Slice 11 / Phase 3 (v2): Workflow tracer — extraction script + Build Log Episode 1

[tkowalczyk]

Parent PRD

#12

What to build

Prove the hybrid generation workflow end-to-end on real content before scaling.

Extraction script — a small CLI tool in this repo that reads a commit range from the sibling auditmos/ogsfrompoly checkout and emits a structured markdown bundle (commit messages with SHAs, file-level diffs scoped to the range, a top-level "context for the article" preamble) ready to paste into Claude. Small interface, hidden implementation. Boundary snapshot tests are deliberately out of scope per PRD #12 — correctness is verified by manual inspection of the bundle output.

Build Log Episode 1 — "Replicating sign-randomization on real Polymarket data" — drafted via the hybrid path: extract a commit range from poly-track's earliest sign-randomization work, paste into Claude, curate for voice and opinion, run disclosure-policy self-review against docs/disclosure-policy.md, commit. Episode 1 replaces the placeholder article from #20. The article embeds code/diff excerpts inline (upstream repo is private, so no clickable commit links).

See plans/slice-11-build-log.md Phase 3 for full details.

Acceptance criteria

• Extraction script lives in this repo and runs against a sibling poly-track checkout via a documented CLI invocation
• Script emits a markdown bundle to stdout containing: commit messages with SHAs, file-level diffs scoped to the range, and a top-level context preamble
• Episode 1 is published at /articles/<slug> with episode_number: 1, series: "build-log", ~800–1200 words, narrative-led
• Episode 1 embeds at least one code excerpt or diff block inline — no clickable links to private commits
• Episode 1's commit_range frontmatter captures the SHAs the article narrates (internal metadata only, not rendered in HTML or .md body)
• Episode 1 passes the author's disclosure-policy self-review against docs/disclosure-policy.md
• The Phase 1 placeholder article is removed; Episode 1 takes its slot in the feeds and listing
• pnpm types && pnpm test && pnpm lint && pnpm knip all pass in CI

Blocked by

• Blocked by Slice 11 / Phase 1 (v2): Article collection spine — schema, dual-format, feeds, listing #20 (article collection spine must exist before Episode 1 can be published)

User stories addressed

Reference by number from PRD #12:

• User story 4 (institutional reader — Build Log audit trail)
• User story 7 (institutional reader — embedded code excerpts)
• User story 9 (technical peer — why decisions were made)
• User story 10 (technical peer — what didn't work)
• User story 11 (technical peer — source papers cited inline)
• User story 17 (author — extraction script enables 30-min drafting)
• User story 21 (author — milestone-tied cadence)