makea-cli 0.2.8__tar.gz → 0.2.10__tar.gz

{makea_cli-0.2.8 → makea_cli-0.2.10}/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.2.10
+
+- PM reads for a brand (and Beeboo working for one):
+  - `designer get tna`: the Time & Action calendar, every pack's arrival with
+    how sure it is (done / confirmed / estimated) and its launch day.
+  - `designer list milestone --product <id>`: the bulk order's production
+    milestones, flattened (step, milestone, status, submitted/approved).
+  - `designer list note --product <id> --channel <key> [--since <date>]`: a
+    channel's messages without a search keyword, optionally only recent ones.
+  - `designer list fit-round --product <id>`: fit rounds and the corrections
+    carried into bulk.
+  - `designer get costing --style <id>`: one unit of each pack, factory price,
+    fees, the brand's freight/duty estimates, target, RRP, margin.
+
+## 0.2.9
+
+- The analytics commands (`admin get analytics-query`, `active-users`,
+  `top-features`, `top-clicks`, `feature-usage`) no longer need a PostHog key.
+  They go through the backend's `POST /admin/analytics/query`, which holds the
+  key, so an admin login is enough. A local `POSTHOG_API_KEY` +
+  `POSTHOG_PROJECT_ID` still switches them to querying PostHog directly.
+  Needs the backend with that endpoint.
+
 ## 0.2.8
 
 - `supplier get pack <quote_request_id> --readable`: the pack as a person reads

{makea_cli-0.2.8 → makea_cli-0.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.8
+Version: 0.2.10
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -98,18 +98,18 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin download document` | read | `GET /admin/document/download` | save a document file (document id + designer user_id). | `download-document` |
 | `makea-cli admin download product-document` | read | `GET /admin/document/download` | Resolve product via admin list product-order payload, then GET /admin/document/download. | `download-product-document` |
 | `makea-cli admin generate pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Lay a production order's variants into pricing groups along one axis (--by style \| colour \| variant \| all) with th… | `production-groups-generate` |
-| `makea-cli admin get active-users` | read | `posthog` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
-| `makea-cli admin get analytics-query` | read | `posthog` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
+| `makea-cli admin get active-users` | read | `POST /admin/analytics/query` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
+| `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 | `currency-api` | avoids repeated lookups. | `convert-currency` |
-| `makea-cli admin get feature-usage` | read | `posthog` | 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 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 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 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 supplier-profile-schema` | read | `GET /admin/supplier/profile/schema` | supplier profile v2 schema (section/field taxonomy: sections, fields, options, required rules). | `get-supplier-profile-schema` |
 | `makea-cli admin get tech-spec-extraction` | read | `GET /admin/products/{id}/extract-tech-specifications` | AI-generate specs (not saved). | `extract-ai-tech-spec` |
-| `makea-cli admin get top-clicks` | read | `posthog` | which buttons/elements get clicked most. | `analytics-top-clicks` |
-| `makea-cli admin get top-features` | read | `posthog` | a quick map of which features get used most. | `analytics-top-features` |
+| `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 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-0.2.8 → makea_cli-0.2.10}/README.md

@@ -86,18 +86,18 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin download document` | read | `GET /admin/document/download` | save a document file (document id + designer user_id). | `download-document` |
 | `makea-cli admin download product-document` | read | `GET /admin/document/download` | Resolve product via admin list product-order payload, then GET /admin/document/download. | `download-product-document` |
 | `makea-cli admin generate pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Lay a production order's variants into pricing groups along one axis (--by style \| colour \| variant \| all) with th… | `production-groups-generate` |
-| `makea-cli admin get active-users` | read | `posthog` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
-| `makea-cli admin get analytics-query` | read | `posthog` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
+| `makea-cli admin get active-users` | read | `POST /admin/analytics/query` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
+| `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 | `currency-api` | avoids repeated lookups. | `convert-currency` |
-| `makea-cli admin get feature-usage` | read | `posthog` | 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 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 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 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 supplier-profile-schema` | read | `GET /admin/supplier/profile/schema` | supplier profile v2 schema (section/field taxonomy: sections, fields, options, required rules). | `get-supplier-profile-schema` |
 | `makea-cli admin get tech-spec-extraction` | read | `GET /admin/products/{id}/extract-tech-specifications` | AI-generate specs (not saved). | `extract-ai-tech-spec` |
-| `makea-cli admin get top-clicks` | read | `posthog` | which buttons/elements get clicked most. | `analytics-top-clicks` |
-| `makea-cli admin get top-features` | read | `posthog` | a quick map of which features get used most. | `analytics-top-features` |
+| `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 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-0.2.10/makea_cli/__init__.py

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

{makea_cli-0.2.8 → makea_cli-0.2.10}/makea_cli/api_client.py

@@ -1359,6 +1359,99 @@ def supplier_list_quote_edit_requests(quote_request_id: str) -> Any:
     return get_json(f"/supplier/quote_requests/{quote_request_id}/quote_edit_requests")
 
 
+def designer_get_tna() -> Any:
+    """GET /designer/tna_calendar — every pack's five steps and arrival, with
+    the launch it is measured against when the arrival is confirmed."""
+    return get_json("/designer/tna_calendar")
+
+
+def designer_list_milestones(product_id: str) -> Any:
+    """Production milestones on a pack's bulk orders, compact: what is done,
+    submitted or waiting, never a lateness the factory did not commit to."""
+    raw = get_json(
+        f"/designer/products/{product_id}/production_order_details",
+        params={"type": "PRODUCTION"},
+    )
+    orders = (
+        raw.get("production_orders_details") or raw.get("orders")
+        if isinstance(raw, dict)
+        else raw
+    )
+    out = []
+    for order in orders or []:
+        if not isinstance(order, dict):
+            continue
+        for step in order.get("production_progress") or []:
+            meta = step.get("metadata") or {}
+            for m in meta.get("milestones") or []:
+                if not isinstance(m, dict):
+                    continue
+                out.append(
+                    {
+                        "order_id": order.get("production_order_id"),
+                        "step": step.get("progress_type"),
+                        "milestone": m.get("title"),
+                        "status": m.get("status"),
+                        "days_from_payment": m.get("time_window"),
+                        "submitted_at": m.get("submitted_at"),
+                        "approval_result": m.get("approval_result"),
+                        "completed_at": m.get("completed_at"),
+                    }
+                )
+    return {"product_id": product_id, "milestones": out}
+
+
+def designer_list_notes(
+    product_id: str, channel_key: str, *, since: str | None = None
+) -> Any:
+    """A channel's messages, oldest first, optionally only those after
+    ``since`` (ISO date or datetime): what the factory said this week."""
+    raw = get_json(f"/designer/products/{product_id}/channels/{channel_key}/notes")
+    notes = raw.get("notes") if isinstance(raw, dict) else raw
+    out = []
+    for n in notes or []:
+        if not isinstance(n, dict):
+            continue
+        if since and str(n.get("created_at") or "") < since:
+            continue
+        out.append(
+            {
+                "note_id": n.get("note_id"),
+                "at": n.get("created_at"),
+                "from": n.get("created_by_type"),
+                "supplier": n.get("supplier_name"),
+                "text": n.get("content"),
+                "replies": len(n.get("replies") or []),
+            }
+        )
+    return {"product_id": product_id, "channel": channel_key, "notes": out}
+
+
+def designer_list_fit_rounds(product_id: str) -> Any:
+    """GET /designer/products/{id}/fit_rounds — every fit round on the pack and
+    the corrections carried into bulk."""
+    return get_json(f"/designer/products/{product_id}/fit_rounds")
+
+
+def designer_get_costing(style_id: str) -> Any:
+    """One unit of each pack on a product card: factory price, fees, the
+    brand's freight and duty estimates, target, RRP, margin."""
+    raw = get_json(f"/designer/styles/{style_id}/overview")
+    packs = raw.get("packs") if isinstance(raw, dict) else []
+    return {
+        "style_id": style_id,
+        "packs": [
+            {
+                "product_id": p.get("product_id"),
+                "pack": p.get("pack_label"),
+                "costing": p.get("costing"),
+            }
+            for p in packs or []
+            if isinstance(p, dict)
+        ],
+    }
+
+
 def designer_list_actions(*, product_id: str | None = None) -> Any:
     """GET /designer/actions — the brand's pending actions, optionally for one product."""
     params = {"product_id": product_id} if product_id else None

{makea_cli-0.2.8 → makea_cli-0.2.10}/makea_cli/commands/analytics/cmd.py

@@ -4,7 +4,8 @@ Behavioural metrics (feature usage, clicks, page/feature time, active users)
 backed by PostHog HogQL. Distinct from the `metrics` group, which reads the
 Makea backend for financial figures.
 
-Requires env: POSTHOG_API_KEY, POSTHOG_PROJECT_ID (see config.py).
+Goes through the Makea backend by default (admin login is enough); a local
+POSTHOG_API_KEY + POSTHOG_PROJECT_ID switches to querying PostHog directly.
 """
 
 from __future__ import annotations
@@ -32,8 +33,7 @@ def register(app: typer.Typer) -> None:
         "get",
         "feature-usage",
         legacy="analytics-feature-usage",
-        api="POSTHOG hogql",
-        external="posthog",
+        api="POST /admin/analytics/query",
         help=(
             "How many distinct users used a feature recently, plus event volume. "
             "Matches $pageview path and feature_time_spent events. "
@@ -82,8 +82,7 @@ def register(app: typer.Typer) -> None:
         "get",
         "top-features",
         legacy="analytics-top-features",
-        api="POSTHOG hogql",
-        external="posthog",
+        api="POST /admin/analytics/query",
         help=(
             "Rank pageview paths by distinct users over the last N days — a quick "
             "map of which features get used most."
@@ -118,8 +117,7 @@ def register(app: typer.Typer) -> None:
         "get",
         "top-clicks",
         legacy="analytics-top-clicks",
-        api="POSTHOG hogql",
-        external="posthog",
+        api="POST /admin/analytics/query",
         help=(
             "Rank autocaptured click targets by count over the last N days — "
             "which buttons/elements get clicked most."
@@ -156,8 +154,7 @@ def register(app: typer.Typer) -> None:
         "get",
         "active-users",
         legacy="analytics-active-users",
-        api="POSTHOG hogql",
-        external="posthog",
+        api="POST /admin/analytics/query",
         help="Distinct active users per day over the last N days (DAU series).",
     )
     def active_users(
@@ -184,8 +181,7 @@ def register(app: typer.Typer) -> None:
         "get",
         "analytics-query",
         legacy="analytics-query",
-        api="POSTHOG hogql",
-        external="posthog",
+        api="POST /admin/analytics/query",
         help=(
             "Run an arbitrary HogQL query (escape hatch). "
             'Example: analytics-query "SELECT count() FROM events"'

{makea_cli-0.2.8 → makea_cli-0.2.10}/makea_cli/commands/brand/cmd.py

@@ -212,6 +212,95 @@ def register(app: typer.Typer) -> None:
         """List a product's channels."""
         print_json_or_exit(console, lambda: api_client.designer_list_channels(product))
 
+    @command(
+        app,
+        "designer",
+        "get",
+        "tna",
+        api="GET /designer/tna_calendar",
+        help=(
+            "GET /designer/tna_calendar — when each pack arrives and how sure that is "
+            "(done / confirmed / estimated), with its launch day."
+        ),
+    )
+    def get_tna() -> None:
+        """The Time & Action calendar."""
+        print_json_or_exit(console, lambda: api_client.designer_get_tna())
+
+    @command(
+        app,
+        "designer",
+        "list",
+        "milestone",
+        api="GET /designer/products/{product_id}/production_order_details",
+        help=(
+            "GET /designer/products/{id}/production_order_details — the bulk order's "
+            "production milestones: done, submitted, waiting."
+        ),
+    )
+    def list_milestones(
+        product: str = typer.Option(..., "--product", "-p", help="Product id."),
+    ) -> None:
+        """List a pack's production milestones."""
+        print_json_or_exit(console, lambda: api_client.designer_list_milestones(product))
+
+    @command(
+        app,
+        "designer",
+        "list",
+        "note",
+        api="GET /designer/products/{product_id}/channels/{channel_key}/notes",
+        help=(
+            "GET /designer/products/{id}/channels/{key}/notes — a channel's messages, "
+            "oldest first; --since keeps the recent ones (no keyword needed)."
+        ),
+    )
+    def list_notes(
+        product: str = typer.Option(..., "--product", "-p", help="Product id."),
+        channel: str = typer.Option(..., "--channel", "-c", help="Channel key."),
+        since: str | None = typer.Option(
+            None, "--since", help="ISO date or datetime, e.g. 2026-10-01."
+        ),
+    ) -> None:
+        """List a channel's messages."""
+        print_json_or_exit(
+            console, lambda: api_client.designer_list_notes(product, channel, since=since)
+        )
+
+    @command(
+        app,
+        "designer",
+        "list",
+        "fit-round",
+        api="GET /designer/products/{product_id}/fit_rounds",
+        help=(
+            "GET /designer/products/{id}/fit_rounds — the pack's fit rounds and the "
+            "corrections carried into bulk."
+        ),
+    )
+    def list_fit_rounds(
+        product: str = typer.Option(..., "--product", "-p", help="Product id."),
+    ) -> None:
+        """List a pack's fit rounds."""
+        print_json_or_exit(console, lambda: api_client.designer_list_fit_rounds(product))
+
+    @command(
+        app,
+        "designer",
+        "get",
+        "costing",
+        api="GET /designer/styles/{style_id}/overview",
+        help=(
+            "GET /designer/styles/{id}/overview — what one unit of each pack costs and "
+            "the margin at RRP (freight and duty are the brand's estimates)."
+        ),
+    )
+    def get_costing(
+        style: str = typer.Option(..., "--style", "-s", help="Product card (style) id."),
+    ) -> None:
+        """A product card's unit cost and margin."""
+        print_json_or_exit(console, lambda: api_client.designer_get_costing(style))
+
     @command(
         app,
         "designer",

{makea_cli-0.2.8 → makea_cli-0.2.10}/makea_cli/config.py

@@ -48,8 +48,9 @@ def redirect_uri() -> str:
 
 # PostHog product-analytics (behavioural metrics: clicks, page/feature time,
 # funnels, retention). Distinct from the financial `metrics` command group,
-# which reads the Makea backend. Configured purely via environment so no key is
-# ever committed:
+# which reads the Makea backend. Optional: without these the analytics commands
+# go through the backend's /admin/analytics/query, which holds the key. Set them
+# only to query PostHog directly:
 #   POSTHOG_API_KEY     personal API key (phx_...), read-only is enough
 #   POSTHOG_PROJECT_ID  numeric project id
 #   POSTHOG_HOST        defaults to the EU cloud query host

{makea_cli-0.2.8 → makea_cli-0.2.10}/makea_cli/posthog_client.py

@@ -1,10 +1,11 @@
 """Minimal PostHog query client (HogQL over the Query API).
 
-This talks to PostHog's cloud directly, not the Makea backend, so it has its
-own auth (a personal API key from env) rather than the Cognito token used by
-api_client.
+Two routes to the same query:
 
-Docs: POST {host}/api/projects/{project_id}/query/ with a HogQLQuery body.
+- By default it goes through the Makea backend (POST /admin/analytics/query),
+  which holds the PostHog key. An admin's `makea-cli login` is all it takes.
+- If POSTHOG_API_KEY and POSTHOG_PROJECT_ID are set locally, it talks to
+  PostHog directly instead (POST {host}/api/projects/{project_id}/query/).
 """
 
 from __future__ import annotations
@@ -14,33 +15,21 @@ from typing import Any
 
 import httpx
 
+from makea_cli import api_client
 from makea_cli.config import posthog_api_key, posthog_host, posthog_project_id
 
 
-class PostHogNotConfigured(RuntimeError):
-    """Raised when the required PostHog env vars are missing."""
-
-
-def _require_config() -> tuple[str, str, str]:
-    key = posthog_api_key()
-    project = posthog_project_id()
-    if not key or not project:
-        raise PostHogNotConfigured(
-            "PostHog is not configured. Set POSTHOG_API_KEY (personal API key, "
-            "phx_...) and POSTHOG_PROJECT_ID, optionally POSTHOG_HOST "
-            "(default https://eu.posthog.com)."
-        )
-    return posthog_host(), project, key
-
-
-def run_hogql(query: str, *, timeout: float = 60.0) -> dict[str, Any]:
+def run_hogql(query: str, *, timeout: float = 90.0) -> dict[str, Any]:
     """Run a HogQL query and return the raw result.
 
     The result has ``columns`` (list of names) and ``results`` (list of rows);
     callers usually want to zip them into dicts for display.
     """
-    host, project, key = _require_config()
-    url = f"{host}/api/projects/{project}/query/"
+    key = posthog_api_key()
+    project = posthog_project_id()
+    if not key or not project:
+        return api_client.post_json("/admin/analytics/query", {"query": query}, timeout=timeout)
+    url = f"{posthog_host()}/api/projects/{project}/query/"
     headers = {
         "Authorization": f"Bearer {key}",
         "Content-Type": "application/json",

{makea_cli-0.2.8 → makea_cli-0.2.10}/pyproject.toml

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

{makea_cli-0.2.8 → makea_cli-0.2.10}/tests/golden_manifest.json

@@ -913,8 +913,8 @@
       "verb": "get",
       "noun": "active-users",
       "access": "read",
-      "api": "POSTHOG hogql",
-      "external": "posthog",
+      "api": "POST /admin/analytics/query",
+      "external": null,
       "side_effects": [],
       "approval": "auto",
       "reversible": null,
@@ -947,8 +947,8 @@
       "verb": "get",
       "noun": "analytics-query",
       "access": "read",
-      "api": "POSTHOG hogql",
-      "external": "posthog",
+      "api": "POST /admin/analytics/query",
+      "external": null,
       "side_effects": [],
       "approval": "auto",
       "reversible": null,
@@ -1040,8 +1040,8 @@
       "verb": "get",
       "noun": "feature-usage",
       "access": "read",
-      "api": "POSTHOG hogql",
-      "external": "posthog",
+      "api": "POST /admin/analytics/query",
+      "external": null,
       "side_effects": [],
       "approval": "auto",
       "reversible": null,
@@ -1347,8 +1347,8 @@
       "verb": "get",
       "noun": "top-clicks",
       "access": "read",
-      "api": "POSTHOG hogql",
-      "external": "posthog",
+      "api": "POST /admin/analytics/query",
+      "external": null,
       "side_effects": [],
       "approval": "auto",
       "reversible": null,
@@ -1394,8 +1394,8 @@
       "verb": "get",
       "noun": "top-features",
       "access": "read",
-      "api": "POSTHOG hogql",
-      "external": "posthog",
+      "api": "POST /admin/analytics/query",
+      "external": null,
       "side_effects": [],
       "approval": "auto",
       "reversible": null,
@@ -5257,6 +5257,38 @@
         }
       ]
     },
+    {
+      "name": "designer get costing",
+      "persona": "designer",
+      "verb": "get",
+      "noun": "costing",
+      "access": "read",
+      "api": "GET /designer/styles/{style_id}/overview",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "GET /designer/styles/{id}/overview — what one unit of each pack costs and the margin at RRP (freight and duty are the brand's estimates).",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.get_costing",
+      "flags": [
+        {
+          "name": "style",
+          "kind": "option",
+          "opts": [
+            "--style",
+            "-s"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Product card (style) id."
+        }
+      ]
+    },
     {
       "name": "designer get lifecycle",
       "persona": "designer",
@@ -5468,6 +5500,24 @@
         }
       ]
     },
+    {
+      "name": "designer get tna",
+      "persona": "designer",
+      "verb": "get",
+      "noun": "tna",
+      "access": "read",
+      "api": "GET /designer/tna_calendar",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "GET /designer/tna_calendar — when each pack arrives and how sure that is (done / confirmed / estimated), with its launch day.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.get_tna",
+      "flags": []
+    },
     {
       "name": "designer list action",
       "persona": "designer",
@@ -5550,6 +5600,38 @@
       "function": "makea_cli.commands.brand.cmd.register.<locals>.list_collections",
       "flags": []
     },
+    {
+      "name": "designer list fit-round",
+      "persona": "designer",
+      "verb": "list",
+      "noun": "fit-round",
+      "access": "read",
+      "api": "GET /designer/products/{product_id}/fit_rounds",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": "client",
+      "legacy": [],
+      "help": "GET /designer/products/{id}/fit_rounds — the pack's fit rounds and the corrections carried into bulk.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.list_fit_rounds",
+      "flags": [
+        {
+          "name": "product",
+          "kind": "option",
+          "opts": [
+            "--product",
+            "-p"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Product id."
+        }
+      ]
+    },
     {
       "name": "designer list library-element",
       "persona": "designer",
@@ -5593,6 +5675,95 @@
         }
       ]
     },
+    {
+      "name": "designer list milestone",
+      "persona": "designer",
+      "verb": "list",
+      "noun": "milestone",
+      "access": "read",
+      "api": "GET /designer/products/{product_id}/production_order_details",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": "client",
+      "legacy": [],
+      "help": "GET /designer/products/{id}/production_order_details — the bulk order's production milestones: done, submitted, waiting.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.list_milestones",
+      "flags": [
+        {
+          "name": "product",
+          "kind": "option",
+          "opts": [
+            "--product",
+            "-p"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Product id."
+        }
+      ]
+    },
+    {
+      "name": "designer list note",
+      "persona": "designer",
+      "verb": "list",
+      "noun": "note",
+      "access": "read",
+      "api": "GET /designer/products/{product_id}/channels/{channel_key}/notes",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": "client",
+      "legacy": [],
+      "help": "GET /designer/products/{id}/channels/{key}/notes — a channel's messages, oldest first; --since keeps the recent ones (no keyword needed).",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.list_notes",
+      "flags": [
+        {
+          "name": "product",
+          "kind": "option",
+          "opts": [
+            "--product",
+            "-p"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Product id."
+        },
+        {
+          "name": "channel",
+          "kind": "option",
+          "opts": [
+            "--channel",
+            "-c"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Channel key."
+        },
+        {
+          "name": "since",
+          "kind": "option",
+          "opts": [
+            "--since"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "ISO date or datetime, e.g. 2026-10-01."
+        }
+      ]
+    },
     {
       "name": "designer list payment",
       "persona": "designer",

makea_cli-0.2.10/tests/test_pm_reads.py

@@ -0,0 +1,69 @@
+"""The PM reads Beeboo uses: milestones, recent notes, costing — trimmed to
+what answers "will it be on time", "what did the factory say this week",
+"what does it cost".
+
+Run with ``.venv/bin/python -m unittest tests.test_pm_reads``.
+"""
+
+import unittest
+from unittest import mock
+
+from makea_cli import api_client
+
+
+class PmReadsTest(unittest.TestCase):
+    def test_milestones_are_flattened(self):
+        raw = {
+            "production_orders_details": [
+                {
+                    "production_order_id": "po1",
+                    "production_progress": [
+                        {
+                            "progress_type": "During Production",
+                            "metadata": {
+                                "milestones": [
+                                    {"title": "Cutting", "status": "completed", "time_window": ["3", "5"]},
+                                ]
+                            },
+                        }
+                    ],
+                }
+            ]
+        }
+        with mock.patch.object(api_client, "get_json", return_value=raw):
+            out = api_client.designer_list_milestones("p1")
+        self.assertEqual(
+            out["milestones"][0],
+            {
+                "order_id": "po1",
+                "step": "During Production",
+                "milestone": "Cutting",
+                "status": "completed",
+                "days_from_payment": ["3", "5"],
+                "submitted_at": None,
+                "approval_result": None,
+                "completed_at": None,
+            },
+        )
+
+    def test_notes_since_keep_the_recent_ones(self):
+        raw = {
+            "notes": [
+                {"note_id": "a", "created_at": "2026-09-30T10:00:00", "content": "old"},
+                {"note_id": "b", "created_at": "2026-10-05T10:00:00", "content": "new", "replies": [{}]},
+            ]
+        }
+        with mock.patch.object(api_client, "get_json", return_value=raw):
+            out = api_client.designer_list_notes("p1", "supplier:s", since="2026-10-01")
+        self.assertEqual([n["note_id"] for n in out["notes"]], ["b"])
+        self.assertEqual(out["notes"][0]["replies"], 1)
+
+    def test_costing_is_per_pack(self):
+        raw = {"packs": [{"product_id": "p1", "pack_label": "v1", "costing": {"make": 50}}]}
+        with mock.patch.object(api_client, "get_json", return_value=raw):
+            out = api_client.designer_get_costing("st1")
+        self.assertEqual(out["packs"], [{"product_id": "p1", "pack": "v1", "costing": {"make": 50}}])
+
+
+if __name__ == "__main__":
+    unittest.main()

makea_cli-0.2.8/makea_cli/__init__.py

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