makea-cli 0.2.32__tar.gz → 0.2.34__tar.gz

{makea_cli-0.2.32 → makea_cli-0.2.34}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.2.34
+
+- `admin create ship-log` takes `--kind feature|fix` (required), and
+  `--ticket no-jira` for a change without a Jira ticket.
+- `admin update ship-log` can change `--kind` and `--ticket`.
+
+## 0.2.33
+
+The admin Ship log (app.makea.co/admin/ship-log): what went live, for the team.
+
+- `admin create ship-log` records a ticket going live after a deploy, with a
+  plain title and summary, its commits, the Amplify job or EB version, an
+  optional `--watch` note and `--media` recordings or screenshots. The same
+  ticket with the same commits on the same day returns the existing entry.
+- `admin list ship-log`, `admin update ship-log` (also attaches more media)
+  and `admin delete ship-log`.
+
 ## 0.2.32
 
 Quote requests wait while the brand's files disagree (TECH-181).

{makea_cli-0.2.32 → makea_cli-0.2.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.32
+Version: 0.2.34
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -99,6 +99,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin create product-note` | write（ask） | `POST /admin/products/{product_id}/notes` | write a note on a product. Without --internal it goes to the brand. | — |
 | `makea-cli admin create quote-request` | write（ask） | `POST /admin/supplier/create_quote_request` | create/send a quote request to a supplier for a product (admin). Held (409 FILES_DISAGREE) while the brand's files disagree; --release-anyway sends regardless. | `create-quote-request` |
 | `makea-cli admin create quote-request-note` | write（ask） | `POST /admin/quote_requests/{quote_request_id}/reply_status_note` | write to the factory on a quote request (e.g. answer its clarification). --requirements-updated words the email as a change to the product's requirements. | — |
+| `makea-cli admin create ship-log` | write（ask） | `POST /admin/ship-log/deploys` | record a change going live on the admin Ship log, after the deploy succeeded: Jira key (or `no-jira`), `--kind feature\|fix`, plain title and summary for the team, commits, Amplify job or EB version, optional `--watch` note and `--media` recordings or screenshots. | — |
 | `makea-cli admin create rule` | write（ask） | `POST /admin/playbook/{target}/rules` | add a rule to a person's (`--user`, user_id or email), a factory's (`--supplier`) or the platform-wide (`--global`, max 30 live) AI playbook; admin-authored, active unless --status. Refuses a repeat or a conflict unless --force. --reason required; --why / --proof are what the brand reads under it, --title its card name. | — |
 | `makea-cli admin create shipping-fee` | write（ask） | `POST /admin/shipping_orders/{shipping_order_id}/fees/add` | add a fee (fixed amount or percentage) on top of the freight. | — |
 | `makea-cli admin create shipping-option` | write（ask） | `POST /admin/shipping_orders/{shipping_order_id}/shipping-options` | add one freight quote (provider, speed, price, currency). | — |
@@ -107,6 +108,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin create supplier-link` | write（ask） | `POST /admin/product/link_supplier` | assign a factory to a product, with no price. A bare assignment is not a quote: no quote email goes out and nothing is priced. To quote, use admin submit quote on the quote request. | — |
 | `makea-cli admin create user` | write（never） | `POST /admin/users/create` | register a user and confirm the Cognito account in one step (no verification email). Allowed --user-type values: "Fas… | `create-user` |
 | `makea-cli admin delete about` | write（ask） | `DELETE /admin/about/{target}/{key}` | remove one About you line (`--user` / `--supplier`); it is not guessed again. --reason required. | — |
+| `makea-cli admin delete ship-log` | write（ask） | `DELETE /admin/ship-log/deploys/{deploy_id}` | remove a Ship log entry recorded by mistake, with its recordings. | — |
 | `makea-cli admin delete feature-flag` | write（ask） | `DELETE /admin/feature-flags/{key}` | remove a flag. Every check of it then reads false, so delete it only once the code that reads it is gone. | — |
 | `makea-cli admin delete library-element` | write（never） | `DELETE /admin/designer/{user_id}/library_components/{component_id}` | remove a component from the designer's org library. | `library-delete` |
 | `makea-cli admin delete rule` | write（ask） | `DELETE /admin/playbook/{target}/rules/{rule_id}` | remove a rule (`--user` / `--supplier` / `--global`): archived, with who and why kept on it (`update rule --status active` restores it). --reason required. | — |
@@ -158,6 +160,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin list supplier` | read | `GET /admin/supplier/get_all_suppliers` | list all suppliers (admin). | `list-suppliers` |
 | `makea-cli admin list supplier-link` | read | `GET /admin/product/linked_suppliers/by_supplier/{supplier_id}` | direct backend query. | `get-supplier-links-by-supplier-id` |
 | `makea-cli admin list task` | read | `GET /admin/tasks` | the Makea team's open tasks (Beeboo's notes, held lessons, sample price flags, PP samples, brand asks) by kind, with notes; `--user` adds that account's own `account.*` cards; `--wrong` lists the tasks marked wrong instead. | — |
+| `makea-cli admin list ship-log` | read | `GET /admin/ship-log/deploys` | deploys recorded on the Ship log between two days (`--since`, `--until`), newest first. | — |
 | `makea-cli admin list user` | read | `GET /admin/users` | list registered users (admin, optional pagination). | `list-users` |
 | `makea-cli admin send email` | write（ask） | `POST /admin/email/send` | queue an HTML email (To required, Cc optional). From must be @makea.co; HTML from --html-file or stdin ('-'). Require… | `send-email` |
 | `makea-cli admin set pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Set a production order's pricing groups from a JSON file, copy them from the order's quote, or clear them (--clear) t… | `production-groups-set` |
@@ -181,6 +184,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update shipping-order` | write（ask） | `PUT /admin/shipping_orders/{shipping_order_id}/status` | Change a shipment: --status (PUT .../status), tracking flags (POST .../tracking), --address (PUT .../shipping-address… | — |
 | `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 task` | write（ask） | `POST /admin/tasks/{task_id}/{done\|dismiss\|note}` | close a Makea task with a note: `--done` once handled (a held lesson's `--reason` goes to Beeboo's next reading), `--dismiss`, or `--dismiss --wrong` when it should never have been raised; `--note` alone adds a note and leaves it open. | — |
+| `makea-cli admin update ship-log` | write（ask） | `PATCH /admin/ship-log/deploys/{deploy_id}` | fix a Ship log entry's title, summary or watch note; `--media` attaches more recordings. | — |
 | `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: 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-0.2.32 → makea_cli-0.2.34}/README.md

@@ -83,6 +83,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin create product-note` | write（ask） | `POST /admin/products/{product_id}/notes` | write a note on a product. Without --internal it goes to the brand. | — |
 | `makea-cli admin create quote-request` | write（ask） | `POST /admin/supplier/create_quote_request` | create/send a quote request to a supplier for a product (admin). Held (409 FILES_DISAGREE) while the brand's files disagree; --release-anyway sends regardless. | `create-quote-request` |
 | `makea-cli admin create quote-request-note` | write（ask） | `POST /admin/quote_requests/{quote_request_id}/reply_status_note` | write to the factory on a quote request (e.g. answer its clarification). --requirements-updated words the email as a change to the product's requirements. | — |
+| `makea-cli admin create ship-log` | write（ask） | `POST /admin/ship-log/deploys` | record a change going live on the admin Ship log, after the deploy succeeded: Jira key (or `no-jira`), `--kind feature\|fix`, plain title and summary for the team, commits, Amplify job or EB version, optional `--watch` note and `--media` recordings or screenshots. | — |
 | `makea-cli admin create rule` | write（ask） | `POST /admin/playbook/{target}/rules` | add a rule to a person's (`--user`, user_id or email), a factory's (`--supplier`) or the platform-wide (`--global`, max 30 live) AI playbook; admin-authored, active unless --status. Refuses a repeat or a conflict unless --force. --reason required; --why / --proof are what the brand reads under it, --title its card name. | — |
 | `makea-cli admin create shipping-fee` | write（ask） | `POST /admin/shipping_orders/{shipping_order_id}/fees/add` | add a fee (fixed amount or percentage) on top of the freight. | — |
 | `makea-cli admin create shipping-option` | write（ask） | `POST /admin/shipping_orders/{shipping_order_id}/shipping-options` | add one freight quote (provider, speed, price, currency). | — |
@@ -91,6 +92,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin create supplier-link` | write（ask） | `POST /admin/product/link_supplier` | assign a factory to a product, with no price. A bare assignment is not a quote: no quote email goes out and nothing is priced. To quote, use admin submit quote on the quote request. | — |
 | `makea-cli admin create user` | write（never） | `POST /admin/users/create` | register a user and confirm the Cognito account in one step (no verification email). Allowed --user-type values: "Fas… | `create-user` |
 | `makea-cli admin delete about` | write（ask） | `DELETE /admin/about/{target}/{key}` | remove one About you line (`--user` / `--supplier`); it is not guessed again. --reason required. | — |
+| `makea-cli admin delete ship-log` | write（ask） | `DELETE /admin/ship-log/deploys/{deploy_id}` | remove a Ship log entry recorded by mistake, with its recordings. | — |
 | `makea-cli admin delete feature-flag` | write（ask） | `DELETE /admin/feature-flags/{key}` | remove a flag. Every check of it then reads false, so delete it only once the code that reads it is gone. | — |
 | `makea-cli admin delete library-element` | write（never） | `DELETE /admin/designer/{user_id}/library_components/{component_id}` | remove a component from the designer's org library. | `library-delete` |
 | `makea-cli admin delete rule` | write（ask） | `DELETE /admin/playbook/{target}/rules/{rule_id}` | remove a rule (`--user` / `--supplier` / `--global`): archived, with who and why kept on it (`update rule --status active` restores it). --reason required. | — |
@@ -142,6 +144,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin list supplier` | read | `GET /admin/supplier/get_all_suppliers` | list all suppliers (admin). | `list-suppliers` |
 | `makea-cli admin list supplier-link` | read | `GET /admin/product/linked_suppliers/by_supplier/{supplier_id}` | direct backend query. | `get-supplier-links-by-supplier-id` |
 | `makea-cli admin list task` | read | `GET /admin/tasks` | the Makea team's open tasks (Beeboo's notes, held lessons, sample price flags, PP samples, brand asks) by kind, with notes; `--user` adds that account's own `account.*` cards; `--wrong` lists the tasks marked wrong instead. | — |
+| `makea-cli admin list ship-log` | read | `GET /admin/ship-log/deploys` | deploys recorded on the Ship log between two days (`--since`, `--until`), newest first. | — |
 | `makea-cli admin list user` | read | `GET /admin/users` | list registered users (admin, optional pagination). | `list-users` |
 | `makea-cli admin send email` | write（ask） | `POST /admin/email/send` | queue an HTML email (To required, Cc optional). From must be @makea.co; HTML from --html-file or stdin ('-'). Require… | `send-email` |
 | `makea-cli admin set pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Set a production order's pricing groups from a JSON file, copy them from the order's quote, or clear them (--clear) t… | `production-groups-set` |
@@ -165,6 +168,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update shipping-order` | write（ask） | `PUT /admin/shipping_orders/{shipping_order_id}/status` | Change a shipment: --status (PUT .../status), tracking flags (POST .../tracking), --address (PUT .../shipping-address… | — |
 | `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 task` | write（ask） | `POST /admin/tasks/{task_id}/{done\|dismiss\|note}` | close a Makea task with a note: `--done` once handled (a held lesson's `--reason` goes to Beeboo's next reading), `--dismiss`, or `--dismiss --wrong` when it should never have been raised; `--note` alone adds a note and leaves it open. | — |
+| `makea-cli admin update ship-log` | write（ask） | `PATCH /admin/ship-log/deploys/{deploy_id}` | fix a Ship log entry's title, summary or watch note; `--media` attaches more recordings. | — |
 | `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: 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-0.2.34/makea_cli/__init__.py

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

{makea_cli-0.2.32 → makea_cli-0.2.34}/makea_cli/api_client.py

@@ -1226,6 +1226,40 @@ def admin_close_task(task_id: str, verb: str, body: dict[str, Any]) -> Any:
     return post_json(f"/admin/tasks/{quote(task_id, safe='')}/{verb}", body)
 
 
+# --- admin: ship log (what went live, for /admin/ship-log) -------------------------
+
+
+def admin_create_ship_log(body: dict[str, Any]) -> Any:
+    """POST /admin/ship-log/deploys — {ticket, title, summary?, commits{backend,frontend,
+    cli,miniprogram}, amplify_job?, eb_version?, watch?, deployed_at?}."""
+    return post_json("/admin/ship-log/deploys", body)
+
+
+def admin_list_ship_log(start: str, end: str) -> Any:
+    """GET /admin/ship-log/deploys?start=&end= — naive-UTC ISO bounds, newest first."""
+    return get_json("/admin/ship-log/deploys", params={"start": start, "end": end})
+
+
+def admin_update_ship_log(deploy_id: str, body: dict[str, Any]) -> Any:
+    """PATCH /admin/ship-log/deploys/{deploy_id} — {title?, summary?, watch?}."""
+    return patch_json(f"/admin/ship-log/deploys/{quote(deploy_id, safe='')}", body)
+
+
+def admin_delete_ship_log(deploy_id: str) -> Any:
+    """DELETE /admin/ship-log/deploys/{deploy_id} — the entry and its recordings."""
+    return delete_json(f"/admin/ship-log/deploys/{quote(deploy_id, safe='')}")
+
+
+def admin_add_ship_log_media(deploy_id: str, file_path: Path, title: str = "") -> Any:
+    """POST /admin/ship-log/deploys/{deploy_id}/media — one recording or screenshot."""
+    return post_multipart_with_file(
+        f"/admin/ship-log/deploys/{quote(deploy_id, safe='')}/media",
+        file_path=file_path,
+        form_fields={"title": title} if title else None,
+        timeout=600.0,
+    )
+
+
 # --- admin: one account's Knowledge > About you -----------------------------------
 # A person (user_id or email; a supplier account's person is their factory's page)
 # or one factory by supplier id. Every write but refresh carries a reason.

{makea_cli-0.2.32 → makea_cli-0.2.34}/makea_cli/commands/__init__.py

@@ -19,6 +19,7 @@ from makea_cli.commands.orders.cmd import register as register_orders
 from makea_cli.commands.playbook.cmd import register as register_playbook
 from makea_cli.commands.product.cmd import register as register_product
 from makea_cli.commands.production.cmd import register as register_production
+from makea_cli.commands.shiplog.cmd import register as register_shiplog
 from makea_cli.commands.shipping.cmd import register as register_shipping
 from makea_cli.commands.supplier.cmd import register as register_supplier
 from makea_cli.commands.tasks.cmd import register as register_tasks
@@ -45,3 +46,4 @@ def register_all(app: typer.Typer) -> None:
     register_about(app)
     register_tasks(app)
     register_flags(app)
+    register_shiplog(app)

makea_cli-0.2.34/makea_cli/commands/shiplog/cmd.py

@@ -0,0 +1,261 @@
+"""Admin commands for the ship log (app.makea.co/admin/ship-log).
+
+A ship log entry is one ticket going live: the ticket, a plain title and
+one-line summary written for the team (not for engineers), the commits behind
+it, the Amplify job or EB version, an optional watch note (something to do
+after it is live), and recordings that show it working. Record one at the end
+of every deploy; the page writes the team's standup from these entries.
+"""
+
+from __future__ import annotations
+
+from datetime import date, timedelta
+from pathlib import Path
+from typing import Any
+
+import typer
+from rich.console import Console
+
+from makea_cli import api_client
+from makea_cli.commands._util import print_json_or_exit
+from makea_cli.registry import command
+
+console = Console()
+
+_EPILOG = """
+Examples
+  makea-cli admin create ship-log --ticket TECH-218 --kind fix \\
+      --title "Notifications open the thing they are about" \\
+      --summary "658 of 1,413 notifications used to land on Styles." \\
+      --backend 86905496 --frontend bb550dd1 --amplify-job 1714 \\
+      --watch "Run the prod backfill" \\
+      --media ~/Desktop/tech218.mp4::"Quote notification lands on the quote"
+  makea-cli admin create ship-log --ticket no-jira --kind feature \\
+      --title "Confetti when the bulk deposit lands" --frontend 5da4001c
+  makea-cli admin list ship-log --since 2026-11-09
+  makea-cli admin update ship-log 20261111T134000-ab12cd --media shot.png
+  makea-cli admin delete ship-log 20261111T134000-ab12cd
+""".strip()
+
+
+def _media_option() -> Any:
+    return typer.Option(
+        None,
+        "--media",
+        "-m",
+        help="Recording or screenshot to attach, PATH or PATH::Title. Repeatable.",
+    )
+
+
+def _shas(values: list[str] | None) -> list[str]:
+    return [s.strip() for v in values or [] for s in v.split(",") if s.strip()]
+
+
+def _parse_media(values: list[str] | None) -> list[tuple[Path, str]]:
+    out = []
+    for raw in values or []:
+        path_s, _, title = raw.partition("::")
+        path = Path(path_s).expanduser()
+        if not path.is_file():
+            raise typer.BadParameter(f"--media: no file at {path}")
+        out.append((path, title.strip()))
+    return out
+
+
+def _upload(deploy_id: str, media: list[tuple[Path, str]]) -> list[Any]:
+    return [api_client.admin_add_ship_log_media(deploy_id, path, title) for path, title in media]
+
+
+def register(app: typer.Typer) -> None:
+    @command(
+        app,
+        "admin",
+        "create",
+        "ship-log",
+        api="POST /admin/ship-log/deploys",
+        side_effects=[
+            "the deploy appears on the admin Ship log for the whole Makea team",
+            "the next person to open that day's standup gets it rewritten to include it",
+            "with --media, each file is uploaded to S3 and shown on the entry",
+        ],
+        approval="ask",
+        reversible=True,
+        idempotent=True,
+        help=(
+            "POST /admin/ship-log/deploys — record one change going live, after the deploy "
+            "succeeded. --ticket is its Jira key, or no-jira when it has none (shown as "
+            "[no-jira]); --kind says whether it is a new feature or a bug fix. "
+            "Title and summary are for the team: what changed for brands, "
+            "factories or Makea, not how. The same ticket with the same commits on the "
+            "same day returns the existing entry. --media uploads recordings (mp4, webm, "
+            "mov) or screenshots (png, jpeg, webp, gif), up to 150 MB each."
+        ),
+        epilog=_EPILOG,
+    )
+    def create_ship_log(
+        ticket: str = typer.Option(
+            ..., "--ticket", "-t", help="Jira key, e.g. TECH-218; no-jira when there is none."
+        ),
+        kind: str = typer.Option(
+            ..., "--kind", "-k", help="feature (something new) or fix (a bug fixed)."
+        ),
+        title: str = typer.Option(..., "--title", help="What changed, in plain words."),
+        summary: str = typer.Option("", "--summary", "-s", help="One or two sentences more."),
+        backend: list[str] = typer.Option(None, "--backend", help="garmentby-service commit(s)."),
+        frontend: list[str] = typer.Option(None, "--frontend", help="Frontend commit(s)."),
+        cli: list[str] = typer.Option(None, "--cli", help="makea-cli commit(s)."),
+        miniprogram: list[str] = typer.Option(
+            None, "--miniprogram", help="Mini program commit(s)."
+        ),
+        amplify_job: str = typer.Option("", "--amplify-job", help="Amplify job number."),
+        eb_version: str = typer.Option("", "--eb-version", help="Elastic Beanstalk version label."),
+        watch: str = typer.Option("", "--watch", help="Something to do after it is live."),
+        deployed_at: str | None = typer.Option(
+            None, "--deployed-at", help="When it went live, ISO UTC. Default: now."
+        ),
+        media: list[str] = _media_option(),
+    ) -> None:
+        """Record a deploy on the admin Ship log."""
+        commits = {
+            side: shas
+            for side, shas in (
+                ("backend", _shas(backend)),
+                ("frontend", _shas(frontend)),
+                ("cli", _shas(cli)),
+                ("miniprogram", _shas(miniprogram)),
+            )
+            if shas
+        }
+        if not commits:
+            raise typer.BadParameter(
+                "pass at least one of --backend, --frontend, --cli, --miniprogram"
+            )
+        files = _parse_media(media)
+        body: dict[str, Any] = {
+            "ticket": ticket,
+            "title": title,
+            "summary": summary,
+            "commits": commits,
+            "amplify_job": amplify_job,
+            "eb_version": eb_version,
+            "watch": watch,
+            "kind": kind,
+        }
+        if deployed_at:
+            body["deployed_at"] = deployed_at
+
+        def run() -> Any:
+            result = api_client.admin_create_ship_log(body)
+            deploy = (result or {}).get("deploy") if isinstance(result, dict) else None
+            if files and deploy and deploy.get("deploy_id"):
+                result["media"] = _upload(deploy["deploy_id"], files)
+            return result
+
+        print_json_or_exit(console, run)
+
+    @command(
+        app,
+        "admin",
+        "list",
+        "ship-log",
+        api="GET /admin/ship-log/deploys",
+        help=(
+            "GET /admin/ship-log/deploys — deploys between two UTC days, newest first: "
+            "deploy_id, ticket, title, summary, watch, commits, amplify_job, deployed_at, media."
+        ),
+        epilog=_EPILOG,
+    )
+    def list_ship_log(
+        since: str | None = typer.Option(
+            None, "--since", help="First day, YYYY-MM-DD. Default: 6 days ago."
+        ),
+        until: str | None = typer.Option(
+            None, "--until", help="Last day, YYYY-MM-DD. Default: today."
+        ),
+    ) -> None:
+        """List recorded deploys."""
+        try:
+            end = date.fromisoformat(until) if until else date.today()
+            start = date.fromisoformat(since) if since else end - timedelta(days=6)
+        except ValueError as exc:
+            raise typer.BadParameter("dates are YYYY-MM-DD") from exc
+        print_json_or_exit(
+            console,
+            lambda: api_client.admin_list_ship_log(f"{start}T00:00:00", f"{end}T23:59:59"),
+        )
+
+    @command(
+        app,
+        "admin",
+        "update",
+        "ship-log",
+        api="PATCH /admin/ship-log/deploys/{deploy_id}",
+        side_effects=[
+            "the entry changes on the admin Ship log",
+            "a changed title or summary gets that day's standup rewritten on its next view",
+            "with --media, each file is uploaded to S3 and shown on the entry",
+        ],
+        approval="ask",
+        reversible=True,
+        idempotent=False,
+        help=(
+            "PATCH /admin/ship-log/deploys/{deploy_id} — fix an entry's title, summary or "
+            "watch note (pass --watch '' to clear it); --media attaches more recordings."
+        ),
+        epilog=_EPILOG,
+    )
+    def update_ship_log(
+        deploy_id: str = typer.Argument(..., help="deploy_id (from list ship-log)."),
+        title: str | None = typer.Option(None, "--title"),
+        summary: str | None = typer.Option(None, "--summary", "-s"),
+        watch: str | None = typer.Option(None, "--watch"),
+        kind: str | None = typer.Option(None, "--kind", "-k", help="feature or fix."),
+        ticket: str | None = typer.Option(None, "--ticket", "-t", help="Jira key or no-jira."),
+        media: list[str] = _media_option(),
+    ) -> None:
+        """Fix a ship log entry or attach recordings."""
+        body = {
+            k: v
+            for k, v in (
+                ("title", title),
+                ("summary", summary),
+                ("watch", watch),
+                ("kind", kind),
+                ("ticket", ticket),
+            )
+            if v is not None
+        }
+        files = _parse_media(media)
+        if not body and not files:
+            raise typer.BadParameter(
+                "nothing to change: pass --title, --summary, --watch, --kind, --ticket or --media"
+            )
+
+        def run() -> Any:
+            result: dict[str, Any] = {}
+            if body:
+                result = api_client.admin_update_ship_log(deploy_id, body)
+            if files:
+                result["media"] = _upload(deploy_id, files)
+            return result
+
+        print_json_or_exit(console, run)
+
+    @command(
+        app,
+        "admin",
+        "delete",
+        "ship-log",
+        api="DELETE /admin/ship-log/deploys/{deploy_id}",
+        side_effects=["the entry and its recordings are removed for the whole team"],
+        approval="ask",
+        reversible=False,
+        idempotent=True,
+        help="DELETE /admin/ship-log/deploys/{deploy_id} — remove an entry recorded by mistake.",
+        epilog=_EPILOG,
+    )
+    def delete_ship_log(
+        deploy_id: str = typer.Argument(..., help="deploy_id (from list ship-log)."),
+    ) -> None:
+        """Remove a ship log entry and its recordings."""
+        print_json_or_exit(console, lambda: api_client.admin_delete_ship_log(deploy_id))

{makea_cli-0.2.32 → makea_cli-0.2.34}/pyproject.toml

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

{makea_cli-0.2.32 → makea_cli-0.2.34}/tests/golden_manifest.json

@@ -758,6 +758,189 @@
         }
       ]
     },
+    {
+      "name": "admin create ship-log",
+      "persona": "admin",
+      "verb": "create",
+      "noun": "ship-log",
+      "access": "write",
+      "api": "POST /admin/ship-log/deploys",
+      "external": null,
+      "side_effects": [
+        "the deploy appears on the admin Ship log for the whole Makea team",
+        "the next person to open that day's standup gets it rewritten to include it",
+        "with --media, each file is uploaded to S3 and shown on the entry"
+      ],
+      "approval": "ask",
+      "reversible": true,
+      "idempotent": true,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /admin/ship-log/deploys — record one change going live, after the deploy succeeded. --ticket is its Jira key, or no-jira when it has none (shown as [no-jira]); --kind says whether it is a new feature or a bug fix. Title and summary are for the team: what changed for brands, factories or Makea, not how. The same ticket with the same commits on the same day returns the existing entry. --media uploads recordings (mp4, webm, mov) or screenshots (png, jpeg, webp, gif), up to 150 MB each.",
+      "function": "makea_cli.commands.shiplog.cmd.register.<locals>.create_ship_log",
+      "flags": [
+        {
+          "name": "ticket",
+          "kind": "option",
+          "opts": [
+            "--ticket",
+            "-t"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Jira key, e.g. TECH-218; no-jira when there is none."
+        },
+        {
+          "name": "kind",
+          "kind": "option",
+          "opts": [
+            "--kind",
+            "-k"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "feature (something new) or fix (a bug fixed)."
+        },
+        {
+          "name": "title",
+          "kind": "option",
+          "opts": [
+            "--title"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "What changed, in plain words."
+        },
+        {
+          "name": "summary",
+          "kind": "option",
+          "opts": [
+            "--summary",
+            "-s"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": "",
+          "help": "One or two sentences more."
+        },
+        {
+          "name": "backend",
+          "kind": "option",
+          "opts": [
+            "--backend"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": true,
+          "default": null,
+          "help": "garmentby-service commit(s)."
+        },
+        {
+          "name": "frontend",
+          "kind": "option",
+          "opts": [
+            "--frontend"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": true,
+          "default": null,
+          "help": "Frontend commit(s)."
+        },
+        {
+          "name": "cli",
+          "kind": "option",
+          "opts": [
+            "--cli"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": true,
+          "default": null,
+          "help": "makea-cli commit(s)."
+        },
+        {
+          "name": "miniprogram",
+          "kind": "option",
+          "opts": [
+            "--miniprogram"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": true,
+          "default": null,
+          "help": "Mini program commit(s)."
+        },
+        {
+          "name": "amplify_job",
+          "kind": "option",
+          "opts": [
+            "--amplify-job"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": "",
+          "help": "Amplify job number."
+        },
+        {
+          "name": "eb_version",
+          "kind": "option",
+          "opts": [
+            "--eb-version"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": "",
+          "help": "Elastic Beanstalk version label."
+        },
+        {
+          "name": "watch",
+          "kind": "option",
+          "opts": [
+            "--watch"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": "",
+          "help": "Something to do after it is live."
+        },
+        {
+          "name": "deployed_at",
+          "kind": "option",
+          "opts": [
+            "--deployed-at"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "When it went live, ISO UTC. Default: now."
+        },
+        {
+          "name": "media",
+          "kind": "option",
+          "opts": [
+            "--media",
+            "-m"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": true,
+          "default": null,
+          "help": "Recording or screenshot to attach, PATH or PATH::Title. Repeatable."
+        }
+      ]
+    },
     {
       "name": "admin create shipping-fee",
       "persona": "admin",
@@ -1576,6 +1759,39 @@
         }
       ]
     },
+    {
+      "name": "admin delete ship-log",
+      "persona": "admin",
+      "verb": "delete",
+      "noun": "ship-log",
+      "access": "write",
+      "api": "DELETE /admin/ship-log/deploys/{deploy_id}",
+      "external": null,
+      "side_effects": [
+        "the entry and its recordings are removed for the whole team"
+      ],
+      "approval": "ask",
+      "reversible": false,
+      "idempotent": true,
+      "limit": null,
+      "legacy": [],
+      "help": "DELETE /admin/ship-log/deploys/{deploy_id} — remove an entry recorded by mistake.",
+      "function": "makea_cli.commands.shiplog.cmd.register.<locals>.delete_ship_log",
+      "flags": [
+        {
+          "name": "deploy_id",
+          "kind": "argument",
+          "opts": [
+            "deploy_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "deploy_id (from list ship-log)."
+        }
+      ]
+    },
     {
       "name": "admin delete shipping-fee",
       "persona": "admin",
@@ -3804,6 +4020,49 @@
         }
       ]
     },
+    {
+      "name": "admin list ship-log",
+      "persona": "admin",
+      "verb": "list",
+      "noun": "ship-log",
+      "access": "read",
+      "api": "GET /admin/ship-log/deploys",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": "client",
+      "legacy": [],
+      "help": "GET /admin/ship-log/deploys — deploys between two UTC days, newest first: deploy_id, ticket, title, summary, watch, commits, amplify_job, deployed_at, media.",
+      "function": "makea_cli.commands.shiplog.cmd.register.<locals>.list_ship_log",
+      "flags": [
+        {
+          "name": "since",
+          "kind": "option",
+          "opts": [
+            "--since"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "First day, YYYY-MM-DD. Default: 6 days ago."
+        },
+        {
+          "name": "until",
+          "kind": "option",
+          "opts": [
+            "--until"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Last day, YYYY-MM-DD. Default: today."
+        }
+      ]
+    },
     {
       "name": "admin list shipping-order",
       "persona": "admin",
@@ -6564,6 +6823,117 @@
         }
       ]
     },
+    {
+      "name": "admin update ship-log",
+      "persona": "admin",
+      "verb": "update",
+      "noun": "ship-log",
+      "access": "write",
+      "api": "PATCH /admin/ship-log/deploys/{deploy_id}",
+      "external": null,
+      "side_effects": [
+        "the entry changes on the admin Ship log",
+        "a changed title or summary gets that day's standup rewritten on its next view",
+        "with --media, each file is uploaded to S3 and shown on the entry"
+      ],
+      "approval": "ask",
+      "reversible": true,
+      "idempotent": false,
+      "limit": null,
+      "legacy": [],
+      "help": "PATCH /admin/ship-log/deploys/{deploy_id} — fix an entry's title, summary or watch note (pass --watch '' to clear it); --media attaches more recordings.",
+      "function": "makea_cli.commands.shiplog.cmd.register.<locals>.update_ship_log",
+      "flags": [
+        {
+          "name": "deploy_id",
+          "kind": "argument",
+          "opts": [
+            "deploy_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "deploy_id (from list ship-log)."
+        },
+        {
+          "name": "title",
+          "kind": "option",
+          "opts": [
+            "--title"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": null
+        },
+        {
+          "name": "summary",
+          "kind": "option",
+          "opts": [
+            "--summary",
+            "-s"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": null
+        },
+        {
+          "name": "watch",
+          "kind": "option",
+          "opts": [
+            "--watch"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": null
+        },
+        {
+          "name": "kind",
+          "kind": "option",
+          "opts": [
+            "--kind",
+            "-k"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "feature or fix."
+        },
+        {
+          "name": "ticket",
+          "kind": "option",
+          "opts": [
+            "--ticket",
+            "-t"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Jira key or no-jira."
+        },
+        {
+          "name": "media",
+          "kind": "option",
+          "opts": [
+            "--media",
+            "-m"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": true,
+          "default": null,
+          "help": "Recording or screenshot to attach, PATH or PATH::Title. Repeatable."
+        }
+      ]
+    },
     {
       "name": "admin update shipping-order",
       "persona": "admin",

makea_cli-0.2.32/makea_cli/__init__.py

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