claude-code-workflow 6.1.4 → 6.2.2

package/ccw/src/cli.ts

@@ -0,0 +1,244 @@
+import { Command } from 'commander';
+import { viewCommand } from './commands/view.js';
+import { serveCommand } from './commands/serve.js';
+import { stopCommand } from './commands/stop.js';
+import { installCommand } from './commands/install.js';
+import { uninstallCommand } from './commands/uninstall.js';
+import { upgradeCommand } from './commands/upgrade.js';
+import { listCommand } from './commands/list.js';
+import { toolCommand } from './commands/tool.js';
+import { sessionCommand } from './commands/session.js';
+import { cliCommand } from './commands/cli.js';
+import { memoryCommand } from './commands/memory.js';
+import { coreMemoryCommand } from './commands/core-memory.js';
+import { hookCommand } from './commands/hook.js';
+import { readFileSync, existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+interface PackageInfo {
+  name: string;
+  version: string;
+  description?: string;
+  [key: string]: unknown;
+}
+
+/**
+ * Load package.json with error handling
+ * @returns Package info with version
+ */
+function loadPackageInfo(): PackageInfo {
+  const pkgPath = join(__dirname, '../package.json');
+
+  try {
+    if (!existsSync(pkgPath)) {
+      console.error('Fatal Error: package.json not found.');
+      console.error(`Expected location: ${pkgPath}`);
+      process.exit(1);
+    }
+
+    const content = readFileSync(pkgPath, 'utf8');
+    return JSON.parse(content) as PackageInfo;
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      console.error('Fatal Error: package.json contains invalid JSON.');
+      console.error(`Parse error: ${error.message}`);
+    } else if (error instanceof Error) {
+      console.error('Fatal Error: Could not read package.json.');
+      console.error(`Error: ${error.message}`);
+    }
+    process.exit(1);
+  }
+}
+
+const pkg = loadPackageInfo();
+
+export function run(argv: string[]): void {
+  const program = new Command();
+
+  program
+    .name('ccw')
+    .description('Claude Code Workflow CLI - Dashboard and workflow tools')
+    .version(pkg.version);
+
+  // View command (server mode with live path switching)
+  program
+    .command('view')
+    .description('Open workflow dashboard server with live path switching')
+    .option('-p, --path <path>', 'Path to project directory', '.')
+    .option('--port <port>', 'Server port', '3456')
+    .option('--no-browser', 'Start server without opening browser')
+    .action(viewCommand);
+
+  // Serve command (alias for view)
+  program
+    .command('serve')
+    .description('Alias for view command')
+    .option('-p, --path <path>', 'Initial project directory')
+    .option('--port <port>', 'Server port', '3456')
+    .option('--no-browser', 'Start server without opening browser')
+    .action(serveCommand);
+
+  // Stop command
+  program
+    .command('stop')
+    .description('Stop the running CCW dashboard server')
+    .option('--port <port>', 'Server port', '3456')
+    .option('-f, --force', 'Force kill process on the port')
+    .action(stopCommand);
+
+  // Install command
+  program
+    .command('install')
+    .description('Install Claude Code Workflow to your system (includes .codex/prompts)')
+    .option('-m, --mode <mode>', 'Installation mode: Global or Path')
+    .option('-p, --path <path>', 'Installation path (for Path mode)')
+    .option('-f, --force', 'Force installation without prompts')
+    .action(installCommand);
+
+  // Uninstall command
+  program
+    .command('uninstall')
+    .description('Uninstall Claude Code Workflow')
+    .action(uninstallCommand);
+
+  // Upgrade command
+  program
+    .command('upgrade')
+    .description('Upgrade Claude Code Workflow installations')
+    .option('-a, --all', 'Upgrade all installations without prompting')
+    .action(upgradeCommand);
+
+  // List command
+  program
+    .command('list')
+    .description('List all installed Claude Code Workflow instances')
+    .action(listCommand);
+
+  // Tool command
+  program
+    .command('tool [subcommand] [args...]')
+    .description('Execute CCW tools')
+    .option('--path <path>', 'File path (for edit_file)')
+    .option('--old <text>', 'Old text to replace (for edit_file)')
+    .option('--new <text>', 'New text (for edit_file)')
+    .option('--action <action>', 'Action to perform (for codex_lens)')
+    .option('--query <query>', 'Search query (for codex_lens)')
+    .option('--limit <n>', 'Max results (for codex_lens)', '20')
+    .option('--file <file>', 'File path for symbol extraction (for codex_lens)')
+    .option('--files <files>', 'Comma-separated file paths (for codex_lens update)')
+    .option('--languages <langs>', 'Comma-separated languages (for codex_lens init)')
+    .action((subcommand, args, options) => toolCommand(subcommand, args, options));
+
+  // Session command
+  program
+    .command('session [subcommand] [args...]')
+    .description('Workflow session lifecycle management')
+    .option('--location <loc>', 'Session location: active|lite-plan|lite-fix (init); Filter: active|archived|both (list)')
+    .option('--type <type>', 'Content type or session type')
+    .option('--content <json>', 'Content for write/update')
+    .option('--task-id <id>', 'Task ID for task content')
+    .option('--filename <name>', 'Filename for process/chat/etc')
+    .option('--dimension <dim>', 'Dimension for review-dim')
+    .option('--iteration <iter>', 'Iteration for review-iter')
+    .option('--subdir <dir>', 'Subdirectory for mkdir')
+    .option('--raw', 'Output raw content only')
+    .option('--no-metadata', 'Exclude metadata from list')
+    .option('--no-update-status', 'Skip status update on archive')
+    .action((subcommand, args, options) => sessionCommand(subcommand, args, options));
+
+  // CLI command
+  program
+    .command('cli [subcommand] [args...]')
+    .description('Unified CLI tool executor (gemini/qwen/codex/claude)')
+    .option('-p, --prompt <prompt>', 'Prompt text (alternative to positional argument)')
+    .option('-f, --file <file>', 'Read prompt from file (best for multi-line prompts)')
+    .option('--tool <tool>', 'CLI tool to use', 'gemini')
+    .option('--mode <mode>', 'Execution mode: analysis, write, auto', 'analysis')
+    .option('--model <model>', 'Model override')
+    .option('--cd <path>', 'Working directory')
+    .option('--includeDirs <dirs>', 'Additional directories (--include-directories for gemini/qwen, --add-dir for codex/claude)')
+    .option('--timeout <ms>', 'Timeout in milliseconds', '300000')
+    .option('--no-stream', 'Disable streaming output')
+    .option('--limit <n>', 'History limit')
+    .option('--status <status>', 'Filter by status')
+    .option('--category <category>', 'Execution category: user, internal, insight', 'user')
+    .option('--resume [id]', 'Resume previous session (empty=last, or execution ID, or comma-separated IDs for merge)')
+    .option('--id <id>', 'Custom execution ID (e.g., IMPL-001-step1)')
+    .option('--no-native', 'Force prompt concatenation instead of native resume')
+    // Storage options
+    .option('--project <path>', 'Project path for storage operations')
+    .option('--force', 'Confirm destructive operations')
+    .option('--cli-history', 'Target CLI history storage')
+    .option('--memory', 'Target memory storage')
+    .option('--cache', 'Target cache storage')
+    .option('--config', 'Target config storage')
+    .action((subcommand, args, options) => cliCommand(subcommand, args, options));
+
+  // Memory command
+  program
+    .command('memory [subcommand] [args...]')
+    .description('Memory module for context tracking and prompt optimization')
+    .option('--type <type>', 'Entity type: file, module, topic (track) OR source type: core_memory, workflow, cli_history (search)')
+    .option('--action <action>', 'Action: read, write, mention')
+    .option('--value <value>', 'Entity value (file path, etc.)')
+    .option('--session <session>', 'Session ID')
+    .option('--stdin', 'Read input from stdin (for Claude Code hooks)')
+    .option('--source <source>', 'Import source: history, sessions, all', 'all')
+    .option('--project <project>', 'Project name filter')
+    .option('--limit <n>', 'Number of results (prompt search)', '20')
+    .option('--sort <field>', 'Sort by: heat, reads, writes', 'heat')
+    .option('--json', 'Output as JSON')
+    .option('--context <text>', 'Current task context')
+    .option('--older-than <age>', 'Age threshold for pruning', '30d')
+    .option('--dry-run', 'Preview without deleting')
+    .option('--id <id>', 'Memory/session ID (for embed command)')
+    .option('--force', 'Force re-embed all chunks')
+    .option('--batch-size <n>', 'Batch size for embedding', '8')
+    .option('--top-k <n>', 'Number of semantic search results', '10')
+    .option('--min-score <f>', 'Minimum similarity score for semantic search', '0.5')
+    .action((subcommand, args, options) => memoryCommand(subcommand, args, options));
+
+  // Core Memory command
+  program
+    .command('core-memory [subcommand] [args...]')
+    .description('Manage core memory entries for strategic context')
+    .option('--id <id>', 'Memory ID')
+    .option('--all', 'Archive all memories')
+    .option('--before <date>', 'Archive memories before date (YYYY-MM-DD)')
+    .option('--interactive', 'Interactive selection')
+    .option('--archived', 'List archived memories')
+    .option('--limit <n>', 'Number of results', '50')
+    .option('--json', 'Output as JSON')
+    .option('--force', 'Skip confirmation')
+    .option('--tool <tool>', 'Tool to use for summary: gemini, qwen', 'gemini')
+    .option('--auto', 'Run auto-clustering')
+    .option('--scope <scope>', 'Auto-cluster scope: all, recent, unclustered', 'recent')
+    .option('--create', 'Create new cluster')
+    .option('--name <name>', 'Cluster name')
+    .option('--members <ids>', 'Cluster member IDs (comma-separated)')
+    .option('--status <status>', 'Cluster status filter')
+    .option('--level <level>', 'Context level: metadata, keyFiles, full')
+    .option('--delete', 'Delete a cluster')
+    .option('--merge <ids>', 'Merge clusters into target (comma-separated source IDs)')
+    .option('--dedup', 'Deduplicate clusters by merging similar ones')
+    .option('--output <file>', 'Output file path for export')
+    .option('--overwrite', 'Overwrite existing memories when importing')
+    .option('--prefix <prefix>', 'Add prefix to imported memory IDs')
+    .action((subcommand, args, options) => coreMemoryCommand(subcommand, args, options));
+
+  // Hook command - CLI endpoint for Claude Code hooks
+  program
+    .command('hook [subcommand] [args...]')
+    .description('CLI endpoint for Claude Code hooks (session-context, notify)')
+    .option('--stdin', 'Read input from stdin (for Claude Code hooks)')
+    .option('--session-id <id>', 'Session ID')
+    .option('--prompt <text>', 'Prompt text')
+    .option('--type <type>', 'Context type: session-start, context')
+    .action((subcommand, args, options) => hookCommand(subcommand, args, options));
+
+  program.parse(argv);
+}