execdiff-git-ai 1.0.0__py3-none-any.whl

execdiff_git_ai/__init__.py

@@ -0,0 +1,13 @@
+"""
+ExecDiff Git AI - Local-first tool for analyzing AI-driven code changes.
+
+This package provides tools to analyze Git diffs and assess the impact
+of changes made by AI coding assistants.
+"""
+
+__version__ = "1.0.0"
+__author__ = "Anup Moncy"
+
+from execdiff_git_ai.agent import run_agent, run_agent_with_ai
+
+__all__ = ["run_agent", "run_agent_with_ai"]

execdiff_git_ai/agent.py

@@ -0,0 +1,328 @@
+import subprocess
+import os
+import re
+
+def get_git_diff():
+    """Get the current git diff for unstaged changes."""
+    try:
+        result = subprocess.run(
+            ["git", "diff"],
+            capture_output=True,
+            text=True,
+            check=True
+        )
+        return result.stdout
+    except subprocess.CalledProcessError:
+        return "No git repository found or no changes detected."
+
+def parse_diff_stats(diff_text):
+    """Parse diff to get file-level statistics."""
+    files = {}
+    current_file = None
+    
+    for line in diff_text.split('\n'):
+        if line.startswith('diff --git'):
+            parts = line.split()
+            if len(parts) >= 4:
+                current_file = parts[3].replace('b/', '')
+                files[current_file] = {'added': 0, 'deleted': 0}
+        elif current_file and line.startswith('+') and not line.startswith('+++'):
+            files[current_file]['added'] += 1
+        elif current_file and line.startswith('-') and not line.startswith('---'):
+            files[current_file]['deleted'] += 1
+    
+    return files
+
+def detect_changed_symbols(diff_text):
+    """
+    Parse the diff and extract changed symbols (functions, classes, methods).
+    Returns a list of dictionaries with symbol info.
+    """
+    symbols = []
+    lines = diff_text.split('\n')
+    modified_functions = set()
+    
+    for i, line in enumerate(lines):
+        # Detect added/modified functions
+        if line.startswith('+') and ('def ' in line or 'class ' in line):
+            if 'def ' in line:
+                try:
+                    name = line.split('def ')[1].split('(')[0].strip()
+                    symbols.append({
+                        'name': name,
+                        'type': 'function',
+                        'change': 'added',
+                        'risk': 'LOW'
+                    })
+                except:
+                    pass
+            elif 'class ' in line:
+                try:
+                    name = line.split('class ')[1].split(':')[0].split('(')[0].strip()
+                    symbols.append({
+                        'name': name,
+                        'type': 'class',
+                        'change': 'added',
+                        'risk': 'LOW'
+                    })
+                except:
+                    pass
+        # Detect modified functions (lines that have @@ context)
+        elif line.startswith('@@'):
+            for j in range(i+1, min(i+15, len(lines))):
+                if lines[j].startswith('-') and 'def ' in lines[j]:
+                    try:
+                        name = lines[j].split('def ')[1].split('(')[0].strip()
+                        if name not in [s['name'] for s in symbols]:
+                            modified_functions.add(name)
+                    except:
+                        pass
+        # Detect variables
+        elif line.startswith('+') and '=' in line and 'def ' not in line and 'class ' not in line:
+            try:
+                var_name = line.split('=')[0].strip().replace('+', '').strip()
+                if var_name and not var_name.startswith('#') and var_name.isidentifier():
+                    symbols.append({
+                        'name': var_name,
+                        'type': 'variable',
+                        'change': 'added',
+                        'risk': 'LOW'
+                    })
+            except:
+                pass
+    
+    # Add modified functions to symbols
+    for func in modified_functions:
+        symbols.append({
+            'name': func,
+            'type': 'function',
+            'change': 'modified',
+            'risk': 'LOW'
+        })
+    
+    return symbols
+
+def format_table_row(col1, col2, col3):
+    """Format a table row with proper alignment."""
+    return f"{col1:<32} {col2:<20} {col3:>8}"
+
+def run_agent():
+    """Run the ExecDiff Git AI assessment (non-AI mode)."""
+    print("\n" + "="*30)
+    print("📊 File Change Assessment")
+    print("="*30)
+    
+    diff = get_git_diff()
+    
+    if not diff or diff == "No git repository found or no changes detected.":
+        print("(No changes detected)")
+        print("\n✅ Assessment complete!\n")
+        return
+    
+    file_stats = parse_diff_stats(diff)
+    
+    print(format_table_row("File", "+Lines", "-Lines"))
+    print("-" * 48)
+    for filename, stats in file_stats.items():
+        print(format_table_row(filename, str(stats['added']), str(stats['deleted'])))
+    
+    print("\n" + "-" * 32)
+    print()
+    
+    symbols = detect_changed_symbols(diff)
+    
+    print("="*80)
+    print("📋 Impact Summary")
+    print("="*80)
+    print(format_table_row("Symbol", "Change Type", "Risk"))
+    print("-" * 56)
+    
+    if symbols:
+        for symbol in symbols:
+            change_desc = f"{symbol['type']} {symbol['change']}"
+            print(format_table_row(symbol['name'], change_desc, symbol['risk']))
+    
+    print()
+    print("✅ Assessment complete!\n")
+
+def analyze_with_ollama(diff_text, symbols):
+    """
+    Use Ollama to analyze the git diff and provide AI-powered impact assessment.
+    """
+    try:
+        prompt = f"""Analyze these code changes and provide an impact assessment for each modified symbol.
+
+For each symbol, provide:
+- File: <filename>
+- Symbol: <name>
+- Impact: <LOW/MEDIUM/HIGH>
+- Summary: <one-line explanation of the change and its impact>
+
+Changed symbols to analyze: {', '.join([s['name'] for s in symbols])}
+
+Git Diff (first 2000 chars):
+{diff_text[:2000]}
+
+Format your response as:
+File: <filename> - Symbol: <name>
+Impact: <LOW/MEDIUM/HIGH>
+Summary: <explanation>
+"""
+        
+        result = subprocess.run(
+            ["ollama", "run", "llama2", prompt],
+            capture_output=True,
+            text=True,
+            timeout=60
+        )
+        
+        if result.returncode == 0:
+            return result.stdout
+        else:
+            return "AI analysis failed. Make sure Ollama is installed and running."
+    except FileNotFoundError:
+        return "Ollama not found. Install from https://ollama.ai/"
+    except subprocess.TimeoutExpired:
+        return "AI analysis timed out."
+    except Exception as e:
+        return f"AI analysis error: {str(e)}"
+
+def extract_impact_summary(ai_analysis):
+    """Extract a summary of changes from AI analysis."""
+    summary_lines = []
+    
+    # Count impacts
+    high_count = ai_analysis.count("Impact: HIGH")
+    medium_count = ai_analysis.count("Impact: MEDIUM")
+    low_count = ai_analysis.count("Impact: LOW")
+    
+    if high_count > 0:
+        summary_lines.append(f"🔴 {high_count} HIGH impact change(s)")
+    if medium_count > 0:
+        summary_lines.append(f"🟡 {medium_count} MEDIUM impact change(s)")
+    if low_count > 0:
+        summary_lines.append(f"🟢 {low_count} LOW impact change(s)")
+    
+    return summary_lines
+
+def extract_change_summary(ai_analysis, file_stats, symbols):
+    """Extract a user-facing summary by translating technical changes into business requirements."""
+    summary_lines = []
+    
+    # Parse AI analysis to extract business-level impacts
+    lines = ai_analysis.split('\n')
+    business_needs = []
+    
+    i = 0
+    while i < len(lines):
+        line = lines[i]
+        if "Impact: HIGH" in line:
+            # Extract the summary for this HIGH impact change
+            for j in range(i, min(i+10, len(lines))):
+                if "Summary:" in lines[j]:
+                    summary_text = lines[j].replace("Summary:", "").strip()
+                    # Combine with next lines if they're part of the summary
+                    k = j + 1
+                    while k < len(lines) and lines[k].strip() and not "Impact:" in lines[k] and not "File:" in lines[k]:
+                        summary_text += " " + lines[k].strip()
+                        k += 1
+                    if summary_text:
+                        business_needs.append(("critical", summary_text[:120]))
+                    break
+        i += 1
+    
+    # Count impact levels
+    high_count = ai_analysis.count("Impact: HIGH")
+    medium_count = ai_analysis.count("Impact: MEDIUM")
+    low_count = ai_analysis.count("Impact: LOW")
+    
+    # Extract file changes
+    total_files = len(file_stats)
+    total_added = sum(stats['added'] for stats in file_stats.values())
+    total_deleted = sum(stats['deleted'] for stats in file_stats.values())
+    
+    # Generate business/user-facing summary
+    if high_count > 0:
+        if business_needs:
+            requirement = business_needs[0][1]
+            summary_lines.append(f"🔴 Critical: {requirement}")
+        else:
+            summary_lines.append(f"🔴 Critical: {high_count} {'change' if high_count == 1 else 'changes'} requiring careful validation")
+    
+    if medium_count > 0:
+        summary_lines.append(f"🟡 Important: {medium_count} {'change' if medium_count == 1 else 'changes'} needing thorough testing and QA")
+    
+    if high_count == 0 and medium_count == 0 and low_count > 0:
+        summary_lines.append(f"🟢 Low Risk: {low_count} minor {'update' if low_count == 1 else 'updates'} with minimal system impact")
+    
+    # Add scope summary
+    if total_files > 0:
+        scope = f"Scope: {total_files} file{'s' if total_files != 1 else ''} affected in this change"
+        summary_lines.append(scope)
+    
+    return summary_lines
+
+def run_agent_with_ai():
+    """Run the ExecDiff Git AI assessment with AI analysis."""
+    print("\n" + "="*30)
+    print("📊 File Change Assessment")
+    print("="*30)
+    
+    diff = get_git_diff()
+    
+    if not diff or diff == "No git repository found or no changes detected.":
+        print("(No changes detected)")
+        print("\n✅ Assessment complete!\n")
+        return
+    
+    file_stats = parse_diff_stats(diff)
+    
+    print(format_table_row("File", "+Lines", "-Lines"))
+    print("-" * 48)
+    for filename, stats in file_stats.items():
+        print(format_table_row(filename, str(stats['added']), str(stats['deleted'])))
+    
+    print("\n" + "-" * 32)
+    print()
+    
+    symbols = detect_changed_symbols(diff)
+    
+    print("="*80)
+    print("📋 Impact Summary")
+    print("="*80)
+    print(format_table_row("Symbol", "Change Type", "Impact"))
+    print("-" * 56)
+    
+    if symbols:
+        for symbol in symbols:
+            change_desc = f"{symbol['type']} {symbol['change']}"
+            print(format_table_row(symbol['name'], change_desc, symbol['risk']))
+    
+    print()
+    
+    # AI Impact Assessment Section
+    if symbols:
+        print("="*80)
+        print("🤖 AI Impact Assessment")
+        print("="*80)
+        
+        ai_analysis = analyze_with_ollama(diff, symbols)
+        
+        # Extract and display business-facing summary
+        summary = extract_change_summary(ai_analysis, file_stats, symbols)
+        if summary:
+            print("\n📋 What Changed:")
+            for line in summary:
+                print(f"  {line}")
+            print()
+        
+        print("Detailed Analysis:\n")
+        print(ai_analysis)
+        
+        # Check for HIGH impact symbols and add warning
+        high_impact_count = ai_analysis.count("Impact: HIGH")
+        if high_impact_count > 0:
+            print("\n⚠️  ALERT: " + str(high_impact_count) + " critical " + ("change" if high_impact_count == 1 else "changes") + " detected!")
+            print("Please review carefully before deploying to production.\n")
+    
+    print("✅ Assessment complete!\n")

execdiff_git_ai/cli.py

@@ -0,0 +1,39 @@
+import argparse
+from execdiff_git_ai.agent import run_agent, run_agent_with_ai
+
+def scan():
+    """Run the ExecDiff Git AI assessment agent (non-AI mode)."""
+    print("🔍 ExecDiff Git AI: Starting impact assessment (non-AI mode)...\n")
+    run_agent()
+
+def scan_ai():
+    """Run the ExecDiff Git AI assessment agent with AI analysis (Ollama)."""
+    print("🤖 ExecDiff Git AI: Starting AI-powered impact assessment...\n")
+    run_agent_with_ai()
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="execdiff-git",
+        description="ExecDiff Git AI - Analyze AI-driven code changes"
+    )
+    subparsers = parser.add_subparsers(dest="command", required=True)
+    
+    scan_parser = subparsers.add_parser(
+        "scan",
+        help="Scan workspace and assess changes (non-AI mode)"
+    )
+    
+    scan_ai_parser = subparsers.add_parser(
+        "scan-ai",
+        help="Scan workspace with AI-powered analysis (requires Ollama)"
+    )
+    
+    args = parser.parse_args()
+    
+    if args.command == "scan":
+        scan()
+    elif args.command == "scan-ai":
+        scan_ai()
+
+if __name__ == "__main__":
+    main()

execdiff_git_ai-1.0.0.dist-info/METADATA

@@ -0,0 +1,287 @@
+Metadata-Version: 2.4
+Name: execdiff-git-ai
+Version: 1.0.0
+Summary: Local-first tool for analyzing AI-driven code changes. Analyzes Git diffs and assesses impact of changes made by AI coding assistants.
+Author-email: Anup Moncy <n93181165@gmail.com>
+License: Apache License
+        Version 2.0, January 2004
+        http://www.apache.org/licenses/
+        
+        Copyright 2025 Anup Moncy
+        
+        Licensed under the Apache License, Version 2.0 (the "License");
+        you may not use this file except in compliance with the License.
+        You may obtain a copy of the License at
+        
+            http://www.apache.org/licenses/LICENSE-2.0
+        
+        Unless required by applicable law or agreed to in writing, software
+        distributed under the License is distributed on an "AS IS" BASIS,
+        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+        See the License for the specific language governing permissions and
+        limitations under the License.
+        
+Project-URL: Homepage, https://github.com/yourusername/execdiff-git-ai
+Project-URL: Bug Tracker, https://github.com/yourusername/execdiff-git-ai/issues
+Project-URL: Documentation, https://github.com/yourusername/execdiff-git-ai#readme
+Keywords: git,ai,copilot,code-analysis,diff,impact-assessment,execdiff
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ExecDiff Git AI
+
+AI Impact Assessment for git changes - understand what your AI copilot changed before you commit it.
+
+## Overview
+
+ExecDiff Git AI is a Python CLI tool that helps developers understand the scope and implications of code changes made by AI coding assistants (like GitHub Copilot, Cursor, or Replit AI) by analyzing git diffs and extracting modified symbols (functions, classes, variables). It can optionally use a local LLM (Ollama) to assess the risk of each change.
+
+## Privacy
+
+ExecDiff Git AI runs **entirely locally**.
+
+- ✅ No code is uploaded
+- ✅ No cloud calls required
+- ✅ No telemetry
+- ✅ Works offline with local LLM (Ollama)
+- ✅ All analysis happens on your machine
+
+## Features
+
+- **Local-first**: Runs entirely on your machine with no cloud calls or telemetry
+- **Impact Assessment**: Detects specific changes to functions, classes, and variables and provides human-readable summaries
+- **AI-powered risk assessment**: Utilizes local Ollama for intelligent impact analysis and scoring (optional)
+- **CLI-first**: `execdiff-git scan` and `execdiff-git scan-ai`
+- **Works offline**, no telemetry
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8+
+- Git
+- Ollama (optional, for AI risk assessment)
+
+### Initial Setup
+
+Install from PyPI:
+
+```bash
+pip install execdiff-git-ai
+```
+
+## How to Use
+
+1. **Make your code change** (or let your AI copilot make changes)
+
+2. **Stage your changes with git**
+
+   ```bash
+   git add .
+   # For new files, you may need:
+   git add -N .
+   ```
+
+3. **Run the assessment (no AI)**
+
+   ```bash
+   execdiff-git scan
+   ```
+
+   Or, to use AI-powered risk assessment (requires Ollama):
+
+   ```bash
+   execdiff-git scan-ai
+   ```
+
+**Note**: For newly created files, you must run `git add -N .` (intent-to-add) so that `execdiff-git scan` or `execdiff-git scan-ai` can detect them. This is a git limitation for diff tools.
+
+## Usage
+
+### Basic Commands
+
+Analyze changes in the current repository:
+
+```bash
+execdiff-git scan
+```
+
+Analyze with AI-powered risk assessment:
+
+```bash
+execdiff-git scan-ai
+```
+
+### Example Output
+
+**Non-AI Mode:**
+
+```
+==============================
+📊 File Change Assessment
+==============================
+File                            +Lines  -Lines
+------------------------------------------------
+shopping_cart.py                     10       2
+checkout.py                           7       1
+email/notifications.py                5       0
+
+--------------------------------
+
+================================================================================
+📋 Impact Summary
+================================================================================
+Symbol                    Change Type          Impact  
+--------------------------------------------------------
+add_to_cart               function modified    MEDIUM  
+remove_from_cart          function modified    LOW     
+checkout                  function modified    HIGH    
+send_order_email          function added       LOW     
+
+✅ Assessment complete!
+```
+
+## Optional: Install Ollama for AI Risk Assessment
+
+Ollama enables intelligent risk scoring. Install and configure:
+
+```bash
+# macOS / Linux
+curl -fsSL https://ollama.ai/install.sh | sh
+
+# Or use Homebrew (macOS)
+brew install ollama
+
+# Pull the model
+ollama pull llama2
+
+# Start the server (runs on localhost:11434)
+ollama serve
+```
+
+With Ollama running, you'll also get AI-powered impact assessment:
+
+```
+==============================
+📊 File Change Assessment
+==============================
+File                            +Lines  -Lines
+------------------------------------------------
+shopping_cart.py                     10       2
+checkout.py                           7       1
+email/notifications.py                5       0
+
+--------------------------------
+
+================================================================================
+📋 Impact Summary
+================================================================================
+Symbol                    Change Type          Impact  
+--------------------------------------------------------
+add_to_cart               function modified    MEDIUM  
+remove_from_cart          function modified    LOW     
+checkout                  function modified    HIGH    
+send_order_email          function added       LOW     
+
+================================================================================
+🤖 AI Impact Assessment
+================================================================================
+
+📋 What Changed:
+  🔴 Critical: Checkout now supports Apple Pay, Google Pay, and PayPal in addition to credit cards, and changes the order completion flow. Payment processing reliability and customer purchase experience are directly affected.
+  🟡 Important: Cart logic now merges duplicate items and updates product quantities in one step. This changes how users see totals and manage products in their cart.
+  🟢 Low Risk: Order confirmation emails improved. Cart item removal is more reliable.
+
+  Scope: 3 files modified (22 additions, 3 removals)
+
+Detailed Analysis:
+
+File: shopping_cart.py - Symbol: add_to_cart
+Impact: MEDIUM
+Summary: Cart logic updated to better handle product quantities and merging duplicate items.
+
+File: shopping_cart.py - Symbol: remove_from_cart
+Impact: LOW
+Summary: Improved item removal to prevent accidental deletion of unrelated products.
+
+File: checkout.py - Symbol: checkout
+Impact: HIGH
+Summary: Checkout flow changed to support Apple Pay, Google Pay, PayPal, and credit cards, and to update order completion steps.
+
+File: email/notifications.py - Symbol: send_order_email
+Impact: LOW
+Summary: Confirmation emails are now sent after every successful order.
+
+⚠️  ALERT: 1 critical change detected!
+Please review carefully before deploying to production.
+
+✅ Assessment complete!
+```
+
+## How It Works
+
+1. **Reads git diff** - Gets all staged and unstaged changes
+2. **Extracts symbols** - Finds functions, classes, and variables
+3. **Detects change type** - Identifies what kind of change was made
+4. **Assesses impact** - Uses local AI (Ollama) or heuristics
+5. **Generates recommendations** - Suggests testing and review actions (AI mode only)
+6. **Advisory warnings** - Critical impact changes trigger warnings (AI mode only)
+
+## Development
+
+Install in editable mode:
+
+```bash
+git clone https://github.com/yourusername/execdiff-git-ai.git
+cd execdiff-git-ai
+pip install -e .
+```
+
+Run the CLI:
+
+```bash
+execdiff-git scan
+```
+
+## Programmatic Usage
+
+You can also use ExecDiff Git AI as a library:
+
+```python
+from execdiff_git_ai.agent import run_agent, run_agent_with_ai
+
+# Non-AI mode (default)
+run_agent()
+
+# AI-powered mode (optional, requires Ollama)
+run_agent_with_ai()
+```
+
+## License
+
+Apache-2.0
+
+## Author
+
+Anup Moncy (n93181165@gmail.com)
+
+## Contributing
+
+Contributions welcome! Please open an issue or submit a pull request.
+
+---
+
+**Note**: This is an early-stage project. The API and behavior are subject to change.

execdiff_git_ai-1.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+execdiff_git_ai/__init__.py,sha256=62BXbkuoc676h4xcROTEjOX_1UrZVT9Gs-z0KzKTcnI,353
+execdiff_git_ai/agent.py,sha256=iXp_9cwSYd8gaAxZCLXsrLH0wKV-8RzeBZPMoAQCte0,11432
+execdiff_git_ai/cli.py,sha256=SWcGF1VoBoS6nqiqjh1mKsqeX3vV6M56P85GhDzRUFs,1136
+execdiff_git_ai-1.0.0.dist-info/licenses/LICENSE,sha256=nWxRL_wvG4MC9-xRzs8pGP4eg1pD2b9xn8qe5XQHUbg,625
+execdiff_git_ai-1.0.0.dist-info/METADATA,sha256=g6jQFFQCgiWpN2Kf1ajCYqhuUU0J_CJytSJlXMuROgM,9002
+execdiff_git_ai-1.0.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+execdiff_git_ai-1.0.0.dist-info/entry_points.txt,sha256=lZY90eUNO6epjpDD5BveMjzs9_EmhCXn_7hQDDbw9v4,58
+execdiff_git_ai-1.0.0.dist-info/top_level.txt,sha256=rHUr4lfk-wUH7HHBXBtCMGDdH8QHCoG-5Hqmbe0kkqg,16
+execdiff_git_ai-1.0.0.dist-info/RECORD,,

execdiff_git_ai-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

execdiff_git_ai-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+execdiff-git = execdiff_git_ai.cli:main

execdiff_git_ai-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2025 Anup Moncy
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

execdiff_git_ai-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+execdiff_git_ai