Context

Implement the primary CLI commands as defined in spec 14.2. These are the core commands users will interact with to manage their AI companies and agents.

Commands to implement:

• ai-company create [--template] [--name] — Create a new company
• ai-company start <company> — Start a company simulation
• ai-company stop <company> — Stop a running company
• ai-company status — Show company status overview
• ai-company agent list — List all agents
• ai-company agent hire <role> — Hire a new agent
• ai-company agent fire <agent-id> — Fire an agent
• ai-company agent info <agent-id> — Show agent details

Acceptance Criteria

• All commands listed above are implemented and functional
• Rich terminal output used throughout (tables, colors, progress indicators)
• Comprehensive error handling with user-friendly messages
• --json flag on all commands for machine-readable output
• Help text for every command and subcommand
• Input validation on all arguments (e.g., valid agent-id format)
• Unit tests for each command with mocked dependencies
• Integration with core domain models from M3

Dependencies

• Evaluate and set up CLI framework (Typer/Click/argparse) #27 — CLI framework must be set up first
• M3 complete — Single agent execution must be functional

Design Spec Reference

• Spec 14.2 — CLI command definitions