buildai-cli 0.3.73__tar.gz → 0.3.74__tar.gz

{buildai_cli-0.3.73 → buildai_cli-0.3.74}/.gitignore

@@ -17,6 +17,10 @@ ENV/
 .eggs/
 *.egg-info/
 dist/
+!apps/buildai-openai-ingest/frontend/
+!apps/buildai-openai-ingest/frontend/dist/
+!apps/buildai-openai-ingest/frontend/dist/index.html
+!apps/buildai-openai-ingest/frontend/dist/mac-mini.png
 build/
 .pytest_cache/
 .mypy_cache/
@@ -55,6 +59,10 @@ Thumbs.db
 
 # Local tool state
 .superpowers/
+
+# EgoExo sync trial script spill (default output is under experiments/egoexo-pipeline/out/)
+/*.sync_trial.json
+/run_config.json
 .entire/*
 !.entire/
 !.entire/settings.json
@@ -68,6 +76,13 @@ Thumbs.db
 buildai-workspace/
 apps/buildai-sd-card-reader-android/
 
+# Local DDS verification refresh artifacts. The reviewed dry-run manifest is
+# tracked separately so tests and handoffs use one stable repair plan.
+.codex/dds-gcs-inventory*.txt
+.codex/dds-gcs-repair-dry-run.current.json
+.codex/dds-gcs-repair-verify*.json
+.codex/dds-*-smoke-current.png
+
 # Generated artifacts
 outputs/
 logs/
@@ -75,8 +90,14 @@ reports/
 scratchpad/
 local-archive/
 reference/
+recording-cache/
 /datasets/1m-hour-dataset/*
 !/datasets/1m-hour-dataset/README.md
+!/datasets/1m-hour-dataset/anonymized-remap-summary.json
+!/datasets/1m-hour-dataset/clip_mapping.parquet
+!/datasets/1m-hour-dataset/factory_mapping.csv
+!/datasets/1m-hour-dataset/object_rename_mapping.parquet
+!/datasets/1m-hour-dataset/worker_mapping.csv
 /datasets/250k-hour-dataset/*
 !/datasets/250k-hour-dataset/README.md
 !/datasets/250k-hour-dataset/build/
@@ -93,6 +114,8 @@ reference/
 /datasets/**/*.mp4
 /datasets/**/*.mov
 /datasets/**/*.parquet
+!/datasets/1m-hour-dataset/clip_mapping.parquet
+!/datasets/1m-hour-dataset/object_rename_mapping.parquet
 /datasets/**/manifest.csv
 /datasets/**/scored_device_on_head_candidates.jsonl
 /datasets/label-viz-clips/candidates/*.decisions.jsonl

{buildai_cli-0.3.73 → buildai_cli-0.3.74}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: buildai-cli
-Version: 0.3.73
+Version: 0.3.74
 Summary: Build AI CLI (Typer)
 Requires-Python: >=3.11
 Requires-Dist: httpx>=0.27.0

{buildai_cli-0.3.73 → buildai_cli-0.3.74}/cli/commands/gigcamera.py

@@ -4,9 +4,11 @@ from __future__ import annotations
 
 import asyncio
 import hashlib
+from dataclasses import asdict, is_dataclass
 from datetime import date
 from decimal import Decimal
-from typing import Literal
+from time import monotonic
+from typing import Literal, cast
 from uuid import UUID
 
 import typer
@@ -40,6 +42,7 @@ _SUBMITTED_BY = "00000000-0000-0000-0000-000000000000"
 # `last_error` on quarantined rows; reset to `pending` and zero `attempt_count`
 # manually once the underlying problem is fixed.
 _RECAP_QUEUE_MAX_ATTEMPTS = 5
+_READ_MODEL_VALIDATION_PROFILES = frozenset({"internal_admin", "internal_viewer"})
 
 
 @app.callback()
@@ -59,6 +62,11 @@ def gigcamera_callback(
         "-p",
         help="Auth workflow profile. Use internal_admin for writes.",
     ),
+    all_proxy: str | None = typer.Option(
+        None,
+        "--all-proxy",
+        help="Proxy URL passed to alloydb-auth-proxy for private-only DB lanes.",
+    ),
     verbose: bool = typer.Option(False, "--verbose", "-v", help="Verbose logging."),
 ) -> None:
     """Capture DB-targeting flags; subcommands initialize the heavy ops context."""
@@ -68,6 +76,7 @@ def gigcamera_callback(
     ctx.obj["_env"] = env
     ctx.obj["_auth"] = auth
     ctx.obj["_user"] = user
+    ctx.obj["_all_proxy"] = all_proxy
     ctx.obj["_verbose"] = verbose
     ctx.obj.setdefault("allow_write", False)
     ctx.obj.setdefault("_ops_ready", False)
@@ -93,6 +102,61 @@ def _require_internal_admin_for_write(ctx: typer.Context, *, write: bool) -> Non
         raise typer.BadParameter("writes require --profile internal_admin")
 
 
+def _require_read_model_validation_profile(ctx: typer.Context) -> None:
+    """Prevent misleading read-model parity runs under scoped developer profiles."""
+
+    profile = (ctx.obj or {}).get("cli_profile") or "engineers-dev"
+    if profile not in _READ_MODEL_VALIDATION_PROFILES:
+        raise typer.BadParameter(
+            "read-model validation requires --profile internal_admin or --profile internal_viewer"
+        )
+
+
+def _context_with_org_id_constraints(
+    dal_ctx: object,
+    *,
+    scope_org_ids: list[UUID] | None,
+) -> object:
+    """Stamp a DAL context with explicit org visibility for scoped read-model rows."""
+
+    if not scope_org_ids:
+        return dal_ctx
+    from dal.constraints import DataConstraints, ResourceType
+
+    requested = frozenset(str(value) for value in scope_org_ids)
+    existing = getattr(dal_ctx, "constraints", None)
+    if existing is not None:
+        allowed_ids = getattr(existing, "allowed_ids", None)
+        if isinstance(allowed_ids, dict) and any(
+            str(resource_type) != "organization" for resource_type in allowed_ids
+        ):
+            raise typer.BadParameter(
+                "--scope-org-id cannot be combined with non-organization constraints"
+            )
+        if existing.has_constraint("organization"):
+            existing_ids = frozenset(str(value) for value in existing.uuid_ids_for("organization"))
+            if not requested.issubset(existing_ids):
+                raise typer.BadParameter(
+                    "--scope-org-id must stay within the active profile's organization constraints"
+                )
+
+    constraints = DataConstraints(allowed_ids={cast(ResourceType, "organization"): requested})
+    if is_dataclass(dal_ctx) and not isinstance(dal_ctx, type):
+        from dataclasses import replace
+
+        return replace(dal_ctx, constraints=constraints)
+    setattr(dal_ctx, "constraints", constraints)
+    return dal_ctx
+
+
+def _renderable_result(value: object) -> object:
+    """Convert dataclass DAL summaries to normal JSON-friendly dictionaries."""
+
+    if is_dataclass(value) and not isinstance(value, type):
+        return asdict(value)
+    return value
+
+
 def _parse_ist_day(value: str, *, field_name: str) -> date:
     """Parse one ISO calendar day supplied as a GigCamera IST boundary."""
 
@@ -109,6 +173,177 @@ def _idempotency_key(base: str, *, run_suffix: str | None) -> str:
     return f"{base}:{suffix}" if suffix else base
 
 
+@app.command("admin-analytics-read-model-refresh")
+def admin_analytics_read_model_refresh(
+    ctx: typer.Context,
+    range_name: Literal["7d", "30d", "all"] = typer.Option(
+        "30d",
+        "--range",
+        help="Canonical analytics range to refresh when not using --recent.",
+    ),
+    org_slug: str | None = typer.Option(
+        None,
+        "--org-slug",
+        help="Optional organization slug matching the admin analytics API filter.",
+    ),
+    scope_org_ids: list[UUID] | None = typer.Option(
+        None,
+        "--scope-org-id",
+        "--org-id",
+        help=(
+            "Organization id to apply as DAL visibility constraints. Repeat for "
+            "multi-org scoped admins."
+        ),
+    ),
+    recent: bool = typer.Option(
+        False,
+        "--recent",
+        help="Refresh today plus the configured late-update window instead of the full range.",
+    ),
+    late_window_days: int = typer.Option(
+        3,
+        "--late-window-days",
+        min=0,
+        max=29,
+        help="Number of prior IST days to refresh with --recent.",
+    ),
+    write: bool = typer.Option(False, "--write", help="Actually upsert read-model rows."),
+    format: Format = format_option(),
+) -> None:
+    """Refresh the admin analytics shadow read model through the canonical DAL path."""
+
+    settings = _settings_for_command(ctx, write=write)
+    scope_org_id_values = [str(value) for value in scope_org_ids or []]
+    if not write:
+        render(
+            {
+                "dry_run": True,
+                "mode": "recent" if recent else "range",
+                "range": range_name,
+                "org_slug": org_slug,
+                "scope_org_ids": scope_org_id_values,
+                "late_window_days": late_window_days if recent else None,
+                "message": "pass --write with --profile internal_admin to upsert read-model rows",
+            },
+            format=format,
+        )
+        return
+    _require_internal_admin_for_write(ctx, write=True)
+
+    async def run() -> None:
+        from dal.product import dashboard as dashboard_dal
+
+        started_at = monotonic()
+        async with get_cli_context(settings, profile=(ctx.obj or {}).get("cli_profile")) as (
+            _db,
+            dal_ctx,
+        ):
+            scoped_dal_ctx = _context_with_org_id_constraints(
+                dal_ctx,
+                scope_org_ids=scope_org_ids,
+            )
+            if recent:
+                result = (
+                    await dashboard_dal.refresh_recent_gigcamera_admin_daily_analytics_read_model(
+                        scoped_dal_ctx,
+                        org_slug=org_slug,
+                        late_window_days=late_window_days,
+                    )
+                )
+            else:
+                result = await dashboard_dal.refresh_gigcamera_admin_daily_analytics_read_model(
+                    scoped_dal_ctx,
+                    range_name=range_name,
+                    org_slug=org_slug,
+                )
+
+        render(
+            {
+                "dry_run": False,
+                "mode": "recent" if recent else "range",
+                "range": range_name,
+                "org_slug": org_slug,
+                "scope_org_ids": scope_org_id_values,
+                "late_window_days": late_window_days if recent else None,
+                "duration_ms": round((monotonic() - started_at) * 1000, 2),
+                "result": _renderable_result(result),
+            },
+            format=format,
+        )
+
+    asyncio.run(run())
+
+
+@app.command("admin-analytics-read-model-parity")
+def admin_analytics_read_model_parity(
+    ctx: typer.Context,
+    range_name: Literal["7d", "30d", "all"] = typer.Option(
+        "30d",
+        "--range",
+        help="Canonical analytics range to compare against read-model rows.",
+    ),
+    org_slug: str | None = typer.Option(
+        None,
+        "--org-slug",
+        help="Optional organization slug matching the admin analytics API filter.",
+    ),
+    scope_org_ids: list[UUID] | None = typer.Option(
+        None,
+        "--scope-org-id",
+        "--org-id",
+        help=(
+            "Organization id to apply as DAL visibility constraints. Repeat for "
+            "multi-org scoped admins."
+        ),
+    ),
+    max_mismatches: int = typer.Option(
+        20,
+        "--max-mismatches",
+        min=1,
+        max=200,
+        help="Maximum mismatch examples to include in the parity payload.",
+    ),
+    format: Format = format_option(),
+) -> None:
+    """Compare read-model rows with canonical admin analytics without mutating data."""
+
+    settings = _settings_for_command(ctx, write=False)
+    _require_read_model_validation_profile(ctx)
+
+    async def run() -> None:
+        from dal.product import dashboard as dashboard_dal
+
+        started_at = monotonic()
+        async with get_cli_context(settings, profile=(ctx.obj or {}).get("cli_profile")) as (
+            _db,
+            dal_ctx,
+        ):
+            scoped_dal_ctx = _context_with_org_id_constraints(
+                dal_ctx,
+                scope_org_ids=scope_org_ids,
+            )
+            result = await dashboard_dal.get_gigcamera_admin_daily_analytics_read_model_parity(
+                scoped_dal_ctx,
+                range_name=range_name,
+                org_slug=org_slug,
+                max_mismatches=max_mismatches,
+            )
+
+        render(
+            {
+                "range": range_name,
+                "org_slug": org_slug,
+                "scope_org_ids": [str(value) for value in scope_org_ids or []],
+                "max_mismatches": max_mismatches,
+                "duration_ms": round((monotonic() - started_at) * 1000, 2),
+                "parity": result,
+            },
+            format=format,
+        )
+
+    asyncio.run(run())
+
+
 async def _stale_consolidated_source_rows(
     db: object,
     *,

{buildai_cli-0.3.73 → buildai_cli-0.3.74}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "buildai-cli"
-version = "0.3.73"
+version = "0.3.74"
 description = "Build AI CLI (Typer)"
 requires-python = ">=3.11"
 dependencies = [