@polymorphism-tech/morph-spec 4.7.2 → 4.8.1

package/src/commands/project/update-agents.js

@@ -1,23 +0,0 @@
-/**
- * update-agents command
- *
- * Refreshes .claude/agents/ with the latest tier-1 and tier-2 MORPH agents
- * from the framework. Useful after upgrading morph-spec to pick up new or
- * updated agent definitions without re-running full init.
- */
-
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { installAgents } from '../../utils/agents-installer.js';
-import { logger } from '../../utils/logger.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const FRAMEWORK_DIR = join(__dirname, '..', '..', '..', 'framework');
-
-export async function updateAgentsCommand(args, options) {
-  const projectDir = process.cwd();
-
-  logger.info('Updating native subagents in .claude/agents/...');
-  await installAgents(projectDir, FRAMEWORK_DIR);
-  logger.success('Native subagents updated. Claude Code will discover them on next session start.');
-}

package/src/commands/state/rollback-phase.js

@@ -1,185 +0,0 @@
-/**
- * MORPH-SPEC Rollback Phase Command
- *
- * Rolls back a feature to a previous phase, marking outputs as draft.
- *
- * Usage:
- *   morph-spec rollback <feature-name> <target-phase>
- *
- * Example:
- *   morph-spec rollback scheduled-reports design
- */
-
-import fs from 'fs';
-import path from 'path';
-import chalk from 'chalk';
-import { loadState, saveState, getFeature, updateFeature } from '../../core/state/state-manager.js';
-
-// Phase order
-const PHASE_ORDER = ['proposal', 'setup', 'uiux', 'design', 'clarify', 'tasks', 'implement', 'sync'];
-
-/**
- * Get phase index
- */
-function getPhaseIndex(phase) {
-  return PHASE_ORDER.indexOf(phase);
-}
-
-/**
- * Get outputs that should be marked as draft when rolling back
- */
-function getOutputsToReset(fromPhase, toPhase) {
-  const fromIndex = getPhaseIndex(fromPhase);
-  const toIndex = getPhaseIndex(toPhase);
-
-  // Map phases to their outputs
-  const phaseOutputs = {
-    'proposal': ['proposal'],
-    'setup': [],
-    'uiux': ['uiDesignSystem', 'uiMockups', 'uiComponents', 'uiFlows'],
-    'design': ['spec', 'contracts', 'decisions'],
-    'clarify': [],
-    'tasks': ['tasks'],
-    'implement': ['recap'],
-    'sync': []
-  };
-
-  const outputsToReset = [];
-
-  // Collect all outputs from phases after target
-  for (let i = toIndex + 1; i <= fromIndex; i++) {
-    const phase = PHASE_ORDER[i];
-    if (phaseOutputs[phase]) {
-      outputsToReset.push(...phaseOutputs[phase]);
-    }
-  }
-
-  return outputsToReset;
-}
-
-/**
- * Main command handler
- */
-export async function rollbackPhaseCommand(feature, targetPhase, options = {}) {
-  console.log(chalk.cyan('\n╔════════════════════════════════════════════════╗'));
-  console.log(chalk.cyan('║     MORPH-SPEC ROLLBACK                        ║'));
-  console.log(chalk.cyan('╚════════════════════════════════════════════════╝\n'));
-
-  // Validate target phase
-  if (!PHASE_ORDER.includes(targetPhase)) {
-    console.log(chalk.red(`❌ Invalid phase: ${targetPhase}`));
-    console.log(chalk.gray('\nValid phases:'));
-    PHASE_ORDER.forEach(p => console.log(chalk.gray(`  - ${p}`)));
-    process.exit(1);
-  }
-
-  // Get current feature state
-  let featureState;
-  try {
-    featureState = getFeature(feature);
-  } catch (error) {
-    console.log(chalk.red(`❌ Feature not found: ${feature}`));
-    console.log(chalk.gray('  Run: morph-spec state list'));
-    process.exit(1);
-  }
-
-  if (!featureState) {
-    console.log(chalk.red(`❌ Feature not found: ${feature}`));
-    process.exit(1);
-  }
-
-  const currentPhase = featureState.phase || 'proposal';
-  const currentIndex = getPhaseIndex(currentPhase);
-  const targetIndex = getPhaseIndex(targetPhase);
-
-  // Check if rollback makes sense
-  if (targetIndex >= currentIndex) {
-    console.log(chalk.yellow(`⚠️  Cannot rollback: target phase '${targetPhase}' is not before current phase '${currentPhase}'`));
-    process.exit(1);
-  }
-
-  // Get outputs to reset
-  const outputsToReset = getOutputsToReset(currentPhase, targetPhase);
-
-  // Show what will happen
-  console.log(chalk.gray('Feature:'), feature);
-  console.log(chalk.gray('Current Phase:'), currentPhase);
-  console.log(chalk.gray('Target Phase:'), targetPhase);
-  console.log('');
-
-  if (outputsToReset.length > 0) {
-    console.log(chalk.yellow('Outputs that will be marked as draft:'));
-    outputsToReset.forEach(o => {
-      console.log(chalk.gray(`  - ${o}`));
-    });
-    console.log('');
-  }
-
-  // Confirm unless --force
-  if (!options.force) {
-    console.log(chalk.yellow('⚠️  This will:'));
-    console.log(chalk.gray('  1. Set phase back to: ' + targetPhase));
-    console.log(chalk.gray('  2. Reset task progress'));
-    console.log(chalk.gray('  3. Mark outputs as not created (files remain on disk)'));
-    console.log('');
-    console.log(chalk.gray('Run with --force to confirm.'));
-    process.exit(1);
-  }
-
-  // Perform rollback
-  try {
-    const state = loadState();
-
-    // Update phase
-    state.features[feature].phase = targetPhase;
-    state.features[feature].status = 'in_progress';
-    state.features[feature].updatedAt = new Date().toISOString();
-
-    // Reset outputs
-    for (const output of outputsToReset) {
-      if (state.features[feature].outputs[output]) {
-        state.features[feature].outputs[output].created = false;
-      }
-    }
-
-    // Reset tasks if rolling back before tasks phase
-    if (targetIndex < getPhaseIndex('tasks')) {
-      state.features[feature].tasks = {
-        total: 0,
-        completed: 0,
-        inProgress: 0,
-        pending: 0
-      };
-    }
-
-    // Add checkpoint for rollback
-    state.features[feature].checkpoints = state.features[feature].checkpoints || [];
-    state.features[feature].checkpoints.push({
-      timestamp: new Date().toISOString(),
-      phase: targetPhase,
-      completedTasks: 0,
-      note: `Rollback from ${currentPhase} to ${targetPhase}`
-    });
-
-    // Track skipped phases (if any were skipped)
-    if (!state.features[feature].skippedPhases) {
-      state.features[feature].skippedPhases = [];
-    }
-
-    saveState(state);
-
-    console.log(chalk.green('✅ Rollback completed!'));
-    console.log('');
-    console.log(chalk.gray('Current state:'));
-    console.log(chalk.gray(`  Phase: ${targetPhase}`));
-    console.log(chalk.gray(`  Status: in_progress`));
-    console.log('');
-    console.log(chalk.cyan('Next steps:'));
-    console.log(chalk.gray(`  1. Review and update outputs for phase: ${targetPhase}`));
-    console.log(chalk.gray(`  2. Run: morph-spec session-summary ${feature}`));
-
-  } catch (error) {
-    console.log(chalk.red(`❌ Rollback failed: ${error.message}`));
-    process.exit(1);
-  }
-}

package/src/commands/templates/template-customize.js

@@ -1,87 +0,0 @@
-/**
- * Template Customize Command - Copy a framework template to project for customization
- */
-
-import { copyFileSync, existsSync, mkdirSync } from 'fs';
-import { join, dirname } from 'path';
-import chalk from 'chalk';
-import { logger } from '../../utils/logger.js';
-import { getTemplateById, resolveTemplatePathById } from '../../core/templates/template-registry.js';
-
-/**
- * Customize template command - copies framework template to project .morph/framework/templates/
- */
-export async function templateCustomizeCommand(templateId, options) {
-  logger.header(`Customizing Template: ${templateId}`);
-  logger.blank();
-
-  try {
-    // 1. Validate template exists
-    const template = getTemplateById(templateId);
-
-    if (!template) {
-      logger.error(`Template not found: ${templateId}`);
-      logger.dim('\n💡 Use `morph-spec template list` to see available templates');
-      process.exit(1);
-    }
-
-    // 3. Resolve source path (framework template)
-    const projectPath = options.projectPath || process.cwd();
-    const sourcePath = resolveTemplatePathById(templateId, projectPath);
-
-    if (!sourcePath) {
-      logger.error(`Framework template file not found for ${templateId}`);
-      process.exit(1);
-    }
-
-    // 4. Destination is always project-local .morph/framework/templates/
-    const destDir = join(projectPath, '.morph/framework/templates', dirname(template.path));
-    const destPath = join(projectPath, '.morph/framework/templates', template.path);
-
-    // 5. Check if already exists
-    if (existsSync(destPath) && !options.force) {
-      logger.warn('Template already customized at this location');
-      logger.dim(`  ${destPath}`);
-      logger.dim('\n  Use --force to overwrite');
-      process.exit(1);
-    }
-
-    // 6. Copy template
-    logger.dim(`Source: ${sourcePath}`);
-    logger.dim(`Destination: ${destPath}`);
-    logger.blank();
-
-    mkdirSync(destDir, { recursive: true });
-    copyFileSync(sourcePath, destPath);
-
-    logger.success('✅ Template copied for customization');
-    logger.blank();
-
-    // 7. Show next steps
-    logger.info(chalk.bold('📝 Next Steps'));
-    console.log(chalk.dim('  1. Edit the template file:'));
-    console.log(chalk.cyan(`     ${destPath}`));
-    console.log(chalk.dim('\n  2. Template will now be used instead of framework version'));
-    console.log(chalk.dim('     (Stack-specific templates take precedence)'));
-    console.log(chalk.dim('\n  3. Test rendering:'));
-    console.log(chalk.cyan(`     morph-spec template render ${templateId} output.md '{"FEATURE_NAME":"test"}'`));
-
-    if (!options.local) {
-      console.log(chalk.dim('\n  4. To share across stacks, use --local flag'));
-    }
-
-    logger.blank();
-
-    // 8. Show warning about updates
-    logger.warn('⚠️  Customized templates won\'t receive framework updates');
-    logger.dim('   To get updates: delete customized version and re-run this command');
-    logger.blank();
-
-  } catch (error) {
-    logger.error(`Failed to customize template: ${error.message}`);
-    if (options.verbose) {
-      console.error(error.stack);
-    }
-    process.exit(1);
-  }
-}

package/src/commands/templates/template-list.js

@@ -1,114 +0,0 @@
-/**
- * Template List Command - List all available templates with filtering
- */
-
-import chalk from 'chalk';
-import { logger } from '../../utils/logger.js';
-import {
-  getAllTemplates,
-  getTemplatesByCategory,
-  getTemplatesByPhase,
-  getRequiredTemplates,
-  getRegistryStats
-} from '../../core/templates/template-registry.js';
-
-/**
- * Format template for display
- */
-function formatTemplate(template) {
-  const { id, name, category, phase, required, stackSpecific, location, engine, deprecated } = template;
-
-  const badges = [];
-  if (required) badges.push(chalk.green('[REQUIRED]'));
-  if (deprecated) badges.push(chalk.red('[DEPRECATED]'));
-  if (stackSpecific) badges.push(chalk.yellow('[STACK-SPECIFIC]'));
-  else badges.push(chalk.cyan('[UNIVERSAL]'));
-  if (engine === 'handlebars') badges.push(chalk.blue('[HBS]'));
-
-  const badgeStr = badges.join(' ');
-
-  return {
-    id: chalk.bold(id),
-    name,
-    location: location === 'framework' ? chalk.cyan('framework') : chalk.yellow('stack'),
-    category: chalk.dim(category),
-    phase: chalk.dim(phase || 'N/A'),
-    badges: badgeStr
-  };
-}
-
-/**
- * List templates command
- */
-export async function templateListCommand(options) {
-  logger.header('MORPH-SPEC Templates');
-  logger.blank();
-
-  try {
-    let templates;
-
-    // Apply filters
-    if (options.category) {
-      templates = getTemplatesByCategory(options.category);
-      logger.dim(`Category: ${options.category}`);
-    } else if (options.phase) {
-      templates = getTemplatesByPhase(options.phase);
-      logger.dim(`Phase: ${options.phase}`);
-    } else if (options.required) {
-      templates = getRequiredTemplates();
-      logger.dim('Required templates only');
-    } else {
-      templates = getAllTemplates();
-      logger.dim('All templates');
-    }
-
-    logger.blank();
-
-    if (templates.length === 0) {
-      logger.warn('No templates found matching criteria');
-      return;
-    }
-
-    // Group by location if not filtered
-    if (!options.category && !options.phase) {
-      const frameworkTemplates = templates.filter(t => t.location === 'framework');
-      const stackTemplates = templates.filter(t => t.location === 'stack');
-
-      if (frameworkTemplates.length > 0) {
-        logger.info(chalk.bold.cyan(`\n📦 Universal Templates (${frameworkTemplates.length})`));
-        frameworkTemplates.forEach(t => {
-          const formatted = formatTemplate(t);
-          console.log(`  ${formatted.id.padEnd(30)} ${formatted.name.padEnd(40)} ${formatted.badges}`);
-        });
-      }
-
-    } else {
-      // Flat list
-      templates.forEach(t => {
-        const formatted = formatTemplate(t);
-        console.log(`  ${formatted.id.padEnd(30)} ${formatted.name.padEnd(40)} ${formatted.location.padEnd(15)} ${formatted.badges}`);
-      });
-    }
-
-    // Show statistics
-    if (!options.category && !options.phase && !options.stack && !options.required) {
-      logger.blank();
-      const stats = getRegistryStats();
-      logger.info(chalk.bold('\n📊 Statistics'));
-      console.log(`  Total Templates: ${chalk.green(stats.total)}`);
-      console.log(`  Framework: ${chalk.cyan(stats.framework)}`);
-      console.log(`  Required: ${chalk.green(stats.required)}`);
-      console.log(`  Optional: ${chalk.dim(stats.optional)}`);
-    }
-
-    logger.blank();
-
-    // Show usage hint
-    logger.dim('💡 Use `morph-spec template show <id>` to see template details');
-    logger.blank();
-
-  } catch (error) {
-    logger.error(`Failed to list templates: ${error.message}`);
-    process.exit(1);
-  }
-}

package/src/commands/templates/template-show.js

@@ -1,129 +0,0 @@
-/**
- * Template Show Command - Display detailed information about a template
- */
-
-import chalk from 'chalk';
-import { logger } from '../../utils/logger.js';
-import { getTemplateById, resolveTemplatePathById } from '../../core/templates/template-registry.js';
-import { readFileSync, existsSync } from 'fs';
-
-/**
- * Show template details command
- */
-export async function templateShowCommand(templateId, options) {
-  logger.header(`Template: ${templateId}`);
-  logger.blank();
-
-  try {
-    const template = getTemplateById(templateId);
-
-    if (!template) {
-      logger.error(`Template not found: ${templateId}`);
-      logger.dim('\n💡 Use `morph-spec template list` to see available templates');
-      process.exit(1);
-    }
-
-    // Display template metadata
-    logger.info(chalk.bold('📋 Metadata'));
-    console.log(`  ID: ${chalk.cyan(template.id)}`);
-    console.log(`  Name: ${chalk.green(template.name)}`);
-    console.log(`  Path: ${chalk.dim(template.path)}`);
-    console.log(`  Location: ${template.location === 'framework' ? chalk.cyan('framework') : chalk.yellow('stack')}`);
-    console.log(`  Category: ${template.category}`);
-    console.log(`  Phase: ${template.phase || 'N/A'}`);
-    console.log(`  Required: ${template.required ? chalk.green('Yes') : chalk.dim('No')}`);
-    console.log(`  Stack-Specific: ${template.stackSpecific ? chalk.yellow('Yes') : chalk.cyan('No (universal)')}`);
-
-    if (template.stackSpecific && template.stacks) {
-      console.log(`  Stacks: ${chalk.yellow(template.stacks.join(', '))}`);
-    }
-
-    console.log(`  Engine: ${template.engine === 'handlebars' ? chalk.blue('Handlebars') : chalk.dim('Custom')}`);
-
-    if (template.deprecated) {
-      console.log(`  ${chalk.red.bold('⚠️  DEPRECATED')}`);
-    }
-
-    if (template.autoGenerated) {
-      console.log(`  ${chalk.dim('Auto-generated (not user-facing)')}`);
-    }
-
-    logger.blank();
-
-    // Description
-    if (template.description) {
-      logger.info(chalk.bold('📝 Description'));
-      console.log(`  ${template.description}`);
-      logger.blank();
-    }
-
-    // Placeholders
-    if (template.placeholders && template.placeholders.length > 0) {
-      logger.info(chalk.bold('🔑 Variables'));
-      template.placeholders.forEach(p => {
-        console.log(`  ${chalk.cyan(`{{${p}}}`)}`);
-      });
-      logger.blank();
-    }
-
-    // Output name
-    if (template.outputName) {
-      logger.info(chalk.bold('📄 Output Name'));
-      console.log(`  ${chalk.dim(template.outputName)}`);
-      logger.blank();
-    }
-
-    // Resolve actual path
-    if (options.showPath) {
-      const projectPath = options.projectPath || process.cwd();
-      const resolvedPath = resolveTemplatePathById(templateId, projectPath);
-
-      logger.info(chalk.bold('📂 Resolved Path'));
-      if (resolvedPath) {
-        console.log(`  ${chalk.green(resolvedPath)}`);
-        console.log(`  ${chalk.dim(`(${existsSync(resolvedPath) ? 'exists' : 'not found'})`)}`);
-      } else {
-        console.log(`  ${chalk.red('Not found in .morph/framework/templates/ or framework/templates/')}`);
-      }
-      logger.blank();
-    }
-
-    // Show template preview
-    if (options.preview) {
-      const projectPath = options.projectPath || process.cwd();
-      const resolvedPath = resolveTemplatePathById(templateId, projectPath);
-
-      if (resolvedPath && existsSync(resolvedPath)) {
-        logger.info(chalk.bold('👁️  Preview (first 20 lines)'));
-        logger.blank();
-
-        const content = readFileSync(resolvedPath, 'utf-8');
-        const lines = content.split('\n').slice(0, 20);
-
-        lines.forEach((line, i) => {
-          console.log(chalk.dim(`${String(i + 1).padStart(3)}  ${line}`));
-        });
-
-        if (content.split('\n').length > 20) {
-          logger.blank();
-          logger.dim(`  ... (${content.split('\n').length - 20} more lines)`);
-        }
-
-        logger.blank();
-      } else {
-        logger.warn('Template file not found - cannot preview');
-      }
-    }
-
-    // Show usage hint
-    if (template.engine === 'handlebars') {
-      logger.info(chalk.bold('💡 Usage Hint'));
-      console.log(chalk.dim(`  morph-spec template render ${templateId} output.md '{"FEATURE_NAME":"my-feature"}'`));
-      logger.blank();
-    }
-
-  } catch (error) {
-    logger.error(`Failed to show template: ${error.message}`);
-    process.exit(1);
-  }
-}

package/src/commands/templates/template-validate.js

@@ -1,91 +0,0 @@
-/**
- * Template Validate Command - Validate Handlebars templates
- */
-
-import chalk from 'chalk';
-import { logger } from '../../utils/logger.js';
-import { validateTemplate, validateAllTemplates, formatValidationResults, summarizeValidation } from '../../core/templates/template-validator.js';
-
-/**
- * Validate template(s) command
- */
-export async function templateValidateCommand(templateId, options) {
-  const projectPath = options.projectPath || process.cwd();
-
-  if (templateId) {
-    // Validate single template
-    logger.header(`Validating Template: ${templateId}`);
-    logger.blank();
-
-    const result = validateTemplate(templateId, projectPath);
-
-    // Display results
-    if (result.errors.length === 0 && result.warnings.length === 0) {
-      logger.success(`✅ Template is valid`);
-      logger.blank();
-
-      if (result.info.length > 0 && options.verbose) {
-        logger.info(chalk.bold('ℹ️  Information'));
-        result.info.forEach(info => console.log(chalk.dim(`  ${info}`)));
-        logger.blank();
-      }
-    } else {
-      if (result.errors.length > 0) {
-        logger.error(chalk.bold('❌ Errors'));
-        result.errors.forEach(error => console.log(chalk.red(`  - ${error}`)));
-        logger.blank();
-      }
-
-      if (result.warnings.length > 0) {
-        logger.warn(chalk.bold('⚠️  Warnings'));
-        result.warnings.forEach(warning => console.log(chalk.yellow(`  - ${warning}`)));
-        logger.blank();
-      }
-
-      if (result.info.length > 0 && options.verbose) {
-        logger.info(chalk.bold('ℹ️  Information'));
-        result.info.forEach(info => console.log(chalk.dim(`  ${info}`)));
-        logger.blank();
-      }
-
-      if (result.errors.length > 0) {
-        process.exit(1);
-      }
-    }
-  } else {
-    // Validate all templates
-    logger.header('Validating All Templates');
-    logger.blank();
-
-    const validationOptions = {
-      skipDeprecated: !options.includeDeprecated,
-      category: options.category,
-      technology: options.technology,
-    };
-
-    const results = validateAllTemplates(projectPath, validationOptions);
-    const summary = summarizeValidation(results);
-
-    // Display results
-    const formatted = formatValidationResults(results, {
-      showInfo: options.verbose,
-      showValid: options.showValid,
-    });
-
-    console.log(formatted);
-    logger.blank();
-
-    // Exit with error if any templates have errors
-    if (summary.hasErrors > 0) {
-      logger.error(`${summary.hasErrors} template(s) failed validation`);
-      process.exit(1);
-    } else if (summary.hasWarnings > 0) {
-      logger.warn(`${summary.hasWarnings} template(s) have warnings`);
-      if (options.strict) {
-        process.exit(1);
-      }
-    } else {
-      logger.success(`All templates are valid! ✅`);
-    }
-  }
-}