@codedology/code-forge 0.8.0 → 0.10.0

package/docs/reference/blocks.json

@@ -4,7 +4,7 @@
     "plans/code-forge-plan-v1.3.md §10.4",
     "plans/NIGHT-LOG.md"
   ],
-  "block_count": 73,
+  "block_count": 102,
   "baseline_ids": ["B0", "B1", "B2", "B3", "B4", "B5", "B6", "B7", "B8"],
   "baseline_note": "Wave 0-1 blocks, landed before v1.3; depends_on may name them, but they have no entry under blocks.",
   "blocks": {
@@ -1006,6 +1006,623 @@
         "B66"
       ],
       "note": "root-added 2026-10-12; GitHub issue #13 adoption plan (plans/adoption-13/plan.md); also amends skill/SKILL.md, skill/references/code.md, docs/README.md, docs/how-it-works.md and test/skill/structure.test.mjs"
+    },
+    "B68": {
+      "title": "A lost review-state file is rebuilt from the signed ledger, never reset",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/worker/review-state.mjs",
+        "test/worker/review-state-restore.test.mjs"
+      ],
+      "depends_on": [
+        "B67"
+      ],
+      "note": "root-added 2026-10-12; GitHub issue #15 review-exits plan (plans/review-exits/plan.md); review.state anchors carry a slim signed state_body; also amends src/worker/engine.mjs, src/worker/loop.mjs, skill/references/review.md, skill/references/ledger.md and test/worker/fixloop-wiring.test.mjs"
+    },
+    "B69": {
+      "title": "Review state lives under the code-forge home, not the temp root",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "src/worker/review-state.mjs",
+        "src/doctor/local.mjs",
+        "test/worker/review-state-durable.test.mjs"
+      ],
+      "depends_on": [
+        "B68"
+      ],
+      "note": "root-added 2026-10-12; GitHub issue #15 review-exits plan (plans/review-exits/plan.md); state at <home>/runs/<run>/review-state, one-time checked move from the temp root, doctor review-state row; also amends src/util/tmp.mjs (runRootPath), src/worker/engine.mjs, src/doctor/index.mjs, skill/references/review.md, docs/how-it-works.md, docs/getting-started.md and the B68/fixloop-wiring tests"
+    },
+    "B70": {
+      "title": "A fully waived review counts as reviewed",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/review/gate-check.mjs",
+        "test/review/waived-all.test.mjs"
+      ],
+      "depends_on": [
+        "B69"
+      ],
+      "note": "root-added 2026-10-12; GitHub issue #9 review-exits plan (plans/review-exits/plan.md); reviewed_by_waiver status and signed gate.review_waived_all row before block.close; unknown severity is human-only; also amends src/cli/block.mjs, skill/references/review.md, skill/references/ledger.md, docs/how-it-works.md and docs/concepts.md"
+    },
+    "B77": {
+      "title": "Test guard ignores live runs of the developer",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "test/helpers/isolate.mjs",
+        "test/helpers-isolate.test.mjs"
+      ],
+      "depends_on": [
+        "B70"
+      ],
+      "note": "root-added 2026-10-12; tool fix found while building (plans/pipeline.md); leakedEntries: a new path of a run whose record was in the baseline is not a leak; also amends test/no-leak.test.mjs"
+    },
+    "B78": {
+      "title": "Full reviewed text comes back after a restore",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "src/worker/review-state.mjs",
+        "test/worker/review-state-restore.test.mjs"
+      ],
+      "depends_on": [
+        "B77"
+      ],
+      "note": "root-added 2026-10-12; tool fix found while building (plans/pipeline.md), follows B68 (issue #15); reviewed_content_blob in the signed state_body, git hash-object/cat-file with a discovery ceiling, sha-checked, falls back to B68; also amends src/worker/engine.mjs, skill/references/review.md and skill/references/ledger.md"
+    },
+    "B71": {
+      "title": "review-file --answers: a reviewer judges a fix made in another owned file",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/review/answers.mjs",
+        "test/review/answers.test.mjs"
+      ],
+      "depends_on": [
+        "B78"
+      ],
+      "note": "root-added 2026-10-12; GitHub issue #9 review-exits plan (plans/review-exits/plan.md); answers ticket kind, signed review.answered rows bound to both content hashes, gate counts a still-current answer like a waiver (answered list on gate.review_waived_all), unknown severities fail closed; also amends src/review/gate-check.mjs, src/cli/review-file.mjs, src/cli/block.mjs, src/worker/queue.mjs, src/worker/engine.mjs, src/worker/loop.mjs, skill/references/review.md, skill/references/ledger.md and docs/how-it-works.md"
+    },
+    "B72": {
+      "title": "block reopen: a human restarts a stopped or lost file on new content",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/review/reopen.mjs",
+        "test/review/reopen.test.mjs"
+      ],
+      "depends_on": [
+        "B71"
+      ],
+      "note": "root-added 2026-10-12; GitHub issues #12 and #15 review-exits plan (plans/review-exits/plan.md); human-only verb on CODER_ONLY_FORBIDDEN, signed review.reopened row bound to the latest anchor seq, stop_content_hash in the state, one row per at_seq, L3 rung stays spent; also amends src/cli/block.mjs, src/util/forbidden.mjs, src/worker/engine.mjs, src/worker/queue.mjs, the forbidden-list pin tests, skill/references/review.md, skill/references/ledger.md, skill/references/code.md and docs/how-it-works.md"
+    },
+    "B79": {
+      "title": "Review-exit leftovers: cap-row severity, answers packet secrets and budget, reopen config and write cause",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "src/review/answers.mjs",
+        "src/review/gate-check.mjs",
+        "src/cli/block.mjs",
+        "src/review/reopen.mjs",
+        "test/review/answers.test.mjs",
+        "test/review/reopen.test.mjs"
+      ],
+      "depends_on": [
+        "B72"
+      ],
+      "note": "root-added 2026-10-12; leftovers from the B71 and B72 round-3 reviews; also amends B71 (answers packet, openAt) and B72 (reopen config, write failure)"
+    },
+    "B73": {
+      "title": "A patch check that closes findings is progress; stop answers name the exits",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/review/fixloop.mjs",
+        "src/review/stop-exits.mjs",
+        "src/cli/review-file.mjs",
+        "src/review/gate-check.mjs",
+        "test/review/patch-progress.test.mjs",
+        "test/worker/fix-list.test.mjs",
+        "test/autopilot/actions.test.mjs",
+        "docs/how-it-works.md",
+        "skill/references/review.md"
+      ],
+      "depends_on": [
+        "B79"
+      ],
+      "note": "root-added 2026-10-12; issue #12 items 9-10; also amends B71 (review-file stopped answer) and the gate review_cap/unreviewed detail"
+    },
+    "B81": {
+      "title": "Deterministic ledger rotation race test",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "src/ledger/write.mjs",
+        "test/ledger/write.test.mjs"
+      ],
+      "depends_on": [
+        "B73"
+      ],
+      "note": "root-added 2026-10-12; the claimRotatedName two-racers test failed once under full-suite load during the B73 land; an afterLink hook forces the race order"
+    },
+    "B74": {
+      "title": "A deleted owned file is reviewed with a deletion note",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "src/review/engine.mjs",
+        "src/review/deletion.mjs",
+        "test/worker/deletion-review.test.mjs",
+        "docs/how-it-works.md",
+        "skill/references/review.md"
+      ],
+      "depends_on": [
+        "B81"
+      ],
+      "note": "root-added 2026-10-12; issue #8; the deletion flow already worked end to end (pinned by test); adds the deletion note with bounded reference search"
+    },
+    "B75": {
+      "title": "review-file --fresh re-runs only results that never counted",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "src/cli/review-file.mjs",
+        "src/worker/queue.mjs",
+        "test/worker/fresh.test.mjs",
+        "test/worker/queue.test.mjs",
+        "skill/references/review.md",
+        "skill/references/code.md"
+      ],
+      "depends_on": [
+        "B74"
+      ],
+      "note": "root-added 2026-10-12; issue #10 item 4; classify the done marker in place, claim only a re-runnable one by atomic rename, restore by link; leftovers in B83"
+    },
+    "B82": {
+      "title": "Deterministic worker restart kill test",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "test/worker/worker.test.mjs"
+      ],
+      "depends_on": [
+        "B75"
+      ],
+      "note": "root-added 2026-10-12; the 'new worker re-reads 3 queued tickets' test checked a killed pid once and failed under load (zombie window); it now waits for ESRCH with a 5 s deadline"
+    },
+    "B76": {
+      "title": "the skill and docs name the review exits in order",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "skill/references/review.md",
+        "skill/references/code.md",
+        "skill/references/security.md",
+        "skill/templates/coder-brief.md",
+        "docs/how-it-works.md",
+        "test/skill/structure.test.mjs"
+      ],
+      "depends_on": [
+        "B75"
+      ],
+      "note": "root-added 2026-10-12; group A docs; exits in order (fix + block reopen, --answers, block waive, re-decompose), block attempt never resets review state, a lost state is rebuilt from the ledger, when --fresh helps"
+    },
+    "B83": {
+      "title": "review-file --fresh fails closed when a marker cannot be restored",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "src/worker/queue.mjs",
+        "src/cli/review-file.mjs",
+        "test/worker/fresh.test.mjs"
+      ],
+      "depends_on": [
+        "B76"
+      ],
+      "note": "root-added 2026-10-12; B75 leftovers (plans/reviews/b75/r3.txt a-d); a failed link-back writes a refused fresh-restore-failed marker or keeps the claim; a kept claim holds the ticket; block reopen clears claims"
+    },
+    "B84": {
+      "title": "keys.cache_hours and keys set --cache-hours set the 1Password cache time",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "schema/code-forge.schema.json",
+        "docs/reference/config.md",
+        "src/keys/store.mjs",
+        "src/cli/keys.mjs",
+        "src/cli/jev.mjs",
+        "src/doctor/local.mjs",
+        "src/worker/loop.mjs",
+        "test/keys/cache-hours.test.mjs",
+        "test/keys/cli.test.mjs",
+        "test/config/schema-coverage.test.mjs",
+        "test/config/schema.test.mjs",
+        "docs/getting-started.md",
+        "docs/how-it-works.md",
+        "skill/references/security.md",
+        "README.md"
+      ],
+      "depends_on": [
+        "B83"
+      ],
+      "note": "root-added 2026-10-12; issue #14 part 1 (plans/keys-cache/plan.md); 1-24 h, default 8; a lower value shortens a cached key at the next read; bad config refuses set --op, warns elsewhere"
+    },
+    "B85": {
+      "title": "key expiry warnings and the re-link line",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/keys/store.mjs",
+        "src/cli/keys.mjs",
+        "src/cli/jev.mjs",
+        "src/doctor/local.mjs",
+        "test/keys/expiry-warn.test.mjs",
+        "docs/getting-started.md",
+        "docs/how-it-works.md",
+        "skill/references/security.md",
+        "README.md"
+      ],
+      "depends_on": [
+        "B84"
+      ],
+      "note": "root-added 2026-10-12; issue #14 part 2 (plans/keys-cache/plan.md); index keeps the op ref; WARN under 1 h in keys list and doctor; jev ask prints the re-link line when the cache expired and 1Password fails; refs shell-quoted"
+    },
+    "B86": {
+      "title": "fail-closed JUnit XML report reader for proof red-green",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/proof/junit.mjs",
+        "test/proof/junit.test.mjs",
+        "test/fixtures/junit/xctest.xml",
+        "test/fixtures/junit/swift-testing.xml",
+        "test/fixtures/junit/phpunit.xml",
+        "test/fixtures/junit/pest.xml",
+        "test/fixtures/junit/pytest.xml",
+        "skill/references/proof.md",
+        "test/skill/structure.test.mjs"
+      ],
+      "depends_on": [
+        "B85"
+      ],
+      "note": "root-added 2026-10-13; issue #7 part 1 (plans/red-green/plan.md); hand-written reader, no DTD/entities, 8 MiB cap, O_NOFOLLOW|O_NONBLOCK; RED only on assertion failures; SwiftPM bare failure needs a matching XCTest console line; not wired into proof yet (B87)"
+    },
+    "B87": {
+      "title": "proof.runners: prove non-node:test files through a runner argv and its JUnit report",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/proof/runners.mjs",
+        "src/proof/red-green.mjs",
+        "src/cli/proof.mjs",
+        "src/config/validate.mjs",
+        "schema/code-forge.schema.json",
+        "src/state/config-snapshot.mjs",
+        "src/state/block.mjs",
+        "src/state/run.mjs",
+        "src/proof/junit.mjs",
+        "docs/concepts.md",
+        "docs/how-it-works.md",
+        "docs/tutorial-first-test.md",
+        "docs/reference/config.md",
+        "skill/references/proof.md",
+        "skill/references/code.md",
+        "README.md",
+        "test/proof/runners.test.mjs",
+        "test/proof/red-green.test.mjs",
+        "test/proof/junit.test.mjs",
+        "test/config/validate.test.mjs",
+        "test/config/schema-coverage.test.mjs",
+        "test/skill/structure.test.mjs"
+      ],
+      "depends_on": [
+        "B86"
+      ],
+      "note": "root-added 2026-10-13; issue #7 part 2 (plans/red-green/plan.md, C-D1=a); runners frozen in the run snapshot; argv only, GIT_* stripped; rule 17 proof-runners-invalid; no-hook match refused exit 2; env_keys names only; swift runs as junit until B88"
+    },
+    "B88": {
+      "title": "swift adapter for proof.runners, checked live with swift test",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/proof/runners.mjs",
+        "src/proof/junit.mjs",
+        "src/proof/red-green.mjs",
+        "test/proof/swift-adapter.test.mjs",
+        "test/proof/swift-live.test.mjs",
+        "test/proof/junit.test.mjs",
+        "test/proof/runners.test.mjs",
+        "test/fixtures/junit/xctest.xml",
+        "test/fixtures/junit/xctest-pass.xml",
+        "test/fixtures/junit/xctest-none.xml",
+        "test/fixtures/junit/swift-testing.xml",
+        "test/fixtures/junit/swift-testing-pass.xml",
+        "test/fixtures/junit/swift-testing-none.xml",
+        "test/fixtures/junit/swift-testing-crash.xml",
+        "test/fixtures/junit/pest.xml",
+        "test/fixtures/junit/pytest.xml",
+        "skill/references/proof.md",
+        "test/skill/structure.test.mjs"
+      ],
+      "depends_on": [
+        "B87"
+      ],
+      "note": "root-added 2026-10-13; issue #7 part 3 (plans/red-green/plan.md §1.3); live VERIFIED Swift 6.3.3 / Xcode 26.6 / macOS 26 arm64; real SwiftPM bare failure is message=\"failure\"; --parallel needed for the XCTest report; filters anchored; swiftc compile shapes; B87 r3 leftovers folded in"
+    },
+    "B89": {
+      "title": "PHP red-green through the junit adapter, checked live on Laravel (PHPUnit and Pest)",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "test/proof/laravel-live.test.mjs",
+        "test/fixtures/junit/phpunit.xml",
+        "test/fixtures/junit/phpunit-pass.xml",
+        "test/fixtures/junit/phpunit-new-class.xml",
+        "test/fixtures/junit/phpunit-full.xml",
+        "test/fixtures/junit/pest.xml",
+        "test/fixtures/junit/pest-pass.xml",
+        "test/fixtures/junit/pest-new-class.xml",
+        "src/proof/red-parse.mjs",
+        "test/proof/red-parse.test.mjs",
+        "test/proof/junit.test.mjs",
+        "skill/references/proof.md",
+        "docs/how-it-works.md",
+        "test/skill/structure.test.mjs"
+      ],
+      "depends_on": [
+        "B88"
+      ],
+      "note": "root-added 2026-10-13; issue #7 part 4 (plans/red-green/plan.md §1.4); live VERIFIED PHP 8.4.25, Laravel 13.35.0, PHPUnit 12.5.39, Pest 4.7.8 through php artisan test; red-parse reads Laravel 13's JSON-escaped agent console (folded-in candidate B108); no <warning> seen"
+    },
+    "B102": {
+      "title": "The xcodebuild adapter for proof.runners: Xcode precheck, -only-testing, result bundle reader",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/proof/xcresult.mjs",
+        "src/proof/runners.mjs",
+        "src/proof/junit.mjs",
+        "src/config/validate.mjs",
+        "schema/code-forge.schema.json",
+        "docs/reference/config.md",
+        "skill/references/proof.md",
+        "test/proof/xcodebuild-adapter.test.mjs",
+        "test/proof/runners.test.mjs",
+        "test/config/schema-coverage.test.mjs",
+        "test/skill/structure.test.mjs",
+        "test/fixtures/xcresult/bare-fail.json",
+        "test/fixtures/xcresult/build-failed.console",
+        "test/fixtures/xcresult/build-failed.json",
+        "test/fixtures/xcresult/build-for-testing-failed.console",
+        "test/fixtures/xcresult/near-names.json",
+        "test/fixtures/xcresult/swift-testing-case.json",
+        "test/fixtures/xcresult/swift-testing-noparens.json",
+        "test/fixtures/xcresult/swift-testing-pass.json",
+        "test/fixtures/xcresult/swift-testing.console",
+        "test/fixtures/xcresult/swift-testing.json",
+        "test/fixtures/xcresult/thrown.console",
+        "test/fixtures/xcresult/thrown.json",
+        "test/fixtures/xcresult/xctest-case.json",
+        "test/fixtures/xcresult/xctest-pass.json",
+        "test/fixtures/xcresult/xctest.console",
+        "test/fixtures/xcresult/xctest.json"
+      ],
+      "depends_on": [
+        "B89"
+      ],
+      "note": "root-added 2026-10-13; issue #7 part 5 (plans/red-green/plan.md §1.6); fixtures captured from Xcode 26.6 (17F113), iPhone 17 simulator iOS 26.5, xcresulttool schema 0.1.0; Swift Testing -only-testing needs (); exit 0 with no test, no bundle, an unreadable bundle or an out-of-scope test is RED_INVALID error; parameterized Swift Testing, repetitions, multi-destination, Runtime Warning and Expected Failure make the bundle unreadable (fail closed)"
+    },
+    "B103": {
+      "title": "A live xcodebuild red-green check on an iOS simulator, opt-in",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "test/proof/xcodebuild-live.test.mjs",
+        "skill/references/proof.md",
+        "docs/how-it-works.md",
+        "test/skill/structure.test.mjs"
+      ],
+      "depends_on": [
+        "B102"
+      ],
+      "note": "root-added 2026-10-13; issue #7 part 6 (plans/red-green/plan.md §1.6); live VERIFIED Xcode 26.6 (17F113), iPhone 17 simulator iOS 26.5; XCTest and Swift Testing, file and case runs RED assertion → GREEN, new function RED_INVALID compile, ghost destination destination-unavailable; live JSON matched the B102 fixtures (kept)"
+    },
+    "B90": {
+      "title": "Size-based review routing: review.routes",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/review/route.mjs",
+        "src/worker/loop.mjs",
+        "src/worker/ticket.mjs",
+        "src/config/validate.mjs",
+        "schema/code-forge.schema.json",
+        "docs/reference/config.md",
+        "skill/references/review.md",
+        "docs/how-it-works.md",
+        "docs/review-only.md",
+        "test/review/route.test.mjs",
+        "test/config/validate-routes.test.mjs",
+        "test/config/validate.test.mjs",
+        "test/config/schema-coverage.test.mjs",
+        "test/skill/structure.test.mjs"
+      ],
+      "depends_on": [
+        "B103"
+      ],
+      "note": "root-added 2026-10-13; issue #10 item 4 (plans/iteration/plan.md B90); rule 18 review-routes-invalid; signed review.route rows before the first session, once per ticket; no routes = byte-equal to 8fadc12"
+    },
+    "B91": {
+      "title": "Two broken results (schema or timeout) move a packet to the second level",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/review/session-retry.mjs",
+        "src/review/schema-fallback.mjs",
+        "src/review/engine.mjs",
+        "src/review/fixloop.mjs",
+        "src/autopilot/binnacle.mjs",
+        "skill/references/review.md",
+        "docs/how-it-works.md",
+        "docs/review-only.md",
+        "test/review/broken-fallback.test.mjs",
+        "test/review/schema-fallback.test.mjs",
+        "test/worker/schema-fallback-wiring.test.mjs",
+        "test/autopilot/binnacle.test.mjs",
+        "test/skill/structure.test.mjs"
+      ],
+      "depends_on": [
+        "B90"
+      ],
+      "note": "root-added 2026-10-13; issue #10 (plans/iteration/plan.md B91); review.session_timeout notes carry packet_hash and are signed; review.schema_fallback gains trigger schema|timeout; no second level = as before plus packet_hash"
+    },
+    "B92": {
+      "title": "Test-quality hint: a test that reads source text is listed for the reviewer",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "src/review/test-quality.mjs",
+        "src/review/engine.mjs",
+        "src/review/lenses/A.md",
+        "src/review/lenses/B.md",
+        "src/review/lenses/full.md",
+        "src/review/lenses/quick.md",
+        "src/review/lenses/recheck.md",
+        "skill/references/code.md",
+        "skill/references/review.md",
+        "skill/templates/coder-brief.md",
+        "docs/how-it-works.md",
+        "test/review/test-quality.test.mjs",
+        "test/review/fixloop.test.mjs",
+        "test/review/route.test.mjs",
+        "test/skill/structure.test.mjs"
+      ],
+      "depends_on": [
+        "B91"
+      ],
+      "note": "root-added 2026-10-13; issue #10 item 3 (plans/iteration/plan.md B92); a pure detector lists test lines that read a source file and assert on its text; the packet gets a ## test-quality hint section, the lens rule tells the reviewer to judge it; rechecks get the rule but no section; lens A/B order test sorted (flake fixed)"
+    },
+    "B93": {
+      "title": "coder.sandbox: a run-fixed sandbox profile for the Codex coder",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "src/engines/builders/codex.mjs",
+        "src/session/spawn.mjs",
+        "src/cli/spawn.mjs",
+        "src/engines/sandbox-dirs.mjs",
+        "src/state/config-snapshot.mjs",
+        "src/state/run.mjs",
+        "schema/code-forge.schema.json",
+        "src/config/validate.mjs",
+        "docs/reference/config.md",
+        "src/doctor/probes.mjs",
+        "src/doctor/index.mjs",
+        "skill/references/adapters/subprocess.md",
+        "skill/references/security.md",
+        "docs/brief-mode.md",
+        "docs/how-it-works.md",
+        "test/engines/sandbox-profile.test.mjs",
+        "test/config/validate.test.mjs",
+        "test/config/schema-coverage.test.mjs",
+        "test/skill/structure.test.mjs"
+      ],
+      "depends_on": [
+        "B92"
+      ],
+      "note": "root-added 2026-10-13; issue #10 item 1 (plans/iteration/plan.md B93); profiles workspace (default, today's argv), toolchain (--add-dir per entry), full (danger-full-access, doctor WARN); refused dirs checked after a per-component symlink walk with native realpath; rule 19 sandbox-dir-refused, rule 20 sandbox-dirs-unused (WARN); immutable key; spawn --role coder --run checks the snapshot (sandbox-changed)"
+    },
+    "B94": {
+      "title": "Skill: one fix round per block",
+      "wave": 14,
+      "level": "L1",
+      "status": "landed",
+      "owned": [
+        "skill/references/code.md",
+        "skill/references/review.md",
+        "skill/references/adapters/solo.md",
+        "skill/references/adapters/claude-code.md",
+        "skill/references/adapters/subprocess.md",
+        "docs/how-it-works.md",
+        "test/skill/structure.test.mjs",
+        "docs/concepts.md",
+        "docs/brief-mode.md",
+        "docs/autopilot.md",
+        "skill/references/ledger.md"
+      ],
+      "depends_on": [
+        "B93"
+      ],
+      "note": "root-added 2026-10-13; issue #10 item 5 (plans/iteration/plan.md B94); skill and docs only; the full rule word for word in code.md §4, solo.md §3 step 7 and how-it-works; one fixed pointer sentence in the other docs; the per-file cap counts per file"
+    },
+    "B80": {
+      "title": "Human-only verbs: waive and reopen ask at a terminal",
+      "wave": 14,
+      "level": "L2",
+      "status": "landed",
+      "owned": [
+        "docs/concepts.md",
+        "docs/getting-started.md",
+        "docs/how-it-works.md",
+        "docs/tutorial-first-test.md",
+        "skill/references/adapters/claude-code.md",
+        "skill/references/adapters/solo.md",
+        "skill/references/code.md",
+        "skill/references/ledger.md",
+        "skill/references/proof.md",
+        "skill/references/review.md",
+        "skill/references/security.md",
+        "src/cli/block.mjs",
+        "src/review/gate-check.mjs",
+        "src/review/reopen.mjs",
+        "src/review/verb-forms.mjs",
+        "src/util/forbidden.mjs",
+        "test/cli/block-human-confirm.test.mjs",
+        "test/cli/status.test.mjs",
+        "test/helpers/human-confirm.mjs",
+        "test/review/answers.test.mjs",
+        "test/review/close-gate.test.mjs",
+        "test/review/gate-check.test.mjs",
+        "test/review/reopen.test.mjs",
+        "test/review/waived-all.test.mjs",
+        "test/skill/structure.test.mjs",
+        "test/state/block-end.test.mjs"
+      ],
+      "depends_on": [
+        "B94"
+      ],
+      "note": "root-added 2026-10-13; issue #10 owner item 1 (plans/iteration/plan.md B80, D1 = a); block waive and block reopen ask the human for a yes at a terminal, no --yes, no terminal exits 2 and records nothing; pre-checks run before the question; a pseudo-terminal passes the check (honest limit in security.md §3); D1 (b) is a later option"
     }
   }
 }