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,67 @@
|
|
|
1
|
+
// src/services/final-review/final-review-evidence-records.ts
|
|
2
|
+
//
|
|
3
|
+
// The `CollectedEvidence` record builders — one per way a source can turn out:
|
|
4
|
+
// read failure (missing vs unreadable), blank, omitted, and found (whole or as
|
|
5
|
+
// an over-cap EXCERPT). Hoisted out of final-review-evidence-collect.ts, which
|
|
6
|
+
// the slice of 2026-10-13 left at 298 of its 300-line cap; the bodies are
|
|
7
|
+
// byte-for-byte what that module held. The allocator and the read phase stay
|
|
8
|
+
// there, so the one-directional edge is collect → records.
|
|
9
|
+
import { MAX_EVIDENCE_BYTES_TOTAL } from './final-review-evidence-budget.js';
|
|
10
|
+
export function readFailureEvidence(base, candidate) {
|
|
11
|
+
// `read` is never `'ok'` here (it is set exactly when the read failed),
|
|
12
|
+
// and `'ok'` is not a status — the branch is what says which of the two
|
|
13
|
+
// failure facts this is.
|
|
14
|
+
const status = candidate.read === 'unreadable' ? 'unreadable' : 'missing';
|
|
15
|
+
return {
|
|
16
|
+
...base,
|
|
17
|
+
status,
|
|
18
|
+
totalBytes: 0,
|
|
19
|
+
includedBytes: 0,
|
|
20
|
+
excerpt: false,
|
|
21
|
+
content: '',
|
|
22
|
+
reason: candidate.read === 'missing'
|
|
23
|
+
? candidate.error
|
|
24
|
+
: `the file exists but could not be read (${candidate.error})`
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
export function blankEvidence(base, raw) {
|
|
28
|
+
return {
|
|
29
|
+
...base,
|
|
30
|
+
status: 'empty',
|
|
31
|
+
totalBytes: raw.byteLength,
|
|
32
|
+
includedBytes: 0,
|
|
33
|
+
excerpt: false,
|
|
34
|
+
content: '',
|
|
35
|
+
reason: `file exists but contains no reviewable content (${raw.byteLength} bytes)`
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
export function omittedEvidence(base, raw, ctx) {
|
|
39
|
+
const { allowance, budgetLeft, candidates, holders, pending, reservedElsewhere, unit, index } = ctx;
|
|
40
|
+
const waiting = [...pending]
|
|
41
|
+
.filter((holder) => holder !== index)
|
|
42
|
+
.map((holder) => `${holders.get(holder)} (source ${candidates[holder]?.source.key ?? '?'})`);
|
|
43
|
+
return {
|
|
44
|
+
...base,
|
|
45
|
+
status: 'omitted',
|
|
46
|
+
totalBytes: raw.byteLength,
|
|
47
|
+
includedBytes: 0,
|
|
48
|
+
excerpt: false,
|
|
49
|
+
content: '',
|
|
50
|
+
reason: reservedElsewhere > 0
|
|
51
|
+
? `${reservedElsewhere} bytes of the budget are reserved for dimension(s) ${waiting.join(', ')} — their only remaining evidence comes later in the source order; this source is inlined WHOLE or not at all and needs ${unit} bytes, while ${budgetLeft} were left (${allowance} after the reservation)`
|
|
52
|
+
: `total evidence budget (${MAX_EVIDENCE_BYTES_TOTAL} bytes) is exhausted — this source is inlined WHOLE or not at all and needs ${unit} bytes, ${budgetLeft} were left`
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
export function foundEvidence(base, raw, unit, content) {
|
|
56
|
+
return {
|
|
57
|
+
...base,
|
|
58
|
+
status: 'found',
|
|
59
|
+
totalBytes: raw.byteLength,
|
|
60
|
+
includedBytes: unit,
|
|
61
|
+
// `unit` is `sourceUnit(candidate)` = `min(file bytes, cap)`, so this is
|
|
62
|
+
// exactly "the FILE is bigger than the cap" — never a budget-cut fragment.
|
|
63
|
+
excerpt: unit < raw.byteLength,
|
|
64
|
+
content,
|
|
65
|
+
reason: ''
|
|
66
|
+
};
|
|
67
|
+
}
|
|
@@ -37,6 +37,15 @@ export interface EvidenceSource {
|
|
|
37
37
|
* it (`enforceScopeContractDelivery` returns early on `missing`).
|
|
38
38
|
*/
|
|
39
39
|
readonly legacySegments?: readonly string[];
|
|
40
|
+
/**
|
|
41
|
+
* Further older locations, tried **in declared order** after
|
|
42
|
+
* `legacySegments`. Needed because one artifact has THREE tiers on disk
|
|
43
|
+
* (`audit/security-<rid>.md` → `rd/security-review-<rid>.md` →
|
|
44
|
+
* `rd/security-review.md`). Mirrors `legacyRelativePaths` on
|
|
45
|
+
* `ArtifactPrerequisite` in `src/services/artifacts/artifact-prerequisites.ts`,
|
|
46
|
+
* which splits its older tiers the same way for the same reason.
|
|
47
|
+
*/
|
|
48
|
+
readonly olderSegments?: readonly (readonly string[])[];
|
|
40
49
|
/** Dimensions this source can supply evidence for. */
|
|
41
50
|
readonly supports: readonly DimensionKind[];
|
|
42
51
|
/** What DELIVERED means for this source. See `isDelivered()` — every source
|
|
@@ -104,6 +113,19 @@ export interface CollectedEvidence {
|
|
|
104
113
|
readonly totalBytes: number;
|
|
105
114
|
/** Bytes actually inlined into the prompt. */
|
|
106
115
|
readonly includedBytes: number;
|
|
116
|
+
/**
|
|
117
|
+
* The allocator's EXCERPT outcome: the FILE is larger than the per-file cap,
|
|
118
|
+
* so only its head was inlined. Measured 2026-10-13 on an all-oversized set
|
|
119
|
+
* (19,256 / 42,335 / 28,414 bytes against a 10,240 cap): the prompt carried a
|
|
120
|
+
* cap-sized head of each, 30,720 bytes, while the delivery report said "no
|
|
121
|
+
* source CAN be delivered". The excerpt was in the prompt; the statement that
|
|
122
|
+
* it was not is the claim-stronger-than-the-code defect.
|
|
123
|
+
*
|
|
124
|
+
* It is NOT delivery under the `whole` rule — `isDelivered` still answers
|
|
125
|
+
* `false` for it, because the conclusion may be in the part that was cut, so
|
|
126
|
+
* it may not back a `pass`. What it must not do is go unnamed.
|
|
127
|
+
*/
|
|
128
|
+
readonly excerpt: boolean;
|
|
107
129
|
readonly content: string;
|
|
108
130
|
/** Why this source carries no evidence (non-`found` statuses only). */
|
|
109
131
|
readonly reason: string;
|
|
@@ -93,7 +93,12 @@ function baseEvidenceSourcesA(rid) {
|
|
|
93
93
|
{
|
|
94
94
|
key: 'rd-code-review',
|
|
95
95
|
label: 'RD code review',
|
|
96
|
-
|
|
96
|
+
// The request id is part of the filename so two slices in one session do
|
|
97
|
+
// not collide (the same reason as CODE_REVIEW in
|
|
98
|
+
// `src/services/artifacts/artifact-prerequisites.ts`); the bare name is
|
|
99
|
+
// the older tier and is the legacy fallback.
|
|
100
|
+
segments: ['rd', `code-review-${rid}.md`],
|
|
101
|
+
legacySegments: ['rd', 'code-review.md'],
|
|
97
102
|
supports: ['no-new-bugs'],
|
|
98
103
|
delivery: { kind: 'whole' }
|
|
99
104
|
}
|
|
@@ -103,8 +108,21 @@ function baseEvidenceSourcesB(rid) {
|
|
|
103
108
|
return [
|
|
104
109
|
{
|
|
105
110
|
key: 'rd-security-review',
|
|
106
|
-
label
|
|
107
|
-
|
|
111
|
+
// The label names what the bytes ARE. The canonical path carries the
|
|
112
|
+
// independent `peaks-security-audit` envelope, so "RD security review"
|
|
113
|
+
// would now misname the producer — but the legacy tier really is the
|
|
114
|
+
// RD-authored review, so the parenthetical must cover both.
|
|
115
|
+
label: 'Security review (independent audit, or legacy RD review)',
|
|
116
|
+
// Mirrors AUDIT_SECURITY **and** SECURITY_REVIEW in
|
|
117
|
+
// `src/services/artifacts/artifact-prerequisites.ts`: the scoped
|
|
118
|
+
// `audit/security-${rid}.md` is canonical, the scoped
|
|
119
|
+
// `rd/security-review-${rid}.md` is the `config` row's own requirement
|
|
120
|
+
// (it was ridless, so a second config slice in a session overwrote the
|
|
121
|
+
// first's review), and the bare `rd/security-review.md` — the v2.11.x RD
|
|
122
|
+
// slot the independent audit skill replaced — is the oldest tier.
|
|
123
|
+
segments: ['audit', `security-${rid}.md`],
|
|
124
|
+
legacySegments: ['rd', `security-review-${rid}.md`],
|
|
125
|
+
olderSegments: [['rd', 'security-review.md']],
|
|
108
126
|
supports: ['no-new-bugs'],
|
|
109
127
|
delivery: { kind: 'whole' }
|
|
110
128
|
},
|
|
@@ -118,7 +136,13 @@ function baseEvidenceSourcesB(rid) {
|
|
|
118
136
|
{
|
|
119
137
|
key: 'rd-bug-analysis',
|
|
120
138
|
label: 'RD bug analysis (original problem statement)',
|
|
121
|
-
|
|
139
|
+
// Mirrors BUG_ANALYSIS in `src/services/artifacts/artifact-prerequisites.ts`:
|
|
140
|
+
// the scoped name is canonical and the bare name is the pre-scoping tier.
|
|
141
|
+
// A segment matcher fails by NOT matching, so the positive direction is
|
|
142
|
+
// asserted — by the bug-analysis scoping suite under
|
|
143
|
+
// tests/unit/services/artifacts/, which names its own file in its header.
|
|
144
|
+
segments: ['rd', `bug-analysis-${rid}.md`],
|
|
145
|
+
legacySegments: ['rd', 'bug-analysis.md'],
|
|
122
146
|
supports: ['problem-resolution'],
|
|
123
147
|
delivery: { kind: 'whole' }
|
|
124
148
|
},
|
|
@@ -13,8 +13,13 @@ export function renderEvidenceSection(collected) {
|
|
|
13
13
|
const heading = `### [${index + 1}] ${item.source.key} — ${item.source.label}`;
|
|
14
14
|
const supports = `SUPPORTS: ${item.source.supports.join(', ')}`;
|
|
15
15
|
if (item.status === 'found') {
|
|
16
|
-
|
|
17
|
-
|
|
16
|
+
// An over-cap source IS delivered — as a bounded excerpt. The block says
|
|
17
|
+
// so in as many words, with the byte count and the withheld fraction, so
|
|
18
|
+
// a reviewer cannot read a head of a file as the whole file and a human
|
|
19
|
+
// reading the transcript can see the evidence was partial.
|
|
20
|
+
const withheld = item.totalBytes - item.includedBytes;
|
|
21
|
+
const status = item.excerpt
|
|
22
|
+
? `FOUND at ${item.relativePath} — TRUNCATED EXCERPT (a HEAD, not the whole file): showing the first ${item.includedBytes} of ${item.totalBytes} bytes, ${withheld} bytes (${((withheld / item.totalBytes) * 100).toFixed(1)}%) withheld.`
|
|
18
23
|
: `FOUND at ${item.relativePath} — ${item.totalBytes} bytes`;
|
|
19
24
|
return `${heading}\n${supports}\nSTATUS: ${status}\n<<<EVIDENCE\n${item.content}\n>>>EVIDENCE`;
|
|
20
25
|
}
|
|
@@ -97,16 +102,24 @@ export function renderDeliveryReachabilityStatus(report) {
|
|
|
97
102
|
// Kept to one line per source and one line per dimension: this block rides
|
|
98
103
|
// inside the same byte-capped prompt as the evidence it describes, and the
|
|
99
104
|
// evidence blocks above already carry each source's path and status.
|
|
105
|
+
// Two measured states, not one assertion. An over-cap source IS delivered as
|
|
106
|
+
// a bounded excerpt (see the evidence blocks above); saying "no deliverable
|
|
107
|
+
// source" about a block the reviewer is reading is the claim-stronger-than-
|
|
108
|
+
// the-code defect, so the bullet names which of the two it is.
|
|
100
109
|
const lines = report.map((entry) => {
|
|
101
110
|
const sources = entry.sources
|
|
102
|
-
.map((item) =>
|
|
111
|
+
.map((item) => item.excerptBytes > 0
|
|
112
|
+
? `${item.key} (${String(item.totalBytes)} bytes; ${String(item.excerptBytes)} inlined, ${String(item.totalBytes - item.excerptBytes)} withheld)`
|
|
113
|
+
: `${item.key} (${String(item.totalBytes)} bytes; none inlined)`)
|
|
103
114
|
.join(', ');
|
|
104
|
-
return
|
|
115
|
+
return entry.excerptDelivered
|
|
116
|
+
? ` - ${entry.dimension}: EXCERPT ONLY — ${sources}. The reviewer received a bounded EXCERPT of each and NOT the documents.`
|
|
117
|
+
: ` - ${entry.dimension}: NO deliverable source — ${sources}. None was inlined, so no evidence for this dimension reached the reviewer.`;
|
|
105
118
|
});
|
|
106
119
|
return [
|
|
107
120
|
'## Evidence delivery reachability (structural)',
|
|
108
|
-
`The allocator inlines at most ${String(MAX_EVIDENCE_BYTES_PER_FILE)} bytes of any one source, WHOLE or not at all, and a source delivered under the "whole" rule is delivered only when the reviewer received ALL of it. For the dimension(s) below, every source on disk that supports it is larger than
|
|
121
|
+
`The allocator inlines at most ${String(MAX_EVIDENCE_BYTES_PER_FILE)} bytes of any one source, WHOLE or not at all, and a source delivered under the "whole" rule is delivered only when the reviewer received ALL of it. For the dimension(s) below, every source on disk that supports it is larger than the per-file cap of ${String(MAX_EVIDENCE_BYTES_PER_FILE)} bytes, so not one of them can ever be delivered WHOLE — not on this run and not on any run, whatever the budget.`,
|
|
109
122
|
...lines,
|
|
110
|
-
'Report each
|
|
123
|
+
'Report each as "inconclusive", confidence "low", naming this reason in its summary, and do NOT report "pass": the service re-checks it and downgrades one — a head of a file is not the document, and the conclusion may be in the part that was cut.'
|
|
111
124
|
].join('\n');
|
|
112
125
|
}
|
|
@@ -154,5 +154,10 @@ export async function prepareFinalReview(rid, opts) {
|
|
|
154
154
|
const { allPass, needsAttention } = summarizeVerdicts(dimensions, output, [
|
|
155
155
|
...(gated.mustAttend ? ['existing-functionality-intact'] : [])
|
|
156
156
|
]);
|
|
157
|
+
// The one model call this review made, reported to the caller at the point
|
|
158
|
+
// the review is COMPLETE: one completed `prepareFinalReview` call ⇒ one
|
|
159
|
+
// `token-usage` event, emitted by the caller because that is where the session
|
|
160
|
+
// binding lives.
|
|
161
|
+
opts.onLlmTokens?.(response.tokens);
|
|
157
162
|
return { ...output, dimensions, allPass, needsAttention };
|
|
158
163
|
}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { type PrePostDiffResult } from './pre-post-diff.js';
|
|
2
2
|
import { type CollectedEvidence, type EvidenceSource } from './final-review-evidence-sources.js';
|
|
3
|
-
import { IncompleteFinalReviewError, type LlmRunner, type PrepareFinalReviewOptions } from './final-review-contract.js';
|
|
3
|
+
import { IncompleteFinalReviewError, type LlmRunner, type LlmTokenUsage, type PrepareFinalReviewOptions } from './final-review-contract.js';
|
|
4
4
|
import type { DimensionEvidence, DimensionKind } from './final-review-types.js';
|
|
5
|
-
export { IncompleteFinalReviewError, type LlmRunner, type PrepareFinalReviewOptions };
|
|
5
|
+
export { IncompleteFinalReviewError, type LlmRunner, type LlmTokenUsage, type PrepareFinalReviewOptions };
|
|
6
6
|
/**
|
|
7
7
|
* The on-disk sources, in allocation order.
|
|
8
8
|
*
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
export { prepareFinalReview, type PrepareFinalReviewOptions, type LlmRunner, IncompleteFinalReviewError, MAX_EVIDENCE_BYTES_PER_FILE, MAX_EVIDENCE_BYTES_TOTAL, assertFloorReservationAffordable, undeliverableDimensions, type UndeliverableDimensionEvidence } from './final-review-service.js';
|
|
1
|
+
export { prepareFinalReview, type PrepareFinalReviewOptions, type LlmRunner, type LlmTokenUsage, IncompleteFinalReviewError, MAX_EVIDENCE_BYTES_PER_FILE, MAX_EVIDENCE_BYTES_TOTAL, assertFloorReservationAffordable, undeliverableDimensions, type UndeliverableDimensionEvidence } from './final-review-service.js';
|
|
2
2
|
export { classifyPrePostDiffVerdict, type PrePostDiffConclusion } from './pre-post-diff.js';
|
|
3
3
|
export type { DimensionKind, DimensionVerdict, EvidenceKind, DimensionConfidence, EvidenceItem, DimensionEvidence, FinalReviewOutput } from './final-review-types.js';
|
|
@@ -43,86 +43,12 @@
|
|
|
43
43
|
* indistinguishable from a clean comparison. Conclusion-first makes "the
|
|
44
44
|
* reviewer got the answer" a property of the bytes received.
|
|
45
45
|
*/
|
|
46
|
-
|
|
47
|
-
export declare const API_DIFF_ARTIFACT_SEGMENTS: readonly ["final-review", "api-diff.txt"];
|
|
48
|
-
/**
|
|
49
|
-
* The literal that opens the artifact's conclusion line.
|
|
50
|
-
*
|
|
51
|
-
* Exported because the consumer must be able to test for the CONCLUSION, not
|
|
52
|
-
* for a byte count (F-BLOCK-1BYTE): one byte of `api-diff.txt` satisfied
|
|
53
|
-
* "status: found" while conveying nothing, and the delivery gate it fed then let
|
|
54
|
-
* a `pass` stand on a comparison nobody saw. The producer writes the line this
|
|
55
|
-
* marker opens and `final-review-service.ts` requires it in the delivered
|
|
56
|
-
* bytes, so the two cannot drift apart into the same hole again.
|
|
57
|
-
*/
|
|
58
|
-
export declare const PRE_POST_DIFF_VERDICT_MARKER = "VERDICT: ";
|
|
59
|
-
/**
|
|
60
|
-
* The three conclusions the artifact may open with, exported as the same
|
|
61
|
-
* literals the writer interpolates below.
|
|
62
|
-
*
|
|
63
|
-
* They are constants because reading the conclusion is now part of the
|
|
64
|
-
* consumer's job (F2): the pre/post-diff source is the one source whose
|
|
65
|
-
* conclusion had a machine-readable form all along, and the envelope threw it
|
|
66
|
-
* away — a delivered `STRUCTURAL DRIFT DETECTED` produced `allPass: true` with
|
|
67
|
-
* an empty `needsAttention`. A consumer that must classify the conclusion may
|
|
68
|
-
* only do so against the producer's own literals, never against a re-typed
|
|
69
|
-
* copy of them.
|
|
70
|
-
*/
|
|
71
|
-
export declare const PRE_POST_DIFF_NO_DRIFT = "NO STRUCTURAL DRIFT";
|
|
72
|
-
export declare const PRE_POST_DIFF_ADDITIONS_ONLY = "ADDITIONS ONLY";
|
|
73
|
-
export declare const PRE_POST_DIFF_DRIFT_DETECTED = "STRUCTURAL DRIFT DETECTED";
|
|
74
|
-
/**
|
|
75
|
-
* What the artifact's conclusion LINE says, read from the bytes a consumer
|
|
76
|
-
* actually received.
|
|
77
|
-
*
|
|
78
|
-
* `indeterminate` is not "nothing to report": it is "the line is there (or is
|
|
79
|
-
* not) and this consumer cannot classify it", which for a drift DETECTOR is a
|
|
80
|
-
* fact a human has to see — see `enforceStructuralDriftAttention`.
|
|
81
|
-
*/
|
|
82
|
-
export type PrePostDiffConclusion = 'no-drift' | 'additions-only' | 'drift-detected' | 'indeterminate';
|
|
83
|
-
/**
|
|
84
|
-
* Classify the delivered conclusion. Pure and total: a caller passes the bytes
|
|
85
|
-
* it received (possibly a head slice) and gets back what the artifact says.
|
|
86
|
-
*
|
|
87
|
-
* Only the FIRST `VERDICT:` line is read. The artifact's header promises the
|
|
88
|
-
* verdict "is repeated nowhere" and that it is the file's conclusion, so a
|
|
89
|
-
* later line cannot be the answer, and reading further would let a document's
|
|
90
|
-
* prose masquerade as its conclusion.
|
|
91
|
-
*/
|
|
92
|
-
export declare function classifyPrePostDiffVerdict(content: string): PrePostDiffConclusion;
|
|
46
|
+
import { type PrePostDiffResult, type ProducePrePostDiffOptions } from './final-review-contract.js';
|
|
93
47
|
/** Test-file globs — the single definition both the file count and the case
|
|
94
48
|
* count use, so the two can never disagree about what a "test file" is. */
|
|
95
49
|
export declare const TEST_FILE_GLOBS: readonly ["*.test.ts", "*.test.tsx", "*.spec.ts", "*.spec.tsx"];
|
|
96
50
|
/** Source globs for the public-API surface. */
|
|
97
51
|
export declare const API_SOURCE_GLOBS: readonly ["*.ts", "*.tsx"];
|
|
98
|
-
export interface PrePostDiffComputed {
|
|
99
|
-
readonly status: 'computed';
|
|
100
|
-
readonly summary: string;
|
|
101
|
-
readonly relativePath: string;
|
|
102
|
-
readonly absolutePath: string;
|
|
103
|
-
readonly content: string;
|
|
104
|
-
}
|
|
105
|
-
export interface PrePostDiffUnavailable {
|
|
106
|
-
readonly status: 'unavailable';
|
|
107
|
-
/** Why no baseline exists, in the operator's terms. */
|
|
108
|
-
readonly reason: string;
|
|
109
|
-
/**
|
|
110
|
-
* `true` when the project root IS a git work tree — i.e. a baseline was
|
|
111
|
-
* expected to be computable and was not. That distinction shapes the REASON
|
|
112
|
-
* the operator is given (a tooling failure to fix, versus a project that has
|
|
113
|
-
* no baseline to offer), and the service refuses a `pass` on this dimension
|
|
114
|
-
* either way: "not a git repository" is the CAUSE of the missing evidence,
|
|
115
|
-
* never a licence to trust the claim the evidence was supposed to support.
|
|
116
|
-
*/
|
|
117
|
-
readonly inGitWorkTree: boolean;
|
|
118
|
-
}
|
|
119
|
-
export type PrePostDiffResult = PrePostDiffComputed | PrePostDiffUnavailable;
|
|
120
|
-
export interface ProducePrePostDiffOptions {
|
|
121
|
-
readonly projectRoot: string;
|
|
122
|
-
readonly sessionId: string;
|
|
123
|
-
/** Explicit base ref. Unset ⇒ merge-base with the upstream default branch. */
|
|
124
|
-
readonly baseRef?: string;
|
|
125
|
-
}
|
|
126
52
|
/**
|
|
127
53
|
* The exported NAMES bound by one source line. Approximate by design: the
|
|
128
54
|
* column-0 anchor is what keeps it to top-level declarations, and
|
|
@@ -135,3 +61,4 @@ export declare function extractExportedNames(line: string): readonly string[];
|
|
|
135
61
|
* must report a dimension it could not assess.
|
|
136
62
|
*/
|
|
137
63
|
export declare function producePrePostDiff(opts: ProducePrePostDiffOptions): PrePostDiffResult;
|
|
64
|
+
export { API_DIFF_ARTIFACT_SEGMENTS, PRE_POST_DIFF_VERDICT_MARKER, PRE_POST_DIFF_NO_DRIFT, PRE_POST_DIFF_ADDITIONS_ONLY, PRE_POST_DIFF_DRIFT_DETECTED, classifyPrePostDiffVerdict, type PrePostDiffConclusion, type PrePostDiffComputed, type PrePostDiffUnavailable, type PrePostDiffResult, type ProducePrePostDiffOptions } from './final-review-contract.js';
|
|
@@ -46,58 +46,7 @@
|
|
|
46
46
|
import { execFileSync } from 'node:child_process';
|
|
47
47
|
import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
|
|
48
48
|
import { dirname, join } from 'node:path';
|
|
49
|
-
|
|
50
|
-
export const API_DIFF_ARTIFACT_SEGMENTS = ['final-review', 'api-diff.txt'];
|
|
51
|
-
/**
|
|
52
|
-
* The literal that opens the artifact's conclusion line.
|
|
53
|
-
*
|
|
54
|
-
* Exported because the consumer must be able to test for the CONCLUSION, not
|
|
55
|
-
* for a byte count (F-BLOCK-1BYTE): one byte of `api-diff.txt` satisfied
|
|
56
|
-
* "status: found" while conveying nothing, and the delivery gate it fed then let
|
|
57
|
-
* a `pass` stand on a comparison nobody saw. The producer writes the line this
|
|
58
|
-
* marker opens and `final-review-service.ts` requires it in the delivered
|
|
59
|
-
* bytes, so the two cannot drift apart into the same hole again.
|
|
60
|
-
*/
|
|
61
|
-
export const PRE_POST_DIFF_VERDICT_MARKER = 'VERDICT: ';
|
|
62
|
-
/**
|
|
63
|
-
* The three conclusions the artifact may open with, exported as the same
|
|
64
|
-
* literals the writer interpolates below.
|
|
65
|
-
*
|
|
66
|
-
* They are constants because reading the conclusion is now part of the
|
|
67
|
-
* consumer's job (F2): the pre/post-diff source is the one source whose
|
|
68
|
-
* conclusion had a machine-readable form all along, and the envelope threw it
|
|
69
|
-
* away — a delivered `STRUCTURAL DRIFT DETECTED` produced `allPass: true` with
|
|
70
|
-
* an empty `needsAttention`. A consumer that must classify the conclusion may
|
|
71
|
-
* only do so against the producer's own literals, never against a re-typed
|
|
72
|
-
* copy of them.
|
|
73
|
-
*/
|
|
74
|
-
export const PRE_POST_DIFF_NO_DRIFT = 'NO STRUCTURAL DRIFT';
|
|
75
|
-
export const PRE_POST_DIFF_ADDITIONS_ONLY = 'ADDITIONS ONLY';
|
|
76
|
-
export const PRE_POST_DIFF_DRIFT_DETECTED = 'STRUCTURAL DRIFT DETECTED';
|
|
77
|
-
/**
|
|
78
|
-
* Classify the delivered conclusion. Pure and total: a caller passes the bytes
|
|
79
|
-
* it received (possibly a head slice) and gets back what the artifact says.
|
|
80
|
-
*
|
|
81
|
-
* Only the FIRST `VERDICT:` line is read. The artifact's header promises the
|
|
82
|
-
* verdict "is repeated nowhere" and that it is the file's conclusion, so a
|
|
83
|
-
* later line cannot be the answer, and reading further would let a document's
|
|
84
|
-
* prose masquerade as its conclusion.
|
|
85
|
-
*/
|
|
86
|
-
export function classifyPrePostDiffVerdict(content) {
|
|
87
|
-
const line = content
|
|
88
|
-
.split(/\r?\n/)
|
|
89
|
-
.find((candidate) => candidate.startsWith(PRE_POST_DIFF_VERDICT_MARKER));
|
|
90
|
-
if (line === undefined)
|
|
91
|
-
return 'indeterminate';
|
|
92
|
-
const conclusion = line.slice(PRE_POST_DIFF_VERDICT_MARKER.length);
|
|
93
|
-
if (conclusion.startsWith(PRE_POST_DIFF_DRIFT_DETECTED))
|
|
94
|
-
return 'drift-detected';
|
|
95
|
-
if (conclusion.startsWith(PRE_POST_DIFF_ADDITIONS_ONLY))
|
|
96
|
-
return 'additions-only';
|
|
97
|
-
if (conclusion.startsWith(PRE_POST_DIFF_NO_DRIFT))
|
|
98
|
-
return 'no-drift';
|
|
99
|
-
return 'indeterminate';
|
|
100
|
-
}
|
|
49
|
+
import { API_DIFF_ARTIFACT_SEGMENTS, PRE_POST_DIFF_VERDICT_MARKER, PRE_POST_DIFF_NO_DRIFT, PRE_POST_DIFF_ADDITIONS_ONLY, PRE_POST_DIFF_DRIFT_DETECTED } from './final-review-contract.js';
|
|
101
50
|
/** Test-file globs — the single definition both the file count and the case
|
|
102
51
|
* count use, so the two can never disagree about what a "test file" is. */
|
|
103
52
|
export const TEST_FILE_GLOBS = ['*.test.ts', '*.test.tsx', '*.spec.ts', '*.spec.tsx'];
|
|
@@ -158,6 +107,19 @@ const EXPORT_DECL_RE = /^export\s+(?:declare\s+)?(?:async\s+)?(?:abstract\s+)?(?
|
|
|
158
107
|
const EXPORT_TYPE_LIST_RE = /^export\s+type\s*\{([^}]*)\}/;
|
|
159
108
|
const EXPORT_LIST_RE = /^export\s*\{([^}]*)\}/;
|
|
160
109
|
const EXPORT_DEFAULT_RE = /^export\s+default\b/;
|
|
110
|
+
/**
|
|
111
|
+
* An `export { … }` list OPENED on this line and closed on a LATER one.
|
|
112
|
+
*
|
|
113
|
+
* `EXPORT_LIST_RE` above requires the closing `}` on the same line, so a block
|
|
114
|
+
* written across several lines matched nothing at all. The miss is ASYMMETRIC,
|
|
115
|
+
* which is what makes it a false-positive source rather than a mere blind spot:
|
|
116
|
+
* reformatting a one-line `export { A, B, C };` into a five-line block left the
|
|
117
|
+
* before side binding three names and the after side binding NONE, so `A`, `B`
|
|
118
|
+
* and `C` were reported REMOVED while all three were still exported. A
|
|
119
|
+
* line-oriented reader cannot see such a block, so the statement is accumulated
|
|
120
|
+
* until the line carrying its closing brace (see the diff loop).
|
|
121
|
+
*/
|
|
122
|
+
const EXPORT_LIST_OPEN_RE = /^export\s*(?:type\s*)?\{[^}]*$/;
|
|
161
123
|
/**
|
|
162
124
|
* Run git read-only. Exit code 1 is `grep`-found-nothing and `merge-base`-no-
|
|
163
125
|
* common-ancestor, which are answers rather than failures — every caller
|
|
@@ -475,6 +437,26 @@ export function producePrePostDiff(opts) {
|
|
|
475
437
|
]).stdout;
|
|
476
438
|
const namesAddedByPath = new Map();
|
|
477
439
|
const namesRemovedByPath = new Map();
|
|
440
|
+
/** Record the names one diff line — its `-` / `+` sign already stripped — binds. */
|
|
441
|
+
const recordNames = (sign, text) => {
|
|
442
|
+
const names = extractExportedNames(text);
|
|
443
|
+
if (names.length === 0)
|
|
444
|
+
return;
|
|
445
|
+
const byPath = sign === '-' ? namesRemovedByPath : namesAddedByPath;
|
|
446
|
+
const bucket = byPath.get(currentPath) ?? new Set();
|
|
447
|
+
for (const name of names)
|
|
448
|
+
bucket.add(name);
|
|
449
|
+
byPath.set(currentPath, bucket);
|
|
450
|
+
};
|
|
451
|
+
// An `export { … }` list written across several lines is ONE statement; see
|
|
452
|
+
// `EXPORT_LIST_OPEN_RE`. It is accumulated here, per SIDE, because a unified
|
|
453
|
+
// diff emits every `-` line of a hunk before its `+` lines and the two sides
|
|
454
|
+
// must never be folded into one statement. A side still open when the other
|
|
455
|
+
// side begins — or when the diff ends — is parsed as it stands: with no
|
|
456
|
+
// closing brace it binds no name, which is the UNDER-reporting this module
|
|
457
|
+
// prefers over a manufactured removal.
|
|
458
|
+
let openSign = null;
|
|
459
|
+
let openStatement = '';
|
|
478
460
|
for (const line of diffText.split(/\r?\n/)) {
|
|
479
461
|
if (line.startsWith('+++ ')) {
|
|
480
462
|
currentPath = line.slice(4).replace(/^b\//, '');
|
|
@@ -484,15 +466,31 @@ export function producePrePostDiff(opts) {
|
|
|
484
466
|
continue;
|
|
485
467
|
if (!line.startsWith('-') && !line.startsWith('+'))
|
|
486
468
|
continue;
|
|
487
|
-
const
|
|
488
|
-
|
|
469
|
+
const sign = line.startsWith('-') ? '-' : '+';
|
|
470
|
+
const text = line.slice(1);
|
|
471
|
+
if (openSign !== null && sign === openSign) {
|
|
472
|
+
openStatement += ` ${text.trim()}`;
|
|
473
|
+
if (text.includes('}')) {
|
|
474
|
+
recordNames(sign, openStatement);
|
|
475
|
+
openSign = null;
|
|
476
|
+
openStatement = '';
|
|
477
|
+
}
|
|
489
478
|
continue;
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
479
|
+
}
|
|
480
|
+
if (openSign !== null) {
|
|
481
|
+
recordNames(openSign, openStatement);
|
|
482
|
+
openSign = null;
|
|
483
|
+
openStatement = '';
|
|
484
|
+
}
|
|
485
|
+
if (EXPORT_LIST_OPEN_RE.test(text)) {
|
|
486
|
+
openSign = sign;
|
|
487
|
+
openStatement = text.trim();
|
|
488
|
+
continue;
|
|
489
|
+
}
|
|
490
|
+
recordNames(sign, text);
|
|
495
491
|
}
|
|
492
|
+
if (openSign !== null)
|
|
493
|
+
recordNames(openSign, openStatement);
|
|
496
494
|
// F6 — a name that appears on BOTH sides of the same file was REWRITTEN or
|
|
497
495
|
// re-listed, not removed: `export { a }` -> `export { a, b }` diffs as
|
|
498
496
|
// `-export { a }` / `+export { a, b }`, and reading the minus side alone
|
|
@@ -666,3 +664,6 @@ export function producePrePostDiff(opts) {
|
|
|
666
664
|
: `Structural removals: ${removals.join('; ')}.`);
|
|
667
665
|
return { status: 'computed', summary, relativePath, absolutePath, content };
|
|
668
666
|
}
|
|
667
|
+
// The artifact's contract now lives in final-review-contract.ts; re-exported so
|
|
668
|
+
// every name that was importable from this module still is.
|
|
669
|
+
export { API_DIFF_ARTIFACT_SEGMENTS, PRE_POST_DIFF_VERDICT_MARKER, PRE_POST_DIFF_NO_DRIFT, PRE_POST_DIFF_ADDITIONS_ONLY, PRE_POST_DIFF_DRIFT_DETECTED, classifyPrePostDiffVerdict } from './final-review-contract.js';
|
|
@@ -41,5 +41,11 @@ export declare function extractFilePath(input: Readonly<Record<string, unknown>>
|
|
|
41
41
|
/**
|
|
42
42
|
* Pure decision function. Given the tool name + input object, return
|
|
43
43
|
* the gate verdict. Tolerates malformed payloads (allow).
|
|
44
|
+
*
|
|
45
|
+
* `driver` is the already-resolved identity of whoever is running the
|
|
46
|
+
* tool call, or `null`/absent when no caller identity resolved. Absent and
|
|
47
|
+
* `null` are the same verdict as before this parameter existed: the
|
|
48
|
+
* hard-blocked families deny. Resolution is the caller's job, so this
|
|
49
|
+
* module keeps no session, lease or filesystem state.
|
|
44
50
|
*/
|
|
45
|
-
export declare function decideGateAction(tool: GateToolName, input: Readonly<Record<string, unknown
|
|
51
|
+
export declare function decideGateAction(tool: GateToolName, input: Readonly<Record<string, unknown>>, driver?: string | null): GateVerdict;
|
|
@@ -37,6 +37,13 @@ export const ALLOW_LISTED_PATH_PATTERNS = [
|
|
|
37
37
|
'CHANGELOG.md',
|
|
38
38
|
'README.md'
|
|
39
39
|
];
|
|
40
|
+
/**
|
|
41
|
+
* The single driver identity that opens the hard-blocked families: the
|
|
42
|
+
* fast-lane skill's name, compared as a whole string. No prefix match and no
|
|
43
|
+
* case folding — a future `peaks-race-<something>` sibling must NOT inherit
|
|
44
|
+
* this write, because the write it opens is source editing.
|
|
45
|
+
*/
|
|
46
|
+
const FAST_LANE_DRIVER = 'peaks-race-code';
|
|
40
47
|
/** Pull the target file path from `input.file_path | input.path | input.notebook_path`. */
|
|
41
48
|
export function extractFilePath(input) {
|
|
42
49
|
for (const key of ['file_path', 'path', 'notebook_path']) {
|
|
@@ -59,8 +66,14 @@ function matchesAny(path, families) {
|
|
|
59
66
|
/**
|
|
60
67
|
* Pure decision function. Given the tool name + input object, return
|
|
61
68
|
* the gate verdict. Tolerates malformed payloads (allow).
|
|
69
|
+
*
|
|
70
|
+
* `driver` is the already-resolved identity of whoever is running the
|
|
71
|
+
* tool call, or `null`/absent when no caller identity resolved. Absent and
|
|
72
|
+
* `null` are the same verdict as before this parameter existed: the
|
|
73
|
+
* hard-blocked families deny. Resolution is the caller's job, so this
|
|
74
|
+
* module keeps no session, lease or filesystem state.
|
|
62
75
|
*/
|
|
63
|
-
export function decideGateAction(tool, input) {
|
|
76
|
+
export function decideGateAction(tool, input, driver) {
|
|
64
77
|
// Only gate Edit / Write / MultiEdit.
|
|
65
78
|
if (tool !== 'Edit' && tool !== 'Write' && tool !== 'MultiEdit') {
|
|
66
79
|
return { action: 'allow' };
|
|
@@ -72,7 +85,7 @@ export function decideGateAction(tool, input) {
|
|
|
72
85
|
// handles file paths only.
|
|
73
86
|
return { action: 'allow' };
|
|
74
87
|
}
|
|
75
|
-
// Allow-list check first — short-circuits any deny.
|
|
88
|
+
// Allow-list check first — short-circuits any deny, for every driver.
|
|
76
89
|
const allowMatch = matchesAny(filePath, ALLOW_LISTED_PATH_PATTERNS);
|
|
77
90
|
if (allowMatch !== null) {
|
|
78
91
|
return { action: 'allow' };
|
|
@@ -80,6 +93,12 @@ export function decideGateAction(tool, input) {
|
|
|
80
93
|
// Hard-blocked family check.
|
|
81
94
|
const denyMatch = matchesAny(filePath, HARD_BLOCKED_PATH_FAMILIES);
|
|
82
95
|
if (denyMatch !== null) {
|
|
96
|
+
// A driver that is not the fast lane falls through to the same deny a
|
|
97
|
+
// two-argument call produces, so an unresolvable identity can never
|
|
98
|
+
// become a silent pass.
|
|
99
|
+
if (driver === FAST_LANE_DRIVER) {
|
|
100
|
+
return { action: 'allow' };
|
|
101
|
+
}
|
|
83
102
|
const reason = `${denyMatch} (orchestrator's hard-blocked path family)`;
|
|
84
103
|
const message = `PEAKS_CODE_PROHIBITED_DIRECT_EDIT: ${filePath} matches hard-blocked path family ${reason}; ` +
|
|
85
104
|
`orchestrator MUST NOT Edit/Write these directly. Use: peaks sub-agent dispatch rd --prompt '<your task>' --request-id <rid> --project . --batch-id <uuid>`;
|
|
@@ -37,6 +37,7 @@ import { dirname, join } from 'node:path';
|
|
|
37
37
|
import { deserializeLease, isLeaseActive, leaseFilePath } from '../worktree/worktree-lease.js';
|
|
38
38
|
import { readDispatchProvenance } from '../worktree/dispatch-provenance.js';
|
|
39
39
|
import { containerLeaseFilePath, deserializeContainerLease, isContainerLeaseActive } from '../container/container-lease.js';
|
|
40
|
+
import { consumedGrantsDenial, expiredGrantsDenial, noAuthorizationDenial, noGrantForOperationDenial, requestMismatchDenial } from './worktree-refusal-messages.js';
|
|
40
41
|
export const WORKTREE_AUTH_FILE = 'worktree-auth.json';
|
|
41
42
|
/** Stable identifier of the current "user authorization" — derived from session + tool + key args. */
|
|
42
43
|
export function currentAuthFingerprint(input) {
|
|
@@ -165,13 +166,7 @@ export function classifyToolCall(input) {
|
|
|
165
166
|
*/
|
|
166
167
|
export function decideFromAuthorization(input, operation, file) {
|
|
167
168
|
if (file === null) {
|
|
168
|
-
return
|
|
169
|
-
allow: false,
|
|
170
|
-
code: 'WORKTREE_USER_AUTH_REQUIRED',
|
|
171
|
-
reason: `No current-task user authorization for "${operation}" (session=${input.sessionId}).`,
|
|
172
|
-
remediation: `Ask the user to explicitly authorize this worktree-mutating operation, then run \`peaks worktree auth grant --operation ${operation} --reason "<why>"\` ` +
|
|
173
|
-
`before the tool call retries. Re-running with --consume=false and a longer --ttl is allowed but should be rare.`
|
|
174
|
-
};
|
|
169
|
+
return noAuthorizationDenial(operation, input.sessionId);
|
|
175
170
|
}
|
|
176
171
|
const now = Date.now();
|
|
177
172
|
// First try to find a requestId-matched, non-consumed, unexpired grant. If none is found,
|
|
@@ -193,41 +188,21 @@ export function decideFromAuthorization(input, operation, file) {
|
|
|
193
188
|
// No live grant matched the current rid (or the caller's rid is null). Diagnose why.
|
|
194
189
|
const sameOpAnyState = file.grants.filter((g) => g.operation === operation);
|
|
195
190
|
if (sameOpAnyState.length === 0) {
|
|
196
|
-
return
|
|
197
|
-
allow: false,
|
|
198
|
-
code: 'WORKTREE_USER_AUTH_REQUIRED',
|
|
199
|
-
reason: `No grant for operation "${operation}" in this session.`,
|
|
200
|
-
remediation: `Run \`peaks worktree auth grant --operation ${operation} --reason "<why>"\` from the LLM after the user has explicitly asked for the operation.`
|
|
201
|
-
};
|
|
191
|
+
return noGrantForOperationDenial(operation);
|
|
202
192
|
}
|
|
203
193
|
const ridScoped = sameOpAnyState.find((g) => g.requestId !== null);
|
|
204
194
|
const ridMatchesScope = ridScoped !== undefined &&
|
|
205
195
|
(input.requestId === null || ridScoped.requestId === input.requestId);
|
|
206
196
|
if (ridScoped !== undefined && !ridMatchesScope) {
|
|
207
|
-
return
|
|
208
|
-
allow: false,
|
|
209
|
-
code: 'WORKTREE_USER_AUTH_REQUEST_MISMATCH',
|
|
210
|
-
reason: `Grant for "${operation}" is scoped to requestId=${ridScoped.requestId} but the current tool call carries requestId=${input.requestId ?? 'null'}.`,
|
|
211
|
-
remediation: `Either drop the requestId scope from the grant (\`peaks worktree auth grant --operation ${operation} --no-request-id\`) or operate under the scoped request.`
|
|
212
|
-
};
|
|
197
|
+
return requestMismatchDenial(operation, ridScoped.requestId, input.requestId);
|
|
213
198
|
}
|
|
214
199
|
// Otherwise: every grant for the operation is either consumed or expired.
|
|
215
200
|
const hasUnexpired = sameOpAnyState.some((g) => Date.parse(g.expiresAt) > now);
|
|
216
201
|
if (!hasUnexpired) {
|
|
217
|
-
return
|
|
218
|
-
allow: false,
|
|
219
|
-
code: 'WORKTREE_USER_AUTH_EXPIRED',
|
|
220
|
-
reason: `All grants for operation "${operation}" in this session have expired.`,
|
|
221
|
-
remediation: `Re-run \`peaks worktree auth grant --operation ${operation} --reason "<why>"\` (default TTL 5 min) before the tool call retries.`
|
|
222
|
-
};
|
|
202
|
+
return expiredGrantsDenial(operation);
|
|
223
203
|
}
|
|
224
204
|
// Grants exist and at least one is unexpired, but every non-expired one is consumed.
|
|
225
|
-
return
|
|
226
|
-
allow: false,
|
|
227
|
-
code: 'WORKTREE_USER_AUTH_REQUIRED',
|
|
228
|
-
reason: `All unexpired grants for operation "${operation}" in this session are already consumed.`,
|
|
229
|
-
remediation: `Re-run \`peaks worktree auth grant --operation ${operation} --reason "<why>"\` to issue a fresh grant (or pass --multi to make it multi-use).`
|
|
230
|
-
};
|
|
205
|
+
return consumedGrantsDenial(operation);
|
|
231
206
|
}
|
|
232
207
|
/**
|
|
233
208
|
* Public entry point used by `peaks gate enforce`. Reads the auth file, decides, and (when consume=true
|