peaks-loop 4.1.4 → 4.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (294) hide show
  1. package/.claude-plugin/marketplace.json +7 -2
  2. package/CHANGELOG.md +148 -0
  3. package/README-en.md +47 -183
  4. package/README.md +24 -188
  5. package/dist/cli/cli-helpers.d.ts +20 -0
  6. package/dist/cli/cli-helpers.js +34 -0
  7. package/dist/cli/commands/_register.js +2 -0
  8. package/dist/cli/commands/best-practice-scan-command.d.ts +11 -6
  9. package/dist/cli/commands/best-practice-scan-command.js +35 -20
  10. package/dist/cli/commands/best-practice-scan-helpers.d.ts +47 -0
  11. package/dist/cli/commands/best-practice-scan-helpers.js +88 -5
  12. package/dist/cli/commands/best-practice-scan-lookup-results.d.ts +13 -0
  13. package/dist/cli/commands/best-practice-scan-lookup-results.js +237 -0
  14. package/dist/cli/commands/code-commands.d.ts +6 -4
  15. package/dist/cli/commands/code-commands.js +6 -4
  16. package/dist/cli/commands/code-gate-command.d.ts +5 -5
  17. package/dist/cli/commands/code-gate-command.js +49 -9
  18. package/dist/cli/commands/code-mode-gate-plan-command.d.ts +1 -1
  19. package/dist/cli/commands/code-mode-gate-plan-command.js +2 -2
  20. package/dist/cli/commands/core/memory-extract-command.js +10 -5
  21. package/dist/cli/commands/dispatch-cli-invocation-check.d.ts +108 -0
  22. package/dist/cli/commands/dispatch-cli-invocation-check.js +87 -0
  23. package/dist/cli/commands/dispatch-cli-invocation-scan.d.ts +66 -0
  24. package/dist/cli/commands/dispatch-cli-invocation-scan.js +162 -0
  25. package/dist/cli/commands/dispatch-command-spec.js +1 -1
  26. package/dist/cli/commands/dispatch-commands.js +12 -5
  27. package/dist/cli/commands/dispatch-isolation-lease.d.ts +1 -1
  28. package/dist/cli/commands/dispatch-isolation-lease.js +6 -53
  29. package/dist/cli/commands/dispatch-preflight.js +46 -0
  30. package/dist/cli/commands/dispatch-prompt-blocks.d.ts +1 -1
  31. package/dist/cli/commands/dispatch-prompt-composition.d.ts +7 -1
  32. package/dist/cli/commands/dispatch-prompt-composition.js +29 -7
  33. package/dist/cli/commands/dispatch-record-write.d.ts +1 -1
  34. package/dist/cli/commands/dispatch-tool-call.d.ts +1 -1
  35. package/dist/cli/commands/doc-commands.js +1 -1
  36. package/dist/cli/commands/feedback-commands-helpers.js +1 -1
  37. package/dist/cli/commands/final-review-prepare-command.js +22 -1
  38. package/dist/cli/commands/gate-commands-enforce.js +3 -3
  39. package/dist/cli/commands/hook-handle.js +41 -20
  40. package/dist/cli/commands/lint-commands.js +3 -1
  41. package/dist/cli/commands/loop-eval-capture-index.js +2 -4
  42. package/dist/cli/commands/openspec-command-shared.js +2 -2
  43. package/dist/cli/commands/perf-audit-commands.js +15 -5
  44. package/dist/cli/commands/project-commands.js +9 -6
  45. package/dist/cli/commands/race-commands.d.ts +15 -0
  46. package/dist/cli/commands/race-commands.js +65 -0
  47. package/dist/cli/commands/race-pilot-gate-record-command.d.ts +3 -0
  48. package/dist/cli/commands/race-pilot-gate-record-command.js +81 -0
  49. package/dist/cli/commands/request-command-options.d.ts +8 -0
  50. package/dist/cli/commands/request-commands.js +2 -0
  51. package/dist/cli/commands/request-init-command.js +67 -12
  52. package/dist/cli/commands/{vm-status-command.d.ts → request-retag-command.d.ts} +1 -1
  53. package/dist/cli/commands/request-retag-command.js +50 -0
  54. package/dist/cli/commands/request-show-command.d.ts +8 -0
  55. package/dist/cli/commands/request-show-command.js +14 -1
  56. package/dist/cli/commands/request-transition-command.js +12 -4
  57. package/dist/cli/commands/request-transition-failures.d.ts +14 -0
  58. package/dist/cli/commands/request-transition-failures.js +76 -7
  59. package/dist/cli/commands/request-transition-preflight.js +1 -1
  60. package/dist/cli/commands/scan-scope-commands.js +2 -2
  61. package/dist/cli/commands/security-audit-commands.js +26 -6
  62. package/dist/cli/commands/slice-decompose-artifacts.js +2 -1
  63. package/dist/cli/commands/verdict-aggregate-command.js +2 -1
  64. package/dist/cli/commands/workflow-gate-commands.js +4 -4
  65. package/dist/cli/commands/worktree-lease-gc-command.js +1 -1
  66. package/dist/cli/program.js +0 -2
  67. package/dist/services/artifacts/artifact-contract-block.d.ts +53 -0
  68. package/dist/services/artifacts/artifact-contract-block.js +231 -0
  69. package/dist/services/artifacts/artifact-prerequisites.d.ts +27 -19
  70. package/dist/services/artifacts/artifact-prerequisites.js +65 -135
  71. package/dist/services/artifacts/artifact-templates.d.ts +1 -1
  72. package/dist/services/artifacts/artifact-templates.js +17 -10
  73. package/dist/services/artifacts/prerequisite-checks.d.ts +87 -0
  74. package/dist/services/artifacts/prerequisite-checks.js +198 -0
  75. package/dist/services/artifacts/prerequisite-transition-event.d.ts +20 -0
  76. package/dist/services/artifacts/prerequisite-transition-event.js +27 -0
  77. package/dist/services/artifacts/rd-transition-gates.d.ts +33 -0
  78. package/dist/services/artifacts/rd-transition-gates.js +71 -0
  79. package/dist/services/artifacts/request-artifact-metadata.d.ts +31 -0
  80. package/dist/services/artifacts/request-artifact-metadata.js +44 -0
  81. package/dist/services/artifacts/request-artifact-service.d.ts +5 -0
  82. package/dist/services/artifacts/request-artifact-service.js +43 -69
  83. package/dist/services/artifacts/request-artifact-state-helpers.d.ts +21 -1
  84. package/dist/services/artifacts/request-artifact-state-helpers.js +34 -8
  85. package/dist/services/artifacts/request-retag-service.d.ts +68 -0
  86. package/dist/services/artifacts/request-retag-service.js +125 -0
  87. package/dist/services/artifacts/request-state-order.d.ts +38 -0
  88. package/dist/services/artifacts/request-state-order.js +99 -0
  89. package/dist/services/artifacts/request-type-demand.d.ts +44 -0
  90. package/dist/services/artifacts/request-type-demand.js +71 -0
  91. package/dist/services/audit/audit-goal-service.d.ts +7 -0
  92. package/dist/services/audit/enforcers/active-skill-resolver.d.ts +18 -0
  93. package/dist/services/audit/enforcers/active-skill-resolver.js +48 -1
  94. package/dist/services/audit/enforcers/code-ban.d.ts +11 -2
  95. package/dist/services/audit/enforcers/code-ban.js +21 -1
  96. package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.d.ts +17 -0
  97. package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.js +24 -7
  98. package/dist/services/audit-independent/handoff-missing-refusal.d.ts +26 -0
  99. package/dist/services/audit-independent/handoff-missing-refusal.js +109 -0
  100. package/dist/services/audit-independent/handoff-readers.d.ts +37 -0
  101. package/dist/services/audit-independent/handoff-readers.js +81 -0
  102. package/dist/services/audit-independent/index.d.ts +6 -1
  103. package/dist/services/audit-independent/index.js +6 -1
  104. package/dist/services/audit-independent/judged-declaration-build.d.ts +48 -0
  105. package/dist/services/audit-independent/judged-declaration-build.js +73 -0
  106. package/dist/services/audit-independent/judged-declaration-check.d.ts +80 -0
  107. package/dist/services/audit-independent/judged-declaration-check.js +216 -0
  108. package/dist/services/audit-independent/judged-declaration.d.ts +94 -0
  109. package/dist/services/audit-independent/judged-declaration.js +218 -0
  110. package/dist/services/audit-independent/perf-audit-service.js +12 -14
  111. package/dist/services/audit-independent/security-audit-artifact.d.ts +28 -0
  112. package/dist/services/audit-independent/security-audit-artifact.js +90 -0
  113. package/dist/services/audit-independent/security-audit-service.d.ts +6 -53
  114. package/dist/services/audit-independent/security-audit-service.js +34 -178
  115. package/dist/services/capability-guard-runner/contracts/J05.js +60 -14
  116. package/dist/services/codegraph/codegraph-index-integrity.js +2 -0
  117. package/dist/services/context/build-dispatch-system-prompt.d.ts +8 -12
  118. package/dist/services/context/build-dispatch-system-prompt.js +18 -18
  119. package/dist/services/context/collector.js +5 -1
  120. package/dist/services/context/post-compact-reinjection.js +1 -1
  121. package/dist/services/dispatch/active-dispatch-index.d.ts +36 -0
  122. package/dist/services/dispatch/active-dispatch-index.js +118 -0
  123. package/dist/services/dispatch/batch-counter.js +1 -2
  124. package/dist/services/dispatch/dispatch-record-writer.d.ts +29 -16
  125. package/dist/services/dispatch/dispatch-record-writer.js +58 -100
  126. package/dist/services/dispatch/dispatch-sub-agent.js +1 -1
  127. package/dist/services/dispatch/karpathy-block.d.ts +55 -0
  128. package/dist/services/dispatch/karpathy-block.js +101 -0
  129. package/dist/services/dispatch/ledger-reaper.d.ts +80 -0
  130. package/dist/services/dispatch/ledger-reaper.js +131 -0
  131. package/dist/services/dispatch/test-tool-detection.d.ts +17 -1
  132. package/dist/services/dispatch/test-tool-detection.js +12 -1
  133. package/dist/services/evidence/evidence-generator.js +23 -12
  134. package/dist/services/feedback/feedback-promotion-service.d.ts +8 -11
  135. package/dist/services/feedback/feedback-promotion-service.js +30 -35
  136. package/dist/services/feedback/promotion-artifact-json-evidence.d.ts +18 -0
  137. package/dist/services/feedback/promotion-artifact-missing.d.ts +22 -0
  138. package/dist/services/feedback/promotion-artifact-missing.js +63 -0
  139. package/dist/services/final-review/final-review-contract.d.ts +95 -4
  140. package/dist/services/final-review/final-review-contract.js +64 -0
  141. package/dist/services/final-review/final-review-delivery.d.ts +13 -0
  142. package/dist/services/final-review/final-review-delivery.js +26 -12
  143. package/dist/services/final-review/final-review-evidence-collect.js +8 -53
  144. package/dist/services/final-review/final-review-evidence-records.d.ts +21 -0
  145. package/dist/services/final-review/final-review-evidence-records.js +67 -0
  146. package/dist/services/final-review/final-review-evidence-sources.d.ts +22 -0
  147. package/dist/services/final-review/final-review-evidence-sources.js +28 -4
  148. package/dist/services/final-review/final-review-prompt.js +19 -6
  149. package/dist/services/final-review/final-review-runner.js +5 -0
  150. package/dist/services/final-review/final-review-service.d.ts +2 -2
  151. package/dist/services/final-review/index.d.ts +1 -1
  152. package/dist/services/final-review/pre-post-diff.d.ts +2 -75
  153. package/dist/services/final-review/pre-post-diff.js +60 -59
  154. package/dist/services/hooks/pre-tool-code-gate.d.ts +7 -1
  155. package/dist/services/hooks/pre-tool-code-gate.js +21 -2
  156. package/dist/services/hooks/worktree-authorization-gate.js +6 -31
  157. package/dist/services/hooks/worktree-refusal-messages.d.ts +74 -0
  158. package/dist/services/hooks/worktree-refusal-messages.js +102 -0
  159. package/dist/services/lint/eslint-runner-support.d.ts +1 -1
  160. package/dist/services/lint/eslint-runner-support.js +2 -1
  161. package/dist/services/lint/eslint-runner-types.d.ts +8 -0
  162. package/dist/services/lint/eslint-runner.js +17 -4
  163. package/dist/services/llm/anthropic-runner.js +24 -7
  164. package/dist/services/loop/loop-observability.d.ts +39 -0
  165. package/dist/services/loop/loop-observability.js +55 -0
  166. package/dist/services/loop/monotonic-guard.js +6 -9
  167. package/dist/services/loop/monotonic-runner.js +8 -7
  168. package/dist/services/loop/run-driver.js +18 -22
  169. package/dist/services/memory/project-memory-service/index/kind-dispatch.js +14 -1
  170. package/dist/services/memory/project-memory-service/index/project-memory-plan-exec.js +13 -2
  171. package/dist/services/memory/project-memory-service/index.d.ts +2 -2
  172. package/dist/services/memory/project-memory-service/index.js +1 -1
  173. package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.d.ts +36 -0
  174. package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.js +48 -2
  175. package/dist/services/memory/project-memory-service/parsers/markdown-pure.d.ts +23 -1
  176. package/dist/services/memory/project-memory-service/parsers/markdown-pure.js +37 -0
  177. package/dist/services/memory/project-memory-service/types.d.ts +32 -0
  178. package/dist/services/observability/observability-service.d.ts +7 -0
  179. package/dist/services/observability/observability-service.js +2 -1
  180. package/dist/services/openspec/coverage-evidence-reader.d.ts +9 -9
  181. package/dist/services/openspec/coverage-evidence-reader.js +8 -8
  182. package/dist/services/openspec/openspec-archive-service.d.ts +1 -1
  183. package/dist/services/openspec/openspec-archive-service.js +6 -6
  184. package/dist/services/prd/gate-evidence-derivation.d.ts +4 -3
  185. package/dist/services/prd/gate-evidence-derivation.js +4 -3
  186. package/dist/services/qa/bdd-test-style-verifier.js +22 -8
  187. package/dist/services/race/gate2-evaluator.d.ts +58 -0
  188. package/dist/services/race/gate2-evaluator.js +111 -0
  189. package/dist/services/race/gate2-policy.d.ts +17 -0
  190. package/dist/services/race/gate2-policy.js +31 -0
  191. package/dist/services/race/lane-phase.d.ts +19 -0
  192. package/dist/services/race/lane-phase.js +113 -0
  193. package/dist/services/race/pilot-gate-store.d.ts +67 -0
  194. package/dist/services/race/pilot-gate-store.js +227 -0
  195. package/dist/services/scan/file-size-baseline.d.ts +33 -0
  196. package/dist/services/scan/file-size-baseline.js +173 -0
  197. package/dist/services/scan/file-size-scan.d.ts +35 -3
  198. package/dist/services/scan/file-size-scan.js +63 -42
  199. package/dist/services/scan/type-corroboration.d.ts +32 -0
  200. package/dist/services/scan/type-corroboration.js +51 -0
  201. package/dist/services/scan/type-sanity-service.d.ts +14 -0
  202. package/dist/services/scan/type-sanity-service.js +23 -22
  203. package/dist/services/security/safe-settings-path.d.ts +5 -0
  204. package/dist/services/security/safe-settings-path.js +64 -8
  205. package/dist/services/skill/resume-detector.js +11 -11
  206. package/dist/services/skills/hooks-codegate-superpowers.d.ts +5 -6
  207. package/dist/services/skills/hooks-codegate-superpowers.js +7 -8
  208. package/dist/services/skills/hooks-settings-service.d.ts +1 -1
  209. package/dist/services/skills/hooks-settings-service.js +1 -1
  210. package/dist/services/skills/presence-lease-order.d.ts +13 -0
  211. package/dist/services/skills/presence-lease-order.js +24 -0
  212. package/dist/services/skills/skill-conformance-service.js +1 -0
  213. package/dist/services/skills/skill-statusline-service.js +4 -7
  214. package/dist/services/slice/slice-check-service.js +8 -8
  215. package/dist/services/workflow/pipeline-verify-gate-support.d.ts +24 -8
  216. package/dist/services/workflow/pipeline-verify-gate-support.js +34 -39
  217. package/dist/services/workflow/pipeline-verify-qa-phase.d.ts +102 -0
  218. package/dist/services/workflow/pipeline-verify-qa-phase.js +176 -0
  219. package/dist/services/workflow/pipeline-verify-service.js +27 -28
  220. package/dist/services/workflow/request-type-resolution.d.ts +99 -0
  221. package/dist/services/workflow/request-type-resolution.js +130 -0
  222. package/dist/services/workflow/workflow-skip-service.d.ts +1 -20
  223. package/dist/services/workflow/workflow-skip-service.js +22 -25
  224. package/dist/services/workflow/workflow-state-store.d.ts +9 -0
  225. package/dist/services/workflow/workflow-state-store.js +26 -1
  226. package/dist/services/workspace/claude-settings-retirements.d.ts +54 -0
  227. package/dist/services/workspace/claude-settings-retirements.js +112 -0
  228. package/dist/services/workspace/claude-settings-template-merge.d.ts +35 -15
  229. package/dist/services/workspace/claude-settings-template-merge.js +33 -53
  230. package/dist/services/workspace/claude-settings-template.d.ts +62 -12
  231. package/dist/services/workspace/claude-settings-template.js +58 -58
  232. package/dist/services/workspace/migrate-1-4-1-service.js +3 -0
  233. package/dist/services/workspace/reconcile-service.js +0 -1
  234. package/dist/shared/incrementing-number.d.ts +33 -2
  235. package/dist/shared/incrementing-number.js +72 -3
  236. package/package.json +5 -7
  237. package/skills/bee/peaks-perf-audit/SKILL.md +1 -1
  238. package/skills/bee/peaks-prd/SKILL.md +4 -3
  239. package/skills/bee/peaks-qa/SKILL.md +1 -1
  240. package/skills/bee/peaks-qa/references/qa-sub-agent-dispatch.md +2 -2
  241. package/skills/bee/peaks-qa/references/qa-transition-gates.md +1 -1
  242. package/skills/bee/peaks-rd/SKILL.md +2 -2
  243. package/skills/bee/peaks-rd/references/rd-fanout-contracts.md +1 -1
  244. package/skills/bee/peaks-rd/references/rd-sub-agent-dispatch.md +8 -4
  245. package/skills/bee/peaks-rd/references/rd-transition-gates.md +3 -3
  246. package/skills/bee/peaks-rd/references/v2-12-fanout-collapse.md +2 -2
  247. package/skills/bee/peaks-rd/references/writing-handoff-frontmatter.md +1 -1
  248. package/skills/bee/peaks-reviewer/SKILL.md +1 -1
  249. package/skills/bee/peaks-sc/SKILL.md +1 -1
  250. package/skills/bee/peaks-security-audit/SKILL.md +10 -2
  251. package/skills/bee/peaks-txt/SKILL.md +4 -3
  252. package/skills/bee/peaks-ui/SKILL.md +3 -3
  253. package/skills/peaks-audit/SKILL.md +29 -1
  254. package/skills/peaks-code/SKILL.md +37 -17
  255. package/skills/peaks-code/references/fast-lane-norm.md +42 -0
  256. package/skills/peaks-code/references/fast-mode.md +3 -2
  257. package/skills/peaks-code/references/local-artifact-workspace.md +3 -3
  258. package/skills/peaks-code/references/micro-cycle.md +3 -3
  259. package/skills/peaks-code/references/resume-detection.md +1 -1
  260. package/skills/peaks-code/references/runbook.md +12 -6
  261. package/skills/peaks-code/references/step-11-memory-sediment.md +4 -0
  262. package/skills/peaks-code/references/sub-agent-dispatch.md +1 -1
  263. package/skills/peaks-code/references/swarm-dispatch-contract.md +40 -16
  264. package/skills/peaks-code/references/workflow-gates-and-types.md +6 -6
  265. package/skills/peaks-code/references/worktree-governance.md +4 -4
  266. package/skills/peaks-content/SKILL.md +1 -1
  267. package/skills/peaks-doctor/SKILL.md +1 -1
  268. package/skills/peaks-final-review/SKILL.md +31 -11
  269. package/skills/peaks-ide/SKILL.md +1 -1
  270. package/skills/peaks-issue-fix-orchestrator/SKILL.md +1 -1
  271. package/skills/peaks-race-code/SKILL.md +185 -0
  272. package/skills/peaks-resume/SKILL.md +1 -1
  273. package/skills/peaks-slice-decompose/SKILL.md +1 -1
  274. package/skills/peaks-solo/SKILL.md +1 -1
  275. package/skills/peaks-sop/SKILL.md +1 -1
  276. package/skills/peaks-status/SKILL.md +1 -1
  277. package/skills/peaks-test/SKILL.md +7 -4
  278. package/dist/cli/commands/vm-command-shared.d.ts +0 -23
  279. package/dist/cli/commands/vm-command-shared.js +0 -23
  280. package/dist/cli/commands/vm-commands.d.ts +0 -3
  281. package/dist/cli/commands/vm-commands.js +0 -45
  282. package/dist/cli/commands/vm-hypervisor-probe.d.ts +0 -27
  283. package/dist/cli/commands/vm-hypervisor-probe.js +0 -78
  284. package/dist/cli/commands/vm-hypervisor-runtime.d.ts +0 -15
  285. package/dist/cli/commands/vm-hypervisor-runtime.js +0 -64
  286. package/dist/cli/commands/vm-release-command.d.ts +0 -5
  287. package/dist/cli/commands/vm-release-command.js +0 -101
  288. package/dist/cli/commands/vm-spawn-command.d.ts +0 -5
  289. package/dist/cli/commands/vm-spawn-command.js +0 -177
  290. package/dist/cli/commands/vm-status-command.js +0 -50
  291. package/dist/services/audit/enforcers/lint-peaks-skill-runtime.d.ts +0 -23
  292. package/dist/services/audit/enforcers/lint-peaks-skill-runtime.js +0 -64
  293. package/dist/services/vm/vm-lease.d.ts +0 -40
  294. package/dist/services/vm/vm-lease.js +0 -160
@@ -1,9 +1,9 @@
1
1
  /**
2
- * Coverage Evidence reader for c8 `coverage-summary.json` (Fix-6B).
2
+ * Coverage Evidence reader for the istanbul `coverage-summary.json` shape (Fix-6B).
3
3
  *
4
4
  * - pure helper module, no side effects beyond FS reads
5
- * - reads the istanbul-reporter JSON shape emitted by `c8 --reporter=json-summary`
6
- * (the project's coverage tool — see scripts/coverage-c8.mjs)
5
+ * - reads the istanbul-reporter JSON shape a `--reporter=json-summary` run emits
6
+ * (the project's instrument is `.husky/coverage-ratchet.mjs`, which emits it)
7
7
  * - resolves a `coverage-summary.json` from a fixed discovery order
8
8
  * - validates per-capability coverage against a `## Capability Mapping` block
9
9
  *
@@ -14,7 +14,7 @@
14
14
  *
15
15
  * Conventions:
16
16
  * - All paths are POSIX-normalized for JSON safety.
17
- * - The c8 summary's per-file keys are project-root-relative POSIX paths
17
+ * - The summary's per-file keys are project-root-relative POSIX paths
18
18
  * (e.g. `src/services/openspec/openspec-archive-service.ts`).
19
19
  * - Capability mapping `source` field is also project-root-relative, may be
20
20
  * a file (`foo.ts`) or a directory (`src/services/openspec/`).
@@ -37,7 +37,7 @@ export type CoverageSummary = {
37
37
  files: ReadonlyMap<string, CoverageFileEntry>;
38
38
  };
39
39
  export type CoverageFileEntry = {
40
- /** Absolute path the c8 entry covers (POSIX). */
40
+ /** Absolute path the summary entry covers (POSIX). */
41
41
  path: string;
42
42
  /** Project-root-relative POSIX path (the key the summary uses). */
43
43
  relativePath: string;
@@ -101,7 +101,7 @@ export type CoverageValidation = {
101
101
  *
102
102
  * Discovery order (per Fix-6B AC1):
103
103
  * 1. `explicitPath` (passed via `--coverage-summary`)
104
- * 2. `<projectRoot>/coverage/coverage-summary.json` (c8 wrapper default)
104
+ * 2. `<projectRoot>/coverage/coverage-summary.json` (the coverage run's default)
105
105
  * 3. `<projectRoot>/openspec/coverage-summary.json` (per-project override)
106
106
  *
107
107
  * Returns:
@@ -153,7 +153,7 @@ export declare function parseCapabilityMapping(proposalPath: string): Promise<{
153
153
  * - File path: returns `[file]`.
154
154
  * - Directory path: returns every `*.ts` file recursively under it (relative
155
155
  * to `projectRoot`, POSIX separators). Non-TS files are excluded because
156
- * c8 only collects coverage on TS source modules.
156
+ * the summary only carries TS source modules.
157
157
  */
158
158
  export declare function resolveCapabilityFiles(input: {
159
159
  projectRoot: string;
@@ -161,7 +161,7 @@ export declare function resolveCapabilityFiles(input: {
161
161
  }): Promise<ReadonlyArray<string>>;
162
162
  /**
163
163
  * Validate per-capability coverage. Each capability row's `source` is resolved
164
- * to one or more files; each file must appear in the c8 summary with all four
164
+ * to one or more files; each file must appear in the summary with all four
165
165
  * metrics at exactly 100%.
166
166
  *
167
167
  * Returns `{ ok: true }` when every capability passes; `{ ok: false, mismatches }`
@@ -175,7 +175,7 @@ export declare function validateCapabilityCoverage(input: {
175
175
  }): Promise<CoverageValidation>;
176
176
  /**
177
177
  * Compare the mtime of every spec/proposal/tasks file under the change against
178
- * the mtime of the c8 summary. If any change file is newer than the summary,
178
+ * the mtime of the summary. If any change file is newer than the summary,
179
179
  * the captured V8 counters no longer match the source on disk and the summary
180
180
  * is stale.
181
181
  *
@@ -1,9 +1,9 @@
1
1
  /**
2
- * Coverage Evidence reader for c8 `coverage-summary.json` (Fix-6B).
2
+ * Coverage Evidence reader for the istanbul `coverage-summary.json` shape (Fix-6B).
3
3
  *
4
4
  * - pure helper module, no side effects beyond FS reads
5
- * - reads the istanbul-reporter JSON shape emitted by `c8 --reporter=json-summary`
6
- * (the project's coverage tool — see scripts/coverage-c8.mjs)
5
+ * - reads the istanbul-reporter JSON shape a `--reporter=json-summary` run emits
6
+ * (the project's instrument is `.husky/coverage-ratchet.mjs`, which emits it)
7
7
  * - resolves a `coverage-summary.json` from a fixed discovery order
8
8
  * - validates per-capability coverage against a `## Capability Mapping` block
9
9
  *
@@ -14,7 +14,7 @@
14
14
  *
15
15
  * Conventions:
16
16
  * - All paths are POSIX-normalized for JSON safety.
17
- * - The c8 summary's per-file keys are project-root-relative POSIX paths
17
+ * - The summary's per-file keys are project-root-relative POSIX paths
18
18
  * (e.g. `src/services/openspec/openspec-archive-service.ts`).
19
19
  * - Capability mapping `source` field is also project-root-relative, may be
20
20
  * a file (`foo.ts`) or a directory (`src/services/openspec/`).
@@ -36,7 +36,7 @@ const DEFAULT_DISCOVERY = [
36
36
  *
37
37
  * Discovery order (per Fix-6B AC1):
38
38
  * 1. `explicitPath` (passed via `--coverage-summary`)
39
- * 2. `<projectRoot>/coverage/coverage-summary.json` (c8 wrapper default)
39
+ * 2. `<projectRoot>/coverage/coverage-summary.json` (the coverage run's default)
40
40
  * 3. `<projectRoot>/openspec/coverage-summary.json` (per-project override)
41
41
  *
42
42
  * Returns:
@@ -238,7 +238,7 @@ function parseCapabilityRow(line) {
238
238
  * - File path: returns `[file]`.
239
239
  * - Directory path: returns every `*.ts` file recursively under it (relative
240
240
  * to `projectRoot`, POSIX separators). Non-TS files are excluded because
241
- * c8 only collects coverage on TS source modules.
241
+ * the summary only carries TS source modules.
242
242
  */
243
243
  export async function resolveCapabilityFiles(input) {
244
244
  const abs = resolve(input.projectRoot, input.row.source);
@@ -280,7 +280,7 @@ async function walkTsFiles(absRoot, projectRoot) {
280
280
  // ---------------------------------------------------------------------------
281
281
  /**
282
282
  * Validate per-capability coverage. Each capability row's `source` is resolved
283
- * to one or more files; each file must appear in the c8 summary with all four
283
+ * to one or more files; each file must appear in the summary with all four
284
284
  * metrics at exactly 100%.
285
285
  *
286
286
  * Returns `{ ok: true }` when every capability passes; `{ ok: false, mismatches }`
@@ -336,7 +336,7 @@ export async function validateCapabilityCoverage(input) {
336
336
  // ---------------------------------------------------------------------------
337
337
  /**
338
338
  * Compare the mtime of every spec/proposal/tasks file under the change against
339
- * the mtime of the c8 summary. If any change file is newer than the summary,
339
+ * the mtime of the summary. If any change file is newer than the summary,
340
340
  * the captured V8 counters no longer match the source on disk and the summary
341
341
  * is stale.
342
342
  *
@@ -38,7 +38,7 @@ export type CoverageEvidence = {
38
38
  capabilityRows: ReadonlyArray<CapabilityMappingRow>;
39
39
  /** Resolved coverage-summary.json absolute path (Fix-6B). */
40
40
  summaryPath?: string;
41
- /** Freshness status of the c8 summary relative to change files. */
41
+ /** Freshness status of the summary relative to change files. */
42
42
  summaryStatus: 'missing' | 'stale' | 'fresh' | 'unavailable';
43
43
  /** Per-capability validation outcome. */
44
44
  capabilityValidation: 'ok' | 'mismatch' | 'no-mapping' | 'not-enforced';
@@ -218,7 +218,7 @@ export async function archiveOpenSpecChange(changeId, options = {}) {
218
218
  });
219
219
  }
220
220
  }
221
- // --- Fix-6B: parse Capability Mapping block + validate against c8 summary ---
221
+ // --- Fix-6B: parse Capability Mapping block + validate against the summary ---
222
222
  const mapping = await parseCapabilityMapping(proposalPath);
223
223
  coverage = {
224
224
  ...coverage,
@@ -245,7 +245,7 @@ export async function archiveOpenSpecChange(changeId, options = {}) {
245
245
  ? summaryPathResult.error.triedPaths
246
246
  : [summaryPathResult.error.path];
247
247
  throw new OpenSpecArchiveError('OPENSPEC_COVERAGE_EVIDENCE_MISSING', `Refusing to archive "${changeId}": no coverage-summary.json found at any of: ${triedPaths.join(', ')}. ` +
248
- 'Run `pnpm test:coverage` (which invokes scripts/coverage-c8.mjs) to generate one, ' +
248
+ 'Generate coverage/coverage-summary.json with the project coverage run (`.husky/coverage-ratchet.mjs` here), ' +
249
249
  'or pass --coverage-summary <path> to point at an existing summary, ' +
250
250
  'or re-run with --force to bypass.', {
251
251
  changeId,
@@ -260,7 +260,7 @@ export async function archiveOpenSpecChange(changeId, options = {}) {
260
260
  }
261
261
  catch (error) {
262
262
  throw new OpenSpecArchiveError('OPENSPEC_COVERAGE_EVIDENCE_MISSING', `Refusing to archive "${changeId}": coverage-summary.json at ${summaryPathResult.value} is malformed (${error.message}). ` +
263
- 'Re-run `pnpm test:coverage` to regenerate, or pass --coverage-summary <path> to point at a valid summary.', { changeId, path: summaryPathResult.value, coverage });
263
+ 'Re-generate coverage/coverage-summary.json, or pass --coverage-summary <path> to point at a valid summary.', { changeId, path: summaryPathResult.value, coverage });
264
264
  }
265
265
  coverage = {
266
266
  ...coverage,
@@ -279,7 +279,7 @@ export async function archiveOpenSpecChange(changeId, options = {}) {
279
279
  staleFiles
280
280
  };
281
281
  throw new OpenSpecArchiveError('OPENSPEC_COVERAGE_EVIDENCE_STALE', `Refusing to archive "${changeId}": coverage-summary.json is older than ${staleFiles.length} change file(s). ` +
282
- 'Re-run `pnpm test:coverage` to refresh, or re-run with --force to bypass.', { changeId, staleFiles, summaryPath: summary.path, coverage });
282
+ 'Re-generate coverage/coverage-summary.json to refresh, or re-run with --force to bypass.', { changeId, staleFiles, summaryPath: summary.path, coverage });
283
283
  }
284
284
  coverage = {
285
285
  ...coverage,
@@ -301,8 +301,8 @@ export async function archiveOpenSpecChange(changeId, options = {}) {
301
301
  coverageMismatchBypassed = true;
302
302
  }
303
303
  else {
304
- throw new OpenSpecArchiveError('OPENSPEC_COVERAGE_EVIDENCE_MISMATCH', `Refusing to archive "${changeId}": ${validation.mismatches.length} capability row(s) claim "covered" in proposal.md but c8 reports < 100% coverage. ` +
305
- 'Re-run `pnpm test:coverage` after closing the gap, or re-run with --force to bypass.', {
304
+ throw new OpenSpecArchiveError('OPENSPEC_COVERAGE_EVIDENCE_MISMATCH', `Refusing to archive "${changeId}": ${validation.mismatches.length} capability row(s) claim "covered" in proposal.md but the coverage summary reports < 100% coverage. ` +
305
+ 'Re-generate coverage/coverage-summary.json after closing the gap, or re-run with --force to bypass.', {
306
306
  changeId,
307
307
  mismatches: validation.mismatches,
308
308
  coverage
@@ -39,9 +39,10 @@
39
39
  * `AUDIT_REQUIRES_HANDOFF` row. An earlier revision of this comment
40
40
  * claimed three, and QA caught prose that disagreed with the code, which
41
41
  * is the defect this module exists to end. The security path declared is
42
- * the config-specific `rd/security-review.md` — genuinely ridless, per its
43
- * own row — not the documented `audit/security-<rid>.md`, which no config
44
- * slice writes)
42
+ * the config-specific `rd/security-review-<rid>.md` (it carried no rid
43
+ * until slice 9.37, so the second config slice in a session overwrote the
44
+ * first's review) — not the documented `audit/security-<rid>.md`, which no
45
+ * config slice writes)
45
46
  * - docs / chore → NOTHING. No `rd:qa-handoff` row ⇒ nothing for Gate C
46
47
  * to validate ⇒ nothing declared (see below)
47
48
  *
@@ -39,9 +39,10 @@
39
39
  * `AUDIT_REQUIRES_HANDOFF` row. An earlier revision of this comment
40
40
  * claimed three, and QA caught prose that disagreed with the code, which
41
41
  * is the defect this module exists to end. The security path declared is
42
- * the config-specific `rd/security-review.md` — genuinely ridless, per its
43
- * own row — not the documented `audit/security-<rid>.md`, which no config
44
- * slice writes)
42
+ * the config-specific `rd/security-review-<rid>.md` (it carried no rid
43
+ * until slice 9.37, so the second config slice in a session overwrote the
44
+ * first's review) — not the documented `audit/security-<rid>.md`, which no
45
+ * config slice writes)
45
46
  * - docs / chore → NOTHING. No `rd:qa-handoff` row ⇒ nothing for Gate C
46
47
  * to validate ⇒ nothing declared (see below)
47
48
  *
@@ -185,15 +185,29 @@ function checkBody(call, sourceFile, relPath) {
185
185
  expected: 'block-body callback with // given: / // when: / // then: comments at the top'
186
186
  };
187
187
  }
188
+ /**
189
+ * The callback block of an `it` / `test` call, or null when the call has
190
+ * no block-bodied callback.
191
+ *
192
+ * THE CALLBACK IS NOT `arguments[1]`. vitest accepts an options object
193
+ * between the description and the callback — `it(name, { timeout }, fn)` —
194
+ * and this repo's own test files use that overload. Read at a fixed
195
+ * position, the options object is neither an arrow nor a function
196
+ * expression, so this returned null, the comment check never ran, and a
197
+ * conformant file came back `missing-given-when-then`: a WRONG verdict,
198
+ * not a missed one. So the callback is the LAST argument that is an arrow
199
+ * or a function expression, at whatever arity.
200
+ */
188
201
  function getCallbackBlock(call) {
189
- const callback = call.arguments[1];
190
- if (callback === undefined)
191
- return null;
192
- if (!ts.isArrowFunction(callback) && !ts.isFunctionExpression(callback))
193
- return null;
194
- if (!callback.body || !ts.isBlock(callback.body))
195
- return null;
196
- return callback.body;
202
+ for (let i = call.arguments.length - 1; i >= 0; i -= 1) {
203
+ const arg = call.arguments[i];
204
+ if (arg === undefined)
205
+ continue;
206
+ if (!ts.isArrowFunction(arg) && !ts.isFunctionExpression(arg))
207
+ continue;
208
+ return ts.isBlock(arg.body) ? arg.body : null;
209
+ }
210
+ return null;
197
211
  }
198
212
  function checkBlockLeadingComments(block, sourceFile, relPath) {
199
213
  // TypeScript's `getLeadingCommentRanges` API is unreliable for
@@ -0,0 +1,58 @@
1
+ import type { RaceGate2Policy } from './gate2-policy.js';
2
+ export type LaneChosenBy = 'user-named' | 'user-picked';
3
+ export type TaskOutcome = 'landed' | 'escalated' | 'stopped';
4
+ export type RiskSurfaceHandling = 'refused' | 'escalated' | 'user-override-recorded' | 'none';
5
+ export type PilotGateVerdict = 'pass' | 'fail' | 'insufficient-evidence';
6
+ export type PilotTaskRow = {
7
+ readonly rid: string;
8
+ readonly sessionId: string;
9
+ readonly date: string;
10
+ readonly laneChosenBy: LaneChosenBy;
11
+ readonly outcome: TaskOutcome;
12
+ readonly filesChanged: readonly string[];
13
+ readonly riskSurfacesHit: readonly number[];
14
+ readonly riskSurfaceHandling: RiskSurfaceHandling;
15
+ readonly rolledBack: boolean;
16
+ readonly ciRed: boolean;
17
+ readonly missedRiskSurface: boolean;
18
+ };
19
+ export type PilotGateCounts = {
20
+ readonly taskCount: number;
21
+ readonly coreCapabilityTaskCount: number;
22
+ readonly sessionCount: number;
23
+ readonly safetyArmExercisedCount: number;
24
+ readonly rollbackCount: number;
25
+ readonly ciRedCount: number;
26
+ readonly missedRiskSurfaceCount: number;
27
+ };
28
+ export type PilotGateReason = {
29
+ readonly code: string;
30
+ readonly message: string;
31
+ readonly observed: number;
32
+ readonly threshold: number;
33
+ };
34
+ export type PilotGateEvaluation = {
35
+ readonly verdict: PilotGateVerdict;
36
+ readonly counts: PilotGateCounts;
37
+ readonly reasons: readonly PilotGateReason[];
38
+ };
39
+ /**
40
+ * The safety arm fired and left a disposition. A hit with `'none'` is a MISSING
41
+ * record, not a clean row — so `'none'` does not count (PRD §3.2(b)).
42
+ *
43
+ * Counting basis is deliberately different from `taskCount`'s: this predicate is
44
+ * applied over ALL records, `escalated` and `stopped` included. An escalation is
45
+ * the safety arm firing correctly, and a landed-only reading would exclude the
46
+ * one sample where it did (PRD §3.1, the exception paragraph).
47
+ */
48
+ export declare function safetyArmExercised(row: PilotTaskRow): boolean;
49
+ /**
50
+ * The coverage condition, DERIVED — never a `coreCapability: true` the author
51
+ * wrote (PRD §3.2). A row qualifies by reaching a hard-blocked family, or by
52
+ * exercising the safety arm.
53
+ *
54
+ * It does NOT test `outcome`: the caller applies this over landed rows only
55
+ * (§3.1), which is a property of the counting set, not of the predicate.
56
+ */
57
+ export declare function taskExercisesCoreCapability(row: PilotTaskRow): boolean;
58
+ export declare function evaluatePilotGate(tasks: readonly PilotTaskRow[], policy: RaceGate2Policy): PilotGateEvaluation;
@@ -0,0 +1,111 @@
1
+ // src/services/race/gate2-evaluator.ts
2
+ //
3
+ // PURE. This module imports no `node:fs` and never writes: the evaluator judges,
4
+ // the store (`pilot-gate-store.ts`) is the only I/O module, and the CLI verb
5
+ // `race pilot-gate record` is the only writer. `peaks race pilot-status` is
6
+ // read-only and proven so by a test that diffs the evidence file's bytes.
7
+ //
8
+ // The verdict semantics are the PRD's §3.3 verbatim:
9
+ //
10
+ // any hard zero above its max -> fail (this branch wins)
11
+ // else all four floors met -> pass
12
+ // else -> insufficient-evidence
13
+ //
14
+ // `insufficient-evidence` is not a failure. It is "keep running the pilot".
15
+ /** Hard-blocked path families — imported from the hook constant, never restated (PRD U-D). */
16
+ import { HARD_BLOCKED_PATH_FAMILIES } from '../hooks/pre-tool-code-gate.js';
17
+ /**
18
+ * The safety arm fired and left a disposition. A hit with `'none'` is a MISSING
19
+ * record, not a clean row — so `'none'` does not count (PRD §3.2(b)).
20
+ *
21
+ * Counting basis is deliberately different from `taskCount`'s: this predicate is
22
+ * applied over ALL records, `escalated` and `stopped` included. An escalation is
23
+ * the safety arm firing correctly, and a landed-only reading would exclude the
24
+ * one sample where it did (PRD §3.1, the exception paragraph).
25
+ */
26
+ export function safetyArmExercised(row) {
27
+ return row.riskSurfacesHit.length > 0 && row.riskSurfaceHandling !== 'none';
28
+ }
29
+ /**
30
+ * The coverage condition, DERIVED — never a `coreCapability: true` the author
31
+ * wrote (PRD §3.2). A row qualifies by reaching a hard-blocked family, or by
32
+ * exercising the safety arm.
33
+ *
34
+ * It does NOT test `outcome`: the caller applies this over landed rows only
35
+ * (§3.1), which is a property of the counting set, not of the predicate.
36
+ */
37
+ export function taskExercisesCoreCapability(row) {
38
+ return row.filesChanged.some(isInHardBlockedFamily) || safetyArmExercised(row);
39
+ }
40
+ function isInHardBlockedFamily(file) {
41
+ const normalized = file.replace(/\\/g, '/');
42
+ return HARD_BLOCKED_PATH_FAMILIES.some((family) => normalized.startsWith(family));
43
+ }
44
+ function belowMin(code, quantity, observed, threshold) {
45
+ if (observed >= threshold)
46
+ return null;
47
+ return {
48
+ code,
49
+ message: `${quantity} is ${observed}, below the minimum of ${threshold}`,
50
+ observed,
51
+ threshold
52
+ };
53
+ }
54
+ function aboveMax(code, quantity, observed, threshold) {
55
+ if (observed <= threshold)
56
+ return null;
57
+ return {
58
+ code,
59
+ message: `${quantity} is ${observed}, above the maximum of ${threshold}`,
60
+ observed,
61
+ threshold
62
+ };
63
+ }
64
+ function isReason(reason) {
65
+ return reason !== null;
66
+ }
67
+ /** The four floors are counted over landed rows; the three hard zeros over every record. */
68
+ function countPilotTasks(tasks) {
69
+ const landed = tasks.filter((row) => row.outcome === 'landed');
70
+ return {
71
+ taskCount: landed.length,
72
+ coreCapabilityTaskCount: landed.filter(taskExercisesCoreCapability).length,
73
+ sessionCount: new Set(landed.map((row) => row.sessionId)).size,
74
+ safetyArmExercisedCount: tasks.filter(safetyArmExercised).length,
75
+ rollbackCount: tasks.filter((row) => row.rolledBack).length,
76
+ ciRedCount: tasks.filter((row) => row.ciRed).length,
77
+ missedRiskSurfaceCount: tasks.filter((row) => row.missedRiskSurface).length
78
+ };
79
+ }
80
+ /**
81
+ * Hard zeros are safety quantities, read over ALL rows — an escalated task that
82
+ * was rolled back is still a rollback — and one non-zero is `fail` before any
83
+ * "is the sample big enough?" discussion starts (§3).
84
+ */
85
+ function hardZeroReasonsFor(counts, policy) {
86
+ return [
87
+ aboveMax('rollback-above-max', 'rollbackCount', counts.rollbackCount, policy.rollbackCountMax),
88
+ aboveMax('ci-red-above-max', 'ciRedCount', counts.ciRedCount, policy.ciRedCountMax),
89
+ aboveMax('missed-risk-surface-above-max', 'missedRiskSurfaceCount', counts.missedRiskSurfaceCount, policy.missedRiskSurfaceCountMax)
90
+ ].filter(isReason);
91
+ }
92
+ function floorReasonsFor(counts, policy) {
93
+ return [
94
+ belowMin('task-count-below-min', 'taskCount', counts.taskCount, policy.taskCountMin),
95
+ belowMin('core-capability-below-min', 'coreCapabilityTaskCount', counts.coreCapabilityTaskCount, policy.coreCapabilityTaskCountMin),
96
+ belowMin('session-count-below-min', 'sessionCount', counts.sessionCount, policy.sessionCountMin),
97
+ belowMin('safety-arm-below-min', 'safetyArmExercisedCount', counts.safetyArmExercisedCount, policy.safetyArmExercisedMin)
98
+ ].filter(isReason);
99
+ }
100
+ export function evaluatePilotGate(tasks, policy) {
101
+ const counts = countPilotTasks(tasks);
102
+ const hardZeroReasons = hardZeroReasonsFor(counts, policy);
103
+ if (hardZeroReasons.length > 0) {
104
+ return { verdict: 'fail', counts, reasons: hardZeroReasons };
105
+ }
106
+ const floorReasons = floorReasonsFor(counts, policy);
107
+ if (floorReasons.length === 0) {
108
+ return { verdict: 'pass', counts, reasons: [] };
109
+ }
110
+ return { verdict: 'insufficient-evidence', counts, reasons: floorReasons };
111
+ }
@@ -0,0 +1,17 @@
1
+ export declare const RACE_GATE2_POLICY_VERSION = "race-gate2-policy-v1";
2
+ export type RaceGate2Policy = {
3
+ /** Floor: landed tasks only (§3.1). */
4
+ readonly taskCountMin: number;
5
+ /** Floor: landed tasks whose change reached the lane's core capability (§3.2). */
6
+ readonly coreCapabilityTaskCountMin: number;
7
+ /** Floor: distinct sessions among landed tasks. */
8
+ readonly sessionCountMin: number;
9
+ /** Floor: safety-arm hits over ALL records, escalated and stopped included (§3.1 exception). */
10
+ readonly safetyArmExercisedMin: number;
11
+ /** Hard zero: any rise is a failure, and it is never part of the "not enough sample" discussion. */
12
+ readonly rollbackCountMax: number;
13
+ readonly ciRedCountMax: number;
14
+ readonly missedRiskSurfaceCountMax: number;
15
+ readonly rationale: string;
16
+ };
17
+ export declare const RACE_GATE2_POLICY_V1: RaceGate2Policy;
@@ -0,0 +1,31 @@
1
+ // src/services/race/gate2-policy.ts
2
+ //
3
+ // THE ONE COMPUTATIONAL SOURCE of the race-lane gate-2 threshold policy.
4
+ //
5
+ // The tracked evidence file `.peaks/race/pilot-gate.json` carries a `policy`
6
+ // block too, but that is the RECORD of what was applied, written by the writer
7
+ // from this constant — never the authority. If the file's block were the source,
8
+ // weakening it in the tracked file would launder the gate.
9
+ //
10
+ // Changing the policy means changing RACE_GATE2_POLICY_VERSION with it, so a
11
+ // historical verdict is never re-interpreted under a policy it was not judged by.
12
+ //
13
+ // The rationale is quoted verbatim from §3 of the gate-2 threshold-policy PRD,
14
+ // because a threshold whose basis is dropped is a number nobody can re-derive.
15
+ export const RACE_GATE2_POLICY_VERSION = 'race-gate2-policy-v1';
16
+ const RATIONALE_LINES = [
17
+ '>= 10 的依据是 rule of three:n 次全绿、零观测失败时,真实失败率的 95% 上界 ≈ 1 − 0.05^(1/n)。n=10 ⇒ ≈ 26%。这是保守但可达的档:按 2026-10-11 的速度(一天 4 条落地)约 3 个工作日。',
18
+ '>= 3 条压核心的依据是前瞻的,不是回溯的:只数任务数的政策会让 10 条从未碰过硬阻断路径的任务通过一道从未测试过收益路径的门——这正是「散文判据」的翻版:数得到,但证明不了要证明的事。',
19
+ '>= 1 安全臂的依据是本轮的实测:2026-10-11 的 4 条 landed 全部 riskSurfacesHit: [];唯一真命中过风险面的(row 7,rid-emit-helpers-escalated)是升级未落地的那条——所以这条泳道的安全承诺从未在任何一条落地的任务上被测过。因此这一条与 taskCount 的口径不同,统计所有记录(含 escalated):升级本身就是安全臂正确开火的证据,只数 landed 会把它恰好排除掉。',
20
+ '>= 2 个 session 的依据:单 session 的多条任务共享同一份上下文与同一个操作者状态(2026-10-11 的 4 条全在一个 session 里)。跨 session 是最便宜的「不是一次侥幸」证据。'
21
+ ];
22
+ export const RACE_GATE2_POLICY_V1 = {
23
+ taskCountMin: 10,
24
+ coreCapabilityTaskCountMin: 3,
25
+ sessionCountMin: 2,
26
+ safetyArmExercisedMin: 1,
27
+ rollbackCountMax: 0,
28
+ ciRedCountMax: 0,
29
+ missedRiskSurfaceCountMax: 0,
30
+ rationale: RATIONALE_LINES.join('\n')
31
+ };
@@ -0,0 +1,19 @@
1
+ export declare const LANE_PHASE_VALUES: readonly ["name-only", "offered-by-default"];
2
+ export type LanePhase = (typeof LANE_PHASE_VALUES)[number];
3
+ export type LanePhaseFile = {
4
+ readonly phase: LanePhase;
5
+ };
6
+ export type ReadLanePhaseResult = {
7
+ readonly kind: 'ok';
8
+ readonly path: string;
9
+ readonly file: LanePhaseFile;
10
+ } | {
11
+ readonly kind: 'missing';
12
+ readonly path: string;
13
+ } | {
14
+ readonly kind: 'invalid';
15
+ readonly path: string;
16
+ readonly message: string;
17
+ };
18
+ export declare function lanePhasePath(projectRoot: string): string;
19
+ export declare function readLanePhase(projectRoot: string): ReadLanePhaseResult;
@@ -0,0 +1,113 @@
1
+ // src/services/race/lane-phase.ts
2
+ //
3
+ // THE ONLY READER of the race lane's phase. `.peaks/race/lane-phase.json` holds one
4
+ // object with one key, `phase`, whose value is one of two tokens.
5
+ //
6
+ // WHY THE PHASE IS A FILE WITH A GRAMMAR. Written as a sentence in a markdown file it
7
+ // had no grammar, so a guard could only recognise the declaration by a spelling
8
+ // pattern, and every spelling a reader would accept while the pattern missed it was
9
+ // invisible to the guard. The reader cannot miss one: a value outside the enum, a second
10
+ // key, a duplicate key (plain or spelled with an escape), or a missing file is a refusal
11
+ // rather than something silently carried.
12
+ //
13
+ // A MISSING FILE IS A REFUSAL, NOT A DEFAULT. "Exactly one legal value" is a parser
14
+ // guarantee, so absence must not resolve to one.
15
+ import { lstatSync, readFileSync } from 'node:fs';
16
+ import { join } from 'node:path';
17
+ import { z } from 'zod';
18
+ export const LANE_PHASE_VALUES = ['name-only', 'offered-by-default'];
19
+ /**
20
+ * The enum makes a value outside the two legal tokens unrepresentable, and `strict()`
21
+ * refuses an unknown key. `strict()` alone still lets `__proto__` through — it is an own,
22
+ * enumerable key that zod does not treat as unknown — so `readLanePhase` also requires the
23
+ * parsed object's own keys to be exactly `['phase']`. Together, an unknown key is a
24
+ * rejection rather than a key silently carried.
25
+ */
26
+ const lanePhaseFileSchema = z.object({ phase: z.enum(LANE_PHASE_VALUES) }).strict();
27
+ export function lanePhasePath(projectRoot) {
28
+ return join(projectRoot, '.peaks', 'race', 'lane-phase.json');
29
+ }
30
+ /**
31
+ * Inspect the path and read the file. `lstat` (not `stat`) so a symlink is seen as the link
32
+ * rather than followed; `throwIfNoEntry: false` makes absence a value rather than a throw; and the
33
+ * `catch` keeps the reader's contract — a tagged result, never an exception — for a path it cannot
34
+ * inspect at all (a NUL byte, say, where a bare `existsSync` returned `false`). `JSON.parse`'s own
35
+ * message quotes the bytes it choked on, so a parse failure is reported without the file's content.
36
+ */
37
+ function readCarrier(path) {
38
+ let stat;
39
+ try {
40
+ stat = lstatSync(path, { throwIfNoEntry: false });
41
+ }
42
+ catch {
43
+ return { kind: 'invalid', message: 'the carrier path could not be inspected' };
44
+ }
45
+ if (stat === undefined)
46
+ return { kind: 'missing' };
47
+ if (!stat.isFile())
48
+ return { kind: 'invalid', message: 'the carrier path is not a regular file' };
49
+ let text;
50
+ let raw;
51
+ try {
52
+ text = readFileSync(path, 'utf8');
53
+ raw = JSON.parse(text);
54
+ }
55
+ catch {
56
+ return { kind: 'invalid', message: 'the file is not valid JSON' };
57
+ }
58
+ return { kind: 'ok', text, raw };
59
+ }
60
+ /**
61
+ * The raw-text refusal, or `null` when the text declares `"phase"` exactly once. No file this
62
+ * project writes needs a backslash: the only key is `phase` and the only values are `name-only`
63
+ * and `offered-by-default`, none of which needs an escape. Refusing one outright is broader than
64
+ * JSON's grammar — it also refuses a file that escapes a letter of the key, which decodes to a
65
+ * legal value — but the wider refusal errs in the safe direction, and it means the key cannot be
66
+ * written as an escape that `JSON.parse` reads as the property `phase` while a count of the
67
+ * literal text misses it. With no escape, the count sees every declaration, so a repeated key that
68
+ * `JSON.parse` would resolve by keeping the LAST is refused instead.
69
+ */
70
+ function duplicateDeclarationMessage(text) {
71
+ if (text.includes('\\')) {
72
+ return 'the file contains a backslash; write the key plainly as "phase" — an escaped key would hide a second declaration';
73
+ }
74
+ if ((text.match(/"phase"\s*:/g) ?? []).length > 1) {
75
+ return 'the file declares "phase" more than once; exactly one declaration is legal';
76
+ }
77
+ return null;
78
+ }
79
+ /**
80
+ * The own-key refusal, or `null` when the parsed object carries only `phase`. `strict()` refuses an
81
+ * unknown key except `__proto__`; this check closes that hole, so nothing is carried beside it.
82
+ */
83
+ function carriedKeyMessage(raw) {
84
+ if (raw === null || typeof raw !== 'object')
85
+ return null;
86
+ const keys = Object.keys(raw);
87
+ if (keys.length === 1 && keys[0] === 'phase')
88
+ return null;
89
+ return 'the file must hold exactly one key, "phase"';
90
+ }
91
+ export function readLanePhase(projectRoot) {
92
+ const path = lanePhasePath(projectRoot);
93
+ const carrier = readCarrier(path);
94
+ if (carrier.kind === 'missing')
95
+ return { kind: 'missing', path };
96
+ if (carrier.kind === 'invalid')
97
+ return { kind: 'invalid', path, message: carrier.message };
98
+ const duplicate = duplicateDeclarationMessage(carrier.text);
99
+ if (duplicate !== null)
100
+ return { kind: 'invalid', path, message: duplicate };
101
+ const carried = carriedKeyMessage(carrier.raw);
102
+ if (carried !== null)
103
+ return { kind: 'invalid', path, message: carried };
104
+ const parsed = lanePhaseFileSchema.safeParse(carrier.raw);
105
+ if (!parsed.success)
106
+ return { kind: 'invalid', path, message: describeIssues(parsed.error) };
107
+ return { kind: 'ok', path, file: parsed.data };
108
+ }
109
+ function describeIssues(error) {
110
+ return error.issues
111
+ .map((issue) => `${issue.path.join('.') || '<root>'}: ${issue.message}`)
112
+ .join('; ');
113
+ }