aios-core 2.1.3 → 2.1.5

package/.aios-core/infrastructure/scripts/documentation-integrity/mode-detector.js

@@ -1,358 +0,0 @@
-/**
- * Mode Detector Module
- *
- * Detects installation mode for AIOS projects with three-mode support:
- * - FRAMEWORK_DEV: Contributing to aios-core itself
- * - GREENFIELD: New empty project
- * - BROWNFIELD: Existing project being integrated
- *
- * @module documentation-integrity/mode-detector
- * @version 1.0.0
- * @story 6.9
- */
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * Installation modes supported by AIOS
- * @enum {string}
- */
-const InstallationMode = {
-  FRAMEWORK_DEV: 'framework-dev',
-  GREENFIELD: 'greenfield',
-  BROWNFIELD: 'brownfield',
-  UNKNOWN: 'unknown',
-};
-
-/**
- * Legacy project type mappings (for backward compatibility)
- * @enum {string}
- */
-const LegacyProjectType = {
-  EXISTING_AIOS: 'EXISTING_AIOS',
-  GREENFIELD: 'GREENFIELD',
-  BROWNFIELD: 'BROWNFIELD',
-  UNKNOWN: 'UNKNOWN',
-};
-
-/**
- * Mode descriptions for display in wizard
- * @type {Object.<string, Object>}
- */
-const ModeDescriptions = {
-  [InstallationMode.FRAMEWORK_DEV]: {
-    label: '🔧 Framework Development',
-    hint: 'Developing aios-core itself - uses framework standards, skips project setup',
-    description: 'For AIOS contributors working on the framework',
-  },
-  [InstallationMode.GREENFIELD]: {
-    label: '🆕 New Project (Greenfield)',
-    hint: 'Start a fresh project with AIOS - generates project docs, config, and infrastructure',
-    description: 'Empty directory setup with full scaffolding',
-  },
-  [InstallationMode.BROWNFIELD]: {
-    label: '📂 Existing Project (Brownfield)',
-    hint: 'Add AIOS to existing project - analyzes current structure and adapts',
-    description: 'Integration with existing codebase',
-  },
-  [InstallationMode.UNKNOWN]: {
-    label: '❓ Unknown',
-    hint: 'Could not determine project type - manual selection required',
-    description: 'Manual mode selection needed',
-  },
-};
-
-/**
- * Detection result with confidence and reasoning
- * @typedef {Object} DetectionResult
- * @property {string} mode - Detected installation mode
- * @property {string} legacyType - Legacy project type for backward compatibility
- * @property {number} confidence - Detection confidence (0-100)
- * @property {string} reason - Human-readable reason for detection
- * @property {Object} markers - Detected markers in the directory
- */
-
-/**
- * Detects the installation mode for a target directory
- *
- * Detection Priority Order:
- * 1. FRAMEWORK_DEV - .aios-core/ exists AND is aios-core repo
- * 2. GREENFIELD - directory is empty
- * 3. BROWNFIELD - has package.json, .git, or other project markers
- * 4. UNKNOWN - has files but no recognized markers
- *
- * @param {string} targetDir - Directory to analyze
- * @returns {DetectionResult} Detection result with mode and metadata
- * @throws {Error} If directory cannot be accessed
- */
-function detectInstallationMode(targetDir = process.cwd()) {
-  // Validate input
-  if (!targetDir || typeof targetDir !== 'string') {
-    throw new Error('Invalid targetDir parameter: must be a non-empty string');
-  }
-
-  const normalizedDir = path.resolve(targetDir);
-
-  // Check if directory exists
-  if (!fs.existsSync(normalizedDir)) {
-    throw new Error(`Directory does not exist: ${normalizedDir}`);
-  }
-
-  // Collect markers
-  const markers = collectMarkers(normalizedDir);
-
-  // Priority 1: Check for AIOS framework development
-  if (markers.hasAiosCore && markers.isAiosCoreRepo) {
-    return {
-      mode: InstallationMode.FRAMEWORK_DEV,
-      legacyType: LegacyProjectType.EXISTING_AIOS,
-      confidence: 100,
-      reason: 'Detected aios-core repository with .aios-core directory',
-      markers,
-    };
-  }
-
-  // Priority 2: Check for existing AIOS installation (non-framework)
-  if (markers.hasAiosCore && !markers.isAiosCoreRepo) {
-    return {
-      mode: InstallationMode.BROWNFIELD,
-      legacyType: LegacyProjectType.EXISTING_AIOS,
-      confidence: 95,
-      reason: 'AIOS already installed in user project - treating as brownfield update',
-      markers,
-    };
-  }
-
-  // Priority 3: Check for empty directory (greenfield)
-  if (markers.isEmpty) {
-    return {
-      mode: InstallationMode.GREENFIELD,
-      legacyType: LegacyProjectType.GREENFIELD,
-      confidence: 100,
-      reason: 'Empty directory detected',
-      markers,
-    };
-  }
-
-  // Priority 4: Check for project markers (brownfield)
-  if (
-    markers.hasPackageJson ||
-    markers.hasGit ||
-    markers.hasPythonProject ||
-    markers.hasGoMod ||
-    markers.hasCargoToml
-  ) {
-    const projectTypes = [];
-    if (markers.hasPackageJson) projectTypes.push('Node.js');
-    if (markers.hasPythonProject) projectTypes.push('Python');
-    if (markers.hasGoMod) projectTypes.push('Go');
-    if (markers.hasCargoToml) projectTypes.push('Rust');
-
-    return {
-      mode: InstallationMode.BROWNFIELD,
-      legacyType: LegacyProjectType.BROWNFIELD,
-      confidence: 90,
-      reason: `Existing project detected: ${projectTypes.join(', ') || 'Git repository'}`,
-      markers,
-    };
-  }
-
-  // Priority 5: Directory has files but no recognized markers
-  return {
-    mode: InstallationMode.UNKNOWN,
-    legacyType: LegacyProjectType.UNKNOWN,
-    confidence: 0,
-    reason: 'Directory has files but no recognized project markers',
-    markers,
-  };
-}
-
-/**
- * Collects all relevant markers from a directory
- *
- * @param {string} targetDir - Directory to scan
- * @returns {Object} Object containing all detected markers
- */
-function collectMarkers(targetDir) {
-  const dirContents = fs.readdirSync(targetDir);
-
-  return {
-    // AIOS markers
-    hasAiosCore: fs.existsSync(path.join(targetDir, '.aios-core')),
-    isAiosCoreRepo: isAiosCoreRepository(targetDir),
-
-    // Directory state
-    isEmpty: dirContents.length === 0,
-    fileCount: dirContents.length,
-
-    // Project markers
-    hasPackageJson: fs.existsSync(path.join(targetDir, 'package.json')),
-    hasGit: fs.existsSync(path.join(targetDir, '.git')),
-
-    // Python markers
-    hasPythonProject:
-      fs.existsSync(path.join(targetDir, 'requirements.txt')) ||
-      fs.existsSync(path.join(targetDir, 'pyproject.toml')) ||
-      fs.existsSync(path.join(targetDir, 'setup.py')),
-
-    // Go markers
-    hasGoMod: fs.existsSync(path.join(targetDir, 'go.mod')),
-
-    // Rust markers
-    hasCargoToml: fs.existsSync(path.join(targetDir, 'Cargo.toml')),
-
-    // Existing standards markers
-    hasEslintrc:
-      fs.existsSync(path.join(targetDir, '.eslintrc.js')) ||
-      fs.existsSync(path.join(targetDir, '.eslintrc.json')) ||
-      fs.existsSync(path.join(targetDir, '.eslintrc.yaml')),
-    hasPrettierrc:
-      fs.existsSync(path.join(targetDir, '.prettierrc')) ||
-      fs.existsSync(path.join(targetDir, '.prettierrc.json')) ||
-      fs.existsSync(path.join(targetDir, 'prettier.config.js')),
-    hasTsconfig: fs.existsSync(path.join(targetDir, 'tsconfig.json')),
-
-    // CI/CD markers
-    hasGithubWorkflows: fs.existsSync(path.join(targetDir, '.github', 'workflows')),
-    hasGitlabCi: fs.existsSync(path.join(targetDir, '.gitlab-ci.yml')),
-  };
-}
-
-/**
- * Checks if the target directory is the aios-core repository itself
- *
- * @param {string} targetDir - Directory to check
- * @returns {boolean} True if this is the aios-core repository
- */
-function isAiosCoreRepository(targetDir) {
-  const packageJsonPath = path.join(targetDir, 'package.json');
-
-  if (!fs.existsSync(packageJsonPath)) {
-    return false;
-  }
-
-  try {
-    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
-    // Check for aios-core package name or workspaces pattern
-    const isAiosCore =
-      packageJson.name === '@aios/core' ||
-      packageJson.name === 'aios-core' ||
-      (Array.isArray(packageJson.workspaces) && packageJson.workspaces.includes('packages/*'));
-    return isAiosCore === true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Maps legacy project type to new installation mode
- *
- * @param {string} legacyType - Legacy project type (EXISTING_AIOS, GREENFIELD, etc.)
- * @returns {string} New installation mode
- */
-function mapLegacyTypeToMode(legacyType) {
-  const mapping = {
-    [LegacyProjectType.EXISTING_AIOS]: InstallationMode.FRAMEWORK_DEV,
-    [LegacyProjectType.GREENFIELD]: InstallationMode.GREENFIELD,
-    [LegacyProjectType.BROWNFIELD]: InstallationMode.BROWNFIELD,
-    [LegacyProjectType.UNKNOWN]: InstallationMode.UNKNOWN,
-  };
-
-  return mapping[legacyType] || InstallationMode.UNKNOWN;
-}
-
-/**
- * Validates user mode selection against auto-detection
- *
- * @param {string} selectedMode - User-selected mode
- * @param {DetectionResult} detected - Auto-detected result
- * @returns {Object} Validation result with warnings if mismatch
- */
-function validateModeSelection(selectedMode, detected) {
-  const result = {
-    isValid: true,
-    warnings: [],
-    suggestions: [],
-  };
-
-  // Allow any selection for UNKNOWN detection
-  if (detected.mode === InstallationMode.UNKNOWN) {
-    return result;
-  }
-
-  // Check for mismatches
-  if (selectedMode !== detected.mode) {
-    if (selectedMode === InstallationMode.GREENFIELD && !detected.markers.isEmpty) {
-      result.warnings.push(
-        'Selected greenfield but directory is not empty. Existing files may be overwritten.',
-      );
-    }
-
-    if (selectedMode === InstallationMode.FRAMEWORK_DEV && !detected.markers.isAiosCoreRepo) {
-      result.warnings.push(
-        'Selected framework-dev but this does not appear to be the aios-core repository.',
-      );
-    }
-
-    if (selectedMode === InstallationMode.BROWNFIELD && detected.markers.isEmpty) {
-      result.warnings.push(
-        'Selected brownfield but directory is empty. Consider using greenfield instead.',
-      );
-      result.suggestions.push(InstallationMode.GREENFIELD);
-    }
-  }
-
-  return result;
-}
-
-/**
- * Gets mode options for wizard display
- *
- * @param {DetectionResult} [detected] - Optional detected result to highlight recommended
- * @returns {Array<Object>} Array of mode options for wizard
- */
-function getModeOptions(detected = null) {
-  const options = [
-    {
-      value: InstallationMode.GREENFIELD,
-      label: ModeDescriptions[InstallationMode.GREENFIELD].label,
-      hint: ModeDescriptions[InstallationMode.GREENFIELD].hint,
-    },
-    {
-      value: InstallationMode.BROWNFIELD,
-      label: ModeDescriptions[InstallationMode.BROWNFIELD].label,
-      hint: ModeDescriptions[InstallationMode.BROWNFIELD].hint,
-    },
-    {
-      value: InstallationMode.FRAMEWORK_DEV,
-      label: ModeDescriptions[InstallationMode.FRAMEWORK_DEV].label,
-      hint: ModeDescriptions[InstallationMode.FRAMEWORK_DEV].hint,
-    },
-  ];
-
-  // If we have detection, mark recommended option
-  if (detected && detected.mode !== InstallationMode.UNKNOWN) {
-    const recommendedIndex = options.findIndex((opt) => opt.value === detected.mode);
-    if (recommendedIndex >= 0) {
-      options[recommendedIndex].hint += ' (Recommended)';
-      // Move recommended to top
-      const recommended = options.splice(recommendedIndex, 1)[0];
-      options.unshift(recommended);
-    }
-  }
-
-  return options;
-}
-
-module.exports = {
-  detectInstallationMode,
-  collectMarkers,
-  isAiosCoreRepository,
-  mapLegacyTypeToMode,
-  validateModeSelection,
-  getModeOptions,
-  InstallationMode,
-  LegacyProjectType,
-  ModeDescriptions,
-};

package/.aios-core/infrastructure/templates/core-config/core-config-brownfield.tmpl.yaml

@@ -1,182 +0,0 @@
-# AIOS Core Configuration
-# Generated by AIOS Documentation Integrity System
-# Mode: Brownfield (Existing Project Integration)
-# Date: {{GENERATED_DATE}}
-
-# =============================================================================
-# PROJECT CONFIGURATION
-# =============================================================================
-project:
-  type: USER_PROJECT
-  mode: brownfield
-  name: "{{PROJECT_NAME}}"
-  analyzed: "{{GENERATED_DATE}}"
-  version: "{{PROJECT_VERSION}}"
-
-  # Analysis metadata from brownfield analyzer
-  analysis:
-    existing_structure: {{HAS_EXISTING_STRUCTURE}}
-    existing_workflows: {{HAS_EXISTING_WORKFLOWS}}
-    existing_standards: {{HAS_EXISTING_STANDARDS}}
-    merge_strategy: "{{MERGE_STRATEGY}}"  # parallel | replace | manual
-
-    # Detected configurations (for reference)
-    detected:
-      tech_stack: {{DETECTED_TECH_STACK}}
-      frameworks: {{DETECTED_FRAMEWORKS}}
-      linting: {{DETECTED_LINTING}}
-      formatting: {{DETECTED_FORMATTING}}
-      testing: {{DETECTED_TESTING}}
-
-# =============================================================================
-# DEV CONTEXT LOADING
-# Files loaded automatically when @dev agent activates
-# =============================================================================
-devLoadAlwaysFiles:
-  - docs/architecture/coding-standards.md
-  - docs/architecture/tech-stack.md
-  - docs/architecture/source-tree.md
-
-# =============================================================================
-# DEPLOYMENT CONFIGURATION
-# All @devops agent tasks read from this section
-# Analyzed from existing workflows + user confirmation
-# =============================================================================
-deployment:
-  # Workflow type (detected or user-selected)
-  workflow: {{DEPLOYMENT_WORKFLOW}}
-
-  # Branch routing configuration (analyzed from existing PR patterns)
-  branches:
-    staging_targets:
-      - "feature/*"
-      - "fix/*"
-      - "docs/*"
-      - "chore/*"
-      - "refactor/*"
-      - "test/*"
-
-    production_targets:
-      - "hotfix/*"
-
-    # Detected branch names (may differ from defaults)
-    staging_branch: {{STAGING_BRANCH}}
-    production_branch: {{PRODUCTION_BRANCH}}
-    default_target: {{DEFAULT_TARGET}}
-
-  # Environment configuration (detected from existing deploy configs)
-  environments:
-    staging:
-      name: "{{STAGING_ENV_NAME}}"
-      branch: {{STAGING_BRANCH}}
-      auto_deploy: {{STAGING_AUTO_DEPLOY}}
-      platform: "{{DEPLOYMENT_PLATFORM}}"
-      url: "${STAGING_URL}"
-      promotion_message: "After validation, create PR to {{PRODUCTION_BRANCH}} for production"
-
-    production:
-      name: "{{PRODUCTION_ENV_NAME}}"
-      branch: {{PRODUCTION_BRANCH}}
-      auto_deploy: {{PRODUCTION_AUTO_DEPLOY}}
-      platform: "{{DEPLOYMENT_PLATFORM}}"
-      url: "${PRODUCTION_URL}"
-      promotion_message: "This is the final production deployment"
-
-  # Quality gates (detected from existing CI)
-  quality_gates:
-    lint: {{QUALITY_LINT}}
-    typecheck: {{QUALITY_TYPECHECK}}
-    tests: {{QUALITY_TESTS}}
-    security_scan: {{QUALITY_SECURITY}}
-    min_coverage: {{MIN_COVERAGE}}
-
-  # PR defaults
-  pr_defaults:
-    auto_assign_reviewers: {{AUTO_ASSIGN_REVIEWERS}}
-    draft_by_default: {{DRAFT_BY_DEFAULT}}
-    include_deployment_info: true
-
-# =============================================================================
-# EXISTING CONFIGURATION PRESERVATION
-# References to existing config files that should be respected
-# =============================================================================
-existing_configs:
-  # Linting/Formatting (don't override these)
-  eslint: {{ESLINT_CONFIG_PATH}}
-  prettier: {{PRETTIER_CONFIG_PATH}}
-  tsconfig: {{TSCONFIG_PATH}}
-  flake8: {{FLAKE8_CONFIG_PATH}}
-
-  # CI/CD (may need merge)
-  github_workflows: {{GITHUB_WORKFLOWS_PATH}}
-  gitlab_ci: {{GITLAB_CI_PATH}}
-
-  # Package management
-  package_json: {{PACKAGE_JSON_PATH}}
-  requirements_txt: {{REQUIREMENTS_PATH}}
-  go_mod: {{GO_MOD_PATH}}
-
-# =============================================================================
-# AGENT CONFIGURATION
-# =============================================================================
-agents:
-  dev:
-    auto_load_context: true
-    story_tracking: true
-    respect_existing_standards: true
-
-  qa:
-    run_on_pr: true
-    coverage_threshold: {{MIN_COVERAGE}}
-
-  devops:
-    auto_detect_workflow: true
-    merge_with_existing: {{MERGE_WORKFLOWS}}
-
-# =============================================================================
-# FEATURES
-# =============================================================================
-features:
-  documentation_integrity: true
-  source_tree_guardian: true
-  quality_metrics: true
-
-  documentation_integrity_options:
-    generate_source_tree: true
-    generate_coding_standards: true
-    generate_tech_stack: true
-    brownfield_analysis: true
-    gitignore_generation: true
-    merge_gitignore: true  # Merge with existing instead of replace
-
-# =============================================================================
-# MIGRATION NOTES
-# Auto-generated notes from brownfield analysis
-# =============================================================================
-migration_notes:
-  # Summary of what was detected vs generated
-  summary: "{{MIGRATION_SUMMARY}}"
-
-  # Items requiring manual review
-  manual_review_items:
-{{#each MANUAL_REVIEW_ITEMS}}
-    - "{{this}}"
-{{/each}}
-
-  # Potential conflicts detected
-  conflicts:
-{{#each CONFLICTS}}
-    - "{{this}}"
-{{/each}}
-
-  # Recommendations
-  recommendations:
-{{#each RECOMMENDATIONS}}
-    - "{{this}}"
-{{/each}}
-
-# =============================================================================
-# CUSTOM CONFIGURATION
-# Project-specific settings
-# =============================================================================
-custom: {}

package/.aios-core/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml

@@ -1,127 +0,0 @@
-# AIOS Core Configuration
-# Generated by AIOS Documentation Integrity System
-# Mode: Greenfield (New Project)
-# Date: {{GENERATED_DATE}}
-
-# =============================================================================
-# PROJECT CONFIGURATION
-# =============================================================================
-project:
-  type: USER_PROJECT
-  mode: greenfield
-  name: "{{PROJECT_NAME}}"
-  created: "{{GENERATED_DATE}}"
-  version: "0.1.0"
-
-# =============================================================================
-# DEV CONTEXT LOADING
-# Files loaded automatically when @dev agent activates
-# =============================================================================
-devLoadAlwaysFiles:
-  - docs/architecture/coding-standards.md
-  - docs/architecture/tech-stack.md
-  - docs/architecture/source-tree.md
-
-# =============================================================================
-# DEPLOYMENT CONFIGURATION
-# All @devops agent tasks read from this section
-# See docs/guides/DEPLOYMENT-GUIDE.md for details
-# =============================================================================
-deployment:
-  # Workflow type: staging-first (with staging branch) or direct-to-main
-  workflow: {{DEPLOYMENT_WORKFLOW}}
-
-  # Branch routing configuration
-  branches:
-    # These branch patterns will target staging (if staging-first workflow)
-    staging_targets:
-      - "feature/*"
-      - "fix/*"
-      - "docs/*"
-      - "chore/*"
-      - "refactor/*"
-      - "test/*"
-
-    # These branch patterns will target production directly (emergency fixes)
-    production_targets:
-      - "hotfix/*"
-
-    # Branch names
-    staging_branch: {{STAGING_BRANCH}}
-    production_branch: {{PRODUCTION_BRANCH}}
-
-    # Default PR target for ambiguous cases
-    default_target: {{DEFAULT_TARGET}}
-
-  # Environment configuration
-  environments:
-    staging:
-      name: "{{STAGING_ENV_NAME}}"
-      branch: {{STAGING_BRANCH}}
-      auto_deploy: true
-      platform: "{{DEPLOYMENT_PLATFORM}}"
-      url: "${STAGING_URL}"
-      promotion_message: "After validation, create PR to {{PRODUCTION_BRANCH}} for production"
-
-    production:
-      name: "{{PRODUCTION_ENV_NAME}}"
-      branch: {{PRODUCTION_BRANCH}}
-      auto_deploy: true
-      platform: "{{DEPLOYMENT_PLATFORM}}"
-      url: "${PRODUCTION_URL}"
-      promotion_message: "This is the final production deployment"
-
-  # Quality gates for PRs
-  quality_gates:
-    lint: {{QUALITY_LINT}}
-    typecheck: {{QUALITY_TYPECHECK}}
-    tests: {{QUALITY_TESTS}}
-    security_scan: {{QUALITY_SECURITY}}
-    min_coverage: {{MIN_COVERAGE}}
-
-  # PR defaults
-  pr_defaults:
-    auto_assign_reviewers: false
-    draft_by_default: false
-    include_deployment_info: true
-    labels:
-      staging: ["staging", "needs-review"]
-      production: ["production", "promotion"]
-
-# =============================================================================
-# AGENT CONFIGURATION
-# Agent-specific settings
-# =============================================================================
-agents:
-  dev:
-    auto_load_context: true
-    story_tracking: true
-
-  qa:
-    run_on_pr: true
-    coverage_threshold: {{MIN_COVERAGE}}
-
-  devops:
-    auto_detect_workflow: true
-
-# =============================================================================
-# FEATURES
-# Feature flags for optional functionality
-# =============================================================================
-features:
-  documentation_integrity: true
-  source_tree_guardian: true
-  quality_metrics: true
-
-  documentation_integrity_options:
-    generate_source_tree: true
-    generate_coding_standards: true
-    generate_tech_stack: true
-    brownfield_analysis: false
-    gitignore_generation: true
-
-# =============================================================================
-# CUSTOM CONFIGURATION
-# Project-specific settings
-# =============================================================================
-custom: {}