Add portable AI sourceosctl plugin parser

Author: mdheller

sourceosctl/commands/portable_ai_cli.py

@@ -0,0 +1,106 @@
+"""Argument parser for the SourceOS Portable AI Kit command group."""
+
+from __future__ import annotations
+
+import argparse
+
+from sourceosctl.commands import portable_ai
+
+
+SURFACES = [
+    "turtleterm",
+    "agent-term",
+    "bearbrowser",
+    "local-web",
+    "anythingllm-adapter",
+]
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="sourceosctl portable-ai",
+        description="SourceOS Portable AI Kit helpers (dry-run / evidence-first surface)",
+    )
+    sub = parser.add_subparsers(dest="command", metavar="<command>")
+    sub.required = True
+
+    profiles_p = sub.add_parser("profiles", help="List built-in portable AI profiles")
+    profiles_p.set_defaults(func=portable_ai.profiles)
+
+    preflight_p = sub.add_parser(
+        "preflight",
+        help="Inspect a portable root target without mutating it",
+    )
+    preflight_p.add_argument("target_root", help="Target USB/SSD portable root")
+    preflight_p.add_argument(
+        "--benchmark",
+        action="store_true",
+        default=False,
+        help="Reserve flag for future read/write benchmark",
+    )
+    preflight_p.set_defaults(func=portable_ai.preflight)
+
+    prepare_p = sub.add_parser(
+        "prepare",
+        help="Render or execute portable root materialization",
+    )
+    prepare_p.add_argument("target_root", help="Target USB/SSD portable root")
+    prepare_p.add_argument(
+        "--profile",
+        default="laptop-safe",
+        choices=sorted(portable_ai.PORTABLE_PROFILES),
+        help="Portable profile",
+    )
+    prepare_p.add_argument(
+        "--dry-run",
+        action="store_true",
+        default=True,
+        dest="dry_run",
+        help="Render plan without writing files",
+    )
+    prepare_p.add_argument(
+        "--execute",
+        action="store_true",
+        default=False,
+        help="Create declared portable-root directories and manifest",
+    )
+    prepare_p.add_argument(
+        "--policy-ok",
+        action="store_true",
+        default=False,
+        help="Confirm policy/operator approval for materialization",
+    )
+    prepare_p.add_argument("--evidence-out", default=None, help="Optional evidence JSON path")
+    prepare_p.set_defaults(func=portable_ai.prepare)
+
+    start_p = sub.add_parser(
+        "start-plan",
+        help="Render a local runtime/surface launch plan without starting daemons",
+    )
+    start_p.add_argument("target_root", help="Target USB/SSD portable root")
+    start_p.add_argument(
+        "--surface",
+        default="turtleterm",
+        choices=SURFACES,
+        help="Launch surface",
+    )
+    start_p.set_defaults(func=portable_ai.start_plan)
+
+    inspect_p = sub.add_parser("inspect", help="Inspect portable root layout state")
+    inspect_p.add_argument("target_root", help="Target USB/SSD portable root")
+    inspect_p.set_defaults(func=portable_ai.inspect)
+
+    evidence_p = sub.add_parser("evidence", help="Portable AI evidence helpers")
+    evidence_sub = evidence_p.add_subparsers(dest="evidence_command", metavar="<subcommand>")
+    evidence_sub.required = True
+    evidence_inspect_p = evidence_sub.add_parser("inspect", help="Inspect portable AI evidence JSON")
+    evidence_inspect_p.add_argument("path", help="Evidence JSON path")
+    evidence_inspect_p.set_defaults(func=portable_ai.evidence_inspect)
+
+    return parser
+
+
+def main(argv=None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    return args.func(args) or 0