openprompt-lang 0.11.0 → 1.0.0

package/bin/cli.js

@@ -20,6 +20,11 @@ import { register as registerLearning } from "../src/cli/commands-learning.js"
 import { register as registerOpl } from "../src/cli/commands-opl.js"
 import { register as registerMisc } from "../src/cli/commands-misc.js"
 
+import { handleUncaughtErrors, EXIT_CODES } from "../src/utils/errors.js"
+
+// Global error handler for uncaught exceptions
+handleUncaughtErrors()
+
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"))
 
@@ -62,6 +67,12 @@ registerMisc(program)
 try {
   await program.parseAsync(process.argv)
 } catch (err) {
-  console.error(chalk.red(`✘ Error: ${err.message}`))
-  process.exitCode = 1
+  if (err.exitCode !== undefined) {
+    console.error('\n' + err.userMessage + '\n')
+    process.exitCode = err.exitCode
+  } else {
+    console.error(chalk.red(`\n✘ Error inesperado: ${err.message}\n`))
+    if (process.env.DEBUG) console.error(chalk.gray(err.stack))
+    process.exitCode = EXIT_CODES.GENERIC
+  }
 }

package/bin/opl.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+// @use(kind, contract, limit)
+// @kind(util)
+// @contract(in: argv -> out: exitCode, sideEffect: delega a cli.js con los mismos argumentos)
+// @limit(lines: 30)
+
+// Shortcut: 'opl' → 'openPrompt-Lang'
+// Este archivo permite usar 'opl' como comando corto en vez de 'openPrompt-Lang'
+// Ej: opl validate, opl assess, opl search react
+
+import { fileURLToPath } from 'url'
+import { dirname, join } from 'path'
+import { execFileSync } from 'child_process'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const cliPath = join(__dirname, 'cli.js')
+
+try {
+  const result = execFileSync(process.execPath, [cliPath, ...process.argv.slice(2)], {
+    cwd: process.cwd(),
+    stdio: 'inherit',
+    env: { ...process.env, OPL_ALIAS: '1' }
+  })
+  process.exitCode = result?.status ?? 0
+} catch (err) {
+  process.exitCode = err.status ?? 1
+}

package/docs/FRAMEWORK.md

@@ -6,6 +6,7 @@
 
 ---
 
+
 ## 1. Anotaciones Disponibles
 
 | Tag | Categoría | Descripción |
@@ -24,7 +25,7 @@
 | `@pattern()` | Arquitectura | Patrón de diseño (ver sección 5) |
 | `@test()` | Calidad | Metadata de tests: `@test(coverage: 80)` |
 | `@learn-error` | Calidad | Error aprendido: `@learn-error id=ID fix='...'` |
-| `@scar` | Calidad | Cicatriz de Guerra — error pasado evitable: `@scar(id: string, symptom: string, cause: string, fix: string, severity?: blocker|critical|warning|info, detect?: regex)` |
+| `@scar` | Calidad | Cicatriz de Guerra |
 | `@goodPractice()` | Documentación | Buena práctica |
 | `@badPractice()` | Documentación | Anti-patrón |
 | `@teachMe` | Documentación | Archivo es template de enseñanza |
@@ -95,21 +96,21 @@ Comandos disponibles desde `bin/cli.js` o `npm run opl` o `node bin/cli.js`:
 opl                              # Pantalla de bienvenida "puerta de entrada"
 opl help                         # Misma pantalla de bienvenida
 opl tutorial                     # Recorrido guiado interactivo (7 min)
-opl index [path]                 # Navegar conocimiento por niveles (general → dominio → documento → sistemas)
+opl index [path]                 # Navegar conocimiento por niveles
 opl read <dominio>/<id>          # Leer contenido específico (--chapter n --full)
-opl search <query>               # Búsqueda híbrida (tags + fulltext + semántica + detecta sistema)
-opl system [name]                # Explorar sistemas de conocimiento (capas, patrones, errores)
-opl graph [concept]              # Grafo de relaciones entre conceptos y documentos
-opl assess [path]                # Evaluar Production Readiness Assessment (PRA 0-100)
-opl assess --verbose             # Mostrar 7 dimensiones × 28 criterios detallados
-opl assess --save                # Guardar reporte JSON en el proyecto
-opl init --knowledge             # Configurar biblioteca personal ~/.opl/knowledge/
-opl session doc/close/diff       # Gestión de sesiones con documentación obligatoria
-opl doc flow/framework           # Generar documentación (Mermaid, FRAMEWORK.md)
-opl upgrade                      # Migrar configuración a versión actual
-opl contract list                # Listar contratos abstractos (IR)
+opl search <query>               # Búsqueda híbrida
+opl system [name]                # Explorar sistemas de conocimiento
+opl graph [concept]              # Grafo de relaciones
+opl assess [path]                # Evaluar PRA 0-100
+opl assess --verbose             # 7 dimensiones × 28 criterios
+opl assess --save                # Guardar reporte JSON
+opl init --knowledge             # Configurar biblioteca personal
+opl session doc/close/diff       # Gestión de sesiones
+opl doc flow/framework           # Generar documentación
+opl upgrade                      # Migrar configuración
+opl contract list                # Listar contratos abstractos
 opl contract show <id>           # Mostrar detalle de contrato
-opl contract search <query>      # Buscar contratos por nombre/tags
+opl contract search <query>      # Buscar contratos
 ```
 
 ## 8. Production Readiness Assessment (PRA)
@@ -243,8 +244,7 @@ npx openPrompt-Lang mcp
 - **SIEMPRE** revisar @scar vinculados en contratos abstractos antes de implementar
 - **SIEMPRE** declarar `@use()` al inicio de archivos anotados
 - **SIEMPRE** ejecutar `npx openPrompt-Lang validate` antes de cada commit
-- **SIEMPRE** documentar errores en proyectos reales en `ERRORES-Y-HALLAZGOS.md` (sin modificar código)
-- **PRA zero-tolerance**: F5 (transacciones atómicas), S2 (deny-by-default), S4 (no hardcoded secrets)
+- **PRA zero-tolerance**: F5, S2, S4
 - **Sistemas de conocimiento**: usar `opl system` antes de implementar features complejas
 - Preferir `export function Name() {}` sobre arrow functions para componentes
 - Preferir Named Exports sobre Default Exports
@@ -255,7 +255,7 @@ npx openPrompt-Lang mcp
 
 La IA dispone de **36 fuentes de conocimiento** organizadas en 13 dominios (incluyendo 2 proyectos reales extraídos).
 
-El conocimiento se agrupa en **sistemas** — conjuntos de fuentes que se necesitan juntas para construir algo real (app fullstack, pasarela de pagos, microservicios, POS, etc.).
+El conocimiento se agrupa en **sistemas** — conjuntos de fuentes que se necesitan juntas para construir algo real.
 Explorar: `opl system list` para ver los 10 sistemas disponibles.
 
 ### Dominios
@@ -337,8 +337,6 @@ Explorar: `opl system list` para ver los 10 sistemas disponibles.
 
 ### Sistemas de Conocimiento
 
-Sistemas agrupados por contexto de construcción (capas, patrones, errores comunes):
-
 | Sistema | Capas | Fuentes |
 |---------|-------|---------|
 | react-fullstack-app | frontend, backend, auth, db, deploy | 7+ |
@@ -352,8 +350,6 @@ Sistemas agrupados por contexto de construcción (capas, patrones, errores comun
 | microservicios-multi-lenguaje | gateway, java, node, python, monitor | 7+ |
 | saas-pos-chileno | saas, multitenant, pos, billing, compliance | 7+ |
 
-Explorar: `opl system [nombre]` — ver capas, patrones y errores documentados.
-
 ### Contratos Abstractos
 
 IR de componentes que separa **Contrato (esencia)** de **Sintaxis (framework)**:
@@ -372,7 +368,7 @@ Los contratos se almacenan en `knowledge-repo/abstract-contracts/` con schema en
 
 ### Cicatrices de Guerra (@scar)
 
-Anotación para **conocimiento negativo** — registrar lo que salió mal para que no se repita:
+Anotación para **conocimiento negativo**:
 
 ```typescript
 // @scar(
@@ -387,8 +383,6 @@ Anotación para **conocimiento negativo** — registrar lo que salió mal para q
 
 Campos: `id` (req), `symptom` (req), `cause` (req), `fix` (req), `detect` (opcional, regex), `severity` (opcional).
 
-Integración PRA: @scar con severity=blocker penaliza el score de calidad. @scar no resueltos reducen F3.
-
 ### Pipeline Auto-curativo
 
 El paso [4/5] de validate ejecuta un loop de auto-corrección:
@@ -438,55 +432,9 @@ knowledge_concept → { bookId, conceptSlug? }
 ## 14. Stack del Proyecto
 
 - **Lenguaje:** node
-- **Stack:** node, javascript, esm, commander
+- **Stack base:** node, javascript, esm, commander
 - **Extensiones:** vitest, eslint, inquirer, chalk, pdf-parse
 - **Perfil:** senior
-
-## 15. Flujo de Trabajo Recomendado
-
-### Para desarrollo con MCP (ahorra tiempo)
-
-```
-analyze_project → context_unified → knowledge_search/recall → work_context_plan → work_context_start → implementar → validate → work_context_close
-```
-
-1. **analyze_project** — Auditoría inicial del proyecto (30s, ahorra ~15min)
-2. **context_unified** — Búsqueda cruzada en 7 fuentes (10s, ahorra ~20min)
-3. **knowledge_search** o **recall** — Buscar antes de crear (10s, ahorra ~30min)
-4. **work_context_plan** — Planificar antes de implementar (1min, ahorra ~1hr)
-5. **work_context_start** — Iniciar sesión con tracking
-6. **implementar** — Escribir código siguiendo anotaciones
-7. **validate** — Verificar anotaciones antes de commit
-8. **work_context_close** — Cerrar sesión y registrar métricas
-
-### Para evaluación de producción (PRA)
-
-```
-opl assess --verbose  →  opl assess --save  →  revisar PRA-ASSESSMENT.json
-```
-
-1. **opl assess --verbose** — Ver 7 dimensiones × 28 criterios
-2. **opl assess --save** — Guardar reporte JSON en el proyecto
-3. **Revisar zero-tolerance** — F5, S2, S4 deben estar en verde
-4. **Priorizar mejoras** — Empezar por dimensiones con menor score
-
-### Para QA completo (workflow integrado)
-
-```
-opl assess --save && npx openPrompt-Lang validate && recall "errores"
-```
-
-### Para validación de anotaciones
-
-```
-validate → lint_file → qa-gen → validate
-```
-
-1. **validate** — Verificar anotaciones antes de cambios
-2. **lint_file** — Lint detallado del archivo modificado
-3. **qa-gen** — Generar tests desde errores aprendidos
-4. **validate** — Validación final antes de commit
-
----
-
-*Generado automáticamente por openPrompt-Lang v0.10.1 — 2026-05-21*
+- **Modo oscuro:** por defecto
+- **Testing:** Vitest
+- **Linting:** ESLint + Prettier

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "openprompt-lang",
-  "version": "0.11.0",
+  "version": "1.0.0",
   "description": "PromptLang CLI — Context Engine de anotaciones para desarrollo asistido por IA",
   "type": "module",
   "main": "./bin/cli.js",
   "bin": {
     "openPrompt-Lang": "./bin/cli.js",
     "openprompt-lang": "./bin/cli.js",
+    "opl": "./bin/opl.js",
     "openprompt-create": "./bin/create.js"
   },
   "files": [

package/src/ai/providers.js

@@ -1,4 +1,7 @@
-// @use(generated, kind, props, limit, test)
+// @use(kind, contract, limit, generated)
+// @kind(feature)
+// @contract(in: provider name + prompt -> out: generated text, sideEffect: llama API externa)
+// @limit(lines: 260)
 // ─── AI Provider abstraction for openPrompt-Lang ────────────────────────────
 // Each provider must implement: generate(prompt, options) => Promise<string>
 

package/src/cli/commands-init.js

@@ -1,15 +1,16 @@
 // @use(commander, kind, contract, limit)
-// @kind(util)
-// @contract(in: program -> out: void, sideEffect: registra comandos init/wizard/figma/suggest)
-// @limit(lines: 80)
+// @kind(feature)
+// @contract(in: program -> out: void, sideEffect: registra comandos init)
+// @limit(lines: 70)
 
 export function register(program) {
-  program
+  const init = program
     .command('init')
     .description('Inicializar proyecto o biblioteca de conocimiento personal')
     .option('--name <name>', 'Nombre del proyecto')
     .option('--describe <text>', 'Descripción del proyecto para sugerencia IA')
     .option('--existing', 'Configurar en proyecto existente (solo archivos de configuración)')
+    .option('--rebuild', 'Reconstruir integración OPL en proyecto existente (force-regenera archivos generados, aplica migraciones)')
     .option('--knowledge', 'Configurar biblioteca de conocimiento personal (~/.opl/knowledge/)')
     .option('--dry-run', 'Previsualizar sin crear archivos')
     .option('--stack <items>', 'Stack base (separado por comas, ej: react,typescript,vite,tailwind)')

package/src/cli/commands-misc.js

@@ -1,7 +1,7 @@
 // @use(commander, kind, contract, limit)
 // @kind(util)
 // @contract(in: program -> out: void, sideEffect: registra comandos misceláneos)
-// @limit(lines: 200)
+// @limit(lines: 270)
 
 export function register(program) {
   const component = program
@@ -249,4 +249,14 @@ export function register(program) {
       const { recall } = await import('../commands/recall.js')
       await recall(query, options)
     })
+
+  program
+    .command('rebuild')
+    .description('Reconstruir integración OPL en proyecto existente (force-regenera archivos, aplica migraciones)')
+    .option('--dir <path>', 'Directorio del proyecto (default: cwd)')
+    .option('--yes', 'Auto-aceptar migraciones y prompts')
+    .action(async (options) => {
+      const { initExisting } = await import('../commands/init-existing.js')
+      await initExisting({ rebuild: true, dir: options.dir || process.cwd() })
+    })
 }

package/src/cli/commands-opl.js

@@ -1,7 +1,7 @@
 // @use(commander, kind, contract, limit)
 // @kind(util)
 // @contract(in: program -> out: void, sideEffect: registra todos los comandos OPL)
-// @limit(lines: 200)
+// @limit(lines: 280)
 
 import chalk from 'chalk'
 

package/src/commands/component.js

@@ -1,7 +1,7 @@
 // @use(kind, contract, limit)
 // @kind(util)
 // @contract(in: args -> out: void, sideEffect: gestión de componentes)
-// @limit(lines: 200)
+// @limit(lines: 450)
 import {
   readFileSync,
   writeFileSync,

package/src/commands/db-rules.js

@@ -1,7 +1,7 @@
 // @use(kind, contract, limit)
 // @kind(util)
 // @contract(in: args -> out: void, sideEffect: muestra reglas de DB)
-// @limit(lines: 100)
+// @limit(lines: 130)
 import { readFileSync, existsSync } from 'fs'
 import { join, dirname } from 'path'
 import { fileURLToPath } from 'url'

package/src/commands/init-core.js

@@ -1,7 +1,7 @@
 // @use(kind, contract, limit)
 // @kind(feature)
 // @contract(in: options -> out: baseDir)
-// @limit(lines: 300)
+// @limit(lines: 430)
 
 import { writeFileSync, readFileSync, existsSync, mkdirSync, cpSync } from 'fs'
 import { join, dirname } from 'path'
@@ -138,10 +138,10 @@ export async function init(options) {
       ]
     }])
 
-    if (projectType === 'existing') return initExisting()
+    if (projectType === 'existing') return initExisting(options)
   }
 
-  if (options.existing) return initExisting()
+  if (options.existing) return initExisting(options)
 
   const baseDir = join(process.cwd(), (options.name || 'mi-proyecto'))
 

package/src/commands/init-existing.js

@@ -1,7 +1,7 @@
 // @use(kind, contract, limit)
 // @kind(feature)
 // @contract(in: options -> out: cwd)
-// @limit(lines: 300)
+// @limit(lines: 450)
 
 import { writeFileSync, readFileSync, existsSync, mkdirSync, readdirSync, statSync } from 'fs'
 import { join } from 'path'
@@ -98,13 +98,18 @@ function auditProject(cwd) {
   return results
 }
 
-export async function initExisting() {
-  const cwd = process.cwd()
+export async function initExisting(options = {}) {
+  const cwd = options.dir || process.cwd()
+  const rebuild = options.rebuild || false
   const projectName = existsSync(join(cwd, 'package.json'))
     ? JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf-8')).name || 'mi-proyecto'
     : 'mi-proyecto'
 
-  console.log(chalk.cyan(`\n🔧 Configurando openPrompt-Lang en proyecto existente: ${projectName}\n`))
+  if (rebuild) {
+    console.log(chalk.cyan(`\n🔧 Reconstruyendo integración OPL en: ${projectName}\n`))
+  } else {
+    console.log(chalk.cyan(`\n🔧 Configurando openPrompt-Lang en proyecto existente: ${projectName}\n`))
+  }
 
   const stack = enhancedDetectStack(cwd)
   const detected = Object.entries(stack)
@@ -148,16 +153,31 @@ export async function initExisting() {
     extractor: { ignore: ['.env', '*.local', 'dist', 'node_modules'], output: 'contexto.md' }
   }
 
-  if (existsSync(join(cwd, 'prompt-lang.json'))) {
-    console.log(chalk.yellow('  ⚠️  prompt-lang.json ya existe. Saltando.'))
+  // Add OPL version tracking
+  try {
+    const pkgPath = new URL('../../package.json', import.meta.url).pathname
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))
+    config.oplVersion = pkg.version
+  } catch {}
+
+  const configPath = join(cwd, 'prompt-lang.json')
+  if (rebuild || !existsSync(configPath)) {
+    // Merge with existing config if rebuilding (preserve user fields)
+    if (rebuild && existsSync(configPath)) {
+      try {
+        const existing = JSON.parse(readFileSync(configPath, 'utf-8'))
+        // Preserve user customizations, merge new defaults
+        Object.assign(config, existing, { oplVersion: config.oplVersion })
+      } catch {}
+    }
+    writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8')
+    console.log(chalk.green(`  ✅ prompt-lang.json ${rebuild ? 'actualizado' : 'creado'}`))
   } else {
-    writeFileSync(join(cwd, 'prompt-lang.json'), JSON.stringify(config, null, 2), 'utf-8')
-    console.log(chalk.green('  ✅ prompt-lang.json'))
+    console.log(chalk.yellow('  ⚠️  prompt-lang.json ya existe. Saltando.'))
   }
 
-  if (existsSync(join(cwd, 'AGENTS.md'))) {
-    console.log(chalk.yellow('  ⚠️  AGENTS.md ya existe. Saltando.'))
-  } else {
+  const agentsPath = join(cwd, 'AGENTS.md')
+  if (rebuild || !existsSync(agentsPath)) {
     const agentsLines = [
       '# AGENTS.md — Contexto para IA',
       '',
@@ -177,26 +197,24 @@ export async function initExisting() {
       '- Framework: openPrompt-Lang',
       '',
     ]
-    writeFileSync(join(cwd, 'AGENTS.md'), agentsLines.join('\n'), 'utf-8')
-    console.log(chalk.green('  ✅ AGENTS.md'))
+    writeFileSync(agentsPath, agentsLines.join('\n'), 'utf-8')
+    console.log(chalk.green(`  ✅ AGENTS.md ${rebuild ? 'actualizado' : 'creado'}`))
+  } else {
+    console.log(chalk.yellow('  ⚠️  AGENTS.md ya existe. Saltando.'))
   }
 
   mkdirSync(join(cwd, '.openprompt'), { recursive: true })
   const frameworkPath = join(cwd, '.openprompt', 'FRAMEWORK.md')
-  if (!existsSync(frameworkPath)) {
+  if (rebuild || !existsSync(frameworkPath)) {
     writeFileSync(frameworkPath, generateFrameworkMd({ dir: cwd }), 'utf-8')
-    console.log(chalk.green('  ✅ .openprompt/FRAMEWORK.md'))
+    console.log(chalk.green(`  ✅ .openprompt/FRAMEWORK.md ${rebuild ? 'actualizado' : 'creado'}`))
+  } else {
+    console.log(chalk.yellow('  ⚠️  .openprompt/FRAMEWORK.md ya existe. Saltando.'))
   }
 
   if (existsSync(join(cwd, 'package.json'))) {
-    const { addScripts } = await inquirer.prompt([{
-      type: 'confirm',
-      name: 'addScripts',
-      message: '¿Agregar scripts descriptivos al package.json?',
-      default: false
-    }])
-
-    if (addScripts) {
+    if (rebuild) {
+      // Always add scripts in rebuild mode
       const pkgPath = join(cwd, 'package.json')
       const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))
       pkg.scripts = pkg.scripts || {}
@@ -206,32 +224,106 @@ export async function initExisting() {
       }
       if (added > 0) {
         writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf-8')
-        console.log(chalk.green(`  ✅ ${added} scripts agregados`))
+        console.log(chalk.green(`  ✅ ${added} scripts descriptivos agregados`))
+      }
+    } else {
+      const { addScripts } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'addScripts',
+        message: '¿Agregar scripts descriptivos al package.json?',
+        default: false
+      }])
+
+      if (addScripts) {
+        const pkgPath = join(cwd, 'package.json')
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))
+        pkg.scripts = pkg.scripts || {}
+        let added = 0
+        for (const [name, cmd] of Object.entries(DESCRIPTIVE_SCRIPTS)) {
+          if (!pkg.scripts[name]) { pkg.scripts[name] = cmd; added++ }
+        }
+        if (added > 0) {
+          writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf-8')
+          console.log(chalk.green(`  ✅ ${added} scripts agregados`))
+        }
       }
     }
   }
 
-  const { createDocs } = await inquirer.prompt([{
-    type: 'confirm',
-    name: 'createDocs',
-    message: '¿Crear estructura docs/ (BACKLOG, COMMITS, LOGS)?',
-    default: false
-  }])
+  if (!rebuild) {
+    const { createDocs } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'createDocs',
+      message: '¿Crear estructura docs/ (BACKLOG, COMMITS, LOGS)?',
+      default: false
+    }])
+
+    if (createDocs) {
+      for (const dir of ['docs/BACKLOG', 'docs/PHASES', 'docs/COMMITS', 'docs/LOGS/ERRORES', 'docs/LOGS/ACTIVIDAD']) {
+        mkdirSync(join(cwd, dir), { recursive: true })
+      }
+      if (!existsSync(join(cwd, 'docs/BACKLOG/tasks.md'))) {
+        writeFileSync(join(cwd, 'docs/BACKLOG/tasks.md'), '# Backlog — Tareas\n\n## TASK-001\n- **Módulo:** \n- **Criterios:**\n  - [ ] \n', 'utf-8')
+      }
+      if (!existsSync(join(cwd, 'docs/PHASES/roadmap.md'))) {
+        writeFileSync(join(cwd, 'docs/PHASES/roadmap.md'), '# Fases\n\n## Fase 1\n**Estado:** Actual\n**Objetivo:** _definir_\n', 'utf-8')
+      }
+      if (!existsSync(join(cwd, 'docs/COMMITS/INDEX.md'))) {
+        writeFileSync(join(cwd, 'docs/COMMITS/INDEX.md'), '# Índice de Commits\n\n| Fecha | Versión | Descripción |\n|---|---|---|\n', 'utf-8')
+      }
+      console.log(chalk.green('  ✅ Estructura docs/'))
+    }
+  }
 
-  if (createDocs) {
-    for (const dir of ['docs/BACKLOG', 'docs/PHASES', 'docs/COMMITS', 'docs/LOGS/ERRORES', 'docs/LOGS/ACTIVIDAD']) {
-      mkdirSync(join(cwd, dir), { recursive: true })
+  if (rebuild) {
+    // Rebuild mode: always set up build plugins
+    const viteConfig = ['vite.config.ts', 'vite.config.js', 'vite.config.mjs'].find(f => existsSync(join(cwd, f)))
+    if (viteConfig) {
+      const vitePath = join(cwd, viteConfig)
+      const existing = readFileSync(vitePath, 'utf-8')
+      if (!existing.includes('openPromptAnnotations')) {
+        const finalContent = `import { openPromptAnnotations } from "openprompt-lang/vite-plugin";\n${existing.replace(/plugins\s*:\s*\[/, 'plugins: [\n    openPromptAnnotations(),')}`
+        writeFileSync(vitePath, finalContent, 'utf-8')
+        console.log(chalk.green(`  ✅ Plugin Vite agregado a ${viteConfig}`))
+      }
     }
-    if (!existsSync(join(cwd, 'docs/BACKLOG/tasks.md'))) {
-      writeFileSync(join(cwd, 'docs/BACKLOG/tasks.md'), '# Backlog — Tareas\n\n## TASK-001\n- **Módulo:** \n- **Criterios:**\n  - [ ] \n', 'utf-8')
+
+    const tsconfig = ['tsconfig.json', 'tsconfig.app.json'].find(f => existsSync(join(cwd, f)))
+    if (tsconfig) {
+      const tsPath = join(cwd, tsconfig)
+      const tsConfig = JSON.parse(readFileSync(tsPath, 'utf-8'))
+      tsConfig.compilerOptions = tsConfig.compilerOptions || {}
+      tsConfig.compilerOptions.plugins = tsConfig.compilerOptions.plugins || []
+      if (!tsConfig.compilerOptions.plugins.some(p => p.name?.includes('openprompt'))) {
+        tsConfig.compilerOptions.plugins.push({ name: 'openprompt-lang/ts-plugin' })
+        writeFileSync(tsPath, `${JSON.stringify(tsConfig, null, 2)}\n`, 'utf-8')
+        console.log(chalk.green(`  ✅ TS plugin agregado a ${tsconfig}`))
+      }
     }
-    if (!existsSync(join(cwd, 'docs/PHASES/roadmap.md'))) {
-      writeFileSync(join(cwd, 'docs/PHASES/roadmap.md'), '# Fases\n\n## Fase 1\n**Estado:** Actual\n**Objetivo:** _definir_\n', 'utf-8')
+
+    // Rebuild mode: always integrate all editors
+    try {
+      const { integrate } = await import('./integrate.js')
+      console.log(chalk.cyan('\n🔄 Reconstruyendo integración de editores...'))
+      await integrate({ dir: cwd, all: true, silent: true })
+    } catch {
+      console.log(chalk.yellow('  ⚠️  No se pudo ejecutar integrate automáticamente.'))
     }
-    if (!existsSync(join(cwd, 'docs/COMMITS/INDEX.md'))) {
-      writeFileSync(join(cwd, 'docs/COMMITS/INDEX.md'), '# Índice de Commits\n\n| Fecha | Versión | Descripción |\n|---|---|---|\n', 'utf-8')
+
+    // Apply pending migrations (upgrade)
+    try {
+      const { upgrade } = await import('./opl-upgrade.js')
+      console.log(chalk.cyan('🔄 Aplicando migraciones pendientes...'))
+      await upgrade({ dir: cwd, yes: true })
+    } catch {
+      console.log(chalk.yellow('  ⚠️  No se pudo ejecutar upgrade automáticamente.'))
     }
-    console.log(chalk.green('  ✅ Estructura docs/'))
+
+    console.log(chalk.cyan(`\n✅ Integración OLP reconstruida para: ${projectName}`))
+    console.log(chalk.cyan(`   Versión OPL: ${config.oplVersion || 'desconocida'}`))
+    console.log(chalk.gray('   Archivos generados forzaron actualización.'))
+    console.log(chalk.gray('   Las personalizaciones del usuario fueron preservadas en prompt-lang.json.\n'))
+    return
   }
 
   const { setupBuild } = await inquirer.prompt([{

package/src/commands/init-helpers.js

@@ -1,7 +1,7 @@
 // @use(kind, contract, limit)
 // @kind(feature)
 // @contract(in: options -> out: baseDir)
-// @limit(lines: 300)
+// @limit(lines: 430)
 
 import { writeFileSync, existsSync, mkdirSync, readdirSync } from 'fs'
 import { join } from 'path'

package/src/commands/integrate.js

@@ -1,4 +1,7 @@
 // @use(kind, contract, limit, learn-error, generated)
+// @kind(feature)
+// @contract(in: options -> out: void, sideEffect: genera archivos de integración en el proyecto)
+// @limit(lines: 700)
 import { writeFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from 'fs'
 import { join, relative } from 'path'
 import os from 'os'

package/src/commands/learning.js

@@ -1,7 +1,7 @@
 // @use(kind, contract, limit)
 // @kind(util)
 // @contract(in: args -> out: void, sideEffect: gestión de aprendizaje semántico)
-// @limit(lines: 200)
+// @limit(lines: 500)
 import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, statSync } from 'fs'
 import { join, relative, dirname, isAbsolute } from 'path'
 import chalk from 'chalk'