makea-cli 0.2.1__tar.gz → 0.2.2__tar.gz

{makea_cli-0.2.1 → makea_cli-0.2.2}/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.2.2
+
+Order lifecycle, exposed in tiers rather than all at once.
+
+- `ask` (an agent must put it in front of a person): `designer submit
+  sampling-order` (confirm a sample order), `designer submit production-order`,
+  `designer update production-order --complete|--links-file`, `designer update
+  shipping-order --confirm-receive`.
+- `never` (an agent must not run it at all): `designer update sampling-order
+  --cancel`, `designer delete sampling-order` (DRAFT only, the backend enforces
+  that), `designer delete shipping-order` — the endpoint is named cancel but it
+  unlinks every production order and removes the shipment.
+
+Cancel and delete are separate commands rather than flags on an `ask` one. The
+grade is per command, so putting them on a milder command would launder a
+destructive action through the wrong grade.
+
+**The grade is advice to a harness, not a gate in the CLI.** A person in a
+terminal runs any of these; `never` means an agent may not decide to.
+
+Payments, bank transfers and subscriptions stay out of the CLI. The endpoints
+exist, and a `--dry-run` would even make them look safe, but giving them a
+command puts a charge one step away from an agent and no approval grade makes
+that a good trade. A test asserts no write command reaches them.
+
 ## 0.2.1
 
 Each persona can now clear its own queue. `list task` and `list action` could show

{makea_cli-0.2.1 → makea_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.1
+Version: 0.2.2
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -79,6 +79,8 @@ makea-cli auth --logout
 
 每条命令都有的开关：`--describe` 打印它的机器可读定义（flags、副作用、审批档位）；`--json` 强制纯 JSON（stdout 不是终端时默认就是）。读命令还有 `--fields a,b,c` 只保留这些字段；`list` 命令还有 `--limit N`（后端自己分页的就透传，不分页的在本地截断并在结果里写明 `truncated` / `returned` / `omitted`）；写命令还有 `--dry-run`（打印将要发出的请求，不发）和 `--idempotency-key <k>`。`makea-cli --describe --json` 打印全量 manifest。
 
+写命令的**审批档位**（manifest 的 `approval`）是给 harness 的建议，不是 CLI 的门：`auto` 可以自动跑；`ask` 必须先让人确认；`never` agent 不许自己决定（人在终端照常能跑）。动钱的端点（payments / bank transfer / subscription）**故意不进 CLI**。
+
 exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不匹配 · `4` 后端拒绝（4xx，错误 JSON 在 stderr）· `5` 没跑完（5xx / 网络 / 超时）——读命令直接重试即可；**写命令可能已经生效了，重试前先读一遍状态**。
 
 0.1 的平铺命令名（`list-users`、`submit-supplier-quote` …）仍可用，作为隐藏的过渡别名转发到新命令并在 stderr 打一行提示；**下一个 minor 版本删除**。完整的改名对照表在 [CHANGELOG.md](CHANGELOG.md)。
@@ -147,6 +149,8 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer create product` | write（ask） | `POST /designer/product/create_or_update_product` | payload must match manufacture/specifications (all frontend fields; categories/subcategories + collection_id in --hel… | `designer-upsert-product` |
 | `makea-cli designer create rfq` | write（ask） | `POST /designer/product/send_rfq` | ask the chosen suppliers to quote on a product. --supplier repeats; --makea-sourcing also asks Makea to source. | — |
 | `makea-cli designer create sampling-order` | write（ask） | `POST /designer/sampling_orders` | order samples. --file is the full order payload (product_order_id, items, fees …); run --dry-run first and read the b… | — |
+| `makea-cli designer delete sampling-order` | write（never） | `DELETE /designer/sampling_orders/{sampling_order_id}` | delete a DRAFT sample order. The backend refuses any other status. Graded `never`. | — |
+| `makea-cli designer delete shipping-order` | write（never） | `POST /designer/shipping_orders/{shipping_order_id}/cancel` | the endpoint is called cancel but it unlinks every production order and removes the shipment, so it is a delete here.… | — |
 | `makea-cli designer download document` | read | `GET /designer/document/download` | save bytes for user_id + document_id (designer-authenticated; same query contract as admin document download). | `designer-download-document` |
 | `makea-cli designer get collection` | read | `GET /designer/collections/{collection_id}/overview` | one collection with its products, orders and lifecycle in a single read. | — |
 | `makea-cli designer get lifecycle` | read | `GET /designer/product_orders/{product_order_id}/lifecycle` | which stage this product is in. | — |
@@ -167,10 +171,15 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer list task` | read | `GET /designer/tasks` | what the platform is waiting on you for. | — |
 | `makea-cli designer search note` | read | `GET /designer/products/{product_id}/channel_search` | full-text search across a product's conversation; --channel narrows to one channel key. | — |
 | `makea-cli designer set product-collection` | write（auto） | `POST /designer/products/{id}/link-to-collection` | assign product to a collection. | `designer-link-product-to-collection` |
+| `makea-cli designer submit production-order` | write（ask） | `POST /designer/production_orders/{production_order_id}/submit` | submit a 大货 order. This is the commitment, so --dry-run and confirm with the user first. | — |
+| `makea-cli designer submit sampling-order` | write（ask） | `POST /designer/sampling_orders/{sampling_order_id}/confirm` | confirm a sample order so the supplier starts. Run --dry-run first and read it back to the user. | — |
 | `makea-cli designer update action` | write（auto） | `POST /designer/actions/{action_id}/{acknowledge\|snooze\|dismiss}` | respond to one of the pending actions from `designer list action`. An action is closed by the fact it asks for, not b… | — |
 | `makea-cli designer update note` | write（ask） | `POST /designer/products/{product_id}/notes/{note_id}/{accept\|reject}` | decide on a task the assistant proposed on a product. | — |
 | `makea-cli designer update product` | write（auto） | `POST /designer/product/update_basic_info` | patch fields on a product. --cover-image / --back-image take a document id and are what the assistant's set_product_i… | — |
+| `makea-cli designer update production-order` | write（ask） | `POST /designer/production_orders/{production_order_id}/complete` | POST /designer/production_orders/{id}/complete, or PUT the order to re-pick which supplier links it covers (--links-f… | — |
 | `makea-cli designer update proposal` | write（ask） | `POST /designer/beeboo_proposals/approve` | apply one spec change the assistant proposed. This edits the pack, so read the proposal first. | — |
+| `makea-cli designer update sampling-order` | write（never） | `POST /designer/sampling_orders/{sampling_order_id}/cancel` | cancel a sample order. Graded `never`: an agent must not do this on its own, a person runs it. | — |
+| `makea-cli designer update shipping-order` | write（ask） | `POST /designer/shipping_orders/{shipping_order_id}/confirm_receive` | say the goods arrived. The backend accepts this only while the shipment is IN_TRANSIT. | — |
 | `makea-cli designer update suggested-action` | write（ask） | `POST /designer/channels/{channel_id}/suggested_actions/bulk_accept` | accept several of a channel's suggested actions in one write. --action takes note_id:action_id and repeats. | — |
 | `makea-cli designer update task` | write（auto） | `POST /designer/tasks/{complete\|dismiss}` | close one of the tasks from `designer list task`. Complete means you did it; dismiss means it does not apply. | — |
 | `makea-cli designer upload document` | write（auto） | `POST /designer/document/upload` | upload a file for the current designer token; optional product_id (omit to start a new draft id server-side). | `designer-upload-document` |

{makea_cli-0.2.1 → makea_cli-0.2.2}/README.md

@@ -67,6 +67,8 @@ makea-cli auth --logout
 
 每条命令都有的开关：`--describe` 打印它的机器可读定义（flags、副作用、审批档位）；`--json` 强制纯 JSON（stdout 不是终端时默认就是）。读命令还有 `--fields a,b,c` 只保留这些字段；`list` 命令还有 `--limit N`（后端自己分页的就透传，不分页的在本地截断并在结果里写明 `truncated` / `returned` / `omitted`）；写命令还有 `--dry-run`（打印将要发出的请求，不发）和 `--idempotency-key <k>`。`makea-cli --describe --json` 打印全量 manifest。
 
+写命令的**审批档位**（manifest 的 `approval`）是给 harness 的建议，不是 CLI 的门：`auto` 可以自动跑；`ask` 必须先让人确认；`never` agent 不许自己决定（人在终端照常能跑）。动钱的端点（payments / bank transfer / subscription）**故意不进 CLI**。
+
 exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不匹配 · `4` 后端拒绝（4xx，错误 JSON 在 stderr）· `5` 没跑完（5xx / 网络 / 超时）——读命令直接重试即可；**写命令可能已经生效了，重试前先读一遍状态**。
 
 0.1 的平铺命令名（`list-users`、`submit-supplier-quote` …）仍可用，作为隐藏的过渡别名转发到新命令并在 stderr 打一行提示；**下一个 minor 版本删除**。完整的改名对照表在 [CHANGELOG.md](CHANGELOG.md)。
@@ -135,6 +137,8 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer create product` | write（ask） | `POST /designer/product/create_or_update_product` | payload must match manufacture/specifications (all frontend fields; categories/subcategories + collection_id in --hel… | `designer-upsert-product` |
 | `makea-cli designer create rfq` | write（ask） | `POST /designer/product/send_rfq` | ask the chosen suppliers to quote on a product. --supplier repeats; --makea-sourcing also asks Makea to source. | — |
 | `makea-cli designer create sampling-order` | write（ask） | `POST /designer/sampling_orders` | order samples. --file is the full order payload (product_order_id, items, fees …); run --dry-run first and read the b… | — |
+| `makea-cli designer delete sampling-order` | write（never） | `DELETE /designer/sampling_orders/{sampling_order_id}` | delete a DRAFT sample order. The backend refuses any other status. Graded `never`. | — |
+| `makea-cli designer delete shipping-order` | write（never） | `POST /designer/shipping_orders/{shipping_order_id}/cancel` | the endpoint is called cancel but it unlinks every production order and removes the shipment, so it is a delete here.… | — |
 | `makea-cli designer download document` | read | `GET /designer/document/download` | save bytes for user_id + document_id (designer-authenticated; same query contract as admin document download). | `designer-download-document` |
 | `makea-cli designer get collection` | read | `GET /designer/collections/{collection_id}/overview` | one collection with its products, orders and lifecycle in a single read. | — |
 | `makea-cli designer get lifecycle` | read | `GET /designer/product_orders/{product_order_id}/lifecycle` | which stage this product is in. | — |
@@ -155,10 +159,15 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer list task` | read | `GET /designer/tasks` | what the platform is waiting on you for. | — |
 | `makea-cli designer search note` | read | `GET /designer/products/{product_id}/channel_search` | full-text search across a product's conversation; --channel narrows to one channel key. | — |
 | `makea-cli designer set product-collection` | write（auto） | `POST /designer/products/{id}/link-to-collection` | assign product to a collection. | `designer-link-product-to-collection` |
+| `makea-cli designer submit production-order` | write（ask） | `POST /designer/production_orders/{production_order_id}/submit` | submit a 大货 order. This is the commitment, so --dry-run and confirm with the user first. | — |
+| `makea-cli designer submit sampling-order` | write（ask） | `POST /designer/sampling_orders/{sampling_order_id}/confirm` | confirm a sample order so the supplier starts. Run --dry-run first and read it back to the user. | — |
 | `makea-cli designer update action` | write（auto） | `POST /designer/actions/{action_id}/{acknowledge\|snooze\|dismiss}` | respond to one of the pending actions from `designer list action`. An action is closed by the fact it asks for, not b… | — |
 | `makea-cli designer update note` | write（ask） | `POST /designer/products/{product_id}/notes/{note_id}/{accept\|reject}` | decide on a task the assistant proposed on a product. | — |
 | `makea-cli designer update product` | write（auto） | `POST /designer/product/update_basic_info` | patch fields on a product. --cover-image / --back-image take a document id and are what the assistant's set_product_i… | — |
+| `makea-cli designer update production-order` | write（ask） | `POST /designer/production_orders/{production_order_id}/complete` | POST /designer/production_orders/{id}/complete, or PUT the order to re-pick which supplier links it covers (--links-f… | — |
 | `makea-cli designer update proposal` | write（ask） | `POST /designer/beeboo_proposals/approve` | apply one spec change the assistant proposed. This edits the pack, so read the proposal first. | — |
+| `makea-cli designer update sampling-order` | write（never） | `POST /designer/sampling_orders/{sampling_order_id}/cancel` | cancel a sample order. Graded `never`: an agent must not do this on its own, a person runs it. | — |
+| `makea-cli designer update shipping-order` | write（ask） | `POST /designer/shipping_orders/{shipping_order_id}/confirm_receive` | say the goods arrived. The backend accepts this only while the shipment is IN_TRANSIT. | — |
 | `makea-cli designer update suggested-action` | write（ask） | `POST /designer/channels/{channel_id}/suggested_actions/bulk_accept` | accept several of a channel's suggested actions in one write. --action takes note_id:action_id and repeats. | — |
 | `makea-cli designer update task` | write（auto） | `POST /designer/tasks/{complete\|dismiss}` | close one of the tasks from `designer list task`. Complete means you did it; dismiss means it does not apply. | — |
 | `makea-cli designer upload document` | write（auto） | `POST /designer/document/upload` | upload a file for the current designer token; optional product_id (omit to start a new draft id server-side). | `designer-upload-document` |

makea_cli-0.2.2/makea_cli/__init__.py

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

{makea_cli-0.2.1 → makea_cli-0.2.2}/makea_cli/api_client.py

@@ -1312,3 +1312,49 @@ def designer_list_actions(*, product_id: str | None = None) -> Any:
 def supplier_list_tasks() -> Any:
     """GET /supplier/tasks — the factory's onboarding and per-order to-dos."""
     return get_json("/supplier/tasks")
+
+
+# --- order lifecycle (designer). Tiered on purpose: see the commands' approval
+# --- grades -- submit/confirm ask a person, cancel/delete are never automatic,
+# --- and nothing here moves money. Payments and subscriptions are deliberately
+# --- absent from the CLI: an agent should not have a path to a charge.
+
+
+def designer_confirm_sampling_order(sampling_order_id: str) -> Any:
+    """POST /designer/sampling_orders/{id}/confirm — the brand confirms the sample order."""
+    return post_json(f"/designer/sampling_orders/{sampling_order_id}/confirm", {})
+
+
+def designer_cancel_sampling_order(sampling_order_id: str) -> Any:
+    """POST /designer/sampling_orders/{id}/cancel — cancel it."""
+    return post_json(f"/designer/sampling_orders/{sampling_order_id}/cancel", {})
+
+
+def designer_delete_sampling_order(sampling_order_id: str) -> Any:
+    """DELETE /designer/sampling_orders/{id} — DRAFT only; the backend refuses anything else."""
+    return delete_json(f"/designer/sampling_orders/{sampling_order_id}")
+
+
+def designer_submit_production_order(production_order_id: str) -> Any:
+    """POST /designer/production_orders/{id}/submit — hand the bulk order to the supplier."""
+    return post_json(f"/designer/production_orders/{production_order_id}/submit", {})
+
+
+def designer_complete_production_order(production_order_id: str) -> Any:
+    """POST /designer/production_orders/{id}/complete — the brand marks the bulk order done."""
+    return post_json(f"/designer/production_orders/{production_order_id}/complete", {})
+
+
+def designer_update_production_order(production_order_id: str, body: dict[str, Any]) -> Any:
+    """PUT /designer/production_orders/{id} — re-pick which supplier links the order covers."""
+    return put_json(f"/designer/production_orders/{production_order_id}", body, timeout=120.0)
+
+
+def designer_confirm_receive_shipping_order(shipping_order_id: str) -> Any:
+    """POST /designer/shipping_orders/{id}/confirm_receive — IN_TRANSIT only."""
+    return post_json(f"/designer/shipping_orders/{shipping_order_id}/confirm_receive", {})
+
+
+def designer_cancel_shipping_order(shipping_order_id: str) -> Any:
+    """POST /designer/shipping_orders/{id}/cancel — unlinks every production order, then deletes it."""
+    return post_json(f"/designer/shipping_orders/{shipping_order_id}/cancel", {})

{makea_cli-0.2.1 → makea_cli-0.2.2}/makea_cli/commands/brand/cmd.py

@@ -562,6 +562,197 @@ def register(app: typer.Typer) -> None:
             body["channel_key"] = channel
         print_json_or_exit(console, lambda: api_client.designer_add_product_note(product_id, body))
 
+    # --- order lifecycle ---------------------------------------------------------
+    #
+    # The `approval` grade on each of these is advice to a harness, not a gate in
+    # the CLI: a person in a terminal just runs the command. `ask` means an agent
+    # must put it in front of someone; `never` means an agent must not run it at
+    # all, which is why cancel and delete are their own commands rather than flags
+    # on an `ask` one -- the grade is per command, so mixing them would launder a
+    # destructive action through a milder grade.
+    #
+    # Payments and subscriptions are deliberately absent. They exist on the
+    # backend; giving them a CLI surface would put a charge one command away from
+    # an agent, and no approval grade makes that a good trade.
+
+    @command(
+        app,
+        "designer",
+        "submit",
+        "sampling-order",
+        api="POST /designer/sampling_orders/{sampling_order_id}/confirm",
+        side_effects=[
+            "confirms the sample order to the supplier",
+            "starts the supplier's clock on it",
+        ],
+        approval="ask",
+        help=(
+            "POST /designer/sampling_orders/{id}/confirm — confirm a sample order so the "
+            "supplier starts. Run --dry-run first and read it back to the user."
+        ),
+    )
+    def submit_sampling_order(
+        sampling_order_id: str = typer.Argument(..., help="Sampling order id."),
+    ) -> None:
+        """Confirm a sampling order."""
+        print_json_or_exit(
+            console, lambda: api_client.designer_confirm_sampling_order(sampling_order_id)
+        )
+
+    @command(
+        app,
+        "designer",
+        "update",
+        "sampling-order",
+        api="POST /designer/sampling_orders/{sampling_order_id}/cancel",
+        side_effects=["cancels the order", "tells the supplier to stop"],
+        approval="never",
+        help=(
+            "POST /designer/sampling_orders/{id}/cancel — cancel a sample order. Graded "
+            "`never`: an agent must not do this on its own, a person runs it."
+        ),
+    )
+    def update_sampling_order(
+        sampling_order_id: str = typer.Argument(..., help="Sampling order id."),
+        cancel: bool = typer.Option(
+            ..., "--cancel", help="The only operation here; explicit on purpose."
+        ),
+    ) -> None:
+        """Cancel a sampling order."""
+        if not cancel:
+            raise typer.BadParameter("--cancel is required")
+        print_json_or_exit(
+            console, lambda: api_client.designer_cancel_sampling_order(sampling_order_id)
+        )
+
+    @command(
+        app,
+        "designer",
+        "delete",
+        "sampling-order",
+        api="DELETE /designer/sampling_orders/{sampling_order_id}",
+        side_effects=["removes the order row; the backend allows this on DRAFT only"],
+        approval="never",
+        help=(
+            "DELETE /designer/sampling_orders/{id} — delete a DRAFT sample order. The backend "
+            "refuses any other status. Graded `never`."
+        ),
+    )
+    def delete_sampling_order(
+        sampling_order_id: str = typer.Argument(..., help="Sampling order id (DRAFT)."),
+    ) -> None:
+        """Delete a draft sampling order."""
+        print_json_or_exit(
+            console, lambda: api_client.designer_delete_sampling_order(sampling_order_id)
+        )
+
+    @command(
+        app,
+        "designer",
+        "submit",
+        "production-order",
+        api="POST /designer/production_orders/{production_order_id}/submit",
+        side_effects=["hands the bulk order to the supplier", "creates its charges"],
+        approval="ask",
+        help=(
+            "POST /designer/production_orders/{id}/submit — submit a 大货 order. This is the "
+            "commitment, so --dry-run and confirm with the user first."
+        ),
+    )
+    def submit_production_order(
+        production_order_id: str = typer.Argument(..., help="Production order id."),
+    ) -> None:
+        """Submit a production order."""
+        print_json_or_exit(
+            console, lambda: api_client.designer_submit_production_order(production_order_id)
+        )
+
+    @command(
+        app,
+        "designer",
+        "update",
+        "production-order",
+        api="POST /designer/production_orders/{production_order_id}/complete",
+        side_effects=["completing closes the order for both sides"],
+        approval="ask",
+        help=(
+            "POST /designer/production_orders/{id}/complete, or PUT the order to re-pick which "
+            "supplier links it covers (--links-file, same body shape as creating it)."
+        ),
+    )
+    def update_production_order(
+        production_order_id: str = typer.Argument(..., help="Production order id."),
+        complete: bool = typer.Option(False, "--complete", help="Mark the order finished."),
+        links_file: Path | None = typer.Option(
+            None,
+            "--links-file",
+            exists=True,
+            dir_okay=False,
+            help="JSON with selected_links, to change what the order covers.",
+        ),
+    ) -> None:
+        """Complete a production order, or change the links it covers."""
+        if complete == (links_file is not None):
+            raise typer.BadParameter("pass exactly one of --complete / --links-file")
+        if complete:
+            run = lambda: api_client.designer_complete_production_order(production_order_id)  # noqa: E731
+        else:
+            body = _json_object(None, links_file, "links-file")
+            run = lambda: api_client.designer_update_production_order(production_order_id, body)  # noqa: E731
+        print_json_or_exit(console, run)
+
+    @command(
+        app,
+        "designer",
+        "update",
+        "shipping-order",
+        api="POST /designer/shipping_orders/{shipping_order_id}/confirm_receive",
+        side_effects=["marks the shipment received, which closes it"],
+        approval="ask",
+        help=(
+            "POST /designer/shipping_orders/{id}/confirm_receive — say the goods arrived. The "
+            "backend accepts this only while the shipment is IN_TRANSIT."
+        ),
+    )
+    def update_shipping_order(
+        shipping_order_id: str = typer.Argument(..., help="Shipping order id."),
+        confirm_receive: bool = typer.Option(
+            ..., "--confirm-receive", help="The only operation here; explicit on purpose."
+        ),
+    ) -> None:
+        """Confirm receipt of a shipment."""
+        if not confirm_receive:
+            raise typer.BadParameter("--confirm-receive is required")
+        print_json_or_exit(
+            console,
+            lambda: api_client.designer_confirm_receive_shipping_order(shipping_order_id),
+        )
+
+    @command(
+        app,
+        "designer",
+        "delete",
+        "shipping-order",
+        api="POST /designer/shipping_orders/{shipping_order_id}/cancel",
+        side_effects=[
+            "unlinks every production order on the shipment",
+            "deletes the shipment itself",
+        ],
+        approval="never",
+        help=(
+            "POST /designer/shipping_orders/{id}/cancel — the endpoint is called cancel but it "
+            "unlinks every production order and removes the shipment, so it is a delete here. "
+            "Graded `never`."
+        ),
+    )
+    def delete_shipping_order(
+        shipping_order_id: str = typer.Argument(..., help="Shipping order id."),
+    ) -> None:
+        """Cancel (and remove) a shipping order."""
+        print_json_or_exit(
+            console, lambda: api_client.designer_cancel_shipping_order(shipping_order_id)
+        )
+
     @command(
         app,
         "designer",

{makea_cli-0.2.1 → makea_cli-0.2.2}/pyproject.toml

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

{makea_cli-0.2.1 → makea_cli-0.2.2}/tests/golden_manifest.json

@@ -4817,6 +4817,73 @@
         }
       ]
     },
+    {
+      "name": "designer delete sampling-order",
+      "persona": "designer",
+      "verb": "delete",
+      "noun": "sampling-order",
+      "access": "write",
+      "api": "DELETE /designer/sampling_orders/{sampling_order_id}",
+      "external": null,
+      "side_effects": [
+        "removes the order row; the backend allows this on DRAFT only"
+      ],
+      "approval": "never",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "DELETE /designer/sampling_orders/{id} — delete a DRAFT sample order. The backend refuses any other status. Graded `never`.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.delete_sampling_order",
+      "flags": [
+        {
+          "name": "sampling_order_id",
+          "kind": "argument",
+          "opts": [
+            "sampling_order_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Sampling order id (DRAFT)."
+        }
+      ]
+    },
+    {
+      "name": "designer delete shipping-order",
+      "persona": "designer",
+      "verb": "delete",
+      "noun": "shipping-order",
+      "access": "write",
+      "api": "POST /designer/shipping_orders/{shipping_order_id}/cancel",
+      "external": null,
+      "side_effects": [
+        "unlinks every production order on the shipment",
+        "deletes the shipment itself"
+      ],
+      "approval": "never",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /designer/shipping_orders/{id}/cancel — the endpoint is called cancel but it unlinks every production order and removes the shipment, so it is a delete here. Graded `never`.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.delete_shipping_order",
+      "flags": [
+        {
+          "name": "shipping_order_id",
+          "kind": "argument",
+          "opts": [
+            "shipping_order_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Shipping order id."
+        }
+      ]
+    },
     {
       "name": "designer download document",
       "persona": "designer",
@@ -5532,6 +5599,74 @@
         }
       ]
     },
+    {
+      "name": "designer submit production-order",
+      "persona": "designer",
+      "verb": "submit",
+      "noun": "production-order",
+      "access": "write",
+      "api": "POST /designer/production_orders/{production_order_id}/submit",
+      "external": null,
+      "side_effects": [
+        "hands the bulk order to the supplier",
+        "creates its charges"
+      ],
+      "approval": "ask",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /designer/production_orders/{id}/submit — submit a 大货 order. This is the commitment, so --dry-run and confirm with the user first.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.submit_production_order",
+      "flags": [
+        {
+          "name": "production_order_id",
+          "kind": "argument",
+          "opts": [
+            "production_order_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Production order id."
+        }
+      ]
+    },
+    {
+      "name": "designer submit sampling-order",
+      "persona": "designer",
+      "verb": "submit",
+      "noun": "sampling-order",
+      "access": "write",
+      "api": "POST /designer/sampling_orders/{sampling_order_id}/confirm",
+      "external": null,
+      "side_effects": [
+        "confirms the sample order to the supplier",
+        "starts the supplier's clock on it"
+      ],
+      "approval": "ask",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /designer/sampling_orders/{id}/confirm — confirm a sample order so the supplier starts. Run --dry-run first and read it back to the user.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.submit_sampling_order",
+      "flags": [
+        {
+          "name": "sampling_order_id",
+          "kind": "argument",
+          "opts": [
+            "sampling_order_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Sampling order id."
+        }
+      ]
+    },
     {
       "name": "designer update action",
       "persona": "designer",
@@ -5750,6 +5885,63 @@
         }
       ]
     },
+    {
+      "name": "designer update production-order",
+      "persona": "designer",
+      "verb": "update",
+      "noun": "production-order",
+      "access": "write",
+      "api": "POST /designer/production_orders/{production_order_id}/complete",
+      "external": null,
+      "side_effects": [
+        "completing closes the order for both sides"
+      ],
+      "approval": "ask",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /designer/production_orders/{id}/complete, or PUT the order to re-pick which supplier links it covers (--links-file, same body shape as creating it).",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.update_production_order",
+      "flags": [
+        {
+          "name": "production_order_id",
+          "kind": "argument",
+          "opts": [
+            "production_order_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Production order id."
+        },
+        {
+          "name": "complete",
+          "kind": "option",
+          "opts": [
+            "--complete"
+          ],
+          "type": "flag",
+          "required": false,
+          "multiple": false,
+          "default": false,
+          "help": "Mark the order finished."
+        },
+        {
+          "name": "links_file",
+          "kind": "option",
+          "opts": [
+            "--links-file"
+          ],
+          "type": "file",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "JSON with selected_links, to change what the order covers."
+        }
+      ]
+    },
     {
       "name": "designer update proposal",
       "persona": "designer",
@@ -5796,6 +5988,97 @@
         }
       ]
     },
+    {
+      "name": "designer update sampling-order",
+      "persona": "designer",
+      "verb": "update",
+      "noun": "sampling-order",
+      "access": "write",
+      "api": "POST /designer/sampling_orders/{sampling_order_id}/cancel",
+      "external": null,
+      "side_effects": [
+        "cancels the order",
+        "tells the supplier to stop"
+      ],
+      "approval": "never",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /designer/sampling_orders/{id}/cancel — cancel a sample order. Graded `never`: an agent must not do this on its own, a person runs it.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.update_sampling_order",
+      "flags": [
+        {
+          "name": "sampling_order_id",
+          "kind": "argument",
+          "opts": [
+            "sampling_order_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Sampling order id."
+        },
+        {
+          "name": "cancel",
+          "kind": "option",
+          "opts": [
+            "--cancel"
+          ],
+          "type": "flag",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "The only operation here; explicit on purpose."
+        }
+      ]
+    },
+    {
+      "name": "designer update shipping-order",
+      "persona": "designer",
+      "verb": "update",
+      "noun": "shipping-order",
+      "access": "write",
+      "api": "POST /designer/shipping_orders/{shipping_order_id}/confirm_receive",
+      "external": null,
+      "side_effects": [
+        "marks the shipment received, which closes it"
+      ],
+      "approval": "ask",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /designer/shipping_orders/{id}/confirm_receive — say the goods arrived. The backend accepts this only while the shipment is IN_TRANSIT.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.update_shipping_order",
+      "flags": [
+        {
+          "name": "shipping_order_id",
+          "kind": "argument",
+          "opts": [
+            "shipping_order_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Shipping order id."
+        },
+        {
+          "name": "confirm_receive",
+          "kind": "option",
+          "opts": [
+            "--confirm-receive"
+          ],
+          "type": "flag",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "The only operation here; explicit on purpose."
+        }
+      ]
+    },
     {
       "name": "designer update suggested-action",
       "persona": "designer",

{makea_cli-0.2.1 → makea_cli-0.2.2}/tests/test_persona_commands.py

@@ -323,3 +323,89 @@ class SupplierLifecycleTests(_PersonaCase):
         self.run_cli("supplier", "update", "action", "a-1", "--snooze", "2")
         self.assertEqual(self.rec.last["path"], "/supplier/actions/a-1/snooze")
         self.assertEqual(self.rec.last["body"], {"days": 2})
+
+
+class OrderLifecycleTests(_PersonaCase):
+    """The tiered order commands, and the grades that make the tiering real."""
+
+    persona = "designer"
+
+    def test_confirm_and_submit_endpoints(self):
+        self.run_cli("designer", "submit", "sampling-order", "so-1")
+        self.assertEqual(self.rec.last["path"], "/designer/sampling_orders/so-1/confirm")
+        self.run_cli("designer", "submit", "production-order", "po-1")
+        self.assertEqual(self.rec.last["path"], "/designer/production_orders/po-1/submit")
+
+    def test_cancel_and_delete_are_separate_commands(self):
+        self.run_cli("designer", "update", "sampling-order", "so-1", "--cancel")
+        self.assertEqual(self.rec.last["path"], "/designer/sampling_orders/so-1/cancel")
+        self.run_cli("designer", "delete", "sampling-order", "so-2")
+        self.assertEqual(self.rec.last["method"], "DELETE")
+        self.assertEqual(self.rec.last["path"], "/designer/sampling_orders/so-2")
+
+    def test_production_order_update_takes_one_intent(self):
+        result = self.runner.invoke(self.cli, ["designer", "update", "production-order", "po-1"])
+        self.assertEqual(result.exit_code, 2)
+        self.run_cli("designer", "update", "production-order", "po-1", "--complete")
+        self.assertEqual(self.rec.last["path"], "/designer/production_orders/po-1/complete")
+
+    def test_production_order_links_file_is_a_put(self):
+        with self.runner.isolated_filesystem():
+            with open("links.json", "w") as f:
+                json.dump({"selected_links": [{"link_id": "lk-1"}]}, f)
+            self.run_cli(
+                "designer", "update", "production-order", "po-1", "--links-file", "links.json"
+            )
+        self.assertEqual(self.rec.last["method"], "PUT")
+        self.assertEqual(self.rec.last["body"], {"selected_links": [{"link_id": "lk-1"}]})
+
+    def test_shipping_receive_and_removal(self):
+        self.run_cli("designer", "update", "shipping-order", "sh-1", "--confirm-receive")
+        self.assertEqual(self.rec.last["path"], "/designer/shipping_orders/sh-1/confirm_receive")
+        self.run_cli("designer", "delete", "shipping-order", "sh-1")
+        self.assertEqual(self.rec.last["path"], "/designer/shipping_orders/sh-1/cancel")
+
+    def test_destructive_commands_are_graded_never(self):
+        from makea_cli import registry
+
+        for persona, verb, noun in (
+            ("designer", "update", "sampling-order"),
+            ("designer", "delete", "sampling-order"),
+            ("designer", "delete", "shipping-order"),
+        ):
+            spec = registry.spec_for(persona, verb, noun)
+            self.assertEqual(spec.approval, "never", spec.name)
+
+    def test_commitments_are_graded_ask(self):
+        from makea_cli import registry
+
+        for persona, verb, noun in (
+            ("designer", "submit", "sampling-order"),
+            ("designer", "submit", "production-order"),
+            ("designer", "update", "production-order"),
+            ("designer", "update", "shipping-order"),
+        ):
+            spec = registry.spec_for(persona, verb, noun)
+            self.assertEqual(spec.approval, "ask", spec.name)
+
+    def test_the_cli_itself_does_not_block_a_never_command(self):
+        """The grade is advice to a harness; a person in a terminal still runs it."""
+        self.run_cli("designer", "delete", "shipping-order", "sh-9")
+        self.assertEqual(len(self.rec.calls), 1)
+
+
+class NoMoneyPathTests(unittest.TestCase):
+    """No CLI command may reach a payment or subscription endpoint."""
+
+    def test_no_command_touches_money(self):
+        from makea_cli import registry
+        from makea_cli.main import build_cli
+
+        build_cli()
+        forbidden = ("/payments", "/subscription", "/bank-transfers", "create-session", "checkout")
+        offenders = [
+            (s.name, s.api)
+            for s in registry.specs()
+            if not s.external and any(f in s.api for f in forbidden) and s.access == "write"
+        ]
+        self.assertEqual(offenders, [], "a write command reaches money movement")

makea_cli-0.2.1/makea_cli/__init__.py

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