mirror of
https://github.com/instructkr/claw-code.git
synced 2026-04-05 23:54:50 +08:00
c2f1304a01
This adds a deterministic mock Anthropic-compatible /v1/messages service, a clean-environment CLI harness, and repo docs so the first parity milestone can be validated without live network dependencies. Constraint: First milestone must prove Rust claw can connect from a clean environment and cover streaming, tool assembly, and permission/tool flow Constraint: No new third-party dependencies; reuse the existing Rust workspace stack Rejected: Record/replay live Anthropic traffic | nondeterministic and unsuitable for repeatable CI coverage Confidence: high Scope-risk: moderate Reversibility: clean Directive: Keep scenario markers and expected tool payload shapes synchronized between the mock service and the harness tests Tested: cargo fmt --all Tested: cargo clippy --workspace --all-targets -- -D warnings Tested: cargo test --workspace Tested: ./scripts/run_mock_parity_harness.sh Not-tested: Live Anthropic responses beyond the five scripted harness scenarios
5.4 KiB
5.4 KiB
Parity Status — claw-code Rust Port
Last updated: 2026-04-03 (03bd7f0)
Mock parity harness — milestone 1
- Deterministic Anthropic-compatible mock service (
rust/crates/mock-anthropic-service) - Reproducible clean-environment CLI harness (
rust/crates/rusty-claude-cli/tests/mock_parity_harness.rs) - Scripted scenarios:
streaming_text,read_file_roundtrip,grep_chunk_assembly,write_file_allowed,write_file_denied
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 executionpathValidation— validate file paths in commandsreadOnlyValidation— block writes in read-only modedestructiveCommandWarning— warn on rm -rf, etc.commandSemantics— classify command intentbashPermissions— permission gating per command typebashSecurity— security checksmodeValidation— validate against current permission modeshouldUseSandbox— 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 validated by the mock parity harness
Migration Readiness
PARITY.mdmaintained and honest- No
#[ignore]tests hiding failures (only 1 allowed:live_stream_smoke_test) - CI green on every commit
- Codebase shape clean for handoff