feat(maintain-report): --markdown + --pdf export — the real receipt-backed report, shareable#101
Merged
Merged
Conversation
…acked report, shareable "Export the report" — not just the demo story. maintain-report now emits the LIVE numbers in the two formats teams actually consume: - --markdown: a paste-ready PR/issue/standup block — stats table, this-week delta, unicode sparkline, forecast, by-scope, suggested next. Framed honestly: "every number comes from verified-run receipts, not model claims." - --pdf: a one-pager via pdf-lite, with the 8-week trend as a REAL vector bar chart — pdf-lite gains a `bars` block type (normalized `re f` rects, q/Q-scoped gray, 1pt floor so zero weeks stay visible) because sparkline glyphs aren't in the Latin-1 base fonts. - Both render from ONE data struct through PURE exporters (maintain-report-export.ts), so the report can never disagree with itself across formats. - ADOPTION.md "show your team" now points story-exports AND numbers-exports. Validated live: markdown renders; PDF is `PDF document, version 1.4, 1 pages` with 8 vector bars.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The priority was "export the report" — the live numbers, not just the demo story.
qodex maintain-report --markdown [-o file]A paste-ready block for a PR description / issue / standup thread: stats table, this-week delta, unicode sparkline, OLS forecast, by-scope, suggested-next. Framed honestly up top: "every number below comes from verified-run receipts, not model claims."
qodex maintain-report --pdf [-o file]A one-page PDF with the 8-week trend as a real vector bar chart.
pdf-litegains abarsblock type — normalizedre frectangles,q/Q-scoped gray fill (never leaks into text), 1pt floor so zero-weeks stay visible — because sparkline glyphs (▁▂▃…) simply aren't in the Latin-1 base fonts and would be stripped.Design
Both formats render from one data struct through PURE exporters (
maintain-report-export.ts) — the report can't disagree with itself across console/markdown/PDF. The existing console output is unchanged.Validated live:
filesaysPDF document, version 1.4, 1 pages; 8 vector bars present; markdown renders cleanly.+9 tests (markdown content incl. sparkline + no-suggestion fallback; PDF numbers; bar normalization/floor; divide-by-zero guard; no glyph leakage). Full suite 1531 green, tsc clean.