AgentCodeX v3.0.0-beta.1

Changelog

Commits

• docs: Complete documentation update for v3.0.0-beta.1 release (1bfd353)
• docs: Add comprehensive session completion and workflow status reports (59bff95)
• fix: Update all GitHub Actions to latest versions (15100be)
• Release v3.0.0-beta.1: Complete implementation with 100% test coverage (d713232)
• audit: Add executive summary for regression audit (2fcfc59)
• audit: Complete regression audit report - 100% clean (884288a)
• style: Auto-format all Python files with Black (1ba42b2)

Statistics

• Total commits: 7
• Files changed: 161 files changed, 25767 insertions(+), 1922 deletions(-)

v2.5.0 - Unified Version Release

Unified Version 2.5.0

All AgentCodeX codebases are now synchronized under version 2.5.0.

v2 (JavaScript/Node.js - NPM)

• Complete Visual Builder CLI management suite
• 7 new commands for Visual Builder lifecycle management
• Enhanced help system and documentation
• All 23 specialized agents fully operational
• Framework sync system for automatic updates

v3 (Python - Core Application)

• 844 tests passing with 97% coverage
• All CI/CD pipelines passing (5/5 jobs)
• Zero linting errors
• Complete FastAPI backend with GPT-5 integration
• MCP server integration (ports 9100-9105)
• Full CLI toolset (execute, config, init, doctor, status, version)
• Production-ready Docker deployment

Installation

v2 (NPM):

npm install -g [email protected]

v3 (Python - from source):

git clone https://github.com/ScaledMinds/AgentCodeX.git
cd AgentCodeX && git checkout v3.0-development
cd v3/core-app && ./install.sh

Both versions are production-ready and fully tested.

v2.4.2 - MCP-First Architecture

🔌 MCP-First Architecture - Production Implementation

Complete implementation of Model Context Protocol (MCP) servers for secure, centralized data operations. All data access now goes through JSON-RPC 2.0 MCP servers instead of direct database connections.

🎯 Key Features

MCP Server Implementations

• PostgreSQL MCP Server (Node.js/TypeScript, port 9000)

  • Full JSON-RPC 2.0 server with parameterized queries
  • Transaction support (BEGIN/COMMIT/ROLLBACK)
  • Connection pooling, health checks, audit logging
  • Methods: query, begin, commit, rollback, tables, schema

• Weaviate MCP Server (Python/FastAPI, port 9001)

  • Semantic search with vector similarity
  • Hybrid search (vector + keyword)
  • Batch operations, collection management
  • Methods: semantic_search, hybrid_search, insert/update/delete, collections

• Filesystem MCP Server (Python/FastAPI, port 9002)

  • Secure filesystem operations with path sandboxing
  • Async I/O for high performance
  • Path traversal attack prevention
  • Methods: read/write/delete, list, search, create_directory, metadata

MCP Client Library

• FastAPI-compatible async Python client
• Type-safe with full type hints
• Automatic retry with exponential backoff
• Dependency injection support
• Classes: PostgresMCPClient, WeaviateMCPClient, FilesystemMCPClient

Architecture Benefits

Security:

• NO direct database credentials in application code
• Centralized access control through MCP servers
• Path sandboxing prevents directory traversal
• SQL injection prevention
• Comprehensive audit logging

Performance:

• Connection pooling for database operations
• Async I/O for filesystem operations
• Automatic retry with backoff

Maintainability:

• Single source of truth for data operations
• Easy to add authentication/authorization
• Simplified testing with mock MCP servers
• Clear separation of concerns

📦 What's New

• All projects now include MCP servers in infrastructure/mcp/
• Updated prototype template uses MCP-first architecture
• HARBOR agent enhanced with MCP deployment configs
• Complete MCP documentation and examples
• agentcodex init automatically copies MCP templates

🔧 Installation

npm install -g agentcodex

🚀 Quick Start

agentcodex init
cd your-project
# Edit docs/ideation/prd.md
# Open in Claude Code:
/agentcodex-start

📖 Documentation

• MCP Architecture: MCP-FIRST-ARCHITECTURE.md
• Release Workflow: release-workflow.md

⬆️ Upgrade

npm update -g agentcodex
cd your-project
agentcodex sync

💡 Breaking Changes

None. Fully backward compatible.

---

Published to NPM: https://www.npmjs.com/package/agentcodex

🤖 Generated with Claude Code

v2.4.1: MCP-First Architecture

AgentCodeX v2.4.1: MCP-First Architecture 🔒

🎯 Major Architectural Shift

This release introduces MCP-First Architecture - ALL data operations now go through Model Context Protocol servers for enhanced security and standardization.

🚀 Key Improvements

MCP-First Data Operations

• PostgreSQL: All queries via MCP server (port 9000)
• Weaviate: Vector operations via MCP server (port 9001)
• Filesystem: File operations via MCP server (port 9002)
• NO direct database connections - everything through secure MCP protocol

Tech Stack Configuration

• New .agentcodex-stack.json for centralized version management
• Template engine automatically uses stack versions
• Consistent tech stack across all projects

Agent Updates

• MAESTRO: Enforces MCP-only architecture
• FORGE: Uses MCP client for all data operations
• All agents: Updated to mandate MCP protocol

Docker Integration

• MCP servers auto-deployed in Docker Compose
• Health checks for all MCP services
• Network isolation for security

📋 What This Means

For Security

✅ No direct database credentials in applications
✅ Automatic query parameterization
✅ Complete audit logging
✅ Granular permission control

For Developers

✅ Standardized data access patterns
✅ Easy to add new data sources
✅ Consistent error handling
✅ Built-in rate limiting

For Open Source Users

✅ Everything works out-of-the-box
✅ No manual MCP configuration needed
✅ Automatic version management
✅ Plug-and-play architecture

🔧 Tech Stack Versions (V4)

All projects now use these exact versions:

• Python: 3.13
• FastAPI: 0.118.0
• Next.js: 15.5
• React: 19.2
• PostgreSQL: 15.4
• Weaviate: 1.33.0
• Traefik: 3.5.2
• Keycloak: 26.3.5
• GPT Model: GPT-5

📦 Installation

Update to v2.4.1:

npm update -g agentcodex

Or fresh install:

npm install -g [email protected]

📚 Documentation

• MCP-First Architecture Guide
• Tech Stack Configuration
• Migration Guide for Existing Projects

⚠️ Breaking Changes

Projects created with v2.4.0 or earlier need migration:

1. Add MCP servers to docker-compose
2. Update backend to use MCP client
3. Remove direct database connections

New projects created with v2.4.1 use MCP by default.

🙏 Thank You

This architectural improvement makes AgentCodeX more secure, standardized, and enterprise-ready. The MCP-first approach ensures all AI applications follow security best practices by default.

---

Full Changelog: v2.4.0...v2.4.1

v2.4.0: Transformative Platform Release

AgentCodeX v2.4.0: Transformative Platform Release 🚀

🎯 Major Features

Template System for Instant Project Generation

• Complete SaaS application template with exact v4 tech stack versions
• Variable substitution for project customization
• Production-ready configurations out of the box

MCP (Model Context Protocol) Integration

• Secure data operations through standardized protocol
• 3 MCP server templates: PostgreSQL, Weaviate, filesystem
• Structured tool orchestration for all agents

Local Knowledge Architecture

• Weaviate 1.33.0 vector database with 8-bit quantization
• Offline-capable development environment
• Local RAG system for enhanced agent intelligence

ORACLE Meta-Learning System

• Continuous improvement from every project
• Automated framework evolution
• Learning preservation across upgrades

🏗️ Infrastructure Updates

• Backend: FastAPI 0.118.0, Python 3.13, GPT-5 integration
• Frontend: Next.js 15.5, React 19.2, shadcn/ui
• Databases: PostgreSQL 15.4, Weaviate 1.33.0
• DevOps: Docker, Traefik 3.5.2, Keycloak 26.3.5

🐛 Fixes

• Updated langchain imports to use langchain-openai package
• Fixed missing signIn import in Next.js templates
• Corrected all version numbers throughout the framework

📦 Installation

Install from NPM:

npm install -g [email protected]

Or clone and link locally:

git clone https://github.com/ScaledMinds/AgentCodeX.git
cd AgentCodeX
npm install
npm link

📚 Documentation

• Platform Specification
• Local Knowledge Architecture
• ORACLE Evolution System
• V4 Stack Integration

🙏 Contributors

Special thanks to all contributors who made this transformative release possible!

---

Full Changelog: v2.3.1...v2.4.0

v2.3.1 - Maintenance Release

Fixed

• GitHub Actions fork compatibility - no more SARIF upload errors on forks
• Documentation updates - ROADMAP now shows v2.3.0 as current
• Template documentation - Added detailed inline comments

Added

• NPM funding field with GitHub Sponsors link
• Automated NPM publishing via GitHub Actions

Changed

• Renamed v2.2.0 spec to v2.4.0 for proper versioning sequence

This maintenance release improves stability and documentation accuracy.