Skip to content

Commit a8e184b

Browse files
committed
Docs: Replan v18 after command CLI
1 parent 35869c3 commit a8e184b

4 files changed

Lines changed: 116 additions & 12 deletions

File tree

CHANGELOG.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7070
- V18 release planning now records explicit public-release blockers for
7171
production-runtime replay, live finalization CLI design, wet-run fixture
7272
harnessing, Continuum contract tie-back, and operator release notes.
73+
- V18 planning now records the evidence-backed post-command-CLI replan toward
74+
production-runtime scratch replay, wet-run fixture harnessing, live
75+
finalization CLI design, and generated Continuum contract tie-back.
7376
- V18 graph-model migration dry-run work now includes a non-destructive CLI
7477
runner and request JSON adapter that validate source facts, invoke the pure
7578
planner, emit deterministic manifest output, and refuse write/apply modes.

docs/BEARING.md

Lines changed: 64 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -46,9 +46,9 @@ Current branch state at this boundary:
4646
evidence
4747
- Latest released package line: `17.0.1`
4848
- Latest completed implementation cycle:
49-
`0199-v18-v17-golden-graph-fixtures`
50-
- Current work: PR E has started. Slice 46 is complete on this branch, and
51-
slices 47 through 55 are the current drift-check batch.
49+
`0213-v18-replan-after-command-cli`
50+
- Current work: PR E now contains slices 46 through 65. The branch is ready
51+
for PR review after final local verification and push.
5252
- Cleanup checkpoint: `main` has been fast-forwarded to `origin/main` after
5353
PR #103 merged; this branch starts from that merge commit.
5454

@@ -320,6 +320,44 @@ enumerates every current `src/domain` file that still touches raw legacy
320320
content/property compatibility patterns and fails if that set drifts without
321321
review.
322322

323+
Slice 56 is complete on this branch. The v17 golden fixture manifest can now
324+
be projected into genesis-equivalence readings with deterministic
325+
patch-boundary evidence.
326+
327+
Slice 57 is complete on this branch. Scratch migration operation commits can
328+
now be read back from Git and projected into genesis-equivalence facts with
329+
scratch commit boundary evidence.
330+
331+
Slice 58 is complete on this branch. The migration command can now construct
332+
legacy and scratch readings through providers after scratch writing.
333+
334+
Slice 59 is complete on this branch. Scratch runtime conformance now has an
335+
adapter-level operation-history readback provider tied to the expected scratch
336+
ref and head.
337+
338+
Slice 60 is complete on this branch. Command finalization is covered with
339+
command-owned reading providers plus scratch operation readback conformance.
340+
341+
Slice 61 is complete on this branch. Provider-built scratch readings now have
342+
a divergence regression proving finalization remains blocked when scratch
343+
history is readable but not equivalent.
344+
345+
Slice 62 is complete on this branch. The command now has deterministic
346+
operator report formatting for planning, scratch, equivalence, and
347+
finalization evidence.
348+
349+
Slice 63 is complete on this branch. A non-finalizing migration command CLI
350+
wrapper writes scratch history, builds command-owned readings, emits the
351+
command report, and refuses live-ref finalization flags.
352+
353+
Slice 64 is complete on this branch. V18 public-release blockers are explicit:
354+
production-runtime scratch replay, live finalization CLI design, wet-run
355+
fixture harnessing, generated Continuum contract tie-back, and release notes.
356+
357+
Slice 65 is complete on this branch. Evidence-backed replanning moves the next
358+
goalpost from scratch operation readback to production-runtime scratch replay
359+
and wet-run fixture harnessing.
360+
323361
## What Feels Wrong
324362

325363
- Content persistence still uses legacy `_content*` compatibility properties.
@@ -335,15 +373,14 @@ review.
335373
- The v18 migration tool can now write scratch history and derive scratch
336374
operation readings, but it does not yet open scratch output through the full
337375
production graph runtime.
338-
- Genesis equivalence is a gate vocabulary now, but not yet a full real-history
339-
ship gate wired through finalization.
340-
- Compact equivalence fixtures are not enough by themselves. The golden v17
341-
fixture now restores Git refs and source inventory consumes those refs, but
342-
the command still needs real-history reading construction from migrated Git
343-
output.
344-
- The next migration work must wire real-history reading and runtime
345-
conformance providers through finalization, then broaden the evidence beyond
346-
scratch operation readback where the production runtime needs it.
376+
- Legacy readings from the v17 golden fixture are manifest-derived, not yet
377+
produced by replaying the restored v17 graph through the public read path.
378+
- The command wrapper writes scratch history and reports evidence, but live-ref
379+
finalization from the CLI is intentionally refused until confirmation and
380+
operator-report semantics are designed.
381+
- Continuum/WARP Optic release claims still need generated contract evidence
382+
tied to Wesley/Continuum artifacts, not just handwritten compatibility
383+
doctrine.
347384

348385
## Where We Are Heading
349386

@@ -359,6 +396,14 @@ Suggested implementation batches:
359396
writing, scratch equivalence gating, finalization safety, finalization
360397
implementation, end-to-end command wiring, post-migration runtime
361398
conformance, and content/property closeout audit.
399+
- PR E extension, slices 56 through 65: legacy and scratch reading
400+
construction, command reading providers, scratch operation readback
401+
conformance, provider-backed finalization and divergence coverage, command
402+
reporting, a non-finalizing command CLI wrapper, release blockers, and this
403+
replan.
404+
- Next goalpost, slices 66 through 70: production-runtime scratch replay,
405+
wet-run fixture harnessing, live finalization CLI design, and generated
406+
Continuum contract tie-back.
362407

363408
## Invariants
364409

@@ -488,3 +533,10 @@ and concrete checks live in `docs/invariants/`.
488533
[0211](design/0211-v18-migration-command-cli-wrapper/v18-migration-command-cli-wrapper.md).
489534
- [x] 64. Record v18 public release blockers:
490535
[0212](design/0212-v18-public-release-blockers/v18-public-release-blockers.md).
536+
- [x] 65. Replan after the command CLI:
537+
[0213](design/0213-v18-replan-after-command-cli/v18-replan-after-command-cli.md).
538+
- [ ] 66. Design production-runtime scratch replay conformance.
539+
- [ ] 67. Implement production-runtime scratch replay provider.
540+
- [ ] 68. Add a v17 fixture wet-run migration harness.
541+
- [ ] 69. Design live finalization CLI confirmation and reporting.
542+
- [ ] 70. Tie v18 release claims to generated Continuum contract evidence.
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
cycle: 0213
3+
task_id: V18_replan_after_command_cli
4+
status: Completed
5+
sponsors:
6+
human: James
7+
agent: Codex
8+
started_at: 2026-05-24
9+
completed_at: 2026-05-24
10+
release_home: v18.0.0
11+
bearing_task: 65
12+
promotes_backlog:
13+
- docs/BEARING.md
14+
- docs/method/backlog/v18.0.0/INFRA_graph-model-migration-tool.md
15+
---
16+
17+
# V18 Replan After Command CLI
18+
19+
## Hill
20+
21+
Use the evidence from slices 56 through 64 to reset the next v18 goalpost
22+
before opening the PR.
23+
24+
## Evidence
25+
26+
- The branch was clean before this replan edit.
27+
- `git rev-list --left-right --count origin/main...HEAD` reported `0 19`.
28+
- The branch now contains legacy fixture readings, scratch readings, command
29+
reading providers, scratch operation readback conformance, provider-backed
30+
finalization coverage, divergence coverage, command reporting, a
31+
non-finalizing command CLI wrapper, and public release blocker docs.
32+
33+
## Closeout
34+
35+
Slice 65 updates `BEARING` and the migration backlog. The next goalpost is no
36+
longer "can we write and inspect scratch history"; it is "can we prove scratch
37+
history through the production runtime and run a wet migration harness without
38+
touching live refs."
39+
40+
## Verification
41+
42+
```text
43+
git status --short
44+
git log --oneline --decorate --max-count=16 origin/main..HEAD
45+
git diff --stat origin/main...HEAD
46+
git rev-list --left-right --count origin/main...HEAD
47+
```

docs/method/backlog/v18.0.0/INFRA_graph-model-migration-tool.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,8 @@ Remaining migration-tool work is intentionally ordered as:
7474
scratch history and refuses live-ref finalization flags (complete).
7575
- slice 64: record v18 public release blockers before widening release claims
7676
(complete).
77+
- slice 65: replan with command-CLI evidence in hand and set the next
78+
production-runtime replay goalpost (complete).
7779

7880
## Starting points
7981

0 commit comments

Comments
 (0)