Merge pull request #42 from ghasemzadeh-hamed/codex/implement-headless-setup-for-aion-os

chore: remove binary example bundle

Author: Hamedghz

Makefile

@@ -0,0 +1,18 @@
+.PHONY: dev doctor bundle test-api
+
+CONTROL_DIR=control
+CLI=PYTHONPATH=cli python -m aion.cli
+
+
+dev:
+cd $(CONTROL_DIR) && poetry run uvicorn app.main:app --host 0.0.0.0 --port 8001 --reload
+
+doctor:
+$(CLI) doctor --verbose
+
+bundle:
+@mkdir -p dist
+tar -czf dist/example-bundle.tgz -C deploy/bundles/example my-config
+
+test-api:
+cd $(CONTROL_DIR) && poetry run pytest -q tests/api

cli/aion/__init__.py

@@ -0,0 +1,5 @@
+"""AION OS command line interface package."""
+
+from .cli import app
+
+__all__ = ["app"]

cli/aion/cli.py

@@ -0,0 +1,46 @@
+"""Entrypoint for the ``aion`` Typer-based CLI."""
+from __future__ import annotations
+
+import importlib
+import sys
+from typing import Optional
+
+import typer
+
+app = typer.Typer(help="AION Operating System command line interface.")
+
+
+# Dynamically register command groups to keep startup fast when optional
+# dependencies such as Textual or FastAPI are missing.  Each module defines a
+# ``register`` function that takes the root Typer app.
+for module_name in (
+    "aion.commands.init",
+    "aion.commands.apply",
+    "aion.commands.doctor",
+    "aion.commands.auth",
+    "aion.commands.tui",
+):
+    try:
+        module = importlib.import_module(module_name)
+    except ImportError as exc:  # pragma: no cover - guard for packaging issues
+        typer.echo(f"warning: failed to import {module_name}: {exc}", err=True)
+        continue
+
+    register = getattr(module, "register", None)
+    if register is None:
+        typer.echo(
+            f"warning: module {module_name} does not expose a register(app) function",
+            err=True,
+        )
+        continue
+    register(app)
+
+
+def main(argv: Optional[list[str]] = None) -> None:
+    """Execute the Typer application."""
+
+    app(args=argv if argv is not None else sys.argv[1:])
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()

cli/aion/commands/__init__.py

@@ -0,0 +1,3 @@
+"""Command group namespace for the AION CLI."""
+
+__all__ = []

cli/aion/commands/apply.py

@@ -0,0 +1,33 @@
+"""Implementation of the ``aion apply`` command group."""
+from __future__ import annotations
+
+import pathlib
+
+import typer
+
+from ..services.bundle import BundleService, BundleSettings
+
+
+def register(app: typer.Typer) -> None:
+    apply_app = typer.Typer(help="Apply configuration bundles to the control plane")
+
+    @apply_app.command()
+    def bundle(
+        path: pathlib.Path = typer.Argument(..., help="Path to the bundle .tgz archive."),
+        atomic: bool = typer.Option(False, "--atomic", help="Rollback on failure."),
+        no_browser: bool = typer.Option(
+            False, "--no-browser", help="Skip browser based review before applying."
+        ),
+    ) -> None:
+        """Apply a configuration bundle."""
+
+        settings = BundleSettings(path=path, atomic=atomic, no_browser=no_browser)
+        service = BundleService()
+        report = service.apply(settings)
+        typer.secho("Bundle applied", fg=typer.colors.GREEN)
+        typer.echo(report)
+
+    app.add_typer(apply_app, name="apply")
+
+
+__all__ = ["register"]

cli/aion/commands/auth.py

@@ -0,0 +1,24 @@
+"""Authentication helper commands for ``aion``."""
+from __future__ import annotations
+
+import typer
+
+from ..services.auth import AuthService
+
+
+def register(app: typer.Typer) -> None:
+    auth_app = typer.Typer(help="Authentication helpers")
+
+    @auth_app.command("token")
+    def token(
+        once: bool = typer.Option(False, "--once", help="Mark the token for single-use."),
+        ttl: str = typer.Option("5m", "--ttl", help="Relative TTL, e.g. 5m or 1h."),
+    ) -> None:
+        service = AuthService()
+        token_value = service.issue_token(ttl=ttl, once=once)
+        typer.echo(token_value)
+
+    app.add_typer(auth_app, name="auth")
+
+
+__all__ = ["register"]

cli/aion/commands/doctor.py

@@ -0,0 +1,26 @@
+"""System diagnostics via ``aion doctor``."""
+from __future__ import annotations
+
+import typer
+
+from ..services.doctor import DoctorService
+
+
+def register(app: typer.Typer) -> None:
+    doctor_app = typer.Typer(help="Run health diagnostics against the control API")
+
+    @doctor_app.command()
+    def doctor(verbose: bool = typer.Option(False, "--verbose", help="Verbose output.")) -> None:
+        service = DoctorService(verbose=verbose)
+        ok, report = service.run()
+        if ok:
+            typer.secho("All systems healthy", fg=typer.colors.GREEN)
+        else:
+            typer.secho("Issues detected", fg=typer.colors.RED)
+        typer.echo(report)
+        raise typer.Exit(code=0 if ok else 1)
+
+    app.add_typer(doctor_app, name="doctor")
+
+
+__all__ = ["register"]

cli/aion/commands/init.py

@@ -0,0 +1,79 @@
+"""Implementation of the ``aion init`` command group."""
+from __future__ import annotations
+
+import getpass
+import sys
+from typing import Optional
+
+import typer
+
+from ..services.quickstart import QuickstartOptions, QuickstartService
+
+
+def _prompt_missing(options: QuickstartOptions) -> QuickstartOptions:
+    if options.admin_email is None:
+        options.admin_email = typer.prompt("Admin email")
+    if options.admin_pass is None:
+        options.admin_pass = getpass.getpass("Admin password: ")
+    if not options.model:
+        options.model = typer.prompt("Default model", default="gpt-4o-mini")
+    return options
+
+
+def register(app: typer.Typer) -> None:
+    init_app = typer.Typer(help="Bootstrap a new AION OS deployment")
+
+    @init_app.callback()
+    def init_command(
+        ctx: typer.Context,
+        quickstart: bool = typer.Option(
+            False, "--quickstart", help="Run the guided quickstart workflow."
+        ),
+        no_browser: bool = typer.Option(
+            False, "--no-browser", help="Force headless mode even if a browser exists."
+        ),
+        admin_email: Optional[str] = typer.Option(
+            None, "--admin-email", help="Seed admin email for the console."
+        ),
+        admin_pass: Optional[str] = typer.Option(
+            None, "--admin-pass", help="Seed admin password for the console."
+        ),
+        provider: str = typer.Option(
+            "local", "--provider", help="Default provider to configure (local|api|hybrid)."
+        ),
+        api_key: Optional[str] = typer.Option(
+            None, "--api-key", help="API key when provider requires one."
+        ),
+        model: Optional[str] = typer.Option(
+            None, "--model", help="Default model identifier to set up."
+        ),
+        port: int = typer.Option(3000, "--port", help="Port to bind the console to."),
+    ) -> None:
+        if not quickstart:
+            typer.echo("Use --quickstart to launch the guided bootstrap workflow.")
+            raise typer.Exit(code=1)
+
+        options = QuickstartOptions(
+            quickstart=quickstart,
+            no_browser=no_browser,
+            admin_email=admin_email,
+            admin_pass=admin_pass,
+            provider=provider,
+            api_key=api_key,
+            model=model,
+            port=port,
+            extra_args=list(ctx.args),
+        )
+        if options.no_browser or not sys.stdin.isatty():  # type: ignore[attr-defined]
+            options = _prompt_missing(options)
+
+        service = QuickstartService()
+        result = service.run(options=options)
+        typer.secho("Quickstart completed", fg=typer.colors.GREEN)
+        for key, value in result.items():
+            typer.echo(f"{key}: {value}")
+
+    app.add_typer(init_app, name="init")
+
+
+__all__ = ["register"]

cli/aion/commands/tui.py

@@ -0,0 +1,24 @@
+"""Terminal UI launcher commands."""
+from __future__ import annotations
+
+import typer
+
+from ..services.tui import TuiServerService
+
+
+def register(app: typer.Typer) -> None:
+    tui_app = typer.Typer(help="Serve the terminal explorer UI")
+
+    @tui_app.command("serve")
+    def serve(
+        port: int = typer.Option(3030, "--port", help="Port to bind the explorer server to."),
+        api: str = typer.Option("http://127.0.0.1:8001", "--api", help="Control API base URL."),
+        token: str = typer.Option(..., "--token", help="Authentication token to forward."),
+    ) -> None:
+        service = TuiServerService(port=port, api_url=api, token=token)
+        service.run()
+
+    app.add_typer(tui_app, name="tui-serve")
+
+
+__all__ = ["register"]

cli/aion/services/__init__.py

@@ -0,0 +1,3 @@
+"""Service helpers used by the AION CLI commands."""
+
+__all__ = []