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
@@ -25,12 +25,23 @@ export function formatCommitBoundaryPath(sessionId, requestId) {
25
25
  export function formatSkillUsageLessonsPath(sessionId) {
26
26
  return `.peaks/_runtime/${sessionId}/txt/skill-usage-lessons.md`;
27
27
  }
28
+ /**
29
+ * The artifact's own record of its type, or nothing when nobody chose one.
30
+ *
31
+ * `null` means `--type` was not passed. Emitting the default here would stamp a
32
+ * chosen-looking `- type: feature` onto every untyped request at the one moment
33
+ * the distinction is still knowable, and `extractMetadata` would then report
34
+ * every such request as declared. The absent line IS the record; the reader
35
+ * substitutes the default and labels it.
36
+ */
37
+ function renderTypeLine(requestType) {
38
+ return requestType === null ? '' : `- type: ${requestType}\n`;
39
+ }
28
40
  function renderPrdTemplate(requestId, _sessionId, sessionId, timestamp, requestType) {
29
41
  return (`# PRD Request ${requestId}
30
42
 
31
43
  - session: ${sessionId}
32
- - type: ${requestType}
33
- - source: <ticket, message URL, or "verbal" with a short sanitized quote>
44
+ ${renderTypeLine(requestType)}- source: <ticket, message URL, or "verbal" with a short sanitized quote>
34
45
  - raw input (sanitized): <one-paragraph restatement of what the user actually asked for>
35
46
 
36
47
  ` +
@@ -53,8 +64,7 @@ function renderUiTemplate(requestId, _sessionId, sessionId, timestamp, requestTy
53
64
 
54
65
  - session: ${sessionId}
55
66
  - linked-prd: ${formatHandoffPath(sessionId, 'prd', requestId)}
56
- - type: ${requestType}
57
- - scope: full new surface | iteration on existing surface | regression fix | visual refresh
67
+ ${renderTypeLine(requestType)}- scope: full new surface | iteration on existing surface | regression fix | visual refresh
58
68
  - design direction: editorial | bento | Swiss | luxury | retro-futurist | glass | product-system | other-explicit-name
59
69
 
60
70
  ` +
@@ -77,8 +87,7 @@ function renderRdTemplate(requestId, _sessionId, sessionId, timestamp, requestTy
77
87
  - session: ${sessionId}
78
88
  - linked-prd: ${formatHandoffPath(sessionId, 'prd', requestId)}
79
89
  - linked-ui: ${formatHandoffPath(sessionId, 'ui', requestId)} (when UI involved)
80
- - type: ${requestType}
81
-
90
+ ${renderTypeLine(requestType)}
82
91
  ` +
83
92
  RD_TEMPLATE_BODY +
84
93
  `## Handoff
@@ -100,8 +109,7 @@ function renderQaTemplate(requestId, _sessionId, sessionId, timestamp, requestTy
100
109
  - linked-prd: ${formatHandoffPath(sessionId, 'prd', requestId)}
101
110
  - linked-rd: ${formatHandoffPath(sessionId, 'rd', requestId)}
102
111
  - linked-ui: ${formatHandoffPath(sessionId, 'ui', requestId)} (when UI involved)
103
- - type: ${requestType}
104
-
112
+ ${renderTypeLine(requestType)}
105
113
  ` +
106
114
  QA_TEMPLATE_BODY +
107
115
  `## Status
@@ -119,8 +127,7 @@ function renderScTemplate(requestId, _sessionId, sessionId, timestamp, requestTy
119
127
  - linked-rd: ${formatHandoffPath(sessionId, 'rd', requestId)}
120
128
  - linked-qa: ${formatHandoffPath(sessionId, 'qa', requestId)}
121
129
  - linked-ui: ${formatHandoffPath(sessionId, 'ui', requestId)} (when UI involved)
122
- - type: ${requestType}
123
-
130
+ ${renderTypeLine(requestType)}
124
131
  ` +
125
132
  SC_TEMPLATE_BODY +
126
133
  `- artifact workspace path: .peaks/_runtime/${sessionId}/
@@ -0,0 +1,87 @@
1
+ /**
2
+ * How ONE prerequisite is judged: its body markers, and the soft-pass
3
+ * downgrade a missing file gets inside a back-compat window.
4
+ *
5
+ * WHY THIS IS A SIBLING AND NOT THREE MORE LINES IN THE TABLE.
6
+ * `artifact-prerequisites.ts` is over the 300-line file-size cap and
7
+ * `fileSizeExcessLines` is a ratchet that may only go DOWN
8
+ * (`.husky/peaks-gate-baseline-monotonic.mjs` — "Split the file; do not raise
9
+ * the ceiling"). The soft-pass branch this module was split out for must ADD
10
+ * lines to that file, so the body check its two enforcers share lives here,
11
+ * where the census counts no debt. `prerequisiteBodyViolations` moved verbatim;
12
+ * only its location changed.
13
+ */
14
+ import type { ArtifactPrerequisite } from './artifact-prerequisites.js';
15
+ /**
16
+ * The warning `code` for a prerequisite whose file is missing inside its
17
+ * back-compat window, derived from the prerequisite itself: the artifact's own
18
+ * filename stem plus the release that closes the window.
19
+ *
20
+ * The stem is what makes the code name WHICH artifact is missing — the branch
21
+ * this replaced emitted the literal `mut-report-missing-deprecated-in-v2.14.0`
22
+ * for EVERY `backCompat` prerequisite, so the `rd/third-party-review.md`
23
+ * warning carried the same code as the `mut/mut-report.json` one and a
24
+ * consumer filtering on it matched both. `backCompatUntil` keeps the
25
+ * deprecation semantics legible and is per-prerequisite, because the two live
26
+ * windows close in different releases (v2.14.0 and v2.15.0).
27
+ *
28
+ * The stem is taken verbatim: both prerequisites that carry `backCompat` name
29
+ * a fixed path, so no character is rewritten.
30
+ *
31
+ * TWO KNOWN LIMITS OF THE STEM, stated so neither is read as a guarantee:
32
+ * - a `<rid>`-templated soft prerequisite keeps the placeholder, producing
33
+ * the LITERAL `<rid>-missing-deprecated-in-…` — the same code for every
34
+ * request. The code is therefore not per-slice filterable. No live
35
+ * prerequisite carries `backCompat` with a `<rid>` path, so nothing
36
+ * filters on one today; the placeholder is the honest thing to print, and
37
+ * making it per-slice would mean resolving the rid into a code a consumer
38
+ * would have to know to match.
39
+ * - the stem comes from the FILENAME only, so two prerequisites sharing a
40
+ * stem collide (`x.md` and `x.json` both yield `x-…`). Measured 0 live
41
+ * collisions, and the pair that exists (`mut/mut-report.json` vs
42
+ * `rd/third-party-review.md`) differs by stem as well as by directory.
43
+ */
44
+ export declare function backCompatWarningCode(prerequisite: ArtifactPrerequisite): string;
45
+ /**
46
+ * The soft-pass warning for a missing `prerequisite`, or `null` when a missing
47
+ * file is a HARD failure and belongs in `missing` instead.
48
+ *
49
+ * The `null` is the whole decision, and it is the caller's only input to it. The
50
+ * invariant the two destinations have, stated exactly:
51
+ * - `warnings` does NOT feed `ok` — a soft pass is reported, never enforced,
52
+ * which is why this can be a warning at all;
53
+ * - `missing` IS what decides `ok` (`ok = missing.length === 0`), so choosing
54
+ * the `missing` branch is choosing to fail the gate. That is the point of
55
+ * the `null`, and the acceptance evidence for this change depends on it.
56
+ *
57
+ * `expiredWindow` is set only when the declared window has closed, so its
58
+ * PRESENCE is the verdict and `path` / `code` / `message` stay byte-identical for
59
+ * the consumers that already read them.
60
+ */
61
+ export declare function missingPrerequisiteWarning(prerequisite: ArtifactPrerequisite, relativePath: string, installedVersion?: string): {
62
+ path: string;
63
+ code: string;
64
+ message: string;
65
+ expiredWindow?: string;
66
+ } | null;
67
+ /**
68
+ * The contract's BODY checks for one prerequisite, applied to `body`. Returns
69
+ * one human-readable message per failed check, empty when the body satisfies
70
+ * the contract.
71
+ *
72
+ * Exported because this contract has a SECOND enforcer: `peaks workflow
73
+ * verify-pipeline` probes the same table for the paths it checks
74
+ * (`pipeline-verify-gate-support.ts`), and a resolver that probed only
75
+ * `existsSync` passed files this function rejects — a guard laxer than the
76
+ * contract it claims to read. Both callers now share this one implementation,
77
+ * so the checker cannot drift from the table again.
78
+ */
79
+ export declare function prerequisiteBodyViolations(prerequisite: ArtifactPrerequisite, body: string): string[];
80
+ /**
81
+ * The body violations for `prerequisite`, or `[]` when it declares no body
82
+ * contract — and in that case `read` is NEVER called, so a prerequisite with
83
+ * nothing to check never has its file opened (unchanged behaviour: the guard has
84
+ * always been a guard on the READ, which is why it takes the read as a thunk
85
+ * rather than the body).
86
+ */
87
+ export declare function bodyViolationsIfDeclared(prerequisite: ArtifactPrerequisite, read: () => Promise<string>): Promise<string[]>;
@@ -0,0 +1,198 @@
1
+ /**
2
+ * How ONE prerequisite is judged: its body markers, and the soft-pass
3
+ * downgrade a missing file gets inside a back-compat window.
4
+ *
5
+ * WHY THIS IS A SIBLING AND NOT THREE MORE LINES IN THE TABLE.
6
+ * `artifact-prerequisites.ts` is over the 300-line file-size cap and
7
+ * `fileSizeExcessLines` is a ratchet that may only go DOWN
8
+ * (`.husky/peaks-gate-baseline-monotonic.mjs` — "Split the file; do not raise
9
+ * the ceiling"). The soft-pass branch this module was split out for must ADD
10
+ * lines to that file, so the body check its two enforcers share lives here,
11
+ * where the census counts no debt. `prerequisiteBodyViolations` moved verbatim;
12
+ * only its location changed.
13
+ */
14
+ import { basename, extname } from 'node:path';
15
+ import { CLI_VERSION } from 'peaks-loop-shared/version';
16
+ /** Stands in for a `backCompatUntil` nobody declared. ONE token for BOTH sites
17
+ * — the warning code and the message — so the two cannot disagree, and
18
+ * token-shaped like the version it stands in for. No live prerequisite omits
19
+ * the field, so this is unreachable today; the honest placeholder beats
20
+ * asserting a release nobody set. */
21
+ const UNDECLARED_WINDOW = 'a-future-release';
22
+ /**
23
+ * The warning `code` for a prerequisite whose file is missing inside its
24
+ * back-compat window, derived from the prerequisite itself: the artifact's own
25
+ * filename stem plus the release that closes the window.
26
+ *
27
+ * The stem is what makes the code name WHICH artifact is missing — the branch
28
+ * this replaced emitted the literal `mut-report-missing-deprecated-in-v2.14.0`
29
+ * for EVERY `backCompat` prerequisite, so the `rd/third-party-review.md`
30
+ * warning carried the same code as the `mut/mut-report.json` one and a
31
+ * consumer filtering on it matched both. `backCompatUntil` keeps the
32
+ * deprecation semantics legible and is per-prerequisite, because the two live
33
+ * windows close in different releases (v2.14.0 and v2.15.0).
34
+ *
35
+ * The stem is taken verbatim: both prerequisites that carry `backCompat` name
36
+ * a fixed path, so no character is rewritten.
37
+ *
38
+ * TWO KNOWN LIMITS OF THE STEM, stated so neither is read as a guarantee:
39
+ * - a `<rid>`-templated soft prerequisite keeps the placeholder, producing
40
+ * the LITERAL `<rid>-missing-deprecated-in-…` — the same code for every
41
+ * request. The code is therefore not per-slice filterable. No live
42
+ * prerequisite carries `backCompat` with a `<rid>` path, so nothing
43
+ * filters on one today; the placeholder is the honest thing to print, and
44
+ * making it per-slice would mean resolving the rid into a code a consumer
45
+ * would have to know to match.
46
+ * - the stem comes from the FILENAME only, so two prerequisites sharing a
47
+ * stem collide (`x.md` and `x.json` both yield `x-…`). Measured 0 live
48
+ * collisions, and the pair that exists (`mut/mut-report.json` vs
49
+ * `rd/third-party-review.md`) differs by stem as well as by directory.
50
+ */
51
+ export function backCompatWarningCode(prerequisite) {
52
+ const stem = basename(prerequisite.relativePath, extname(prerequisite.relativePath));
53
+ return `${stem}-missing-deprecated-in-${prerequisite.backCompatUntil ?? UNDECLARED_WINDOW}`;
54
+ }
55
+ /** How many segments a release string is compared by: `MAJOR.MINOR.PATCH`. Named
56
+ * because the count is a policy (what a release string means here), not a loop
57
+ * detail, and both the parse and the compare read it. */
58
+ const RELEASE_SEGMENTS = 3;
59
+ /**
60
+ * The declared window's `MAJOR.MINOR.PATCH`, as three numbers, from a release
61
+ * string. Only the leading triple is read: a prerelease suffix (`-beta.11`)
62
+ * compares as its release triple, and a segment that is missing or not a number
63
+ * reads as 0. Both limits are stated rather than guarded, because every
64
+ * declaration in the table is a plain `vX.Y.Z`.
65
+ */
66
+ function releaseTriple(version) {
67
+ const segments = (version.replace(/^v/i, '').split('-')[0] ?? '').split('.');
68
+ const triple = [];
69
+ for (let index = 0; index < RELEASE_SEGMENTS; index += 1) {
70
+ const parsed = Number.parseInt(segments[index] ?? '', 10);
71
+ triple.push(Number.isNaN(parsed) ? 0 : parsed);
72
+ }
73
+ return triple;
74
+ }
75
+ /** Negative when `a` predates `b`, positive when it follows, 0 when their
76
+ * release triples are equal. */
77
+ function compareReleaseVersions(a, b) {
78
+ const left = releaseTriple(a);
79
+ const right = releaseTriple(b);
80
+ for (let index = 0; index < RELEASE_SEGMENTS; index += 1) {
81
+ const difference = (left[index] ?? 0) - (right[index] ?? 0);
82
+ if (difference !== 0)
83
+ return difference < 0 ? -1 : 1;
84
+ }
85
+ return 0;
86
+ }
87
+ /**
88
+ * The certificate for a soft pass whose window has closed, or `null` while the
89
+ * window is still open. It names BOTH releases, so a reader sees the comparison
90
+ * rather than a verdict — the release the table declared, and the build it was
91
+ * compared against.
92
+ *
93
+ * A window closing AT the running release counts as closed: the declared release
94
+ * is the one that removes the soft pass, so on that release there is none left.
95
+ *
96
+ * `installedVersion` is a parameter rather than a closed-over constant so a test
97
+ * can drive both sides of the boundary without depending on the release this
98
+ * repository happens to be building; the default is the version this build ships.
99
+ */
100
+ function expiredWindowClause(prerequisite, installedVersion) {
101
+ const until = prerequisite.backCompatUntil;
102
+ if (until === undefined)
103
+ return null;
104
+ if (compareReleaseVersions(installedVersion, until) < 0)
105
+ return null;
106
+ return `${until} (installed ${installedVersion})`;
107
+ }
108
+ /**
109
+ * The soft-pass warning for a missing `prerequisite`, or `null` when a missing
110
+ * file is a HARD failure and belongs in `missing` instead.
111
+ *
112
+ * The `null` is the whole decision, and it is the caller's only input to it. The
113
+ * invariant the two destinations have, stated exactly:
114
+ * - `warnings` does NOT feed `ok` — a soft pass is reported, never enforced,
115
+ * which is why this can be a warning at all;
116
+ * - `missing` IS what decides `ok` (`ok = missing.length === 0`), so choosing
117
+ * the `missing` branch is choosing to fail the gate. That is the point of
118
+ * the `null`, and the acceptance evidence for this change depends on it.
119
+ *
120
+ * `expiredWindow` is set only when the declared window has closed, so its
121
+ * PRESENCE is the verdict and `path` / `code` / `message` stay byte-identical for
122
+ * the consumers that already read them.
123
+ */
124
+ export function missingPrerequisiteWarning(prerequisite, relativePath, installedVersion = CLI_VERSION) {
125
+ if (prerequisite.backCompat !== true)
126
+ return null;
127
+ const until = prerequisite.backCompatUntil ?? UNDECLARED_WINDOW;
128
+ const expiredWindow = expiredWindowClause(prerequisite, installedVersion);
129
+ return {
130
+ path: relativePath,
131
+ code: backCompatWarningCode(prerequisite),
132
+ message: `${prerequisite.description} — file missing; soft-blocked under the back-compat window. ${until} hard-fail.`,
133
+ ...(expiredWindow === null ? {} : { expiredWindow })
134
+ };
135
+ }
136
+ /**
137
+ * The contract's BODY checks for one prerequisite, applied to `body`. Returns
138
+ * one human-readable message per failed check, empty when the body satisfies
139
+ * the contract.
140
+ *
141
+ * Exported because this contract has a SECOND enforcer: `peaks workflow
142
+ * verify-pipeline` probes the same table for the paths it checks
143
+ * (`pipeline-verify-gate-support.ts`), and a resolver that probed only
144
+ * `existsSync` passed files this function rejects — a guard laxer than the
145
+ * contract it claims to read. Both callers now share this one implementation,
146
+ * so the checker cannot drift from the table again.
147
+ */
148
+ export function prerequisiteBodyViolations(prerequisite, body) {
149
+ const violations = [];
150
+ const lowered = body.toLowerCase();
151
+ if (prerequisite.mustContain && prerequisite.mustContain.length > 0) {
152
+ const missingMarkers = prerequisite.mustContain.filter((marker) => !lowered.includes(marker.toLowerCase()));
153
+ if (missingMarkers.length > 0) {
154
+ violations.push(`${prerequisite.description} — missing section(s): ${missingMarkers.join(', ')}`);
155
+ }
156
+ }
157
+ if (prerequisite.headingMustContain && prerequisite.headingMustContain.length > 0) {
158
+ // Slice 2.6.1.F: a line beginning with `#`, `##`, or `###` followed by
159
+ // the marker (case-insensitive). Fenced code blocks are NOT excluded
160
+ // here — a "heading" inside a code fence is rare and, when present,
161
+ // should still be reported as missing to keep the contract strict.
162
+ const headingLines = body
163
+ .split('\n')
164
+ .map((line) => line.trim())
165
+ .filter((line) => /^#{1,3}\s+/.test(line));
166
+ const loweredHeadings = headingLines.map((h) => h.toLowerCase());
167
+ const missingHeadings = prerequisite.headingMustContain.filter((marker) => !loweredHeadings.some((h) => h.includes(marker.toLowerCase())));
168
+ if (missingHeadings.length > 0) {
169
+ violations.push(`${prerequisite.description} — missing heading(s): ${missingHeadings.join(', ')}`);
170
+ }
171
+ }
172
+ if (prerequisite.mustContainAny && prerequisite.mustContainAny.length > 0) {
173
+ const hitAny = prerequisite.mustContainAny.some((marker) => lowered.includes(marker.toLowerCase()));
174
+ if (!hitAny) {
175
+ violations.push(`${prerequisite.description} — none of the escape-hatch markers present: ${prerequisite.mustContainAny.join(', ')}`);
176
+ }
177
+ }
178
+ return violations;
179
+ }
180
+ /** True when `prerequisite` declares any body check at all. Private on purpose:
181
+ * its ONE caller is `bodyViolationsIfDeclared` below. */
182
+ function hasBodyChecks(prerequisite) {
183
+ return ((prerequisite.mustContain?.length ?? 0) > 0 ||
184
+ (prerequisite.headingMustContain?.length ?? 0) > 0 ||
185
+ (prerequisite.mustContainAny?.length ?? 0) > 0);
186
+ }
187
+ /**
188
+ * The body violations for `prerequisite`, or `[]` when it declares no body
189
+ * contract — and in that case `read` is NEVER called, so a prerequisite with
190
+ * nothing to check never has its file opened (unchanged behaviour: the guard has
191
+ * always been a guard on the READ, which is why it takes the read as a thunk
192
+ * rather than the body).
193
+ */
194
+ export async function bodyViolationsIfDeclared(prerequisite, read) {
195
+ if (!hasBodyChecks(prerequisite))
196
+ return [];
197
+ return prerequisiteBodyViolations(prerequisite, await read());
198
+ }
@@ -0,0 +1,20 @@
1
+ import type { PrerequisiteCheckResult } from './artifact-prerequisites.js';
2
+ import type { RequestArtifactRole } from './artifact-templates.js';
3
+ import type { RequestArtifactState } from './request-artifact-state-helpers.js';
4
+ /**
5
+ * Slice C of v2.11.1 — observability hook #7/7. Fire-and-forget per PRD Q4. The
6
+ * synchronous emit never throws and never blocks the prereq check's return
7
+ * value.
8
+ *
9
+ * Split out when `checkPrerequisites` gained the `emitEvents: false` opt-out:
10
+ * the emit and the decision to skip it are one story, and the caller is over its
11
+ * file-size cap. Body moved verbatim.
12
+ */
13
+ export declare function emitPrereqTransitionEvent(opts: {
14
+ projectRoot: string;
15
+ sessionId: string;
16
+ role: RequestArtifactRole;
17
+ newState: RequestArtifactState;
18
+ requestId: string;
19
+ result: PrerequisiteCheckResult;
20
+ }): void;
@@ -0,0 +1,27 @@
1
+ import { emitObservabilityEvent } from '../observability/observability-service.js';
2
+ /**
3
+ * Slice C of v2.11.1 — observability hook #7/7. Fire-and-forget per PRD Q4. The
4
+ * synchronous emit never throws and never blocks the prereq check's return
5
+ * value.
6
+ *
7
+ * Split out when `checkPrerequisites` gained the `emitEvents: false` opt-out:
8
+ * the emit and the decision to skip it are one story, and the caller is over its
9
+ * file-size cap. Body moved verbatim.
10
+ */
11
+ export function emitPrereqTransitionEvent(opts) {
12
+ if (opts.sessionId === undefined)
13
+ return;
14
+ emitObservabilityEvent({
15
+ schemaVersion: 1,
16
+ ts: new Date().toISOString(),
17
+ sessionId: opts.sessionId,
18
+ category: 'slice-transition',
19
+ sliceRid: opts.requestId,
20
+ detail: {
21
+ artifactRole: opts.role,
22
+ to: opts.newState,
23
+ prereqOk: opts.result.ok,
24
+ missingCount: opts.result.missing.length
25
+ }
26
+ }, { projectRoot: opts.projectRoot });
27
+ }
@@ -0,0 +1,31 @@
1
+ import { type RequestType } from './artifact-prerequisites.js';
2
+ /**
3
+ * Where a request artifact's effective type came from.
4
+ *
5
+ * `default` means the body carried no usable `- type:` line, so
6
+ * `DEFAULT_REQUEST_TYPE` was substituted. Nothing else in the repository tells
7
+ * that apart from a deliberate `- type: feature`, and the substitution has a
8
+ * price: measured 2026-10-13 through `getPrerequisitesFor`, the `feature` row at
9
+ * `rd:qa-handoff` demands 9 artifacts, `bugfix` 10, `docs` and `chore` none. The
10
+ * locked PRD handoff for this slice states 10 for `feature`; 9 is what the
11
+ * function returns.
12
+ *
13
+ * `peaks request init` writes a type line only when `--type` was passed, so the
14
+ * absence of the line survives creation instead of being stamped over with the
15
+ * default at the moment the distinction is first knowable.
16
+ */
17
+ export type RequestTypeSource = 'declared' | 'default';
18
+ export type ArtifactMetadata = {
19
+ state: string;
20
+ requestType: RequestType;
21
+ requestTypeSource: RequestTypeSource;
22
+ createdAt?: string;
23
+ sessionId?: string;
24
+ };
25
+ /**
26
+ * Read the fields of a request artifact body. Moved verbatim out of
27
+ * `request-artifact-service.ts` when the type's provenance was added; the only
28
+ * behaviour change is `requestTypeSource`, which records whether a usable
29
+ * `- type:` line was actually present.
30
+ */
31
+ export declare function extractMetadata(markdown: string): ArtifactMetadata;
@@ -0,0 +1,44 @@
1
+ import { DEFAULT_REQUEST_TYPE, isRequestType } from './artifact-prerequisites.js';
2
+ import { readArtifactState } from './request-artifact-state-helpers.js';
3
+ /**
4
+ * Read the fields of a request artifact body. Moved verbatim out of
5
+ * `request-artifact-service.ts` when the type's provenance was added; the only
6
+ * behaviour change is `requestTypeSource`, which records whether a usable
7
+ * `- type:` line was actually present.
8
+ */
9
+ export function extractMetadata(markdown) {
10
+ const state = readArtifactState(markdown) ?? 'unknown';
11
+ let createdAt;
12
+ let requestType = DEFAULT_REQUEST_TYPE;
13
+ let requestTypeSource = 'default';
14
+ let sessionId;
15
+ for (const rawLine of markdown.split(/\r?\n/)) {
16
+ const line = rawLine.trim();
17
+ const createdMatch = /^-\s*created:\s*(.+?)\s*$/.exec(line);
18
+ if (createdMatch !== null && createdMatch[1] !== undefined) {
19
+ createdAt = createdMatch[1];
20
+ continue;
21
+ }
22
+ const typeMatch = /^-\s*type:\s*(.+?)\s*$/.exec(line);
23
+ if (typeMatch !== null && typeMatch[1] !== undefined) {
24
+ const candidate = typeMatch[1];
25
+ if (isRequestType(candidate)) {
26
+ requestType = candidate;
27
+ requestTypeSource = 'declared';
28
+ }
29
+ // Placeholder values (e.g. "feature | bug | refactor | clarification") fall back to default.
30
+ continue;
31
+ }
32
+ const sessionMatch = /^-\s*session:\s*(.+?)\s*$/.exec(line);
33
+ if (sessionMatch !== null && sessionMatch[1] !== undefined) {
34
+ sessionId = sessionMatch[1];
35
+ continue;
36
+ }
37
+ }
38
+ const base = { state, requestType, requestTypeSource };
39
+ if (createdAt !== undefined)
40
+ base.createdAt = createdAt;
41
+ if (sessionId !== undefined)
42
+ base.sessionId = sessionId;
43
+ return base;
44
+ }
@@ -1,4 +1,5 @@
1
1
  import { DEFAULT_REQUEST_TYPE, isRequestType, VALID_REQUEST_TYPES, type PrerequisiteCheckResult, type RequestType } from './artifact-prerequisites.js';
2
+ import { type RequestTypeSource } from './request-artifact-metadata.js';
2
3
  export { VALID_REQUEST_TYPES, DEFAULT_REQUEST_TYPE, isRequestType, type RequestType };
3
4
  import { type RequestArtifactRole } from './artifact-templates.js';
4
5
  export type { RequestArtifactRole } from './artifact-templates.js';
@@ -74,6 +75,8 @@ export type RequestArtifactSummary = {
74
75
  path: string;
75
76
  state: string;
76
77
  requestType: RequestType;
78
+ /** Whether `requestType` was recorded in the body or substituted. See `RequestTypeSource`. */
79
+ requestTypeSource: RequestTypeSource;
77
80
  createdAt?: string;
78
81
  };
79
82
  export type ListRequestArtifactsOptions = {
@@ -112,6 +115,8 @@ export type TransitionRequestArtifactResult = RequestArtifactSummary & {
112
115
  previousState: string;
113
116
  content: string;
114
117
  bypassedPrerequisites?: PrerequisiteCheckResult;
118
+ /** Soft-passed prerequisites on a SUCCESSFUL transition (set only when non-empty). Never affects `ok`. */
119
+ prerequisiteWarnings?: PrerequisiteCheckResult['warnings'];
115
120
  };
116
121
  import { type RequestArtifactState } from './request-artifact-state-helpers.js';
117
122
  export { allowedStatesForRole, FileSizeViolationError, LintGateError, PrerequisitesNotSatisfiedError, TypeSanityViolationError, updateStatusBlock } from './request-artifact-state-helpers.js';
@@ -8,7 +8,8 @@ import { ensureSession, getSessionIdCanonical } from '../session/session-manager
8
8
  // gone; request-artifact callers pass `options.sessionId` explicitly
9
9
  // or accept the requestId as the default. Path-safety helpers now
10
10
  // live at `shared/path-safety.ts` if this module ever needs them.
11
- import { getNextNumber, buildNumberedFilename, slugifyDescription } from '../../shared/incrementing-number.js';
11
+ import { getNextNumber, buildNumberedFilename, requestIdFromFileName, slugifyDescription } from '../../shared/incrementing-number.js';
12
+ import { extractMetadata } from './request-artifact-metadata.js';
12
13
  import { lintRequestArtifact } from './artifact-lint-service.js';
13
14
  import { isUnsafePathInput } from '../../shared/path-safety.js';
14
15
  import { guardRuntimeSegment, runtimeRoot } from '../../shared/runtime-root.js';
@@ -74,7 +75,6 @@ export async function createRequestArtifact(options) {
74
75
  if (!REQUEST_ID_PATTERN.test(options.requestId)) {
75
76
  throw new Error(`Invalid request id: ${options.requestId} (expected letters, digits, dots, underscores, or dashes)`);
76
77
  }
77
- const requestType = options.requestType ?? DEFAULT_REQUEST_TYPE;
78
78
  const clock = options.clock ?? defaultClock;
79
79
  const timestamp = clock();
80
80
  // Use provided session ID or get/create current session. The session
@@ -144,7 +144,10 @@ export async function createRequestArtifact(options) {
144
144
  const number = getNextNumber(requestsDir);
145
145
  const filename = buildNumberedFilename(number, options.requestId);
146
146
  const path = join(requestsDir, filename);
147
- const content = renderTemplate(options.role, options.requestId, sessionId, sessionSlug, timestamp, requestType);
147
+ const content = renderTemplate(options.role, options.requestId, sessionId, sessionSlug, timestamp,
148
+ // `null`, not the default: an untyped request records no type, so the
149
+ // reader's substitution stays visible as a substitution.
150
+ options.requestType ?? null);
148
151
  if (options.apply !== true) {
149
152
  // session-axis dir (`.peaks/_runtime/<sid>/`). Pre-resolved here
150
153
  // so dry-run output reports the canonical scope location.
@@ -183,47 +186,12 @@ export async function createRequestArtifact(options) {
183
186
  ...(options.callerId !== undefined ? { callerId: options.callerId } : {})
184
187
  };
185
188
  }
186
- function extractMetadata(markdown) {
187
- const state = readArtifactState(markdown) ?? 'unknown';
188
- let createdAt;
189
- let requestType = DEFAULT_REQUEST_TYPE;
190
- let sessionId;
191
- for (const rawLine of markdown.split(/\r?\n/)) {
192
- const line = rawLine.trim();
193
- const createdMatch = /^-\s*created:\s*(.+?)\s*$/.exec(line);
194
- if (createdMatch !== null && createdMatch[1] !== undefined) {
195
- createdAt = createdMatch[1];
196
- continue;
197
- }
198
- const typeMatch = /^-\s*type:\s*(.+?)\s*$/.exec(line);
199
- if (typeMatch !== null && typeMatch[1] !== undefined) {
200
- const candidate = typeMatch[1];
201
- if (isRequestType(candidate)) {
202
- requestType = candidate;
203
- }
204
- // Placeholder values (e.g. "feature | bug | refactor | clarification") fall back to default.
205
- continue;
206
- }
207
- const sessionMatch = /^-\s*session:\s*(.+?)\s*$/.exec(line);
208
- if (sessionMatch !== null && sessionMatch[1] !== undefined) {
209
- sessionId = sessionMatch[1];
210
- continue;
211
- }
212
- }
213
- const base = { state, requestType };
214
- if (createdAt !== undefined)
215
- base.createdAt = createdAt;
216
- if (sessionId !== undefined)
217
- base.sessionId = sessionId;
218
- return base;
219
- }
220
189
  async function readSummary(dir, role, fileName, sessionId) {
221
190
  const path = join(dir, fileName);
222
191
  const body = await readFile(path, 'utf8');
223
- const { state, createdAt, requestType, sessionId: bodySessionId } = extractMetadata(body);
224
- // Strip numbered prefix (e.g., "001-requestId.md" -> "requestId")
225
- // Only strip 3-digit zero-padded prefixes (our incrementing number format)
226
- const requestId = fileName.replace(/^0\d{2}-/, '').replace(/\.md$/, '');
192
+ const { state, createdAt, requestType, requestTypeSource, sessionId: bodySessionId } = extractMetadata(body);
193
+ // The id, stripped by the rule that writes the prefix (see `buildNumberedFilename`).
194
+ const requestId = requestIdFromFileName(fileName) ?? fileName.replace(/\.md$/, '');
227
195
  // Repair R5: this used to take the *scope* path fragment (`_runtime/<sid>`)
228
196
  // and re-join it onto the project root, then strip the prefix back off to
229
197
  // recover the bare session id. The round-trip was the escape's carrier — an
@@ -237,6 +205,7 @@ async function readSummary(dir, role, fileName, sessionId) {
237
205
  path,
238
206
  state,
239
207
  requestType,
208
+ requestTypeSource,
240
209
  writerSessionId: bodySessionId ?? sessionId
241
210
  };
242
211
  if (createdAt !== undefined) {
@@ -364,7 +333,8 @@ async function readRequestArtifact(dir, role, found, sessionId) {
364
333
  // the sibling `request-artifact-state-helpers.ts` module — see
365
334
  // v2.18.3 file-split for the rationale. Function signatures and
366
335
  // behaviour are unchanged (verbatim move).
367
- import { ALLOWED_STATES_PER_ROLE, FileSizeViolationError, LintGateError, PrerequisitesNotSatisfiedError, readArtifactState, TypeSanityViolationError, updateStatusBlock } from './request-artifact-state-helpers.js';
336
+ import { ALLOWED_STATES_PER_ROLE, FileSizeViolationError, LintGateError, PrerequisitesNotSatisfiedError, TypeSanityViolationError, updateStatusBlock } from './request-artifact-state-helpers.js';
337
+ import { assertLegalStateStep } from './request-state-order.js';
368
338
  export { allowedStatesForRole, FileSizeViolationError, LintGateError, PrerequisitesNotSatisfiedError, TypeSanityViolationError, updateStatusBlock } from './request-artifact-state-helpers.js';
369
339
  export async function transitionRequestArtifact(options) {
370
340
  if (!VALID_ROLES.has(options.role)) {
@@ -397,6 +367,8 @@ export async function transitionRequestArtifact(options) {
397
367
  confirmed: options.confirmed,
398
368
  forceConfirm: options.forceConfirm
399
369
  });
370
+ // A forward jump past an intermediate state is refused (request-state-order.ts).
371
+ assertLegalStateStep(options.role, existing.state, options.newState, options.allowIncomplete === true);
400
372
  const prerequisiteResult = await checkPrerequisites({
401
373
  projectRoot: options.projectRoot,
402
374
  sessionId: existing.sessionId,
@@ -408,9 +380,6 @@ export async function transitionRequestArtifact(options) {
408
380
  if (!prerequisiteResult.ok && options.allowIncomplete !== true) {
409
381
  throw new PrerequisitesNotSatisfiedError(options.role, options.newState, existing.sessionId, prerequisiteResult.missing, prerequisiteResult.warnings);
410
382
  }
411
- // (Removed in v2.11.0 Group A: the tech-doc-presence + tech-doc-mandatory-
412
- // sections gates. The rd → spec-locked transition now relies on the
413
- // immutable peaks-prd handoff (sha256-frontmatter) for the same intent;
414
383
  // Type sanity check for PRD handoff
415
384
  if (options.typeSanityCheck !== undefined &&
416
385
  options.role === 'prd' &&
@@ -438,7 +407,7 @@ export async function transitionRequestArtifact(options) {
438
407
  }
439
408
  }
440
409
  }
441
- // File size gate: when RD declares implemented, scan for oversized files (karpathy-skills "Simplicity First")
410
+ // File-size ratchet: refuse only a file this change made worse (Simplicity First).
442
411
  if (options.role === 'rd' &&
443
412
  options.newState === 'implemented' &&
444
413
  options.allowIncomplete !== true) {
@@ -458,11 +427,8 @@ export async function transitionRequestArtifact(options) {
458
427
  const reasonForNote = combinedReason.length > 0 ? combinedReason : undefined;
459
428
  const { updated, previousState } = updateStatusBlock(existing.content, options.newState, timestamp, reasonForNote);
460
429
  await writeFile(existing.path, updated, 'utf8');
461
- // Slice v2.11.1 — observability hook #1/7. Fire-and-forget emit per
462
- // PRD Q4 (full-auto must never fail-loud on observability). The
463
- // synchronous `emitObservabilityEvent` returns `{written: false}` on
464
- // any error path; we deliberately ignore the result so the
465
- // transition contract remains unchanged.
430
+ // Fire-and-forget: the synchronous emit returns `{written: false}` on any
431
+ // error path and we ignore it, so observability never fails the transition.
466
432
  emitObservabilityEvent({
467
433
  schemaVersion: 1,
468
434
  ts: timestamp,
@@ -483,6 +449,7 @@ export async function transitionRequestArtifact(options) {
483
449
  path: existing.path,
484
450
  state: options.newState,
485
451
  requestType: existing.requestType,
452
+ requestTypeSource: existing.requestTypeSource,
486
453
  previousState,
487
454
  content: updated
488
455
  };
@@ -492,5 +459,10 @@ export async function transitionRequestArtifact(options) {
492
459
  if (!prerequisiteResult.ok && options.allowIncomplete === true) {
493
460
  result.bypassedPrerequisites = prerequisiteResult;
494
461
  }
462
+ // Soft-passed prerequisites travel on the SUCCESS path too, not only inside
463
+ // the throw above — otherwise `ok: true` drops what it soft-passed.
464
+ if (prerequisiteResult.warnings.length > 0) {
465
+ result.prerequisiteWarnings = prerequisiteResult.warnings;
466
+ }
495
467
  return result;
496
468
  }