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
|
@@ -28,7 +28,8 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from
|
|
|
28
28
|
import { dirname, join, resolve } from 'node:path';
|
|
29
29
|
import { registerSop } from '../sop/sop-registry-service.js';
|
|
30
30
|
import { projectRegistryPath, projectSopManifestPath } from '../sop/sop-paths.js';
|
|
31
|
-
import {
|
|
31
|
+
import { missingArtifacts } from './promotion-artifact-missing.js';
|
|
32
|
+
export { missingArtifacts };
|
|
32
33
|
/**
|
|
33
34
|
* PRD-002b slice 2 — extract magic numbers used by the promotion
|
|
34
35
|
* helper. `slice(0, 5)` was used as a heuristic on the user's body
|
|
@@ -47,7 +48,7 @@ export const PROMOTION_LAYER_DETAILS = [
|
|
|
47
48
|
{
|
|
48
49
|
layer: 'B',
|
|
49
50
|
label: 'peaks-hooks PreToolUse',
|
|
50
|
-
description: 'Append a matcher to
|
|
51
|
+
description: 'Append a matcher to `.peaks/.claude-settings-template.json`, or to `.claude/settings.json` for a hook that ships with this repository. Tool-call interception.'
|
|
51
52
|
},
|
|
52
53
|
{
|
|
53
54
|
layer: 'C',
|
|
@@ -72,9 +73,11 @@ export const PROMOTION_LAYER_DETAILS = [
|
|
|
72
73
|
* decoration: `gate-enforce-service.enforceBashCommand` enumerates SOPs via
|
|
73
74
|
* `readRegistry()`, so an unregistered manifest is off the enforcement path
|
|
74
75
|
* no matter how valid it is.
|
|
75
|
-
* - B (peaks-hooks PreToolUse):
|
|
76
|
-
*
|
|
77
|
-
*
|
|
76
|
+
* - B (peaks-hooks PreToolUse): the `hooks` block of one of the two settings
|
|
77
|
+
* files in `LAYER_B_SETTINGS` — the `.peaks/.claude-settings-template.json`
|
|
78
|
+
* snapshot, or this repository's tracked `.claude/settings.json` — must
|
|
79
|
+
* register the rule. The file always exists, so existence proves nothing:
|
|
80
|
+
* the evidence is the registration inside it.
|
|
78
81
|
* - C (mode-gate hardFloorCategory): `src/services/code/mode-gate.ts` must
|
|
79
82
|
* register the rule in the hard-floor vocabulary, for the same reason. This
|
|
80
83
|
* is the repo's existing convention: the one real layer-C promotion cites
|
|
@@ -110,7 +113,8 @@ export function promotionArtifactChecks(memoryName, layer) {
|
|
|
110
113
|
if (layer === 'B') {
|
|
111
114
|
return [
|
|
112
115
|
{
|
|
113
|
-
path:
|
|
116
|
+
path: LAYER_B_SETTINGS[0],
|
|
117
|
+
alternatives: [LAYER_B_SETTINGS[1]],
|
|
114
118
|
evidence: 'hook-registration',
|
|
115
119
|
id: memoryName
|
|
116
120
|
}
|
|
@@ -121,34 +125,25 @@ export function promotionArtifactChecks(memoryName, layer) {
|
|
|
121
125
|
];
|
|
122
126
|
}
|
|
123
127
|
/**
|
|
124
|
-
*
|
|
125
|
-
*
|
|
126
|
-
*
|
|
127
|
-
*
|
|
128
|
+
* The settings files a layer-B hook registration may legitimately live in.
|
|
129
|
+
*
|
|
130
|
+
* TWO locations, because there are two audiences and only one file each.
|
|
131
|
+
* `peaks workspace init` writes `.peaks/.claude-settings-template.json` in every
|
|
132
|
+
* project, consumer or not, so it is tried first. This repository's own
|
|
133
|
+
* development hooks are registered in the tracked `.claude/settings.json`
|
|
134
|
+
* instead — the template above is written into a CONSUMER tree, where
|
|
135
|
+
* `${CLAUDE_PROJECT_DIR}/src/**` names nothing, so a hook of ours cannot live
|
|
136
|
+
* there. Checking only the snapshot reports a rule that IS enforced as
|
|
137
|
+
* unpromoted; checking only the tracked file breaks every consumer.
|
|
138
|
+
*
|
|
139
|
+
* `.claude/settings.local.json` is deliberately NOT a third location: a rule
|
|
140
|
+
* backed only by that untracked file is the "true on one machine" state this
|
|
141
|
+
* artifact check exists to reject.
|
|
128
142
|
*/
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
if (!existsSync(absolute)) {
|
|
134
|
-
missing.push(`${check.path} (absent)`);
|
|
135
|
-
continue;
|
|
136
|
-
}
|
|
137
|
-
let text;
|
|
138
|
-
try {
|
|
139
|
-
text = readFileSync(absolute, 'utf8');
|
|
140
|
-
}
|
|
141
|
-
catch {
|
|
142
|
-
missing.push(`${check.path} (unreadable)`);
|
|
143
|
-
continue;
|
|
144
|
-
}
|
|
145
|
-
const failure = artifactEvidenceFailure(check, text);
|
|
146
|
-
if (failure !== null) {
|
|
147
|
-
missing.push(`${check.path} (${failure})`);
|
|
148
|
-
}
|
|
149
|
-
}
|
|
150
|
-
return missing;
|
|
151
|
-
}
|
|
143
|
+
const LAYER_B_SETTINGS = [
|
|
144
|
+
'.peaks/.claude-settings-template.json',
|
|
145
|
+
'.claude/settings.json'
|
|
146
|
+
];
|
|
152
147
|
const COMMENT_MARKER_RE = /<!--\s*peaks-feedback-promoted:\s*layer=([ABC])\s*-->/;
|
|
153
148
|
/**
|
|
154
149
|
* declaration.
|
|
@@ -518,8 +513,8 @@ export function generatePromotionStub(opts) {
|
|
|
518
513
|
}
|
|
519
514
|
if (layer === 'B') {
|
|
520
515
|
return {
|
|
521
|
-
snippet: `{\n "matcher": "Bash",\n "hooks": [\n {\n "type": "command",\n "command": "node -e \\"process.exit(0)\\""\n }\n ]\n}\n<!-- Append the rule-specific matcher to .peaks/.claude-settings-template.json -->`,
|
|
522
|
-
targetFiles: [
|
|
516
|
+
snippet: `{\n "matcher": "Bash",\n "hooks": [\n {\n "type": "command",\n "command": "node -e \\"process.exit(0)\\""\n }\n ]\n}\n<!-- Append the rule-specific matcher to .peaks/.claude-settings-template.json, or to .claude/settings.json for a hook that ships with this repository -->`,
|
|
517
|
+
targetFiles: [...LAYER_B_SETTINGS]
|
|
523
518
|
};
|
|
524
519
|
}
|
|
525
520
|
// layer === 'C'
|
|
@@ -18,6 +18,24 @@ export type PromotionEvidence =
|
|
|
18
18
|
export type PromotionArtifactCheck = {
|
|
19
19
|
/** Project-relative POSIX path whose CONTENT must carry the evidence. */
|
|
20
20
|
path: string;
|
|
21
|
+
/**
|
|
22
|
+
* Other project-relative paths where the SAME evidence may legitimately live.
|
|
23
|
+
*
|
|
24
|
+
* The conjunction is across CHECKS — layer A needs its manifest AND its
|
|
25
|
+
* registry entry — so an alternative location cannot be expressed as another
|
|
26
|
+
* check: that would demand it too. It belongs here, where the sense is OR.
|
|
27
|
+
*
|
|
28
|
+
* Layer B is the reason the field exists. Its registration is written into
|
|
29
|
+
* whichever Claude settings file the project actually reads: a consumer gets
|
|
30
|
+
* the generated snapshot, while this repository registers its own development
|
|
31
|
+
* hooks in the tracked `.claude/settings.json` — the template that produces the
|
|
32
|
+
* snapshot is written into a consumer tree, where a command naming
|
|
33
|
+
* `${CLAUDE_PROJECT_DIR}/src/**` resolves to nothing.
|
|
34
|
+
*
|
|
35
|
+
* `artifactEvidenceFailure` reads `evidence` and `id` only, so the same check
|
|
36
|
+
* is tried against every candidate as it stands.
|
|
37
|
+
*/
|
|
38
|
+
alternatives?: readonly string[];
|
|
21
39
|
evidence: PromotionEvidence;
|
|
22
40
|
/** The rule id the evidence must name (a SOP id for layer A, a memory name for B and C). */
|
|
23
41
|
id: string;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The reader half of the promotion-artifact concern: which of a layer's required
|
|
3
|
+
* artifacts are NOT present, under a given project root.
|
|
4
|
+
*
|
|
5
|
+
* Extracted from `./feedback-promotion-service.ts` for the file-size cap, the way
|
|
6
|
+
* `./promotion-artifact-evidence.ts` was extracted before it. That module builds
|
|
7
|
+
* the decision from a file's text; this one decides whether the file is there to
|
|
8
|
+
* read. The service re-exports `missingArtifacts` from its own path, so no
|
|
9
|
+
* importer changed.
|
|
10
|
+
*/
|
|
11
|
+
import { type PromotionArtifactCheck } from './promotion-artifact-evidence.js';
|
|
12
|
+
/**
|
|
13
|
+
* Which of `checks` are not satisfied under `projectRoot`. Empty means the
|
|
14
|
+
* promotion is backed by its artifact. Never throws, and never permits: a file
|
|
15
|
+
* that is absent, unreadable, or unparseable is a finding, not a warning —
|
|
16
|
+
* "cannot read the evidence" must not read as "the evidence is good".
|
|
17
|
+
*
|
|
18
|
+
* A check is satisfied when `path` OR any of its `alternatives` carries the
|
|
19
|
+
* evidence; one that no candidate satisfies is reported ONCE, naming every
|
|
20
|
+
* location it looked in, so a reader is never told about half the search.
|
|
21
|
+
*/
|
|
22
|
+
export declare function missingArtifacts(checks: readonly PromotionArtifactCheck[], projectRoot: string): string[];
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The reader half of the promotion-artifact concern: which of a layer's required
|
|
3
|
+
* artifacts are NOT present, under a given project root.
|
|
4
|
+
*
|
|
5
|
+
* Extracted from `./feedback-promotion-service.ts` for the file-size cap, the way
|
|
6
|
+
* `./promotion-artifact-evidence.ts` was extracted before it. That module builds
|
|
7
|
+
* the decision from a file's text; this one decides whether the file is there to
|
|
8
|
+
* read. The service re-exports `missingArtifacts` from its own path, so no
|
|
9
|
+
* importer changed.
|
|
10
|
+
*/
|
|
11
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
12
|
+
import { resolve } from 'node:path';
|
|
13
|
+
import { artifactEvidenceFailure } from './promotion-artifact-evidence.js';
|
|
14
|
+
/**
|
|
15
|
+
* Which of `checks` are not satisfied under `projectRoot`. Empty means the
|
|
16
|
+
* promotion is backed by its artifact. Never throws, and never permits: a file
|
|
17
|
+
* that is absent, unreadable, or unparseable is a finding, not a warning —
|
|
18
|
+
* "cannot read the evidence" must not read as "the evidence is good".
|
|
19
|
+
*
|
|
20
|
+
* A check is satisfied when `path` OR any of its `alternatives` carries the
|
|
21
|
+
* evidence; one that no candidate satisfies is reported ONCE, naming every
|
|
22
|
+
* location it looked in, so a reader is never told about half the search.
|
|
23
|
+
*/
|
|
24
|
+
export function missingArtifacts(checks, projectRoot) {
|
|
25
|
+
const missing = [];
|
|
26
|
+
for (const check of checks) {
|
|
27
|
+
const failures = candidateFailures(check, projectRoot);
|
|
28
|
+
if (failures !== null)
|
|
29
|
+
missing.push(failures.join('; '));
|
|
30
|
+
}
|
|
31
|
+
return missing;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* One `${path} (${reason})` per location that does NOT back `check`, or `null`
|
|
35
|
+
* when one of them does. `null` and `[]` are different answers, which is why the
|
|
36
|
+
* caller gets the distinction rather than an empty array.
|
|
37
|
+
*
|
|
38
|
+
* `check.alternatives` exists because a layer may legitimately keep its one
|
|
39
|
+
* artifact in more than one place; the conjunction is across CHECKS, so an
|
|
40
|
+
* alternative location cannot be spelled as another check without demanding it.
|
|
41
|
+
*/
|
|
42
|
+
function candidateFailures(check, projectRoot) {
|
|
43
|
+
const failures = [];
|
|
44
|
+
for (const candidate of [check.path, ...(check.alternatives ?? [])]) {
|
|
45
|
+
const absolute = resolve(projectRoot, candidate);
|
|
46
|
+
if (!existsSync(absolute)) {
|
|
47
|
+
failures.push(`${candidate} (absent)`);
|
|
48
|
+
continue;
|
|
49
|
+
}
|
|
50
|
+
let text;
|
|
51
|
+
try {
|
|
52
|
+
text = readFileSync(absolute, 'utf8');
|
|
53
|
+
}
|
|
54
|
+
catch {
|
|
55
|
+
failures.push(`${candidate} (unreadable)`);
|
|
56
|
+
continue;
|
|
57
|
+
}
|
|
58
|
+
const failure = artifactEvidenceFailure(check, text);
|
|
59
|
+
if (failure !== null)
|
|
60
|
+
failures.push(`${candidate} (${failure})`);
|
|
61
|
+
}
|
|
62
|
+
return failures.length === 1 + (check.alternatives?.length ?? 0) ? failures : null;
|
|
63
|
+
}
|
|
@@ -1,12 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A completed model call's token accounting: the two counts an observability
|
|
3
|
+
* reader sums, plus a tag saying whether the provider reported them or the
|
|
4
|
+
* runner estimated them. `source` is optional so a runner that always has
|
|
5
|
+
* provider numbers — or a test fake — need not state it.
|
|
6
|
+
*/
|
|
7
|
+
export interface LlmTokenUsage {
|
|
8
|
+
readonly input: number;
|
|
9
|
+
readonly output: number;
|
|
10
|
+
readonly source?: 'provider' | 'estimated';
|
|
11
|
+
}
|
|
1
12
|
export interface LlmRunner {
|
|
2
13
|
call(systemPrompt: string, userPrompt: string, opts: {
|
|
3
14
|
maxTokens: number;
|
|
4
15
|
}): Promise<{
|
|
5
16
|
output: string;
|
|
6
|
-
tokens:
|
|
7
|
-
input: number;
|
|
8
|
-
output: number;
|
|
9
|
-
};
|
|
17
|
+
tokens: LlmTokenUsage;
|
|
10
18
|
}>;
|
|
11
19
|
}
|
|
12
20
|
export interface PrepareFinalReviewOptions {
|
|
@@ -19,8 +27,91 @@ export interface PrepareFinalReviewOptions {
|
|
|
19
27
|
* reports the dimension `unavailable` when it cannot.
|
|
20
28
|
*/
|
|
21
29
|
readonly baseRef?: string;
|
|
30
|
+
/**
|
|
31
|
+
* Called once per COMPLETED review, with the model call's token accounting,
|
|
32
|
+
* immediately before this function returns. The `token-usage` emission
|
|
33
|
+
* belongs in the caller (the CLI holds the session binding and owns the
|
|
34
|
+
* emit), so the service reports the numbers instead of writing observability
|
|
35
|
+
* itself. Optional: a caller that has nowhere to put them simply omits it.
|
|
36
|
+
*/
|
|
37
|
+
readonly onLlmTokens?: (tokens: LlmTokenUsage) => void;
|
|
22
38
|
}
|
|
23
39
|
export declare class IncompleteFinalReviewError extends Error {
|
|
24
40
|
readonly code: "INCOMPLETE_FINAL_REVIEW";
|
|
25
41
|
constructor(message: string);
|
|
26
42
|
}
|
|
43
|
+
/** Path segments (under `.peaks/_runtime/<sessionId>/`) the artifact lands at. */
|
|
44
|
+
export declare const API_DIFF_ARTIFACT_SEGMENTS: readonly ["final-review", "api-diff.txt"];
|
|
45
|
+
/**
|
|
46
|
+
* The literal that opens the artifact's conclusion line.
|
|
47
|
+
*
|
|
48
|
+
* Exported because the consumer must be able to test for the CONCLUSION, not
|
|
49
|
+
* for a byte count (F-BLOCK-1BYTE): one byte of `api-diff.txt` satisfied
|
|
50
|
+
* "status: found" while conveying nothing, and the delivery gate it fed then let
|
|
51
|
+
* a `pass` stand on a comparison nobody saw. The producer writes the line this
|
|
52
|
+
* marker opens and `final-review-service.ts` requires it in the delivered
|
|
53
|
+
* bytes, so the two cannot drift apart into the same hole again.
|
|
54
|
+
*/
|
|
55
|
+
export declare const PRE_POST_DIFF_VERDICT_MARKER = "VERDICT: ";
|
|
56
|
+
/**
|
|
57
|
+
* The three conclusions the artifact may open with, exported as the same
|
|
58
|
+
* literals the verdict writer interpolates.
|
|
59
|
+
*
|
|
60
|
+
* They are constants because reading the conclusion is now part of the
|
|
61
|
+
* consumer's job (F2): the pre/post-diff source is the one source whose
|
|
62
|
+
* conclusion had a machine-readable form all along, and the envelope threw it
|
|
63
|
+
* away — a delivered `STRUCTURAL DRIFT DETECTED` produced `allPass: true` with
|
|
64
|
+
* an empty `needsAttention`. A consumer that must classify the conclusion may
|
|
65
|
+
* only do so against the producer's own literals, never against a re-typed
|
|
66
|
+
* copy of them.
|
|
67
|
+
*/
|
|
68
|
+
export declare const PRE_POST_DIFF_NO_DRIFT = "NO STRUCTURAL DRIFT";
|
|
69
|
+
export declare const PRE_POST_DIFF_ADDITIONS_ONLY = "ADDITIONS ONLY";
|
|
70
|
+
export declare const PRE_POST_DIFF_DRIFT_DETECTED = "STRUCTURAL DRIFT DETECTED";
|
|
71
|
+
/**
|
|
72
|
+
* What the artifact's conclusion LINE says, read from the bytes a consumer
|
|
73
|
+
* actually received.
|
|
74
|
+
*
|
|
75
|
+
* `indeterminate` is not "nothing to report": it is "the line is there (or is
|
|
76
|
+
* not) and this consumer cannot classify it", which for a drift DETECTOR is a
|
|
77
|
+
* fact a human has to see — see `enforceStructuralDriftAttention`.
|
|
78
|
+
*/
|
|
79
|
+
export type PrePostDiffConclusion = 'no-drift' | 'additions-only' | 'drift-detected' | 'indeterminate';
|
|
80
|
+
/**
|
|
81
|
+
* Classify the delivered conclusion. Pure and total: a caller passes the bytes
|
|
82
|
+
* it received (possibly a head slice) and gets back what the artifact says.
|
|
83
|
+
*
|
|
84
|
+
* Only the FIRST `VERDICT:` line is read. The artifact's header promises the
|
|
85
|
+
* verdict "is repeated nowhere" and that it is the file's conclusion, so a
|
|
86
|
+
* later line cannot be the answer, and reading further would let a document's
|
|
87
|
+
* prose masquerade as its conclusion.
|
|
88
|
+
*/
|
|
89
|
+
export declare function classifyPrePostDiffVerdict(content: string): PrePostDiffConclusion;
|
|
90
|
+
export interface PrePostDiffComputed {
|
|
91
|
+
readonly status: 'computed';
|
|
92
|
+
readonly summary: string;
|
|
93
|
+
readonly relativePath: string;
|
|
94
|
+
readonly absolutePath: string;
|
|
95
|
+
readonly content: string;
|
|
96
|
+
}
|
|
97
|
+
export interface PrePostDiffUnavailable {
|
|
98
|
+
readonly status: 'unavailable';
|
|
99
|
+
/** Why no baseline exists, in the operator's terms. */
|
|
100
|
+
readonly reason: string;
|
|
101
|
+
/**
|
|
102
|
+
* `true` when the project root IS a git work tree — i.e. a baseline was
|
|
103
|
+
* expected to be computable and was not. That distinction shapes the REASON
|
|
104
|
+
* the operator is given (a tooling failure to fix, versus a project that has
|
|
105
|
+
* no baseline to offer), and the service refuses a `pass` on this dimension
|
|
106
|
+
* either way: "not a git repository" is the CAUSE of the missing evidence,
|
|
107
|
+
* never a licence to trust the claim the evidence was supposed to support.
|
|
108
|
+
*/
|
|
109
|
+
readonly inGitWorkTree: boolean;
|
|
110
|
+
}
|
|
111
|
+
export type PrePostDiffResult = PrePostDiffComputed | PrePostDiffUnavailable;
|
|
112
|
+
export interface ProducePrePostDiffOptions {
|
|
113
|
+
readonly projectRoot: string;
|
|
114
|
+
readonly sessionId: string;
|
|
115
|
+
/** Explicit base ref. Unset ⇒ merge-base with the upstream default branch. */
|
|
116
|
+
readonly baseRef?: string;
|
|
117
|
+
}
|
|
@@ -5,6 +5,12 @@
|
|
|
5
5
|
// Hoisted verbatim from final-review-service.ts (C wave 7 file-size
|
|
6
6
|
// split); the service module re-exports all three so no importer's path
|
|
7
7
|
// or symbol changed.
|
|
8
|
+
//
|
|
9
|
+
// It also carries the pre/post-diff producer's contract with its consumers:
|
|
10
|
+
// where its artifact lands, what its conclusion line says, the shapes it
|
|
11
|
+
// returns and the reader for that conclusion line. Moved here by the file-size
|
|
12
|
+
// split that took `pre-post-diff.ts` back under the cap; `pre-post-diff.ts`
|
|
13
|
+
// re-exports every name, so no importer's path or symbol changed either.
|
|
8
14
|
export class IncompleteFinalReviewError extends Error {
|
|
9
15
|
code = 'INCOMPLETE_FINAL_REVIEW';
|
|
10
16
|
constructor(message) {
|
|
@@ -12,3 +18,61 @@ export class IncompleteFinalReviewError extends Error {
|
|
|
12
18
|
this.name = 'IncompleteFinalReviewError';
|
|
13
19
|
}
|
|
14
20
|
}
|
|
21
|
+
/* ------------------------------------------------------------------ *
|
|
22
|
+
* The pre/post-diff producer's contract, in full: its artifact, the
|
|
23
|
+
* conclusion that artifact opens with, the shapes it returns, and the
|
|
24
|
+
* reader for that conclusion. Hoisted verbatim from pre-post-diff.ts
|
|
25
|
+
* (file-size split); pre-post-diff.ts re-exports every name.
|
|
26
|
+
* ------------------------------------------------------------------ */
|
|
27
|
+
/** Path segments (under `.peaks/_runtime/<sessionId>/`) the artifact lands at. */
|
|
28
|
+
export const API_DIFF_ARTIFACT_SEGMENTS = ['final-review', 'api-diff.txt'];
|
|
29
|
+
/**
|
|
30
|
+
* The literal that opens the artifact's conclusion line.
|
|
31
|
+
*
|
|
32
|
+
* Exported because the consumer must be able to test for the CONCLUSION, not
|
|
33
|
+
* for a byte count (F-BLOCK-1BYTE): one byte of `api-diff.txt` satisfied
|
|
34
|
+
* "status: found" while conveying nothing, and the delivery gate it fed then let
|
|
35
|
+
* a `pass` stand on a comparison nobody saw. The producer writes the line this
|
|
36
|
+
* marker opens and `final-review-service.ts` requires it in the delivered
|
|
37
|
+
* bytes, so the two cannot drift apart into the same hole again.
|
|
38
|
+
*/
|
|
39
|
+
export const PRE_POST_DIFF_VERDICT_MARKER = 'VERDICT: ';
|
|
40
|
+
/**
|
|
41
|
+
* The three conclusions the artifact may open with, exported as the same
|
|
42
|
+
* literals the verdict writer interpolates.
|
|
43
|
+
*
|
|
44
|
+
* They are constants because reading the conclusion is now part of the
|
|
45
|
+
* consumer's job (F2): the pre/post-diff source is the one source whose
|
|
46
|
+
* conclusion had a machine-readable form all along, and the envelope threw it
|
|
47
|
+
* away — a delivered `STRUCTURAL DRIFT DETECTED` produced `allPass: true` with
|
|
48
|
+
* an empty `needsAttention`. A consumer that must classify the conclusion may
|
|
49
|
+
* only do so against the producer's own literals, never against a re-typed
|
|
50
|
+
* copy of them.
|
|
51
|
+
*/
|
|
52
|
+
export const PRE_POST_DIFF_NO_DRIFT = 'NO STRUCTURAL DRIFT';
|
|
53
|
+
export const PRE_POST_DIFF_ADDITIONS_ONLY = 'ADDITIONS ONLY';
|
|
54
|
+
export const PRE_POST_DIFF_DRIFT_DETECTED = 'STRUCTURAL DRIFT DETECTED';
|
|
55
|
+
/**
|
|
56
|
+
* Classify the delivered conclusion. Pure and total: a caller passes the bytes
|
|
57
|
+
* it received (possibly a head slice) and gets back what the artifact says.
|
|
58
|
+
*
|
|
59
|
+
* Only the FIRST `VERDICT:` line is read. The artifact's header promises the
|
|
60
|
+
* verdict "is repeated nowhere" and that it is the file's conclusion, so a
|
|
61
|
+
* later line cannot be the answer, and reading further would let a document's
|
|
62
|
+
* prose masquerade as its conclusion.
|
|
63
|
+
*/
|
|
64
|
+
export function classifyPrePostDiffVerdict(content) {
|
|
65
|
+
const line = content
|
|
66
|
+
.split(/\r?\n/)
|
|
67
|
+
.find((candidate) => candidate.startsWith(PRE_POST_DIFF_VERDICT_MARKER));
|
|
68
|
+
if (line === undefined)
|
|
69
|
+
return 'indeterminate';
|
|
70
|
+
const conclusion = line.slice(PRE_POST_DIFF_VERDICT_MARKER.length);
|
|
71
|
+
if (conclusion.startsWith(PRE_POST_DIFF_DRIFT_DETECTED))
|
|
72
|
+
return 'drift-detected';
|
|
73
|
+
if (conclusion.startsWith(PRE_POST_DIFF_ADDITIONS_ONLY))
|
|
74
|
+
return 'additions-only';
|
|
75
|
+
if (conclusion.startsWith(PRE_POST_DIFF_NO_DRIFT))
|
|
76
|
+
return 'no-drift';
|
|
77
|
+
return 'indeterminate';
|
|
78
|
+
}
|
|
@@ -6,10 +6,23 @@ import type { DimensionEvidence, DimensionKind } from './final-review-types.js';
|
|
|
6
6
|
*/
|
|
7
7
|
export interface UndeliverableDimensionEvidence {
|
|
8
8
|
readonly dimension: DimensionKind;
|
|
9
|
+
/**
|
|
10
|
+
* Did the reviewer receive a bounded EXCERPT of at least one of these sources?
|
|
11
|
+
*
|
|
12
|
+
* Measured 2026-10-13 on the all-oversized set this report was written for
|
|
13
|
+
* (`qa-test-report` 19,256 B, `qa/test-cases` 42,335 B, `prd-handoff` 28,414 B
|
|
14
|
+
* against a 10,240 cap): the allocator inlined 30,720 bytes — a cap-sized head
|
|
15
|
+
* of each — into the prompt. So "no source can ever be delivered" was true
|
|
16
|
+
* only of WHOLE delivery, and the report read as if the reviewer had been
|
|
17
|
+
* shown nothing. This flag is which of those two facts it is.
|
|
18
|
+
*/
|
|
19
|
+
readonly excerptDelivered: boolean;
|
|
9
20
|
readonly sources: readonly {
|
|
10
21
|
readonly key: string;
|
|
11
22
|
readonly relativePath: string;
|
|
12
23
|
readonly totalBytes: number;
|
|
24
|
+
/** Bytes of this source inlined as an excerpt (0 when none was inlined). */
|
|
25
|
+
readonly excerptBytes: number;
|
|
13
26
|
}[];
|
|
14
27
|
}
|
|
15
28
|
/**
|
|
@@ -8,13 +8,15 @@
|
|
|
8
8
|
import { isDelivered } from './final-review-service.js';
|
|
9
9
|
import { MAX_EVIDENCE_BYTES_PER_FILE, REQUIRED_DIMENSIONS } from './final-review-evidence-budget.js';
|
|
10
10
|
/**
|
|
11
|
-
* Can this source EVER be delivered, whatever the budget?
|
|
11
|
+
* Can this source EVER be delivered WHOLE, whatever the budget?
|
|
12
12
|
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
13
|
+
* The whole qualifier is the fact: an over-cap source IS delivered, as a
|
|
14
|
+
* bounded excerpt (see `CollectedEvidence.excerpt`). What it can never be is
|
|
15
|
+
* delivered WHOLE, and `whole` is the only rule with a structural ceiling. Its
|
|
16
|
+
* test is `includedBytes === totalBytes`, and the allocator can only ever inline
|
|
15
17
|
* `min(bytes, MAX_EVIDENCE_BYTES_PER_FILE)` — so a `whole`-rule source LARGER
|
|
16
|
-
* than the per-file cap
|
|
17
|
-
*
|
|
18
|
+
* than the per-file cap is never whole: not on this run, not on any run, not
|
|
19
|
+
* with any budget, because the budget is not what cuts it. Raising
|
|
18
20
|
* `MAX_EVIDENCE_BYTES_TOTAL` changes nothing either, since the per-file cap is
|
|
19
21
|
* derived from it and the reservation spends all of it.
|
|
20
22
|
*
|
|
@@ -74,13 +76,16 @@ export function undeliverableDimensions(collected) {
|
|
|
74
76
|
continue;
|
|
75
77
|
if (!onDisk.every(isStructurallyUndeliverable))
|
|
76
78
|
continue;
|
|
79
|
+
const sources = onDisk.map((item) => ({
|
|
80
|
+
key: item.source.key,
|
|
81
|
+
relativePath: item.relativePath,
|
|
82
|
+
totalBytes: item.totalBytes,
|
|
83
|
+
excerptBytes: item.excerpt ? item.includedBytes : 0
|
|
84
|
+
}));
|
|
77
85
|
report.push({
|
|
78
86
|
dimension,
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
relativePath: item.relativePath,
|
|
82
|
-
totalBytes: item.totalBytes
|
|
83
|
-
}))
|
|
87
|
+
excerptDelivered: sources.some((item) => item.excerptBytes > 0),
|
|
88
|
+
sources
|
|
84
89
|
});
|
|
85
90
|
}
|
|
86
91
|
return report;
|
|
@@ -108,11 +113,20 @@ export function enforceDeliveryReachability(dimensions, report) {
|
|
|
108
113
|
// The ENVELOPE is not byte-capped, so it names the path as well as the
|
|
109
114
|
// size: the path is what a human has to act on to fix it.
|
|
110
115
|
const detail = entry.sources
|
|
111
|
-
.map((item) => `${item.key} at ${item.relativePath} (${String(item.totalBytes)} bytes
|
|
116
|
+
.map((item) => `${item.key} at ${item.relativePath} (${String(item.totalBytes)} bytes, ${item.excerptBytes > 0
|
|
117
|
+
? `${String(item.excerptBytes)} inlined as an excerpt, ${String(item.totalBytes - item.excerptBytes)} withheld`
|
|
118
|
+
: 'none inlined'})`)
|
|
112
119
|
.join(', ');
|
|
120
|
+
// The consequence is measured, not assumed. Saying "no evidence can ever
|
|
121
|
+
// reach the reviewer" while a cap-sized head of every one of these sources
|
|
122
|
+
// sits in the prompt is a claim stronger than the code — the defect class
|
|
123
|
+
// this module keeps closing.
|
|
124
|
+
const consequence = entry.excerptDelivered
|
|
125
|
+
? 'a bounded EXCERPT of each was inlined, so the reviewer HAS partial evidence for this dimension — but no source for it can be delivered WHOLE, and a head of a file is not the document: the conclusion may be in the part that was cut'
|
|
126
|
+
: 'none of them was inlined, so no evidence for this dimension reached the reviewer at all';
|
|
113
127
|
const marker = `[delivery-reachability: ${dimension.verdict === 'pass'
|
|
114
128
|
? 'verdict downgraded from "pass" to "inconclusive"'
|
|
115
|
-
: `gate ran; verdict "${dimension.verdict}" is already non-"pass" and is left unchanged`} — EVERY source on disk that supports "${dimension.dimension}" (${detail}) is larger than the per-file delivery cap of ${String(MAX_EVIDENCE_BYTES_PER_FILE)} bytes, and a source is inlined WHOLE or not at all
|
|
129
|
+
: `gate ran; verdict "${dimension.verdict}" is already non-"pass" and is left unchanged`} — EVERY source on disk that supports "${dimension.dimension}" (${detail}) is larger than the per-file delivery cap of ${String(MAX_EVIDENCE_BYTES_PER_FILE)} bytes, and a source is inlined WHOLE or not at all; ${consequence}. The dimension is red by byte arithmetic, not by the reviewer's judgement, and it is listed in needsAttention for that reason.]`;
|
|
116
130
|
const annotated = {
|
|
117
131
|
...dimension,
|
|
118
132
|
summary: `${dimension.summary} ${marker}`
|
|
@@ -4,9 +4,15 @@
|
|
|
4
4
|
// budget allocator, hoisted from final-review-service.ts (C wave 7).
|
|
5
5
|
// evidenceSourcesFor stays in the service module (guard C pins it there)
|
|
6
6
|
// and is imported from it — a one-directional edge.
|
|
7
|
+
//
|
|
8
|
+
// The `CollectedEvidence` record builders moved to
|
|
9
|
+
// final-review-evidence-records.ts on 2026-10-13, when this file reached 298 of
|
|
10
|
+
// its 300-line cap. What stays here is the read phase, the floor reservation,
|
|
11
|
+
// the allocator and the two byte helpers — collect → records, one way.
|
|
7
12
|
import { readFileSync } from 'node:fs';
|
|
8
13
|
import { join } from 'node:path';
|
|
9
14
|
import { GATE_SOURCE_FOR_DIMENSION } from './final-review-evidence-sources.js';
|
|
15
|
+
import { blankEvidence, foundEvidence, omittedEvidence, readFailureEvidence } from './final-review-evidence-records.js';
|
|
10
16
|
import { MAX_EVIDENCE_BYTES_TOTAL, REQUIRED_DIMENSIONS, assertFloorReservationAffordable, sourceUnit } from './final-review-evidence-budget.js';
|
|
11
17
|
import { evidenceSourcesFor } from './final-review-service.js';
|
|
12
18
|
/**
|
|
@@ -27,7 +33,8 @@ export function readEvidence(projectRoot, sessionId, rid, prePostDiffAvailable)
|
|
|
27
33
|
// copy would silently swap the evidence this run reports.
|
|
28
34
|
const attempts = [
|
|
29
35
|
source.segments,
|
|
30
|
-
...(source.legacySegments !== undefined ? [source.legacySegments] : [])
|
|
36
|
+
...(source.legacySegments !== undefined ? [source.legacySegments] : []),
|
|
37
|
+
...(source.olderSegments ?? [])
|
|
31
38
|
];
|
|
32
39
|
// The path reported when nothing resolved stays the CANONICAL one, so the
|
|
33
40
|
// operator is sent to where the artifact belongs, not to its old home.
|
|
@@ -120,63 +127,11 @@ function floorHolders(candidates) {
|
|
|
120
127
|
});
|
|
121
128
|
return holders;
|
|
122
129
|
}
|
|
123
|
-
function readFailureEvidence(base, candidate) {
|
|
124
|
-
// `read` is never `'ok'` here (it is set exactly when the read failed),
|
|
125
|
-
// and `'ok'` is not a status — the branch is what says which of the two
|
|
126
|
-
// failure facts this is.
|
|
127
|
-
const status = candidate.read === 'unreadable' ? 'unreadable' : 'missing';
|
|
128
|
-
return {
|
|
129
|
-
...base,
|
|
130
|
-
status,
|
|
131
|
-
totalBytes: 0,
|
|
132
|
-
includedBytes: 0,
|
|
133
|
-
content: '',
|
|
134
|
-
reason: candidate.read === 'missing'
|
|
135
|
-
? candidate.error
|
|
136
|
-
: `the file exists but could not be read (${candidate.error})`
|
|
137
|
-
};
|
|
138
|
-
}
|
|
139
|
-
function blankEvidence(base, raw) {
|
|
140
|
-
return {
|
|
141
|
-
...base,
|
|
142
|
-
status: 'empty',
|
|
143
|
-
totalBytes: raw.byteLength,
|
|
144
|
-
includedBytes: 0,
|
|
145
|
-
content: '',
|
|
146
|
-
reason: `file exists but contains no reviewable content (${raw.byteLength} bytes)`
|
|
147
|
-
};
|
|
148
|
-
}
|
|
149
|
-
function omittedEvidence(base, raw, ctx) {
|
|
150
|
-
const { allowance, budgetLeft, candidates, holders, pending, reservedElsewhere, unit, index } = ctx;
|
|
151
|
-
const waiting = [...pending]
|
|
152
|
-
.filter((holder) => holder !== index)
|
|
153
|
-
.map((holder) => `${holders.get(holder)} (source ${candidates[holder]?.source.key ?? '?'})`);
|
|
154
|
-
return {
|
|
155
|
-
...base,
|
|
156
|
-
status: 'omitted',
|
|
157
|
-
totalBytes: raw.byteLength,
|
|
158
|
-
includedBytes: 0,
|
|
159
|
-
content: '',
|
|
160
|
-
reason: reservedElsewhere > 0
|
|
161
|
-
? `${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)`
|
|
162
|
-
: `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`
|
|
163
|
-
};
|
|
164
|
-
}
|
|
165
130
|
function reservedForPending(pending, units, index) {
|
|
166
131
|
return [...pending]
|
|
167
132
|
.filter((holder) => holder !== index)
|
|
168
133
|
.reduce((sum, holder) => sum + (units[holder] ?? 0), 0);
|
|
169
134
|
}
|
|
170
|
-
function foundEvidence(base, raw, unit, content) {
|
|
171
|
-
return {
|
|
172
|
-
...base,
|
|
173
|
-
status: 'found',
|
|
174
|
-
totalBytes: raw.byteLength,
|
|
175
|
-
includedBytes: unit,
|
|
176
|
-
content,
|
|
177
|
-
reason: ''
|
|
178
|
-
};
|
|
179
|
-
}
|
|
180
135
|
export function collectEvidence(projectRoot, sessionId, rid, prePostDiffAvailable) {
|
|
181
136
|
assertFloorReservationAffordable();
|
|
182
137
|
const candidates = readEvidence(projectRoot, sessionId, rid, prePostDiffAvailable);
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { CollectedEvidence, EvidenceCandidate, EvidenceSource } from './final-review-evidence-sources.js';
|
|
2
|
+
import type { DimensionKind } from './final-review-types.js';
|
|
3
|
+
export interface EvidenceBase {
|
|
4
|
+
readonly source: EvidenceSource;
|
|
5
|
+
readonly relativePath: string;
|
|
6
|
+
readonly absolutePath: string;
|
|
7
|
+
}
|
|
8
|
+
export declare function readFailureEvidence(base: EvidenceBase, candidate: EvidenceCandidate): CollectedEvidence;
|
|
9
|
+
export declare function blankEvidence(base: EvidenceBase, raw: Buffer): CollectedEvidence;
|
|
10
|
+
export interface OmissionContext {
|
|
11
|
+
readonly budgetLeft: number;
|
|
12
|
+
readonly allowance: number;
|
|
13
|
+
readonly holders: ReadonlyMap<number, DimensionKind>;
|
|
14
|
+
readonly pending: Set<number>;
|
|
15
|
+
readonly reservedElsewhere: number;
|
|
16
|
+
readonly unit: number;
|
|
17
|
+
readonly candidates: readonly EvidenceCandidate[];
|
|
18
|
+
readonly index: number;
|
|
19
|
+
}
|
|
20
|
+
export declare function omittedEvidence(base: EvidenceBase, raw: Buffer, ctx: OmissionContext): CollectedEvidence;
|
|
21
|
+
export declare function foundEvidence(base: EvidenceBase, raw: Buffer, unit: number, content: string): CollectedEvidence;
|