makea-cli 0.2.20__tar.gz → 0.2.21__tar.gz

{makea_cli-0.2.20 → makea_cli-0.2.21}/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.2.21
+
+New: the Makea team's task queue. Needs the backend from the same day
+(`/admin/tasks`).
+
+- `admin list task [--kind …] [--user …] [--product …]`: open Makea tasks by
+  kind: `unknown` (a lesson Beeboo held because nobody said why), `once` (read
+  as one order's problem), `note` (a slip of Makea's or the platform's),
+  `sample_price`, `pp_sample`, `brand_ask`; with `--user`, that account's own
+  cards the team may settle (`setting`).
+- `admin get task <id>`: one task with what settles it, and for a held lesson
+  the finding behind it.
+- `admin update task <id> --done | --dismiss --note …`: close it. On a held
+  lesson, `--reason … [--caused-by …] [--recurs | --once]` records what the
+  team found out, and Beeboo's next reading of the chats uses it. A task
+  marked done stays closed when the nightly reading raises the same fact.
+- `admin update user --billing-currency GBP`: the account's billing currency;
+  closes a "Set your billing currency" card.
+
 ## 0.2.20
 
 New: rules for a factory and for the whole platform, and an account's About

{makea_cli-0.2.20 → makea_cli-0.2.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.20
+Version: 0.2.21
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -123,6 +123,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get rule-history` | read | `GET /admin/playbook/rules/{rule_id}/history` | every revision of one rule: its words, who changed it and why, and the rule that replaced it. | — |
 | `makea-cli admin get shipping-order` | read | `GET /admin/shipping_orders/{shipping_order_id}/details` | one shipment with its production and sampling orders, freight quotes, fees, tracking and address. | — |
 | `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 task` | read | `GET /admin/tasks/{task_id}` | one Makea task in full: body, admin link, what settles it, and for a held lesson the finding Beeboo kept. | — |
 | `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 | `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` |
@@ -137,6 +138,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin list shipping-order` | read | `GET /admin/shipping_orders` | paginated list of all shipping orders (admin). | `list-all-shipping-orders` |
 | `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; `--user` adds that account's own `account.*` cards. | — |
 | `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` |
@@ -151,6 +153,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/{target}/rules/{rule_id}` | change a rule's text, status, applies_to, when, mode or end date (--valid-until), on `--user` / `--supplier` / `--global`. --reason required; the rule keeps what it was before. | — |
 | `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}` | close a Makea task with a note: `--done` once handled (a held lesson's `--reason` goes to Beeboo's next reading), or `--dismiss`. | — |
 | `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.20 → makea_cli-0.2.21}/README.md

@@ -111,6 +111,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get rule-history` | read | `GET /admin/playbook/rules/{rule_id}/history` | every revision of one rule: its words, who changed it and why, and the rule that replaced it. | — |
 | `makea-cli admin get shipping-order` | read | `GET /admin/shipping_orders/{shipping_order_id}/details` | one shipment with its production and sampling orders, freight quotes, fees, tracking and address. | — |
 | `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 task` | read | `GET /admin/tasks/{task_id}` | one Makea task in full: body, admin link, what settles it, and for a held lesson the finding Beeboo kept. | — |
 | `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 | `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` |
@@ -125,6 +126,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin list shipping-order` | read | `GET /admin/shipping_orders` | paginated list of all shipping orders (admin). | `list-all-shipping-orders` |
 | `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; `--user` adds that account's own `account.*` cards. | — |
 | `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` |
@@ -139,6 +141,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/{target}/rules/{rule_id}` | change a rule's text, status, applies_to, when, mode or end date (--valid-until), on `--user` / `--supplier` / `--global`. --reason required; the rule keeps what it was before. | — |
 | `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}` | close a Makea task with a note: `--done` once handled (a held lesson's `--reason` goes to Beeboo's next reading), or `--dismiss`. | — |
 | `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.21/makea_cli/__init__.py

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

{makea_cli-0.2.20 → makea_cli-0.2.21}/makea_cli/api_client.py

@@ -1191,6 +1191,35 @@ def admin_delete_rule(base: str, rule_id: str, reason: str) -> Any:
     return delete_json(_rule_path(base, rule_id), body={"reason": reason})
 
 
+# --- admin: the Makea team's task queue -------------------------------------------
+
+
+def admin_list_tasks(
+    *,
+    kind: str | None = None,
+    type_: str | None = None,
+    user: str | None = None,
+    product: str | None = None,
+) -> Any:
+    """GET /admin/tasks — the team's open tasks; filters are comma-separated."""
+    params = {
+        k: v
+        for k, v in (("kind", kind), ("type", type_), ("user", user), ("product", product))
+        if v
+    }
+    return get_json("/admin/tasks", params=params or None)
+
+
+def admin_get_task(task_id: str) -> Any:
+    """GET /admin/tasks/{task_id} — one task, with Beeboo's finding behind it."""
+    return get_json(f"/admin/tasks/{quote(task_id, safe='')}")
+
+
+def admin_close_task(task_id: str, verb: str, body: dict[str, Any]) -> Any:
+    """POST /admin/tasks/{task_id}/{done|dismiss} — {note, reason?, caused_by?, recurs?}."""
+    return post_json(f"/admin/tasks/{quote(task_id, safe='')}/{verb}", body)
+
+
 # --- 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.20 → makea_cli-0.2.21}/makea_cli/commands/__init__.py

@@ -19,6 +19,7 @@ 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.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
 
 
 def register_all(app: typer.Typer) -> None:
@@ -39,3 +40,4 @@ def register_all(app: typer.Typer) -> None:
     register_brand(app)
     register_playbook(app)
     register_about(app)
+    register_tasks(app)

{makea_cli-0.2.20 → makea_cli-0.2.21}/makea_cli/commands/directory/cmd.py

@@ -232,6 +232,15 @@ def register(app: typer.Typer) -> None:
             "--company-certificate-document-id",
             help="Optional company-certificate document ID already stored under the user.",
         ),
+        billing_currency: str | None = typer.Option(
+            None,
+            "--billing-currency",
+            help=(
+                "Optional ISO code (GBP, USD, EUR…) the account bills in. Every product "
+                "nothing is paid on yet follows, and a 'Set your billing currency' card "
+                "closes."
+            ),
+        ),
     ) -> None:
         """
         Admin: update a user's DDB profile fields and/or Cognito custom:userType.
@@ -262,6 +271,10 @@ def register(app: typer.Typer) -> None:
             ("referral_type", referral_type),
             ("referral_detail", referral_detail),
             ("company_certificate_document_id", company_certificate_document_id),
+            (
+                "billing_currency",
+                billing_currency.strip().upper() if billing_currency is not None else None,
+            ),
         ]
         for key, value in scalar_options:
             if value is not None:

{makea_cli-0.2.20 → makea_cli-0.2.21}/makea_cli/commands/playbook/cmd.py

@@ -15,6 +15,8 @@ one of three targets:
 Every write needs ``--reason``. The rule keeps it as an evidence entry
 (``admin_add`` / ``admin_edit`` / ``admin_delete`` with who, why, when and,
 for edits and deletes, what the rule was before), and the audit log records it.
+``--reason`` is the change log and the brand never reads it; ``--why`` and
+``--proof`` are what the brand reads under the rule on Knowledge > Rules.
 ``delete`` archives: the rule leaves the brand's Rules page and every prompt,
 the row stays as the record, and ``update --status active`` brings it back.
 """
@@ -55,6 +57,11 @@ when there is no team); --scope overrides.
 style, collection, supplier, element (e.g. supplier:sup_123:Ningbo Knit).
 "all" (update only) widens it back to the whole account.
 
+--why is the reason the brand reads under the rule; --proof (repeatable) is
+one message behind it, WHO|YYYY-MM-DD|TEXT or WHO|TEXT, WHO being Brand,
+Factory, record or a name. Both are kept apart from --reason, which only
+admins see. A later --why/--proof replaces the earlier pair.
+
 --when is which products it is for, as JSON:
   '{"categories": ["knitwear"], "service_modes": ["cmt"]}'
 Order conditions the rule already has (units, destination) are kept; {} means
@@ -64,7 +71,9 @@ Examples
   makea-cli admin list rule --user brand@example.com
   makea-cli admin get rule rul_0123456789ab --user brand@example.com
   makea-cli admin create rule --user brand@example.com \\
-      --text "Always book DHL Express for samples" --reason "Agreed on the 14 Oct call"
+      --text "Always book DHL Express for samples" --reason "Agreed on the 14 Oct call" \\
+      --why "Two sample parcels were lost with the economy courier" \\
+      --proof "Brand|2026-10-14|Please only use DHL Express for samples from now on"
   makea-cli admin update rule rul_0123456789ab --user brand@example.com \\
       --status muted --reason "Brand asked to pause it by email"
   makea-cli admin delete rule rul_0123456789ab --user brand@example.com \\
@@ -114,6 +123,49 @@ def _reason(raw: str) -> str:
     return reason
 
 
+def _why_option() -> Any:
+    return typer.Option(
+        None, "--why", help="Why the rule exists, as the brand reads it (max 300 chars)."
+    )
+
+
+def _proof_option() -> Any:
+    return typer.Option(
+        None,
+        "--proof",
+        help="A message behind the rule, WHO|YYYY-MM-DD|TEXT or WHO|TEXT (repeatable, max 5).",
+    )
+
+
+def _proof(raw: list[str]) -> list[dict[str, str]]:
+    out = []
+    for item in raw:
+        parts = [p.strip() for p in item.split("|", 2)]
+        if len(parts) == 3:
+            who, at, text = parts
+            try:
+                at = date.fromisoformat(at).isoformat()
+            except ValueError as e:
+                raise typer.BadParameter(f"--proof date must be YYYY-MM-DD: {item}") from e
+        elif len(parts) == 2:
+            (who, text), at = parts, ""
+        else:
+            raise typer.BadParameter(f"--proof must be WHO|YYYY-MM-DD|TEXT: {item}")
+        if not who or not text:
+            raise typer.BadParameter(f"--proof needs who and text: {item}")
+        out.append({"who": who, "at": at, "text": text})
+    if len(out) > 5:
+        raise typer.BadParameter("--proof at most 5 times")
+    return out
+
+
+def _basis(body: dict[str, Any], why: str | None, proof: list[str] | None) -> None:
+    if why is not None and why.strip():
+        body["why"] = " ".join(why.split())
+    if proof:
+        body["proof"] = _proof(proof)
+
+
 def _applies_to(raw: str) -> dict[str, str]:
     if raw.strip().lower() == "all":
         return {"kind": "all"}
@@ -348,6 +400,8 @@ def register(app: typer.Typer) -> None:
             "--valid-until",
             help="YYYY-MM-DD the rule ends on (a closure, a temporary arrangement).",
         ),
+        why: str | None = _why_option(),
+        proof: list[str] | None = _proof_option(),
     ) -> None:
         """Add a playbook rule for a person, a factory or everyone."""
         base = _target(user, supplier, is_global)
@@ -374,6 +428,7 @@ def register(app: typer.Typer) -> None:
             body["force"] = True
         if valid_until is not None:
             body["valid_until"] = _date(valid_until)
+        _basis(body, why, proof)
         print_json_or_exit(console, lambda: api_client.admin_create_rule(base, body))
 
     @command(
@@ -391,7 +446,8 @@ def register(app: typer.Typer) -> None:
         idempotent=True,
         help=(
             "PATCH /admin/playbook/{target}/rules/{rule_id} — change a rule's text, "
-            "status, applies_to, when or mode. --reason required; the rule keeps what it was before."
+            "status, applies_to, when, mode, or the --why/--proof the brand reads. --reason "
+            "required; the rule keeps what it was before."
         ),
         epilog=_RULES_EPILOG,
     )
@@ -415,6 +471,8 @@ def register(app: typer.Typer) -> None:
             "--valid-until",
             help='YYYY-MM-DD the rule ends on; "none" removes the end date.',
         ),
+        why: str | None = _why_option(),
+        proof: list[str] | None = _proof_option(),
     ) -> None:
         """Edit a playbook rule."""
         base = _target(user, supplier, is_global)
@@ -433,10 +491,11 @@ def register(app: typer.Typer) -> None:
             body["valid_until"] = (
                 "" if valid_until.strip().lower() == "none" else _date(valid_until)
             )
+        _basis(body, why, proof)
         if not body:
             raise typer.BadParameter(
-                "nothing to change: pass --text, --status, --applies-to, --when, --mode "
-                "or --valid-until"
+                "nothing to change: pass --text, --status, --applies-to, --when, --mode, "
+                "--valid-until, --why or --proof"
             )
         body["reason"] = _reason(reason)
         print_json_or_exit(console, lambda: api_client.admin_update_rule(base, rule_id, body))

makea_cli-0.2.21/makea_cli/commands/tasks/cmd.py

@@ -0,0 +1,159 @@
+"""Admin commands for the Makea team's task queue.
+
+A *task* is a card the Makea team owns: Beeboo's notes from reading the chats
+(a lesson it held back from the brand's rules, or a slip of the platform's),
+a sample priced far above bulk, a PP sample to see through, a brand's ask in
+the concierge thread. With ``--user``, an account's own cards the team may
+settle for it (``account.*``, such as its billing currency) are listed too.
+
+Kinds: ``unknown`` (a lesson nobody said the reason for), ``once`` (a lesson
+read as one order's problem), ``note`` (a slip of Makea's or the platform's),
+``sample_price``, ``pp_sample``, ``brand_ask``, ``setting``.
+
+The change a task asks for is made with the command that owns it (``admin
+create rule``, ``admin update user``, ``admin update about`` …); ``update
+task --done`` then records that it was handled. Only notes the team handles
+off the platform can be marked done; the others close by themselves when the
+fact behind them lands, and ``get task`` says which fact.
+"""
+
+from __future__ import annotations
+
+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()
+
+_CAUSES = ("factory", "brand", "makea", "outside")
+
+_TASKS_EPILOG = """
+Kinds: unknown (a lesson nobody said why), once (one order's problem),
+note (a slip of Makea's or the platform's), sample_price, pp_sample,
+brand_ask, setting.
+
+Examples
+  makea-cli admin list task --kind unknown,once
+  makea-cli admin list task --user brand@example.com
+  makea-cli admin get task 4d85c843-3888-500e-adb2-207f0f07110d
+  makea-cli admin update task <task_id> --done --note "Asked the brand on WhatsApp" \\
+      --reason "The brand changed the cuff after approval" --caused-by brand --once
+  makea-cli admin update task <task_id> --dismiss --note "Brand keeps GBP"
+""".strip()
+
+
+def register(app: typer.Typer) -> None:
+    @command(
+        app,
+        "admin",
+        "list",
+        "task",
+        api="GET /admin/tasks",
+        help=(
+            "GET /admin/tasks — the Makea team's open tasks: task_id, type, kind, title, "
+            "owner (the account), product, due date, can_mark_done; counts by kind. "
+            "--user adds that account's own cards the team may settle (account.*)."
+        ),
+        epilog=_TASKS_EPILOG,
+    )
+    def list_tasks(
+        kind: str | None = typer.Option(
+            None, "--kind", "-k", help="Only these kinds, comma-separated."
+        ),
+        type_: str | None = typer.Option(
+            None, "--type", help="Only these action types, e.g. makea.beeboo_note."
+        ),
+        user: str | None = typer.Option(
+            None, "--user", "-u", help="One account: user_id or email."
+        ),
+        product: str | None = typer.Option(None, "--product", "-p", help="One product id."),
+    ) -> None:
+        """List the Makea team's open tasks."""
+        print_json_or_exit(
+            console,
+            lambda: api_client.admin_list_tasks(kind=kind, type_=type_, user=user, product=product),
+        )
+
+    @command(
+        app,
+        "admin",
+        "get",
+        "task",
+        api="GET /admin/tasks/{task_id}",
+        help=(
+            "GET /admin/tasks/{task_id} — one task in full: body, context, admin_url, "
+            "next (what settles it), and for a held lesson the finding Beeboo kept "
+            "(problem, factory, product, reason so far)."
+        ),
+        epilog=_TASKS_EPILOG,
+    )
+    def get_task(task_id: str = typer.Argument(..., help="Task id (from list task).")) -> None:
+        """Show one task and what settles it."""
+        print_json_or_exit(console, lambda: api_client.admin_get_task(task_id))
+
+    @command(
+        app,
+        "admin",
+        "update",
+        "task",
+        api="POST /admin/tasks/{task_id}/{done|dismiss}",
+        side_effects=[
+            "closes the task for the whole Makea team",
+            "with --reason, Beeboo's next reading of the chats uses that reason",
+        ],
+        approval="ask",
+        reversible=False,
+        idempotent=False,
+        help=(
+            "POST /admin/tasks/{task_id}/{done|dismiss} — close a task: --done once it is "
+            "handled (notes the team handles off the platform only), --dismiss when it "
+            "will not be done. --note required. On a held lesson, --reason records why "
+            "it happened for Beeboo's next reading."
+        ),
+        epilog=_TASKS_EPILOG,
+    )
+    def update_task(
+        task_id: str = typer.Argument(..., help="Task id (from list task)."),
+        done: bool = typer.Option(False, "--done", help="It was handled."),
+        dismiss: bool = typer.Option(False, "--dismiss", help="It will not be done."),
+        note: str = typer.Option(..., "--note", "-n", help="What was done, or why not (required)."),
+        reason: str | None = typer.Option(
+            None,
+            "--reason",
+            help="With --done on a held lesson: why it happened, as the team found out.",
+        ),
+        caused_by: str | None = typer.Option(
+            None, "--caused-by", help=f"With --reason: {', '.join(_CAUSES)}."
+        ),
+        recurs: bool | None = typer.Option(
+            None,
+            "--recurs/--once",
+            help="With --reason: it will happen again, or it was this order only.",
+        ),
+    ) -> None:
+        """Mark a task done, or dismiss it."""
+        if done == dismiss:
+            raise typer.BadParameter("pass exactly one of --done, --dismiss")
+        clean_note = " ".join(note.split())
+        if not clean_note:
+            raise typer.BadParameter("--note must not be empty")
+        body: dict[str, Any] = {"note": clean_note}
+        if reason is not None:
+            if not done:
+                raise typer.BadParameter("--reason goes with --done")
+            body["reason"] = " ".join(reason.split())
+            if caused_by is not None:
+                if caused_by not in _CAUSES:
+                    raise typer.BadParameter(f"--caused-by: one of {', '.join(_CAUSES)}")
+                body["caused_by"] = caused_by
+            if recurs is not None:
+                body["recurs"] = recurs
+        elif caused_by is not None or recurs is not None:
+            raise typer.BadParameter("--caused-by and --recurs/--once go with --reason")
+        verb = "done" if done else "dismiss"
+        print_json_or_exit(console, lambda: api_client.admin_close_task(task_id, verb, body))

{makea_cli-0.2.20 → makea_cli-0.2.21}/pyproject.toml

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

{makea_cli-0.2.20 → makea_cli-0.2.21}/tests/golden_manifest.json

@@ -522,6 +522,30 @@
           "multiple": false,
           "default": null,
           "help": "YYYY-MM-DD the rule ends on (a closure, a temporary arrangement)."
+        },
+        {
+          "name": "why",
+          "kind": "option",
+          "opts": [
+            "--why"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Why the rule exists, as the brand reads it (max 300 chars)."
+        },
+        {
+          "name": "proof",
+          "kind": "option",
+          "opts": [
+            "--proof"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": true,
+          "default": null,
+          "help": "A message behind the rule, WHO|YYYY-MM-DD|TEXT or WHO|TEXT (repeatable, max 5)."
         }
       ]
     },
@@ -2496,6 +2520,37 @@
       "function": "makea_cli.commands.supplier.cmd.register.<locals>.get_supplier_profile_schema",
       "flags": []
     },
+    {
+      "name": "admin get task",
+      "persona": "admin",
+      "verb": "get",
+      "noun": "task",
+      "access": "read",
+      "api": "GET /admin/tasks/{task_id}",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": null,
+      "legacy": [],
+      "help": "GET /admin/tasks/{task_id} — one task in full: body, context, admin_url, next (what settles it), and for a held lesson the finding Beeboo kept (problem, factory, product, reason so far).",
+      "function": "makea_cli.commands.tasks.cmd.register.<locals>.get_task",
+      "flags": [
+        {
+          "name": "task_id",
+          "kind": "argument",
+          "opts": [
+            "task_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Task id (from list task)."
+        }
+      ]
+    },
     {
       "name": "admin get tech-spec-extraction",
       "persona": "admin",
@@ -3236,6 +3291,76 @@
         }
       ]
     },
+    {
+      "name": "admin list task",
+      "persona": "admin",
+      "verb": "list",
+      "noun": "task",
+      "access": "read",
+      "api": "GET /admin/tasks",
+      "external": null,
+      "side_effects": [],
+      "approval": "auto",
+      "reversible": null,
+      "idempotent": null,
+      "limit": "client",
+      "legacy": [],
+      "help": "GET /admin/tasks — the Makea team's open tasks: task_id, type, kind, title, owner (the account), product, due date, can_mark_done; counts by kind. --user adds that account's own cards the team may settle (account.*).",
+      "function": "makea_cli.commands.tasks.cmd.register.<locals>.list_tasks",
+      "flags": [
+        {
+          "name": "kind",
+          "kind": "option",
+          "opts": [
+            "--kind",
+            "-k"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Only these kinds, comma-separated."
+        },
+        {
+          "name": "type_",
+          "kind": "option",
+          "opts": [
+            "--type"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Only these action types, e.g. makea.beeboo_note."
+        },
+        {
+          "name": "user",
+          "kind": "option",
+          "opts": [
+            "--user",
+            "-u"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "One account: user_id or email."
+        },
+        {
+          "name": "product",
+          "kind": "option",
+          "opts": [
+            "--product",
+            "-p"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "One product id."
+        }
+      ]
+    },
     {
       "name": "admin list user",
       "persona": "admin",
@@ -4934,7 +5059,7 @@
       "idempotent": true,
       "limit": null,
       "legacy": [],
-      "help": "PATCH /admin/playbook/{target}/rules/{rule_id} — change a rule's text, status, applies_to, when or mode. --reason required; the rule keeps what it was before.",
+      "help": "PATCH /admin/playbook/{target}/rules/{rule_id} — change a rule's text, status, applies_to, when, mode, or the --why/--proof the brand reads. --reason required; the rule keeps what it was before.",
       "function": "makea_cli.commands.playbook.cmd.register.<locals>.update_rule",
       "flags": [
         {
@@ -5070,6 +5195,30 @@
           "multiple": false,
           "default": null,
           "help": "YYYY-MM-DD the rule ends on; \"none\" removes the end date."
+        },
+        {
+          "name": "why",
+          "kind": "option",
+          "opts": [
+            "--why"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Why the rule exists, as the brand reads it (max 300 chars)."
+        },
+        {
+          "name": "proof",
+          "kind": "option",
+          "opts": [
+            "--proof"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": true,
+          "default": null,
+          "help": "A message behind the rule, WHO|YYYY-MM-DD|TEXT or WHO|TEXT (repeatable, max 5)."
         }
       ]
     },
@@ -5262,6 +5411,113 @@
         }
       ]
     },
+    {
+      "name": "admin update task",
+      "persona": "admin",
+      "verb": "update",
+      "noun": "task",
+      "access": "write",
+      "api": "POST /admin/tasks/{task_id}/{done|dismiss}",
+      "external": null,
+      "side_effects": [
+        "closes the task for the whole Makea team",
+        "with --reason, Beeboo's next reading of the chats uses that reason"
+      ],
+      "approval": "ask",
+      "reversible": false,
+      "idempotent": false,
+      "limit": null,
+      "legacy": [],
+      "help": "POST /admin/tasks/{task_id}/{done|dismiss} — close a task: --done once it is handled (notes the team handles off the platform only), --dismiss when it will not be done. --note required. On a held lesson, --reason records why it happened for Beeboo's next reading.",
+      "function": "makea_cli.commands.tasks.cmd.register.<locals>.update_task",
+      "flags": [
+        {
+          "name": "task_id",
+          "kind": "argument",
+          "opts": [
+            "task_id"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "Task id (from list task)."
+        },
+        {
+          "name": "done",
+          "kind": "option",
+          "opts": [
+            "--done"
+          ],
+          "type": "flag",
+          "required": false,
+          "multiple": false,
+          "default": false,
+          "help": "It was handled."
+        },
+        {
+          "name": "dismiss",
+          "kind": "option",
+          "opts": [
+            "--dismiss"
+          ],
+          "type": "flag",
+          "required": false,
+          "multiple": false,
+          "default": false,
+          "help": "It will not be done."
+        },
+        {
+          "name": "note",
+          "kind": "option",
+          "opts": [
+            "--note",
+            "-n"
+          ],
+          "type": "text",
+          "required": true,
+          "multiple": false,
+          "default": null,
+          "help": "What was done, or why not (required)."
+        },
+        {
+          "name": "reason",
+          "kind": "option",
+          "opts": [
+            "--reason"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "With --done on a held lesson: why it happened, as the team found out."
+        },
+        {
+          "name": "caused_by",
+          "kind": "option",
+          "opts": [
+            "--caused-by"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "With --reason: factory, brand, makea, outside."
+        },
+        {
+          "name": "recurs",
+          "kind": "option",
+          "opts": [
+            "--recurs"
+          ],
+          "type": "flag",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "With --reason: it will happen again, or it was this order only."
+        }
+      ]
+    },
     {
       "name": "admin update tech-spec",
       "persona": "admin",
@@ -5677,6 +5933,18 @@
           "multiple": false,
           "default": null,
           "help": "Optional company-certificate document ID already stored under the user."
+        },
+        {
+          "name": "billing_currency",
+          "kind": "option",
+          "opts": [
+            "--billing-currency"
+          ],
+          "type": "text",
+          "required": false,
+          "multiple": false,
+          "default": null,
+          "help": "Optional ISO code (GBP, USD, EUR…) the account bills in. Every product nothing is paid on yet follows, and a 'Set your billing currency' card closes."
         }
       ]
     },
@@ -9646,4 +9914,4 @@
       ]
     }
   ]
-}
+}

{makea_cli-0.2.20 → makea_cli-0.2.21}/tests/test_persona_commands.py

@@ -639,3 +639,58 @@ class AboutCommandTests(_PersonaCase):
         )  # fmt: skip
         self.run_cli("admin", "generate", "about", "-u", "u1", "--force", expect=2)
         self.assertEqual(self.rec.calls, [])
+
+
+class TaskCommandTests(_PersonaCase):
+    """admin … task: the Makea team's queue. Closing one needs a note."""
+
+    persona = "admin"
+
+    def test_list_passes_its_filters(self):
+        self.run_cli("admin", "list", "task")
+        self.assertEqual((self.rec.last["path"], self.rec.last["params"]), ("/admin/tasks", None))
+        self.run_cli("admin", "list", "task", "--kind", "unknown,once", "-u", "b@x.co")
+        self.assertEqual(self.rec.last["params"], {"kind": "unknown,once", "user": "b@x.co"})
+
+    def test_get_reads_one(self):
+        self.run_cli("admin", "get", "task", "t1")
+        self.assertEqual(self.rec.last["path"], "/admin/tasks/t1")
+
+    def test_done_with_what_the_team_found_out(self):
+        self.run_cli(
+            "admin", "update", "task", "t1", "--done", "--note", " asked  the brand ",
+            "--reason", "cuff changed after approval", "--caused-by", "brand", "--once",
+        )  # fmt: skip
+        self.assertEqual(
+            (self.rec.last["method"], self.rec.last["path"], self.rec.last["body"]),
+            (
+                "POST",
+                "/admin/tasks/t1/done",
+                {
+                    "note": "asked the brand",
+                    "reason": "cuff changed after approval",
+                    "caused_by": "brand",
+                    "recurs": False,
+                },
+            ),
+        )
+        self.run_cli("admin", "update", "task", "t1", "--dismiss", "--note", "keeps GBP")
+        self.assertEqual(self.rec.last["path"], "/admin/tasks/t1/dismiss")
+
+    def test_refused_before_the_backend(self):
+        self.run_cli("admin", "update", "task", "t1", "--note", "x", expect=2)
+        self.run_cli("admin", "update", "task", "t1", "--done", "--dismiss", "-n", "x", expect=2)
+        self.run_cli("admin", "update", "task", "t1", "--done", expect=2)
+        self.run_cli(
+            "admin", "update", "task", "t1", "--dismiss", "-n", "x", "--reason", "r", expect=2
+        )
+        self.run_cli(
+            "admin", "update", "task", "t1", "--done", "-n", "x", "--reason", "r",
+            "--caused-by", "weather", expect=2,
+        )  # fmt: skip
+        self.run_cli("admin", "update", "task", "t1", "--done", "-n", "x", "--once", expect=2)
+        self.assertEqual(self.rec.calls, [])
+
+    def test_update_user_sets_the_billing_currency(self):
+        self.run_cli("admin", "update", "user", "u1", "--billing-currency", "gbp")
+        self.assertEqual(self.rec.last["body"], {"billing_currency": "GBP"})

{makea_cli-0.2.20 → makea_cli-0.2.21}/uv.lock

@@ -115,7 +115,7 @@ wheels = [
 
 [[package]]
 name = "makea-cli"
-version = "0.2.19"
+version = "0.2.21"
 source = { editable = "." }
 dependencies = [
     { name = "click" },

makea_cli-0.2.20/makea_cli/__init__.py

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