devcoach 0.1.0__tar.gz → 0.3.5__tar.gz

devcoach-0.3.5/.github/workflows/ci.yml

@@ -0,0 +1,185 @@
+name: CI
+
+# Covers three scenarios:
+#
+#  1. Push to main / pull request  →  lint + test + build
+#  2. Tag push (v*)                →  lint + test + build + publish + GitHub Release
+#  3. workflow_dispatch (Release)  →  bump version → tag → lint + test + build + publish + GitHub Release
+#
+# The bump job only runs on workflow_dispatch. Lint/test/build always run.
+# Publish and GitHub Release run whenever a tag is present.
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: "Version bump type"
+        required: false
+        default: patch
+        type: choice
+        options: [patch, minor, major]
+      version:
+        description: "Exact version (overrides bump, e.g. 1.0.0)"
+        required: false
+        default: ""
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # ── Bump ────────────────────────────────────────────────────────────────
+  # Only runs on workflow_dispatch. Bumps pyproject.toml, commits, tags, pushes.
+  bump:
+    name: Bump version and tag
+    if: github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      version: ${{ steps.ver.outputs.version }}
+      tag:     ${{ steps.ver.outputs.tag }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Configure git
+        run: |
+          git config user.name  "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Compute next version
+        id: ver
+        run: |
+          if [ -n "${{ inputs.version }}" ]; then
+            NEXT="${{ inputs.version }}"
+          else
+            CURRENT=$(grep '^version' pyproject.toml | head -1 | sed 's/.*"\(.*\)"/\1/')
+            IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT"
+            case "${{ inputs.bump }}" in
+              major) NEXT="$((MAJOR+1)).0.0" ;;
+              minor) NEXT="${MAJOR}.$((MINOR+1)).0" ;;
+              patch) NEXT="${MAJOR}.${MINOR}.$((PATCH+1))" ;;
+            esac
+          fi
+          echo "version=$NEXT" >> "$GITHUB_OUTPUT"
+          echo "tag=v$NEXT"    >> "$GITHUB_OUTPUT"
+
+      - name: Bump version in pyproject.toml
+        run: sed -i 's/^version = ".*"/version = "${{ steps.ver.outputs.version }}"/' pyproject.toml
+
+      - name: Commit and tag
+        run: |
+          git add pyproject.toml
+          git commit -m "chore: bump version to ${{ steps.ver.outputs.version }}"
+          git tag "${{ steps.ver.outputs.tag }}"
+          git push --atomic origin main "${{ steps.ver.outputs.tag }}"
+
+  # ── Lint ────────────────────────────────────────────────────────────────
+  lint:
+    name: Lint (ruff)
+    needs: [bump]
+    if: always() && (needs.bump.result == 'success' || needs.bump.result == 'skipped')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ needs.bump.outputs.tag || github.ref }}
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - run: uv sync --group dev
+      - run: uv run ruff check src/ tests/
+      - run: uv run ruff format --check src/ tests/
+
+  # ── Tests ───────────────────────────────────────────────────────────────
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    needs: [bump]
+    if: always() && (needs.bump.result == 'success' || needs.bump.result == 'skipped')
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ needs.bump.outputs.tag || github.ref }}
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv sync --group dev
+      - run: uv run pytest tests/ -v --tb=short
+
+  # ── Build ───────────────────────────────────────────────────────────────
+  build:
+    name: Build distribution
+    needs: [bump, lint, test]
+    if: always() && (needs.bump.result == 'success' || needs.bump.result == 'skipped') && needs.lint.result == 'success' && needs.test.result == 'success'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ needs.bump.outputs.tag || github.ref }}
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - run: uv build
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/
+          retention-days: 7
+
+  # ── Publish ─────────────────────────────────────────────────────────────
+  # Runs when a tag is present: either created by the bump job (workflow_dispatch)
+  # or pushed directly (git push origin v1.2.3).
+  # Uses PyPI Trusted Publishing (OIDC) — no API tokens needed.
+  #
+  # One-time setup on PyPI: project=devcoach, owner=UltimaPhoenix,
+  #   repo=dev-coach, workflow=ci.yml, environment=pypi
+  publish:
+    name: Publish to PyPI
+    needs: [bump, build]
+    if: always() && needs.build.result == 'success' && (needs.bump.result == 'success' || startsWith(github.ref, 'refs/tags/v'))
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/devcoach
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  # ── GitHub Release ──────────────────────────────────────────────────────
+  github-release:
+    name: Create GitHub Release
+    needs: [bump, publish]
+    if: always() && needs.publish.result == 'success' && (needs.bump.result == 'success' || startsWith(github.ref, 'refs/tags/v'))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ needs.bump.outputs.tag || github.ref }}
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+      - uses: softprops/action-gh-release@v3
+        with:
+          tag_name: ${{ needs.bump.outputs.tag || github.ref_name }}
+          files: dist/*
+          generate_release_notes: true
+          fail_on_unmatched_files: true

{devcoach-0.1.0 → devcoach-0.3.5}/.github/workflows/ruff-autofix.yml

@@ -14,9 +14,9 @@ jobs:
     name: ruff check --fix + ruff format
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: astral-sh/setup-uv@v5
+      - uses: astral-sh/setup-uv@v7
         with:
           python-version: "3.12"
 

{devcoach-0.1.0 → devcoach-0.3.5}/CLAUDE.md

@@ -250,7 +250,9 @@ npx @modelcontextprotocol/inspector devcoach
 
 ## Development conventions
 
-- All code is **type-annotated** (mypy-compatible)
+- Follow **Uncle Bob's Clean Code** principles
+- Follow **PEP** standards
+- Linting and formatting enforced by **ruff** — run `uv run ruff check src/ tests/` and `uv run ruff format src/ tests/` before committing
 - No external dependencies beyond `fastmcp` and `pydantic`
 - `db.py` exposes only pure functions — no business logic
 - `coach.py` never imports from `server.py` (one-way dependency)

{devcoach-0.1.0 → devcoach-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devcoach
-Version: 0.1.0
+Version: 0.3.5
 Summary: A local MCP server that acts as a progressive technical coach for Claude Code and Claude Desktop
 Project-URL: Homepage, https://github.com/UltimaPhoenix/dev-coach
 Project-URL: Repository, https://github.com/UltimaPhoenix/dev-coach
@@ -232,8 +232,8 @@ Description-Content-Type: text/markdown
 
 # devcoach
 
-[![PyPI](https://img.shields.io/pypi/v/devcoach)](https://pypi.org/project/devcoach/)
-[![Python](https://img.shields.io/pypi/pyversions/devcoach)](https://pypi.org/project/devcoach/)
+[![PyPI](https://img.shields.io/github/v/release/UltimaPhoenix/dev-coach?label=PyPI)](https://pypi.org/project/devcoach/)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://pypi.org/project/devcoach/)
 [![CI](https://github.com/UltimaPhoenix/dev-coach/actions/workflows/ci.yml/badge.svg)](https://github.com/UltimaPhoenix/dev-coach/actions/workflows/ci.yml)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
 

{devcoach-0.1.0 → devcoach-0.3.5}/README.md

@@ -1,7 +1,7 @@
 # devcoach
 
-[![PyPI](https://img.shields.io/pypi/v/devcoach)](https://pypi.org/project/devcoach/)
-[![Python](https://img.shields.io/pypi/pyversions/devcoach)](https://pypi.org/project/devcoach/)
+[![PyPI](https://img.shields.io/github/v/release/UltimaPhoenix/dev-coach?label=PyPI)](https://pypi.org/project/devcoach/)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://pypi.org/project/devcoach/)
 [![CI](https://github.com/UltimaPhoenix/dev-coach/actions/workflows/ci.yml/badge.svg)](https://github.com/UltimaPhoenix/dev-coach/actions/workflows/ci.yml)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
 

{devcoach-0.1.0 → devcoach-0.3.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "devcoach"
-version = "0.1.0"
+version = "0.3.5"
 description = "A local MCP server that acts as a progressive technical coach for Claude Code and Claude Desktop"
 readme = "README.md"
 requires-python = ">=3.11"

devcoach-0.1.0/.github/workflows/ci.yml

@@ -1,110 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-    tags: ["v*"]
-  pull_request:
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  # ── Lint ────────────────────────────────────────────────────────────────
-  lint:
-    name: Lint (ruff)
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: astral-sh/setup-uv@v7
-        with:
-          python-version: "3.12"
-      - run: uv sync --group dev
-      - run: uv run ruff check src/ tests/
-      - run: uv run ruff format --check src/ tests/
-
-  # ── Tests ───────────────────────────────────────────────────────────────
-  test:
-    name: Test (Python ${{ matrix.python-version }})
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.11", "3.12", "3.13"]
-    steps:
-      - uses: actions/checkout@v6
-      - uses: astral-sh/setup-uv@v7
-        with:
-          python-version: ${{ matrix.python-version }}
-      - run: uv sync --group dev
-      - run: uv run pytest tests/ -v --tb=short
-
-  # ── Build ───────────────────────────────────────────────────────────────
-  build:
-    name: Build distribution
-    needs: [lint, test]
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: astral-sh/setup-uv@v7
-        with:
-          python-version: "3.12"
-      - run: uv build
-      - uses: actions/upload-artifact@v7
-        with:
-          name: dist
-          path: dist/
-          retention-days: 7
-
-  # ── Publish ─────────────────────────────────────────────────────────────
-  # Runs only on v* tags (e.g. v0.2.0). Uses PyPI Trusted Publishing (OIDC)
-  # — no API tokens stored in repository secrets.
-  #
-  # One-time setup required on PyPI:
-  #   1. Go to https://pypi.org/manage/account/publishing/
-  #   2. Add a new publisher:
-  #        PyPI project name : devcoach
-  #        Owner             : UltimaPhoenix
-  #        Repository name   : dev-coach
-  #        Workflow filename  : ci.yml
-  #        Environment name  : pypi
-  publish:
-    name: Publish to PyPI
-    if: startsWith(github.ref, 'refs/tags/v')
-    needs: build
-    runs-on: ubuntu-latest
-    environment:
-      name: pypi
-      url: https://pypi.org/p/devcoach
-    permissions:
-      id-token: write   # required for OIDC trusted publishing
-    steps:
-      - uses: actions/download-artifact@v8
-        with:
-          name: dist
-          path: dist/
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
-
-  # ── GitHub Release ──────────────────────────────────────────────────────
-  # Creates a GitHub Release with the built distribution attached.
-  release:
-    name: Create GitHub Release
-    if: startsWith(github.ref, 'refs/tags/v')
-    needs: publish
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/download-artifact@v8
-        with:
-          name: dist
-          path: dist/
-      - name: Create release
-        uses: softprops/action-gh-release@v3
-        with:
-          files: dist/*
-          generate_release_notes: true
-          fail_on_unmatched_files: true