devcoach 0.3.10__tar.gz → 0.3.12__tar.gz

{devcoach-0.3.10 → devcoach-0.3.12}/.github/workflows/ci.yml

@@ -257,11 +257,61 @@ jobs:
           path: dist/
       - uses: pypa/gh-action-pypi-publish@release/v1
 
+  # ── Build binaries ──────────────────────────────────────────────────────
+  # Builds PyInstaller single-file executables for all target platforms.
+  # Only runs on releases (tag push or workflow_dispatch) — not on PRs or main pushes.
+  build-binaries:
+    name: Build binary (${{ matrix.platform }})
+    needs: [bump, lint, test]
+    if: >
+      always()
+      && (needs.bump.result == 'success' || needs.bump.result == 'skipped')
+      && needs.lint.result == 'success'
+      && needs.test.result == 'success'
+      && (startsWith(github.ref, 'refs/tags/v') || github.event_name == 'workflow_dispatch')
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: darwin-arm64
+            runs-on: macos-latest
+          - platform: darwin-amd64
+            runs-on: macos-13
+          - platform: linux-amd64
+            runs-on: ubuntu-latest
+          - platform: linux-arm64
+            runs-on: ubuntu-24.04-arm
+    runs-on: ${{ matrix.runs-on }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ needs.bump.outputs.tag || github.ref }}
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - name: Install dependencies and PyInstaller
+        run: |
+          uv sync
+          uv pip install pyinstaller
+      - name: Build binary
+        run: uv run pyinstaller devcoach.spec --distpath dist
+      - name: Rename binary
+        run: mv dist/devcoach dist/devcoach-${{ matrix.platform }}
+      - uses: actions/upload-artifact@v7
+        with:
+          name: binary-${{ matrix.platform }}
+          path: dist/devcoach-${{ matrix.platform }}
+          retention-days: 7
+
   # ── 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'))
+    needs: [bump, publish, build-binaries]
+    if: >
+      always()
+      && needs.publish.result == 'success'
+      && needs.build-binaries.result == 'success'
+      && (needs.bump.result == 'success' || startsWith(github.ref, 'refs/tags/v'))
     runs-on: ubuntu-latest
     permissions:
       contents: write
@@ -273,9 +323,102 @@ jobs:
         with:
           name: dist
           path: dist/
+      - uses: actions/download-artifact@v8
+        with:
+          pattern: binary-*
+          merge-multiple: true
+          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
+
+  # ── Bump Homebrew formula ────────────────────────────────────────────────
+  # After a successful release, updates Formula/devcoach.rb in homebrew-tap
+  # with the new version and SHA256 hashes for all platform binaries.
+  # Requires secret HOMEBREW_TAP_TOKEN (classic PAT, repo scope on homebrew-tap).
+  bump-homebrew-formula:
+    name: Bump Homebrew formula
+    needs: [bump, github-release, build-binaries]
+    if: >
+      always()
+      && needs.github-release.result == 'success'
+      && needs.build-binaries.result == 'success'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          pattern: binary-*
+          merge-multiple: true
+          path: binaries/
+      - name: Compute SHA256 hashes
+        id: sha
+        run: |
+          echo "darwin_arm64=$(sha256sum binaries/devcoach-darwin-arm64 | cut -d' ' -f1)" >> "$GITHUB_OUTPUT"
+          echo "darwin_amd64=$(sha256sum binaries/devcoach-darwin-amd64 | cut -d' ' -f1)" >> "$GITHUB_OUTPUT"
+          echo "linux_amd64=$(sha256sum  binaries/devcoach-linux-amd64  | cut -d' ' -f1)" >> "$GITHUB_OUTPUT"
+          echo "linux_arm64=$(sha256sum  binaries/devcoach-linux-arm64  | cut -d' ' -f1)" >> "$GITHUB_OUTPUT"
+      - name: Clone homebrew-tap
+        run: |
+          git clone "https://x-access-token:${{ secrets.HOMEBREW_TAP_TOKEN }}@github.com/UltimaPhoenix/homebrew-tap.git" tap
+      - name: Update formula
+        env:
+          TAG: ${{ needs.bump.outputs.tag || github.ref_name }}
+          DARWIN_ARM64_SHA: ${{ steps.sha.outputs.darwin_arm64 }}
+          DARWIN_AMD64_SHA: ${{ steps.sha.outputs.darwin_amd64 }}
+          LINUX_AMD64_SHA:  ${{ steps.sha.outputs.linux_amd64 }}
+          LINUX_ARM64_SHA:  ${{ steps.sha.outputs.linux_arm64 }}
+        run: |
+          VERSION="${TAG#v}"
+          cat > tap/Formula/devcoach.rb << FORMULA
+          class Devcoach < Formula
+            desc "Progressive technical coaching MCP server for Claude Code and Claude Desktop"
+            homepage "https://github.com/UltimaPhoenix/dev-coach"
+            version "$VERSION"
+            license "Apache-2.0"
+
+            on_macos do
+              on_arm do
+                url "https://github.com/UltimaPhoenix/dev-coach/releases/download/$TAG/devcoach-darwin-arm64"
+                sha256 "$DARWIN_ARM64_SHA"
+              end
+              on_intel do
+                url "https://github.com/UltimaPhoenix/dev-coach/releases/download/$TAG/devcoach-darwin-amd64"
+                sha256 "$DARWIN_AMD64_SHA"
+              end
+            end
+
+            on_linux do
+              on_arm do
+                url "https://github.com/UltimaPhoenix/dev-coach/releases/download/$TAG/devcoach-linux-arm64"
+                sha256 "$LINUX_ARM64_SHA"
+              end
+              on_intel do
+                url "https://github.com/UltimaPhoenix/dev-coach/releases/download/$TAG/devcoach-linux-amd64"
+                sha256 "$LINUX_AMD64_SHA"
+              end
+            end
+
+            def install
+              binary = Dir["devcoach-*"].first
+              chmod 0755, binary
+              bin.install binary => "devcoach"
+            end
+
+            test do
+              assert_match "devcoach", shell_output("#{bin}/devcoach --help 2>&1")
+            end
+          end
+          FORMULA
+      - name: Commit and push
+        run: |
+          TAG="${{ needs.bump.outputs.tag || github.ref_name }}"
+          VERSION="${TAG#v}"
+          cd tap
+          git config user.name  "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Formula/devcoach.rb
+          git diff --cached --quiet || git commit -m "devcoach $VERSION"
+          git push

{devcoach-0.3.10 → devcoach-0.3.12}/.gitignore

@@ -31,6 +31,7 @@ MANIFEST
 #  before PyInstaller builds the exe, so as to inject date/other infos into it.
 *.manifest
 *.spec
+!devcoach.spec
 
 # Installer logs
 pip-log.txt

{devcoach-0.3.10 → devcoach-0.3.12}/CLAUDE.md

@@ -182,7 +182,7 @@ The `log_lesson` tool accepts this schema:
 {
   "id": "uuid-or-random-string",
   "timestamp": "2025-01-15T20:30:00Z",
-  "topic_id": "python_generators",
+  "topic_id": "python",
   "category": "python",
   "title": "Generator expressions vs list comprehensions",
   "level": "mid",

{devcoach-0.3.10 → devcoach-0.3.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devcoach
-Version: 0.3.10
+Version: 0.3.12
 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
@@ -262,15 +262,6 @@ flowchart TD
     E --> G
     G --> F([Done])
     G -.->|prompts| U(["You: ✅ ❌ ⏭"])
-
-    style loop fill:none,stroke:#AAAAAA,stroke-dasharray:5 5,color:#757575
-    classDef action fill:#D4E4D8,stroke:#8BAF96,color:#1E1E1E
-    classDef term   fill:#E8E8E4,stroke:#AAAAAA,color:#1E1E1E
-    classDef user   fill:#F5EDE3,stroke:#D4A27F,color:#1E1E1E
-
-    class B,D,E,G action
-    class A,F,Z term
-    class U user
 ```
 
 → [Full decision flow: session startup · lesson selection · depth calibration](https://ultimaphoenix.github.io/dev-coach/how-it-works/)
@@ -289,13 +280,21 @@ Everything runs **locally**. No data leaves your machine. One SQLite file at `~/
 
 ## Installation
 
-### Recommended — no permanent install needed
+### Homebrew (macOS / Linux)
+
+```bash
+brew tap UltimaPhoenix/tap && brew install devcoach
+```
+
+Pre-built native binaries — no Python required.
+
+### uvx — no permanent install needed
 
 ```bash
 uvx devcoach mcp   # starts the MCP server directly
 ```
 
-### Permanent install
+### uv tool — permanent install
 
 ```bash
 uv tool install devcoach
@@ -309,7 +308,7 @@ devcoach install
 
 Restart Claude Code or Claude Desktop after installing.
 
-> **Requirements:** [uv](https://docs.astral.sh/uv/) · Python 3.12+ · Claude Code or Claude Desktop
+> **Requirements (uvx/uv):** [uv](https://docs.astral.sh/uv/) · Python 3.12+ · Claude Code or Claude Desktop
 
 ---
 

{devcoach-0.3.10 → devcoach-0.3.12}/README.md

@@ -31,15 +31,6 @@ flowchart TD
     E --> G
     G --> F([Done])
     G -.->|prompts| U(["You: ✅ ❌ ⏭"])
-
-    style loop fill:none,stroke:#AAAAAA,stroke-dasharray:5 5,color:#757575
-    classDef action fill:#D4E4D8,stroke:#8BAF96,color:#1E1E1E
-    classDef term   fill:#E8E8E4,stroke:#AAAAAA,color:#1E1E1E
-    classDef user   fill:#F5EDE3,stroke:#D4A27F,color:#1E1E1E
-
-    class B,D,E,G action
-    class A,F,Z term
-    class U user
 ```
 
 → [Full decision flow: session startup · lesson selection · depth calibration](https://ultimaphoenix.github.io/dev-coach/how-it-works/)
@@ -58,13 +49,21 @@ Everything runs **locally**. No data leaves your machine. One SQLite file at `~/
 
 ## Installation
 
-### Recommended — no permanent install needed
+### Homebrew (macOS / Linux)
+
+```bash
+brew tap UltimaPhoenix/tap && brew install devcoach
+```
+
+Pre-built native binaries — no Python required.
+
+### uvx — no permanent install needed
 
 ```bash
 uvx devcoach mcp   # starts the MCP server directly
 ```
 
-### Permanent install
+### uv tool — permanent install
 
 ```bash
 uv tool install devcoach
@@ -78,7 +77,7 @@ devcoach install
 
 Restart Claude Code or Claude Desktop after installing.
 
-> **Requirements:** [uv](https://docs.astral.sh/uv/) · Python 3.12+ · Claude Code or Claude Desktop
+> **Requirements (uvx/uv):** [uv](https://docs.astral.sh/uv/) · Python 3.12+ · Claude Code or Claude Desktop
 
 ---
 

devcoach-0.3.12/devcoach.spec

@@ -0,0 +1,74 @@
+# -*- mode: python ; coding: utf-8 -*-
+import sys
+from pathlib import Path
+
+src = Path("src/devcoach")
+
+datas = [
+    (str(src / "SKILL.md"), "devcoach"),
+    (str(src / "web" / "templates"), "devcoach/web/templates"),
+    (str(src / "web" / "static"), "devcoach/web/static"),
+]
+
+hidden_imports = [
+    # pydantic-core is a compiled extension — ensure it's picked up
+    "pydantic_core",
+    "pydantic_core._pydantic_core",
+    # fastmcp / mcp internals that may be dynamically imported
+    "mcp",
+    "mcp.server",
+    "mcp.server.stdio",
+    "mcp.types",
+    # uvicorn needs these
+    "uvicorn.logging",
+    "uvicorn.loops",
+    "uvicorn.loops.auto",
+    "uvicorn.protocols",
+    "uvicorn.protocols.http",
+    "uvicorn.protocols.http.auto",
+    "uvicorn.protocols.websockets",
+    "uvicorn.protocols.websockets.auto",
+    "uvicorn.lifespan",
+    "uvicorn.lifespan.on",
+    # email / multipart used by starlette
+    "email.mime.multipart",
+    "email.mime.text",
+    "email.mime.base",
+    # sqlite3 is stdlib but needs explicit inclusion on some platforms
+    "sqlite3",
+    "_sqlite3",
+]
+
+a = Analysis(
+    ["src/devcoach/mcp/server.py"],
+    pathex=["src"],
+    binaries=[],
+    datas=datas,
+    hiddenimports=hidden_imports,
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[],
+    excludes=["tkinter", "matplotlib", "numpy", "scipy", "PIL"],
+    noarchive=False,
+)
+
+pyz = PYZ(a.pure)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.datas,
+    [],
+    name="devcoach",
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=False,
+    console=True,
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+)

{devcoach-0.3.10 → devcoach-0.3.12}/docs/how-it-works.md

@@ -25,13 +25,6 @@ flowchart LR
         D
         E
     end
-
-    style onboarding fill:none,stroke:#AAAAAA,stroke-dasharray:5 5,color:#757575
-    classDef action fill:#D4E4D8,stroke:#8BAF96,color:#1E1E1E
-    classDef term   fill:#E8E8E4,stroke:#AAAAAA,color:#1E1E1E
-
-    class C,D,E,F action
-    class A,G term
 ```
 
 ---
@@ -58,15 +51,6 @@ flowchart TD
     E --> G
     G --> F([Done])
     G -.->|prompts| U(["You: ✅ ❌ ⏭"])
-
-    style loop fill:none,stroke:#AAAAAA,stroke-dasharray:5 5,color:#757575
-    classDef action fill:#D4E4D8,stroke:#8BAF96,color:#1E1E1E
-    classDef term   fill:#E8E8E4,stroke:#AAAAAA,color:#1E1E1E
-    classDef user   fill:#F5EDE3,stroke:#D4A27F,color:#1E1E1E
-
-    class B,D,E,G action
-    class A,F,Z term
-    class U user
 ```
 
 ---

{devcoach-0.3.10 → devcoach-0.3.12}/docs/index.md

@@ -25,15 +25,6 @@ flowchart TD
     E --> G
     G --> F([Done])
     G -.->|prompts| U(["You: ✅ ❌ ⏭"])
-
-    style loop fill:none,stroke:#AAAAAA,stroke-dasharray:5 5,color:#757575
-    classDef action fill:#D4E4D8,stroke:#8BAF96,color:#1E1E1E
-    classDef term   fill:#E8E8E4,stroke:#AAAAAA,color:#1E1E1E
-    classDef user   fill:#F5EDE3,stroke:#D4A27F,color:#1E1E1E
-
-    class B,D,E,G action
-    class A,F,Z term
-    class U user
 ```
 
 → [Full decision flow: session startup · lesson selection · depth calibration](how-it-works.md)

{devcoach-0.3.10 → devcoach-0.3.12}/pyproject.toml

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

{devcoach-0.3.10 → devcoach-0.3.12}/sonar-project.properties

@@ -2,7 +2,7 @@ sonar.projectKey=UltimaPhoenix_dev-coach
 sonar.organization=ultimaphoenix
 
 sonar.projectName=devcoach
-sonar.projectVersion=0.3.10
+sonar.projectVersion=0.3.12
 
 sonar.sources=src
 sonar.tests=tests