docs: align docs with current architecture; archive completed reviews

[slittycode]

Summary

Documentation had drifted in several places vs. the code. This sweep brings the living docs back in sync and archives one-shot review docs whose action items have all shipped.

Stale-in-place fixes

• BACKLOG.md — audition samples moved from "In Progress (branch claude/gemini-sample-generation-U753E)" to "Shipped". That branch is gone; the feature landed in feat(samples): Phase 3 audition — heuristic WAV/MIDI from Phase 1 + PyTheory #45 and test(samples): end-to-end audio-content assertions for audition output #46.
• docs/SAMPLE_GENERATION.md — header changes from "Status: Prototype on branch X" to "Status: Shipped".
• apps/ui/README.md — drops Google Gen AI SDK from the Tech Stack. The @google/genai dependency was removed from package.json; Gemini is fully backend-mediated.
• apps/backend/ARCHITECTURE.md — Components table extended to cover csv_export.py, dsp_utils.py, dsp_bandbank.py, sample_*.py, server_samples.py, stage_status.py, symbolic_extract.py, url_ingest.py, phase1_evaluation.py, phase1_report_html.py, utils/cleanup.py. Routes list gains /interrupt, /samples (POST + GET).
• apps/backend/README.md — canonical-routes list rounded out with DELETE /runs, /interrupt, /source-audio, /export/csv, /spectral-enhancements, /pitch-note-translations, /interpretations, /samples.
• apps/backend/AGENTS.md — File Map refreshed with the same new modules. New "Operator and Research Scripts" section documents scripts/ (bootstrap, evaluate_*, genre_check, etc.). Stale 2026-03-10 date stamp bumped.
• apps/ui/AGENTS.md — File Map expanded with analysisRunsClient, phase2Validator, mixDoctor, spectralArtifactsClient, sampleGenerationClient, fieldAnalytics, midi/, sessionMusician/, and the types/ barrel. Notes that the UI no longer imports an AI SDK.
• CLAUDE.md — backend "Core files" list expanded to match; audition-samples surface called out explicitly.

Archived (moved to docs/history/)

• external-repo-review-2026-05-13.md — Tracks 1, 2, 3 all shipped or deferred. Archive-note header summarizes the PRs that closed each track.
• track1-spike-outcome-2026-05-13.md — verification spike concluded; sample-rate fix shipped; regression test lives in apps/backend/tests/test_loudness_r128.py.

Cross-references updated

• docs/adr/0001-phase1-json-schema-v1.md
• apps/backend/csv_export.py (module docstring)
• apps/backend/tests/test_loudness_r128.py (module docstring)
• docs/history/README.md index
• relative links inside the two archived docs

Test plan

• git grep confirms no remaining references to docs/external-repo-review-2026-05-13.md or docs/track1-spike-outcome-2026-05-13.md outside docs/history/.
• Relative links inside the two archived docs rewritten from ../ to ../../ to remain navigable from the new depth.
• No code changes — only docs and module docstrings. Recommend a npm run lint + unittest discover smoke run before merge to confirm the docstring edits didn't trip anything.

https://claude.ai/code/session_01YNsCxdcxQiTieUNvAgKMd9

---

Generated by Claude Code

[slittycode]

Verdict: APPROVE

Summary

Docs-only sweep: aligns CLAUDE.md, ARCHITECTURE.md, AGENTS.md, and README.md with the modules that shipped in #45/#46, archives two completed review docs to docs/history/, and fixes relative links throughout. No code changes except docstring path corrections in csv_export.py and test_loudness_r128.py. All newly-documented files verified to exist on disk; no stale references to the old paths found outside docs/history/.

Findings

None.

Test results

No tests run — zero executable code changed. The PR's own test plan (lint + unittest discover smoke) is the right call before merge.

Phase boundary check

Clean. Docs only; no Phase 1/2/3 boundary crossings.

---

Generated by Claude Code

[slittycode]

Verdict: APPROVE

Summary

Docs-only sweep: two completed review docs archived into docs/history/, all their cross-references updated to the new depth (../ → ../../), and every living doc (CLAUDE.md, ARCHITECTURE.md, AGENTS.md×2, README.md×2, BACKLOG.md, the ADR, csv_export.py docstring, test_loudness_r128.py docstring) brought in sync with the modules that shipped since the last doc refresh. CI is green on both Frontend and Backend. No code changes.

Findings

No blocking or should-fix findings.

Worth considering (minor accuracy nits in archived files, not worth a follow-up commit):

• docs/history/track1-spike-outcome-2026-05-13.md still reads "Result (pending CI)" — predates the fix shipping. Archived context, low stakes.
• The "Definition of done" checklist inside the archived external-repo-review-2026-05-13.md still has unchecked boxes (e.g., [ ] Side-by-side endpoint comparison committed). The archive note says all three tracks resolved, so a reader has to reconcile that themselves.

Test results

Frontend: pass. Backend: pass. No test-impacting changes — only docstring edits in csv_export.py and test_loudness_r128.py.

Phase boundary check

Clean. No changes to Phase 1, 2, or 3 logic. No schema changes. No field additions, removals, or renames.

---

Generated by Claude Code