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

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

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.2.22
+
+New: what the brand reads under a rule, and its card name. Needs the backend
+from the same day.
+
+- `admin create / update rule --why … --proof "WHO|YYYY-MM-DD|TEXT"`: the
+  reason the brand reads under a rule on Knowledge > Rules, and up to 5
+  messages behind it (WHO is Brand, Factory, record or a name). Kept apart
+  from `--reason`, which only admins see. (The flags went out in 0.2.21; the
+  backend reads them from this release.)
+- `admin create / update rule --title …`: the rule's card name on the Rules
+  page. Beeboo names every rule by itself; `update --title ""` hands it back.
+- `admin list / get rule` show each rule's `title`.
+
 ## 0.2.21
 
 New: the Makea team's task queue. Needs the backend from the same day

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.21
+Version: 0.2.22
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -92,7 +92,7 @@ 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/{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 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… | — |
@@ -133,7 +133,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/{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 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, title, 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` |
@@ -150,7 +150,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update library-element` | write（auto） | `PATCH /admin/designer/{user_id}/library_components/{component_id}` | update a component's name and/or values (empty value clears a field). | `library-update` |
 | `makea-cli admin update quote` | write（ask） | `POST /admin/product/edit_supplier_link_override_info` | admin updates an existing quote (supplier link) in place. Only the options you pass are sent, and the backend leaves … | `update-supplier-quote` |
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
-| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/{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 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 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.21 → makea_cli-0.2.22}/README.md

@@ -80,7 +80,7 @@ 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/{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 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… | — |
@@ -121,7 +121,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/{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 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, title, 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` |
@@ -138,7 +138,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update library-element` | write（auto） | `PATCH /admin/designer/{user_id}/library_components/{component_id}` | update a component's name and/or values (empty value clears a field). | `library-update` |
 | `makea-cli admin update quote` | write（ask） | `POST /admin/product/edit_supplier_link_override_info` | admin updates an existing quote (supplier link) in place. Only the options you pass are sent, and the backend leaves … | `update-supplier-quote` |
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
-| `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/{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 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 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.22/makea_cli/__init__.py

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

{makea_cli-0.2.21 → makea_cli-0.2.22}/makea_cli/commands/playbook/cmd.py

@@ -62,6 +62,10 @@ one message behind it, WHO|YYYY-MM-DD|TEXT or WHO|TEXT, WHO being Brand,
 Factory, record or a name. Both are kept apart from --reason, which only
 admins see. A later --why/--proof replaces the earlier pair.
 
+--title is the rule's card name on the brand's Rules page ("Restate every
+comment"). Beeboo names every rule by itself; a --title given here holds
+until the rule's words change. update --title "" hands naming back to Beeboo.
+
 --when is which products it is for, as JSON:
   '{"categories": ["knitwear"], "service_modes": ["cmt"]}'
 Order conditions the rule already has (units, destination) are kept; {} means
@@ -129,6 +133,15 @@ def _why_option() -> Any:
     )
 
 
+def _title_option() -> Any:
+    return typer.Option(
+        None,
+        "--title",
+        help="The card name on the brand's Rules page, 2-4 words (Beeboo names it "
+        'when left out; "" on update hands it back to Beeboo).',
+    )
+
+
 def _proof_option() -> Any:
     return typer.Option(
         None,
@@ -402,6 +415,7 @@ def register(app: typer.Typer) -> None:
         ),
         why: str | None = _why_option(),
         proof: list[str] | None = _proof_option(),
+        title: str | None = _title_option(),
     ) -> None:
         """Add a playbook rule for a person, a factory or everyone."""
         base = _target(user, supplier, is_global)
@@ -429,6 +443,8 @@ def register(app: typer.Typer) -> None:
         if valid_until is not None:
             body["valid_until"] = _date(valid_until)
         _basis(body, why, proof)
+        if title is not None and title.strip():
+            body["title"] = " ".join(title.split())
         print_json_or_exit(console, lambda: api_client.admin_create_rule(base, body))
 
     @command(
@@ -446,8 +462,8 @@ def register(app: typer.Typer) -> None:
         idempotent=True,
         help=(
             "PATCH /admin/playbook/{target}/rules/{rule_id} — change a rule's text, "
-            "status, applies_to, when, mode, or the --why/--proof the brand reads. --reason "
-            "required; the rule keeps what it was before."
+            "status, applies_to, when, mode, the --why/--proof the brand reads, or its card "
+            "--title. --reason required; the rule keeps what it was before."
         ),
         epilog=_RULES_EPILOG,
     )
@@ -473,6 +489,7 @@ def register(app: typer.Typer) -> None:
         ),
         why: str | None = _why_option(),
         proof: list[str] | None = _proof_option(),
+        title: str | None = _title_option(),
     ) -> None:
         """Edit a playbook rule."""
         base = _target(user, supplier, is_global)
@@ -492,10 +509,12 @@ def register(app: typer.Typer) -> None:
                 "" if valid_until.strip().lower() == "none" else _date(valid_until)
             )
         _basis(body, why, proof)
+        if title is not None:
+            body["title"] = " ".join(title.split())
         if not body:
             raise typer.BadParameter(
                 "nothing to change: pass --text, --status, --applies-to, --when, --mode, "
-                "--valid-until, --why or --proof"
+                "--valid-until, --why, --proof or --title"
             )
         body["reason"] = _reason(reason)
         print_json_or_exit(console, lambda: api_client.admin_update_rule(base, rule_id, body))

{makea_cli-0.2.21 → makea_cli-0.2.22}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "makea-cli"
-version = "0.2.21"
+version = "0.2.22"
 description = "Makea admin CLI (browser login + Makea admin HTTP API)"
 readme = "README.md"
 requires-python = ">=3.10"

{makea_cli-0.2.21 → makea_cli-0.2.22}/tests/golden_manifest.json

@@ -546,6 +546,18 @@
           "multiple": true,
           "default": null,
           "help": "A message behind the rule, WHO|YYYY-MM-DD|TEXT or WHO|TEXT (repeatable, max 5)."
+        },
+        {
+          "name": "title",
+          "kind": "option",
+          "opts": [
+            "--title"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "The card name on the brand's Rules page, 2-4 words (Beeboo names it when left out; \"\" on update hands it back to Beeboo)."
         }
       ]
     },
@@ -5059,7 +5071,7 @@
       "idempotent": true,
       "limit": null,
       "legacy": [],
-      "help": "PATCH /admin/playbook/{target}/rules/{rule_id} — change a rule's text, status, applies_to, when, mode, or the --why/--proof the brand reads. --reason required; the rule keeps what it was before.",
+      "help": "PATCH /admin/playbook/{target}/rules/{rule_id} — change a rule's text, status, applies_to, when, mode, the --why/--proof the brand reads, or its card --title. --reason required; the rule keeps what it was before.",
       "function": "makea_cli.commands.playbook.cmd.register.<locals>.update_rule",
       "flags": [
         {
@@ -5219,6 +5231,18 @@
           "multiple": true,
           "default": null,
           "help": "A message behind the rule, WHO|YYYY-MM-DD|TEXT or WHO|TEXT (repeatable, max 5)."
+        },
+        {
+          "name": "title",
+          "kind": "option",
+          "opts": [
+            "--title"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "The card name on the brand's Rules page, 2-4 words (Beeboo names it when left out; \"\" on update hands it back to Beeboo)."
         }
       ]
     },
@@ -9914,4 +9938,4 @@
       ]
     }
   ]
-}
+}

makea_cli-0.2.21/makea_cli/__init__.py

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