makea-cli 0.2.24__tar.gz → 0.2.25__tar.gz

{makea_cli-0.2.24 → makea_cli-0.2.25}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.2.25
+
+New: `designer create proposal`, a tech-pack change as a card on the field it
+changes. Needs the backend from the same day
+(`/designer/products/{id}/tech_spec/proposals`).
+
+- Name the section and field as `designer get tech-pack --readable` shows them
+  (label or key). Pick a row with `--item "<a value it holds>"` or `--entry N`,
+  a line with `--was "<its text>"`; `--action add|delete` for a new row or a
+  cleared field. `--file` takes a JSON list for several changes at once.
+- It writes nothing into the pack: the user presses Apply on the card. A
+  refusal lists the sections, fields, rows or lines that exist.
+- Graded `auto`, so Beeboo runs it without a confirm button.
+
 ## 0.2.24
 
 Removed: `admin get revenue-metrics` (legacy `get-cumulative-payment-and-platform-revenue`).

{makea_cli-0.2.24 → makea_cli-0.2.25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.24
+Version: 0.2.25
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -210,6 +210,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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 create proposal` | write（auto） | `POST /designer/products/{product_id}/tech_spec/proposals` | propose a tech-pack change as a card on the field it changes; the user applies it. Name section/field as `get tech-pack --readable` shows them; --item / --entry pick a row, --was a line. | — |
 | `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-0.2.24 → makea_cli-0.2.25}/README.md

@@ -198,6 +198,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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 create proposal` | write（auto） | `POST /designer/products/{product_id}/tech_spec/proposals` | propose a tech-pack change as a card on the field it changes; the user applies it. Name section/field as `get tech-pack --readable` shows them; --item / --entry pick a row, --was a line. | — |
 | `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-0.2.25/makea_cli/__init__.py

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

{makea_cli-0.2.24 → makea_cli-0.2.25}/makea_cli/api_client.py

@@ -1734,6 +1734,13 @@ def designer_approve_proposal(note_id: str, proposal_id: str) -> Any:
     )
 
 
+def designer_create_proposals(product_id: str, proposals: list[dict[str, Any]]) -> Any:
+    """POST /designer/products/{id}/tech_spec/proposals — change cards on the tech pack."""
+    return post_json(
+        f"/designer/products/{product_id}/tech_spec/proposals", {"proposals": proposals}
+    )
+
+
 def designer_bulk_accept_actions(channel_id: str, actions: list[dict[str, str]]) -> Any:
     """POST /designer/channels/{id}/suggested_actions/bulk_accept — accept several at once."""
     return post_json(

{makea_cli-0.2.24 → makea_cli-0.2.25}/makea_cli/commands/brand/cmd.py

@@ -666,6 +666,90 @@ def register(app: typer.Typer) -> None:
         """Approve one assistant proposal."""
         print_json_or_exit(console, lambda: api_client.designer_approve_proposal(note, proposal_id))
 
+    @command(
+        app,
+        "designer",
+        "create",
+        "proposal",
+        api="POST /designer/products/{product_id}/tech_spec/proposals",
+        side_effects=[
+            "puts a change card on the tech pack; the pack changes only when the user applies it"
+        ],
+        approval="auto",
+        help=(
+            "POST /designer/products/{id}/tech_spec/proposals — propose a tech-pack change as a "
+            "card on the field it changes. Name the section and field as `get tech-pack "
+            "--readable` shows them; pick a row with --item (a value it holds) or --entry, a line "
+            "with --was. A refusal lists the sections, fields, rows or lines that exist. "
+            "--file takes a JSON list of the same keys for several changes at once."
+        ),
+    )
+    def create_proposal(
+        product: str = typer.Option(..., "--product", "-p", help="Product id."),
+        section: str | None = typer.Option(
+            None, "--section", help='Section, by label or key (e.g. "Trims & hardware").'
+        ),
+        field: str | None = typer.Option(
+            None, "--field", help="Field, by label or key (field-based packs)."
+        ),
+        value: str | None = typer.Option(None, "--value", help="The new value or line."),
+        reason: str | None = typer.Option(
+            None, "--reason", help="One line the user reads on the card."
+        ),
+        action: str = typer.Option(
+            "update", "--action", help="update (default), add (a new row or line) or delete."
+        ),
+        entry: int | None = typer.Option(
+            None, "--entry", help="Row number in a repeating section, 0 = first."
+        ),
+        item: str | None = typer.Option(
+            None, "--item", help='Pick the row that holds this value now (e.g. "cord lock").'
+        ),
+        was: str | None = typer.Option(
+            None, "--was", help="Current text of the line to change (line-based packs)."
+        ),
+        kind: str | None = typer.Option(
+            None, "--kind", help="For a new line: spec (default) or note."
+        ),
+        replaces: list[str] = typer.Option(
+            [], "--replaces", help="line_id a new line replaces (repeat)."
+        ),
+        document: list[str] = typer.Option(
+            [], "--document", help="document_id the change comes from (repeat)."
+        ),
+        file: Path | None = typer.Option(
+            None,
+            "--file",
+            "-f",
+            exists=True,
+            dir_okay=False,
+            help="JSON list of proposals with the keys above, instead of the flags.",
+        ),
+    ) -> None:
+        """Propose tech-pack changes."""
+        if file is not None:
+            items = json.loads(file.read_text(encoding="utf-8"))
+            if not isinstance(items, list):
+                raise typer.BadParameter("--file must hold a JSON list of proposals")
+        else:
+            if not section or not reason:
+                raise typer.BadParameter("--section and --reason are required (or --file)")
+            one: dict[str, Any] = {
+                "section": section,
+                "field": field,
+                "value": value,
+                "reason": reason,
+                "action": action,
+                "entry": entry,
+                "item": item,
+                "was": was,
+                "kind": kind,
+                "replaces": replaces or None,
+                "documents": document or None,
+            }
+            items = [{k: v for k, v in one.items() if v is not None}]
+        print_json_or_exit(console, lambda: api_client.designer_create_proposals(product, items))
+
     @command(
         app,
         "designer",

{makea_cli-0.2.24 → makea_cli-0.2.25}/pyproject.toml

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

{makea_cli-0.2.24 → makea_cli-0.2.25}/tests/golden_manifest.json

@@ -7079,6 +7079,185 @@
         }
       ]
     },
+    {
+      "name": "designer create proposal",
+      "persona": "designer",
+      "verb": "create",
+      "noun": "proposal",
+      "access": "write",
+      "api": "POST /designer/products/{product_id}/tech_spec/proposals",
+      "external": null,
+      "side_effects": [
+        "puts a change card on the tech pack; the pack changes only when the user applies it"
+      ],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /designer/products/{id}/tech_spec/proposals — propose a tech-pack change as a card on the field it changes. Name the section and field as `get tech-pack --readable` shows them; pick a row with --item (a value it holds) or --entry, a line with --was. A refusal lists the sections, fields, rows or lines that exist. --file takes a JSON list of the same keys for several changes at once.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.create_proposal",
+      "flags": [
+        {
+          "name": "product",
+          "kind": "option",
+          "opts": [
+            "--product",
+            "-p"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Product id."
+        },
+        {
+          "name": "section",
+          "kind": "option",
+          "opts": [
+            "--section"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Section, by label or key (e.g. \"Trims & hardware\")."
+        },
+        {
+          "name": "field",
+          "kind": "option",
+          "opts": [
+            "--field"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Field, by label or key (field-based packs)."
+        },
+        {
+          "name": "value",
+          "kind": "option",
+          "opts": [
+            "--value"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "The new value or line."
+        },
+        {
+          "name": "reason",
+          "kind": "option",
+          "opts": [
+            "--reason"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "One line the user reads on the card."
+        },
+        {
+          "name": "action",
+          "kind": "option",
+          "opts": [
+            "--action"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": "update",
+          "help": "update (default), add (a new row or line) or delete."
+        },
+        {
+          "name": "entry",
+          "kind": "option",
+          "opts": [
+            "--entry"
+          ],
+          "type": "integer",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Row number in a repeating section, 0 = first."
+        },
+        {
+          "name": "item",
+          "kind": "option",
+          "opts": [
+            "--item"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Pick the row that holds this value now (e.g. \"cord lock\")."
+        },
+        {
+          "name": "was",
+          "kind": "option",
+          "opts": [
+            "--was"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Current text of the line to change (line-based packs)."
+        },
+        {
+          "name": "kind",
+          "kind": "option",
+          "opts": [
+            "--kind"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "For a new line: spec (default) or note."
+        },
+        {
+          "name": "replaces",
+          "kind": "option",
+          "opts": [
+            "--replaces"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": true,
+          "default": [],
+          "help": "line_id a new line replaces (repeat)."
+        },
+        {
+          "name": "document",
+          "kind": "option",
+          "opts": [
+            "--document"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": true,
+          "default": [],
+          "help": "document_id the change comes from (repeat)."
+        },
+        {
+          "name": "file",
+          "kind": "option",
+          "opts": [
+            "--file",
+            "-f"
+          ],
+          "type": "file",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "JSON list of proposals with the keys above, instead of the flags."
+        }
+      ]
+    },
     {
       "name": "designer create quote-award",
       "persona": "designer",

makea_cli-0.2.24/makea_cli/__init__.py

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