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,52 @@
1
+ import { execSync } from 'node:child_process';
2
+ import { findProjectRoot } from '../../services/config/config-safety.js';
3
+ import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
4
+ export const DEFAULT_DOCKER_IMAGE = 'node:22-slim';
5
+ export function detectContainerRuntime(explicit) {
6
+ const tryOrder = explicit ? [explicit] : ['docker', 'podman'];
7
+ for (const r of tryOrder) {
8
+ try {
9
+ const version = execSync(`${r} --version`, {
10
+ stdio: ['ignore', 'pipe', 'pipe'],
11
+ encoding: 'utf8',
12
+ windowsHide: true
13
+ }).trim();
14
+ return { ok: true, runtime: r, binary: `${r} (${version.split('\n')[0] ?? ''})` };
15
+ }
16
+ catch {
17
+ /* try next */
18
+ }
19
+ }
20
+ return {
21
+ ok: false,
22
+ stderr: explicit
23
+ ? `explicit --runtime ${explicit} not on PATH`
24
+ : 'neither docker nor podman is on PATH',
25
+ hint: explicit
26
+ ? `Install ${explicit} or pass a different --runtime.`
27
+ : 'Install docker (Docker Desktop on macOS / Windows) or podman (RHEL / Fedora).'
28
+ };
29
+ }
30
+ export function joinPathSession(projectRoot, sessionId) {
31
+ return `${projectRoot.replace(/[\\/]+$/, '')}/.peaks/_runtime/${sessionId}`;
32
+ }
33
+ /**
34
+ * Resolve the project root and session id every container verb works against.
35
+ * The sid falls back through `PEAKS_SESSION_ID` and the canonical binding
36
+ * before the `unknown-sid` sentinel.
37
+ */
38
+ export function resolveContainerTarget(options) {
39
+ const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
40
+ const sessionId = options.session ??
41
+ process.env.PEAKS_SESSION_ID ??
42
+ getCurrentSessionId(projectRoot) ??
43
+ 'unknown-sid';
44
+ return { projectRoot, sessionId };
45
+ }
46
+ export function checkDockerAvailable() {
47
+ // Part 43: superseded by detectContainerRuntime above; this
48
+ // function is preserved for callers that imported it. The
49
+ // container-commands.ts action handlers all use
50
+ // detectContainerRuntime directly.
51
+ return { ok: false, stderr: 'deprecated — use detectContainerRuntime' };
52
+ }
@@ -23,5 +23,5 @@
23
23
  * follow-up rid.
24
24
  */
25
25
  import type { Command } from 'commander';
26
- import { type ProgramIO } from '../cli-helpers.js';
26
+ import type { ProgramIO } from '../cli-helpers.js';
27
27
  export declare function registerContainerCommand(program: Command, io: ProgramIO): void;
@@ -22,224 +22,12 @@
22
22
  * allowing docker-related tool calls. The gate bridge is a
23
23
  * follow-up rid.
24
24
  */
25
- import { execSync } from 'node:child_process';
26
- import { existsSync, readFileSync } from 'node:fs';
27
- import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
28
- import { addJsonOption, printResult } from '../cli-helpers.js';
29
- import { findProjectRoot } from '../../services/config/config-safety.js';
30
- import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
31
- import { atomicWriteJson } from '../../services/ide/shared/atomic-json.js';
32
- import { normalizePath } from '../../shared/path-utils.js';
33
- import { containerLeaseFilePath, deserializeContainerLease, finalizeContainerLease, generateContainerLeaseId, markContainerReleased, ttlForContainerRole } from '../../services/container/container-lease.js';
34
- const DEFAULT_DOCKER_IMAGE = 'node:22-slim';
35
- function detectContainerRuntime(explicit) {
36
- const tryOrder = explicit ? [explicit] : ['docker', 'podman'];
37
- for (const r of tryOrder) {
38
- try {
39
- const version = execSync(`${r} --version`, {
40
- stdio: ['ignore', 'pipe', 'pipe'],
41
- encoding: 'utf8',
42
- windowsHide: true
43
- }).trim();
44
- return { ok: true, runtime: r, binary: `${r} (${version.split('\n')[0] ?? ''})` };
45
- }
46
- catch {
47
- /* try next */
48
- }
49
- }
50
- return {
51
- ok: false,
52
- stderr: explicit
53
- ? `explicit --runtime ${explicit} not on PATH`
54
- : 'neither docker nor podman is on PATH',
55
- hint: explicit
56
- ? `Install ${explicit} or pass a different --runtime.`
57
- : 'Install docker (Docker Desktop on macOS / Windows) or podman (RHEL / Fedora).'
58
- };
59
- }
60
- function joinPathSession(projectRoot, sessionId) {
61
- return `${projectRoot.replace(/[\\/]+$/, '')}/.peaks/_runtime/${sessionId}`;
62
- }
63
- function checkDockerAvailable() {
64
- // Part 43: superseded by detectContainerRuntime above; this
65
- // function is preserved for callers that imported it. The
66
- // container-commands.ts action handlers all use
67
- // detectContainerRuntime directly.
68
- return { ok: false, stderr: 'deprecated — use detectContainerRuntime' };
69
- }
25
+ import { registerContainerReleaseCommand } from './container-release-command.js';
26
+ import { registerContainerSpawnCommand } from './container-spawn-command.js';
70
27
  export function registerContainerCommand(program, io) {
71
28
  const cmd = program
72
29
  .command('container')
73
30
  .description('L4 container isolation: spawn/release container leases (Part 12; pairs with --isolation container on dispatch).');
74
- addJsonOption(cmd
75
- .command('spawn')
76
- .description('Spawn a container via `docker run` and write a container lease. ' +
77
- 'The lease is the source of truth for the L4 PreToolUse gate (Part 12 follow-up). ' +
78
- 'Default TTL is role-aware (rd=30m / qa=15m / ui=1h); pass --ttl <ms> to override. ' +
79
- 'Default image is `node:22-slim`; pass --image <name> to override.')
80
- .requiredOption('--rid <rid>', 'peaks request id the lease is associated with')
81
- .requiredOption('--role <role>', 'sub-agent role (rd | qa | ui | sc | prd | general-purpose)')
82
- .requiredOption('--purpose <text>', 'why this container was spawned (audit log)')
83
- .option('--image <name>', `container image (default ${DEFAULT_DOCKER_IMAGE})`)
84
- .option('--ttl <ms>', 'time-to-live in ms (default role-aware; override with positive number)')
85
- .option('--mount <path>', 'host path to mount as the container working dir (default: <projectRoot>)')
86
- .option('--session <sid>', 'override session id')
87
- .option('--project <path>', 'project root (default: findProjectRoot(cwd))')).action((options) => {
88
- const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
89
- const sessionId = options.session ??
90
- process.env.PEAKS_SESSION_ID ??
91
- getCurrentSessionId(projectRoot) ??
92
- 'unknown-sid';
93
- try {
94
- const explicitRuntime = (() => {
95
- if (options.runtime === 'docker')
96
- return 'docker';
97
- if (options.runtime === 'podman')
98
- return 'podman';
99
- return undefined;
100
- })();
101
- const runtime = detectContainerRuntime(explicitRuntime);
102
- if (!runtime.ok) {
103
- printResult(io, fail('container.spawn', 'CONTAINER_RUNTIME_UNAVAILABLE', `${runtime.stderr}: ${runtime.hint}`, { rid: options.rid, role: options.role, sessionId }, [
104
- 'Install docker (Docker Desktop on macOS / Windows) or podman (RHEL / Fedora).',
105
- 'On Windows, ensure WSL2 backend is enabled and the daemon is running.',
106
- 'Pass --runtime docker|podman to force a specific runtime.'
107
- ]), options.json);
108
- process.exitCode = 1;
109
- return;
110
- }
111
- const leaseId = generateContainerLeaseId();
112
- const now = Date.now();
113
- const ttlMs = options.ttl === undefined
114
- ? ttlForContainerRole(options.role)
115
- : Number.parseInt(options.ttl, 10);
116
- if (!Number.isInteger(ttlMs) || ttlMs <= 0) {
117
- printResult(io, fail('container.spawn', 'INVALID_TTL', '--ttl must be a positive integer (ms)', { ttl: options.ttl }, ['Re-run with --ttl 1800000 (30 min) or omit to use role default.']), options.json);
118
- process.exitCode = 1;
119
- return;
120
- }
121
- const image = options.image ?? DEFAULT_DOCKER_IMAGE;
122
- const mount = options.mount ?? projectRoot;
123
- // `docker run --rm -d` so the container is detached and
124
- // auto-removed when stopped; --cidfile writes the
125
- // container id to a file we can read back. The
126
- // `--label peaks.leaseId=<id>` lets `peaks container
127
- // list` / `peaks container gc` find orphans by label
128
- // when the lease file is missing.
129
- const cidFile = `${normalizePath(joinPathSession(projectRoot, sessionId))}/.${runtime.runtime}-cid-${leaseId}`;
130
- try {
131
- execSync(`${runtime.runtime} run --rm -d --cidfile "${cidFile}" --label "peaks.leaseId=${leaseId}" --label "peaks.rid=${options.rid}" -v "${mount}:/work" -w /work ${image} sleep infinity`, { cwd: projectRoot, stdio: 'pipe', encoding: 'utf8', windowsHide: true });
132
- }
133
- catch (err) {
134
- printResult(io, fail('container.spawn', 'DOCKER_RUN_FAILED', getErrorMessage(err), { rid: options.rid, image, runtime: runtime.runtime, sessionId }, [
135
- 'Verify the image name is reachable on the configured registry.',
136
- 'Verify the host path is mounted correctly (Windows: the path must be visible to WSL2).',
137
- `Run \`${runtime.runtime} ps -a\` to inspect any leftover containers with the peaks.leaseId label.`
138
- ]), options.json);
139
- process.exitCode = 1;
140
- return;
141
- }
142
- const containerId = readFileSync(cidFile, 'utf8').trim();
143
- const lease = finalizeContainerLease({
144
- leaseId,
145
- rid: options.rid,
146
- role: options.role,
147
- path: mount,
148
- image,
149
- containerId,
150
- createdAt: now,
151
- expiresAt: now + ttlMs,
152
- purpose: options.purpose
153
- });
154
- atomicWriteJson(containerLeaseFilePath(joinPathSession(projectRoot, sessionId), leaseId), lease);
155
- printResult(io, ok('container.spawn', {
156
- lease,
157
- sessionId,
158
- projectRoot,
159
- runtime: runtime.runtime,
160
- runtimeVersion: runtime.binary,
161
- nextActions: [
162
- `Container id: ${containerId}`,
163
- `Image: ${image}`,
164
- `Lease expires at: ${new Date(lease.expiresAt).toISOString()}`,
165
- 'Run `peaks container release --lease-id <id>` when done'
166
- ]
167
- }, [], []), options.json);
168
- }
169
- catch (err) {
170
- printResult(io, fail('container.spawn', 'SPAWN_FAILED', getErrorMessage(err), { rid: options.rid, sessionId }, [
171
- 'See error message; if the lease was not written, retry after fixing the underlying issue.'
172
- ]), options.json);
173
- process.exitCode = 1;
174
- }
175
- });
176
- addJsonOption(cmd
177
- .command('release')
178
- .description('Transition a container lease to released and run `docker rm --force`. Idempotent on already-released leases.')
179
- .requiredOption('--lease-id <id>', 'lease id returned by `peaks container spawn`')
180
- .option('--session <sid>', 'override session id')
181
- .option('--project <path>', 'project root (default: findProjectRoot(cwd))')).action((options) => {
182
- const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
183
- const sessionId = options.session ??
184
- process.env.PEAKS_SESSION_ID ??
185
- getCurrentSessionId(projectRoot) ??
186
- 'unknown-sid';
187
- try {
188
- const file = containerLeaseFilePath(joinPathSession(projectRoot, sessionId), options.leaseId);
189
- if (!existsSync(file)) {
190
- printResult(io, fail('container.release', 'LEASE_NOT_FOUND', `no lease on disk at ${file}`, { leaseId: options.leaseId, file }, [
191
- 'Run `peaks container list` to inspect active leases.',
192
- 'For a never-spawned lease, this is a no-op — no further action needed.'
193
- ]), options.json);
194
- process.exitCode = 1;
195
- return;
196
- }
197
- let lease;
198
- try {
199
- lease = deserializeContainerLease(readFileSync(file, 'utf8'));
200
- }
201
- catch (err) {
202
- printResult(io, fail('container.release', 'LEASE_FILE_INVALID', getErrorMessage(err), { leaseId: options.leaseId, file }, [
203
- 'Delete the malformed lease file manually and re-issue spawn.',
204
- 'For security, release never fails open on a malformed lease.'
205
- ]), options.json);
206
- process.exitCode = 1;
207
- return;
208
- }
209
- if (lease.status === 'released') {
210
- printResult(io, ok('container.release', { lease, sessionId, projectRoot, alreadyReleased: true }, [], [`Lease ${lease.leaseId} already released; nothing to do.`]), options.json);
211
- return;
212
- }
213
- let dockerRmFailed = false;
214
- try {
215
- const releaseRuntime = detectContainerRuntime(undefined);
216
- const runtimeCmd = releaseRuntime.ok ? releaseRuntime.runtime : 'docker';
217
- execSync(`${runtimeCmd} rm --force "${lease.containerId}"`, {
218
- cwd: projectRoot,
219
- stdio: 'pipe',
220
- encoding: 'utf8',
221
- windowsHide: true
222
- });
223
- }
224
- catch {
225
- dockerRmFailed = true;
226
- }
227
- const released = markContainerReleased(lease);
228
- atomicWriteJson(file, released);
229
- printResult(io, ok('container.release', { lease: released, sessionId, projectRoot, dockerRmFailed }, dockerRmFailed
230
- ? [
231
- 'docker rm failed (likely the container was already removed); lease marked released.'
232
- ]
233
- : [], [
234
- `Lease ${lease.leaseId} marked released.`,
235
- dockerRmFailed
236
- ? 'Manual `docker ps -a` + `docker rm` may be needed.'
237
- : `Container ${lease.containerId} removed.`
238
- ]), options.json);
239
- }
240
- catch (err) {
241
- printResult(io, fail('container.release', 'RELEASE_FAILED', getErrorMessage(err), { leaseId: options.leaseId, sessionId }, ['Verify the lease id and re-run.', 'If the lease was never spawned, no-op.']), options.json);
242
- process.exitCode = 1;
243
- }
244
- });
31
+ registerContainerSpawnCommand(cmd, io);
32
+ registerContainerReleaseCommand(cmd, io);
245
33
  }
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../cli-helpers.js';
3
+ export declare function registerContainerReleaseCommand(cmd: Command, io: ProgramIO): void;
@@ -0,0 +1,105 @@
1
+ import { execSync } from 'node:child_process';
2
+ import { existsSync, readFileSync } from 'node:fs';
3
+ import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
4
+ import { addJsonOption, printResult } from '../cli-helpers.js';
5
+ import { atomicWriteJson } from '../../services/ide/shared/atomic-json.js';
6
+ import { containerLeaseFilePath, deserializeContainerLease, markContainerReleased } from '../../services/container/container-lease.js';
7
+ import { detectContainerRuntime, joinPathSession, resolveContainerTarget } from './container-command-shared.js';
8
+ export function registerContainerReleaseCommand(cmd, io) {
9
+ addJsonOption(cmd
10
+ .command('release')
11
+ .description('Transition a container lease to released and run `docker rm --force`. Idempotent on already-released leases.')
12
+ .requiredOption('--lease-id <id>', 'lease id returned by `peaks container spawn`')
13
+ .option('--session <sid>', 'override session id')
14
+ .option('--project <path>', 'project root (default: findProjectRoot(cwd))')).action((options) => runContainerRelease(io, options));
15
+ }
16
+ /** Read + parse the lease file; `null` once the refusal is emitted. */
17
+ function readLease(io, options, file) {
18
+ if (!existsSync(file)) {
19
+ printResult(io, fail('container.release', 'LEASE_NOT_FOUND', `no lease on disk at ${file}`, {
20
+ leaseId: options.leaseId,
21
+ file
22
+ }, [
23
+ 'Run `peaks container list` to inspect active leases.',
24
+ 'For a never-spawned lease, this is a no-op — no further action needed.'
25
+ ]), options.json);
26
+ process.exitCode = 1;
27
+ return null;
28
+ }
29
+ try {
30
+ return deserializeContainerLease(readFileSync(file, 'utf8'));
31
+ }
32
+ catch (err) {
33
+ printResult(io, fail('container.release', 'LEASE_FILE_INVALID', getErrorMessage(err), {
34
+ leaseId: options.leaseId,
35
+ file
36
+ }, [
37
+ 'Delete the malformed lease file manually and re-issue spawn.',
38
+ 'For security, release never fails open on a malformed lease.'
39
+ ]), options.json);
40
+ process.exitCode = 1;
41
+ return null;
42
+ }
43
+ }
44
+ /** `docker rm --force`, tolerating a container that is already gone. */
45
+ function removeContainer(lease, projectRoot) {
46
+ try {
47
+ const detected = detectContainerRuntime(undefined);
48
+ const runtimeCmd = detected.ok ? detected.runtime : 'docker';
49
+ execSync(`${runtimeCmd} rm --force "${lease.containerId}"`, {
50
+ cwd: projectRoot,
51
+ stdio: 'pipe',
52
+ encoding: 'utf8',
53
+ windowsHide: true
54
+ });
55
+ return false;
56
+ }
57
+ catch {
58
+ return true;
59
+ }
60
+ }
61
+ function runContainerRelease(io, options) {
62
+ const { projectRoot, sessionId } = resolveContainerTarget(options);
63
+ try {
64
+ const file = containerLeaseFilePath(joinPathSession(projectRoot, sessionId), options.leaseId);
65
+ const lease = readLease(io, options, file);
66
+ if (lease === null)
67
+ return;
68
+ if (lease.status === 'released') {
69
+ printResult(io, ok('container.release', { lease, sessionId, projectRoot, alreadyReleased: true }, [], [`Lease ${lease.leaseId} already released; nothing to do.`]), options.json);
70
+ return;
71
+ }
72
+ const outcome = releaseLease({ options, io, projectRoot, sessionId, file, lease });
73
+ printResult(io, ok('container.release', outcome.data, outcome.warnings, outcome.nextActions), options.json);
74
+ }
75
+ catch (err) {
76
+ printResult(io, fail('container.release', 'RELEASE_FAILED', getErrorMessage(err), {
77
+ leaseId: options.leaseId,
78
+ sessionId
79
+ }, ['Verify the lease id and re-run.', 'If the lease was never spawned, no-op.']), options.json);
80
+ process.exitCode = 1;
81
+ }
82
+ }
83
+ /**
84
+ * `docker rm --force` the container, flip the lease to released and write it
85
+ * back. A failed `docker rm` is reported, not fatal: the lease is the source
86
+ * of truth and it is still marked released.
87
+ */
88
+ function releaseLease(plan) {
89
+ const { projectRoot, sessionId, file, lease } = plan;
90
+ const dockerRmFailed = removeContainer(lease, projectRoot);
91
+ const released = markContainerReleased(lease);
92
+ atomicWriteJson(file, released);
93
+ return {
94
+ data: { lease: released, sessionId, projectRoot, dockerRmFailed },
95
+ warnings: dockerRmFailed
96
+ ? ['docker rm failed (likely the container was already removed); lease marked released.']
97
+ : [],
98
+ nextActions: [
99
+ `Lease ${lease.leaseId} marked released.`,
100
+ dockerRmFailed
101
+ ? 'Manual `docker ps -a` + `docker rm` may be needed.'
102
+ : `Container ${lease.containerId} removed.`
103
+ ]
104
+ };
105
+ }
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../cli-helpers.js';
3
+ export declare function registerContainerSpawnCommand(cmd: Command, io: ProgramIO): void;
@@ -0,0 +1,148 @@
1
+ import { execSync } from 'node:child_process';
2
+ import { readFileSync } from 'node:fs';
3
+ import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
4
+ import { addJsonOption, printResult } from '../cli-helpers.js';
5
+ import { atomicWriteJson } from '../../services/ide/shared/atomic-json.js';
6
+ import { normalizePath } from '../../shared/path-utils.js';
7
+ import { containerLeaseFilePath, finalizeContainerLease, generateContainerLeaseId, ttlForContainerRole } from '../../services/container/container-lease.js';
8
+ import { DEFAULT_DOCKER_IMAGE, detectContainerRuntime, joinPathSession, resolveContainerTarget } from './container-command-shared.js';
9
+ export function registerContainerSpawnCommand(cmd, io) {
10
+ addJsonOption(cmd
11
+ .command('spawn')
12
+ .description('Spawn a container via `docker run` and write a container lease. ' +
13
+ 'The lease is the source of truth for the L4 PreToolUse gate (Part 12 follow-up). ' +
14
+ 'Default TTL is role-aware (rd=30m / qa=15m / ui=1h); pass --ttl <ms> to override. ' +
15
+ 'Default image is `node:22-slim`; pass --image <name> to override.')
16
+ .requiredOption('--rid <rid>', 'peaks request id the lease is associated with')
17
+ .requiredOption('--role <role>', 'sub-agent role (rd | qa | ui | sc | prd | general-purpose)')
18
+ .requiredOption('--purpose <text>', 'why this container was spawned (audit log)')
19
+ .option('--image <name>', `container image (default ${DEFAULT_DOCKER_IMAGE})`)
20
+ .option('--ttl <ms>', 'time-to-live in ms (default role-aware; override with positive number)')
21
+ .option('--mount <path>', 'host path to mount as the container working dir (default: <projectRoot>)')
22
+ .option('--session <sid>', 'override session id')
23
+ .option('--project <path>', 'project root (default: findProjectRoot(cwd))')).action((options) => runContainerSpawn(io, options));
24
+ }
25
+ /** The `--runtime` flag, narrowed to the two runtimes the adapter supports. */
26
+ function explicitRuntimeOf(options) {
27
+ if (options.runtime === 'docker')
28
+ return 'docker';
29
+ if (options.runtime === 'podman')
30
+ return 'podman';
31
+ return undefined;
32
+ }
33
+ /** Refuse `--runtime` when neither binary answers; `null` once refused. */
34
+ function requireRuntime(options, io, projectRoot, sessionId) {
35
+ const detected = detectContainerRuntime(explicitRuntimeOf(options));
36
+ if (detected.ok)
37
+ return detected;
38
+ printResult(io, fail('container.spawn', 'CONTAINER_RUNTIME_UNAVAILABLE', `${detected.stderr}: ${detected.hint}`, { rid: options.rid, role: options.role, sessionId }, [
39
+ 'Install docker (Docker Desktop on macOS / Windows) or podman (RHEL / Fedora).',
40
+ 'On Windows, ensure WSL2 backend is enabled and the daemon is running.',
41
+ 'Pass --runtime docker|podman to force a specific runtime.'
42
+ ]), options.json);
43
+ process.exitCode = 1;
44
+ return null;
45
+ }
46
+ /** Resolve `--ttl`, refusing a non-positive integer; `null` once refused. */
47
+ function requireTtl(options, io) {
48
+ const ttlMs = options.ttl === undefined
49
+ ? ttlForContainerRole(options.role)
50
+ : Number.parseInt(options.ttl, 10);
51
+ if (Number.isInteger(ttlMs) && ttlMs > 0)
52
+ return ttlMs;
53
+ printResult(io, fail('container.spawn', 'INVALID_TTL', '--ttl must be a positive integer (ms)', { ttl: options.ttl }, ['Re-run with --ttl 1800000 (30 min) or omit to use role default.']), options.json);
54
+ process.exitCode = 1;
55
+ return null;
56
+ }
57
+ /** The worker root the cidfile lives in; `normalizePath` keeps Windows paths sane. */
58
+ function cidFileFor(plan) {
59
+ const root = normalizePath(joinPathSession(plan.projectRoot, plan.sessionId));
60
+ return `${root}/.${plan.detected.runtime}-cid-${plan.leaseId}`;
61
+ }
62
+ /**
63
+ * `docker run --rm -d` so the container is detached and auto-removed when
64
+ * stopped; `--cidfile` writes the container id to a file we read back. The
65
+ * `--label peaks.leaseId=<id>` lets `peaks container list` / `peaks container gc`
66
+ * find orphans by label when the lease file is missing.
67
+ *
68
+ * Returns the container id, or `null` once DOCKER_RUN_FAILED is emitted.
69
+ */
70
+ function runDockerSpawn(plan) {
71
+ const { options, io, projectRoot, detected, image, mount } = plan;
72
+ const cidFile = cidFileFor(plan);
73
+ try {
74
+ execSync(`${detected.runtime} run --rm -d --cidfile "${cidFile}" --label "peaks.leaseId=${plan.leaseId}" --label "peaks.rid=${options.rid}" -v "${mount}:/work" -w /work ${image} sleep infinity`, { cwd: projectRoot, stdio: 'pipe', encoding: 'utf8', windowsHide: true });
75
+ }
76
+ catch (err) {
77
+ printResult(io, fail('container.spawn', 'DOCKER_RUN_FAILED', getErrorMessage(err), { rid: options.rid, image, runtime: detected.runtime, sessionId: plan.sessionId }, [
78
+ 'Verify the image name is reachable on the configured registry.',
79
+ 'Verify the host path is mounted correctly (Windows: the path must be visible to WSL2).',
80
+ `Run \`${detected.runtime} ps -a\` to inspect any leftover containers with the peaks.leaseId label.`
81
+ ]), options.json);
82
+ process.exitCode = 1;
83
+ return null;
84
+ }
85
+ return readFileSync(cidFile, 'utf8').trim();
86
+ }
87
+ /** Write the lease and print the success envelope. */
88
+ function finishSpawn(plan, containerId) {
89
+ const { options, io, projectRoot, sessionId, detected, image, mount, leaseId, now, ttlMs } = plan;
90
+ const lease = finalizeContainerLease({
91
+ leaseId,
92
+ rid: options.rid,
93
+ role: options.role,
94
+ path: mount,
95
+ image,
96
+ containerId,
97
+ createdAt: now,
98
+ expiresAt: now + ttlMs,
99
+ purpose: options.purpose
100
+ });
101
+ atomicWriteJson(containerLeaseFilePath(joinPathSession(projectRoot, sessionId), leaseId), lease);
102
+ printResult(io, ok('container.spawn', {
103
+ lease,
104
+ sessionId,
105
+ projectRoot,
106
+ runtime: detected.runtime,
107
+ runtimeVersion: detected.binary,
108
+ nextActions: [
109
+ `Container id: ${containerId}`,
110
+ `Image: ${image}`,
111
+ `Lease expires at: ${new Date(lease.expiresAt).toISOString()}`,
112
+ 'Run `peaks container release --lease-id <id>` when done'
113
+ ]
114
+ }, [], []), options.json);
115
+ }
116
+ function runContainerSpawn(io, options) {
117
+ const { projectRoot, sessionId } = resolveContainerTarget(options);
118
+ try {
119
+ const detected = requireRuntime(options, io, projectRoot, sessionId);
120
+ if (detected === null)
121
+ return;
122
+ const ttlMs = requireTtl(options, io);
123
+ if (ttlMs === null)
124
+ return;
125
+ const plan = {
126
+ options,
127
+ io,
128
+ projectRoot,
129
+ sessionId,
130
+ detected,
131
+ image: options.image ?? DEFAULT_DOCKER_IMAGE,
132
+ mount: options.mount ?? projectRoot,
133
+ leaseId: generateContainerLeaseId(),
134
+ now: Date.now(),
135
+ ttlMs
136
+ };
137
+ const containerId = runDockerSpawn(plan);
138
+ if (containerId === null)
139
+ return;
140
+ finishSpawn(plan, containerId);
141
+ }
142
+ catch (err) {
143
+ printResult(io, fail('container.spawn', 'SPAWN_FAILED', getErrorMessage(err), { rid: options.rid, sessionId }, [
144
+ 'See error message; if the lease was not written, retry after fixing the underlying issue.'
145
+ ]), options.json);
146
+ process.exitCode = 1;
147
+ }
148
+ }
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../cli-helpers.js';
3
+ export declare function registerContextCheckCommand(context: Command, io: ProgramIO): void;
@@ -0,0 +1,81 @@
1
+ import { fail, ok } from 'peaks-loop-shared/result';
2
+ import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
3
+ import { formatMainSessionTriggerLogLine, pickMainSessionTrigger } from '../../services/context/main-session-monitor.js';
4
+ import { emitObservabilityEvent } from '../../services/observability/observability-service.js';
5
+ import { findProjectRoot } from '../../services/config/config-safety.js';
6
+ import { getSessionIdCanonical } from '../../services/session/session-manager.js';
7
+ import { capacityOf, requirePromptSize } from './context-status-command.js';
8
+ /** The `--in-flight-batch` seam: a sub-agent batch defers the trigger (D6.e). */
9
+ function inFlightOf(opts) {
10
+ return opts.inFlightBatch === true
11
+ ? { hasInFlightBatch: true, sharedChannelEntries: 1 }
12
+ : undefined;
13
+ }
14
+ /**
15
+ * Observability hook #5/7. Fire-and-forget per PRD Q4; the synchronous emit
16
+ * never throws. Only fires when a session id is resolvable.
17
+ */
18
+ function emitContextTrigger(trigger, promptSize) {
19
+ const projectRoot = findProjectRoot(process.cwd()) ?? process.cwd();
20
+ const sid = getSessionIdCanonical(projectRoot) ?? '';
21
+ if (sid.length === 0)
22
+ return;
23
+ emitObservabilityEvent({
24
+ schemaVersion: 1,
25
+ ts: new Date().toISOString(),
26
+ sessionId: sid,
27
+ category: 'context-trigger',
28
+ detail: {
29
+ kind: trigger.kind,
30
+ promptSize,
31
+ ...(trigger.kind === 'soft-warn' || trigger.kind === 'compact'
32
+ ? { ratio: trigger.ratio }
33
+ : {})
34
+ }
35
+ }, { projectRoot });
36
+ }
37
+ /** The single advisory line the tier decides. */
38
+ function triggerAdvice(trigger) {
39
+ if (trigger.kind === 'compact') {
40
+ return `Tier reached → trigger ${trigger.path} on ${trigger.ide} (code=${trigger.code})`;
41
+ }
42
+ if (trigger.kind === 'defer')
43
+ return `Deferred: ${trigger.reason}`;
44
+ if (trigger.kind === 'soft-warn') {
45
+ return `Soft warning at ${(trigger.ratio * 100).toFixed(0)}% (no trigger yet)`;
46
+ }
47
+ return 'Below threshold; no trigger';
48
+ }
49
+ export function registerContextCheckCommand(context, io) {
50
+ addJsonOption(context
51
+ .command('check')
52
+ .description('v2.11.0 D6: threshold check + IDE-aware trigger dispatch. With --auto-trigger, returns the trigger path the LLM should follow; without, returns a dry-run recommendation. The LLM is responsible for actually invoking the trigger (slash command, self-compress, or escalation).')
53
+ .requiredOption('--prompt-size <bytes>', 'estimated prompt size in bytes')
54
+ .option('--capacity <bytes>', 'override the 256K default capacity (test seam)', '262144')
55
+ .option('--in-flight-batch', 'a sub-agent batch is in flight (defer trigger per D6.e)', false)
56
+ .option('--auto-trigger', 'return the trigger path the LLM should follow', false)).action((opts) => {
57
+ try {
58
+ const promptSize = requirePromptSize('context.check', opts, io);
59
+ if (promptSize === null)
60
+ return;
61
+ const trigger = pickMainSessionTrigger({
62
+ promptSize,
63
+ capacityBytes: capacityOf(opts),
64
+ inFlightBatch: inFlightOf(opts)
65
+ });
66
+ emitContextTrigger(trigger, promptSize);
67
+ const payload = {
68
+ ...trigger,
69
+ autoTrigger: opts.autoTrigger === true,
70
+ logLine: formatMainSessionTriggerLogLine(trigger, 'main')
71
+ };
72
+ printResult(io, ok('context.check', payload, [], [triggerAdvice(trigger)]), opts.json);
73
+ }
74
+ catch (err) {
75
+ printResult(io, fail('context.check', 'CONTEXT_CHECK_FAILED', getErrorMessage(err), null, [
76
+ 'Verify --prompt-size is a non-negative number'
77
+ ]), opts.json);
78
+ process.exitCode = 1;
79
+ }
80
+ });
81
+ }
@@ -1,11 +1,6 @@
1
1
  /**
2
2
  * peaks context * CLI (Slice #3 L1c) — context 4-layer loader.
3
3
  *
4
- * - L0: full read (every SKILL.md in full)
5
- * - L1: summary (one paragraph per skill + the skill list)
6
- * - L2: index (just names + paths)
7
- * - L3: fuzzy search by query (delegates to peaks memory search)
8
- *
9
4
  * The LLM-side UX layer (peaks-code / peaks-ide) picks the layer based
10
5
  * on the L1a task level:
11
6
  * - typo: L0 only (a few lines)
@@ -15,6 +10,6 @@
15
10
  * - migration: L0 + L1 + L2 + L3 + codegraph
16
11
  */
17
12
  import type { Command } from 'commander';
18
- import { type ProgramIO } from '../cli-helpers.js';
19
- export type ContextLayer = 'L0' | 'L1' | 'L2' | 'L3';
13
+ import type { ProgramIO } from '../cli-helpers.js';
14
+ export type { ContextLayer } from './context-layer-fetchers.js';
20
15
  export declare function registerContextCommands(program: Command, io: ProgramIO): void;