makea-cli 0.2.26__tar.gz → 0.2.28__tar.gz

{makea_cli-0.2.26 → makea_cli-0.2.28}/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 0.2.28
+
+Read the files brands send that no model reads (TECH-143).
+
+`makea-cli designer get file <path>` (also `supplier` and `admin`) reads a file
+on this machine and saves PNG pictures of what it draws next to it. No API call.
+
+- Pattern DXF (AAMA/ASTM, Gerber, Optitex, Chinese CAD): every piece with its
+  sizes, cut quantity, size, seam allowance, notches and grain line, and a sheet
+  of the pieces. Chinese piece names come out right (GBK).
+- RUL grade rules: sizes, sample size, units, the rules.
+- Illustrator: as the PDF it holds, or, when it was saved without PDF content
+  (CorelDRAW's AI export), drawn from Illustrator's own data.
+- EPS: header facts and its preview picture. Photoshop: size, layers, picture.
+- Embroidery: PES, DST, EXP, JEF, VP3 and more (size, stitches, threads,
+  stitch-out); Wilcom EMB (stitches, threads, fabric, backing, preview).
+- ZIP: every file inside, each read the same way. AVIF, TIFF, BMP: as pictures.
+  SVG: size, colours, text.
+- Anything else says what it is and what to export instead.
+
+The same reader (`makea_cli.file_reader`) is what the Makea backend uses to read
+these uploads for the tech pack and to preview them.
+
+## 0.2.27
+
+Notes and misfires on the Makea task queue.
+
+- `admin update task <id> --note "…"` alone adds a note (who was asked, what
+  the team is waiting on) and leaves the task open.
+- `admin update task <id> --dismiss --wrong --note "…"`: the task should never
+  have been raised, and the note says why. On a lesson Beeboo held, its next
+  reading of the chats is told and raises nothing on the same message again.
+- `admin list task --wrong`: every task marked wrong, newest first, with why.
+
+The same queue is on the admin page under Makea tasks.
+
 ## 0.2.26
 
 The admin page is now the CLI's companion. Every `makea-cli admin …` result

{makea_cli-0.2.26 → makea_cli-0.2.28}/PKG-INFO

@@ -1,11 +1,15 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.26
+Version: 0.2.28
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
 Requires-Dist: httpx>=0.27
+Requires-Dist: olefile>=0.47
+Requires-Dist: pillow>=11.3
 Requires-Dist: platformdirs>=4.2
+Requires-Dist: pyembroidery>=1.5
+Requires-Dist: pypdfium2>=4.30
 Requires-Dist: rich>=13.7
 Requires-Dist: typer<0.25,>=0.12
 Description-Content-Type: text/markdown
@@ -118,6 +122,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get about` | read | `GET /admin/about/{target}` | one account's About you (`--user`: a supplier account's person gets their factory's page; `--supplier`): facts, removed, unknown, paused, topic keys. | — |
 | `makea-cli admin get active-users` | read | `POST /admin/analytics/query` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
 | `makea-cli admin get analytics-query` | read | `POST /admin/analytics/query` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
+| `makea-cli admin get file` | read | local (makea_cli.file_reader) | read a pattern (DXF/RUL), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or AVIF/TIFF file on this machine; saves PNG pictures of what it draws next to it. No API call. | — |
 | `makea-cli admin get currency-conversion` | read | `GET /admin/fx/rates` | the platform's own exchange rates and rounding (rate table for several --from; one --from with --amount converts it). | `convert-currency` |
 | `makea-cli admin get feature-usage` | read | `POST /admin/analytics/query` | How many distinct users used a feature recently, plus event volume. Matches $pageview path and feature_time_spent eve… | `analytics-feature-usage` |
 | `makea-cli admin get growth-snapshot` | read | `GET /admin/growth/snapshots/{id}` | one reconciled Growth Analysis snapshot (default `latest`); `--block` prints one block (headline, gates, review_items, …). | — |
@@ -152,7 +157,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 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 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` |
@@ -175,7 +180,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update sampling-order` | write（ask） | `PUT /admin/sampling_orders/{sampling_order_id}/status` | move a sampling order to another status (DRAFT, IN_PROGRESS, SAMPLING_COMPLETED, APPROVAL, SHIPPED, DELIVERED, CANCELLED). PAID is recorded by the payment and is refused here. Prefer admin update product-step, which moves the same statuses through the step model. | — |
 | `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 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 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` |
@@ -202,6 +207,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer delete sampling-order` | write（never） | `DELETE /designer/sampling_orders/{sampling_order_id}` | delete a DRAFT sample order. The backend refuses any other status. Graded `never`. | — |
 | `makea-cli designer delete shipping-order` | write（never） | `POST /designer/shipping_orders/{shipping_order_id}/cancel` | the endpoint is called cancel but it unlinks every production order and removes the shipment, so it is a delete here.… | — |
 | `makea-cli designer download document` | read | `GET /designer/document/download` | save bytes for user_id + document_id (designer-authenticated; same query contract as admin document download). | `designer-download-document` |
+| `makea-cli designer get file` | read | local (makea_cli.file_reader) | read a pattern (DXF/RUL), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or AVIF/TIFF file on this machine; saves PNG pictures of what it draws next to it. No API call. | — |
 | `makea-cli designer get collection` | read | `GET /designer/collections/{collection_id}/overview` | one collection with its products, orders and lifecycle in a single read. | — |
 | `makea-cli designer get lifecycle` | read | `GET /designer/product_orders/{product_order_id}/lifecycle` | which stage this product is in. | — |
 | `makea-cli designer get product` | read | `GET /designer/get_product` | one product: status, documents, prices, links. | — |
@@ -245,6 +251,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 |---|---|---|---|---|
 | `makea-cli supplier create note` | write（ask） | `POST /supplier/products/{id}/channels/{key}/notes` | post a message into a product channel you are part of. | — |
 | `makea-cli supplier download document` | read | `GET /supplier/document/download` | save a document you are allowed to read. | — |
+| `makea-cli supplier get file` | read | local (makea_cli.file_reader) | read a pattern (DXF/RUL), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or AVIF/TIFF file on this machine; saves PNG pictures of what it draws next to it. No API call. | — |
 | `makea-cli supplier get pack` | read | `GET /supplier/quote_requests/{id}/technical-specifications` | the tech pack for an RFQ, as the factory is allowed to see it (`--readable`: labels, values and blank essentials only). | — |
 | `makea-cli supplier get pack-changes` | read | `GET /supplier/products/{product_id}/specification-change-history` | what changed in the pack since you quoted, field by field. | — |
 | `makea-cli supplier get profile` | read | `GET /supplier/profile` | your own supplier profile. | — |

{makea_cli-0.2.26 → makea_cli-0.2.28}/README.md

@@ -106,6 +106,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get about` | read | `GET /admin/about/{target}` | one account's About you (`--user`: a supplier account's person gets their factory's page; `--supplier`): facts, removed, unknown, paused, topic keys. | — |
 | `makea-cli admin get active-users` | read | `POST /admin/analytics/query` | Distinct active users per day over the last N days (DAU series). | `analytics-active-users` |
 | `makea-cli admin get analytics-query` | read | `POST /admin/analytics/query` | Run an arbitrary HogQL query (escape hatch). Example: analytics-query "SELECT count() FROM events" | `analytics-query` |
+| `makea-cli admin get file` | read | local (makea_cli.file_reader) | read a pattern (DXF/RUL), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or AVIF/TIFF file on this machine; saves PNG pictures of what it draws next to it. No API call. | — |
 | `makea-cli admin get currency-conversion` | read | `GET /admin/fx/rates` | the platform's own exchange rates and rounding (rate table for several --from; one --from with --amount converts it). | `convert-currency` |
 | `makea-cli admin get feature-usage` | read | `POST /admin/analytics/query` | How many distinct users used a feature recently, plus event volume. Matches $pageview path and feature_time_spent eve… | `analytics-feature-usage` |
 | `makea-cli admin get growth-snapshot` | read | `GET /admin/growth/snapshots/{id}` | one reconciled Growth Analysis snapshot (default `latest`); `--block` prints one block (headline, gates, review_items, …). | — |
@@ -140,7 +141,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 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 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` |
@@ -163,7 +164,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update sampling-order` | write（ask） | `PUT /admin/sampling_orders/{sampling_order_id}/status` | move a sampling order to another status (DRAFT, IN_PROGRESS, SAMPLING_COMPLETED, APPROVAL, SHIPPED, DELIVERED, CANCELLED). PAID is recorded by the payment and is refused here. Prefer admin update product-step, which moves the same statuses through the step model. | — |
 | `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 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 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` |
@@ -190,6 +191,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer delete sampling-order` | write（never） | `DELETE /designer/sampling_orders/{sampling_order_id}` | delete a DRAFT sample order. The backend refuses any other status. Graded `never`. | — |
 | `makea-cli designer delete shipping-order` | write（never） | `POST /designer/shipping_orders/{shipping_order_id}/cancel` | the endpoint is called cancel but it unlinks every production order and removes the shipment, so it is a delete here.… | — |
 | `makea-cli designer download document` | read | `GET /designer/document/download` | save bytes for user_id + document_id (designer-authenticated; same query contract as admin document download). | `designer-download-document` |
+| `makea-cli designer get file` | read | local (makea_cli.file_reader) | read a pattern (DXF/RUL), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or AVIF/TIFF file on this machine; saves PNG pictures of what it draws next to it. No API call. | — |
 | `makea-cli designer get collection` | read | `GET /designer/collections/{collection_id}/overview` | one collection with its products, orders and lifecycle in a single read. | — |
 | `makea-cli designer get lifecycle` | read | `GET /designer/product_orders/{product_order_id}/lifecycle` | which stage this product is in. | — |
 | `makea-cli designer get product` | read | `GET /designer/get_product` | one product: status, documents, prices, links. | — |
@@ -233,6 +235,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 |---|---|---|---|---|
 | `makea-cli supplier create note` | write（ask） | `POST /supplier/products/{id}/channels/{key}/notes` | post a message into a product channel you are part of. | — |
 | `makea-cli supplier download document` | read | `GET /supplier/document/download` | save a document you are allowed to read. | — |
+| `makea-cli supplier get file` | read | local (makea_cli.file_reader) | read a pattern (DXF/RUL), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or AVIF/TIFF file on this machine; saves PNG pictures of what it draws next to it. No API call. | — |
 | `makea-cli supplier get pack` | read | `GET /supplier/quote_requests/{id}/technical-specifications` | the tech pack for an RFQ, as the factory is allowed to see it (`--readable`: labels, values and blank essentials only). | — |
 | `makea-cli supplier get pack-changes` | read | `GET /supplier/products/{product_id}/specification-change-history` | what changed in the pack since you quoted, field by field. | — |
 | `makea-cli supplier get profile` | read | `GET /supplier/profile` | your own supplier profile. | — |

makea_cli-0.2.28/makea_cli/__init__.py

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

{makea_cli-0.2.26 → makea_cli-0.2.28}/makea_cli/api_client.py

@@ -1195,8 +1195,12 @@ def admin_list_tasks(
     type_: str | None = None,
     user: str | None = None,
     product: str | None = None,
+    wrong: bool = False,
 ) -> Any:
-    """GET /admin/tasks — the team's open tasks; filters are comma-separated."""
+    """GET /admin/tasks — the team's open tasks; filters are comma-separated.
+    ``wrong``: the tasks the team marked wrong instead, newest first."""
+    if wrong:
+        return get_json("/admin/tasks", params={"wrong": "1"})
     params = {
         k: v
         for k, v in (("kind", kind), ("type", type_), ("user", user), ("product", product))
@@ -1211,7 +1215,8 @@ def admin_get_task(task_id: str) -> Any:
 
 
 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?}."""
+    """POST /admin/tasks/{task_id}/{done|dismiss|note} — {note, reason?, caused_by?,
+    recurs?, wrong?}. ``note`` adds a note and leaves the task open."""
     return post_json(f"/admin/tasks/{quote(task_id, safe='')}/{verb}", body)
 
 

{makea_cli-0.2.26 → makea_cli-0.2.28}/makea_cli/commands/__init__.py

@@ -11,6 +11,7 @@ from makea_cli.commands.directory.cmd import register as register_directory
 from makea_cli.commands.document.cmd import register as register_document
 from makea_cli.commands.email.cmd import register as register_email
 from makea_cli.commands.factory.cmd import register as register_factory
+from makea_cli.commands.files.cmd import register as register_files
 from makea_cli.commands.flags.cmd import register as register_flags
 from makea_cli.commands.library.cmd import register as register_library
 from makea_cli.commands.metrics.cmd import register as register_metrics
@@ -38,6 +39,7 @@ def register_all(app: typer.Typer) -> None:
     register_email(app)
     register_library(app)
     register_factory(app)
+    register_files(app)
     register_brand(app)
     register_playbook(app)
     register_about(app)

makea_cli-0.2.28/makea_cli/commands/files/cmd.py

@@ -0,0 +1,84 @@
+"""``makea-cli <persona> get file PATH``: read a file a brand sent, locally.
+
+Pattern DXF/RUL, Illustrator, EPS, Photoshop, embroidery (PES/DST/EMB), ZIP,
+AVIF/TIFF/SVG. No API call: the file never leaves the machine. Pictures of what
+the file draws are saved next to it so the caller can look at them (an agent
+reads them with its image tool).
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+import typer
+from rich.console import Console
+
+from makea_cli.commands._util import print_json_or_exit
+from makea_cli.file_reader import read_path
+from makea_cli.registry import command
+
+console = Console()
+
+_HELP = (
+    "Read a pattern (DXF/RUL), artwork (AI/EPS/PSD/SVG), embroidery (PES/DST/EMB), ZIP or "
+    "AVIF/TIFF file on this machine: what it states plus PNG pictures of what it draws."
+)
+
+
+def _slug(text: str) -> str:
+    return re.sub(r"[^A-Za-z0-9]+", "-", text).strip("-").lower()[:40] or "picture"
+
+
+def read_file_payload(path: Path, pictures_dir: Path | None) -> dict:
+    if not path.is_file():
+        raise FileNotFoundError(f"{path} is not a file")
+    reading = read_path(str(path))
+    out_dir = pictures_dir or path.parent
+    saved = []
+    pictures = reading.all_pictures()
+    if pictures:
+        out_dir.mkdir(parents=True, exist_ok=True)
+    for i, pic in enumerate(pictures, 1):
+        target = out_dir / f"{path.stem}.{i}-{_slug(pic.label)}.png"
+        target.write_bytes(pic.png)
+        saved.append({"label": pic.label, "path": str(target)})
+    payload = {
+        "file": str(path),
+        "kind": reading.kind,
+        "format": reading.format,
+        "readable": reading.readable,
+        "readout": reading.markdown(),
+        "pictures": saved,
+    }
+    if saved:
+        payload["next"] = (
+            "Look at each picture to read what it shows; the readout lists only stated facts."
+        )
+    return payload
+
+
+def register(app: typer.Typer) -> None:
+    for persona in ("designer", "supplier", "admin"):
+        _register_for(app, persona)
+
+
+def _register_for(app: typer.Typer, persona: str) -> None:
+    @command(
+        app,
+        persona,
+        "get",
+        "file",
+        api="LOCAL file_reader",
+        external="local",
+        help=_HELP,
+    )
+    def get_file(
+        path: Path = typer.Argument(..., help="The file to read."),
+        pictures_dir: Path | None = typer.Option(
+            None,
+            "--pictures-dir",
+            help="Where to save the PNG pictures (default: next to the file).",
+        ),
+    ) -> None:
+        print_json_or_exit(console, lambda: read_file_payload(path, pictures_dir))

{makea_cli-0.2.26 → makea_cli-0.2.28}/makea_cli/commands/tasks/cmd.py

@@ -12,7 +12,10 @@ read as one order's problem), ``note`` (a slip of Makea's or the platform's),
 
 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
+task --done`` then records that it was handled. ``update task --note`` alone
+adds a note and leaves the task open; ``--dismiss --wrong`` says the task
+should never have been raised (Beeboo's next reading is told, and ``list
+task --wrong`` lists every such task). 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.
 """
@@ -44,6 +47,10 @@ Examples
   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"
+  makea-cli admin update task <task_id> --note "Asked the brand, waiting"
+  makea-cli admin update task <task_id> --dismiss --wrong \
+      --note "The factory was confirming the file, not reporting a mistake"
+  makea-cli admin list task --wrong
 """.strip()
 
 
@@ -56,8 +63,9 @@ def register(app: typer.Typer) -> None:
         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.*)."
+            "owner (the account), product, due date, can_mark_done, notes; counts by kind. "
+            "--user adds that account's own cards the team may settle (account.*). "
+            "--wrong lists the tasks the team marked wrong instead, newest first."
         ),
         epilog=_TASKS_EPILOG,
     )
@@ -72,11 +80,18 @@ def register(app: typer.Typer) -> None:
             None, "--user", "-u", help="One account: user_id or email."
         ),
         product: str | None = typer.Option(None, "--product", "-p", help="One product id."),
+        wrong: bool = typer.Option(
+            False, "--wrong", help="The tasks marked wrong (closed), with why, newest first."
+        ),
     ) -> None:
-        """List the Makea team's open tasks."""
+        """List the Makea team's open tasks, or the ones marked wrong."""
+        if wrong and (kind or type_ or user or product):
+            raise typer.BadParameter("--wrong takes no filters")
         print_json_or_exit(
             console,
-            lambda: api_client.admin_list_tasks(kind=kind, type_=type_, user=user, product=product),
+            lambda: api_client.admin_list_tasks(
+                kind=kind, type_=type_, user=user, product=product, wrong=wrong
+            ),
         )
 
     @command(
@@ -101,19 +116,23 @@ def register(app: typer.Typer) -> None:
         "admin",
         "update",
         "task",
-        api="POST /admin/tasks/{task_id}/{done|dismiss}",
+        api="POST /admin/tasks/{task_id}/{done|dismiss|note}",
         side_effects=[
-            "closes the task for the whole Makea team",
+            "with --done or --dismiss, closes the task for the whole Makea team",
+            "with --note alone, adds a note the team sees; the task stays open",
             "with --reason, Beeboo's next reading of the chats uses that reason",
+            "with --wrong, Beeboo's next reading is told the finding was wrong",
         ],
         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."
+            "POST /admin/tasks/{task_id}/{done|dismiss|note} — close a task: --done once "
+            "it is handled (notes the team handles off the platform only), --dismiss when "
+            "it will not be done, --dismiss --wrong when it should never have been raised "
+            "(the note says why). --note required; --note alone adds a note and leaves the "
+            "task open. On a held lesson, --reason records why it happened for Beeboo's "
+            "next reading."
         ),
         epilog=_TASKS_EPILOG,
     )
@@ -121,7 +140,17 @@ def register(app: typer.Typer) -> None:
         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)."),
+        wrong: bool = typer.Option(
+            False,
+            "--wrong",
+            help="With --dismiss: it should never have been raised; --note says why.",
+        ),
+        note: str = typer.Option(
+            ...,
+            "--note",
+            "-n",
+            help="What was done, or why not (required). Alone: a note; the task stays open.",
+        ),
         reason: str | None = typer.Option(
             None,
             "--reason",
@@ -136,13 +165,22 @@ def register(app: typer.Typer) -> None:
             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")
+        """Mark a task done, dismiss it, or add a note."""
+        if done and dismiss:
+            raise typer.BadParameter("pass at most one of --done, --dismiss")
+        if wrong and not dismiss:
+            raise typer.BadParameter("--wrong goes with --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 not (done or dismiss):
+            if reason is not None or caused_by is not None or recurs is not None:
+                raise typer.BadParameter("--reason, --caused-by, --recurs/--once go with --done")
+            print_json_or_exit(console, lambda: api_client.admin_close_task(task_id, "note", body))
+            return
+        if wrong:
+            body["wrong"] = True
         if reason is not None:
             if not done:
                 raise typer.BadParameter("--reason goes with --done")