buildai-cli 0.3.164__tar.gz → 0.3.166__tar.gz

{buildai_cli-0.3.164 → buildai_cli-0.3.166}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: buildai-cli
-Version: 0.3.164
+Version: 0.3.166
 Summary: Build AI CLI (Typer)
 Requires-Python: >=3.11
 Requires-Dist: google-crc32c>=1.7.1

{buildai_cli-0.3.164 → buildai_cli-0.3.166}/cli/commands/labeling.py

@@ -22,6 +22,7 @@ from dal.labeling import (
     configure_guarded_scheduler_execution,
     hand_practice,
     list_accounts,
+    practice_bonus_payouts,
     prepare_routing_policy_transition,
     prepare_shadow_quality_runtime,
     preview_rapid_navigation_label_repair,
@@ -80,6 +81,11 @@ hand_practice_app = typer.Typer(
     no_args_is_help=True,
 )
 app.add_typer(hand_practice_app, name="hand-practice")
+practice_bonus_payouts_app = typer.Typer(
+    help="The instant bonus payout (practice bonus, referral steps): switch, status, backfill.",
+    no_args_is_help=True,
+)
+app.add_typer(practice_bonus_payouts_app, name="practice-bonus-payouts")
 app.add_typer(hand_labels_export_app, name="hands-export")
 
 _GCLOUD_READ_TIMEOUT_SECONDS = 15
@@ -977,6 +983,82 @@ def hand_practice_report_command(
     output(asyncio.run(_run()), format=format)
 
 
+@practice_bonus_payouts_app.command("status")
+def practice_bonus_payouts_status_command(
+    typer_ctx: typer.Context,
+    profile: Annotated[str | None, typer.Option("--profile")] = None,
+    env: Annotated[str | None, typer.Option("--env", "-e")] = None,
+    format: Format = format_option(),
+) -> None:
+    """Whether each lane is on, and payouts by kind, state, and reason."""
+
+    async def _run() -> dict:
+        effective_profile = _resolve_profile(profile=profile, env=env, write=False)
+        settings = _init_settings(typer_ctx, env=env, profile=effective_profile, write=False)
+        async with get_cli_context(settings, profile=effective_profile) as (_db, dal_ctx):
+            return await practice_bonus_payouts.status_summary(dal_ctx)
+
+    output(asyncio.run(_run()), format=format)
+
+
+@practice_bonus_payouts_app.command("switch")
+def practice_bonus_payouts_switch_command(
+    typer_ctx: typer.Context,
+    state: Annotated[str, typer.Argument(help="on or off")],
+    actor_account_id: Annotated[UUID, typer.Option("--actor-account-id")],
+    lane: Annotated[
+        str,
+        typer.Option("--lane", help="practice (the practice bonus) or referral (both steps)."),
+    ] = "practice",
+    profile: Annotated[str | None, typer.Option("--profile")] = None,
+    env: Annotated[str | None, typer.Option("--env", "-e")] = None,
+    write: Annotated[bool, typer.Option("--write", help="Required: this moves money.")] = False,
+    format: Format = format_option(),
+) -> None:
+    """One lane's kill switch: on pays its bonuses at once; off leaves them to the manual payout."""
+
+    if state not in {"on", "off"}:
+        raise typer.BadParameter("Pass on or off.")
+    if lane not in practice_bonus_payouts.LANES:
+        raise typer.BadParameter("Pass --lane practice or --lane referral.")
+    if not write:
+        raise typer.BadParameter("Switching changes who is paid at once; pass --write.")
+
+    async def _run() -> dict:
+        effective_profile = _resolve_profile(profile=profile, env=env, write=write)
+        settings = _init_settings(typer_ctx, env=env, profile=effective_profile, write=write)
+        async with get_cli_context(settings, profile=effective_profile) as (_db, dal_ctx):
+            return await practice_bonus_payouts.set_payouts_enabled(
+                dal_ctx, lane=lane, enabled=state == "on", actor_id=actor_account_id
+            )
+
+    output(asyncio.run(_run()), format=format)
+
+
+@practice_bonus_payouts_app.command("backfill")
+def practice_bonus_payouts_backfill_command(
+    typer_ctx: typer.Context,
+    profile: Annotated[str | None, typer.Option("--profile")] = None,
+    env: Annotated[str | None, typer.Option("--env", "-e")] = None,
+    write: Annotated[
+        bool, typer.Option("--write", help="Queue the lines. Default: list them only.")
+    ] = False,
+    format: Format = format_option(),
+) -> None:
+    """Queue every unpaid bonus line minted before the lane existed, once.
+
+    The sweep then checks every guardrail and orders each one while the lane is on.
+    """
+
+    async def _run() -> dict:
+        effective_profile = _resolve_profile(profile=profile, env=env, write=write)
+        settings = _init_settings(typer_ctx, env=env, profile=effective_profile, write=write)
+        async with get_cli_context(settings, profile=effective_profile) as (_db, dal_ctx):
+            return await practice_bonus_payouts.backfill(dal_ctx, write=write)
+
+    output(asyncio.run(_run()), format=format)
+
+
 def _init_settings(
     ctx: typer.Context,
     *,

{buildai_cli-0.3.164 → buildai_cli-0.3.166}/pyproject.toml

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