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,59 @@
1
+ import { type ResultEnvelope } from 'peaks-loop-shared/result';
2
+ import type { ProjectMemoryKind } from '../../services/memory/memory-search-service.js';
3
+ export interface MemorySearchCommandOptions {
4
+ query: string;
5
+ kind?: string;
6
+ limit?: number;
7
+ project?: string;
8
+ json?: boolean;
9
+ }
10
+ export interface MemoryListCommandOptions {
11
+ kind?: string;
12
+ pick?: boolean;
13
+ fzfBin?: string;
14
+ project?: string;
15
+ json?: boolean;
16
+ /** Slice B: emit counts + names-of-first-N instead of the full entry array. */
17
+ summary?: boolean;
18
+ }
19
+ export interface MemoryReindexCommandOptions {
20
+ project?: string;
21
+ dryRun?: boolean;
22
+ apply?: boolean;
23
+ json?: boolean;
24
+ /** Slice B: emit counts + names-of-first-N instead of the full arrays. */
25
+ summary?: boolean;
26
+ }
27
+ export interface MemoryIngestCommandOptions {
28
+ project?: string;
29
+ sourceDir?: string;
30
+ dryRun?: boolean;
31
+ apply?: boolean;
32
+ json?: boolean;
33
+ }
34
+ export interface MemoryRotateCommandOptions {
35
+ project?: string;
36
+ dryRun?: boolean;
37
+ apply?: boolean;
38
+ json?: boolean;
39
+ }
40
+ /** `--project` canonicalised, else the nearest project root above cwd, else cwd. */
41
+ export declare function resolveMemoryProjectRoot(project?: string): string;
42
+ /** The CLI kind flag, narrowed to the canonical vocabulary; unknown ⇒ no filter. */
43
+ export declare function resolveKindFilter(kind: string | undefined): ProjectMemoryKind | undefined;
44
+ /**
45
+ * The failed envelope for a memory verb: the error's own `code` when it carries
46
+ * one, the verb's `<VERB>_FAILED` otherwise. `byCode` names the one action worth
47
+ * recommending for a specific failure; anything else falls back to
48
+ * `suggestions`, so a caller that has no code-specific advice omits it.
49
+ */
50
+ export declare function memoryFailure(input: {
51
+ readonly command: string;
52
+ readonly fallbackCode: string;
53
+ readonly error: unknown;
54
+ readonly projectRoot: string;
55
+ readonly suggestions?: readonly string[];
56
+ readonly byCode?: Readonly<Record<string, string>>;
57
+ }): ResultEnvelope<{
58
+ projectRoot: string;
59
+ }>;
@@ -0,0 +1,39 @@
1
+ // src/cli/commands/memory-command-shared.ts
2
+ //
3
+ // What every `peaks memory` run function shares: the option types the Commander
4
+ // wiring in `core/memory-command.ts` feeds them, the project-root resolution,
5
+ // the kind filter, and the one place a refused run becomes an envelope. Split
6
+ // out of `memory-commands.ts` so each verb can live in its own module.
7
+ //
8
+ // The five run functions used to repeat the same twelve-line catch block, each
9
+ // with its own `(error as { code?: string }).code ?? '<VERB>_FAILED'` and its
10
+ // own suggestion list. `memoryFailure` is that block once; the per-verb
11
+ // fallback code, the code-keyed hints and the default suggestion are the only
12
+ // things that ever differed.
13
+ import { fail, getErrorMessage } from 'peaks-loop-shared/result';
14
+ import { findProjectRoot } from '../../services/config/config-safety.js';
15
+ import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
16
+ import { VALID_PROJECT_MEMORY_KINDS } from '../../services/memory/project-memory-service.js';
17
+ /** `--project` canonicalised, else the nearest project root above cwd, else cwd. */
18
+ export function resolveMemoryProjectRoot(project) {
19
+ return project !== undefined
20
+ ? resolveCanonicalProjectRoot(project)
21
+ : (findProjectRoot(process.cwd()) ?? process.cwd());
22
+ }
23
+ /** The CLI kind flag, narrowed to the canonical vocabulary; unknown ⇒ no filter. */
24
+ export function resolveKindFilter(kind) {
25
+ return kind !== undefined && VALID_PROJECT_MEMORY_KINDS.includes(kind)
26
+ ? kind
27
+ : undefined;
28
+ }
29
+ /**
30
+ * The failed envelope for a memory verb: the error's own `code` when it carries
31
+ * one, the verb's `<VERB>_FAILED` otherwise. `byCode` names the one action worth
32
+ * recommending for a specific failure; anything else falls back to
33
+ * `suggestions`, so a caller that has no code-specific advice omits it.
34
+ */
35
+ export function memoryFailure(input) {
36
+ const code = input.error.code ?? input.fallbackCode;
37
+ const hint = input.byCode?.[code];
38
+ return fail(input.command, code, getErrorMessage(input.error), { projectRoot: input.projectRoot }, hint === undefined ? [...(input.suggestions ?? [])] : [hint]);
39
+ }
@@ -1,79 +1,6 @@
1
- import { type MemoryIndexEntry, type MemoryIndexSnapshot, type ProjectMemoryKind } from '../../services/memory/memory-search-service.js';
2
- import { type MemoryReindexReport } from '../../services/memory/project-memory-service.js';
3
- import { type ProgramIO } from '../cli-helpers.js';
4
- export interface MemorySearchCommandOptions {
5
- query: string;
6
- kind?: string;
7
- limit?: number;
8
- project?: string;
9
- json?: boolean;
10
- }
11
- export interface MemoryListCommandOptions {
12
- kind?: string;
13
- pick?: boolean;
14
- fzfBin?: string;
15
- project?: string;
16
- json?: boolean;
17
- /** Slice B: emit counts + names-of-first-N instead of the full entry array. */
18
- summary?: boolean;
19
- }
20
- export interface MemoryReindexCommandOptions {
21
- project?: string;
22
- dryRun?: boolean;
23
- apply?: boolean;
24
- json?: boolean;
25
- /** Slice B: emit counts + names-of-first-N instead of the full arrays. */
26
- summary?: boolean;
27
- }
28
- /**
29
- * `memory reindex`. The full report's arrays stay on disk / in the default
30
- * envelope; this replaces them with `{count, names}` views (≤ 2 KB).
31
- */
32
- export declare function buildMemoryReindexSummary(report: MemoryReindexReport): Record<string, unknown>;
33
- /**
34
- * Slice B: bounded view of `memory list`. `count` is the true total; `names`
35
- * carries `name (kind)` labels for the first N entries.
36
- */
37
- export declare function buildMemoryListSummary(data: {
38
- snapshot: MemoryIndexSnapshot;
39
- entries: readonly MemoryIndexEntry[];
40
- kindFilter: ProjectMemoryKind | undefined;
41
- pickedEntries: readonly MemoryIndexEntry[];
42
- pickedOutputPath: string | null;
43
- fzfVersion: string | null;
44
- }): Record<string, unknown>;
45
- export interface MemoryIngestCommandOptions {
46
- project?: string;
47
- sourceDir?: string;
48
- dryRun?: boolean;
49
- apply?: boolean;
50
- json?: boolean;
51
- }
52
- export interface MemoryRotateCommandOptions {
53
- project?: string;
54
- dryRun?: boolean;
55
- apply?: boolean;
56
- json?: boolean;
57
- }
58
- export declare function runMemoryList(io: ProgramIO, options: MemoryListCommandOptions): Promise<void>;
59
- /**
60
- * Run the memory search subcommand. Extracted so unit tests can
61
- * exercise the full envelope without spawning a subprocess.
62
- */
63
- export declare function runMemorySearch(io: ProgramIO, options: MemorySearchCommandOptions): Promise<void>;
64
- /**
65
- * `peaks memory reindex` — rebuild `.peaks/memory/index.json` from disk and
66
- * regenerate `MEMORY.md`. Dry-run by default; `--apply` writes.
67
- */
68
- export declare function runMemoryReindex(io: ProgramIO, options: MemoryReindexCommandOptions): Promise<void>;
69
- /**
70
- * `peaks memory rotate` — tier-driven retention for `.peaks/memory/`.
71
- * Implements the sediment pruning policy (tier 1: archive, never delete).
72
- * Dry-run by default; `--apply` moves tier-C candidates into `archived/`.
73
- */
74
- export declare function runMemoryRotate(io: ProgramIO, options: MemoryRotateCommandOptions): Promise<void>;
75
- /**
76
- * `peaks memory ingest` — import memories written by the IDE-side agent into
77
- * `.peaks/memory/`. The IDE-side source is read-only; dry-run by default.
78
- */
79
- export declare function runMemoryIngest(io: ProgramIO, options: MemoryIngestCommandOptions): Promise<void>;
1
+ export type { MemoryIngestCommandOptions, MemoryListCommandOptions, MemoryReindexCommandOptions, MemoryRotateCommandOptions, MemorySearchCommandOptions } from './memory-command-shared.js';
2
+ export { buildMemoryListSummary, runMemoryList } from './memory-list-command.js';
3
+ export { buildMemoryReindexSummary, runMemoryReindex } from './memory-reindex-command.js';
4
+ export { runMemoryIngest } from './memory-ingest-command.js';
5
+ export { runMemoryRotate } from './memory-rotate-command.js';
6
+ export { runMemorySearch } from './memory-search-command.js';
@@ -1,309 +1,19 @@
1
- import { findProjectRoot } from '../../services/config/config-safety.js';
2
- import { resolveCanonicalProjectRoot } from '../../services/config/config-service.js';
3
- import { loadMemoryIndex, searchMemory } from '../../services/memory/memory-search-service.js';
4
- import { executeMemoryReindex, VALID_PROJECT_MEMORY_KINDS } from '../../services/memory/project-memory-service.js';
5
- import { boundedNames, fitSummaryToBytes } from '../../services/context/summary-view.js';
6
- import { executeMemoryIngest } from '../../services/memory/memory-ingest-service.js';
7
- import { executeMemoryRotate } from '../../services/memory/memory-rotate-service.js';
8
- import { pickFromList } from '../../services/fuzzy-matching/fzf-pick-service.js';
9
- import { fail, ok } from 'peaks-loop-shared/result';
10
- import { getErrorMessage, printResult } from '../cli-helpers.js';
11
- import { join } from 'node:path';
12
- const VALID_KINDS = VALID_PROJECT_MEMORY_KINDS;
13
- /**
14
- * `memory reindex`. The full report's arrays stay on disk / in the default
15
- * envelope; this replaces them with `{count, names}` views (≤ 2 KB).
16
- */
17
- export function buildMemoryReindexSummary(report) {
18
- const view = {
19
- view: 'summary',
20
- apply: report.apply,
21
- projectRoot: report.projectRoot,
22
- memoryDir: report.memoryDir,
23
- indexPath: report.indexPath,
24
- memoryMdPath: report.memoryMdPath,
25
- scannedFiles: report.scannedFiles,
26
- indexed: report.indexed,
27
- indexedByKind: report.indexedByKind,
28
- unclassified: boundedNames(report.unclassified.map((u) => `${u.name}${u.rawKind === null ? '' : ` (${u.rawKind})`}`)),
29
- nameConflicts: boundedNames(report.nameConflicts.map((c) => c.name)),
30
- orphanIndex: boundedNames(report.orphanIndex.map((o) => o.name)),
31
- orphanDisk: boundedNames(report.orphanDisk.map((p) => p.split(/[\\/]/).pop() ?? p)),
32
- memoryMd: report.memoryMd,
33
- writtenFiles: boundedNames(report.writtenFiles.map((p) => p.split(/[\\/]/).pop() ?? p))
34
- };
35
- return fitSummaryToBytes(view);
36
- }
37
- /**
38
- * Slice B: bounded view of `memory list`. `count` is the true total; `names`
39
- * carries `name (kind)` labels for the first N entries.
40
- */
41
- export function buildMemoryListSummary(data) {
42
- const label = (e) => `${e.name} (${e.kind})`;
43
- const view = {
44
- view: 'summary',
45
- indexPath: data.snapshot.indexPath,
46
- version: data.snapshot.version,
47
- updatedAt: data.snapshot.updatedAt,
48
- total: data.entries.length,
49
- kindFilter: data.kindFilter ?? null,
50
- entries: boundedNames(data.entries.map(label))
51
- };
52
- if (data.pickedOutputPath !== null) {
53
- view.picked = boundedNames(data.pickedEntries.map(label));
54
- view.pickedOutputPath = data.pickedOutputPath;
55
- view.fzfVersion = data.fzfVersion;
56
- }
57
- return fitSummaryToBytes(view);
58
- }
59
- function resolveMemoryProjectRoot(project) {
60
- return project !== undefined
61
- ? resolveCanonicalProjectRoot(project)
62
- : (findProjectRoot(process.cwd()) ?? process.cwd());
63
- }
64
- export async function runMemoryList(io, options) {
65
- const projectRoot = options.project !== undefined
66
- ? resolveCanonicalProjectRoot(options.project)
67
- : (findProjectRoot(process.cwd()) ?? process.cwd());
68
- try {
69
- const snapshot = loadMemoryIndex(projectRoot);
70
- const kindFilter = options.kind !== undefined && VALID_KINDS.includes(options.kind)
71
- ? options.kind
72
- : undefined;
73
- const entries = kindFilter === undefined
74
- ? snapshot.entries
75
- : snapshot.entries.filter((e) => e.kind === kindFilter);
76
- const warnings = [];
77
- let pickedEntries = entries;
78
- let pickedOutputPath = null;
79
- let fzfVersion = null;
80
- if (options.pick === true) {
81
- const outputPath = join(projectRoot, '.peaks', 'memory', 'picked.json');
82
- const byName = new Map(entries.map((e) => [e.name, e]));
83
- const result = await pickFromList({
84
- items: entries,
85
- formatLine: (entry) => `${entry.name} | ${entry.kind} | ${entry.description.slice(0, 60)}`,
86
- parseLine: (line) => {
87
- const parts = line.split('|').map((p) => p.trim());
88
- if (parts.length < 1)
89
- return null;
90
- const name = parts[0];
91
- if (name === undefined || name.length === 0)
92
- return null;
93
- return byName.get(name) ?? null;
94
- },
95
- outputPath,
96
- meta: { kindFilter: kindFilter ?? null, totalCandidates: entries.length },
97
- ...(options.fzfBin !== undefined ? { fzfBin: options.fzfBin } : {}),
98
- projectRoot,
99
- multi: true,
100
- prompt: 'memory> '
101
- });
102
- pickedEntries = [...result.picked];
103
- pickedOutputPath = result.outputPath;
104
- fzfVersion = result.fzfVersion;
105
- }
106
- const nextActions = [];
107
- if (pickedOutputPath !== null) {
108
- nextActions.push(`Picked ${pickedEntries.length} entr(ies); written to ${pickedOutputPath}`);
109
- }
110
- if (entries.length === 0) {
111
- nextActions.push('No entries match; run `peaks memory extract` to build the index from memory/*.md files.');
112
- }
113
- // Slice B: `--summary` swaps the full entry array for a bounded
114
- // `{count, names}` view. The default (no flag) envelope is byte-identical
115
- // to before — the flag is strictly opt-in.
116
- const data = options.summary === true
117
- ? buildMemoryListSummary({
118
- snapshot,
119
- entries,
120
- kindFilter,
121
- pickedEntries,
122
- pickedOutputPath,
123
- fzfVersion
124
- })
125
- : {
126
- indexPath: snapshot.indexPath,
127
- version: snapshot.version,
128
- updatedAt: snapshot.updatedAt,
129
- total: entries.length,
130
- kindFilter: kindFilter ?? null,
131
- entries,
132
- ...(options.pick === true
133
- ? { picked: pickedEntries, pickedOutputPath, fzfVersion }
134
- : {})
135
- };
136
- printResult(io, ok('memory.list', data, warnings, nextActions), options.json);
137
- }
138
- catch (error) {
139
- const message = getErrorMessage(error);
140
- const code = error.code ?? 'MEMORY_LIST_FAILED';
141
- const suggestions = [];
142
- if (code === 'INDEX_MISSING') {
143
- suggestions.push('Run `peaks memory extract` to build the index from memory/*.md files');
144
- }
145
- printResult(io, fail('memory.list', code, message, { projectRoot }, suggestions), options.json);
146
- process.exitCode = 1;
147
- }
148
- }
149
- /**
150
- * Run the memory search subcommand. Extracted so unit tests can
151
- * exercise the full envelope without spawning a subprocess.
152
- */
153
- export async function runMemorySearch(io, options) {
154
- const projectRoot = options.project !== undefined
155
- ? resolveCanonicalProjectRoot(options.project)
156
- : (findProjectRoot(process.cwd()) ?? process.cwd());
157
- const kindFilter = options.kind !== undefined && VALID_KINDS.includes(options.kind)
158
- ? options.kind
159
- : undefined;
160
- try {
161
- const matches = searchMemory({
162
- query: options.query,
163
- projectRoot,
164
- ...(options.limit !== undefined ? { limit: options.limit } : {}),
165
- ...(kindFilter !== undefined ? { kind: kindFilter } : {})
166
- });
167
- printResult(io, ok('memory.search', {
168
- query: options.query,
169
- total: matches.length,
170
- matches,
171
- warnings: []
172
- }, []), options.json);
173
- }
174
- catch (error) {
175
- const message = getErrorMessage(error);
176
- const code = error.code ?? 'MEMORY_SEARCH_FAILED';
177
- const suggestions = [];
178
- if (code === 'INDEX_MISSING') {
179
- suggestions.push('Run `peaks memory extract --apply` to build the index from memory/*.md files');
180
- }
181
- if (code === 'EMPTY_QUERY') {
182
- suggestions.push('Use `peaks memory index` to list all entries');
183
- }
184
- printResult(io, fail('memory.search', code, message, { projectRoot, query: options.query }, suggestions), options.json);
185
- process.exitCode = 1;
186
- }
187
- }
188
- /**
189
- * `peaks memory reindex` — rebuild `.peaks/memory/index.json` from disk and
190
- * regenerate `MEMORY.md`. Dry-run by default; `--apply` writes.
191
- */
192
- export async function runMemoryReindex(io, options) {
193
- const projectRoot = resolveMemoryProjectRoot(options.project);
194
- if (options.dryRun === true && options.apply === true) {
195
- printResult(io, fail('memory.reindex', 'INVALID_MEMORY_REINDEX_FLAGS', 'Use either --dry-run or --apply, not both', {}, ['Run without --apply to preview the drift report, or pass --apply to rebuild']), options.json);
196
- process.exitCode = 1;
197
- return;
198
- }
199
- try {
200
- const report = executeMemoryReindex({ projectRoot, apply: options.apply === true });
201
- const nextActions = [];
202
- if (options.apply !== true) {
203
- nextActions.push('Preview only — re-run with --apply to rebuild index.json and regenerate MEMORY.md.');
204
- }
205
- if (report.unclassified.length > 0) {
206
- nextActions.push(`${report.unclassified.length} file(s) have no resolvable kind; add \`metadata.type\` (or \`kind:\`) to index them.`);
207
- }
208
- if (report.orphanIndex.length > 0) {
209
- nextActions.push(`${report.orphanIndex.length} previous index entry(ies) point at missing files; they are dropped from the rebuilt index.`);
210
- }
211
- if (report.nameConflicts.length > 0) {
212
- nextActions.push(`${report.nameConflicts.length} name collision(s) across files; both entries are kept — rename one file to disambiguate.`);
213
- }
214
- // Slice B: `--summary` keeps the scalar drift counts + names-of-first-N;
215
- // the full report (with every unclassified/orphan path) stays available
216
- // by omitting the flag. Default shape is unchanged.
217
- const data = options.summary === true ? buildMemoryReindexSummary(report) : report;
218
- printResult(io, ok('memory.reindex', data, [], nextActions), options.json);
219
- }
220
- catch (error) {
221
- const message = getErrorMessage(error);
222
- const code = error.code ?? 'MEMORY_REINDEX_FAILED';
223
- printResult(io, fail('memory.reindex', code, message, { projectRoot }, [
224
- 'Check that the project has a readable .peaks/memory directory'
225
- ]), options.json);
226
- process.exitCode = 1;
227
- }
228
- }
229
- /**
230
- * `peaks memory rotate` — tier-driven retention for `.peaks/memory/`.
231
- * Implements the sediment pruning policy (tier 1: archive, never delete).
232
- * Dry-run by default; `--apply` moves tier-C candidates into `archived/`.
233
- */
234
- export async function runMemoryRotate(io, options) {
235
- const projectRoot = resolveMemoryProjectRoot(options.project);
236
- if (options.dryRun === true && options.apply === true) {
237
- printResult(io, fail('memory.rotate', 'INVALID_MEMORY_ROTATE_FLAGS', 'Use either --dry-run or --apply, not both', {}, [
238
- 'Run without --apply to preview the rotation plan, or pass --apply to archive tier-C candidates'
239
- ]), options.json);
240
- process.exitCode = 1;
241
- return;
242
- }
243
- try {
244
- const report = executeMemoryRotate({ projectRoot, apply: options.apply === true });
245
- const nextActions = [];
246
- if (report.refused) {
247
- nextActions.push(`Refused to apply: ${report.refusalReasons.join('; ')}`);
248
- }
249
- else if (options.apply !== true) {
250
- nextActions.push('Preview only — re-run with --apply to move the tier-C candidates into archived/.');
251
- }
252
- if (report.excluded.length > 0) {
253
- nextActions.push(`${report.excluded.length} candidate(s) excluded by a safety gate (see \`excluded\`).`);
254
- }
255
- const deleteCandidates = report.candidates.filter((candidate) => candidate.action === 'delete-candidate');
256
- if (deleteCandidates.length > 0) {
257
- nextActions.push(`${deleteCandidates.length} tier-D file(s) are delete-candidates only; peaks never deletes them — remove by hand if you are sure.`);
258
- }
259
- printResult(io, ok('memory.rotate', report, report.warnings, nextActions), options.json);
260
- if (report.refused)
261
- process.exitCode = 1;
262
- }
263
- catch (error) {
264
- const message = getErrorMessage(error);
265
- const code = error.code ?? 'MEMORY_ROTATE_FAILED';
266
- printResult(io, fail('memory.rotate', code, message, { projectRoot }, [
267
- 'Check that the project has a readable .peaks/memory directory'
268
- ]), options.json);
269
- process.exitCode = 1;
270
- }
271
- }
272
- /**
273
- * `peaks memory ingest` — import memories written by the IDE-side agent into
274
- * `.peaks/memory/`. The IDE-side source is read-only; dry-run by default.
275
- */
276
- export async function runMemoryIngest(io, options) {
277
- const projectRoot = resolveMemoryProjectRoot(options.project);
278
- if (options.dryRun === true && options.apply === true) {
279
- printResult(io, fail('memory.ingest', 'INVALID_MEMORY_INGEST_FLAGS', 'Use either --dry-run or --apply, not both', {}, ['Run without --apply to preview imports, or pass --apply to write them into .peaks/memory']), options.json);
280
- process.exitCode = 1;
281
- return;
282
- }
283
- try {
284
- const report = executeMemoryIngest({
285
- projectRoot,
286
- ...(options.sourceDir !== undefined ? { sourceDir: options.sourceDir } : {}),
287
- apply: options.apply === true
288
- });
289
- const nextActions = [];
290
- if (options.apply !== true && report.imported.length > 0) {
291
- nextActions.push('Preview only — re-run with --apply to write these memories into .peaks/memory.');
292
- }
293
- if (report.conflicts.length > 0) {
294
- nextActions.push(`${report.conflicts.length} conflict(s) left both copies in place; resolve them by hand.`);
295
- }
296
- if (report.needsClassification.length > 0) {
297
- nextActions.push(`${report.needsClassification.length} file(s) could not be classified; add \`metadata.type\` to the source before re-running.`);
298
- }
299
- printResult(io, ok('memory.ingest', report, report.warnings, nextActions), options.json);
300
- }
301
- catch (error) {
302
- const message = getErrorMessage(error);
303
- const code = error.code ?? 'MEMORY_INGEST_FAILED';
304
- printResult(io, fail('memory.ingest', code, message, { projectRoot }, [
305
- 'Check the --source-dir path and that .peaks/memory is writable'
306
- ]), options.json);
307
- process.exitCode = 1;
308
- }
309
- }
1
+ // src/cli/commands/memory-commands.ts
2
+ //
3
+ // The `peaks memory` run functions, one module per verb:
4
+ //
5
+ // read : `memory-list-command.ts`, `memory-search-command.ts`
6
+ // write : `memory-reindex-command.ts`, `memory-rotate-command.ts`,
7
+ // `memory-ingest-command.ts`
8
+ // shared: `memory-command-shared.ts` (option types, project root, failures)
9
+ //
10
+ // The Commander wiring lives in `core/memory-command.ts`, which reaches these
11
+ // functions by dynamic `import('../memory-commands.js')`; this module is the
12
+ // path it names and keeps re-exporting every symbol it used to define, so
13
+ // `tests/unit/cli/commands/summary-flag.test.ts` and
14
+ // `tests/unit/services/context/summary-view.test.ts` need no edit.
15
+ export { buildMemoryListSummary, runMemoryList } from './memory-list-command.js';
16
+ export { buildMemoryReindexSummary, runMemoryReindex } from './memory-reindex-command.js';
17
+ export { runMemoryIngest } from './memory-ingest-command.js';
18
+ export { runMemoryRotate } from './memory-rotate-command.js';
19
+ export { runMemorySearch } from './memory-search-command.js';
@@ -0,0 +1,3 @@
1
+ import { type ProgramIO } from '../cli-helpers.js';
2
+ import { type MemoryIngestCommandOptions } from './memory-command-shared.js';
3
+ export declare function runMemoryIngest(io: ProgramIO, options: MemoryIngestCommandOptions): Promise<void>;
@@ -0,0 +1,50 @@
1
+ // src/cli/commands/memory-ingest-command.ts
2
+ //
3
+ // `peaks memory ingest` — import memories written by the IDE-side agent into
4
+ // `.peaks/memory/`. The IDE-side source is read-only; dry-run by default.
5
+ // Extracted from `memory-commands.ts`; the envelope, the flags and the exported
6
+ // symbol name are unchanged.
7
+ import { fail, ok } from 'peaks-loop-shared/result';
8
+ import { executeMemoryIngest } from '../../services/memory/memory-ingest-service.js';
9
+ import { printResult } from '../cli-helpers.js';
10
+ import { memoryFailure, resolveMemoryProjectRoot } from './memory-command-shared.js';
11
+ export async function runMemoryIngest(io, options) {
12
+ const projectRoot = resolveMemoryProjectRoot(options.project);
13
+ if (options.dryRun === true && options.apply === true) {
14
+ printResult(io, fail('memory.ingest', 'INVALID_MEMORY_INGEST_FLAGS', 'Use either --dry-run or --apply, not both', {}, ['Run without --apply to preview imports, or pass --apply to write them into .peaks/memory']), options.json);
15
+ process.exitCode = 1;
16
+ return;
17
+ }
18
+ try {
19
+ const report = executeMemoryIngest({
20
+ projectRoot,
21
+ ...(options.sourceDir !== undefined ? { sourceDir: options.sourceDir } : {}),
22
+ apply: options.apply === true
23
+ });
24
+ printResult(io, ok('memory.ingest', report, report.warnings, ingestNextActions(report, options)), options.json);
25
+ }
26
+ catch (error) {
27
+ printResult(io, memoryFailure({
28
+ command: 'memory.ingest',
29
+ fallbackCode: 'MEMORY_INGEST_FAILED',
30
+ error,
31
+ projectRoot,
32
+ suggestions: ['Check the --source-dir path and that .peaks/memory is writable']
33
+ }), options.json);
34
+ process.exitCode = 1;
35
+ }
36
+ }
37
+ /** The preview / conflict / unclassified notices the report earns, in order. */
38
+ function ingestNextActions(report, options) {
39
+ const nextActions = [];
40
+ if (options.apply !== true && report.imported.length > 0) {
41
+ nextActions.push('Preview only — re-run with --apply to write these memories into .peaks/memory.');
42
+ }
43
+ if (report.conflicts.length > 0) {
44
+ nextActions.push(`${report.conflicts.length} conflict(s) left both copies in place; resolve them by hand.`);
45
+ }
46
+ if (report.needsClassification.length > 0) {
47
+ nextActions.push(`${report.needsClassification.length} file(s) could not be classified; add \`metadata.type\` to the source before re-running.`);
48
+ }
49
+ return nextActions;
50
+ }
@@ -0,0 +1,16 @@
1
+ import { type MemoryIndexEntry, type MemoryIndexSnapshot, type ProjectMemoryKind } from '../../services/memory/memory-search-service.js';
2
+ import { type ProgramIO } from '../cli-helpers.js';
3
+ import { type MemoryListCommandOptions } from './memory-command-shared.js';
4
+ /**
5
+ * Slice B: bounded view of `memory list`. `count` is the true total; `names`
6
+ * carries `name (kind)` labels for the first N entries.
7
+ */
8
+ export declare function buildMemoryListSummary(data: {
9
+ snapshot: MemoryIndexSnapshot;
10
+ entries: readonly MemoryIndexEntry[];
11
+ kindFilter: ProjectMemoryKind | undefined;
12
+ pickedEntries: readonly MemoryIndexEntry[];
13
+ pickedOutputPath: string | null;
14
+ fzfVersion: string | null;
15
+ }): Record<string, unknown>;
16
+ export declare function runMemoryList(io: ProgramIO, options: MemoryListCommandOptions): Promise<void>;