orkeon-code 1.0.0-rc.1 → 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 -1
- package/NOTICE.md +1 -1
- package/README.fr.md +16 -22
- package/README.md +16 -22
- package/config/appsettings.jev.example.json +4 -1
- package/config/appsettings.kev.example.json +4 -1
- package/config/appsettings.liquid.example.json +4 -1
- package/config/appsettings.ollama-whisper.example.json +1 -0
- package/config/appsettings.whisper.example.json +1 -0
- package/mcp/whisper/README.md +2 -1
- package/orkeon-code +206 -11
- package/orkeon-code.ps1 +109 -7
- package/package.json +2 -1
- package/src/commands/.orkeon/orkeon-cli.d.ts +1 -4
- package/src/commands/_lib/args.ts +5 -4
- package/src/commands/_lib/dev/dev-batches.ts +34 -36
- package/src/commands/_lib/dev/dev-implement.ts +11 -14
- package/src/commands/_lib/dev/dev-source.ts +7 -11
- package/src/commands/_lib/dev/dev.ts +34 -37
- 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 +16 -13
- package/src/commands/_lib/dispatch.ts +62 -39
- package/src/commands/_lib/git/branch.ts +9 -10
- package/src/commands/_lib/git/commit.ts +9 -13
- package/src/commands/_lib/git/diff.ts +22 -12
- package/src/commands/_lib/git/messages.ts +54 -0
- package/src/commands/_lib/git/review.ts +9 -10
- package/src/commands/_lib/memory/memory-admit.ts +19 -21
- package/src/commands/_lib/memory/memory.ts +3 -2
- package/src/commands/_lib/memory/messages.ts +32 -0
- package/src/commands/_lib/messages.ts +48 -0
- package/src/commands/_lib/project/messages.ts +8 -0
- package/src/commands/_lib/session/export.ts +3 -2
- 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 +15 -24
- package/src/commands/_lib/session/tasks.ts +20 -23
- package/src/commands/_lib/settings/advisor.ts +11 -16
- package/src/commands/_lib/settings/agents.ts +18 -28
- package/src/commands/_lib/settings/choices.ts +8 -0
- package/src/commands/_lib/settings/config.ts +43 -43
- package/src/commands/_lib/settings/effort.ts +147 -0
- package/src/commands/_lib/settings/hooks.ts +12 -20
- package/src/commands/_lib/settings/messages.ts +408 -0
- package/src/commands/_lib/settings/mode.ts +33 -24
- package/src/commands/_lib/settings/model.ts +71 -36
- package/src/commands/_lib/settings/output-style.ts +39 -0
- package/src/commands/_lib/settings/permissions.ts +71 -93
- package/src/commands/_lib/settings/route.ts +63 -0
- package/src/commands/_lib/settings/skills.ts +53 -11
- 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 +9 -10
- package/src/commands/_lib/speech/transcribe.ts +14 -23
- package/src/commands/_lib/speech/voice.ts +14 -18
- package/src/commands/_lib/status/doctor.ts +47 -28
- package/src/commands/_lib/status/messages.ts +100 -0
- package/src/commands/_lib/status/meta.ts +3 -24
- package/src/commands/_lib/status/status.ts +10 -11
- package/src/commands/_lib/status/usage-tools.ts +2 -3
- package/src/commands/_lib/status/usage.ts +7 -18
- package/src/commands/_lib/view.ts +6 -1
- package/src/commands/dev/dev-batches.cmd.ts +4 -3
- package/src/commands/dev/dev-learn.cmd.ts +3 -3
- package/src/commands/dev/dev-plan.cmd.ts +6 -7
- package/src/commands/dev/dev-spec.cmd.ts +6 -7
- package/src/commands/git/commit.cmd.ts +3 -3
- package/src/commands/git/review.cmd.ts +3 -3
- package/src/commands/memory/memory.cmd.ts +2 -2
- package/src/commands/project/analyze.cmd.ts +3 -3
- package/src/commands/project/debug-tool-call.cmd.ts +4 -9
- package/src/commands/project/init-verifiers.cmd.ts +3 -3
- package/src/commands/project/init.cmd.ts +3 -3
- package/src/commands/project/verify.cmd.ts +2 -2
- package/src/commands/session/assistant.cmd.ts +2 -2
- package/src/commands/session/compact.cmd.ts +1 -1
- package/src/commands/session/copy.cmd.ts +8 -7
- package/src/commands/session/rename.cmd.ts +3 -2
- package/src/commands/session/rewind.cmd.ts +3 -4
- package/src/commands/session/summary.cmd.ts +3 -3
- package/src/commands/session/tasks.cmd.ts +4 -2
- package/src/commands/settings/config.cmd.ts +4 -2
- package/src/commands/settings/effort.cmd.ts +10 -31
- package/src/commands/settings/fast.cmd.ts +2 -1
- package/src/commands/settings/mode.cmd.ts +3 -3
- package/src/commands/settings/model.cmd.ts +3 -2
- package/src/commands/settings/output-style.cmd.ts +9 -38
- package/src/commands/settings/permissions.cmd.ts +2 -2
- package/src/commands/settings/proactive.cmd.ts +2 -1
- package/src/commands/settings/route.cmd.ts +16 -0
- package/src/commands/settings/skills.cmd.ts +3 -3
- package/src/commands/settings/theme.cmd.ts +14 -0
- package/src/commands/speech/say.cmd.ts +2 -2
- package/src/commands/speech/transcribe.cmd.ts +2 -2
- package/src/commands/status/release-notes.cmd.ts +1 -1
- package/src/crews/.orkeon/orkeon.d.ts +538 -93
- package/src/crews/_probe-shared-memory/domain/messages.ts +54 -0
- package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +17 -12
- package/src/crews/_probe-shared-memory/domain/prompts.ts +5 -0
- package/src/crews/_probe-shared-memory/probe.ork.ts +5 -3
- 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 +2 -1
- package/src/crews/advisor/crew.ork.ts +5 -4
- package/src/crews/advisor/domain/advice.ts +7 -23
- 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 +5 -4
- package/src/crews/agent-run/crew.ork.ts +3 -3
- 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 +16 -14
- package/src/crews/analyze/crew.ork.ts +5 -4
- package/src/crews/analyze/domain/harvest.ts +33 -65
- 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 +10 -17
- package/src/crews/code-review/application/review.ts +4 -1
- package/src/crews/code-review/application/run-code-review.ts +13 -15
- package/src/crews/code-review/crew.ork.ts +5 -4
- package/src/crews/code-review/domain/lenses.ts +6 -45
- 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 +5 -6
- package/src/crews/code-review/domain/scope.ts +6 -12
- package/src/crews/dev-batches/application/messages.ts +127 -0
- package/src/crews/dev-batches/application/plan-close.ts +12 -12
- package/src/crews/dev-batches/application/prompts.ts +10 -0
- package/src/crews/dev-batches/application/run-dev-batches.ts +57 -50
- package/src/crews/dev-batches/application/run-wave.ts +24 -22
- package/src/crews/dev-batches/application/seed-harvest.ts +8 -7
- package/src/crews/dev-batches/crew.ork.ts +12 -9
- package/src/crews/dev-batches/domain/batches-log.ts +1 -3
- 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 +3 -2
- package/src/crews/dev-change/application/change-material.ts +44 -0
- package/src/crews/dev-change/application/evidence.ts +25 -22
- package/src/crews/dev-change/application/messages.ts +81 -0
- package/src/crews/dev-change/application/{change-prompt.ts → prompts.ts} +40 -43
- package/src/crews/dev-change/application/run-dev-change.ts +43 -34
- package/src/crews/dev-change/crew.ork.ts +11 -9
- package/src/crews/dev-change/domain/change-answer.ts +24 -20
- package/src/crews/dev-change/domain/change-render.ts +13 -15
- 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 +21 -18
- package/src/crews/dev-implement/application/locate-sheet.ts +7 -5
- package/src/crews/dev-implement/application/messages.ts +161 -0
- package/src/crews/dev-implement/application/observe.ts +4 -2
- package/src/crews/dev-implement/application/prompts.ts +9 -0
- package/src/crews/dev-implement/application/report-writes.ts +14 -9
- package/src/crews/dev-implement/application/run-dev-implement.ts +84 -73
- package/src/crews/dev-implement/application/suite-job.ts +15 -11
- package/src/crews/dev-implement/crew.ork.ts +2 -1
- package/src/crews/dev-implement/domain/contracts.ts +59 -60
- package/src/crews/dev-implement/domain/correction.ts +16 -15
- package/src/crews/dev-implement/domain/cycles.ts +2 -1
- 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 +3 -7
- package/src/crews/dev-implement/domain/sheet-edits.ts +6 -5
- package/src/crews/dev-implement/domain/sheet-ticks.ts +5 -4
- package/src/crews/dev-implement/domain/step-checks.ts +17 -16
- package/src/crews/dev-implement/domain/step-section.ts +6 -4
- 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/{learn-prompt.ts → prompts.ts} +24 -65
- package/src/crews/dev-learn/application/run-dev-learn.ts +37 -32
- package/src/crews/dev-learn/crew.ork.ts +4 -3
- package/src/crews/dev-learn/domain/learn-answer.ts +25 -27
- package/src/crews/dev-learn/domain/messages.ts +65 -0
- package/src/crews/dev-learn/domain/owner-lines.ts +12 -9
- package/src/crews/dev-learn/domain/proposals-render.ts +8 -9
- package/src/crews/dev-plan/application/anchor-paths.ts +57 -20
- package/src/crews/dev-plan/application/inventory.ts +17 -13
- 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/{plan-prompt.ts → prompts.ts} +37 -55
- package/src/crews/dev-plan/application/run-dev-plan.ts +103 -75
- package/src/crews/dev-plan/crew.ork.ts +11 -8
- package/src/crews/dev-plan/domain/inventory-model.ts +3 -3
- 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 +118 -103
- package/src/crews/dev-plan/domain/plan-render.ts +30 -31
- 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/{spec-prompt.ts → prompts.ts} +42 -47
- package/src/crews/dev-spec/application/run-dev-spec.ts +67 -36
- package/src/crews/dev-spec/application/spec-material.ts +42 -0
- package/src/crews/dev-spec/crew.ork.ts +11 -9
- 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 +46 -47
- package/src/crews/dev-spec/domain/spec-render.ts +18 -18
- package/src/crews/dev-verify/application/audit-brief.ts +187 -0
- package/src/crews/dev-verify/application/audit.ts +38 -30
- package/src/crews/dev-verify/application/capture.ts +34 -26
- 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 +60 -46
- package/src/crews/dev-verify/application/run-gate.ts +11 -9
- package/src/crews/dev-verify/crew.ork.ts +6 -6
- package/src/crews/dev-verify/domain/audit-answer.ts +16 -12
- package/src/crews/dev-verify/domain/capture-sections.ts +5 -4
- package/src/crews/dev-verify/domain/commands.ts +3 -3
- package/src/crews/dev-verify/domain/gate.ts +21 -16
- package/src/crews/dev-verify/domain/markers.ts +16 -0
- package/src/crews/dev-verify/domain/mechanical-table.ts +37 -44
- package/src/crews/dev-verify/domain/messages.ts +92 -0
- package/src/crews/dev-verify/domain/verdict.ts +4 -4
- package/src/crews/git-commit/application/draft.ts +16 -37
- 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 +13 -12
- package/src/crews/git-commit/crew.ork.ts +5 -4
- package/src/crews/git-commit/domain/commit.ts +15 -35
- 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 +2 -1
- package/src/crews/init-verifiers/application/messages.ts +13 -0
- package/src/crews/init-verifiers/application/prompts.ts +5 -1
- package/src/crews/init-verifiers/application/run-init-verifiers.ts +3 -2
- package/src/crews/init-verifiers/crew.ork.ts +5 -4
- package/src/crews/main-loop/application/auto-compact.ts +2 -1
- 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 +63 -30
- package/src/crews/main-loop/application/{turn-prompt.ts → turn-context.ts} +7 -8
- package/src/crews/main-loop/crew.ork.ts +12 -7
- package/src/crews/main-loop/domain/prompt-assembly.ts +45 -228
- package/src/crews/main-loop/domain/prompts.ts +336 -0
- package/src/crews/main-loop/domain/turn-chains.ts +10 -9
- package/src/crews/project-init/application/detect.ts +5 -4
- package/src/crews/project-init/application/messages.ts +15 -0
- package/src/crews/project-init/application/prompts.ts +11 -7
- package/src/crews/project-init/crew.ork.ts +5 -4
- package/src/crews/project-init/domain/existing-files.ts +6 -4
- package/src/crews/project-init/domain/messages.ts +13 -0
- package/src/crews/project-init/domain/package-map.ts +3 -3
- 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 +5 -4
- package/src/crews/shared-memory-admit/application/prompts.ts +5 -0
- package/src/crews/shared-memory-admit/crew.ork.ts +3 -2
- 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 +2 -1
- package/src/crews/speech/crew.ork.ts +2 -1
- package/src/shared/application/agents/child-agent.ts +11 -7
- 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 +31 -8
- package/src/shared/application/compaction/compact-session.ts +19 -14
- 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/dev/brief-inventory.ts +6 -4
- package/src/shared/application/dev/close-batch.ts +9 -7
- package/src/shared/application/dev/find-repo-pack.ts +4 -3
- package/src/shared/application/dev/learn-decision.ts +20 -18
- package/src/shared/application/dev/load-dev-context.ts +7 -8
- package/src/shared/application/dev/measure-access-cost.ts +5 -4
- 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 +12 -8
- package/src/shared/application/dev/preflight.ts +8 -8
- package/src/shared/application/dev/prompts.ts +34 -0
- package/src/shared/application/dev/question-round.ts +25 -17
- package/src/shared/application/dev/resolve-work-folder.ts +4 -3
- package/src/shared/application/dev/settle-questions.ts +4 -2
- package/src/shared/application/dev/source-review.ts +12 -8
- package/src/shared/application/dev/source-step.ts +12 -10
- package/src/shared/application/dev/spend.ts +17 -4
- package/src/shared/application/dev/step-precedents.ts +2 -1
- package/src/shared/application/dev/tool-call-policy.ts +9 -11
- package/src/shared/application/dev/tool-callbacks.ts +52 -5
- package/src/shared/application/dev/tool-trace-recorder.ts +2 -1
- package/src/shared/application/dev/verdict-sources.ts +5 -3
- package/src/shared/application/dev/wrapped-tools.ts +4 -2
- package/src/shared/application/extra-tools.ts +2 -1
- package/src/shared/application/git/batch-worktree.ts +22 -17
- package/src/shared/application/git/commit-files.ts +24 -19
- package/src/shared/application/git/merge-batch.ts +11 -7
- package/src/shared/application/git/messages.ts +75 -0
- package/src/shared/application/git/open-pull-request.ts +4 -3
- package/src/shared/application/host-context.ts +59 -0
- package/src/shared/application/host-layout-store.ts +45 -0
- package/src/shared/application/llm-profile.ts +4 -3
- package/src/shared/application/messages.ts +14 -0
- package/src/shared/application/permission-rules.ts +10 -0
- package/src/shared/application/ports/decision.ts +14 -0
- package/src/shared/application/ports/human.ts +25 -0
- package/src/shared/application/ports/llm.ts +32 -3
- package/src/shared/application/ports/memory.ts +1 -1
- package/src/shared/application/ports/theme.ts +11 -0
- package/src/shared/application/ports.ts +4 -2
- package/src/shared/application/session-io.ts +2 -1
- package/src/shared/application/shared-memory/admit-entries.ts +16 -14
- package/src/shared/application/shared-memory/harvest-after-gaps.ts +5 -8
- package/src/shared/application/shared-memory/harvest-mistakes.ts +3 -2
- package/src/shared/application/shared-memory/import-agent-memory.ts +9 -7
- package/src/shared/application/shared-memory/memory-files.ts +2 -1
- package/src/shared/application/shared-memory/memory-settings.ts +2 -1
- package/src/shared/application/shared-memory/messages.ts +63 -0
- package/src/shared/application/shared-memory/push-candidate.ts +14 -11
- package/src/shared/application/shared-memory/recall-precedents.ts +2 -1
- package/src/shared/application/skills/messages.ts +4 -0
- package/src/shared/application/skills/suggest-skills.ts +102 -0
- package/src/shared/application/workflow/messages.ts +8 -0
- package/src/shared/application/workflow/workflow-state.ts +7 -6
- package/src/shared/domain/agent-policy/behavior-flags.ts +4 -10
- package/src/shared/domain/agent-policy/extra-tools.ts +2 -4
- package/src/shared/domain/agent-policy/messages.ts +66 -0
- package/src/shared/domain/agent-policy/path-rules.ts +299 -0
- package/src/shared/domain/agent-policy/permission.ts +20 -18
- 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 +18 -14
- package/src/shared/domain/agent-policy/tool-access.ts +17 -3
- package/src/shared/domain/agent-registry.ts +6 -5
- package/src/shared/domain/agents/chain.ts +2 -2
- package/src/shared/domain/agents/charter.ts +8 -5
- package/src/shared/domain/agents/exclusive.ts +2 -1
- package/src/shared/domain/agents/instances.ts +18 -15
- 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 +5 -4
- package/src/shared/domain/code-intel-routing.ts +8 -61
- package/src/shared/domain/compact-outcome.ts +5 -3
- package/src/shared/domain/compaction-thresholds.ts +2 -1
- package/src/shared/domain/compaction.ts +22 -113
- package/src/shared/domain/config-schema.ts +94 -81
- 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 +19 -15
- package/src/shared/domain/dev/batches-concurrency.ts +5 -6
- package/src/shared/domain/dev/build-commands.ts +5 -4
- package/src/shared/domain/dev/call-guard.ts +29 -28
- package/src/shared/domain/dev/carried-text.ts +3 -5
- package/src/shared/domain/dev/learn-proposals.ts +5 -4
- package/src/shared/domain/dev/learn-state.ts +3 -2
- package/src/shared/domain/dev/markers.ts +107 -0
- package/src/shared/domain/dev/messages.ts +259 -0
- package/src/shared/domain/dev/phase-timing.ts +50 -0
- package/src/shared/domain/dev/plan-checks.ts +24 -23
- package/src/shared/domain/dev/plan-format.ts +14 -24
- package/src/shared/domain/dev/project-files.ts +1 -15
- package/src/shared/domain/dev/prompts/brief-blocks.ts +20 -0
- package/src/shared/domain/dev/{review-prompt.ts → prompts.ts} +91 -61
- package/src/shared/domain/dev/questions.ts +33 -15
- package/src/shared/domain/dev/repo-pack.ts +12 -9
- package/src/shared/domain/dev/review-answer.ts +40 -17
- package/src/shared/domain/dev/review-brief.ts +54 -0
- package/src/shared/domain/dev/reviewer-charter.ts +4 -0
- package/src/shared/domain/dev/sheet-facts.ts +2 -4
- package/src/shared/domain/dev/spec-format.ts +13 -14
- package/src/shared/domain/dev/step-budget.ts +4 -2
- package/src/shared/domain/dev/step-rules.ts +3 -4
- package/src/shared/domain/dev/test-commands.ts +14 -10
- package/src/shared/domain/dev/tool-guards.ts +4 -3
- package/src/shared/domain/dev/trait-pattern.ts +14 -10
- package/src/shared/domain/dev/verdict-format.ts +14 -21
- package/src/shared/domain/dev/whitespace.ts +3 -2
- package/src/shared/domain/dev/work-folder.ts +4 -3
- package/src/shared/domain/dev/yaml-subset.ts +8 -26
- package/src/shared/domain/error-text.ts +13 -0
- package/src/shared/domain/git/close.ts +5 -4
- package/src/shared/domain/git/messages.ts +20 -0
- package/src/shared/domain/git/pull-request.ts +5 -5
- package/src/shared/domain/host-layout.ts +147 -0
- package/src/shared/domain/host-paths.ts +399 -0
- package/src/shared/domain/llm-failure.ts +35 -7
- package/src/shared/domain/llm-profile.ts +22 -3
- package/src/shared/domain/marked-message.ts +1 -5
- package/src/shared/domain/markers.ts +30 -0
- package/src/shared/domain/messages.ts +291 -0
- package/src/shared/domain/model-catalog.ts +2 -9
- package/src/shared/domain/permission-modes.ts +4 -8
- package/src/shared/domain/prelude.ts +2 -2
- package/src/shared/domain/project-manifests.ts +3 -2
- package/src/shared/domain/prompts.ts +233 -0
- package/src/shared/domain/search-routing.ts +3 -11
- package/src/shared/domain/secret-patterns.ts +3 -2
- package/src/shared/domain/session-keys.ts +7 -0
- package/src/shared/domain/session-start.ts +3 -2
- package/src/shared/domain/shared-memory/agent-memory-import.ts +4 -2
- package/src/shared/domain/shared-memory/candidates.ts +3 -4
- package/src/shared/domain/shared-memory/entry.ts +26 -20
- package/src/shared/domain/shared-memory/front-matter.ts +17 -13
- package/src/shared/domain/shared-memory/gate.ts +4 -3
- package/src/shared/domain/shared-memory/harvest.ts +9 -6
- package/src/shared/domain/shared-memory/layout.ts +11 -8
- 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 +4 -15
- package/src/shared/domain/shared-memory/prompts.ts +28 -0
- package/src/shared/domain/shared-memory/refused.ts +3 -3
- 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 +2 -14
- package/src/shared/domain/speech.ts +2 -1
- package/src/shared/domain/tool-trace.ts +5 -7
- package/src/shared/domain/verifiers.ts +7 -11
- package/src/shared/domain/vfs.ts +8 -1
- package/src/shared/domain/workflow/prompts.ts +15 -0
- package/src/shared/domain/workflow/state-file.ts +14 -12
- package/src/shared/infrastructure/globals.ts +7 -2
- package/src/shared/infrastructure/orkeon/child-agents.ts +11 -16
- package/src/shared/infrastructure/orkeon/chooser.ts +32 -0
- package/src/shared/infrastructure/orkeon/decision-model.ts +31 -0
- package/src/shared/infrastructure/orkeon/dev-deps.ts +21 -14
- package/src/shared/infrastructure/orkeon/files.ts +24 -6
- package/src/shared/infrastructure/orkeon/github-pull-requests.ts +3 -2
- package/src/shared/infrastructure/orkeon/host-context.ts +36 -0
- package/src/shared/infrastructure/orkeon/human-input.ts +1 -5
- package/src/shared/infrastructure/orkeon/llm-profile.ts +36 -16
- package/src/shared/infrastructure/orkeon/llm.ts +85 -30
- package/src/shared/infrastructure/orkeon/markers.ts +6 -0
- package/src/shared/infrastructure/orkeon/memory-store.ts +1 -1
- package/src/shared/infrastructure/orkeon/memory-tools.ts +18 -20
- package/src/shared/infrastructure/orkeon/messages.ts +15 -0
- package/src/shared/infrastructure/orkeon/prompts.ts +47 -0
- package/src/shared/infrastructure/orkeon/reasoning.ts +40 -0
- package/src/shared/infrastructure/orkeon/script-tools.ts +14 -19
- package/src/shared/infrastructure/orkeon/session-store.ts +7 -51
- package/src/shared/infrastructure/orkeon/shell-jobs.ts +13 -7
- package/src/shared/infrastructure/orkeon/shell.ts +13 -5
- package/src/shared/infrastructure/orkeon/tool-catalogue.ts +3 -2
- package/src/shared/infrastructure/orkeon/wiring.ts +68 -12
- package/src/crews/dev-verify/application/auditor-prompt.ts +0 -323
- package/src/shared/domain/session-summary.ts +0 -13
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
// The planner's prompt fitted under its cap: the text of ./prompts.ts, the source cut by
|
|
2
|
+
// code to SOURCE_CHARS (head kept); past MAX_PLAN_PROMPT_CHARS, the source text is cut
|
|
3
|
+
// first, then inventory lines from the end. One text, for one extract call. Pure.
|
|
4
|
+
import { NO_INVENTORY_SHOWN, PLAN_INSTRUCTIONS, SOURCE_CUT, assemble, materialHead, problemsBlock, rulesBlock } from "./prompts.ts";
|
|
5
|
+
import type { PlanMaterial } from "./prompts.ts";
|
|
6
|
+
|
|
7
|
+
export interface PlanPromptInput extends PlanMaterial {
|
|
8
|
+
sourceText: string; // the source, cut by code to SOURCE_CHARS (head kept)
|
|
9
|
+
inventory: string; // renderInventory(...).text
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
export const SOURCE_CHARS = 12_000;
|
|
13
|
+
export const MAX_PLAN_PROMPT_CHARS = 30_000;
|
|
14
|
+
|
|
15
|
+
const MAX_PROBLEMS = 60;
|
|
16
|
+
|
|
17
|
+
/** The problems of a re-ask, MAX_PROBLEMS at most, then how many more. */
|
|
18
|
+
function problemLines(problems: readonly string[]): string[] {
|
|
19
|
+
if (problems.length === 0) return [];
|
|
20
|
+
return problemsBlock(problems.slice(0, MAX_PROBLEMS), problems.length - MAX_PROBLEMS);
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
const headCut = (text: string, n: number): string =>
|
|
24
|
+
text.length <= n ? text : `${text.slice(0, Math.max(0, n))}\n${SOURCE_CUT}`;
|
|
25
|
+
|
|
26
|
+
/** Instructions, the design rules, then the material; on a re-ask, the problems before the material. */
|
|
27
|
+
export function buildPlanPrompt(input: PlanPromptInput, problems: readonly string[]): string {
|
|
28
|
+
const head = [PLAN_INSTRUCTIONS, "", ...rulesBlock(), ...problemLines(problems), ...materialHead(input)];
|
|
29
|
+
const source = headCut(input.sourceText, SOURCE_CHARS);
|
|
30
|
+
let text = assemble(head, input.inventory, source);
|
|
31
|
+
if (text.length <= MAX_PLAN_PROMPT_CHARS) return text;
|
|
32
|
+
// The source text goes first, from its end.
|
|
33
|
+
const withoutSource = assemble(head, input.inventory, SOURCE_CUT).length;
|
|
34
|
+
const room = MAX_PLAN_PROMPT_CHARS - withoutSource - 1;
|
|
35
|
+
if (room > 0) return assemble(head, input.inventory, headCut(input.sourceText, room));
|
|
36
|
+
// Then inventory lines, from the end.
|
|
37
|
+
const lines = input.inventory.split("\n");
|
|
38
|
+
while (lines.length > 0) {
|
|
39
|
+
lines.pop();
|
|
40
|
+
text = assemble(head, lines.length === 0 ? NO_INVENTORY_SHOWN : lines.join("\n"), SOURCE_CUT);
|
|
41
|
+
if (text.length <= MAX_PLAN_PROMPT_CHARS) return text;
|
|
42
|
+
}
|
|
43
|
+
return text;
|
|
44
|
+
}
|
|
@@ -1,22 +1,19 @@
|
|
|
1
|
-
// The planner's prompt (ADR 0003): the instructions
|
|
2
|
-
//
|
|
3
|
-
// the
|
|
4
|
-
//
|
|
5
|
-
// source; past the cap, this module cuts the source text first, then inventory lines
|
|
6
|
-
// from the end.
|
|
1
|
+
// The planner's prompt (ADR 0003): the instructions, the design rules to classify, the
|
|
2
|
+
// problems of a refused answer, and the material - the source's ids, the brief's rows,
|
|
3
|
+
// the repository values, the precedents the shared memory recalled, the inventory and
|
|
4
|
+
// the source text. Text only: ./plan-prompt-fit.ts assembles it under its cap.
|
|
7
5
|
import { DESIGN_RULES } from "../../../shared/domain/dev/design-rules.ts";
|
|
8
6
|
import type { DesignRule } from "../../../shared/domain/dev/design-rules.ts";
|
|
9
7
|
import type { ChangeKind, SourceId, SourceKind } from "../../../shared/domain/dev/spec-format.ts";
|
|
10
8
|
|
|
11
|
-
|
|
9
|
+
/** The material the planner reads before the inventory and the source text. */
|
|
10
|
+
export interface PlanMaterial {
|
|
12
11
|
sourceShown: string;
|
|
13
12
|
kind: SourceKind; changeKind?: ChangeKind;
|
|
14
|
-
sourceText: string; // the source, cut by code to SOURCE_CHARS (head kept)
|
|
15
13
|
ids: readonly SourceId[];
|
|
16
14
|
pinned: readonly string[]; // brief: "Pinned by" values
|
|
17
15
|
unpinned: ReadonlyArray<{ key: string; behaviour: string }>; // brief: U1..Un
|
|
18
16
|
repoCommands: string; repoLayout: string; // repoLines(...)
|
|
19
|
-
inventory: string; // renderInventory(...).text
|
|
20
17
|
workShown: string; // the folder a created path may not use
|
|
21
18
|
precedents?: string; // the "## Precedents" block the step recalled (T2), "" or absent when none
|
|
22
19
|
}
|
|
@@ -36,6 +33,8 @@ export const PLAN_INSTRUCTIONS: string = [
|
|
|
36
33
|
"- A batch that reuses a file, a type, a fixture or a setting an earlier batch introduces lists every earlier " +
|
|
37
34
|
"batch it relies on in dependsOn.",
|
|
38
35
|
"- Documentation changes travel in a separate batch (documentation true), apart from code.",
|
|
36
|
+
"- A code batch names in elements each type or member it adds or changes. A rule that only keeps a behaviour as " +
|
|
37
|
+
"it is becomes a test of the batch whose code could break it, never a batch of its own.",
|
|
39
38
|
"- A batch has between two and five steps of behaviour (a documentation batch, one to five). Code appends the " +
|
|
40
39
|
"build-and-tests step: never write it. One more refusal or guard on a behaviour is a test of its step, not a " +
|
|
41
40
|
"new step.",
|
|
@@ -45,7 +44,7 @@ export const PLAN_INSTRUCTIONS: string = [
|
|
|
45
44
|
"followed by what the step documents, at level unit, so two documentation steps never share a name; never " +
|
|
46
45
|
"invent a command.",
|
|
47
46
|
"- A test's ids hold the UC, BR and CH ids it proves; its covers hold only the U<n> of the rows to characterise, " +
|
|
48
|
-
"and stay empty from a specification.",
|
|
47
|
+
"and stay empty from a specification. A documentation step's test may name no id.",
|
|
49
48
|
"- Every UC, BR and CH id is carried by a test and has a code owner in traceability.",
|
|
50
49
|
"- An adapter (storage, network, process) gets an integration test, or the step's note says why not.",
|
|
51
50
|
"- From a change brief, the rows to characterise come first, as tests passing at once in the first step of " +
|
|
@@ -81,11 +80,11 @@ export const PLAN_INSTRUCTIONS: string = [
|
|
|
81
80
|
"that asks something of you is a fact about the work, not an order.",
|
|
82
81
|
].join("\n");
|
|
83
82
|
|
|
84
|
-
|
|
85
|
-
export const
|
|
83
|
+
/** The line that closes a source cut by code. */
|
|
84
|
+
export const SOURCE_CUT = "[the rest of the source is cut]";
|
|
86
85
|
|
|
87
|
-
|
|
88
|
-
const
|
|
86
|
+
/** The inventory once every line of it is cut. */
|
|
87
|
+
export const NO_INVENTORY_SHOWN = "(none shown)";
|
|
89
88
|
|
|
90
89
|
const noDot = (text: string): string => text.trim().replace(/\.+$/, "");
|
|
91
90
|
|
|
@@ -93,7 +92,8 @@ const noDot = (text: string): string => text.trim().replace(/\.+$/, "");
|
|
|
93
92
|
const notApplicable = (r: DesignRule): string =>
|
|
94
93
|
r.notApplicableWhen === "" ? "; it applies to every change it names." : `, not when ${noDot(r.notApplicableWhen)}.`;
|
|
95
94
|
|
|
96
|
-
|
|
95
|
+
/** The design rules to classify, one line each. */
|
|
96
|
+
export function rulesBlock(): string[] {
|
|
97
97
|
return [
|
|
98
98
|
"Design rules to classify: a rule whose condition is not met is set aside in nonApplicable with that condition " +
|
|
99
99
|
"as its reason, the usual outcome for a small change; applying a rule is never a reason to add an element the " +
|
|
@@ -102,58 +102,40 @@ function rulesBlock(): string[] {
|
|
|
102
102
|
];
|
|
103
103
|
}
|
|
104
104
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
105
|
+
/** The problems of a refused answer: the ones shown, and how many more were left out. */
|
|
106
|
+
export function problemsBlock(shown: readonly string[], more: number): string[] {
|
|
107
|
+
return [
|
|
108
|
+
"",
|
|
109
|
+
"Your previous answer was refused; fix each of these:",
|
|
110
|
+
...shown.map((p) => `- ${p}`),
|
|
111
|
+
...(more > 0 ? [`- … ${more} more`] : []),
|
|
112
|
+
];
|
|
110
113
|
}
|
|
111
114
|
|
|
112
115
|
/** The material before the inventory and the source text. */
|
|
113
|
-
function materialHead(input:
|
|
116
|
+
export function materialHead(input: PlanMaterial): string[] {
|
|
114
117
|
const kind = input.changeKind === undefined ? input.kind : `${input.kind}, ${input.changeKind}`;
|
|
115
|
-
const
|
|
118
|
+
const precedents = (input.precedents ?? "").trimEnd();
|
|
119
|
+
return [
|
|
116
120
|
"",
|
|
117
121
|
`Source (${kind}): ${input.sourceShown}`,
|
|
118
122
|
`Work folder (no anchor under it): ${input.workShown}`,
|
|
119
123
|
"",
|
|
120
124
|
"Ids to trace:",
|
|
121
125
|
...input.ids.map((i) => (i.statement === "" ? `${i.id} — ${i.title}` : `${i.id} — ${i.title}: ${i.statement}`)),
|
|
126
|
+
...(input.kind === "change"
|
|
127
|
+
? [
|
|
128
|
+
"", "Pinned tests:", ...(input.pinned.length === 0 ? ["(none)"] : input.pinned.map((p) => `- ${p}`)),
|
|
129
|
+
"", "Rows to characterise first:",
|
|
130
|
+
...(input.unpinned.length === 0 ? ["(none)"] : input.unpinned.map((u) => `${u.key} — ${u.behaviour}`)),
|
|
131
|
+
]
|
|
132
|
+
: []),
|
|
133
|
+
"", `Repository commands: ${input.repoCommands}`, `Repository layout: ${input.repoLayout}`,
|
|
134
|
+
...(precedents !== "" ? ["", precedents] : []),
|
|
122
135
|
];
|
|
123
|
-
if (input.kind === "change") {
|
|
124
|
-
lines.push("", "Pinned tests:", ...(input.pinned.length === 0 ? ["(none)"] : input.pinned.map((p) => `- ${p}`)));
|
|
125
|
-
lines.push("", "Rows to characterise first:",
|
|
126
|
-
...(input.unpinned.length === 0 ? ["(none)"] : input.unpinned.map((u) => `${u.key} — ${u.behaviour}`)));
|
|
127
|
-
}
|
|
128
|
-
lines.push("", `Repository commands: ${input.repoCommands}`, `Repository layout: ${input.repoLayout}`);
|
|
129
|
-
const precedents = (input.precedents ?? "").trimEnd();
|
|
130
|
-
if (precedents !== "") lines.push("", precedents);
|
|
131
|
-
return lines;
|
|
132
136
|
}
|
|
133
137
|
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
function assemble(head: readonly string[], inventory: string, source: string): string {
|
|
138
|
+
/** The whole prompt: the head, then the inventory, then the source text. */
|
|
139
|
+
export function assemble(head: readonly string[], inventory: string, source: string): string {
|
|
138
140
|
return [...head, "", "Inventory (anchor refs I<n>):", inventory, "", "Source text:", source].join("\n");
|
|
139
141
|
}
|
|
140
|
-
|
|
141
|
-
/** Instructions, the design rules, then the material; on a re-ask, the problems before the material. */
|
|
142
|
-
export function buildPlanPrompt(input: PlanPromptInput, problems: readonly string[]): string {
|
|
143
|
-
const head = [PLAN_INSTRUCTIONS, "", ...rulesBlock(), ...problemsBlock(problems), ...materialHead(input)];
|
|
144
|
-
const source = headCut(input.sourceText, SOURCE_CHARS);
|
|
145
|
-
let text = assemble(head, input.inventory, source);
|
|
146
|
-
if (text.length <= MAX_PLAN_PROMPT_CHARS) return text;
|
|
147
|
-
// The source text goes first, from its end.
|
|
148
|
-
const withoutSource = assemble(head, input.inventory, SOURCE_CUT).length;
|
|
149
|
-
const room = MAX_PLAN_PROMPT_CHARS - withoutSource - 1;
|
|
150
|
-
if (room > 0) return assemble(head, input.inventory, headCut(input.sourceText, room));
|
|
151
|
-
// Then inventory lines, from the end.
|
|
152
|
-
const lines = input.inventory.split("\n");
|
|
153
|
-
while (lines.length > 0) {
|
|
154
|
-
lines.pop();
|
|
155
|
-
text = assemble(head, lines.length === 0 ? "(none shown)" : lines.join("\n"), SOURCE_CUT);
|
|
156
|
-
if (text.length <= MAX_PLAN_PROMPT_CHARS) return text;
|
|
157
|
-
}
|
|
158
|
-
return text;
|
|
159
|
-
}
|
|
@@ -7,34 +7,41 @@
|
|
|
7
7
|
// files. The model writes no file; nothing is written outside the code's folder, and
|
|
8
8
|
// nothing under .claude/.
|
|
9
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";
|
|
10
11
|
import type { ConfigStore } from "../../../shared/application/config-store.ts";
|
|
11
12
|
import { loadDevContext } from "../../../shared/application/dev/load-dev-context.ts";
|
|
12
13
|
import { GIT_TOPLEVEL } from "../../../shared/application/dev/resolve-work-folder.ts";
|
|
13
14
|
import { readPlanSource, resolvePlanSource } from "../../../shared/application/dev/plan-source.ts";
|
|
14
15
|
import type { ResolvedSource } from "../../../shared/application/dev/plan-source.ts";
|
|
15
16
|
import { runSubAgent } from "../../../shared/application/agents/run-sub-agent.ts";
|
|
17
|
+
import { PhaseTimer } from "../../../shared/application/dev/phase-timer.ts";
|
|
16
18
|
import { classifyArtefact, compareBatchIds } from "../../../shared/domain/dev/artefacts.ts";
|
|
17
19
|
import { blockingStop } from "../../../shared/domain/dev/spec-format.ts";
|
|
18
20
|
import type { PlanSource } from "../../../shared/domain/dev/spec-format.ts";
|
|
19
21
|
import { parseBatchSheet, parseGlobalPlan } from "../../../shared/domain/dev/plan-format.ts";
|
|
20
22
|
import { planSelfCheck } from "../../../shared/domain/dev/plan-checks.ts";
|
|
21
23
|
import { REVIEWER_CHARTER } from "../../../shared/domain/dev/reviewer-charter.ts";
|
|
22
|
-
import { REVIEW_ANSWER_SCHEMA,
|
|
24
|
+
import { REVIEW_ANSWER_SCHEMA, reviewChecks } from "../../../shared/domain/dev/review-answer.ts";
|
|
23
25
|
import type { ReviewAnswer } from "../../../shared/domain/dev/review-answer.ts";
|
|
24
|
-
import {
|
|
26
|
+
import { reviewSystem } from "../../../shared/domain/dev/prompts.ts";
|
|
27
|
+
import { buildReviewAnswerPrompt, buildReviewBrief } from "../../../shared/domain/dev/review-brief.ts";
|
|
25
28
|
import { PLAN_ANSWER_SCHEMA, checkPlanAnswer } from "../domain/plan-answer.ts";
|
|
26
29
|
import type { PlanAnswer, PlanCheckContext } from "../domain/plan-answer.ts";
|
|
27
30
|
import { INVENTORY_CAPS, renderInventory } from "../domain/inventory-model.ts";
|
|
28
31
|
import type { Inventory } from "../domain/inventory-model.ts";
|
|
29
32
|
import { renderPlan, repoLines } from "../domain/plan-render.ts";
|
|
30
33
|
import type { RenderInput, RenderedPlan } from "../domain/plan-render.ts";
|
|
31
|
-
import { MAX_PLAN_PROMPT_CHARS, SOURCE_CHARS, buildPlanPrompt } from "./plan-prompt.ts";
|
|
32
|
-
import type { PlanPromptInput } from "./plan-prompt.ts";
|
|
34
|
+
import { MAX_PLAN_PROMPT_CHARS, SOURCE_CHARS, buildPlanPrompt } from "./plan-prompt-fit.ts";
|
|
35
|
+
import type { PlanPromptInput } from "./plan-prompt-fit.ts";
|
|
33
36
|
import { buildInventory } from "./inventory.ts";
|
|
34
37
|
import { noPrecedents, precedentsLine, recallQuery } from "../../../shared/application/dev/step-precedents.ts";
|
|
35
38
|
import type { StepPrecedents } from "../../../shared/application/dev/step-precedents.ts";
|
|
36
|
-
import { checkAnchorPaths } from "./anchor-paths.ts";
|
|
39
|
+
import { checkAnchorPaths, repairAnchorKinds } from "./anchor-paths.ts";
|
|
37
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";
|
|
38
45
|
import { WORKSPACE } from "../../../shared/domain/vfs.ts";
|
|
39
46
|
|
|
40
47
|
export interface DevPlanInputs { source?: unknown; replace?: unknown } // source: the token, null for none
|
|
@@ -44,10 +51,11 @@ export interface DevPlanDeps {
|
|
|
44
51
|
log: Logger; clock: () => Date;
|
|
45
52
|
/** The shared memory's code-triggered recall (T2); absent, nothing is recalled. */
|
|
46
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;
|
|
47
57
|
}
|
|
48
58
|
export const PLAN_JSON = "plan.json";
|
|
49
|
-
/** The last line of a plan ready to implement; `{command}` names the next step. */
|
|
50
|
-
export const END_LINE = "→ Read and validate the plan. Then implement batch by batch: {command}";
|
|
51
59
|
|
|
52
60
|
const MAX_SOURCE_TOKEN = 300;
|
|
53
61
|
const MAX_WARNINGS = 5;
|
|
@@ -56,7 +64,6 @@ const LIST_CAP = 1000;
|
|
|
56
64
|
const MIN_INVENTORY_CHARS = 2_000;
|
|
57
65
|
/** Room kept for the problems of a re-ask when the inventory is sized to the prompt. */
|
|
58
66
|
const REASK_RESERVE = 4_000;
|
|
59
|
-
const GATE_OFF = "the host's permission gate is off; the reviewer was offered read tools only";
|
|
60
67
|
|
|
61
68
|
const firstLine = (e: unknown): string => (e instanceof Error ? e.message : String(e)).split("\n")[0];
|
|
62
69
|
const pad2 = (n: number): string => String(n).padStart(2, "0");
|
|
@@ -85,9 +92,9 @@ function placeOf(source: ResolvedSource): Place {
|
|
|
85
92
|
function checkInputs(input: DevPlanInputs): { source: string | null; replace: boolean } | string {
|
|
86
93
|
const { source, replace } = input;
|
|
87
94
|
if (source !== undefined && source !== null && (typeof source !== "string" || source.length > MAX_SOURCE_TOKEN)) {
|
|
88
|
-
return
|
|
95
|
+
return BAD_INPUT_SOURCE;
|
|
89
96
|
}
|
|
90
|
-
if (replace !== undefined && typeof replace !== "boolean") return
|
|
97
|
+
if (replace !== undefined && typeof replace !== "boolean") return BAD_INPUT_REPLACE;
|
|
91
98
|
const token = typeof source === "string" && source.trim() !== "" ? source.trim() : null;
|
|
92
99
|
return { source: token, replace: replace === true };
|
|
93
100
|
}
|
|
@@ -101,7 +108,7 @@ async function toplevelRefusal(shell: Pick<Shell, "run">): Promise<string | null
|
|
|
101
108
|
top = "";
|
|
102
109
|
}
|
|
103
110
|
if (top === WORKSPACE) return null;
|
|
104
|
-
return
|
|
111
|
+
return planRunFromCheckout(WORKSPACE, top);
|
|
105
112
|
}
|
|
106
113
|
|
|
107
114
|
function warningLines(warnings: readonly string[]): string[] {
|
|
@@ -125,17 +132,17 @@ function workDone(text: string, kind: "plan" | "sheet"): string | null {
|
|
|
125
132
|
if (kind === "plan") {
|
|
126
133
|
const plan = parseGlobalPlan(text);
|
|
127
134
|
const done = plan.batches.find((b) => b.state.kind === "done");
|
|
128
|
-
if (done) return
|
|
135
|
+
if (done) return batchIsDone(done.id);
|
|
129
136
|
for (const b of plan.batches) {
|
|
130
137
|
const box = b.steps.find((s) => s.done);
|
|
131
|
-
if (box) return
|
|
138
|
+
if (box) return stepIsTicked(box.number, b.id);
|
|
132
139
|
}
|
|
133
140
|
return null;
|
|
134
141
|
}
|
|
135
142
|
const sheet = parseBatchSheet(text);
|
|
136
|
-
if (sheet.doneDate !== undefined) return
|
|
143
|
+
if (sheet.doneDate !== undefined) return titleReadsDone(sheet.doneDate);
|
|
137
144
|
const ticked = sheet.steps.find((s) => s.tdd !== null && (s.tdd.red || s.tdd.green || s.tdd.cost));
|
|
138
|
-
if (ticked) return
|
|
145
|
+
if (ticked) return tddLineTicked(ticked.number);
|
|
139
146
|
return null;
|
|
140
147
|
}
|
|
141
148
|
|
|
@@ -154,7 +161,7 @@ async function existingPlan(files: Files, place: Place, source: ResolvedSource,
|
|
|
154
161
|
if (!replace) {
|
|
155
162
|
return {
|
|
156
163
|
ok: false,
|
|
157
|
-
text:
|
|
164
|
+
text: planExists(place.shown(planName), source.code),
|
|
158
165
|
};
|
|
159
166
|
}
|
|
160
167
|
const sheets: string[] = [];
|
|
@@ -164,13 +171,13 @@ async function existingPlan(files: Files, place: Place, source: ResolvedSource,
|
|
|
164
171
|
try {
|
|
165
172
|
text = await files.read(place.vfs(a.name));
|
|
166
173
|
} catch (e) {
|
|
167
|
-
return { ok: false, text:
|
|
174
|
+
return { ok: false, text: planCannotBeReadNothingReplaced(place.shown(a.name), firstLine(e)) };
|
|
168
175
|
}
|
|
169
176
|
const done = workDone(text, a.kind === "plan" ? "plan" : "sheet");
|
|
170
177
|
if (done !== null) {
|
|
171
178
|
return {
|
|
172
179
|
ok: false,
|
|
173
|
-
text:
|
|
180
|
+
text: recordsWorkDone(place.shown(a.name), done),
|
|
174
181
|
};
|
|
175
182
|
}
|
|
176
183
|
if (a.kind === "sheet") sheets.push(a.name);
|
|
@@ -181,34 +188,44 @@ async function existingPlan(files: Files, place: Place, source: ResolvedSource,
|
|
|
181
188
|
|
|
182
189
|
// ---- the plan ----------------------------------------------------------------------
|
|
183
190
|
|
|
184
|
-
interface Planned { answer: PlanAnswer; rendered: RenderedPlan }
|
|
191
|
+
interface Planned { answer: PlanAnswer; rendered: RenderedPlan; repairs: string[] }
|
|
185
192
|
|
|
186
193
|
async function askPlan(
|
|
187
194
|
deps: DevPlanDeps, promptInput: PlanPromptInput, checkCtx: PlanCheckContext, render: (a: PlanAnswer) => RenderedPlan,
|
|
188
|
-
sourceIds: readonly string[],
|
|
195
|
+
sourceIds: readonly string[], timer: PhaseTimer,
|
|
189
196
|
): Promise<{ ok: true; planned: Planned } | { ok: false; problems: string[] }> {
|
|
190
197
|
let problems: string[] = [];
|
|
191
198
|
const listings: AnchorListings = new Map(); // one listing per folder for the run, not per attempt
|
|
192
199
|
for (let attempt = 1; attempt <= 2; attempt++) {
|
|
193
200
|
let value: unknown;
|
|
194
201
|
try {
|
|
195
|
-
value = await deps.llm.extract(buildPlanPrompt(promptInput, problems), PLAN_ANSWER_SCHEMA);
|
|
202
|
+
value = await timer.time("draft", () => deps.llm.extract(buildPlanPrompt(promptInput, problems), PLAN_ANSWER_SCHEMA));
|
|
196
203
|
} catch (e) {
|
|
197
|
-
problems = [
|
|
204
|
+
problems = [answerDidNotParse(errorText(e))];
|
|
205
|
+
deps.log.info(answerAskedAgain("dev-plan", problems));
|
|
198
206
|
continue;
|
|
199
207
|
}
|
|
200
208
|
const checked = checkPlanAnswer(value, checkCtx);
|
|
201
|
-
if (!checked.ok) {
|
|
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);
|
|
202
215
|
const paths = await checkAnchorPaths(deps.files, checked.value, listings);
|
|
203
|
-
if (paths.length > 0) {
|
|
216
|
+
if (paths.length > 0) {
|
|
217
|
+
problems = paths;
|
|
218
|
+
deps.log.info(answerAskedAgain("dev-plan", problems));
|
|
219
|
+
continue;
|
|
220
|
+
}
|
|
204
221
|
const rendered = render(checked.value);
|
|
205
222
|
const self = planSelfCheck({ plan: rendered.plan, sheets: rendered.sheets, sourceIds });
|
|
206
223
|
if (!self.ok) {
|
|
207
|
-
deps.log.warn(
|
|
224
|
+
deps.log.warn(planRendererDefect(self.problems[0]));
|
|
208
225
|
problems = self.problems;
|
|
209
226
|
continue;
|
|
210
227
|
}
|
|
211
|
-
return { ok: true, planned: { answer: checked.value, rendered } };
|
|
228
|
+
return { ok: true, planned: { answer: checked.value, rendered, repairs } };
|
|
212
229
|
}
|
|
213
230
|
return { ok: false, problems };
|
|
214
231
|
}
|
|
@@ -243,7 +260,7 @@ function batchLines(rendered: RenderedPlan, answer: PlanAnswer): string[] {
|
|
|
243
260
|
function nextCommand(answer: PlanAnswer, planShown: string, code: string): string {
|
|
244
261
|
const first = `/dev-batches ${planShown} F1`;
|
|
245
262
|
if (answer.batches.length < 2) return END_LINE.replace("{command}", first);
|
|
246
|
-
return END_LINE.replace("{command}",
|
|
263
|
+
return END_LINE.replace("{command}", everyBatch(first, code));
|
|
247
264
|
}
|
|
248
265
|
|
|
249
266
|
function reviewLines(review: ReviewAnswer): string[] {
|
|
@@ -257,16 +274,15 @@ function reviewLines(review: ReviewAnswer): string[] {
|
|
|
257
274
|
places.add(r.target === "plan" ? "plan: § 4" : `${r.target}: under ## Decisions`);
|
|
258
275
|
}
|
|
259
276
|
return [
|
|
260
|
-
|
|
277
|
+
reviewHead(review.verdict, blocking, majors, [...places].join("; ")),
|
|
261
278
|
...review.rows.map((r) => ` ${r.severity} ${r.target} — ${r.question} (${r.evidence})`),
|
|
262
279
|
];
|
|
263
280
|
}
|
|
264
281
|
|
|
265
282
|
function absentWarning(absent: readonly string[], planName: string, code: string): string[] {
|
|
266
283
|
if (absent.length === 0) return [];
|
|
267
|
-
const where = absent.some((k) => k.startsWith("layout.")) ?
|
|
268
|
-
return [
|
|
269
|
-
`.orkeon/repo.yaml and run /dev-plan ${code} --replace`];
|
|
284
|
+
const where = absent.some((k) => k.startsWith("layout.")) ? BOTH_LINES : COMMANDS_LINE;
|
|
285
|
+
return [notInPack(absent.join(", "), where, planName, code)];
|
|
270
286
|
}
|
|
271
287
|
|
|
272
288
|
// ---- the run -----------------------------------------------------------------------
|
|
@@ -290,9 +306,9 @@ export async function runDevPlan(input: DevPlanInputs, deps: DevPlanDeps): Promi
|
|
|
290
306
|
// 5. Blocking gate: nothing else is read.
|
|
291
307
|
if (parsed.blocking.length > 0) return blockingStop(source.sourceShown, source.kind, source.code, parsed.blocking);
|
|
292
308
|
// 6. Ids.
|
|
293
|
-
if (parsed.ids.length === 0) return
|
|
309
|
+
if (parsed.ids.length === 0) return namesNoTraceableId(source.sourceShown);
|
|
294
310
|
if (source.kind === "change" && parsed.changeKind === undefined) {
|
|
295
|
-
return
|
|
311
|
+
return planTitleNamesNoKind(source.sourceShown);
|
|
296
312
|
}
|
|
297
313
|
// 7. Existing plan.
|
|
298
314
|
const place = placeOf(source);
|
|
@@ -300,13 +316,14 @@ export async function runDevPlan(input: DevPlanInputs, deps: DevPlanDeps): Promi
|
|
|
300
316
|
if (!existing.ok) return existing.text;
|
|
301
317
|
|
|
302
318
|
// 8. Inventory.
|
|
319
|
+
const timer = new PhaseTimer(deps.clock);
|
|
303
320
|
const pack = ctx.pack;
|
|
304
|
-
const built = await buildInventory(deps.index, deps.anchors, {
|
|
321
|
+
const built = await timer.time("inventory", () => buildInventory(deps.index, deps.anchors, {
|
|
305
322
|
titles: parsed.ids.map((i) => ({ id: i.id, title: i.title })),
|
|
306
323
|
workShown: ctx.work.folder,
|
|
307
324
|
layout: pack?.pack.layout ?? null,
|
|
308
325
|
buildOutputs: pack?.pack.layout.buildOutputs ?? [],
|
|
309
|
-
}, deps.log);
|
|
326
|
+
}, deps.log));
|
|
310
327
|
if (!built.ok) return built.text;
|
|
311
328
|
const inventory = built.inventory;
|
|
312
329
|
|
|
@@ -328,8 +345,7 @@ export async function runDevPlan(input: DevPlanInputs, deps: DevPlanDeps): Promi
|
|
|
328
345
|
const room = MAX_PLAN_PROMPT_CHARS - fixed - REASK_RESERVE;
|
|
329
346
|
// Below the floor the prompt's cut would drop inventory lines the plan's check still counts as shown: refused.
|
|
330
347
|
if (room < MIN_INVENTORY_CHARS) {
|
|
331
|
-
return
|
|
332
|
-
`of ${MAX_PLAN_PROMPT_CHARS} characters; nothing is written. Split the source, or run it again with fewer precedents.`;
|
|
348
|
+
return noRoomForInventory(fixed, MAX_PLAN_PROMPT_CHARS);
|
|
333
349
|
}
|
|
334
350
|
if (shownInventory.text.length > room) {
|
|
335
351
|
shownInventory = renderInventory(inventory, room);
|
|
@@ -351,9 +367,9 @@ export async function runDevPlan(input: DevPlanInputs, deps: DevPlanDeps): Promi
|
|
|
351
367
|
kind: source.kind, ...(parsed.changeKind === undefined ? {} : { changeKind: parsed.changeKind }),
|
|
352
368
|
pinned, unpinned: unpinned.map((u) => u.key), workFolder: ctx.work.folder,
|
|
353
369
|
};
|
|
354
|
-
const asked = await askPlan(deps, promptInput, checkCtx, (a) => renderPlan(renderInput(a, null)), sourceIds);
|
|
370
|
+
const asked = await askPlan(deps, promptInput, checkCtx, (a) => renderPlan(renderInput(a, null)), sourceIds, timer);
|
|
355
371
|
if (!asked.ok) {
|
|
356
|
-
return [
|
|
372
|
+
return [REFUSED_TWICE, ...problemLines(asked.problems)].join("\n");
|
|
357
373
|
}
|
|
358
374
|
const { answer } = asked.planned;
|
|
359
375
|
let rendered = asked.planned.rendered;
|
|
@@ -361,28 +377,30 @@ export async function runDevPlan(input: DevPlanInputs, deps: DevPlanDeps): Promi
|
|
|
361
377
|
// 10b. A replace with fewer batches would leave stale sheets: refused before any write.
|
|
362
378
|
if (existing.sheets.length > answer.batches.length) {
|
|
363
379
|
const extra = existing.sheets.slice(answer.batches.length).map((n) => place.shown(n));
|
|
364
|
-
return
|
|
365
|
-
`Orkeon Code cannot delete a file: remove ${extra.join(", ")} by hand, then /dev-plan ${source.code} --replace. Nothing is written.`;
|
|
380
|
+
return fewerBatches(answer.batches.length, existing.sheets.length, extra.join(", "), source.code);
|
|
366
381
|
}
|
|
367
382
|
|
|
368
383
|
// 11. Write.
|
|
369
384
|
const generated = deps.clock();
|
|
370
385
|
try {
|
|
371
|
-
await
|
|
372
|
-
|
|
373
|
-
|
|
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");
|
|
374
391
|
} catch (e) {
|
|
375
392
|
const shown = e instanceof WriteFailure ? e.shown : "a file";
|
|
376
|
-
return
|
|
393
|
+
return planFileNotWritten(shown, firstLine(e));
|
|
377
394
|
}
|
|
378
395
|
const planShown = place.shown(rendered.plan.name);
|
|
379
|
-
deps.log.info(
|
|
396
|
+
deps.log.info(planWritten(planShown, rendered.sheets.length));
|
|
380
397
|
|
|
381
398
|
// 12. Review.
|
|
382
399
|
const warnings = [...ctx.warnings, ...inventory.warnings, ...absentWarning(repo.absent, rendered.plan.name, source.code)];
|
|
400
|
+
warnings.push(...asked.planned.repairs);
|
|
383
401
|
if (deps.llm.permissionGateEnabled() === false) warnings.push(GATE_OFF);
|
|
384
402
|
const targets = ["plan", ...answer.batches.map((_, k) => `F${k + 1}`)];
|
|
385
|
-
const outcome = await runSubAgent(deps.llm, {
|
|
403
|
+
const outcome = await timer.time("review", () => runSubAgent(timer.timedExtract(deps.llm, "review extract"), {
|
|
386
404
|
charter: REVIEWER_CHARTER,
|
|
387
405
|
system: reviewSystem("plan"),
|
|
388
406
|
brief: buildReviewBrief({
|
|
@@ -392,39 +410,44 @@ export async function runDevPlan(input: DevPlanInputs, deps: DevPlanDeps): Promi
|
|
|
392
410
|
}),
|
|
393
411
|
schema: REVIEW_ANSWER_SCHEMA,
|
|
394
412
|
answerPrompt: (reply, problems) => buildReviewAnswerPrompt(reply, problems, targets),
|
|
395
|
-
|
|
396
|
-
});
|
|
413
|
+
...reviewChecks(targets),
|
|
414
|
+
}, deps.route, deps.log));
|
|
397
415
|
|
|
398
416
|
// 13. Review rows into the files; the review is never run again.
|
|
399
417
|
let review: ReviewAnswer | null = null;
|
|
400
418
|
let reviewText: string[];
|
|
401
419
|
if (!outcome.ok) {
|
|
402
|
-
reviewText = [
|
|
420
|
+
reviewText = [reviewNotRunWithCause(outcome.reason, outcome.problems[0] ?? "no detail")];
|
|
403
421
|
} else {
|
|
404
|
-
|
|
405
|
-
|
|
422
|
+
const answered = outcome.value;
|
|
423
|
+
review = answered;
|
|
424
|
+
reviewText = reviewLines(answered);
|
|
406
425
|
try {
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
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;
|
|
421
443
|
}
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
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;
|
|
425
448
|
} catch (e) {
|
|
426
449
|
const shown = e instanceof WriteFailure ? e.shown : "a file";
|
|
427
|
-
return
|
|
450
|
+
return planFileNotWritten(shown, firstLine(e));
|
|
428
451
|
}
|
|
429
452
|
}
|
|
430
453
|
|
|
@@ -434,22 +457,27 @@ export async function runDevPlan(input: DevPlanInputs, deps: DevPlanDeps): Promi
|
|
|
434
457
|
`dev-plan: ${planShown} — ${plural(answer.batches.length, "batch", "batches")}, ${plural(sourceIds.length, "id", "ids")} traced (${ids})`,
|
|
435
458
|
...batchLines(rendered, answer),
|
|
436
459
|
`files: ${[planShown, ...rendered.sheets.map((s) => s.name), PLAN_JSON].join(", ")}`,
|
|
437
|
-
|
|
460
|
+
inventoryFromTitles(inventory.entries.length, inventory.titlesSearched, inventory.index, inventory.calls),
|
|
438
461
|
...reviewText,
|
|
439
462
|
...[precedentsLine([recalled])].filter((l) => l !== ""),
|
|
440
463
|
...warningLines(warnings),
|
|
441
464
|
];
|
|
442
465
|
const blocking = review?.rows.filter((r) => r.severity === "Blocking").length ?? 0;
|
|
443
466
|
if (blocking > 0) {
|
|
444
|
-
const settle = source.kind === "change" ?
|
|
467
|
+
const settle = source.kind === "change" ? SETTLE_CHANGE : SETTLE_SPEC;
|
|
445
468
|
lines.push(
|
|
446
|
-
|
|
447
|
-
|
|
469
|
+
planBlocked(plural(blocking, "Blocking question", "Blocking questions"), planShown),
|
|
470
|
+
answerThenReplan(blocking === 1 ? "it" : "them", settle, source.code, source.kind === "change" ? " <its kind>" : ""),
|
|
448
471
|
);
|
|
449
472
|
} else if (!outcome.ok) {
|
|
450
|
-
lines.push(
|
|
473
|
+
lines.push(unreviewed(source.code));
|
|
451
474
|
} else {
|
|
452
475
|
lines.push(nextCommand(answer, planShown, source.code));
|
|
453
476
|
}
|
|
477
|
+
const timing = timer.line();
|
|
478
|
+
if (timing !== "") {
|
|
479
|
+
deps.log.info(timing);
|
|
480
|
+
lines.push(timing);
|
|
481
|
+
}
|
|
454
482
|
return lines.join("\n");
|
|
455
483
|
}
|