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,94 @@
|
|
|
1
|
+
// The shared memory's settings as they apply to a run: the folder (memory.dir), the project
|
|
2
|
+
// (memory.project, else the origin remote's name, else "local", as /dev-learn names it) and
|
|
3
|
+
// whether an audited candidate is admitted without asking (memory.autoAdmitAudited). A stored
|
|
4
|
+
// value is checked again here, since the config store hands back what the file holds: an invalid
|
|
5
|
+
// one falls back to the default with a warning, it never stops the caller.
|
|
6
|
+
|
|
7
|
+
import type { ConfigStore } from "../config-store.ts";
|
|
8
|
+
import type { Shell } from "../ports.ts";
|
|
9
|
+
import { projectFromRemote } from "../../domain/shared-memory/refused.ts";
|
|
10
|
+
import {
|
|
11
|
+
DEFAULT_MEMORY_DIR, MEMORY_AUTO_ADMIT_CONFIG_KEY, MEMORY_DIR_CONFIG_KEY, MEMORY_PROJECT_CONFIG_KEY, checkMemoryDir,
|
|
12
|
+
memoryCollection, memoryLayout, memoryProjectProblem,
|
|
13
|
+
} from "../../domain/shared-memory/layout.ts";
|
|
14
|
+
import type { MemoryLayout } from "../../domain/shared-memory/layout.ts";
|
|
15
|
+
import { memoryDirSetAside } from "./messages.ts";
|
|
16
|
+
|
|
17
|
+
export const GIT_REMOTE_ORIGIN = "git remote get-url origin";
|
|
18
|
+
export const LOCAL_PROJECT = "local";
|
|
19
|
+
|
|
20
|
+
export interface MemorySettings {
|
|
21
|
+
/** memory.dir, relative to the project. */
|
|
22
|
+
dir: string;
|
|
23
|
+
layout: MemoryLayout;
|
|
24
|
+
project: string;
|
|
25
|
+
collection: string;
|
|
26
|
+
autoAdmitAudited: boolean;
|
|
27
|
+
/** What was set aside, one line each. */
|
|
28
|
+
warnings: string[];
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
async function stdoutOf(shell: Pick<Shell, "run">, command: string): Promise<string | null> {
|
|
32
|
+
try {
|
|
33
|
+
const result = await shell.run(command);
|
|
34
|
+
return result.exitCode === 0 ? result.stdout.trim() : null;
|
|
35
|
+
} catch {
|
|
36
|
+
return null;
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
async function valueOf(config: Pick<ConfigStore, "readValue">, key: string): Promise<string | undefined> {
|
|
41
|
+
try {
|
|
42
|
+
return (await config.readValue(key)).value;
|
|
43
|
+
} catch {
|
|
44
|
+
return undefined;
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
const validProject = (name: string | null): string | null =>
|
|
49
|
+
name !== null && memoryProjectProblem(name) === undefined ? name : null;
|
|
50
|
+
|
|
51
|
+
/** The project name when memory.project is unset: the origin remote's, else "local". Not the checkout's
|
|
52
|
+
* folder: in the container it is always /workspace. */
|
|
53
|
+
export async function defaultProject(shell: Pick<Shell, "run">): Promise<string> {
|
|
54
|
+
const remote = await stdoutOf(shell, GIT_REMOTE_ORIGIN);
|
|
55
|
+
return validProject(remote === null || remote === "" ? null : projectFromRemote(remote)) ?? LOCAL_PROJECT;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** memory.dir as it applies, relative to the project, and the line saying a stored value was set aside. */
|
|
59
|
+
export async function readMemoryDir(config: Pick<ConfigStore, "readValue">): Promise<{ dir: string; warning?: string }> {
|
|
60
|
+
const raw = await valueOf(config, MEMORY_DIR_CONFIG_KEY);
|
|
61
|
+
if (raw === undefined) return { dir: DEFAULT_MEMORY_DIR };
|
|
62
|
+
const check = checkMemoryDir(raw);
|
|
63
|
+
return check.ok ? { dir: check.dir } : { dir: DEFAULT_MEMORY_DIR, warning: memoryDirSetAside(MEMORY_DIR_CONFIG_KEY, raw, check.reason, DEFAULT_MEMORY_DIR) };
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/** memory.dir as the guards read it: the folder alone, the warning left to the commands that print it. */
|
|
67
|
+
export function memoryDirOf(config: Pick<ConfigStore, "readValue">): () => Promise<string> {
|
|
68
|
+
return async () => (await readMemoryDir(config)).dir;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/** The refused motifs' file of the shared memory, relative to the project: refused.md under memory.dir. */
|
|
72
|
+
export async function readRefusedFile(config: Pick<ConfigStore, "readValue">): Promise<string> {
|
|
73
|
+
return `${(await readMemoryDir(config)).dir}/refused.md`;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
export async function readMemorySettings(
|
|
77
|
+
deps: { config: Pick<ConfigStore, "readValue">; shell: Pick<Shell, "run"> },
|
|
78
|
+
): Promise<MemorySettings> {
|
|
79
|
+
const read = await readMemoryDir(deps.config);
|
|
80
|
+
const warnings: string[] = read.warning === undefined ? [] : [read.warning];
|
|
81
|
+
const dir = read.dir;
|
|
82
|
+
const rawProject = await valueOf(deps.config, MEMORY_PROJECT_CONFIG_KEY);
|
|
83
|
+
let project: string | null = null;
|
|
84
|
+
if (rawProject !== undefined) {
|
|
85
|
+
project = validProject(rawProject);
|
|
86
|
+
if (project === null) warnings.push(`${MEMORY_PROJECT_CONFIG_KEY} '${rawProject}' set aside (${memoryProjectProblem(rawProject)})`);
|
|
87
|
+
}
|
|
88
|
+
project ??= await defaultProject(deps.shell);
|
|
89
|
+
const auto = await valueOf(deps.config, MEMORY_AUTO_ADMIT_CONFIG_KEY);
|
|
90
|
+
return {
|
|
91
|
+
dir, layout: memoryLayout(dir), project, collection: memoryCollection(project),
|
|
92
|
+
autoAdmitAudited: auto === "true", warnings,
|
|
93
|
+
};
|
|
94
|
+
}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
// The text the shared-memory services report: the admission, the harvests, the import, a push's refusals (the
|
|
2
|
+
// memory_push tool hands them to the model as they are) and the settings set aside.
|
|
3
|
+
|
|
4
|
+
// admit-entries.ts
|
|
5
|
+
export const candidateUnreadable = (reason: string): string => `its candidate file cannot be read (${reason})`;
|
|
6
|
+
export const NO_CANDIDATE_FILE = "no candidate file";
|
|
7
|
+
export const CANDIDATE_CHANGED = "its file changed since it was confirmed: run /memory-admit again";
|
|
8
|
+
export const notACandidateAnyMore = (problem: string): string => `its file is not a candidate entry any more (${problem})`;
|
|
9
|
+
export const statusNotCandidate = (status: string): string => `its status is ${status}, not candidate`;
|
|
10
|
+
export const fileHoldsId = (id: string): string => `its file holds the id ${id}`;
|
|
11
|
+
export const topicWasRefused = (id: string, topic: string): string => `${id}: its topic '${topic}' was refused (refused.md)`;
|
|
12
|
+
export const supersedesNoAdmitted = (id: string, old: string): string =>
|
|
13
|
+
`${id} supersedes ${old}, which is no admitted entry: left as it is`;
|
|
14
|
+
export const notMarkedSuperseded = (old: string, id: string, reason: string): string =>
|
|
15
|
+
`${old} not marked superseded by ${id} (${reason})`;
|
|
16
|
+
export const refusedNotWritten = (id: string, path: string, reason: string): string =>
|
|
17
|
+
`${id}: ${path} not written (${reason}), the candidate stays`;
|
|
18
|
+
export const stillReadsAsCandidate = (path: string, reason: string): string =>
|
|
19
|
+
`${path} still reads as a candidate (${reason}): /memory-admit will say it is decided`;
|
|
20
|
+
export const indexStale = (collection: string, reason: string): string =>
|
|
21
|
+
`the index of ${collection} is stale (${reason}): the next admission re-ingests entries/`;
|
|
22
|
+
export const NOTHING_TO_APPLY = "nothing to apply";
|
|
23
|
+
|
|
24
|
+
// harvest-after-gaps.ts, harvest-mistakes.ts
|
|
25
|
+
export const UNTREATED_GAP = "untreated verdict gap";
|
|
26
|
+
export const UNTREATED_GAPS = "untreated verdict gaps";
|
|
27
|
+
export const learnNudgeLine = (gaps: string, batches: number): string =>
|
|
28
|
+
`→ ${gaps} across ${batches} batches: /dev-learn ` +
|
|
29
|
+
"turns those that recur into rules (in a fresh session).";
|
|
30
|
+
export const harvestSkipped = (reason: string): string => `shared memory: harvest: ${reason}`;
|
|
31
|
+
export const mistakesHarvested = (candidates: string, ids: string): string =>
|
|
32
|
+
`shared memory: ${candidates} harvested from the audits ` +
|
|
33
|
+
`(${ids}) → /memory-admit decides each one.`;
|
|
34
|
+
export const harvestFailed = (reason: string): string => `shared memory: harvest after the verdict failed (${reason})`;
|
|
35
|
+
export const refusedUnreadableNothingHarvested = (reason: string): string => `refused.md cannot be read (${reason}): nothing harvested`;
|
|
36
|
+
export const mistakeAlreadyHeld = (topic: string): string => `${topic}: a mistake candidate or entry already holds it`;
|
|
37
|
+
|
|
38
|
+
// import-agent-memory.ts
|
|
39
|
+
export const noteUnreadable = (path: string, reason: string): string => `${path} cannot be read (${reason}): the line alone is imported`;
|
|
40
|
+
export const itemLooksLikeSecret = (patterns: string): string => `the item looks like it holds a secret (${patterns})`;
|
|
41
|
+
export const noAgentMemory = (root: string, index: string): string => `No harness agent memory in ${root} (no <agent>/${index}).`;
|
|
42
|
+
export const NO_CANDIDATE_WRITTEN = "No candidate written.";
|
|
43
|
+
export const duplicatesSkipped = (count: number, list: string): string =>
|
|
44
|
+
`${count} duplicate(s) skipped (topic already held): ${list}`;
|
|
45
|
+
export const DECIDE_WITH_MEMORY_ADMIT = "Decide them with /memory-admit (each one is asked).";
|
|
46
|
+
|
|
47
|
+
// memory-files.ts, memory-settings.ts, recall-precedents.ts
|
|
48
|
+
export const notRefreshed = (path: string, title: string): string =>
|
|
49
|
+
`${path} not refreshed: it exists and is not the memory's (it does not start with '${title}')`;
|
|
50
|
+
export const memoryDirSetAside = (key: string, raw: string, reason: string, dir: string): string =>
|
|
51
|
+
`${key} '${raw}' set aside (${reason}): ${dir} applies`;
|
|
52
|
+
export const recallFailed = (reason: string): string => `shared memory: recall failed, no precedents (${reason})`;
|
|
53
|
+
|
|
54
|
+
// push-candidate.ts: the refusals of memory_push
|
|
55
|
+
export const EVIDENCE_REQUIRED = "evidence required: at least one path:line, commit or verdict file";
|
|
56
|
+
export const topicNeverProposedAgain = (topic: string): string =>
|
|
57
|
+
`topic '${topic}' was refused (refused.md): it is never proposed again`;
|
|
58
|
+
export const refusedUnreadableNothingWritten = (reason: string): string => `refused.md cannot be read (${reason}): nothing was written`;
|
|
59
|
+
export const notAValidEntry = (problems: string): string => `not a valid entry: ${problems}`;
|
|
60
|
+
export const nineHoldTheId = (id: string): string => `nine candidates or entries already hold the id ${id}`;
|
|
61
|
+
export const admittedHoldsId = (id: string): string => `an admitted entry already holds ${id}: supersede it rather than push it again`;
|
|
62
|
+
export const notWritable = (path: string, reason: string): string => `${path} is not writable (${reason}): nothing was written`;
|
|
63
|
+
export const overwroteTwice = (id: string): string => `another push overwrote ${id} twice: nothing was kept, push again`;
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
// pushCandidate: a candidate of the shared memory from what the model or a crew proposes (the
|
|
2
|
+
// memory_push tool). It writes candidates/<id>.md only, never entries/: admission is
|
|
3
|
+
// /memory-admit's. Refused, with the reason and nothing written: a topic refused.md holds, an
|
|
4
|
+
// entry the domain finds invalid (shape, secrets), an unreadable refused list, a failed write.
|
|
5
|
+
|
|
6
|
+
import type { Files } from "../ports.ts";
|
|
7
|
+
import { ENTRY_TYPES, entryIdPrefix, entryProblems } from "../../domain/shared-memory/entry.ts";
|
|
8
|
+
import type { EntryType, MemoryEntry } from "../../domain/shared-memory/entry.ts";
|
|
9
|
+
import { topicOf } from "../../domain/shared-memory/refused.ts";
|
|
10
|
+
import { serializeEntry } from "../../domain/shared-memory/front-matter.ts";
|
|
11
|
+
import { candidatePath, entryPath } from "../../domain/shared-memory/layout.ts";
|
|
12
|
+
import type { MemoryLayout } from "../../domain/shared-memory/layout.ts";
|
|
13
|
+
import { secretLikePaths } from "../../domain/secret-patterns.ts";
|
|
14
|
+
import { readOrNull, refreshCandidatesList, refusedTopics, writeCandidateFile } from "./memory-files.ts";
|
|
15
|
+
import { EVIDENCE_REQUIRED, admittedHoldsId, nineHoldTheId, notAValidEntry, notWritable, overwroteTwice, refusedUnreadableNothingWritten, topicNeverProposedAgain } from "./messages.ts";
|
|
16
|
+
import { evidenceNamesSecret, typeMustBeOneOf } from "../../domain/shared-memory/messages.ts";
|
|
17
|
+
import { cannotBeRead } from "../messages.ts";
|
|
18
|
+
|
|
19
|
+
export interface PushInput {
|
|
20
|
+
type: EntryType;
|
|
21
|
+
title: string;
|
|
22
|
+
topic: string;
|
|
23
|
+
appliesWhen: string;
|
|
24
|
+
rationale: string;
|
|
25
|
+
correction?: string;
|
|
26
|
+
detectionSignal?: string;
|
|
27
|
+
/** path:line, a commit, or a verdict file: one item each. */
|
|
28
|
+
evidence: string[];
|
|
29
|
+
tags: string[];
|
|
30
|
+
/** Absent: human:<date> memory_push. */
|
|
31
|
+
source?: string;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export type PushOutcome =
|
|
35
|
+
| { ok: true; id: string; path: string; warnings: string[] }
|
|
36
|
+
| { ok: false; refused: string };
|
|
37
|
+
|
|
38
|
+
export interface PushDeps {
|
|
39
|
+
files: Pick<Files, "read" | "write" | "list">;
|
|
40
|
+
clock: () => Date;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
const text = (value: unknown): string => (typeof value === "string" ? value.trim() : "");
|
|
44
|
+
const list = (value: unknown): string[] =>
|
|
45
|
+
Array.isArray(value) ? value.filter((v): v is string => typeof v === "string").map((v) => v.trim()).filter((v) => v !== "") : [];
|
|
46
|
+
|
|
47
|
+
/** The tool's input (snake_case, as the model writes it) read as a PushInput, or why not. */
|
|
48
|
+
export function readPushInput(input: unknown): { ok: true; input: PushInput } | { ok: false; refused: string } {
|
|
49
|
+
const raw = (input !== null && typeof input === "object" ? input : {}) as Record<string, unknown>;
|
|
50
|
+
const type = text(raw.type);
|
|
51
|
+
if (!(ENTRY_TYPES as readonly string[]).includes(type)) return { ok: false, refused: typeMustBeOneOf(ENTRY_TYPES.join(", ")) };
|
|
52
|
+
const missing = ["title", "topic", "applies_when", "rationale"].filter((key) => text(raw[key]) === "");
|
|
53
|
+
if (missing.length > 0) return { ok: false, refused: `${missing.join(", ")} required` };
|
|
54
|
+
const evidence = list(raw.evidence);
|
|
55
|
+
if (evidence.length === 0) return { ok: false, refused: EVIDENCE_REQUIRED };
|
|
56
|
+
const secret = secretLikePaths(evidence.flatMap((e) => e.split(/\s+/)).map((w) => w.replace(/:\d+$/, "")));
|
|
57
|
+
if (secret.length > 0) return { ok: false, refused: evidenceNamesSecret(secret.join(", ")) };
|
|
58
|
+
const pushed: PushInput = {
|
|
59
|
+
type: type as EntryType, title: text(raw.title), topic: text(raw.topic), appliesWhen: text(raw.applies_when),
|
|
60
|
+
rationale: text(raw.rationale), evidence, tags: list(raw.tags).map((t) => t.toLowerCase()),
|
|
61
|
+
};
|
|
62
|
+
if (text(raw.correction) !== "") pushed.correction = text(raw.correction);
|
|
63
|
+
if (text(raw.detection_signal) !== "") pushed.detectionSignal = text(raw.detection_signal);
|
|
64
|
+
return { ok: true, input: pushed };
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
const day = (date: Date): string => date.toISOString().slice(0, 10);
|
|
68
|
+
|
|
69
|
+
/** The candidate entry, its id not yet made unique. */
|
|
70
|
+
export function candidateEntry(input: PushInput, project: string, date: string): MemoryEntry {
|
|
71
|
+
const entry: MemoryEntry = {
|
|
72
|
+
id: `${entryIdPrefix(project, input.type, date)}${topicOf(input.title)}`,
|
|
73
|
+
type: input.type, title: input.title, project, date, topic: topicOf(input.topic),
|
|
74
|
+
appliesWhen: input.appliesWhen, rationale: input.rationale,
|
|
75
|
+
source: input.source ?? `human:${date} memory_push`, status: "candidate", supersedes: [], tags: input.tags, stack: [],
|
|
76
|
+
body: ["## Context", input.appliesWhen, "", "## Content", input.rationale,
|
|
77
|
+
...(input.correction === undefined ? [] : ["", `Instead: ${input.correction}`]), "", "## Evidence",
|
|
78
|
+
...input.evidence.map((e) => `- \`${e.replace(/`/g, "'")}\``)].join("\n") + "\n",
|
|
79
|
+
};
|
|
80
|
+
if (input.correction !== undefined) entry.correction = input.correction;
|
|
81
|
+
if (input.detectionSignal !== undefined) entry.detectionSignal = input.detectionSignal;
|
|
82
|
+
return entry;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/** The id itself when no candidate or entry holds it, else the first free `-2` … `-9`; null when none is. */
|
|
86
|
+
async function freeId(files: Pick<Files, "read">, layout: MemoryLayout, entry: MemoryEntry): Promise<string | null> {
|
|
87
|
+
for (let n = 1; n <= 9; n++) {
|
|
88
|
+
const id = n === 1 ? entry.id : `${entry.id}-${n}`;
|
|
89
|
+
const taken = (await readOrNull(files, candidatePath(layout, id))) !== null
|
|
90
|
+
|| (await readOrNull(files, entryPath(layout, entry.type, id))) !== null;
|
|
91
|
+
if (!taken) return id;
|
|
92
|
+
}
|
|
93
|
+
return null;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/** The text read back is the one written, line endings and a trailing blank aside (a host may normalise them). */
|
|
97
|
+
const sameText = (a: string, b: string): boolean => a.replace(/\r\n/g, "\n").trimEnd() === b.replace(/\r\n/g, "\n").trimEnd();
|
|
98
|
+
|
|
99
|
+
const firstLine = (error: unknown): string => String((error as Error)?.message ?? error).split("\n")[0];
|
|
100
|
+
|
|
101
|
+
/** Writes `entry` as a candidate after the checks: refused topic, validity, a free id. */
|
|
102
|
+
export async function writeCandidate(
|
|
103
|
+
deps: Pick<PushDeps, "files">, memory: { layout: MemoryLayout }, entry: MemoryEntry,
|
|
104
|
+
): Promise<PushOutcome> {
|
|
105
|
+
try {
|
|
106
|
+
if ((await refusedTopics(deps.files, memory.layout)).has(entry.topic)) {
|
|
107
|
+
return { ok: false, refused: topicNeverProposedAgain(entry.topic) };
|
|
108
|
+
}
|
|
109
|
+
} catch (error) {
|
|
110
|
+
return { ok: false, refused: refusedUnreadableNothingWritten(firstLine(error)) };
|
|
111
|
+
}
|
|
112
|
+
const problems = entryProblems(entry);
|
|
113
|
+
if (problems.length > 0) return { ok: false, refused: notAValidEntry(problems.join("; ")) };
|
|
114
|
+
// The Files port has no exclusive create: a concurrent push of the same title may write the same id between
|
|
115
|
+
// freeId and the write. The candidate is read back, and a file another push overwrote is written again under the
|
|
116
|
+
// next free id; a push whose write came last still wins its id (no lock without module state).
|
|
117
|
+
for (let attempt = 1; attempt <= 2; attempt++) {
|
|
118
|
+
let id: string | null;
|
|
119
|
+
try {
|
|
120
|
+
id = await freeId(deps.files, memory.layout, entry);
|
|
121
|
+
} catch (error) {
|
|
122
|
+
return { ok: false, refused: cannotBeRead(memory.layout.candidates, firstLine(error)) };
|
|
123
|
+
}
|
|
124
|
+
if (id === null) return { ok: false, refused: nineHoldTheId(entry.id) };
|
|
125
|
+
if (id !== entry.id && (await readOrNull(deps.files, entryPath(memory.layout, entry.type, entry.id)).catch(() => null)) !== null) {
|
|
126
|
+
return { ok: false, refused: admittedHoldsId(entry.id) };
|
|
127
|
+
}
|
|
128
|
+
let path: string;
|
|
129
|
+
try {
|
|
130
|
+
path = await writeCandidateFile(deps.files, memory.layout, { ...entry, id });
|
|
131
|
+
} catch (error) {
|
|
132
|
+
return { ok: false, refused: notWritable(memory.layout.candidates, firstLine(error)) };
|
|
133
|
+
}
|
|
134
|
+
const kept = await readOrNull(deps.files, path).catch(() => null);
|
|
135
|
+
if (kept !== null && sameText(kept, serializeEntry({ ...entry, id, status: "candidate" })) === false) continue;
|
|
136
|
+
const listed = await refreshCandidatesList(deps.files, memory.layout);
|
|
137
|
+
return { ok: true, id, path, warnings: listed === null ? [] : [listed] };
|
|
138
|
+
}
|
|
139
|
+
return { ok: false, refused: overwroteTwice(entry.id) };
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
/** memory_push: the input read, the candidate built and written. */
|
|
143
|
+
export async function pushCandidate(
|
|
144
|
+
deps: PushDeps, memory: { layout: MemoryLayout; project: string }, raw: unknown,
|
|
145
|
+
): Promise<PushOutcome> {
|
|
146
|
+
const read = readPushInput(raw);
|
|
147
|
+
if (!read.ok) return read;
|
|
148
|
+
return writeCandidate(deps, memory, candidateEntry(read.input, memory.project, day(deps.clock())));
|
|
149
|
+
}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
// Recall from the shared memory: ask the index, read each hit's file, keep the admitted entries of the
|
|
2
|
+
// types asked, best first. The index keeps superseded entries and is no source of truth, so the status
|
|
3
|
+
// is read from the file itself. recallPrecedents is the best-effort form a crew step uses: a failure
|
|
4
|
+
// costs the block, never the step (as extract-memories.ts degrades to nothing).
|
|
5
|
+
|
|
6
|
+
import type { Files, Logger, SharedMemory } from "../ports.ts";
|
|
7
|
+
import { parseEntry } from "../../domain/shared-memory/front-matter.ts";
|
|
8
|
+
import type { EntryType } from "../../domain/shared-memory/entry.ts";
|
|
9
|
+
import { MAX_PRECEDENTS, RECALL_TOP_N, buildPrecedentsBlock } from "../../domain/shared-memory/precedents-block.ts";
|
|
10
|
+
import type { Precedent } from "../../domain/shared-memory/precedents-block.ts";
|
|
11
|
+
import type { MemoryLayout } from "../../domain/shared-memory/layout.ts";
|
|
12
|
+
import { recallFailed } from "./messages.ts";
|
|
13
|
+
|
|
14
|
+
export interface RecallDeps {
|
|
15
|
+
memory: Pick<SharedMemory, "search">;
|
|
16
|
+
files: Pick<Files, "read">;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export interface RecallRequest {
|
|
20
|
+
/** Where the entries are and the collection that indexes them (memory-settings.ts). */
|
|
21
|
+
memory: { layout: Pick<MemoryLayout, "entries">; collection: string };
|
|
22
|
+
query: string;
|
|
23
|
+
/** Only these types; absent or empty = every type. */
|
|
24
|
+
types?: readonly EntryType[];
|
|
25
|
+
/** At most this many entries, MAX_PRECEDENTS at most. */
|
|
26
|
+
max?: number;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
export interface Recall {
|
|
30
|
+
precedents: Precedent[];
|
|
31
|
+
/** More admitted entries matched than were kept. */
|
|
32
|
+
truncated: boolean;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** The admitted entries the index finds for the query. Throws when the index cannot answer. */
|
|
36
|
+
export async function recallEntries(deps: RecallDeps, request: RecallRequest): Promise<Recall> {
|
|
37
|
+
const max = Math.max(1, Math.min(MAX_PRECEDENTS, Math.floor(request.max ?? MAX_PRECEDENTS)));
|
|
38
|
+
const query = request.query.trim();
|
|
39
|
+
if (query === "") return { precedents: [], truncated: false };
|
|
40
|
+
const hits = await deps.memory.search(request.memory.collection, query, RECALL_TOP_N);
|
|
41
|
+
const under = `${request.memory.layout.entries}/`;
|
|
42
|
+
const types = request.types !== undefined && request.types.length > 0 ? new Set(request.types) : null;
|
|
43
|
+
const found: Precedent[] = [];
|
|
44
|
+
for (const hit of hits) {
|
|
45
|
+
if (!hit.sourceId.startsWith(under)) continue;
|
|
46
|
+
let text: string;
|
|
47
|
+
try {
|
|
48
|
+
text = await deps.files.read(hit.sourceId);
|
|
49
|
+
} catch {
|
|
50
|
+
continue; // gone since the index was built
|
|
51
|
+
}
|
|
52
|
+
const parsed = parseEntry(text);
|
|
53
|
+
if (!parsed.ok || parsed.entry.status !== "admitted") continue;
|
|
54
|
+
if (types !== null && !types.has(parsed.entry.type)) continue;
|
|
55
|
+
found.push({ entry: parsed.entry, path: hit.sourceId, score: hit.score });
|
|
56
|
+
}
|
|
57
|
+
return { precedents: found.slice(0, max), truncated: found.length > max };
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** The "## Precedents" block for a crew step's prompt; "" when nothing is recalled or the recall fails. */
|
|
61
|
+
export async function recallPrecedents(
|
|
62
|
+
deps: RecallDeps & { log: Pick<Logger, "warn"> }, request: RecallRequest,
|
|
63
|
+
): Promise<string> {
|
|
64
|
+
try {
|
|
65
|
+
return buildPrecedentsBlock((await recallEntries(deps, request)).precedents);
|
|
66
|
+
} catch (error) {
|
|
67
|
+
deps.log.warn(recallFailed(String((error as Error)?.message ?? error).split("\n")[0]));
|
|
68
|
+
return "";
|
|
69
|
+
}
|
|
70
|
+
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
// What the suggestion of skills says to the user.
|
|
2
|
+
export const SUGGEST_WITHOUT_DECISION_MODEL =
|
|
3
|
+
"skills.suggest is on and the host has no decision model: no skill is suggested (set Orkeon:Decision:Provider, or Orkeon:TypeSafe)";
|
|
4
|
+
export const skillsSuggested = (paths: string): string => `skills suggested for this turn: ${paths}`;
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
// The skills suggested for one turn (ADR 0027): with `skills.suggest` on and a decision model on the host, the
|
|
2
|
+
// project's skill files are listed, the model is told of each by one line, and the few that fit the request are read
|
|
3
|
+
// and handed to the turn, apart from the ones a person attached: the turn reads them as reference material the
|
|
4
|
+
// operator did not choose. A skill kept for a person to invoke is never offered. It fails open at every step: the setting off or
|
|
5
|
+
// unreadable, no decision model, no skill folder, a model that does not answer suggest nothing. What was suggested
|
|
6
|
+
// is logged and kept in the session for `/skills suggest why`.
|
|
7
|
+
import type { DecisionModel, Files, Logger, SessionStore } from "../ports.ts";
|
|
8
|
+
import type { ConfigStore } from "../config-store.ts";
|
|
9
|
+
import type { AttachedSkill } from "../attached-skills.ts";
|
|
10
|
+
import { WORKSPACE } from "../../domain/vfs.ts";
|
|
11
|
+
import { SKILLS_SUGGESTED_STATE_KEY } from "../../domain/session-keys.ts";
|
|
12
|
+
import type { DecisionAnswers } from "../../domain/decision/questions.ts";
|
|
13
|
+
import type { SkillCard, SkillPick } from "../../domain/skills/shortlist.ts";
|
|
14
|
+
import {
|
|
15
|
+
CLAUDE_SKILLS_DIR, CLAUDE_SKILL_FILE, ORKEON_SKILLS_DIR, SKILL_HEAD_CHARS, SKILLS_LISTING_MAX, SKILLS_SUGGEST_CONFIG_KEY,
|
|
16
|
+
SUGGEST_MAX_CANDIDATES, offerable, shortlistOf, shortlistQuestion, skillCard, skillKey, suggestOn, suggestState,
|
|
17
|
+
} from "../../domain/skills/shortlist.ts";
|
|
18
|
+
import { SUGGEST_WITHOUT_DECISION_MODEL, skillsSuggested } from "./messages.ts";
|
|
19
|
+
|
|
20
|
+
export interface SuggestDeps {
|
|
21
|
+
config: Pick<ConfigStore, "readValue">;
|
|
22
|
+
decision: DecisionModel;
|
|
23
|
+
files: Pick<Files, "read" | "list">;
|
|
24
|
+
session: Pick<SessionStore, "writeState">;
|
|
25
|
+
log: Pick<Logger, "info" | "warn">;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
async function settingOn(config: SuggestDeps["config"]): Promise<boolean> {
|
|
29
|
+
try {
|
|
30
|
+
return suggestOn((await config.readValue(SKILLS_SUGGEST_CONFIG_KEY)).value);
|
|
31
|
+
} catch {
|
|
32
|
+
return false;
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
async function entries(files: SuggestDeps["files"], dir: string): Promise<string[]> {
|
|
37
|
+
try {
|
|
38
|
+
return [...await files.list(dir, SKILLS_LISTING_MAX)].map((name) => name.replace(/\/+$/, "")).sort();
|
|
39
|
+
} catch {
|
|
40
|
+
return [];
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** The skill files of the project, the project's own first, each folder in name order, SUGGEST_MAX_CANDIDATES at most. */
|
|
45
|
+
async function skillPaths(files: SuggestDeps["files"]): Promise<string[]> {
|
|
46
|
+
const own = (await entries(files, `${WORKSPACE}/${ORKEON_SKILLS_DIR}`))
|
|
47
|
+
.filter((name) => /\.md$/i.test(name))
|
|
48
|
+
.map((name) => `${WORKSPACE}/${ORKEON_SKILLS_DIR}/${name}`);
|
|
49
|
+
// A folder per skill: an entry that ends like a file (README.md, notes.txt) is none.
|
|
50
|
+
const others = (await entries(files, `${WORKSPACE}/${CLAUDE_SKILLS_DIR}`))
|
|
51
|
+
.filter((name) => !/\.[A-Za-z0-9]{1,5}$/.test(name))
|
|
52
|
+
.map((name) => `${WORKSPACE}/${CLAUDE_SKILLS_DIR}/${name}/${CLAUDE_SKILL_FILE}`);
|
|
53
|
+
return [...own, ...others].slice(0, SUGGEST_MAX_CANDIDATES);
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/** The card of each skill file that can be read, is not blank and may be offered to a model. */
|
|
57
|
+
async function cards(files: SuggestDeps["files"], paths: readonly string[]): Promise<SkillCard[]> {
|
|
58
|
+
const read = await Promise.all(paths.map(async (path) => {
|
|
59
|
+
try {
|
|
60
|
+
const head = await files.read(path, SKILL_HEAD_CHARS);
|
|
61
|
+
return head.trim().length === 0 || !offerable(head) ? null : skillCard(path, head);
|
|
62
|
+
} catch {
|
|
63
|
+
return null;
|
|
64
|
+
}
|
|
65
|
+
}));
|
|
66
|
+
return read.filter((card): card is SkillCard => card !== null);
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
async function contents(files: SuggestDeps["files"], picks: readonly SkillPick[]): Promise<AttachedSkill[]> {
|
|
70
|
+
const out: AttachedSkill[] = [];
|
|
71
|
+
for (const pick of picks) {
|
|
72
|
+
try {
|
|
73
|
+
const content = await files.read(pick.path);
|
|
74
|
+
if (content.trim().length > 0) out.push({ path: pick.path, content });
|
|
75
|
+
} catch { /* a skill gone since its card was read is left out */ }
|
|
76
|
+
}
|
|
77
|
+
return out;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/** The skills suggested for `request`, those of `attached` (paths a person attached) left out. */
|
|
81
|
+
export async function suggestSkills(deps: SuggestDeps, request: string, attached: readonly string[]): Promise<AttachedSkill[]> {
|
|
82
|
+
if (!await settingOn(deps.config)) return [];
|
|
83
|
+
if (!deps.decision.available()) {
|
|
84
|
+
deps.log.warn(SUGGEST_WITHOUT_DECISION_MODEL);
|
|
85
|
+
return [];
|
|
86
|
+
}
|
|
87
|
+
const held = new Set(attached.map(skillKey));
|
|
88
|
+
const offered = (await cards(deps.files, await skillPaths(deps.files))).filter((card) => !held.has(skillKey(card.path)));
|
|
89
|
+
if (offered.length === 0) return [];
|
|
90
|
+
let answers: DecisionAnswers | null = null;
|
|
91
|
+
try {
|
|
92
|
+
answers = await deps.decision.ask(suggestState(request), shortlistQuestion(offered));
|
|
93
|
+
} catch { /* a decision model that throws is one that did not answer */ }
|
|
94
|
+
const picks = shortlistOf(answers, offered);
|
|
95
|
+
try {
|
|
96
|
+
await deps.session.writeState(SKILLS_SUGGESTED_STATE_KEY, JSON.stringify({ offered: offered.length, picks }));
|
|
97
|
+
} catch { /* the record is a convenience: the turn goes on without it */ }
|
|
98
|
+
if (picks.length === 0) return [];
|
|
99
|
+
const skills = await contents(deps.files, picks);
|
|
100
|
+
deps.log.info(skillsSuggested(skills.map((skill) => skill.path).join(", ")));
|
|
101
|
+
return skills;
|
|
102
|
+
}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
// The state keys a use case reads many times, read once (Orkeon #263): one batch
|
|
2
|
+
// read of the session's state bag, then each read of those keys answered from it.
|
|
3
|
+
//
|
|
4
|
+
// A turn of the main loop reads about ten keys through readers that each take the
|
|
5
|
+
// SessionStore port (the behaviour flags, the output style, the hooks, the skills,
|
|
6
|
+
// the compaction breaker...). Rather than teach every reader a batch, the turn hands
|
|
7
|
+
// them a session whose readState answers the snapshot: the readers stay as they are.
|
|
8
|
+
|
|
9
|
+
import type { SessionStore } from "./ports.ts";
|
|
10
|
+
|
|
11
|
+
/** The state reads and writes of a session, the snapshot's keys answered without a call. */
|
|
12
|
+
export type StateSnapshot = Pick<SessionStore, "readState" | "writeState">;
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* Reads `keys` in one call and answers them from then on; a key outside `keys` is
|
|
16
|
+
* read from the session as before. A write goes to the session, then to the
|
|
17
|
+
* snapshot, so a later read of the key sees it. A batch read that fails leaves the
|
|
18
|
+
* snapshot empty: every read goes to the session, as without one (best-effort, like
|
|
19
|
+
* the readers themselves).
|
|
20
|
+
*/
|
|
21
|
+
export async function stateSnapshot(
|
|
22
|
+
session: Pick<SessionStore, "readState" | "readStates" | "writeState">,
|
|
23
|
+
keys: readonly string[],
|
|
24
|
+
): Promise<StateSnapshot> {
|
|
25
|
+
let values: Map<string, string | null>;
|
|
26
|
+
try {
|
|
27
|
+
values = new Map(Object.entries(await session.readStates(keys)));
|
|
28
|
+
} catch {
|
|
29
|
+
values = new Map();
|
|
30
|
+
}
|
|
31
|
+
return {
|
|
32
|
+
readState: async (key) => (values.has(key) ? values.get(key) ?? null : session.readState(key)),
|
|
33
|
+
async writeState(key, value) {
|
|
34
|
+
await session.writeState(key, value);
|
|
35
|
+
if (values.has(key)) values.set(key, value);
|
|
36
|
+
},
|
|
37
|
+
};
|
|
38
|
+
}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
// Why no state file of the batch in progress was written, and what the tree's status could not say.
|
|
2
|
+
|
|
3
|
+
export const noWorkCode = (code: string, folder: string, reason: string): string => `no work code '${code}' in ${folder}/ (${reason})`;
|
|
4
|
+
export const noSheetOf = (phase: string, shown: string): string => `no sheet of ${phase} in ${shown}/`;
|
|
5
|
+
export const noOpenSheetOf = (phase: string, folder: string): string => `no open sheet of ${phase} in ${folder}/`;
|
|
6
|
+
export const gitStatusFailed = (reason: string): string => `git status failed: ${reason}`;
|
|
7
|
+
export const gitStatusCouldNotRun = (reason: string): string => `git status could not run: ${reason}`;
|
|
8
|
+
export const workFolderUnreachable = (folder: string): string => `the work folder ${folder}/ cannot be reached`;
|