aios-core 3.0.0 → 3.2.0

package/.aios-core/schemas/squad-design-schema.json

@@ -0,0 +1,299 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://synkra.dev/schemas/squad-design.json",
+  "title": "Squad Design Blueprint",
+  "description": "Schema for squad design blueprints generated by *design-squad",
+  "type": "object",
+  "required": ["squad", "recommendations", "metadata"],
+  "properties": {
+    "squad": {
+      "type": "object",
+      "description": "Basic squad information",
+      "required": ["name", "domain"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9](-squad)?$",
+          "minLength": 2,
+          "maxLength": 64,
+          "description": "Squad name in kebab-case"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 500,
+          "description": "Human-readable description of the squad"
+        },
+        "domain": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 50,
+          "description": "Domain identifier in kebab-case"
+        }
+      }
+    },
+    "analysis": {
+      "type": "object",
+      "description": "Domain analysis results",
+      "properties": {
+        "entities": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 50,
+          "description": "Extracted domain entities"
+        },
+        "workflows": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+            "minLength": 2,
+            "maxLength": 100
+          },
+          "maxItems": 50,
+          "description": "Identified workflows in kebab-case"
+        },
+        "integrations": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 30,
+          "description": "External integrations detected"
+        },
+        "stakeholders": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 20,
+          "description": "Stakeholder roles identified"
+        }
+      }
+    },
+    "recommendations": {
+      "type": "object",
+      "description": "Generated recommendations",
+      "required": ["agents", "tasks"],
+      "properties": {
+        "agents": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/agentRecommendation"
+          },
+          "minItems": 0,
+          "maxItems": 10,
+          "description": "Recommended agents"
+        },
+        "tasks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/taskRecommendation"
+          },
+          "minItems": 0,
+          "maxItems": 50,
+          "description": "Recommended tasks"
+        },
+        "template": {
+          "type": "string",
+          "enum": ["basic", "etl", "agent-only", "custom"],
+          "default": "basic",
+          "description": "Recommended squad template"
+        },
+        "config_mode": {
+          "type": "string",
+          "enum": ["extend", "override", "none"],
+          "default": "extend",
+          "description": "Configuration inheritance mode"
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Blueprint metadata",
+      "required": ["created_at"],
+      "properties": {
+        "created_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 timestamp of blueprint creation"
+        },
+        "source_docs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Paths to source documentation files"
+        },
+        "user_adjustments": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0,
+          "description": "Number of user modifications made"
+        },
+        "overall_confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Overall confidence score (0-1)"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "agentRecommendation": {
+      "type": "object",
+      "required": ["id", "role", "confidence"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 64,
+          "description": "Agent identifier in kebab-case"
+        },
+        "role": {
+          "type": "string",
+          "minLength": 5,
+          "maxLength": 200,
+          "description": "Agent role description"
+        },
+        "commands": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+            "minLength": 2,
+            "maxLength": 64
+          },
+          "maxItems": 20,
+          "description": "Agent commands in kebab-case"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Recommendation confidence score (0-1)"
+        },
+        "user_added": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether this agent was added by user"
+        },
+        "user_modified": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether this agent was modified by user"
+        }
+      }
+    },
+    "taskRecommendation": {
+      "type": "object",
+      "required": ["name", "agent", "confidence"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 64,
+          "description": "Task name in kebab-case (without .md extension)"
+        },
+        "agent": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 64,
+          "description": "Owning agent identifier"
+        },
+        "entrada": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 20,
+          "description": "Task input parameters"
+        },
+        "saida": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 20,
+          "description": "Task output parameters"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Recommendation confidence score (0-1)"
+        },
+        "checklist": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "maxItems": 20,
+          "description": "Task checklist items"
+        }
+      }
+    }
+  },
+  "examples": [
+    {
+      "squad": {
+        "name": "order-management-squad",
+        "description": "Squad for order management system",
+        "domain": "order-management"
+      },
+      "analysis": {
+        "entities": ["Order", "Customer", "Product", "Payment"],
+        "workflows": ["create-order", "process-payment", "ship-order"],
+        "integrations": ["Stripe API", "Inventory Service"],
+        "stakeholders": ["Customer", "Admin", "Support"]
+      },
+      "recommendations": {
+        "agents": [
+          {
+            "id": "order-manager",
+            "role": "Manages order lifecycle from creation to fulfillment",
+            "commands": ["create-order", "update-order", "cancel-order"],
+            "confidence": 0.92,
+            "user_added": false,
+            "user_modified": false
+          }
+        ],
+        "tasks": [
+          {
+            "name": "create-order",
+            "agent": "order-manager",
+            "entrada": ["customer_id", "items", "payment_method"],
+            "saida": ["order_id", "status"],
+            "confidence": 0.88
+          }
+        ],
+        "template": "basic",
+        "config_mode": "extend"
+      },
+      "metadata": {
+        "created_at": "2025-12-18T00:00:00Z",
+        "source_docs": ["./docs/prd/orders.md"],
+        "user_adjustments": 2,
+        "overall_confidence": 0.87
+      }
+    }
+  ]
+}

package/bin/aios-init.js

@@ -60,6 +60,15 @@ const { detectRepositoryContext } = resolveAiosCoreModule('scripts/repository-de
 // const { GitHubProjectsAdapter } = resolveAiosCoreModule('utils/pm-adapters/github-adapter');
 // const { JiraAdapter } = resolveAiosCoreModule('utils/pm-adapters/jira-adapter');
 
+// Brownfield upgrade module (Story 6.18)
+let brownfieldUpgrader;
+try {
+  brownfieldUpgrader = require('../src/installer/brownfield-upgrader');
+} catch (_err) {
+  // Module may not be available in older installations
+  brownfieldUpgrader = null;
+}
+
 async function main() {
   console.clear();
 
@@ -142,6 +151,108 @@ async function main() {
   console.log(chalk.cyan('📦 Package:') + ` ${context.packageName}`);
   console.log('');
 
+  // Check for existing installation (Story 6.18 - Brownfield Upgrade)
+  const installedManifestPath = path.join(projectRoot, '.aios-core', '.installed-manifest.yaml');
+  const hasExistingInstall = fs.existsSync(installedManifestPath);
+
+  if (hasExistingInstall && brownfieldUpgrader) {
+    console.log(chalk.yellow('🔄 Existing AIOS installation detected!'));
+    console.log('');
+
+    const sourceDir = path.join(context.frameworkLocation, '.aios-core');
+    const upgradeCheck = brownfieldUpgrader.checkUpgradeAvailable(sourceDir, projectRoot);
+
+    if (upgradeCheck.available) {
+      console.log(chalk.green(`   Upgrade available: ${upgradeCheck.from} → ${upgradeCheck.to}`));
+      console.log('');
+
+      // Generate upgrade report for display
+      const sourceManifest = brownfieldUpgrader.loadSourceManifest(sourceDir);
+      const installedManifest = brownfieldUpgrader.loadInstalledManifest(projectRoot);
+      const report = brownfieldUpgrader.generateUpgradeReport(sourceManifest, installedManifest, projectRoot);
+
+      console.log(chalk.gray('─'.repeat(80)));
+      const { upgradeChoice } = await inquirer.prompt([
+        {
+          type: 'list',
+          name: 'upgradeChoice',
+          message: chalk.white('What would you like to do?'),
+          choices: [
+            {
+              name: `  Upgrade to ${upgradeCheck.to} ` + chalk.gray(`(${report.newFiles.length} new, ${report.modifiedFiles.length} updated files)`),
+              value: 'upgrade',
+            },
+            {
+              name: '  Dry Run ' + chalk.gray('(Show what would be changed without applying)'),
+              value: 'dry-run',
+            },
+            {
+              name: '  Fresh Install ' + chalk.gray('(Reinstall everything, overwrite all files)'),
+              value: 'fresh',
+            },
+            {
+              name: '  Cancel ' + chalk.gray('(Exit without changes)'),
+              value: 'cancel',
+            },
+          ],
+        },
+      ]);
+
+      if (upgradeChoice === 'cancel') {
+        console.log(chalk.yellow('\nInstallation cancelled.'));
+        process.exit(0);
+      }
+
+      if (upgradeChoice === 'dry-run') {
+        console.log('');
+        console.log(brownfieldUpgrader.formatUpgradeReport(report));
+        console.log('');
+        console.log(chalk.yellow('This was a dry run. No files were changed.'));
+        console.log(chalk.gray('Run again and select "Upgrade" to apply changes.'));
+        process.exit(0);
+      }
+
+      if (upgradeChoice === 'upgrade') {
+        console.log('');
+        console.log(chalk.blue('📦 Applying upgrade...'));
+
+        const result = await brownfieldUpgrader.applyUpgrade(report, sourceDir, projectRoot, { dryRun: false });
+
+        if (result.success) {
+          // Update installed manifest
+          const packageJson = require(path.join(context.frameworkLocation, 'package.json'));
+          brownfieldUpgrader.updateInstalledManifest(projectRoot, sourceManifest, `aios-core@${packageJson.version}`);
+
+          console.log(chalk.green('✓') + ` Upgraded ${result.filesInstalled.length} files`);
+          if (result.filesSkipped.length > 0) {
+            console.log(chalk.yellow('⚠') + ` Preserved ${result.filesSkipped.length} user-modified files`);
+          }
+          console.log('');
+          console.log(chalk.green('✅ Upgrade complete!'));
+          console.log(chalk.gray(`   From: ${upgradeCheck.from}`));
+          console.log(chalk.gray(`   To:   ${upgradeCheck.to}`));
+          process.exit(0);
+        } else {
+          console.error(chalk.red('✗') + ' Upgrade failed with errors:');
+          for (const err of result.errors) {
+            console.error(chalk.red(`   - ${err.path}: ${err.error}`));
+          }
+          process.exit(1);
+        }
+      }
+
+      // If 'fresh' was selected, continue with normal installation flow below
+      if (upgradeChoice === 'fresh') {
+        console.log(chalk.yellow('\nProceeding with fresh installation...'));
+        console.log('');
+      }
+    } else {
+      console.log(chalk.green(`   Current version: ${upgradeCheck.from || 'unknown'}`));
+      console.log(chalk.gray('   No upgrade available. You can proceed with fresh install if needed.'));
+      console.log('');
+    }
+  }
+
   // Step 1: Installation Mode
   console.log(chalk.gray('─'.repeat(80)));
   const { installMode } = await inquirer.prompt([
@@ -251,6 +362,21 @@ async function main() {
   if (fs.existsSync(sourceCoreDir)) {
     await fse.copy(sourceCoreDir, targetCoreDir);
     console.log(chalk.green('✓') + ' AIOS Core files installed ' + chalk.gray('(11 agents, 68 tasks, 23 templates)'));
+
+    // Create installed manifest for brownfield upgrades (Story 6.18)
+    if (brownfieldUpgrader) {
+      try {
+        const sourceManifest = brownfieldUpgrader.loadSourceManifest(sourceCoreDir);
+        if (sourceManifest) {
+          const packageJson = require(path.join(context.frameworkLocation, 'package.json'));
+          brownfieldUpgrader.updateInstalledManifest(context.projectRoot, sourceManifest, `aios-core@${packageJson.version}`);
+          console.log(chalk.green('✓') + ' Installation manifest created ' + chalk.gray('(enables future upgrades)'));
+        }
+      } catch (manifestErr) {
+        // Non-critical - just log warning
+        console.log(chalk.yellow('⚠') + ' Could not create installation manifest ' + chalk.gray('(brownfield upgrades may not work)'));
+      }
+    }
   } else {
     console.error(chalk.red('✗') + ' AIOS Core files not found');
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-core",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "main": "index.js",
   "module": "index.esm.js",
@@ -78,6 +78,9 @@
     "version:expansion:all:patch": "node tools/bump-all-versions.js patch",
     "release": "semantic-release",
     "release:test": "semantic-release --dry-run --no-ci || echo 'Config test complete - authentication errors are expected locally'",
+    "generate:manifest": "node scripts/generate-install-manifest.js",
+    "validate:manifest": "node scripts/validate-manifest.js",
+    "prepublishOnly": "npm run generate:manifest && npm run validate:manifest",
     "prepare": "echo 'Skipping husky - not needed for NPM publish'"
   },
   "dependencies": {