deepseek-harness/packages/bash
Tianyi Cui cb1864795e docs: prose-standard pass over the PR's added comments and one label
Current-state fixes: two test comments still named the pre-rename
spawnProcess; two narrated history ('the old whole-chunk drop', 'no
longer kills backend work') instead of the pinned contract; and the
packages/README row said process-group where the seam's own vocabulary
is process-tree (en+zh, pair re-recorded).
2026-07-27 02:06:46 +08:00
..
bash Merge branch 'worktree-tasks-service-seam' into worktree-process-service-seam 2026-07-26 20:55:58 +08:00
bash-local docs: prose-standard pass over the PR's added comments and one label 2026-07-27 02:06:46 +08:00
bash-sandbox Merge branch 'worktree-tasks-service-seam' into worktree-process-service-seam 2026-07-26 20:55:58 +08:00
tool-bash Merge branch 'worktree-tasks-service-seam' into worktree-process-service-seam 2026-07-26 20:55:58 +08:00
README.i18n.yaml docs(subprocess): bring the zh side of the subprocess pairs along after the master merge 2026-07-26 22:00:38 +08:00
README.md Merge branch 'worktree-tasks-service-seam' into worktree-process-service-seam 2026-07-26 20:55:58 +08:00
README.zh.md docs(subprocess): bring the zh side of the subprocess pairs along after the master merge 2026-07-26 22:00:38 +08:00

bash/ — bash capability family

English | 中文

The canonical three-package capability seam (see capability seams): an abstract executor interface, concrete implementations, and the model-facing tool that consumes it. All product packages.

Package Role ctx key
bash/ Abstract bash executor seam (interface + vocabulary; sandbox result facts carry the sandbox/ seam's mode/enforcement vocabulary, and the managed-env/output vocabulary is re-exported from the subprocess/ seam) ctx.bash
bash-local/ Local BashExecutor implementation over the subprocess/ service (command defaulting, deadlines, terminal env, background-read merge) (registers ctx.bash)
bash-sandbox/ Sandbox-consuming BashExecutor (wraps every command argv via ctx.sandbox, stamps denial/enforcement facts; extends bash-local's mechanics) (registers ctx.bash)
tool-bash/ Model-facing bash schema; background processes register with the generic tasks/ runtime (registers on ctx.tools)

The interface lives at bash/bash/. bash-sandbox replacing bash-local without touching the interface or the tool is the split doing exactly what it exists for — a leaf cordis.yml picks one executor entry, plus a ctx.sandbox provider entry for the confined one (see the acp-agent example's default composition).