makea-cli 0.2.22__py3-none-any.whl → 0.2.23__py3-none-any.whl

makea_cli/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.22"
+__version__ = "0.2.23"

makea_cli/api_client.py

@@ -933,6 +933,27 @@ def get_cumulative_payment_and_platform_revenue(
     )
 
 
+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``).
+    """
+    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:
     """
     GET /admin/fx/rates — the platform's own exchange rates (rounded up to its

makea_cli/commands/metrics/cmd.py

@@ -1,5 +1,9 @@
 from __future__ import annotations
 
+import json
+import tempfile
+from pathlib import Path
+
 import typer
 from rich.console import Console
 
@@ -165,3 +169,147 @@ def register(app: typer.Typer) -> None:
             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.dist-info → makea_cli-0.2.23.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.22
+Version: 0.2.23
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -114,6 +114,7 @@ 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` |
@@ -128,6 +129,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 +160,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.dist-info → makea_cli-0.2.23.dist-info}/RECORD

@@ -1,6 +1,6 @@
-makea_cli/__init__.py,sha256=ByX4mXI7ZzGpflAj9VCqX2NLBK8uAil5WOrao7y2YZM,23
+makea_cli/__init__.py,sha256=drfF0qMRjoB2RacyqP-NkNmDOIBrys6RWHvqSTpZLuc,23
 makea_cli/__main__.py,sha256=AkQjxWfKE3w9iD1d6I-2Zqvv2t9cct0oYyFF0UiA-Z0,144
-makea_cli/api_client.py,sha256=SJu96FAB2jjbXtbg6rz9dbJfAdR-xodP_7bwsQnLn2c,74802
+makea_cli/api_client.py,sha256=SQWPYQzIrm9BqWrraHkhAQeFZjljLHZm_ioSnlcz9ss,75766
 makea_cli/auth_pkce.py,sha256=iXSyJ7DM3qVuj-3FwPiqM25CxXz9ebFs9FNthZdw3ws,7315
 makea_cli/broker.py,sha256=5O650nAdRuF-u9E1MuVM2jVv796iBdxJGIaJasxHij0,3019
 makea_cli/config.py,sha256=hz8MnJSkhxcIEZkcpHR005JrDceo1Xmi8qwIUq50cMU,3003
@@ -33,7 +33,7 @@ makea_cli/commands/factory/cmd.py,sha256=k_UGkqpzxxZhN9WjKt1rb95KOTGHMpMJRpfNHTG
 makea_cli/commands/library/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 makea_cli/commands/library/cmd.py,sha256=eXZa6iLyPaoEWtRd-UmhRT6Ox-zlfs89gJqGn-IPuSU,11187
 makea_cli/commands/metrics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-makea_cli/commands/metrics/cmd.py,sha256=ox5OD7Bk3QJcdHQv5u4t6G-OlC6eSbQG5BEH1yBkxno,6414
+makea_cli/commands/metrics/cmd.py,sha256=GvJe83vQu8XSCEulsfDvA60eKnvpIA5ItyMbvxjHQss,12069
 makea_cli/commands/orders/__init__.py,sha256=6WKPqX02e0RRPmItPIBJ0TA4_yDI2PVvBDkAiMQu9rU,75
 makea_cli/commands/orders/cmd.py,sha256=Nh5lGv5k4SIwsr_hg-ndah8eTorZCYIMpTAz4CCi6oY,13352
 makea_cli/commands/playbook/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -49,7 +49,7 @@ makea_cli/commands/supplier/__init__.py,sha256=qfQDeQdQ-B7I_uwFVfcp1vXFUTL4fAcNL
 makea_cli/commands/supplier/cmd.py,sha256=crRCy9WfhkryHMIL3iufoiT90_SG3-mKChAtdhd06uc,58076
 makea_cli/commands/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 makea_cli/commands/tasks/cmd.py,sha256=SRvv4Ovtcf5-me-8AdKcZ_z_gSrdgC0pbswYbMz7oY4,6539
-makea_cli-0.2.22.dist-info/METADATA,sha256=_4x_4_mqAfhiet0nJk5tmxAGBiGA63OGT8eeEO4Gtnk,37484
-makea_cli-0.2.22.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-makea_cli-0.2.22.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
-makea_cli-0.2.22.dist-info/RECORD,,
+makea_cli-0.2.23.dist-info/METADATA,sha256=R8vXTZWjsjKrw0eGacTTpI3gCFT3xv8uV41cJ5wqau4,38087
+makea_cli-0.2.23.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+makea_cli-0.2.23.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
+makea_cli-0.2.23.dist-info/RECORD,,