create-universal-ai-context 2.4.0 → 2.6.0-final

package/lib/utils/fs-wrapper.js

@@ -1,79 +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
-};
+/**
+ * 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

@@ -1,60 +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
-};
+/**
+ * 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/lib/validate.js

@@ -1,155 +1,155 @@
-/**
- * AI Context Engineering - Installation Validator
- *
- * Validates the installation was successful.
- */
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * Context directory and file names
- */
-const AI_CONTEXT_DIR = '.ai-context';
-const AI_CONTEXT_FILE = 'AI_CONTEXT.md';
-
-/**
- * Required files and directories for a valid installation
- */
-const REQUIRED_STRUCTURE = {
-  directories: [
-    AI_CONTEXT_DIR,
-    `${AI_CONTEXT_DIR}/context`,
-    `${AI_CONTEXT_DIR}/research`,
-    `${AI_CONTEXT_DIR}/plans`,
-  ],
-  files: [
-    AI_CONTEXT_FILE,
-    `${AI_CONTEXT_DIR}/README.md`,
-    `${AI_CONTEXT_DIR}/settings.json`,
-    `${AI_CONTEXT_DIR}/context/WORKFLOW_INDEX.md`,
-  ],
-};
-
-/**
- * Validate the installation
- */
-async function validateInstallation(targetDir) {
-  const result = {
-    passed: true,
-    warnings: 0,
-    errors: 0,
-    checks: [],
-  };
-
-  // Check required directories
-  for (const dir of REQUIRED_STRUCTURE.directories) {
-    const fullPath = path.join(targetDir, dir);
-    const exists = fs.existsSync(fullPath);
-
-    result.checks.push({
-      type: 'directory',
-      path: dir,
-      status: exists ? 'PASS' : 'FAIL',
-    });
-
-    if (!exists) {
-      result.errors++;
-      result.passed = false;
-    }
-  }
-
-  // Check required files
-  for (const file of REQUIRED_STRUCTURE.files) {
-    const fullPath = path.join(targetDir, file);
-    const exists = fs.existsSync(fullPath);
-
-    result.checks.push({
-      type: 'file',
-      path: file,
-      status: exists ? 'PASS' : 'FAIL',
-    });
-
-    if (!exists) {
-      result.errors++;
-      result.passed = false;
-    }
-  }
-
-  // Check for remaining placeholders in key files
-  const filesToCheck = [
-    AI_CONTEXT_FILE,
-    `${AI_CONTEXT_DIR}/README.md`,
-    `${AI_CONTEXT_DIR}/settings.json`,
-  ];
-
-  for (const file of filesToCheck) {
-    const fullPath = path.join(targetDir, file);
-    if (fs.existsSync(fullPath)) {
-      const content = fs.readFileSync(fullPath, 'utf8');
-      const placeholders = content.match(/\{\{[A-Z_]+\}\}/g) || [];
-
-      if (placeholders.length > 0) {
-        result.checks.push({
-          type: 'placeholders',
-          path: file,
-          status: 'WARN',
-          details: `${placeholders.length} placeholders remaining`,
-        });
-        result.warnings++;
-      }
-    }
-  }
-
-  // Validate settings.json is valid JSON
-  const settingsPath = path.join(targetDir, AI_CONTEXT_DIR, 'settings.json');
-  if (fs.existsSync(settingsPath)) {
-    try {
-      JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
-      result.checks.push({
-        type: 'json',
-        path: `${AI_CONTEXT_DIR}/settings.json`,
-        status: 'PASS',
-      });
-    } catch (e) {
-      result.checks.push({
-        type: 'json',
-        path: `${AI_CONTEXT_DIR}/settings.json`,
-        status: 'FAIL',
-        details: 'Invalid JSON',
-      });
-      result.errors++;
-      result.passed = false;
-    }
-  }
-
-  return result;
-}
-
-/**
- * Count files in a directory
- */
-function countFiles(dir, pattern = '*') {
-  if (!fs.existsSync(dir)) return 0;
-
-  let count = 0;
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (entry.isFile()) {
-      count++;
-    } else if (entry.isDirectory()) {
-      count += countFiles(path.join(dir, entry.name), pattern);
-    }
-  }
-
-  return count;
-}
-
-module.exports = {
-  validateInstallation,
-  countFiles,
-  REQUIRED_STRUCTURE,
-  AI_CONTEXT_DIR,
-  AI_CONTEXT_FILE,
-};
+/**
+ * AI Context Engineering - Installation Validator
+ *
+ * Validates the installation was successful.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Context directory and file names
+ */
+const AI_CONTEXT_DIR = '.ai-context';
+const AI_CONTEXT_FILE = 'AI_CONTEXT.md';
+
+/**
+ * Required files and directories for a valid installation
+ */
+const REQUIRED_STRUCTURE = {
+  directories: [
+    AI_CONTEXT_DIR,
+    `${AI_CONTEXT_DIR}/context`,
+    `${AI_CONTEXT_DIR}/research`,
+    `${AI_CONTEXT_DIR}/plans`,
+  ],
+  files: [
+    AI_CONTEXT_FILE,
+    `${AI_CONTEXT_DIR}/README.md`,
+    `${AI_CONTEXT_DIR}/settings.json`,
+    `${AI_CONTEXT_DIR}/context/WORKFLOW_INDEX.md`,
+  ],
+};
+
+/**
+ * Validate the installation
+ */
+async function validateInstallation(targetDir) {
+  const result = {
+    passed: true,
+    warnings: 0,
+    errors: 0,
+    checks: [],
+  };
+
+  // Check required directories
+  for (const dir of REQUIRED_STRUCTURE.directories) {
+    const fullPath = path.join(targetDir, dir);
+    const exists = fs.existsSync(fullPath);
+
+    result.checks.push({
+      type: 'directory',
+      path: dir,
+      status: exists ? 'PASS' : 'FAIL',
+    });
+
+    if (!exists) {
+      result.errors++;
+      result.passed = false;
+    }
+  }
+
+  // Check required files
+  for (const file of REQUIRED_STRUCTURE.files) {
+    const fullPath = path.join(targetDir, file);
+    const exists = fs.existsSync(fullPath);
+
+    result.checks.push({
+      type: 'file',
+      path: file,
+      status: exists ? 'PASS' : 'FAIL',
+    });
+
+    if (!exists) {
+      result.errors++;
+      result.passed = false;
+    }
+  }
+
+  // Check for remaining placeholders in key files
+  const filesToCheck = [
+    AI_CONTEXT_FILE,
+    `${AI_CONTEXT_DIR}/README.md`,
+    `${AI_CONTEXT_DIR}/settings.json`,
+  ];
+
+  for (const file of filesToCheck) {
+    const fullPath = path.join(targetDir, file);
+    if (fs.existsSync(fullPath)) {
+      const content = fs.readFileSync(fullPath, 'utf8');
+      const placeholders = content.match(/\{\{[A-Z_]+\}\}/g) || [];
+
+      if (placeholders.length > 0) {
+        result.checks.push({
+          type: 'placeholders',
+          path: file,
+          status: 'WARN',
+          details: `${placeholders.length} placeholders remaining`,
+        });
+        result.warnings++;
+      }
+    }
+  }
+
+  // Validate settings.json is valid JSON
+  const settingsPath = path.join(targetDir, AI_CONTEXT_DIR, 'settings.json');
+  if (fs.existsSync(settingsPath)) {
+    try {
+      JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+      result.checks.push({
+        type: 'json',
+        path: `${AI_CONTEXT_DIR}/settings.json`,
+        status: 'PASS',
+      });
+    } catch (e) {
+      result.checks.push({
+        type: 'json',
+        path: `${AI_CONTEXT_DIR}/settings.json`,
+        status: 'FAIL',
+        details: 'Invalid JSON',
+      });
+      result.errors++;
+      result.passed = false;
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Count files in a directory
+ */
+function countFiles(dir, pattern = '*') {
+  if (!fs.existsSync(dir)) return 0;
+
+  let count = 0;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    if (entry.isFile()) {
+      count++;
+    } else if (entry.isDirectory()) {
+      count += countFiles(path.join(dir, entry.name), pattern);
+    }
+  }
+
+  return count;
+}
+
+module.exports = {
+  validateInstallation,
+  countFiles,
+  REQUIRED_STRUCTURE,
+  AI_CONTEXT_DIR,
+  AI_CONTEXT_FILE,
+};

package/package.json

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