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,172 @@
1
+ import { runDoctor } from '../../../services/doctor/index.js';
2
+ import { dropStale, rebuildBindingFromLegacy } from '../../../services/session/binding-store.js';
3
+ import { findProjectRoot } from '../../../services/config/config-safety.js';
4
+ import { loadSkillRegistry } from '../../../services/skills/skill-registry.js';
5
+ import { addJsonOption, printResult } from '../../cli-helpers.js';
6
+ import { fail, ok } from 'peaks-loop-shared/result';
7
+ import { listStaleInstances, staleBindingSection, STALE_TTL_MS } from './doctor-bindings.js';
8
+ import { buildDoctorLogsSection } from './doctor-logs.js';
9
+ import { doctorIsValidSessionId, doctorStatusLineInstalledProbe } from './doctor-probes.js';
10
+ import { buildDoctorSummary } from './doctor-summary.js';
11
+ /** v2.18.2 cycle 2: `--rebuild-binding` and `--cleanup-stale` both mutate the
12
+ * binding, so running them together is ambiguous. Hard-reject the combination
13
+ * so the user gets an actionable error instead of a silent short-circuit. */
14
+ function emitConflictingFlags(io, options) {
15
+ const envelope = fail('doctor.rebuild-binding', 'CONFLICTING_FLAGS', '--rebuild-binding and --cleanup-stale are mutually exclusive', { rebuildBinding: true, cleanupStale: true }, ['Run them in separate `peaks doctor` invocations']);
16
+ printResult(io, envelope, options.json === true);
17
+ process.exitCode = 1;
18
+ }
19
+ /** The `--rebuild-binding` envelope. A rewrite is reported as `fail` when the
20
+ * rebuild was an observable no-op, so the two outcomes stay distinguishable. */
21
+ function rebuildEnvelope(result, data) {
22
+ if (result.rewritten !== 0) {
23
+ return fail('doctor.rebuild-binding', result.noop ? 'BINDING_REBUILD_NOOP' : 'BINDING_REBUILD_OK', result.noop
24
+ ? 'No legacy callerId entries to rewrite'
25
+ : `Rewrote ${result.rewritten} legacy callerId entry/entries (preserved ${result.preserved})`, data, ['Re-run `peaks binding status` to verify the rewritten entries']);
26
+ }
27
+ return ok('doctor.rebuild-binding', data, [], result.noop ? ['no legacy callerId entries found — nothing to rewrite'] : []);
28
+ }
29
+ /** `--rebuild-binding`: a single targeted migration, no doctor checks run. */
30
+ function runRebuildBinding(io, options, projectRoot) {
31
+ const result = rebuildBindingFromLegacy(projectRoot);
32
+ for (const err of result.errors) {
33
+ io.stderr(` warning: ${err}`);
34
+ }
35
+ const data = {
36
+ rebuilt: !result.noop,
37
+ rewritten: result.rewritten,
38
+ preserved: result.preserved,
39
+ errors: result.errors,
40
+ projectRoot
41
+ };
42
+ printResult(io, rebuildEnvelope(result, data), options.json === true);
43
+ if (result.errors.length > 0 && result.rewritten === 0) {
44
+ process.exitCode = 1;
45
+ }
46
+ }
47
+ /** `report.summary.ok` already factors in severity-aware aggregation (warnings
48
+ * do NOT flip `ok`); the stale-binding count escalates independently. */
49
+ function buildDoctorResult(report, staleInstances, data) {
50
+ if (report.summary.ok && staleInstances.length === 0)
51
+ return ok('doctor', data);
52
+ return fail('doctor', 'DOCTOR_FAILED', staleInstances.length > 0
53
+ ? `Found ${staleInstances.length} stale binding instance(s); rerun with --cleanup-stale to drop them`
54
+ : 'One or more doctor checks failed', data, staleInstances.length > 0
55
+ ? ['Run `peaks doctor --cleanup-stale` to drop stale entries']
56
+ : ['Fix failed checks and rerun peaks doctor']);
57
+ }
58
+ /** Human-readable: one line per check, green/red/warn indicators, no JSON. */
59
+ function renderChecks(io, report) {
60
+ for (const check of report.checks) {
61
+ if (check.ok)
62
+ io.stdout(` + ${check.message}`);
63
+ else if (check.severity === 'warning')
64
+ io.stdout(` ! ${check.message}`);
65
+ else
66
+ io.stdout(` × ${check.message}`);
67
+ }
68
+ }
69
+ function renderLogsSection(io, logs) {
70
+ io.stdout('\n logs:');
71
+ io.stdout(` logDir: ${logs.logDir}`);
72
+ io.stdout(` todayFile: ${logs.todayFile}`);
73
+ io.stdout(` sizeBytes: ${logs.sizeBytes}`);
74
+ io.stdout(` retentionDays: ${logs.retentionDays}`);
75
+ io.stdout(` level: ${logs.level}`);
76
+ }
77
+ function renderStaleBinding(io, staleInstances, droppedStale) {
78
+ io.stdout('\n stale-binding (v2.16.0 AC-10):');
79
+ if (staleInstances.length === 0) {
80
+ io.stdout(' + no stale instances');
81
+ return;
82
+ }
83
+ io.stdout(` × ${staleInstances.length} stale instance(s):`);
84
+ for (const s of staleInstances) {
85
+ io.stdout(` - sid=${s.sid} caller=${s.callerId} lastSeen=${s.lastHeartbeat}`);
86
+ }
87
+ if (droppedStale.length > 0) {
88
+ io.stdout(` cleaned up: ${droppedStale.length}`);
89
+ }
90
+ else {
91
+ io.stdout(' rerun with --cleanup-stale to drop them');
92
+ }
93
+ }
94
+ function renderDoctorFooter(io, report, staleInstances) {
95
+ const { passed, failed, warnings } = report.summary;
96
+ io.stdout(`\n ${passed} passed, ${failed} failed${warnings > 0 ? `, ${warnings} warning(s)` : ''}`);
97
+ if (!report.summary.ok || staleInstances.length > 0) {
98
+ io.stderr(`\nDOCTOR_FAILED: ${staleInstances.length > 0 ? 'stale binding present' : `${failed} check(s) failed`}.`);
99
+ }
100
+ else if (warnings > 0) {
101
+ io.stdout(`\n ${warnings} warning(s) present — exit code 0 (warn-only).`);
102
+ }
103
+ }
104
+ function renderDoctorHuman(io, report, sections) {
105
+ renderChecks(io, report);
106
+ if (sections.logs !== null)
107
+ renderLogsSection(io, sections.logs);
108
+ renderStaleBinding(io, sections.staleInstances, sections.droppedStale);
109
+ renderDoctorFooter(io, report, sections.staleInstances);
110
+ }
111
+ async function runDoctorReport(io, options, projectRoot) {
112
+ const report = await runDoctor({
113
+ loadSkills: loadSkillRegistry,
114
+ projectRootResolver: () => findProjectRoot(process.cwd()),
115
+ isValidSessionIdProbe: doctorIsValidSessionId,
116
+ statusLineInstalledProbe: doctorStatusLineInstalledProbe
117
+ });
118
+ const logs = options.log === true ? await buildDoctorLogsSection() : null;
119
+ const ttl = options.staleTtlMs !== undefined ? Number(options.staleTtlMs) : STALE_TTL_MS;
120
+ const staleInstances = listStaleInstances(projectRoot, ttl);
121
+ const droppedStale = options.cleanupStale === true ? dropStale(projectRoot, ttl).dropped : [];
122
+ const staleBinding = staleBindingSection(ttl, staleInstances, droppedStale);
123
+ const fullData = logs === null ? { ...report, staleBinding } : { ...report, logs, staleBinding };
124
+ const data = options.summary === true ? buildDoctorSummary(fullData) : fullData;
125
+ if (options.json === true) {
126
+ printResult(io, buildDoctorResult(report, staleInstances, data), true);
127
+ }
128
+ else {
129
+ renderDoctorHuman(io, report, { logs, staleInstances, droppedStale });
130
+ }
131
+ if (!report.summary.ok || staleInstances.length > 0) {
132
+ process.exitCode = 1;
133
+ }
134
+ }
135
+ async function runDoctorCommand(io, options) {
136
+ if (options.rebuildBinding === true && options.cleanupStale === true) {
137
+ emitConflictingFlags(io, options);
138
+ return;
139
+ }
140
+ // v2.18.2 cycle 2: --project override, applies to BOTH the
141
+ // --rebuild-binding short-circuit AND the binding-stale scan.
142
+ const projectRoot = options.project !== undefined
143
+ ? options.project
144
+ : (findProjectRoot(process.cwd()) ?? process.cwd());
145
+ if (options.rebuildBinding === true) {
146
+ runRebuildBinding(io, options, projectRoot);
147
+ return;
148
+ }
149
+ await runDoctorReport(io, options, projectRoot);
150
+ }
151
+ export function registerDoctorCommand(program, io) {
152
+ addJsonOption(program
153
+ .command('doctor')
154
+ .description('Run repository doctor checks')
155
+ .option('--log', 'include a "logs" section in the doctor output (slice 2026-06-16-cli-logging, AC6)')
156
+ .option('--cleanup-stale', 'drop stale instance entries from the project-level binding (v2.16.0 AC-10)')
157
+ .option('--stale-ttl-ms <ms>', 'stale-binding TTL in milliseconds (default 300000 = 5 minutes, v2.16.0 AC-10)')
158
+ // v2.18.2 PATCH scope (follow-up issue #1): rewrite legacy
159
+ // v2.16.0 / v2.17.0 binding files in place so every existing
160
+ // callerId gets the `${envSignal}#${pid}` suffix introduced in
161
+ // v2.18.0. Mutually exclusive with --cleanup-stale to keep the
162
+ // semantics unambiguous (rebuild = structural change,
163
+ // cleanup-stale = TTL-based prune).
164
+ .option('--rebuild-binding', 'rewrite legacy v2.16.0 / v2.17.0 callerId entries to the v2.18.0+ `#${pid}` format (v2.18.2, follow-up issue #1)')
165
+ // v2.18.2 cycle 2: --project makes the project-root-bound
166
+ // flags (--rebuild-binding, --cleanup-stale, stale-binding
167
+ // scan) addressable for non-current projects. The doctor was
168
+ // hardcoded to findProjectRoot(process.cwd()) which is the
169
+ // wrong default for users inspecting a sibling project.
170
+ .option('--project <path>', 'target project root (defaults to git root or cwd)')
171
+ .option('--summary', 'JSON envelope only: emit check counts + names-of-first-N (≤ 2 KB) instead of the full checks/stale-binding arrays; the default envelope is unchanged')).action((options) => runDoctorCommand(io, options));
172
+ }
@@ -0,0 +1,7 @@
1
+ /**
2
+ * the doctor envelope. The `checks` array (one object per check, each with a
3
+ * full message) and the stale-binding instance list collapse to counts +
4
+ * names-of-first-N; the summary counters and log section are scalars and are
5
+ * kept verbatim. ≤ 2 KB by construction.
6
+ */
7
+ export declare function buildDoctorSummary(data: Record<string, unknown>): Record<string, unknown>;
@@ -0,0 +1,39 @@
1
+ import { boundedNames, fitSummaryToBytes } from '../../../services/context/summary-view.js';
2
+ /**
3
+ * the doctor envelope. The `checks` array (one object per check, each with a
4
+ * full message) and the stale-binding instance list collapse to counts +
5
+ * names-of-first-N; the summary counters and log section are scalars and are
6
+ * kept verbatim. ≤ 2 KB by construction.
7
+ */
8
+ export function buildDoctorSummary(data) {
9
+ const checks = Array.isArray(data.checks)
10
+ ? data.checks
11
+ : [];
12
+ const label = (c) => {
13
+ const id = typeof c.id === 'string' ? c.id : 'unknown';
14
+ if (c.ok === true)
15
+ return `ok ${id}`;
16
+ return `${c.severity === 'warning' ? 'warn' : 'FAIL'} ${id}`;
17
+ };
18
+ const failed = checks.filter((c) => c.ok === false);
19
+ const stale = typeof data.staleBinding === 'object' && data.staleBinding !== null
20
+ ? data.staleBinding
21
+ : null;
22
+ const view = {
23
+ view: 'summary',
24
+ summary: data.summary,
25
+ checks: boundedNames(checks.map(label)),
26
+ failed: boundedNames(failed.map((c) => `${typeof c.id === 'string' ? c.id : 'unknown'}: ${typeof c.message === 'string' ? c.message : ''}`))
27
+ };
28
+ if (stale !== null) {
29
+ view.staleBinding = {
30
+ ttlMs: stale.ttlMs,
31
+ staleCount: stale.staleCount,
32
+ droppedCount: stale.droppedCount,
33
+ droppedSids: boundedNames(Array.isArray(stale.droppedSids) ? stale.droppedSids.map((s) => String(s)) : [])
34
+ };
35
+ }
36
+ if (data.logs !== undefined)
37
+ view.logs = data.logs;
38
+ return fitSummaryToBytes(view);
39
+ }
@@ -0,0 +1,25 @@
1
+ import { type ProgramIO } from '../../cli-helpers.js';
2
+ /** A `--dry-run --apply` refusal, resolved per verb. */
3
+ export type FlagConflict = {
4
+ readonly command: string;
5
+ readonly code: string;
6
+ readonly nextActions: readonly string[];
7
+ readonly json: boolean | undefined;
8
+ readonly dryRun: boolean | undefined;
9
+ readonly apply: boolean | undefined;
10
+ };
11
+ /**
12
+ * `--dry-run` and `--apply` are mutually exclusive: previewing and writing in
13
+ * one invocation has no defined meaning, so refuse before any work happens.
14
+ */
15
+ export declare function refuseBothFlags(io: ProgramIO, conflict: FlagConflict): boolean;
16
+ /** A verb whose lazy `memory-commands.ts` import or run failed. */
17
+ export type BootstrapFailure = {
18
+ readonly command: string;
19
+ readonly code: string;
20
+ readonly message: string;
21
+ readonly json: boolean | undefined;
22
+ readonly nextActions?: readonly string[] | undefined;
23
+ };
24
+ /** Print the `*_BOOTSTRAP_FAILED` envelope and mark the process failed. */
25
+ export declare function emitBootstrapFailure(io: ProgramIO, failure: BootstrapFailure): void;
@@ -0,0 +1,20 @@
1
+ import { fail } from 'peaks-loop-shared/result';
2
+ import { printResult } from '../../cli-helpers.js';
3
+ /**
4
+ * `--dry-run` and `--apply` are mutually exclusive: previewing and writing in
5
+ * one invocation has no defined meaning, so refuse before any work happens.
6
+ */
7
+ export function refuseBothFlags(io, conflict) {
8
+ if (!(conflict.dryRun === true && conflict.apply === true))
9
+ return false;
10
+ printResult(io, fail(conflict.command, conflict.code, 'Use either --dry-run or --apply, not both', {}, [
11
+ ...conflict.nextActions
12
+ ]), conflict.json);
13
+ process.exitCode = 1;
14
+ return true;
15
+ }
16
+ /** Print the `*_BOOTSTRAP_FAILED` envelope and mark the process failed. */
17
+ export function emitBootstrapFailure(io, failure) {
18
+ printResult(io, fail(failure.command, failure.code, failure.message, {}, [...(failure.nextActions ?? [])]), failure.json);
19
+ process.exitCode = 1;
20
+ }
@@ -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 registerMemoryCommand(program: Command, io: ProgramIO): void;
@@ -1,230 +1,9 @@
1
- import { describeMemoryBlockDrops, executeProjectMemoryBackup, executeProjectMemoryExtract, SENSITIVE_MEMORY_CHECKS, summarizeProjectMemoryBackupResult, summarizeProjectMemoryExtractResult, UnsafeMemoryError, VALID_PROJECT_MEMORY_KINDS } 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
- /** Derived from the canonical kind vocabulary — never hand-maintain a list here. */
5
- const KIND_HELP = VALID_PROJECT_MEMORY_KINDS.join(', ');
1
+ import { registerMemoryDelegatedVerbs } from './memory-delegated-verbs.js';
2
+ import { registerMemoryExtractCommand } from './memory-extract-command.js';
3
+ import { registerMemorySyncCommand } from './memory-sync-command.js';
6
4
  export function registerMemoryCommand(program, io) {
7
5
  const memory = program.command('memory').description('Manage project-local Peaks memory');
8
- addJsonOption(memory
9
- .command('extract')
10
- .description('Extract stable project memory from skill artifacts into project .peaks/memory')
11
- .requiredOption('--project <path>', 'target project root')
12
- .requiredOption('--artifact <path...>', 'skill artifact paths inside the project')
13
- .option('--dry-run', 'preview writes without changing files')
14
- .option('--apply', 'write extracted memories into project .peaks/memory')).action((options) => {
15
- if (options.dryRun === true && options.apply === true) {
16
- printResult(io, fail('memory.extract', 'INVALID_MEMORY_EXTRACT_FLAGS', 'Use either --dry-run or --apply, not both', {}, ['Run without --apply to preview writes, or pass --apply to write memories']), options.json);
17
- process.exitCode = 1;
18
- return;
19
- }
20
- try {
21
- const result = executeProjectMemoryExtract({
22
- projectRoot: options.project,
23
- artifactPaths: options.artifact,
24
- apply: options.apply === true
25
- });
26
- // A block that was found but not extracted must not vanish silently: the
27
- // parser's rejection reasons ride the envelope's existing `warnings`
28
- // channel (JSON: `warnings[]`; human: `warning: …` on stderr). `data` is
29
- // unchanged — this adds no field to the summary.
30
- printResult(io, ok('memory.extract', summarizeProjectMemoryExtractResult(result), describeMemoryBlockDrops(result.droppedBlocks)), options.json);
31
- }
32
- catch (error) {
33
- const refusal = error instanceof UnsafeMemoryError ? error : null;
34
- printResult(io, fail('memory.extract', 'MEMORY_EXTRACT_FAILED', getErrorMessage(error),
35
- // The check and the term are facts about the failure, so they ride
36
- // the envelope's data — not just its prose. `fail()` redacts
37
- // `message` (see `UnsafeMemoryError`), so the term would otherwise
38
- // reach the reader as `[redacted]`; `data` is passed through.
39
- refusal === null ? {} : { check: refusal.check, matchedTerm: refusal.matchedTerm }, memoryExtractNextActions(refusal)), options.json);
40
- process.exitCode = 1;
41
- }
42
- });
43
- addJsonOption(memory
44
- .command('sync')
45
- .description('Back up project .peaks/memory into the artifact workspace')
46
- .requiredOption('--project <path>', 'target project root')
47
- .requiredOption('--workspace <path>', 'artifact workspace path')
48
- .option('--dry-run', 'preview copies without changing files')
49
- .option('--apply', 'copy project .peaks/memory into artifact workspace backup')).action((options) => {
50
- if (options.dryRun === true && options.apply === true) {
51
- printResult(io, fail('memory.sync', 'INVALID_MEMORY_SYNC_FLAGS', 'Use either --dry-run or --apply, not both', {}, ['Run without --apply to preview copies, or pass --apply to back up memories']), options.json);
52
- process.exitCode = 1;
53
- return;
54
- }
55
- try {
56
- const result = executeProjectMemoryBackup({
57
- projectRoot: options.project,
58
- artifactWorkspacePath: options.workspace,
59
- apply: options.apply === true
60
- });
61
- printResult(io, ok('memory.sync', summarizeProjectMemoryBackupResult(result)), options.json);
62
- }
63
- catch (error) {
64
- printResult(io, fail('memory.sync', 'MEMORY_SYNC_FAILED', getErrorMessage(error), {}, [
65
- 'Use an artifact workspace outside the project root'
66
- ]), options.json);
67
- process.exitCode = 1;
68
- }
69
- });
70
- addJsonOption(memory
71
- .command('list')
72
- .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.')
73
- .option('--kind <kind>', `filter by memory kind (one of: ${KIND_HELP})`)
74
- .option('--pick', 'spawn fzf for interactive multi-select (requires fzf >= 0.38); writes picked.json')
75
- .option('--fzf-bin <path>', 'override fzf binary path (default: fzf on PATH)', 'fzf')
76
- .option('--summary', 'emit counts + names-of-first-N only (≤ 2 KB) instead of the full entry array; the default envelope is unchanged')
77
- .option('--project <path>', 'target project root (defaults to git root or cwd)')).action((options) => {
78
- void import('../memory-commands.js')
79
- .then(({ runMemoryList }) => {
80
- void runMemoryList(io, {
81
- ...(options.kind !== undefined ? { kind: options.kind } : {}),
82
- ...(options.pick === true ? { pick: true } : {}),
83
- ...(options.fzfBin ? { fzfBin: options.fzfBin } : {}),
84
- ...(options.project !== undefined ? { project: options.project } : {}),
85
- ...(options.summary === true ? { summary: true } : {}),
86
- ...(options.json !== undefined ? { json: options.json } : {})
87
- });
88
- })
89
- .catch((error) => {
90
- const msg = /brew install fzf|apt-get install fzf|older than required/.test(getErrorMessage(error))
91
- ? '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.'
92
- : getErrorMessage(error);
93
- const code = /brew install fzf|apt-get install fzf|older than required/.test(msg)
94
- ? 'FZF_UNAVAILABLE'
95
- : 'MEMORY_LIST_BOOTSTRAP_FAILED';
96
- printResult(io, fail('memory.list', code, msg, {}, [
97
- 'Install fzf or run without --pick to list entries as JSON'
98
- ]), options.json);
99
- if (code === 'FZF_UNAVAILABLE')
100
- process.exitCode = 127;
101
- else
102
- process.exitCode = 1;
103
- });
104
- });
105
- addJsonOption(memory
106
- .command('reindex')
107
- .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.')
108
- .option('--project <path>', 'target project root (defaults to git root or cwd)')
109
- .option('--dry-run', 'report drift without writing (default)')
110
- .option('--apply', 'rebuild index.json and regenerate MEMORY.md')
111
- .option('--summary', 'emit drift counts + names-of-first-N only (≤ 2 KB) instead of the full arrays; the default envelope is unchanged')).action((options) => {
112
- void import('../memory-commands.js')
113
- .then(({ runMemoryReindex }) => {
114
- void runMemoryReindex(io, {
115
- ...(options.project !== undefined ? { project: options.project } : {}),
116
- ...(options.dryRun === true ? { dryRun: true } : {}),
117
- ...(options.apply === true ? { apply: true } : {}),
118
- ...(options.summary === true ? { summary: true } : {}),
119
- ...(options.json !== undefined ? { json: options.json } : {})
120
- });
121
- })
122
- .catch((error) => {
123
- printResult(io, fail('memory.reindex', 'MEMORY_REINDEX_BOOTSTRAP_FAILED', getErrorMessage(error), {}, []), options.json);
124
- process.exitCode = 1;
125
- });
126
- });
127
- addJsonOption(memory
128
- .command('ingest')
129
- .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.')
130
- .option('--project <path>', 'target project root (defaults to git root or cwd)')
131
- .option('--source-dir <path>', 'override the IDE-side memory directory')
132
- .option('--dry-run', 'preview imports without writing (default)')
133
- .option('--apply', 'write normalized memories into .peaks/memory')).action((options) => {
134
- void import('../memory-commands.js')
135
- .then(({ runMemoryIngest }) => {
136
- void runMemoryIngest(io, {
137
- ...(options.project !== undefined ? { project: options.project } : {}),
138
- ...(options.sourceDir !== undefined ? { sourceDir: options.sourceDir } : {}),
139
- ...(options.dryRun === true ? { dryRun: true } : {}),
140
- ...(options.apply === true ? { apply: true } : {}),
141
- ...(options.json !== undefined ? { json: options.json } : {})
142
- });
143
- })
144
- .catch((error) => {
145
- printResult(io, fail('memory.ingest', 'MEMORY_INGEST_BOOTSTRAP_FAILED', getErrorMessage(error), {}, []), options.json);
146
- process.exitCode = 1;
147
- });
148
- });
149
- addJsonOption(memory
150
- .command('rotate')
151
- .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.')
152
- .option('--project <path>', 'target project root (defaults to git root or cwd)')
153
- .option('--dry-run', 'report the rotation plan without moving anything (default)')
154
- .option('--apply', 'move tier-C candidates into .peaks/memory/archived/')).action((options) => {
155
- void import('../memory-commands.js')
156
- .then(({ runMemoryRotate }) => {
157
- void runMemoryRotate(io, {
158
- ...(options.project !== undefined ? { project: options.project } : {}),
159
- ...(options.dryRun === true ? { dryRun: true } : {}),
160
- ...(options.apply === true ? { apply: true } : {}),
161
- ...(options.json !== undefined ? { json: options.json } : {})
162
- });
163
- })
164
- .catch((error) => {
165
- printResult(io, fail('memory.rotate', 'MEMORY_ROTATE_BOOTSTRAP_FAILED', getErrorMessage(error), {}, []), options.json);
166
- process.exitCode = 1;
167
- });
168
- });
169
- addJsonOption(memory
170
- .command('search <query>')
171
- .description('Fuzzy-search the memory index (deterministic, local, zero-token). Default --limit 6.')
172
- .option('--kind <kind>', `filter by memory kind (one of: ${KIND_HELP})`)
173
- .option('--limit <n>', 'maximum number of matches to return', (value) => Number(value))
174
- .option('--project <path>', 'target project root (defaults to git root or cwd)')).action((query, options) => {
175
- // Lazy import avoids a top-of-file import cycle (memory-commands.ts
176
- // imports services that the rest of this file may also touch).
177
- void import('../memory-commands.js')
178
- .then(({ runMemorySearch }) => {
179
- void runMemorySearch(io, {
180
- query,
181
- ...(options.kind !== undefined ? { kind: options.kind } : {}),
182
- ...(options.limit !== undefined ? { limit: options.limit } : {}),
183
- ...(options.project !== undefined ? { project: options.project } : {}),
184
- ...(options.json !== undefined ? { json: options.json } : {})
185
- });
186
- })
187
- .catch((error) => {
188
- printResult(io, fail('memory.search', 'MEMORY_SEARCH_BOOTSTRAP_FAILED', getErrorMessage(error), {}, []), options.json);
189
- process.exitCode = 1;
190
- });
191
- });
192
- }
193
- /**
194
- * The remedy for a failed `memory extract`, chosen by the check that refused
195
- * the write — the same `SENSITIVE_MEMORY_CHECKS` values the refusal message
196
- * and envelope data are built from, so the message, the data and the advice
197
- * cannot drift apart.
198
- *
199
- * WHY IT IS NOT ONE STATIC STRING. Every failure used to get "Check artifact
200
- * paths and remove secrets before extracting memory" — including a refusal
201
- * raised only because a memory TITLE contained a word like `authority`
202
- * (slice C0). There was no secret anywhere in that memory, so the one thing
203
- * the hint told the user to do was the one thing that could not help: it sent
204
- * check that actually failed.
205
- *
206
- * `null` (a failure that is not a safety refusal — a path escape, a missing
207
- * artifact) keeps the pre-C0 hint, which is about paths and secrets rather
208
- * than about a check.
209
- */
210
- function memoryExtractNextActions(refusal) {
211
- if (refusal === null) {
212
- return ['Check artifact paths and remove secrets before extracting memory'];
213
- }
214
- if (refusal.check === SENSITIVE_MEMORY_CHECKS.title) {
215
- return [
216
- 'Retitle the memory so it is not named after a credential term, then re-run memory extract'
217
- ];
218
- }
219
- if (refusal.check === SENSITIVE_MEMORY_CHECKS.content) {
220
- // Name the rule, not just the family. `matchedTerm` is a closed id
221
- // (`credential-assignment`, `bearer-value`, `pem-private-key`, …), so the
222
- // reader can tell a credential in the text from a sentence that merely has
223
- // the shape of one — which is the difference between removing a value and
224
- // rewording prose.
225
- return [
226
- `Remove the credential value the "${refusal.matchedTerm}" pattern matched, then re-run memory extract`
227
- ];
228
- }
229
- return ['Remove the credential value from the memory content, then re-run memory extract'];
6
+ registerMemoryExtractCommand(memory, io);
7
+ registerMemorySyncCommand(memory, io);
8
+ registerMemoryDelegatedVerbs(memory, io);
230
9
  }
@@ -0,0 +1,4 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../../cli-helpers.js';
3
+ /** The five verbs whose bodies live in `memory-commands.ts`, in shipping order. */
4
+ export declare function registerMemoryDelegatedVerbs(memory: Command, io: ProgramIO): void;