docs: add work-consolidation.md as the open-work source of truth - #37
Merged
Conversation
A fresh backend-source + live-API audit (backend HEAD fa1c533, read-only Bearer probes) found the previous closing claim in the-gaps.md — "parity work is complete except G11" — is no longer true. Three documented, Bearer-ready backend feature areas have no iOS consumer, and one shipped feature is broken. - New work-consolidation.md: the single answer to "what is left to build and who works on it". Carries the verified baseline (823 tests green; exactly one iOS verb/path call the backend rejects; 31 Bearer-ready routes with no iOS consumer), the prioritized gap list (D4, G15-G21, P1-P8), three parallel workstreams sized so they don't collide, the subscriber-gating map, and backend asks A8-A12 - the-gaps.md: superseded-for-open-work banner plus inline corrections where it is now wrong — X4 (BYO AI keys) is superseded by G15 twice over (the endpoints are live, and the BYO-key model is gone; AI is a subscriber entitlement on the app's server-side key), and `materialize` is not internal — it backs the user-facing "Create from..." feature. It stays the historical record for phases 1-19, D1-D3, G1-G14, A1-A7 - CLAUDE.md: point the reference-docs section at work-consolidation.md first Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KD1sv3y8YWsDBiG31tUJWo
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Lands the audit that re-opened parity work. A backend-source + live-API pass (backend HEAD
fa1c533, read-only Bearer probes) found thatthe-gaps.md's closing claim — "parity work is complete except G11" — is no longer true: three documented, Bearer-ready backend feature areas have no iOS consumer, and one shipped feature is broken in production.This is the plan the follow-up PRs implement, so it lands first.
What's included
work-consolidation.md(new) — the open-work source of truth: verified baseline (823 tests green, exactly one iOS verb/path the backend rejects, 31 Bearer-ready routes with no iOS consumer), the prioritized gap list (D4 avatar 405, G15 AI, G16 Create from…, G17 shared-in lists, G18–G21, papercuts P1–P8), three parallel workstreams sized not to collide, the subscriber-gating map, and backend asks A8–A12the-gaps.md— superseded-for-open-work banner + inline corrections. X4 (BYO AI keys) is superseded by G15 twice over: the endpoints are live, and the BYO-key model is gone (AI is a subscriber entitlement on the app's own server-side key).materializeis not "internal" — it backs the user-facing "Create from…" feature. The file stays the historical record for phases 1–19, D1–D3, G1–G14, A1–A7CLAUDE.md— reference-docs section now points atwork-consolidation.mdfirstTesting
Docs only — no code changed. Baseline recorded in the doc: 823 tests, 0 failures (iPhone 16 ·
302E002E-…,-parallel-testing-enabled NO, E2E skipped).Follow-ups
This is PR 1 of a stack. Next: the
APIClienttransport seam (unblocks parallel work), then D4 (the live avatar regression), G17, and the P1/P3 papercuts.🤖 Generated with Claude Code