@polymorphism-tech/morph-spec 8.47.0 → 9.1.0

package/src/lib/detectors/design-system-detector.js

@@ -1,188 +0,0 @@
-/**
- * @fileoverview Design System Detector
- *
- * Detects if a design system exists for the project or feature.
- * Checks multiple locations in priority order.
- *
- * @module design-system-detector
- */
-
-import { existsSync, readFileSync, readdirSync } from 'fs';
-import { join } from 'path';
-
-const SKIP_DIRS = new Set(['node_modules', '.git', '.morph', 'dist', 'build', '.next', 'obj', 'bin', '.vs']);
-const CSS_SCAN_MAX_DEPTH = 6;
-
-/**
- * Recursively walk a directory collecting files with given extensions.
- * @param {string} dir - Directory to walk
- * @param {string[]} extensions - File extensions to collect (e.g. ['.css', '.scss'])
- * @param {string[]} files - Accumulator array (mutated in-place)
- * @param {number} depth - Current recursion depth
- * @param {number} maxDepth - Maximum recursion depth
- */
-function walkDirForCss(dir, extensions, files, depth, maxDepth) {
-  if (depth > maxDepth) return;
-  let entries;
-  try {
-    entries = readdirSync(dir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-  for (const entry of entries) {
-    if (entry.isDirectory()) {
-      if (!SKIP_DIRS.has(entry.name)) {
-        walkDirForCss(join(dir, entry.name), extensions, files, depth + 1, maxDepth);
-      }
-    } else if (entry.isFile()) {
-      const lower = entry.name.toLowerCase();
-      if (extensions.some(ext => lower.endsWith(ext))) {
-        files.push(join(dir, entry.name));
-      }
-    }
-  }
-}
-
-/**
- * Detect design system for project or feature
- * @param {string} projectPath - Root path of the project
- * @param {string|null} featureName - Feature name (optional, checks feature-level if provided)
- * @returns {Object} { hasDesignSystem, path, isProjectLevel, isFeatureLevel, source }
- */
-export function detectDesignSystem(projectPath, featureName = null) {
-  const result = {
-    hasDesignSystem: false,
-    path: null,
-    isProjectLevel: false,
-    isFeatureLevel: false,
-    source: null
-  };
-
-  // Priority 1: Feature-level design system (if feature specified)
-  if (featureName) {
-    const featureDesignSystemPath = join(
-      projectPath,
-      '.morph/features',
-      featureName,
-      '1-design',
-      'design-system.md'
-    );
-
-    if (existsSync(featureDesignSystemPath)) {
-      return {
-        hasDesignSystem: true,
-        path: featureDesignSystemPath,
-        isProjectLevel: false,
-        isFeatureLevel: true,
-        source: 'feature-output'
-      };
-    }
-  }
-
-  // Priority 2: Project-level design system (markdown)
-  const projectDesignSystemPath = join(projectPath, '.morph/context/design-system.md');
-  if (existsSync(projectDesignSystemPath)) {
-    return {
-      hasDesignSystem: true,
-      path: projectDesignSystemPath,
-      isProjectLevel: true,
-      isFeatureLevel: false,
-      source: 'project-markdown'
-    };
-  }
-
-  // Priority 3: Generated CSS design system
-  const cssDesignSystemPath = join(projectPath, 'wwwroot/css/design-system.css');
-  if (existsSync(cssDesignSystemPath)) {
-    return {
-      hasDesignSystem: true,
-      path: cssDesignSystemPath,
-      isProjectLevel: true,
-      isFeatureLevel: false,
-      source: 'generated-css'
-    };
-  }
-
-  // Priority 4: Recursively scan frontend root directories for CSS/SCSS with design tokens
-  const frontendRoots = ['wwwroot', 'styles', 'src/styles', 'src', 'public'];
-  const extensions = ['.css', '.scss'];
-  const collected = [];
-
-  for (const root of frontendRoots) {
-    const rootPath = join(projectPath, root);
-    if (existsSync(rootPath)) {
-      walkDirForCss(rootPath, extensions, collected, 0, CSS_SCAN_MAX_DEPTH);
-    }
-  }
-
-  // Deduplicate by resolved path
-  const seen = new Set();
-  const cssFiles = [];
-  for (const file of collected) {
-    if (!seen.has(file)) {
-      seen.add(file);
-      cssFiles.push(file);
-    }
-  }
-
-  // Sort for deterministic first-match across platforms
-  cssFiles.sort();
-
-  for (const cssFile of cssFiles) {
-    try {
-      const content = readFileSync(cssFile, 'utf8');
-      const hasDesignTokens = /:root\s*\{[\s\S]*?--/.test(content);
-      if (hasDesignTokens) {
-        return {
-          hasDesignSystem: true,
-          path: cssFile,
-          isProjectLevel: true,
-          isFeatureLevel: false,
-          source: 'existing-css-variables'
-        };
-      }
-    } catch {
-      // Continue checking other files
-    }
-  }
-
-  // No design system found
-  return result;
-}
-
-/**
- * Get recommended design system locations based on project type
- * @param {string} projectPath - Root path of the project
- * @returns {Object} { markdown, css, description }
- */
-export function getRecommendedLocations(projectPath) {
-  try {
-    const configPath = join(projectPath, '.morph/config/config.json');
-
-    let projectType = 'unknown';
-    if (existsSync(configPath)) {
-      const config = JSON.parse(readFileSync(configPath, 'utf8'));
-      projectType = config.project?.type || 'unknown';
-    }
-
-    // Default locations
-    const locations = {
-      markdown: '.morph/context/design-system.md',
-      css: 'public/design-system.css',
-      description: 'Project-level design system (shared across features)'
-    };
-
-    // Adjust based on project type
-    if (projectType === 'nextjs' || projectType.includes('nextjs')) {
-      locations.css = 'styles/design-system.css';
-    }
-
-    return locations;
-  } catch {
-    return {
-      markdown: '.morph/context/design-system.md',
-      css: 'wwwroot/css/design-system.css',
-      description: 'Project-level design system (shared across features)'
-    };
-  }
-}

package/src/lib/evaluator-report.js

@@ -1,104 +0,0 @@
-import { existsSync, readFileSync } from 'fs';
-import { getAbsoluteOutputPath } from '../core/paths/output-schema.js';
-
-export const VERDICT_TOKEN = '**Verdict:**';
-export const VERDICTS = ['SHIP', 'FIX'];
-export const BLOCKER_TYPES = ['uc', 'teste', 'regressao', 'seguranca'];
-
-// O relatório é append-only: uma reavaliação acrescenta ao fim, e o token vigente é o ÚLTIMO.
-const VERDICT_RE = /\*\*Verdict:\*\*\s*([A-Za-z]+)/g;
-const BLOCKERS_SECTION_RE = /^##\s+Bloqueadores\s*$/gim;
-const MEDIA_SECTION_RE = /^##\s+M[íi]dia\s+gerada\s*$/m;
-const SCREEN_CHECKLIST_SECTION_RE = /^##\s+Checklist\s+de\s+tela\s*$/gim;
-
-export function evaluatorReportPath(cwd, featureName) {
-  return getAbsoluteOutputPath(cwd, featureName, 'evaluatorReport');
-}
-
-function readReport(cwd, featureName) {
-  try {
-    const p = evaluatorReportPath(cwd, featureName);
-    return existsSync(p) ? readFileSync(p, 'utf8') : null;
-  } catch {
-    return null;
-  }
-}
-
-function lastSectionBody(text, re) {
-  const matches = [...text.matchAll(re)];
-  if (matches.length === 0) return null;
-  const last = matches[matches.length - 1];
-  const rest = text.slice(last.index + last[0].length);
-  const next = rest.search(/^#{1,2}\s/m);
-  return next === -1 ? rest : rest.slice(0, next);
-}
-
-const normalizeType = (s) => s.toLowerCase().normalize('NFD').replace(/[̀-ͯ]/g, '').trim();
-
-/**
- * Linhas de tabela da última `## Bloqueadores`: `| id | tipo | onde | evidência |`.
- * Cabeçalho e separador não contam; `untyped` são as linhas cujo tipo não é de {@link BLOCKER_TYPES}.
- */
-function parseBlockers(body) {
-  const blockers = [];
-  const untyped = [];
-  for (const line of body.split(/\r?\n/)) {
-    if (!/^\s*\|/.test(line)) continue;
-    const cells = line.trim().replace(/^\||\|$/g, '').split('|').map((c) => c.trim());
-    if (cells.every((c) => /^:?-{2,}:?$/.test(c) || c === '')) continue;
-    if (/^#$|^id$/i.test(cells[0]) && /^tipo$/i.test(cells[1] ?? '')) continue;
-    const row = { id: cells[0], type: normalizeType(cells[1] ?? ''), where: cells[2] ?? '', evidence: cells[3] ?? '' };
-    (BLOCKER_TYPES.includes(row.type) ? blockers : untyped).push(row);
-  }
-  return { blockers, untyped };
-}
-
-export function evaluatorVerdictFromText(text) {
-  if (typeof text !== 'string') return { verdict: undefined, blockers: [], untyped: [], superseded: [] };
-  const verdicts = [...text.matchAll(VERDICT_RE)].map((m) => m[1].toUpperCase());
-  const body = lastSectionBody(text, BLOCKERS_SECTION_RE);
-  const { blockers, untyped } = body === null ? { blockers: [], untyped: [] } : parseBlockers(body);
-  return {
-    verdict: verdicts.length ? verdicts[verdicts.length - 1] : undefined,
-    blockers,
-    untyped,
-    superseded: verdicts.slice(0, -1),
-  };
-}
-
-/**
- * `missing`: sem relatório. `unverdicted`: relatório sem `**Verdict:** SHIP|FIX` válido.
- * `ok`: veredito legível — quem decide se ele libera o ship é o risk-detector.
- */
-export function evaluatorReportState(cwd, featureName) {
-  const path = evaluatorReportPath(cwd, featureName);
-  const text = readReport(cwd, featureName);
-  if (text === null) return { status: 'missing', path };
-  const parsed = evaluatorVerdictFromText(text);
-  if (!VERDICTS.includes(parsed.verdict)) return { status: 'unverdicted', path };
-  return { status: 'ok', path, ...parsed };
-}
-
-/** O sinal `evaluatorVerdict` que `verdictPause` (risk-detector) lê — gate-check e approve leem o mesmo. */
-export function verdictSignal(report) {
-  if (report.status !== 'ok') return { status: report.status };
-  return {
-    status: 'ok',
-    verdict: report.verdict,
-    blockers: report.blockers.length,
-    blockerIds: report.blockers.map((b) => b.id),
-    untyped: report.untyped.length,
-    superseded: report.superseded,
-  };
-}
-
-export function evaluatorMediaSection(cwd, featureName) {
-  const text = readReport(cwd, featureName);
-  return text !== null && MEDIA_SECTION_RE.test(text);
-}
-
-export function evaluatorScreenChecklist(cwd, featureName) {
-  const text = readReport(cwd, featureName);
-  const body = text === null ? null : lastSectionBody(text, SCREEN_CHECKLIST_SECTION_RE);
-  return body === null ? { section: false, body: '' } : { section: true, body };
-}