makea-cli 0.2.19__tar.gz → 0.2.21__tar.gz

{makea_cli-0.2.19 → makea_cli-0.2.21}/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 0.2.21
+
+New: the Makea team's task queue. Needs the backend from the same day
+(`/admin/tasks`).
+
+- `admin list task [--kind …] [--user …] [--product …]`: open Makea tasks by
+  kind: `unknown` (a lesson Beeboo held because nobody said why), `once` (read
+  as one order's problem), `note` (a slip of Makea's or the platform's),
+  `sample_price`, `pp_sample`, `brand_ask`; with `--user`, that account's own
+  cards the team may settle (`setting`).
+- `admin get task <id>`: one task with what settles it, and for a held lesson
+  the finding behind it.
+- `admin update task <id> --done | --dismiss --note …`: close it. On a held
+  lesson, `--reason … [--caused-by …] [--recurs | --once]` records what the
+  team found out, and Beeboo's next reading of the chats uses it. A task
+  marked done stays closed when the nightly reading raises the same fact.
+- `admin update user --billing-currency GBP`: the account's billing currency;
+  closes a "Set your billing currency" card.
+
+## 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`:

{makea_cli-0.2.19 → makea_cli-0.2.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.19
+Version: 0.2.21
 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,10 +119,11 @@ 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` |
+| `makea-cli admin get task` | read | `GET /admin/tasks/{task_id}` | one Makea task in full: body, admin link, what settles it, and for a held lesson the finding Beeboo kept. | — |
 | `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` |
 | `makea-cli admin get top-features` | read | `POST /admin/analytics/query` | a quick map of which features get used most. | `analytics-top-features` |
@@ -129,23 +133,27 @@ 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` |
 | `makea-cli admin list supplier-link` | read | `GET /admin/product/linked_suppliers/by_supplier/{supplier_id}` | direct backend query. | `get-supplier-links-by-supplier-id` |
+| `makea-cli admin list task` | read | `GET /admin/tasks` | the Makea team's open tasks (Beeboo's notes, held lessons, sample price flags, PP samples, brand asks) by kind; `--user` adds that account's own `account.*` cards. | — |
 | `makea-cli admin list user` | read | `GET /admin/users` | list registered users (admin, optional pagination). | `list-users` |
 | `makea-cli admin send email` | write（ask） | `POST /admin/email/send` | queue an HTML email (To required, Cc optional). From must be @makea.co; HTML from --html-file or stdin ('-'). Require… | `send-email` |
 | `makea-cli admin set pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Set a production order's pricing groups from a JSON file, copy them from the order's quote, or clear them (--clear) t… | `production-groups-set` |
 | `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, mode or end date (--valid-until). --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 task` | write（ask） | `POST /admin/tasks/{task_id}/{done\|dismiss}` | close a Makea task with a note: `--done` once handled (a held lesson's `--reason` goes to Beeboo's next reading), or `--dismiss`. | — |
 | `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 admin update user` | write（ask） | `PUT /admin/user-profiles/{user_id}/update` | admin updates DynamoDB user profile fields and/or Cognito custom:userType. Allowed --user-type values: "Fashion brand… | `update-user-profile` |

{makea_cli-0.2.19 → makea_cli-0.2.21}/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,10 +107,11 @@ 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` |
+| `makea-cli admin get task` | read | `GET /admin/tasks/{task_id}` | one Makea task in full: body, admin link, what settles it, and for a held lesson the finding Beeboo kept. | — |
 | `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` |
 | `makea-cli admin get top-features` | read | `POST /admin/analytics/query` | a quick map of which features get used most. | `analytics-top-features` |
@@ -117,23 +121,27 @@ 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` |
 | `makea-cli admin list supplier-link` | read | `GET /admin/product/linked_suppliers/by_supplier/{supplier_id}` | direct backend query. | `get-supplier-links-by-supplier-id` |
+| `makea-cli admin list task` | read | `GET /admin/tasks` | the Makea team's open tasks (Beeboo's notes, held lessons, sample price flags, PP samples, brand asks) by kind; `--user` adds that account's own `account.*` cards. | — |
 | `makea-cli admin list user` | read | `GET /admin/users` | list registered users (admin, optional pagination). | `list-users` |
 | `makea-cli admin send email` | write（ask） | `POST /admin/email/send` | queue an HTML email (To required, Cc optional). From must be @makea.co; HTML from --html-file or stdin ('-'). Require… | `send-email` |
 | `makea-cli admin set pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Set a production order's pricing groups from a JSON file, copy them from the order's quote, or clear them (--clear) t… | `production-groups-set` |
 | `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, mode or end date (--valid-until). --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 task` | write（ask） | `POST /admin/tasks/{task_id}/{done\|dismiss}` | close a Makea task with a note: `--done` once handled (a held lesson's `--reason` goes to Beeboo's next reading), or `--dismiss`. | — |
 | `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 admin update user` | write（ask） | `PUT /admin/user-profiles/{user_id}/update` | admin updates DynamoDB user profile fields and/or Cognito custom:userType. Allowed --user-type values: "Fashion brand… | `update-user-profile` |

makea_cli-0.2.21/makea_cli/__init__.py

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

{makea_cli-0.2.19 → makea_cli-0.2.21}/makea_cli/api_client.py

@@ -1136,49 +1136,130 @@ 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: the Makea team's task queue -------------------------------------------
+
+
+def admin_list_tasks(
+    *,
+    kind: str | None = None,
+    type_: str | None = None,
+    user: str | None = None,
+    product: str | None = None,
+) -> Any:
+    """GET /admin/tasks — the team's open tasks; filters are comma-separated."""
+    params = {
+        k: v
+        for k, v in (("kind", kind), ("type", type_), ("user", user), ("product", product))
+        if v
+    }
+    return get_json("/admin/tasks", params=params or None)
+
+
+def admin_get_task(task_id: str) -> Any:
+    """GET /admin/tasks/{task_id} — one task, with Beeboo's finding behind it."""
+    return get_json(f"/admin/tasks/{quote(task_id, safe='')}")
+
+
+def admin_close_task(task_id: str, verb: str, body: dict[str, Any]) -> Any:
+    """POST /admin/tasks/{task_id}/{done|dismiss} — {note, reason?, caused_by?, recurs?}."""
+    return post_json(f"/admin/tasks/{quote(task_id, safe='')}/{verb}", body)
+
+
+# --- 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.19 → makea_cli-0.2.21}/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
@@ -18,6 +19,7 @@ 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
+from makea_cli.commands.tasks.cmd import register as register_tasks
 
 
 def register_all(app: typer.Typer) -> None:
@@ -37,3 +39,5 @@ def register_all(app: typer.Typer) -> None:
     register_factory(app)
     register_brand(app)
     register_playbook(app)
+    register_about(app)
+    register_tasks(app)