0 Fork 0

Files

T

Tianyi Cui fb0d4ba564 fix(process): close review gaps from Codex round 1

- Mount LocalProcessManager in the sandbox e2e compositions (bwrap/landlock/
  seatbelt + the spine multi-project e2e) and add the spine demo's
  dsh-process-local devDependency, so SandboxBashExecutor's new inject
  resolves when those suites are enabled.
- Extend the Windows test/coverage skip to packages/process/* — the POSIX
  process-group suite moved there from packages/bash.
- Update the stale disposal contract: the bash seam JSDoc, BashProcess JSDoc,
  and core bash doc (en+zh) now state that composition teardown (the process
  manager's disposal) owns kill-and-await, and an executor-only reload leaves
  background processes running.
- Record ctx.processes in the architecture capability table and extension map
  (en+zh) and the root AGENTS.md layout tree; reword the timeout-library note
  so it describes where the plumbing and classification live today.

2026-07-26 07:54:42 +08:00

bash

fix(process): close review gaps from Codex round 1

2026-07-26 07:54:42 +08:00

bash-local

refactor(process): split the process manager out of the bash executor

2026-07-26 06:59:01 +08:00

bash-sandbox

fix(process): close review gaps from Codex round 1

2026-07-26 07:54:42 +08:00

tool-bash

refactor(process): split the process manager out of the bash executor

2026-07-26 06:59:01 +08:00

README.md

refactor(process): split the process manager out of the bash executor

2026-07-26 06:59:01 +08:00

README.md

bash/ — bash capability family

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 `process/` seam)	`ctx.bash`
`bash-local/`	Local `BashExecutor` implementation over the `process/` manager (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).