docs(changelog): backfill [0.4.0], populate [Unreleased], fix footer link

[liam-ai-reality]

Summary

• Add missing ## [0.4.0] section documenting klasp setup, klasp init --adopt, and the expanded recipes guide
• Populate ## [Unreleased] with 3 commits present since the v0.4.0 tag (feat(demo) Killer demo: 3 agents, 1 failing commit, 1 self-correction loop — replayable fixtures #69, fix fix: doctor false-positive on managed-block hooks, setup output polish #110, feat(core) Extend AgentSurface trait with install_with_warnings + doctor_check (kill stringly-typed dispatch + close doctor coverage gap) #55)
• Fix [Unreleased] footer comparison link: was v0.3.0...HEAD, now v0.4.0...HEAD
• Add [0.4.0] and [0.3.1] footer version comparison links (both were missing)
• Add reference links for all newly cited issue/PR numbers (Extend AgentSurface trait with install_with_warnings + doctor_check (kill stringly-typed dispatch + close doctor coverage gap) #55, First-run gate adoption: detect and mirror existing pre-commit/Husky/Lefthook setups #97, docs: audit recipes for Python, TypeScript, Rust, Go, polyglot, monorepo #100, feat(init): --adopt flow detects + mirrors existing gates (closes #97) #101, klasp setup: one-command first-run flow + sensible install/adopt defaults #103, feat(setup): one-command first-run flow + agent-narrowing defaults (closes #103) #104, fix: doctor false-positive on managed-block hooks, setup output polish #110)

Closes #112.

Test plan

• Confirm ## [0.4.0] section now appears between ## [Unreleased] and ## [0.3.1]
• Confirm ## [Unreleased] lists all 3 unreleased commits (feat(demo), fix fix: doctor false-positive on managed-block hooks, setup output polish #110, feat(core) Extend AgentSurface trait with install_with_warnings + doctor_check (kill stringly-typed dispatch + close doctor coverage gap) #55)
• Confirm footer [Unreleased] link compares v0.4.0...HEAD
• Confirm footer [0.4.0] and [0.3.1] comparison links are present and correct
• Verify all new [#N] references resolve (no dead links)

🤖 Generated with Claude Code

[liam-ai-reality]

Code review — step 07 findings

Verdict: 🟢 Approve — no blocking issues.

What looks good

• All three audit findings from chore(release): readiness audit 2026-05-11 — red #112 are correctly addressed.
• Version comparison links are accurate: [Unreleased] → v0.4.0...HEAD, [0.4.0] → v0.3.1...v0.4.0, [0.3.1] → v0.3.0...v0.3.1.
• [Unreleased] picks up the third commit (feat(core) Extend AgentSurface trait with install_with_warnings + doctor_check (kill stringly-typed dispatch + close doctor coverage gap) #55, landed May 12 after the audit ran) — complete and correct.
• [0.4.0] scope is correct: housekeeping commits (chore(release), docs: sync README) properly omitted.
• All new entries match existing bold-title + em-dash description style and enrol spelling.
• New reference links are numerically ordered and typed correctly (issues vs. pull).

Nits (no action required on this PR)

• feat(demo) in [Unreleased] cites [#69] (the closed issue) with no PR number — the commit message has no (#PR) suffix so this appears to be a direct push. Non-blocking.

Pre-existing debt (out of scope — follow-up issue recommended)

• [#72], [#73] (used in ## [0.2.3]) and [#91] (used in ## [0.3.1]) have no footer reference links. This gap predates this PR.

---

Review run by agentic-flow step 07 · no re-dispatch needed (no Critical/Important findings)

[liam-ai-reality]

Review remediation

Finding	Disposition
feat(demo) entry missing merge PR number	Dropped — commit was a direct push; no PR number exists to cite
[#72], [#73], [#91] missing footer reference links (pre-existing)	Deferred → #114

No fix commits needed. PR diff is unchanged from initial push.

Deferred follow-up: #114 — add the three missing footer links in a subsequent patch.