@polymorphism-tech/morph-spec 2.3.0 → 3.0.0

package/src/commands/update.js

@@ -1,159 +1,192 @@
-import { join } from 'path';
-import ora from 'ora';
-import chalk from 'chalk';
-import { logger } from '../utils/logger.js';
-import {
-  getContentDir,
-  copyDirectory,
-  pathExists
-} from '../utils/file-copier.js';
-import {
-  checkCLIOutdated,
-  checkProjectOutdated,
-  saveProjectMorphVersion,
-  getUpdateInstructions,
-  detectInstallMethod
-} from '../utils/version-checker.js';
-
-export async function updateCommand(options) {
-  const targetPath = process.cwd();
-  const contentDir = getContentDir();
-  const morphPath = join(targetPath, '.morph');
-
-  logger.header('MORPH-SPEC Update');
-
-  // Check if MORPH is initialized
-  if (!(await pathExists(morphPath))) {
-    logger.error('MORPH not initialized in this directory.');
-    logger.dim('Run "morph-spec init" first.');
-    process.exit(1);
-  }
-
-  // Check CLI version
-  const spinner = ora('Checking versions...').start();
-  const cliCheck = await checkCLIOutdated();
-  const projectCheck = await checkProjectOutdated(targetPath);
-
-  spinner.stop();
-
-  // Display version info
-  logger.blank();
-  logger.info('Version Status:');
-  logger.dim(`  CLI version: ${cliCheck.current}`);
-
-  if (projectCheck.current) {
-    logger.dim(`  Project MORPH version: ${projectCheck.current}`);
-  } else {
-    logger.dim('  Project MORPH version: not found (legacy installation)');
-  }
-
-  if (cliCheck.latest) {
-    const latestColor = cliCheck.isOutdated ? chalk.yellow : chalk.green;
-    logger.dim(`  Latest available: ${latestColor(cliCheck.latest)}`);
-  }
-  logger.blank();
-
-  // If CLI is outdated, stop and instruct user
-  if (cliCheck.isOutdated && cliCheck.latest) {
-    logger.warn(`Your CLI is outdated (${cliCheck.current} → ${cliCheck.latest})`);
-    logger.blank();
-    logger.info('Please update the CLI first:');
-    logger.blank();
-
-    const method = detectInstallMethod();
-    const instructions = getUpdateInstructions(method);
-
-    instructions.forEach(line => {
-      if (line === '') {
-        logger.blank();
-      } else if (line.startsWith('Or ')) {
-        logger.dim(line);
-      } else {
-        logger.box([line]);
-      }
-    });
-
-    logger.blank();
-    logger.dim('Then run "morph-spec update" again.');
-    process.exit(0);
-  }
-
-  // Proceed with update
-  const updateSpinner = ora('Updating MORPH-SPEC...').start();
-
-  try {
-    const updateTemplates = !options.standards || options.templates;
-    const updateStandards = !options.templates || options.standards;
-
-    // Update templates
-    if (updateTemplates) {
-      updateSpinner.text = 'Updating templates...';
-      const templatesSrc = join(contentDir, '.morph', 'templates');
-      const templatesDest = join(morphPath, 'templates');
-      await copyDirectory(templatesSrc, templatesDest);
-    }
-
-    // Update standards
-    if (updateStandards) {
-      updateSpinner.text = 'Updating standards...';
-      const standardsSrc = join(contentDir, '.morph', 'standards');
-      const standardsDest = join(morphPath, 'standards');
-      await copyDirectory(standardsSrc, standardsDest);
-    }
-
-    // Update agents.json
-    updateSpinner.text = 'Updating agents configuration...';
-    const agentsSrc = join(contentDir, '.morph', 'config', 'agents.json');
-    const agentsDest = join(morphPath, 'config', 'agents.json');
-    if (await pathExists(agentsSrc)) {
-      await copyDirectory(agentsSrc, agentsDest);
-    }
-
-    // Update .claude commands and skills
-    updateSpinner.text = 'Updating Claude commands and skills...';
-    const claudeSrc = join(contentDir, '.claude');
-    const claudeDest = join(targetPath, '.claude');
-    if (await pathExists(claudeSrc)) {
-      await copyDirectory(claudeSrc, claudeDest);
-    }
-
-    // Update CLAUDE.md
-    updateSpinner.text = 'Updating CLAUDE.md...';
-    const claudeMdSrc = join(contentDir, 'CLAUDE.md');
-    const claudeMdDest = join(targetPath, 'CLAUDE.md');
-    await copyDirectory(claudeMdSrc, claudeMdDest);
-
-    // Update .morphversion
-    updateSpinner.text = 'Saving version info...';
-    await saveProjectMorphVersion(targetPath, cliCheck.current);
-
-    updateSpinner.succeed('MORPH-SPEC updated successfully!');
-    logger.blank();
-
-    // Show version change
-    if (projectCheck.current && projectCheck.current !== cliCheck.current) {
-      logger.success(`Updated: ${projectCheck.current} → ${cliCheck.current}`);
-    } else if (!projectCheck.current) {
-      logger.success(`Updated to v${cliCheck.current}`);
-    } else {
-      logger.success(`Already up to date (v${cliCheck.current})`);
-    }
-
-    logger.blank();
-    logger.info('Updated files:');
-    if (updateTemplates) logger.dim('  ✓ .morph/templates/');
-    if (updateStandards) logger.dim('  ✓ .morph/standards/');
-    logger.dim('  ✓ .morph/config/agents.json');
-    logger.dim('  ✓ .claude/commands/ and .claude/skills/');
-    logger.dim('  ✓ CLAUDE.md');
-    logger.blank();
-    logger.info('Your config.json was preserved.');
-    logger.dim('Review the updated files for any new features.');
-    logger.blank();
-
-  } catch (error) {
-    updateSpinner.fail('Update failed');
-    logger.error(error.message);
-    process.exit(1);
-  }
-}
+import { join } from 'path';
+import fs from 'fs-extra';
+import ora from 'ora';
+import chalk from 'chalk';
+import { logger } from '../utils/logger.js';
+import {
+  getContentDir,
+  copyDirectory,
+  pathExists,
+  ensureDir,
+  createDirectoryLink
+} from '../utils/file-copier.js';
+import {
+  checkCLIOutdated,
+  checkProjectOutdated,
+  saveProjectMorphVersion,
+  getUpdateInstructions,
+  detectInstallMethod
+} from '../utils/version-checker.js';
+
+export async function updateCommand(options) {
+  const targetPath = process.cwd();
+  const contentDir = getContentDir();
+  const morphPath = join(targetPath, '.morph');
+
+  logger.header('MORPH-SPEC Update');
+
+  // Check if MORPH is initialized
+  if (!(await pathExists(morphPath))) {
+    logger.error('MORPH not initialized in this directory.');
+    logger.dim('Run "morph-spec init" first.');
+    process.exit(1);
+  }
+
+  // Check CLI version
+  const spinner = ora('Checking versions...').start();
+  const cliCheck = await checkCLIOutdated();
+  const projectCheck = await checkProjectOutdated(targetPath);
+
+  spinner.stop();
+
+  // Display version info
+  logger.blank();
+  logger.info('Version Status:');
+  logger.dim(`  CLI version: ${cliCheck.current}`);
+
+  if (projectCheck.current) {
+    logger.dim(`  Project MORPH version: ${projectCheck.current}`);
+  } else {
+    logger.dim('  Project MORPH version: not found (legacy installation)');
+  }
+
+  if (cliCheck.latest) {
+    const latestColor = cliCheck.isOutdated ? chalk.yellow : chalk.green;
+    logger.dim(`  Latest available: ${latestColor(cliCheck.latest)}`);
+  }
+  logger.blank();
+
+  // If CLI is outdated, stop and instruct user
+  if (cliCheck.isOutdated && cliCheck.latest) {
+    logger.warn(`Your CLI is outdated (${cliCheck.current} → ${cliCheck.latest})`);
+    logger.blank();
+    logger.info('Please update the CLI first:');
+    logger.blank();
+
+    const method = detectInstallMethod();
+    const instructions = getUpdateInstructions(method);
+
+    instructions.forEach(line => {
+      if (line === '') {
+        logger.blank();
+      } else if (line.startsWith('Or ')) {
+        logger.dim(line);
+      } else {
+        logger.box([line]);
+      }
+    });
+
+    logger.blank();
+    logger.dim('Then run "morph-spec update" again.');
+    process.exit(0);
+  }
+
+  // Proceed with update
+  const updateSpinner = ora('Updating MORPH-SPEC...').start();
+
+  try {
+    const updateTemplates = !options.standards || options.templates;
+    const updateStandards = !options.templates || options.standards;
+
+    // Update templates
+    if (updateTemplates) {
+      updateSpinner.text = 'Updating templates...';
+      const templatesSrc = join(contentDir, '.morph', 'templates');
+      const templatesDest = join(morphPath, 'templates');
+      await copyDirectory(templatesSrc, templatesDest);
+    }
+
+    // Update standards
+    if (updateStandards) {
+      updateSpinner.text = 'Updating standards...';
+      const standardsSrc = join(contentDir, '.morph', 'standards');
+      const standardsDest = join(morphPath, 'standards');
+      await copyDirectory(standardsSrc, standardsDest);
+    }
+
+    // Update agents.json
+    updateSpinner.text = 'Updating agents configuration...';
+    const agentsSrc = join(contentDir, '.morph', 'config', 'agents.json');
+    const agentsDest = join(morphPath, 'config', 'agents.json');
+    if (await pathExists(agentsSrc)) {
+      await copyDirectory(agentsSrc, agentsDest);
+    }
+
+    // Update .claude commands and skills
+    updateSpinner.text = 'Updating Claude commands and skills...';
+    const claudeSrc = join(contentDir, '.claude');
+    const claudeDest = join(targetPath, '.claude');
+    if (await pathExists(claudeSrc)) {
+      // Copy commands (always copy, these are small)
+      const commandsSrc = join(claudeSrc, 'commands');
+      const commandsDest = join(claudeDest, 'commands');
+      if (await pathExists(commandsSrc)) {
+        await copyDirectory(commandsSrc, commandsDest);
+
+        // Clean up stale command files moved to skills/workflows/ in v2.4+
+        const staleCommands = [
+          'morph-setup.md', 'morph-uiux.md', 'morph-design.md',
+          'morph-clarify.md', 'morph-tasks.md'
+        ];
+        for (const file of staleCommands) {
+          const stalePath = join(commandsDest, file);
+          if (await pathExists(stalePath)) {
+            await fs.remove(stalePath);
+          }
+        }
+      }
+
+      // Update skills using directory links per category
+      const skillsSrc = join(claudeSrc, 'skills');
+      const skillsDest = join(claudeDest, 'skills');
+      if (await pathExists(skillsSrc)) {
+        await ensureDir(skillsDest);
+        const entries = await fs.readdir(skillsSrc, { withFileTypes: true });
+        for (const entry of entries) {
+          if (entry.isDirectory()) {
+            await createDirectoryLink(join(skillsSrc, entry.name), join(skillsDest, entry.name));
+          }
+        }
+      }
+    }
+
+    // Update CLAUDE.md
+    updateSpinner.text = 'Updating CLAUDE.md...';
+    const claudeMdSrc = join(contentDir, 'CLAUDE.md');
+    const claudeMdDest = join(targetPath, 'CLAUDE.md');
+    await copyDirectory(claudeMdSrc, claudeMdDest);
+
+    // Update .morphversion
+    updateSpinner.text = 'Saving version info...';
+    await saveProjectMorphVersion(targetPath, cliCheck.current);
+
+    updateSpinner.succeed('MORPH-SPEC updated successfully!');
+    logger.blank();
+
+    // Show version change
+    if (projectCheck.current && projectCheck.current !== cliCheck.current) {
+      logger.success(`Updated: ${projectCheck.current} → ${cliCheck.current}`);
+    } else if (!projectCheck.current) {
+      logger.success(`Updated to v${cliCheck.current}`);
+    } else {
+      logger.success(`Already up to date (v${cliCheck.current})`);
+    }
+
+    logger.blank();
+    logger.info('Updated files:');
+    if (updateTemplates) logger.dim('  ✓ .morph/templates/');
+    if (updateStandards) logger.dim('  ✓ .morph/standards/');
+    logger.dim('  ✓ .morph/config/agents.json');
+    logger.dim('  ✓ .claude/commands/ and .claude/skills/');
+    logger.dim('  ✓ CLAUDE.md');
+    logger.blank();
+    logger.info('Your config.json was preserved.');
+    logger.dim('Review the updated files for any new features.');
+    logger.blank();
+
+  } catch (error) {
+    updateSpinner.fail('Update failed');
+    logger.error(error.message);
+    process.exit(1);
+  }
+}

package/src/commands/validate-blazor-state.js

@@ -0,0 +1,210 @@
+/**
+ * validate-blazor-state command
+ *
+ * Validates Blazor Server session state patterns.
+ * Ensures proper Persist + Reload pattern implementation.
+ *
+ * Usage:
+ *   morph-spec validate-blazor-state [path]
+ *   morph-spec validate-blazor-state src/ --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 {
+  validateBlazorState,
+  countIssues,
+} from '../lib/blazor-state-validator.js';
+
+/**
+ * Main command handler for validate-blazor-state.
+ *
+ * @param {string} [targetPath] - Path to validate (file or directory)
+ * @param {Object} options - Command options
+ * @param {boolean} [options.verbose] - Show detailed output
+ */
+export async function validateBlazorStateCommand(targetPath, options = {}) {
+  const { verbose = false } = options;
+
+  console.log('');
+  console.log(
+    chalk.cyan('\uD83D\uDD0D Validando padroes de SessionState 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# and Razor files...').start();
+
+  let files = [];
+
+  try {
+    const stats = statSync(basePath);
+
+    if (stats.isFile()) {
+      if (basePath.endsWith('.cs') || basePath.endsWith('.razor')) {
+        files = [basePath];
+      } else {
+        spinner.fail('File must be .cs or .razor');
+        process.exit(1);
+      }
+    } else {
+      // Find all relevant files
+      const pattern = join(basePath, '**/*.{cs,razor}');
+      files = await glob(pattern, {
+        ignore: [
+          '**/node_modules/**',
+          '**/bin/**',
+          '**/obj/**',
+          '**/Migrations/**',
+        ],
+        windowsPathsNoEscape: true,
+      });
+    }
+
+    spinner.succeed(`Found ${files.length} 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 files found to validate'));
+    return;
+  }
+
+  // Validate each file
+  const allIssues = [];
+  const fileResults = [];
+
+  for (const file of files) {
+    try {
+      const content = readFileSync(file, 'utf-8');
+      const issues = validateBlazorState(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 Padroes de SessionState validados com sucesso!')
+    );
+    console.log(
+      chalk.gray(
+        '   Dica: Certifique-se de sempre verificar IsLoaded em OnInitializedAsync.'
+      )
+    );
+    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';
+
+        const color =
+          issue.type === 'error'
+            ? chalk.red
+            : issue.type === 'warning'
+            ? chalk.yellow
+            : chalk.blue;
+
+        console.log(`${icon} ${color(issue.message)}`);
+        if (issue.suggestion) {
+          console.log(chalk.gray(`   \u2192 ${issue.suggestion}`));
+        }
+        if (issue.line) {
+          console.log(chalk.dim(`   Linha: ${issue.line}`));
+        }
+        console.log('');
+      });
+    });
+  } else {
+    allIssues.forEach((issue) => {
+      const icon =
+        issue.type === 'error'
+          ? '\u274C'
+          : issue.type === 'warning'
+          ? '\u26A0\uFE0F'
+          : '\u2139\uFE0F';
+
+      const color =
+        issue.type === 'error'
+          ? chalk.red
+          : issue.type === 'warning'
+          ? chalk.yellow
+          : chalk.blue;
+
+      console.log(`${icon} ${color(issue.message)}`);
+      if (issue.suggestion) {
+        console.log(chalk.gray(`   \u2192 ${issue.suggestion}`));
+      }
+      console.log(chalk.dim(`   ${issue.file}`));
+      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) validado(s) | ${errors} erro(s) | ${warnings} warning(s) | ${infos} info(s)\n`
+    )
+  );
+
+  // Checklist reminder
+  console.log(chalk.cyan('\uD83D\uDCCB Checklist SessionState:'));
+  console.log(chalk.gray('   [ ] SessionState tem LoadFrom(entity)?'));
+  console.log(chalk.gray('   [ ] SessionState tem propriedade IsLoaded?'));
+  console.log(chalk.gray('   [ ] Paginas verificam IsLoaded em OnInitializedAsync?'));
+  console.log(chalk.gray('   [ ] SessionMiddleware configurado em Program.cs?'));
+  console.log(chalk.gray('   [ ] IHttpContextAccessor registrado?'));
+  console.log('');
+
+  // Recommendation
+  if (errors > 0) {
+    console.log(
+      chalk.cyan(
+        '\uD83D\uDCD6 Consulte: framework/standards/blazor-state.md para o padrao completo'
+      )
+    );
+    console.log('');
+    process.exit(1);
+  }
+}
+
+export default validateBlazorStateCommand;