aios-core 2.1.5 → 2.1.6

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

@@ -1,46 +1,70 @@
 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
- * 
- * 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.
- * 
+ *
+ * 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
+ *
  * @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 (Story 1.2)
+    // Step 1: Welcome screen
     console.log('🚀 Welcome to AIOS Installer\n');
-    
-    // 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)
+
+    // 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)
     // - IDE Selection (Story 1.4)
     // - MCP Installation (Story 1.5)
     // - Environment Config (Story 1.6)
     // - Validation (Story 1.8)
-    
+
     return {
-      projectType: confirmedType,
+      projectType: detected.legacyType, // Backward compatibility
+      installationMode: selectedMode,
       targetDir,
+      detected,
+      modeConfig,
       // Other configuration will be added by downstream stories
     };
   } catch (error) {
@@ -49,29 +73,152 @@ 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) {
-  // Stub implementation - full implementation in Story 1.2
-  // In real implementation, this would use @clack/prompts to ask user
-  
+  // Kept for backward compatibility
   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('(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
+  console.log('(Use selectInstallationMode for new three-mode selection)\n');
+
   return detectedType;
 }
 
@@ -87,7 +234,11 @@ function getProjectType(targetDir) {
 
 module.exports = {
   runWizard,
-  confirmProjectType,
+  selectInstallationMode,
+  configureModeSpecific,
+  elicitDeploymentConfig,
+  confirmProjectType, // Deprecated - kept for backward compatibility
   getProjectType,
+  InstallationMode,
 };
 

package/packages/installer/tests/integration/environment-configuration.test.js

@@ -9,6 +9,7 @@ const fs = require('fs-extra');
 const path = require('path');
 const os = require('os');
 const { configureEnvironment, updateGitignore } = require('../../src/config/configure-environment');
+const pkg = require('../../../../package.json');
 
 /**
  * Cleanup helper with retry logic for flaky file system operations
@@ -72,7 +73,7 @@ describe('Environment Configuration Integration', () => {
 
       const content = await fs.readFile(envPath, 'utf8');
       expect(content).toContain('NODE_ENV=development');
-      expect(content).toContain('AIOS_VERSION=2.1.0');
+      expect(content).toContain(`AIOS_VERSION=${pkg.version}`);
     });
 
     it('should create .env.example file', async () => {

package/packages/installer/tests/unit/env-template.test.js

@@ -6,6 +6,7 @@
  */
 
 const { generateEnvContent, generateEnvExample } = require('../../src/config/templates/env-template');
+const pkg = require('../../../../package.json');
 
 describe('.env Template Generator', () => {
   describe('generateEnvContent', () => {
@@ -13,7 +14,7 @@ describe('.env Template Generator', () => {
       const content = generateEnvContent();
 
       expect(content).toContain('NODE_ENV=development');
-      expect(content).toContain('AIOS_VERSION=2.1.0');
+      expect(content).toContain(`AIOS_VERSION=${pkg.version}`);
       expect(content).toContain('OPENAI_API_KEY=');
       expect(content).toContain('ANTHROPIC_API_KEY=');
       expect(content).toContain('# AIOS Environment Configuration');
@@ -83,7 +84,7 @@ describe('.env Template Generator', () => {
       const content = generateEnvExample();
 
       expect(content).toContain('NODE_ENV=development');
-      expect(content).toContain('AIOS_VERSION=2.1.0');
+      expect(content).toContain(`AIOS_VERSION=${pkg.version}`);
       expect(content).toContain('OPENAI_API_KEY=');
       expect(content).toContain('ANTHROPIC_API_KEY=');
       expect(content).toContain('CLICKUP_API_KEY=');

package/.aios-core/development/tasks/validate-structure.md

@@ -1,243 +0,0 @@
-# validate-structure
-
-**Task ID:** validate-structure
-**Version:** 1.0.0
-**Agent:** @architect (Aria)
-**Story:** 6.8 - Source-Tree Guardian
-
----
-
-## Purpose
-
-Validate file placement decisions against AIOS source-tree standards before implementation begins.
-
-**This task is MANDATORY for all stories that create new files.**
-
----
-
-## When to Use
-
-- Before starting implementation of any story
-- When planning new modules or features
-- During architecture review
-- Before PR submission
-
----
-
-## Prerequisites
-
-- Story file exists with implementation plan
-- Source-tree-guardian module installed
-- Access to `docs/architecture/source-tree.md`
-
----
-
-## Execution
-
-### Step 1: List New Files
-
-List all files that will be created in this story:
-
-| File | Purpose | Category |
-|------|---------|----------|
-| {path} | {purpose} | {agent/task/script/test/etc} |
-
-### Step 2: Validate Each File
-
-For each file, run placement validation:
-
-```bash
-npm run validate:structure -- --check "{file_path}"
-```
-
-Or validate all planned files at once:
-
-```bash
-npm run validate:structure -- --files "{glob_pattern}"
-```
-
-### Step 3: Document Decisions
-
-Add the following section to the story file:
-
-```markdown
-## Structure Validation
-
-| File | Validated Location | Approved |
-|------|-------------------|----------|
-| {file} | {location} | ✅/❌ |
-
-**Validated by:** @architect (Aria)
-**Date:** {YYYY-MM-DD}
-**Violations:** {count}
-**Notes:** {any special decisions}
-```
-
-### Step 4: Handle Violations
-
-If violations exist:
-
-1. **Review the violation message** - Understand why the location is flagged
-2. **Propose correct location** - Use suggested location or justify alternative
-3. **Get PO approval** - If deviation from standard is needed
-4. **Document reasoning** - Create ADR if significant deviation
-5. **Update story** - Mark as resolved or approved exception
-
----
-
-## Task Definition (YAML)
-
-```yaml
-task: validateStructure()
-responsável: Aria (Architect)
-responsavel_type: Agente
-atomic_layer: Molecule
-elicit: true
-
-Entrada:
-  - campo: story_files
-    tipo: array
-    origem: Story implementation plan
-    obrigatório: true
-    descrição: List of files to be created/modified
-
-  - campo: story_path
-    tipo: string
-    origem: User input or context
-    obrigatório: true
-    descrição: Path to the story file
-
-Saída:
-  - campo: placement_report
-    tipo: object
-    destino: Story file (## Structure Validation section)
-    persistido: true
-
-  - campo: violations
-    tipo: array
-    destino: Console output
-    persistido: false
-
-Elicitation:
-  - prompt: "What files will be created in this story?"
-    type: list
-    required: true
-    help: "List each file with its full path"
-
-  - prompt: "For each file, what is its purpose?"
-    type: text
-    required: true
-    help: "Brief description of what each file does"
-
-  - prompt: "What category does each file belong to?"
-    type: select
-    options:
-      - agent
-      - task
-      - script
-      - template
-      - checklist
-      - test
-      - documentation
-      - configuration
-      - other
-    required: true
-```
-
----
-
-## Checklist
-
-Use this checklist to ensure complete validation:
-
-- [ ] All new files have been listed
-- [ ] Each file has been validated against source-tree.md
-- [ ] Placement decisions are documented in story
-- [ ] Any violations have been resolved or approved
-- [ ] @architect sign-off is complete
-- [ ] Story "Structure Validation" section is populated
-
----
-
-## CLI Commands Reference
-
-```bash
-# Full validation
-npm run validate:structure
-
-# Check single file
-npm run validate:structure -- --check "path/to/file.js"
-
-# Check multiple files with glob
-npm run validate:structure -- --files "src/**/*.js"
-
-# Generate manifest
-npm run validate:structure -- --generate-manifest
-
-# Show suggestions for violations
-npm run validate:structure -- --fix
-
-# JSON output for automation
-npm run validate:structure -- --json
-
-# Verbose output
-npm run validate:structure -- --verbose
-```
-
----
-
-## Common Violations & Resolutions
-
-### Scripts at Root Level
-
-**Violation:** `Scripts at root level are not allowed`
-
-**Resolution:**
-- Move to `.aios-core/infrastructure/scripts/{category}/`
-- Example: `scripts/foo.js` → `.aios-core/infrastructure/scripts/foo.js`
-
-### Tools at Root Level
-
-**Violation:** `Tool definitions at root level are not allowed`
-
-**Resolution:**
-- Move to `.aios-core/infrastructure/tools/cli/` for CLI tools
-- Move to `.aios-core/infrastructure/tools/mcp/` for MCP tools
-
-### Agents in Wrong Location
-
-**Violation:** `Agent files at root level are not allowed`
-
-**Resolution:**
-- Move to `.aios-core/development/agents/`
-- Ensure naming follows kebab-case: `{agent-name}.md`
-
-### Tasks in Wrong Location
-
-**Violation:** `Task files at root level are not allowed`
-
-**Resolution:**
-- Move to `.aios-core/development/tasks/`
-- Ensure naming follows kebab-case: `{task-name}.md`
-
----
-
-## Integration Points
-
-- **Pre-commit Hook:** Runs automatically on `git commit`
-- **CI/CD Pipeline:** Can be integrated with `npm run validate:structure -- --json`
-- **Story Workflow:** Executed by @architect before @dev implementation
-
----
-
-## Related Resources
-
-- [Source Tree Structure](../../docs/architecture/source-tree.md)
-- [Coding Standards](../../docs/architecture/coding-standards.md)
-- [Story 6.8: Source-Tree Guardian](../../docs/stories/v2.1/sprint-6/story-6.8-source-tree-guardian.md)
-
----
-
-**Created:** 2025-12-14
-**Author:** @architect (Aria)
-**Story:** 6.8 - Source-Tree Guardian