makea-cli 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

makea_cli/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.0"
+__version__ = "0.2.2"

makea_cli/api_client.py

@@ -1220,3 +1220,141 @@ def supplier_download_document(
 ) -> tuple[bytes, str | None]:
     """GET /supplier/document/download — a document this factory may read."""
     return _download("/supplier/document/download", {"document_id": document_id}, timeout=timeout)
+
+
+# --- clearing the queue: tasks, actions, and the assistant's proposals ----------
+
+
+def designer_task_action(action: str, task_id: str) -> Any:
+    """POST /designer/tasks/{dismiss|complete} — body ``{"task_id": "<type>#<key>"}``."""
+    return post_json(f"/designer/tasks/{action}", {"task_id": task_id})
+
+
+def designer_action_state(action_id: str, state: str, *, days: int | None = None) -> Any:
+    """POST /designer/actions/{id}/{acknowledge|snooze|dismiss}."""
+    body: dict[str, Any] = {}
+    if state == "snooze" and days is not None:
+        body["days"] = days
+    return post_json(f"/designer/actions/{action_id}/{state}", body)
+
+
+def designer_note_decision(product_id: str, note_id: str, decision: str) -> Any:
+    """POST /designer/products/{id}/notes/{note_id}/{accept|reject} — a task candidate."""
+    return post_json(f"/designer/products/{product_id}/notes/{note_id}/{decision}", {})
+
+
+def designer_approve_proposal(note_id: str, proposal_id: str) -> Any:
+    """POST /designer/beeboo_proposals/approve — apply one of the assistant's spec proposals."""
+    return post_json(
+        "/designer/beeboo_proposals/approve", {"note_id": note_id, "proposal_id": proposal_id}
+    )
+
+
+def designer_bulk_accept_actions(channel_id: str, actions: list[dict[str, str]]) -> Any:
+    """POST /designer/channels/{id}/suggested_actions/bulk_accept — accept several at once."""
+    return post_json(
+        f"/designer/channels/{channel_id}/suggested_actions/bulk_accept", {"actions": actions}
+    )
+
+
+def supplier_task_action(action: str, task_id: str) -> Any:
+    """POST /supplier/tasks/{dismiss|complete} — body ``{"task_id": "<type>#<key>"}``."""
+    return post_json(f"/supplier/tasks/{action}", {"task_id": task_id})
+
+
+def supplier_action_state(action_id: str, state: str, *, days: int | None = None) -> Any:
+    """POST /supplier/actions/{id}/{acknowledge|snooze}."""
+    body: dict[str, Any] = {}
+    if state == "snooze" and days is not None:
+        body["days"] = days
+    return post_json(f"/supplier/actions/{action_id}/{state}", body)
+
+
+# --- the factory's quote lifecycle ----------------------------------------------
+
+
+def supplier_edit_quote(quote_request_id: str, link_id: str, body: dict[str, Any]) -> Any:
+    """POST /supplier/quote_requests/{id}/links/{link_id}/edit — revise a quote already sent."""
+    return post_json(
+        f"/supplier/quote_requests/{quote_request_id}/links/{link_id}/edit", body, timeout=120.0
+    )
+
+
+def supplier_set_rfq_status(quote_request_id: str, status: str) -> Any:
+    """POST /supplier/quote_requests/{id}/status — accept or decline the invitation."""
+    return post_json(f"/supplier/quote_requests/{quote_request_id}/status", {"status": status})
+
+
+def supplier_archive_rfq(quote_request_id: str) -> Any:
+    """POST /supplier/quote_requests/{id}/archive — take it off your board."""
+    return post_json(f"/supplier/quote_requests/{quote_request_id}/archive", {})
+
+
+def supplier_accept_terms(quote_request_id: str, agreement_keys: list[str]) -> Any:
+    """POST /supplier/quote_requests/{id}/accept_terms — accept the named agreements."""
+    return post_json(
+        f"/supplier/quote_requests/{quote_request_id}/accept_terms",
+        {"agreement_keys": agreement_keys},
+    )
+
+
+def supplier_list_quote_edit_requests(quote_request_id: str) -> Any:
+    """GET /supplier/quote_requests/{id}/quote_edit_requests — the brand's change requests."""
+    return get_json(f"/supplier/quote_requests/{quote_request_id}/quote_edit_requests")
+
+
+def designer_list_actions(*, product_id: str | None = None) -> Any:
+    """GET /designer/actions — the brand's pending actions, optionally for one product."""
+    params = {"product_id": product_id} if product_id else None
+    return get_json("/designer/actions", params=params)
+
+
+def supplier_list_tasks() -> Any:
+    """GET /supplier/tasks — the factory's onboarding and per-order to-dos."""
+    return get_json("/supplier/tasks")
+
+
+# --- order lifecycle (designer). Tiered on purpose: see the commands' approval
+# --- grades -- submit/confirm ask a person, cancel/delete are never automatic,
+# --- and nothing here moves money. Payments and subscriptions are deliberately
+# --- absent from the CLI: an agent should not have a path to a charge.
+
+
+def designer_confirm_sampling_order(sampling_order_id: str) -> Any:
+    """POST /designer/sampling_orders/{id}/confirm — the brand confirms the sample order."""
+    return post_json(f"/designer/sampling_orders/{sampling_order_id}/confirm", {})
+
+
+def designer_cancel_sampling_order(sampling_order_id: str) -> Any:
+    """POST /designer/sampling_orders/{id}/cancel — cancel it."""
+    return post_json(f"/designer/sampling_orders/{sampling_order_id}/cancel", {})
+
+
+def designer_delete_sampling_order(sampling_order_id: str) -> Any:
+    """DELETE /designer/sampling_orders/{id} — DRAFT only; the backend refuses anything else."""
+    return delete_json(f"/designer/sampling_orders/{sampling_order_id}")
+
+
+def designer_submit_production_order(production_order_id: str) -> Any:
+    """POST /designer/production_orders/{id}/submit — hand the bulk order to the supplier."""
+    return post_json(f"/designer/production_orders/{production_order_id}/submit", {})
+
+
+def designer_complete_production_order(production_order_id: str) -> Any:
+    """POST /designer/production_orders/{id}/complete — the brand marks the bulk order done."""
+    return post_json(f"/designer/production_orders/{production_order_id}/complete", {})
+
+
+def designer_update_production_order(production_order_id: str, body: dict[str, Any]) -> Any:
+    """PUT /designer/production_orders/{id} — re-pick which supplier links the order covers."""
+    return put_json(f"/designer/production_orders/{production_order_id}", body, timeout=120.0)
+
+
+def designer_confirm_receive_shipping_order(shipping_order_id: str) -> Any:
+    """POST /designer/shipping_orders/{id}/confirm_receive — IN_TRANSIT only."""
+    return post_json(f"/designer/shipping_orders/{shipping_order_id}/confirm_receive", {})
+
+
+def designer_cancel_shipping_order(shipping_order_id: str) -> Any:
+    """POST /designer/shipping_orders/{id}/cancel — unlinks every production order, then deletes it."""
+    return post_json(f"/designer/shipping_orders/{shipping_order_id}/cancel", {})

makea_cli/commands/brand/cmd.py

@@ -272,6 +272,23 @@ def register(app: typer.Typer) -> None:
         """List the brand's open tasks."""
         print_json_or_exit(console, lambda: api_client.designer_list_tasks())
 
+    @command(
+        app,
+        "designer",
+        "list",
+        "action",
+        api="GET /designer/actions",
+        help=(
+            "GET /designer/actions — the pending actions on you, optionally for one product. "
+            "An action is closed by the fact it asks for, not by acknowledging it."
+        ),
+    )
+    def list_actions(
+        product: str | None = typer.Option(None, "--product", "-p", help="Only this product's."),
+    ) -> None:
+        """List the brand's pending actions."""
+        print_json_or_exit(console, lambda: api_client.designer_list_actions(product_id=product))
+
     @command(
         app,
         "designer",
@@ -377,6 +394,151 @@ def register(app: typer.Typer) -> None:
             console, lambda: api_client.designer_update_product_basic_info(product_id, payload)
         )
 
+    @command(
+        app,
+        "designer",
+        "update",
+        "task",
+        api="POST /designer/tasks/{complete|dismiss}",
+        side_effects=["clears the task off your dashboard"],
+        approval="auto",
+        help=(
+            "POST /designer/tasks/{complete|dismiss} — close one of the tasks from "
+            "`designer list task`. Complete means you did it; dismiss means it does not apply."
+        ),
+    )
+    def update_task(
+        task_id: str = typer.Argument(..., help="Task id, the '<type>#<key>' from list task."),
+        complete: bool = typer.Option(False, "--complete", help="Mark it done."),
+        dismiss: bool = typer.Option(False, "--dismiss", help="Hide it as not applicable."),
+    ) -> None:
+        """Complete or dismiss a task."""
+        if complete == dismiss:
+            raise typer.BadParameter("pass exactly one of --complete / --dismiss")
+        verb = "complete" if complete else "dismiss"
+        print_json_or_exit(console, lambda: api_client.designer_task_action(verb, task_id))
+
+    @command(
+        app,
+        "designer",
+        "update",
+        "action",
+        api="POST /designer/actions/{action_id}/{acknowledge|snooze|dismiss}",
+        side_effects=["changes what your pending-actions list shows"],
+        approval="auto",
+        help=(
+            "POST /designer/actions/{id}/{acknowledge|snooze|dismiss} — respond to one of the "
+            "pending actions from `designer list action`. An action is closed by the fact it "
+            "asks for, not by this; acknowledging only says you have seen it."
+        ),
+    )
+    def update_action(
+        action_id: str = typer.Argument(..., help="Action id from list action."),
+        acknowledge: bool = typer.Option(False, "--acknowledge", help="Mark it seen."),
+        snooze: int | None = typer.Option(
+            None, "--snooze", metavar="DAYS", help="Hide it for this many days."
+        ),
+        dismiss: bool = typer.Option(False, "--dismiss", help="Drop it."),
+    ) -> None:
+        """Acknowledge, snooze or dismiss a pending action."""
+        chosen = [
+            n
+            for n, v in (
+                ("acknowledge", acknowledge),
+                ("snooze", snooze is not None),
+                ("dismiss", dismiss),
+            )
+            if v
+        ]
+        if len(chosen) != 1:
+            raise typer.BadParameter(
+                "pass exactly one of --acknowledge / --snooze DAYS / --dismiss"
+            )
+        state = chosen[0]
+        print_json_or_exit(
+            console, lambda: api_client.designer_action_state(action_id, state, days=snooze)
+        )
+
+    @command(
+        app,
+        "designer",
+        "update",
+        "note",
+        api="POST /designer/products/{product_id}/notes/{note_id}/{accept|reject}",
+        side_effects=["accepting a task candidate creates the task and notifies whoever it is for"],
+        approval="ask",
+        help=(
+            "POST /designer/products/{id}/notes/{note_id}/{accept|reject} — decide on a task "
+            "the assistant proposed on a product."
+        ),
+    )
+    def update_note(
+        note_id: str = typer.Argument(..., help="Note id carrying the proposed task."),
+        product: str = typer.Option(..., "--product", "-p", help="Product the note is on."),
+        accept: bool = typer.Option(False, "--accept", help="Create the task."),
+        reject: bool = typer.Option(False, "--reject", help="Turn it down."),
+    ) -> None:
+        """Accept or reject a proposed task."""
+        if accept == reject:
+            raise typer.BadParameter("pass exactly one of --accept / --reject")
+        decision = "accept" if accept else "reject"
+        print_json_or_exit(
+            console, lambda: api_client.designer_note_decision(product, note_id, decision)
+        )
+
+    @command(
+        app,
+        "designer",
+        "update",
+        "proposal",
+        api="POST /designer/beeboo_proposals/approve",
+        side_effects=[
+            "writes the proposed change into the tech pack",
+            "notifies the suppliers who hold that pack",
+        ],
+        approval="ask",
+        help=(
+            "POST /designer/beeboo_proposals/approve — apply one spec change the assistant "
+            "proposed. This edits the pack, so read the proposal first."
+        ),
+    )
+    def update_proposal(
+        proposal_id: str = typer.Argument(..., help="Proposal id from the note."),
+        note: str = typer.Option(..., "--note", help="Note id the proposal hangs on."),
+    ) -> None:
+        """Approve one assistant proposal."""
+        print_json_or_exit(console, lambda: api_client.designer_approve_proposal(note, proposal_id))
+
+    @command(
+        app,
+        "designer",
+        "update",
+        "suggested-action",
+        api="POST /designer/channels/{channel_id}/suggested_actions/bulk_accept",
+        side_effects=["applies every accepted action", "fans out one notification for the batch"],
+        approval="ask",
+        help=(
+            "POST /designer/channels/{id}/suggested_actions/bulk_accept — accept several of a "
+            "channel's suggested actions in one write. --action takes note_id:action_id and repeats."
+        ),
+    )
+    def update_suggested_actions(
+        channel_id: str = typer.Argument(..., help="Channel holding the notes."),
+        action: list[str] = typer.Option(
+            ..., "--action", "-a", help="note_id:action_id (repeat per action)."
+        ),
+    ) -> None:
+        """Accept suggested actions in bulk."""
+        pairs: list[dict[str, str]] = []
+        for raw in action:
+            note_id, sep, action_id = raw.partition(":")
+            if not sep or not note_id or not action_id:
+                raise typer.BadParameter(f"--action must be note_id:action_id, got {raw!r}")
+            pairs.append({"note_id": note_id, "action_id": action_id})
+        print_json_or_exit(
+            console, lambda: api_client.designer_bulk_accept_actions(channel_id, pairs)
+        )
+
     @command(
         app,
         "designer",
@@ -400,6 +562,197 @@ def register(app: typer.Typer) -> None:
             body["channel_key"] = channel
         print_json_or_exit(console, lambda: api_client.designer_add_product_note(product_id, body))
 
+    # --- order lifecycle ---------------------------------------------------------
+    #
+    # The `approval` grade on each of these is advice to a harness, not a gate in
+    # the CLI: a person in a terminal just runs the command. `ask` means an agent
+    # must put it in front of someone; `never` means an agent must not run it at
+    # all, which is why cancel and delete are their own commands rather than flags
+    # on an `ask` one -- the grade is per command, so mixing them would launder a
+    # destructive action through a milder grade.
+    #
+    # Payments and subscriptions are deliberately absent. They exist on the
+    # backend; giving them a CLI surface would put a charge one command away from
+    # an agent, and no approval grade makes that a good trade.
+
+    @command(
+        app,
+        "designer",
+        "submit",
+        "sampling-order",
+        api="POST /designer/sampling_orders/{sampling_order_id}/confirm",
+        side_effects=[
+            "confirms the sample order to the supplier",
+            "starts the supplier's clock on it",
+        ],
+        approval="ask",
+        help=(
+            "POST /designer/sampling_orders/{id}/confirm — confirm a sample order so the "
+            "supplier starts. Run --dry-run first and read it back to the user."
+        ),
+    )
+    def submit_sampling_order(
+        sampling_order_id: str = typer.Argument(..., help="Sampling order id."),
+    ) -> None:
+        """Confirm a sampling order."""
+        print_json_or_exit(
+            console, lambda: api_client.designer_confirm_sampling_order(sampling_order_id)
+        )
+
+    @command(
+        app,
+        "designer",
+        "update",
+        "sampling-order",
+        api="POST /designer/sampling_orders/{sampling_order_id}/cancel",
+        side_effects=["cancels the order", "tells the supplier to stop"],
+        approval="never",
+        help=(
+            "POST /designer/sampling_orders/{id}/cancel — cancel a sample order. Graded "
+            "`never`: an agent must not do this on its own, a person runs it."
+        ),
+    )
+    def update_sampling_order(
+        sampling_order_id: str = typer.Argument(..., help="Sampling order id."),
+        cancel: bool = typer.Option(
+            ..., "--cancel", help="The only operation here; explicit on purpose."
+        ),
+    ) -> None:
+        """Cancel a sampling order."""
+        if not cancel:
+            raise typer.BadParameter("--cancel is required")
+        print_json_or_exit(
+            console, lambda: api_client.designer_cancel_sampling_order(sampling_order_id)
+        )
+
+    @command(
+        app,
+        "designer",
+        "delete",
+        "sampling-order",
+        api="DELETE /designer/sampling_orders/{sampling_order_id}",
+        side_effects=["removes the order row; the backend allows this on DRAFT only"],
+        approval="never",
+        help=(
+            "DELETE /designer/sampling_orders/{id} — delete a DRAFT sample order. The backend "
+            "refuses any other status. Graded `never`."
+        ),
+    )
+    def delete_sampling_order(
+        sampling_order_id: str = typer.Argument(..., help="Sampling order id (DRAFT)."),
+    ) -> None:
+        """Delete a draft sampling order."""
+        print_json_or_exit(
+            console, lambda: api_client.designer_delete_sampling_order(sampling_order_id)
+        )
+
+    @command(
+        app,
+        "designer",
+        "submit",
+        "production-order",
+        api="POST /designer/production_orders/{production_order_id}/submit",
+        side_effects=["hands the bulk order to the supplier", "creates its charges"],
+        approval="ask",
+        help=(
+            "POST /designer/production_orders/{id}/submit — submit a 大货 order. This is the "
+            "commitment, so --dry-run and confirm with the user first."
+        ),
+    )
+    def submit_production_order(
+        production_order_id: str = typer.Argument(..., help="Production order id."),
+    ) -> None:
+        """Submit a production order."""
+        print_json_or_exit(
+            console, lambda: api_client.designer_submit_production_order(production_order_id)
+        )
+
+    @command(
+        app,
+        "designer",
+        "update",
+        "production-order",
+        api="POST /designer/production_orders/{production_order_id}/complete",
+        side_effects=["completing closes the order for both sides"],
+        approval="ask",
+        help=(
+            "POST /designer/production_orders/{id}/complete, or PUT the order to re-pick which "
+            "supplier links it covers (--links-file, same body shape as creating it)."
+        ),
+    )
+    def update_production_order(
+        production_order_id: str = typer.Argument(..., help="Production order id."),
+        complete: bool = typer.Option(False, "--complete", help="Mark the order finished."),
+        links_file: Path | None = typer.Option(
+            None,
+            "--links-file",
+            exists=True,
+            dir_okay=False,
+            help="JSON with selected_links, to change what the order covers.",
+        ),
+    ) -> None:
+        """Complete a production order, or change the links it covers."""
+        if complete == (links_file is not None):
+            raise typer.BadParameter("pass exactly one of --complete / --links-file")
+        if complete:
+            run = lambda: api_client.designer_complete_production_order(production_order_id)  # noqa: E731
+        else:
+            body = _json_object(None, links_file, "links-file")
+            run = lambda: api_client.designer_update_production_order(production_order_id, body)  # noqa: E731
+        print_json_or_exit(console, run)
+
+    @command(
+        app,
+        "designer",
+        "update",
+        "shipping-order",
+        api="POST /designer/shipping_orders/{shipping_order_id}/confirm_receive",
+        side_effects=["marks the shipment received, which closes it"],
+        approval="ask",
+        help=(
+            "POST /designer/shipping_orders/{id}/confirm_receive — say the goods arrived. The "
+            "backend accepts this only while the shipment is IN_TRANSIT."
+        ),
+    )
+    def update_shipping_order(
+        shipping_order_id: str = typer.Argument(..., help="Shipping order id."),
+        confirm_receive: bool = typer.Option(
+            ..., "--confirm-receive", help="The only operation here; explicit on purpose."
+        ),
+    ) -> None:
+        """Confirm receipt of a shipment."""
+        if not confirm_receive:
+            raise typer.BadParameter("--confirm-receive is required")
+        print_json_or_exit(
+            console,
+            lambda: api_client.designer_confirm_receive_shipping_order(shipping_order_id),
+        )
+
+    @command(
+        app,
+        "designer",
+        "delete",
+        "shipping-order",
+        api="POST /designer/shipping_orders/{shipping_order_id}/cancel",
+        side_effects=[
+            "unlinks every production order on the shipment",
+            "deletes the shipment itself",
+        ],
+        approval="never",
+        help=(
+            "POST /designer/shipping_orders/{id}/cancel — the endpoint is called cancel but it "
+            "unlinks every production order and removes the shipment, so it is a delete here. "
+            "Graded `never`."
+        ),
+    )
+    def delete_shipping_order(
+        shipping_order_id: str = typer.Argument(..., help="Shipping order id."),
+    ) -> None:
+        """Cancel (and remove) a shipping order."""
+        print_json_or_exit(
+            console, lambda: api_client.designer_cancel_shipping_order(shipping_order_id)
+        )
+
     @command(
         app,
         "designer",

makea_cli/commands/factory/cmd.py

@@ -192,6 +192,149 @@ def register(app: typer.Typer) -> None:
 
         print_json_or_exit(console, run)
 
+    @command(
+        app,
+        "supplier",
+        "list",
+        "quote-edit-request",
+        api="GET /supplier/quote_requests/{quote_request_id}/quote_edit_requests",
+        help=(
+            "GET /supplier/quote_requests/{id}/quote_edit_requests — changes the brand has "
+            "asked you to make to a quote you already sent."
+        ),
+    )
+    def list_quote_edit_requests(
+        quote_request_id: str = typer.Argument(..., help="The quote request."),
+    ) -> None:
+        """List the brand's requested changes to your quote."""
+        print_json_or_exit(
+            console, lambda: api_client.supplier_list_quote_edit_requests(quote_request_id)
+        )
+
+    @command(
+        app,
+        "supplier",
+        "update",
+        "task",
+        api="POST /supplier/tasks/{complete|dismiss}",
+        side_effects=["clears the task off your dashboard"],
+        approval="auto",
+        help="POST /supplier/tasks/{complete|dismiss} — close one of the tasks from `supplier list task`.",
+    )
+    def update_task(
+        task_id: str = typer.Argument(..., help="Task id, the '<type>#<key>' from list task."),
+        complete: bool = typer.Option(False, "--complete", help="Mark it done."),
+        dismiss: bool = typer.Option(False, "--dismiss", help="Hide it as not applicable."),
+    ) -> None:
+        """Complete or dismiss a task."""
+        if complete == dismiss:
+            raise typer.BadParameter("pass exactly one of --complete / --dismiss")
+        verb = "complete" if complete else "dismiss"
+        print_json_or_exit(console, lambda: api_client.supplier_task_action(verb, task_id))
+
+    @command(
+        app,
+        "supplier",
+        "update",
+        "action",
+        api="POST /supplier/actions/{action_id}/{acknowledge|snooze}",
+        side_effects=["changes what your pending-actions list shows"],
+        approval="auto",
+        help=(
+            "POST /supplier/actions/{id}/{acknowledge|snooze} — respond to a pending action. "
+            "Acknowledging says you have seen it; the action still closes on the fact it asks for."
+        ),
+    )
+    def update_action(
+        action_id: str = typer.Argument(..., help="Action id from list action."),
+        acknowledge: bool = typer.Option(False, "--acknowledge", help="Mark it seen."),
+        snooze: int | None = typer.Option(
+            None, "--snooze", metavar="DAYS", help="Hide it for this many days."
+        ),
+    ) -> None:
+        """Acknowledge or snooze a pending action."""
+        if acknowledge == (snooze is not None):
+            raise typer.BadParameter("pass exactly one of --acknowledge / --snooze DAYS")
+        state = "acknowledge" if acknowledge else "snooze"
+        print_json_or_exit(
+            console, lambda: api_client.supplier_action_state(action_id, state, days=snooze)
+        )
+
+    @command(
+        app,
+        "supplier",
+        "list",
+        "task",
+        api="GET /supplier/tasks",
+        help="GET /supplier/tasks — your onboarding and per-order to-dos.",
+    )
+    def list_tasks() -> None:
+        """List the factory's tasks."""
+        print_json_or_exit(console, lambda: api_client.supplier_list_tasks())
+
+    @command(
+        app,
+        "supplier",
+        "update",
+        "quote",
+        api="POST /supplier/quote_requests/{quote_request_id}/links/{link_id}/edit",
+        side_effects=["changes the price the brand sees", "notifies the brand of the revision"],
+        approval="ask",
+        help=(
+            "POST /supplier/quote_requests/{id}/links/{link_id}/edit — revise a quote you "
+            "already sent. --file is the same payload shape as submit; --dry-run first."
+        ),
+    )
+    def update_quote(
+        quote_request_id: str = typer.Argument(..., help="The quote request."),
+        link_id: str = typer.Argument(..., help="The quote (supplier link) to revise."),
+        file: Path = typer.Option(
+            ..., "--file", "-f", exists=True, dir_okay=False, help="JSON file with the revision."
+        ),
+    ) -> None:
+        """Revise a submitted quote."""
+        body = _load_json_object(file)
+        print_json_or_exit(
+            console, lambda: api_client.supplier_edit_quote(quote_request_id, link_id, body)
+        )
+
+    @command(
+        app,
+        "supplier",
+        "update",
+        "rfq",
+        api="POST /supplier/quote_requests/{quote_request_id}/{status|archive|accept_terms}",
+        side_effects=[
+            "the brand sees whether you took the job",
+            "archiving hides it from your board",
+        ],
+        approval="ask",
+        help=(
+            "POST /supplier/quote_requests/{id}/{status|archive|accept_terms} — answer an RFQ. "
+            "--status accepts or declines the invitation; --archive takes it off your board; "
+            "--accept-terms accepts the named agreements (repeat the flag)."
+        ),
+    )
+    def update_rfq(
+        quote_request_id: str = typer.Argument(..., help="The quote request."),
+        status: str | None = typer.Option(None, "--status", help="New status, e.g. ACCEPTED."),
+        archive: bool = typer.Option(False, "--archive", help="Take it off your board."),
+        accept_terms: list[str] = typer.Option(
+            [], "--accept-terms", help="Agreement key to accept (repeat per agreement)."
+        ),
+    ) -> None:
+        """Answer, archive, or accept the terms of an RFQ."""
+        chosen = [bool(status), archive, bool(accept_terms)]
+        if sum(chosen) != 1:
+            raise typer.BadParameter("pass exactly one of --status / --archive / --accept-terms")
+        if status:
+            run = lambda: api_client.supplier_set_rfq_status(quote_request_id, status)  # noqa: E731
+        elif archive:
+            run = lambda: api_client.supplier_archive_rfq(quote_request_id)  # noqa: E731
+        else:
+            run = lambda: api_client.supplier_accept_terms(quote_request_id, list(accept_terms))  # noqa: E731
+        print_json_or_exit(console, run)
+
     @command(
         app,
         "supplier",

{makea_cli-0.2.0.dist-info → makea_cli-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.0
+Version: 0.2.2
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -79,6 +79,8 @@ makea-cli auth --logout
 
 每条命令都有的开关：`--describe` 打印它的机器可读定义（flags、副作用、审批档位）；`--json` 强制纯 JSON（stdout 不是终端时默认就是）。读命令还有 `--fields a,b,c` 只保留这些字段；`list` 命令还有 `--limit N`（后端自己分页的就透传，不分页的在本地截断并在结果里写明 `truncated` / `returned` / `omitted`）；写命令还有 `--dry-run`（打印将要发出的请求，不发）和 `--idempotency-key <k>`。`makea-cli --describe --json` 打印全量 manifest。
 
+写命令的**审批档位**（manifest 的 `approval`）是给 harness 的建议，不是 CLI 的门：`auto` 可以自动跑；`ask` 必须先让人确认；`never` agent 不许自己决定（人在终端照常能跑）。动钱的端点（payments / bank transfer / subscription）**故意不进 CLI**。
+
 exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不匹配 · `4` 后端拒绝（4xx，错误 JSON 在 stderr）· `5` 没跑完（5xx / 网络 / 超时）——读命令直接重试即可；**写命令可能已经生效了，重试前先读一遍状态**。
 
 0.1 的平铺命令名（`list-users`、`submit-supplier-quote` …）仍可用，作为隐藏的过渡别名转发到新命令并在 stderr 打一行提示；**下一个 minor 版本删除**。完整的改名对照表在 [CHANGELOG.md](CHANGELOG.md)。
@@ -147,6 +149,8 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer create product` | write（ask） | `POST /designer/product/create_or_update_product` | payload must match manufacture/specifications (all frontend fields; categories/subcategories + collection_id in --hel… | `designer-upsert-product` |
 | `makea-cli designer create rfq` | write（ask） | `POST /designer/product/send_rfq` | ask the chosen suppliers to quote on a product. --supplier repeats; --makea-sourcing also asks Makea to source. | — |
 | `makea-cli designer create sampling-order` | write（ask） | `POST /designer/sampling_orders` | order samples. --file is the full order payload (product_order_id, items, fees …); run --dry-run first and read the b… | — |
+| `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 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. | — |
@@ -154,6 +158,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer get quote-advice` | read | `GET /designer/product/quote_advice` | which quote to award and why, from cache. Reading never spends a model call; the web app is what asks for a fresh one. | — |
 | `makea-cli designer get tech-pack` | read | `GET /designer/products/{product_id}/technical-specifications` | the product's tech pack. | — |
 | `makea-cli designer get tech-pack-history` | read | `GET /designer/products/{product_id}/specification-change-history` | who changed which spec field, when, and from what. | — |
+| `makea-cli designer list action` | read | `GET /designer/actions` | the pending actions on you, optionally for one product. An action is closed by the fact it asks for, not by acknowled… | — |
 | `makea-cli designer list channel` | read | `GET /designer/products/{product_id}/channels` | the product's conversation channels. | — |
 | `makea-cli designer list collection` | read | `GET /designer/collections` | the brand's collections. | — |
 | `makea-cli designer list library-element` | read | `GET /designer/library_components` | the brand's own shelf (fabrics, trims, colours, artwork); --section narrows to one kind. | — |
@@ -166,7 +171,17 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer list task` | read | `GET /designer/tasks` | what the platform is waiting on you for. | — |
 | `makea-cli designer search note` | read | `GET /designer/products/{product_id}/channel_search` | full-text search across a product's conversation; --channel narrows to one channel key. | — |
 | `makea-cli designer set product-collection` | write（auto） | `POST /designer/products/{id}/link-to-collection` | assign product to a collection. | `designer-link-product-to-collection` |
+| `makea-cli designer submit production-order` | write（ask） | `POST /designer/production_orders/{production_order_id}/submit` | submit a 大货 order. This is the commitment, so --dry-run and confirm with the user first. | — |
+| `makea-cli designer submit sampling-order` | write（ask） | `POST /designer/sampling_orders/{sampling_order_id}/confirm` | confirm a sample order so the supplier starts. Run --dry-run first and read it back to the user. | — |
+| `makea-cli designer update action` | write（auto） | `POST /designer/actions/{action_id}/{acknowledge\|snooze\|dismiss}` | respond to one of the pending actions from `designer list action`. An action is closed by the fact it asks for, not b… | — |
+| `makea-cli designer update note` | write（ask） | `POST /designer/products/{product_id}/notes/{note_id}/{accept\|reject}` | decide on a task the assistant proposed on a product. | — |
 | `makea-cli designer update product` | write（auto） | `POST /designer/product/update_basic_info` | patch fields on a product. --cover-image / --back-image take a document id and are what the assistant's set_product_i… | — |
+| `makea-cli designer update production-order` | write（ask） | `POST /designer/production_orders/{production_order_id}/complete` | POST /designer/production_orders/{id}/complete, or PUT the order to re-pick which supplier links it covers (--links-f… | — |
+| `makea-cli designer update proposal` | write（ask） | `POST /designer/beeboo_proposals/approve` | apply one spec change the assistant proposed. This edits the pack, so read the proposal first. | — |
+| `makea-cli designer update sampling-order` | write（never） | `POST /designer/sampling_orders/{sampling_order_id}/cancel` | cancel a sample order. Graded `never`: an agent must not do this on its own, a person runs it. | — |
+| `makea-cli designer update shipping-order` | write（ask） | `POST /designer/shipping_orders/{shipping_order_id}/confirm_receive` | say the goods arrived. The backend accepts this only while the shipment is IN_TRANSIT. | — |
+| `makea-cli designer update suggested-action` | write（ask） | `POST /designer/channels/{channel_id}/suggested_actions/bulk_accept` | accept several of a channel's suggested actions in one write. --action takes note_id:action_id and repeats. | — |
+| `makea-cli designer update task` | write（auto） | `POST /designer/tasks/{complete\|dismiss}` | close one of the tasks from `designer list task`. Complete means you did it; dismiss means it does not apply. | — |
 | `makea-cli designer upload document` | write（auto） | `POST /designer/document/upload` | upload a file for the current designer token; optional product_id (omit to start a new draft id server-side). | `designer-upload-document` |
 
 ### `supplier`
@@ -183,8 +198,14 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli supplier list channel` | read | `GET /supplier/products/{product_id}/channels` | the channels you are part of on a product. | — |
 | `makea-cli supplier list note` | read | `GET /supplier/products/{product_id}/channels/{channel_key}/notes` | the conversation in one channel. | — |
 | `makea-cli supplier list production-order` | read | `GET /supplier/production_orders` | your production orders, optionally for one RFQ. | — |
+| `makea-cli supplier list quote-edit-request` | read | `GET /supplier/quote_requests/{quote_request_id}/quote_edit_requests` | changes the brand has asked you to make to a quote you already sent. | — |
 | `makea-cli supplier list rfq` | read | `GET /supplier/quote_requests` | the RFQs (quote requests) sent to you. | — |
+| `makea-cli supplier list task` | read | `GET /supplier/tasks` | your onboarding and per-order to-dos. | — |
 | `makea-cli supplier submit quote` | write（ask） | `POST /supplier/quote_requests/{id}/submit_quote` | submit your quote for an RFQ. --file is the supplier link payload as JSON (same shape the web form posts); run with -… | — |
+| `makea-cli supplier update action` | write（auto） | `POST /supplier/actions/{action_id}/{acknowledge\|snooze}` | respond to a pending action. Acknowledging says you have seen it; the action still closes on the fact it asks for. | — |
+| `makea-cli supplier update quote` | write（ask） | `POST /supplier/quote_requests/{quote_request_id}/links/{link_id}/edit` | revise a quote you already sent. --file is the same payload shape as submit; --dry-run first. | — |
+| `makea-cli supplier update rfq` | write（ask） | `POST /supplier/quote_requests/{quote_request_id}/{status\|archive\|accept_terms}` | answer an RFQ. --status accepts or declines the invitation; --archive takes it off your board; --accept-terms accepts… | — |
+| `makea-cli supplier update task` | write（auto） | `POST /supplier/tasks/{complete\|dismiss}` | close one of the tasks from `supplier list task`. | — |
 
 其它：`makea-cli auth [--logout]` 登录/登出；`makea-cli version` 版本号。
 

{makea_cli-0.2.0.dist-info → makea_cli-0.2.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
-makea_cli/__init__.py,sha256=Zn1KFblwuFHiDRdRAiRnDBRkbPttWh44jKa5zG2ov0E,22
+makea_cli/__init__.py,sha256=m6kyaNpwBcP1XYcqrelX2oS3PJuOnElOcRdBa9pEb8c,22
 makea_cli/__main__.py,sha256=AkQjxWfKE3w9iD1d6I-2Zqvv2t9cct0oYyFF0UiA-Z0,144
-makea_cli/api_client.py,sha256=oVIR8QD8lkKJm0YM0CzWwOPQ3vi4sNSWqgq_HnaNuXQ,42139
+makea_cli/api_client.py,sha256=cvs7ntOqVb8mDGiCOmyHwPo2EvwDTYqlchm5pXbG15w,48435
 makea_cli/auth_pkce.py,sha256=iXSyJ7DM3qVuj-3FwPiqM25CxXz9ebFs9FNthZdw3ws,7315
 makea_cli/config.py,sha256=lVPsp-44V9pPyUNbcG-uQNV8srCrBVMZnb0HF38Paks,2906
 makea_cli/errors.py,sha256=_2qKjvkU8YWeBcUd04Yn62lKkZoqQY52kH8klNMyxhM,2780
@@ -16,7 +16,7 @@ makea_cli/commands/analytics/cmd.py,sha256=_I5fBlomTalAxRpB-jculS01AbjEC5cVG3lAN
 makea_cli/commands/auth/__init__.py,sha256=NXoKGfkY2X_hb8GnAyzhoI_qDXfpwKZPqt4HnOrXW3Y,73
 makea_cli/commands/auth/cmd.py,sha256=G9ZeiaJwzUUTptIyynr0V-82wI7eV0qVX0pD6rdPSXg,1321
 makea_cli/commands/brand/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-makea_cli/commands/brand/cmd.py,sha256=KgOOFRNkLwxyMB80rpCPZ9JPlruKPBT90rCFtUIPsVE,16818
+makea_cli/commands/brand/cmd.py,sha256=9Gx2agSJP6LyDZYOGyYr3mAfqPFJRiuno41DmucKZqI,31040
 makea_cli/commands/designer/__init__.py,sha256=Tc3Ju4-BKX2euBljhlrEd-Ksirk6JSPNixq4x0IbQYI,77
 makea_cli/commands/designer/cmd.py,sha256=4oOJ5tWYojUs8FBj3QRmgpwbicpsU1XqswoNlJpLLS8,23615
 makea_cli/commands/directory/__init__.py,sha256=rQHBc0JOFXynlzrBm_YfqoRuNsS-JOl-OOvPjgDbnIA,78
@@ -26,7 +26,7 @@ makea_cli/commands/document/cmd.py,sha256=IqjzGoTYXp1RbTIYY1MSEqX93btK4eESDTX40C
 makea_cli/commands/email/__init__.py,sha256=EWMqMTgZK1GQDW7-9RGVSGU-CvaHTARjXZL18Hdj80I,74
 makea_cli/commands/email/cmd.py,sha256=s22JQjJ7bPdpgBaL7Tmr8hx80ki_JN_iGQtUekXmmdo,4177
 makea_cli/commands/factory/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-makea_cli/commands/factory/cmd.py,sha256=gK2ezMDzSc3MNV9zy06nHyvD0fltWO43pa2xemJrmgI,8734
+makea_cli/commands/factory/cmd.py,sha256=ae2KGxnzoY1i7C4miVIk52IQZm53pOfePnJa9zeL_sI,14724
 makea_cli/commands/library/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 makea_cli/commands/library/cmd.py,sha256=eXZa6iLyPaoEWtRd-UmhRT6Ox-zlfs89gJqGn-IPuSU,11187
 makea_cli/commands/metrics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -40,7 +40,7 @@ makea_cli/commands/production/cmd.py,sha256=s6fVAGzOvokF6Va5WKGEA2vw2x2hDQ3PrsF0
 makea_cli/commands/production/pricing_spec.py,sha256=xGbj7-ps3PcKuU6Oc59A70b62FjF6Awhr5IY3ymZveU,27174
 makea_cli/commands/supplier/__init__.py,sha256=qfQDeQdQ-B7I_uwFVfcp1vXFUTL4fAcNLu3ipsZ7dfs,77
 makea_cli/commands/supplier/cmd.py,sha256=CrG1m0U5-dvdJi4vk9-JRSYY_moPfV_Ud6jRTf-G5Z8,56947
-makea_cli-0.2.0.dist-info/METADATA,sha256=zmAtw_mXRFW14exkDGOR1IQBp7qES7AvNT1GbMA9HB4,25373
-makea_cli-0.2.0.dist-info/WHEEL,sha256=THafob7ofN-NsuMN7Mg4qZyHaQI7KkD-QlcQatYhXPo,87
-makea_cli-0.2.0.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
-makea_cli-0.2.0.dist-info/RECORD,,
+makea_cli-0.2.2.dist-info/METADATA,sha256=jW5EW6HvLmvM2Zrr1Afg6kJTZgXq-0P9Wz0qPKcJGyQ,29877
+makea_cli-0.2.2.dist-info/WHEEL,sha256=THafob7ofN-NsuMN7Mg4qZyHaQI7KkD-QlcQatYhXPo,87
+makea_cli-0.2.2.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
+makea_cli-0.2.2.dist-info/RECORD,,