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.
- package/.claude-plugin/marketplace.json +7 -2
- package/CHANGELOG.md +168 -0
- package/README-en.md +1 -1
- package/README.md +1 -1
- 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/asset-command-shared.d.ts +12 -0
- package/dist/cli/commands/asset-command-shared.js +45 -0
- package/dist/cli/commands/asset-commands.d.ts +6 -1
- package/dist/cli/commands/asset-commands.js +11 -372
- package/dist/cli/commands/asset-crystallize-command.d.ts +3 -0
- package/dist/cli/commands/asset-crystallize-command.js +60 -0
- package/dist/cli/commands/asset-crystallize-payload.d.ts +47 -0
- package/dist/cli/commands/asset-crystallize-payload.js +85 -0
- package/dist/cli/commands/asset-crystallize-runner.d.ts +3 -0
- package/dist/cli/commands/asset-crystallize-runner.js +133 -0
- package/dist/cli/commands/asset-dispose-command.d.ts +3 -0
- package/dist/cli/commands/asset-dispose-command.js +99 -0
- package/dist/cli/commands/asset-status-command.d.ts +3 -0
- package/dist/cli/commands/asset-status-command.js +100 -0
- package/dist/cli/commands/baseline-audit-command.d.ts +3 -0
- package/dist/cli/commands/baseline-audit-command.js +64 -0
- package/dist/cli/commands/baseline-command-shared.d.ts +23 -0
- package/dist/cli/commands/baseline-command-shared.js +39 -0
- package/dist/cli/commands/baseline-commands.js +33 -313
- package/dist/cli/commands/baseline-freeze-commands.d.ts +4 -0
- package/dist/cli/commands/baseline-freeze-commands.js +81 -0
- package/dist/cli/commands/baseline-guard-command.d.ts +3 -0
- package/dist/cli/commands/baseline-guard-command.js +52 -0
- package/dist/cli/commands/baseline-read-commands.d.ts +5 -0
- package/dist/cli/commands/baseline-read-commands.js +72 -0
- package/dist/cli/commands/baseline-rollback-commands.d.ts +4 -0
- package/dist/cli/commands/baseline-rollback-commands.js +88 -0
- package/dist/cli/commands/classify-downgrade-command.d.ts +9 -0
- package/dist/cli/commands/classify-downgrade-command.js +21 -0
- package/dist/cli/commands/classify-run-command.d.ts +9 -0
- package/dist/cli/commands/classify-run-command.js +73 -0
- package/dist/cli/commands/classify-signals.d.ts +5 -0
- package/dist/cli/commands/classify-signals.js +104 -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-emit-handoff-command.js +40 -3
- 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-gate-step-08-command.js +25 -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/codegraph-command-options.d.ts +22 -0
- package/dist/cli/commands/codegraph-command-options.js +22 -0
- package/dist/cli/commands/codegraph-commands.d.ts +2 -2
- package/dist/cli/commands/codegraph-commands.js +14 -397
- package/dist/cli/commands/codegraph-config-restore-command.d.ts +3 -0
- package/dist/cli/commands/codegraph-config-restore-command.js +200 -0
- package/dist/cli/commands/codegraph-proxy-commands.d.ts +10 -0
- package/dist/cli/commands/codegraph-proxy-commands.js +159 -0
- package/dist/cli/commands/codegraph-repair-commands.d.ts +3 -0
- package/dist/cli/commands/codegraph-repair-commands.js +94 -0
- package/dist/cli/commands/codegraph-status-command.d.ts +1 -1
- package/dist/cli/commands/codegraph-status-command.js +27 -214
- package/dist/cli/commands/codegraph-status-integrity.d.ts +44 -0
- package/dist/cli/commands/codegraph-status-integrity.js +121 -0
- package/dist/cli/commands/codegraph-status-json.d.ts +5 -0
- package/dist/cli/commands/codegraph-status-json.js +127 -0
- package/dist/cli/commands/container-command-shared.d.ts +60 -0
- package/dist/cli/commands/container-command-shared.js +52 -0
- package/dist/cli/commands/container-commands.d.ts +1 -1
- package/dist/cli/commands/container-commands.js +4 -216
- package/dist/cli/commands/container-release-command.d.ts +3 -0
- package/dist/cli/commands/container-release-command.js +105 -0
- package/dist/cli/commands/container-spawn-command.d.ts +3 -0
- package/dist/cli/commands/container-spawn-command.js +148 -0
- package/dist/cli/commands/context-check-command.d.ts +3 -0
- package/dist/cli/commands/context-check-command.js +81 -0
- package/dist/cli/commands/context-commands.d.ts +2 -7
- package/dist/cli/commands/context-commands.js +6 -276
- package/dist/cli/commands/context-layer-command.d.ts +3 -0
- package/dist/cli/commands/context-layer-command.js +34 -0
- package/dist/cli/commands/context-layer-fetchers.d.ts +15 -0
- package/dist/cli/commands/context-layer-fetchers.js +162 -0
- package/dist/cli/commands/context-status-command.d.ts +17 -0
- package/dist/cli/commands/context-status-command.js +41 -0
- package/dist/cli/commands/contract-write-command.d.ts +3 -0
- package/dist/cli/commands/contract-write-command.js +144 -0
- package/dist/cli/commands/core/doctor-bindings.d.ts +17 -0
- package/dist/cli/commands/core/doctor-bindings.js +30 -0
- package/dist/cli/commands/core/doctor-command.d.ts +4 -18
- package/dist/cli/commands/core/doctor-command.js +2 -323
- package/dist/cli/commands/core/doctor-logs.d.ts +8 -0
- package/dist/cli/commands/core/doctor-logs.js +32 -0
- package/dist/cli/commands/core/doctor-probes.d.ts +3 -0
- package/dist/cli/commands/core/doctor-probes.js +55 -0
- package/dist/cli/commands/core/doctor-run-command.d.ts +12 -0
- package/dist/cli/commands/core/doctor-run-command.js +172 -0
- package/dist/cli/commands/core/doctor-summary.d.ts +7 -0
- package/dist/cli/commands/core/doctor-summary.js +39 -0
- package/dist/cli/commands/core/memory-command-shared.d.ts +25 -0
- package/dist/cli/commands/core/memory-command-shared.js +20 -0
- package/dist/cli/commands/core/memory-command.d.ts +1 -1
- package/dist/cli/commands/core/memory-command.js +6 -227
- package/dist/cli/commands/core/memory-delegated-verbs.d.ts +4 -0
- package/dist/cli/commands/core/memory-delegated-verbs.js +178 -0
- package/dist/cli/commands/core/memory-extract-command.d.ts +3 -0
- package/dist/cli/commands/core/memory-extract-command.js +95 -0
- package/dist/cli/commands/core/memory-sync-command.d.ts +3 -0
- package/dist/cli/commands/core/memory-sync-command.js +38 -0
- package/dist/cli/commands/core/session-command.d.ts +1 -1
- package/dist/cli/commands/core/session-command.js +12 -206
- package/dist/cli/commands/core/session-info-command.d.ts +3 -0
- package/dist/cli/commands/core/session-info-command.js +142 -0
- package/dist/cli/commands/core/session-verb-commands.d.ts +5 -0
- package/dist/cli/commands/core/session-verb-commands.js +58 -0
- package/dist/cli/commands/core/standards-command.d.ts +1 -24
- package/dist/cli/commands/core/standards-command.js +33 -201
- package/dist/cli/commands/core/standards-init-command.d.ts +3 -0
- package/dist/cli/commands/core/standards-init-command.js +87 -0
- package/dist/cli/commands/core/standards-lint.d.ts +24 -0
- package/dist/cli/commands/core/standards-lint.js +57 -0
- package/dist/cli/commands/core/standards-migrate-command.d.ts +3 -0
- package/dist/cli/commands/core/standards-migrate-command.js +57 -0
- package/dist/cli/commands/cron-scheduler-commands.d.ts +5 -1
- package/dist/cli/commands/cron-scheduler-commands.js +36 -206
- package/dist/cli/commands/cron-scheduler-run-once-command.d.ts +7 -0
- package/dist/cli/commands/cron-scheduler-run-once-command.js +35 -0
- package/dist/cli/commands/cron-scheduler-shared.d.ts +6 -0
- package/dist/cli/commands/cron-scheduler-shared.js +48 -0
- package/dist/cli/commands/cron-scheduler-start-command.d.ts +7 -0
- package/dist/cli/commands/cron-scheduler-start-command.js +65 -0
- package/dist/cli/commands/cron-scheduler-status-command.d.ts +7 -0
- package/dist/cli/commands/cron-scheduler-status-command.js +46 -0
- package/dist/cli/commands/cron-scheduler-stop-command.d.ts +7 -0
- package/dist/cli/commands/cron-scheduler-stop-command.js +61 -0
- 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-commands.js +12 -5
- package/dist/cli/commands/dispatch-dag-envelope.d.ts +41 -0
- package/dist/cli/commands/dispatch-dag-envelope.js +49 -0
- package/dist/cli/commands/dispatch-dag-failure.d.ts +18 -0
- package/dist/cli/commands/dispatch-dag-failure.js +16 -0
- package/dist/cli/commands/dispatch-dag-preflight.d.ts +51 -0
- package/dist/cli/commands/dispatch-dag-preflight.js +105 -0
- package/dist/cli/commands/dispatch-dag-runners.d.ts +48 -0
- package/dist/cli/commands/dispatch-dag-runners.js +73 -0
- package/dist/cli/commands/dispatch-from-dag.d.ts +27 -0
- package/dist/cli/commands/dispatch-from-dag.js +87 -257
- package/dist/cli/commands/dispatch-preflight.js +46 -0
- package/dist/cli/commands/dispatch-prompt-composition.d.ts +6 -0
- package/dist/cli/commands/dispatch-prompt-composition.js +29 -7
- 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-command-envelopes.d.ts +44 -0
- package/dist/cli/commands/final-review-command-envelopes.js +100 -0
- package/dist/cli/commands/final-review-command-shared.d.ts +52 -0
- package/dist/cli/commands/final-review-command-shared.js +35 -0
- package/dist/cli/commands/final-review-commands.d.ts +7 -27
- package/dist/cli/commands/final-review-commands.js +13 -240
- package/dist/cli/commands/final-review-prepare-command.d.ts +3 -0
- package/dist/cli/commands/final-review-prepare-command.js +221 -0
- package/dist/cli/commands/gate-commands-enforce.js +3 -3
- package/dist/cli/commands/governance-classify-contract-commands.d.ts +23 -9
- package/dist/cli/commands/governance-classify-contract-commands.js +26 -269
- package/dist/cli/commands/hook-handle.js +41 -20
- package/dist/cli/commands/hooks-command-shared.d.ts +42 -0
- package/dist/cli/commands/hooks-command-shared.js +32 -0
- package/dist/cli/commands/hooks-commands.d.ts +20 -0
- package/dist/cli/commands/hooks-commands.js +75 -309
- package/dist/cli/commands/hooks-install-envelopes.d.ts +6 -0
- package/dist/cli/commands/hooks-install-envelopes.js +144 -0
- package/dist/cli/commands/hooks-status-command.d.ts +3 -0
- package/dist/cli/commands/hooks-status-command.js +93 -0
- package/dist/cli/commands/hooks-uninstall-command.d.ts +3 -0
- package/dist/cli/commands/hooks-uninstall-command.js +43 -0
- package/dist/cli/commands/lint-commands.js +3 -1
- package/dist/cli/commands/loop-command-shared.d.ts +31 -0
- package/dist/cli/commands/loop-command-shared.js +15 -0
- package/dist/cli/commands/loop-commands.d.ts +12 -17
- package/dist/cli/commands/loop-commands.js +56 -238
- package/dist/cli/commands/loop-eval-capture-index.js +2 -4
- package/dist/cli/commands/loop-export-command.d.ts +3 -0
- package/dist/cli/commands/loop-export-command.js +73 -0
- package/dist/cli/commands/loop-goal-compose-command.d.ts +3 -0
- package/dist/cli/commands/loop-goal-compose-command.js +36 -0
- package/dist/cli/commands/loop-import-command.d.ts +3 -0
- package/dist/cli/commands/loop-import-command.js +86 -0
- package/dist/cli/commands/loop-placeholder-commands.d.ts +3 -0
- package/dist/cli/commands/loop-placeholder-commands.js +52 -0
- package/dist/cli/commands/memory-command-shared.d.ts +59 -0
- package/dist/cli/commands/memory-command-shared.js +39 -0
- package/dist/cli/commands/memory-commands.d.ts +6 -79
- package/dist/cli/commands/memory-commands.js +19 -309
- package/dist/cli/commands/memory-ingest-command.d.ts +3 -0
- package/dist/cli/commands/memory-ingest-command.js +50 -0
- package/dist/cli/commands/memory-list-command.d.ts +16 -0
- package/dist/cli/commands/memory-list-command.js +129 -0
- package/dist/cli/commands/memory-reindex-command.d.ts +9 -0
- package/dist/cli/commands/memory-reindex-command.js +78 -0
- package/dist/cli/commands/memory-rotate-command.d.ts +3 -0
- package/dist/cli/commands/memory-rotate-command.js +55 -0
- package/dist/cli/commands/memory-search-command.d.ts +7 -0
- package/dist/cli/commands/memory-search-command.js +46 -0
- package/dist/cli/commands/openspec-archive-command.d.ts +3 -0
- package/dist/cli/commands/openspec-archive-command.js +55 -0
- package/dist/cli/commands/openspec-command-shared.d.ts +62 -0
- package/dist/cli/commands/openspec-command-shared.js +135 -0
- package/dist/cli/commands/openspec-commands.d.ts +1 -1
- package/dist/cli/commands/openspec-commands.js +33 -306
- package/dist/cli/commands/openspec-from-doctor-command.d.ts +3 -0
- package/dist/cli/commands/openspec-from-doctor-command.js +66 -0
- package/dist/cli/commands/openspec-init-command.d.ts +3 -0
- package/dist/cli/commands/openspec-init-command.js +49 -0
- package/dist/cli/commands/openspec-list-command.d.ts +3 -0
- package/dist/cli/commands/openspec-list-command.js +27 -0
- package/dist/cli/commands/openspec-render-command.d.ts +3 -0
- package/dist/cli/commands/openspec-render-command.js +33 -0
- package/dist/cli/commands/openspec-show-command.d.ts +3 -0
- package/dist/cli/commands/openspec-show-command.js +33 -0
- package/dist/cli/commands/openspec-to-rd-command.d.ts +3 -0
- package/dist/cli/commands/openspec-to-rd-command.js +33 -0
- package/dist/cli/commands/openspec-validate-command.d.ts +3 -0
- package/dist/cli/commands/openspec-validate-command.js +45 -0
- package/dist/cli/commands/perf-audit-commands.js +15 -5
- package/dist/cli/commands/playwright-browser-command.d.ts +8 -0
- package/dist/cli/commands/playwright-browser-command.js +61 -0
- package/dist/cli/commands/playwright-commands.d.ts +10 -62
- package/dist/cli/commands/playwright-commands.js +77 -400
- package/dist/cli/commands/playwright-envelope.d.ts +8 -0
- package/dist/cli/commands/playwright-envelope.js +29 -0
- package/dist/cli/commands/playwright-ls-stop-commands.d.ts +4 -0
- package/dist/cli/commands/playwright-ls-stop-commands.js +74 -0
- package/dist/cli/commands/playwright-session-store.d.ts +65 -0
- package/dist/cli/commands/playwright-session-store.js +189 -0
- package/dist/cli/commands/project-commands.d.ts +19 -0
- package/dist/cli/commands/project-commands.js +101 -259
- package/dist/cli/commands/project-context-command.d.ts +3 -0
- package/dist/cli/commands/project-context-command.js +44 -0
- package/dist/cli/commands/project-dashboard-command.d.ts +3 -0
- package/dist/cli/commands/project-dashboard-command.js +74 -0
- package/dist/cli/commands/project-knowledge-command.d.ts +3 -0
- package/dist/cli/commands/project-knowledge-command.js +48 -0
- package/dist/cli/commands/project-memories-show-command.d.ts +3 -0
- package/dist/cli/commands/project-memories-show-command.js +87 -0
- package/dist/cli/commands/project-memory-index-command.d.ts +3 -0
- package/dist/cli/commands/project-memory-index-command.js +31 -0
- package/dist/cli/commands/qa-archive-screenshots-command.d.ts +3 -0
- package/dist/cli/commands/qa-archive-screenshots-command.js +53 -0
- package/dist/cli/commands/qa-commands.d.ts +14 -87
- package/dist/cli/commands/qa-commands.js +17 -315
- package/dist/cli/commands/qa-context-prestep.d.ts +1 -0
- package/dist/cli/commands/qa-context-prestep.js +34 -0
- package/dist/cli/commands/qa-run-command.d.ts +3 -0
- package/dist/cli/commands/qa-run-command.js +105 -0
- package/dist/cli/commands/qa-run-options.d.ts +23 -0
- package/dist/cli/commands/qa-run-options.js +31 -0
- package/dist/cli/commands/qa-run-slice.d.ts +41 -0
- package/dist/cli/commands/qa-run-slice.js +145 -0
- 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/release-canary-command.d.ts +28 -0
- package/dist/cli/commands/release-canary-command.js +129 -0
- package/dist/cli/commands/release-command-shared.d.ts +13 -0
- package/dist/cli/commands/release-command-shared.js +18 -0
- package/dist/cli/commands/release-commands.d.ts +10 -18
- package/dist/cli/commands/release-commands.js +25 -298
- package/dist/cli/commands/release-done-command.d.ts +3 -0
- package/dist/cli/commands/release-done-command.js +64 -0
- package/dist/cli/commands/release-hotfix-command.d.ts +3 -0
- package/dist/cli/commands/release-hotfix-command.js +50 -0
- package/dist/cli/commands/release-plan-command.d.ts +3 -0
- package/dist/cli/commands/release-plan-command.js +33 -0
- package/dist/cli/commands/release-precheck-command.d.ts +3 -0
- package/dist/cli/commands/release-precheck-command.js +28 -0
- package/dist/cli/commands/release-promote-command.d.ts +3 -0
- package/dist/cli/commands/release-promote-command.js +34 -0
- package/dist/cli/commands/release-rollback-command.d.ts +3 -0
- package/dist/cli/commands/release-rollback-command.js +33 -0
- package/dist/cli/commands/release-watch-command.d.ts +3 -0
- package/dist/cli/commands/release-watch-command.js +44 -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/request-retag-command.d.ts +3 -0
- 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 +45 -3
- package/dist/cli/commands/scan-scope-commands.js +2 -2
- package/dist/cli/commands/security-audit-commands.js +26 -6
- package/dist/cli/commands/sediment-argv-flags.d.ts +54 -0
- package/dist/cli/commands/sediment-argv-flags.js +116 -0
- package/dist/cli/commands/sediment-command-shared.d.ts +15 -0
- package/dist/cli/commands/sediment-command-shared.js +5 -0
- package/dist/cli/commands/sediment-commands.d.ts +35 -59
- package/dist/cli/commands/sediment-commands.js +36 -590
- package/dist/cli/commands/sediment-pool-commands.d.ts +9 -0
- package/dist/cli/commands/sediment-pool-commands.js +185 -0
- package/dist/cli/commands/sediment-query-commands.d.ts +4 -0
- package/dist/cli/commands/sediment-query-commands.js +94 -0
- package/dist/cli/commands/sediment-release-commands.d.ts +8 -0
- package/dist/cli/commands/sediment-release-commands.js +232 -0
- package/dist/cli/commands/sop-advance-command.d.ts +3 -0
- package/dist/cli/commands/sop-advance-command.js +160 -0
- package/dist/cli/commands/sop-check-command.d.ts +3 -0
- package/dist/cli/commands/sop-check-command.js +44 -0
- package/dist/cli/commands/sop-command-shared.d.ts +23 -0
- package/dist/cli/commands/sop-command-shared.js +18 -0
- package/dist/cli/commands/sop-commands.d.ts +15 -1
- package/dist/cli/commands/sop-commands.js +26 -240
- package/dist/cli/commands/sop-init-command.d.ts +3 -0
- package/dist/cli/commands/sop-init-command.js +51 -0
- package/dist/cli/commands/sop-lint-command.d.ts +3 -0
- package/dist/cli/commands/sop-lint-command.js +64 -0
- package/dist/cli/commands/sop-register-command.d.ts +3 -0
- package/dist/cli/commands/sop-register-command.js +48 -0
- package/dist/cli/commands/sop-registry-command.d.ts +3 -0
- package/dist/cli/commands/sop-registry-command.js +30 -0
- package/dist/cli/commands/statusline-command-shared.d.ts +73 -0
- package/dist/cli/commands/statusline-command-shared.js +90 -0
- package/dist/cli/commands/statusline-commands.d.ts +1 -19
- package/dist/cli/commands/statusline-commands.js +48 -287
- package/dist/cli/commands/statusline-compact-command.d.ts +4 -0
- package/dist/cli/commands/statusline-compact-command.js +54 -0
- package/dist/cli/commands/statusline-install-command.d.ts +3 -0
- package/dist/cli/commands/statusline-install-command.js +48 -0
- package/dist/cli/commands/statusline-render-command.d.ts +9 -0
- package/dist/cli/commands/statusline-render-command.js +55 -0
- package/dist/cli/commands/statusline-status-command.d.ts +3 -0
- package/dist/cli/commands/statusline-status-command.js +23 -0
- package/dist/cli/commands/statusline-uninstall-command.d.ts +3 -0
- package/dist/cli/commands/statusline-uninstall-command.js +23 -0
- package/dist/cli/commands/test-command-run-helpers.d.ts +27 -0
- package/dist/cli/commands/test-command-run-helpers.js +73 -0
- package/dist/cli/commands/test-command-runner-resolution.d.ts +57 -0
- package/dist/cli/commands/test-command-runner-resolution.js +183 -0
- package/dist/cli/commands/test-commands.d.ts +8 -56
- package/dist/cli/commands/test-commands.js +26 -249
- package/dist/cli/commands/vm-command-shared.d.ts +23 -0
- package/dist/cli/commands/vm-command-shared.js +23 -0
- package/dist/cli/commands/vm-commands.d.ts +1 -28
- package/dist/cli/commands/vm-commands.js +36 -270
- package/dist/cli/commands/vm-hypervisor-runtime.d.ts +15 -0
- package/dist/cli/commands/vm-hypervisor-runtime.js +64 -0
- package/dist/cli/commands/vm-release-command.d.ts +5 -0
- package/dist/cli/commands/vm-release-command.js +101 -0
- package/dist/cli/commands/vm-spawn-command.d.ts +5 -0
- package/dist/cli/commands/vm-spawn-command.js +177 -0
- package/dist/cli/commands/web-command-shared.d.ts +12 -0
- package/dist/cli/commands/web-command-shared.js +30 -0
- package/dist/cli/commands/web-commands.d.ts +7 -14
- package/dist/cli/commands/web-commands.js +6 -314
- package/dist/cli/commands/web-install-command.d.ts +10 -0
- package/dist/cli/commands/web-install-command.js +116 -0
- package/dist/cli/commands/web-lifecycle-commands.d.ts +9 -30
- package/dist/cli/commands/web-lifecycle-commands.js +14 -322
- package/dist/cli/commands/web-login-command.d.ts +14 -0
- package/dist/cli/commands/web-login-command.js +189 -0
- package/dist/cli/commands/web-op-payload.d.ts +22 -0
- package/dist/cli/commands/web-op-payload.js +89 -0
- package/dist/cli/commands/web-op-refusals.d.ts +37 -0
- package/dist/cli/commands/web-op-refusals.js +73 -0
- package/dist/cli/commands/web-op-runner.d.ts +14 -0
- package/dist/cli/commands/web-op-runner.js +166 -0
- package/dist/cli/commands/web-status-command.d.ts +4 -0
- package/dist/cli/commands/web-status-command.js +32 -0
- package/dist/cli/commands/web-stop-command.d.ts +10 -0
- package/dist/cli/commands/web-stop-command.js +59 -0
- package/dist/cli/commands/web-verb-specs.d.ts +18 -0
- package/dist/cli/commands/web-verb-specs.js +66 -0
- package/dist/cli/commands/workflow-command-shared.d.ts +102 -0
- package/dist/cli/commands/workflow-command-shared.js +74 -0
- package/dist/cli/commands/workflow-graph-commands.d.ts +3 -0
- package/dist/cli/commands/workflow-graph-commands.js +73 -0
- package/dist/cli/commands/workflow-init-command.d.ts +3 -0
- package/dist/cli/commands/workflow-init-command.js +68 -0
- package/dist/cli/commands/workflow-lifecycle-commands.d.ts +9 -59
- package/dist/cli/commands/workflow-lifecycle-commands.js +14 -348
- package/dist/cli/commands/workflow-node-commands.d.ts +3 -0
- package/dist/cli/commands/workflow-node-commands.js +154 -0
- package/dist/cli/commands/workflow-terminalize-command.d.ts +3 -0
- package/dist/cli/commands/workflow-terminalize-command.js +56 -0
- package/dist/cli/commands/worktree-lease-gc-command.js +1 -1
- package/dist/services/artifacts/artifact-contract-block.d.ts +53 -0
- package/dist/services/artifacts/artifact-contract-block.js +212 -0
- package/dist/services/artifacts/artifact-prerequisites.d.ts +27 -19
- package/dist/services/artifacts/artifact-prerequisites.js +63 -133
- 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/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 +23 -51
- package/dist/services/artifacts/request-artifact-state-helpers.d.ts +12 -0
- package/dist/services/artifacts/request-artifact-state-helpers.js +28 -4
- 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 +79 -0
- package/dist/services/audit-independent/judged-declaration-check.js +155 -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/code/auto-compact-artifacts.d.ts +54 -0
- package/dist/services/code/auto-compact-artifacts.js +135 -0
- package/dist/services/code/auto-compact-attempt.d.ts +46 -0
- package/dist/services/code/auto-compact-attempt.js +88 -0
- package/dist/services/code/auto-compact-decision.d.ts +74 -0
- package/dist/services/code/auto-compact-decision.js +149 -0
- package/dist/services/code/auto-compact-dispatch-gate.d.ts +36 -0
- package/dist/services/code/auto-compact-dispatch-gate.js +86 -0
- package/dist/services/code/auto-compact-envelopes.d.ts +33 -0
- package/dist/services/code/auto-compact-envelopes.js +134 -0
- package/dist/services/code/auto-compact-history.d.ts +46 -0
- package/dist/services/code/auto-compact-history.js +17 -0
- package/dist/services/code/auto-compact-orchestrator.d.ts +11 -240
- package/dist/services/code/auto-compact-orchestrator.js +165 -686
- package/dist/services/code/auto-compact-run-types.d.ts +123 -0
- package/dist/services/code/auto-compact-run-types.js +1 -0
- package/dist/services/code/emit-handoff.d.ts +35 -1
- package/dist/services/code/emit-handoff.js +128 -7
- package/dist/services/code/step-08-gate.d.ts +28 -19
- package/dist/services/code/step-08-gate.js +92 -35
- package/dist/services/codegraph/codegraph-index-integrity.js +2 -0
- package/dist/services/config/config-coercion.d.ts +7 -0
- package/dist/services/config/config-coercion.js +156 -0
- package/dist/services/config/config-file-io.d.ts +11 -0
- package/dist/services/config/config-file-io.js +61 -0
- package/dist/services/config/config-get.d.ts +2 -0
- package/dist/services/config/config-get.js +36 -0
- package/dist/services/config/config-global-loader.d.ts +15 -0
- package/dist/services/config/config-global-loader.js +111 -0
- package/dist/services/config/config-nested-path.d.ts +3 -0
- package/dist/services/config/config-nested-path.js +53 -0
- package/dist/services/config/config-primitives.d.ts +16 -0
- package/dist/services/config/config-primitives.js +24 -0
- package/dist/services/config/config-service.d.ts +9 -33
- package/dist/services/config/config-service.js +16 -665
- package/dist/services/config/config-validation.d.ts +19 -0
- package/dist/services/config/config-validation.js +152 -0
- package/dist/services/config/config-workspace.d.ts +10 -0
- package/dist/services/config/config-workspace.js +158 -0
- package/dist/services/context/build-dispatch-system-prompt.d.ts +3 -3
- package/dist/services/context/build-dispatch-system-prompt.js +7 -7
- package/dist/services/context/collector.js +5 -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/evidence/evidence-generator.js +15 -8
- 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/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 +26 -0
- package/dist/services/scan/file-size-baseline.js +150 -0
- package/dist/services/scan/file-size-scan.d.ts +42 -3
- package/dist/services/scan/file-size-scan.js +58 -42
- package/dist/services/scan/type-sanity-service.js +13 -3
- package/dist/services/skill/resume-detector.js +3 -3
- 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-deny-list.d.ts +61 -0
- package/dist/services/skills/hooks-settings-deny-list.js +173 -0
- package/dist/services/skills/hooks-settings-envelopes.d.ts +20 -0
- package/dist/services/skills/hooks-settings-envelopes.js +79 -0
- package/dist/services/skills/hooks-settings-file-shape.d.ts +43 -0
- package/dist/services/skills/hooks-settings-file-shape.js +207 -0
- package/dist/services/skills/hooks-settings-paths.d.ts +34 -0
- package/dist/services/skills/hooks-settings-paths.js +75 -0
- package/dist/services/skills/hooks-settings-read-installed.d.ts +39 -0
- package/dist/services/skills/hooks-settings-read-installed.js +60 -0
- package/dist/services/skills/hooks-settings-service.d.ts +13 -213
- package/dist/services/skills/hooks-settings-service.js +72 -658
- package/dist/services/skills/hooks-settings-types.d.ts +139 -0
- package/dist/services/skills/hooks-settings-types.js +1 -0
- 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.js +2 -1
- package/dist/services/workflow/pipeline-verify-service.js +1 -1
- package/dist/services/workflow/workflow-skip-service.d.ts +0 -20
- package/dist/services/workflow/workflow-skip-service.js +3 -4
- 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 +109 -0
- package/dist/services/workspace/claude-settings-template-merge.js +223 -0
- package/dist/services/workspace/claude-settings-template.d.ts +79 -87
- package/dist/services/workspace/claude-settings-template.js +80 -235
- 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 +10 -0
- package/dist/shared/incrementing-number.js +27 -0
- package/package.json +5 -5
- package/skills/bee/peaks-perf-audit/SKILL.md +1 -1
- package/skills/bee/peaks-prd/SKILL.md +1 -1
- 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 +5 -2
- 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/services/audit/enforcers/lint-peaks-skill-runtime.d.ts +0 -23
- package/dist/services/audit/enforcers/lint-peaks-skill-runtime.js +0 -64
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The check that reads a declaration back and refuses when the tree moved.
|
|
3
|
+
*
|
|
4
|
+
* It hashes the bytes of every declared path. A commit does not change bytes,
|
|
5
|
+
* so the check is commitment-invariant by construction rather than by way of a
|
|
6
|
+
* git ref. A rename or a delete removes the path, and a rewrite changes its
|
|
7
|
+
* hash; each is refused by name. A path that appears under a declared root and
|
|
8
|
+
* was not declared is refused too, which is the one arm that needs a tree
|
|
9
|
+
* listing rather than a hash.
|
|
10
|
+
*
|
|
11
|
+
* The listing is `git ls-files -c -o --exclude-standard`, which is invariant
|
|
12
|
+
* under a commit: a commit redistributes tracked and untracked entries, it does
|
|
13
|
+
* not change the set of files on disk.
|
|
14
|
+
*
|
|
15
|
+
* Absence rule, stated where the producer reads it: an artifact that is present
|
|
16
|
+
* but carries no declaration is refused. There is no back-compat window,
|
|
17
|
+
* because this check is reached only from a transition that a slice in flight
|
|
18
|
+
* can re-run.
|
|
19
|
+
*/
|
|
20
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
21
|
+
import { execFileSync } from 'node:child_process';
|
|
22
|
+
import { join } from 'node:path';
|
|
23
|
+
import { parseJudgedDeclaration, sha256OfFile } from './judged-declaration.js';
|
|
24
|
+
/** Where the security audit artifact may live, newest tier first. */
|
|
25
|
+
export function securityArtifactTiers(rid) {
|
|
26
|
+
return [
|
|
27
|
+
`audit/security-${rid}.md`,
|
|
28
|
+
'audit/security.md',
|
|
29
|
+
`rd/security-review-${rid}.md`,
|
|
30
|
+
'rd/security-review.md'
|
|
31
|
+
];
|
|
32
|
+
}
|
|
33
|
+
export function resolveSecurityArtifact(projectRoot, sessionId, rid) {
|
|
34
|
+
const root = join(projectRoot, '.peaks', '_runtime', sessionId);
|
|
35
|
+
for (const relative of securityArtifactTiers(rid)) {
|
|
36
|
+
const absolute = join(root, ...relative.split('/'));
|
|
37
|
+
if (existsSync(absolute))
|
|
38
|
+
return { relative, absolute };
|
|
39
|
+
}
|
|
40
|
+
return null;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* List the files git knows about under a prefix. Fail-closed: a git read that
|
|
44
|
+
* did not happen is reported, never returned as an empty list.
|
|
45
|
+
*/
|
|
46
|
+
export function listTreeFiles(projectRoot, prefix) {
|
|
47
|
+
try {
|
|
48
|
+
const raw = execFileSync('git', ['-C', projectRoot, 'ls-files', '-c', '-o', '--exclude-standard', '--', prefix], { encoding: 'utf8', windowsHide: true });
|
|
49
|
+
const files = raw
|
|
50
|
+
.split(/\r?\n/)
|
|
51
|
+
.map((line) => line.trim())
|
|
52
|
+
.filter((line) => line.length > 0);
|
|
53
|
+
return { ok: true, files };
|
|
54
|
+
}
|
|
55
|
+
catch (error) {
|
|
56
|
+
return { ok: false, detail: error instanceof Error ? error.message : String(error) };
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
function readArtifact(absolute) {
|
|
60
|
+
try {
|
|
61
|
+
return { ok: true, body: readFileSync(absolute, 'utf8') };
|
|
62
|
+
}
|
|
63
|
+
catch (error) {
|
|
64
|
+
return { ok: false, detail: error instanceof Error ? error.message : String(error) };
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
function fileRefusals(input) {
|
|
68
|
+
const refusals = [];
|
|
69
|
+
for (const file of input.files) {
|
|
70
|
+
const hashed = sha256OfFile(join(input.projectRoot, ...file.path.split('/')));
|
|
71
|
+
if (!hashed.ok) {
|
|
72
|
+
refusals.push({
|
|
73
|
+
code: hashed.code === 'missing' ? 'declared-path-gone' : 'declared-path-unreadable',
|
|
74
|
+
artifact: input.artifact,
|
|
75
|
+
path: file.path
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
else if (hashed.sha256 !== file.sha256) {
|
|
79
|
+
refusals.push({ code: 'declared-path-modified', artifact: input.artifact, path: file.path });
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
return refusals;
|
|
83
|
+
}
|
|
84
|
+
function rootRefusals(input) {
|
|
85
|
+
const refusals = [];
|
|
86
|
+
for (const root of input.roots) {
|
|
87
|
+
const listed = listTreeFiles(input.projectRoot, root.path);
|
|
88
|
+
if (!listed.ok) {
|
|
89
|
+
refusals.push({ code: 'root-listing-failed', artifact: input.artifact, path: root.path });
|
|
90
|
+
continue;
|
|
91
|
+
}
|
|
92
|
+
for (const found of listed.files) {
|
|
93
|
+
if (input.declared.has(found))
|
|
94
|
+
continue;
|
|
95
|
+
if (found !== root.path && !found.startsWith(`${root.path}/`))
|
|
96
|
+
continue;
|
|
97
|
+
refusals.push({ code: 'undeclared-path-under-root', artifact: input.artifact, path: found });
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
return refusals;
|
|
101
|
+
}
|
|
102
|
+
/** Compare the declaration against the tree. Returns refusals, ordered by path. */
|
|
103
|
+
export function checkDeclarationAgainstTree(input) {
|
|
104
|
+
const refusals = [
|
|
105
|
+
...fileRefusals({ ...input, files: input.declaration.files }),
|
|
106
|
+
...rootRefusals({
|
|
107
|
+
...input,
|
|
108
|
+
roots: input.declaration.roots,
|
|
109
|
+
declared: new Set(input.declaration.files.map((f) => f.path))
|
|
110
|
+
})
|
|
111
|
+
];
|
|
112
|
+
return refusals.sort((a, b) => (a.path < b.path ? -1 : 1));
|
|
113
|
+
}
|
|
114
|
+
/**
|
|
115
|
+
* Entry point for the transition gate. An artifact that is not there is not
|
|
116
|
+
* this check's business — the artifact-existence prerequisite owns that.
|
|
117
|
+
*
|
|
118
|
+
* LIMIT, measured rather than assumed — the hole that survives is COMPLETENESS,
|
|
119
|
+
* not tampering: the declaration is the producer's own statement, so ten files
|
|
120
|
+
* touched and one declared passes. Nothing here can know what the producer did
|
|
121
|
+
* not say. Rule: a declaration is a claim about the paths it names, never a
|
|
122
|
+
* claim that those are all the paths.
|
|
123
|
+
*
|
|
124
|
+
* Absence rule, stated where the producer reads it, and the reason it is this
|
|
125
|
+
* blunt: a security artifact that IS there must carry a declaration. No section
|
|
126
|
+
* of the artifact turns the check off, because a requirement that any section
|
|
127
|
+
* can switch off is not a requirement — an earlier draft of this file keyed the
|
|
128
|
+
* requirement on a marker line in the coverage block, and deleting that block
|
|
129
|
+
* (while keeping the declaration, and then rewriting a declared path) passed.
|
|
130
|
+
* The cost is stated rather than hidden: an artifact written before this change
|
|
131
|
+
* is refused until the audit is re-run, and the gate only fires on a
|
|
132
|
+
* transition, so nothing already committed is affected.
|
|
133
|
+
*/
|
|
134
|
+
export function verifyJudgedDeclaration(input) {
|
|
135
|
+
const resolved = resolveSecurityArtifact(input.projectRoot, input.sessionId, input.requestId);
|
|
136
|
+
if (resolved === null)
|
|
137
|
+
return { refusals: [], checked: 0 };
|
|
138
|
+
const artifact = resolved.relative;
|
|
139
|
+
const read = readArtifact(resolved.absolute);
|
|
140
|
+
if (!read.ok) {
|
|
141
|
+
return { refusals: [{ code: 'artifact-unreadable', artifact, path: artifact }], checked: 0 };
|
|
142
|
+
}
|
|
143
|
+
const parsed = parseJudgedDeclaration(read.body);
|
|
144
|
+
if (!parsed.ok) {
|
|
145
|
+
// The refusal no section can switch off: the declaration is missing, or it
|
|
146
|
+
// does not parse to the grammar.
|
|
147
|
+
return { refusals: [{ code: parsed.code, artifact, path: artifact }], checked: 0 };
|
|
148
|
+
}
|
|
149
|
+
const refusals = checkDeclarationAgainstTree({
|
|
150
|
+
projectRoot: input.projectRoot,
|
|
151
|
+
artifact,
|
|
152
|
+
declaration: parsed.declaration
|
|
153
|
+
});
|
|
154
|
+
return { refusals, checked: parsed.declaration.files.length };
|
|
155
|
+
}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The machine-readable declaration of what an audit judged.
|
|
3
|
+
*
|
|
4
|
+
* `## Red-line scope` in the RD request is prose for a human and is read by no
|
|
5
|
+
* machine here. The declaration is the only machine-read statement of a
|
|
6
|
+
* slice's surface, and the producer that emits the artifact writes it, so a
|
|
7
|
+
* caller cannot produce the artifact without one.
|
|
8
|
+
*
|
|
9
|
+
* Grammar — exactly one fenced json block under the heading `## Judged content`:
|
|
10
|
+
*
|
|
11
|
+
* ## Judged content
|
|
12
|
+
*
|
|
13
|
+
* ```json
|
|
14
|
+
* {"schemaVersion":1,"judgedAt":"2026-10-13T00:00:00.000Z","handoffHash":"unknown",
|
|
15
|
+
* "files":[{"path":"src/a.ts","sha256":"<64 hex>"}],
|
|
16
|
+
* "roots":[{"path":"src/dir","why":"<text>"}]}
|
|
17
|
+
* ```
|
|
18
|
+
*
|
|
19
|
+
* Rules. No backslash anywhere in the block: JSON resolves an escaped spelling
|
|
20
|
+
* to the same string, so a raw reader and a parsing reader could disagree about
|
|
21
|
+
* what was declared. A `path` is a relative POSIX path with no `..` and no
|
|
22
|
+
* leading slash; `files` is non-empty; a duplicate path is refused. A root
|
|
23
|
+
* entry must carry a non-empty `why` — a bare directory root is refused.
|
|
24
|
+
*
|
|
25
|
+
* LIMIT, recorded rather than fixed: any rule keyed on a self-reported field is
|
|
26
|
+
* closed against accidental shedding, and not against a producer that rewrites
|
|
27
|
+
* its own field.
|
|
28
|
+
*/
|
|
29
|
+
export declare const JUDGED_HEADING = "## Judged content";
|
|
30
|
+
export declare const JUDGED_SCHEMA_VERSION = 1;
|
|
31
|
+
export type JudgedFile = {
|
|
32
|
+
readonly path: string;
|
|
33
|
+
readonly sha256: string;
|
|
34
|
+
};
|
|
35
|
+
export type JudgedRoot = {
|
|
36
|
+
readonly path: string;
|
|
37
|
+
readonly why: string;
|
|
38
|
+
};
|
|
39
|
+
export type JudgedDeclaration = {
|
|
40
|
+
readonly schemaVersion: number;
|
|
41
|
+
readonly judgedAt: string;
|
|
42
|
+
readonly handoffHash: string;
|
|
43
|
+
readonly files: readonly JudgedFile[];
|
|
44
|
+
readonly roots: readonly JudgedRoot[];
|
|
45
|
+
};
|
|
46
|
+
export type JudgedParseFailure = {
|
|
47
|
+
readonly ok: false;
|
|
48
|
+
readonly code: string;
|
|
49
|
+
readonly detail: string;
|
|
50
|
+
};
|
|
51
|
+
export type JudgedParseResult = {
|
|
52
|
+
readonly ok: true;
|
|
53
|
+
readonly declaration: JudgedDeclaration;
|
|
54
|
+
} | JudgedParseFailure;
|
|
55
|
+
/**
|
|
56
|
+
* The audit service's detect result when the declaration cannot be built. It
|
|
57
|
+
* lives here so the producer can substitute it for the probe's verdict without
|
|
58
|
+
* growing the service's own branch count.
|
|
59
|
+
*/
|
|
60
|
+
export declare function declarationMissingDetect(detect: {
|
|
61
|
+
readonly handoffPresent: boolean;
|
|
62
|
+
readonly templatePresent: boolean;
|
|
63
|
+
}, failure: JudgedParseFailure): {
|
|
64
|
+
readonly state: 'declaration-missing';
|
|
65
|
+
readonly handoffPresent: boolean;
|
|
66
|
+
readonly templatePresent: boolean;
|
|
67
|
+
readonly warnings: readonly string[];
|
|
68
|
+
readonly nextActions: readonly string[];
|
|
69
|
+
};
|
|
70
|
+
export type Sha256Result = {
|
|
71
|
+
readonly ok: true;
|
|
72
|
+
readonly sha256: string;
|
|
73
|
+
} | {
|
|
74
|
+
readonly ok: false;
|
|
75
|
+
readonly code: 'missing' | 'unreadable';
|
|
76
|
+
readonly detail: string;
|
|
77
|
+
};
|
|
78
|
+
/** Hash the bytes of one file. A missing file is reported, never guessed. */
|
|
79
|
+
export declare function sha256OfFile(absPath: string): Sha256Result;
|
|
80
|
+
/** A declared path is a relative POSIX path pointing at one file. */
|
|
81
|
+
export declare function validateDeclaredPath(raw: unknown): {
|
|
82
|
+
ok: true;
|
|
83
|
+
path: string;
|
|
84
|
+
} | {
|
|
85
|
+
ok: false;
|
|
86
|
+
detail: string;
|
|
87
|
+
};
|
|
88
|
+
/** Render the declaration as the artifact section the check reads back. */
|
|
89
|
+
export declare function renderJudgedDeclaration(declaration: JudgedDeclaration): string;
|
|
90
|
+
/**
|
|
91
|
+
* Parse the declaration out of an artifact body. Strict on shape: a block that
|
|
92
|
+
* parses to something other than the grammar is a refusal, never a default.
|
|
93
|
+
*/
|
|
94
|
+
export declare function parseJudgedDeclaration(body: string): JudgedParseResult;
|
|
@@ -0,0 +1,218 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The machine-readable declaration of what an audit judged.
|
|
3
|
+
*
|
|
4
|
+
* `## Red-line scope` in the RD request is prose for a human and is read by no
|
|
5
|
+
* machine here. The declaration is the only machine-read statement of a
|
|
6
|
+
* slice's surface, and the producer that emits the artifact writes it, so a
|
|
7
|
+
* caller cannot produce the artifact without one.
|
|
8
|
+
*
|
|
9
|
+
* Grammar — exactly one fenced json block under the heading `## Judged content`:
|
|
10
|
+
*
|
|
11
|
+
* ## Judged content
|
|
12
|
+
*
|
|
13
|
+
* ```json
|
|
14
|
+
* {"schemaVersion":1,"judgedAt":"2026-10-13T00:00:00.000Z","handoffHash":"unknown",
|
|
15
|
+
* "files":[{"path":"src/a.ts","sha256":"<64 hex>"}],
|
|
16
|
+
* "roots":[{"path":"src/dir","why":"<text>"}]}
|
|
17
|
+
* ```
|
|
18
|
+
*
|
|
19
|
+
* Rules. No backslash anywhere in the block: JSON resolves an escaped spelling
|
|
20
|
+
* to the same string, so a raw reader and a parsing reader could disagree about
|
|
21
|
+
* what was declared. A `path` is a relative POSIX path with no `..` and no
|
|
22
|
+
* leading slash; `files` is non-empty; a duplicate path is refused. A root
|
|
23
|
+
* entry must carry a non-empty `why` — a bare directory root is refused.
|
|
24
|
+
*
|
|
25
|
+
* LIMIT, recorded rather than fixed: any rule keyed on a self-reported field is
|
|
26
|
+
* closed against accidental shedding, and not against a producer that rewrites
|
|
27
|
+
* its own field.
|
|
28
|
+
*/
|
|
29
|
+
import { createHash } from 'node:crypto';
|
|
30
|
+
import { readFileSync } from 'node:fs';
|
|
31
|
+
export const JUDGED_HEADING = '## Judged content';
|
|
32
|
+
export const JUDGED_SCHEMA_VERSION = 1;
|
|
33
|
+
/**
|
|
34
|
+
* The audit service's detect result when the declaration cannot be built. It
|
|
35
|
+
* lives here so the producer can substitute it for the probe's verdict without
|
|
36
|
+
* growing the service's own branch count.
|
|
37
|
+
*/
|
|
38
|
+
export function declarationMissingDetect(detect, failure) {
|
|
39
|
+
return {
|
|
40
|
+
state: 'declaration-missing',
|
|
41
|
+
handoffPresent: detect.handoffPresent,
|
|
42
|
+
templatePresent: detect.templatePresent,
|
|
43
|
+
warnings: [
|
|
44
|
+
`security-audit refused: the judged declaration is not buildable (${failure.code}: ${failure.detail}).`
|
|
45
|
+
],
|
|
46
|
+
nextActions: [
|
|
47
|
+
'Pass every judged path with --judged <path> (repeatable); each must exist and be a file.',
|
|
48
|
+
'A run that declares nothing is refused rather than given an unbounded surface.'
|
|
49
|
+
]
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
/** Hash the bytes of one file. A missing file is reported, never guessed. */
|
|
53
|
+
export function sha256OfFile(absPath) {
|
|
54
|
+
let bytes;
|
|
55
|
+
try {
|
|
56
|
+
bytes = readFileSync(absPath);
|
|
57
|
+
}
|
|
58
|
+
catch (error) {
|
|
59
|
+
const code = error.code === 'ENOENT' ? 'missing' : 'unreadable';
|
|
60
|
+
const detail = error instanceof Error ? error.message : String(error);
|
|
61
|
+
return { ok: false, code, detail };
|
|
62
|
+
}
|
|
63
|
+
return { ok: true, sha256: createHash('sha256').update(bytes).digest('hex') };
|
|
64
|
+
}
|
|
65
|
+
/** A declared path is a relative POSIX path pointing at one file. */
|
|
66
|
+
export function validateDeclaredPath(raw) {
|
|
67
|
+
if (typeof raw !== 'string' || raw.length === 0) {
|
|
68
|
+
return { ok: false, detail: 'path must be a non-empty string' };
|
|
69
|
+
}
|
|
70
|
+
if (raw.includes('\\'))
|
|
71
|
+
return { ok: false, detail: `path must not contain a backslash: ${raw}` };
|
|
72
|
+
if (raw.startsWith('/'))
|
|
73
|
+
return { ok: false, detail: `path must be relative: ${raw}` };
|
|
74
|
+
if (/^[a-zA-Z]:/.test(raw))
|
|
75
|
+
return { ok: false, detail: `path must be relative: ${raw}` };
|
|
76
|
+
if (raw.endsWith('/')) {
|
|
77
|
+
return { ok: false, detail: `path must name a file, not a directory: ${raw}` };
|
|
78
|
+
}
|
|
79
|
+
const segments = raw.split('/');
|
|
80
|
+
if (segments.some((s) => s === '' || s === '.' || s === '..')) {
|
|
81
|
+
return { ok: false, detail: `path must be normalised with no traversal: ${raw}` };
|
|
82
|
+
}
|
|
83
|
+
return { ok: true, path: raw };
|
|
84
|
+
}
|
|
85
|
+
const HEX64 = /^[a-f0-9]{64}$/;
|
|
86
|
+
/** Render the declaration as the artifact section the check reads back. */
|
|
87
|
+
export function renderJudgedDeclaration(declaration) {
|
|
88
|
+
const payload = {
|
|
89
|
+
schemaVersion: declaration.schemaVersion,
|
|
90
|
+
judgedAt: declaration.judgedAt,
|
|
91
|
+
handoffHash: declaration.handoffHash,
|
|
92
|
+
files: declaration.files.map((f) => ({ path: f.path, sha256: f.sha256 })),
|
|
93
|
+
roots: declaration.roots.map((r) => ({ path: r.path, why: r.why }))
|
|
94
|
+
};
|
|
95
|
+
return [JUDGED_HEADING, '', '```json', JSON.stringify(payload), '```', ''].join('\n');
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Extract the fenced block under the heading. Returns the raw block text or a
|
|
99
|
+
* code naming why there is none. Deliberately literal: a heading that does not
|
|
100
|
+
* match byte-for-byte is a missing declaration, not a variant to accommodate.
|
|
101
|
+
*/
|
|
102
|
+
function extractJudgedBlock(body) {
|
|
103
|
+
const lines = body.split(/\r?\n/);
|
|
104
|
+
const start = lines.findIndex((line) => line.trimEnd() === JUDGED_HEADING);
|
|
105
|
+
if (start === -1)
|
|
106
|
+
return { ok: false, code: 'declaration-missing' };
|
|
107
|
+
const rest = lines.slice(start + 1);
|
|
108
|
+
const fenceStart = rest.findIndex((line) => line.trim() === '```json');
|
|
109
|
+
if (fenceStart === -1)
|
|
110
|
+
return { ok: false, code: 'declaration-unfenced' };
|
|
111
|
+
const block = [];
|
|
112
|
+
for (const line of rest.slice(fenceStart + 1)) {
|
|
113
|
+
if (line.trim() === '```')
|
|
114
|
+
return { ok: true, block: block.join('\n') };
|
|
115
|
+
block.push(line);
|
|
116
|
+
}
|
|
117
|
+
return { ok: false, code: 'declaration-unterminated' };
|
|
118
|
+
}
|
|
119
|
+
function parseFileEntries(raw) {
|
|
120
|
+
if (!Array.isArray(raw) || raw.length === 0) {
|
|
121
|
+
return { ok: false, code: 'declaration-empty', detail: 'files must be a non-empty array' };
|
|
122
|
+
}
|
|
123
|
+
const files = [];
|
|
124
|
+
const seen = new Set();
|
|
125
|
+
for (const entry of raw) {
|
|
126
|
+
if (entry === null || typeof entry !== 'object') {
|
|
127
|
+
return { ok: false, code: 'declaration-schema', detail: 'a files entry is not an object' };
|
|
128
|
+
}
|
|
129
|
+
const row = entry;
|
|
130
|
+
const checked = validateDeclaredPath(row['path']);
|
|
131
|
+
if (!checked.ok)
|
|
132
|
+
return { ok: false, code: 'declaration-path', detail: checked.detail };
|
|
133
|
+
if (typeof row['sha256'] !== 'string' || !HEX64.test(row['sha256'])) {
|
|
134
|
+
return { ok: false, code: 'declaration-hash', detail: checked.path };
|
|
135
|
+
}
|
|
136
|
+
if (seen.has(checked.path)) {
|
|
137
|
+
return { ok: false, code: 'declaration-duplicate', detail: checked.path };
|
|
138
|
+
}
|
|
139
|
+
seen.add(checked.path);
|
|
140
|
+
files.push({ path: checked.path, sha256: row['sha256'] });
|
|
141
|
+
}
|
|
142
|
+
return { ok: true, files };
|
|
143
|
+
}
|
|
144
|
+
function parseRootEntries(raw) {
|
|
145
|
+
if (!Array.isArray(raw)) {
|
|
146
|
+
return { ok: false, code: 'declaration-schema', detail: 'roots must be an array' };
|
|
147
|
+
}
|
|
148
|
+
const roots = [];
|
|
149
|
+
for (const entry of raw) {
|
|
150
|
+
if (entry === null || typeof entry !== 'object') {
|
|
151
|
+
return { ok: false, code: 'declaration-schema', detail: 'a roots entry is not an object' };
|
|
152
|
+
}
|
|
153
|
+
const row = entry;
|
|
154
|
+
const checked = validateDeclaredPath(row['path']);
|
|
155
|
+
if (!checked.ok)
|
|
156
|
+
return { ok: false, code: 'declaration-path', detail: checked.detail };
|
|
157
|
+
const why = row['why'];
|
|
158
|
+
if (typeof why !== 'string' || why.trim().length === 0) {
|
|
159
|
+
return { ok: false, code: 'declaration-bare-root', detail: checked.path };
|
|
160
|
+
}
|
|
161
|
+
roots.push({ path: checked.path, why });
|
|
162
|
+
}
|
|
163
|
+
return { ok: true, roots };
|
|
164
|
+
}
|
|
165
|
+
function parseEnvelopeBlock(block) {
|
|
166
|
+
// A backslash is refused before parsing, not after: JSON resolves escapes, so
|
|
167
|
+
// a parsed value and the raw bytes could describe different surfaces.
|
|
168
|
+
if (block.includes('\\')) {
|
|
169
|
+
return { ok: false, code: 'declaration-escaped', detail: 'the block contains a backslash' };
|
|
170
|
+
}
|
|
171
|
+
let raw;
|
|
172
|
+
try {
|
|
173
|
+
raw = JSON.parse(block);
|
|
174
|
+
}
|
|
175
|
+
catch (error) {
|
|
176
|
+
const detail = error instanceof Error ? error.message : String(error);
|
|
177
|
+
return { ok: false, code: 'declaration-unparsable', detail };
|
|
178
|
+
}
|
|
179
|
+
if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
|
|
180
|
+
return { ok: false, code: 'declaration-unparsable', detail: 'the block is not a JSON object' };
|
|
181
|
+
}
|
|
182
|
+
const obj = raw;
|
|
183
|
+
if (obj['schemaVersion'] !== JUDGED_SCHEMA_VERSION) {
|
|
184
|
+
return { ok: false, code: 'declaration-schema', detail: String(obj['schemaVersion']) };
|
|
185
|
+
}
|
|
186
|
+
if (typeof obj['judgedAt'] !== 'string' || typeof obj['handoffHash'] !== 'string') {
|
|
187
|
+
return { ok: false, code: 'declaration-schema', detail: 'judgedAt / handoffHash' };
|
|
188
|
+
}
|
|
189
|
+
return { ok: true, obj };
|
|
190
|
+
}
|
|
191
|
+
/**
|
|
192
|
+
* Parse the declaration out of an artifact body. Strict on shape: a block that
|
|
193
|
+
* parses to something other than the grammar is a refusal, never a default.
|
|
194
|
+
*/
|
|
195
|
+
export function parseJudgedDeclaration(body) {
|
|
196
|
+
const extracted = extractJudgedBlock(body);
|
|
197
|
+
if (!extracted.ok)
|
|
198
|
+
return { ok: false, code: extracted.code, detail: JUDGED_HEADING };
|
|
199
|
+
const envelope = parseEnvelopeBlock(extracted.block);
|
|
200
|
+
if (!envelope.ok)
|
|
201
|
+
return envelope;
|
|
202
|
+
const files = parseFileEntries(envelope.obj['files']);
|
|
203
|
+
if (!files.ok)
|
|
204
|
+
return files;
|
|
205
|
+
const roots = parseRootEntries(envelope.obj['roots'] ?? []);
|
|
206
|
+
if (!roots.ok)
|
|
207
|
+
return roots;
|
|
208
|
+
return {
|
|
209
|
+
ok: true,
|
|
210
|
+
declaration: {
|
|
211
|
+
schemaVersion: JUDGED_SCHEMA_VERSION,
|
|
212
|
+
judgedAt: envelope.obj['judgedAt'],
|
|
213
|
+
handoffHash: envelope.obj['handoffHash'],
|
|
214
|
+
files: files.files,
|
|
215
|
+
roots: roots.roots
|
|
216
|
+
}
|
|
217
|
+
};
|
|
218
|
+
}
|
|
@@ -20,11 +20,12 @@
|
|
|
20
20
|
* - Schema: `.peaks/project-scan/audit-output-schema.md` (schemaVersion: 1)
|
|
21
21
|
* - Companion: `src/services/audit-independent/security-audit-service.ts`
|
|
22
22
|
*/
|
|
23
|
-
import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
|
|
23
|
+
import { existsSync, readFileSync, writeFileSync, mkdirSync, renameSync } from 'node:fs';
|
|
24
24
|
import { join, resolve, isAbsolute } from 'node:path';
|
|
25
25
|
import { createHash } from 'node:crypto';
|
|
26
26
|
import { REQUEST_ID_PATTERN } from '../artifacts/request-artifact-service.js';
|
|
27
27
|
import { resolveHandoffPath } from '../prd/handoff-service.js';
|
|
28
|
+
import { handoffMissingRefusal } from './handoff-missing-refusal.js';
|
|
28
29
|
/**
|
|
29
30
|
* Validate a raw value as a PerfAuditEnvelope. Mirrors the
|
|
30
31
|
* `isSecurityAuditEnvelope` strict-shape pattern.
|
|
@@ -150,22 +151,20 @@ export function detectPerfAudit(input) {
|
|
|
150
151
|
const templatePath = join(input.projectRoot, '.peaks', 'project-scan', 'perf-template.md');
|
|
151
152
|
const templatePresent = existsSync(templatePath);
|
|
152
153
|
if (!handoffPresent) {
|
|
154
|
+
const refusal = handoffMissingRefusal({
|
|
155
|
+
role: 'perf',
|
|
156
|
+
projectRoot: input.projectRoot,
|
|
157
|
+
sessionId: input.sessionId,
|
|
158
|
+
...(input.requestId !== undefined ? { requestId: input.requestId } : {}),
|
|
159
|
+
// Measured, not assumed: `detect` supplies no envelope at all.
|
|
160
|
+
envelopeValidated: input.envelope !== undefined && isPerfAuditEnvelope(input.envelope)
|
|
161
|
+
});
|
|
153
162
|
return {
|
|
154
163
|
state: 'handoff-missing',
|
|
155
164
|
handoffPresent: false,
|
|
156
165
|
templatePresent,
|
|
157
|
-
warnings:
|
|
158
|
-
|
|
159
|
-
...(input.requestId === undefined
|
|
160
|
-
? [
|
|
161
|
-
"No --rid was supplied, so only the pre-rid-scoping `prd/handoff.md` could be probed. Pass --rid to resolve this slice's `prd/handoff-<rid>.md`."
|
|
162
|
-
]
|
|
163
|
-
: [])
|
|
164
|
-
],
|
|
165
|
-
nextActions: [
|
|
166
|
-
'Run peaks-prd handoff init to produce a sha256-locked handoff before running peaks perf-audit.',
|
|
167
|
-
'Until the handoff exists, peaks-perf-audit cannot start (gate fail).'
|
|
168
|
-
]
|
|
166
|
+
warnings: refusal.warnings,
|
|
167
|
+
nextActions: refusal.nextActions
|
|
169
168
|
};
|
|
170
169
|
}
|
|
171
170
|
if (!templatePresent) {
|
|
@@ -303,7 +302,6 @@ export function writePerfAuditArtifact(projectRoot, sessionId, rid, body) {
|
|
|
303
302
|
const tmpPath = `${targetPath}.tmp`;
|
|
304
303
|
writeFileSync(tmpPath, body, 'utf8');
|
|
305
304
|
// Sync rename: on Windows, fs.renameSync overwrites if target exists (Node 22+)
|
|
306
|
-
const { renameSync } = require('node:fs');
|
|
307
305
|
renameSync(tmpPath, targetPath);
|
|
308
306
|
return targetPath;
|
|
309
307
|
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Rendering and writing of the security audit artifact. Split out of
|
|
3
|
+
* `security-audit-service.ts`, which was over the per-file cap; the service now
|
|
4
|
+
* depends on this module rather than carrying the markdown itself.
|
|
5
|
+
*/
|
|
6
|
+
import type { SecurityAuditEnvelope, SecurityAuditVerdict } from './security-audit-service.js';
|
|
7
|
+
/**
|
|
8
|
+
* Render a SecurityAuditEnvelope to the canonical audit artifact body
|
|
9
|
+
* (markdown). Produce a markdown body with all required sections, ready to
|
|
10
|
+
* write to `.peaks/_runtime/<sid>/audit/security-<rid>.md`.
|
|
11
|
+
*/
|
|
12
|
+
export declare function renderSecurityAuditArtifact(env: SecurityAuditEnvelope, opts: {
|
|
13
|
+
rid: string;
|
|
14
|
+
handoffHash: string;
|
|
15
|
+
generatedAt: string;
|
|
16
|
+
}): {
|
|
17
|
+
body: string;
|
|
18
|
+
violationsCount: number;
|
|
19
|
+
verdict: SecurityAuditVerdict;
|
|
20
|
+
};
|
|
21
|
+
/**
|
|
22
|
+
* Write the rendered audit artifact to
|
|
23
|
+
* `.peaks/_runtime/<sid>/audit/security-<rid>.md`.
|
|
24
|
+
*
|
|
25
|
+
* Atomic write (tmp + rename) to avoid partial writes on crash.
|
|
26
|
+
* Returns the absolute path on success.
|
|
27
|
+
*/
|
|
28
|
+
export declare function writeSecurityAuditArtifact(projectRoot: string, sessionId: string, rid: string, body: string): string;
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Rendering and writing of the security audit artifact. Split out of
|
|
3
|
+
* `security-audit-service.ts`, which was over the per-file cap; the service now
|
|
4
|
+
* depends on this module rather than carrying the markdown itself.
|
|
5
|
+
*/
|
|
6
|
+
import { mkdirSync, renameSync, writeFileSync } from 'node:fs';
|
|
7
|
+
import { join } from 'node:path';
|
|
8
|
+
import { REQUEST_ID_PATTERN } from '../artifacts/request-artifact-service.js';
|
|
9
|
+
/**
|
|
10
|
+
* Render a SecurityAuditEnvelope to the canonical audit artifact body
|
|
11
|
+
* (markdown). Produce a markdown body with all required sections, ready to
|
|
12
|
+
* write to `.peaks/_runtime/<sid>/audit/security-<rid>.md`.
|
|
13
|
+
*/
|
|
14
|
+
export function renderSecurityAuditArtifact(env, opts) {
|
|
15
|
+
const counts = {};
|
|
16
|
+
for (const v of env.violations) {
|
|
17
|
+
counts[v.severity] = (counts[v.severity] ?? 0) + 1;
|
|
18
|
+
}
|
|
19
|
+
const criticalCount = counts['CRITICAL'] ?? 0;
|
|
20
|
+
const findingsBullets = env.violations.length === 0
|
|
21
|
+
? '- (none)'
|
|
22
|
+
: env.violations
|
|
23
|
+
.map((v) => `- [${v.severity}] ${v.dimension} @ ${v.file}:${v.line} — ${v.hint}`)
|
|
24
|
+
.join('\n');
|
|
25
|
+
const requiredFixes = buildRequiredFixes(env);
|
|
26
|
+
const body = [
|
|
27
|
+
'## Summary',
|
|
28
|
+
'',
|
|
29
|
+
env.summary,
|
|
30
|
+
'',
|
|
31
|
+
'## Threat model coverage',
|
|
32
|
+
'',
|
|
33
|
+
`audited at: ${opts.generatedAt}`,
|
|
34
|
+
`verdict: ${env.verdict}`,
|
|
35
|
+
`handoffHash: ${opts.handoffHash}`,
|
|
36
|
+
'',
|
|
37
|
+
'## Findings',
|
|
38
|
+
'',
|
|
39
|
+
findingsBullets,
|
|
40
|
+
'',
|
|
41
|
+
requiredFixes,
|
|
42
|
+
'## Verdict',
|
|
43
|
+
'',
|
|
44
|
+
`verdict: ${env.verdict}`,
|
|
45
|
+
`CRITICAL: ${criticalCount}`,
|
|
46
|
+
''
|
|
47
|
+
]
|
|
48
|
+
.filter((s) => s.length > 0)
|
|
49
|
+
.join('\n');
|
|
50
|
+
return {
|
|
51
|
+
body,
|
|
52
|
+
violationsCount: env.violations.length,
|
|
53
|
+
verdict: env.verdict
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
function buildRequiredFixes(env) {
|
|
57
|
+
const requiredFixes = env.violations.length === 0
|
|
58
|
+
? ''
|
|
59
|
+
: [
|
|
60
|
+
'## Required fixes',
|
|
61
|
+
'',
|
|
62
|
+
...env.violations.map((v) => `- [${v.severity}] ${v.file}:${v.line} — ${v.hint}`),
|
|
63
|
+
''
|
|
64
|
+
].join('\n');
|
|
65
|
+
return requiredFixes;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Write the rendered audit artifact to
|
|
69
|
+
* `.peaks/_runtime/<sid>/audit/security-<rid>.md`.
|
|
70
|
+
*
|
|
71
|
+
* Atomic write (tmp + rename) to avoid partial writes on crash.
|
|
72
|
+
* Returns the absolute path on success.
|
|
73
|
+
*/
|
|
74
|
+
export function writeSecurityAuditArtifact(projectRoot, sessionId, rid, body) {
|
|
75
|
+
// The rid is a filename below, and the write is tmp+rename, so an
|
|
76
|
+
// unvalidated rid can OVERWRITE an arbitrary `.md` rather than merely create
|
|
77
|
+
// one. Guarded here (not only at the CLI boundary) so no caller can skip it.
|
|
78
|
+
if (!REQUEST_ID_PATTERN.test(rid)) {
|
|
79
|
+
throw new Error(`Invalid request id: ${rid} (expected letters, digits, dots, underscores, or dashes)`);
|
|
80
|
+
}
|
|
81
|
+
const targetDir = join(projectRoot, '.peaks', '_runtime', sessionId, 'audit');
|
|
82
|
+
mkdirSync(targetDir, { recursive: true });
|
|
83
|
+
const targetPath = join(targetDir, `security-${rid}.md`);
|
|
84
|
+
// tmp + rename for atomicity
|
|
85
|
+
const tmpPath = `${targetPath}.tmp`;
|
|
86
|
+
writeFileSync(tmpPath, body, 'utf8');
|
|
87
|
+
// Sync rename: on Windows, fs.renameSync overwrites if target exists (Node 22+)
|
|
88
|
+
renameSync(tmpPath, targetPath);
|
|
89
|
+
return targetPath;
|
|
90
|
+
}
|