Specify CLI behavior, inspection commands, and exit codes

[Matographo]

Summary

Document flags, positional input handling, stdout and stderr behavior, inspection commands, and the exit-code matrix.

Why

CLI ambiguity creates implementation drift and inconsistent user expectations, especially for automation and CI usage.

Deliverables

• Positional input resolution rules
• Output routing rules
• Inspection-command semantics
• Exit-code matrix

Acceptance Criteria

• CLI behavior is unambiguous
• Invalid argument combinations are specified
• Exit codes are documented by error class
• stdout and stderr usage is clearly defined

Dependencies

• None

Related Docs

• REQUIREMENTS.md