Skip to content

docs(readme): badge row + status callout + PyMuPDF quick-start fix#234

Merged
wranngle merged 2 commits into
mainfrom
docs/readme-badges-callout-f3
Jul 10, 2026
Merged

docs(readme): badge row + status callout + PyMuPDF quick-start fix#234
wranngle merged 2 commits into
mainfrom
docs/readme-badges-callout-f3

Conversation

@wranngle

Copy link
Copy Markdown
Owner

Summary

  • Adds the CI + License + Status badge row and the verbatim active-status callout under the section-12 freeze carve-out (additive voice-clean edits only, no existing prose touched).
  • Fixes F3: Live mode quick start (bun install + bun run start) never mentioned the Python 3 venv + PyMuPDF requirements.txt prerequisite that lib/pdf-generator.ts hard-depends on as the sole PDF renderer. Mirrors CI's own test.yml "Install PyMuPDF renderer dependency" step.

Test plan

  • bun run test:run tests/unit/readme.test.ts — 49 passed
  • bun run typecheck — clean
  • Manual lint: zero em/en-dashes, zero sentence-ending exclamation points, zero banned vocabulary in README.md

Co-Authored-By: Claude Fable 5 noreply@anthropic.com

…ap (F3)

Live mode quick start (`bun install` + `bun run start`) never mentioned
the Python 3 venv + PyMuPDF requirements.txt prerequisite that
lib/pdf-generator.ts hard-depends on for the only PDF renderer. CI's own
test.yml installs this in a separate step; a first-time user following
just the two stated commands hit a PDF-render subprocess failure with no
guidance. Added the same venv + pip install step CI runs, before
`bun run start`.

Also added the CI/License/Status badge row and the verbatim active-status
callout under section-12's freeze carve-out (both explicitly permitted as
additive voice-clean edits, no existing prose touched). Repo-metadata
(About/topics/homepage) already conforms; not touched here.

Verified: bun run test:run tests/unit/readme.test.ts (49 passed), bun run
typecheck clean. Two remaining COMPETE atoms (intro-paragraph placement,
section order) staged to tournament-atoms-gtm_ops.json for the
cross-provider tournament phase, out of scope for this mechanical pass.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions github-actions Bot added the pr-needs-issue PR has no Closes/Fixes/Resolves reference; auto-applied by pr-link-check label Jul 10, 2026
…ection-order

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@wranngle wranngle merged commit a209dd4 into main Jul 10, 2026
19 of 20 checks passed
@wranngle wranngle deleted the docs/readme-badges-callout-f3 branch July 10, 2026 02:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pr-needs-issue PR has no Closes/Fixes/Resolves reference; auto-applied by pr-link-check

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant