@girardmedia/bootspring 2.1.3 → 2.2.1

package/cli/todo.js

@@ -1,629 +0,0 @@
-/**
- * Bootspring Todo Command
- * Simple and powerful todo management
- *
- * @package bootspring
- * @command todo
- */
-
-const fs = require('fs');
-const path = require('path');
-const config = require('../core/config');
-const utils = require('../core/utils');
-const { validateTodoText, validateNumericId } = require('../core/validation');
-
-// ============================================================================
-// Utility Functions (for programmatic/test use)
-// ============================================================================
-
-/**
- * Parse todo file and return todos
- * @param {string} filePath - Path to todo file
- * @returns {object[]} Array of todos with { done, text } format
- */
-function parseTodoFile(filePath) {
-  try {
-    const content = fs.readFileSync(filePath, 'utf-8');
-    const todos = [];
-    const lines = content.split('\n');
-
-    for (const line of lines) {
-      const match = line.match(/^(\s*)-\s*\[([ xX])\]\s*(.+)$/);
-      if (match) {
-        todos.push({
-          done: match[2].toLowerCase() === 'x',
-          text: match[3].trim()
-        });
-      }
-    }
-
-    return todos;
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Write todos to file
- * @param {string} filePath - Path to todo file
- * @param {object[]} items - Array of todos with { done, text } format
- */
-function writeTodoFile(filePath, items) {
-  const lines = ['# Todo', ''];
-
-  for (const item of items) {
-    const checkbox = item.done ? '[x]' : '[ ]';
-    lines.push(`- ${checkbox} ${item.text}`);
-  }
-
-  lines.push(''); // trailing newline
-  fs.writeFileSync(filePath, lines.join('\n'), 'utf-8');
-}
-
-/**
- * Add a todo to file (utility function)
- * @param {string} filePath - Path to todo file
- * @param {string} text - Todo text
- */
-function addTodoUtil(filePath, text) {
-  const todos = parseTodoFile(filePath);
-  todos.push({ done: false, text });
-  writeTodoFile(filePath, todos);
-}
-
-/**
- * Mark a todo as done (utility function)
- * @param {string} filePath - Path to todo file
- * @param {number} index - Zero-based index
- */
-function markDone(filePath, index) {
-  const todos = parseTodoFile(filePath);
-  if (index >= 0 && index < todos.length) {
-    todos[index].done = true;
-    writeTodoFile(filePath, todos);
-  }
-}
-
-/**
- * Mark a todo as not done (utility function)
- * @param {string} filePath - Path to todo file
- * @param {number} index - Zero-based index
- */
-function markUndone(filePath, index) {
-  const todos = parseTodoFile(filePath);
-  if (index >= 0 && index < todos.length) {
-    todos[index].done = false;
-    writeTodoFile(filePath, todos);
-  }
-}
-
-/**
- * Remove a todo by index (utility function)
- * @param {string} filePath - Path to todo file
- * @param {number} index - Zero-based index
- */
-function removeTodoUtil(filePath, index) {
-  const todos = parseTodoFile(filePath);
-  if (index >= 0 && index < todos.length) {
-    todos.splice(index, 1);
-    writeTodoFile(filePath, todos);
-  }
-}
-
-/**
- * Clear todos (utility function)
- * @param {string} filePath - Path to todo file
- * @param {string} type - 'completed' or 'all'
- */
-function clearTodos(filePath, type = 'completed') {
-  const todos = parseTodoFile(filePath);
-
-  if (type === 'all') {
-    writeTodoFile(filePath, []);
-  } else if (type === 'completed') {
-    const remaining = todos.filter(t => !t.done);
-    writeTodoFile(filePath, remaining);
-  }
-}
-
-/**
- * List all todos from file (utility function)
- * @param {string} filePath - Path to todo file
- * @returns {object[]} Array of todos
- */
-function listTodosUtil(filePath) {
-  return parseTodoFile(filePath);
-}
-
-// ============================================================================
-// Internal Parsing (for CLI use)
-// ============================================================================
-
-/**
- * Parse todo.md file content
- * @param {string} content - File content
- * @returns {object[]} Array of todos with full metadata
- */
-function parseTodos(content) {
-  const todos = [];
-  const lines = content.split('\n');
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-
-    // Match todo items: - [ ] or - [x]
-    const match = line.match(/^(\s*)-\s*\[([ xX])\]\s*(.+)$/);
-    if (match) {
-      todos.push({
-        index: todos.length + 1,
-        indent: match[1].length,
-        completed: match[2].toLowerCase() === 'x',
-        text: match[3].trim(),
-        line: i
-      });
-    }
-  }
-
-  return todos;
-}
-
-/**
- * Format todos for display
- * @param {object[]} todos - Array of todos
- * @param {object} options - Display options
- */
-function displayTodos(todos, options = {}) {
-  const { showCompleted = true, showIndex = true } = options;
-
-  const pending = todos.filter(t => !t.completed);
-  const completed = todos.filter(t => t.completed);
-
-  if (pending.length === 0 && completed.length === 0) {
-    utils.print.dim('No todos found. Add one with: bootspring todo add "Your task"');
-    return;
-  }
-
-  // Display pending
-  if (pending.length > 0) {
-    console.log(`\n${utils.COLORS.bold}Pending (${pending.length})${utils.COLORS.reset}\n`);
-    for (const todo of pending) {
-      const index = showIndex ? `${utils.COLORS.dim}${String(todo.index).padStart(2)}${utils.COLORS.reset} ` : '';
-      const indent = ' '.repeat(todo.indent);
-      console.log(`${index}${indent}${utils.COLORS.yellow}○${utils.COLORS.reset} ${todo.text}`);
-    }
-  }
-
-  // Display completed
-  if (showCompleted && completed.length > 0) {
-    console.log(`\n${utils.COLORS.bold}Completed (${completed.length})${utils.COLORS.reset}\n`);
-    for (const todo of completed) {
-      const index = showIndex ? `${utils.COLORS.dim}${String(todo.index).padStart(2)}${utils.COLORS.reset} ` : '';
-      const indent = ' '.repeat(todo.indent);
-      console.log(`${index}${indent}${utils.COLORS.green}●${utils.COLORS.reset} ${utils.COLORS.dim}${todo.text}${utils.COLORS.reset}`);
-    }
-  }
-
-  console.log();
-}
-
-/**
- * Get todo file path
- * @returns {string} Todo file path
- */
-function getTodoPath() {
-  const cfg = config.load();
-  return path.join(cfg._projectRoot, cfg.paths?.todo || 'todo.md');
-}
-
-/**
- * Read todo file
- * @returns {string} File content
- */
-function readTodoFile() {
-  const todoPath = getTodoPath();
-  if (!utils.fileExists(todoPath)) {
-    // Create default todo file
-    const defaultContent = '# Todo List\n\n## Pending\n\n## Completed\n';
-    utils.writeFile(todoPath, defaultContent);
-    return defaultContent;
-  }
-  return utils.readFile(todoPath);
-}
-
-/**
- * Save todo file content (internal CLI use)
- * @param {string} content - File content
- */
-function saveTodoContent(content) {
-  const todoPath = getTodoPath();
-  utils.writeFile(todoPath, content);
-}
-
-/**
- * List all todos
- */
-function listTodos(args) {
-  const parsedArgs = utils.parseArgs(args);
-  const content = readTodoFile();
-  const todos = parseTodos(content);
-
-  console.log(`${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Bootspring Todo${utils.COLORS.reset}`);
-
-  displayTodos(todos, {
-    showCompleted: !parsedArgs.pending,
-    showIndex: true
-  });
-
-  // Summary
-  const pending = todos.filter(t => !t.completed).length;
-  const completed = todos.filter(t => t.completed).length;
-  utils.print.dim(`${pending} pending, ${completed} completed`);
-}
-
-/**
- * Add a new todo
- */
-function addTodo(args) {
-  const rawText = args.join(' ').trim();
-
-  if (!rawText) {
-    utils.print.error('Please provide a todo text');
-    utils.print.dim('Usage: bootspring todo add "Your task"');
-    return;
-  }
-
-  // Validate and sanitize todo text
-  const validation = validateTodoText(rawText);
-  if (!validation.valid) {
-    utils.print.error(`Invalid todo text: ${validation.error}`);
-    return;
-  }
-  const text = validation.sanitized;
-
-  const content = readTodoFile();
-  const lines = content.split('\n');
-
-  // Find the "Pending" section or add after first heading
-  let insertIndex = -1;
-  for (let i = 0; i < lines.length; i++) {
-    if (lines[i].match(/^##?\s*(Pending|In Progress|Todo)/i)) {
-      insertIndex = i + 1;
-      // Skip empty lines after heading
-      while (insertIndex < lines.length && lines[insertIndex].trim() === '') {
-        insertIndex++;
-      }
-      break;
-    }
-  }
-
-  // If no section found, add after first heading
-  if (insertIndex === -1) {
-    for (let i = 0; i < lines.length; i++) {
-      if (lines[i].startsWith('#')) {
-        insertIndex = i + 1;
-        break;
-      }
-    }
-  }
-
-  // If still no good place, add at the end
-  if (insertIndex === -1) {
-    insertIndex = lines.length;
-  }
-
-  // Insert the new todo
-  const newTodo = `- [ ] ${text}`;
-  lines.splice(insertIndex, 0, newTodo);
-
-  saveTodoContent(lines.join('\n'));
-
-  utils.print.success(`Added: ${text}`);
-
-  // Show count
-  const todos = parseTodos(lines.join('\n'));
-  const pending = todos.filter(t => !t.completed).length;
-  utils.print.dim(`${pending} pending todos`);
-}
-
-/**
- * Mark todo as done
- */
-function doneTodo(args) {
-  const indexStr = args[0];
-
-  if (!indexStr) {
-    utils.print.error('Please provide a todo number');
-    utils.print.dim('Usage: bootspring todo done <number>');
-    return;
-  }
-
-  // Validate numeric ID
-  const validation = validateNumericId(indexStr, { min: 1 });
-  if (!validation.valid) {
-    utils.print.error(`Invalid todo number: ${validation.error}`);
-    return;
-  }
-  const index = validation.value;
-
-  const content = readTodoFile();
-  const todos = parseTodos(content);
-
-  const todo = todos.find(t => t.index === index);
-  if (!todo) {
-    utils.print.error(`Todo #${index} not found`);
-    return;
-  }
-
-  if (todo.completed) {
-    utils.print.warning(`Todo #${index} is already completed`);
-    return;
-  }
-
-  // Update the line
-  const lines = content.split('\n');
-  const originalLine = lines[todo.line];
-  lines[todo.line] = originalLine.replace('[ ]', '[x]');
-
-  saveTodoContent(lines.join('\n'));
-
-  utils.print.success(`Completed: ${todo.text}`);
-
-  // Show remaining
-  const remaining = todos.filter(t => !t.completed && t.index !== index).length;
-  utils.print.dim(`${remaining} pending todos remaining`);
-}
-
-/**
- * Undo a completed todo
- */
-function undoTodo(args) {
-  const indexStr = args[0];
-
-  if (!indexStr) {
-    utils.print.error('Please provide a todo number');
-    utils.print.dim('Usage: bootspring todo undo <number>');
-    return;
-  }
-
-  // Validate numeric ID
-  const validation = validateNumericId(indexStr, { min: 1 });
-  if (!validation.valid) {
-    utils.print.error(`Invalid todo number: ${validation.error}`);
-    return;
-  }
-  const index = validation.value;
-
-  const content = readTodoFile();
-  const todos = parseTodos(content);
-
-  const todo = todos.find(t => t.index === index);
-  if (!todo) {
-    utils.print.error(`Todo #${index} not found`);
-    return;
-  }
-
-  if (!todo.completed) {
-    utils.print.warning(`Todo #${index} is not completed`);
-    return;
-  }
-
-  // Update the line
-  const lines = content.split('\n');
-  const originalLine = lines[todo.line];
-  lines[todo.line] = originalLine.replace(/\[[xX]\]/, '[ ]');
-
-  saveTodoContent(lines.join('\n'));
-
-  utils.print.success(`Reopened: ${todo.text}`);
-}
-
-/**
- * Remove a todo
- */
-function removeTodo(args) {
-  const indexStr = args[0];
-
-  if (!indexStr) {
-    utils.print.error('Please provide a todo number');
-    utils.print.dim('Usage: bootspring todo remove <number>');
-    return;
-  }
-
-  // Validate numeric ID
-  const validation = validateNumericId(indexStr, { min: 1 });
-  if (!validation.valid) {
-    utils.print.error(`Invalid todo number: ${validation.error}`);
-    return;
-  }
-  const index = validation.value;
-
-  const content = readTodoFile();
-  const todos = parseTodos(content);
-
-  const todo = todos.find(t => t.index === index);
-  if (!todo) {
-    utils.print.error(`Todo #${index} not found`);
-    return;
-  }
-
-  // Remove the line
-  const lines = content.split('\n');
-  lines.splice(todo.line, 1);
-
-  saveTodoContent(lines.join('\n'));
-
-  utils.print.success(`Removed: ${todo.text}`);
-}
-
-/**
- * Clear completed todos
- */
-function clearCompleted() {
-  const content = readTodoFile();
-  const todos = parseTodos(content);
-  const completedTodos = todos.filter(t => t.completed);
-
-  if (completedTodos.length === 0) {
-    utils.print.info('No completed todos to clear');
-    return;
-  }
-
-  // Remove completed lines (in reverse order to maintain indices)
-  const lines = content.split('\n');
-  const linesToRemove = completedTodos.map(t => t.line).sort((a, b) => b - a);
-
-  for (const lineIndex of linesToRemove) {
-    lines.splice(lineIndex, 1);
-  }
-
-  saveTodoContent(lines.join('\n'));
-
-  utils.print.success(`Cleared ${completedTodos.length} completed todos`);
-}
-
-/**
- * Show todo help
- */
-function showHelp() {
-  console.log(`
-${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Bootspring Todo${utils.COLORS.reset}
-${utils.COLORS.dim}Simple and powerful todo management${utils.COLORS.reset}
-
-${utils.COLORS.bold}Usage:${utils.COLORS.reset}
-  bootspring todo <command> [args]
-
-${utils.COLORS.bold}Commands:${utils.COLORS.reset}
-  ${utils.COLORS.cyan}list${utils.COLORS.reset}              List all todos
-  ${utils.COLORS.cyan}add${utils.COLORS.reset} <text>       Add a new todo
-  ${utils.COLORS.cyan}done${utils.COLORS.reset} <number>    Mark todo as completed
-  ${utils.COLORS.cyan}undo${utils.COLORS.reset} <number>    Reopen a completed todo
-  ${utils.COLORS.cyan}remove${utils.COLORS.reset} <number>  Remove a todo
-  ${utils.COLORS.cyan}clear${utils.COLORS.reset}            Clear all completed todos
-
-${utils.COLORS.bold}Examples:${utils.COLORS.reset}
-  bootspring todo add "Implement user auth"
-  bootspring todo done 1
-  bootspring todo list --pending
-  bootspring todo clear
-`);
-}
-
-/**
- * Run todo command
- */
-async function run(args) {
-  const subcommand = args[0] || 'list';
-  const subargs = args.slice(1);
-
-  switch (subcommand) {
-    case 'list':
-    case 'ls':
-      listTodos(subargs);
-      break;
-
-    case 'add':
-    case 'a':
-    case 'new':
-      addTodo(subargs);
-      break;
-
-    case 'done':
-    case 'd':
-    case 'complete':
-    case 'check':
-      doneTodo(subargs);
-      break;
-
-    case 'undo':
-    case 'u':
-    case 'reopen':
-      undoTodo(subargs);
-      break;
-
-    case 'remove':
-    case 'rm':
-    case 'delete':
-      removeTodo(subargs);
-      break;
-
-    case 'clear':
-      clearCompleted();
-      break;
-
-    case 'help':
-    case '-h':
-    case '--help':
-      showHelp();
-      break;
-
-    default:
-      // If it looks like a todo text, treat as add
-      if (subcommand && !subcommand.startsWith('-')) {
-        addTodo([subcommand, ...subargs]);
-      } else {
-        utils.print.error(`Unknown subcommand: ${subcommand}`);
-        showHelp();
-      }
-  }
-}
-
-// Smart wrapper that detects if called with file path or CLI args
-function addTodoSmart(firstArg, secondArg) {
-  if (typeof firstArg === 'string' && typeof secondArg === 'string') {
-    // Utility mode: addTodo(filePath, text)
-    return addTodoUtil(firstArg, secondArg);
-  } else if (Array.isArray(firstArg)) {
-    // CLI mode: addTodo(args)
-    return addTodo(firstArg);
-  } else {
-    // Default CLI mode with single arg treated as array
-    return addTodo([firstArg, secondArg].filter(Boolean));
-  }
-}
-
-function removeTodoSmart(firstArg, secondArg) {
-  if (typeof firstArg === 'string' && typeof secondArg === 'number') {
-    // Utility mode: removeTodo(filePath, index)
-    return removeTodoUtil(firstArg, secondArg);
-  } else if (Array.isArray(firstArg)) {
-    // CLI mode: removeTodo(args)
-    return removeTodo(firstArg);
-  } else {
-    return removeTodo([firstArg]);
-  }
-}
-
-function listTodosSmart(firstArg) {
-  if (typeof firstArg === 'string' && (firstArg.includes('/') || firstArg.includes('\\'))) {
-    // Utility mode: listTodos(filePath)
-    return listTodosUtil(firstArg);
-  } else if (Array.isArray(firstArg)) {
-    // CLI mode: listTodos(args)
-    return listTodos(firstArg);
-  } else {
-    return listTodos([firstArg].filter(Boolean));
-  }
-}
-
-module.exports = {
-  // CLI command runner
-  run,
-
-  // CLI-focused internal functions
-  parseTodos,
-  doneTodo,
-  undoTodo,
-  clearCompleted,
-
-  // Utility functions (for programmatic/test use)
-  parseTodoFile,
-  writeTodoFile,
-  markDone,
-  markUndone,
-  clearTodos,
-
-  // Smart wrappers that work in both modes
-  addTodo: addTodoSmart,
-  removeTodo: removeTodoSmart,
-  listTodos: listTodosSmart
-};