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
|
@@ -61,6 +61,7 @@ export function createProjectMemoryExtractPlan(options) {
|
|
|
61
61
|
export function executeProjectMemoryExtract(options) {
|
|
62
62
|
const plan = createProjectMemoryExtractPlan(options);
|
|
63
63
|
const writtenFiles = [];
|
|
64
|
+
const skippedWrites = [];
|
|
64
65
|
if (plan.apply) {
|
|
65
66
|
mkdirSync(plan.primaryMemoryDir, { recursive: true });
|
|
66
67
|
const safeMemoryDir = assertSafeProjectMemoryDir(plan.projectRoot);
|
|
@@ -74,8 +75,18 @@ export function executeProjectMemoryExtract(options) {
|
|
|
74
75
|
const existingNames = readStoredMemoryNames(plan.primaryMemoryDir);
|
|
75
76
|
for (const write of plan.plannedWrites) {
|
|
76
77
|
const slug = slugify(write.memory.title);
|
|
77
|
-
if (existingNames.has(slug))
|
|
78
|
+
if (existingNames.has(slug)) {
|
|
79
|
+
// Recorded, not merely skipped: a skip and a successful write left
|
|
80
|
+
// identical evidence in the envelope, so the block vanished from the
|
|
81
|
+
// report of a run that had extracted it.
|
|
82
|
+
skippedWrites.push({
|
|
83
|
+
slug,
|
|
84
|
+
title: write.memory.title,
|
|
85
|
+
sourceArtifact: write.memory.sourceArtifact,
|
|
86
|
+
filePath: write.filePath
|
|
87
|
+
});
|
|
78
88
|
continue;
|
|
89
|
+
}
|
|
79
90
|
const targetPath = resolveInputPath(write.filePath);
|
|
80
91
|
const stableTargetPath = stablePath(targetPath);
|
|
81
92
|
if (!isInsidePath(stableTargetPath, stableRealPath(safeMemoryDir))) {
|
|
@@ -97,7 +108,7 @@ export function executeProjectMemoryExtract(options) {
|
|
|
97
108
|
const indexPath = join(plan.primaryMemoryDir, 'index.json');
|
|
98
109
|
generateMemoryIndexFile(plan.projectRoot, plan.primaryMemoryDir, indexPath);
|
|
99
110
|
}
|
|
100
|
-
return { ...plan, writtenFiles };
|
|
111
|
+
return { ...plan, writtenFiles, skippedWrites };
|
|
101
112
|
}
|
|
102
113
|
export function createProjectMemoryBackupPlan(options) {
|
|
103
114
|
const projectRoot = normalizeRoot(options.projectRoot);
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
export type { BackupPlanOptions, ExtractedProjectMemory, MemoryBlockDrop, MemoryBlockDropReason, MemoryBlockParse, MemoryKindTier, ExtractPlanOptions, ExtractSessionMemoriesOptions, ExtractSessionMemoriesResult, MemoryIndex, MemoryIndexEntry, ProjectMemoryBackupPlan, ProjectMemoryBackupResult, ProjectMemoryBackupSummary, ProjectMemoryCopy, ProjectMemoryExtractPlan, ProjectMemoryExtractResult, ProjectMemoryExtractSummary, ProjectMemoryKind, ProjectMemoryReadResult, ProjectMemoryShowResult, ProjectMemoryWrite, StoredProjectMemory } from './types.js';
|
|
1
|
+
export type { BackupPlanOptions, ExtractedProjectMemory, MemoryBlockDrop, MemoryBlockDropReason, MemoryBlockParse, MemoryKindTier, MemoryWriteSkip, ExtractPlanOptions, ExtractSessionMemoriesOptions, ExtractSessionMemoriesResult, MemoryIndex, MemoryIndexEntry, ProjectMemoryBackupPlan, ProjectMemoryBackupResult, ProjectMemoryBackupSummary, ProjectMemoryCopy, ProjectMemoryExtractPlan, ProjectMemoryExtractResult, ProjectMemoryExtractSummary, ProjectMemoryKind, ProjectMemoryReadResult, ProjectMemoryShowResult, ProjectMemoryWrite, StoredProjectMemory } from './types.js';
|
|
2
2
|
export { VALID_PROJECT_MEMORY_KINDS } from './parsers/frontmatter.js';
|
|
3
3
|
export { HOT_MEMORY_KINDS, MEMORY_KIND_TIER, PROJECT_MEMORY_KINDS, WARM_MEMORY_KINDS } from './types.js';
|
|
4
|
-
export { describeMemoryBlockDrops, describeSessionScanFailures, summarizeBackupResult, summarizeExtractResult, summarizeMemoryBody, extractStableProjectMemories, extractStableProjectMemoriesWithDiagnostics, END_MARKER, START_MARKER } from './parsers/markdown-pure.js';
|
|
4
|
+
export { describeMemoryBlockDrops, describeMemoryWriteSkips, describeSessionScanFailures, MAX_NAMED_MEMORY_WRITE_SKIPS, summarizeBackupResult, summarizeExtractResult, summarizeMemoryBody, extractStableProjectMemories, extractStableProjectMemoriesWithDiagnostics, END_MARKER, START_MARKER } from './parsers/markdown-pure.js';
|
|
5
5
|
export type { SessionScanFailure } from './types.js';
|
|
6
6
|
export type { ExtractedMemoryBlocks } from './parsers/markdown-pure.js';
|
|
7
7
|
export { parseBlock, parseBlockResult, parseMemoryFrontmatter, parseStoredMemoryFile, renderMemoryFile, resolveMemoryKind, resolveMemoryName, slugify } from './parsers/frontmatter.js';
|
|
@@ -14,7 +14,7 @@ export { VALID_PROJECT_MEMORY_KINDS } from './parsers/frontmatter.js';
|
|
|
14
14
|
// Canonical kind vocabulary + hot/warm tier map (slice E)
|
|
15
15
|
export { HOT_MEMORY_KINDS, MEMORY_KIND_TIER, PROJECT_MEMORY_KINDS, WARM_MEMORY_KINDS } from './types.js';
|
|
16
16
|
// Pure markdown helpers
|
|
17
|
-
export { describeMemoryBlockDrops, describeSessionScanFailures, summarizeBackupResult, summarizeExtractResult, summarizeMemoryBody, extractStableProjectMemories, extractStableProjectMemoriesWithDiagnostics, END_MARKER, START_MARKER } from './parsers/markdown-pure.js';
|
|
17
|
+
export { describeMemoryBlockDrops, describeMemoryWriteSkips, describeSessionScanFailures, MAX_NAMED_MEMORY_WRITE_SKIPS, summarizeBackupResult, summarizeExtractResult, summarizeMemoryBody, extractStableProjectMemories, extractStableProjectMemoriesWithDiagnostics, END_MARKER, START_MARKER } from './parsers/markdown-pure.js';
|
|
18
18
|
// Frontmatter parser + renderer
|
|
19
19
|
export { parseBlock, parseBlockResult, parseMemoryFrontmatter, parseStoredMemoryFile, renderMemoryFile, resolveMemoryKind, resolveMemoryName, slugify } from './parsers/frontmatter.js';
|
|
20
20
|
// Store: path safety + sensitive content
|
|
@@ -5,6 +5,42 @@ export declare const VALID_MEMORY_KINDS: ReadonlySet<ProjectMemoryKind>;
|
|
|
5
5
|
/** Exported for guard tests + tooling that needs to enumerate the accepted
|
|
6
6
|
* set (CLI help text, `--kind` validation) without duplicating the literal. */
|
|
7
7
|
export declare const VALID_PROJECT_MEMORY_KINDS: readonly ProjectMemoryKind[];
|
|
8
|
+
/**
|
|
9
|
+
* Filename stem for a memory title, and the `name:` its stored frontmatter
|
|
10
|
+
* carries.
|
|
11
|
+
*
|
|
12
|
+
* The character class is Unicode-aware deliberately. An ASCII-only class
|
|
13
|
+
* reduced EVERY title written in a non-Latin script to the same empty string,
|
|
14
|
+
* so all of them landed on one constant name: whichever title arrived first
|
|
15
|
+
* took that file, and each later one was skipped because the store refuses to
|
|
16
|
+
* overwrite a file it already holds. Two titles that still reduce to one stem
|
|
17
|
+
* are refused outright by the plan builders' duplicate-name check.
|
|
18
|
+
*
|
|
19
|
+
* A title with no letter or digit in any script ("!!!") leaves nothing to build
|
|
20
|
+
* a name from. That branch takes the first 32 hex characters of the title's
|
|
21
|
+
* sha256 instead of a fixed constant, so distinct titles still reach distinct
|
|
22
|
+
* names. It is a DIGEST rather than the title's bytes because of LENGTH: an
|
|
23
|
+
* encoding that grew with the title (the two-hex-chars-per-byte
|
|
24
|
+
* `toString('hex')` this replaced) produced names past the filesystem limit for
|
|
25
|
+
* a long enough title, so the write failed and took the whole batch with it —
|
|
26
|
+
* measured, exit 1 and 0 files for a 140-character title. A digest is 39
|
|
27
|
+
* characters whatever the title is.
|
|
28
|
+
*
|
|
29
|
+
* THE FIXED LENGTH IS BOUGHT WITH A PROBABILISTIC GUARANTEE, and that is the
|
|
30
|
+
* strongest thing this branch can claim. For the derived branch distinct titles
|
|
31
|
+
* reach distinct names with overwhelming probability rather than by
|
|
32
|
+
* construction: a collision needs two titles whose first 128 digest bits agree
|
|
33
|
+
* — the birthday bound puts that at about n^2 / 2^129 for n derived names in one
|
|
34
|
+
* store, i.e. under 1 in 10^26 at a million names. The branch above keeps the
|
|
35
|
+
* stronger, exact property (two titles share a stem only if they are equal
|
|
36
|
+
* modulo case and runs of non-letter/non-digit characters). Neither branch loses
|
|
37
|
+
* a block silently on a collision: within a run the duplicate-name check refuses
|
|
38
|
+
* the whole extract, and across runs the later write is skipped and NAMED in the
|
|
39
|
+
* envelope's `warnings`.
|
|
40
|
+
*
|
|
41
|
+
* The '_' is outside the alphabet the branch above can emit, so a derived name
|
|
42
|
+
* cannot equal a title-derived stem.
|
|
43
|
+
*/
|
|
8
44
|
export declare function slugify(title: string): string;
|
|
9
45
|
/**
|
|
10
46
|
* Single implementation of the extract-path block parse. Returns a
|
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
// every name here so the `index.ts` barrel, `markdown-pure.ts` and the CLI
|
|
8
8
|
// keep importing them from `./parsers/frontmatter.js` unchanged.
|
|
9
9
|
// ---------------------------------------------------------------------------
|
|
10
|
+
import { createHash } from 'node:crypto';
|
|
10
11
|
import { PROJECT_MEMORY_KINDS } from '../types.js';
|
|
11
12
|
/** Accepted-kind set, derived from the canonical `PROJECT_MEMORY_KINDS`
|
|
12
13
|
* tuple so the parser cannot drift from the union type / tier map. */
|
|
@@ -14,12 +15,57 @@ export const VALID_MEMORY_KINDS = new Set(PROJECT_MEMORY_KINDS);
|
|
|
14
15
|
/** Exported for guard tests + tooling that needs to enumerate the accepted
|
|
15
16
|
* set (CLI help text, `--kind` validation) without duplicating the literal. */
|
|
16
17
|
export const VALID_PROJECT_MEMORY_KINDS = PROJECT_MEMORY_KINDS;
|
|
18
|
+
/**
|
|
19
|
+
* Hex characters of the title digest the derived branch keeps. 32 hex = 128
|
|
20
|
+
* bits, and the name is therefore `memory_` + 32 = **39 characters for every
|
|
21
|
+
* title**, however long the title is.
|
|
22
|
+
*/
|
|
23
|
+
const DERIVED_NAME_HEX_LENGTH = 32;
|
|
24
|
+
/**
|
|
25
|
+
* Filename stem for a memory title, and the `name:` its stored frontmatter
|
|
26
|
+
* carries.
|
|
27
|
+
*
|
|
28
|
+
* The character class is Unicode-aware deliberately. An ASCII-only class
|
|
29
|
+
* reduced EVERY title written in a non-Latin script to the same empty string,
|
|
30
|
+
* so all of them landed on one constant name: whichever title arrived first
|
|
31
|
+
* took that file, and each later one was skipped because the store refuses to
|
|
32
|
+
* overwrite a file it already holds. Two titles that still reduce to one stem
|
|
33
|
+
* are refused outright by the plan builders' duplicate-name check.
|
|
34
|
+
*
|
|
35
|
+
* A title with no letter or digit in any script ("!!!") leaves nothing to build
|
|
36
|
+
* a name from. That branch takes the first 32 hex characters of the title's
|
|
37
|
+
* sha256 instead of a fixed constant, so distinct titles still reach distinct
|
|
38
|
+
* names. It is a DIGEST rather than the title's bytes because of LENGTH: an
|
|
39
|
+
* encoding that grew with the title (the two-hex-chars-per-byte
|
|
40
|
+
* `toString('hex')` this replaced) produced names past the filesystem limit for
|
|
41
|
+
* a long enough title, so the write failed and took the whole batch with it —
|
|
42
|
+
* measured, exit 1 and 0 files for a 140-character title. A digest is 39
|
|
43
|
+
* characters whatever the title is.
|
|
44
|
+
*
|
|
45
|
+
* THE FIXED LENGTH IS BOUGHT WITH A PROBABILISTIC GUARANTEE, and that is the
|
|
46
|
+
* strongest thing this branch can claim. For the derived branch distinct titles
|
|
47
|
+
* reach distinct names with overwhelming probability rather than by
|
|
48
|
+
* construction: a collision needs two titles whose first 128 digest bits agree
|
|
49
|
+
* — the birthday bound puts that at about n^2 / 2^129 for n derived names in one
|
|
50
|
+
* store, i.e. under 1 in 10^26 at a million names. The branch above keeps the
|
|
51
|
+
* stronger, exact property (two titles share a stem only if they are equal
|
|
52
|
+
* modulo case and runs of non-letter/non-digit characters). Neither branch loses
|
|
53
|
+
* a block silently on a collision: within a run the duplicate-name check refuses
|
|
54
|
+
* the whole extract, and across runs the later write is skipped and NAMED in the
|
|
55
|
+
* envelope's `warnings`.
|
|
56
|
+
*
|
|
57
|
+
* The '_' is outside the alphabet the branch above can emit, so a derived name
|
|
58
|
+
* cannot equal a title-derived stem.
|
|
59
|
+
*/
|
|
17
60
|
export function slugify(title) {
|
|
18
61
|
const slug = title
|
|
19
62
|
.toLowerCase()
|
|
20
|
-
.replace(/[
|
|
63
|
+
.replace(/[^\p{L}\p{N}]+/gu, '-')
|
|
21
64
|
.replace(/^-+|-+$/g, '');
|
|
22
|
-
|
|
65
|
+
if (slug.length > 0)
|
|
66
|
+
return slug;
|
|
67
|
+
const digest = createHash('sha256').update(title, 'utf8').digest('hex');
|
|
68
|
+
return `memory_${digest.slice(0, DERIVED_NAME_HEX_LENGTH)}`;
|
|
23
69
|
}
|
|
24
70
|
/**
|
|
25
71
|
* Single implementation of the extract-path block parse. Returns a
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { ExtractedProjectMemory, MemoryBlockDrop, ProjectMemoryBackupResult, ProjectMemoryBackupSummary, ProjectMemoryExtractResult, ProjectMemoryExtractSummary, SessionScanFailure } from '../types.js';
|
|
1
|
+
import type { ExtractedProjectMemory, MemoryBlockDrop, MemoryWriteSkip, ProjectMemoryBackupResult, ProjectMemoryBackupSummary, ProjectMemoryExtractResult, ProjectMemoryExtractSummary, SessionScanFailure } from '../types.js';
|
|
2
2
|
export declare const START_MARKER = "<!-- peaks-memory:start -->";
|
|
3
3
|
export declare const END_MARKER = "<!-- peaks-memory:end -->";
|
|
4
4
|
export declare function summarizeMemoryBody(body: string): string;
|
|
@@ -29,5 +29,27 @@ export declare function describeMemoryBlockDrops(dropped: ReadonlyArray<MemoryBl
|
|
|
29
29
|
* whole file that never yielded blocks at all.
|
|
30
30
|
*/
|
|
31
31
|
export declare function describeSessionScanFailures(failures: ReadonlyArray<SessionScanFailure>): string[];
|
|
32
|
+
/**
|
|
33
|
+
* How many skipped writes are NAMED before the list closes with a count.
|
|
34
|
+
*
|
|
35
|
+
* The COUNT must never be lost — the failure reported here is a reader who could
|
|
36
|
+
* not tell how many writes were skipped — so it is always `skips.length`, never
|
|
37
|
+
* the number of lines above it. The LIST is what is capped: it grows with the
|
|
38
|
+
* capsule while the envelope does not, and 200 skipped blocks measured 201 lines
|
|
39
|
+
* and a 95 KB envelope with no ceiling on `warnings` anywhere in the code.
|
|
40
|
+
*/
|
|
41
|
+
export declare const MAX_NAMED_MEMORY_WRITE_SKIPS = 20;
|
|
42
|
+
/**
|
|
43
|
+
* Render one warning line per planned write the store already held, plus a
|
|
44
|
+
* closing line with both counts.
|
|
45
|
+
*
|
|
46
|
+
* The counts are passed in rather than derived from `skips.length`: the caller
|
|
47
|
+
* observed the run, and `planned - skipped` is a claim about writes this
|
|
48
|
+
* function did not see. The closing line exists because the failure being
|
|
49
|
+
* reported is exactly a reader having no way to notice that the two counts
|
|
50
|
+
* differed — the named lines say which blocks were lost, the count says how
|
|
51
|
+
* many, and only the second one stays exact past the cap.
|
|
52
|
+
*/
|
|
53
|
+
export declare function describeMemoryWriteSkips(skips: ReadonlyArray<MemoryWriteSkip>, plannedCount: number, writtenCount: number): string[];
|
|
32
54
|
export declare function summarizeExtractResult(result: ProjectMemoryExtractResult): ProjectMemoryExtractSummary;
|
|
33
55
|
export declare function summarizeBackupResult(result: ProjectMemoryBackupResult): ProjectMemoryBackupSummary;
|
|
@@ -164,6 +164,43 @@ export function describeMemoryBlockDrops(dropped) {
|
|
|
164
164
|
export function describeSessionScanFailures(failures) {
|
|
165
165
|
return failures.map((failure) => `Could not read the session artifact ${failure.file}: ${failure.detail}.`);
|
|
166
166
|
}
|
|
167
|
+
/**
|
|
168
|
+
* How many skipped writes are NAMED before the list closes with a count.
|
|
169
|
+
*
|
|
170
|
+
* The COUNT must never be lost — the failure reported here is a reader who could
|
|
171
|
+
* not tell how many writes were skipped — so it is always `skips.length`, never
|
|
172
|
+
* the number of lines above it. The LIST is what is capped: it grows with the
|
|
173
|
+
* capsule while the envelope does not, and 200 skipped blocks measured 201 lines
|
|
174
|
+
* and a 95 KB envelope with no ceiling on `warnings` anywhere in the code.
|
|
175
|
+
*/
|
|
176
|
+
export const MAX_NAMED_MEMORY_WRITE_SKIPS = 20;
|
|
177
|
+
/**
|
|
178
|
+
* Render one warning line per planned write the store already held, plus a
|
|
179
|
+
* closing line with both counts.
|
|
180
|
+
*
|
|
181
|
+
* The counts are passed in rather than derived from `skips.length`: the caller
|
|
182
|
+
* observed the run, and `planned - skipped` is a claim about writes this
|
|
183
|
+
* function did not see. The closing line exists because the failure being
|
|
184
|
+
* reported is exactly a reader having no way to notice that the two counts
|
|
185
|
+
* differed — the named lines say which blocks were lost, the count says how
|
|
186
|
+
* many, and only the second one stays exact past the cap.
|
|
187
|
+
*/
|
|
188
|
+
export function describeMemoryWriteSkips(skips, plannedCount, writtenCount) {
|
|
189
|
+
if (skips.length === 0)
|
|
190
|
+
return [];
|
|
191
|
+
const lines = skips
|
|
192
|
+
.slice(0, MAX_NAMED_MEMORY_WRITE_SKIPS)
|
|
193
|
+
.map((skip) => `Skipped writing the memory "${skip.title}" from ${skip.sourceArtifact}: ${skip.filePath} already exists, so the block was not written.`);
|
|
194
|
+
const unlisted = skips.length - MAX_NAMED_MEMORY_WRITE_SKIPS;
|
|
195
|
+
if (unlisted > 0) {
|
|
196
|
+
// The dropped names are dropped for good: `skippedWrites` stays out of the
|
|
197
|
+
// envelope's `data`, so `warnings` is the only carrier. Saying so beats
|
|
198
|
+
// pointing the reader at a list that is not there.
|
|
199
|
+
lines.push(`… and ${unlisted} more skipped writes; the count below is the full number.`);
|
|
200
|
+
}
|
|
201
|
+
lines.push(`Wrote ${writtenCount} of ${plannedCount} planned memories; ${skips.length} skipped because the target file already exists.`);
|
|
202
|
+
return lines;
|
|
203
|
+
}
|
|
167
204
|
export function summarizeExtractResult(result) {
|
|
168
205
|
return {
|
|
169
206
|
apply: result.apply,
|
|
@@ -36,6 +36,26 @@ export type MemoryBlockDrop = {
|
|
|
36
36
|
/** Human-readable explanation of the failed precondition. */
|
|
37
37
|
detail: string;
|
|
38
38
|
};
|
|
39
|
+
/**
|
|
40
|
+
* A planned write that was NOT performed because the store already holds its
|
|
41
|
+
* target name.
|
|
42
|
+
*
|
|
43
|
+
* Distinct from `MemoryBlockDrop`: that one is a PARSE rejection, decided from
|
|
44
|
+
* the block's own text. This one is a WRITE skip — the block parsed, and it is
|
|
45
|
+
* still not in `.peaks/memory/`. Without it the two outcomes read alike from the
|
|
46
|
+
* envelope, because either one leaves `writtenFiles` short of `plannedWrites`.
|
|
47
|
+
* Empty on a preview, which writes nothing and so skips nothing.
|
|
48
|
+
*/
|
|
49
|
+
export type MemoryWriteSkip = {
|
|
50
|
+
/** Filename stem the write would have used — already present in the store. */
|
|
51
|
+
slug: string;
|
|
52
|
+
/** Title of the memory that was not written. */
|
|
53
|
+
title: string;
|
|
54
|
+
/** Artifact the block was read from. */
|
|
55
|
+
sourceArtifact: string;
|
|
56
|
+
/** Absolute path that already exists and was therefore left untouched. */
|
|
57
|
+
filePath: string;
|
|
58
|
+
};
|
|
39
59
|
/**
|
|
40
60
|
* Result of parsing one memory block, as a discriminated union.
|
|
41
61
|
*
|
|
@@ -72,6 +92,12 @@ export type ProjectMemoryExtractPlan = {
|
|
|
72
92
|
};
|
|
73
93
|
export type ProjectMemoryExtractResult = ProjectMemoryExtractPlan & {
|
|
74
94
|
writtenFiles: string[];
|
|
95
|
+
/**
|
|
96
|
+
* Planned writes the store already held, so `writtenFiles` is shorter than
|
|
97
|
+
* `plannedWrites` by exactly this many. Reported through the CLI envelope's
|
|
98
|
+
* `warnings` channel, which is why it adds no field to the summary.
|
|
99
|
+
*/
|
|
100
|
+
skippedWrites: MemoryWriteSkip[];
|
|
75
101
|
};
|
|
76
102
|
export type ProjectMemoryExtractSummary = {
|
|
77
103
|
apply: boolean;
|
|
@@ -171,6 +197,12 @@ export type ExtractSessionMemoriesResult = {
|
|
|
171
197
|
extractedCount: number;
|
|
172
198
|
writtenFiles: string[];
|
|
173
199
|
updatedIndex: boolean;
|
|
200
|
+
/**
|
|
201
|
+
* Planned writes the store already held, so `writtenFiles` is shorter than
|
|
202
|
+
* `extractedCount` by exactly this many. Same diagnostic contract as
|
|
203
|
+
* `ProjectMemoryExtractResult.skippedWrites`.
|
|
204
|
+
*/
|
|
205
|
+
skippedWrites: MemoryWriteSkip[];
|
|
174
206
|
/**
|
|
175
207
|
* Blocks that were FOUND between the markers in this session's artifacts but
|
|
176
208
|
* rejected by the parser. Same diagnostic contract as
|
|
@@ -90,6 +90,13 @@ export declare function emitTokenUsageEvent(opts: {
|
|
|
90
90
|
projectRoot: string;
|
|
91
91
|
inputTokens: number;
|
|
92
92
|
outputTokens: number;
|
|
93
|
+
/**
|
|
94
|
+
* Where the two counts came from. Required, not defaulted: a `0` the provider
|
|
95
|
+
* reported and a `0` nobody measured are the same number, and the whole point
|
|
96
|
+
* of the tag is to stop them being read as one — a caller that cannot say
|
|
97
|
+
* which it holds has not measured.
|
|
98
|
+
*/
|
|
99
|
+
source: 'provider' | 'estimated';
|
|
93
100
|
}): EmitResult;
|
|
94
101
|
/**
|
|
95
102
|
*/
|
|
@@ -39,9 +39,10 @@
|
|
|
39
39
|
* `AUDIT_REQUIRES_HANDOFF` row. An earlier revision of this comment
|
|
40
40
|
* claimed three, and QA caught prose that disagreed with the code, which
|
|
41
41
|
* is the defect this module exists to end. The security path declared is
|
|
42
|
-
* the config-specific `rd/security-review
|
|
43
|
-
*
|
|
44
|
-
*
|
|
42
|
+
* the config-specific `rd/security-review-<rid>.md` (it carried no rid
|
|
43
|
+
* until slice 9.37, so the second config slice in a session overwrote the
|
|
44
|
+
* first's review) — not the documented `audit/security-<rid>.md`, which no
|
|
45
|
+
* config slice writes)
|
|
45
46
|
* - docs / chore → NOTHING. No `rd:qa-handoff` row ⇒ nothing for Gate C
|
|
46
47
|
* to validate ⇒ nothing declared (see below)
|
|
47
48
|
*
|
|
@@ -39,9 +39,10 @@
|
|
|
39
39
|
* `AUDIT_REQUIRES_HANDOFF` row. An earlier revision of this comment
|
|
40
40
|
* claimed three, and QA caught prose that disagreed with the code, which
|
|
41
41
|
* is the defect this module exists to end. The security path declared is
|
|
42
|
-
* the config-specific `rd/security-review
|
|
43
|
-
*
|
|
44
|
-
*
|
|
42
|
+
* the config-specific `rd/security-review-<rid>.md` (it carried no rid
|
|
43
|
+
* until slice 9.37, so the second config slice in a session overwrote the
|
|
44
|
+
* first's review) — not the documented `audit/security-<rid>.md`, which no
|
|
45
|
+
* config slice writes)
|
|
45
46
|
* - docs / chore → NOTHING. No `rd:qa-handoff` row ⇒ nothing for Gate C
|
|
46
47
|
* to validate ⇒ nothing declared (see below)
|
|
47
48
|
*
|
|
@@ -185,15 +185,29 @@ function checkBody(call, sourceFile, relPath) {
|
|
|
185
185
|
expected: 'block-body callback with // given: / // when: / // then: comments at the top'
|
|
186
186
|
};
|
|
187
187
|
}
|
|
188
|
+
/**
|
|
189
|
+
* The callback block of an `it` / `test` call, or null when the call has
|
|
190
|
+
* no block-bodied callback.
|
|
191
|
+
*
|
|
192
|
+
* THE CALLBACK IS NOT `arguments[1]`. vitest accepts an options object
|
|
193
|
+
* between the description and the callback — `it(name, { timeout }, fn)` —
|
|
194
|
+
* and this repo's own test files use that overload. Read at a fixed
|
|
195
|
+
* position, the options object is neither an arrow nor a function
|
|
196
|
+
* expression, so this returned null, the comment check never ran, and a
|
|
197
|
+
* conformant file came back `missing-given-when-then`: a WRONG verdict,
|
|
198
|
+
* not a missed one. So the callback is the LAST argument that is an arrow
|
|
199
|
+
* or a function expression, at whatever arity.
|
|
200
|
+
*/
|
|
188
201
|
function getCallbackBlock(call) {
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
return null;
|
|
196
|
-
|
|
202
|
+
for (let i = call.arguments.length - 1; i >= 0; i -= 1) {
|
|
203
|
+
const arg = call.arguments[i];
|
|
204
|
+
if (arg === undefined)
|
|
205
|
+
continue;
|
|
206
|
+
if (!ts.isArrowFunction(arg) && !ts.isFunctionExpression(arg))
|
|
207
|
+
continue;
|
|
208
|
+
return ts.isBlock(arg.body) ? arg.body : null;
|
|
209
|
+
}
|
|
210
|
+
return null;
|
|
197
211
|
}
|
|
198
212
|
function checkBlockLeadingComments(block, sourceFile, relPath) {
|
|
199
213
|
// TypeScript's `getLeadingCommentRanges` API is unreliable for
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import type { RaceGate2Policy } from './gate2-policy.js';
|
|
2
|
+
export type LaneChosenBy = 'user-named' | 'user-picked';
|
|
3
|
+
export type TaskOutcome = 'landed' | 'escalated' | 'stopped';
|
|
4
|
+
export type RiskSurfaceHandling = 'refused' | 'escalated' | 'user-override-recorded' | 'none';
|
|
5
|
+
export type PilotGateVerdict = 'pass' | 'fail' | 'insufficient-evidence';
|
|
6
|
+
export type PilotTaskRow = {
|
|
7
|
+
readonly rid: string;
|
|
8
|
+
readonly sessionId: string;
|
|
9
|
+
readonly date: string;
|
|
10
|
+
readonly laneChosenBy: LaneChosenBy;
|
|
11
|
+
readonly outcome: TaskOutcome;
|
|
12
|
+
readonly filesChanged: readonly string[];
|
|
13
|
+
readonly riskSurfacesHit: readonly number[];
|
|
14
|
+
readonly riskSurfaceHandling: RiskSurfaceHandling;
|
|
15
|
+
readonly rolledBack: boolean;
|
|
16
|
+
readonly ciRed: boolean;
|
|
17
|
+
readonly missedRiskSurface: boolean;
|
|
18
|
+
};
|
|
19
|
+
export type PilotGateCounts = {
|
|
20
|
+
readonly taskCount: number;
|
|
21
|
+
readonly coreCapabilityTaskCount: number;
|
|
22
|
+
readonly sessionCount: number;
|
|
23
|
+
readonly safetyArmExercisedCount: number;
|
|
24
|
+
readonly rollbackCount: number;
|
|
25
|
+
readonly ciRedCount: number;
|
|
26
|
+
readonly missedRiskSurfaceCount: number;
|
|
27
|
+
};
|
|
28
|
+
export type PilotGateReason = {
|
|
29
|
+
readonly code: string;
|
|
30
|
+
readonly message: string;
|
|
31
|
+
readonly observed: number;
|
|
32
|
+
readonly threshold: number;
|
|
33
|
+
};
|
|
34
|
+
export type PilotGateEvaluation = {
|
|
35
|
+
readonly verdict: PilotGateVerdict;
|
|
36
|
+
readonly counts: PilotGateCounts;
|
|
37
|
+
readonly reasons: readonly PilotGateReason[];
|
|
38
|
+
};
|
|
39
|
+
/**
|
|
40
|
+
* The safety arm fired and left a disposition. A hit with `'none'` is a MISSING
|
|
41
|
+
* record, not a clean row — so `'none'` does not count (PRD §3.2(b)).
|
|
42
|
+
*
|
|
43
|
+
* Counting basis is deliberately different from `taskCount`'s: this predicate is
|
|
44
|
+
* applied over ALL records, `escalated` and `stopped` included. An escalation is
|
|
45
|
+
* the safety arm firing correctly, and a landed-only reading would exclude the
|
|
46
|
+
* one sample where it did (PRD §3.1, the exception paragraph).
|
|
47
|
+
*/
|
|
48
|
+
export declare function safetyArmExercised(row: PilotTaskRow): boolean;
|
|
49
|
+
/**
|
|
50
|
+
* The coverage condition, DERIVED — never a `coreCapability: true` the author
|
|
51
|
+
* wrote (PRD §3.2). A row qualifies by reaching a hard-blocked family, or by
|
|
52
|
+
* exercising the safety arm.
|
|
53
|
+
*
|
|
54
|
+
* It does NOT test `outcome`: the caller applies this over landed rows only
|
|
55
|
+
* (§3.1), which is a property of the counting set, not of the predicate.
|
|
56
|
+
*/
|
|
57
|
+
export declare function taskExercisesCoreCapability(row: PilotTaskRow): boolean;
|
|
58
|
+
export declare function evaluatePilotGate(tasks: readonly PilotTaskRow[], policy: RaceGate2Policy): PilotGateEvaluation;
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
// src/services/race/gate2-evaluator.ts
|
|
2
|
+
//
|
|
3
|
+
// PURE. This module imports no `node:fs` and never writes: the evaluator judges,
|
|
4
|
+
// the store (`pilot-gate-store.ts`) is the only I/O module, and the CLI verb
|
|
5
|
+
// `race pilot-gate record` is the only writer. `peaks race pilot-status` is
|
|
6
|
+
// read-only and proven so by a test that diffs the evidence file's bytes.
|
|
7
|
+
//
|
|
8
|
+
// The verdict semantics are the PRD's §3.3 verbatim:
|
|
9
|
+
//
|
|
10
|
+
// any hard zero above its max -> fail (this branch wins)
|
|
11
|
+
// else all four floors met -> pass
|
|
12
|
+
// else -> insufficient-evidence
|
|
13
|
+
//
|
|
14
|
+
// `insufficient-evidence` is not a failure. It is "keep running the pilot".
|
|
15
|
+
/** Hard-blocked path families — imported from the hook constant, never restated (PRD U-D). */
|
|
16
|
+
import { HARD_BLOCKED_PATH_FAMILIES } from '../hooks/pre-tool-code-gate.js';
|
|
17
|
+
/**
|
|
18
|
+
* The safety arm fired and left a disposition. A hit with `'none'` is a MISSING
|
|
19
|
+
* record, not a clean row — so `'none'` does not count (PRD §3.2(b)).
|
|
20
|
+
*
|
|
21
|
+
* Counting basis is deliberately different from `taskCount`'s: this predicate is
|
|
22
|
+
* applied over ALL records, `escalated` and `stopped` included. An escalation is
|
|
23
|
+
* the safety arm firing correctly, and a landed-only reading would exclude the
|
|
24
|
+
* one sample where it did (PRD §3.1, the exception paragraph).
|
|
25
|
+
*/
|
|
26
|
+
export function safetyArmExercised(row) {
|
|
27
|
+
return row.riskSurfacesHit.length > 0 && row.riskSurfaceHandling !== 'none';
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* The coverage condition, DERIVED — never a `coreCapability: true` the author
|
|
31
|
+
* wrote (PRD §3.2). A row qualifies by reaching a hard-blocked family, or by
|
|
32
|
+
* exercising the safety arm.
|
|
33
|
+
*
|
|
34
|
+
* It does NOT test `outcome`: the caller applies this over landed rows only
|
|
35
|
+
* (§3.1), which is a property of the counting set, not of the predicate.
|
|
36
|
+
*/
|
|
37
|
+
export function taskExercisesCoreCapability(row) {
|
|
38
|
+
return row.filesChanged.some(isInHardBlockedFamily) || safetyArmExercised(row);
|
|
39
|
+
}
|
|
40
|
+
function isInHardBlockedFamily(file) {
|
|
41
|
+
const normalized = file.replace(/\\/g, '/');
|
|
42
|
+
return HARD_BLOCKED_PATH_FAMILIES.some((family) => normalized.startsWith(family));
|
|
43
|
+
}
|
|
44
|
+
function belowMin(code, quantity, observed, threshold) {
|
|
45
|
+
if (observed >= threshold)
|
|
46
|
+
return null;
|
|
47
|
+
return {
|
|
48
|
+
code,
|
|
49
|
+
message: `${quantity} is ${observed}, below the minimum of ${threshold}`,
|
|
50
|
+
observed,
|
|
51
|
+
threshold
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
function aboveMax(code, quantity, observed, threshold) {
|
|
55
|
+
if (observed <= threshold)
|
|
56
|
+
return null;
|
|
57
|
+
return {
|
|
58
|
+
code,
|
|
59
|
+
message: `${quantity} is ${observed}, above the maximum of ${threshold}`,
|
|
60
|
+
observed,
|
|
61
|
+
threshold
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
function isReason(reason) {
|
|
65
|
+
return reason !== null;
|
|
66
|
+
}
|
|
67
|
+
/** The four floors are counted over landed rows; the three hard zeros over every record. */
|
|
68
|
+
function countPilotTasks(tasks) {
|
|
69
|
+
const landed = tasks.filter((row) => row.outcome === 'landed');
|
|
70
|
+
return {
|
|
71
|
+
taskCount: landed.length,
|
|
72
|
+
coreCapabilityTaskCount: landed.filter(taskExercisesCoreCapability).length,
|
|
73
|
+
sessionCount: new Set(landed.map((row) => row.sessionId)).size,
|
|
74
|
+
safetyArmExercisedCount: tasks.filter(safetyArmExercised).length,
|
|
75
|
+
rollbackCount: tasks.filter((row) => row.rolledBack).length,
|
|
76
|
+
ciRedCount: tasks.filter((row) => row.ciRed).length,
|
|
77
|
+
missedRiskSurfaceCount: tasks.filter((row) => row.missedRiskSurface).length
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Hard zeros are safety quantities, read over ALL rows — an escalated task that
|
|
82
|
+
* was rolled back is still a rollback — and one non-zero is `fail` before any
|
|
83
|
+
* "is the sample big enough?" discussion starts (§3).
|
|
84
|
+
*/
|
|
85
|
+
function hardZeroReasonsFor(counts, policy) {
|
|
86
|
+
return [
|
|
87
|
+
aboveMax('rollback-above-max', 'rollbackCount', counts.rollbackCount, policy.rollbackCountMax),
|
|
88
|
+
aboveMax('ci-red-above-max', 'ciRedCount', counts.ciRedCount, policy.ciRedCountMax),
|
|
89
|
+
aboveMax('missed-risk-surface-above-max', 'missedRiskSurfaceCount', counts.missedRiskSurfaceCount, policy.missedRiskSurfaceCountMax)
|
|
90
|
+
].filter(isReason);
|
|
91
|
+
}
|
|
92
|
+
function floorReasonsFor(counts, policy) {
|
|
93
|
+
return [
|
|
94
|
+
belowMin('task-count-below-min', 'taskCount', counts.taskCount, policy.taskCountMin),
|
|
95
|
+
belowMin('core-capability-below-min', 'coreCapabilityTaskCount', counts.coreCapabilityTaskCount, policy.coreCapabilityTaskCountMin),
|
|
96
|
+
belowMin('session-count-below-min', 'sessionCount', counts.sessionCount, policy.sessionCountMin),
|
|
97
|
+
belowMin('safety-arm-below-min', 'safetyArmExercisedCount', counts.safetyArmExercisedCount, policy.safetyArmExercisedMin)
|
|
98
|
+
].filter(isReason);
|
|
99
|
+
}
|
|
100
|
+
export function evaluatePilotGate(tasks, policy) {
|
|
101
|
+
const counts = countPilotTasks(tasks);
|
|
102
|
+
const hardZeroReasons = hardZeroReasonsFor(counts, policy);
|
|
103
|
+
if (hardZeroReasons.length > 0) {
|
|
104
|
+
return { verdict: 'fail', counts, reasons: hardZeroReasons };
|
|
105
|
+
}
|
|
106
|
+
const floorReasons = floorReasonsFor(counts, policy);
|
|
107
|
+
if (floorReasons.length === 0) {
|
|
108
|
+
return { verdict: 'pass', counts, reasons: [] };
|
|
109
|
+
}
|
|
110
|
+
return { verdict: 'insufficient-evidence', counts, reasons: floorReasons };
|
|
111
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
export declare const RACE_GATE2_POLICY_VERSION = "race-gate2-policy-v1";
|
|
2
|
+
export type RaceGate2Policy = {
|
|
3
|
+
/** Floor: landed tasks only (§3.1). */
|
|
4
|
+
readonly taskCountMin: number;
|
|
5
|
+
/** Floor: landed tasks whose change reached the lane's core capability (§3.2). */
|
|
6
|
+
readonly coreCapabilityTaskCountMin: number;
|
|
7
|
+
/** Floor: distinct sessions among landed tasks. */
|
|
8
|
+
readonly sessionCountMin: number;
|
|
9
|
+
/** Floor: safety-arm hits over ALL records, escalated and stopped included (§3.1 exception). */
|
|
10
|
+
readonly safetyArmExercisedMin: number;
|
|
11
|
+
/** Hard zero: any rise is a failure, and it is never part of the "not enough sample" discussion. */
|
|
12
|
+
readonly rollbackCountMax: number;
|
|
13
|
+
readonly ciRedCountMax: number;
|
|
14
|
+
readonly missedRiskSurfaceCountMax: number;
|
|
15
|
+
readonly rationale: string;
|
|
16
|
+
};
|
|
17
|
+
export declare const RACE_GATE2_POLICY_V1: RaceGate2Policy;
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
// src/services/race/gate2-policy.ts
|
|
2
|
+
//
|
|
3
|
+
// THE ONE COMPUTATIONAL SOURCE of the race-lane gate-2 threshold policy.
|
|
4
|
+
//
|
|
5
|
+
// The tracked evidence file `.peaks/race/pilot-gate.json` carries a `policy`
|
|
6
|
+
// block too, but that is the RECORD of what was applied, written by the writer
|
|
7
|
+
// from this constant — never the authority. If the file's block were the source,
|
|
8
|
+
// weakening it in the tracked file would launder the gate.
|
|
9
|
+
//
|
|
10
|
+
// Changing the policy means changing RACE_GATE2_POLICY_VERSION with it, so a
|
|
11
|
+
// historical verdict is never re-interpreted under a policy it was not judged by.
|
|
12
|
+
//
|
|
13
|
+
// The rationale is quoted verbatim from §3 of the gate-2 threshold-policy PRD,
|
|
14
|
+
// because a threshold whose basis is dropped is a number nobody can re-derive.
|
|
15
|
+
export const RACE_GATE2_POLICY_VERSION = 'race-gate2-policy-v1';
|
|
16
|
+
const RATIONALE_LINES = [
|
|
17
|
+
'>= 10 的依据是 rule of three:n 次全绿、零观测失败时,真实失败率的 95% 上界 ≈ 1 − 0.05^(1/n)。n=10 ⇒ ≈ 26%。这是保守但可达的档:按 2026-10-11 的速度(一天 4 条落地)约 3 个工作日。',
|
|
18
|
+
'>= 3 条压核心的依据是前瞻的,不是回溯的:只数任务数的政策会让 10 条从未碰过硬阻断路径的任务通过一道从未测试过收益路径的门——这正是「散文判据」的翻版:数得到,但证明不了要证明的事。',
|
|
19
|
+
'>= 1 安全臂的依据是本轮的实测:2026-10-11 的 4 条 landed 全部 riskSurfacesHit: [];唯一真命中过风险面的(row 7,rid-emit-helpers-escalated)是升级未落地的那条——所以这条泳道的安全承诺从未在任何一条落地的任务上被测过。因此这一条与 taskCount 的口径不同,统计所有记录(含 escalated):升级本身就是安全臂正确开火的证据,只数 landed 会把它恰好排除掉。',
|
|
20
|
+
'>= 2 个 session 的依据:单 session 的多条任务共享同一份上下文与同一个操作者状态(2026-10-11 的 4 条全在一个 session 里)。跨 session 是最便宜的「不是一次侥幸」证据。'
|
|
21
|
+
];
|
|
22
|
+
export const RACE_GATE2_POLICY_V1 = {
|
|
23
|
+
taskCountMin: 10,
|
|
24
|
+
coreCapabilityTaskCountMin: 3,
|
|
25
|
+
sessionCountMin: 2,
|
|
26
|
+
safetyArmExercisedMin: 1,
|
|
27
|
+
rollbackCountMax: 0,
|
|
28
|
+
ciRedCountMax: 0,
|
|
29
|
+
missedRiskSurfaceCountMax: 0,
|
|
30
|
+
rationale: RATIONALE_LINES.join('\n')
|
|
31
|
+
};
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
export declare const LANE_PHASE_VALUES: readonly ["name-only", "offered-by-default"];
|
|
2
|
+
export type LanePhase = (typeof LANE_PHASE_VALUES)[number];
|
|
3
|
+
export type LanePhaseFile = {
|
|
4
|
+
readonly phase: LanePhase;
|
|
5
|
+
};
|
|
6
|
+
export type ReadLanePhaseResult = {
|
|
7
|
+
readonly kind: 'ok';
|
|
8
|
+
readonly path: string;
|
|
9
|
+
readonly file: LanePhaseFile;
|
|
10
|
+
} | {
|
|
11
|
+
readonly kind: 'missing';
|
|
12
|
+
readonly path: string;
|
|
13
|
+
} | {
|
|
14
|
+
readonly kind: 'invalid';
|
|
15
|
+
readonly path: string;
|
|
16
|
+
readonly message: string;
|
|
17
|
+
};
|
|
18
|
+
export declare function lanePhasePath(projectRoot: string): string;
|
|
19
|
+
export declare function readLanePhase(projectRoot: string): ReadLanePhaseResult;
|