{"slug": "athena-building-a-local-first-ai-change-intelligence-release-engine", "title": "Athena: Building a Local-First AI Change Intelligence & Release Engine", "summary": "A developer built Athena, an open-source, local-first Git and AST change-intelligence engine and Model Context Protocol (MCP) server that detects breaking changes, maps caller blast radius, flags documentation drift, and generates evidence-grounded release notes without sending code to third-party cloud APIs. The tool parses Python and TypeScript syntax trees across commit ranges and runs locally via Ollama with open-weight models such as qwen2.5-coder:7b, and plugs into AI coding assistants like Claude Desktop, Cursor, and Zed over JSON-RPC 2.0 stdio. An open-core CLI and MCP server are paired with a paid GitHub Action bot ($19/month solo, $79/month team) that audits pull requests and posts blast-radius warnings in PR reviews.", "body_md": "*This is a submission for the [Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle](https://dev.to/challenges/hacktoberfest-week2-2026-10-12)*\n\n**Athena** is an open-source, local-first **Git & AST change-intelligence engine and Model Context Protocol (MCP) server** built for the Hacktoberfest 2026 — Side Hustle Challenge. 🛡ï¸\n\nEvery developer and engineering team faces the same dread on release day:\n\nI built Athena to turn raw Git history and multi-language syntax trees into structured, mathematically verified change intelligence—without ever sending your code to closed third-party cloud APIs.\n\n🔠**AST-Level Breaking Change Detection**: Parses Python and TypeScript syntax trees across Git commit ranges to pinpoint removed exports, altered parameter lists (positional, keyword, and defaults), and modified return types.\n\n💥 **Caller Blast Radius Mapping**: Automatically traverses your repository to find every internal file, caller function, and imported symbol affected by a modified signature.\n\n📚 **Documentation Drift Detection**: Cross-references modified code symbols against Markdown guides and docstrings to catch stale documentation before shipping.\n\n📠**Evidence-Grounded Release Notes**: Generates categorized changelogs where every bullet point is linked directly to exact commit hashes and file diffs.\n\n🔌 **Universal Model Context Protocol (MCP)**: Plugs natively into Claude Desktop, Cursor, Zed, or any AI coding assistant via standard JSON-RPC 2.0 stdio tools.\n\n🔒 **Offline-First & Privacy-Focused**: Runs completely on your local machine using Ollama and open-weight models like `qwen2.5-coder:7b`. Your proprietary codebase never leaves your computer.\n\nAthena is built for engineering teams, freelancers, and companies building in regulated environments:\n\n**The Side Hustle Model**: An open-core CLI and MCP server for solo developers, paired with an automated GitHub Action bot ($19/month solo / $79/month team) that audits every Pull Request and posts blast-radius warnings directly in PR reviews.\n\nAthena can inspect any local Git repository (pass `.` for your current directory, or a path to a project). You can also run `python examples/create_demo_repo.py` to generate an instant sandbox repo with sample commits, breaking changes, and documentation drift.\n\n```\npython -m athena breaking-changes . --base v1.0.0 --target v2.0.0\nFound 1 breaking change requiring human review:\n\n[CRITICAL] calculate_metrics (function)\n  Location: src/core/calculator.py:42\n  Change: Non-optional parameter 'weights' was added to public function\n  Evidence: commit 4a8b21c: \"feat: add weights support to metrics calculation\"\n  Suggested SemVer Bump: MAJOR\npython -m athena analyze . --base v1.0.0 --target HEAD\nAnalysis Summary:\n  • Commits analyzed: 12 commits between v1.0.0 and HEAD\n  • Files modified: 8 (Python: 5, TypeScript: 2, Markdown: 1)\n  • AST Symbol changes: 3 modified signatures, 1 deprecated export\n  • Downstream callers affected: 4 internal callers identified\npython -m athena release-notes . --base v1.0.0 --target v2.0.0 --version \"v2.0.0\"\n# Release Notes — v2.0.0\n\n## ⚠️ Potential Breaking Changes\n- `calculate_metrics`: Parameter `weights` added without a default value in `src/core/calculator.py` ([`4a8b21c`](commit:4a8b21c))\n\n## 🚀 What's Changed\n- Added async worker queue execution engine in `src/engine/worker.py` ([`7d9e10f`](commit:7d9e10f))\n- Refactored export interfaces in TypeScript client ([`b12c40e`](commit:b12c40e))\n\n## 📚 Documentation Drift\n- `docs/api_guide.md` references the old 2-argument signature for `calculate_metrics`\n```\n\nAdd Athena to your `claude_desktop_config.json` or Cursor settings:\n\n```\n{\n  \"mcpServers\": {\n    \"athena\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"athena\", \"mcp\"]\n    }\n  }\n}\n```\n\nNow your AI editor can directly query Athena for verified blast radiuses and breaking-change assessments before suggesting code edits!\n\nThe entire engine is open-source under the MIT license:\n\n`athena-mcp`)\n**Local-First, Evidence-Backed Git & AST Release-Readiness and Change-Intelligence MCP Server**\n\nAthena is an open-source, local-first Model Context Protocol (MCP) server and developer CLI that delivers **verifiable, ground-truth code-change intelligence**. By combining deterministic Git diff analysis, Python Abstract Syntax Tree (`ast`) and TypeScript/JavaScript structural signature comparison, downstream caller blast-radius tracing, and documentation-drift detection, Athena eliminates the hallucination and superficiality of conventional AI release-note generators.\n\n`EvidenceRecord` items containing the 40-character commit SHA, commit subject, file path, exact base/target line spans, unified diff hunk…`/` markers, staticmethods, Windows NTFS stream protection, and TypeScript multiline interfaces)\nAthena is engineered around a strict **hybrid architecture**:\n\n```\n[ Git History & Diff Engine ]\n              ↓\n  [ Multi-Language AST Parsers (Python + TypeScript) ]\n              ↓\n [ Deterministic Verification & Blast Radius Engine ]\n              ↓\n     [ Ollama Local LLM (qwen2.5-coder:7b) ] (Optional Acceleration)\n              ↓\n   [ Standard MCP Server / CLI Output ]\n```\n\nAthena uses **[Ollama](https://ollama.com/)** with the open-weight **`qwen2.5-coder:7b`** model running locally on consumer hardware (tested on an NVIDIA RTX 4050 Laptop GPU with 6GB VRAM). The model synthesizes multi-commit diffs, grouping disparate changes into cohesive business narratives and technical release themes.\n\nLLMs can invent code that does not exist. Athena solves this with a two-tier pipeline:\n\n`ast` module and TypeScript syntax tokenizers. The breaking-change verdict is For a developer tool like Athena, **open innovation is the entire business enabler**:\n\n🔒 **Client Privacy & Zero NDA Breaches**:\n\nFreelancers and agencies handling enterprise code cannot send client intellectual property to OpenAI, Anthropic, or external cloud endpoints without written consent. Running open-weight models locally on the laptop guarantees 100% data sovereignty. Client code never leaves the machine.\n\n💰 **Viable Unit Economics for a Side Hustle**:\n\nSending 50,000-line diffs across 20 pull requests a day to proprietary cloud APIs would rack up hundreds of dollars in token bills each month, destroying margin. With open-weight models running on consumer hardware, the marginal cost per audit is **$0.00**.\n\nâœˆï¸ **Offline & Air-Gapped Autonomy**:\n\nDevelopers code on flights, commuter trains, and secure air-gapped corporate intranets. Athena has zero network calls—no telemetry, no internet checks, no cloud dependencies.\n\n🔓 **No Vendor Lock-In**:\n\nBecause Athena is built on open standards (Git, standard ASTs, and the open Model Context Protocol), users can swap the local model from Qwen to Llama 3 or Gemma 2 at will.\n\nTo test Athena in a real-world setting, I shared it with a freelance backend developer who maintains a micro-service billing API for a retail client.\n\n**The Test:**\n\nWe ran Athena against an upcoming `v2.0.0` refactor branch containing 38 commits.\n\n**What Happened:**\n\nAthena immediately flagged a **`CRITICAL` breaking change**: a helper method `format_tax_rate` had been changed into a `@staticmethod` and received a new positional argument without a default value. While the author's new unit tests passed, Athena's **Blast Radius** tool identified 3 legacy webhook processors in other files that were calling the old 1-argument signature. Merging that PR would have broken live customer invoice generation.\n\n**Their Feedback:**\n\n*\"Catching that before the client saw it saved my reputation. In my freelance work, a broken webhook means angry emails and lost retainers. I'd easily pay $29 a month for a tool that automates this across my client repos.\"*\n\n**What They Asked for Next:**\n\nA native GitHub Action that automatically comments the blast radius report directly on pull requests.\n\nAthena was developed using an AI-assisted engineering methodology, pairing iterative code generation with rigorous verification. You can review and inspect the full architecture, AST visitors, and test suite directly in the open-source repository.\n\n`qwen2.5-coder:7b`) via Ollama with deterministic AST static analysis to deliver verifiable, private developer tooling.", "url": "https://wpnews.pro/news/athena-building-a-local-first-ai-change-intelligence-release-engine", "canonical_source": "https://dev.to/aaryanrwt/athena-building-a-local-first-ai-change-intelligence-release-engine-2kie", "published_at": "2026-10-16 21:19:16+00:00", "updated_at": "2026-10-16 21:22:35.269028+00:00", "lang": "en", "topics": ["ai-tools", "developer-tools", "ai-agents", "agent-protocols", "ai-products"], "entities": ["Athena", "Model Context Protocol", "Ollama", "qwen2.5-coder:7b", "Claude Desktop", "Cursor", "Zed", "GitHub"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/athena-building-a-local-first-ai-change-intelligence-release-engine", "markdown": "https://wpnews.pro/news/athena-building-a-local-first-ai-change-intelligence-release-engine.md", "text": "https://wpnews.pro/news/athena-building-a-local-first-ai-change-intelligence-release-engine.txt", "jsonld": "https://wpnews.pro/news/athena-building-a-local-first-ai-change-intelligence-release-engine.jsonld"}}