@polymorphism-tech/morph-spec 4.7.1 → 4.8.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! ✅`);
-    }
-  }
-}

package/src/commands/utils/troubleshoot.js

@@ -1,222 +0,0 @@
-/**
- * Troubleshoot Command
- * Search for solutions to common problems
- *
- * Usage: morph-spec troubleshoot <keywords...>
- */
-
-import { searchIndex, getCategories } from '../../lib/troubleshooting/troubleshoot-index.js';
-import { searchGrep } from '../../lib/troubleshooting/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 frontend/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;

package/src/commands/validation/analyze-blazor-concurrency.js

@@ -1,193 +0,0 @@
-/**
- * analyze-blazor-concurrency command
- *
- * Analyzes Blazor Server code for DbContext concurrency issues.
- *
- * Usage:
- *   morph-spec analyze-blazor-concurrency [path]
- *   morph-spec analyze-blazor-concurrency src/Services --verbose
- */
-
-import { glob } from 'glob';
-import { readFileSync, existsSync, statSync } from 'fs';
-import { join, resolve } from 'path';
-import chalk from 'chalk';
-import ora from 'ora';
-
-import {
-  analyzeConcurrency,
-} from '../../lib/validators/blazor/blazor-concurrency-analyzer.js';
-import { countIssues } from '../../lib/validators/shared/index.js';
-
-/**
- * Main command handler for analyze-blazor-concurrency.
- *
- * @param {string} [targetPath] - Path to analyze (file or directory)
- * @param {Object} options - Command options
- * @param {boolean} [options.verbose] - Show detailed output
- */
-export async function analyzeBlazorConcurrencyCommand(targetPath, options = {}) {
-  const { verbose = false } = options;
-
-  console.log('');
-  console.log(
-    chalk.cyan('\uD83D\uDD0D Analisando concorrencia DbContext em Blazor Server...')
-  );
-  console.log('');
-
-  // Determine target path
-  const basePath = targetPath ? resolve(targetPath) : process.cwd();
-
-  if (!existsSync(basePath)) {
-    console.log(chalk.red(`\u274C Path not found: ${basePath}`));
-    process.exit(1);
-  }
-
-  const spinner = ora('Scanning for C# files...').start();
-
-  let files = [];
-
-  try {
-    const stats = statSync(basePath);
-
-    if (stats.isFile()) {
-      if (basePath.endsWith('.cs')) {
-        files = [basePath];
-      } else {
-        spinner.fail('File must be .cs');
-        process.exit(1);
-      }
-    } else {
-      // Find all C# files (services, repositories, handlers)
-      const pattern = join(basePath, '**/*.cs');
-      files = await glob(pattern, {
-        ignore: [
-          '**/node_modules/**',
-          '**/bin/**',
-          '**/obj/**',
-          '**/Migrations/**',
-        ],
-        windowsPathsNoEscape: true,
-      });
-    }
-
-    spinner.succeed(`Found ${files.length} C# file(s)`);
-  } catch (error) {
-    spinner.fail(`Error scanning files: ${error.message}`);
-    process.exit(1);
-  }
-
-  if (files.length === 0) {
-    console.log(chalk.yellow('\n\u26A0\uFE0F No C# files found to analyze'));
-    return;
-  }
-
-  // Analyze each file
-  const allIssues = [];
-  const fileResults = [];
-
-  for (const file of files) {
-    try {
-      const content = readFileSync(file, 'utf-8');
-      const issues = analyzeConcurrency(content, file);
-
-      if (issues.length > 0) {
-        allIssues.push(...issues);
-        fileResults.push({ file, issues });
-      }
-    } catch (error) {
-      if (verbose) {
-        console.log(chalk.red(`\u274C Error reading ${file}: ${error.message}`));
-      }
-    }
-  }
-
-  // Output results
-  console.log('');
-
-  if (allIssues.length === 0) {
-    console.log(
-      chalk.green(
-        '\u2705 Nenhum problema de concorrencia detectado!'
-      )
-    );
-    console.log(
-      chalk.gray(
-        '   Dica: Certifique-se de usar IDbContextFactory para operacoes background.'
-      )
-    );
-    console.log('');
-    return;
-  }
-
-  // Display issues
-  if (verbose) {
-    fileResults.forEach(({ file, issues }) => {
-      console.log(chalk.white.bold(`\n${file}`));
-      console.log(chalk.gray('-'.repeat(60)));
-
-      issues.forEach((issue) => {
-        const icon =
-          issue.type === 'error'
-            ? '\u274C'
-            : issue.type === 'warning'
-            ? '\u26A0\uFE0F'
-            : '\u2139\uFE0F';
-
-        console.log(`${icon} ${issue.message}`);
-        if (issue.suggestion) {
-          console.log(chalk.gray(`   \u2192 ${issue.suggestion}`));
-        }
-        if (issue.line) {
-          console.log(chalk.dim(`   Linha: ${issue.line}`));
-        }
-        if (issue.code) {
-          console.log(chalk.dim(`   Codigo: ${issue.code}`));
-        }
-        console.log('');
-      });
-    });
-  } else {
-    allIssues.forEach((issue) => {
-      const icon =
-        issue.type === 'error'
-          ? '\u274C'
-          : issue.type === 'warning'
-          ? '\u26A0\uFE0F'
-          : '\u2139\uFE0F';
-
-      const location = issue.line ? `${issue.file}:${issue.line}` : issue.file;
-
-      console.log(`${icon} ${issue.message}`);
-      if (issue.suggestion) {
-        console.log(chalk.gray(`   \u2192 ${issue.suggestion}`));
-      }
-      console.log(chalk.dim(`   ${location}`));
-      console.log('');
-    });
-  }
-
-  // Summary
-  const { errors, warnings, infos } = countIssues(allIssues);
-  const summaryColor = errors > 0 ? chalk.red : chalk.yellow;
-
-  console.log(chalk.gray('-'.repeat(60)));
-  console.log(
-    summaryColor(
-      `\n${files.length} arquivo(s) analisado(s) | ${errors} erro(s) | ${warnings} warning(s) | ${infos} info(s)\n`
-    )
-  );
-
-  // Recommendation
-  if (errors > 0) {
-    console.log(
-      chalk.cyan(
-        '\uD83D\uDCD6 Consulte: framework/standards/backend/database/ef-core.md para padroes corretos'
-      )
-    );
-    console.log('');
-    process.exit(1);
-  }
-}
-
-export default analyzeBlazorConcurrencyCommand;