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

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

@@ -1,5 +1,27 @@
 # Changelog
 
+## 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
+backend from the same day (`/admin/growth/snapshots`).
+
+- `admin upload growth-snapshot --analysis … --derived … --audit … --forecast …
+  --review … --rule-version …` (or `--sources one.json`): publish a reconciled
+  snapshot. The server runs the ten publication gates (Stripe allocations
+  checked against live Stripe) and refuses a snapshot that fails any of them.
+  `--check` runs the gates without publishing. A snapshot id is written once;
+  publish a correction under a new id such as `2026-10-26.b`.
+- `admin list growth-snapshot`: every published snapshot, newest first.
+- `admin get growth-snapshot [ID|latest] [--block NAME]`: one snapshot, or one
+  block of it. Audited actuals (`ledger`) and Booked GMV (`forecast`) are
+  separate blocks; never add one to the other.
+
 ## 0.2.22
 
 New: what the brand reads under a rule, and its card name. Needs the backend

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.22
+Version: 0.2.24
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -114,11 +114,11 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get analytics-query` | read | `POST /admin/analytics/query` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
 | `makea-cli admin get currency-conversion` | read | `GET /admin/fx/rates` | the platform's own exchange rates and rounding (rate table for several --from; one --from with --amount converts it). | `convert-currency` |
 | `makea-cli admin get feature-usage` | read | `POST /admin/analytics/query` | How many distinct users used a feature recently, plus event volume. Matches $pageview path and feature_time_spent eve… | `analytics-feature-usage` |
+| `makea-cli admin get growth-snapshot` | read | `GET /admin/growth/snapshots/{id}` | one reconciled Growth Analysis snapshot (default `latest`); `--block` prints one block (headline, gates, review_items, …). | — |
 | `makea-cli admin get library-schema` | read | `GET /admin/library_components/schema` | the tech-pack library taxonomy: sections and their library-role field keys (run this before create/update). | `library-schema` |
 | `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. | — |
@@ -128,6 +128,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get top-clicks` | read | `POST /admin/analytics/query` | which buttons/elements get clicked most. | `analytics-top-clicks` |
 | `makea-cli admin get top-features` | read | `POST /admin/analytics/query` | a quick map of which features get used most. | `analytics-top-features` |
 | `makea-cli admin list library-element` | read | `GET /admin/designer/{user_id}/library_components` | list a designer's tech-pack library (org-fanned). Optional --section scopes to one type. | `library-list` |
+| `makea-cli admin list growth-snapshot` | read | `GET /admin/growth/snapshots` | published Growth Analysis snapshots, newest first (the change log). | — |
 | `makea-cli admin list misc-payment` | read | `GET /admin/products/{id}/misc-payments` | misc payments for one product (admin). | `list-misc-payments-by-product` |
 | `makea-cli admin list product-order` | read | `GET /admin/designer/get_all_product_orders` | designer product (SKU) list. For 大货 use admin list production-order or admin list production-order --product. | `list-product-orders` |
 | `makea-cli admin list production-order` | read | `GET /admin/production_orders?type=PRODUCTION` | 大货 (production) orders only. For restock use admin list restock-order; for shipping use admin list shipping-order. | `list-all-production-orders` |
@@ -158,6 +159,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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: status, fan-out, delivered emails (--silent: state only). | — |
 | `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 growth-snapshot` | write（ask） | `POST /admin/growth/snapshots` | publish a reconciled snapshot to admin Metrics; the server runs the ten gates and refuses a failure; `--check` gates only. | — |
 | `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` |
 | `makea-cli admin upload product-document` | write（auto） | `POST /admin/designer/upload_document` | upload a file to AWS S3 under a product and return document domain metadata for reuse by other commands. | `upload-product-document` |
 | `makea-cli admin upload production-order-document` | write（auto） | `POST /admin/production_orders/{production_order_id}/documents` | upload a file to AWS S3 for a production order and return document domain metadata. | `upload-production-order-document` |

{makea_cli-0.2.22 → makea_cli-0.2.24}/README.md

@@ -102,11 +102,11 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get analytics-query` | read | `POST /admin/analytics/query` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
 | `makea-cli admin get currency-conversion` | read | `GET /admin/fx/rates` | the platform's own exchange rates and rounding (rate table for several --from; one --from with --amount converts it). | `convert-currency` |
 | `makea-cli admin get feature-usage` | read | `POST /admin/analytics/query` | How many distinct users used a feature recently, plus event volume. Matches $pageview path and feature_time_spent eve… | `analytics-feature-usage` |
+| `makea-cli admin get growth-snapshot` | read | `GET /admin/growth/snapshots/{id}` | one reconciled Growth Analysis snapshot (default `latest`); `--block` prints one block (headline, gates, review_items, …). | — |
 | `makea-cli admin get library-schema` | read | `GET /admin/library_components/schema` | the tech-pack library taxonomy: sections and their library-role field keys (run this before create/update). | `library-schema` |
 | `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. | — |
@@ -116,6 +116,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get top-clicks` | read | `POST /admin/analytics/query` | which buttons/elements get clicked most. | `analytics-top-clicks` |
 | `makea-cli admin get top-features` | read | `POST /admin/analytics/query` | a quick map of which features get used most. | `analytics-top-features` |
 | `makea-cli admin list library-element` | read | `GET /admin/designer/{user_id}/library_components` | list a designer's tech-pack library (org-fanned). Optional --section scopes to one type. | `library-list` |
+| `makea-cli admin list growth-snapshot` | read | `GET /admin/growth/snapshots` | published Growth Analysis snapshots, newest first (the change log). | — |
 | `makea-cli admin list misc-payment` | read | `GET /admin/products/{id}/misc-payments` | misc payments for one product (admin). | `list-misc-payments-by-product` |
 | `makea-cli admin list product-order` | read | `GET /admin/designer/get_all_product_orders` | designer product (SKU) list. For 大货 use admin list production-order or admin list production-order --product. | `list-product-orders` |
 | `makea-cli admin list production-order` | read | `GET /admin/production_orders?type=PRODUCTION` | 大货 (production) orders only. For restock use admin list restock-order; for shipping use admin list shipping-order. | `list-all-production-orders` |
@@ -146,6 +147,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `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: status, fan-out, delivered emails (--silent: state only). | — |
 | `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 growth-snapshot` | write（ask） | `POST /admin/growth/snapshots` | publish a reconciled snapshot to admin Metrics; the server runs the ten gates and refuses a failure; `--check` gates only. | — |
 | `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` |
 | `makea-cli admin upload product-document` | write（auto） | `POST /admin/designer/upload_document` | upload a file to AWS S3 under a product and return document domain metadata for reuse by other commands. | `upload-product-document` |
 | `makea-cli admin upload production-order-document` | write（auto） | `POST /admin/production_orders/{production_order_id}/documents` | upload a file to AWS S3 for a production order and return document domain metadata. | `upload-production-order-document` |

makea_cli-0.2.24/makea_cli/__init__.py

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

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

@@ -907,30 +907,25 @@ 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:
+def list_growth_snapshots() -> Any:
+    """GET /admin/growth/snapshots — published Growth Analysis snapshots, newest first."""
+    return get_json("/admin/growth/snapshots")
+
+
+def get_growth_snapshot(snapshot_id: str = "latest") -> Any:
+    """GET /admin/growth/snapshots/{id|latest} — one snapshot, every block of it."""
+    return get_json(f"/admin/growth/snapshots/{quote(snapshot_id, safe='')}", timeout=120.0)
+
+
+def import_growth_snapshot(sources_path: Path, *, check_only: bool = False) -> Any:
+    """POST /admin/growth/snapshots — gate and publish one reconciled snapshot.
+
+    Sent as a file part, not a JSON body: the server caps an in-memory body at
+    2.5MB and a snapshot with a long forecast passes that. ``check_only`` runs
+    the gates without publishing (``?dry_run=1``).
     """
-    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,
-    )
+    path = "/admin/growth/snapshots" + ("?dry_run=1" if check_only else "")
+    return post_multipart_with_file(path, file_path=sources_path, timeout=300.0)
 
 
 def get_fx_rates(*, to: str, sources: list[str], amount: float | None = None) -> Any:

makea_cli-0.2.24/makea_cli/commands/metrics/cmd.py

@@ -0,0 +1,227 @@
+from __future__ import annotations
+
+import json
+import tempfile
+from pathlib import Path
+
+import typer
+from rich.console import Console
+
+from makea_cli.registry import command
+
+from makea_cli import api_client
+from makea_cli.commands._util import print_json_or_exit
+
+console = Console()
+
+
+def register(app: typer.Typer) -> None:
+    @command(
+        app,
+        "admin",
+        "get",
+        "currency-conversion",
+        legacy="convert-currency",
+        api="GET /admin/fx/rates",
+        help=(
+            "GET /admin/fx/rates — convert money between currencies at the "
+            "platform's own rates and rounding, so totals reconcile with its "
+            "prices and revenue metrics. Pass several source currencies via --from "
+            "(comma-separated) to get a full rate table in one call, then convert "
+            "locally — avoids repeated lookups."
+        ),
+    )
+    def convert_currency(
+        to: str = typer.Option(..., "--to", "-t", help="Target currency, e.g. GBP."),
+        from_: str = typer.Option(
+            ...,
+            "--from",
+            "-f",
+            help="Source currency code, or comma-separated list (e.g. usd,eur,cny,gbp).",
+        ),
+        amount: float = typer.Option(
+            None,
+            "--amount",
+            "-a",
+            help="Optional amount to convert (only meaningful with a single --from).",
+        ),
+    ) -> None:
+        """Return source->target rates, and optionally a converted amount, as the
+        platform computes them.
+
+        Use it to collapse a mixed-currency set into one currency: collect the
+        distinct currencies, call once with --from a,b,c to get every rate, then
+        multiply locally. The rates are the platform's (FreeCurrencyService,
+        rounded up to ``rate_decimals``) and come from the backend rather than
+        being fetched and rounded here, so they cannot drift from it.
+
+        Output JSON: {"to", "rates": {CUR: rate, ...}, "rate_decimals",
+        "rounding", "source", "unavailable"} plus {"from", "rate", "amount",
+        "converted"} when a single --from and --amount are given; "converted" is
+        the platform's own conversion, rounding included. A currency with no
+        rate fails the command rather than coming back null.
+        """
+        sources = [s.strip() for s in from_.split(",") if s.strip()]
+        if not sources:
+            console.print("[red]--from must contain at least one currency code.[/red]")
+            raise typer.Exit(1)
+
+        def _do() -> dict:
+            payload = api_client.get_fx_rates(
+                to=to,
+                sources=sources,
+                amount=amount if len(sources) == 1 else None,
+            )
+            out = (payload or {}).get("result") or {}
+            if out.get("unavailable"):
+                raise RuntimeError(
+                    "FX rate unavailable: "
+                    + ", ".join(f"{s}->{to.upper()}" for s in out["unavailable"])
+                )
+            return out
+
+        print_json_or_exit(console, _do)
+
+    @command(
+        app,
+        "admin",
+        "list",
+        "growth-snapshot",
+        api="GET /admin/growth/snapshots",
+        help=(
+            "GET /admin/growth/snapshots — published Growth Analysis snapshots "
+            "(Metrics page), newest first, with cut-off, rule version, audit "
+            "status and headline GMV/revenue."
+        ),
+    )
+    def list_growth_snapshots() -> None:
+        """Every published snapshot's index entry. Snapshots are immutable; a
+        correction is a new id, so this list is also the change log."""
+        print_json_or_exit(console, api_client.list_growth_snapshots)
+
+    @command(
+        app,
+        "admin",
+        "get",
+        "growth-snapshot",
+        api="GET /admin/growth/snapshots/{id}",
+        help=(
+            "GET /admin/growth/snapshots/{id|latest} — one reconciled snapshot: "
+            "headline, economics, monthly, customers, ledger, suppliers, forecast, "
+            "gates and review items."
+        ),
+    )
+    def get_growth_snapshot(
+        snapshot_id: str = typer.Argument("latest", help="Snapshot id, or latest."),
+        block: str = typer.Option(
+            None,
+            "--block",
+            "-b",
+            help="Print only one block, e.g. headline, gates, review_items, economics.",
+        ),
+    ) -> None:
+        """Audited actuals and Booked GMV live in separate blocks (``ledger`` vs
+        ``forecast``); never add one to the other."""
+
+        def _do():
+            snapshot = (api_client.get_growth_snapshot(snapshot_id) or {}).get("snapshot") or {}
+            if block:
+                if block not in snapshot:
+                    raise RuntimeError(f"No block {block!r}. Blocks: {', '.join(sorted(snapshot))}")
+                return snapshot[block]
+            return snapshot
+
+        print_json_or_exit(console, _do)
+
+    @command(
+        app,
+        "admin",
+        "upload",
+        "growth-snapshot",
+        api="POST /admin/growth/snapshots",
+        side_effects=[],
+        approval="ask",
+        reversible=False,
+        help=(
+            "POST /admin/growth/snapshots — publish a reconciled Growth Analysis "
+            "snapshot to the Metrics page. The server runs the ten publication "
+            "gates and refuses anything that fails; --check runs them without "
+            "publishing."
+        ),
+    )
+    def upload_growth_snapshot(
+        analysis: Path = typer.Option(
+            None,
+            "--analysis",
+            help="analysis_data.json (headline, fx, monthly, customers, orders, ...).",
+        ),
+        derived: Path = typer.Option(
+            None, "--derived", help="derived_metrics.json (AOV, supplier populations)."
+        ),
+        audit: Path = typer.Option(
+            None, "--audit", help="audit_checks.json (source pipeline assertions)."
+        ),
+        forecast: Path = typer.Option(
+            None, "--forecast", help="projection_data.json (Booked GMV)."
+        ),
+        review: Path = typer.Option(
+            None,
+            "--review",
+            help="JSON list of review items; an open item needs accepted_open: true to pass.",
+        ),
+        rule_version: str = typer.Option(
+            None, "--rule-version", help="The rule set these numbers follow."
+        ),
+        snapshot_id: str = typer.Option(
+            None,
+            "--snapshot-id",
+            help="Defaults to the cut-off date; suffix a correction, e.g. 2026-10-26.b.",
+        ),
+        fx_basis: str = typer.Option(None, "--fx-basis", help="e.g. 'ECB reference, 31 Jul 2026'."),
+        note: str = typer.Option(None, "--note", help="What changed since the previous snapshot."),
+        sources: Path = typer.Option(
+            None,
+            "--sources",
+            help="One prebuilt JSON holding every block; replaces the file options.",
+        ),
+        check: bool = typer.Option(False, "--check", help="Run the gates only; publish nothing."),
+    ) -> None:
+        """Publish once per refresh. An id is written once: a correction is a new
+        snapshot, and the previous one stays readable for comparison.
+
+        Output: {"published", "entry", "gates"}. A failed gate exits 4 with every
+        gate and its detail, and nothing is stored.
+        """
+
+        def _load(path: Path | None):
+            if path is None:
+                return None
+            return json.loads(path.read_text(encoding="utf-8"))
+
+        def _do():
+            if sources is not None:
+                body = _load(sources)
+            else:
+                if analysis is None or not rule_version:
+                    raise RuntimeError("Pass --sources, or --analysis with --rule-version.")
+                body = {
+                    "analysis": _load(analysis),
+                    "derived": _load(derived) or {},
+                    "audit": _load(audit) or {},
+                    "forecast": _load(forecast) or {},
+                    "review_items": _load(review) or [],
+                }
+            for key, value in (
+                ("rule_version", rule_version),
+                ("snapshot_id", snapshot_id),
+                ("fx_basis", fx_basis),
+                ("note", note),
+            ):
+                if value:
+                    body[key] = value
+            with tempfile.TemporaryDirectory() as tmp:
+                path = Path(tmp) / "growth_snapshot.json"
+                path.write_text(json.dumps(body, ensure_ascii=False), encoding="utf-8")
+                return api_client.import_growth_snapshot(path, check_only=check)
+
+        print_json_or_exit(console, _do)

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

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

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

@@ -2107,6 +2107,50 @@
         }
       ]
     },
+    {
+      "name": "admin get growth-snapshot",
+      "persona": "admin",
+      "verb": "get",
+      "noun": "growth-snapshot",
+      "access": "read",
+      "api": "GET /admin/growth/snapshots/{id}",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "GET /admin/growth/snapshots/{id|latest} — one reconciled snapshot: headline, economics, monthly, customers, ledger, suppliers, forecast, gates and review items.",
+      "function": "makea_cli.commands.metrics.cmd.register.<locals>.get_growth_snapshot",
+      "flags": [
+        {
+          "name": "snapshot_id",
+          "kind": "argument",
+          "opts": [
+            "snapshot_id"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": "latest",
+          "help": "Snapshot id, or latest."
+        },
+        {
+          "name": "block",
+          "kind": "option",
+          "opts": [
+            "--block",
+            "-b"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Print only one block, e.g. headline, gates, review_items, economics."
+        }
+      ]
+    },
     {
       "name": "admin get library-schema",
       "persona": "admin",
@@ -2298,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",
@@ -2703,6 +2663,24 @@
         }
       ]
     },
+    {
+      "name": "admin list growth-snapshot",
+      "persona": "admin",
+      "verb": "list",
+      "noun": "growth-snapshot",
+      "access": "read",
+      "api": "GET /admin/growth/snapshots",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": "client",
+      "legacy": [],
+      "help": "GET /admin/growth/snapshots — published Growth Analysis snapshots (Metrics page), newest first, with cut-off, rule version, audit status and headline GMV/revenue.",
+      "function": "makea_cli.commands.metrics.cmd.register.<locals>.list_growth_snapshots",
+      "flags": []
+    },
     {
       "name": "admin list library-element",
       "persona": "admin",
@@ -6079,6 +6057,157 @@
         }
       ]
     },
+    {
+      "name": "admin upload growth-snapshot",
+      "persona": "admin",
+      "verb": "upload",
+      "noun": "growth-snapshot",
+      "access": "write",
+      "api": "POST /admin/growth/snapshots",
+      "external": null,
+      "side_effects": [],
+      "approval": "ask",
+      "reversible": false,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /admin/growth/snapshots — publish a reconciled Growth Analysis snapshot to the Metrics page. The server runs the ten publication gates and refuses anything that fails; --check runs them without publishing.",
+      "function": "makea_cli.commands.metrics.cmd.register.<locals>.upload_growth_snapshot",
+      "flags": [
+        {
+          "name": "analysis",
+          "kind": "option",
+          "opts": [
+            "--analysis"
+          ],
+          "type": "path",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "analysis_data.json (headline, fx, monthly, customers, orders, ...)."
+        },
+        {
+          "name": "derived",
+          "kind": "option",
+          "opts": [
+            "--derived"
+          ],
+          "type": "path",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "derived_metrics.json (AOV, supplier populations)."
+        },
+        {
+          "name": "audit",
+          "kind": "option",
+          "opts": [
+            "--audit"
+          ],
+          "type": "path",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "audit_checks.json (source pipeline assertions)."
+        },
+        {
+          "name": "forecast",
+          "kind": "option",
+          "opts": [
+            "--forecast"
+          ],
+          "type": "path",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "projection_data.json (Booked GMV)."
+        },
+        {
+          "name": "review",
+          "kind": "option",
+          "opts": [
+            "--review"
+          ],
+          "type": "path",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "JSON list of review items; an open item needs accepted_open: true to pass."
+        },
+        {
+          "name": "rule_version",
+          "kind": "option",
+          "opts": [
+            "--rule-version"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "The rule set these numbers follow."
+        },
+        {
+          "name": "snapshot_id",
+          "kind": "option",
+          "opts": [
+            "--snapshot-id"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Defaults to the cut-off date; suffix a correction, e.g. 2026-10-26.b."
+        },
+        {
+          "name": "fx_basis",
+          "kind": "option",
+          "opts": [
+            "--fx-basis"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "e.g. 'ECB reference, 31 Jul 2026'."
+        },
+        {
+          "name": "note",
+          "kind": "option",
+          "opts": [
+            "--note"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "What changed since the previous snapshot."
+        },
+        {
+          "name": "sources",
+          "kind": "option",
+          "opts": [
+            "--sources"
+          ],
+          "type": "path",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "One prebuilt JSON holding every block; replaces the file options."
+        },
+        {
+          "name": "check",
+          "kind": "option",
+          "opts": [
+            "--check"
+          ],
+          "type": "flag",
+          "required": false,
+          "multiple": false,
+          "default": false,
+          "help": "Run the gates only; publish nothing."
+        }
+      ]
+    },
     {
       "name": "admin upload link-document",
       "persona": "admin",

{makea_cli-0.2.22 → makea_cli-0.2.24}/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.22/makea_cli/__init__.py

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

makea_cli-0.2.22/makea_cli/commands/metrics/cmd.py

@@ -1,167 +0,0 @@
-from __future__ import annotations
-
-import typer
-from rich.console import Console
-
-from makea_cli.registry import command
-
-from makea_cli import api_client
-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",
-        "get",
-        "currency-conversion",
-        legacy="convert-currency",
-        api="GET /admin/fx/rates",
-        help=(
-            "GET /admin/fx/rates — convert money between currencies at the "
-            "platform's own rates and rounding, so totals reconcile with its "
-            "prices and revenue metrics. Pass several source currencies via --from "
-            "(comma-separated) to get a full rate table in one call, then convert "
-            "locally — avoids repeated lookups."
-        ),
-    )
-    def convert_currency(
-        to: str = typer.Option(..., "--to", "-t", help="Target currency, e.g. GBP."),
-        from_: str = typer.Option(
-            ...,
-            "--from",
-            "-f",
-            help="Source currency code, or comma-separated list (e.g. usd,eur,cny,gbp).",
-        ),
-        amount: float = typer.Option(
-            None,
-            "--amount",
-            "-a",
-            help="Optional amount to convert (only meaningful with a single --from).",
-        ),
-    ) -> None:
-        """Return source->target rates, and optionally a converted amount, as the
-        platform computes them.
-
-        Use it to collapse a mixed-currency set into one currency: collect the
-        distinct currencies, call once with --from a,b,c to get every rate, then
-        multiply locally. The rates are the platform's (FreeCurrencyService,
-        rounded up to ``rate_decimals``) and come from the backend rather than
-        being fetched and rounded here, so they cannot drift from it.
-
-        Output JSON: {"to", "rates": {CUR: rate, ...}, "rate_decimals",
-        "rounding", "source", "unavailable"} plus {"from", "rate", "amount",
-        "converted"} when a single --from and --amount are given; "converted" is
-        the platform's own conversion, rounding included. A currency with no
-        rate fails the command rather than coming back null.
-        """
-        sources = [s.strip() for s in from_.split(",") if s.strip()]
-        if not sources:
-            console.print("[red]--from must contain at least one currency code.[/red]")
-            raise typer.Exit(1)
-
-        def _do() -> dict:
-            payload = api_client.get_fx_rates(
-                to=to,
-                sources=sources,
-                amount=amount if len(sources) == 1 else None,
-            )
-            out = (payload or {}).get("result") or {}
-            if out.get("unavailable"):
-                raise RuntimeError(
-                    "FX rate unavailable: "
-                    + ", ".join(f"{s}->{to.upper()}" for s in out["unavailable"])
-                )
-            return out
-
-        print_json_or_exit(console, _do)