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,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,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`;
|
|
@@ -17,6 +17,7 @@ import { listDevCodes, loadDevCode, loadDevContext } from "../dev/load-dev-conte
|
|
|
17
17
|
import type { CodeSheet, DevCode } from "../dev/load-dev-context.ts";
|
|
18
18
|
import type { WorkFolder } from "../dev/resolve-work-folder.ts";
|
|
19
19
|
import { WORKSPACE } from "../../domain/vfs.ts";
|
|
20
|
+
import { gitStatusCouldNotRun, gitStatusFailed, noOpenSheetOf, noSheetOf, noWorkCode, workFolderUnreachable } from "./messages.ts";
|
|
20
21
|
|
|
21
22
|
export async function readActiveWorkflow(session: Pick<SessionStore, "readState">): Promise<ActiveWorkflow | null> {
|
|
22
23
|
return parseActiveWorkflow(await session.readState(WORKFLOW_ACTIVE_STATE_KEY));
|
|
@@ -51,9 +52,9 @@ async function findSheet(
|
|
|
51
52
|
): Promise<{ code: DevCode; sheet: CodeSheet } | { skipped: string }> {
|
|
52
53
|
if (active.code !== null) {
|
|
53
54
|
const lookup = await loadDevCode(deps, work, active.code);
|
|
54
|
-
if (lookup.found === null) return { skipped:
|
|
55
|
+
if (lookup.found === null) return { skipped: noWorkCode(active.code, work.folder, lookup.reason) };
|
|
55
56
|
const any = lookup.found.sheets.find((s) => s.batch === active.phase);
|
|
56
|
-
if (any === undefined) return { skipped:
|
|
57
|
+
if (any === undefined) return { skipped: noSheetOf(active.phase, lookup.found.shown) };
|
|
57
58
|
if (any.sheet.doneDate !== undefined) return { skipped: `${lookup.found.shown}/${any.name} is done (${any.sheet.doneDate})` };
|
|
58
59
|
return { code: lookup.found, sheet: any };
|
|
59
60
|
}
|
|
@@ -64,7 +65,7 @@ async function findSheet(
|
|
|
64
65
|
const sheet = openSheet(lookup.found, active.phase);
|
|
65
66
|
if (sheet !== undefined) return { code: lookup.found, sheet };
|
|
66
67
|
}
|
|
67
|
-
return { skipped:
|
|
68
|
+
return { skipped: noOpenSheetOf(active.phase, work.folder) };
|
|
68
69
|
}
|
|
69
70
|
|
|
70
71
|
/** The batch's events: Code's own log when there is one, else the log of the work code's
|
|
@@ -95,10 +96,10 @@ async function readReports(files: Pick<Files, "list">, folder: string, phase: st
|
|
|
95
96
|
async function readTree(shell: Pick<Shell, "run">): Promise<{ lines: string[] } | { note: string }> {
|
|
96
97
|
try {
|
|
97
98
|
const r = await shell.run("git status --short");
|
|
98
|
-
if (r.exitCode !== 0) return { note:
|
|
99
|
+
if (r.exitCode !== 0) return { note: gitStatusFailed((r.stderr || r.stdout).trim().split("\n")[0] || `exit ${r.exitCode}`) };
|
|
99
100
|
return { lines: r.stdout.split(/\r?\n/).filter((l) => l.trim().length > 0) };
|
|
100
101
|
} catch (error) {
|
|
101
|
-
return { note:
|
|
102
|
+
return { note: gitStatusCouldNotRun(error instanceof Error ? error.message : String(error)) };
|
|
102
103
|
}
|
|
103
104
|
}
|
|
104
105
|
|
|
@@ -112,7 +113,7 @@ export async function writeWorkflowState(
|
|
|
112
113
|
const active = await readActiveWorkflow(deps.session);
|
|
113
114
|
if (active === null) return null;
|
|
114
115
|
const { work } = await loadDevContext(deps);
|
|
115
|
-
if (work.vfsPath === null) return { skipped:
|
|
116
|
+
if (work.vfsPath === null) return { skipped: workFolderUnreachable(work.folder) };
|
|
116
117
|
const found = await findSheet(deps, work, active);
|
|
117
118
|
if ("skipped" in found) return found;
|
|
118
119
|
|
|
@@ -8,6 +8,8 @@
|
|
|
8
8
|
// before the flags existed. Every default below is therefore the value that was hard-coded at
|
|
9
9
|
// the call site (40 act iterations, one review pass, nothing dropped, no extra
|
|
10
10
|
// clause), so turning a flag on is the only thing that changes anything.
|
|
11
|
+
import { effortFlag } from "./messages.ts";
|
|
12
|
+
import { PROACTIVE_CLAUSE } from "./prompts.ts";
|
|
11
13
|
|
|
12
14
|
// ── /effort → the act() iteration ladder ─────────────────────────────────
|
|
13
15
|
|
|
@@ -20,7 +22,7 @@ export const DEFAULT_EFFORT: EffortLevel = "medium";
|
|
|
20
22
|
/**
|
|
21
23
|
* Iterations granted to `ctx.llm.act` per level.
|
|
22
24
|
*
|
|
23
|
-
* The ladder bounds the tool-calling loop.
|
|
25
|
+
* The ladder bounds the tool-calling loop. The level also reaches the
|
|
24
26
|
* provider: `act({ effort })` and `AgentBuilder.effort()` turn its thinking on at that level (A-3).
|
|
25
27
|
* Only a level `/effort` stored is forwarded (`providerEffort`): an unconfigured session sends none,
|
|
26
28
|
* so it keeps the provider's own default and the 40 iterations it always had.
|
|
@@ -99,14 +101,6 @@ export function fastModeDrops(fast: boolean): readonly DroppableBlock[] {
|
|
|
99
101
|
|
|
100
102
|
// ── /proactive → the follow-up clause ────────────────────────────────────
|
|
101
103
|
|
|
102
|
-
/**
|
|
103
|
-
* Appended to the task block (last, with the request) rather than added as its
|
|
104
|
-
* own context block: it is an instruction about the ANSWER's shape, and the
|
|
105
|
-
* furthest thing from the task is the easiest for a model to lose.
|
|
106
|
-
*/
|
|
107
|
-
export const PROACTIVE_CLAUSE =
|
|
108
|
-
"(Proactive mode: after the answer, suggest at most three concrete next steps under " +
|
|
109
|
-
"'Next steps'; leave the list out when the work is self-contained.)";
|
|
110
104
|
|
|
111
105
|
export function proactiveSuffix(on: boolean): string {
|
|
112
106
|
return on ? `\n\n${PROACTIVE_CLAUSE}` : "";
|
|
@@ -158,7 +152,7 @@ export function describeActiveFlags(flags: BehaviorFlags): string {
|
|
|
158
152
|
const active: string[] = [];
|
|
159
153
|
// A stored level, even `medium`, is named: it turns the provider's thinking on.
|
|
160
154
|
if (flags.thinking !== null) {
|
|
161
|
-
active.push(
|
|
155
|
+
active.push(effortFlag(flags.effort, EFFORT_MAX_ITERATIONS[flags.effort], flags.thinking));
|
|
162
156
|
}
|
|
163
157
|
if (flags.passes !== DEFAULT_PASSES) active.push(`passes=${flags.passes}`);
|
|
164
158
|
if (flags.fast) active.push(`fast=on (dropping ${FAST_MODE_DROPPED_BLOCKS.join(", ")})`);
|
|
@@ -12,13 +12,11 @@
|
|
|
12
12
|
|
|
13
13
|
import { builtInTool, sameToolName } from "./permission.ts";
|
|
14
14
|
import type { ExtraTool } from "./permission.ts";
|
|
15
|
+
import { EXTRA_TOOL_ENTRY_RULE, NAMES_NO_TOOL } from "./messages.ts";
|
|
15
16
|
|
|
16
17
|
/** The /config key that lists them. */
|
|
17
18
|
export const EXTRA_TOOLS_CONFIG_KEY = "tools.extra";
|
|
18
19
|
|
|
19
|
-
/** What an entry must be, for messages. */
|
|
20
|
-
export const EXTRA_TOOL_ENTRY_RULE = "each entry is <name>[:read|:write], a tool that is not built in, named once";
|
|
21
|
-
|
|
22
20
|
/** A tool name as the host registers it: letters, digits, `_`, `-`, `.`. */
|
|
23
21
|
const TOOL_NAME = /^[A-Za-z0-9_][A-Za-z0-9_.-]*$/;
|
|
24
22
|
|
|
@@ -65,5 +63,5 @@ export function extraToolsProblem(value: string): string | undefined {
|
|
|
65
63
|
if (invalid.length > 0) {
|
|
66
64
|
return `${EXTRA_TOOL_ENTRY_RULE}; not: ${invalid.join(", ")}`;
|
|
67
65
|
}
|
|
68
|
-
return tools.length === 0 ?
|
|
66
|
+
return tools.length === 0 ? NAMES_NO_TOOL : undefined;
|
|
69
67
|
}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
// The messages of shared/domain/agent-policy: the text the user reads (ADR 0026).
|
|
2
|
+
|
|
3
|
+
// ── Permission rules ────────────────────────────────────────────────────
|
|
4
|
+
|
|
5
|
+
/** Why an allow rule does nothing in plan, or in a mode that does not offer its tool. */
|
|
6
|
+
export const PLAN_IGNORES_ALLOW_RULES =
|
|
7
|
+
"mode 'plan' ignores every allow rule: the gate decides each call from the mode, which runs reads " +
|
|
8
|
+
"and refuses the rest. Switch mode instead.";
|
|
9
|
+
export const modeDoesNotOffer = (mode: string, tool: string): string =>
|
|
10
|
+
`mode '${mode}' does not offer '${tool}': an allow rule spares a question, ` +
|
|
11
|
+
"it does not hand a tool over. Switch mode instead.";
|
|
12
|
+
|
|
13
|
+
/** What a rule to add is refused or warned for. */
|
|
14
|
+
export const noToolARuleMayName = (tool: string, tools: string): string =>
|
|
15
|
+
`'${tool}' is no tool a rule may name: one of ${tools}`;
|
|
16
|
+
export const offeredToEveryAct = (tool: string): string =>
|
|
17
|
+
`'${tool}' is offered to every act whatever the mode: an allow rule lets it run without asking in ` +
|
|
18
|
+
"dontAsk too.";
|
|
19
|
+
export const argumentsNotKnown = (tool: string, argument: string): string =>
|
|
20
|
+
`the arguments of '${tool}' are not known here (its MCP server or plugin declares them): the rule ` +
|
|
21
|
+
`matches a call only if '${tool}' takes an argument named exactly '${argument}'.`;
|
|
22
|
+
export const takesNoArgument = (tool: string): string => `'${tool}' takes no argument: a rule on it covers every call`;
|
|
23
|
+
export const hasNoArgument = (tool: string, argument: string, known: readonly string[]): string =>
|
|
24
|
+
`'${tool}' has no argument '${argument}': it takes ${known.join(", ")}`;
|
|
25
|
+
|
|
26
|
+
// ── Behaviour flags, extra tools ────────────────────────────────────────
|
|
27
|
+
|
|
28
|
+
export const effortFlag = (effort: string, maxIterations: number, thinking: string): string =>
|
|
29
|
+
`effort=${effort} (act maxIterations=${maxIterations}, provider thinking asked at ${thinking})`;
|
|
30
|
+
|
|
31
|
+
/** What an entry must be, for messages. */
|
|
32
|
+
export const EXTRA_TOOL_ENTRY_RULE = "each entry is <name>[:read|:write], a tool that is not built in, named once";
|
|
33
|
+
export const NAMES_NO_TOOL = "it names no tool";
|
|
34
|
+
|
|
35
|
+
// ── Path rules ──────────────────────────────────────────────────────────
|
|
36
|
+
|
|
37
|
+
/** What an entry must be, for messages. */
|
|
38
|
+
export const PATH_ENTRY_RULE =
|
|
39
|
+
"entries separated by commas, each a path of a mount in any spelling or a path under /workspace, `*` for any run of characters";
|
|
40
|
+
export const underNoMount = (given: string): string => `'${given}' is under no mount of this host: no rule`;
|
|
41
|
+
export const namesEveryPathNoRule = (given: string): string => `'${given}' names every path: no rule`;
|
|
42
|
+
export const holdsAQuote = (entry: string, rule: string): string =>
|
|
43
|
+
`'${entry}' holds a quote: write the path bare, its spaces included (${rule})`;
|
|
44
|
+
export const namesEveryPath = (entry: string, rule: string): string => `'${entry}' names every path (${rule})`;
|
|
45
|
+
export const outsideUserList = (key: string, entry: string): string =>
|
|
46
|
+
`${key} (project): '${entry}' is outside the user's list; a project file may only narrow it`;
|
|
47
|
+
export const refusedOwnMount = (tool: string, path: string, mount: string): string =>
|
|
48
|
+
`${tool} on ${path} is refused: ${mount} is Orkeon Code's own`;
|
|
49
|
+
export const refusedByDeny = (tool: string, path: string, key: string, deny: string): string =>
|
|
50
|
+
`${tool} on ${path} is refused by ${key} '${deny}'`;
|
|
51
|
+
export const outsideAllow = (tool: string, path: string, key: string): string => `${tool} on ${path} is outside ${key}`;
|
|
52
|
+
|
|
53
|
+
// ── Rule sets ───────────────────────────────────────────────────────────
|
|
54
|
+
|
|
55
|
+
export const GIT_READONLY_TITLE = "git commands that change the repository, its branches or its remotes";
|
|
56
|
+
export const INLINE_INTERPRETERS_TITLE = "code handed inline to an interpreter, which could run what the other rules refuse";
|
|
57
|
+
export const READ_NOISE_TITLE = "reads under build outputs, version-control internals and installed packages";
|
|
58
|
+
export const SECRETS_TITLE = "a private key block or a token with a known prefix in written content";
|
|
59
|
+
export const STATE_FILES_TITLE = "files only Orkeon Code's own code writes";
|
|
60
|
+
export const rootWholeProject = (raw: string): string => `root '${raw}' names the whole project: no rule`;
|
|
61
|
+
export const rootOutside = (raw: string, workspace: string): string => `root '${raw}' is outside ${workspace}: no rule`;
|
|
62
|
+
export const rootClimbsOut = (raw: string): string => `root '${raw}' climbs out with '..': no rule`;
|
|
63
|
+
export const rootHoldsStar = (raw: string): string => `root '${raw}' holds '*': a rule on it would cover more than the folder`;
|
|
64
|
+
export const patternWholeProject = (raw: string): string => `pattern '${raw}' covers the whole project: no rule`;
|
|
65
|
+
export const patternOutside = (raw: string, workspace: string): string => `pattern '${raw}' is outside ${workspace}: no rule`;
|
|
66
|
+
export const patternClimbsOut = (raw: string): string => `pattern '${raw}' climbs out with '..': no rule`;
|
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
// The user's path lists — pure, no IO: `paths.deny` names what the assistant may neither read nor write,
|
|
2
|
+
// `paths.allow` the only paths it may; both match on the canonical virtual spelling (host-paths.ts toVirtual), so a
|
|
3
|
+
// physical spelling of a mount's base (`C:\…`, `/mnt/c/…`, `\\wsl$\…`) or another letter case on a Windows disk
|
|
4
|
+
// reaches the same rule. The notation:
|
|
5
|
+
//
|
|
6
|
+
// /workspace/secrets, C:\proj\keys\*, tests/fixtures/real
|
|
7
|
+
//
|
|
8
|
+
// entries separated by commas (a path may hold spaces), each a virtual path, a physical spelling of a mount's base,
|
|
9
|
+
// or a relative path under /workspace; `*` stands for any run of characters as the gate reads it; a bare path covers
|
|
10
|
+
// itself and everything below it. Deny wins over allow; a non-empty allow refuses every path outside it, on every
|
|
11
|
+
// mount. Two readers: pathListRules gives the gate the deny rules on the canonical spelling (and lists them in
|
|
12
|
+
// /permissions); pathListRefusal, run by the acts' callbacks on the canonicalised call, holds against every spelling,
|
|
13
|
+
// every case the host ignores, each operation of an edit_batch, what a folder reader reaches and the words of a
|
|
14
|
+
// shell command. The built-in deny of the whole /user-config mount (userConfigRules) keeps the physical bases of
|
|
15
|
+
// launch.json and the user settings out of the model's reach.
|
|
16
|
+
|
|
17
|
+
import { globMatches, sameToolName, shellCommandForms, shellWords } from "./permission.ts";
|
|
18
|
+
import type { PermissionRule } from "./permission.ts";
|
|
19
|
+
import {
|
|
20
|
+
FOLDER_READ_TOOLS, OPERATIONS_TOOL, PATH_READ_TOOLS, PATH_WRITE_TOOLS, UNSCOPED_READ_TOOLS, UNSCOPED_WRITE_TOOLS,
|
|
21
|
+
denyEach, denyWhole,
|
|
22
|
+
} from "./rule-sets.ts";
|
|
23
|
+
import { normalisePath, reachedPaths } from "../dev/call-guard.ts";
|
|
24
|
+
import { textToVirtual, toVirtual } from "../host-paths.ts";
|
|
25
|
+
import { IDENTITY_HOST } from "../host-layout.ts";
|
|
26
|
+
import type { HostLayout } from "../host-layout.ts";
|
|
27
|
+
import { MOUNT_POINTS, WORKSPACE } from "../vfs.ts";
|
|
28
|
+
import {
|
|
29
|
+
holdsAQuote, namesEveryPath, namesEveryPathNoRule, outsideAllow, outsideUserList, PATH_ENTRY_RULE, refusedByDeny,
|
|
30
|
+
refusedOwnMount, underNoMount,
|
|
31
|
+
} from "./messages.ts";
|
|
32
|
+
|
|
33
|
+
/** The /config keys. */
|
|
34
|
+
export const PATHS_DENY_CONFIG_KEY = "paths.deny";
|
|
35
|
+
export const PATHS_ALLOW_CONFIG_KEY = "paths.allow";
|
|
36
|
+
|
|
37
|
+
/** The mount Orkeon Code keeps to itself: config.json and launch.json, the physical bases inside. */
|
|
38
|
+
export const USER_CONFIG_MOUNT = "/user-config";
|
|
39
|
+
|
|
40
|
+
/** The lists as the callbacks check them: canonical patterns, a bare entry present as itself and as `<entry>/*`. */
|
|
41
|
+
export interface PathLists {
|
|
42
|
+
deny: readonly string[];
|
|
43
|
+
allow: readonly string[];
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
export const EMPTY_PATH_LISTS: PathLists = Object.freeze({ deny: Object.freeze([]), allow: Object.freeze([]) }) as PathLists;
|
|
47
|
+
|
|
48
|
+
export interface PathListsParse extends PathLists {
|
|
49
|
+
/** Each entry left out, as written, and why. */
|
|
50
|
+
problems: string[];
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/** The raw values of the two keys of one settings file, undefined when unset. */
|
|
54
|
+
export interface PathListValues {
|
|
55
|
+
deny?: string;
|
|
56
|
+
allow?: string;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
const DRIVE_OR_UNC = /^(?:[A-Za-z]:|\\\\|\/\/|\\)/;
|
|
60
|
+
|
|
61
|
+
/** Whether a path is spelled as a Windows drive or UNC path. */
|
|
62
|
+
const windowsSpelled = (text: string): boolean => DRIVE_OR_UNC.test(text);
|
|
63
|
+
|
|
64
|
+
const escapeRegExp = (text: string): string => text.replace(/[.*+?^$|()[\]{}\\]/g, "\\$&");
|
|
65
|
+
|
|
66
|
+
/** Whether a posix path lies under a Windows drive the WSL automount exposes (`/mnt/c/…`). */
|
|
67
|
+
function underAutomount(path: string, layout: HostLayout): boolean {
|
|
68
|
+
const root = layout.automountRoot === "/" ? "" : layout.automountRoot;
|
|
69
|
+
return new RegExp(`^${escapeRegExp(root)}/[A-Za-z](?:/|$)`).test(path);
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** Whether a canonical path starts with a mount point of the VFS: one the launchers give, or one of the layout. */
|
|
73
|
+
function onMount(path: string, layout: HostLayout): boolean {
|
|
74
|
+
const first = `/${path.split("/")[1] ?? ""}`;
|
|
75
|
+
return MOUNT_POINTS.includes(first) || layout.mounts.some((m) => m.virtual === first);
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/** One entry to its canonical virtual spelling, or the reason it has none. */
|
|
79
|
+
function canonicalEntry(given: string, layout: HostLayout): { canonical?: string; problem?: string } {
|
|
80
|
+
const relative = !given.startsWith("/") && !windowsSpelled(given);
|
|
81
|
+
const virtual = normalisePath(toVirtual(relative ? `${WORKSPACE}/${given}` : given, layout));
|
|
82
|
+
if (!virtual.startsWith("/")) return { problem: underNoMount(given) };
|
|
83
|
+
if (virtual === "/") return { problem: namesEveryPathNoRule(given) };
|
|
84
|
+
if (layout.flavour === "wsl" && underAutomount(virtual, layout)) {
|
|
85
|
+
return { problem: underNoMount(given) };
|
|
86
|
+
}
|
|
87
|
+
return { canonical: virtual };
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/** The entries of a value as written: trimmed, the blanks left out. */
|
|
91
|
+
const writtenEntries = (value: string): string[] => value.split(/[,\n]/).map((e) => e.trim()).filter((e) => e.length > 0);
|
|
92
|
+
|
|
93
|
+
/** Why a value of paths.deny or paths.allow is refused by /config set, on its notation alone (which mount an entry
|
|
94
|
+
* lies under is the run's to judge, with the host's layout): no entry, an entry holding a quote, one naming every path. */
|
|
95
|
+
export function pathListProblem(value: string): string | undefined {
|
|
96
|
+
const entries = writtenEntries(value);
|
|
97
|
+
if (entries.length === 0) return `no entry (${PATH_ENTRY_RULE})`;
|
|
98
|
+
for (const entry of entries) {
|
|
99
|
+
if (/["'`]/.test(entry)) return holdsAQuote(entry, PATH_ENTRY_RULE);
|
|
100
|
+
if (/^[\\/]?\*?[\\/]?$/.test(entry)) return namesEveryPath(entry, PATH_ENTRY_RULE);
|
|
101
|
+
}
|
|
102
|
+
return undefined;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/** The patterns one canonical entry stands for: a bare path covers itself and what is below it. */
|
|
106
|
+
const patternsOf = (canonical: string): string[] => canonical.includes("*") ? [canonical] : [canonical, `${canonical}/*`];
|
|
107
|
+
|
|
108
|
+
/** The entries of one value, each canonical, in the order given; `problems` says what was left out and why. */
|
|
109
|
+
export function parsePathEntries(value: unknown, layout: HostLayout): { entries: string[]; problems: string[] } {
|
|
110
|
+
const given = writtenEntries(String(value ?? ""));
|
|
111
|
+
const entries: string[] = [];
|
|
112
|
+
const problems: string[] = [];
|
|
113
|
+
for (const entry of given) {
|
|
114
|
+
const { canonical, problem } = canonicalEntry(entry, layout);
|
|
115
|
+
if (problem !== undefined) problems.push(problem);
|
|
116
|
+
else if (canonical !== undefined && !entries.includes(canonical)) entries.push(canonical);
|
|
117
|
+
}
|
|
118
|
+
return { entries, problems };
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/** Whether `path` lies within what `pattern` covers, case folded as the host folds it. */
|
|
122
|
+
function within(pattern: string, path: string, layout: HostLayout): boolean {
|
|
123
|
+
return globMatches(folded(pattern, layout), folded(path, layout));
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
/** A path as it is compared: lower-cased where the host's file system ignores the case (every path on native Windows,
|
|
127
|
+
* a path under a mount whose base is a Windows drive under WSL), as written elsewhere. */
|
|
128
|
+
function folded(path: string, layout: HostLayout): string {
|
|
129
|
+
if (layout.flavour === "windows") return path.toLowerCase();
|
|
130
|
+
if (layout.flavour !== "wsl") return path;
|
|
131
|
+
const virtual = `/${path.split("/")[1] ?? ""}`;
|
|
132
|
+
const mount = layout.mounts.find((m) => m.virtual === virtual);
|
|
133
|
+
const onDrive = mount !== undefined
|
|
134
|
+
&& ((mount.posix !== undefined && underAutomount(mount.posix, layout)) || /^[A-Za-z]:/.test(mount.windows ?? ""));
|
|
135
|
+
return onDrive ? path.toLowerCase() : path;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/**
|
|
139
|
+
* The lists as they apply: the user's denies and the project's, added; the user's allows, and the project's allow
|
|
140
|
+
* entries within them — a project file narrows, never widens: when the user allows nothing in particular, the
|
|
141
|
+
* project's allows stand whole. Every entry canonical; the problems name each entry left out, with its key.
|
|
142
|
+
*/
|
|
143
|
+
export function readPathLists(user: PathListValues, project: PathListValues, layout: HostLayout): PathListsParse {
|
|
144
|
+
const problems: string[] = [];
|
|
145
|
+
const read = (value: unknown, key: string, who: string): string[] => {
|
|
146
|
+
const parsed = parsePathEntries(value, layout);
|
|
147
|
+
problems.push(...parsed.problems.map((p) => `${key} (${who}): ${p}`));
|
|
148
|
+
return parsed.entries;
|
|
149
|
+
};
|
|
150
|
+
const userDeny = read(user.deny, PATHS_DENY_CONFIG_KEY, "user");
|
|
151
|
+
const projectDeny = read(project.deny, PATHS_DENY_CONFIG_KEY, "project");
|
|
152
|
+
const userAllow = read(user.allow, PATHS_ALLOW_CONFIG_KEY, "user");
|
|
153
|
+
const projectAllow = read(project.allow, PATHS_ALLOW_CONFIG_KEY, "project").filter((entry) => {
|
|
154
|
+
const kept = userAllow.length === 0 || userAllow.some((u) => patternsOf(u).some((p) => within(p, entry, layout)));
|
|
155
|
+
if (!kept) problems.push(outsideUserList(PATHS_ALLOW_CONFIG_KEY, entry));
|
|
156
|
+
return kept;
|
|
157
|
+
});
|
|
158
|
+
const unique = (entries: string[]): string[] => [...new Set(entries.flatMap(patternsOf))];
|
|
159
|
+
return { deny: unique([...userDeny, ...projectDeny]), allow: unique([...userAllow, ...projectAllow]), problems };
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* The project's paths.allow as it applies over the user's, judged without the host (the config schema's layering,
|
|
164
|
+
* /config list and /doctor): an entry within the user's list is kept as written, one outside it is dropped; an entry
|
|
165
|
+
* the identity host cannot read (a physical spelling) is kept, the run judges it with the layout. A user allowing
|
|
166
|
+
* nothing in particular keeps them all, as readPathLists does.
|
|
167
|
+
*/
|
|
168
|
+
export function narrowAllowValue(project: string, user: string | undefined): { kept: string[]; dropped: string[] } {
|
|
169
|
+
const userPatterns = user === undefined ? [] : parsePathEntries(user, IDENTITY_HOST).entries.flatMap(patternsOf);
|
|
170
|
+
if (userPatterns.length === 0) return { kept: writtenEntries(project), dropped: [] };
|
|
171
|
+
const kept: string[] = [];
|
|
172
|
+
const dropped: string[] = [];
|
|
173
|
+
for (const entry of writtenEntries(project)) {
|
|
174
|
+
const { canonical } = canonicalEntry(entry, IDENTITY_HOST);
|
|
175
|
+
const inside = canonical === undefined || userPatterns.some((p) => within(p, canonical, IDENTITY_HOST));
|
|
176
|
+
(inside ? kept : dropped).push(entry);
|
|
177
|
+
}
|
|
178
|
+
return { kept, dropped };
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
/** The entries of a list as a reader meets them: each canonical entry once, without the `<entry>/*` twin a bare entry
|
|
182
|
+
* stands for. */
|
|
183
|
+
export function listedEntries(patterns: readonly string[]): string[] {
|
|
184
|
+
return patterns.filter((p) => !(p.endsWith("/*") && patterns.includes(p.slice(0, -2))));
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/** The spellings the gate may meet a canonical pattern in: itself, and relative to the project when under it. */
|
|
188
|
+
function gateForms(pattern: string): string[] {
|
|
189
|
+
return pattern.startsWith(`${WORKSPACE}/`) ? [pattern, pattern.slice(WORKSPACE.length + 1)] : [pattern];
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
/**
|
|
193
|
+
* The deny rules of the lists for the gate, on the canonical spelling and the relative one: each pattern on the
|
|
194
|
+
* `path` of every reading and writing tool; a shell rule on the absolute pattern as a run of the command's text; and
|
|
195
|
+
* once a deny exists, the tools whose paths the gate cannot read denied whole (UNSCOPED_READ_TOOLS and
|
|
196
|
+
* UNSCOPED_WRITE_TOOLS). An allow gives the gate nothing: it narrows, and pathListRefusal holds it. The other
|
|
197
|
+
* spellings and the host's case are pathListRefusal's too.
|
|
198
|
+
*/
|
|
199
|
+
export function pathListRules(lists: PathLists): PermissionRule[] {
|
|
200
|
+
if (lists.deny.length === 0) return [];
|
|
201
|
+
const tools = [...PATH_READ_TOOLS, ...PATH_WRITE_TOOLS];
|
|
202
|
+
const paths = lists.deny.flatMap((pattern) => denyEach(tools, "path", gateForms(pattern)));
|
|
203
|
+
const commands = lists.deny.filter((p) => !p.endsWith("/*")).map((p): PermissionRule =>
|
|
204
|
+
({ effect: "deny", tool: "shell_command", argument: "command", pattern: `*${p}*` }));
|
|
205
|
+
return [...paths, ...commands, ...denyWhole([...UNSCOPED_READ_TOOLS, ...UNSCOPED_WRITE_TOOLS])];
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
/** The built-in rules that close the whole /user-config mount to the model: its readers and writers by path, the
|
|
209
|
+
* folder readers on the mount itself, and any shell command naming it. In force beside the memory rules. */
|
|
210
|
+
export function userConfigRules(): PermissionRule[] {
|
|
211
|
+
return [
|
|
212
|
+
...denyEach([...PATH_READ_TOOLS, ...PATH_WRITE_TOOLS], "path", [`${USER_CONFIG_MOUNT}/*`]),
|
|
213
|
+
...denyEach(FOLDER_READ_TOOLS, "path", [USER_CONFIG_MOUNT]),
|
|
214
|
+
{ effect: "deny", tool: "shell_command", argument: "command", pattern: `*${USER_CONFIG_MOUNT}*` },
|
|
215
|
+
];
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
const BUILT_IN_DENIES: readonly string[] = [USER_CONFIG_MOUNT, `${USER_CONFIG_MOUNT}/*`];
|
|
219
|
+
|
|
220
|
+
/** A path named by a call: as the call spells it, and canonical. A word of a shell command that names no mount
|
|
221
|
+
* (`/dev/null`, `/usr/bin/env`) is `unmounted`: a deny may still cover it, the allow list does not judge it. */
|
|
222
|
+
interface NamedPath { given: string; canonical: string; unmounted?: boolean }
|
|
223
|
+
|
|
224
|
+
/** A spelling to its canonical virtual path: a relative one under the project; a Windows spelling under no mount
|
|
225
|
+
* stays as written (the VFS refuses it anyway) and a deny never matches it. */
|
|
226
|
+
function canonicalOf(given: string, layout: HostLayout): string {
|
|
227
|
+
const virtual = toVirtual(given, layout);
|
|
228
|
+
if (windowsSpelled(virtual)) return virtual;
|
|
229
|
+
return normalisePath(virtual.startsWith("/") ? virtual : `${WORKSPACE}/${virtual}`);
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
const plain = (value: unknown): string | undefined => typeof value === "string" && value.trim() !== "" ? value.trim() : undefined;
|
|
233
|
+
|
|
234
|
+
/** The words of a shell command that name a path: absolute or Windows spelled, or holding a separator (a relative
|
|
235
|
+
* path); the value of a `key=value` word (`--out=…`, `FOO=…`), the target of a redirection (`2>/dev/null`); never
|
|
236
|
+
* an option, a URL or a bare word. The command is read with its physical spellings canonicalised first
|
|
237
|
+
* (textToVirtual), so an unquoted Windows path with spaces is one word, never its fragments. */
|
|
238
|
+
function commandPaths(command: string, layout: HostLayout): string[] {
|
|
239
|
+
const words = new Set(shellCommandForms(textToVirtual(command, layout)).flatMap(shellWords));
|
|
240
|
+
const paths: string[] = [];
|
|
241
|
+
for (const word of words) {
|
|
242
|
+
const equals = word.indexOf("=");
|
|
243
|
+
const assigned = equals > 0 && !/[/\\]/.test(word.slice(0, equals)) ? word.slice(equals + 1) : word;
|
|
244
|
+
const value = assigned.replace(/^[0-9]*[<>]{1,2}&?/, "");
|
|
245
|
+
if (value === "" || value.startsWith("-") || /^[a-z][a-z0-9+.-]*:\/\//i.test(value)) continue;
|
|
246
|
+
const pathLike = value.startsWith("/") || windowsSpelled(value) || /[/\\]/.test(value);
|
|
247
|
+
if (pathLike && !paths.includes(value)) paths.push(value);
|
|
248
|
+
}
|
|
249
|
+
return paths;
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
/** Every path one call names, canonical beside its spelling. */
|
|
253
|
+
function namedPaths(tool: string, args: Readonly<Record<string, unknown>>, layout: HostLayout): NamedPath[] {
|
|
254
|
+
const given: string[] = [];
|
|
255
|
+
for (const field of ["path", "root_path", "working_directory"]) {
|
|
256
|
+
const value = plain(args[field]);
|
|
257
|
+
if (value !== undefined) given.push(value);
|
|
258
|
+
}
|
|
259
|
+
if (Array.isArray(args.paths)) given.push(...args.paths.map(plain).filter((p): p is string => p !== undefined));
|
|
260
|
+
if (sameToolName(tool, OPERATIONS_TOOL) && Array.isArray(args.operations)) {
|
|
261
|
+
for (const op of args.operations) {
|
|
262
|
+
const path = op !== null && typeof op === "object" ? plain((op as { path?: unknown }).path) : undefined;
|
|
263
|
+
if (path !== undefined) given.push(path);
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
given.push(...reachedPaths(tool, args));
|
|
267
|
+
const named: NamedPath[] = [...new Set(given)].map((g) => ({ given: g, canonical: canonicalOf(g, layout) }));
|
|
268
|
+
if (sameToolName(tool, "shell_command") && typeof args.command === "string") {
|
|
269
|
+
for (const word of commandPaths(args.command, layout)) {
|
|
270
|
+
const canonical = canonicalOf(word, layout);
|
|
271
|
+
if (!named.some((n) => n.given === word)) named.push({ given: word, canonical, unmounted: !onMount(canonical, layout) });
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
return named;
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
const spelled = (p: NamedPath): string => p.given === p.canonical ? `'${p.given}'` : `'${p.given}' (${p.canonical})`;
|
|
278
|
+
|
|
279
|
+
/**
|
|
280
|
+
* Why a call falls under the lists, or null: the first path it names (its `path`, `root_path`, `working_directory`,
|
|
281
|
+
* `paths`, each operation of an edit_batch, what a folder reader reaches, the words of a shell command) that a deny
|
|
282
|
+
* pattern covers, the built-in deny of /user-config included; else, when an allow list stands, the first path outside
|
|
283
|
+
* every allow pattern, the words of a shell command that name no mount (`/dev/null`) apart. Each path read canonical
|
|
284
|
+
* and in the host's case. Best effort on a shell command: what a script reaches by itself, and a folder reader over
|
|
285
|
+
* a folder above a denied one, are outside this check.
|
|
286
|
+
*/
|
|
287
|
+
export function pathListRefusal(lists: PathLists, layout: HostLayout, tool: string, input: unknown): string | null {
|
|
288
|
+
const args = input !== null && typeof input === "object" && !Array.isArray(input) ? input as Readonly<Record<string, unknown>> : {};
|
|
289
|
+
const named = namedPaths(tool, args, layout);
|
|
290
|
+
for (const path of named) {
|
|
291
|
+
const builtIn = BUILT_IN_DENIES.find((p) => within(p, path.canonical, layout));
|
|
292
|
+
if (builtIn !== undefined) return refusedOwnMount(tool, spelled(path), USER_CONFIG_MOUNT);
|
|
293
|
+
const deny = lists.deny.find((p) => within(p, path.canonical, layout));
|
|
294
|
+
if (deny !== undefined) return refusedByDeny(tool, spelled(path), PATHS_DENY_CONFIG_KEY, deny);
|
|
295
|
+
}
|
|
296
|
+
if (lists.allow.length === 0) return null;
|
|
297
|
+
const outside = named.find((path) => path.unmounted !== true && !lists.allow.some((p) => within(p, path.canonical, layout)));
|
|
298
|
+
return outside === undefined ? null : outsideAllow(tool, spelled(outside), PATHS_ALLOW_CONFIG_KEY);
|
|
299
|
+
}
|