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

makea_cli/__init__.py

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

makea_cli/api_client.py

@@ -1181,6 +1181,31 @@ def admin_delete_user_rule(user: str, rule_id: str, reason: str) -> Any:
     return delete_json(_user_rules_path(user, rule_id), body={"reason": reason})
 
 
+def admin_get_rule_history(rule_id: str) -> Any:
+    """GET /admin/playbook/rules/{rule_id}/history — every revision of one rule
+    (words, who, why), what replaced it and what it replaced."""
+    return get_json(f"/admin/playbook/rules/{quote(rule_id, safe='')}/history")
+
+
+def admin_playbook_preview(
+    surface: str,
+    *,
+    user_id: str | None = None,
+    supplier_id: str | None = None,
+    product_id: str | None = None,
+) -> Any:
+    """GET /admin/playbook/preview — the block a surface would inject, plus every
+    rule left out and why (``excluded``)."""
+    params: dict[str, Any] = {"surface": surface}
+    if user_id:
+        params["user_id"] = user_id
+    if supplier_id:
+        params["supplier_id"] = supplier_id
+    if product_id:
+        params["product_id"] = product_id
+    return get_json("/admin/playbook/preview", params=params)
+
+
 # --- supplier persona: a factory acting on its own RFQs, quotes and orders --------
 
 

makea_cli/commands/playbook/cmd.py

@@ -172,6 +172,71 @@ def register(app: typer.Typer) -> 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",
+        "get",
+        "rule-history",
+        api="GET /admin/playbook/rules/{rule_id}/history",
+        help=(
+            "GET /admin/playbook/rules/{rule_id}/history — every revision of one rule: "
+            "its words, who changed it and why; superseded_chain leads to the rule "
+            "that holds now when this one was replaced."
+        ),
+    )
+    def get_rule_history(
+        rule_id: str = typer.Argument(..., help="Rule id (rul_…)."),
+    ) -> None:
+        """Show what a playbook rule said at each point, and what replaced it."""
+        print_json_or_exit(console, lambda: api_client.admin_get_rule_history(rule_id))
+
+    @command(
+        app,
+        "admin",
+        "get",
+        "playbook-preview",
+        api="GET /admin/playbook/preview",
+        help=(
+            "GET /admin/playbook/preview — the playbook block one AI surface would get "
+            "for a person (or a factory), and in excluded[] every rule read that stays "
+            "out with its reason (waiting for confirmation, paused, only for knitwear, "
+            "over budget…). --product previews a conversation about one product."
+        ),
+    )
+    def playbook_preview(
+        user: str | None = typer.Option(None, "--user", "-u", help="Brand user_id."),
+        supplier: str | None = typer.Option(None, "--supplier", help="Supplier id."),
+        surface: str = typer.Option(
+            "chat_default", "--surface", help="AI surface, e.g. chat_default."
+        ),
+        product: str | None = typer.Option(None, "--product", "-p", help="Product id."),
+        rule: str | None = typer.Option(
+            None, "--rule", help="Only say whether this rule is in, and if not why."
+        ),
+    ) -> None:
+        """Preview a playbook block and why the other rules stay out."""
+        if not user and not supplier:
+            raise typer.BadParameter("pass --user or --supplier")
+
+        def fetch() -> Any:
+            out = api_client.admin_playbook_preview(
+                surface, user_id=user, supplier_id=supplier, product_id=product
+            )
+            if not rule:
+                return out
+            if rule in (out.get("rule_ids") or []):
+                return {"rule_id": rule, "in_prompt": True}
+            for ex in out.get("excluded") or []:
+                if ex.get("rule_id") == rule:
+                    return {"rule_id": rule, "in_prompt": False, **ex}
+            return {
+                "rule_id": rule,
+                "in_prompt": False,
+                "reason": "not read: archived, or not on a scope this surface reads",
+            }
+
+        print_json_or_exit(console, fetch)
+
     @command(
         app,
         "admin",

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.17
+Version: 0.2.18
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -112,10 +112,12 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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 playbook-preview` | read | `GET /admin/playbook/preview` | the playbook block one AI surface would get for a person or factory, and every rule left out with its reason; --product previews a conversation about one product, --rule answers for one rule. | — |
 | `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-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` |
 | `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-0.2.17.dist-info → makea_cli-0.2.18.dist-info}/RECORD

@@ -1,6 +1,6 @@
-makea_cli/__init__.py,sha256=Qi17SZ8BBtfJyUgJ1-dmlKGJmEwoMRO4CvqGYPFRAhw,23
+makea_cli/__init__.py,sha256=3RGPra41WobAbWeoPRqR_JXeysqFvK3H3AP1g9gjj3g,23
 makea_cli/__main__.py,sha256=AkQjxWfKE3w9iD1d6I-2Zqvv2t9cct0oYyFF0UiA-Z0,144
-makea_cli/api_client.py,sha256=sPJ_YmfzlpyOi8HL95pDEnQin_eZIN00Yc9LD4fj4XE,70913
+makea_cli/api_client.py,sha256=yrHxKDQUov6iuXJZaMq33tyKfuoPhVg6wYLLIwt-88A,71777
 makea_cli/auth_pkce.py,sha256=iXSyJ7DM3qVuj-3FwPiqM25CxXz9ebFs9FNthZdw3ws,7315
 makea_cli/broker.py,sha256=5O650nAdRuF-u9E1MuVM2jVv796iBdxJGIaJasxHij0,3019
 makea_cli/config.py,sha256=hz8MnJSkhxcIEZkcpHR005JrDceo1Xmi8qwIUq50cMU,3003
@@ -35,7 +35,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=ktSn3Fx1i6GN4eGeqp4nW0OJ85oduIa3J10mDNRPRMo,12548
+makea_cli/commands/playbook/cmd.py,sha256=lXKY6PQ6oLkHFHwghsPUKXtdT2bDLTtLl7Wgg8vhXtE,15237
 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 +45,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.17.dist-info/METADATA,sha256=aubC1OdePkFzgJBiKYJPPEk1-wtjC7jwfckx2JA4OgU,34938
-makea_cli-0.2.17.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-makea_cli-0.2.17.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
-makea_cli-0.2.17.dist-info/RECORD,,
+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,,