minitest-cli 0.3.0__tar.gz → 0.4.1__tar.gz

minitest_cli-0.4.1/.env.example

@@ -0,0 +1,16 @@
+# Minitest CLI configuration
+# Copy to .env and customize as needed. All values below are optional —
+# sensible defaults are built into the CLI.
+
+# Testing service base URL
+# MINITEST_API_URL=
+
+# Pre-authenticated token (bypasses OAuth login)
+# MINITEST_TOKEN=
+
+# Default app ID for commands that require --app
+# MINITEST_APP_ID=
+
+# Supabase OAuth settings
+# MINITEST_SUPABASE_URL=
+# MINITEST_SUPABASE_PUBLISHABLE_KEY=

minitest_cli-0.4.1/.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI 🧪
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Clone the repository
+        uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Build package
+        run: uv build
+
+  pyright:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+      - name: Install dependencies
+        run: uv sync --dev
+      - name: Run pyright
+        run: uv run pyright
+
+  ruff:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - name: Run ruff format check
+        uses: astral-sh/ruff-action@v3
+        with:
+          args: "format --check"
+      - name: Run ruff linter
+        uses: astral-sh/ruff-action@v3
+        with:
+          args: "check"
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Clone the repository
+        uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Run tests
+        run: uv run pytest

minitest_cli-0.4.1/.github/workflows/release.yml

@@ -0,0 +1,130 @@
+name: Release 🚀
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+permissions: {}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Clone the repository
+        uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Verify tag matches package version
+        run: |
+          python3 - <<'PY'
+          import os, pathlib, sys, tomllib
+          version = tomllib.loads(pathlib.Path("pyproject.toml").read_text())["project"]["version"]
+          tag_version = os.environ["GITHUB_REF_NAME"].removeprefix("v")
+          if version != tag_version:
+              print(f"::error::Tag v{tag_version} does not match pyproject.toml version {version}")
+              sys.exit(1)
+          print(f"Version {version} matches tag")
+          PY
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/minitest-cli/
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Clone the repository
+        uses: actions/checkout@v5
+
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: dist/*
+
+  update-homebrew:
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    steps:
+      - name: Fetch PyPI metadata
+        id: pypi
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
+          echo "Waiting for minitest-cli $VERSION to be available on PyPI..."
+          for i in $(seq 1 30); do
+            if curl -sSf --connect-timeout 5 --max-time 15 \
+              "https://pypi.org/pypi/minitest-cli/$VERSION/json" -o /tmp/pypi.json.tmp; then
+              mv /tmp/pypi.json.tmp /tmp/pypi.json
+              echo "Package is available on PyPI"
+              break
+            fi
+            echo "Attempt $i/30 - not yet available, waiting 10s..."
+            sleep 10
+          done
+
+          if [ ! -f /tmp/pypi.json ]; then
+            echo "::error::Package not found on PyPI after 5 minutes"
+            exit 1
+          fi
+
+          SDIST_URL=$(jq -r '.urls[] | select(.packagetype == "sdist") | .url' /tmp/pypi.json)
+          SDIST_SHA256=$(jq -r '.urls[] | select(.packagetype == "sdist") | .digests.sha256' /tmp/pypi.json)
+          if [ -z "$SDIST_URL" ] || [ "$SDIST_URL" = "null" ] || [ -z "$SDIST_SHA256" ] || [ "$SDIST_SHA256" = "null" ]; then
+            echo "::error::sdist metadata is missing from PyPI response"
+            exit 1
+          fi
+          echo "sdist_url=$SDIST_URL" >> "$GITHUB_OUTPUT"
+          echo "sdist_sha256=$SDIST_SHA256" >> "$GITHUB_OUTPUT"
+
+      - name: Trigger Homebrew tap update
+        uses: peter-evans/repository-dispatch@v3
+        with:
+          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+          repository: minitap-ai/homebrew-tap
+          event-type: update-formula
+          client-payload: |
+            {
+              "formula": "minitest-cli",
+              "version": "${{ steps.pypi.outputs.version }}",
+              "sdist_url": "${{ steps.pypi.outputs.sdist_url }}",
+              "sdist_sha256": "${{ steps.pypi.outputs.sdist_sha256 }}"
+            }

minitest_cli-0.4.1/.gitignore

@@ -0,0 +1,85 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyright
+.pyright/
+
+# Ruff
+.ruff_cache/
+
+# macOS
+.DS_Store
+
+# Opencode (local agent config — keep skills tracked)
+.opencode/*
+!.opencode/skill/

minitest_cli-0.4.1/.opencode/skill/release/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: release
+description: >
+  Release a new version of minitest-cli. Use when the user says "release",
+  "tag a new version", "bump version", "create a release", or "publish".
+  Determines the next semver tag from git history, updates pyproject.toml,
+  syncs the lockfile, commits, tags, and pushes.
+---
+
+# Release minitest-cli
+
+## Process
+
+### 1. Determine the next version
+
+Fetch all existing tags and the commits since the latest tag:
+
+```bash
+git fetch --tags
+git tag -l 'v*' --sort=-v:refname   # find latest tag
+git log <latest-tag>..HEAD --oneline # commits since last release
+```
+
+Apply semver rules to the commit list:
+
+| Condition | Bump |
+|-----------|------|
+| Any commit message **breaks** backward compatibility (`BREAKING CHANGE`, `!:`) | **major** (X.0.0) |
+| At least one `feat:` commit | **minor** (0.X.0) |
+| Only `fix:`, `docs:`, `test:`, `chore:`, `refactor:`, `style:`, `perf:`, `ci:` | **patch** (0.0.X) |
+
+Present the suggested version and commit summary to the user. Wait for confirmation before proceeding.
+
+### 2. Bump version
+
+```bash
+# Edit pyproject.toml version field
+# Then sync lockfile
+uv sync
+```
+
+### 3. Commit, tag, push
+
+```bash
+git add pyproject.toml uv.lock
+git commit -m "release: v<VERSION>"
+git tag v<VERSION>
+git push origin HEAD
+git push origin v<VERSION>
+```
+
+The tag push triggers the release workflow (PyPI publish, GitHub Release, Homebrew tap update).

minitest_cli-0.4.1/AGENTS.md

@@ -0,0 +1,61 @@
+# AGENTS.md - minitest-cli
+
+## Commands
+
+```bash
+uv run minitest --help                             # Show CLI help
+uv run pytest                                      # Run tests
+uv run ruff check .                                # Lint
+uv run ruff format .                               # Format
+uv run pyright                                     # Type check
+uv add <package>                                   # Add new dependency (always use uv add, never edit pyproject.toml manually)
+```
+
+## Project Structure
+
+- `src/minitest_cli/` - Main package
+- `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
+  - `auth.py` - Token storage (read/write ~/.minitest/credentials.json)
+- `api/client.py` - httpx async client with auto auth + X-Minitest-Channel header
+- `utils/`
+  - `output.py` - --json helpers: stdout=data, stderr=diagnostics
+  - `update_check.py` - PyPI version check (cached 24h, non-blocking)
+- `main.py` - Typer app entry point, global flags, command group registration
+- `tests/` - Unit tests
+
+## Coding Guidelines
+
+### Imports
+- ALWAYS use absolute imports (relative imports banned by ruff)
+- ALWAYS place imports at the top of the file
+- Order: standard library → third-party → local imports
+
+### Naming
+- Files/modules: `snake_case.py`
+- Classes: `PascalCase`
+- Functions/variables: `snake_case`
+- Constants: `UPPER_SNAKE_CASE`
+- Test files: `test_*.py`
+
+### Code Style
+- Keep files under 150 lines when possible
+- Use `X | None` syntax (not `Optional[X]`)
+- Use `Annotated[Type, ...]` for Typer parameters
+- Enums: inherit from `str, Enum`
+
+### Output Convention
+- `--json` flag: JSON to stdout, diagnostics to stderr
+- Without `--json`: human-friendly rich tables to stdout, diagnostics to stderr
+- Exit codes: 0=Success, 1=General error, 2=Auth error, 3=Network/API error, 4=Not found
+
+### No Interactive Prompts
+- All input via flags, env vars, or stdin
+- Never prompt for input interactively
+
+### Testing
+- Group tests in classes by feature
+- Name tests: `test_<action>_<scenario>`
+- Always check exit codes and output

{minitest_cli-0.3.0 → minitest_cli-0.4.1}/PKG-INFO

@@ -1,11 +1,14 @@
 Metadata-Version: 2.4
 Name: minitest-cli
-Version: 0.3.0
+Version: 0.4.1
 Summary: Minitest CLI – command-line interface for the Minitest testing platform
-Keywords: testing,cli,minitest,minitap,automation,qa
-Author: Minitap Team
+Project-URL: Homepage, https://minitap.ai/
+Project-URL: Source, https://github.com/minitap-ai/minitest-cli
+Project-URL: Bug Tracker, https://github.com/minitap-ai/minitest-cli/issues
+Project-URL: Changelog, https://github.com/minitap-ai/minitest-cli/releases
 Author-email: Minitap Team <support@minitap.ai>
 License-Expression: MIT
+Keywords: automation,cli,minitap,minitest,qa,testing
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -16,20 +19,16 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Testing
 Classifier: Typing :: Typed
-Requires-Dist: typer>=0.24.1
+Requires-Python: >=3.12
 Requires-Dist: httpx>=0.28.1
-Requires-Dist: pydantic>=2.12.5
 Requires-Dist: pydantic-settings>=2.13.1
+Requires-Dist: pydantic>=2.12.5
 Requires-Dist: rich>=14.3.3
-Requires-Dist: ruff>=0.15.6 ; extra == 'dev'
-Requires-Dist: pyright>=1.1.408 ; extra == 'dev'
-Requires-Dist: pytest>=9.0.2 ; extra == 'dev'
-Requires-Python: >=3.12
-Project-URL: Homepage, https://minitap.ai/
-Project-URL: Source, https://github.com/minitap-ai/minitest-cli
-Project-URL: Bug Tracker, https://github.com/minitap-ai/minitest-cli/issues
-Project-URL: Changelog, https://github.com/minitap-ai/minitest-cli/releases
+Requires-Dist: typer>=0.24.1
 Provides-Extra: dev
+Requires-Dist: pyright>=1.1.408; extra == 'dev'
+Requires-Dist: pytest>=9.0.2; extra == 'dev'
+Requires-Dist: ruff>=0.15.6; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # minitest-cli

minitest_cli-0.4.1/RELEASE.md

@@ -0,0 +1,90 @@
+# Release Process
+
+## Overview
+
+Releases are automated via GitHub Actions. Pushing a version tag triggers the
+full pipeline: build, publish to PyPI, create a GitHub Release, and update the
+Homebrew formula.
+
+## Steps
+
+### 1. Update the version
+
+Bump the version in `pyproject.toml`:
+
+- `pyproject.toml` — `version = "X.Y.Z"`
+
+Then sync the lockfile:
+
+```bash
+uv sync
+```
+
+### 2. Commit and tag
+
+```bash
+git add pyproject.toml uv.lock
+git commit -m "release: vX.Y.Z"
+git tag vX.Y.Z
+git push origin main
+git push origin vX.Y.Z
+```
+
+### 3. Automated pipeline
+
+The tag push triggers `.github/workflows/release.yml`, which:
+
+1. **Build** — runs `uv build` to produce sdist and wheel
+2. **Publish to PyPI** — uses trusted publishing (OIDC), no API token needed
+3. **GitHub Release** — creates a release with auto-generated notes and attaches
+   the built artifacts
+4. **Homebrew update** — dispatches an event to `minitap-ai/homebrew-tap` with
+   the new version, sdist URL, and SHA256 hash
+
+### 4. Verify
+
+After the pipeline completes:
+
+```bash
+# PyPI
+pip install minitest-cli==X.Y.Z
+minitest --version
+
+# uvx
+uvx --from minitest-cli@X.Y.Z minitest --version
+
+# Homebrew (after tap update completes)
+brew update
+brew install minitap-ai/tap/minitest-cli
+minitest --version
+```
+
+## Prerequisites
+
+### PyPI trusted publishing
+
+Configure on PyPI at https://pypi.org/manage/project/minitest-cli/settings/publishing/:
+
+| Field | Value |
+|-------|-------|
+| Owner | `minitap-ai` |
+| Repository | `minitest-cli` |
+| Workflow | `release.yml` |
+| Environment | `pypi` |
+
+### GitHub repository settings
+
+Create a GitHub Actions environment named `pypi` in the repository settings.
+
+### Homebrew tap token
+
+A `HOMEBREW_TAP_TOKEN` secret must be set in this repository with a GitHub
+personal access token that has write access to `minitap-ai/homebrew-tap`.
+
+## Version scheme
+
+We follow [Semantic Versioning](https://semver.org/):
+
+- **Patch** (`0.1.1`) — bug fixes, no API changes
+- **Minor** (`0.2.0`) — new features, backward-compatible
+- **Major** (`1.0.0`) — breaking changes

{minitest_cli-0.3.0 → minitest_cli-0.4.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "minitest-cli"
-version = "0.3.0"
+version = "0.4.1"
 description = "Minitest CLI – command-line interface for the Minitest testing platform"
 readme = "README.md"
 license = "MIT"
@@ -51,12 +51,11 @@ minitest = "minitest_cli.main:app"
 "Changelog" = "https://github.com/minitap-ai/minitest-cli/releases"
 
 [build-system]
-requires = ["uv_build>=0.10.11,<0.11.0"]
-build-backend = "uv_build"
+requires = ["hatchling"]
+build-backend = "hatchling.build"
 
-[tool.uv.build-backend]
-module-root = "src"
-module-name = "minitest_cli"
+[tool.hatch.build.targets.wheel]
+packages = ["src/minitest_cli"]
 
 [tool.ruff]
 exclude = [

minitest_cli-0.4.1/pyrightconfig.json

@@ -0,0 +1,3 @@
+{
+  "exclude": [".venv/**"]
+}

{minitest_cli-0.3.0 → minitest_cli-0.4.1}/src/minitest_cli/commands/flow.py

@@ -16,10 +16,10 @@ from minitest_cli.commands.flow_helpers import (
     handle_response_error,
     is_json_mode,
     run_api_call,
+    validate_flow_type,
 )
 from minitest_cli.core.app_context import resolve_app_id
 from minitest_cli.core.auth import require_auth
-from minitest_cli.models.flow_template import FlowType
 from minitest_cli.utils.output import output, print_info, print_success, print_table
 
 app = typer.Typer(name="flow", help="Testing flow operations.")
@@ -31,7 +31,7 @@ app.command(name="delete")(flow_modify.delete_flow)
 @app.command(name="create")
 def create_flow(
     name: Annotated[str, typer.Option("--name", help="Flow name.")],
-    flow_type: Annotated[FlowType, typer.Option("--type", help="Flow type.")],
+    flow_type: Annotated[str, typer.Option("--type", help="Flow type.")],
     description: Annotated[
         str | None, typer.Option("--description", help="Flow description.")
     ] = None,
@@ -44,7 +44,8 @@ def create_flow(
     json_mode = is_json_mode()
     require_auth(settings)
     app_id = resolve_app_id(settings, get_app_flag())
-    payload: dict[str, Any] = {"name": name, "type": flow_type.value}
+    validate_flow_type(flow_type, settings)
+    payload: dict[str, Any] = {"name": name, "type": flow_type}
     if description is not None:
         payload["description"] = description
     if criteria:
@@ -64,9 +65,7 @@ def create_flow(
 
 @app.command(name="list")
 def list_flows(
-    flow_type: Annotated[
-        FlowType | None, typer.Option("--type", help="Filter by flow type.")
-    ] = None,
+    flow_type: Annotated[str | None, typer.Option("--type", help="Filter by flow type.")] = None,
     page: Annotated[int, typer.Option("--page", min=1, help="Page number.")] = 1,
     page_size: Annotated[
         int, typer.Option("--page-size", min=1, max=100, help="Items per page.")
@@ -80,12 +79,14 @@ def list_flows(
     json_mode = is_json_mode()
     require_auth(settings)
     app_id = resolve_app_id(settings, get_app_flag())
+    if flow_type is not None:
+        validate_flow_type(flow_type, settings)
     if all_flows:
         page, page_size = 1, 100
 
     params: dict[str, Any] = {"page": page, "page_size": page_size}
     if flow_type is not None:
-        params["type"] = flow_type.value
+        params["type"] = flow_type
 
     async def _run() -> Any:
         async with ApiClient(settings) as client:

{minitest_cli-0.3.0 → minitest_cli-0.4.1}/src/minitest_cli/commands/flow_helpers.py

@@ -20,6 +20,35 @@ EXIT_NOT_FOUND = 4
 FLOW_TABLE_HEADERS = ["ID", "Name", "Type", "Description", "Acceptance Criteria"]
 
 
+def fetch_flow_types(settings: Settings) -> list[str]:
+    """Fetch valid flow types from the API."""
+    try:
+        resp = httpx.get(
+            f"{settings.api_url}/api/v1/flow-types",
+            timeout=10,
+        )
+    except httpx.HTTPError as exc:
+        print_error(f"Failed to fetch flow types: {exc}")
+        raise typer.Exit(code=EXIT_NETWORK_ERROR) from exc
+    if resp.status_code != 200:
+        print_error(f"Failed to fetch flow types: HTTP {resp.status_code}")
+        raise typer.Exit(code=EXIT_NETWORK_ERROR)
+    data = resp.json()
+    if not isinstance(data, list) or not data:
+        print_error("Invalid response from flow types endpoint.")
+        raise typer.Exit(code=EXIT_NETWORK_ERROR)
+    return data
+
+
+def validate_flow_type(value: str, settings: Settings) -> str:
+    """Validate a flow type value against types from the API."""
+    valid = fetch_flow_types(settings)
+    if value not in valid:
+        print_error(f"Invalid flow type '{value}'. Valid types: {', '.join(valid)}")
+        raise typer.Exit(code=1)
+    return value
+
+
 def get_settings() -> Settings:
     return typer.Context.settings  # type: ignore[attr-defined]