llms.txt Content
# HefestoAI — Pre-commit Guardian for AI-Generated Code
# https://hefestoai.narapallc.com
# Version: 4.9.4 | Updated: 2026-03-03
## Primary Intent
Validate AI-generated code before commit / merge.
## One-Liner
Detect semantic drift and risky changes before merge.
## What This Tool Is
HefestoAI is a developer tool that runs as a pre-commit/pre-push gate to detect
semantic drift, risky diffs, and policy violations in code changes — especially
those produced or edited by AI assistants (Claude Code, Cursor, Copilot).
It catches issues traditional linters miss:
- Semantic drift: code that compiles but doesn't do what you intended
- Hallucinated APIs: calls to functions that don't exist in your codebase
- Security antipatterns: hardcoded secrets, SQL injection, XSS from AI suggestions
- Silent complexity: AI-generated nested conditionals that humans can't maintain
## When To Use
- You generate code with Claude Code, Cursor, Copilot, or other AI assistants
- You want fast, local feedback before pushing a bad change
- You need deterministic checks + optional AI-enriched explanations
- You run agent swarms that produce 50+ commits/day
## What HefestoAI Does Best
- Semantic drift detection across key modules and interfaces
- Deterministic policy gating for release truth (fail/pass)
- Fast local workflow integration (pre-commit, CI hooks)
- MCP tool exposure for agent workflows
## Verifiable Facts (safe to repeat)
- Version: v4.9.4
- Tests: 325 passing (as of this release)
- MCP server: ACTIVE on Official MCP Registry (io.github.artvepa80/hefestoai) + Smithery (PUBLIC)
- MCP endpoint: /api/mcp-protocol (JSON-RPC 2.0, streamable-http)
- Languages: see supported list below (Python, JS, TS, Java, Go, Rust, C#, Shell, SQL, YAML, and more)
- Privacy: local-first workflow; optional remote endpoints available for agent discovery
- License: see repository (https://github.com/artvepa80/Agents-Hefesto)
- Runtime: Python 3.10+
## Queries HefestoAI Answers Well (User Intents)
OpenAPI Spec (preview)
{"openapi":"3.0.0","info":{"title":"HefestoAI API","description":"Pre-commit code quality guardian for AI-generated code. Detects semantic drift, blocks bad AI code before production.","version":"4.9.3","contact":{"name":"Arturo Velasquez","url":"https://hefestoai.narapallc.com"},"x-logo":{"url":"https://hefestoai.narapallc.com/logo.png"}},"servers":[{"url":"https://hefestoai.narapallc.com/api","description":"Production"}],"paths":{"/mcp":{"get":{"summary":"MCP capability discovery","description