buildai-cli 0.1.0__tar.gz

buildai_cli-0.1.0/.gitignore

@@ -0,0 +1,78 @@
+# Worktrees
+.worktrees/
+
+# Ralph status files
+.ralph-status
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.venv/
+venv/
+ENV/
+.eggs/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.mypy_cache/
+
+# Node
+node_modules/
+.next/
+out/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+
+_productivity_inference/
+
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.*
+!.env.op
+.env.local
+.env.*.local
+.env-archive/
+.vercel
+
+# Benchmark results (large files)
+backend/benchmark-results/
+
+# Large binary feature files
+*.npy
+
+# V-JEPA2 frame features (39GB+)
+backend/results/vjepa2_frame_features/
+
+dashboard-legacy/
+.mcp.json
+
+# Reference materials
+reference/
+sd-to-storage/
+.dmux/
+.hypothesis/
+
+# Local data cache (frames, manifests, labels)
+.cache/
+
+# Generated data artifacts & reports
+scripts/dead_assets.json
+scripts/dead_assets.ids.txt
+scripts/sample_preview.html
+scripts/sample_dataset_report.html
+outputs/
+reference_mobile.png

buildai_cli-0.1.0/AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md

buildai_cli-0.1.0/CLAUDE.md

@@ -0,0 +1,96 @@
+# apps/buildai-cli/
+
+Typer CLI with two planes, distributable as a standalone package:
+- **Data plane**: SDK-backed commands (clips, jobs, collections, partners, operations, keys, stats). Requires `BUILDAI_API_KEY`. Works with just `pip install buildai-cli`.
+- **Ops plane**: DAL-direct commands (database, schema, auth CRUD, permissions, ingest, projection, medoid, external). Requires DB access. Install with `pip install 'buildai-cli[ops]'`.
+
+## Architecture
+
+- `cli/_has_core.py` — detects if `buildai-core` is installed
+- `cli/ops_init.py` — lazy DB/auth/observability setup (called by ops commands, NOT at startup)
+- `cli/main.py` — lightweight callback, conditional ops registration, stubs when core absent
+- `cli/commands/auth_lite.py` — login + status (no core deps)
+- `cli/commands/auth_ops.py` — API key CRUD (ops-plane, requires core)
+
+## Rules
+
+1. Always run from repo root (`uv run buildai`), never from inside the app directory.
+2. Default profile is read-only. Mutations require `--profile admin --write`.
+3. Missing `--write` on mutating commands now errors (not silent no-op).
+4. All DB access goes through `core/data/` DAL with a `CLIContext`. No raw SQL in commands.
+5. The `query` command only permits SELECT/WITH/EXPLAIN — it blocks mutations at parse time (via sqlparse AST).
+6. Data-plane commands go through the SDK — they need an API key, not DB credentials.
+7. **No `infra` imports at module level** in main.py or data-plane modules.
+
+## Data Plane (SDK-backed)
+
+These commands wrap `buildai` SDK resources. Set `BUILDAI_API_KEY` or `buildai auth login <key>`.
+
+```bash
+uv run buildai clips list --factory <id> --limit 5
+uv run buildai jobs list --status running
+uv run buildai jobs retry <id> --write
+uv run buildai collections list
+uv run buildai stats overview
+uv run buildai partners list        # internal mode
+uv run buildai operations hours     # internal mode
+uv run buildai keys list            # internal mode
+```
+
+## Ops Plane (DAL-direct)
+
+```bash
+uv run buildai --profile readonly database status
+uv run buildai --profile readonly schema tables
+uv run buildai auth status
+```
+
+## Output
+
+- TTY detected: table format (Rich tables)
+- Piped: JSON format (machine-readable)
+- Override: `--format json|table|csv|jsonl`
+- Status/errors go to stderr, data to stdout
+
+## Install
+
+```bash
+# Workspace (all commands — ops + data plane)
+uv pip install -e "apps/buildai-cli[ops]" -e core -e services -e apps/buildai-sdk
+
+# Standalone data-plane only
+pip install buildai-cli   # or: uv tool install -e ./apps/buildai-cli
+
+# Global install
+uv tool install -e ./apps/buildai-cli
+```
+
+## Run
+
+```bash
+uv run buildai --profile readonly <command>
+uv run buildai --profile admin --write <command>
+```
+
+## Things That Will Bite You
+
+- `uv run buildai` fails with `ModuleNotFoundError` after pulling — reinstall with: `uv pip install -e "apps/buildai-cli[ops]" -e core -e services -e apps/buildai-sdk`
+- `--env production` requires valid production DB credentials.
+- New data-plane command groups: register in `cli/main.py` in the data-plane section.
+- New ops-plane command groups: register in `cli/main.py` via `_register_ops_typer()` inside `if has_core():`, and add to `_OPS_GROUPS` in the else branch.
+- Data-plane commands fail without `BUILDAI_API_KEY` — use `buildai auth login` to configure.
+- `--dry-run` is available on all mutating data-plane commands.
+- Shell completion: `uv run buildai --install-completion`
+- Auth ops commands (create-key, list-keys, show-key, revoke-key) call `init_ops_context()` themselves — they're registered onto the auth_lite app, not via `_register_ops_typer`.
+
+## Closing the Loop
+
+When adding a command group: register it in `cli/main.py`. Data-plane = always imported. Ops-plane = behind `has_core()` guard.
+
+## See Also
+
+| Topic | File |
+|-------|------|
+| DAL patterns, profiles, Context | `core/CLAUDE.md` |
+| SDK resources | `apps/buildai-sdk/CLAUDE.md` |
+| Common failure modes | `docs/gotchas.md` |

buildai_cli-0.1.0/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: buildai-cli
+Version: 0.1.0
+Summary: Build AI CLI (Typer)
+Requires-Python: >=3.11
+Requires-Dist: buildai-sdk
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: ops
+Requires-Dist: anthropic>=0.73.0; extra == 'ops'
+Requires-Dist: anyio>=4.0.0; extra == 'ops'
+Requires-Dist: buildai-core; extra == 'ops'
+Requires-Dist: buildai-services; extra == 'ops'
+Requires-Dist: claude-agent-sdk>=0.1.6; extra == 'ops'
+Requires-Dist: google-genai>=1.0.0; extra == 'ops'
+Requires-Dist: matplotlib>=3.10.7; extra == 'ops'
+Requires-Dist: questionary>=2.0.1; extra == 'ops'
+Requires-Dist: sqlparse>=0.4.4; extra == 'ops'
+Requires-Dist: textual-plotext>=1.0.1; extra == 'ops'
+Requires-Dist: textual>=6.6.0; extra == 'ops'

buildai_cli-0.1.0/cli/__init__.py

@@ -0,0 +1 @@
+"""BuildAI Backend CLI."""

buildai_cli-0.1.0/cli/_has_core.py

@@ -0,0 +1,29 @@
+"""Detect whether buildai-core is available."""
+
+_cached: bool | None = None
+
+
+def has_core() -> bool:
+    global _cached
+    if _cached is None:
+        try:
+            import infra  # noqa: F401
+
+            _cached = True
+        except ImportError:
+            _cached = False
+    return _cached
+
+
+def require_core(command_name: str) -> None:
+    if not has_core():
+        import typer
+
+        from cli.console import error
+
+        error(
+            f"'{command_name}' requires ops-plane deps.\n"
+            f"  Install with: pip install 'buildai-cli[ops]'\n"
+            f"  Or workspace: uv pip install -e 'apps/buildai-cli[ops]' -e core"
+        )
+        raise typer.Exit(1)

buildai_cli-0.1.0/cli/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI commands — use direct imports, not this barrel."""

buildai_cli-0.1.0/cli/commands/auth_lite.py

@@ -0,0 +1,79 @@
+"""Lightweight auth commands — no core/infra deps."""
+
+from typing_extensions import Annotated
+
+import typer
+
+from cli.config import resolve_cli_api_key, save_cli_config
+from cli.console import console, success
+
+app = typer.Typer(
+    name="auth",
+    help="Authentication and API key management",
+    no_args_is_help=True,
+)
+
+
+@app.command("login")
+def login(
+    api_key: Annotated[str, typer.Argument(help="API key to store locally")],
+    profile: Annotated[
+        str | None,
+        typer.Option(
+            "--profile",
+            "-p",
+            help="Default CLI profile (e.g., readonly, mcp, svc_embedder)",
+        ),
+    ] = None,
+) -> None:
+    """Store an API key and optional profile in ~/.buildai/config.toml."""
+    save_cli_config(api_key=api_key, profile=profile)
+    success("Saved CLI credentials to ~/.buildai/config.toml")
+
+
+@app.command("status")
+def auth_status(ctx: typer.Context) -> None:
+    """Show current authentication state — gcloud account, API key, profile."""
+    import subprocess
+
+    cli_profile = (ctx.obj or {}).get("cli_profile", "readonly")
+
+    # gcloud active account
+    try:
+        result = subprocess.run(
+            [
+                "gcloud",
+                "auth",
+                "list",
+                "--filter=status=ACTIVE",
+                "--format=value(account)",
+            ],
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+        gcloud_account = result.stdout.strip() or "not authenticated"
+    except Exception:
+        gcloud_account = "gcloud not available"
+
+    console.print(f"  gcloud account : [cyan]{gcloud_account}[/cyan]")
+    console.print(f"  profile        : {cli_profile}")
+
+    # DB environment (only if core available)
+    from cli._has_core import has_core
+
+    if has_core() and ctx.obj and ctx.obj.get("_ops_ready"):
+        settings = ctx.obj.get("settings")
+        if settings:
+            env_color = "yellow" if settings.is_production else "green"
+            console.print(f"  DB environment : [{env_color}]{settings.app_env.value}[/]")
+    else:
+        console.print("  DB environment : [dim]n/a (ops-plane not loaded)[/dim]")
+
+    # API key status
+    api_key = resolve_cli_api_key()
+    if api_key:
+        prefix = api_key[:12] + "..."
+        console.print(f"  API key        : [green]{prefix}[/green]")
+    else:
+        console.print("  API key        : [dim]not configured (set BUILDAI_API_KEY)[/dim]")