[A2A] CLI Integration (serve, discover, connect, ask, delegate) #334

Overview

Extend Squad CLI with commands for cross-repo squad interaction: discover, connect, ask, delegate, broadcast.

Reference

• PRD: See tamresearch1 repo, branch squad/296-cross-repo-a2a, file .squad/research/cross-repo-a2a-prd.md
• Related Issue: tamirdresher_microsoft/tamresearch1#296
• Depends on: [A2A] Core A2A/ACP Protocol Implementation #332 (Core A2A), [A2A] Discovery Mechanism (Local + Network) #333 (Discovery)

New CLI Commands

squad serve

Start A2A server mode

• Flags: --port (default: auto), --network (opt-in), --registry (local|network)
• Behavior: Register in discovery, serve A2A endpoints, heartbeat loop

squad discover

List all discovered squads

• Output: Table with repo, port, status, capabilities
• Filter: --local, --network, --repo (pattern match)

squad connect [squad-name]

Establish connection to a squad

• Interactive: Select from discovered squads if name not provided
• Validation: Check health endpoint, test query
• Output: Connection details, available capabilities

squad ask [squad-name] [query]

Query another squad

• Examples: squad ask backend "API versioning strategy"
• Output: Decision documents, research, or response
• Flags: --format (text|json), --scope (architecture|security|...)

squad delegate [squad-name] [title]

Delegate a task to another squad

• Interactive prompt for description, priority
• Creates issue in target repo via A2A
• Output: Task ID, tracking link

squad broadcast [message]

Send message to all discovered squads

• Use cases: Breaking changes, security alerts
• Output: Delivery status per squad
• Flags: --scope (local|network)

squad health

Check health of squads

• Flags: --all (check all discovered), --squad (specific)
• Output: Status, latency, last seen

User Experience

• Zero-config for local discovery
• Intuitive command names
• Rich terminal output (colors, tables)
• Error messages with suggestions
• Progressive disclosure (simple → advanced)

Deliverables

• CLI command implementations (src/cli/a2a-commands.ts)
• Interactive prompts (inquirer.js)
• Terminal output formatting (chalk, cli-table)
• Help documentation for each command
• Man pages / --help text
• Example workflows
• Integration tests

Success Criteria

• All commands working end-to-end
• Help text clear and comprehensive
• Error handling graceful
• Performance: Commands respond <1s
• User testing: 5/5 users complete workflow without docs

Timeline

3 weeks