@defai.digital/automatosx 9.2.4 → 10.3.0

package/CHANGELOG.md

@@ -5,6 +5,94 @@ All notable changes to AutomatosX will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [10.0.0] - 2025-11-23
+
+### Added - Claude Code Native Integration 🎉
+
+**Major Feature**: Native Model Context Protocol (MCP) integration with Claude Code, eliminating the fragile CLAUDE.md documentation dependency.
+
+#### MCP Server Integration
+- **automatosx-mcp binary** - Native MCP server with stdio transport
+- **17 MCP tools** - Complete programmatic access to AutomatosX features
+  - Core: `run_agent`, `list_agents`, `search_memory`, `session_create`
+  - Memory: `memory_add`, `memory_list`, `memory_clear`, `memory_export`
+  - Session: `session_list`, `session_get`, `session_add_task`, `session_close`
+  - System: `config_get`, `status`, `health_check`
+- **JSON-RPC 2.0 protocol** - Standard MCP communication
+
+#### Auto-Generated Manifests
+- **ManifestGenerator class** - Generates Claude Code integration files from agent profiles
+- **20 manifest files** - Skills, commands, and sub-agents (100% auto-generated)
+  - 1 orchestration skill (`/automatosx`)
+  - 18 slash commands (`/agent-backend`, `/agent-frontend`, etc.)
+  - 1 coordinator sub-agent for multi-agent orchestration
+- **npm script** - `npm run generate:claude-manifests` for regeneration
+- **Zero documentation dependency** - Manifests always match actual agent capabilities
+
+#### One-Command Setup
+- **`ax setup --claude-code` flag** - Complete integration setup in one command
+- **Automatic CLI detection** - Checks for Claude Code installation
+- **MCP server registration** - Auto-registers with `claude mcp add`
+- **Manifest generation** - Creates all 20 integration files
+- **Validation** - Ensures setup correctness with clear error messages
+
+#### Comprehensive Diagnostics
+- **`ax doctor --claude-code` command** - Health checks for Claude Code integration
+- **5 diagnostic checks** - CLI, MCP server, registration, manifests, validation
+- **Clear error messages** - Actionable fixes for all issues
+- **Status reporting** - Pass/fail summary with next steps
+
+### Changed
+- **README.md** - Updated Quick Start with Claude Code integration options
+- **setup command** - Added `--claude-code` flag for native integration
+- **doctor command** - Added `--claude-code` flag for integration diagnostics
+
+### Technical Implementation
+- **src/mcp/index.ts** (37 lines) - MCP server entry point
+- **src/integrations/claude-code/manifest-generator.ts** (374 lines) - Manifest generation
+- **src/integrations/claude-code/setup-helper.ts** (293 lines) - Setup and diagnostics
+- **tools/generate-claude-manifests.ts** (80 lines) - CLI tool for manifest generation
+- **tests/integration/claude-code-setup.test.ts** (323 lines) - 17 comprehensive tests
+
+### Testing
+- **17 integration tests** - All passing (100% success rate)
+- **Complete coverage** - Setup, diagnostics, validation, idempotency
+- **Error condition testing** - Missing prerequisites, invalid manifests
+- **Manual testing** - All user workflows verified
+
+### Documentation
+- **docs/migration/v10-claude-code-integration.md** (~1,000 lines) - Complete migration guide
+- **docs/integrations/claude-code.md** (~1,200 lines) - User guide with examples
+- **Troubleshooting guides** - Common issues and solutions
+- **FAQ** - 15+ questions answered
+
+### Breaking Changes
+**NONE** - v10.0.0 is fully backward compatible with v9.x. All existing CLI commands, workflows, and integrations continue to work unchanged. The Claude Code integration is purely additive.
+
+### Benefits
+- ✅ **Robust Integration** - Programmatic MCP instead of fragile documentation
+- ✅ **Zero Maintenance** - Manifests auto-generate from agent profiles
+- ✅ **One-Command Setup** - `ax setup --claude-code` does everything
+- ✅ **Clear Diagnostics** - `ax doctor --claude-code` for health checks
+- ✅ **Natural Usage** - Slash commands (`/agent-backend`) in Claude Code
+- ✅ **Multi-Agent Orchestration** - `/automatosx` skill for complex tasks
+- ✅ **Persistent Memory** - Automatic context from past conversations
+- ✅ **Complete Observability** - All actions logged via MCP
+
+### Migration
+Users on v9.x can upgrade with zero breaking changes:
+```bash
+npm install -g @defai.digital/automatosx@10.0.0
+ax setup --claude-code  # Optional - adds native integration
+```
+
+See `docs/migration/v10-claude-code-integration.md` for complete guide.
+
+### Implementation Time
+- **Total**: 14 hours (vs 2 weeks estimated)
+- **Efficiency**: 95% time savings by discovering existing MCP server
+- **Quality**: 100% test pass rate, complete documentation
+
 ## [9.2.3] - 2025-11-22
 
 ### Added

package/CONTRIBUTING.md

@@ -26,7 +26,7 @@ AutomatosX is an **open source project** published for **transparency and commun
 - **Feature Suggestions** - Share your ideas for discussion
 - **Documentation Improvements** - Typos, clarifications, examples
 - **Security Reports** - See [SECURITY.md](SECURITY.md) for responsible disclosure
-- **Questions & Discussions** - Use GitHub Discussions
+- **Questions & Help** - Open a GitHub Issue with the `question` label
 - **Sharing & Using** - Use AutomatosX in your projects!
 
 ### Current Development Model 🔧
@@ -45,7 +45,7 @@ We believe in **radical transparency** - you should be able to:
 - ✅ Trust that nothing harmful is hidden
 - ✅ Fork and modify for your own use (within license terms)
 
-This doesn't mean we don't value the community! Issues, discussions, and feedback are **highly appreciated** and help make AutomatosX better.
+This doesn't mean we don't value the community! Issues, questions, and feedback are **highly appreciated** and help make AutomatosX better.
 
 ## Getting Started
 

package/LICENSE

@@ -1,3 +1,16 @@
+AutomatosX Open Source Edition - Apache License 2.0
+
+This license applies ONLY to the AutomatosX Open Source Edition code
+published on GitHub at https://github.com/defai-digital/automatosx
+
+This license does NOT apply to:
+- AutomatosX Pro Edition (proprietary software - separate EULA)
+- AutomatosX Enterprise Edition (proprietary software - separate agreement)
+
+For commercial editions, see COMMERCIAL-LICENSE.md
+
+===============================================================================
+
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/

package/README.md

@@ -13,7 +13,7 @@
 [![Windows](https://img.shields.io/badge/Windows-10+-blue.svg)](https://www.microsoft.com/windows)
 [![Ubuntu](https://img.shields.io/badge/Ubuntu-24.04-blue.svg)](https://ubuntu.com)
 
-**Status**: ✅ **Production Ready** | v9.2.4 | Enterprise MCP Support | Multi-Provider Orchestration
+**Status**: ✅ **Production Ready** | v10.3.0 | Native Claude Code Integration | Enterprise MCP Support
 
 > 🎯 **What AutomatosX Does**: Adds 20+ specialized agents, persistent memory, workflow automation, and 80% cost savings to Claude Code/Codex - **without changing how you work**.
 
@@ -107,12 +107,34 @@ npm install -g @defai.digital/automatosx
 
 ### Step 2: Initialize in Your Project
 
+**Option A: With Claude Code Native Integration** (Recommended)
+
+```bash
+cd your-project
+ax setup --claude-code
+```
+
+**What you get**:
+- ✅ 18 slash commands (`/agent-backend`, `/agent-frontend`, etc.)
+- ✅ Multi-agent orchestration (`/automatosx`)
+- ✅ MCP server with 17 tools
+- ✅ Auto-generated manifests
+- ✅ One-command diagnostics (`ax doctor --claude-code`)
+
+**Option B: Invisible Mode** (Original)
+
 ```bash
 cd your-project
 ax setup
 ```
 
-**That's it!** AutomatosX is now running invisibly. Keep using Claude Code/Codex naturally.
+**What you get**:
+- ✅ Invisible integration (no new commands)
+- ✅ Automatic multi-agent delegation
+- ✅ Persistent memory
+- ✅ Cost optimization
+
+**That's it!** AutomatosX is now running. Keep using Claude Code naturally.
 
 ### Step 3: Use Claude Code Naturally (No New Commands!)
 
@@ -666,22 +688,43 @@ npm test
 
 ---
 
-## 📄 License
+## 📦 Editions & Licensing
+
+AutomatosX uses an **open-core model** with three editions:
 
-AutomatosX is dual-licensed:
+| Edition | License | Price | Best For |
+|---------|---------|-------|----------|
+| **Open Source** | Apache 2.0 | Free Forever | Everyone (individuals, startups, enterprises) |
+| **Pro** | Commercial EULA | Contact Sales | Teams needing priority support + LTS |
+| **Enterprise** | Enterprise Agreement | Contact Sales | Regulated industries + compliance needs |
 
-- **Apache License 2.0** - See [LICENSE](LICENSE)
-- **Commercial License with OpenRAIL-M** - See [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md)
+### Open Source Edition (This Repo)
 
-**TL;DR**:
-- ✅ FREE for research, academic, personal projects, startups < $2M revenue
-- ❌ Commercial license required for companies ≥ $2M revenue/funding
+**License**: [Apache License 2.0](LICENSE) - Free forever, no revenue limits
+
+**What's Included**:
+- ✅ Full source code on GitHub
+- ✅ Core orchestration engine + 20+ AI agents
+- ✅ Persistent memory system (SQLite FTS5)
+- ✅ Multi-provider routing (Claude, Gemini, OpenAI Codex)
+- ✅ Workflow specs and execution
+- ✅ Community support (GitHub Issues)
+
+**Who Can Use**: Anyone, for any purpose (personal, commercial, research)
+
+### Pro & Enterprise Editions
+
+**Additional Features**: Advanced workflows, team collaboration, premium agent packs, SSO/RBAC, audit logging, self-hosted deployment, white-label options, priority support (1-day SLA), long-term support (LTS), custom SLA (24/7 available)
+
+**Get Started**: Contact <sales@defai.digital> for pricing
+
+**Learn More**: See [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md) for detailed edition comparison
+
+---
 
-**Need a commercial license?**
-- Email: <sales@defai.digital>
-- Subject: "AutomatosX Commercial License Inquiry"
+**Copyright 2025 DEFAI Private Limited**
 
-Copyright 2025 DEFAI Private Limited
+**Note**: We removed revenue thresholds ($2M limit) and OpenRAIL-M references in v3.0 (November 2025). Open Source Edition is now truly free for everyone - no limits, no tracking. If you need extra features or guaranteed support, explore Pro/Enterprise editions.
 
 ---