Skip to content

A10: the stale prose, swept - #93

Merged
tap merged 1 commit into
mainfrom
claude/sample-rate-solutions-comparison-mqc190
Oct 15, 2026
Merged

tap merged 1 commit into
mainfrom
claude/sample-rate-solutions-comparison-mqc190

Conversation

@tap

@tap tap commented Oct 15, 2026

Copy link
Copy Markdown
Owner

What this changes

This is the roadmap's A10, the last Block A item. It corrects the prose that had gone stale against the tree:

  • Root PLAN.md:
  • bridge/PLAN.md §9: the deferred "degenerate case" chapter is struck through and points at Part VI.
  • async/PLAN.md:
    • §3 said v0.4.0; the family is at 0.6.0.
    • §4's construction scenario is marked done (construct_q15, 43f3e29, 2026-10-09).
    • Tail latency is marked done in part: A6 gates the worst single pull(), and the host p99/max belongs to Block B.
  • docs/AUDIT_2026-10_PLAN.md: "execution in progress" now reads executed. All 35 rows are closed, and S0–S5 are on main.
  • Comparison records:
    • docs/COMPARISON.md ("The shared tooling") and each engine's COMPARISON.md (first caveat) now state that the competitors are frozen by policy at their 2026-10-09 pins: libsamplerate 0.2.2, r8brain-free-src 7.6 and SpeexDSP 1.2.1.
    • async's record adds that its host rows also use the Ubuntu 24.04 packages, soxr 0.1.3 among them.
    • Moving a pin re-runs compare.yml and the notebooks and re-dates the tables.

Why

Each of these was a claim a reader would take at its word, and each one had stopped being true.

Verification

  • Provenance checked:
    • Part VI's landing: git log on book/src/part6/, 2bb2a56, 2026-10-08.
    • construct_q15: 43f3e29.
    • The audit table: no row lacks ✓ or ↗.
    • Each pin's date: git log -S on the tools/compare/ hashes. r8brain was re-pinned at 7.6 and SpeexDSP added in 3ebefb3, 2026-10-09.
  • update_compare_docs.py reproduces every generated table as committed, so the edits sit outside the markers.
  • check_retired_words.py and git diff --check pass.
  • I have no local mdbook, so CI's book build is the first gate for the book and the links.

Notes for the reviewer

  • Prose only: no code, count or ceiling moves.

🤖 Generated with Claude Code

https://claude.ai/code/session_016GKzq1VSdcMYCRMhddiMaf


Generated by Claude Code

The roadmap's A10. Each claim below had gone stale against the tree:

- Root PLAN.md: the layout said the book's bridge chapters were
  follow-up work. Part VI, the bridge engine, landed in #68 on 2026-10-08,
  and the rational engine is Part VII. The migration record's "bringing
  async's workloads under clang-tidy is follow-up work" now notes that A2
  did it on 2026-10-12.
- bridge/PLAN.md section 9: the "degenerate case" chapter, "explicitly
  deferred", is struck through and points at Part VI, which was written
  from the ANCHOR: comments the code carried from day one.
- async/PLAN.md: the status line said v0.4.0, but the family is at 0.6.0
  (D13). Roadmap item 1, construction as a ratcheted scenario, is marked
  done: construct_q15 landed on 2026-10-09 in 43f3e29. Item 3, tail
  latency, is marked done in part: A6 gates the worst single pull() in the
  QEMU ratchet, and the host p99/max is Block B's.
- docs/AUDIT_2026-10_PLAN.md: "execution in progress" now reads executed.
  All 35 disposition rows are closed, and S0 to S5 are on main.
- The comparison records: docs/COMPARISON.md ("The shared tooling") and
  each engine's COMPARISON.md (first caveat) state that the competitors are
  frozen by policy at their 2026-10-09 pins. Those are libsamplerate 0.2.2,
  r8brain-free-src 7.6 and SpeexDSP 1.2.1; async's host rows also use the
  Ubuntu 24.04 packages, soxr 0.1.3 among them. A newer competitor release
  is not tracked, and moving a pin re-runs compare.yml and the notebooks
  and re-dates the tables. The generated tables are untouched:
  update_compare_docs.py reproduces them as committed.

The roadmap marks A10 landed. Prose only, so no code, count or ceiling
moves.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016GKzq1VSdcMYCRMhddiMaf
@tap
tap merged commit b684114 into main Oct 15, 2026
32 checks passed
@tap
tap deleted the claude/sample-rate-solutions-comparison-mqc190 branch October 15, 2026 11:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants