minitest-cli 0.7.0__tar.gz → 0.8.0__tar.gz

{minitest_cli-0.7.0 → minitest_cli-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minitest-cli
-Version: 0.7.0
+Version: 0.8.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
@@ -91,17 +91,22 @@ minitest auth login
 # List your apps
 minitest apps list
 
+# Create a new app on your tenant
+minitest apps create --name "My App"
+
 # Run tests
 minitest run --app <app-id>
 ```
 
 ## Configuration
 
-| Environment Variable | Description              | Required                           |
-| -------------------- | ------------------------ | ---------------------------------- |
-| `MINITEST_TOKEN`     | API authentication token | Yes (or use `minitest auth login`) |
-| `MINITEST_APP_ID`    | Default app ID           | No (can use `--app` flag)          |
-| `MINITEST_API_URL`   | API base URL             | No (defaults to production)        |
+| Environment Variable          | Description                                                | Required                           |
+| ----------------------------- | ---------------------------------------------------------- | ---------------------------------- |
+| `MINITEST_TOKEN`              | API authentication token                                   | Yes (or use `minitest auth login`) |
+| `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_INTEGRATIONS_URL`   | minihands-integrations base URL (used to list tenants)     | No (defaults to production)        |
 
 ## Global Flags
 
@@ -140,6 +145,8 @@ To point the CLI at the **dev** environment instead of production, set these env
 MINITEST_SUPABASE_URL=https://qrezuucghnmfvaxghqsv.supabase.co \
 MINITEST_SUPABASE_PUBLISHABLE_KEY=sb_publishable_4JRhoCm8pa5PbII0dhS09A_jhpkQhmy \
 MINITEST_API_URL=https://testing-service.dev.minitap.ai \
+MINITEST_APPS_MANAGER_URL=https://apps-manager.dev.minitap.ai \
+MINITEST_INTEGRATIONS_URL=https://integrations.dev.minitap.ai \
 minitest auth login
 ```
 
@@ -149,6 +156,8 @@ This authenticates against the dev environment and stores a dev-specific auth to
 MINITEST_SUPABASE_URL=https://qrezuucghnmfvaxghqsv.supabase.co \
 MINITEST_SUPABASE_PUBLISHABLE_KEY=sb_publishable_4JRhoCm8pa5PbII0dhS09A_jhpkQhmy \
 MINITEST_API_URL=https://testing-service.dev.minitap.ai \
+MINITEST_APPS_MANAGER_URL=https://apps-manager.dev.minitap.ai \
+MINITEST_INTEGRATIONS_URL=https://integrations.dev.minitap.ai \
 minitest apps list
 ```
 

{minitest_cli-0.7.0 → minitest_cli-0.8.0}/README.md

@@ -58,17 +58,22 @@ minitest auth login
 # List your apps
 minitest apps list
 
+# Create a new app on your tenant
+minitest apps create --name "My App"
+
 # Run tests
 minitest run --app <app-id>
 ```
 
 ## Configuration
 
-| Environment Variable | Description              | Required                           |
-| -------------------- | ------------------------ | ---------------------------------- |
-| `MINITEST_TOKEN`     | API authentication token | Yes (or use `minitest auth login`) |
-| `MINITEST_APP_ID`    | Default app ID           | No (can use `--app` flag)          |
-| `MINITEST_API_URL`   | API base URL             | No (defaults to production)        |
+| Environment Variable          | Description                                                | Required                           |
+| ----------------------------- | ---------------------------------------------------------- | ---------------------------------- |
+| `MINITEST_TOKEN`              | API authentication token                                   | Yes (or use `minitest auth login`) |
+| `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_INTEGRATIONS_URL`   | minihands-integrations base URL (used to list tenants)     | No (defaults to production)        |
 
 ## Global Flags
 
@@ -107,6 +112,8 @@ To point the CLI at the **dev** environment instead of production, set these env
 MINITEST_SUPABASE_URL=https://qrezuucghnmfvaxghqsv.supabase.co \
 MINITEST_SUPABASE_PUBLISHABLE_KEY=sb_publishable_4JRhoCm8pa5PbII0dhS09A_jhpkQhmy \
 MINITEST_API_URL=https://testing-service.dev.minitap.ai \
+MINITEST_APPS_MANAGER_URL=https://apps-manager.dev.minitap.ai \
+MINITEST_INTEGRATIONS_URL=https://integrations.dev.minitap.ai \
 minitest auth login
 ```
 
@@ -116,6 +123,8 @@ This authenticates against the dev environment and stores a dev-specific auth to
 MINITEST_SUPABASE_URL=https://qrezuucghnmfvaxghqsv.supabase.co \
 MINITEST_SUPABASE_PUBLISHABLE_KEY=sb_publishable_4JRhoCm8pa5PbII0dhS09A_jhpkQhmy \
 MINITEST_API_URL=https://testing-service.dev.minitap.ai \
+MINITEST_APPS_MANAGER_URL=https://apps-manager.dev.minitap.ai \
+MINITEST_INTEGRATIONS_URL=https://integrations.dev.minitap.ai \
 minitest apps list
 ```
 

{minitest_cli-0.7.0 → minitest_cli-0.8.0}/pyproject.toml

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

minitest_cli-0.8.0/src/minitest_cli/api/apps_manager_client.py

@@ -0,0 +1,89 @@
+"""Async HTTP client for the apps-manager service.
+
+Mirrors the shape of :class:`minitest_cli.api.client.ApiClient` but targets a
+different base URL (``MINITEST_APPS_MANAGER_URL``). Reuses the same Supabase
+JWT auth flow.
+"""
+
+from typing import Any
+
+import httpx
+
+from minitest_cli.core.auth import load_token
+from minitest_cli.core.config import Settings
+
+CHANNEL_HEADER = "X-Minitest-Channel"
+CHANNEL_VALUE = "cli"
+DEFAULT_TIMEOUT = 30.0
+UPLOAD_TIMEOUT = 300.0  # 5 minutes for large file uploads
+
+
+class AppsManagerClient:
+    """Wraps httpx.AsyncClient pointed at the apps-manager service.
+
+    Auth and channel headers are auto-injected just like
+    :class:`minitest_cli.api.client.ApiClient`.
+
+    Usage::
+
+        async with AppsManagerClient(settings) as client:
+            response = await client.post("/api/v1/tenants/<id>/apps", data=...)
+    """
+
+    def __init__(self, settings: Settings) -> None:
+        self._settings = settings
+        self._client: httpx.AsyncClient | None = None
+
+    async def __aenter__(self) -> "AppsManagerClient":
+        token = load_token(self._settings)
+        self._client = httpx.AsyncClient(
+            base_url=self._settings.apps_manager_url,
+            headers={
+                "Authorization": f"Bearer {token}",
+                CHANNEL_HEADER: CHANNEL_VALUE,
+            },
+            timeout=DEFAULT_TIMEOUT,
+        )
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: object,
+    ) -> None:
+        if self._client:
+            await self._client.aclose()
+
+    def _ensure_client(self) -> httpx.AsyncClient:
+        if self._client is None:
+            msg = "AppsManagerClient must be used as an async context manager"
+            raise RuntimeError(msg)
+        return self._client
+
+    async def get(self, path: str, **kwargs: Any) -> httpx.Response:
+        """Send a GET request."""
+        return await self._ensure_client().get(path, **kwargs)
+
+    async def post(self, path: str, **kwargs: Any) -> httpx.Response:
+        """Send a POST request."""
+        return await self._ensure_client().post(path, **kwargs)
+
+    async def upload_form(
+        self,
+        path: str,
+        *,
+        data: dict[str, str] | None = None,
+        files: dict[str, Any] | None = None,
+        timeout: float = UPLOAD_TIMEOUT,
+        **kwargs: Any,
+    ) -> httpx.Response:
+        """Send a POST request with multipart form data and extended timeout."""
+        client = self._ensure_client()
+        return await client.post(
+            path,
+            data=data or {},
+            files=files or {},
+            timeout=timeout,
+            **kwargs,
+        )

{minitest_cli-0.7.0 → minitest_cli-0.8.0}/src/minitest_cli/api/client.py

@@ -61,6 +61,10 @@ class ApiClient:
         """Send a POST request."""
         return await self._ensure_client().post(path, **kwargs)
 
+    async def put(self, path: str, **kwargs: Any) -> httpx.Response:
+        """Send a PUT request."""
+        return await self._ensure_client().put(path, **kwargs)
+
     async def patch(self, path: str, **kwargs: Any) -> httpx.Response:
         """Send a PATCH request."""
         return await self._ensure_client().patch(path, **kwargs)

minitest_cli-0.8.0/src/minitest_cli/commands/app_knowledge.py

@@ -0,0 +1,145 @@
+"""App-knowledge commands: get and update an app's AppKnowledge prompt.
+
+- ``get`` reads from ``GET /api/v1/apps/{app_id}/test-config`` and extracts the
+  ``app_knowledge`` field. testing-service has no dedicated GET endpoint for
+  app knowledge alone — the test-config response carries the latest version.
+- ``update`` calls ``PUT /api/v1/apps/{app_id}/app-knowledge`` with body
+  ``{"content": "..."}`` and returns the new ``version_number``.
+"""
+
+from pathlib import Path
+from typing import Annotated, Any
+
+import typer
+
+from minitest_cli.commands.app_knowledge_helpers import (
+    fetch_app_knowledge,
+    update_app_knowledge,
+)
+from minitest_cli.core.auth import require_auth
+from minitest_cli.core.config import Settings
+from minitest_cli.utils.output import (
+    print_error,
+    print_info,
+    print_json,
+    print_success,
+)
+
+app = typer.Typer(name="app-knowledge", help="Read and update an app's AppKnowledge.")
+
+
+@app.callback()
+def _callback() -> None:
+    """App-knowledge operations."""
+
+
+def _get_settings() -> Settings:
+    return typer.Context.settings  # type: ignore[attr-defined]
+
+
+def _is_json_mode() -> bool:
+    return typer.Context.json_mode  # type: ignore[attr-defined]
+
+
+@app.command(name="get")
+def get_app_knowledge(
+    app_id: Annotated[
+        str,
+        typer.Option(
+            "--app",
+            help="App ID to read AppKnowledge for. Required.",
+        ),
+    ],
+) -> None:
+    """Read the current AppKnowledge content for an app.
+
+    Without ``--json``, prints the markdown content to stdout. With ``--json``,
+    prints the full record (including ``versionNumber`` if available).
+    """
+    settings = _get_settings()
+    json_mode = _is_json_mode()
+    require_auth(settings)
+
+    record = fetch_app_knowledge(settings, app_id)
+
+    if json_mode:
+        print_json(record)
+        return
+
+    content = record.get("content")
+    if not content:
+        print_info("No AppKnowledge content set for this app.")
+        return
+    print(content)  # noqa: T201
+
+
+@app.command(name="update")
+def update_app_knowledge_command(
+    app_id: Annotated[
+        str,
+        typer.Option(
+            "--app",
+            help="App ID to update AppKnowledge for. Required.",
+        ),
+    ],
+    content: Annotated[
+        str | None,
+        typer.Option(
+            "--content",
+            help="New AppKnowledge markdown content (inline string).",
+        ),
+    ] = None,
+    content_file: Annotated[
+        Path | None,
+        typer.Option(
+            "--content-file",
+            help="Path to a file whose contents become the new AppKnowledge.",
+            exists=True,
+            readable=True,
+            dir_okay=False,
+        ),
+    ] = None,
+) -> None:
+    """Create a new version of the AppKnowledge prompt for an app.
+
+    Either ``--content`` or ``--content-file`` must be provided (not both).
+    Prints the new version number to stdout. With ``--json``, prints the full
+    response record.
+    """
+    settings = _get_settings()
+    json_mode = _is_json_mode()
+    require_auth(settings)
+
+    body = _resolve_content(content, content_file)
+    record: dict[str, Any] = update_app_knowledge(settings, app_id, body)
+
+    if json_mode:
+        print_json(record)
+        return
+
+    version_number = record.get("versionNumber") or record.get("version_number")
+    if version_number is None:
+        print_error("Backend response did not include a version number.")
+        raise typer.Exit(code=1)
+    print_success(f"AppKnowledge updated (version {version_number}).")
+    print(version_number)  # noqa: T201
+
+
+def _resolve_content(content: str | None, content_file: Path | None) -> str:
+    if content is None and content_file is None:
+        print_error("Provide --content or --content-file.")
+        raise typer.Exit(code=1)
+    if content is not None and content_file is not None:
+        print_error("Use either --content or --content-file, not both.")
+        raise typer.Exit(code=1)
+    if content is not None:
+        if content == "":
+            print_error("--content must not be empty.")
+            raise typer.Exit(code=1)
+        return content
+    assert content_file is not None  # noqa: S101  for type checkers
+    text = content_file.read_text(encoding="utf-8")
+    if not text:
+        print_error(f"--content-file is empty: {content_file}")
+        raise typer.Exit(code=1)
+    return text

minitest_cli-0.8.0/src/minitest_cli/commands/app_knowledge_helpers.py

@@ -0,0 +1,99 @@
+"""Helpers for app-knowledge commands: error mapping and HTTP calls."""
+
+from __future__ import annotations
+
+import asyncio
+from collections.abc import Coroutine
+from typing import Any
+
+import httpx
+import typer
+
+from minitest_cli.api.client import ApiClient
+from minitest_cli.core.config import Settings
+from minitest_cli.utils.output import print_error
+
+EXIT_GENERAL_ERROR = 1
+EXIT_NETWORK_ERROR = 3
+EXIT_NOT_FOUND = 4
+
+
+def _extract_detail(resp: httpx.Response) -> str:
+    try:
+        body = resp.json()
+        if isinstance(body, dict):
+            detail = body.get("detail") or body.get("message")
+            if detail:
+                return str(detail)
+    except Exception:  # noqa: BLE001
+        pass
+    return resp.text or f"HTTP {resp.status_code}"
+
+
+def _handle_response_error(resp: httpx.Response, *, resource: str = "App") -> None:
+    if resp.status_code < 400:
+        return
+    detail = _extract_detail(resp)
+    if resp.status_code == 404:
+        print_error(f"{resource} not found: {detail}")
+        raise typer.Exit(code=EXIT_NOT_FOUND)
+    if resp.status_code in (401, 403):
+        print_error(f"Authentication failed ({resp.status_code}): {detail}")
+        raise typer.Exit(code=EXIT_GENERAL_ERROR)
+    if 400 <= resp.status_code < 500:
+        print_error(f"Validation error ({resp.status_code}): {detail}")
+        raise typer.Exit(code=EXIT_GENERAL_ERROR)
+    print_error(f"Backend error ({resp.status_code}): {detail}")
+    raise typer.Exit(code=EXIT_NETWORK_ERROR)
+
+
+def _run_api_call[T](coro: Coroutine[Any, Any, T]) -> T:
+    try:
+        return asyncio.run(coro)
+    except httpx.HTTPError as exc:
+        print_error(f"Network error: {exc}")
+        raise typer.Exit(code=EXIT_NETWORK_ERROR) from exc
+
+
+def fetch_app_knowledge(settings: Settings, app_id: str) -> dict[str, Any]:
+    """Read the current AppKnowledge for an app.
+
+    testing-service has no dedicated GET endpoint, so we read the test-config
+    record (which carries the latest ``app_knowledge`` content) and surface a
+    minimal ``{appId, content}`` shape for callers.
+    """
+
+    async def _run() -> dict[str, Any]:
+        async with ApiClient(settings) as client:
+            resp = await client.get(f"/api/v1/apps/{app_id}/test-config")
+            _handle_response_error(resp)
+            payload = resp.json()
+            content: Any = None
+            if isinstance(payload, dict):
+                content = payload.get("appKnowledge") or payload.get("app_knowledge")
+            return {"appId": app_id, "content": content}
+
+    return _run_api_call(_run())
+
+
+def update_app_knowledge(settings: Settings, app_id: str, content: str) -> dict[str, Any]:
+    """Push a new AppKnowledge version for an app.
+
+    Calls ``PUT /api/v1/apps/{app_id}/app-knowledge`` with body
+    ``{"content": ...}`` and returns the parsed response.
+    """
+
+    async def _run() -> dict[str, Any]:
+        async with ApiClient(settings) as client:
+            resp = await client.put(
+                f"/api/v1/apps/{app_id}/app-knowledge",
+                json={"content": content},
+            )
+            _handle_response_error(resp)
+            data = resp.json()
+            if not isinstance(data, dict):
+                print_error("Unexpected response shape from update endpoint.")
+                raise typer.Exit(code=EXIT_NETWORK_ERROR)
+            return data
+
+    return _run_api_call(_run())

minitest_cli-0.8.0/src/minitest_cli/commands/apps.py

@@ -0,0 +1,174 @@
+"""App management commands: list, create."""
+
+import asyncio
+from pathlib import Path
+from typing import Annotated
+
+import httpx
+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.commands.apps_helpers import create_app_request
+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
+from minitest_cli.models.app import AppDetailResponse, AppListResponse
+from minitest_cli.utils.output import (
+    err_console,
+    print_error,
+    print_json,
+    print_success,
+    print_table,
+)
+
+EXIT_NETWORK_ERROR = 3
+
+app = typer.Typer(name="apps", help="App management.")
+
+
+@app.callback()
+def _callback() -> None:
+    """App management."""
+
+
+APP_TABLE_HEADERS = ["ID", "Name", "Platform"]
+
+_PLATFORM_LABELS: dict[str, str] = {
+    "android": "Android",
+    "ios": "iOS",
+    "cross_platform": "Cross-platform",
+}
+
+
+def _format_platform(value: str | None) -> str:
+    """Render an AppPlatform value for the table; pass through unknown values."""
+    if value is None:
+        return "—"
+    return _PLATFORM_LABELS.get(value, value)
+
+
+def _get_settings() -> Settings:
+    return typer.Context.settings  # type: ignore[attr-defined]
+
+
+def _is_json_mode() -> bool:
+    return typer.Context.json_mode  # type: ignore[attr-defined]
+
+
+@app.command(name="list")
+def list_apps() -> None:
+    """List all apps."""
+    settings = _get_settings()
+    json_mode = _is_json_mode()
+    require_auth(settings)
+
+    async def _list() -> AppListResponse:
+        async with ApiClient(settings) as client:
+            resp = await client.get("/api/v1/apps")
+            if resp.status_code >= 400:
+                detail = resp.text
+                try:
+                    body = resp.json()
+                    if isinstance(body, dict):
+                        detail = body.get("detail") or body.get("message") or detail
+                except Exception:  # noqa: BLE001
+                    pass
+                print_error(f"API error ({resp.status_code}): {detail}")
+                raise typer.Exit(code=EXIT_NETWORK_ERROR)
+            return AppListResponse.model_validate(resp.json())
+
+    try:
+        data = asyncio.run(_list())
+    except httpx.HTTPError as exc:
+        print_error(f"Network error: {exc}")
+        raise typer.Exit(code=EXIT_NETWORK_ERROR) from exc
+
+    if json_mode:
+        print_json([a.model_dump(mode="json", by_alias=True) for a in data.apps])
+        return
+
+    rows = [[a.id, a.name, _format_platform(a.platform)] for a in data.apps]
+    print_table(APP_TABLE_HEADERS, rows, title="Apps")
+
+
+@app.command(name="create")
+def create_app(
+    name: Annotated[
+        str,
+        typer.Option(
+            "--name",
+            help="Human-readable app name.",
+        ),
+    ],
+    tenant: Annotated[
+        str | None,
+        typer.Option(
+            "--tenant",
+            help=(
+                "Tenant ID to create the app under. Auto-resolved when the user has a "
+                "single tenant; prompts on a TTY otherwise."
+            ),
+        ),
+    ] = None,
+    description: Annotated[
+        str | None,
+        typer.Option("--description", help="Optional description."),
+    ] = None,
+    slug: Annotated[
+        str | None,
+        typer.Option(
+            "--slug",
+            help="URL-friendly slug. Auto-generated from the name if omitted.",
+        ),
+    ] = None,
+    icon: Annotated[
+        Path | None,
+        typer.Option(
+            "--icon",
+            help="Optional path to an icon image to upload.",
+            exists=True,
+            readable=True,
+            dir_okay=False,
+        ),
+    ] = None,
+) -> None:
+    """Create a new app on a tenant.
+
+    Calls ``POST /api/v1/tenants/{tenant_id}/apps`` on apps-manager. Prints the
+    created app's id to stdout; with ``--json``, prints the full record.
+    """
+    settings = _get_settings()
+    json_mode = _is_json_mode()
+    require_auth(settings)
+
+    async def _run() -> AppDetailResponse:
+        if tenant:
+            resolved_tenant_id = tenant
+        else:
+            tenants = await fetch_user_tenants(settings)
+            resolved_tenant_id = resolve_tenant_id(settings, None, tenants)
+            if len(tenants) > 1:
+                err_console.print(f"[dim]Using tenant {resolved_tenant_id}[/dim]")
+
+        return await create_app_request(
+            settings,
+            tenant_id=resolved_tenant_id,
+            name=name,
+            description=description,
+            slug=slug,
+            icon=icon,
+        )
+
+    try:
+        created = asyncio.run(_run())
+    except httpx.HTTPError as exc:
+        print_error(f"Network error: {exc}")
+        raise typer.Exit(code=EXIT_NETWORK_ERROR) from exc
+
+    if json_mode:
+        print_json(created.model_dump(mode="json", by_alias=True))
+        return
+
+    print_success(f"Created app '{created.name}' (slug: {created.slug})")
+    print(created.id)  # noqa: T201