aios-core 2.1.0

package/package.json

@@ -0,0 +1,161 @@
+{
+  "name": "aios-core",
+  "version": "2.1.0",
+  "description": "AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
+  "main": "index.js",
+  "module": "index.esm.js",
+  "types": "index.d.ts",
+  "bin": {
+    "aios": "./bin/aios.js",
+    "aios-fullstack": "./bin/aios.js",
+    "aios-fullstack-minimal": "./bin/aios-minimal.js",
+    "aios-minimal": "./bin/aios-minimal.js"
+  },
+  "preferGlobal": false,
+  "workspaces": [
+    ".aios-core",
+    "memory",
+    "security",
+    "performance",
+    "telemetry",
+    "packages/*"
+  ],
+  "files": [
+    "bin/",
+    "src/",
+    "scripts/",
+    "packages/",
+    "install/",
+    "tools/",
+    "templates/",
+    ".aios-core/",
+    ".claude/CLAUDE.md",
+    ".claude/rules/",
+    "common/",
+    "expansion-packs/",
+    "index.js",
+    "index.esm.js",
+    "index.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node tools/package-builder.js",
+    "build:agents": "node tools/cli.js build --agents-only",
+    "build:teams": "node tools/cli.js build --teams-only",
+    "build:packages": "node tools/package-builder.js",
+    "list:agents": "node tools/cli.js list:agents",
+    "validate": "node tools/cli.js validate",
+    "install:aios": "node tools/installer/bin/aios.js install",
+    "register-mcp-tool": "node .aios-core/utils/register-mcp-tool.js",
+    "setup:github": "node tools/setup-github-cli.js",
+    "setup": "npm run setup:github && npm run install:aios",
+    "stories:index": "node .aios-core/scripts/story-index-generator.js docs/stories",
+    "stories:backlog": "node .aios-core/scripts/backlog-manager.js generate docs/stories/backlog.md",
+    "stories:source-tree": "node .aios-core/infrastructure/scripts/source-tree-guardian/index.js --generate-manifest",
+    "validate:structure": "node .aios-core/infrastructure/scripts/source-tree-guardian/index.js",
+    "format": "prettier --write \"**/*.md\"",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:monitoring": "jest .claude/commands/hybridOps/tests",
+    "test:cross-platform": "jest test/cross-platform.test.js",
+    "lint": "eslint . --cache --cache-location .eslintcache",
+    "typecheck": "tsc --noEmit",
+    "publish:dry-run": "node tools/npm-publish.js --dry-run",
+    "publish:preview": "node tools/npm-publish.js --tag preview",
+    "publish:stable": "node tools/npm-publish.js --tag latest",
+    "publish:interactive": "node tools/npm-publish.js --interactive",
+    "version:patch": "node tools/version-bump.js patch",
+    "version:minor": "node tools/version-bump.js minor",
+    "version:major": "node tools/version-bump.js major",
+    "version:expansion": "node tools/bump-expansion-version.js",
+    "version:expansion:set": "node tools/update-expansion-version.js",
+    "version:all": "node tools/bump-all-versions.js",
+    "version:all:minor": "node tools/bump-all-versions.js minor",
+    "version:all:major": "node tools/bump-all-versions.js major",
+    "version:all:patch": "node tools/bump-all-versions.js patch",
+    "version:expansion:all": "node tools/bump-all-versions.js",
+    "version:expansion:all:minor": "node tools/bump-all-versions.js minor",
+    "version:expansion:all:major": "node tools/bump-all-versions.js major",
+    "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'",
+    "prepare": "echo 'Skipping husky - not needed for NPM publish'"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "@kayvan/markdown-tree-parser": "^1.5.0",
+    "chalk": "^4.1.2",
+    "cli-progress": "^3.12.0",
+    "commander": "^14.0.1",
+    "execa": "^5.1.1",
+    "fs-extra": "^11.3.2",
+    "glob": "^11.0.3",
+    "handlebars": "^4.7.8",
+    "inquirer": "^8.2.6",
+    "isolated-vm": "^5.0.4",
+    "js-yaml": "^4.1.0",
+    "ora": "^5.4.1",
+    "picocolors": "^1.1.1",
+    "semver": "^7.7.2",
+    "validator": "^13.15.15",
+    "yaml": "^2.8.1"
+  },
+  "keywords": [
+    "ai",
+    "aios",
+    "agile",
+    "agents",
+    "orchestrator",
+    "fullstack",
+    "development",
+    "cli",
+    "cross-platform",
+    "interactive",
+    "wizard",
+    "modern-ux",
+    "vite-style",
+    "automation"
+  ],
+  "author": "AIOS Fullstack Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SynkraAI/aios-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/SynkraAI/aios-core/issues"
+  },
+  "homepage": "https://github.com/SynkraAI/aios-core#readme",
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/jest": "^30.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.46.2",
+    "@typescript-eslint/parser": "^8.46.2",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "eslint": "^9.38.0",
+    "husky": "^9.1.7",
+    "jest": "^30.2.0",
+    "lint-staged": "^16.1.1",
+    "prettier": "^3.5.3",
+    "semantic-release": "^22.0.0",
+    "typescript": "^5.9.3",
+    "yaml-lint": "^1.7.0"
+  },
+  "lint-staged": {
+    "*.{js,mjs,cjs,ts}": [
+      "eslint --fix --cache --cache-location .eslintcache",
+      "prettier --write"
+    ],
+    "*.md": [
+      "prettier --write"
+    ]
+  }
+}

package/packages/installer/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@aios/installer",
+  "version": "2.1.0",
+  "description": "AIOS Installer - Automated setup wizard for AIOS projects (greenfield & brownfield)",
+  "main": "src/index.js",
+  "bin": {
+    "aios-installer": "./src/index.js"
+  },
+  "scripts": {
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:unit": "jest tests/unit",
+    "test:integration": "jest tests/integration"
+  },
+  "keywords": [
+    "aios",
+    "installer",
+    "wizard",
+    "cli",
+    "setup",
+    "greenfield",
+    "brownfield"
+  ],
+  "author": "AIOS Fullstack Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "chalk": "^4.1.2",
+    "fs-extra": "^11.3.2"
+  },
+  "devDependencies": {
+    "jest": "^30.2.0"
+  }
+}
+

package/packages/installer/src/config/configure-environment.js

@@ -0,0 +1,312 @@
+/**
+ * Environment Configuration Module
+ * Story 1.6: Environment Configuration
+ *
+ * Handles .env and core-config.yaml generation with interactive prompts
+ *
+ * @module configure-environment
+ */
+
+ 
+// Console statements are intentional for user feedback during installation
+
+const fs = require('fs-extra');
+const path = require('path');
+const { confirm, password } = require('@clack/prompts');
+const { generateEnvContent, generateEnvExample } = require('./templates/env-template');
+const { generateCoreConfig } = require('./templates/core-config-template');
+const {
+  validateEnvFormat,
+  validateApiKeyFormat,
+  validateYamlSyntax,
+  validateCoreConfigStructure,
+  sanitizeInput,
+} = require('./validation/config-validator');
+
+/**
+ * Configure environment files (.env and core-config.yaml)
+ *
+ * @param {Object} options - Configuration options
+ * @param {string} [options.targetDir] - Target directory (default: process.cwd())
+ * @param {string} [options.projectType] - Project type from Story 1.3
+ * @param {Array<string>} [options.selectedIDEs] - Selected IDEs from Story 1.4
+ * @param {Array<Object>} [options.mcpServers] - MCP servers from Story 1.5
+ * @param {boolean} [options.skipPrompts] - Skip interactive prompts (for testing)
+ * @returns {Promise<Object>} Configuration result
+ */
+async function configureEnvironment(options = {}) {
+  const {
+    targetDir = process.cwd(),
+    projectType = 'GREENFIELD',
+    selectedIDEs = [],
+    mcpServers = [],
+    skipPrompts = false,
+  } = options;
+
+  const results = {
+    envCreated: false,
+    envExampleCreated: false,
+    coreConfigCreated: false,
+    gitignoreUpdated: false,
+    errors: [],
+  };
+
+  try {
+    // Step 1: Check for existing .env and offer backup
+    const envPath = path.join(targetDir, '.env');
+    const envExists = await fs.pathExists(envPath);
+
+    if (envExists && !skipPrompts) {
+      const shouldBackup = await confirm({
+        message: 'Found existing .env file. Create backup before overwriting?',
+        initialValue: true,
+      });
+
+      if (shouldBackup) {
+        const backupPath = path.join(targetDir, `.env.backup.${Date.now()}`);
+        await fs.copy(envPath, backupPath);
+        console.log(`✅ Backup created: ${backupPath}`);
+      }
+    }
+
+    // Step 2: API keys are configured later via .env or aios-master
+    // Skipping prompts during installation for better UX
+    const apiKeys = {};
+
+    if (!skipPrompts) {
+      console.log('\n💡 API keys can be configured later in .env file or via aios-master');
+    }
+
+    // Step 3: Generate and write .env file
+    const envContent = generateEnvContent(apiKeys);
+
+    // Validate .env format
+    const envValidation = validateEnvFormat(envContent);
+    if (!envValidation.valid) {
+      results.errors.push(...envValidation.errors);
+      throw new Error('Generated .env file has invalid format');
+    }
+
+    await fs.writeFile(envPath, envContent, { encoding: 'utf8' });
+    results.envCreated = true;
+
+    // Set file permissions (0600 on Unix systems)
+    if (process.platform !== 'win32') {
+      await fs.chmod(envPath, 0o600);
+    }
+
+    console.log('✅ Created .env file');
+
+    // Step 4: Generate and write .env.example
+    const envExamplePath = path.join(targetDir, '.env.example');
+    const envExampleContent = generateEnvExample();
+    await fs.writeFile(envExamplePath, envExampleContent, { encoding: 'utf8' });
+    results.envExampleCreated = true;
+    console.log('✅ Created .env.example file');
+
+    // Step 5: Update .gitignore
+    await updateGitignore(targetDir);
+    results.gitignoreUpdated = true;
+    console.log('✅ Updated .gitignore');
+
+    // Step 6: Generate and write core-config.yaml
+    const coreConfigDir = path.join(targetDir, '.aios-core');
+    await fs.ensureDir(coreConfigDir);
+
+    const coreConfigContent = generateCoreConfig({
+      projectType,
+      selectedIDEs,
+      mcpServers,
+      aiosVersion: '2.1.0',
+    });
+
+    // Validate YAML syntax
+    const yamlValidation = validateYamlSyntax(coreConfigContent);
+    if (!yamlValidation.valid) {
+      results.errors.push(yamlValidation.error);
+      throw new Error('Generated core-config.yaml has invalid YAML syntax');
+    }
+
+    // Validate core config structure
+    const structureValidation = validateCoreConfigStructure(yamlValidation.parsed);
+    if (!structureValidation.valid) {
+      results.errors.push(...structureValidation.errors);
+      throw new Error('Generated core-config.yaml has invalid structure');
+    }
+
+    const coreConfigPath = path.join(coreConfigDir, 'core-config.yaml');
+    await fs.writeFile(coreConfigPath, coreConfigContent, { encoding: 'utf8' });
+    results.coreConfigCreated = true;
+    console.log('✅ Created .aios-core/core-config.yaml');
+
+    return results;
+  } catch (error) {
+    results.errors.push(error.message);
+    throw error;
+  }
+}
+
+/**
+ * Collect API keys via interactive prompts
+ *
+ * @returns {Promise<Object>} API keys object
+ */
+async function collectApiKeys() {
+  const keys = {};
+
+  // OpenAI API Key
+  const openaiKey = await password({
+    message: 'OpenAI API Key (optional):',
+    validate: (value) => {
+      if (!value) return; // Empty is ok (skip)
+      const sanitized = sanitizeInput(value);
+      const validation = validateApiKeyFormat(sanitized, 'openai');
+      return validation.valid ? undefined : validation.error;
+    },
+  });
+
+  if (openaiKey && typeof openaiKey === 'string') {
+    keys.openai = sanitizeInput(openaiKey);
+    console.log('✓ OpenAI API key configured');
+  } else {
+    console.log('⊘ Skipped - configure later in .env');
+  }
+
+  // Anthropic API Key
+  const anthropicKey = await password({
+    message: 'Anthropic API Key (optional):',
+    validate: (value) => {
+      if (!value) return; // Empty is ok (skip)
+      const sanitized = sanitizeInput(value);
+      const validation = validateApiKeyFormat(sanitized, 'anthropic');
+      return validation.valid ? undefined : validation.error;
+    },
+  });
+
+  if (anthropicKey && typeof anthropicKey === 'string') {
+    keys.anthropic = sanitizeInput(anthropicKey);
+    console.log('✓ Anthropic API key configured');
+  } else {
+    console.log('⊘ Skipped - configure later in .env');
+  }
+
+  // ClickUp API Key (optional service)
+  const clickupKey = await password({
+    message: 'ClickUp API Key (optional):',
+    validate: (value) => {
+      if (!value) return; // Empty is ok (skip)
+      const sanitized = sanitizeInput(value);
+      const validation = validateApiKeyFormat(sanitized);
+      return validation.valid ? undefined : validation.error;
+    },
+  });
+
+  if (clickupKey && typeof clickupKey === 'string') {
+    keys.clickup = sanitizeInput(clickupKey);
+    console.log('✓ ClickUp API key configured');
+  } else {
+    console.log('⊘ Skipped - configure later in .env');
+  }
+
+  // GitHub Token (optional service)
+  const githubToken = await password({
+    message: 'GitHub Personal Access Token (optional):',
+    validate: (value) => {
+      if (!value) return; // Empty is ok (skip)
+      const sanitized = sanitizeInput(value);
+      const validation = validateApiKeyFormat(sanitized, 'github');
+      return validation.valid ? undefined : validation.error;
+    },
+  });
+
+  if (githubToken && typeof githubToken === 'string') {
+    keys.github = sanitizeInput(githubToken);
+    console.log('✓ GitHub token configured');
+  } else {
+    console.log('⊘ Skipped - configure later in .env');
+  }
+
+  // Exa API Key (for web search)
+  const exaKey = await password({
+    message: 'Exa API Key (optional):',
+    validate: (value) => {
+      if (!value) return; // Empty is ok (skip)
+      const sanitized = sanitizeInput(value);
+      const validation = validateApiKeyFormat(sanitized);
+      return validation.valid ? undefined : validation.error;
+    },
+  });
+
+  if (exaKey && typeof exaKey === 'string') {
+    keys.exa = sanitizeInput(exaKey);
+    console.log('✓ Exa API key configured');
+  } else {
+    console.log('⊘ Skipped - configure later in .env');
+  }
+
+  return keys;
+}
+
+/**
+ * Update .gitignore to include critical entries for AIOS projects
+ *
+ * @param {string} targetDir - Target directory
+ * @returns {Promise<void>}
+ */
+async function updateGitignore(targetDir) {
+  const gitignorePath = path.join(targetDir, '.gitignore');
+  let gitignoreContent = '';
+
+  // Read existing .gitignore if it exists
+  if (await fs.pathExists(gitignorePath)) {
+    gitignoreContent = await fs.readFile(gitignorePath, 'utf8');
+  }
+
+  // Critical entries that must be in .gitignore
+  const criticalEntries = {
+    'Environment & Secrets': ['.env', '.env.local', '.env.*.local', '*.key', '*.pem'],
+    'Dependencies': ['node_modules/', 'node_modules'],
+    'Build & Logs': ['dist/', 'build/', '*.log', 'logs/'],
+    'IDE & OS': ['.DS_Store', 'Thumbs.db', '.idea/', '*.swp'],
+    'AIOS Local': ['.aios-core/local/', '.claude/settings.local.json', '.aios/install-log.txt'],
+  };
+
+  const lines = gitignoreContent.split('\n').map(line => line.trim());
+  const entriesToAdd = [];
+
+  // Check each critical entry
+  for (const [category, entries] of Object.entries(criticalEntries)) {
+    const missingEntries = entries.filter(entry => {
+      // Check if entry already exists (with or without leading /)
+      const normalizedEntry = entry.replace(/^\//, '');
+      return !lines.some(line => {
+        const normalizedLine = line.replace(/^\//, '');
+        return normalizedLine === normalizedEntry || normalizedLine === entry;
+      });
+    });
+
+    if (missingEntries.length > 0) {
+      entriesToAdd.push({ category, entries: missingEntries });
+    }
+  }
+
+  // Add missing entries
+  if (entriesToAdd.length > 0) {
+    let newContent = gitignoreContent.trim();
+
+    for (const { category, entries } of entriesToAdd) {
+      const section = `\n\n# ${category} (AIOS)\n${entries.join('\n')}`;
+      newContent += section;
+    }
+
+    newContent += '\n';
+
+    await fs.writeFile(gitignorePath, newContent, { encoding: 'utf8' });
+  }
+}
+
+module.exports = {
+  configureEnvironment,
+  collectApiKeys,
+  updateGitignore,
+};

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

@@ -0,0 +1,183 @@
+/**
+ * core-config.yaml Template Generator
+ * Story 1.6: Environment Configuration
+ *
+ * Generates YAML configuration file for AIOS framework
+ *
+ * @module core-config-template
+ */
+
+const yaml = require('js-yaml');
+
+/**
+ * Generate core-config.yaml content
+ *
+ * @param {Object} options - Configuration options
+ * @param {string} options.projectType - Project type from Story 1.3 (GREENFIELD|BROWNFIELD|EXISTING_AIOS)
+ * @param {Array<string>} [options.selectedIDEs] - Selected IDEs from Story 1.4
+ * @param {Array<Object>} [options.mcpServers] - MCP server configurations from Story 1.5
+ * @param {string} [options.aiosVersion] - AIOS version (default: 2.1.0)
+ * @returns {string} core-config.yaml content
+ */
+function generateCoreConfig(options = {}) {
+  const {
+    projectType = 'GREENFIELD',
+    selectedIDEs = [],
+    mcpServers = [],
+    aiosVersion = '2.1.0',
+  } = options;
+
+  const config = {
+    // Framework Version & Metadata
+    markdownExploder: true,
+
+    // Project Configuration (from Story 1.3)
+    project: {
+      type: projectType,
+      installedAt: new Date().toISOString(),
+      version: aiosVersion,
+    },
+
+    // IDE Configuration (from Story 1.4)
+    ide: {
+      selected: selectedIDEs.length > 0 ? selectedIDEs : ['vscode'],
+      configs: {
+        vscode: selectedIDEs.includes('vscode') || selectedIDEs.length === 0,
+        cursor: selectedIDEs.includes('cursor'),
+        windsurf: selectedIDEs.includes('windsurf'),
+        zed: selectedIDEs.includes('zed'),
+        'claude-desktop': selectedIDEs.includes('claude-desktop'),
+        'claude-code': selectedIDEs.includes('claude-code'),
+      },
+    },
+
+    // MCP Configuration (from Story 1.5)
+    mcp: {
+      enabled: mcpServers.length > 0,
+      configLocation: '.claude/mcp.json',
+      servers: mcpServers.map(server => server.name || server.id),
+    },
+
+    // QA Configuration
+    qa: {
+      qaLocation: 'docs/qa',
+    },
+
+    // PRD Configuration
+    prd: {
+      prdFile: 'docs/prd.md',
+      prdVersion: 'v4',
+      prdSharded: true,
+      prdShardedLocation: 'docs/prd',
+      epicFilePattern: 'epic-{n}*.md',
+    },
+
+    // Architecture Configuration
+    architecture: {
+      architectureFile: 'docs/architecture.md',
+      architectureVersion: 'v4',
+      architectureSharded: true,
+      architectureShardedLocation: 'docs/architecture',
+    },
+
+    // Development Configuration
+    customTechnicalDocuments: null,
+    devLoadAlwaysFiles: [
+      'docs/framework/coding-standards.md',
+      'docs/framework/tech-stack.md',
+      'docs/framework/source-tree.md',
+    ],
+    devLoadAlwaysFilesFallback: [
+      'docs/architecture/padroes-de-codigo.md',
+      'docs/architecture/pilha-tecnologica.md',
+      'docs/architecture/arvore-de-origem.md',
+    ],
+    devDebugLog: '.ai/debug-log.md',
+    devStoryLocation: 'docs/stories',
+
+    // Slash Command Prefix
+    slashPrefix: 'AIOS',
+
+    // Framework Documentation Paths
+    frameworkDocsLocation: 'docs/framework',
+    projectDocsLocation: 'docs/architecture/project-decisions',
+
+    // Lazy Loading Configuration
+    lazyLoading: {
+      enabled: true,
+      heavySections: [
+        'pvMindContext',
+        'expansionPacks',
+        'registry',
+      ],
+    },
+
+    // Git Configuration
+    git: {
+      showConfigWarning: true,
+      cacheTimeSeconds: 300,
+    },
+
+    // Decision Logging Configuration
+    decisionLogging: {
+      enabled: true,
+      async: true,
+      location: '.ai/',
+      indexFile: 'decision-logs-index.md',
+      format: 'adr',
+      performance: {
+        maxOverhead: 50,
+      },
+    },
+
+    // Resource Locations
+    toolsLocation: '.aios-core/tools',
+    scriptsLocation: '.aios-core/scripts',
+    dataLocation: '.aios-core/data',
+    elicitationLocation: '.aios-core/elicitation',
+    expansionPacksLocation: 'expansion-packs',
+    mindsLocation: 'outputs/minds',
+
+    // Project Status Configuration
+    projectStatus: {
+      enabled: true,
+      autoLoadOnAgentActivation: true,
+      showInGreeting: true,
+      cacheTimeSeconds: 60,
+      components: {
+        gitBranch: true,
+        gitStatus: true,
+        recentWork: true,
+        currentEpic: true,
+        currentStory: true,
+      },
+      statusFile: '.aios/project-status.yaml',
+      maxModifiedFiles: 5,
+      maxRecentCommits: 2,
+    },
+
+    // Agent Identity Configuration
+    agentIdentity: {
+      greeting: {
+        contextDetection: true,
+        sessionDetection: 'hybrid',
+        workflowDetection: 'hardcoded',
+        performance: {
+          gitCheckCache: true,
+          gitCheckTTL: 300,
+        },
+      },
+    },
+  };
+
+  // Convert to YAML with proper formatting
+  return yaml.dump(config, {
+    indent: 2,
+    lineWidth: 120,
+    noRefs: true,
+  });
+}
+
+module.exports = {
+  generateCoreConfig,
+};