feat: add guided one-command installer

scripts/agent_installer/cli.py

@@ -11,6 +11,7 @@ from .common import (
     json,
 )
 from .diagnostics import doctor_project
+from .flow import install_project
 from .project import inspect_project, prepare_project, render_client_config, set_config_env
 
 
@@ -24,6 +25,11 @@ def _print_result(payload: dict[str, Any], *, as_json: bool) -> None:
     for check in payload.get("checks", []):
         marker = "PASS" if check["ok"] else ("FAIL" if check["required"] else "INFO")
         print(f"[{marker}] {check['name']}: {check['detail']}")
+    if "status" in payload:
+        print(f"Status: {payload['status']}")
+    if "clientConfig" in payload:
+        print("Client configuration:")
+        print(json.dumps(payload["clientConfig"], ensure_ascii=False, indent=2))
 
 
 def build_parser() -> argparse.ArgumentParser:
@@ -31,6 +37,12 @@ def build_parser() -> argparse.ArgumentParser:
     parser.add_argument("--project-root", type=Path, default=None)
     subparsers = parser.add_subparsers(dest="command", required=True)
 
+    install = subparsers.add_parser("install", help="Run the complete guided local installation flow.")
+    install.add_argument("--api-base-url", required=True)
+    install.add_argument("--env-name", default=DEFAULT_ENV_NAME)
+    install.add_argument("--enable-writes", action="store_true")
+    install.add_argument("--json", action="store_true", dest="as_json")
+
     for name in ("inspect", "prepare", "doctor"):
         command = subparsers.add_parser(name)
         command.add_argument("--json", action="store_true", dest="as_json")
@@ -53,6 +65,15 @@ def main(argv: Sequence[str] | None = None) -> int:
     parser = build_parser()
     args = parser.parse_args(argv)
     try:
+        if args.command == "install":
+            payload = install_project(
+                args.project_root,
+                args.api_base_url,
+                env_name=args.env_name,
+                enable_writes=args.enable_writes,
+            )
+            _print_result(payload, as_json=args.as_json)
+            return 0 if payload["ok"] else 1
         if args.command == "inspect":
             payload = inspect_project(args.project_root)
             _print_result(payload, as_json=args.as_json)