Skip to content

fix: deep-dive round 2 — backbone rule flipped, pre-upgrade paths routed, flow bugs closed#513

Merged
leeovery merged 2 commits into
mainfrom
feat/batch-review-round-2
Jul 23, 2026
Merged

fix: deep-dive round 2 — backbone rule flipped, pre-upgrade paths routed, flow bugs closed#513
leeovery merged 2 commits into
mainfrom
feat/batch-review-round-2

Conversation

@leeovery

@leeovery leeovery commented Jul 22, 2026

Copy link
Copy Markdown
Owner

Round-2 deep dive over the whole stack (design log: #504; base: #512), per Lee: multiple agents, logic + conventions, catch bugs before going live. Six slices: three literal-executor walkthroughs (planning; scoping+review; discovery+spec-entry), textual forensics over the full diff, a dual-authority rules audit (CONVENTIONS.md + CLAUDE.md), and a mutation-check proving every round-1 engine guard is load-bearing.

Majors fixed

  • Planning backbone Hard Rule Restructure skills to align with skill-creator guidelines #2 still commanded raw-git-never-scoped-helper for exactly the three operations the stack moved onto --plan — an always-loaded backbone rule contradicting every reference it governs. Flipped to the shipped reality, with restart cleanup named as the one surviving raw-git case.
  • Pre-upgrade plans hit unrouted mid-session throws: three resume paths (planning continue, scoping adjust-continue, review-actions F) reached their first --plan commit with storage_paths never backfilled — an engine error mid-flow with mutations already applied. Each path now carries a routed guard at entry: subtree shows no storage_paths → record it from the format's Storage Pathspecs before anything commits.

Also fixed

  • resolve-dependencies D never iterated past the first unresolved dependency (pre-existing on main; improve-doctrine) — per-dependency loop-back added, ops example shows both op shapes.
  • display-groupings unify gains the anchor-collision guard (reconcile step 6's invariant — an anchor keyed unified could be silently demoted).
  • confirm-and-persist restores the synthesis sourcing note the batch swap dropped; description optional, never invented.
  • brief-synthesis C skips on zero regenerations; author-tasks drop-list covers task= on last-in-phase; review-findings shows the delete-op shape; absent storage_paths treated like [] at restart; knowledge-store staging exists-guarded; dangling (D7) token and spacing tidied.

Verified clean

Textual forensics (47 files: no escape artifacts, balanced fences, valid JSON templates, resolving cross-refs); the never-list rule tree-wide; mutation-check: every round-1 guard's test goes red if its guard is deleted; suites 1568/1568 · lint 27/27 · typecheck.

🤖 Generated with Claude Code

Stack

  1. feat(engine): discovery-map add-batch — the harvest persists in one call (D7) #505
  2. feat(engine): manifest apply — batched set/delete across one work unit (D7) #506
  3. refactor(prose): task-map family folds onto existing batch forms (D7, stage 3) #507
  4. feat(engine): manifest set — two grammars, never mixed #508
  5. refactor(prose): dump/read folds — subtree gets replace per-topic loops (D7, stage 5) #509
  6. feat(engine): commit --plan — plan storage stages from recorded state (D7, stage 6) #510
  7. fix: batching-stack review round — re-resolve rewired, guards symmetric, hardening pinned #512
  8. fix: deep-dive round 2 — backbone rule flipped, pre-upgrade paths routed, flow bugs closed #513 👈 current
  9. fix(review-r3): engine hardening + crash-resume seams #514
  10. feat(scoping): promotion routes through first-phase choice + bridge #515
  11. fix(spec): pin the bugfix source name to the topic #516
  12. fix(skills): gate-skip sentence accurate in gate-less phases #517
  13. fix(review-entry): name the real upstream — specification and plan #518
  14. fix(shared): strip triage-landing's unreachable superseded-research arm #519
  15. feat(engine): refuse work-unit-level fields that shadow the phases tree #520
  16. fix(discovery): first-written briefs join the full brief lifecycle #521
  17. test(sim): pipeline simulation — engine driven end-to-end as a black box #522
  18. fix(round-4): review findings — backfill keying, ratchet evasion, pull guard #523

@leeovery
leeovery force-pushed the feat/batch-review-fixes branch from e78fb09 to 465e63d Compare July 23, 2026 11:05
@leeovery
leeovery force-pushed the feat/batch-review-round-2 branch from c971da1 to 8ad0c0d Compare July 23, 2026 11:05
@leeovery
leeovery force-pushed the feat/batch-review-fixes branch from 465e63d to bcfa71a Compare July 23, 2026 12:29
@leeovery
leeovery force-pushed the feat/batch-review-round-2 branch from 8ad0c0d to 6e264b3 Compare July 23, 2026 12:29
@leeovery
leeovery force-pushed the feat/batch-review-fixes branch from bcfa71a to 91c594a Compare July 23, 2026 12:30
@leeovery
leeovery force-pushed the feat/batch-review-round-2 branch from 6e264b3 to 19ff4c5 Compare July 23, 2026 12:30
@leeovery
leeovery force-pushed the feat/batch-review-fixes branch from 91c594a to 2a4b3ef Compare July 23, 2026 12:31
@leeovery
leeovery force-pushed the feat/batch-review-round-2 branch from 19ff4c5 to af5addc Compare July 23, 2026 12:31
@leeovery
leeovery force-pushed the feat/batch-review-fixes branch from 2a4b3ef to 8e552b1 Compare July 23, 2026 12:32
@leeovery
leeovery force-pushed the feat/batch-review-round-2 branch from af5addc to 11c2481 Compare July 23, 2026 12:32
@leeovery
leeovery force-pushed the feat/batch-review-fixes branch from 8e552b1 to 4fc6f7b Compare July 23, 2026 12:32
@leeovery
leeovery force-pushed the feat/batch-review-round-2 branch from 11c2481 to 927adc3 Compare July 23, 2026 12:32
@leeovery
leeovery force-pushed the feat/batch-review-fixes branch from 4fc6f7b to 3793e7a Compare July 23, 2026 12:33
@leeovery
leeovery force-pushed the feat/batch-review-round-2 branch from 927adc3 to ed05893 Compare July 23, 2026 12:33
@leeovery
leeovery changed the base branch from feat/batch-review-fixes to main July 23, 2026 12:34
leeovery and others added 2 commits July 23, 2026 13:34
…ted, flow bugs closed

Six-slice pass (three literal-executor walkthroughs, textual forensics,
dual-authority rules audit, engine mutation-check). Fixes:

- MAJOR planning backbone Hard Rule #2 contradicted every reference it
  governs — still commanding raw-git-never-scoped-helper for the three
  operations the stack moved onto --plan. Flipped to the shipped
  reality; restart cleanup named as the one raw-git case.
- MAJOR pre-upgrade plans hit unrouted mid-session --plan throws on
  three resume paths (planning continue, scoping adjust-continue,
  review-actions F). Each now carries a routed backfill guard: subtree
  shows no storage_paths → record it from the format's Storage
  Pathspecs before anything commits. Scoping continue also folds its
  two per-field gets into one subtree read.
- resolve-dependencies D never looped past the first unresolved
  dependency (pre-existing on main — improve-doctrine fix): both
  branches now return to D for the next dependency; the ops example
  shows both current-topic and reverse op shapes.
- display-groupings unify gains reconcile step 6's anchor-collision
  guard (an anchor keyed "unified" could be silently demoted to
  proposed).
- confirm-and-persist restores the synthesis sourcing note lost in the
  batch swap; description is optional, never invented.
- brief-synthesis C skips entirely on zero regenerated briefs.
- author-tasks drop-list names task= on a phase's last task;
  process-review-findings shows the delete-op shape inline; restart
  cleanups treat absent storage_paths like []; knowledge-store staging
  exists-guarded; dangling (D7) token and bullet spacing tidied.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The zero-regenerations skip was inline prose steering flow — now a
conditional pair: no regenerations returns to caller, otherwise the
propagation body runs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@leeovery
leeovery force-pushed the feat/batch-review-round-2 branch from ed05893 to 9e13a3a Compare July 23, 2026 12:34
@leeovery
leeovery merged commit f28a1b8 into main Jul 23, 2026
@leeovery
leeovery deleted the feat/batch-review-round-2 branch July 23, 2026 12:43
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.

1 participant