create-universal-ai-context 2.2.0 → 2.2.2

package/README.md

@@ -97,6 +97,67 @@ npx create-universal-ai-context hooks:install
 - `newest` - Most recently modified wins
 - `manual` - Require manual resolution
 
+## Automation Scripts
+
+The generated `.ai-context/` directory includes automation that keeps documentation synchronized:
+
+### Generators
+
+**Code Mapper** (`.ai-context/automation/generators/code-mapper.js`)
+- Scans workflow files for file:line references
+- Builds CODE_TO_WORKFLOW_MAP.md (reverse index of code → docs)
+- Shows which workflows reference each file
+- Helps identify what needs updating after code changes
+
+**Index Builder** (`.ai-context/automation/generators/index-builder.js`)
+- Regenerates category indexes automatically
+- Updates navigation indexes with accurate counts
+- Scans workflows, agents, and commands for metadata
+
+### Git Hooks
+
+**Pre-Commit Hook**
+- Validates before allowing commits
+- Warns if code changes might affect documentation
+- Optionally blocks commits if docs are stale
+
+**Post-Commit Hook**
+- Rebuilds CODE_TO_WORKFLOW_MAP.md in background
+- Updates file hashes for change tracking
+- Keeps indexes synchronized
+
+### Install Hooks
+
+```bash
+# Copy hooks to .git/hooks/
+cp .ai-context/automation/hooks/pre-commit.sh .git/hooks/pre-commit
+cp .ai-context/automation/hooks/post-commit.sh .git/hooks/post-commit
+chmod +x .git/hooks/pre-commit .git/hooks/post-commit
+```
+
+### Run Manually
+
+```bash
+# Regenerate code-to-workflow map
+node .ai-context/automation/generators/code-mapper.js
+
+# Rebuild all indexes
+node .ai-context/automation/generators/index-builder.js
+
+# Dry-run to preview
+node .ai-context/automation/generators/code-mapper.js --dry-run
+```
+
+### Configuration
+
+Control automation via `.ai-context/automation/config.json`:
+- Enable/disable generators
+- Configure hook behavior
+- Set drift check sensitivity
+- Toggle blocking on stale documentation
+
+---
+
 ## Existing Documentation Detection
 
 The CLI automatically detects existing AI context files:

package/bin/create-ai-context.js

@@ -745,15 +745,9 @@ program
   .action(async () => {
     console.log(banner);
 
-    const installScript = path.join(__dirname, '..', '.claude', 'automation', 'hooks', 'install.js');
-
-    if (!fs.existsSync(installScript)) {
-      console.error(chalk.red('\n✖ Error: Install script not found'));
-      process.exit(1);
-    }
-
     try {
-      require(installScript);
+      const { installHooks } = require('../lib/install-hooks');
+      installHooks();
     } catch (error) {
       console.error(chalk.red('\n✖ Error:'), error.message);
       process.exit(1);

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/install-hooks.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+/**
+ * Install Git Hooks for AI Context Sync
+ *
+ * Usage: Called via `npx create-ai-context hooks:install`
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function installHooks(projectRoot = process.cwd()) {
+  const hooksDir = path.join(__dirname, '..', 'templates', 'hooks');
+  const gitHooksDir = path.join(projectRoot, '.git', 'hooks');
+
+  // Hooks to install
+  const hooks = [
+    { source: 'pre-commit.hbs', target: 'pre-commit' },
+    { source: 'post-commit.hbs', target: 'post-commit' }
+  ];
+
+  function ensureDirectory(dir) {
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+  }
+
+  function copyHook(sourceFile, targetFile) {
+    const sourcePath = path.join(hooksDir, sourceFile);
+    const targetPath = path.join(gitHooksDir, targetFile);
+
+    if (!fs.existsSync(sourcePath)) {
+      console.warn(`Warning: ${sourceFile} not found, skipping`);
+      return false;
+    }
+
+    const content = fs.readFileSync(sourcePath, 'utf-8');
+
+    fs.writeFileSync(targetPath, content, { mode: 0o755 });
+    console.log(`✓ Installed ${targetFile}`);
+    return true;
+  }
+
+  console.log('\nInstalling AI context sync git hooks...\n');
+
+  // Check if we're in a git repository
+  if (!fs.existsSync(gitHooksDir)) {
+    console.error('Error: .git/hooks directory not found');
+    console.error('Please run this command from the root of a git repository\n');
+    throw new Error('Not a git repository');
+  }
+
+  // Ensure hooks directory exists
+  ensureDirectory(gitHooksDir);
+
+  // Copy hooks
+  let installed = 0;
+  for (const hook of hooks) {
+    if (copyHook(hook.source, hook.target)) {
+      installed++;
+    }
+  }
+
+  console.log(`\nSuccessfully installed ${installed} git hooks\n`);
+  console.log('The hooks will:');
+  console.log('  • Check sync status before commits (pre-commit)');
+  console.log('  • Auto-sync after successful commits (post-commit)\n');
+  console.log('To skip sync checks, use: git commit --no-verify\n');
+
+  return { installed, total: hooks.length };
+}
+
+module.exports = { installHooks };
+
+// If run directly
+if (require.main === module) {
+  try {
+    installHooks();
+  } catch (error) {
+    console.error('\n✖ Installation failed:', error.message);
+    process.exit(1);
+  }
+}

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.0",
+  "version": "2.2.2",
   "description": "Universal AI Context Engineering - Set up context for Claude, Copilot, Cline, Antigravity, and more",
   "main": "lib/index.js",
   "bin": {

package/templates/hooks/post-commit.hbs

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Post-commit hook for AI context sync
+# This hook triggers sync after successful commits
+
+# Don't block commit if this fails
+set +e
+
+# Check if ai-context binary is available
+if ! command -v create-ai-context &> /dev/null; then
+    # Try npx
+    if command -v npx &> /dev/null; then
+        AI_CONTEXT_CMD="npx create-universal-ai-context"
+    else
+        exit 0
+    fi
+else
+    AI_CONTEXT_CMD="create-ai-context"
+fi
+
+# Run background sync (async)
+echo "Syncing AI contexts in background..."
+
+# Use subshell to run in background
+(
+    sleep 2  # Wait a bit to not interfere with commit
+    $AI_CONTEXT_CMD sync:all --quiet > /dev/null 2>&1
+) &
+
+exit 0

package/templates/hooks/pre-commit.hbs

@@ -0,0 +1,46 @@
+#!/bin/bash
+# Pre-commit hook for AI context sync
+# This hook checks if AI tool contexts are out of sync
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+GREEN='\033[0;32m'
+NC='\033[0m' # No Color
+
+# Check if ai-context binary is available
+if ! command -v create-ai-context &> /dev/null; then
+    # Try npx
+    if command -v npx &> /dev/null; then
+        AI_CONTEXT_CMD="npx create-universal-ai-context"
+    else
+        echo -e "${YELLOW}Warning: create-ai-context not found. Skipping sync check.${NC}"
+        exit 0
+    fi
+else
+    AI_CONTEXT_CMD="create-ai-context"
+fi
+
+# Run sync check
+echo -e "${GREEN}Checking AI context sync status...${NC}"
+
+# Check for out-of-sync contexts
+CHECK_OUTPUT=$($AI_CONTEXT_CMD sync:check 2>&1)
+CHECK_EXIT_CODE=$?
+
+if [ $CHECK_EXIT_CODE -ne 0 ]; then
+    echo -e "${RED}AI contexts are out of sync!${NC}"
+    echo ""
+    echo "$CHECK_OUTPUT"
+    echo ""
+    echo -e "${YELLOW}To sync all contexts, run:${NC}"
+    echo "  $AI_CONTEXT_CMD sync:all"
+    echo ""
+    echo -e "${YELLOW}To skip this check, use: git commit --no-verify${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}AI contexts are in sync${NC}"
+exit 0