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

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

@@ -1,5 +1,33 @@
 # Changelog
 
+## 0.2.20
+
+New: rules for a factory and for the whole platform, and an account's About
+you. Needs the backend from 7c6460f8.
+
+- `admin list / get / create / update / delete rule` take one target:
+  `--user` as before, `--supplier <supplier_id>` for one factory's playbook
+  (no user needed), or `--global` for the platform-wide playbook every
+  account's AI reads (at most 30 live rules; an add or a restore past that is
+  refused). Same rules everywhere: a reason on every write, the duplicate and
+  conflict check, evidence and audit. `--scope` only applies with `--user`.
+- `admin get about --user | --supplier`: an account's Knowledge > About you
+  (a supplier account's person gets their factory's page). Does not recount.
+- `admin update about <key> --text … --reason …` adds or rewords a line, which
+  then stands as the account's own words; `--restore` brings a removed one
+  back. `admin delete about <key>` removes one (not guessed again).
+  `admin update about-pause [--resume]` stops or restarts Beeboo using it.
+- `admin generate about [--read [--force]]`: recount now instead of at the
+  nightly pass; `--read` also reads the conversations (one model call).
+
+## 0.2.19
+
+- `admin create rule` and `admin update rule` take `--valid-until YYYY-MM-DD`:
+  the day the rule ends (a closure, a temporary arrangement). From the day
+  after, it is in no prompt and does nothing; `playbook-preview` lists it as
+  "Ended". `--valid-until none` on update removes the end date. Needs the
+  backend from 3c1dc4e4.
+
 ## 0.2.18
 
 New: see why a playbook rule did not reach Beeboo, and what a rule said

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.18
+Version: 0.2.20
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -92,21 +92,24 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin backfill supplier-id` | write（never） | `POST /admin/supplier/backfill_supplier_id_with_quote_requests` | Migrate supplier_id from a wrong UUID to the Cognito user sub (user_id): profile + Cognito supplierReferenceId, optio… | `backfill-supplier-id` |
 | `makea-cli admin create library-element` | write（auto） | `POST /admin/designer/{user_id}/library_components` | save a reusable component under a designer. Provide --section and --values (see admin get library-schema). | `library-create` |
 | `makea-cli admin create quote-request` | write（ask） | `POST /admin/supplier/create_quote_request` | create/send a quote request to a supplier for a product (admin). | `create-quote-request` |
-| `makea-cli admin create rule` | write（ask） | `POST /admin/playbook/users/{user}/rules` | add a rule to one person's AI playbook (user_id or email); admin-authored, active unless --status. Refuses a repeat or a conflict unless --force. --reason required. | — |
+| `makea-cli admin create rule` | write（ask） | `POST /admin/playbook/{target}/rules` | add a rule to a person's (`--user`, user_id or email), a factory's (`--supplier`) or the platform-wide (`--global`, max 30 live) AI playbook; admin-authored, active unless --status. Refuses a repeat or a conflict unless --force. --reason required. | — |
 | `makea-cli admin create shipping-fee` | write（ask） | `POST /admin/shipping_orders/{shipping_order_id}/fees/add` | add a fee (fixed amount or percentage) on top of the freight. | — |
 | `makea-cli admin create shipping-option` | write（ask） | `POST /admin/shipping_orders/{shipping_order_id}/shipping-options` | add one freight quote (provider, speed, price, currency). | — |
 | `makea-cli admin create shipping-order` | write（ask） | `POST /admin/shipping_orders/create` | make a shipment for a brand's production and/or sampling orders. The shipment belongs to the orders' owner; you are r… | — |
 | `makea-cli admin create supplier` | write（ask） | `POST /admin/supplier/add_supplier` | create supplier from JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the field taxonomy (… | `add-supplier` |
 | `makea-cli admin create user` | write（never） | `POST /admin/users/create` | register a user and confirm the Cognito account in one step (no verification email). Allowed --user-type values: "Fas… | `create-user` |
+| `makea-cli admin delete about` | write（ask） | `DELETE /admin/about/{target}/{key}` | remove one About you line (`--user` / `--supplier`); it is not guessed again. --reason required. | — |
 | `makea-cli admin delete library-element` | write（never） | `DELETE /admin/designer/{user_id}/library_components/{component_id}` | remove a component from the designer's org library. | `library-delete` |
-| `makea-cli admin delete rule` | write（ask） | `DELETE /admin/playbook/users/{user}/rules/{rule_id}` | remove a rule: archived, with who and why kept on it (`update rule --status active` restores it). --reason required. | — |
+| `makea-cli admin delete rule` | write（ask） | `DELETE /admin/playbook/{target}/rules/{rule_id}` | remove a rule (`--user` / `--supplier` / `--global`): archived, with who and why kept on it (`update rule --status active` restores it). --reason required. | — |
 | `makea-cli admin delete shipping-fee` | write（ask） | `DELETE /admin/shipping_orders/{shipping_order_id}/fees/{fee_id}/remove` | remove one fee. | — |
 | `makea-cli admin delete shipping-option` | write（ask） | `DELETE /admin/shipping_orders/{shipping_order_id}/shipping-options/{shipping_option_id}/remove` | withdraw one freight quote. | — |
 | `makea-cli admin delete shipping-order` | write（never） | `DELETE /admin/shipping_orders/{shipping_order_id}/delete` | remove a shipment and free its orders. Graded `never`: the backend does not check status, so it removes a paid or in-transit shipment too. | — |
 | `makea-cli admin delete shipping-order-item` | write（ask） | `POST /admin/production_orders/{id}/unlink_from_shipping_order/{shipping_order_id}` | take one production or sampling order off a shipment. A shipment left empty is deleted. | — |
 | `makea-cli admin download document` | read | `GET /admin/document/download` | save a document file (document id + designer user_id). | `download-document` |
 | `makea-cli admin download product-document` | read | `GET /admin/document/download` | Resolve product via admin list product-order payload, then GET /admin/document/download. | `download-product-document` |
+| `makea-cli admin generate about` | write（auto） | `POST /admin/about/{target}/refresh` | recount an account's About you now; `--read` also reads its conversations (one model call). | — |
 | `makea-cli admin generate pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Lay a production order's variants into pricing groups along one axis (--by style \| colour \| variant \| all) with th… | `production-groups-generate` |
+| `makea-cli admin get about` | read | `GET /admin/about/{target}` | one account's About you (`--user`: a supplier account's person gets their factory's page; `--supplier`): facts, removed, unknown, paused, topic keys. | — |
 | `makea-cli admin get active-users` | read | `POST /admin/analytics/query` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
 | `makea-cli admin get analytics-query` | read | `POST /admin/analytics/query` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
 | `makea-cli admin get currency-conversion` | read | `GET /admin/fx/rates` | the platform's own exchange rates and rounding (rate table for several --from; one --from with --amount converts it). | `convert-currency` |
@@ -116,7 +119,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get production-pricing` | read | `GET /admin/production_orders/{id}/details` | show a production order's price tiers, MOQ, sizes/colours, pricing groups and cart coverage. | `production-pricing-show` |
 | `makea-cli admin get quote-request` | read | `GET /admin/quote_requests/{quote_request_id}` | one quote request in full. | — |
 | `makea-cli admin get revenue-metrics` | read | `GET /admin/business-metrics/cumulative-payment-and-platform-revenue` | platform-wide payment received and platform revenue (service fee + transaction fee) bucketed over a date range. | `get-cumulative-payment-and-platform-revenue` |
-| `makea-cli admin get rule` | read | `GET /admin/playbook/users/{user}/rules/{rule_id}` | one rule in full, with its evidence: where it came from, who changed it and why. | — |
+| `makea-cli admin get rule` | read | `GET /admin/playbook/{target}/rules/{rule_id}` | one rule in full (`--user` / `--supplier` / `--global`), with its evidence: where it came from, who changed it and why. | — |
 | `makea-cli admin get rule-history` | read | `GET /admin/playbook/rules/{rule_id}/history` | every revision of one rule: its words, who changed it and why, and the rule that replaced it. | — |
 | `makea-cli admin get shipping-order` | read | `GET /admin/shipping_orders/{shipping_order_id}/details` | one shipment with its production and sampling orders, freight quotes, fees, tracking and address. | — |
 | `makea-cli admin get supplier-profile-schema` | read | `GET /admin/supplier/profile/schema` | supplier profile v2 schema (section/field taxonomy: sections, fields, options, required rules). | `get-supplier-profile-schema` |
@@ -129,7 +132,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin list production-order` | read | `GET /admin/production_orders?type=PRODUCTION` | 大货 (production) orders only. For restock use admin list restock-order; for shipping use admin list shipping-order. | `list-all-production-orders` |
 | `makea-cli admin list quote-request` | read | `GET /admin/quote_requests` | quote requests, optionally for one product (--product) or one supplier (--supplier, GET /admin/quote_requests/supplie… | — |
 | `makea-cli admin list restock-order` | read | `GET /admin/production_orders?type=RESTOCK` | restock orders only. Restock shares the production_orders table; this filters to type=RESTOCK. | `list-all-restock-orders` |
-| `makea-cli admin list rule` | read | `GET /admin/playbook/users/{user}/rules` | every AI playbook rule that holds for one person (team, own account, factory): status, scope, text, which products, effect, source. Archived ones only with --all. | — |
+| `makea-cli admin list rule` | read | `GET /admin/playbook/{target}/rules` | every AI playbook rule for one person (team, own account, factory), one factory (`--supplier`) or the platform (`--global`): status, scope, text, which products, effect, source. Archived ones only with --all. | — |
 | `makea-cli admin list sampling-order` | read | `GET /admin/sampling_orders/get_all` | paginated list of all sampling orders (admin). | `list-all-sampling-orders` |
 | `makea-cli admin list shipping-order` | read | `GET /admin/shipping_orders` | paginated list of all shipping orders (admin). | `list-all-shipping-orders` |
 | `makea-cli admin list supplier` | read | `GET /admin/supplier/get_all_suppliers` | list all suppliers (admin). | `list-suppliers` |
@@ -140,10 +143,12 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin set production-tiers` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Set the order-wide price tiers / MOQ / incoterm / currency on a production order (the schedule used when it has no pr… | `production-tiers-set` |
 | `makea-cli admin set production-variants` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Set a production order's available sizes and colours (the grid the buyer's cart and every pricing group's cart keys a… | `production-variants-set` |
 | `makea-cli admin submit quote` | write（ask） | `POST /admin/quote_requests/{quote_request_id}/submit_quote` | admin submits a new quote (link) to a quote request. Pricing groups cannot be sent here (the submit endpoint ignores … | `submit-supplier-quote` |
+| `makea-cli admin update about` | write（ask） | `PATCH /admin/about/{target}/{key}` | add or reword one About you line (stands as the account's own words); `--restore` brings a removed one back. --reason required. | — |
+| `makea-cli admin update about-pause` | write（ask） | `POST /admin/about/{target}/pause` | stop (or `--resume`) Beeboo using an account's About you. --reason required. | — |
 | `makea-cli admin update library-element` | write（auto） | `PATCH /admin/designer/{user_id}/library_components/{component_id}` | update a component's name and/or values (empty value clears a field). | `library-update` |
 | `makea-cli admin update quote` | write（ask） | `POST /admin/product/edit_supplier_link_override_info` | admin updates an existing quote (supplier link) in place. Only the options you pass are sent, and the backend leaves … | `update-supplier-quote` |
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
-| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/users/{user}/rules/{rule_id}` | change a rule's text, status, applies_to, when or mode. --reason required; the rule keeps what it was before. | — |
+| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/{target}/rules/{rule_id}` | change a rule's text, status, applies_to, when, mode or end date (--valid-until), on `--user` / `--supplier` / `--global`. --reason required; the rule keeps what it was before. | — |
 | `makea-cli admin update shipping-order` | write（ask） | `PUT /admin/shipping_orders/{shipping_order_id}/status` | Change a shipment: --status (PUT .../status), tracking flags (POST .../tracking), --address (PUT .../shipping-address… | — |
 | `makea-cli admin update supplier` | write（ask） | `PUT /admin/supplier/update_supplier` | update an existing supplier from a JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the fi… | `update-supplier` |
 | `makea-cli admin update tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |

{makea_cli-0.2.18 → makea_cli-0.2.20}/README.md

@@ -80,21 +80,24 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin backfill supplier-id` | write（never） | `POST /admin/supplier/backfill_supplier_id_with_quote_requests` | Migrate supplier_id from a wrong UUID to the Cognito user sub (user_id): profile + Cognito supplierReferenceId, optio… | `backfill-supplier-id` |
 | `makea-cli admin create library-element` | write（auto） | `POST /admin/designer/{user_id}/library_components` | save a reusable component under a designer. Provide --section and --values (see admin get library-schema). | `library-create` |
 | `makea-cli admin create quote-request` | write（ask） | `POST /admin/supplier/create_quote_request` | create/send a quote request to a supplier for a product (admin). | `create-quote-request` |
-| `makea-cli admin create rule` | write（ask） | `POST /admin/playbook/users/{user}/rules` | add a rule to one person's AI playbook (user_id or email); admin-authored, active unless --status. Refuses a repeat or a conflict unless --force. --reason required. | — |
+| `makea-cli admin create rule` | write（ask） | `POST /admin/playbook/{target}/rules` | add a rule to a person's (`--user`, user_id or email), a factory's (`--supplier`) or the platform-wide (`--global`, max 30 live) AI playbook; admin-authored, active unless --status. Refuses a repeat or a conflict unless --force. --reason required. | — |
 | `makea-cli admin create shipping-fee` | write（ask） | `POST /admin/shipping_orders/{shipping_order_id}/fees/add` | add a fee (fixed amount or percentage) on top of the freight. | — |
 | `makea-cli admin create shipping-option` | write（ask） | `POST /admin/shipping_orders/{shipping_order_id}/shipping-options` | add one freight quote (provider, speed, price, currency). | — |
 | `makea-cli admin create shipping-order` | write（ask） | `POST /admin/shipping_orders/create` | make a shipment for a brand's production and/or sampling orders. The shipment belongs to the orders' owner; you are r… | — |
 | `makea-cli admin create supplier` | write（ask） | `POST /admin/supplier/add_supplier` | create supplier from JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the field taxonomy (… | `add-supplier` |
 | `makea-cli admin create user` | write（never） | `POST /admin/users/create` | register a user and confirm the Cognito account in one step (no verification email). Allowed --user-type values: "Fas… | `create-user` |
+| `makea-cli admin delete about` | write（ask） | `DELETE /admin/about/{target}/{key}` | remove one About you line (`--user` / `--supplier`); it is not guessed again. --reason required. | — |
 | `makea-cli admin delete library-element` | write（never） | `DELETE /admin/designer/{user_id}/library_components/{component_id}` | remove a component from the designer's org library. | `library-delete` |
-| `makea-cli admin delete rule` | write（ask） | `DELETE /admin/playbook/users/{user}/rules/{rule_id}` | remove a rule: archived, with who and why kept on it (`update rule --status active` restores it). --reason required. | — |
+| `makea-cli admin delete rule` | write（ask） | `DELETE /admin/playbook/{target}/rules/{rule_id}` | remove a rule (`--user` / `--supplier` / `--global`): archived, with who and why kept on it (`update rule --status active` restores it). --reason required. | — |
 | `makea-cli admin delete shipping-fee` | write（ask） | `DELETE /admin/shipping_orders/{shipping_order_id}/fees/{fee_id}/remove` | remove one fee. | — |
 | `makea-cli admin delete shipping-option` | write（ask） | `DELETE /admin/shipping_orders/{shipping_order_id}/shipping-options/{shipping_option_id}/remove` | withdraw one freight quote. | — |
 | `makea-cli admin delete shipping-order` | write（never） | `DELETE /admin/shipping_orders/{shipping_order_id}/delete` | remove a shipment and free its orders. Graded `never`: the backend does not check status, so it removes a paid or in-transit shipment too. | — |
 | `makea-cli admin delete shipping-order-item` | write（ask） | `POST /admin/production_orders/{id}/unlink_from_shipping_order/{shipping_order_id}` | take one production or sampling order off a shipment. A shipment left empty is deleted. | — |
 | `makea-cli admin download document` | read | `GET /admin/document/download` | save a document file (document id + designer user_id). | `download-document` |
 | `makea-cli admin download product-document` | read | `GET /admin/document/download` | Resolve product via admin list product-order payload, then GET /admin/document/download. | `download-product-document` |
+| `makea-cli admin generate about` | write（auto） | `POST /admin/about/{target}/refresh` | recount an account's About you now; `--read` also reads its conversations (one model call). | — |
 | `makea-cli admin generate pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Lay a production order's variants into pricing groups along one axis (--by style \| colour \| variant \| all) with th… | `production-groups-generate` |
+| `makea-cli admin get about` | read | `GET /admin/about/{target}` | one account's About you (`--user`: a supplier account's person gets their factory's page; `--supplier`): facts, removed, unknown, paused, topic keys. | — |
 | `makea-cli admin get active-users` | read | `POST /admin/analytics/query` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
 | `makea-cli admin get analytics-query` | read | `POST /admin/analytics/query` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
 | `makea-cli admin get currency-conversion` | read | `GET /admin/fx/rates` | the platform's own exchange rates and rounding (rate table for several --from; one --from with --amount converts it). | `convert-currency` |
@@ -104,7 +107,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get production-pricing` | read | `GET /admin/production_orders/{id}/details` | show a production order's price tiers, MOQ, sizes/colours, pricing groups and cart coverage. | `production-pricing-show` |
 | `makea-cli admin get quote-request` | read | `GET /admin/quote_requests/{quote_request_id}` | one quote request in full. | — |
 | `makea-cli admin get revenue-metrics` | read | `GET /admin/business-metrics/cumulative-payment-and-platform-revenue` | platform-wide payment received and platform revenue (service fee + transaction fee) bucketed over a date range. | `get-cumulative-payment-and-platform-revenue` |
-| `makea-cli admin get rule` | read | `GET /admin/playbook/users/{user}/rules/{rule_id}` | one rule in full, with its evidence: where it came from, who changed it and why. | — |
+| `makea-cli admin get rule` | read | `GET /admin/playbook/{target}/rules/{rule_id}` | one rule in full (`--user` / `--supplier` / `--global`), with its evidence: where it came from, who changed it and why. | — |
 | `makea-cli admin get rule-history` | read | `GET /admin/playbook/rules/{rule_id}/history` | every revision of one rule: its words, who changed it and why, and the rule that replaced it. | — |
 | `makea-cli admin get shipping-order` | read | `GET /admin/shipping_orders/{shipping_order_id}/details` | one shipment with its production and sampling orders, freight quotes, fees, tracking and address. | — |
 | `makea-cli admin get supplier-profile-schema` | read | `GET /admin/supplier/profile/schema` | supplier profile v2 schema (section/field taxonomy: sections, fields, options, required rules). | `get-supplier-profile-schema` |
@@ -117,7 +120,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin list production-order` | read | `GET /admin/production_orders?type=PRODUCTION` | 大货 (production) orders only. For restock use admin list restock-order; for shipping use admin list shipping-order. | `list-all-production-orders` |
 | `makea-cli admin list quote-request` | read | `GET /admin/quote_requests` | quote requests, optionally for one product (--product) or one supplier (--supplier, GET /admin/quote_requests/supplie… | — |
 | `makea-cli admin list restock-order` | read | `GET /admin/production_orders?type=RESTOCK` | restock orders only. Restock shares the production_orders table; this filters to type=RESTOCK. | `list-all-restock-orders` |
-| `makea-cli admin list rule` | read | `GET /admin/playbook/users/{user}/rules` | every AI playbook rule that holds for one person (team, own account, factory): status, scope, text, which products, effect, source. Archived ones only with --all. | — |
+| `makea-cli admin list rule` | read | `GET /admin/playbook/{target}/rules` | every AI playbook rule for one person (team, own account, factory), one factory (`--supplier`) or the platform (`--global`): status, scope, text, which products, effect, source. Archived ones only with --all. | — |
 | `makea-cli admin list sampling-order` | read | `GET /admin/sampling_orders/get_all` | paginated list of all sampling orders (admin). | `list-all-sampling-orders` |
 | `makea-cli admin list shipping-order` | read | `GET /admin/shipping_orders` | paginated list of all shipping orders (admin). | `list-all-shipping-orders` |
 | `makea-cli admin list supplier` | read | `GET /admin/supplier/get_all_suppliers` | list all suppliers (admin). | `list-suppliers` |
@@ -128,10 +131,12 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin set production-tiers` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Set the order-wide price tiers / MOQ / incoterm / currency on a production order (the schedule used when it has no pr… | `production-tiers-set` |
 | `makea-cli admin set production-variants` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Set a production order's available sizes and colours (the grid the buyer's cart and every pricing group's cart keys a… | `production-variants-set` |
 | `makea-cli admin submit quote` | write（ask） | `POST /admin/quote_requests/{quote_request_id}/submit_quote` | admin submits a new quote (link) to a quote request. Pricing groups cannot be sent here (the submit endpoint ignores … | `submit-supplier-quote` |
+| `makea-cli admin update about` | write（ask） | `PATCH /admin/about/{target}/{key}` | add or reword one About you line (stands as the account's own words); `--restore` brings a removed one back. --reason required. | — |
+| `makea-cli admin update about-pause` | write（ask） | `POST /admin/about/{target}/pause` | stop (or `--resume`) Beeboo using an account's About you. --reason required. | — |
 | `makea-cli admin update library-element` | write（auto） | `PATCH /admin/designer/{user_id}/library_components/{component_id}` | update a component's name and/or values (empty value clears a field). | `library-update` |
 | `makea-cli admin update quote` | write（ask） | `POST /admin/product/edit_supplier_link_override_info` | admin updates an existing quote (supplier link) in place. Only the options you pass are sent, and the backend leaves … | `update-supplier-quote` |
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
-| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/users/{user}/rules/{rule_id}` | change a rule's text, status, applies_to, when or mode. --reason required; the rule keeps what it was before. | — |
+| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/{target}/rules/{rule_id}` | change a rule's text, status, applies_to, when, mode or end date (--valid-until), on `--user` / `--supplier` / `--global`. --reason required; the rule keeps what it was before. | — |
 | `makea-cli admin update shipping-order` | write（ask） | `PUT /admin/shipping_orders/{shipping_order_id}/status` | Change a shipment: --status (PUT .../status), tracking flags (POST .../tracking), --address (PUT .../shipping-address… | — |
 | `makea-cli admin update supplier` | write（ask） | `PUT /admin/supplier/update_supplier` | update an existing supplier from a JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the fi… | `update-supplier` |
 | `makea-cli admin update tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |

makea_cli-0.2.20/makea_cli/__init__.py

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

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

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

{makea_cli-0.2.18 → makea_cli-0.2.20}/makea_cli/commands/__init__.py

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

makea_cli-0.2.20/makea_cli/commands/about/cmd.py

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