CLI-035 — Complete command reference and troubleshooting documentation

[dDevAhmed]

Summary

Bring public CLI documentation in sync with the implemented MVP command behavior as commands land.

Scope

• expand docs/reference/commands.md with arguments/options/examples;
• document configuration requirements;
• document common failures/remediation;
• document exit behavior;
• cross-link installation/quick-start/security guidance;
• clearly mark unavailable/planned features.

Acceptance Criteria

• every implemented MVP command has accurate reference documentation;
• examples match real behavior;
• unsupported features are not presented as available;
• troubleshooting covers common setup/config/process/network failures;
• secret-safe guidance is maintained.

Dependencies

• CLI-016 through CLI-034 as applicable

---

🏷 Labels

• type: docs
• area: docs
• priority: P2
• difficulty: beginner
• good first issue