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
|
@@ -1,283 +1,113 @@
|
|
|
1
1
|
/**
|
|
2
|
+
* The `--from-dag` path of `peaks sub-agent dispatch`.
|
|
2
3
|
*
|
|
3
|
-
* Pulled out of `dispatch-commands.ts` to honor the
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
4
|
+
* Pulled out of `dispatch-commands.ts` to honor the file-size cap (Karpathy #2
|
|
5
|
+
* Simplicity First). The single-dispatch action stays in `dispatch-commands.ts`;
|
|
6
|
+
* the DAG-dispatch path lives here because the two share no logic — the
|
|
7
|
+
* warm-path single dispatch does NOT load slice-dag / dag-orchestrator /
|
|
8
|
+
* contract-store (slice 9 perf), while the `--from-dag` codepath loads all
|
|
9
|
+
* three on first call.
|
|
9
10
|
*
|
|
10
|
-
* 2.7.0 slice-dag-dispatcher MVP: read a SliceDag from a file and run
|
|
11
|
-
*
|
|
12
|
-
* that emits the per-IDE `buildToolCall` envelope for each topological
|
|
13
|
-
* level.
|
|
11
|
+
* 2.7.0 slice-dag-dispatcher MVP: read a SliceDag from a file and run it
|
|
12
|
+
* through `runLayeredDag`. The orchestrator's `runSlice` is a thin wrapper
|
|
13
|
+
* that emits the per-IDE `buildToolCall` envelope for each topological level.
|
|
14
14
|
*
|
|
15
15
|
* 1.2 MVP scope: this dispatches the FIRST topological level synchronously
|
|
16
|
-
* (returns the dispatch specs); subsequent levels are not surfaced in
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
16
|
+
* (returns the dispatch specs); subsequent levels are not surfaced in the CLI
|
|
17
|
+
* envelope because the LLM-side runner must actually execute each
|
|
18
|
+
* `buildToolCall` and write the resulting contract before level 2+ can be
|
|
19
|
+
* safely auto-advanced. The LLM re-invokes `peaks sub-agent dispatch --from-dag
|
|
20
|
+
* <file> --batch-id <id>` after writing level-1 contracts, which causes
|
|
21
|
+
* `runLayeredDag` to plan level 2+ with the level-1 ancestor contracts spliced
|
|
22
|
+
* into their dispatch prompts.
|
|
23
23
|
*
|
|
24
|
-
* Internally,
|
|
25
|
-
* cancel-on-fail path is exercised end-to-end during the MVP emit; only
|
|
26
|
-
*
|
|
24
|
+
* Internally, `runLayeredDag` DOES iterate all levels so its join-barrier +
|
|
25
|
+
* cancel-on-fail path is exercised end-to-end during the MVP emit; only the
|
|
26
|
+
* CLI envelope is filtered to level-1 toolCalls (see `firstLevelIds`).
|
|
27
27
|
*/
|
|
28
|
-
import { randomUUID } from 'node:crypto';
|
|
29
28
|
import { printResult } from '../cli-helpers.js';
|
|
30
|
-
import {
|
|
31
|
-
import {
|
|
32
|
-
import {
|
|
33
|
-
import {
|
|
34
|
-
import { planFileOverlapWaves } from '../../services/dispatch/file-overlap-wave-planner.js';
|
|
29
|
+
import { buildDagSuccessEnvelope } from './dispatch-dag-envelope.js';
|
|
30
|
+
import { emitDagFailure } from './dispatch-dag-failure.js';
|
|
31
|
+
import { assertGraphNodesMapped, loadDagRuntime, readDagOrFail, resolveDagIds, topologicalLevelsOrFail } from './dispatch-dag-preflight.js';
|
|
32
|
+
import { makeCliRunner, makeNoopWriter, planFirstLevelWaves, resolveDagDispatcher } from './dispatch-dag-runners.js';
|
|
35
33
|
export async function runDispatchFromDag(role, options, asJson, io) {
|
|
36
34
|
if (!options.fromDag)
|
|
37
35
|
return;
|
|
38
|
-
const
|
|
39
|
-
|
|
40
|
-
const
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
'unknown-sid';
|
|
44
|
-
const rid = options.requestId ?? 'unknown-rid';
|
|
45
|
-
const batchId = options.batchId ?? randomUUID();
|
|
46
|
-
// Slice 9 (dispatch CLI latency): the --from-dag codepath loads three
|
|
47
|
-
// heavy modules (slice-dag, dag-orchestrator, contract-store) that
|
|
48
|
-
// transitively import 10+ more services. They are NOT touched by the
|
|
49
|
-
// warm-path single-dispatch action, so we lazy-load them here only
|
|
50
|
-
// when --from-dag is actually requested. The dynamic-import promise
|
|
51
|
-
// resolves on first call, then ESM caches the module for subsequent
|
|
52
|
-
// calls in the same process.
|
|
53
|
-
const [{ readFileSync }, sliceDagMod, dagOrchestratorMod, contractStoreMod] = await Promise.all([
|
|
54
|
-
import('node:fs'),
|
|
55
|
-
import('../../services/dispatch/slice-dag.js'),
|
|
56
|
-
import('../../services/code/dag-orchestrator.js'),
|
|
57
|
-
import('../../services/dispatch/contract-store.js')
|
|
58
|
-
]);
|
|
59
|
-
const { validateDag, topologicalLevels, isSliceComplexity } = sliceDagMod;
|
|
60
|
-
const { runLayeredDag } = dagOrchestratorMod;
|
|
61
|
-
const { listContracts, hashContract } = contractStoreMod;
|
|
62
|
-
let dag;
|
|
63
|
-
try {
|
|
64
|
-
const raw = readFileSync(options.fromDag, 'utf8');
|
|
65
|
-
const parsed = JSON.parse(raw);
|
|
66
|
-
validateDag(parsed);
|
|
67
|
-
dag = parsed;
|
|
68
|
-
}
|
|
69
|
-
catch (err) {
|
|
70
|
-
printResult(io, fail('sub-agent.dispatch', 'INVALID_DAG', `failed to read or validate DAG from ${options.fromDag}: ${err.message}`, { role, toolCall: null, dispatchRecordPath: null }, [
|
|
71
|
-
'Check the JSON file at the given path; the DAG must have {nodes, edges} and pass validateDag().'
|
|
72
|
-
]), asJson);
|
|
73
|
-
process.exitCode = 1;
|
|
36
|
+
const scope = { role, asJson, io };
|
|
37
|
+
const ids = resolveDagIds(options);
|
|
38
|
+
const runtime = await loadDagRuntime();
|
|
39
|
+
const dag = readDagOrFail(runtime, options.fromDag, scope);
|
|
40
|
+
if (dag === null)
|
|
74
41
|
return;
|
|
75
|
-
|
|
76
|
-
// Slice 4.0.8 RD §4 D4c: each DAG node must map to an explicitly
|
|
77
|
-
// prepared workflow graph node before sub-agent dispatch. Reject
|
|
78
|
-
// unmapped nodes with PEAKS_GRAPH_NODE_REQUIRED. The mapping is
|
|
79
|
-
// carried via the `graphNode` annotation on each DAG node, OR — as
|
|
80
|
-
// a back-compat fallback for DAGs without the annotation — the
|
|
81
|
-
// DAG node id itself is treated as the graph node id. Either way,
|
|
82
|
-
// the graph node must be prepared (RD §3 D4c) before the dispatch
|
|
83
|
-
// CLI runs.
|
|
84
|
-
for (const node of dag.nodes) {
|
|
85
|
-
const graphNodeId = node.graphNode;
|
|
86
|
-
const candidate = typeof graphNodeId === 'string' && graphNodeId.length > 0 ? graphNodeId : node.id;
|
|
87
|
-
if (typeof candidate !== 'string' || candidate.length === 0) {
|
|
88
|
-
printResult(io, fail('sub-agent.dispatch', 'PEAKS_GRAPH_NODE_REQUIRED', `DAG node ${node.id} has no graph-node mapping (RD §4 D4c)`, { role, toolCall: null, dispatchRecordPath: null, dagNodeId: node.id }, [
|
|
89
|
-
'Annotate the DAG node with `graphNode: "<id>"` so each dispatch can bind a prepared graph node.'
|
|
90
|
-
]), asJson);
|
|
91
|
-
process.exitCode = 1;
|
|
92
|
-
return;
|
|
93
|
-
}
|
|
94
|
-
}
|
|
95
|
-
// MVP (1.2): the orchestrator iterates topological levels + join
|
|
96
|
-
// barrier + cancel-on-fail end-to-end. The CLI's runner returns `done`
|
|
97
|
-
// for every leaf (so runDag's cancel-on-fail path is exercised when a
|
|
98
|
-
// leaf actually fails); the CLI envelope filters `emittedToolCalls` to
|
|
99
|
-
// the first level only (see `firstLevelIds`). The LLM-side runner
|
|
100
|
-
// re-invokes `--from-dag` for level 2+ after writing level-1
|
|
101
|
-
// contracts via `peaks contract write`.
|
|
102
|
-
let levelArr;
|
|
103
|
-
try {
|
|
104
|
-
levelArr = topologicalLevels(dag);
|
|
105
|
-
}
|
|
106
|
-
catch (err) {
|
|
107
|
-
printResult(io, fail('sub-agent.dispatch', 'INVALID_DAG', `topologicalLevels failed for ${options.fromDag}: ${err.message}`, { role, toolCall: null, dispatchRecordPath: null }, [
|
|
108
|
-
'The DAG passed validateDag() but topologicalLevels threw (likely a cycle that slipped past validateDag, or a runtime invariant).',
|
|
109
|
-
'Inspect the DAG file with the editor and re-invoke dispatch. (No peaks scan dag CLI ships in 2.7.0; if you need a programmatic DAG validator, import validateDag / topologicalLevels from src/services/dispatch/slice-dag.ts directly.)'
|
|
110
|
-
]), asJson);
|
|
111
|
-
process.exitCode = 1;
|
|
42
|
+
if (assertGraphNodesMapped(dag, scope) === null)
|
|
112
43
|
return;
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
44
|
+
const levelArr = topologicalLevelsOrFail(runtime, dag, options.fromDag, scope);
|
|
45
|
+
if (levelArr === null)
|
|
46
|
+
return;
|
|
47
|
+
const dispatched = resolveDagDispatcher(ids.projectRoot);
|
|
48
|
+
if (!dispatched.dispatcher.supportsRole(role)) {
|
|
49
|
+
emitDagFailure(io, asJson, {
|
|
50
|
+
role,
|
|
51
|
+
code: 'IDE_NOT_SUPPORTED',
|
|
52
|
+
message: `IDE ${dispatched.ide} does not support role "${role}"`,
|
|
53
|
+
nextActions: [
|
|
54
|
+
'Switch to a registered IDE (e.g. claude-code) or pick a role the current IDE supports.'
|
|
55
|
+
]
|
|
56
|
+
});
|
|
126
57
|
return;
|
|
127
58
|
}
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
59
|
+
await runLevels({ runtime, dag, levelArr, dispatched, ids, scope, fromDag: options.fromDag });
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Run every topological level through `runLayeredDag` and print the level-1
|
|
63
|
+
* envelope. Upstream contracts are read first so downstream-level prompts get
|
|
64
|
+
* auto-injected ancestors via `formatContractInjection` (empty at level-1 emit
|
|
65
|
+
* time, which is when the LLM re-invokes with fresh level-1 contracts).
|
|
66
|
+
*/
|
|
67
|
+
async function runLevels(run) {
|
|
68
|
+
const { runtime, dag, levelArr, dispatched, ids, scope, fromDag } = run;
|
|
69
|
+
const existingContracts = runtime.listContracts(ids.projectRoot, ids.sid);
|
|
136
70
|
const firstLevelIds = new Set(levelArr[0] ?? []);
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
const firstLevelWaves = firstLevelDescriptors.length > 0 && firstLevelDescriptors.every((d) => d.files.length > 0)
|
|
146
|
-
? planFileOverlapWaves(firstLevelDescriptors).waves
|
|
147
|
-
: null;
|
|
148
|
-
const emittedToolCalls = [];
|
|
149
|
-
const emittedSliceIds = [];
|
|
150
|
-
// CLI runner: emit the per-slice `buildToolCall` envelope, then return
|
|
151
|
-
// `done` with an empty `publicSurface` placeholder. The orchestrator
|
|
152
|
-
// treats the slice as "CLI-emitted, awaiting LLM-side execution" and
|
|
153
|
-
// advances to the next topological level (or breaks on failure). The
|
|
154
|
-
// placeholder surface is intentionally empty: the real public surface
|
|
155
|
-
// arrives later via `peaks contract write` from the LLM-side runner,
|
|
156
|
-
// and overwrites the CLI placeholder contract written by `noopWriter`.
|
|
157
|
-
// Why not `cancelled`? Returning `cancelled` here short-circuits
|
|
158
|
-
// runDag's join-barrier + cancel-on-fail path — the orchestrator
|
|
159
|
-
// breaks out after the first level with a cancellation, which hides
|
|
160
|
-
// the real cancel-on-fail semantics from the test suite (and from any
|
|
161
|
-
// future caller that wants to use `runDag` end-to-end from the CLI).
|
|
162
|
-
// Returning `done` exercises the full happy path; cancel-on-fail
|
|
163
|
-
// semantics will be covered when 1.3 lands real per-IDE await.
|
|
164
|
-
const cliRunner = async (spec) => {
|
|
165
|
-
const toolCall = dispatcher.buildToolCall({
|
|
166
|
-
role: spec.role,
|
|
167
|
-
prompt: spec.prompt,
|
|
168
|
-
requestId: rid,
|
|
169
|
-
sessionId: sid
|
|
170
|
-
});
|
|
171
|
-
if (firstLevelIds.has(spec.sliceId)) {
|
|
172
|
-
emittedToolCalls.push(toolCall);
|
|
173
|
-
emittedSliceIds.push(spec.sliceId);
|
|
174
|
-
}
|
|
175
|
-
return {
|
|
176
|
-
status: 'done',
|
|
177
|
-
publicSurface: {
|
|
178
|
-
exports: [],
|
|
179
|
-
types: [],
|
|
180
|
-
publicSignatures: []
|
|
181
|
-
}
|
|
182
|
-
};
|
|
183
|
-
};
|
|
184
|
-
// CLI noop writer — the orchestrator collects a `SliceContract` per
|
|
185
|
-
// emitted toolCall so downstream re-invocations (level 2+) can splice
|
|
186
|
-
// ancestor contracts via `formatContractInjection`. We don't write to
|
|
187
|
-
// disk here (the LLM-side runner does that via `peaks contract write`
|
|
188
|
-
// after each toolCall resolves), but the returned placeholder MUST be
|
|
189
|
-
// shape-valid: the `contractHash` field has to be a real SHA-256 hex
|
|
190
|
-
// string so formatContractInjection + downstream validators don't
|
|
191
|
-
// reject the placeholder. The placeholder hash is computed from the
|
|
192
|
-
// slice identity only (`sliceId|sessionId`) — it's deterministic,
|
|
193
|
-
// stable, and collision-free for the MVP run, but obviously does NOT
|
|
194
|
-
// represent the slice's actual public surface. The LLM-side runner's
|
|
195
|
-
// `peaks contract write` call will overwrite this with a content-based
|
|
196
|
-
// hash once the slice finishes.
|
|
197
|
-
const noopWriter = (sliceId, _publicSurface) => {
|
|
198
|
-
const partial = {
|
|
199
|
-
sliceId,
|
|
200
|
-
sessionId: sid,
|
|
201
|
-
exports: [],
|
|
202
|
-
types: [],
|
|
203
|
-
publicSignatures: []
|
|
204
|
-
};
|
|
205
|
-
return {
|
|
206
|
-
sliceId,
|
|
207
|
-
sessionId: sid,
|
|
208
|
-
completedAt: new Date(0).toISOString(), // epoch sentinel = "placeholder, not yet finished"
|
|
209
|
-
exports: [],
|
|
210
|
-
types: [],
|
|
211
|
-
publicSignatures: [],
|
|
212
|
-
contractHash: hashContract(partial)
|
|
213
|
-
};
|
|
214
|
-
};
|
|
215
|
-
// runLayeredDag IS in the path: validates the DAG, iterates all
|
|
216
|
-
// topological levels (foundation/upstreamSync slices prioritized within
|
|
217
|
-
// each level by `topologicalLevels`), runs the join barrier after
|
|
218
|
-
// each level, and triggers cancel-on-fail rollback if any leaf
|
|
219
|
-
// returns `failed` (or `cancelled`, once 1.3 lands). The CLI
|
|
220
|
-
// envelope below filters `emittedToolCalls` / `emittedSliceIds` to
|
|
221
|
-
// the first level — see the `firstLevelIds` filter inside `cliRunner`.
|
|
71
|
+
const emissions = { toolCalls: [], sliceIds: [] };
|
|
72
|
+
const runSlice = makeCliRunner({
|
|
73
|
+
firstLevelIds,
|
|
74
|
+
dispatcher: dispatched.dispatcher,
|
|
75
|
+
ids,
|
|
76
|
+
emissions
|
|
77
|
+
});
|
|
78
|
+
const writeContractFn = makeNoopWriter(runtime.hashContract, ids.sid);
|
|
222
79
|
try {
|
|
223
|
-
await runLayeredDag(dag, {
|
|
224
|
-
projectRoot,
|
|
225
|
-
sessionId: sid,
|
|
80
|
+
await runtime.runLayeredDag(dag, {
|
|
81
|
+
projectRoot: ids.projectRoot,
|
|
82
|
+
sessionId: ids.sid,
|
|
226
83
|
existingContracts,
|
|
227
|
-
runSlice
|
|
228
|
-
writeContractFn
|
|
84
|
+
runSlice,
|
|
85
|
+
writeContractFn
|
|
229
86
|
});
|
|
230
87
|
}
|
|
231
88
|
catch (err) {
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
89
|
+
emitDagFailure(scope.io, scope.asJson, {
|
|
90
|
+
role: scope.role,
|
|
91
|
+
code: 'INVALID_DAG',
|
|
92
|
+
message: `runLayeredDag failed for ${fromDag}: ${err.message}`,
|
|
93
|
+
nextActions: [
|
|
94
|
+
'runLayeredDag threw DagPlanError; the DAG passed validateDag() but failed at topologicalLevels or contractStore dispatch.',
|
|
95
|
+
'Inspect the DAG file and re-run.'
|
|
96
|
+
]
|
|
97
|
+
});
|
|
241
98
|
return;
|
|
242
99
|
}
|
|
243
|
-
printResult(io,
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
batchId,
|
|
249
|
-
dispatchCount: emittedSliceIds.length,
|
|
100
|
+
printResult(scope.io, buildDagSuccessEnvelope({
|
|
101
|
+
role: scope.role,
|
|
102
|
+
ide: dispatched.dispatcher.label,
|
|
103
|
+
fromDag,
|
|
104
|
+
batchId: ids.batchId,
|
|
250
105
|
levelsTotal: levelArr.length,
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
firstLevelWaves,
|
|
255
|
-
toolCalls: emittedToolCalls,
|
|
106
|
+
emittedSliceIds: emissions.sliceIds,
|
|
107
|
+
emittedToolCalls: emissions.toolCalls,
|
|
108
|
+
firstLevelWaves: planFirstLevelWaves(dag, levelArr),
|
|
256
109
|
existingContractCount: existingContracts.length,
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
// v2.15.0 follow-up — G12/G11/G2: per-slice metadata (foundation /
|
|
261
|
-
// upstreamSync / complexity) for downstream scheduling decisions.
|
|
262
|
-
sliceMeta: emittedSliceIds.map((id) => {
|
|
263
|
-
const node = dag.nodes.find((n) => n.id === id);
|
|
264
|
-
return {
|
|
265
|
-
id,
|
|
266
|
-
foundation: node?.foundation === true,
|
|
267
|
-
upstreamSync: node?.upstreamSync === true,
|
|
268
|
-
complexity: node?.complexity !== undefined && isSliceComplexity(node.complexity)
|
|
269
|
-
? node.complexity
|
|
270
|
-
: null
|
|
271
|
-
};
|
|
272
|
-
}),
|
|
273
|
-
nextActions: [
|
|
274
|
-
'Execute each toolCall in your IDE; on completion, write the slice contract to .peaks/_runtime/<sid>/dispatch/contracts/<slice-id>.json.',
|
|
275
|
-
'Re-invoke `peaks sub-agent dispatch --from-dag <file>` with the same batch-id to advance to the next level once all current-level slices have written contracts.'
|
|
276
|
-
]
|
|
277
|
-
}, [], [
|
|
278
|
-
'MVP (1.2) plans the first level via runLayeredDag orchestrator (cancel-on-fail path active); the LLM drives subsequent levels by re-invoking this command after contract writes.',
|
|
279
|
-
existingContracts.length > 0
|
|
280
|
-
? `Injected ${existingContracts.length} upstream contract(s) into downstream-level prompts via formatContractInjection.`
|
|
281
|
-
: 'No upstream contracts found; first-level prompts have empty ancestor blocks.'
|
|
282
|
-
]), asJson);
|
|
110
|
+
dag,
|
|
111
|
+
isSliceComplexity: runtime.isSliceComplexity
|
|
112
|
+
}), scope.asJson);
|
|
283
113
|
}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
// The `peaks sub-agent dispatch` preflight: every refusal that can be decided from
|
|
2
2
|
// the argv alone, before the session id, the lease or the prompt blocks are touched.
|
|
3
3
|
// Returns the prompt-size decision, or `null` when a refusal was already printed.
|
|
4
|
+
import { readFileSync } from 'node:fs';
|
|
4
5
|
import { printResult } from '../cli-helpers.js';
|
|
5
6
|
import { fail } from 'peaks-loop-shared/result';
|
|
6
7
|
import { evaluatePromptSize } from '../../services/context/context-guard.js';
|
|
@@ -45,6 +46,47 @@ function applyPromptLengthOverride(options) {
|
|
|
45
46
|
}
|
|
46
47
|
}
|
|
47
48
|
}
|
|
49
|
+
function rejectPromptFileUnreadable(io, role, prompt, asJson) {
|
|
50
|
+
printResult(io, fail('sub-agent.dispatch', 'PROMPT_FILE_NOT_FOUND', `--prompt "${prompt}" is a file reference ("@<path>") but that path could not be read`, { role, toolCall: null, dispatchRecordPath: null }, [
|
|
51
|
+
'Fix the path after "@", or pass the prompt text itself.',
|
|
52
|
+
'A --prompt that does not begin with "@" is sent verbatim.'
|
|
53
|
+
]), asJson);
|
|
54
|
+
process.exitCode = 1;
|
|
55
|
+
return null;
|
|
56
|
+
}
|
|
57
|
+
function rejectEmptyPromptFile(io, role, prompt, asJson) {
|
|
58
|
+
printResult(io, fail('sub-agent.dispatch', 'MISSING_PROMPT', `--prompt "${prompt}" resolved to an empty file: a dispatch needs instructions`, { role, toolCall: null, dispatchRecordPath: null }, [
|
|
59
|
+
'Write the brief into the referenced file, or pass the prompt text itself.',
|
|
60
|
+
'An empty or whitespace-only file carries no brief, so the dispatch would look successful and instruct nothing.'
|
|
61
|
+
]), asJson);
|
|
62
|
+
process.exitCode = 1;
|
|
63
|
+
return null;
|
|
64
|
+
}
|
|
65
|
+
// `--prompt "@<path>"` is a file reference, mirroring `peaks prd handoff init
|
|
66
|
+
// --body` (prd-commands.ts `resolveBody`). Before this the "@" token was sent
|
|
67
|
+
// as literal text, so a dispatch naming a brief file went out carrying the path
|
|
68
|
+
// and none of the brief — no warning, exit 0. A prompt that does not begin with
|
|
69
|
+
// "@" is returned untouched, byte-identical.
|
|
70
|
+
//
|
|
71
|
+
// The emptiness check is repeated AFTER the read, and only on this branch: the
|
|
72
|
+
// pre-read check sees the token "@<path>", never the file's contents, so an
|
|
73
|
+
// empty file passes it and re-opens the same silent-dispatch defect from the
|
|
74
|
+
// other side. A whitespace-only file is the same input. Both are refused; a
|
|
75
|
+
// LITERAL prompt is not re-checked, so a whitespace-only literal is unchanged.
|
|
76
|
+
function resolvePromptFileRef(io, role, prompt, asJson) {
|
|
77
|
+
if (!prompt.startsWith('@'))
|
|
78
|
+
return { prompt };
|
|
79
|
+
try {
|
|
80
|
+
const content = readFileSync(prompt.slice(1), 'utf8');
|
|
81
|
+
if (content.trim().length === 0) {
|
|
82
|
+
return rejectEmptyPromptFile(io, role, prompt, asJson);
|
|
83
|
+
}
|
|
84
|
+
return { prompt: content };
|
|
85
|
+
}
|
|
86
|
+
catch {
|
|
87
|
+
return rejectPromptFileUnreadable(io, role, prompt, asJson);
|
|
88
|
+
}
|
|
89
|
+
}
|
|
48
90
|
function rejectPromptTooLarge(io, role, promptLength, asJson) {
|
|
49
91
|
printResult(io, fail('sub-agent.dispatch', 'PROMPT_TOO_LARGE', `prompt exceeds ${PROMPT_LIMIT_BYTES} bytes (got ${promptLength})`, { role, toolCall: null, dispatchRecordPath: null }, [
|
|
50
92
|
'Truncate the prompt or split into multiple dispatches.',
|
|
@@ -86,6 +128,10 @@ export function preflightDispatch(io, role, options, asJson) {
|
|
|
86
128
|
if (!options.prompt || options.prompt.length === 0) {
|
|
87
129
|
return rejectMissingPrompt(io, role, asJson);
|
|
88
130
|
}
|
|
131
|
+
const fileRef = resolvePromptFileRef(io, role, options.prompt, asJson);
|
|
132
|
+
if (fileRef === null)
|
|
133
|
+
return null;
|
|
134
|
+
options.prompt = fileRef.prompt;
|
|
89
135
|
// Slice 4.0.8 RD §4 D4c required `--graph-node` here, before the session
|
|
90
136
|
// id existed, so the only recovery it could offer was prose. The node is
|
|
91
137
|
// now provisioned inside the try block below, once `sid` is known.
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import type { Command } from 'commander';
|
|
1
2
|
import { type ProgramIO } from '../cli-helpers.js';
|
|
2
3
|
import { getAdapter } from '../../services/ide/ide-registry.js';
|
|
3
4
|
import type { ContextGuardDecision } from '../../services/context/context-guard.js';
|
|
@@ -16,6 +17,11 @@ export interface ComposeDispatchPromptInput {
|
|
|
16
17
|
worktreeBranch: string | null;
|
|
17
18
|
decision: ContextGuardDecision;
|
|
18
19
|
asJson: boolean;
|
|
20
|
+
/**
|
|
21
|
+
* The registered CLI, so the prompt's own quotations of it can be resolved
|
|
22
|
+
* against the commands that exist rather than against a second, hand-kept list.
|
|
23
|
+
*/
|
|
24
|
+
rootCommand: Command;
|
|
19
25
|
}
|
|
20
26
|
export interface ComposedDispatchPrompt {
|
|
21
27
|
adapter: ReturnType<typeof getAdapter>;
|
|
@@ -1,7 +1,3 @@
|
|
|
1
|
-
// The prompt `peaks sub-agent dispatch` hands a sub-agent: the adapter check, the
|
|
2
|
-
// optional preflight blocks (memory / codegraph / UI library / fresh context /
|
|
3
|
-
// context probe / session capsule), the isolation and must-ls-files blocks, and the
|
|
4
|
-
// warning list the envelope carries.
|
|
5
1
|
import { fail, getErrorMessage } from 'peaks-loop-shared/result';
|
|
6
2
|
import { printResult } from '../cli-helpers.js';
|
|
7
3
|
import { detectInstalledIde } from '../../services/ide/ide-detector.js';
|
|
@@ -16,6 +12,9 @@ import { computeUiLibraryDispatchBlock } from '../../services/standards/ui-libra
|
|
|
16
12
|
import { readFreshContextBlock } from '../../services/fresh-context/fresh-context-block.js';
|
|
17
13
|
import { deprecatedReviewerWarnings } from './sub-agent-shared.js';
|
|
18
14
|
import { buildIsolationBlock, buildMustLsFilesBlock } from './dispatch-prompt-blocks.js';
|
|
15
|
+
import { ensureArtifactContractBlock, readArtifactContractBlock } from '../../services/artifacts/artifact-contract-block.js';
|
|
16
|
+
import { ensureKarpathyBlock } from '../../services/dispatch/karpathy-block.js';
|
|
17
|
+
import { cliInvocationWarnings } from './dispatch-cli-invocation-check.js';
|
|
19
18
|
// loadPreferences can throw on schema mismatch; we fall back to defaults
|
|
20
19
|
// to avoid breaking the dispatch on a stale preferences.json file.
|
|
21
20
|
function loadProjectPreferences(projectRoot) {
|
|
@@ -154,7 +153,7 @@ async function composeMemoryAugmentedBody(input, projectPrefs) {
|
|
|
154
153
|
});
|
|
155
154
|
}
|
|
156
155
|
export async function composeDispatchPrompt(io, input) {
|
|
157
|
-
const { projectRoot, role, options, isolationMode, leaseId, worktreePath, worktreeBranch, decision, asJson } = input;
|
|
156
|
+
const { projectRoot, sid, rid, role, options, isolationMode, leaseId, worktreePath, worktreeBranch, decision, asJson, rootCommand, prompt } = input;
|
|
158
157
|
const projectPrefs = loadProjectPreferences(projectRoot);
|
|
159
158
|
const ide = detectInstalledIde(projectRoot) ?? 'claude-code';
|
|
160
159
|
const adapter = getAdapter(ide);
|
|
@@ -164,8 +163,31 @@ export async function composeDispatchPrompt(io, input) {
|
|
|
164
163
|
const memoryAugmentedBody = await composeMemoryAugmentedBody(input, projectPrefs);
|
|
165
164
|
const isolationBlock = buildIsolationBlock(isolationMode, leaseId, worktreePath, worktreeBranch);
|
|
166
165
|
const { mustLsFilesVerification, mustLsFilesBlock } = buildMustLsFilesBlock(options, projectRoot);
|
|
167
|
-
|
|
166
|
+
// What the downstream gate will demand of this role, named in advance. `''`
|
|
167
|
+
// when this role has no gated artifacts under this type, so an unaffected
|
|
168
|
+
// role's prompt stays byte-identical. Injection is idempotent — a caller
|
|
169
|
+
// prompt that already carries a block keeps exactly one (see the helper).
|
|
170
|
+
const contractBlock = await readArtifactContractBlock({
|
|
171
|
+
projectRoot,
|
|
172
|
+
sessionId: sid,
|
|
173
|
+
requestId: rid,
|
|
174
|
+
role
|
|
175
|
+
});
|
|
176
|
+
// The presence test runs on the ASSEMBLED prompt, not on the caller's draft:
|
|
177
|
+
// this string is what the sub-agent receives as `toolCall.args.prompt` and
|
|
178
|
+
// what the dispatch record stores as `prompt`. A draft that merely names
|
|
179
|
+
// Karpathy (or carries a copy with a word wrong) does not count as carrying
|
|
180
|
+
// the canonical block, so the block is added rather than trusted.
|
|
181
|
+
const effectivePrompt = ensureKarpathyBlock(ensureArtifactContractBlock(`${memoryAugmentedBody}${isolationBlock}${mustLsFilesBlock}`, contractBlock));
|
|
182
|
+
// Findings travel as WARNINGS, never as a refusal, and they are read off the
|
|
183
|
+
// CALLER's prompt rather than the assembled one — both decisions are measured
|
|
184
|
+
// and recorded on `dispatch-cli-invocation-check.ts`.
|
|
185
|
+
const invocationWarnings = cliInvocationWarnings(prompt, rootCommand);
|
|
168
186
|
// + rerouted here, never refused — rationale on the helper itself.
|
|
169
|
-
const warnings = [
|
|
187
|
+
const warnings = [
|
|
188
|
+
...decision.warnings,
|
|
189
|
+
...deprecatedReviewerWarnings(role),
|
|
190
|
+
...invocationWarnings
|
|
191
|
+
];
|
|
170
192
|
return { adapter, effectivePrompt, warnings, mustLsFilesVerification };
|
|
171
193
|
}
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
*
|
|
7
7
|
* See `src/services/doc/doc-generator.ts` for the underlying logic.
|
|
8
8
|
*/
|
|
9
|
+
import { mkdirSync, writeFileSync } from 'node:fs';
|
|
9
10
|
import { resolve as resolvePath } from 'node:path';
|
|
10
11
|
import { findProjectRoot } from '../../services/config/config-safety.js';
|
|
11
12
|
import { generateSkillFromCommands, gitLogSince, renderSkillMarkdown, suggestChangelog } from '../../services/doc/doc-generator.js';
|
|
@@ -31,7 +32,6 @@ export function registerDocCommands(program, io) {
|
|
|
31
32
|
if (opts.output !== undefined) {
|
|
32
33
|
// Write to file
|
|
33
34
|
try {
|
|
34
|
-
const { writeFileSync, mkdirSync } = require('node:fs');
|
|
35
35
|
mkdirSync(resolvePath(opts.output, '..'), { recursive: true });
|
|
36
36
|
writeFileSync(resolvePath(opts.output), md, 'utf8');
|
|
37
37
|
printResult(io, ok('doc.generate-skill', {
|
|
@@ -18,7 +18,7 @@ export const CHECK_UNPROMOTED_DESCRIPTION = 'Scan `.peaks/memory/*.md` and list
|
|
|
18
18
|
export const NO_LAYER_NEXT_ACTIONS = [
|
|
19
19
|
'No --layer passed. Choose one of A / B / C and re-run.',
|
|
20
20
|
'A: append to sops/*.md (procedural rules)',
|
|
21
|
-
'B: append a matcher to .peaks/.claude-settings-template.json (tool-call interception)',
|
|
21
|
+
'B: append a matcher to .peaks/.claude-settings-template.json, or to .claude/settings.json for a hook that ships with this repo (tool-call interception)',
|
|
22
22
|
'C: extend HardFloorCategory in mode-gate.ts (always pauses regardless of mode)',
|
|
23
23
|
'Or pass --dry-run to preview all three stubs first.'
|
|
24
24
|
];
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { FinalReviewOutput } from '../../services/final-review/final-review-types.js';
|
|
2
|
+
import { type ProgramIO } from '../cli-helpers.js';
|
|
3
|
+
/** The two inputs a refusal envelope names, plus why it was refused. */
|
|
4
|
+
export type PrepareRefusal = {
|
|
5
|
+
readonly rid: string;
|
|
6
|
+
readonly code: string;
|
|
7
|
+
readonly message: string;
|
|
8
|
+
readonly sessionId: string;
|
|
9
|
+
readonly auditGoalPath: string;
|
|
10
|
+
readonly nextActions: string[];
|
|
11
|
+
};
|
|
12
|
+
/** Print one refusal envelope and mark the process failed. */
|
|
13
|
+
export declare function emitPrepareFailure(io: ProgramIO, json: boolean | undefined, refusal: PrepareRefusal, missingEnv?: readonly string[]): void;
|
|
14
|
+
/** Where a resolved run reads its audit goal from. */
|
|
15
|
+
export type PrepareGoalPath = {
|
|
16
|
+
readonly sessionId: string;
|
|
17
|
+
readonly auditGoalPath: string;
|
|
18
|
+
};
|
|
19
|
+
/**
|
|
20
|
+
* Stub path: surface a structured "scaffold ready" envelope.
|
|
21
|
+
*
|
|
22
|
+
* The service is NOT called here — the stub runner answers the audit-goal
|
|
23
|
+
* shape, not the 4-dim review shape, so running it through
|
|
24
|
+
* `prepareFinalReview()` would only manufacture a malformed review. The
|
|
25
|
+
* envelope confirms the route is wired end-to-end and reports the audit-goal
|
|
26
|
+
* path the service WOULD read.
|
|
27
|
+
*/
|
|
28
|
+
export declare function emitStubEnvelope(io: ProgramIO, rid: string, goal: PrepareGoalPath, json: boolean | undefined): void;
|
|
29
|
+
/** The success envelope of a real-provider run. */
|
|
30
|
+
export declare function emitReviewEnvelope(io: ProgramIO, result: {
|
|
31
|
+
readonly rid: string;
|
|
32
|
+
readonly goal: PrepareGoalPath;
|
|
33
|
+
readonly model: string;
|
|
34
|
+
readonly review: FinalReviewOutput;
|
|
35
|
+
readonly json: boolean | undefined;
|
|
36
|
+
}): void;
|
|
37
|
+
/**
|
|
38
|
+
* Map a thrown error to the CLI's error code. The LLM-layer errors already
|
|
39
|
+
* carry codes precise enough to act on (`LLM_CREDENTIAL_MISSING`,
|
|
40
|
+
* `LLM_REQUEST_FAILED`, …), so they are passed through rather than flattened
|
|
41
|
+
* into one opaque failure.
|
|
42
|
+
*/
|
|
43
|
+
export declare function finalReviewErrorCode(error: unknown): string;
|
|
44
|
+
export declare function finalReviewNextActions(code: string): string[];
|