claw-code/PARITY.md

Parity Status — claw-code Rust Port

Last updated: 2026-04-03 (03bd7f0)

Tool Surface: 40/40 (spec parity)

Real Implementations (behavioral parity — varying depth)

Tool	Rust Impl	Behavioral Notes
bash	runtime::bash 283 LOC	subprocess exec, timeout, background, sandbox — strong parity. Missing: sedValidation, pathValidation, readOnlyValidation, destructiveCommandWarning, commandSemantics (upstream has 18 submodules for bash alone)
read_file	runtime::file_ops	offset/limit read — good parity
write_file	runtime::file_ops	file create/overwrite — good parity
edit_file	runtime::file_ops	old/new string replacement — good parity. Missing: replace_all was recently added
glob_search	runtime::file_ops	glob pattern matching — good parity
grep_search	runtime::file_ops	ripgrep-style search — good parity
WebFetch	tools	URL fetch + content extraction — moderate parity (need to verify content truncation, redirect handling vs upstream)
WebSearch	tools	search query execution — moderate parity
TodoWrite	tools	todo/note persistence — moderate parity
Skill	tools	skill discovery/install — moderate parity
Agent	tools	agent delegation — moderate parity
ToolSearch	tools	tool discovery — good parity
NotebookEdit	tools	jupyter notebook cell editing — moderate parity
Sleep	tools	delay execution — good parity
SendUserMessage/Brief	tools	user-facing message — good parity
Config	tools	config inspection — moderate parity
EnterPlanMode	tools	worktree plan mode toggle — good parity
ExitPlanMode	tools	worktree plan mode restore — good parity
StructuredOutput	tools	passthrough JSON — good parity
REPL	tools	subprocess code execution — moderate parity
PowerShell	tools	Windows PowerShell execution — moderate parity

Stubs Only (surface parity, no behavior)

Tool	Status	Notes
AskUserQuestion	stub	needs user I/O integration
TaskCreate	stub	needs sub-agent runtime
TaskGet	stub	needs task registry
TaskList	stub	needs task registry
TaskStop	stub	needs process management
TaskUpdate	stub	needs task message passing
TaskOutput	stub	needs output capture
TeamCreate	stub	needs parallel task orchestration
TeamDelete	stub	needs team lifecycle
CronCreate	stub	needs scheduler runtime
CronDelete	stub	needs cron registry
CronList	stub	needs cron registry
LSP	stub	needs language server client
ListMcpResources	stub	needs MCP client
ReadMcpResource	stub	needs MCP client
McpAuth	stub	needs OAuth flow
MCP	stub	needs MCP tool proxy
RemoteTrigger	stub	needs HTTP client
TestingPermission	stub	test-only, low priority

Slash Commands: 67/141 upstream entries

• 27 original specs (pre-today) — all with real handlers
• 40 new specs — parse + stub handler ("not yet implemented")
• Remaining ~74 upstream entries are internal modules/dialogs/steps, not user /commands

Missing Behavioral Features (in existing real tools)

Bash tool — upstream has 18 submodules, Rust has 1:

• sedValidation — validate sed commands before execution
• pathValidation — validate file paths in commands
• readOnlyValidation — block writes in read-only mode
• destructiveCommandWarning — warn on rm -rf, etc.
• commandSemantics — classify command intent
• bashPermissions — permission gating per command type
• bashSecurity — security checks
• modeValidation — validate against current permission mode
• shouldUseSandbox — sandbox decision logic

File tools — need verification:

• Path traversal prevention (symlink following, ../ escapes)
• Size limits on read/write
• Binary file detection
• Permission mode enforcement (read-only vs workspace-write)

Config/Plugin/MCP flows:

• Full MCP server lifecycle (connect, list tools, call tool, disconnect)
• Plugin install/enable/disable/uninstall full flow
• Config merge precedence (user > project > local)

Runtime Behavioral Gaps

• Permission enforcement across all tools (read-only, workspace-write, danger-full-access)
• Output truncation (large stdout/file content)
• Session compaction behavior matching
• Token counting / cost tracking accuracy
• Streaming response support

Migration Readiness

• PARITY.md maintained and honest
• No #[ignore] tests hiding failures (only 1 allowed: live_stream_smoke_test)
• CI green on every commit
• Codebase shape clean for handoff