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

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: minitest-cli
-Version: 0.32.0
+Version: 0.34.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
@@ -167,19 +167,42 @@ app defaults.
 | ---------------- | ------------------------- |
 | `minitest auth`  | Authentication management |
 | `minitest apps`  | List, inspect, and create apps |
-| `minitest user-story` | User-story operations |
-| `minitest df`    | Draft features — branches of the test suite |
-| `minitest flow-types` | List flow types, create/rename/delete custom ones |
+| `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 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 |
 | `minitest screens` | Inspect the screens exploration mapped for an app |
 | `minitest build` | Native iOS/Android build management |
-| `minitest run`   | Test execution for mobile and web lanes |
-| `minitest maintenance` | CLI-only test-flow maintenance against local code |
+| `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
+
+Old names keep working as hidden aliases: they print a deprecation warning on
+stderr and leave `--json` stdout unchanged. Switch to the new names.
+
+| Deprecated | Use instead |
+| ---------- | ----------- |
+| `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 flow-types` | `minitest tags` |
+| `run from-commit --user-story` / `-u` | `run from-commit --scenario` / `-s` |
+| `batch list --user-story-id` | `batch list --scenario` |
+| `run cancel --srp`, `run recording --srp` | `--target-id` |
+| `--type` on `scenario create/update/list` | `--tag` |
 
 ## CLI-only maintenance
 
-`minitest maintenance` lets a coding agent keep Minitest user stories in sync
+`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 test-flow edits and the local HEAD SHA.
+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
@@ -189,7 +212,7 @@ minitest maintenance --agent
 minitest --json maintenance context
 minitest maintenance affected --file affected.json
 minitest maintenance change --file change.json
-minitest maintenance status --phase writing --message "Updating affected stories"
+minitest maintenance status --phase writing --message "Updating affected scenarios"
 minitest maintenance complete --changed
 
 # Apply proposed edits now, or open the web review queue

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

@@ -134,19 +134,42 @@ app defaults.
 | ---------------- | ------------------------- |
 | `minitest auth`  | Authentication management |
 | `minitest apps`  | List, inspect, and create apps |
-| `minitest user-story` | User-story operations |
-| `minitest df`    | Draft features — branches of the test suite |
-| `minitest flow-types` | List flow types, create/rename/delete custom ones |
+| `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 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 |
 | `minitest screens` | Inspect the screens exploration mapped for an app |
 | `minitest build` | Native iOS/Android build management |
-| `minitest run`   | Test execution for mobile and web lanes |
-| `minitest maintenance` | CLI-only test-flow maintenance against local code |
+| `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
+
+Old names keep working as hidden aliases: they print a deprecation warning on
+stderr and leave `--json` stdout unchanged. Switch to the new names.
+
+| Deprecated | Use instead |
+| ---------- | ----------- |
+| `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 flow-types` | `minitest tags` |
+| `run from-commit --user-story` / `-u` | `run from-commit --scenario` / `-s` |
+| `batch list --user-story-id` | `batch list --scenario` |
+| `run cancel --srp`, `run recording --srp` | `--target-id` |
+| `--type` on `scenario create/update/list` | `--tag` |
 
 ## CLI-only maintenance
 
-`minitest maintenance` lets a coding agent keep Minitest user stories in sync
+`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 test-flow edits and the local HEAD SHA.
+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
@@ -156,7 +179,7 @@ minitest maintenance --agent
 minitest --json maintenance context
 minitest maintenance affected --file affected.json
 minitest maintenance change --file change.json
-minitest maintenance status --phase writing --message "Updating affected stories"
+minitest maintenance status --phase writing --message "Updating affected scenarios"
 minitest maintenance complete --changed
 
 # Apply proposed edits now, or open the web review queue

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

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

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/app_skill.py

@@ -21,7 +21,7 @@ from minitest_cli.utils.output import print_info, print_json, print_success, pri
 
 app = typer.Typer(
     name="app-skill",
-    help="Manage app skills: procedures Mini loads to arrange test state.",
+    help="Manage app skills (Skills in the webapp): procedures Mini loads to arrange test state.",
     no_args_is_help=True,
 )
 app.add_typer(app_skill_secret.app)

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/apps.py

@@ -12,6 +12,7 @@ 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.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
 from minitest_cli.core.config import Settings
 from minitest_cli.core.tenants import fetch_user_tenants, resolve_tenant_id
@@ -36,22 +37,6 @@ def _callback() -> None:
     """App management."""
 
 
-APP_TABLE_HEADERS = ["ID", "Name", "Platform"]
-
-_PLATFORM_LABELS: dict[str, str] = {
-    "android": "Android",
-    "ios": "iOS",
-    "web": "Web",
-}
-
-
-def _format_platforms(values: list[str]) -> str:
-    """Render an app's platform lanes for the table."""
-    if not values:
-        return "—"
-    return ", ".join(_PLATFORM_LABELS.get(v, v) for v in values)
-
-
 def _get_settings() -> Settings:
     return typer.Context.settings  # type: ignore[attr-defined]
 
@@ -92,8 +77,7 @@ def list_apps() -> None:
         print_json([a.model_dump(mode="json", by_alias=True) for a in data.apps])
         return
 
-    rows = [[a.id, a.name, _format_platforms(a.platforms)] for a in data.apps]
-    print_table(APP_TABLE_HEADERS, rows, title="Apps")
+    print_table(APP_TABLE_HEADERS, [app_row(a) for a in data.apps], title="Apps")
 
 
 @app.command(name="create")

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/apps_dependencies.py

@@ -45,7 +45,7 @@ def dependencies(
             "--simulate",
             help=(
                 "Simulate dependency edits without writing: reports cycle "
-                "verdict, affected stories, and the new run order."
+                "verdict, affected scenarios, and the new run order."
             ),
         ),
     ] = False,
@@ -54,7 +54,7 @@ def dependencies(
         typer.Option(
             "--add",
             help=(
-                "Edge to add, as <story_id>:<depends_on_id> — the story will "
+                "Edge to add, as <story_id>:<depends_on_id> — the scenario will "
                 "depend on (run after) the second id. Repeatable; requires --simulate."
             ),
         ),
@@ -69,7 +69,7 @@ def dependencies(
         ),
     ] = None,
 ) -> None:
-    """Print the user-story dependency graph as a Mermaid flowchart.
+    """Print the scenario dependency graph as a Mermaid flowchart.
 
     Fetches the dependency graph for the app and renders it as a Mermaid
     ``flowchart TD`` diagram to stdout. With ``--json``, outputs the raw
@@ -129,7 +129,7 @@ def dependencies(
 
     mermaid = build_dependency_graph(nodes, edges)
     if not mermaid:
-        print_info("No user stories found for this app.")
+        print_info("No scenarios found for this app.")
         raise typer.Exit(code=0)
 
     print(mermaid)  # noqa: T201

minitest_cli-0.34.0/src/minitest_cli/commands/apps_table.py

@@ -0,0 +1,28 @@
+"""Rows of the `apps list` table."""
+
+from minitest_cli.models.app import AppResponse
+
+APP_TABLE_HEADERS = ["ID", "Name", "Platform", "Repository", "Folder"]
+
+_PLATFORM_LABELS: dict[str, str] = {
+    "android": "Android",
+    "ios": "iOS",
+    "web": "Web",
+}
+
+
+def _format_platforms(values: list[str]) -> str:
+    if not values:
+        return "—"
+    return ", ".join(_PLATFORM_LABELS.get(v, v) for v in values)
+
+
+def app_row(app: AppResponse) -> list[str]:
+    repo = app.repository
+    return [
+        app.id,
+        app.name,
+        _format_platforms(app.platforms),
+        repo.full_name if repo else "—",
+        (repo.folder or "/") if repo else "—",
+    ]

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/batch.py

@@ -7,6 +7,7 @@ import typer
 
 from minitest_cli.api.client import ApiClient
 from minitest_cli.commands.batch_helpers import batches_base_path
+from minitest_cli.commands.deprecated_alias import deprecated_option, merge_deprecated_option
 from minitest_cli.commands.run_display import _derive_run_status
 from minitest_cli.commands.run_helpers import (
     ensure_uuid,
@@ -26,7 +27,7 @@ from minitest_cli.utils.output import (
     print_table,
 )
 
-app = typer.Typer(name="batch", help="Manage batch runs (multi-story executions).")
+app = typer.Typer(name="batch", help="List, inspect and cancel runs (Runs in the webapp).")
 
 BATCH_TABLE_HEADERS = ["ID", "Status", "Source", "Commit", "Tag", "Targets", "Created"]
 
@@ -57,26 +58,32 @@ def list_batches(
         typer.Option("--result", help="Filter by derived result (repeatable)."),
     ] = None,
     commit_sha: Annotated[str | None, typer.Option("--commit-sha")] = None,
-    user_story_id: Annotated[str | None, typer.Option("--user-story-id")] = None,
+    scenario_id: Annotated[
+        str | None, typer.Option("--scenario", help="Only runs that include this scenario ID.")
+    ] = None,
+    legacy_user_story_id: Annotated[
+        str | None, deprecated_option("--user-story-id", new_flag="--scenario")
+    ] = None,
     search: Annotated[str | None, typer.Option("--search")] = None,
     all_pages: Annotated[bool, typer.Option("--all", help="Fetch all pages.")] = False,
 ) -> None:
-    """List batches for the current app."""
+    """List the runs (batches) of the current app."""
     settings, app_id, json_mode = resolve_app()
     if all_pages:
         page, page_size = 1, 100
 
+    scenario_id = merge_deprecated_option(
+        scenario_id, legacy_user_story_id, old_flag="--user-story-id", new_flag="--scenario"
+    )
+    filters = {
+        "status": status_filter,
+        "result": result_filter,
+        "commit_sha": commit_sha,
+        "user_story_id": scenario_id,
+        "search": search,
+    }
     params: dict[str, object] = {"page": page, "page_size": page_size}
-    if status_filter:
-        params["status"] = status_filter
-    if result_filter:
-        params["result"] = result_filter
-    if commit_sha:
-        params["commit_sha"] = commit_sha
-    if user_story_id:
-        params["user_story_id"] = user_story_id
-    if search:
-        params["search"] = search
+    params.update({key: value for key, value in filters.items() if value})
 
     async def _list() -> BatchListResponse:
         async with ApiClient(settings) as client:
@@ -108,9 +115,9 @@ def list_batches(
 
 @app.command(name="get")
 def get_batch(
-    batch_id: Annotated[str, typer.Argument(help="Batch ID.")],
+    batch_id: Annotated[str, typer.Argument(help="Run (batch) ID.")],
 ) -> None:
-    """Get a single batch with its story runs."""
+    """Get one run (batch) with its scenario runs."""
     settings, app_id, json_mode = resolve_app()
     ensure_uuid(batch_id, kind="batch id")
 
@@ -165,17 +172,17 @@ def get_batch(
         )
     if rows:
         print_table(
-            ["Run ID", "User Story", "Status", "Created"],
+            ["Run ID", "Scenario", "Status", "Created"],
             rows,
-            title=f"Story runs ({len(rows)})",
+            title=f"Scenario runs ({len(rows)})",
         )
 
 
 @app.command()
 def cancel(
-    batch_id: Annotated[str, typer.Argument(help="Batch ID to cancel.")],
+    batch_id: Annotated[str, typer.Argument(help="Run (batch) ID to cancel.")],
 ) -> None:
-    """Cancel a batch and all its pending/running story runs."""
+    """Cancel a run (batch) and all its pending/running scenario runs."""
     settings, app_id, json_mode = resolve_app()
     ensure_uuid(batch_id, kind="batch id")
 

minitest_cli-0.34.0/src/minitest_cli/commands/deprecated_alias.py

@@ -0,0 +1,57 @@
+import functools
+from collections.abc import Callable
+from typing import Any
+
+import typer
+
+from minitest_cli.utils.output import print_error, print_warning
+
+
+def deprecated_alias(source: typer.Typer, *, old_name: str) -> typer.Typer:
+    """Expose ``source``'s commands under a hidden legacy name that warns on stderr."""
+    new_name = source.info.name
+    alias = typer.Typer(name=old_name, help=f"Deprecated: use `minitest {new_name}`.", hidden=True)
+
+    @alias.callback()
+    def _warn() -> None:
+        print_warning(f"`minitest {old_name}` is deprecated; use `minitest {new_name}` instead.")
+
+    alias.registered_commands = source.registered_commands
+    return alias
+
+
+def deprecated_command(
+    group: typer.Typer, command: Callable[..., Any], *, old_name: str, new_name: str
+) -> None:
+    """Register ``command`` again under a hidden legacy subcommand name that warns on stderr."""
+    group_name = group.info.name
+
+    @functools.wraps(command)
+    def _legacy(*args: Any, **kwargs: Any) -> Any:
+        print_warning(
+            f"`minitest {group_name} {old_name}` is deprecated; "
+            f"use `minitest {group_name} {new_name}` instead."
+        )
+        return command(*args, **kwargs)
+
+    group.command(name=old_name, hidden=True, help=f"Deprecated: use `{new_name}`.")(_legacy)
+
+
+def deprecated_option(*param_decls: str, new_flag: str) -> Any:
+    """A hidden option kept for a renamed flag; pair it with ``merge_deprecated_option``."""
+    return typer.Option(*param_decls, hidden=True, help=f"Deprecated alias for {new_flag}.")
+
+
+def merge_deprecated_option[T](
+    new: T | None, old: T | None, *, old_flag: str, new_flag: str
+) -> T | None:
+    """Return the renamed flag's value, falling back to its deprecated alias with a warning."""
+    if old is None:
+        return new
+    print_warning(f"{old_flag} is deprecated; use {new_flag} instead.")
+    if new is None:
+        return old
+    if isinstance(new, list) and isinstance(old, list):
+        return [*new, *old]  # type: ignore[return-value]
+    print_error(f"Use either {new_flag} or {old_flag}, not both.")
+    raise typer.Exit(code=1)

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/draft_feature.py

@@ -11,6 +11,7 @@ import typer
 
 from minitest_cli.api.client import ApiClient
 from minitest_cli.commands import draft_feature_apply, draft_feature_show
+from minitest_cli.commands.deprecated_alias import deprecated_alias
 from minitest_cli.commands.draft_feature_helpers import (
     DRAFT_FEATURE_TABLE_HEADERS,
     base_path,
@@ -21,7 +22,7 @@ from minitest_cli.commands.run_helpers import ensure_uuid, resolve_app, run_api_
 from minitest_cli.models.draft_feature import DraftFeatureResponse, DraftFeatureStatus
 from minitest_cli.utils.output import output, print_error, print_info, print_success, print_table
 
-app = typer.Typer(name="df", help="Draft features — branches of the app's test suite.")
+app = typer.Typer(name="draft", help="Drafts — branches of the app's test suite.")
 draft_feature_show.register(app)
 draft_feature_apply.register(app)
 
@@ -42,7 +43,7 @@ def list_draft_features(
     async def _list() -> list[DraftFeatureResponse]:
         async with ApiClient(settings) as client:
             resp = await client.get(base_path(app_id), params=params)
-            handle_response_error(resp, resource="Draft features")
+            handle_response_error(resp, resource="Drafts")
             return [DraftFeatureResponse.model_validate(item) for item in resp.json()]
 
     features = run_api_call(_list())
@@ -51,12 +52,12 @@ def list_draft_features(
         output([f.model_dump(mode="json", by_alias=True) for f in features], json_mode=True)
         return
     if not features:
-        print_info("No draft features found.")
+        print_info("No drafts found.")
         return
     print_table(
         DRAFT_FEATURE_TABLE_HEADERS,
         [format_draft_feature_row(f) for f in features],
-        title=f"Draft features ({len(features)})",
+        title=f"Drafts ({len(features)})",
     )
 
 
@@ -88,7 +89,7 @@ def create_draft_feature(
 
     feature = run_api_call(_create())
     if not json_mode:
-        print_success(f"Draft feature created: {feature.id}")
+        print_success(f"Draft created: {feature.id}")
     output(feature.model_dump(mode="json", by_alias=True), json_mode=json_mode)
 
 
@@ -114,4 +115,7 @@ def delete_draft_feature(
     if json_mode:
         output(feature.model_dump(mode="json", by_alias=True), json_mode=True)
     else:
-        print_success(f"Draft feature abandoned: {feature.id} (status: {feature.status.value})")
+        print_success(f"Draft abandoned: {feature.id} (status: {feature.status.value})")
+
+
+legacy_app = deprecated_alias(app, old_name="df")

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/draft_feature_apply.py

@@ -1,4 +1,4 @@
-"""`minitest df apply` — post a changeset file to a branch."""
+"""`minitest draft apply` — post a changeset file to a branch."""
 
 from pathlib import Path
 from typing import Annotated

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/draft_feature_conflicts.py

@@ -1,4 +1,4 @@
-"""Rendering for `minitest df show --view conflicts`.
+"""Rendering for `minitest draft show --view conflicts`.
 
 The three sides of a conflict are whole story tuples, so printing them as three
 JSON blobs in a table makes the one thing a resolver needs — which key is in

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/draft_feature_helpers.py

@@ -59,7 +59,9 @@ def handle_response_error(resp: httpx.Response, *, resource: str = "Draft featur
     if resp.status_code == 409:
         detail = extract_detail(resp)
         print_error(detail or f"{resource} changed since it was read.")
-        print_info("Re-run `df show --view diff`, rebuild against the mainRev it returns, retry.")
+        print_info(
+            "Re-run `draft show --view diff`, rebuild against the mainRev it returns, retry."
+        )
         raise typer.Exit(code=EXIT_CONFLICT)
     if resp.status_code >= 400:
         detail = extract_detail(resp)

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/draft_feature_show.py

@@ -1,4 +1,4 @@
-"""`minitest df show` — read a branch as a diff, as the suite it would run, or as its conflicts."""
+"""`minitest draft show` — read a branch as a diff, as the suite it runs, or as its conflicts."""
 
 from enum import StrEnum
 from typing import Annotated

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/flow_types_write.py

@@ -48,7 +48,7 @@ def create_flow_type(
     color: Annotated[str, typer.Option("--color", help="Tailwind color name.")] = "gray",
     usage_prompt: UsagePromptOption = None,
 ) -> None:
-    """Create a custom flow type, usable as --type on any user-story command.
+    """Create a custom flow type, usable as --type on any scenario command.
 
     Custom types are tenant-scoped: every app on your tenant can use them.
     """

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/issues.py

@@ -1,4 +1,4 @@
-"""Commands for reading app findings, their fix prompts, and closing them."""
+"""Commands for reading app issues, their fix prompts, and closing them."""
 
 from enum import StrEnum
 from typing import Annotated
@@ -23,27 +23,29 @@ class IssueCriticality(StrEnum):
 
 
 app = typer.Typer(
-    name="issues", help="Read app findings, fix prompts, and mark them fixed.", no_args_is_help=True
+    name="issues", help="Read app issues, fix prompts, and mark them fixed.", no_args_is_help=True
 )
 app.command()(fix)
 
 
 @app.command("list")
 def list_issues(
-    issue: Annotated[str | None, typer.Option("--issue", help="Scope to one failure ID.")] = None,
-    run: Annotated[str | None, typer.Option("--run", help="Scope to one story run ID.")] = None,
-    batch: Annotated[str | None, typer.Option("--batch", help="Scope to one batch ID.")] = None,
+    issue: Annotated[str | None, typer.Option("--issue", help="Scope to one issue ID.")] = None,
+    run: Annotated[str | None, typer.Option("--run", help="Scope to one scenario run ID.")] = None,
+    batch: Annotated[
+        str | None, typer.Option("--batch", help="Scope to one run (batch) ID.")
+    ] = None,
     platform: Annotated[
         IssuePlatform | None, typer.Option(help="Filter by execution platform.")
     ] = None,
     criticality: Annotated[
-        IssueCriticality | None, typer.Option(help="Filter by finding criticality.")
+        IssueCriticality | None, typer.Option(help="Filter by issue criticality.")
     ] = None,
     include_resolved: Annotated[
-        bool, typer.Option("--include-resolved", help="Include resolved findings.")
+        bool, typer.Option("--include-resolved", help="Include resolved issues.")
     ] = False,
 ) -> None:
-    """Return scoped findings, build provenance, fix prompts, and deeplinks as JSON."""
+    """Return scoped issues, build provenance, fix prompts, and deeplinks as JSON."""
     scopes = {"issue": issue, "run": run, "batch": batch}
     selected = [(kind, value) for kind, value in scopes.items() if value is not None]
     if len(selected) > 1:

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/issues_fix.py

@@ -74,7 +74,7 @@ def fix(
         typer.Argument(help="One or more app-failure IDs to mark as fixed."),
     ],
 ) -> None:
-    """Mark findings as fixed, reporting one result per ID."""
+    """Mark issues as fixed, reporting one result per ID."""
     settings, app_id, _ = resolve_app()
     results, exit_codes = run_api_call(_fix_issues(settings, app_id, issue_ids))
     fixed = sum(result["status"] == "fixed" for result in results)

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/issues_helpers.py

@@ -122,7 +122,7 @@ async def _reject_batch_id_passed_as_run(client: ApiClient, app_id: str, given_i
     """
     if await fetch_optional_batch(client, app_id, given_id) is None:
         return
-    print_error(f"Run not found: {given_id} is a batch id, not a story-run id.")
+    print_error(f"Run not found: {given_id} is a batch id, not a scenario-run id.")
     err_console.print("  [dim]The webapp path[/dim] /test/runs/<id> [dim]carries a batch id.[/dim]")
     err_console.print(f"  [yellow]Try:[/yellow] [bold]--batch {given_id}[/bold]")
     raise typer.Exit(code=EXIT_NOT_FOUND)

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/maintenance.py

@@ -1,4 +1,4 @@
-"""`minitest maintenance` — keep test flows in sync with local app code, no GitHub.
+"""`minitest maintenance` — keep scenarios in sync with local app code, no GitHub.
 
 The customer's own coding agent runs the reasoning locally against their checkout;
 only the proposed criteria edits and an opaque commit sha reach Minitest. The maintenance
@@ -41,7 +41,7 @@ from minitest_cli.utils.output import (
 
 app = typer.Typer(
     name="maintenance",
-    help="Maintain test flows against local app code (CLI-only, no GitHub).",
+    help="Keep scenarios in sync with local app code (CLI-only, no GitHub).",
 )
 register_callback_commands(app)
 
@@ -69,7 +69,7 @@ def maintenance(
 
 @app.command()
 def context() -> None:
-    """Open a maintenance run and emit its context (mode, fromSha, stories) as JSON.
+    """Open a maintenance run and emit its context (mode, fromSha, scenarios) as JSON.
 
     First run for an app has no watermark → audit mode (review the whole suite). Later runs
     return the previous sha so the agent diffs `git diff <fromSha>..HEAD` locally.

{minitest_cli-0.32.0 → minitest_cli-0.34.0}/src/minitest_cli/commands/maintenance_callbacks.py

@@ -19,7 +19,7 @@ def register_callback_commands(app: typer.Typer) -> None:
     def affected(
         file: Annotated[Path, typer.Option("--file", help="JSON file: {stories:[...]}.")],
     ) -> None:
-        """Declare which stories the change affects (idempotent per run)."""
+        """Declare which scenarios the change affects (idempotent per run)."""
         _post_file(file, sub_path="affected-stories")
 
     @app.command()