create-universal-ai-context 2.3.0 → 2.5.0

package/lib/template-coordination.js

@@ -0,0 +1,148 @@
+/**
+ * Tool Coordination Module
+ * Helpers for adding tool awareness to generated content
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Get tool coordination header
+ * @param {string} toolName - Name of the tool (claude, copilot, cline, antigravity)
+ * @param {string} version - Version of create-ai-context
+ * @returns {string} Header comment for the tool
+ */
+function getToolCoordinationHeader(toolName, version) {
+  version = version || '2.3.0';
+
+  const newline = '\n';
+  const htmlHeaderBase = '<!-- ========================================= -->';
+  const htmlFooterBase = '<!-- ========================================= -->';
+  const hashHeaderBase = '# ==========================================';
+  const hashFooterBase = '# ==========================================';
+
+  const headers = {
+    claude: [
+      htmlHeaderBase,
+      '<!-- WARNING: CLAUDE CODE CONTEXT -->',
+      '<!-- Managed by create-ai-context v' + version + ' -->',
+      '<!-- Source: .ai-context/ directory -->',
+      htmlFooterBase
+    ].join(newline),
+
+    copilot: [
+      htmlHeaderBase,
+      '<!-- WARNING: GITHUB COPILOT INSTRUCTIONS -->',
+      '<!-- Managed by create-ai-context v' + version + ' -->',
+      '<!-- Source: .ai-context/ directory -->',
+      htmlFooterBase
+    ].join(newline),
+
+    cline: [
+      hashHeaderBase,
+      '# WARNING: CLINE RULES',
+      '# Managed by create-ai-context v' + version,
+      '# Source: .ai-context/ directory',
+      hashFooterBase
+    ].join(newline),
+
+    antigravity: [
+      htmlHeaderBase,
+      '<!-- WARNING: ANTIGRAVITY CONTEXT -->',
+      '<!-- Managed by create-ai-context v' + version + ' -->',
+      '<!-- Source: .ai-context/ directory -->',
+      htmlFooterBase
+    ].join(newline)
+  };
+
+  return headers[toolName] || '';
+}
+
+/**
+ * Get tool coordination footer
+ * @param {string} toolName - Name of the tool
+ * @returns {string} Footer content with cross-tool references
+ */
+function getToolCoordinationFooter(toolName) {
+  const footer = '---\n' +
+    '## Universal Context Directory\n\n' +
+    'This project uses **AI Context Engineering** for coordinated documentation across all AI tools.\n\n' +
+    '**Universal Source:** .ai-context/\n\n' +
+    '**Related Tool Contexts:**\n' +
+    '- Claude Code: `AI_CONTEXT.md`\n' +
+    '- GitHub Copilot: `.github/copilot-instructions.md`\n' +
+    '- Cline: `.clinerules`\n' +
+    '- Antigravity: `.agent/`\n\n' +
+    '**Regeneration Command:**\n' +
+    '```bash\n' +
+    'npx create-ai-context generate --ai ' + toolName + '\n```\n\n' +
+    '**To Modify Documentation:**\n' +
+    'Edit source files in .ai-context/ then regenerate.\n';
+
+  return footer;
+}
+
+/**
+ * Check if file is managed by create-ai-context
+ * @param {string} filePath - Path to file to check
+ * @returns {boolean} True if file is managed by create-ai-context
+ */
+function isManagedFile(filePath) {
+  try {
+    if (!fs.existsSync(filePath)) {
+      return false;
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return content.includes('Managed by create-ai-context') ||
+           content.includes('CREATE-AI-CONTEXT') ||
+           content.includes('Auto-generated by AI Context Engineering');
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Get universal context reference for templates
+ * @returns {object} Object with context directory info
+ */
+function getUniversalContextReference() {
+  return {
+    directory: '.ai-context',
+    description: 'Universal AI Context Engineering directory',
+    subdirectories: {
+      agents: '.ai-context/agents/',
+      commands: '.ai-context/commands/',
+      context: '.ai-context/context/',
+      indexes: '.ai-context/indexes/',
+      custom: '.ai-context/custom/',
+      tools: '.ai-context/tools/'
+    },
+    mainFile: 'AI_CONTEXT.md',
+    workflowIndex: '.ai-context/context/WORKFLOW_INDEX.md',
+    rpiPlan: '.ai-context/RPI_WORKFLOW_PLAN.md'
+  };
+}
+
+/**
+ * Format tool coordination message for CLI output
+ * @param {string} toolName - Name of the tool
+ * @returns {string} Formatted message
+ */
+function formatCoordinationMessage(toolName) {
+  const messages = {
+    claude: 'Claude Code context generated. Symlinks created from .ai-context/',
+    copilot: 'Copilot instructions generated from .ai-context/ universal context',
+    cline: 'Cline rules generated from .ai-context/ universal context',
+    antigravity: 'Antigravity context generated from .ai-context/ universal context'
+  };
+
+  return messages[toolName] || toolName + ' context generated';
+}
+
+module.exports = {
+  getToolCoordinationHeader,
+  getToolCoordinationFooter,
+  isManagedFile,
+  getUniversalContextReference,
+  formatCoordinationMessage
+};

package/lib/template-renderer.js

@@ -8,6 +8,7 @@
 const Handlebars = require('handlebars');
 const fs = require('fs');
 const path = require('path');
+const { getToolCoordinationHeader, getToolCoordinationFooter, getUniversalContextReference } = require('./template-coordination');
 
 /**
  * Templates directory
@@ -217,11 +218,13 @@ function getAvailableTemplates() {
  * Build default context from analysis results
  * @param {object} analysis - Analysis results from static analyzer
  * @param {object} config - Configuration from CLI
+ * @param {string} toolName - AI tool name (claude, copilot, cline, antigravity)
  * @returns {object} Context object for templates
  */
-function buildContext(analysis, config) {
+function buildContext(analysis, config, toolName = 'claude') {
   const projectName = config.projectName || 'project';
   const techStack = analysis.techStack || config.techStack || {};
+  const version = getPackageVersion();
 
   return {
     // Project identity
@@ -286,12 +289,19 @@ function buildContext(analysis, config) {
     // Critical constraints
     critical_constraints: [],
 
-    // Metadata
+    // Metadata with tool-specific coordination header
     metadata: {
-      header: '<!-- Auto-generated by AI Context Engineering. Do not edit manually. -->',
+      header: getToolCoordinationHeader(toolName, version),
       timestamp: new Date().toISOString(),
-      generator_version: getPackageVersion(),
-      source_ref: projectName
+      generator_version: version,
+      source_ref: projectName,
+      tool_name: toolName
+    },
+
+    // Tool coordination footer
+    coordination: {
+      footer: getToolCoordinationFooter(toolName),
+      universal_context: getUniversalContextReference()
     },
 
     // Registry (for federation compatibility)

package/lib/utils/fs-wrapper.js

@@ -0,0 +1,79 @@
+/**
+ * Filesystem Operation Wrapper
+ *
+ * Adds context to filesystem errors (WARNING level, not fatal)
+ */
+
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+
+/**
+ * Wrap sync file write with better error messages
+ * Returns warning object instead of throwing (non-fatal)
+ * @param {string} filePath - File path
+ * @param {string} content - Content to write
+ * @param {object} options - Write options
+ * @returns {object} { success: boolean, warning?: string }
+ */
+function writeFileSyncWithContext(filePath, content, options = {}) {
+  try {
+    fs.writeFileSync(filePath, content, options);
+    return { success: true };
+  } catch (error) {
+    let message;
+    if (error.code === 'EACCES' || error.code === 'EPERM') {
+      message = `Permission denied writing to ${filePath}. Check file permissions.`;
+    } else if (error.code === 'ENOENT') {
+      message = `Directory does not exist: ${path.dirname(filePath)}. Ensure parent directory exists.`;
+    } else if (error.code === 'ENOSPC') {
+      message = `No space left on device while writing ${filePath}. Free up disk space.`;
+    } else {
+      message = `Failed to write ${filePath}: ${error.message}`;
+    }
+    return { success: false, warning: message, error };
+  }
+}
+
+/**
+ * Wrap sync directory creation with better error messages
+ * Returns warning object instead of throwing (non-fatal)
+ * @param {string} dirPath - Directory path
+ * @param {object} options - mkdir options
+ * @returns {object} { success: boolean, warning?: string }
+ */
+function mkdirSyncWithContext(dirPath, options = {}) {
+  try {
+    fs.mkdirSync(dirPath, options);
+    return { success: true };
+  } catch (error) {
+    // EEXIST is not an error - directory already exists
+    if (error.code === 'EEXIST') {
+      return { success: true };
+    }
+    let message;
+    if (error.code === 'EACCES' || error.code === 'EPERM') {
+      message = `Permission denied creating directory ${dirPath}. Check directory permissions.`;
+    } else {
+      message = `Failed to create directory ${dirPath}: ${error.message}`;
+    }
+    return { success: false, warning: message, error };
+  }
+}
+
+/**
+ * Log a warning message if verbose mode is enabled
+ * @param {object} result - Result from writeFileSyncWithContext or mkdirSyncWithContext
+ * @param {boolean} verbose - Whether to log warnings
+ */
+function logWarning(result, verbose = false) {
+  if (!result.success && result.warning && verbose) {
+    console.warn(chalk.yellow(`⚠ ${result.warning}`));
+  }
+}
+
+module.exports = {
+  writeFileSyncWithContext,
+  mkdirSyncWithContext,
+  logWarning
+};

package/lib/utils/path-utils.js

@@ -0,0 +1,60 @@
+/**
+ * Path Utilities
+ *
+ * Cross-platform path handling utilities
+ */
+
+const path = require('path');
+
+/**
+ * Normalize path separators to forward slashes for consistency
+ * @param {string} filePath - Path to normalize
+ * @returns {string} Normalized path
+ */
+function normalizePath(filePath) {
+  if (!filePath) return '';
+  return filePath.replace(/\\/g, '/');
+}
+
+/**
+ * Get relative path with normalized separators
+ * @param {string} from - Source path
+ * @param {string} to - Destination path
+ * @returns {string} Normalized relative path
+ */
+function relativePath(from, to) {
+  const rel = path.relative(from, to);
+  return normalizePath(rel);
+}
+
+/**
+ * Join path segments and normalize
+ * @param {...string} segments - Path segments
+ * @returns {string} Normalized joined path
+ */
+function joinPath(...segments) {
+  return normalizePath(path.join(...segments));
+}
+
+/**
+ * Check if path is absolute (cross-platform)
+ * @param {string} filePath - Path to check
+ * @returns {boolean}
+ */
+function isAbsolute(filePath) {
+  if (!filePath) return false;
+
+  // Windows paths can start with drive letter (C:\) or UNC (\\)
+  if (/^[a-zA-Z]:\\/.test(filePath) || /^\\\\/.test(filePath)) {
+    return true;
+  }
+
+  return path.isAbsolute(filePath);
+}
+
+module.exports = {
+  normalizePath,
+  relativePath,
+  joinPath,
+  isAbsolute
+};

package/package.json

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

package/templates/handlebars/aider-config.hbs

@@ -0,0 +1,80 @@
+{{!-- Aider Configuration Template --}}
+# {{project.name}} - Aider Configuration
+# Generated: {{metadata.timestamp}}
+
+# Model selection (uncomment and configure as needed)
+# model: gpt-4
+# model: claude-3-opus-20240229
+# model: deepseek-coder
+
+# Auto-commit settings
+auto-commits: true
+auto-commit: false
+commit_prompt: "docs: update {path} per AI pair-programming session"
+
+# File handling
+{{#if key_files.entry_points}}
+# Add only these files to context
+add: {{join key_files.entry_points ","}}
+{{/if}}
+
+# Exclude patterns
+exclude:
+  - node_modules/
+  - build/
+  - dist/
+  - .git/
+  - coverage/
+  - "*.min.js"
+  - "*.min.css"
+
+# Git settings
+gitignore: true
+git-detect: true
+
+# Editor settings
+editor: vscode
+# editor-model: gpt-4
+
+# Language detection
+{{#if project.primary_language}}
+language: {{project.primary_language}}
+{{/if}}
+
+# Testing
+test-cmd: {{commands.test}}
+
+# Linting (configure as needed)
+# lint-cmd: npm run lint
+# lint-cmd: python -m flake8 .
+
+# Security
+# unsafe-install: false  # Set to true to allow pip installs without confirmation
+
+# Shell commands
+# shell-commands: true  # Allow aider to run shell commands
+
+# Voice input (experimental)
+# voice-input: false
+
+# Chat history
+# chat-history: .aider.chat.history
+# chat-history-file: .aider.chat.history
+
+# Display settings
+# color: true
+# progress-spinner: true
+
+# Map tokens (for context optimization)
+# map-tokens: 2048
+
+# Message formatting
+# stream: true
+# dark-mode: false
+
+# Advanced settings
+# attribute-author: true
+# attribute-committer: true
+
+---
+{{{coordination.footer}}}

package/templates/handlebars/antigravity.hbs

@@ -60,6 +60,10 @@
 {{/each}}
 {{/if}}
 {{/if}}
+
+---
+
+{{{coordination.footer}}}
 {{{fileEnd}}}
 
 {{!-- ============================================================ --}}
@@ -102,6 +106,10 @@
 - `{{this}}`
 {{/each}}
 {{/if}}
+
+---
+
+{{{coordination.footer}}}
 {{{fileEnd}}}
 
 {{!-- ============================================================ --}}
@@ -133,6 +141,10 @@ These are known issues and pitfalls. Review before making changes.
 {{else}}
 *No gotchas documented yet. Add as discovered.*
 {{/if}}
+
+---
+
+{{{coordination.footer}}}
 {{{fileEnd}}}
 
 {{!-- ============================================================ --}}
@@ -158,6 +170,10 @@ These rules MUST be followed. Violations may cause production issues.
 - Total Constraints: {{length critical_constraints}}
 - Gotchas: {{length gotchas}}
 - Workflows: {{length workflows}}
+
+---
+
+{{{coordination.footer}}}
 {{{fileEnd}}}
 
 {{!-- ============================================================ --}}
@@ -189,6 +205,10 @@ These rules MUST be followed. Violations may cause production issues.
 {{else}}
 *No workflows discovered. Run AI analysis to populate.*
 {{/if}}
+
+---
+
+{{{coordination.footer}}}
 {{{fileEnd}}}
 
 {{!-- ============================================================ --}}
@@ -214,6 +234,10 @@ Starts the {{project.name}} development server.
 
 ## Related
 - See `rules/identity.md` for full command list
+
+---
+
+{{{coordination.footer}}}
 {{{fileEnd}}}
 
 {{{fileStart "workflows/test.md"}}}
@@ -232,6 +256,10 @@ Runs the test suite for {{project.name}}.
 ## Tips
 - Run before committing changes
 - Check test coverage reports
+
+---
+
+{{{coordination.footer}}}
 {{{fileEnd}}}
 
 {{{fileStart "workflows/build.md"}}}
@@ -246,6 +274,10 @@ Runs the test suite for {{project.name}}.
 
 ## Description
 Builds {{project.name}} for production.
+
+---
+
+{{{coordination.footer}}}
 {{{fileEnd}}}
 
 {{!-- ============================================================ --}}
@@ -293,6 +325,10 @@ Activate this skill when debugging issues in {{project.name}}.
 - Check application logs for errors
 - Review stack traces carefully
 - Verify environment configuration
+
+---
+
+{{{coordination.footer}}}
 {{{fileEnd}}}
 
 {{{fileStart "skills/implementation.md"}}}
@@ -334,4 +370,8 @@ Activate this skill when implementing new features in {{project.name}}.
 - {{this}}
 {{/each}}
 {{/if}}
+
+---
+
+{{{coordination.footer}}}
 {{{fileEnd}}}

package/templates/handlebars/claude.hbs

@@ -180,5 +180,4 @@ This context is optimized for:
 
 ---
 
-*Auto-generated by AI Context Engineering v{{metadata.generator_version}}*
-*Regenerate with: `npx create-ai-context generate`*
+{{{coordination.footer}}}

package/templates/handlebars/cline.hbs

@@ -59,5 +59,4 @@ layer.{{@index}}={{name}}={{path}}
 {{/each}}
 {{/if}}
 
-# Auto-generated by AI Context Engineering v{{metadata.generator_version}}
-# Regenerate: npx create-ai-context generate --ai cline
+{{{coordination.footer}}}

package/templates/handlebars/continue-config.hbs

@@ -0,0 +1,116 @@
+{{!-- Continue Configuration Template --}}
+{
+  "$schema": "https://continue.dev/schema.json",
+  "projectTitle": "{{project.name}}",
+  "description": "{{project.description}}",
+  "techstack": "{{join project.tech_stack ", "}}",
+
+  "context": {
+    "providers": [
+      {
+        "name": "codebase",
+        "description": "Project codebase context"
+      }
+    ],
+    "rules": [
+      {
+        "description": "Project Communication Style",
+        "type": "markdown",
+        "content": "<communication>\n- Speak to me in a professional, technical manner\n- Provide clear explanations for code changes\n- Reference specific files and line numbers when discussing changes\n- Ask clarifying questions when requirements are ambiguous\n</communication>"
+      },
+      {
+        "description": "Filesystem Rules",
+        "type": "markdown",
+        "content": "<filesystem>\n{{#if key_files.entry_points}}- Key project files: {{join key_files.entry_points ", "}}\n{{/if}}- Models directory: {{#each architecture.layers}}{{#if (ifEquals name 'models')}}{{path}}{{/if}}{{/each}}\n- Migrations directory: {{#each architecture.layers}}{{#if (ifEquals name 'migrations')}}{{path}}{{/if}}{{/each}}\n- Treat node_modules, build, dist as read-only\n</filesystem>"
+      },
+      {
+        "description": "Coding Guidelines",
+        "type": "markdown",
+        "content": "<coding>\n- Primary language: {{project.primary_language}}\n- Framework: {{#each architecture.layers}}{{#if (ifEquals name 'framework')}}{{name}}{{/if}}{{/each}}\n- Testing framework: jest\n- Follow existing code style and patterns\n- Add type hints/annotations for all functions\n- Write tests for new functionality (target: 80% coverage)\n- Use early returns when possible\n- Avoid deep nesting (>4 levels)\n- Keep functions focused and small (<50 lines)\n</coding>"
+      },
+      {
+        "description": "Commands",
+        "type": "table",
+        "content": "| Command | Purpose |\n|---------|---------|\n| {{commands.install}} | Install dependencies |\n| {{commands.dev}} | Start development server |\n| {{commands.test}} | Run tests |\n| {{commands.build}} | Build for production |"
+      },
+      {
+        "description": "Architecture",
+        "type": "markdown",
+        "content": "<architecture>\n{{project.description}}\n\nKey patterns:\n- {{architecture.pattern}}\n{{#each architecture.layers}}\n- {{name}}: {{purpose}}\n{{/each}}\n</architecture>"
+      }
+    ]
+  },
+
+  "slashCommands": [
+    {
+      "name": "test",
+      "description": "Run tests",
+      "run": "{{commands.test}}"
+    },
+    {
+      "name": "build",
+      "description": "Build project",
+      "run": "{{commands.build}}"
+    },
+    {
+      "name": "dev",
+      "description": "Start development server",
+      "run": "{{commands.dev}}"
+    }
+  ],
+
+  "models": [
+    {
+      "title": "GPT-4",
+      "provider": "openai",
+      "model": "gpt-4"
+    },
+    {
+      "title": "Claude 3 Opus",
+      "provider": "anthropic",
+      "model": "claude-3-opus-20240229"
+    }
+  ],
+
+  "tabAutocompleteModel": {
+    "title": "DeepSeek V2",
+    "provider": "deepseek",
+    "model": "deepseek-coder"
+  },
+
+  "customCommands": [
+    {
+      "name": "explain",
+      "prompt": "Explain the selected code in detail, including its purpose and how it works."
+    },
+    {
+      "name": "refactor",
+      "prompt": "Refactor the selected code to improve readability and maintainability."
+    },
+    {
+      "name": "docs",
+      "prompt": "Generate JSDoc/TypeDoc documentation for the selected code."
+    }
+  ],
+
+  "allowYaml": true,
+
+  "maxContextTokens": 8000,
+
+  "temperature": 0.2,
+
+  "regexDenylist": [
+    ".*\\.min\\.js",
+    ".*\\.min\\.css",
+    "node_modules/.*",
+    "build/.*",
+    "dist/.*"
+  ],
+
+  "_comment": "Generated by create-universal-ai-context v{{metadata.generator_version}}",
+  "_generatedAt": "{{metadata.timestamp}}",
+  "_toolCoordination": {
+    "universalContext": ".ai-context/",
+    "regenerateCommand": "npx create-ai-context generate --ai continue"
+  }
+}

package/templates/handlebars/copilot.hbs

@@ -127,5 +127,4 @@
 
 ---
 
-*Auto-generated by AI Context Engineering v{{metadata.generator_version}}*
-*Regenerate with: `npx create-ai-context generate --ai copilot`*
+{{{coordination.footer}}}

package/templates/handlebars/partials/header.hbs

@@ -1,3 +1,3 @@
-{{!-- Reusable header partial --}}
+{{!-- Reusable header partial with tool coordination --}}
 {{{metadata.header}}}
 <!-- Generated: {{metadata.timestamp}} | Version: {{metadata.generator_version}} -->