peaks-loop 4.1.4 → 4.1.5

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 (240) hide show
  1. package/.claude-plugin/marketplace.json +7 -2
  2. package/CHANGELOG.md +112 -0
  3. package/README-en.md +1 -1
  4. package/README.md +1 -1
  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/code-commands.d.ts +6 -4
  9. package/dist/cli/commands/code-commands.js +6 -4
  10. package/dist/cli/commands/code-gate-command.d.ts +5 -5
  11. package/dist/cli/commands/code-gate-command.js +49 -9
  12. package/dist/cli/commands/code-mode-gate-plan-command.d.ts +1 -1
  13. package/dist/cli/commands/code-mode-gate-plan-command.js +2 -2
  14. package/dist/cli/commands/core/memory-extract-command.js +10 -5
  15. package/dist/cli/commands/dispatch-cli-invocation-check.d.ts +108 -0
  16. package/dist/cli/commands/dispatch-cli-invocation-check.js +87 -0
  17. package/dist/cli/commands/dispatch-cli-invocation-scan.d.ts +66 -0
  18. package/dist/cli/commands/dispatch-cli-invocation-scan.js +162 -0
  19. package/dist/cli/commands/dispatch-commands.js +12 -5
  20. package/dist/cli/commands/dispatch-preflight.js +46 -0
  21. package/dist/cli/commands/dispatch-prompt-composition.d.ts +6 -0
  22. package/dist/cli/commands/dispatch-prompt-composition.js +29 -7
  23. package/dist/cli/commands/doc-commands.js +1 -1
  24. package/dist/cli/commands/feedback-commands-helpers.js +1 -1
  25. package/dist/cli/commands/final-review-prepare-command.js +22 -1
  26. package/dist/cli/commands/gate-commands-enforce.js +3 -3
  27. package/dist/cli/commands/hook-handle.js +41 -20
  28. package/dist/cli/commands/lint-commands.js +3 -1
  29. package/dist/cli/commands/loop-eval-capture-index.js +2 -4
  30. package/dist/cli/commands/perf-audit-commands.js +15 -5
  31. package/dist/cli/commands/project-commands.js +9 -6
  32. package/dist/cli/commands/race-commands.d.ts +15 -0
  33. package/dist/cli/commands/race-commands.js +65 -0
  34. package/dist/cli/commands/race-pilot-gate-record-command.d.ts +3 -0
  35. package/dist/cli/commands/race-pilot-gate-record-command.js +81 -0
  36. package/dist/cli/commands/request-command-options.d.ts +8 -0
  37. package/dist/cli/commands/request-commands.js +2 -0
  38. package/dist/cli/commands/request-init-command.js +67 -12
  39. package/dist/cli/commands/request-retag-command.d.ts +3 -0
  40. package/dist/cli/commands/request-retag-command.js +50 -0
  41. package/dist/cli/commands/request-show-command.d.ts +8 -0
  42. package/dist/cli/commands/request-show-command.js +14 -1
  43. package/dist/cli/commands/request-transition-command.js +12 -4
  44. package/dist/cli/commands/request-transition-failures.d.ts +14 -0
  45. package/dist/cli/commands/request-transition-failures.js +45 -3
  46. package/dist/cli/commands/scan-scope-commands.js +2 -2
  47. package/dist/cli/commands/security-audit-commands.js +26 -6
  48. package/dist/cli/commands/worktree-lease-gc-command.js +1 -1
  49. package/dist/services/artifacts/artifact-contract-block.d.ts +53 -0
  50. package/dist/services/artifacts/artifact-contract-block.js +212 -0
  51. package/dist/services/artifacts/artifact-prerequisites.d.ts +27 -19
  52. package/dist/services/artifacts/artifact-prerequisites.js +63 -133
  53. package/dist/services/artifacts/artifact-templates.d.ts +1 -1
  54. package/dist/services/artifacts/artifact-templates.js +17 -10
  55. package/dist/services/artifacts/prerequisite-checks.d.ts +87 -0
  56. package/dist/services/artifacts/prerequisite-checks.js +198 -0
  57. package/dist/services/artifacts/prerequisite-transition-event.d.ts +20 -0
  58. package/dist/services/artifacts/prerequisite-transition-event.js +27 -0
  59. package/dist/services/artifacts/request-artifact-metadata.d.ts +31 -0
  60. package/dist/services/artifacts/request-artifact-metadata.js +44 -0
  61. package/dist/services/artifacts/request-artifact-service.d.ts +5 -0
  62. package/dist/services/artifacts/request-artifact-service.js +23 -51
  63. package/dist/services/artifacts/request-artifact-state-helpers.d.ts +12 -0
  64. package/dist/services/artifacts/request-artifact-state-helpers.js +28 -4
  65. package/dist/services/artifacts/request-retag-service.d.ts +68 -0
  66. package/dist/services/artifacts/request-retag-service.js +125 -0
  67. package/dist/services/artifacts/request-state-order.d.ts +38 -0
  68. package/dist/services/artifacts/request-state-order.js +99 -0
  69. package/dist/services/artifacts/request-type-demand.d.ts +44 -0
  70. package/dist/services/artifacts/request-type-demand.js +71 -0
  71. package/dist/services/audit/audit-goal-service.d.ts +7 -0
  72. package/dist/services/audit/enforcers/active-skill-resolver.d.ts +18 -0
  73. package/dist/services/audit/enforcers/active-skill-resolver.js +48 -1
  74. package/dist/services/audit/enforcers/code-ban.d.ts +11 -2
  75. package/dist/services/audit/enforcers/code-ban.js +21 -1
  76. package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.d.ts +17 -0
  77. package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.js +24 -7
  78. package/dist/services/audit-independent/handoff-missing-refusal.d.ts +26 -0
  79. package/dist/services/audit-independent/handoff-missing-refusal.js +109 -0
  80. package/dist/services/audit-independent/handoff-readers.d.ts +37 -0
  81. package/dist/services/audit-independent/handoff-readers.js +81 -0
  82. package/dist/services/audit-independent/index.d.ts +6 -1
  83. package/dist/services/audit-independent/index.js +6 -1
  84. package/dist/services/audit-independent/judged-declaration-build.d.ts +48 -0
  85. package/dist/services/audit-independent/judged-declaration-build.js +73 -0
  86. package/dist/services/audit-independent/judged-declaration-check.d.ts +79 -0
  87. package/dist/services/audit-independent/judged-declaration-check.js +155 -0
  88. package/dist/services/audit-independent/judged-declaration.d.ts +94 -0
  89. package/dist/services/audit-independent/judged-declaration.js +218 -0
  90. package/dist/services/audit-independent/perf-audit-service.js +12 -14
  91. package/dist/services/audit-independent/security-audit-artifact.d.ts +28 -0
  92. package/dist/services/audit-independent/security-audit-artifact.js +90 -0
  93. package/dist/services/audit-independent/security-audit-service.d.ts +6 -53
  94. package/dist/services/audit-independent/security-audit-service.js +34 -178
  95. package/dist/services/capability-guard-runner/contracts/J05.js +60 -14
  96. package/dist/services/codegraph/codegraph-index-integrity.js +2 -0
  97. package/dist/services/context/build-dispatch-system-prompt.d.ts +3 -3
  98. package/dist/services/context/build-dispatch-system-prompt.js +7 -7
  99. package/dist/services/context/collector.js +5 -1
  100. package/dist/services/dispatch/active-dispatch-index.d.ts +36 -0
  101. package/dist/services/dispatch/active-dispatch-index.js +118 -0
  102. package/dist/services/dispatch/batch-counter.js +1 -2
  103. package/dist/services/dispatch/dispatch-record-writer.d.ts +29 -16
  104. package/dist/services/dispatch/dispatch-record-writer.js +58 -100
  105. package/dist/services/dispatch/dispatch-sub-agent.js +1 -1
  106. package/dist/services/dispatch/karpathy-block.d.ts +55 -0
  107. package/dist/services/dispatch/karpathy-block.js +101 -0
  108. package/dist/services/dispatch/ledger-reaper.d.ts +80 -0
  109. package/dist/services/dispatch/ledger-reaper.js +131 -0
  110. package/dist/services/evidence/evidence-generator.js +15 -8
  111. package/dist/services/feedback/feedback-promotion-service.d.ts +8 -11
  112. package/dist/services/feedback/feedback-promotion-service.js +30 -35
  113. package/dist/services/feedback/promotion-artifact-json-evidence.d.ts +18 -0
  114. package/dist/services/feedback/promotion-artifact-missing.d.ts +22 -0
  115. package/dist/services/feedback/promotion-artifact-missing.js +63 -0
  116. package/dist/services/final-review/final-review-contract.d.ts +95 -4
  117. package/dist/services/final-review/final-review-contract.js +64 -0
  118. package/dist/services/final-review/final-review-delivery.d.ts +13 -0
  119. package/dist/services/final-review/final-review-delivery.js +26 -12
  120. package/dist/services/final-review/final-review-evidence-collect.js +8 -53
  121. package/dist/services/final-review/final-review-evidence-records.d.ts +21 -0
  122. package/dist/services/final-review/final-review-evidence-records.js +67 -0
  123. package/dist/services/final-review/final-review-evidence-sources.d.ts +22 -0
  124. package/dist/services/final-review/final-review-evidence-sources.js +28 -4
  125. package/dist/services/final-review/final-review-prompt.js +19 -6
  126. package/dist/services/final-review/final-review-runner.js +5 -0
  127. package/dist/services/final-review/final-review-service.d.ts +2 -2
  128. package/dist/services/final-review/index.d.ts +1 -1
  129. package/dist/services/final-review/pre-post-diff.d.ts +2 -75
  130. package/dist/services/final-review/pre-post-diff.js +60 -59
  131. package/dist/services/hooks/pre-tool-code-gate.d.ts +7 -1
  132. package/dist/services/hooks/pre-tool-code-gate.js +21 -2
  133. package/dist/services/hooks/worktree-authorization-gate.js +6 -31
  134. package/dist/services/hooks/worktree-refusal-messages.d.ts +74 -0
  135. package/dist/services/hooks/worktree-refusal-messages.js +102 -0
  136. package/dist/services/lint/eslint-runner-support.d.ts +1 -1
  137. package/dist/services/lint/eslint-runner-support.js +2 -1
  138. package/dist/services/lint/eslint-runner-types.d.ts +8 -0
  139. package/dist/services/lint/eslint-runner.js +17 -4
  140. package/dist/services/llm/anthropic-runner.js +24 -7
  141. package/dist/services/loop/loop-observability.d.ts +39 -0
  142. package/dist/services/loop/loop-observability.js +55 -0
  143. package/dist/services/loop/monotonic-guard.js +6 -9
  144. package/dist/services/loop/monotonic-runner.js +8 -7
  145. package/dist/services/loop/run-driver.js +18 -22
  146. package/dist/services/memory/project-memory-service/index/kind-dispatch.js +14 -1
  147. package/dist/services/memory/project-memory-service/index/project-memory-plan-exec.js +13 -2
  148. package/dist/services/memory/project-memory-service/index.d.ts +2 -2
  149. package/dist/services/memory/project-memory-service/index.js +1 -1
  150. package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.d.ts +36 -0
  151. package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.js +48 -2
  152. package/dist/services/memory/project-memory-service/parsers/markdown-pure.d.ts +23 -1
  153. package/dist/services/memory/project-memory-service/parsers/markdown-pure.js +37 -0
  154. package/dist/services/memory/project-memory-service/types.d.ts +32 -0
  155. package/dist/services/observability/observability-service.d.ts +7 -0
  156. package/dist/services/observability/observability-service.js +2 -1
  157. package/dist/services/prd/gate-evidence-derivation.d.ts +4 -3
  158. package/dist/services/prd/gate-evidence-derivation.js +4 -3
  159. package/dist/services/qa/bdd-test-style-verifier.js +22 -8
  160. package/dist/services/race/gate2-evaluator.d.ts +58 -0
  161. package/dist/services/race/gate2-evaluator.js +111 -0
  162. package/dist/services/race/gate2-policy.d.ts +17 -0
  163. package/dist/services/race/gate2-policy.js +31 -0
  164. package/dist/services/race/lane-phase.d.ts +19 -0
  165. package/dist/services/race/lane-phase.js +113 -0
  166. package/dist/services/race/pilot-gate-store.d.ts +67 -0
  167. package/dist/services/race/pilot-gate-store.js +227 -0
  168. package/dist/services/scan/file-size-baseline.d.ts +26 -0
  169. package/dist/services/scan/file-size-baseline.js +150 -0
  170. package/dist/services/scan/file-size-scan.d.ts +42 -3
  171. package/dist/services/scan/file-size-scan.js +58 -42
  172. package/dist/services/scan/type-sanity-service.js +13 -3
  173. package/dist/services/skill/resume-detector.js +3 -3
  174. package/dist/services/skills/hooks-codegate-superpowers.d.ts +5 -6
  175. package/dist/services/skills/hooks-codegate-superpowers.js +7 -8
  176. package/dist/services/skills/hooks-settings-service.d.ts +1 -1
  177. package/dist/services/skills/hooks-settings-service.js +1 -1
  178. package/dist/services/skills/presence-lease-order.d.ts +13 -0
  179. package/dist/services/skills/presence-lease-order.js +24 -0
  180. package/dist/services/skills/skill-conformance-service.js +1 -0
  181. package/dist/services/skills/skill-statusline-service.js +4 -7
  182. package/dist/services/slice/slice-check-service.js +8 -8
  183. package/dist/services/workflow/pipeline-verify-gate-support.js +2 -1
  184. package/dist/services/workflow/pipeline-verify-service.js +1 -1
  185. package/dist/services/workflow/workflow-skip-service.d.ts +0 -20
  186. package/dist/services/workflow/workflow-skip-service.js +3 -4
  187. package/dist/services/workspace/claude-settings-retirements.d.ts +54 -0
  188. package/dist/services/workspace/claude-settings-retirements.js +112 -0
  189. package/dist/services/workspace/claude-settings-template-merge.d.ts +35 -15
  190. package/dist/services/workspace/claude-settings-template-merge.js +33 -53
  191. package/dist/services/workspace/claude-settings-template.d.ts +62 -12
  192. package/dist/services/workspace/claude-settings-template.js +58 -58
  193. package/dist/services/workspace/migrate-1-4-1-service.js +3 -0
  194. package/dist/services/workspace/reconcile-service.js +0 -1
  195. package/dist/shared/incrementing-number.d.ts +10 -0
  196. package/dist/shared/incrementing-number.js +27 -0
  197. package/package.json +5 -5
  198. package/skills/bee/peaks-perf-audit/SKILL.md +1 -1
  199. package/skills/bee/peaks-prd/SKILL.md +1 -1
  200. package/skills/bee/peaks-qa/SKILL.md +1 -1
  201. package/skills/bee/peaks-qa/references/qa-sub-agent-dispatch.md +2 -2
  202. package/skills/bee/peaks-qa/references/qa-transition-gates.md +1 -1
  203. package/skills/bee/peaks-rd/SKILL.md +2 -2
  204. package/skills/bee/peaks-rd/references/rd-fanout-contracts.md +1 -1
  205. package/skills/bee/peaks-rd/references/rd-sub-agent-dispatch.md +8 -4
  206. package/skills/bee/peaks-rd/references/rd-transition-gates.md +3 -3
  207. package/skills/bee/peaks-rd/references/v2-12-fanout-collapse.md +2 -2
  208. package/skills/bee/peaks-rd/references/writing-handoff-frontmatter.md +1 -1
  209. package/skills/bee/peaks-reviewer/SKILL.md +1 -1
  210. package/skills/bee/peaks-sc/SKILL.md +1 -1
  211. package/skills/bee/peaks-security-audit/SKILL.md +10 -2
  212. package/skills/bee/peaks-txt/SKILL.md +4 -3
  213. package/skills/bee/peaks-ui/SKILL.md +3 -3
  214. package/skills/peaks-audit/SKILL.md +29 -1
  215. package/skills/peaks-code/SKILL.md +5 -2
  216. package/skills/peaks-code/references/fast-lane-norm.md +42 -0
  217. package/skills/peaks-code/references/fast-mode.md +3 -2
  218. package/skills/peaks-code/references/local-artifact-workspace.md +3 -3
  219. package/skills/peaks-code/references/micro-cycle.md +3 -3
  220. package/skills/peaks-code/references/resume-detection.md +1 -1
  221. package/skills/peaks-code/references/runbook.md +12 -6
  222. package/skills/peaks-code/references/step-11-memory-sediment.md +4 -0
  223. package/skills/peaks-code/references/sub-agent-dispatch.md +1 -1
  224. package/skills/peaks-code/references/swarm-dispatch-contract.md +40 -16
  225. package/skills/peaks-code/references/workflow-gates-and-types.md +6 -6
  226. package/skills/peaks-code/references/worktree-governance.md +4 -4
  227. package/skills/peaks-content/SKILL.md +1 -1
  228. package/skills/peaks-doctor/SKILL.md +1 -1
  229. package/skills/peaks-final-review/SKILL.md +31 -11
  230. package/skills/peaks-ide/SKILL.md +1 -1
  231. package/skills/peaks-issue-fix-orchestrator/SKILL.md +1 -1
  232. package/skills/peaks-race-code/SKILL.md +185 -0
  233. package/skills/peaks-resume/SKILL.md +1 -1
  234. package/skills/peaks-slice-decompose/SKILL.md +1 -1
  235. package/skills/peaks-solo/SKILL.md +1 -1
  236. package/skills/peaks-sop/SKILL.md +1 -1
  237. package/skills/peaks-status/SKILL.md +1 -1
  238. package/skills/peaks-test/SKILL.md +7 -4
  239. package/dist/services/audit/enforcers/lint-peaks-skill-runtime.d.ts +0 -23
  240. package/dist/services/audit/enforcers/lint-peaks-skill-runtime.js +0 -64
@@ -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
+ }
@@ -0,0 +1,67 @@
1
+ import { type PilotGateEvaluation, type PilotTaskRow } from './gate2-evaluator.js';
2
+ /** `fast-lane-norm.md` §2 numbers the risk surfaces 1..7; a value outside that is a typo, not a row. */
3
+ export declare const RISK_SURFACE_MAX = 7;
4
+ /**
5
+ * The file's own note, written by the writer so the artifact cannot be produced
6
+ * without it. Two claims it must carry, per PRD §4 and §5.3: what the evidence
7
+ * does NOT prove, and which of the two policy blocks is authoritative.
8
+ */
9
+ export declare const PILOT_GATE_NOTE: string;
10
+ export declare const LANE_CHOSEN_BY_VALUES: readonly ["user-named", "user-picked"];
11
+ export declare const OUTCOME_VALUES: readonly ["landed", "escalated", "stopped"];
12
+ export declare const HANDLING_VALUES: readonly ["refused", "escalated", "user-override-recorded", "none"];
13
+ export type PilotGateFile = {
14
+ readonly policyVersion?: string | undefined;
15
+ readonly tasks: readonly PilotTaskRow[];
16
+ };
17
+ export type ReadPilotGateResult = {
18
+ readonly kind: 'ok';
19
+ readonly path: string;
20
+ readonly gate: PilotGateFile;
21
+ } | {
22
+ readonly kind: 'missing';
23
+ readonly path: string;
24
+ } | {
25
+ readonly kind: 'invalid';
26
+ readonly path: string;
27
+ readonly message: string;
28
+ };
29
+ export type PilotTaskInput = {
30
+ readonly rid: string;
31
+ readonly sessionId: string;
32
+ readonly date: string;
33
+ readonly laneChosenBy: string;
34
+ readonly outcome: string;
35
+ readonly filesChanged: readonly string[];
36
+ readonly riskSurfacesHit: readonly number[];
37
+ readonly riskSurfaceHandling: string;
38
+ readonly rolledBack: boolean;
39
+ readonly ciRed: boolean;
40
+ readonly missedRiskSurface: boolean;
41
+ };
42
+ export declare function pilotGatePath(projectRoot: string): string;
43
+ export declare function readPilotGate(projectRoot: string): ReadPilotGateResult;
44
+ /**
45
+ * Validate one row, fail-closed, each refusal naming the rule it broke. Nothing
46
+ * is written when this returns `invalid`.
47
+ */
48
+ export declare function buildPilotTaskRow(input: PilotTaskInput): {
49
+ readonly kind: 'ok';
50
+ readonly row: PilotTaskRow;
51
+ } | {
52
+ readonly kind: 'invalid';
53
+ readonly message: string;
54
+ };
55
+ /**
56
+ * Idempotent upsert of one row, keyed by `--rid`: a repeated rid replaces that
57
+ * row in place (first-seen order preserved), a new rid is appended. The writer is
58
+ * also the only thing that can refresh `lastEvaluation` — the reader owns no file
59
+ * — which is what keeps the committed evaluation from going stale.
60
+ *
61
+ * Throws when the existing file cannot be read: clobbering unreadable evidence
62
+ * with a fresh one-row file would silently destroy rows.
63
+ */
64
+ export declare function upsertPilotTask(projectRoot: string, row: PilotTaskRow, now?: Date): {
65
+ readonly path: string;
66
+ readonly evaluation: PilotGateEvaluation;
67
+ };
@@ -0,0 +1,227 @@
1
+ // src/services/race/pilot-gate-store.ts
2
+ //
3
+ // THE ONLY I/O MODULE of the race-lane gate-2 evidence. `gate2-evaluator.ts`
4
+ // judges; this file reads and writes, and nothing else may.
5
+ //
6
+ // WHY THE EVIDENCE IS TRACKED. Gate 2 gates a switch of `skills/peaks-audit/SKILL.md`
7
+ // to "offered by default" — a tracked change, which must be judged on tracked
8
+ // evidence. If `pilot-gate.json` lived under `.peaks/_runtime/` it would be
9
+ // gitignored, the guard would read nothing on a clean CI clone, and "did the gate
10
+ // pass?" would remain a local fact rather than a repository fact.
11
+ //
12
+ // WHAT THIS FILE DOES NOT PROVE. The per-task prose traces stay gitignored
13
+ // (`.peaks/_runtime/<sessionId>/race/<rid>.md`), so the rows here were extracted
14
+ // from them and committed. Nothing in this repository can prove those rows came
15
+ // from tasks that were really run; the guard can only prove the rows, the counts,
16
+ // the verdict and the SKILL.md marker are mutually consistent.
17
+ //
18
+ // THE POLICY BLOCK IN THE FILE IS A RECORD, NOT THE AUTHORITY. The thresholds a
19
+ // verdict is computed from are `RACE_GATE2_POLICY_V1` in `gate2-policy.ts`. Were
20
+ // the file's own block the computational source, weakening it in a commit would
21
+ // launder the gate it exists to hold. The writer copies the constant into the
22
+ // block verbatim, and a reader can compare `recordedPolicyVersion` against the
23
+ // policy it was judged under.
24
+ import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
25
+ import { dirname, join } from 'node:path';
26
+ import { CLI_VERSION } from 'peaks-loop-shared/version';
27
+ import { z } from 'zod';
28
+ import { isUnsafePathInput } from '../../shared/path-safety.js';
29
+ import { REQUEST_ID_PATTERN } from '../artifacts/request-artifact-service.js';
30
+ import { evaluatePilotGate } from './gate2-evaluator.js';
31
+ import { RACE_GATE2_POLICY_V1, RACE_GATE2_POLICY_VERSION } from './gate2-policy.js';
32
+ /** `fast-lane-norm.md` §2 numbers the risk surfaces 1..7; a value outside that is a typo, not a row. */
33
+ export const RISK_SURFACE_MAX = 7;
34
+ /**
35
+ * The file's own note, written by the writer so the artifact cannot be produced
36
+ * without it. Two claims it must carry, per PRD §4 and §5.3: what the evidence
37
+ * does NOT prove, and which of the two policy blocks is authoritative.
38
+ */
39
+ export const PILOT_GATE_NOTE = [
40
+ 'Gate-2 evidence for the peaks-race-code fast lane.',
41
+ 'WHY IT IS TRACKED: gate 2 gates a TRACKED change (skills/peaks-audit/SKILL.md), so it is judged on tracked evidence; under .peaks/_runtime/ it would be gitignored, and whether the gate passed would stay a local fact.',
42
+ 'WHAT IT DOES NOT PROVE: the per-task prose traces (.peaks/_runtime/<sessionId>/race/<rid>.md) are gitignored, so these rows were extracted from them and committed. Nothing in this repository can prove they came from tasks that were really run; a guard can only prove the rows, the counts, the verdict and the SKILL.md marker are mutually consistent.',
43
+ 'WHICH POLICY IS AUTHORITATIVE: src/services/race/gate2-policy.ts. The policy block below is the RECORD of what was applied, copied verbatim from that constant; a verdict is always computed from the constant, never from this file — otherwise weakening this block would launder the gate.',
44
+ 'ciRed false means no CI failure is attributed to this task, NOT that CI was green on its commit.',
45
+ 'missedRiskSurface false means no missed risk surface is known; no procedure exists yet for setting it (U-C), so it is a required value with nothing behind it.'
46
+ ].join(' ');
47
+ export const LANE_CHOSEN_BY_VALUES = ['user-named', 'user-picked'];
48
+ export const OUTCOME_VALUES = ['landed', 'escalated', 'stopped'];
49
+ export const HANDLING_VALUES = ['refused', 'escalated', 'user-override-recorded', 'none'];
50
+ /**
51
+ * One evidence row. `z.object` strips unknown keys, so an author-written
52
+ * `coreCapability: true` is ignored rather than honoured — the coverage value is
53
+ * derived (§3.2) and there is deliberately no field that can assert it.
54
+ */
55
+ const pilotTaskRowSchema = z.object({
56
+ rid: z.string().min(1),
57
+ sessionId: z.string().min(1),
58
+ date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
59
+ laneChosenBy: z.enum(LANE_CHOSEN_BY_VALUES),
60
+ outcome: z.enum(OUTCOME_VALUES),
61
+ filesChanged: z.array(z.string()),
62
+ riskSurfacesHit: z.array(z.number().int()),
63
+ riskSurfaceHandling: z.enum(HANDLING_VALUES),
64
+ rolledBack: z.boolean(),
65
+ ciRed: z.boolean(),
66
+ missedRiskSurface: z.boolean()
67
+ });
68
+ /**
69
+ * The reader needs what it judges with and nothing else. `tasks` is required —
70
+ * a file whose rows cannot be read is not a verdict, it is unreadable evidence.
71
+ * `policyVersion` is read for the report. The rest of the artifact
72
+ * (`evaluatorVersion`, `updatedAt`, `policy`, `lastEvaluation`) is the writer's
73
+ * record and is deliberately NOT a precondition for judging: PRD §3 versions the
74
+ * policy precisely so that a file written under a different version stays
75
+ * readable instead of turning into a parse error.
76
+ */
77
+ const pilotGateFileSchema = z.object({
78
+ policyVersion: z.string().optional(),
79
+ tasks: z.array(pilotTaskRowSchema)
80
+ });
81
+ export function pilotGatePath(projectRoot) {
82
+ return join(projectRoot, '.peaks', 'race', 'pilot-gate.json');
83
+ }
84
+ export function readPilotGate(projectRoot) {
85
+ const path = pilotGatePath(projectRoot);
86
+ if (!existsSync(path))
87
+ return { kind: 'missing', path };
88
+ let raw;
89
+ try {
90
+ raw = JSON.parse(readFileSync(path, 'utf8'));
91
+ }
92
+ catch (error) {
93
+ return {
94
+ kind: 'invalid',
95
+ path,
96
+ message: error instanceof Error ? error.message : String(error)
97
+ };
98
+ }
99
+ const parsed = pilotGateFileSchema.safeParse(raw);
100
+ if (!parsed.success) {
101
+ return { kind: 'invalid', path, message: describeIssues(parsed.error) };
102
+ }
103
+ return { kind: 'ok', path, gate: parsed.data };
104
+ }
105
+ function describeIssues(error) {
106
+ return error.issues
107
+ .map((issue) => `${issue.path.join('.') || '<root>'}: ${issue.message}`)
108
+ .join('; ');
109
+ }
110
+ /** Backslashes are normalized rather than refused: a path is a path on either shell. */
111
+ function normalizeFiles(files) {
112
+ const normalized = [];
113
+ for (const file of files) {
114
+ const path = file.replace(/\\/g, '/');
115
+ if (isUnsafePathInput(path)) {
116
+ return {
117
+ ok: false,
118
+ message: `--file must be repository-relative, got ${JSON.stringify(file)}`
119
+ };
120
+ }
121
+ normalized.push(path);
122
+ }
123
+ return { ok: true, files: normalized };
124
+ }
125
+ /**
126
+ * The one rule no schema can state: a hit with no disposition is a MISSING
127
+ * record, and accepting it silently would make the coverage derivation credit
128
+ * nothing and say nothing.
129
+ */
130
+ function checkRiskSurfaces(surfaces, handling) {
131
+ for (const surface of surfaces) {
132
+ if (!Number.isInteger(surface) || surface < 1 || surface > RISK_SURFACE_MAX) {
133
+ return `--risk-surface must be an integer 1..${RISK_SURFACE_MAX}, got ${surface}`;
134
+ }
135
+ }
136
+ if (surfaces.length > 0 && handling === 'none') {
137
+ return '--risk-surface-handling cannot be "none" when --risk-surface is present: a hit with no disposition is a missing record, not a clean row';
138
+ }
139
+ return null;
140
+ }
141
+ /**
142
+ * Validate one row, fail-closed, each refusal naming the rule it broke. Nothing
143
+ * is written when this returns `invalid`.
144
+ */
145
+ export function buildPilotTaskRow(input) {
146
+ const invalid = (message) => ({
147
+ kind: 'invalid',
148
+ message
149
+ });
150
+ // The rule is the id PATTERN, not a prefix: a name may key a row, it may not
151
+ // veto one. Snapshot of `.peaks/_runtime/*/rd/requests/` on 2026-10-13 — 97
152
+ // ids, 39 prefixed, 58 not — so the test this replaces refused 58 of 97 of
153
+ // what the repository mints. `REQUEST_ID_PATTERN` is imported rather than
154
+ // re-spelled so this site cannot drift, and it is STRICTER than that test:
155
+ // the old one accepted `rid-/abs`, this one refuses it.
156
+ if (!REQUEST_ID_PATTERN.test(input.rid)) {
157
+ return invalid(`--rid must match ${REQUEST_ID_PATTERN.source}, got ${JSON.stringify(input.rid)}`);
158
+ }
159
+ // `isUnsafePathInput` is the predicate `guardRuntimeSegment` is built on; the
160
+ // ids and the file paths are checked BEFORE anything is written. THIS RID ARM
161
+ // IS UNREACHABLE-TRUE: every string the pattern admits is one `[A-Za-z0-9._-]`
162
+ // segment starting alphanumeric, so it always passes, and it is KEPT as
163
+ // defence in depth — the invariant, not the test, makes the write safe. The
164
+ // SESSION arm below is the live one; `../../PWNED` reaches and is refused by it.
165
+ if (isUnsafePathInput(input.rid)) {
166
+ return invalid(`--rid must be a single safe path segment, got ${JSON.stringify(input.rid)}`);
167
+ }
168
+ if (isUnsafePathInput(input.sessionId)) {
169
+ return invalid(`--session-id must be a single safe path segment, got ${JSON.stringify(input.sessionId)}`);
170
+ }
171
+ const files = normalizeFiles(input.filesChanged);
172
+ if (!files.ok)
173
+ return invalid(files.message);
174
+ const surfaceProblem = checkRiskSurfaces(input.riskSurfacesHit, input.riskSurfaceHandling);
175
+ if (surfaceProblem !== null)
176
+ return invalid(surfaceProblem);
177
+ const parsed = pilotTaskRowSchema.safeParse({ ...input, filesChanged: files.files });
178
+ if (!parsed.success)
179
+ return invalid(describeIssues(parsed.error));
180
+ return { kind: 'ok', row: parsed.data };
181
+ }
182
+ /**
183
+ * Idempotent upsert of one row, keyed by `--rid`: a repeated rid replaces that
184
+ * row in place (first-seen order preserved), a new rid is appended. The writer is
185
+ * also the only thing that can refresh `lastEvaluation` — the reader owns no file
186
+ * — which is what keeps the committed evaluation from going stale.
187
+ *
188
+ * Throws when the existing file cannot be read: clobbering unreadable evidence
189
+ * with a fresh one-row file would silently destroy rows.
190
+ */
191
+ export function upsertPilotTask(projectRoot, row, now = new Date()) {
192
+ const existing = readPilotGate(projectRoot);
193
+ if (existing.kind === 'invalid') {
194
+ throw new Error(`PILOT_GATE_EVIDENCE_INVALID: ${existing.path}: ${existing.message}`);
195
+ }
196
+ const previousTasks = existing.kind === 'ok' ? existing.gate.tasks : [];
197
+ const index = previousTasks.findIndex((task) => task.rid === row.rid);
198
+ const tasks = index === -1
199
+ ? [...previousTasks, row]
200
+ : previousTasks.map((task, at) => (at === index ? row : task));
201
+ const evaluation = evaluatePilotGate(tasks, RACE_GATE2_POLICY_V1);
202
+ writePilotGate(projectRoot, tasks, evaluation, now);
203
+ return { path: pilotGatePath(projectRoot), evaluation };
204
+ }
205
+ /**
206
+ * The full artifact the writer owns. The `policy` block is copied from the code
207
+ * constant verbatim — it records what was applied, and a test asserts the two are
208
+ * byte-equal so the record cannot drift from the source.
209
+ */
210
+ function writePilotGate(projectRoot, tasks, evaluation, now) {
211
+ const path = pilotGatePath(projectRoot);
212
+ const artifact = {
213
+ note: PILOT_GATE_NOTE,
214
+ policyVersion: RACE_GATE2_POLICY_VERSION,
215
+ evaluatorVersion: CLI_VERSION,
216
+ updatedAt: now.toISOString(),
217
+ policy: RACE_GATE2_POLICY_V1,
218
+ tasks,
219
+ lastEvaluation: { ...evaluation, evaluatedAt: now.toISOString() }
220
+ };
221
+ // Temp file in the same directory, then rename: a crash mid-write leaves the
222
+ // previous valid evidence intact rather than a truncated one.
223
+ mkdirSync(dirname(path), { recursive: true });
224
+ const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
225
+ writeFileSync(tmp, `${JSON.stringify(artifact, null, 2)}\n`, 'utf8');
226
+ renameSync(tmp, path);
227
+ }
@@ -0,0 +1,26 @@
1
+ /** A git read the scan needs could not be completed. Thrown, never returned:
2
+ * the alternative is an empty file list that reads as "nothing changed". */
3
+ export declare class GitReadFailedError extends Error {
4
+ readonly code = "FILE_SIZE_GIT_READ_FAILED";
5
+ constructor(what: string, projectRoot: string, detail: string);
6
+ }
7
+ export type ChangedFiles = {
8
+ /** Paths to measure in the working tree: Added/Modified entries plus rename
9
+ * targets. Deletions are omitted — they have no body to measure. */
10
+ paths: string[];
11
+ /** The path `file`'s baseline size must be read from: itself, or the name it
12
+ * had at `baseRef` before a rename. */
13
+ baselinePathFor(file: string): string;
14
+ };
15
+ /**
16
+ * The changed-file population the scan measures, as `git diff --name-status`
17
+ * reports it. `A`/`M` keep their path; `R`/`C` keep the TARGET path and record
18
+ * the source, so the rename is judged against the size the file had before it
19
+ * moved; `D` is dropped. A git failure here THROWS rather than returning `[]`.
20
+ *
21
+ * `only` is the caller's own list, when it has one — see `restrictedTo`.
22
+ */
23
+ export declare function readChangedFiles(projectRoot: string, baseRef: string, only?: readonly string[]): ChangedFiles;
24
+ /** The file's raw-line count AT `baseRef`, or `null` when the ref has no such
25
+ * path — i.e. the change ADDED the file and it is over the cap by creation. */
26
+ export declare function readBaseLineCount(projectRoot: string, baseRef: string, file: string): number | null;