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

{minitest_cli-0.35.0 → minitest_cli-0.36.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.36.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: minitest-cli
-Version: 0.35.0
+Version: 0.36.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
@@ -178,7 +178,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
@@ -226,28 +225,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.36.0}/README.md

@@ -145,7 +145,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
@@ -193,28 +192,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.36.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "minitest-cli"
-version = "0.35.0"
+version = "0.36.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.36.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
 
 

{minitest_cli-0.35.0 → minitest_cli-0.36.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.36.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.36.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.36.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.36.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.35.0 → minitest_cli-0.36.0}/src/minitest_cli/commands/issues.py

@@ -6,6 +6,7 @@ from typing import Annotated
 import typer
 
 from minitest_cli.commands.issues_fix import fix
+from minitest_cli.commands.issues_get import get
 from minitest_cli.commands.issues_service import collect_issues
 from minitest_cli.commands.run_helpers import ensure_uuid, resolve_app, run_api_call
 from minitest_cli.utils.output import print_error, print_json
@@ -25,6 +26,7 @@ class IssueCriticality(StrEnum):
 app = typer.Typer(
     name="issues", help="Read app issues, fix prompts, and mark them fixed.", no_args_is_help=True
 )
+app.command()(get)
 app.command()(fix)
 
 

minitest_cli-0.36.0/src/minitest_cli/commands/issues_get.py

@@ -0,0 +1,33 @@
+"""``minitest issues get``: read one issue of the active app by id."""
+
+from typing import Annotated
+
+import typer
+
+from minitest_cli.api.client import ApiClient
+from minitest_cli.commands.issues_helpers import fetch_failure, fetch_optional_batch
+from minitest_cli.commands.issues_projection import build_block, issue_item
+from minitest_cli.commands.run_helpers import ensure_uuid, resolve_app, run_api_call
+from minitest_cli.core.config import Settings
+from minitest_cli.models.issues import IssueDetailResponse
+from minitest_cli.utils.output import print_json
+
+
+async def read_issue(settings: Settings, app_id: str, issue_id: str) -> IssueDetailResponse:
+    async with ApiClient(settings) as client:
+        failure = await fetch_failure(client, app_id, issue_id)
+        batch = (
+            await fetch_optional_batch(client, app_id, failure.batch_id)
+            if failure.batch_id
+            else None
+        )
+    return IssueDetailResponse(issue=issue_item(failure), build=build_block(batch))
+
+
+def get(
+    issue_id: Annotated[str, typer.Argument(help="Issue ID (the `id` from `issues list`).")],
+) -> None:
+    """Return one issue, whatever its status, with its build provenance and fix prompt as JSON."""
+    ensure_uuid(issue_id, kind="issue")
+    settings, app_id, _ = resolve_app()
+    print_json(run_api_call(read_issue(settings, app_id, issue_id)))

{minitest_cli-0.35.0 → minitest_cli-0.36.0}/src/minitest_cli/commands/test_profile.py

@@ -20,6 +20,7 @@ from minitest_cli.commands.test_profile_helpers import (
     is_json_mode,
     read_stdin_secret,
     run_api_call,
+    warn_if_qa_inbox_unreadable,
 )
 from minitest_cli.core.app_context import resolve_app_id
 from minitest_cli.core.auth import require_auth
@@ -125,6 +126,7 @@ def create_profile(
     data = run_api_call(_run())
     if not json_mode:
         print_success(f"Test profile created: {data.get('id', '')}")
+    warn_if_qa_inbox_unreadable(data)
     output(data, json_mode=json_mode)
 
 
@@ -143,7 +145,9 @@ def get_profile(
             handle_profile_response(resp)
             return resp.json()
 
-    output(run_api_call(_run()), json_mode=json_mode)
+    data = run_api_call(_run())
+    warn_if_qa_inbox_unreadable(data)
+    output(data, json_mode=json_mode)
 
 
 @app.command(name="delete")

{minitest_cli-0.35.0 → minitest_cli-0.36.0}/src/minitest_cli/commands/test_profile_helpers.py

@@ -13,7 +13,7 @@ from minitest_cli.commands.user_story_helpers import (
     is_json_mode,
     run_api_call,
 )
-from minitest_cli.utils.output import print_error
+from minitest_cli.utils.output import print_error, print_warning
 
 EXIT_NETWORK_ERROR = 3
 EXIT_NOT_FOUND = 4
@@ -87,3 +87,11 @@ __all__ = [
     "read_stdin_secret",
     "run_api_call",
 ]
+
+
+def warn_if_qa_inbox_unreadable(profile: dict[str, Any]) -> None:
+    if profile.get("qaInboxShared"):
+        print_warning(
+            f"{profile.get('username')} belongs to another workspace, so Mini can't read its "
+            "emails (login codes, verification links). Use a different @qa.minitap.ai address."
+        )

{minitest_cli-0.35.0 → minitest_cli-0.36.0}/src/minitest_cli/commands/test_profile_list.py

@@ -13,6 +13,7 @@ from minitest_cli.commands.test_profile_helpers import (
     handle_profile_response,
     is_json_mode,
     run_api_call,
+    warn_if_qa_inbox_unreadable,
 )
 from minitest_cli.core.app_context import resolve_app_id
 from minitest_cli.core.auth import require_auth
@@ -36,6 +37,8 @@ def register(app: typer.Typer) -> None:
 
         data = run_api_call(_run())
         items = data["items"] if isinstance(data, dict) and "items" in data else data
+        for profile in items:
+            warn_if_qa_inbox_unreadable(profile)
         if json_mode:
             output(items, json_mode=True)
             return

{minitest_cli-0.35.0 → minitest_cli-0.36.0}/src/minitest_cli/commands/test_profile_update.py

@@ -20,6 +20,7 @@ from minitest_cli.commands.test_profile_helpers import (
     is_json_mode,
     read_stdin_secret,
     run_api_call,
+    warn_if_qa_inbox_unreadable,
 )
 from minitest_cli.core.app_context import resolve_app_id
 from minitest_cli.core.auth import require_auth
@@ -156,4 +157,5 @@ def register(app: typer.Typer) -> None:
         data = run_api_call(_run())
         if not json_mode:
             print_success(f"Test profile updated: {profile_id}")
+        warn_if_qa_inbox_unreadable(data)
         output(data, json_mode=json_mode)

{minitest_cli-0.35.0 → minitest_cli-0.36.0}/src/minitest_cli/main.py

@@ -18,7 +18,6 @@ from minitest_cli.commands import (
     flow_types,
     init,
     issues,
-    maintenance,
     run,
     screens,
     skill,
@@ -60,7 +59,6 @@ app.add_typer(build.app)
 app.add_typer(env.app)
 app.add_typer(run.app)
 app.add_typer(issues.app)
-app.add_typer(maintenance.app)
 app.add_typer(batch.app)
 app.add_typer(skill.app)
 app.add_typer(upgrade.app)

{minitest_cli-0.35.0 → minitest_cli-0.36.0}/src/minitest_cli/models/build.py

@@ -17,6 +17,10 @@ class BuildResponse(CamelModel):
     size_bytes: int | None = None
     commit_sha: str | None = None
     commit_title: str | None = None
+    app_version: str | None = None
+    build_number: str | None = None
+    verification_status: str | None = None
+    verification_reason: str | None = None
     error_class: str | None = None
     error_summary: str | None = None
     error_remediation: str | None = None

{minitest_cli-0.35.0 → minitest_cli-0.36.0}/src/minitest_cli/models/issues.py

@@ -75,3 +75,8 @@ class IssuesListResponse(CamelModel):
     scope: IssuesScope
     build: IssuesBuild
     issues: list[IssueItem]
+
+
+class IssueDetailResponse(CamelModel):
+    issue: IssueItem
+    build: IssuesBuild

{minitest_cli-0.35.0 → minitest_cli-0.36.0}/tests/test_app_skill_commands.py

@@ -97,6 +97,56 @@ def test_update_all_platforms_clears_the_platform_filter(tmp_path):
     assert recorder.body == {"platforms": []}
 
 
+def test_update_sends_paired_replacements_and_prints_what_changed(tmp_path):
+    changes = ["Changed runnable blocks: fill.sh", "Instructions went from 900 to 940 characters"]
+    recorder = Recorder(httpx.Response(200, json=_skill(version=3, changes=changes)))
+
+    result = _invoke(
+        skill_app,
+        [
+            "update",
+            "color-by-number-fill",
+            "--replace",
+            "retry once",
+            "--with",
+            "retry three times",
+            "--replace",
+            "# old check\n",
+            "--with",
+            "",
+            "--allow-destructive",
+        ],
+        recorder,
+        tmp_path,
+    )
+
+    assert result.exit_code == 0, result.output
+    assert recorder.body == {
+        "edits": [
+            {"oldText": "retry once", "newText": "retry three times"},
+            {"oldText": "# old check\n", "newText": ""},
+        ],
+        "allowDestructive": True,
+    }
+    assert "Changed runnable blocks: fill.sh" in result.output
+
+
+@pytest.mark.parametrize(
+    "args",
+    [
+        ["--replace", "a", "--with", "b", "--replace", "c"],
+        ["--replace", "a", "--with", "b", "--instructions", "whole"],
+    ],
+)
+def test_update_refuses_ambiguous_instruction_changes_before_calling_the_api(tmp_path, args):
+    recorder = Recorder(httpx.Response(200, json=_skill()))
+
+    result = _invoke(skill_app, ["update", "color-by-number-fill", *args], recorder, tmp_path)
+
+    assert result.exit_code == 1
+    assert recorder.requests == []
+
+
 def test_delete_linked_skill_lists_scenarios_and_keeps_the_skill(tmp_path):
     recorder = Recorder(
         httpx.Response(

minitest_cli-0.36.0/tests/test_build_get_command.py

@@ -0,0 +1,106 @@
+"""Behavior tests for `minitest build get`."""
+
+import json
+from pathlib import Path
+from typing import Any
+from unittest.mock import patch
+
+import httpx
+from tests._commit_transport import make_settings, routed
+from typer.testing import CliRunner
+
+from minitest_cli.commands.build_fix_prompts import WITHHELD_NOTICE
+from minitest_cli.main import app
+
+runner = CliRunner()
+APP_ID = "a0d9820f-5136-4f70-b46b-e5966f56bfb5"
+BUILD_ID = "6f1c2a3b-4d5e-4f60-8a7b-9c0d1e2f3a4b"
+FOREIGN_BUILD_ID = "0b6d1f4e-2c3a-4e5f-9a8b-7c6d5e4f3a2b"
+BUILD = {
+    "id": BUILD_ID,
+    "appId": APP_ID,
+    "kind": "native",
+    "platform": "ios",
+    "status": "completed",
+    "originalName": "Shop.app.zip",
+    "sizeBytes": 2048,
+    "commitSha": "a1b2c3d4e5f6",
+    "commitTitle": "feat: checkout v2",
+    "appVersion": "4.2.0",
+    "buildNumber": "317",
+    "verificationStatus": "verified",
+    "createdAt": "2026-10-14T09:30:00Z",
+}
+
+
+def _serve(build: dict[str, Any]):
+    seen: list[str] = []
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        seen.append(request.url.path)
+        if request.url.path == f"/api/v1/apps/{APP_ID}/builds/{BUILD_ID}":
+            return httpx.Response(200, json=build)
+        return httpx.Response(404, json={"message": "Build not found"})
+
+    return handler, seen
+
+
+def _invoke(tmp_path: Path, build: dict[str, Any], args: list[str]):
+    handler, seen = _serve(build)
+    with (
+        routed(handler),
+        patch("minitest_cli.main.get_settings", return_value=make_settings(tmp_path)),
+        patch("minitest_cli.main.check_for_updates"),
+    ):
+        return runner.invoke(app, args), seen
+
+
+class TestBuildGet:
+    def test_get_returns_the_app_build_as_json(self, tmp_path: Path) -> None:
+        result, seen = _invoke(tmp_path, BUILD, ["--json", "build", "get", BUILD_ID])
+
+        assert result.exit_code == 0
+        assert seen == [f"/api/v1/apps/{APP_ID}/builds/{BUILD_ID}"]
+        payload = json.loads(result.stdout)
+        assert payload["id"] == BUILD_ID
+        assert (payload["appVersion"], payload["buildNumber"]) == ("4.2.0", "317")
+        assert payload["commitTitle"] == "feat: checkout v2"
+        assert payload["verificationStatus"] == "verified"
+        assert payload["guidance"] is None
+
+    def test_get_withholds_infra_failure_details(self, tmp_path: Path) -> None:
+        failed = {
+            **BUILD,
+            "status": "failed",
+            "errorClass": "infra",
+            "errorSummary": "builder disk full",
+            "errorFixPrompt": "ssh into the builder",
+        }
+
+        result, _ = _invoke(tmp_path, failed, ["--json", "build", "get", BUILD_ID])
+
+        payload = json.loads(result.stdout)
+        assert payload["guidance"] == {"source": "withheld", "text": WITHHELD_NOTICE}
+        assert payload["errorSummary"] == WITHHELD_NOTICE
+        assert payload["errorFixPrompt"] is None
+
+    def test_get_shows_the_version_in_human_mode(self, tmp_path: Path) -> None:
+        result, _ = _invoke(tmp_path, BUILD, ["build", "get", BUILD_ID])
+
+        assert result.exit_code == 0
+        assert "Build 4.2.0 (317)" in result.stdout
+        assert "completed" in result.stdout
+
+    def test_get_a_build_of_another_app_is_not_found(self, tmp_path: Path) -> None:
+        result, _ = _invoke(tmp_path, BUILD, ["--json", "build", "get", FOREIGN_BUILD_ID])
+
+        assert result.exit_code == 4
+        assert "Build not found" in result.stderr
+        assert result.stdout == ""
+
+    def test_get_rejects_a_non_uuid_without_calling_the_api(self, tmp_path: Path) -> None:
+        result, seen = _invoke(tmp_path, BUILD, ["build", "get", "317"])
+
+        assert result.exit_code == 1
+        assert "not a valid UUID" in result.stderr
+        assert seen == []