aios-core 2.2.1 → 2.3.1

package/.aios-core/development/tasks/search-mcp.md

@@ -0,0 +1,309 @@
+# Search MCP Catalog Task
+
+> Search and discover available MCP servers in the Docker MCP Toolkit catalog.
+
+---
+
+## Task Definition
+
+```yaml
+task: searchMcp()
+responsavel: DevOps Agent
+responsavel_type: Agente
+atomic_layer: Infrastructure
+elicit: true
+
+**Entrada:**
+- campo: search_query
+  tipo: string
+  origem: User Input
+  obrigatorio: true
+  validacao: Search query for MCP catalog (e.g., "notion", "database", "slack")
+
+**Saida:**
+- campo: mcp_results
+  tipo: array
+  destino: Console output
+  persistido: false
+
+- campo: mcp_details
+  tipo: object
+  destino: Console output (if user selects an MCP)
+  persistido: false
+```
+
+---
+
+## Pre-Conditions
+
+```yaml
+pre-conditions:
+  - [ ] Docker MCP Toolkit running
+    tipo: pre-condition
+    blocker: true
+    validacao: docker mcp --version succeeds
+    error_message: "Docker MCP Toolkit required. Enable in Docker Desktop settings."
+
+  - [ ] Docker daemon running
+    tipo: pre-condition
+    blocker: true
+    validacao: docker info succeeds
+    error_message: "Start Docker Desktop before running this task"
+```
+
+---
+
+## Interactive Elicitation
+
+### Step 1: Search Query
+
+```
+ELICIT: MCP Search Query
+
+What type of MCP server are you looking for?
+
+Examples:
+  • "notion" - Workspace and document management
+  • "database" - Database integrations (postgres, mysql, sqlite)
+  • "slack" - Team messaging
+  • "browser" - Browser automation (puppeteer, playwright)
+  • "storage" - Cloud storage (s3, gcs)
+  • "*" - List all available MCPs
+
+→ Enter search query: _______________
+```
+
+### Step 2: Display Results
+
+```
+ELICIT: Search Results
+
+Found {n} MCPs matching "{query}":
+
+┌─────────────────────────────────────────────────────────────────┐
+│ #  │ MCP Name        │ Description                             │
+├─────────────────────────────────────────────────────────────────┤
+│ 1  │ mcp/notion      │ Notion workspace integration            │
+│ 2  │ mcp/postgres    │ PostgreSQL database access              │
+│ 3  │ mcp/sqlite      │ SQLite local database                   │
+│ 4  │ mcp/mysql       │ MySQL database access                   │
+└─────────────────────────────────────────────────────────────────┘
+
+Options:
+  • Enter a number to see details
+  • Type "add {number}" to add the MCP
+  • Type "search {query}" to search again
+  • Type "exit" to finish
+
+→ Select option: ___
+```
+
+### Step 3: Show MCP Details (Optional)
+
+```
+ELICIT: MCP Details
+
+📦 mcp/{name}
+
+Description: {full_description}
+
+🔧 Tools Provided:
+   • tool1 - Description of tool1
+   • tool2 - Description of tool2
+   • tool3 - Description of tool3
+
+🔑 Required Credentials:
+   • {CREDENTIAL_NAME} - {description}
+   • (none) - if no credentials needed
+
+📋 Example Usage:
+   docker mcp server add {name}
+   docker mcp tools call {name}.{tool} --param value
+
+Options:
+  • Type "add" to add this MCP
+  • Type "back" to return to results
+  • Type "exit" to finish
+
+→ Select option: ___
+```
+
+---
+
+## Implementation Steps
+
+### 1. Search the Catalog
+
+```bash
+# Basic search
+docker mcp catalog search {query}
+
+# Example: Search for "notion"
+docker mcp catalog search notion
+
+# List all MCPs
+docker mcp catalog search "*"
+
+# Example output:
+# NAME           DESCRIPTION
+# mcp/notion     Notion workspace integration
+# mcp/postgres   PostgreSQL database access
+```
+
+### 2. Get MCP Details
+
+```bash
+# Get detailed info about an MCP
+docker mcp catalog info {mcp-name}
+
+# Example: Get notion details
+docker mcp catalog info notion
+
+# Example output:
+# Name: mcp/notion
+# Description: Notion workspace integration
+# Tools:
+#   - getPage: Retrieve a Notion page
+#   - createPage: Create a new page
+#   - search: Search Notion workspace
+# Environment:
+#   - NOTION_API_KEY (required)
+```
+
+### 3. Filter by Category (if supported)
+
+```bash
+# Search by category
+docker mcp catalog search --category database
+docker mcp catalog search --category productivity
+docker mcp catalog search --category automation
+```
+
+---
+
+## Post-Conditions
+
+```yaml
+post-conditions:
+  - [ ] Search results displayed
+    tipo: post-condition
+    blocker: false
+    validacao: User can see matching MCPs or "no results" message
+    error_message: "Search failed - check Docker MCP connection"
+```
+
+---
+
+## Error Handling
+
+### Error: No Results Found
+
+```
+Resolution:
+1. Try a broader search query
+2. Use wildcards: docker mcp catalog search "*database*"
+3. Check available categories: docker mcp catalog categories
+4. Browse full catalog: docker mcp catalog search "*"
+```
+
+### Error: Docker MCP Not Available
+
+```
+Resolution:
+1. Verify Docker Desktop 4.50+ is installed
+2. Enable MCP Toolkit: Docker Desktop > Settings > Extensions > MCP Toolkit
+3. Restart Docker Desktop
+4. Verify: docker mcp --version
+```
+
+### Error: Catalog Timeout
+
+```
+Resolution:
+1. Check internet connection
+2. Docker MCP catalog requires network access
+3. Retry: docker mcp catalog search {query}
+4. Check Docker proxy settings if behind firewall
+```
+
+---
+
+## Success Output
+
+```
+✅ MCP Catalog Search Complete
+
+🔍 Query: "{query}"
+📦 Results: {n} MCPs found
+
+┌─────────────────────────────────────────────────────────────────┐
+│ MCP Name        │ Description              │ Credentials       │
+├─────────────────────────────────────────────────────────────────┤
+│ mcp/notion      │ Notion workspace         │ NOTION_API_KEY    │
+│ mcp/postgres    │ PostgreSQL access        │ DATABASE_URL      │
+│ mcp/sqlite      │ SQLite local DB          │ None              │
+└─────────────────────────────────────────────────────────────────┘
+
+Next steps:
+1. View details: *search-mcp → select number
+2. Add an MCP: *add-mcp {name}
+3. List enabled MCPs: *list-mcps
+```
+
+---
+
+## Common Search Examples
+
+| Search Query | Finds | Use Case |
+|--------------|-------|----------|
+| `notion` | Notion workspace MCP | Document management |
+| `database` | postgres, mysql, sqlite, redis | Database access |
+| `slack` | Slack messaging MCP | Team communication |
+| `browser` | puppeteer, playwright | Browser automation |
+| `storage` | s3, gcs, azure-blob | Cloud storage |
+| `github` | GitHub API MCP | Repository management |
+| `*` | All available MCPs | Browse full catalog |
+
+---
+
+## Related Commands
+
+| Command | Description |
+|---------|-------------|
+| `*add-mcp` | Add an MCP server to Docker MCP Toolkit |
+| `*list-mcps` | List currently enabled MCPs |
+| `*remove-mcp` | Remove an MCP from Docker MCP Toolkit |
+| `*setup-mcp-docker` | Initial Docker MCP Toolkit setup |
+
+---
+
+## Performance
+
+```yaml
+duration_expected: 1-2 minutes
+cost_estimated: $0 (local Docker operation)
+token_usage: ~200-500 tokens
+```
+
+---
+
+## Metadata
+
+```yaml
+task: search-mcp
+version: 1.0.0
+story: Story 6.14 - MCP Governance Consolidation
+dependencies:
+  - Docker MCP Toolkit
+  - Docker Desktop 4.50+
+tags:
+  - infrastructure
+  - mcp
+  - docker
+  - discovery
+  - catalog
+created_at: 2025-12-17
+updated_at: 2025-12-17
+agents:
+  - devops
+```

package/.aios-core/development/tasks/setup-mcp-docker.md

@@ -1,10 +1,10 @@
 # Setup Docker MCP Toolkit
 
 **Task ID:** setup-mcp-docker
-**Version:** 2.0.0
+**Version:** 2.1.0
 **Created:** 2025-12-08
-**Updated:** 2025-12-08
-**Agent:** @devops (Gage) / @dev (Dex)
+**Updated:** 2025-12-17
+**Agent:** @devops (Gage)
 
 ---
 
@@ -63,7 +63,7 @@ Configure Docker MCP Toolkit as the primary MCP infrastructure for AIOS, using *
 
 ```yaml
 task: setupMcpDocker()
-responsável: DevOps Agent / Dev Agent
+responsável: DevOps Agent
 responsavel_type: Agente
 atomic_layer: Infrastructure
 
@@ -556,8 +556,8 @@ token_usage: ~500-1,000 tokens (this task only)
 ## Metadata
 
 ```yaml
-story: Docker MCP Migration (Story 5.11)
-version: 2.0.0
+story: Story 6.14 - MCP Governance Consolidation
+version: 2.1.0
 dependencies:
   - Docker Desktop 4.50+
   - Docker MCP Toolkit
@@ -568,11 +568,14 @@ tags:
   - docker
   - setup
   - http-transport
-updated_at: 2025-12-08
+created_at: 2025-12-08
+updated_at: 2025-12-17
 agents:
   - devops
-  - dev
 changelog:
+  2.1.0:
+    - Changed: DevOps Agent now exclusive responsible (Story 6.14)
+    - Removed: Dev Agent from agents list
   2.0.0:
     - BREAKING: Changed from stdio to HTTP transport
     - Added: gateway-service.yml for persistent gateway

package/.aios-core/development/tasks/squad-creator-validate.md

@@ -0,0 +1,151 @@
+---
+task: Validate Squad
+responsável: @squad-creator
+responsável_type: agent
+atomic_layer: task
+Entrada: |
+  - squad_path: Path to the squad directory (default: ./squads/{name})
+  - name: Squad name (alternative to full path)
+  - strict: If true, warnings become errors (default: false)
+  - verbose: If true, show detailed output (default: false)
+Saída: |
+  - validation_result: Object with { valid, errors, warnings, suggestions }
+  - report: Formatted report for display
+  - exit_code: 0 if valid, 1 if invalid
+Checklist:
+  - [ ] Resolve squad path via squad-loader
+  - [ ] Execute squad-validator.validate()
+  - [ ] Format result for output
+  - [ ] Return appropriate exit code
+---
+
+# *validate-squad
+
+Validates a squad against the JSON Schema and TASK-FORMAT-SPECIFICATION-V1.
+
+## Usage
+
+```
+@squad-creator
+*validate-squad ./squads/my-squad
+*validate-squad my-squad
+*validate-squad my-squad --strict
+*validate-squad my-squad --verbose
+```
+
+## Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `squad_path` | string | - | Full path to squad directory |
+| `name` | string | - | Squad name (resolves to ./squads/{name}) |
+| `--strict` | flag | false | Treat warnings as errors |
+| `--verbose` | flag | false | Show detailed validation output |
+
+## Validation Checks
+
+### 1. Manifest Validation
+- Checks for `squad.yaml` or `config.yaml` (deprecated)
+- Validates against JSON Schema
+- Required fields: `name`, `version`
+
+### 2. Structure Validation
+- Checks for expected directories: `tasks/`, `agents/`
+- Verifies referenced files exist
+
+### 3. Task Validation (TASK-FORMAT-SPECIFICATION-V1)
+- Checks for required fields in task files
+- Validates naming conventions (kebab-case)
+
+### 4. Agent Validation
+- Checks for valid agent definition format
+- Validates naming conventions
+
+## Flow
+
+```
+1. Resolve squad path
+   ├── If full path provided → use directly
+   └── If name provided → resolve via ./squads/{name}/
+
+2. Execute validations
+   ├── validateManifest() → Schema check
+   ├── validateStructure() → Directory check
+   ├── validateTasks() → Task format check
+   └── validateAgents() → Agent format check
+
+3. Format and display result
+   ├── Show errors (if any)
+   ├── Show warnings (if any)
+   └── Show final result (VALID/INVALID)
+
+4. Return exit code
+   ├── 0 → Valid (or valid with warnings)
+   └── 1 → Invalid (errors found)
+```
+
+## Output Example
+
+```
+Validating squad: ./squads/my-squad/
+
+Errors: 0
+Warnings: 2
+  - [MISSING_DIRECTORY]: Expected directory not found: workflows/
+    Suggestion: mkdir workflows (task-first architecture recommends tasks/ and agents/)
+  - [TASK_MISSING_FIELD] (my-task.md): Task missing recommended field: Checklist
+    Suggestion: Add "Checklist:" to my-task.md (TASK-FORMAT-SPECIFICATION-V1)
+
+Result: VALID (with warnings)
+```
+
+## Error Codes
+
+| Code | Severity | Description |
+|------|----------|-------------|
+| `MANIFEST_NOT_FOUND` | Error | No squad.yaml or config.yaml found |
+| `YAML_PARSE_ERROR` | Error | Invalid YAML syntax |
+| `SCHEMA_ERROR` | Error | Manifest doesn't match JSON Schema |
+| `FILE_NOT_FOUND` | Error | Referenced file doesn't exist |
+| `DEPRECATED_MANIFEST` | Warning | Using config.yaml instead of squad.yaml |
+| `MISSING_DIRECTORY` | Warning | Expected directory not found |
+| `NO_TASKS` | Warning | No task files in tasks/ |
+| `TASK_MISSING_FIELD` | Warning | Task missing recommended field |
+| `AGENT_INVALID_FORMAT` | Warning | Agent file may not follow format |
+| `INVALID_NAMING` | Warning | Filename not in kebab-case |
+
+## Implementation
+
+```javascript
+const { SquadLoader } = require('./.aios-core/development/scripts/squad');
+const { SquadValidator } = require('./.aios-core/development/scripts/squad');
+
+async function validateSquad(options) {
+  const { squadPath, name, strict, verbose } = options;
+
+  // Resolve path
+  const loader = new SquadLoader();
+  let resolvedPath = squadPath;
+  if (!squadPath && name) {
+    const resolved = await loader.resolve(name);
+    resolvedPath = resolved.path;
+  }
+
+  // Validate
+  const validator = new SquadValidator({ strict, verbose });
+  const result = await validator.validate(resolvedPath);
+
+  // Format output
+  console.log(validator.formatResult(result, resolvedPath));
+
+  // Return exit code
+  return result.valid ? 0 : 1;
+}
+```
+
+## Related
+
+- **Story:** SQS-3 (Squad Validator + JSON Schema)
+- **Dependencies:** squad-loader.js, squad-validator.js
+- **Schema:** .aios-core/schemas/squad-schema.json
+- **Agent:** @squad-creator (Craft)

package/.aios-core/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md

@@ -30,7 +30,7 @@
               ↓
 ┌─────────────────────────────────────┐
 │   LAYER 2: Output Formatter         │  ← Template engine (JS)
-│   (.aios-core/scripts/)             │
+│   (.aios-core/infrastructure/scripts/)│
 └─────────────────────────────────────┘
               ↓
 ┌─────────────────────────────────────┐
@@ -156,7 +156,7 @@ archetypes:
 ### Template Engine Architecture
 
 ```javascript
-// .aios-core/scripts/output-formatter.js
+// .aios-core/infrastructure/scripts/output-formatter.js
 
 class PersonalizedOutputFormatter {
   constructor(agent, task, results) {
@@ -238,7 +238,7 @@ class PersonalizedOutputFormatter {
 ### Pattern Validation
 
 ```javascript
-// .aios-core/scripts/validate-output-pattern.js
+// .aios-core/infrastructure/scripts/validate-output-pattern.js
 
 /**
  * Ensures all task outputs follow standard structure

package/.aios-core/index.d.ts

@@ -1,8 +1,8 @@
-// @aios-fullstack/core - TypeScript Definitions
-export declare const MetaAgent: any;
-export declare const TaskManager: any;
-export declare const ElicitationEngine: any;
-export declare const TemplateEngine: any;
-export declare const ComponentSearch: any;
-export declare const DependencyAnalyzer: any;
+// @aios-fullstack/core - TypeScript Definitions
+export declare const MetaAgent: any;
+export declare const TaskManager: any;
+export declare const ElicitationEngine: any;
+export declare const TemplateEngine: any;
+export declare const ComponentSearch: any;
+export declare const DependencyAnalyzer: any;
 export {};

package/.aios-core/index.js

@@ -1,7 +1,7 @@
 // @synkra/aios-core/core - CommonJS Entry Point
 const MetaAgent = require('./infrastructure/scripts/component-generator.js');
 const TaskManager = require('./infrastructure/scripts/batch-creator.js');
-const ElicitationEngine = require('./scripts/elicitation-engine.js');
+const ElicitationEngine = require('./core/elicitation/elicitation-engine.js');
 const TemplateEngine = require('./infrastructure/scripts/template-engine.js');
 const ComponentSearch = require('./infrastructure/scripts/component-search.js');
 const DependencyAnalyzer = require('./infrastructure/scripts/dependency-analyzer.js');

package/.aios-core/infrastructure/scripts/batch-creator.js

@@ -7,7 +7,7 @@
 const fs = require('fs-extra');
 const path = require('path');
 const ComponentGenerator = require('./component-generator');
-const ElicitationEngine = require('../../scripts/elicitation-engine');
+const ElicitationEngine = require('../../core/elicitation/elicitation-engine');
 const DependencyAnalyzer = require('./dependency-analyzer');
 const TransactionManager = require('./transaction-manager');
 const chalk = require('chalk');

package/.aios-core/infrastructure/scripts/component-generator.js

@@ -10,7 +10,7 @@ const TemplateEngine = require('./template-engine');
 const TemplateValidator = require('./template-validator');
 const SecurityChecker = require('./security-checker');
 const YAMLValidator = require('./yaml-validator');
-const ElicitationEngine = require('../../scripts/elicitation-engine');
+const ElicitationEngine = require('../../core/elicitation/elicitation-engine');
 // const ComponentPreview = require('./component-preview'); // Archived in archived-utilities/ (Story 3.1.2)
 // const ManifestPreview = require('./manifest-preview'); // Archived in archived-utilities/ (Story 3.1.3)
 const ComponentMetadata = require('./component-metadata');