@polymorphism-tech/morph-spec 8.28.0 → 8.31.0

package/framework/templates/ui/design-system.css

@@ -1,226 +1,226 @@
-/**
- * Design System - {Project Name}
- *
- * CSS Variables generated from design-system.md
- * Use estas variáveis em todo o projeto para manter consistência visual.
- *
- * Template MORPH-SPEC by Polymorphism Tech
- */
-
-:root {
-  /* ========================================
-   * CORES PRINCIPAIS
-   * ======================================== */
-
-  --color-primary: #{hex da cor primária};
-  --color-primary-hover: #{hex da cor primária mais escura};
-  --color-primary-active: #{hex da cor primária ainda mais escura};
-
-  --color-secondary: #{hex da cor secundária};
-  --color-secondary-hover: #{hex};
-  --color-secondary-active: #{hex};
-
-  /* ========================================
-   * CORES DE ESTADO
-   * ======================================== */
-
-  --color-success: #{hex};
-  --color-success-bg: #{hex com transparência ou shade mais claro};
-  --color-success-border: #{hex};
-
-  --color-error: #{hex};
-  --color-error-bg: #{hex};
-  --color-error-border: #{hex};
-
-  --color-warning: #{hex};
-  --color-warning-bg: #{hex};
-  --color-warning-border: #{hex};
-
-  --color-info: #{hex};
-  --color-info-bg: #{hex};
-  --color-info-border: #{hex};
-
-  /* ========================================
-   * ESCALA DE NEUTROS (Cinzas)
-   * ======================================== */
-
-  --color-gray-50: #{hex};
-  --color-gray-100: #{hex};
-  --color-gray-200: #{hex};
-  --color-gray-300: #{hex};
-  --color-gray-400: #{hex};
-  --color-gray-500: #{hex};
-  --color-gray-600: #{hex};
-  --color-gray-700: #{hex};
-  --color-gray-800: #{hex};
-  --color-gray-900: #{hex};
-
-  /* ========================================
-   * TIPOGRAFIA - FONTES
-   * ======================================== */
-
-  --font-sans: '{Font Name}', -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif;
-  --font-serif: '{Font Name}', Georgia, 'Times New Roman', serif;
-  --font-mono: '{Font Name}', 'Fira Code', 'Courier New', Consolas, monospace;
-
-  /* ========================================
-   * TIPOGRAFIA - TAMANHOS
-   * ======================================== */
-
-  --text-xs: 0.75rem;      /* 12px */
-  --text-sm: 0.875rem;     /* 14px */
-  --text-base: 1rem;       /* 16px */
-  --text-lg: 1.125rem;     /* 18px */
-  --text-xl: 1.25rem;      /* 20px */
-  --text-2xl: 1.5rem;      /* 24px */
-  --text-3xl: 1.875rem;    /* 30px */
-  --text-4xl: 2.25rem;     /* 36px */
-  --text-5xl: 3rem;        /* 48px */
-
-  /* ========================================
-   * TIPOGRAFIA - LINE HEIGHTS
-   * ======================================== */
-
-  --leading-none: 1;
-  --leading-tight: 1.25;
-  --leading-snug: 1.375;
-  --leading-normal: 1.5;
-  --leading-relaxed: 1.625;
-  --leading-loose: 2;
-
-  /* ========================================
-   * TIPOGRAFIA - FONT WEIGHTS
-   * ======================================== */
-
-  --font-light: 300;
-  --font-regular: 400;
-  --font-medium: 500;
-  --font-semibold: 600;
-  --font-bold: 700;
-  --font-extrabold: 800;
-
-  /* ========================================
-   * ESPAÇAMENTO
-   * Baseado em múltiplos de {base}px (ex: 4px)
-   * ======================================== */
-
-  --space-0: 0;
-  --space-1: 0.25rem;   /* 4px */
-  --space-2: 0.5rem;    /* 8px */
-  --space-3: 0.75rem;   /* 12px */
-  --space-4: 1rem;      /* 16px */
-  --space-5: 1.25rem;   /* 20px */
-  --space-6: 1.5rem;    /* 24px */
-  --space-7: 1.75rem;   /* 28px */
-  --space-8: 2rem;      /* 32px */
-  --space-10: 2.5rem;   /* 40px */
-  --space-12: 3rem;     /* 48px */
-  --space-16: 4rem;     /* 64px */
-  --space-20: 5rem;     /* 80px */
-  --space-24: 6rem;     /* 96px */
-
-  /* ========================================
-   * BORDER RADIUS
-   * ======================================== */
-
-  --rounded-none: 0;
-  --rounded-sm: 0.125rem;   /* 2px */
-  --rounded-md: 0.375rem;   /* 6px */
-  --rounded-lg: 0.5rem;     /* 8px */
-  --rounded-xl: 0.75rem;    /* 12px */
-  --rounded-2xl: 1rem;      /* 16px */
-  --rounded-full: 9999px;
-
-  /* ========================================
-   * SOMBRAS (Shadows)
-   * ======================================== */
-
-  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
-  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
-  --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
-  --shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
-  --shadow-2xl: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
-
-  /* ========================================
-   * Z-INDEX LAYERS
-   * ======================================== */
-
-  --z-0: 0;
-  --z-10: 10;
-  --z-20: 20;
-  --z-30: 30;
-  --z-40: 40;
-  --z-50: 50;      /* Modals, dropdowns */
-  --z-100: 100;    /* Tooltips */
-  --z-max: 9999;   /* Toasts, notifications */
-
-  /* ========================================
-   * TRANSITIONS / ANIMATIONS
-   * ======================================== */
-
-  --transition-fast: 150ms ease-in-out;
-  --transition-base: 250ms ease-in-out;
-  --transition-slow: 350ms ease-in-out;
-
-  --ease-in: cubic-bezier(0.4, 0, 1, 1);
-  --ease-out: cubic-bezier(0, 0, 0.2, 1);
-  --ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
-
-  /* ========================================
-   * BREAKPOINTS (informativo - usar em media queries)
-   * ======================================== */
-
-  /* @media (min-width: 640px) - sm */
-  /* @media (min-width: 768px) - md */
-  /* @media (min-width: 1024px) - lg */
-  /* @media (min-width: 1280px) - xl */
-  /* @media (min-width: 1536px) - 2xl */
-}
-
-/* ========================================
- * MODO ESCURO (Dark Mode)
- * Opcional - ajuste as cores para dark theme
- * ======================================== */
-
-@media (prefers-color-scheme: dark) {
-  :root {
-    /* Inverter cores conforme necessário */
-    --color-gray-50: #{hex do gray-900};
-    --color-gray-900: #{hex do gray-50};
-    /* ... outras inversões */
-  }
-}
-
-/* ========================================
- * CLASSES UTILITÁRIAS (Exemplo)
- * ======================================== */
-
-/* Exemplo de uso das variáveis */
-.btn-primary {
-  background-color: var(--color-primary);
-  color: white;
-  padding: var(--space-2) var(--space-4);
-  border-radius: var(--rounded-md);
-  font-weight: var(--font-semibold);
-  transition: background-color var(--transition-base);
-}
-
-.btn-primary:hover {
-  background-color: var(--color-primary-hover);
-}
-
-.card {
-  background-color: white;
-  padding: var(--space-6);
-  border-radius: var(--rounded-lg);
-  box-shadow: var(--shadow-md);
-}
-
-.text-muted {
-  color: var(--color-gray-600);
-  font-size: var(--text-sm);
-}
-
-/* ========================================
- * FIM DO DESIGN SYSTEM
- * ======================================== */
+/**
+ * Design System - {Project Name}
+ *
+ * CSS Variables generated from design-system.md
+ * Use estas variáveis em todo o projeto para manter consistência visual.
+ *
+ * Template MORPH-SPEC by Polymorphism Tech
+ */
+
+:root {
+  /* ========================================
+   * CORES PRINCIPAIS
+   * ======================================== */
+
+  --color-primary: #{hex da cor primária};
+  --color-primary-hover: #{hex da cor primária mais escura};
+  --color-primary-active: #{hex da cor primária ainda mais escura};
+
+  --color-secondary: #{hex da cor secundária};
+  --color-secondary-hover: #{hex};
+  --color-secondary-active: #{hex};
+
+  /* ========================================
+   * CORES DE ESTADO
+   * ======================================== */
+
+  --color-success: #{hex};
+  --color-success-bg: #{hex com transparência ou shade mais claro};
+  --color-success-border: #{hex};
+
+  --color-error: #{hex};
+  --color-error-bg: #{hex};
+  --color-error-border: #{hex};
+
+  --color-warning: #{hex};
+  --color-warning-bg: #{hex};
+  --color-warning-border: #{hex};
+
+  --color-info: #{hex};
+  --color-info-bg: #{hex};
+  --color-info-border: #{hex};
+
+  /* ========================================
+   * ESCALA DE NEUTROS (Cinzas)
+   * ======================================== */
+
+  --color-gray-50: #{hex};
+  --color-gray-100: #{hex};
+  --color-gray-200: #{hex};
+  --color-gray-300: #{hex};
+  --color-gray-400: #{hex};
+  --color-gray-500: #{hex};
+  --color-gray-600: #{hex};
+  --color-gray-700: #{hex};
+  --color-gray-800: #{hex};
+  --color-gray-900: #{hex};
+
+  /* ========================================
+   * TIPOGRAFIA - FONTES
+   * ======================================== */
+
+  --font-sans: '{Font Name}', -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif;
+  --font-serif: '{Font Name}', Georgia, 'Times New Roman', serif;
+  --font-mono: '{Font Name}', 'Fira Code', 'Courier New', Consolas, monospace;
+
+  /* ========================================
+   * TIPOGRAFIA - TAMANHOS
+   * ======================================== */
+
+  --text-xs: 0.75rem;      /* 12px */
+  --text-sm: 0.875rem;     /* 14px */
+  --text-base: 1rem;       /* 16px */
+  --text-lg: 1.125rem;     /* 18px */
+  --text-xl: 1.25rem;      /* 20px */
+  --text-2xl: 1.5rem;      /* 24px */
+  --text-3xl: 1.875rem;    /* 30px */
+  --text-4xl: 2.25rem;     /* 36px */
+  --text-5xl: 3rem;        /* 48px */
+
+  /* ========================================
+   * TIPOGRAFIA - LINE HEIGHTS
+   * ======================================== */
+
+  --leading-none: 1;
+  --leading-tight: 1.25;
+  --leading-snug: 1.375;
+  --leading-normal: 1.5;
+  --leading-relaxed: 1.625;
+  --leading-loose: 2;
+
+  /* ========================================
+   * TIPOGRAFIA - FONT WEIGHTS
+   * ======================================== */
+
+  --font-light: 300;
+  --font-regular: 400;
+  --font-medium: 500;
+  --font-semibold: 600;
+  --font-bold: 700;
+  --font-extrabold: 800;
+
+  /* ========================================
+   * ESPAÇAMENTO
+   * Baseado em múltiplos de {base}px (ex: 4px)
+   * ======================================== */
+
+  --space-0: 0;
+  --space-1: 0.25rem;   /* 4px */
+  --space-2: 0.5rem;    /* 8px */
+  --space-3: 0.75rem;   /* 12px */
+  --space-4: 1rem;      /* 16px */
+  --space-5: 1.25rem;   /* 20px */
+  --space-6: 1.5rem;    /* 24px */
+  --space-7: 1.75rem;   /* 28px */
+  --space-8: 2rem;      /* 32px */
+  --space-10: 2.5rem;   /* 40px */
+  --space-12: 3rem;     /* 48px */
+  --space-16: 4rem;     /* 64px */
+  --space-20: 5rem;     /* 80px */
+  --space-24: 6rem;     /* 96px */
+
+  /* ========================================
+   * BORDER RADIUS
+   * ======================================== */
+
+  --rounded-none: 0;
+  --rounded-sm: 0.125rem;   /* 2px */
+  --rounded-md: 0.375rem;   /* 6px */
+  --rounded-lg: 0.5rem;     /* 8px */
+  --rounded-xl: 0.75rem;    /* 12px */
+  --rounded-2xl: 1rem;      /* 16px */
+  --rounded-full: 9999px;
+
+  /* ========================================
+   * SOMBRAS (Shadows)
+   * ======================================== */
+
+  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+  --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+  --shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
+  --shadow-2xl: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
+
+  /* ========================================
+   * Z-INDEX LAYERS
+   * ======================================== */
+
+  --z-0: 0;
+  --z-10: 10;
+  --z-20: 20;
+  --z-30: 30;
+  --z-40: 40;
+  --z-50: 50;      /* Modals, dropdowns */
+  --z-100: 100;    /* Tooltips */
+  --z-max: 9999;   /* Toasts, notifications */
+
+  /* ========================================
+   * TRANSITIONS / ANIMATIONS
+   * ======================================== */
+
+  --transition-fast: 150ms ease-in-out;
+  --transition-base: 250ms ease-in-out;
+  --transition-slow: 350ms ease-in-out;
+
+  --ease-in: cubic-bezier(0.4, 0, 1, 1);
+  --ease-out: cubic-bezier(0, 0, 0.2, 1);
+  --ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
+
+  /* ========================================
+   * BREAKPOINTS (informativo - usar em media queries)
+   * ======================================== */
+
+  /* @media (min-width: 640px) - sm */
+  /* @media (min-width: 768px) - md */
+  /* @media (min-width: 1024px) - lg */
+  /* @media (min-width: 1280px) - xl */
+  /* @media (min-width: 1536px) - 2xl */
+}
+
+/* ========================================
+ * MODO ESCURO (Dark Mode)
+ * Opcional - ajuste as cores para dark theme
+ * ======================================== */
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    /* Inverter cores conforme necessário */
+    --color-gray-50: #{hex do gray-900};
+    --color-gray-900: #{hex do gray-50};
+    /* ... outras inversões */
+  }
+}
+
+/* ========================================
+ * CLASSES UTILITÁRIAS (Exemplo)
+ * ======================================== */
+
+/* Exemplo de uso das variáveis */
+.btn-primary {
+  background-color: var(--color-primary);
+  color: white;
+  padding: var(--space-2) var(--space-4);
+  border-radius: var(--rounded-md);
+  font-weight: var(--font-semibold);
+  transition: background-color var(--transition-base);
+}
+
+.btn-primary:hover {
+  background-color: var(--color-primary-hover);
+}
+
+.card {
+  background-color: white;
+  padding: var(--space-6);
+  border-radius: var(--rounded-lg);
+  box-shadow: var(--shadow-md);
+}
+
+.text-muted {
+  color: var(--color-gray-600);
+  font-size: var(--text-sm);
+}
+
+/* ========================================
+ * FIM DO DESIGN SYSTEM
+ * ======================================== */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "8.28.0",
+  "version": "8.31.0",
   "description": "MORPH-SPEC: NLH (Natural Language Harness) for spec-driven development with Claude Code",
   "keywords": [
     "claude-code",

package/src/commands/dashboard/dashboard.js

@@ -1,53 +1,53 @@
-import { spawn } from 'child_process';
-import { existsSync } from 'fs';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import chalk from 'chalk';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-export async function dashboardCommand(options = {}) {
-  const port = options.port || '3200';
-  const dashboardDir = resolve(__dirname, '..', '..', 'dashboard');
-  const nodeModules = resolve(dashboardDir, 'node_modules');
-
-  // Check if dashboard dependencies are installed
-  if (!existsSync(nodeModules)) {
-    console.log(chalk.yellow('Installing dashboard dependencies...'));
-    const install = spawn('npm', ['install'], {
-      cwd: dashboardDir,
-      stdio: 'inherit',
-      shell: true,
-    });
-    await new Promise((res, rej) => {
-      install.on('close', (code) => (code === 0 ? res() : rej(new Error(`npm install failed with code ${code}`))));
-    });
-  }
-
-  console.log(chalk.cyan(`\n  Starting morph-spec dashboard at http://localhost:${port}\n`));
-
-  const env = {
-    ...process.env,
-    MORPH_PROJECT_DIR: process.cwd(),
-  };
-
-  const viteArgs = ['vite', '--port', port];
-  if (options.open !== false) viteArgs.push('--open');
-
-  const vite = spawn('npx', viteArgs, {
-    cwd: dashboardDir,
-    stdio: 'inherit',
-    shell: true,
-    env,
-  });
-
-  vite.on('error', (err) => {
-    console.error(chalk.red(`Failed to start dashboard: ${err.message}`));
-    process.exit(1);
-  });
-
-  process.on('SIGINT', () => {
-    vite.kill();
-    process.exit(0);
-  });
-}
+import { spawn } from 'child_process';
+import { existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export async function dashboardCommand(options = {}) {
+  const port = options.port || '3200';
+  const dashboardDir = resolve(__dirname, '..', '..', 'dashboard');
+  const nodeModules = resolve(dashboardDir, 'node_modules');
+
+  // Check if dashboard dependencies are installed
+  if (!existsSync(nodeModules)) {
+    console.log(chalk.yellow('Installing dashboard dependencies...'));
+    const install = spawn('npm', ['install'], {
+      cwd: dashboardDir,
+      stdio: 'inherit',
+      shell: true,
+    });
+    await new Promise((res, rej) => {
+      install.on('close', (code) => (code === 0 ? res() : rej(new Error(`npm install failed with code ${code}`))));
+    });
+  }
+
+  console.log(chalk.cyan(`\n  Starting morph-spec dashboard at http://localhost:${port}\n`));
+
+  const env = {
+    ...process.env,
+    MORPH_PROJECT_DIR: process.cwd(),
+  };
+
+  const viteArgs = ['vite', '--port', port];
+  if (options.open !== false) viteArgs.push('--open');
+
+  const vite = spawn('npx', viteArgs, {
+    cwd: dashboardDir,
+    stdio: 'inherit',
+    shell: true,
+    env,
+  });
+
+  vite.on('error', (err) => {
+    console.error(chalk.red(`Failed to start dashboard: ${err.message}`));
+    process.exit(1);
+  });
+
+  process.on('SIGINT', () => {
+    vite.kill();
+    process.exit(0);
+  });
+}

package/src/commands/graph/affected.js

@@ -0,0 +1,89 @@
+/**
+ * `morph-spec graph affected <símbolo>` — blast radius saneado.
+ *
+ * O valor medido não é recall: contra o grep, o grafo achou ZERO arquivos a
+ * mais. É precisão — 58% menos ruído em 12 símbolos do ProspectPRO (1.092
+ * arquivos no grep, 266 usos reais) e a classificação da relação. `IHandler`
+ * aparece em 193 arquivos no grep e tem 2 usos reais: é implementada por 98.
+ *
+ * @module graph-affected
+ */
+import chalk from 'chalk';
+import { loadGraph, getFreshness } from '../../lib/graph/graph-loader.js';
+import { buildIndex, resolveLabel, affected } from '../../lib/graph/sanitize.js';
+
+const FALLBACK_HINT = 'Sem resposta do grafo, caia para grep/Glob — o grafo é um subconjunto estrito do grep, então cair para grep não perde recall.';
+
+/**
+ * @param {string} symbol
+ * @param {{path?: string, json?: boolean, prod?: boolean, usesOnly?: boolean}} [options]
+ */
+export async function graphAffectedCommand(symbol, options = {}) {
+  const projectPath = options.path || process.cwd();
+  const loaded = loadGraph(projectPath);
+
+  if (!loaded.ok) {
+    const payload = {
+      ok: false, reason: 'no-graph', detail: loaded.reason, hint: FALLBACK_HINT,
+    };
+    if (options.json) console.log(JSON.stringify(payload, null, 2));
+    else {
+      console.error(chalk.yellow(`\n○ Sem grafo (${loaded.reason}).`));
+      console.error(chalk.gray(`   ${FALLBACK_HINT}\n`));
+    }
+    process.exit(1);
+  }
+
+  const { graph } = loaded;
+  const index = buildIndex(graph);
+  const resolved = resolveLabel(index, symbol);
+
+  if (!resolved.ok) {
+    const payload = {
+      ok: false, reason: resolved.reason, symbol,
+      options: resolved.options, hint: FALLBACK_HINT,
+    };
+    if (options.json) {
+      console.log(JSON.stringify(payload, null, 2));
+    } else if (resolved.reason === 'ambiguous') {
+      console.error(chalk.yellow(`\n○ "${symbol}" é ambíguo — escolha pelo path ou pelo id:`));
+      for (const o of resolved.options) console.error(chalk.gray(`   ${o.source_file}  (${o.id})`));
+      console.error('');
+    } else {
+      console.error(chalk.yellow(`\n○ "${symbol}" não existe no grafo.`));
+      console.error(chalk.gray(`   ${FALLBACK_HINT}\n`));
+    }
+    process.exit(1);
+  }
+
+  const consumers = affected(index, graph, resolved.id, {
+    prod: options.prod === true,
+    excludeInheritance: options.usesOnly === true,
+  });
+  const freshness = getFreshness(projectPath, graph);
+  const payload = {
+    ok: true,
+    symbol,
+    id: resolved.id,
+    source_file: resolved.node.source_file,
+    consumers,
+    count: consumers.length,
+    freshness,
+  };
+
+  if (options.json) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+
+  console.log(chalk.green(`\n✅ ${symbol} — ${consumers.length} consumidor(es)`));
+  console.log(chalk.gray(`   declarado em ${resolved.node.source_file}`));
+  if (freshness.state === 'stale') {
+    console.log(chalk.yellow('   ⚠ grafo stale (o rebuild do hook é assíncrono) — confirme no código antes de agir'));
+  }
+  for (const c of consumers) {
+    const loc = c.source_location ? `:${c.source_location}` : '';
+    console.log(`   ${chalk.cyan(c.relation.padEnd(14))} ${c.source_file}${loc}  ${chalk.gray(c.label)}`);
+  }
+  console.log('');
+}