makea-cli 0.2.5__tar.gz → 0.2.7__tar.gz

{makea_cli-0.2.5 → makea_cli-0.2.7}/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.2.7
+
+- `admin update tracking-status ... --silent`: move the orders without
+  telling anyone (no email, WhatsApp or WeChat). For parcels that landed long
+  before anyone noticed, where a "your order has arrived" email would confuse.
+
+## 0.2.6
+
+- `admin update tracking-status <kind> <order_id> <tracking_number> --status Delivered`
+  (`ask`): tell Makea what the carrier says about one parcel. The 17track API
+  is off, so the daily tracking-sweep skill reads the public 17track page and
+  posts each delivered parcel here. The backend runs the same path the 17track
+  webhook did: status, fan-out to every order sharing the number, and the
+  delivered emails. Repeating a Delivered update is a no-op.
+
 ## 0.2.5
 
 The production journey, for the Claude agent on the product channel.

{makea_cli-0.2.5 → makea_cli-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.5
+Version: 0.2.7
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -131,6 +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 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.5 → makea_cli-0.2.7}/README.md

@@ -119,6 +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 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.7/makea_cli/__init__.py

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

{makea_cli-0.2.5 → makea_cli-0.2.7}/makea_cli/commands/orders/cmd.py

@@ -314,3 +314,73 @@ def register(app: typer.Typer) -> None:
                 offset=offset,
             ),
         )
+
+    @command(
+        app,
+        "admin",
+        "update",
+        "tracking-status",
+        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)",
+        ],
+        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."
+        ),
+    )
+    def update_tracking_status(
+        kind: str = typer.Argument(
+            ...,
+            help="sampling | production | restock | shipping | material | reference_sample",
+        ),
+        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."
+        ),
+        sub_status: str | None = typer.Option(None, "--sub-status"),
+        event: str | None = typer.Option(None, "--event", help="Latest carrier event text."),
+        location: str | None = typer.Option(None, "--location"),
+        time_utc: str | None = typer.Option(
+            None, "--time", help="Latest event time, ISO 8601 UTC."
+        ),
+        silent: bool = typer.Option(
+            False,
+            "--silent",
+            help="Change state only: no email, WhatsApp or WeChat to anyone. For parcels that landed long ago.",
+        ),
+    ) -> None:
+        """
+        Tell Makea what the carrier says about one parcel.
+
+        Output: JSON from the webhook path: 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.
+        """
+        track_info = {
+            "latest_status": {"status": status, "sub_status": sub_status},
+            "latest_event": {
+                "description": event,
+                "location": location,
+                "time_utc": time_utc,
+            },
+        }
+        print_json_or_exit(
+            console,
+            lambda: api_client.post_json(
+                "/admin/tracking/carrier_status",
+                {
+                    "kind": kind,
+                    "order_id": order_id,
+                    "tracking_number": tracking_number,
+                    "track_info": track_info,
+                    "notify": not silent,
+                },
+            ),
+        )

{makea_cli-0.2.5 → makea_cli-0.2.7}/pyproject.toml

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

{makea_cli-0.2.5 → makea_cli-0.2.7}/tests/golden_manifest.json

@@ -3564,6 +3564,136 @@
         }
       ]
     },
+    {
+      "name": "admin update tracking-status",
+      "persona": "admin",
+      "verb": "update",
+      "noun": "tracking-status",
+      "access": "write",
+      "api": "POST /admin/tracking/carrier_status",
+      "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)"
+      ],
+      "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.",
+      "function": "makea_cli.commands.orders.cmd.register.<locals>.update_tracking_status",
+      "flags": [
+        {
+          "name": "kind",
+          "kind": "argument",
+          "opts": [
+            "kind"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "sampling | production | restock | shipping | material | reference_sample"
+        },
+        {
+          "name": "order_id",
+          "kind": "argument",
+          "opts": [
+            "order_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Order id (product id for reference_sample)."
+        },
+        {
+          "name": "tracking_number",
+          "kind": "argument",
+          "opts": [
+            "tracking_number"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "The parcel's tracking number."
+        },
+        {
+          "name": "status",
+          "kind": "option",
+          "opts": [
+            "--status"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "17track status, e.g. Delivered, InTransit."
+        },
+        {
+          "name": "sub_status",
+          "kind": "option",
+          "opts": [
+            "--sub-status"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": null
+        },
+        {
+          "name": "event",
+          "kind": "option",
+          "opts": [
+            "--event"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Latest carrier event text."
+        },
+        {
+          "name": "location",
+          "kind": "option",
+          "opts": [
+            "--location"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": null
+        },
+        {
+          "name": "time_utc",
+          "kind": "option",
+          "opts": [
+            "--time"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Latest event time, ISO 8601 UTC."
+        },
+        {
+          "name": "silent",
+          "kind": "option",
+          "opts": [
+            "--silent"
+          ],
+          "type": "flag",
+          "required": false,
+          "multiple": false,
+          "default": false,
+          "help": "Change state only: no email, WhatsApp or WeChat to anyone. For parcels that landed long ago."
+        }
+      ]
+    },
     {
       "name": "admin update user",
       "persona": "admin",

makea_cli-0.2.5/makea_cli/__init__.py

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