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,144 @@
1
+ // src/cli/commands/contract-write-command.ts
2
+ //
3
+ // `peaks contract write` — persist a finished slice's public surface (exports /
4
+ // types / publicSignatures) to
5
+ // `.peaks/_runtime/<sessionId>/dispatch/contracts/<slice-id>.json`, where the
6
+ // orchestrator picks it up on the next dispatch run. Extracted from
7
+ // `governance-classify-contract-commands.ts` (which had merged
8
+ // `contract-commands.ts` and `classify-classify-commands.ts` verbatim); the
9
+ // registered name, description, options, refusal codes and envelope are
10
+ // unchanged.
11
+ //
12
+ // The guards and the write are separate functions because the merged file had
13
+ // all three inline in one 151-line registrar, and every branch there was over
14
+ // the per-function line cap on its own.
15
+ import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
16
+ import { writeContract } from '../../services/dispatch/contract-store.js';
17
+ import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
18
+ import { addJsonOption, printResult } from '../cli-helpers.js';
19
+ const INPUT_LIMIT_BYTES = 256 * 1024;
20
+ /** Split a comma-separated flag value into a trimmed string array. */
21
+ function splitCsv(value) {
22
+ if (value === undefined)
23
+ return [];
24
+ return value
25
+ .split(',')
26
+ .map((s) => s.trim())
27
+ .filter((s) => s.length > 0);
28
+ }
29
+ export function registerContractCommands(program, io) {
30
+ const contract = program
31
+ .command('contract')
32
+ .description('Slice contract store (skill-first / CLI-auxiliary). These commands ' +
33
+ 'are primitives that peaks-code / peaks-rd SKILL.md compose. The LLM-side ' +
34
+ 'runner (the IDE-resident sub-agent that finished a slice) calls ' +
35
+ "`peaks contract write` to persist the slice's public surface; the " +
36
+ 'orchestrator picks it up on the next dispatch run via listContracts() ' +
37
+ 'and splices it into downstream prompts via formatContractInjection().');
38
+ addJsonOption(contractWriteCommand(contract)).action((options) => {
39
+ const envelope = contractWriteEnvelope(options);
40
+ printResult(io, envelope, options.json === true);
41
+ if (!envelope.ok)
42
+ process.exitCode = 1;
43
+ });
44
+ }
45
+ // peaks contract write --project <root> --session-id <sid>
46
+ // --slice-id <id> --exports <a,b> --types <x,y> --signatures <s1,s2>
47
+ // [--broadcast-to <b1,b2>] [--completed-at <iso>]
48
+ function contractWriteCommand(contract) {
49
+ return contract
50
+ .command('write')
51
+ .description("2.7.0 slice-dag-dispatcher MVP: persist a finished slice's public " +
52
+ 'surface (exports / types / publicSignatures) to disk at ' +
53
+ '.peaks/_runtime/<sessionId>/dispatch/contracts/<slice-id>.json. ' +
54
+ 'The orchestrator picks it up on the next dispatch run. Idempotent: ' +
55
+ 're-running with the same inputs overwrites in place; the SHA-256 ' +
56
+ 'contractHash is content-derived so a contract write from a different ' +
57
+ 'runner (re-execution) is detected as a content change.')
58
+ .option('--project <path>', 'target project root (defaults to cwd)')
59
+ .option('--session-id <sid>', 'session id (default: resolve from .peaks/_runtime/session.json; falls back to PEAKS_SESSION_ID env var; final fallback "unknown-sid")')
60
+ .requiredOption('--slice-id <id>', 'slice id; must be non-empty; used as the contract filename basename')
61
+ .option('--exports <list>', 'comma-separated public export names (e.g. "validateDag,topologicalLevels")')
62
+ .option('--types <list>', 'comma-separated public type names (e.g. "SliceDag,SliceNode")')
63
+ .option('--signatures <list>', 'comma-separated public function/method signatures (e.g. "validateDag(dag: SliceDag): void")')
64
+ .option('--broadcast-to <list>', 'comma-separated downstream slice ids that should auto-inherit this contract (e.g. "B,C")')
65
+ .option('--completed-at <iso>', 'ISO 8601 timestamp; defaults to now()');
66
+ }
67
+ /** The written-contract envelope, or the refusal the caller earned. */
68
+ function contractWriteEnvelope(options) {
69
+ const projectRoot = options.project ?? process.cwd();
70
+ const sid = options.sessionId ??
71
+ process.env['PEAKS_SESSION_ID'] ??
72
+ getCurrentSessionId(projectRoot) ??
73
+ 'unknown-sid';
74
+ const lists = {
75
+ exports: splitCsv(options.exports),
76
+ types: splitCsv(options.types),
77
+ signatures: splitCsv(options.signatures),
78
+ broadcastTo: splitCsv(options.broadcastTo)
79
+ };
80
+ const refusal = contractWriteRefusal(options, sid, lists);
81
+ if (refusal !== null)
82
+ return refusal;
83
+ try {
84
+ const result = writeContract(projectRoot, sid, contractWriteInput(options, sid, lists));
85
+ return ok('contract.write', contractWriteData(result), [], [
86
+ 'Contract written; orchestrator will pick it up on the next `peaks sub-agent dispatch --from-dag` run.',
87
+ 'Re-running with the same inputs is idempotent (overwrites in place).'
88
+ ]);
89
+ }
90
+ catch (err) {
91
+ return fail('contract.write', 'WRITE_ERROR', getErrorMessage(err), { path: null, contract: null }, [
92
+ 'See error message; check that --project is a writable directory and --slice-id is a valid filename basename (no path separators).'
93
+ ]);
94
+ }
95
+ }
96
+ /**
97
+ * The `writeContract` input: `--broadcast-to` and `--completed-at` ride only
98
+ * when the caller set them, so an absent flag never becomes an empty value.
99
+ */
100
+ function contractWriteInput(options, sid, lists) {
101
+ return {
102
+ // The refusal above already rejected `undefined` / empty.
103
+ sliceId: options.sliceId,
104
+ sessionId: sid,
105
+ exports: lists.exports,
106
+ types: lists.types,
107
+ publicSignatures: lists.signatures,
108
+ ...(lists.broadcastTo.length > 0 ? { broadcastTo: lists.broadcastTo } : {}),
109
+ ...(options.completedAt !== undefined ? { completedAt: options.completedAt } : {})
110
+ };
111
+ }
112
+ /** The written contract, counted per surface — never the raw store row. */
113
+ function contractWriteData(result) {
114
+ return {
115
+ path: result.path,
116
+ contractHash: result.contract.contractHash,
117
+ sliceId: result.contract.sliceId,
118
+ sessionId: result.contract.sessionId,
119
+ completedAt: result.contract.completedAt,
120
+ exportCount: result.contract.exports.length,
121
+ typeCount: result.contract.types.length,
122
+ signatureCount: result.contract.publicSignatures.length,
123
+ broadcastTo: result.contract.broadcastTo ?? []
124
+ };
125
+ }
126
+ /** The two pre-write refusals (missing slice id, oversized input), or `null`. */
127
+ function contractWriteRefusal(options, sid, lists) {
128
+ const sliceId = options.sliceId;
129
+ if (sliceId === undefined || sliceId.length === 0) {
130
+ return fail('contract.write', 'MISSING_SLICE_ID', '--slice-id is required', { path: null, contract: null }, ['Re-run with --slice-id <id> (must be non-empty; used as the contract filename basename).']);
131
+ }
132
+ // Cap the combined input to protect the file IO from runaway values
133
+ // (e.g. a 10MB comma-separated --signatures flag).
134
+ const inputSize = sliceId.length +
135
+ sid.length +
136
+ lists.exports.join(',').length +
137
+ lists.types.join(',').length +
138
+ lists.signatures.join(',').length +
139
+ lists.broadcastTo.join(',').length +
140
+ (options.completedAt?.length ?? 0);
141
+ if (inputSize <= INPUT_LIMIT_BYTES)
142
+ return null;
143
+ return fail('contract.write', 'INPUT_TOO_LARGE', `combined input size ${inputSize} bytes exceeds ${INPUT_LIMIT_BYTES} (likely oversized --exports/--types/--signatures lists)`, { path: null, contract: null }, ['Split the slice into smaller surfaces or omit optional fields.']);
144
+ }
@@ -0,0 +1,17 @@
1
+ export type BindingSource = 'canonical' | 'legacy';
2
+ /** One stale entry in the project-level binding. */
3
+ export type StaleInstance = {
4
+ sid: string;
5
+ callerId: string;
6
+ lastHeartbeat: string;
7
+ };
8
+ export declare const STALE_TTL_MS = 300000;
9
+ export declare function listStaleInstances(projectRoot: string, ttlMs?: number): StaleInstance[];
10
+ /** The `staleBinding` block every doctor envelope carries. */
11
+ export declare function staleBindingSection(ttlMs: number, staleInstances: readonly StaleInstance[], droppedStale: readonly string[]): {
12
+ ttlMs: number;
13
+ staleCount: number;
14
+ staleInstances: readonly StaleInstance[];
15
+ droppedCount: number;
16
+ droppedSids: readonly string[];
17
+ };
@@ -0,0 +1,30 @@
1
+ import { readBinding } from '../../../services/session/binding-store.js';
2
+ // threshold is exposed as a CLI flag so users can tune it for
3
+ // long-running sessions. 300000 ms = 5 minutes.
4
+ export const STALE_TTL_MS = 300_000;
5
+ // in the project-level binding. Used by `peaks doctor` and surfaced as
6
+ // a warning in the report. Returns the stale entry descriptors.
7
+ export function listStaleInstances(projectRoot, ttlMs = STALE_TTL_MS) {
8
+ const binding = readBinding(projectRoot);
9
+ if (!binding)
10
+ return [];
11
+ const cutoff = Date.now() - ttlMs;
12
+ const stale = [];
13
+ for (const [sid, inst] of Object.entries(binding.instances)) {
14
+ const t = Date.parse(inst.lastHeartbeat);
15
+ if (Number.isFinite(t) && t < cutoff) {
16
+ stale.push({ sid, callerId: inst.callerId, lastHeartbeat: inst.lastHeartbeat });
17
+ }
18
+ }
19
+ return stale;
20
+ }
21
+ /** The `staleBinding` block every doctor envelope carries. */
22
+ export function staleBindingSection(ttlMs, staleInstances, droppedStale) {
23
+ return {
24
+ ttlMs,
25
+ staleCount: staleInstances.length,
26
+ staleInstances,
27
+ droppedCount: droppedStale.length,
28
+ droppedSids: droppedStale
29
+ };
30
+ }
@@ -1,18 +1,4 @@
1
- import type { Command } from 'commander';
2
- import { type ProgramIO } from '../../cli-helpers.js';
3
- /**
4
- * the doctor envelope. The `checks` array (one object per check, each with a
5
- * full message) and the stale-binding instance list collapse to counts +
6
- * names-of-first-N; the summary counters and log section are scalars and are
7
- * kept verbatim. ≤ 2 KB by construction.
8
- */
9
- export declare function buildDoctorSummary(data: Record<string, unknown>): Record<string, unknown>;
10
- export type BindingSource = 'canonical' | 'legacy';
11
- export type DoctorLogsSection = {
12
- logDir: string;
13
- todayFile: string;
14
- sizeBytes: number;
15
- retentionDays: number;
16
- level: string;
17
- };
18
- export declare function registerDoctorCommand(program: Command, io: ProgramIO): void;
1
+ export type { BindingSource, StaleInstance } from './doctor-bindings.js';
2
+ export type { DoctorLogsSection } from './doctor-logs.js';
3
+ export { buildDoctorSummary } from './doctor-summary.js';
4
+ export { registerDoctorCommand } from './doctor-run-command.js';
@@ -1,323 +1,2 @@
1
- import { runDoctor } from '../../../services/doctor/index.js';
2
- import { readBinding, dropStale, rebuildBindingFromLegacy } from '../../../services/session/binding-store.js';
3
- import { findProjectRoot } from '../../../services/config/config-safety.js';
4
- import { loadSkillRegistry } from '../../../services/skills/skill-registry.js';
5
- import { planStatusLineInstall } from '../../../services/skills/statusline-settings-service.js';
6
- import { addJsonOption, printResult } from '../../cli-helpers.js';
7
- import { boundedNames, fitSummaryToBytes } from '../../../services/context/summary-view.js';
8
- import { fail, ok } from 'peaks-loop-shared/result';
9
- // slice-3b Option C: the doctor subpackage owns the check pipeline but
10
- // does NOT import cross-domain utils from the main package (avoids
11
- // circular deps). The CLI is the natural wiring point — every cross-
12
- // domain util the doctor used to import directly is now injected as a
13
- // probe on DoctorOptions at call-site:
14
- //
15
- // loadSkills ← loadSkillRegistry (main/services/skills/skill-registry.ts)
16
- // skillPresenceProbe ← leave as-is; doctor-command does not own the presence probe
17
- // statusLineInstalledProbe ← defaults to a `planStatusLineInstall` wrapper below
18
- // projectRootResolver ← findProjectRoot (main/services/config/config-safety.ts)
19
- // isValidSessionIdProbe ← the regex kept in main/services/workspace/sid-naming-guard.ts
20
- //
21
- // Inlining isValidSessionId via the doctor subpackage's default regex
22
- // (which mirrors the upstream file byte-for-byte) keeps the L3 orphan
23
- // check behaviour-identical without dragging sid-naming-guard into a
24
- // workspace package. If sid-naming-guard is ever moved into
25
- // peaks-loop-shared, swap this for a re-import.
26
- function doctorIsValidSessionId(sid) {
27
- return /^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])-session-[0-9a-z]{3,6}$/.test(sid);
28
- }
29
- function statusLineAlreadyInstalledForScope(scope, projectRoot) {
30
- try {
31
- if (scope === 'project') {
32
- if (projectRoot === undefined)
33
- return false;
34
- return planStatusLineInstall('project', projectRoot).alreadyInstalled;
35
- }
36
- return planStatusLineInstall('global').alreadyInstalled;
37
- }
38
- catch {
39
- return false;
40
- }
41
- }
42
- /**
43
- * the doctor envelope. The `checks` array (one object per check, each with a
44
- * full message) and the stale-binding instance list collapse to counts +
45
- * names-of-first-N; the summary counters and log section are scalars and are
46
- * kept verbatim. ≤ 2 KB by construction.
47
- */
48
- export function buildDoctorSummary(data) {
49
- const checks = Array.isArray(data.checks)
50
- ? data.checks
51
- : [];
52
- const label = (c) => {
53
- const id = typeof c.id === 'string' ? c.id : 'unknown';
54
- if (c.ok === true)
55
- return `ok ${id}`;
56
- return `${c.severity === 'warning' ? 'warn' : 'FAIL'} ${id}`;
57
- };
58
- const failed = checks.filter((c) => c.ok === false);
59
- const stale = typeof data.staleBinding === 'object' && data.staleBinding !== null
60
- ? data.staleBinding
61
- : null;
62
- const view = {
63
- view: 'summary',
64
- summary: data.summary,
65
- checks: boundedNames(checks.map(label)),
66
- failed: boundedNames(failed.map((c) => `${typeof c.id === 'string' ? c.id : 'unknown'}: ${typeof c.message === 'string' ? c.message : ''}`))
67
- };
68
- if (stale !== null) {
69
- view.staleBinding = {
70
- ttlMs: stale.ttlMs,
71
- staleCount: stale.staleCount,
72
- droppedCount: stale.droppedCount,
73
- droppedSids: boundedNames(Array.isArray(stale.droppedSids) ? stale.droppedSids.map((s) => String(s)) : [])
74
- };
75
- }
76
- if (data.logs !== undefined)
77
- view.logs = data.logs;
78
- return fitSummaryToBytes(view);
79
- }
80
- function doctorStatusLineInstalledProbe() {
81
- const projectRoot = findProjectRoot(process.cwd());
82
- // Check both scopes: a user may have installed the statusLine globally, which
83
- // the project-only check would miss and falsely report as "not installed".
84
- try {
85
- if (projectRoot !== null && statusLineAlreadyInstalledForScope('project', projectRoot)) {
86
- return true;
87
- }
88
- }
89
- catch {
90
- // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
91
- /* fall through to global */
92
- }
93
- try {
94
- return statusLineAlreadyInstalledForScope('global');
95
- }
96
- catch {
97
- return false;
98
- }
99
- }
100
- // threshold is exposed as a CLI flag so users can tune it for
101
- // long-running sessions.
102
- const STALE_TTL_MS = 5 * 60 * 1000;
103
- // in the project-level binding. Used by `peaks doctor` and surfaced as
104
- // a warning in the report. Returns the stale entry descriptors.
105
- function listStaleInstances(projectRoot, ttlMs = STALE_TTL_MS) {
106
- const binding = readBinding(projectRoot);
107
- if (!binding)
108
- return [];
109
- const cutoff = Date.now() - ttlMs;
110
- const stale = [];
111
- for (const [sid, inst] of Object.entries(binding.instances)) {
112
- const t = Date.parse(inst.lastHeartbeat);
113
- if (Number.isFinite(t) && t < cutoff) {
114
- stale.push({ sid, callerId: inst.callerId, lastHeartbeat: inst.lastHeartbeat });
115
- }
116
- }
117
- return stale;
118
- }
119
- //
120
- // `buildDoctorLogsSection` reads the on-disk log dir and returns the
121
- // metadata the doctor needs to render the "logs" block. It is
122
- // extracted from the inline `peaks doctor --log` action so the
123
- // command stays small and the helper is unit-testable without
124
- // spinning up the full program.
125
- async function buildDoctorLogsSection() {
126
- // Lazy imports to avoid a circular dep at module-load time
127
- // (core-artifact-commands is imported very early in program.ts).
128
- const { resolveLogDir, buildLogFileName } = await import('../../../services/log/logger.js');
129
- const { statSync, existsSync } = await import('node:fs');
130
- const { join } = await import('node:path');
131
- const logDir = resolveLogDir();
132
- const todayFile = buildLogFileName(new Date());
133
- const fullPath = join(logDir, todayFile);
134
- let sizeBytes = 0;
135
- if (existsSync(fullPath)) {
136
- try {
137
- sizeBytes = statSync(fullPath).size;
138
- }
139
- catch {
140
- sizeBytes = 0;
141
- }
142
- }
143
- return {
144
- logDir,
145
- todayFile,
146
- sizeBytes,
147
- retentionDays: 7,
148
- level: process.env.PEAKS_LOG_LEVEL ?? 'info'
149
- };
150
- }
151
- // "logs" section to the doctor output (logDir, today's file name,
152
- // size, retention policy, level). Useful for the user when they
153
- // want to attach a quick log snapshot to a bug report without
154
- // running `peaks log tail` first. The flag is opt-in so the
155
- // existing doctor output is preserved (P4).
156
- export function registerDoctorCommand(program, io) {
157
- addJsonOption(program
158
- .command('doctor')
159
- .description('Run repository doctor checks')
160
- .option('--log', 'include a "logs" section in the doctor output (slice 2026-06-16-cli-logging, AC6)')
161
- .option('--cleanup-stale', 'drop stale instance entries from the project-level binding (v2.16.0 AC-10)')
162
- .option('--stale-ttl-ms <ms>', 'stale-binding TTL in milliseconds (default 300000 = 5 minutes, v2.16.0 AC-10)')
163
- // v2.18.2 PATCH scope (follow-up issue #1): rewrite legacy
164
- // v2.16.0 / v2.17.0 binding files in place so every existing
165
- // callerId gets the `${envSignal}#${pid}` suffix introduced in
166
- // v2.18.0. Mutually exclusive with --cleanup-stale to keep the
167
- // semantics unambiguous (rebuild = structural change,
168
- // cleanup-stale = TTL-based prune).
169
- .option('--rebuild-binding', 'rewrite legacy v2.16.0 / v2.17.0 callerId entries to the v2.18.0+ `#${pid}` format (v2.18.2, follow-up issue #1)')
170
- // v2.18.2 cycle 2: --project makes the project-root-bound
171
- // flags (--rebuild-binding, --cleanup-stale, stale-binding
172
- // scan) addressable for non-current projects. The doctor was
173
- // hardcoded to findProjectRoot(process.cwd()) which is the
174
- // wrong default for users inspecting a sibling project.
175
- .option('--project <path>', 'target project root (defaults to git root or cwd)')
176
- .option('--summary', 'JSON envelope only: emit check counts + names-of-first-N (≤ 2 KB) instead of the full checks/stale-binding arrays; the default envelope is unchanged')).action(async (options) => {
177
- // v2.18.2 cycle 2 (Q2 arbitration): --rebuild-binding and
178
- // --cleanup-stale BOTH mutate the binding file. Running them
179
- // together is ambiguous (rebuild rewrites callerIds; cleanup
180
- // prunes entries). Hard-reject the combination so the user
181
- // gets an actionable error instead of a silent short-circuit.
182
- if (options.rebuildBinding === true && options.cleanupStale === true) {
183
- const envelope = fail('doctor.rebuild-binding', 'CONFLICTING_FLAGS', '--rebuild-binding and --cleanup-stale are mutually exclusive', { rebuildBinding: true, cleanupStale: true }, ['Run them in separate `peaks doctor` invocations']);
184
- printResult(io, envelope, options.json === true);
185
- process.exitCode = 1;
186
- return;
187
- }
188
- // v2.18.2 cycle 2: --project override, applies to BOTH the
189
- // --rebuild-binding short-circuit AND the binding-stale scan.
190
- const projectRoot = options.project !== undefined
191
- ? options.project
192
- : (findProjectRoot(process.cwd()) ?? process.cwd());
193
- // v2.18.2: short-circuit on --rebuild-binding so the doctor
194
- // checks don't run when the user is asking for a single targeted
195
- // migration. The rebuild is observable in its own right
196
- // (rewritten/preserved counts) and does not benefit from running
197
- // the full doctor surface first.
198
- if (options.rebuildBinding === true) {
199
- const result = rebuildBindingFromLegacy(projectRoot);
200
- if (result.errors.length > 0) {
201
- for (const err of result.errors) {
202
- io.stderr(` warning: ${err}`);
203
- }
204
- }
205
- const data = {
206
- rebuilt: !result.noop,
207
- rewritten: result.rewritten,
208
- preserved: result.preserved,
209
- errors: result.errors,
210
- projectRoot
211
- };
212
- const envelope = result.rewritten === 0
213
- ? ok('doctor.rebuild-binding', data, [], result.noop ? ['no legacy callerId entries found — nothing to rewrite'] : [])
214
- : fail('doctor.rebuild-binding', result.noop ? 'BINDING_REBUILD_NOOP' : 'BINDING_REBUILD_OK', result.noop
215
- ? 'No legacy callerId entries to rewrite'
216
- : `Rewrote ${result.rewritten} legacy callerId entry/entries (preserved ${result.preserved})`, data, ['Re-run `peaks binding status` to verify the rewritten entries']);
217
- printResult(io, envelope, options.json === true);
218
- if (result.errors.length > 0 && result.rewritten === 0) {
219
- process.exitCode = 1;
220
- }
221
- return;
222
- }
223
- const report = await runDoctor({
224
- // slice-3b Option C: wire cross-domain probes at call-site.
225
- loadSkills: loadSkillRegistry,
226
- projectRootResolver: () => findProjectRoot(process.cwd()),
227
- isValidSessionIdProbe: doctorIsValidSessionId,
228
- statusLineInstalledProbe: doctorStatusLineInstalledProbe
229
- });
230
- let logsSection = null;
231
- if (options.log === true) {
232
- logsSection = await buildDoctorLogsSection();
233
- }
234
- const ttl = options.staleTtlMs !== undefined ? Number(options.staleTtlMs) : STALE_TTL_MS;
235
- const staleInstances = listStaleInstances(projectRoot, ttl);
236
- let droppedStale = [];
237
- if (options.cleanupStale === true) {
238
- const { dropped } = dropStale(projectRoot, ttl);
239
- droppedStale = dropped;
240
- }
241
- const staleBindingSection = {
242
- ttlMs: ttl,
243
- staleCount: staleInstances.length,
244
- staleInstances,
245
- droppedCount: droppedStale.length,
246
- droppedSids: droppedStale
247
- };
248
- const fullData = logsSection === null
249
- ? { ...report, staleBinding: staleBindingSection }
250
- : { ...report, logs: logsSection, staleBinding: staleBindingSection };
251
- // Slice B: `--summary` is opt-in and affects the JSON envelope only (the
252
- // human-readable path below already prints one line per check).
253
- const data = options.summary === true ? buildDoctorSummary(fullData) : fullData;
254
- // repair cycle: `report.summary.ok` already factors in the
255
- // severity-aware aggregation in `buildReport` (warnings do NOT
256
- // flip `ok`). Stale-binding is independent and still escalates.
257
- const result = report.summary.ok && staleInstances.length === 0
258
- ? ok('doctor', data)
259
- : fail('doctor', 'DOCTOR_FAILED', staleInstances.length > 0
260
- ? `Found ${staleInstances.length} stale binding instance(s); rerun with --cleanup-stale to drop them`
261
- : 'One or more doctor checks failed', data, staleInstances.length > 0
262
- ? ['Run `peaks doctor --cleanup-stale` to drop stale entries']
263
- : ['Fix failed checks and rerun peaks doctor']);
264
- if (options.json === true) {
265
- printResult(io, result, true);
266
- }
267
- else {
268
- // Human-readable: one line per check, green/red indicators, no JSON.
269
- // repair cycle: warn-only findings (severity: 'warning') surface
270
- // as `! check.ok` with the `! ` (warning) glyph so the operator
271
- // can tell them apart from real errors without reading JSON.
272
- for (const check of report.checks) {
273
- if (check.ok) {
274
- io.stdout(` + ${check.message}`);
275
- }
276
- else if (check.severity === 'warning') {
277
- io.stdout(` ! ${check.message}`);
278
- }
279
- else {
280
- io.stdout(` × ${check.message}`);
281
- }
282
- }
283
- if (logsSection !== null) {
284
- io.stdout('\n logs:');
285
- io.stdout(` logDir: ${logsSection.logDir}`);
286
- io.stdout(` todayFile: ${logsSection.todayFile}`);
287
- io.stdout(` sizeBytes: ${logsSection.sizeBytes}`);
288
- io.stdout(` retentionDays: ${logsSection.retentionDays}`);
289
- io.stdout(` level: ${logsSection.level}`);
290
- }
291
- io.stdout('\n stale-binding (v2.16.0 AC-10):');
292
- if (staleInstances.length === 0) {
293
- io.stdout(' + no stale instances');
294
- }
295
- else {
296
- io.stdout(` × ${staleInstances.length} stale instance(s):`);
297
- for (const s of staleInstances) {
298
- io.stdout(` - sid=${s.sid} caller=${s.callerId} lastSeen=${s.lastHeartbeat}`);
299
- }
300
- if (droppedStale.length > 0) {
301
- io.stdout(` cleaned up: ${droppedStale.length}`);
302
- }
303
- else {
304
- io.stdout(' rerun with --cleanup-stale to drop them');
305
- }
306
- }
307
- io.stdout(`\n ${report.summary.passed} passed, ${report.summary.failed} failed${report.summary.warnings > 0 ? `, ${report.summary.warnings} warning(s)` : ''}`);
308
- if (!report.summary.ok || staleInstances.length > 0) {
309
- io.stderr(`\nDOCTOR_FAILED: ${staleInstances.length > 0 ? 'stale binding present' : `${report.summary.failed} check(s) failed`}.`);
310
- }
311
- else if (report.summary.warnings > 0) {
312
- io.stdout(`\n ${report.summary.warnings} warning(s) present — exit code 0 (warn-only).`);
313
- }
314
- }
315
- // repair cycle: `report.summary.ok` already factors in the
316
- // severity-aware aggregation in `buildReport` (warnings do NOT
317
- // flip `ok`). The exit-code gate remains `summary.ok &&
318
- // !staleInstances` — no separate warning special-case needed here.
319
- if (!report.summary.ok || staleInstances.length > 0) {
320
- process.exitCode = 1;
321
- }
322
- });
323
- }
1
+ export { buildDoctorSummary } from './doctor-summary.js';
2
+ export { registerDoctorCommand } from './doctor-run-command.js';
@@ -0,0 +1,8 @@
1
+ export type DoctorLogsSection = {
2
+ logDir: string;
3
+ todayFile: string;
4
+ sizeBytes: number;
5
+ retentionDays: number;
6
+ level: string;
7
+ };
8
+ export declare function buildDoctorLogsSection(): Promise<DoctorLogsSection>;
@@ -0,0 +1,32 @@
1
+ import { existsSync, statSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ //
4
+ // `buildDoctorLogsSection` reads the on-disk log dir and returns the
5
+ // metadata the doctor needs to render the "logs" block. It is
6
+ // extracted from the inline `peaks doctor --log` action so the
7
+ // command stays small and the helper is unit-testable without
8
+ // spinning up the full program.
9
+ export async function buildDoctorLogsSection() {
10
+ // Lazy import to avoid a circular dep at module-load time
11
+ // (core-artifact-commands is imported very early in program.ts).
12
+ const { resolveLogDir, buildLogFileName } = await import('../../../services/log/logger.js');
13
+ const logDir = resolveLogDir();
14
+ const todayFile = buildLogFileName(new Date());
15
+ const fullPath = join(logDir, todayFile);
16
+ let sizeBytes = 0;
17
+ if (existsSync(fullPath)) {
18
+ try {
19
+ sizeBytes = statSync(fullPath).size;
20
+ }
21
+ catch {
22
+ sizeBytes = 0;
23
+ }
24
+ }
25
+ return {
26
+ logDir,
27
+ todayFile,
28
+ sizeBytes,
29
+ retentionDays: 7,
30
+ level: process.env.PEAKS_LOG_LEVEL ?? 'info'
31
+ };
32
+ }
@@ -0,0 +1,3 @@
1
+ export declare function doctorIsValidSessionId(sid: string): boolean;
2
+ export declare function statusLineAlreadyInstalledForScope(scope: 'project' | 'global', projectRoot?: string): boolean;
3
+ export declare function doctorStatusLineInstalledProbe(): boolean;
@@ -0,0 +1,55 @@
1
+ import { findProjectRoot } from '../../../services/config/config-safety.js';
2
+ import { planStatusLineInstall } from '../../../services/skills/statusline-settings-service.js';
3
+ // slice-3b Option C: the doctor subpackage owns the check pipeline but
4
+ // does NOT import cross-domain utils from the main package (avoids
5
+ // circular deps). The CLI is the natural wiring point — every cross-
6
+ // domain util the doctor used to import directly is now injected as a
7
+ // probe on DoctorOptions at call-site:
8
+ //
9
+ // loadSkills ← loadSkillRegistry (main/services/skills/skill-registry.ts)
10
+ // skillPresenceProbe ← leave as-is; doctor-command does not own the presence probe
11
+ // statusLineInstalledProbe ← defaults to a `planStatusLineInstall` wrapper below
12
+ // projectRootResolver ← findProjectRoot (main/services/config/config-safety.ts)
13
+ // isValidSessionIdProbe ← the regex kept in main/services/workspace/sid-naming-guard.ts
14
+ //
15
+ // Inlining isValidSessionId via the doctor subpackage's default regex
16
+ // (which mirrors the upstream file byte-for-byte) keeps the L3 orphan
17
+ // check behaviour-identical without dragging sid-naming-guard into a
18
+ // workspace package. If sid-naming-guard is ever moved into
19
+ // peaks-loop-shared, swap this for a re-import.
20
+ export function doctorIsValidSessionId(sid) {
21
+ return /^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])-session-[0-9a-z]{3,6}$/.test(sid);
22
+ }
23
+ export function statusLineAlreadyInstalledForScope(scope, projectRoot) {
24
+ try {
25
+ if (scope === 'project') {
26
+ if (projectRoot === undefined)
27
+ return false;
28
+ return planStatusLineInstall('project', projectRoot).alreadyInstalled;
29
+ }
30
+ return planStatusLineInstall('global').alreadyInstalled;
31
+ }
32
+ catch {
33
+ return false;
34
+ }
35
+ }
36
+ export function doctorStatusLineInstalledProbe() {
37
+ const projectRoot = findProjectRoot(process.cwd());
38
+ // Check both scopes: a user may have installed the statusLine globally, which
39
+ // the project-only check would miss and falsely report as "not installed".
40
+ try {
41
+ if (projectRoot !== null && statusLineAlreadyInstalledForScope('project', projectRoot)) {
42
+ return true;
43
+ }
44
+ }
45
+ catch {
46
+ // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
47
+ /* fall through to global */
48
+ }
49
+ try {
50
+ return statusLineAlreadyInstalledForScope('global');
51
+ }
52
+ catch {
53
+ return false;
54
+ }
55
+ }
@@ -0,0 +1,12 @@
1
+ import type { Command } from 'commander';
2
+ import { type ProgramIO } from '../../cli-helpers.js';
3
+ export type DoctorOptions = {
4
+ json?: boolean;
5
+ log?: boolean;
6
+ cleanupStale?: boolean;
7
+ staleTtlMs?: string;
8
+ rebuildBinding?: boolean;
9
+ project?: string;
10
+ summary?: boolean;
11
+ };
12
+ export declare function registerDoctorCommand(program: Command, io: ProgramIO): void;