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,142 @@
|
|
|
1
|
+
import { existsSync } from 'node:fs';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { getSessionMeta } from '../../../services/session/session-manager.js';
|
|
4
|
+
import { resolveCanonicalProjectRoot } from '../../../services/config/config-service.js';
|
|
5
|
+
import { findProjectRoot } from '../../../services/config/config-safety.js';
|
|
6
|
+
import { fail, ok } from 'peaks-loop-shared/result';
|
|
7
|
+
import { addJsonOption, printResult } from '../../cli-helpers.js';
|
|
8
|
+
/** Exit codes for a rejected `--caller-id`, by the resolver's own errno. */
|
|
9
|
+
const EXIT_USAGE = 64;
|
|
10
|
+
const EXIT_DATAERR = 65;
|
|
11
|
+
/** The advisory that rides every read off the pre-canonical binding dotfile. */
|
|
12
|
+
const LEGACY_WARNING = 'Read from legacy back-compat path .peaks/.session.json. Run `peaks workspace reconcile --apply` to migrate to the canonical home (.peaks/_runtime/session.json).';
|
|
13
|
+
/** `canonical` = `.peaks/_runtime/session.json`; `legacy` = `.peaks/.session.json`. */
|
|
14
|
+
function bindingSourceOf(projectRoot) {
|
|
15
|
+
return existsSync(join(projectRoot, '.peaks', '_runtime', 'session.json'))
|
|
16
|
+
? 'canonical'
|
|
17
|
+
: 'legacy';
|
|
18
|
+
}
|
|
19
|
+
function bindingPathOf(projectRoot, source) {
|
|
20
|
+
return source === 'canonical'
|
|
21
|
+
? join(projectRoot, '.peaks', '_runtime', 'session.json')
|
|
22
|
+
: join(projectRoot, '.peaks', '.session.json');
|
|
23
|
+
}
|
|
24
|
+
/** A `--caller-id` the resolver rejected (D5 → exit 65; EX_USAGE → exit 64). */
|
|
25
|
+
function emitCallerIdInvalid(io, options, error) {
|
|
26
|
+
printResult(io, fail('session.info', 'CALLER_ID_INVALID', error.message, { source: error.source }, [
|
|
27
|
+
`Set --caller-id to a value matching ^[a-zA-Z0-9._-]{1,200}$`,
|
|
28
|
+
'Or set PEAKS_CALLER_ID env var (or CLAUDE_CODE_SESSION_ID for Claude Code)'
|
|
29
|
+
]), options.json);
|
|
30
|
+
process.exitCode = error.code === 'EX_USAGE' ? EXIT_USAGE : EXIT_DATAERR;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* `--caller-id` together with `--active`: look up the binding this callerId
|
|
34
|
+
* holds, so the envelope carries both the resolved id and its peak session.
|
|
35
|
+
*/
|
|
36
|
+
async function emitCallerBinding(io, options, projectRoot, callerId) {
|
|
37
|
+
const { getSessionIdCanonical } = await import('../../../services/session/session-manager.js');
|
|
38
|
+
const { getCallerBinding } = await import('../../../services/session/caller-binding-service.js');
|
|
39
|
+
const callerBinding = getCallerBinding(projectRoot, callerId);
|
|
40
|
+
printResult(io, ok('session.info', {
|
|
41
|
+
active: true,
|
|
42
|
+
sessionId: getSessionIdCanonical(projectRoot),
|
|
43
|
+
callerId,
|
|
44
|
+
callerBindingPeakSessionId: callerBinding?.peakSessionId ?? null,
|
|
45
|
+
source: bindingSourceOf(projectRoot)
|
|
46
|
+
}), options.json);
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Resolve `--caller-id` (D1/D5 validation) and report it. An invalid flag
|
|
50
|
+
* throws `CallerIdError`, which is surfaced as `CALLER_ID_INVALID`; anything
|
|
51
|
+
* else propagates.
|
|
52
|
+
*/
|
|
53
|
+
async function emitCallerIdPath(io, options, projectRoot, flagValue) {
|
|
54
|
+
const { resolveCallerId, CallerIdError } = await import('../../../services/session/resolve-caller-id.js');
|
|
55
|
+
let callerId;
|
|
56
|
+
try {
|
|
57
|
+
callerId = resolveCallerId({ flagValue });
|
|
58
|
+
}
|
|
59
|
+
catch (error) {
|
|
60
|
+
if (error instanceof CallerIdError) {
|
|
61
|
+
emitCallerIdInvalid(io, options, error);
|
|
62
|
+
return;
|
|
63
|
+
}
|
|
64
|
+
throw error;
|
|
65
|
+
}
|
|
66
|
+
if (options.active === true) {
|
|
67
|
+
await emitCallerBinding(io, options, projectRoot, callerId);
|
|
68
|
+
return;
|
|
69
|
+
}
|
|
70
|
+
printResult(io, ok('session.info', {
|
|
71
|
+
callerId,
|
|
72
|
+
note: '--caller-id resolved; pass --active to also look up the bound peak session'
|
|
73
|
+
}), options.json);
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* `--active` without `--caller-id`: the SOLE authoritative lookup of the
|
|
77
|
+
* active session id — composes on `getSessionIdCanonical`
|
|
78
|
+
* (canonicalize-on-read) and falls through to `getSessionId`
|
|
79
|
+
* (strict-equality) for callers on the original contract. NEITHER path calls
|
|
80
|
+
* `ensureSession()` — that would side-effect-create a fresh binding on miss,
|
|
81
|
+
* erasing the "no active session" signal sub-agents rely on.
|
|
82
|
+
*/
|
|
83
|
+
async function emitActiveBinding(io, options, projectRoot) {
|
|
84
|
+
const { getSessionIdCanonical, getSessionId } = await import('../../../services/session/session-manager.js');
|
|
85
|
+
let activeSid = getSessionIdCanonical(projectRoot);
|
|
86
|
+
if (activeSid === null)
|
|
87
|
+
activeSid = getSessionId(projectRoot);
|
|
88
|
+
if (activeSid === null) {
|
|
89
|
+
printResult(io, fail('session.info', 'NO_ACTIVE_SESSION', 'No session bound. Run `peaks workspace init --project <repo> --json` to bind one.', { projectRoot }, [`peaks workspace init --project ${projectRoot} --json`]), options.json);
|
|
90
|
+
process.exitCode = 1;
|
|
91
|
+
return;
|
|
92
|
+
}
|
|
93
|
+
const source = bindingSourceOf(projectRoot);
|
|
94
|
+
printResult(io, ok('session.info', {
|
|
95
|
+
active: true,
|
|
96
|
+
sessionId: activeSid,
|
|
97
|
+
bindingPath: bindingPathOf(projectRoot, source),
|
|
98
|
+
projectRoot,
|
|
99
|
+
source
|
|
100
|
+
}, source === 'legacy' ? [LEGACY_WARNING] : []), options.json);
|
|
101
|
+
}
|
|
102
|
+
/** Explicit `<sessionId>`: read that session's metadata, or refuse. */
|
|
103
|
+
function emitSessionById(io, sessionId, options, projectRoot) {
|
|
104
|
+
if (sessionId === undefined) {
|
|
105
|
+
printResult(io, fail('session.info', 'SESSION_ID_REQUIRED', 'session.info requires a <sessionId> or --active', {}, ['Pass a <sessionId> argument, or use --active to resolve the canonical binding']), options.json);
|
|
106
|
+
process.exitCode = 1;
|
|
107
|
+
return;
|
|
108
|
+
}
|
|
109
|
+
const meta = getSessionMeta(projectRoot, sessionId);
|
|
110
|
+
if (meta === null) {
|
|
111
|
+
printResult(io, fail('session.info', 'SESSION_NOT_FOUND', `Session "${sessionId}" not found or has no metadata`, { sessionId }, ['Use `peaks session list` to see available sessions']), options.json);
|
|
112
|
+
process.exitCode = 1;
|
|
113
|
+
return;
|
|
114
|
+
}
|
|
115
|
+
printResult(io, ok('session.info', meta), options.json);
|
|
116
|
+
}
|
|
117
|
+
async function runSessionInfo(io, sessionId, options) {
|
|
118
|
+
const projectRoot = options.project !== undefined
|
|
119
|
+
? resolveCanonicalProjectRoot(options.project)
|
|
120
|
+
: (findProjectRoot(process.cwd()) ?? process.cwd());
|
|
121
|
+
if (options.callerId !== undefined) {
|
|
122
|
+
await emitCallerIdPath(io, options, projectRoot, options.callerId);
|
|
123
|
+
return;
|
|
124
|
+
}
|
|
125
|
+
if (options.active === true) {
|
|
126
|
+
await emitActiveBinding(io, options, projectRoot);
|
|
127
|
+
return;
|
|
128
|
+
}
|
|
129
|
+
emitSessionById(io, sessionId, options, projectRoot);
|
|
130
|
+
}
|
|
131
|
+
export function registerSessionInfoCommand(session, io) {
|
|
132
|
+
addJsonOption(session
|
|
133
|
+
.command('info [sessionId]')
|
|
134
|
+
.description('Show full metadata for a session directory. Pass --active to resolve the canonical binding from .peaks/_runtime/session.json (the "one command a sub-agent runs to find the parent\'s sid" primitive). Slice 021: --active is the SOLE authoritative way to look up the active session id; the on-disk file path is internal and must NOT be `cat`-ed directly.')
|
|
135
|
+
.option('--active', 'resolve the canonical session id from .peaks/_runtime/session.json (ignores [sessionId] when set)')
|
|
136
|
+
.option('--project <path>', 'target project root (defaults to git root or cwd). Slice 021: lets sub-agents skip the cwd heuristic and look up the binding for a specific repo.')
|
|
137
|
+
// overrides the per-process PEAKS_CALLER_ID env var and the
|
|
138
|
+
// PLATFORM_FALLBACKS table (D4 priority). The resolved callerId is
|
|
139
|
+
// surfaced in the JSON envelope so callers can confirm what was
|
|
140
|
+
// resolved without re-deriving it.
|
|
141
|
+
.option('--caller-id <id>', 'Override the caller id for this invocation (D4 priority: flag beats env beats platform fallback). When set, the response envelope includes the resolved callerId.')).action((sessionId, options) => runSessionInfo(io, sessionId, options));
|
|
142
|
+
}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { Command } from 'commander';
|
|
2
|
+
import { type ProgramIO } from '../../cli-helpers.js';
|
|
3
|
+
export declare function registerSessionListCommand(session: Command, io: ProgramIO): void;
|
|
4
|
+
export declare function registerSessionTitleCommand(session: Command, io: ProgramIO): void;
|
|
5
|
+
export declare function registerSessionRotateCommand(session: Command, io: ProgramIO): void;
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { listSessionMetas, rotateSessionBinding, setSessionTitle } from '../../../services/session/session-manager.js';
|
|
2
|
+
import { resolveCanonicalProjectRoot } from '../../../services/config/config-service.js';
|
|
3
|
+
import { findProjectRoot } from '../../../services/config/config-safety.js';
|
|
4
|
+
import { fail, ok } from 'peaks-loop-shared/result';
|
|
5
|
+
import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
|
|
6
|
+
export function registerSessionListCommand(session, io) {
|
|
7
|
+
addJsonOption(session.command('list').description('List all session directories with titles and metadata')).action((options) => {
|
|
8
|
+
const projectRoot = findProjectRoot(process.cwd()) ?? process.cwd();
|
|
9
|
+
const metas = listSessionMetas(projectRoot);
|
|
10
|
+
printResult(io, ok('session.list', { sessions: metas, total: metas.length }), options.json);
|
|
11
|
+
});
|
|
12
|
+
}
|
|
13
|
+
export function registerSessionTitleCommand(session, io) {
|
|
14
|
+
addJsonOption(session
|
|
15
|
+
.command('title <sessionId> <title>')
|
|
16
|
+
.description('Set a human-readable title for a session directory')).action((sessionId, title, options) => {
|
|
17
|
+
const projectRoot = findProjectRoot(process.cwd()) ?? process.cwd();
|
|
18
|
+
try {
|
|
19
|
+
const meta = setSessionTitle(projectRoot, sessionId, title);
|
|
20
|
+
printResult(io, ok('session.title', meta), options.json);
|
|
21
|
+
}
|
|
22
|
+
catch (error) {
|
|
23
|
+
printResult(io, fail('session.title', 'SESSION_TITLE_FAILED', getErrorMessage(error), { sessionId }, [
|
|
24
|
+
'Verify the sessionId exists under .peaks/'
|
|
25
|
+
]), options.json);
|
|
26
|
+
process.exitCode = 1;
|
|
27
|
+
}
|
|
28
|
+
});
|
|
29
|
+
}
|
|
30
|
+
export function registerSessionRotateCommand(session, io) {
|
|
31
|
+
addJsonOption(session
|
|
32
|
+
.command('rotate')
|
|
33
|
+
.description('Drop the project-level session binding so the next peaks call auto-generates a fresh session id. The on-disk session directory is left intact — only .peaks/.session.json is removed.')
|
|
34
|
+
.option('--project <path>', 'target project root (defaults to git root or cwd)')
|
|
35
|
+
.option('--reason <text>', 'human-readable reason for the rotation, recorded in the response data')).action((options) => {
|
|
36
|
+
try {
|
|
37
|
+
// Canonicalise the project root before touching the binding: `peaks
|
|
38
|
+
// workspace init` writes it realpath-resolved, and readSessionFile's
|
|
39
|
+
// strict projectRoot equality check would otherwise miss a path that
|
|
40
|
+
// came through a symlink (notably /tmp on macOS).
|
|
41
|
+
const projectRoot = options.project !== undefined
|
|
42
|
+
? options.project
|
|
43
|
+
: (findProjectRoot(process.cwd()) ?? process.cwd());
|
|
44
|
+
const previousSessionId = rotateSessionBinding(resolveCanonicalProjectRoot(projectRoot));
|
|
45
|
+
printResult(io, ok('session.rotate', {
|
|
46
|
+
previousSessionId,
|
|
47
|
+
...(options.reason !== undefined ? { reason: options.reason } : {}),
|
|
48
|
+
note: previousSessionId === null
|
|
49
|
+
? 'No prior binding was present; the project is already unbound.'
|
|
50
|
+
: 'Next ensureSession() call will auto-generate a fresh id. The previous session directory is still on disk at .peaks/_runtime/<previousSessionId>/.'
|
|
51
|
+
}), options.json);
|
|
52
|
+
}
|
|
53
|
+
catch (error) {
|
|
54
|
+
printResult(io, fail('session.rotate', 'SESSION_ROTATE_FAILED', getErrorMessage(error), { projectRoot: options.project }, ['Verify the project path exists and is writable']), options.json);
|
|
55
|
+
process.exitCode = 1;
|
|
56
|
+
}
|
|
57
|
+
});
|
|
58
|
+
}
|
|
@@ -1,27 +1,4 @@
|
|
|
1
1
|
import type { Command } from 'commander';
|
|
2
2
|
import { type ProgramIO } from '../../cli-helpers.js';
|
|
3
|
-
|
|
4
|
-
export declare const LOOP_ENGINEERING_CATEGORY = "loop-engineering";
|
|
5
|
-
/** Project-relative location of the file the `loop-engineering` lint reads. */
|
|
6
|
-
export declare const LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH = ".peaks/standards/loop-engineering-guidelines.md";
|
|
7
|
-
export interface StandardsLintEnvelope {
|
|
8
|
-
ok: boolean;
|
|
9
|
-
code: string;
|
|
10
|
-
message: string;
|
|
11
|
-
data: {
|
|
12
|
-
category: string;
|
|
13
|
-
path: string;
|
|
14
|
-
redLineCount: number;
|
|
15
|
-
redLineIds: string[];
|
|
16
|
-
findings: string[];
|
|
17
|
-
};
|
|
18
|
-
nextActions: string[];
|
|
19
|
-
}
|
|
20
|
-
/**
|
|
21
|
-
* Pure helper: read the loop-engineering guideline file under `projectRoot`
|
|
22
|
-
* and lint it. Kept out of the Commander action so unit tests can drive it
|
|
23
|
-
* without spawning a child process (same shape as
|
|
24
|
-
* `runReadinessLint` in skill-loop-engineering-readiness-commands.ts).
|
|
25
|
-
*/
|
|
26
|
-
export declare function runLoopEngineeringLint(projectRoot: string): StandardsLintEnvelope;
|
|
3
|
+
export { LOOP_ENGINEERING_CATEGORY, LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH, runLoopEngineeringLint, type StandardsLintEnvelope } from './standards-lint.js';
|
|
27
4
|
export declare function registerStandardsCommand(program: Command, io: ProgramIO): void;
|
|
@@ -1,211 +1,43 @@
|
|
|
1
|
-
import { existsSync, readFileSync } from 'node:fs';
|
|
2
|
-
import { join, resolve } from 'node:path';
|
|
3
|
-
import { summarizeProjectStandardsInitResult, summarizeProjectStandardsUpdateResult } from '../../../services/standards/project-standards-service.js';
|
|
4
|
-
import { executeProjectStandardsInitIdeAware, executeProjectStandardsUpdateIdeAware } from '../../../services/standards/ide-aware-standards-service.js';
|
|
5
|
-
import { migrateStandards } from '../../../services/standards/migrate-service.js';
|
|
6
|
-
import { migrateClaudeRules } from '../../../services/standards/migrate-claude-rules-service.js';
|
|
7
|
-
import { lintLoopEngineeringGuidelines, EXPECTED_RED_LINE_IDS } from '../../../services/standards/loop-engineering-lint.js';
|
|
8
1
|
import { fail, ok } from 'peaks-loop-shared/result';
|
|
9
2
|
import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
export
|
|
14
|
-
/**
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
export function runLoopEngineeringLint(projectRoot) {
|
|
21
|
-
const root = resolve(projectRoot);
|
|
22
|
-
const guidelinePath = join(root, LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH);
|
|
23
|
-
const data = {
|
|
24
|
-
category: LOOP_ENGINEERING_CATEGORY,
|
|
25
|
-
path: guidelinePath,
|
|
26
|
-
redLineCount: 0,
|
|
27
|
-
redLineIds: [],
|
|
28
|
-
findings: []
|
|
29
|
-
};
|
|
30
|
-
if (!existsSync(guidelinePath)) {
|
|
31
|
-
return {
|
|
32
|
-
ok: false,
|
|
33
|
-
code: 'LINT_FILE_NOT_FOUND',
|
|
34
|
-
message: `no ${LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH} under ${root}`,
|
|
35
|
-
data,
|
|
36
|
-
nextActions: [
|
|
37
|
-
`Pass --project pointing at a peaks-loop checkout (the lint reads its own guideline file).`
|
|
38
|
-
]
|
|
39
|
-
};
|
|
3
|
+
import { registerStandardsInitCommands } from './standards-init-command.js';
|
|
4
|
+
import { LOOP_ENGINEERING_CATEGORY, runLoopEngineeringLint } from './standards-lint.js';
|
|
5
|
+
import { registerStandardsMigrateCommand } from './standards-migrate-command.js';
|
|
6
|
+
export { LOOP_ENGINEERING_CATEGORY, LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH, runLoopEngineeringLint } from './standards-lint.js';
|
|
7
|
+
/** `standards lint` prints the pure lint result as a CLI envelope. */
|
|
8
|
+
function runStandardsLint(io, options) {
|
|
9
|
+
if (options.category !== LOOP_ENGINEERING_CATEGORY) {
|
|
10
|
+
printResult(io, fail('standards.lint', 'UNKNOWN_LINT_CATEGORY', `only --category ${LOOP_ENGINEERING_CATEGORY} is implemented`, { category: options.category }, [`Pass --category ${LOOP_ENGINEERING_CATEGORY}.`]), options.json);
|
|
11
|
+
process.exitCode = 1;
|
|
12
|
+
return;
|
|
40
13
|
}
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
message: `${redLineIds.length} red line(s) present with all 4 sections (expected: ${EXPECTED_RED_LINE_IDS.join(', ')})`,
|
|
49
|
-
data: fullData,
|
|
50
|
-
nextActions: ['Any new red line must use the 4-section form or this lint will reject it.']
|
|
51
|
-
};
|
|
52
|
-
}
|
|
53
|
-
return {
|
|
54
|
-
ok: false,
|
|
55
|
-
code: 'STANDARDS_LINT_FAILED',
|
|
56
|
-
message: `guideline file failed the lint (${result.findings.length} finding(s))`,
|
|
57
|
-
data: { ...fullData, findings: result.findings },
|
|
58
|
-
nextActions: [
|
|
59
|
-
'Address every finding in data.findings, then re-run the lint.',
|
|
60
|
-
'Each red line must be a `## RL-N — <title>` heading with the 4 sections: Failure modes / Rewrite / Self-check / Out-of-scope.'
|
|
61
|
-
]
|
|
62
|
-
};
|
|
63
|
-
}
|
|
64
|
-
export function registerStandardsCommand(program, io) {
|
|
65
|
-
const standards = program
|
|
66
|
-
.command('standards')
|
|
67
|
-
.description('Manage project-local coding standards');
|
|
68
|
-
addJsonOption(standards
|
|
69
|
-
.command('init')
|
|
70
|
-
.description('Initialize project-local coding standards for Peaks skill preflight')
|
|
71
|
-
.requiredOption('--project <path>', 'target project root')
|
|
72
|
-
.option('--language <language>', 'standards language pack')
|
|
73
|
-
.option('--ide <id>', 'override IDE detection (e.g. claude-code, trae)')
|
|
74
|
-
.option('--dry-run', 'preview writes without changing files')
|
|
75
|
-
.option('--apply', 'write missing standards into the target project')).action((options) => {
|
|
76
|
-
if (options.dryRun === true && options.apply === true) {
|
|
77
|
-
printResult(io, fail('standards.init', 'INVALID_STANDARDS_INIT_FLAGS', 'Use either --dry-run or --apply, not both', {}, ['Run without --apply to preview writes, or omit --dry-run when applying standards']), options.json);
|
|
78
|
-
process.exitCode = 1;
|
|
79
|
-
return;
|
|
80
|
-
}
|
|
81
|
-
try {
|
|
82
|
-
const result = executeProjectStandardsInitIdeAware({
|
|
83
|
-
projectRoot: options.project,
|
|
84
|
-
...(options.language !== undefined ? { language: options.language } : {}),
|
|
85
|
-
...(options.ide !== undefined
|
|
86
|
-
? {
|
|
87
|
-
ideId: options.ide
|
|
88
|
-
}
|
|
89
|
-
: {}),
|
|
90
|
-
apply: options.apply === true
|
|
91
|
-
});
|
|
92
|
-
printResult(io, ok('standards.init', summarizeProjectStandardsInitResult(result)), options.json);
|
|
93
|
-
}
|
|
94
|
-
catch (error) {
|
|
95
|
-
printResult(io, fail('standards.init', 'STANDARDS_INIT_FAILED', getErrorMessage(error), {}, [
|
|
96
|
-
'Check the project path and existing .claude/rules directory before retrying'
|
|
97
|
-
]), options.json);
|
|
98
|
-
process.exitCode = 1;
|
|
99
|
-
}
|
|
100
|
-
});
|
|
101
|
-
addJsonOption(standards
|
|
102
|
-
.command('update')
|
|
103
|
-
.description('Append managed standards metadata to an existing CLAUDE.md without rewriting the body')
|
|
104
|
-
.requiredOption('--project <path>', 'target project root')
|
|
105
|
-
.option('--language <language>', 'standards language pack')
|
|
106
|
-
.option('--ide <id>', 'override IDE detection (e.g. claude-code, trae)')
|
|
107
|
-
.option('--dry-run', 'preview writes without changing files')
|
|
108
|
-
.option('--apply', 'append managed metadata to the target project')).action((options) => {
|
|
109
|
-
if (options.dryRun === true && options.apply === true) {
|
|
110
|
-
printResult(io, fail('standards.update', 'INVALID_STANDARDS_UPDATE_FLAGS', 'Use either --dry-run or --apply, not both', {}, [
|
|
111
|
-
'Run without --apply to preview writes, or omit --dry-run when applying standards updates'
|
|
112
|
-
]), options.json);
|
|
113
|
-
process.exitCode = 1;
|
|
114
|
-
return;
|
|
115
|
-
}
|
|
116
|
-
try {
|
|
117
|
-
const result = executeProjectStandardsUpdateIdeAware({
|
|
118
|
-
projectRoot: options.project,
|
|
119
|
-
...(options.language !== undefined ? { language: options.language } : {}),
|
|
120
|
-
...(options.ide !== undefined
|
|
121
|
-
? {
|
|
122
|
-
ideId: options.ide
|
|
123
|
-
}
|
|
124
|
-
: {}),
|
|
125
|
-
apply: options.apply === true
|
|
126
|
-
});
|
|
127
|
-
const summary = summarizeProjectStandardsUpdateResult(result);
|
|
128
|
-
const response = summary.reviewSuggestions.length > 0
|
|
129
|
-
? fail('standards.update', 'STANDARDS_UPDATE_REVIEW_REQUIRED', 'Standards update requires manual review', summary, summary.reviewSuggestions)
|
|
130
|
-
: ok('standards.update', summary);
|
|
131
|
-
printResult(io, response, options.json);
|
|
132
|
-
if (summary.reviewSuggestions.length > 0) {
|
|
133
|
-
process.exitCode = 1;
|
|
134
|
-
}
|
|
135
|
-
}
|
|
136
|
-
catch (error) {
|
|
137
|
-
printResult(io, fail('standards.update', 'STANDARDS_UPDATE_FAILED', getErrorMessage(error), {}, [
|
|
138
|
-
'Check the project path, CLAUDE.md contents, and existing .claude/rules directory before retrying'
|
|
139
|
-
]), options.json);
|
|
140
|
-
process.exitCode = 1;
|
|
141
|
-
}
|
|
142
|
-
});
|
|
143
|
-
addJsonOption(standards
|
|
144
|
-
.command('migrate')
|
|
145
|
-
.description('Rewrite a consumer project CLAUDE.md to drop the legacy heartbeat block (slice 028). Dry-run by default; pass --apply to write. With --from-claude-rules, thins the 1.x .claude/rules/ tree to 2-line pointers and scaffolds .peaks/standards/ (slice 2026-06-12-standards-migrate-claude-rules).')
|
|
146
|
-
.option('--project <path>', 'target project root')
|
|
147
|
-
.option('--apply', 'rewrite the legacy block in place; default is dry-run')
|
|
148
|
-
.option('--from-claude-rules', 'thin .claude/rules/ to pointers and scaffold .peaks/standards/')).action((options) => {
|
|
149
|
-
const projectRoot = options.project ?? process.cwd();
|
|
150
|
-
if (options.fromClaudeRules === true) {
|
|
151
|
-
try {
|
|
152
|
-
const result = migrateClaudeRules({ projectRoot, apply: options.apply === true });
|
|
153
|
-
printResult(io, ok('standards.migrate', result.data, [], [...result.data.nextActions]), options.json);
|
|
154
|
-
}
|
|
155
|
-
catch (error) {
|
|
156
|
-
printResult(io, fail('standards.migrate', 'STANDARDS_MIGRATE_FAILED', getErrorMessage(error), {
|
|
157
|
-
backupPath: null,
|
|
158
|
-
thinnedFiles: [],
|
|
159
|
-
scaffoldedFiles: [],
|
|
160
|
-
preservedFiles: [],
|
|
161
|
-
wouldChange: false,
|
|
162
|
-
applied: false,
|
|
163
|
-
nextActions: []
|
|
164
|
-
}, [getErrorMessage(error)]), options.json);
|
|
165
|
-
process.exitCode = 1;
|
|
166
|
-
}
|
|
167
|
-
return;
|
|
168
|
-
}
|
|
169
|
-
try {
|
|
170
|
-
const result = migrateStandards({ project: projectRoot, apply: options.apply === true });
|
|
171
|
-
printResult(io, ok('standards.migrate', result.data, [], result.data.nextActions), options.json);
|
|
172
|
-
}
|
|
173
|
-
catch (error) {
|
|
174
|
-
printResult(io, fail('standards.migrate', 'STANDARDS_MIGRATE_FAILED', getErrorMessage(error), {
|
|
175
|
-
file: null,
|
|
176
|
-
foundOldBlock: false,
|
|
177
|
-
wouldChange: false,
|
|
178
|
-
applied: false,
|
|
179
|
-
before: null,
|
|
180
|
-
after: null,
|
|
181
|
-
nextActions: []
|
|
182
|
-
}, [getErrorMessage(error)]), options.json);
|
|
14
|
+
try {
|
|
15
|
+
const envelope = runLoopEngineeringLint(options.project ?? process.cwd());
|
|
16
|
+
const response = envelope.ok
|
|
17
|
+
? ok('standards.lint', envelope.data, [], envelope.nextActions)
|
|
18
|
+
: fail('standards.lint', envelope.code, envelope.message, envelope.data, envelope.nextActions);
|
|
19
|
+
printResult(io, response, options.json);
|
|
20
|
+
if (!envelope.ok) {
|
|
183
21
|
process.exitCode = 1;
|
|
184
22
|
}
|
|
185
|
-
}
|
|
23
|
+
}
|
|
24
|
+
catch (error) {
|
|
25
|
+
printResult(io, fail('standards.lint', 'STANDARDS_LINT_ERROR', getErrorMessage(error), { category: options.category }, ['Verify the guideline file is readable.']), options.json);
|
|
26
|
+
process.exitCode = 1;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
function registerStandardsLintCommand(standards, io) {
|
|
186
30
|
addJsonOption(standards
|
|
187
31
|
.command('lint')
|
|
188
32
|
.description('Lint a guideline file for structural completeness (the loop-engineering red lines)')
|
|
189
33
|
.requiredOption('--category <category>', `guideline category to lint (${LOOP_ENGINEERING_CATEGORY})`)
|
|
190
|
-
.option('--project <path>', 'project root holding .peaks/standards/ (default: cwd)')).action((options) =>
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
? ok('standards.lint', envelope.data, [], envelope.nextActions)
|
|
200
|
-
: fail('standards.lint', envelope.code, envelope.message, envelope.data, envelope.nextActions);
|
|
201
|
-
printResult(io, response, options.json);
|
|
202
|
-
if (!envelope.ok) {
|
|
203
|
-
process.exitCode = 1;
|
|
204
|
-
}
|
|
205
|
-
}
|
|
206
|
-
catch (error) {
|
|
207
|
-
printResult(io, fail('standards.lint', 'STANDARDS_LINT_ERROR', getErrorMessage(error), { category: options.category }, ['Verify the guideline file is readable.']), options.json);
|
|
208
|
-
process.exitCode = 1;
|
|
209
|
-
}
|
|
210
|
-
});
|
|
34
|
+
.option('--project <path>', 'project root holding .peaks/standards/ (default: cwd)')).action((options) => runStandardsLint(io, options));
|
|
35
|
+
}
|
|
36
|
+
export function registerStandardsCommand(program, io) {
|
|
37
|
+
const standards = program
|
|
38
|
+
.command('standards')
|
|
39
|
+
.description('Manage project-local coding standards');
|
|
40
|
+
registerStandardsInitCommands(standards, io);
|
|
41
|
+
registerStandardsMigrateCommand(standards, io);
|
|
42
|
+
registerStandardsLintCommand(standards, io);
|
|
211
43
|
}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import { summarizeProjectStandardsInitResult, summarizeProjectStandardsUpdateResult } from '../../../services/standards/project-standards-service.js';
|
|
2
|
+
import { executeProjectStandardsInitIdeAware, executeProjectStandardsUpdateIdeAware } from '../../../services/standards/ide-aware-standards-service.js';
|
|
3
|
+
import { fail, ok } from 'peaks-loop-shared/result';
|
|
4
|
+
import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
|
|
5
|
+
/** The five flags `init` and `update` share, in registration order. */
|
|
6
|
+
function withWriteFlags(cmd, applyHelp) {
|
|
7
|
+
return cmd
|
|
8
|
+
.requiredOption('--project <path>', 'target project root')
|
|
9
|
+
.option('--language <language>', 'standards language pack')
|
|
10
|
+
.option('--ide <id>', 'override IDE detection (e.g. claude-code, trae)')
|
|
11
|
+
.option('--dry-run', 'preview writes without changing files')
|
|
12
|
+
.option('--apply', applyHelp);
|
|
13
|
+
}
|
|
14
|
+
/** The ide-aware request both verbs build from the same flag set. */
|
|
15
|
+
function buildIdeAwareRequest(options) {
|
|
16
|
+
return {
|
|
17
|
+
projectRoot: options.project,
|
|
18
|
+
...(options.language !== undefined ? { language: options.language } : {}),
|
|
19
|
+
...(options.ide !== undefined ? { ideId: options.ide } : {}),
|
|
20
|
+
apply: options.apply === true
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
/** `--dry-run --apply` together is ambiguous; refuse before doing any work. */
|
|
24
|
+
function refuseConflictingFlags(io, options, refusal) {
|
|
25
|
+
if (!(options.dryRun === true && options.apply === true))
|
|
26
|
+
return false;
|
|
27
|
+
printResult(io, fail(refusal.command, refusal.code, 'Use either --dry-run or --apply, not both', {}, refusal.nextActions), options.json);
|
|
28
|
+
process.exitCode = 1;
|
|
29
|
+
return true;
|
|
30
|
+
}
|
|
31
|
+
function runStandardsInit(io, options) {
|
|
32
|
+
const refused = refuseConflictingFlags(io, options, {
|
|
33
|
+
command: 'standards.init',
|
|
34
|
+
code: 'INVALID_STANDARDS_INIT_FLAGS',
|
|
35
|
+
nextActions: [
|
|
36
|
+
'Run without --apply to preview writes, or omit --dry-run when applying standards'
|
|
37
|
+
]
|
|
38
|
+
});
|
|
39
|
+
if (refused)
|
|
40
|
+
return;
|
|
41
|
+
try {
|
|
42
|
+
const result = executeProjectStandardsInitIdeAware(buildIdeAwareRequest(options));
|
|
43
|
+
printResult(io, ok('standards.init', summarizeProjectStandardsInitResult(result)), options.json);
|
|
44
|
+
}
|
|
45
|
+
catch (error) {
|
|
46
|
+
printResult(io, fail('standards.init', 'STANDARDS_INIT_FAILED', getErrorMessage(error), {}, [
|
|
47
|
+
'Check the project path and existing .claude/rules directory before retrying'
|
|
48
|
+
]), options.json);
|
|
49
|
+
process.exitCode = 1;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
function runStandardsUpdate(io, options) {
|
|
53
|
+
const refused = refuseConflictingFlags(io, options, {
|
|
54
|
+
command: 'standards.update',
|
|
55
|
+
code: 'INVALID_STANDARDS_UPDATE_FLAGS',
|
|
56
|
+
nextActions: [
|
|
57
|
+
'Run without --apply to preview writes, or omit --dry-run when applying standards updates'
|
|
58
|
+
]
|
|
59
|
+
});
|
|
60
|
+
if (refused)
|
|
61
|
+
return;
|
|
62
|
+
try {
|
|
63
|
+
const result = executeProjectStandardsUpdateIdeAware(buildIdeAwareRequest(options));
|
|
64
|
+
const summary = summarizeProjectStandardsUpdateResult(result);
|
|
65
|
+
const response = summary.reviewSuggestions.length > 0
|
|
66
|
+
? fail('standards.update', 'STANDARDS_UPDATE_REVIEW_REQUIRED', 'Standards update requires manual review', summary, summary.reviewSuggestions)
|
|
67
|
+
: ok('standards.update', summary);
|
|
68
|
+
printResult(io, response, options.json);
|
|
69
|
+
if (summary.reviewSuggestions.length > 0) {
|
|
70
|
+
process.exitCode = 1;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
catch (error) {
|
|
74
|
+
printResult(io, fail('standards.update', 'STANDARDS_UPDATE_FAILED', getErrorMessage(error), {}, [
|
|
75
|
+
'Check the project path, CLAUDE.md contents, and existing .claude/rules directory before retrying'
|
|
76
|
+
]), options.json);
|
|
77
|
+
process.exitCode = 1;
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
export function registerStandardsInitCommands(standards, io) {
|
|
81
|
+
addJsonOption(withWriteFlags(standards
|
|
82
|
+
.command('init')
|
|
83
|
+
.description('Initialize project-local coding standards for Peaks skill preflight'), 'write missing standards into the target project')).action((options) => runStandardsInit(io, options));
|
|
84
|
+
addJsonOption(withWriteFlags(standards
|
|
85
|
+
.command('update')
|
|
86
|
+
.description('Append managed standards metadata to an existing CLAUDE.md without rewriting the body'), 'append managed metadata to the target project')).action((options) => runStandardsUpdate(io, options));
|
|
87
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/** The only `--category` this subcommand implements today. */
|
|
2
|
+
export declare const LOOP_ENGINEERING_CATEGORY = "loop-engineering";
|
|
3
|
+
/** Project-relative location of the file the `loop-engineering` lint reads. */
|
|
4
|
+
export declare const LOOP_ENGINEERING_GUIDELINES_RELATIVE_PATH = ".peaks/standards/loop-engineering-guidelines.md";
|
|
5
|
+
export interface StandardsLintEnvelope {
|
|
6
|
+
ok: boolean;
|
|
7
|
+
code: string;
|
|
8
|
+
message: string;
|
|
9
|
+
data: {
|
|
10
|
+
category: string;
|
|
11
|
+
path: string;
|
|
12
|
+
redLineCount: number;
|
|
13
|
+
redLineIds: string[];
|
|
14
|
+
findings: string[];
|
|
15
|
+
};
|
|
16
|
+
nextActions: string[];
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Pure helper: read the loop-engineering guideline file under `projectRoot`
|
|
20
|
+
* and lint it. Kept out of the Commander action so unit tests can drive it
|
|
21
|
+
* without spawning a child process (same shape as
|
|
22
|
+
* `runReadinessLint` in skill-loop-engineering-readiness-commands.ts).
|
|
23
|
+
*/
|
|
24
|
+
export declare function runLoopEngineeringLint(projectRoot: string): StandardsLintEnvelope;
|