agileflow 3.4.3 → 4.0.0-alpha.1

package/tools/cli/lib/ide-registry.js

@@ -1,297 +0,0 @@
-/**
- * AgileFlow CLI - IDE Registry
- *
- * Centralized registry of supported IDEs with their metadata.
- * This eliminates duplicate IDE configuration scattered across commands.
- *
- * Enhanced as part of US-0178: Consolidate IDE installer config into unified registry pattern
- *
- * Usage:
- *   const { IdeRegistry } = require('./lib/ide-registry');
- *   const configPath = IdeRegistry.getConfigPath('claude-code', projectDir);
- *   const displayName = IdeRegistry.getDisplayName('cursor');
- *   const config = IdeRegistry.get('windsurf');
- */
-
-const path = require('path');
-
-/**
- * IDE metadata definition
- * @typedef {Object} IdeMetadata
- * @property {string} name - Internal IDE name (e.g., 'claude-code')
- * @property {string} displayName - Human-readable name (e.g., 'Claude Code')
- * @property {string} configDir - Base config directory (e.g., '.claude')
- * @property {string} commandsSubdir - Subdirectory for commands (e.g., 'commands', 'workflows')
- * @property {string} agileflowFolder - AgileFlow folder name (e.g., 'agileflow', 'AgileFlow')
- * @property {string} targetSubdir - Full target path (computed from commandsSubdir + agileflowFolder)
- * @property {boolean} preferred - Whether this is a preferred IDE
- * @property {string} description - Short description for UI
- * @property {string} [handler] - Handler class name (e.g., 'ClaudeCodeSetup')
- * @property {Object} labels - Custom labels for installed content
- * @property {Object} features - Feature flags for this IDE
- */
-
-/**
- * Registry of all supported IDEs
- * @type {Object.<string, IdeMetadata>}
- */
-const IDE_REGISTRY = {
-  'claude-code': {
-    name: 'claude-code',
-    displayName: 'Claude Code',
-    configDir: '.claude',
-    commandsSubdir: 'commands',
-    agileflowFolder: 'agileflow',
-    targetSubdir: 'commands/agileflow', // lowercase
-    preferred: true,
-    description: "Anthropic's Claude Code IDE",
-    handler: 'ClaudeCodeSetup',
-    labels: {
-      commands: 'commands',
-      agents: 'agents',
-    },
-    features: {
-      spawnableAgents: true, // Has .claude/agents/ for Task tool
-      skills: true, // Has .claude/skills/ for user skills
-      damageControl: true, // Supports PreToolUse hooks
-    },
-  },
-  cursor: {
-    name: 'cursor',
-    displayName: 'Cursor',
-    configDir: '.cursor',
-    commandsSubdir: 'commands',
-    agileflowFolder: 'AgileFlow',
-    targetSubdir: 'commands/AgileFlow', // PascalCase
-    preferred: false,
-    description: 'AI-powered code editor',
-    handler: 'CursorSetup',
-    labels: {
-      commands: 'commands',
-      agents: 'agents',
-    },
-    features: {
-      spawnableAgents: false,
-      skills: false,
-      damageControl: false,
-    },
-  },
-  windsurf: {
-    name: 'windsurf',
-    displayName: 'Windsurf',
-    configDir: '.windsurf',
-    commandsSubdir: 'workflows',
-    agileflowFolder: 'agileflow',
-    targetSubdir: 'workflows/agileflow', // lowercase
-    preferred: false,
-    description: "Codeium's AI IDE",
-    handler: 'WindsurfSetup',
-    labels: {
-      commands: 'workflows',
-      agents: 'agent workflows',
-    },
-    features: {
-      spawnableAgents: false,
-      skills: false,
-      damageControl: false,
-    },
-  },
-  codex: {
-    name: 'codex',
-    displayName: 'OpenAI Codex',
-    configDir: '.codex',
-    commandsSubdir: 'skills',
-    agileflowFolder: 'agileflow',
-    targetSubdir: 'skills', // Codex uses skills directory
-    preferred: false,
-    description: "OpenAI's Codex",
-    handler: 'CodexSetup',
-    labels: {
-      commands: 'prompts',
-      agents: 'skills',
-    },
-    features: {
-      spawnableAgents: false,
-      skills: true, // Has .codex/skills/
-      damageControl: false,
-      customInstall: true, // Uses custom install flow (not setupStandard)
-      agentsMd: true, // Creates AGENTS.md at project root
-    },
-  },
-};
-
-/**
- * IDE Registry class providing centralized IDE metadata access
- */
-class IdeRegistry {
-  /**
-   * Get all registered IDE names
-   * @returns {string[]} List of IDE names
-   */
-  static getAll() {
-    return Object.keys(IDE_REGISTRY);
-  }
-
-  /**
-   * Get all IDE metadata
-   * @returns {Object.<string, IdeMetadata>} All IDE metadata
-   */
-  static getAllMetadata() {
-    return { ...IDE_REGISTRY };
-  }
-
-  /**
-   * Get metadata for a specific IDE
-   * @param {string} ideName - IDE name
-   * @returns {IdeMetadata|null} IDE metadata or null if not found
-   */
-  static get(ideName) {
-    return IDE_REGISTRY[ideName] || null;
-  }
-
-  /**
-   * Check if an IDE is registered
-   * @param {string} ideName - IDE name
-   * @returns {boolean}
-   */
-  static exists(ideName) {
-    return ideName in IDE_REGISTRY;
-  }
-
-  /**
-   * Get the config path for an IDE in a project
-   * @param {string} ideName - IDE name
-   * @param {string} projectDir - Project directory
-   * @returns {string} Full path to IDE config directory
-   */
-  static getConfigPath(ideName, projectDir) {
-    const ide = IDE_REGISTRY[ideName];
-    if (!ide) {
-      return '';
-    }
-    return path.join(projectDir, ide.configDir, ide.targetSubdir);
-  }
-
-  /**
-   * Get the base config directory for an IDE (e.g., .claude, .cursor)
-   * @param {string} ideName - IDE name
-   * @param {string} projectDir - Project directory
-   * @returns {string} Full path to base config directory
-   */
-  static getBaseDir(ideName, projectDir) {
-    const ide = IDE_REGISTRY[ideName];
-    if (!ide) {
-      return '';
-    }
-    return path.join(projectDir, ide.configDir);
-  }
-
-  /**
-   * Get the display name for an IDE
-   * @param {string} ideName - IDE name
-   * @returns {string} Display name or the original name if not found
-   */
-  static getDisplayName(ideName) {
-    const ide = IDE_REGISTRY[ideName];
-    return ide ? ide.displayName : ideName;
-  }
-
-  /**
-   * Get all preferred IDEs
-   * @returns {string[]} List of preferred IDE names
-   */
-  static getPreferred() {
-    return Object.entries(IDE_REGISTRY)
-      .filter(([, meta]) => meta.preferred)
-      .map(([name]) => name);
-  }
-
-  /**
-   * Validate IDE name
-   * @param {string} ideName - IDE name to validate
-   * @returns {{ok: boolean, error?: string}} Validation result
-   */
-  static validate(ideName) {
-    if (!ideName || typeof ideName !== 'string') {
-      return { ok: false, error: 'IDE name must be a non-empty string' };
-    }
-
-    if (!IDE_REGISTRY[ideName]) {
-      const validNames = Object.keys(IDE_REGISTRY).join(', ');
-      return {
-        ok: false,
-        error: `Unknown IDE: '${ideName}'. Valid options: ${validNames}`,
-      };
-    }
-
-    return { ok: true };
-  }
-
-  /**
-   * Get handler class name for an IDE
-   * @param {string} ideName - IDE name
-   * @returns {string|null} Handler class name or null
-   */
-  static getHandler(ideName) {
-    const ide = IDE_REGISTRY[ideName];
-    return ide ? ide.handler : null;
-  }
-
-  /**
-   * Get IDE choices formatted for UI selection (inquirer checkbox format)
-   * @returns {Array} Array of {name, value, checked, configDir, description}
-   */
-  static getChoices() {
-    return Object.values(IDE_REGISTRY)
-      .sort((a, b) => {
-        // Preferred first, then alphabetical
-        if (a.preferred && !b.preferred) return -1;
-        if (!a.preferred && b.preferred) return 1;
-        return a.displayName.localeCompare(b.displayName);
-      })
-      .map((ide, index) => ({
-        name: ide.displayName,
-        value: ide.name,
-        checked: ide.preferred || index === 0,
-        configDir: `${ide.configDir}/${ide.commandsSubdir}`,
-        description: ide.description,
-      }));
-  }
-
-  /**
-   * Check if an IDE has a specific feature
-   * @param {string} ideName - IDE name
-   * @param {string} featureName - Feature to check
-   * @returns {boolean}
-   */
-  static hasFeature(ideName, featureName) {
-    const ide = IDE_REGISTRY[ideName];
-    return !!(ide && ide.features && ide.features[featureName]);
-  }
-
-  /**
-   * Get all IDEs with a specific feature
-   * @param {string} featureName - Feature to filter by
-   * @returns {string[]} Array of IDE names
-   */
-  static getWithFeature(featureName) {
-    return Object.entries(IDE_REGISTRY)
-      .filter(([, meta]) => meta.features && meta.features[featureName])
-      .map(([name]) => name);
-  }
-
-  /**
-   * Get labels for an IDE (e.g., 'commands' vs 'workflows')
-   * @param {string} ideName - IDE name
-   * @returns {Object} Labels object {commands, agents}
-   */
-  static getLabels(ideName) {
-    const ide = IDE_REGISTRY[ideName];
-    return ide && ide.labels ? ide.labels : { commands: 'commands', agents: 'agents' };
-  }
-}
-
-module.exports = {
-  IdeRegistry,
-  IDE_REGISTRY,
-};

package/tools/cli/lib/npm-utils.js

@@ -1,103 +0,0 @@
-/**
- * AgileFlow CLI - npm Registry Utilities
- *
- * Utilities for interacting with the npm registry.
- * Set DEBUG_NPM=1 environment variable for verbose error logging.
- */
-
-const https = require('https');
-
-// Debug mode: set DEBUG_NPM=1 to see error details
-const DEBUG = process.env.DEBUG_NPM === '1';
-
-/**
- * Log debug messages when DEBUG_NPM=1
- * @param {string} message - Message to log
- * @param {*} data - Optional data to include
- */
-function debugLog(message, data = null) {
-  if (DEBUG) {
-    console.error(`[npm-utils] ${message}`, data ? JSON.stringify(data) : '');
-  }
-}
-
-/**
- * Get the latest version of a package from npm registry
- *
- * Returns null on any error (network, timeout, invalid response) since
- * version checking should not block the CLI. Set DEBUG_NPM=1 to see errors.
- *
- * @param {string} packageName - Name of the package (e.g., 'agileflow' or '@scope/pkg')
- * @returns {Promise<string|null>} Latest version string or null if unavailable
- */
-async function getLatestVersion(packageName) {
-  return new Promise(resolve => {
-    const options = {
-      hostname: 'registry.npmjs.org',
-      port: 443,
-      path: `/${packageName}/latest`,
-      method: 'GET',
-      headers: {
-        'User-Agent': 'agileflow-cli',
-      },
-      // Security: Explicitly enable TLS certificate validation
-      // Prevents MITM attacks on npm registry requests
-      rejectUnauthorized: true,
-    };
-
-    debugLog('Fetching version', { package: packageName, path: options.path });
-
-    const req = https.request(options, res => {
-      let data = '';
-
-      res.on('data', chunk => {
-        data += chunk;
-      });
-
-      res.on('end', () => {
-        if (res.statusCode !== 200) {
-          debugLog('Non-200 status', { statusCode: res.statusCode });
-          return resolve(null);
-        }
-
-        try {
-          const json = JSON.parse(data);
-          const version = json.version || null;
-          debugLog('Version found', { version });
-          resolve(version);
-        } catch (err) {
-          debugLog('JSON parse error', { error: err.message });
-          resolve(null);
-        }
-      });
-    });
-
-    req.on('error', err => {
-      // Enhanced error logging with retry guidance
-      const errorInfo = {
-        error: err.message,
-        code: err.code,
-        suggestion: 'Check network connection. If error persists, try: npm cache clean --force',
-      };
-      if (err.code === 'CERT_HAS_EXPIRED' || err.code === 'UNABLE_TO_VERIFY_LEAF_SIGNATURE') {
-        errorInfo.suggestion =
-          'TLS certificate error - check system time or update CA certificates';
-      }
-      debugLog('Network error', errorInfo);
-      resolve(null);
-    });
-
-    // 10 second timeout for registry requests
-    req.setTimeout(10000, () => {
-      debugLog('Request timeout (10s)', { suggestion: 'npm registry may be slow. Retry later.' });
-      req.destroy();
-      resolve(null);
-    });
-
-    req.end();
-  });
-}
-
-module.exports = {
-  getLatestVersion,
-};

package/tools/cli/lib/self-update.js

@@ -1,148 +0,0 @@
-/**
- * AgileFlow CLI - Self-Update Module
- *
- * Provides self-update capability for the CLI to ensure users
- * always run the latest version.
- *
- * Usage:
- *   const { checkSelfUpdate, performSelfUpdate } = require('./lib/self-update');
- *   await checkSelfUpdate(options, 'update');
- */
-
-const path = require('path');
-const { spawnSync } = require('node:child_process');
-const semver = require('semver');
-const chalk = require('chalk');
-const { getLatestVersion } = require('./npm-utils');
-const { info } = require('./ui');
-
-/**
- * Get the local CLI version from package.json
- * @returns {string} Local CLI version
- */
-function getLocalVersion() {
-  const packageJson = require(path.join(__dirname, '..', '..', '..', 'package.json'));
-  return packageJson.version;
-}
-
-/**
- * Check if a self-update is needed
- * @param {Object} options - Command options
- * @param {boolean} [options.selfUpdate=true] - Whether self-update is enabled
- * @param {boolean} [options.selfUpdated=false] - Whether already self-updated
- * @returns {Promise<{needed: boolean, localVersion: string, latestVersion: string|null}>}
- */
-async function checkSelfUpdate(options = {}) {
-  const shouldCheck = options.selfUpdate !== false && !options.selfUpdated;
-
-  if (!shouldCheck) {
-    return {
-      needed: false,
-      localVersion: getLocalVersion(),
-      latestVersion: null,
-    };
-  }
-
-  const localVersion = getLocalVersion();
-  const latestVersion = await getLatestVersion('agileflow');
-
-  if (!latestVersion) {
-    return {
-      needed: false,
-      localVersion,
-      latestVersion: null,
-    };
-  }
-
-  const needed = semver.lt(localVersion, latestVersion);
-
-  return {
-    needed,
-    localVersion,
-    latestVersion,
-  };
-}
-
-/**
- * Perform self-update by re-running with latest CLI version
- * @param {string} command - Command name to re-run
- * @param {Object} options - Command options
- * @param {Object} versionInfo - Version info from checkSelfUpdate
- * @returns {number} Exit code from spawned process
- */
-function performSelfUpdate(command, options, versionInfo) {
-  const { localVersion, latestVersion } = versionInfo;
-
-  // Display update notice
-  console.log(chalk.hex('#e8683a').bold('\n  AgileFlow CLI Update\n'));
-  info(`Updating CLI from v${localVersion} to v${latestVersion}...`);
-  console.log(chalk.dim('  Fetching latest version from npm...\n'));
-
-  // Build the command with all current options forwarded
-  const args = ['agileflow@latest', command, '--self-updated'];
-
-  // Forward common options
-  if (options.directory) args.push('-d', options.directory);
-  if (options.force) args.push('--force');
-
-  // Forward command-specific options
-  if (command === 'update' && options.ides) {
-    args.push('--ides', options.ides);
-  }
-
-  const result = spawnSync('npx', args, {
-    stdio: 'inherit',
-    cwd: process.cwd(),
-    shell: process.platform === 'win32',
-  });
-
-  return result.status ?? 0;
-}
-
-/**
- * Check and perform self-update if needed
- * Returns true if the caller should exit (because update was performed)
- * @param {string} command - Command name
- * @param {Object} options - Command options
- * @returns {Promise<boolean>} True if caller should exit
- */
-async function handleSelfUpdate(command, options) {
-  const versionInfo = await checkSelfUpdate(options);
-
-  if (versionInfo.needed) {
-    const exitCode = performSelfUpdate(command, options, versionInfo);
-    process.exit(exitCode);
-    return true; // Never reached, but for type safety
-  }
-
-  return false;
-}
-
-/**
- * Middleware for self-update check
- * @param {string} command - Command name
- * @returns {Function} Middleware function
- */
-function selfUpdateMiddleware(command) {
-  return async (ctx, next) => {
-    const versionInfo = await checkSelfUpdate(ctx.options);
-
-    if (versionInfo.needed) {
-      const exitCode = performSelfUpdate(command, ctx.options, versionInfo);
-      process.exit(exitCode);
-      return; // Never reached
-    }
-
-    // Store version info in context for later use
-    ctx.versionInfo = versionInfo;
-    await next();
-  };
-}
-
-module.exports = {
-  getLocalVersion,
-  checkSelfUpdate,
-  performSelfUpdate,
-  handleSelfUpdate,
-  selfUpdateMiddleware,
-};