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,139 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The public type surface of the hooks settings service.
|
|
3
|
+
*
|
|
4
|
+
* Split out of `hooks-settings-service.ts` (file-size cap campaign). The
|
|
5
|
+
* service re-exports every name declared here, so existing importers keep
|
|
6
|
+
* using `./hooks-settings-service.js` unchanged.
|
|
7
|
+
*/
|
|
8
|
+
import type { IdeId } from '../ide/ide-types.js';
|
|
9
|
+
import type { HookScope } from '../ide/shared/safe-path.js';
|
|
10
|
+
import type { PeaksHookEntry } from './hooks-codegate-superpowers.js';
|
|
11
|
+
export type HookInstallOptions = {
|
|
12
|
+
/**
|
|
13
|
+
* Which IDE's adapter to install for. Defaults to `'claude-code'` for
|
|
14
|
+
* backward compatibility. The CLI command should resolve this from
|
|
15
|
+
* `detectIdeFromContext({ env, cwd, parsedStdin })` and pass the result.
|
|
16
|
+
* Throws if the IDE is not registered in the adapter registry.
|
|
17
|
+
*/
|
|
18
|
+
readonly ide?: IdeId;
|
|
19
|
+
/**
|
|
20
|
+
* Slice #013 (bugfix — peaks hooks install --no-progress): when `true`,
|
|
21
|
+
* skip emitting the progress-start PreToolUse hook entry while still
|
|
22
|
+
* installing the gate-enforce entry. The progress-start hook auto-spawns
|
|
23
|
+
* a new terminal running `peaks progress watch`; with dispatch +
|
|
24
|
+
* heartbeat (slice #009 + #010) that auto-spawn is dead weight. Default
|
|
25
|
+
* `false` preserves the pre-slice install shape (both entries). The
|
|
26
|
+
* sentinel-based install is idempotent: re-running with `skipProgress:
|
|
27
|
+
* true` over a settings.json that previously had the progress entry
|
|
28
|
+
* installed will remove that entry. `uninstall` honors the same flag
|
|
29
|
+
* so it can find and remove both entries when both are present and
|
|
30
|
+
* only the gate-enforce entry when only the gate-enforce is present.
|
|
31
|
+
*
|
|
32
|
+
* Slice #014 (refactor — full removal of legacy progress-start surface):
|
|
33
|
+
* the field is preserved for API stability, but the underlying
|
|
34
|
+
* install only ever emits the gate-enforce entry. The progress-start
|
|
35
|
+
* entry is no longer installed regardless of this flag's value. The
|
|
36
|
+
* legacy `peaks progress start|watch|close` CLI surface is gone
|
|
37
|
+
* (replaced by `peaks sub-agent dispatch|heartbeat|share`); the hook
|
|
38
|
+
* entry would have been pointing at a `peaks progress start` that no
|
|
39
|
+
* longer exists. The sentinel `peaks progress start` constant is still
|
|
40
|
+
* exported (some tests + back-compat reads rely on it) but no new
|
|
41
|
+
* hook entries use it.
|
|
42
|
+
*/
|
|
43
|
+
readonly skipProgress?: boolean;
|
|
44
|
+
};
|
|
45
|
+
/**
|
|
46
|
+
* One peaks-managed entry paired with the settings file it is (or will be)
|
|
47
|
+
* written to.
|
|
48
|
+
*
|
|
49
|
+
* `entries` is a flat list of the same matcher/sentinel pairs, which reads as
|
|
50
|
+
* "written to `settingsPath`" even when the entry is routed to the other file
|
|
51
|
+
* (see `resolveHookTargets`). This carries the routing explicitly so the
|
|
52
|
+
* dry-run can name the real target without a real run.
|
|
53
|
+
*/
|
|
54
|
+
export type HookEntryTarget = {
|
|
55
|
+
matcher: string;
|
|
56
|
+
sentinel: string;
|
|
57
|
+
settingsPath: string;
|
|
58
|
+
};
|
|
59
|
+
export type HookInstallPlan = {
|
|
60
|
+
scope: HookScope;
|
|
61
|
+
settingsPath: string;
|
|
62
|
+
exists: boolean;
|
|
63
|
+
alreadyInstalled: boolean;
|
|
64
|
+
desiredCommand: string;
|
|
65
|
+
sentinel: string;
|
|
66
|
+
matcher: string;
|
|
67
|
+
/**
|
|
68
|
+
* Machine-local, gitignored settings file that the gate-enforce entry is
|
|
69
|
+
* written to instead of `settingsPath`. Undefined when the IDE has no such
|
|
70
|
+
* file (or the scope is global, where the settings file is already
|
|
71
|
+
* machine-local). See `resolveHookTargets`.
|
|
72
|
+
*/
|
|
73
|
+
localSettingsPath?: string;
|
|
74
|
+
/** Every entry the install writes, paired with its target file. */
|
|
75
|
+
entryTargets: ReadonlyArray<HookEntryTarget>;
|
|
76
|
+
};
|
|
77
|
+
export type HookInstallResult = HookInstallPlan & {
|
|
78
|
+
applied: boolean;
|
|
79
|
+
};
|
|
80
|
+
export type HookRemoveResult = {
|
|
81
|
+
scope: HookScope;
|
|
82
|
+
settingsPath: string;
|
|
83
|
+
localSettingsPath?: string;
|
|
84
|
+
removed: boolean;
|
|
85
|
+
};
|
|
86
|
+
export type HookStatus = {
|
|
87
|
+
scope: HookScope;
|
|
88
|
+
settingsPath: string;
|
|
89
|
+
exists: boolean;
|
|
90
|
+
localSettingsPath?: string;
|
|
91
|
+
localExists?: boolean;
|
|
92
|
+
installed: boolean;
|
|
93
|
+
/**
|
|
94
|
+
* Whether this IDE can host a peaks hook AT ALL (`hasHookSpec`).
|
|
95
|
+
*
|
|
96
|
+
* `status` answers "what is on disk", and for an IDE with no
|
|
97
|
+
* `HOOK_COMMAND_BY_IDE` entry the answer is "nothing, and nothing ever will
|
|
98
|
+
* be" — which is a successful query returning a negative fact, not a failed
|
|
99
|
+
* one. The exit code says the query succeeded; this field says what it found.
|
|
100
|
+
* Without it `installed: false` would be indistinguishable from a supported
|
|
101
|
+
* IDE that simply has no hook installed yet, which is a state the user can
|
|
102
|
+
* act on.
|
|
103
|
+
*/
|
|
104
|
+
supportsHooks: boolean;
|
|
105
|
+
};
|
|
106
|
+
export type HookHandler = {
|
|
107
|
+
type?: string;
|
|
108
|
+
command?: string;
|
|
109
|
+
};
|
|
110
|
+
export type HookMatcherEntry = {
|
|
111
|
+
matcher?: string;
|
|
112
|
+
hooks?: HookHandler[];
|
|
113
|
+
};
|
|
114
|
+
/**
|
|
115
|
+
* A peaks-managed hook entry set grouped by the settings file that must
|
|
116
|
+
* carry it.
|
|
117
|
+
*
|
|
118
|
+
* Peaks hooks normally land in the adapter's settings file. The gate-enforce
|
|
119
|
+
* Bash entry is the exception: on Windows its `shell` must be pinned to
|
|
120
|
+
* `powershell`, because the default Git-Bash shell force-allocates a console
|
|
121
|
+
* window on every Bash tool call (MSYS2 behaviour — see the 2026-09-10
|
|
122
|
+
* hook-console finding). A machine-specific value must never be committed
|
|
123
|
+
* into the SHARED `.claude/settings.json` that a macOS/Linux teammate reads
|
|
124
|
+
* too, so that entry is materialized into the machine-local file instead.
|
|
125
|
+
* The routing decision is platform-independent (it keys off the entry's
|
|
126
|
+
* `machineLocal` flag, not off `process.platform`) so the shared file's
|
|
127
|
+
* content does not depend on which OS ran the install.
|
|
128
|
+
*/
|
|
129
|
+
export type HookTarget = {
|
|
130
|
+
settingsPath: string;
|
|
131
|
+
entries: PeaksHookEntry[];
|
|
132
|
+
/**
|
|
133
|
+
* When true this file also receives the third-party PreToolUse gate
|
|
134
|
+
* exemptions (`EXTERNAL_GATE_EXEMPT_ENV`). Claude Code only — `env` is a
|
|
135
|
+
* Claude Code settings key — and only ever on a machine-local file, never
|
|
136
|
+
* on the committed shared one.
|
|
137
|
+
*/
|
|
138
|
+
envExemptions?: boolean;
|
|
139
|
+
};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { SkillPresenceLease } from './presence-lease-types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Most recent lease first: `lastHeartbeat` desc, `startedAt` desc as the
|
|
4
|
+
* tie-break.
|
|
5
|
+
*
|
|
6
|
+
* The tie-break is not decorative. Nothing refreshes the on-disk heartbeat
|
|
7
|
+
* today — no caller runs `setPresenceLease` on a cadence — so `lastHeartbeat`
|
|
8
|
+
* frequently equals `startedAt`, and two leases written in the same millisecond
|
|
9
|
+
* tie on heartbeat alone. That tie then falls through to `Array.prototype.sort`
|
|
10
|
+
* stability, i.e. `readdirSync` order, which is the input this ordering exists
|
|
11
|
+
* to stop depending on.
|
|
12
|
+
*/
|
|
13
|
+
export declare function comparePresenceLeases(a: SkillPresenceLease, b: SkillPresenceLease): number;
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
// Shared ordering for a peaks session's presence leases.
|
|
2
|
+
//
|
|
3
|
+
// Lives on its own because the three readers that need it — the resolver, the
|
|
4
|
+
// statusline projection, and the per-caller legacy read — sit in three modules
|
|
5
|
+
// and none of them owns the other. They used to order the same lease set three
|
|
6
|
+
// ways (two by heartbeat alone, one with a tie-break), so they could name
|
|
7
|
+
// different leases as "who is driving".
|
|
8
|
+
/**
|
|
9
|
+
* Most recent lease first: `lastHeartbeat` desc, `startedAt` desc as the
|
|
10
|
+
* tie-break.
|
|
11
|
+
*
|
|
12
|
+
* The tie-break is not decorative. Nothing refreshes the on-disk heartbeat
|
|
13
|
+
* today — no caller runs `setPresenceLease` on a cadence — so `lastHeartbeat`
|
|
14
|
+
* frequently equals `startedAt`, and two leases written in the same millisecond
|
|
15
|
+
* tie on heartbeat alone. That tie then falls through to `Array.prototype.sort`
|
|
16
|
+
* stability, i.e. `readdirSync` order, which is the input this ordering exists
|
|
17
|
+
* to stop depending on.
|
|
18
|
+
*/
|
|
19
|
+
export function comparePresenceLeases(a, b) {
|
|
20
|
+
const byHeartbeat = (b.lastHeartbeat ?? '').localeCompare(a.lastHeartbeat ?? '');
|
|
21
|
+
if (byHeartbeat !== 0)
|
|
22
|
+
return byHeartbeat;
|
|
23
|
+
return (b.startedAt ?? '').localeCompare(a.startedAt ?? '');
|
|
24
|
+
}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { findProjectRoot } from '../config/config-safety.js';
|
|
2
2
|
import { getSessionIdCanonical } from '../session/session-manager.js';
|
|
3
3
|
import { resolveActiveSkillForCaller } from '../audit/enforcers/active-skill-resolver.js';
|
|
4
|
+
import { comparePresenceLeases } from './presence-lease-order.js';
|
|
4
5
|
import { listPresenceLeases } from './presence-lease-service.js';
|
|
5
6
|
import { read24hOverlay, readActiveLeaf, readCompactState, resolveCallerId, resolveCwdFromStdin } from './skill-statusline-model.js';
|
|
6
7
|
export { parseStatusLineStdin, read24hOverlay } from './skill-statusline-model.js';
|
|
@@ -101,13 +102,9 @@ function readPresenceReadOnly(projectRoot, callerId) {
|
|
|
101
102
|
if (inFlight.length === 0) {
|
|
102
103
|
return { presence: null, invalid: false };
|
|
103
104
|
}
|
|
104
|
-
// Most recent wins
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
if (hb !== 0)
|
|
108
|
-
return hb;
|
|
109
|
-
return b.startedAt.localeCompare(a.startedAt);
|
|
110
|
-
});
|
|
105
|
+
// Most recent wins, through the shared comparator so every reader of one
|
|
106
|
+
// lease set names the same lease.
|
|
107
|
+
const sorted = inFlight.slice().sort(comparePresenceLeases);
|
|
111
108
|
const latest = sorted[0];
|
|
112
109
|
if (latest === undefined || typeof latest.skill !== 'string' || latest.skill.length === 0) {
|
|
113
110
|
return { presence: null, invalid: false };
|
|
@@ -243,22 +243,22 @@ async function runUnitTests(projectRoot, runTests) {
|
|
|
243
243
|
}
|
|
244
244
|
};
|
|
245
245
|
}
|
|
246
|
-
//
|
|
247
|
-
//
|
|
248
|
-
// in, so this boundary gate and the transition gate agree on which file is
|
|
249
|
-
// a slice's evidence. `<rid>` is substituted at probe time.
|
|
246
|
+
// Candidate order is canonical-first, then the back-compat tiers, mirroring
|
|
247
|
+
// `artifact-prerequisites.ts` (v2.12.0 moved security + perf to audit skills).
|
|
250
248
|
const REVIEW_FILES = [
|
|
251
249
|
{
|
|
252
250
|
name: 'code-review',
|
|
253
251
|
paths: ['rd/code-review-<rid>.md', 'rd/code-review.md'],
|
|
254
252
|
label: 'code-review'
|
|
255
253
|
},
|
|
256
|
-
// v2.12.0 collapse: security + perf moved to standalone audit skills.
|
|
257
|
-
// OR the v2.11.x legacy path during the 1-minor-release back-compat
|
|
258
|
-
// window (v2.13.0 hard-deletes the legacy paths — see CHANGELOG [2.12.0]).
|
|
259
254
|
{
|
|
260
255
|
name: 'security-review',
|
|
261
|
-
paths: [
|
|
256
|
+
paths: [
|
|
257
|
+
'audit/security-<rid>.md',
|
|
258
|
+
'audit/security.md',
|
|
259
|
+
'rd/security-review-<rid>.md',
|
|
260
|
+
'rd/security-review.md'
|
|
261
|
+
],
|
|
262
262
|
label: 'security-review'
|
|
263
263
|
},
|
|
264
264
|
{
|
|
@@ -8,7 +8,8 @@
|
|
|
8
8
|
*/
|
|
9
9
|
import { existsSync, readFileSync } from 'node:fs';
|
|
10
10
|
import { join } from 'node:path';
|
|
11
|
-
import { getPrerequisitesFor
|
|
11
|
+
import { getPrerequisitesFor } from '../artifacts/artifact-prerequisites.js';
|
|
12
|
+
import { prerequisiteBodyViolations } from '../artifacts/prerequisite-checks.js';
|
|
12
13
|
import { showRequestArtifact } from '../artifacts/request-artifact-service.js';
|
|
13
14
|
import { readArtifactState } from '../artifacts/request-artifact-state-helpers.js';
|
|
14
15
|
export function extractState(markdown) {
|
|
@@ -209,7 +209,7 @@ export async function verifyPipeline(options) {
|
|
|
209
209
|
// artifact is absent, so `unpromoted` mixes "never promoted" with
|
|
210
210
|
// "promoted on paper only" — the reason on each entry says which.
|
|
211
211
|
feedbackGates[0].detail = `${unpromoted.length} feedback memor${unpromoted.length === 1 ? 'y' : 'ies'} without a backed promotion: ${unpromoted.map((u) => `${u.name} (${u.reason})`).join('; ')}${exemptNote}`;
|
|
212
|
-
violations.push(`Gate H feedback-promotion FAILED: ${unpromoted.length} feedback memor${unpromoted.length === 1 ? 'y is' : 'ies are'} not yet promoted to an enforcement layer with a real artifact (${unpromoted.map((u) => u.name).join(', ')})${exemptNote}. A marker alone does not count: layer A needs a registered SOP manifest, layer B a hook command that runs something named after the rule in .peaks/.claude-settings-template.json, layer C a hard-floor category in src/services/code/mode-gate.ts. Run \`peaks feedback promote <memory-file> --layer <A|B|C>\` for each and read what it reports. See sops/feedback-promotion-sop.md.`);
|
|
212
|
+
violations.push(`Gate H feedback-promotion FAILED: ${unpromoted.length} feedback memor${unpromoted.length === 1 ? 'y is' : 'ies are'} not yet promoted to an enforcement layer with a real artifact (${unpromoted.map((u) => u.name).join(', ')})${exemptNote}. A marker alone does not count: layer A needs a registered SOP manifest, layer B a hook command that runs something named after the rule in .peaks/.claude-settings-template.json or the tracked .claude/settings.json, layer C a hard-floor category in src/services/code/mode-gate.ts. Run \`peaks feedback promote <memory-file> --layer <A|B|C>\` for each and read what it reports. See sops/feedback-promotion-sop.md.`);
|
|
213
213
|
nextActions.push(`Run \`peaks feedback promote <memory-file> --layer <A|B|C>\` for each feedback memory without a backed promotion to satisfy Gate H.`);
|
|
214
214
|
}
|
|
215
215
|
}
|
|
@@ -1,23 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
*
|
|
3
|
-
* Pure-function classifier (`canSkipSlice`) + side-effecting applicator
|
|
4
|
-
* (`applySkip`). Both are testable without filesystem mocks (the
|
|
5
|
-
* applicator accepts an injected `readSkipState` / `writeSkipState`
|
|
6
|
-
* pair so the unit tests use in-memory fakes; the production caller
|
|
7
|
-
* passes the real store from `workflow-state-store.ts`).
|
|
8
|
-
*
|
|
9
|
-
* Three rules (per RD §Why + Tech Doc §2-4):
|
|
10
|
-
* - Rule 1 (slice type allowlist): `bugfix` / `feature` / `refactor`
|
|
11
|
-
* can never skip QA, regardless of `--reason`. The allowlist is
|
|
12
|
-
* `['docs', 'config', 'chore']`.
|
|
13
|
-
* - Rule 2 (one-time semantics): if a skip-marker already exists for
|
|
14
|
-
* this rid AND the requested skip is the same → idempotent
|
|
15
|
-
* no-op (`applied: false, idempotent: true`). If different → deny
|
|
16
|
-
* with `reason: "rid already has a different skip applied"`.
|
|
17
|
-
* - Rule 3 (role-based authorization): scripts (caller kind derived
|
|
18
|
-
* from `$PEAKS_CALLER_ID` env var) MUST pass `--i-have-reviewed`
|
|
19
|
-
* in addition to `--reason`.
|
|
20
|
-
*/
|
|
21
1
|
import { type WorkflowSkipState } from './workflow-state-store.js';
|
|
22
2
|
import type { RequestType } from '../artifacts/artifact-prerequisites.js';
|
|
23
3
|
export type SkipArgs = {
|
|
@@ -18,6 +18,8 @@
|
|
|
18
18
|
* from `$PEAKS_CALLER_ID` env var) MUST pass `--i-have-reviewed`
|
|
19
19
|
* in addition to `--reason`.
|
|
20
20
|
*/
|
|
21
|
+
import { execFileSync } from 'node:child_process';
|
|
22
|
+
import { userInfo } from 'node:os';
|
|
21
23
|
import { readSkipState, writeSkipState } from './workflow-state-store.js';
|
|
22
24
|
import { showRequestArtifact } from '../artifacts/request-artifact-service.js';
|
|
23
25
|
const SKIPPABLE_TYPES = ['docs', 'config', 'chore'];
|
|
@@ -190,8 +192,6 @@ function pathFromStateFile(projectRoot, sessionId, rid) {
|
|
|
190
192
|
* unavailable. Never throws. */
|
|
191
193
|
function resolveSkipAppliedBy() {
|
|
192
194
|
try {
|
|
193
|
-
// Lazy require so the unit tests can stub via process.env.
|
|
194
|
-
const { execFileSync } = require('node:child_process');
|
|
195
195
|
const out = execFileSync('git', ['config', '--global', 'user.name'], {
|
|
196
196
|
encoding: 'utf8',
|
|
197
197
|
stdio: ['ignore', 'pipe', 'ignore'],
|
|
@@ -207,8 +207,7 @@ function resolveSkipAppliedBy() {
|
|
|
207
207
|
// fall through
|
|
208
208
|
}
|
|
209
209
|
try {
|
|
210
|
-
const
|
|
211
|
-
const info = os.userInfo();
|
|
210
|
+
const info = userInfo();
|
|
212
211
|
return info.username;
|
|
213
212
|
}
|
|
214
213
|
catch {
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `claude-settings-retirements.ts` — the `hooks.PreToolUse` entries this template
|
|
3
|
+
* used to declare and has since RETIRED, plus the shape predicate the retirement
|
|
4
|
+
* is tested against.
|
|
5
|
+
*
|
|
6
|
+
* WHY A RETIREMENT IS NOT A DELETION. `mergeTemplateOwnedHooks` (in
|
|
7
|
+
* `claude-settings-template-merge.ts`) carries across every on-disk entry the
|
|
8
|
+
* template does not declare — that is the whole point of the entry-level
|
|
9
|
+
* ownership rule, and it is what keeps `installAutoCompactHook`'s `Bash|Task`
|
|
10
|
+
* entry alive across an init. So simply STOPPING the emission reaches nobody: an
|
|
11
|
+
* install written by an earlier release keeps the entry forever. Declaring less
|
|
12
|
+
* cannot retire an entry; something has to say "this one is gone", and
|
|
13
|
+
* `isRetiredTemplateEntry` is that something. `templateContentMatches` calls it
|
|
14
|
+
* too, because a file still carrying a retired entry has to compare as DRIFTED or
|
|
15
|
+
* the merge that would drop it never runs.
|
|
16
|
+
*
|
|
17
|
+
* Extracted from `claude-settings-template-merge.ts` when the second retirement
|
|
18
|
+
* pushed that module past the 300-line cap. The bodies moved verbatim; the
|
|
19
|
+
* predicate and its two shape types came along because the predicate is their
|
|
20
|
+
* only reader inside that module.
|
|
21
|
+
*
|
|
22
|
+
* TWO RETIREMENTS SO FAR:
|
|
23
|
+
* - TEMPLATE_VERSION 1.8.0 — the `Write|Edit|MultiEdit` gate handler;
|
|
24
|
+
* - TEMPLATE_VERSION 1.10.0 — the two layer-B feedback hooks.
|
|
25
|
+
* They share neither a matcher nor a command form, so each gets its own narrow
|
|
26
|
+
* predicate rather than one looser rule. The narrowness is load-bearing: a
|
|
27
|
+
* predicate that dropped "anything on this matcher" would delete a USER's hook,
|
|
28
|
+
* which is the failure the ownership rule exists to prevent.
|
|
29
|
+
*/
|
|
30
|
+
/** One handler in a `hooks.PreToolUse` entry, in the shape this template declares. */
|
|
31
|
+
export type TemplateHookCommand = {
|
|
32
|
+
type: string;
|
|
33
|
+
command: string;
|
|
34
|
+
shell?: string;
|
|
35
|
+
};
|
|
36
|
+
/**
|
|
37
|
+
* One `hooks.PreToolUse` entry in the shape this template declares. The
|
|
38
|
+
* `matcher` + `hooks` pair is the entry's identity everywhere in this concern:
|
|
39
|
+
* `matcher` alone is not unique (two `Bash` entries), and whole-object identity
|
|
40
|
+
* would make a hand-edited entry unrecognizable and therefore unrepairable.
|
|
41
|
+
*/
|
|
42
|
+
export type TemplatePreToolUseEntry = {
|
|
43
|
+
matcher: string;
|
|
44
|
+
hooks: TemplateHookCommand[];
|
|
45
|
+
};
|
|
46
|
+
export declare function isPreToolUseEntry(value: unknown): value is TemplatePreToolUseEntry;
|
|
47
|
+
/**
|
|
48
|
+
* Is `entry` one this template used to declare and has since RETIRED?
|
|
49
|
+
*
|
|
50
|
+
* Each retirement gets its own narrow predicate — the shapes share neither a
|
|
51
|
+
* matcher nor a command form. An entry whose shape matches nothing here is not
|
|
52
|
+
* retired, and is preserved.
|
|
53
|
+
*/
|
|
54
|
+
export declare function isRetiredTemplateEntry(entry: unknown): boolean;
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `claude-settings-retirements.ts` — the `hooks.PreToolUse` entries this template
|
|
3
|
+
* used to declare and has since RETIRED, plus the shape predicate the retirement
|
|
4
|
+
* is tested against.
|
|
5
|
+
*
|
|
6
|
+
* WHY A RETIREMENT IS NOT A DELETION. `mergeTemplateOwnedHooks` (in
|
|
7
|
+
* `claude-settings-template-merge.ts`) carries across every on-disk entry the
|
|
8
|
+
* template does not declare — that is the whole point of the entry-level
|
|
9
|
+
* ownership rule, and it is what keeps `installAutoCompactHook`'s `Bash|Task`
|
|
10
|
+
* entry alive across an init. So simply STOPPING the emission reaches nobody: an
|
|
11
|
+
* install written by an earlier release keeps the entry forever. Declaring less
|
|
12
|
+
* cannot retire an entry; something has to say "this one is gone", and
|
|
13
|
+
* `isRetiredTemplateEntry` is that something. `templateContentMatches` calls it
|
|
14
|
+
* too, because a file still carrying a retired entry has to compare as DRIFTED or
|
|
15
|
+
* the merge that would drop it never runs.
|
|
16
|
+
*
|
|
17
|
+
* Extracted from `claude-settings-template-merge.ts` when the second retirement
|
|
18
|
+
* pushed that module past the 300-line cap. The bodies moved verbatim; the
|
|
19
|
+
* predicate and its two shape types came along because the predicate is their
|
|
20
|
+
* only reader inside that module.
|
|
21
|
+
*
|
|
22
|
+
* TWO RETIREMENTS SO FAR:
|
|
23
|
+
* - TEMPLATE_VERSION 1.8.0 — the `Write|Edit|MultiEdit` gate handler;
|
|
24
|
+
* - TEMPLATE_VERSION 1.10.0 — the two layer-B feedback hooks.
|
|
25
|
+
* They share neither a matcher nor a command form, so each gets its own narrow
|
|
26
|
+
* predicate rather than one looser rule. The narrowness is load-bearing: a
|
|
27
|
+
* predicate that dropped "anything on this matcher" would delete a USER's hook,
|
|
28
|
+
* which is the failure the ownership rule exists to prevent.
|
|
29
|
+
*/
|
|
30
|
+
export function isPreToolUseEntry(value) {
|
|
31
|
+
if (typeof value !== 'object' || value === null || Array.isArray(value)) {
|
|
32
|
+
return false;
|
|
33
|
+
}
|
|
34
|
+
const candidate = value;
|
|
35
|
+
return typeof candidate.matcher === 'string' && Array.isArray(candidate.hooks);
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* The retired `Write|Edit|MultiEdit` gate entry, as an on-disk file written by a
|
|
39
|
+
* pre-1.8.0 release holds it.
|
|
40
|
+
*
|
|
41
|
+
* TEMPLATE_VERSION 1.8.0 stopped emitting this entry. Declaring less is not
|
|
42
|
+
* enough on its own: `mergeTemplateOwnedHooks` preserves every on-disk entry the
|
|
43
|
+
* template does not declare — that is the whole point of the entry-level
|
|
44
|
+
* ownership rule (it is what keeps `installAutoCompactHook`'s `Bash|Task` entry
|
|
45
|
+
* alive) — so a project installed by an earlier release would keep the no-op
|
|
46
|
+
* handler, and its `node "C:/…/nvm/v24.14.0/…"` path, forever.
|
|
47
|
+
*
|
|
48
|
+
* Deliberately narrow. It matches the exact command shape this template used to
|
|
49
|
+
* emit — one handler, `node "<…>/services/hooks/write-gate.js"` — under the exact
|
|
50
|
+
* legacy matcher spelling, so a user's OWN `Write|Edit|MultiEdit` entry (a
|
|
51
|
+
* different command, or more than one handler) is preserved like any other entry
|
|
52
|
+
* the template does not declare.
|
|
53
|
+
*/
|
|
54
|
+
const RETIRED_WRITE_GATE_MATCHER = 'Write|Edit|MultiEdit';
|
|
55
|
+
const RETIRED_WRITE_GATE_COMMAND = /^node "[^"]*\/services\/hooks\/write-gate\.js"$/;
|
|
56
|
+
/**
|
|
57
|
+
* The two layer-B feedback hooks TEMPLATE_VERSION 1.10.0 retired, as a file
|
|
58
|
+
* written by 1.9.0 holds them.
|
|
59
|
+
*
|
|
60
|
+
* 1.9.0 emitted them into the CONSUMER template on purpose, to make the promotion
|
|
61
|
+
* a property of a fresh clone rather than of one machine. The template cannot do
|
|
62
|
+
* that: it is written into a consumer project's `.claude/settings.local.json`,
|
|
63
|
+
* where `${CLAUDE_PROJECT_DIR}` is the CONSUMER's root, `src/**` is absent from
|
|
64
|
+
* the npm `files` list, and nothing copies it — so every downstream project
|
|
65
|
+
* received two `Bash` PreToolUse entries whose command could never resolve, and a
|
|
66
|
+
* fresh clone of THIS repository got neither them nor a tracked copy of the
|
|
67
|
+
* registration (`settings.local.json` is gitignored). They are this repository's
|
|
68
|
+
* own development hooks; the registration now lives in this repository's tracked
|
|
69
|
+
* `.claude/settings.json`, where `${CLAUDE_PROJECT_DIR}` really is the root that
|
|
70
|
+
* contains `src/`.
|
|
71
|
+
*
|
|
72
|
+
* Same mechanism and same reason as the write gate above: `mergeTemplateOwnedHooks`
|
|
73
|
+
* preserves every on-disk entry the template does not declare, so REMOVING the
|
|
74
|
+
* spread from `buildClaudeSettingsLocalJson` would leave the two unresolvable
|
|
75
|
+
* entries in every install that already had them, forever.
|
|
76
|
+
*
|
|
77
|
+
* Deliberately narrow: it matches the exact command string 1.9.0 emitted — `bash`,
|
|
78
|
+
* then the project-root variable, then that script's shipped path — under the
|
|
79
|
+
* matcher 1.9.0 used, with a single handler. A consumer's own `Bash` entry (a
|
|
80
|
+
* different command, or more than one handler) is preserved like any other entry
|
|
81
|
+
* the template does not declare.
|
|
82
|
+
*/
|
|
83
|
+
const RETIRED_FEEDBACK_HOOK_MATCHER = 'Bash';
|
|
84
|
+
const RETIRED_FEEDBACK_HOOK_COMMANDS = new Set([
|
|
85
|
+
'pre-tool-peaks-current-directory-scope.sh',
|
|
86
|
+
'pre-tool-piping-a-test-run-reports-the-pipes-exit-code.sh'
|
|
87
|
+
].map((script) => `bash "\${CLAUDE_PROJECT_DIR}/src/services/hooks/${script}"`));
|
|
88
|
+
/**
|
|
89
|
+
* Is `entry` one this template used to declare and has since RETIRED?
|
|
90
|
+
*
|
|
91
|
+
* Each retirement gets its own narrow predicate — the shapes share neither a
|
|
92
|
+
* matcher nor a command form. An entry whose shape matches nothing here is not
|
|
93
|
+
* retired, and is preserved.
|
|
94
|
+
*/
|
|
95
|
+
export function isRetiredTemplateEntry(entry) {
|
|
96
|
+
if (!isPreToolUseEntry(entry))
|
|
97
|
+
return false;
|
|
98
|
+
if (entry.hooks.length !== 1)
|
|
99
|
+
return false;
|
|
100
|
+
const [handler] = entry.hooks;
|
|
101
|
+
if (handler === undefined)
|
|
102
|
+
return false;
|
|
103
|
+
if (handler.type !== 'command')
|
|
104
|
+
return false;
|
|
105
|
+
if (entry.matcher === RETIRED_WRITE_GATE_MATCHER) {
|
|
106
|
+
return RETIRED_WRITE_GATE_COMMAND.test(handler.command);
|
|
107
|
+
}
|
|
108
|
+
if (entry.matcher === RETIRED_FEEDBACK_HOOK_MATCHER) {
|
|
109
|
+
return RETIRED_FEEDBACK_HOOK_COMMANDS.has(handler.command);
|
|
110
|
+
}
|
|
111
|
+
return false;
|
|
112
|
+
}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `claude-settings-template-merge.ts` — the comparison and the merge that decide
|
|
3
|
+
* whether an on-disk settings file still declares what the template declares, and
|
|
4
|
+
* that carry every entry the template does not declare across untouched.
|
|
5
|
+
*
|
|
6
|
+
* Split out of `claude-settings-template.ts` (475 raw lines against the 300 cap)
|
|
7
|
+
* when the two layer-B feedback hook entries had to be added to the template: that
|
|
8
|
+
* file now holds the template's own shape, and this one holds the merge machinery.
|
|
9
|
+
* The bodies moved verbatim; the three non-null assertions became the explicit
|
|
10
|
+
* `undefined` checks they already were in effect, so this module is clean at birth.
|
|
11
|
+
* `claude-settings-template.ts` re-exports every symbol below, so it stays the
|
|
12
|
+
* single public entry point for this concern.
|
|
13
|
+
*/
|
|
14
|
+
import { isRetiredTemplateEntry } from './claude-settings-retirements.js';
|
|
15
|
+
/**
|
|
16
|
+
* Compare two serialized template strings: does the on-disk file already
|
|
17
|
+
* declare every entry the generated tree declares?
|
|
18
|
+
*
|
|
19
|
+
* This comparator answers "is each entry the GENERATED tree declares present
|
|
20
|
+
* on disk?", NOT "are the two `hooks` trees identical". Extra on-disk entries
|
|
21
|
+
* are IGNORED, so an entry another writer put in this file never makes it look
|
|
22
|
+
* drifted.
|
|
23
|
+
*
|
|
24
|
+
* That is the deliberate other half of the entry-level merge in
|
|
25
|
+
* `mergeTemplateOwnedHooks` / `workspace-claude-settings-materializer.ts`.
|
|
26
|
+
* `.claude/settings.local.json` has a SECOND writer of `hooks.PreToolUse`:
|
|
27
|
+
* `installAutoCompactHook` appends a `Bash|Task` entry. Under the previous
|
|
28
|
+
* exact-tree rule the merged file carried 4 entries against a 3-entry
|
|
29
|
+
* generated tree, so every `peaks workspace init` answered "drifted",
|
|
30
|
+
* rewrote, and reported `refreshed` forever — precisely the state whole-key
|
|
31
|
+
* ownership existed to prevent, and the reason the merge could not ship alone.
|
|
32
|
+
*
|
|
33
|
+
* Matching is order-insensitive AND multiset-aware: the template declares TWO
|
|
34
|
+
* `Bash` entries — a MEASUREMENT, not a memory, so it is pinned to a predicate
|
|
35
|
+
* rather than restated in prose: `buildClaudeSettingsLocalJson().hooks.
|
|
36
|
+
* PreToolUse` filtered on `matcher === 'Bash'` has length 2 (the Step 0.8 gate
|
|
37
|
+
* and `gate enforce`). Each must have its own counterpart on disk, so a file
|
|
38
|
+
* carrying only one of them is still reported as drifted (the previous
|
|
39
|
+
* index-by-index loop had the same property; it is load-bearing, not a
|
|
40
|
+
* detail). The live count was 4 from TEMPLATE_VERSION 1.9.0 until 1.10.0 retired
|
|
41
|
+
* the two layer-B feedback hooks from the template, which is exactly how a
|
|
42
|
+
* prose count goes stale.
|
|
43
|
+
*
|
|
44
|
+
* Returns `true` iff both strings parse to objects whose `hooks.PreToolUse`
|
|
45
|
+
* arrays satisfy that containment, the on-disk file carries NO entry this
|
|
46
|
+
* template has retired (`isRetiredTemplateEntry`), AND the on-disk `env`
|
|
47
|
+
* already carries every exemption the template declares (extra on-disk keys
|
|
48
|
+
* and extra globs are allowed — a user may exempt other trees, and a
|
|
49
|
+
* requirement the file already exceeds must not re-trigger a write).
|
|
50
|
+
*
|
|
51
|
+
* Returns `false` on any `JSON.parse` error, shape mismatch, or
|
|
52
|
+
* missing `hooks.PreToolUse`. Whitespace and key order do NOT affect
|
|
53
|
+
* the result — the comparison is on the parsed AST, not on bytes.
|
|
54
|
+
*
|
|
55
|
+
* This is the comparator `initWorkspace` uses to decide whether to
|
|
56
|
+
* refresh a stale `.peaks/.claude-settings-template.json` on disk.
|
|
57
|
+
*/
|
|
58
|
+
export declare function templateContentMatches(generated: string, onDisk: string): boolean;
|
|
59
|
+
/**
|
|
60
|
+
* Merge the on-disk `hooks.PreToolUse` list with the template's.
|
|
61
|
+
*
|
|
62
|
+
* the entries IT DECLARES — and nothing else. Every other on-disk entry is
|
|
63
|
+
* carried across verbatim, whatever its matcher, because the template has no
|
|
64
|
+
* opinion about it:
|
|
65
|
+
*
|
|
66
|
+
* - a `matcher` the template does not declare (`Bash|Task`, the auto-compact
|
|
67
|
+
* hook `installAutoCompactHook` appends) is never touched;
|
|
68
|
+
* - surplus entries BEYOND the template's count for a declared matcher (a
|
|
69
|
+
* user's own `Bash` hook) are surplus too, and survive;
|
|
70
|
+
* - an on-disk entry that fills a declared slot is REPLACED by the template's
|
|
71
|
+
* entry for it. That is what makes a hand-edited (or older-release) entry
|
|
72
|
+
* self-heal instead of lingering next to a correct copy of itself.
|
|
73
|
+
*
|
|
74
|
+
* Slot counting is per `matcher` and positional within it: the template
|
|
75
|
+
* declares TWO `Bash` entries — `buildClaudeSettingsLocalJson()` filtered on
|
|
76
|
+
* `matcher === 'Bash'` is the measurement, and it is 2 — so the first two
|
|
77
|
+
* on-disk `Bash` entries are theirs and a third is the user's. (It was 4 while
|
|
78
|
+
* TEMPLATE_VERSION 1.9.0 also declared the two layer-B feedback hooks; 1.10.0
|
|
79
|
+
* retired those, and because the retirement is tested BEFORE slot counting they
|
|
80
|
+
* never occupy a slot on their way out.) The template's entries are emitted
|
|
81
|
+
* first, in template order, then the preserved ones in their on-disk order —
|
|
82
|
+
* which is a fixed point: re-merging the result yields the result (the
|
|
83
|
+
* template's own entries are encountered first and refill their own slots).
|
|
84
|
+
*
|
|
85
|
+
* Non-conforming entries (no string `matcher`, no `hooks` array) are preserved
|
|
86
|
+
* rather than dropped: guessing at their shape is how a user's entry gets
|
|
87
|
+
* deleted.
|
|
88
|
+
*
|
|
89
|
+
* ONE exception to "preserve what I do not declare": an entry this template
|
|
90
|
+
* used to declare and RETIRED is dropped rather than preserved — TEMPLATE_
|
|
91
|
+
* VERSION 1.8.0's `Write|Edit|MultiEdit` gate, and 1.10.0's two layer-B feedback
|
|
92
|
+
* hooks (see `isRetiredTemplateEntry`). Declaring less cannot retire an entry on
|
|
93
|
+
* its own, because preserving undeclared entries is exactly what this function
|
|
94
|
+
* does; without the drop, a pre-1.8.0 install would keep the no-op handler and
|
|
95
|
+
* its version-pinned script path forever, and a pre-1.10.0 consumer would keep
|
|
96
|
+
* two `Bash` entries whose command points into an `src/` tree it never
|
|
97
|
+
* received. Each predicate is narrow enough that only the exact command this
|
|
98
|
+
* template emitted matches.
|
|
99
|
+
*/
|
|
100
|
+
export declare function mergeTemplateOwnedHooks(onDisk: ReadonlyArray<unknown>, template: ReadonlyArray<unknown>): unknown[];
|
|
101
|
+
/**
|
|
102
|
+
* The retirement vocabulary — the entries this template used to declare and has
|
|
103
|
+
* since RETIRED, and the shape predicate that says so — lives in
|
|
104
|
+
* `claude-settings-retirements.ts`. It was extracted when the second retirement
|
|
105
|
+
* pushed this module past the 300-line cap. Re-exported here so
|
|
106
|
+
* `claude-settings-template.ts`, the single public entry point for the template
|
|
107
|
+
* concern, still reaches it through the module it always did.
|
|
108
|
+
*/
|
|
109
|
+
export { isRetiredTemplateEntry };
|