Skip to main content

Module spawn

Module spawn 

Source
Expand description

v1.0.75 (G22 solution): spawn subsystem abstraction with VersionAdapter trait for codex/claude/opencode executors. Spawn subsystem abstraction (v1.0.75 — G22 solution)

Provides VersionAdapter trait that detects the version of external CLI executors (claude code, codex CLI, opencode headless) and adapts flags, schema and error handling accordingly.

Modules§

claude_adapter
Claude Code version adapter (v1.0.75 — G22)
codex_adapter
Codex CLI version adapter (v1.0.75 — G22)
compat_matrix
Executor compatibility matrix (v1.0.75 — G22)
env_whitelist
Env whitelist for LLM subprocess spawners (v1.0.83, ADR-0041).
error_propagator
Error propagator for subprocess invocations (v1.0.75 — G22 P16/P17)
executor_version
Executor version parsing (v1.0.75 — G22)
opencode_adapter
OpenCode headless version adapter (v1.0.75 — G22)
preflight
Pre-flight validation layer for LLM subprocess spawners (v1.0.87, ADR-0045).

Structs§

ExecutorCapabilities
Detected capability of a given executor version.
ParsedOutput
Result of parsing a subprocess output stream.
VersionCache
In-memory cache of executor -> ExecutorVersion to avoid re-spawning --version on every command. Resettable via --executor-version-check.

Enums§

CompatMode
Compatibility mode controlling how strict the adapter is with version drift.

Traits§

VersionAdapter
Trait for adapting spawn invocations to a particular executor’s version.

Functions§

apply_cwd_isolation
Apply CWD isolation to a subprocess command. Sets current_dir to an ephemeral directory without .mcp.json ancestors and CLAUDE_CONFIG_DIR to block user-level MCP inheritance.
apply_cwd_isolation_tokio
Tokio variant of apply_cwd_isolation for async subprocess commands.
base_command
Reusable tokio command builder for subprocess invocation.
global_version_cache
spawn_isolation_dir
GAP-SPAWN-001 (v1.0.91): isolation directory for LLM subprocesses. Prevents .mcp.json walk-up by anchoring CWD in a clean temp dir.