@brainwav/diagram 1.0.8 → 1.1.0

package/src/diagram.js

@@ -1,1809 +1,226 @@
 #!/usr/bin/env node
 
 const { Command } = require('commander');
-const fs = require('fs');
-const path = require('path');
-const { glob } = require('glob');
 const chalk = require('chalk');
-const { spawn, execFileSync } = require('child_process');
-const os = require('os');
-const crypto = require('crypto');
-const zlib = require('zlib');
-const { getOpenCommand, getNpxCommandCandidates } = require('./utils/commands');
-
-// Read version from package.json
+const path = require('path');
 const packageJson = require('../package.json');
-
-// Video generation (lazy loaded)
-let videoModule;
-function getVideoModule() {
-  if (!videoModule) {
-    try {
-      videoModule = require('./video.js');
-    } catch (e) {
-      console.error(chalk.red('❌ Video generation requires Playwright. Install with: npm install playwright'));
-      process.exit(1);
-    }
-  }
-  return videoModule;
-}
+const { loadDiagramRc } = require('./config/diagramrc');
+const { registerAnalyzeCommand } = require('./commands/analyze');
+const { registerGenerateCommand } = require('./commands/generate');
+const { registerGenerateAllCommand } = require('./commands/generate-all');
+const { registerScanCommand } = require('./commands/scan');
+const { registerValidateCommand } = require('./commands/validate');
+const { registerDiffCommand } = require('./commands/diff');
+const { registerGenerateVideoCommand } = require('./commands/generate-video');
+const { registerGenerateAnimatedCommand } = require('./commands/generate-animated');
+const { registerDoctorCommand } = require('./commands/doctor');
+const { registerChangedCommand } = require('./commands/changed');
+const { registerContextCommand } = require('./commands/context');
+const { registerExplainCommand } = require('./commands/explain');
+const { registerInitCommand } = require('./commands/init');
+const { registerWorkflowPrCommand } = require('./commands/workflow-pr');
+const {
+  escapeHtml,
+  groupChangePaths,
+  buildRiskNarrative,
+  buildSummaryMeta,
+  generateHtmlExplainer,
+} = require('./workflow/pr-impact');
+
+const CANONICAL_COMMAND_NAME = 'archscope';
+const COMPATIBILITY_COMMAND_NAME = 'diagram';
+const COMPATIBILITY_NOTICE =
+  `Compatibility notice: '${COMPATIBILITY_COMMAND_NAME}' remains supported during migration. Use '${CANONICAL_COMMAND_NAME}' for canonical usage.`;
 
 const program = new Command();
 
-// Utility functions
-function detectLanguage(filePath) {
-  if (typeof filePath !== 'string') return 'unknown';
-  const ext = path.extname(filePath).toLowerCase();
-  const map = {
-    '.ts': 'typescript', '.tsx': 'typescript',
-    '.mts': 'typescript', '.cts': 'typescript',
-    '.js': 'javascript', '.jsx': 'javascript',
-    '.mjs': 'javascript', '.cjs': 'javascript',
-    '.py': 'python', '.go': 'go', '.rs': 'rust',
-    '.java': 'java', '.rb': 'ruby', '.php': 'php',
-  };
-  return map[ext] || 'unknown';
-}
-
-function inferType(filePath, content) {
-  const base = path.basename(filePath).toLowerCase();
-  if (base.includes('service')) return 'service';
-  if (base.includes('component') || base.endsWith('.tsx') || base.endsWith('.jsx')) return 'component';
-  if (content.includes('class ') && content.includes('extends')) return 'class';
-  if (content.includes('export default function') || content.includes('export function')) return 'function';
-  if (content.includes('module.exports') || content.includes('export ')) return 'module';
-  return 'file';
-}
-
-function extractImports(content, lang) {
-  const imports = [];
-  if (lang === 'typescript' || lang === 'javascript') {
-    // ES6 imports with timeout protection against ReDoS
-    const es6Regex = /import\s+(?:(?:\{[^}]*?\}|\*\s+as\s+\w+|\w+)\s+from\s+)?["']([^"']+)["']/g;
-    const es6 = [...content.matchAll(es6Regex)];
-    es6.forEach(m => imports.push(m[1]));
-    // CommonJS requires
-    const cjs = [...content.matchAll(/require\s*\(\s*["']([^"']+)["']\s*\)/g)];
-    cjs.forEach(m => imports.push(m[1]));
-    // Dynamic imports
-    const dynamic = [...content.matchAll(/import\s*\(\s*["']([^"']+)["']\s*\)/g)];
-    dynamic.forEach(m => imports.push(m[1]));
-  } else if (lang === 'python') {
-    const py = [...content.matchAll(/(?:from|import)\s+([\w.]+)/g)];
-    py.forEach(m => imports.push(m[1]));
-  } else if (lang === 'go') {
-    const go = [...content.matchAll(/import\s+(?:\(\s*)?["']([^"']+)["']/g)];
-    go.forEach(m => imports.push(m[1]));
-  }
-  return imports;
-}
-
-/**
- * Extract imports with line number information
- * @param {string} content - File content
- * @param {string} lang - Language
- * @returns {Array<{path: string, line: number}>}
- */
-function extractImportsWithPositions(content, lang) {
-  const imports = [];
-  const lines = content.split(/\r?\n/);
-  
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    const lineNum = i + 1;
-    
-    if (lang === 'typescript' || lang === 'javascript') {
-      // ES6 imports
-      const es6 = line.match(/import\s+(?:(?:\{[^}]*\}|\*\s+as\s+\w+|\w+)\s+from\s+)?["']([^"']+)["']/);
-      if (es6) {
-        imports.push({ path: es6[1], line: lineNum });
-        continue;
-      }
-      
-      // CommonJS requires
-      const cjs = line.match(/require\s*\(\s*["']([^"']+)["']\s*\)/);
-      if (cjs) {
-        imports.push({ path: cjs[1], line: lineNum });
-        continue;
-      }
-      
-      // Dynamic imports
-      const dynamic = line.match(/import\s*\(\s*["']([^"']+)["']\s*\)/);
-      if (dynamic) {
-        imports.push({ path: dynamic[1], line: lineNum });
-      }
-    } else if (lang === 'python') {
-      const py = line.match(/(?:from|import)\s+([\w.]+)/);
-      if (py) {
-        imports.push({ path: py[1], line: lineNum });
-      }
-    } else if (lang === 'go') {
-      const go = line.match(/import\s+(?:\(\s*)?["']([^"']+)["']/);
-      if (go) {
-        imports.push({ path: go[1], line: lineNum });
-      }
-    }
-  }
-  
-  return imports;
-}
-
-function sanitize(name) {
-  // Ensure unique, valid mermaid ID
-  const base = name.replace(/[^a-zA-Z0-9_]/g, '_').replace(/^[0-9]/, '_$&');
-  // Add hash suffix to prevent collisions (using SHA-256)
-  const hash = crypto.createHash('sha256').update(name).digest('hex').slice(0, 8);
-  return `${base}_${hash}`;
-}
-
-function escapeMermaid(str) {
-  if (!str) return '';
-  return str
-    .replace(/"/g, '\\"')
-    .replace(/\[/g, '\\[')
-    .replace(/\]/g, '\\]')
-    .replace(/\(/g, '\\(')
-    .replace(/\)/g, '\\)')
-    .replace(/#/g, '\\#')
-    .replace(/</g, '\\<')
-    .replace(/>/g, '\\>')
-    .replace(/\{/g, '\\{')
-    .replace(/\}/g, '\\}')
-    .replace(/\|/g, '\\|');
-}
-
-function normalizePath(inputPath) {
-  // Always use forward slashes for consistency
-  return inputPath.replace(/\\/g, '/');
-}
-
-const IMPORT_RESOLUTION_SUFFIXES = [
-  '',
-  '.ts',
-  '.tsx',
-  '.js',
-  '.jsx',
-  '.mjs',
-  '.mts',
-  '.cts',
-  '/index.ts',
-  '/index.tsx',
-  '/index.js',
-  '/index.jsx',
-  '/index.mjs',
-  '/index.mts',
-  '/index.cts'
-];
-
-function toComparablePath(p) {
-  return normalizePath(String(p || '')).replace(/^\.\//, '');
-}
-
-function getImportPath(importInfo) {
-  if (typeof importInfo === 'string') return importInfo;
-  if (importInfo && typeof importInfo.path === 'string') return importInfo.path;
-  return null;
-}
-
-function resolveInternalImport(fromFilePath, importPath, rootPath) {
-  if (typeof fromFilePath !== 'string' || typeof importPath !== 'string') {
-    return null;
-  }
-  if (!importPath.startsWith('.')) {
-    return null;
-  }
-
-  const fromDir = path.dirname(fromFilePath);
+program
+  .name(CANONICAL_COMMAND_NAME)
+  .description('Generate architecture evidence for humans and AI agents')
+  .version(packageJson.version);
 
-  // In analysis mode we can enforce root boundaries with absolute paths
-  if (rootPath) {
-    const absoluteTarget = path.resolve(rootPath, fromDir, importPath);
-    const relativeToRoot = toComparablePath(path.relative(rootPath, absoluteTarget));
-    if (relativeToRoot.startsWith('..') || path.isAbsolute(relativeToRoot)) {
-      return null;
+registerAnalyzeCommand(program);
+registerGenerateCommand(program);
+registerGenerateAllCommand(program);
+registerScanCommand(program);
+registerValidateCommand(program);
+registerDiffCommand(program);
+registerGenerateVideoCommand(program);
+registerGenerateAnimatedCommand(program);
+registerDoctorCommand(program);
+registerChangedCommand(program);
+registerContextCommand(program);
+registerExplainCommand(program);
+registerInitCommand(program);
+registerWorkflowPrCommand(program);
+
+program.on('command:*', function (operands) {
+  console.error(chalk.red(`\n🤖 AI Agent Error: Unknown command '${operands[0]}'\n`));
+  console.error(chalk.white('Use the canonical command set:\n'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} init [path]`) + chalk.gray('            - Scaffold .architecture.yml, .diagramrc, and CI sample step'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} doctor [path]`) + chalk.gray('          - Check local tooling and environment health'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} analyze [path]`) + chalk.gray('         - Analyze codebase structure'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} scan [path]`) + chalk.gray('            - Initialize architecture evidence pack manifest'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} generate [path]`) + chalk.gray('        - Generate one diagram type'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} generate-all [path]`) + chalk.gray('    - Generate all diagram types'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} changed [path]`) + chalk.gray('         - Analyze only git-changed files'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} context [path]`) + chalk.gray('         - Refresh AI context pack artifacts'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} explain <component> [path]`) + chalk.gray(' - Explain a local dependency neighborhood'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} validate [path]`) + chalk.gray('        - Validate architecture against .architecture.yml'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} workflow pr [path]`) + chalk.gray('     - Compute PR blast-radius and risk score'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} diff <base> <head>`) + chalk.gray('     - Compare architecture snapshots'));
+  console.error(chalk.gray('\nOptional advanced media commands:'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} generate-video [path]`) + chalk.gray('  - Generate animated video output'));
+  console.error(chalk.cyan(`  ${CANONICAL_COMMAND_NAME} generate-animated [path]`) + chalk.gray(' - Generate animated SVG output\n'));
+  console.error(chalk.white(`Use ${chalk.cyan(`${CANONICAL_COMMAND_NAME} --help`)} for full option details.`));
+  console.error(chalk.white(`Use ${chalk.cyan('--format json')} instead of ${chalk.cyan('--json')} for machine output.`));
+  process.exit(1);
+});
+
+function getInvocationName(argv, env = process.env) {
+  const candidates = [
+    argv[1],
+    env._,
+    env.npm_lifecycle_script,
+    argv[0],
+  ];
+  for (const candidate of candidates) {
+    const name = path.basename(String(candidate || '').trim());
+    if (name && name !== 'node' && name !== 'diagram.js') {
+      return name;
     }
-    return relativeToRoot;
   }
-
-  // Fallback for precomputed data without root path
-  const posixFromDir = normalizePath(fromDir);
-  const posixImport = normalizePath(importPath);
-  return toComparablePath(path.posix.normalize(path.posix.join(posixFromDir, posixImport)));
+  return path.basename(argv[1] || '');
 }
 
-function findComponentByResolvedPath(components, resolvedPath) {
-  const comparablePath = toComparablePath(resolvedPath);
-  const candidates = new Set(
-    IMPORT_RESOLUTION_SUFFIXES.map(suffix => toComparablePath(comparablePath + suffix))
-  );
-  return components.find(c => candidates.has(toComparablePath(c.filePath)));
+function isCompatibilityInvocation(argv, env = process.env) {
+  return getInvocationName(argv, env) === COMPATIBILITY_COMMAND_NAME;
 }
 
-function getExternalPackageName(importPath) {
-  if (typeof importPath !== 'string') return null;
-  if (!importPath) return null;
-  if (importPath.startsWith('@')) {
-    const [scope, pkg] = importPath.split('/');
-    return scope && pkg ? `${scope}/${pkg}` : scope || null;
+function emitCompatibilityInvocationNotice(argv, env = process.env) {
+  if (isCompatibilityInvocation(argv, env)) {
+    console.error(chalk.yellow(COMPATIBILITY_NOTICE));
   }
-  return importPath.split('/')[0] || null;
 }
 
-const ROLE_PATTERNS = {
-  user: [
-    'route', 'routes', 'controller', 'controllers', 'handler', 'handlers',
-    'api', 'middleware', 'page', 'pages', 'ui', 'frontend', 'web', 'client', 'request'
-  ],
-  auth: [
-    'auth', 'authentication', 'authorization', 'session', 'signin', 'login',
-    'signup', 'token', 'jwt', 'oauth', 'sso', 'passport', 'identity', 'acl',
-    'guard', 'permission', 'password', 'mfa', 'security'
-  ],
-  database: [
-    'db', 'database', 'data', 'datastore', 'repository', 'repo', 'model',
-    'schema', 'migration', 'query', 'querybuilder', 'prisma', 'typeorm',
-    'sequelize', 'mongoose', 'knex', 'drizzle', 'redis', 'postgres', 'mysql',
-    'sqlite', 'mongo', 'dynamodb', 'd1'
-  ],
-  events: [
-    'event', 'events', 'queue', 'worker', 'cron', 'scheduler', 'webhook',
-    'pubsub', 'bus', 'publish', 'subscriber', 'consumer', 'producer',
-    'listener', 'trigger'
-  ],
-  integrations: [
-    'integration', 'webhook', 'gateway', 'stripe', 'pay', 'sendgrid', 'twilio',
-    'sentry', 'github', 'slack', 'analytics', 'mail', 'smtp', 'storage'
-  ],
-  security: [
-    'security', 'threat', 'attack', 'rate', 'encrypt', 'decrypt', 'signature',
-    'hash', 'verify', 'csrf', 'xss', 'audit', 'compliance', 'policy', 'vault',
-    'kms', 'secret', 'key'
-  ],
-};
-
-const SUPPORTED_DIAGRAM_TYPES = Object.freeze([
-  'architecture',
-  'sequence',
-  'dependency',
-  'class',
-  'flow',
-  'database',
-  'user',
-  'events',
-  'auth',
-  'security',
-]);
-
-function textHasToken(text, token) {
-  const escaped = token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-  const re = new RegExp(`(^|[\\/._-])${escaped}([\\/._-]|$)`, 'i');
-  return re.test(text);
-}
-
-function collectExternalImports(importEntries) {
-  const packages = new Set();
-  if (!Array.isArray(importEntries)) return [];
-
-  for (const entry of importEntries) {
-    const importPath = getImportPath(entry);
-    if (!importPath || importPath.startsWith('.')) {
-      continue;
+/**
+ * Determine which top-level subcommand name is active from a CLI argument list.
+ *
+ * Scans the provided `argv` (typically `process.argv`) and returns the first token
+ * that represents a top-level command — i.e. the first non-flag token that is not
+ * the value for an option that expects a value. Returns `null` if no such token is found.
+ *
+ * @param {string[]} argv - The complete argument vector (e.g. `process.argv`).
+ * @returns {string|null} The active top-level subcommand name, or `null` if none is present.
+ */
+function findActiveCommand(argv) {
+  const flagsWithValue = new Set();
+  const stack = [program];
+  while (stack.length > 0) {
+    const command = stack.pop();
+    for (const option of command.options || []) {
+      const expectsValue = Boolean(option.required || option.optional || option.variadic);
+      if (!expectsValue) continue;
+      if (option.short) flagsWithValue.add(option.short);
+      if (option.long) flagsWithValue.add(option.long);
     }
-    const externalPackage = getExternalPackageName(importPath);
-    if (externalPackage) {
-      packages.add(externalPackage);
+    for (const subcommand of command.commands || []) {
+      stack.push(subcommand);
     }
   }
 
-  return [...packages];
-}
-
-function inferRoleTags(filePath, originalName, fileContent, importEntries, type) {
-  const content = (fileContent || '').toLowerCase();
-  const pathText = normalizePath(filePath || '').toLowerCase();
-  const nameText = (originalName || '').toLowerCase();
-  const externalImports = collectExternalImports(importEntries).join(' ').toLowerCase();
-  const combined = `${pathText} ${nameText} ${content} ${externalImports}`;
-
-  const tags = new Set();
-
-  for (const [tag, tokens] of Object.entries(ROLE_PATTERNS)) {
-    for (const token of tokens) {
-      if (textHasToken(combined, token)) {
-        tags.add(tag);
-        break;
-      }
+  for (let i = 2; i < argv.length; i += 1) {
+    const current = argv[i];
+    if (current.startsWith('-')) continue;
+    const prev = argv[i - 1];
+    if (!flagsWithValue.has(prev)) {
+      return current;
     }
   }
-
-  if (type === 'service') {
-    tags.add('service');
-  }
-
-  if (tags.size === 0) {
-    tags.add('general');
-  }
-
-  return [...tags];
-}
-
-function hasRole(component, role) {
-  return (Array.isArray(component.roleTags) && component.roleTags.includes(role));
-}
-
-function componentsByRole(components, role) {
-  if (!Array.isArray(components)) return [];
-  return components.filter((component) => hasRole(component, role));
+  return null;
 }
 
-function getExternalPackageList(importEntries) {
-  const packages = collectExternalImports(importEntries);
-  if (!packages.length) return [];
-  return packages.map((pkg) => ({
-    name: pkg,
-    label: pkg,
-  }));
-}
+/**
+ * Rewrite deprecated flags and command aliases in a CLI argument vector to their current canonical forms.
+ *
+ * Logs short deprecation notes to stderr for any rewritten tokens and returns a new argv array with replacements applied.
+ *
+ * @param {string[]} argv - The original process-style argument array (e.g. process.argv).
+ * @returns {string[]} The rewritten argument array with deprecated flags and command aliases replaced.
+ */
+function resolveAliasArgs(argv) {
+  const resolvedArgs = [];
+  let commandFound = false;
+  const activeCommand = findActiveCommand(argv);
 
-function mapSafeNames(components) {
-  const map = new Map();
-  const used = new Set();
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
 
-  for (const component of components) {
-    const rawName = sanitize(component.name || component.originalName || 'node');
-    if (!used.has(rawName)) {
-      map.set(component, rawName);
-      used.add(rawName);
+    if (arg === '--json' || arg === '-j') {
+      console.error(chalk.yellow(`🤖 Note for AI Agent: '${arg}' is deprecated. Using '--format json' automatically.`));
+      resolvedArgs.push('--format', 'json');
       continue;
     }
 
-    let i = 1;
-    let candidate = `${rawName}_${i}`;
-    while (used.has(candidate)) {
-      i += 1;
-      candidate = `${rawName}_${i}`;
-    }
-    map.set(component, candidate);
-    used.add(candidate);
-  }
-
-  return map;
-}
-
-function byNameIndex(components) {
-  const map = new Map();
-  if (!Array.isArray(components)) return map;
-  for (const component of components) {
-    if (component && component.name) {
-      map.set(component.name, component);
-    }
-  }
-  return map;
-}
-
-function resolveDependencyComponent(component, componentsByName, name) {
-  if (!component || !name || !componentsByName) return null;
-  return componentsByName.get(name) || null;
-}
-
-function collectConnectedComponents(components, seedComponents, maxDepth = 2, maxNodes = 35) {
-  if (!Array.isArray(components)) return [];
-  if (!Array.isArray(seedComponents) || seedComponents.length === 0) return [];
-
-  const byName = byNameIndex(components);
-  const selected = new Map();
-  const queue = [];
-
-  for (const seed of seedComponents) {
-    if (seed && seed.name && !selected.has(seed.name)) {
-      selected.set(seed.name, seed);
-      queue.push(seed);
-    }
-  }
-
-  let depth = 0;
-  const visited = new Set();
-  while (queue.length > 0 && depth < maxDepth) {
-    const levelSize = queue.length;
-    for (let i = 0; i < levelSize; i++) {
-      const current = queue.shift();
-      if (!current || typeof current.name !== 'string') continue;
-      const depthKey = `${current.name}:${depth}`;
-      if (visited.has(depthKey)) continue;
-      visited.add(depthKey);
-
-      const next = [];
-      for (const depName of current.dependencies || []) {
-        const dependency = byName.get(depName);
-        if (dependency && !selected.has(depName)) {
-          selected.set(depName, dependency);
-          next.push(dependency);
-        }
-      }
-
-      for (const candidate of components) {
-        if (selected.has(candidate.name)) continue;
-        const reverseDependencies = Array.isArray(candidate.dependencies) ? candidate.dependencies : [];
-        if (reverseDependencies.includes(current.name)) {
-          selected.set(candidate.name, candidate);
-          next.push(candidate);
-        }
-      }
-
-      for (const n of next) {
-        if (selected.size >= maxNodes) break;
-        queue.push(n);
-      }
-      if (selected.size >= maxNodes) break;
-    }
-    depth += 1;
-  }
-
-  return [...selected.values()];
-}
-
-function inferDbIntent(component) {
-  const source = `${component.filePath || ''} ${component.originalName || ''} ${component.name || ''}`.toLowerCase();
-  const hasLookup = /(read|find|query|select|get|lookup|exists|fetch)/.test(source);
-  const hasWrite = /(create|insert|update|upsert|save|delete|remove|write|transaction)/.test(source);
-  return { hasLookup, hasWrite };
-}
-
-function classifyAsGeneral(component) {
-  if (!component || !Array.isArray(component.roleTags)) return false;
-  return component.roleTags.includes('general') && component.roleTags.length === 1;
-}
-
-// Analysis
-async function analyze(rootPath, options) {
-  // Validate maxFiles with strict parsing
-  let maxFiles = parseInt(options.maxFiles, 10);
-  if (isNaN(maxFiles) || maxFiles < 1 || maxFiles > 10000) {
-    maxFiles = 100;
-  }
-  // Extra safety: ensure within safe bounds
-  maxFiles = Math.min(Math.max(maxFiles, 1), 10000);
-  
-  // Validate patterns type
-  let patterns = ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx', '**/*.py', '**/*.go', '**/*.rs'];
-  if (options.patterns) {
-    if (typeof options.patterns !== 'string') {
-      throw new TypeError('patterns must be a string');
-    }
-    patterns = options.patterns.split(',');
-  }
-  
-  let exclude = ['node_modules/**', '.git/**', 'dist/**', 'build/**', '*.test.*', '*.spec.*'];
-  if (options.exclude) {
-    if (typeof options.exclude !== 'string') {
-      throw new TypeError('exclude must be a string');
-    }
-    exclude = options.exclude.split(',');
-  }
-
-  const files = [];
-  for (const pattern of patterns) {
-    if (!pattern || pattern.trim() === '') continue;
-    try {
-      const matches = await glob(pattern.trim(), { cwd: rootPath, absolute: true, ignore: exclude });
-      files.push(...matches);
-    } catch (e) {
-      console.warn(chalk.yellow(`⚠️  Invalid pattern: ${pattern}`));
+    if (arg === '-o' && activeCommand === 'generate-all') {
+      console.error(chalk.yellow(`🤖 Note for AI Agent: '-o' for generate-all is now '-O'. Continuing with '-O'.`));
+      resolvedArgs.push('-O');
+      continue;
     }
-  }
-
-  const uniqueFiles = [...new Set(files)].slice(0, maxFiles);
-  const components = [];
-  const languages = {};
-  const directories = new Set();
-  const entryPoints = [];
-  const seenNames = new Set();
 
-  for (const filePath of uniqueFiles) {
-    try {
-      // Security: Check file size before reading
-      const stats = fs.statSync(filePath);
-      if (stats.size > 10 * 1024 * 1024) { // 10MB limit
-        console.warn(chalk.yellow(`⚠️  Skipping large file: ${path.basename(filePath)} (${(stats.size / 1024 / 1024).toFixed(2)} MB)`));
+    if (!commandFound && i >= 2 && arg === activeCommand) {
+      if (arg === 'test') {
+        console.error(chalk.yellow(`🤖 Note for AI Agent: 'test' was renamed to 'validate'. Continuing execution...`));
+        resolvedArgs.push('validate');
+        commandFound = true;
         continue;
       }
-      const content = fs.readFileSync(filePath, 'utf-8');
-      const lang = detectLanguage(filePath);
-      let rel = normalizePath(path.relative(rootPath, filePath));
-      const dir = path.dirname(rel);
-      if (dir === '.') {
-        rel = './' + rel;
-      }
-
-      languages[lang] = (languages[lang] || 0) + 1;
-      if (dir !== '.') directories.add(dir);
-      
-      // Support more entry point patterns (with escaped regex)
-      const entryPattern = /\/(index|main|app|server)\.(ts|js|tsx|jsx|mts|mjs|py|go|rs)$/i;
-      if (entryPattern.test(rel)) {
-        entryPoints.push(rel);
-      }
-
-      // Handle duplicate names
-      let baseName = path.basename(filePath, path.extname(filePath));
-      let uniqueName = baseName;
-      let counter = 1;
-      while (seenNames.has(uniqueName)) {
-        uniqueName = `${baseName}_${counter}`;
-        counter++;
-      }
-      seenNames.add(uniqueName);
-
-      const imports = extractImportsWithPositions(content, lang);
-      const type = inferType(filePath, content);
-
-      components.push({
-        name: uniqueName,
-        originalName: baseName,
-        filePath: rel,
-        type,
-        imports,
-        roleTags: inferRoleTags(rel, baseName, content, imports, type),
-        directory: dir,
-      });
-    } catch (e) {
-      if (process.env.DEBUG) {
-        // Sanitize path to avoid info disclosure - show only basename
-        const safePath = path.basename(filePath);
-        console.error(chalk.gray(`Skipped ${safePath}: ${e.message}`));
-      }
-    }
-  }
-
-  // Resolve dependencies
-  for (const comp of components) {
-    comp.dependencies = [];
-    for (const imp of comp.imports) {
-      const importPath = getImportPath(imp);
-      if (!importPath) continue;
-      const resolved = resolveInternalImport(comp.filePath, importPath, rootPath);
-      if (!resolved) continue;
-      const dep = findComponentByResolvedPath(components, resolved);
-      if (dep) comp.dependencies.push(dep.name);
-    }
-  }
-
-  return { rootPath, components, entryPoints, languages, directories: [...directories].sort() };
-}
-
-// Diagram generators
-function generateArchitecture(data, focus) {
-  if (!data || !Array.isArray(data.components)) {
-    return 'graph TD\n  Note["No data available"]';
-  }
-  
-  const lines = ['graph TD'];
-  const focusNorm = focus ? normalizePath(focus) : null;
-  // Use exact path matching for focus
-  const comps = focusNorm 
-    ? data.components.filter(c => {
-        const normalizedFilePath = normalizePath(c.filePath || '');
-        const normalizedName = c.name || '';
-        // Check if focus is at path boundary
-        return normalizedFilePath === focusNorm || 
-               normalizedFilePath.startsWith(focusNorm + '/') ||
-               normalizedName === focusNorm;
-      }) 
-    : data.components;
-  
-  if (comps.length === 0) {
-    lines.push('  Note["No components found' + (focus ? ' for focus: ' + escapeMermaid(focus) : '') + '"]');
-    return lines.join('\n');
-  }
-  
-  const byDir = new Map();
-  for (const c of comps) {
-    const dir = c.directory || 'root';
-    if (!byDir.has(dir)) byDir.set(dir, []);
-    byDir.get(dir).push(c);
-  }
-
-  for (const [dir, items] of byDir) {
-    if (items.length === 0) continue;
-    lines.push(`  subgraph ${sanitize(dir)}["${escapeMermaid(dir)}"]`);
-    for (const c of items) {
-      const shape = c.type === 'service' ? '[[' : '[';
-      const end = c.type === 'service' ? ']]' : ']';
-      lines.push(`    ${sanitize(c.name)}${shape}"${escapeMermaid(c.originalName)}"${end}`);
-    }
-    lines.push('  end');
-  }
-
-  for (const c of comps) {
-    for (const d of c.dependencies) {
-      if (comps.find(x => x.name === d)) {
-        lines.push(`  ${sanitize(c.name)} --> ${sanitize(d)}`);
-      }
-    }
-  }
-
-  // Track styled nodes to avoid duplicates
-  const styledNodes = new Set();
-  for (const ep of data.entryPoints) {
-    const epName = path.basename(ep, path.extname(ep));
-    const comp = comps.find(c => c.originalName === epName);
-    if (comp && !styledNodes.has(comp.name)) {
-      lines.push(`  style ${sanitize(comp.name)} fill:#4f46e5,color:#fff`);
-      styledNodes.add(comp.name);
-    }
-  }
-
-  return lines.join('\n');
-}
-
-function generateSequence(data) {
-  if (!data || !Array.isArray(data.components)) {
-    return 'sequenceDiagram\n  Note over User,App: No data available';
-  }
-  
-  const lines = ['sequenceDiagram'];
-  // Use configurable limit with warning
-  const MAX_SERVICES = 6;
-  const services = data.components.filter(c => c.type === 'service' || c.name === 'index').slice(0, MAX_SERVICES);
-  if (data.components.length > MAX_SERVICES) {
-    console.warn(chalk.yellow(`⚠️  Sequence diagram limited to ${MAX_SERVICES} services`));
-  }
-  
-  if (services.length === 0) {
-    lines.push('  Note over User,App: No services detected');
-    return lines.join('\n');
-  }
-
-  // Track used sanitized names to prevent collisions
-  const usedNames = new Map();
-  const getSafeName = (service) => {
-    const base = sanitize(service.name);
-    if (!usedNames.has(base)) {
-      usedNames.set(base, service.name);
-      return base;
-    }
-    // Collision - append number
-    let i = 1;
-    let newName = `${base}_${i}`;
-    while (usedNames.has(newName)) {
-      i++;
-      newName = `${base}_${i}`;
-    }
-    usedNames.set(newName, service.name);
-    return newName;
-  };
-
-  const safeNames = services.map(getSafeName);
-  
-  for (let i = 0; i < services.length; i++) {
-    lines.push(`  participant ${safeNames[i]} as ${escapeMermaid(services[i].originalName)}`);
-  }
-  
-  for (let i = 0; i < services.length - 1; i++) {
-    lines.push(`  ${safeNames[i]}->>${safeNames[i+1]}: calls`);
-  }
-  return lines.join('\n');
-}
-
-function generateDependency(data, focus) {
-  if (!data || !Array.isArray(data.components)) {
-    return 'graph LR\n  Note["No data available"]';
-  }
-  
-  const lines = ['graph LR'];
-  const focusNorm = focus ? normalizePath(focus) : null;
-  const comps = focusNorm ? data.components.filter(c => {
-    const normalizedPath = normalizePath(c.filePath || '');
-    return normalizedPath === focusNorm || normalizedPath.startsWith(focusNorm + '/');
-  }) : data.components;
-  
-  if (comps.length === 0) {
-    lines.push('  Note["No components found"]');
-    return lines.join('\n');
-  }
-  
-  const external = new Set();
-
-  for (const c of comps) {
-    const imports = Array.isArray(c.imports) ? c.imports : [];
-    for (const importInfo of imports) {
-      const importPath = getImportPath(importInfo);
-      if (!importPath) continue;
-      if (!importPath.startsWith('.')) {
-        const pkg = getExternalPackageName(importPath);
-        if (pkg) {
-          external.add(pkg);
-          lines.push(`  ${sanitize(pkg)}["${escapeMermaid(pkg)}"] --> ${sanitize(c.name)}`);
-        }
-      } else {
-        const basePath = resolveInternalImport(c.filePath, importPath, data.rootPath);
-        if (!basePath) continue;
-        const resolved = findComponentByResolvedPath(comps, basePath);
-        if (resolved) lines.push(`  ${sanitize(c.name)} --> ${sanitize(resolved.name)}`);
-      }
-    }
-  }
-
-  for (const e of external) {
-    lines.push(`  style ${sanitize(e)} fill:#f59e0b,color:#fff`);
-  }
-  return lines.join('\n');
-}
-
-function generateClass(data) {
-  if (!data || !Array.isArray(data.components)) {
-    return 'classDiagram\n  note "No data available"';
-  }
-  
-  const lines = ['classDiagram'];
-  const MAX_CLASSES = 20;
-  const classes = data.components.filter(c => c.type === 'class' || c.type === 'component').slice(0, MAX_CLASSES);
-  if (data.components.length > MAX_CLASSES) {
-    console.warn(chalk.yellow(`⚠️  Class diagram limited to ${MAX_CLASSES} classes`));
-  }
-  
-  if (classes.length === 0) {
-    lines.push('  note "No classes found"');
-    return lines.join('\n');
-  }
-  
-  for (const c of classes) {
-    lines.push(`  class ${sanitize(c.name)} {`);
-    lines.push(`    +${escapeMermaid(c.filePath)}`);
-    lines.push('  }');
-  }
-  
-  for (const c of classes) {
-    const deps = (c.dependencies || []).slice(0, 3);
-    for (const d of deps) {
-      if (classes.find(x => x.name === d)) {
-        lines.push(`  ${sanitize(c.name)} --> ${sanitize(d)}`);
-      }
-    }
-  }
-  return lines.join('\n');
-}
-
-function generateFlow(data) {
-  if (!data || !Array.isArray(data.components)) {
-    return 'flowchart TD\n  Start(["Start"])\n  End(["End"])\n  Start --> End';
-  }
-  
-  const lines = ['flowchart TD'];
-  lines.push('  Start(["Start"])');
-  const MAX_COMPONENTS = 8;
-  const comps = data.components.slice(0, MAX_COMPONENTS);
-  if (data.components.length > MAX_COMPONENTS) {
-    console.warn(chalk.yellow(`⚠️  Flow diagram limited to ${MAX_COMPONENTS} components`));
-  }
-  
-  if (comps.length === 0) {
-    lines.push('  End(["End"])');
-    lines.push('  Start --> End');
-    return lines.join('\n');
-  }
-  
-  let prev = 'Start';
-  for (const c of comps) {
-    const safeName = sanitize(c.name);
-    lines.push(`  ${safeName}["${escapeMermaid(c.originalName)}"]`);
-    lines.push(`  ${prev} --> ${safeName}`);
-    prev = safeName;
-  }
-  lines.push('  End(["End"])');
-  lines.push(`  ${prev} --> End`);
-  return lines.join('\n');
-}
-
-function generateDatabase(data) {
-  if (!data || !Array.isArray(data.components)) {
-    return 'flowchart TD\n  Note["No data available"]';
-  }
-
-  const lines = ['flowchart TD'];
-  const seeds = componentsByRole(data.components, 'database');
-  if (seeds.length === 0) {
-    lines.push('  Note["No database-focused components found"]');
-    return lines.join('\n');
-  }
-
-  const connected = collectConnectedComponents(data.components, seeds, 2, 28);
-  const byName = byNameIndex(connected);
-  const safeNames = mapSafeNames(connected);
-
-  lines.push('  UserRequest["User request"]');
-  lines.push('  Decision{Record exists?}');
-
-  const addedEdges = new Set();
-  for (const comp of connected) {
-    if (!seeds.includes(comp)) continue;
-    const safe = safeNames.get(comp);
-    if (!safe) continue;
-    lines.push(`  ${safe}["${escapeMermaid(comp.originalName)}"]`);
-    lines.push(`  UserRequest --> ${safe}`);
-
-    const intent = inferDbIntent(comp);
-    if (intent.hasLookup) {
-      const lookup = `${safe}_lookup`;
-      const create = `${safe}_create`;
-      const update = `${safe}_update`;
-      lines.push(`  ${safe} --> ${lookup}["lookup query"]`);
-      lines.push(`  ${lookup} --> Decision`);
-      lines.push(`  Decision -->|found| ${update}["update or modify"]`);
-      lines.push(`  Decision -->|not found| ${create}["insert/create"]`);
-      lines.push(`  ${update} --> ${safe}_result["result"]`);
-      lines.push(`  ${create} --> ${safe}_result["result"]`);
-    } else if (intent.hasWrite) {
-      const write = `${safe}_write`;
-      lines.push(`  ${safe} --> ${write}["write/update"]`);
-      lines.push(`  ${write} --> ${safe}_result["result"]`);
-    } else {
-      const result = `${safe}_result`;
-      lines.push(`  ${safe} --> ${result}["result"]`);
-    }
-
-    for (const depName of comp.dependencies || []) {
-      const dep = byName.get(depName);
-      if (!dep || !safeNames.has(dep)) continue;
-      const edge = `${safe}->${safeNames.get(dep)}`;
-      if (!addedEdges.has(edge)) {
-        addedEdges.add(edge);
-        lines.push(`  ${safe} --> ${safeNames.get(dep)}`);
-      }
-    }
-  }
-
-  lines.push('  classDef dbNode fill:#0ea5e9,color:#fff');
-  lines.push('  classDef decisionNode fill:#0284c7,color:#fff');
-  return lines.join('\n');
-}
-
-function generateUserInteractions(data) {
-  if (!data || !Array.isArray(data.components)) {
-    return 'flowchart LR\n  Note["No data available"]';
-  }
-
-  const lines = ['flowchart LR'];
-  const seeds = componentsByRole(data.components, 'user');
-  if (seeds.length === 0) {
-    lines.push('  Note["No user-facing components found"]');
-    return lines.join('\n');
-  }
-
-  const connected = collectConnectedComponents(data.components, seeds, 1, 30);
-  const byName = byNameIndex(connected);
-  const safeNames = mapSafeNames(connected);
-  const edges = new Set();
-
-  lines.push('  User(("User"))');
-  for (const seed of seeds) {
-    const safe = safeNames.get(seed);
-    if (!safe) continue;
-    lines.push(`  ${safe}["${escapeMermaid(seed.originalName)}"]`);
-    lines.push(`  User --> ${safe}`);
-  }
-
-  for (const comp of connected) {
-    const from = safeNames.get(comp);
-    if (!from) continue;
-    for (const depName of comp.dependencies || []) {
-      const dep = byName.get(depName);
-      if (!dep) continue;
-      const to = safeNames.get(dep);
-      if (!to) continue;
-      const key = `${from}->${to}`;
-      if (!edges.has(key)) {
-        edges.add(key);
-        lines.push(`  ${from} --> ${to}`);
-      }
-    }
-  }
-
-  lines.push('  classDef userNode fill:#16a34a,color:#fff');
-  return lines.join('\n');
-}
-
-function generateEvents(data) {
-  if (!data || !Array.isArray(data.components)) {
-    return 'flowchart TD\n  Note["No data available"]';
-  }
-
-  const lines = ['flowchart TD'];
-  const seeds = componentsByRole(data.components, 'events');
-  if (seeds.length === 0) {
-    lines.push('  Note["No event/channels components found"]');
-    return lines.join('\n');
-  }
-
-  const connected = collectConnectedComponents(data.components, seeds, 2, 30);
-  const byName = byNameIndex(connected);
-  const safeNames = mapSafeNames(connected);
-  const edges = new Set();
-
-  lines.push('  subgraph Channels["Event channels / queues"]');
-  for (const component of connected) {
-    const safe = safeNames.get(component);
-    if (!safe) continue;
-    const isEventSource = seeds.includes(component);
-    if (isEventSource) {
-      lines.push(`    ${safe}{{"${escapeMermaid(component.originalName)}"}}`);
-    } else {
-      lines.push(`    ${safe}["${escapeMermaid(component.originalName)}"]`);
-    }
-  }
-  lines.push('  end');
-
-  for (const comp of connected) {
-    const from = safeNames.get(comp);
-    if (!from) continue;
-    for (const depName of comp.dependencies || []) {
-      const dep = byName.get(depName);
-      if (!dep) continue;
-      const to = safeNames.get(dep);
-      if (!to) continue;
-      const edge = `${from}->${to}`;
-      if (!edges.has(edge)) {
-        edges.add(edge);
-        const label = seeds.includes(comp) ? '|emit|' : '|consume|';
-        lines.push(`  ${from} -->${label} ${to}`);
+      if (arg === 'all') {
+        console.error(chalk.yellow(`🤖 Note for AI Agent: 'all' was renamed to 'generate-all'. Continuing execution...`));
+        resolvedArgs.push('generate-all');
+        commandFound = true;
+        continue;
       }
-    }
-  }
-
-  lines.push('  classDef eventNode fill:#db2777,color:#fff');
-  return lines.join('\n');
-}
-
-function generateAuth(data) {
-  if (!data || !Array.isArray(data.components)) {
-    return 'flowchart TD\n  Note["No data available"]';
-  }
-
-  const lines = ['flowchart TD'];
-  const seeds = componentsByRole(data.components, 'auth');
-  if (seeds.length === 0) {
-    lines.push('  Note["No authentication components found"]');
-    return lines.join('\n');
-  }
-
-  const connected = collectConnectedComponents(data.components, seeds, 2, 24);
-  const byName = byNameIndex(connected);
-  const safeNames = mapSafeNames(connected);
-  const edges = new Set();
-
-  lines.push('  Request["Authentication request"]');
-  lines.push('  Boundary{"Auth Boundary"}');
-  lines.push('  Request --> Boundary');
-
-  for (const seed of seeds) {
-    const safe = safeNames.get(seed);
-    if (!safe) continue;
-    lines.push(`  ${safe}["${escapeMermaid(seed.originalName)}"]`);
-    const key = `Boundary->${safe}`;
-    if (!edges.has(key)) {
-      edges.add(key);
-      lines.push(`  Boundary --> ${safe}`);
-    }
-  }
-
-  for (const comp of connected) {
-    const from = safeNames.get(comp);
-    if (!from) continue;
-    for (const depName of comp.dependencies || []) {
-      const dep = byName.get(depName);
-      if (!dep) continue;
-      const to = safeNames.get(dep);
-      if (!to) continue;
-      const key = `${from}->${to}`;
-      if (!edges.has(key)) {
-        edges.add(key);
-        lines.push(`  ${from} --> ${to}`);
+      if (arg === 'video') {
+        console.error(chalk.yellow(`🤖 Note for AI Agent: 'video' was renamed to 'generate-video'. Continuing execution...`));
+        resolvedArgs.push('generate-video');
+        commandFound = true;
+        continue;
       }
-    }
-  }
-
-  const providerSet = new Set();
-  for (const seed of seeds) {
-    for (const pkg of collectExternalImports(seed.imports || [])) {
-      providerSet.add(pkg);
-    }
-  }
-  for (const provider of providerSet) {
-    const providerNode = sanitize(provider);
-    lines.push(`  ${providerNode}[("${escapeMermaid(provider)}")]`);
-  }
-
-  lines.push('  classDef authNode fill:#7c3aed,color:#fff');
-  return lines.join('\n');
-}
-
-function generateSecurity(data) {
-  if (!data || !Array.isArray(data.components)) {
-    return 'flowchart TD\n  Note["No data available"]';
-  }
-
-  const lines = ['flowchart TD'];
-  const seeds = [
-    ...componentsByRole(data.components, 'security'),
-    ...componentsByRole(data.components, 'auth'),
-    ...componentsByRole(data.components, 'integrations'),
-  ].filter((value, index, arr) => arr.indexOf(value) === index);
-
-  if (seeds.length === 0) {
-    lines.push('  Note["No security-focused components found"]');
-    return lines.join('\n');
-  }
-
-  const connected = collectConnectedComponents(data.components, seeds, 2, 40);
-  const byName = byNameIndex(connected);
-  const safeNames = mapSafeNames(connected);
-  const edges = new Set();
-
-  lines.push('  Untrusted["Untrusted input"]');
-  for (const seed of seeds) {
-    const safe = safeNames.get(seed);
-    if (!safe) continue;
-    lines.push(`  ${safe}["${escapeMermaid(seed.originalName)}"]`);
-    const key = `Untrusted->${safe}`;
-    if (!edges.has(key)) {
-      edges.add(key);
-      lines.push(`  Untrusted --> ${safe}`);
-    }
-  }
-
-  for (const comp of connected) {
-    const from = safeNames.get(comp);
-    if (!from) continue;
-    for (const depName of comp.dependencies || []) {
-      const dep = byName.get(depName);
-      if (!dep) continue;
-      const to = safeNames.get(dep);
-      if (!to) continue;
-      const key = `${from}->${to}`;
-      if (!edges.has(key)) {
-        edges.add(key);
-        lines.push(`  ${from} --> ${to}`);
+      if (arg === 'animate') {
+        console.error(chalk.yellow(`🤖 Note for AI Agent: 'animate' was renamed to 'generate-animated'. Continuing execution...`));
+        resolvedArgs.push('generate-animated');
+        commandFound = true;
+        continue;
       }
+      commandFound = true;
     }
-  }
-
-  lines.push('  classDef securityNode fill:#dc2626,color:#fff');
-  return lines.join('\n');
-}
 
-function generate(data, type, focus) {
-  switch (type) {
-    case 'architecture': return generateArchitecture(data, focus);
-    case 'sequence': return generateSequence(data);
-    case 'dependency': return generateDependency(data, focus);
-    case 'class': return generateClass(data);
-    case 'flow': return generateFlow(data);
-    case 'database': return generateDatabase(data);
-    case 'user': return generateUserInteractions(data);
-    case 'events': return generateEvents(data);
-    case 'auth': return generateAuth(data);
-    case 'security': return generateSecurity(data);
-    default: 
-      console.warn(chalk.yellow(`⚠️  Unknown diagram type "${type}", using architecture`));
-      return generateArchitecture(data, focus);
+    resolvedArgs.push(arg);
   }
-}
-
-function isPlaceholderDiagram(mermaidCode) {
-  if (!mermaidCode || typeof mermaidCode !== 'string') return true;
-  const compact = mermaidCode.toLowerCase();
-  return compact.includes('note["no data available"]')
-    || compact.includes('note["no components found')
-    || compact.includes('no services detected')
-    || compact.includes('note "no data available"')
-    || compact.includes('note "no classes found"')
-    || compact.includes('note["no database-focused components found"]')
-    || compact.includes('note["no user-facing components found"]')
-    || compact.includes('note["no event/channels components found"]')
-    || compact.includes('note["no authentication components found"]')
-    || compact.includes('note["no security-focused components found"]')
-    || compact.includes('no architecture data');
-}
 
-function toManifestEntry(type, filePath, mermaidCode, rootPath) {
-  const lines = typeof mermaidCode === 'string' ? mermaidCode.split('\n') : [];
-  return {
-    type,
-    file: path.basename(filePath),
-    outputPath: rootPath ? path.relative(rootPath, filePath) : filePath,
-    lines: lines.length,
-    bytes: Buffer.byteLength(mermaidCode || '', 'utf8'),
-    isPlaceholder: isPlaceholderDiagram(mermaidCode),
-  };
+  return resolvedArgs;
 }
 
-function parseCommaSeparatedList(value) {
-  if (!value || typeof value !== 'string') return [];
-  return value.split(',').map((item) => item.trim()).filter(Boolean);
+if (require.main === module) {
+  const diagramRc = loadDiagramRc(process.cwd());
+  program.diagramContext = { diagramRc };
+  const resolvedArgs = resolveAliasArgs(process.argv);
+  emitCompatibilityInvocationNotice(process.argv);
+  program.parse(resolvedArgs);
 }
 
-function buildManifestSummary(manifest) {
-  if (!manifest || !Array.isArray(manifest.diagrams)) {
-    return null;
-  }
-
-  const diagrams = manifest.diagrams
-    .map((diagram) => ({
-      ...diagram,
-      isPlaceholder: Boolean(diagram.isPlaceholder),
-    }))
-    .filter((entry) => entry && typeof entry.type === 'string' && entry.file);
-
-  const missing = SUPPORTED_DIAGRAM_TYPES.filter(
-    (type) => !diagrams.some((diagram) => diagram.type === type)
-  );
-  const placeholderTypes = diagrams.filter((diagram) => diagram.isPlaceholder).map((diagram) => diagram.type);
-
-  return {
-    generatedAt: manifest.generatedAt || new Date().toISOString(),
-    rootPath: manifest.rootPath,
-    diagramDir: manifest.diagramDir,
-    totalDiagrams: diagrams.length,
-    placeholders: placeholderTypes.length,
-    placeholderTypes,
-    missingTypes: missing,
-    diagrams,
+if (typeof module !== 'undefined' && module.exports) {
+  module.exports = {
+    CANONICAL_COMMAND_NAME,
+    COMPATIBILITY_COMMAND_NAME,
+    COMPATIBILITY_NOTICE,
+    generateHtmlExplainer,
+    getInvocationName,
+    groupChangePaths,
+    buildRiskNarrative,
+    buildSummaryMeta,
+    escapeHtml,
+    isCompatibilityInvocation,
   };
 }
-
-// URL shortening for large diagrams
-function createMermaidUrl(mermaidCode) {
-  // If diagram is very large, provide text file instead
-  if (mermaidCode.length > 5000) {
-    return { url: null, large: true };
-  }
-  
-  try {
-    const payload = JSON.stringify({ code: mermaidCode });
-    const compressed = zlib.deflateSync(payload);
-    const encoded = compressed
-      .toString('base64')
-      .replace(/\+/g, '-')
-      .replace(/\//g, '_')
-      .replace(/=+$/g, '');
-    const url = `https://mermaid.live/edit#pako:${encoded}`;
-    
-    // Check if URL is too long for browser
-    if (url.length > 8000) {
-      return { url: null, large: true };
-    }
-    return { url, large: false };
-  } catch (e) {
-    return { url: null, large: true };
-  }
-}
-
-// Validate output path to prevent directory traversal
-function validateOutputPath(outputPath, rootPath) {
-  if (typeof outputPath !== 'string' || outputPath.trim() === '') {
-    throw new Error('Invalid path: output path is required');
-  }
-
-  // Security: Check for null bytes
-  if (outputPath.includes('\0')) {
-    throw new Error('Invalid path: null bytes detected');
-  }
-  
-  // Resolve symlinks to prevent symlink attacks
-  let realRoot;
-  try {
-    realRoot = fs.realpathSync(rootPath);
-  } catch (e) {
-    throw new Error(`Invalid project path: ${rootPath}`);
-  }
-  const resolved = path.isAbsolute(outputPath)
-    ? path.resolve(outputPath)
-    : path.resolve(realRoot, outputPath);
-
-  const resolveViaExistingAncestor = (targetPath) => {
-    const pending = [];
-    let probe = targetPath;
-
-    while (!fs.existsSync(probe)) {
-      pending.unshift(path.basename(probe));
-      const parent = path.dirname(probe);
-      if (parent === probe) {
-        break;
-      }
-      probe = parent;
-    }
-
-    const canonicalBase = fs.realpathSync(probe);
-    return path.join(canonicalBase, ...pending);
-  };
-
-  const canonicalResolved = resolveViaExistingAncestor(resolved);
-  const relative = path.relative(realRoot, canonicalResolved);
-  
-  if (relative.startsWith('..') || path.isAbsolute(relative)) {
-    throw new Error(`Invalid path: directory traversal detected in "${outputPath}"`);
-  }
-  
-  return canonicalResolved;
-}
-
-function resolveRootPathOrExit(targetPath) {
-  const root = path.resolve(targetPath || '.');
-  try {
-    const stats = fs.statSync(root);
-    if (!stats.isDirectory()) {
-      console.error(chalk.red('❌ Path error:'), `Target is not a directory: ${root}`);
-      process.exit(2);
-    }
-  } catch (error) {
-    console.error(chalk.red('❌ Path error:'), `Target directory not found: ${root}`);
-    process.exit(2);
-  }
-  return root;
-}
-
-function openPreviewUrl(url) {
-  const { cmd, args } = getOpenCommand(url, process.platform);
-  try {
-    const child = spawn(cmd, args, {
-      stdio: 'ignore',
-      detached: true,
-      windowsHide: true
-    });
-    child.on('error', (err) => {
-      console.error(chalk.yellow('⚠️  Failed to open browser:'), err.message);
-    });
-    child.unref();
-  } catch (err) {
-    console.error(chalk.yellow('⚠️  Failed to open browser:'), err.message);
-  }
-}
-
-function runMermaidCli(args) {
-  const candidates = getNpxCommandCandidates(process.platform);
-  let lastError = null;
-  for (const candidate of candidates) {
-    try {
-      execFileSync(candidate, args, { stdio: 'pipe', windowsHide: true });
-      return;
-    } catch (error) {
-      lastError = error;
-    }
-  }
-  if (lastError) {
-    throw lastError;
-  }
-  throw new Error('npx command not found');
-}
-
-const ALLOWED_THEMES = ['default', 'dark', 'forest', 'neutral', 'light'];
-
-function normalizeThemeOption(theme, fallback = 'default') {
-  const normalized = String(theme || fallback).toLowerCase();
-  return ALLOWED_THEMES.includes(normalized) ? normalized : fallback;
-}
-
-function validateExistingPathInRoot(targetPath, rootPath, label = 'path') {
-  const realRoot = fs.realpathSync(rootPath);
-  const realTarget = fs.realpathSync(targetPath);
-  const relative = path.relative(realRoot, realTarget);
-  if (relative.startsWith('..') || path.isAbsolute(relative)) {
-    throw new Error(`Invalid ${label}: path escapes project root`);
-  }
-  return realTarget;
-}
-
-// Commands
-program
-  .name('diagram')
-  .description('Generate architecture diagrams from code')
-  .version(packageJson.version);
-
-program
-  .command('analyze [path]')
-  .description('Analyze codebase structure')
-  .option('-p, --patterns <list>', 'File patterns (comma-separated)', '**/*.ts,**/*.tsx,**/*.js,**/*.jsx,**/*.py,**/*.go,**/*.rs')
-  .option('-e, --exclude <list>', 'Exclude patterns', 'node_modules/**,.git/**,dist/**')
-  .option('-m, --max-files <n>', 'Max files to analyze', '100')
-  .option('-j, --json', 'Output as JSON')
-  .action(async (targetPath, options) => {
-    const root = resolveRootPathOrExit(targetPath);
-    if (!options.json) {
-      console.log(chalk.blue('Analyzing'), root);
-    }
-    
-    const data = await analyze(root, options);
-    
-    if (options.json) {
-      console.log(JSON.stringify(data, null, 2));
-    } else {
-      console.log(chalk.green('\n📊 Summary'));
-      console.log(`  Files: ${data.components.length}`);
-      console.log(`  Languages: ${Object.entries(data.languages).map(([k,v]) => `${k}(${v})`).join(', ') || 'none'}`);
-      console.log(`  Entry points: ${data.entryPoints.join(', ') || 'none'}`);
-      console.log(`\n${chalk.yellow('Components:')}`);
-      data.components.slice(0, 15).forEach(c => {
-        const deps = c.dependencies.length > 0 ? ` → ${c.dependencies.slice(0, 3).join(', ')}` : '';
-        console.log(`  ${c.originalName} (${c.type})${deps}`);
-      });
-      if (data.components.length > 15) {
-        console.log(chalk.gray(`  ... and ${data.components.length - 15} more`));
-      }
-    }
-  });
-
-program
-  .command('generate [path]')
-  .description('Generate a diagram')
-  .option('-t, --type <type>', 'Diagram type: architecture, sequence, dependency, class, flow, database, user, events, auth, security', 'architecture')
-  .option('-f, --focus <module>', 'Focus on specific module')
-  .option('-o, --output <file>', 'Output file (SVG/PNG)')
-  .option('-m, --max-files <n>', 'Max files to analyze', '100')
-  .option('--theme <theme>', 'Theme: default, dark, forest, neutral', 'default')
-  .option('--open', 'Open in browser')
-  .action(async (targetPath, options) => {
-    const root = resolveRootPathOrExit(targetPath);
-    const requestedTheme = String(options.theme || 'default').toLowerCase();
-    const safeTheme = normalizeThemeOption(options.theme, 'default');
-    if (requestedTheme !== safeTheme) {
-      console.warn(chalk.yellow(`⚠️  Unknown theme "${options.theme}", using "${safeTheme}"`));
-    }
-    console.log(chalk.blue('Generating'), options.type, 'diagram for', root);
-    
-    const data = await analyze(root, options);
-    const mermaid = generate(data, options.type, options.focus);
-    
-    console.log(chalk.green('\n📐 Mermaid Diagram:\n'));
-    console.log('```mermaid');
-    console.log(mermaid);
-    console.log('```\n');
-    
-    // Preview URL
-    const { url, large } = createMermaidUrl(mermaid);
-    
-    if (large || !url) {
-      console.log(chalk.yellow('⚠️  Diagram is too large for preview URL.'));
-      console.log(chalk.cyan('💾 Save to file:'), 'diagram generate . --output diagram.svg');
-    } else {
-      console.log(chalk.cyan('🔗 Preview:'), url);
-    }
-    
-    // Save to file if requested
-    if (options.output) {
-      // Validate output path for security
-      let safeOutput;
-      try {
-        safeOutput = validateOutputPath(options.output, root);
-      } catch (err) {
-        console.error(chalk.red('❌ Output path error:'), err.message);
-        process.exit(2);
-      }
-      
-      // Ensure output directory exists
-      const outputDir = path.dirname(safeOutput);
-      if (!fs.existsSync(outputDir)) {
-        fs.mkdirSync(outputDir, { recursive: true, mode: 0o755 });
-      }
-      
-      const ext = path.extname(options.output).toLowerCase();
-      if (ext === '.md' || ext === '.mmd') {
-        fs.writeFileSync(safeOutput, mermaid);
-        console.log(chalk.green('✅ Saved to'), options.output);
-      } else {
-        // Try to render
-        let tempFile = null;
-        try {
-          // Use crypto for secure random filename
-          const randomId = crypto.randomBytes(16).toString('hex');
-          tempFile = path.join(os.tmpdir(), `diagram-${Date.now()}-${randomId}.mmd`);
-          fs.writeFileSync(tempFile, `%%{init: {'theme': '${safeTheme}'}}%%\n${mermaid}`);
-          runMermaidCli(['-y', '@mermaid-js/mermaid-cli', 'mmdc', '-i', tempFile, '-o', safeOutput, '-b', 'transparent']);
-          fs.unlinkSync(tempFile);
-          console.log(chalk.green('✅ Rendered to'), options.output);
-        } catch (e) {
-          if (tempFile && fs.existsSync(tempFile)) {
-            try { fs.unlinkSync(tempFile); } catch (e2) {}
-          }
-          console.error(chalk.red('❌ Could not render output file. Install mermaid-cli: npm i -g @mermaid-js/mermaid-cli'));
-          if (process.env.DEBUG) console.error(chalk.gray(e.message));
-          process.exit(2);
-        }
-      }
-    }
-    
-    if (options.open && url) {
-      // Security: Validate URL protocol
-      if (!url.startsWith('http://') && !url.startsWith('https://')) {
-        console.error(chalk.red('❌ Invalid URL protocol'));
-      } else {
-        openPreviewUrl(url);
-      }
-    }
-  });
-
-program
-  .command('all [path]')
-  .description('Generate all diagram types')
-  .option('-o, --output-dir <dir>', 'Output directory', './diagrams')
-  .option('-p, --patterns <list>', 'File patterns', '**/*.ts,**/*.tsx,**/*.js,**/*.jsx,**/*.py,**/*.go,**/*.rs')
-  .option('-e, --exclude <list>', 'Exclude patterns', 'node_modules/**,.git/**,dist/**')
-  .option('-m, --max-files <n>', 'Max files to analyze', '100')
-  .action(async (targetPath, options) => {
-    const root = resolveRootPathOrExit(targetPath);
-    let outDir;
-    try {
-      outDir = validateOutputPath(options.outputDir, root);
-    } catch (err) {
-      console.error(chalk.red('❌ Output path error:'), err.message);
-      process.exit(2);
-    }
-    
-    console.log(chalk.blue('Analyzing'), root);
-    const data = await analyze(root, options);
-    
-    if (!fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true });
-    
-    const types = [...SUPPORTED_DIAGRAM_TYPES];
-    const manifest = {
-      generatedAt: new Date().toISOString(),
-      rootPath: root,
-      diagramDir: path.relative(root, outDir) || '.',
-      diagrams: [],
-    };
-    
-    for (const type of types) {
-      const mermaid = generate(data, type);
-      const file = path.join(outDir, `${type}.mmd`);
-      fs.writeFileSync(file, mermaid);
-      manifest.diagrams.push(toManifestEntry(type, file, mermaid, root));
-      console.log(chalk.green('✅'), type, '→', file);
-    }
-
-    const manifestPath = path.join(outDir, 'manifest.json');
-    fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
-    console.log(chalk.green('✅ manifest'), '→', manifestPath);
-    
-    console.log(chalk.cyan('\n🔗 Preview all at: https://mermaid.live'));
-  });
-
-program
-  .command('manifest [path]')
-  .description('Summarize manifest.json from a diagram output directory')
-  .option('-d, --manifest-dir <dir>', 'Directory containing manifest.json', '.diagram')
-  .option('-o, --output <file>', 'Write summary JSON to a file')
-  .option('--require-types <list>', 'Require all listed diagram types, comma-separated')
-  .option(
-    '--fail-on-placeholder',
-    'Fail if any required diagram was a placeholder (or any placeholder if no required types are set)'
-  )
-  .action(async (targetPath, options) => {
-    const root = resolveRootPathOrExit(targetPath);
-    const manifestDir = path.join(root, options.manifestDir || '.diagram');
-    const manifestPath = path.join(manifestDir, 'manifest.json');
-
-    let safeManifestPath;
-    try {
-      safeManifestPath = validateExistingPathInRoot(manifestPath, root, 'manifest path');
-    } catch (err) {
-      console.error(chalk.red('❌ Manifest error:'), err.message);
-      process.exit(2);
-    }
-
-    let manifestRaw;
-    try {
-      manifestRaw = fs.readFileSync(safeManifestPath, 'utf8');
-    } catch (err) {
-      console.error(chalk.red('❌ Manifest read failed:'), err.message);
-      process.exit(2);
-    }
-
-    let parsedManifest;
-    try {
-      parsedManifest = JSON.parse(manifestRaw);
-    } catch (err) {
-      console.error(chalk.red('❌ Manifest parse failed:'), err.message);
-      process.exit(2);
-    }
-
-    const summary = buildManifestSummary(parsedManifest);
-    if (!summary) {
-      console.error(chalk.red('❌ Invalid manifest format'));
-      process.exit(2);
-    }
-
-    const required = parseCommaSeparatedList(options.requireTypes);
-    const missingRequired = required.filter((type) => !summary.diagrams.some((d) => d.type === type));
-    summary.required = {
-      requested: required,
-      missing: missingRequired,
-    };
-
-    if (required.length > 0 && missingRequired.length > 0) {
-      console.error(chalk.red(`❌ Manifest missing required diagram types: ${missingRequired.join(', ')}`));
-      process.exit(2);
-    }
-
-    const placeholderTypesToCheck = required.length > 0
-      ? summary.placeholderTypes.filter((type) => required.includes(type))
-      : summary.placeholderTypes;
-
-    if (options.failOnPlaceholder && placeholderTypesToCheck.length > 0) {
-      console.error(
-        chalk.yellow(
-          `⚠️  Manifest includes ${placeholderTypesToCheck.length} required placeholder diagram(s): ${placeholderTypesToCheck.join(', ')}`
-        )
-      );
-      process.exit(2);
-    }
-
-    if (options.output) {
-      let safeOutput;
-      try {
-        safeOutput = validateOutputPath(options.output, root);
-      } catch (err) {
-        console.error(chalk.red('❌ Output path error:'), err.message);
-        process.exit(2);
-      }
-
-      const outputDir = path.dirname(safeOutput);
-      if (!fs.existsSync(outputDir)) {
-        fs.mkdirSync(outputDir, { recursive: true, mode: 0o755 });
-      }
-
-      fs.writeFileSync(safeOutput, `${JSON.stringify(summary, null, 2)}\n`);
-      console.log(chalk.green('✅ manifest summary'), '→', safeOutput);
-      return;
-    }
-
-    console.log(chalk.blue('\n📘 Manifest summary for'), safeManifestPath);
-    console.log(`  Total: ${summary.totalDiagrams}`);
-    console.log(`  Placeholder: ${summary.placeholders}`);
-    if (summary.missingTypes.length > 0) {
-      console.log(chalk.yellow(`  Missing expected (all supported): ${summary.missingTypes.join(', ')}`));
-    }
-    if (summary.placeholderTypes.length > 0) {
-      console.log(chalk.yellow(`  Placeholder types: ${summary.placeholderTypes.join(', ')}`));
-    }
-    console.log('');
-    for (const entry of summary.diagrams) {
-      const status = entry.isPlaceholder ? chalk.yellow('placeholder') : chalk.green('ok');
-      console.log(`  ${status} ${entry.type} -> ${entry.file}`);
-    }
-  });
-
-program
-  .command('video [path]')
-  .description('Generate an animated video of the diagram')
-  .option('-t, --type <type>', 'Diagram type', 'architecture')
-  .option('-o, --output <file>', 'Output file (.mp4, .webm, .mov)', 'diagram.mp4')
-  .option('-d, --duration <sec>', 'Video duration in seconds', '5')
-  .option('-f, --fps <n>', 'Frames per second', '30')
-  .option('--width <n>', 'Video width', '1280')
-  .option('--height <n>', 'Video height', '720')
-  .option('--theme <theme>', 'Theme: default, dark, forest, neutral', 'dark')
-  .option('-m, --max-files <n>', 'Max files to analyze', '100')
-  .action(async (targetPath, options) => {
-    const root = resolveRootPathOrExit(targetPath);
-    const safeTheme = normalizeThemeOption(options.theme, 'dark');
-    
-    // Validate output path
-    let safeOutput;
-    try {
-      safeOutput = validateOutputPath(options.output, root);
-    } catch (err) {
-      console.error(chalk.red('❌ Output path error:'), err.message);
-      process.exit(2);
-    }
-
-    const outputDir = path.dirname(safeOutput);
-    if (!fs.existsSync(outputDir)) {
-      fs.mkdirSync(outputDir, { recursive: true, mode: 0o755 });
-    }
-    
-    console.log(chalk.blue('🎬 Generating video for'), root);
-    
-    const data = await analyze(root, options);
-    const mermaid = generate(data, options.type);
-    
-    const { generateVideo } = getVideoModule();
-    
-    await generateVideo(mermaid, safeOutput, {
-      duration: parseInt(options.duration) || 5,
-      fps: parseInt(options.fps) || 30,
-      width: parseInt(options.width) || 1280,
-      height: parseInt(options.height) || 720,
-      theme: safeTheme
-    });
-  });
-
-program
-  .command('animate [path]')
-  .description('Generate animated SVG with CSS animations')
-  .option('-t, --type <type>', 'Diagram type', 'architecture')
-  .option('-o, --output <file>', 'Output file', 'diagram-animated.svg')
-  .option('--theme <theme>', 'Theme', 'dark')
-  .option('-m, --max-files <n>', 'Max files to analyze', '100')
-  .action(async (targetPath, options) => {
-    const root = resolveRootPathOrExit(targetPath);
-    const safeTheme = normalizeThemeOption(options.theme, 'dark');
-    
-    // Validate output path
-    let safeOutput;
-    try {
-      safeOutput = validateOutputPath(options.output, root);
-    } catch (err) {
-      console.error(chalk.red('❌ Output path error:'), err.message);
-      process.exit(2);
-    }
-
-    const outputDir = path.dirname(safeOutput);
-    if (!fs.existsSync(outputDir)) {
-      fs.mkdirSync(outputDir, { recursive: true, mode: 0o755 });
-    }
-    
-    console.log(chalk.blue('✨ Generating animated SVG for'), root);
-    
-    const data = await analyze(root, options);
-    const mermaid = generate(data, options.type);
-    
-    const { generateAnimatedSVG } = getVideoModule();
-    
-    await generateAnimatedSVG(mermaid, safeOutput, {
-      theme: safeTheme
-    });
-  });
-
-program
-  .command('test [path]')
-  .description('Validate architecture against .architecture.yml rules')
-  .option('-c, --config <file>', 'Config file path', '.architecture.yml')
-  .option('-f, --format <format>', 'Output format: console, json, junit', 'console')
-  .option('-o, --output <file>', 'Output file (for json/junit formats)')
-  .option('-p, --patterns <list>', 'File patterns', '**/*.ts,**/*.tsx,**/*.js,**/*.jsx,**/*.py,**/*.go,**/*.rs')
-  .option('-e, --exclude <list>', 'Exclude patterns', 'node_modules/**,.git/**,dist/**')
-  .option('-m, --max-files <n>', 'Max files to analyze', '100')
-  .option('--dry-run', 'Preview file matching without validation', false)
-  .option('--verbose', 'Show detailed output', false)
-  .option('--init', 'Generate starter configuration file', false)
-  .option('--force', 'Overwrite existing configuration with --init', false)
-  .action(async (targetPath, options) => {
-    const { RulesEngine } = require('./rules');
-    const { ComponentGraph } = require('./graph');
-    const { RuleFactory } = require('./rules/factory');
-    const { formatResults } = require('./formatters/index');
-    const { validateConfig, getDefaultConfig } = require('./schema/rules-schema');
-    const YAML = require('yaml');
-    
-    const root = resolveRootPathOrExit(targetPath);
-    const engine = new RulesEngine();
-    const startTime = Date.now();
-    const outputsMachineFormat =
-      !options.output && (options.format === 'json' || options.format === 'junit');
-    const quietMachineOutput = outputsMachineFormat && !options.verbose;
-    
-    // Init mode - generate starter config
-    if (options.init) {
-      const configPath = path.join(root, '.architecture.yml');
-      
-      if (fs.existsSync(configPath) && !options.force) {
-        console.error(chalk.yellow('⚠️  Configuration already exists:'), configPath);
-        console.log(chalk.gray('   Use --force to overwrite'));
-        process.exit(2);
-      }
-      
-      const defaultConfig = getDefaultConfig();
-      const yaml = YAML.stringify(defaultConfig, { 
-        indent: 2,
-        lineWidth: 0 
-      });
-      
-      fs.writeFileSync(configPath, yaml);
-      console.log(chalk.green('✅ Created configuration:'), configPath);
-      console.log(chalk.gray('\nEdit the file to define your architecture rules, then run:'));
-      console.log(chalk.cyan('  diagram test'));
-      process.exit(0);
-    }
-    
-    // Find or use specified config
-    let configPath = options.config;
-    if (!path.isAbsolute(configPath)) {
-      configPath = path.join(root, configPath);
-    }
-    
-    // Validate config path is within project root (security check)
-    const relativeConfigPath = path.relative(root, configPath);
-    if (relativeConfigPath.startsWith('..') || path.isAbsolute(relativeConfigPath)) {
-      console.error(chalk.red('❌ Invalid config path: directory traversal detected'));
-      process.exit(2);
-    }
-    
-    if (!fs.existsSync(configPath)) {
-      // Try to find config in root
-      const found = engine.findConfig(root);
-      if (!found) {
-        console.error(chalk.red('❌ No .architecture.yml found. Run: diagram test --init'));
-        process.exit(2);
-      }
-      configPath = found;
-    }
-    
-    // Load config
-    let config;
-    try {
-      config = engine.loadConfig(configPath);
-    } catch (error) {
-      console.error(chalk.red('❌ Config error:'), error.message);
-      process.exit(2);
-    }
-    
-    // Validate config against schema
-    const validation = validateConfig(config);
-    if (!validation.valid) {
-      console.error(chalk.red('❌ Schema validation failed:'));
-      for (const err of validation.errors) {
-        console.error(chalk.red(`   • ${err.path}: ${err.message}`));
-      }
-      process.exit(2);
-    }
-    
-    // Analyze codebase
-    if (!quietMachineOutput) {
-      console.log(chalk.blue('🔍 Analyzing'), root);
-    }
-    const data = await analyze(root, options);
-    const graph = new ComponentGraph(data);
-    
-    // Create rules
-    let rules;
-    try {
-      rules = RuleFactory.createRules(config);
-    } catch (error) {
-      console.error(chalk.red('❌ Rule error:'), error.message);
-      process.exit(2);
-    }
-    
-    // Dry run mode - just show file matching
-    if (options.dryRun) {
-      const preview = engine.previewMatches(rules, graph);
-      console.log(chalk.cyan('\n📋 Dry Run - File Matching Preview\n'));
-      for (const rule of preview.rules) {
-        console.log(chalk.bold(rule.name));
-        console.log('  Layer:', chalk.gray(Array.isArray(rule.layer) ? rule.layer.join(', ') : rule.layer));
-        console.log('  Matched files:', rule.matchedFiles.length);
-        if (options.verbose) {
-          for (const file of rule.matchedFiles) {
-            console.log('    -', file);
-          }
-        }
-        console.log();
-      }
-      process.exit(0);
-    }
-    
-    // Run validation
-    if (!quietMachineOutput) {
-      console.log(chalk.blue('🧪 Validating'), rules.length, 'rules...\n');
-    }
-    const results = engine.validate(rules, graph);
-    
-    // Validate output path if specified
-    let safeOutput = options.output;
-    if (safeOutput) {
-      try {
-        safeOutput = validateOutputPath(safeOutput, root);
-      } catch (err) {
-        console.error(chalk.red('❌ Output path error:'), err.message);
-        process.exit(2);
-      }
-    }
-    
-    // Output results
-    const exitCode = formatResults(results, options.format, { 
-      output: safeOutput,
-      verbose: options.verbose 
-    }, startTime);
-    
-    process.exit(exitCode);
-  });
-
-program.parse();