@polymorphism-tech/morph-spec 4.7.2 → 4.8.4

package/src/commands/feature/shard-spec.js

@@ -1,225 +0,0 @@
-/**
- * MORPH-SPEC Document Sharding
- * Splits large spec.md files into manageable shards (BMAD-inspired)
- * Achieves 90% token savings by loading only relevant sections
- */
-
-import fs from 'fs';
-import path from 'path';
-import ora from 'ora';
-import chalk from 'chalk';
-import { getAbsoluteOutputPath } from '../../core/paths/output-schema.js';
-import { logger } from '../../utils/logger.js';
-import { ensureDir, writeFile } from '../../utils/file-copier.js';
-
-// ============================================================================
-// Helper Functions
-// ============================================================================
-
-function parseSpec(specContent) {
-  const sections = [];
-  const lines = specContent.split('\n');
-
-  let currentSection = null;
-  let currentContent = [];
-
-  for (const line of lines) {
-    // Detect level 2 heading (## Heading)
-    if (line.match(/^## /)) {
-      // Save previous section
-      if (currentSection) {
-        sections.push({
-          title: currentSection,
-          slug: toSlug(currentSection),
-          content: currentContent.join('\n').trim(),
-        });
-      }
-
-      // Start new section
-      currentSection = line.replace(/^## /, '').trim();
-      currentContent = [line]; // Include heading in content
-    } else {
-      currentContent.push(line);
-    }
-  }
-
-  // Save last section
-  if (currentSection) {
-    sections.push({
-      title: currentSection,
-      slug: toSlug(currentSection),
-      content: currentContent.join('\n').trim(),
-    });
-  }
-
-  return sections;
-}
-
-function toSlug(title) {
-  return title
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-|-$/g, '');
-}
-
-function generateIndex(sections, featureName) {
-  let index = `# ${toTitleCase(featureName)} - Technical Specification\n\n`;
-  index += `> **Sharded Spec:** This spec has been split into sections for optimal token usage\n`;
-  index += `> **BMAD Pattern:** Load only the section you need during implementation\n\n`;
-  index += `---\n\n`;
-  index += `## 📋 Table of Contents\n\n`;
-
-  sections.forEach((section, i) => {
-    index += `${i + 1}. **[${section.title}](${section.slug}.md)**\n`;
-
-    // Add first 100 chars as description
-    const firstLine = section.content.split('\n').find(l => l.trim() && !l.startsWith('#'));
-    const description = firstLine ? firstLine.substring(0, 100) + '...' : 'See section for details';
-    index += `   > ${description}\n\n`;
-  });
-
-  index += `---\n\n`;
-  index += `## 💡 How to Use Sharded Specs\n\n`;
-  index += `### In Planning Phases (1-3)\n`;
-  index += `Load **all sections** to get complete context:\n`;
-  index += `\`\`\`bash\n`;
-  index += `# Read index.md + all section files\n`;
-  index += `\`\`\`\n\n`;
-
-  index += `### In Implementation Phase (4)\n`;
-  index += `Load **only the relevant section** for your current story:\n`;
-  index += `\`\`\`bash\n`;
-  index += `# Example: Working on entity design story\n`;
-  index += `# Read: spec/index.md + spec/entity-design.md (not the other 10 sections!)\n`;
-  index += `\`\`\`\n\n`;
-
-  index += `**Token Savings:** For a 10-section spec (30k tokens), selective loading = **90% savings**\n\n`;
-  index += `---\n\n`;
-  index += `*Generated by MORPH-SPEC Framework - Document Sharding*\n`;
-  index += `*Inspired by BMAD Method: 90% token reduction for large specs*\n`;
-
-  return index;
-}
-
-function toTitleCase(str) {
-  return str
-    .split('-')
-    .map(word => word.charAt(0).toUpperCase() + word.slice(1))
-    .join(' ');
-}
-
-function estimateTokens(text) {
-  // Rough estimate: 1 token ≈ 4 characters
-  return Math.ceil(text.length / 4);
-}
-
-// ============================================================================
-// Command Function
-// ============================================================================
-
-export async function shardSpecCommand(feature, options) {
-  logger.header('MORPH-SPEC Document Sharding');
-  logger.dim(`Feature: ${feature}`);
-  logger.blank();
-
-  const spinner = ora('Analyzing spec.md...').start();
-
-  try {
-    // Find spec.md
-    const specPath = getAbsoluteOutputPath(process.cwd(), feature, 'spec');
-    if (!fs.existsSync(specPath)) {
-      throw new Error(`Spec not found: ${specPath}`);
-    }
-
-    // Read spec content
-    const specContent = fs.readFileSync(specPath, 'utf-8');
-    const totalTokens = estimateTokens(specContent);
-
-    spinner.info(`Original spec.md: ~${totalTokens.toLocaleString()} tokens`);
-    logger.blank();
-
-    // Parse into sections
-    const sections = parseSpec(specContent);
-
-    if (sections.length < 3) {
-      spinner.warn(`Spec has only ${sections.length} sections - sharding not recommended`);
-      logger.dim('  Sharding is most beneficial for specs with 5+ sections');
-      return;
-    }
-
-    spinner.succeed(`Detected ${sections.length} sections`);
-    logger.blank();
-
-    // Generate index
-    const indexContent = generateIndex(sections, feature);
-
-    // Calculate savings
-    const avgShardTokens = sections.reduce((sum, s) => sum + estimateTokens(s.content), 0) / sections.length;
-    const savingsPercent = Math.round(((totalTokens - avgShardTokens) / totalTokens) * 100);
-
-    logger.header('Token Savings (selective load):');
-    logger.info(`  ${chalk.green(`~${savingsPercent}%`)} reduction`);
-    logger.dim(`  - Full load: ~${totalTokens.toLocaleString()} tokens`);
-    logger.dim(`  - Selective load: ~${Math.round(avgShardTokens).toLocaleString()} tokens (index + 1 shard)`);
-    logger.blank();
-
-    if (options.verbose) {
-      logger.header('Shard Details:');
-      logger.blank();
-      sections.forEach((section, i) => {
-        const tokens = estimateTokens(section.content);
-        logger.dim(`  ${i + 1}. ${section.title}`);
-        logger.dim(`     File: ${section.slug}.md`);
-        logger.dim(`     Tokens: ~${tokens.toLocaleString()}`);
-        logger.blank();
-      });
-    }
-
-    // Output
-    const outputDir = path.join(process.cwd(), `.morph/features/${feature}/1-design/spec`);
-
-    if (options.dryRun) {
-      logger.header('DRY RUN - Would create:');
-      logger.dim(`  ${outputDir}/index.md`);
-      sections.forEach(s => logger.dim(`  ${outputDir}/${s.slug}.md`));
-      logger.blank();
-      logger.success('Run without --dry-run to create files');
-    } else {
-      const createSpinner = ora('Creating sharded spec files...').start();
-
-      // Create directory
-      await ensureDir(outputDir);
-
-      // Write index
-      await writeFile(path.join(outputDir, 'index.md'), indexContent);
-      createSpinner.text = 'Created index.md';
-
-      // Write shards
-      for (const section of sections) {
-        const shardPath = path.join(outputDir, `${section.slug}.md`);
-        await writeFile(shardPath, section.content);
-        createSpinner.text = `Created ${section.slug}.md`;
-      }
-
-      createSpinner.succeed('Sharded spec created!');
-      logger.blank();
-
-      // Archive original spec.md
-      const archivePath = specPath.replace('.md', '.original.md');
-      fs.renameSync(specPath, archivePath);
-      logger.dim('  Archived original: spec.original.md');
-      logger.blank();
-
-      logger.header('Next steps:');
-      logger.dim(`  1. Review sharded spec in .morph/features/${feature}/1-design/spec/`);
-      logger.dim(`  2. Create stories: morph-spec story create ${feature} SR-001`);
-      logger.dim('  3. Stories will auto-load only relevant shards (90% token savings)');
-      logger.blank();
-    }
-
-  } catch (error) {
-    spinner.fail('Sharding failed');
-    logger.error(error.message);
-    process.exit(1);
-  }
-}

package/src/commands/feature/sprint-status.js

@@ -1,250 +0,0 @@
-/**
- * MORPH-SPEC Sprint Status Manager
- * Updates sprint-status.yaml and shows next story
- */
-
-import fs from 'fs';
-import path from 'path';
-import yaml from 'yaml';
-import ora from 'ora';
-import chalk from 'chalk';
-import { logger } from '../../utils/logger.js';
-
-// ============================================================================
-// Helper Functions
-// ============================================================================
-
-function loadSprintStatus(featureName) {
-  const statusPath = path.join(process.cwd(), `.morph/features/${featureName}/sprint-status.yaml`);
-
-  if (!fs.existsSync(statusPath)) {
-    throw new Error(`Sprint status not found: ${statusPath}\n\n💡 Create a sprint status file first:\n   morph-spec story create ${featureName} STORY-001`);
-  }
-
-  const content = fs.readFileSync(statusPath, 'utf-8');
-  return { path: statusPath, data: yaml.parse(content) };
-}
-
-function saveSprintStatus(statusPath, data) {
-  const content = yaml.stringify(data);
-  fs.writeFileSync(statusPath, content);
-}
-
-function updateMetrics(sprint) {
-  const stories = sprint.stories || [];
-  const metrics = {
-    total_stories: stories.length,
-    ready: stories.filter(s => s.status === 'ready').length,
-    in_progress: stories.filter(s => s.status === 'in_progress').length,
-    ready_for_qa: stories.filter(s => s.status === 'ready_for_qa').length,
-    done: stories.filter(s => s.status === 'done').length,
-  };
-
-  metrics.completion_percent = stories.length > 0
-    ? Math.round((metrics.done / stories.length) * 100)
-    : 0;
-
-  sprint.metrics = metrics;
-  sprint.updated = new Date().toISOString().split('T')[0];
-}
-
-function findStory(sprint, storyId) {
-  return sprint.stories.find(s => s.id === storyId);
-}
-
-function getNextStory(sprint) {
-  // Find first story that is "ready" (not in_progress or done)
-  return sprint.stories.find(s => s.status === 'ready' || s.status === 'pending');
-}
-
-function displayStatus(sprint) {
-  logger.header(`Sprint Status: ${sprint.feature}`);
-  logger.blank();
-  logger.info(`Epic: ${chalk.cyan(sprint.epic)}`);
-  logger.info(`Progress: ${chalk.green(`${sprint.metrics.completion_percent}%`)} (${sprint.metrics.done}/${sprint.metrics.total_stories} stories done)`);
-  logger.blank();
-
-  logger.header('Stories:');
-  sprint.stories.forEach(story => {
-    const statusEmoji = {
-      pending: '⏸️ ',
-      ready: '✅',
-      in_progress: '🔄',
-      ready_for_qa: '👀',
-      done: '✔️ ',
-    }[story.status] || '❓';
-
-    const statusColor = {
-      pending: chalk.dim,
-      ready: chalk.cyan,
-      in_progress: chalk.yellow,
-      ready_for_qa: chalk.magenta,
-      done: chalk.green,
-    }[story.status] || chalk.white;
-
-    logger.dim(`  ${statusEmoji} ${story.id}: ${story.title} ${statusColor(`(${story.status})`)}`);
-  });
-  logger.blank();
-
-  if (sprint.current && sprint.current.story_id) {
-    logger.info(`🎯 Current Focus: ${chalk.cyan(sprint.current.story_id)} (${sprint.current.agent} agent)`);
-  }
-
-  if (sprint.next && sprint.next.story_id) {
-    logger.info(`📋 Next Story: ${chalk.cyan(sprint.next.story_id)}`);
-    logger.dim(`   ${sprint.next.recommendation || 'Ready for development'}`);
-  }
-
-  logger.blank();
-}
-
-// ============================================================================
-// Command Function
-// ============================================================================
-
-export async function sprintStatusCommand(feature, action, storyId, options) {
-  // Default action is 'show'
-  const cmd = action || 'show';
-
-  if (cmd === 'help' || options.help) {
-    logger.header('MORPH-SPEC Sprint Status Manager');
-    logger.blank();
-    logger.info('Usage:');
-    logger.dim('  morph-spec story status <feature> [command] [story-id]');
-    logger.blank();
-    logger.info('Commands:');
-    logger.dim('  show                      Display current sprint status (default)');
-    logger.dim('  start <story-id>          Mark story as in_progress');
-    logger.dim('  qa <story-id>             Mark story as ready_for_qa');
-    logger.dim('  done <story-id>           Mark story as done');
-    logger.dim('  next                      Show next story to work on');
-    logger.blank();
-    logger.info('Examples:');
-    logger.dim('  morph-spec story status scheduled-reports show');
-    logger.dim('  morph-spec story status scheduled-reports start SR-001');
-    logger.dim('  morph-spec story status scheduled-reports qa SR-001');
-    logger.dim('  morph-spec story status scheduled-reports done SR-001');
-    logger.dim('  morph-spec story status scheduled-reports next');
-    logger.blank();
-    return;
-  }
-
-  try {
-    // Load sprint status
-    const { path: statusPath, data: sprint } = loadSprintStatus(feature);
-
-    // Execute command
-    switch (cmd) {
-      case 'show':
-        displayStatus(sprint);
-        break;
-
-      case 'start':
-        if (!storyId) {
-          throw new Error('Story ID required for "start" command');
-        }
-        const storyToStart = findStory(sprint, storyId);
-        if (!storyToStart) {
-          throw new Error(`Story not found: ${storyId}`);
-        }
-
-        const spinner = ora('Updating story status...').start();
-        storyToStart.status = 'in_progress';
-        storyToStart.started = new Date().toISOString().split('T')[0];
-        storyToStart.assigned = 'dev';
-        sprint.current = { story_id: storyId, agent: 'dev', phase: 'implementation' };
-        updateMetrics(sprint);
-        saveSprintStatus(statusPath, sprint);
-        spinner.succeed(`Story ${chalk.cyan(storyId)} marked as IN PROGRESS`);
-        logger.blank();
-        logger.info('💡 Recommendation: Run this story in a FRESH Claude session');
-        logger.dim('   /dev → Implement story → Add Dev Notes');
-        logger.blank();
-        break;
-
-      case 'qa':
-        if (!storyId) {
-          throw new Error('Story ID required for "qa" command');
-        }
-        const storyForQA = findStory(sprint, storyId);
-        if (!storyForQA) {
-          throw new Error(`Story not found: ${storyId}`);
-        }
-
-        const qaSpinner = ora('Updating story status...').start();
-        storyForQA.status = 'ready_for_qa';
-        storyForQA.assigned = 'qa';
-        sprint.current = { story_id: storyId, agent: 'qa', phase: 'review' };
-        updateMetrics(sprint);
-        saveSprintStatus(statusPath, sprint);
-        qaSpinner.succeed(`Story ${chalk.cyan(storyId)} marked as READY FOR QA`);
-        logger.blank();
-        logger.info('💡 Recommendation: QA in a FRESH Claude session');
-        logger.dim('   /qa → Review code → Add QA Notes');
-        logger.blank();
-        break;
-
-      case 'done':
-        if (!storyId) {
-          throw new Error('Story ID required for "done" command');
-        }
-        const storyDone = findStory(sprint, storyId);
-        if (!storyDone) {
-          throw new Error(`Story not found: ${storyId}`);
-        }
-
-        const doneSpinner = ora('Updating story status...').start();
-        storyDone.status = 'done';
-        storyDone.completed = new Date().toISOString().split('T')[0];
-        updateMetrics(sprint);
-
-        // Update next story
-        const nextStory = getNextStory(sprint);
-        if (nextStory) {
-          sprint.next = {
-            story_id: nextStory.id,
-            recommendation: `Story ${nextStory.id} is ready for development`,
-          };
-        } else {
-          sprint.next = null;
-        }
-
-        saveSprintStatus(statusPath, sprint);
-        doneSpinner.succeed(`Story ${chalk.cyan(storyId)} marked as DONE`);
-        logger.blank();
-
-        if (nextStory) {
-          logger.info(`📋 Next Story: ${chalk.cyan(nextStory.id)}`);
-          logger.dim(`   ${nextStory.title}`);
-          logger.blank();
-        } else {
-          logger.success('🎉 All stories completed! Feature ready for final review.');
-          logger.blank();
-        }
-        break;
-
-      case 'next':
-        const next = getNextStory(sprint);
-        if (next) {
-          logger.header('Next Story:');
-          logger.blank();
-          logger.info(`📋 Story ID: ${chalk.cyan(next.id)}`);
-          logger.info(`   Title: ${next.title}`);
-          logger.info(`   File: ${chalk.dim(next.file)}`);
-          logger.info(`   Status: ${next.status}`);
-          logger.blank();
-        } else {
-          logger.success('🎉 No pending stories! Sprint complete.');
-          logger.blank();
-        }
-        break;
-
-      default:
-        throw new Error(`Unknown command: ${cmd}\n   Use --help to see available commands`);
-    }
-
-  } catch (error) {
-    logger.error(error.message);
-    process.exit(1);
-  }
-}

package/src/commands/generation/generate-onboarding.js

@@ -1,169 +0,0 @@
-/**
- * Generate Onboarding Command
- *
- * Reads project context and renders the onboarding template
- * with detected MCPs, agents, standards, and workflow info.
- */
-
-import { join } from 'path';
-import { existsSync, readFileSync, readdirSync } from 'fs';
-import chalk from 'chalk';
-import { logger } from '../../utils/logger.js';
-import { pathExists, readJson, writeFile, ensureDir } from '../../utils/file-copier.js';
-import { getInstalledCLIVersion } from '../../utils/version-checker.js';
-
-export async function generateOnboardingCommand(options = {}) {
-  const targetPath = process.cwd();
-  const configPath = join(targetPath, '.morph', 'config', 'config.json');
-  const integrationsPath = join(targetPath, '.morph', 'config', 'integrations.json');
-  const agentsPath = join(targetPath, '.morph', 'config', 'agents.json');
-
-  logger.header('Generating Onboarding Guide');
-
-  // Load config
-  if (!(await pathExists(configPath))) {
-    logger.error('Project not initialized. Run "morph-spec init" first.');
-    process.exit(1);
-  }
-
-  const config = await readJson(configPath);
-  const integrations = await pathExists(integrationsPath) ? await readJson(integrationsPath) : null;
-
-  // Build template variables
-  const projectName = config?.project?.name || 'Unknown Project';
-  const stack = config?.project?.stack || config?.project?.architecture || 'not detected';
-  const architecture = config?.project?.architecture || 'not detected';
-  const version = getInstalledCLIVersion();
-  const date = new Date().toISOString().split('T')[0];
-
-  // Build agents list
-  let agentsList = 'No agents configuration found. Run `morph-spec init` to set up.';
-  if (await pathExists(agentsPath)) {
-    try {
-      const agentsConfig = await readJson(agentsPath);
-      const agents = agentsConfig.agents || {};
-      const lines = [];
-      for (const [id, agent] of Object.entries(agents)) {
-        const emoji = agent.emoji || '';
-        const tier = agent.tier ? `Tier ${agent.tier}` : '';
-        lines.push(`- ${emoji} **${agent.name || id}** (${tier}) — ${agent.role || agent.responsibilities?.[0] || ''}`);
-      }
-      if (lines.length > 0) {
-        agentsList = lines.join('\n');
-      }
-    } catch {
-      // Use default
-    }
-  }
-
-  // Build MCPs summary
-  let availableMcps = 'No MCPs detected. Install MCP servers and run `morph-spec init --force` to detect.';
-  if (integrations) {
-    const lines = [];
-
-    if (integrations.plugins?.length > 0) {
-      lines.push('**Plugins:**');
-      for (const p of integrations.plugins) {
-        const ver = p.version ? ` v${p.version}` : '';
-        lines.push(`- ${p.name}${ver}`);
-      }
-    }
-
-    if (integrations.mcpServers?.length > 0) {
-      lines.push('');
-      lines.push('**MCP Servers:**');
-
-      const phaseMap = {
-        context7: 'proposal, design, tasks, implement',
-        supabase: 'design, implement',
-        playwright: 'UI/UX, implement',
-        github: 'setup, tasks, implement',
-        figma: 'UI/UX'
-      };
-
-      for (const s of integrations.mcpServers) {
-        const name = s.name.toLowerCase();
-        const phases = Object.entries(phaseMap).find(([k]) => name.includes(k));
-        const phaseStr = phases ? ` (phases: ${phases[1]})` : '';
-        lines.push(`- **${s.name}** (${s.source})${phaseStr}`);
-      }
-    }
-
-    if (integrations.superpowers?.installed) {
-      lines.push('');
-      lines.push(`**Superpowers:** installed (${integrations.superpowers.skills?.length || 0} skills)`);
-    }
-
-    if (lines.length > 0) {
-      availableMcps = lines.join('\n');
-    }
-  }
-
-  // Build standards summary
-  let standardsSummary = 'Using morph-spec defaults.';
-  const standardsDir = join(targetPath, '.morph', 'standards');
-  if (existsSync(standardsDir)) {
-    try {
-      const standards = collectStandards(standardsDir);
-      if (standards.length > 0) {
-        standardsSummary = standards.map(s => `- ${s}`).join('\n');
-      }
-    } catch {
-      // Use default
-    }
-  }
-
-  // Build workflow summary
-  const workflowSummary = 'Workflow is **auto-detected** from your feature request. The framework analyzes keywords and complexity to choose the best workflow.';
-
-  // Read template
-  const templatePath = join(import.meta.dirname, '..', '..', '..', 'framework', 'templates', 'docs', 'onboarding.md');
-  let template;
-  if (existsSync(templatePath)) {
-    template = readFileSync(templatePath, 'utf-8');
-  } else {
-    logger.error('Onboarding template not found.');
-    process.exit(1);
-  }
-
-  // Replace placeholders
-  let content = template
-    .replace(/\{\{PROJECT_NAME\}\}/g, projectName)
-    .replace(/\{\{STACK\}\}/g, stack)
-    .replace(/\{\{ARCHITECTURE\}\}/g, architecture)
-    .replace(/\{\{DATE\}\}/g, date)
-    .replace(/\{\{VERSION\}\}/g, version)
-    .replace(/\{\{AGENTS_LIST\}\}/g, agentsList)
-    .replace(/\{\{AVAILABLE_MCPS\}\}/g, availableMcps)
-    .replace(/\{\{STANDARDS_SUMMARY\}\}/g, standardsSummary)
-    .replace(/\{\{WORKFLOW_SUMMARY\}\}/g, workflowSummary);
-
-  // Write output
-  const outputDir = join(targetPath, '.morph', 'project', 'outputs');
-  await ensureDir(outputDir);
-  const outputPath = join(outputDir, 'onboarding.md');
-  await writeFile(outputPath, content);
-
-  logger.success(`Onboarding guide generated: ${outputPath}`);
-  logger.dim('Share this file with new team members.');
-}
-
-/**
- * Collect standard file names from directory tree
- */
-function collectStandards(dir, prefix = '') {
-  const results = [];
-  try {
-    const entries = readdirSync(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      if (entry.isDirectory()) {
-        results.push(...collectStandards(join(dir, entry.name), `${prefix}${entry.name}/`));
-      } else if (entry.name.endsWith('.md') && entry.name !== 'README.md') {
-        results.push(`${prefix}${entry.name.replace('.md', '')}`);
-      }
-    }
-  } catch {
-    // Permission errors
-  }
-  return results;
-}