feat(acp): complete capability matrix

[yan-ad]

Summary

Complete the Crabcode ACP capability matrix and make crabcode acp fully functional across session lifecycle, prompts, tools, permissions, commands, MCP, terminals, questions, cancellation, and usage accounting.

Highlights

• complete persisted session lifecycle with cursor pagination, hierarchy metadata, stable message IDs, fork isolation, close, and delete
• support persistent image/audio prompt attachments with legacy attachment migration and WAV/MP3 audio routing
• stream full and structured tool results, normalized locations, native diffs/media/resources, and MCP annotations/metadata
• preserve real permission tool-call IDs and provide non-mutating preflight diffs, including multi-file apply_patch
• forward interactive questions through capability-gated ACP form elicitation
• embed client-hosted terminals with create/wait/output/kill/release and cancellation support
• add ACP /compact, local /skills and /mcp, custom command overrides, and explicit unknown-command errors
• retain provider stop reasons and authoritative input/output/cache usage with persisted, cache-aware cost accounting
• resolve ACP context-window size from the effective selectable model catalog, including custom and runtime model metadata (supersedes fix(acp): report model context window #16)
• add stdio subprocess initialization and clean-EOF integration coverage
• update _docs/acp.mdx so all Crabcode-side capability areas are marked Full, with editor/model/protocol requirements documented separately

Storage and compatibility

• adds persistence fields/migrations for authoritative usage and durable attachment metadata
• attachments are stored per session under Crabcode state storage and copied independently on fork
• _meta.crabcode extensions expose hierarchy and detailed usage while preserving ACP compatibility
• unsupported future MCP content remains available through lossless raw/text fallback

Validation

• focused ACP, session, persistence, provider, MCP, permission, question, terminal, attachment, audio, compaction, and tool tests pass
• ACP stdio subprocess lifecycle test passes
• cargo check passes
• cargo fmt passes
• scripts/check-aisdk-boundary.sh passes

The repository-wide suite still exposes pre-existing shared global test-state coupling when session tests run in one process. Those session tests pass with isolated XDG_STATE_HOME; two unrelated existing failures remain in model-cache fixture and renderer-path assertions.

• Wires slash commands end-to-end over ACP stdio, including /compact, /skills, /mcp, /btw, custom commands, and workspace skills; preserves embedded context during expansion

TUI command discoverability

• Keeps chat-only commands such as /compact, /fork, and /timeline visible in slash autocomplete and the command palette from Home, labeled as available during chat.
• Execution remains guarded outside an active chat, with a clear error instead of silently hiding the command.
• Applies OpenCode-compatible compaction.auto, compaction.prune, and compaction.reserved across persisted TUI/ACP sessions and request-local print/subagent pruning.

[yan-ad]

@Blankeos The ACP compatibility matrix is now fully covered from the Crabcode side.

I have also integrated the complete branch into yan-flavor and have been running it in our local environment. The ACP workflows have been working well there, including session operations, tool calls, permission handling, live context/usage reporting, compaction, commands, attachments, and transport lifecycle behavior.

The latest validation passed:

• cargo check
• 47 ACP service tests
• 3 wire-level ACP stdio tests
• formatting and diff checks

From our side, this is ready for review and merge. Any remaining compatibility constraints documented in _docs/acp.mdx are editor, provider, model, or protocol runtime requirements rather than known Crabcode-side capability gaps.

[Blankeos]

Added maintainer follow-up fixes for terminal provider stop reasons, cancellation and partial-transcript persistence, close/reopen ownership, delayed terminal cleanup, protected permission previews, cache-aware token totals, and invalid-load validation before discovery. Added login-only terminal auth discovery (modern append args and legacy registry replacement args), gzip release archives, stderr-only npm installation diagnostics, and regressions. Current-main integration passes cargo check, 63 ACP unit tests, 42 request-loop tests, 7 stdio tests, fmt and SDK boundary checks; stdio suite also passed three consecutive runs on PR head. Official registry auth checker passes against the local binary; local-provider login passed in isolated PTY. Full-suite run identified two UI assertions also reproduced on untouched PR head; not claiming the full suite green. No tag or publication. Registry submission intentionally deferred; tracking readiness 8/10 in #59.