sdd-es 2.5.0 → 2.6.0

package/skills/memory-compactor/SKILL.md

@@ -1,114 +1,68 @@
 ---
-description: Comprime los archivos .sdd/memoria/agente-*.md cuando superan 80 entradas o 50KB. Elimina duplicados (misma ruta, fecha distinta — conserva la más reciente) y aplica el diccionario caveman de compresion-tokens (Nivel Full). Produce backup .original antes de comprimir.
-model: claude-haiku-4-5-20251001
+name: memory-compactor
+model: claude-haiku-4-5
+description: Comprime archivos de memoria de agentes cuando superan umbral (>50KB)
 allowed-tools: Read, Write, Bash
 ---
 
 # Skill: Memory Compactor
 
-## Propósito
-
-Los archivos de memoria de agentes crecen indefinidamente a lo largo de proyectos largos. Una memoria de 200 entradas consume ~30KB de ventana de contexto en cada invocación del agente — contexto que podría usarse para la tarea real. Esta skill comprime esos archivos sin perder las decisiones clave.
-
-**Cuándo ejecutar:**
-- Cuando el hook `agent-memory.js` emite: `⚠️ Memoria de {agente} supera 50KB`
-- Cuando `/sdd.optimizar memoria` detecta archivos por encima del umbral
-- Manualmente si el agente empieza a ignorar instrucciones (señal de contexto saturado)
+**Propósito:** Comprimir automáticamente archivos de memoria de agentes (`.sdd/memoria/agente-*.md`) cuando superan 50KB, eliminando entradas duplicadas y aplicando técnicas de reducción de contexto.
 
 ---
 
-## PASO 1 — Detectar archivos que superan el umbral
-
-```bash
-# Listar archivos de memoria con su tamaño
-ls -la .sdd/memoria/agente-*.md 2>/dev/null || echo "SIN_ARCHIVOS_MEMORIA"
-
-# Contar entradas por archivo (cada entrada empieza con "## ")
-for f in .sdd/memoria/agente-*.md; do
-  [ -f "$f" ] || continue
-  entradas=$(grep -c "^## " "$f" 2>/dev/null || echo 0)
-  bytes=$(wc -c < "$f" 2>/dev/null || echo 0)
-  echo "$f: $entradas entradas, $bytes bytes"
-done
-```
+## Cuándo Usar
 
-**Umbral de intervención:** >80 entradas O >50KB. Si ningún archivo supera el umbral, reportar "✅ Memorias dentro del umbral — no se requiere compresión" y terminar.
+1. **Automático:** Hook `agent-memory.js` la dispara cuando memoria > 50KB
+2. **Manual:** Usuario ejecuta `/sdd.optimizar memoria` en proyectos largos
 
 ---
 
-## PASO 2 — Para cada archivo que supera el umbral
+## Qué Hace
 
-### 2a. Crear backup
-
-```bash
-cp .sdd/memoria/agente-{nombre}.md .sdd/memoria/agente-{nombre}.md.original
-```
-
-### 2b. Leer el archivo completo
-
-Parsear línea a línea. Cada entrada tiene este formato:
-```markdown
-## 2026-06-13 — ruta/del/archivo.md
-> resumen de la acción tomada
-```
+### Deduplicación
+Elimina entradas duplicadas del mismo archivo.
 
-### 2c. Eliminar duplicados
+### Compresión por Caveman (Nivel Full)
+Aplica diccionario de reemplazos: `CREATE TABLE` → `CT`, `SELECT * FROM` → `SF`, etc.
 
-Agrupar entradas por `archivo` (la parte después del `—` en el encabezado `##`). De cada grupo, conservar **solo la entrada más reciente** (la de fecha más alta). Las fechas están en formato ISO 8601 `YYYY-MM-DD` — ordenar lexicográficamente es suficiente.
+### Backup Automático
+Crea `.original.md` antes de comprimir.
 
-**Ejemplo:**
-```
-## 2026-06-01 — .sdd/especificaciones/auth/spec.md  ← ELIMINAR (más antigua)
-## 2026-06-10 — .sdd/especificaciones/auth/spec.md  ← CONSERVAR (más reciente)
-```
-
-### 2d. Aplicar compresión Nivel Full al cuerpo de cada entrada
-
-El diccionario completo vive en `{PLUGIN_DIR}/skills/compresion-tokens/SKILL.md`. No duplicar los pares aquí — leer la sección "Diccionario Nivel Full" de esa skill y aplicar los mismos 80+ reemplazos sobre el texto de cada línea `>`.
+---
 
-**Patrones que NUNCA comprimir** (igual que en `compresion-tokens`):
-- Rutas de archivo (la parte después del `—` en `##`)
-- Código entre backticks
-- Nombres de variables, funciones, clases
-- URLs y comandos
+## Output
 
-### 2e. Reescribir el archivo comprimido
+**Antes:** `.sdd/memoria/agente-arquitecto.md = 150KB (80 entradas)`
 
-```markdown
-# Memoria del agente: {nombre}
+**Después:** `.sdd/memoria/agente-arquitecto.md = 15KB (8 entradas únicas)`
 
-[Comprimido por memory-compactor el {fecha}. Backup en .original]
-Léelo al inicio de cada sesión para mantener continuidad entre conversaciones.
+Mensaje: `✨ [auto-compress] arquitecto: 150KB → 15KB (10%)`
 
 ---
 
-{entradas deduplicadas y comprimidas, ordenadas por fecha descendente}
-```
+## Detalles Técnicos
+
+- Deduplicación por `## YYYY-MM-DD — filepath`
+- Reutiliza diccionario de `skills/compresion-tokens/SKILL.md`
+- Backup `.original.md` siempre
+- Performance: <100ms
+- Trigger automático >50KB en `agent-memory.js`
 
 ---
 
-## PASO 3 — Reporte
+## API (Internal)
 
+```javascript
+triggerAutoCompresion(cwd, agente, memoriaFile)
 ```
-╔══════════════════════════════════════════════════════════════╗
-║        🧠 MEMORY COMPACTOR — Resultado                       ║
-╠══════════════════════════════════════════════════════════════╣
-║  AGENTE           | ANTES        | DESPUÉS      | REDUCCIÓN  ║
-║  ─────────────────┼──────────────┼──────────────┼─────────── ║
-║  {nombre}         | {N} entr.    | {M} entr.    | {%}%       ║
-║                   | {KB_antes}KB | {KB_desp}KB  |            ║
-╠══════════════════════════════════════════════════════════════╣
-║  Backups guardados en: .sdd/memoria/*.md.original            ║
-║  Para restaurar: cp agente-{nombre}.md.original agente-...   ║
-╚══════════════════════════════════════════════════════════════╝
-```
+
+Ejecuta compresión automáticamente cuando se excede umbral.
 
 ---
 
 ## Notas
 
-- Esta skill reutiliza el diccionario de `compresion-tokens` — no lo reinventa.
-- La deduplicación es la técnica más efectiva: en proyectos largos, el 40-60% de las entradas son re-escrituras del mismo archivo.
-- Nunca borrar el `.original` automáticamente — el usuario decide cuándo hacerlo.
-- Si un archivo tiene <20 entradas y <20KB, saltar silenciosamente aunque se haya invocado la skill.
-- Esta skill se invoca desde `/sdd.optimizar memoria` y desde `/sdd.comprimir memoria`.
+- Idempotente (ejecutar 2 veces = mismo resultado)
+- Nunca pierdes datos (backup existe siempre)
+- No interrumpe flujos (solo stderr messages)

package/skills/mutation-detector/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: mutation-detector
+model: claude-haiku-4-5
+description: Detecta mutaciones (cambios) en archivos para tracking de calidad
+allowed-tools: Read, Bash
+---
+
+# Skill: Mutation Detector
+
+**Propósito:** Analizar patrones de cambio en archivos para detectar inestabilidad y calcular defect escape rate.
+
+---
+
+## Cómo Funciona
+
+### Ledger de Mutaciones
+
+Cada vez que un agente modifica un archivo (Write, Edit, MultiEdit), el hook registra:
+```json
+{
+  "ts": "2026-06-14T10:30:00Z",
+  "agente": "backend-dev",
+  "archivo": "src/auth.ts",
+  "tool": "Edit",
+  "tipo": "partial"
+}
+```
+
+**Campo `tipo`:**
+- `full` — Write (archivo nuevamente escrito desde cero)
+- `partial` — Edit (cambios parciales al archivo)
+
+### Análisis de Estabilidad
+
+Mutation Detector agrupa por archivo:
+```
+src/auth.ts:
+  - Mutación 1: backend-dev (full)    2026-06-10 10:00
+  - Mutación 2: backend-dev (partial) 2026-06-11 14:30
+  - Mutación 3: tester-qa (partial)   2026-06-11 15:00 (test fail)
+  
+Análisis:
+  - Total mutaciones: 3
+  - Autor principal: backend-dev
+  - Estabilidad: INESTABLE (3 cambios en 2 días)
+  - Defect finder: tester-qa encontró 1 bug
+```
+
+---
+
+## Defect Escape Rate
+
+**Fórmula:**
+```
+Defect Escape Rate = (Bugs encontrados) / (Total bugs presentes)
+
+Ejemplo:
+- Backend Dev escribió src/auth.ts
+- QA ejecutó tests, encontró 4 bugs
+- En producción: 1 bug adicional
+
+Escape Rate = 1 / 5 = 20%
+```
+
+**Tabla por agente:**
+```
+AGENTE         | ARCHIVOS | BUGS ENCONTRADOS | BUGS EN PROD | ESCAPE RATE
+───────────────┼──────────┼──────────────────┼─────────────┼──────────
+backend-dev    | 12       | 4                | 1           | 20%
+frontend-dev   | 8        | 0                | 0           | N/A
+tester-qa      | —        | 4 encontrados    | —           | 100% accuracy
+```
+
+---
+
+## Output: Comando `/sdd.defect-report`
+
+**Resumen ejecutivo:**
+```
+DEFECT REPORT — Sesión 2026-06-14
+
+Archivos modificados: 12
+Bugs encontrados (QA): 4
+Bugs en producción (post-release): 1
+─────────────────────────────────
+Global Escape Rate: 20% (1 de 5)
+
+Por agente:
+  backend-dev:   4 archivos, 3 bugs encontrados → 75% quality score
+  frontend-dev:  8 archivos, 1 bug encontrado   → 88% quality score
+  tester-qa:     Encontró 4 bugs (100% accuracy)
+```
+
+---
+
+## Implementación Técnica
+
+### Ledger: `.sdd/observabilidad/mutaciones.jsonl`
+
+Append-only JSONL donde cada línea es una mutación:
+```json
+{"ts":"2026-06-14T10:30:00Z","agente":"backend-dev","archivo":"src/auth.ts","tool":"Edit","tipo":"partial"}
+{"ts":"2026-06-14T10:35:00Z","agente":"backend-dev","archivo":"src/auth.ts","tool":"Write","tipo":"full"}
+{"ts":"2026-06-14T15:00:00Z","agente":"tester-qa","archivo":"src/auth.test.ts","tool":"Write","tipo":"full"}
+```
+
+### Agregación por archivo
+
+```javascript
+const mutacionesPorArchivo = {};
+for (const mut of mutaciones) {
+  if (!mutacionesPorArchivo[mut.archivo]) {
+    mutacionesPorArchivo[mut.archivo] = [];
+  }
+  mutacionesPorArchivo[mut.archivo].push(mut);
+}
+```
+
+### Cálculo de Inestabilidad
+
+```
+Si archivo tiene >2 mutaciones en <24h → INESTABLE
+Si archivo tiene >5 mutaciones → CRÍTICO
+```
+
+---
+
+## Notas
+
+- Fase 1 (v2.6.0): Solo tracking + informe simple
+- Fase 2 (v2.6.1): Dashboard con gráficos
+- Ledger append-only: nunca sobrescrito, histórico completo
+- Reversible: puedes recalcular estadísticas en cualquier momento
+

package/skills/observabilidad-consumo/SKILL.md

@@ -1,6 +1,6 @@
 ---
 description: Lee .sdd/observabilidad/consumo.jsonl y genera un reporte de actividad de agentes — invocaciones por agente, archivos tocados, picos y señales de fan-out excesivo. Referencia cruzada con orquestacion-ptc y compresion-tokens.
-model: claude-haiku-4-5-20251001
+model: haiku
 allowed-tools: Read, Bash
 ---
 

package/skills/token-budget/SKILL.md

@@ -1,6 +1,6 @@
 ---
 description: Dado el estado actual del proyecto (fase, tareas pendientes, historial de consumo), estima el presupuesto de tokens por fase restante y recomienda si usar PTC paralelo o serial. Reutiliza criterios de orquestacion-ptc para la recomendación de paralelización.
-model: claude-haiku-4-5-20251001
+model: haiku
 allowed-tools: Read
 ---
 
@@ -108,6 +108,29 @@ Para la fase `implementacion` con N tareas pendientes:
 
 ---
 
+## Señal de alerta: presupuesto proyectado < 20%
+
+Tras calcular el peso total estimado de las fases restantes y compararlo con el presupuesto disponible (calibrado con el ledger), si **el presupuesto proyectado restante cae por debajo del 20%**, emite una alerta destacada antes de cualquier recomendación:
+
+```
+⚠️  ALERTA DE PRESUPUESTO — proyección < 20% disponible
+
+   Presupuesto proyectado restante: {X}%  (umbral crítico: 20%)
+   Fases que aún no caben con el margen actual: {lista}
+
+   ACCIONES RECOMENDADAS (de mayor a menor impacto):
+   1. Ejecutar /sdd.comprimir aplicar para liberar contexto ahora.
+   2. Degradar modelos con effort-router en las fases restantes.
+   3. Paralelizar con PTC las tareas independientes (ahorro del orquestador).
+   4. Dividir la fase de implementación: ejecutar por lotes y comprimir entre lotes.
+```
+
+Cómo se calcula el porcentaje proyectado: `(peso_disponible − peso_total_estimado_fases_restantes) / peso_disponible × 100`. Si no hay historial para fijar `peso_disponible`, usa el umbral conservador del ledger (velocidad observada × eventos restantes estimados) y marca la alerta como **estimación sin calibrar**.
+
+La alerta es informativa y no bloquea: el usuario decide. Pero debe mostrarse SIEMPRE que la proyección cruce el umbral del 20%.
+
+---
+
 ## Output que produces
 
 ```

package/skills/wireframe-mvp/SKILL.md

@@ -1,6 +1,6 @@
 ---
 description: Genera un wireframe HTML de la pantalla P0 del MVP. Usa el DESIGN.md activo para colores, tipografía y estilo. Guarda el HTML en .sdd/diseño/ con la tool Write. Respeta {PLUGIN_DIR}/craft/anti-ai-slop.md.
-model: claude-sonnet-4-6
+model: sonnet
 allowed-tools: Read, Write, Bash
 ---
 

package/mcp-figma/README.md

@@ -1,158 +0,0 @@
-# sdd-figma-mcp
-
-MCP server local para integración de Figma con proyectos que usan SDD-ES. Lo usa el agente `desarrollador-frontend` para analizar el sistema de diseño del proyecto, traer componentes de Figma y generar código adaptado — sin romper lo que ya existe.
-
-## Qué hace
-
-| Herramienta | Qué resuelve |
-|---|---|
-| `analizar_sistema_diseño` | Lee tokens, colores, tipografía y componentes del proyecto local |
-| `evaluar_ui_existente` | Score 0-100 + problemas + sugerencias de mejora |
-| `conectar_figma` | Verifica PAT y metadata del archivo |
-| `listar_componentes` | Lista componentes publicados en el archivo Figma |
-| `traer_componente` | Detalle completo de un nodo: estructura, fills, texto, dimensiones |
-| `mapear_estilos` | Cruza colores/tipografía de Figma con tokens del proyecto |
-| `generar_componente` | Código React/Vue adaptado al sistema de diseño local |
-| `sugerir_mejoras` | Lista priorizada de mejoras al design system |
-
-## Instalación
-
-### 1. Sin dependencias — listo para ejecutar
-
-No hay `npm install`. El servidor usa exclusivamente módulos built-in de Node.js (`readline`, `fs`, `path`) y `fetch` nativo (disponible desde Node 18). El `package.json` es solo un descriptor — no instala nada.
-
-### 2. Obtener el Personal Access Token de Figma
-
-1. Abre Figma → Menú de usuario (esquina superior derecha) → **Settings**
-2. Pestaña **Security** → **Personal access tokens** → **Generate new token**
-3. Dale un nombre (ej. `sdd-figma-mcp`) y copia el token
-
-### 3. Definir FIGMA_PAT como variable de entorno del sistema
-
-El MCP lee el token desde `process.env.FIGMA_PAT` — **no está hardcodeado en ningún archivo de configuración** para evitar que quede en el repositorio.
-
-Claude Code hereda las variables de entorno de la sesión donde se lanza, así que basta con definirla una vez en el sistema:
-
-**Windows (PowerShell, permanente para el usuario):**
-```powershell
-[System.Environment]::SetEnvironmentVariable("FIGMA_PAT", "tu-token-aqui", "User")
-# Cierra y vuelve a abrir la terminal para que tome efecto
-```
-
-**Windows (solo sesión actual):**
-```powershell
-$env:FIGMA_PAT = "tu-token-aqui"
-```
-
-**macOS / Linux (permanente):**
-```bash
-echo 'export FIGMA_PAT="tu-token-aqui"' >> ~/.zshrc   # o ~/.bashrc
-source ~/.zshrc
-```
-
-> Si el proyecto tiene un `.env` que Claude Code carga automáticamente, también puedes agregar `FIGMA_PAT=tu-token` ahí — el proceso Node lo hereda igual.
-
-### 4. Registrar el MCP en Claude Code
-
-Agrega esto a tu `.claude/settings.json` (o `~/.claude/settings.json` para uso global):
-
-```json
-{
-  "mcpServers": {
-    "sdd-figma": {
-      "command": "node",
-      "args": ["/ruta/absoluta/al/sdd-lite/mcp-figma/src/index.js"]
-    }
-  }
-}
-```
-
-No hay campo `env` — el servidor hereda `FIGMA_PAT` directamente del entorno del sistema (paso 3). Así el token nunca queda registrado en ningún archivo de configuración del repositorio.
-
-> Reemplaza `/ruta/absoluta/al/sdd-lite` con la ruta real donde instalaste SDD-ES.
-> En Windows usa barras invertidas dobles: `"c:\\\\Users\\\\usuario\\\\sdd-lite\\\\mcp-figma\\\\src\\\\index.js"`
-
-### 5. Verificar
-
-Reinicia Claude Code y ejecuta en cualquier proyecto frontend:
-
-```
-analizar_sistema_diseño({ project_root: "." })
-```
-
-Deberías ver el perfil del sistema de diseño del proyecto.
-
-## Cómo encontrar el file_key de Figma
-
-La URL de Figma tiene este formato:
-
-```
-https://www.figma.com/file/ABCDEF123456/nombre-del-archivo?node-id=0:1
-                           ^^^^^^^^^^^^
-                           este es el file_key
-```
-
-## Cómo encontrar el node_id
-
-1. Selecciona el frame o componente en Figma
-2. La URL cambia a: `?node-id=123:456`
-3. Ese valor (`123:456` o en formato `123-456`) es el `node_id`
-
-## Flujo típico de uso
-
-```
-# 1. Analiza lo que ya tiene el proyecto
-analizar_sistema_diseño({ project_root: "/mi/proyecto" })
-
-# 2. Conecta con el archivo de Figma
-conectar_figma({ file_key: "ABCDEF123456" })
-
-# 3. Lista los componentes disponibles
-listar_componentes({ file_key: "ABCDEF123456", filter: "Button" })
-
-# 4. Trae el componente que quieres implementar
-traer_componente({ file_key: "ABCDEF123456", node_id: "123:456" })
-
-# 5. Verifica que los estilos tienen equivalente en el proyecto
-mapear_estilos({ file_key: "ABCDEF123456", node_id: "123:456", project_root: "/mi/proyecto" })
-
-# 6. Genera el código adaptado
-generar_componente({ file_key: "ABCDEF123456", node_id: "123:456", project_root: "/mi/proyecto" })
-```
-
-## Stacks soportados
-
-| Framework | CSS | Estado |
-|---|---|---|
-| React / Next.js | Tailwind CSS | ✅ Completo |
-| React / Next.js | CSS Modules | ✅ Completo |
-| Vue 3 | Tailwind / Scoped CSS | ✅ Completo |
-| React / Next.js | styled-components | ⚠️ Parcial (genera CSS Module) |
-| Angular | Cualquiera | ⚠️ Genera React, ajusta manualmente |
-| Svelte | Cualquiera | 🔜 En roadmap |
-
-## Variables de entorno
-
-| Variable | Requerida | Descripción |
-|---|---|---|
-| `FIGMA_PAT` | Sí | Personal Access Token de Figma |
-
-## Estructura del proyecto
-
-```
-mcp-figma/
-├── src/
-│   ├── index.js                  ← Servidor MCP + definición de tools
-│   ├── mcp.js                    ← Protocolo JSON-RPC 2.0 sobre stdio (sin deps)
-│   ├── figma-client.js           ← Cliente HTTP de la API de Figma
-│   ├── design-system-analyzer.js ← Análisis del sistema de diseño local
-│   ├── style-mapper.js           ← Mapeo de estilos Figma ↔ tokens locales
-│   └── component-generator.js   ← Generación de código por framework
-└── package.json                  ← Cero dependencias — solo descriptor
-```
-
-## Limitaciones conocidas
-
-- La detección de tokens en Tailwind usa análisis estático de texto (no ejecuta el módulo), por lo que configs muy dinámicas pueden no detectarse completamente
-- La generación de componentes es un punto de partida — siempre revisa accesibilidad, props faltantes y manejo de estado
-- La API de Figma Variables (tokens del sistema de diseño de Figma) requiere plan Professional o superior

package/mcp-figma/package.json

@@ -1,7 +0,0 @@
-{
-  "name": "sdd-figma-mcp",
-  "version": "1.0.0",
-  "description": "MCP server para integración de Figma con SDD-ES — cero dependencias externas",
-  "type": "module",
-  "main": "src/index.js"
-}

package/mcp-figma/src/component-generator.js

@@ -1,162 +0,0 @@
-// @ts-check
-import { existsSync } from "fs";
-import { join } from "path";
-
-/**
- * @typedef {{ figmaName:string, figmaValue:string, localToken:string|null, matchType:string }} ColorMapping
- * @typedef {{ type:string, color?:{r:number,g:number,b:number}, fills?:any[], children?:any[], name:string, absoluteBoundingBox?:{width:number,height:number}, style?:any }} FigmaNode
- * @typedef {{ stack:{ framework:string, cssApproach:string, hasTokenFile:boolean }, colors:Record<string,string>, spacing:Record<string,string>, typography:{ fontFamilies:string[], fontSizes:Record<string,string>, fontWeights:Record<string,string> }, existingComponents:string[], breakpoints:Record<string,string>, shadows:Record<string,string> }} DesignProfile
- */
-
-/** @param {string} str */
-function toPascalCase(str) {
-  return str.replace(/[^a-zA-Z0-9\s]/g, " ").split(/\s+/).filter(Boolean)
-    .map(w => w[0].toUpperCase() + w.slice(1).toLowerCase()).join("");
-}
-
-/** @param {string} str */
-function toKebabCase(str) {
-  return str.replace(/[^a-zA-Z0-9\s]/g, " ").split(/\s+/).filter(Boolean).join("-").toLowerCase();
-}
-
-/** @param {FigmaNode} node */
-function inferProps(node) {
-  /** @type {Record<string,string>} */
-  const props = {};
-  const name = node.name.toLowerCase();
-  const hasText = (node.children ?? []).some(/** @param {any} c */ c => c.type === "TEXT");
-  if (hasText || /(button|label|title|heading)/.test(name)) props["children"] = "ReactNode";
-  if (/(button|btn|cta|link)/.test(name)) { props["onClick"] = "() => void"; props["disabled"] = "boolean"; }
-  if ((node.children ?? []).some(/** @param {any} c */ c => /(image|img|avatar)/.test(c.name.toLowerCase()))) { props["src"] = "string"; props["alt"] = "string"; }
-  if (/(card|button|badge|chip)/.test(name)) props["variant"] = '"primary" | "secondary" | "ghost"';
-  return props;
-}
-
-/**
- * @param {ColorMapping|null|undefined} mapping
- * @param {string} prefix
- */
-function resolveColorClass(mapping, prefix) {
-  if (!mapping) return "";
-  return mapping.localToken ? `${prefix}-[var(${mapping.localToken})]` : `${prefix}-[${mapping.figmaValue}]`;
-}
-
-/**
- * Construye el bloque CSS usando variables del proyecto o valores hex como fallback.
- * @param {string} selector
- * @param {FigmaNode} node
- * @param {ColorMapping[]} colorMappings
- * @returns {string}
- */
-function buildCSSBlock(selector, node, colorMappings) {
-  const dims = node.absoluteBoundingBox;
-  const lines = [];
-
-  if (dims) {
-    lines.push(`  width: ${Math.round(dims.width)}px;`);
-    lines.push(`  height: ${Math.round(dims.height)}px;`);
-  }
-
-  const bgFill = (node.fills ?? []).find(/** @param {any} f */ f => f.type === "SOLID");
-  if (bgFill?.color) {
-    const hex = `#${Math.round(bgFill.color.r*255).toString(16).padStart(2,"0")}${Math.round(bgFill.color.g*255).toString(16).padStart(2,"0")}${Math.round(bgFill.color.b*255).toString(16).padStart(2,"0")}`;
-    const mapping = colorMappings.find(m => m.figmaValue === hex);
-    lines.push(`  background-color: ${mapping?.localToken ? `var(${mapping.localToken})` : hex};`);
-  }
-
-  const textChild = (node.children ?? []).find(/** @param {any} c */ c => c.type === "TEXT" && c.style);
-  if (textChild?.style) {
-    const s = textChild.style;
-    if (s.fontSize) lines.push(`  font-size: ${s.fontSize}px;`);
-    if (s.fontWeight) lines.push(`  font-weight: ${s.fontWeight};`);
-    if (s.lineHeightPx) lines.push(`  line-height: ${Math.round(s.lineHeightPx)}px;`);
-  }
-
-  if (lines.length === 0) lines.push("  /* estilos del sistema de diseño */");
-
-  return `.${selector} {\n${lines.join("\n")}\n}`;
-}
-
-/**
- * @param {FigmaNode} node
- * @param {string} componentName
- * @param {Record<string,string>} props
- * @param {ColorMapping[]} colorMappings
- * @param {string} cssApproach
- */
-function generateReact(node, componentName, props, colorMappings, cssApproach) {
-  const warnings = [];
-  const dims = node.absoluteBoundingBox;
-  if (!dims) warnings.push("No se pudo leer el bounding box — dimensiones aproximadas.");
-  if (colorMappings.some(m => m.matchType === "new")) warnings.push("Algunos colores de Figma no tienen token equivalente en el proyecto. Se usó el valor hex directo.");
-
-  const hasChildren = "children" in props;
-  const propsStr = Object.entries(props).map(([k,v]) => `${k}${v==="boolean"?"?":""}: ${v}`).join("; ");
-  const propsKeys = Object.keys(props).join(", ") || "className";
-  const cssClass = toKebabCase(componentName);
-
-  /** @type {string|null} */
-  let cssSnippet = null;
-  let code = "";
-
-  if (cssApproach === "tailwind") {
-    const bgFill = (node.fills ?? []).find(/** @param {any} f */ f => f.type === "SOLID");
-    const bgHex = bgFill?.color
-      ? `#${Math.round(bgFill.color.r*255).toString(16).padStart(2,"0")}${Math.round(bgFill.color.g*255).toString(16).padStart(2,"0")}${Math.round(bgFill.color.b*255).toString(16).padStart(2,"0")}`
-      : null;
-    const bgMapping = bgHex ? colorMappings.find(m => m.figmaValue === bgHex) : null;
-    const bgClass = bgMapping ? resolveColorClass(bgMapping, "bg") : "";
-    code = `import React from "react";\n\ninterface ${componentName}Props {\n  ${propsStr || "className?: string"}\n}\n\nexport function ${componentName}({ ${propsKeys} }: ${componentName}Props) {\n  return (\n    <div className="${bgClass} rounded p-4">\n      ${hasChildren ? "{children}" : `{/* contenido de ${node.name} */}`}\n    </div>\n  );\n}\n\nexport default ${componentName};\n`;
-
-  } else if (cssApproach === "css-modules") {
-    code = `import React from "react";\nimport styles from "./${cssClass}.module.css";\n\ninterface ${componentName}Props {\n  ${propsStr || "className?: string"}\n}\n\nexport function ${componentName}({ ${propsKeys} }: ${componentName}Props) {\n  return (\n    <div className={styles.root}>\n      ${hasChildren ? "{children}" : `{/* contenido de ${node.name} */}`}\n    </div>\n  );\n}\n\nexport default ${componentName};\n`;
-    cssSnippet = buildCSSBlock(".root", node, colorMappings);
-
-  } else {
-    // CSS puro — clase global, snippet CSS separado
-    code = `import React from "react";\nimport "./${cssClass}.css";\n\ninterface ${componentName}Props {\n  ${propsStr || "className?: string"}\n}\n\nexport function ${componentName}({ ${propsKeys} }: ${componentName}Props) {\n  return (\n    <div className="${cssClass}">\n      ${hasChildren ? "{children}" : `{/* contenido de ${node.name} */}`}\n    </div>\n  );\n}\n\nexport default ${componentName};\n`;
-    cssSnippet = buildCSSBlock(`.${cssClass}`, node, colorMappings);
-  }
-
-  return { filename: `${componentName}.tsx`, code, warnings, cssSnippet };
-}
-
-/**
- * @param {FigmaNode} node
- * @param {string} componentName
- * @param {Record<string,string>} props
- */
-function generateVue(node, componentName, props) {
-  const propsBlock = Object.entries(props).map(([k,v]) => `${k}?: ${v}`).join("\n  ");
-  const hasChildren = "children" in props;
-  const code = `<template>\n  <div class="root">\n    ${hasChildren ? "<slot />" : `<!-- contenido de ${node.name} -->`}\n  </div>\n</template>\n\n<script setup lang="ts">\ninterface Props {\n  ${propsBlock}\n}\ndefineProps<Props>();\n</script>\n\n<style scoped>\n.root {\n  /* estilos del sistema de diseño */\n}\n</style>\n`;
-  return { filename: `${componentName}.vue`, code, warnings: /** @type {string[]} */ ([]), cssSnippet: /** @type {string|null} */ (null) };
-}
-
-/**
- * @param {FigmaNode} node
- * @param {DesignProfile} profile
- * @param {ColorMapping[]} colorMappings
- */
-function generateComponent(node, profile, colorMappings) {
-  const componentName = toPascalCase(node.name) || "FigmaComponent";
-  const props = inferProps(node);
-  return profile.stack.framework === "vue"
-    ? generateVue(node, componentName, props)
-    : generateReact(node, componentName, props, colorMappings, profile.stack.cssApproach);
-}
-
-/** @param {DesignProfile} profile */
-function suggestImprovements(profile) {
-  const improvements = [];
-  if (Object.keys(profile.colors).length === 0) improvements.push({ priority: "alta", area: "Tokens de color", description: "No se detectaron tokens de color", action: "Define colores como CSS variables o en tailwind.config.js" });
-  if (!profile.stack.hasTokenFile) improvements.push({ priority: "alta", area: "Token file", description: "No existe archivo único de tokens", action: "Crea src/tokens.ts con exports de colores, tipografía y espaciado" });
-  if (profile.existingComponents.length === 0) improvements.push({ priority: "alta", area: "Componentes base", description: "No se encontró librería de componentes", action: "Crea src/components con Button, Input, Card" });
-  if (Object.keys(profile.spacing).length === 0) improvements.push({ priority: "media", area: "Espaciado", description: "No se detectaron tokens de espaciado", action: "Define escala de espaciado (4, 8, 16, 24, 32px)" });
-  if (Object.keys(profile.breakpoints).length === 0) improvements.push({ priority: "media", area: "Breakpoints", description: "No se detectaron breakpoints como tokens", action: "Define breakpoints en tailwind.config.js o custom media queries" });
-  if (profile.typography.fontFamilies.length === 0) improvements.push({ priority: "media", area: "Tipografía", description: "No se detectó fuente declarada como token", action: "Define --font-sans o fontFamily en tailwind.config.js" });
-  if (Object.keys(profile.shadows).length === 0) improvements.push({ priority: "baja", area: "Sombras", description: "No se detectaron tokens de sombra", action: "Define sombras estándar (sm, md, lg)" });
-  return improvements;
-}
-
-export { generateComponent, suggestImprovements };