🤖 AI Attribution Tools

Advanced AI-assisted commit detection and attribution management for GitHub development workflows.

Perfect for teams using VS Code Copilot, ChatGPT, Claude AI, and other AI coding assistants who need transparency and compliance in their development processes.

---

🎯 Why AI Attribution Tools?

As AI-assisted development becomes mainstream, proper attribution is crucial for:

• ✅ Compliance & Transparency - Clear audit trails for AI assistance
• ✅ Team Collaboration - Understanding AI vs. human contributions
• ✅ Quality Assurance - Tracking AI assistance patterns and effectiveness
• ✅ Legal Protection - Proper documentation for intellectual property
• ✅ Workflow Optimization - Analyzing AI development patterns

---

🚀 Quick Installation

Option 1: PowerShell Gallery (Recommended)

# Install for current user
Install-Module -Name AIAttributionTools -Scope CurrentUser

# Import and start using
Import-Module AIAttributionTools
Invoke-LLMCommitAnalysis

Option 2: VS Code Copilot Integration (Windows 11)

# One-click setup for VS Code + Copilot environments
irm https://raw.githubusercontent.com/thisis-romar/ai-attribution-tools/main/Install-AIAttributionTools.ps1 | iex

Option 3: Manual Installation

1. Download the latest release
2. Extract to $env:USERPROFILE\Documents\PowerShell\Modules\AIAttributionTools
3. Import: Import-Module AIAttributionTools

---

📊 Key Features

🔍 AI Detection Engine

• Advanced Scoring: 0-11+ point scale for AI likelihood assessment
• Pattern Recognition: 50+ AI commit indicators
• Multi-AI Support: GitHub Copilot, ChatGPT, Claude, Cursor, Tabnine, CodeWhisperer
• Statistical Analysis: Comprehensive reporting and trend detection

⚙️ Development Integration

• Zero API Costs: All analysis runs locally
• Privacy First: No data transmission or cloud dependencies
• Conventional Commits: Integration with standardized commit formats
• Git Integration: Automated commit author correction and attribution

🎯 Enterprise Ready

• CI/CD Integration: GitHub Actions, Azure DevOps, Jenkins support
• Team Analytics: Multi-repository analysis capabilities
• Compliance Reporting: Audit trails and documentation generation
• Custom Configuration: Flexible scoring thresholds and patterns

---

�� Basic Usage

Analyze Repository Commits

# Basic analysis of last 30 days
Invoke-LLMCommitAnalysis

# Detailed analysis with individual commit breakdown
Invoke-LLMCommitAnalysis -ShowDetails -Since "7 days ago"

# Focus on specific repository
Invoke-LLMCommitAnalysis -Repository "C:\MyProject" -ShowDetails

Example Output

=== AI Attribution Analysis Results ===
Total Commits Analyzed: 47
AI-Likely Commits: 12
AI Usage Percentage: 25.5%
Average AI Score: 3.2
Highest Score Found: 9

Top AI-Likely Commits:
- a1b2c3d: "Implement comprehensive error handling" (Score: 9)
- e4f5g6h: "Add advanced logging capabilities" (Score: 8)  
- i7j8k9l: "Refactor data processing pipeline" (Score: 7)

---

📚 Documentation

• API Reference - Complete function documentation
• Configuration Guide - Advanced setup and customization
• Usage Examples - Real-world integration scenarios
• GitHub Actions Integration - CI/CD pipeline examples

---

🚀 Advanced Examples

GitHub Actions Integration

name: AI Attribution Analysis
on: [push, pull_request]
jobs:
  ai-analysis:
    runs-on: windows-latest
    steps:
    - uses: actions/checkout@v3
    - name: Analyze AI Usage
      shell: pwsh
      run: |
        Install-Module AIAttributionTools -Force -Scope CurrentUser
        $analysis = Invoke-LLMCommitAnalysis -Since "1 day ago"
        Write-Host "AI Usage: $($analysis.AIPercentage)%"

Team Dashboard Script

# Weekly team analysis
$repos = @("ProjectA", "ProjectB", "ProjectC")
$teamReport = @()

foreach ($repo in $repos) {
    $analysis = Invoke-LLMCommitAnalysis -Repository $repo -Since "7 days ago"
    $teamReport += [PSCustomObject]@{
        Repository = $repo
        AIPercentage = $analysis.AIPercentage
        TotalCommits = $analysis.TotalCommits
    }
}

$teamReport | Format-Table -AutoSize

---

🛠️ System Requirements

• PowerShell: 5.1+ (Windows PowerShell) or 7+ (PowerShell Core)
• Git: Any recent version for repository analysis
• Platform: Windows 10/11, macOS, Linux (PowerShell Core)
• Memory: Minimal footprint, suitable for large repositories

---

🤝 Community & Support

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Issues & Feature Requests

Report bugs and request features on our GitHub Issues page.

Discussions

Join community discussions in GitHub Discussions.

---

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🏢 Enterprise & Commercial Use

AI Attribution Tools is completely free for commercial and enterprise use under the MIT License. Perfect for:

• Individual Developers - Personal project transparency
• Development Teams - Team collaboration and compliance
• Enterprise Organizations - Large-scale AI development governance
• Open Source Projects - Community contribution transparency

---

🔗 Related Projects

This tool was originally developed as part of a larger WhatsApp receipts processing system but has been separated into its own dedicated repository for broader community use and better focus.

Happy coding with AI attribution transparency! 🤖✨