minitest-cli 0.35.0__tar.gz → 0.37.0__tar.gz

{minitest_cli-0.35.0 → minitest_cli-0.37.0}/.env.example

@@ -16,6 +16,12 @@ MINITEST_API_URL=https://testing-service.dev.minitap.ai
 # Development
 MINITEST_APPS_MANAGER_URL=https://apps-manager.dev.minitap.ai
 
+# —— Conductor (minitest draft) ——
+# Production
+# MINITEST_CONDUCTOR_URL=https://conductor.app.minitap.ai
+# Development
+MINITEST_CONDUCTOR_URL=https://conductor.dev.minitap.ai
+
 # —— Integrations ——
 # Production
 # MINITEST_INTEGRATIONS_URL=https://integrations.minitap.ai

{minitest_cli-0.35.0 → minitest_cli-0.37.0}/AGENTS.md

@@ -14,7 +14,7 @@ uv add <package>                                   # Add new dependency (always
 ## Project Structure
 
 - `src/minitest_cli/` - Main package
-- `commands/` - One Typer sub-app per command group (auth, apps, flow, build, run, maintenance)
+- `commands/` - One Typer sub-app per command group (auth, apps, flow, build, run)
 - `core/`
   - `config.py` - pydantic-settings: MINITEST_API_URL, MINITEST_TOKEN, config dir
   - `app_context.py` - --app flag / MINITEST_APP_ID resolution

{minitest_cli-0.35.0 → minitest_cli-0.37.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: minitest-cli
-Version: 0.35.0
+Version: 0.37.0
 Summary: Minitest CLI – command-line interface for the Minitest testing platform
 Project-URL: Homepage, https://minitap.ai/
 Project-URL: Source, https://github.com/minitap-ai/minitest-cli
@@ -145,6 +145,7 @@ app defaults.
 | `MINITEST_APP_ID`             | Default app ID                                             | No (can use `--app` flag)          |
 | `MINITEST_API_URL`            | testing-service base URL                                   | No (defaults to production)        |
 | `MINITEST_APPS_MANAGER_URL`   | apps-manager base URL (used by `minitest apps create`)     | No (defaults to production)        |
+| `MINITEST_CONDUCTOR_URL`      | Conductor base URL (used by `minitest draft`)              | No (defaults to production)        |
 | `MINITEST_INTEGRATIONS_URL`   | minihands-integrations base URL (used to list tenants)     | No (defaults to production)        |
 | `MINITEST_WEBAPP_URL`         | Minitest webapp base URL (used for review links)            | No (defaults to production)        |
 | `MINITEST_SUPABASE_URL`       | Supabase project URL used for OAuth login                  | No (defaults to production)        |
@@ -169,7 +170,8 @@ app defaults.
 | `minitest apps`  | List, inspect, and create apps; residential proxy and private network settings |
 | `minitest scenario` | Create, update, list and delete scenarios |
 | `minitest scenario-binding` | Bind test accounts, test files or app skills to scenarios |
-| `minitest draft` | Drafts — branches of the test suite |
+| `minitest draft` | Ask Mini for a suite change, follow it, check and merge it (drafts in the webapp) |
+| `minitest df` | Low-level suite branches Mini writes (draft features) |
 | `minitest test-profile` | Test profiles (Test accounts in the webapp) |
 | `minitest tags`  | List, create, update and delete scenario tags |
 | `minitest app-skill` | App skills (Skills in the webapp): procedures Mini loads to arrange test state |
@@ -178,7 +180,6 @@ app defaults.
 | `minitest run`   | Start runs and inspect their scenario runs |
 | `minitest batch` | List, inspect and cancel runs (a batch is a Run in the webapp) |
 | `minitest issues` | Read app issues and their fix prompts, mark them fixed |
-| `minitest maintenance` | CLI-only scenario maintenance against local code |
 | `minitest skill` | Print the CLI skill for your AI coding agent (not app skills) |
 
 ### Deprecated names
@@ -191,7 +192,7 @@ stderr and leave `--json` stdout unchanged. Switch to the new names.
 | `minitest user-story` | `minitest scenario` |
 | `minitest user-story-binding` | `minitest scenario-binding` |
 | `minitest scenario-binding set-skills` | `minitest scenario-binding set-app-skills` |
-| `minitest df` | `minitest draft` |
+| `minitest draft show/apply/delete` (v0.34–v0.36) | `minitest df show/apply/delete` |
 | `minitest flow-types` | `minitest tags` |
 | `run from-commit --user-story` / `-u` | `run from-commit --scenario` / `-s` |
 | `batch list --user-story-id` | `batch list --scenario` |
@@ -226,28 +227,6 @@ least one domain. Connectors cannot be created from the CLI: a workspace owner
 or admin creates them in the webapp, under **Workspace settings → Private
 network**.
 
-## CLI-only maintenance
-
-`minitest maintenance` lets a coding agent keep Minitest scenarios in sync
-without connecting GitHub. Run it from the app repository: the code stays on the
-machine, while the CLI sends only proposed scenario edits and the local HEAD SHA.
-
-```bash
-# Print the server-composed maintenance instructions for your coding agent
-minitest maintenance --agent
-
-# Agent workflow primitives
-minitest --json maintenance context
-minitest maintenance affected --file affected.json
-minitest maintenance change --file change.json
-minitest maintenance status --phase writing --message "Updating affected scenarios"
-minitest maintenance complete --changed
-
-# Apply proposed edits now, or open the web review queue
-minitest maintenance apply
-minitest maintenance apply --review
-```
-
 ## Exit Codes
 
 | Code | Meaning                                            |

{minitest_cli-0.35.0 → minitest_cli-0.37.0}/README.md

@@ -112,6 +112,7 @@ app defaults.
 | `MINITEST_APP_ID`             | Default app ID                                             | No (can use `--app` flag)          |
 | `MINITEST_API_URL`            | testing-service base URL                                   | No (defaults to production)        |
 | `MINITEST_APPS_MANAGER_URL`   | apps-manager base URL (used by `minitest apps create`)     | No (defaults to production)        |
+| `MINITEST_CONDUCTOR_URL`      | Conductor base URL (used by `minitest draft`)              | No (defaults to production)        |
 | `MINITEST_INTEGRATIONS_URL`   | minihands-integrations base URL (used to list tenants)     | No (defaults to production)        |
 | `MINITEST_WEBAPP_URL`         | Minitest webapp base URL (used for review links)            | No (defaults to production)        |
 | `MINITEST_SUPABASE_URL`       | Supabase project URL used for OAuth login                  | No (defaults to production)        |
@@ -136,7 +137,8 @@ app defaults.
 | `minitest apps`  | List, inspect, and create apps; residential proxy and private network settings |
 | `minitest scenario` | Create, update, list and delete scenarios |
 | `minitest scenario-binding` | Bind test accounts, test files or app skills to scenarios |
-| `minitest draft` | Drafts — branches of the test suite |
+| `minitest draft` | Ask Mini for a suite change, follow it, check and merge it (drafts in the webapp) |
+| `minitest df` | Low-level suite branches Mini writes (draft features) |
 | `minitest test-profile` | Test profiles (Test accounts in the webapp) |
 | `minitest tags`  | List, create, update and delete scenario tags |
 | `minitest app-skill` | App skills (Skills in the webapp): procedures Mini loads to arrange test state |
@@ -145,7 +147,6 @@ app defaults.
 | `minitest run`   | Start runs and inspect their scenario runs |
 | `minitest batch` | List, inspect and cancel runs (a batch is a Run in the webapp) |
 | `minitest issues` | Read app issues and their fix prompts, mark them fixed |
-| `minitest maintenance` | CLI-only scenario maintenance against local code |
 | `minitest skill` | Print the CLI skill for your AI coding agent (not app skills) |
 
 ### Deprecated names
@@ -158,7 +159,7 @@ stderr and leave `--json` stdout unchanged. Switch to the new names.
 | `minitest user-story` | `minitest scenario` |
 | `minitest user-story-binding` | `minitest scenario-binding` |
 | `minitest scenario-binding set-skills` | `minitest scenario-binding set-app-skills` |
-| `minitest df` | `minitest draft` |
+| `minitest draft show/apply/delete` (v0.34–v0.36) | `minitest df show/apply/delete` |
 | `minitest flow-types` | `minitest tags` |
 | `run from-commit --user-story` / `-u` | `run from-commit --scenario` / `-s` |
 | `batch list --user-story-id` | `batch list --scenario` |
@@ -193,28 +194,6 @@ least one domain. Connectors cannot be created from the CLI: a workspace owner
 or admin creates them in the webapp, under **Workspace settings → Private
 network**.
 
-## CLI-only maintenance
-
-`minitest maintenance` lets a coding agent keep Minitest scenarios in sync
-without connecting GitHub. Run it from the app repository: the code stays on the
-machine, while the CLI sends only proposed scenario edits and the local HEAD SHA.
-
-```bash
-# Print the server-composed maintenance instructions for your coding agent
-minitest maintenance --agent
-
-# Agent workflow primitives
-minitest --json maintenance context
-minitest maintenance affected --file affected.json
-minitest maintenance change --file change.json
-minitest maintenance status --phase writing --message "Updating affected scenarios"
-minitest maintenance complete --changed
-
-# Apply proposed edits now, or open the web review queue
-minitest maintenance apply
-minitest maintenance apply --review
-```
-
 ## Exit Codes
 
 | Code | Meaning                                            |

{minitest_cli-0.35.0 → minitest_cli-0.37.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "minitest-cli"
-version = "0.35.0"
+version = "0.37.0"
 description = "Minitest CLI – command-line interface for the Minitest testing platform"
 readme = "README.md"
 license = "MIT"

{minitest_cli-0.35.0 → minitest_cli-0.37.0}/src/minitest_cli/api/client.py

@@ -13,8 +13,7 @@ CONVERSATION_ID_HEADER = "X-Minitest-Conversation-Id"
 CAUSE_HEADER = "X-Minitest-Cause"
 DEFAULT_TIMEOUT = 30.0
 UPLOAD_TIMEOUT = 300.0  # 5 minutes for large file uploads
-# Creating a batch can block on server-side maintenance before it answers, and the
-# POST is not idempotent — timing out client-side leaves a batch running unseen.
+# Creating a batch is not idempotent — timing out client-side leaves a batch running unseen.
 BATCH_CREATE_TIMEOUT = 180.0
 
 
@@ -40,9 +39,16 @@ class ApiClient:
             response = await client.get("/api/v1/apps")
     """
 
-    def __init__(self, settings: Settings, *, token_override: str | None = None) -> None:
+    def __init__(
+        self,
+        settings: Settings,
+        *,
+        token_override: str | None = None,
+        base_url: str | None = None,
+    ) -> None:
         self._settings = settings
         self._token_override = token_override
+        self._base_url = base_url or settings.api_url
         self._client: httpx.AsyncClient | None = None
 
     async def __aenter__(self) -> "ApiClient":
@@ -54,7 +60,7 @@ class ApiClient:
         if self._settings.cause is not None:
             headers[CAUSE_HEADER] = self._settings.cause
         self._client = httpx.AsyncClient(
-            base_url=self._settings.api_url,
+            base_url=self._base_url,
             headers=headers,
             auth=_BearerAuth(self._settings, self._token_override),
             timeout=DEFAULT_TIMEOUT,

{minitest_cli-0.35.0 → minitest_cli-0.37.0}/src/minitest_cli/commands/app_skill_helpers.py

@@ -103,6 +103,16 @@ def read_instructions(instructions: str | None, instructions_file: Path | None)
     return instructions
 
 
+def instruction_edits(
+    replace: list[str] | None, replacements: list[str] | None
+) -> list[dict[str, str]]:
+    old, new = replace or [], replacements or []
+    if len(old) != len(new):
+        print_error("Give exactly one --with for each --replace.")
+        raise typer.Exit(code=1)
+    return [{"oldText": o, "newText": n} for o, n in zip(old, new, strict=True)]
+
+
 def warn_undefined_secrets(skill: dict[str, Any]) -> None:
     undefined = skill.get("undefinedSecrets") or []
     if undefined:

{minitest_cli-0.35.0 → minitest_cli-0.37.0}/src/minitest_cli/commands/app_skill_write.py

@@ -8,11 +8,12 @@ import typer
 from minitest_cli.commands.app_skill_helpers import (
     call,
     command_context,
+    instruction_edits,
     read_instructions,
     skills_path,
     warn_undefined_secrets,
 )
-from minitest_cli.utils.output import print_error, print_json, print_success
+from minitest_cli.utils.output import print_error, print_info, print_json, print_success
 
 Description = Annotated[
     str | None,
@@ -31,6 +32,24 @@ InstructionsFile = Annotated[
         "--instructions-file", exists=True, readable=True, dir_okay=False, help="Markdown file."
     ),
 ]
+Replace = Annotated[
+    list[str] | None,
+    typer.Option(
+        "--replace",
+        help="Exact text of the instructions to replace; pair each with a --with (repeatable).",
+    ),
+]
+With = Annotated[
+    list[str] | None,
+    typer.Option("--with", help="Replacement for the matching --replace; empty deletes it."),
+]
+AllowDestructive = Annotated[
+    bool,
+    typer.Option(
+        "--allow-destructive",
+        help="Accept a version that removes runnable code or most of the instructions.",
+    ),
+]
 AllPlatforms = Annotated[
     bool, typer.Option("--all-platforms", help="Make the skill apply to every platform.")
 ]
@@ -94,17 +113,34 @@ def register(app: typer.Typer) -> None:
         all_platforms: AllPlatforms = False,
         instructions: Instructions = None,
         instructions_file: InstructionsFile = None,
+        replace: Replace = None,
+        with_: With = None,
+        allow_destructive: AllowDestructive = False,
     ) -> None:
-        """Change a skill; every change becomes a new version."""
+        """Change a skill; every change becomes a new version.
+
+        Change part of the instructions with --replace/--with pairs instead of resending them.
+        """
         settings, json_mode, app_id = command_context()
         body = _patch(description, platforms, all_platforms, instructions, instructions_file)
+        edits = instruction_edits(replace, with_)
+        if edits and "instructions" in body:
+            print_error("Use either --replace/--with or --instructions, not both.")
+            raise typer.Exit(code=1)
+        if edits:
+            body["edits"] = edits
         if new_name is not None:
             body["name"] = new_name
         if not body:
             print_error("Nothing to update.")
             raise typer.Exit(code=1)
+        if allow_destructive:
+            body["allowDestructive"] = True
         skill = call(settings, "PATCH", f"{skills_path(app_id)}/{name}", json=body)
         _report(skill, json_mode, f"Skill {skill['name']} is now v{skill['version']}.")
+        if not json_mode:
+            for change in skill.get("changes", []):
+                print_info(f"  {change}")
 
     @app.command(name="propose")
     def propose_update(

{minitest_cli-0.35.0 → minitest_cli-0.37.0}/src/minitest_cli/commands/apps.py

@@ -30,6 +30,7 @@ from minitest_cli.utils.output import (
     print_table,
 )
 
+EXIT_GENERAL_ERROR = 1
 EXIT_NETWORK_ERROR = 3
 
 app = typer.Typer(name="apps", help="App management.")
@@ -70,6 +71,9 @@ def list_apps() -> None:
                         detail = body.get("detail") or body.get("message") or detail
                 except Exception:  # noqa: BLE001
                     pass
+                if resp.status_code in (401, 403):
+                    print_error(f"Authentication failed ({resp.status_code}): {detail}")
+                    raise typer.Exit(code=EXIT_GENERAL_ERROR)
                 print_error(f"API error ({resp.status_code}): {detail}")
                 raise typer.Exit(code=EXIT_NETWORK_ERROR)
             return AppListResponse.model_validate(resp.json())

{minitest_cli-0.35.0 → minitest_cli-0.37.0}/src/minitest_cli/commands/build.py

@@ -22,6 +22,7 @@ from minitest_cli.commands.build_helpers import (
     upload_status_message,
 )
 from minitest_cli.commands.build_commit import from_commit
+from minitest_cli.commands.build_get import get
 from minitest_cli.commands.build_fix_prompts import print_fix_prompts, redacted_payload
 from minitest_cli.models import BuildListResponse, BuildResponse
 from minitest_cli.utils.output import (
@@ -145,4 +146,5 @@ def list_builds(
     print_fix_prompts(result.items)
 
 
+app.command(name="get")(get)
 app.command(name="from-commit")(from_commit)

{minitest_cli-0.35.0 → minitest_cli-0.37.0}/src/minitest_cli/commands/build_fix_prompts.py

@@ -40,18 +40,23 @@ def build_guidance(build: BuildResponse) -> dict[str, str | None]:
     return {"source": "none", "text": None}
 
 
+def redacted_build(build: BuildResponse) -> dict[str, Any]:
+    item = build.model_dump(mode="json", by_alias=True)
+    if build.status != FAILED_STATUS:
+        item["guidance"] = None
+        return item
+    item["guidance"] = build_guidance(build)
+    if is_withheld(build.error_class):
+        item["errorSummary"] = WITHHELD_NOTICE
+        item["errorRemediation"] = None
+        item["errorFixPrompt"] = None
+        item["errorRaw"] = None
+    return item
+
+
 def redacted_payload(result: BuildListResponse) -> dict[str, Any]:
     payload = result.model_dump(mode="json", by_alias=True)
-    for item, build in zip(payload.get("items", []), result.items, strict=False):
-        if build.status != FAILED_STATUS:
-            item["guidance"] = None
-            continue
-        item["guidance"] = build_guidance(build)
-        if is_withheld(build.error_class):
-            item["errorSummary"] = WITHHELD_NOTICE
-            item["errorRemediation"] = None
-            item["errorFixPrompt"] = None
-            item["errorRaw"] = None
+    payload["items"] = [redacted_build(build) for build in result.items]
     return payload
 
 

minitest_cli-0.37.0/src/minitest_cli/commands/build_get.py

@@ -0,0 +1,50 @@
+"""``minitest build get``: read one build of the active app by id."""
+
+from typing import Annotated
+
+import typer
+
+from minitest_cli.api.client import ApiClient
+from minitest_cli.commands.build_fix_prompts import print_fix_prompts, redacted_build
+from minitest_cli.commands.build_helpers import (
+    BUILD_TABLE_HEADERS,
+    base_path,
+    format_build_row,
+    handle_response_error,
+    resolve_app,
+    run_api_call,
+)
+from minitest_cli.commands.run_helpers import ensure_uuid
+from minitest_cli.models import BuildResponse
+from minitest_cli.utils.output import output, print_table
+
+
+def _version_label(build: BuildResponse) -> str | None:
+    if build.app_version and build.build_number:
+        return f"{build.app_version} ({build.build_number})"
+    return build.app_version or build.build_number
+
+
+def get(
+    build_id: Annotated[str, typer.Argument(help="Build ID (from `minitest build list`).")],
+) -> None:
+    """Show one build of the active app: status, version, commit and failure guidance."""
+    ensure_uuid(build_id, kind="build ID")
+    settings, app_id, json_mode = resolve_app()
+
+    async def _run() -> BuildResponse:
+        async with ApiClient(settings) as client:
+            resp = await client.get(f"{base_path(app_id)}/builds/{build_id}")
+        handle_response_error(resp, resource="Build")
+        return BuildResponse.model_validate(resp.json())
+
+    build = run_api_call(_run())
+
+    if json_mode:
+        output(redacted_build(build), json_mode=True)
+        return
+
+    version = _version_label(build)
+    title = f"Build {version}" if version else "Build"
+    print_table(BUILD_TABLE_HEADERS, [format_build_row(build)], title=title)
+    print_fix_prompts([build])

minitest_cli-0.37.0/src/minitest_cli/commands/draft.py

@@ -0,0 +1,111 @@
+"""`minitest draft`: ask Mini for a suite change and drive it to merge.
+
+A draft is the workbench the webapp shows under Drafts: a branch of the suite plus
+Mini's conversation about it. Mini is the only author of the branch; never `df apply`
+into a draft's branch yourself.
+"""
+
+from typing import Annotated
+
+import typer
+
+from minitest_cli.commands import (
+    draft_asks,
+    draft_conversation,
+    draft_create,
+    draft_legacy,
+    draft_lifecycle,
+    draft_pr,
+    draft_update,
+)
+from minitest_cli.commands.draft_helpers import (
+    DRAFTS_PATH,
+    call,
+    draft_path,
+    resolve_target,
+    run_conductor,
+)
+from minitest_cli.commands.draft_render import (
+    DRAFT_TABLE_HEADERS,
+    draft_row,
+    show_draft,
+)
+from minitest_cli.commands.draft_watch import WatchUntil, watch
+from minitest_cli.utils.output import (
+    print_info,
+    print_json,
+    print_table,
+)
+
+app = typer.Typer(
+    name="draft",
+    help="Ask Mini for a suite change, follow the conversation, and check/merge the result.",
+    no_args_is_help=True,
+)
+EXIT_WATCH_TIMEOUT = 1
+
+
+@app.command(name="list")
+def list_drafts(
+    history: Annotated[
+        bool, typer.Option("--history", help="List merged and discarded drafts instead.")
+    ] = False,
+) -> None:
+    """List the active app's drafts (open ones by default)."""
+    target = resolve_target()
+    params = {"appId": target.app_id, "scope": "history" if history else "open"}
+    body = call(target, "GET", DRAFTS_PATH, retry=True, params=params)
+    drafts = body.get("drafts", [])
+    if target.json_mode:
+        print_json(drafts)
+        return
+    if not drafts:
+        print_info("No drafts found.")
+        return
+    print_table(
+        DRAFT_TABLE_HEADERS, [draft_row(d) for d in drafts], title=f"Drafts ({len(drafts)})"
+    )
+
+
+@app.command(name="get")
+def get_draft(
+    draft_id: Annotated[str, typer.Argument(help="Draft ID.")],
+    watch_flag: Annotated[
+        bool, typer.Option("--watch", help="Poll until the draft is stable, then print it.")
+    ] = False,
+    until: Annotated[
+        WatchUntil,
+        typer.Option(
+            "--until",
+            help="idle: Mini has nothing queued. settled: also no check or draft build running.",
+        ),
+    ] = WatchUntil.IDLE,
+    interval: Annotated[
+        float, typer.Option("--interval", min=1.0, help="Seconds between polls.")
+    ] = 5.0,
+    timeout: Annotated[
+        float, typer.Option("--timeout", min=1.0, help="Give up after this many seconds (exit 1).")
+    ] = 900.0,
+) -> None:
+    """Show a draft: state, Mini's status, scenarios and open asks."""
+    target = resolve_target()
+    path = draft_path(draft_id)
+    if not watch_flag:
+        show_draft(call(target, "GET", path, retry=True), json_mode=target.json_mode)
+        return
+    draft, stable = run_conductor(
+        watch(target, path, until=until, interval=interval, timeout=timeout)
+    )
+    show_draft(draft, json_mode=target.json_mode)
+    if not stable:
+        print_info(f"Still not {until.value} after {timeout:.0f}s; run the same command again.")
+        raise typer.Exit(code=EXIT_WATCH_TIMEOUT)
+
+
+draft_create.register(app)
+draft_update.register(app)
+draft_conversation.register(app)
+draft_lifecycle.register(app)
+draft_pr.register(app)
+app.add_typer(draft_asks.app)
+draft_legacy.register(app)

minitest_cli-0.37.0/src/minitest_cli/commands/draft_asks.py

@@ -0,0 +1,148 @@
+"""`minitest draft ask list|answer|decline`: answer what Mini asked on a draft.
+
+Secret fields (``secret: true`` in an ask's answerFields) are only read from a file or
+stdin (``--field-file KEY=PATH``, ``-`` for stdin) — never from the command line, where
+shells and process lists keep them — and are never printed back.
+"""
+
+from pathlib import Path
+from typing import Annotated, Any
+
+import typer
+
+from minitest_cli.commands.draft_helpers import (
+    EXIT_GENERAL_ERROR,
+    EXIT_NOT_FOUND,
+    DraftTarget,
+    call,
+    draft_path,
+    resolve_target,
+)
+from minitest_cli.commands.draft_render import (
+    ASK_TABLE_HEADERS,
+    ask_fields,
+    read_file,
+    read_text,
+    show_draft,
+)
+from minitest_cli.commands.run_helpers import ensure_uuid
+from minitest_cli.utils.output import (
+    print_error,
+    print_info,
+    print_json,
+    print_success,
+    print_table,
+)
+
+app = typer.Typer(
+    name="ask", help="Read and answer Mini's questions on a draft.", no_args_is_help=True
+)
+DraftIdArg = Annotated[str, typer.Argument(help="Draft ID.")]
+AskIdArg = Annotated[str, typer.Argument(help="Ask ID (from `draft ask list`).")]
+
+
+def _open_asks(target: DraftTarget, draft_id: str) -> list[dict[str, Any]]:
+    return call(target, "GET", draft_path(draft_id), retry=True).get("asks") or []
+
+
+def _find_ask(target: DraftTarget, draft_id: str, ask_id: str) -> dict[str, Any]:
+    ensure_uuid(ask_id, kind="ask id")
+    for ask in _open_asks(target, draft_id):
+        if ask.get("id") == ask_id:
+            return ask
+    print_error(f"No open ask {ask_id} on draft {draft_id}; see `minitest draft ask list`.")
+    raise typer.Exit(code=EXIT_NOT_FOUND)
+
+
+def _pair(raw: str, flag: str) -> tuple[str, str]:
+    key, sep, value = raw.partition("=")
+    if not sep or not key:
+        print_error(f"{flag} expects KEY=VALUE.")
+        raise typer.Exit(code=EXIT_GENERAL_ERROR)
+    return key, value
+
+
+def _fields(ask: dict[str, Any], inline: list[str], files: list[str]) -> dict[str, str]:
+    known = {f["key"]: f for f in ask.get("answerFields") or []}
+    values: dict[str, str] = {}
+    for raw in inline:
+        key, value = _pair(raw, "--field")
+        if known.get(key, {}).get("secret"):
+            print_error(f"'{key}' is secret: pass it with --field-file {key}=PATH (- = stdin).")
+            raise typer.Exit(code=EXIT_GENERAL_ERROR)
+        values[key] = value
+    if sum(1 for raw in files if _pair(raw, "--field-file")[1] == "-") > 1:
+        print_error("Only one --field-file can read stdin.")
+        raise typer.Exit(code=EXIT_GENERAL_ERROR)
+    for raw in files:
+        key, path = _pair(raw, "--field-file")
+        values[key] = read_file(Path(path)).removesuffix("\n")
+    unknown = sorted(set(values) - set(known))
+    if unknown:
+        print_error(f"Unknown field(s) {', '.join(unknown)}; this ask takes: {ask_fields(ask)}.")
+        raise typer.Exit(code=EXIT_GENERAL_ERROR)
+    return values
+
+
+@app.command(name="list")
+def list_asks(draft_id: DraftIdArg) -> None:
+    """List Mini's open questions on a draft, with the fields each answer takes."""
+    target = resolve_target()
+    asks = _open_asks(target, draft_id)
+    if target.json_mode:
+        print_json(asks)
+        return
+    if not asks:
+        print_info("Mini is not asking anything.")
+        return
+    rows = [[a["id"], a.get("askType", "-"), a["question"], ask_fields(a)] for a in asks]
+    print_table(ASK_TABLE_HEADERS, rows)
+
+
+@app.command(name="answer")
+def answer_ask(
+    draft_id: DraftIdArg,
+    ask_id: AskIdArg,
+    answer: Annotated[str | None, typer.Option("--answer", help="Free-text answer.")] = None,
+    answer_file: Annotated[
+        Path | None, typer.Option("--answer-file", help="Read the answer from a file (- = stdin).")
+    ] = None,
+    field: Annotated[
+        list[str] | None, typer.Option("--field", help="KEY=VALUE for a non-secret field.")
+    ] = None,
+    field_file: Annotated[
+        list[str] | None,
+        typer.Option("--field-file", help="KEY=PATH, value read from a file (- = stdin)."),
+    ] = None,
+) -> None:
+    """Answer an ask; Mini resumes the draft with it. Turns auto-merge off."""
+    text = read_text(answer, answer_file, flag="answer", required=False)
+    target = resolve_target()
+    ask = _find_ask(target, draft_id, ask_id)
+    values = _fields(ask, field or [], field_file or [])
+    if text is None and not values:
+        print_error("Pass --answer/--answer-file, or the ask's fields with --field/--field-file.")
+        raise typer.Exit(code=EXIT_GENERAL_ERROR)
+    body: dict[str, object] = {}
+    if text is not None:
+        body["answer"] = text
+    if values:
+        body["fields"] = values
+    draft = call(target, "POST", draft_path(draft_id, f"/asks/{ask_id}/answer"), json=body)
+    print_success("Answered; Mini picks it up next.")
+    show_draft(draft, json_mode=target.json_mode)
+
+
+@app.command(name="decline")
+def decline_ask(
+    draft_id: DraftIdArg,
+    ask_id: AskIdArg,
+    reason: Annotated[str | None, typer.Option("--reason", help="Why, so Mini can adapt.")] = None,
+) -> None:
+    """Decline an ask; Mini carries on without it."""
+    target = resolve_target()
+    ensure_uuid(ask_id, kind="ask id")
+    body = {"reason": reason} if reason else None
+    draft = call(target, "POST", draft_path(draft_id, f"/asks/{ask_id}/decline"), json=body)
+    print_success("Declined.")
+    show_draft(draft, json_mode=target.json_mode)