aios-core 2.1.3 → 2.1.5

package/.aios-core/infrastructure/scripts/llm-routing/install-llm-routing.js

@@ -70,7 +70,7 @@ function installLLMRouting(options = {}) {
     projectRoot = process.cwd(),
     templatesDir = path.join(__dirname, 'templates'),
     onProgress = console.log,
-    onError = console.error,
+    onError = console.error
   } = options;
 
   const result = {
@@ -78,7 +78,7 @@ function installLLMRouting(options = {}) {
     installDir: null,
     filesInstalled: [],
     envCreated: false,
-    errors: [],
+    errors: []
   };
 
   // Check templates exist
@@ -143,7 +143,7 @@ function installLLMRouting(options = {}) {
     try {
       fs.copyFileSync(envExample, envFile);
       result.envCreated = true;
-      onProgress('✅ Created .env from .env.example');
+      onProgress(`✅ Created .env from .env.example`);
     } catch (error) {
       result.success = false;
       result.errors.push(`Failed to create .env: ${error.message}`);
@@ -180,7 +180,7 @@ function updateClaudeConfig() {
     config.aiosLLMRouting = {
       version: LLM_ROUTING_VERSION,
       installedAt: new Date().toISOString(),
-      commands: ['claude-max', 'claude-free'],
+      commands: ['claude-max', 'claude-free']
     };
 
     fs.writeFileSync(claudeConfigPath, JSON.stringify(config, null, 2));
@@ -250,7 +250,7 @@ module.exports = {
   isLLMRoutingInstalled,
   getInstallDir,
   getInstallationSummary,
-  LLM_ROUTING_VERSION,
+  LLM_ROUTING_VERSION
 };
 
 // Run if executed directly
@@ -259,7 +259,7 @@ if (require.main === module) {
 
   const result = installLLMRouting({
     projectRoot: process.cwd(),
-    templatesDir: path.join(__dirname, 'templates'),
+    templatesDir: path.join(__dirname, 'templates')
   });
 
   const summary = getInstallationSummary(result);

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

@@ -2,7 +2,23 @@
 paths: **/*
 ---
 
-# MCP Server Usage Rules
+# 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
 
@@ -17,38 +33,68 @@ ALWAYS prefer native Claude Code tools over MCP servers:
 | Search content | `Grep` tool | docker-gateway |
 | List directories | `Bash(ls)` or `Glob` | docker-gateway |
 
-## docker-gateway (Desktop Commander) Restrictions
+## 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. User asks to run something inside a Docker container
+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 (use `Bash` tool)
+- 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 (use `Bash` tool)
+- Running Node.js or Python scripts on host (use `Bash` tool)
 
-## playwright MCP Restrictions
+## 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)
-- docker-gateway executes inside Docker containers (Linux)
+- **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 operations
+- 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-core",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "description": "AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "main": "index.js",
   "module": "index.esm.js",

package/packages/installer/src/config/templates/env-template.js

@@ -118,7 +118,7 @@ VERCEL_TOKEN=
 # AIOS Core Configuration
 # --------------------------------------------
 NODE_ENV=development
-AIOS_VERSION=2.1.3
+AIOS_VERSION=2.1.5
 
 # --------------------------------------------
 # Custom Configuration
@@ -230,7 +230,7 @@ VERCEL_TOKEN=
 # AIOS Core Configuration
 # --------------------------------------------
 NODE_ENV=development
-AIOS_VERSION=2.1.3
+AIOS_VERSION=2.1.5
 
 # --------------------------------------------
 # Custom Configuration

package/packages/installer/src/wizard/wizard.js

@@ -1,70 +1,46 @@
 const { detectProjectType } = require('../detection/detect-project-type');
-const {
-  detectInstallationMode,
-  getModeOptions,
-  validateModeSelection,
-  InstallationMode,
-} = require('../../../../.aios-core/infrastructure/scripts/documentation-integrity/mode-detector');
 
 /**
  * Interactive Wizard for AIOS Installation
- *
- * Supports three installation modes:
- * - GREENFIELD: New project - generates all docs and config
- * - BROWNFIELD: Existing project - analyzes and adapts
- * - FRAMEWORK_DEV: Contributing to aios-core itself
- *
+ * 
+ * This is a stub implementation that demonstrates the integration
+ * with the project type detection module (Story 1.3).
+ * Full wizard implementation is part of Story 1.2.
+ * 
  * @module wizard
- * @version 2.0.0
- * @story 6.9
  */
 
 /**
  * Run the interactive installer wizard
- *
+ * 
  * @param {Object} options - Wizard options
  * @param {string} options.targetDir - Target directory for installation
- * @param {string} options.mode - Pre-selected mode (skip detection)
  * @returns {Promise<Object>} Installation configuration
  */
 async function runWizard(options = {}) {
   const targetDir = options.targetDir || process.cwd();
-
+  
   try {
-    // Step 1: Welcome screen
+    // Step 1: Welcome screen (Story 1.2)
     console.log('🚀 Welcome to AIOS Installer\n');
-
-    // Step 2: Detect installation mode (Story 6.9)
-    console.log('📊 Analyzing project directory...');
-    const detected = detectInstallationMode(targetDir);
-    console.log(`✅ Detected: ${detected.mode} (${detected.reason})\n`);
-
-    // Step 3: Select installation mode (with user override)
-    const selectedMode = options.mode || (await selectInstallationMode(detected));
-
-    // Step 4: Validate selection
-    const validation = validateModeSelection(selectedMode, detected);
-    if (validation.warnings.length > 0) {
-      console.log('\n⚠️  Warnings:');
-      validation.warnings.forEach((w) => console.log(`   - ${w}`));
-      console.log('');
-    }
-
-    // Step 5: Mode-specific configuration
-    const modeConfig = await configureModeSpecific(selectedMode, targetDir, detected);
-
-    // Step 6: Continue with installation (Stories 1.4-1.8)
+    
+    // Step 2: Detect project type (THIS STORY - Story 1.3)
+    console.log('📊 Detecting project type...');
+    const detectedType = detectProjectType(targetDir);
+    console.log(`✅ Detected: ${detectedType}\n`);
+    
+    // Step 3: Confirm with user (Story 1.2)
+    const confirmedType = await confirmProjectType(detectedType);
+    
+    // Step 4: Continue with installation (Stories 1.4-1.8)
     // - IDE Selection (Story 1.4)
     // - MCP Installation (Story 1.5)
     // - Environment Config (Story 1.6)
     // - Validation (Story 1.8)
-
+    
     return {
-      projectType: detected.legacyType, // Backward compatibility
-      installationMode: selectedMode,
+      projectType: confirmedType,
       targetDir,
-      detected,
-      modeConfig,
       // Other configuration will be added by downstream stories
     };
   } catch (error) {
@@ -73,152 +49,29 @@ async function runWizard(options = {}) {
   }
 }
 
-/**
- * Select installation mode with user input
- *
- * @param {Object} detected - Detection result from mode detector
- * @returns {Promise<string>} Selected installation mode
- */
-async function selectInstallationMode(detected) {
-  const options = getModeOptions(detected);
-
-  console.log('Select installation type:\n');
-  options.forEach((opt, index) => {
-    const marker = opt.value === detected.mode ? '→' : ' ';
-    console.log(`${marker} ${index + 1}. ${opt.label}`);
-    console.log(`     ${opt.hint}\n`);
-  });
-
-  // Stub: In real implementation, use @clack/prompts select()
-  // For now, return detected mode or first option
-  console.log(`(Using detected mode: ${detected.mode})`);
-  console.log('(Interactive selection via @clack/prompts in Story 1.2)\n');
-
-  return detected.mode !== InstallationMode.UNKNOWN ? detected.mode : InstallationMode.GREENFIELD;
-}
-
-/**
- * Configure mode-specific settings
- *
- * @param {string} mode - Selected installation mode
- * @param {string} targetDir - Target directory
- * @param {Object} detected - Detection result
- * @returns {Promise<Object>} Mode-specific configuration
- */
-async function configureModeSpecific(mode, targetDir, detected) {
-  const config = {
-    mode,
-    generateDocs: true,
-    generateConfig: true,
-    generateGitignore: true,
-    runSetupGithub: false,
-    deployment: null,
-  };
-
-  switch (mode) {
-    case InstallationMode.FRAMEWORK_DEV:
-      // Framework development - skip project setup
-      console.log('🔧 Framework Development Mode');
-      console.log('   → Using existing framework standards');
-      console.log('   → Skipping project documentation generation');
-      console.log('   → Skipping infrastructure setup\n');
-      config.generateDocs = false;
-      config.generateConfig = false;
-      config.generateGitignore = false;
-      break;
-
-    case InstallationMode.GREENFIELD:
-      // New project - full scaffolding
-      console.log('🆕 Greenfield Mode');
-      console.log('   → Will generate project documentation');
-      console.log('   → Will create project-specific core-config');
-      console.log('   → Will generate .gitignore based on tech stack');
-      console.log('   → Will offer *setup-github for infrastructure\n');
-      config.runSetupGithub = true;
-      // Deployment config will be elicited in Phase 3
-      config.deployment = await elicitDeploymentConfig();
-      break;
-
-    case InstallationMode.BROWNFIELD:
-      // Existing project - analyze and adapt
-      console.log('📂 Brownfield Mode');
-      console.log('   → Will analyze existing source tree');
-      console.log('   → Will detect existing coding standards');
-      console.log('   → Will merge with existing .gitignore');
-      console.log('   → Will analyze existing GitHub workflows\n');
-      // Deployment config will be elicited based on analysis in Phase 3
-      config.deployment = await elicitDeploymentConfig();
-      break;
-
-    default:
-      console.log('❓ Unknown mode - using greenfield defaults\n');
-  }
-
-  return config;
-}
-
-/**
- * Elicit deployment configuration from user
- * Implements Task 3.3 from Story 6.9
- *
- * @returns {Promise<Object>} Deployment configuration
- */
-async function elicitDeploymentConfig() {
-  // Stub implementation - will be fully implemented in Phase 3
-  console.log('📦 Deployment Configuration');
-  console.log('   (Full elicitation will be implemented in Phase 3)\n');
-
-  // Return default staging-first workflow
-  return {
-    workflow: 'staging-first',
-    branches: {
-      staging_targets: ['feature/*', 'fix/*', 'docs/*', 'chore/*', 'refactor/*', 'test/*'],
-      production_targets: ['hotfix/*'],
-      staging_branch: 'staging',
-      production_branch: 'main',
-      default_target: 'staging',
-    },
-    environments: {
-      staging: {
-        name: 'Staging',
-        auto_deploy: true,
-        platform: null, // To be detected/elicited
-      },
-      production: {
-        name: 'Production',
-        auto_deploy: true,
-        platform: null,
-      },
-    },
-    quality_gates: {
-      lint: true,
-      typecheck: true,
-      tests: true,
-      security_scan: false,
-    },
-  };
-}
-
 /**
  * Confirm project type with user or allow override
- * @deprecated Use selectInstallationMode instead
- *
+ * 
  * @param {string} detectedType - Detected project type
  * @returns {Promise<string>} Confirmed project type
  */
 async function confirmProjectType(detectedType) {
-  // Kept for backward compatibility
+  // Stub implementation - full implementation in Story 1.2
+  // In real implementation, this would use @clack/prompts to ask user
+  
   const typeDescriptions = {
-    GREENFIELD: 'New project - AIOS will create complete structure',
-    BROWNFIELD: 'Existing project - AIOS will integrate with current setup',
-    EXISTING_AIOS: 'AIOS already installed - Would you like to update or reinstall?',
-    UNKNOWN: 'Unknown project type - Manual selection required',
+    'GREENFIELD': 'New project - AIOS will create complete structure',
+    'BROWNFIELD': 'Existing project - AIOS will integrate with current setup',
+    'EXISTING_AIOS': 'AIOS already installed - Would you like to update or reinstall?',
+    'UNKNOWN': 'Unknown project type - Manual selection required',
   };
-
+  
   console.log(`Project Type: ${detectedType}`);
   console.log(`Description: ${typeDescriptions[detectedType]}`);
-  console.log('(Use selectInstallationMode for new three-mode selection)\n');
-
+  console.log('(Interactive confirmation will be added in Story 1.2)\n');
+  
+  // For now, return the detected type
+  // Real implementation would prompt user to confirm or override
   return detectedType;
 }
 
@@ -234,11 +87,7 @@ function getProjectType(targetDir) {
 
 module.exports = {
   runWizard,
-  selectInstallationMode,
-  configureModeSpecific,
-  elicitDeploymentConfig,
-  confirmProjectType, // Deprecated - kept for backward compatibility
+  confirmProjectType,
   getProjectType,
-  InstallationMode,
 };
 

package/src/wizard/index.js

@@ -30,7 +30,7 @@ const {
 const {
   installLLMRouting,
   isLLMRoutingInstalled,
-  getInstallationSummary,
+  getInstallationSummary
 } = require('../../.aios-core/infrastructure/scripts/llm-routing/install-llm-routing');
 
 /**
@@ -484,7 +484,7 @@ async function runWizard() {
         const llmResult = installLLMRouting({
           projectRoot: process.cwd(),
           onProgress: (msg) => console.log(`   ${msg}`),
-          onError: (msg) => console.error(`   ${msg}`),
+          onError: (msg) => console.error(`   ${msg}`)
         });
 
         if (llmResult.success) {