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

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

@@ -1,5 +1,25 @@
 # 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`).
+The backend endpoint is gone; it was never the reconciled figure. Use
+`admin get growth-snapshot` for platform money.
+
 ## 0.2.23
 
 New: Growth Analysis snapshots, the numbers on admin Metrics. Needs the

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.23
+Version: 0.2.25
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -119,7 +119,6 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get playbook-preview` | read | `GET /admin/playbook/preview` | the playbook block one AI surface would get for a person or factory, and every rule left out with its reason; --product previews a conversation about one product, --rule answers for one rule. | — |
 | `makea-cli admin get production-pricing` | read | `GET /admin/production_orders/{id}/details` | show a production order's price tiers, MOQ, sizes/colours, pricing groups and cart coverage. | `production-pricing-show` |
 | `makea-cli admin get quote-request` | read | `GET /admin/quote_requests/{quote_request_id}` | one quote request in full. | — |
-| `makea-cli admin get revenue-metrics` | read | `GET /admin/business-metrics/cumulative-payment-and-platform-revenue` | platform-wide payment received and platform revenue (service fee + transaction fee) bucketed over a date range. | `get-cumulative-payment-and-platform-revenue` |
 | `makea-cli admin get rule` | read | `GET /admin/playbook/{target}/rules/{rule_id}` | one rule in full (`--user` / `--supplier` / `--global`), with its evidence: where it came from, who changed it and why. | — |
 | `makea-cli admin get rule-history` | read | `GET /admin/playbook/rules/{rule_id}/history` | every revision of one rule: its words, who changed it and why, and the rule that replaced it. | — |
 | `makea-cli admin get shipping-order` | read | `GET /admin/shipping_orders/{shipping_order_id}/details` | one shipment with its production and sampling orders, freight quotes, fees, tracking and address. | — |
@@ -211,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.23 → makea_cli-0.2.25}/README.md

@@ -107,7 +107,6 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get playbook-preview` | read | `GET /admin/playbook/preview` | the playbook block one AI surface would get for a person or factory, and every rule left out with its reason; --product previews a conversation about one product, --rule answers for one rule. | — |
 | `makea-cli admin get production-pricing` | read | `GET /admin/production_orders/{id}/details` | show a production order's price tiers, MOQ, sizes/colours, pricing groups and cart coverage. | `production-pricing-show` |
 | `makea-cli admin get quote-request` | read | `GET /admin/quote_requests/{quote_request_id}` | one quote request in full. | — |
-| `makea-cli admin get revenue-metrics` | read | `GET /admin/business-metrics/cumulative-payment-and-platform-revenue` | platform-wide payment received and platform revenue (service fee + transaction fee) bucketed over a date range. | `get-cumulative-payment-and-platform-revenue` |
 | `makea-cli admin get rule` | read | `GET /admin/playbook/{target}/rules/{rule_id}` | one rule in full (`--user` / `--supplier` / `--global`), with its evidence: where it came from, who changed it and why. | — |
 | `makea-cli admin get rule-history` | read | `GET /admin/playbook/rules/{rule_id}/history` | every revision of one rule: its words, who changed it and why, and the rule that replaced it. | — |
 | `makea-cli admin get shipping-order` | read | `GET /admin/shipping_orders/{shipping_order_id}/details` | one shipment with its production and sampling orders, freight quotes, fees, tracking and address. | — |
@@ -199,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.23 → makea_cli-0.2.25}/makea_cli/api_client.py

@@ -907,32 +907,6 @@ def update_production_order_details(
     )
 
 
-def get_cumulative_payment_and_platform_revenue(
-    *,
-    start_date: str,
-    end_date: str,
-    granularity: str | None = None,
-    currency: str | None = None,
-    order_type: str | None = None,
-) -> Any:
-    """
-    GET /admin/business-metrics/cumulative-payment-and-platform-revenue —
-    platform-wide cumulative payment received and platform revenue (service fee +
-    transaction fee) within a date range, bucketed by day/week/month.
-    """
-    params: dict[str, Any] = {"start_date": start_date, "end_date": end_date}
-    if granularity is not None:
-        params["granularity"] = granularity
-    if currency is not None:
-        params["currency"] = currency
-    if order_type is not None:
-        params["order_type"] = order_type
-    return get_json(
-        "/admin/business-metrics/cumulative-payment-and-platform-revenue",
-        params=params,
-    )
-
-
 def list_growth_snapshots() -> Any:
     """GET /admin/growth/snapshots — published Growth Analysis snapshots, newest first."""
     return get_json("/admin/growth/snapshots")
@@ -1760,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.23 → 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.23 → makea_cli-0.2.25}/makea_cli/commands/metrics/cmd.py

@@ -14,96 +14,8 @@ from makea_cli.commands._util import print_json_or_exit
 
 console = Console()
 
-_GRANULARITIES = ("day", "week", "month")
-_ORDER_TYPES = ("all", "sampling", "production")
-
 
 def register(app: typer.Typer) -> None:
-    @command(
-        app,
-        "admin",
-        "get",
-        "revenue-metrics",
-        legacy="get-cumulative-payment-and-platform-revenue",
-        api="GET /admin/business-metrics/cumulative-payment-and-platform-revenue",
-        help=(
-            "GET /admin/business-metrics/cumulative-payment-and-platform-revenue — "
-            "platform-wide payment received and platform revenue (service fee + "
-            "transaction fee) bucketed over a date range."
-        ),
-    )
-    def get_cumulative_payment_and_platform_revenue(
-        start_date: str = typer.Option(
-            ...,
-            "--start-date",
-            help="Start date (inclusive), ISO format YYYY-MM-DD.",
-        ),
-        end_date: str = typer.Option(
-            ...,
-            "--end-date",
-            help="End date (inclusive), ISO format YYYY-MM-DD.",
-        ),
-        granularity: str = typer.Option(
-            "day",
-            "--granularity",
-            "-g",
-            help="Time bucket: day, week, or month. Default: day.",
-        ),
-        currency: str = typer.Option(
-            "GBP",
-            "--currency",
-            "-c",
-            help="Target currency for conversion. Default: GBP.",
-        ),
-        order_type: str = typer.Option(
-            "all",
-            "--order-type",
-            "-t",
-            help="Filter: all, sampling, or production. Default: all.",
-        ),
-    ) -> None:
-        """
-        Platform-wide cumulative payment received and platform revenue over a date range.
-
-        Calls GET /admin/business-metrics/cumulative-payment-and-platform-revenue.
-
-        Platform revenue = service fee + transaction fee (the 2.8% transaction fee is
-        applied by the server). The response contains two siblings under ``result``:
-
-        - ``payment_received``: cumulative/period amounts per bucket, plus a
-          ``payment_breakdown`` (sampling / production_deposit / production_final).
-        - ``platform_revenue``: cumulative/period amounts per bucket.
-
-        Input: required --start-date and --end-date (YYYY-MM-DD); optional
-        --granularity (day|week|month), --currency, --order-type (all|sampling|production).
-
-        Output: raw JSON body from the admin business-metrics endpoint.
-
-        This endpoint is **platform-wide only** and does not support filtering by
-        user_id, product, or category. For per-user / per-product drill-downs, use
-        admin list product-order / admin list sampling-order --product /
-        admin list production-order --product and aggregate client-side.
-        """
-        g = granularity.strip().lower()
-        if g not in _GRANULARITIES:
-            console.print(f"[red]--granularity must be one of: {', '.join(_GRANULARITIES)}.[/red]")
-            raise typer.Exit(1)
-        ot = order_type.strip().lower()
-        if ot not in _ORDER_TYPES:
-            console.print(f"[red]--order-type must be one of: {', '.join(_ORDER_TYPES)}.[/red]")
-            raise typer.Exit(1)
-
-        print_json_or_exit(
-            console,
-            lambda: api_client.get_cumulative_payment_and_platform_revenue(
-                start_date=start_date,
-                end_date=end_date,
-                granularity=g,
-                currency=currency,
-                order_type=ot,
-            ),
-        )
-
     @command(
         app,
         "admin",

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "makea-cli"
-version = "0.2.23"
+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.23 → makea_cli-0.2.25}/tests/golden_manifest.json

@@ -2342,90 +2342,6 @@
         }
       ]
     },
-    {
-      "name": "admin get revenue-metrics",
-      "persona": "admin",
-      "verb": "get",
-      "noun": "revenue-metrics",
-      "access": "read",
-      "api": "GET /admin/business-metrics/cumulative-payment-and-platform-revenue",
-      "external": null,
-      "side_effects": [],
-      "approval": "auto",
-      "reversible": null,
-      "idempotent": null,
-      "limit": null,
-      "legacy": [
-        "get-cumulative-payment-and-platform-revenue"
-      ],
-      "help": "GET /admin/business-metrics/cumulative-payment-and-platform-revenue — platform-wide payment received and platform revenue (service fee + transaction fee) bucketed over a date range.",
-      "function": "makea_cli.commands.metrics.cmd.register.<locals>.get_cumulative_payment_and_platform_revenue",
-      "flags": [
-        {
-          "name": "start_date",
-          "kind": "option",
-          "opts": [
-            "--start-date"
-          ],
-          "type": "text",
-          "required": true,
-          "multiple": false,
-          "default": null,
-          "help": "Start date (inclusive), ISO format YYYY-MM-DD."
-        },
-        {
-          "name": "end_date",
-          "kind": "option",
-          "opts": [
-            "--end-date"
-          ],
-          "type": "text",
-          "required": true,
-          "multiple": false,
-          "default": null,
-          "help": "End date (inclusive), ISO format YYYY-MM-DD."
-        },
-        {
-          "name": "granularity",
-          "kind": "option",
-          "opts": [
-            "--granularity",
-            "-g"
-          ],
-          "type": "text",
-          "required": false,
-          "multiple": false,
-          "default": "day",
-          "help": "Time bucket: day, week, or month. Default: day."
-        },
-        {
-          "name": "currency",
-          "kind": "option",
-          "opts": [
-            "--currency",
-            "-c"
-          ],
-          "type": "text",
-          "required": false,
-          "multiple": false,
-          "default": "GBP",
-          "help": "Target currency for conversion. Default: GBP."
-        },
-        {
-          "name": "order_type",
-          "kind": "option",
-          "opts": [
-            "--order-type",
-            "-t"
-          ],
-          "type": "text",
-          "required": false,
-          "multiple": false,
-          "default": "all",
-          "help": "Filter: all, sampling, or production. Default: all."
-        }
-      ]
-    },
     {
       "name": "admin get rule",
       "persona": "admin",
@@ -7163,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.23 → makea_cli-0.2.25}/uv.lock

@@ -115,7 +115,7 @@ wheels = [
 
 [[package]]
 name = "makea-cli"
-version = "0.2.21"
+version = "0.2.24"
 source = { editable = "." }
 dependencies = [
     { name = "click" },

makea_cli-0.2.23/makea_cli/__init__.py

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