feat: sprout-cli — agent-first CLI with full MCP parity (48 commands)

[tlongwell-block]

Summary

New sprout-cli crate — an agent-first, JSON-only CLI for the Sprout relay. 48 commands covering all 42 MCP tools plus token management, auth bootstrap, and additional REST-only operations. Also adds two new REST endpoints to the relay.

CLI (crates/sprout-cli)

Design: Pure JSON on stdout, structured JSON errors on stderr, meaningful exit codes (0/1/2/3/4). Designed for agent consumption — no tables, no colors, no rendering dependencies.

Auth: Three-tier resolution:

1. SPROUT_API_TOKEN — Bearer token (fastest, no extra HTTP call)
2. SPROUT_PRIVATE_KEY — auto-mints a 1-day token via NIP-98 at startup
3. SPROUT_PUBKEY — X-Pubkey header (dev mode, SPROUT_REQUIRE_AUTH_TOKEN=false)

Architecture:

sprout <command> [flags]
    │
    ├─ main.rs ──▶ commands/*.rs ──▶ client.rs ──▶ Sprout Relay REST API
    │  (clap)       (handlers)       (reqwest)
    │
    ├─ validate.rs   (UUID, hex, content size, percent-encode)
    └─ error.rs      (CliError → JSON stderr + exit code)

stdout: raw relay JSON
stderr: {"error": "category", "message": "detail"}
exit:   0=ok  1=user  2=network  3=auth  4=other

Stats: ~2900 lines across 13 source files. 38 unit tests. Clippy clean (workspace -D warnings).

Relay (2 new REST endpoints)

• PUT /api/messages/{event_id} — edit message (kind:40003)
• POST /api/messages/{event_id}/votes — vote on forum post (kind:45002)

These were previously WebSocket-only in the MCP server. Adding REST endpoints makes the relay API feature-complete and lets the CLI stay pure REST.

Commands (48 total)

Full command list

Messages: send-message, send-diff-message, edit-message, delete-message, get-messages, get-thread, search

Channels: list-channels, get-channel, create-channel, update-channel, set-channel-topic, set-channel-purpose, join-channel, leave-channel, archive-channel, unarchive-channel, delete-channel, list-channel-members, add-channel-member, remove-channel-member, get-canvas, set-canvas

Reactions: add-reaction, remove-reaction, get-reactions

DMs: list-dms, open-dm, add-dm-member

Users: get-users, set-profile, get-presence, set-presence, set-channel-add-policy

Workflows: list-workflows, create-workflow, update-workflow, delete-workflow, trigger-workflow, get-workflow-runs, get-workflow, approve-step

Feed: get-feed

Forum: vote-on-post

Auth & Tokens: auth, list-tokens, delete-token, delete-all-tokens

Testing

All 48 commands verified against a local relay. See crates/sprout-cli/TESTING.md for the full runbook.

cargo test -p sprout-cli    # 38 tests
cargo clippy -p sprout-cli  # zero warnings