🧠 PatchMind

PatchMind is a modular Python CLI tool for Git repositories that generates smart, visual HTML reports.
It captures patch-level diffs, tree views, file history timelines, risk scoring, and more — all locally.

No cloud. No bloat. Just clean insight.

🚀 Key Features

• 🔍 Detects file-level and line-level changes across commits
• 🌳 Tree-based visualization of modified paths
• 📅 File timeline view with authorship and metadata
• ⚠️ Risk and impact scoring per file
• 👤 Inline blame summaries
• 📄 Clean, standalone HTML output
• ⚙️ Fully CLI-driven — automate in CI/CD

📸 Sample Output

📦 Installation

Install from PyPI:

pip install patchmind

Or install manually:

git clone https://github.com/Darkstar420/patchmind.git
cd patchmind
pip install -r requirements.txt

🧪 Usage

Generate an HTML report from the root of any Git repo:

python cli/main.py --report

The output will be saved as patchmind_report.html in the project root.

📂 Project Layout

patchmind/
├── cli/               # CLI entrypoint
├── core/              # Core analysis engine
├── tests/             # Unit tests
├── docs/              # Sample reports and images
├── config.yaml        # Config (optional)
├── requirements.txt
└── README.md

🧪 Run Tests

pytest -q

Unit tests live in tests/ and validate key functionality, including mock Git data and report rendering.

💡 Why Use PatchMind?

✅ No setup required – run it instantly ✅ See what's changing, where, and why ✅ Stay ahead of technical debt ✅ Built for devs who want insight — not overhead

📄 License

Licensed under the Apache 2.0 License — free to use, modify, and distribute.