agileflow 3.4.3 → 4.0.0-alpha.2

package/tools/cli/lib/ui.js

@@ -1,211 +0,0 @@
-/**
- * AgileFlow CLI - UI Utilities
- *
- * Provides interactive prompts and display utilities for the CLI.
- */
-
-const chalk = require('chalk');
-const inquirer = require('inquirer');
-const path = require('node:path');
-const fs = require('node:fs');
-const { IdeManager } = require('../installers/ide/manager');
-const { IdeRegistry } = require('./ide-registry');
-const { BRAND_HEX } = require('../../../lib/colors');
-
-// Load package.json for version
-const packageJsonPath = path.join(__dirname, '..', '..', '..', 'package.json');
-const packageJson = require(packageJsonPath);
-
-/**
- * Display the AgileFlow ASCII logo
- */
-function displayLogo() {
-  const logo = `
- █████╗  ██████╗ ██╗██╗     ███████╗███████╗██╗      ██████╗ ██╗    ██╗
-██╔══██╗██╔════╝ ██║██║     ██╔════╝██╔════╝██║     ██╔═══██╗██║    ██║
-███████║██║  ███╗██║██║     █████╗  █████╗  ██║     ██║   ██║██║ █╗ ██║
-██╔══██║██║   ██║██║██║     ██╔══╝  ██╔══╝  ██║     ██║   ██║██║███╗██║
-██║  ██║╚██████╔╝██║███████╗███████╗██║     ███████╗╚██████╔╝╚███╔███╔╝
-╚═╝  ╚═╝ ╚═════╝ ╚═╝╚══════╝╚══════╝╚═╝     ╚══════╝ ╚═════╝  ╚══╝╚══╝ `;
-  console.log(chalk.hex(BRAND_HEX)(logo));
-  console.log(chalk.dim(`  AgileFlow v${packageJson.version} - AI-Driven Agile Development\n`));
-}
-
-/**
- * Display a section header
- * @param {string} title - Section title
- * @param {string} subtitle - Optional subtitle
- */
-function displaySection(title, subtitle = null) {
-  console.log(chalk.bold.hex(BRAND_HEX)(`\n${title}`));
-  if (subtitle) {
-    console.log(chalk.dim(subtitle));
-  }
-  console.log();
-}
-
-/**
- * Display a success message
- * @param {string} message - Success message
- */
-function success(message) {
-  console.log(chalk.green(`✓ ${message}`));
-}
-
-/**
- * Display a warning message
- * @param {string} message - Warning message
- */
-function warning(message) {
-  console.log(chalk.yellow(`⚠ ${message}`));
-}
-
-/**
- * Display an error message
- * @param {string} message - Error message
- */
-function error(message) {
-  console.log(chalk.red(`✗ ${message}`));
-}
-
-/**
- * Display an info message
- * @param {string} message - Info message
- */
-function info(message) {
-  console.log(chalk.dim(`  ${message}`));
-}
-
-// IDE Manager instance for dynamic IDE discovery
-const ideManager = new IdeManager();
-
-/**
- * Get available IDE choices dynamically from installed handlers
- * @returns {Array} IDE choices formatted for inquirer
- */
-function getIdeChoices() {
-  const ides = ideManager.getAvailableIdes();
-
-  return ides.map((ide, index) => ({
-    name: ide.name,
-    value: ide.value,
-    // First IDE (preferred) is checked by default
-    checked: ide.preferred || index === 0,
-  }));
-}
-
-/**
- * @deprecated Use getIdeChoices() instead - dynamically loaded from IDE handlers
- * Legacy hardcoded IDE choices - now sourced from IdeRegistry for consistency
- * Kept for backward compatibility with code that imports IDE_CHOICES directly
- */
-const IDE_CHOICES = IdeRegistry.getChoices();
-
-/**
- * Prompt for installation configuration
- * Streamlined to ask only essential questions - uses smart defaults for the rest.
- * @returns {Promise<Object>} Installation configuration
- */
-async function promptInstall() {
-  displayLogo();
-
-  // Always install to current directory
-  const directory = path.resolve('.');
-
-  // Check if docs/ folder already exists and if it's an AgileFlow docs folder
-  const defaultDocsFolder = 'docs';
-  const docsPath = path.join(directory, defaultDocsFolder);
-  const docsExists = fs.existsSync(docsPath);
-
-  // Check if existing docs/ is an AgileFlow docs folder
-  // AgileFlow docs have 00-meta/agileflow-metadata.json
-  const isAgileFlowDocs =
-    docsExists && fs.existsSync(path.join(docsPath, '00-meta', 'agileflow-metadata.json'));
-
-  // Build questions dynamically - only ask what's necessary
-  const questions = [
-    {
-      type: 'checkbox',
-      name: 'ides',
-      message: 'Select your IDE(s):',
-      choices: getIdeChoices(),
-      validate: input => {
-        if (input.length === 0) {
-          return 'Please select at least one IDE';
-        }
-        return true;
-      },
-    },
-  ];
-
-  // Only ask about docs folder if it exists AND is not an AgileFlow folder
-  // If it's already an AgileFlow folder, reuse it silently
-  if (docsExists && !isAgileFlowDocs) {
-    questions.push({
-      type: 'input',
-      name: 'docsFolder',
-      message: `A 'docs/' folder already exists (not AgileFlow). Use a different name?`,
-      default: 'agileflow-docs',
-      validate: input => {
-        if (!/^[a-zA-Z0-9._-]+$/.test(input)) {
-          return 'Folder name can only contain letters, numbers, dots, underscores, and hyphens';
-        }
-        return true;
-      },
-    });
-  }
-
-  const answers = await inquirer.prompt(questions);
-
-  return {
-    directory,
-    ides: answers.ides,
-    userName: 'Developer', // Smart default - rarely customized
-    agileflowFolder: '.agileflow', // Smart default - never changed
-    docsFolder: answers.docsFolder || defaultDocsFolder,
-    updateGitignore: true, // Smart default - always want this
-  };
-}
-
-/**
- * Prompt for confirmation
- * @param {string} message - Confirmation message
- * @param {boolean} defaultValue - Default value
- * @returns {Promise<boolean>}
- */
-async function confirm(message, defaultValue = true) {
-  const { confirmed } = await inquirer.prompt([
-    {
-      type: 'confirm',
-      name: 'confirmed',
-      message,
-      default: defaultValue,
-    },
-  ]);
-  return confirmed;
-}
-
-/**
- * Get IDE configuration by name
- * Uses IdeRegistry for consistent configuration
- * @param {string} ideName - IDE name
- * @returns {Object|null}
- */
-function getIdeConfig(ideName) {
-  // Use IdeRegistry as the single source of truth
-  return IdeRegistry.get(ideName);
-}
-
-module.exports = {
-  displayLogo,
-  displaySection,
-  success,
-  warning,
-  error,
-  info,
-  promptInstall,
-  confirm,
-  getIdeConfig,
-  getIdeChoices,
-  IDE_CHOICES, // @deprecated - kept for backward compatibility
-};

package/tools/cli/lib/utils.js

@@ -1,87 +0,0 @@
-/**
- * Shared Utilities Module
- *
- * Common utility functions used across the CLI.
- * Consolidates duplicated code from installer.js, doctor.js, etc.
- */
-
-const crypto = require('crypto');
-const path = require('path');
-
-/**
- * Calculate SHA256 hash of data and return as hex string
- * @param {string|Buffer} data - Data to hash
- * @returns {string} Hex-encoded SHA256 hash
- */
-function sha256Hex(data) {
-  return crypto.createHash('sha256').update(data).digest('hex');
-}
-
-/**
- * Convert a file path to POSIX format (forward slashes)
- * @param {string} filePath - Path to convert
- * @returns {string} POSIX-style path
- */
-function toPosixPath(filePath) {
-  return filePath.split(path.sep).join('/');
-}
-
-/**
- * Generate a safe timestamp string for use in file/folder names
- * @param {Date} date - Date to format (defaults to now)
- * @returns {string} Timestamp like "2025-12-27T10-30-45-123Z"
- */
-function safeTimestampForPath(date = new Date()) {
-  return date.toISOString().replace(/[:.]/g, '-');
-}
-
-/**
- * Compare two semantic version strings
- * @param {string} v1 - First version (e.g., "2.61.0")
- * @param {string} v2 - Second version (e.g., "2.60.0")
- * @returns {number} -1 if v1 < v2, 0 if equal, 1 if v1 > v2
- */
-function compareVersions(v1, v2) {
-  const parts1 = v1.replace(/^v/, '').split('.').map(Number);
-  const parts2 = v2.replace(/^v/, '').split('.').map(Number);
-
-  for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
-    const p1 = parts1[i] || 0;
-    const p2 = parts2[i] || 0;
-    if (p1 < p2) return -1;
-    if (p1 > p2) return 1;
-  }
-  return 0;
-}
-
-/**
- * Create a debug logger function
- * @param {boolean} enabled - Whether debug logging is enabled
- * @param {string} prefix - Optional prefix for log messages
- * @returns {Function} Debug log function
- */
-function createDebugLogger(enabled, prefix = '') {
-  return (...args) => {
-    if (enabled) {
-      if (prefix) {
-        console.log(`[${prefix}]`, ...args);
-      } else {
-        console.log(...args);
-      }
-    }
-  };
-}
-
-/**
- * Brand color for AgileFlow (burnt orange/terracotta)
- */
-const BRAND_COLOR = '#e8683a';
-
-module.exports = {
-  sha256Hex,
-  toPosixPath,
-  safeTimestampForPath,
-  compareVersions,
-  createDebugLogger,
-  BRAND_COLOR,
-};