wade-cli 0.0.1__tar.gz → 0.29.0__tar.gz

wade_cli-0.29.0/.github/workflows/auto-version.yml

@@ -0,0 +1,73 @@
+name: Auto Version Bump
+
+on:
+  pull_request:
+    types: [closed]
+    branches: [main]
+
+permissions:
+  contents: write
+
+jobs:
+  version-bump:
+    # Only run when the PR was actually merged
+    if: github.event.pull_request.merged == true
+    runs-on: ubuntu-latest
+    steps:
+      - name: Detect bump type
+        id: detect
+        env:
+          COMMIT_MSG: ${{ github.event.pull_request.title }}
+        run: |
+          MSG="$COMMIT_MSG"
+          FIRST_LINE=$(echo "$MSG" | head -n 1)
+
+          if echo "$MSG" | grep -q 'BREAKING CHANGE'; then
+            echo "bump=major" >> "$GITHUB_OUTPUT"
+          elif echo "$FIRST_LINE" | grep -qE '^[a-z]+(\(.+\))?!:'; then
+            echo "bump=major" >> "$GITHUB_OUTPUT"
+          elif echo "$FIRST_LINE" | grep -qE '^(feat|update)(\(.+\))?:'; then
+            echo "bump=minor" >> "$GITHUB_OUTPUT"
+          elif echo "$FIRST_LINE" | grep -qE '^(fix|docs|refactor|chore|style|perf|test|ci|build|revert)(\(.+\))?:'; then
+            echo "bump=patch" >> "$GITHUB_OUTPUT"
+          else
+            echo "bump=" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Skip if no conventional commit
+        if: steps.detect.outputs.bump == ''
+        run: echo "No conventional commit prefix detected — skipping version bump."
+
+      - uses: actions/checkout@v4
+        if: steps.detect.outputs.bump != ''
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v3
+        if: steps.detect.outputs.bump != ''
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        if: steps.detect.outputs.bump != ''
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        if: steps.detect.outputs.bump != ''
+        run: uv sync --all-extras
+
+      - name: Configure git
+        if: steps.detect.outputs.bump != ''
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: Bump version
+        if: steps.detect.outputs.bump != ''
+        run: uv run python scripts/auto_version.py ${{ steps.detect.outputs.bump }}
+
+      - name: Push commit and tag
+        if: steps.detect.outputs.bump != ''
+        run: |
+          git push
+          git push --tags

wade_cli-0.29.0/.github/workflows/ci.yml

@@ -0,0 +1,71 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+      - name: Set up Python
+        run: uv python install 3.13
+      - name: Install dependencies
+        run: uv sync --all-extras
+      - name: Lint with ruff
+        run: uv run ruff check src/ tests/
+      - name: Format check with ruff
+        run: uv run ruff format --check src/ tests/
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+      - name: Set up Python
+        run: uv python install 3.13
+      - name: Install dependencies
+        run: uv sync --all-extras
+      - name: Type check with mypy
+        run: uv run mypy src/ --strict
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: uv sync --all-extras
+      - name: Configure git
+        run: |
+          git config --global user.email "test@wade.dev"
+          git config --global user.name "wade test"
+          git config --global init.defaultBranch main
+      - name: Run unit tests
+        run: ./scripts/test.sh tests/unit/
+      - name: Run integration tests
+        run: ./scripts/test.sh tests/integration/
+      - name: Run top-level CLI contract smoke
+        run: ./scripts/test.sh tests/test_cli_basics.py
+
+  e2e_docker:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run deterministic e2e contract tests in Docker
+        run: ./scripts/test-e2e-docker.sh

wade_cli-0.29.0/.github/workflows/pr-title-lint.yml

@@ -0,0 +1,31 @@
+name: PR Title Lint
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize, reopened]
+    branches: [main]
+
+permissions:
+  pull-requests: read
+
+jobs:
+  lint-title:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: amannn/action-semantic-pull-request@v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          types: |
+            feat
+            fix
+            docs
+            refactor
+            chore
+            style
+            perf
+            test
+            ci
+            build
+            revert
+            update

wade_cli-0.29.0/.gitignore

@@ -0,0 +1,48 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+
+# AI tool directories (wade-managed — never committed in this repo)
+.agents/
+.claude/
+.copilot/
+.cursor/
+.gemini/
+.github/hooks/
+.github/skills
+CLAUDE.md
+PLAN.md
+PR-SUMMARY.md
+
+# OS
+.DS_Store
+Thumbs.db
+
+# uv
+uv.lock
+
+# Local archive (pre-reset export)
+archive/

wade_cli-0.29.0/.pre-commit-config.yaml

@@ -0,0 +1,26 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.2
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: local
+    hooks:
+      - id: mypy
+        name: mypy
+        language: system
+        entry: uv run mypy --strict src/
+        pass_filenames: false
+        always_run: true
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: [--maxkb=500]
+      - id: check-merge-conflict

wade_cli-0.29.0/.wade.yml

@@ -0,0 +1,66 @@
+version: 2
+project:
+  main_branch: main
+  issue_label: feature-plan
+  worktrees_dir: ../.worktrees
+  branch_prefix: feat
+  merge_strategy: PR
+ai:
+  default_tool: claude
+  default_model: claude-sonnet-4.6
+  effort: max
+  plan:
+    tool: claude
+    model: claude-opus-4.7
+    effort: xhigh
+    yolo: true
+  deps:
+    tool: copilot
+    model: claude-sonnet-4.6
+    mode: headless
+    yolo: false
+  review_plan:
+    tool: copilot
+    model: claude-sonnet-4.6
+    mode: headless
+    enabled: true
+    yolo: false
+  review_implementation:
+    tool: copilot
+    model: claude-sonnet-4.6
+    mode: headless
+    enabled: true
+    yolo: false
+  review_batch:
+    tool: copilot
+    model: claude-sonnet-4.6
+    mode: interactive
+    enabled: true
+    yolo: true
+  yolo: true
+models:
+  claude:
+    easy:
+      model: claude-sonnet-4.6
+      effort: xhigh
+    medium:
+      model: claude-sonnet-4.6
+      effort: max
+    complex:
+      model: claude-opus-4.7
+      effort: high
+    very_complex:
+      model: claude-opus-4.7
+      effort: xhigh
+provider:
+  name: github
+knowledge:
+  enabled: true
+  path: KNOWLEDGE.md
+hooks:
+  post_worktree_create: scripts/setup-worktree.sh
+  copy_to_worktree:
+  - .env
+  - .wade.yml
+  - KNOWLEDGE.md
+  - KNOWLEDGE.ratings.yml

wade_cli-0.29.0/AGENTS.md

@@ -0,0 +1,144 @@
+# AGENTS.md
+
+This file provides guidance to AI agents working on the WADE codebase.
+For detailed reference on specific topics, see `docs/dev/`.
+
+## Project Overview
+
+**WADE** (Workflow for AI-Driven Engineering) is a Python CLI toolkit for AI-agent-driven git workflow management. It wraps `gh` CLI and native git to manage GitHub Issues as tasks, git worktrees for isolated development, branch safety checks, and installable Agent Skill files. CLI entry point: **`wade`**.
+
+## Terminology
+
+Two distinct worlds interact in this codebase. Always be clear which one you are working in:
+
+| Term | Meaning |
+|------|---------|
+| **the WADE repo** / **this project** | This source repository — `src/wade/`, `templates/`, `tests/`, `scripts/` |
+| **inited project** / **target project** | Any third-party repo that has run `wade init` to adopt the workflow |
+| **skill templates** | Markdown files in `templates/skills/` — the source of truth, part of the WADE repo |
+| **installed skills** | Copies (or symlinks) of skill templates placed in a project's `.claude/skills/` by `wade init` |
+| **AGENTS.md pointer** | A short `## Git Workflow` block that `wade init` injects into an inited project's `AGENTS.md` |
+
+**This `AGENTS.md` governs development of WADE itself.** Skills, the pointer, and the progressive disclosure architecture are all *outputs* of WADE — artifacts installed into inited projects, not rules for developing WADE.
+
+**WADE uses its own workflow.** This repo is itself an inited project. Follow the `## Git Workflow` pointer at the bottom and the phase-specific skill referenced in your clipboard prompt.
+
+## Commands
+
+> **AI agents: always run the scripts below — never improvise raw `uv run pytest` / `mypy` / `ruff` calls.**
+
+| Script | Purpose |
+|--------|---------|
+| `./scripts/test.sh` | Run all tests (excludes live) |
+| `./scripts/test.sh tests/unit/` | Unit tests only |
+| `./scripts/test-e2e.sh` | Deterministic E2E contract tests (host lane) |
+| `./scripts/test-e2e-docker.sh` | Deterministic E2E contract tests in Docker (CI-equivalent) |
+| `./scripts/check.sh` | Lint + type-check (both) |
+| `./scripts/check.sh --lint` | Lint + format check only |
+| `./scripts/check.sh --types` | Type check (strict mypy) only |
+| `./scripts/fmt.sh` | Auto-format source in-place |
+| `./scripts/check-all.sh` | Full checklist (test + check) |
+
+```bash
+uv pip install -e ".[dev]"           # Install for development
+uv run python scripts/auto_version.py patch # Version bump (patch/minor/major)
+
+# Version bumps MUST be done with the script above. NEVER bump pyproject.toml
+# manually, as the script generates CHANGELOG.md and git tags automatically.
+```
+
+> Full commands reference: see `docs/dev/architecture.md`
+
+## Architecture
+
+```
+CLI Layer      ->  can import: services, models, config, logging, ui
+Service Layer  ->  can import: providers, ai_tools, git, db, models, config, logging
+Provider Layer ->  can import: models, config, logging  (NO service imports)
+AI Tool Layer  ->  can import: models, config, logging  (NO service imports)
+Git Layer      ->  can import: models, config, logging  (NO service imports)
+DB Layer       ->  can import: models, logging           (NO config imports)
+Models Layer   ->  can import: nothing (leaf dependency)
+```
+
+No circular dependencies. Models are pure data. Services orchestrate. **Never import a higher layer from a lower layer.**
+
+CLI modules are thin dispatch — they parse flags via Typer, then call service methods. Business logic lives in `services/`, not in `cli/`.
+
+> Full package structure, command dispatch, config system, and subsystem details: see `docs/dev/architecture.md`
+
+### Key Design Patterns
+
+- **AI Tool Self-Registration**: `AbstractAITool.__init_subclass__` auto-registers adapters. Adding a new AI tool = one file, one class.
+- **Provider Abstraction**: `AbstractTaskProvider` ABC with pluggable backends (GitHub via `gh` CLI, ClickUp via REST API, Markdown via a single central file). Non-GitHub providers compose `GitHubPRDelegateMixin` so PR-review APIs still flow through `gh`.
+- **Prompts as .md Templates**: All AI prompts live in `templates/prompts/`, not inline strings.
+- **Synchronous Only**: No asyncio. Process-level parallelism via multiple terminals.
+- **Pydantic Everywhere**: All data structures are Pydantic `BaseModel` subclasses, not dicts.
+
+## Design Principles
+
+### Determinism via Services
+
+All deterministic operations — git commands, state transitions, file manipulation, API calls — **must live in service/utility code**, never in AI agent reasoning.
+
+- **Code decides and executes** — fetch, merge, branch creation, worktree lifecycle, issue state changes. Codified in `services/`, `git/`, `providers/`.
+- **Agents interpret and decide** — reading conflict diffs, choosing resolution strategies, composing commit messages. Guided by skills.
+
+**Test**: "Can an AI agent get this wrong by reasoning about it?" If yes, put it in code.
+
+### Two Worlds
+
+Everything in this repo exists in one of two worlds:
+
+| WADE repo (source) | Inited project (output) |
+|---------------------|------------------------|
+| `src/wade/` | installed `wade` binary |
+| `templates/skills/<name>/SKILL.md` | `.claude/skills/<name>/SKILL.md` |
+| `templates/agents-pointer.md` | `## Git Workflow` block in target `AGENTS.md` |
+| `AGENTS.md` (this file) | target project's own `AGENTS.md` |
+
+When developing WADE, **only touch the left column**. Always edit `templates/skills/<name>/SKILL.md` directly — never edit files inside `.claude/skills/` (those are symlinks in this repo, copies in inited projects).
+
+> Skills system deep dive (symlinks, pointer markers, installation lifecycle): see `docs/dev/skills-system.md`
+
+## Conventions
+
+### Naming
+
+- **Modules**: `snake_case.py` — one module per concern
+- **Classes**: `PascalCase` — Pydantic models, ABCs, adapters
+- **Functions**: `snake_case` — `_` prefix for private helpers
+- **Constants**: `UPPER_SNAKE_CASE`
+- **Enums**: `StrEnum` for string-valued enums
+- **CLI commands**: top-level commands (`wade plan`, `wade implement`)
+
+### Commits
+
+Use [Conventional Commits](https://www.conventionalcommits.org/):
+`feat:` (minor), `fix:` (patch), `docs:` (patch), `refactor:` (patch),
+`test:` (patch), `chore:` (patch). Breaking changes (`feat!:`) -> major.
+
+## Change Checklist
+
+Before considering any work complete:
+
+- [ ] **Code** — `./scripts/test.sh` passes
+- [ ] **Types + Lint** — `./scripts/check.sh` passes (or run both at once: `./scripts/check-all.sh`)
+- [ ] **`AGENTS.md`** — updated if architecture, conventions, or workflow changed
+- [ ] **`README.md`** — updated if user-facing behavior changed
+- [ ] **`templates/skills/`** — updated if agent-facing rules changed (plan-session for planning, implementation-session for implementation, review-pr-comments-session for reviews)
+- [ ] **Commit** — uses conventional-commit prefix
+
+> Full 10-item checklist, documentation rules, feedback loop, and correction-driven docs: see `docs/dev/documentation-policies.md`
+
+## Detailed Reference
+
+Read these on-demand when working in a specific area:
+
+| When you are... | Read |
+|-----------------|------|
+| Modifying architecture, config, or commands | `docs/dev/architecture.md` |
+| Adding an AI tool, provider, or subcommand | `docs/dev/extending.md` |
+| Writing or running tests | `docs/dev/testing.md` |
+| Working on skills, pointer system, or `wade init` | `docs/dev/skills-system.md` |
+| Updating documentation policies | `docs/dev/documentation-policies.md` |