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,113 @@
|
|
|
1
|
+
// src/services/race/lane-phase.ts
|
|
2
|
+
//
|
|
3
|
+
// THE ONLY READER of the race lane's phase. `.peaks/race/lane-phase.json` holds one
|
|
4
|
+
// object with one key, `phase`, whose value is one of two tokens.
|
|
5
|
+
//
|
|
6
|
+
// WHY THE PHASE IS A FILE WITH A GRAMMAR. Written as a sentence in a markdown file it
|
|
7
|
+
// had no grammar, so a guard could only recognise the declaration by a spelling
|
|
8
|
+
// pattern, and every spelling a reader would accept while the pattern missed it was
|
|
9
|
+
// invisible to the guard. The reader cannot miss one: a value outside the enum, a second
|
|
10
|
+
// key, a duplicate key (plain or spelled with an escape), or a missing file is a refusal
|
|
11
|
+
// rather than something silently carried.
|
|
12
|
+
//
|
|
13
|
+
// A MISSING FILE IS A REFUSAL, NOT A DEFAULT. "Exactly one legal value" is a parser
|
|
14
|
+
// guarantee, so absence must not resolve to one.
|
|
15
|
+
import { lstatSync, readFileSync } from 'node:fs';
|
|
16
|
+
import { join } from 'node:path';
|
|
17
|
+
import { z } from 'zod';
|
|
18
|
+
export const LANE_PHASE_VALUES = ['name-only', 'offered-by-default'];
|
|
19
|
+
/**
|
|
20
|
+
* The enum makes a value outside the two legal tokens unrepresentable, and `strict()`
|
|
21
|
+
* refuses an unknown key. `strict()` alone still lets `__proto__` through — it is an own,
|
|
22
|
+
* enumerable key that zod does not treat as unknown — so `readLanePhase` also requires the
|
|
23
|
+
* parsed object's own keys to be exactly `['phase']`. Together, an unknown key is a
|
|
24
|
+
* rejection rather than a key silently carried.
|
|
25
|
+
*/
|
|
26
|
+
const lanePhaseFileSchema = z.object({ phase: z.enum(LANE_PHASE_VALUES) }).strict();
|
|
27
|
+
export function lanePhasePath(projectRoot) {
|
|
28
|
+
return join(projectRoot, '.peaks', 'race', 'lane-phase.json');
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Inspect the path and read the file. `lstat` (not `stat`) so a symlink is seen as the link
|
|
32
|
+
* rather than followed; `throwIfNoEntry: false` makes absence a value rather than a throw; and the
|
|
33
|
+
* `catch` keeps the reader's contract — a tagged result, never an exception — for a path it cannot
|
|
34
|
+
* inspect at all (a NUL byte, say, where a bare `existsSync` returned `false`). `JSON.parse`'s own
|
|
35
|
+
* message quotes the bytes it choked on, so a parse failure is reported without the file's content.
|
|
36
|
+
*/
|
|
37
|
+
function readCarrier(path) {
|
|
38
|
+
let stat;
|
|
39
|
+
try {
|
|
40
|
+
stat = lstatSync(path, { throwIfNoEntry: false });
|
|
41
|
+
}
|
|
42
|
+
catch {
|
|
43
|
+
return { kind: 'invalid', message: 'the carrier path could not be inspected' };
|
|
44
|
+
}
|
|
45
|
+
if (stat === undefined)
|
|
46
|
+
return { kind: 'missing' };
|
|
47
|
+
if (!stat.isFile())
|
|
48
|
+
return { kind: 'invalid', message: 'the carrier path is not a regular file' };
|
|
49
|
+
let text;
|
|
50
|
+
let raw;
|
|
51
|
+
try {
|
|
52
|
+
text = readFileSync(path, 'utf8');
|
|
53
|
+
raw = JSON.parse(text);
|
|
54
|
+
}
|
|
55
|
+
catch {
|
|
56
|
+
return { kind: 'invalid', message: 'the file is not valid JSON' };
|
|
57
|
+
}
|
|
58
|
+
return { kind: 'ok', text, raw };
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* The raw-text refusal, or `null` when the text declares `"phase"` exactly once. No file this
|
|
62
|
+
* project writes needs a backslash: the only key is `phase` and the only values are `name-only`
|
|
63
|
+
* and `offered-by-default`, none of which needs an escape. Refusing one outright is broader than
|
|
64
|
+
* JSON's grammar — it also refuses a file that escapes a letter of the key, which decodes to a
|
|
65
|
+
* legal value — but the wider refusal errs in the safe direction, and it means the key cannot be
|
|
66
|
+
* written as an escape that `JSON.parse` reads as the property `phase` while a count of the
|
|
67
|
+
* literal text misses it. With no escape, the count sees every declaration, so a repeated key that
|
|
68
|
+
* `JSON.parse` would resolve by keeping the LAST is refused instead.
|
|
69
|
+
*/
|
|
70
|
+
function duplicateDeclarationMessage(text) {
|
|
71
|
+
if (text.includes('\\')) {
|
|
72
|
+
return 'the file contains a backslash; write the key plainly as "phase" — an escaped key would hide a second declaration';
|
|
73
|
+
}
|
|
74
|
+
if ((text.match(/"phase"\s*:/g) ?? []).length > 1) {
|
|
75
|
+
return 'the file declares "phase" more than once; exactly one declaration is legal';
|
|
76
|
+
}
|
|
77
|
+
return null;
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* The own-key refusal, or `null` when the parsed object carries only `phase`. `strict()` refuses an
|
|
81
|
+
* unknown key except `__proto__`; this check closes that hole, so nothing is carried beside it.
|
|
82
|
+
*/
|
|
83
|
+
function carriedKeyMessage(raw) {
|
|
84
|
+
if (raw === null || typeof raw !== 'object')
|
|
85
|
+
return null;
|
|
86
|
+
const keys = Object.keys(raw);
|
|
87
|
+
if (keys.length === 1 && keys[0] === 'phase')
|
|
88
|
+
return null;
|
|
89
|
+
return 'the file must hold exactly one key, "phase"';
|
|
90
|
+
}
|
|
91
|
+
export function readLanePhase(projectRoot) {
|
|
92
|
+
const path = lanePhasePath(projectRoot);
|
|
93
|
+
const carrier = readCarrier(path);
|
|
94
|
+
if (carrier.kind === 'missing')
|
|
95
|
+
return { kind: 'missing', path };
|
|
96
|
+
if (carrier.kind === 'invalid')
|
|
97
|
+
return { kind: 'invalid', path, message: carrier.message };
|
|
98
|
+
const duplicate = duplicateDeclarationMessage(carrier.text);
|
|
99
|
+
if (duplicate !== null)
|
|
100
|
+
return { kind: 'invalid', path, message: duplicate };
|
|
101
|
+
const carried = carriedKeyMessage(carrier.raw);
|
|
102
|
+
if (carried !== null)
|
|
103
|
+
return { kind: 'invalid', path, message: carried };
|
|
104
|
+
const parsed = lanePhaseFileSchema.safeParse(carrier.raw);
|
|
105
|
+
if (!parsed.success)
|
|
106
|
+
return { kind: 'invalid', path, message: describeIssues(parsed.error) };
|
|
107
|
+
return { kind: 'ok', path, file: parsed.data };
|
|
108
|
+
}
|
|
109
|
+
function describeIssues(error) {
|
|
110
|
+
return error.issues
|
|
111
|
+
.map((issue) => `${issue.path.join('.') || '<root>'}: ${issue.message}`)
|
|
112
|
+
.join('; ');
|
|
113
|
+
}
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import { type PilotGateEvaluation, type PilotTaskRow } from './gate2-evaluator.js';
|
|
2
|
+
/** `fast-lane-norm.md` §2 numbers the risk surfaces 1..7; a value outside that is a typo, not a row. */
|
|
3
|
+
export declare const RISK_SURFACE_MAX = 7;
|
|
4
|
+
/**
|
|
5
|
+
* The file's own note, written by the writer so the artifact cannot be produced
|
|
6
|
+
* without it. Two claims it must carry, per PRD §4 and §5.3: what the evidence
|
|
7
|
+
* does NOT prove, and which of the two policy blocks is authoritative.
|
|
8
|
+
*/
|
|
9
|
+
export declare const PILOT_GATE_NOTE: string;
|
|
10
|
+
export declare const LANE_CHOSEN_BY_VALUES: readonly ["user-named", "user-picked"];
|
|
11
|
+
export declare const OUTCOME_VALUES: readonly ["landed", "escalated", "stopped"];
|
|
12
|
+
export declare const HANDLING_VALUES: readonly ["refused", "escalated", "user-override-recorded", "none"];
|
|
13
|
+
export type PilotGateFile = {
|
|
14
|
+
readonly policyVersion?: string | undefined;
|
|
15
|
+
readonly tasks: readonly PilotTaskRow[];
|
|
16
|
+
};
|
|
17
|
+
export type ReadPilotGateResult = {
|
|
18
|
+
readonly kind: 'ok';
|
|
19
|
+
readonly path: string;
|
|
20
|
+
readonly gate: PilotGateFile;
|
|
21
|
+
} | {
|
|
22
|
+
readonly kind: 'missing';
|
|
23
|
+
readonly path: string;
|
|
24
|
+
} | {
|
|
25
|
+
readonly kind: 'invalid';
|
|
26
|
+
readonly path: string;
|
|
27
|
+
readonly message: string;
|
|
28
|
+
};
|
|
29
|
+
export type PilotTaskInput = {
|
|
30
|
+
readonly rid: string;
|
|
31
|
+
readonly sessionId: string;
|
|
32
|
+
readonly date: string;
|
|
33
|
+
readonly laneChosenBy: string;
|
|
34
|
+
readonly outcome: string;
|
|
35
|
+
readonly filesChanged: readonly string[];
|
|
36
|
+
readonly riskSurfacesHit: readonly number[];
|
|
37
|
+
readonly riskSurfaceHandling: string;
|
|
38
|
+
readonly rolledBack: boolean;
|
|
39
|
+
readonly ciRed: boolean;
|
|
40
|
+
readonly missedRiskSurface: boolean;
|
|
41
|
+
};
|
|
42
|
+
export declare function pilotGatePath(projectRoot: string): string;
|
|
43
|
+
export declare function readPilotGate(projectRoot: string): ReadPilotGateResult;
|
|
44
|
+
/**
|
|
45
|
+
* Validate one row, fail-closed, each refusal naming the rule it broke. Nothing
|
|
46
|
+
* is written when this returns `invalid`.
|
|
47
|
+
*/
|
|
48
|
+
export declare function buildPilotTaskRow(input: PilotTaskInput): {
|
|
49
|
+
readonly kind: 'ok';
|
|
50
|
+
readonly row: PilotTaskRow;
|
|
51
|
+
} | {
|
|
52
|
+
readonly kind: 'invalid';
|
|
53
|
+
readonly message: string;
|
|
54
|
+
};
|
|
55
|
+
/**
|
|
56
|
+
* Idempotent upsert of one row, keyed by `--rid`: a repeated rid replaces that
|
|
57
|
+
* row in place (first-seen order preserved), a new rid is appended. The writer is
|
|
58
|
+
* also the only thing that can refresh `lastEvaluation` — the reader owns no file
|
|
59
|
+
* — which is what keeps the committed evaluation from going stale.
|
|
60
|
+
*
|
|
61
|
+
* Throws when the existing file cannot be read: clobbering unreadable evidence
|
|
62
|
+
* with a fresh one-row file would silently destroy rows.
|
|
63
|
+
*/
|
|
64
|
+
export declare function upsertPilotTask(projectRoot: string, row: PilotTaskRow, now?: Date): {
|
|
65
|
+
readonly path: string;
|
|
66
|
+
readonly evaluation: PilotGateEvaluation;
|
|
67
|
+
};
|
|
@@ -0,0 +1,227 @@
|
|
|
1
|
+
// src/services/race/pilot-gate-store.ts
|
|
2
|
+
//
|
|
3
|
+
// THE ONLY I/O MODULE of the race-lane gate-2 evidence. `gate2-evaluator.ts`
|
|
4
|
+
// judges; this file reads and writes, and nothing else may.
|
|
5
|
+
//
|
|
6
|
+
// WHY THE EVIDENCE IS TRACKED. Gate 2 gates a switch of `skills/peaks-audit/SKILL.md`
|
|
7
|
+
// to "offered by default" — a tracked change, which must be judged on tracked
|
|
8
|
+
// evidence. If `pilot-gate.json` lived under `.peaks/_runtime/` it would be
|
|
9
|
+
// gitignored, the guard would read nothing on a clean CI clone, and "did the gate
|
|
10
|
+
// pass?" would remain a local fact rather than a repository fact.
|
|
11
|
+
//
|
|
12
|
+
// WHAT THIS FILE DOES NOT PROVE. The per-task prose traces stay gitignored
|
|
13
|
+
// (`.peaks/_runtime/<sessionId>/race/<rid>.md`), so the rows here were extracted
|
|
14
|
+
// from them and committed. Nothing in this repository can prove those rows came
|
|
15
|
+
// from tasks that were really run; the guard can only prove the rows, the counts,
|
|
16
|
+
// the verdict and the SKILL.md marker are mutually consistent.
|
|
17
|
+
//
|
|
18
|
+
// THE POLICY BLOCK IN THE FILE IS A RECORD, NOT THE AUTHORITY. The thresholds a
|
|
19
|
+
// verdict is computed from are `RACE_GATE2_POLICY_V1` in `gate2-policy.ts`. Were
|
|
20
|
+
// the file's own block the computational source, weakening it in a commit would
|
|
21
|
+
// launder the gate it exists to hold. The writer copies the constant into the
|
|
22
|
+
// block verbatim, and a reader can compare `recordedPolicyVersion` against the
|
|
23
|
+
// policy it was judged under.
|
|
24
|
+
import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
|
|
25
|
+
import { dirname, join } from 'node:path';
|
|
26
|
+
import { CLI_VERSION } from 'peaks-loop-shared/version';
|
|
27
|
+
import { z } from 'zod';
|
|
28
|
+
import { isUnsafePathInput } from '../../shared/path-safety.js';
|
|
29
|
+
import { REQUEST_ID_PATTERN } from '../artifacts/request-artifact-service.js';
|
|
30
|
+
import { evaluatePilotGate } from './gate2-evaluator.js';
|
|
31
|
+
import { RACE_GATE2_POLICY_V1, RACE_GATE2_POLICY_VERSION } from './gate2-policy.js';
|
|
32
|
+
/** `fast-lane-norm.md` §2 numbers the risk surfaces 1..7; a value outside that is a typo, not a row. */
|
|
33
|
+
export const RISK_SURFACE_MAX = 7;
|
|
34
|
+
/**
|
|
35
|
+
* The file's own note, written by the writer so the artifact cannot be produced
|
|
36
|
+
* without it. Two claims it must carry, per PRD §4 and §5.3: what the evidence
|
|
37
|
+
* does NOT prove, and which of the two policy blocks is authoritative.
|
|
38
|
+
*/
|
|
39
|
+
export const PILOT_GATE_NOTE = [
|
|
40
|
+
'Gate-2 evidence for the peaks-race-code fast lane.',
|
|
41
|
+
'WHY IT IS TRACKED: gate 2 gates a TRACKED change (skills/peaks-audit/SKILL.md), so it is judged on tracked evidence; under .peaks/_runtime/ it would be gitignored, and whether the gate passed would stay a local fact.',
|
|
42
|
+
'WHAT IT DOES NOT PROVE: the per-task prose traces (.peaks/_runtime/<sessionId>/race/<rid>.md) are gitignored, so these rows were extracted from them and committed. Nothing in this repository can prove they came from tasks that were really run; a guard can only prove the rows, the counts, the verdict and the SKILL.md marker are mutually consistent.',
|
|
43
|
+
'WHICH POLICY IS AUTHORITATIVE: src/services/race/gate2-policy.ts. The policy block below is the RECORD of what was applied, copied verbatim from that constant; a verdict is always computed from the constant, never from this file — otherwise weakening this block would launder the gate.',
|
|
44
|
+
'ciRed false means no CI failure is attributed to this task, NOT that CI was green on its commit.',
|
|
45
|
+
'missedRiskSurface false means no missed risk surface is known; no procedure exists yet for setting it (U-C), so it is a required value with nothing behind it.'
|
|
46
|
+
].join(' ');
|
|
47
|
+
export const LANE_CHOSEN_BY_VALUES = ['user-named', 'user-picked'];
|
|
48
|
+
export const OUTCOME_VALUES = ['landed', 'escalated', 'stopped'];
|
|
49
|
+
export const HANDLING_VALUES = ['refused', 'escalated', 'user-override-recorded', 'none'];
|
|
50
|
+
/**
|
|
51
|
+
* One evidence row. `z.object` strips unknown keys, so an author-written
|
|
52
|
+
* `coreCapability: true` is ignored rather than honoured — the coverage value is
|
|
53
|
+
* derived (§3.2) and there is deliberately no field that can assert it.
|
|
54
|
+
*/
|
|
55
|
+
const pilotTaskRowSchema = z.object({
|
|
56
|
+
rid: z.string().min(1),
|
|
57
|
+
sessionId: z.string().min(1),
|
|
58
|
+
date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
|
|
59
|
+
laneChosenBy: z.enum(LANE_CHOSEN_BY_VALUES),
|
|
60
|
+
outcome: z.enum(OUTCOME_VALUES),
|
|
61
|
+
filesChanged: z.array(z.string()),
|
|
62
|
+
riskSurfacesHit: z.array(z.number().int()),
|
|
63
|
+
riskSurfaceHandling: z.enum(HANDLING_VALUES),
|
|
64
|
+
rolledBack: z.boolean(),
|
|
65
|
+
ciRed: z.boolean(),
|
|
66
|
+
missedRiskSurface: z.boolean()
|
|
67
|
+
});
|
|
68
|
+
/**
|
|
69
|
+
* The reader needs what it judges with and nothing else. `tasks` is required —
|
|
70
|
+
* a file whose rows cannot be read is not a verdict, it is unreadable evidence.
|
|
71
|
+
* `policyVersion` is read for the report. The rest of the artifact
|
|
72
|
+
* (`evaluatorVersion`, `updatedAt`, `policy`, `lastEvaluation`) is the writer's
|
|
73
|
+
* record and is deliberately NOT a precondition for judging: PRD §3 versions the
|
|
74
|
+
* policy precisely so that a file written under a different version stays
|
|
75
|
+
* readable instead of turning into a parse error.
|
|
76
|
+
*/
|
|
77
|
+
const pilotGateFileSchema = z.object({
|
|
78
|
+
policyVersion: z.string().optional(),
|
|
79
|
+
tasks: z.array(pilotTaskRowSchema)
|
|
80
|
+
});
|
|
81
|
+
export function pilotGatePath(projectRoot) {
|
|
82
|
+
return join(projectRoot, '.peaks', 'race', 'pilot-gate.json');
|
|
83
|
+
}
|
|
84
|
+
export function readPilotGate(projectRoot) {
|
|
85
|
+
const path = pilotGatePath(projectRoot);
|
|
86
|
+
if (!existsSync(path))
|
|
87
|
+
return { kind: 'missing', path };
|
|
88
|
+
let raw;
|
|
89
|
+
try {
|
|
90
|
+
raw = JSON.parse(readFileSync(path, 'utf8'));
|
|
91
|
+
}
|
|
92
|
+
catch (error) {
|
|
93
|
+
return {
|
|
94
|
+
kind: 'invalid',
|
|
95
|
+
path,
|
|
96
|
+
message: error instanceof Error ? error.message : String(error)
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
const parsed = pilotGateFileSchema.safeParse(raw);
|
|
100
|
+
if (!parsed.success) {
|
|
101
|
+
return { kind: 'invalid', path, message: describeIssues(parsed.error) };
|
|
102
|
+
}
|
|
103
|
+
return { kind: 'ok', path, gate: parsed.data };
|
|
104
|
+
}
|
|
105
|
+
function describeIssues(error) {
|
|
106
|
+
return error.issues
|
|
107
|
+
.map((issue) => `${issue.path.join('.') || '<root>'}: ${issue.message}`)
|
|
108
|
+
.join('; ');
|
|
109
|
+
}
|
|
110
|
+
/** Backslashes are normalized rather than refused: a path is a path on either shell. */
|
|
111
|
+
function normalizeFiles(files) {
|
|
112
|
+
const normalized = [];
|
|
113
|
+
for (const file of files) {
|
|
114
|
+
const path = file.replace(/\\/g, '/');
|
|
115
|
+
if (isUnsafePathInput(path)) {
|
|
116
|
+
return {
|
|
117
|
+
ok: false,
|
|
118
|
+
message: `--file must be repository-relative, got ${JSON.stringify(file)}`
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
normalized.push(path);
|
|
122
|
+
}
|
|
123
|
+
return { ok: true, files: normalized };
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* The one rule no schema can state: a hit with no disposition is a MISSING
|
|
127
|
+
* record, and accepting it silently would make the coverage derivation credit
|
|
128
|
+
* nothing and say nothing.
|
|
129
|
+
*/
|
|
130
|
+
function checkRiskSurfaces(surfaces, handling) {
|
|
131
|
+
for (const surface of surfaces) {
|
|
132
|
+
if (!Number.isInteger(surface) || surface < 1 || surface > RISK_SURFACE_MAX) {
|
|
133
|
+
return `--risk-surface must be an integer 1..${RISK_SURFACE_MAX}, got ${surface}`;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
if (surfaces.length > 0 && handling === 'none') {
|
|
137
|
+
return '--risk-surface-handling cannot be "none" when --risk-surface is present: a hit with no disposition is a missing record, not a clean row';
|
|
138
|
+
}
|
|
139
|
+
return null;
|
|
140
|
+
}
|
|
141
|
+
/**
|
|
142
|
+
* Validate one row, fail-closed, each refusal naming the rule it broke. Nothing
|
|
143
|
+
* is written when this returns `invalid`.
|
|
144
|
+
*/
|
|
145
|
+
export function buildPilotTaskRow(input) {
|
|
146
|
+
const invalid = (message) => ({
|
|
147
|
+
kind: 'invalid',
|
|
148
|
+
message
|
|
149
|
+
});
|
|
150
|
+
// The rule is the id PATTERN, not a prefix: a name may key a row, it may not
|
|
151
|
+
// veto one. Snapshot of `.peaks/_runtime/*/rd/requests/` on 2026-10-13 — 97
|
|
152
|
+
// ids, 39 prefixed, 58 not — so the test this replaces refused 58 of 97 of
|
|
153
|
+
// what the repository mints. `REQUEST_ID_PATTERN` is imported rather than
|
|
154
|
+
// re-spelled so this site cannot drift, and it is STRICTER than that test:
|
|
155
|
+
// the old one accepted `rid-/abs`, this one refuses it.
|
|
156
|
+
if (!REQUEST_ID_PATTERN.test(input.rid)) {
|
|
157
|
+
return invalid(`--rid must match ${REQUEST_ID_PATTERN.source}, got ${JSON.stringify(input.rid)}`);
|
|
158
|
+
}
|
|
159
|
+
// `isUnsafePathInput` is the predicate `guardRuntimeSegment` is built on; the
|
|
160
|
+
// ids and the file paths are checked BEFORE anything is written. THIS RID ARM
|
|
161
|
+
// IS UNREACHABLE-TRUE: every string the pattern admits is one `[A-Za-z0-9._-]`
|
|
162
|
+
// segment starting alphanumeric, so it always passes, and it is KEPT as
|
|
163
|
+
// defence in depth — the invariant, not the test, makes the write safe. The
|
|
164
|
+
// SESSION arm below is the live one; `../../PWNED` reaches and is refused by it.
|
|
165
|
+
if (isUnsafePathInput(input.rid)) {
|
|
166
|
+
return invalid(`--rid must be a single safe path segment, got ${JSON.stringify(input.rid)}`);
|
|
167
|
+
}
|
|
168
|
+
if (isUnsafePathInput(input.sessionId)) {
|
|
169
|
+
return invalid(`--session-id must be a single safe path segment, got ${JSON.stringify(input.sessionId)}`);
|
|
170
|
+
}
|
|
171
|
+
const files = normalizeFiles(input.filesChanged);
|
|
172
|
+
if (!files.ok)
|
|
173
|
+
return invalid(files.message);
|
|
174
|
+
const surfaceProblem = checkRiskSurfaces(input.riskSurfacesHit, input.riskSurfaceHandling);
|
|
175
|
+
if (surfaceProblem !== null)
|
|
176
|
+
return invalid(surfaceProblem);
|
|
177
|
+
const parsed = pilotTaskRowSchema.safeParse({ ...input, filesChanged: files.files });
|
|
178
|
+
if (!parsed.success)
|
|
179
|
+
return invalid(describeIssues(parsed.error));
|
|
180
|
+
return { kind: 'ok', row: parsed.data };
|
|
181
|
+
}
|
|
182
|
+
/**
|
|
183
|
+
* Idempotent upsert of one row, keyed by `--rid`: a repeated rid replaces that
|
|
184
|
+
* row in place (first-seen order preserved), a new rid is appended. The writer is
|
|
185
|
+
* also the only thing that can refresh `lastEvaluation` — the reader owns no file
|
|
186
|
+
* — which is what keeps the committed evaluation from going stale.
|
|
187
|
+
*
|
|
188
|
+
* Throws when the existing file cannot be read: clobbering unreadable evidence
|
|
189
|
+
* with a fresh one-row file would silently destroy rows.
|
|
190
|
+
*/
|
|
191
|
+
export function upsertPilotTask(projectRoot, row, now = new Date()) {
|
|
192
|
+
const existing = readPilotGate(projectRoot);
|
|
193
|
+
if (existing.kind === 'invalid') {
|
|
194
|
+
throw new Error(`PILOT_GATE_EVIDENCE_INVALID: ${existing.path}: ${existing.message}`);
|
|
195
|
+
}
|
|
196
|
+
const previousTasks = existing.kind === 'ok' ? existing.gate.tasks : [];
|
|
197
|
+
const index = previousTasks.findIndex((task) => task.rid === row.rid);
|
|
198
|
+
const tasks = index === -1
|
|
199
|
+
? [...previousTasks, row]
|
|
200
|
+
: previousTasks.map((task, at) => (at === index ? row : task));
|
|
201
|
+
const evaluation = evaluatePilotGate(tasks, RACE_GATE2_POLICY_V1);
|
|
202
|
+
writePilotGate(projectRoot, tasks, evaluation, now);
|
|
203
|
+
return { path: pilotGatePath(projectRoot), evaluation };
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
* The full artifact the writer owns. The `policy` block is copied from the code
|
|
207
|
+
* constant verbatim — it records what was applied, and a test asserts the two are
|
|
208
|
+
* byte-equal so the record cannot drift from the source.
|
|
209
|
+
*/
|
|
210
|
+
function writePilotGate(projectRoot, tasks, evaluation, now) {
|
|
211
|
+
const path = pilotGatePath(projectRoot);
|
|
212
|
+
const artifact = {
|
|
213
|
+
note: PILOT_GATE_NOTE,
|
|
214
|
+
policyVersion: RACE_GATE2_POLICY_VERSION,
|
|
215
|
+
evaluatorVersion: CLI_VERSION,
|
|
216
|
+
updatedAt: now.toISOString(),
|
|
217
|
+
policy: RACE_GATE2_POLICY_V1,
|
|
218
|
+
tasks,
|
|
219
|
+
lastEvaluation: { ...evaluation, evaluatedAt: now.toISOString() }
|
|
220
|
+
};
|
|
221
|
+
// Temp file in the same directory, then rename: a crash mid-write leaves the
|
|
222
|
+
// previous valid evidence intact rather than a truncated one.
|
|
223
|
+
mkdirSync(dirname(path), { recursive: true });
|
|
224
|
+
const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
|
|
225
|
+
writeFileSync(tmp, `${JSON.stringify(artifact, null, 2)}\n`, 'utf8');
|
|
226
|
+
renameSync(tmp, path);
|
|
227
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/** A git read the scan needs could not be completed. Thrown, never returned:
|
|
2
|
+
* the alternative is an empty file list that reads as "nothing changed". */
|
|
3
|
+
export declare class GitReadFailedError extends Error {
|
|
4
|
+
readonly code = "FILE_SIZE_GIT_READ_FAILED";
|
|
5
|
+
constructor(what: string, projectRoot: string, detail: string);
|
|
6
|
+
}
|
|
7
|
+
export type ChangedFiles = {
|
|
8
|
+
/** Paths to measure in the working tree: Added/Modified entries plus rename
|
|
9
|
+
* targets. Deletions are omitted — they have no body to measure. */
|
|
10
|
+
paths: string[];
|
|
11
|
+
/** The path `file`'s baseline size must be read from: itself, or the name it
|
|
12
|
+
* had at `baseRef` before a rename. */
|
|
13
|
+
baselinePathFor(file: string): string;
|
|
14
|
+
};
|
|
15
|
+
/**
|
|
16
|
+
* The changed-file population the scan measures, as `git diff --name-status`
|
|
17
|
+
* reports it. `A`/`M` keep their path; `R`/`C` keep the TARGET path and record
|
|
18
|
+
* the source, so the rename is judged against the size the file had before it
|
|
19
|
+
* moved; `D` is dropped. A git failure here THROWS rather than returning `[]`.
|
|
20
|
+
*
|
|
21
|
+
* `only` is the caller's own list, when it has one — see `restrictedTo`.
|
|
22
|
+
*/
|
|
23
|
+
export declare function readChangedFiles(projectRoot: string, baseRef: string, only?: readonly string[]): ChangedFiles;
|
|
24
|
+
/** The file's raw-line count AT `baseRef`, or `null` when the ref has no such
|
|
25
|
+
* path — i.e. the change ADDED the file and it is over the cap by creation. */
|
|
26
|
+
export declare function readBaseLineCount(projectRoot: string, baseRef: string, file: string): number | null;
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
// src/services/scan/file-size-baseline.ts
|
|
2
|
+
//
|
|
3
|
+
// The git side of the diff-scoped file-size scan: WHICH files changed against a
|
|
4
|
+
// base ref, and HOW BIG each was at that ref. Together they make the scan a
|
|
5
|
+
// RATCHET — a file that is over its cap but no larger than its own state at that
|
|
6
|
+
// ref is accepted, and only growth past the cap is refused. Same rule as the
|
|
7
|
+
// commit gate's "a file you touch may not be WORSE than it was"
|
|
8
|
+
// (`.husky/peaks-gate.mjs`).
|
|
9
|
+
//
|
|
10
|
+
// FAIL-CLOSED ON BOTH GIT READS. The enumeration and the size probe both name
|
|
11
|
+
// their failure instead of swallowing it: a ratchet whose input list can
|
|
12
|
+
// silently become empty is not a ratchet, and `catch { return [] }` cannot tell
|
|
13
|
+
// "git refused to enumerate" from "nothing changed".
|
|
14
|
+
//
|
|
15
|
+
// RENAMES ARE JUDGED, NOT DROPPED. A rename is enumerated as `R` and compared
|
|
16
|
+
// against the OLD path's size at `baseRef`, so a pure rename passes and a
|
|
17
|
+
// rename that grows is refused naming the growth. The `--diff-filter=AM`
|
|
18
|
+
// spelling this replaced excluded `R` by accident — a file could grow past its
|
|
19
|
+
// cap and stay invisible to the scan simply by being renamed in the same
|
|
20
|
+
// commit.
|
|
21
|
+
//
|
|
22
|
+
// KNOWN, RECORDED, NOT FIXED — a DELETION is invisible: `D` entries are dropped
|
|
23
|
+
// before the measurement, and that is left as it is because a deletion cannot
|
|
24
|
+
// grow. It is a documentation matter, not a hole in the ratchet.
|
|
25
|
+
//
|
|
26
|
+
// KNOWN, RECORDED, NOT FIXED — subprocess cost is `2 + 2K` git spawns, where K
|
|
27
|
+
// is the changed files that are OVER their cap (one `cat-file -e` plus one
|
|
28
|
+
// `show` each, inside the scan's `lines > cap` branch; the 2 are the
|
|
29
|
+
// enumerations above). It is linear in OVER-CAP changed files, not in changed
|
|
30
|
+
// files: 10 changed with 0 over spawns 2, with 2 over spawns 6, with 5 over
|
|
31
|
+
// spawns 12; 40 changed with 3 over spawns 8 and with 40 over spawns 82. At
|
|
32
|
+
// roughly 58 ms per process on the measured host that is 0.8 s at K=5 and 4.7 s
|
|
33
|
+
// at K=40, paid once per slice on a human-run command with two call sites.
|
|
34
|
+
// Batching every baseline read through one `git cat-file --batch` on stdin is
|
|
35
|
+
// the known fix if the many-over-cap case ever becomes real; it is not
|
|
36
|
+
// warranted at these numbers.
|
|
37
|
+
//
|
|
38
|
+
// Split out of `file-size-scan.ts`. That file was 237 raw lines at the split
|
|
39
|
+
// (not "at its cap"): the point is that this logic did not fit under 300 there,
|
|
40
|
+
// and the scan now depends on this module rather than on a hand-rolled list.
|
|
41
|
+
// This module's own name matches the `file-size` pattern the walk-based
|
|
42
|
+
// policy-wiring rule (`policyWiringFindings` in
|
|
43
|
+
// `tests/unit/standards/_file-size-cap-scan.ts`, asserted by
|
|
44
|
+
// `tests/unit/standards/file-size-cap.test.ts`) requires to import
|
|
45
|
+
// `file-size-policy.ts`; that test's literal fixtures name `file-size-scan.ts`,
|
|
46
|
+
// not this file.
|
|
47
|
+
import { execFileSync, spawnSync } from 'node:child_process';
|
|
48
|
+
import { countRawLines, normalizePolicyPath } from './file-size-policy.js';
|
|
49
|
+
/** A git read the scan needs could not be completed. Thrown, never returned:
|
|
50
|
+
* the alternative is an empty file list that reads as "nothing changed". */
|
|
51
|
+
export class GitReadFailedError extends Error {
|
|
52
|
+
code = 'FILE_SIZE_GIT_READ_FAILED';
|
|
53
|
+
constructor(what, projectRoot, detail) {
|
|
54
|
+
super(`File-size scan refused: ${what} could not be read from git in ${projectRoot} ` +
|
|
55
|
+
`(${detail}). A git failure is not "nothing changed"; fix the ref/path, or pass ` +
|
|
56
|
+
'a `baseRef` that resolves.');
|
|
57
|
+
this.name = 'GitReadFailedError';
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
function gitLines(projectRoot, args) {
|
|
61
|
+
let raw;
|
|
62
|
+
try {
|
|
63
|
+
raw = execFileSync('git', ['-C', projectRoot, ...args], {
|
|
64
|
+
encoding: 'utf8',
|
|
65
|
+
windowsHide: true
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
catch (error) {
|
|
69
|
+
const detail = error instanceof Error ? (error.message.split('\n')[0] ?? '') : String(error);
|
|
70
|
+
throw new GitReadFailedError(`\`git ${args.join(' ')}\``, projectRoot, detail);
|
|
71
|
+
}
|
|
72
|
+
return raw
|
|
73
|
+
.split(/\r?\n/)
|
|
74
|
+
.map((line) => line.trim())
|
|
75
|
+
.filter(Boolean);
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* The caller's list, intersected with what git reports — or the whole change set when
|
|
79
|
+
* the caller named none. Compared in the policy's POSIX spelling, because a
|
|
80
|
+
* Windows-native caller path and a git-reported one spell the same file differently.
|
|
81
|
+
*
|
|
82
|
+
* INTERSECTION, NOT POPULATION. The commit hook is handed the STAGED paths by
|
|
83
|
+
* lint-staged, so it knows its set and the set is narrower than the working tree: a
|
|
84
|
+
* modification nobody staged is not part of that commit, and measuring it would block
|
|
85
|
+
* the commit over a file it was never asked about. A named path git does not report as
|
|
86
|
+
* changed is therefore skipped, never measured — this narrows; it cannot widen.
|
|
87
|
+
*/
|
|
88
|
+
function restrictedTo(all, only) {
|
|
89
|
+
if (only === undefined)
|
|
90
|
+
return [...all];
|
|
91
|
+
const wanted = new Set(only.map(normalizePolicyPath));
|
|
92
|
+
return all.filter((file) => wanted.has(normalizePolicyPath(file)));
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* The changed-file population the scan measures, as `git diff --name-status`
|
|
96
|
+
* reports it. `A`/`M` keep their path; `R`/`C` keep the TARGET path and record
|
|
97
|
+
* the source, so the rename is judged against the size the file had before it
|
|
98
|
+
* moved; `D` is dropped. A git failure here THROWS rather than returning `[]`.
|
|
99
|
+
*
|
|
100
|
+
* `only` is the caller's own list, when it has one — see `restrictedTo`.
|
|
101
|
+
*/
|
|
102
|
+
export function readChangedFiles(projectRoot, baseRef, only) {
|
|
103
|
+
const paths = [];
|
|
104
|
+
const renameSources = new Map();
|
|
105
|
+
for (const line of gitLines(projectRoot, ['diff', '--name-status', baseRef])) {
|
|
106
|
+
const [status, first, second] = line.split('\t');
|
|
107
|
+
if (status === undefined || first === undefined)
|
|
108
|
+
continue;
|
|
109
|
+
if ((status.startsWith('R') || status.startsWith('C')) && second !== undefined) {
|
|
110
|
+
paths.push(second);
|
|
111
|
+
renameSources.set(second, first);
|
|
112
|
+
}
|
|
113
|
+
else if (status.startsWith('A') || status.startsWith('M')) {
|
|
114
|
+
paths.push(first);
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
const untracked = gitLines(projectRoot, ['ls-files', '--others', '--exclude-standard']);
|
|
118
|
+
const allPaths = Array.from(new Set([...paths, ...untracked]));
|
|
119
|
+
return {
|
|
120
|
+
paths: restrictedTo(allPaths, only),
|
|
121
|
+
baselinePathFor: (file) => renameSources.get(file) ?? file
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Whether `git cat-file -e` could resolve `<baseRef>:<file>`, i.e. whether the
|
|
126
|
+
* probe EXITED ZERO. What a non-zero exit actually measures is wider than "the
|
|
127
|
+
* ref has no such path": a bad or unreadable ref (a misspelled name, or `HEAD~1`
|
|
128
|
+
* on a root commit) and any other git failure exit non-zero too and are read
|
|
129
|
+
* identically. That conflation is fail-closed — no baseline means
|
|
130
|
+
* `previousLines: null`, which the scan reads as "created over the cap" and
|
|
131
|
+
* refuses. Stated so the next reader does not take the narrow reading.
|
|
132
|
+
*/
|
|
133
|
+
function pathExistsAtRef(projectRoot, baseRef, file) {
|
|
134
|
+
const probe = spawnSync('git', ['-C', projectRoot, 'cat-file', '-e', `${baseRef}:${file}`], {
|
|
135
|
+
stdio: 'ignore',
|
|
136
|
+
windowsHide: true
|
|
137
|
+
});
|
|
138
|
+
return probe.status === 0;
|
|
139
|
+
}
|
|
140
|
+
/** The file's raw-line count AT `baseRef`, or `null` when the ref has no such
|
|
141
|
+
* path — i.e. the change ADDED the file and it is over the cap by creation. */
|
|
142
|
+
export function readBaseLineCount(projectRoot, baseRef, file) {
|
|
143
|
+
if (!pathExistsAtRef(projectRoot, baseRef, file)) {
|
|
144
|
+
return null;
|
|
145
|
+
}
|
|
146
|
+
return countRawLines(execFileSync('git', ['-C', projectRoot, 'show', `${baseRef}:${file}`], {
|
|
147
|
+
encoding: 'utf8',
|
|
148
|
+
windowsHide: true
|
|
149
|
+
}));
|
|
150
|
+
}
|
|
@@ -29,6 +29,17 @@ export type FileSizeViolation = {
|
|
|
29
29
|
/** The cap this file was measured against, resolved per path by the policy
|
|
30
30
|
* module (300 raw lines; 500 under root `tests/`), or the caller's override. */
|
|
31
31
|
cap: number;
|
|
32
|
+
/**
|
|
33
|
+
* The file's raw-line count at `baseRef`, or `null` when the file did not
|
|
34
|
+
* exist there — i.e. THIS change CREATED it over the cap.
|
|
35
|
+
*
|
|
36
|
+
* A changed file that is over its cap but NOT larger than its own state at
|
|
37
|
+
* `baseRef` is not a violation: the whole-tree `fileSizeOverCap` ratchet
|
|
38
|
+
* already accepts it as a standing quantity, so touching it must stay legal.
|
|
39
|
+
* Only growth travels here — including growth that a rename carried along,
|
|
40
|
+
* which is measured against the pre-rename path.
|
|
41
|
+
*/
|
|
42
|
+
previousLines: number | null;
|
|
32
43
|
};
|
|
33
44
|
export type FileSizeScanResult = {
|
|
34
45
|
ok: boolean;
|
|
@@ -41,10 +52,17 @@ export type FileSizeScanResult = {
|
|
|
41
52
|
* records). Reported so the exemption is auditable rather than a silent
|
|
42
53
|
* skip. */
|
|
43
54
|
exemptFiles: string[];
|
|
44
|
-
/** Files that appeared in `git diff` but no longer exist on disk
|
|
45
|
-
*
|
|
46
|
-
* ENOENT; now they are reported here as informational data. */
|
|
55
|
+
/** Files that appeared in `git diff` but no longer exist on disk. Pre-#015
|
|
56
|
+
* the scan crashed on these via ENOENT; now they are reported, not counted. */
|
|
47
57
|
deletedFiles: string[];
|
|
58
|
+
/**
|
|
59
|
+
* Changed files that ARE over their cap right now but this change did not
|
|
60
|
+
* enlarge (they were already that large at `baseRef`, or larger). They
|
|
61
|
+
* are NOT violations — the ratchet accepts them — but they are named here
|
|
62
|
+
* rather than dropped, so "0 violations" cannot mean "nothing was over the
|
|
63
|
+
* cap"; the same reason `exemptFiles` and `outOfScopeFiles` exist.
|
|
64
|
+
*/
|
|
65
|
+
acceptedOverCapFiles: string[];
|
|
48
66
|
/** Changed files the file-size policy does not measure at all: outside its
|
|
49
67
|
* four scope directories, or with an extension it does not count. Reported
|
|
50
68
|
* rather than silently skipped, for the same reason `exemptFiles` is.
|
|
@@ -74,5 +92,26 @@ export type FileSizeScanOptions = {
|
|
|
74
92
|
* the policy is the default, this option only overrides it.
|
|
75
93
|
*/
|
|
76
94
|
threshold?: number;
|
|
95
|
+
/**
|
|
96
|
+
* The caller's own list, when it has one — the commit hook is handed the STAGED
|
|
97
|
+
* paths by lint-staged. It RESTRICTS the git change set (a path git does not
|
|
98
|
+
* report as changed is skipped, never measured) and never widens it; omitted,
|
|
99
|
+
* git alone decides the population.
|
|
100
|
+
*/
|
|
101
|
+
files?: readonly string[];
|
|
77
102
|
};
|
|
103
|
+
/**
|
|
104
|
+
* The diff-scoped scan, judged as a RATCHET: a changed file is a violation only
|
|
105
|
+
* when THIS change enlarged it — it grew past its cap, or was created over it.
|
|
106
|
+
* A file that is over its cap but no larger than its own state at `baseRef`
|
|
107
|
+
* passes, because the baseline already carries it as an accepted over-cap
|
|
108
|
+
* quantity (`ceilings.fileSizeOverCap`) and `request transition rd →
|
|
109
|
+
* implemented` refusing to touch any of those files is the contradiction that
|
|
110
|
+
* blocked two consecutive slices. A rename is judged against the size the file
|
|
111
|
+
* had before it moved, so moving a file is not itself growth.
|
|
112
|
+
*
|
|
113
|
+
* THROWS `GitReadFailedError` when git cannot enumerate the changed files (an
|
|
114
|
+
* unresolvable `baseRef`, a non-repo path) — an empty list must mean "nothing
|
|
115
|
+
* changed", never "the read failed". `readChangedFiles` owns that refusal.
|
|
116
|
+
*/
|
|
78
117
|
export declare function scanFileSize(options: FileSizeScanOptions): FileSizeScanResult;
|