makea-cli 0.2.12__tar.gz → 0.2.14__tar.gz

{makea_cli-0.2.12 → makea_cli-0.2.14}/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.2.14
+
+- `admin update tracking-status`: help text no longer describes it as "the
+  17track webhook path". The 17track integration (registration and webhook)
+  was removed from the backend on 2026-10-10; this command, fed by the
+  tracking-sweep skill, is now the only way a carrier status reaches an
+  order. Behaviour is unchanged.
+
+## 0.2.13
+
+- `designer get supplier-scorecard [SUPPLIER_ID]`: a factory's track record
+  with the brand's team: orders on time against the factory's confirmed date,
+  milestone proofs rejected, inspections with High/Critical defects, fit
+  rounds that needed a new sample, confirmed dates moved later, median time to
+  first quote and to answer the brand's asks, chases, and orders, units and
+  styles. Every figure carries its n and period; "too few to judge" below the
+  minimum. No id: every factory the brand works with. A read (auto), and
+  brand-private: Makea refuses it in a factory's thread.
+
 ## 0.2.12
 
 Fixes from a live exam of Beeboo (2026-10-10):

{makea_cli-0.2.12 → makea_cli-0.2.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.12
+Version: 0.2.14
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -131,7 +131,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
 | `makea-cli admin update supplier` | write（ask） | `PUT /admin/supplier/update_supplier` | update an existing supplier from a JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the fi… | `update-supplier` |
 | `makea-cli admin update tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |
-| `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. Runs the 17track webhook path: status, fan-out, delivered emails (--silent: state only). | — |
+| `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 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-0.2.12 → makea_cli-0.2.14}/README.md

@@ -119,7 +119,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
 | `makea-cli admin update supplier` | write（ask） | `PUT /admin/supplier/update_supplier` | update an existing supplier from a JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the fi… | `update-supplier` |
 | `makea-cli admin update tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |
-| `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. Runs the 17track webhook path: status, fan-out, delivered emails (--silent: state only). | — |
+| `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 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-0.2.14/makea_cli/__init__.py

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

{makea_cli-0.2.12 → makea_cli-0.2.14}/makea_cli/api_client.py

@@ -1576,9 +1576,7 @@ def designer_list_milestones(product_id: str) -> Any:
         params={"type": "PRODUCTION"},
     )
     orders = (
-        raw.get("production_orders_details") or raw.get("orders")
-        if isinstance(raw, dict)
-        else raw
+        raw.get("production_orders_details") or raw.get("orders") if isinstance(raw, dict) else raw
     )
     out = []
     for order in orders or []:
@@ -1604,9 +1602,7 @@ def designer_list_milestones(product_id: str) -> Any:
     return {"product_id": product_id, "milestones": out}
 
 
-def designer_list_notes(
-    product_id: str, channel_key: str, *, since: str | None = None
-) -> Any:
+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")
@@ -1674,6 +1670,18 @@ def designer_get_costing(style_id: str | None = None, *, product_id: str | None
     return {"style_id": style_id, "packs": packs}
 
 
+def designer_get_supplier_scorecard(supplier_id: str | None = None) -> Any:
+    """A factory's track record with the brand's team: on time against its
+    confirmed dates, quality, responsiveness, volume. Each figure has its n and
+    period; "too few to judge" below the minimum. No id: every factory the
+    brand works with. Brand-private."""
+    if supplier_id:
+        raw = get_json(f"/designer/suppliers/{supplier_id}/scorecard")
+        return raw.get("scorecard") if isinstance(raw, dict) else raw
+    raw = get_json("/designer/suppliers/scorecards")
+    return {"scorecards": raw.get("scorecards") if isinstance(raw, dict) else raw}
+
+
 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.12 → makea_cli-0.2.14}/makea_cli/commands/brand/cmd.py

@@ -348,6 +348,27 @@ def register(app: typer.Typer) -> None:
             console, lambda: api_client.designer_get_costing(style, product_id=product)
         )
 
+    @command(
+        app,
+        "designer",
+        "get",
+        "supplier-scorecard",
+        api="GET /designer/suppliers/{supplier_id}/scorecard",
+        help=(
+            "GET /designer/suppliers/{id}/scorecard — a factory's track record with the "
+            "brand's team (on time vs confirmed dates, quality, responsiveness, volume; "
+            "each figure with its n and period). No id: every factory the brand works "
+            "with. Brand-private: never shared with the factory."
+        ),
+    )
+    def get_supplier_scorecard(
+        supplier_id: str | None = typer.Argument(
+            None, help="Supplier id; omit for every factory the brand works with."
+        ),
+    ) -> None:
+        """A factory's track record with this brand."""
+        print_json_or_exit(console, lambda: api_client.designer_get_supplier_scorecard(supplier_id))
+
     @command(
         app,
         "designer",

{makea_cli-0.2.12 → makea_cli-0.2.14}/makea_cli/commands/orders/cmd.py

@@ -323,14 +323,14 @@ def register(app: typer.Typer) -> None:
         api="POST /admin/tracking/carrier_status",
         side_effects=[
             "moves the order to delivered when the status says so",
-            "emails and messages the designer, supplier and admins as the 17track webhook did (none with --silent)",
+            "emails and messages the designer, supplier and admins that the parcel arrived (none with --silent)",
         ],
         approval="ask",
         idempotent=True,
         help=(
             "POST /admin/tracking/carrier_status — apply a carrier status looked up by hand "
-            "(the tracking-sweep skill) to one order. Runs the 17track webhook path: status, "
-            "fan-out to every order sharing the number, and the delivered emails."
+            "(the tracking-sweep skill) to one order: status, fan-out to every order "
+            "sharing the number, and the delivered emails."
         ),
     )
     def update_tracking_status(
@@ -341,7 +341,9 @@ def register(app: typer.Typer) -> None:
         order_id: str = typer.Argument(..., help="Order id (product id for reference_sample)."),
         tracking_number: str = typer.Argument(..., help="The parcel's tracking number."),
         status: str = typer.Option(
-            ..., "--status", help="17track status, e.g. Delivered, InTransit."
+            ...,
+            "--status",
+            help="Carrier status as the public 17track page shows it, e.g. Delivered, InTransit.",
         ),
         sub_status: str | None = typer.Option(None, "--sub-status"),
         event: str | None = typer.Option(None, "--event", help="Latest carrier event text."),
@@ -358,7 +360,7 @@ def register(app: typer.Typer) -> None:
         """
         Tell Makea what the carrier says about one parcel.
 
-        Output: JSON from the webhook path: success, status, and one entry per
+        Output: JSON: success, status, and one entry per
         order the number was fanned out to. Repeating a Delivered update is a
         no-op (no second email). --silent moves the orders without telling
         anyone.

{makea_cli-0.2.12 → makea_cli-0.2.14}/pyproject.toml

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

{makea_cli-0.2.12 → makea_cli-0.2.14}/tests/golden_manifest.json

@@ -3574,14 +3574,14 @@
       "external": null,
       "side_effects": [
         "moves the order to delivered when the status says so",
-        "emails and messages the designer, supplier and admins as the 17track webhook did (none with --silent)"
+        "emails and messages the designer, supplier and admins that the parcel arrived (none with --silent)"
       ],
       "approval": "ask",
       "reversible": null,
       "idempotent": true,
       "limit": null,
       "legacy": [],
-      "help": "POST /admin/tracking/carrier_status — apply a carrier status looked up by hand (the tracking-sweep skill) to one order. Runs the 17track webhook path: status, fan-out to every order sharing the number, and the delivered emails.",
+      "help": "POST /admin/tracking/carrier_status — apply a carrier status looked up by hand (the tracking-sweep skill) to one order: status, fan-out to every order sharing the number, and the delivered emails.",
       "function": "makea_cli.commands.orders.cmd.register.<locals>.update_tracking_status",
       "flags": [
         {
@@ -3630,7 +3630,7 @@
           "required": true,
           "multiple": false,
           "default": null,
-          "help": "17track status, e.g. Delivered, InTransit."
+          "help": "Carrier status as the public 17track page shows it, e.g. Delivered, InTransit."
         },
         {
           "name": "sub_status",
@@ -5477,6 +5477,37 @@
         }
       ]
     },
+    {
+      "name": "designer get supplier-scorecard",
+      "persona": "designer",
+      "verb": "get",
+      "noun": "supplier-scorecard",
+      "access": "read",
+      "api": "GET /designer/suppliers/{supplier_id}/scorecard",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "GET /designer/suppliers/{id}/scorecard — a factory's track record with the brand's team (on time vs confirmed dates, quality, responsiveness, volume; each figure with its n and period). No id: every factory the brand works with. Brand-private: never shared with the factory.",
+      "function": "makea_cli.commands.brand.cmd.register.<locals>.get_supplier_scorecard",
+      "flags": [
+        {
+          "name": "supplier_id",
+          "kind": "argument",
+          "opts": [
+            "supplier_id"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Supplier id; omit for every factory the brand works with."
+        }
+      ]
+    },
     {
       "name": "designer get tech-pack",
       "persona": "designer",

{makea_cli-0.2.12 → makea_cli-0.2.14}/tests/test_pm_reads.py

@@ -22,7 +22,11 @@ class PmReadsTest(unittest.TestCase):
                             "progress_type": "During Production",
                             "metadata": {
                                 "milestones": [
-                                    {"title": "Cutting", "status": "completed", "time_window": ["3", "5"]},
+                                    {
+                                        "title": "Cutting",
+                                        "status": "completed",
+                                        "time_window": ["3", "5"],
+                                    },
                                 ]
                             },
                         }
@@ -50,7 +54,12 @@ class PmReadsTest(unittest.TestCase):
         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": [{}]},
+                {
+                    "note_id": "b",
+                    "created_at": "2026-10-05T10:00:00",
+                    "content": "new",
+                    "replies": [{}],
+                },
             ]
         }
         with mock.patch.object(api_client, "get_json", return_value=raw):
@@ -62,7 +71,9 @@ class PmReadsTest(unittest.TestCase):
         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}}])
+        self.assertEqual(
+            out["packs"], [{"product_id": "p1", "pack": "v1", "costing": {"make": 50}}]
+        )
 
 
 class ExamFixesTest(unittest.TestCase):

makea_cli-0.2.14/tests/test_supplier_scorecard.py

@@ -0,0 +1,48 @@
+"""`designer get supplier-scorecard`: one factory, or every factory the
+brand works with.
+
+Run with ``.venv/bin/python -m unittest tests.test_supplier_scorecard``.
+"""
+
+import unittest
+from unittest import mock
+
+from makea_cli import api_client, registry
+
+
+class SupplierScorecardTest(unittest.TestCase):
+    def test_one_factory(self):
+        card = {"supplier_id": "s1", "on_time": {"text": "3 of 4 on time", "n": 4}}
+        with mock.patch.object(
+            api_client, "get_json", return_value={"success": True, "scorecard": card}
+        ) as get:
+            out = api_client.designer_get_supplier_scorecard("s1")
+        get.assert_called_once_with("/designer/suppliers/s1/scorecard")
+        self.assertEqual(out, card)
+
+    def test_every_factory(self):
+        with mock.patch.object(
+            api_client,
+            "get_json",
+            return_value={"success": True, "scorecards": [{"supplier_id": "s1"}]},
+        ) as get:
+            out = api_client.designer_get_supplier_scorecard()
+        get.assert_called_once_with("/designer/suppliers/scorecards")
+        self.assertEqual(out, {"scorecards": [{"supplier_id": "s1"}]})
+
+    def test_it_is_an_automatic_read(self):
+        from makea_cli import __version__
+        from makea_cli.main import build_cli
+
+        build_cli()
+        entry = next(
+            c
+            for c in registry.manifest(__version__)["commands"]
+            if c["name"] == "designer get supplier-scorecard"
+        )
+        self.assertEqual(entry["access"], "read")
+        self.assertEqual(entry["approval"], "auto")
+
+
+if __name__ == "__main__":
+    unittest.main()

makea_cli-0.2.12/makea_cli/__init__.py

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