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,74 @@
1
+ /**
2
+ * The denial text the worktree-authorization gate prints when no live user
3
+ * grant covers the operation.
4
+ *
5
+ * WHY ITS OWN MODULE. `worktree-authorization-gate.ts` is 701 lines against a
6
+ * 300-line cap and already carries a baseline row, so it may only shrink. The
7
+ * five refusal texts it used to build inline move here and the gate calls
8
+ * these builders — the extract-don't-append move this repository makes instead
9
+ * of growing an over-cap file.
10
+ *
11
+ * WHY THE TEXT ASKS THE READER TO GO TO THE USER. The gate is a `PreToolUse`
12
+ * hook, so its reader is the agent, and the AGENT IS THE PARTY THE PROJECT'S
13
+ * RULE AIMS AT: the authorization this gate consumes is the user's to give. The
14
+ * gate cannot enforce that distinction — see the next paragraph, which is the
15
+ * part an earlier revision of this file got wrong — so the text asks rather
16
+ * than claims, and the denial that told its own reader to run a command it was
17
+ * told it must not run is the defect this function replaces.
18
+ *
19
+ * WHAT THE GATE ACTUALLY CHECKS — AND WHAT IT DOES NOT. A grant recorded for
20
+ * the operation in this session. Nothing else: the gate has no issuer concept,
21
+ * so it cannot and does not discriminate on who wrote the grant. Measured
22
+ * 2026-10-13, end to end, in a scratch project: `git stash drop stash@{0}` is
23
+ * refused (exit 2); the agent then runs
24
+ * `peaks worktree auth grant --operation git-stash-mutating --reason "the agent
25
+ * wrote this itself; no user was involved"` and gets `ok: true`; the SAME call
26
+ * then exits 0 and is allowed. The grant stays operation-scoped (`git worktree
27
+ * add` against the same project is still refused), so the gate does gate — it
28
+ * just cannot tell consent from self-authorization.
29
+ *
30
+ * WHY THIS MATTERS FOR THE TEXT. An earlier revision of this function said "an
31
+ * agent-issued grant is not the consent this gate checks for, so the reader
32
+ * cannot satisfy this refusal itself". That is exactly the defect the function
33
+ * exists to avoid: a message asserting a guarantee the code does not implement,
34
+ * which this module's own header above already falsifies. The text below says
35
+ * what the measurement shows — the gate needs a recorded grant, and nothing
36
+ * distinguishes who issued it — and keeps the ask, because the authorization is
37
+ * the user's to give even though the gate cannot enforce that.
38
+ *
39
+ * `operation` is a plain `string`, not the gate's `OperationType`: the text
40
+ * only interpolates the value, and importing that type back would make the two
41
+ * modules mutually importing. `as const` on `code` and `allow` keeps each
42
+ * returned literal narrow enough to be the gate's deny variant without the
43
+ * import.
44
+ */
45
+ export declare function noAuthorizationDenial(operation: string, sessionId: string): {
46
+ allow: false;
47
+ code: "WORKTREE_USER_AUTH_REQUIRED";
48
+ reason: string;
49
+ remediation: string;
50
+ };
51
+ export declare function noGrantForOperationDenial(operation: string): {
52
+ allow: false;
53
+ code: "WORKTREE_USER_AUTH_REQUIRED";
54
+ reason: string;
55
+ remediation: string;
56
+ };
57
+ export declare function requestMismatchDenial(operation: string, grantRequestId: string | null, currentRequestId: string | null): {
58
+ allow: false;
59
+ code: "WORKTREE_USER_AUTH_REQUEST_MISMATCH";
60
+ reason: string;
61
+ remediation: string;
62
+ };
63
+ export declare function expiredGrantsDenial(operation: string): {
64
+ allow: false;
65
+ code: "WORKTREE_USER_AUTH_EXPIRED";
66
+ reason: string;
67
+ remediation: string;
68
+ };
69
+ export declare function consumedGrantsDenial(operation: string): {
70
+ allow: false;
71
+ code: "WORKTREE_USER_AUTH_REQUIRED";
72
+ reason: string;
73
+ remediation: string;
74
+ };
@@ -0,0 +1,102 @@
1
+ /**
2
+ * The denial text the worktree-authorization gate prints when no live user
3
+ * grant covers the operation.
4
+ *
5
+ * WHY ITS OWN MODULE. `worktree-authorization-gate.ts` is 701 lines against a
6
+ * 300-line cap and already carries a baseline row, so it may only shrink. The
7
+ * five refusal texts it used to build inline move here and the gate calls
8
+ * these builders — the extract-don't-append move this repository makes instead
9
+ * of growing an over-cap file.
10
+ *
11
+ * WHY THE TEXT ASKS THE READER TO GO TO THE USER. The gate is a `PreToolUse`
12
+ * hook, so its reader is the agent, and the AGENT IS THE PARTY THE PROJECT'S
13
+ * RULE AIMS AT: the authorization this gate consumes is the user's to give. The
14
+ * gate cannot enforce that distinction — see the next paragraph, which is the
15
+ * part an earlier revision of this file got wrong — so the text asks rather
16
+ * than claims, and the denial that told its own reader to run a command it was
17
+ * told it must not run is the defect this function replaces.
18
+ *
19
+ * WHAT THE GATE ACTUALLY CHECKS — AND WHAT IT DOES NOT. A grant recorded for
20
+ * the operation in this session. Nothing else: the gate has no issuer concept,
21
+ * so it cannot and does not discriminate on who wrote the grant. Measured
22
+ * 2026-10-13, end to end, in a scratch project: `git stash drop stash@{0}` is
23
+ * refused (exit 2); the agent then runs
24
+ * `peaks worktree auth grant --operation git-stash-mutating --reason "the agent
25
+ * wrote this itself; no user was involved"` and gets `ok: true`; the SAME call
26
+ * then exits 0 and is allowed. The grant stays operation-scoped (`git worktree
27
+ * add` against the same project is still refused), so the gate does gate — it
28
+ * just cannot tell consent from self-authorization.
29
+ *
30
+ * WHY THIS MATTERS FOR THE TEXT. An earlier revision of this function said "an
31
+ * agent-issued grant is not the consent this gate checks for, so the reader
32
+ * cannot satisfy this refusal itself". That is exactly the defect the function
33
+ * exists to avoid: a message asserting a guarantee the code does not implement,
34
+ * which this module's own header above already falsifies. The text below says
35
+ * what the measurement shows — the gate needs a recorded grant, and nothing
36
+ * distinguishes who issued it — and keeps the ask, because the authorization is
37
+ * the user's to give even though the gate cannot enforce that.
38
+ *
39
+ * `operation` is a plain `string`, not the gate's `OperationType`: the text
40
+ * only interpolates the value, and importing that type back would make the two
41
+ * modules mutually importing. `as const` on `code` and `allow` keeps each
42
+ * returned literal narrow enough to be the gate's deny variant without the
43
+ * import.
44
+ */
45
+ /**
46
+ * The remedy paragraph every denial ends with, with the operation baked in.
47
+ *
48
+ * Four facts, in the order a reader needs them: what the gate requires, what it
49
+ * does not check, whose authorization the rule is, and how to record it.
50
+ */
51
+ function userSideGrant(operation) {
52
+ return [
53
+ `The gate requires one thing: a grant recorded for the "${operation}" operation in this session's \`.peaks/_runtime/<sessionId>/worktree-auth.json\`.`,
54
+ 'Nothing in the gate records or checks WHO issued a grant, so a grant the reader writes itself is accepted — the requirement is a recorded grant, not a verified issuer.',
55
+ "The authorization is the USER's to give: ask them first, then record it with",
56
+ ` peaks worktree auth grant --operation ${operation} --reason "<the words they used>"`,
57
+ '(`--ttl <ms>` and `--multi` are accepted.) A grant with no user behind it satisfies this gate; it does not satisfy the rule the gate exists for, which is why the ask comes first.'
58
+ ].join('\n');
59
+ }
60
+ export function noAuthorizationDenial(operation, sessionId) {
61
+ return {
62
+ allow: false,
63
+ code: 'WORKTREE_USER_AUTH_REQUIRED',
64
+ reason: `No current-task user authorization for "${operation}" (session=${sessionId}).`,
65
+ remediation: userSideGrant(operation)
66
+ };
67
+ }
68
+ export function noGrantForOperationDenial(operation) {
69
+ return {
70
+ allow: false,
71
+ code: 'WORKTREE_USER_AUTH_REQUIRED',
72
+ reason: `No grant for operation "${operation}" in this session.`,
73
+ remediation: userSideGrant(operation)
74
+ };
75
+ }
76
+ export function requestMismatchDenial(operation, grantRequestId, currentRequestId) {
77
+ return {
78
+ allow: false,
79
+ code: 'WORKTREE_USER_AUTH_REQUEST_MISMATCH',
80
+ reason: `Grant for "${operation}" is scoped to requestId=${grantRequestId} but the current tool ` +
81
+ `call carries requestId=${currentRequestId}.`,
82
+ remediation: `Operate under the request the grant is scoped to (requestId=${grantRequestId}), or have ` +
83
+ `the user re-issue the grant unscoped. ${userSideGrant(operation)}`
84
+ };
85
+ }
86
+ export function expiredGrantsDenial(operation) {
87
+ return {
88
+ allow: false,
89
+ code: 'WORKTREE_USER_AUTH_EXPIRED',
90
+ reason: `All grants for operation "${operation}" in this session have expired.`,
91
+ remediation: `${userSideGrant(operation)} (The previous grant expired; the default TTL is 5 minutes.)`
92
+ };
93
+ }
94
+ export function consumedGrantsDenial(operation) {
95
+ return {
96
+ allow: false,
97
+ code: 'WORKTREE_USER_AUTH_REQUIRED',
98
+ reason: `All unexpired grants for operation "${operation}" in this session are already consumed.`,
99
+ remediation: `${userSideGrant(operation)} (The previous grant was single-use and already consumed; a ` +
100
+ `multi-use grant is possible but should be rare.)`
101
+ };
102
+ }
@@ -17,6 +17,6 @@ export declare function matchBaseline(finding: EslintFinding, baseline: readonly
17
17
  export declare function aggregateRedLine(baseline: readonly BaselineViolation[]): readonly RedLineEntry[];
18
18
  export declare const EMPTY_DIFF_RANGE: readonly DiffRange[];
19
19
  export declare const EMPTY_REDLINE: readonly RedLineEntry[];
20
- export declare function emptyResult(state: EslintState, start: number, rawOutput: string): EslintRunResult;
20
+ export declare function emptyResult(state: EslintState, start: number, rawOutput: string, reason?: string): EslintRunResult;
21
21
  export declare function buildEslintArgs(options: EslintRunOptions): string[];
22
22
  export type { DiffRange };
@@ -150,13 +150,14 @@ export function aggregateRedLine(baseline) {
150
150
  }
151
151
  export const EMPTY_DIFF_RANGE = [];
152
152
  export const EMPTY_REDLINE = [];
153
- export function emptyResult(state, start, rawOutput) {
153
+ export function emptyResult(state, start, rawOutput, reason) {
154
154
  return {
155
155
  state,
156
156
  findings: [],
157
157
  summary: { error: 0, warn: 0, info: 0 },
158
158
  durationMs: Date.now() - start,
159
159
  rawOutput,
160
+ ...(reason === undefined ? {} : { reason }),
160
161
  baselineWaived: [],
161
162
  redLine: EMPTY_REDLINE
162
163
  };
@@ -45,6 +45,14 @@ export type EslintRunResult = {
45
45
  readonly summary: EslintSummary;
46
46
  readonly durationMs: number;
47
47
  readonly rawOutput: string;
48
+ /**
49
+ * Why a non-`ok` state was reached. Four different conditions — an
50
+ * unbuildable argument list, a spawn failure, a signal kill (which is how a
51
+ * spawn timeout lands) and unparseable linter output — all reported
52
+ * `execution-failed` and nothing else, so an operator could not tell a
53
+ * timed-out linter from one that emitted rubbish. Absent when `state` is ok.
54
+ */
55
+ readonly reason?: string;
48
56
  readonly baselineWaived: readonly EslintFinding[];
49
57
  readonly redLine: readonly RedLineEntry[];
50
58
  };
@@ -87,7 +87,7 @@ export function runEslint(options) {
87
87
  args = buildEslintArgs(options);
88
88
  }
89
89
  catch (error) {
90
- return emptyResult('execution-failed', start, error instanceof Error ? error.message : String(error));
90
+ return emptyResult('execution-failed', start, error instanceof Error ? error.message : String(error), 'the eslint argument list could not be built');
91
91
  }
92
92
  const projectRoot = resolveProjectRoot(options.cwd);
93
93
  // Invoke eslint via `node <node_modules/eslint/bin/eslint.js>` to bypass
@@ -132,10 +132,23 @@ export function runEslint(options) {
132
132
  if (result.error !== undefined && result.error !== null) {
133
133
  const message = result.error.message;
134
134
  const state = /ENOENT/.test(message) ? 'npx-failed' : 'execution-failed';
135
- return emptyResult(state, start, typeof result.stdout === 'string' ? result.stdout : '');
135
+ // A spawn timeout arrives HERE, as `error.code === 'ETIMEDOUT'` — measured on
136
+ // this host with `--timeout-ms 20000`: the spawn-error branch below wins over
137
+ // the signal branch, because this check comes first and spawnSync sets both.
138
+ // So a timeout must not be reported as "could not be spawned": it was spawned
139
+ // and did not finish, and that difference is the whole diagnosis.
140
+ const timedOut = result.error.code === 'ETIMEDOUT';
141
+ const budgetMs = options.timeoutMs ?? ESLINT_DEFAULT_TIMEOUT_MS;
142
+ return emptyResult(state, start, typeof result.stdout === 'string' ? result.stdout : '', timedOut
143
+ ? `eslint did not finish within the ${budgetMs}ms spawn timeout`
144
+ : `eslint could not be spawned: ${message}`);
136
145
  }
137
146
  if (result.signal !== null && result.signal !== undefined) {
138
- return emptyResult('execution-failed', start, typeof result.stdout === 'string' ? result.stdout : '');
147
+ // A kill that arrived WITHOUT a spawn error — a signal from outside, not the
148
+ // spawn timeout (that one is caught above as ETIMEDOUT). Named so it is not
149
+ // read as linter output that would not parse.
150
+ const budgetMs = options.timeoutMs ?? ESLINT_DEFAULT_TIMEOUT_MS;
151
+ return emptyResult('execution-failed', start, typeof result.stdout === 'string' ? result.stdout : '', `eslint was killed by ${result.signal} after ${Date.now() - start}ms (spawn timeout ${budgetMs}ms)`);
139
152
  }
140
153
  const stdout = typeof result.stdout === 'string' ? result.stdout : '';
141
154
  let findings = [];
@@ -166,7 +179,7 @@ export function runEslint(options) {
166
179
  }
167
180
  }
168
181
  catch {
169
- return emptyResult('execution-failed', start, stdout);
182
+ return emptyResult('execution-failed', start, stdout, `eslint stdout was not valid JSON (${stdout.length} bytes)`);
170
183
  }
171
184
  }
172
185
  if (result.status !== 0 && findings.length === 0) {
@@ -13,6 +13,7 @@
13
13
  * a fake transport instead of reaching the network.
14
14
  */
15
15
  import { getErrorMessage } from 'peaks-loop-shared/result';
16
+ import { estimateTokens } from '../memory/llm-reranker-core.js';
16
17
  /** Public Anthropic endpoint. `ANTHROPIC_BASE_URL` overrides it (gateways, local proxies). */
17
18
  const DEFAULT_BASE_URL = 'https://api.anthropic.com';
18
19
  /** One call is bounded: an unbounded gate is a hung gate. */
@@ -102,6 +103,28 @@ function isTextBlock(block) {
102
103
  function isAbort(error) {
103
104
  return error instanceof Error && (error.name === 'TimeoutError' || error.name === 'AbortError');
104
105
  }
106
+ /**
107
+ * The two token counts this call reports, and where they came from.
108
+ *
109
+ * `?? 0` used to stand in for an omitted `usage`, which made "the provider
110
+ * reported zero" and "nobody measured" the same number on the wire. When the
111
+ * reply does not carry BOTH counts, the runner falls back to the estimator the
112
+ * repo already has (`llm-reranker-core.ts` `estimateTokens`, 1 token ≈ 4 bytes)
113
+ * over the request body and the returned text, and says so with
114
+ * `source: 'estimated'` rather than leaving the two states indistinguishable.
115
+ */
116
+ function tokenCounts(usage, requestBody, text) {
117
+ const input = usage?.input_tokens;
118
+ const output = usage?.output_tokens;
119
+ if (typeof input !== 'number' || typeof output !== 'number') {
120
+ return {
121
+ input: estimateTokens(requestBody),
122
+ output: estimateTokens(text),
123
+ source: 'estimated'
124
+ };
125
+ }
126
+ return { input, output, source: 'provider' };
127
+ }
105
128
  export function createAnthropicRunner(config, options = {}) {
106
129
  const fetchImpl = options.fetchImpl ?? defaultFetch;
107
130
  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
@@ -153,13 +176,7 @@ export function createAnthropicRunner(config, options = {}) {
153
176
  if (!output) {
154
177
  throw new LlmRequestError(`LLM reply from ${url} carried no text block`);
155
178
  }
156
- return {
157
- output,
158
- tokens: {
159
- input: payload.usage?.input_tokens ?? 0,
160
- output: payload.usage?.output_tokens ?? 0
161
- }
162
- };
179
+ return { output, tokens: tokenCounts(payload.usage, body, output) };
163
180
  }
164
181
  };
165
182
  }
@@ -0,0 +1,39 @@
1
+ /**
2
+ * The loop runtime's two observability emissions: the monotonic guard's verdict
3
+ * for a cycle, and that cycle's own outcome.
4
+ *
5
+ * WHY BOTH MAPPINGS LIVE HERE. The two producers cannot emit for themselves:
6
+ * `checkMonotonicImprovement` is pure (no project root, no session id —
7
+ * `monotonic-guard.ts:83`), and the cycle bookkeeping in `runLoopLocked` has no
8
+ * emitter. So the emit happens in the callers, and the callers are two files.
9
+ * The mapping from loop state to event vocabulary is decided ONCE, here, rather
10
+ * than re-derived at each call site.
11
+ *
12
+ * Fire-and-forget by contract: whatever `emitObservabilityEvent` returns
13
+ * (`written: false` on every error path) is dropped, and neither helper throws.
14
+ */
15
+ import type { MonotonicReport } from './monotonic-guard.js';
16
+ /**
17
+ * `monotonic-trigger` — once per computed report, from each caller of
18
+ * `checkMonotonicImprovement`, which is pure and cannot emit for itself.
19
+ *
20
+ * `pass` → `report: 'pass'`; `block` → `report: 'block'`; `action` is the
21
+ * report's own `code`, a vocabulary the guard already produces
22
+ * (`MONOTONIC_OK` / `MONOTONIC_VIOLATION` / `MONOTONIC_NO_PREVIOUS` /
23
+ * `MONOTONIC_INCOMPARABLE_EVALUATORS`). **`skip` emits NOTHING**: nothing was
24
+ * guarded, so counting it would make the counter track "how often the guard ran"
25
+ * instead of "how often a monotonic condition fired". `'warn'` stays unused —
26
+ * the guard cannot return it, and it is not repurposed here.
27
+ */
28
+ export declare function emitMonotonicReport(projectRoot: string, sid: string, report: MonotonicReport): void;
29
+ /**
30
+ * `cycle` — exactly ONE event per cycle, at the end of the iteration.
31
+ *
32
+ * One, not two: `aggregateDashboardMetrics` counts events, not distinct cycle
33
+ * ids (`aggregation.ts:212`), so emitting `'started'` alongside this one would
34
+ * double `cycleCount`. `'started'` therefore stays unused. `status` is
35
+ * `'failed'` for the cycle whose report carries the violation — the same
36
+ * condition `runLoopLocked` aborts on — and `'completed'` otherwise, so
37
+ * `cycleCount` equals the number of cycles the driver actually ran.
38
+ */
39
+ export declare function emitCycleOutcome(projectRoot: string, sid: string, cycle: number, report: MonotonicReport): void;
@@ -0,0 +1,55 @@
1
+ /**
2
+ * The loop runtime's two observability emissions: the monotonic guard's verdict
3
+ * for a cycle, and that cycle's own outcome.
4
+ *
5
+ * WHY BOTH MAPPINGS LIVE HERE. The two producers cannot emit for themselves:
6
+ * `checkMonotonicImprovement` is pure (no project root, no session id —
7
+ * `monotonic-guard.ts:83`), and the cycle bookkeeping in `runLoopLocked` has no
8
+ * emitter. So the emit happens in the callers, and the callers are two files.
9
+ * The mapping from loop state to event vocabulary is decided ONCE, here, rather
10
+ * than re-derived at each call site.
11
+ *
12
+ * Fire-and-forget by contract: whatever `emitObservabilityEvent` returns
13
+ * (`written: false` on every error path) is dropped, and neither helper throws.
14
+ */
15
+ import { emitCycleEvent, emitMonotonicTriggerEvent } from '../observability/observability-service.js';
16
+ /**
17
+ * `monotonic-trigger` — once per computed report, from each caller of
18
+ * `checkMonotonicImprovement`, which is pure and cannot emit for itself.
19
+ *
20
+ * `pass` → `report: 'pass'`; `block` → `report: 'block'`; `action` is the
21
+ * report's own `code`, a vocabulary the guard already produces
22
+ * (`MONOTONIC_OK` / `MONOTONIC_VIOLATION` / `MONOTONIC_NO_PREVIOUS` /
23
+ * `MONOTONIC_INCOMPARABLE_EVALUATORS`). **`skip` emits NOTHING**: nothing was
24
+ * guarded, so counting it would make the counter track "how often the guard ran"
25
+ * instead of "how often a monotonic condition fired". `'warn'` stays unused —
26
+ * the guard cannot return it, and it is not repurposed here.
27
+ */
28
+ export function emitMonotonicReport(projectRoot, sid, report) {
29
+ if (report.status === 'skip')
30
+ return;
31
+ emitMonotonicTriggerEvent({
32
+ projectRoot,
33
+ sessionId: sid,
34
+ report: report.status,
35
+ action: report.code
36
+ });
37
+ }
38
+ /**
39
+ * `cycle` — exactly ONE event per cycle, at the end of the iteration.
40
+ *
41
+ * One, not two: `aggregateDashboardMetrics` counts events, not distinct cycle
42
+ * ids (`aggregation.ts:212`), so emitting `'started'` alongside this one would
43
+ * double `cycleCount`. `'started'` therefore stays unused. `status` is
44
+ * `'failed'` for the cycle whose report carries the violation — the same
45
+ * condition `runLoopLocked` aborts on — and `'completed'` otherwise, so
46
+ * `cycleCount` equals the number of cycles the driver actually ran.
47
+ */
48
+ export function emitCycleOutcome(projectRoot, sid, cycle, report) {
49
+ emitCycleEvent({
50
+ projectRoot,
51
+ sessionId: sid,
52
+ cycle,
53
+ status: report.monotonicityViolation ? 'failed' : 'completed'
54
+ });
55
+ }
@@ -13,6 +13,8 @@
13
13
  *
14
14
  * File budget: ≤ 800 lines (Karpathy §2).
15
15
  */
16
+ import { readFileSync, readdirSync } from 'node:fs';
17
+ import { join } from 'node:path';
16
18
  /** Score normalisation — gateAction maps to a 0..1 score:
17
19
  * pass → 1.0
18
20
  * warn → 0.5
@@ -148,15 +150,10 @@ function classifyFsError(err) {
148
150
  * .peaks/_sub_agents/<sid>/shared/ 跨批 signal → 不 crash").
149
151
  * Pure helper; only present for the cross-session case. */
150
152
  export function loadCrossSessionSignal(projectRoot, sid) {
151
- // Lazily import so unit tests in non-windows environments don't pull
152
- // node:fs through a static `import` (test envs stay small).
153
- // eslint-disable-next-line @typescript-eslint/no-var-requires
154
- const fs = require('node:fs');
155
- const path = require('node:path');
156
- const sharedDir = path.join(projectRoot, '.peaks', '_sub_agents', sid, 'shared');
153
+ const sharedDir = join(projectRoot, '.peaks', '_sub_agents', sid, 'shared');
157
154
  const readdir = (() => {
158
155
  try {
159
- return { ok: true, value: fs.readdirSync(sharedDir) };
156
+ return { ok: true, value: readdirSync(sharedDir) };
160
157
  }
161
158
  catch (err) {
162
159
  return { ok: false, reason: classifyFsError(err) };
@@ -177,10 +174,10 @@ export function loadCrossSessionSignal(projectRoot, sid) {
177
174
  }
178
175
  if (best === null)
179
176
  return null;
180
- const target = path.join(sharedDir, `cycle-${best}.json`);
177
+ const target = join(sharedDir, `cycle-${best}.json`);
181
178
  const readFile = (() => {
182
179
  try {
183
- return { ok: true, value: fs.readFileSync(target, 'utf8') };
180
+ return { ok: true, value: readFileSync(target, 'utf8') };
184
181
  }
185
182
  catch (err) {
186
183
  return { ok: false, reason: classifyFsError(err) };
@@ -21,10 +21,12 @@
21
21
  *
22
22
  * File budget: ≤ 800 lines (Karpathy §2).
23
23
  */
24
+ import { existsSync, readFileSync, readdirSync } from 'node:fs';
24
25
  import { join } from 'node:path';
25
26
  import { dispatchEvaluator } from './evaluator-dispatcher.js';
26
27
  import { checkMonotonicImprovement, toScoreRow, DEFAULT_MONOTONIC_THRESHOLD } from './monotonic-guard.js';
27
28
  import { appendMetricLine, readMetricLines } from '../observability/jsonl-store.js';
29
+ import { emitMonotonicReport } from './loop-observability.js';
28
30
  import { findProjectRoot } from '../config/config-safety.js';
29
31
  import { classifyFsError, MONOTONIC_CYCLE_KIND, WALKED_EVALUATORS } from './monotonic-runner-types.js';
30
32
  /** Resolve the slice dir — kept for API/BC (run-driver.ts uses it to
@@ -112,15 +114,11 @@ function loadMostRecentCycleFromSubAgents(projectRoot, sid, rid) {
112
114
  return loadMostRecentCycleFromDir(dir, rid);
113
115
  }
114
116
  function loadMostRecentCycleFromDir(dir, rid) {
115
- // Lazily import so unit tests in non-windows environments don't pull
116
- // node:fs through a static `import`.
117
- // eslint-disable-next-line @typescript-eslint/no-var-requires
118
- const fs = require('node:fs');
119
- if (!fs.existsSync(dir))
117
+ if (!existsSync(dir))
120
118
  return null;
121
119
  const readdir = (() => {
122
120
  try {
123
- return { ok: true, value: fs.readdirSync(dir) };
121
+ return { ok: true, value: readdirSync(dir) };
124
122
  }
125
123
  catch (err) {
126
124
  return { ok: false, reason: classifyFsError(err) };
@@ -143,7 +141,7 @@ function loadMostRecentCycleFromDir(dir, rid) {
143
141
  const target = join(dir, `cycle-${bestCycle}.json`);
144
142
  const readFile = (() => {
145
143
  try {
146
- return { ok: true, value: fs.readFileSync(target, 'utf8') };
144
+ return { ok: true, value: readFileSync(target, 'utf8') };
147
145
  }
148
146
  catch (err) {
149
147
  return { ok: false, reason: classifyFsError(err) };
@@ -222,6 +220,9 @@ export function runMonotonicCheck(options) {
222
220
  const currentCycle = { cycle, scores: rows };
223
221
  const previousCycle = loadPreviousCycle(options.projectRoot, options.sid, options.rid);
224
222
  const report = checkMonotonicImprovement(previousCycle, currentCycle, { threshold });
223
+ // The guard is pure and holds no session binding, so its caller emits, one
224
+ // line after the verdict exists.
225
+ emitMonotonicReport(options.projectRoot, options.sid, report);
225
226
  let persistedAt = null;
226
227
  const envelopeWarns = [];
227
228
  if (persist) {
@@ -7,31 +7,27 @@
7
7
  * load-bearing: it reads `.peaks/_runtime/<sid>/loop/<rid>/spec.yaml`,
8
8
  * walks each `evaluators[].kind` in order via `dispatchEvaluator`,
9
9
  * captures a score row, persists the current cycle to disk, runs the
10
- * monotonic guard against the prior cycle, and decides whether to
11
- * continue / abort based on `termination.strategy`.
10
+ * monotonic guard against the prior cycle, emits that cycle's `cycle` and
11
+ * `monotonic-trigger` events (`loop-observability.ts`), and decides
12
+ * whether to continue / abort based on `termination.strategy`.
12
13
  *
13
- * Strategy semantics:
14
- * - `monotonic-violation` (default): abort on MONOTONICITY_VIOLATION.
15
- * - `max-cycles`: run exactly `termination.maxCycles` (default 5)
16
- * cycles, aborting on any violation along the way.
17
- * - `manual`: run exactly one cycle and exit 0; further cycles are
18
- * the operator's responsibility.
19
- * - anything else: `UNKNOWN_TERMINATION_STRATEGY`.
14
+ * Strategy semantics: `monotonic-violation` (default) aborts on
15
+ * MONOTONICITY_VIOLATION; `max-cycles` runs exactly `termination.maxCycles`
16
+ * (default 5), aborting on any violation along the way; `manual` runs exactly
17
+ * one cycle and exits 0, further cycles being the operator's responsibility;
18
+ * anything else is `UNKNOWN_TERMINATION_STRATEGY`.
20
19
  *
21
- * Karpathy §2 Simplicity First: no new deps. Pure-data + JSON to
22
- * disk. The single in-process lock flag prevents two concurrent
23
- * `peaks loop run` calls (same sid+rid) from corrupting the cycle
24
- * index; cross-process locking is out of scope per the dispatch
25
- * prompt.
26
- *
27
- * File budget: ≤ 800 lines.
20
+ * Karpathy §2 Simplicity First: no new deps. Pure data + JSON to disk. The
21
+ * in-process lock flag stops two concurrent `peaks loop run` calls (same
22
+ * sid+rid) corrupting the cycle index; cross-process locking is out of scope.
28
23
  */
29
- import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
24
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
30
25
  import { join } from 'node:path';
31
26
  import { resolveLoopSpec, lintLoopSpec, specPath, MONOTONIC_TERMINATION, DEFAULT_MAX_CYCLES } from './spec-service.js';
32
27
  import { dispatchEvaluator } from './evaluator-dispatcher.js';
33
28
  import { checkMonotonicImprovement, toScoreRow, DEFAULT_MONOTONIC_THRESHOLD } from './monotonic-guard.js';
34
29
  import { nextCycleIndex, sliceDir } from './monotonic-runner.js';
30
+ import { emitCycleOutcome, emitMonotonicReport } from './loop-observability.js';
35
31
  import { findProjectRoot } from '../config/config-safety.js';
36
32
  function classifyFsError(err) {
37
33
  const code = err?.code;
@@ -278,7 +274,11 @@ function runLoopLocked(spec, strategy, maxCycles, options) {
278
274
  ? persistCycleRecord(options.projectRoot, options.sid, options.rid, cycleNo, rows)
279
275
  : null;
280
276
  const record = buildCycleRecord(cycleNo, rows, previousCycle, threshold, persistedAt);
277
+ // The guard is pure and holds no binding, so the caller emits for it; one
278
+ // `cycle` event per cycle, after the push, or the per-event count doubles.
279
+ emitMonotonicReport(options.projectRoot, options.sid, record.monotonicReport);
281
280
  cycles.push(record);
281
+ emitCycleOutcome(options.projectRoot, options.sid, cycleNo, record.monotonicReport);
282
282
  finalReport = record.monotonicReport;
283
283
  if (record.monotonicReport.monotonicityViolation) {
284
284
  regressionCount += record.monotonicReport.regressions.length;
@@ -344,13 +344,9 @@ function loadCycleAt(projectRoot, sid, rid, n) {
344
344
  return parseCycleFromPath(path, n);
345
345
  }
346
346
  function parseCycleFromPath(path, fallbackCycle) {
347
- // Defer to monotonic-runner via a lazy require (the function is
348
- // small and avoids leaking its internals).
349
- // eslint-disable-next-line @typescript-eslint/no-var-requires
350
- const fs = require('node:fs');
351
347
  const readFile = (() => {
352
348
  try {
353
- return { ok: true, value: fs.readFileSync(path, 'utf8') };
349
+ return { ok: true, value: readFileSync(path, 'utf8') };
354
350
  }
355
351
  catch (err) {
356
352
  return { ok: false, reason: classifyFsError(err) };
@@ -62,6 +62,7 @@ export function extractSessionMemories(options) {
62
62
  extractedCount: 0,
63
63
  writtenFiles: [],
64
64
  updatedIndex: false,
65
+ skippedWrites: [],
65
66
  droppedBlocks: [],
66
67
  scanFailures: []
67
68
  };
@@ -116,6 +117,7 @@ export function extractSessionMemories(options) {
116
117
  extractedCount: 0,
117
118
  writtenFiles: [],
118
119
  updatedIndex: false,
120
+ skippedWrites: [],
119
121
  droppedBlocks,
120
122
  scanFailures
121
123
  };
@@ -136,12 +138,22 @@ export function extractSessionMemories(options) {
136
138
  // writes so callers can still tell what the run actually produced.
137
139
  const existingNames = apply ? readStoredMemoryNames(primaryMemoryDir) : new Set();
138
140
  const writtenFiles = [];
141
+ const skippedWrites = [];
139
142
  if (apply) {
140
143
  mkdirSync(primaryMemoryDir, { recursive: true });
141
144
  for (const memory of allExtracted) {
142
145
  const slug = slugify(memory.title);
143
- if (existingNames.has(slug))
146
+ if (existingNames.has(slug)) {
147
+ // Same defect as the artifact path, one function over: the skip left no
148
+ // trace, so `extractedCount: 5` with 4 files on disk read as success.
149
+ skippedWrites.push({
150
+ slug,
151
+ title: memory.title,
152
+ sourceArtifact: memory.sourceArtifact,
153
+ filePath: join(primaryMemoryDir, `${slug}.md`)
154
+ });
144
155
  continue;
156
+ }
145
157
  const targetPath = join(primaryMemoryDir, `${slug}.md`);
146
158
  const safePath = resolveInputPath(targetPath);
147
159
  const stableSafePath = stablePath(safePath);
@@ -163,6 +175,7 @@ export function extractSessionMemories(options) {
163
175
  extractedCount: allExtracted.length,
164
176
  writtenFiles,
165
177
  updatedIndex: apply && writtenFiles.length > 0,
178
+ skippedWrites,
166
179
  droppedBlocks,
167
180
  scanFailures
168
181
  };