wx-cli/.gsd/milestones/M001/slices/S02/tasks/T01-PLAN.md

estimated_steps	estimated_files	skills_used
14	16

T01: Add global --tcp CLI flag and wire into transport module

Add --tcp flag as a global argument on the root Cli struct in src/cli/mod.rs, not on individual subcommands. The flag takes Option<String> (e.g., Some("127.0.0.1:9876")). Wire this through the dispatch() function so every command path receives the TCP address. Modify all cmd_* functions in src/cli/ to accept an optional tcp_addr: Option<&str> parameter. Update src/cli/transport.rs:

1. Add send_tcp(req: Request, addr: &str) -> Result<Response> function using std::net::TcpStream with 15s connect timeout and 120s read/write timeout
2. Add is_alive_tcp(addr: &str) -> bool for TCP liveness check
3. Update send() to accept tcp_addr: Option<&str>, routing to send_tcp when present
4. Update is_alive() to accept tcp_addr: Option<&str>, routing to is_alive_tcp when present
5. Update ensure_daemon() — when --tcp is specified, do NOT auto-start daemon (user explicitly chose TCP); if connection fails, hard error with clear message

Must-haves:

• 15s connect timeout on TcpStream
• 120s read/write timeout
• No silent fallback when --tcp specified
• Hard error with address and OS error on connection failure

Constraints:

• Use std::net::TcpStream (blocking, since CLI is sync)
• Keep #[cfg(unix)] / #[cfg(windows)] guards intact for local transport paths

Inputs

• src/cli/mod.rs
• src/cli/transport.rs
• src/cli/daemon_cmd.rs
• src/cli/sessions.rs
• src/ipc.rs

Expected Output

• src/cli/mod.rs
• src/cli/transport.rs

Verification

cargo check 2>&1 | tail -5; grep -c 'tcp: Option' src/cli/mod.rs; grep -q 'send_tcp' src/cli/transport.rs; grep -q 'is_alive_tcp' src/cli/transport.rs