@polymorphism-tech/morph-spec 4.7.2 → 4.8.4

package/src/commands/project/standards.js

@@ -1,80 +0,0 @@
-/**
- * Standards CLI Commands
- *
- * Provides browsable access to the framework standards registry.
- * Usage:
- *   morph-spec standards --list
- *   morph-spec standards --search <query>
- *   morph-spec standards --show <id>
- *   morph-spec standards --category <cat>
- */
-
-import { readFileSync } from 'fs';
-import { join } from 'path';
-import { fileURLToPath } from 'url';
-import { logger } from '../../utils/logger.js';
-
-const __dirname = fileURLToPath(new URL('.', import.meta.url));
-const REGISTRY_PATH = join(__dirname, '..', '..', '..', 'framework', 'standards', 'STANDARDS.json');
-
-function loadRegistry() {
-  return JSON.parse(readFileSync(REGISTRY_PATH, 'utf8')).standards;
-}
-
-/**
- * List all standards, optionally filtered by category.
- * @param {{ json?: boolean, category?: string }} opts
- * @returns {Promise<Array>}
- */
-export async function listStandards({ json, category } = {}) {
-  let standards = loadRegistry();
-  if (category) {
-    standards = standards.filter(s => s.category === category);
-  }
-  if (json) return standards;
-  standards.forEach(s =>
-    logger.info(`${s.id.padEnd(55)} ${s.category}`)
-  );
-  return standards;
-}
-
-/**
- * Search standards by query string (matches id, name, or tags).
- * @param {string} query
- * @param {{ json?: boolean }} opts
- * @returns {Promise<Array>}
- */
-export async function searchStandards(query, { json } = {}) {
-  const q = query.toLowerCase();
-  const results = loadRegistry().filter(s =>
-    s.name.toLowerCase().includes(q) ||
-    s.id.toLowerCase().includes(q) ||
-    s.tags.some(t => t.toLowerCase().includes(q))
-  );
-  if (json) return results;
-  if (results.length === 0) {
-    logger.warn(`No standards found matching "${query}"`);
-  } else {
-    results.forEach(s => logger.info(`${s.id}: ${s.name}  [${s.category}]`));
-  }
-  return results;
-}
-
-/**
- * Show the full content of a standard by its id.
- * @param {string} id
- * @returns {Promise<string|null>}
- */
-export async function showStandard(id) {
-  const standard = loadRegistry().find(s => s.id === id);
-  if (!standard) {
-    logger.error(`Standard '${id}' not found. Use --list to see available standards.`);
-    return null;
-  }
-  const content = readFileSync(
-    join(__dirname, '..', '..', '..', 'framework', 'standards', standard.path),
-    'utf8'
-  );
-  logger.info(content);
-  return content;
-}

package/src/commands/project/sync.js

@@ -1,167 +0,0 @@
-import { join } from 'path';
-import { readdirSync, existsSync } from 'fs';
-import ora from 'ora';
-import chalk from 'chalk';
-import { logger } from '../../utils/logger.js';
-import { readFile, writeFile, ensureDir } from '../../utils/file-copier.js';
-import { analyzeConversation } from '../../lib/detectors/conversation-analyzer.js';
-
-export async function syncCommand(options) {
-  const targetPath = options.path || process.cwd();
-
-  logger.header('MORPH-SPEC Standards Sync');
-  logger.dim(`Project: ${targetPath}`);
-  logger.blank();
-
-  const spinner = ora('Analyzing feature decisions...').start();
-
-  try {
-    // 1. Find all decisions.md files
-    const outputsPath = join(targetPath, '.morph', 'project', 'outputs');
-
-    if (!existsSync(outputsPath)) {
-      spinner.warn('No features found');
-      logger.dim('Create features first using MORPH workflow.');
-      return;
-    }
-
-    const features = readdirSync(outputsPath, { withFileTypes: true })
-      .filter(dirent => dirent.isDirectory())
-      .map(dirent => dirent.name);
-
-    if (features.length === 0) {
-      spinner.warn('No features found');
-      return;
-    }
-
-    spinner.text = `Found ${features.length} features, analyzing decisions...`;
-
-    // 2. Analyze all decisions
-    const conversation = await analyzeConversation(targetPath);
-
-    if (conversation.decisions.length === 0) {
-      spinner.warn('No decisions found to sync');
-      logger.dim('Features may not have decisions.md files yet.');
-      return;
-    }
-
-    spinner.succeed(`Found ${conversation.decisions.length} decisions`);
-    logger.blank();
-
-    // 3. Group by category
-    const byCategory = groupByCategory(conversation.decisions);
-
-    // 4. Display candidates
-    logger.header('Decisions by Category:');
-    logger.blank();
-
-    let totalCandidates = 0;
-
-    for (const [category, decisions] of Object.entries(byCategory)) {
-      if (decisions.length > 0) {
-        logger.info(chalk.cyan(`${formatCategory(category)} (${decisions.length})`));
-        decisions.slice(0, 3).forEach(d => {
-          const preview = d.text.split('\n')[0].substring(0, 70);
-          logger.dim(`  - ${preview}...`);
-        });
-        if (decisions.length > 3) {
-          logger.dim(`  ... and ${decisions.length - 3} more`);
-        }
-        logger.blank();
-        totalCandidates += decisions.length;
-      }
-    }
-
-    // 5. Sync (for now, just report - interactive approval would be added later)
-    if (options.dryRun) {
-      logger.warn('Dry run mode - no files updated');
-      logger.dim(`Would update ${Object.keys(byCategory).length} standard files`);
-      return;
-    }
-
-    spinner.start('Updating standards...');
-
-    const standardsDir = join(targetPath, '.morph', 'project', 'standards');
-    await ensureDir(standardsDir);
-
-    let updatedFiles = [];
-
-    for (const [category, decisions] of Object.entries(byCategory)) {
-      if (decisions.length === 0) continue;
-
-      const fileName = `${category}.md`;
-      const filePath = join(standardsDir, fileName);
-
-      // Read existing or create new
-      let content = '';
-      if (existsSync(filePath)) {
-        content = await readFile(filePath);
-      } else {
-        content = `# ${formatCategory(category)} Standards\n\n> Project-specific standards for ${category}\n\n`;
-      }
-
-      // Append new decisions
-      content += `\n## Decisions from Features (${new Date().toISOString().split('T')[0]})\n\n`;
-
-      decisions.forEach((d, idx) => {
-        const preview = d.text.split('\n').slice(0, 5).join('\n');
-        content += `### Decision ${idx + 1}\n\n${preview}\n\n`;
-      });
-
-      await writeFile(filePath, content);
-      updatedFiles.push(fileName);
-    }
-
-    spinner.succeed(`Updated ${updatedFiles.length} standard files`);
-
-    updatedFiles.forEach(file => {
-      logger.dim(`  - ${file}`);
-    });
-
-    logger.blank();
-    logger.success('Standards sync complete!');
-    logger.dim('Commit these changes with a sync: message.');
-
-  } catch (error) {
-    spinner.fail('Sync failed');
-    logger.error(error.message);
-    process.exit(1);
-  }
-}
-
-/**
- * Group decisions by category
- */
-function groupByCategory(decisions) {
-  const categories = {
-    'coding': [],
-    'architecture': [],
-    'azure': [],
-    'integrations': [],
-    'ui-ux': []
-  };
-
-  decisions.forEach(decision => {
-    const category = decision.category || 'coding';
-    if (categories[category]) {
-      categories[category].push(decision);
-    }
-  });
-
-  return categories;
-}
-
-/**
- * Format category name
- */
-function formatCategory(category) {
-  const names = {
-    'coding': 'Coding Standards',
-    'architecture': 'Architecture Patterns',
-    'azure': 'Azure & Infrastructure',
-    'integrations': 'Integration Patterns',
-    'ui-ux': 'UI/UX Standards'
-  };
-
-  return names[category] || category;
-}

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);
-  }
-}