@polymorphism-tech/morph-spec 4.12.0 → 4.13.0

package/src/lib/standards/standards-context-injector.js

@@ -1,302 +0,0 @@
-/**
- * @fileoverview Standards Context Injector
- *
- * Automatically loads and surfaces relevant standards content for agents.
- * Resolution order: project overrides → framework standards → content standards
- *
- * @module standards-context-injector
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-
-/**
- * Agent → Standards mapping
- * Maps each agent ID to relevant standard files (hierarchical paths without .md extension)
- */
-const AGENT_STANDARDS_MAP = {
-  // Tier 1: Orchestrators
-  'standards-architect': [
-    'core/architecture',
-    'core/coding',
-    'infrastructure/azure/azure', // Stack-specific (kept in .morph/framework/standards/)
-    'backend/dotnet/core',
-    'backend/dotnet/program-cs-checklist'
-  ],
-  'ai-system-architect': [
-    'ai-agents/setup',
-    'ai-agents/workflows',
-    'ai-agents/production',
-    'ai-agents/blazor-ui',
-    'core/architecture',
-    'core/coding'
-  ],
-  'popm-advisor': [], // No technical standards
-
-  // Tier 2: Domain Leaders
-  'dotnet-senior': [
-    'core/coding',
-    'core/architecture',
-    'core/testing',
-    'backend/dotnet/core',
-    'backend/dotnet/async',
-    'backend/dotnet/di',
-    'backend/database/ef-core',
-    'backend/api/rest'
-  ],
-  'infra-architect': [
-    'core/architecture',
-    'core/coding'
-  ],
-  // Tier 3: Specialists - Infrastructure Squad
-  'azure-architect': [
-    'infrastructure/azure/azure', // Stack-specific
-    'core/architecture',
-    'backend/dotnet/core'
-  ],
-  'ui-designer': [
-    'frontend/design-system/naming',
-    'frontend/design-system/animations',
-    'frontend/blazor/fluent-ui-setup', // Stack-specific
-    'frontend/blazor/fluent-ui'
-  ],
-
-  // Tier 3: Specialists - Backend Squad
-  'ef-modeler': [
-    'backend/database/ef-core',
-    'backend/database/migrations',
-    'backend/database/repository-patterns',
-    'core/architecture',
-    'core/coding',
-    'backend/dotnet/core'
-  ],
-  'event-architect': [
-    'core/architecture',
-    'core/coding',
-    'backend/dotnet/core'
-  ],
-  'api-designer': [
-    'backend/api/rest',
-    'backend/api/validation',
-    'core/architecture',
-    'core/coding',
-    'backend/dotnet/core'
-  ],
-  'nosql-cache-expert': [
-    'core/architecture',
-    'core/coding'
-  ],
-  'ddd-expert': [
-    'core/architecture',
-    'core/coding'
-  ],
-  'hangfire-orchestrator': [
-    'core/architecture',
-    'core/coding',
-    'frontend/blazor/lifecycle', // Background jobs + Blazor lifecycle
-    'backend/database/repository-patterns', // Factory pattern
-    'backend/dotnet/core'
-  ],
-  'ms-agent-expert': [
-    'ai-agents/setup',
-    'ai-agents/workflows',
-    'ai-agents/production',
-    'ai-agents/blazor-ui',
-    'core/coding',
-    'core/architecture'
-  ],
-  'asaas-financial': [
-    'core/coding',
-    'core/architecture'
-  ],
-  'clerk-auth': [
-    'core/coding',
-    'core/architecture',
-    'backend/authentication/passkeys' // Stack-specific
-  ],
-  'resend-email': [
-    'core/coding',
-    'core/architecture'
-  ],
-
-  // Tier 3: Specialists - Frontend Squad
-  'blazor-builder': [
-    'frontend/blazor/lifecycle',
-    'frontend/blazor/state',
-    'frontend/blazor/pitfalls',
-    'frontend/blazor/html-conversion',
-    'frontend/blazor/fluent-ui',
-    'frontend/design-system/naming',
-    'frontend/design-system/animations',
-    'backend/database/ef-core', // DbContext usage
-    'core/coding',
-    'core/architecture'
-  ],
-  'nextjs-expert': [
-    'core/coding'
-  ],
-  'css-specialist': [
-    'frontend/design-system/naming',
-    'frontend/design-system/animations',
-    'frontend/blazor/fluent-ui'
-  ],
-
-  // Tier 3: Specialists - Infrastructure Squad
-  'bicep-architect': [
-    'infrastructure/azure/azure', // Stack-specific
-    'core/architecture'
-  ],
-  'devops-engineer': [
-    'infrastructure/azure/azure', // Stack-specific
-    'backend/dotnet/core'
-  ],
-  'container-specialist': [
-    'infrastructure/azure/azure', // Stack-specific
-    'backend/dotnet/core'
-  ],
-  'observability-expert': [
-    'infrastructure/azure/azure', // Stack-specific
-    'core/architecture'
-  ],
-  'azure-identity': [
-    'infrastructure/azure/azure', // Stack-specific
-    'core/architecture',
-    'backend/authentication/passkeys' // Stack-specific
-  ],
-
-  // Tier 3: Specialists - Quality Squad
-  'testing-specialist': [
-    'core/testing',
-    'core/coding',
-    'core/architecture',
-    'backend/dotnet/core'
-  ],
-  'code-analyzer': [
-    'core/coding',
-    'core/architecture',
-    'backend/dotnet/core',
-    'backend/dotnet/program-cs-checklist'
-  ],
-  'troubleshooting-expert': [
-    'core/architecture',
-    'frontend/blazor/pitfalls',
-    'backend/dotnet/core'
-  ],
-  'load-testing-expert': [
-    'core/architecture',
-    'infrastructure/azure/azure' // Stack-specific
-  ],
-  'documentation-specialist': [], // No technical standards
-
-  // Tier 4: Validators
-  'security-expert': [
-    'core/coding',
-    'core/architecture',
-    'backend/authentication/passkeys' // Stack-specific
-  ]
-};
-
-/**
- * Load a single standard file with project override support
- * @param {string} standardName - Standard path without .md extension (e.g., "core/coding", "backend/database/ef-core")
- * @param {string} projectPath - Root path of the project
- * @returns {string|null} Standard content or null if not found
- */
-function loadStandard(standardName, projectPath) {
-  const locations = [
-    // 1. Project override
-    join(projectPath, '.morph/context', `${standardName}.md`),
-    // 2. Project-level standards (.morph/framework/standards/)
-    join(projectPath, '.morph/framework/standards', `${standardName}.md`),
-    // 3. Framework standards (hierarchical structure: core/, backend/, frontend/, infrastructure/)
-    join(projectPath, 'framework/standards', `${standardName}.md`)
-  ];
-
-  for (const path of locations) {
-    if (existsSync(path)) {
-      try {
-        return readFileSync(path, 'utf8');
-      } catch (err) {
-        // Continue to next location
-      }
-    }
-  }
-
-  return null;
-}
-
-/**
- * Load all relevant standards for a given agent
- * @param {string} agentId - Agent ID (e.g., 'blazor-builder')
- * @param {string} projectPath - Root path of the project
- * @returns {Object} { sections: [{standard, content}], fullContent: string }
- */
-export function loadStandardsForAgent(agentId, projectPath = '.') {
-  const standardNames = AGENT_STANDARDS_MAP[agentId] || [];
-  const sections = [];
-  const contentParts = [];
-
-  // Load inferred standards if exists (project-specific learnings)
-  const inferredPath = join(projectPath, '.morph/context/inferred.md');
-  if (existsSync(inferredPath)) {
-    try {
-      const inferredContent = readFileSync(inferredPath, 'utf8');
-      sections.push({
-        standard: 'inferred',
-        content: inferredContent
-      });
-      contentParts.push(`# Project-Specific Standards (Inferred)\n\n${inferredContent}`);
-    } catch (err) {
-      // Ignore if can't read
-    }
-  }
-
-  // Load each standard
-  for (const standardName of standardNames) {
-    const content = loadStandard(standardName, projectPath);
-    if (content) {
-      sections.push({
-        standard: standardName,
-        content
-      });
-      contentParts.push(`# ${standardName}\n\n${content}`);
-    }
-  }
-
-  return {
-    sections,
-    fullContent: contentParts.join('\n\n---\n\n'),
-    standardNames // For debugging/introspection
-  };
-}
-
-/**
- * Get list of standards for an agent (without loading content)
- * @param {string} agentId - Agent ID
- * @returns {string[]} Array of standard names
- */
-export function getStandardsListForAgent(agentId) {
-  return AGENT_STANDARDS_MAP[agentId] || [];
-}
-
-/**
- * Check if a standard exists in any location
- * @param {string} standardName - Standard path without .md extension (e.g., "core/coding", "backend/database/ef-core")
- * @param {string} projectPath - Root path of the project
- * @returns {Object} { exists: boolean, location: string|null }
- */
-export function checkStandardExists(standardName, projectPath = '.') {
-  const locations = [
-    { type: 'project', path: join(projectPath, '.morph/context', `${standardName}.md`) },
-    { type: 'morph', path: join(projectPath, '.morph/framework/standards', `${standardName}.md`) },
-    { type: 'framework', path: join(projectPath, 'framework/standards', `${standardName}.md`) }
-  ];
-
-  for (const loc of locations) {
-    if (existsSync(loc.path)) {
-      return { exists: true, location: loc.type, path: loc.path };
-    }
-  }
-
-  return { exists: false, location: null, path: null };
-}

package/src/lib/validators/blazor/blazor-concurrency-analyzer.js

@@ -1,316 +0,0 @@
-/**
- * Blazor Concurrency Analyzer
- *
- * Detects potential DbContext concurrency issues in Blazor Server applications.
- * Identifies patterns that lead to "A second operation was started" exceptions.
- *
- * @module blazor-concurrency-analyzer
- */
-
-import { readFileSync } from 'fs';
-import { glob } from 'glob';
-import { countIssues } from '../shared/index.js';
-
-/**
- * @typedef {Object} ConcurrencyIssue
- * @property {'error' | 'warning' | 'info'} type
- * @property {string} message
- * @property {string} [suggestion]
- * @property {string} file
- * @property {number} [line]
- * @property {string} [code]
- */
-
-// Patterns that indicate scoped DbContext injection
-const SCOPED_DBCONTEXT_PATTERNS = [
-  /private readonly (\w+DbContext)\s+_\w+/g,
-  /\[Inject\]\s*(?:private|public)\s+(\w+DbContext)/g,
-  /private readonly I(\w+)Repository\s+_\w+/g,
-];
-
-// Patterns that indicate background operations
-const BACKGROUND_OPERATION_PATTERNS = [
-  /Task\.Run\s*\(/,
-  /Task\.Factory\.StartNew\s*\(/,
-  /Parallel\.For/,
-  /Parallel\.ForEach/,
-  /\.ConfigureAwait\(false\)/,
-  /_ = \w+Async\(/,  // Fire-and-forget pattern
-  /ThreadPool\.QueueUserWorkItem/,
-];
-
-// Patterns that indicate factory usage (GOOD)
-const FACTORY_PATTERNS = [
-  /IDbContextFactory<\w+>/,
-  /IDbContextFactory\s*<\s*\w+\s*>/,
-  /_factory\.CreateDbContext/,
-  /_contextFactory\.CreateDbContext/,
-  /await using var \w+ = .*CreateDbContext/,
-];
-
-// Hangfire patterns
-const HANGFIRE_PATTERNS = [
-  /BackgroundJob\.Enqueue/,
-  /BackgroundJob\.Schedule/,
-  /RecurringJob\.AddOrUpdate/,
-  /\[AutomaticRetry\]/,
-];
-
-/**
- * Checks for scoped DbContext used in background operations.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {ConcurrencyIssue[]}
- */
-export function checkScopedDbContextInBackground(content, filePath) {
-  const issues = [];
-  const lines = content.split('\n');
-
-  // First, check if file has scoped DbContext
-  let hasScopedDbContext = false;
-  let dbContextLine = 0;
-
-  lines.forEach((line, index) => {
-    SCOPED_DBCONTEXT_PATTERNS.forEach((pattern) => {
-      if (pattern.test(line)) {
-        hasScopedDbContext = true;
-        dbContextLine = index + 1;
-      }
-      pattern.lastIndex = 0;
-    });
-  });
-
-  if (!hasScopedDbContext) {
-    return issues;
-  }
-
-  // Check if file has factory pattern (GOOD - no issues)
-  const hasFactory = FACTORY_PATTERNS.some((pattern) => pattern.test(content));
-
-  if (hasFactory) {
-    return issues; // Using factory pattern correctly
-  }
-
-  // Check for background operations
-  lines.forEach((line, index) => {
-    BACKGROUND_OPERATION_PATTERNS.forEach((pattern) => {
-      if (pattern.test(line)) {
-        issues.push({
-          type: 'error',
-          message: 'Operacao background com DbContext scoped detectada',
-          suggestion:
-            'Use IDbContextFactory<T> ou Repository Factory pattern para operacoes background. Ver framework/standards/backend/database/ef-core.md',
-          file: filePath,
-          line: index + 1,
-          code: line.trim(),
-        });
-      }
-    });
-  });
-
-  return issues;
-}
-
-/**
- * Checks for Hangfire jobs using scoped services.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {ConcurrencyIssue[]}
- */
-export function checkHangfireWithScopedServices(content, filePath) {
-  const issues = [];
-  const lines = content.split('\n');
-
-  // Check if file has Hangfire patterns
-  const hasHangfire = HANGFIRE_PATTERNS.some((pattern) => pattern.test(content));
-
-  if (!hasHangfire) {
-    return issues;
-  }
-
-  // Check if using factory pattern
-  const hasFactory = FACTORY_PATTERNS.some((pattern) => pattern.test(content));
-
-  if (hasFactory) {
-    return issues; // Good - using factory
-  }
-
-  // Check for scoped DbContext
-  const hasScopedDbContext = SCOPED_DBCONTEXT_PATTERNS.some((pattern) => {
-    const result = pattern.test(content);
-    pattern.lastIndex = 0;
-    return result;
-  });
-
-  if (hasScopedDbContext) {
-    lines.forEach((line, index) => {
-      HANGFIRE_PATTERNS.forEach((pattern) => {
-        if (pattern.test(line)) {
-          issues.push({
-            type: 'error',
-            message: 'Hangfire job com DbContext scoped',
-            suggestion:
-              'Hangfire jobs rodam fora do escopo HTTP. Use IDbContextFactory<T> para criar contextos isolados.',
-            file: filePath,
-            line: index + 1,
-            code: line.trim(),
-          });
-        }
-      });
-    });
-  }
-
-  return issues;
-}
-
-/**
- * Checks for scoped services injected into singleton services.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {ConcurrencyIssue[]}
- */
-export function checkScopedInSingleton(content, filePath) {
-  const issues = [];
-  const lines = content.split('\n');
-
-  // Type guard: filePath must be a string (validation-runner may pass options object)
-  if (typeof filePath !== 'string') return [];
-
-  // Check if class might be a singleton (common naming patterns)
-  const isSingletonCandidate =
-    filePath.includes('BackgroundService') ||
-    filePath.includes('HostedService') ||
-    filePath.includes('Worker') ||
-    content.includes(': BackgroundService') ||
-    content.includes(': IHostedService') ||
-    content.includes('[Singleton]');
-
-  if (!isSingletonCandidate) {
-    return issues;
-  }
-
-  // Check for scoped service injection
-  lines.forEach((line, index) => {
-    SCOPED_DBCONTEXT_PATTERNS.forEach((pattern) => {
-      if (pattern.test(line)) {
-        issues.push({
-          type: 'warning',
-          message: 'Possivel injecao de servico scoped em singleton',
-          suggestion:
-            'Services scoped (DbContext, Repositories) nao devem ser injetados em singletons. Use IServiceScopeFactory ou IDbContextFactory.',
-          file: filePath,
-          line: index + 1,
-          code: line.trim(),
-        });
-      }
-      pattern.lastIndex = 0;
-    });
-  });
-
-  return issues;
-}
-
-/**
- * Checks for concurrent DbContext access in Blazor components.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {ConcurrencyIssue[]}
- */
-export function checkConcurrentAccess(content, filePath) {
-  const issues = [];
-  const lines = content.split('\n');
-
-  // Check for multiple Task.WhenAll with repository/context calls
-  if (content.includes('Task.WhenAll') || content.includes('Task.WhenAny')) {
-    // Check if the tasks involve database operations
-    const hasDbOperations =
-      content.includes('Repository') ||
-      content.includes('DbContext') ||
-      content.includes('SaveChangesAsync') ||
-      content.includes('ToListAsync');
-
-    if (hasDbOperations) {
-      lines.forEach((line, index) => {
-        if (line.includes('Task.WhenAll') || line.includes('Task.WhenAny')) {
-          issues.push({
-            type: 'warning',
-            message: 'Task.WhenAll/WhenAny com possivel acesso concorrente ao DbContext',
-            suggestion:
-              'Se as tasks acessam o mesmo DbContext, isso causara erros. Cada task deve ter seu proprio contexto via IDbContextFactory.',
-            file: filePath,
-            line: index + 1,
-            code: line.trim(),
-          });
-        }
-      });
-    }
-  }
-
-  return issues;
-}
-
-/**
- * Runs all concurrency checks on a file.
- *
- * @param {string} content - File content
- * @param {string} filePath - Path to the file
- * @returns {ConcurrencyIssue[]}
- */
-export function analyzeConcurrency(content, filePath) {
-  const issues = [];
-
-  issues.push(...checkScopedDbContextInBackground(content, filePath));
-  issues.push(...checkHangfireWithScopedServices(content, filePath));
-  issues.push(...checkScopedInSingleton(content, filePath));
-  issues.push(...checkConcurrentAccess(content, filePath));
-
-  return issues;
-}
-
-
-/**
- * Project-level concurrency validator. Scans all .cs files in projectPath.
- * Follows the same interface as other project-level validators (validateNextComponentFiles, etc.)
- *
- * @param {string} projectPath - Project root path
- * @param {Object} [_options]
- * @returns {Promise<{errors: number, warnings: number, issues: Array}>}
- */
-export async function validateConcurrencyFiles(projectPath, _options = {}) {
-  const result = { errors: 0, warnings: 0, issues: [] };
-  const pattern = projectPath.replace(/\\/g, '/') + '/**/*.cs';
-  const files = await glob(pattern, { ignore: ['**/node_modules/**', '**/obj/**', '**/bin/**'] });
-
-  for (const filePath of files) {
-    const content = readFileSync(filePath, 'utf8');
-    const relPath = filePath.replace(projectPath.replace(/\\/g, '/') + '/', '');
-    const fileIssues = analyzeConcurrency(content, relPath);
-    for (const issue of fileIssues) {
-      result.issues.push({
-        level: issue.type,
-        message: issue.message,
-        file: issue.file,
-        line: issue.line,
-        solution: issue.suggestion,
-      });
-      if (issue.type === 'error') result.errors++;
-      else result.warnings++;
-    }
-  }
-
-  return result;
-}
-
-export default {
-  analyzeConcurrency,
-  validateConcurrencyFiles,
-  checkScopedDbContextInBackground,
-  checkHangfireWithScopedServices,
-  checkScopedInSingleton,
-  checkConcurrentAccess,
-  countIssues,
-};