orkeon-code 0.0.0-stage → 1.0.0-rc.2
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/.orkeon-runtime +10 -0
- package/.orkeon-version +1 -0
- package/LICENSE.md +21 -0
- package/NOTICE.md +17 -0
- package/README.fr.md +163 -0
- package/README.md +156 -2
- package/config/appsettings.anthropic.example.json +77 -0
- package/config/appsettings.example.json +71 -0
- package/config/appsettings.jev.example.json +131 -0
- package/config/appsettings.kev.example.json +133 -0
- package/config/appsettings.liquid.example.json +132 -0
- package/config/appsettings.ollama-whisper.example.json +93 -0
- package/config/appsettings.ollama.example.json +70 -0
- package/config/appsettings.whisper.example.json +32 -0
- package/mcp/whisper/README.md +294 -0
- package/mcp/whisper/pyproject.toml +32 -0
- package/mcp/whisper/uv.lock +1641 -0
- package/mcp/whisper/whisper_mcp.py +1053 -0
- package/orkeon-code +1092 -0
- package/orkeon-code.mjs +71 -0
- package/orkeon-code.ps1 +939 -0
- package/package.json +58 -4
- package/scripts/install.ps1 +156 -0
- package/scripts/install.sh +148 -0
- package/scripts/session-start.ork.ts +90 -0
- package/scripts/session-start.sh +74 -0
- package/scripts/setup-fixture.sh +88 -0
- package/src/commands/.orkeon/orkeon-cli.d.ts +559 -0
- package/src/commands/_lib/args.ts +194 -0
- package/src/commands/_lib/dev/dev-batches.ts +366 -0
- package/src/commands/_lib/dev/dev-implement.ts +185 -0
- package/src/commands/_lib/dev/dev-source.ts +61 -0
- package/src/commands/_lib/dev/dev.ts +341 -0
- package/src/commands/_lib/dev/markers.ts +7 -0
- package/src/commands/_lib/dev/messages.ts +112 -0
- package/src/commands/_lib/dev-step.ts +145 -0
- package/src/commands/_lib/dispatch.ts +254 -0
- package/src/commands/_lib/effort.ts +15 -0
- package/src/commands/_lib/git/branch.ts +94 -0
- package/src/commands/_lib/git/commit.ts +90 -0
- package/src/commands/_lib/git/diff.ts +107 -0
- package/src/commands/_lib/git/messages.ts +54 -0
- package/src/commands/_lib/git/review.ts +108 -0
- package/src/commands/_lib/memory/memory-admit.ts +148 -0
- package/src/commands/_lib/memory/memory.ts +52 -0
- package/src/commands/_lib/memory/messages.ts +32 -0
- package/src/commands/_lib/messages.ts +48 -0
- package/src/commands/_lib/pr-context.ts +32 -0
- package/src/commands/_lib/project/analyze.ts +24 -0
- package/src/commands/_lib/project/messages.ts +8 -0
- package/src/commands/_lib/session/export.ts +105 -0
- package/src/commands/_lib/session/messages.ts +87 -0
- package/src/commands/_lib/session/prompts.ts +4 -0
- package/src/commands/_lib/session/resume.ts +151 -0
- package/src/commands/_lib/session/tasks.ts +181 -0
- package/src/commands/_lib/settings/advisor.ts +75 -0
- package/src/commands/_lib/settings/agents.ts +137 -0
- package/src/commands/_lib/settings/choices.ts +8 -0
- package/src/commands/_lib/settings/config.ts +141 -0
- package/src/commands/_lib/settings/effort.ts +147 -0
- package/src/commands/_lib/settings/hooks.ts +50 -0
- package/src/commands/_lib/settings/messages.ts +408 -0
- package/src/commands/_lib/settings/mode.ts +100 -0
- package/src/commands/_lib/settings/model.ts +181 -0
- package/src/commands/_lib/settings/output-style.ts +39 -0
- package/src/commands/_lib/settings/permissions.ts +287 -0
- package/src/commands/_lib/settings/route.ts +63 -0
- package/src/commands/_lib/settings/session-config.ts +49 -0
- package/src/commands/_lib/settings/skills.ts +93 -0
- package/src/commands/_lib/settings/theme.ts +42 -0
- package/src/commands/_lib/speech/messages.ts +58 -0
- package/src/commands/_lib/speech/prompts.ts +4 -0
- package/src/commands/_lib/speech/say.ts +95 -0
- package/src/commands/_lib/speech/transcribe.ts +121 -0
- package/src/commands/_lib/speech/voice.ts +142 -0
- package/src/commands/_lib/status/cache.ts +31 -0
- package/src/commands/_lib/status/context.ts +57 -0
- package/src/commands/_lib/status/doctor.ts +205 -0
- package/src/commands/_lib/status/messages.ts +100 -0
- package/src/commands/_lib/status/meta.ts +24 -0
- package/src/commands/_lib/status/status.ts +128 -0
- package/src/commands/_lib/status/usage-tools.ts +48 -0
- package/src/commands/_lib/status/usage.ts +128 -0
- package/src/commands/_lib/view.ts +34 -0
- package/src/commands/dev/dev-batches.cmd.ts +109 -0
- package/src/commands/dev/dev-learn.cmd.ts +29 -0
- package/src/commands/dev/dev-plan.cmd.ts +51 -0
- package/src/commands/dev/dev-spec.cmd.ts +54 -0
- package/src/commands/dev/dev-status.cmd.ts +16 -0
- package/src/commands/git/branch.cmd.ts +27 -0
- package/src/commands/git/commit.cmd.ts +48 -0
- package/src/commands/git/diff.cmd.ts +26 -0
- package/src/commands/git/review.cmd.ts +36 -0
- package/src/commands/memory/memory.cmd.ts +48 -0
- package/src/commands/project/analyze.cmd.ts +32 -0
- package/src/commands/project/debug-tool-call.cmd.ts +62 -0
- package/src/commands/project/files.cmd.ts +22 -0
- package/src/commands/project/init-verifiers.cmd.ts +14 -0
- package/src/commands/project/init.cmd.ts +14 -0
- package/src/commands/project/verify.cmd.ts +27 -0
- package/src/commands/session/assistant.cmd.ts +40 -0
- package/src/commands/session/btw.cmd.ts +18 -0
- package/src/commands/session/clear.cmd.ts +19 -0
- package/src/commands/session/compact.cmd.ts +16 -0
- package/src/commands/session/copy.cmd.ts +45 -0
- package/src/commands/session/exit.cmd.ts +9 -0
- package/src/commands/session/export.cmd.ts +28 -0
- package/src/commands/session/rename.cmd.ts +18 -0
- package/src/commands/session/resume.cmd.ts +19 -0
- package/src/commands/session/rewind.cmd.ts +25 -0
- package/src/commands/session/summary.cmd.ts +27 -0
- package/src/commands/session/tasks.cmd.ts +46 -0
- package/src/commands/settings/advisor.cmd.ts +38 -0
- package/src/commands/settings/agents.cmd.ts +19 -0
- package/src/commands/settings/config.cmd.ts +19 -0
- package/src/commands/settings/effort.cmd.ts +19 -0
- package/src/commands/settings/fast.cmd.ts +18 -0
- package/src/commands/settings/hooks.cmd.ts +17 -0
- package/src/commands/settings/mode.cmd.ts +20 -0
- package/src/commands/settings/model.cmd.ts +21 -0
- package/src/commands/settings/output-style.cmd.ts +19 -0
- package/src/commands/settings/permissions.cmd.ts +25 -0
- package/src/commands/settings/proactive.cmd.ts +16 -0
- package/src/commands/settings/route.cmd.ts +16 -0
- package/src/commands/settings/skills.cmd.ts +17 -0
- package/src/commands/settings/theme.cmd.ts +14 -0
- package/src/commands/speech/say.cmd.ts +24 -0
- package/src/commands/speech/transcribe.cmd.ts +29 -0
- package/src/commands/speech/voice.cmd.ts +30 -0
- package/src/commands/status/context.cmd.ts +18 -0
- package/src/commands/status/doctor.cmd.ts +27 -0
- package/src/commands/status/release-notes.cmd.ts +9 -0
- package/src/commands/status/status.cmd.ts +25 -0
- package/src/commands/status/usage.cmd.ts +21 -0
- package/src/crews/.orkeon/orkeon.d.ts +4391 -0
- package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
- package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +188 -0
- package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
- package/src/crews/_probe-shared-memory/probe.ork.ts +100 -0
- package/src/crews/advisor/application/messages.ts +4 -0
- package/src/crews/advisor/application/prompts.ts +4 -0
- package/src/crews/advisor/application/run-advisor.ts +41 -0
- package/src/crews/advisor/crew.ork.ts +44 -0
- package/src/crews/advisor/domain/advice.ts +119 -0
- package/src/crews/advisor/domain/messages.ts +8 -0
- package/src/crews/advisor/domain/prompts.ts +26 -0
- package/src/crews/agent-run/application/messages.ts +18 -0
- package/src/crews/agent-run/application/run-agent-run.ts +43 -0
- package/src/crews/agent-run/crew.ork.ts +67 -0
- package/src/crews/analyze/application/messages.ts +27 -0
- package/src/crews/analyze/application/prompts.ts +4 -0
- package/src/crews/analyze/application/run-analyze.ts +120 -0
- package/src/crews/analyze/crew.ork.ts +41 -0
- package/src/crews/analyze/domain/harvest.ts +269 -0
- package/src/crews/analyze/domain/prompts.ts +86 -0
- package/src/crews/code-review/application/lens-material.ts +24 -0
- package/src/crews/code-review/application/messages.ts +17 -0
- package/src/crews/code-review/application/prompts.ts +126 -0
- package/src/crews/code-review/application/review.ts +74 -0
- package/src/crews/code-review/application/run-code-review.ts +121 -0
- package/src/crews/code-review/crew.ork.ts +52 -0
- package/src/crews/code-review/domain/lenses.ts +154 -0
- package/src/crews/code-review/domain/messages.ts +25 -0
- package/src/crews/code-review/domain/prompts.ts +58 -0
- package/src/crews/code-review/domain/report.ts +58 -0
- package/src/crews/code-review/domain/scope.ts +106 -0
- package/src/crews/dev-batches/application/messages.ts +127 -0
- package/src/crews/dev-batches/application/plan-close.ts +181 -0
- package/src/crews/dev-batches/application/prompts.ts +10 -0
- package/src/crews/dev-batches/application/run-dev-batches.ts +676 -0
- package/src/crews/dev-batches/application/run-wave.ts +452 -0
- package/src/crews/dev-batches/application/seed-harvest.ts +163 -0
- package/src/crews/dev-batches/crew.ork.ts +146 -0
- package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
- package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
- package/src/crews/dev-batches/domain/batches-log.ts +52 -0
- package/src/crews/dev-batches/domain/markers.ts +5 -0
- package/src/crews/dev-batches/domain/messages.ts +6 -0
- package/src/crews/dev-batches/domain/wave-order.ts +44 -0
- package/src/crews/dev-change/application/change-material.ts +44 -0
- package/src/crews/dev-change/application/evidence.ts +172 -0
- package/src/crews/dev-change/application/messages.ts +81 -0
- package/src/crews/dev-change/application/prompts.ts +101 -0
- package/src/crews/dev-change/application/run-dev-change.ts +324 -0
- package/src/crews/dev-change/crew.ork.ts +114 -0
- package/src/crews/dev-change/domain/change-answer.ts +163 -0
- package/src/crews/dev-change/domain/change-render.ts +77 -0
- package/src/crews/dev-change/domain/markers.ts +28 -0
- package/src/crews/dev-change/domain/messages.ts +16 -0
- package/src/crews/dev-implement/application/close.ts +186 -0
- package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
- package/src/crews/dev-implement/application/locate-sheet.ts +82 -0
- package/src/crews/dev-implement/application/messages.ts +161 -0
- package/src/crews/dev-implement/application/observe.ts +52 -0
- package/src/crews/dev-implement/application/prompts.ts +9 -0
- package/src/crews/dev-implement/application/report-writes.ts +46 -0
- package/src/crews/dev-implement/application/run-dev-implement.ts +822 -0
- package/src/crews/dev-implement/application/run-role.ts +27 -0
- package/src/crews/dev-implement/application/suite-job.ts +122 -0
- package/src/crews/dev-implement/application/touched.ts +74 -0
- package/src/crews/dev-implement/crew.ork.ts +69 -0
- package/src/crews/dev-implement/domain/contracts.ts +255 -0
- package/src/crews/dev-implement/domain/correction.ts +103 -0
- package/src/crews/dev-implement/domain/cycles.ts +36 -0
- package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
- package/src/crews/dev-implement/domain/markers.ts +23 -0
- package/src/crews/dev-implement/domain/messages.ts +58 -0
- package/src/crews/dev-implement/domain/prompts.ts +93 -0
- package/src/crews/dev-implement/domain/roles.ts +49 -0
- package/src/crews/dev-implement/domain/sheet-edits.ts +76 -0
- package/src/crews/dev-implement/domain/sheet-ticks.ts +23 -0
- package/src/crews/dev-implement/domain/step-checks.ts +137 -0
- package/src/crews/dev-implement/domain/step-section.ts +129 -0
- package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
- package/src/crews/dev-learn/application/learn-prompt-fit.ts +63 -0
- package/src/crews/dev-learn/application/messages.ts +51 -0
- package/src/crews/dev-learn/application/prompts.ts +99 -0
- package/src/crews/dev-learn/application/run-dev-learn.ts +558 -0
- package/src/crews/dev-learn/crew.ork.ts +53 -0
- package/src/crews/dev-learn/domain/learn-answer.ts +233 -0
- package/src/crews/dev-learn/domain/messages.ts +65 -0
- package/src/crews/dev-learn/domain/owner-lines.ts +89 -0
- package/src/crews/dev-learn/domain/proposals-render.ts +95 -0
- package/src/crews/dev-plan/application/anchor-paths.ts +113 -0
- package/src/crews/dev-plan/application/inventory.ts +174 -0
- package/src/crews/dev-plan/application/messages.ts +88 -0
- package/src/crews/dev-plan/application/plan-prompt-fit.ts +44 -0
- package/src/crews/dev-plan/application/prompts.ts +141 -0
- package/src/crews/dev-plan/application/run-dev-plan.ts +483 -0
- package/src/crews/dev-plan/crew.ork.ts +112 -0
- package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
- package/src/crews/dev-plan/domain/markers.ts +18 -0
- package/src/crews/dev-plan/domain/messages.ts +118 -0
- package/src/crews/dev-plan/domain/plan-answer.ts +753 -0
- package/src/crews/dev-plan/domain/plan-render.ts +306 -0
- package/src/crews/dev-plan/domain/prompts.ts +44 -0
- package/src/crews/dev-spec/application/messages.ts +30 -0
- package/src/crews/dev-spec/application/prompts.ts +93 -0
- package/src/crews/dev-spec/application/run-dev-spec.ts +237 -0
- package/src/crews/dev-spec/application/spec-material.ts +42 -0
- package/src/crews/dev-spec/crew.ork.ts +110 -0
- package/src/crews/dev-spec/domain/markers.ts +30 -0
- package/src/crews/dev-spec/domain/messages.ts +39 -0
- package/src/crews/dev-spec/domain/spec-answer.ts +252 -0
- package/src/crews/dev-spec/domain/spec-render.ts +76 -0
- package/src/crews/dev-verify/application/audit-brief.ts +187 -0
- package/src/crews/dev-verify/application/audit.ts +267 -0
- package/src/crews/dev-verify/application/capture.ts +311 -0
- package/src/crews/dev-verify/application/messages.ts +119 -0
- package/src/crews/dev-verify/application/prompts.ts +209 -0
- package/src/crews/dev-verify/application/run-dev-verify.ts +423 -0
- package/src/crews/dev-verify/application/run-gate.ts +204 -0
- package/src/crews/dev-verify/crew.ork.ts +103 -0
- package/src/crews/dev-verify/domain/audit-answer.ts +154 -0
- package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
- package/src/crews/dev-verify/domain/capture-sections.ts +138 -0
- package/src/crews/dev-verify/domain/commands.ts +103 -0
- package/src/crews/dev-verify/domain/gate.ts +131 -0
- package/src/crews/dev-verify/domain/markers.ts +16 -0
- package/src/crews/dev-verify/domain/mechanical-table.ts +156 -0
- package/src/crews/dev-verify/domain/messages.ts +92 -0
- package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
- package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
- package/src/crews/dev-verify/domain/text.ts +20 -0
- package/src/crews/dev-verify/domain/verdict.ts +127 -0
- package/src/crews/git-commit/application/draft.ts +133 -0
- package/src/crews/git-commit/application/messages.ts +15 -0
- package/src/crews/git-commit/application/prompts.ts +47 -0
- package/src/crews/git-commit/application/run-git-commit.ts +117 -0
- package/src/crews/git-commit/crew.ork.ts +53 -0
- package/src/crews/git-commit/domain/commit.ts +200 -0
- package/src/crews/git-commit/domain/markers.ts +4 -0
- package/src/crews/git-commit/domain/messages.ts +48 -0
- package/src/crews/init-verifiers/application/authoring.ts +90 -0
- package/src/crews/init-verifiers/application/messages.ts +13 -0
- package/src/crews/init-verifiers/application/prompts.ts +107 -0
- package/src/crews/init-verifiers/application/run-init-verifiers.ts +26 -0
- package/src/crews/init-verifiers/crew.ork.ts +35 -0
- package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
- package/src/crews/init-verifiers/domain/readiness.ts +23 -0
- package/src/crews/main-loop/application/auto-compact.ts +78 -0
- package/src/crews/main-loop/application/context-gather.ts +133 -0
- package/src/crews/main-loop/application/messages.ts +81 -0
- package/src/crews/main-loop/application/prompts.ts +12 -0
- package/src/crews/main-loop/application/run-main-loop.ts +383 -0
- package/src/crews/main-loop/application/turn-context.ts +111 -0
- package/src/crews/main-loop/crew.ork.ts +124 -0
- package/src/crews/main-loop/domain/autocompact.ts +27 -0
- package/src/crews/main-loop/domain/prompt-assembly.ts +338 -0
- package/src/crews/main-loop/domain/prompts.ts +336 -0
- package/src/crews/main-loop/domain/turn-chains.ts +130 -0
- package/src/crews/project-init/application/detect.ts +123 -0
- package/src/crews/project-init/application/messages.ts +15 -0
- package/src/crews/project-init/application/prompts.ts +105 -0
- package/src/crews/project-init/application/run-project-init.ts +31 -0
- package/src/crews/project-init/crew.ork.ts +36 -0
- package/src/crews/project-init/domain/conventions.ts +36 -0
- package/src/crews/project-init/domain/existing-files.ts +65 -0
- package/src/crews/project-init/domain/messages.ts +13 -0
- package/src/crews/project-init/domain/package-map.ts +73 -0
- package/src/crews/project-init/domain/prompts.ts +10 -0
- package/src/crews/session-compact/application/prompts.ts +5 -0
- package/src/crews/session-compact/crew.ork.ts +56 -0
- package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
- package/src/crews/shared-memory-admit/crew.ork.ts +49 -0
- package/src/crews/speech/application/messages.ts +3 -0
- package/src/crews/speech/application/prompts.ts +3 -0
- package/src/crews/speech/application/run-speech.ts +26 -0
- package/src/crews/speech/crew.ork.ts +38 -0
- package/src/shared/application/agents/child-agent.ts +259 -0
- package/src/shared/application/agents/messages.ts +35 -0
- package/src/shared/application/agents/route-agent.ts +115 -0
- package/src/shared/application/agents/run-sub-agent.ts +119 -0
- package/src/shared/application/answer-language.ts +14 -0
- package/src/shared/application/attached-skills.ts +36 -0
- package/src/shared/application/compaction/compact-session.ts +242 -0
- package/src/shared/application/compaction/extract-memories.ts +38 -0
- package/src/shared/application/compaction/messages.ts +20 -0
- package/src/shared/application/compaction/prune-context.ts +94 -0
- package/src/shared/application/compaction/pruned-llm.ts +35 -0
- package/src/shared/application/compaction/restore-context.ts +78 -0
- package/src/shared/application/config-store.ts +123 -0
- package/src/shared/application/dev/brief-inventory.ts +115 -0
- package/src/shared/application/dev/close-batch.ts +85 -0
- package/src/shared/application/dev/find-repo-pack.ts +78 -0
- package/src/shared/application/dev/learn-decision.ts +254 -0
- package/src/shared/application/dev/load-dev-context.ts +265 -0
- package/src/shared/application/dev/measure-access-cost.ts +69 -0
- package/src/shared/application/dev/messages.ts +132 -0
- package/src/shared/application/dev/phase-timer.ts +54 -0
- package/src/shared/application/dev/plan-source.ts +116 -0
- package/src/shared/application/dev/preflight.ts +71 -0
- package/src/shared/application/dev/project-files.ts +17 -0
- package/src/shared/application/dev/prompts.ts +34 -0
- package/src/shared/application/dev/question-round.ts +60 -0
- package/src/shared/application/dev/resolve-work-folder.ts +134 -0
- package/src/shared/application/dev/script-tool-slot.ts +27 -0
- package/src/shared/application/dev/settle-questions.ts +57 -0
- package/src/shared/application/dev/source-review.ts +67 -0
- package/src/shared/application/dev/source-step.ts +152 -0
- package/src/shared/application/dev/spend.ts +55 -0
- package/src/shared/application/dev/step-precedents.ts +90 -0
- package/src/shared/application/dev/tool-call-policy.ts +87 -0
- package/src/shared/application/dev/tool-callbacks.ts +262 -0
- package/src/shared/application/dev/tool-trace-recorder.ts +46 -0
- package/src/shared/application/dev/verdict-sources.ts +50 -0
- package/src/shared/application/dev/wrapped-tools.ts +147 -0
- package/src/shared/application/extra-tools.ts +71 -0
- package/src/shared/application/git/batch-worktree.ts +102 -0
- package/src/shared/application/git/commit-files.ts +191 -0
- package/src/shared/application/git/merge-batch.ts +67 -0
- package/src/shared/application/git/messages.ts +75 -0
- package/src/shared/application/git/open-pull-request.ts +52 -0
- package/src/shared/application/host-context.ts +59 -0
- package/src/shared/application/host-layout-store.ts +45 -0
- package/src/shared/application/instructions-file.ts +19 -0
- package/src/shared/application/json-file.ts +34 -0
- package/src/shared/application/llm-profile.ts +36 -0
- package/src/shared/application/messages.ts +14 -0
- package/src/shared/application/permission-rules.ts +169 -0
- package/src/shared/application/ports/approvals.ts +20 -0
- package/src/shared/application/ports/clock.ts +5 -0
- package/src/shared/application/ports/code-index.ts +93 -0
- package/src/shared/application/ports/crew.ts +60 -0
- package/src/shared/application/ports/decision.ts +14 -0
- package/src/shared/application/ports/files.ts +21 -0
- package/src/shared/application/ports/human.ts +38 -0
- package/src/shared/application/ports/llm.ts +83 -0
- package/src/shared/application/ports/memory.ts +30 -0
- package/src/shared/application/ports/progress.ts +23 -0
- package/src/shared/application/ports/runtime.ts +15 -0
- package/src/shared/application/ports/session.ts +74 -0
- package/src/shared/application/ports/shared-memory.ts +26 -0
- package/src/shared/application/ports/shell.ts +40 -0
- package/src/shared/application/ports/telemetry.ts +45 -0
- package/src/shared/application/ports/theme.ts +11 -0
- package/src/shared/application/ports/tools.ts +46 -0
- package/src/shared/application/ports/usage.ts +45 -0
- package/src/shared/application/ports.ts +29 -0
- package/src/shared/application/project-manifests.ts +106 -0
- package/src/shared/application/session-io.ts +85 -0
- package/src/shared/application/session-state.ts +36 -0
- package/src/shared/application/shared-memory/admit-entries.ts +179 -0
- package/src/shared/application/shared-memory/harvest-after-gaps.ts +69 -0
- package/src/shared/application/shared-memory/harvest-mistakes.ts +45 -0
- package/src/shared/application/shared-memory/import-agent-memory.ts +119 -0
- package/src/shared/application/shared-memory/memory-files.ts +111 -0
- package/src/shared/application/shared-memory/memory-settings.ts +94 -0
- package/src/shared/application/shared-memory/messages.ts +63 -0
- package/src/shared/application/shared-memory/push-candidate.ts +149 -0
- package/src/shared/application/shared-memory/recall-precedents.ts +70 -0
- package/src/shared/application/skills/messages.ts +4 -0
- package/src/shared/application/skills/suggest-skills.ts +102 -0
- package/src/shared/application/state-snapshot.ts +38 -0
- package/src/shared/application/workflow/messages.ts +8 -0
- package/src/shared/application/workflow/workflow-state.ts +136 -0
- package/src/shared/domain/agent-policy/behavior-flags.ts +162 -0
- package/src/shared/domain/agent-policy/extra-tools.ts +67 -0
- package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
- package/src/shared/domain/agent-policy/messages.ts +66 -0
- package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
- package/src/shared/domain/agent-policy/output-styles.ts +11 -0
- package/src/shared/domain/agent-policy/path-rules.ts +299 -0
- package/src/shared/domain/agent-policy/permission.ts +625 -0
- package/src/shared/domain/agent-policy/prompts.ts +17 -0
- package/src/shared/domain/agent-policy/reasoning.ts +59 -0
- package/src/shared/domain/agent-policy/rule-sets.ts +416 -0
- package/src/shared/domain/agent-policy/tool-access.ts +91 -0
- package/src/shared/domain/agent-registry.ts +143 -0
- package/src/shared/domain/agents/built-in-charters.ts +43 -0
- package/src/shared/domain/agents/chain.ts +30 -0
- package/src/shared/domain/agents/charter.ts +64 -0
- package/src/shared/domain/agents/exclusive.ts +25 -0
- package/src/shared/domain/agents/instances.ts +252 -0
- package/src/shared/domain/agents/messages.ts +39 -0
- package/src/shared/domain/agents/model-route.ts +199 -0
- package/src/shared/domain/agents/prompts.ts +20 -0
- package/src/shared/domain/code-intel-contract.ts +357 -0
- package/src/shared/domain/code-intel-routing.ts +60 -0
- package/src/shared/domain/compact-outcome.ts +46 -0
- package/src/shared/domain/compaction-thresholds.ts +162 -0
- package/src/shared/domain/compaction.ts +288 -0
- package/src/shared/domain/config-schema.ts +434 -0
- package/src/shared/domain/context-prune.ts +176 -0
- package/src/shared/domain/decision/questions.ts +102 -0
- package/src/shared/domain/dev/access-cost.ts +230 -0
- package/src/shared/domain/dev/artefacts.ts +50 -0
- package/src/shared/domain/dev/batches-concurrency.ts +35 -0
- package/src/shared/domain/dev/batches-state.ts +49 -0
- package/src/shared/domain/dev/build-commands.ts +45 -0
- package/src/shared/domain/dev/call-guard.ts +342 -0
- package/src/shared/domain/dev/carried-text.ts +47 -0
- package/src/shared/domain/dev/design-rules.ts +100 -0
- package/src/shared/domain/dev/learn-proposals.ts +176 -0
- package/src/shared/domain/dev/learn-state.ts +94 -0
- package/src/shared/domain/dev/markers.ts +107 -0
- package/src/shared/domain/dev/messages.ts +259 -0
- package/src/shared/domain/dev/path-args.ts +42 -0
- package/src/shared/domain/dev/path-rebase.ts +93 -0
- package/src/shared/domain/dev/phase-timing.ts +50 -0
- package/src/shared/domain/dev/plan-checks.ts +191 -0
- package/src/shared/domain/dev/plan-format.ts +170 -0
- package/src/shared/domain/dev/project-files.ts +29 -0
- package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
- package/src/shared/domain/dev/prompts.ts +251 -0
- package/src/shared/domain/dev/questions.ts +267 -0
- package/src/shared/domain/dev/reading-rule.ts +41 -0
- package/src/shared/domain/dev/repo-pack.ts +240 -0
- package/src/shared/domain/dev/review-answer.ts +173 -0
- package/src/shared/domain/dev/review-brief.ts +54 -0
- package/src/shared/domain/dev/reviewer-charter.ts +35 -0
- package/src/shared/domain/dev/sheet-facts.ts +81 -0
- package/src/shared/domain/dev/spec-format.ts +182 -0
- package/src/shared/domain/dev/step-budget.ts +74 -0
- package/src/shared/domain/dev/step-rules.ts +109 -0
- package/src/shared/domain/dev/test-commands.ts +94 -0
- package/src/shared/domain/dev/test-output.ts +33 -0
- package/src/shared/domain/dev/test-paths.ts +40 -0
- package/src/shared/domain/dev/tool-guards.ts +65 -0
- package/src/shared/domain/dev/trait-pattern.ts +87 -0
- package/src/shared/domain/dev/verdict-format.ts +162 -0
- package/src/shared/domain/dev/whitespace.ts +35 -0
- package/src/shared/domain/dev/work-folder.ts +68 -0
- package/src/shared/domain/dev/yaml-subset.ts +385 -0
- package/src/shared/domain/error-text.ts +13 -0
- package/src/shared/domain/git/close.ts +274 -0
- package/src/shared/domain/git/messages.ts +20 -0
- package/src/shared/domain/git/pull-request.ts +96 -0
- package/src/shared/domain/git/worktree.ts +46 -0
- package/src/shared/domain/host-layout.ts +147 -0
- package/src/shared/domain/host-paths.ts +399 -0
- package/src/shared/domain/index-languages.ts +16 -0
- package/src/shared/domain/instructions-file.ts +18 -0
- package/src/shared/domain/iso-day.ts +4 -0
- package/src/shared/domain/llm-failure.ts +134 -0
- package/src/shared/domain/llm-profile.ts +44 -0
- package/src/shared/domain/marked-message.ts +29 -0
- package/src/shared/domain/markers.ts +30 -0
- package/src/shared/domain/messages.ts +291 -0
- package/src/shared/domain/model-catalog.ts +79 -0
- package/src/shared/domain/permission-modes.ts +99 -0
- package/src/shared/domain/prelude.ts +92 -0
- package/src/shared/domain/project-manifests.ts +84 -0
- package/src/shared/domain/prompts.ts +233 -0
- package/src/shared/domain/search-routing.ts +77 -0
- package/src/shared/domain/secret-patterns.ts +46 -0
- package/src/shared/domain/session-keys.ts +92 -0
- package/src/shared/domain/session-start.ts +61 -0
- package/src/shared/domain/severity.ts +72 -0
- package/src/shared/domain/sha1.ts +61 -0
- package/src/shared/domain/shared-memory/agent-memory-import.ts +145 -0
- package/src/shared/domain/shared-memory/candidates.ts +40 -0
- package/src/shared/domain/shared-memory/entry.ts +151 -0
- package/src/shared/domain/shared-memory/front-matter.ts +187 -0
- package/src/shared/domain/shared-memory/gate.ts +45 -0
- package/src/shared/domain/shared-memory/harvest.ts +64 -0
- package/src/shared/domain/shared-memory/layout.ts +190 -0
- package/src/shared/domain/shared-memory/markers.ts +9 -0
- package/src/shared/domain/shared-memory/messages.ts +66 -0
- package/src/shared/domain/shared-memory/precedents-block.ts +82 -0
- package/src/shared/domain/shared-memory/prompts.ts +28 -0
- package/src/shared/domain/shared-memory/refused.ts +84 -0
- package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
- package/src/shared/domain/skills/prompts.ts +4 -0
- package/src/shared/domain/skills/shortlist.ts +149 -0
- package/src/shared/domain/snip-turns.ts +33 -0
- package/src/shared/domain/speech.ts +21 -0
- package/src/shared/domain/strip.ts +88 -0
- package/src/shared/domain/tool-trace.ts +120 -0
- package/src/shared/domain/types.ts +67 -0
- package/src/shared/domain/verifiers.ts +33 -0
- package/src/shared/domain/vfs.ts +16 -0
- package/src/shared/domain/workflow/prompts.ts +15 -0
- package/src/shared/domain/workflow/state-file.ts +142 -0
- package/src/shared/infrastructure/globals.ts +57 -0
- package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
- package/src/shared/infrastructure/orkeon/child-agents.ts +122 -0
- package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
- package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
- package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
- package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
- package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
- package/src/shared/infrastructure/orkeon/dev-deps.ts +179 -0
- package/src/shared/infrastructure/orkeon/files.ts +58 -0
- package/src/shared/infrastructure/orkeon/github-pull-requests.ts +30 -0
- package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
- package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
- package/src/shared/infrastructure/orkeon/human-input.ts +55 -0
- package/src/shared/infrastructure/orkeon/llm-profile.ts +58 -0
- package/src/shared/infrastructure/orkeon/llm.ts +164 -0
- package/src/shared/infrastructure/orkeon/markers.ts +6 -0
- package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
- package/src/shared/infrastructure/orkeon/memory-tools.ts +129 -0
- package/src/shared/infrastructure/orkeon/messages.ts +15 -0
- package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
- package/src/shared/infrastructure/orkeon/progress.ts +24 -0
- package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
- package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
- package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
- package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
- package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
- package/src/shared/infrastructure/orkeon/script-tools.ts +129 -0
- package/src/shared/infrastructure/orkeon/session-store.ts +94 -0
- package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
- package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
- package/src/shared/infrastructure/orkeon/shell-jobs.ts +81 -0
- package/src/shared/infrastructure/orkeon/shell.ts +39 -0
- package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
- package/src/shared/infrastructure/orkeon/tool-catalogue.ts +76 -0
- package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
- package/src/shared/infrastructure/orkeon/usage.ts +74 -0
- package/src/shared/infrastructure/orkeon/wiring.ts +174 -0
|
@@ -0,0 +1,483 @@
|
|
|
1
|
+
// /dev-plan's use case: checks the inputs and the checkout, resolves the spec or change
|
|
2
|
+
// brief and stops on a Blocking open question before anything else is read, refuses to
|
|
3
|
+
// write over a plan unless asked and never over one whose work has started, inventories
|
|
4
|
+
// the code by the index, asks the model for the plan as JSON (once more on a refused
|
|
5
|
+
// answer), renders and self-checks the plan and its sheets, writes them with plan.json,
|
|
6
|
+
// then has the read-only reviewer question the plan once and writes its rows into the
|
|
7
|
+
// files. The model writes no file; nothing is written outside the code's folder, and
|
|
8
|
+
// nothing under .claude/.
|
|
9
|
+
import type { AnchorIndex, CodeIndex, Files, Llm, Logger, Shell } from "../../../shared/application/ports.ts";
|
|
10
|
+
import type { ActRoute } from "../../../shared/application/agents/route-agent.ts";
|
|
11
|
+
import type { ConfigStore } from "../../../shared/application/config-store.ts";
|
|
12
|
+
import { loadDevContext } from "../../../shared/application/dev/load-dev-context.ts";
|
|
13
|
+
import { GIT_TOPLEVEL } from "../../../shared/application/dev/resolve-work-folder.ts";
|
|
14
|
+
import { readPlanSource, resolvePlanSource } from "../../../shared/application/dev/plan-source.ts";
|
|
15
|
+
import type { ResolvedSource } from "../../../shared/application/dev/plan-source.ts";
|
|
16
|
+
import { runSubAgent } from "../../../shared/application/agents/run-sub-agent.ts";
|
|
17
|
+
import { PhaseTimer } from "../../../shared/application/dev/phase-timer.ts";
|
|
18
|
+
import { classifyArtefact, compareBatchIds } from "../../../shared/domain/dev/artefacts.ts";
|
|
19
|
+
import { blockingStop } from "../../../shared/domain/dev/spec-format.ts";
|
|
20
|
+
import type { PlanSource } from "../../../shared/domain/dev/spec-format.ts";
|
|
21
|
+
import { parseBatchSheet, parseGlobalPlan } from "../../../shared/domain/dev/plan-format.ts";
|
|
22
|
+
import { planSelfCheck } from "../../../shared/domain/dev/plan-checks.ts";
|
|
23
|
+
import { REVIEWER_CHARTER } from "../../../shared/domain/dev/reviewer-charter.ts";
|
|
24
|
+
import { REVIEW_ANSWER_SCHEMA, reviewChecks } from "../../../shared/domain/dev/review-answer.ts";
|
|
25
|
+
import type { ReviewAnswer } from "../../../shared/domain/dev/review-answer.ts";
|
|
26
|
+
import { reviewSystem } from "../../../shared/domain/dev/prompts.ts";
|
|
27
|
+
import { buildReviewAnswerPrompt, buildReviewBrief } from "../../../shared/domain/dev/review-brief.ts";
|
|
28
|
+
import { PLAN_ANSWER_SCHEMA, checkPlanAnswer } from "../domain/plan-answer.ts";
|
|
29
|
+
import type { PlanAnswer, PlanCheckContext } from "../domain/plan-answer.ts";
|
|
30
|
+
import { INVENTORY_CAPS, renderInventory } from "../domain/inventory-model.ts";
|
|
31
|
+
import type { Inventory } from "../domain/inventory-model.ts";
|
|
32
|
+
import { renderPlan, repoLines } from "../domain/plan-render.ts";
|
|
33
|
+
import type { RenderInput, RenderedPlan } from "../domain/plan-render.ts";
|
|
34
|
+
import { MAX_PLAN_PROMPT_CHARS, SOURCE_CHARS, buildPlanPrompt } from "./plan-prompt-fit.ts";
|
|
35
|
+
import type { PlanPromptInput } from "./plan-prompt-fit.ts";
|
|
36
|
+
import { buildInventory } from "./inventory.ts";
|
|
37
|
+
import { noPrecedents, precedentsLine, recallQuery } from "../../../shared/application/dev/step-precedents.ts";
|
|
38
|
+
import type { StepPrecedents } from "../../../shared/application/dev/step-precedents.ts";
|
|
39
|
+
import { checkAnchorPaths, repairAnchorKinds } from "./anchor-paths.ts";
|
|
40
|
+
import type { AnchorListings } from "./anchor-paths.ts";
|
|
41
|
+
import { BAD_INPUT_REPLACE, BAD_INPUT_SOURCE, BOTH_LINES, COMMANDS_LINE, END_LINE, REFUSED_TWICE, REVIEWED_FAILS_SELF_CHECK, ROWS_NOT_WRITTEN, SETTLE_CHANGE, SETTLE_SPEC, answerThenReplan, batchIsDone, planCannotBeReadNothingReplaced, planFileNotWritten, everyBatch, fewerBatches, inventoryFromTitles, namesNoTraceableId, noRoomForInventory, notInPack, planBlocked, planExists, planWritten, recordsWorkDone, planRendererDefect, reviewHead, reviewNotRunWithCause, planRunFromCheckout, stepIsTicked, tddLineTicked, planTitleNamesNoKind, titleReadsDone, unreviewed } from "./messages.ts";
|
|
42
|
+
import { PERMISSION_GATE_OFF as GATE_OFF } from "../../../shared/application/dev/messages.ts";
|
|
43
|
+
import { answerAskedAgain, answerDidNotParse } from "../../../shared/application/agents/messages.ts";
|
|
44
|
+
import { errorText } from "../../../shared/domain/error-text.ts";
|
|
45
|
+
import { WORKSPACE } from "../../../shared/domain/vfs.ts";
|
|
46
|
+
|
|
47
|
+
export interface DevPlanInputs { source?: unknown; replace?: unknown } // source: the token, null for none
|
|
48
|
+
export interface DevPlanDeps {
|
|
49
|
+
files: Files; shell: Pick<Shell, "run">; config: Pick<ConfigStore, "readValue">;
|
|
50
|
+
index: CodeIndex; anchors: AnchorIndex; llm: Pick<Llm, "extract" | "act" | "permissionGateEnabled">;
|
|
51
|
+
log: Logger; clock: () => Date;
|
|
52
|
+
/** The shared memory's code-triggered recall (T2); absent, nothing is recalled. */
|
|
53
|
+
precedents?: StepPrecedents;
|
|
54
|
+
/** The route of the plan reviewer's act to a cheaper or stronger profile (shared/application/agents/route-agent.ts actRoute);
|
|
55
|
+
* absent, the act runs on the crew's profile. */
|
|
56
|
+
route?: ActRoute;
|
|
57
|
+
}
|
|
58
|
+
export const PLAN_JSON = "plan.json";
|
|
59
|
+
|
|
60
|
+
const MAX_SOURCE_TOKEN = 300;
|
|
61
|
+
const MAX_WARNINGS = 5;
|
|
62
|
+
const MAX_PROBLEM_LINES = 12;
|
|
63
|
+
const LIST_CAP = 1000;
|
|
64
|
+
const MIN_INVENTORY_CHARS = 2_000;
|
|
65
|
+
/** Room kept for the problems of a re-ask when the inventory is sized to the prompt. */
|
|
66
|
+
const REASK_RESERVE = 4_000;
|
|
67
|
+
|
|
68
|
+
const firstLine = (e: unknown): string => (e instanceof Error ? e.message : String(e)).split("\n")[0];
|
|
69
|
+
const pad2 = (n: number): string => String(n).padStart(2, "0");
|
|
70
|
+
const dateOf = (d: Date): string => `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
|
|
71
|
+
const plural = (n: number, one: string, many: string): string => `${n} ${n === 1 ? one : many}`;
|
|
72
|
+
|
|
73
|
+
class WriteFailure extends Error {
|
|
74
|
+
readonly shown: string;
|
|
75
|
+
constructor(shown: string, cause: unknown) {
|
|
76
|
+
super(firstLine(cause));
|
|
77
|
+
this.shown = shown;
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
interface Place { folderVfs: string; folderShown: string; shown: (name: string) => string; vfs: (name: string) => string }
|
|
82
|
+
|
|
83
|
+
function placeOf(source: ResolvedSource): Place {
|
|
84
|
+
const folderVfs = source.folderShown === "" ? WORKSPACE : `${WORKSPACE}/${source.folderShown}`;
|
|
85
|
+
return {
|
|
86
|
+
folderVfs, folderShown: source.folderShown,
|
|
87
|
+
shown: (name) => (source.folderShown === "" ? name : `${source.folderShown}/${name}`),
|
|
88
|
+
vfs: (name) => `${folderVfs}/${name}`,
|
|
89
|
+
};
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
function checkInputs(input: DevPlanInputs): { source: string | null; replace: boolean } | string {
|
|
93
|
+
const { source, replace } = input;
|
|
94
|
+
if (source !== undefined && source !== null && (typeof source !== "string" || source.length > MAX_SOURCE_TOKEN)) {
|
|
95
|
+
return BAD_INPUT_SOURCE;
|
|
96
|
+
}
|
|
97
|
+
if (replace !== undefined && typeof replace !== "boolean") return BAD_INPUT_REPLACE;
|
|
98
|
+
const token = typeof source === "string" && source.trim() !== "" ? source.trim() : null;
|
|
99
|
+
return { source: token, replace: replace === true };
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
async function toplevelRefusal(shell: Pick<Shell, "run">): Promise<string | null> {
|
|
103
|
+
let top: string;
|
|
104
|
+
try {
|
|
105
|
+
const r = await shell.run(GIT_TOPLEVEL);
|
|
106
|
+
top = r.exitCode === 0 ? r.stdout.trim() : "";
|
|
107
|
+
} catch {
|
|
108
|
+
top = "";
|
|
109
|
+
}
|
|
110
|
+
if (top === WORKSPACE) return null;
|
|
111
|
+
return planRunFromCheckout(WORKSPACE, top);
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
function warningLines(warnings: readonly string[]): string[] {
|
|
115
|
+
const lines = warnings.slice(0, MAX_WARNINGS).map((w) => `warning: ${w}`);
|
|
116
|
+
if (warnings.length > MAX_WARNINGS) lines.push(` … ${warnings.length - MAX_WARNINGS} more warnings`);
|
|
117
|
+
return lines;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
function problemLines(problems: readonly string[]): string[] {
|
|
121
|
+
const lines = problems.slice(0, MAX_PROBLEM_LINES).map((p) => ` ${p}`);
|
|
122
|
+
if (problems.length > MAX_PROBLEM_LINES) lines.push(` … ${problems.length - MAX_PROBLEM_LINES} more`);
|
|
123
|
+
return lines;
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
// ---- an existing plan (§ 2.9) ------------------------------------------------------
|
|
127
|
+
|
|
128
|
+
type Existing = { ok: true; sheets: string[] } | { ok: false; text: string };
|
|
129
|
+
|
|
130
|
+
/** What a plan or sheet records as done: a done batch, a ticked box, a ticked TDD line, a done title. */
|
|
131
|
+
function workDone(text: string, kind: "plan" | "sheet"): string | null {
|
|
132
|
+
if (kind === "plan") {
|
|
133
|
+
const plan = parseGlobalPlan(text);
|
|
134
|
+
const done = plan.batches.find((b) => b.state.kind === "done");
|
|
135
|
+
if (done) return batchIsDone(done.id);
|
|
136
|
+
for (const b of plan.batches) {
|
|
137
|
+
const box = b.steps.find((s) => s.done);
|
|
138
|
+
if (box) return stepIsTicked(box.number, b.id);
|
|
139
|
+
}
|
|
140
|
+
return null;
|
|
141
|
+
}
|
|
142
|
+
const sheet = parseBatchSheet(text);
|
|
143
|
+
if (sheet.doneDate !== undefined) return titleReadsDone(sheet.doneDate);
|
|
144
|
+
const ticked = sheet.steps.find((s) => s.tdd !== null && (s.tdd.red || s.tdd.green || s.tdd.cost));
|
|
145
|
+
if (ticked) return tddLineTicked(ticked.number);
|
|
146
|
+
return null;
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
async function existingPlan(files: Files, place: Place, source: ResolvedSource, replace: boolean): Promise<Existing> {
|
|
150
|
+
let names: string[];
|
|
151
|
+
try {
|
|
152
|
+
names = (await files.list(place.folderVfs, LIST_CAP)).map((n) => n.replace(/\/+$/, ""));
|
|
153
|
+
} catch {
|
|
154
|
+
names = [];
|
|
155
|
+
}
|
|
156
|
+
const own = names
|
|
157
|
+
.map((n) => classifyArtefact(n))
|
|
158
|
+
.filter((a) => a !== null && (a.kind === "plan" || a.kind === "sheet") && a.prefix === source.prefix);
|
|
159
|
+
if (own.length === 0) return { ok: true, sheets: [] };
|
|
160
|
+
const planName = `${source.prefix}-PLAN.md`;
|
|
161
|
+
if (!replace) {
|
|
162
|
+
return {
|
|
163
|
+
ok: false,
|
|
164
|
+
text: planExists(place.shown(planName), source.code),
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
const sheets: string[] = [];
|
|
168
|
+
for (const a of own) {
|
|
169
|
+
if (a === null) continue;
|
|
170
|
+
let text: string;
|
|
171
|
+
try {
|
|
172
|
+
text = await files.read(place.vfs(a.name));
|
|
173
|
+
} catch (e) {
|
|
174
|
+
return { ok: false, text: planCannotBeReadNothingReplaced(place.shown(a.name), firstLine(e)) };
|
|
175
|
+
}
|
|
176
|
+
const done = workDone(text, a.kind === "plan" ? "plan" : "sheet");
|
|
177
|
+
if (done !== null) {
|
|
178
|
+
return {
|
|
179
|
+
ok: false,
|
|
180
|
+
text: recordsWorkDone(place.shown(a.name), done),
|
|
181
|
+
};
|
|
182
|
+
}
|
|
183
|
+
if (a.kind === "sheet") sheets.push(a.name);
|
|
184
|
+
}
|
|
185
|
+
sheets.sort((x, y) => compareBatchIds(classifyArtefact(x)?.batch ?? x, classifyArtefact(y)?.batch ?? y));
|
|
186
|
+
return { ok: true, sheets };
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
// ---- the plan ----------------------------------------------------------------------
|
|
190
|
+
|
|
191
|
+
interface Planned { answer: PlanAnswer; rendered: RenderedPlan; repairs: string[] }
|
|
192
|
+
|
|
193
|
+
async function askPlan(
|
|
194
|
+
deps: DevPlanDeps, promptInput: PlanPromptInput, checkCtx: PlanCheckContext, render: (a: PlanAnswer) => RenderedPlan,
|
|
195
|
+
sourceIds: readonly string[], timer: PhaseTimer,
|
|
196
|
+
): Promise<{ ok: true; planned: Planned } | { ok: false; problems: string[] }> {
|
|
197
|
+
let problems: string[] = [];
|
|
198
|
+
const listings: AnchorListings = new Map(); // one listing per folder for the run, not per attempt
|
|
199
|
+
for (let attempt = 1; attempt <= 2; attempt++) {
|
|
200
|
+
let value: unknown;
|
|
201
|
+
try {
|
|
202
|
+
value = await timer.time("draft", () => deps.llm.extract(buildPlanPrompt(promptInput, problems), PLAN_ANSWER_SCHEMA));
|
|
203
|
+
} catch (e) {
|
|
204
|
+
problems = [answerDidNotParse(errorText(e))];
|
|
205
|
+
deps.log.info(answerAskedAgain("dev-plan", problems));
|
|
206
|
+
continue;
|
|
207
|
+
}
|
|
208
|
+
const checked = checkPlanAnswer(value, checkCtx);
|
|
209
|
+
if (!checked.ok) {
|
|
210
|
+
problems = checked.problems;
|
|
211
|
+
deps.log.info(answerAskedAgain("dev-plan", problems));
|
|
212
|
+
continue;
|
|
213
|
+
}
|
|
214
|
+
const repairs = await repairAnchorKinds(deps.files, checked.value, listings);
|
|
215
|
+
const paths = await checkAnchorPaths(deps.files, checked.value, listings);
|
|
216
|
+
if (paths.length > 0) {
|
|
217
|
+
problems = paths;
|
|
218
|
+
deps.log.info(answerAskedAgain("dev-plan", problems));
|
|
219
|
+
continue;
|
|
220
|
+
}
|
|
221
|
+
const rendered = render(checked.value);
|
|
222
|
+
const self = planSelfCheck({ plan: rendered.plan, sheets: rendered.sheets, sourceIds });
|
|
223
|
+
if (!self.ok) {
|
|
224
|
+
deps.log.warn(planRendererDefect(self.problems[0]));
|
|
225
|
+
problems = self.problems;
|
|
226
|
+
continue;
|
|
227
|
+
}
|
|
228
|
+
return { ok: true, planned: { answer: checked.value, rendered, repairs } };
|
|
229
|
+
}
|
|
230
|
+
return { ok: false, problems };
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
function planJson(generated: Date, source: ResolvedSource, inventory: Inventory, answer: PlanAnswer, review: ReviewAnswer | null): string {
|
|
234
|
+
return `${JSON.stringify({
|
|
235
|
+
version: 1, generated: generated.toISOString(), source: source.sourceShown, prefix: source.prefix,
|
|
236
|
+
inventory, answer, review,
|
|
237
|
+
}, null, 2)}\n`;
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
async function writeOne(files: Files, place: Place, name: string, content: string): Promise<void> {
|
|
241
|
+
try {
|
|
242
|
+
await files.write(place.vfs(name), content);
|
|
243
|
+
} catch (e) {
|
|
244
|
+
throw new WriteFailure(place.shown(name), e);
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
// ---- the end message (§ 3.3) -------------------------------------------------------
|
|
249
|
+
|
|
250
|
+
function batchLines(rendered: RenderedPlan, answer: PlanAnswer): string[] {
|
|
251
|
+
const summary = parseGlobalPlan(rendered.plan.text).summary;
|
|
252
|
+
return answer.batches.map((b, k) => {
|
|
253
|
+
const row = summary[k];
|
|
254
|
+
const deps = row === undefined || row.dependsOn.length === 0 ? "—" : row.dependsOn.join(", ");
|
|
255
|
+
return ` F${k + 1} — ${b.name} — ${plural(b.steps.length, "step", "steps")} — ${row?.ids ?? "—"} — depends on ${deps}`;
|
|
256
|
+
});
|
|
257
|
+
}
|
|
258
|
+
|
|
259
|
+
/** The next step: the first batch, and with more than one /dev-batches, which runs them all in their order (L-7). */
|
|
260
|
+
function nextCommand(answer: PlanAnswer, planShown: string, code: string): string {
|
|
261
|
+
const first = `/dev-batches ${planShown} F1`;
|
|
262
|
+
if (answer.batches.length < 2) return END_LINE.replace("{command}", first);
|
|
263
|
+
return END_LINE.replace("{command}", everyBatch(first, code));
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
function reviewLines(review: ReviewAnswer): string[] {
|
|
267
|
+
if (review.rows.length === 0) return [`review: ${review.verdict}`];
|
|
268
|
+
const blocking = review.rows.filter((r) => r.severity === "Blocking").length;
|
|
269
|
+
const majors = review.rows.length - blocking;
|
|
270
|
+
const places = new Set<string>();
|
|
271
|
+
if (blocking > 0) places.add("Blocking: § 4");
|
|
272
|
+
for (const r of review.rows) {
|
|
273
|
+
if (r.severity !== "Major") continue;
|
|
274
|
+
places.add(r.target === "plan" ? "plan: § 4" : `${r.target}: under ## Decisions`);
|
|
275
|
+
}
|
|
276
|
+
return [
|
|
277
|
+
reviewHead(review.verdict, blocking, majors, [...places].join("; ")),
|
|
278
|
+
...review.rows.map((r) => ` ${r.severity} ${r.target} — ${r.question} (${r.evidence})`),
|
|
279
|
+
];
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
function absentWarning(absent: readonly string[], planName: string, code: string): string[] {
|
|
283
|
+
if (absent.length === 0) return [];
|
|
284
|
+
const where = absent.some((k) => k.startsWith("layout.")) ? BOTH_LINES : COMMANDS_LINE;
|
|
285
|
+
return [notInPack(absent.join(", "), where, planName, code)];
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
// ---- the run -----------------------------------------------------------------------
|
|
289
|
+
|
|
290
|
+
export async function runDevPlan(input: DevPlanInputs, deps: DevPlanDeps): Promise<string> {
|
|
291
|
+
// 1. Inputs.
|
|
292
|
+
const checked = checkInputs(input);
|
|
293
|
+
if (typeof checked === "string") return checked;
|
|
294
|
+
// 2. Checkout.
|
|
295
|
+
const top = await toplevelRefusal(deps.shell);
|
|
296
|
+
if (top !== null) return top;
|
|
297
|
+
// 3. Context.
|
|
298
|
+
const ctx = await loadDevContext(deps);
|
|
299
|
+
// 4. Source.
|
|
300
|
+
const resolution = await resolvePlanSource(deps.files, ctx.work, checked.source);
|
|
301
|
+
if (!resolution.ok) return resolution.text;
|
|
302
|
+
const source = resolution.source;
|
|
303
|
+
const read = await readPlanSource(deps.files, source);
|
|
304
|
+
if (!read.ok) return read.text;
|
|
305
|
+
const parsed: PlanSource = read.parsed;
|
|
306
|
+
// 5. Blocking gate: nothing else is read.
|
|
307
|
+
if (parsed.blocking.length > 0) return blockingStop(source.sourceShown, source.kind, source.code, parsed.blocking);
|
|
308
|
+
// 6. Ids.
|
|
309
|
+
if (parsed.ids.length === 0) return namesNoTraceableId(source.sourceShown);
|
|
310
|
+
if (source.kind === "change" && parsed.changeKind === undefined) {
|
|
311
|
+
return planTitleNamesNoKind(source.sourceShown);
|
|
312
|
+
}
|
|
313
|
+
// 7. Existing plan.
|
|
314
|
+
const place = placeOf(source);
|
|
315
|
+
const existing = await existingPlan(deps.files, place, source, checked.replace);
|
|
316
|
+
if (!existing.ok) return existing.text;
|
|
317
|
+
|
|
318
|
+
// 8. Inventory.
|
|
319
|
+
const timer = new PhaseTimer(deps.clock);
|
|
320
|
+
const pack = ctx.pack;
|
|
321
|
+
const built = await timer.time("inventory", () => buildInventory(deps.index, deps.anchors, {
|
|
322
|
+
titles: parsed.ids.map((i) => ({ id: i.id, title: i.title })),
|
|
323
|
+
workShown: ctx.work.folder,
|
|
324
|
+
layout: pack?.pack.layout ?? null,
|
|
325
|
+
buildOutputs: pack?.pack.layout.buildOutputs ?? [],
|
|
326
|
+
}, deps.log));
|
|
327
|
+
if (!built.ok) return built.text;
|
|
328
|
+
const inventory = built.inventory;
|
|
329
|
+
|
|
330
|
+
// 9. Prompt. T2: the decisions and code structures of earlier work on these use cases, after the inventory.
|
|
331
|
+
const recalled = await (deps.precedents ?? noPrecedents)("T2", recallQuery([source.code, ...parsed.ids.map((i) => i.title)]));
|
|
332
|
+
const repo = repoLines(pack?.pack ?? null, pack?.shown ?? null);
|
|
333
|
+
const unpinned = parsed.mustNotChange.filter((r) => r.pinnedBy === null).map((r, i) => ({ key: `U${i + 1}`, behaviour: r.behaviour }));
|
|
334
|
+
const pinned = parsed.mustNotChange.flatMap((r) => (r.pinnedBy === null ? [] : [r.pinnedBy]));
|
|
335
|
+
let shownInventory = renderInventory(inventory, INVENTORY_CAPS.promptChars);
|
|
336
|
+
const promptInput: PlanPromptInput = {
|
|
337
|
+
sourceShown: source.sourceShown, kind: source.kind,
|
|
338
|
+
...(parsed.changeKind === undefined ? {} : { changeKind: parsed.changeKind }),
|
|
339
|
+
sourceText: read.text.slice(0, SOURCE_CHARS),
|
|
340
|
+
ids: parsed.ids, pinned, unpinned,
|
|
341
|
+
repoCommands: repo.commands, repoLayout: repo.layout,
|
|
342
|
+
inventory: shownInventory.text, workShown: ctx.work.folder, precedents: recalled.block,
|
|
343
|
+
};
|
|
344
|
+
const fixed = buildPlanPrompt({ ...promptInput, sourceText: "", inventory: "" }, []).length;
|
|
345
|
+
const room = MAX_PLAN_PROMPT_CHARS - fixed - REASK_RESERVE;
|
|
346
|
+
// Below the floor the prompt's cut would drop inventory lines the plan's check still counts as shown: refused.
|
|
347
|
+
if (room < MIN_INVENTORY_CHARS) {
|
|
348
|
+
return noRoomForInventory(fixed, MAX_PLAN_PROMPT_CHARS);
|
|
349
|
+
}
|
|
350
|
+
if (shownInventory.text.length > room) {
|
|
351
|
+
shownInventory = renderInventory(inventory, room);
|
|
352
|
+
promptInput.inventory = shownInventory.text;
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
// 10. Plan.
|
|
356
|
+
const date = dateOf(deps.clock());
|
|
357
|
+
const sourceIds = parsed.ids.map((i) => i.id);
|
|
358
|
+
const byRef = new Map(inventory.entries.map((e) => [e.ref, e]));
|
|
359
|
+
const renderInput = (answer: PlanAnswer, review: ReviewAnswer | null): RenderInput => ({
|
|
360
|
+
prefix: source.prefix, sourceShown: source.sourceShown, kind: source.kind,
|
|
361
|
+
...(parsed.changeKind === undefined ? {} : { changeKind: parsed.changeKind }),
|
|
362
|
+
sourceIds: parsed.ids, repo, inventory: byRef, answer, review, date,
|
|
363
|
+
});
|
|
364
|
+
const checkCtx: PlanCheckContext = {
|
|
365
|
+
sourceIds, shownRefs: shownInventory.shown, refPaths: new Map(inventory.entries.map((e) => [e.ref, e.path])),
|
|
366
|
+
refNames: new Map(inventory.entries.map((e) => [e.ref, e.name])),
|
|
367
|
+
kind: source.kind, ...(parsed.changeKind === undefined ? {} : { changeKind: parsed.changeKind }),
|
|
368
|
+
pinned, unpinned: unpinned.map((u) => u.key), workFolder: ctx.work.folder,
|
|
369
|
+
};
|
|
370
|
+
const asked = await askPlan(deps, promptInput, checkCtx, (a) => renderPlan(renderInput(a, null)), sourceIds, timer);
|
|
371
|
+
if (!asked.ok) {
|
|
372
|
+
return [REFUSED_TWICE, ...problemLines(asked.problems)].join("\n");
|
|
373
|
+
}
|
|
374
|
+
const { answer } = asked.planned;
|
|
375
|
+
let rendered = asked.planned.rendered;
|
|
376
|
+
|
|
377
|
+
// 10b. A replace with fewer batches would leave stale sheets: refused before any write.
|
|
378
|
+
if (existing.sheets.length > answer.batches.length) {
|
|
379
|
+
const extra = existing.sheets.slice(answer.batches.length).map((n) => place.shown(n));
|
|
380
|
+
return fewerBatches(answer.batches.length, existing.sheets.length, extra.join(", "), source.code);
|
|
381
|
+
}
|
|
382
|
+
|
|
383
|
+
// 11. Write.
|
|
384
|
+
const generated = deps.clock();
|
|
385
|
+
try {
|
|
386
|
+
await timer.time("write", async () => {
|
|
387
|
+
await writeOne(deps.files, place, rendered.plan.name, rendered.plan.text);
|
|
388
|
+
for (const s of rendered.sheets) await writeOne(deps.files, place, s.name, s.text);
|
|
389
|
+
await writeOne(deps.files, place, PLAN_JSON, planJson(generated, source, inventory, answer, null));
|
|
390
|
+
}, "pass");
|
|
391
|
+
} catch (e) {
|
|
392
|
+
const shown = e instanceof WriteFailure ? e.shown : "a file";
|
|
393
|
+
return planFileNotWritten(shown, firstLine(e));
|
|
394
|
+
}
|
|
395
|
+
const planShown = place.shown(rendered.plan.name);
|
|
396
|
+
deps.log.info(planWritten(planShown, rendered.sheets.length));
|
|
397
|
+
|
|
398
|
+
// 12. Review.
|
|
399
|
+
const warnings = [...ctx.warnings, ...inventory.warnings, ...absentWarning(repo.absent, rendered.plan.name, source.code)];
|
|
400
|
+
warnings.push(...asked.planned.repairs);
|
|
401
|
+
if (deps.llm.permissionGateEnabled() === false) warnings.push(GATE_OFF);
|
|
402
|
+
const targets = ["plan", ...answer.batches.map((_, k) => `F${k + 1}`)];
|
|
403
|
+
const outcome = await timer.time("review", () => runSubAgent(timer.timedExtract(deps.llm, "review extract"), {
|
|
404
|
+
charter: REVIEWER_CHARTER,
|
|
405
|
+
system: reviewSystem("plan"),
|
|
406
|
+
brief: buildReviewBrief({
|
|
407
|
+
mode: "plan", folder: place.folderShown === "" ? "." : place.folderShown,
|
|
408
|
+
files: [planShown, ...rendered.sheets.map((s) => place.shown(s.name))],
|
|
409
|
+
source: source.sourceShown, inventory: shownInventory.text, targets,
|
|
410
|
+
}),
|
|
411
|
+
schema: REVIEW_ANSWER_SCHEMA,
|
|
412
|
+
answerPrompt: (reply, problems) => buildReviewAnswerPrompt(reply, problems, targets),
|
|
413
|
+
...reviewChecks(targets),
|
|
414
|
+
}, deps.route, deps.log));
|
|
415
|
+
|
|
416
|
+
// 13. Review rows into the files; the review is never run again.
|
|
417
|
+
let review: ReviewAnswer | null = null;
|
|
418
|
+
let reviewText: string[];
|
|
419
|
+
if (!outcome.ok) {
|
|
420
|
+
reviewText = [reviewNotRunWithCause(outcome.reason, outcome.problems[0] ?? "no detail")];
|
|
421
|
+
} else {
|
|
422
|
+
const answered = outcome.value;
|
|
423
|
+
review = answered;
|
|
424
|
+
reviewText = reviewLines(answered);
|
|
425
|
+
try {
|
|
426
|
+
const stop = await timer.time("write", async (): Promise<string | null> => {
|
|
427
|
+
if (answered.rows.length > 0) {
|
|
428
|
+
const reviewed = renderPlan(renderInput(answer, answered));
|
|
429
|
+
const self = planSelfCheck({ plan: reviewed.plan, sheets: reviewed.sheets, sourceIds });
|
|
430
|
+
if (!self.ok) {
|
|
431
|
+
return [
|
|
432
|
+
REVIEWED_FAILS_SELF_CHECK,
|
|
433
|
+
...problemLines(self.problems),
|
|
434
|
+
ROWS_NOT_WRITTEN,
|
|
435
|
+
...answered.rows.map((r) => ` ${r.severity} ${r.target} — ${r.question} (${r.evidence})`),
|
|
436
|
+
].join("\n");
|
|
437
|
+
}
|
|
438
|
+
if (reviewed.plan.text !== rendered.plan.text) await writeOne(deps.files, place, reviewed.plan.name, reviewed.plan.text);
|
|
439
|
+
for (const [k, s] of reviewed.sheets.entries()) {
|
|
440
|
+
if (s.text !== rendered.sheets[k].text) await writeOne(deps.files, place, s.name, s.text);
|
|
441
|
+
}
|
|
442
|
+
rendered = reviewed;
|
|
443
|
+
}
|
|
444
|
+
await writeOne(deps.files, place, PLAN_JSON, planJson(generated, source, inventory, answer, answered));
|
|
445
|
+
return null;
|
|
446
|
+
}, "pass");
|
|
447
|
+
if (stop !== null) return stop;
|
|
448
|
+
} catch (e) {
|
|
449
|
+
const shown = e instanceof WriteFailure ? e.shown : "a file";
|
|
450
|
+
return planFileNotWritten(shown, firstLine(e));
|
|
451
|
+
}
|
|
452
|
+
}
|
|
453
|
+
|
|
454
|
+
// 15. End message.
|
|
455
|
+
const ids = sourceIds.join(", ");
|
|
456
|
+
const lines = [
|
|
457
|
+
`dev-plan: ${planShown} — ${plural(answer.batches.length, "batch", "batches")}, ${plural(sourceIds.length, "id", "ids")} traced (${ids})`,
|
|
458
|
+
...batchLines(rendered, answer),
|
|
459
|
+
`files: ${[planShown, ...rendered.sheets.map((s) => s.name), PLAN_JSON].join(", ")}`,
|
|
460
|
+
inventoryFromTitles(inventory.entries.length, inventory.titlesSearched, inventory.index, inventory.calls),
|
|
461
|
+
...reviewText,
|
|
462
|
+
...[precedentsLine([recalled])].filter((l) => l !== ""),
|
|
463
|
+
...warningLines(warnings),
|
|
464
|
+
];
|
|
465
|
+
const blocking = review?.rows.filter((r) => r.severity === "Blocking").length ?? 0;
|
|
466
|
+
if (blocking > 0) {
|
|
467
|
+
const settle = source.kind === "change" ? SETTLE_CHANGE : SETTLE_SPEC;
|
|
468
|
+
lines.push(
|
|
469
|
+
planBlocked(plural(blocking, "Blocking question", "Blocking questions"), planShown),
|
|
470
|
+
answerThenReplan(blocking === 1 ? "it" : "them", settle, source.code, source.kind === "change" ? " <its kind>" : ""),
|
|
471
|
+
);
|
|
472
|
+
} else if (!outcome.ok) {
|
|
473
|
+
lines.push(unreviewed(source.code));
|
|
474
|
+
} else {
|
|
475
|
+
lines.push(nextCommand(answer, planShown, source.code));
|
|
476
|
+
}
|
|
477
|
+
const timing = timer.line();
|
|
478
|
+
if (timing !== "") {
|
|
479
|
+
deps.log.info(timing);
|
|
480
|
+
lines.push(timing);
|
|
481
|
+
}
|
|
482
|
+
return lines.join("\n");
|
|
483
|
+
}
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
// @orkeon-script 1.0
|
|
2
|
+
/// <reference path="../.orkeon/orkeon.d.ts" />
|
|
3
|
+
//
|
|
4
|
+
// DevPlan crew (/dev-plan). Composition root: it builds the planner agent and wires application/run-dev-plan,
|
|
5
|
+
// which stops on a Blocking open question, inventories the code by the index, asks the model for the plan as
|
|
6
|
+
// JSON (once more on a refused answer), writes <CODE>-PLAN.md, one sheet per batch and plan.json, then has the
|
|
7
|
+
// read-only reviewer question the plan once. The reviewer's act runs in a background child, `dev-reviewer`
|
|
8
|
+
// (the reviewer's charter: read tools only, plan mode), which /tasks lists and stops while it runs, and repairs by a new run once it has ended
|
|
9
|
+
// (A-3, shared/application/agents/child-agent.ts).
|
|
10
|
+
//
|
|
11
|
+
// Input (globalThis.inputs): { source: string | null, replace?: boolean, hooks?: the /hooks registry,
|
|
12
|
+
// effort?: "low" | "medium" | "high" | "xhigh" | "max" | null, concurrency?: number, maxInstances?: number }
|
|
13
|
+
// Run standalone: bash scripts/run-crew.sh src/crews/dev-plan/crew.ork.ts --inputs '{"source":"prune"}'
|
|
14
|
+
//
|
|
15
|
+
// Budget: up to 59 index and batch_anchors calls by code, at most 40 folder listings for the anchors (one per folder for the run,
|
|
16
|
+
// both attempts sharing them), about 30 other file and git calls, two extract calls and one review of 20
|
|
17
|
+
// iterations (about 3 tool calls each): 59 + 40 + 30 + 2 + 60 = 191, so toolCalls 240 leaves a margin that 200
|
|
18
|
+
// did not. The reviewer runs as a child: the runtime gives it what the parent has left at its spawn
|
|
19
|
+
// (SpawnAgentScriptTool CreateChildBudget), so the 60 is its own estimate, not a cap.
|
|
20
|
+
|
|
21
|
+
import { CrewBuilder, publishCrew, inputs, ToolBuilder } from "../../shared/infrastructure/globals.ts";
|
|
22
|
+
import {
|
|
23
|
+
orkeonActRoute, orkeonPrunedLlm,
|
|
24
|
+
orkeonAgent,
|
|
25
|
+
orkeonAnchorIndex,
|
|
26
|
+
orkeonClock,
|
|
27
|
+
orkeonCodeIndex,
|
|
28
|
+
orkeonConfigStore,
|
|
29
|
+
orkeonFiles,
|
|
30
|
+
orkeonMemoryToolPorts,
|
|
31
|
+
orkeonSessionIo,
|
|
32
|
+
orkeonSharedMemory,
|
|
33
|
+
orkeonShell,
|
|
34
|
+
} from "../../shared/infrastructure/orkeon/wiring.ts";
|
|
35
|
+
import { memoryReadTools, memoryRecallOn, memoryRecallTools } from "../../shared/infrastructure/orkeon/memory-tools.ts";
|
|
36
|
+
import { agentLlm } from "../../shared/infrastructure/orkeon/llm.ts";
|
|
37
|
+
import { memoryDirOf } from "../../shared/application/shared-memory/memory-settings.ts";
|
|
38
|
+
import { devToolCallbacks } from "../../shared/application/dev/tool-callbacks.ts";
|
|
39
|
+
import { childAgentBody, openChildAct } from "../../shared/infrastructure/orkeon/child-agents.ts";
|
|
40
|
+
import { charterCatalogue } from "../../shared/domain/agents/charter.ts";
|
|
41
|
+
import { instanceLimits } from "../../shared/domain/agents/instances.ts";
|
|
42
|
+
import { providerEffort } from "../../shared/domain/agent-policy/behavior-flags.ts";
|
|
43
|
+
import { REVIEWER_CHARTER } from "../../shared/domain/dev/reviewer-charter.ts";
|
|
44
|
+
import { reviewerCallbacks } from "../../shared/application/dev/spend.ts";
|
|
45
|
+
import { runDevPlan } from "./application/run-dev-plan.ts";
|
|
46
|
+
import { PLANNER_GOAL, PLAN_REVIEW_TASK } from "./application/messages.ts";
|
|
47
|
+
import { STEP_BUDGETS } from "../../shared/domain/dev/step-budget.ts";
|
|
48
|
+
import { stepPrecedents } from "../../shared/application/dev/step-precedents.ts";
|
|
49
|
+
|
|
50
|
+
const ports = {
|
|
51
|
+
shell: orkeonShell(), files: orkeonFiles(), config: orkeonConfigStore(), index: orkeonCodeIndex(), anchors: orkeonAnchorIndex(),
|
|
52
|
+
};
|
|
53
|
+
// memory_recall is attached unless a session rule denies every call of it (the command says so).
|
|
54
|
+
const memoryOn = memoryRecallOn(inputs());
|
|
55
|
+
const session = orkeonSessionIo();
|
|
56
|
+
const effort = providerEffort(inputs().effort);
|
|
57
|
+
const limits = instanceLimits(inputs());
|
|
58
|
+
// These callbacks, then the host's gate on the input they return (Orkeon #303): the step's rule sets again and the /hooks the command passed.
|
|
59
|
+
// memory_recall (the shared memory's precedents) declares `read`: named in readTools, as run_validation in dev-verify.
|
|
60
|
+
const callbacksFor = (ctx: any) => devToolCallbacks(
|
|
61
|
+
{ step: "dev-plan", hooks: inputs().hooks, readTools: memoryReadTools(memoryOn) }, { shell: ports.shell, log: ctx.log, memoryDir: memoryDirOf(ports.config) },
|
|
62
|
+
);
|
|
63
|
+
|
|
64
|
+
/** The reviewer, added to the crew by its first act (a sequential crew would run an agent it holds from the start). */
|
|
65
|
+
const reviewer = () => {
|
|
66
|
+
const builder = orkeonAgent()
|
|
67
|
+
.name(REVIEWER_CHARTER.name)
|
|
68
|
+
.role(REVIEWER_CHARTER.role)
|
|
69
|
+
.goal(REVIEWER_CHARTER.goal)
|
|
70
|
+
.tools(charterCatalogue(REVIEWER_CHARTER))
|
|
71
|
+
.withAutonomousTools(memoryRecallTools(ToolBuilder, orkeonMemoryToolPorts, memoryOn))
|
|
72
|
+
.maxIterations(REVIEWER_CHARTER.maxIterations)
|
|
73
|
+
.body(childAgentBody((ctx: any) => reviewerCallbacks(callbacksFor(ctx)), (llm, ctx) => orkeonPrunedLlm(llm, ctx.log, ctx.tools)));
|
|
74
|
+
return effort === undefined ? builder : builder.effort(effort);
|
|
75
|
+
};
|
|
76
|
+
|
|
77
|
+
const planner = orkeonAgent()
|
|
78
|
+
.name("dev-planner")
|
|
79
|
+
.role("Technical planner")
|
|
80
|
+
.goal(PLANNER_GOAL)
|
|
81
|
+
// The catalogue is the reviewer's: read tools only, for the inline review on a host without background
|
|
82
|
+
// children. The plan itself is an extract call, which offers none.
|
|
83
|
+
.tools(charterCatalogue(REVIEWER_CHARTER))
|
|
84
|
+
.withAutonomousTools(memoryRecallTools(ToolBuilder, orkeonMemoryToolPorts, memoryOn))
|
|
85
|
+
.maxIterations(REVIEWER_CHARTER.maxIterations)
|
|
86
|
+
.body(async (_input: any, ctx: any) => {
|
|
87
|
+
const clock = orkeonClock();
|
|
88
|
+
const child = openChildAct(
|
|
89
|
+
agentLlm(ctx, callbacksFor(ctx), { effort }), ctx, crew, { state: session, clock, log: ctx.log, effort },
|
|
90
|
+
{ crew: "dev-plan", step: "dev-plan" },
|
|
91
|
+
{ agent: REVIEWER_CHARTER.name, charter: REVIEWER_CHARTER.name, task: PLAN_REVIEW_TASK, builder: reviewer },
|
|
92
|
+
);
|
|
93
|
+
try {
|
|
94
|
+
// T2: the shared memory's precedents in the planner's prompt, unless memory_recall is denied.
|
|
95
|
+
const precedents = stepPrecedents({ ...ports, memory: orkeonSharedMemory(), log: ctx.log }, { on: memoryOn });
|
|
96
|
+
return await runDevPlan(inputs(), { ...ports, llm: child.llm, log: ctx.log, clock, precedents, route: orkeonActRoute(ctx.log) });
|
|
97
|
+
} finally {
|
|
98
|
+
await child.close();
|
|
99
|
+
}
|
|
100
|
+
})
|
|
101
|
+
.build();
|
|
102
|
+
|
|
103
|
+
const crew = CrewBuilder()
|
|
104
|
+
.name("dev-plan")
|
|
105
|
+
.process("sequential")
|
|
106
|
+
.budget(STEP_BUDGETS["dev-plan"])
|
|
107
|
+
.concurrency(limits.concurrency)
|
|
108
|
+
.maxInstances(limits.maxInstances)
|
|
109
|
+
.withAgent(planner)
|
|
110
|
+
.build();
|
|
111
|
+
|
|
112
|
+
publishCrew(crew);
|