aios-core 4.0.2 → 4.1.0

package/packages/installer/src/pro/pro-scaffolder.js

@@ -0,0 +1,335 @@
+/**
+ * Pro Content Scaffolder
+ *
+ * Copies premium content (squads, configs, feature registry) from
+ * node_modules/@aios-fullstack/pro/ into the user's project after
+ * license activation.
+ *
+ * @module packages/installer/src/pro/pro-scaffolder
+ * @story INS-3.1 — Implement Pro Content Scaffolder
+ */
+
+'use strict';
+
+const fs = require('fs-extra');
+const path = require('path');
+const yaml = require('js-yaml');
+const { hashFileAsync, hashFilesMatchAsync } = require('../installer/file-hasher');
+
+/**
+ * Items to scaffold from pro package into user project.
+ * Each entry defines source (relative to proSourceDir) and dest (relative to targetDir).
+ */
+const SCAFFOLD_ITEMS = [
+  {
+    type: 'directory',
+    source: 'squads',
+    dest: 'squads',
+    description: 'Pro squads',
+    required: true,
+  },
+  {
+    type: 'file',
+    source: 'pro-config.yaml',
+    dest: path.join('.aios-core', 'pro-config.yaml'),
+    description: 'Pro configuration',
+    required: true,
+  },
+  {
+    type: 'file',
+    source: 'feature-registry.yaml',
+    dest: path.join('.aios-core', 'feature-registry.yaml'),
+    description: 'Feature registry',
+    required: false,
+  },
+];
+
+/**
+ * Scaffold pro content into user project.
+ *
+ * @param {string} targetDir - Project root directory
+ * @param {string} proSourceDir - Path to pro package content (node_modules/@aios-fullstack/pro)
+ * @param {Object} [options={}] - Scaffold options
+ * @param {Function} [options.onProgress] - Progress callback ({item, status, message})
+ * @param {boolean} [options.force=false] - Force overwrite even if content exists
+ * @returns {Promise<Object>} Scaffold result with copiedFiles, warnings, manifest
+ */
+async function scaffoldProContent(targetDir, proSourceDir, options = {}) {
+  const { onProgress = null, force = false } = options;
+
+  const result = {
+    success: false,
+    copiedFiles: [],
+    skippedFiles: [],
+    warnings: [],
+    errors: [],
+    manifest: null,
+    versionInfo: null,
+  };
+
+  // Track files for rollback on partial failure
+  const rollbackFiles = [];
+
+  // Validate pro source exists
+  if (!await fs.pathExists(proSourceDir)) {
+    result.errors.push(
+      `Pro package not found at ${proSourceDir}. Run "npm install @aios-fullstack/pro" first.`
+    );
+    return result;
+  }
+
+  try {
+    for (const item of SCAFFOLD_ITEMS) {
+      const sourcePath = path.join(proSourceDir, item.source);
+      const destPath = path.join(targetDir, item.dest);
+
+      // Check source exists
+      if (!await fs.pathExists(sourcePath)) {
+        if (item.required) {
+          throw new Error(`Required pro content not found: ${item.source}`);
+        }
+        const warning = `${item.description} (${item.source}) not found in pro package — skipping`;
+        result.warnings.push(warning);
+        if (onProgress) {
+          onProgress({ item: item.source, status: 'warning', message: warning });
+        }
+        continue;
+      }
+
+      if (item.type === 'directory') {
+        const copied = await scaffoldDirectory(sourcePath, destPath, { force, rollbackFiles, baseDir: targetDir });
+        result.copiedFiles.push(...copied.copiedFiles);
+        result.skippedFiles.push(...copied.skippedFiles);
+      } else {
+        const copied = await scaffoldFile(sourcePath, destPath, { force, rollbackFiles, baseDir: targetDir });
+        if (copied.skipped) {
+          result.skippedFiles.push(copied.relativePath);
+        } else {
+          result.copiedFiles.push(copied.relativePath);
+        }
+      }
+
+      if (onProgress) {
+        onProgress({ item: item.source, status: 'done', message: `${item.description} scaffolded` });
+      }
+    }
+
+    // Generate pro-version.json (AC4)
+    const versionInfo = await generateProVersionJson(targetDir, proSourceDir, result.copiedFiles);
+    result.versionInfo = versionInfo;
+    result.copiedFiles.push('pro-version.json');
+    rollbackFiles.push(path.join(targetDir, 'pro-version.json'));
+
+    // Generate pro-installed-manifest.yaml (AC8)
+    const manifest = await generateInstalledManifest(targetDir, result.copiedFiles);
+    result.manifest = manifest;
+    result.copiedFiles.push('pro-installed-manifest.yaml');
+    rollbackFiles.push(path.join(targetDir, 'pro-installed-manifest.yaml'));
+
+    result.success = true;
+
+  } catch (error) {
+    result.errors.push(error.message);
+
+    // Rollback partially copied files (AC6)
+    const rollbackResult = await rollbackScaffold(rollbackFiles);
+    if (rollbackResult.errors.length > 0) {
+      result.errors.push(`Rollback errors: ${rollbackResult.errors.join(', ')}`);
+    }
+    result.warnings.push(
+      `Scaffolding failed: ${error.message}. ${rollbackResult.removed} files cleaned up.`
+    );
+  }
+
+  return result;
+}
+
+/**
+ * Scaffold a directory recursively with idempotency checks.
+ *
+ * @param {string} sourceDir - Source directory
+ * @param {string} destDir - Destination directory
+ * @param {Object} options - Options
+ * @returns {Promise<Object>} Result with copiedFiles and skippedFiles
+ */
+async function scaffoldDirectory(sourceDir, destDir, options = {}) {
+  const { force = false, rollbackFiles = [], baseDir } = options;
+  const copiedFiles = [];
+  const skippedFiles = [];
+
+  await fs.ensureDir(destDir);
+
+  const items = await fs.readdir(sourceDir, { withFileTypes: true });
+
+  for (const item of items) {
+    const sourcePath = path.join(sourceDir, item.name);
+    const destPath = path.join(destDir, item.name);
+
+    if (item.isDirectory()) {
+      const sub = await scaffoldDirectory(sourcePath, destPath, options);
+      copiedFiles.push(...sub.copiedFiles);
+      skippedFiles.push(...sub.skippedFiles);
+    } else {
+      const result = await scaffoldFile(sourcePath, destPath, { force, rollbackFiles, baseDir });
+      if (result.skipped) {
+        skippedFiles.push(result.relativePath);
+      } else {
+        copiedFiles.push(result.relativePath);
+      }
+    }
+  }
+
+  return { copiedFiles, skippedFiles };
+}
+
+/**
+ * Scaffold a single file with idempotency (AC5).
+ * If dest exists and has identical hash, skip. If user modified, skip (preserve).
+ *
+ * @param {string} sourcePath - Source file path
+ * @param {string} destPath - Destination file path
+ * @param {Object} options - Options
+ * @returns {Promise<Object>} Result with relativePath and skipped flag
+ */
+async function scaffoldFile(sourcePath, destPath, options = {}) {
+  const { force = false, rollbackFiles = [], baseDir } = options;
+  const base = baseDir || path.resolve(destPath, '..', '..');
+  const relativePath = path.relative(base, destPath).replace(/\\/g, '/');
+
+  // Idempotency check (AC5) — async to avoid blocking event loop
+  if (!force && await fs.pathExists(destPath)) {
+    try {
+      if (await hashFilesMatchAsync(sourcePath, destPath)) {
+        // Identical — skip
+        return { relativePath, skipped: true };
+      }
+    } catch {
+      // Hash comparison failed — overwrite to be safe
+    }
+  }
+
+  await fs.ensureDir(path.dirname(destPath));
+  await fs.copy(sourcePath, destPath);
+  rollbackFiles.push(destPath);
+
+  return { relativePath, skipped: false };
+}
+
+/**
+ * Generate pro-version.json with SHA256 hashes for version tracking (AC4).
+ *
+ * @param {string} targetDir - Project root
+ * @param {string} proSourceDir - Pro package directory
+ * @param {string[]} copiedFiles - List of copied file relative paths
+ * @returns {Promise<Object>} Version info object
+ */
+async function generateProVersionJson(targetDir, proSourceDir, copiedFiles) {
+  // Read pro package version
+  let proVersion = 'unknown';
+  const proPkgPath = path.join(proSourceDir, 'package.json');
+  if (await fs.pathExists(proPkgPath)) {
+    try {
+      const proPkg = await fs.readJson(proPkgPath);
+      proVersion = proPkg.version || 'unknown';
+    } catch {
+      // Keep 'unknown'
+    }
+  }
+
+  // Generate hashes for all copied files
+  const fileHashes = {};
+  for (const relativePath of copiedFiles) {
+    const absolutePath = path.join(targetDir, relativePath);
+    try {
+      if (await fs.pathExists(absolutePath)) {
+        const stats = await fs.stat(absolutePath);
+        if (stats.isFile()) {
+          fileHashes[relativePath] = `sha256:${await hashFileAsync(absolutePath)}`;
+        }
+      }
+    } catch {
+      // Skip unhashable files
+    }
+  }
+
+  const versionInfo = {
+    proVersion,
+    installedAt: new Date().toISOString(),
+    fileCount: copiedFiles.length,
+    fileHashes,
+  };
+
+  const versionPath = path.join(targetDir, 'pro-version.json');
+  await fs.writeJson(versionPath, versionInfo, { spaces: 2 });
+
+  return versionInfo;
+}
+
+/**
+ * Generate pro-installed-manifest.yaml listing all scaffolded files (AC8).
+ *
+ * @param {string} targetDir - Project root
+ * @param {string[]} copiedFiles - List of copied file relative paths
+ * @returns {Promise<Object>} Manifest object
+ */
+async function generateInstalledManifest(targetDir, copiedFiles) {
+  const files = [];
+  for (const relativePath of copiedFiles) {
+    const absolutePath = path.join(targetDir, relativePath);
+    let timestamp = new Date().toISOString();
+    try {
+      if (await fs.pathExists(absolutePath)) {
+        const stats = await fs.stat(absolutePath);
+        timestamp = stats.mtime.toISOString();
+      }
+    } catch {
+      // Use current time
+    }
+    files.push({ path: relativePath, timestamp });
+  }
+
+  const manifest = {
+    generatedAt: new Date().toISOString(),
+    totalFiles: files.length,
+    files,
+  };
+
+  const manifestPath = path.join(targetDir, 'pro-installed-manifest.yaml');
+  await fs.writeFile(manifestPath, yaml.dump(manifest), 'utf8');
+
+  return manifest;
+}
+
+/**
+ * Rollback partially scaffolded files on error (AC6).
+ *
+ * @param {string[]} rollbackFiles - Absolute paths to remove
+ * @returns {Promise<Object>} Rollback result with removed count and errors
+ */
+async function rollbackScaffold(rollbackFiles) {
+  let removed = 0;
+  const errors = [];
+
+  for (const filePath of rollbackFiles) {
+    try {
+      if (await fs.pathExists(filePath)) {
+        await fs.remove(filePath);
+        removed++;
+      }
+    } catch (error) {
+      errors.push(`Failed to remove ${filePath}: ${error.message}`);
+    }
+  }
+
+  return { removed, errors };
+}
+
+module.exports = {
+  scaffoldProContent,
+  scaffoldDirectory,
+  scaffoldFile,
+  generateProVersionJson,
+  generateInstalledManifest,
+  rollbackScaffold,
+  SCAFFOLD_ITEMS,
+};

package/packages/installer/src/utils/aios-colors.js

@@ -1,5 +1,5 @@
 /**
- * AIOS Color Palette v2.1
+ * AIOS Color Palette v4.0.4
  * 
  * Brand-inspired color system for CLI tools and terminal output.
  * Colors derived from AIOS logo gradient (magenta → orange → purple → blue)
@@ -189,7 +189,7 @@ const lists = {
  */
 const examples = {
   welcome: () => {
-    console.log(headings.h1('🎉 Welcome to AIOS v2.1 Installer!'));
+    console.log(headings.h1('🎉 Welcome to AIOS v4 Installer!'));
     console.log(colors.info('Let\'s configure your project in just a few steps...\n'));
   },
   

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

@@ -1,7 +1,7 @@
 /**
  * Visual Feedback Helpers
  *
- * Spinners, progress bars, and status indicators using AIOS Color System v2.1
+ * Spinners, progress bars, and status indicators using AIOS Color System v4.0.4
  *
  * @module wizard/feedback
  */

package/packages/installer/src/wizard/ide-config-generator.js

@@ -206,14 +206,14 @@ function generateTemplateVariables(wizardState) {
 
 /**
  * Copy agent files from .aios-core/development/agents to IDE-specific agent folder
- * v2.1 modular structure: agents are now in development/ module
+ * v4 modular structure: agents are now in development/ module
  * @param {string} projectRoot - Project root directory
  * @param {string} agentFolder - Target folder for agent files (IDE-specific)
  * @param {Object} ideConfig - IDE configuration object (optional, for special handling)
  * @returns {Promise<string[]>} List of copied files
  */
 async function copyAgentFiles(projectRoot, agentFolder, ideConfig = null) {
-  // v2.1: Agents are in development/agents/ (not root agents/)
+  // v4: Agents are in development/agents/ (not root agents/)
   const sourceDir = path.join(__dirname, '..', '..', '..', '..', '.aios-core', 'development', 'agents');
   const targetDir = path.join(projectRoot, agentFolder);
   const copiedFiles = [];

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

@@ -10,6 +10,7 @@
 const inquirer = require('inquirer');
 const path = require('path');
 const fse = require('fs-extra');
+const { colors } = require('../utils/aios-colors');
 const {
   getLanguageQuestion,
   getUserProfileQuestion,
@@ -41,11 +42,11 @@ const {
   isLLMRoutingInstalled,
 } = require('../../../../.aios-core/infrastructure/scripts/llm-routing/install-llm-routing');
 
-// DISABLED: Squads replaced expansion-packs (OSR-8)
+// DISABLED: Legacy installation block superseded by squads flow (OSR-8)
 // /**
-//  * Generate AntiGravity workflow content for expansion pack agents
+//  * Generate AntiGravity workflow content for squad agents
 //  * @param {string} agentName - Agent name (e.g., 'data-collector')
-//  * @param {string} packName - Expansion pack name (e.g., 'etl')
+//  * @param {string} packName - Starter squad name (e.g., 'etl')
 //  * @returns {string} Workflow file content
 //  */
 // function generateExpansionPackWorkflow(agentName, packName) {
@@ -57,7 +58,7 @@ const {
 //
 // # Ativação do Agente ${displayName}
 //
-// **Expansion Pack:** ${packName}
+// **Squad:** ${packName}
 //
 // **INSTRUÇÕES CRÍTICAS PARA O ANTIGRAVITY:**
 //
@@ -118,7 +119,7 @@ const LANGUAGE_MAP = {
 /**
  * Write language preference to Claude Code's native settings.json (Story ACT-12)
  * Replaces the old approach of storing language in core-config.yaml.
- * Claude Code v2.1.0+ natively supports a `language` field in settings.json
+ * Claude Code v4.0.4+ natively supports a `language` field in settings.json
  * that is automatically injected into the system prompt.
  *
  * @param {string} language - Language code from wizard (en|pt|es)
@@ -460,16 +461,16 @@ async function runWizard(options = {}) {
       answers.techPresetResult = { preset: 'none', success: true };
     }
 
-    // DISABLED: Squads replaced expansion-packs (OSR-8)
-    // Install Expansion Packs if selected
+    // DISABLED: Legacy installation block superseded by squads flow (OSR-8)
+    // Install Squads if selected
     // if (answers.selectedExpansionPacks && answers.selectedExpansionPacks.length > 0) {
-    //   console.log('\n🎁 Installing Expansion Packs...');
+    //   console.log('\n🎁 Installing Squads...');
     //
-    //   // Detect source expansion-packs directory (npm package location)
+    //   // Detect source squads directory (npm package location)
     //   const possibleSourceDirs = [
-    //     path.join(__dirname, '..', '..', 'expansion-packs'),
-    //     path.join(__dirname, '..', '..', '..', 'expansion-packs'),
-    //     path.join(process.cwd(), 'node_modules', '@synkra/aios-core', 'expansion-packs'),
+    //     path.join(__dirname, '..', '..', 'squads'),
+    //     path.join(__dirname, '..', '..', '..', 'squads'),
+    //     path.join(process.cwd(), 'node_modules', '@synkra/aios-core', 'squads'),
     //   ];
     //
     //   let sourceExpansionDir = null;
@@ -481,7 +482,7 @@ async function runWizard(options = {}) {
     //   }
     //
     //   if (sourceExpansionDir) {
-    //     const targetExpansionDir = path.join(process.cwd(), 'expansion-packs');
+    //     const targetExpansionDir = path.join(process.cwd(), 'squads');
     //     await fse.ensureDir(targetExpansionDir);
     //
     //     const installedPacks = [];
@@ -514,10 +515,10 @@ async function runWizard(options = {}) {
     //     };
     //
     //     if (installedPacks.length > 0) {
-    //       console.log(`\n✅ Expansion Packs installed (${installedPacks.length}/${answers.selectedExpansionPacks.length})`);
+    //       console.log(`\n✅ Squads installed (${installedPacks.length}/${answers.selectedExpansionPacks.length})`);
     //     }
     //   } else {
-    //     console.log('   ⚠️  Expansion packs source directory not found');
+    //     console.log('   ⚠️  Squads source directory not found');
     //     answers.expansionPacksInstalled = false;
     //   }
     // }
@@ -544,10 +545,10 @@ async function runWizard(options = {}) {
         }
       }
 
-      // DISABLED: Squads replaced expansion-packs (OSR-8)
-      // Install expansion pack agents to each selected IDE
+      // DISABLED: Legacy installation block superseded by squads flow (OSR-8)
+      // Install squad agents to each selected IDE
       // if (answers.expansionPacksResult && answers.expansionPacksResult.installed.length > 0) {
-      //   console.log('\n📦 Installing expansion pack agents to IDEs...');
+      //   console.log('\n📦 Installing squad agents to IDEs...');
       //
       //   for (const packName of answers.expansionPacksResult.installed) {
       //     const packAgentsDir = path.join(answers.expansionPacksResult.targetDir, packName, 'agents');
@@ -562,7 +563,7 @@ async function runWizard(options = {}) {
       //
       //           const isAntiGravity = ideConfig.specialConfig && ideConfig.specialConfig.type === 'antigravity';
       //
-      //           // Determine target folder for this expansion pack
+      //           // Determine target folder for this squad
       //           let targetFolder;
       //           if (isAntiGravity) {
       //             // AntiGravity: workflows go to .agent/workflows/{packName}/
@@ -818,6 +819,44 @@ async function runWizard(options = {}) {
       answers.llmRoutingInstalled = false;
     }
 
+    // Story INS-3.2: Pro Installation Wizard (optional phase)
+    if (!options.skipPro) {
+      try {
+        const { runProWizard } = require('./pro-setup');
+        const isCI = process.env.CI === 'true' || !process.stdout.isTTY;
+        const hasProKey = !!process.env.AIOS_PRO_KEY;
+
+        if (isCI && hasProKey) {
+          // CI mode: auto-run if AIOS_PRO_KEY is set
+          console.log('\n🔑 Pro license key detected, running Pro setup...');
+          const proResult = await runProWizard({ quiet: true });
+          answers.proInstalled = proResult.success;
+          answers.proResult = proResult;
+        } else if (!isCI && !options.quiet) {
+          // Interactive mode: ask if user has a Pro license
+          const { hasPro } = await inquirer.prompt([
+            {
+              type: 'confirm',
+              name: 'hasPro',
+              message: colors.primary('Do you have an AIOS Pro license key?'),
+              default: false,
+            },
+          ]);
+
+          if (hasPro) {
+            const proResult = await runProWizard();
+            answers.proInstalled = proResult.success;
+            answers.proResult = proResult;
+          } else {
+            answers.proInstalled = false;
+          }
+        }
+      } catch {
+        // Pro module not available — skip silently
+        answers.proInstalled = false;
+      }
+    }
+
     // Story 1.8: Installation Validation
     console.log('\n🔍 Validating installation...\n');