Skip to content

v0.1.0 - Foundation Release: Enhanced File Analysis & Production Ready

Choose a tag to compare

View all tags
@n0zer0d4y n0zer0d4y released this 13 Nov 06:46
· 44 commits to master since this release
v0.1.0
b8784ee

v0.1.0 - Foundation Release: Enhanced File Analysis & Production Ready

Initial Public Release

Athena Protocol MCP Server - A systematic thinking validation system for LLM coding agents, acting as an AI tech lead to validate approaches, analyze impacts, and optimize decision-making.

Key Features

  • 5 Core Validation Tools: thinking_validation, impact_analysis, assumption_checker, dependency_mapper, thinking_optimizer
  • 14 LLM Provider Support: OpenAI, Anthropic, Google, Qwen, Groq, XAI, Mistral, Perplexity, OpenRouter, Ollama, ZAI, Azure, Bedrock, Vertex
  • Precision File Analysis: New analysisTargets parameter with 4 read modes (full, head, tail, range)
  • Docker Support: Production-ready containerization with multi-stage builds
  • npm Package: Ready for distribution via npm registry

Major Improvements

Enhanced File Analysis System

  • NEW: analysisTargets parameter with client-controlled precision
    • full mode: Read entire file when issue location is unclear
    • head mode: Read first N lines for imports/setup analysis
    • tail mode: Read last N lines for recent changes
    • range mode: Read specific line ranges for targeted analysis
    • Priority levels: critical, important, supplementary
  • REMOVED: Legacy filesToAnalyze parameter (previously limited to 100 lines)
  • Smart defaults: mode: "head" with lines: 50 when omitted

Tool Output Enhancements

thinking_optimizer now includes comprehensive tacticalPlan output:

  • Classification and grep-first guidance
  • Key findings and decision points
  • Implementation steps and testing plans
  • Risk mitigation and checkpoints
  • Value/effort analysis

Stability & Quality

  • FIXED: JSON parsing errors in MCP client communication
  • FIXED: Stdout contamination from debug logs
  • REMOVED: All informal emojis from code and logs
  • REMOVED: Unused web-search placeholder tool
  • IMPROVED: Error messages and validation feedback

npm & Docker Ready

npm Package Configuration

  • Package name: @n0zer0d4y/athena-protocol
  • Executable: athena-protocol
  • Optimized bundle with .npmignore
  • Pre-publish validation scripts

Docker Deployment

  • Multi-stage Alpine-based build (62MB final image)
  • Non-root user execution
  • Health check endpoint
  • Docker Compose orchestration

Documentation

  • Comprehensive README: Setup, configuration, tool usage, MCP client integration
  • Provider Guide: Detailed setup for all 14 LLM providers with latest models (GPT-5, Claude 4.5, Gemini 2.5, etc.)
  • MCP Client Schema: JSON configuration examples for Cursor and Claude Desktop
  • Important Notices:
    • Memory system marked as experimental (pending refactor)
    • Provider testing status (6 tested, 8 configured)

Known Limitations

  • Tested Providers: Only OpenAI, Google, ZAI, Mistral, OpenRouter, and Groq have been thoroughly tested
  • Memory System: Persistent memory creates thinking-memory.json in project root (refactor planned)

Testing

All test scripts updated to use new analysisTargets parameter:

  • test-live-mcp-tools.cjs
  • test-mcp-thinking-validation.js
  • test-all-tools.js
  • validate-tool-architecture.cjs

Requirements

  • Node.js 18 or higher
  • At least one LLM provider API key
  • TypeScript 5.x (for development)

Quick Start

npm installation:

npm install -g @n0zer0d4y/athena-protocol
athena-protocol

Docker deployment:

docker-compose up -d

Links

Commits in this Release

  • fix: restore and enhance thinking_optimizer tactical plan output
  • refactor: streamline file analysis with analysisTargets parameter
  • fix: resolve MCP client JSON parsing and validation errors
  • refactor: remove unused web-search placeholder tool
  • docs: update model listings and improve documentation quality
  • docs: add notice about memory system pending refactor
  • docs: add MCP client configuration section
  • docs: add provider testing status notice
  • chore: prepare package for npm publishing and Docker deployment

Full Changelog: Initial release

Assets 2
Loading