aios-core 3.11.0 → 3.11.2

package/.aios-core/cli/commands/validate/index.js

@@ -35,7 +35,7 @@ const ExitCode = {
 };
 
 // Resolve validator module path
-const validatorPath = path.resolve(__dirname, '../../../../src/installer/post-install-validator');
+const validatorPath = path.resolve(__dirname, '../../../../packages/installer/src/installer/post-install-validator');
 let PostInstallValidator, formatReport;
 
 let validatorLoadError = null;

package/.aios-core/install-manifest.yaml

@@ -7,8 +7,8 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 3.11.0
-generated_at: "2026-02-03T13:59:53.457Z"
+version: 3.11.2
+generated_at: "2026-02-03T14:51:52.983Z"
 generator: scripts/generate-install-manifest.js
 file_count: 839
 files:
@@ -109,9 +109,9 @@ files:
     type: cli
     size: 5320
   - path: cli/commands/validate/index.js
-    hash: sha256:18901c95898b8d6d25b2fd8b8f91bd0bdcb421bcc92bba457a8a3836af28f36b
+    hash: sha256:dece3a1a8d3ed4ef7dbd8f1ac840c6ec69fb9c759fc43d5813a71ac59479d3a0
     type: cli
-    size: 12882
+    size: 12901
   - path: cli/commands/workers/formatters/info-formatter.js
     hash: sha256:6f0d25f4033828616656178c55e50d1eeec9457279807c1b06e111d9dd79c53e
     type: cli

package/bin/aios-init.js

@@ -1,10 +1,21 @@
 #!/usr/bin/env node
 
 /**
- * AIOS-FullStack Installation Wizard v5
+ * AIOS-FullStack Installation Wizard v5 (LEGACY)
  * Based on the original beautiful visual design with ASCII art
  * Version: 2.1.0
  *
+ * ⚠️ DEPRECATION NOTICE (v3.11.2):
+ * This file is the LEGACY installer and will be removed in v4.0.0.
+ * The new modular wizard is located at: packages/installer/src/wizard/index.js
+ *
+ * This file is kept as a fallback for edge cases where the new wizard
+ * is not available. All new development should use the new wizard.
+ *
+ * Migration path:
+ * - Use `npx aios-core` which routes through bin/aios.js to the new wizard
+ * - Do NOT call this file directly
+ *
  * Supported IDEs (8 total):
  * - Claude Code, Cursor, Windsurf, Trae, Roo Code, Cline, Gemini CLI, GitHub Copilot
  */

package/bin/aios-minimal.js

@@ -2,25 +2,41 @@
 
 /**
  * AIOS-FullStack Minimal Installation
- * Wrapper that launches aios-init.js in minimal mode
  *
- * Minimal mode only shows expansion-creator pack,
- * which provides tools to install other expansion packs manually.
+ * DEPRECATION NOTICE (v3.11.1):
+ * The --minimal mode was designed for expansion-packs which have been
+ * replaced by the Squads system (OSR-8). This command now runs the
+ * standard wizard through the main router.
+ *
+ * This file is kept for backwards compatibility but will be removed
+ * in a future major version.
  */
 
-const { execSync } = require('child_process');
+const { spawn } = require('child_process');
 const path = require('path');
 
-// Get the path to aios-init.js
-const initScriptPath = path.join(__dirname, 'aios-init.js');
-
-try {
-  // Execute aios-init.js with --minimal flag
-  execSync(`node "${initScriptPath}" --minimal`, {
-    stdio: 'inherit',
-    cwd: process.cwd(),
-  });
-} catch (error) {
-  // Error is already displayed by child process
-  process.exit(error.status || 1);
-}
+// Show deprecation warning
+console.log('\n⚠️  DEPRECATION WARNING: aios-minimal is deprecated.');
+console.log('   The --minimal mode (expansion-packs) was replaced by Squads.');
+console.log('   Running standard installation wizard instead.\n');
+
+// Get the path to the main router (aios.js)
+const routerPath = path.join(__dirname, 'aios.js');
+
+// Forward all arguments to the main router
+const args = process.argv.slice(2);
+
+// Spawn the main router
+const child = spawn('node', [routerPath, ...args], {
+  stdio: 'inherit',
+  cwd: process.cwd(),
+});
+
+child.on('close', (code) => {
+  process.exit(code || 0);
+});
+
+child.on('error', (error) => {
+  console.error('❌ Failed to start AIOS:', error.message);
+  process.exit(1);
+});

package/bin/aios.js

@@ -20,8 +20,8 @@ const command = args[0];
 
 // Helper: Run initialization wizard
 async function runWizard() {
-  // Use the new v2.1 wizard from src/wizard/index.js
-  const wizardPath = path.join(__dirname, '..', 'src', 'wizard', 'index.js');
+  // Use the new v2.1 wizard from packages/installer/src/wizard/index.js
+  const wizardPath = path.join(__dirname, '..', 'packages', 'installer', 'src', 'wizard', 'index.js');
 
   if (!fs.existsSync(wizardPath)) {
     // Fallback to legacy wizard if new wizard not found
@@ -56,12 +56,21 @@ USAGE:
   npx @synkra/aios-core@latest              # Run installation wizard
   npx @synkra/aios-core@latest install      # Install in current project
   npx @synkra/aios-core@latest init <name>  # Create new project
+  npx @synkra/aios-core@latest update       # Update to latest version
   npx @synkra/aios-core@latest validate     # Validate installation integrity
   npx @synkra/aios-core@latest info         # Show system info
   npx @synkra/aios-core@latest doctor       # Run diagnostics
   npx @synkra/aios-core@latest --version    # Show version
+  npx @synkra/aios-core@latest --version -d # Show detailed version info
   npx @synkra/aios-core@latest --help       # Show this help
 
+UPDATE:
+  aios update                    # Update to latest version
+  aios update --check            # Check for updates without applying
+  aios update --dry-run          # Preview what would be updated
+  aios update --force            # Force update even if up-to-date
+  aios update --verbose          # Show detailed output
+
 VALIDATION:
   aios validate                    # Validate installation integrity
   aios validate --repair           # Repair missing/corrupted files
@@ -92,8 +101,64 @@ For more information, visit: https://github.com/SynkraAI/aios-core
 }
 
 // Helper: Show version
-function showVersion() {
-  console.log(packageJson.version);
+async function showVersion() {
+  const isDetailed = args.includes('--detailed') || args.includes('-d');
+
+  if (!isDetailed) {
+    // Simple version output (backwards compatible)
+    console.log(packageJson.version);
+    return;
+  }
+
+  // Detailed version output (Story 7.2: Version Tracking)
+  console.log(`AIOS-FullStack v${packageJson.version}`);
+  console.log('Package: @synkra/aios-core');
+
+  // Check for local installation
+  const localVersionPath = path.join(process.cwd(), '.aios-core', 'version.json');
+
+  if (fs.existsSync(localVersionPath)) {
+    try {
+      const versionInfo = JSON.parse(fs.readFileSync(localVersionPath, 'utf8'));
+      console.log('\n📦 Local Installation:');
+      console.log(`  Version:    ${versionInfo.version}`);
+      console.log(`  Mode:       ${versionInfo.mode || 'unknown'}`);
+
+      if (versionInfo.installedAt) {
+        const installedDate = new Date(versionInfo.installedAt);
+        console.log(`  Installed:  ${installedDate.toLocaleDateString()}`);
+      }
+
+      if (versionInfo.updatedAt) {
+        const updatedDate = new Date(versionInfo.updatedAt);
+        console.log(`  Updated:    ${updatedDate.toLocaleDateString()}`);
+      }
+
+      if (versionInfo.fileHashes) {
+        const fileCount = Object.keys(versionInfo.fileHashes).length;
+        console.log(`  Files:      ${fileCount} tracked`);
+      }
+
+      if (versionInfo.customized && versionInfo.customized.length > 0) {
+        console.log(`  Customized: ${versionInfo.customized.length} files`);
+      }
+
+      // Version comparison
+      if (versionInfo.version !== packageJson.version) {
+        console.log('\n⚠️  Version mismatch!');
+        console.log(`  Local:  ${versionInfo.version}`);
+        console.log(`  Latest: ${packageJson.version}`);
+        console.log('  Run \'npx aios-core update\' to update.');
+      } else {
+        console.log('\n✅ Up to date');
+      }
+    } catch (error) {
+      console.log(`\n⚠️  Could not read version.json: ${error.message}`);
+    }
+  } else {
+    console.log('\n📭 No local installation found');
+    console.log('  Run \'npx aios-core install\' to install AIOS in this project.');
+  }
 }
 
 // Helper: Show system info
@@ -138,8 +203,8 @@ async function runValidate() {
     const { createValidateCommand } = require('../.aios-core/cli/commands/validate/index.js');
     const validateCmd = createValidateCommand();
 
-    // Parse and execute
-    await validateCmd.parseAsync(['node', 'aios', 'validate', ...validateArgs]);
+    // Parse and execute (Note: don't include 'validate' as it's the command name, not an argument)
+    await validateCmd.parseAsync(['node', 'aios', ...validateArgs]);
   } catch (_error) {
     // Fallback: Run quick validation inline
     console.log('Running installation validation...\n');
@@ -177,6 +242,67 @@ async function runValidate() {
   }
 }
 
+// Helper: Run update command
+async function runUpdate() {
+  const updateArgs = args.slice(1);
+  const isCheck = updateArgs.includes('--check');
+  const isDryRun = updateArgs.includes('--dry-run');
+  const isForce = updateArgs.includes('--force');
+  const isVerbose = updateArgs.includes('--verbose') || updateArgs.includes('-v');
+
+  try {
+    const updaterPath = path.join(__dirname, '..', 'packages', 'installer', 'src', 'updater', 'index.js');
+
+    if (!fs.existsSync(updaterPath)) {
+      console.error('❌ Updater module not found');
+      console.error('Please ensure AIOS-FullStack is installed correctly.');
+      process.exit(1);
+    }
+
+    const { AIOSUpdater, formatCheckResult, formatUpdateResult } = require(updaterPath);
+
+    const updater = new AIOSUpdater(process.cwd(), {
+      verbose: isVerbose,
+      force: isForce,
+    });
+
+    if (isCheck) {
+      // Check only mode
+      console.log('🔍 Checking for updates...\n');
+      const result = await updater.checkForUpdates();
+      console.log(formatCheckResult(result, { colors: true }));
+
+      if (result.status === 'check_failed') {
+        process.exit(1);
+      }
+    } else {
+      // Update mode
+      console.log('🔄 AIOS Update\n');
+
+      const result = await updater.update({
+        dryRun: isDryRun,
+        onProgress: (phase, message) => {
+          if (isVerbose) {
+            console.log(`[${phase}] ${message}`);
+          }
+        },
+      });
+
+      console.log(formatUpdateResult(result, { colors: true }));
+
+      if (!result.success && result.error !== 'Already up to date') {
+        process.exit(1);
+      }
+    }
+  } catch (error) {
+    console.error(`❌ Update error: ${error.message}`);
+    if (args.includes('--verbose') || args.includes('-v')) {
+      console.error(error.stack);
+    }
+    process.exit(1);
+  }
+}
+
 // Helper: Run doctor diagnostics
 function runDoctor() {
   console.log('🏥 AIOS System Diagnostics\n');
@@ -242,46 +368,126 @@ function runDoctor() {
 }
 
 // Helper: Create new project
-async function initProject(projectName) {
+// Helper: Show init help
+function showInitHelp() {
+  console.log(`
+Usage: npx aios-core init <project-name> [options]
+
+Create a new AIOS project with the specified name.
+
+Options:
+  --force              Force creation in non-empty directory
+  --skip-install       Skip npm dependency installation
+  --template <name>    Use specific template (default: default)
+  -t <name>            Shorthand for --template
+  -h, --help           Show this help message
+
+Available Templates:
+  default     Full installation with all agents, tasks, and workflows
+  minimal     Essential files only (dev agent + basic tasks)
+  enterprise  Everything + dashboards + team integrations
+
+Examples:
+  npx aios-core init my-project
+  npx aios-core init my-project --template minimal
+  npx aios-core init my-project --force --skip-install
+  npx aios-core init . --template enterprise
+`);
+}
+
+async function initProject() {
+  // 1. Parse ALL args after 'init'
+  const initArgs = args.slice(1);
+
+  // 2. Handle --help FIRST (before creating any directories)
+  if (initArgs.includes('--help') || initArgs.includes('-h')) {
+    showInitHelp();
+    return;
+  }
+
+  // 3. Parse flags
+  const isForce = initArgs.includes('--force');
+  const skipInstall = initArgs.includes('--skip-install');
+
+  // Template with argument
+  const templateIndex = initArgs.findIndex((a) => a === '--template' || a === '-t');
+  let template = 'default';
+  if (templateIndex !== -1) {
+    template = initArgs[templateIndex + 1];
+    if (!template || template.startsWith('-')) {
+      console.error('❌ --template requires a template name');
+      console.error('Available templates: default, minimal, enterprise');
+      process.exit(1);
+    }
+  }
+
+  // Validate template
+  const validTemplates = ['default', 'minimal', 'enterprise'];
+  if (!validTemplates.includes(template)) {
+    console.error(`❌ Unknown template: ${template}`);
+    console.error(`Available templates: ${validTemplates.join(', ')}`);
+    process.exit(1);
+  }
+
+  // 4. Extract project name (anything that doesn't start with - and isn't a template value)
+  const projectName = initArgs.find((arg, i) => {
+    if (arg.startsWith('-')) return false;
+    // Skip if it's the value after --template
+    const prevArg = initArgs[i - 1];
+    if (prevArg === '--template' || prevArg === '-t') return false;
+    return true;
+  });
+
   if (!projectName) {
     console.error('❌ Project name is required');
-    console.log('\nUsage: npx @synkra/aios-core@latest init <project-name>');
+    console.log('\nUsage: npx aios-core init <project-name> [options]');
+    console.log('Run with --help for more information.');
     process.exit(1);
   }
 
-  // Handle "." to install in current directory
+  // 5. Handle "." to install in current directory
   const isCurrentDir = projectName === '.';
   const targetPath = isCurrentDir ? process.cwd() : path.join(process.cwd(), projectName);
   const displayName = isCurrentDir ? path.basename(process.cwd()) : projectName;
 
-  console.log(`Creating new AIOS project: ${displayName}\n`);
-
-  // Check if directory exists
-  if (fs.existsSync(targetPath)) {
-    // Allow if directory is empty or only has hidden files
+  // 6. Check if directory exists
+  if (fs.existsSync(targetPath) && !isCurrentDir) {
     const contents = fs.readdirSync(targetPath).filter((f) => !f.startsWith('.'));
-    if (contents.length > 0 && !isCurrentDir) {
+    if (contents.length > 0 && !isForce) {
       console.error(`❌ Directory already exists and is not empty: ${projectName}`);
-      console.log('Use a different name or remove the existing directory.');
+      console.error('Use --force to overwrite.');
       process.exit(1);
     }
-    // Directory exists but is empty or is current dir - proceed
-    if (!isCurrentDir) {
+    if (contents.length > 0 && isForce) {
+      console.log(`⚠️  Using --force: overwriting existing directory: ${projectName}`);
+    } else {
       console.log(`✓ Using existing empty directory: ${projectName}`);
     }
-  } else {
-    // Create project directory
+  } else if (!fs.existsSync(targetPath)) {
     fs.mkdirSync(targetPath, { recursive: true });
     console.log(`✓ Created directory: ${projectName}`);
   }
 
-  // Change to project directory (if not already there)
+  console.log(`Creating new AIOS project: ${displayName}`);
+  if (template !== 'default') {
+    console.log(`Template: ${template}`);
+  }
+  if (skipInstall) {
+    console.log('Skip install: enabled');
+  }
+  console.log('');
+
+  // 7. Change to project directory (if not already there)
   if (!isCurrentDir) {
     process.chdir(targetPath);
   }
 
-  // Run the initialization wizard
-  await runWizard();
+  // 8. Run the initialization wizard with options
+  await runWizard({
+    template,
+    skipInstall,
+    force: isForce,
+  });
 }
 
 // Command routing (async main function)
@@ -305,9 +511,8 @@ async function main() {
       break;
 
     case 'init': {
-      // Create new project
-      const projectName = args[1];
-      await initProject(projectName);
+      // Create new project (flags parsed inside initProject)
+      await initProject();
       break;
     }
 
@@ -324,10 +529,15 @@ async function main() {
       await runValidate();
       break;
 
+    case 'update':
+      // Update to latest version - Epic 7
+      await runUpdate();
+      break;
+
     case '--version':
     case '-v':
     case '-V':
-      showVersion();
+      await showVersion();
       break;
 
     case '--help':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-core",
-  "version": "3.11.0",
+  "version": "3.11.2",
   "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "bin": {
     "aios": "bin/aios.js",

package/packages/installer/src/installer/aios-core-installer.js

@@ -11,6 +11,7 @@
 const fs = require('fs-extra');
 const path = require('path');
 const ora = require('ora');
+const { hashFile } = require('./file-hasher');
 
 /**
  * Get the path to the source .aios-core directory in the package
@@ -75,6 +76,72 @@ function replaceRootPlaceholder(content, rootPath = '.aios-core') {
   return content.replace(/\{root\}/g, rootPath);
 }
 
+/**
+ * Generate file hashes for installed files
+ * Story 7.2: Version Tracking
+ *
+ * @param {string} targetAiosCore - Path to .aios-core directory
+ * @param {string[]} installedFiles - List of installed files (relative to .aios-core)
+ * @returns {Promise<Object>} Object mapping file paths to their sha256 hashes
+ */
+async function generateFileHashes(targetAiosCore, installedFiles) {
+  const fileHashes = {};
+
+  for (const filePath of installedFiles) {
+    const absolutePath = path.join(targetAiosCore, filePath);
+
+    try {
+      if (await fs.pathExists(absolutePath)) {
+        const stats = await fs.stat(absolutePath);
+        if (stats.isFile()) {
+          const hash = hashFile(absolutePath);
+          fileHashes[filePath] = `sha256:${hash}`;
+        }
+      }
+    } catch (_error) {
+      // Skip files that can't be hashed (permissions, etc.)
+      continue;
+    }
+  }
+
+  return fileHashes;
+}
+
+/**
+ * Generate version.json for installation tracking
+ * Story 7.2: Version Tracking - Enables update command to detect changes
+ *
+ * @param {Object} options - Options
+ * @param {string} options.targetAiosCore - Path to .aios-core directory
+ * @param {string} options.version - Package version
+ * @param {string[]} options.installedFiles - List of installed files
+ * @param {string} [options.mode='project-development'] - Installation mode
+ * @returns {Promise<Object>} version.json content
+ */
+async function generateVersionJson(options) {
+  const {
+    targetAiosCore,
+    version,
+    installedFiles,
+    mode = 'project-development',
+  } = options;
+
+  const fileHashes = await generateFileHashes(targetAiosCore, installedFiles);
+
+  const versionJson = {
+    version,
+    installedAt: new Date().toISOString(),
+    mode,
+    fileHashes,
+    customized: [],
+  };
+
+  const versionJsonPath = path.join(targetAiosCore, 'version.json');
+  await fs.writeJson(versionJsonPath, versionJson, { spaces: 2 });
+
+  return versionJson;
+}
+
 /**
  * Copy a single file with optional {root} replacement
  * @param {string} sourcePath - Source file path
@@ -226,8 +293,9 @@ async function installAiosCore(options = {}) {
 
     // Create install manifest
     spinner.text = 'Creating installation manifest...';
+    const packageVersion = require('../../../../package.json').version;
     const manifest = {
-      version: require('../../../../package.json').version,
+      version: packageVersion,
       installed_at: new Date().toISOString(),
       install_type: 'full',
       files: result.installedFiles,
@@ -239,6 +307,16 @@ async function installAiosCore(options = {}) {
       'utf8',
     );
 
+    // Story 7.2: Create version.json with file hashes for update tracking
+    spinner.text = 'Generating version tracking info...';
+    const versionInfo = await generateVersionJson({
+      targetAiosCore,
+      version: packageVersion,
+      installedFiles: result.installedFiles,
+      mode: 'project-development',
+    });
+    result.versionInfo = versionInfo;
+
     result.success = true;
     spinner.succeed(`AIOS core installed (${result.installedFiles.length} files)`);
 
@@ -314,6 +392,8 @@ module.exports = {
   getAiosCoreSourcePath,
   copyFileWithRootReplacement,
   copyDirectoryWithRootReplacement,
+  generateVersionJson,
+  generateFileHashes,
   FOLDERS_TO_COPY,
   ROOT_FILES_TO_COPY,
 };