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,142 @@
1
+ import { existsSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { getSessionMeta } from '../../../services/session/session-manager.js';
4
+ import { resolveCanonicalProjectRoot } from '../../../services/config/config-service.js';
5
+ import { findProjectRoot } from '../../../services/config/config-safety.js';
6
+ import { fail, ok } from 'peaks-loop-shared/result';
7
+ import { addJsonOption, printResult } from '../../cli-helpers.js';
8
+ /** Exit codes for a rejected `--caller-id`, by the resolver's own errno. */
9
+ const EXIT_USAGE = 64;
10
+ const EXIT_DATAERR = 65;
11
+ /** The advisory that rides every read off the pre-canonical binding dotfile. */
12
+ const LEGACY_WARNING = 'Read from legacy back-compat path .peaks/.session.json. Run `peaks workspace reconcile --apply` to migrate to the canonical home (.peaks/_runtime/session.json).';
13
+ /** `canonical` = `.peaks/_runtime/session.json`; `legacy` = `.peaks/.session.json`. */
14
+ function bindingSourceOf(projectRoot) {
15
+ return existsSync(join(projectRoot, '.peaks', '_runtime', 'session.json'))
16
+ ? 'canonical'
17
+ : 'legacy';
18
+ }
19
+ function bindingPathOf(projectRoot, source) {
20
+ return source === 'canonical'
21
+ ? join(projectRoot, '.peaks', '_runtime', 'session.json')
22
+ : join(projectRoot, '.peaks', '.session.json');
23
+ }
24
+ /** A `--caller-id` the resolver rejected (D5 → exit 65; EX_USAGE → exit 64). */
25
+ function emitCallerIdInvalid(io, options, error) {
26
+ printResult(io, fail('session.info', 'CALLER_ID_INVALID', error.message, { source: error.source }, [
27
+ `Set --caller-id to a value matching ^[a-zA-Z0-9._-]{1,200}$`,
28
+ 'Or set PEAKS_CALLER_ID env var (or CLAUDE_CODE_SESSION_ID for Claude Code)'
29
+ ]), options.json);
30
+ process.exitCode = error.code === 'EX_USAGE' ? EXIT_USAGE : EXIT_DATAERR;
31
+ }
32
+ /**
33
+ * `--caller-id` together with `--active`: look up the binding this callerId
34
+ * holds, so the envelope carries both the resolved id and its peak session.
35
+ */
36
+ async function emitCallerBinding(io, options, projectRoot, callerId) {
37
+ const { getSessionIdCanonical } = await import('../../../services/session/session-manager.js');
38
+ const { getCallerBinding } = await import('../../../services/session/caller-binding-service.js');
39
+ const callerBinding = getCallerBinding(projectRoot, callerId);
40
+ printResult(io, ok('session.info', {
41
+ active: true,
42
+ sessionId: getSessionIdCanonical(projectRoot),
43
+ callerId,
44
+ callerBindingPeakSessionId: callerBinding?.peakSessionId ?? null,
45
+ source: bindingSourceOf(projectRoot)
46
+ }), options.json);
47
+ }
48
+ /**
49
+ * Resolve `--caller-id` (D1/D5 validation) and report it. An invalid flag
50
+ * throws `CallerIdError`, which is surfaced as `CALLER_ID_INVALID`; anything
51
+ * else propagates.
52
+ */
53
+ async function emitCallerIdPath(io, options, projectRoot, flagValue) {
54
+ const { resolveCallerId, CallerIdError } = await import('../../../services/session/resolve-caller-id.js');
55
+ let callerId;
56
+ try {
57
+ callerId = resolveCallerId({ flagValue });
58
+ }
59
+ catch (error) {
60
+ if (error instanceof CallerIdError) {
61
+ emitCallerIdInvalid(io, options, error);
62
+ return;
63
+ }
64
+ throw error;
65
+ }
66
+ if (options.active === true) {
67
+ await emitCallerBinding(io, options, projectRoot, callerId);
68
+ return;
69
+ }
70
+ printResult(io, ok('session.info', {
71
+ callerId,
72
+ note: '--caller-id resolved; pass --active to also look up the bound peak session'
73
+ }), options.json);
74
+ }
75
+ /**
76
+ * `--active` without `--caller-id`: the SOLE authoritative lookup of the
77
+ * active session id — composes on `getSessionIdCanonical`
78
+ * (canonicalize-on-read) and falls through to `getSessionId`
79
+ * (strict-equality) for callers on the original contract. NEITHER path calls
80
+ * `ensureSession()` — that would side-effect-create a fresh binding on miss,
81
+ * erasing the "no active session" signal sub-agents rely on.
82
+ */
83
+ async function emitActiveBinding(io, options, projectRoot) {
84
+ const { getSessionIdCanonical, getSessionId } = await import('../../../services/session/session-manager.js');
85
+ let activeSid = getSessionIdCanonical(projectRoot);
86
+ if (activeSid === null)
87
+ activeSid = getSessionId(projectRoot);
88
+ if (activeSid === null) {
89
+ printResult(io, fail('session.info', 'NO_ACTIVE_SESSION', 'No session bound. Run `peaks workspace init --project <repo> --json` to bind one.', { projectRoot }, [`peaks workspace init --project ${projectRoot} --json`]), options.json);
90
+ process.exitCode = 1;
91
+ return;
92
+ }
93
+ const source = bindingSourceOf(projectRoot);
94
+ printResult(io, ok('session.info', {
95
+ active: true,
96
+ sessionId: activeSid,
97
+ bindingPath: bindingPathOf(projectRoot, source),
98
+ projectRoot,
99
+ source
100
+ }, source === 'legacy' ? [LEGACY_WARNING] : []), options.json);
101
+ }
102
+ /** Explicit `<sessionId>`: read that session's metadata, or refuse. */
103
+ function emitSessionById(io, sessionId, options, projectRoot) {
104
+ if (sessionId === undefined) {
105
+ printResult(io, fail('session.info', 'SESSION_ID_REQUIRED', 'session.info requires a <sessionId> or --active', {}, ['Pass a <sessionId> argument, or use --active to resolve the canonical binding']), options.json);
106
+ process.exitCode = 1;
107
+ return;
108
+ }
109
+ const meta = getSessionMeta(projectRoot, sessionId);
110
+ if (meta === null) {
111
+ printResult(io, fail('session.info', 'SESSION_NOT_FOUND', `Session "${sessionId}" not found or has no metadata`, { sessionId }, ['Use `peaks session list` to see available sessions']), options.json);
112
+ process.exitCode = 1;
113
+ return;
114
+ }
115
+ printResult(io, ok('session.info', meta), options.json);
116
+ }
117
+ async function runSessionInfo(io, sessionId, options) {
118
+ const projectRoot = options.project !== undefined
119
+ ? resolveCanonicalProjectRoot(options.project)
120
+ : (findProjectRoot(process.cwd()) ?? process.cwd());
121
+ if (options.callerId !== undefined) {
122
+ await emitCallerIdPath(io, options, projectRoot, options.callerId);
123
+ return;
124
+ }
125
+ if (options.active === true) {
126
+ await emitActiveBinding(io, options, projectRoot);
127
+ return;
128
+ }
129
+ emitSessionById(io, sessionId, options, projectRoot);
130
+ }
131
+ export function registerSessionInfoCommand(session, io) {
132
+ addJsonOption(session
133
+ .command('info [sessionId]')
134
+ .description('Show full metadata for a session directory. Pass --active to resolve the canonical binding from .peaks/_runtime/session.json (the "one command a sub-agent runs to find the parent\'s sid" primitive). Slice 021: --active is the SOLE authoritative way to look up the active session id; the on-disk file path is internal and must NOT be `cat`-ed directly.')
135
+ .option('--active', 'resolve the canonical session id from .peaks/_runtime/session.json (ignores [sessionId] when set)')
136
+ .option('--project <path>', 'target project root (defaults to git root or cwd). Slice 021: lets sub-agents skip the cwd heuristic and look up the binding for a specific repo.')
137
+ // overrides the per-process PEAKS_CALLER_ID env var and the
138
+ // PLATFORM_FALLBACKS table (D4 priority). The resolved callerId is
139
+ // surfaced in the JSON envelope so callers can confirm what was
140
+ // resolved without re-deriving it.
141
+ .option('--caller-id <id>', 'Override the caller id for this invocation (D4 priority: flag beats env beats platform fallback). When set, the response envelope includes the resolved callerId.')).action((sessionId, options) => runSessionInfo(io, sessionId, options));
142
+ }
@@ -0,0 +1,5 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../../cli-helpers.js';
3
+ export declare function registerSessionListCommand(session: Command, io: ProgramIO): void;
4
+ export declare function registerSessionTitleCommand(session: Command, io: ProgramIO): void;
5
+ export declare function registerSessionRotateCommand(session: Command, io: ProgramIO): void;
@@ -0,0 +1,58 @@
1
+ import { listSessionMetas, rotateSessionBinding, setSessionTitle } from '../../../services/session/session-manager.js';
2
+ import { resolveCanonicalProjectRoot } from '../../../services/config/config-service.js';
3
+ import { findProjectRoot } from '../../../services/config/config-safety.js';
4
+ import { fail, ok } from 'peaks-loop-shared/result';
5
+ import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
6
+ export function registerSessionListCommand(session, io) {
7
+ addJsonOption(session.command('list').description('List all session directories with titles and metadata')).action((options) => {
8
+ const projectRoot = findProjectRoot(process.cwd()) ?? process.cwd();
9
+ const metas = listSessionMetas(projectRoot);
10
+ printResult(io, ok('session.list', { sessions: metas, total: metas.length }), options.json);
11
+ });
12
+ }
13
+ export function registerSessionTitleCommand(session, io) {
14
+ addJsonOption(session
15
+ .command('title <sessionId> <title>')
16
+ .description('Set a human-readable title for a session directory')).action((sessionId, title, options) => {
17
+ const projectRoot = findProjectRoot(process.cwd()) ?? process.cwd();
18
+ try {
19
+ const meta = setSessionTitle(projectRoot, sessionId, title);
20
+ printResult(io, ok('session.title', meta), options.json);
21
+ }
22
+ catch (error) {
23
+ printResult(io, fail('session.title', 'SESSION_TITLE_FAILED', getErrorMessage(error), { sessionId }, [
24
+ 'Verify the sessionId exists under .peaks/'
25
+ ]), options.json);
26
+ process.exitCode = 1;
27
+ }
28
+ });
29
+ }
30
+ export function registerSessionRotateCommand(session, io) {
31
+ addJsonOption(session
32
+ .command('rotate')
33
+ .description('Drop the project-level session binding so the next peaks call auto-generates a fresh session id. The on-disk session directory is left intact — only .peaks/.session.json is removed.')
34
+ .option('--project <path>', 'target project root (defaults to git root or cwd)')
35
+ .option('--reason <text>', 'human-readable reason for the rotation, recorded in the response data')).action((options) => {
36
+ try {
37
+ // Canonicalise the project root before touching the binding: `peaks
38
+ // workspace init` writes it realpath-resolved, and readSessionFile's
39
+ // strict projectRoot equality check would otherwise miss a path that
40
+ // came through a symlink (notably /tmp on macOS).
41
+ const projectRoot = options.project !== undefined
42
+ ? options.project
43
+ : (findProjectRoot(process.cwd()) ?? process.cwd());
44
+ const previousSessionId = rotateSessionBinding(resolveCanonicalProjectRoot(projectRoot));
45
+ printResult(io, ok('session.rotate', {
46
+ previousSessionId,
47
+ ...(options.reason !== undefined ? { reason: options.reason } : {}),
48
+ note: previousSessionId === null
49
+ ? 'No prior binding was present; the project is already unbound.'
50
+ : 'Next ensureSession() call will auto-generate a fresh id. The previous session directory is still on disk at .peaks/_runtime/<previousSessionId>/.'
51
+ }), options.json);
52
+ }
53
+ catch (error) {
54
+ printResult(io, fail('session.rotate', 'SESSION_ROTATE_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Verify the project path exists and is writable']), options.json);
55
+ process.exitCode = 1;
56
+ }
57
+ });
58
+ }
@@ -1,27 +1,4 @@
1
1
  import type { Command } from 'commander';
2
2
  import { type ProgramIO } from '../../cli-helpers.js';
3
- /** The only `--category` this subcommand implements today. */
4
- export declare const LOOP_ENGINEERING_CATEGORY = "loop-engineering";
5
- /** Project-relative location of the file the `loop-engineering` lint reads. */
6
- export declare const LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH = ".peaks/standards/loop-engineering-guidelines.md";
7
- export interface StandardsLintEnvelope {
8
- ok: boolean;
9
- code: string;
10
- message: string;
11
- data: {
12
- category: string;
13
- path: string;
14
- redLineCount: number;
15
- redLineIds: string[];
16
- findings: string[];
17
- };
18
- nextActions: string[];
19
- }
20
- /**
21
- * Pure helper: read the loop-engineering guideline file under `projectRoot`
22
- * and lint it. Kept out of the Commander action so unit tests can drive it
23
- * without spawning a child process (same shape as
24
- * `runReadinessLint` in skill-loop-engineering-readiness-commands.ts).
25
- */
26
- export declare function runLoopEngineeringLint(projectRoot: string): StandardsLintEnvelope;
3
+ export { LOOP_ENGINEERING_CATEGORY, LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH, runLoopEngineeringLint, type StandardsLintEnvelope } from './standards-lint.js';
27
4
  export declare function registerStandardsCommand(program: Command, io: ProgramIO): void;
@@ -1,211 +1,43 @@
1
- import { existsSync, readFileSync } from 'node:fs';
2
- import { join, resolve } from 'node:path';
3
- import { summarizeProjectStandardsInitResult, summarizeProjectStandardsUpdateResult } from '../../../services/standards/project-standards-service.js';
4
- import { executeProjectStandardsInitIdeAware, executeProjectStandardsUpdateIdeAware } from '../../../services/standards/ide-aware-standards-service.js';
5
- import { migrateStandards } from '../../../services/standards/migrate-service.js';
6
- import { migrateClaudeRules } from '../../../services/standards/migrate-claude-rules-service.js';
7
- import { lintLoopEngineeringGuidelines, EXPECTED_RED_LINE_IDS } from '../../../services/standards/loop-engineering-lint.js';
8
1
  import { fail, ok } from 'peaks-loop-shared/result';
9
2
  import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
10
- /** The only `--category` this subcommand implements today. */
11
- export const LOOP_ENGINEERING_CATEGORY = 'loop-engineering';
12
- /** Project-relative location of the file the `loop-engineering` lint reads. */
13
- export const LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH = '.peaks/standards/loop-engineering-guidelines.md';
14
- /**
15
- * Pure helper: read the loop-engineering guideline file under `projectRoot`
16
- * and lint it. Kept out of the Commander action so unit tests can drive it
17
- * without spawning a child process (same shape as
18
- * `runReadinessLint` in skill-loop-engineering-readiness-commands.ts).
19
- */
20
- export function runLoopEngineeringLint(projectRoot) {
21
- const root = resolve(projectRoot);
22
- const guidelinePath = join(root, LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH);
23
- const data = {
24
- category: LOOP_ENGINEERING_CATEGORY,
25
- path: guidelinePath,
26
- redLineCount: 0,
27
- redLineIds: [],
28
- findings: []
29
- };
30
- if (!existsSync(guidelinePath)) {
31
- return {
32
- ok: false,
33
- code: 'LINT_FILE_NOT_FOUND',
34
- message: `no ${LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH} under ${root}`,
35
- data,
36
- nextActions: [
37
- `Pass --project pointing at a peaks-loop checkout (the lint reads its own guideline file).`
38
- ]
39
- };
3
+ import { registerStandardsInitCommands } from './standards-init-command.js';
4
+ import { LOOP_ENGINEERING_CATEGORY, runLoopEngineeringLint } from './standards-lint.js';
5
+ import { registerStandardsMigrateCommand } from './standards-migrate-command.js';
6
+ export { LOOP_ENGINEERING_CATEGORY, LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH, runLoopEngineeringLint } from './standards-lint.js';
7
+ /** `standards lint` prints the pure lint result as a CLI envelope. */
8
+ function runStandardsLint(io, options) {
9
+ if (options.category !== LOOP_ENGINEERING_CATEGORY) {
10
+ printResult(io, fail('standards.lint', 'UNKNOWN_LINT_CATEGORY', `only --category ${LOOP_ENGINEERING_CATEGORY} is implemented`, { category: options.category }, [`Pass --category ${LOOP_ENGINEERING_CATEGORY}.`]), options.json);
11
+ process.exitCode = 1;
12
+ return;
40
13
  }
41
- const result = lintLoopEngineeringGuidelines(readFileSync(guidelinePath, 'utf-8'));
42
- const redLineIds = result.redLines.map((rl) => rl.id);
43
- const fullData = { ...data, redLineCount: redLineIds.length, redLineIds };
44
- if (result.ok) {
45
- return {
46
- ok: true,
47
- code: 'STANDARDS_LINT_OK',
48
- message: `${redLineIds.length} red line(s) present with all 4 sections (expected: ${EXPECTED_RED_LINE_IDS.join(', ')})`,
49
- data: fullData,
50
- nextActions: ['Any new red line must use the 4-section form or this lint will reject it.']
51
- };
52
- }
53
- return {
54
- ok: false,
55
- code: 'STANDARDS_LINT_FAILED',
56
- message: `guideline file failed the lint (${result.findings.length} finding(s))`,
57
- data: { ...fullData, findings: result.findings },
58
- nextActions: [
59
- 'Address every finding in data.findings, then re-run the lint.',
60
- 'Each red line must be a `## RL-N — <title>` heading with the 4 sections: Failure modes / Rewrite / Self-check / Out-of-scope.'
61
- ]
62
- };
63
- }
64
- export function registerStandardsCommand(program, io) {
65
- const standards = program
66
- .command('standards')
67
- .description('Manage project-local coding standards');
68
- addJsonOption(standards
69
- .command('init')
70
- .description('Initialize project-local coding standards for Peaks skill preflight')
71
- .requiredOption('--project <path>', 'target project root')
72
- .option('--language <language>', 'standards language pack')
73
- .option('--ide <id>', 'override IDE detection (e.g. claude-code, trae)')
74
- .option('--dry-run', 'preview writes without changing files')
75
- .option('--apply', 'write missing standards into the target project')).action((options) => {
76
- if (options.dryRun === true && options.apply === true) {
77
- printResult(io, fail('standards.init', 'INVALID_STANDARDS_INIT_FLAGS', 'Use either --dry-run or --apply, not both', {}, ['Run without --apply to preview writes, or omit --dry-run when applying standards']), options.json);
78
- process.exitCode = 1;
79
- return;
80
- }
81
- try {
82
- const result = executeProjectStandardsInitIdeAware({
83
- projectRoot: options.project,
84
- ...(options.language !== undefined ? { language: options.language } : {}),
85
- ...(options.ide !== undefined
86
- ? {
87
- ideId: options.ide
88
- }
89
- : {}),
90
- apply: options.apply === true
91
- });
92
- printResult(io, ok('standards.init', summarizeProjectStandardsInitResult(result)), options.json);
93
- }
94
- catch (error) {
95
- printResult(io, fail('standards.init', 'STANDARDS_INIT_FAILED', getErrorMessage(error), {}, [
96
- 'Check the project path and existing .claude/rules directory before retrying'
97
- ]), options.json);
98
- process.exitCode = 1;
99
- }
100
- });
101
- addJsonOption(standards
102
- .command('update')
103
- .description('Append managed standards metadata to an existing CLAUDE.md without rewriting the body')
104
- .requiredOption('--project <path>', 'target project root')
105
- .option('--language <language>', 'standards language pack')
106
- .option('--ide <id>', 'override IDE detection (e.g. claude-code, trae)')
107
- .option('--dry-run', 'preview writes without changing files')
108
- .option('--apply', 'append managed metadata to the target project')).action((options) => {
109
- if (options.dryRun === true && options.apply === true) {
110
- printResult(io, fail('standards.update', 'INVALID_STANDARDS_UPDATE_FLAGS', 'Use either --dry-run or --apply, not both', {}, [
111
- 'Run without --apply to preview writes, or omit --dry-run when applying standards updates'
112
- ]), options.json);
113
- process.exitCode = 1;
114
- return;
115
- }
116
- try {
117
- const result = executeProjectStandardsUpdateIdeAware({
118
- projectRoot: options.project,
119
- ...(options.language !== undefined ? { language: options.language } : {}),
120
- ...(options.ide !== undefined
121
- ? {
122
- ideId: options.ide
123
- }
124
- : {}),
125
- apply: options.apply === true
126
- });
127
- const summary = summarizeProjectStandardsUpdateResult(result);
128
- const response = summary.reviewSuggestions.length > 0
129
- ? fail('standards.update', 'STANDARDS_UPDATE_REVIEW_REQUIRED', 'Standards update requires manual review', summary, summary.reviewSuggestions)
130
- : ok('standards.update', summary);
131
- printResult(io, response, options.json);
132
- if (summary.reviewSuggestions.length > 0) {
133
- process.exitCode = 1;
134
- }
135
- }
136
- catch (error) {
137
- printResult(io, fail('standards.update', 'STANDARDS_UPDATE_FAILED', getErrorMessage(error), {}, [
138
- 'Check the project path, CLAUDE.md contents, and existing .claude/rules directory before retrying'
139
- ]), options.json);
140
- process.exitCode = 1;
141
- }
142
- });
143
- addJsonOption(standards
144
- .command('migrate')
145
- .description('Rewrite a consumer project CLAUDE.md to drop the legacy heartbeat block (slice 028). Dry-run by default; pass --apply to write. With --from-claude-rules, thins the 1.x .claude/rules/ tree to 2-line pointers and scaffolds .peaks/standards/ (slice 2026-06-12-standards-migrate-claude-rules).')
146
- .option('--project <path>', 'target project root')
147
- .option('--apply', 'rewrite the legacy block in place; default is dry-run')
148
- .option('--from-claude-rules', 'thin .claude/rules/ to pointers and scaffold .peaks/standards/')).action((options) => {
149
- const projectRoot = options.project ?? process.cwd();
150
- if (options.fromClaudeRules === true) {
151
- try {
152
- const result = migrateClaudeRules({ projectRoot, apply: options.apply === true });
153
- printResult(io, ok('standards.migrate', result.data, [], [...result.data.nextActions]), options.json);
154
- }
155
- catch (error) {
156
- printResult(io, fail('standards.migrate', 'STANDARDS_MIGRATE_FAILED', getErrorMessage(error), {
157
- backupPath: null,
158
- thinnedFiles: [],
159
- scaffoldedFiles: [],
160
- preservedFiles: [],
161
- wouldChange: false,
162
- applied: false,
163
- nextActions: []
164
- }, [getErrorMessage(error)]), options.json);
165
- process.exitCode = 1;
166
- }
167
- return;
168
- }
169
- try {
170
- const result = migrateStandards({ project: projectRoot, apply: options.apply === true });
171
- printResult(io, ok('standards.migrate', result.data, [], result.data.nextActions), options.json);
172
- }
173
- catch (error) {
174
- printResult(io, fail('standards.migrate', 'STANDARDS_MIGRATE_FAILED', getErrorMessage(error), {
175
- file: null,
176
- foundOldBlock: false,
177
- wouldChange: false,
178
- applied: false,
179
- before: null,
180
- after: null,
181
- nextActions: []
182
- }, [getErrorMessage(error)]), options.json);
14
+ try {
15
+ const envelope = runLoopEngineeringLint(options.project ?? process.cwd());
16
+ const response = envelope.ok
17
+ ? ok('standards.lint', envelope.data, [], envelope.nextActions)
18
+ : fail('standards.lint', envelope.code, envelope.message, envelope.data, envelope.nextActions);
19
+ printResult(io, response, options.json);
20
+ if (!envelope.ok) {
183
21
  process.exitCode = 1;
184
22
  }
185
- });
23
+ }
24
+ catch (error) {
25
+ printResult(io, fail('standards.lint', 'STANDARDS_LINT_ERROR', getErrorMessage(error), { category: options.category }, ['Verify the guideline file is readable.']), options.json);
26
+ process.exitCode = 1;
27
+ }
28
+ }
29
+ function registerStandardsLintCommand(standards, io) {
186
30
  addJsonOption(standards
187
31
  .command('lint')
188
32
  .description('Lint a guideline file for structural completeness (the loop-engineering red lines)')
189
33
  .requiredOption('--category <category>', `guideline category to lint (${LOOP_ENGINEERING_CATEGORY})`)
190
- .option('--project <path>', 'project root holding .peaks/standards/ (default: cwd)')).action((options) => {
191
- if (options.category !== LOOP_ENGINEERING_CATEGORY) {
192
- printResult(io, fail('standards.lint', 'UNKNOWN_LINT_CATEGORY', `only --category ${LOOP_ENGINEERING_CATEGORY} is implemented`, { category: options.category }, [`Pass --category ${LOOP_ENGINEERING_CATEGORY}.`]), options.json);
193
- process.exitCode = 1;
194
- return;
195
- }
196
- try {
197
- const envelope = runLoopEngineeringLint(options.project ?? process.cwd());
198
- const response = envelope.ok
199
- ? ok('standards.lint', envelope.data, [], envelope.nextActions)
200
- : fail('standards.lint', envelope.code, envelope.message, envelope.data, envelope.nextActions);
201
- printResult(io, response, options.json);
202
- if (!envelope.ok) {
203
- process.exitCode = 1;
204
- }
205
- }
206
- catch (error) {
207
- printResult(io, fail('standards.lint', 'STANDARDS_LINT_ERROR', getErrorMessage(error), { category: options.category }, ['Verify the guideline file is readable.']), options.json);
208
- process.exitCode = 1;
209
- }
210
- });
34
+ .option('--project <path>', 'project root holding .peaks/standards/ (default: cwd)')).action((options) => runStandardsLint(io, options));
35
+ }
36
+ export function registerStandardsCommand(program, io) {
37
+ const standards = program
38
+ .command('standards')
39
+ .description('Manage project-local coding standards');
40
+ registerStandardsInitCommands(standards, io);
41
+ registerStandardsMigrateCommand(standards, io);
42
+ registerStandardsLintCommand(standards, io);
211
43
  }
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../../cli-helpers.js';
3
+ export declare function registerStandardsInitCommands(standards: Command, io: ProgramIO): void;
@@ -0,0 +1,87 @@
1
+ import { summarizeProjectStandardsInitResult, summarizeProjectStandardsUpdateResult } from '../../../services/standards/project-standards-service.js';
2
+ import { executeProjectStandardsInitIdeAware, executeProjectStandardsUpdateIdeAware } from '../../../services/standards/ide-aware-standards-service.js';
3
+ import { fail, ok } from 'peaks-loop-shared/result';
4
+ import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
5
+ /** The five flags `init` and `update` share, in registration order. */
6
+ function withWriteFlags(cmd, applyHelp) {
7
+ return cmd
8
+ .requiredOption('--project <path>', 'target project root')
9
+ .option('--language <language>', 'standards language pack')
10
+ .option('--ide <id>', 'override IDE detection (e.g. claude-code, trae)')
11
+ .option('--dry-run', 'preview writes without changing files')
12
+ .option('--apply', applyHelp);
13
+ }
14
+ /** The ide-aware request both verbs build from the same flag set. */
15
+ function buildIdeAwareRequest(options) {
16
+ return {
17
+ projectRoot: options.project,
18
+ ...(options.language !== undefined ? { language: options.language } : {}),
19
+ ...(options.ide !== undefined ? { ideId: options.ide } : {}),
20
+ apply: options.apply === true
21
+ };
22
+ }
23
+ /** `--dry-run --apply` together is ambiguous; refuse before doing any work. */
24
+ function refuseConflictingFlags(io, options, refusal) {
25
+ if (!(options.dryRun === true && options.apply === true))
26
+ return false;
27
+ printResult(io, fail(refusal.command, refusal.code, 'Use either --dry-run or --apply, not both', {}, refusal.nextActions), options.json);
28
+ process.exitCode = 1;
29
+ return true;
30
+ }
31
+ function runStandardsInit(io, options) {
32
+ const refused = refuseConflictingFlags(io, options, {
33
+ command: 'standards.init',
34
+ code: 'INVALID_STANDARDS_INIT_FLAGS',
35
+ nextActions: [
36
+ 'Run without --apply to preview writes, or omit --dry-run when applying standards'
37
+ ]
38
+ });
39
+ if (refused)
40
+ return;
41
+ try {
42
+ const result = executeProjectStandardsInitIdeAware(buildIdeAwareRequest(options));
43
+ printResult(io, ok('standards.init', summarizeProjectStandardsInitResult(result)), options.json);
44
+ }
45
+ catch (error) {
46
+ printResult(io, fail('standards.init', 'STANDARDS_INIT_FAILED', getErrorMessage(error), {}, [
47
+ 'Check the project path and existing .claude/rules directory before retrying'
48
+ ]), options.json);
49
+ process.exitCode = 1;
50
+ }
51
+ }
52
+ function runStandardsUpdate(io, options) {
53
+ const refused = refuseConflictingFlags(io, options, {
54
+ command: 'standards.update',
55
+ code: 'INVALID_STANDARDS_UPDATE_FLAGS',
56
+ nextActions: [
57
+ 'Run without --apply to preview writes, or omit --dry-run when applying standards updates'
58
+ ]
59
+ });
60
+ if (refused)
61
+ return;
62
+ try {
63
+ const result = executeProjectStandardsUpdateIdeAware(buildIdeAwareRequest(options));
64
+ const summary = summarizeProjectStandardsUpdateResult(result);
65
+ const response = summary.reviewSuggestions.length > 0
66
+ ? fail('standards.update', 'STANDARDS_UPDATE_REVIEW_REQUIRED', 'Standards update requires manual review', summary, summary.reviewSuggestions)
67
+ : ok('standards.update', summary);
68
+ printResult(io, response, options.json);
69
+ if (summary.reviewSuggestions.length > 0) {
70
+ process.exitCode = 1;
71
+ }
72
+ }
73
+ catch (error) {
74
+ printResult(io, fail('standards.update', 'STANDARDS_UPDATE_FAILED', getErrorMessage(error), {}, [
75
+ 'Check the project path, CLAUDE.md contents, and existing .claude/rules directory before retrying'
76
+ ]), options.json);
77
+ process.exitCode = 1;
78
+ }
79
+ }
80
+ export function registerStandardsInitCommands(standards, io) {
81
+ addJsonOption(withWriteFlags(standards
82
+ .command('init')
83
+ .description('Initialize project-local coding standards for Peaks skill preflight'), 'write missing standards into the target project')).action((options) => runStandardsInit(io, options));
84
+ addJsonOption(withWriteFlags(standards
85
+ .command('update')
86
+ .description('Append managed standards metadata to an existing CLAUDE.md without rewriting the body'), 'append managed metadata to the target project')).action((options) => runStandardsUpdate(io, options));
87
+ }
@@ -0,0 +1,24 @@
1
+ /** The only `--category` this subcommand implements today. */
2
+ export declare const LOOP_ENGINEERING_CATEGORY = "loop-engineering";
3
+ /** Project-relative location of the file the `loop-engineering` lint reads. */
4
+ export declare const LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH = ".peaks/standards/loop-engineering-guidelines.md";
5
+ export interface StandardsLintEnvelope {
6
+ ok: boolean;
7
+ code: string;
8
+ message: string;
9
+ data: {
10
+ category: string;
11
+ path: string;
12
+ redLineCount: number;
13
+ redLineIds: string[];
14
+ findings: string[];
15
+ };
16
+ nextActions: string[];
17
+ }
18
+ /**
19
+ * Pure helper: read the loop-engineering guideline file under `projectRoot`
20
+ * and lint it. Kept out of the Commander action so unit tests can drive it
21
+ * without spawning a child process (same shape as
22
+ * `runReadinessLint` in skill-loop-engineering-readiness-commands.ts).
23
+ */
24
+ export declare function runLoopEngineeringLint(projectRoot: string): StandardsLintEnvelope;