aios-core 2.1.6 → 2.2.1

package/.aios-core/core-config.yaml

@@ -1,382 +1,391 @@
-# ============================================
-# AIOS-FULLSTACK Core Configuration
-# Version: 2.1.0 (Consolidated from analysis of 6 variants)
-# Last Updated: 2025-11-29
-# ============================================
-
-# ============================================
-# SECTION 1: Framework Metadata
-# ============================================
-markdownExploder: true
-
-project:
-  type: EXISTING_AIOS
-  installedAt: "2025-01-14T00:00:00Z"
-  version: "2.1.0"
-
-# ============================================
-# SECTION 2: Documentation Paths
-# ============================================
-qa:
-  qaLocation: docs/qa
-
-prd:
-  prdFile: docs/prd.md
-  prdVersion: v4
-  prdSharded: true
-  prdShardedLocation: docs/prd
-  epicFilePattern: "epic-{n}*.md"
-
-architecture:
-  architectureFile: docs/architecture.md
-  architectureVersion: v4
-  architectureSharded: true
-  architectureShardedLocation: docs/architecture
-
-customTechnicalDocuments: null
-
-devLoadAlwaysFiles:
-  - docs/architecture/coding-standards.md
-  - docs/architecture/tech-stack.md
-  - docs/architecture/source-tree.md
-
-# Fallback patterns for Portuguese or alternative naming conventions
-# These will be tried if the primary files above are not found
-devLoadAlwaysFilesFallback:
-  # Portuguese variants
-  - docs/architecture/padroes-de-codigo.md
-  - docs/architecture/pilha-tecnologica.md
-  - docs/architecture/arvore-de-origem.md
-  # Alternative English names
-  - docs/architecture/code-standards.md
-  - docs/architecture/technology-stack.md
-  - docs/architecture/project-structure.md
-  - docs/architecture/unified-project-structure.md
-  - docs/architecture/directory-structure.md
-
-devDebugLog: .ai/debug-log.md
-devStoryLocation: docs/stories
-slashPrefix: AIOS
-
-# ============================================
-# SECTION 3: Resource Locations
-# ============================================
-toolsLocation: .aios-core/tools
-scriptsLocation: .aios-core/scripts
-dataLocation: .aios-core/data
-elicitationLocation: .aios-core/elicitation
-expansionPacksLocation: expansion-packs
-mindsLocation: outputs/minds
-
-# ============================================
-# SECTION 4: IDE Configuration
-# ============================================
-ide:
-  selected:
-    - vscode
-    - cursor
-    - claude-code
-  configs:
-    vscode: true
-    cursor: true
-    windsurf: false
-    zed: false
-    claude-desktop: false
-    claude-code: true
-
-# ============================================
-# SECTION 5: MCP Configuration
-# ============================================
-mcp:
-  enabled: true
-  configLocation: .claude/mcp.json
-
-  # Docker MCP Toolkit Configuration (Story 5.11)
-  # Updated: 2025-12-08 - Changed from stdio to HTTP transport to fix timeout
-  docker_mcp:
-    enabled: true
-
-    # Gateway Configuration - HTTP Transport (fixes 30s timeout issue)
-    # IMPORTANT: Use HTTP, NOT stdio - gateway must be pre-started as service
-    gateway:
-      transport: http  # HTTP/SSE transport for persistent service
-      url: "http://localhost:8080/mcp"
-      port: 8080
-      watch: true
-      service_file: ".docker/mcp/gateway-service.yml"
-
-    # AIOS Default Presets
-    # minimal: No API keys required (default for new installations)
-    # full: Requires EXA_API_KEY for web search
-    presets:
-      minimal:
-        servers: [context7, desktop-commander, playwright]
-        description: "Core MCPs - no API keys required"
-        api_keys_required: false
-        estimated_tokens: "10-15k"
-
-      full:
-        servers: [context7, desktop-commander, playwright, exa]
-        description: "All MCPs - requires EXA_API_KEY for exa"
-        api_keys_required: true
-        estimated_tokens: "20-25k"
-
-    defaultPreset: minimal  # No API keys needed for quick start
-
-    # Default MCPs for AIOS Installation
-    defaultServers:
-      - name: context7
-        description: "Up-to-date library documentation for LLMs"
-        config: {}
-        required: true
-        api_key_required: false
-
-      - name: desktop-commander
-        description: "File management, terminal commands, and system operations"
-        config:
-          paths:
-            - "${USER_HOME}"  # Resolves to user's home directory
-        required: true
-        api_key_required: false
-
-      - name: playwright
-        description: "Browser automation for testing and web interaction"
-        config: {}
-        required: true
-        api_key_required: false
-
-      - name: exa
-        description: "AI-powered web search and content extraction"
-        config:
-          apiKeys:
-            EXA_API_KEY: "${EXA_API_KEY}"
-        required: false  # Only in 'full' preset
-        api_key_required: true
-
-    # Commands reference
-    commands:
-      # Gateway management
-      start_gateway: "docker compose -f .docker/mcp/gateway-service.yml up -d"
-      stop_gateway: "docker compose -f .docker/mcp/gateway-service.yml down"
-      gateway_health: "curl http://localhost:8080/health"
-
-      # Server management
-      list_servers: "docker mcp server ls"
-      enable_server: "docker mcp server enable {name}"
-      disable_server: "docker mcp server disable {name}"
-
-      # Configuration
-      read_config: "docker mcp config read"
-      write_config: "docker mcp config write"
-
-    # Troubleshooting reference
-    troubleshooting:
-      timeout_issue: |
-        If Claude Code shows "Failed to connect to docker-gateway":
-        1. Ensure gateway is running: docker compose -f .docker/mcp/gateway-service.yml up -d
-        2. Check health: curl http://localhost:8080/health
-        3. Verify ~/.claude.json uses HTTP transport, NOT stdio
-      gateway_not_starting: |
-        1. Check Docker Desktop is running
-        2. Check port 8080 is available: netstat -an | grep 8080
-        3. Try alternate port in gateway-service.yml
-
-  # Legacy 1MCP Configuration (DEPRECATED - Story 5.11)
-  # Rollback: See docs/architecture/mcp-optimization-1mcp.md#rollback
-  # onemp:
-  #   enabled: false
-  #   port: 3050
-  #   presets: [aios-dev, aios-research, aios-pm, aios-full]
-
-# ============================================
-# SECTION 6: Performance & Caching
-# ============================================
-lazyLoading:
-  enabled: true
-  heavySections:
-    - pvMindContext
-    - expansionPacks
-    - registry
-
-git:
-  showConfigWarning: true
-  cacheTimeSeconds: 300
-
-# ============================================
-# SECTION 7: Logging & Status
-# ============================================
-decisionLogging:
-  enabled: true
-  async: true
-  location: .ai/
-  indexFile: decision-logs-index.md
-  format: adr
-  performance:
-    maxOverhead: 50
-
-projectStatus:
-  enabled: true
-  autoLoadOnAgentActivation: true
-  showInGreeting: true
-  cacheTimeSeconds: 60
-  components:
-    gitBranch: true
-    gitStatus: true
-    recentWork: true
-    currentEpic: true
-    currentStory: true
-  statusFile: .aios/project-status.yaml
-  maxModifiedFiles: 5
-  maxRecentCommits: 2
-
-agentIdentity:
-  greeting:
-    contextDetection: true
-    sessionDetection: hybrid
-    workflowDetection: hardcoded
-    performance:
-      gitCheckCache: true
-      gitCheckTTL: 300
-
-# ============================================
-# SECTION 8: GitHub Integration
-# ============================================
-github:
-  enabled: true
-  cli_required: false  # gh CLI enhances but not required
-  features:
-    pr_creation: true
-    issue_management: true
-
-# ============================================
-# SECTION 9: CodeRabbit Integration (Story 6.3.3)
-# MASTER TOGGLE: When enabled=false, ALL CodeRabbit behavior is disabled
-# ============================================
-coderabbit_integration:
-  enabled: true  # CodeRabbit CLI installed on this machine
-  installation_mode: wsl
-  wsl_config:
-    distribution: Ubuntu
-    installation_path: ~/.local/bin/coderabbit
-    working_directory: /mnt/c/Users/AllFluence-User/Workspaces/AIOS/AIOS-V4/aios-fullstack
-
-  # Self-healing configuration
-  self_healing:
-    enabled: true
-    type: full
-    max_iterations: 3
-    timeout_minutes: 30
-
-  # Severity handling by agent type
-  severity_handling:
-    CRITICAL: auto_fix        # Block and auto-fix (must resolve)
-    HIGH: auto_fix            # Auto-fix (recommend fix)
-    MEDIUM: document_as_debt  # Create tech debt issue
-    LOW: ignore               # Note in review, no action
-
-  # Graceful degradation for machines without CodeRabbit
-  graceful_degradation:
-    skip_if_not_installed: true
-    fallback_message: "CodeRabbit CLI not found. Skipping automated review. Install via: pip install coderabbit-cli"
-
-  # CLI commands (WSL wrapper for Windows)
-  commands:
-    qa_pre_review_uncommitted: |
-      wsl bash -c 'cd /mnt/c/Users/AllFluence-User/Workspaces/AIOS/AIOS-V4/aios-fullstack && ~/.local/bin/coderabbit --prompt-only -t uncommitted'
-    qa_story_review_committed: |
-      wsl bash -c 'cd /mnt/c/Users/AllFluence-User/Workspaces/AIOS/AIOS-V4/aios-fullstack && ~/.local/bin/coderabbit --prompt-only -t committed --base main'
-
-  report_location: docs/qa/coderabbit-reports/
-
-# ============================================
-# SECTION 10: Expansion Packs
-# ============================================
-expansionPacks:
-  location: expansion-packs
-  installed:
-    - hybrid-ops
-  autoLoad: false
-
-pvMindContext:
-  enabled: true
-  location: outputs/minds/pedro_valerio
-  features:
-    persona_voice: true
-    technical_depth: advanced
-    communication_style: structured
-
-storyBacklog:
-  enabled: true
-  location: docs/stories/backlog
-  prioritization: value_risk
-
-# ============================================
-# SECTION 11: Utility Scripts Registry (Stories 3.4 + 3.5)
-# Utilities are categorized by integration pattern
-# ============================================
-utils:
-  # Agent Helper utilities (28) - Used directly by agents
-  helpers:
-    - batch-creator
-    - capability-analyzer
-    - change-propagation-predictor
-    - clickup-helpers  # Located at common/utils/clickup-helpers.js
-    - code-quality-improver
-    - compatibility-checker
-    - component-metadata
-    - component-preview
-    - conflict-manager
-    - coverage-analyzer
-    - dependency-analyzer
-    - diff-generator
-    - framework-analyzer
-    - git-wrapper
-    - manifest-preview
-    - migration-path-generator
-    - migration-tester
-    - modification-history
-    - modification-risk-assessment
-    - modification-validator
-    - performance-analyzer
-    - redundancy-analyzer
-    - refactoring-suggester
-    - sandbox-tester
-    - template-validator
-    - test-quality-assessment
-    - validate-filenames
-    - version-tracker
-    - visual-impact-generator
-
-  # Task Execution utilities (18) - Called during task execution
-  executors:
-    - approval-workflow
-    - branch-manager
-    - commit-message-generator
-    - component-generator
-    - component-search
-    - conflict-resolver
-    - deprecation-manager
-    - dependency-impact-analyzer
-    - documentation-synchronizer
-    - migration-generator
-    - migration-rollback
-    - modification-synchronizer
-    - performance-optimizer
-    - rollback-handler
-    - safe-removal-handler
-    - test-generator
-    - test-updater
-
-  # Framework utilities (11) - Framework-level components
-  framework:
-    - elicitation-engine
-    - elicitation-session-manager
-    - improvement-engine
-    - improvement-validator  # Mapped from util-aios-validator
-    - metrics-tracker
-    - pattern-learner
-    - template-engine
-    - test-template-system
-    - transaction-manager
-    - usage-analytics
-    - usage-tracker
+# ============================================
+# AIOS Core Configuration
+# Version: 2.3.0 (Story 6.11 - Framework Docs Consolidation)
+# Last Updated: 2025-12-14
+# ============================================
+
+# ============================================
+# SECTION 1: Framework Metadata
+# ============================================
+markdownExploder: true
+
+project:
+  type: EXISTING_AIOS
+  installedAt: "2025-01-14T00:00:00Z"
+  version: "2.1.0"
+
+# ============================================
+# SECTION 2: Documentation Paths
+# ============================================
+qa:
+  qaLocation: docs/qa
+
+prd:
+  prdFile: docs/prd.md
+  prdVersion: v4
+  prdSharded: true
+  prdShardedLocation: docs/prd
+  epicFilePattern: "epic-{n}*.md"
+
+architecture:
+  architectureFile: docs/architecture.md
+  architectureVersion: v4
+  architectureSharded: true
+  architectureShardedLocation: docs/architecture
+
+customTechnicalDocuments: null
+
+# Official framework documentation location (Story 6.11)
+# Prefer docs/framework/ for portable framework standards
+# docs/architecture/ contains project-specific analysis and decisions
+devLoadAlwaysFiles:
+  - docs/framework/coding-standards.md
+  - docs/framework/tech-stack.md
+  - docs/framework/source-tree.md
+
+# Fallback patterns for backward compatibility and alternative naming
+# These will be tried if the primary files above are not found
+devLoadAlwaysFilesFallback:
+  # Backward compatibility - old architecture location (deprecated)
+  - docs/architecture/coding-standards.md
+  - docs/architecture/tech-stack.md
+  - docs/architecture/source-tree.md
+  # Portuguese variants
+  - docs/architecture/padroes-de-codigo.md
+  - docs/architecture/pilha-tecnologica.md
+  - docs/architecture/arvore-de-origem.md
+  # Alternative English names
+  - docs/architecture/code-standards.md
+  - docs/architecture/technology-stack.md
+  - docs/architecture/project-structure.md
+  - docs/architecture/unified-project-structure.md
+  - docs/architecture/directory-structure.md
+
+devDebugLog: .ai/debug-log.md
+devStoryLocation: docs/stories
+slashPrefix: AIOS
+
+# ============================================
+# SECTION 3: Resource Locations
+# ============================================
+toolsLocation: .aios-core/tools
+scriptsLocation: .aios-core/scripts
+dataLocation: .aios-core/data
+elicitationLocation: .aios-core/elicitation
+# Squads replaced Squads in OSR-8 - see docs/guides/squads-guide.md
+squadsTemplateLocation: templates/squad
+mindsLocation: outputs/minds
+
+# ============================================
+# SECTION 4: IDE Configuration
+# ============================================
+ide:
+  selected:
+    - vscode
+    - cursor
+    - claude-code
+  configs:
+    vscode: true
+    cursor: true
+    windsurf: false
+    zed: false
+    claude-desktop: false
+    claude-code: true
+
+# ============================================
+# SECTION 5: MCP Configuration
+# ============================================
+mcp:
+  enabled: true
+  configLocation: .claude/mcp.json
+
+  # Docker MCP Toolkit Configuration (Story 5.11)
+  # Updated: 2025-12-08 - Changed from stdio to HTTP transport to fix timeout
+  docker_mcp:
+    enabled: true
+
+    # Gateway Configuration - HTTP Transport (fixes 30s timeout issue)
+    # IMPORTANT: Use HTTP, NOT stdio - gateway must be pre-started as service
+    gateway:
+      transport: http  # HTTP/SSE transport for persistent service
+      url: "http://localhost:8080/mcp"
+      port: 8080
+      watch: true
+      service_file: ".docker/mcp/gateway-service.yml"
+
+    # AIOS Default Presets
+    # minimal: No API keys required (default for new installations)
+    # full: Requires EXA_API_KEY for web search
+    presets:
+      minimal:
+        servers: [context7, desktop-commander, playwright]
+        description: "Core MCPs - no API keys required"
+        api_keys_required: false
+        estimated_tokens: "10-15k"
+
+      full:
+        servers: [context7, desktop-commander, playwright, exa]
+        description: "All MCPs - requires EXA_API_KEY for exa"
+        api_keys_required: true
+        estimated_tokens: "20-25k"
+
+    defaultPreset: minimal  # No API keys needed for quick start
+
+    # Default MCPs for AIOS Installation
+    defaultServers:
+      - name: context7
+        description: "Up-to-date library documentation for LLMs"
+        config: {}
+        required: true
+        api_key_required: false
+
+      - name: desktop-commander
+        description: "File management, terminal commands, and system operations"
+        config:
+          paths:
+            - "${USER_HOME}"  # Resolves to user's home directory
+        required: true
+        api_key_required: false
+
+      - name: playwright
+        description: "Browser automation for testing and web interaction"
+        config: {}
+        required: true
+        api_key_required: false
+
+      - name: exa
+        description: "AI-powered web search and content extraction"
+        config:
+          apiKeys:
+            EXA_API_KEY: "${EXA_API_KEY}"
+        required: false  # Only in 'full' preset
+        api_key_required: true
+
+    # Commands reference
+    commands:
+      # Gateway management
+      start_gateway: "docker compose -f .docker/mcp/gateway-service.yml up -d"
+      stop_gateway: "docker compose -f .docker/mcp/gateway-service.yml down"
+      gateway_health: "curl http://localhost:8080/health"
+
+      # Server management
+      list_servers: "docker mcp server ls"
+      enable_server: "docker mcp server enable {name}"
+      disable_server: "docker mcp server disable {name}"
+
+      # Configuration
+      read_config: "docker mcp config read"
+      write_config: "docker mcp config write"
+
+    # Troubleshooting reference
+    troubleshooting:
+      timeout_issue: |
+        If Claude Code shows "Failed to connect to docker-gateway":
+        1. Ensure gateway is running: docker compose -f .docker/mcp/gateway-service.yml up -d
+        2. Check health: curl http://localhost:8080/health
+        3. Verify ~/.claude.json uses HTTP transport, NOT stdio
+      gateway_not_starting: |
+        1. Check Docker Desktop is running
+        2. Check port 8080 is available: netstat -an | grep 8080
+        3. Try alternate port in gateway-service.yml
+
+  # Legacy 1MCP Configuration (DEPRECATED - Story 5.11)
+  # Rollback: See docs/architecture/mcp-optimization-1mcp.md#rollback
+  # onemp:
+  #   enabled: false
+  #   port: 3050
+  #   presets: [aios-dev, aios-research, aios-pm, aios-full]
+
+# ============================================
+# SECTION 6: Performance & Caching
+# ============================================
+lazyLoading:
+  enabled: true
+  heavySections:
+    - pvMindContext
+    - squads
+    - registry
+
+git:
+  showConfigWarning: true
+  cacheTimeSeconds: 300
+
+# ============================================
+# SECTION 7: Logging & Status
+# ============================================
+decisionLogging:
+  enabled: true
+  async: true
+  location: .ai/
+  indexFile: decision-logs-index.md
+  format: adr
+  performance:
+    maxOverhead: 50
+
+projectStatus:
+  enabled: true
+  autoLoadOnAgentActivation: true
+  showInGreeting: true
+  cacheTimeSeconds: 60
+  components:
+    gitBranch: true
+    gitStatus: true
+    recentWork: true
+    currentEpic: true
+    currentStory: true
+  statusFile: .aios/project-status.yaml
+  maxModifiedFiles: 5
+  maxRecentCommits: 2
+
+agentIdentity:
+  greeting:
+    contextDetection: true
+    sessionDetection: hybrid
+    workflowDetection: hardcoded
+    performance:
+      gitCheckCache: true
+      gitCheckTTL: 300
+
+# ============================================
+# SECTION 8: GitHub Integration
+# ============================================
+github:
+  enabled: true
+  cli_required: false  # gh CLI enhances but not required
+  features:
+    pr_creation: true
+    issue_management: true
+
+# ============================================
+# SECTION 9: CodeRabbit Integration (Story 6.3.3)
+# MASTER TOGGLE: When enabled=false, ALL CodeRabbit behavior is disabled
+# ============================================
+coderabbit_integration:
+  enabled: true  # CodeRabbit CLI installed on this machine
+  installation_mode: wsl
+  wsl_config:
+    distribution: Ubuntu
+    installation_path: ~/.local/bin/coderabbit
+    working_directory: /mnt/c/Users/AllFluence-User/Workspaces/AIOS/SynkraAI/aios-core
+
+  # Self-healing configuration
+  self_healing:
+    enabled: true
+    type: full
+    max_iterations: 3
+    timeout_minutes: 30
+
+  # Severity handling by agent type
+  severity_handling:
+    CRITICAL: auto_fix        # Block and auto-fix (must resolve)
+    HIGH: auto_fix            # Auto-fix (recommend fix)
+    MEDIUM: document_as_debt  # Create tech debt issue
+    LOW: ignore               # Note in review, no action
+
+  # Graceful degradation for machines without CodeRabbit
+  graceful_degradation:
+    skip_if_not_installed: true
+    fallback_message: "CodeRabbit CLI not found. Skipping automated review. Install via: pip install coderabbit-cli"
+
+  # CLI commands (WSL wrapper for Windows)
+  commands:
+    qa_pre_review_uncommitted: |
+      wsl bash -c 'cd /mnt/c/Users/AllFluence-User/Workspaces/AIOS/SynkraAI/aios-core && ~/.local/bin/coderabbit --prompt-only -t uncommitted'
+    qa_story_review_committed: |
+      wsl bash -c 'cd /mnt/c/Users/AllFluence-User/Workspaces/AIOS/SynkraAI/aios-core && ~/.local/bin/coderabbit --prompt-only -t committed --base main'
+
+  report_location: docs/qa/coderabbit-reports/
+
+# ============================================
+# SECTION 10: Squads System (replaced Expansion Packs in OSR-8)
+# See docs/guides/squads-guide.md for full documentation
+# ============================================
+squads:
+  templateLocation: templates/squad
+  # Squads are created from template, not pre-installed
+  # Use: cp -r templates/squad/ squads/my-squad-name/
+  autoLoad: false
+
+pvMindContext:
+  enabled: true
+  location: outputs/minds/pedro_valerio
+  features:
+    persona_voice: true
+    technical_depth: advanced
+    communication_style: structured
+
+storyBacklog:
+  enabled: true
+  location: docs/stories/backlog
+  prioritization: value_risk
+
+# ============================================
+# SECTION 11: Utility Scripts Registry (Stories 3.4 + 3.5)
+# Utilities are categorized by integration pattern
+# ============================================
+utils:
+  # Agent Helper utilities (28) - Used directly by agents
+  helpers:
+    - batch-creator
+    - capability-analyzer
+    - change-propagation-predictor
+    - clickup-helpers  # Located at common/utils/clickup-helpers.js
+    - code-quality-improver
+    - compatibility-checker
+    - component-metadata
+    - component-preview
+    - conflict-manager
+    - coverage-analyzer
+    - dependency-analyzer
+    - diff-generator
+    - framework-analyzer
+    - git-wrapper
+    - manifest-preview
+    - migration-path-generator
+    - migration-tester
+    - modification-history
+    - modification-risk-assessment
+    - modification-validator
+    - performance-analyzer
+    - redundancy-analyzer
+    - refactoring-suggester
+    - sandbox-tester
+    - template-validator
+    - test-quality-assessment
+    - validate-filenames
+    - version-tracker
+    - visual-impact-generator
+
+  # Task Execution utilities (18) - Called during task execution
+  executors:
+    - approval-workflow
+    - branch-manager
+    - commit-message-generator
+    - component-generator
+    - component-search
+    - conflict-resolver
+    - deprecation-manager
+    - dependency-impact-analyzer
+    - documentation-synchronizer
+    - migration-generator
+    - migration-rollback
+    - modification-synchronizer
+    - performance-optimizer
+    - rollback-handler
+    - safe-removal-handler
+    - test-generator
+    - test-updater
+
+  # Framework utilities (11) - Framework-level components
+  framework:
+    - elicitation-engine
+    - elicitation-session-manager
+    - improvement-engine
+    - improvement-validator  # Mapped from util-aios-validator
+    - metrics-tracker
+    - pattern-learner
+    - template-engine
+    - test-template-system
+    - transaction-manager
+    - usage-analytics
+    - usage-tracker