minitest-cli 0.4.4__tar.gz → 0.4.5__tar.gz

{minitest_cli-0.4.4 → minitest_cli-0.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minitest-cli
-Version: 0.4.4
+Version: 0.4.5
 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
@@ -37,24 +37,30 @@ Command-line interface for the Minitest testing platform.
 
 ## Installation
 
-### pip (recommended)
+### curl (recommended)
 
 ```bash
-pip install minitest-cli
+curl -fsSL https://raw.githubusercontent.com/minitap-ai/minitest-cli/main/install.sh | bash
 ```
 
-### uvx (zero-install)
+### Homebrew
 
-Run without installing:
+```bash
+brew install minitap-ai/tap/minitest-cli
+```
+
+### pip
 
 ```bash
-uvx --from minitest-cli minitest --help
+python3 -m pip install --user minitest-cli
 ```
 
-### Homebrew
+### uvx (zero-install)
+
+Run without installing:
 
 ```bash
-brew install minitap-ai/tap/minitest-cli
+uvx --from minitest-cli minitest --help
 ```
 
 ### From source
@@ -81,40 +87,40 @@ 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`   | API base URL             | No (defaults to production)        |
 
 ## Global Flags
 
-| Flag | Description |
-|------|-------------|
-| `--json` | Output JSON to stdout (diagnostics go to stderr) |
-| `--app <id-or-name>` | Target app for commands that require one |
-| `--version` | Show CLI version |
-| `--help` | Show help |
+| Flag                 | Description                                      |
+| -------------------- | ------------------------------------------------ |
+| `--json`             | Output JSON to stdout (diagnostics go to stderr) |
+| `--app <id-or-name>` | Target app for commands that require one         |
+| `--version`          | Show CLI version                                 |
+| `--help`             | Show help                                        |
 
 ## Commands
 
-| Command | Description |
-|---------|-------------|
-| `minitest auth` | Authentication management |
-| `minitest apps` | App management |
-| `minitest flow` | Testing flow operations |
-| `minitest build` | Build management |
-| `minitest run` | Test execution |
+| Command          | Description               |
+| ---------------- | ------------------------- |
+| `minitest auth`  | Authentication management |
+| `minitest apps`  | App management            |
+| `minitest flow`  | Testing flow operations   |
+| `minitest build` | Build management          |
+| `minitest run`   | Test execution            |
 
 ## Exit Codes
 
-| Code | Meaning |
-|------|---------|
-| 0 | Success |
-| 1 | General error |
-| 2 | Authentication error |
-| 3 | Network / API error |
-| 4 | Resource not found |
+| Code | Meaning              |
+| ---- | -------------------- |
+| 0    | Success              |
+| 1    | General error        |
+| 2    | Authentication error |
+| 3    | Network / API error  |
+| 4    | Resource not found   |
 
 ## Using the Dev Environment
 

{minitest_cli-0.4.4 → minitest_cli-0.4.5}/README.md

@@ -4,24 +4,30 @@ Command-line interface for the Minitest testing platform.
 
 ## Installation
 
-### pip (recommended)
+### curl (recommended)
 
 ```bash
-pip install minitest-cli
+curl -fsSL https://raw.githubusercontent.com/minitap-ai/minitest-cli/main/install.sh | bash
 ```
 
-### uvx (zero-install)
+### Homebrew
 
-Run without installing:
+```bash
+brew install minitap-ai/tap/minitest-cli
+```
+
+### pip
 
 ```bash
-uvx --from minitest-cli minitest --help
+python3 -m pip install --user minitest-cli
 ```
 
-### Homebrew
+### uvx (zero-install)
+
+Run without installing:
 
 ```bash
-brew install minitap-ai/tap/minitest-cli
+uvx --from minitest-cli minitest --help
 ```
 
 ### From source
@@ -48,40 +54,40 @@ 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`   | API base URL             | No (defaults to production)        |
 
 ## Global Flags
 
-| Flag | Description |
-|------|-------------|
-| `--json` | Output JSON to stdout (diagnostics go to stderr) |
-| `--app <id-or-name>` | Target app for commands that require one |
-| `--version` | Show CLI version |
-| `--help` | Show help |
+| Flag                 | Description                                      |
+| -------------------- | ------------------------------------------------ |
+| `--json`             | Output JSON to stdout (diagnostics go to stderr) |
+| `--app <id-or-name>` | Target app for commands that require one         |
+| `--version`          | Show CLI version                                 |
+| `--help`             | Show help                                        |
 
 ## Commands
 
-| Command | Description |
-|---------|-------------|
-| `minitest auth` | Authentication management |
-| `minitest apps` | App management |
-| `minitest flow` | Testing flow operations |
-| `minitest build` | Build management |
-| `minitest run` | Test execution |
+| Command          | Description               |
+| ---------------- | ------------------------- |
+| `minitest auth`  | Authentication management |
+| `minitest apps`  | App management            |
+| `minitest flow`  | Testing flow operations   |
+| `minitest build` | Build management          |
+| `minitest run`   | Test execution            |
 
 ## Exit Codes
 
-| Code | Meaning |
-|------|---------|
-| 0 | Success |
-| 1 | General error |
-| 2 | Authentication error |
-| 3 | Network / API error |
-| 4 | Resource not found |
+| Code | Meaning              |
+| ---- | -------------------- |
+| 0    | Success              |
+| 1    | General error        |
+| 2    | Authentication error |
+| 3    | Network / API error  |
+| 4    | Resource not found   |
 
 ## Using the Dev Environment
 

minitest_cli-0.4.5/install.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# install.sh — Install minitest-cli (brew → pipx → python3 -m pip fallback)
+#
+# Usage:
+#   curl -fsSL https://raw.githubusercontent.com/minitap-ai/minitest-cli/main/install.sh | bash
+#
+set -euo pipefail
+
+PACKAGE="minitest-cli"
+BREW_TAP="minitap-ai/tap/minitest-cli"
+INSTALLED_VIA=""
+
+info()  { printf '\033[1;34m==>\033[0m %s\n' "$*"; }
+warn()  { printf '\033[1;33mWarning:\033[0m %s\n' "$*"; }
+error() { printf '\033[1;31mError:\033[0m %s\n' "$*" >&2; }
+
+# -------------------------------------------------------------------
+# 1. Try installers in order: brew → pipx → python3 -m pip
+#    Each attempt is conditional — failure falls through to the next.
+# -------------------------------------------------------------------
+if command -v brew &>/dev/null; then
+  info "Installing $PACKAGE with Homebrew…"
+  if brew install "$BREW_TAP"; then
+    INSTALLED_VIA="brew"
+  else
+    warn "Homebrew install failed — trying next method."
+  fi
+fi
+
+if [[ -z "$INSTALLED_VIA" ]] && command -v pipx &>/dev/null; then
+  info "Installing $PACKAGE with pipx…"
+  if pipx install "$PACKAGE" --force; then
+    INSTALLED_VIA="pipx"
+  else
+    warn "pipx install failed — trying next method."
+  fi
+fi
+
+if [[ -z "$INSTALLED_VIA" ]] && command -v python3 &>/dev/null; then
+  info "Installing $PACKAGE with python3 -m pip…"
+  if python3 -m pip install --user "$PACKAGE"; then
+    INSTALLED_VIA="pip"
+  else
+    warn "pip install failed."
+  fi
+fi
+
+if [[ -z "$INSTALLED_VIA" ]]; then
+  error "All install methods failed or no supported package manager found."
+  error "  macOS:  Install Homebrew → https://brew.sh"
+  error "  Linux:  sudo apt install pipx && pipx ensurepath"
+  exit 1
+fi
+
+# -------------------------------------------------------------------
+# 2. Verify installation
+# -------------------------------------------------------------------
+if command -v minitest &>/dev/null; then
+  info "minitest-cli installed successfully via $INSTALLED_VIA! 🎉"
+  minitest --version
+  echo ""
+  info "Next steps:"
+  echo "  minitest auth login       # authenticate"
+  echo "  minitest apps list        # list your apps"
+  echo "  minitest --help           # see all commands"
+else
+  warn "Installation completed, but 'minitest' is not on your PATH."
+  if [[ "$INSTALLED_VIA" == "brew" ]]; then
+    warn "Try restarting your shell or check: brew --prefix"
+  else
+    warn "You may need to restart your shell or add ~/.local/bin to your PATH."
+  fi
+fi

{minitest_cli-0.4.4 → minitest_cli-0.4.5}/pyproject.toml

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

{minitest_cli-0.4.4 → minitest_cli-0.4.5}/src/minitest_cli/commands/auth.py

@@ -1,5 +1,7 @@
 """Authentication commands: login, logout, status."""
 
+import json
+import subprocess
 from datetime import UTC, datetime
 
 import typer
@@ -13,10 +15,37 @@ from minitest_cli.core.auth import (
     oauth_pkce_login,
 )
 from minitest_cli.core.config import Settings
-from minitest_cli.utils.output import output, print_error, print_success
+from minitest_cli.utils.output import output, print_error, print_info, print_success
 
 app = typer.Typer(name="auth", help="Authentication management.")
 
+SKILL_NAME = "minitest-cli"
+SKILL_INSTALL_CMD = "npx skills add minitap-ai/agent-skills --skill minitest-cli"
+
+
+def _is_skill_installed() -> bool:
+    """Check if the minitest-cli skill is installed via ``npx skills ls``.
+
+    Queries both project-level and global scopes so the detection stays in
+    sync with whatever directories the ``skills`` CLI manages.
+    """
+    for flags in (["--json"], ["--json", "-g"]):
+        try:
+            result = subprocess.run(
+                ["npx", "skills", "ls", *flags],
+                capture_output=True,
+                text=True,
+                timeout=30,
+            )
+            if result.returncode == 0:
+                skills = json.loads(result.stdout)
+                if any(s.get("name") == SKILL_NAME for s in skills):
+                    return True
+        except (subprocess.TimeoutExpired, json.JSONDecodeError, FileNotFoundError, OSError):
+            # npx not available or unexpected output – fall through
+            pass
+    return False
+
 
 def _get_settings() -> Settings:
     """Retrieve settings stored by the main callback."""
@@ -40,6 +69,28 @@ def login() -> None:
     creds = oauth_pkce_login(settings)
     print_success(f"Authenticated as {creds.email}")
 
+    # Check if the minitest-cli agent skill is installed
+    if not _is_skill_installed():
+        print_info("")
+        print_info("💡 The minitest-cli agent skill is not installed in this project.")
+        print_info("   Your AI agent needs it to know how to use minitest.")
+        print_info("")
+        try:
+            answer = input("   Install it now? [Y/n] ").strip().lower()
+        except (EOFError, KeyboardInterrupt):
+            answer = "n"
+            print()  # newline after ^C / ^D
+        if answer in ("", "y", "yes"):
+            print_info("")
+            print_info(f"   Running: {SKILL_INSTALL_CMD}")
+            print_info("")
+            subprocess.run(SKILL_INSTALL_CMD.split(), check=False)
+        else:
+            print_info("")
+            print_info("   You can install it later with:")
+            print_info(f"   {SKILL_INSTALL_CMD}")
+            print_info("")
+
 
 @app.command()
 def logout() -> None:

{minitest_cli-0.4.4 → minitest_cli-0.4.5}/src/minitest_cli/core/oauth.py

@@ -1,4 +1,4 @@
-"""OAuth PKCE login flow and token refresh."""
+"""OAuth PKCE login flow via Supabase OAuth2 server, and token refresh."""
 
 from __future__ import annotations
 
@@ -20,9 +20,8 @@ from minitest_cli.core.config import Settings
 from minitest_cli.core.credentials import Credentials
 from minitest_cli.core.token_exchange import (
     auth_error,
-    get_apikey_header,
     parse_and_save_token_response,
-    require_supabase_url,
+    register_oauth_client,
 )
 
 _ASSETS = importlib.resources.files("minitest_cli.assets")
@@ -59,31 +58,24 @@ def refresh_token(settings: Settings, creds: Credentials) -> Credentials | None:
 
 
 def oauth_pkce_login(settings: Settings) -> Credentials:
-    """Run the full OAuth PKCE login flow.
+    """Run the full OAuth PKCE login flow via Supabase's OAuth2 server.
 
     Steps:
-      1. Generate code verifier + challenge
-      2. Start local callback server
-      3. Open browser to Supabase authorize endpoint
-      4. Wait for callback with auth code
-      5. Exchange code for tokens
-      6. Save and return credentials
+      1. Start local callback server
+      2. Dynamically register an OAuth2 client with Supabase
+      3. Generate PKCE code verifier + challenge
+      4. Open browser to Supabase authorize endpoint (shows hosted sign-in page)
+      5. Wait for callback with authorization code
+      6. Exchange code + verifier for tokens at Supabase token endpoint
+      7. Save and return credentials
     """
-    supabase_url = require_supabase_url(settings)
+    supabase_url = settings.supabase_url.rstrip("/")
 
     # PKCE challenge: base64url(sha256(verifier)) without padding
     code_verifier = secrets.token_urlsafe(64)
     digest = hashlib.sha256(code_verifier.encode()).digest()
     code_challenge = base64.urlsafe_b64encode(digest).rstrip(b"=").decode()
 
-    # CSRF protection: We do NOT generate our own state parameter.
-    # Supabase internally uses 'state' as a FlowState UUID (database key) to track
-    # the OAuth flow context (redirect_to, PKCE params, etc.). If we override it,
-    # Supabase can't find the FlowState record and falls back to Site URL.
-    # We still have CSRF protection via:
-    #   1. Supabase's FlowState UUID (validated on callback)
-    #   2. PKCE (code_challenge + code_verifier) per OAuth 2.1
-
     # Start callback server
     auth_code_holder: dict[str, str | None] = {"code": None, "error": None}
     ready_event = Event()
@@ -122,17 +114,21 @@ def oauth_pkce_login(settings: Settings) -> Credentials:
     port = server.server_address[1]
     redirect_uri = f"http://127.0.0.1:{port}/callback"
 
-    # Build authorize URL (no custom state - see comment above)
+    # Register OAuth client with Supabase (dynamic client registration)
+    client_id = register_oauth_client(supabase_url, redirect_uri)
+
+    # Build authorize URL — Supabase's OAuth2 server shows its hosted sign-in page
     authorize_params = urllib.parse.urlencode(
         {
-            "provider": "google",
+            "client_id": client_id,
+            "redirect_uri": redirect_uri,
             "response_type": "code",
             "code_challenge": code_challenge,
             "code_challenge_method": "S256",
-            "redirect_to": redirect_uri,
+            "scope": "openid email profile",
         }
     )
-    authorize_url = f"{supabase_url}/auth/v1/authorize?{authorize_params}"
+    authorize_url = f"{supabase_url}/auth/v1/oauth/authorize?{authorize_params}"
 
     print("Opening browser for authentication...", file=sys.stderr)  # noqa: T201
     print(f"If the browser doesn't open, visit:\n{authorize_url}", file=sys.stderr)  # noqa: T201
@@ -156,16 +152,19 @@ def oauth_pkce_login(settings: Settings) -> Credentials:
     if not auth_code:
         auth_error("No authorization code received.")
 
-    # Exchange code for tokens (Supabase uses grant_type=pkce for PKCE flow)
+    # Exchange code for tokens at Supabase's OAuth2 token endpoint
     assert auth_code is not None  # for type narrowing
     try:
         token_response = httpx.post(
-            f"{supabase_url}/auth/v1/token?grant_type=pkce",
-            json={
-                "auth_code": auth_code,
+            f"{supabase_url}/auth/v1/oauth/token",
+            data={
+                "grant_type": "authorization_code",
+                "code": auth_code,
+                "redirect_uri": redirect_uri,
+                "client_id": client_id,
                 "code_verifier": code_verifier,
             },
-            headers={"Content-Type": "application/json", "apikey": get_apikey_header(settings)},
+            headers={"Content-Type": "application/x-www-form-urlencoded"},
             timeout=15.0,
         )
     except httpx.HTTPError as exc:

{minitest_cli-0.4.4 → minitest_cli-0.4.5}/src/minitest_cli/core/token_exchange.py

@@ -6,6 +6,8 @@ import sys
 import time
 from typing import Any, NoReturn
 
+import httpx
+
 from minitest_cli.core.config import Settings
 from minitest_cli.core.credentials import Credentials, save_credentials
 
@@ -51,6 +53,42 @@ def parse_and_save_token_response(settings: Settings, data: dict[str, Any]) -> C
         return None
 
 
+def register_oauth_client(supabase_url: str, redirect_uri: str) -> str:
+    """Dynamically register an OAuth2 client with Supabase and return the client_id."""
+    register_url = f"{supabase_url}/auth/v1/oauth/clients/register"
+    try:
+        resp = httpx.post(
+            register_url,
+            json={
+                "client_name": "minitest-cli",
+                "redirect_uris": [redirect_uri],
+                "grant_types": ["authorization_code", "refresh_token"],
+                "response_types": ["code"],
+                "token_endpoint_auth_method": "none",
+            },
+            headers={"Content-Type": "application/json"},
+            timeout=15.0,
+        )
+    except httpx.HTTPError as exc:
+        auth_error(f"Failed to register OAuth client: {exc}")
+
+    if resp.status_code not in (200, 201):
+        auth_error(f"OAuth client registration failed: {resp.text}")
+
+    try:
+        data = resp.json()
+    except ValueError:
+        auth_error(
+            f"OAuth client registration returned invalid response "
+            f"(HTTP {resp.status_code}): {resp.text}"
+        )
+
+    client_id: str | None = data.get("client_id")
+    if not client_id:
+        auth_error("OAuth client registration returned no client_id.")
+    return client_id  # type: ignore[return-value]
+
+
 def auth_error(message: str) -> NoReturn:
     """Print auth error to stderr and exit with code 2."""
     print(f"Error: {message}", file=sys.stderr)  # noqa: T201

{minitest_cli-0.4.4 → minitest_cli-0.4.5}/uv.lock

@@ -141,7 +141,7 @@ wheels = [
 
 [[package]]
 name = "minitest-cli"
-version = "0.4.3"
+version = "0.4.5"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },