diffron 0.1.0__tar.gz → 0.1.2__tar.gz

{diffron-0.1.0 → diffron-0.1.2}/MANIFEST.in

@@ -1,19 +1,17 @@
-include LICENSE
-include README.md
-include CHANGELOG.md
-include requirements.txt
-include pyproject.toml
-
-recursive-include diffron *.py *.pyi py.typed
-recursive-include docs *.md
-recursive-include hooks *.py
-
-exclude tests
-exclude hooks/prepare-commit-msg
-exclude hooks/prepare-commit-msg-global.py
-exclude hooks/prepare-commit-msg.py
-exclude *.bat
-exclude *.code-workspace
-exclude sync-*.txt
-exclude .gitignore
-exclude .sorana
+include LICENSE
+include README.md
+include CHANGELOG.md
+include requirements.txt
+include pyproject.toml
+
+recursive-include diffron *.py *.pyi py.typed
+recursive-include diffron/hooks *
+recursive-include docs *.md
+
+exclude tests
+exclude hooks
+exclude *.bat
+exclude *.code-workspace
+exclude sync-*.txt
+exclude .gitignore
+exclude .sorana

{diffron-0.1.0/diffron.egg-info → diffron-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: diffron
-Version: 0.1.0
+Version: 0.1.2
 Summary: Git commit message and PR description generator using Lemonade
 Home-page: https://github.com/diffron/diffron
 Author: Diffron Contributors
@@ -45,7 +45,7 @@ Dynamic: requires-python
 
 Git commit message and PR description generator using AMD Lemonade via lemonade-python-sdk.
 
-**This is a demo project showcasing the lemonade-python-sdk - submitted to the AMD Lemonade Developer Challenge 2026.**
+**Diffron is a production-ready reference implementation of the lemonade-python-sdk — submitted to the AMD Lemonade Developer Challenge 2026.**
 
 ![Version](https://img.shields.io/badge/version-0.1.0-blue)
 ![Python](https://img.shields.io/badge/python-3.9+-blue)
@@ -243,12 +243,12 @@ client = DiffronClient(model="your-model-name")
 
 | Project | Description |
 |---------|-------------|
-| **lemonade-python-sdk** | 🍋 **AMD Lemonade Challenge Submission** - Python SDK for AMD Lemonade API |
-| **Diffron** | Demo project showcasing lemonade-python-sdk (this repo) |
-| **Aicono** | AI Assistant (Desktop App) |
-| **TabNeuron** | Browser Connector / Memory |
-| **Sorana** | Advanced AI Interface |
-| **RyzenPilot** | Hardware Optimization |
+| [**lemonade-python-sdk**](https://github.com/Tetramatrix/lemonade-python-sdk) | 🍋 **AMD Lemonade Challenge Submission** - Python SDK for AMD Lemonade API |
+| [**Diffron**](https://pypi.org/project/diffron/) | Production-ready reference implementation using lemonade-python-sdk (this repo) |
+| [**Aicono**](https://tetramatrix.github.io/Aicono/) | AI Assistant (Desktop App) |
+| [**TabNeuron**](https://tetramatrix.github.io/TabNeuron/) | Browser Connector / Memory |
+| [**Sorana**](https://tetramatrix.github.io/Sorana/) | Advanced AI Interface |
+| [**RyzenZPilot**](https://tetramatrix.github.io/RyzenZPilot/) | Hardware Optimization |
 
 **Note:** Lemonade is AMD's local LLM server for Ryzen AI PCs. Diffron uses `lemonade-python-sdk` to communicate with Lemonade's API.
 

{diffron-0.1.0 → diffron-0.1.2}/README.md

@@ -2,7 +2,7 @@
 
 Git commit message and PR description generator using AMD Lemonade via lemonade-python-sdk.
 
-**This is a demo project showcasing the lemonade-python-sdk - submitted to the AMD Lemonade Developer Challenge 2026.**
+**Diffron is a production-ready reference implementation of the lemonade-python-sdk — submitted to the AMD Lemonade Developer Challenge 2026.**
 
 ![Version](https://img.shields.io/badge/version-0.1.0-blue)
 ![Python](https://img.shields.io/badge/python-3.9+-blue)
@@ -200,12 +200,12 @@ client = DiffronClient(model="your-model-name")
 
 | Project | Description |
 |---------|-------------|
-| **lemonade-python-sdk** | 🍋 **AMD Lemonade Challenge Submission** - Python SDK for AMD Lemonade API |
-| **Diffron** | Demo project showcasing lemonade-python-sdk (this repo) |
-| **Aicono** | AI Assistant (Desktop App) |
-| **TabNeuron** | Browser Connector / Memory |
-| **Sorana** | Advanced AI Interface |
-| **RyzenPilot** | Hardware Optimization |
+| [**lemonade-python-sdk**](https://github.com/Tetramatrix/lemonade-python-sdk) | 🍋 **AMD Lemonade Challenge Submission** - Python SDK for AMD Lemonade API |
+| [**Diffron**](https://pypi.org/project/diffron/) | Production-ready reference implementation using lemonade-python-sdk (this repo) |
+| [**Aicono**](https://tetramatrix.github.io/Aicono/) | AI Assistant (Desktop App) |
+| [**TabNeuron**](https://tetramatrix.github.io/TabNeuron/) | Browser Connector / Memory |
+| [**Sorana**](https://tetramatrix.github.io/Sorana/) | Advanced AI Interface |
+| [**RyzenZPilot**](https://tetramatrix.github.io/RyzenZPilot/) | Hardware Optimization |
 
 **Note:** Lemonade is AMD's local LLM server for Ryzen AI PCs. Diffron uses `lemonade-python-sdk` to communicate with Lemonade's API.
 

{diffron-0.1.0 → diffron-0.1.2}/diffron/git_hooks.py

@@ -19,7 +19,7 @@ PYTHON_HOOK_NAME = "prepare-commit-msg.py"
 
 # Get the hooks directory (where the template hooks are stored)
 DIFFRON_PACKAGE_DIR = Path(__file__).parent
-HOOKS_TEMPLATE_DIR = DIFFRON_PACKAGE_DIR.parent / "hooks"
+HOOKS_TEMPLATE_DIR = DIFFRON_PACKAGE_DIR / "hooks"
 
 
 def install_hooks(

diffron-0.1.2/diffron/hooks/prepare-commit-msg

@@ -0,0 +1,13 @@
+#!/bin/sh
+# Diffron prepare-commit-msg hook wrapper for Windows (Git Bash)
+# This file should be placed in .git/hooks/prepare-commit-msg (no extension)
+
+# Get the directory where this wrapper script is located (Unix-style path)
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Convert Unix path to Windows path for Python using cygpath
+# Git Bash on Windows uses /d/... but Windows needs D:\...
+PYTHON_SCRIPT="$(cygpath -w "$SCRIPT_DIR/prepare-commit-msg.py" 2>/dev/null || echo "$SCRIPT_DIR/prepare-commit-msg.py")"
+
+# Run the Python script
+python "$PYTHON_SCRIPT" "$1" "$2"

diffron-0.1.2/diffron/hooks/prepare-commit-msg-global.py

@@ -0,0 +1,59 @@
+#!/usr/bin/env python
+"""
+Diffron prepare-commit-msg Git hook.
+
+Automatically generates commit messages using Lemonade LLM.
+Installed globally by Diffron.
+"""
+
+import sys
+import os
+
+# Import diffron from installed package (no path manipulation needed)
+from diffron.commit_gen import generate_commit_message
+from diffron.lemonade import is_lemonade_running
+
+
+def main():
+    """Main hook entry point."""
+    # Parse arguments
+    if len(sys.argv) < 2:
+        print("Error: Missing commit message file argument", file=sys.stderr)
+        sys.exit(1)
+
+    commit_msg_file = sys.argv[1]
+    commit_source = sys.argv[2] if len(sys.argv) > 2 else ""
+
+    # Skip for merges, rebases, and amend commits
+    skip_sources = {"merge", "squash", "commit"}
+    if commit_source in skip_sources:
+        sys.exit(0)
+
+    # Check if Lemonade is running
+    if not is_lemonade_running():
+        # Silently exit if Lemonade not running - let user commit manually
+        sys.exit(0)
+
+    try:
+        # Generate commit message
+        commit_message = generate_commit_message()
+
+        if commit_message:
+            # Write to commit message file
+            with open(commit_msg_file, "w", encoding="utf-8") as f:
+                f.write(commit_message)
+    except Exception as e:
+        # Log error but don't block commit
+        error_msg = f"# Diffron error: {e}\n"
+        try:
+            with open(commit_msg_file, "a", encoding="utf-8") as f:
+                f.write(error_msg)
+        except Exception:
+            pass
+        sys.exit(0)  # Don't block commit on error
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

diffron-0.1.2/diffron/hooks/prepare-commit-msg.py

@@ -0,0 +1,101 @@
+#!/usr/bin/env python
+"""
+Diffron prepare-commit-msg Git hook.
+
+Automatically generates commit messages using Lemonade LLM.
+Installed globally by Diffron.
+"""
+
+import sys
+import os
+import urllib.request
+import urllib.error
+
+# Import diffron from installed package (no path manipulation needed)
+from diffron.commit_gen import generate_commit_message
+from diffron.lemonade import get_lemonade_url
+
+
+def is_lemonade_api_responsive(url: str, timeout: float = 10.0) -> bool:
+    """
+    Check if Lemonade API actually responds (not just port open).
+
+    Args:
+        url: Lemonade server URL.
+        timeout: Request timeout in seconds (10s to allow for slow startup).
+
+    Returns:
+        True if API responds successfully.
+    """
+    try:
+        # Try /api/v1/models endpoint
+        models_url = f"{url}/api/v1/models"
+        req = urllib.request.Request(models_url)
+        with urllib.request.urlopen(req, timeout=timeout) as response:
+            if response.status == 200:
+                return True
+    except (urllib.error.URLError, urllib.error.HTTPError, TimeoutError, OSError):
+        pass
+
+    # Fallback: try root endpoint
+    try:
+        req = urllib.request.Request(url)
+        with urllib.request.urlopen(req, timeout=timeout) as response:
+            return response.status == 200
+    except (urllib.error.URLError, urllib.error.HTTPError, TimeoutError, OSError):
+        pass
+
+    return False
+
+
+def main():
+    """Main hook entry point."""
+    # Parse arguments
+    if len(sys.argv) < 2:
+        print("Error: Missing commit message file argument", file=sys.stderr)
+        sys.exit(1)
+
+    commit_msg_file = sys.argv[1]
+    commit_source = sys.argv[2] if len(sys.argv) > 2 else ""
+
+    # Skip for merges, rebases, and amend commits
+    skip_sources = {"merge", "squash", "commit"}
+    if commit_source in skip_sources:
+        sys.exit(0)
+
+    # Change to the repository directory (where git commit was run)
+    repo_dir = os.path.dirname(os.path.abspath(commit_msg_file))
+    # Navigate up from .git/COMMIT_EDITMSG to repo root
+    if os.path.basename(repo_dir) == ".git":
+        repo_dir = os.path.dirname(repo_dir)
+    os.chdir(repo_dir)
+
+    # Get Lemonade URL and check if API is actually responsive
+    lemonade_url = get_lemonade_url()
+    if not is_lemonade_api_responsive(lemonade_url):
+        # Silently exit if Lemonade not responding - let user commit manually
+        sys.exit(0)
+
+    try:
+        # Generate commit message
+        commit_message = generate_commit_message()
+
+        if commit_message:
+            # Write to commit message file
+            with open(commit_msg_file, "w", encoding="utf-8") as f:
+                f.write(commit_message)
+    except Exception as e:
+        # Log error but don't block commit
+        error_msg = f"# Diffron error: {e}\n"
+        try:
+            with open(commit_msg_file, "a", encoding="utf-8") as f:
+                f.write(error_msg)
+        except Exception:
+            pass
+        sys.exit(0)  # Don't block commit on error
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

{diffron-0.1.0 → diffron-0.1.2/diffron.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: diffron
-Version: 0.1.0
+Version: 0.1.2
 Summary: Git commit message and PR description generator using Lemonade
 Home-page: https://github.com/diffron/diffron
 Author: Diffron Contributors
@@ -45,7 +45,7 @@ Dynamic: requires-python
 
 Git commit message and PR description generator using AMD Lemonade via lemonade-python-sdk.
 
-**This is a demo project showcasing the lemonade-python-sdk - submitted to the AMD Lemonade Developer Challenge 2026.**
+**Diffron is a production-ready reference implementation of the lemonade-python-sdk — submitted to the AMD Lemonade Developer Challenge 2026.**
 
 ![Version](https://img.shields.io/badge/version-0.1.0-blue)
 ![Python](https://img.shields.io/badge/python-3.9+-blue)
@@ -243,12 +243,12 @@ client = DiffronClient(model="your-model-name")
 
 | Project | Description |
 |---------|-------------|
-| **lemonade-python-sdk** | 🍋 **AMD Lemonade Challenge Submission** - Python SDK for AMD Lemonade API |
-| **Diffron** | Demo project showcasing lemonade-python-sdk (this repo) |
-| **Aicono** | AI Assistant (Desktop App) |
-| **TabNeuron** | Browser Connector / Memory |
-| **Sorana** | Advanced AI Interface |
-| **RyzenPilot** | Hardware Optimization |
+| [**lemonade-python-sdk**](https://github.com/Tetramatrix/lemonade-python-sdk) | 🍋 **AMD Lemonade Challenge Submission** - Python SDK for AMD Lemonade API |
+| [**Diffron**](https://pypi.org/project/diffron/) | Production-ready reference implementation using lemonade-python-sdk (this repo) |
+| [**Aicono**](https://tetramatrix.github.io/Aicono/) | AI Assistant (Desktop App) |
+| [**TabNeuron**](https://tetramatrix.github.io/TabNeuron/) | Browser Connector / Memory |
+| [**Sorana**](https://tetramatrix.github.io/Sorana/) | Advanced AI Interface |
+| [**RyzenZPilot**](https://tetramatrix.github.io/RyzenZPilot/) | Hardware Optimization |
 
 **Note:** Lemonade is AMD's local LLM server for Ryzen AI PCs. Diffron uses `lemonade-python-sdk` to communicate with Lemonade's API.
 

{diffron-0.1.0 → diffron-0.1.2}/diffron.egg-info/SOURCES.txt

@@ -28,12 +28,19 @@ diffron.egg-info/dependency_links.txt
 diffron.egg-info/entry_points.txt
 diffron.egg-info/requires.txt
 diffron.egg-info/top_level.txt
+diffron/hooks/aipr.py
+diffron/hooks/prepare-commit-msg
+diffron/hooks/prepare-commit-msg-global.py
+diffron/hooks/prepare-commit-msg.py
 docs/HOOKS.md
 docs/PLAN.md
 docs/PYPI_RELEASE.md
 docs/SETUP.md
 docs/USAGE.md
 hooks/aipr.py
+hooks/prepare-commit-msg
+hooks/prepare-commit-msg-global.py
+hooks/prepare-commit-msg.py
 tests/test_commit_gen.py
 tests/test_git_hooks.py
 tests/test_lemonade.py

{diffron-0.1.0 → diffron-0.1.2}/diffron.egg-info/top_level.txt

@@ -1,5 +1,6 @@
 diffron
 dist
 docs
+hooks
 internal
 mvp

{diffron-0.1.0 → diffron-0.1.2}/docs/HOOKS.md

@@ -164,13 +164,18 @@ C:\Users\YourName\.diffron-hooks\
 #### prepare-commit-msg (Shell Wrapper)
 
 ```bash
-#!/C:/Program Files/Git/usr/bin/sh.exe
-# Diffron prepare-commit-msg hook wrapper
+#!/bin/sh
+# Diffron prepare-commit-msg hook wrapper for Windows (Git Bash)
 
-# Get the directory where this wrapper script is located
-HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
-python "$HOOK_DIR/prepare-commit-msg.py" "$1" "$2"
-exit 0
+# Get the directory where this wrapper script is located (Unix-style path)
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Convert Unix path to Windows path for Python using cygpath
+# Git Bash on Windows uses /d/... but Windows needs D:\...
+PYTHON_SCRIPT="$(cygpath -w "$SCRIPT_DIR/prepare-commit-msg.py" 2>/dev/null || echo "$SCRIPT_DIR/prepare-commit-msg.py")"
+
+# Run the Python script
+python "$PYTHON_SCRIPT" "$1" "$2"
 ```
 
 **Purpose:** Git for Windows executes this shell script, which delegates to Python.
@@ -179,6 +184,7 @@ exit 0
 - Git for Windows uses bundled Git Bash
 - Python may not be in Git Bash PATH
 - Wrapper ensures correct Python interpreter is used
+- **cygpath** converts Unix-style paths (`/d/...`) to Windows paths (`D:\...`)
 
 #### prepare-commit-msg.py (Python Hook)
 
@@ -417,6 +423,102 @@ git commit -m "test"
 
 ---
 
+## Troubleshooting
+
+### Hooks werden nicht ausgeführt
+
+**Symptom:** `git commit` öffnet den Editor ohne generierte Message.
+
+**Ursache 1: Lokaler `core.hooksPath` überschreibt globalen Wert**
+
+```bash
+# Prüfen ob lokaler hooksPath gesetzt ist
+git config core.hooksPath
+
+# Wenn Output leer ist ("core.hooksPath="), wurde er auf leer gesetzt
+# Das deaktiviert Hooks komplett!
+
+# Lösung: Lokalen Wert entfernen
+git config --unset core.hooksPath
+
+# Verifizieren: Sollte jetzt keinen Output geben
+git config core.hooksPath
+```
+
+**Ursache 2: Backup hat fehlerhafte Konfiguration wiederhergestellt**
+
+Nach dem Einspielen eines Backups kann die `.git/config` einen leeren `core.hooksPath=` enthalten.
+
+**Lösung nach Backup:**
+```bash
+cd path/to/repo
+git config --unset core.hooksPath
+git commit  # Testen ob Hook funktioniert
+```
+
+**Ursache 3: Wrapper-Pfad-Konvertierung fehlgeschlagen**
+
+Der Shell-Wrapper muss Unix-Pfade (`/d/...`) zu Windows-Pfaden (`D:\...`) konvertieren.
+
+**Lösung:** Stelle sicher dass der Wrapper `cygpath` verwendet:
+```bash
+#!/bin/sh
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PYTHON_SCRIPT="$(cygpath -w "$SCRIPT_DIR/prepare-commit-msg.py" 2>/dev/null || echo "$SCRIPT_DIR/prepare-commit-msg.py")"
+python "$PYTHON_SCRIPT" "$1" "$2"
+```
+
+### Lemonade antwortet nicht / ist langsam
+
+**Symptom:** Hook schreibt keine Message, Commit erfordert manuelle Eingabe.
+
+**Ursache:** Lemonade Server ist nicht erreichbar oder antwortet zu langsam.
+
+**Lösung:**
+1. Prüfen ob Lemonade läuft: `http://localhost:8020` im Browser öffnen
+2. Hook-Timeout erhöhen (Standard: 10 Sekunden):
+   ```python
+   # In prepare-commit-msg.py
+   def is_lemonade_api_responsive(url: str, timeout: float = 10.0) -> bool:
+   ```
+
+### "No staged changes" Fehler im Log
+
+**Symptom:** Hook wird ausgeführt, aber generiert keine Message.
+
+**Ursache:** Der Hook prüft den git diff im aktuellen Arbeitsverzeichnis, nicht im Hook-Kontext.
+
+**Lösung:** Der Hook wechselt automatisch ins Repository-Verzeichnis. Stelle sicher dass:
+```python
+# Change to the repository directory
+repo_dir = os.path.dirname(os.path.abspath(commit_msg_file))
+if os.path.basename(repo_dir) == ".git":
+    repo_dir = os.path.dirname(repo_dir)
+os.chdir(repo_dir)
+```
+
+### Globale vs. Lokale Hooks
+
+**Frage:** Soll ich globale oder lokale Hooks verwenden?
+
+**Empfehlung:** Verwende **globale Hooks** für konsistentes Verhalten:
+```bash
+git config --global core.hooksPath "C:/Users/YourName/.diffron-hooks"
+```
+
+**Vorteile:**
+- Einmal installieren, überall verfügbar
+- Backup von `.git/config` beeinflusst Hooks nicht
+- Konsistentes Verhalten über alle Repositories
+
+**Nach Backup prüfen:**
+```bash
+git config --global core.hooksPath  # Sollte Pfad anzeigen
+git config core.hooksPath           # Sollte leer sein (kein Output)
+```
+
+---
+
 ## Hook Lifecycle
 
 ### Installation
@@ -438,5 +540,5 @@ git commit -m "test"
 
 ---
 
-*Last updated: 2026-03-28*
+*Last updated: 2026-03-29*
 *Version: 0.1.0*

{diffron-0.1.0 → diffron-0.1.2}/docs/SETUP.md

@@ -2,7 +2,7 @@
 
 Complete installation guide for Diffron on Windows with AMD Lemonade and GitHub Desktop.
 
-**Diffron is a demo project showcasing the lemonade-python-sdk - submitted to the AMD Lemonade Developer Challenge 2026.**
+**Diffron is a production-ready reference implementation of the lemonade-python-sdk — submitted to the AMD Lemonade Developer Challenge 2026.**
 
 ---
 

diffron-0.1.2/hooks/aipr.py

@@ -0,0 +1,96 @@
+#!/usr/bin/env python
+"""
+Diffron PR Description Generator (aipr).
+
+Generates GitHub PR title and description from branch changes.
+Run this script manually when ready to create a PR.
+
+Usage:
+    python aipr.py [branch] [base]
+
+    branch: Branch to analyze (default: current branch)
+    base: Base branch to compare against (default: main/master)
+
+Example:
+    python aipr.py feature/my-feature main
+"""
+
+import sys
+import os
+import subprocess
+
+# Add parent directory to path to import diffron
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from diffron.pr_gen import generate_pr_description, create_github_pr
+from diffron.lemonade import is_lemonade_running
+
+
+def check_gh_cli() -> bool:
+    """Check if GitHub CLI is available."""
+    try:
+        result = subprocess.run(
+            ["gh", "--version"],
+            capture_output=True,
+            text=True,
+            timeout=10,
+        )
+        return result.returncode == 0
+    except (subprocess.SubprocessError, FileNotFoundError):
+        return False
+
+
+def main():
+    """Main entry point."""
+    # Parse arguments
+    branch = sys.argv[1] if len(sys.argv) > 1 else None
+    base = sys.argv[2] if len(sys.argv) > 2 else None
+
+    # Check if Lemonade is running
+    if not is_lemonade_running():
+        print(
+            "Error: Lemonade server is not running.",
+            file=sys.stderr
+        )
+        print(
+            "Please start Lemonade first (e.g., 'lemonade serve').",
+            file=sys.stderr
+        )
+        sys.exit(1)
+
+    try:
+        # Generate PR description
+        print("Analyzing branch changes...")
+        pr = generate_pr_description(branch=branch, base=base)
+
+        # Output result
+        print("\n" + "=" * 60)
+        print(pr.format_output())
+        print("=" * 60 + "\n")
+
+        # Check if gh CLI is available
+        if check_gh_cli():
+            response = input("Create PR on GitHub now? (y/n): ").strip().lower()
+            if response in ("y", "yes"):
+                print("Creating PR...")
+                create_github_pr(branch=branch, base=base, auto_submit=True)
+                print("PR created successfully!")
+        else:
+            print(
+                "Tip: Install GitHub CLI (gh) to auto-create PRs: "
+                "https://cli.github.com/"
+            )
+
+    except ValueError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+    except ConnectionError as e:
+        print(f"Connection error: {e}", file=sys.stderr)
+        sys.exit(1)
+    except KeyboardInterrupt:
+        print("\nCancelled.")
+        sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

diffron-0.1.2/hooks/prepare-commit-msg

@@ -0,0 +1,13 @@
+#!/bin/sh
+# Diffron prepare-commit-msg hook wrapper for Windows (Git Bash)
+# This file should be placed in .git/hooks/prepare-commit-msg (no extension)
+
+# Get the directory where this wrapper script is located (Unix-style path)
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Convert Unix path to Windows path for Python using cygpath
+# Git Bash on Windows uses /d/... but Windows needs D:\...
+PYTHON_SCRIPT="$(cygpath -w "$SCRIPT_DIR/prepare-commit-msg.py" 2>/dev/null || echo "$SCRIPT_DIR/prepare-commit-msg.py")"
+
+# Run the Python script
+python "$PYTHON_SCRIPT" "$1" "$2"

diffron-0.1.2/hooks/prepare-commit-msg-global.py

@@ -0,0 +1,59 @@
+#!/usr/bin/env python
+"""
+Diffron prepare-commit-msg Git hook.
+
+Automatically generates commit messages using Lemonade LLM.
+Installed globally by Diffron.
+"""
+
+import sys
+import os
+
+# Import diffron from installed package (no path manipulation needed)
+from diffron.commit_gen import generate_commit_message
+from diffron.lemonade import is_lemonade_running
+
+
+def main():
+    """Main hook entry point."""
+    # Parse arguments
+    if len(sys.argv) < 2:
+        print("Error: Missing commit message file argument", file=sys.stderr)
+        sys.exit(1)
+
+    commit_msg_file = sys.argv[1]
+    commit_source = sys.argv[2] if len(sys.argv) > 2 else ""
+
+    # Skip for merges, rebases, and amend commits
+    skip_sources = {"merge", "squash", "commit"}
+    if commit_source in skip_sources:
+        sys.exit(0)
+
+    # Check if Lemonade is running
+    if not is_lemonade_running():
+        # Silently exit if Lemonade not running - let user commit manually
+        sys.exit(0)
+
+    try:
+        # Generate commit message
+        commit_message = generate_commit_message()
+
+        if commit_message:
+            # Write to commit message file
+            with open(commit_msg_file, "w", encoding="utf-8") as f:
+                f.write(commit_message)
+    except Exception as e:
+        # Log error but don't block commit
+        error_msg = f"# Diffron error: {e}\n"
+        try:
+            with open(commit_msg_file, "a", encoding="utf-8") as f:
+                f.write(error_msg)
+        except Exception:
+            pass
+        sys.exit(0)  # Don't block commit on error
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

diffron-0.1.2/hooks/prepare-commit-msg.py

@@ -0,0 +1,101 @@
+#!/usr/bin/env python
+"""
+Diffron prepare-commit-msg Git hook.
+
+Automatically generates commit messages using Lemonade LLM.
+Installed globally by Diffron.
+"""
+
+import sys
+import os
+import urllib.request
+import urllib.error
+
+# Import diffron from installed package (no path manipulation needed)
+from diffron.commit_gen import generate_commit_message
+from diffron.lemonade import get_lemonade_url
+
+
+def is_lemonade_api_responsive(url: str, timeout: float = 10.0) -> bool:
+    """
+    Check if Lemonade API actually responds (not just port open).
+
+    Args:
+        url: Lemonade server URL.
+        timeout: Request timeout in seconds (10s to allow for slow startup).
+
+    Returns:
+        True if API responds successfully.
+    """
+    try:
+        # Try /api/v1/models endpoint
+        models_url = f"{url}/api/v1/models"
+        req = urllib.request.Request(models_url)
+        with urllib.request.urlopen(req, timeout=timeout) as response:
+            if response.status == 200:
+                return True
+    except (urllib.error.URLError, urllib.error.HTTPError, TimeoutError, OSError):
+        pass
+
+    # Fallback: try root endpoint
+    try:
+        req = urllib.request.Request(url)
+        with urllib.request.urlopen(req, timeout=timeout) as response:
+            return response.status == 200
+    except (urllib.error.URLError, urllib.error.HTTPError, TimeoutError, OSError):
+        pass
+
+    return False
+
+
+def main():
+    """Main hook entry point."""
+    # Parse arguments
+    if len(sys.argv) < 2:
+        print("Error: Missing commit message file argument", file=sys.stderr)
+        sys.exit(1)
+
+    commit_msg_file = sys.argv[1]
+    commit_source = sys.argv[2] if len(sys.argv) > 2 else ""
+
+    # Skip for merges, rebases, and amend commits
+    skip_sources = {"merge", "squash", "commit"}
+    if commit_source in skip_sources:
+        sys.exit(0)
+
+    # Change to the repository directory (where git commit was run)
+    repo_dir = os.path.dirname(os.path.abspath(commit_msg_file))
+    # Navigate up from .git/COMMIT_EDITMSG to repo root
+    if os.path.basename(repo_dir) == ".git":
+        repo_dir = os.path.dirname(repo_dir)
+    os.chdir(repo_dir)
+
+    # Get Lemonade URL and check if API is actually responsive
+    lemonade_url = get_lemonade_url()
+    if not is_lemonade_api_responsive(lemonade_url):
+        # Silently exit if Lemonade not responding - let user commit manually
+        sys.exit(0)
+
+    try:
+        # Generate commit message
+        commit_message = generate_commit_message()
+
+        if commit_message:
+            # Write to commit message file
+            with open(commit_msg_file, "w", encoding="utf-8") as f:
+                f.write(commit_message)
+    except Exception as e:
+        # Log error but don't block commit
+        error_msg = f"# Diffron error: {e}\n"
+        try:
+            with open(commit_msg_file, "a", encoding="utf-8") as f:
+                f.write(error_msg)
+        except Exception:
+            pass
+        sys.exit(0)  # Don't block commit on error
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

{diffron-0.1.0 → diffron-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "diffron"
-version = "0.1.0"
+version = "0.1.2"
 description = "Git commit message and PR description generator using Lemonade"
 readme = "README.md"
 license = {text = "MIT"}
@@ -55,10 +55,11 @@ Documentation = "https://github.com/diffron/diffron/docs"
 Repository = "https://github.com/diffron/diffron"
 
 [tool.setuptools.packages.find]
-exclude = ["tests", "hooks"]
+exclude = ["tests"]
 
 [tool.setuptools.package-data]
 diffron = ["py.typed"]
+"diffron.hooks" = ["*"]
 
 [tool.black]
 line-length = 100

{diffron-0.1.0 → diffron-0.1.2}/setup.py

@@ -1,64 +1,64 @@
-"""Setup script for Diffron package."""
-
-from setuptools import setup, find_packages
-
-with open("README.md", "r", encoding="utf-8") as fh:
-    long_description = fh.read()
-
-with open("requirements.txt", "r", encoding="utf-8") as fh:
-    requirements = [line.strip() for line in fh if line.strip() and not line.startswith("#")]
-
-setup(
-    name="diffron",
-    version="0.1.0",
-    author="Diffron Contributors",
-    author_email="diffron@example.com",
-    description="Git commit message and PR description generator using Lemonade",
-    long_description=long_description,
-    long_description_content_type="text/markdown",
-    url="https://github.com/diffron/diffron",
-    packages=find_packages(exclude=["tests", "hooks"]),
-    classifiers=[
-        "Development Status :: 3 - Alpha",
-        "Environment :: Console",
-        "Intended Audience :: Developers",
-        "License :: OSI Approved :: MIT License",
-        "Operating System :: Microsoft :: Windows",
-        "Operating System :: POSIX :: Linux",
-        "Operating System :: MacOS :: MacOS X",
-        "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.9",
-        "Programming Language :: Python :: 3.10",
-        "Programming Language :: Python :: 3.11",
-        "Programming Language :: Python :: 3.12",
-        "Topic :: Software Development :: Version Control :: Git",
-        "Topic :: Scientific/Engineering :: Artificial Intelligence",
-    ],
-    python_requires=">=3.9",
-    install_requires=[
-        "openai>=1.0.0",
-        "psutil>=5.9.0",
-    ],
-    extras_require={
-        "git": ["gitpython>=3.1.0"],
-        "dev": [
-            "pytest>=7.0.0",
-            "pytest-cov>=4.0.0",
-            "black>=23.0.0",
-            "isort>=5.12.0",
-            "mypy>=1.0.0",
-        ],
-    },
-    entry_points={
-        "console_scripts": [
-            "diffron-install-hooks=diffron.cli:install_hooks_cli",
-            "diffron-uninstall-hooks=diffron.cli:uninstall_hooks_cli",
-            "diffron-pr=diffron.cli:pr_description_cli",
-            "diffron-status=diffron.cli:status_cli",
-        ],
-    },
-    include_package_data=True,
-    package_data={
-        "diffron": ["py.typed"],
-    },
-)
+"""Setup script for Diffron package."""
+
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+with open("requirements.txt", "r", encoding="utf-8") as fh:
+    requirements = [line.strip() for line in fh if line.strip() and not line.startswith("#")]
+
+setup(
+    name="diffron",
+    version="0.1.2",
+    author="Diffron Contributors",
+    author_email="diffron@example.com",
+    description="Git commit message and PR description generator using Lemonade",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/diffron/diffron",
+    packages=find_packages(exclude=["tests", "hooks"]),
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Environment :: Console",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: Microsoft :: Windows",
+        "Operating System :: POSIX :: Linux",
+        "Operating System :: MacOS :: MacOS X",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Topic :: Software Development :: Version Control :: Git",
+        "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    ],
+    python_requires=">=3.9",
+    install_requires=[
+        "openai>=1.0.0",
+        "psutil>=5.9.0",
+    ],
+    extras_require={
+        "git": ["gitpython>=3.1.0"],
+        "dev": [
+            "pytest>=7.0.0",
+            "pytest-cov>=4.0.0",
+            "black>=23.0.0",
+            "isort>=5.12.0",
+            "mypy>=1.0.0",
+        ],
+    },
+    entry_points={
+        "console_scripts": [
+            "diffron-install-hooks=diffron.cli:install_hooks_cli",
+            "diffron-uninstall-hooks=diffron.cli:uninstall_hooks_cli",
+            "diffron-pr=diffron.cli:pr_description_cli",
+            "diffron-status=diffron.cli:status_cli",
+        ],
+    },
+    include_package_data=True,
+    package_data={
+        "diffron": ["py.typed"],
+    },
+)