@polymorphism-tech/morph-spec 4.7.1 → 4.8.1

package/src/commands/state/state.js

@@ -1,365 +1,337 @@
-/**
- * MORPH-SPEC State Command
- * CLI wrapper for state management operations
- */
-
-import { join } from 'path';
-import { readFileSync, existsSync } from 'fs';
-import ora from 'ora';
-import chalk from 'chalk';
-import { logger } from '../../utils/logger.js';
-import * as StateManager from '../../core/state/state-manager.js';
-
-// ============================================================================
-// Command Functions
-// ============================================================================
-
-/**
- * Main state command router
- */
-export async function stateCommand(action, args, options) {
-  switch (action) {
-    case 'init':
-      await initCommand(options);
-      break;
-
-    case 'get':
-      await getCommand(args[0], options);
-      break;
-
-    case 'set':
-      await setCommand(args[0], args[1], args[2], options);
-      break;
-
-    case 'checkpoint':
-      await checkpointCommand(args[0], args.slice(1).join(' '), options);
-      break;
-
-    case 'list':
-      await listCommand(options);
-      break;
-
-    case 'add-agent':
-      await addAgentCommand(args[0], args[1], options);
-      break;
-
-    case 'remove-agent':
-      await removeAgentCommand(args[0], args[1], options);
-      break;
-
-    case 'mark-output':
-      await markOutputCommand(args[0], args[1], options);
-      break;
-
-    default:
-      logger.error(`Unknown action: ${action}`);
-      logger.blank();
-      logger.info('Available actions:');
-      logger.dim('  init, get, set, checkpoint, list, add-agent, remove-agent, mark-output');
-      logger.blank();
-      logger.dim('Run "morph-spec state --help" for more information');
-      process.exit(1);
-  }
-}
-
-/**
- * Initialize state file
- */
-async function initCommand(options) {
-  logger.header('Initialize State');
-  logger.blank();
-
-  try {
-    if (StateManager.stateExists() && !options.force) {
-      logger.warn('State file already exists.');
-      logger.dim('  Use --force to overwrite');
-      logger.blank();
-      return;
-    }
-
-    const spinner = ora('Initializing state.json...').start();
-
-    // Read project name and stack from config.json if not provided via options
-    let projectName = options.project;
-    let projectType = options.type;
-    if (!projectName || !projectType) {
-      const configPath = join(process.cwd(), '.morph', 'config', 'config.json');
-      if (existsSync(configPath)) {
-        try {
-          const config = JSON.parse(readFileSync(configPath, 'utf8'));
-          projectName = projectName || config.project?.name || 'unknown';
-          projectType = projectType || config.project?.stack || 'unknown';
-        } catch {
-          projectName = projectName || 'unknown';
-          projectType = projectType || 'unknown';
-        }
-      } else {
-        projectName = projectName || 'unknown';
-        projectType = projectType || 'unknown';
-      }
-    }
-
-    StateManager.initState({
-      force: options.force,
-      projectName,
-      projectType
-    });
-
-    spinner.succeed('State initialized!');
-    logger.blank();
-    logger.dim(`Location: ${StateManager.getStatePath()}`);
-    logger.blank();
-
-  } catch (error) {
-    logger.error(error.message);
-    process.exit(1);
-  }
-}
-
-/**
- * Get feature state
- */
-async function getCommand(featureName, options) {
-  if (!featureName) {
-    logger.error('Feature name required');
-    logger.dim('  Usage: morph-spec state get <feature>');
-    process.exit(1);
-  }
-
-  try {
-    const feature = StateManager.getFeature(featureName);
-
-    if (!feature) {
-      logger.error(`Feature '${featureName}' not found`);
-      process.exit(1);
-    }
-
-    if (options.json) {
-      console.log(JSON.stringify(feature, null, 2));
-    } else {
-      logger.header(`Feature: ${featureName}`);
-      logger.blank();
-      logger.info(`Status: ${chalk.cyan(feature.status)}`);
-      logger.info(`Phase: ${chalk.cyan(feature.phase)}`);
-      logger.info(`Tasks: ${chalk.cyan(`${feature.tasks.completed}/${feature.tasks.total}`)}`);
-      logger.info(`Agents: ${chalk.cyan(feature.activeAgents.join(', ') || 'None')}`);
-      logger.blank();
-    }
-
-  } catch (error) {
-    logger.error(error.message);
-    process.exit(1);
-  }
-}
-
-/**
- * Set feature property
- */
-async function setCommand(featureName, key, value, options) {
-  if (!featureName || !key || value === undefined) {
-    logger.error('Missing required arguments');
-    logger.dim('  Usage: morph-spec state set <feature> <key> <value>');
-    logger.blank();
-    logger.dim('  Example: morph-spec state set my-feature phase implement');
-    process.exit(1);
-  }
-
-  try {
-    const spinner = ora('Updating state...').start();
-
-    // Parse value automatically (JSON, number, boolean)
-    let parsedValue = value;
-    try {
-      parsedValue = JSON.parse(value);
-    } catch {
-      // Keep as string if not valid JSON
-    }
-
-    StateManager.updateFeature(featureName, key, parsedValue);
-
-    spinner.succeed(`Updated ${chalk.cyan(featureName)}.${chalk.cyan(key)}`);
-    logger.blank();
-    logger.dim(`Value: ${JSON.stringify(parsedValue)}`);
-    logger.blank();
-
-  } catch (error) {
-    logger.error(error.message);
-    process.exit(1);
-  }
-}
-
-/**
- * Add checkpoint
- */
-async function checkpointCommand(featureName, note, options) {
-  if (!featureName || !note) {
-    logger.error('Missing required arguments');
-    logger.dim('  Usage: morph-spec state checkpoint <feature> "<note>"');
-    logger.blank();
-    logger.dim('  Example: morph-spec state checkpoint my-feature "Completed T001-T003"');
-    process.exit(1);
-  }
-
-  try {
-    const spinner = ora('Creating checkpoint...').start();
-
-    const checkpoint = await StateManager.addCheckpoint(featureName, note);
-
-    spinner.succeed(`Checkpoint registered for ${chalk.cyan(featureName)}`);
-    logger.blank();
-    logger.dim(`  ${checkpoint.summary?.note || note}`);
-    logger.dim(`  Phase: ${checkpoint.phase}`);
-    logger.dim(`  Tasks completed: ${checkpoint.summary?.completedTasks ?? 0}`);
-    logger.blank();
-
-  } catch (error) {
-    logger.error(error.message);
-    process.exit(1);
-  }
-}
-
-/**
- * List all features
- */
-async function listCommand(options) {
-  logger.header('MORPH-SPEC Project Status');
-  logger.blank();
-
-  try {
-    const summary = StateManager.getSummary();
-    const features = StateManager.listFeatures();
-
-    // Project info
-    const projectName = summary.project?.name || '(unnamed)';
-    const projectType = summary.project?.type || '(unknown)';
-    logger.info(`Project: ${chalk.cyan(projectName)}`);
-    logger.info(`Type: ${chalk.cyan(projectType)}`);
-    logger.blank();
-
-    if (features.length === 0) {
-      logger.warn('No features found');
-      logger.blank();
-      return;
-    }
-
-    // Features table
-    logger.header('Features:');
-    logger.blank();
-
-    features.forEach(([name, feature]) => {
-      const statusEmoji = {
-        draft: '📝',
-        in_review: '👀',
-        approved: '✅',
-        in_progress: '🚧',
-        done: '✔️',
-        archived: '📦'
-      }[feature.status] || '❓';
-
-      const tasks = feature.tasks || {};
-      const progress = (tasks.total || 0) > 0
-        ? `${tasks.completed || 0}/${tasks.total}`
-        : '0/0';
-
-      logger.info(`${statusEmoji}  ${chalk.bold(name)}`);
-      logger.dim(`   Phase: ${(feature.phase || 'unknown').padEnd(16)} │ Tasks: ${progress}`);
-      logger.dim(`   Agents: ${(feature.activeAgents || []).slice(0, 5).join(', ') || 'None'}`);
-      logger.blank();
-    });
-
-    // Summary
-    logger.header('Summary:');
-    logger.info(`Total Features: ${chalk.cyan(summary.metadata?.totalFeatures ?? features.length)}`);
-    logger.info(`Completed: ${chalk.cyan(summary.metadata?.completedFeatures ?? 0)}`);
-    logger.blank();
-
-  } catch (error) {
-    logger.error(error.message);
-    process.exit(1);
-  }
-}
-
-/**
- * Add agent to feature
- */
-async function addAgentCommand(featureName, agentId, options) {
-  if (!featureName || !agentId) {
-    logger.error('Missing required arguments');
-    logger.dim('  Usage: morph-spec state add-agent <feature> <agent-id>');
-    process.exit(1);
-  }
-
-  try {
-    const added = StateManager.addAgent(featureName, agentId);
-
-    if (added) {
-      logger.success(`Agent '${chalk.cyan(agentId)}' added to ${chalk.cyan(featureName)}`);
-    } else {
-      logger.warn(`Agent '${agentId}' already active`);
-    }
-    logger.blank();
-
-  } catch (error) {
-    logger.error(error.message);
-    process.exit(1);
-  }
-}
-
-/**
- * Remove agent from feature
- */
-async function removeAgentCommand(featureName, agentId, options) {
-  if (!featureName || !agentId) {
-    logger.error('Missing required arguments');
-    logger.dim('  Usage: morph-spec state remove-agent <feature> <agent-id>');
-    process.exit(1);
-  }
-
-  try {
-    const removed = StateManager.removeAgent(featureName, agentId);
-
-    if (removed) {
-      logger.success(`Agent '${chalk.cyan(agentId)}' removed from ${chalk.cyan(featureName)}`);
-    } else {
-      logger.warn(`Agent '${agentId}' not found`);
-    }
-    logger.blank();
-
-  } catch (error) {
-    logger.error(error.message);
-    process.exit(1);
-  }
-}
-
-/**
- * Mark output as created
- */
-async function markOutputCommand(featureName, outputType, options) {
-  if (!featureName || !outputType) {
-    logger.error('Missing required arguments');
-    logger.dim('  Usage: morph-spec state mark-output <feature> <output-type>');
-    logger.blank();
-    logger.dim('  Valid types:');
-    logger.dim('    Standard: proposal, spec, contracts, tasks, decisions, recap');
-    logger.dim('    UI/UX:    uiDesignSystem, uiMockups, uiComponents, uiFlows');
-    logger.blank();
-    logger.dim('  Note: UI types also accept kebab-case (e.g., ui-design-system)');
-    logger.blank();
-    logger.dim('  Examples:');
-    logger.dim('    morph-spec state mark-output my-feature spec');
-    logger.dim('    morph-spec state mark-output my-feature uiDesignSystem');
-    logger.dim('    morph-spec state mark-output my-feature ui-design-system');
-    process.exit(1);
-  }
-
-  try {
-    StateManager.markOutput(featureName, outputType);
-
-    logger.success(`Output '${chalk.cyan(outputType)}' marked as created for ${chalk.cyan(featureName)}`);
-    logger.blank();
-
-  } catch (error) {
-    logger.error(error.message);
-    process.exit(1);
-  }
-}
+/**
+ * MORPH-SPEC State Command
+ * CLI wrapper for state management operations
+ */
+
+import { join } from 'path';
+import { readFileSync, existsSync } from 'fs';
+import ora from 'ora';
+import chalk from 'chalk';
+import { logger } from '../../utils/logger.js';
+import * as StateManager from '../../core/state/state-manager.js';
+import { derivePhase } from '../../core/state/state-manager.js';
+
+// ============================================================================
+// Command Functions
+// ============================================================================
+
+/**
+ * Main state command router
+ */
+export async function stateCommand(action, args, options) {
+  switch (action) {
+    case 'init':
+      await initCommand(options);
+      break;
+
+    case 'get':
+      await getCommand(args[0], options);
+      break;
+
+    case 'set':
+      await setCommand(args[0], args[1], args[2], options);
+      break;
+
+    case 'list':
+      await listCommand(options);
+      break;
+
+    case 'add-agent':
+      await addAgentCommand(args[0], args[1], options);
+      break;
+
+    case 'remove-agent':
+      await removeAgentCommand(args[0], args[1], options);
+      break;
+
+    case 'mark-output':
+      await markOutputCommand(args[0], args[1], options);
+      break;
+
+    default:
+      logger.error(`Unknown action: ${action}`);
+      logger.blank();
+      logger.info('Available actions:');
+      logger.dim('  init, get, set, list, add-agent, remove-agent, mark-output');
+      logger.blank();
+      logger.dim('Run "morph-spec state --help" for more information');
+      process.exit(1);
+  }
+}
+
+/**
+ * Initialize state file
+ */
+async function initCommand(options) {
+  logger.header('Initialize State');
+  logger.blank();
+
+  try {
+    if (StateManager.stateExists() && !options.force) {
+      logger.warn('State file already exists.');
+      logger.dim('  Use --force to overwrite');
+      logger.blank();
+      return;
+    }
+
+    const spinner = ora('Initializing state.json...').start();
+
+    // Read project name and stack from config.json if not provided via options
+    let projectName = options.project;
+    let projectType = options.type;
+    if (!projectName || !projectType) {
+      const configPath = join(process.cwd(), '.morph', 'config', 'config.json');
+      if (existsSync(configPath)) {
+        try {
+          const config = JSON.parse(readFileSync(configPath, 'utf8'));
+          projectName = projectName || config.project?.name || 'unknown';
+          projectType = projectType || config.project?.stack || 'unknown';
+        } catch {
+          projectName = projectName || 'unknown';
+          projectType = projectType || 'unknown';
+        }
+      } else {
+        projectName = projectName || 'unknown';
+        projectType = projectType || 'unknown';
+      }
+    }
+
+    StateManager.initState({
+      force: options.force,
+      projectName,
+      projectType
+    });
+
+    spinner.succeed('State initialized!');
+    logger.blank();
+    logger.dim(`Location: ${StateManager.getStatePath()}`);
+    logger.blank();
+
+  } catch (error) {
+    logger.error(error.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * Get feature state
+ */
+async function getCommand(featureName, options) {
+  if (!featureName) {
+    logger.error('Feature name required');
+    logger.dim('  Usage: morph-spec state get <feature>');
+    process.exit(1);
+  }
+
+  try {
+    const feature = StateManager.getFeature(featureName);
+
+    if (!feature) {
+      logger.error(`Feature '${featureName}' not found`);
+      process.exit(1);
+    }
+
+    if (options.json) {
+      console.log(JSON.stringify(feature, null, 2));
+    } else {
+      logger.header(`Feature: ${featureName}`);
+      logger.blank();
+      const featurePath = join(process.cwd(), '.morph/features', featureName);
+      const phase = derivePhase(featurePath);
+      const tasks = feature.tasks || { completed: 0, total: 0 };
+      logger.info(`Status: ${chalk.cyan(feature.status)}`);
+      logger.info(`Phase: ${chalk.cyan(phase)}`);
+      logger.info(`Tasks: ${chalk.cyan(`${tasks.completed}/${tasks.total}`)}`);
+      logger.info(`Agents: ${chalk.cyan((feature.activeAgents || []).join(', ') || 'None')}`);
+      logger.blank();
+    }
+
+  } catch (error) {
+    logger.error(error.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * Set feature property
+ */
+async function setCommand(featureName, key, value, options) {
+  if (!featureName || !key || value === undefined) {
+    logger.error('Missing required arguments');
+    logger.dim('  Usage: morph-spec state set <feature> <key> <value>');
+    logger.blank();
+    logger.dim('  Example: morph-spec state set my-feature phase implement');
+    process.exit(1);
+  }
+
+  try {
+    const spinner = ora('Updating state...').start();
+
+    // Parse value automatically (JSON, number, boolean)
+    let parsedValue = value;
+    try {
+      parsedValue = JSON.parse(value);
+    } catch {
+      // Keep as string if not valid JSON
+    }
+
+    StateManager.updateFeature(featureName, key, parsedValue);
+
+    spinner.succeed(`Updated ${chalk.cyan(featureName)}.${chalk.cyan(key)}`);
+    logger.blank();
+    logger.dim(`Value: ${JSON.stringify(parsedValue)}`);
+    logger.blank();
+
+  } catch (error) {
+    logger.error(error.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * List all features
+ */
+async function listCommand(options) {
+  logger.header('MORPH-SPEC Project Status');
+  logger.blank();
+
+  try {
+    const summary = StateManager.getSummary();
+    const features = StateManager.listFeatures();
+
+    // Project info
+    const projectName = summary.project?.name || '(unnamed)';
+    const projectType = summary.project?.type || '(unknown)';
+    logger.info(`Project: ${chalk.cyan(projectName)}`);
+    logger.info(`Type: ${chalk.cyan(projectType)}`);
+    logger.blank();
+
+    if (features.length === 0) {
+      logger.warn('No features found');
+      logger.blank();
+      return;
+    }
+
+    // Features table
+    logger.header('Features:');
+    logger.blank();
+
+    features.forEach(([name, feature]) => {
+      const statusEmoji = {
+        draft: '📝',
+        in_review: '👀',
+        approved: '✅',
+        in_progress: '🚧',
+        done: '✔️',
+        archived: '📦'
+      }[feature.status] || '❓';
+
+      const tasks = feature.tasks || {};
+      const progress = (tasks.total || 0) > 0
+        ? `${tasks.completed || 0}/${tasks.total}`
+        : '0/0';
+
+      logger.info(`${statusEmoji}  ${chalk.bold(name)}`);
+      const featurePath = join(process.cwd(), '.morph/features', name);
+      const featurePhase = derivePhase(featurePath);
+      logger.dim(`   Phase: ${featurePhase.padEnd(16)} │ Tasks: ${progress}`);
+      logger.dim(`   Agents: ${(feature.activeAgents || []).slice(0, 5).join(', ') || 'None'}`);
+      logger.blank();
+    });
+
+    // Summary
+    logger.header('Summary:');
+    logger.info(`Total Features: ${chalk.cyan(summary.metadata?.totalFeatures ?? features.length)}`);
+    logger.info(`Completed: ${chalk.cyan(summary.metadata?.completedFeatures ?? 0)}`);
+    logger.blank();
+
+  } catch (error) {
+    logger.error(error.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * Add agent to feature
+ */
+async function addAgentCommand(featureName, agentId, options) {
+  if (!featureName || !agentId) {
+    logger.error('Missing required arguments');
+    logger.dim('  Usage: morph-spec state add-agent <feature> <agent-id>');
+    process.exit(1);
+  }
+
+  try {
+    const added = StateManager.addAgent(featureName, agentId);
+
+    if (added) {
+      logger.success(`Agent '${chalk.cyan(agentId)}' added to ${chalk.cyan(featureName)}`);
+    } else {
+      logger.warn(`Agent '${agentId}' already active`);
+    }
+    logger.blank();
+
+  } catch (error) {
+    logger.error(error.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * Remove agent from feature
+ */
+async function removeAgentCommand(featureName, agentId, options) {
+  if (!featureName || !agentId) {
+    logger.error('Missing required arguments');
+    logger.dim('  Usage: morph-spec state remove-agent <feature> <agent-id>');
+    process.exit(1);
+  }
+
+  try {
+    const removed = StateManager.removeAgent(featureName, agentId);
+
+    if (removed) {
+      logger.success(`Agent '${chalk.cyan(agentId)}' removed from ${chalk.cyan(featureName)}`);
+    } else {
+      logger.warn(`Agent '${agentId}' not found`);
+    }
+    logger.blank();
+
+  } catch (error) {
+    logger.error(error.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * Mark output as created
+ */
+async function markOutputCommand(featureName, outputType, options) {
+  if (!featureName || !outputType) {
+    logger.error('Missing required arguments');
+    logger.dim('  Usage: morph-spec state mark-output <feature> <output-type>');
+    logger.blank();
+    logger.dim('  Valid types:');
+    logger.dim('    Standard: proposal, spec, contracts, tasks, decisions, recap');
+    logger.dim('    UI/UX:    uiDesignSystem, uiMockups, uiComponents, uiFlows');
+    logger.blank();
+    logger.dim('  Note: UI types also accept kebab-case (e.g., ui-design-system)');
+    logger.blank();
+    logger.dim('  Examples:');
+    logger.dim('    morph-spec state mark-output my-feature spec');
+    logger.dim('    morph-spec state mark-output my-feature uiDesignSystem');
+    logger.dim('    morph-spec state mark-output my-feature ui-design-system');
+    process.exit(1);
+  }
+
+  try {
+    StateManager.markOutput(featureName, outputType);
+
+    logger.success(`Output '${chalk.cyan(outputType)}' marked as created for ${chalk.cyan(featureName)}`);
+    logger.blank();
+
+  } catch (error) {
+    logger.error(error.message);
+    process.exit(1);
+  }
+}