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,221 @@
1
+ // src/cli/commands/final-review-prepare-command.ts
2
+ //
3
+ // The body of `peaks prepare-final-review`: the two input validations, the
4
+ // audit-goal path resolution, the provider check, the stub scaffold route and
5
+ // the real-provider route. Split out of `final-review-commands.ts`; every
6
+ // envelope code, message, `data` field and next-action string is unchanged.
7
+ //
8
+ // The input validations and the `_runtime` join below live in ONE module on
9
+ // purpose: rule D is file-scoped, so a join whose id slot is checked two
10
+ // modules away is a join the guard cannot see.
11
+ import { existsSync, statSync } from 'node:fs';
12
+ import { join, resolve } from 'node:path';
13
+ import { REQUEST_ID_PATTERN } from '../../services/artifacts/request-artifact-service.js';
14
+ import { createAnthropicRunner, LlmBindingError, resolveAnthropicConfig } from '../../services/llm/anthropic-runner.js';
15
+ import { emitTokenUsageEvent } from '../../services/observability/observability-service.js';
16
+ import { prepareFinalReview } from '../../services/final-review/final-review-service.js';
17
+ import { getErrorMessage } from '../cli-helpers.js';
18
+ import { DEFAULT_LLM_PROVIDER, isSupportedLlmProvider, SUPPORTED_LLM_PROVIDERS } from './final-review-command-shared.js';
19
+ import { emitPrepareFailure, emitReviewEnvelope, emitStubEnvelope, finalReviewErrorCode, finalReviewNextActions } from './final-review-command-envelopes.js';
20
+ function validateProjectRoot(projectArg) {
21
+ const projectRoot = resolve(projectArg);
22
+ if (!existsSync(projectRoot)) {
23
+ return {
24
+ ok: false,
25
+ code: 'PROJECT_NOT_FOUND',
26
+ message: `project path does not exist: ${projectArg}`
27
+ };
28
+ }
29
+ let stat;
30
+ try {
31
+ stat = statSync(projectRoot);
32
+ }
33
+ catch (error) {
34
+ return { ok: false, code: 'INVALID_PROJECT', message: getErrorMessage(error) };
35
+ }
36
+ if (!stat.isDirectory()) {
37
+ return {
38
+ ok: false,
39
+ code: 'INVALID_PROJECT',
40
+ message: `project path is not a directory: ${projectArg}`
41
+ };
42
+ }
43
+ return { ok: true, projectRoot };
44
+ }
45
+ /**
46
+ * Validate the session id. Rejects empty, path-traversal (`..`), and
47
+ * any segment separator (`/`, `\`) so the caller cannot escape
48
+ * `.peaks/_runtime/<sessionId>/audit-goal/` via CLI flags.
49
+ */
50
+ function validateSessionId(sessionId) {
51
+ if (sessionId.length === 0) {
52
+ return {
53
+ ok: false,
54
+ code: 'MISSING_REQUIRED_FLAG',
55
+ message: '`--session-id` is required and must be a non-empty string'
56
+ };
57
+ }
58
+ if (sessionId.includes('..') || sessionId.includes('/') || sessionId.includes('\\')) {
59
+ return {
60
+ ok: false,
61
+ code: 'INVALID_SESSION_ID',
62
+ message: '`--session-id` must not contain path-traversal or path-separator characters (rejected: "..", "/", "\\")'
63
+ };
64
+ }
65
+ return { ok: true, sessionId };
66
+ }
67
+ /** The refusal for an audit goal the pre-flight did not find on disk. */
68
+ function auditGoalMissingRefusal(rid, sessionId, auditGoalPath) {
69
+ return {
70
+ rid,
71
+ code: 'AUDIT_GOAL_NOT_FOUND',
72
+ message: `audit-goal file not found at expected path: ${auditGoalPath}`,
73
+ sessionId,
74
+ auditGoalPath,
75
+ nextActions: [
76
+ 'Run `peaks audit goal --project <path> --need <text>` first to produce the approved goal JSON.',
77
+ 'Confirm `--session-id` matches the session that wrote the goal.'
78
+ ]
79
+ };
80
+ }
81
+ /**
82
+ * Resolve the audit-goal path, or the refusal that replaces it.
83
+ *
84
+ * The `rid` axis is checked HERE, at the join: the rid is the CLI positional
85
+ * and it is the FILENAME segment, so the `--session-id` validation does not
86
+ * cover it (added 2026-09-14, repair R1 — a second-slot hole, found by the
87
+ * widened rule D rather than by a human reading the file).
88
+ *
89
+ * The audit-goal existence pre-flight sits here too, so the caller learns the
90
+ * real reason its request cannot proceed BEFORE the provider check.
91
+ */
92
+ function resolveAuditGoalPath(rid, options, projectRoot) {
93
+ const sessionValidation = validateSessionId(options.sessionId);
94
+ if (!sessionValidation.ok) {
95
+ return {
96
+ rid,
97
+ code: sessionValidation.code,
98
+ message: sessionValidation.message,
99
+ sessionId: options.sessionId,
100
+ auditGoalPath: '',
101
+ nextActions: [
102
+ 'Pass a non-empty `--session-id` whose value is a single segment (no "..", "/", or "\\")'
103
+ ]
104
+ };
105
+ }
106
+ if (!REQUEST_ID_PATTERN.test(rid)) {
107
+ return {
108
+ rid,
109
+ code: 'RID_INVALID',
110
+ message: `Invalid request id: ${rid} (expected letters, digits, dots, underscores, or dashes)`,
111
+ sessionId: sessionValidation.sessionId,
112
+ auditGoalPath: '',
113
+ nextActions: ['Pass the rid of the slice, e.g. 2026-09-14-some-slug']
114
+ };
115
+ }
116
+ const auditGoalPath = join(projectRoot, '.peaks', '_runtime', sessionValidation.sessionId, 'audit-goal', `${rid}.json`);
117
+ if (!existsSync(auditGoalPath)) {
118
+ return auditGoalMissingRefusal(rid, sessionValidation.sessionId, auditGoalPath);
119
+ }
120
+ return { projectRoot, sessionId: sessionValidation.sessionId, auditGoalPath };
121
+ }
122
+ /** Resolve the three inputs the run needs, or the refusal that replaces them. */
123
+ function resolvePrepareInputs(rid, options) {
124
+ const projectValidation = validateProjectRoot(options.project);
125
+ if (!projectValidation.ok) {
126
+ return {
127
+ rid,
128
+ code: projectValidation.code,
129
+ message: projectValidation.message,
130
+ sessionId: options.sessionId,
131
+ auditGoalPath: '',
132
+ nextActions: ['Verify the project path exists and is a directory']
133
+ };
134
+ }
135
+ return resolveAuditGoalPath(rid, options, projectValidation.projectRoot);
136
+ }
137
+ function isRefusal(value) {
138
+ return !('projectRoot' in value);
139
+ }
140
+ /**
141
+ * The `token-usage` emission owner: the one site where a completed review's
142
+ * token counts and the session binding are both in scope. Fire-and-forget —
143
+ * `emitTokenUsageEvent` never throws, and this never blocks or fails the review
144
+ * it reports on.
145
+ *
146
+ * `source` defaults to `'provider'` only for a runner that states neither: the
147
+ * real runner always tags its counts (`anthropic-runner.ts` `tokenCounts`), so
148
+ * the default is reached by a test fake, not by a production call.
149
+ */
150
+ function emitReviewTokenUsage(inputs, tokens) {
151
+ emitTokenUsageEvent({
152
+ projectRoot: inputs.projectRoot,
153
+ sessionId: inputs.sessionId,
154
+ inputTokens: tokens.input,
155
+ outputTokens: tokens.output,
156
+ source: tokens.source ?? 'provider'
157
+ });
158
+ }
159
+ /**
160
+ * Real provider path: bind a real `LlmRunner` and run the service.
161
+ *
162
+ * Binding happens INSIDE the try so an absent credential surfaces as
163
+ * `LlmBindingError`'s own code instead of escaping as a crash. No envelope is
164
+ * emitted on that path — a "successful" empty review would be worse than an
165
+ * error.
166
+ */
167
+ async function runRealReview(io, rid, inputs, options) {
168
+ const { json } = options;
169
+ try {
170
+ const config = resolveAnthropicConfig();
171
+ const llmRunner = createAnthropicRunner(config);
172
+ const review = await prepareFinalReview(rid, {
173
+ projectRoot: inputs.projectRoot,
174
+ sessionId: inputs.sessionId,
175
+ llmRunner,
176
+ ...(options.base === undefined ? {} : { baseRef: options.base }),
177
+ onLlmTokens: (tokens) => emitReviewTokenUsage(inputs, tokens)
178
+ });
179
+ emitReviewEnvelope(io, { rid, goal: inputs, model: config.model, review, json });
180
+ }
181
+ catch (error) {
182
+ const code = finalReviewErrorCode(error);
183
+ emitPrepareFailure(io, json, {
184
+ rid,
185
+ code,
186
+ message: getErrorMessage(error),
187
+ sessionId: inputs.sessionId,
188
+ auditGoalPath: inputs.auditGoalPath,
189
+ nextActions: finalReviewNextActions(code)
190
+ }, error instanceof LlmBindingError ? error.missingEnv : undefined);
191
+ }
192
+ }
193
+ export async function runPrepareFinalReview(rid, options, io) {
194
+ const inputs = resolvePrepareInputs(rid, options);
195
+ if (isRefusal(inputs)) {
196
+ emitPrepareFailure(io, options.json, inputs);
197
+ return;
198
+ }
199
+ // Unknown provider names fail loudly — a silent fallback to `stub` would hand
200
+ // the caller a scaffold envelope that reads as a review route, which is the
201
+ // defect class this gate exists to stop.
202
+ const provider = options.llmProvider ?? DEFAULT_LLM_PROVIDER;
203
+ if (!isSupportedLlmProvider(provider)) {
204
+ emitPrepareFailure(io, options.json, {
205
+ rid,
206
+ code: 'LLM_PROVIDER_NOT_IMPLEMENTED',
207
+ message: `LLM provider "${provider}" is not implemented. Supported providers: ${SUPPORTED_LLM_PROVIDERS.join(', ')}.`,
208
+ sessionId: inputs.sessionId,
209
+ auditGoalPath: inputs.auditGoalPath,
210
+ nextActions: [
211
+ `Re-run with \`--llm-provider anthropic\` for a real 4-dim review, or \`--llm-provider ${DEFAULT_LLM_PROVIDER}\` for an offline scaffold.`
212
+ ]
213
+ });
214
+ return;
215
+ }
216
+ if (provider === 'stub') {
217
+ emitStubEnvelope(io, rid, inputs, options.json);
218
+ return;
219
+ }
220
+ await runRealReview(io, rid, inputs, options);
221
+ }
@@ -149,9 +149,9 @@ export function emitAllowSkipped(io, options) {
149
149
  }
150
150
  /**
151
151
  * Hard block: a worktree-mutating tool call without a current-task user grant. emitBlock writes
152
- * the Claude Code permissionDecision:"deny" envelope and exits 2. The reason includes the
153
- * remediation hint so the LLM can run `peaks worktree auth grant` and retry, and the user can
154
- * read the deny text in the next-turn stderr.
152
+ * the Claude Code permissionDecision:"deny" envelope and exits 2. The reason carries the
153
+ * remediation hint from `worktree-refusal-messages.ts`, which names the USER-side path — the
154
+ * grant is not the agent's to issue — and the user can read the deny text in the next-turn stderr.
155
155
  */
156
156
  function emitWorktreeDeny(io, options, wtDecision) {
157
157
  emitBlock(io, `[worktree-gate:${wtDecision.code}] ${wtDecision.reason} — ${wtDecision.remediation}`);
@@ -1,18 +1,32 @@
1
1
  /**
2
+ * The `peaks contract` / `peaks classify` entry point.
2
3
  *
3
4
  * Pre-merge originals (now deleted):
4
- * - src/cli/commands/contract-commands.ts (167 lines)
5
+ * - src/cli/commands/contract-commands.ts (167 lines)
5
6
  * - src/cli/commands/classify-classify-commands.ts (190 lines)
6
7
  *
7
- * Both exported `register*Commands` functions are preserved **verbatim**
8
- * (function name, signature, body). The merge is a structural refactor
9
- * only — no behavior change. `autoRegisterAllCommands` discovers both
10
- * exports from this single file.
8
+ * Both `register*Commands` functions are preserved **verbatim** (function name,
9
+ * signature, body). The merge was a structural refactor only — no behavior
10
+ * change — and `autoRegisterAllCommands` discovers both exports from this single
11
+ * file. This module is now the entry point and no longer holds the verbs:
11
12
  *
12
- * minimum; Family 1 is the cleanest demonstration because both inputs
13
- * sit under 200 lines and the merged file lands at ~360 lines — well
13
+ * `contract-write-command.ts` `peaks contract write`
14
+ * `classify-run-command.ts` `peaks classify run`
15
+ * `classify-downgrade-command.ts` `peaks classify downgrade` (always refused)
16
+ * `classify-signals.ts` the diff signals + the audit log
14
17
  */
15
18
  import type { Command } from 'commander';
16
- import { type ProgramIO } from '../cli-helpers.js';
17
- export declare function registerContractCommands(program: Command, io: ProgramIO): void;
19
+ import type { ProgramIO } from '../cli-helpers.js';
20
+ export { registerContractCommands } from './contract-write-command.js';
21
+ /**
22
+ * peaks classify CLI (Slice L1a + L1b).
23
+ *
24
+ * Subcommands:
25
+ * - peaks classify run --project <path> [--override <level> --reason "<text>"]
26
+ * Classify the current diff via the heuristic + return a JSON envelope
27
+ * with the chosen level, gate set, and audit log.
28
+ * - peaks classify downgrade --level <level> --reason "<text>" --project <path>
29
+ * Always refused (per spec §4: "peaks classify downgrade" always errors
30
+ * out). LLM may ask; the CLI never grants.
31
+ */
18
32
  export declare function registerClassifyCommands(program: Command, io: ProgramIO): void;
@@ -1,281 +1,38 @@
1
1
  /**
2
+ * The `peaks contract` / `peaks classify` entry point.
2
3
  *
3
4
  * Pre-merge originals (now deleted):
4
- * - src/cli/commands/contract-commands.ts (167 lines)
5
+ * - src/cli/commands/contract-commands.ts (167 lines)
5
6
  * - src/cli/commands/classify-classify-commands.ts (190 lines)
6
7
  *
7
- * Both exported `register*Commands` functions are preserved **verbatim**
8
- * (function name, signature, body). The merge is a structural refactor
9
- * only — no behavior change. `autoRegisterAllCommands` discovers both
10
- * exports from this single file.
8
+ * Both `register*Commands` functions are preserved **verbatim** (function name,
9
+ * signature, body). The merge was a structural refactor only — no behavior
10
+ * change — and `autoRegisterAllCommands` discovers both exports from this single
11
+ * file. This module is now the entry point and no longer holds the verbs:
11
12
  *
12
- * minimum; Family 1 is the cleanest demonstration because both inputs
13
- * sit under 200 lines and the merged file lands at ~360 lines — well
13
+ * `contract-write-command.ts` `peaks contract write`
14
+ * `classify-run-command.ts` `peaks classify run`
15
+ * `classify-downgrade-command.ts` `peaks classify downgrade` (always refused)
16
+ * `classify-signals.ts` the diff signals + the audit log
17
+ */
18
+ import { registerClassifyDowngradeCommand } from './classify-downgrade-command.js';
19
+ import { registerClassifyRunCommand } from './classify-run-command.js';
20
+ export { registerContractCommands } from './contract-write-command.js';
21
+ /**
22
+ * peaks classify CLI (Slice L1a + L1b).
23
+ *
24
+ * Subcommands:
25
+ * - peaks classify run --project <path> [--override <level> --reason "<text>"]
26
+ * Classify the current diff via the heuristic + return a JSON envelope
27
+ * with the chosen level, gate set, and audit log.
28
+ * - peaks classify downgrade --level <level> --reason "<text>" --project <path>
29
+ * Always refused (per spec §4: "peaks classify downgrade" always errors
30
+ * out). LLM may ask; the CLI never grants.
14
31
  */
15
- // ===========================================================================
16
- // Shared imports (consolidated; both originals pulled names from these
17
- // same modules — `cli-helpers.ts` re-exports `getErrorMessage` from
18
- // `peaks-loop-shared/result`, so the single canonical import is
19
- // functionally identical to either original line.)
20
- // ===========================================================================
21
- import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
22
- import { join } from 'node:path';
23
- import { fail, ok, getErrorMessage } from 'peaks-loop-shared/result';
24
- import { addJsonOption, printResult } from '../cli-helpers.js';
25
- import { writeContract } from '../../services/dispatch/contract-store.js';
26
- import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
27
- import { classifyTask } from '../../services/classify/classify-service.js';
28
- import { TASK_LEVELS } from '../../services/classify/classify-types.js';
29
- import { loadPreferences } from '../../services/preferences/preferences-service.js';
30
- // ===========================================================================
31
- // Section 1: `peaks contract` CLI commands (was contract-commands.ts).
32
- // ===========================================================================
33
- const INPUT_LIMIT_BYTES = 256 * 1024;
34
- /** Split a comma-separated flag value into a trimmed string array. */
35
- function splitCsv(value) {
36
- if (value === undefined)
37
- return [];
38
- return value
39
- .split(',')
40
- .map((s) => s.trim())
41
- .filter((s) => s.length > 0);
42
- }
43
- export function registerContractCommands(program, io) {
44
- const contract = program
45
- .command('contract')
46
- .description('Slice contract store (skill-first / CLI-auxiliary). These commands ' +
47
- 'are primitives that peaks-code / peaks-rd SKILL.md compose. The LLM-side ' +
48
- 'runner (the IDE-resident sub-agent that finished a slice) calls ' +
49
- "`peaks contract write` to persist the slice's public surface; the " +
50
- 'orchestrator picks it up on the next dispatch run via listContracts() ' +
51
- 'and splices it into downstream prompts via formatContractInjection().');
52
- // ─────────────────────────────────────────────────────────────────
53
- // peaks contract write --project <root> --session-id <sid>
54
- // --slice-id <id> --exports <a,b> --types <x,y> --signatures <s1,s2>
55
- // [--broadcast-to <b1,b2>] [--completed-at <iso>]
56
- // ─────────────────────────────────────────────────────────────────
57
- addJsonOption(contract
58
- .command('write')
59
- .description("2.7.0 slice-dag-dispatcher MVP: persist a finished slice's public " +
60
- 'surface (exports / types / publicSignatures) to disk at ' +
61
- '.peaks/_runtime/<sessionId>/dispatch/contracts/<slice-id>.json. ' +
62
- 'The orchestrator picks it up on the next dispatch run. Idempotent: ' +
63
- 're-running with the same inputs overwrites in place; the SHA-256 ' +
64
- 'contractHash is content-derived so a contract write from a different ' +
65
- 'runner (re-execution) is detected as a content change.')
66
- .option('--project <path>', 'target project root (defaults to cwd)')
67
- .option('--session-id <sid>', 'session id (default: resolve from .peaks/_runtime/session.json; falls back to PEAKS_SESSION_ID env var; final fallback "unknown-sid")')
68
- .requiredOption('--slice-id <id>', 'slice id; must be non-empty; used as the contract filename basename')
69
- .option('--exports <list>', 'comma-separated public export names (e.g. "validateDag,topologicalLevels")')
70
- .option('--types <list>', 'comma-separated public type names (e.g. "SliceDag,SliceNode")')
71
- .option('--signatures <list>', 'comma-separated public function/method signatures (e.g. "validateDag(dag: SliceDag): void")')
72
- .option('--broadcast-to <list>', 'comma-separated downstream slice ids that should auto-inherit this contract (e.g. "B,C")')
73
- .option('--completed-at <iso>', 'ISO 8601 timestamp; defaults to now()')).action((options) => {
74
- const asJson = options.json === true;
75
- const projectRoot = options.project ?? process.cwd();
76
- const sid = options.sessionId ??
77
- process.env.PEAKS_SESSION_ID ??
78
- getCurrentSessionId(projectRoot) ??
79
- 'unknown-sid';
80
- const sliceId = options.sliceId;
81
- if (sliceId === undefined || sliceId.length === 0) {
82
- printResult(io, fail('contract.write', 'MISSING_SLICE_ID', '--slice-id is required', { path: null, contract: null }, [
83
- 'Re-run with --slice-id <id> (must be non-empty; used as the contract filename basename).'
84
- ]), asJson);
85
- process.exitCode = 1;
86
- return;
87
- }
88
- const exports = splitCsv(options.exports);
89
- const types = splitCsv(options.types);
90
- const signatures = splitCsv(options.signatures);
91
- const broadcastTo = splitCsv(options.broadcastTo);
92
- // Cap the combined input to protect the file IO from runaway values
93
- // (e.g. a 10MB comma-separated --signatures flag).
94
- const inputSize = sliceId.length +
95
- sid.length +
96
- exports.join(',').length +
97
- types.join(',').length +
98
- signatures.join(',').length +
99
- broadcastTo.join(',').length +
100
- (options.completedAt?.length ?? 0);
101
- if (inputSize > INPUT_LIMIT_BYTES) {
102
- printResult(io, fail('contract.write', 'INPUT_TOO_LARGE', `combined input size ${inputSize} bytes exceeds ${INPUT_LIMIT_BYTES} (likely oversized --exports/--types/--signatures lists)`, { path: null, contract: null }, ['Split the slice into smaller surfaces or omit optional fields.']), asJson);
103
- process.exitCode = 1;
104
- return;
105
- }
106
- try {
107
- const input = {
108
- sliceId,
109
- sessionId: sid,
110
- exports,
111
- types,
112
- publicSignatures: signatures,
113
- ...(broadcastTo.length > 0 ? { broadcastTo } : {}),
114
- ...(options.completedAt !== undefined ? { completedAt: options.completedAt } : {})
115
- };
116
- const result = writeContract(projectRoot, sid, input);
117
- printResult(io, ok('contract.write', {
118
- path: result.path,
119
- contractHash: result.contract.contractHash,
120
- sliceId: result.contract.sliceId,
121
- sessionId: result.contract.sessionId,
122
- completedAt: result.contract.completedAt,
123
- exportCount: result.contract.exports.length,
124
- typeCount: result.contract.types.length,
125
- signatureCount: result.contract.publicSignatures.length,
126
- broadcastTo: result.contract.broadcastTo ?? []
127
- }, [], [
128
- `Contract written; orchestrator will pick it up on the next \`peaks sub-agent dispatch --from-dag\` run.`,
129
- `Re-running with the same inputs is idempotent (overwrites in place).`
130
- ]), asJson);
131
- }
132
- catch (err) {
133
- printResult(io, fail('contract.write', 'WRITE_ERROR', getErrorMessage(err), { path: null, contract: null }, [
134
- 'See error message; check that --project is a writable directory and --slice-id is a valid filename basename (no path separators).'
135
- ]), asJson);
136
- process.exitCode = 1;
137
- }
138
- });
139
- }
140
- const CLASSIFY_AUDIT_FILE = 'classify-audit.jsonl';
141
- function getSignalsFromGitDiff(projectRoot) {
142
- // Use git diff --stat to extract file count + line count. Fall back to
143
- // zeros if git is unavailable (e.g. fresh repo with no commits).
144
- let stdout;
145
- try {
146
- const { execFileSync } = require('node:child_process');
147
- stdout = execFileSync('git', ['diff', '--shortstat', 'HEAD'], {
148
- cwd: projectRoot,
149
- stdio: ['ignore', 'pipe', 'ignore'],
150
- maxBuffer: 32 * 1024 * 1024,
151
- windowsHide: true
152
- }).toString('utf8');
153
- }
154
- catch {
155
- return {
156
- filesChanged: 0,
157
- linesChanged: 0,
158
- touchesDependencies: false,
159
- touchesMigrationScripts: false,
160
- isPureRefactor: true,
161
- keywords: []
162
- };
163
- }
164
- const lines = stdout.split('\n').filter((l) => l.trim().length > 0);
165
- const filesChanged = lines.length;
166
- let added = 0;
167
- let removed = 0;
168
- let touchesDependencies = false;
169
- let touchesMigrationScripts = false;
170
- for (const line of lines) {
171
- const match = /(\d+)\s+insertion.*?(\d+)\s+deletion/.exec(line);
172
- if (match) {
173
- added += Number(match[1]);
174
- removed += Number(match[2]);
175
- }
176
- if (/(package\.json|pnpm-lock\.yaml|yarn\.lock|requirements\.txt|go\.mod)/.test(line)) {
177
- touchesDependencies = true;
178
- }
179
- if (/(migrate|codemod|backfill|schema)/.test(line)) {
180
- touchesMigrationScripts = true;
181
- }
182
- }
183
- // isPureRefactor: heuristic — if added lines / removed lines < 0.1 OR
184
- // no new exports were added, treat as refactor. For L2.2 the signal is
185
- // binary (true/false). Default: true (no behavior change is the safe
186
- // assumption; flip to false when keyword 'add' / 'new' / 'feature' present).
187
- const isPureRefactor = true;
188
- return {
189
- filesChanged,
190
- linesChanged: added + removed,
191
- touchesDependencies,
192
- touchesMigrationScripts,
193
- isPureRefactor,
194
- keywords: []
195
- };
196
- }
197
- function appendAuditEntry(projectRoot, entry) {
198
- const auditDir = join(projectRoot, '.peaks/_runtime');
199
- if (!existsSync(auditDir)) {
200
- try {
201
- mkdirSync(auditDir, { recursive: true });
202
- }
203
- catch {
204
- /* ignore */
205
- } // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
206
- }
207
- const auditPath = join(auditDir, CLASSIFY_AUDIT_FILE);
208
- let body = '';
209
- try {
210
- if (existsSync(auditPath)) {
211
- body = readFileSync(auditPath, 'utf8');
212
- }
213
- }
214
- catch {
215
- /* ignore */
216
- } // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
217
- body += JSON.stringify(entry) + '\n';
218
- try {
219
- writeFileSync(auditPath, body);
220
- }
221
- catch {
222
- /* best-effort */
223
- } // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
224
- }
225
- function isTaskLevel(value) {
226
- return TASK_LEVELS.includes(value);
227
- }
228
32
  export function registerClassifyCommands(program, io) {
229
33
  const classify = program
230
34
  .command('classify')
231
35
  .description('L1a task classification: 5-level heuristic (typo/bug/feature/refactor/migration) + override/upgrade + audit log');
232
- addJsonOption(classify
233
- .command('run')
234
- .description('Classify the current diff (git diff HEAD) into one of 5 task levels')
235
- .requiredOption('--project <path>', 'target project root')
236
- .option('--override <level>', 'force a level (one of typo|bug|feature|refactor|migration); requires --reason')
237
- .option('--reason <text>', 'reason for the override (mandatory when --override is set)')).action(async (options) => {
238
- try {
239
- const prefs = await loadPreferences(options.project);
240
- const signals = getSignalsFromGitDiff(options.project);
241
- let override;
242
- if (options.override !== undefined) {
243
- if (!isTaskLevel(options.override)) {
244
- printResult(io, fail('classify.run', 'INVALID_LEVEL', `level must be one of: ${TASK_LEVELS.join(', ')}`, { provided: options.override }, ['Pass one of typo, bug, feature, refactor, migration']), options.json);
245
- process.exitCode = 1;
246
- return;
247
- }
248
- if (options.reason === undefined || options.reason.length === 0) {
249
- printResult(io, fail('classify.run', 'REASON_REQUIRED', '--reason is required when --override is set', {}, ['Provide a non-empty reason for the override']), options.json);
250
- process.exitCode = 1;
251
- return;
252
- }
253
- override = { level: options.override, reason: options.reason };
254
- }
255
- const result = classifyTask(override !== undefined
256
- ? { signals, conservatism: prefs.classifyConservatism, override }
257
- : { signals, conservatism: prefs.classifyConservatism }, prefs.classifyRules.feature_threshold_files, prefs.classifyRules.feature_threshold_lines);
258
- appendAuditEntry(options.project, result.audit);
259
- printResult(io, ok('classify.run', result, [], [
260
- `gate set for level "${result.level}": ${result.gateSet.stages.join(', ')}`,
261
- `audit log: .peaks/_runtime/${CLASSIFY_AUDIT_FILE}`
262
- ]), options.json);
263
- }
264
- catch (error) {
265
- printResult(io, fail('classify.run', 'CLASSIFY_RUN_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Run peaks classify --help for usage']), options.json);
266
- process.exitCode = 1;
267
- }
268
- });
269
- // Downgrade is REFUSED per spec §4. Surface this as a hard fail.
270
- classify
271
- .command('downgrade')
272
- .description('REFUSED per spec §4 — peaks-loop never downgrades a classification; ask the user to override explicitly')
273
- .requiredOption('--level <level>', 'attempted level')
274
- .requiredOption('--reason <text>', 'reason for the attempt (always rejected)')
275
- .requiredOption('--project <path>', 'target project root')
276
- .option('--json', 'print machine-readable JSON envelope')
277
- .action((options) => {
278
- printResult(io, fail('classify.downgrade', 'DOWNGRADE_REFUSED', 'peaks classify downgrade is refused per spec §4. Use --override (with reason) on `classify run` to force a level; the CLI never downgrades a classification unilaterally.', { attemptedLevel: options.level, reason: options.reason }, ['Use `peaks classify run --override <level> --reason "<text>"` instead']), options.json);
279
- process.exitCode = 2;
280
- });
36
+ registerClassifyRunCommand(classify, io);
37
+ registerClassifyDowngradeCommand(classify, io);
281
38
  }
@@ -5,7 +5,7 @@ import { getAdapter } from '../../services/ide/ide-registry.js';
5
5
  import { evaluateCodeBan } from '../../services/audit/enforcers/code-ban.js';
6
6
  import { isRootWrite } from '../../services/audit/enforcers/no-root-pollution.js';
7
7
  import { checkLoginGate } from '../../services/audit/enforcers/login-gate.js';
8
- import { resolveActiveSkillForCaller } from '../../services/audit/enforcers/active-skill-resolver.js';
8
+ import { hasLeaseForCaller, hasPeaksLeaseInSession, resolveActiveSkillForCaller } from '../../services/audit/enforcers/active-skill-resolver.js';
9
9
  import { fail, ok } from 'peaks-loop-shared/result';
10
10
  import { emitDecision, emitHint } from '../../services/hooks/output.js';
11
11
  /**
@@ -98,26 +98,47 @@ export function registerHookHandleCommand(program, io) {
98
98
  // The envelope shape (skill / callerId / sessionId / source) is
99
99
  // unchanged from 4.0.7; the underlying source is now
100
100
  // `canonical` for the lease + index path.
101
- const activeSkill = resolveActiveSkillForCaller(projectRoot);
102
- if (activeSkill.skill !== null) {
103
- const codeDecision = evaluateCodeBan({
104
- skill: activeSkill.skill,
105
- command: fallbackCommand
106
- });
107
- if (codeDecision.denied) {
108
- const formatted = formatDecisionResponse(ide, 'deny', codeDecision.reason);
109
- emitDecision(io, formatted.stdout);
110
- if (options.json === true) {
111
- emitHint(io, JSON.stringify(ok('hook.handle', {
112
- ide,
113
- tool: hook.toolName,
114
- decision: 'deny',
115
- reason: codeDecision.reason,
116
- enforcer: 'code-ban'
117
- })));
118
- }
119
- return;
101
+ //
102
+ // Scoped to THIS caller: without a callerId the resolver returns
103
+ // whichever lease `readdirSync` yields first, so another window's skill
104
+ // would be applied here. The identity comes from the payload, not the
105
+ // environment — whether the hook subprocess inherits the
106
+ // caller-identifying env is unverified, and the payload already has it.
107
+ const callerId = pluckString(parsed, ['caller_id']) ?? pluckString(parsed, ['session_id']);
108
+ const identityAvailable = typeof callerId === 'string' && callerId.length > 0;
109
+ const callerHasLease = identityAvailable && hasLeaseForCaller(projectRoot, callerId);
110
+ // A scoped resolve answers for THIS caller only when this caller owns a
111
+ // lease. An id with no lease is ambiguous: either a caller with no peaks
112
+ // skill, or an id that is not the lease's key — and the harness does
113
+ // hand over a differing session id (skill-statusline-service.ts:100-103).
114
+ // The two are indistinguishable here, so that case keeps the unscoped
115
+ // answer, which denies, rather than turning a peaks commit into an allow.
116
+ const activeSkill = !identityAvailable
117
+ ? { skill: null, callerId: null, sessionId: null, mode: null, source: 'none' }
118
+ : callerHasLease
119
+ ? resolveActiveSkillForCaller(projectRoot, { callerId })
120
+ : resolveActiveSkillForCaller(projectRoot);
121
+ // Evaluated even when nothing resolved: the old `if (skill !== null)`
122
+ // guard meant an unresolved driver skipped the ban entirely.
123
+ const codeDecision = evaluateCodeBan({
124
+ skill: activeSkill.skill,
125
+ command: fallbackCommand,
126
+ peaksLeasePresent: hasPeaksLeaseInSession(projectRoot),
127
+ identityResolved: callerHasLease
128
+ });
129
+ if (codeDecision.denied) {
130
+ const formatted = formatDecisionResponse(ide, 'deny', codeDecision.reason);
131
+ emitDecision(io, formatted.stdout);
132
+ if (options.json === true) {
133
+ emitHint(io, JSON.stringify(ok('hook.handle', {
134
+ ide,
135
+ tool: hook.toolName,
136
+ decision: 'deny',
137
+ reason: codeDecision.reason,
138
+ enforcer: 'code-ban'
139
+ })));
120
140
  }
141
+ return;
121
142
  }
122
143
  // Lazy import to avoid circular: peaks gate enforce logic
123
144
  const { enforceBashCommand } = await import('../../services/sop/gate-enforce-service.js');