@polymorphism-tech/morph-spec 2.2.0 → 2.4.0

package/src/commands/sync.js

@@ -1,167 +1,167 @@
-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 '../../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;
-}
+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 '../../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/task.js

@@ -0,0 +1,78 @@
+/**
+ * Task management commands
+ * Wrapper for bin/task-manager.js (CommonJS) to ESM
+ */
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import chalk from 'chalk';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const taskManagerPath = join(__dirname, '..', '..', 'bin', 'task-manager.js');
+
+/**
+ * Execute task-manager.js with given arguments
+ */
+function executeTaskManager(args) {
+  return new Promise((resolve, reject) => {
+    const child = spawn('node', [taskManagerPath, ...args], {
+      stdio: 'inherit',
+      shell: true
+    });
+
+    child.on('close', (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`Task manager exited with code ${code}`));
+      }
+    });
+
+    child.on('error', (error) => {
+      reject(error);
+    });
+  });
+}
+
+/**
+ * Complete tasks command
+ */
+export async function taskDoneCommand(featureName, taskIds, options) {
+  try {
+    const args = ['done', featureName, ...taskIds];
+    if (options.skipValidation) {
+      args.push('--skip-validation');
+    }
+    await executeTaskManager(args);
+  } catch (error) {
+    console.error(chalk.red(`Error: ${error.message}`));
+    process.exit(1);
+  }
+}
+
+/**
+ * Start task command
+ */
+export async function taskStartCommand(featureName, taskId, options) {
+  try {
+    const args = ['start', featureName, taskId];
+    await executeTaskManager(args);
+  } catch (error) {
+    console.error(chalk.red(`Error: ${error.message}`));
+    process.exit(1);
+  }
+}
+
+/**
+ * Get next task command
+ */
+export async function taskNextCommand(featureName, options) {
+  try {
+    const args = ['next', featureName];
+    await executeTaskManager(args);
+  } catch (error) {
+    console.error(chalk.red(`Error: ${error.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/troubleshoot.js

@@ -0,0 +1,222 @@
+/**
+ * Troubleshoot Command
+ * Search for solutions to common problems
+ *
+ * Usage: morph-spec troubleshoot <keywords...>
+ */
+
+import { searchIndex, getCategories } from '../lib/troubleshoot-index.js';
+import { searchGrep } from '../lib/troubleshoot-grep.js';
+import chalk from 'chalk';
+
+// Severity colors and icons
+const SEVERITY_CONFIG = {
+  critical: { color: chalk.red, icon: '🔴', label: 'CRITICAL' },
+  high: { color: chalk.yellow, icon: '🟠', label: 'HIGH' },
+  medium: { color: chalk.blue, icon: '🔵', label: 'MEDIUM' },
+  low: { color: chalk.gray, icon: '⚪', label: 'LOW' }
+};
+
+/**
+ * Format a single result for display
+ * @param {Object} result - Result object
+ * @param {boolean} verbose - Show full content
+ * @returns {string} Formatted output
+ */
+function formatResult(result, verbose = false) {
+  const severity = SEVERITY_CONFIG[result.severity] || SEVERITY_CONFIG.medium;
+  const lines = [];
+
+  lines.push(chalk.gray('━'.repeat(50)));
+  lines.push('');
+  lines.push(`${severity.icon} ${severity.color.bold(severity.label)}: ${chalk.white.bold(result.title)}`);
+  lines.push('');
+
+  // File and section
+  lines.push(`${chalk.gray('📁 Arquivo:')} ${chalk.cyan(result.file)}`);
+  if (result.section) {
+    lines.push(`${chalk.gray('📂 Seção:')} ${result.section}`);
+  }
+  lines.push('');
+
+  // Cause
+  if (result.cause) {
+    lines.push(`${chalk.red('💡 Causa:')}`);
+    lines.push(`   ${result.cause}`);
+    lines.push('');
+  }
+
+  // Solution
+  if (result.solution) {
+    lines.push(`${chalk.green('✅ Solução:')}`);
+    lines.push(`   ${chalk.white(result.solution)}`);
+    lines.push('');
+  }
+
+  // Content preview (for grep results or verbose mode)
+  if (verbose && result.content) {
+    lines.push(`${chalk.gray('📝 Conteúdo:')}`);
+    const contentLines = result.content.split('\n').slice(0, 15);
+    contentLines.forEach(line => {
+      lines.push(`   ${chalk.gray(line)}`);
+    });
+    lines.push('');
+  }
+
+  // Keywords matched
+  if (result.keywords && result.keywords.length > 0) {
+    const keywords = Array.isArray(result.keywords)
+      ? result.keywords.slice(0, 5).join(', ')
+      : result.keywords;
+    lines.push(`${chalk.gray('🏷️  Keywords:')} ${chalk.dim(keywords)}`);
+  }
+
+  // Source (index or grep)
+  if (result.source === 'grep') {
+    lines.push(`${chalk.gray('🔍 Fonte:')} ${chalk.dim('Busca em arquivos (grep)')}`);
+  }
+
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+/**
+ * Format the summary footer
+ * @param {Object} stats - Search statistics
+ * @returns {string} Formatted summary
+ */
+function formatSummary(stats) {
+  const lines = [];
+
+  lines.push(chalk.gray('━'.repeat(50)));
+  lines.push('');
+
+  if (stats.total === 0) {
+    lines.push(chalk.yellow('⚠️  Nenhum resultado encontrado no índice ou arquivos.'));
+    lines.push('');
+    lines.push(chalk.dim('💡 Dicas:'));
+    lines.push(chalk.dim('   • Tente termos mais específicos (ex: "NU1605" em vez de "error")'));
+    lines.push(chalk.dim('   • Use parte da mensagem de erro exata'));
+    lines.push(chalk.dim('   • Consulte a documentação: morph-spec read blazor-pitfalls.md'));
+  } else {
+    lines.push(`${chalk.green('✅')} Encontrado ${chalk.bold(stats.total)} resultado(s)`);
+
+    if (stats.fromIndex > 0) {
+      lines.push(`   ${chalk.dim(`• ${stats.fromIndex} do índice de problemas conhecidos`)}`);
+    }
+    if (stats.fromGrep > 0) {
+      lines.push(`   ${chalk.dim(`• ${stats.fromGrep} da busca em arquivos`)}`);
+    }
+  }
+
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+/**
+ * List all categories
+ */
+function listCategories() {
+  const categories = getCategories();
+
+  console.log('');
+  console.log(chalk.bold('📂 Categorias disponíveis:'));
+  console.log('');
+
+  for (const [id, category] of Object.entries(categories)) {
+    const name = typeof category === 'object' ? category.name : category;
+    const desc = typeof category === 'object' ? category.description : '';
+    console.log(`   ${chalk.cyan(id.padEnd(12))} ${name}`);
+    if (desc) {
+      console.log(`   ${' '.repeat(12)} ${chalk.dim(desc)}`);
+    }
+  }
+
+  console.log('');
+  console.log(chalk.dim('Uso: morph-spec troubleshoot --category efcore "sua busca"'));
+  console.log('');
+}
+
+/**
+ * Main troubleshoot command
+ * @param {string[]} keywords - Search keywords
+ * @param {Object} options - Command options
+ */
+export async function troubleshootCommand(keywords, options = {}) {
+  // Handle --list-categories flag
+  if (options.listCategories) {
+    listCategories();
+    return;
+  }
+
+  // Validate keywords
+  if (!keywords || keywords.length === 0) {
+    console.log('');
+    console.log(chalk.yellow('⚠️  Por favor, forneça termos de busca.'));
+    console.log('');
+    console.log(chalk.dim('Exemplos:'));
+    console.log(chalk.dim('   morph-spec troubleshoot "blazor.web.js 404"'));
+    console.log(chalk.dim('   morph-spec troubleshoot DbContext concurrent'));
+    console.log(chalk.dim('   morph-spec troubleshoot NU1605 Azure.Identity'));
+    console.log('');
+    console.log(chalk.dim('Opções:'));
+    console.log(chalk.dim('   --category <cat>    Filtrar por categoria (blazor, efcore, azure)'));
+    console.log(chalk.dim('   --verbose, -v       Mostrar conteúdo completo'));
+    console.log(chalk.dim('   --list-categories   Listar categorias disponíveis'));
+    console.log('');
+    return;
+  }
+
+  const searchTerms = Array.isArray(keywords) ? keywords : [keywords];
+
+  console.log('');
+  console.log(`${chalk.cyan('🔍')} Buscando soluções para: ${chalk.bold(`"${searchTerms.join(' ')}"`)}`);
+  console.log('');
+
+  // Search options
+  const searchOptions = {};
+  if (options.category) {
+    searchOptions.category = options.category;
+    console.log(chalk.dim(`   Filtrando por categoria: ${options.category}`));
+    console.log('');
+  }
+
+  // Level 1: Search index
+  let indexResults = searchIndex(searchTerms, searchOptions);
+  indexResults = indexResults.map(r => ({ ...r, source: 'index' }));
+
+  // Level 2: Grep fallback (if few results)
+  let grepResults = [];
+  if (indexResults.length < 3) {
+    grepResults = searchGrep(searchTerms, searchOptions);
+    // Filter out duplicates (same file + section)
+    const indexKeys = new Set(indexResults.map(r => `${r.file}:${r.section}`));
+    grepResults = grepResults.filter(r => !indexKeys.has(`${r.file}:${r.section}`));
+  }
+
+  // Combine and limit results
+  const allResults = [...indexResults, ...grepResults].slice(0, 10);
+
+  // Display results
+  for (const result of allResults) {
+    console.log(formatResult(result, options.verbose));
+  }
+
+  // Display summary
+  console.log(formatSummary({
+    total: allResults.length,
+    fromIndex: indexResults.length,
+    fromGrep: grepResults.slice(0, 10 - indexResults.length).length
+  }));
+
+  // Hint for web search (handled by Claude Code slash command)
+  if (allResults.length === 0) {
+    console.log(chalk.dim('💡 Use /morph-troubleshoot no Claude Code para busca web em'));
+    console.log(chalk.dim('   GitHub Issues, Stack Overflow e Microsoft Learn.'));
+    console.log('');
+  }
+}
+
+export default troubleshootCommand;