create-universal-ai-context 2.2.1 → 2.3.0

package/lib/adapters/claude.js

@@ -73,7 +73,9 @@ async function generate(analysis, config, projectRoot) {
       result.files.push(...claudeDirResult);
     }
 
-    result.success = result.errors.length === 0 || result.errors.some(e => e.code === 'EXISTS');
+    // Success if no actual errors (warnings and info are OK)
+    result.success = result.errors.length === 0 ||
+      result.errors.every(e => e.code === 'EXISTS' || e.severity === 'info' || e.severity === 'warning');
   } catch (error) {
     result.errors.push({
       message: error.message,
@@ -85,7 +87,7 @@ async function generate(analysis, config, projectRoot) {
 }
 
 /**
- * Generate .claude/ directory with full structure
+ * Generate .claude/ directory with symlinks to .ai-context/
  * @param {string} projectRoot - Project root directory
  * @param {object} context - Template context
  * @param {object} result - Result object to track files/errors
@@ -94,6 +96,7 @@ async function generate(analysis, config, projectRoot) {
 async function generateClaudeDirectory(projectRoot, context, result) {
   const { copyDirectory } = require('../installer');
   const templatesDir = path.join(__dirname, '..', '..', 'templates', 'base');
+  const aiContextDir = path.join(projectRoot, '.ai-context');
   const claudeDir = path.join(projectRoot, '.claude');
 
   // Don't overwrite existing .claude/ directory
@@ -115,29 +118,52 @@ async function generateClaudeDirectory(projectRoot, context, result) {
     // Create .claude/ directory
     fs.mkdirSync(claudeDir, { recursive: true });
 
-    // Copy relevant subdirectories from templates/base to .claude/
-    const subdirsToCopy = [
+    // Subdirectories to symlink from .ai-context/
+    const subdirsToLink = [
       'agents',
       'commands',
       'indexes',
       'context',
       'schemas',
-      'standards'
+      'standards',
+      'tools'
     ];
 
-    // Only copy tools if explicitly enabled
-    if (context.features?.tools !== false) {
-      subdirsToCopy.push('tools');
-    }
-
+    let linksCreated = 0;
     let filesCopied = 0;
-    for (const subdir of subdirsToCopy) {
-      const srcPath = path.join(templatesDir, subdir);
-      if (fs.existsSync(srcPath)) {
-        const destPath = path.join(claudeDir, subdir);
-        fs.mkdirSync(destPath, { recursive: true });
-        const count = await copyDirectory(srcPath, destPath);
-        filesCopied += count;
+
+    for (const subdir of subdirsToLink) {
+      const srcPath = path.join(aiContextDir, subdir);
+      const destPath = path.join(claudeDir, subdir);
+
+      // Skip if source doesn't exist
+      if (!fs.existsSync(srcPath)) {
+        continue;
+      }
+
+      // Try to create symlink, fallback to copy
+      try {
+        // Remove dest if it exists (shouldn't, but safety)
+        if (fs.existsSync(destPath)) {
+          if (fs.lstatSync(destPath).isSymbolicLink()) {
+            fs.unlinkSync(destPath);
+          } else {
+            // Existing directory, skip
+            continue;
+          }
+        }
+
+        // Create symlink
+        fs.symlinkSync(srcPath, destPath, 'junction');
+        linksCreated++;
+      } catch (symlinkError) {
+        // Symlink failed (likely Windows permissions or filesystem limitation)
+        // Fallback: copy directory contents
+        if (!fs.existsSync(destPath)) {
+          fs.mkdirSync(destPath, { recursive: true });
+          const count = await copyDirectory(srcPath, destPath);
+          filesCopied += count;
+        }
       }
     }
 
@@ -145,7 +171,7 @@ async function generateClaudeDirectory(projectRoot, context, result) {
     const settingsPath = path.join(claudeDir, 'settings.json');
     const settings = {
       '$schema': './schemas/settings.schema.json',
-      version: '2.1.0',
+      version: '2.2.2',
       project: {
         name: context.project?.name || 'Project',
         tech_stack: context.project?.tech_stack || 'Not detected'
@@ -170,7 +196,26 @@ async function generateClaudeDirectory(projectRoot, context, result) {
     const readmePath = path.join(claudeDir, 'README.md');
     const readme = `# .claude Configuration - ${context.project?.name || 'Project'}
 
-This directory contains Claude Code-specific context engineering files.
+This directory provides Claude Code with auto-discovered commands, agents, and configuration.
+
+## Architecture
+
+This directory uses **symlinks** to \`../.ai-context/\` for all shared content:
+
+\`\`\`
+.claude/
+├── agents       → ../.ai-context/agents/
+├── commands     → ../.ai-context/commands/
+├── indexes      → ../.ai-context/indexes/
+├── context      → ../.ai-context/context/
+├── schemas      → ../.ai-context/schemas/
+├── standards    → ../.ai-context/standards/
+├── tools        → ../.ai-context/tools/
+├── settings.json (this file - Claude-specific)
+└── README.md (this file)
+\`\`\`
+
+**Single source of truth:** All content lives in \`.ai-context/\`. Edit there, not here.
 
 ## Quick Start
 
@@ -182,22 +227,26 @@ This directory contains Claude Code-specific context engineering files.
 
 See \`AI_CONTEXT.md\` at project root for universal AI context (works with all tools).
 
-## Claude-Specific Files
-
-- **agents/** - Specialized agents for different tasks
-- **commands/** - Custom slash commands
-- **indexes/** - 3-level navigation system
-- **context/** - Workflow documentation
-
-*Generated by create-universal-ai-context v${context.version || '2.1.0'}*
+*Generated by create-universal-ai-context v${context.version || '2.3.0'}*
 `;
     fs.writeFileSync(readmePath, readme);
     filesCopied++;
 
+    // Add info message about symlink approach
+    if (linksCreated > 0) {
+      result.errors.push({
+        message: `Created ${linksCreated} symlinks from .claude/ to .ai-context/ (single source of truth)`,
+        code: 'SYMLINKS_CREATED',
+        severity: 'info'
+      });
+    }
+
     return [{
       path: claudeDir,
       relativePath: '.claude/',
-      size: filesCopied
+      size: filesCopied,
+      symlinks: linksCreated,
+      details: `${linksCreated} symlinks, ${filesCopied} files`
     }];
 
   } catch (error) {

package/lib/cross-tool-sync/sync-manager.js

@@ -9,7 +9,7 @@ const fs = require('fs');
 const path = require('path');
 const crypto = require('crypto');
 const { getAdapter, getAllAdapters, getAdapterNames } = require('../adapters');
-const { analyzeProject } = require('../static-analyzer');
+const { analyzeCodebase } = require('../static-analyzer');
 const { generateAll, initialize: initGenerator } = require('../ai-context-generator');
 
 /**
@@ -221,7 +221,7 @@ async function propagateContextChange(sourceTool, projectRoot, config, strategy
   // 1. Re-analyze codebase to get fresh analysis
   let analysis;
   try {
-    analysis = await analyzeProject(projectRoot, config);
+    analysis = await analyzeCodebase(projectRoot, config);
   } catch (error) {
     results.errors.push({
       message: `Failed to analyze project: ${error.message}`
@@ -328,7 +328,7 @@ async function syncAllFromCodebase(projectRoot, config) {
 
   try {
     // Analyze project
-    const analysis = await analyzeProject(projectRoot, config);
+    const analysis = await analyzeCodebase(projectRoot, config);
 
     // Generate for all tools
     const generateResults = await generateAll(analysis, config, projectRoot, {

package/lib/migrate.js

@@ -274,6 +274,11 @@ async function migrateV1ToV2(projectRoot, options = {}) {
 function getMigrationStatus(projectRoot) {
   const detection = detectV1Installation(projectRoot);
 
+  // In v2.0, both .ai-context/ AND .claude/ can exist
+  // The presence of AI_CONTEXT.md indicates v2.0 installation
+  // .claude/ in v2.0 is created by the Claude adapter for Claude-specific features
+  const hasAiContextMd = fs.existsSync(path.join(projectRoot, MIGRATIONS.entryFile.new));
+
   if (!detection.hasV1 && !detection.hasV2) {
     return {
       status: 'none',
@@ -282,24 +287,28 @@ function getMigrationStatus(projectRoot) {
     };
   }
 
-  if (detection.hasV1 && !detection.hasV2) {
+  // If AI_CONTEXT.md exists, this is v2.0 (even if .claude/ also exists)
+  if (hasAiContextMd) {
     return {
-      status: 'v1',
-      message: 'v1.x installation found, migration available',
-      needsMigration: true,
+      status: 'v2',
+      message: 'v2.0 installation found, no migration needed',
+      needsMigration: false,
       details: detection
     };
   }
 
-  if (!detection.hasV1 && detection.hasV2) {
+  // If .claude/ exists but no AI_CONTEXT.md, this is v1.x
+  if (detection.hasV1 && !detection.hasV2) {
     return {
-      status: 'v2',
-      message: 'v2.0 installation found, no migration needed',
-      needsMigration: false,
+      status: 'v1',
+      message: 'v1.x installation found, migration available',
+      needsMigration: true,
       details: detection
     };
   }
 
+  // True mixed state: both v1.x indicators and v2.0 indicators exist
+  // This shouldn't happen normally, but handle it
   if (detection.hasV1 && detection.hasV2) {
     return {
       status: 'mixed',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-universal-ai-context",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "Universal AI Context Engineering - Set up context for Claude, Copilot, Cline, Antigravity, and more",
   "main": "lib/index.js",
   "bin": {