@polymorphism-tech/morph-spec 4.3.6 → 4.5.0

package/src/commands/mcp/mcp-setup.js

@@ -0,0 +1,315 @@
+/**
+ * MCP Setup Command
+ *
+ * Install and configure MCP servers for morph-spec projects.
+ *
+ * Usage:
+ *   morph-spec mcp setup              — Interactive wizard showing all MCPs
+ *   morph-spec mcp setup <name>       — Setup a specific MCP
+ *   morph-spec mcp setup --list       — Show MCP install status
+ *   morph-spec mcp setup --auto       — Non-interactive auto-install credential-free MCPs
+ */
+
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import ora from 'ora';
+import {
+  orchestrateMcpSetup,
+  installAutoMcps,
+  installMcpWithCredentials,
+  generateSetupInstructions,
+  formatMcpStatusTable,
+  loadMcpRegistry
+} from '../../lib/installers/mcp-installer.js';
+import { detectClaudeConfig } from '../../lib/detectors/claude-config-detector.js';
+import { detectProject } from '../../lib/detectors/index.js';
+
+/**
+ * Detect the current project's stack
+ */
+async function detectStack(targetPath) {
+  try {
+    const results = await detectProject(targetPath, { conversation: false, generateStandards: false });
+    return results.structure?.stack || 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}
+
+export async function mcpSetupCommand(name, options) {
+  const targetPath = process.cwd();
+
+  try {
+    // Detect current environment
+    const stack = await detectStack(targetPath);
+    const claudeConfig = await detectClaudeConfig(targetPath);
+    const existingMcps = claudeConfig.mcpServers || [];
+
+    if (options.list) {
+      return showStatusList(targetPath, stack, existingMcps);
+    }
+
+    if (options.auto) {
+      return autoInstall(targetPath, stack, existingMcps);
+    }
+
+    if (name) {
+      return setupSpecificMcp(targetPath, name, stack, existingMcps);
+    }
+
+    // Interactive wizard
+    return interactiveWizard(targetPath, stack, existingMcps);
+  } catch (err) {
+    console.error(chalk.red(`Error: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+/**
+ * Show MCP status list (--list)
+ */
+async function showStatusList(targetPath, stack, existingMcps) {
+  const orchestration = orchestrateMcpSetup(targetPath, stack, existingMcps);
+  const statusRows = formatMcpStatusTable(orchestration, {});
+
+  console.log(chalk.cyan('\n  MCP Server Status\n'));
+  console.log(`  Stack: ${chalk.bold(stack)}`);
+  console.log('  ' + '─'.repeat(60));
+
+  const STATUS_ICONS = {
+    installed: chalk.green('✓'),
+    available: chalk.cyan('○'),
+    already_configured: chalk.green('✓'),
+    needs_setup: chalk.yellow('⚠'),
+    prereq_missing: chalk.red('✗'),
+    not_relevant: chalk.gray('─')
+  };
+
+  if (statusRows.length === 0) {
+    console.log(chalk.gray('\n  No MCPs in registry.\n'));
+    return;
+  }
+
+  for (const row of statusRows) {
+    const icon = STATUS_ICONS[row.status] || '?';
+    const statusLabel = row.status.replace(/_/g, ' ');
+    console.log(`  ${icon} ${row.name.padEnd(15)} ${statusLabel.padEnd(20)} ${chalk.gray(row.detail)}`);
+  }
+
+  console.log('');
+}
+
+/**
+ * Auto-install credential-free MCPs (--auto)
+ */
+async function autoInstall(targetPath, stack, existingMcps) {
+  const orchestration = orchestrateMcpSetup(targetPath, stack, existingMcps, { autoOnly: true });
+  const autoNames = Object.keys(orchestration.autoInstallable);
+
+  if (autoNames.length === 0) {
+    console.log(chalk.green('\n  ✓ All auto-installable MCPs are already configured.\n'));
+    return;
+  }
+
+  const spinner = ora(`Installing ${autoNames.join(', ')}...`).start();
+  const result = await installAutoMcps(targetPath, orchestration.autoInstallable);
+  spinner.succeed(`Installed ${result.added.length} MCP server(s): ${result.added.join(', ')}`);
+
+  if (result.skipped.length > 0) {
+    console.log(chalk.gray(`  Skipped (already configured): ${result.skipped.join(', ')}`));
+  }
+
+  console.log('');
+}
+
+/**
+ * Setup a specific MCP by name
+ */
+async function setupSpecificMcp(targetPath, name, stack, existingMcps) {
+  const registry = loadMcpRegistry();
+  const mcpEntry = registry.mcps[name];
+
+  if (!mcpEntry) {
+    console.log(chalk.red(`\n  Unknown MCP: ${name}`));
+    console.log(chalk.gray(`  Available: ${Object.keys(registry.mcps).join(', ')}`));
+    console.log('');
+    return;
+  }
+
+  if (!mcpEntry.install) {
+    console.log(chalk.red(`\n  MCP "${name}" has no install configuration.\n`));
+    return;
+  }
+
+  // Check if already installed
+  const isInstalled = existingMcps.some(s => s.name.toLowerCase().includes(name));
+  if (isInstalled) {
+    const { reconfigure } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'reconfigure',
+      message: `${name} is already configured. Reconfigure?`,
+      default: false
+    }]);
+    if (!reconfigure) return;
+  }
+
+  // Check prerequisites
+  const prereqs = mcpEntry.install.prerequisites || [];
+  for (const prereq of prereqs) {
+    try {
+      const { execSync } = await import('child_process');
+      execSync(prereq.checkCommand, { stdio: 'ignore', timeout: 5000 });
+    } catch {
+      console.log(chalk.red(`\n  Missing prerequisite: ${prereq.name}`));
+      console.log(chalk.gray(`  Install: ${prereq.installUrl}`));
+      console.log('');
+      return;
+    }
+  }
+
+  // Show warnings
+  for (const warning of mcpEntry.install.warnings || []) {
+    console.log(chalk.yellow(`\n  ⚠ ${warning}`));
+  }
+
+  const credentials = mcpEntry.install.credentials || [];
+
+  // Auto-installable — just install
+  if (mcpEntry.install.autoInstall) {
+    const spinner = ora(`Installing ${name}...`).start();
+    const result = await installAutoMcps(targetPath, { [name]: mcpEntry });
+    if (result.added.length > 0) {
+      spinner.succeed(`${name} MCP installed`);
+    } else {
+      spinner.info(`${name} MCP already configured`);
+    }
+    console.log('');
+    return;
+  }
+
+  // Needs credentials
+  console.log(chalk.cyan(`\n  Setting up ${name} MCP\n`));
+  console.log(chalk.gray(`  Usage: ${mcpEntry.usage}`));
+  console.log('');
+
+  const { enterCredentials } = await inquirer.prompt([{
+    type: 'confirm',
+    name: 'enterCredentials',
+    message: 'Enter credentials now?',
+    default: true
+  }]);
+
+  if (enterCredentials) {
+    const credentialValues = {};
+    for (const cred of credentials) {
+      const { value } = await inquirer.prompt([{
+        type: cred.secret ? 'password' : 'input',
+        name: 'value',
+        message: `${cred.name}:`,
+        mask: cred.secret ? '*' : undefined
+      }]);
+      credentialValues[cred.envVar] = value;
+    }
+
+    const spinner = ora(`Configuring ${name}...`).start();
+    await installMcpWithCredentials(targetPath, name, mcpEntry, credentialValues);
+    spinner.succeed(`${name} MCP configured`);
+  } else {
+    // Show config snippet
+    const instructions = generateSetupInstructions(name, mcpEntry);
+    console.log(chalk.gray('\n  Add to .claude/settings.local.json → mcpServers:'));
+    console.log(chalk.gray('  ' + '─'.repeat(55)));
+    for (const line of instructions.configSnippet.split('\n')) {
+      console.log(chalk.gray(`  ${line}`));
+    }
+    console.log(chalk.gray('  ' + '─'.repeat(55)));
+
+    for (const cred of instructions.credentialUrls) {
+      console.log(chalk.gray(`  Get ${cred.name}: ${cred.helpUrl}`));
+    }
+  }
+
+  console.log('');
+}
+
+/**
+ * Interactive wizard showing all MCPs
+ */
+async function interactiveWizard(targetPath, stack, existingMcps) {
+  const orchestration = orchestrateMcpSetup(targetPath, stack, existingMcps);
+
+  console.log(chalk.cyan('\n  MCP Setup Wizard'));
+  console.log(chalk.gray(`  Stack: ${stack}`));
+  console.log('');
+
+  const autoNames = Object.keys(orchestration.autoInstallable);
+  const manualNames = Object.keys(orchestration.needsManualSetup);
+  const alreadyNames = Object.keys(orchestration.alreadyInstalled);
+
+  if (alreadyNames.length > 0) {
+    console.log(chalk.green(`  Already configured: ${alreadyNames.join(', ')}`));
+  }
+
+  // Auto-install
+  if (autoNames.length > 0) {
+    const { installAuto } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'installAuto',
+      message: `Install credential-free MCPs? (${autoNames.join(', ')})`,
+      default: true
+    }]);
+
+    if (installAuto) {
+      const spinner = ora('Installing...').start();
+      const result = await installAutoMcps(targetPath, orchestration.autoInstallable);
+      spinner.succeed(`Installed: ${result.added.join(', ')}`);
+    }
+  }
+
+  // Credential MCPs
+  if (manualNames.length > 0) {
+    console.log(chalk.cyan('\n  Credential-requiring MCPs:'));
+
+    for (const name of manualNames) {
+      const entry = orchestration.needsManualSetup[name];
+
+      for (const warning of entry.install.warnings || []) {
+        console.log(chalk.yellow(`  ⚠ ${warning}`));
+      }
+
+      const capitalizedName = name.charAt(0).toUpperCase() + name.slice(1);
+      const { setupNow } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'setupNow',
+        message: `Set up ${capitalizedName}? (${entry.usage})`,
+        default: false
+      }]);
+
+      if (setupNow) {
+        const credentialValues = {};
+        for (const cred of entry.install.credentials) {
+          const { value } = await inquirer.prompt([{
+            type: cred.secret ? 'password' : 'input',
+            name: 'value',
+            message: `${cred.name}:`,
+            mask: cred.secret ? '*' : undefined
+          }]);
+          credentialValues[cred.envVar] = value;
+        }
+
+        const spinner = ora(`Configuring ${name}...`).start();
+        await installMcpWithCredentials(targetPath, name, entry, credentialValues);
+        spinner.succeed(`${capitalizedName} configured`);
+      } else {
+        const instructions = generateSetupInstructions(name, entry);
+        console.log(chalk.gray(`  Run later: ${instructions.cliCommand}`));
+      }
+    }
+  }
+
+  if (autoNames.length === 0 && manualNames.length === 0) {
+    console.log(chalk.green('  ✓ All relevant MCPs are already configured.\n'));
+  } else {
+    console.log('');
+  }
+}

package/src/commands/project/changes.js

@@ -0,0 +1,66 @@
+/**
+ * Changes Command
+ *
+ * Lists files created/modified by a feature, grouped by phase.
+ */
+
+import chalk from 'chalk';
+import { logger } from '../../utils/logger.js';
+import { getFileChanges } from '../../core/state/state-manager.js';
+
+export async function changesCommand(feature, options = {}) {
+  if (!feature) {
+    logger.error('Usage: morph-spec changes <feature>');
+    process.exit(1);
+  }
+
+  try {
+    const grouped = getFileChanges(feature, { groupByPhase: true });
+
+    if (options.json) {
+      console.log(JSON.stringify(grouped, null, 2));
+      return;
+    }
+
+    const phases = Object.keys(grouped);
+
+    if (phases.length === 0) {
+      logger.warn(`No file changes tracked for feature '${feature}'.`);
+      return;
+    }
+
+    logger.header(`File Changes — ${feature}`);
+
+    let totalFiles = 0;
+
+    for (const phase of phases) {
+      const changes = grouped[phase];
+      totalFiles += changes.length;
+
+      console.log(chalk.cyan(`\n  Phase: ${phase} (${changes.length} files)`));
+      console.log('  ' + '─'.repeat(50));
+
+      for (const change of changes) {
+        const actionIcon = {
+          created: chalk.green('+'),
+          modified: chalk.yellow('~'),
+          deleted: chalk.red('-')
+        }[change.action] || ' ';
+
+        const timestamp = change.timestamp
+          ? chalk.dim(` (${new Date(change.timestamp).toLocaleDateString()})`)
+          : '';
+
+        console.log(`  ${actionIcon} ${change.path}${timestamp}`);
+      }
+    }
+
+    logger.blank();
+    logger.dim(`Total: ${totalFiles} file(s) across ${phases.length} phase(s)`);
+    logger.blank();
+
+  } catch (error) {
+    logger.error(error.message);
+    process.exit(1);
+  }
+}

package/src/commands/project/checkpoint.js

@@ -0,0 +1,209 @@
+/**
+ * MORPH-SPEC Checkpoint Save/Restore Command
+ *
+ * Save and restore full context at phase boundaries.
+ *
+ * Usage:
+ *   morph-spec checkpoint save <feature-name>
+ *   morph-spec checkpoint restore <feature-name>
+ *   morph-spec checkpoint list <feature-name>
+ */
+
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import { loadState, saveState, getFeature } from '../../core/state/state-manager.js';
+
+/**
+ * Get checkpoints directory for a feature
+ */
+function getCheckpointsDir(featureName) {
+  return path.join(process.cwd(), '.morph/checkpoints', featureName);
+}
+
+/**
+ * Save checkpoint command
+ */
+export async function checkpointSaveCommand(featureName, options = {}) {
+  if (!featureName) {
+    console.error(chalk.red('Error: Feature name required'));
+    process.exit(1);
+  }
+
+  const feature = getFeature(featureName);
+  if (!feature) {
+    console.error(chalk.red(`Error: Feature '${featureName}' not found`));
+    process.exit(1);
+  }
+
+  const outputDir = path.join(process.cwd(), '.morph/features', featureName);
+  if (!fs.existsSync(outputDir)) {
+    console.error(chalk.red(`Error: No outputs found for '${featureName}'`));
+    process.exit(1);
+  }
+
+  // Create checkpoint directory with timestamp
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+  const label = options.label || feature.phase;
+  const checkpointName = `${label}_${timestamp}`;
+  const checkpointDir = path.join(getCheckpointsDir(featureName), checkpointName);
+  fs.mkdirSync(checkpointDir, { recursive: true });
+
+  // Copy all output files
+  const files = fs.readdirSync(outputDir);
+  let fileCount = 0;
+  for (const file of files) {
+    const src = path.join(outputDir, file);
+    const stat = fs.statSync(src);
+    if (stat.isFile()) {
+      fs.copyFileSync(src, path.join(checkpointDir, file));
+      fileCount++;
+    }
+  }
+
+  // Save state snapshot
+  const stateSnapshot = {
+    feature: { ...feature },
+    timestamp: new Date().toISOString(),
+    phase: feature.phase,
+    label,
+    files: files.filter(f => fs.statSync(path.join(outputDir, f)).isFile())
+  };
+  fs.writeFileSync(
+    path.join(checkpointDir, '_checkpoint.json'),
+    JSON.stringify(stateSnapshot, null, 2)
+  );
+
+  console.log(chalk.green(`\n✓ Checkpoint saved: ${checkpointName}`));
+  console.log(chalk.gray(`  Phase: ${feature.phase}`));
+  console.log(chalk.gray(`  Files: ${fileCount}`));
+  console.log(chalk.gray(`  Path: ${checkpointDir}\n`));
+}
+
+/**
+ * Restore checkpoint command
+ */
+export async function checkpointRestoreCommand(featureName, checkpointName, options = {}) {
+  if (!featureName) {
+    console.error(chalk.red('Error: Feature name required'));
+    process.exit(1);
+  }
+
+  const checkpointsDir = getCheckpointsDir(featureName);
+  if (!fs.existsSync(checkpointsDir)) {
+    console.error(chalk.red(`Error: No checkpoints found for '${featureName}'`));
+    process.exit(1);
+  }
+
+  // Find checkpoint to restore
+  let targetDir;
+  if (checkpointName) {
+    targetDir = path.join(checkpointsDir, checkpointName);
+    if (!fs.existsSync(targetDir)) {
+      console.error(chalk.red(`Error: Checkpoint '${checkpointName}' not found`));
+      process.exit(1);
+    }
+  } else {
+    // Restore latest
+    const checkpoints = fs.readdirSync(checkpointsDir)
+      .filter(d => fs.statSync(path.join(checkpointsDir, d)).isDirectory())
+      .sort()
+      .reverse();
+
+    if (checkpoints.length === 0) {
+      console.error(chalk.red(`Error: No checkpoints found for '${featureName}'`));
+      process.exit(1);
+    }
+
+    targetDir = path.join(checkpointsDir, checkpoints[0]);
+    checkpointName = checkpoints[0];
+  }
+
+  // Read checkpoint metadata
+  const metaPath = path.join(targetDir, '_checkpoint.json');
+  if (!fs.existsSync(metaPath)) {
+    console.error(chalk.red('Error: Checkpoint metadata not found'));
+    process.exit(1);
+  }
+
+  const meta = JSON.parse(fs.readFileSync(metaPath, 'utf8'));
+
+  // Restore output files
+  const outputDir = path.join(process.cwd(), '.morph/features', featureName);
+  fs.mkdirSync(outputDir, { recursive: true });
+
+  const files = fs.readdirSync(targetDir).filter(f => f !== '_checkpoint.json');
+  for (const file of files) {
+    fs.copyFileSync(path.join(targetDir, file), path.join(outputDir, file));
+  }
+
+  // Restore state
+  const state = loadState();
+  if (state.features[featureName] && meta.feature) {
+    // Preserve some current fields, restore phase and outputs
+    state.features[featureName].phase = meta.feature.phase;
+    state.features[featureName].outputs = meta.feature.outputs;
+    state.features[featureName].tasks = meta.feature.tasks;
+    state.features[featureName].approvalGates = meta.feature.approvalGates;
+    state.features[featureName].updatedAt = new Date().toISOString();
+    saveState(state);
+  }
+
+  console.log(chalk.green(`\n✓ Checkpoint restored: ${checkpointName}`));
+  console.log(chalk.gray(`  Phase: ${meta.phase}`));
+  console.log(chalk.gray(`  Files restored: ${files.length}`));
+  console.log(chalk.gray(`  Original date: ${meta.timestamp}\n`));
+}
+
+/**
+ * List checkpoints command
+ */
+export async function checkpointListCommand(featureName, options = {}) {
+  if (!featureName) {
+    console.error(chalk.red('Error: Feature name required'));
+    process.exit(1);
+  }
+
+  const checkpointsDir = getCheckpointsDir(featureName);
+  if (!fs.existsSync(checkpointsDir)) {
+    console.log(chalk.gray(`No checkpoints found for '${featureName}'.\n`));
+    return;
+  }
+
+  const checkpoints = fs.readdirSync(checkpointsDir)
+    .filter(d => fs.statSync(path.join(checkpointsDir, d)).isDirectory())
+    .sort()
+    .reverse();
+
+  if (checkpoints.length === 0) {
+    console.log(chalk.gray(`No checkpoints found for '${featureName}'.\n`));
+    return;
+  }
+
+  // JSON output
+  if (options.json) {
+    const list = checkpoints.map(cp => {
+      const metaPath = path.join(checkpointsDir, cp, '_checkpoint.json');
+      const meta = fs.existsSync(metaPath) ? JSON.parse(fs.readFileSync(metaPath, 'utf8')) : {};
+      return { name: cp, phase: meta.phase, timestamp: meta.timestamp, files: meta.files?.length || 0 };
+    });
+    console.log(JSON.stringify({ feature: featureName, checkpoints: list }, null, 2));
+    return;
+  }
+
+  // Visual output
+  console.log(chalk.cyan(`\nCheckpoints for '${featureName}':\n`));
+
+  for (const cp of checkpoints) {
+    const metaPath = path.join(checkpointsDir, cp, '_checkpoint.json');
+    let meta = {};
+    if (fs.existsSync(metaPath)) {
+      meta = JSON.parse(fs.readFileSync(metaPath, 'utf8'));
+    }
+
+    const date = meta.timestamp ? new Date(meta.timestamp).toLocaleString() : 'unknown';
+    console.log(chalk.white(`  ${cp}`));
+    console.log(chalk.gray(`    Phase: ${meta.phase || 'unknown'} | Files: ${meta.files?.length || '?'} | ${date}`));
+  }
+  console.log('');
+}