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,144 @@
|
|
|
1
|
+
// src/cli/commands/contract-write-command.ts
|
|
2
|
+
//
|
|
3
|
+
// `peaks contract write` — persist a finished slice's public surface (exports /
|
|
4
|
+
// types / publicSignatures) to
|
|
5
|
+
// `.peaks/_runtime/<sessionId>/dispatch/contracts/<slice-id>.json`, where the
|
|
6
|
+
// orchestrator picks it up on the next dispatch run. Extracted from
|
|
7
|
+
// `governance-classify-contract-commands.ts` (which had merged
|
|
8
|
+
// `contract-commands.ts` and `classify-classify-commands.ts` verbatim); the
|
|
9
|
+
// registered name, description, options, refusal codes and envelope are
|
|
10
|
+
// unchanged.
|
|
11
|
+
//
|
|
12
|
+
// The guards and the write are separate functions because the merged file had
|
|
13
|
+
// all three inline in one 151-line registrar, and every branch there was over
|
|
14
|
+
// the per-function line cap on its own.
|
|
15
|
+
import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
|
|
16
|
+
import { writeContract } from '../../services/dispatch/contract-store.js';
|
|
17
|
+
import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
|
|
18
|
+
import { addJsonOption, printResult } from '../cli-helpers.js';
|
|
19
|
+
const INPUT_LIMIT_BYTES = 256 * 1024;
|
|
20
|
+
/** Split a comma-separated flag value into a trimmed string array. */
|
|
21
|
+
function splitCsv(value) {
|
|
22
|
+
if (value === undefined)
|
|
23
|
+
return [];
|
|
24
|
+
return value
|
|
25
|
+
.split(',')
|
|
26
|
+
.map((s) => s.trim())
|
|
27
|
+
.filter((s) => s.length > 0);
|
|
28
|
+
}
|
|
29
|
+
export function registerContractCommands(program, io) {
|
|
30
|
+
const contract = program
|
|
31
|
+
.command('contract')
|
|
32
|
+
.description('Slice contract store (skill-first / CLI-auxiliary). These commands ' +
|
|
33
|
+
'are primitives that peaks-code / peaks-rd SKILL.md compose. The LLM-side ' +
|
|
34
|
+
'runner (the IDE-resident sub-agent that finished a slice) calls ' +
|
|
35
|
+
"`peaks contract write` to persist the slice's public surface; the " +
|
|
36
|
+
'orchestrator picks it up on the next dispatch run via listContracts() ' +
|
|
37
|
+
'and splices it into downstream prompts via formatContractInjection().');
|
|
38
|
+
addJsonOption(contractWriteCommand(contract)).action((options) => {
|
|
39
|
+
const envelope = contractWriteEnvelope(options);
|
|
40
|
+
printResult(io, envelope, options.json === true);
|
|
41
|
+
if (!envelope.ok)
|
|
42
|
+
process.exitCode = 1;
|
|
43
|
+
});
|
|
44
|
+
}
|
|
45
|
+
// peaks contract write --project <root> --session-id <sid>
|
|
46
|
+
// --slice-id <id> --exports <a,b> --types <x,y> --signatures <s1,s2>
|
|
47
|
+
// [--broadcast-to <b1,b2>] [--completed-at <iso>]
|
|
48
|
+
function contractWriteCommand(contract) {
|
|
49
|
+
return contract
|
|
50
|
+
.command('write')
|
|
51
|
+
.description("2.7.0 slice-dag-dispatcher MVP: persist a finished slice's public " +
|
|
52
|
+
'surface (exports / types / publicSignatures) to disk at ' +
|
|
53
|
+
'.peaks/_runtime/<sessionId>/dispatch/contracts/<slice-id>.json. ' +
|
|
54
|
+
'The orchestrator picks it up on the next dispatch run. Idempotent: ' +
|
|
55
|
+
're-running with the same inputs overwrites in place; the SHA-256 ' +
|
|
56
|
+
'contractHash is content-derived so a contract write from a different ' +
|
|
57
|
+
'runner (re-execution) is detected as a content change.')
|
|
58
|
+
.option('--project <path>', 'target project root (defaults to cwd)')
|
|
59
|
+
.option('--session-id <sid>', 'session id (default: resolve from .peaks/_runtime/session.json; falls back to PEAKS_SESSION_ID env var; final fallback "unknown-sid")')
|
|
60
|
+
.requiredOption('--slice-id <id>', 'slice id; must be non-empty; used as the contract filename basename')
|
|
61
|
+
.option('--exports <list>', 'comma-separated public export names (e.g. "validateDag,topologicalLevels")')
|
|
62
|
+
.option('--types <list>', 'comma-separated public type names (e.g. "SliceDag,SliceNode")')
|
|
63
|
+
.option('--signatures <list>', 'comma-separated public function/method signatures (e.g. "validateDag(dag: SliceDag): void")')
|
|
64
|
+
.option('--broadcast-to <list>', 'comma-separated downstream slice ids that should auto-inherit this contract (e.g. "B,C")')
|
|
65
|
+
.option('--completed-at <iso>', 'ISO 8601 timestamp; defaults to now()');
|
|
66
|
+
}
|
|
67
|
+
/** The written-contract envelope, or the refusal the caller earned. */
|
|
68
|
+
function contractWriteEnvelope(options) {
|
|
69
|
+
const projectRoot = options.project ?? process.cwd();
|
|
70
|
+
const sid = options.sessionId ??
|
|
71
|
+
process.env['PEAKS_SESSION_ID'] ??
|
|
72
|
+
getCurrentSessionId(projectRoot) ??
|
|
73
|
+
'unknown-sid';
|
|
74
|
+
const lists = {
|
|
75
|
+
exports: splitCsv(options.exports),
|
|
76
|
+
types: splitCsv(options.types),
|
|
77
|
+
signatures: splitCsv(options.signatures),
|
|
78
|
+
broadcastTo: splitCsv(options.broadcastTo)
|
|
79
|
+
};
|
|
80
|
+
const refusal = contractWriteRefusal(options, sid, lists);
|
|
81
|
+
if (refusal !== null)
|
|
82
|
+
return refusal;
|
|
83
|
+
try {
|
|
84
|
+
const result = writeContract(projectRoot, sid, contractWriteInput(options, sid, lists));
|
|
85
|
+
return ok('contract.write', contractWriteData(result), [], [
|
|
86
|
+
'Contract written; orchestrator will pick it up on the next `peaks sub-agent dispatch --from-dag` run.',
|
|
87
|
+
'Re-running with the same inputs is idempotent (overwrites in place).'
|
|
88
|
+
]);
|
|
89
|
+
}
|
|
90
|
+
catch (err) {
|
|
91
|
+
return fail('contract.write', 'WRITE_ERROR', getErrorMessage(err), { path: null, contract: null }, [
|
|
92
|
+
'See error message; check that --project is a writable directory and --slice-id is a valid filename basename (no path separators).'
|
|
93
|
+
]);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* The `writeContract` input: `--broadcast-to` and `--completed-at` ride only
|
|
98
|
+
* when the caller set them, so an absent flag never becomes an empty value.
|
|
99
|
+
*/
|
|
100
|
+
function contractWriteInput(options, sid, lists) {
|
|
101
|
+
return {
|
|
102
|
+
// The refusal above already rejected `undefined` / empty.
|
|
103
|
+
sliceId: options.sliceId,
|
|
104
|
+
sessionId: sid,
|
|
105
|
+
exports: lists.exports,
|
|
106
|
+
types: lists.types,
|
|
107
|
+
publicSignatures: lists.signatures,
|
|
108
|
+
...(lists.broadcastTo.length > 0 ? { broadcastTo: lists.broadcastTo } : {}),
|
|
109
|
+
...(options.completedAt !== undefined ? { completedAt: options.completedAt } : {})
|
|
110
|
+
};
|
|
111
|
+
}
|
|
112
|
+
/** The written contract, counted per surface — never the raw store row. */
|
|
113
|
+
function contractWriteData(result) {
|
|
114
|
+
return {
|
|
115
|
+
path: result.path,
|
|
116
|
+
contractHash: result.contract.contractHash,
|
|
117
|
+
sliceId: result.contract.sliceId,
|
|
118
|
+
sessionId: result.contract.sessionId,
|
|
119
|
+
completedAt: result.contract.completedAt,
|
|
120
|
+
exportCount: result.contract.exports.length,
|
|
121
|
+
typeCount: result.contract.types.length,
|
|
122
|
+
signatureCount: result.contract.publicSignatures.length,
|
|
123
|
+
broadcastTo: result.contract.broadcastTo ?? []
|
|
124
|
+
};
|
|
125
|
+
}
|
|
126
|
+
/** The two pre-write refusals (missing slice id, oversized input), or `null`. */
|
|
127
|
+
function contractWriteRefusal(options, sid, lists) {
|
|
128
|
+
const sliceId = options.sliceId;
|
|
129
|
+
if (sliceId === undefined || sliceId.length === 0) {
|
|
130
|
+
return fail('contract.write', 'MISSING_SLICE_ID', '--slice-id is required', { path: null, contract: null }, ['Re-run with --slice-id <id> (must be non-empty; used as the contract filename basename).']);
|
|
131
|
+
}
|
|
132
|
+
// Cap the combined input to protect the file IO from runaway values
|
|
133
|
+
// (e.g. a 10MB comma-separated --signatures flag).
|
|
134
|
+
const inputSize = sliceId.length +
|
|
135
|
+
sid.length +
|
|
136
|
+
lists.exports.join(',').length +
|
|
137
|
+
lists.types.join(',').length +
|
|
138
|
+
lists.signatures.join(',').length +
|
|
139
|
+
lists.broadcastTo.join(',').length +
|
|
140
|
+
(options.completedAt?.length ?? 0);
|
|
141
|
+
if (inputSize <= INPUT_LIMIT_BYTES)
|
|
142
|
+
return null;
|
|
143
|
+
return fail('contract.write', 'INPUT_TOO_LARGE', `combined input size ${inputSize} bytes exceeds ${INPUT_LIMIT_BYTES} (likely oversized --exports/--types/--signatures lists)`, { path: null, contract: null }, ['Split the slice into smaller surfaces or omit optional fields.']);
|
|
144
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
export type BindingSource = 'canonical' | 'legacy';
|
|
2
|
+
/** One stale entry in the project-level binding. */
|
|
3
|
+
export type StaleInstance = {
|
|
4
|
+
sid: string;
|
|
5
|
+
callerId: string;
|
|
6
|
+
lastHeartbeat: string;
|
|
7
|
+
};
|
|
8
|
+
export declare const STALE_TTL_MS = 300000;
|
|
9
|
+
export declare function listStaleInstances(projectRoot: string, ttlMs?: number): StaleInstance[];
|
|
10
|
+
/** The `staleBinding` block every doctor envelope carries. */
|
|
11
|
+
export declare function staleBindingSection(ttlMs: number, staleInstances: readonly StaleInstance[], droppedStale: readonly string[]): {
|
|
12
|
+
ttlMs: number;
|
|
13
|
+
staleCount: number;
|
|
14
|
+
staleInstances: readonly StaleInstance[];
|
|
15
|
+
droppedCount: number;
|
|
16
|
+
droppedSids: readonly string[];
|
|
17
|
+
};
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { readBinding } from '../../../services/session/binding-store.js';
|
|
2
|
+
// threshold is exposed as a CLI flag so users can tune it for
|
|
3
|
+
// long-running sessions. 300000 ms = 5 minutes.
|
|
4
|
+
export const STALE_TTL_MS = 300_000;
|
|
5
|
+
// in the project-level binding. Used by `peaks doctor` and surfaced as
|
|
6
|
+
// a warning in the report. Returns the stale entry descriptors.
|
|
7
|
+
export function listStaleInstances(projectRoot, ttlMs = STALE_TTL_MS) {
|
|
8
|
+
const binding = readBinding(projectRoot);
|
|
9
|
+
if (!binding)
|
|
10
|
+
return [];
|
|
11
|
+
const cutoff = Date.now() - ttlMs;
|
|
12
|
+
const stale = [];
|
|
13
|
+
for (const [sid, inst] of Object.entries(binding.instances)) {
|
|
14
|
+
const t = Date.parse(inst.lastHeartbeat);
|
|
15
|
+
if (Number.isFinite(t) && t < cutoff) {
|
|
16
|
+
stale.push({ sid, callerId: inst.callerId, lastHeartbeat: inst.lastHeartbeat });
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
return stale;
|
|
20
|
+
}
|
|
21
|
+
/** The `staleBinding` block every doctor envelope carries. */
|
|
22
|
+
export function staleBindingSection(ttlMs, staleInstances, droppedStale) {
|
|
23
|
+
return {
|
|
24
|
+
ttlMs,
|
|
25
|
+
staleCount: staleInstances.length,
|
|
26
|
+
staleInstances,
|
|
27
|
+
droppedCount: droppedStale.length,
|
|
28
|
+
droppedSids: droppedStale
|
|
29
|
+
};
|
|
30
|
+
}
|
|
@@ -1,18 +1,4 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
* full message) and the stale-binding instance list collapse to counts +
|
|
6
|
-
* names-of-first-N; the summary counters and log section are scalars and are
|
|
7
|
-
* kept verbatim. ≤ 2 KB by construction.
|
|
8
|
-
*/
|
|
9
|
-
export declare function buildDoctorSummary(data: Record<string, unknown>): Record<string, unknown>;
|
|
10
|
-
export type BindingSource = 'canonical' | 'legacy';
|
|
11
|
-
export type DoctorLogsSection = {
|
|
12
|
-
logDir: string;
|
|
13
|
-
todayFile: string;
|
|
14
|
-
sizeBytes: number;
|
|
15
|
-
retentionDays: number;
|
|
16
|
-
level: string;
|
|
17
|
-
};
|
|
18
|
-
export declare function registerDoctorCommand(program: Command, io: ProgramIO): void;
|
|
1
|
+
export type { BindingSource, StaleInstance } from './doctor-bindings.js';
|
|
2
|
+
export type { DoctorLogsSection } from './doctor-logs.js';
|
|
3
|
+
export { buildDoctorSummary } from './doctor-summary.js';
|
|
4
|
+
export { registerDoctorCommand } from './doctor-run-command.js';
|
|
@@ -1,323 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
import { findProjectRoot } from '../../../services/config/config-safety.js';
|
|
4
|
-
import { loadSkillRegistry } from '../../../services/skills/skill-registry.js';
|
|
5
|
-
import { planStatusLineInstall } from '../../../services/skills/statusline-settings-service.js';
|
|
6
|
-
import { addJsonOption, printResult } from '../../cli-helpers.js';
|
|
7
|
-
import { boundedNames, fitSummaryToBytes } from '../../../services/context/summary-view.js';
|
|
8
|
-
import { fail, ok } from 'peaks-loop-shared/result';
|
|
9
|
-
// slice-3b Option C: the doctor subpackage owns the check pipeline but
|
|
10
|
-
// does NOT import cross-domain utils from the main package (avoids
|
|
11
|
-
// circular deps). The CLI is the natural wiring point — every cross-
|
|
12
|
-
// domain util the doctor used to import directly is now injected as a
|
|
13
|
-
// probe on DoctorOptions at call-site:
|
|
14
|
-
//
|
|
15
|
-
// loadSkills ← loadSkillRegistry (main/services/skills/skill-registry.ts)
|
|
16
|
-
// skillPresenceProbe ← leave as-is; doctor-command does not own the presence probe
|
|
17
|
-
// statusLineInstalledProbe ← defaults to a `planStatusLineInstall` wrapper below
|
|
18
|
-
// projectRootResolver ← findProjectRoot (main/services/config/config-safety.ts)
|
|
19
|
-
// isValidSessionIdProbe ← the regex kept in main/services/workspace/sid-naming-guard.ts
|
|
20
|
-
//
|
|
21
|
-
// Inlining isValidSessionId via the doctor subpackage's default regex
|
|
22
|
-
// (which mirrors the upstream file byte-for-byte) keeps the L3 orphan
|
|
23
|
-
// check behaviour-identical without dragging sid-naming-guard into a
|
|
24
|
-
// workspace package. If sid-naming-guard is ever moved into
|
|
25
|
-
// peaks-loop-shared, swap this for a re-import.
|
|
26
|
-
function doctorIsValidSessionId(sid) {
|
|
27
|
-
return /^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])-session-[0-9a-z]{3,6}$/.test(sid);
|
|
28
|
-
}
|
|
29
|
-
function statusLineAlreadyInstalledForScope(scope, projectRoot) {
|
|
30
|
-
try {
|
|
31
|
-
if (scope === 'project') {
|
|
32
|
-
if (projectRoot === undefined)
|
|
33
|
-
return false;
|
|
34
|
-
return planStatusLineInstall('project', projectRoot).alreadyInstalled;
|
|
35
|
-
}
|
|
36
|
-
return planStatusLineInstall('global').alreadyInstalled;
|
|
37
|
-
}
|
|
38
|
-
catch {
|
|
39
|
-
return false;
|
|
40
|
-
}
|
|
41
|
-
}
|
|
42
|
-
/**
|
|
43
|
-
* the doctor envelope. The `checks` array (one object per check, each with a
|
|
44
|
-
* full message) and the stale-binding instance list collapse to counts +
|
|
45
|
-
* names-of-first-N; the summary counters and log section are scalars and are
|
|
46
|
-
* kept verbatim. ≤ 2 KB by construction.
|
|
47
|
-
*/
|
|
48
|
-
export function buildDoctorSummary(data) {
|
|
49
|
-
const checks = Array.isArray(data.checks)
|
|
50
|
-
? data.checks
|
|
51
|
-
: [];
|
|
52
|
-
const label = (c) => {
|
|
53
|
-
const id = typeof c.id === 'string' ? c.id : 'unknown';
|
|
54
|
-
if (c.ok === true)
|
|
55
|
-
return `ok ${id}`;
|
|
56
|
-
return `${c.severity === 'warning' ? 'warn' : 'FAIL'} ${id}`;
|
|
57
|
-
};
|
|
58
|
-
const failed = checks.filter((c) => c.ok === false);
|
|
59
|
-
const stale = typeof data.staleBinding === 'object' && data.staleBinding !== null
|
|
60
|
-
? data.staleBinding
|
|
61
|
-
: null;
|
|
62
|
-
const view = {
|
|
63
|
-
view: 'summary',
|
|
64
|
-
summary: data.summary,
|
|
65
|
-
checks: boundedNames(checks.map(label)),
|
|
66
|
-
failed: boundedNames(failed.map((c) => `${typeof c.id === 'string' ? c.id : 'unknown'}: ${typeof c.message === 'string' ? c.message : ''}`))
|
|
67
|
-
};
|
|
68
|
-
if (stale !== null) {
|
|
69
|
-
view.staleBinding = {
|
|
70
|
-
ttlMs: stale.ttlMs,
|
|
71
|
-
staleCount: stale.staleCount,
|
|
72
|
-
droppedCount: stale.droppedCount,
|
|
73
|
-
droppedSids: boundedNames(Array.isArray(stale.droppedSids) ? stale.droppedSids.map((s) => String(s)) : [])
|
|
74
|
-
};
|
|
75
|
-
}
|
|
76
|
-
if (data.logs !== undefined)
|
|
77
|
-
view.logs = data.logs;
|
|
78
|
-
return fitSummaryToBytes(view);
|
|
79
|
-
}
|
|
80
|
-
function doctorStatusLineInstalledProbe() {
|
|
81
|
-
const projectRoot = findProjectRoot(process.cwd());
|
|
82
|
-
// Check both scopes: a user may have installed the statusLine globally, which
|
|
83
|
-
// the project-only check would miss and falsely report as "not installed".
|
|
84
|
-
try {
|
|
85
|
-
if (projectRoot !== null && statusLineAlreadyInstalledForScope('project', projectRoot)) {
|
|
86
|
-
return true;
|
|
87
|
-
}
|
|
88
|
-
}
|
|
89
|
-
catch {
|
|
90
|
-
// TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
|
|
91
|
-
/* fall through to global */
|
|
92
|
-
}
|
|
93
|
-
try {
|
|
94
|
-
return statusLineAlreadyInstalledForScope('global');
|
|
95
|
-
}
|
|
96
|
-
catch {
|
|
97
|
-
return false;
|
|
98
|
-
}
|
|
99
|
-
}
|
|
100
|
-
// threshold is exposed as a CLI flag so users can tune it for
|
|
101
|
-
// long-running sessions.
|
|
102
|
-
const STALE_TTL_MS = 5 * 60 * 1000;
|
|
103
|
-
// in the project-level binding. Used by `peaks doctor` and surfaced as
|
|
104
|
-
// a warning in the report. Returns the stale entry descriptors.
|
|
105
|
-
function listStaleInstances(projectRoot, ttlMs = STALE_TTL_MS) {
|
|
106
|
-
const binding = readBinding(projectRoot);
|
|
107
|
-
if (!binding)
|
|
108
|
-
return [];
|
|
109
|
-
const cutoff = Date.now() - ttlMs;
|
|
110
|
-
const stale = [];
|
|
111
|
-
for (const [sid, inst] of Object.entries(binding.instances)) {
|
|
112
|
-
const t = Date.parse(inst.lastHeartbeat);
|
|
113
|
-
if (Number.isFinite(t) && t < cutoff) {
|
|
114
|
-
stale.push({ sid, callerId: inst.callerId, lastHeartbeat: inst.lastHeartbeat });
|
|
115
|
-
}
|
|
116
|
-
}
|
|
117
|
-
return stale;
|
|
118
|
-
}
|
|
119
|
-
//
|
|
120
|
-
// `buildDoctorLogsSection` reads the on-disk log dir and returns the
|
|
121
|
-
// metadata the doctor needs to render the "logs" block. It is
|
|
122
|
-
// extracted from the inline `peaks doctor --log` action so the
|
|
123
|
-
// command stays small and the helper is unit-testable without
|
|
124
|
-
// spinning up the full program.
|
|
125
|
-
async function buildDoctorLogsSection() {
|
|
126
|
-
// Lazy imports to avoid a circular dep at module-load time
|
|
127
|
-
// (core-artifact-commands is imported very early in program.ts).
|
|
128
|
-
const { resolveLogDir, buildLogFileName } = await import('../../../services/log/logger.js');
|
|
129
|
-
const { statSync, existsSync } = await import('node:fs');
|
|
130
|
-
const { join } = await import('node:path');
|
|
131
|
-
const logDir = resolveLogDir();
|
|
132
|
-
const todayFile = buildLogFileName(new Date());
|
|
133
|
-
const fullPath = join(logDir, todayFile);
|
|
134
|
-
let sizeBytes = 0;
|
|
135
|
-
if (existsSync(fullPath)) {
|
|
136
|
-
try {
|
|
137
|
-
sizeBytes = statSync(fullPath).size;
|
|
138
|
-
}
|
|
139
|
-
catch {
|
|
140
|
-
sizeBytes = 0;
|
|
141
|
-
}
|
|
142
|
-
}
|
|
143
|
-
return {
|
|
144
|
-
logDir,
|
|
145
|
-
todayFile,
|
|
146
|
-
sizeBytes,
|
|
147
|
-
retentionDays: 7,
|
|
148
|
-
level: process.env.PEAKS_LOG_LEVEL ?? 'info'
|
|
149
|
-
};
|
|
150
|
-
}
|
|
151
|
-
// "logs" section to the doctor output (logDir, today's file name,
|
|
152
|
-
// size, retention policy, level). Useful for the user when they
|
|
153
|
-
// want to attach a quick log snapshot to a bug report without
|
|
154
|
-
// running `peaks log tail` first. The flag is opt-in so the
|
|
155
|
-
// existing doctor output is preserved (P4).
|
|
156
|
-
export function registerDoctorCommand(program, io) {
|
|
157
|
-
addJsonOption(program
|
|
158
|
-
.command('doctor')
|
|
159
|
-
.description('Run repository doctor checks')
|
|
160
|
-
.option('--log', 'include a "logs" section in the doctor output (slice 2026-06-16-cli-logging, AC6)')
|
|
161
|
-
.option('--cleanup-stale', 'drop stale instance entries from the project-level binding (v2.16.0 AC-10)')
|
|
162
|
-
.option('--stale-ttl-ms <ms>', 'stale-binding TTL in milliseconds (default 300000 = 5 minutes, v2.16.0 AC-10)')
|
|
163
|
-
// v2.18.2 PATCH scope (follow-up issue #1): rewrite legacy
|
|
164
|
-
// v2.16.0 / v2.17.0 binding files in place so every existing
|
|
165
|
-
// callerId gets the `${envSignal}#${pid}` suffix introduced in
|
|
166
|
-
// v2.18.0. Mutually exclusive with --cleanup-stale to keep the
|
|
167
|
-
// semantics unambiguous (rebuild = structural change,
|
|
168
|
-
// cleanup-stale = TTL-based prune).
|
|
169
|
-
.option('--rebuild-binding', 'rewrite legacy v2.16.0 / v2.17.0 callerId entries to the v2.18.0+ `#${pid}` format (v2.18.2, follow-up issue #1)')
|
|
170
|
-
// v2.18.2 cycle 2: --project makes the project-root-bound
|
|
171
|
-
// flags (--rebuild-binding, --cleanup-stale, stale-binding
|
|
172
|
-
// scan) addressable for non-current projects. The doctor was
|
|
173
|
-
// hardcoded to findProjectRoot(process.cwd()) which is the
|
|
174
|
-
// wrong default for users inspecting a sibling project.
|
|
175
|
-
.option('--project <path>', 'target project root (defaults to git root or cwd)')
|
|
176
|
-
.option('--summary', 'JSON envelope only: emit check counts + names-of-first-N (≤ 2 KB) instead of the full checks/stale-binding arrays; the default envelope is unchanged')).action(async (options) => {
|
|
177
|
-
// v2.18.2 cycle 2 (Q2 arbitration): --rebuild-binding and
|
|
178
|
-
// --cleanup-stale BOTH mutate the binding file. Running them
|
|
179
|
-
// together is ambiguous (rebuild rewrites callerIds; cleanup
|
|
180
|
-
// prunes entries). Hard-reject the combination so the user
|
|
181
|
-
// gets an actionable error instead of a silent short-circuit.
|
|
182
|
-
if (options.rebuildBinding === true && options.cleanupStale === true) {
|
|
183
|
-
const envelope = fail('doctor.rebuild-binding', 'CONFLICTING_FLAGS', '--rebuild-binding and --cleanup-stale are mutually exclusive', { rebuildBinding: true, cleanupStale: true }, ['Run them in separate `peaks doctor` invocations']);
|
|
184
|
-
printResult(io, envelope, options.json === true);
|
|
185
|
-
process.exitCode = 1;
|
|
186
|
-
return;
|
|
187
|
-
}
|
|
188
|
-
// v2.18.2 cycle 2: --project override, applies to BOTH the
|
|
189
|
-
// --rebuild-binding short-circuit AND the binding-stale scan.
|
|
190
|
-
const projectRoot = options.project !== undefined
|
|
191
|
-
? options.project
|
|
192
|
-
: (findProjectRoot(process.cwd()) ?? process.cwd());
|
|
193
|
-
// v2.18.2: short-circuit on --rebuild-binding so the doctor
|
|
194
|
-
// checks don't run when the user is asking for a single targeted
|
|
195
|
-
// migration. The rebuild is observable in its own right
|
|
196
|
-
// (rewritten/preserved counts) and does not benefit from running
|
|
197
|
-
// the full doctor surface first.
|
|
198
|
-
if (options.rebuildBinding === true) {
|
|
199
|
-
const result = rebuildBindingFromLegacy(projectRoot);
|
|
200
|
-
if (result.errors.length > 0) {
|
|
201
|
-
for (const err of result.errors) {
|
|
202
|
-
io.stderr(` warning: ${err}`);
|
|
203
|
-
}
|
|
204
|
-
}
|
|
205
|
-
const data = {
|
|
206
|
-
rebuilt: !result.noop,
|
|
207
|
-
rewritten: result.rewritten,
|
|
208
|
-
preserved: result.preserved,
|
|
209
|
-
errors: result.errors,
|
|
210
|
-
projectRoot
|
|
211
|
-
};
|
|
212
|
-
const envelope = result.rewritten === 0
|
|
213
|
-
? ok('doctor.rebuild-binding', data, [], result.noop ? ['no legacy callerId entries found — nothing to rewrite'] : [])
|
|
214
|
-
: fail('doctor.rebuild-binding', result.noop ? 'BINDING_REBUILD_NOOP' : 'BINDING_REBUILD_OK', result.noop
|
|
215
|
-
? 'No legacy callerId entries to rewrite'
|
|
216
|
-
: `Rewrote ${result.rewritten} legacy callerId entry/entries (preserved ${result.preserved})`, data, ['Re-run `peaks binding status` to verify the rewritten entries']);
|
|
217
|
-
printResult(io, envelope, options.json === true);
|
|
218
|
-
if (result.errors.length > 0 && result.rewritten === 0) {
|
|
219
|
-
process.exitCode = 1;
|
|
220
|
-
}
|
|
221
|
-
return;
|
|
222
|
-
}
|
|
223
|
-
const report = await runDoctor({
|
|
224
|
-
// slice-3b Option C: wire cross-domain probes at call-site.
|
|
225
|
-
loadSkills: loadSkillRegistry,
|
|
226
|
-
projectRootResolver: () => findProjectRoot(process.cwd()),
|
|
227
|
-
isValidSessionIdProbe: doctorIsValidSessionId,
|
|
228
|
-
statusLineInstalledProbe: doctorStatusLineInstalledProbe
|
|
229
|
-
});
|
|
230
|
-
let logsSection = null;
|
|
231
|
-
if (options.log === true) {
|
|
232
|
-
logsSection = await buildDoctorLogsSection();
|
|
233
|
-
}
|
|
234
|
-
const ttl = options.staleTtlMs !== undefined ? Number(options.staleTtlMs) : STALE_TTL_MS;
|
|
235
|
-
const staleInstances = listStaleInstances(projectRoot, ttl);
|
|
236
|
-
let droppedStale = [];
|
|
237
|
-
if (options.cleanupStale === true) {
|
|
238
|
-
const { dropped } = dropStale(projectRoot, ttl);
|
|
239
|
-
droppedStale = dropped;
|
|
240
|
-
}
|
|
241
|
-
const staleBindingSection = {
|
|
242
|
-
ttlMs: ttl,
|
|
243
|
-
staleCount: staleInstances.length,
|
|
244
|
-
staleInstances,
|
|
245
|
-
droppedCount: droppedStale.length,
|
|
246
|
-
droppedSids: droppedStale
|
|
247
|
-
};
|
|
248
|
-
const fullData = logsSection === null
|
|
249
|
-
? { ...report, staleBinding: staleBindingSection }
|
|
250
|
-
: { ...report, logs: logsSection, staleBinding: staleBindingSection };
|
|
251
|
-
// Slice B: `--summary` is opt-in and affects the JSON envelope only (the
|
|
252
|
-
// human-readable path below already prints one line per check).
|
|
253
|
-
const data = options.summary === true ? buildDoctorSummary(fullData) : fullData;
|
|
254
|
-
// repair cycle: `report.summary.ok` already factors in the
|
|
255
|
-
// severity-aware aggregation in `buildReport` (warnings do NOT
|
|
256
|
-
// flip `ok`). Stale-binding is independent and still escalates.
|
|
257
|
-
const result = report.summary.ok && staleInstances.length === 0
|
|
258
|
-
? ok('doctor', data)
|
|
259
|
-
: fail('doctor', 'DOCTOR_FAILED', staleInstances.length > 0
|
|
260
|
-
? `Found ${staleInstances.length} stale binding instance(s); rerun with --cleanup-stale to drop them`
|
|
261
|
-
: 'One or more doctor checks failed', data, staleInstances.length > 0
|
|
262
|
-
? ['Run `peaks doctor --cleanup-stale` to drop stale entries']
|
|
263
|
-
: ['Fix failed checks and rerun peaks doctor']);
|
|
264
|
-
if (options.json === true) {
|
|
265
|
-
printResult(io, result, true);
|
|
266
|
-
}
|
|
267
|
-
else {
|
|
268
|
-
// Human-readable: one line per check, green/red indicators, no JSON.
|
|
269
|
-
// repair cycle: warn-only findings (severity: 'warning') surface
|
|
270
|
-
// as `! check.ok` with the `! ` (warning) glyph so the operator
|
|
271
|
-
// can tell them apart from real errors without reading JSON.
|
|
272
|
-
for (const check of report.checks) {
|
|
273
|
-
if (check.ok) {
|
|
274
|
-
io.stdout(` + ${check.message}`);
|
|
275
|
-
}
|
|
276
|
-
else if (check.severity === 'warning') {
|
|
277
|
-
io.stdout(` ! ${check.message}`);
|
|
278
|
-
}
|
|
279
|
-
else {
|
|
280
|
-
io.stdout(` × ${check.message}`);
|
|
281
|
-
}
|
|
282
|
-
}
|
|
283
|
-
if (logsSection !== null) {
|
|
284
|
-
io.stdout('\n logs:');
|
|
285
|
-
io.stdout(` logDir: ${logsSection.logDir}`);
|
|
286
|
-
io.stdout(` todayFile: ${logsSection.todayFile}`);
|
|
287
|
-
io.stdout(` sizeBytes: ${logsSection.sizeBytes}`);
|
|
288
|
-
io.stdout(` retentionDays: ${logsSection.retentionDays}`);
|
|
289
|
-
io.stdout(` level: ${logsSection.level}`);
|
|
290
|
-
}
|
|
291
|
-
io.stdout('\n stale-binding (v2.16.0 AC-10):');
|
|
292
|
-
if (staleInstances.length === 0) {
|
|
293
|
-
io.stdout(' + no stale instances');
|
|
294
|
-
}
|
|
295
|
-
else {
|
|
296
|
-
io.stdout(` × ${staleInstances.length} stale instance(s):`);
|
|
297
|
-
for (const s of staleInstances) {
|
|
298
|
-
io.stdout(` - sid=${s.sid} caller=${s.callerId} lastSeen=${s.lastHeartbeat}`);
|
|
299
|
-
}
|
|
300
|
-
if (droppedStale.length > 0) {
|
|
301
|
-
io.stdout(` cleaned up: ${droppedStale.length}`);
|
|
302
|
-
}
|
|
303
|
-
else {
|
|
304
|
-
io.stdout(' rerun with --cleanup-stale to drop them');
|
|
305
|
-
}
|
|
306
|
-
}
|
|
307
|
-
io.stdout(`\n ${report.summary.passed} passed, ${report.summary.failed} failed${report.summary.warnings > 0 ? `, ${report.summary.warnings} warning(s)` : ''}`);
|
|
308
|
-
if (!report.summary.ok || staleInstances.length > 0) {
|
|
309
|
-
io.stderr(`\nDOCTOR_FAILED: ${staleInstances.length > 0 ? 'stale binding present' : `${report.summary.failed} check(s) failed`}.`);
|
|
310
|
-
}
|
|
311
|
-
else if (report.summary.warnings > 0) {
|
|
312
|
-
io.stdout(`\n ${report.summary.warnings} warning(s) present — exit code 0 (warn-only).`);
|
|
313
|
-
}
|
|
314
|
-
}
|
|
315
|
-
// repair cycle: `report.summary.ok` already factors in the
|
|
316
|
-
// severity-aware aggregation in `buildReport` (warnings do NOT
|
|
317
|
-
// flip `ok`). The exit-code gate remains `summary.ok &&
|
|
318
|
-
// !staleInstances` — no separate warning special-case needed here.
|
|
319
|
-
if (!report.summary.ok || staleInstances.length > 0) {
|
|
320
|
-
process.exitCode = 1;
|
|
321
|
-
}
|
|
322
|
-
});
|
|
323
|
-
}
|
|
1
|
+
export { buildDoctorSummary } from './doctor-summary.js';
|
|
2
|
+
export { registerDoctorCommand } from './doctor-run-command.js';
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { existsSync, statSync } from 'node:fs';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
//
|
|
4
|
+
// `buildDoctorLogsSection` reads the on-disk log dir and returns the
|
|
5
|
+
// metadata the doctor needs to render the "logs" block. It is
|
|
6
|
+
// extracted from the inline `peaks doctor --log` action so the
|
|
7
|
+
// command stays small and the helper is unit-testable without
|
|
8
|
+
// spinning up the full program.
|
|
9
|
+
export async function buildDoctorLogsSection() {
|
|
10
|
+
// Lazy import to avoid a circular dep at module-load time
|
|
11
|
+
// (core-artifact-commands is imported very early in program.ts).
|
|
12
|
+
const { resolveLogDir, buildLogFileName } = await import('../../../services/log/logger.js');
|
|
13
|
+
const logDir = resolveLogDir();
|
|
14
|
+
const todayFile = buildLogFileName(new Date());
|
|
15
|
+
const fullPath = join(logDir, todayFile);
|
|
16
|
+
let sizeBytes = 0;
|
|
17
|
+
if (existsSync(fullPath)) {
|
|
18
|
+
try {
|
|
19
|
+
sizeBytes = statSync(fullPath).size;
|
|
20
|
+
}
|
|
21
|
+
catch {
|
|
22
|
+
sizeBytes = 0;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
return {
|
|
26
|
+
logDir,
|
|
27
|
+
todayFile,
|
|
28
|
+
sizeBytes,
|
|
29
|
+
retentionDays: 7,
|
|
30
|
+
level: process.env.PEAKS_LOG_LEVEL ?? 'info'
|
|
31
|
+
};
|
|
32
|
+
}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import { findProjectRoot } from '../../../services/config/config-safety.js';
|
|
2
|
+
import { planStatusLineInstall } from '../../../services/skills/statusline-settings-service.js';
|
|
3
|
+
// slice-3b Option C: the doctor subpackage owns the check pipeline but
|
|
4
|
+
// does NOT import cross-domain utils from the main package (avoids
|
|
5
|
+
// circular deps). The CLI is the natural wiring point — every cross-
|
|
6
|
+
// domain util the doctor used to import directly is now injected as a
|
|
7
|
+
// probe on DoctorOptions at call-site:
|
|
8
|
+
//
|
|
9
|
+
// loadSkills ← loadSkillRegistry (main/services/skills/skill-registry.ts)
|
|
10
|
+
// skillPresenceProbe ← leave as-is; doctor-command does not own the presence probe
|
|
11
|
+
// statusLineInstalledProbe ← defaults to a `planStatusLineInstall` wrapper below
|
|
12
|
+
// projectRootResolver ← findProjectRoot (main/services/config/config-safety.ts)
|
|
13
|
+
// isValidSessionIdProbe ← the regex kept in main/services/workspace/sid-naming-guard.ts
|
|
14
|
+
//
|
|
15
|
+
// Inlining isValidSessionId via the doctor subpackage's default regex
|
|
16
|
+
// (which mirrors the upstream file byte-for-byte) keeps the L3 orphan
|
|
17
|
+
// check behaviour-identical without dragging sid-naming-guard into a
|
|
18
|
+
// workspace package. If sid-naming-guard is ever moved into
|
|
19
|
+
// peaks-loop-shared, swap this for a re-import.
|
|
20
|
+
export function doctorIsValidSessionId(sid) {
|
|
21
|
+
return /^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])-session-[0-9a-z]{3,6}$/.test(sid);
|
|
22
|
+
}
|
|
23
|
+
export function statusLineAlreadyInstalledForScope(scope, projectRoot) {
|
|
24
|
+
try {
|
|
25
|
+
if (scope === 'project') {
|
|
26
|
+
if (projectRoot === undefined)
|
|
27
|
+
return false;
|
|
28
|
+
return planStatusLineInstall('project', projectRoot).alreadyInstalled;
|
|
29
|
+
}
|
|
30
|
+
return planStatusLineInstall('global').alreadyInstalled;
|
|
31
|
+
}
|
|
32
|
+
catch {
|
|
33
|
+
return false;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
export function doctorStatusLineInstalledProbe() {
|
|
37
|
+
const projectRoot = findProjectRoot(process.cwd());
|
|
38
|
+
// Check both scopes: a user may have installed the statusLine globally, which
|
|
39
|
+
// the project-only check would miss and falsely report as "not installed".
|
|
40
|
+
try {
|
|
41
|
+
if (projectRoot !== null && statusLineAlreadyInstalledForScope('project', projectRoot)) {
|
|
42
|
+
return true;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
catch {
|
|
46
|
+
// TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
|
|
47
|
+
/* fall through to global */
|
|
48
|
+
}
|
|
49
|
+
try {
|
|
50
|
+
return statusLineAlreadyInstalledForScope('global');
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
return false;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Command } from 'commander';
|
|
2
|
+
import { type ProgramIO } from '../../cli-helpers.js';
|
|
3
|
+
export type DoctorOptions = {
|
|
4
|
+
json?: boolean;
|
|
5
|
+
log?: boolean;
|
|
6
|
+
cleanupStale?: boolean;
|
|
7
|
+
staleTtlMs?: string;
|
|
8
|
+
rebuildBinding?: boolean;
|
|
9
|
+
project?: string;
|
|
10
|
+
summary?: boolean;
|
|
11
|
+
};
|
|
12
|
+
export declare function registerDoctorCommand(program: Command, io: ProgramIO): void;
|