aios-core 2.2.2 → 3.0.0

package/.claude/rules/mcp-usage.md

@@ -1,100 +1,116 @@
----
-paths: **/*
----
-
-# MCP Server Usage Rules - AIOS Architecture
-
-## MCP Configuration Architecture
-
-AIOS uses a hybrid MCP architecture for optimal performance and security:
-
-### Direct in Claude Code (global ~/.claude.json)
-| MCP | Purpose |
-|-----|---------|
-| **playwright** | Browser automation, screenshots, web testing |
-| **desktop-commander** | Docker container operations via docker-gateway |
-
-### Inside Docker Desktop (via desktop-commander)
-| MCP | Purpose |
-|-----|---------|
-| **EXA** | Web search, research, company/competitor analysis |
-| **Context7** | Library documentation lookup |
-
-## CRITICAL: Tool Selection Priority
-
-ALWAYS prefer native Claude Code tools over MCP servers:
-
-| Task | USE THIS | NOT THIS |
-|------|----------|----------|
-| Read files | `Read` tool | docker-gateway |
-| Write files | `Write` / `Edit` tools | docker-gateway |
-| Run commands | `Bash` tool | docker-gateway |
-| Search files | `Glob` tool | docker-gateway |
-| Search content | `Grep` tool | docker-gateway |
-| List directories | `Bash(ls)` or `Glob` | docker-gateway |
-
-## desktop-commander (docker-gateway) Usage
-
-### ONLY use docker-gateway when:
-1. User explicitly says "use docker" or "use container"
-2. User explicitly mentions "Desktop Commander"
-3. Task specifically requires Docker container operations
-4. Accessing MCPs running inside Docker (EXA, Context7)
-5. User asks to run something inside a Docker container
-
-### NEVER use docker-gateway for:
-- Reading local files (use `Read` tool)
-- Writing local files (use `Write` or `Edit` tools)
-- Running shell commands on host (use `Bash` tool)
-- Searching files (use `Glob` or `Grep` tools)
-- Listing directories (use `Bash(ls)` or `Glob`)
-- Running Node.js or Python scripts on host (use `Bash` tool)
-
-## playwright MCP Usage
-
-### ONLY use playwright when:
-1. User explicitly asks for browser automation
-2. User wants to take screenshots of web pages
-3. User needs to interact with a website
-4. Task requires web scraping or testing
-5. Filling forms or clicking elements on web pages
-
-### NEVER use playwright for:
-- General file operations
-- Running commands
-- Anything not related to web browsers
-
-## EXA MCP Usage (via Docker)
-
-### Use EXA (mcp__docker-gateway__web_search_exa) for:
-1. Web searches for current information
-2. Research and documentation lookup
-3. Company and competitor research
-4. Finding code examples online
-
-### Access pattern:
-```
-mcp__docker-gateway__web_search_exa
-```
-
-## Context7 MCP Usage (via Docker)
-
-### Use Context7 for:
-1. Library documentation lookup
-2. API reference for packages/frameworks
-3. Getting up-to-date docs for dependencies
-
-### Access pattern:
-```
-mcp__docker-gateway__resolve-library-id
-mcp__docker-gateway__get-library-docs
-```
-
-## Rationale
-
-- **Native tools** execute on the LOCAL system (Windows/Mac/Linux)
-- **docker-gateway** executes inside Docker containers (Linux)
-- Using docker-gateway for local operations causes path mismatches and failures
-- Native tools are faster and more reliable for local file operations
-- EXA and Context7 run inside Docker for isolation and consistent environment
-- playwright runs directly for better browser integration with host system
+---
+paths: **/*
+---
+
+# MCP Server Usage Rules - AIOS Architecture
+
+## MCP Governance
+
+**IMPORTANT:** All MCP infrastructure management is handled EXCLUSIVELY by the **DevOps Agent (@devops / Gage)**.
+
+| Operation | Agent | Command |
+|-----------|-------|---------|
+| Search MCP catalog | DevOps | `*search-mcp` |
+| Add MCP server | DevOps | `*add-mcp` |
+| List enabled MCPs | DevOps | `*list-mcps` |
+| Remove MCP server | DevOps | `*remove-mcp` |
+| Setup Docker MCP | DevOps | `*setup-mcp-docker` |
+
+Other agents (Dev, Architect, etc.) are MCP **consumers**, not administrators. If MCP management is needed, delegate to @devops.
+
+---
+
+## MCP Configuration Architecture
+
+AIOS uses Docker MCP Toolkit as the primary MCP infrastructure:
+
+### Direct in Claude Code (global ~/.claude.json)
+| MCP | Purpose |
+|-----|---------|
+| **playwright** | Browser automation, screenshots, web testing |
+| **desktop-commander** | Docker container operations via docker-gateway |
+
+### Inside Docker Desktop (via desktop-commander)
+| MCP | Purpose |
+|-----|---------|
+| **EXA** | Web search, research, company/competitor analysis |
+| **Context7** | Library documentation lookup |
+
+## CRITICAL: Tool Selection Priority
+
+ALWAYS prefer native Claude Code tools over MCP servers:
+
+| Task | USE THIS | NOT THIS |
+|------|----------|----------|
+| Read files | `Read` tool | docker-gateway |
+| Write files | `Write` / `Edit` tools | docker-gateway |
+| Run commands | `Bash` tool | docker-gateway |
+| Search files | `Glob` tool | docker-gateway |
+| Search content | `Grep` tool | docker-gateway |
+| List directories | `Bash(ls)` or `Glob` | docker-gateway |
+
+## desktop-commander (docker-gateway) Usage
+
+### ONLY use docker-gateway when:
+1. User explicitly says "use docker" or "use container"
+2. User explicitly mentions "Desktop Commander"
+3. Task specifically requires Docker container operations
+4. Accessing MCPs running inside Docker (EXA, Context7)
+5. User asks to run something inside a Docker container
+
+### NEVER use docker-gateway for:
+- Reading local files (use `Read` tool)
+- Writing local files (use `Write` or `Edit` tools)
+- Running shell commands on host (use `Bash` tool)
+- Searching files (use `Glob` or `Grep` tools)
+- Listing directories (use `Bash(ls)` or `Glob`)
+- Running Node.js or Python scripts on host (use `Bash` tool)
+
+## playwright MCP Usage
+
+### ONLY use playwright when:
+1. User explicitly asks for browser automation
+2. User wants to take screenshots of web pages
+3. User needs to interact with a website
+4. Task requires web scraping or testing
+5. Filling forms or clicking elements on web pages
+
+### NEVER use playwright for:
+- General file operations
+- Running commands
+- Anything not related to web browsers
+
+## EXA MCP Usage (via Docker)
+
+### Use EXA (mcp__docker-gateway__web_search_exa) for:
+1. Web searches for current information
+2. Research and documentation lookup
+3. Company and competitor research
+4. Finding code examples online
+
+### Access pattern:
+```
+mcp__docker-gateway__web_search_exa
+```
+
+## Context7 MCP Usage (via Docker)
+
+### Use Context7 for:
+1. Library documentation lookup
+2. API reference for packages/frameworks
+3. Getting up-to-date docs for dependencies
+
+### Access pattern:
+```
+mcp__docker-gateway__resolve-library-id
+mcp__docker-gateway__get-library-docs
+```
+
+## Rationale
+
+- **Native tools** execute on the LOCAL system (Windows/Mac/Linux)
+- **docker-gateway** executes inside Docker containers (Linux)
+- Using docker-gateway for local operations causes path mismatches and failures
+- Native tools are faster and more reliable for local file operations
+- EXA and Context7 run inside Docker for isolation and consistent environment
+- playwright runs directly for better browser integration with host system

package/LICENSE

@@ -1,48 +1,48 @@
-Commons Clause License Condition v1.0
-
-The Software is provided to you by the Licensor under the License,
-as defined below, subject to the following condition.
-
-Without limiting other conditions in the License, the grant of rights
-under the License will not include, and the License does not grant to
-you, the right to Sell the Software.
-
-For purposes of the foregoing, "Sell" means practicing any or all of
-the rights granted to you under the License to provide to third parties,
-for a fee or other consideration (including without limitation fees for
-hosting or consulting/support services related to the Software), a
-product or service whose value derives, entirely or substantially, from
-the functionality of the Software.
-
-Any license notice or attribution required by the License must also
-include this Commons Clause License Condition notice.
-
----
-
-MIT License
-
-Copyright (c) 2025 AllFluence Inc. - AIOS Framework
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
----
-
-Software: Synkra AIOS (AI-Orchestrated System for Full Stack Development)
-License: MIT
-Licensor: AllFluence Inc.
+Commons Clause License Condition v1.0
+
+The Software is provided to you by the Licensor under the License,
+as defined below, subject to the following condition.
+
+Without limiting other conditions in the License, the grant of rights
+under the License will not include, and the License does not grant to
+you, the right to Sell the Software.
+
+For purposes of the foregoing, "Sell" means practicing any or all of
+the rights granted to you under the License to provide to third parties,
+for a fee or other consideration (including without limitation fees for
+hosting or consulting/support services related to the Software), a
+product or service whose value derives, entirely or substantially, from
+the functionality of the Software.
+
+Any license notice or attribution required by the License must also
+include this Commons Clause License Condition notice.
+
+---
+
+MIT License
+
+Copyright (c) 2025 AllFluence Inc. - AIOS Framework
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Software: Synkra AIOS (AI-Orchestrated System for Full Stack Development)
+License: MIT
+Licensor: AllFluence Inc.

package/README.md

@@ -510,7 +510,7 @@ Sistema automatizado de detecção de gaps em **7 categorias**:
    node outputs/architecture-map/schemas/validate-tool-references.js
    ```
    - Valida ferramentas MCP/CLI/Local
-   - Suporta dual-mode (Legacy/1MCP)
+   - Integração com Docker MCP Toolkit
 
 ### 📈 Epic 2 & 3 Achievements
 
@@ -525,8 +525,8 @@ Sistema automatizado de detecção de gaps em **7 categorias**:
 - ✅ **88 Orphaned Active gaps resolvidos** (Stories 3.1.1-3.1.4)
 - ✅ 54 utilities ativas documentadas em `core-config.yaml`
 - ✅ 19 utilities arquivadas com rationale
-- ✅ **85% token reduction** via 1MCP integration (280k → 40k tokens)
-- ✅ Dual-mode validation (Legacy/1MCP)
+- ✅ **85% token reduction** via Docker MCP Toolkit (280k → 40k tokens)
+- ✅ MCP governance consolidated under DevOps Agent (Story 6.14)
 - ✅ Pre-commit hooks + Quarterly audit
 
 ### 🚀 Quick Start
@@ -565,7 +565,6 @@ cp outputs/architecture-map/mermaid/synthesis-layered-view.mmd docs/
 
 ### 🎯 Roadmap v1.1
 
-- [ ] Story 3.31 - 1MCP preset relationship synthesis
 - [ ] Interactive Miro board export
 - [ ] Real-time Neo4j updates on code changes
 - [ ] VSCode extension for inline visualization

package/bin/aios.js

@@ -234,11 +234,12 @@ async function main() {
       await runWizard();
       break;
 
-    case 'init':
+    case 'init': {
       // Create new project
       const projectName = args[1];
       await initProject(projectName);
       break;
+    }
 
     case 'info':
       showInfo();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-core",
-  "version": "2.2.2",
+  "version": "3.0.0",
   "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "main": "index.js",
   "module": "index.esm.js",
@@ -14,9 +14,7 @@
   "workspaces": [
     ".aios-core",
     "memory",
-    "security",
     "performance",
-    "telemetry",
     "packages/*"
   ],
   "files": [

package/packages/installer/package.json

@@ -1,39 +1,39 @@
-{
-  "name": "@aios/installer",
-  "version": "2.1.0",
-  "description": "AIOS Installer - Automated setup wizard for AIOS projects (greenfield & brownfield)",
-  "main": "src/index.js",
-  "bin": {
-    "aios-installer": "./src/index.js"
-  },
-  "scripts": {
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "test:unit": "jest tests/unit",
-    "test:integration": "jest tests/integration"
-  },
-  "keywords": [
-    "aios",
-    "installer",
-    "wizard",
-    "cli",
-    "setup",
-    "greenfield",
-    "brownfield"
-  ],
-  "author": "AIOS Fullstack Team",
-  "license": "MIT",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@clack/prompts": "^0.11.0",
-    "chalk": "^4.1.2",
-    "fs-extra": "^11.3.2"
-  },
-  "devDependencies": {
-    "jest": "^30.2.0"
-  }
-}
-
+{
+  "name": "@aios/installer",
+  "version": "2.1.0",
+  "description": "AIOS Installer - Automated setup wizard for AIOS projects (greenfield & brownfield)",
+  "main": "src/index.js",
+  "bin": {
+    "aios-installer": "./src/index.js"
+  },
+  "scripts": {
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:unit": "jest tests/unit",
+    "test:integration": "jest tests/integration"
+  },
+  "keywords": [
+    "aios",
+    "installer",
+    "wizard",
+    "cli",
+    "setup",
+    "greenfield",
+    "brownfield"
+  ],
+  "author": "AIOS Fullstack Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "chalk": "^4.1.2",
+    "fs-extra": "^11.3.2"
+  },
+  "devDependencies": {
+    "jest": "^30.2.0"
+  }
+}
+

package/templates/squad/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) {{year}} {{author}}
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) {{year}} {{author}}
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/templates/squad/README.md

@@ -1,37 +1,37 @@
-# {{Squad Name}}
-
-{{Brief description of what this Squad does}}
-
-## Installation
-
-```bash
-npm install {{squad-name}}
-```
-
-## Usage
-
-```bash
-# Activate the agent
-@{{agent-name}}
-
-# Use commands
-*{{command-name}}
-```
-
-## Features
-
-- Feature 1
-- Feature 2
-- Feature 3
-
-## Documentation
-
-See the [full documentation](docs/README.md) for detailed usage.
-
-## Contributing
-
-Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
-
-## License
-
-MIT License - see [LICENSE](LICENSE)
+# {{Squad Name}}
+
+{{Brief description of what this Squad does}}
+
+## Installation
+
+```bash
+npm install {{squad-name}}
+```
+
+## Usage
+
+```bash
+# Activate the agent
+@{{agent-name}}
+
+# Use commands
+*{{command-name}}
+```
+
+## Features
+
+- Feature 1
+- Feature 2
+- Feature 3
+
+## Documentation
+
+See the [full documentation](docs/README.md) for detailed usage.
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT License - see [LICENSE](LICENSE)

package/templates/squad/agents/example-agent.yaml

@@ -1,36 +1,36 @@
-# Example Agent Definition
-# Replace placeholders with your agent's details
-
-name: example-agent
-version: 1.0.0
-description: Brief description of what this agent does
-
-persona:
-  name: Example Agent
-  role: Your Agent's Role
-  expertise:
-    - Expertise Area 1
-    - Expertise Area 2
-    - Expertise Area 3
-
-capabilities:
-  - capability-one
-  - capability-two
-
-commands:
-  - name: example-command
-    description: What this command does
-    workflow: example-workflow
-
-system_prompt: |
-  You are Example Agent, specialized in [your domain].
-
-  Your responsibilities:
-  - Responsibility 1
-  - Responsibility 2
-  - Responsibility 3
-
-  Guidelines:
-  - Be helpful and precise
-  - Follow best practices
-  - Ask for clarification when needed
+# Example Agent Definition
+# Replace placeholders with your agent's details
+
+name: example-agent
+version: 1.0.0
+description: Brief description of what this agent does
+
+persona:
+  name: Example Agent
+  role: Your Agent's Role
+  expertise:
+    - Expertise Area 1
+    - Expertise Area 2
+    - Expertise Area 3
+
+capabilities:
+  - capability-one
+  - capability-two
+
+commands:
+  - name: example-command
+    description: What this command does
+    workflow: example-workflow
+
+system_prompt: |
+  You are Example Agent, specialized in [your domain].
+
+  Your responsibilities:
+  - Responsibility 1
+  - Responsibility 2
+  - Responsibility 3
+
+  Guidelines:
+  - Be helpful and precise
+  - Follow best practices
+  - Ask for clarification when needed