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

{minitest_cli-0.34.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.34.0 → minitest_cli-0.36.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: minitest-cli
-Version: 0.34.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
@@ -166,7 +166,7 @@ app defaults.
 | Command          | Description               |
 | ---------------- | ------------------------- |
 | `minitest auth`  | Authentication management |
-| `minitest apps`  | List, inspect, and create apps |
+| `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 |
@@ -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
@@ -198,28 +197,34 @@ stderr and leave `--json` stdout unchanged. Switch to the new names.
 | `run cancel --srp`, `run recording --srp` | `--target-id` |
 | `--type` on `scenario create/update/list` | `--tag` |
 
-## CLI-only maintenance
+## App network settings
 
-`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.
+Two per-app settings decide how test devices reach the network. Anyone on the
+app can read them; only workspace **owners and admins** can change them (other
+roles get `Only workspace owners and admins can change this setting`, exit 2).
+`set` reads the current settings first and changes only what you pass.
+Domains are an exact host (`api.stg.example.com`) or `*.example.com`, which
+matches subdomains only, not `example.com` itself.
 
 ```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
+# Residential proxy: reach the listed domains from a residential IP in one country
+minitest --app <app-id> apps residential-proxy show
+minitest --app <app-id> apps residential-proxy set [--enable|--disable] [--country tr] \
+  [--domain ipinfo.io ...] [--remove-domain <d> ...] [--clear-domains]
+
+# Private network: reach internal domains through a connector running in your network
+minitest --app <app-id> apps private-network show
+minitest --app <app-id> apps private-network connectors
+minitest --app <app-id> apps private-network set [--enable|--disable] [--connector <name-or-id>] \
+  [--domain api.stg.corp.internal ...] [--remove-domain <d> ...] [--clear-domains] [--port 443 ...]
 ```
 
+`--clear-domains --domain a --domain b` replaces the list; `--port` replaces the
+ports (default 443). Turning the private network on needs a connector and at
+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**.
+
 ## Exit Codes
 
 | Code | Meaning                                            |

{minitest_cli-0.34.0 → minitest_cli-0.36.0}/README.md

@@ -133,7 +133,7 @@ app defaults.
 | Command          | Description               |
 | ---------------- | ------------------------- |
 | `minitest auth`  | Authentication management |
-| `minitest apps`  | List, inspect, and create apps |
+| `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 |
@@ -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
@@ -165,28 +164,34 @@ stderr and leave `--json` stdout unchanged. Switch to the new names.
 | `run cancel --srp`, `run recording --srp` | `--target-id` |
 | `--type` on `scenario create/update/list` | `--tag` |
 
-## CLI-only maintenance
+## App network settings
 
-`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.
+Two per-app settings decide how test devices reach the network. Anyone on the
+app can read them; only workspace **owners and admins** can change them (other
+roles get `Only workspace owners and admins can change this setting`, exit 2).
+`set` reads the current settings first and changes only what you pass.
+Domains are an exact host (`api.stg.example.com`) or `*.example.com`, which
+matches subdomains only, not `example.com` itself.
 
 ```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
+# Residential proxy: reach the listed domains from a residential IP in one country
+minitest --app <app-id> apps residential-proxy show
+minitest --app <app-id> apps residential-proxy set [--enable|--disable] [--country tr] \
+  [--domain ipinfo.io ...] [--remove-domain <d> ...] [--clear-domains]
+
+# Private network: reach internal domains through a connector running in your network
+minitest --app <app-id> apps private-network show
+minitest --app <app-id> apps private-network connectors
+minitest --app <app-id> apps private-network set [--enable|--disable] [--connector <name-or-id>] \
+  [--domain api.stg.corp.internal ...] [--remove-domain <d> ...] [--clear-domains] [--port 443 ...]
 ```
 
+`--clear-domains --domain a --domain b` replaces the list; `--port` replaces the
+ports (default 443). Turning the private network on needs a connector and at
+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**.
+
 ## Exit Codes
 
 | Code | Meaning                                            |

{minitest_cli-0.34.0 → minitest_cli-0.36.0}/pyproject.toml

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

{minitest_cli-0.34.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.36.0/src/minitest_cli/commands/app_network_helpers.py

@@ -0,0 +1,114 @@
+"""Shared plumbing for the per-app network settings (residential proxy, private network)."""
+
+import asyncio
+import re
+from typing import Any
+
+import httpx
+import typer
+
+from minitest_cli.api.client import ApiClient
+from minitest_cli.api.errors import format_network_error
+from minitest_cli.commands._response_errors import extract_detail
+from minitest_cli.core.app_context import resolve_app_id
+from minitest_cli.core.auth import require_auth
+from minitest_cli.core.config import Settings
+from minitest_cli.utils.output import print_error
+
+EXIT_GENERAL_ERROR = 1
+EXIT_AUTH_ERROR = 2
+EXIT_NETWORK_ERROR = 3
+EXIT_NOT_FOUND = 4
+
+ADMIN_ONLY_MESSAGE = "Only workspace owners and admins can change this setting."
+
+
+def is_json_mode() -> bool:
+    return typer.Context.json_mode  # type: ignore[attr-defined]
+
+
+def resolve_target() -> tuple[Settings, str]:
+    settings: Settings = typer.Context.settings  # type: ignore[attr-defined]
+    require_auth(settings)
+    return settings, resolve_app_id(settings, typer.Context.app_flag)  # type: ignore[attr-defined]
+
+
+def fail(message: str, code: int = EXIT_GENERAL_ERROR) -> typer.Exit:
+    print_error(message)
+    return typer.Exit(code=code)
+
+
+def _raise_for_status(resp: httpx.Response) -> None:
+    if resp.status_code < 400:
+        return
+    detail = extract_detail(resp)
+    if resp.status_code == 403:
+        raise fail(f"{ADMIN_ONLY_MESSAGE} ({detail})", EXIT_AUTH_ERROR)
+    if resp.status_code == 401:
+        raise fail(f"Authentication failed: {detail}", EXIT_AUTH_ERROR)
+    if resp.status_code == 404:
+        raise fail(f"Not found: {detail}", EXIT_NOT_FOUND)
+    if resp.status_code in (400, 409, 422):
+        raise fail(f"Rejected by the server ({resp.status_code}): {detail}")
+    raise fail(f"API error ({resp.status_code}): {detail}", EXIT_NETWORK_ERROR)
+
+
+def call_api(
+    settings: Settings, method: str, path: str, body: dict[str, Any] | None = None
+) -> dict[str, Any]:
+    async def _run() -> dict[str, Any]:
+        async with ApiClient(settings) as client:
+            resp = await client.request(method, path, json=body)
+        _raise_for_status(resp)
+        try:
+            return resp.json()
+        except ValueError as exc:
+            raise fail(
+                f"Unexpected non-JSON response ({resp.status_code}): {resp.text[:200]}",
+                EXIT_NETWORK_ERROR,
+            ) from exc
+
+    try:
+        return asyncio.run(_run())
+    except httpx.HTTPError as exc:
+        raise fail(format_network_error(exc), EXIT_NETWORK_ERROR) from exc
+
+
+def merge_domains(
+    current: list[str],
+    *,
+    add: list[str] | None,
+    remove: list[str] | None,
+    clear: bool,
+    pattern: str,
+    max_domains: int,
+) -> list[str]:
+    """Apply ``--clear-domains``, ``--remove-domain`` then ``--domain`` and validate the result."""
+    added = [_normalize(d) for d in add or []]
+    invalid = [d for d in added if not re.fullmatch(pattern, d)]
+    if invalid:
+        raise fail(
+            f"Invalid domain(s): {', '.join(invalid)}. Use a lowercase host like api.example.com, "
+            "or *.example.com to match its subdomains (not example.com itself)."
+        )
+    removed = {_normalize(d) for d in remove or []}
+    unknown = sorted(removed - set(current))
+    if unknown:
+        raise fail(f"Not in the current domain list: {', '.join(unknown)}.")
+    base = [] if clear else [d for d in current if d not in removed]
+    merged = list(dict.fromkeys([*base, *added]))
+    if len(merged) > max_domains:
+        raise fail(f"Too many domains: {len(merged)} (max {max_domains}).")
+    return merged
+
+
+def _normalize(domain: str) -> str:
+    return domain.strip().lower().rstrip(".")
+
+
+def on_off(value: bool) -> str:
+    return "on" if value else "off"
+
+
+def domain_list(domains: list[str]) -> str:
+    return ", ".join(domains) if domains else "-"

{minitest_cli-0.34.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.34.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.34.0 → minitest_cli-0.36.0}/src/minitest_cli/commands/apps.py

@@ -1,4 +1,4 @@
-"""App management commands: list, get, create, dependencies."""
+"""App management commands: list, get, create, dependencies, network settings."""
 
 import asyncio
 from pathlib import Path
@@ -10,7 +10,12 @@ import typer
 from minitest_cli.api.apps_manager_client import AppsManagerClient  # noqa: F401  re-exported for tests
 from minitest_cli.api.client import ApiClient
 from minitest_cli.api.errors import format_network_error
-from minitest_cli.commands import apps_dependencies, apps_get
+from minitest_cli.commands import (
+    apps_dependencies,
+    apps_get,
+    private_network,
+    residential_proxy,
+)
 from minitest_cli.commands.apps_helpers import create_app_request
 from minitest_cli.commands.apps_table import APP_TABLE_HEADERS, app_row
 from minitest_cli.core.auth import require_auth
@@ -30,6 +35,8 @@ EXIT_NETWORK_ERROR = 3
 app = typer.Typer(name="apps", help="App management.")
 app.command(name="dependencies")(apps_dependencies.dependencies)
 app.command(name="get")(apps_get.get_app)
+app.add_typer(residential_proxy.app)
+app.add_typer(private_network.app)
 
 
 @app.callback()

{minitest_cli-0.34.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.34.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.34.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)))