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

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

@@ -1,5 +1,50 @@
 # Changelog
 
+## 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
+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.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.15
+Version: 0.2.17
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -92,9 +92,18 @@ 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 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` |
@@ -106,6 +115,8 @@ 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 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` |
@@ -116,6 +127,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 +141,8 @@ 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 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.15 → makea_cli-0.2.17}/README.md

@@ -80,9 +80,18 @@ 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 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` |
@@ -94,6 +103,8 @@ 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 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` |
@@ -104,6 +115,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 +129,8 @@ 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 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.17/makea_cli/__init__.py

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

{makea_cli-0.2.15 → makea_cli-0.2.17}/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:
@@ -760,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")
@@ -1047,6 +1136,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.17}/makea_cli/commands/__init__.py

@@ -13,8 +13,10 @@ 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.shipping.cmd import register as register_shipping
 from makea_cli.commands.supplier.cmd import register as register_supplier
 
 
@@ -26,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)
@@ -33,3 +36,4 @@ def register_all(app: typer.Typer) -> None:
     register_library(app)
     register_factory(app)
     register_brand(app)
+    register_playbook(app)