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,221 @@
|
|
|
1
|
+
// src/cli/commands/final-review-prepare-command.ts
|
|
2
|
+
//
|
|
3
|
+
// The body of `peaks prepare-final-review`: the two input validations, the
|
|
4
|
+
// audit-goal path resolution, the provider check, the stub scaffold route and
|
|
5
|
+
// the real-provider route. Split out of `final-review-commands.ts`; every
|
|
6
|
+
// envelope code, message, `data` field and next-action string is unchanged.
|
|
7
|
+
//
|
|
8
|
+
// The input validations and the `_runtime` join below live in ONE module on
|
|
9
|
+
// purpose: rule D is file-scoped, so a join whose id slot is checked two
|
|
10
|
+
// modules away is a join the guard cannot see.
|
|
11
|
+
import { existsSync, statSync } from 'node:fs';
|
|
12
|
+
import { join, resolve } from 'node:path';
|
|
13
|
+
import { REQUEST_ID_PATTERN } from '../../services/artifacts/request-artifact-service.js';
|
|
14
|
+
import { createAnthropicRunner, LlmBindingError, resolveAnthropicConfig } from '../../services/llm/anthropic-runner.js';
|
|
15
|
+
import { emitTokenUsageEvent } from '../../services/observability/observability-service.js';
|
|
16
|
+
import { prepareFinalReview } from '../../services/final-review/final-review-service.js';
|
|
17
|
+
import { getErrorMessage } from '../cli-helpers.js';
|
|
18
|
+
import { DEFAULT_LLM_PROVIDER, isSupportedLlmProvider, SUPPORTED_LLM_PROVIDERS } from './final-review-command-shared.js';
|
|
19
|
+
import { emitPrepareFailure, emitReviewEnvelope, emitStubEnvelope, finalReviewErrorCode, finalReviewNextActions } from './final-review-command-envelopes.js';
|
|
20
|
+
function validateProjectRoot(projectArg) {
|
|
21
|
+
const projectRoot = resolve(projectArg);
|
|
22
|
+
if (!existsSync(projectRoot)) {
|
|
23
|
+
return {
|
|
24
|
+
ok: false,
|
|
25
|
+
code: 'PROJECT_NOT_FOUND',
|
|
26
|
+
message: `project path does not exist: ${projectArg}`
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
let stat;
|
|
30
|
+
try {
|
|
31
|
+
stat = statSync(projectRoot);
|
|
32
|
+
}
|
|
33
|
+
catch (error) {
|
|
34
|
+
return { ok: false, code: 'INVALID_PROJECT', message: getErrorMessage(error) };
|
|
35
|
+
}
|
|
36
|
+
if (!stat.isDirectory()) {
|
|
37
|
+
return {
|
|
38
|
+
ok: false,
|
|
39
|
+
code: 'INVALID_PROJECT',
|
|
40
|
+
message: `project path is not a directory: ${projectArg}`
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
return { ok: true, projectRoot };
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Validate the session id. Rejects empty, path-traversal (`..`), and
|
|
47
|
+
* any segment separator (`/`, `\`) so the caller cannot escape
|
|
48
|
+
* `.peaks/_runtime/<sessionId>/audit-goal/` via CLI flags.
|
|
49
|
+
*/
|
|
50
|
+
function validateSessionId(sessionId) {
|
|
51
|
+
if (sessionId.length === 0) {
|
|
52
|
+
return {
|
|
53
|
+
ok: false,
|
|
54
|
+
code: 'MISSING_REQUIRED_FLAG',
|
|
55
|
+
message: '`--session-id` is required and must be a non-empty string'
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
if (sessionId.includes('..') || sessionId.includes('/') || sessionId.includes('\\')) {
|
|
59
|
+
return {
|
|
60
|
+
ok: false,
|
|
61
|
+
code: 'INVALID_SESSION_ID',
|
|
62
|
+
message: '`--session-id` must not contain path-traversal or path-separator characters (rejected: "..", "/", "\\")'
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
return { ok: true, sessionId };
|
|
66
|
+
}
|
|
67
|
+
/** The refusal for an audit goal the pre-flight did not find on disk. */
|
|
68
|
+
function auditGoalMissingRefusal(rid, sessionId, auditGoalPath) {
|
|
69
|
+
return {
|
|
70
|
+
rid,
|
|
71
|
+
code: 'AUDIT_GOAL_NOT_FOUND',
|
|
72
|
+
message: `audit-goal file not found at expected path: ${auditGoalPath}`,
|
|
73
|
+
sessionId,
|
|
74
|
+
auditGoalPath,
|
|
75
|
+
nextActions: [
|
|
76
|
+
'Run `peaks audit goal --project <path> --need <text>` first to produce the approved goal JSON.',
|
|
77
|
+
'Confirm `--session-id` matches the session that wrote the goal.'
|
|
78
|
+
]
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Resolve the audit-goal path, or the refusal that replaces it.
|
|
83
|
+
*
|
|
84
|
+
* The `rid` axis is checked HERE, at the join: the rid is the CLI positional
|
|
85
|
+
* and it is the FILENAME segment, so the `--session-id` validation does not
|
|
86
|
+
* cover it (added 2026-09-14, repair R1 — a second-slot hole, found by the
|
|
87
|
+
* widened rule D rather than by a human reading the file).
|
|
88
|
+
*
|
|
89
|
+
* The audit-goal existence pre-flight sits here too, so the caller learns the
|
|
90
|
+
* real reason its request cannot proceed BEFORE the provider check.
|
|
91
|
+
*/
|
|
92
|
+
function resolveAuditGoalPath(rid, options, projectRoot) {
|
|
93
|
+
const sessionValidation = validateSessionId(options.sessionId);
|
|
94
|
+
if (!sessionValidation.ok) {
|
|
95
|
+
return {
|
|
96
|
+
rid,
|
|
97
|
+
code: sessionValidation.code,
|
|
98
|
+
message: sessionValidation.message,
|
|
99
|
+
sessionId: options.sessionId,
|
|
100
|
+
auditGoalPath: '',
|
|
101
|
+
nextActions: [
|
|
102
|
+
'Pass a non-empty `--session-id` whose value is a single segment (no "..", "/", or "\\")'
|
|
103
|
+
]
|
|
104
|
+
};
|
|
105
|
+
}
|
|
106
|
+
if (!REQUEST_ID_PATTERN.test(rid)) {
|
|
107
|
+
return {
|
|
108
|
+
rid,
|
|
109
|
+
code: 'RID_INVALID',
|
|
110
|
+
message: `Invalid request id: ${rid} (expected letters, digits, dots, underscores, or dashes)`,
|
|
111
|
+
sessionId: sessionValidation.sessionId,
|
|
112
|
+
auditGoalPath: '',
|
|
113
|
+
nextActions: ['Pass the rid of the slice, e.g. 2026-09-14-some-slug']
|
|
114
|
+
};
|
|
115
|
+
}
|
|
116
|
+
const auditGoalPath = join(projectRoot, '.peaks', '_runtime', sessionValidation.sessionId, 'audit-goal', `${rid}.json`);
|
|
117
|
+
if (!existsSync(auditGoalPath)) {
|
|
118
|
+
return auditGoalMissingRefusal(rid, sessionValidation.sessionId, auditGoalPath);
|
|
119
|
+
}
|
|
120
|
+
return { projectRoot, sessionId: sessionValidation.sessionId, auditGoalPath };
|
|
121
|
+
}
|
|
122
|
+
/** Resolve the three inputs the run needs, or the refusal that replaces them. */
|
|
123
|
+
function resolvePrepareInputs(rid, options) {
|
|
124
|
+
const projectValidation = validateProjectRoot(options.project);
|
|
125
|
+
if (!projectValidation.ok) {
|
|
126
|
+
return {
|
|
127
|
+
rid,
|
|
128
|
+
code: projectValidation.code,
|
|
129
|
+
message: projectValidation.message,
|
|
130
|
+
sessionId: options.sessionId,
|
|
131
|
+
auditGoalPath: '',
|
|
132
|
+
nextActions: ['Verify the project path exists and is a directory']
|
|
133
|
+
};
|
|
134
|
+
}
|
|
135
|
+
return resolveAuditGoalPath(rid, options, projectValidation.projectRoot);
|
|
136
|
+
}
|
|
137
|
+
function isRefusal(value) {
|
|
138
|
+
return !('projectRoot' in value);
|
|
139
|
+
}
|
|
140
|
+
/**
|
|
141
|
+
* The `token-usage` emission owner: the one site where a completed review's
|
|
142
|
+
* token counts and the session binding are both in scope. Fire-and-forget —
|
|
143
|
+
* `emitTokenUsageEvent` never throws, and this never blocks or fails the review
|
|
144
|
+
* it reports on.
|
|
145
|
+
*
|
|
146
|
+
* `source` defaults to `'provider'` only for a runner that states neither: the
|
|
147
|
+
* real runner always tags its counts (`anthropic-runner.ts` `tokenCounts`), so
|
|
148
|
+
* the default is reached by a test fake, not by a production call.
|
|
149
|
+
*/
|
|
150
|
+
function emitReviewTokenUsage(inputs, tokens) {
|
|
151
|
+
emitTokenUsageEvent({
|
|
152
|
+
projectRoot: inputs.projectRoot,
|
|
153
|
+
sessionId: inputs.sessionId,
|
|
154
|
+
inputTokens: tokens.input,
|
|
155
|
+
outputTokens: tokens.output,
|
|
156
|
+
source: tokens.source ?? 'provider'
|
|
157
|
+
});
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
* Real provider path: bind a real `LlmRunner` and run the service.
|
|
161
|
+
*
|
|
162
|
+
* Binding happens INSIDE the try so an absent credential surfaces as
|
|
163
|
+
* `LlmBindingError`'s own code instead of escaping as a crash. No envelope is
|
|
164
|
+
* emitted on that path — a "successful" empty review would be worse than an
|
|
165
|
+
* error.
|
|
166
|
+
*/
|
|
167
|
+
async function runRealReview(io, rid, inputs, options) {
|
|
168
|
+
const { json } = options;
|
|
169
|
+
try {
|
|
170
|
+
const config = resolveAnthropicConfig();
|
|
171
|
+
const llmRunner = createAnthropicRunner(config);
|
|
172
|
+
const review = await prepareFinalReview(rid, {
|
|
173
|
+
projectRoot: inputs.projectRoot,
|
|
174
|
+
sessionId: inputs.sessionId,
|
|
175
|
+
llmRunner,
|
|
176
|
+
...(options.base === undefined ? {} : { baseRef: options.base }),
|
|
177
|
+
onLlmTokens: (tokens) => emitReviewTokenUsage(inputs, tokens)
|
|
178
|
+
});
|
|
179
|
+
emitReviewEnvelope(io, { rid, goal: inputs, model: config.model, review, json });
|
|
180
|
+
}
|
|
181
|
+
catch (error) {
|
|
182
|
+
const code = finalReviewErrorCode(error);
|
|
183
|
+
emitPrepareFailure(io, json, {
|
|
184
|
+
rid,
|
|
185
|
+
code,
|
|
186
|
+
message: getErrorMessage(error),
|
|
187
|
+
sessionId: inputs.sessionId,
|
|
188
|
+
auditGoalPath: inputs.auditGoalPath,
|
|
189
|
+
nextActions: finalReviewNextActions(code)
|
|
190
|
+
}, error instanceof LlmBindingError ? error.missingEnv : undefined);
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
export async function runPrepareFinalReview(rid, options, io) {
|
|
194
|
+
const inputs = resolvePrepareInputs(rid, options);
|
|
195
|
+
if (isRefusal(inputs)) {
|
|
196
|
+
emitPrepareFailure(io, options.json, inputs);
|
|
197
|
+
return;
|
|
198
|
+
}
|
|
199
|
+
// Unknown provider names fail loudly — a silent fallback to `stub` would hand
|
|
200
|
+
// the caller a scaffold envelope that reads as a review route, which is the
|
|
201
|
+
// defect class this gate exists to stop.
|
|
202
|
+
const provider = options.llmProvider ?? DEFAULT_LLM_PROVIDER;
|
|
203
|
+
if (!isSupportedLlmProvider(provider)) {
|
|
204
|
+
emitPrepareFailure(io, options.json, {
|
|
205
|
+
rid,
|
|
206
|
+
code: 'LLM_PROVIDER_NOT_IMPLEMENTED',
|
|
207
|
+
message: `LLM provider "${provider}" is not implemented. Supported providers: ${SUPPORTED_LLM_PROVIDERS.join(', ')}.`,
|
|
208
|
+
sessionId: inputs.sessionId,
|
|
209
|
+
auditGoalPath: inputs.auditGoalPath,
|
|
210
|
+
nextActions: [
|
|
211
|
+
`Re-run with \`--llm-provider anthropic\` for a real 4-dim review, or \`--llm-provider ${DEFAULT_LLM_PROVIDER}\` for an offline scaffold.`
|
|
212
|
+
]
|
|
213
|
+
});
|
|
214
|
+
return;
|
|
215
|
+
}
|
|
216
|
+
if (provider === 'stub') {
|
|
217
|
+
emitStubEnvelope(io, rid, inputs, options.json);
|
|
218
|
+
return;
|
|
219
|
+
}
|
|
220
|
+
await runRealReview(io, rid, inputs, options);
|
|
221
|
+
}
|
|
@@ -149,9 +149,9 @@ export function emitAllowSkipped(io, options) {
|
|
|
149
149
|
}
|
|
150
150
|
/**
|
|
151
151
|
* Hard block: a worktree-mutating tool call without a current-task user grant. emitBlock writes
|
|
152
|
-
* the Claude Code permissionDecision:"deny" envelope and exits 2. The reason
|
|
153
|
-
* remediation hint
|
|
154
|
-
* read the deny text in the next-turn stderr.
|
|
152
|
+
* the Claude Code permissionDecision:"deny" envelope and exits 2. The reason carries the
|
|
153
|
+
* remediation hint from `worktree-refusal-messages.ts`, which names the USER-side path — the
|
|
154
|
+
* grant is not the agent's to issue — and the user can read the deny text in the next-turn stderr.
|
|
155
155
|
*/
|
|
156
156
|
function emitWorktreeDeny(io, options, wtDecision) {
|
|
157
157
|
emitBlock(io, `[worktree-gate:${wtDecision.code}] ${wtDecision.reason} — ${wtDecision.remediation}`);
|
|
@@ -1,18 +1,32 @@
|
|
|
1
1
|
/**
|
|
2
|
+
* The `peaks contract` / `peaks classify` entry point.
|
|
2
3
|
*
|
|
3
4
|
* Pre-merge originals (now deleted):
|
|
4
|
-
* - src/cli/commands/contract-commands.ts
|
|
5
|
+
* - src/cli/commands/contract-commands.ts (167 lines)
|
|
5
6
|
* - src/cli/commands/classify-classify-commands.ts (190 lines)
|
|
6
7
|
*
|
|
7
|
-
* Both
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
8
|
+
* Both `register*Commands` functions are preserved **verbatim** (function name,
|
|
9
|
+
* signature, body). The merge was a structural refactor only — no behavior
|
|
10
|
+
* change — and `autoRegisterAllCommands` discovers both exports from this single
|
|
11
|
+
* file. This module is now the entry point and no longer holds the verbs:
|
|
11
12
|
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
13
|
+
* `contract-write-command.ts` `peaks contract write`
|
|
14
|
+
* `classify-run-command.ts` `peaks classify run`
|
|
15
|
+
* `classify-downgrade-command.ts` `peaks classify downgrade` (always refused)
|
|
16
|
+
* `classify-signals.ts` the diff signals + the audit log
|
|
14
17
|
*/
|
|
15
18
|
import type { Command } from 'commander';
|
|
16
|
-
import {
|
|
17
|
-
export
|
|
19
|
+
import type { ProgramIO } from '../cli-helpers.js';
|
|
20
|
+
export { registerContractCommands } from './contract-write-command.js';
|
|
21
|
+
/**
|
|
22
|
+
* peaks classify CLI (Slice L1a + L1b).
|
|
23
|
+
*
|
|
24
|
+
* Subcommands:
|
|
25
|
+
* - peaks classify run --project <path> [--override <level> --reason "<text>"]
|
|
26
|
+
* Classify the current diff via the heuristic + return a JSON envelope
|
|
27
|
+
* with the chosen level, gate set, and audit log.
|
|
28
|
+
* - peaks classify downgrade --level <level> --reason "<text>" --project <path>
|
|
29
|
+
* Always refused (per spec §4: "peaks classify downgrade" always errors
|
|
30
|
+
* out). LLM may ask; the CLI never grants.
|
|
31
|
+
*/
|
|
18
32
|
export declare function registerClassifyCommands(program: Command, io: ProgramIO): void;
|
|
@@ -1,281 +1,38 @@
|
|
|
1
1
|
/**
|
|
2
|
+
* The `peaks contract` / `peaks classify` entry point.
|
|
2
3
|
*
|
|
3
4
|
* Pre-merge originals (now deleted):
|
|
4
|
-
* - src/cli/commands/contract-commands.ts
|
|
5
|
+
* - src/cli/commands/contract-commands.ts (167 lines)
|
|
5
6
|
* - src/cli/commands/classify-classify-commands.ts (190 lines)
|
|
6
7
|
*
|
|
7
|
-
* Both
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
8
|
+
* Both `register*Commands` functions are preserved **verbatim** (function name,
|
|
9
|
+
* signature, body). The merge was a structural refactor only — no behavior
|
|
10
|
+
* change — and `autoRegisterAllCommands` discovers both exports from this single
|
|
11
|
+
* file. This module is now the entry point and no longer holds the verbs:
|
|
11
12
|
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
13
|
+
* `contract-write-command.ts` `peaks contract write`
|
|
14
|
+
* `classify-run-command.ts` `peaks classify run`
|
|
15
|
+
* `classify-downgrade-command.ts` `peaks classify downgrade` (always refused)
|
|
16
|
+
* `classify-signals.ts` the diff signals + the audit log
|
|
17
|
+
*/
|
|
18
|
+
import { registerClassifyDowngradeCommand } from './classify-downgrade-command.js';
|
|
19
|
+
import { registerClassifyRunCommand } from './classify-run-command.js';
|
|
20
|
+
export { registerContractCommands } from './contract-write-command.js';
|
|
21
|
+
/**
|
|
22
|
+
* peaks classify CLI (Slice L1a + L1b).
|
|
23
|
+
*
|
|
24
|
+
* Subcommands:
|
|
25
|
+
* - peaks classify run --project <path> [--override <level> --reason "<text>"]
|
|
26
|
+
* Classify the current diff via the heuristic + return a JSON envelope
|
|
27
|
+
* with the chosen level, gate set, and audit log.
|
|
28
|
+
* - peaks classify downgrade --level <level> --reason "<text>" --project <path>
|
|
29
|
+
* Always refused (per spec §4: "peaks classify downgrade" always errors
|
|
30
|
+
* out). LLM may ask; the CLI never grants.
|
|
14
31
|
*/
|
|
15
|
-
// ===========================================================================
|
|
16
|
-
// Shared imports (consolidated; both originals pulled names from these
|
|
17
|
-
// same modules — `cli-helpers.ts` re-exports `getErrorMessage` from
|
|
18
|
-
// `peaks-loop-shared/result`, so the single canonical import is
|
|
19
|
-
// functionally identical to either original line.)
|
|
20
|
-
// ===========================================================================
|
|
21
|
-
import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
|
22
|
-
import { join } from 'node:path';
|
|
23
|
-
import { fail, ok, getErrorMessage } from 'peaks-loop-shared/result';
|
|
24
|
-
import { addJsonOption, printResult } from '../cli-helpers.js';
|
|
25
|
-
import { writeContract } from '../../services/dispatch/contract-store.js';
|
|
26
|
-
import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
|
|
27
|
-
import { classifyTask } from '../../services/classify/classify-service.js';
|
|
28
|
-
import { TASK_LEVELS } from '../../services/classify/classify-types.js';
|
|
29
|
-
import { loadPreferences } from '../../services/preferences/preferences-service.js';
|
|
30
|
-
// ===========================================================================
|
|
31
|
-
// Section 1: `peaks contract` CLI commands (was contract-commands.ts).
|
|
32
|
-
// ===========================================================================
|
|
33
|
-
const INPUT_LIMIT_BYTES = 256 * 1024;
|
|
34
|
-
/** Split a comma-separated flag value into a trimmed string array. */
|
|
35
|
-
function splitCsv(value) {
|
|
36
|
-
if (value === undefined)
|
|
37
|
-
return [];
|
|
38
|
-
return value
|
|
39
|
-
.split(',')
|
|
40
|
-
.map((s) => s.trim())
|
|
41
|
-
.filter((s) => s.length > 0);
|
|
42
|
-
}
|
|
43
|
-
export function registerContractCommands(program, io) {
|
|
44
|
-
const contract = program
|
|
45
|
-
.command('contract')
|
|
46
|
-
.description('Slice contract store (skill-first / CLI-auxiliary). These commands ' +
|
|
47
|
-
'are primitives that peaks-code / peaks-rd SKILL.md compose. The LLM-side ' +
|
|
48
|
-
'runner (the IDE-resident sub-agent that finished a slice) calls ' +
|
|
49
|
-
"`peaks contract write` to persist the slice's public surface; the " +
|
|
50
|
-
'orchestrator picks it up on the next dispatch run via listContracts() ' +
|
|
51
|
-
'and splices it into downstream prompts via formatContractInjection().');
|
|
52
|
-
// ─────────────────────────────────────────────────────────────────
|
|
53
|
-
// peaks contract write --project <root> --session-id <sid>
|
|
54
|
-
// --slice-id <id> --exports <a,b> --types <x,y> --signatures <s1,s2>
|
|
55
|
-
// [--broadcast-to <b1,b2>] [--completed-at <iso>]
|
|
56
|
-
// ─────────────────────────────────────────────────────────────────
|
|
57
|
-
addJsonOption(contract
|
|
58
|
-
.command('write')
|
|
59
|
-
.description("2.7.0 slice-dag-dispatcher MVP: persist a finished slice's public " +
|
|
60
|
-
'surface (exports / types / publicSignatures) to disk at ' +
|
|
61
|
-
'.peaks/_runtime/<sessionId>/dispatch/contracts/<slice-id>.json. ' +
|
|
62
|
-
'The orchestrator picks it up on the next dispatch run. Idempotent: ' +
|
|
63
|
-
're-running with the same inputs overwrites in place; the SHA-256 ' +
|
|
64
|
-
'contractHash is content-derived so a contract write from a different ' +
|
|
65
|
-
'runner (re-execution) is detected as a content change.')
|
|
66
|
-
.option('--project <path>', 'target project root (defaults to cwd)')
|
|
67
|
-
.option('--session-id <sid>', 'session id (default: resolve from .peaks/_runtime/session.json; falls back to PEAKS_SESSION_ID env var; final fallback "unknown-sid")')
|
|
68
|
-
.requiredOption('--slice-id <id>', 'slice id; must be non-empty; used as the contract filename basename')
|
|
69
|
-
.option('--exports <list>', 'comma-separated public export names (e.g. "validateDag,topologicalLevels")')
|
|
70
|
-
.option('--types <list>', 'comma-separated public type names (e.g. "SliceDag,SliceNode")')
|
|
71
|
-
.option('--signatures <list>', 'comma-separated public function/method signatures (e.g. "validateDag(dag: SliceDag): void")')
|
|
72
|
-
.option('--broadcast-to <list>', 'comma-separated downstream slice ids that should auto-inherit this contract (e.g. "B,C")')
|
|
73
|
-
.option('--completed-at <iso>', 'ISO 8601 timestamp; defaults to now()')).action((options) => {
|
|
74
|
-
const asJson = options.json === true;
|
|
75
|
-
const projectRoot = options.project ?? process.cwd();
|
|
76
|
-
const sid = options.sessionId ??
|
|
77
|
-
process.env.PEAKS_SESSION_ID ??
|
|
78
|
-
getCurrentSessionId(projectRoot) ??
|
|
79
|
-
'unknown-sid';
|
|
80
|
-
const sliceId = options.sliceId;
|
|
81
|
-
if (sliceId === undefined || sliceId.length === 0) {
|
|
82
|
-
printResult(io, fail('contract.write', 'MISSING_SLICE_ID', '--slice-id is required', { path: null, contract: null }, [
|
|
83
|
-
'Re-run with --slice-id <id> (must be non-empty; used as the contract filename basename).'
|
|
84
|
-
]), asJson);
|
|
85
|
-
process.exitCode = 1;
|
|
86
|
-
return;
|
|
87
|
-
}
|
|
88
|
-
const exports = splitCsv(options.exports);
|
|
89
|
-
const types = splitCsv(options.types);
|
|
90
|
-
const signatures = splitCsv(options.signatures);
|
|
91
|
-
const broadcastTo = splitCsv(options.broadcastTo);
|
|
92
|
-
// Cap the combined input to protect the file IO from runaway values
|
|
93
|
-
// (e.g. a 10MB comma-separated --signatures flag).
|
|
94
|
-
const inputSize = sliceId.length +
|
|
95
|
-
sid.length +
|
|
96
|
-
exports.join(',').length +
|
|
97
|
-
types.join(',').length +
|
|
98
|
-
signatures.join(',').length +
|
|
99
|
-
broadcastTo.join(',').length +
|
|
100
|
-
(options.completedAt?.length ?? 0);
|
|
101
|
-
if (inputSize > INPUT_LIMIT_BYTES) {
|
|
102
|
-
printResult(io, fail('contract.write', 'INPUT_TOO_LARGE', `combined input size ${inputSize} bytes exceeds ${INPUT_LIMIT_BYTES} (likely oversized --exports/--types/--signatures lists)`, { path: null, contract: null }, ['Split the slice into smaller surfaces or omit optional fields.']), asJson);
|
|
103
|
-
process.exitCode = 1;
|
|
104
|
-
return;
|
|
105
|
-
}
|
|
106
|
-
try {
|
|
107
|
-
const input = {
|
|
108
|
-
sliceId,
|
|
109
|
-
sessionId: sid,
|
|
110
|
-
exports,
|
|
111
|
-
types,
|
|
112
|
-
publicSignatures: signatures,
|
|
113
|
-
...(broadcastTo.length > 0 ? { broadcastTo } : {}),
|
|
114
|
-
...(options.completedAt !== undefined ? { completedAt: options.completedAt } : {})
|
|
115
|
-
};
|
|
116
|
-
const result = writeContract(projectRoot, sid, input);
|
|
117
|
-
printResult(io, ok('contract.write', {
|
|
118
|
-
path: result.path,
|
|
119
|
-
contractHash: result.contract.contractHash,
|
|
120
|
-
sliceId: result.contract.sliceId,
|
|
121
|
-
sessionId: result.contract.sessionId,
|
|
122
|
-
completedAt: result.contract.completedAt,
|
|
123
|
-
exportCount: result.contract.exports.length,
|
|
124
|
-
typeCount: result.contract.types.length,
|
|
125
|
-
signatureCount: result.contract.publicSignatures.length,
|
|
126
|
-
broadcastTo: result.contract.broadcastTo ?? []
|
|
127
|
-
}, [], [
|
|
128
|
-
`Contract written; orchestrator will pick it up on the next \`peaks sub-agent dispatch --from-dag\` run.`,
|
|
129
|
-
`Re-running with the same inputs is idempotent (overwrites in place).`
|
|
130
|
-
]), asJson);
|
|
131
|
-
}
|
|
132
|
-
catch (err) {
|
|
133
|
-
printResult(io, fail('contract.write', 'WRITE_ERROR', getErrorMessage(err), { path: null, contract: null }, [
|
|
134
|
-
'See error message; check that --project is a writable directory and --slice-id is a valid filename basename (no path separators).'
|
|
135
|
-
]), asJson);
|
|
136
|
-
process.exitCode = 1;
|
|
137
|
-
}
|
|
138
|
-
});
|
|
139
|
-
}
|
|
140
|
-
const CLASSIFY_AUDIT_FILE = 'classify-audit.jsonl';
|
|
141
|
-
function getSignalsFromGitDiff(projectRoot) {
|
|
142
|
-
// Use git diff --stat to extract file count + line count. Fall back to
|
|
143
|
-
// zeros if git is unavailable (e.g. fresh repo with no commits).
|
|
144
|
-
let stdout;
|
|
145
|
-
try {
|
|
146
|
-
const { execFileSync } = require('node:child_process');
|
|
147
|
-
stdout = execFileSync('git', ['diff', '--shortstat', 'HEAD'], {
|
|
148
|
-
cwd: projectRoot,
|
|
149
|
-
stdio: ['ignore', 'pipe', 'ignore'],
|
|
150
|
-
maxBuffer: 32 * 1024 * 1024,
|
|
151
|
-
windowsHide: true
|
|
152
|
-
}).toString('utf8');
|
|
153
|
-
}
|
|
154
|
-
catch {
|
|
155
|
-
return {
|
|
156
|
-
filesChanged: 0,
|
|
157
|
-
linesChanged: 0,
|
|
158
|
-
touchesDependencies: false,
|
|
159
|
-
touchesMigrationScripts: false,
|
|
160
|
-
isPureRefactor: true,
|
|
161
|
-
keywords: []
|
|
162
|
-
};
|
|
163
|
-
}
|
|
164
|
-
const lines = stdout.split('\n').filter((l) => l.trim().length > 0);
|
|
165
|
-
const filesChanged = lines.length;
|
|
166
|
-
let added = 0;
|
|
167
|
-
let removed = 0;
|
|
168
|
-
let touchesDependencies = false;
|
|
169
|
-
let touchesMigrationScripts = false;
|
|
170
|
-
for (const line of lines) {
|
|
171
|
-
const match = /(\d+)\s+insertion.*?(\d+)\s+deletion/.exec(line);
|
|
172
|
-
if (match) {
|
|
173
|
-
added += Number(match[1]);
|
|
174
|
-
removed += Number(match[2]);
|
|
175
|
-
}
|
|
176
|
-
if (/(package\.json|pnpm-lock\.yaml|yarn\.lock|requirements\.txt|go\.mod)/.test(line)) {
|
|
177
|
-
touchesDependencies = true;
|
|
178
|
-
}
|
|
179
|
-
if (/(migrate|codemod|backfill|schema)/.test(line)) {
|
|
180
|
-
touchesMigrationScripts = true;
|
|
181
|
-
}
|
|
182
|
-
}
|
|
183
|
-
// isPureRefactor: heuristic — if added lines / removed lines < 0.1 OR
|
|
184
|
-
// no new exports were added, treat as refactor. For L2.2 the signal is
|
|
185
|
-
// binary (true/false). Default: true (no behavior change is the safe
|
|
186
|
-
// assumption; flip to false when keyword 'add' / 'new' / 'feature' present).
|
|
187
|
-
const isPureRefactor = true;
|
|
188
|
-
return {
|
|
189
|
-
filesChanged,
|
|
190
|
-
linesChanged: added + removed,
|
|
191
|
-
touchesDependencies,
|
|
192
|
-
touchesMigrationScripts,
|
|
193
|
-
isPureRefactor,
|
|
194
|
-
keywords: []
|
|
195
|
-
};
|
|
196
|
-
}
|
|
197
|
-
function appendAuditEntry(projectRoot, entry) {
|
|
198
|
-
const auditDir = join(projectRoot, '.peaks/_runtime');
|
|
199
|
-
if (!existsSync(auditDir)) {
|
|
200
|
-
try {
|
|
201
|
-
mkdirSync(auditDir, { recursive: true });
|
|
202
|
-
}
|
|
203
|
-
catch {
|
|
204
|
-
/* ignore */
|
|
205
|
-
} // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
|
|
206
|
-
}
|
|
207
|
-
const auditPath = join(auditDir, CLASSIFY_AUDIT_FILE);
|
|
208
|
-
let body = '';
|
|
209
|
-
try {
|
|
210
|
-
if (existsSync(auditPath)) {
|
|
211
|
-
body = readFileSync(auditPath, 'utf8');
|
|
212
|
-
}
|
|
213
|
-
}
|
|
214
|
-
catch {
|
|
215
|
-
/* ignore */
|
|
216
|
-
} // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
|
|
217
|
-
body += JSON.stringify(entry) + '\n';
|
|
218
|
-
try {
|
|
219
|
-
writeFileSync(auditPath, body);
|
|
220
|
-
}
|
|
221
|
-
catch {
|
|
222
|
-
/* best-effort */
|
|
223
|
-
} // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
|
|
224
|
-
}
|
|
225
|
-
function isTaskLevel(value) {
|
|
226
|
-
return TASK_LEVELS.includes(value);
|
|
227
|
-
}
|
|
228
32
|
export function registerClassifyCommands(program, io) {
|
|
229
33
|
const classify = program
|
|
230
34
|
.command('classify')
|
|
231
35
|
.description('L1a task classification: 5-level heuristic (typo/bug/feature/refactor/migration) + override/upgrade + audit log');
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
.description('Classify the current diff (git diff HEAD) into one of 5 task levels')
|
|
235
|
-
.requiredOption('--project <path>', 'target project root')
|
|
236
|
-
.option('--override <level>', 'force a level (one of typo|bug|feature|refactor|migration); requires --reason')
|
|
237
|
-
.option('--reason <text>', 'reason for the override (mandatory when --override is set)')).action(async (options) => {
|
|
238
|
-
try {
|
|
239
|
-
const prefs = await loadPreferences(options.project);
|
|
240
|
-
const signals = getSignalsFromGitDiff(options.project);
|
|
241
|
-
let override;
|
|
242
|
-
if (options.override !== undefined) {
|
|
243
|
-
if (!isTaskLevel(options.override)) {
|
|
244
|
-
printResult(io, fail('classify.run', 'INVALID_LEVEL', `level must be one of: ${TASK_LEVELS.join(', ')}`, { provided: options.override }, ['Pass one of typo, bug, feature, refactor, migration']), options.json);
|
|
245
|
-
process.exitCode = 1;
|
|
246
|
-
return;
|
|
247
|
-
}
|
|
248
|
-
if (options.reason === undefined || options.reason.length === 0) {
|
|
249
|
-
printResult(io, fail('classify.run', 'REASON_REQUIRED', '--reason is required when --override is set', {}, ['Provide a non-empty reason for the override']), options.json);
|
|
250
|
-
process.exitCode = 1;
|
|
251
|
-
return;
|
|
252
|
-
}
|
|
253
|
-
override = { level: options.override, reason: options.reason };
|
|
254
|
-
}
|
|
255
|
-
const result = classifyTask(override !== undefined
|
|
256
|
-
? { signals, conservatism: prefs.classifyConservatism, override }
|
|
257
|
-
: { signals, conservatism: prefs.classifyConservatism }, prefs.classifyRules.feature_threshold_files, prefs.classifyRules.feature_threshold_lines);
|
|
258
|
-
appendAuditEntry(options.project, result.audit);
|
|
259
|
-
printResult(io, ok('classify.run', result, [], [
|
|
260
|
-
`gate set for level "${result.level}": ${result.gateSet.stages.join(', ')}`,
|
|
261
|
-
`audit log: .peaks/_runtime/${CLASSIFY_AUDIT_FILE}`
|
|
262
|
-
]), options.json);
|
|
263
|
-
}
|
|
264
|
-
catch (error) {
|
|
265
|
-
printResult(io, fail('classify.run', 'CLASSIFY_RUN_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Run peaks classify --help for usage']), options.json);
|
|
266
|
-
process.exitCode = 1;
|
|
267
|
-
}
|
|
268
|
-
});
|
|
269
|
-
// Downgrade is REFUSED per spec §4. Surface this as a hard fail.
|
|
270
|
-
classify
|
|
271
|
-
.command('downgrade')
|
|
272
|
-
.description('REFUSED per spec §4 — peaks-loop never downgrades a classification; ask the user to override explicitly')
|
|
273
|
-
.requiredOption('--level <level>', 'attempted level')
|
|
274
|
-
.requiredOption('--reason <text>', 'reason for the attempt (always rejected)')
|
|
275
|
-
.requiredOption('--project <path>', 'target project root')
|
|
276
|
-
.option('--json', 'print machine-readable JSON envelope')
|
|
277
|
-
.action((options) => {
|
|
278
|
-
printResult(io, fail('classify.downgrade', 'DOWNGRADE_REFUSED', 'peaks classify downgrade is refused per spec §4. Use --override (with reason) on `classify run` to force a level; the CLI never downgrades a classification unilaterally.', { attemptedLevel: options.level, reason: options.reason }, ['Use `peaks classify run --override <level> --reason "<text>"` instead']), options.json);
|
|
279
|
-
process.exitCode = 2;
|
|
280
|
-
});
|
|
36
|
+
registerClassifyRunCommand(classify, io);
|
|
37
|
+
registerClassifyDowngradeCommand(classify, io);
|
|
281
38
|
}
|
|
@@ -5,7 +5,7 @@ import { getAdapter } from '../../services/ide/ide-registry.js';
|
|
|
5
5
|
import { evaluateCodeBan } from '../../services/audit/enforcers/code-ban.js';
|
|
6
6
|
import { isRootWrite } from '../../services/audit/enforcers/no-root-pollution.js';
|
|
7
7
|
import { checkLoginGate } from '../../services/audit/enforcers/login-gate.js';
|
|
8
|
-
import { resolveActiveSkillForCaller } from '../../services/audit/enforcers/active-skill-resolver.js';
|
|
8
|
+
import { hasLeaseForCaller, hasPeaksLeaseInSession, resolveActiveSkillForCaller } from '../../services/audit/enforcers/active-skill-resolver.js';
|
|
9
9
|
import { fail, ok } from 'peaks-loop-shared/result';
|
|
10
10
|
import { emitDecision, emitHint } from '../../services/hooks/output.js';
|
|
11
11
|
/**
|
|
@@ -98,26 +98,47 @@ export function registerHookHandleCommand(program, io) {
|
|
|
98
98
|
// The envelope shape (skill / callerId / sessionId / source) is
|
|
99
99
|
// unchanged from 4.0.7; the underlying source is now
|
|
100
100
|
// `canonical` for the lease + index path.
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
101
|
+
//
|
|
102
|
+
// Scoped to THIS caller: without a callerId the resolver returns
|
|
103
|
+
// whichever lease `readdirSync` yields first, so another window's skill
|
|
104
|
+
// would be applied here. The identity comes from the payload, not the
|
|
105
|
+
// environment — whether the hook subprocess inherits the
|
|
106
|
+
// caller-identifying env is unverified, and the payload already has it.
|
|
107
|
+
const callerId = pluckString(parsed, ['caller_id']) ?? pluckString(parsed, ['session_id']);
|
|
108
|
+
const identityAvailable = typeof callerId === 'string' && callerId.length > 0;
|
|
109
|
+
const callerHasLease = identityAvailable && hasLeaseForCaller(projectRoot, callerId);
|
|
110
|
+
// A scoped resolve answers for THIS caller only when this caller owns a
|
|
111
|
+
// lease. An id with no lease is ambiguous: either a caller with no peaks
|
|
112
|
+
// skill, or an id that is not the lease's key — and the harness does
|
|
113
|
+
// hand over a differing session id (skill-statusline-service.ts:100-103).
|
|
114
|
+
// The two are indistinguishable here, so that case keeps the unscoped
|
|
115
|
+
// answer, which denies, rather than turning a peaks commit into an allow.
|
|
116
|
+
const activeSkill = !identityAvailable
|
|
117
|
+
? { skill: null, callerId: null, sessionId: null, mode: null, source: 'none' }
|
|
118
|
+
: callerHasLease
|
|
119
|
+
? resolveActiveSkillForCaller(projectRoot, { callerId })
|
|
120
|
+
: resolveActiveSkillForCaller(projectRoot);
|
|
121
|
+
// Evaluated even when nothing resolved: the old `if (skill !== null)`
|
|
122
|
+
// guard meant an unresolved driver skipped the ban entirely.
|
|
123
|
+
const codeDecision = evaluateCodeBan({
|
|
124
|
+
skill: activeSkill.skill,
|
|
125
|
+
command: fallbackCommand,
|
|
126
|
+
peaksLeasePresent: hasPeaksLeaseInSession(projectRoot),
|
|
127
|
+
identityResolved: callerHasLease
|
|
128
|
+
});
|
|
129
|
+
if (codeDecision.denied) {
|
|
130
|
+
const formatted = formatDecisionResponse(ide, 'deny', codeDecision.reason);
|
|
131
|
+
emitDecision(io, formatted.stdout);
|
|
132
|
+
if (options.json === true) {
|
|
133
|
+
emitHint(io, JSON.stringify(ok('hook.handle', {
|
|
134
|
+
ide,
|
|
135
|
+
tool: hook.toolName,
|
|
136
|
+
decision: 'deny',
|
|
137
|
+
reason: codeDecision.reason,
|
|
138
|
+
enforcer: 'code-ban'
|
|
139
|
+
})));
|
|
120
140
|
}
|
|
141
|
+
return;
|
|
121
142
|
}
|
|
122
143
|
// Lazy import to avoid circular: peaks gate enforce logic
|
|
123
144
|
const { enforceBashCommand } = await import('../../services/sop/gate-enforce-service.js');
|