makea-cli 0.2.14__py3-none-any.whl → 0.2.16__py3-none-any.whl

makea_cli/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.14"
+__version__ = "0.2.16"

makea_cli/api_client.py

@@ -5,7 +5,7 @@ import mimetypes
 from pathlib import Path
 from pathlib import PurePosixPath
 from typing import Any
-from urllib.parse import unquote
+from urllib.parse import quote, unquote
 
 import httpx
 
@@ -197,8 +197,14 @@ def patch_json(path: str, body: Any, *, timeout: float = 60.0) -> Any:
     return _request("PATCH", path, json_body=body, timeout=timeout)
 
 
-def delete_json(path: str, *, params: dict[str, Any] | None = None, timeout: float = 60.0) -> Any:
-    return _request("DELETE", path, params=params, timeout=timeout)
+def delete_json(
+    path: str,
+    *,
+    params: dict[str, Any] | None = None,
+    body: Any = None,
+    timeout: float = 60.0,
+) -> Any:
+    return _request("DELETE", path, params=params, json_body=body, timeout=timeout)
 
 
 def send_admin_raw_email(body: dict[str, Any]) -> Any:
@@ -844,6 +850,18 @@ def get_cumulative_payment_and_platform_revenue(
     )
 
 
+def get_fx_rates(*, to: str, sources: list[str], amount: float | None = None) -> Any:
+    """
+    GET /admin/fx/rates — the platform's own exchange rates (rounded up to its
+    RATE_DECIMALS), and with one source and an amount, that amount converted the
+    way the platform converts it.
+    """
+    params: dict[str, Any] = {"to": to, "from": ",".join(sources)}
+    if amount is not None:
+        params["amount"] = amount
+    return get_json("/admin/fx/rates", params=params)
+
+
 def extract_ai_tech_specifications(product_reference_id: str, *, timeout: float = 300.0) -> Any:
     """
     GET /admin/products/{id}/extract-tech-specifications — synchronous AI extraction;
@@ -1035,6 +1053,51 @@ def admin_delete_library_component(
     )
 
 
+# --- admin: one person's AI playbook rules ---------------------------------------
+# Addressed by user_id or email; the backend resolves every scope the person's
+# rules live in (team, own account, factory) and refuses an email that is on
+# more than one account. Every write carries a reason the rule keeps.
+
+
+def _user_rules_path(user: str, rule_id: str | None = None) -> str:
+    path = f"/admin/playbook/users/{quote(user.strip(), safe='@')}/rules"
+    return f"{path}/{quote(rule_id, safe='')}" if rule_id else path
+
+
+def admin_list_user_rules(
+    user: str, *, status: str | None = None, include_archived: bool = False
+) -> Any:
+    """GET /admin/playbook/users/{user}/rules — every rule that holds for one person."""
+    params: dict[str, Any] = {}
+    if status:
+        params["status"] = status
+    if include_archived:
+        params["include_archived"] = "1"
+    return get_json(_user_rules_path(user), params=params or None)
+
+
+def admin_get_user_rule(user: str, rule_id: str) -> Any:
+    """GET /admin/playbook/users/{user}/rules/{rule_id} — one rule, evidence included."""
+    return get_json(_user_rules_path(user, rule_id))
+
+
+def admin_create_user_rule(user: str, body: dict[str, Any]) -> Any:
+    """POST /admin/playbook/users/{user}/rules — {text, reason, scope?, applies_to?,
+    when?, mode?, category?, polarity?, status?, force?}."""
+    return post_json(_user_rules_path(user), body)
+
+
+def admin_update_user_rule(user: str, rule_id: str, body: dict[str, Any]) -> Any:
+    """PATCH /admin/playbook/users/{user}/rules/{rule_id} — {text?, status?,
+    applies_to?, when?, mode?, reason}."""
+    return patch_json(_user_rules_path(user, rule_id), body)
+
+
+def admin_delete_user_rule(user: str, rule_id: str, reason: str) -> Any:
+    """DELETE /admin/playbook/users/{user}/rules/{rule_id} — archives it, with the reason."""
+    return delete_json(_user_rules_path(user, rule_id), body={"reason": reason})
+
+
 # --- supplier persona: a factory acting on its own RFQs, quotes and orders --------
 
 

makea_cli/commands/__init__.py

@@ -13,6 +13,7 @@ from makea_cli.commands.factory.cmd import register as register_factory
 from makea_cli.commands.library.cmd import register as register_library
 from makea_cli.commands.metrics.cmd import register as register_metrics
 from makea_cli.commands.orders.cmd import register as register_orders
+from makea_cli.commands.playbook.cmd import register as register_playbook
 from makea_cli.commands.product.cmd import register as register_product
 from makea_cli.commands.production.cmd import register as register_production
 from makea_cli.commands.supplier.cmd import register as register_supplier
@@ -33,3 +34,4 @@ def register_all(app: typer.Typer) -> None:
     register_library(app)
     register_factory(app)
     register_brand(app)
+    register_playbook(app)

makea_cli/commands/metrics/cmd.py

@@ -1,8 +1,5 @@
 from __future__ import annotations
 
-import math
-
-import httpx
 import typer
 from rich.console import Console
 
@@ -16,38 +13,6 @@ console = Console()
 _GRANULARITIES = ("day", "week", "month")
 _ORDER_TYPES = ("all", "sampling", "production")
 
-# Same free FX source the backend uses (FreeCurrencyService), so converted
-# amounts match the platform's revenue metrics.
-_FX_PRIMARY = (
-    "https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api@latest/v1/currencies/{base}.json"
-)
-_FX_FALLBACK = "https://latest.currency-api.pages.dev/v1/currencies/{base}.json"
-
-
-def _fx_rate(base: str, target: str) -> float:
-    """Exchange rate base -> target, rounded UP to 2dp exactly like the backend
-    (math.ceil(raw * 100) / 100) so totals reconcile with revenue metrics."""
-    base, target = base.lower(), target.lower()
-    if base == target:
-        return 1.0
-    last_err: Exception | None = None
-    for url in (_FX_PRIMARY.format(base=base), _FX_FALLBACK.format(base=base)):
-        try:
-            with httpx.Client(timeout=10) as client:
-                resp = client.get(url)
-                resp.raise_for_status()
-                data = resp.json()
-            raw = data.get(base, {}).get(target)
-            if raw is not None:
-                return math.ceil(float(raw) * 100) / 100
-        except Exception as e:  # noqa: BLE001 - try fallback URL
-            last_err = e
-            continue
-    raise RuntimeError(
-        f"FX rate {base.upper()}->{target.upper()} unavailable"
-        + (f": {last_err}" if last_err else "")
-    )
-
 
 def register(app: typer.Typer) -> None:
     @command(
@@ -141,13 +106,13 @@ def register(app: typer.Typer) -> None:
         "get",
         "currency-conversion",
         legacy="convert-currency",
-        api="GET currency-api",
-        external="currency-api",
+        api="GET /admin/fx/rates",
         help=(
-            "Convert money between currencies using the same free FX source and "
-            "rounding as the platform's revenue metrics. Pass several source "
-            "currencies via --from (comma-separated) to get a full rate table in "
-            "one call, then convert locally — avoids repeated lookups."
+            "GET /admin/fx/rates — convert money between currencies at the "
+            "platform's own rates and rounding, so totals reconcile with its "
+            "prices and revenue metrics. Pass several source currencies via --from "
+            "(comma-separated) to get a full rate table in one call, then convert "
+            "locally — avoids repeated lookups."
         ),
     )
     def convert_currency(
@@ -165,17 +130,20 @@ def register(app: typer.Typer) -> None:
             help="Optional amount to convert (only meaningful with a single --from).",
         ),
     ) -> None:
-        """Return source->target rates (rounded like the backend), and optionally a
-        converted amount.
+        """Return source->target rates, and optionally a converted amount, as the
+        platform computes them.
 
         Use it to collapse a mixed-currency set into one currency: collect the
         distinct currencies, call once with --from a,b,c to get every rate, then
-        multiply locally. Rates use math.ceil(raw * 100) / 100, matching the
-        platform's FreeCurrencyService, so totals reconcile with revenue metrics.
-
-        Output JSON: {"to", "rates": {CUR: rate, ...}, "rounding", "source"} plus
-        {"from", "rate", "amount", "converted"} when a single --from and --amount
-        are given.
+        multiply locally. The rates are the platform's (FreeCurrencyService,
+        rounded up to ``rate_decimals``) and come from the backend rather than
+        being fetched and rounded here, so they cannot drift from it.
+
+        Output JSON: {"to", "rates": {CUR: rate, ...}, "rate_decimals",
+        "rounding", "source", "unavailable"} plus {"from", "rate", "amount",
+        "converted"} when a single --from and --amount are given; "converted" is
+        the platform's own conversion, rounding included. A currency with no
+        rate fails the command rather than coming back null.
         """
         sources = [s.strip() for s in from_.split(",") if s.strip()]
         if not sources:
@@ -183,22 +151,16 @@ def register(app: typer.Typer) -> None:
             raise typer.Exit(1)
 
         def _do() -> dict:
-            rates = {s.upper(): _fx_rate(s, to) for s in sources}
-            out: dict = {
-                "to": to.upper(),
-                "rates": rates,
-                "rounding": "ceil_2dp",
-                "source": "fawazahmed0/currency-api",
-            }
-            if amount is not None and len(sources) == 1:
-                rate = rates[sources[0].upper()]
-                out.update(
-                    {
-                        "from": sources[0].upper(),
-                        "rate": rate,
-                        "amount": amount,
-                        "converted": round(amount * rate, 2),
-                    }
+            payload = api_client.get_fx_rates(
+                to=to,
+                sources=sources,
+                amount=amount if len(sources) == 1 else None,
+            )
+            out = (payload or {}).get("result") or {}
+            if out.get("unavailable"):
+                raise RuntimeError(
+                    "FX rate unavailable: "
+                    + ", ".join(f"{s}->{to.upper()}" for s in out["unavailable"])
                 )
             return out
 

makea_cli/commands/playbook/cmd.py

@@ -0,0 +1,329 @@
+"""Admin commands for one person's AI playbook rules (Knowledge > Rules).
+
+A *rule* is one line Beeboo follows for an account ("Always book DHL Express",
+"Approve PP samples from photos"). Rules live on the brand's team playbook, on
+the person's own account, and, for a factory, on its company playbook. These
+commands address the person (``--user`` takes a user_id or an email) and the
+backend finds every scope; an email on more than one account is refused with
+the candidates, so pass the user_id then.
+
+Every write needs ``--reason``. The rule keeps it as an evidence entry
+(``admin_add`` / ``admin_edit`` / ``admin_delete`` with who, why, when and,
+for edits and deletes, what the rule was before), and the audit log records it.
+``delete`` archives: the rule leaves the brand's Rules page and every prompt,
+the row stays as the record, and ``update --status active`` brings it back.
+"""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+
+import typer
+from rich.console import Console
+
+from makea_cli import api_client
+from makea_cli.commands._util import print_json_or_exit
+from makea_cli.registry import command
+
+console = Console()
+
+_STATUSES = ("pending", "active", "muted", "archived")
+_SCOPES = ("org", "user", "supplier")
+_APPLIES_TO_KINDS = ("style", "collection", "supplier", "element")
+_MODES = ("remind", "act")
+
+_RULES_EPILOG = """
+--user takes a user_id (Cognito sub) or an email.
+
+Scopes: ORG#… is the brand's team playbook, USER#… the person's own,
+SUPPLIER#… a factory's. A new rule goes to the factory playbook for a supplier,
+else the team's (the person's own when there is no team); --scope overrides.
+
+--applies-to narrows a rule to one thing: KIND:ID[:LABEL] with KIND one of
+style, collection, supplier, element (e.g. supplier:sup_123:Ningbo Knit).
+"all" (update only) widens it back to the whole account.
+
+--when is which products it is for, as JSON:
+  '{"categories": ["knitwear"], "service_modes": ["cmt"]}'
+Order conditions the rule already has (units, destination) are kept; {} means
+every product.
+
+Examples
+  makea-cli admin list rule --user brand@example.com
+  makea-cli admin get rule rul_0123456789ab --user brand@example.com
+  makea-cli admin create rule --user brand@example.com \\
+      --text "Always book DHL Express for samples" --reason "Agreed on the 14 Oct call"
+  makea-cli admin update rule rul_0123456789ab --user brand@example.com \\
+      --status muted --reason "Brand asked to pause it by email"
+  makea-cli admin delete rule rul_0123456789ab --user brand@example.com \\
+      --reason "Learned from another brand's thread"
+""".strip()
+
+
+def _user_option() -> Any:
+    return typer.Option(..., "--user", "-u", help="Target person: user_id or email.")
+
+
+def _reason_option() -> Any:
+    return typer.Option(
+        ...,
+        "--reason",
+        "-r",
+        help="Why (required). Kept on the rule and in the audit log.",
+    )
+
+
+def _reason(raw: str) -> str:
+    reason = " ".join(raw.split())
+    if not reason:
+        raise typer.BadParameter("--reason must not be empty")
+    return reason
+
+
+def _applies_to(raw: str) -> dict[str, str]:
+    if raw.strip().lower() == "all":
+        return {"kind": "all"}
+    kind, sep, rest = raw.partition(":")
+    item_id, _, label = rest.partition(":")
+    kind = kind.strip().lower()
+    if not sep or kind not in _APPLIES_TO_KINDS or not item_id.strip():
+        raise typer.BadParameter(
+            f"--applies-to: expected KIND:ID[:LABEL] with KIND one of {', '.join(_APPLIES_TO_KINDS)}"
+        )
+    out = {"kind": kind, "id": item_id.strip()}
+    if label.strip():
+        out["label"] = label.strip()
+    return out
+
+
+def _when(raw: str) -> dict[str, Any]:
+    try:
+        data = json.loads(raw)
+    except json.JSONDecodeError as e:
+        raise typer.BadParameter(f"--when: invalid JSON ({e})") from e
+    if not isinstance(data, dict):
+        raise typer.BadParameter("--when: expected a JSON object")
+    return data
+
+
+def _choice(value: str | None, allowed: tuple[str, ...], flag: str) -> str | None:
+    if value is None:
+        return None
+    value = value.strip().lower()
+    if value not in allowed:
+        raise typer.BadParameter(f"{flag}: one of {', '.join(allowed)}")
+    return value
+
+
+def register(app: typer.Typer) -> None:
+    @command(
+        app,
+        "admin",
+        "list",
+        "rule",
+        api="GET /admin/playbook/users/{user}/rules",
+        help=(
+            "GET /admin/playbook/users/{user}/rules — every AI playbook rule that holds "
+            "for one person (team, own account, factory): status, scope, text, "
+            "applies_to/when, mode/effect, source line, dates. Archived ones only with --all."
+        ),
+        epilog=_RULES_EPILOG,
+    )
+    def list_rules(
+        user: str = _user_option(),
+        status: str | None = typer.Option(
+            None,
+            "--status",
+            "-s",
+            help=f"Only these statuses, comma-separated ({', '.join(_STATUSES)}).",
+        ),
+        include_archived: bool = typer.Option(
+            False, "--all", help="Also list archived (deleted) rules."
+        ),
+    ) -> None:
+        """List a person's playbook rules."""
+        if status:
+            for s in status.split(","):
+                _choice(s, _STATUSES, "--status")
+        print_json_or_exit(
+            console,
+            lambda: api_client.admin_list_user_rules(
+                user, status=status, include_archived=include_archived
+            ),
+        )
+
+    @command(
+        app,
+        "admin",
+        "get",
+        "rule",
+        api="GET /admin/playbook/users/{user}/rules/{rule_id}",
+        help=(
+            "GET /admin/playbook/users/{user}/rules/{rule_id} — one rule in full, "
+            "evidence (where it came from, who changed it and why) included."
+        ),
+        epilog=_RULES_EPILOG,
+    )
+    def get_rule(
+        rule_id: str = typer.Argument(..., help="Rule id (rul_…)."),
+        user: str = _user_option(),
+    ) -> None:
+        """Show one playbook rule with its evidence."""
+        print_json_or_exit(console, lambda: api_client.admin_get_user_rule(user, rule_id))
+
+    @command(
+        app,
+        "admin",
+        "create",
+        "rule",
+        api="POST /admin/playbook/users/{user}/rules",
+        side_effects=[
+            "Beeboo follows the rule in this account's AI answers from now on",
+            "shows on the brand's Knowledge > Rules page (brand scopes)",
+        ],
+        approval="ask",
+        reversible=True,
+        idempotent=False,
+        help=(
+            "POST /admin/playbook/users/{user}/rules — add a rule to a person's playbook "
+            "(admin-authored, active unless --status). Refuses a repeat or a conflict "
+            "unless --force. --reason required."
+        ),
+        epilog=_RULES_EPILOG,
+    )
+    def create_rule(
+        user: str = _user_option(),
+        text: str = typer.Option(..., "--text", help="The rule, one line (max 160 chars)."),
+        reason: str = _reason_option(),
+        scope: str | None = typer.Option(
+            None, "--scope", help=f"Where it lives: {', '.join(_SCOPES)} (default: see below)."
+        ),
+        applies_to: str | None = typer.Option(
+            None, "--applies-to", help="Narrow to one thing: KIND:ID[:LABEL]."
+        ),
+        when: str | None = typer.Option(
+            None,
+            "--when",
+            help='Which products, JSON: {"categories": [...], "service_modes": [...]}.',
+        ),
+        mode: str | None = typer.Option(
+            None, "--mode", help="remind (default): Beeboo tells; act: Beeboo does it."
+        ),
+        category: str | None = typer.Option(
+            None,
+            "--category",
+            help="communication, spec_defaults, sourcing, commercial, logistics, process, "
+            "hard_constraint, … (default: classified from the text).",
+        ),
+        polarity: str | None = typer.Option(
+            None, "--polarity", help="always, never or prefer (default: from the text)."
+        ),
+        status: str | None = typer.Option(
+            None, "--status", help="Start as pending, active (default) or muted."
+        ),
+        force: bool = typer.Option(
+            False, "--force", help="Add even if it repeats or disagrees with an existing rule."
+        ),
+    ) -> None:
+        """Add a playbook rule for a person."""
+        body: dict[str, Any] = {"text": text, "reason": _reason(reason)}
+        if scope is not None:
+            body["scope"] = _choice(scope, _SCOPES, "--scope")
+        if applies_to is not None:
+            body["applies_to"] = _applies_to(applies_to)
+            if body["applies_to"].get("kind") == "all":
+                body.pop("applies_to")
+        if when is not None:
+            body["when"] = _when(when)
+        if mode is not None:
+            body["mode"] = _choice(mode, _MODES, "--mode")
+        if category is not None:
+            body["category"] = category.strip().lower()
+        if polarity is not None:
+            body["polarity"] = _choice(polarity, ("always", "never", "prefer"), "--polarity")
+        if status is not None:
+            body["status"] = _choice(status, ("pending", "active", "muted"), "--status")
+        if force:
+            body["force"] = True
+        print_json_or_exit(console, lambda: api_client.admin_create_user_rule(user, body))
+
+    @command(
+        app,
+        "admin",
+        "update",
+        "rule",
+        api="PATCH /admin/playbook/users/{user}/rules/{rule_id}",
+        side_effects=[
+            "changes what Beeboo does for this account",
+            "a learned rule becomes authored and stops expiring",
+        ],
+        approval="ask",
+        reversible=True,
+        idempotent=True,
+        help=(
+            "PATCH /admin/playbook/users/{user}/rules/{rule_id} — change a rule's text, "
+            "status, applies_to, when or mode. --reason required; the rule keeps what it was before."
+        ),
+        epilog=_RULES_EPILOG,
+    )
+    def update_rule(
+        rule_id: str = typer.Argument(..., help="Rule id (rul_…)."),
+        user: str = _user_option(),
+        reason: str = _reason_option(),
+        text: str | None = typer.Option(None, "--text", help="New words."),
+        status: str | None = typer.Option(None, "--status", help=f"One of {', '.join(_STATUSES)}."),
+        applies_to: str | None = typer.Option(
+            None, "--applies-to", help='KIND:ID[:LABEL], or "all" for the whole account.'
+        ),
+        when: str | None = typer.Option(
+            None, "--when", help="Which products, JSON ({} for every product)."
+        ),
+        mode: str | None = typer.Option(None, "--mode", help="remind or act."),
+    ) -> None:
+        """Edit a person's playbook rule."""
+        body: dict[str, Any] = {}
+        if text is not None:
+            body["text"] = text
+        if status is not None:
+            body["status"] = _choice(status, _STATUSES, "--status")
+        if applies_to is not None:
+            body["applies_to"] = _applies_to(applies_to)
+        if when is not None:
+            body["when"] = _when(when)
+        if mode is not None:
+            body["mode"] = _choice(mode, _MODES, "--mode")
+        if not body:
+            raise typer.BadParameter(
+                "nothing to change: pass --text, --status, --applies-to, --when or --mode"
+            )
+        body["reason"] = _reason(reason)
+        print_json_or_exit(console, lambda: api_client.admin_update_user_rule(user, rule_id, body))
+
+    @command(
+        app,
+        "admin",
+        "delete",
+        "rule",
+        api="DELETE /admin/playbook/users/{user}/rules/{rule_id}",
+        side_effects=[
+            "archives the rule: off the brand's Rules page and out of every AI prompt",
+            "the learner will not propose the same words again",
+        ],
+        approval="ask",
+        reversible=True,
+        idempotent=False,
+        help=(
+            "DELETE /admin/playbook/users/{user}/rules/{rule_id} — remove a rule (archived, "
+            "with who and why kept on it; update --status active restores it). --reason required."
+        ),
+        epilog=_RULES_EPILOG,
+    )
+    def delete_rule(
+        rule_id: str = typer.Argument(..., help="Rule id (rul_…)."),
+        user: str = _user_option(),
+        reason: str = _reason_option(),
+    ) -> None:
+        """Remove (archive) a person's playbook rule."""
+        why = _reason(reason)
+        print_json_or_exit(console, lambda: api_client.admin_delete_user_rule(user, rule_id, why))

{makea_cli-0.2.14.dist-info → makea_cli-0.2.16.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.14
+Version: 0.2.16
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -92,20 +92,23 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin backfill supplier-id` | write（never） | `POST /admin/supplier/backfill_supplier_id_with_quote_requests` | Migrate supplier_id from a wrong UUID to the Cognito user sub (user_id): profile + Cognito supplierReferenceId, optio… | `backfill-supplier-id` |
 | `makea-cli admin create library-element` | write（auto） | `POST /admin/designer/{user_id}/library_components` | save a reusable component under a designer. Provide --section and --values (see admin get library-schema). | `library-create` |
 | `makea-cli admin create quote-request` | write（ask） | `POST /admin/supplier/create_quote_request` | create/send a quote request to a supplier for a product (admin). | `create-quote-request` |
+| `makea-cli admin create rule` | write（ask） | `POST /admin/playbook/users/{user}/rules` | add a rule to one person's AI playbook (user_id or email); admin-authored, active unless --status. Refuses a repeat or a conflict unless --force. --reason required. | — |
 | `makea-cli admin create supplier` | write（ask） | `POST /admin/supplier/add_supplier` | create supplier from JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the field taxonomy (… | `add-supplier` |
 | `makea-cli admin create user` | write（never） | `POST /admin/users/create` | register a user and confirm the Cognito account in one step (no verification email). Allowed --user-type values: "Fas… | `create-user` |
 | `makea-cli admin delete library-element` | write（never） | `DELETE /admin/designer/{user_id}/library_components/{component_id}` | remove a component from the designer's org library. | `library-delete` |
+| `makea-cli admin delete rule` | write（ask） | `DELETE /admin/playbook/users/{user}/rules/{rule_id}` | remove a rule: archived, with who and why kept on it (`update rule --status active` restores it). --reason required. | — |
 | `makea-cli admin download document` | read | `GET /admin/document/download` | save a document file (document id + designer user_id). | `download-document` |
 | `makea-cli admin download product-document` | read | `GET /admin/document/download` | Resolve product via admin list product-order payload, then GET /admin/document/download. | `download-product-document` |
 | `makea-cli admin generate pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Lay a production order's variants into pricing groups along one axis (--by style \| colour \| variant \| all) with th… | `production-groups-generate` |
 | `makea-cli admin get active-users` | read | `POST /admin/analytics/query` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
 | `makea-cli admin get analytics-query` | read | `POST /admin/analytics/query` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
-| `makea-cli admin get currency-conversion` | read | `currency-api` | avoids repeated lookups. | `convert-currency` |
+| `makea-cli admin get currency-conversion` | read | `GET /admin/fx/rates` | the platform's own exchange rates and rounding (rate table for several --from; one --from with --amount converts it). | `convert-currency` |
 | `makea-cli admin get feature-usage` | read | `POST /admin/analytics/query` | How many distinct users used a feature recently, plus event volume. Matches $pageview path and feature_time_spent eve… | `analytics-feature-usage` |
 | `makea-cli admin get library-schema` | read | `GET /admin/library_components/schema` | the tech-pack library taxonomy: sections and their library-role field keys (run this before create/update). | `library-schema` |
 | `makea-cli admin get production-pricing` | read | `GET /admin/production_orders/{id}/details` | show a production order's price tiers, MOQ, sizes/colours, pricing groups and cart coverage. | `production-pricing-show` |
 | `makea-cli admin get quote-request` | read | `GET /admin/quote_requests/{quote_request_id}` | one quote request in full. | — |
 | `makea-cli admin get revenue-metrics` | read | `GET /admin/business-metrics/cumulative-payment-and-platform-revenue` | platform-wide payment received and platform revenue (service fee + transaction fee) bucketed over a date range. | `get-cumulative-payment-and-platform-revenue` |
+| `makea-cli admin get rule` | read | `GET /admin/playbook/users/{user}/rules/{rule_id}` | one rule in full, with its evidence: where it came from, who changed it and why. | — |
 | `makea-cli admin get supplier-profile-schema` | read | `GET /admin/supplier/profile/schema` | supplier profile v2 schema (section/field taxonomy: sections, fields, options, required rules). | `get-supplier-profile-schema` |
 | `makea-cli admin get tech-spec-extraction` | read | `GET /admin/products/{id}/extract-tech-specifications` | AI-generate specs (not saved). | `extract-ai-tech-spec` |
 | `makea-cli admin get top-clicks` | read | `POST /admin/analytics/query` | which buttons/elements get clicked most. | `analytics-top-clicks` |
@@ -116,6 +119,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin list production-order` | read | `GET /admin/production_orders?type=PRODUCTION` | 大货 (production) orders only. For restock use admin list restock-order; for shipping use admin list shipping-order. | `list-all-production-orders` |
 | `makea-cli admin list quote-request` | read | `GET /admin/quote_requests` | quote requests, optionally for one product (--product) or one supplier (--supplier, GET /admin/quote_requests/supplie… | — |
 | `makea-cli admin list restock-order` | read | `GET /admin/production_orders?type=RESTOCK` | restock orders only. Restock shares the production_orders table; this filters to type=RESTOCK. | `list-all-restock-orders` |
+| `makea-cli admin list rule` | read | `GET /admin/playbook/users/{user}/rules` | every AI playbook rule that holds for one person (team, own account, factory): status, scope, text, which products, effect, source. Archived ones only with --all. | — |
 | `makea-cli admin list sampling-order` | read | `GET /admin/sampling_orders/get_all` | paginated list of all sampling orders (admin). | `list-all-sampling-orders` |
 | `makea-cli admin list shipping-order` | read | `GET /admin/shipping_orders` | paginated list of all shipping orders (admin). | `list-all-shipping-orders` |
 | `makea-cli admin list supplier` | read | `GET /admin/supplier/get_all_suppliers` | list all suppliers (admin). | `list-suppliers` |
@@ -129,6 +133,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update library-element` | write（auto） | `PATCH /admin/designer/{user_id}/library_components/{component_id}` | update a component's name and/or values (empty value clears a field). | `library-update` |
 | `makea-cli admin update quote` | write（ask） | `POST /admin/product/edit_supplier_link_override_info` | admin updates an existing quote (supplier link) in place. Only the options you pass are sent, and the backend leaves … | `update-supplier-quote` |
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
+| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/users/{user}/rules/{rule_id}` | change a rule's text, status, applies_to, when or mode. --reason required; the rule keeps what it was before. | — |
 | `makea-cli admin update supplier` | write（ask） | `PUT /admin/supplier/update_supplier` | update an existing supplier from a JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the fi… | `update-supplier` |
 | `makea-cli admin update tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |
 | `makea-cli admin update tracking-status` | write（ask） | `POST /admin/tracking/carrier_status` | apply a carrier status looked up by hand (tracking-sweep skill) to one order: status, fan-out, delivered emails (--silent: state only). | — |

{makea_cli-0.2.14.dist-info → makea_cli-0.2.16.dist-info}/RECORD

@@ -1,6 +1,6 @@
-makea_cli/__init__.py,sha256=3fSLgeJpZq4cUgzAH_CdFzXwJEO3NH_VVDv2pQnmwN0,23
+makea_cli/__init__.py,sha256=nS1Qf8CA6pxMzqGCeAMZHTKK2igCSNakZ3o7kDK0JIQ,23
 makea_cli/__main__.py,sha256=AkQjxWfKE3w9iD1d6I-2Zqvv2t9cct0oYyFF0UiA-Z0,144
-makea_cli/api_client.py,sha256=gnxrEoVzv7uJKGe1X0TGKjpVD1XxddoPdPKkLeTQStw,65051
+makea_cli/api_client.py,sha256=I3w5xPMSxZ0bUliXdS8Sz4_W0-ZS3uhHVvoAkn166ZE,67533
 makea_cli/auth_pkce.py,sha256=iXSyJ7DM3qVuj-3FwPiqM25CxXz9ebFs9FNthZdw3ws,7315
 makea_cli/broker.py,sha256=5O650nAdRuF-u9E1MuVM2jVv796iBdxJGIaJasxHij0,3019
 makea_cli/config.py,sha256=hz8MnJSkhxcIEZkcpHR005JrDceo1Xmi8qwIUq50cMU,3003
@@ -10,7 +10,7 @@ makea_cli/main.py,sha256=nuTQ8_P8OSdRbjMHMB4qcKdex124nS-ApCW-zfbqlI0,7169
 makea_cli/output.py,sha256=VWvZe2Ad8zxT4ZQyBhFRc6wkFwbyYzQFPddepANGAbY,6361
 makea_cli/posthog_client.py,sha256=k0cy9Hq7bhdLlPvC1ZW_esJ70xHDdQzPQUlx-GpVskk,1921
 makea_cli/registry.py,sha256=GYJK_idhwIh1X2ictwFjn8PEMaXT56hFVkoLEVYrVqw,13722
-makea_cli/commands/__init__.py,sha256=sxDNEYDmQTASzH2uvMtqNwKLLbOQBzwPfxc-S1tHf-w,1474
+makea_cli/commands/__init__.py,sha256=LJ6pjYtIL_VvdSRbF1QomSojcarJF710Sifg2RWsgQo,1575
 makea_cli/commands/_util.py,sha256=zSFwWaWpncARlKxgq4WuJlJvNv7XdZ39HfHrNOELHuw,980
 makea_cli/commands/analytics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 makea_cli/commands/analytics/cmd.py,sha256=KVLUtYSeyYZ8_09jIuIAmePjQqcpQS2mb5PBBzGwQYQ,6562
@@ -31,9 +31,11 @@ makea_cli/commands/factory/cmd.py,sha256=k_UGkqpzxxZhN9WjKt1rb95KOTGHMpMJRpfNHTG
 makea_cli/commands/library/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 makea_cli/commands/library/cmd.py,sha256=eXZa6iLyPaoEWtRd-UmhRT6Ox-zlfs89gJqGn-IPuSU,11187
 makea_cli/commands/metrics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-makea_cli/commands/metrics/cmd.py,sha256=mXMSy3zHgJXzqLNy6OrdQqySk9COknPKVDf_SQQdFIA,7662
+makea_cli/commands/metrics/cmd.py,sha256=ox5OD7Bk3QJcdHQv5u4t6G-OlC6eSbQG5BEH1yBkxno,6414
 makea_cli/commands/orders/__init__.py,sha256=6WKPqX02e0RRPmItPIBJ0TA4_yDI2PVvBDkAiMQu9rU,75
 makea_cli/commands/orders/cmd.py,sha256=Nh5lGv5k4SIwsr_hg-ndah8eTorZCYIMpTAz4CCi6oY,13352
+makea_cli/commands/playbook/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+makea_cli/commands/playbook/cmd.py,sha256=ktSn3Fx1i6GN4eGeqp4nW0OJ85oduIa3J10mDNRPRMo,12548
 makea_cli/commands/product/__init__.py,sha256=mfdonFmpbddDSlJq6JWNWgNpM6aOpKtZr-3FJ6scrwg,76
 makea_cli/commands/product/cmd.py,sha256=W0oVTZvsK1QWZWv2x6NC26_JQMXrO16O8gYuKYPWC08,7101
 makea_cli/commands/production/__init__.py,sha256=Whn5ziwVMt4jzcokiFWLhWIpRLYC-ldnjZgAzeQ3We4,79
@@ -41,7 +43,7 @@ makea_cli/commands/production/cmd.py,sha256=s6fVAGzOvokF6Va5WKGEA2vw2x2hDQ3PrsF0
 makea_cli/commands/production/pricing_spec.py,sha256=xGbj7-ps3PcKuU6Oc59A70b62FjF6Awhr5IY3ymZveU,27174
 makea_cli/commands/supplier/__init__.py,sha256=qfQDeQdQ-B7I_uwFVfcp1vXFUTL4fAcNLu3ipsZ7dfs,77
 makea_cli/commands/supplier/cmd.py,sha256=crRCy9WfhkryHMIL3iufoiT90_SG3-mKChAtdhd06uc,58076
-makea_cli-0.2.14.dist-info/METADATA,sha256=E4VzOb4JNgtC6tRz49sOdRKb3ZW2IqrEZJ6HFEgi6Wg,31730
-makea_cli-0.2.14.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-makea_cli-0.2.14.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
-makea_cli-0.2.14.dist-info/RECORD,,
+makea_cli-0.2.16.dist-info/METADATA,sha256=-Zpj9hQq0JaECBulxaELeFJeaMEjjthhrIDO8VxBeKI,32987
+makea_cli-0.2.16.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+makea_cli-0.2.16.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
+makea_cli-0.2.16.dist-info/RECORD,,