Add CLI subcommands and doctor diagnostics

tests/test_aman_cli.py

@@ -0,0 +1,58 @@
+import io
+import json
+import sys
+import unittest
+from pathlib import Path
+from unittest.mock import patch
+
+ROOT = Path(__file__).resolve().parents[1]
+SRC = ROOT / "src"
+if str(SRC) not in sys.path:
+    sys.path.insert(0, str(SRC))
+
+import aman
+from diagnostics import DiagnosticCheck, DiagnosticReport
+
+
+class AmanCliTests(unittest.TestCase):
+    def test_parse_cli_args_defaults_to_run_command(self):
+        args = aman._parse_cli_args(["--dry-run"])
+
+        self.assertEqual(args.command, "run")
+        self.assertTrue(args.dry_run)
+
+    def test_parse_cli_args_doctor_command(self):
+        args = aman._parse_cli_args(["doctor", "--json"])
+
+        self.assertEqual(args.command, "doctor")
+        self.assertTrue(args.json)
+
+    def test_doctor_command_json_output_and_exit_code(self):
+        report = DiagnosticReport(
+            checks=[DiagnosticCheck(id="config.load", ok=True, message="ok", hint="")]
+        )
+        args = aman._parse_cli_args(["doctor", "--json"])
+        out = io.StringIO()
+        with patch("aman.run_diagnostics", return_value=report), patch("sys.stdout", out):
+            exit_code = aman._doctor_command(args)
+
+        self.assertEqual(exit_code, 0)
+        payload = json.loads(out.getvalue())
+        self.assertTrue(payload["ok"])
+        self.assertEqual(payload["checks"][0]["id"], "config.load")
+
+    def test_doctor_command_failed_report_returns_exit_code_2(self):
+        report = DiagnosticReport(
+            checks=[DiagnosticCheck(id="config.load", ok=False, message="broken", hint="fix")]
+        )
+        args = aman._parse_cli_args(["doctor"])
+        out = io.StringIO()
+        with patch("aman.run_diagnostics", return_value=report), patch("sys.stdout", out):
+            exit_code = aman._doctor_command(args)
+
+        self.assertEqual(exit_code, 2)
+        self.assertIn("[FAIL] config.load", out.getvalue())
+
+
+if __name__ == "__main__":
+    unittest.main()