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

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

@@ -1,5 +1,18 @@
 # Changelog
 
+## 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.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.4
+Version: 0.2.5
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -157,6 +157,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 +174,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.5}/README.md

@@ -145,6 +145,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 +162,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.5/makea_cli/__init__.py

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

{makea_cli-0.2.4 → makea_cli-0.2.5}/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.5}/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.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "makea-cli"
-version = "0.2.4"
+version = "0.2.5"
 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.5}/tests/golden_manifest.json

@@ -5201,6 +5201,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 +5782,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"