zima-blue-cli 0.1.0__tar.gz

zima_blue_cli-0.1.0/.claude/agents/test-reviewer.md

@@ -0,0 +1,45 @@
+---
+name: test-reviewer
+description: Reviews test files for proper isolation, coverage, and conventions
+model: haiku
+---
+
+# Test Reviewer
+
+You are a specialized test reviewer for the Zima Blue CLI project. Review test files against the project's testing conventions.
+
+## Review Checklist
+
+For each test file, check:
+
+1. **Isolation**: Tests using filesystem/config operations must inherit from `TestIsolator` (in `tests/base.py`). This provides automatic `ZIMA_HOME` isolation via `monkeypatch`.
+
+2. **Fixture usage**: Use shared fixtures from `tests/conftest.py`:
+   - `isolated_zima_home` — temp ZIMA_HOME directory
+   - `config_manager` — pre-configured ConfigManager
+   - `cli_runner` — Typer CliRunner instance
+   - `unique_code` — unique test identifier generator
+
+3. **Test placement**:
+   - Pure unit tests (no subprocess, no filesystem) → `tests/unit/`
+   - CLI command tests, subprocess tests → `tests/integration/`
+
+4. **Naming convention**:
+   - File: `test_<module_path>.py` (e.g., `zima/models/agent.py` → `test_models_agent.py`)
+   - Class: `Test<ClassName>`
+   - Method: `test_<behavior>_<condition>`
+
+5. **Coverage quality**:
+   - Happy path + edge cases + error handling
+   - Use `pytest.raises` for expected exceptions
+   - No trivial tests (e.g., only testing that an object exists)
+
+6. **Docstrings**: Google-style docstrings on test classes, concise descriptions on methods.
+
+## Output Format
+
+Report issues grouped by severity:
+
+- **MUST FIX**: Missing isolation, wrong placement, broken fixtures
+- **SHOULD FIX**: Missing edge cases, poor naming, missing docstrings
+- **NICE TO HAVE**: Style improvements, additional coverage suggestions

zima_blue_cli-0.1.0/.claude/settings.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "FILE=\"$CLAUDE_FILE_PATH\"; if [[ \"$FILE\" == *.py ]]; then black \"$FILE\" --line-length 100 --quiet 2>/dev/null; ruff check \"$FILE\" --fix --quiet 2>/dev/null; fi"
+          }
+        ]
+      }
+    ]
+  }
+}

zima_blue_cli-0.1.0/.claude/skills/gen-test/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: gen-test
+description: Generate pytest unit tests for a given source module or function
+---
+
+# Generate Tests
+
+Generate pytest unit tests for a target Python module or function.
+
+## Usage
+
+- `/gen-test zima/models/agent.py` — generate tests for the agent model
+- `/gen-test zima/config/manager.py::ConfigManager.save_config` — generate tests for a specific method
+
+## Instructions
+
+1. **Read the target source file** to understand its public API, classes, and functions.
+
+2. **Determine the test file path** using the project convention:
+   - Source: `zima/foo/bar.py` -> Test: `tests/unit/test_foo_bar.py` (flattened with underscores)
+   - But check existing naming first: `zima/models/agent.py` -> `tests/unit/test_models_agent.py`
+   - If the test file already exists, **append** new test classes/methods rather than overwriting.
+
+3. **Generate tests** following these conventions:
+   - Test classes inherit from `TestIsolator` (from `tests/base.py`) when filesystem/config isolation is needed
+   - Use `monkeypatch` for `ZIMA_HOME` isolation (handled by `TestIsolator`)
+   - Use fixtures from `tests/conftest.py` (`config_manager`, `cli_runner`, `unique_code`, `isolated_zima_home`)
+   - Google-style docstrings on test classes
+   - Cover: happy path, edge cases, error handling
+   - Use `pytest.raises` for expected exceptions
+   - Use `tmp_path` or `TestIsolator.get_test_path()` for temp files
+
+4. **Example test structure**:
+
+```python
+"""Tests for <module description>."""
+
+import pytest
+
+from zima.<module> import <TargetClass>
+from tests.base import TestIsolator
+
+
+class Test<TargetClass>(TestIsolator):
+    """Tests for <TargetClass>."""
+
+    def test_<behavior>_success(self):
+        """Test <behavior> with valid input."""
+        # arrange
+        ...
+        # act
+        result = ...
+        # assert
+        assert result == expected
+
+    def test_<behavior>_invalid_input(self):
+        """Test <behavior> raises on invalid input."""
+        with pytest.raises(ValueError):
+            ...
+```
+
+5. **After generating**, run the test to verify it passes:
+   ```bash
+   pytest <test_file> -v
+   ```
+
+6. **Report** the test file path, number of tests generated, and pass/fail status.

zima_blue_cli-0.1.0/.claude/skills/new-entity/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: new-entity
+description: Scaffold a new configuration entity type (model, commands, manager integration, CLI registration)
+disable-model-invocation: true
+---
+
+# New Config Entity Scaffold
+
+Scaffold a new configuration entity type for the Zima Blue CLI platform.
+
+## Usage
+
+- `/new-entity Trigger` — create a new entity called "Trigger"
+- `/new-entity Schedule` — create a new entity called "Schedule"
+
+## Instructions
+
+Follow the 4-step extension pattern documented in CLAUDE.md:
+
+### Step 1: Create Model
+
+Create `zima/models/<entity>.py`:
+
+- Follow the pattern from existing models (e.g., `zima/models/agent.py`)
+- Inherit from `BaseConfig` or create a standalone dataclass
+- Include `Metadata` with `code`, `name`, `description`
+- YAML structure: `apiVersion: zima.io/v1` / `kind: <Entity>` / `metadata` / `spec`
+- Add `KIND = "<entity>"` class constant
+- Implement `from_dict` classmethod and `to_dict` method
+- Add validation for `metadata.code`: lowercase letters, numbers, hyphens only, max 64 chars
+
+### Step 2: Register in ConfigManager
+
+Edit `zima/config/manager.py`:
+
+- Add the new kind string to `ConfigManager.KINDS` set
+- No other changes needed — `ConfigManager` handles all entity types generically
+
+### Step 3: Create Commands
+
+Create `zima/commands/<entity>.py`:
+
+- Follow the pattern from existing commands (e.g., `zima/commands/agent.py`)
+- Use Typer `app = typer.Typer(help="<Entity> management commands")`
+- Implement standard CRUD: `list`, `get`, `create`, `delete`
+- For `create`: accept YAML file via `--file` option, validate and save
+- Use `ConfigManager` for all config operations
+- Use `rich` for formatted output
+
+### Step 4: Register CLI Subcommand
+
+Edit `zima/cli.py`:
+
+- Import the new command app: `from zima.commands.<entity> import app as <entity>_app`
+- Register: `app.add_typer(<entity>_app, name="<entity>")`
+
+### Step 5: Create Test Fixtures (Optional)
+
+Create sample YAML config in `tests/fixtures/configs/`:
+
+```yaml
+apiVersion: zima.io/v1
+kind: <Entity>
+metadata:
+  code: sample-<entity>
+  name: Sample <Entity>
+  description: For testing
+spec:
+  # entity-specific fields
+```
+
+### Verification
+
+After scaffolding, verify:
+1. `python -c "from zima.models.<entity> import <Entity>Config"` — import works
+2. `zima <entity> --help` — CLI registered correctly
+3. `pytest tests/` — no existing tests broken

zima_blue_cli-0.1.0/.github/workflows/integration-test.yml

@@ -0,0 +1,210 @@
+name: Integration Tests
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - 'zima/**'
+      - 'tests/**'
+      - 'pyproject.toml'
+      - '.github/workflows/integration-test.yml'
+  pull_request:
+    branches: [main, master]
+    paths:
+      - 'zima/**'
+      - 'tests/**'
+      - 'pyproject.toml'
+      - '.github/workflows/integration-test.yml'
+  workflow_dispatch:
+    inputs:
+      test_type:
+        description: 'Test type to run'
+        required: true
+        default: 'fast'
+        type: choice
+        options:
+          - fast
+          - full
+
+env:
+  PYTHONIOENCODING: utf-8
+  PYTHONUTF8: 1
+
+jobs:
+  # ============ Lint ============
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('pyproject.toml') }}
+          restore-keys: ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run ruff check
+        run: ruff check zima/ tests/
+
+      - name: Run black check
+        run: black --check zima/ tests/ --line-length 100
+
+  # ============ Fast Tests (PR + push) ============
+  test-fast:
+    runs-on: ${{ matrix.os }}
+    needs: lint
+    if: github.event_name != 'workflow_dispatch' || github.event.inputs.test_type == 'fast'
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ['3.13']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('pyproject.toml') }}
+          restore-keys: ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests (Ubuntu)
+        if: runner.os == 'Linux'
+        run: pytest tests/ -m "not slow" --cov=zima --cov-report=xml --cov-fail-under=60 --tb=short -v
+        timeout-minutes: 10
+
+      - name: Run tests (Windows)
+        if: runner.os == 'Windows'
+        run: pytest tests/ -m "not slow" --tb=short -v
+        timeout-minutes: 20
+
+      - name: Upload coverage data
+        if: runner.os == 'Linux'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-data
+          path: coverage.xml
+          retention-days: 1
+
+  # ============ Full Tests (manual only) ============
+  test-full:
+    runs-on: ${{ matrix.os }}
+    needs: lint
+    if: github.event.inputs.test_type == 'full'
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ['3.13']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('pyproject.toml') }}
+          restore-keys: ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run full test suite
+        run: pytest tests/ -v --tb=short
+        timeout-minutes: 20
+
+  # ============ Quality Gate ============
+  quality-gate:
+    runs-on: ubuntu-latest
+    needs: [lint, test-fast]
+    if: always()
+    steps:
+      - name: Check all jobs passed
+        run: |
+          echo "lint: ${{ needs.lint.result }}"
+          echo "test-fast: ${{ needs.test-fast.result }}"
+          fast_ok="${{ needs.test-fast.result }}"
+          if [[ "${{ needs.lint.result }}" == "success" && ("$fast_ok" == "success" || "$fast_ok" == "skipped") ]]; then
+            echo "Quality gate passed!"
+            exit 0
+          else
+            echo "Quality gate FAILED!"
+            exit 1
+          fi
+
+  # ============ Coverage Report ============
+  coverage:
+    runs-on: ubuntu-latest
+    needs: [test-fast]
+    if: always() && needs.test-fast.result == 'success' && github.event_name == 'pull_request'
+    permissions:
+      pull-requests: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Download coverage data
+        uses: actions/download-artifact@v4
+        with:
+          name: coverage-data
+
+      - name: Post coverage comment on PR
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          python -c "
+          import xml.etree.ElementTree as ET
+          import subprocess
+
+          tree = ET.parse('coverage.xml')
+          root = tree.getroot()
+          rate = float(root.attrib['line-rate'])
+          lines_covered = int(root.attrib['lines-covered'])
+          lines_valid = int(root.attrib['lines-valid'])
+
+          rows = []
+          for cls in root.iter('class'):
+              name = cls.attrib['filename']
+              r = float(cls.attrib['line-rate'])
+              rows.append((name, r))
+          rows.sort(key=lambda x: x[1])
+
+          comment = '## Test Coverage\n\n'
+          comment += '**Overall: {:.1f}%** ({}/{} lines)\n\n'.format(rate * 100, lines_covered, lines_valid)
+          comment += '| Module | Coverage | Status |\n|--------|----------|--------|\n'
+          for name, r in rows:
+              icon = ':green_circle:' if r >= 0.8 else ':yellow_circle:' if r >= 0.5 else ':red_circle:'
+              comment += '| {} | {:.1f}% | {} |\n'.format(name, r * 100, icon)
+
+          pr = '${{ github.event.pull_request.number }}'
+          subprocess.run(['gh', 'pr', 'comment', pr, '--body', comment])
+          "

zima_blue_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  pypi-publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish

zima_blue_cli-0.1.0/.gitignore

@@ -0,0 +1,52 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Agent logs and sessions (user data)
+agents/*/logs/
+agents/*/sessions/
+agents/*/prompts/
+agents/*/checkpoints/
+agents/*/state.json
+
+# ZimaBlue runtime
+.zima/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Git worktrees
+.worktrees/
+