makea-cli 0.2.25__tar.gz → 0.2.26__tar.gz

{makea_cli-0.2.25 → makea_cli-0.2.26}/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## 0.2.26
+
+The admin page is now the CLI's companion. Every `makea-cli admin …` result
+carries `admin_url`, the admin page's link to the record (`--open` opens it in
+the browser). After a successful command the CLI tells the admin tabs you have
+open: they refresh and, with Follow on, open the record. Dry runs and failed
+commands send nothing; `MAKEA_COMPANION=off` turns it off; `MAKEA_APP_URL`
+points the links at another frontend. Works the same from Claude Code, Codex or
+a shell; the page shows which one ran each command.
+
+New: what Makea staff do by hand on the admin page, from the terminal. Every
+endpoint is already live; nothing here moves money.
+
+- Reads: `admin get production-order`, `admin get supplier`, `admin get user`,
+  `admin get product-status` (stage · step · owner per supplier),
+  `admin get product-step --supplier` (the steps a factory can be moved to),
+  `admin list product-note`, `admin list feature-flag`.
+- `admin update sampling-order / production-order --status`: an order's status.
+  The paid statuses (PAID, DEPOSIT_PAID, FINAL_PAYMENT_PAID) are refused; a
+  payment records them.
+- `admin set sampling-order-tracking / production-order-tracking`: tracking
+  number, URL, method, carrier (production also cartons and gross weight). Only
+  the flags given are sent. A new tracking number marks the order shipped and
+  tells the brand.
+- `admin update product-step --supplier --stage --step [--note]
+  [--notify-brand] [--notify-supplier]`: Change step, for a move that happened
+  off the platform. The server refuses money steps.
+- `admin update product`: name, category, launch date, contact, size count,
+  grading, custom notes.
+- `admin update product-document --status APPROVED|REJECTED|UPLOADED`.
+- `admin create product-note --content [--internal]`: without `--internal` the
+  brand reads it and is emailed.
+- `admin create / delete supplier-link`: assign a factory to a product with no
+  price, or remove a link (`--link-id`, or `--supplier` for all of its links).
+  Removing a link that already has orders leaves them pointing at nothing.
+- `admin create quote-request-note --text [--requirements-updated]`: write to
+  the factory on a quote request.
+- `admin create / update / delete feature-flag`: add a flag, flip it, edit it,
+  add or remove one account (`--add-user` / `--remove-user`), remove it.
+
 ## 0.2.25
 
 New: `designer create proposal`, a tech-pack change as a card on the field it

{makea_cli-0.2.25 → makea_cli-0.2.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.25
+Version: 0.2.26
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -90,21 +90,27 @@ 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 feature-flag` | write（ask） | `POST /admin/feature-flags` | add a flag (off unless --enabled). An existing key is refused. | — |
 | `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 product-note` | write（ask） | `POST /admin/products/{product_id}/notes` | write a note on a product. Without --internal it goes to the brand. | — |
 | `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 quote-request-note` | write（ask） | `POST /admin/quote_requests/{quote_request_id}/reply_status_note` | write to the factory on a quote request (e.g. answer its clarification). --requirements-updated words the email as a change to the product's requirements. | — |
 | `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; --why / --proof are what the brand reads under it, --title its card name. | — |
 | `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 supplier-link` | write（ask） | `POST /admin/product/link_supplier` | assign a factory to a product, with no price. A bare assignment is not a quote: no quote email goes out and nothing is priced. To quote, use admin submit quote on the quote request. | — |
 | `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 feature-flag` | write（ask） | `DELETE /admin/feature-flags/{key}` | remove a flag. Every check of it then reads false, so delete it only once the code that reads it is gone. | — |
 | `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/{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 delete supplier-link` | write（ask） | `POST /admin/product/unlink_supplier` | remove a supplier link from a product. --link-id removes one link; --supplier removes every link that supplier has on the product. | — |
 | `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). | — |
@@ -117,19 +123,26 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get growth-snapshot` | read | `GET /admin/growth/snapshots/{id}` | one reconciled Growth Analysis snapshot (default `latest`); `--block` prints one block (headline, gates, review_items, …). | — |
 | `makea-cli admin get library-schema` | read | `GET /admin/library_components/schema` | the tech-pack library taxonomy: sections and their library-role field keys (run this before create/update). | `library-schema` |
 | `makea-cli admin get playbook-preview` | read | `GET /admin/playbook/preview` | the playbook block one AI surface would get for a person or factory, and every rule left out with its reason; --product previews a conversation about one product, --rule answers for one rule. | — |
+| `makea-cli admin get product-status` | read | `GET /admin/products/{product_id}/status` | where the product is: stage · step · owner for each supplier on it (the shared status model), plus the step catalog. | — |
+| `makea-cli admin get product-step` | read | `GET /admin/products/{product_id}/suppliers/{supplier_id}/change_step` | the step one factory is at on a product and the steps admin update product-step can move it to (options; money steps are listed but never selectable). | — |
+| `makea-cli admin get production-order` | read | `GET /admin/production_orders/{production_order_id}/details` | one production (or restock) order in full: items, status, progress steps, tracking, notes, documents and linked suppliers. For only its pricing use admin get production-pricing. | — |
 | `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 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` | read | `GET /admin/supplier/get_supplier_by_id` | one supplier's full profile (contact, capabilities, documents) plus its financial documents. | — |
 | `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` |
+| `makea-cli admin get user` | read | `GET /admin/user-profiles/{user_id}` | one account's profile (Cognito sub as id). | — |
+| `makea-cli admin list feature-flag` | read | `GET /admin/feature-flags` | every flag: global switch, default value, and the accounts it is on for (id, email, name). | — |
 | `makea-cli admin list library-element` | read | `GET /admin/designer/{user_id}/library_components` | list a designer's tech-pack library (org-fanned). Optional --section scopes to one type. | `library-list` |
 | `makea-cli admin list growth-snapshot` | read | `GET /admin/growth/snapshots` | published Growth Analysis snapshots, newest first (the change log). | — |
 | `makea-cli admin list misc-payment` | read | `GET /admin/products/{id}/misc-payments` | misc payments for one product (admin). | `list-misc-payments-by-product` |
+| `makea-cli admin list product-note` | read | `GET /admin/products/{product_id}/notes` | the notes Makea wrote to the brand on a product. | — |
 | `makea-cli admin list product-order` | read | `GET /admin/designer/get_all_product_orders` | designer product (SKU) list. For 大货 use admin list production-order or admin list production-order --product. | `list-product-orders` |
 | `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… | — |
@@ -143,15 +156,23 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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-order-tracking` | write（ask） | `POST /admin/production_orders/{production_order_id}/tracking` | the bulk parcel: tracking number, URL, shipping method, carrier, plus cartons and gross weight off the packing list. Only what you pass is changed; an empty string clears a field. | — |
 | `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 set sampling-order-tracking` | write（ask） | `PUT /admin/sampling_orders/{sampling_order_id}/tracking` | the sample's parcel: tracking number, URL, shipping method, carrier. Only what you pass is changed; an empty string clears a field. | — |
 | `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 feature-flag` | write（ask） | `PATCH /admin/feature-flags/{key}` | flip the global switch, edit the description or default value, or add / remove one account on the allow-list (by user id; find it with admin list user). | — |
 | `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 product` | write（ask） | `PUT /admin/products/{product_id}/basic-info` | change a product's name, category, launch date, contact, size count, grading or custom notes. Only what you pass is changed. Shipping address, sampling sizes and colourways are not covered here. | — |
+| `makea-cli admin update product-document` | write（ask） | `POST /admin/designer/update_document_status` | review one of a product's documents: APPROVED, REJECTED, UPLOADED. | — |
+| `makea-cli admin update product-step` | write（ask） | `POST /admin/products/{product_id}/suppliers/{supplier_id}/change_step` | move a factory to a step when it happened off the platform. Before production any step can be picked, backwards too; PRODUCE, QC and SHIP only go forward, and a step behind an unpaid payment is refused. Run admin get product-step first for the options. | — |
+| `makea-cli admin update production-order` | write（ask） | `PUT /admin/production_orders/{production_order_id}/status` | move a production order to another status (DRAFT, IN_REVIEW, READY_FOR_PRODUCTION, PRODUCTION_IN_PROGRESS, PRODUCTION_COMPLETED, SHIPPED, DELIVERED, COMPLETED, CANCELLED). The paid statuses (PAID, DEPOSIT_PAID, FINAL_PAYMENT_PAID) are recorded by the payment and are refused here. | — |
 | `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/{target}/rules/{rule_id}` | change a rule's text, status, applies_to, when, mode or end date (--valid-until), the --why / --proof the brand reads, or its card --title, on `--user` / `--supplier` / `--global`. --reason required; the rule keeps what it was before. | — |
+| `makea-cli admin update sampling-order` | write（ask） | `PUT /admin/sampling_orders/{sampling_order_id}/status` | move a sampling order to another status (DRAFT, IN_PROGRESS, SAMPLING_COMPLETED, APPROVAL, SHIPPED, DELIVERED, CANCELLED). PAID is recorded by the payment and is refused here. Prefer admin update product-step, which moves the same statuses through the step model. | — |
 | `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-0.2.25 → makea_cli-0.2.26}/README.md

@@ -78,21 +78,27 @@ 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 feature-flag` | write（ask） | `POST /admin/feature-flags` | add a flag (off unless --enabled). An existing key is refused. | — |
 | `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 product-note` | write（ask） | `POST /admin/products/{product_id}/notes` | write a note on a product. Without --internal it goes to the brand. | — |
 | `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 quote-request-note` | write（ask） | `POST /admin/quote_requests/{quote_request_id}/reply_status_note` | write to the factory on a quote request (e.g. answer its clarification). --requirements-updated words the email as a change to the product's requirements. | — |
 | `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; --why / --proof are what the brand reads under it, --title its card name. | — |
 | `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 supplier-link` | write（ask） | `POST /admin/product/link_supplier` | assign a factory to a product, with no price. A bare assignment is not a quote: no quote email goes out and nothing is priced. To quote, use admin submit quote on the quote request. | — |
 | `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 feature-flag` | write（ask） | `DELETE /admin/feature-flags/{key}` | remove a flag. Every check of it then reads false, so delete it only once the code that reads it is gone. | — |
 | `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/{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 delete supplier-link` | write（ask） | `POST /admin/product/unlink_supplier` | remove a supplier link from a product. --link-id removes one link; --supplier removes every link that supplier has on the product. | — |
 | `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). | — |
@@ -105,19 +111,26 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get growth-snapshot` | read | `GET /admin/growth/snapshots/{id}` | one reconciled Growth Analysis snapshot (default `latest`); `--block` prints one block (headline, gates, review_items, …). | — |
 | `makea-cli admin get library-schema` | read | `GET /admin/library_components/schema` | the tech-pack library taxonomy: sections and their library-role field keys (run this before create/update). | `library-schema` |
 | `makea-cli admin get playbook-preview` | read | `GET /admin/playbook/preview` | the playbook block one AI surface would get for a person or factory, and every rule left out with its reason; --product previews a conversation about one product, --rule answers for one rule. | — |
+| `makea-cli admin get product-status` | read | `GET /admin/products/{product_id}/status` | where the product is: stage · step · owner for each supplier on it (the shared status model), plus the step catalog. | — |
+| `makea-cli admin get product-step` | read | `GET /admin/products/{product_id}/suppliers/{supplier_id}/change_step` | the step one factory is at on a product and the steps admin update product-step can move it to (options; money steps are listed but never selectable). | — |
+| `makea-cli admin get production-order` | read | `GET /admin/production_orders/{production_order_id}/details` | one production (or restock) order in full: items, status, progress steps, tracking, notes, documents and linked suppliers. For only its pricing use admin get production-pricing. | — |
 | `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 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` | read | `GET /admin/supplier/get_supplier_by_id` | one supplier's full profile (contact, capabilities, documents) plus its financial documents. | — |
 | `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` |
+| `makea-cli admin get user` | read | `GET /admin/user-profiles/{user_id}` | one account's profile (Cognito sub as id). | — |
+| `makea-cli admin list feature-flag` | read | `GET /admin/feature-flags` | every flag: global switch, default value, and the accounts it is on for (id, email, name). | — |
 | `makea-cli admin list library-element` | read | `GET /admin/designer/{user_id}/library_components` | list a designer's tech-pack library (org-fanned). Optional --section scopes to one type. | `library-list` |
 | `makea-cli admin list growth-snapshot` | read | `GET /admin/growth/snapshots` | published Growth Analysis snapshots, newest first (the change log). | — |
 | `makea-cli admin list misc-payment` | read | `GET /admin/products/{id}/misc-payments` | misc payments for one product (admin). | `list-misc-payments-by-product` |
+| `makea-cli admin list product-note` | read | `GET /admin/products/{product_id}/notes` | the notes Makea wrote to the brand on a product. | — |
 | `makea-cli admin list product-order` | read | `GET /admin/designer/get_all_product_orders` | designer product (SKU) list. For 大货 use admin list production-order or admin list production-order --product. | `list-product-orders` |
 | `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… | — |
@@ -131,15 +144,23 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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-order-tracking` | write（ask） | `POST /admin/production_orders/{production_order_id}/tracking` | the bulk parcel: tracking number, URL, shipping method, carrier, plus cartons and gross weight off the packing list. Only what you pass is changed; an empty string clears a field. | — |
 | `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 set sampling-order-tracking` | write（ask） | `PUT /admin/sampling_orders/{sampling_order_id}/tracking` | the sample's parcel: tracking number, URL, shipping method, carrier. Only what you pass is changed; an empty string clears a field. | — |
 | `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 feature-flag` | write（ask） | `PATCH /admin/feature-flags/{key}` | flip the global switch, edit the description or default value, or add / remove one account on the allow-list (by user id; find it with admin list user). | — |
 | `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 product` | write（ask） | `PUT /admin/products/{product_id}/basic-info` | change a product's name, category, launch date, contact, size count, grading or custom notes. Only what you pass is changed. Shipping address, sampling sizes and colourways are not covered here. | — |
+| `makea-cli admin update product-document` | write（ask） | `POST /admin/designer/update_document_status` | review one of a product's documents: APPROVED, REJECTED, UPLOADED. | — |
+| `makea-cli admin update product-step` | write（ask） | `POST /admin/products/{product_id}/suppliers/{supplier_id}/change_step` | move a factory to a step when it happened off the platform. Before production any step can be picked, backwards too; PRODUCE, QC and SHIP only go forward, and a step behind an unpaid payment is refused. Run admin get product-step first for the options. | — |
+| `makea-cli admin update production-order` | write（ask） | `PUT /admin/production_orders/{production_order_id}/status` | move a production order to another status (DRAFT, IN_REVIEW, READY_FOR_PRODUCTION, PRODUCTION_IN_PROGRESS, PRODUCTION_COMPLETED, SHIPPED, DELIVERED, COMPLETED, CANCELLED). The paid statuses (PAID, DEPOSIT_PAID, FINAL_PAYMENT_PAID) are recorded by the payment and are refused here. | — |
 | `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/{target}/rules/{rule_id}` | change a rule's text, status, applies_to, when, mode or end date (--valid-until), the --why / --proof the brand reads, or its card --title, on `--user` / `--supplier` / `--global`. --reason required; the rule keeps what it was before. | — |
+| `makea-cli admin update sampling-order` | write（ask） | `PUT /admin/sampling_orders/{sampling_order_id}/status` | move a sampling order to another status (DRAFT, IN_PROGRESS, SAMPLING_COMPLETED, APPROVAL, SHIPPED, DELIVERED, CANCELLED). PAID is recorded by the payment and is refused here. Prefer admin update product-step, which moves the same statuses through the step model. | — |
 | `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-0.2.26/makea_cli/__init__.py

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

{makea_cli-0.2.25 → makea_cli-0.2.26}/makea_cli/api_client.py

@@ -1282,6 +1282,131 @@ def admin_playbook_preview(
     return get_json("/admin/playbook/preview", params=params)
 
 
+# --- admin: what the admin page does by hand (orders, products, people, flags) -----
+# None of these move money: order statuses that record a payment are refused by
+# the commands, and change_step refuses money steps server-side.
+
+
+def admin_get_supplier(supplier_id: str) -> Any:
+    """GET /admin/supplier/get_supplier_by_id?supplier_id= — profile plus financial documents."""
+    return get_json("/admin/supplier/get_supplier_by_id", params={"supplier_id": supplier_id})
+
+
+def admin_get_user_profile(user_id: str) -> Any:
+    """GET /admin/user-profiles/{user_id}"""
+    return get_json(f"/admin/user-profiles/{quote(user_id, safe='')}")
+
+
+def admin_update_sampling_order_status(sampling_order_id: str, status: str) -> Any:
+    """PUT /admin/sampling_orders/{id}/status"""
+    return put_json(f"/admin/sampling_orders/{sampling_order_id}/status", {"status": status})
+
+
+def admin_update_production_order_status(production_order_id: str, status: str) -> Any:
+    """PUT /admin/production_orders/{id}/status"""
+    return put_json(f"/admin/production_orders/{production_order_id}/status", {"status": status})
+
+
+def admin_set_sampling_order_tracking(sampling_order_id: str, body: dict[str, Any]) -> Any:
+    """PUT /admin/sampling_orders/{id}/tracking — tracking_number / tracking_url /
+    shipping_method / carrier_id, flat in the body."""
+    return put_json(f"/admin/sampling_orders/{sampling_order_id}/tracking", body)
+
+
+def admin_set_production_order_tracking(production_order_id: str, body: dict[str, Any]) -> Any:
+    """POST /admin/production_orders/{id}/tracking — as sampling, plus cartons and
+    gross_weight_kg (absent = unchanged, empty string = cleared)."""
+    return post_json(f"/admin/production_orders/{production_order_id}/tracking", body)
+
+
+def admin_get_product_status(product_id: str) -> Any:
+    """GET /admin/products/{id}/status — the product's stage · step · owner per supplier,
+    with the step catalog."""
+    return get_json(f"/admin/products/{product_id}/status")
+
+
+def admin_get_change_step(product_id: str, supplier_id: str) -> Any:
+    """GET /admin/products/{id}/suppliers/{sid}/change_step — where the factory is
+    and which steps can be picked."""
+    return get_json(f"/admin/products/{product_id}/suppliers/{supplier_id}/change_step")
+
+
+def admin_change_step(product_id: str, supplier_id: str, body: dict[str, Any]) -> Any:
+    """POST /admin/products/{id}/suppliers/{sid}/change_step —
+    {stage, step, note?, notify_brand?, notify_supplier?}."""
+    return post_json(f"/admin/products/{product_id}/suppliers/{supplier_id}/change_step", body)
+
+
+def admin_list_product_notes(product_id: str) -> Any:
+    """GET /admin/products/{id}/notes — the product's customer notes."""
+    return get_json(f"/admin/products/{product_id}/notes")
+
+
+def admin_add_product_note(product_id: str, content: str, *, internal: bool) -> Any:
+    """POST /admin/products/{id}/notes — {content, is_internal}. The backend reads
+    ``is_internal``; a customer note (the default) is emailed to the brand."""
+    return post_json(
+        f"/admin/products/{product_id}/notes",
+        {"content": content, "is_internal": internal},
+    )
+
+
+def admin_update_product_basic_info(product_id: str, body: dict[str, Any]) -> Any:
+    """PUT /admin/products/{id}/basic-info — only the fields given are changed."""
+    return put_json(f"/admin/products/{product_id}/basic-info", body)
+
+
+def admin_update_product_document_status(product_id: str, document_id: str, status: str) -> Any:
+    """POST /admin/designer/update_document_status — {product_id, document_id, status}."""
+    return post_json(
+        "/admin/designer/update_document_status",
+        {"product_id": product_id, "document_id": document_id, "status": status},
+    )
+
+
+def admin_link_supplier(body: dict[str, Any]) -> Any:
+    """POST /admin/product/link_supplier — a bare assignment (no price, so not a quote)."""
+    return post_json("/admin/product/link_supplier", body)
+
+
+def admin_unlink_supplier(
+    product_id: str, *, link_id: str | None = None, supplier_id: str | None = None
+) -> Any:
+    """POST /admin/product/unlink_supplier?product_id=&link_id=|supplier_id= (query, no body)."""
+    params: dict[str, Any] = {"product_id": product_id}
+    if link_id:
+        params["link_id"] = link_id
+    if supplier_id:
+        params["supplier_id"] = supplier_id
+    return _request("POST", "/admin/product/unlink_supplier", params=params)
+
+
+def admin_reply_quote_request(quote_request_id: str, body: dict[str, Any]) -> Any:
+    """POST /admin/quote_requests/{id}/reply_status_note — {status_note, notification_kind}."""
+    return post_json(f"/admin/quote_requests/{quote_request_id}/reply_status_note", body)
+
+
+def admin_list_feature_flags() -> Any:
+    """GET /admin/feature-flags — every flag with its allow-list resolved."""
+    return get_json("/admin/feature-flags")
+
+
+def admin_create_feature_flag(body: dict[str, Any]) -> Any:
+    """POST /admin/feature-flags — {key, description?, enabled?, value?}."""
+    return post_json("/admin/feature-flags", body)
+
+
+def admin_update_feature_flag(key: str, body: dict[str, Any]) -> Any:
+    """PATCH /admin/feature-flags/{key} — enabled / description / value /
+    add_user_id / remove_user_id, one account at a time."""
+    return patch_json(f"/admin/feature-flags/{quote(key, safe='')}", body)
+
+
+def admin_delete_feature_flag(key: str) -> Any:
+    """DELETE /admin/feature-flags/{key} — every check of the flag then reads false."""
+    return delete_json(f"/admin/feature-flags/{quote(key, safe='')}")
+
+
 # --- supplier persona: a factory acting on its own RFQs, quotes and orders --------
 
 

{makea_cli-0.2.25 → makea_cli-0.2.26}/makea_cli/commands/__init__.py

@@ -11,6 +11,7 @@ from makea_cli.commands.directory.cmd import register as register_directory
 from makea_cli.commands.document.cmd import register as register_document
 from makea_cli.commands.email.cmd import register as register_email
 from makea_cli.commands.factory.cmd import register as register_factory
+from makea_cli.commands.flags.cmd import register as register_flags
 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
@@ -41,3 +42,4 @@ def register_all(app: typer.Typer) -> None:
     register_playbook(app)
     register_about(app)
     register_tasks(app)
+    register_flags(app)

{makea_cli-0.2.25 → makea_cli-0.2.26}/makea_cli/commands/directory/cmd.py

@@ -54,6 +54,20 @@ def register(app: typer.Typer) -> None:
         """
         print_json_or_exit(console, lambda: api_client.get_all_users(limit=limit, offset=offset))
 
+    @command(
+        app,
+        "admin",
+        "get",
+        "user",
+        api="GET /admin/user-profiles/{user_id}",
+        help="GET /admin/user-profiles/{user_id} — one account's profile (Cognito sub as id).",
+    )
+    def get_user(
+        user_id: str = typer.Argument(..., help="Cognito sub (user_id) of the account."),
+    ) -> None:
+        """Show one user's profile."""
+        print_json_or_exit(console, lambda: api_client.admin_get_user_profile(user_id))
+
     @command(
         app,
         "admin",

makea_cli-0.2.26/makea_cli/commands/flags/cmd.py

@@ -0,0 +1,157 @@
+"""Admin feature flags: the switches on the admin page's Flags tab.
+
+A flag is on globally, or, while the global switch is off, on for the accounts
+on its allow-list. The allow-list holds user ids (Cognito sub), never emails.
+Every change reaches prod users at once, so every write asks first.
+"""
+
+from __future__ import annotations
+
+import re
+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()
+
+# Mirrors garmentby_service.common.feature_flags (FLAG_KEY_PATTERN, MAX_FLAG_KEY_CHARS).
+_FLAG_KEY = re.compile(r"^[A-Z][A-Z0-9_]*$")
+_FLAG_KEY_MAX = 64
+
+
+def _flag_key(raw: str) -> str:
+    key = raw.strip().upper()
+    if not _FLAG_KEY.match(key) or len(key) > _FLAG_KEY_MAX:
+        raise typer.BadParameter(
+            f"flag key must be ALL_CAPS with underscores, at most {_FLAG_KEY_MAX} characters"
+        )
+    return key
+
+
+def register(app: typer.Typer) -> None:
+    @command(
+        app,
+        "admin",
+        "list",
+        "feature-flag",
+        api="GET /admin/feature-flags",
+        help=(
+            "GET /admin/feature-flags — every flag: global switch, default value, and the "
+            "accounts it is on for (id, email, name)."
+        ),
+    )
+    def list_feature_flags() -> None:
+        """List feature flags."""
+        print_json_or_exit(console, api_client.admin_list_feature_flags)
+
+    @command(
+        app,
+        "admin",
+        "create",
+        "feature-flag",
+        api="POST /admin/feature-flags",
+        side_effects=["with --enabled the flag is on for every account at once"],
+        approval="ask",
+        reversible=True,
+        idempotent=False,
+        help=(
+            "POST /admin/feature-flags — add a flag (off unless --enabled). An existing key "
+            "is refused."
+        ),
+    )
+    def create_feature_flag(
+        key: str = typer.Argument(..., help="Flag key, ALL_CAPS_WITH_UNDERSCORES."),
+        description: str | None = typer.Option(None, "--description", help="What it gates."),
+        enabled: bool = typer.Option(False, "--enabled", help="Turn it on globally now."),
+        value: str | None = typer.Option(
+            None,
+            "--value",
+            help="Default value, for flags that name a choice (e.g. DEEPSEEK).",
+        ),
+    ) -> None:
+        """Create a feature flag."""
+        body: dict[str, Any] = {"key": _flag_key(key), "enabled": enabled}
+        if description is not None:
+            body["description"] = description.strip()
+        if value is not None:
+            body["value"] = value.strip()
+        print_json_or_exit(console, lambda: api_client.admin_create_feature_flag(body))
+
+    @command(
+        app,
+        "admin",
+        "update",
+        "feature-flag",
+        api="PATCH /admin/feature-flags/{key}",
+        side_effects=["the change reaches the affected accounts at once"],
+        approval="ask",
+        reversible=True,
+        idempotent=True,
+        help=(
+            "PATCH /admin/feature-flags/{key} — flip the global switch, edit the description "
+            "or default value, or add / remove one account on the allow-list (by user id; "
+            "find it with admin list user)."
+        ),
+    )
+    def update_feature_flag(
+        key: str = typer.Argument(..., help="Flag key."),
+        enabled: bool | None = typer.Option(
+            None, "--enabled/--disabled", help="The global switch."
+        ),
+        description: str | None = typer.Option(None, "--description"),
+        value: str | None = typer.Option(
+            None, "--value", help="Default value; an empty string clears it."
+        ),
+        add_user: str | None = typer.Option(
+            None, "--add-user", help="User id (Cognito sub) to put on the allow-list."
+        ),
+        remove_user: str | None = typer.Option(
+            None, "--remove-user", help="User id to take off the allow-list."
+        ),
+    ) -> None:
+        """Change a feature flag."""
+        body: dict[str, Any] = {}
+        if enabled is not None:
+            body["enabled"] = enabled
+        if description is not None:
+            body["description"] = description.strip()
+        if value is not None:
+            body["value"] = value.strip()
+        if add_user and add_user.strip():
+            body["add_user_id"] = add_user.strip()
+        if remove_user and remove_user.strip():
+            body["remove_user_id"] = remove_user.strip()
+        if not body:
+            raise typer.BadParameter(
+                "pass at least one of --enabled/--disabled, --description, --value, "
+                "--add-user, --remove-user"
+            )
+        flag = _flag_key(key)
+        print_json_or_exit(console, lambda: api_client.admin_update_feature_flag(flag, body))
+
+    @command(
+        app,
+        "admin",
+        "delete",
+        "feature-flag",
+        api="DELETE /admin/feature-flags/{key}",
+        side_effects=["every check of the flag reads false from then on"],
+        approval="ask",
+        reversible=False,
+        idempotent=True,
+        help=(
+            "DELETE /admin/feature-flags/{key} — remove a flag. Every check of it then reads "
+            "false, so delete it only once the code that reads it is gone."
+        ),
+    )
+    def delete_feature_flag(
+        key: str = typer.Argument(..., help="Flag key."),
+    ) -> None:
+        """Delete a feature flag."""
+        flag = _flag_key(key)
+        print_json_or_exit(console, lambda: api_client.admin_delete_feature_flag(flag))