peaks-loop 4.1.4 → 4.1.6

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 (294) hide show
  1. package/.claude-plugin/marketplace.json +7 -2
  2. package/CHANGELOG.md +148 -0
  3. package/README-en.md +47 -183
  4. package/README.md +24 -188
  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/best-practice-scan-command.d.ts +11 -6
  9. package/dist/cli/commands/best-practice-scan-command.js +35 -20
  10. package/dist/cli/commands/best-practice-scan-helpers.d.ts +47 -0
  11. package/dist/cli/commands/best-practice-scan-helpers.js +88 -5
  12. package/dist/cli/commands/best-practice-scan-lookup-results.d.ts +13 -0
  13. package/dist/cli/commands/best-practice-scan-lookup-results.js +237 -0
  14. package/dist/cli/commands/code-commands.d.ts +6 -4
  15. package/dist/cli/commands/code-commands.js +6 -4
  16. package/dist/cli/commands/code-gate-command.d.ts +5 -5
  17. package/dist/cli/commands/code-gate-command.js +49 -9
  18. package/dist/cli/commands/code-mode-gate-plan-command.d.ts +1 -1
  19. package/dist/cli/commands/code-mode-gate-plan-command.js +2 -2
  20. package/dist/cli/commands/core/memory-extract-command.js +10 -5
  21. package/dist/cli/commands/dispatch-cli-invocation-check.d.ts +108 -0
  22. package/dist/cli/commands/dispatch-cli-invocation-check.js +87 -0
  23. package/dist/cli/commands/dispatch-cli-invocation-scan.d.ts +66 -0
  24. package/dist/cli/commands/dispatch-cli-invocation-scan.js +162 -0
  25. package/dist/cli/commands/dispatch-command-spec.js +1 -1
  26. package/dist/cli/commands/dispatch-commands.js +12 -5
  27. package/dist/cli/commands/dispatch-isolation-lease.d.ts +1 -1
  28. package/dist/cli/commands/dispatch-isolation-lease.js +6 -53
  29. package/dist/cli/commands/dispatch-preflight.js +46 -0
  30. package/dist/cli/commands/dispatch-prompt-blocks.d.ts +1 -1
  31. package/dist/cli/commands/dispatch-prompt-composition.d.ts +7 -1
  32. package/dist/cli/commands/dispatch-prompt-composition.js +29 -7
  33. package/dist/cli/commands/dispatch-record-write.d.ts +1 -1
  34. package/dist/cli/commands/dispatch-tool-call.d.ts +1 -1
  35. package/dist/cli/commands/doc-commands.js +1 -1
  36. package/dist/cli/commands/feedback-commands-helpers.js +1 -1
  37. package/dist/cli/commands/final-review-prepare-command.js +22 -1
  38. package/dist/cli/commands/gate-commands-enforce.js +3 -3
  39. package/dist/cli/commands/hook-handle.js +41 -20
  40. package/dist/cli/commands/lint-commands.js +3 -1
  41. package/dist/cli/commands/loop-eval-capture-index.js +2 -4
  42. package/dist/cli/commands/openspec-command-shared.js +2 -2
  43. package/dist/cli/commands/perf-audit-commands.js +15 -5
  44. package/dist/cli/commands/project-commands.js +9 -6
  45. package/dist/cli/commands/race-commands.d.ts +15 -0
  46. package/dist/cli/commands/race-commands.js +65 -0
  47. package/dist/cli/commands/race-pilot-gate-record-command.d.ts +3 -0
  48. package/dist/cli/commands/race-pilot-gate-record-command.js +81 -0
  49. package/dist/cli/commands/request-command-options.d.ts +8 -0
  50. package/dist/cli/commands/request-commands.js +2 -0
  51. package/dist/cli/commands/request-init-command.js +67 -12
  52. package/dist/cli/commands/{vm-status-command.d.ts → request-retag-command.d.ts} +1 -1
  53. package/dist/cli/commands/request-retag-command.js +50 -0
  54. package/dist/cli/commands/request-show-command.d.ts +8 -0
  55. package/dist/cli/commands/request-show-command.js +14 -1
  56. package/dist/cli/commands/request-transition-command.js +12 -4
  57. package/dist/cli/commands/request-transition-failures.d.ts +14 -0
  58. package/dist/cli/commands/request-transition-failures.js +76 -7
  59. package/dist/cli/commands/request-transition-preflight.js +1 -1
  60. package/dist/cli/commands/scan-scope-commands.js +2 -2
  61. package/dist/cli/commands/security-audit-commands.js +26 -6
  62. package/dist/cli/commands/slice-decompose-artifacts.js +2 -1
  63. package/dist/cli/commands/verdict-aggregate-command.js +2 -1
  64. package/dist/cli/commands/workflow-gate-commands.js +4 -4
  65. package/dist/cli/commands/worktree-lease-gc-command.js +1 -1
  66. package/dist/cli/program.js +0 -2
  67. package/dist/services/artifacts/artifact-contract-block.d.ts +53 -0
  68. package/dist/services/artifacts/artifact-contract-block.js +231 -0
  69. package/dist/services/artifacts/artifact-prerequisites.d.ts +27 -19
  70. package/dist/services/artifacts/artifact-prerequisites.js +65 -135
  71. package/dist/services/artifacts/artifact-templates.d.ts +1 -1
  72. package/dist/services/artifacts/artifact-templates.js +17 -10
  73. package/dist/services/artifacts/prerequisite-checks.d.ts +87 -0
  74. package/dist/services/artifacts/prerequisite-checks.js +198 -0
  75. package/dist/services/artifacts/prerequisite-transition-event.d.ts +20 -0
  76. package/dist/services/artifacts/prerequisite-transition-event.js +27 -0
  77. package/dist/services/artifacts/rd-transition-gates.d.ts +33 -0
  78. package/dist/services/artifacts/rd-transition-gates.js +71 -0
  79. package/dist/services/artifacts/request-artifact-metadata.d.ts +31 -0
  80. package/dist/services/artifacts/request-artifact-metadata.js +44 -0
  81. package/dist/services/artifacts/request-artifact-service.d.ts +5 -0
  82. package/dist/services/artifacts/request-artifact-service.js +43 -69
  83. package/dist/services/artifacts/request-artifact-state-helpers.d.ts +21 -1
  84. package/dist/services/artifacts/request-artifact-state-helpers.js +34 -8
  85. package/dist/services/artifacts/request-retag-service.d.ts +68 -0
  86. package/dist/services/artifacts/request-retag-service.js +125 -0
  87. package/dist/services/artifacts/request-state-order.d.ts +38 -0
  88. package/dist/services/artifacts/request-state-order.js +99 -0
  89. package/dist/services/artifacts/request-type-demand.d.ts +44 -0
  90. package/dist/services/artifacts/request-type-demand.js +71 -0
  91. package/dist/services/audit/audit-goal-service.d.ts +7 -0
  92. package/dist/services/audit/enforcers/active-skill-resolver.d.ts +18 -0
  93. package/dist/services/audit/enforcers/active-skill-resolver.js +48 -1
  94. package/dist/services/audit/enforcers/code-ban.d.ts +11 -2
  95. package/dist/services/audit/enforcers/code-ban.js +21 -1
  96. package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.d.ts +17 -0
  97. package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.js +24 -7
  98. package/dist/services/audit-independent/handoff-missing-refusal.d.ts +26 -0
  99. package/dist/services/audit-independent/handoff-missing-refusal.js +109 -0
  100. package/dist/services/audit-independent/handoff-readers.d.ts +37 -0
  101. package/dist/services/audit-independent/handoff-readers.js +81 -0
  102. package/dist/services/audit-independent/index.d.ts +6 -1
  103. package/dist/services/audit-independent/index.js +6 -1
  104. package/dist/services/audit-independent/judged-declaration-build.d.ts +48 -0
  105. package/dist/services/audit-independent/judged-declaration-build.js +73 -0
  106. package/dist/services/audit-independent/judged-declaration-check.d.ts +80 -0
  107. package/dist/services/audit-independent/judged-declaration-check.js +216 -0
  108. package/dist/services/audit-independent/judged-declaration.d.ts +94 -0
  109. package/dist/services/audit-independent/judged-declaration.js +218 -0
  110. package/dist/services/audit-independent/perf-audit-service.js +12 -14
  111. package/dist/services/audit-independent/security-audit-artifact.d.ts +28 -0
  112. package/dist/services/audit-independent/security-audit-artifact.js +90 -0
  113. package/dist/services/audit-independent/security-audit-service.d.ts +6 -53
  114. package/dist/services/audit-independent/security-audit-service.js +34 -178
  115. package/dist/services/capability-guard-runner/contracts/J05.js +60 -14
  116. package/dist/services/codegraph/codegraph-index-integrity.js +2 -0
  117. package/dist/services/context/build-dispatch-system-prompt.d.ts +8 -12
  118. package/dist/services/context/build-dispatch-system-prompt.js +18 -18
  119. package/dist/services/context/collector.js +5 -1
  120. package/dist/services/context/post-compact-reinjection.js +1 -1
  121. package/dist/services/dispatch/active-dispatch-index.d.ts +36 -0
  122. package/dist/services/dispatch/active-dispatch-index.js +118 -0
  123. package/dist/services/dispatch/batch-counter.js +1 -2
  124. package/dist/services/dispatch/dispatch-record-writer.d.ts +29 -16
  125. package/dist/services/dispatch/dispatch-record-writer.js +58 -100
  126. package/dist/services/dispatch/dispatch-sub-agent.js +1 -1
  127. package/dist/services/dispatch/karpathy-block.d.ts +55 -0
  128. package/dist/services/dispatch/karpathy-block.js +101 -0
  129. package/dist/services/dispatch/ledger-reaper.d.ts +80 -0
  130. package/dist/services/dispatch/ledger-reaper.js +131 -0
  131. package/dist/services/dispatch/test-tool-detection.d.ts +17 -1
  132. package/dist/services/dispatch/test-tool-detection.js +12 -1
  133. package/dist/services/evidence/evidence-generator.js +23 -12
  134. package/dist/services/feedback/feedback-promotion-service.d.ts +8 -11
  135. package/dist/services/feedback/feedback-promotion-service.js +30 -35
  136. package/dist/services/feedback/promotion-artifact-json-evidence.d.ts +18 -0
  137. package/dist/services/feedback/promotion-artifact-missing.d.ts +22 -0
  138. package/dist/services/feedback/promotion-artifact-missing.js +63 -0
  139. package/dist/services/final-review/final-review-contract.d.ts +95 -4
  140. package/dist/services/final-review/final-review-contract.js +64 -0
  141. package/dist/services/final-review/final-review-delivery.d.ts +13 -0
  142. package/dist/services/final-review/final-review-delivery.js +26 -12
  143. package/dist/services/final-review/final-review-evidence-collect.js +8 -53
  144. package/dist/services/final-review/final-review-evidence-records.d.ts +21 -0
  145. package/dist/services/final-review/final-review-evidence-records.js +67 -0
  146. package/dist/services/final-review/final-review-evidence-sources.d.ts +22 -0
  147. package/dist/services/final-review/final-review-evidence-sources.js +28 -4
  148. package/dist/services/final-review/final-review-prompt.js +19 -6
  149. package/dist/services/final-review/final-review-runner.js +5 -0
  150. package/dist/services/final-review/final-review-service.d.ts +2 -2
  151. package/dist/services/final-review/index.d.ts +1 -1
  152. package/dist/services/final-review/pre-post-diff.d.ts +2 -75
  153. package/dist/services/final-review/pre-post-diff.js +60 -59
  154. package/dist/services/hooks/pre-tool-code-gate.d.ts +7 -1
  155. package/dist/services/hooks/pre-tool-code-gate.js +21 -2
  156. package/dist/services/hooks/worktree-authorization-gate.js +6 -31
  157. package/dist/services/hooks/worktree-refusal-messages.d.ts +74 -0
  158. package/dist/services/hooks/worktree-refusal-messages.js +102 -0
  159. package/dist/services/lint/eslint-runner-support.d.ts +1 -1
  160. package/dist/services/lint/eslint-runner-support.js +2 -1
  161. package/dist/services/lint/eslint-runner-types.d.ts +8 -0
  162. package/dist/services/lint/eslint-runner.js +17 -4
  163. package/dist/services/llm/anthropic-runner.js +24 -7
  164. package/dist/services/loop/loop-observability.d.ts +39 -0
  165. package/dist/services/loop/loop-observability.js +55 -0
  166. package/dist/services/loop/monotonic-guard.js +6 -9
  167. package/dist/services/loop/monotonic-runner.js +8 -7
  168. package/dist/services/loop/run-driver.js +18 -22
  169. package/dist/services/memory/project-memory-service/index/kind-dispatch.js +14 -1
  170. package/dist/services/memory/project-memory-service/index/project-memory-plan-exec.js +13 -2
  171. package/dist/services/memory/project-memory-service/index.d.ts +2 -2
  172. package/dist/services/memory/project-memory-service/index.js +1 -1
  173. package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.d.ts +36 -0
  174. package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.js +48 -2
  175. package/dist/services/memory/project-memory-service/parsers/markdown-pure.d.ts +23 -1
  176. package/dist/services/memory/project-memory-service/parsers/markdown-pure.js +37 -0
  177. package/dist/services/memory/project-memory-service/types.d.ts +32 -0
  178. package/dist/services/observability/observability-service.d.ts +7 -0
  179. package/dist/services/observability/observability-service.js +2 -1
  180. package/dist/services/openspec/coverage-evidence-reader.d.ts +9 -9
  181. package/dist/services/openspec/coverage-evidence-reader.js +8 -8
  182. package/dist/services/openspec/openspec-archive-service.d.ts +1 -1
  183. package/dist/services/openspec/openspec-archive-service.js +6 -6
  184. package/dist/services/prd/gate-evidence-derivation.d.ts +4 -3
  185. package/dist/services/prd/gate-evidence-derivation.js +4 -3
  186. package/dist/services/qa/bdd-test-style-verifier.js +22 -8
  187. package/dist/services/race/gate2-evaluator.d.ts +58 -0
  188. package/dist/services/race/gate2-evaluator.js +111 -0
  189. package/dist/services/race/gate2-policy.d.ts +17 -0
  190. package/dist/services/race/gate2-policy.js +31 -0
  191. package/dist/services/race/lane-phase.d.ts +19 -0
  192. package/dist/services/race/lane-phase.js +113 -0
  193. package/dist/services/race/pilot-gate-store.d.ts +67 -0
  194. package/dist/services/race/pilot-gate-store.js +227 -0
  195. package/dist/services/scan/file-size-baseline.d.ts +33 -0
  196. package/dist/services/scan/file-size-baseline.js +173 -0
  197. package/dist/services/scan/file-size-scan.d.ts +35 -3
  198. package/dist/services/scan/file-size-scan.js +63 -42
  199. package/dist/services/scan/type-corroboration.d.ts +32 -0
  200. package/dist/services/scan/type-corroboration.js +51 -0
  201. package/dist/services/scan/type-sanity-service.d.ts +14 -0
  202. package/dist/services/scan/type-sanity-service.js +23 -22
  203. package/dist/services/security/safe-settings-path.d.ts +5 -0
  204. package/dist/services/security/safe-settings-path.js +64 -8
  205. package/dist/services/skill/resume-detector.js +11 -11
  206. package/dist/services/skills/hooks-codegate-superpowers.d.ts +5 -6
  207. package/dist/services/skills/hooks-codegate-superpowers.js +7 -8
  208. package/dist/services/skills/hooks-settings-service.d.ts +1 -1
  209. package/dist/services/skills/hooks-settings-service.js +1 -1
  210. package/dist/services/skills/presence-lease-order.d.ts +13 -0
  211. package/dist/services/skills/presence-lease-order.js +24 -0
  212. package/dist/services/skills/skill-conformance-service.js +1 -0
  213. package/dist/services/skills/skill-statusline-service.js +4 -7
  214. package/dist/services/slice/slice-check-service.js +8 -8
  215. package/dist/services/workflow/pipeline-verify-gate-support.d.ts +24 -8
  216. package/dist/services/workflow/pipeline-verify-gate-support.js +34 -39
  217. package/dist/services/workflow/pipeline-verify-qa-phase.d.ts +102 -0
  218. package/dist/services/workflow/pipeline-verify-qa-phase.js +176 -0
  219. package/dist/services/workflow/pipeline-verify-service.js +27 -28
  220. package/dist/services/workflow/request-type-resolution.d.ts +99 -0
  221. package/dist/services/workflow/request-type-resolution.js +130 -0
  222. package/dist/services/workflow/workflow-skip-service.d.ts +1 -20
  223. package/dist/services/workflow/workflow-skip-service.js +22 -25
  224. package/dist/services/workflow/workflow-state-store.d.ts +9 -0
  225. package/dist/services/workflow/workflow-state-store.js +26 -1
  226. package/dist/services/workspace/claude-settings-retirements.d.ts +54 -0
  227. package/dist/services/workspace/claude-settings-retirements.js +112 -0
  228. package/dist/services/workspace/claude-settings-template-merge.d.ts +35 -15
  229. package/dist/services/workspace/claude-settings-template-merge.js +33 -53
  230. package/dist/services/workspace/claude-settings-template.d.ts +62 -12
  231. package/dist/services/workspace/claude-settings-template.js +58 -58
  232. package/dist/services/workspace/migrate-1-4-1-service.js +3 -0
  233. package/dist/services/workspace/reconcile-service.js +0 -1
  234. package/dist/shared/incrementing-number.d.ts +33 -2
  235. package/dist/shared/incrementing-number.js +72 -3
  236. package/package.json +5 -7
  237. package/skills/bee/peaks-perf-audit/SKILL.md +1 -1
  238. package/skills/bee/peaks-prd/SKILL.md +4 -3
  239. package/skills/bee/peaks-qa/SKILL.md +1 -1
  240. package/skills/bee/peaks-qa/references/qa-sub-agent-dispatch.md +2 -2
  241. package/skills/bee/peaks-qa/references/qa-transition-gates.md +1 -1
  242. package/skills/bee/peaks-rd/SKILL.md +2 -2
  243. package/skills/bee/peaks-rd/references/rd-fanout-contracts.md +1 -1
  244. package/skills/bee/peaks-rd/references/rd-sub-agent-dispatch.md +8 -4
  245. package/skills/bee/peaks-rd/references/rd-transition-gates.md +3 -3
  246. package/skills/bee/peaks-rd/references/v2-12-fanout-collapse.md +2 -2
  247. package/skills/bee/peaks-rd/references/writing-handoff-frontmatter.md +1 -1
  248. package/skills/bee/peaks-reviewer/SKILL.md +1 -1
  249. package/skills/bee/peaks-sc/SKILL.md +1 -1
  250. package/skills/bee/peaks-security-audit/SKILL.md +10 -2
  251. package/skills/bee/peaks-txt/SKILL.md +4 -3
  252. package/skills/bee/peaks-ui/SKILL.md +3 -3
  253. package/skills/peaks-audit/SKILL.md +29 -1
  254. package/skills/peaks-code/SKILL.md +37 -17
  255. package/skills/peaks-code/references/fast-lane-norm.md +42 -0
  256. package/skills/peaks-code/references/fast-mode.md +3 -2
  257. package/skills/peaks-code/references/local-artifact-workspace.md +3 -3
  258. package/skills/peaks-code/references/micro-cycle.md +3 -3
  259. package/skills/peaks-code/references/resume-detection.md +1 -1
  260. package/skills/peaks-code/references/runbook.md +12 -6
  261. package/skills/peaks-code/references/step-11-memory-sediment.md +4 -0
  262. package/skills/peaks-code/references/sub-agent-dispatch.md +1 -1
  263. package/skills/peaks-code/references/swarm-dispatch-contract.md +40 -16
  264. package/skills/peaks-code/references/workflow-gates-and-types.md +6 -6
  265. package/skills/peaks-code/references/worktree-governance.md +4 -4
  266. package/skills/peaks-content/SKILL.md +1 -1
  267. package/skills/peaks-doctor/SKILL.md +1 -1
  268. package/skills/peaks-final-review/SKILL.md +31 -11
  269. package/skills/peaks-ide/SKILL.md +1 -1
  270. package/skills/peaks-issue-fix-orchestrator/SKILL.md +1 -1
  271. package/skills/peaks-race-code/SKILL.md +185 -0
  272. package/skills/peaks-resume/SKILL.md +1 -1
  273. package/skills/peaks-slice-decompose/SKILL.md +1 -1
  274. package/skills/peaks-solo/SKILL.md +1 -1
  275. package/skills/peaks-sop/SKILL.md +1 -1
  276. package/skills/peaks-status/SKILL.md +1 -1
  277. package/skills/peaks-test/SKILL.md +7 -4
  278. package/dist/cli/commands/vm-command-shared.d.ts +0 -23
  279. package/dist/cli/commands/vm-command-shared.js +0 -23
  280. package/dist/cli/commands/vm-commands.d.ts +0 -3
  281. package/dist/cli/commands/vm-commands.js +0 -45
  282. package/dist/cli/commands/vm-hypervisor-probe.d.ts +0 -27
  283. package/dist/cli/commands/vm-hypervisor-probe.js +0 -78
  284. package/dist/cli/commands/vm-hypervisor-runtime.d.ts +0 -15
  285. package/dist/cli/commands/vm-hypervisor-runtime.js +0 -64
  286. package/dist/cli/commands/vm-release-command.d.ts +0 -5
  287. package/dist/cli/commands/vm-release-command.js +0 -101
  288. package/dist/cli/commands/vm-spawn-command.d.ts +0 -5
  289. package/dist/cli/commands/vm-spawn-command.js +0 -177
  290. package/dist/cli/commands/vm-status-command.js +0 -50
  291. package/dist/services/audit/enforcers/lint-peaks-skill-runtime.d.ts +0 -23
  292. package/dist/services/audit/enforcers/lint-peaks-skill-runtime.js +0 -64
  293. package/dist/services/vm/vm-lease.d.ts +0 -40
  294. package/dist/services/vm/vm-lease.js +0 -160
@@ -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,33 @@
1
+ /**
2
+ * The gates `transitionRequestArtifact` applies on `rd → implemented`,
3
+ * `rd → qa-handoff` and `rd → handed-off`: the per-file size ratchet and the
4
+ * declared-type corroboration. Extracted so `request-artifact-service.ts`
5
+ * (already over its cap) grows by one call instead of two blocks, and so the
6
+ * checks run for EVERY caller — not only the CLI flag path.
7
+ *
8
+ * ONE ENUMERATION PER TRANSITION. At `implemented` the change set is read once
9
+ * and shared: the type rule judges every path (deletions included, rename
10
+ * sources included), while the size scan measures the A/M/R/untracked subset.
11
+ * `qa-handoff` / `handed-off` run only the type rule (two git spawns); the size
12
+ * ratchet keeps the single state it has always judged.
13
+ */
14
+ import type { RequestType } from './artifact-prerequisites.js';
15
+ import { type TypeCorroboration } from '../scan/type-corroboration.js';
16
+ export type RdGatePhase = 'implemented' | 'qa-handoff' | 'handed-off';
17
+ export declare class TypeCorroborationViolationError extends Error {
18
+ readonly code = "TYPE_CORROBORATION_VIOLATION";
19
+ readonly declaredType: RequestType;
20
+ readonly kind: 'source-touched' | 'diff-unavailable';
21
+ constructor(declaredType: RequestType, verdict: Extract<TypeCorroboration, {
22
+ ok: false;
23
+ }>);
24
+ }
25
+ /** Written into the artifact when `--allow-incomplete` skips a gate that COULD
26
+ * have judged this type: a silent bypass is indistinguishable from a pass. */
27
+ export declare function rdGatesBypassNote(phase: RdGatePhase): string;
28
+ export declare function runRdTransitionGates(options: {
29
+ projectRoot: string;
30
+ declaredType: RequestType;
31
+ allowIncomplete: boolean;
32
+ phase: RdGatePhase;
33
+ }): string | null;
@@ -0,0 +1,71 @@
1
+ import { FileSizeViolationError } from './request-artifact-state-helpers.js';
2
+ import { readGitChangeSet } from '../scan/file-size-baseline.js';
3
+ import { scanFileSize } from '../scan/file-size-scan.js';
4
+ import { corroborateDeclaredType, diffUnavailableVerdict, isToolingOnlyDeclaredType } from '../scan/type-corroboration.js';
5
+ export class TypeCorroborationViolationError extends Error {
6
+ code = 'TYPE_CORROBORATION_VIOLATION';
7
+ declaredType;
8
+ kind;
9
+ constructor(declaredType, verdict) {
10
+ super(verdict.message);
11
+ this.name = 'TypeCorroborationViolationError';
12
+ this.declaredType = declaredType;
13
+ this.kind = verdict.kind;
14
+ }
15
+ }
16
+ /** Written into the artifact when `--allow-incomplete` skips a gate that COULD
17
+ * have judged this type: a silent bypass is indistinguishable from a pass. */
18
+ export function rdGatesBypassNote(phase) {
19
+ const gates = phase === 'implemented'
20
+ ? 'file-size ratchet, declared-type corroboration'
21
+ : 'declared-type corroboration';
22
+ return (`bypassed the rd ${phase} gates (${gates}) via --allow-incomplete; ` +
23
+ 'none of them was evaluated');
24
+ }
25
+ /** The shared read, or the fail-closed verdict built from the same message. */
26
+ function readOrRefuse(projectRoot, declaredType) {
27
+ try {
28
+ return readGitChangeSet(projectRoot, 'HEAD');
29
+ }
30
+ catch {
31
+ throw new TypeCorroborationViolationError(declaredType, diffUnavailableVerdict(declaredType));
32
+ }
33
+ }
34
+ export function runRdTransitionGates(options) {
35
+ const judged = isToolingOnlyDeclaredType(options.declaredType);
36
+ if (options.allowIncomplete)
37
+ return judged ? rdGatesBypassNote(options.phase) : null;
38
+ if (!judged) {
39
+ // The size ratchet still runs at implemented; the type rule is a no-op here.
40
+ if (options.phase === 'implemented') {
41
+ const size = scanFileSize({ projectRoot: options.projectRoot });
42
+ if (!size.ok)
43
+ throw new FileSizeViolationError(size.violations);
44
+ }
45
+ return null;
46
+ }
47
+ if (options.phase !== 'implemented') {
48
+ const verdict = corroborateDeclaredType({
49
+ projectRoot: options.projectRoot,
50
+ declaredType: options.declaredType
51
+ });
52
+ if (!verdict.ok)
53
+ throw new TypeCorroborationViolationError(options.declaredType, verdict);
54
+ return null;
55
+ }
56
+ const changeSet = readOrRefuse(options.projectRoot, options.declaredType);
57
+ const verdict = corroborateDeclaredType({
58
+ projectRoot: options.projectRoot,
59
+ declaredType: options.declaredType,
60
+ changedPaths: changeSet.changedPaths
61
+ });
62
+ if (!verdict.ok)
63
+ throw new TypeCorroborationViolationError(options.declaredType, verdict);
64
+ const size = scanFileSize({
65
+ projectRoot: options.projectRoot,
66
+ changedFiles: changeSet.changedFiles
67
+ });
68
+ if (!size.ok)
69
+ throw new FileSizeViolationError(size.violations);
70
+ return null;
71
+ }
@@ -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';