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
|
@@ -23,10 +23,17 @@
|
|
|
23
23
|
* it can be unit-tested in isolation and so the on-disk file matches
|
|
24
24
|
* the in-memory template byte-for-byte.
|
|
25
25
|
*
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
*
|
|
29
|
-
*
|
|
26
|
+
* TWO `Bash` matchers are emitted: the Step 0.8 mechanical gate and the SOP
|
|
27
|
+
* gate-enforce handler. No `Write|Edit|MultiEdit` entry is emitted: that
|
|
28
|
+
* matcher's gate is `peaks code-gate`, installed into the committed
|
|
29
|
+
* `.claude/settings.json` by `peaks hooks install`. TEMPLATE_VERSION 1.10.0
|
|
30
|
+
* removed the two layer-B feedback hooks this file used to emit: they are this
|
|
31
|
+
* repository's OWN development hooks, and this file is written into a
|
|
32
|
+
* CONSUMER project, where `${CLAUDE_PROJECT_DIR}` is that project's root, no
|
|
33
|
+
* `src/**` is ever shipped, and the command therefore points at nothing. They
|
|
34
|
+
* are registered in this repository's tracked `.claude/settings.json` instead;
|
|
35
|
+
* `isRetiredTemplateEntry` in `claude-settings-template-merge.ts` is what makes
|
|
36
|
+
* an install that already has them converge.
|
|
30
37
|
*
|
|
31
38
|
* The previous `Bash` matcher (which whitelisted a fixed `peaks
|
|
32
39
|
* <subcommand>` prefix) was removed in TEMPLATE_VERSION 1.2.0. The
|
|
@@ -40,7 +47,15 @@
|
|
|
40
47
|
* consumer project's `.claude/settings.json` and which exits 0
|
|
41
48
|
* silently for any command not guarded by a registered SOP gate.
|
|
42
49
|
*/
|
|
43
|
-
import { EXTERNAL_GATE_EXEMPT_ENV,
|
|
50
|
+
import { EXTERNAL_GATE_EXEMPT_ENV, resolveHookShell, resolveHookSpec } from '../skills/hooks-codegate-superpowers.js';
|
|
51
|
+
/**
|
|
52
|
+
* The comparison and the entry-level merge live in
|
|
53
|
+
* `claude-settings-template-merge.ts` — they were two thirds of this file's
|
|
54
|
+
* bytes and none of its template shape. Re-exported here so this module stays
|
|
55
|
+
* the single public entry point for the template concern: no caller has to
|
|
56
|
+
* know which half a symbol lives in.
|
|
57
|
+
*/
|
|
58
|
+
export { isRetiredTemplateEntry, mergeTemplateOwnedHooks, templateContentMatches } from './claude-settings-template-merge.js';
|
|
44
59
|
export const CLAUDE_SETTINGS_LOCAL_FILENAME = '.claude/settings.local.json';
|
|
45
60
|
/**
|
|
46
61
|
* Informational version of the offline template shape. Bumped when the
|
|
@@ -98,232 +113,31 @@ export const CLAUDE_SETTINGS_LOCAL_FILENAME = '.claude/settings.local.json';
|
|
|
98
113
|
* `mergeTemplateOwnedHooks` drops the retired entry from
|
|
99
114
|
* existing on-disk files, so an earlier install converges
|
|
100
115
|
* instead of keeping a no-op with a stale absolute path.
|
|
116
|
+
* 1.9.0 — added the two layer-B feedback hook entries
|
|
117
|
+
* (`pre-tool-peaks-current-directory-scope.sh` and
|
|
118
|
+
* `pre-tool-piping-a-test-run-reports-the-pipes-exit-code.sh`),
|
|
119
|
+
* pinned to `shell: bash`. Until now their registration existed only
|
|
120
|
+
* in the generated copies on the machine that hand-wrote them: a
|
|
121
|
+
* fresh clone got the two scripts and no registration, so the
|
|
122
|
+
* promotion they carry was true only locally. See
|
|
123
|
+
* `buildFeedbackHookHandler` for why the pin is `bash` and not the
|
|
124
|
+
* `powershell` its three siblings take.
|
|
125
|
+
* 1.10.0 — REMOVED those two entries again, and retired them so every install
|
|
126
|
+
* that already carries them converges. 1.9.0's INTENT was right — a
|
|
127
|
+
* fresh clone should carry the registration, not just the scripts —
|
|
128
|
+
* but this file is the wrong mechanism for it. This template is
|
|
129
|
+
* written into a CONSUMER project's `.claude/settings.local.json`,
|
|
130
|
+
* where `${CLAUDE_PROJECT_DIR}` is the consumer's root, `src/**` is
|
|
131
|
+
* not in the npm `files` list, and nothing copies it, so the two
|
|
132
|
+
* entries were a command that could never resolve in every
|
|
133
|
+
* downstream project; and this repository, whose `settings.local.json`
|
|
134
|
+
* is gitignored, got no tracked copy either. The scripts STAY here —
|
|
135
|
+
* they are this repository's own development hooks — and the
|
|
136
|
+
* registration moved to the tracked `.claude/settings.json`.
|
|
137
|
+
* `isRetiredTemplateEntry` carries the retirement, because declaring
|
|
138
|
+
* less cannot retire an entry on its own.
|
|
101
139
|
*/
|
|
102
|
-
export const TEMPLATE_VERSION = '1.
|
|
103
|
-
/**
|
|
104
|
-
* Compare two serialized template strings: does the on-disk file already
|
|
105
|
-
* declare every entry the generated tree declares?
|
|
106
|
-
*
|
|
107
|
-
* This comparator answers "is each entry the GENERATED tree declares present
|
|
108
|
-
* on disk?", NOT "are the two `hooks` trees identical". Extra on-disk entries
|
|
109
|
-
* are IGNORED, so an entry another writer put in this file never makes it look
|
|
110
|
-
* drifted.
|
|
111
|
-
*
|
|
112
|
-
* That is the deliberate other half of the entry-level merge in
|
|
113
|
-
* `mergeTemplateOwnedHooks` / `workspace-claude-settings-materializer.ts`.
|
|
114
|
-
* `.claude/settings.local.json` has a SECOND writer of `hooks.PreToolUse`:
|
|
115
|
-
* `installAutoCompactHook` appends a `Bash|Task` entry. Under the previous
|
|
116
|
-
* exact-tree rule the merged file carried 4 entries against a 3-entry
|
|
117
|
-
* generated tree, so every `peaks workspace init` answered "drifted",
|
|
118
|
-
* rewrote, and reported `refreshed` forever — precisely the state whole-key
|
|
119
|
-
* ownership existed to prevent, and the reason the merge could not ship alone.
|
|
120
|
-
*
|
|
121
|
-
* Matching is order-insensitive AND multiset-aware: the template declares TWO
|
|
122
|
-
* `Bash` entries, and each must have its own counterpart on disk, so a file
|
|
123
|
-
* carrying only one of them is still reported as drifted (the previous
|
|
124
|
-
* index-by-index loop had the same property; it is load-bearing, not a
|
|
125
|
-
* detail).
|
|
126
|
-
*
|
|
127
|
-
* Returns `true` iff both strings parse to objects whose `hooks.PreToolUse`
|
|
128
|
-
* arrays satisfy that containment, the on-disk file carries NO entry this
|
|
129
|
-
* template has retired (`isRetiredTemplateEntry`), AND the on-disk `env`
|
|
130
|
-
* already carries every exemption the template declares (extra on-disk keys
|
|
131
|
-
* and extra globs are allowed — a user may exempt other trees, and a
|
|
132
|
-
* requirement the file already exceeds must not re-trigger a write).
|
|
133
|
-
*
|
|
134
|
-
* Returns `false` on any `JSON.parse` error, shape mismatch, or
|
|
135
|
-
* missing `hooks.PreToolUse`. Whitespace and key order do NOT affect
|
|
136
|
-
* the result — the comparison is on the parsed AST, not on bytes.
|
|
137
|
-
*
|
|
138
|
-
* This is the comparator `initWorkspace` uses to decide whether to
|
|
139
|
-
* refresh a stale `.peaks/.claude-settings-template.json` on disk.
|
|
140
|
-
*/
|
|
141
|
-
export function templateContentMatches(generated, onDisk) {
|
|
142
|
-
let parsedGenerated;
|
|
143
|
-
let parsedOnDisk;
|
|
144
|
-
try {
|
|
145
|
-
parsedGenerated = JSON.parse(generated);
|
|
146
|
-
}
|
|
147
|
-
catch {
|
|
148
|
-
return false;
|
|
149
|
-
}
|
|
150
|
-
try {
|
|
151
|
-
parsedOnDisk = JSON.parse(onDisk);
|
|
152
|
-
}
|
|
153
|
-
catch {
|
|
154
|
-
return false;
|
|
155
|
-
}
|
|
156
|
-
if (!isTemplateShape(parsedGenerated) || !isTemplateShape(parsedOnDisk)) {
|
|
157
|
-
return false;
|
|
158
|
-
}
|
|
159
|
-
// Multiset containment: consume one on-disk entry per generated entry so a
|
|
160
|
-
// file holding a single copy of a doubly-declared entry still fails.
|
|
161
|
-
const unmatched = [...parsedOnDisk.hooks.PreToolUse];
|
|
162
|
-
for (const required of parsedGenerated.hooks.PreToolUse) {
|
|
163
|
-
const at = unmatched.findIndex((candidate) => sameEntry(required, candidate));
|
|
164
|
-
if (at === -1) {
|
|
165
|
-
return false;
|
|
166
|
-
}
|
|
167
|
-
unmatched.splice(at, 1);
|
|
168
|
-
}
|
|
169
|
-
// A RETIRED entry on disk is drift, and this clause is what makes the
|
|
170
|
-
// retirement in `mergeTemplateOwnedHooks` reach an installed file at all.
|
|
171
|
-
//
|
|
172
|
-
// Containment alone cannot express it: a file still carrying
|
|
173
|
-
// `Write|Edit|MultiEdit` declares every entry the template declares, so
|
|
174
|
-
// `templateContentMatches` answered "current", no rewrite ran, and the merge
|
|
175
|
-
// never got the chance to drop it. Measured on a throwaway project root
|
|
176
|
-
// before this clause existed — init against the rebuilt CLI reported
|
|
177
|
-
// `already-current` and the retired entry survived verbatim. Declaring less
|
|
178
|
-
// is not a retirement; the comparator has to say so.
|
|
179
|
-
//
|
|
180
|
-
// One extra rewrite per affected install, then the fixed point holds: the
|
|
181
|
-
// merge emits no retired entry, so the next comparison finds none and
|
|
182
|
-
// answers `current`.
|
|
183
|
-
if (parsedOnDisk.hooks.PreToolUse.some((entry) => isRetiredTemplateEntry(entry))) {
|
|
184
|
-
return false;
|
|
185
|
-
}
|
|
186
|
-
// A project installed by a release that predates a template-declared
|
|
187
|
-
// exemption still needs the refresh this comparator gates — otherwise the
|
|
188
|
-
// entry would only ever appear on a machine that re-ran `peaks hooks
|
|
189
|
-
// install`. `hasExternalGateExemptions` is the same predicate the installer
|
|
190
|
-
// uses, so the two writers cannot drift apart.
|
|
191
|
-
return hasExternalGateExemptions({ env: parsedOnDisk.env });
|
|
192
|
-
}
|
|
193
|
-
/**
|
|
194
|
-
* Merge the on-disk `hooks.PreToolUse` list with the template's.
|
|
195
|
-
*
|
|
196
|
-
* the entries IT DECLARES — and nothing else. Every other on-disk entry is
|
|
197
|
-
* carried across verbatim, whatever its matcher, because the template has no
|
|
198
|
-
* opinion about it:
|
|
199
|
-
*
|
|
200
|
-
* - a `matcher` the template does not declare (`Bash|Task`, the auto-compact
|
|
201
|
-
* hook `installAutoCompactHook` appends) is never touched;
|
|
202
|
-
* - surplus entries BEYOND the template's count for a declared matcher (a
|
|
203
|
-
* user's own `Bash` hook) are surplus too, and survive;
|
|
204
|
-
* - an on-disk entry that fills a declared slot is REPLACED by the template's
|
|
205
|
-
* entry for it. That is what makes a hand-edited (or older-release) entry
|
|
206
|
-
* self-heal instead of lingering next to a correct copy of itself.
|
|
207
|
-
*
|
|
208
|
-
* Slot counting is per `matcher` and positional within it: the template
|
|
209
|
-
* declares TWO `Bash` entries, so the first two on-disk `Bash` entries are
|
|
210
|
-
* theirs and a third is the user's. The template's entries are emitted first,
|
|
211
|
-
* in template order, then the preserved ones in their on-disk order — which is
|
|
212
|
-
* a fixed point: re-merging the result yields the result (the template's own
|
|
213
|
-
* entries are encountered first and refill their own slots).
|
|
214
|
-
*
|
|
215
|
-
* Non-conforming entries (no string `matcher`, no `hooks` array) are preserved
|
|
216
|
-
* rather than dropped: guessing at their shape is how a user's entry gets
|
|
217
|
-
* deleted.
|
|
218
|
-
*
|
|
219
|
-
* ONE exception to "preserve what I do not declare": an entry this template
|
|
220
|
-
* used to declare and RETIRED (TEMPLATE_VERSION 1.8.0's `Write|Edit|MultiEdit`
|
|
221
|
-
* gate — see `isRetiredTemplateEntry`) is dropped rather than preserved.
|
|
222
|
-
* Declaring less cannot retire an entry on its own, because preserving
|
|
223
|
-
* undeclared entries is exactly what this function does; without the drop, a
|
|
224
|
-
* pre-1.8.0 install would keep the no-op handler and its version-pinned script
|
|
225
|
-
* path forever. The predicate is narrow enough that only the exact command
|
|
226
|
-
* this template emitted matches.
|
|
227
|
-
*/
|
|
228
|
-
export function mergeTemplateOwnedHooks(onDisk, template) {
|
|
229
|
-
const slots = new Map();
|
|
230
|
-
for (const entry of template) {
|
|
231
|
-
if (!isPreToolUseEntry(entry))
|
|
232
|
-
continue;
|
|
233
|
-
slots.set(entry.matcher, (slots.get(entry.matcher) ?? 0) + 1);
|
|
234
|
-
}
|
|
235
|
-
const taken = new Map();
|
|
236
|
-
const preserved = [];
|
|
237
|
-
for (const entry of onDisk) {
|
|
238
|
-
// Retired by this template — dropped, not carried across.
|
|
239
|
-
if (isRetiredTemplateEntry(entry)) {
|
|
240
|
-
continue;
|
|
241
|
-
}
|
|
242
|
-
// Unowned by construction: not a shape the template could have declared.
|
|
243
|
-
if (!isPreToolUseEntry(entry)) {
|
|
244
|
-
preserved.push(entry);
|
|
245
|
-
continue;
|
|
246
|
-
}
|
|
247
|
-
const declared = slots.get(entry.matcher) ?? 0;
|
|
248
|
-
const used = taken.get(entry.matcher) ?? 0;
|
|
249
|
-
if (used >= declared) {
|
|
250
|
-
preserved.push(entry);
|
|
251
|
-
continue;
|
|
252
|
-
}
|
|
253
|
-
taken.set(entry.matcher, used + 1);
|
|
254
|
-
}
|
|
255
|
-
return [...template, ...preserved];
|
|
256
|
-
}
|
|
257
|
-
/** Structural equality of two `PreToolUse` entries. */
|
|
258
|
-
function sameEntry(a, b) {
|
|
259
|
-
return a.matcher === b.matcher && sameHooksArray(a.hooks, b.hooks);
|
|
260
|
-
}
|
|
261
|
-
function isPreToolUseEntry(value) {
|
|
262
|
-
if (typeof value !== 'object' || value === null || Array.isArray(value)) {
|
|
263
|
-
return false;
|
|
264
|
-
}
|
|
265
|
-
const candidate = value;
|
|
266
|
-
return typeof candidate.matcher === 'string' && Array.isArray(candidate.hooks);
|
|
267
|
-
}
|
|
268
|
-
function isTemplateShape(value) {
|
|
269
|
-
if (typeof value !== 'object' || value === null) {
|
|
270
|
-
return false;
|
|
271
|
-
}
|
|
272
|
-
const candidate = value;
|
|
273
|
-
if (typeof candidate.hooks !== 'object' || candidate.hooks === null) {
|
|
274
|
-
return false;
|
|
275
|
-
}
|
|
276
|
-
const hooksObj = candidate.hooks;
|
|
277
|
-
return Array.isArray(hooksObj.PreToolUse);
|
|
278
|
-
}
|
|
279
|
-
function sameHooksArray(a, b) {
|
|
280
|
-
if (a.length !== b.length) {
|
|
281
|
-
return false;
|
|
282
|
-
}
|
|
283
|
-
for (let i = 0; i < a.length; i += 1) {
|
|
284
|
-
const ha = a[i];
|
|
285
|
-
const hb = b[i];
|
|
286
|
-
// `shell` participates in the comparison: it is machine-specific (see
|
|
287
|
-
// `resolveHookShell`), so a file written on one platform must be
|
|
288
|
-
// recognized as drifted on the other instead of silently kept.
|
|
289
|
-
if (ha.type !== hb.type || ha.command !== hb.command || ha.shell !== hb.shell) {
|
|
290
|
-
return false;
|
|
291
|
-
}
|
|
292
|
-
}
|
|
293
|
-
return true;
|
|
294
|
-
}
|
|
295
|
-
/**
|
|
296
|
-
* The retired `Write|Edit|MultiEdit` gate entry, as an on-disk file written by
|
|
297
|
-
* a pre-1.8.0 release holds it.
|
|
298
|
-
*
|
|
299
|
-
* TEMPLATE_VERSION 1.8.0 stopped emitting this entry. Declaring less is not
|
|
300
|
-
* enough on its own: `mergeTemplateOwnedHooks` preserves every on-disk entry
|
|
301
|
-
* the template does not declare — that is the whole point of the entry-level
|
|
302
|
-
* ownership rule (it is what keeps `installAutoCompactHook`'s `Bash|Task`
|
|
303
|
-
* entry alive) — so a project installed by an earlier release would keep the
|
|
304
|
-
* no-op handler, and its `node "C:/…/nvm/v24.14.0/…"` path, forever. This
|
|
305
|
-
* predicate is the retirement: `mergeTemplateOwnedHooks` drops a match.
|
|
306
|
-
*
|
|
307
|
-
* Deliberately narrow. It matches the exact command shape this template used
|
|
308
|
-
* to emit — one handler, `node "<…>/services/hooks/write-gate.js"` — under the
|
|
309
|
-
* exact legacy matcher spelling, so a user's OWN `Write|Edit|MultiEdit` entry
|
|
310
|
-
* (a different command, or more than one handler) is preserved like any other
|
|
311
|
-
* entry the template does not declare. A looser "drop anything on this
|
|
312
|
-
* matcher" rule would delete a user's hook, which is the failure the ownership
|
|
313
|
-
* rule exists to prevent.
|
|
314
|
-
*/
|
|
315
|
-
const RETIRED_WRITE_GATE_MATCHER = 'Write|Edit|MultiEdit';
|
|
316
|
-
const RETIRED_WRITE_GATE_COMMAND = /^node "[^"]*\/services\/hooks\/write-gate\.js"$/;
|
|
317
|
-
export function isRetiredTemplateEntry(entry) {
|
|
318
|
-
if (!isPreToolUseEntry(entry))
|
|
319
|
-
return false;
|
|
320
|
-
if (entry.matcher !== RETIRED_WRITE_GATE_MATCHER)
|
|
321
|
-
return false;
|
|
322
|
-
if (entry.hooks.length !== 1)
|
|
323
|
-
return false;
|
|
324
|
-
const handler = entry.hooks[0];
|
|
325
|
-
return handler.type === 'command' && RETIRED_WRITE_GATE_COMMAND.test(handler.command);
|
|
326
|
-
}
|
|
140
|
+
export const TEMPLATE_VERSION = '1.10.0';
|
|
327
141
|
/**
|
|
328
142
|
* TEMPLATE_VERSION 1.4.0 — the SOP gate-enforce handler, read from the same
|
|
329
143
|
* canonical hook spec `peaks hooks install` uses. Deriving it here (rather
|
|
@@ -347,11 +161,13 @@ function buildGateEnforceHandler() {
|
|
|
347
161
|
* forcing gate is a core feature that PreToolUse hooks can short-
|
|
348
162
|
* circuit but that the `permissions` block cannot.
|
|
349
163
|
*
|
|
350
|
-
* As of TEMPLATE_VERSION 1.
|
|
351
|
-
*
|
|
352
|
-
*
|
|
353
|
-
*
|
|
354
|
-
*
|
|
164
|
+
* As of TEMPLATE_VERSION 1.10.0 the template emits exactly TWO `Bash` matchers:
|
|
165
|
+
* the two below. (1.9.0 added one entry per layer-B feedback hook on top of
|
|
166
|
+
* them, which made four; 1.10.0 removed and retired those — see
|
|
167
|
+
* `isRetiredTemplateEntry`.) The `Write|Edit|MultiEdit` fact-forcing bypass is
|
|
168
|
+
* no longer a hook: it is the `env` exemption above, and that matcher's gate
|
|
169
|
+
* (`peaks code-gate`) is installed into the committed `.claude/settings.json`
|
|
170
|
+
* by `peaks hooks install`.
|
|
355
171
|
*/
|
|
356
172
|
export function buildClaudeSettingsLocalJson() {
|
|
357
173
|
return {
|
|
@@ -420,3 +236,32 @@ function buildBashGateStep08Handler() {
|
|
|
420
236
|
...(shell !== undefined ? { shell } : {})
|
|
421
237
|
};
|
|
422
238
|
}
|
|
239
|
+
/**
|
|
240
|
+
* TEMPLATE_VERSION 1.9.0 emitted the two layer-B feedback hooks from here; 1.10.0
|
|
241
|
+
* removed and RETIRED them. See `claude-settings-retirements.ts` for the retirement
|
|
242
|
+
* itself and for why declaring less cannot carry one. What is worth keeping here:
|
|
243
|
+
*
|
|
244
|
+
* - WHERE THEY LIVE NOW. `pre-tool-peaks-current-directory-scope.sh` and
|
|
245
|
+
* `pre-tool-piping-a-test-run-reports-the-pipes-exit-code.sh` are this
|
|
246
|
+
* repository's OWN development hooks, so their registration is in this
|
|
247
|
+
* repository's tracked `.claude/settings.json` — where `${CLAUDE_PROJECT_DIR}`
|
|
248
|
+
* really is the root that contains `src/`.
|
|
249
|
+
* - THE SHELL PIN THEY STILL CARRY, and why it is not the `powershell` their CLI
|
|
250
|
+
* siblings take. Measured on this host, both shapes run the script and both
|
|
251
|
+
* print its refusal to stderr — but not the same exit code:
|
|
252
|
+
*
|
|
253
|
+
* bash "<script>" exit 2 (the script's own code)
|
|
254
|
+
* powershell "<script>" exit 1 (flattened by the shell)
|
|
255
|
+
*
|
|
256
|
+
* Under the Claude Code hook protocol only exit 2 blocks; any other non-zero
|
|
257
|
+
* exit is a NON-BLOCKING ERROR and the tool call goes ahead. So `powershell`
|
|
258
|
+
* would turn the refusal into a log line and let the command through — the
|
|
259
|
+
* failure these entries exist to prevent. `shell` accepts `bash` and
|
|
260
|
+
* `powershell` only, and `bash` is also the interpreter the command names.
|
|
261
|
+
* - WHAT THEY REFUSE. `peaks-current-directory-scope` refuses global-state
|
|
262
|
+
* mutations (`npm i -g`, writes under `~/.claude`) unless the user explicitly
|
|
263
|
+
* authorises them; `piping-a-test-run-reports-the-pipes-exit-code` refuses a
|
|
264
|
+
* test run piped into a pager, because the exit code read afterwards is the
|
|
265
|
+
* pager's, not the runner's. `tests/unit/hooks/feedback-promoted-pretool-hooks.test.ts`
|
|
266
|
+
* drives both, with a plant for each.
|
|
267
|
+
*/
|
|
@@ -20,6 +20,9 @@
|
|
|
20
20
|
*/
|
|
21
21
|
import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync } from 'node:fs';
|
|
22
22
|
import { join } from 'node:path';
|
|
23
|
+
// Frozen: the filenames release 1.4.1 wrote, not the current contract. The
|
|
24
|
+
// entries name what this migration must FIND on an upgraded tree, so they stay
|
|
25
|
+
// bare even where a later release put the request id in the canonical name.
|
|
23
26
|
export const PER_SESSION_ARTIFACT_TYPES = [
|
|
24
27
|
'rd/tech-doc.md',
|
|
25
28
|
'rd/code-review.md',
|
|
@@ -277,7 +277,6 @@ function readActiveSkillSessionId(projectRoot) {
|
|
|
277
277
|
return null;
|
|
278
278
|
try {
|
|
279
279
|
// Sync read: tiny file, no I/O benefit from async
|
|
280
|
-
const { readFileSync } = require('node:fs');
|
|
281
280
|
const raw = readFileSync(pathToRead, 'utf8');
|
|
282
281
|
const parsed = JSON.parse(raw);
|
|
283
282
|
if (typeof parsed?.sessionId === 'string' && parsed.sessionId.length > 0) {
|
|
@@ -22,6 +22,16 @@ export declare function getNextNumber(dirPath: string): number;
|
|
|
22
22
|
*/
|
|
23
23
|
export declare function slugifyDescription(description: string): string;
|
|
24
24
|
export declare function buildNumberedFilename(number: number, description: string): string;
|
|
25
|
+
/**
|
|
26
|
+
* The id a markdown artifact's filename carries, or null when the name is not a
|
|
27
|
+
* markdown artifact at all. The READ side of `buildNumberedFilename`, in the same
|
|
28
|
+
* module, so writer and reader cannot drift apart from each other.
|
|
29
|
+
*
|
|
30
|
+
* The returned stem is not yet checked against the id pattern the artifact service
|
|
31
|
+
* owns; a caller that needs a legal request id applies that there rather than the
|
|
32
|
+
* pattern being imported here.
|
|
33
|
+
*/
|
|
34
|
+
export declare function requestIdFromFileName(fileName: string): string | null;
|
|
25
35
|
/**
|
|
26
36
|
* Get the next numbered file path in a directory.
|
|
27
37
|
* Combines getNextNumber() and buildNumberedFilename().
|
|
@@ -34,6 +34,19 @@ export function getNextNumber(dirPath) {
|
|
|
34
34
|
* @param description - Human-readable description (converted to kebab-case slug)
|
|
35
35
|
* @returns Formatted filename like "001-feature-name.md"
|
|
36
36
|
*/
|
|
37
|
+
/**
|
|
38
|
+
* The `<NNN>` prefix in a numbered filename is COSMETIC. `getNextNumber` reads
|
|
39
|
+
* the directory's highest prefix and adds one, and nothing claims a number in
|
|
40
|
+
* between — so two writers running at once can both read the same maximum and
|
|
41
|
+
* both stamp the same number. That is harmless only because the number is not
|
|
42
|
+
* an identity: what names an artifact is the slug (the request id), and every
|
|
43
|
+
* reader strips the prefix. Measured 2026-10-12: the sole consumers of the
|
|
44
|
+
* number are this module's writer path (`getNextNumber` -> `buildNumberedFilename`)
|
|
45
|
+
* and the read side (`requestIdFromFileName`, which discards it); the artifact
|
|
46
|
+
* service's duplicate check and lookup both key on the slug. Read that as a
|
|
47
|
+
* constraint: give the number a meaning and you must claim it atomically first,
|
|
48
|
+
* rather than assume this scan hands out unique values.
|
|
49
|
+
*/
|
|
37
50
|
// Windows supports up to 255 chars per filename component (and 260 for the
|
|
38
51
|
// full path). Pre-#015 the slug was silently truncated to 50 chars, which
|
|
39
52
|
// produced orphaned artefacts (the on-disk file no longer matched the
|
|
@@ -65,6 +78,20 @@ export function buildNumberedFilename(number, description) {
|
|
|
65
78
|
const slug = slugifyDescription(description);
|
|
66
79
|
return `${padded}-${slug}.md`;
|
|
67
80
|
}
|
|
81
|
+
/**
|
|
82
|
+
* The id a markdown artifact's filename carries, or null when the name is not a
|
|
83
|
+
* markdown artifact at all. The READ side of `buildNumberedFilename`, in the same
|
|
84
|
+
* module, so writer and reader cannot drift apart from each other.
|
|
85
|
+
*
|
|
86
|
+
* The returned stem is not yet checked against the id pattern the artifact service
|
|
87
|
+
* owns; a caller that needs a legal request id applies that there rather than the
|
|
88
|
+
* pattern being imported here.
|
|
89
|
+
*/
|
|
90
|
+
export function requestIdFromFileName(fileName) {
|
|
91
|
+
if (!fileName.endsWith('.md'))
|
|
92
|
+
return null;
|
|
93
|
+
return fileName.replace(/^0\d{2}-/, '').replace(/\.md$/, '');
|
|
94
|
+
}
|
|
68
95
|
/**
|
|
69
96
|
* Get the next numbered file path in a directory.
|
|
70
97
|
* Combines getNextNumber() and buildNumberedFilename().
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "peaks-loop",
|
|
3
|
-
"version": "4.1.
|
|
3
|
+
"version": "4.1.5",
|
|
4
4
|
"description": "Loop Engineering CLI — workflow primitive / loop guards / evaluators / slice orchestration",
|
|
5
5
|
"author": "SquabbyZ",
|
|
6
6
|
"keywords": [
|
|
@@ -129,10 +129,10 @@
|
|
|
129
129
|
"picomatch": "4.0.4",
|
|
130
130
|
"yaml": "^2.9.0",
|
|
131
131
|
"zod": "^4.4.3",
|
|
132
|
-
"peaks-loop-internal-runtime": "0.0.
|
|
133
|
-
"peaks-loop-
|
|
134
|
-
"peaks-loop-
|
|
135
|
-
"peaks-loop-shared": "0.0.
|
|
132
|
+
"peaks-loop-internal-runtime": "0.0.45",
|
|
133
|
+
"peaks-loop-shared-channel": "0.0.62",
|
|
134
|
+
"peaks-loop-mut": "0.1.59",
|
|
135
|
+
"peaks-loop-shared": "0.0.94"
|
|
136
136
|
},
|
|
137
137
|
"devDependencies": {
|
|
138
138
|
"@changesets/cli": "2.31.1",
|
|
@@ -12,7 +12,7 @@ metadata:
|
|
|
12
12
|
- schema: .peaks/project-scan/audit-output-schema.md
|
|
13
13
|
---
|
|
14
14
|
|
|
15
|
-
<!-- peaks:loop-hygiene — HAND-MAINTAINED block, NOT generated; byte-identical in every SKILL.md, enforced by tests/unit/skills/loop-hygiene-block.test.ts. Edit one, edit all
|
|
15
|
+
<!-- peaks:loop-hygiene — HAND-MAINTAINED block, NOT generated; byte-identical in every SKILL.md, enforced by tests/unit/skills/loop-hygiene-block.test.ts. Edit one, edit all 23. -->
|
|
16
16
|
|
|
17
17
|
## Loop hygiene (every turn — MANDATORY)
|
|
18
18
|
|
|
@@ -8,7 +8,7 @@ description: |
|
|
|
8
8
|
visibility: internal
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
<!-- peaks:loop-hygiene — HAND-MAINTAINED block, NOT generated; byte-identical in every SKILL.md, enforced by tests/unit/skills/loop-hygiene-block.test.ts. Edit one, edit all
|
|
11
|
+
<!-- peaks:loop-hygiene — HAND-MAINTAINED block, NOT generated; byte-identical in every SKILL.md, enforced by tests/unit/skills/loop-hygiene-block.test.ts. Edit one, edit all 23. -->
|
|
12
12
|
|
|
13
13
|
## Loop hygiene (every turn — MANDATORY)
|
|
14
14
|
|
|
@@ -8,7 +8,7 @@ description: |
|
|
|
8
8
|
visibility: internal
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
<!-- peaks:loop-hygiene — HAND-MAINTAINED block, NOT generated; byte-identical in every SKILL.md, enforced by tests/unit/skills/loop-hygiene-block.test.ts. Edit one, edit all
|
|
11
|
+
<!-- peaks:loop-hygiene — HAND-MAINTAINED block, NOT generated; byte-identical in every SKILL.md, enforced by tests/unit/skills/loop-hygiene-block.test.ts. Edit one, edit all 23. -->
|
|
12
12
|
|
|
13
13
|
## Loop hygiene (every turn — MANDATORY)
|
|
14
14
|
|
|
@@ -13,8 +13,8 @@ This chain ends with `git worktree add` (superpowers:using-git-worktrees SKILL.m
|
|
|
13
13
|
|
|
14
14
|
For worktree operations, use ONLY:
|
|
15
15
|
|
|
16
|
-
- `peaks worktree spawn --rid <rid> --
|
|
17
|
-
- until then: `peaks worktree auth grant --
|
|
16
|
+
- `peaks worktree spawn --rid <rid> --role <role> --purpose <text>` (after rid-L2-extended ships)
|
|
17
|
+
- until then: `peaks worktree auth grant --operation <op> --reason <text>` (`<op>`, e.g. `git-worktree` | `agent-isolation-worktree`)
|
|
18
18
|
|
|
19
19
|
The superpowers skills remain available as REFERENCE material for brainstorming / planning techniques, but MUST NOT be used as a workflow. peaks-qa's own QA artifacts (`.peaks/_runtime/<sessionId>/qa/<artifact>.md`) are authoritative.
|
|
20
20
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> Body of `### Transition verification gates`. You cannot declare a phase complete from memory. Each gate below is a `ls` or `grep` command you **MUST run** and whose output you **MUST see** before proceeding. If any file shows "No such file" or any command returns empty, the phase is incomplete.
|
|
4
4
|
|
|
5
|
-
> **CLI enforcement (v2.11.0 D1/D4 trim)**: the gates below are enforced by `peaks request transition`. The CLI checks the same files before allowing the transition and fails with `code: PREREQUISITES_MISSING` if any are absent. Required files depend on the request type recorded at `peaks request init --type ...`. **As of v2.11.0:** peaks-qa does NOT own security-findings or performance-findings —
|
|
5
|
+
> **CLI enforcement (v2.11.0 D1/D4 trim)**: the gates below are enforced by `peaks request transition`. The CLI checks the same files before allowing the transition and fails with `code: PREREQUISITES_MISSING` if any are absent. Required files depend on the request type recorded at `peaks request init --type ...`. **As of v2.11.0:** peaks-qa does NOT own security-findings or performance-findings — peaks-rd's audit fan-out produces that evidence as `audit/security-<rid>.md` and `audit/perf-<rid>.md` (the standalone skills in the paragraph below; the paths named here were `rd/security-review.md` / `rd/perf-baseline.md` until v2.12.0 and remain readable back-compat tiers), and the QA test report references it rather than requiring separate files.
|
|
6
6
|
|
|
7
7
|
| Type | qa:running requires | qa:verdict-issued also requires |
|
|
8
8
|
|---|---|---|
|
|
@@ -9,7 +9,7 @@ description: |
|
|
|
9
9
|
visibility: internal
|
|
10
10
|
---
|
|
11
11
|
|
|
12
|
-
<!-- peaks:loop-hygiene — HAND-MAINTAINED block, NOT generated; byte-identical in every SKILL.md, enforced by tests/unit/skills/loop-hygiene-block.test.ts. Edit one, edit all
|
|
12
|
+
<!-- peaks:loop-hygiene — HAND-MAINTAINED block, NOT generated; byte-identical in every SKILL.md, enforced by tests/unit/skills/loop-hygiene-block.test.ts. Edit one, edit all 23. -->
|
|
13
13
|
|
|
14
14
|
## Loop hygiene (every turn — MANDATORY)
|
|
15
15
|
|
|
@@ -85,7 +85,7 @@ For frontend / UI-affecting slices, RD's self-test uses the Playwright MCP heade
|
|
|
85
85
|
|
|
86
86
|
When this skill is launched as a sub-agent via `peaks sub-agent dispatch <role>` (then the LLM executes the returned toolCall) from `peaks-code`, the following sections of THIS skill are **suspended** for the sub-agent run: Session id (use parent's), Skill presence, Workspace initialization, Mode selection, Statusline install.
|
|
87
87
|
|
|
88
|
-
What the sub-agent MUST still do: read PRD via `peaks request show`, run standards preflight (dry-run only), write planning artefact (`rd/tech-doc.md` for feature/refactor; `rd/bug-analysis
|
|
88
|
+
What the sub-agent MUST still do: read PRD via `peaks request show`, run standards preflight (dry-run only), write planning artefact (`rd/tech-doc.md` for feature/refactor; `rd/bug-analysis-<rid>.md` for bugfix; skip for config/docs/chore), return compact JSON envelope.
|
|
89
89
|
|
|
90
90
|
→ see `references/rd-sub-agent-dispatch.md` for the full contract + hard prohibitions.
|
|
91
91
|
|
|
@@ -230,7 +230,7 @@ refusing — matching the prereq-side acceptance above.
|
|
|
230
230
|
|---|---|
|
|
231
231
|
| feature / refactor | `prd/handoff.md` (immutable) + `audit/security-<rid>.md` (peaks-security-audit) + `audit/perf-<rid>.md` (peaks-perf-audit) + `rd/code-review-<rid>.md` + `rd/karpathy-review-<rid>.md` + `qa/test-cases/<rid>.md` |
|
|
232
232
|
| bugfix | `prd/handoff.md` (immutable) + `audit/security-<rid>.md` (peaks-security-audit) + `audit/perf-<rid>.md` (peaks-perf-audit, perf-shaped only) + `rd/code-review-<rid>.md` + `rd/karpathy-review-<rid>.md` + `qa/test-cases/<rid>.md` |
|
|
233
|
-
| config | `rd/security-review
|
|
233
|
+
| config | `rd/security-review-<rid>.md` (`SECURITY_REVIEW.relativePath` carries the `<rid>` since slice 9.37; the bare name stays readable as the legacy tier) |
|
|
234
234
|
| docs / chore | (no extra evidence required) |
|
|
235
235
|
|
|
236
236
|
Always required (in addition to the type-specific row):
|
|
@@ -13,8 +13,8 @@ This chain ends with `git worktree add` (superpowers:using-git-worktrees SKILL.m
|
|
|
13
13
|
|
|
14
14
|
For worktree operations, use ONLY:
|
|
15
15
|
|
|
16
|
-
- `peaks worktree spawn --rid <rid> --
|
|
17
|
-
- until then: `peaks worktree auth grant --
|
|
16
|
+
- `peaks worktree spawn --rid <rid> --role <role> --purpose <text>` (after rid-L2-extended ships)
|
|
17
|
+
- until then: `peaks worktree auth grant --operation <op> --reason <text>` (`<op>`, e.g. `git-worktree` | `agent-isolation-worktree`)
|
|
18
18
|
|
|
19
19
|
The superpowers skills remain available as REFERENCE material for brainstorming / planning techniques, but MUST NOT be used as a workflow. peaks-rd's own PRD/RD artifacts (`.peaks/_runtime/<sessionId>/rd/requests/<rid>.md`) are authoritative.
|
|
20
20
|
|
|
@@ -70,7 +70,7 @@ What the sub-agent **MUST** still do, from this skill's contract:
|
|
|
70
70
|
2. `peaks request show <rid> --role prd --project <repo> --json` (and `--role ui` if UI is in the swarm plan).
|
|
71
71
|
3. Standards preflight (dry-run only; Code owns the apply step).
|
|
72
72
|
4. Project-scan read; create `rd/project-scan.md` only if Code flagged it missing in the dispatch prompt.
|
|
73
|
-
5. Write the planning artefact: `rd/requests/<rid>.md` (feature/refactor, per the `artifact-per-request.md` contract) or `rd/bug-analysis
|
|
73
|
+
5. Write the planning artefact: `rd/requests/<rid>.md` (feature/refactor, per the `artifact-per-request.md` contract) or `rd/bug-analysis-<rid>.md` (bugfix). If `--type` is `config|docs|chore`, **no planning artefact is required** — return immediately with `{"role":"rd-planning","status":"skipped","reason":"type=<type>"}`.
|
|
74
74
|
|
|
75
75
|
> **v2.11.0 change (Group A):** `rd/tech-doc.md` is removed. The per-slice planning record is the per-request artefact at `rd/requests/<rid>.md`; the slice's source-of-truth architecture is the immutable peaks-prd handoff at `prd/handoff.md` (verify handoff hash = `<dispatched value>` before reading).
|
|
76
76
|
6. Return only a compact JSON envelope — Code will run the convergence gate (`ls` checks):
|
|
@@ -139,6 +139,8 @@ See the block constant at `src/services/dispatch/test-tool-detection.ts` for the
|
|
|
139
139
|
|
|
140
140
|
When the dispatch primitive constructs the sub-agent prompt, the following context block MUST be appended to the sub-agent prompt verbatim. The block is the canonical injection source for any RD-spawned sub-agent (including 4-way fanout, including inline main-loop RD).
|
|
141
141
|
|
|
142
|
+
**The dispatch CLI now does this itself (2026-10-13).** `peaks sub-agent dispatch` runs `ensureKarpathyBlock` over the assembled prompt (`src/services/dispatch/karpathy-block.ts`, applied in `src/cli/commands/dispatch-prompt-composition.ts`), so the block reaches the child whether or not the caller remembers to append it. A caller that already appended it is not appended twice. The constant is the machine copy of the block below, and a unit test asserts the two are byte-equal, so neither can drift. What the obligation still covers is the path that does NOT go through this CLI: `--from-dag` (`src/services/code/dag-orchestrator.ts`) and `--mode detached` inject no Karpathy block, so a caller using either must append it itself.
|
|
143
|
+
|
|
142
144
|
```
|
|
143
145
|
Karpathy-guidelines context (REQUIRED — read before any code action)
|
|
144
146
|
|
|
@@ -161,7 +163,9 @@ Touch only what you must. Clean up only your own mess. When editing existing cod
|
|
|
161
163
|
Define success criteria. Loop until verified. "Add validation" → write tests for invalid inputs, then make them pass. "Fix the bug" → write a test that reproduces it, then make it pass. For multi-step tasks, state a brief plan with verify checkpoints. Strong success criteria let you loop independently. Weak criteria require constant clarification.
|
|
162
164
|
```
|
|
163
165
|
|
|
164
|
-
Sub-agents MUST NOT silently drop this block.
|
|
166
|
+
Sub-agents MUST NOT silently drop this block. The canonical skill id for the full guidelines text is `andrej-karpathy-skills:karpathy-guidelines`.
|
|
167
|
+
|
|
168
|
+
Corrected 2026-10-13, kept visible rather than edited away: this paragraph used to read *"Nothing asserts its presence automatically — the unit test that did was deleted in `f17aa377`, so a dropped block fails silently."* That was true when written and it was the defect. The composer now injects the block and `tests/unit/services/dispatch/karpathy-block.test.ts` + `tests/unit/skills/karpathy-injection.test.ts` assert both the delivery and the byte-equality of this file's block with the constant, so a dropped block no longer fails silently on the CLI path. Measured 2026-10-12, before the executor existed: four RD dispatch prompts in one session carried zero occurrences of `Karpathy`.
|
|
165
169
|
|
|
166
170
|
## BDD Test Style Contract (effective rid-2026-08-05-bdd-test-style, v4.0.11+)
|
|
167
171
|
|
|
@@ -11,10 +11,10 @@ You cannot declare a phase complete from memory. Each gate below is a `ls` or `g
|
|
|
11
11
|
> | Type | rd:implemented requires | rd:qa-handoff also requires |
|
|
12
12
|
> |---|---|---|
|
|
13
13
|
> | feature / refactor | `rd/tech-doc.md` | `rd/code-review-<rid>.md` + `audit/security-<rid>.md` + `audit/perf-<rid>.md` (filled Results table, or `N/A — no perf surface` in Notes) + **`qa/test-cases/<rid>.md`** (added in slice 004; pre-drafted by the 4th sub-agent in the parallel fan-out) |
|
|
14
|
-
> | bugfix | `rd/bug-analysis
|
|
15
|
-
> | config | (none) | `rd/security-review
|
|
14
|
+
> | bugfix | `rd/bug-analysis-<rid>.md` (lighter than tech-doc; root cause + fix + regression test plan) | `rd/code-review-<rid>.md` + `audit/security-<rid>.md` + **`qa/test-cases/<rid>.md`**; `audit/perf-<rid>.md` only when the bug is performance-shaped (matches the L449-452 "When this applies" criteria) |
|
|
15
|
+
> | config | (none) | `rd/security-review-<rid>.md` only — `SECURITY_REVIEW.relativePath` carries the `<rid>` since slice 9.37 |
|
|
16
16
|
>
|
|
17
|
-
> The `<rid>`-bearing names are the ones `peaks request transition` resolves first; the pre-rid names (`rd/code-review.md`, `rd/security-review.md`, `audit/security.md`, `audit/perf.md`) stay **readable** as back-compat tiers for sessions written before
|
|
17
|
+
> The `<rid>`-bearing names are the ones `peaks request transition` resolves first; the pre-rid names (`rd/bug-analysis.md`, `rd/code-review.md`, `rd/security-review.md`, `audit/security.md`, `audit/perf.md`) stay **readable** as back-compat tiers for sessions written before the rid was added to the filename — read, never written. Exception: `rd/perf-baseline.md` is the RD-side Gate B9 baseline (a different artifact from `audit/perf-<rid>.md`) and is still both written by `peaks perf baseline --apply` and read as `AUDIT_PERF`'s oldest legacy tier.
|
|
18
18
|
> | docs / chore | (none) | (none) |
|
|
19
19
|
>
|
|
20
20
|
> The escape hatch `--allow-incomplete --reason "<text>"` still exists for one-off exceptions; the bypass is recorded in the artifact transition note.
|
|
@@ -9,10 +9,10 @@ into two new standalone audit skills.
|
|
|
9
9
|
## Removed sub-agent slots
|
|
10
10
|
|
|
11
11
|
- `security-reviewer` — moved to standalone `peaks-security-audit` skill.
|
|
12
|
-
Output: `.peaks/_runtime/<sessionId>/audit/security
|
|
12
|
+
Output: `.peaks/_runtime/<sessionId>/audit/security-<rid>.md`.
|
|
13
13
|
Required RD-side prereq: `AUDIT_SECURITY`.
|
|
14
14
|
- `perf-baseline-reviewer` — moved to standalone `peaks-perf-audit` skill.
|
|
15
|
-
Output: `.peaks/_runtime/<sessionId>/audit/perf
|
|
15
|
+
Output: `.peaks/_runtime/<sessionId>/audit/perf-<rid>.md`.
|
|
16
16
|
Required RD-side prereq: `AUDIT_PERF`.
|
|
17
17
|
|
|
18
18
|
Both audit skills consume the immutable peaks-prd handoff
|
|
@@ -67,7 +67,7 @@ gateEvidence:
|
|
|
67
67
|
- `nextActions[]` — verb-first; what peaks-qa should do next, in order.
|
|
68
68
|
- `gateEvidence` — paths to the gate files peaks-qa will validate. **DERIVED, never hand-written**: the producer computes it from the request `type` (`src/services/prd/gate-evidence-derivation.ts`), and Gate C reads the same `rd:qa-handoff` row, so the block and the gate cannot disagree. It declares that row's evidence, plus `projectScan` (Gate A's artifact — declared only where Gate C runs, since a path nothing verifies should not be declared):
|
|
69
69
|
- `feature` / `refactor` / `bugfix` → **5 keys**: `projectScan`, `prdHandoff`, `codeReview`, `securityReview`, `perfBaseline`
|
|
70
|
-
- `config` → **2 keys**: `projectScan`, `securityReview`. `CONFIG_TABLE['rd:qa-handoff']` is the security review alone, so a config slice has **no** `prdHandoff`; and its security evidence is
|
|
70
|
+
- `config` → **2 keys**: `projectScan`, `securityReview`. `CONFIG_TABLE['rd:qa-handoff']` is the security review alone, so a config slice has **no** `prdHandoff`; and its security evidence is `rd/security-review-<rid>.md` (scoped by rid since slice 9.37), not `audit/security-<rid>.md`.
|
|
71
71
|
- `docs` / `chore` → **no `gateEvidence` block at all**. Those types have no `rd:qa-handoff` row: there is no evidence to declare and nothing for Gate C to check, so the block is omitted rather than filled with an unverified statement. Such a capsule is byte-identical to a pre-B2 one.
|
|
72
72
|
**The Gate C failure rule is scoped to the types above** — where that gate runs: a declared path that does not exist fails `peaks request transition --state qa-handoff` (`PREREQUISITES_MISSING`), naming the key. Two shapes are deliberately NOT failures: a capsule for a type with no `rd:qa-handoff` row (the check does not run), and an **empty** declaration (`gateEvidence: {}`) — a weak claim, not a false one, since the type's artifacts remain enforced by the table itself, so an empty map cannot open the gate. When the request type cannot be resolved at all, the block is omitted rather than half-declared.
|
|
73
73
|
- `schemaVersion: 2` — pinned, and written PLAIN (no quotes). The constant is `HANDOFF_SCHEMA_VERSION` in `src/services/prd/handoff-frontmatter-shape.ts` and its value is the string `'2'`; the serializer emits it unquoted, because `AUDIT_REQUIRES_HANDOFF` matches the substring `schemaVersion: 2` and a quoted `'2'` would not contain it. `readHandoff` accepts `'2'` or the bare number `2` and nothing else — **`'2.0'` is not a valid value here**, and this document said it was until it was measured against the serializer. Bump only when the field set changes.
|
|
@@ -4,7 +4,7 @@ visibility: internal
|
|
|
4
4
|
description: Third-party independent code-review skill for Peaks. Use as a parallel reviewer to karpathy-reviewer when a workflow needs an out-of-band (non-RD-model) review pass to mitigate single-LLM self-dogfood blind spots. Emits a schema-validated ReviewerEnvelope (no free-form LLM JSON). v2.14.0 G4.
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
<!-- peaks:loop-hygiene — HAND-MAINTAINED block, NOT generated; byte-identical in every SKILL.md, enforced by tests/unit/skills/loop-hygiene-block.test.ts. Edit one, edit all
|
|
7
|
+
<!-- peaks:loop-hygiene — HAND-MAINTAINED block, NOT generated; byte-identical in every SKILL.md, enforced by tests/unit/skills/loop-hygiene-block.test.ts. Edit one, edit all 23. -->
|
|
8
8
|
|
|
9
9
|
## Loop hygiene (every turn — MANDATORY)
|
|
10
10
|
|