ContractGuard AI – Detect & Resolve API Conflicts Across Git Branches Automatically
ContractGuard is an AI-powered API contract conflict detection platform built for teams managing evolving APIs across multiple Git branches. Instead of discovering breaking changes after a crash in production, ContractGuard catches them before they ever merge.
🔗 GitHub: https://github.com/YOUR_USERNAME/contractg...
🛠️ Built at: [Hackathon Name]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🧩 WHAT PROBLEM DOES IT SOLVE?
Every development team working with APIs across parallel branches faces the same silent nightmare — a backend developer renames a field, removes an endpoint, or changes a data type, and days later the mobile app crashes in production. No warning. No alert. Just a 3 AM incident and an emergency war room.
ContractGuard eliminates this by acting as an intelligent middleman between your branches, your APIs, and your team.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ WHAT DOES IT DO?
✅ Connects to your GitHub repositories using a personal access token
✅ Automatically discovers all branches in each repo
✅ Deep-scans source code files (.ts, .js, .py, .java, .go) to extract API endpoint signatures — paths, HTTP methods, request fields, response fields, required/optional status, and exact line numbers
✅ Follows function references across imported files up to 3 levels deep (backtracking extractor)
✅ Compares each feature branch against main at 3 levels: endpoint level, field level, and behavior level
✅ Detects FIELD_REMOVED, TYPE_CHANGED, FIELD_RENAMED, ENDPOINT_REMOVED, REQUIRED_ADDED and more
✅ Ranks every conflict by severity: Critical → High → Medium → Low → Easy
✅ Provides guided resolution: Keep Main / Use Branch / Make Optional / Consolidate
✅ Handles cross-branch consolidation scenarios (when Branch A removes a field and Branch B renames it)
✅ AI-powered conflict explanations, resolution suggestions, and migration guide generation via Ollama (qwen2.5-coder:32b)
✅ Generates downloadable merged YAML contract and migration guide
✅ Never auto-pushes to GitHub — all output is preview only
🧱 TECH STACK
Frontend: React 19, Vite, TypeScript, Tailwind CS