makea-cli 0.2.15__tar.gz → 0.2.16__tar.gz

{makea_cli-0.2.15 → makea_cli-0.2.16}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.2.16
+
+New: an admin can read, add, edit and remove the AI playbook rules of one
+person (backend 2026-10-18, deploy e408a077 or later).
+
+- `admin list rule --user <user_id|email> [--status …] [--all]`: every rule
+  that holds for the person, from their team, their own account and, for a
+  factory, its company. Archived rules only with `--all`.
+- `admin get rule <rule_id> --user …`: one rule with its evidence.
+- `admin create rule --user … --text … --reason …`: admin-authored, active
+  unless `--status`. Goes to the team when there is one (`--scope` to pick).
+  A repeat or a conflict is refused unless `--force`.
+- `admin update rule <rule_id> --user … --reason …`: text, status,
+  applies_to, which products (`--when`) or mode.
+- `admin delete rule <rule_id> --user … --reason …`: archives the rule, the
+  way the brand's own dismiss does. It leaves the brand's Rules page and every
+  prompt, and Beeboo will not propose the same words again. `update rule
+  --status active` brings it back.
+
+Every write needs `--reason`; the rule records who changed it, why and what
+it was before. An email on two accounts is refused with both user ids.
+
 ## 0.2.15
 
 **Behaviour change: `admin get currency-conversion` returns different

{makea_cli-0.2.15 → makea_cli-0.2.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.15
+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,9 +92,11 @@ 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` |
@@ -106,6 +108,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 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.15 → makea_cli-0.2.16}/README.md

@@ -80,9 +80,11 @@ 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` |
@@ -94,6 +96,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 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` |
@@ -104,6 +107,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` |
@@ -117,6 +121,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.16/makea_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.16"

{makea_cli-0.2.15 → makea_cli-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:
@@ -1047,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-0.2.15 → makea_cli-0.2.16}/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-0.2.16/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.15 → makea_cli-0.2.16}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "makea-cli"
-version = "0.2.15"
+version = "0.2.16"
 description = "Makea admin CLI (browser login + Makea admin HTTP API)"
 readme = "README.md"
 requires-python = ">=3.10"