create-universal-ai-context 2.2.2 → 2.4.0

package/lib/adapters/continue.js

@@ -0,0 +1,138 @@
+/**
+ * Continue Adapter
+ *
+ * Generates .continue/config.json file for Continue extension
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { renderTemplateByName, buildContext } = require('../template-renderer');
+const { isManagedFile } = require('../template-coordination');
+
+/**
+ * Adapter metadata
+ */
+const adapter = {
+  name: 'continue',
+  displayName: 'Continue',
+  description: 'Configuration file for Continue VS Code/JetBrains extension',
+  outputType: 'single-file',
+  outputPath: '.continue/config.json'
+};
+
+/**
+ * Get output path for Continue config file
+ * @param {string} projectRoot - Project root directory
+ * @returns {string} Output file path
+ */
+function getOutputPath(projectRoot) {
+  return path.join(projectRoot, '.continue', 'config.json');
+}
+
+/**
+ * Check if Continue output already exists
+ * @param {string} projectRoot - Project root directory
+ * @returns {boolean}
+ */
+function exists(projectRoot) {
+  const configPath = getOutputPath(projectRoot);
+  const continueDir = path.join(projectRoot, '.continue');
+  return fs.existsSync(configPath) || fs.existsSync(continueDir);
+}
+
+/**
+ * Generate Continue config file
+ * @param {object} analysis - Analysis results from static analyzer
+ * @param {object} config - Configuration from CLI
+ * @param {string} projectRoot - Project root directory
+ * @returns {object} Generation result
+ */
+async function generate(analysis, config, projectRoot) {
+  const result = {
+    success: false,
+    adapter: adapter.name,
+    files: [],
+    errors: []
+  };
+
+  try {
+    const configPath = getOutputPath(projectRoot);
+
+    // Check if file exists and is custom (not managed by us)
+    if (fs.existsSync(configPath) && !config.force) {
+      if (!isManagedFile(configPath)) {
+        result.errors.push({
+          message: '.continue/config.json exists and appears to be custom. Use --force to overwrite.',
+          code: 'EXISTS_CUSTOM',
+          severity: 'error'
+        });
+        return result;
+      }
+    }
+
+    // Build context from analysis
+    const context = buildContext(analysis, config, 'continue');
+
+    // Render template
+    const content = renderTemplateByName('continue-config', context);
+
+    // Create .continue directory if it doesn't exist
+    const continueDir = path.dirname(configPath);
+    if (!fs.existsSync(continueDir)) {
+      fs.mkdirSync(continueDir, { recursive: true });
+    }
+
+    // Write output file
+    fs.writeFileSync(configPath, content, 'utf-8');
+
+    result.success = true;
+    result.files.push({
+      path: configPath,
+      relativePath: '.continue/config.json',
+      size: content.length
+    });
+  } catch (error) {
+    result.errors.push({
+      message: error.message,
+      stack: error.stack
+    });
+  }
+
+  return result;
+}
+
+/**
+ * Validate Continue output
+ * @param {string} projectRoot - Project root directory
+ * @returns {object} Validation result
+ */
+function validate(projectRoot) {
+  const issues = [];
+  const configPath = getOutputPath(projectRoot);
+
+  if (!fs.existsSync(configPath)) {
+    issues.push({ file: '.continue/config.json', error: 'not found' });
+  } else {
+    const content = fs.readFileSync(configPath, 'utf-8');
+    const placeholderMatch = content.match(/\{\{[A-Z_]+\}\}/g);
+    if (placeholderMatch && placeholderMatch.length > 0) {
+      issues.push({
+        file: '.continue/config.json',
+        error: `Found ${placeholderMatch.length} unreplaced placeholders`
+      });
+    }
+  }
+
+  return {
+    valid: issues.filter(i => i.severity !== 'warning').length === 0,
+    issues
+  };
+}
+
+module.exports = {
+  ...adapter,
+  getOutputPath,
+  exists,
+  generate,
+  validate
+};

package/lib/adapters/copilot.js

@@ -7,6 +7,7 @@
 const fs = require('fs');
 const path = require('path');
 const { renderTemplateByName, buildContext } = require('../template-renderer');
+const { isManagedFile } = require('../template-coordination');
 
 /**
  * Adapter metadata
@@ -53,14 +54,27 @@ async function generate(analysis, config, projectRoot) {
   };
 
   try {
+    const outputPath = getOutputPath(projectRoot);
+
+    // Check if file exists and is custom (not managed by us)
+    if (fs.existsSync(outputPath) && !config.force) {
+      if (!isManagedFile(outputPath)) {
+        result.errors.push({
+          message: '.github/copilot-instructions.md exists and appears to be custom. Use --force to overwrite.',
+          code: 'EXISTS_CUSTOM',
+          severity: 'error'
+        });
+        return result;
+      }
+    }
+
     // Build context from analysis
-    const context = buildContext(analysis, config);
+    const context = buildContext(analysis, config, 'copilot');
 
     // Render template
     const content = renderTemplateByName('copilot', context);
 
     // Ensure .github directory exists
-    const outputPath = getOutputPath(projectRoot);
     const outputDir = path.dirname(outputPath);
     if (!fs.existsSync(outputDir)) {
       fs.mkdirSync(outputDir, { recursive: true });

package/lib/adapters/index.js

@@ -8,6 +8,9 @@ const claude = require('./claude');
 const copilot = require('./copilot');
 const cline = require('./cline');
 const antigravity = require('./antigravity');
+const windsurf = require('./windsurf');
+const aider = require('./aider');
+const continueAdapter = require('./continue');
 
 /**
  * All available adapters
@@ -16,7 +19,10 @@ const adapters = {
   claude,
   copilot,
   cline,
-  antigravity
+  antigravity,
+  windsurf,
+  aider,
+  continue: continueAdapter
 };
 
 /**
@@ -65,5 +71,8 @@ module.exports = {
   claude,
   copilot,
   cline,
-  antigravity
+  antigravity,
+  windsurf,
+  aider,
+  continue: continueAdapter
 };

package/lib/adapters/windsurf.js

@@ -0,0 +1,138 @@
+/**
+ * Windsurf IDE Adapter
+ *
+ * Generates .windsurf/rules.md file for Windsurf IDE Cascade AI
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { renderTemplateByName, buildContext } = require('../template-renderer');
+const { isManagedFile } = require('../template-coordination');
+
+/**
+ * Adapter metadata
+ */
+const adapter = {
+  name: 'windsurf',
+  displayName: 'Windsurf IDE',
+  description: 'Project rules for Windsurf IDE Cascade AI',
+  outputType: 'single-file',
+  outputPath: '.windsurf/rules.md'
+};
+
+/**
+ * Get output path for Windsurf rules file
+ * @param {string} projectRoot - Project root directory
+ * @returns {string} Output file path
+ */
+function getOutputPath(projectRoot) {
+  return path.join(projectRoot, '.windsurf', 'rules.md');
+}
+
+/**
+ * Check if Windsurf output already exists
+ * @param {string} projectRoot - Project root directory
+ * @returns {boolean}
+ */
+function exists(projectRoot) {
+  const rulesPath = getOutputPath(projectRoot);
+  const windsurfDir = path.join(projectRoot, '.windsurf');
+  return fs.existsSync(rulesPath) || fs.existsSync(windsurfDir);
+}
+
+/**
+ * Generate Windsurf rules file
+ * @param {object} analysis - Analysis results from static analyzer
+ * @param {object} config - Configuration from CLI
+ * @param {string} projectRoot - Project root directory
+ * @returns {object} Generation result
+ */
+async function generate(analysis, config, projectRoot) {
+  const result = {
+    success: false,
+    adapter: adapter.name,
+    files: [],
+    errors: []
+  };
+
+  try {
+    const rulesPath = getOutputPath(projectRoot);
+
+    // Check if file exists and is custom (not managed by us)
+    if (fs.existsSync(rulesPath) && !config.force) {
+      if (!isManagedFile(rulesPath)) {
+        result.errors.push({
+          message: '.windsurf/rules.md exists and appears to be custom. Use --force to overwrite.',
+          code: 'EXISTS_CUSTOM',
+          severity: 'error'
+        });
+        return result;
+      }
+    }
+
+    // Build context from analysis
+    const context = buildContext(analysis, config, 'windsurf');
+
+    // Render template
+    const content = renderTemplateByName('windsurf-rules', context);
+
+    // Create .windsurf directory if it doesn't exist
+    const windsurfDir = path.dirname(rulesPath);
+    if (!fs.existsSync(windsurfDir)) {
+      fs.mkdirSync(windsurfDir, { recursive: true });
+    }
+
+    // Write output file
+    fs.writeFileSync(rulesPath, content, 'utf-8');
+
+    result.success = true;
+    result.files.push({
+      path: rulesPath,
+      relativePath: '.windsurf/rules.md',
+      size: content.length
+    });
+  } catch (error) {
+    result.errors.push({
+      message: error.message,
+      stack: error.stack
+    });
+  }
+
+  return result;
+}
+
+/**
+ * Validate Windsurf output
+ * @param {string} projectRoot - Project root directory
+ * @returns {object} Validation result
+ */
+function validate(projectRoot) {
+  const issues = [];
+  const rulesPath = getOutputPath(projectRoot);
+
+  if (!fs.existsSync(rulesPath)) {
+    issues.push({ file: '.windsurf/rules.md', error: 'not found' });
+  } else {
+    const content = fs.readFileSync(rulesPath, 'utf-8');
+    const placeholderMatch = content.match(/\{\{[A-Z_]+\}\}/g);
+    if (placeholderMatch && placeholderMatch.length > 0) {
+      issues.push({
+        file: '.windsurf/rules.md',
+        error: `Found ${placeholderMatch.length} unreplaced placeholders`
+      });
+    }
+  }
+
+  return {
+    valid: issues.filter(i => i.severity !== 'warning').length === 0,
+    issues
+  };
+}
+
+module.exports = {
+  ...adapter,
+  getOutputPath,
+  exists,
+  generate,
+  validate
+};

package/lib/ai-orchestrator.js

@@ -303,7 +303,8 @@ function getPackageVersion() {
     const pkgPath = path.join(__dirname, '..', 'package.json');
     const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
     return pkg.version || '1.0.0';
-  } catch {
+  } catch (error) {
+    // Silently fall back to default version
     return '1.0.0';
   }
 }

package/lib/content-preservation.js

@@ -0,0 +1,243 @@
+/**
+ * Content Preservation Module
+ * Handles migration and preservation of custom content during context generation
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Find custom content in .claude/ directory
+ * Custom content = files without "MANAGED BY" header
+ * @param {string} claudeDir - Path to .claude/ directory
+ * @returns {Array} List of custom content items
+ */
+function findCustomContentInClaude(claudeDir) {
+  const custom = [];
+
+  const walkDir = (dir, depth = 0) => {
+    // Limit depth to avoid infinite recursion
+    if (depth > 10) return;
+
+    if (!fs.existsSync(dir)) {
+      return;
+    }
+
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        // Skip node_modules and other common dirs
+        if (entry.name === 'node_modules' || entry.name === '.git') {
+          continue;
+        }
+        walkDir(path.join(dir, entry.name), depth + 1);
+      } else if (entry.name.endsWith('.md')) {
+        const filePath = path.join(dir, entry.name);
+        try {
+          const content = fs.readFileSync(filePath, 'utf-8');
+
+          // Check if file has managed header
+          if (!content.includes('MANAGED BY CREATE-AI-CONTEXT') &&
+              !content.includes('Auto-generated by AI Context Engineering')) {
+            const relPath = path.relative(claudeDir, filePath);
+            custom.push({
+              path: relPath,
+              type: determineContentType(relPath),
+              content: content
+            });
+          }
+        } catch (err) {
+          // Skip unreadable files
+        }
+      }
+    }
+  };
+
+  walkDir(claudeDir);
+  return custom;
+}
+
+/**
+ * Determine content type from path
+ * @param {string} relPath - Relative path from .claude/
+ * @returns {string} Content type
+ */
+function determineContentType(relPath) {
+  // Normalize path separators to forward slashes for cross-platform compatibility
+  const normalizedPath = relPath.replace(/\\/g, '/');
+
+  if (normalizedPath.startsWith('agents/')) return 'agent';
+  if (normalizedPath.startsWith('commands/')) return 'command';
+  if (normalizedPath.startsWith('context/')) return 'context';
+  if (normalizedPath.startsWith('workflows/')) return 'workflow';
+  if (normalizedPath.startsWith('schemas/')) return 'schema';
+  if (normalizedPath.startsWith('standards/')) return 'standard';
+  return 'other';
+}
+
+/**
+ * Migrate custom content to .ai-context/custom/
+ * @param {string} claudeDir - Source .claude/ directory
+ * @param {string} aiContextDir - Destination .ai-context/ directory
+ * @param {Array} customItems - Items to migrate
+ * @returns {Array} List of migrated items with paths
+ */
+function migrateCustomContent(claudeDir, aiContextDir, customItems) {
+  const customDir = path.join(aiContextDir, 'custom');
+  fs.mkdirSync(customDir, { recursive: true });
+
+  const migrated = [];
+
+  for (const item of customItems) {
+    const destPath = path.join(customDir, item.path);
+    const destDir = path.dirname(destPath);
+
+    try {
+      fs.mkdirSync(destDir, { recursive: true });
+
+      // Add preservation header
+      const preservedHeader = `<!--
+PRESERVED FROM .claude/${item.path}
+This file was migrated from .claude/ to .ai-context/custom/ to preserve custom content.
+Original migration date: ${new Date().toISOString()}
+-->
+`;
+
+      fs.writeFileSync(destPath, preservedHeader + item.content);
+
+      migrated.push({
+        original: `.claude/${item.path}`,
+        destination: `.ai-context/custom/${item.path}`,
+        type: item.type
+      });
+    } catch (err) {
+      // Log error but continue with other files
+      console.warn(`Failed to migrate ${item.path}: ${err.message}`);
+    }
+  }
+
+  return migrated;
+}
+
+/**
+ * Detect custom content markers in a file
+ * @param {string} content - File content
+ * @returns {boolean} True if content has custom markers
+ */
+function detectCustomContent(content) {
+  // Check for absence of managed marker
+  if (!content || content.length === 0) {
+    return false;
+  }
+
+  const hasManagedMarker = content.includes('MANAGED BY CREATE-AI-CONTEXT') ||
+                          content.includes('Auto-generated by AI Context Engineering') ||
+                          content.includes('Managed by create-ai-context') ||
+                          content.includes('CREATE-AI-CONTEXT');
+
+  if (!hasManagedMarker) {
+    return true;
+  }
+
+  // Check for custom edit markers
+  if (content.includes('<!-- CUSTOM EDIT -->') ||
+      content.includes('# CUSTOM EDIT') ||
+      content.includes('<!-- USER CUSTOM -->')) {
+    return true;
+  }
+
+  return false;
+}
+
+/**
+ * Find custom files in .agent/ directory
+ * @param {string} agentDir - Path to .agent/ directory
+ * @returns {Array} List of custom file paths (relative)
+ */
+function findCustomFilesInAgent(agentDir) {
+  const custom = [];
+
+  if (!fs.existsSync(agentDir)) {
+    return custom;
+  }
+
+  const walkDir = (dir, depth = 0) => {
+    if (depth > 10) return;
+
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        if (entry.name !== 'node_modules' && entry.name !== '.git') {
+          walkDir(path.join(dir, entry.name), depth + 1);
+        }
+      } else if (entry.name.endsWith('.md')) {
+        const filePath = path.join(dir, entry.name);
+        try {
+          const content = fs.readFileSync(filePath, 'utf-8');
+
+          if (!content.includes('Auto-generated by AI Context Engineering') &&
+              !content.includes('Auto-generated by AI Context Engineering v2')) {
+            const relPath = path.relative(agentDir, filePath);
+            custom.push(relPath);
+          }
+        } catch (err) {
+          // Skip unreadable files
+        }
+      }
+    }
+  };
+
+  walkDir(agentDir);
+  return custom;
+}
+
+/**
+ * Backup existing files before migration
+ * @param {string} filePath - File to backup
+ * @returns {string} Backup file path
+ */
+function backupFile(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  const backupPath = filePath + '.backup.' + Date.now();
+  try {
+    fs.copyFileSync(filePath, backupPath);
+    return backupPath;
+  } catch (err) {
+    console.warn(`Failed to create backup of ${filePath}: ${err.message}`);
+    return null;
+  }
+}
+
+/**
+ * Restore from backup
+ * @param {string} backupPath - Backup file path
+ * @returns {boolean} True if restored successfully
+ */
+function restoreFromBackup(backupPath) {
+  if (!fs.existsSync(backupPath)) {
+    return false;
+  }
+
+  const originalPath = backupPath.replace(/\.backup\.\d+$/, '');
+  try {
+    fs.copyFileSync(backupPath, originalPath);
+    fs.unlinkSync(backupPath);
+    return true;
+  } catch (err) {
+    console.warn(`Failed to restore from backup ${backupPath}: ${err.message}`);
+    return false;
+  }
+}
+
+module.exports = {
+  findCustomContentInClaude,
+  migrateCustomContent,
+  detectCustomContent,
+  findCustomFilesInAgent,
+  determineContentType,
+  backupFile,
+  restoreFromBackup
+};

package/lib/index.js

@@ -77,7 +77,11 @@ async function run(options = {}) {
     mode = 'merge',  // 'merge' | 'overwrite' | 'interactive'
     preserveCustom = true,
     updateRefs = false,
-    backup = false
+    backup = false,
+    // Force flag
+    force = false,
+    // Placeholder validation
+    failOnUnreplaced = false
   } = options;
 
   // Determine target directory
@@ -267,9 +271,11 @@ async function run(options = {}) {
   const placeholdersReplaced = await replacePlaceholders(targetDir, {
     ...config,
     techStack,
-    analysis
+    analysis,
+    failOnUnreplaced: config.failOnUnreplaced,
+    verbose: config.verbose
   });
-  spinner.succeed(`Replaced ${placeholdersReplaced} placeholders`);
+  spinner.succeed(`Replaced ${placeholdersReplaced.totalReplaced} placeholders`);
 
   // Phase 10: AI Orchestration (if in Claude Code environment)
   if (env.mode === 'full-ai' || env.mode === 'hybrid') {
@@ -289,7 +295,8 @@ async function run(options = {}) {
   try {
     generationResults = await generateAllContexts(analysis, config, targetDir, {
       aiTools: config.aiTools,
-      verbose: config.verbose
+      verbose: config.verbose,
+      force: config.force || false
     });
     const toolsGenerated = generationResults.generated.map(g => g.adapter).join(', ');
     if (generationResults.success) {