Tianyi Cui 3422f8fa5c Merge branch 'worktree-hooks-b-bash-seam' into worktree-hooks-c-interception 2 miesięcy temu
..
bash bb9ae2ba99 docs(bash): reframe stdin/env — the scrub is the security control, not a trust boundary 2 miesięcy temu
bash-local 3422f8fa5c Merge branch 'worktree-hooks-b-bash-seam' into worktree-hooks-c-interception 2 miesięcy temu
tool-bash 1323366da3 Merge worktree-hooks-b-bash-seam into worktree-hooks-c-interception 2 miesięcy temu
README.md 5024cd5757 Document the package hierarchy and finalize the RFC 2 miesięcy temu

README.md

bash/ — bash capability family

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

Package Role ctx key
bash/ Abstract bash executor seam (interface + vocabulary) ctx.bash
bash-local/ Local-subprocess BashExecutor implementation (registers ctx.bash)
tool-bash/ Model-facing bash/bash_output/bash_kill tool schemas (registers on ctx.tools)

The interface lives at bash/bash/. A sandboxed executor would replace bash-local without touching the interface or the tool — the split is what makes that possible.