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

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

@@ -1,5 +1,41 @@
 # Changelog
 
+## 0.2.18
+
+New: see why a playbook rule did not reach Beeboo, and what a rule said
+before. Both need the backend's playbook trace and revisions (ca0469d1).
+
+- `admin get playbook-preview -u <user> [--product <id>] [--surface …]`: the
+  block one AI surface would get, and in `excluded[]` every rule read that
+  stays out with its reason (waiting for the brand, paused, only for other
+  product types, narrowed to another factory, over budget…). `--rule <id>`
+  answers for one rule only; `--supplier` previews a factory's playbook.
+- `admin get rule-history <rule_id>`: every revision of one rule, with who
+  changed it and why, and `superseded_chain` to the rule that replaced it.
+
+## 0.2.17
+
+New: an admin can make and run shipping orders from the CLI. `create
+shipping-order` needs the backend's new `POST /admin/shipping_orders/create`;
+the other commands use endpoints the admin web page already calls.
+
+- `admin create shipping-order -p <production_order_id> [-s <sampling_order_id>] …`:
+  a shipment owned by the orders' brand (it shows on their Ship page, and the
+  fulfilment fee follows their plan); you are recorded as created_by.
+  Optional `--mode`, `--status` (default SUBMITTED), `--address`. Orders
+  already on a live shipment are refused, and one shipment carries one
+  supplier's goods.
+- `admin get shipping-order <id>`: the shipment with its orders, quotes, fees,
+  tracking and address.
+- `admin update shipping-order <id>`: any of `--status`, tracking
+  (`--tracking-number`, `--tracking-url`, `--shipping-method`, `--carrier-id`),
+  `--address`, `--cartons` / `--gross-weight-kg`.
+- `admin create|delete shipping-option`: add or withdraw a freight quote.
+- `admin create|delete shipping-fee`: add or remove a fee on the shipment.
+- `admin delete shipping-order-item <id> -p|-s <order_id>`: take one order off
+  a shipment (an emptied shipment is deleted).
+- `admin delete shipping-order <id>`: delete the shipment and free its orders.
+
 ## 0.2.16
 
 New: an admin can read, add, edit and remove the AI playbook rules of one

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.16
+Version: 0.2.18
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -93,10 +93,17 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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 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 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 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 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` |
@@ -105,10 +112,13 @@ 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 admin get top-clicks` | read | `POST /admin/analytics/query` | which buttons/elements get clicked most. | `analytics-top-clicks` |
@@ -134,6 +144,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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 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 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-0.2.18}/README.md

@@ -81,10 +81,17 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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 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 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 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 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` |
@@ -93,10 +100,13 @@ 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 admin get top-clicks` | read | `POST /admin/analytics/query` | which buttons/elements get clicked most. | `analytics-top-clicks` |
@@ -122,6 +132,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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 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 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.18/makea_cli/__init__.py

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

{makea_cli-0.2.16 → makea_cli-0.2.18}/makea_cli/api_client.py

@@ -766,6 +766,89 @@ def get_all_shipping_orders(
     return get_json("/admin/shipping_orders", params=params)
 
 
+def admin_create_shipping_order(body: dict[str, Any]) -> Any:
+    """POST /admin/shipping_orders/create — a shipment for a brand's production/sampling orders."""
+    return post_json("/admin/shipping_orders/create", body)
+
+
+def admin_get_shipping_order(shipping_order_id: str) -> Any:
+    """GET /admin/shipping_orders/{id}/details — the shipment with its orders filled in."""
+    return get_json(f"/admin/shipping_orders/{shipping_order_id}/details")
+
+
+def admin_update_shipping_order_status(shipping_order_id: str, status: str) -> Any:
+    """PUT /admin/shipping_orders/{id}/status"""
+    return put_json(f"/admin/shipping_orders/{shipping_order_id}/status", {"status": status})
+
+
+def admin_update_shipping_order_tracking(
+    shipping_order_id: str, tracking_info: dict[str, Any]
+) -> Any:
+    """POST /admin/shipping_orders/{id}/tracking"""
+    return post_json(
+        f"/admin/shipping_orders/{shipping_order_id}/tracking", {"tracking_info": tracking_info}
+    )
+
+
+def admin_update_shipping_order_address(
+    shipping_order_id: str, shipping_address: dict[str, Any]
+) -> Any:
+    """PUT /admin/shipping_orders/{id}/shipping-address"""
+    return put_json(
+        f"/admin/shipping_orders/{shipping_order_id}/shipping-address",
+        {"shipping_address": shipping_address},
+    )
+
+
+def admin_update_shipping_order_cargo(shipping_order_id: str, cargo: dict[str, Any]) -> Any:
+    """PUT /admin/shipping_orders/{id}/cargo — cartons and/or gross_weight_kg."""
+    return put_json(f"/admin/shipping_orders/{shipping_order_id}/cargo", cargo)
+
+
+def admin_delete_shipping_order(shipping_order_id: str) -> Any:
+    """DELETE /admin/shipping_orders/{id}/delete — soft delete; unlinks its orders."""
+    return delete_json(f"/admin/shipping_orders/{shipping_order_id}/delete")
+
+
+def admin_add_shipping_option(shipping_order_id: str, option: dict[str, Any]) -> Any:
+    """POST /admin/shipping_orders/{id}/shipping-options — one freight quote."""
+    return post_json(
+        f"/admin/shipping_orders/{shipping_order_id}/shipping-options",
+        {"shipping_option": option},
+    )
+
+
+def admin_remove_shipping_option(shipping_order_id: str, shipping_option_id: str) -> Any:
+    """DELETE /admin/shipping_orders/{id}/shipping-options/{option_id}/remove"""
+    return delete_json(
+        f"/admin/shipping_orders/{shipping_order_id}/shipping-options/{shipping_option_id}/remove"
+    )
+
+
+def admin_add_shipping_order_fee(shipping_order_id: str, fee: dict[str, Any]) -> Any:
+    """POST /admin/shipping_orders/{id}/fees/add"""
+    return post_json(f"/admin/shipping_orders/{shipping_order_id}/fees/add", fee)
+
+
+def admin_remove_shipping_order_fee(shipping_order_id: str, fee_id: str) -> Any:
+    """DELETE /admin/shipping_orders/{id}/fees/{fee_id}/remove"""
+    return delete_json(f"/admin/shipping_orders/{shipping_order_id}/fees/{fee_id}/remove")
+
+
+def admin_unlink_from_shipping_order(
+    shipping_order_id: str,
+    *,
+    production_order_id: str | None = None,
+    sampling_order_id: str | None = None,
+) -> Any:
+    """POST /admin/{production|sampling}_orders/{id}/unlink_from_shipping_order/{shipping_order_id}"""
+    if production_order_id:
+        path = f"/admin/production_orders/{production_order_id}"
+    else:
+        path = f"/admin/sampling_orders/{sampling_order_id}"
+    return post_json(f"{path}/unlink_from_shipping_order/{shipping_order_id}", {})
+
+
 def get_misc_payments_by_product(product_id: str) -> Any:
     """GET /admin/products/{product_id}/misc-payments — misc payments for one product."""
     return get_json(f"/admin/products/{product_id}/misc-payments")
@@ -1098,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-0.2.16 → makea_cli-0.2.18}/makea_cli/commands/__init__.py

@@ -16,6 +16,7 @@ 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.shipping.cmd import register as register_shipping
 from makea_cli.commands.supplier.cmd import register as register_supplier
 
 
@@ -27,6 +28,7 @@ def register_all(app: typer.Typer) -> None:
     register_orders(app)
     register_product(app)
     register_production(app)
+    register_shipping(app)
     register_designer(app)
     register_metrics(app)
     register_analytics(app)

{makea_cli-0.2.16 → makea_cli-0.2.18}/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",