makea-cli 0.2.4__tar.gz → 0.2.6__tar.gz

{makea_cli-0.2.4 → makea_cli-0.2.6}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.2.6
+
+- `admin update tracking-status <kind> <order_id> <tracking_number> --status Delivered`
+  (`ask`): tell Makea what the carrier says about one parcel. The 17track API
+  is off, so the daily tracking-sweep skill reads the public 17track page and
+  posts each delivered parcel here. The backend runs the same path the 17track
+  webhook did: status, fan-out to every order sharing the number, and the
+  delivered emails. Repeating a Delivered update is a no-op.
+
+## 0.2.5
+
+The production journey, for the Claude agent on the product channel.
+
+- `designer set production-cart <production_order_id> --qty 'SIZE,#RRGGBB=COUNT' …`
+  (`auto`): the run's size x colour quantities. Replaces the whole cart, and is
+  refused once the run is locked.
+- `designer set production-lock <production_order_id> [--unlock]` (`ask`):
+  place the order. Locking is what makes the deposit payable; it can be
+  reopened until the deposit is paid.
+- `designer get production-price <production_order_id> [--phase final]`: the
+  deposit (or balance) for the quantities on the run now, line by line.
+
 ## 0.2.4
 
 For Beeboo acting for a brand through the CLI (the Claude agent on the product

{makea_cli-0.2.4 → makea_cli-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.4
+Version: 0.2.6
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -131,6 +131,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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 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 tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |
+| `makea-cli admin update tracking-status` | write（ask） | `POST /admin/tracking/carrier_status` | apply a carrier status looked up by hand (tracking-sweep skill) to one order. Runs the 17track webhook path: status, fan-out, delivered emails. | — |
 | `makea-cli admin update user` | write（ask） | `PUT /admin/user-profiles/{user_id}/update` | admin updates DynamoDB user profile fields and/or Cognito custom:userType. Allowed --user-type values: "Fashion brand… | `update-user-profile` |
 | `makea-cli admin upload financial-document` | write（auto） | `POST /admin/products/{product_id}/financial_documents` | upload one or more files to AWS S3 and return financial document metadata. | `upload-financial-documents` |
 | `makea-cli admin upload link-document` | write（auto） | `POST /admin/upload_link_document` | upload a file to AWS S3 and return document domain metadata for reuse as input in other commands. | `upload-link-document` |
@@ -157,6 +158,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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. | — |
 | `makea-cli designer get product` | read | `GET /designer/get_product` | one product: status, documents, prices, links. | — |
+| `makea-cli designer get production-price` | read | `GET /designer/production_orders/{production_order_id}/calculate_price` | what the deposit (or the balance, --phase final) comes to for the quantities on the run right now, line by line. | — |
 | `makea-cli designer get quote-advice` | read | `GET /designer/product/quote_advice` | which quote to award and why, from cache. Reading never spends a model call; the web app is what asks for a fresh one. | — |
 | `makea-cli designer get tech-pack` | read | `GET /designer/products/{product_id}/technical-specifications` | the product's tech pack. | — |
 | `makea-cli designer get tech-pack-history` | read | `GET /designer/products/{product_id}/specification-change-history` | who changed which spec field, when, and from what. | — |
@@ -173,6 +175,8 @@ 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 set production-cart` | write（auto） | `PUT /designer/production_orders/{production_order_id}/cart` | the quantity of every size and colour on the run. Replaces the whole cart: pass every cell you want kept. --qty repea… | — |
+| `makea-cli designer set production-lock` | write（ask） | `POST /designer/production_orders/{production_order_id}/configuration-lock` | place the order with the quantities on the run (--unlock to reopen them). Locking is what makes the deposit payable: … | — |
 | `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 submit tech-pack` | write（ask） | `POST /designer/products/{product_id}/technical-specifications/confirm` | confirm the tech pack, the step before anyone is asked to quote. | — |

{makea_cli-0.2.4 → makea_cli-0.2.6}/README.md

@@ -119,6 +119,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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 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 tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |
+| `makea-cli admin update tracking-status` | write（ask） | `POST /admin/tracking/carrier_status` | apply a carrier status looked up by hand (tracking-sweep skill) to one order. Runs the 17track webhook path: status, fan-out, delivered emails. | — |
 | `makea-cli admin update user` | write（ask） | `PUT /admin/user-profiles/{user_id}/update` | admin updates DynamoDB user profile fields and/or Cognito custom:userType. Allowed --user-type values: "Fashion brand… | `update-user-profile` |
 | `makea-cli admin upload financial-document` | write（auto） | `POST /admin/products/{product_id}/financial_documents` | upload one or more files to AWS S3 and return financial document metadata. | `upload-financial-documents` |
 | `makea-cli admin upload link-document` | write（auto） | `POST /admin/upload_link_document` | upload a file to AWS S3 and return document domain metadata for reuse as input in other commands. | `upload-link-document` |
@@ -145,6 +146,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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. | — |
 | `makea-cli designer get product` | read | `GET /designer/get_product` | one product: status, documents, prices, links. | — |
+| `makea-cli designer get production-price` | read | `GET /designer/production_orders/{production_order_id}/calculate_price` | what the deposit (or the balance, --phase final) comes to for the quantities on the run right now, line by line. | — |
 | `makea-cli designer get quote-advice` | read | `GET /designer/product/quote_advice` | which quote to award and why, from cache. Reading never spends a model call; the web app is what asks for a fresh one. | — |
 | `makea-cli designer get tech-pack` | read | `GET /designer/products/{product_id}/technical-specifications` | the product's tech pack. | — |
 | `makea-cli designer get tech-pack-history` | read | `GET /designer/products/{product_id}/specification-change-history` | who changed which spec field, when, and from what. | — |
@@ -161,6 +163,8 @@ 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 set production-cart` | write（auto） | `PUT /designer/production_orders/{production_order_id}/cart` | the quantity of every size and colour on the run. Replaces the whole cart: pass every cell you want kept. --qty repea… | — |
+| `makea-cli designer set production-lock` | write（ask） | `POST /designer/production_orders/{production_order_id}/configuration-lock` | place the order with the quantities on the run (--unlock to reopen them). Locking is what makes the deposit payable: … | — |
 | `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 submit tech-pack` | write（ask） | `POST /designer/products/{product_id}/technical-specifications/confirm` | confirm the tech pack, the step before anyone is asked to quote. | — |

makea_cli-0.2.6/makea_cli/__init__.py

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

{makea_cli-0.2.4 → makea_cli-0.2.6}/makea_cli/api_client.py

@@ -1213,6 +1213,27 @@ def designer_create_checkout(body: dict[str, Any]) -> Any:
     return post_json("/designer/payments/basket/create-session", body)
 
 
+def designer_production_price(production_order_id: str, phase: str) -> Any:
+    """GET /designer/production_orders/{id}/calculate_price — deposit or balance, itemised."""
+    return get_json(
+        f"/designer/production_orders/{production_order_id}/calculate_price",
+        params={"payment_type": phase},
+    )
+
+
+def designer_set_production_cart(production_order_id: str, cart: dict[str, int]) -> Any:
+    """PUT /designer/production_orders/{id}/cart — replace the size x colour quantities."""
+    return put_json(f"/designer/production_orders/{production_order_id}/cart", {"cart_items": cart})
+
+
+def designer_set_production_lock(production_order_id: str, locked: bool) -> Any:
+    """POST /designer/production_orders/{id}/configuration-lock — place or reopen the run."""
+    return post_json(
+        f"/designer/production_orders/{production_order_id}/configuration-lock",
+        {"locked": locked},
+    )
+
+
 def designer_list_collections() -> Any:
     """GET /designer/collections — the brand's collections."""
     return get_json("/designer/collections")

{makea_cli-0.2.4 → makea_cli-0.2.6}/makea_cli/commands/brand/cmd.py

@@ -914,3 +914,99 @@ def register(app: typer.Typer) -> None:
         if accept_terms:
             body["terms_accepted"] = True
         print_json_or_exit(console, lambda: api_client.designer_create_checkout(body))
+
+    # --- the production journey: quantities, place the order, pay the deposit ---
+
+    @command(
+        app,
+        "designer",
+        "get",
+        "production-price",
+        api="GET /designer/production_orders/{production_order_id}/calculate_price",
+        help=(
+            "GET /designer/production_orders/{id}/calculate_price — what the deposit (or the "
+            "balance, --phase final) comes to for the quantities on the run right now, line "
+            "by line."
+        ),
+    )
+    def get_production_price(
+        production_order_id: str = typer.Argument(..., help="Production order id."),
+        phase: str = typer.Option("deposit", "--phase", help="deposit or final."),
+    ) -> None:
+        """Price a production order's deposit or balance."""
+        if phase not in ("deposit", "final"):
+            raise typer.BadParameter("--phase is deposit or final")
+        print_json_or_exit(
+            console,
+            lambda: api_client.designer_production_price(production_order_id, phase),
+        )
+
+    @command(
+        app,
+        "designer",
+        "set",
+        "production-cart",
+        api="PUT /designer/production_orders/{production_order_id}/cart",
+        side_effects=["replaces the run's quantities; nothing is ordered until it is locked"],
+        approval="auto",
+        help=(
+            "PUT /designer/production_orders/{id}/cart — the quantity of every size and "
+            "colour on the run. Replaces the whole cart: pass every cell you want kept. "
+            "--qty repeats as 'SIZE,#RRGGBB=COUNT' (quote it: # starts a shell comment), "
+            "with the sizes and colour hex codes from "
+            "the order's available_sizes / available_colors (`designer list "
+            "production-order --product <id>`). Refused once the run is locked."
+        ),
+    )
+    def set_production_cart(
+        production_order_id: str = typer.Argument(..., help="Production order id."),
+        qty: list[str] = typer.Option(
+            ..., "--qty", help="SIZE,#RRGGBB=COUNT for one cell (repeat)."
+        ),
+    ) -> None:
+        """Set a production order's size x colour quantities."""
+        cart: dict[str, int] = {}
+        for cell in qty:
+            key, sep, count = cell.rpartition("=")
+            if not sep or "," not in key:
+                raise typer.BadParameter(f"--qty {cell!r}: expected SIZE,#RRGGBB=COUNT")
+            try:
+                n = int(count)
+            except ValueError as e:
+                raise typer.BadParameter(f"--qty {cell!r}: COUNT must be a whole number") from e
+            if n < 0:
+                raise typer.BadParameter(f"--qty {cell!r}: COUNT cannot be negative")
+            size, _, colour = key.partition(",")
+            cart[f"{size.strip()},{colour.strip()}"] = n
+        print_json_or_exit(
+            console,
+            lambda: api_client.designer_set_production_cart(production_order_id, cart),
+        )
+
+    @command(
+        app,
+        "designer",
+        "set",
+        "production-lock",
+        api="POST /designer/production_orders/{production_order_id}/configuration-lock",
+        side_effects=[
+            "places the order: the quantities are final and the deposit becomes payable",
+            "can be unlocked again until the deposit is paid",
+        ],
+        approval="ask",
+        help=(
+            "POST /designer/production_orders/{id}/configuration-lock — place the order "
+            "with the quantities on the run (--unlock to reopen them). Locking is what makes "
+            "the deposit payable: `designer create checkout --key "
+            "production:<id>:deposit --accept-terms`."
+        ),
+    )
+    def set_production_lock(
+        production_order_id: str = typer.Argument(..., help="Production order id."),
+        unlock: bool = typer.Option(False, "--unlock", help="Reopen the quantities instead."),
+    ) -> None:
+        """Lock (place) or unlock a production order's configuration."""
+        print_json_or_exit(
+            console,
+            lambda: api_client.designer_set_production_lock(production_order_id, not unlock),
+        )

{makea_cli-0.2.4 → makea_cli-0.2.6}/makea_cli/commands/orders/cmd.py

@@ -314,3 +314,66 @@ def register(app: typer.Typer) -> None:
                 offset=offset,
             ),
         )
+
+    @command(
+        app,
+        "admin",
+        "update",
+        "tracking-status",
+        api="POST /admin/tracking/carrier_status",
+        side_effects=[
+            "moves the order to delivered when the status says so",
+            "emails and messages the designer, supplier and admins as the 17track webhook did",
+        ],
+        approval="ask",
+        idempotent=True,
+        help=(
+            "POST /admin/tracking/carrier_status — apply a carrier status looked up by hand "
+            "(the tracking-sweep skill) to one order. Runs the 17track webhook path: status, "
+            "fan-out to every order sharing the number, and the delivered emails."
+        ),
+    )
+    def update_tracking_status(
+        kind: str = typer.Argument(
+            ...,
+            help="sampling | production | restock | shipping | material | reference_sample",
+        ),
+        order_id: str = typer.Argument(..., help="Order id (product id for reference_sample)."),
+        tracking_number: str = typer.Argument(..., help="The parcel's tracking number."),
+        status: str = typer.Option(
+            ..., "--status", help="17track status, e.g. Delivered, InTransit."
+        ),
+        sub_status: str | None = typer.Option(None, "--sub-status"),
+        event: str | None = typer.Option(None, "--event", help="Latest carrier event text."),
+        location: str | None = typer.Option(None, "--location"),
+        time_utc: str | None = typer.Option(
+            None, "--time", help="Latest event time, ISO 8601 UTC."
+        ),
+    ) -> None:
+        """
+        Tell Makea what the carrier says about one parcel.
+
+        Output: JSON from the webhook path: success, status, and one entry per
+        order the number was fanned out to. Repeating a Delivered update is a
+        no-op (no second email).
+        """
+        track_info = {
+            "latest_status": {"status": status, "sub_status": sub_status},
+            "latest_event": {
+                "description": event,
+                "location": location,
+                "time_utc": time_utc,
+            },
+        }
+        print_json_or_exit(
+            console,
+            lambda: api_client.post_json(
+                "/admin/tracking/carrier_status",
+                {
+                    "kind": kind,
+                    "order_id": order_id,
+                    "tracking_number": tracking_number,
+                    "track_info": track_info,
+                },
+            ),
+        )

{makea_cli-0.2.4 → makea_cli-0.2.6}/pyproject.toml

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

{makea_cli-0.2.4 → makea_cli-0.2.6}/tests/golden_manifest.json

@@ -3564,6 +3564,124 @@
         }
       ]
     },
+    {
+      "name": "admin update tracking-status",
+      "persona": "admin",
+      "verb": "update",
+      "noun": "tracking-status",
+      "access": "write",
+      "api": "POST /admin/tracking/carrier_status",
+      "external": null,
+      "side_effects": [
+        "moves the order to delivered when the status says so",
+        "emails and messages the designer, supplier and admins as the 17track webhook did"
+      ],
+      "approval": "ask",
+      "reversible": null,
+      "idempotent": true,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /admin/tracking/carrier_status — apply a carrier status looked up by hand (the tracking-sweep skill) to one order. Runs the 17track webhook path: status, fan-out to every order sharing the number, and the delivered emails.",
+      "function": "makea_cli.commands.orders.cmd.register.<locals>.update_tracking_status",
+      "flags": [
+        {
+          "name": "kind",
+          "kind": "argument",
+          "opts": [
+            "kind"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "sampling | production | restock | shipping | material | reference_sample"
+        },
+        {
+          "name": "order_id",
+          "kind": "argument",
+          "opts": [
+            "order_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Order id (product id for reference_sample)."
+        },
+        {
+          "name": "tracking_number",
+          "kind": "argument",
+          "opts": [
+            "tracking_number"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "The parcel's tracking number."
+        },
+        {
+          "name": "status",
+          "kind": "option",
+          "opts": [
+            "--status"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "17track status, e.g. Delivered, InTransit."
+        },
+        {
+          "name": "sub_status",
+          "kind": "option",
+          "opts": [
+            "--sub-status"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": null
+        },
+        {
+          "name": "event",
+          "kind": "option",
+          "opts": [
+            "--event"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Latest carrier event text."
+        },
+        {
+          "name": "location",
+          "kind": "option",
+          "opts": [
+            "--location"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": null
+        },
+        {
+          "name": "time_utc",
+          "kind": "option",
+          "opts": [
+            "--time"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Latest event time, ISO 8601 UTC."
+        }
+      ]
+    },
     {
       "name": "admin update user",
       "persona": "admin",
@@ -5201,6 +5319,49 @@
         }
       ]
     },
+    {
+      "name": "designer get production-price",
+      "persona": "designer",
+      "verb": "get",
+      "noun": "production-price",
+      "access": "read",
+      "api": "GET /designer/production_orders/{production_order_id}/calculate_price",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "GET /designer/production_orders/{id}/calculate_price — what the deposit (or the balance, --phase final) comes to for the quantities on the run right now, line by line.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.get_production_price",
+      "flags": [
+        {
+          "name": "production_order_id",
+          "kind": "argument",
+          "opts": [
+            "production_order_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Production order id."
+        },
+        {
+          "name": "phase",
+          "kind": "option",
+          "opts": [
+            "--phase"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": "deposit",
+          "help": "deposit or final."
+        }
+      ]
+    },
     {
       "name": "designer get quote-advice",
       "persona": "designer",
@@ -5739,6 +5900,97 @@
         }
       ]
     },
+    {
+      "name": "designer set production-cart",
+      "persona": "designer",
+      "verb": "set",
+      "noun": "production-cart",
+      "access": "write",
+      "api": "PUT /designer/production_orders/{production_order_id}/cart",
+      "external": null,
+      "side_effects": [
+        "replaces the run's quantities; nothing is ordered until it is locked"
+      ],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "PUT /designer/production_orders/{id}/cart — the quantity of every size and colour on the run. Replaces the whole cart: pass every cell you want kept. --qty repeats as 'SIZE,#RRGGBB=COUNT' (quote it: # starts a shell comment), with the sizes and colour hex codes from the order's available_sizes / available_colors (`designer list production-order --product <id>`). Refused once the run is locked.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.set_production_cart",
+      "flags": [
+        {
+          "name": "production_order_id",
+          "kind": "argument",
+          "opts": [
+            "production_order_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Production order id."
+        },
+        {
+          "name": "qty",
+          "kind": "option",
+          "opts": [
+            "--qty"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": true,
+          "default": null,
+          "help": "SIZE,#RRGGBB=COUNT for one cell (repeat)."
+        }
+      ]
+    },
+    {
+      "name": "designer set production-lock",
+      "persona": "designer",
+      "verb": "set",
+      "noun": "production-lock",
+      "access": "write",
+      "api": "POST /designer/production_orders/{production_order_id}/configuration-lock",
+      "external": null,
+      "side_effects": [
+        "places the order: the quantities are final and the deposit becomes payable",
+        "can be unlocked again until the deposit is paid"
+      ],
+      "approval": "ask",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /designer/production_orders/{id}/configuration-lock — place the order with the quantities on the run (--unlock to reopen them). Locking is what makes the deposit payable: `designer create checkout --key production:<id>:deposit --accept-terms`.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.set_production_lock",
+      "flags": [
+        {
+          "name": "production_order_id",
+          "kind": "argument",
+          "opts": [
+            "production_order_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Production order id."
+        },
+        {
+          "name": "unlock",
+          "kind": "option",
+          "opts": [
+            "--unlock"
+          ],
+          "type": "flag",
+          "required": false,
+          "multiple": false,
+          "default": false,
+          "help": "Reopen the quantities instead."
+        }
+      ]
+    },
     {
       "name": "designer submit production-order",
       "persona": "designer",

makea_cli-0.2.4/makea_cli/__init__.py

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