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.
- package/.claude-plugin/marketplace.json +7 -2
- package/CHANGELOG.md +148 -0
- package/README-en.md +47 -183
- package/README.md +24 -188
- package/dist/cli/cli-helpers.d.ts +20 -0
- package/dist/cli/cli-helpers.js +34 -0
- package/dist/cli/commands/_register.js +2 -0
- package/dist/cli/commands/best-practice-scan-command.d.ts +11 -6
- package/dist/cli/commands/best-practice-scan-command.js +35 -20
- package/dist/cli/commands/best-practice-scan-helpers.d.ts +47 -0
- package/dist/cli/commands/best-practice-scan-helpers.js +88 -5
- package/dist/cli/commands/best-practice-scan-lookup-results.d.ts +13 -0
- package/dist/cli/commands/best-practice-scan-lookup-results.js +237 -0
- package/dist/cli/commands/code-commands.d.ts +6 -4
- package/dist/cli/commands/code-commands.js +6 -4
- package/dist/cli/commands/code-gate-command.d.ts +5 -5
- package/dist/cli/commands/code-gate-command.js +49 -9
- package/dist/cli/commands/code-mode-gate-plan-command.d.ts +1 -1
- package/dist/cli/commands/code-mode-gate-plan-command.js +2 -2
- package/dist/cli/commands/core/memory-extract-command.js +10 -5
- package/dist/cli/commands/dispatch-cli-invocation-check.d.ts +108 -0
- package/dist/cli/commands/dispatch-cli-invocation-check.js +87 -0
- package/dist/cli/commands/dispatch-cli-invocation-scan.d.ts +66 -0
- package/dist/cli/commands/dispatch-cli-invocation-scan.js +162 -0
- package/dist/cli/commands/dispatch-command-spec.js +1 -1
- package/dist/cli/commands/dispatch-commands.js +12 -5
- package/dist/cli/commands/dispatch-isolation-lease.d.ts +1 -1
- package/dist/cli/commands/dispatch-isolation-lease.js +6 -53
- package/dist/cli/commands/dispatch-preflight.js +46 -0
- package/dist/cli/commands/dispatch-prompt-blocks.d.ts +1 -1
- package/dist/cli/commands/dispatch-prompt-composition.d.ts +7 -1
- package/dist/cli/commands/dispatch-prompt-composition.js +29 -7
- package/dist/cli/commands/dispatch-record-write.d.ts +1 -1
- package/dist/cli/commands/dispatch-tool-call.d.ts +1 -1
- package/dist/cli/commands/doc-commands.js +1 -1
- package/dist/cli/commands/feedback-commands-helpers.js +1 -1
- package/dist/cli/commands/final-review-prepare-command.js +22 -1
- package/dist/cli/commands/gate-commands-enforce.js +3 -3
- package/dist/cli/commands/hook-handle.js +41 -20
- package/dist/cli/commands/lint-commands.js +3 -1
- package/dist/cli/commands/loop-eval-capture-index.js +2 -4
- package/dist/cli/commands/openspec-command-shared.js +2 -2
- package/dist/cli/commands/perf-audit-commands.js +15 -5
- package/dist/cli/commands/project-commands.js +9 -6
- package/dist/cli/commands/race-commands.d.ts +15 -0
- package/dist/cli/commands/race-commands.js +65 -0
- package/dist/cli/commands/race-pilot-gate-record-command.d.ts +3 -0
- package/dist/cli/commands/race-pilot-gate-record-command.js +81 -0
- package/dist/cli/commands/request-command-options.d.ts +8 -0
- package/dist/cli/commands/request-commands.js +2 -0
- package/dist/cli/commands/request-init-command.js +67 -12
- package/dist/cli/commands/{vm-status-command.d.ts → request-retag-command.d.ts} +1 -1
- package/dist/cli/commands/request-retag-command.js +50 -0
- package/dist/cli/commands/request-show-command.d.ts +8 -0
- package/dist/cli/commands/request-show-command.js +14 -1
- package/dist/cli/commands/request-transition-command.js +12 -4
- package/dist/cli/commands/request-transition-failures.d.ts +14 -0
- package/dist/cli/commands/request-transition-failures.js +76 -7
- package/dist/cli/commands/request-transition-preflight.js +1 -1
- package/dist/cli/commands/scan-scope-commands.js +2 -2
- package/dist/cli/commands/security-audit-commands.js +26 -6
- package/dist/cli/commands/slice-decompose-artifacts.js +2 -1
- package/dist/cli/commands/verdict-aggregate-command.js +2 -1
- package/dist/cli/commands/workflow-gate-commands.js +4 -4
- package/dist/cli/commands/worktree-lease-gc-command.js +1 -1
- package/dist/cli/program.js +0 -2
- package/dist/services/artifacts/artifact-contract-block.d.ts +53 -0
- package/dist/services/artifacts/artifact-contract-block.js +231 -0
- package/dist/services/artifacts/artifact-prerequisites.d.ts +27 -19
- package/dist/services/artifacts/artifact-prerequisites.js +65 -135
- package/dist/services/artifacts/artifact-templates.d.ts +1 -1
- package/dist/services/artifacts/artifact-templates.js +17 -10
- package/dist/services/artifacts/prerequisite-checks.d.ts +87 -0
- package/dist/services/artifacts/prerequisite-checks.js +198 -0
- package/dist/services/artifacts/prerequisite-transition-event.d.ts +20 -0
- package/dist/services/artifacts/prerequisite-transition-event.js +27 -0
- package/dist/services/artifacts/rd-transition-gates.d.ts +33 -0
- package/dist/services/artifacts/rd-transition-gates.js +71 -0
- package/dist/services/artifacts/request-artifact-metadata.d.ts +31 -0
- package/dist/services/artifacts/request-artifact-metadata.js +44 -0
- package/dist/services/artifacts/request-artifact-service.d.ts +5 -0
- package/dist/services/artifacts/request-artifact-service.js +43 -69
- package/dist/services/artifacts/request-artifact-state-helpers.d.ts +21 -1
- package/dist/services/artifacts/request-artifact-state-helpers.js +34 -8
- package/dist/services/artifacts/request-retag-service.d.ts +68 -0
- package/dist/services/artifacts/request-retag-service.js +125 -0
- package/dist/services/artifacts/request-state-order.d.ts +38 -0
- package/dist/services/artifacts/request-state-order.js +99 -0
- package/dist/services/artifacts/request-type-demand.d.ts +44 -0
- package/dist/services/artifacts/request-type-demand.js +71 -0
- package/dist/services/audit/audit-goal-service.d.ts +7 -0
- package/dist/services/audit/enforcers/active-skill-resolver.d.ts +18 -0
- package/dist/services/audit/enforcers/active-skill-resolver.js +48 -1
- package/dist/services/audit/enforcers/code-ban.d.ts +11 -2
- package/dist/services/audit/enforcers/code-ban.js +21 -1
- package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.d.ts +17 -0
- package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.js +24 -7
- package/dist/services/audit-independent/handoff-missing-refusal.d.ts +26 -0
- package/dist/services/audit-independent/handoff-missing-refusal.js +109 -0
- package/dist/services/audit-independent/handoff-readers.d.ts +37 -0
- package/dist/services/audit-independent/handoff-readers.js +81 -0
- package/dist/services/audit-independent/index.d.ts +6 -1
- package/dist/services/audit-independent/index.js +6 -1
- package/dist/services/audit-independent/judged-declaration-build.d.ts +48 -0
- package/dist/services/audit-independent/judged-declaration-build.js +73 -0
- package/dist/services/audit-independent/judged-declaration-check.d.ts +80 -0
- package/dist/services/audit-independent/judged-declaration-check.js +216 -0
- package/dist/services/audit-independent/judged-declaration.d.ts +94 -0
- package/dist/services/audit-independent/judged-declaration.js +218 -0
- package/dist/services/audit-independent/perf-audit-service.js +12 -14
- package/dist/services/audit-independent/security-audit-artifact.d.ts +28 -0
- package/dist/services/audit-independent/security-audit-artifact.js +90 -0
- package/dist/services/audit-independent/security-audit-service.d.ts +6 -53
- package/dist/services/audit-independent/security-audit-service.js +34 -178
- package/dist/services/capability-guard-runner/contracts/J05.js +60 -14
- package/dist/services/codegraph/codegraph-index-integrity.js +2 -0
- package/dist/services/context/build-dispatch-system-prompt.d.ts +8 -12
- package/dist/services/context/build-dispatch-system-prompt.js +18 -18
- package/dist/services/context/collector.js +5 -1
- package/dist/services/context/post-compact-reinjection.js +1 -1
- package/dist/services/dispatch/active-dispatch-index.d.ts +36 -0
- package/dist/services/dispatch/active-dispatch-index.js +118 -0
- package/dist/services/dispatch/batch-counter.js +1 -2
- package/dist/services/dispatch/dispatch-record-writer.d.ts +29 -16
- package/dist/services/dispatch/dispatch-record-writer.js +58 -100
- package/dist/services/dispatch/dispatch-sub-agent.js +1 -1
- package/dist/services/dispatch/karpathy-block.d.ts +55 -0
- package/dist/services/dispatch/karpathy-block.js +101 -0
- package/dist/services/dispatch/ledger-reaper.d.ts +80 -0
- package/dist/services/dispatch/ledger-reaper.js +131 -0
- package/dist/services/dispatch/test-tool-detection.d.ts +17 -1
- package/dist/services/dispatch/test-tool-detection.js +12 -1
- package/dist/services/evidence/evidence-generator.js +23 -12
- package/dist/services/feedback/feedback-promotion-service.d.ts +8 -11
- package/dist/services/feedback/feedback-promotion-service.js +30 -35
- package/dist/services/feedback/promotion-artifact-json-evidence.d.ts +18 -0
- package/dist/services/feedback/promotion-artifact-missing.d.ts +22 -0
- package/dist/services/feedback/promotion-artifact-missing.js +63 -0
- package/dist/services/final-review/final-review-contract.d.ts +95 -4
- package/dist/services/final-review/final-review-contract.js +64 -0
- package/dist/services/final-review/final-review-delivery.d.ts +13 -0
- package/dist/services/final-review/final-review-delivery.js +26 -12
- package/dist/services/final-review/final-review-evidence-collect.js +8 -53
- package/dist/services/final-review/final-review-evidence-records.d.ts +21 -0
- package/dist/services/final-review/final-review-evidence-records.js +67 -0
- package/dist/services/final-review/final-review-evidence-sources.d.ts +22 -0
- package/dist/services/final-review/final-review-evidence-sources.js +28 -4
- package/dist/services/final-review/final-review-prompt.js +19 -6
- package/dist/services/final-review/final-review-runner.js +5 -0
- package/dist/services/final-review/final-review-service.d.ts +2 -2
- package/dist/services/final-review/index.d.ts +1 -1
- package/dist/services/final-review/pre-post-diff.d.ts +2 -75
- package/dist/services/final-review/pre-post-diff.js +60 -59
- package/dist/services/hooks/pre-tool-code-gate.d.ts +7 -1
- package/dist/services/hooks/pre-tool-code-gate.js +21 -2
- package/dist/services/hooks/worktree-authorization-gate.js +6 -31
- package/dist/services/hooks/worktree-refusal-messages.d.ts +74 -0
- package/dist/services/hooks/worktree-refusal-messages.js +102 -0
- package/dist/services/lint/eslint-runner-support.d.ts +1 -1
- package/dist/services/lint/eslint-runner-support.js +2 -1
- package/dist/services/lint/eslint-runner-types.d.ts +8 -0
- package/dist/services/lint/eslint-runner.js +17 -4
- package/dist/services/llm/anthropic-runner.js +24 -7
- package/dist/services/loop/loop-observability.d.ts +39 -0
- package/dist/services/loop/loop-observability.js +55 -0
- package/dist/services/loop/monotonic-guard.js +6 -9
- package/dist/services/loop/monotonic-runner.js +8 -7
- package/dist/services/loop/run-driver.js +18 -22
- package/dist/services/memory/project-memory-service/index/kind-dispatch.js +14 -1
- package/dist/services/memory/project-memory-service/index/project-memory-plan-exec.js +13 -2
- package/dist/services/memory/project-memory-service/index.d.ts +2 -2
- package/dist/services/memory/project-memory-service/index.js +1 -1
- package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.d.ts +36 -0
- package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.js +48 -2
- package/dist/services/memory/project-memory-service/parsers/markdown-pure.d.ts +23 -1
- package/dist/services/memory/project-memory-service/parsers/markdown-pure.js +37 -0
- package/dist/services/memory/project-memory-service/types.d.ts +32 -0
- package/dist/services/observability/observability-service.d.ts +7 -0
- package/dist/services/observability/observability-service.js +2 -1
- package/dist/services/openspec/coverage-evidence-reader.d.ts +9 -9
- package/dist/services/openspec/coverage-evidence-reader.js +8 -8
- package/dist/services/openspec/openspec-archive-service.d.ts +1 -1
- package/dist/services/openspec/openspec-archive-service.js +6 -6
- package/dist/services/prd/gate-evidence-derivation.d.ts +4 -3
- package/dist/services/prd/gate-evidence-derivation.js +4 -3
- package/dist/services/qa/bdd-test-style-verifier.js +22 -8
- package/dist/services/race/gate2-evaluator.d.ts +58 -0
- package/dist/services/race/gate2-evaluator.js +111 -0
- package/dist/services/race/gate2-policy.d.ts +17 -0
- package/dist/services/race/gate2-policy.js +31 -0
- package/dist/services/race/lane-phase.d.ts +19 -0
- package/dist/services/race/lane-phase.js +113 -0
- package/dist/services/race/pilot-gate-store.d.ts +67 -0
- package/dist/services/race/pilot-gate-store.js +227 -0
- package/dist/services/scan/file-size-baseline.d.ts +33 -0
- package/dist/services/scan/file-size-baseline.js +173 -0
- package/dist/services/scan/file-size-scan.d.ts +35 -3
- package/dist/services/scan/file-size-scan.js +63 -42
- package/dist/services/scan/type-corroboration.d.ts +32 -0
- package/dist/services/scan/type-corroboration.js +51 -0
- package/dist/services/scan/type-sanity-service.d.ts +14 -0
- package/dist/services/scan/type-sanity-service.js +23 -22
- package/dist/services/security/safe-settings-path.d.ts +5 -0
- package/dist/services/security/safe-settings-path.js +64 -8
- package/dist/services/skill/resume-detector.js +11 -11
- package/dist/services/skills/hooks-codegate-superpowers.d.ts +5 -6
- package/dist/services/skills/hooks-codegate-superpowers.js +7 -8
- package/dist/services/skills/hooks-settings-service.d.ts +1 -1
- package/dist/services/skills/hooks-settings-service.js +1 -1
- package/dist/services/skills/presence-lease-order.d.ts +13 -0
- package/dist/services/skills/presence-lease-order.js +24 -0
- package/dist/services/skills/skill-conformance-service.js +1 -0
- package/dist/services/skills/skill-statusline-service.js +4 -7
- package/dist/services/slice/slice-check-service.js +8 -8
- package/dist/services/workflow/pipeline-verify-gate-support.d.ts +24 -8
- package/dist/services/workflow/pipeline-verify-gate-support.js +34 -39
- package/dist/services/workflow/pipeline-verify-qa-phase.d.ts +102 -0
- package/dist/services/workflow/pipeline-verify-qa-phase.js +176 -0
- package/dist/services/workflow/pipeline-verify-service.js +27 -28
- package/dist/services/workflow/request-type-resolution.d.ts +99 -0
- package/dist/services/workflow/request-type-resolution.js +130 -0
- package/dist/services/workflow/workflow-skip-service.d.ts +1 -20
- package/dist/services/workflow/workflow-skip-service.js +22 -25
- package/dist/services/workflow/workflow-state-store.d.ts +9 -0
- package/dist/services/workflow/workflow-state-store.js +26 -1
- package/dist/services/workspace/claude-settings-retirements.d.ts +54 -0
- package/dist/services/workspace/claude-settings-retirements.js +112 -0
- package/dist/services/workspace/claude-settings-template-merge.d.ts +35 -15
- package/dist/services/workspace/claude-settings-template-merge.js +33 -53
- package/dist/services/workspace/claude-settings-template.d.ts +62 -12
- package/dist/services/workspace/claude-settings-template.js +58 -58
- package/dist/services/workspace/migrate-1-4-1-service.js +3 -0
- package/dist/services/workspace/reconcile-service.js +0 -1
- package/dist/shared/incrementing-number.d.ts +33 -2
- package/dist/shared/incrementing-number.js +72 -3
- package/package.json +5 -7
- package/skills/bee/peaks-perf-audit/SKILL.md +1 -1
- package/skills/bee/peaks-prd/SKILL.md +4 -3
- package/skills/bee/peaks-qa/SKILL.md +1 -1
- package/skills/bee/peaks-qa/references/qa-sub-agent-dispatch.md +2 -2
- package/skills/bee/peaks-qa/references/qa-transition-gates.md +1 -1
- package/skills/bee/peaks-rd/SKILL.md +2 -2
- package/skills/bee/peaks-rd/references/rd-fanout-contracts.md +1 -1
- package/skills/bee/peaks-rd/references/rd-sub-agent-dispatch.md +8 -4
- package/skills/bee/peaks-rd/references/rd-transition-gates.md +3 -3
- package/skills/bee/peaks-rd/references/v2-12-fanout-collapse.md +2 -2
- package/skills/bee/peaks-rd/references/writing-handoff-frontmatter.md +1 -1
- package/skills/bee/peaks-reviewer/SKILL.md +1 -1
- package/skills/bee/peaks-sc/SKILL.md +1 -1
- package/skills/bee/peaks-security-audit/SKILL.md +10 -2
- package/skills/bee/peaks-txt/SKILL.md +4 -3
- package/skills/bee/peaks-ui/SKILL.md +3 -3
- package/skills/peaks-audit/SKILL.md +29 -1
- package/skills/peaks-code/SKILL.md +37 -17
- package/skills/peaks-code/references/fast-lane-norm.md +42 -0
- package/skills/peaks-code/references/fast-mode.md +3 -2
- package/skills/peaks-code/references/local-artifact-workspace.md +3 -3
- package/skills/peaks-code/references/micro-cycle.md +3 -3
- package/skills/peaks-code/references/resume-detection.md +1 -1
- package/skills/peaks-code/references/runbook.md +12 -6
- package/skills/peaks-code/references/step-11-memory-sediment.md +4 -0
- package/skills/peaks-code/references/sub-agent-dispatch.md +1 -1
- package/skills/peaks-code/references/swarm-dispatch-contract.md +40 -16
- package/skills/peaks-code/references/workflow-gates-and-types.md +6 -6
- package/skills/peaks-code/references/worktree-governance.md +4 -4
- package/skills/peaks-content/SKILL.md +1 -1
- package/skills/peaks-doctor/SKILL.md +1 -1
- package/skills/peaks-final-review/SKILL.md +31 -11
- package/skills/peaks-ide/SKILL.md +1 -1
- package/skills/peaks-issue-fix-orchestrator/SKILL.md +1 -1
- package/skills/peaks-race-code/SKILL.md +185 -0
- package/skills/peaks-resume/SKILL.md +1 -1
- package/skills/peaks-slice-decompose/SKILL.md +1 -1
- package/skills/peaks-solo/SKILL.md +1 -1
- package/skills/peaks-sop/SKILL.md +1 -1
- package/skills/peaks-status/SKILL.md +1 -1
- package/skills/peaks-test/SKILL.md +7 -4
- package/dist/cli/commands/vm-command-shared.d.ts +0 -23
- package/dist/cli/commands/vm-command-shared.js +0 -23
- package/dist/cli/commands/vm-commands.d.ts +0 -3
- package/dist/cli/commands/vm-commands.js +0 -45
- package/dist/cli/commands/vm-hypervisor-probe.d.ts +0 -27
- package/dist/cli/commands/vm-hypervisor-probe.js +0 -78
- package/dist/cli/commands/vm-hypervisor-runtime.d.ts +0 -15
- package/dist/cli/commands/vm-hypervisor-runtime.js +0 -64
- package/dist/cli/commands/vm-release-command.d.ts +0 -5
- package/dist/cli/commands/vm-release-command.js +0 -101
- package/dist/cli/commands/vm-spawn-command.d.ts +0 -5
- package/dist/cli/commands/vm-spawn-command.js +0 -177
- package/dist/cli/commands/vm-status-command.js +0 -50
- package/dist/services/audit/enforcers/lint-peaks-skill-runtime.d.ts +0 -23
- package/dist/services/audit/enforcers/lint-peaks-skill-runtime.js +0 -64
- package/dist/services/vm/vm-lease.d.ts +0 -40
- 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';
|