makea-cli 0.2.18__py3-none-any.whl → 0.2.20__py3-none-any.whl

makea_cli/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.18"
+__version__ = "0.2.20"

makea_cli/api_client.py

@@ -1136,49 +1136,101 @@ 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.
+# --- admin: AI playbook rules -----------------------------------------------------
+# Addressed by whose they are: a person (user_id or email; the backend resolves
+# every scope their rules live in and refuses an email on more than one account),
+# one factory by supplier id, or the platform-wide GLOBAL playbook. 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 playbook_rules_path(
+    *, user: str | None = None, supplier: str | None = None, is_global: bool = False
+) -> str:
+    """Whose rules: a person (user_id or email), one factory, or the GLOBAL playbook."""
+    if is_global:
+        return "/admin/playbook/global/rules"
+    if supplier:
+        return f"/admin/playbook/suppliers/{quote(supplier.strip(), safe='')}/rules"
+    return f"/admin/playbook/users/{quote((user or '').strip(), safe='@')}/rules"
+
+
+def _rule_path(base: str, rule_id: str) -> str:
+    return f"{base}/{quote(rule_id, safe='')}"
 
 
-def admin_list_user_rules(
-    user: str, *, status: str | None = None, include_archived: bool = False
+def admin_list_rules(
+    base: str, *, status: str | None = None, include_archived: bool = False
 ) -> Any:
-    """GET /admin/playbook/users/{user}/rules — every rule that holds for one person."""
+    """GET …/rules — every rule on one target (``playbook_rules_path``)."""
     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)
+    return get_json(base, params=params or None)
+
+
+def admin_get_rule(base: str, rule_id: str) -> Any:
+    """GET …/rules/{rule_id} — one rule, evidence included."""
+    return get_json(_rule_path(base, rule_id))
+
+
+def admin_create_rule(base: str, body: dict[str, Any]) -> Any:
+    """POST …/rules — {text, reason, scope?, applies_to?, when?, mode?, category?,
+    polarity?, status?, force?}."""
+    return post_json(base, body)
+
+
+def admin_update_rule(base: str, rule_id: str, body: dict[str, Any]) -> Any:
+    """PATCH …/rules/{rule_id} — {text?, status?, applies_to?, when?, mode?, reason}."""
+    return patch_json(_rule_path(base, rule_id), body)
+
+
+def admin_delete_rule(base: str, rule_id: str, reason: str) -> Any:
+    """DELETE …/rules/{rule_id} — archives it, with the reason."""
+    return delete_json(_rule_path(base, rule_id), body={"reason": reason})
+
+
+# --- admin: one account's Knowledge > About you -----------------------------------
+# A person (user_id or email; a supplier account's person is their factory's page)
+# or one factory by supplier id. Every write but refresh carries a reason.
+
+
+def about_path(*, user: str | None = None, supplier: str | None = None) -> str:
+    if supplier:
+        return f"/admin/about/suppliers/{quote(supplier.strip(), safe='')}"
+    return f"/admin/about/users/{quote((user or '').strip(), safe='@')}"
+
+
+def admin_get_about(base: str) -> Any:
+    """GET /admin/about/{target} — the page: facts, removed, unknown, paused."""
+    return get_json(base)
+
+
+def admin_set_about_line(base: str, key: str, body: dict[str, Any]) -> Any:
+    """PATCH …/{key} — {text, valid_until?, reason}: add or reword one line."""
+    return patch_json(f"{base}/{quote(key, safe='')}", body)
 
 
-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_remove_about_line(base: str, key: str, reason: str) -> Any:
+    """DELETE …/{key} — remove the line; it is not guessed again."""
+    return delete_json(f"{base}/{quote(key, safe='')}", body={"reason": reason})
 
 
-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_restore_about_line(base: str, key: str, reason: str) -> Any:
+    """POST …/{key}/restore — bring a removed line back."""
+    return post_json(f"{base}/{quote(key, safe='')}/restore", {"reason": reason})
 
 
-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_pause_about(base: str, paused: bool, reason: str) -> Any:
+    """POST …/pause — stop (or resume) Beeboo using the page."""
+    return post_json(f"{base}/pause", {"paused": paused, "reason": reason})
 
 
-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})
+def admin_refresh_about(base: str, *, read: bool = False, force: bool = False) -> Any:
+    """POST …/refresh — recount from records now; ``read`` also reads the
+    conversations since last time (one model call, so a long timeout)."""
+    return post_json(f"{base}/refresh", {"read": read, "force": force}, timeout=300.0)
 
 
 def admin_get_rule_history(rule_id: str) -> Any:

makea_cli/commands/__init__.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import typer
 
+from makea_cli.commands.about.cmd import register as register_about
 from makea_cli.commands.analytics.cmd import register as register_analytics
 from makea_cli.commands.auth.cmd import register as register_auth
 from makea_cli.commands.brand.cmd import register as register_brand
@@ -37,3 +38,4 @@ def register_all(app: typer.Typer) -> None:
     register_factory(app)
     register_brand(app)
     register_playbook(app)
+    register_about(app)

makea_cli/commands/about/cmd.py

@@ -0,0 +1,253 @@
+"""Admin commands for one account's Knowledge > About you.
+
+About you is the short list of plain facts Beeboo starts every turn from
+("You sell DTC through Shopify", "Vinchy approves fit"), at most 8 lines: what
+the account said, what is counted from its orders, and what is read from its
+conversations. A fact can be wrong but cannot be broken; anything that can be
+broken is a rule (``admin … rule``).
+
+Two targets, exactly one of:
+
+* ``--user``: a person (user_id or email). A supplier account's person is
+  their factory's page; anyone else is their brand's (the team's when there
+  is one).
+* ``--supplier``: one factory, by supplier id.
+
+A line an admin writes counts as the account's own words: the nightly counting
+and reading leave it alone. A removed line is not guessed again until it is
+restored or said again. Every write but ``generate about`` needs ``--reason``,
+which goes to the audit log.
+"""
+
+from __future__ import annotations
+
+from datetime import date
+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()
+
+_ABOUT_EPILOG = """
+Target, exactly one of:
+  --user       a person: user_id (Cognito sub) or email
+  --supplier   one factory, by supplier id
+{target} in the API path is users/{user} or suppliers/{supplier}.
+
+KEY is a topic: `get about` lists them under keys[] (channels, roles,
+markets, closures, …), with what each means.
+
+Examples
+  makea-cli admin get about --user brand@example.com
+  makea-cli admin update about channels --user brand@example.com \\
+      --text "You sell wholesale to about 20 stockists." --reason "Said on the 14 Oct call"
+  makea-cli admin delete about price_band --supplier sup_123 --reason "Counted from one order"
+  makea-cli admin update about price_band --supplier sup_123 --restore --reason "Removed by mistake"
+  makea-cli admin generate about --user brand@example.com --read
+""".strip()
+
+
+def _user_option() -> Any:
+    return typer.Option(None, "--user", "-u", help="Target person: user_id or email.")
+
+
+def _supplier_option() -> Any:
+    return typer.Option(None, "--supplier", help="Target factory: supplier id.")
+
+
+def _reason_option() -> Any:
+    return typer.Option(..., "--reason", "-r", help="Why (required). Kept in the audit log.")
+
+
+def _target(user: str | None, supplier: str | None) -> str:
+    user = (user or "").strip() or None
+    supplier = (supplier or "").strip() or None
+    if bool(user) == bool(supplier):
+        raise typer.BadParameter("pass exactly one of --user, --supplier")
+    return api_client.about_path(user=user, supplier=supplier)
+
+
+def _reason(raw: str) -> str:
+    reason = " ".join(raw.split())
+    if not reason:
+        raise typer.BadParameter("--reason must not be empty")
+    return reason
+
+
+def register(app: typer.Typer) -> None:
+    @command(
+        app,
+        "admin",
+        "get",
+        "about",
+        api="GET /admin/about/{target}",
+        help=(
+            "GET /admin/about/{target} — one account's About you as its Knowledge tab "
+            "shows it: facts[] (key, text, source said/counted/read, valid_until), "
+            "removed[], unknown[], paused, and keys[] (every topic). Does not recount."
+        ),
+        epilog=_ABOUT_EPILOG,
+    )
+    def get_about(
+        user: str | None = _user_option(),
+        supplier: str | None = _supplier_option(),
+    ) -> None:
+        """Show an account's About you."""
+        base = _target(user, supplier)
+        print_json_or_exit(console, lambda: api_client.admin_get_about(base))
+
+    @command(
+        app,
+        "admin",
+        "update",
+        "about",
+        api="PATCH /admin/about/{target}/{key}",
+        side_effects=[
+            "Beeboo reads the new line from this account's next turn",
+            "the line shows on the account's Knowledge > About you tab",
+        ],
+        approval="ask",
+        reversible=True,
+        idempotent=True,
+        help=(
+            "PATCH /admin/about/{target}/{key} — add or reword one About you line (it then "
+            "stands as the account's own words); with --restore, POST …/{key}/restore "
+            "brings a removed line back. --reason required."
+        ),
+        epilog=_ABOUT_EPILOG,
+    )
+    def update_about(
+        key: str = typer.Argument(..., help="Topic key, e.g. channels (see get about)."),
+        user: str | None = _user_option(),
+        supplier: str | None = _supplier_option(),
+        reason: str = _reason_option(),
+        text: str | None = typer.Option(
+            None, "--text", help="The line, written to the account ('You sell…')."
+        ),
+        valid_until: str | None = typer.Option(
+            None,
+            "--valid-until",
+            help='YYYY-MM-DD the fact stops holding (a closure); "none" removes it.',
+        ),
+        restore: bool = typer.Option(False, "--restore", help="Bring a removed line back."),
+    ) -> None:
+        """Add, reword or restore one About you line."""
+        base = _target(user, supplier)
+        why = _reason(reason)
+        if restore:
+            if text is not None or valid_until is not None:
+                raise typer.BadParameter("--restore takes no --text or --valid-until")
+            print_json_or_exit(console, lambda: api_client.admin_restore_about_line(base, key, why))
+            return
+        body: dict[str, Any] = {"reason": why}
+        if text is not None:
+            body["text"] = text
+        if valid_until is not None:
+            if valid_until.strip().lower() == "none":
+                body["valid_until"] = None
+            else:
+                try:
+                    body["valid_until"] = date.fromisoformat(valid_until.strip()).isoformat()
+                except ValueError as e:
+                    raise typer.BadParameter("--valid-until: expected YYYY-MM-DD") from e
+        if len(body) == 1:
+            raise typer.BadParameter("nothing to change: pass --text, --valid-until or --restore")
+        print_json_or_exit(console, lambda: api_client.admin_set_about_line(base, key, body))
+
+    @command(
+        app,
+        "admin",
+        "delete",
+        "about",
+        api="DELETE /admin/about/{target}/{key}",
+        side_effects=[
+            "the line leaves the account's About you and Beeboo's context",
+            "counting and reading will not bring the topic back",
+        ],
+        approval="ask",
+        reversible=True,
+        idempotent=False,
+        help=(
+            "DELETE /admin/about/{target}/{key} — remove one About you line; it is not "
+            "guessed again (update about KEY --restore brings it back). --reason required."
+        ),
+        epilog=_ABOUT_EPILOG,
+    )
+    def delete_about(
+        key: str = typer.Argument(..., help="Topic key (see get about)."),
+        user: str | None = _user_option(),
+        supplier: str | None = _supplier_option(),
+        reason: str = _reason_option(),
+    ) -> None:
+        """Remove one About you line."""
+        base = _target(user, supplier)
+        why = _reason(reason)
+        print_json_or_exit(console, lambda: api_client.admin_remove_about_line(base, key, why))
+
+    @command(
+        app,
+        "admin",
+        "update",
+        "about-pause",
+        api="POST /admin/about/{target}/pause",
+        side_effects=["Beeboo stops (or resumes) reading this account's About you"],
+        approval="ask",
+        reversible=True,
+        idempotent=True,
+        help=(
+            "POST /admin/about/{target}/pause — stop Beeboo using the account's About you "
+            "(--resume to start again); the lines are kept. --reason required."
+        ),
+        epilog=_ABOUT_EPILOG,
+    )
+    def update_about_pause(
+        user: str | None = _user_option(),
+        supplier: str | None = _supplier_option(),
+        reason: str = _reason_option(),
+        resume: bool = typer.Option(False, "--resume", help="Start using it again."),
+    ) -> None:
+        """Pause or resume an account's About you."""
+        base = _target(user, supplier)
+        why = _reason(reason)
+        print_json_or_exit(console, lambda: api_client.admin_pause_about(base, not resume, why))
+
+    @command(
+        app,
+        "admin",
+        "generate",
+        "about",
+        api="POST /admin/about/{target}/refresh",
+        side_effects=[
+            "recounts the counted lines from the account's records now",
+            "with --read, adds lines read from its conversations (one model call)",
+        ],
+        approval="auto",
+        reversible=False,
+        idempotent=True,
+        help=(
+            "POST /admin/about/{target}/refresh — bring an account's About you up to date "
+            "now instead of at the nightly pass: recount from records; --read also reads "
+            "its conversations since last time; --force re-reads all of them."
+        ),
+        epilog=_ABOUT_EPILOG,
+    )
+    def generate_about(
+        user: str | None = _user_option(),
+        supplier: str | None = _supplier_option(),
+        read: bool = typer.Option(False, "--read", help="Also read conversations (model call)."),
+        force: bool = typer.Option(
+            False, "--force", help="With --read: re-read everything, not just what is new."
+        ),
+    ) -> None:
+        """Recount (and read) an account's About you now."""
+        base = _target(user, supplier)
+        if force and not read:
+            raise typer.BadParameter("--force only applies with --read")
+        print_json_or_exit(
+            console, lambda: api_client.admin_refresh_about(base, read=read, force=force)
+        )

makea_cli/commands/playbook/cmd.py

@@ -1,11 +1,16 @@
-"""Admin commands for one person's AI playbook rules (Knowledge > Rules).
+"""Admin commands for 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.
+the person's own account, for a factory on its company playbook, and on the
+platform-wide GLOBAL playbook every account's AI reads. These commands address
+one of three targets:
+
+* ``--user``: a person (user_id or email); the backend finds every scope their
+  rules live in. An email on more than one account is refused with the
+  candidates, so pass the user_id then.
+* ``--supplier``: one factory's company playbook, by supplier id.
+* ``--global``: the GLOBAL playbook (at most 30 live rules).
 
 Every write needs ``--reason``. The rule keeps it as an evidence entry
 (``admin_add`` / ``admin_edit`` / ``admin_delete`` with who, why, when and,
@@ -17,6 +22,7 @@ the row stays as the record, and ``update --status active`` brings it back.
 from __future__ import annotations
 
 import json
+from datetime import date
 from typing import Any
 
 import typer
@@ -34,11 +40,16 @@ _APPLIES_TO_KINDS = ("style", "collection", "supplier", "element")
 _MODES = ("remind", "act")
 
 _RULES_EPILOG = """
---user takes a user_id (Cognito sub) or an email.
+Target, exactly one of:
+  --user       a person: user_id (Cognito sub) or email
+  --supplier   one factory, by supplier id
+  --global     the platform-wide playbook every account's AI reads (max 30 live rules)
+{target} in the API path is users/{user}, suppliers/{supplier} or global.
 
 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.
+SUPPLIER#… a factory's, PLAYBOOK#GLOBAL everyone's. A new rule for a --user
+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).
@@ -58,11 +69,33 @@ Examples
       --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"
+  makea-cli admin list rule --supplier sup_123
+  makea-cli admin create rule --global \\
+      --text "Quote prices in the brand's currency" --reason "Agreed in the 20 Oct review"
 """.strip()
 
 
 def _user_option() -> Any:
-    return typer.Option(..., "--user", "-u", help="Target person: user_id or email.")
+    return typer.Option(None, "--user", "-u", help="Target person: user_id or email.")
+
+
+def _supplier_option() -> Any:
+    return typer.Option(None, "--supplier", help="Target factory: supplier id.")
+
+
+def _global_option() -> Any:
+    return typer.Option(
+        False, "--global", help="Target the platform-wide playbook every account reads."
+    )
+
+
+def _target(user: str | None, supplier: str | None, is_global: bool) -> str:
+    """The rules path for exactly one of --user, --supplier, --global."""
+    user = (user or "").strip() or None
+    supplier = (supplier or "").strip() or None
+    if sum(bool(t) for t in (user, supplier, is_global)) != 1:
+        raise typer.BadParameter("pass exactly one of --user, --supplier, --global")
+    return api_client.playbook_rules_path(user=user, supplier=supplier, is_global=is_global)
 
 
 def _reason_option() -> Any:
@@ -107,6 +140,13 @@ def _when(raw: str) -> dict[str, Any]:
     return data
 
 
+def _date(raw: str) -> str:
+    try:
+        return date.fromisoformat(raw.strip()).isoformat()
+    except ValueError as e:
+        raise typer.BadParameter("--valid-until: expected YYYY-MM-DD") from e
+
+
 def _choice(value: str | None, allowed: tuple[str, ...], flag: str) -> str | None:
     if value is None:
         return None
@@ -122,16 +162,19 @@ def register(app: typer.Typer) -> None:
         "admin",
         "list",
         "rule",
-        api="GET /admin/playbook/users/{user}/rules",
+        api="GET /admin/playbook/{target}/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."
+            "GET /admin/playbook/{target}/rules — every AI playbook rule that holds "
+            "for one person (team, own account, factory), one factory (--supplier) or "
+            "everyone (--global): 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(),
+        user: str | None = _user_option(),
+        supplier: str | None = _supplier_option(),
+        is_global: bool = _global_option(),
         status: str | None = typer.Option(
             None,
             "--status",
@@ -142,14 +185,15 @@ def register(app: typer.Typer) -> None:
             False, "--all", help="Also list archived (deleted) rules."
         ),
     ) -> None:
-        """List a person's playbook rules."""
+        """List the playbook rules of a person, a factory or the global playbook."""
+        base = _target(user, supplier, is_global)
         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
+            lambda: api_client.admin_list_rules(
+                base, status=status, include_archived=include_archived
             ),
         )
 
@@ -158,19 +202,22 @@ def register(app: typer.Typer) -> None:
         "admin",
         "get",
         "rule",
-        api="GET /admin/playbook/users/{user}/rules/{rule_id}",
+        api="GET /admin/playbook/{target}/rules/{rule_id}",
         help=(
-            "GET /admin/playbook/users/{user}/rules/{rule_id} — one rule in full, "
+            "GET /admin/playbook/{target}/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(),
+        user: str | None = _user_option(),
+        supplier: str | None = _supplier_option(),
+        is_global: bool = _global_option(),
     ) -> None:
         """Show one playbook rule with its evidence."""
-        print_json_or_exit(console, lambda: api_client.admin_get_user_rule(user, rule_id))
+        base = _target(user, supplier, is_global)
+        print_json_or_exit(console, lambda: api_client.admin_get_rule(base, rule_id))
 
     @command(
         app,
@@ -242,27 +289,33 @@ def register(app: typer.Typer) -> None:
         "admin",
         "create",
         "rule",
-        api="POST /admin/playbook/users/{user}/rules",
+        api="POST /admin/playbook/{target}/rules",
         side_effects=[
-            "Beeboo follows the rule in this account's AI answers from now on",
+            "Beeboo follows the rule in this account's AI answers from now on "
+            "(every account's, with --global)",
             "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."
+            "POST /admin/playbook/{target}/rules — add a rule to a person's, a factory's "
+            "or the global playbook (admin-authored, active unless --status). Refuses a "
+            "repeat or a conflict unless --force, and a 31st live global rule. "
+            "--reason required."
         ),
         epilog=_RULES_EPILOG,
     )
     def create_rule(
-        user: str = _user_option(),
+        user: str | None = _user_option(),
+        supplier: str | None = _supplier_option(),
+        is_global: bool = _global_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)."
+            None,
+            "--scope",
+            help=f"Where a --user rule lives: {', '.join(_SCOPES)} (default: see below).",
         ),
         applies_to: str | None = typer.Option(
             None, "--applies-to", help="Narrow to one thing: KIND:ID[:LABEL]."
@@ -290,10 +343,18 @@ def register(app: typer.Typer) -> None:
         force: bool = typer.Option(
             False, "--force", help="Add even if it repeats or disagrees with an existing rule."
         ),
+        valid_until: str | None = typer.Option(
+            None,
+            "--valid-until",
+            help="YYYY-MM-DD the rule ends on (a closure, a temporary arrangement).",
+        ),
     ) -> None:
-        """Add a playbook rule for a person."""
+        """Add a playbook rule for a person, a factory or everyone."""
+        base = _target(user, supplier, is_global)
         body: dict[str, Any] = {"text": text, "reason": _reason(reason)}
         if scope is not None:
+            if not user:
+                raise typer.BadParameter("--scope only applies with --user")
             body["scope"] = _choice(scope, _SCOPES, "--scope")
         if applies_to is not None:
             body["applies_to"] = _applies_to(applies_to)
@@ -311,14 +372,16 @@ def register(app: typer.Typer) -> 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))
+        if valid_until is not None:
+            body["valid_until"] = _date(valid_until)
+        print_json_or_exit(console, lambda: api_client.admin_create_rule(base, body))
 
     @command(
         app,
         "admin",
         "update",
         "rule",
-        api="PATCH /admin/playbook/users/{user}/rules/{rule_id}",
+        api="PATCH /admin/playbook/{target}/rules/{rule_id}",
         side_effects=[
             "changes what Beeboo does for this account",
             "a learned rule becomes authored and stops expiring",
@@ -327,14 +390,16 @@ def register(app: typer.Typer) -> None:
         reversible=True,
         idempotent=True,
         help=(
-            "PATCH /admin/playbook/users/{user}/rules/{rule_id} — change a rule's text, "
+            "PATCH /admin/playbook/{target}/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(),
+        user: str | None = _user_option(),
+        supplier: str | None = _supplier_option(),
+        is_global: bool = _global_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)}."),
@@ -345,8 +410,14 @@ def register(app: typer.Typer) -> None:
             None, "--when", help="Which products, JSON ({} for every product)."
         ),
         mode: str | None = typer.Option(None, "--mode", help="remind or act."),
+        valid_until: str | None = typer.Option(
+            None,
+            "--valid-until",
+            help='YYYY-MM-DD the rule ends on; "none" removes the end date.',
+        ),
     ) -> None:
-        """Edit a person's playbook rule."""
+        """Edit a playbook rule."""
+        base = _target(user, supplier, is_global)
         body: dict[str, Any] = {}
         if text is not None:
             body["text"] = text
@@ -358,19 +429,24 @@ def register(app: typer.Typer) -> None:
             body["when"] = _when(when)
         if mode is not None:
             body["mode"] = _choice(mode, _MODES, "--mode")
+        if valid_until is not None:
+            body["valid_until"] = (
+                "" if valid_until.strip().lower() == "none" else _date(valid_until)
+            )
         if not body:
             raise typer.BadParameter(
-                "nothing to change: pass --text, --status, --applies-to, --when or --mode"
+                "nothing to change: pass --text, --status, --applies-to, --when, --mode "
+                "or --valid-until"
             )
         body["reason"] = _reason(reason)
-        print_json_or_exit(console, lambda: api_client.admin_update_user_rule(user, rule_id, body))
+        print_json_or_exit(console, lambda: api_client.admin_update_rule(base, rule_id, body))
 
     @command(
         app,
         "admin",
         "delete",
         "rule",
-        api="DELETE /admin/playbook/users/{user}/rules/{rule_id}",
+        api="DELETE /admin/playbook/{target}/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",
@@ -379,16 +455,19 @@ def register(app: typer.Typer) -> None:
         reversible=True,
         idempotent=False,
         help=(
-            "DELETE /admin/playbook/users/{user}/rules/{rule_id} — remove a rule (archived, "
+            "DELETE /admin/playbook/{target}/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(),
+        user: str | None = _user_option(),
+        supplier: str | None = _supplier_option(),
+        is_global: bool = _global_option(),
         reason: str = _reason_option(),
     ) -> None:
-        """Remove (archive) a person's playbook rule."""
+        """Remove (archive) a playbook rule."""
+        base = _target(user, supplier, is_global)
         why = _reason(reason)
-        print_json_or_exit(console, lambda: api_client.admin_delete_user_rule(user, rule_id, why))
+        print_json_or_exit(console, lambda: api_client.admin_delete_rule(base, rule_id, why))

{makea_cli-0.2.18.dist-info → makea_cli-0.2.20.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.18
+Version: 0.2.20
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -92,21 +92,24 @@ 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 rule` | write（ask） | `POST /admin/playbook/{target}/rules` | add a rule to a person's (`--user`, user_id or email), a factory's (`--supplier`) or the platform-wide (`--global`, max 30 live) AI playbook; admin-authored, active unless --status. Refuses a repeat or a conflict unless --force. --reason required. | — |
 | `makea-cli admin create shipping-fee` | write（ask） | `POST /admin/shipping_orders/{shipping_order_id}/fees/add` | add a fee (fixed amount or percentage) on top of the freight. | — |
 | `makea-cli admin create shipping-option` | write（ask） | `POST /admin/shipping_orders/{shipping_order_id}/shipping-options` | add one freight quote (provider, speed, price, currency). | — |
 | `makea-cli admin create shipping-order` | write（ask） | `POST /admin/shipping_orders/create` | make a shipment for a brand's production and/or sampling orders. The shipment belongs to the orders' owner; you are r… | — |
 | `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 about` | write（ask） | `DELETE /admin/about/{target}/{key}` | remove one About you line (`--user` / `--supplier`); it is not guessed again. --reason required. | — |
 | `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 delete rule` | write（ask） | `DELETE /admin/playbook/{target}/rules/{rule_id}` | remove a rule (`--user` / `--supplier` / `--global`): archived, with who and why kept on it (`update rule --status active` restores it). --reason required. | — |
 | `makea-cli admin delete shipping-fee` | write（ask） | `DELETE /admin/shipping_orders/{shipping_order_id}/fees/{fee_id}/remove` | remove one fee. | — |
 | `makea-cli admin delete shipping-option` | write（ask） | `DELETE /admin/shipping_orders/{shipping_order_id}/shipping-options/{shipping_option_id}/remove` | withdraw one freight quote. | — |
 | `makea-cli admin delete shipping-order` | write（never） | `DELETE /admin/shipping_orders/{shipping_order_id}/delete` | remove a shipment and free its orders. Graded `never`: the backend does not check status, so it removes a paid or in-transit shipment too. | — |
 | `makea-cli admin delete shipping-order-item` | write（ask） | `POST /admin/production_orders/{id}/unlink_from_shipping_order/{shipping_order_id}` | take one production or sampling order off a shipment. A shipment left empty is deleted. | — |
 | `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 about` | write（auto） | `POST /admin/about/{target}/refresh` | recount an account's About you now; `--read` also reads its conversations (one model call). | — |
 | `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 about` | read | `GET /admin/about/{target}` | one account's About you (`--user`: a supplier account's person gets their factory's page; `--supplier`): facts, removed, unknown, paused, topic keys. | — |
 | `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 | `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` |
@@ -116,7 +119,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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 rule` | read | `GET /admin/playbook/{target}/rules/{rule_id}` | one rule in full (`--user` / `--supplier` / `--global`), with its evidence: where it came from, who changed it and why. | — |
 | `makea-cli admin get rule-history` | read | `GET /admin/playbook/rules/{rule_id}/history` | every revision of one rule: its words, who changed it and why, and the rule that replaced it. | — |
 | `makea-cli admin get shipping-order` | read | `GET /admin/shipping_orders/{shipping_order_id}/details` | one shipment with its production and sampling orders, freight quotes, fees, tracking and address. | — |
 | `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` |
@@ -129,7 +132,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 rule` | read | `GET /admin/playbook/{target}/rules` | every AI playbook rule for one person (team, own account, factory), one factory (`--supplier`) or the platform (`--global`): 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` |
@@ -140,10 +143,12 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin set production-tiers` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Set the order-wide price tiers / MOQ / incoterm / currency on a production order (the schedule used when it has no pr… | `production-tiers-set` |
 | `makea-cli admin set production-variants` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Set a production order's available sizes and colours (the grid the buyer's cart and every pricing group's cart keys a… | `production-variants-set` |
 | `makea-cli admin submit quote` | write（ask） | `POST /admin/quote_requests/{quote_request_id}/submit_quote` | admin submits a new quote (link) to a quote request. Pricing groups cannot be sent here (the submit endpoint ignores … | `submit-supplier-quote` |
+| `makea-cli admin update about` | write（ask） | `PATCH /admin/about/{target}/{key}` | add or reword one About you line (stands as the account's own words); `--restore` brings a removed one back. --reason required. | — |
+| `makea-cli admin update about-pause` | write（ask） | `POST /admin/about/{target}/pause` | stop (or `--resume`) Beeboo using an account's About you. --reason required. | — |
 | `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 rule` | write（ask） | `PATCH /admin/playbook/{target}/rules/{rule_id}` | change a rule's text, status, applies_to, when, mode or end date (--valid-until), on `--user` / `--supplier` / `--global`. --reason required; the rule keeps what it was before. | — |
 | `makea-cli admin update shipping-order` | write（ask） | `PUT /admin/shipping_orders/{shipping_order_id}/status` | Change a shipment: --status (PUT .../status), tracking flags (POST .../tracking), --address (PUT .../shipping-address… | — |
 | `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-0.2.18.dist-info → makea_cli-0.2.20.dist-info}/RECORD

@@ -1,6 +1,6 @@
-makea_cli/__init__.py,sha256=3RGPra41WobAbWeoPRqR_JXeysqFvK3H3AP1g9gjj3g,23
+makea_cli/__init__.py,sha256=PP1XN3LVw4efHZSwpFDbQRezvRqPg1JqZ--H2vUombw,23
 makea_cli/__main__.py,sha256=AkQjxWfKE3w9iD1d6I-2Zqvv2t9cct0oYyFF0UiA-Z0,144
-makea_cli/api_client.py,sha256=yrHxKDQUov6iuXJZaMq33tyKfuoPhVg6wYLLIwt-88A,71777
+makea_cli/api_client.py,sha256=dQckmLB-wbUuhznW7ej_xe79hVQm_3Xn1OzGykNBVwk,73833
 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,8 +10,10 @@ 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=A6nBCidMsRXfNtIPhJhbvIQklYe1BIphMAubZQc1s0w,1676
+makea_cli/commands/__init__.py,sha256=lTvsdzRvYIRwJuTlDPKcOmp0OWekNlxXsi-63g4q46w,1768
 makea_cli/commands/_util.py,sha256=zSFwWaWpncARlKxgq4WuJlJvNv7XdZ39HfHrNOELHuw,980
+makea_cli/commands/about/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+makea_cli/commands/about/cmd.py,sha256=smvn0WWfRfyL6h1ZB7vXSmJY67t7qhTHdRqxTk4jqeI,9665
 makea_cli/commands/analytics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 makea_cli/commands/analytics/cmd.py,sha256=KVLUtYSeyYZ8_09jIuIAmePjQqcpQS2mb5PBBzGwQYQ,6562
 makea_cli/commands/auth/__init__.py,sha256=NXoKGfkY2X_hb8GnAyzhoI_qDXfpwKZPqt4HnOrXW3Y,73
@@ -35,7 +37,7 @@ makea_cli/commands/metrics/cmd.py,sha256=ox5OD7Bk3QJcdHQv5u4t6G-OlC6eSbQG5BEH1yB
 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=lXKY6PQ6oLkHFHwghsPUKXtdT2bDLTtLl7Wgg8vhXtE,15237
+makea_cli/commands/playbook/cmd.py,sha256=Vj2jPtFe6laIhL1ZTqkw4LRJzmSB8ewP0pd-Z2ADg8s,18608
 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
@@ -45,7 +47,7 @@ makea_cli/commands/shipping/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMp
 makea_cli/commands/shipping/cmd.py,sha256=ozt73pj3onlOv0NhEwiJlslyG9WOycE0QN4tmzwFlT0,17280
 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.18.dist-info/METADATA,sha256=OagrYvbHIf9KWYTBUIPm0TXVlhJA4-WeBrIhY9WueCw,35416
-makea_cli-0.2.18.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-makea_cli-0.2.18.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
-makea_cli-0.2.18.dist-info/RECORD,,
+makea_cli-0.2.20.dist-info/METADATA,sha256=PQo8Hp4cyZ9xhDd4VcTgTQcGkjIoXrolYPkOktBMz3s,36693
+makea_cli-0.2.20.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+makea_cli-0.2.20.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
+makea_cli-0.2.20.dist-info/RECORD,,