docs: fixit pass for consistency now that M3 is closed - #71
Merged
Conversation
Several docs had drifted from the merged state of M3 (#70) and the roadmap-consolidation PR just before it (#69): - README.md, docs/ecosystem.md: both still described docs/pragmatic_mvp.md as holding "the status ledger" — it moved to ROADMAP.md in #69. Added ROADMAP.md to README's document table and pointed ecosystem.md's plan table at it. - docs/m3-readiness-review.md, docs/pragmatic_mvp.md: the M3 progress sections still said arms 2 and 3 were outstanding / not run. Updated to the landed state, and folded the M3-5 arms into the same bulleted list format as M3-0..M3-6 rather than leaving them as a trailing paragraph. - docs/ecosystem.md: the Harbor-track pause note was stale — squad's own ROADMAP.md records the pause lifted 2026-08-08. Corrected, and distinguished from the still-open cross-track gate (needs Harbor at M8). - docs/ecosystem.md: the stats-bridge "Watch out" (working-copy sys.path hack) described the pre-2026-08-08 state; the fix landed the same day duva-bench's own PLAN.md documents it, so replaced with the current setup and a real trap found in its place (a stale/broken local venv reads as "just rebuild it," not as a report-generation failure worth digging into). - docs/ecosystem.md: issues #63 and #65 (linked as open findings) have both been closed; #65 became docs/api-compatibility.md's "Plane dependencies" section. Only #64 is still open. - docs/api-compatibility.md: extended "Plane dependencies" with the candidate-set analogue of the intent-minting gap #65 already documented — the native MCP surface has no proposal-open tool, so a candidate set's proposal has to be opened via one compat-plane REST call. Confirmed directly while running M3-5 arm 2 (#70). No narrative or scope changes — corrections to what's already true, pointing at evidence that already exists.
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
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
A documentation consistency pass across the repo now that M3 (#70) and the
roadmap-consolidation PR just before it (#69) are both merged. No scope or
narrative changes — every edit corrects something that had drifted out of
sync with a merged PR, with the evidence for the correction cited inline.
docs/pragmatic_mvp.mdas holding "the status ledger." Give the roadmap one home, and make CLAUDE.md point at the real plan #69 moved that toROADMAP.md. AddedROADMAP.mdto README's document table; pointedecosystem.md's plan table at it.
sections still said arms 2 and 3 were outstanding / not run. Updated to
the landed state (M3-5: run arm 2 (three-way agent cost comparison) — closes M3 #70), and folded the M3-5 arms into the same bulleted
list format as M3-0..M3-6 instead of a trailing paragraph.
own
ROADMAP.mdrecords the pause lifted 2026-08-08. Corrected, anddistinguished from the still-open cross-track gate (which needs Harbor
at its own M8, not this).
working-copy
sys.pathhack that predates the fix duva-bench's ownPLAN.mddocuments landing 2026-08-08. Replaced with the current setup,plus a real trap found in its place while running M3-5 arm 3: a stale or
half-built local venv (no
pyvenv.cfg) silently reads as "just rerunsetup-stats.sh," not as a report-generation failure worth investigating.both closed; The native plane cannot open a run on its own — undocumented dependency on the compat plane #65 became
docs/api-compatibility.md's "Planedependencies" section. Only No native-plane response has a schema — all 87 operations type requests only #64 is still open.
candidate-set analogue of The native plane cannot open a run on its own — undocumented dependency on the compat plane #65's intent-minting gap: the native MCP
surface has no proposal-open tool, so a candidate set's proposal has to
be opened via one compat-plane REST call. Confirmed directly while
running M3-5 arm 2 (M3-5: run arm 2 (three-way agent cost comparison) — closes M3 #70) — the
adp-mcptrials needed exactly this.Test plan
make check-docspasses (CLAUDE.md path assertions unaffected —no paths named there were touched)
make checkfull suite green