@girardmedia/bootspring 2.2.0 → 2.3.0

package/core/utils.d.ts

@@ -1,90 +0,0 @@
-/**
- * Bootspring Utils Types
- * @module core/utils
- */
-
-export interface Spinner {
-  start(): Spinner;
-  stop(): Spinner;
-  succeed(text?: string): Spinner;
-  fail(text?: string): Spinner;
-  warn(text?: string): Spinner;
-  info(text?: string): Spinner;
-}
-
-export interface ParsedArgs {
-  _: string[];
-  [key: string]: string | boolean | string[] | undefined;
-}
-
-/** ANSI color codes */
-export const COLORS: {
-  reset: string;
-  bold: string;
-  dim: string;
-  red: string;
-  green: string;
-  yellow: string;
-  blue: string;
-  cyan: string;
-  magenta: string;
-};
-
-/** Print helpers */
-export const print: {
-  success(message: string): void;
-  error(message: string): void;
-  warning(message: string): void;
-  info(message: string): void;
-  dim(message: string): void;
-};
-
-/**
- * Parse command line arguments
- * @param args - Arguments array
- * @returns Parsed arguments object
- */
-export function parseArgs(args: string[]): ParsedArgs;
-
-/**
- * Create a CLI spinner
- * @param text - Spinner text
- * @returns Spinner instance
- */
-export function createSpinner(text: string): Spinner;
-
-/**
- * Format date for display
- * @param date - Date to format
- * @returns Formatted date string
- */
-export function formatDate(date: Date | string | number): string;
-
-/**
- * Format relative time
- * @param date - Date to format
- * @returns Relative time string (e.g., "2 hours ago")
- */
-export function formatRelativeTime(date: Date | string | number): string;
-
-/**
- * Check if file exists
- * @param filePath - Path to check
- * @returns True if file exists
- */
-export function fileExists(filePath: string): boolean;
-
-/**
- * Read file contents
- * @param filePath - Path to read
- * @returns File contents or null
- */
-export function readFile(filePath: string): string | null;
-
-/**
- * Create a formatted table
- * @param headers - Table headers
- * @param rows - Table rows
- * @returns Formatted table string
- */
-export function createTable(headers: string[], rows: string[][]): string;

package/core/utils.js

@@ -1,455 +0,0 @@
-/**
- * Bootspring Utilities
- * Shared utility functions
- *
- * @package bootspring
- * @module core/utils
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// ANSI color codes
-const COLORS = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-  italic: '\x1b[3m',
-  underline: '\x1b[4m',
-
-  // Foreground
-  black: '\x1b[30m',
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  magenta: '\x1b[35m',
-  cyan: '\x1b[36m',
-  white: '\x1b[37m',
-
-  // Background
-  bgBlack: '\x1b[40m',
-  bgRed: '\x1b[41m',
-  bgGreen: '\x1b[42m',
-  bgYellow: '\x1b[43m',
-  bgBlue: '\x1b[44m',
-  bgMagenta: '\x1b[45m',
-  bgCyan: '\x1b[46m',
-  bgWhite: '\x1b[47m'
-};
-
-/**
- * Styled console output
- */
-const print = {
-  info: (msg) => console.log(`${COLORS.cyan}ℹ${COLORS.reset} ${msg}`),
-  success: (msg) => console.log(`${COLORS.green}✓${COLORS.reset} ${msg}`),
-  warning: (msg) => console.log(`${COLORS.yellow}⚠${COLORS.reset} ${msg}`),
-  error: (msg) => console.log(`${COLORS.red}✗${COLORS.reset} ${msg}`),
-  debug: (msg) => process.env.DEBUG && console.log(`${COLORS.dim}⋯ ${msg}${COLORS.reset}`),
-  header: (msg) => console.log(`\n${COLORS.bold}${COLORS.cyan}${msg}${COLORS.reset}\n`),
-  dim: (msg) => console.log(`${COLORS.dim}${msg}${COLORS.reset}`),
-  brand: (msg) => console.log(`${COLORS.cyan}⚡${COLORS.reset} ${msg}`)
-};
-
-/**
- * Create a spinner for async operations
- * @param {string} message - Spinner message
- * @returns {object} Spinner controller
- */
-function createSpinner(message) {
-  const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-  let frameIndex = 0;
-  let interval = null;
-  const isTTY = process.stdout.isTTY;
-
-  // Helper to clear line safely
-  const clearLine = () => {
-    if (isTTY && process.stdout.clearLine) {
-      process.stdout.clearLine(0);
-      process.stdout.cursorTo(0);
-    }
-  };
-
-  return {
-    start() {
-      if (isTTY) {
-        process.stdout.write(`${COLORS.cyan}${frames[0]}${COLORS.reset} ${message}`);
-        interval = setInterval(() => {
-          frameIndex = (frameIndex + 1) % frames.length;
-          clearLine();
-          process.stdout.write(`${COLORS.cyan}${frames[frameIndex]}${COLORS.reset} ${message}`);
-        }, 80);
-      }
-      return this;
-    },
-
-    succeed(text = message) {
-      if (interval) clearInterval(interval);
-      clearLine();
-      console.log(`${COLORS.green}✓${COLORS.reset} ${text}`);
-      return this;
-    },
-
-    fail(text = message) {
-      if (interval) clearInterval(interval);
-      clearLine();
-      console.log(`${COLORS.red}✗${COLORS.reset} ${text}`);
-      return this;
-    },
-
-    warn(text = message) {
-      if (interval) clearInterval(interval);
-      clearLine();
-      console.log(`${COLORS.yellow}⚠${COLORS.reset} ${text}`);
-      return this;
-    },
-
-    info(text = message) {
-      if (interval) clearInterval(interval);
-      clearLine();
-      console.log(`${COLORS.cyan}ℹ${COLORS.reset} ${text}`);
-      return this;
-    },
-
-    stop() {
-      if (interval) clearInterval(interval);
-      clearLine();
-      return this;
-    }
-  };
-}
-
-/**
- * Ensure directory exists
- * @param {string} dirPath - Directory path
- * @returns {boolean} Success status
- */
-function ensureDir(dirPath) {
-  try {
-    if (!fs.existsSync(dirPath)) {
-      fs.mkdirSync(dirPath, { recursive: true });
-    }
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Read file safely
- * @param {string} filepath - File path
- * @param {string} [defaultValue=null] - Default value if file doesn't exist
- * @returns {string|null} File contents or default value (null if not found)
- */
-function readFile(filepath, defaultValue = null) {
-  try {
-    return fs.readFileSync(filepath, 'utf-8');
-  } catch {
-    return defaultValue;
-  }
-}
-
-/**
- * Write file safely
- * @param {string} filepath - File path
- * @param {string} content - File content
- * @returns {boolean} Success status
- */
-function writeFile(filepath, content) {
-  try {
-    const dir = path.dirname(filepath);
-    ensureDir(dir);
-    fs.writeFileSync(filepath, content, 'utf-8');
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Check if file exists
- * @param {string} filepath - File path
- * @returns {boolean} Exists status
- */
-function fileExists(filepath) {
-  try {
-    return fs.existsSync(filepath);
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Get file modification time
- * @param {string} filepath - File path
- * @returns {Date|null} Modification date or null
- */
-function getFileTime(filepath) {
-  try {
-    const stats = fs.statSync(filepath);
-    return stats.mtime;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Format date as ISO string without time
- * @param {Date} date - Date object
- * @returns {string} Formatted date
- */
-function formatDate(date = new Date()) {
-  return date.toISOString().split('T')[0];
-}
-
-/**
- * Format date as relative time
- * @param {Date} date - Date object
- * @returns {string} Relative time string
- */
-function formatRelativeTime(date) {
-  const now = new Date();
-  const diff = now - date;
-  const seconds = Math.floor(diff / 1000);
-  const minutes = Math.floor(seconds / 60);
-  const hours = Math.floor(minutes / 60);
-  const days = Math.floor(hours / 24);
-
-  if (days > 0) return `${days} day${days > 1 ? 's' : ''} ago`;
-  if (hours > 0) return `${hours} hour${hours > 1 ? 's' : ''} ago`;
-  if (minutes > 0) return `${minutes} minute${minutes > 1 ? 's' : ''} ago`;
-  return 'just now';
-}
-
-/**
- * Slugify a string
- * @param {string} str - Input string
- * @returns {string} Slugified string
- */
-function slugify(str) {
-  return str
-    .toLowerCase()
-    .trim()
-    .replace(/[^\w\s-]/g, '')
-    .replace(/[\s_-]+/g, '-')
-    .replace(/^-+|-+$/g, '');
-}
-
-/**
- * Truncate string with ellipsis
- * @param {string} str - Input string
- * @param {number} length - Max length
- * @returns {string} Truncated string
- */
-function truncate(str, length = 50) {
-  if (str.length <= length) return str;
-  return str.slice(0, length - 3) + '...';
-}
-
-/**
- * Parse command line arguments
- * @param {string[]} args - Argument array
- * @returns {object} Parsed arguments { _: positional, ...flags }
- */
-function parseArgs(args) {
-  const result = { _: [] };
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-
-    if (arg.startsWith('--')) {
-      const key = arg.slice(2);
-      const nextArg = args[i + 1];
-
-      if (key.includes('=')) {
-        const [k, v] = key.split('=');
-        result[k] = v;
-      } else if (nextArg && !nextArg.startsWith('-')) {
-        result[key] = nextArg;
-        i++;
-      } else {
-        result[key] = true;
-      }
-    } else if (arg.startsWith('-') && arg.length === 2) {
-      // Short flag (e.g., -v, -n)
-      const key = arg.slice(1);
-      const nextArg = args[i + 1];
-
-      // Check if next argument is a value (not another flag)
-      if (nextArg && !nextArg.startsWith('-')) {
-        result[key] = nextArg;
-        i++;
-      } else {
-        result[key] = true;
-      }
-    } else if (arg.startsWith('-')) {
-      // Combined short flags (e.g., -abc) - treat each as boolean
-      const keys = arg.slice(1).split('');
-      for (const key of keys) {
-        result[key] = true;
-      }
-    } else {
-      result._.push(arg);
-    }
-  }
-
-  return result;
-}
-
-/**
- * Create a simple table for console output
- * @param {string[]} headers - Table headers
- * @param {string[][]} rows - Table rows
- * @returns {string} Formatted table
- */
-function createTable(headers, rows) {
-  const widths = headers.map((h, i) => {
-    const colValues = [h, ...rows.map(r => String(r[i] || ''))];
-    return Math.max(...colValues.map(v => v.length));
-  });
-
-  const separator = widths.map(w => '─'.repeat(w + 2)).join('┼');
-  const formatRow = (row) => row.map((cell, i) => ` ${String(cell).padEnd(widths[i])} `).join('│');
-
-  const lines = [
-    formatRow(headers),
-    separator,
-    ...rows.map(formatRow)
-  ];
-
-  return lines.join('\n');
-}
-
-/**
- * Deep clone an object
- * @param {object} obj - Object to clone
- * @returns {object} Cloned object
- */
-function deepClone(obj) {
-  return JSON.parse(JSON.stringify(obj));
-}
-
-/**
- * Check if running in CI environment
- * @returns {boolean} CI status
- */
-function isCI() {
-  return !!(
-    process.env.CI ||
-    process.env.CONTINUOUS_INTEGRATION ||
-    process.env.GITHUB_ACTIONS ||
-    process.env.GITLAB_CI ||
-    process.env.CIRCLECI ||
-    process.env.TRAVIS
-  );
-}
-
-/**
- * Get package.json from project
- * @param {string} projectRoot - Project root path
- * @returns {object|null} Package.json contents or null
- */
-function getPackageJson(projectRoot) {
-  const pkgPath = path.join(projectRoot, 'package.json');
-  try {
-    return JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Check if running in MCP context (AI assistant integration only)
- * @returns {boolean} MCP status
- */
-function isMCPContext() {
-  return !!(
-    process.env.BOOTSPRING_MCP ||
-    process.env.MCP_SERVER ||
-    process.env.CLAUDE_CODE_MCP
-  );
-}
-
-/**
- * Print MCP recommendation message and return false if not in MCP context.
- * This is a soft gate - callers should provide degraded functionality.
- * @param {string} feature - Feature name that benefits from MCP
- * @param {Object} options - Configuration options
- * @param {boolean} options.silent - Don't print any message
- * @param {boolean} options.brief - Print brief message instead of full
- * @returns {boolean} True if in MCP context, false otherwise
- */
-function requireMCP(feature, options = {}) {
-  if (isMCPContext()) {
-    return true;
-  }
-
-  if (options.silent) {
-    return false;
-  }
-
-  if (options.brief) {
-    console.log(`${COLORS.dim}Note: ${feature} has enhanced features when used with MCP integration.${COLORS.reset}`);
-    console.log(`${COLORS.dim}Run "bootspring mcp" for setup instructions.${COLORS.reset}\n`);
-    return false;
-  }
-
-  console.log(`
-${COLORS.yellow}${COLORS.bold}Limited Mode - MCP Integration Recommended${COLORS.reset}
-
-${feature} works in CLI mode but has enhanced features through MCP integration.
-MCP enables real-time AI-assisted workflows and deeper integration.
-
-${COLORS.bold}Current Mode:${COLORS.reset} CLI (limited functionality)
-${COLORS.bold}Enhanced Mode:${COLORS.reset} MCP (full AI integration)
-
-${COLORS.bold}To enable full features:${COLORS.reset}
-  1. Start the MCP server:
-     ${COLORS.cyan}bootspring mcp start${COLORS.reset}
-
-  2. Add Bootspring to your AI client's MCP configuration
-
-${COLORS.bold}Documentation:${COLORS.reset}
-  https://bootspring.com/docs/mcp-setup
-
-${COLORS.dim}Run "bootspring mcp" for server options${COLORS.reset}
-`);
-
-  return false;
-}
-
-/**
- * Print a warning about MCP-only features (non-blocking)
- * Use this when a command works without MCP but has reduced functionality
- * @param {string} feature - Feature with limited functionality
- */
-function warnMCPLimited(feature) {
-  if (isMCPContext()) return;
-
-  console.log(`${COLORS.dim}Note: ${feature} - some features require MCP integration.${COLORS.reset}`);
-  console.log(`${COLORS.dim}Run "bootspring mcp" for setup instructions.${COLORS.reset}\n`);
-}
-
-module.exports = {
-  COLORS,
-  print,
-  createSpinner,
-  ensureDir,
-  readFile,
-  writeFile,
-  fileExists,
-  getFileTime,
-  formatDate,
-  formatRelativeTime,
-  slugify,
-  truncate,
-  parseArgs,
-  createTable,
-  deepClone,
-  isCI,
-  getPackageJson,
-  isMCPContext,
-  requireMCP,
-  warnMCPLimited
-};