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,178 @@
1
+ import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
2
+ import { fail } from 'peaks-loop-shared/result';
3
+ import { VALID_PROJECT_MEMORY_KINDS } from '../../../services/memory/project-memory-service.js';
4
+ import { emitBootstrapFailure } from './memory-command-shared.js';
5
+ /** Derived from the canonical kind vocabulary — never hand-maintain a list here. */
6
+ const KIND_HELP = VALID_PROJECT_MEMORY_KINDS.join(', ');
7
+ /**
8
+ * Call a run function from the lazily imported `memory-commands.js`.
9
+ *
10
+ * The dynamic import avoids a top-of-file import cycle (memory-commands.ts
11
+ * imports services the rest of this family also touches).
12
+ */
13
+ function delegateMemoryRun(args) {
14
+ void import('../memory-commands.js')
15
+ .then((mod) => {
16
+ void args.build(mod)(args.io, args.options);
17
+ })
18
+ .catch((error) => {
19
+ emitBootstrapFailure(args.io, {
20
+ command: args.spec.command,
21
+ code: args.spec.code,
22
+ message: getErrorMessage(error),
23
+ json: args.spec.json,
24
+ nextActions: args.spec.nextActions
25
+ });
26
+ });
27
+ }
28
+ /** The bootstrap hint `memory list --pick` gives when fzf is missing or old. */
29
+ const FZF_UNAVAILABLE = /brew install fzf|apt-get install fzf|older than required/;
30
+ const FZF_MESSAGE = 'fzf binary not found or too old. Install with: brew install fzf (or apt: apt-get install fzf). peaks memory list --pick requires fzf >= 0.38.';
31
+ /**
32
+ * `--pick` needs a real fzf, so a missing binary is its own refusal with its
33
+ * own exit code (127, the shell's "command not found") rather than a generic
34
+ * bootstrap failure.
35
+ */
36
+ function listBootstrapFailure(io, options, error) {
37
+ const msg = FZF_UNAVAILABLE.test(getErrorMessage(error)) ? FZF_MESSAGE : getErrorMessage(error);
38
+ const code = FZF_UNAVAILABLE.test(msg) ? 'FZF_UNAVAILABLE' : 'MEMORY_LIST_BOOTSTRAP_FAILED';
39
+ printResult(io, fail('memory.list', code, msg, {}, [
40
+ 'Install fzf or run without --pick to list entries as JSON'
41
+ ]), options.json);
42
+ if (code === 'FZF_UNAVAILABLE')
43
+ process.exitCode = 127;
44
+ else
45
+ process.exitCode = 1;
46
+ }
47
+ function registerMemoryList(memory, io) {
48
+ addJsonOption(memory
49
+ .command('list')
50
+ .description('List all memory entries from .peaks/memory/index.json. Pass --pick to spawn fzf for interactive multi-select; the picked subset is written to .peaks/memory/picked.json.')
51
+ .option('--kind <kind>', `filter by memory kind (one of: ${KIND_HELP})`)
52
+ .option('--pick', 'spawn fzf for interactive multi-select (requires fzf >= 0.38); writes picked.json')
53
+ .option('--fzf-bin <path>', 'override fzf binary path (default: fzf on PATH)', 'fzf')
54
+ .option('--summary', 'emit counts + names-of-first-N only (≤ 2 KB) instead of the full entry array; the default envelope is unchanged')
55
+ .option('--project <path>', 'target project root (defaults to git root or cwd)')).action((options) => {
56
+ void import('../memory-commands.js')
57
+ .then(({ runMemoryList }) => {
58
+ void runMemoryList(io, {
59
+ ...(options.kind !== undefined ? { kind: options.kind } : {}),
60
+ ...(options.pick === true ? { pick: true } : {}),
61
+ ...(options.fzfBin ? { fzfBin: options.fzfBin } : {}),
62
+ ...(options.project !== undefined ? { project: options.project } : {}),
63
+ ...(options.summary === true ? { summary: true } : {}),
64
+ ...(options.json !== undefined ? { json: options.json } : {})
65
+ });
66
+ })
67
+ .catch((error) => listBootstrapFailure(io, options, error));
68
+ });
69
+ }
70
+ function registerMemoryReindex(memory, io) {
71
+ addJsonOption(memory
72
+ .command('reindex')
73
+ .description('Rebuild .peaks/memory/index.json from every memory file on disk and regenerate MEMORY.md; reports unclassified files and orphans both ways. Dry-run by default; pass --apply to write.')
74
+ .option('--project <path>', 'target project root (defaults to git root or cwd)')
75
+ .option('--dry-run', 'report drift without writing (default)')
76
+ .option('--apply', 'rebuild index.json and regenerate MEMORY.md')
77
+ .option('--summary', 'emit drift counts + names-of-first-N only (≤ 2 KB) instead of the full arrays; the default envelope is unchanged')).action((options) => {
78
+ delegateMemoryRun({
79
+ io,
80
+ spec: {
81
+ command: 'memory.reindex',
82
+ code: 'MEMORY_REINDEX_BOOTSTRAP_FAILED',
83
+ json: options.json
84
+ },
85
+ options: {
86
+ ...(options.project !== undefined ? { project: options.project } : {}),
87
+ ...(options.dryRun === true ? { dryRun: true } : {}),
88
+ ...(options.apply === true ? { apply: true } : {}),
89
+ ...(options.summary === true ? { summary: true } : {}),
90
+ ...(options.json !== undefined ? { json: options.json } : {})
91
+ },
92
+ build: (mod) => mod.runMemoryReindex
93
+ });
94
+ });
95
+ }
96
+ function registerMemoryIngest(memory, io) {
97
+ addJsonOption(memory
98
+ .command('ingest')
99
+ .description('Import memories written by the IDE-side agent (~/.claude/projects/<hash>/memory/*.md) into the peaks-owned .peaks/memory store. The IDE-side dir is read-only. Dry-run by default; pass --apply to write.')
100
+ .option('--project <path>', 'target project root (defaults to git root or cwd)')
101
+ .option('--source-dir <path>', 'override the IDE-side memory directory')
102
+ .option('--dry-run', 'preview imports without writing (default)')
103
+ .option('--apply', 'write normalized memories into .peaks/memory')).action((options) => {
104
+ delegateMemoryRun({
105
+ io,
106
+ spec: {
107
+ command: 'memory.ingest',
108
+ code: 'MEMORY_INGEST_BOOTSTRAP_FAILED',
109
+ json: options.json
110
+ },
111
+ options: {
112
+ ...(options.project !== undefined ? { project: options.project } : {}),
113
+ ...(options.sourceDir !== undefined ? { sourceDir: options.sourceDir } : {}),
114
+ ...(options.dryRun === true ? { dryRun: true } : {}),
115
+ ...(options.apply === true ? { apply: true } : {}),
116
+ ...(options.json !== undefined ? { json: options.json } : {})
117
+ },
118
+ build: (mod) => mod.runMemoryIngest
119
+ });
120
+ });
121
+ }
122
+ function registerMemoryRotate(memory, io) {
123
+ addJsonOption(memory
124
+ .command('rotate')
125
+ .description('Tier-driven retention for .peaks/memory/ (sediment pruning policy, tier 1: archive only, never delete). Tier assignment: explicit `metadata.tier: A|B|C|D` wins; else files under archived/ are D, files pinned in MEMORY.md are B, kinds rule/convention/project-rule are A, kinds decision/reference/feedback/module/bug/investigation/technical-pattern are B, everything else is C. Tier C older than 6 months (frontmatter updatedAt/updated/modified, else file mtime) and not pinned is archived; tier D is reported as a delete-candidate only. Tier A/B are never selected, every candidate must pass a reference grep against src/ + skills/, and --apply refuses an empty plan or a failed gate. Dry-run by default.')
126
+ .option('--project <path>', 'target project root (defaults to git root or cwd)')
127
+ .option('--dry-run', 'report the rotation plan without moving anything (default)')
128
+ .option('--apply', 'move tier-C candidates into .peaks/memory/archived/')).action((options) => {
129
+ delegateMemoryRun({
130
+ io,
131
+ spec: {
132
+ command: 'memory.rotate',
133
+ code: 'MEMORY_ROTATE_BOOTSTRAP_FAILED',
134
+ json: options.json
135
+ },
136
+ options: {
137
+ ...(options.project !== undefined ? { project: options.project } : {}),
138
+ ...(options.dryRun === true ? { dryRun: true } : {}),
139
+ ...(options.apply === true ? { apply: true } : {}),
140
+ ...(options.json !== undefined ? { json: options.json } : {})
141
+ },
142
+ build: (mod) => mod.runMemoryRotate
143
+ });
144
+ });
145
+ }
146
+ function registerMemorySearch(memory, io) {
147
+ addJsonOption(memory
148
+ .command('search <query>')
149
+ .description('Fuzzy-search the memory index (deterministic, local, zero-token). Default --limit 6.')
150
+ .option('--kind <kind>', `filter by memory kind (one of: ${KIND_HELP})`)
151
+ .option('--limit <n>', 'maximum number of matches to return', (value) => Number(value))
152
+ .option('--project <path>', 'target project root (defaults to git root or cwd)')).action((query, options) => {
153
+ delegateMemoryRun({
154
+ io,
155
+ spec: {
156
+ command: 'memory.search',
157
+ code: 'MEMORY_SEARCH_BOOTSTRAP_FAILED',
158
+ json: options.json
159
+ },
160
+ options: {
161
+ query,
162
+ ...(options.kind !== undefined ? { kind: options.kind } : {}),
163
+ ...(options.limit !== undefined ? { limit: options.limit } : {}),
164
+ ...(options.project !== undefined ? { project: options.project } : {}),
165
+ ...(options.json !== undefined ? { json: options.json } : {})
166
+ },
167
+ build: (mod) => mod.runMemorySearch
168
+ });
169
+ });
170
+ }
171
+ /** The five verbs whose bodies live in `memory-commands.ts`, in shipping order. */
172
+ export function registerMemoryDelegatedVerbs(memory, io) {
173
+ registerMemoryList(memory, io);
174
+ registerMemoryReindex(memory, io);
175
+ registerMemoryIngest(memory, io);
176
+ registerMemoryRotate(memory, io);
177
+ registerMemorySearch(memory, io);
178
+ }
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../../cli-helpers.js';
3
+ export declare function registerMemoryExtractCommand(memory: Command, io: ProgramIO): void;
@@ -0,0 +1,95 @@
1
+ import { describeMemoryBlockDrops, describeMemoryWriteSkips, executeProjectMemoryExtract, SENSITIVE_MEMORY_CHECKS, summarizeProjectMemoryExtractResult, UnsafeMemoryError } from '../../../services/memory/project-memory-service.js';
2
+ import { fail, ok } from 'peaks-loop-shared/result';
3
+ import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
4
+ import { refuseBothFlags } from './memory-command-shared.js';
5
+ /**
6
+ * The remedy for a failed `memory extract`, chosen by the check that refused
7
+ * the write — the same `SENSITIVE_MEMORY_CHECKS` values the refusal message
8
+ * and envelope data are built from, so the message, the data and the advice
9
+ * cannot drift apart.
10
+ *
11
+ * WHY IT IS NOT ONE STATIC STRING. Every failure used to get "Check artifact
12
+ * paths and remove secrets before extracting memory" — including a refusal
13
+ * raised only because a memory TITLE contained a word like `authority`
14
+ * (slice C0). There was no secret anywhere in that memory, so the one thing
15
+ * the hint told the user to do was the one thing that could not help: it sent
16
+ * check that actually failed.
17
+ *
18
+ * `null` (a failure that is not a safety refusal — a path escape, a missing
19
+ * artifact) keeps the pre-C0 hint, which is about paths and secrets rather
20
+ * than about a check.
21
+ */
22
+ function memoryExtractNextActions(refusal) {
23
+ if (refusal === null) {
24
+ return ['Check artifact paths and remove secrets before extracting memory'];
25
+ }
26
+ if (refusal.check === SENSITIVE_MEMORY_CHECKS.title) {
27
+ return [
28
+ 'Retitle the memory so it is not named after a credential term, then re-run memory extract'
29
+ ];
30
+ }
31
+ if (refusal.check === SENSITIVE_MEMORY_CHECKS.content) {
32
+ // Name the rule, not just the family. `matchedTerm` is a closed id
33
+ // (`credential-assignment`, `bearer-value`, `pem-private-key`, …), so the
34
+ // reader can tell a credential in the text from a sentence that merely has
35
+ // the shape of one — which is the difference between removing a value and
36
+ // rewording prose.
37
+ return [
38
+ `Remove the credential value the "${refusal.matchedTerm}" pattern matched, then re-run memory extract`
39
+ ];
40
+ }
41
+ return ['Remove the credential value from the memory content, then re-run memory extract'];
42
+ }
43
+ function runExtract(io, options) {
44
+ const result = executeProjectMemoryExtract({
45
+ projectRoot: options.project,
46
+ artifactPaths: options.artifact,
47
+ apply: options.apply === true
48
+ });
49
+ // A block that was found but not extracted must not vanish silently: the
50
+ // parser's rejection reasons, and the writes the store already held, both ride
51
+ // the envelope's existing `warnings` channel (JSON: `warnings[]`; human:
52
+ // `warning: …` on stderr). `data` is unchanged — neither adds a field to the
53
+ // summary, and `writtenFiles` was already there to be compared against
54
+ // `plannedWrites`.
55
+ printResult(io, ok('memory.extract', summarizeProjectMemoryExtractResult(result), [
56
+ ...describeMemoryBlockDrops(result.droppedBlocks),
57
+ ...describeMemoryWriteSkips(result.skippedWrites, result.plannedWrites.length, result.writtenFiles.length)
58
+ ]), options.json);
59
+ }
60
+ function emitExtractFailure(io, options, error) {
61
+ const refusal = error instanceof UnsafeMemoryError ? error : null;
62
+ printResult(io, fail('memory.extract', 'MEMORY_EXTRACT_FAILED', getErrorMessage(error),
63
+ // The check and the term are facts about the failure, so they ride
64
+ // the envelope's data — not just its prose. `fail()` redacts
65
+ // `message` (see `UnsafeMemoryError`), so the term would otherwise
66
+ // reach the reader as `[redacted]`; `data` is passed through.
67
+ refusal === null ? {} : { check: refusal.check, matchedTerm: refusal.matchedTerm }, memoryExtractNextActions(refusal)), options.json);
68
+ process.exitCode = 1;
69
+ }
70
+ export function registerMemoryExtractCommand(memory, io) {
71
+ addJsonOption(memory
72
+ .command('extract')
73
+ .description('Extract stable project memory from skill artifacts into project .peaks/memory')
74
+ .requiredOption('--project <path>', 'target project root')
75
+ .requiredOption('--artifact <path...>', 'skill artifact paths inside the project')
76
+ .option('--dry-run', 'preview writes without changing files')
77
+ .option('--apply', 'write extracted memories into project .peaks/memory')).action((options) => {
78
+ const refused = refuseBothFlags(io, {
79
+ command: 'memory.extract',
80
+ code: 'INVALID_MEMORY_EXTRACT_FLAGS',
81
+ nextActions: ['Run without --apply to preview writes, or pass --apply to write memories'],
82
+ json: options.json,
83
+ dryRun: options.dryRun,
84
+ apply: options.apply
85
+ });
86
+ if (refused)
87
+ return;
88
+ try {
89
+ runExtract(io, options);
90
+ }
91
+ catch (error) {
92
+ emitExtractFailure(io, options, error);
93
+ }
94
+ });
95
+ }
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../../cli-helpers.js';
3
+ export declare function registerMemorySyncCommand(memory: Command, io: ProgramIO): void;
@@ -0,0 +1,38 @@
1
+ import { executeProjectMemoryBackup, summarizeProjectMemoryBackupResult } from '../../../services/memory/project-memory-service.js';
2
+ import { fail, ok } from 'peaks-loop-shared/result';
3
+ import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
4
+ import { refuseBothFlags } from './memory-command-shared.js';
5
+ export function registerMemorySyncCommand(memory, io) {
6
+ addJsonOption(memory
7
+ .command('sync')
8
+ .description('Back up project .peaks/memory into the artifact workspace')
9
+ .requiredOption('--project <path>', 'target project root')
10
+ .requiredOption('--workspace <path>', 'artifact workspace path')
11
+ .option('--dry-run', 'preview copies without changing files')
12
+ .option('--apply', 'copy project .peaks/memory into artifact workspace backup')).action((options) => {
13
+ const refused = refuseBothFlags(io, {
14
+ command: 'memory.sync',
15
+ code: 'INVALID_MEMORY_SYNC_FLAGS',
16
+ nextActions: ['Run without --apply to preview copies, or pass --apply to back up memories'],
17
+ json: options.json,
18
+ dryRun: options.dryRun,
19
+ apply: options.apply
20
+ });
21
+ if (refused)
22
+ return;
23
+ try {
24
+ const result = executeProjectMemoryBackup({
25
+ projectRoot: options.project,
26
+ artifactWorkspacePath: options.workspace,
27
+ apply: options.apply === true
28
+ });
29
+ printResult(io, ok('memory.sync', summarizeProjectMemoryBackupResult(result)), options.json);
30
+ }
31
+ catch (error) {
32
+ printResult(io, fail('memory.sync', 'MEMORY_SYNC_FAILED', getErrorMessage(error), {}, [
33
+ 'Use an artifact workspace outside the project root'
34
+ ]), options.json);
35
+ process.exitCode = 1;
36
+ }
37
+ });
38
+ }
@@ -1,3 +1,3 @@
1
1
  import type { Command } from 'commander';
2
- import { type ProgramIO } from '../../cli-helpers.js';
2
+ import type { ProgramIO } from '../../cli-helpers.js';
3
3
  export declare function registerSessionCommand(program: Command, io: ProgramIO): void;
@@ -1,10 +1,3 @@
1
- import { existsSync } from 'node:fs';
2
- import { join } from 'node:path';
3
- import { getSessionMeta, rotateSessionBinding, setSessionTitle, listSessionMetas } 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, getErrorMessage, printResult } from '../../cli-helpers.js';
8
1
  // `peaks session checkpoint` and `peaks session resume` subcommands
9
2
  // EAGERLY so they appear in `peaks session --help` output. The
10
3
  // previous lazy import ran AFTER commander had already produced
@@ -22,174 +15,20 @@ import { registerSessionMigrateSkillNameCommand } from '../session-migrate-skill
22
15
  // appear in `peaks session --help` for LLM `<TAB>`-discovery.
23
16
  import { registerSession24hModeCommand } from '../session-24h-mode.js';
24
17
  import { registerSpillDemoCommand } from '../spill-demo-command.js';
18
+ import { registerSessionInfoCommand } from './session-info-command.js';
19
+ import { registerSessionListCommand, registerSessionRotateCommand, registerSessionTitleCommand } from './session-verb-commands.js';
25
20
  export function registerSessionCommand(program, io) {
26
21
  const session = program.command('session').description('Manage Peaks session directories');
27
- addJsonOption(session.command('list').description('List all session directories with titles and metadata')).action((options) => {
28
- const projectRoot = findProjectRoot(process.cwd()) ?? process.cwd();
29
- const metas = listSessionMetas(projectRoot);
30
- printResult(io, ok('session.list', { sessions: metas, total: metas.length }), options.json);
31
- });
32
- addJsonOption(session
33
- .command('info [sessionId]')
34
- .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.')
35
- .option('--active', 'resolve the canonical session id from .peaks/_runtime/session.json (ignores [sessionId] when set)')
36
- .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.')
37
- // overrides the per-process PEAKS_CALLER_ID env var and the
38
- // PLATFORM_FALLBACKS table (D4 priority). The resolved callerId is
39
- // surfaced in the JSON envelope so callers can confirm what was
40
- // resolved without re-deriving it.
41
- .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(async (sessionId, options) => {
42
- // (matches the pre-021 behaviour so the existing slice-020 / slice-007
43
- // sub-agent flow keeps working unchanged).
44
- const projectRoot = options.project !== undefined
45
- ? resolveCanonicalProjectRoot(options.project)
46
- : (findProjectRoot(process.cwd()) ?? process.cwd());
47
- // We use `resolveCallerId` for D1/D5 validation; an invalid flag
48
- // throws CallerIdError (D5 → exit 65). A missing flag and no env
49
- // and no fallback also throws (D2 → exit 64). The resolved id is
50
- // surfaced in the envelope so the caller can audit.
51
- if (options.callerId !== undefined) {
52
- const { resolveCallerId, CallerIdError } = await import('../../../services/session/resolve-caller-id.js');
53
- let callerId;
54
- try {
55
- callerId = resolveCallerId({ flagValue: options.callerId });
56
- }
57
- catch (error) {
58
- if (error instanceof CallerIdError) {
59
- const code = error.code === 'EX_USAGE' ? 64 : 65;
60
- printResult(io, fail('session.info', 'CALLER_ID_INVALID', error.message, { source: error.source }, [
61
- `Set --caller-id to a value matching ^[a-zA-Z0-9._-]{1,200}$`,
62
- 'Or set PEAKS_CALLER_ID env var (or CLAUDE_CODE_SESSION_ID for Claude Code)'
63
- ]), options.json);
64
- process.exitCode = code;
65
- return;
66
- }
67
- throw error;
68
- }
69
- // Surface the resolved id in the envelope. When --active is also
70
- // passed, look up the binding for this callerId; otherwise
71
- // just emit the resolved id so the caller knows what was used.
72
- if (options.active === true) {
73
- const { getSessionIdCanonical } = await import('../../../services/session/session-manager.js');
74
- const { getCallerBinding } = await import('../../../services/session/caller-binding-service.js');
75
- const activeSid = getSessionIdCanonical(projectRoot);
76
- const callerBinding = getCallerBinding(projectRoot, callerId);
77
- // reports. Callers / migration tooling can detect pre-migration trees
78
- // by inspecting `source === 'legacy'`.
79
- const bindingSource = existsSync(join(projectRoot, '.peaks', '_runtime', 'session.json'))
80
- ? 'canonical'
81
- : 'legacy';
82
- printResult(io, ok('session.info', {
83
- active: true,
84
- sessionId: activeSid,
85
- callerId,
86
- callerBindingPeakSessionId: callerBinding?.peakSessionId ?? null,
87
- source: bindingSource
88
- }), options.json);
89
- return;
90
- }
91
- printResult(io, ok('session.info', {
92
- callerId,
93
- note: '--caller-id resolved; pass --active to also look up the bound peak session'
94
- }), options.json);
95
- return;
96
- }
97
- // does not know the parent's sid reads it from the binding via
98
- // SOLE authoritative discovery primitive: it composes on
99
- // getSessionIdCanonical (canonicalize-on-read; handles the stored
100
- // "projectRoot: '.'" vs caller-passed absolute realpath mismatch
101
- // that the F22 fix addressed) AND falls through to getSessionId
102
- // (strict-equality) for callers on the original contract. NEITHER
103
- // path may call ensureSession() — that would side-effect-create a
104
- // fresh binding on miss, erasing the "no active session" signal
105
- // sub-agents rely on.
106
- if (options.active === true) {
107
- // Import lazily to avoid a cycle with workspace-commands.
108
- const { getSessionIdCanonical, getSessionId } = await import('../../../services/session/session-manager.js');
109
- // 1. Canonicalize-on-read first.
110
- let activeSid = getSessionIdCanonical(projectRoot);
111
- // 2. Fall through to the strict-equality reader if the canonical
112
- // miss is a projectRoot-form mismatch (e.g. the binding was
113
- // written with the absolute realpath but the caller's form
114
- // normalizes differently). The 2-read fan-out mirrors the
115
- // fallback ensureSession() uses.
116
- if (activeSid === null) {
117
- activeSid = getSessionId(projectRoot);
118
- }
119
- if (activeSid === null) {
120
- // 3. No binding at all — fail loudly, NO crash, NO side-effect,
121
- // exit 1, message must point at `peaks workspace init`
122
- // (the canonical "first action" command, not the legacy
123
- // "or `peaks skill presence:set`" hedge that the pre-021
124
- // wording used — presence:set would also need a binding to
125
- // resolve the parent sid, so it's not actually a bootstrap
126
- // path).
127
- 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);
128
- process.exitCode = 1;
129
- return;
130
- }
131
- // 4. Determine the on-disk source so callers (and future
132
- // migration tooling) can detect pre-migration trees. The
133
- // contract).
134
- const bindingSource = existsSync(join(projectRoot, '.peaks', '_runtime', 'session.json'))
135
- ? 'canonical'
136
- : 'legacy';
137
- // surface a warning so callers (and humans tailing the JSON)
138
- // see "this tree has not been reconciled to the canonical
139
- // home yet". The warning is informational; the binding is
140
- // contract). `warnings` is a top-level envelope field, not a
141
- // data field, so it goes through ok()'s 3rd positional arg.
142
- const legacyWarnings = bindingSource === 'legacy'
143
- ? [
144
- 'Read from legacy back-compat path .peaks/.session.json. Run `peaks workspace reconcile --apply` to migrate to the canonical home (.peaks/_runtime/session.json).'
145
- ]
146
- : [];
147
- printResult(io, ok('session.info', {
148
- active: true,
149
- sessionId: activeSid,
150
- bindingPath: bindingSource === 'canonical'
151
- ? join(projectRoot, '.peaks', '_runtime', 'session.json')
152
- : join(projectRoot, '.peaks', '.session.json'),
153
- projectRoot,
154
- source: bindingSource
155
- }, legacyWarnings), options.json);
156
- return;
157
- }
158
- if (sessionId === undefined) {
159
- 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);
160
- process.exitCode = 1;
161
- return;
162
- }
163
- const meta = getSessionMeta(projectRoot, sessionId);
164
- if (meta === null) {
165
- 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);
166
- process.exitCode = 1;
167
- return;
168
- }
169
- printResult(io, ok('session.info', meta), options.json);
170
- });
171
- addJsonOption(session
172
- .command('title <sessionId> <title>')
173
- .description('Set a human-readable title for a session directory')).action((sessionId, title, options) => {
174
- const projectRoot = findProjectRoot(process.cwd()) ?? process.cwd();
175
- try {
176
- const meta = setSessionTitle(projectRoot, sessionId, title);
177
- printResult(io, ok('session.title', meta), options.json);
178
- }
179
- catch (error) {
180
- printResult(io, fail('session.title', 'SESSION_TITLE_FAILED', getErrorMessage(error), { sessionId }, [
181
- 'Verify the sessionId exists under .peaks/'
182
- ]), options.json);
183
- process.exitCode = 1;
184
- }
185
- });
22
+ registerSessionListCommand(session, io);
23
+ registerSessionInfoCommand(session, io);
24
+ registerSessionTitleCommand(session, io);
186
25
  // Skill-level primitives — the LLM is the decision-maker; CLI is the muscle.
187
- // via `void (async () => …)`) so commander walks the subcommand
188
- // tree synchronously and `peaks session --help` includes both
189
- // `checkpoint` and `resume`. The previous async-IIFE registered
190
- // them on a microtask tick AFTER the program-level help builder
191
- // had already serialised its output, so they were hidden from
192
- // `<TAB>`-discovery and the LLM never saw them.
26
+ // Registered synchronously (rather than via `void (async () => …)`) so
27
+ // commander walks the subcommand tree synchronously and
28
+ // `peaks session --help` includes both `checkpoint` and `resume`. The
29
+ // previous async-IIFE registered them on a microtask tick AFTER the
30
+ // program-level help builder had already serialised its output, so they
31
+ // were hidden from `<TAB>`-discovery and the LLM never saw them.
193
32
  registerSessionCheckpointCommand(session, io);
194
33
  registerSessionResumeCommand(session, io);
195
34
  // Slice 2 of the peaks-code → peaks-code rename plan:
@@ -200,38 +39,5 @@ export function registerSessionCommand(program, io) {
200
39
  registerSessionMigrateSkillNameCommand(session);
201
40
  registerSession24hModeCommand(session, io);
202
41
  registerSpillDemoCommand(session, io);
203
- addJsonOption(session
204
- .command('rotate')
205
- .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.')
206
- .option('--project <path>', 'target project root (defaults to git root or cwd)')
207
- .option('--reason <text>', 'human-readable reason for the rotation, recorded in the response data')).action((options) => {
208
- try {
209
- // Canonicalise the project root before touching the binding.
210
- // `peaks workspace init` writes the binding with the
211
- // realpath-resolved projectRoot; if the caller passes a path
212
- // through a symlink (notably /tmp on macOS, which is a
213
- // symlink to /private/tmp) without canonicalising here,
214
- // readSessionFile's strict projectRoot equality check fails
215
- // and the rotate call reports "no prior binding" even
216
- // though one exists. The same fix as `workspace init`
217
- // (b193714): promote the path to the git root, falling back
218
- // to the heuristic, falling back to cwd verbatim.
219
- const projectRoot = options.project !== undefined
220
- ? options.project
221
- : (findProjectRoot(process.cwd()) ?? process.cwd());
222
- const canonical = resolveCanonicalProjectRoot(projectRoot);
223
- const previousSessionId = rotateSessionBinding(canonical);
224
- printResult(io, ok('session.rotate', {
225
- previousSessionId,
226
- ...(options.reason !== undefined ? { reason: options.reason } : {}),
227
- note: previousSessionId === null
228
- ? 'No prior binding was present; the project is already unbound.'
229
- : 'Next ensureSession() call will auto-generate a fresh id. The previous session directory is still on disk at .peaks/_runtime/<previousSessionId>/.'
230
- }), options.json);
231
- }
232
- catch (error) {
233
- printResult(io, fail('session.rotate', 'SESSION_ROTATE_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Verify the project path exists and is writable']), options.json);
234
- process.exitCode = 1;
235
- }
236
- });
42
+ registerSessionRotateCommand(session, io);
237
43
  }
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../../cli-helpers.js';
3
+ export declare function registerSessionInfoCommand(session: Command, io: ProgramIO): void;