makea-cli 0.2.1__py3-none-any.whl → 0.2.2__py3-none-any.whl

makea_cli/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.1"
+__version__ = "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/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.dist-info → makea_cli-0.2.2.dist-info}/METADATA

@@ -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.dist-info → makea_cli-0.2.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
-makea_cli/__init__.py,sha256=HfjVOrpTnmZ-xVFCYSVmX50EXaBQeJteUHG-PD6iQs8,22
+makea_cli/__init__.py,sha256=m6kyaNpwBcP1XYcqrelX2oS3PJuOnElOcRdBa9pEb8c,22
 makea_cli/__main__.py,sha256=AkQjxWfKE3w9iD1d6I-2Zqvv2t9cct0oYyFF0UiA-Z0,144
-makea_cli/api_client.py,sha256=tF_FMHFnuxhUSjvc_XkzozLhdcBUMlYuzoT8CJly8mI,46100
+makea_cli/api_client.py,sha256=cvs7ntOqVb8mDGiCOmyHwPo2EvwDTYqlchm5pXbG15w,48435
 makea_cli/auth_pkce.py,sha256=iXSyJ7DM3qVuj-3FwPiqM25CxXz9ebFs9FNthZdw3ws,7315
 makea_cli/config.py,sha256=lVPsp-44V9pPyUNbcG-uQNV8srCrBVMZnb0HF38Paks,2906
 makea_cli/errors.py,sha256=_2qKjvkU8YWeBcUd04Yn62lKkZoqQY52kH8klNMyxhM,2780
@@ -16,7 +16,7 @@ makea_cli/commands/analytics/cmd.py,sha256=_I5fBlomTalAxRpB-jculS01AbjEC5cVG3lAN
 makea_cli/commands/auth/__init__.py,sha256=NXoKGfkY2X_hb8GnAyzhoI_qDXfpwKZPqt4HnOrXW3Y,73
 makea_cli/commands/auth/cmd.py,sha256=G9ZeiaJwzUUTptIyynr0V-82wI7eV0qVX0pD6rdPSXg,1321
 makea_cli/commands/brand/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-makea_cli/commands/brand/cmd.py,sha256=0GyF-kcuh6jpEeCn9bm-MsS_FDCl6yyAhiNk-UmX_CM,23447
+makea_cli/commands/brand/cmd.py,sha256=9Gx2agSJP6LyDZYOGyYr3mAfqPFJRiuno41DmucKZqI,31040
 makea_cli/commands/designer/__init__.py,sha256=Tc3Ju4-BKX2euBljhlrEd-Ksirk6JSPNixq4x0IbQYI,77
 makea_cli/commands/designer/cmd.py,sha256=4oOJ5tWYojUs8FBj3QRmgpwbicpsU1XqswoNlJpLLS8,23615
 makea_cli/commands/directory/__init__.py,sha256=rQHBc0JOFXynlzrBm_YfqoRuNsS-JOl-OOvPjgDbnIA,78
@@ -40,7 +40,7 @@ makea_cli/commands/production/cmd.py,sha256=s6fVAGzOvokF6Va5WKGEA2vw2x2hDQ3PrsF0
 makea_cli/commands/production/pricing_spec.py,sha256=xGbj7-ps3PcKuU6Oc59A70b62FjF6Awhr5IY3ymZveU,27174
 makea_cli/commands/supplier/__init__.py,sha256=qfQDeQdQ-B7I_uwFVfcp1vXFUTL4fAcNLu3ipsZ7dfs,77
 makea_cli/commands/supplier/cmd.py,sha256=CrG1m0U5-dvdJi4vk9-JRSYY_moPfV_Ud6jRTf-G5Z8,56947
-makea_cli-0.2.1.dist-info/METADATA,sha256=yZr1GR_KU8YLRxufe04hPVDi5oY4yCks2NKomp9ATDc,27908
-makea_cli-0.2.1.dist-info/WHEEL,sha256=THafob7ofN-NsuMN7Mg4qZyHaQI7KkD-QlcQatYhXPo,87
-makea_cli-0.2.1.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
-makea_cli-0.2.1.dist-info/RECORD,,
+makea_cli-0.2.2.dist-info/METADATA,sha256=jW5EW6HvLmvM2Zrr1Afg6kJTZgXq-0P9Wz0qPKcJGyQ,29877
+makea_cli-0.2.2.dist-info/WHEEL,sha256=THafob7ofN-NsuMN7Mg4qZyHaQI7KkD-QlcQatYhXPo,87
+makea_cli-0.2.2.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
+makea_cli-0.2.2.dist-info/RECORD,,