@polymorphism-tech/morph-spec 3.2.0 → 4.3.0

package/src/commands/feature/index.js

@@ -0,0 +1,6 @@
+/**
+ * Feature Management Commands
+ */
+export { createStoryCommand } from './create-story.js';
+export { shardSpecCommand } from './shard-spec.js';
+export { sprintStatusCommand } from './sprint-status.js';

package/src/commands/{shard-spec.js → feature/shard-spec.js}

@@ -8,8 +8,8 @@ import fs from 'fs';
 import path from 'path';
 import ora from 'ora';
 import chalk from 'chalk';
-import { logger } from '../utils/logger.js';
-import { ensureDir, writeFile } from '../utils/file-copier.js';
+import { logger } from '../../utils/logger.js';
+import { ensureDir, writeFile } from '../../utils/file-copier.js';
 
 // ============================================================================
 // Helper Functions

package/src/commands/{sprint-status.js → feature/sprint-status.js}

@@ -8,7 +8,7 @@ import path from 'path';
 import yaml from 'yaml';
 import ora from 'ora';
 import chalk from 'chalk';
-import { logger } from '../utils/logger.js';
+import { logger } from '../../utils/logger.js';
 
 // ============================================================================
 // Helper Functions

package/src/commands/{generate-context.js → generation/generate-context.js}

@@ -1,40 +1,40 @@
-/**
- * @fileoverview Generate Context Command
- *
- * CLI: morph-spec generate context [feature]
- *
- * Generates CONTEXT.md (project-level) or CONTEXT-{feature}.md (feature-level)
- * with all relevant project data for Claude's consumption.
- *
- * @module generate-context
- */
-
-import { generateContext } from '../lib/context-generator.js';
-
-/**
- * Generate context files
- * @param {string} projectPath - Root path of the project
- * @param {string} featureName - Optional feature name
- * @returns {Promise<void>}
- */
-export async function generateContextCommand(projectPath, featureName = null) {
-  console.log('📄 Generating CONTEXT files...\n');
-
-  try {
-    const results = await generateContext(projectPath, featureName);
-
-    console.log('✅ Generated:');
-    console.log(`   - ${results.projectContext}`);
-
-    if (results.featureContext) {
-      console.log(`   - ${results.featureContext}`);
-    }
-
-    console.log('\n💡 Use these files to provide full context to Claude Code.');
-
-  } catch (err) {
-    console.error('❌ Error generating context:');
-    console.error(`   ${err.message}`);
-    process.exit(1);
-  }
-}
+/**
+ * @fileoverview Generate Context Command
+ *
+ * CLI: morph-spec generate context [feature]
+ *
+ * Generates CONTEXT.md (project-level) or CONTEXT-{feature}.md (feature-level)
+ * with all relevant project data for Claude's consumption.
+ *
+ * @module generate-context
+ */
+
+import { generateContext } from '../../lib/generators/context-generator.js';
+
+/**
+ * Generate context files
+ * @param {string} projectPath - Root path of the project
+ * @param {string} featureName - Optional feature name
+ * @returns {Promise<void>}
+ */
+export async function generateContextCommand(projectPath, featureName = null) {
+  console.log('📄 Generating CONTEXT files...\n');
+
+  try {
+    const results = await generateContext(projectPath, featureName);
+
+    console.log('✅ Generated:');
+    console.log(`   - ${results.projectContext}`);
+
+    if (results.featureContext) {
+      console.log(`   - ${results.featureContext}`);
+    }
+
+    console.log('\n💡 Use these files to provide full context to Claude Code.');
+
+  } catch (err) {
+    console.error('❌ Error generating context:');
+    console.error(`   ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/{generate.js → generation/generate.js}

@@ -7,10 +7,10 @@ import { mkdirSync, writeFileSync } from 'fs';
 import { dirname, join } from 'path';
 import ora from 'ora';
 import chalk from 'chalk';
-import { logger } from '../utils/logger.js';
-import * as DesignSystemGenerator from '../lib/design-system-generator.js';
-import { getFeature } from '../lib/state-manager.js';
-import { extractFeatureMetadata } from '../lib/metadata-extractor.js';
+import { logger } from '../../utils/logger.js';
+import * as DesignSystemGenerator from '../../lib/generators/design-system-generator.js';
+import { getFeature } from '../../core/state/state-manager.js';
+import { extractFeatureMetadata } from '../../lib/generators/metadata-extractor.js';
 
 // ============================================================================
 // Design System Subcommand

package/src/commands/generation/index.js

@@ -0,0 +1,5 @@
+/**
+ * Code/Documentation Generation Commands
+ */
+export { generateCommand } from './generate.js';
+export { generateContextCommand } from './generate-context.js';

package/src/commands/index.js

@@ -0,0 +1,16 @@
+/**
+ * All Commands - Category Exports
+ *
+ * Commands organized by functional category.
+ */
+
+export * from './feature/index.js';
+export * from './state/index.js';
+export * from './generation/index.js';
+export * from './validation/index.js';
+export * from './templates/index.js';
+export * from './project/index.js';
+export * from './learning/index.js';
+export * from './tasks/index.js';
+export * from './agents/index.js';
+export * from './utils/index.js';

package/src/commands/{capture-pattern.js → learning/capture-pattern.js}

@@ -1,121 +1,121 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { appendFileSync, existsSync, readFileSync } from 'fs';
-import { join } from 'path';
-
-/**
- * Capture Pattern Command - Document lessons learned
- *
- * Appends patterns to patterns-learned.md for future reference
- */
-
-const program = new Command();
-
-const VALID_CATEGORIES = ['success', 'avoid', 'optimization', 'security', 'convention', 'best-practice'];
-
-program
-  .name('capture-pattern')
-  .description('Capture a pattern or lesson learned from a feature')
-  .argument('<feature>', 'Feature name')
-  .argument('<category>', `Pattern category (${VALID_CATEGORIES.join(', ')})`)
-  .argument('<description>', 'Brief description of the pattern')
-  .option('--auto', 'Auto-capture without opening editor', false)
-  .action(async (featureName, category, description, options) => {
-    try {
-      // Validate category
-      if (!VALID_CATEGORIES.includes(category)) {
-        console.error(chalk.red(`\n❌ Invalid category: ${category}`));
-        console.log(chalk.gray(`Valid categories: ${VALID_CATEGORIES.join(', ')}\n`));
-        process.exit(1);
-      }
-
-      // Get patterns file path
-      const patternsPath = join(process.cwd(), '.morph/memory/patterns-learned.md');
-
-      if (!existsSync(patternsPath)) {
-        console.error(chalk.red(`\n❌ Patterns file not found: ${patternsPath}`));
-        console.log(chalk.yellow('Run "morph-spec init" to create the file.\n'));
-        process.exit(1);
-      }
-
-      // Create pattern entry
-      const timestamp = new Date().toISOString().split('T')[0];
-      const categoryDisplay = category === 'avoid' ? 'Anti-Pattern to Avoid' :
-                              category === 'success' ? 'Best Practice' :
-                              category === 'optimization' ? 'Performance Optimization' :
-                              category === 'security' ? 'Security Best Practice' :
-                              category === 'convention' ? 'Convention' :
-                              'Best Practice';
-
-      const patternTemplate = `
-
----
-
-## Pattern: ${description}
-
-**Source:** Feature \`${featureName}\` (${timestamp})
-**Category:** ${categoryDisplay}
-**Date:** ${timestamp}
-
-**Problem:**
-[Describe the problem this pattern solves]
-
-**Implementation:**
-\`\`\`csharp
-// Add code example here
-\`\`\`
-
-**Why:**
-- [Reason 1]
-- [Reason 2]
-
-**When to Use:**
-[Describe scenarios where this pattern applies]
-
-**Reuse:** [List features/scenarios where this can be reused]
-
----
-`;
-
-      // Append to file
-      appendFileSync(patternsPath, patternTemplate, 'utf8');
-
-      console.log(chalk.green(`\n✅ Pattern captured successfully`));
-      console.log(chalk.cyan(`   Feature: ${featureName}`));
-      console.log(chalk.cyan(`   Category: ${categoryDisplay}`));
-      console.log(chalk.cyan(`   Description: ${description}\n`));
-
-      if (!options.auto) {
-        console.log(chalk.bold('📝 Next Steps:'));
-        console.log(chalk.gray(`1. Edit ${patternsPath}`));
-        console.log(chalk.gray('2. Fill in: Problem, Implementation (code), Why, When to Use'));
-        console.log(chalk.gray('3. Add code examples and rationale\n'));
-      }
-
-      // Show location in file
-      const content = readFileSync(patternsPath, 'utf8');
-      const lines = content.split('\n');
-      const patternLine = lines.findIndex(line => line.includes(`Pattern: ${description}`));
-
-      if (patternLine !== -1) {
-        console.log(chalk.gray(`Pattern added at line ${patternLine + 1}`));
-      }
-
-      console.log(chalk.gray(`\nFile: ${patternsPath}\n`));
-
-    } catch (error) {
-      console.error(chalk.red(`\n❌ Error capturing pattern: ${error.message}\n`));
-      process.exit(1);
-    }
-  });
-
-// Only parse if run directly (not imported as module)
-if (import.meta.url === `file://${process.argv[1]}`) {
-  if (process.argv.length > 2) {
-    program.parse(process.argv);
-  } else {
-    program.help();
-  }
-}
-
-export default program;
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { appendFileSync, existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * Capture Pattern Command - Document lessons learned
+ *
+ * Appends patterns to patterns-learned.md for future reference
+ */
+
+const program = new Command();
+
+const VALID_CATEGORIES = ['success', 'avoid', 'optimization', 'security', 'convention', 'best-practice'];
+
+program
+  .name('capture-pattern')
+  .description('Capture a pattern or lesson learned from a feature')
+  .argument('<feature>', 'Feature name')
+  .argument('<category>', `Pattern category (${VALID_CATEGORIES.join(', ')})`)
+  .argument('<description>', 'Brief description of the pattern')
+  .option('--auto', 'Auto-capture without opening editor', false)
+  .action(async (featureName, category, description, options) => {
+    try {
+      // Validate category
+      if (!VALID_CATEGORIES.includes(category)) {
+        console.error(chalk.red(`\n❌ Invalid category: ${category}`));
+        console.log(chalk.gray(`Valid categories: ${VALID_CATEGORIES.join(', ')}\n`));
+        process.exit(1);
+      }
+
+      // Get patterns file path
+      const patternsPath = join(process.cwd(), '.morph/memory/patterns-learned.md');
+
+      if (!existsSync(patternsPath)) {
+        console.error(chalk.red(`\n❌ Patterns file not found: ${patternsPath}`));
+        console.log(chalk.yellow('Run "morph-spec init" to create the file.\n'));
+        process.exit(1);
+      }
+
+      // Create pattern entry
+      const timestamp = new Date().toISOString().split('T')[0];
+      const categoryDisplay = category === 'avoid' ? 'Anti-Pattern to Avoid' :
+                              category === 'success' ? 'Best Practice' :
+                              category === 'optimization' ? 'Performance Optimization' :
+                              category === 'security' ? 'Security Best Practice' :
+                              category === 'convention' ? 'Convention' :
+                              'Best Practice';
+
+      const patternTemplate = `
+
+---
+
+## Pattern: ${description}
+
+**Source:** Feature \`${featureName}\` (${timestamp})
+**Category:** ${categoryDisplay}
+**Date:** ${timestamp}
+
+**Problem:**
+[Describe the problem this pattern solves]
+
+**Implementation:**
+\`\`\`csharp
+// Add code example here
+\`\`\`
+
+**Why:**
+- [Reason 1]
+- [Reason 2]
+
+**When to Use:**
+[Describe scenarios where this pattern applies]
+
+**Reuse:** [List features/scenarios where this can be reused]
+
+---
+`;
+
+      // Append to file
+      appendFileSync(patternsPath, patternTemplate, 'utf8');
+
+      console.log(chalk.green(`\n✅ Pattern captured successfully`));
+      console.log(chalk.cyan(`   Feature: ${featureName}`));
+      console.log(chalk.cyan(`   Category: ${categoryDisplay}`));
+      console.log(chalk.cyan(`   Description: ${description}\n`));
+
+      if (!options.auto) {
+        console.log(chalk.bold('📝 Next Steps:'));
+        console.log(chalk.gray(`1. Edit ${patternsPath}`));
+        console.log(chalk.gray('2. Fill in: Problem, Implementation (code), Why, When to Use'));
+        console.log(chalk.gray('3. Add code examples and rationale\n'));
+      }
+
+      // Show location in file
+      const content = readFileSync(patternsPath, 'utf8');
+      const lines = content.split('\n');
+      const patternLine = lines.findIndex(line => line.includes(`Pattern: ${description}`));
+
+      if (patternLine !== -1) {
+        console.log(chalk.gray(`Pattern added at line ${patternLine + 1}`));
+      }
+
+      console.log(chalk.gray(`\nFile: ${patternsPath}\n`));
+
+    } catch (error) {
+      console.error(chalk.red(`\n❌ Error capturing pattern: ${error.message}\n`));
+      process.exit(1);
+    }
+  });
+
+// Only parse if run directly (not imported as module)
+if (import.meta.url === `file://${process.argv[1]}`) {
+  if (process.argv.length > 2) {
+    program.parse(process.argv);
+  } else {
+    program.help();
+  }
+}
+
+export default program;

package/src/commands/learning/index.js

@@ -0,0 +1,5 @@
+/**
+ * Pattern Learning Commands
+ */
+export { capturePatternCommand } from './capture-pattern.js';
+export { searchPatternsCommand } from './search-patterns.js';

package/src/commands/mcp/mcp.js

@@ -0,0 +1,102 @@
+/**
+ * MCP CLI command — MCP server analysis and optimization
+ *
+ * Usage:
+ *   morph-spec mcp optimize
+ *   morph-spec mcp list
+ */
+
+import chalk from 'chalk';
+import { analyzeMCP } from '../../lib/context/mcp-optimizer.js';
+
+const STATUS_COLORS = {
+  used: chalk.green,
+  unused: chalk.red,
+  unknown: chalk.gray
+};
+
+function formatTokens(n) {
+  return n >= 1000 ? `${(n / 1000).toFixed(1)}K` : String(n);
+}
+
+export async function mcpOptimizeCommand(options) {
+  try {
+    const analysis = analyzeMCP();
+
+    if (!analysis.found) {
+      console.log(chalk.yellow(`\n  ⚠ ${analysis.message}\n`));
+      return;
+    }
+
+    console.log(chalk.cyan('\n  MCP Optimization Analysis\n'));
+    console.log('  ' + '─'.repeat(60));
+
+    console.log(`\n  Settings file: ${chalk.gray(analysis.settingsPath)}`);
+    console.log(`  Total servers: ${analysis.totalServers}`);
+    console.log(`  Total context overhead: ${chalk.yellow(formatTokens(analysis.totalOverhead) + ' tokens')}`);
+
+    if (analysis.unusedCount > 0) {
+      console.log(`  Unused servers: ${chalk.red(analysis.unusedCount)}`);
+      console.log(`  Potential savings: ${chalk.green(formatTokens(analysis.potentialSavings) + ' tokens')}`);
+    }
+
+    if (analysis.recommendations.length === 0) {
+      console.log(chalk.green('\n  ✓ MCP configuration looks optimized!\n'));
+      return;
+    }
+
+    console.log(chalk.yellow('\n  Recommendations:\n'));
+    for (const rec of analysis.recommendations) {
+      console.log(`  ${chalk.bold(rec.title)}`);
+      console.log(`  ${rec.description}`);
+      console.log(`  Savings: ${chalk.green(formatTokens(rec.estimatedSavings) + ' tokens')}`);
+      console.log(`  Action: ${chalk.cyan(rec.action)}`);
+      console.log('');
+    }
+
+    console.log('  ' + '─'.repeat(60));
+    console.log('');
+  } catch (err) {
+    console.error(chalk.red(`Error: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function mcpListCommand(options) {
+  try {
+    const analysis = analyzeMCP();
+
+    if (!analysis.found) {
+      console.log(chalk.yellow(`\n  ⚠ ${analysis.message}\n`));
+      return;
+    }
+
+    if (analysis.servers.length === 0) {
+      console.log(chalk.gray('\n  No MCP servers configured.\n'));
+      return;
+    }
+
+    console.log(chalk.cyan('\n  Configured MCP Servers\n'));
+    console.log('  ' + 'Name'.padEnd(25) + ' ' + 'Status'.padEnd(10) + ' ' + 'Overhead');
+    console.log('  ' + '─'.repeat(50));
+
+    for (const server of analysis.servers) {
+      const colorFn = STATUS_COLORS[server.usageStatus] || chalk.white;
+      console.log(
+        '  ' +
+        server.name.padEnd(25) + ' ' +
+        colorFn(server.usageStatus.padEnd(10)) + ' ' +
+        formatTokens(server.overhead) + ' tokens'
+      );
+    }
+
+    console.log('\n  ' + `Total overhead: ${formatTokens(analysis.totalOverhead)} tokens`);
+    if (analysis.recommendations.length > 0) {
+      console.log(chalk.yellow(`  Run 'morph-spec mcp optimize' for recommendations`));
+    }
+    console.log('');
+  } catch (err) {
+    console.error(chalk.red(`Error: ${err.message}`));
+    process.exit(1);
+  }
+}