scene)¶

Статус: Accepted (one-shot + background long-run)
Дата: 2026-07-23
Tags: #shell #terminal #agent-comfort #equal-standing #harness #adr #cascade-ide

Резюме¶

У Operator есть реальный shell + ↑ + несколько вкладок. Агенту в CDP нужен тот же habitat: именованные tabs, системные shells (Win: pwsh/cmd; Unix: $SHELL), history/rerun, и cdp_shell_scene — карта всех вкладок сразу (twin к git_scene), без switch→watch→switch.

Связанные ADR¶

ADR	Роль
0002	Human–agent parity
0176	Affordance map
0178	Scene pattern (git)
0179	Progress ≠ unblock; long-run uses poll scene/last
0166	Agent comfort = product

Контекст¶

Cursor Shell / terminals folder ≠ leather REPL continuity. Simulator pitch + Kolb kj-20260723-1312 сделали gap явным. WT / ConPTY = emulator layer позже; MVP = attach to stock shells.

Решение¶

Verbs (meta, always-on)¶

Tool	Job
`cdp_shell_scene`	All tabs: id, shell, cwd, state, pid, last cmd/exit, capped preview
`cdp_shell_run`	One command; optional `tab` / `cwd` / `shell` / `timeout_seconds` / `background`
`cdp_shell_history`	Last N meta rows (no full stdout dump)
`cdp_shell_rerun`	By index or last (↑); optional `background`
`cdp_shell_last`	Capped body; while running → live buffers
`cdp_shell_which`	Shell kind + exe + cwd + pid/state
`cdp_shell_kill`	Kill process tree on tab
`cdp_shell_close`	Close tab (kills if needed); frees slot

Default cwd: tab cwd → session.ProjectRoot → session.ScmRoot → process cwd. Caps: 8 tabs, 50 history/tab, stdout body / live buffer caps.

Execution model¶

Foreground (default): one-shot process; timeout; history append.
Background (background=true): return immediately with pid; tab stays running; poll scene/last; stop with kill. Not ConPTY — still one process per command, but long-lived.
Parallelism = several tabs / several tool calls in one turn.
Prefer cdp_build/cdp_run/cdp_test for session project lifecycle when they fit; shell for the rest of the world.
IDE-first: agent uses cdp_shell_* as the normal IDE terminal (like leather). Sibling terminal-mcp (terminal_*) is an escape hatch (CDP down/redeploy, or a job that must outlive CDP) — not the default long-run home.

Где жить¶

Слой	Роль
`terminal-mcp-core` (`ShellHabitat`)	Shared habitat
`cdp-mcp` (`cdp_shell_*`)	Primary — IDE terminal + session cwd
`terminal-mcp` (`terminal_*`)	Escape — survives CDP kill/redeploy
Cursor rule `cdp-shell-habitat.mdc`	Agent habit (IDE-first)
CSX facade (later)	`Shell.*` twin

Последствия¶

Equal standing: ↑ + multi-tab + scene — terminal in the agent-IDE.
Dual host: CDP shell stays primary; sibling terminal-mcp = escape (kj-1358). CDP redeploy survival is a side effect of the escape hatch, not the product pitch.
CDP deploy/KillRunning from external process (cannot kill own tree).
Backlog: ConPTY / persistent REPL; WT profile as Operator plug; CSX ShellFacade; optional session hint for escape host cwd.

Отклонённые альтернативы¶

Только учить агента Cursor Shell — отклонено: continuity не в harness CDP.
WT feature parity в MCP — отклонено: wrong layer; shell first.
Fake in-proc string runner as “shell” — отклонено: not equal standing with real pwsh/cmd.
«Deploy outside» / «always use terminal-mcp for long-run» as primary UX — отклонено: IDE-first cdp_shell_*; escape host is secondary.
Удалить cdp_shell_* из CDP — отклонено: session cwd + «терминал в IDE» — primary.

Dogfood¶

Kolb: kj-20260723-1312, kj-20260723-1358. Wire: cdp-mcp 0.5.78+ + terminal-mcp 0.1.0+ (D:\terminal-mcp\).