<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Aaryan Rawat</title>
    <description>The latest articles on DEV Community by Aaryan Rawat (@aaryanrwt).</description>
    <link>https://dev.to/aaryanrwt</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4175540%2Fbef640b0-ab8b-4f26-97fb-e21298ff472d.jpg</url>
      <title>DEV Community: Aaryan Rawat</title>
      <link>https://dev.to/aaryanrwt</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/aaryanrwt"/>
    <language>en</language>
    <item>
      <title>Athena: A Local-First Git &amp; AST Change-Intelligence Engine and MCP Server</title>
      <dc:creator>Aaryan Rawat</dc:creator>
      <pubDate>Sun, 18 Oct 2026 15:05:37 +0000</pubDate>
      <link>https://dev.to/aaryanrwt/athena-a-local-first-git-ast-change-intelligence-engine-and-mcp-server-eok</link>
      <guid>https://dev.to/aaryanrwt/athena-a-local-first-git-ast-change-intelligence-engine-and-mcp-server-eok</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/hacktoberfest-week2-2026-10-12"&gt;Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ft5kkd8ycp7q4cu7sqj9q.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ft5kkd8ycp7q4cu7sqj9q.png" alt="Athena Banner" width="800" height="265"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  What I Built
&lt;/h2&gt;

&lt;p&gt;Most release-note generators and PR review bots do the same thing: they dump &lt;code&gt;git log --oneline&lt;/code&gt; into a cloud LLM and hope for the best.&lt;/p&gt;

&lt;p&gt;That fails in real engineering teams for two reasons:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Commit messages lie.&lt;/strong&gt; A commit titled &lt;code&gt;fix(api): minor cleanup in parameter defaults&lt;/code&gt; might actually insert an optional parameter before an existing one (&lt;code&gt;def compute(a, b=2)&lt;/code&gt; -&amp;gt; &lt;code&gt;def compute(a, inserted=0, b=2)&lt;/code&gt;), silently shifting positional arguments for every caller in production.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Hallucinations &amp;amp; privacy.&lt;/strong&gt; Cloud LLMs invent commit hashes, miss downstream callers, and require sending proprietary source diffs to external APIs.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;&lt;strong&gt;Athena (&lt;code&gt;athena-mcp&lt;/code&gt;)&lt;/strong&gt; is an open-source, local-first &lt;strong&gt;Git &amp;amp; AST Change-Intelligence Engine, CLI, and Model Context Protocol (MCP) server&lt;/strong&gt;. Instead of guessing from commit titles, Athena parses the actual Python Abstract Syntax Tree (&lt;code&gt;ast&lt;/code&gt;) and TypeScript/JavaScript structural contracts across any Git revision range (&lt;code&gt;base_ref..target_ref&lt;/code&gt;), traces downstream caller blast radius across the repository, flags stale Markdown documentation, and binds every single finding to a verified &lt;code&gt;EvidenceRecord&lt;/code&gt; (40-character commit SHA, file path, exact base/target line spans, and diff hunk excerpt).&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fhsgrn5p3sallaq626380.gif" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fhsgrn5p3sallaq626380.gif" alt="Athena Pixel Showcase" width="560" height="315"&gt;&lt;/a&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  Open-Source AI Models &amp;amp; Ecosystem Used
&lt;/h2&gt;

&lt;p&gt;Because this challenge celebrates &lt;strong&gt;Open-Source AI&lt;/strong&gt;, Athena is built 100% on open-weights models and open protocols that run locally on consumer hardware (tested on an NVIDIA RTX 4050 Laptop GPU with 6 GB VRAM and 16 GB RAM):&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Google &lt;code&gt;gemma:latest&lt;/code&gt; (Gemma 7B — Open Weights via Ollama, &lt;code&gt;~5.0 GB&lt;/code&gt;):&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;Used in &lt;strong&gt;Mode B&lt;/strong&gt; to synthesize executive summaries and audience-segmented release narratives (&lt;strong&gt;Developers&lt;/strong&gt;, &lt;strong&gt;Maintainers&lt;/strong&gt;, and &lt;strong&gt;Clients/Stakeholders&lt;/strong&gt;) from Athena's deterministic AST and Git evidence records.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Alibaba &lt;code&gt;qwen2.5-coder:7b&lt;/code&gt; (Qwen 2.5 Coder 7B — Open Weights via Ollama, &lt;code&gt;~4.7 GB&lt;/code&gt;):&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;Used in &lt;strong&gt;Mode B&lt;/strong&gt; for code-heavy breaking-change impact explanations, migration guidance, and caller blast-radius summaries.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Automatic 6 GB VRAM Model Swap &amp;amp; Verification Gate (&lt;code&gt;src/athena/ollama_engine.py&lt;/code&gt;):&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;Running two 7B models on a 6 GB laptop GPU normally triggers CUDA/VRAM thrashing. Athena inspects Ollama's &lt;code&gt;/api/ps&lt;/code&gt; endpoint before inference and automatically evicts any competing loaded model (&lt;code&gt;keep_alive: 0&lt;/code&gt;) before loading &lt;code&gt;gemma:latest&lt;/code&gt; or &lt;code&gt;qwen2.5-coder:7b&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Zero-Hallucination Verifier (&lt;code&gt;src/athena/verifier.py&lt;/code&gt;):&lt;/strong&gt; Every JSON response returned by &lt;code&gt;gemma:7b&lt;/code&gt; or &lt;code&gt;qwen2.5-coder:7b&lt;/code&gt; is cross-checked against Athena's deterministic &lt;code&gt;EvidenceRecord&lt;/code&gt; table. If the model invents a commit SHA, fabricates a file path, or times out, Athena strips the unverified claim or gracefully falls back to deterministic &lt;strong&gt;Mode C&lt;/strong&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Open-Source Model Context Protocol (&lt;code&gt;mcp&lt;/code&gt; Python SDK):&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;Exposes Athena's intelligence as 4 standardized, read-only &lt;code&gt;stdio&lt;/code&gt; MCP tools (&lt;code&gt;inspect_revision_range&lt;/code&gt;, &lt;code&gt;analyze_code_changes&lt;/code&gt;, &lt;code&gt;detect_potential_breaking_changes&lt;/code&gt;, and &lt;code&gt;generate_release_notes&lt;/code&gt;) so any MCP-compatible agent or IDE can query ground-truth Git + AST diffs locally.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  How Athena's Engine Works
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Deterministic-First Core (Mode A — 0ms LLM Wait Time):&lt;/strong&gt; Works 100% offline without Ollama or any network connection.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Deep AST Contract &amp;amp; Recursion Differencing:&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;Catches removed parameters, narrowed defaults, removed &lt;code&gt;None&lt;/code&gt;-fallback body guards (&lt;code&gt;griffe#469&lt;/code&gt;), &lt;code&gt;(str, Enum)&lt;/code&gt; &amp;lt;-&amp;gt; &lt;code&gt;StrEnum&lt;/code&gt; breaking migrations (&lt;code&gt;griffe#501&lt;/code&gt;), and newly raised exceptions (&lt;code&gt;griffe#498&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Positional-Parameter Index Shift Detection (&lt;code&gt;BUG-030&lt;/code&gt;):&lt;/strong&gt; Flags optional positional insertions that shift surviving parameters' indices (&lt;code&gt;old_pos_idx[n] != new_pos_idx[n]&lt;/code&gt;), verified against a 66-case parametrized binding-relation matrix across positional-only (&lt;code&gt;/&lt;/code&gt;), standard positional, trailing appends, and keyword-only (&lt;code&gt;*&lt;/code&gt;) controls.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Recursive Function Defect Analysis (&lt;code&gt;BUG-021&lt;/code&gt;..&lt;code&gt;BUG-029&lt;/code&gt;):&lt;/strong&gt; Detects broken recursive self-call arity, unconditional infinite recursion without a base case, and unqualified class-method recursion &lt;code&gt;NameError&lt;/code&gt;s.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Public API Exposure vs. Internal Helpers:&lt;/strong&gt; Distinguishes &lt;code&gt;__all__&lt;/code&gt;, &lt;code&gt;__init__.py&lt;/code&gt; re-exports, and TypeScript &lt;code&gt;export&lt;/code&gt; symbols (&lt;code&gt;is_public_api_export=True&lt;/code&gt;) from internal &lt;code&gt;_private&lt;/code&gt; modules.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Dynamic Dispatch &amp;amp; Coverage Confidence:&lt;/strong&gt; Scans for reflection (&lt;code&gt;getattr&lt;/code&gt;, &lt;code&gt;globals()&lt;/code&gt;, &lt;code&gt;eval&lt;/code&gt;, &lt;code&gt;importlib.import_module&lt;/code&gt;, TS bracket dispatch &lt;code&gt;obj[key]()&lt;/code&gt;) and outputs an explicit &lt;code&gt;AnalysisCoverageReport&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  Why This Matters (The Side Hustle / Business Case)
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Engineering Teams &amp;amp; Fast-Moving Startups:&lt;/strong&gt; A single silent breaking change in a shared internal package costs hours of incident triage and rollbacks. Athena drops straight into GitHub Actions (&lt;code&gt;.github/workflows/athena-audit.yml&lt;/code&gt;) or your IDE (&lt;code&gt;Claude Desktop&lt;/code&gt;, &lt;code&gt;Cursor&lt;/code&gt;, &lt;code&gt;VS Code&lt;/code&gt;) via MCP.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Open-Source Maintainers:&lt;/strong&gt; Automates verified, audience-segmented release notes and SemVer checks without manual diff digging.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Regulated Industries (FinTech, HealthTech, Defense):&lt;/strong&gt; Teams that cannot send proprietary code diffs to closed cloud APIs get AI-enhanced release intelligence running 100% on local hardware with built-in path-jail security, Git flag-injection defense, and automatic Bearer/API key redaction.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  Demo &amp;amp; CLI Usage
&lt;/h2&gt;

&lt;h3&gt;
  
  
  1. Install Athena (&lt;code&gt;Python 3.12+&lt;/code&gt;)
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;
bash
git clone https://github.com/aaryanrwt/athena.git
cd athena
pip install -e ".[dev]"
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>opensource</category>
      <category>ai</category>
    </item>
    <item>
      <title>Athena: Local-First Code Auditing and Verified Release Notes with Open-Weight AI</title>
      <dc:creator>Aaryan Rawat</dc:creator>
      <pubDate>Fri, 16 Oct 2026 21:29:13 +0000</pubDate>
      <link>https://dev.to/aaryanrwt/athena-local-first-code-auditing-and-verified-release-notes-with-open-weight-ai-gik</link>
      <guid>https://dev.to/aaryanrwt/athena-local-first-code-auditing-and-verified-release-notes-with-open-weight-ai-gik</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;This is a submission for the &lt;a href="https://dev.to/challenges/hacktoberfest-week2-2026-10-12"&gt;Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  What I Built
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Athena&lt;/strong&gt; is an open-source, local-first &lt;strong&gt;Git &amp;amp; AST change-intelligence engine and Model Context Protocol (MCP) server&lt;/strong&gt; built for the Hacktoberfest 2026 - Side Hustle Challenge.&lt;/p&gt;

&lt;p&gt;Every developer and engineering team faces the same dread on release day:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Did a refactoring subtly change a public function signature without bumping SemVer?&lt;/li&gt;
&lt;li&gt;Which downstream callers across our codebase will break if this pull request merges?&lt;/li&gt;
&lt;li&gt;Did someone update a function's parameters without updating the accompanying docstrings or markdown guides?&lt;/li&gt;
&lt;li&gt;Who has the time to read through 150 commits and write structured, evidence-grounded release notes?&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;I 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.&lt;/p&gt;

&lt;h3&gt;
  
  
  What Does Athena Do?
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;AST-Level Breaking Change Detection&lt;/strong&gt;: Parses Python and TypeScript syntax trees across Git commit ranges to pinpoint removed exports, altered parameter lists, and modified return types.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Caller Blast Radius Mapping&lt;/strong&gt;: Automatically traverses your repository to find every internal file, caller function, and imported symbol affected by a modified signature.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Documentation Drift Detection&lt;/strong&gt;: Cross-references modified code symbols against Markdown guides and docstrings to catch stale documentation before shipping.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Evidence-Grounded Release Notes&lt;/strong&gt;: Generates categorized changelogs where every bullet point is linked directly to exact commit hashes and file diffs.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Universal Model Context Protocol (MCP)&lt;/strong&gt;: Plugs natively into Claude Desktop, Cursor, Zed, or any AI coding assistant via standard JSON-RPC 2.0 stdio tools.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Offline-First &amp;amp; Privacy-Focused&lt;/strong&gt;: Runs completely on your local machine using Ollama and open-weight models like &lt;code&gt;qwen2.5-coder:7b&lt;/code&gt;. Your proprietary codebase never leaves your computer.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Who Would Pay For It?
&lt;/h3&gt;

&lt;p&gt;Athena is built for engineering teams, freelancers, and companies building in regulated environments:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Freelancers &amp;amp; Dev Agencies&lt;/strong&gt;: Freelance developers building client backends can run Athena pre-merge to guarantee they never push a breaking change that breaches a client contract or NDA.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;SaaS &amp;amp; Enterprise Engineering Teams&lt;/strong&gt;: A silent breaking change in a shared internal library costs thousands of dollars in emergency rollbacks and customer downtime. Athena automates pre-merge checks in CI/CD.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Privacy-Conscious Organizations (FinTech, HealthTech, Defense)&lt;/strong&gt;: Teams who cannot send proprietary code diffs to cloud LLMs can deploy Athena completely offline on developer laptops or air-gapped CI runners.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;The Side Hustle Model&lt;/strong&gt;: 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.&lt;/p&gt;

&lt;h2&gt;
  
  
  Demo
&lt;/h2&gt;

&lt;p&gt;Athena can inspect any local Git repository (pass &lt;code&gt;.&lt;/code&gt; for your current directory, or a path to a project). You can also run &lt;code&gt;python examples/create_demo_repo.py&lt;/code&gt; to generate an instant sandbox repo with sample commits, breaking changes, and documentation drift.&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Detecting Breaking Changes via AST
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;python &lt;span class="nt"&gt;-m&lt;/span&gt; athena breaking-changes &lt;span class="nb"&gt;.&lt;/span&gt; &lt;span class="nt"&gt;--base&lt;/span&gt; v1.0.0 &lt;span class="nt"&gt;--target&lt;/span&gt; v2.0.0
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Found 1 breaking change requiring human review:

[CRITICAL] calculate_metrics (function)
  Location: src/core/calculator.py:42
  Change: Non-optional parameter 'weights' was added to public function
  Evidence: commit 4a8b21c: "feat: add weights support to metrics calculation"
  Suggested SemVer Bump: MAJOR
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  2. Assessing Caller Blast Radius
&lt;/h3&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;python &lt;span class="nt"&gt;-m&lt;/span&gt; athena analyze &lt;span class="nb"&gt;.&lt;/span&gt; &lt;span class="nt"&gt;--base&lt;/span&gt; v1.0.0 &lt;span class="nt"&gt;--target&lt;/span&gt; HEAD
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Analysis Summary:
  - Commits analyzed: 12 commits between v1.0.0 and HEAD
  - Files modified: 8 (Python: 5, TypeScript: 2, Markdown: 1)
  - AST Symbol changes: 3 modified signatures, 1 deprecated export
  - Downstream callers affected: 4 internal callers identified
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  3. Generating Evidence-Verified Release Notes
&lt;/h3&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;python &lt;span class="nt"&gt;-m&lt;/span&gt; athena release-notes &lt;span class="nb"&gt;.&lt;/span&gt; &lt;span class="nt"&gt;--base&lt;/span&gt; v1.0.0 &lt;span class="nt"&gt;--target&lt;/span&gt; v2.0.0 &lt;span class="nt"&gt;--version&lt;/span&gt; &lt;span class="s2"&gt;"v2.0.0"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight markdown"&gt;&lt;code&gt;&lt;span class="gh"&gt;# Release Notes - v2.0.0&lt;/span&gt;

&lt;span class="gu"&gt;## Potential Breaking Changes&lt;/span&gt;
&lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="sb"&gt;`calculate_metrics`&lt;/span&gt;: Parameter &lt;span class="sb"&gt;`weights`&lt;/span&gt; added without a default value in &lt;span class="sb"&gt;`src/core/calculator.py`&lt;/span&gt; (&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nv"&gt;commit:4a8b21c&lt;/span&gt;&lt;span class="p"&gt;](&lt;/span&gt;&lt;span class="sx"&gt;https://github.com/aaryanrwt/athena&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;)

&lt;span class="gu"&gt;## What's Changed&lt;/span&gt;
&lt;span class="p"&gt;-&lt;/span&gt; Added async worker queue execution engine in &lt;span class="sb"&gt;`src/engine/worker.py`&lt;/span&gt; (&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nv"&gt;commit:7d9e10f&lt;/span&gt;&lt;span class="p"&gt;](&lt;/span&gt;&lt;span class="sx"&gt;https://github.com/aaryanrwt/athena&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;)
&lt;span class="p"&gt;-&lt;/span&gt; Refactored export interfaces in TypeScript client (&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nv"&gt;commit:b12c40e&lt;/span&gt;&lt;span class="p"&gt;](&lt;/span&gt;&lt;span class="sx"&gt;https://github.com/aaryanrwt/athena&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;)

&lt;span class="gu"&gt;## Documentation Drift&lt;/span&gt;
&lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="sb"&gt;`docs/api_guide.md`&lt;/span&gt; references the old 2-argument signature for &lt;span class="sb"&gt;`calculate_metrics`&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  4. Interactive AI Editor Integration (MCP Server)
&lt;/h3&gt;

&lt;p&gt;Add Athena to your &lt;code&gt;claude_desktop_config.json&lt;/code&gt; or Cursor settings:&lt;br&gt;
&lt;/p&gt;
&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"mcpServers"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"athena"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"command"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"python"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"args"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"-m"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"athena"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"mcp"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;Now your AI editor can directly query Athena for verified blast radiuses and breaking-change assessments before suggesting code edits.&lt;/p&gt;
&lt;h2&gt;
  
  
  Code
&lt;/h2&gt;

&lt;p&gt;The entire engine is open-source under the MIT license:&lt;/p&gt;


&lt;div class="ltag-github-readme-tag"&gt;
  &lt;div class="readme-overview"&gt;
    &lt;h2&gt;
      &lt;img src="https://assets.dev.to/assets/github-logo-5a155e1f9a670af7944dd5e12375bc76ed542ea80224905ecaf878b9157cdefc.svg" alt="GitHub logo"&gt;
      &lt;a href="https://github.com/aaryanrwt" rel="noopener noreferrer"&gt;
        aaryanrwt
      &lt;/a&gt; / &lt;a href="https://github.com/aaryanrwt/athena" rel="noopener noreferrer"&gt;
        athena
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      Deterministic Git &amp;amp; AST change intelligence engine and Model Context Protocol (MCP) server. Detects breaking changes, maps caller blast radius, identifies doc drift, and drafts evidence-grounded release notes with optional local LLM acceleration.
    &lt;/h3&gt;
  &lt;/div&gt;
  &lt;div class="ltag-github-body"&gt;
    
&lt;div id="readme" class="md"&gt;&lt;div class="markdown-heading"&gt;
&lt;h1 class="heading-element"&gt;Athena (&lt;code&gt;athena-mcp&lt;/code&gt;)&lt;/h1&gt;
&lt;/div&gt;

&lt;p&gt;&lt;strong&gt;Local-First, Evidence-Backed Git &amp;amp; AST Release-Readiness and Change-Intelligence MCP Server&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Athena is an open-source, local-first Model Context Protocol (MCP) server and developer CLI that delivers &lt;strong&gt;verifiable, ground-truth code-change intelligence&lt;/strong&gt;. By combining deterministic Git diff analysis, Python Abstract Syntax Tree (&lt;code&gt;ast&lt;/code&gt;) 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.&lt;/p&gt;




&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;Key Differentiators&lt;/h2&gt;
&lt;/div&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Deterministic-First Core (100% LLM-Independent)&lt;/strong&gt;: Athena works out-of-the box completely offline without Ollama, without an external AI API, and without any network connection. All Git inspections, AST symbol deltas, caller blast-radius graphs, doc-drift warnings, and release notes execute deterministically with 0ms LLM wait time.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Ground-Truth Evidence Citations&lt;/strong&gt;: Every reported change story and potential breaking change is bound to verified &lt;code&gt;EvidenceRecord&lt;/code&gt; items containing the 40-character commit SHA, commit subject, file path, exact base/target line spans, unified diff hunk…&lt;/li&gt;
&lt;/ol&gt;&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/aaryanrwt/athena" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;33 / 33 Real-World Automated Tests Passing&lt;/strong&gt; (covering positional-only &lt;code&gt;/&lt;/code&gt; markers, staticmethods, Windows NTFS stream protection, and TypeScript multiline interfaces)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Zero Cloud API Requirement&lt;/strong&gt;: 100% offline-first with deterministic AST fallbacks.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;
  
  
  How I Built It
&lt;/h2&gt;

&lt;p&gt;Athena is engineered around a strict hybrid architecture:&lt;br&gt;
&lt;/p&gt;
&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;[ Git History &amp;amp; Diff Engine ]
              |
  [ Multi-Language AST Parsers (Python + TypeScript) ]
              |
 [ Deterministic Verification &amp;amp; Blast Radius Engine ]
              |
     [ Ollama Local LLM (qwen2.5-coder:7b) ] (Optional Acceleration)
              |
   [ Standard MCP Server / CLI Output ]
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  Open-Source AI at the Core
&lt;/h3&gt;

&lt;p&gt;Athena uses &lt;a href="https://ollama.com/" rel="noopener noreferrer"&gt;Ollama&lt;/a&gt; with the open-weight &lt;code&gt;qwen2.5-coder:7b&lt;/code&gt; 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.&lt;/p&gt;
&lt;h3&gt;
  
  
  Why Deterministic-First Engineering Matters
&lt;/h3&gt;

&lt;p&gt;LLMs can invent code that does not exist. Athena solves this with a two-tier pipeline:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Deterministic Rule Engine&lt;/strong&gt;: AST parsing and blast-radius tracing run entirely via Python's native &lt;code&gt;ast&lt;/code&gt; module and TypeScript syntax tokenizers. The breaking-change verdict is 100% mathematical truth.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Evidence Grounding&lt;/strong&gt;: Any summary produced by the local AI must cite an actual commit SHA and file path. Athena's verifier checks each citation against the real Git log; any hallucinated claims are automatically pruned.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Deterministic Fallback&lt;/strong&gt;: If Ollama is offline or not installed, Athena seamlessly switches to deterministic mode, ensuring 100% CLI and MCP server reliability without any AI runtime.&lt;/li&gt;
&lt;/ol&gt;

&lt;h2&gt;
  
  
  Why Does Open Innovation Matter?
&lt;/h2&gt;

&lt;p&gt;For a developer tool like Athena, open innovation is the entire business enabler:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Client Privacy &amp;amp; Zero NDA Breaches&lt;/strong&gt;: Freelancers 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.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Viable Unit Economics for a Side Hustle&lt;/strong&gt;: Sending 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.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Offline &amp;amp; Air-Gapped Autonomy&lt;/strong&gt;: Developers code on flights, commuter trains, and secure air-gapped corporate intranets. Athena has zero network calls - no telemetry, no internet checks, no cloud dependencies.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No Vendor Lock-In&lt;/strong&gt;: Because 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.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  My First User
&lt;/h2&gt;

&lt;p&gt;To 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.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The Test:&lt;/strong&gt;&lt;br&gt;
We ran Athena against an upcoming &lt;code&gt;v2.0.0&lt;/code&gt; refactor branch containing 38 commits.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;What Happened:&lt;/strong&gt;&lt;br&gt;
Athena immediately flagged a &lt;strong&gt;CRITICAL breaking change&lt;/strong&gt;: a helper method &lt;code&gt;format_tax_rate&lt;/code&gt; had been changed into a &lt;code&gt;@staticmethod&lt;/code&gt; and received a new positional argument without a default value. While the author's new unit tests passed, Athena's &lt;strong&gt;Blast Radius&lt;/strong&gt; 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.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Their Feedback:&lt;/strong&gt;&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;"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."&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;&lt;strong&gt;What They Asked for Next:&lt;/strong&gt;&lt;br&gt;
A native GitHub Action that automatically comments the blast radius report directly on pull requests.&lt;/p&gt;

&lt;h2&gt;
  
  
  Prize Categories
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Week 2: Side Hustle&lt;/strong&gt; - A local-first change intelligence and release management engine with a clear commercial path for freelancers, agencies, and micro-SaaS teams.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Best Open-Source AI Application&lt;/strong&gt; - Combining open-weight models (&lt;code&gt;qwen2.5-coder:7b&lt;/code&gt;) via Ollama with deterministic AST static analysis to deliver verifiable, private developer tooling.&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>programming</category>
      <category>ai</category>
    </item>
    <item>
      <title>Athena: Building a Local-First AI Change Intelligence &amp; Release Engine</title>
      <dc:creator>Aaryan Rawat</dc:creator>
      <pubDate>Fri, 16 Oct 2026 21:19:16 +0000</pubDate>
      <link>https://dev.to/aaryanrwt/athena-building-a-local-first-ai-change-intelligence-release-engine-2kie</link>
      <guid>https://dev.to/aaryanrwt/athena-building-a-local-first-ai-change-intelligence-release-engine-2kie</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/hacktoberfest-week2-2026-10-12"&gt;Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  What I Built
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Athena&lt;/strong&gt; is an open-source, local-first &lt;strong&gt;Git &amp;amp; AST change-intelligence engine and Model Context Protocol (MCP) server&lt;/strong&gt; built for the Hacktoberfest 2026 â€” Side Hustle Challenge. ðŸ›¡ï¸&lt;/p&gt;

&lt;p&gt;Every developer and engineering team faces the same dread on release day:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;em&gt;Did a refactoring subtly change a public function signature without bumping SemVer?&lt;/em&gt;&lt;/li&gt;
&lt;li&gt;&lt;em&gt;Which downstream callers across our codebase will break if this pull request merges?&lt;/em&gt;&lt;/li&gt;
&lt;li&gt;&lt;em&gt;Did someone update a function's parameters without updating the accompanying docstrings or markdown guides?&lt;/em&gt;&lt;/li&gt;
&lt;li&gt;&lt;em&gt;Who has the time to read through 150 commits and write structured, evidence-grounded release notes?&lt;/em&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;I 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.&lt;/p&gt;

&lt;h3&gt;
  
  
  What Does Athena Do?
&lt;/h3&gt;

&lt;p&gt;ðŸ” &lt;strong&gt;AST-Level Breaking Change Detection&lt;/strong&gt;: 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.&lt;/p&gt;

&lt;p&gt;ðŸ’¥ &lt;strong&gt;Caller Blast Radius Mapping&lt;/strong&gt;: Automatically traverses your repository to find every internal file, caller function, and imported symbol affected by a modified signature.&lt;/p&gt;

&lt;p&gt;ðŸ“š &lt;strong&gt;Documentation Drift Detection&lt;/strong&gt;: Cross-references modified code symbols against Markdown guides and docstrings to catch stale documentation before shipping.&lt;/p&gt;

&lt;p&gt;ðŸ“ &lt;strong&gt;Evidence-Grounded Release Notes&lt;/strong&gt;: Generates categorized changelogs where every bullet point is linked directly to exact commit hashes and file diffs.&lt;/p&gt;

&lt;p&gt;ðŸ”Œ &lt;strong&gt;Universal Model Context Protocol (MCP)&lt;/strong&gt;: Plugs natively into Claude Desktop, Cursor, Zed, or any AI coding assistant via standard JSON-RPC 2.0 stdio tools.&lt;/p&gt;

&lt;p&gt;ðŸ”’ &lt;strong&gt;Offline-First &amp;amp; Privacy-Focused&lt;/strong&gt;: Runs completely on your local machine using Ollama and open-weight models like &lt;code&gt;qwen2.5-coder:7b&lt;/code&gt;. Your proprietary codebase never leaves your computer.&lt;/p&gt;

&lt;h3&gt;
  
  
  Who Would Pay For It?
&lt;/h3&gt;

&lt;p&gt;Athena is built for engineering teams, freelancers, and companies building in regulated environments:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Freelancers &amp;amp; Dev Agencies&lt;/strong&gt;: Freelance developers building client backends can run Athena pre-merge to guarantee they never push a breaking change that breaches a client contract or NDA.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;SaaS &amp;amp; Enterprise Engineering Teams&lt;/strong&gt;: A silent breaking change in a shared internal library costs thousands of dollars in emergency rollbacks and customer downtime. Athena automates pre-merge checks in CI/CD.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Privacy-Conscious Organizations (FinTech, HealthTech, Defense)&lt;/strong&gt;: Teams who cannot send proprietary code diffs to cloud LLMs can deploy Athena completely offline on developer laptops or air-gapped CI runners.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;The Side Hustle Model&lt;/strong&gt;: 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.&lt;/p&gt;




&lt;h2&gt;
  
  
  Demo
&lt;/h2&gt;

&lt;p&gt;Athena can inspect any local Git repository (pass &lt;code&gt;.&lt;/code&gt; for your current directory, or a path to a project). You can also run &lt;code&gt;python examples/create_demo_repo.py&lt;/code&gt; to generate an instant sandbox repo with sample commits, breaking changes, and documentation drift.&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Detecting Breaking Changes via AST
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;python &lt;span class="nt"&gt;-m&lt;/span&gt; athena breaking-changes &lt;span class="nb"&gt;.&lt;/span&gt; &lt;span class="nt"&gt;--base&lt;/span&gt; v1.0.0 &lt;span class="nt"&gt;--target&lt;/span&gt; v2.0.0
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Found 1 breaking change requiring human review:

[CRITICAL] calculate_metrics (function)
  Location: src/core/calculator.py:42
  Change: Non-optional parameter 'weights' was added to public function
  Evidence: commit 4a8b21c: "feat: add weights support to metrics calculation"
  Suggested SemVer Bump: MAJOR
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  2. Assessing Caller Blast Radius
&lt;/h3&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;python &lt;span class="nt"&gt;-m&lt;/span&gt; athena analyze &lt;span class="nb"&gt;.&lt;/span&gt; &lt;span class="nt"&gt;--base&lt;/span&gt; v1.0.0 &lt;span class="nt"&gt;--target&lt;/span&gt; HEAD
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Analysis Summary:
  â€¢ Commits analyzed: 12 commits between v1.0.0 and HEAD
  â€¢ Files modified: 8 (Python: 5, TypeScript: 2, Markdown: 1)
  â€¢ AST Symbol changes: 3 modified signatures, 1 deprecated export
  â€¢ Downstream callers affected: 4 internal callers identified
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  3. Generating Evidence-Verified Release Notes
&lt;/h3&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;python &lt;span class="nt"&gt;-m&lt;/span&gt; athena release-notes &lt;span class="nb"&gt;.&lt;/span&gt; &lt;span class="nt"&gt;--base&lt;/span&gt; v1.0.0 &lt;span class="nt"&gt;--target&lt;/span&gt; v2.0.0 &lt;span class="nt"&gt;--version&lt;/span&gt; &lt;span class="s2"&gt;"v2.0.0"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight markdown"&gt;&lt;code&gt;&lt;span class="gh"&gt;# Release Notes â€” v2.0.0&lt;/span&gt;

&lt;span class="gu"&gt;## âš&amp;nbsp;ï¸ Potential Breaking Changes&lt;/span&gt;
&lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="sb"&gt;`calculate_metrics`&lt;/span&gt;: Parameter &lt;span class="sb"&gt;`weights`&lt;/span&gt; added without a default value in &lt;span class="sb"&gt;`src/core/calculator.py`&lt;/span&gt; (&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nv"&gt;`4a8b21c`&lt;/span&gt;&lt;span class="p"&gt;](&lt;/span&gt;&lt;span class="sx"&gt;commit:4a8b21c&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;)

&lt;span class="gu"&gt;## ðŸš€ What's Changed&lt;/span&gt;
&lt;span class="p"&gt;-&lt;/span&gt; Added async worker queue execution engine in &lt;span class="sb"&gt;`src/engine/worker.py`&lt;/span&gt; (&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nv"&gt;`7d9e10f`&lt;/span&gt;&lt;span class="p"&gt;](&lt;/span&gt;&lt;span class="sx"&gt;commit:7d9e10f&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;)
&lt;span class="p"&gt;-&lt;/span&gt; Refactored export interfaces in TypeScript client (&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nv"&gt;`b12c40e`&lt;/span&gt;&lt;span class="p"&gt;](&lt;/span&gt;&lt;span class="sx"&gt;commit:b12c40e&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;)

&lt;span class="gu"&gt;## ðŸ“š Documentation Drift&lt;/span&gt;
&lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="sb"&gt;`docs/api_guide.md`&lt;/span&gt; references the old 2-argument signature for &lt;span class="sb"&gt;`calculate_metrics`&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  4. Interactive AI Editor Integration (MCP Server)
&lt;/h3&gt;

&lt;p&gt;Add Athena to your &lt;code&gt;claude_desktop_config.json&lt;/code&gt; or Cursor settings:&lt;br&gt;
&lt;/p&gt;
&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"mcpServers"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="nl"&gt;"athena"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"command"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"python"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
      &lt;/span&gt;&lt;span class="nl"&gt;"args"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"-m"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"athena"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"mcp"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;Now your AI editor can directly query Athena for verified blast radiuses and breaking-change assessments before suggesting code edits!&lt;/p&gt;


&lt;h2&gt;
  
  
  Code
&lt;/h2&gt;

&lt;p&gt;The entire engine is open-source under the MIT license:&lt;/p&gt;


&lt;div class="ltag-github-readme-tag"&gt;
  &lt;div class="readme-overview"&gt;
    &lt;h2&gt;
      &lt;img src="https://assets.dev.to/assets/github-logo-5a155e1f9a670af7944dd5e12375bc76ed542ea80224905ecaf878b9157cdefc.svg" alt="GitHub logo"&gt;
      &lt;a href="https://github.com/aaryanrwt" rel="noopener noreferrer"&gt;
        aaryanrwt
      &lt;/a&gt; / &lt;a href="https://github.com/aaryanrwt/athena" rel="noopener noreferrer"&gt;
        athena
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      Deterministic Git &amp;amp; AST change intelligence engine and Model Context Protocol (MCP) server. Detects breaking changes, maps caller blast radius, identifies doc drift, and drafts evidence-grounded release notes with optional local LLM acceleration.
    &lt;/h3&gt;
  &lt;/div&gt;
  &lt;div class="ltag-github-body"&gt;
    
&lt;div id="readme" class="md"&gt;&lt;div class="markdown-heading"&gt;
&lt;h1 class="heading-element"&gt;Athena (&lt;code&gt;athena-mcp&lt;/code&gt;)&lt;/h1&gt;
&lt;/div&gt;

&lt;p&gt;&lt;strong&gt;Local-First, Evidence-Backed Git &amp;amp; AST Release-Readiness and Change-Intelligence MCP Server&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Athena is an open-source, local-first Model Context Protocol (MCP) server and developer CLI that delivers &lt;strong&gt;verifiable, ground-truth code-change intelligence&lt;/strong&gt;. By combining deterministic Git diff analysis, Python Abstract Syntax Tree (&lt;code&gt;ast&lt;/code&gt;) 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.&lt;/p&gt;




&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;Key Differentiators&lt;/h2&gt;
&lt;/div&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Deterministic-First Core (100% LLM-Independent)&lt;/strong&gt;: Athena works out-of-the box completely offline without Ollama, without an external AI API, and without any network connection. All Git inspections, AST symbol deltas, caller blast-radius graphs, doc-drift warnings, and release notes execute deterministically with 0ms LLM wait time.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Ground-Truth Evidence Citations&lt;/strong&gt;: Every reported change story and potential breaking change is bound to verified &lt;code&gt;EvidenceRecord&lt;/code&gt; items containing the 40-character commit SHA, commit subject, file path, exact base/target line spans, unified diff hunk…&lt;/li&gt;
&lt;/ol&gt;&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/aaryanrwt/athena" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;33 / 33 Real-World Automated Tests Passing&lt;/strong&gt; (covering positional-only &lt;code&gt;/&lt;/code&gt; markers, staticmethods, Windows NTFS stream protection, and TypeScript multiline interfaces)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Zero Cloud API Requirement&lt;/strong&gt;: 100% offline-first with deterministic AST fallbacks.&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  How I Built It
&lt;/h2&gt;

&lt;p&gt;Athena is engineered around a strict &lt;strong&gt;hybrid architecture&lt;/strong&gt;:&lt;br&gt;
&lt;/p&gt;
&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;[ Git History &amp;amp; Diff Engine ]
              â†“
  [ Multi-Language AST Parsers (Python + TypeScript) ]
              â†“
 [ Deterministic Verification &amp;amp; Blast Radius Engine ]
              â†“
     [ Ollama Local LLM (qwen2.5-coder:7b) ] (Optional Acceleration)
              â†“
   [ Standard MCP Server / CLI Output ]
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;h3&gt;
  
  
  ðŸ§&amp;nbsp; Open-Source AI at the Core
&lt;/h3&gt;

&lt;p&gt;Athena uses &lt;strong&gt;&lt;a href="https://ollama.com/" rel="noopener noreferrer"&gt;Ollama&lt;/a&gt;&lt;/strong&gt; with the open-weight &lt;strong&gt;&lt;code&gt;qwen2.5-coder:7b&lt;/code&gt;&lt;/strong&gt; 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.&lt;/p&gt;
&lt;h3&gt;
  
  
  ðŸ›¡ï¸ Why Deterministic-First Engineering Matters
&lt;/h3&gt;

&lt;p&gt;LLMs can invent code that does not exist. Athena solves this with a two-tier pipeline:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Deterministic Rule Engine&lt;/strong&gt;: AST parsing and blast-radius tracing run entirely via Python's native &lt;code&gt;ast&lt;/code&gt; module and TypeScript syntax tokenizers. The breaking-change verdict is &lt;strong&gt;100% mathematical truth&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Evidence Grounding&lt;/strong&gt;: Any summary produced by the local AI must cite an actual commit SHA and file path. Athena's verifier checks each citation against the real Git log; any hallucinated claims are automatically pruned.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Deterministic Fallback&lt;/strong&gt;: If Ollama is offline or not installed, Athena seamlessly switches to deterministic mode, ensuring 100% CLI and MCP server reliability without any AI runtime.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  Why Does Open Innovation Matter?
&lt;/h2&gt;

&lt;p&gt;For a developer tool like Athena, &lt;strong&gt;open innovation is the entire business enabler&lt;/strong&gt;:&lt;/p&gt;

&lt;p&gt;ðŸ”’ &lt;strong&gt;Client Privacy &amp;amp; Zero NDA Breaches&lt;/strong&gt;:&lt;br&gt;
Freelancers 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.&lt;/p&gt;

&lt;p&gt;ðŸ’° &lt;strong&gt;Viable Unit Economics for a Side Hustle&lt;/strong&gt;:&lt;br&gt;
Sending 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 &lt;strong&gt;$0.00&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;âœˆï¸ &lt;strong&gt;Offline &amp;amp; Air-Gapped Autonomy&lt;/strong&gt;:&lt;br&gt;
Developers code on flights, commuter trains, and secure air-gapped corporate intranets. Athena has zero network callsâ€”no telemetry, no internet checks, no cloud dependencies.&lt;/p&gt;

&lt;p&gt;ðŸ”“ &lt;strong&gt;No Vendor Lock-In&lt;/strong&gt;:&lt;br&gt;
Because 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.&lt;/p&gt;




&lt;h2&gt;
  
  
  My First User
&lt;/h2&gt;

&lt;p&gt;To 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.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The Test:&lt;/strong&gt;&lt;br&gt;
We ran Athena against an upcoming &lt;code&gt;v2.0.0&lt;/code&gt; refactor branch containing 38 commits.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;What Happened:&lt;/strong&gt;&lt;br&gt;
Athena immediately flagged a &lt;strong&gt;&lt;code&gt;CRITICAL&lt;/code&gt; breaking change&lt;/strong&gt;: a helper method &lt;code&gt;format_tax_rate&lt;/code&gt; had been changed into a &lt;code&gt;@staticmethod&lt;/code&gt; and received a new positional argument without a default value. While the author's new unit tests passed, Athena's &lt;strong&gt;Blast Radius&lt;/strong&gt; 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.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Their Feedback:&lt;/strong&gt;&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;"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."&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;&lt;strong&gt;What They Asked for Next:&lt;/strong&gt;&lt;br&gt;
A native GitHub Action that automatically comments the blast radius report directly on pull requests.&lt;/p&gt;




&lt;h2&gt;
  
  
  Prize Categories
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Week 2: Side Hustle&lt;/strong&gt; â€” A local-first change intelligence and release management engine with a clear commercial path for freelancers, agencies, and micro-SaaS teams.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Best Open-Source AI Application&lt;/strong&gt; â€” Combining open-weight models (&lt;code&gt;qwen2.5-coder:7b&lt;/code&gt;) via Ollama with deterministic AST static analysis to deliver verifiable, private developer tooling.&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>opensource</category>
      <category>ai</category>
    </item>
  </channel>
</rss>
