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,52 @@
|
|
|
1
|
+
import { execSync } from 'node:child_process';
|
|
2
|
+
import { findProjectRoot } from '../../services/config/config-safety.js';
|
|
3
|
+
import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
|
|
4
|
+
export const DEFAULT_DOCKER_IMAGE = 'node:22-slim';
|
|
5
|
+
export function detectContainerRuntime(explicit) {
|
|
6
|
+
const tryOrder = explicit ? [explicit] : ['docker', 'podman'];
|
|
7
|
+
for (const r of tryOrder) {
|
|
8
|
+
try {
|
|
9
|
+
const version = execSync(`${r} --version`, {
|
|
10
|
+
stdio: ['ignore', 'pipe', 'pipe'],
|
|
11
|
+
encoding: 'utf8',
|
|
12
|
+
windowsHide: true
|
|
13
|
+
}).trim();
|
|
14
|
+
return { ok: true, runtime: r, binary: `${r} (${version.split('\n')[0] ?? ''})` };
|
|
15
|
+
}
|
|
16
|
+
catch {
|
|
17
|
+
/* try next */
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
return {
|
|
21
|
+
ok: false,
|
|
22
|
+
stderr: explicit
|
|
23
|
+
? `explicit --runtime ${explicit} not on PATH`
|
|
24
|
+
: 'neither docker nor podman is on PATH',
|
|
25
|
+
hint: explicit
|
|
26
|
+
? `Install ${explicit} or pass a different --runtime.`
|
|
27
|
+
: 'Install docker (Docker Desktop on macOS / Windows) or podman (RHEL / Fedora).'
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
export function joinPathSession(projectRoot, sessionId) {
|
|
31
|
+
return `${projectRoot.replace(/[\\/]+$/, '')}/.peaks/_runtime/${sessionId}`;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Resolve the project root and session id every container verb works against.
|
|
35
|
+
* The sid falls back through `PEAKS_SESSION_ID` and the canonical binding
|
|
36
|
+
* before the `unknown-sid` sentinel.
|
|
37
|
+
*/
|
|
38
|
+
export function resolveContainerTarget(options) {
|
|
39
|
+
const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
|
|
40
|
+
const sessionId = options.session ??
|
|
41
|
+
process.env.PEAKS_SESSION_ID ??
|
|
42
|
+
getCurrentSessionId(projectRoot) ??
|
|
43
|
+
'unknown-sid';
|
|
44
|
+
return { projectRoot, sessionId };
|
|
45
|
+
}
|
|
46
|
+
export function checkDockerAvailable() {
|
|
47
|
+
// Part 43: superseded by detectContainerRuntime above; this
|
|
48
|
+
// function is preserved for callers that imported it. The
|
|
49
|
+
// container-commands.ts action handlers all use
|
|
50
|
+
// detectContainerRuntime directly.
|
|
51
|
+
return { ok: false, stderr: 'deprecated — use detectContainerRuntime' };
|
|
52
|
+
}
|
|
@@ -23,5 +23,5 @@
|
|
|
23
23
|
* follow-up rid.
|
|
24
24
|
*/
|
|
25
25
|
import type { Command } from 'commander';
|
|
26
|
-
import {
|
|
26
|
+
import type { ProgramIO } from '../cli-helpers.js';
|
|
27
27
|
export declare function registerContainerCommand(program: Command, io: ProgramIO): void;
|
|
@@ -22,224 +22,12 @@
|
|
|
22
22
|
* allowing docker-related tool calls. The gate bridge is a
|
|
23
23
|
* follow-up rid.
|
|
24
24
|
*/
|
|
25
|
-
import {
|
|
26
|
-
import {
|
|
27
|
-
import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
|
|
28
|
-
import { addJsonOption, printResult } from '../cli-helpers.js';
|
|
29
|
-
import { findProjectRoot } from '../../services/config/config-safety.js';
|
|
30
|
-
import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
|
|
31
|
-
import { atomicWriteJson } from '../../services/ide/shared/atomic-json.js';
|
|
32
|
-
import { normalizePath } from '../../shared/path-utils.js';
|
|
33
|
-
import { containerLeaseFilePath, deserializeContainerLease, finalizeContainerLease, generateContainerLeaseId, markContainerReleased, ttlForContainerRole } from '../../services/container/container-lease.js';
|
|
34
|
-
const DEFAULT_DOCKER_IMAGE = 'node:22-slim';
|
|
35
|
-
function detectContainerRuntime(explicit) {
|
|
36
|
-
const tryOrder = explicit ? [explicit] : ['docker', 'podman'];
|
|
37
|
-
for (const r of tryOrder) {
|
|
38
|
-
try {
|
|
39
|
-
const version = execSync(`${r} --version`, {
|
|
40
|
-
stdio: ['ignore', 'pipe', 'pipe'],
|
|
41
|
-
encoding: 'utf8',
|
|
42
|
-
windowsHide: true
|
|
43
|
-
}).trim();
|
|
44
|
-
return { ok: true, runtime: r, binary: `${r} (${version.split('\n')[0] ?? ''})` };
|
|
45
|
-
}
|
|
46
|
-
catch {
|
|
47
|
-
/* try next */
|
|
48
|
-
}
|
|
49
|
-
}
|
|
50
|
-
return {
|
|
51
|
-
ok: false,
|
|
52
|
-
stderr: explicit
|
|
53
|
-
? `explicit --runtime ${explicit} not on PATH`
|
|
54
|
-
: 'neither docker nor podman is on PATH',
|
|
55
|
-
hint: explicit
|
|
56
|
-
? `Install ${explicit} or pass a different --runtime.`
|
|
57
|
-
: 'Install docker (Docker Desktop on macOS / Windows) or podman (RHEL / Fedora).'
|
|
58
|
-
};
|
|
59
|
-
}
|
|
60
|
-
function joinPathSession(projectRoot, sessionId) {
|
|
61
|
-
return `${projectRoot.replace(/[\\/]+$/, '')}/.peaks/_runtime/${sessionId}`;
|
|
62
|
-
}
|
|
63
|
-
function checkDockerAvailable() {
|
|
64
|
-
// Part 43: superseded by detectContainerRuntime above; this
|
|
65
|
-
// function is preserved for callers that imported it. The
|
|
66
|
-
// container-commands.ts action handlers all use
|
|
67
|
-
// detectContainerRuntime directly.
|
|
68
|
-
return { ok: false, stderr: 'deprecated — use detectContainerRuntime' };
|
|
69
|
-
}
|
|
25
|
+
import { registerContainerReleaseCommand } from './container-release-command.js';
|
|
26
|
+
import { registerContainerSpawnCommand } from './container-spawn-command.js';
|
|
70
27
|
export function registerContainerCommand(program, io) {
|
|
71
28
|
const cmd = program
|
|
72
29
|
.command('container')
|
|
73
30
|
.description('L4 container isolation: spawn/release container leases (Part 12; pairs with --isolation container on dispatch).');
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
.description('Spawn a container via `docker run` and write a container lease. ' +
|
|
77
|
-
'The lease is the source of truth for the L4 PreToolUse gate (Part 12 follow-up). ' +
|
|
78
|
-
'Default TTL is role-aware (rd=30m / qa=15m / ui=1h); pass --ttl <ms> to override. ' +
|
|
79
|
-
'Default image is `node:22-slim`; pass --image <name> to override.')
|
|
80
|
-
.requiredOption('--rid <rid>', 'peaks request id the lease is associated with')
|
|
81
|
-
.requiredOption('--role <role>', 'sub-agent role (rd | qa | ui | sc | prd | general-purpose)')
|
|
82
|
-
.requiredOption('--purpose <text>', 'why this container was spawned (audit log)')
|
|
83
|
-
.option('--image <name>', `container image (default ${DEFAULT_DOCKER_IMAGE})`)
|
|
84
|
-
.option('--ttl <ms>', 'time-to-live in ms (default role-aware; override with positive number)')
|
|
85
|
-
.option('--mount <path>', 'host path to mount as the container working dir (default: <projectRoot>)')
|
|
86
|
-
.option('--session <sid>', 'override session id')
|
|
87
|
-
.option('--project <path>', 'project root (default: findProjectRoot(cwd))')).action((options) => {
|
|
88
|
-
const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
|
|
89
|
-
const sessionId = options.session ??
|
|
90
|
-
process.env.PEAKS_SESSION_ID ??
|
|
91
|
-
getCurrentSessionId(projectRoot) ??
|
|
92
|
-
'unknown-sid';
|
|
93
|
-
try {
|
|
94
|
-
const explicitRuntime = (() => {
|
|
95
|
-
if (options.runtime === 'docker')
|
|
96
|
-
return 'docker';
|
|
97
|
-
if (options.runtime === 'podman')
|
|
98
|
-
return 'podman';
|
|
99
|
-
return undefined;
|
|
100
|
-
})();
|
|
101
|
-
const runtime = detectContainerRuntime(explicitRuntime);
|
|
102
|
-
if (!runtime.ok) {
|
|
103
|
-
printResult(io, fail('container.spawn', 'CONTAINER_RUNTIME_UNAVAILABLE', `${runtime.stderr}: ${runtime.hint}`, { rid: options.rid, role: options.role, sessionId }, [
|
|
104
|
-
'Install docker (Docker Desktop on macOS / Windows) or podman (RHEL / Fedora).',
|
|
105
|
-
'On Windows, ensure WSL2 backend is enabled and the daemon is running.',
|
|
106
|
-
'Pass --runtime docker|podman to force a specific runtime.'
|
|
107
|
-
]), options.json);
|
|
108
|
-
process.exitCode = 1;
|
|
109
|
-
return;
|
|
110
|
-
}
|
|
111
|
-
const leaseId = generateContainerLeaseId();
|
|
112
|
-
const now = Date.now();
|
|
113
|
-
const ttlMs = options.ttl === undefined
|
|
114
|
-
? ttlForContainerRole(options.role)
|
|
115
|
-
: Number.parseInt(options.ttl, 10);
|
|
116
|
-
if (!Number.isInteger(ttlMs) || ttlMs <= 0) {
|
|
117
|
-
printResult(io, fail('container.spawn', 'INVALID_TTL', '--ttl must be a positive integer (ms)', { ttl: options.ttl }, ['Re-run with --ttl 1800000 (30 min) or omit to use role default.']), options.json);
|
|
118
|
-
process.exitCode = 1;
|
|
119
|
-
return;
|
|
120
|
-
}
|
|
121
|
-
const image = options.image ?? DEFAULT_DOCKER_IMAGE;
|
|
122
|
-
const mount = options.mount ?? projectRoot;
|
|
123
|
-
// `docker run --rm -d` so the container is detached and
|
|
124
|
-
// auto-removed when stopped; --cidfile writes the
|
|
125
|
-
// container id to a file we can read back. The
|
|
126
|
-
// `--label peaks.leaseId=<id>` lets `peaks container
|
|
127
|
-
// list` / `peaks container gc` find orphans by label
|
|
128
|
-
// when the lease file is missing.
|
|
129
|
-
const cidFile = `${normalizePath(joinPathSession(projectRoot, sessionId))}/.${runtime.runtime}-cid-${leaseId}`;
|
|
130
|
-
try {
|
|
131
|
-
execSync(`${runtime.runtime} run --rm -d --cidfile "${cidFile}" --label "peaks.leaseId=${leaseId}" --label "peaks.rid=${options.rid}" -v "${mount}:/work" -w /work ${image} sleep infinity`, { cwd: projectRoot, stdio: 'pipe', encoding: 'utf8', windowsHide: true });
|
|
132
|
-
}
|
|
133
|
-
catch (err) {
|
|
134
|
-
printResult(io, fail('container.spawn', 'DOCKER_RUN_FAILED', getErrorMessage(err), { rid: options.rid, image, runtime: runtime.runtime, sessionId }, [
|
|
135
|
-
'Verify the image name is reachable on the configured registry.',
|
|
136
|
-
'Verify the host path is mounted correctly (Windows: the path must be visible to WSL2).',
|
|
137
|
-
`Run \`${runtime.runtime} ps -a\` to inspect any leftover containers with the peaks.leaseId label.`
|
|
138
|
-
]), options.json);
|
|
139
|
-
process.exitCode = 1;
|
|
140
|
-
return;
|
|
141
|
-
}
|
|
142
|
-
const containerId = readFileSync(cidFile, 'utf8').trim();
|
|
143
|
-
const lease = finalizeContainerLease({
|
|
144
|
-
leaseId,
|
|
145
|
-
rid: options.rid,
|
|
146
|
-
role: options.role,
|
|
147
|
-
path: mount,
|
|
148
|
-
image,
|
|
149
|
-
containerId,
|
|
150
|
-
createdAt: now,
|
|
151
|
-
expiresAt: now + ttlMs,
|
|
152
|
-
purpose: options.purpose
|
|
153
|
-
});
|
|
154
|
-
atomicWriteJson(containerLeaseFilePath(joinPathSession(projectRoot, sessionId), leaseId), lease);
|
|
155
|
-
printResult(io, ok('container.spawn', {
|
|
156
|
-
lease,
|
|
157
|
-
sessionId,
|
|
158
|
-
projectRoot,
|
|
159
|
-
runtime: runtime.runtime,
|
|
160
|
-
runtimeVersion: runtime.binary,
|
|
161
|
-
nextActions: [
|
|
162
|
-
`Container id: ${containerId}`,
|
|
163
|
-
`Image: ${image}`,
|
|
164
|
-
`Lease expires at: ${new Date(lease.expiresAt).toISOString()}`,
|
|
165
|
-
'Run `peaks container release --lease-id <id>` when done'
|
|
166
|
-
]
|
|
167
|
-
}, [], []), options.json);
|
|
168
|
-
}
|
|
169
|
-
catch (err) {
|
|
170
|
-
printResult(io, fail('container.spawn', 'SPAWN_FAILED', getErrorMessage(err), { rid: options.rid, sessionId }, [
|
|
171
|
-
'See error message; if the lease was not written, retry after fixing the underlying issue.'
|
|
172
|
-
]), options.json);
|
|
173
|
-
process.exitCode = 1;
|
|
174
|
-
}
|
|
175
|
-
});
|
|
176
|
-
addJsonOption(cmd
|
|
177
|
-
.command('release')
|
|
178
|
-
.description('Transition a container lease to released and run `docker rm --force`. Idempotent on already-released leases.')
|
|
179
|
-
.requiredOption('--lease-id <id>', 'lease id returned by `peaks container spawn`')
|
|
180
|
-
.option('--session <sid>', 'override session id')
|
|
181
|
-
.option('--project <path>', 'project root (default: findProjectRoot(cwd))')).action((options) => {
|
|
182
|
-
const projectRoot = options.project ?? findProjectRoot(process.cwd()) ?? process.cwd();
|
|
183
|
-
const sessionId = options.session ??
|
|
184
|
-
process.env.PEAKS_SESSION_ID ??
|
|
185
|
-
getCurrentSessionId(projectRoot) ??
|
|
186
|
-
'unknown-sid';
|
|
187
|
-
try {
|
|
188
|
-
const file = containerLeaseFilePath(joinPathSession(projectRoot, sessionId), options.leaseId);
|
|
189
|
-
if (!existsSync(file)) {
|
|
190
|
-
printResult(io, fail('container.release', 'LEASE_NOT_FOUND', `no lease on disk at ${file}`, { leaseId: options.leaseId, file }, [
|
|
191
|
-
'Run `peaks container list` to inspect active leases.',
|
|
192
|
-
'For a never-spawned lease, this is a no-op — no further action needed.'
|
|
193
|
-
]), options.json);
|
|
194
|
-
process.exitCode = 1;
|
|
195
|
-
return;
|
|
196
|
-
}
|
|
197
|
-
let lease;
|
|
198
|
-
try {
|
|
199
|
-
lease = deserializeContainerLease(readFileSync(file, 'utf8'));
|
|
200
|
-
}
|
|
201
|
-
catch (err) {
|
|
202
|
-
printResult(io, fail('container.release', 'LEASE_FILE_INVALID', getErrorMessage(err), { leaseId: options.leaseId, file }, [
|
|
203
|
-
'Delete the malformed lease file manually and re-issue spawn.',
|
|
204
|
-
'For security, release never fails open on a malformed lease.'
|
|
205
|
-
]), options.json);
|
|
206
|
-
process.exitCode = 1;
|
|
207
|
-
return;
|
|
208
|
-
}
|
|
209
|
-
if (lease.status === 'released') {
|
|
210
|
-
printResult(io, ok('container.release', { lease, sessionId, projectRoot, alreadyReleased: true }, [], [`Lease ${lease.leaseId} already released; nothing to do.`]), options.json);
|
|
211
|
-
return;
|
|
212
|
-
}
|
|
213
|
-
let dockerRmFailed = false;
|
|
214
|
-
try {
|
|
215
|
-
const releaseRuntime = detectContainerRuntime(undefined);
|
|
216
|
-
const runtimeCmd = releaseRuntime.ok ? releaseRuntime.runtime : 'docker';
|
|
217
|
-
execSync(`${runtimeCmd} rm --force "${lease.containerId}"`, {
|
|
218
|
-
cwd: projectRoot,
|
|
219
|
-
stdio: 'pipe',
|
|
220
|
-
encoding: 'utf8',
|
|
221
|
-
windowsHide: true
|
|
222
|
-
});
|
|
223
|
-
}
|
|
224
|
-
catch {
|
|
225
|
-
dockerRmFailed = true;
|
|
226
|
-
}
|
|
227
|
-
const released = markContainerReleased(lease);
|
|
228
|
-
atomicWriteJson(file, released);
|
|
229
|
-
printResult(io, ok('container.release', { lease: released, sessionId, projectRoot, dockerRmFailed }, dockerRmFailed
|
|
230
|
-
? [
|
|
231
|
-
'docker rm failed (likely the container was already removed); lease marked released.'
|
|
232
|
-
]
|
|
233
|
-
: [], [
|
|
234
|
-
`Lease ${lease.leaseId} marked released.`,
|
|
235
|
-
dockerRmFailed
|
|
236
|
-
? 'Manual `docker ps -a` + `docker rm` may be needed.'
|
|
237
|
-
: `Container ${lease.containerId} removed.`
|
|
238
|
-
]), options.json);
|
|
239
|
-
}
|
|
240
|
-
catch (err) {
|
|
241
|
-
printResult(io, fail('container.release', 'RELEASE_FAILED', getErrorMessage(err), { leaseId: options.leaseId, sessionId }, ['Verify the lease id and re-run.', 'If the lease was never spawned, no-op.']), options.json);
|
|
242
|
-
process.exitCode = 1;
|
|
243
|
-
}
|
|
244
|
-
});
|
|
31
|
+
registerContainerSpawnCommand(cmd, io);
|
|
32
|
+
registerContainerReleaseCommand(cmd, io);
|
|
245
33
|
}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import { execSync } from 'node:child_process';
|
|
2
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
3
|
+
import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
|
|
4
|
+
import { addJsonOption, printResult } from '../cli-helpers.js';
|
|
5
|
+
import { atomicWriteJson } from '../../services/ide/shared/atomic-json.js';
|
|
6
|
+
import { containerLeaseFilePath, deserializeContainerLease, markContainerReleased } from '../../services/container/container-lease.js';
|
|
7
|
+
import { detectContainerRuntime, joinPathSession, resolveContainerTarget } from './container-command-shared.js';
|
|
8
|
+
export function registerContainerReleaseCommand(cmd, io) {
|
|
9
|
+
addJsonOption(cmd
|
|
10
|
+
.command('release')
|
|
11
|
+
.description('Transition a container lease to released and run `docker rm --force`. Idempotent on already-released leases.')
|
|
12
|
+
.requiredOption('--lease-id <id>', 'lease id returned by `peaks container spawn`')
|
|
13
|
+
.option('--session <sid>', 'override session id')
|
|
14
|
+
.option('--project <path>', 'project root (default: findProjectRoot(cwd))')).action((options) => runContainerRelease(io, options));
|
|
15
|
+
}
|
|
16
|
+
/** Read + parse the lease file; `null` once the refusal is emitted. */
|
|
17
|
+
function readLease(io, options, file) {
|
|
18
|
+
if (!existsSync(file)) {
|
|
19
|
+
printResult(io, fail('container.release', 'LEASE_NOT_FOUND', `no lease on disk at ${file}`, {
|
|
20
|
+
leaseId: options.leaseId,
|
|
21
|
+
file
|
|
22
|
+
}, [
|
|
23
|
+
'Run `peaks container list` to inspect active leases.',
|
|
24
|
+
'For a never-spawned lease, this is a no-op — no further action needed.'
|
|
25
|
+
]), options.json);
|
|
26
|
+
process.exitCode = 1;
|
|
27
|
+
return null;
|
|
28
|
+
}
|
|
29
|
+
try {
|
|
30
|
+
return deserializeContainerLease(readFileSync(file, 'utf8'));
|
|
31
|
+
}
|
|
32
|
+
catch (err) {
|
|
33
|
+
printResult(io, fail('container.release', 'LEASE_FILE_INVALID', getErrorMessage(err), {
|
|
34
|
+
leaseId: options.leaseId,
|
|
35
|
+
file
|
|
36
|
+
}, [
|
|
37
|
+
'Delete the malformed lease file manually and re-issue spawn.',
|
|
38
|
+
'For security, release never fails open on a malformed lease.'
|
|
39
|
+
]), options.json);
|
|
40
|
+
process.exitCode = 1;
|
|
41
|
+
return null;
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
/** `docker rm --force`, tolerating a container that is already gone. */
|
|
45
|
+
function removeContainer(lease, projectRoot) {
|
|
46
|
+
try {
|
|
47
|
+
const detected = detectContainerRuntime(undefined);
|
|
48
|
+
const runtimeCmd = detected.ok ? detected.runtime : 'docker';
|
|
49
|
+
execSync(`${runtimeCmd} rm --force "${lease.containerId}"`, {
|
|
50
|
+
cwd: projectRoot,
|
|
51
|
+
stdio: 'pipe',
|
|
52
|
+
encoding: 'utf8',
|
|
53
|
+
windowsHide: true
|
|
54
|
+
});
|
|
55
|
+
return false;
|
|
56
|
+
}
|
|
57
|
+
catch {
|
|
58
|
+
return true;
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
function runContainerRelease(io, options) {
|
|
62
|
+
const { projectRoot, sessionId } = resolveContainerTarget(options);
|
|
63
|
+
try {
|
|
64
|
+
const file = containerLeaseFilePath(joinPathSession(projectRoot, sessionId), options.leaseId);
|
|
65
|
+
const lease = readLease(io, options, file);
|
|
66
|
+
if (lease === null)
|
|
67
|
+
return;
|
|
68
|
+
if (lease.status === 'released') {
|
|
69
|
+
printResult(io, ok('container.release', { lease, sessionId, projectRoot, alreadyReleased: true }, [], [`Lease ${lease.leaseId} already released; nothing to do.`]), options.json);
|
|
70
|
+
return;
|
|
71
|
+
}
|
|
72
|
+
const outcome = releaseLease({ options, io, projectRoot, sessionId, file, lease });
|
|
73
|
+
printResult(io, ok('container.release', outcome.data, outcome.warnings, outcome.nextActions), options.json);
|
|
74
|
+
}
|
|
75
|
+
catch (err) {
|
|
76
|
+
printResult(io, fail('container.release', 'RELEASE_FAILED', getErrorMessage(err), {
|
|
77
|
+
leaseId: options.leaseId,
|
|
78
|
+
sessionId
|
|
79
|
+
}, ['Verify the lease id and re-run.', 'If the lease was never spawned, no-op.']), options.json);
|
|
80
|
+
process.exitCode = 1;
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* `docker rm --force` the container, flip the lease to released and write it
|
|
85
|
+
* back. A failed `docker rm` is reported, not fatal: the lease is the source
|
|
86
|
+
* of truth and it is still marked released.
|
|
87
|
+
*/
|
|
88
|
+
function releaseLease(plan) {
|
|
89
|
+
const { projectRoot, sessionId, file, lease } = plan;
|
|
90
|
+
const dockerRmFailed = removeContainer(lease, projectRoot);
|
|
91
|
+
const released = markContainerReleased(lease);
|
|
92
|
+
atomicWriteJson(file, released);
|
|
93
|
+
return {
|
|
94
|
+
data: { lease: released, sessionId, projectRoot, dockerRmFailed },
|
|
95
|
+
warnings: dockerRmFailed
|
|
96
|
+
? ['docker rm failed (likely the container was already removed); lease marked released.']
|
|
97
|
+
: [],
|
|
98
|
+
nextActions: [
|
|
99
|
+
`Lease ${lease.leaseId} marked released.`,
|
|
100
|
+
dockerRmFailed
|
|
101
|
+
? 'Manual `docker ps -a` + `docker rm` may be needed.'
|
|
102
|
+
: `Container ${lease.containerId} removed.`
|
|
103
|
+
]
|
|
104
|
+
};
|
|
105
|
+
}
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
import { execSync } from 'node:child_process';
|
|
2
|
+
import { readFileSync } from 'node:fs';
|
|
3
|
+
import { fail, getErrorMessage, ok } from 'peaks-loop-shared/result';
|
|
4
|
+
import { addJsonOption, printResult } from '../cli-helpers.js';
|
|
5
|
+
import { atomicWriteJson } from '../../services/ide/shared/atomic-json.js';
|
|
6
|
+
import { normalizePath } from '../../shared/path-utils.js';
|
|
7
|
+
import { containerLeaseFilePath, finalizeContainerLease, generateContainerLeaseId, ttlForContainerRole } from '../../services/container/container-lease.js';
|
|
8
|
+
import { DEFAULT_DOCKER_IMAGE, detectContainerRuntime, joinPathSession, resolveContainerTarget } from './container-command-shared.js';
|
|
9
|
+
export function registerContainerSpawnCommand(cmd, io) {
|
|
10
|
+
addJsonOption(cmd
|
|
11
|
+
.command('spawn')
|
|
12
|
+
.description('Spawn a container via `docker run` and write a container lease. ' +
|
|
13
|
+
'The lease is the source of truth for the L4 PreToolUse gate (Part 12 follow-up). ' +
|
|
14
|
+
'Default TTL is role-aware (rd=30m / qa=15m / ui=1h); pass --ttl <ms> to override. ' +
|
|
15
|
+
'Default image is `node:22-slim`; pass --image <name> to override.')
|
|
16
|
+
.requiredOption('--rid <rid>', 'peaks request id the lease is associated with')
|
|
17
|
+
.requiredOption('--role <role>', 'sub-agent role (rd | qa | ui | sc | prd | general-purpose)')
|
|
18
|
+
.requiredOption('--purpose <text>', 'why this container was spawned (audit log)')
|
|
19
|
+
.option('--image <name>', `container image (default ${DEFAULT_DOCKER_IMAGE})`)
|
|
20
|
+
.option('--ttl <ms>', 'time-to-live in ms (default role-aware; override with positive number)')
|
|
21
|
+
.option('--mount <path>', 'host path to mount as the container working dir (default: <projectRoot>)')
|
|
22
|
+
.option('--session <sid>', 'override session id')
|
|
23
|
+
.option('--project <path>', 'project root (default: findProjectRoot(cwd))')).action((options) => runContainerSpawn(io, options));
|
|
24
|
+
}
|
|
25
|
+
/** The `--runtime` flag, narrowed to the two runtimes the adapter supports. */
|
|
26
|
+
function explicitRuntimeOf(options) {
|
|
27
|
+
if (options.runtime === 'docker')
|
|
28
|
+
return 'docker';
|
|
29
|
+
if (options.runtime === 'podman')
|
|
30
|
+
return 'podman';
|
|
31
|
+
return undefined;
|
|
32
|
+
}
|
|
33
|
+
/** Refuse `--runtime` when neither binary answers; `null` once refused. */
|
|
34
|
+
function requireRuntime(options, io, projectRoot, sessionId) {
|
|
35
|
+
const detected = detectContainerRuntime(explicitRuntimeOf(options));
|
|
36
|
+
if (detected.ok)
|
|
37
|
+
return detected;
|
|
38
|
+
printResult(io, fail('container.spawn', 'CONTAINER_RUNTIME_UNAVAILABLE', `${detected.stderr}: ${detected.hint}`, { rid: options.rid, role: options.role, sessionId }, [
|
|
39
|
+
'Install docker (Docker Desktop on macOS / Windows) or podman (RHEL / Fedora).',
|
|
40
|
+
'On Windows, ensure WSL2 backend is enabled and the daemon is running.',
|
|
41
|
+
'Pass --runtime docker|podman to force a specific runtime.'
|
|
42
|
+
]), options.json);
|
|
43
|
+
process.exitCode = 1;
|
|
44
|
+
return null;
|
|
45
|
+
}
|
|
46
|
+
/** Resolve `--ttl`, refusing a non-positive integer; `null` once refused. */
|
|
47
|
+
function requireTtl(options, io) {
|
|
48
|
+
const ttlMs = options.ttl === undefined
|
|
49
|
+
? ttlForContainerRole(options.role)
|
|
50
|
+
: Number.parseInt(options.ttl, 10);
|
|
51
|
+
if (Number.isInteger(ttlMs) && ttlMs > 0)
|
|
52
|
+
return ttlMs;
|
|
53
|
+
printResult(io, fail('container.spawn', 'INVALID_TTL', '--ttl must be a positive integer (ms)', { ttl: options.ttl }, ['Re-run with --ttl 1800000 (30 min) or omit to use role default.']), options.json);
|
|
54
|
+
process.exitCode = 1;
|
|
55
|
+
return null;
|
|
56
|
+
}
|
|
57
|
+
/** The worker root the cidfile lives in; `normalizePath` keeps Windows paths sane. */
|
|
58
|
+
function cidFileFor(plan) {
|
|
59
|
+
const root = normalizePath(joinPathSession(plan.projectRoot, plan.sessionId));
|
|
60
|
+
return `${root}/.${plan.detected.runtime}-cid-${plan.leaseId}`;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* `docker run --rm -d` so the container is detached and auto-removed when
|
|
64
|
+
* stopped; `--cidfile` writes the container id to a file we read back. The
|
|
65
|
+
* `--label peaks.leaseId=<id>` lets `peaks container list` / `peaks container gc`
|
|
66
|
+
* find orphans by label when the lease file is missing.
|
|
67
|
+
*
|
|
68
|
+
* Returns the container id, or `null` once DOCKER_RUN_FAILED is emitted.
|
|
69
|
+
*/
|
|
70
|
+
function runDockerSpawn(plan) {
|
|
71
|
+
const { options, io, projectRoot, detected, image, mount } = plan;
|
|
72
|
+
const cidFile = cidFileFor(plan);
|
|
73
|
+
try {
|
|
74
|
+
execSync(`${detected.runtime} run --rm -d --cidfile "${cidFile}" --label "peaks.leaseId=${plan.leaseId}" --label "peaks.rid=${options.rid}" -v "${mount}:/work" -w /work ${image} sleep infinity`, { cwd: projectRoot, stdio: 'pipe', encoding: 'utf8', windowsHide: true });
|
|
75
|
+
}
|
|
76
|
+
catch (err) {
|
|
77
|
+
printResult(io, fail('container.spawn', 'DOCKER_RUN_FAILED', getErrorMessage(err), { rid: options.rid, image, runtime: detected.runtime, sessionId: plan.sessionId }, [
|
|
78
|
+
'Verify the image name is reachable on the configured registry.',
|
|
79
|
+
'Verify the host path is mounted correctly (Windows: the path must be visible to WSL2).',
|
|
80
|
+
`Run \`${detected.runtime} ps -a\` to inspect any leftover containers with the peaks.leaseId label.`
|
|
81
|
+
]), options.json);
|
|
82
|
+
process.exitCode = 1;
|
|
83
|
+
return null;
|
|
84
|
+
}
|
|
85
|
+
return readFileSync(cidFile, 'utf8').trim();
|
|
86
|
+
}
|
|
87
|
+
/** Write the lease and print the success envelope. */
|
|
88
|
+
function finishSpawn(plan, containerId) {
|
|
89
|
+
const { options, io, projectRoot, sessionId, detected, image, mount, leaseId, now, ttlMs } = plan;
|
|
90
|
+
const lease = finalizeContainerLease({
|
|
91
|
+
leaseId,
|
|
92
|
+
rid: options.rid,
|
|
93
|
+
role: options.role,
|
|
94
|
+
path: mount,
|
|
95
|
+
image,
|
|
96
|
+
containerId,
|
|
97
|
+
createdAt: now,
|
|
98
|
+
expiresAt: now + ttlMs,
|
|
99
|
+
purpose: options.purpose
|
|
100
|
+
});
|
|
101
|
+
atomicWriteJson(containerLeaseFilePath(joinPathSession(projectRoot, sessionId), leaseId), lease);
|
|
102
|
+
printResult(io, ok('container.spawn', {
|
|
103
|
+
lease,
|
|
104
|
+
sessionId,
|
|
105
|
+
projectRoot,
|
|
106
|
+
runtime: detected.runtime,
|
|
107
|
+
runtimeVersion: detected.binary,
|
|
108
|
+
nextActions: [
|
|
109
|
+
`Container id: ${containerId}`,
|
|
110
|
+
`Image: ${image}`,
|
|
111
|
+
`Lease expires at: ${new Date(lease.expiresAt).toISOString()}`,
|
|
112
|
+
'Run `peaks container release --lease-id <id>` when done'
|
|
113
|
+
]
|
|
114
|
+
}, [], []), options.json);
|
|
115
|
+
}
|
|
116
|
+
function runContainerSpawn(io, options) {
|
|
117
|
+
const { projectRoot, sessionId } = resolveContainerTarget(options);
|
|
118
|
+
try {
|
|
119
|
+
const detected = requireRuntime(options, io, projectRoot, sessionId);
|
|
120
|
+
if (detected === null)
|
|
121
|
+
return;
|
|
122
|
+
const ttlMs = requireTtl(options, io);
|
|
123
|
+
if (ttlMs === null)
|
|
124
|
+
return;
|
|
125
|
+
const plan = {
|
|
126
|
+
options,
|
|
127
|
+
io,
|
|
128
|
+
projectRoot,
|
|
129
|
+
sessionId,
|
|
130
|
+
detected,
|
|
131
|
+
image: options.image ?? DEFAULT_DOCKER_IMAGE,
|
|
132
|
+
mount: options.mount ?? projectRoot,
|
|
133
|
+
leaseId: generateContainerLeaseId(),
|
|
134
|
+
now: Date.now(),
|
|
135
|
+
ttlMs
|
|
136
|
+
};
|
|
137
|
+
const containerId = runDockerSpawn(plan);
|
|
138
|
+
if (containerId === null)
|
|
139
|
+
return;
|
|
140
|
+
finishSpawn(plan, containerId);
|
|
141
|
+
}
|
|
142
|
+
catch (err) {
|
|
143
|
+
printResult(io, fail('container.spawn', 'SPAWN_FAILED', getErrorMessage(err), { rid: options.rid, sessionId }, [
|
|
144
|
+
'See error message; if the lease was not written, retry after fixing the underlying issue.'
|
|
145
|
+
]), options.json);
|
|
146
|
+
process.exitCode = 1;
|
|
147
|
+
}
|
|
148
|
+
}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
import { fail, ok } from 'peaks-loop-shared/result';
|
|
2
|
+
import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
|
|
3
|
+
import { formatMainSessionTriggerLogLine, pickMainSessionTrigger } from '../../services/context/main-session-monitor.js';
|
|
4
|
+
import { emitObservabilityEvent } from '../../services/observability/observability-service.js';
|
|
5
|
+
import { findProjectRoot } from '../../services/config/config-safety.js';
|
|
6
|
+
import { getSessionIdCanonical } from '../../services/session/session-manager.js';
|
|
7
|
+
import { capacityOf, requirePromptSize } from './context-status-command.js';
|
|
8
|
+
/** The `--in-flight-batch` seam: a sub-agent batch defers the trigger (D6.e). */
|
|
9
|
+
function inFlightOf(opts) {
|
|
10
|
+
return opts.inFlightBatch === true
|
|
11
|
+
? { hasInFlightBatch: true, sharedChannelEntries: 1 }
|
|
12
|
+
: undefined;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Observability hook #5/7. Fire-and-forget per PRD Q4; the synchronous emit
|
|
16
|
+
* never throws. Only fires when a session id is resolvable.
|
|
17
|
+
*/
|
|
18
|
+
function emitContextTrigger(trigger, promptSize) {
|
|
19
|
+
const projectRoot = findProjectRoot(process.cwd()) ?? process.cwd();
|
|
20
|
+
const sid = getSessionIdCanonical(projectRoot) ?? '';
|
|
21
|
+
if (sid.length === 0)
|
|
22
|
+
return;
|
|
23
|
+
emitObservabilityEvent({
|
|
24
|
+
schemaVersion: 1,
|
|
25
|
+
ts: new Date().toISOString(),
|
|
26
|
+
sessionId: sid,
|
|
27
|
+
category: 'context-trigger',
|
|
28
|
+
detail: {
|
|
29
|
+
kind: trigger.kind,
|
|
30
|
+
promptSize,
|
|
31
|
+
...(trigger.kind === 'soft-warn' || trigger.kind === 'compact'
|
|
32
|
+
? { ratio: trigger.ratio }
|
|
33
|
+
: {})
|
|
34
|
+
}
|
|
35
|
+
}, { projectRoot });
|
|
36
|
+
}
|
|
37
|
+
/** The single advisory line the tier decides. */
|
|
38
|
+
function triggerAdvice(trigger) {
|
|
39
|
+
if (trigger.kind === 'compact') {
|
|
40
|
+
return `Tier reached → trigger ${trigger.path} on ${trigger.ide} (code=${trigger.code})`;
|
|
41
|
+
}
|
|
42
|
+
if (trigger.kind === 'defer')
|
|
43
|
+
return `Deferred: ${trigger.reason}`;
|
|
44
|
+
if (trigger.kind === 'soft-warn') {
|
|
45
|
+
return `Soft warning at ${(trigger.ratio * 100).toFixed(0)}% (no trigger yet)`;
|
|
46
|
+
}
|
|
47
|
+
return 'Below threshold; no trigger';
|
|
48
|
+
}
|
|
49
|
+
export function registerContextCheckCommand(context, io) {
|
|
50
|
+
addJsonOption(context
|
|
51
|
+
.command('check')
|
|
52
|
+
.description('v2.11.0 D6: threshold check + IDE-aware trigger dispatch. With --auto-trigger, returns the trigger path the LLM should follow; without, returns a dry-run recommendation. The LLM is responsible for actually invoking the trigger (slash command, self-compress, or escalation).')
|
|
53
|
+
.requiredOption('--prompt-size <bytes>', 'estimated prompt size in bytes')
|
|
54
|
+
.option('--capacity <bytes>', 'override the 256K default capacity (test seam)', '262144')
|
|
55
|
+
.option('--in-flight-batch', 'a sub-agent batch is in flight (defer trigger per D6.e)', false)
|
|
56
|
+
.option('--auto-trigger', 'return the trigger path the LLM should follow', false)).action((opts) => {
|
|
57
|
+
try {
|
|
58
|
+
const promptSize = requirePromptSize('context.check', opts, io);
|
|
59
|
+
if (promptSize === null)
|
|
60
|
+
return;
|
|
61
|
+
const trigger = pickMainSessionTrigger({
|
|
62
|
+
promptSize,
|
|
63
|
+
capacityBytes: capacityOf(opts),
|
|
64
|
+
inFlightBatch: inFlightOf(opts)
|
|
65
|
+
});
|
|
66
|
+
emitContextTrigger(trigger, promptSize);
|
|
67
|
+
const payload = {
|
|
68
|
+
...trigger,
|
|
69
|
+
autoTrigger: opts.autoTrigger === true,
|
|
70
|
+
logLine: formatMainSessionTriggerLogLine(trigger, 'main')
|
|
71
|
+
};
|
|
72
|
+
printResult(io, ok('context.check', payload, [], [triggerAdvice(trigger)]), opts.json);
|
|
73
|
+
}
|
|
74
|
+
catch (err) {
|
|
75
|
+
printResult(io, fail('context.check', 'CONTEXT_CHECK_FAILED', getErrorMessage(err), null, [
|
|
76
|
+
'Verify --prompt-size is a non-negative number'
|
|
77
|
+
]), opts.json);
|
|
78
|
+
process.exitCode = 1;
|
|
79
|
+
}
|
|
80
|
+
});
|
|
81
|
+
}
|
|
@@ -1,11 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* peaks context * CLI (Slice #3 L1c) — context 4-layer loader.
|
|
3
3
|
*
|
|
4
|
-
* - L0: full read (every SKILL.md in full)
|
|
5
|
-
* - L1: summary (one paragraph per skill + the skill list)
|
|
6
|
-
* - L2: index (just names + paths)
|
|
7
|
-
* - L3: fuzzy search by query (delegates to peaks memory search)
|
|
8
|
-
*
|
|
9
4
|
* The LLM-side UX layer (peaks-code / peaks-ide) picks the layer based
|
|
10
5
|
* on the L1a task level:
|
|
11
6
|
* - typo: L0 only (a few lines)
|
|
@@ -15,6 +10,6 @@
|
|
|
15
10
|
* - migration: L0 + L1 + L2 + L3 + codegraph
|
|
16
11
|
*/
|
|
17
12
|
import type { Command } from 'commander';
|
|
18
|
-
import {
|
|
19
|
-
export type ContextLayer
|
|
13
|
+
import type { ProgramIO } from '../cli-helpers.js';
|
|
14
|
+
export type { ContextLayer } from './context-layer-fetchers.js';
|
|
20
15
|
export declare function registerContextCommands(program: Command, io: ProgramIO): void;
|