coder-config 0.45.5 → 0.45.7

package/lib/cli.js

@@ -318,133 +318,152 @@ function runCli(manager) {
 }
 
 /**
- * Print help message
+ * Print help message with nice TUI formatting
  */
 function printHelp() {
   const showLoops = isRalphLoopsEnabled();
 
-  const loopHelp = showLoops ? `
-Loop Commands (Ralph Loop - autonomous development):
-  loop                       List all loops
-  loop create "Task"         Create new loop with task description
-  loop create "Task" --workstream <name>  Create loop in workstream context
-  loop start <id>            Start/resume a loop
-  loop pause <id>            Pause loop at next safe point
-  loop resume <id>           Resume paused loop
-  loop cancel <id>           Cancel loop
-  loop delete <id>           Delete loop and its data
-  loop approve <id>          Approve plan (when in plan phase)
-  loop complete <id>         Mark loop as complete
-  loop status [id]           Show status (active loop if no id)
-  loop active                Show current active loop
-  loop history               Show completed loops
-  loop config                Show loop configuration
-  loop config --max-iterations 50    Set max iterations
-  loop config --auto-approve-plan    Skip manual plan approval
-  loop inject [--silent]     Output loop context (for hooks)
-
-  Running a loop with Claude Code:
-    export CODER_LOOP_ID=<id>
-    claude --continue "Your task"
-` : '';
+  // ANSI color codes
+  const c = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    white: '\x1b[37m',
+  };
+
+  // Check if colors should be disabled
+  const noColor = process.env.NO_COLOR || process.env.TERM === 'dumb';
+  if (noColor) {
+    Object.keys(c).forEach(k => c[k] = '');
+  }
 
+  // Helper to format a command line
+  const cmd = (name, desc) => {
+    const paddedName = name.padEnd(32);
+    return `${c.cyan}${paddedName}${c.reset}${desc}`;
+  };
+
+  // Helper to create a boxed section
+  const box = (title, lines) => {
+    const maxLen = Math.max(...lines.map(l => l.replace(/\x1b\[[0-9;]*m/g, '').length), title.length + 4);
+    const width = Math.min(maxLen + 2, 80);
+    const top = `┌─ ${c.bold}${title}${c.reset} ${'─'.repeat(Math.max(0, width - title.length - 5))}┐`;
+    const bot = `└${'─'.repeat(width)}┘`;
+    const content = lines.map(l => {
+      const stripped = l.replace(/\x1b\[[0-9;]*m/g, '');
+      const padding = Math.max(0, width - stripped.length - 1);
+      return `│ ${l}${' '.repeat(padding)}│`;
+    }).join('\n');
+    return `${top}\n${content}\n${bot}`;
+  };
+
+  // Header
   console.log(`
-coder-config v${VERSION}
-Configuration manager for AI coding tools
-
-Usage:
-  coder-config <command> [args]
-  claude-config <command> [args]  (alias)
-
-Project Commands:
-  init                       Initialize project with .claude/mcps.json
-  apply                      Generate .mcp.json from config
-  show                       Show current project config
-  list                       List available MCPs (✓ = active)
-  add <mcp> [mcp...]         Add MCP(s) to project
-  remove <mcp> [mcp...]      Remove MCP(s) from project
-
-Memory Commands:
-  memory                     Show memory status
-  memory init                Initialize project memory
-  memory add <type> <content>  Add entry (types: preference, correction, fact,
-                             context, pattern, decision, issue, history)
-  memory search <query>      Search all memory files
-
-Environment Commands:
-  env                        List environment variables
-  env set <KEY> <value>      Set variable in .claude/.env
-  env unset <KEY>            Remove variable
-
-Project Commands (for UI):
-  project                    List registered projects
-  project add [path]         Add project (defaults to cwd)
-  project add [path] --name X  Add with custom display name
-  project remove <name|path> Remove project from registry
-
-Workstream Commands:
-  workstream                 List all workstreams
-  workstream create "Name"   Create new workstream
-  workstream delete <name>   Delete workstream
-  workstream use <name>      Set active workstream (global)
-  workstream active          Show current active workstream
-  workstream deactivate      Show how to deactivate workstream
-  workstream add <ws> <path>     Add project to workstream
-  workstream remove <ws> <path>  Remove project from workstream
-  workstream inject [--silent]   Output restriction + context (for hooks)
-  workstream detect [path]   Detect workstream for directory
-  workstream install-hook    Install pre-prompt hook for Claude Code
-  workstream install-hook --gemini   Install for Gemini CLI
-  workstream install-hook --codex    Install for Codex CLI
-  workstream install-hook --all      Install for all supported tools
-
-  Folder Auto-Activation:
-  workstream add-trigger <ws> <folder>    Add trigger folder
-  workstream remove-trigger <ws> <folder> Remove trigger folder
-  workstream auto-activate <ws> [on|off|default]  Set auto-activate
-  workstream check-folder [path] [--json] Check folder for matches
-  workstream install-cd-hook       Install cd hook for auto-activation
-  workstream uninstall-cd-hook     Remove cd hook
-  workstream cd-hook-status        Check if cd hook is installed
-
-  Per-session activation (enables parallel work):
-    export CODER_WORKSTREAM=<name-or-id>
-${loopHelp}
-Session Persistence:
-  session                    Show session status (saved context)
-  session install            Install hooks and /flush command
-  session clear              Clear saved session context
-
-Registry Commands:
-  registry                       List MCPs in global registry
-  registry add <name> '<json>'   Add MCP to global registry
-  registry remove <name>         Remove MCP from registry
-
-Maintenance:
-  migrate                    Migrate from ~/.claude-config to ~/.coder-config
-  migrate --force            Overwrite existing files in new location
-  migrate --remove           Remove legacy directory after migration
-  update                     Check npm for updates and install if available
-  update --check             Check for updates without installing
-  update /path/to/source     Update from local development source
-  ui [--port=3333]           Start web UI (daemon mode by default)
-  ui install                 Auto-start on login (macOS LaunchAgent)
-  ui uninstall               Remove auto-start
-  ui status                  Check if UI daemon is running
-  ui stop                    Stop the UI daemon
-  version                    Show version info
-
-Plugins (Claude Code CLI):
-  claude plugin marketplace add regression-io/coder-config-plugins
-  claude plugin install <name>@coder-config-plugins
-
-Examples:
-  coder-config init
-  coder-config add postgres github
-  coder-config memory add preference "Use TypeScript for new files"
-  coder-config env set GITHUB_TOKEN ghp_xxx
-  coder-config apply
+${c.yellow}Usage:${c.reset} ${c.bold}coder-config${c.reset} [OPTIONS] ${c.cyan}COMMAND${c.reset} [ARGS]...
+
+${c.dim}Configuration manager for AI coding tools (Claude Code, Gemini CLI, Codex CLI)${c.reset}
 `);
+
+  // Options section
+  console.log(box('Options', [
+    `${c.green}--version${c.reset}          ${c.dim}-v${c.reset}    Show version and exit`,
+    `${c.green}--help${c.reset}             ${c.dim}-h${c.reset}    Show this message and exit`,
+  ]));
+  console.log();
+
+  // Project Commands
+  console.log(box('Project', [
+    cmd('init', 'Initialize project with .claude/mcps.json'),
+    cmd('apply', 'Generate .mcp.json from config'),
+    cmd('show', 'Show current project config'),
+    cmd('list', 'List available MCPs (✓ = active)'),
+    cmd('add <mcp> [mcp...]', 'Add MCP(s) to project'),
+    cmd('remove <mcp> [mcp...]', 'Remove MCP(s) from project'),
+  ]));
+  console.log();
+
+  // Memory Commands
+  console.log(box('Memory', [
+    cmd('memory', 'Show memory status'),
+    cmd('memory init', 'Initialize project memory'),
+    cmd('memory add <type> <text>', 'Add entry to memory'),
+    cmd('memory search <query>', 'Search all memory files'),
+  ]));
+  console.log();
+
+  // Environment Commands
+  console.log(box('Environment', [
+    cmd('env', 'List environment variables'),
+    cmd('env set <KEY> <value>', 'Set variable in .claude/.env'),
+    cmd('env unset <KEY>', 'Remove variable'),
+  ]));
+  console.log();
+
+  // Registry Commands
+  console.log(box('Registry', [
+    cmd('registry', 'List MCPs in global registry'),
+    cmd('registry add <name> \'<json>\'', 'Add MCP to registry'),
+    cmd('registry remove <name>', 'Remove MCP from registry'),
+  ]));
+  console.log();
+
+  // Workstream Commands
+  console.log(box('Workstreams', [
+    cmd('workstream', 'List all workstreams'),
+    cmd('workstream create "Name"', 'Create new workstream'),
+    cmd('workstream delete <name>', 'Delete workstream'),
+    cmd('workstream use <name>', 'Set active workstream'),
+    cmd('workstream add <ws> <path>', 'Add project to workstream'),
+    cmd('workstream remove <ws> <path>', 'Remove from workstream'),
+    cmd('workstream install-hook', 'Install pre-prompt hook'),
+  ]));
+  console.log();
+
+  // Loop Commands (if enabled)
+  if (showLoops) {
+    console.log(box('Loops (Ralph Loop)', [
+      cmd('loop', 'List all loops'),
+      cmd('loop create "Task"', 'Create new loop'),
+      cmd('loop start <id>', 'Start/resume a loop'),
+      cmd('loop pause <id>', 'Pause loop'),
+      cmd('loop cancel <id>', 'Cancel loop'),
+      cmd('loop status [id]', 'Show loop status'),
+      cmd('loop config', 'Show/set loop config'),
+    ]));
+    console.log();
+  }
+
+  // Session Commands
+  console.log(box('Sessions', [
+    cmd('session', 'Show session status'),
+    cmd('session install', 'Install hooks and /flush'),
+    cmd('session clear', 'Clear saved context'),
+  ]));
+  console.log();
+
+  // UI & Maintenance
+  console.log(box('UI & Maintenance', [
+    cmd('ui', 'Start web UI (daemon mode)'),
+    cmd('ui install', 'Auto-start on login'),
+    cmd('ui status', 'Check daemon status'),
+    cmd('ui stop', 'Stop the daemon'),
+    cmd('update', 'Check and install updates'),
+    cmd('version', 'Show version info'),
+  ]));
+  console.log();
+
+  // Examples
+  console.log(`${c.yellow}Examples:${c.reset}`);
+  console.log(`  ${c.dim}$${c.reset} coder-config init`);
+  console.log(`  ${c.dim}$${c.reset} coder-config add postgres github`);
+  console.log(`  ${c.dim}$${c.reset} coder-config memory add preference "Use TypeScript"`);
+  console.log(`  ${c.dim}$${c.reset} coder-config ui`);
+  console.log();
 }
 
 module.exports = {

package/lib/constants.js

@@ -2,7 +2,7 @@
  * Constants and tool path configurations
  */
 
-const VERSION = '0.45.5';
+const VERSION = '0.45.7';
 
 // Tool-specific path configurations
 const TOOL_PATHS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coder-config",
-  "version": "0.45.5",
+  "version": "0.45.7",
   "description": "Configuration manager for AI coding tools - Claude Code, Gemini CLI, Codex CLI, Antigravity. Manage MCPs, rules, permissions, memory, and workstreams.",
   "author": "regression.io",
   "main": "config-loader.js",

package/ui/server.cjs

@@ -263,6 +263,32 @@ class ConfigUIServer {
       console.log(`📁 Project: ${this.projectDir}`);
       console.log(`💻 Terminal WebSocket: ws://localhost:${this.port}/ws/terminal\n`);
     });
+
+    // Watchdog: detect suspend/resume and restart if event loop was blocked
+    this.startSuspendWatchdog();
+  }
+
+  /**
+   * Watchdog to detect system suspend/resume
+   * If the event loop was blocked for too long (suspend), restart the server
+   */
+  startSuspendWatchdog() {
+    const HEARTBEAT_INTERVAL = 5000; // Check every 5 seconds
+    const SUSPEND_THRESHOLD = 30000; // 30 seconds gap = likely suspended
+    let lastHeartbeat = Date.now();
+
+    setInterval(() => {
+      const now = Date.now();
+      const elapsed = now - lastHeartbeat;
+
+      if (elapsed > SUSPEND_THRESHOLD) {
+        console.log(`[Watchdog] System resumed after ${Math.round(elapsed / 1000)}s suspend, restarting server...`);
+        // Exit with code 0 - launchd will restart us
+        process.exit(0);
+      }
+
+      lastHeartbeat = now;
+    }, HEARTBEAT_INTERVAL);
   }
 
   /**