peaks-loop 4.1.3 → 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 (628) hide show
  1. package/.claude-plugin/marketplace.json +7 -2
  2. package/CHANGELOG.md +168 -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/asset-command-shared.d.ts +12 -0
  9. package/dist/cli/commands/asset-command-shared.js +45 -0
  10. package/dist/cli/commands/asset-commands.d.ts +6 -1
  11. package/dist/cli/commands/asset-commands.js +11 -372
  12. package/dist/cli/commands/asset-crystallize-command.d.ts +3 -0
  13. package/dist/cli/commands/asset-crystallize-command.js +60 -0
  14. package/dist/cli/commands/asset-crystallize-payload.d.ts +47 -0
  15. package/dist/cli/commands/asset-crystallize-payload.js +85 -0
  16. package/dist/cli/commands/asset-crystallize-runner.d.ts +3 -0
  17. package/dist/cli/commands/asset-crystallize-runner.js +133 -0
  18. package/dist/cli/commands/asset-dispose-command.d.ts +3 -0
  19. package/dist/cli/commands/asset-dispose-command.js +99 -0
  20. package/dist/cli/commands/asset-status-command.d.ts +3 -0
  21. package/dist/cli/commands/asset-status-command.js +100 -0
  22. package/dist/cli/commands/baseline-audit-command.d.ts +3 -0
  23. package/dist/cli/commands/baseline-audit-command.js +64 -0
  24. package/dist/cli/commands/baseline-command-shared.d.ts +23 -0
  25. package/dist/cli/commands/baseline-command-shared.js +39 -0
  26. package/dist/cli/commands/baseline-commands.js +33 -313
  27. package/dist/cli/commands/baseline-freeze-commands.d.ts +4 -0
  28. package/dist/cli/commands/baseline-freeze-commands.js +81 -0
  29. package/dist/cli/commands/baseline-guard-command.d.ts +3 -0
  30. package/dist/cli/commands/baseline-guard-command.js +52 -0
  31. package/dist/cli/commands/baseline-read-commands.d.ts +5 -0
  32. package/dist/cli/commands/baseline-read-commands.js +72 -0
  33. package/dist/cli/commands/baseline-rollback-commands.d.ts +4 -0
  34. package/dist/cli/commands/baseline-rollback-commands.js +88 -0
  35. package/dist/cli/commands/classify-downgrade-command.d.ts +9 -0
  36. package/dist/cli/commands/classify-downgrade-command.js +21 -0
  37. package/dist/cli/commands/classify-run-command.d.ts +9 -0
  38. package/dist/cli/commands/classify-run-command.js +73 -0
  39. package/dist/cli/commands/classify-signals.d.ts +5 -0
  40. package/dist/cli/commands/classify-signals.js +104 -0
  41. package/dist/cli/commands/code-commands.d.ts +6 -4
  42. package/dist/cli/commands/code-commands.js +6 -4
  43. package/dist/cli/commands/code-emit-handoff-command.js +40 -3
  44. package/dist/cli/commands/code-gate-command.d.ts +5 -5
  45. package/dist/cli/commands/code-gate-command.js +49 -9
  46. package/dist/cli/commands/code-gate-step-08-command.js +25 -9
  47. package/dist/cli/commands/code-mode-gate-plan-command.d.ts +1 -1
  48. package/dist/cli/commands/code-mode-gate-plan-command.js +2 -2
  49. package/dist/cli/commands/codegraph-command-options.d.ts +22 -0
  50. package/dist/cli/commands/codegraph-command-options.js +22 -0
  51. package/dist/cli/commands/codegraph-commands.d.ts +2 -2
  52. package/dist/cli/commands/codegraph-commands.js +14 -397
  53. package/dist/cli/commands/codegraph-config-restore-command.d.ts +3 -0
  54. package/dist/cli/commands/codegraph-config-restore-command.js +200 -0
  55. package/dist/cli/commands/codegraph-proxy-commands.d.ts +10 -0
  56. package/dist/cli/commands/codegraph-proxy-commands.js +159 -0
  57. package/dist/cli/commands/codegraph-repair-commands.d.ts +3 -0
  58. package/dist/cli/commands/codegraph-repair-commands.js +94 -0
  59. package/dist/cli/commands/codegraph-status-command.d.ts +1 -1
  60. package/dist/cli/commands/codegraph-status-command.js +27 -214
  61. package/dist/cli/commands/codegraph-status-integrity.d.ts +44 -0
  62. package/dist/cli/commands/codegraph-status-integrity.js +121 -0
  63. package/dist/cli/commands/codegraph-status-json.d.ts +5 -0
  64. package/dist/cli/commands/codegraph-status-json.js +127 -0
  65. package/dist/cli/commands/container-command-shared.d.ts +60 -0
  66. package/dist/cli/commands/container-command-shared.js +52 -0
  67. package/dist/cli/commands/container-commands.d.ts +1 -1
  68. package/dist/cli/commands/container-commands.js +4 -216
  69. package/dist/cli/commands/container-release-command.d.ts +3 -0
  70. package/dist/cli/commands/container-release-command.js +105 -0
  71. package/dist/cli/commands/container-spawn-command.d.ts +3 -0
  72. package/dist/cli/commands/container-spawn-command.js +148 -0
  73. package/dist/cli/commands/context-check-command.d.ts +3 -0
  74. package/dist/cli/commands/context-check-command.js +81 -0
  75. package/dist/cli/commands/context-commands.d.ts +2 -7
  76. package/dist/cli/commands/context-commands.js +6 -276
  77. package/dist/cli/commands/context-layer-command.d.ts +3 -0
  78. package/dist/cli/commands/context-layer-command.js +34 -0
  79. package/dist/cli/commands/context-layer-fetchers.d.ts +15 -0
  80. package/dist/cli/commands/context-layer-fetchers.js +162 -0
  81. package/dist/cli/commands/context-status-command.d.ts +17 -0
  82. package/dist/cli/commands/context-status-command.js +41 -0
  83. package/dist/cli/commands/contract-write-command.d.ts +3 -0
  84. package/dist/cli/commands/contract-write-command.js +144 -0
  85. package/dist/cli/commands/core/doctor-bindings.d.ts +17 -0
  86. package/dist/cli/commands/core/doctor-bindings.js +30 -0
  87. package/dist/cli/commands/core/doctor-command.d.ts +4 -18
  88. package/dist/cli/commands/core/doctor-command.js +2 -323
  89. package/dist/cli/commands/core/doctor-logs.d.ts +8 -0
  90. package/dist/cli/commands/core/doctor-logs.js +32 -0
  91. package/dist/cli/commands/core/doctor-probes.d.ts +3 -0
  92. package/dist/cli/commands/core/doctor-probes.js +55 -0
  93. package/dist/cli/commands/core/doctor-run-command.d.ts +12 -0
  94. package/dist/cli/commands/core/doctor-run-command.js +172 -0
  95. package/dist/cli/commands/core/doctor-summary.d.ts +7 -0
  96. package/dist/cli/commands/core/doctor-summary.js +39 -0
  97. package/dist/cli/commands/core/memory-command-shared.d.ts +25 -0
  98. package/dist/cli/commands/core/memory-command-shared.js +20 -0
  99. package/dist/cli/commands/core/memory-command.d.ts +1 -1
  100. package/dist/cli/commands/core/memory-command.js +6 -227
  101. package/dist/cli/commands/core/memory-delegated-verbs.d.ts +4 -0
  102. package/dist/cli/commands/core/memory-delegated-verbs.js +178 -0
  103. package/dist/cli/commands/core/memory-extract-command.d.ts +3 -0
  104. package/dist/cli/commands/core/memory-extract-command.js +95 -0
  105. package/dist/cli/commands/core/memory-sync-command.d.ts +3 -0
  106. package/dist/cli/commands/core/memory-sync-command.js +38 -0
  107. package/dist/cli/commands/core/session-command.d.ts +1 -1
  108. package/dist/cli/commands/core/session-command.js +12 -206
  109. package/dist/cli/commands/core/session-info-command.d.ts +3 -0
  110. package/dist/cli/commands/core/session-info-command.js +142 -0
  111. package/dist/cli/commands/core/session-verb-commands.d.ts +5 -0
  112. package/dist/cli/commands/core/session-verb-commands.js +58 -0
  113. package/dist/cli/commands/core/standards-command.d.ts +1 -24
  114. package/dist/cli/commands/core/standards-command.js +33 -201
  115. package/dist/cli/commands/core/standards-init-command.d.ts +3 -0
  116. package/dist/cli/commands/core/standards-init-command.js +87 -0
  117. package/dist/cli/commands/core/standards-lint.d.ts +24 -0
  118. package/dist/cli/commands/core/standards-lint.js +57 -0
  119. package/dist/cli/commands/core/standards-migrate-command.d.ts +3 -0
  120. package/dist/cli/commands/core/standards-migrate-command.js +57 -0
  121. package/dist/cli/commands/cron-scheduler-commands.d.ts +5 -1
  122. package/dist/cli/commands/cron-scheduler-commands.js +36 -206
  123. package/dist/cli/commands/cron-scheduler-run-once-command.d.ts +7 -0
  124. package/dist/cli/commands/cron-scheduler-run-once-command.js +35 -0
  125. package/dist/cli/commands/cron-scheduler-shared.d.ts +6 -0
  126. package/dist/cli/commands/cron-scheduler-shared.js +48 -0
  127. package/dist/cli/commands/cron-scheduler-start-command.d.ts +7 -0
  128. package/dist/cli/commands/cron-scheduler-start-command.js +65 -0
  129. package/dist/cli/commands/cron-scheduler-status-command.d.ts +7 -0
  130. package/dist/cli/commands/cron-scheduler-status-command.js +46 -0
  131. package/dist/cli/commands/cron-scheduler-stop-command.d.ts +7 -0
  132. package/dist/cli/commands/cron-scheduler-stop-command.js +61 -0
  133. package/dist/cli/commands/dispatch-cli-invocation-check.d.ts +108 -0
  134. package/dist/cli/commands/dispatch-cli-invocation-check.js +87 -0
  135. package/dist/cli/commands/dispatch-cli-invocation-scan.d.ts +66 -0
  136. package/dist/cli/commands/dispatch-cli-invocation-scan.js +162 -0
  137. package/dist/cli/commands/dispatch-commands.js +12 -5
  138. package/dist/cli/commands/dispatch-dag-envelope.d.ts +41 -0
  139. package/dist/cli/commands/dispatch-dag-envelope.js +49 -0
  140. package/dist/cli/commands/dispatch-dag-failure.d.ts +18 -0
  141. package/dist/cli/commands/dispatch-dag-failure.js +16 -0
  142. package/dist/cli/commands/dispatch-dag-preflight.d.ts +51 -0
  143. package/dist/cli/commands/dispatch-dag-preflight.js +105 -0
  144. package/dist/cli/commands/dispatch-dag-runners.d.ts +48 -0
  145. package/dist/cli/commands/dispatch-dag-runners.js +73 -0
  146. package/dist/cli/commands/dispatch-from-dag.d.ts +27 -0
  147. package/dist/cli/commands/dispatch-from-dag.js +87 -257
  148. package/dist/cli/commands/dispatch-preflight.js +46 -0
  149. package/dist/cli/commands/dispatch-prompt-composition.d.ts +6 -0
  150. package/dist/cli/commands/dispatch-prompt-composition.js +29 -7
  151. package/dist/cli/commands/doc-commands.js +1 -1
  152. package/dist/cli/commands/feedback-commands-helpers.js +1 -1
  153. package/dist/cli/commands/final-review-command-envelopes.d.ts +44 -0
  154. package/dist/cli/commands/final-review-command-envelopes.js +100 -0
  155. package/dist/cli/commands/final-review-command-shared.d.ts +52 -0
  156. package/dist/cli/commands/final-review-command-shared.js +35 -0
  157. package/dist/cli/commands/final-review-commands.d.ts +7 -27
  158. package/dist/cli/commands/final-review-commands.js +13 -240
  159. package/dist/cli/commands/final-review-prepare-command.d.ts +3 -0
  160. package/dist/cli/commands/final-review-prepare-command.js +221 -0
  161. package/dist/cli/commands/gate-commands-enforce.js +3 -3
  162. package/dist/cli/commands/governance-classify-contract-commands.d.ts +23 -9
  163. package/dist/cli/commands/governance-classify-contract-commands.js +26 -269
  164. package/dist/cli/commands/hook-handle.js +41 -20
  165. package/dist/cli/commands/hooks-command-shared.d.ts +42 -0
  166. package/dist/cli/commands/hooks-command-shared.js +32 -0
  167. package/dist/cli/commands/hooks-commands.d.ts +20 -0
  168. package/dist/cli/commands/hooks-commands.js +75 -309
  169. package/dist/cli/commands/hooks-install-envelopes.d.ts +6 -0
  170. package/dist/cli/commands/hooks-install-envelopes.js +144 -0
  171. package/dist/cli/commands/hooks-status-command.d.ts +3 -0
  172. package/dist/cli/commands/hooks-status-command.js +93 -0
  173. package/dist/cli/commands/hooks-uninstall-command.d.ts +3 -0
  174. package/dist/cli/commands/hooks-uninstall-command.js +43 -0
  175. package/dist/cli/commands/lint-commands.js +3 -1
  176. package/dist/cli/commands/loop-command-shared.d.ts +31 -0
  177. package/dist/cli/commands/loop-command-shared.js +15 -0
  178. package/dist/cli/commands/loop-commands.d.ts +12 -17
  179. package/dist/cli/commands/loop-commands.js +56 -238
  180. package/dist/cli/commands/loop-eval-capture-index.js +2 -4
  181. package/dist/cli/commands/loop-export-command.d.ts +3 -0
  182. package/dist/cli/commands/loop-export-command.js +73 -0
  183. package/dist/cli/commands/loop-goal-compose-command.d.ts +3 -0
  184. package/dist/cli/commands/loop-goal-compose-command.js +36 -0
  185. package/dist/cli/commands/loop-import-command.d.ts +3 -0
  186. package/dist/cli/commands/loop-import-command.js +86 -0
  187. package/dist/cli/commands/loop-placeholder-commands.d.ts +3 -0
  188. package/dist/cli/commands/loop-placeholder-commands.js +52 -0
  189. package/dist/cli/commands/memory-command-shared.d.ts +59 -0
  190. package/dist/cli/commands/memory-command-shared.js +39 -0
  191. package/dist/cli/commands/memory-commands.d.ts +6 -79
  192. package/dist/cli/commands/memory-commands.js +19 -309
  193. package/dist/cli/commands/memory-ingest-command.d.ts +3 -0
  194. package/dist/cli/commands/memory-ingest-command.js +50 -0
  195. package/dist/cli/commands/memory-list-command.d.ts +16 -0
  196. package/dist/cli/commands/memory-list-command.js +129 -0
  197. package/dist/cli/commands/memory-reindex-command.d.ts +9 -0
  198. package/dist/cli/commands/memory-reindex-command.js +78 -0
  199. package/dist/cli/commands/memory-rotate-command.d.ts +3 -0
  200. package/dist/cli/commands/memory-rotate-command.js +55 -0
  201. package/dist/cli/commands/memory-search-command.d.ts +7 -0
  202. package/dist/cli/commands/memory-search-command.js +46 -0
  203. package/dist/cli/commands/openspec-archive-command.d.ts +3 -0
  204. package/dist/cli/commands/openspec-archive-command.js +55 -0
  205. package/dist/cli/commands/openspec-command-shared.d.ts +62 -0
  206. package/dist/cli/commands/openspec-command-shared.js +135 -0
  207. package/dist/cli/commands/openspec-commands.d.ts +1 -1
  208. package/dist/cli/commands/openspec-commands.js +33 -306
  209. package/dist/cli/commands/openspec-from-doctor-command.d.ts +3 -0
  210. package/dist/cli/commands/openspec-from-doctor-command.js +66 -0
  211. package/dist/cli/commands/openspec-init-command.d.ts +3 -0
  212. package/dist/cli/commands/openspec-init-command.js +49 -0
  213. package/dist/cli/commands/openspec-list-command.d.ts +3 -0
  214. package/dist/cli/commands/openspec-list-command.js +27 -0
  215. package/dist/cli/commands/openspec-render-command.d.ts +3 -0
  216. package/dist/cli/commands/openspec-render-command.js +33 -0
  217. package/dist/cli/commands/openspec-show-command.d.ts +3 -0
  218. package/dist/cli/commands/openspec-show-command.js +33 -0
  219. package/dist/cli/commands/openspec-to-rd-command.d.ts +3 -0
  220. package/dist/cli/commands/openspec-to-rd-command.js +33 -0
  221. package/dist/cli/commands/openspec-validate-command.d.ts +3 -0
  222. package/dist/cli/commands/openspec-validate-command.js +45 -0
  223. package/dist/cli/commands/perf-audit-commands.js +15 -5
  224. package/dist/cli/commands/playwright-browser-command.d.ts +8 -0
  225. package/dist/cli/commands/playwright-browser-command.js +61 -0
  226. package/dist/cli/commands/playwright-commands.d.ts +10 -62
  227. package/dist/cli/commands/playwright-commands.js +77 -400
  228. package/dist/cli/commands/playwright-envelope.d.ts +8 -0
  229. package/dist/cli/commands/playwright-envelope.js +29 -0
  230. package/dist/cli/commands/playwright-ls-stop-commands.d.ts +4 -0
  231. package/dist/cli/commands/playwright-ls-stop-commands.js +74 -0
  232. package/dist/cli/commands/playwright-session-store.d.ts +65 -0
  233. package/dist/cli/commands/playwright-session-store.js +189 -0
  234. package/dist/cli/commands/project-commands.d.ts +19 -0
  235. package/dist/cli/commands/project-commands.js +101 -259
  236. package/dist/cli/commands/project-context-command.d.ts +3 -0
  237. package/dist/cli/commands/project-context-command.js +44 -0
  238. package/dist/cli/commands/project-dashboard-command.d.ts +3 -0
  239. package/dist/cli/commands/project-dashboard-command.js +74 -0
  240. package/dist/cli/commands/project-knowledge-command.d.ts +3 -0
  241. package/dist/cli/commands/project-knowledge-command.js +48 -0
  242. package/dist/cli/commands/project-memories-show-command.d.ts +3 -0
  243. package/dist/cli/commands/project-memories-show-command.js +87 -0
  244. package/dist/cli/commands/project-memory-index-command.d.ts +3 -0
  245. package/dist/cli/commands/project-memory-index-command.js +31 -0
  246. package/dist/cli/commands/qa-archive-screenshots-command.d.ts +3 -0
  247. package/dist/cli/commands/qa-archive-screenshots-command.js +53 -0
  248. package/dist/cli/commands/qa-commands.d.ts +14 -87
  249. package/dist/cli/commands/qa-commands.js +17 -315
  250. package/dist/cli/commands/qa-context-prestep.d.ts +1 -0
  251. package/dist/cli/commands/qa-context-prestep.js +34 -0
  252. package/dist/cli/commands/qa-run-command.d.ts +3 -0
  253. package/dist/cli/commands/qa-run-command.js +105 -0
  254. package/dist/cli/commands/qa-run-options.d.ts +23 -0
  255. package/dist/cli/commands/qa-run-options.js +31 -0
  256. package/dist/cli/commands/qa-run-slice.d.ts +41 -0
  257. package/dist/cli/commands/qa-run-slice.js +145 -0
  258. package/dist/cli/commands/race-commands.d.ts +15 -0
  259. package/dist/cli/commands/race-commands.js +65 -0
  260. package/dist/cli/commands/race-pilot-gate-record-command.d.ts +3 -0
  261. package/dist/cli/commands/race-pilot-gate-record-command.js +81 -0
  262. package/dist/cli/commands/release-canary-command.d.ts +28 -0
  263. package/dist/cli/commands/release-canary-command.js +129 -0
  264. package/dist/cli/commands/release-command-shared.d.ts +13 -0
  265. package/dist/cli/commands/release-command-shared.js +18 -0
  266. package/dist/cli/commands/release-commands.d.ts +10 -18
  267. package/dist/cli/commands/release-commands.js +25 -298
  268. package/dist/cli/commands/release-done-command.d.ts +3 -0
  269. package/dist/cli/commands/release-done-command.js +64 -0
  270. package/dist/cli/commands/release-hotfix-command.d.ts +3 -0
  271. package/dist/cli/commands/release-hotfix-command.js +50 -0
  272. package/dist/cli/commands/release-plan-command.d.ts +3 -0
  273. package/dist/cli/commands/release-plan-command.js +33 -0
  274. package/dist/cli/commands/release-precheck-command.d.ts +3 -0
  275. package/dist/cli/commands/release-precheck-command.js +28 -0
  276. package/dist/cli/commands/release-promote-command.d.ts +3 -0
  277. package/dist/cli/commands/release-promote-command.js +34 -0
  278. package/dist/cli/commands/release-rollback-command.d.ts +3 -0
  279. package/dist/cli/commands/release-rollback-command.js +33 -0
  280. package/dist/cli/commands/release-watch-command.d.ts +3 -0
  281. package/dist/cli/commands/release-watch-command.js +44 -0
  282. package/dist/cli/commands/request-command-options.d.ts +8 -0
  283. package/dist/cli/commands/request-commands.js +2 -0
  284. package/dist/cli/commands/request-init-command.js +67 -12
  285. package/dist/cli/commands/request-retag-command.d.ts +3 -0
  286. package/dist/cli/commands/request-retag-command.js +50 -0
  287. package/dist/cli/commands/request-show-command.d.ts +8 -0
  288. package/dist/cli/commands/request-show-command.js +14 -1
  289. package/dist/cli/commands/request-transition-command.js +12 -4
  290. package/dist/cli/commands/request-transition-failures.d.ts +14 -0
  291. package/dist/cli/commands/request-transition-failures.js +45 -3
  292. package/dist/cli/commands/scan-scope-commands.js +2 -2
  293. package/dist/cli/commands/security-audit-commands.js +26 -6
  294. package/dist/cli/commands/sediment-argv-flags.d.ts +54 -0
  295. package/dist/cli/commands/sediment-argv-flags.js +116 -0
  296. package/dist/cli/commands/sediment-command-shared.d.ts +15 -0
  297. package/dist/cli/commands/sediment-command-shared.js +5 -0
  298. package/dist/cli/commands/sediment-commands.d.ts +35 -59
  299. package/dist/cli/commands/sediment-commands.js +36 -590
  300. package/dist/cli/commands/sediment-pool-commands.d.ts +9 -0
  301. package/dist/cli/commands/sediment-pool-commands.js +185 -0
  302. package/dist/cli/commands/sediment-query-commands.d.ts +4 -0
  303. package/dist/cli/commands/sediment-query-commands.js +94 -0
  304. package/dist/cli/commands/sediment-release-commands.d.ts +8 -0
  305. package/dist/cli/commands/sediment-release-commands.js +232 -0
  306. package/dist/cli/commands/sop-advance-command.d.ts +3 -0
  307. package/dist/cli/commands/sop-advance-command.js +160 -0
  308. package/dist/cli/commands/sop-check-command.d.ts +3 -0
  309. package/dist/cli/commands/sop-check-command.js +44 -0
  310. package/dist/cli/commands/sop-command-shared.d.ts +23 -0
  311. package/dist/cli/commands/sop-command-shared.js +18 -0
  312. package/dist/cli/commands/sop-commands.d.ts +15 -1
  313. package/dist/cli/commands/sop-commands.js +26 -240
  314. package/dist/cli/commands/sop-init-command.d.ts +3 -0
  315. package/dist/cli/commands/sop-init-command.js +51 -0
  316. package/dist/cli/commands/sop-lint-command.d.ts +3 -0
  317. package/dist/cli/commands/sop-lint-command.js +64 -0
  318. package/dist/cli/commands/sop-register-command.d.ts +3 -0
  319. package/dist/cli/commands/sop-register-command.js +48 -0
  320. package/dist/cli/commands/sop-registry-command.d.ts +3 -0
  321. package/dist/cli/commands/sop-registry-command.js +30 -0
  322. package/dist/cli/commands/statusline-command-shared.d.ts +73 -0
  323. package/dist/cli/commands/statusline-command-shared.js +90 -0
  324. package/dist/cli/commands/statusline-commands.d.ts +1 -19
  325. package/dist/cli/commands/statusline-commands.js +48 -287
  326. package/dist/cli/commands/statusline-compact-command.d.ts +4 -0
  327. package/dist/cli/commands/statusline-compact-command.js +54 -0
  328. package/dist/cli/commands/statusline-install-command.d.ts +3 -0
  329. package/dist/cli/commands/statusline-install-command.js +48 -0
  330. package/dist/cli/commands/statusline-render-command.d.ts +9 -0
  331. package/dist/cli/commands/statusline-render-command.js +55 -0
  332. package/dist/cli/commands/statusline-status-command.d.ts +3 -0
  333. package/dist/cli/commands/statusline-status-command.js +23 -0
  334. package/dist/cli/commands/statusline-uninstall-command.d.ts +3 -0
  335. package/dist/cli/commands/statusline-uninstall-command.js +23 -0
  336. package/dist/cli/commands/test-command-run-helpers.d.ts +27 -0
  337. package/dist/cli/commands/test-command-run-helpers.js +73 -0
  338. package/dist/cli/commands/test-command-runner-resolution.d.ts +57 -0
  339. package/dist/cli/commands/test-command-runner-resolution.js +183 -0
  340. package/dist/cli/commands/test-commands.d.ts +8 -56
  341. package/dist/cli/commands/test-commands.js +26 -249
  342. package/dist/cli/commands/vm-command-shared.d.ts +23 -0
  343. package/dist/cli/commands/vm-command-shared.js +23 -0
  344. package/dist/cli/commands/vm-commands.d.ts +1 -28
  345. package/dist/cli/commands/vm-commands.js +36 -270
  346. package/dist/cli/commands/vm-hypervisor-runtime.d.ts +15 -0
  347. package/dist/cli/commands/vm-hypervisor-runtime.js +64 -0
  348. package/dist/cli/commands/vm-release-command.d.ts +5 -0
  349. package/dist/cli/commands/vm-release-command.js +101 -0
  350. package/dist/cli/commands/vm-spawn-command.d.ts +5 -0
  351. package/dist/cli/commands/vm-spawn-command.js +177 -0
  352. package/dist/cli/commands/web-command-shared.d.ts +12 -0
  353. package/dist/cli/commands/web-command-shared.js +30 -0
  354. package/dist/cli/commands/web-commands.d.ts +7 -14
  355. package/dist/cli/commands/web-commands.js +6 -314
  356. package/dist/cli/commands/web-install-command.d.ts +10 -0
  357. package/dist/cli/commands/web-install-command.js +116 -0
  358. package/dist/cli/commands/web-lifecycle-commands.d.ts +9 -30
  359. package/dist/cli/commands/web-lifecycle-commands.js +14 -322
  360. package/dist/cli/commands/web-login-command.d.ts +14 -0
  361. package/dist/cli/commands/web-login-command.js +189 -0
  362. package/dist/cli/commands/web-op-payload.d.ts +22 -0
  363. package/dist/cli/commands/web-op-payload.js +89 -0
  364. package/dist/cli/commands/web-op-refusals.d.ts +37 -0
  365. package/dist/cli/commands/web-op-refusals.js +73 -0
  366. package/dist/cli/commands/web-op-runner.d.ts +14 -0
  367. package/dist/cli/commands/web-op-runner.js +166 -0
  368. package/dist/cli/commands/web-status-command.d.ts +4 -0
  369. package/dist/cli/commands/web-status-command.js +32 -0
  370. package/dist/cli/commands/web-stop-command.d.ts +10 -0
  371. package/dist/cli/commands/web-stop-command.js +59 -0
  372. package/dist/cli/commands/web-verb-specs.d.ts +18 -0
  373. package/dist/cli/commands/web-verb-specs.js +66 -0
  374. package/dist/cli/commands/workflow-command-shared.d.ts +102 -0
  375. package/dist/cli/commands/workflow-command-shared.js +74 -0
  376. package/dist/cli/commands/workflow-graph-commands.d.ts +3 -0
  377. package/dist/cli/commands/workflow-graph-commands.js +73 -0
  378. package/dist/cli/commands/workflow-init-command.d.ts +3 -0
  379. package/dist/cli/commands/workflow-init-command.js +68 -0
  380. package/dist/cli/commands/workflow-lifecycle-commands.d.ts +9 -59
  381. package/dist/cli/commands/workflow-lifecycle-commands.js +14 -348
  382. package/dist/cli/commands/workflow-node-commands.d.ts +3 -0
  383. package/dist/cli/commands/workflow-node-commands.js +154 -0
  384. package/dist/cli/commands/workflow-terminalize-command.d.ts +3 -0
  385. package/dist/cli/commands/workflow-terminalize-command.js +56 -0
  386. package/dist/cli/commands/worktree-lease-gc-command.js +1 -1
  387. package/dist/services/artifacts/artifact-contract-block.d.ts +53 -0
  388. package/dist/services/artifacts/artifact-contract-block.js +212 -0
  389. package/dist/services/artifacts/artifact-prerequisites.d.ts +27 -19
  390. package/dist/services/artifacts/artifact-prerequisites.js +63 -133
  391. package/dist/services/artifacts/artifact-templates.d.ts +1 -1
  392. package/dist/services/artifacts/artifact-templates.js +17 -10
  393. package/dist/services/artifacts/prerequisite-checks.d.ts +87 -0
  394. package/dist/services/artifacts/prerequisite-checks.js +198 -0
  395. package/dist/services/artifacts/prerequisite-transition-event.d.ts +20 -0
  396. package/dist/services/artifacts/prerequisite-transition-event.js +27 -0
  397. package/dist/services/artifacts/request-artifact-metadata.d.ts +31 -0
  398. package/dist/services/artifacts/request-artifact-metadata.js +44 -0
  399. package/dist/services/artifacts/request-artifact-service.d.ts +5 -0
  400. package/dist/services/artifacts/request-artifact-service.js +23 -51
  401. package/dist/services/artifacts/request-artifact-state-helpers.d.ts +12 -0
  402. package/dist/services/artifacts/request-artifact-state-helpers.js +28 -4
  403. package/dist/services/artifacts/request-retag-service.d.ts +68 -0
  404. package/dist/services/artifacts/request-retag-service.js +125 -0
  405. package/dist/services/artifacts/request-state-order.d.ts +38 -0
  406. package/dist/services/artifacts/request-state-order.js +99 -0
  407. package/dist/services/artifacts/request-type-demand.d.ts +44 -0
  408. package/dist/services/artifacts/request-type-demand.js +71 -0
  409. package/dist/services/audit/audit-goal-service.d.ts +7 -0
  410. package/dist/services/audit/enforcers/active-skill-resolver.d.ts +18 -0
  411. package/dist/services/audit/enforcers/active-skill-resolver.js +48 -1
  412. package/dist/services/audit/enforcers/code-ban.d.ts +11 -2
  413. package/dist/services/audit/enforcers/code-ban.js +21 -1
  414. package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.d.ts +17 -0
  415. package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.js +24 -7
  416. package/dist/services/audit-independent/handoff-missing-refusal.d.ts +26 -0
  417. package/dist/services/audit-independent/handoff-missing-refusal.js +109 -0
  418. package/dist/services/audit-independent/handoff-readers.d.ts +37 -0
  419. package/dist/services/audit-independent/handoff-readers.js +81 -0
  420. package/dist/services/audit-independent/index.d.ts +6 -1
  421. package/dist/services/audit-independent/index.js +6 -1
  422. package/dist/services/audit-independent/judged-declaration-build.d.ts +48 -0
  423. package/dist/services/audit-independent/judged-declaration-build.js +73 -0
  424. package/dist/services/audit-independent/judged-declaration-check.d.ts +79 -0
  425. package/dist/services/audit-independent/judged-declaration-check.js +155 -0
  426. package/dist/services/audit-independent/judged-declaration.d.ts +94 -0
  427. package/dist/services/audit-independent/judged-declaration.js +218 -0
  428. package/dist/services/audit-independent/perf-audit-service.js +12 -14
  429. package/dist/services/audit-independent/security-audit-artifact.d.ts +28 -0
  430. package/dist/services/audit-independent/security-audit-artifact.js +90 -0
  431. package/dist/services/audit-independent/security-audit-service.d.ts +6 -53
  432. package/dist/services/audit-independent/security-audit-service.js +34 -178
  433. package/dist/services/capability-guard-runner/contracts/J05.js +60 -14
  434. package/dist/services/code/auto-compact-artifacts.d.ts +54 -0
  435. package/dist/services/code/auto-compact-artifacts.js +135 -0
  436. package/dist/services/code/auto-compact-attempt.d.ts +46 -0
  437. package/dist/services/code/auto-compact-attempt.js +88 -0
  438. package/dist/services/code/auto-compact-decision.d.ts +74 -0
  439. package/dist/services/code/auto-compact-decision.js +149 -0
  440. package/dist/services/code/auto-compact-dispatch-gate.d.ts +36 -0
  441. package/dist/services/code/auto-compact-dispatch-gate.js +86 -0
  442. package/dist/services/code/auto-compact-envelopes.d.ts +33 -0
  443. package/dist/services/code/auto-compact-envelopes.js +134 -0
  444. package/dist/services/code/auto-compact-history.d.ts +46 -0
  445. package/dist/services/code/auto-compact-history.js +17 -0
  446. package/dist/services/code/auto-compact-orchestrator.d.ts +11 -240
  447. package/dist/services/code/auto-compact-orchestrator.js +165 -686
  448. package/dist/services/code/auto-compact-run-types.d.ts +123 -0
  449. package/dist/services/code/auto-compact-run-types.js +1 -0
  450. package/dist/services/code/emit-handoff.d.ts +35 -1
  451. package/dist/services/code/emit-handoff.js +128 -7
  452. package/dist/services/code/step-08-gate.d.ts +28 -19
  453. package/dist/services/code/step-08-gate.js +92 -35
  454. package/dist/services/codegraph/codegraph-index-integrity.js +2 -0
  455. package/dist/services/config/config-coercion.d.ts +7 -0
  456. package/dist/services/config/config-coercion.js +156 -0
  457. package/dist/services/config/config-file-io.d.ts +11 -0
  458. package/dist/services/config/config-file-io.js +61 -0
  459. package/dist/services/config/config-get.d.ts +2 -0
  460. package/dist/services/config/config-get.js +36 -0
  461. package/dist/services/config/config-global-loader.d.ts +15 -0
  462. package/dist/services/config/config-global-loader.js +111 -0
  463. package/dist/services/config/config-nested-path.d.ts +3 -0
  464. package/dist/services/config/config-nested-path.js +53 -0
  465. package/dist/services/config/config-primitives.d.ts +16 -0
  466. package/dist/services/config/config-primitives.js +24 -0
  467. package/dist/services/config/config-service.d.ts +9 -33
  468. package/dist/services/config/config-service.js +16 -665
  469. package/dist/services/config/config-validation.d.ts +19 -0
  470. package/dist/services/config/config-validation.js +152 -0
  471. package/dist/services/config/config-workspace.d.ts +10 -0
  472. package/dist/services/config/config-workspace.js +158 -0
  473. package/dist/services/context/build-dispatch-system-prompt.d.ts +3 -3
  474. package/dist/services/context/build-dispatch-system-prompt.js +7 -7
  475. package/dist/services/context/collector.js +5 -1
  476. package/dist/services/dispatch/active-dispatch-index.d.ts +36 -0
  477. package/dist/services/dispatch/active-dispatch-index.js +118 -0
  478. package/dist/services/dispatch/batch-counter.js +1 -2
  479. package/dist/services/dispatch/dispatch-record-writer.d.ts +29 -16
  480. package/dist/services/dispatch/dispatch-record-writer.js +58 -100
  481. package/dist/services/dispatch/dispatch-sub-agent.js +1 -1
  482. package/dist/services/dispatch/karpathy-block.d.ts +55 -0
  483. package/dist/services/dispatch/karpathy-block.js +101 -0
  484. package/dist/services/dispatch/ledger-reaper.d.ts +80 -0
  485. package/dist/services/dispatch/ledger-reaper.js +131 -0
  486. package/dist/services/evidence/evidence-generator.js +15 -8
  487. package/dist/services/feedback/feedback-promotion-service.d.ts +8 -11
  488. package/dist/services/feedback/feedback-promotion-service.js +30 -35
  489. package/dist/services/feedback/promotion-artifact-json-evidence.d.ts +18 -0
  490. package/dist/services/feedback/promotion-artifact-missing.d.ts +22 -0
  491. package/dist/services/feedback/promotion-artifact-missing.js +63 -0
  492. package/dist/services/final-review/final-review-contract.d.ts +95 -4
  493. package/dist/services/final-review/final-review-contract.js +64 -0
  494. package/dist/services/final-review/final-review-delivery.d.ts +13 -0
  495. package/dist/services/final-review/final-review-delivery.js +26 -12
  496. package/dist/services/final-review/final-review-evidence-collect.js +8 -53
  497. package/dist/services/final-review/final-review-evidence-records.d.ts +21 -0
  498. package/dist/services/final-review/final-review-evidence-records.js +67 -0
  499. package/dist/services/final-review/final-review-evidence-sources.d.ts +22 -0
  500. package/dist/services/final-review/final-review-evidence-sources.js +28 -4
  501. package/dist/services/final-review/final-review-prompt.js +19 -6
  502. package/dist/services/final-review/final-review-runner.js +5 -0
  503. package/dist/services/final-review/final-review-service.d.ts +2 -2
  504. package/dist/services/final-review/index.d.ts +1 -1
  505. package/dist/services/final-review/pre-post-diff.d.ts +2 -75
  506. package/dist/services/final-review/pre-post-diff.js +60 -59
  507. package/dist/services/hooks/pre-tool-code-gate.d.ts +7 -1
  508. package/dist/services/hooks/pre-tool-code-gate.js +21 -2
  509. package/dist/services/hooks/worktree-authorization-gate.js +6 -31
  510. package/dist/services/hooks/worktree-refusal-messages.d.ts +74 -0
  511. package/dist/services/hooks/worktree-refusal-messages.js +102 -0
  512. package/dist/services/lint/eslint-runner-support.d.ts +1 -1
  513. package/dist/services/lint/eslint-runner-support.js +2 -1
  514. package/dist/services/lint/eslint-runner-types.d.ts +8 -0
  515. package/dist/services/lint/eslint-runner.js +17 -4
  516. package/dist/services/llm/anthropic-runner.js +24 -7
  517. package/dist/services/loop/loop-observability.d.ts +39 -0
  518. package/dist/services/loop/loop-observability.js +55 -0
  519. package/dist/services/loop/monotonic-guard.js +6 -9
  520. package/dist/services/loop/monotonic-runner.js +8 -7
  521. package/dist/services/loop/run-driver.js +18 -22
  522. package/dist/services/memory/project-memory-service/index/kind-dispatch.js +14 -1
  523. package/dist/services/memory/project-memory-service/index/project-memory-plan-exec.js +13 -2
  524. package/dist/services/memory/project-memory-service/index.d.ts +2 -2
  525. package/dist/services/memory/project-memory-service/index.js +1 -1
  526. package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.d.ts +36 -0
  527. package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.js +48 -2
  528. package/dist/services/memory/project-memory-service/parsers/markdown-pure.d.ts +23 -1
  529. package/dist/services/memory/project-memory-service/parsers/markdown-pure.js +37 -0
  530. package/dist/services/memory/project-memory-service/types.d.ts +32 -0
  531. package/dist/services/observability/observability-service.d.ts +7 -0
  532. package/dist/services/observability/observability-service.js +2 -1
  533. package/dist/services/prd/gate-evidence-derivation.d.ts +4 -3
  534. package/dist/services/prd/gate-evidence-derivation.js +4 -3
  535. package/dist/services/qa/bdd-test-style-verifier.js +22 -8
  536. package/dist/services/race/gate2-evaluator.d.ts +58 -0
  537. package/dist/services/race/gate2-evaluator.js +111 -0
  538. package/dist/services/race/gate2-policy.d.ts +17 -0
  539. package/dist/services/race/gate2-policy.js +31 -0
  540. package/dist/services/race/lane-phase.d.ts +19 -0
  541. package/dist/services/race/lane-phase.js +113 -0
  542. package/dist/services/race/pilot-gate-store.d.ts +67 -0
  543. package/dist/services/race/pilot-gate-store.js +227 -0
  544. package/dist/services/scan/file-size-baseline.d.ts +26 -0
  545. package/dist/services/scan/file-size-baseline.js +150 -0
  546. package/dist/services/scan/file-size-scan.d.ts +42 -3
  547. package/dist/services/scan/file-size-scan.js +58 -42
  548. package/dist/services/scan/type-sanity-service.js +13 -3
  549. package/dist/services/skill/resume-detector.js +3 -3
  550. package/dist/services/skills/hooks-codegate-superpowers.d.ts +5 -6
  551. package/dist/services/skills/hooks-codegate-superpowers.js +7 -8
  552. package/dist/services/skills/hooks-settings-deny-list.d.ts +61 -0
  553. package/dist/services/skills/hooks-settings-deny-list.js +173 -0
  554. package/dist/services/skills/hooks-settings-envelopes.d.ts +20 -0
  555. package/dist/services/skills/hooks-settings-envelopes.js +79 -0
  556. package/dist/services/skills/hooks-settings-file-shape.d.ts +43 -0
  557. package/dist/services/skills/hooks-settings-file-shape.js +207 -0
  558. package/dist/services/skills/hooks-settings-paths.d.ts +34 -0
  559. package/dist/services/skills/hooks-settings-paths.js +75 -0
  560. package/dist/services/skills/hooks-settings-read-installed.d.ts +39 -0
  561. package/dist/services/skills/hooks-settings-read-installed.js +60 -0
  562. package/dist/services/skills/hooks-settings-service.d.ts +13 -213
  563. package/dist/services/skills/hooks-settings-service.js +72 -658
  564. package/dist/services/skills/hooks-settings-types.d.ts +139 -0
  565. package/dist/services/skills/hooks-settings-types.js +1 -0
  566. package/dist/services/skills/presence-lease-order.d.ts +13 -0
  567. package/dist/services/skills/presence-lease-order.js +24 -0
  568. package/dist/services/skills/skill-conformance-service.js +1 -0
  569. package/dist/services/skills/skill-statusline-service.js +4 -7
  570. package/dist/services/slice/slice-check-service.js +8 -8
  571. package/dist/services/workflow/pipeline-verify-gate-support.js +2 -1
  572. package/dist/services/workflow/pipeline-verify-service.js +1 -1
  573. package/dist/services/workflow/workflow-skip-service.d.ts +0 -20
  574. package/dist/services/workflow/workflow-skip-service.js +3 -4
  575. package/dist/services/workspace/claude-settings-retirements.d.ts +54 -0
  576. package/dist/services/workspace/claude-settings-retirements.js +112 -0
  577. package/dist/services/workspace/claude-settings-template-merge.d.ts +109 -0
  578. package/dist/services/workspace/claude-settings-template-merge.js +223 -0
  579. package/dist/services/workspace/claude-settings-template.d.ts +79 -87
  580. package/dist/services/workspace/claude-settings-template.js +80 -235
  581. package/dist/services/workspace/migrate-1-4-1-service.js +3 -0
  582. package/dist/services/workspace/reconcile-service.js +0 -1
  583. package/dist/shared/incrementing-number.d.ts +10 -0
  584. package/dist/shared/incrementing-number.js +27 -0
  585. package/package.json +5 -5
  586. package/skills/bee/peaks-perf-audit/SKILL.md +1 -1
  587. package/skills/bee/peaks-prd/SKILL.md +1 -1
  588. package/skills/bee/peaks-qa/SKILL.md +1 -1
  589. package/skills/bee/peaks-qa/references/qa-sub-agent-dispatch.md +2 -2
  590. package/skills/bee/peaks-qa/references/qa-transition-gates.md +1 -1
  591. package/skills/bee/peaks-rd/SKILL.md +2 -2
  592. package/skills/bee/peaks-rd/references/rd-fanout-contracts.md +1 -1
  593. package/skills/bee/peaks-rd/references/rd-sub-agent-dispatch.md +8 -4
  594. package/skills/bee/peaks-rd/references/rd-transition-gates.md +3 -3
  595. package/skills/bee/peaks-rd/references/v2-12-fanout-collapse.md +2 -2
  596. package/skills/bee/peaks-rd/references/writing-handoff-frontmatter.md +1 -1
  597. package/skills/bee/peaks-reviewer/SKILL.md +1 -1
  598. package/skills/bee/peaks-sc/SKILL.md +1 -1
  599. package/skills/bee/peaks-security-audit/SKILL.md +10 -2
  600. package/skills/bee/peaks-txt/SKILL.md +4 -3
  601. package/skills/bee/peaks-ui/SKILL.md +3 -3
  602. package/skills/peaks-audit/SKILL.md +29 -1
  603. package/skills/peaks-code/SKILL.md +5 -2
  604. package/skills/peaks-code/references/fast-lane-norm.md +42 -0
  605. package/skills/peaks-code/references/fast-mode.md +3 -2
  606. package/skills/peaks-code/references/local-artifact-workspace.md +3 -3
  607. package/skills/peaks-code/references/micro-cycle.md +3 -3
  608. package/skills/peaks-code/references/resume-detection.md +1 -1
  609. package/skills/peaks-code/references/runbook.md +12 -6
  610. package/skills/peaks-code/references/step-11-memory-sediment.md +4 -0
  611. package/skills/peaks-code/references/sub-agent-dispatch.md +1 -1
  612. package/skills/peaks-code/references/swarm-dispatch-contract.md +40 -16
  613. package/skills/peaks-code/references/workflow-gates-and-types.md +6 -6
  614. package/skills/peaks-code/references/worktree-governance.md +4 -4
  615. package/skills/peaks-content/SKILL.md +1 -1
  616. package/skills/peaks-doctor/SKILL.md +1 -1
  617. package/skills/peaks-final-review/SKILL.md +31 -11
  618. package/skills/peaks-ide/SKILL.md +1 -1
  619. package/skills/peaks-issue-fix-orchestrator/SKILL.md +1 -1
  620. package/skills/peaks-race-code/SKILL.md +185 -0
  621. package/skills/peaks-resume/SKILL.md +1 -1
  622. package/skills/peaks-slice-decompose/SKILL.md +1 -1
  623. package/skills/peaks-solo/SKILL.md +1 -1
  624. package/skills/peaks-sop/SKILL.md +1 -1
  625. package/skills/peaks-status/SKILL.md +1 -1
  626. package/skills/peaks-test/SKILL.md +7 -4
  627. package/dist/services/audit/enforcers/lint-peaks-skill-runtime.d.ts +0 -23
  628. package/dist/services/audit/enforcers/lint-peaks-skill-runtime.js +0 -64
@@ -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;
@@ -0,0 +1,150 @@
1
+ // src/services/scan/file-size-baseline.ts
2
+ //
3
+ // The git side of the diff-scoped file-size scan: WHICH files changed against a
4
+ // base ref, and HOW BIG each was at that ref. Together they make the scan a
5
+ // RATCHET — a file that is over its cap but no larger than its own state at that
6
+ // ref is accepted, and only growth past the cap is refused. Same rule as the
7
+ // commit gate's "a file you touch may not be WORSE than it was"
8
+ // (`.husky/peaks-gate.mjs`).
9
+ //
10
+ // FAIL-CLOSED ON BOTH GIT READS. The enumeration and the size probe both name
11
+ // their failure instead of swallowing it: a ratchet whose input list can
12
+ // silently become empty is not a ratchet, and `catch { return [] }` cannot tell
13
+ // "git refused to enumerate" from "nothing changed".
14
+ //
15
+ // RENAMES ARE JUDGED, NOT DROPPED. A rename is enumerated as `R` and compared
16
+ // against the OLD path's size at `baseRef`, so a pure rename passes and a
17
+ // rename that grows is refused naming the growth. The `--diff-filter=AM`
18
+ // spelling this replaced excluded `R` by accident — a file could grow past its
19
+ // cap and stay invisible to the scan simply by being renamed in the same
20
+ // commit.
21
+ //
22
+ // KNOWN, RECORDED, NOT FIXED — a DELETION is invisible: `D` entries are dropped
23
+ // before the measurement, and that is left as it is because a deletion cannot
24
+ // grow. It is a documentation matter, not a hole in the ratchet.
25
+ //
26
+ // KNOWN, RECORDED, NOT FIXED — subprocess cost is `2 + 2K` git spawns, where K
27
+ // is the changed files that are OVER their cap (one `cat-file -e` plus one
28
+ // `show` each, inside the scan's `lines > cap` branch; the 2 are the
29
+ // enumerations above). It is linear in OVER-CAP changed files, not in changed
30
+ // files: 10 changed with 0 over spawns 2, with 2 over spawns 6, with 5 over
31
+ // spawns 12; 40 changed with 3 over spawns 8 and with 40 over spawns 82. At
32
+ // roughly 58 ms per process on the measured host that is 0.8 s at K=5 and 4.7 s
33
+ // at K=40, paid once per slice on a human-run command with two call sites.
34
+ // Batching every baseline read through one `git cat-file --batch` on stdin is
35
+ // the known fix if the many-over-cap case ever becomes real; it is not
36
+ // warranted at these numbers.
37
+ //
38
+ // Split out of `file-size-scan.ts`. That file was 237 raw lines at the split
39
+ // (not "at its cap"): the point is that this logic did not fit under 300 there,
40
+ // and the scan now depends on this module rather than on a hand-rolled list.
41
+ // This module's own name matches the `file-size` pattern the walk-based
42
+ // policy-wiring rule (`policyWiringFindings` in
43
+ // `tests/unit/standards/_file-size-cap-scan.ts`, asserted by
44
+ // `tests/unit/standards/file-size-cap.test.ts`) requires to import
45
+ // `file-size-policy.ts`; that test's literal fixtures name `file-size-scan.ts`,
46
+ // not this file.
47
+ import { execFileSync, spawnSync } from 'node:child_process';
48
+ import { countRawLines, normalizePolicyPath } from './file-size-policy.js';
49
+ /** A git read the scan needs could not be completed. Thrown, never returned:
50
+ * the alternative is an empty file list that reads as "nothing changed". */
51
+ export class GitReadFailedError extends Error {
52
+ code = 'FILE_SIZE_GIT_READ_FAILED';
53
+ constructor(what, projectRoot, detail) {
54
+ super(`File-size scan refused: ${what} could not be read from git in ${projectRoot} ` +
55
+ `(${detail}). A git failure is not "nothing changed"; fix the ref/path, or pass ` +
56
+ 'a `baseRef` that resolves.');
57
+ this.name = 'GitReadFailedError';
58
+ }
59
+ }
60
+ function gitLines(projectRoot, args) {
61
+ let raw;
62
+ try {
63
+ raw = execFileSync('git', ['-C', projectRoot, ...args], {
64
+ encoding: 'utf8',
65
+ windowsHide: true
66
+ });
67
+ }
68
+ catch (error) {
69
+ const detail = error instanceof Error ? (error.message.split('\n')[0] ?? '') : String(error);
70
+ throw new GitReadFailedError(`\`git ${args.join(' ')}\``, projectRoot, detail);
71
+ }
72
+ return raw
73
+ .split(/\r?\n/)
74
+ .map((line) => line.trim())
75
+ .filter(Boolean);
76
+ }
77
+ /**
78
+ * The caller's list, intersected with what git reports — or the whole change set when
79
+ * the caller named none. Compared in the policy's POSIX spelling, because a
80
+ * Windows-native caller path and a git-reported one spell the same file differently.
81
+ *
82
+ * INTERSECTION, NOT POPULATION. The commit hook is handed the STAGED paths by
83
+ * lint-staged, so it knows its set and the set is narrower than the working tree: a
84
+ * modification nobody staged is not part of that commit, and measuring it would block
85
+ * the commit over a file it was never asked about. A named path git does not report as
86
+ * changed is therefore skipped, never measured — this narrows; it cannot widen.
87
+ */
88
+ function restrictedTo(all, only) {
89
+ if (only === undefined)
90
+ return [...all];
91
+ const wanted = new Set(only.map(normalizePolicyPath));
92
+ return all.filter((file) => wanted.has(normalizePolicyPath(file)));
93
+ }
94
+ /**
95
+ * The changed-file population the scan measures, as `git diff --name-status`
96
+ * reports it. `A`/`M` keep their path; `R`/`C` keep the TARGET path and record
97
+ * the source, so the rename is judged against the size the file had before it
98
+ * moved; `D` is dropped. A git failure here THROWS rather than returning `[]`.
99
+ *
100
+ * `only` is the caller's own list, when it has one — see `restrictedTo`.
101
+ */
102
+ export function readChangedFiles(projectRoot, baseRef, only) {
103
+ const paths = [];
104
+ const renameSources = new Map();
105
+ for (const line of gitLines(projectRoot, ['diff', '--name-status', baseRef])) {
106
+ const [status, first, second] = line.split('\t');
107
+ if (status === undefined || first === undefined)
108
+ continue;
109
+ if ((status.startsWith('R') || status.startsWith('C')) && second !== undefined) {
110
+ paths.push(second);
111
+ renameSources.set(second, first);
112
+ }
113
+ else if (status.startsWith('A') || status.startsWith('M')) {
114
+ paths.push(first);
115
+ }
116
+ }
117
+ const untracked = gitLines(projectRoot, ['ls-files', '--others', '--exclude-standard']);
118
+ const allPaths = Array.from(new Set([...paths, ...untracked]));
119
+ return {
120
+ paths: restrictedTo(allPaths, only),
121
+ baselinePathFor: (file) => renameSources.get(file) ?? file
122
+ };
123
+ }
124
+ /**
125
+ * Whether `git cat-file -e` could resolve `<baseRef>:<file>`, i.e. whether the
126
+ * probe EXITED ZERO. What a non-zero exit actually measures is wider than "the
127
+ * ref has no such path": a bad or unreadable ref (a misspelled name, or `HEAD~1`
128
+ * on a root commit) and any other git failure exit non-zero too and are read
129
+ * identically. That conflation is fail-closed — no baseline means
130
+ * `previousLines: null`, which the scan reads as "created over the cap" and
131
+ * refuses. Stated so the next reader does not take the narrow reading.
132
+ */
133
+ function pathExistsAtRef(projectRoot, baseRef, file) {
134
+ const probe = spawnSync('git', ['-C', projectRoot, 'cat-file', '-e', `${baseRef}:${file}`], {
135
+ stdio: 'ignore',
136
+ windowsHide: true
137
+ });
138
+ return probe.status === 0;
139
+ }
140
+ /** The file's raw-line count AT `baseRef`, or `null` when the ref has no such
141
+ * path — i.e. the change ADDED the file and it is over the cap by creation. */
142
+ export function readBaseLineCount(projectRoot, baseRef, file) {
143
+ if (!pathExistsAtRef(projectRoot, baseRef, file)) {
144
+ return null;
145
+ }
146
+ return countRawLines(execFileSync('git', ['-C', projectRoot, 'show', `${baseRef}:${file}`], {
147
+ encoding: 'utf8',
148
+ windowsHide: true
149
+ }));
150
+ }
@@ -29,6 +29,17 @@ export type FileSizeViolation = {
29
29
  /** The cap this file was measured against, resolved per path by the policy
30
30
  * module (300 raw lines; 500 under root `tests/`), or the caller's override. */
31
31
  cap: number;
32
+ /**
33
+ * The file's raw-line count at `baseRef`, or `null` when the file did not
34
+ * exist there — i.e. THIS change CREATED it over the cap.
35
+ *
36
+ * A changed file that is over its cap but NOT larger than its own state at
37
+ * `baseRef` is not a violation: the whole-tree `fileSizeOverCap` ratchet
38
+ * already accepts it as a standing quantity, so touching it must stay legal.
39
+ * Only growth travels here — including growth that a rename carried along,
40
+ * which is measured against the pre-rename path.
41
+ */
42
+ previousLines: number | null;
32
43
  };
33
44
  export type FileSizeScanResult = {
34
45
  ok: boolean;
@@ -41,10 +52,17 @@ export type FileSizeScanResult = {
41
52
  * records). Reported so the exemption is auditable rather than a silent
42
53
  * skip. */
43
54
  exemptFiles: string[];
44
- /** Files that appeared in `git diff` but no longer exist on disk (e.g.
45
- * deleted in the working tree). Pre-#015 the scan crashed on these via
46
- * ENOENT; now they are reported here as informational data. */
55
+ /** Files that appeared in `git diff` but no longer exist on disk. Pre-#015
56
+ * the scan crashed on these via ENOENT; now they are reported, not counted. */
47
57
  deletedFiles: string[];
58
+ /**
59
+ * Changed files that ARE over their cap right now but this change did not
60
+ * enlarge (they were already that large at `baseRef`, or larger). They
61
+ * are NOT violations — the ratchet accepts them — but they are named here
62
+ * rather than dropped, so "0 violations" cannot mean "nothing was over the
63
+ * cap"; the same reason `exemptFiles` and `outOfScopeFiles` exist.
64
+ */
65
+ acceptedOverCapFiles: string[];
48
66
  /** Changed files the file-size policy does not measure at all: outside its
49
67
  * four scope directories, or with an extension it does not count. Reported
50
68
  * rather than silently skipped, for the same reason `exemptFiles` is.
@@ -74,5 +92,26 @@ export type FileSizeScanOptions = {
74
92
  * the policy is the default, this option only overrides it.
75
93
  */
76
94
  threshold?: number;
95
+ /**
96
+ * The caller's own list, when it has one — the commit hook is handed the STAGED
97
+ * paths by lint-staged. It RESTRICTS the git change set (a path git does not
98
+ * report as changed is skipped, never measured) and never widens it; omitted,
99
+ * git alone decides the population.
100
+ */
101
+ files?: readonly string[];
77
102
  };
103
+ /**
104
+ * The diff-scoped scan, judged as a RATCHET: a changed file is a violation only
105
+ * when THIS change enlarged it — it grew past its cap, or was created over it.
106
+ * A file that is over its cap but no larger than its own state at `baseRef`
107
+ * passes, because the baseline already carries it as an accepted over-cap
108
+ * quantity (`ceilings.fileSizeOverCap`) and `request transition rd →
109
+ * implemented` refusing to touch any of those files is the contradiction that
110
+ * blocked two consecutive slices. A rename is judged against the size the file
111
+ * had before it moved, so moving a file is not itself growth.
112
+ *
113
+ * THROWS `GitReadFailedError` when git cannot enumerate the changed files (an
114
+ * unresolvable `baseRef`, a non-repo path) — an empty list must mean "nothing
115
+ * changed", never "the read failed". `readChangedFiles` owns that refusal.
116
+ */
78
117
  export declare function scanFileSize(options: FileSizeScanOptions): FileSizeScanResult;