openprompt-lang 0.4.0 → 0.5.0

package/README.md

@@ -11,6 +11,14 @@ openPrompt-Lang --version
 ## Índice
 
 - [Instalación](#instalación)
+- [Nuevas Capacidades (v0.4.0)](#nuevas-capacidades-v040)
+  - [Aprender de proyectos reales](#aprender-de-proyectos-reales---extract---learn)
+  - [Aprender de documentación](#aprender-de-documentación---learn)
+  - [Transferencia de contexto](#transferencia-de-contexto---integrate---fromto)
+  - [Contexto por dominio](#contexto-por-dominio---context---domain)
+  - [Presets pre-ensamblados](#presets-pre-ensamblados---init---preset)
+  - [Reglas de base de datos](#reglas-de-base-de-datos---db-rules)
+  - [Filtros de componentes](#filtros-de-componentes---component-list---styletechvalidated)
 - [Anotaciones PromptLang (directorio completo)](#anotaciones-promptlang-directorio-completo)
   - [Tags de definición](#tags-de-definición)
   - [Tags de contrato](#tags-de-contrato)
@@ -406,6 +414,68 @@ export function Button(props: ButtonProps) { ... }
 
 ---
 
+## Nuevas Capacidades (v0.4.0)
+
+### Aprender de proyectos reales — `extract --learn`
+Analiza un proyecto y extrae sus patrones: convención de nombres, arquitectura, estilo UI, hooks, anotaciones. Genera un perfil reutilizable.
+
+```bash
+openPrompt-Lang extract ./proyecto-pulido --learn
+openPrompt-Lang init --name nuevo --learn-from ./aprendizaje-perfil.json
+```
+
+### Aprender de documentación — `learn`
+Usa IA para transformar documentación local en módulos de lenguaje funcionales con templates, tests y prácticas.
+
+```bash
+openPrompt-Lang learn --docs ./docs-rust/ --name rust
+openPrompt-Lang learn --docs ./docs-react/ --from ./proyecto-real/ --name react
+openPrompt-Lang learn --docs ./docs/ --name django --integrate
+```
+
+Los módulos se guardan en `~/.openprompt/knowledge/langs/<id>/` (accesibles para cualquier proyecto).
+
+### Transferencia de contexto — `integrate --from/--to`
+Copia el contexto de negocio entre proyectos: stack, convenciones, @kind/@contract detectados, arquitectura.
+
+```bash
+openPrompt-Lang integrate --from ./web-react --to ./app-mobile
+```
+
+### Contexto por dominio — `context --domain`
+Filtra el contexto del proyecto por dominio de negocio: ecommerce, saas, mobile, api, admin, blog.
+
+```bash
+openPrompt-Lang context --domain ecommerce
+```
+
+### Presets pre-ensamblados — `init --preset`
+Stacks completos con servicios incluidos: Supabase, Stripe, Ionic, Tauri, Firebase.
+
+```bash
+openPrompt-Lang init --preset react-supabase-stripe --name tienda
+openPrompt-Lang init --list-presets
+```
+
+### Reglas de base de datos — `db-rules`
+Knowledge base de buenas prácticas, anti-patrones y reglas para SQL, Supabase, Postgres, Docker.
+
+```bash
+openPrompt-Lang db-rules --id db-001
+openPrompt-Lang db-rules --tag performance
+```
+
+### Filtros de componentes — `component list --style/--tech/--validated`
+```bash
+openPrompt-Lang component list --style shadcn
+openPrompt-Lang component list --tech vue
+openPrompt-Lang component list --validated
+```
+
+> 📖 **Manual completo para IA:** `docs/AI-MANUAL.md` — todos los comandos, workflows ordenados y configuración.
+
+---
+
 ## Comandos CLI
 
 | Comando | Descripción |

package/bin/cli.js

@@ -1,301 +1,379 @@
 #!/usr/bin/env node
 
-import { Command } from "commander"
-import chalk from "chalk"
-import { readFileSync, existsSync } from "fs"
-import { join, dirname } from "path"
-import { fileURLToPath } from "url"
+import { Command } from 'commander'
+import chalk from 'chalk'
+import { readFileSync, existsSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
-const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"))
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'))
 
 const program = new Command()
 
 program
-  .name("openPrompt-Lang")
-  .description(chalk.cyan("Framework de anotaciones para desarrollo asistido por IA"))
+  .name('openPrompt-Lang')
+  .description(chalk.cyan('Framework de anotaciones para desarrollo asistido por IA'))
   .version(pkg.version)
 
 program
-  .command("init")
-  .description("Inicializar proyecto con estructura PromptLang")
-  .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)")
+  .command('init')
+  .description('Inicializar proyecto con estructura PromptLang')
+  .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('--dry-run', 'Previsualizar sin crear archivos')
+  .option('--stack <items>', 'Stack base (separado por comas, ej: react,typescript,vite,tailwind)')
+  .option('--preset <name>', 'Usar preset pre-ensamblado (ej: react-supabase-stripe, vue-firebase-netlify)')
+  .option('--list-presets', 'Listar presets disponibles y salir')
+  .option('--list-stacks', 'Listar stacks disponibles y salir')
+  .option('--learn-from <file>', 'Ruta a perfil de aprendizaje (aprendizaje-perfil.json) para heredar patrones')
+  .option('--no-interactive', 'Saltar preguntas interactivas y usar defaults')
   .action(async (options) => {
-    const { init } = await import("../src/commands/init.js")
+    if (options.listStacks) {
+      const { listStacks } = await import('../src/commands/init.js')
+      await listStacks()
+      return
+    }
+    if (options.listPresets) {
+      const { listPresets } = await import('../src/commands/init.js')
+      await listPresets()
+      return
+    }
+    const { init } = await import('../src/commands/init.js')
     await init(options)
   })
 
 program
-  .command("figma")
-  .description("Generar prompt para diseño en Figma con convenciones React + Tailwind")
+  .command('figma')
+  .description('Generar prompt para diseño en Figma con convenciones React + Tailwind')
   .action(async () => {
-    const { figma } = await import("../src/commands/figma.js")
+    const { figma } = await import('../src/commands/figma.js')
     await figma()
   })
 
 program
-  .command("context")
-  .description("Extraer contexto del proyecto para la IA")
-  .option("--output <file>", "Archivo de salida", "contexto.md")
-  .option("--scope <module>", "Filtrar por módulo (@scope)")
-  .option("--no-ai", "No incluir anotaciones PromptLang en el output")
+  .command('context')
+  .description('Extraer contexto del proyecto para la IA')
+  .option('--output <file>', 'Archivo de salida', 'contexto.md')
+  .option('--scope <module>', 'Filtrar por módulo (@scope)')
+  .option('--no-ai', 'No incluir anotaciones PromptLang en el output')
+  .option('--mode <mode>', 'Modo de extracción: raw (solo archivos), index (solo índice), full (ambos)', 'full')
+  .option('--query <text>', 'Consulta semántica para sugerencias de componentes/patrones')
+  .option('--domain <domain>', 'Filtrar por dominio de negocio (ecommerce, saas, mobile, api, admin, blog)')
+  .option('--projects <list>', 'Proyectos vecinos a referenciar (separados por coma)')
+  .option('--dir <path>', 'Directorio base del proyecto (default: cwd)')
   .action(async (options) => {
-    const { context } = await import("../src/commands/context.js")
+    const { context } = await import('../src/commands/context.js')
     await context(options)
   })
 
 program
-  .command("validate")
-  .description("Ejecutar pipeline de validación y verificar anotaciones")
-  .option("--fix", "Auto-corregir errores cuando sea posible")
+  .command('validate')
+  .description('Ejecutar pipeline de validación y verificar anotaciones')
+  .option('--fix', 'Auto-corregir errores cuando sea posible')
   .action(async (options) => {
-    const { validate } = await import("../src/commands/validate.js")
+    const { validate } = await import('../src/commands/validate.js')
     await validate(options)
   })
 
 program
-  .command("suggest")
-  .description("IA sugiere estructura/stack según descripción del proyecto")
-  .argument("<description>", "Descripción del proyecto")
+  .command('suggest')
+  .description('IA sugiere estructura/stack según descripción del proyecto')
+  .argument('<description>', 'Descripción del proyecto')
   .action(async (description) => {
-    const { suggest } = await import("../src/commands/suggest.js")
+    const { suggest } = await import('../src/commands/suggest.js')
     await suggest(description)
   })
 
 const component = program
-  .command("component")
-  .description("Gestionar biblioteca de componentes reutilizables")
+  .command('component')
+  .description('Gestionar biblioteca de componentes reutilizables')
 
 component
-  .command("list")
-  .description("Listar componentes disponibles")
-  .option("--library <path>", "Ruta a la biblioteca de componentes")
+  .command('list')
+  .description('Listar componentes disponibles')
+  .option('--library <path>', 'Ruta a la biblioteca de componentes')
+  .option('--style <style>', 'Filtrar por estilo UI (shadcn, mantine, chakra, headless, mui)')
+  .option('--tech <tech>', 'Filtrar por tecnología (react, vue, angular)')
+  .option('--validated', 'Mostrar solo componentes validados/aprendidos')
   .action(async (options) => {
-    const { componentList } = await import("../src/commands/component.js")
+    const { componentList } = await import('../src/commands/component.js')
     await componentList(options)
   })
 
 component
-  .command("add <name>")
-  .description("Agregar componente desde biblioteca o template del módulo de lenguaje")
-  .option("--library <path>", "Ruta a la biblioteca de componentes")
-  .option("--template", "Usar template del módulo de lenguaje (INDEX.json)")
-  .option("--lang <lang>", "Lenguaje del template (default: de prompt-lang.json)")
-  .option("--variants <list>", "Variantes a incluir (separadas por coma)")
-  .option("--output <name>", "Nombre del archivo de salida (sin extensión)")
-  .option("--force", "Sobrescribir archivo existente")
+  .command('add <name>')
+  .description('Agregar componente desde biblioteca o template del módulo de lenguaje')
+  .option('--library <path>', 'Ruta a la biblioteca de componentes')
+  .option('--template', 'Usar template del módulo de lenguaje (INDEX.json)')
+  .option('--lang <lang>', 'Lenguaje del template (default: de prompt-lang.json)')
+  .option('--variants <list>', 'Variantes a incluir (separadas por coma)')
+  .option('--output <name>', 'Nombre del archivo de salida (sin extensión)')
+  .option('--force', 'Sobrescribir archivo existente')
+  .option('--save', 'Marcar componente como validado/aprendido')
   .action(async (name, options) => {
-    const { componentAdd } = await import("../src/commands/component.js")
+    const { componentAdd } = await import('../src/commands/component.js')
     await componentAdd(name, options)
   })
 
 component
-  .command("init")
-  .description("Inicializar una biblioteca de componentes")
-  .option("--library <path>", "Ruta donde crear la biblioteca")
-  .option("--name <name>", "Nombre de la biblioteca")
+  .command('init')
+  .description('Inicializar una biblioteca de componentes')
+  .option('--library <path>', 'Ruta donde crear la biblioteca')
+  .option('--name <name>', 'Nombre de la biblioteca')
   .action(async (options) => {
-    const { componentInit } = await import("../src/commands/component.js")
+    const { componentInit } = await import('../src/commands/component.js')
     await componentInit(options)
   })
 
 component
-  .command("manifest")
-  .description("Mostrar el manifiesto de la biblioteca de componentes")
-  .option("--library <path>", "Ruta a la biblioteca de componentes")
+  .command('manifest')
+  .description('Mostrar el manifiesto de la biblioteca de componentes')
+  .option('--library <path>', 'Ruta a la biblioteca de componentes')
   .action(async (options) => {
-    const { componentManifest } = await import("../src/commands/component.js")
+    const { componentManifest } = await import('../src/commands/component.js')
     await componentManifest(options)
   })
 
 // ─── Wizard command ──────────────────────────────────────────────────────────
 
 program
-  .command("wizard")
-  .description("Asistente interactivo para configurar proyecto openPrompt-Lang")
+  .command('wizard')
+  .description('Asistente interactivo para configurar proyecto openPrompt-Lang')
   .action(async () => {
-    const { wizard } = await import("../src/commands/wizard.js")
+    const { wizard } = await import('../src/commands/wizard.js')
     await wizard()
   })
 
 // ─── Teach command ───────────────────────────────────────────────────────────
 
 program
-  .command("teach <templateId>")
-  .description("Enseñanza estructurada desde template con @teachMe")
-  .option("--lang <lang>", "Lenguaje del template (default: react)")
-  .option("--code", "Mostrar código completo del template")
-  .option("--force", "Mostrar template aunque no tenga @teachMe")
+  .command('teach <templateId>')
+  .description('Enseñanza estructurada desde template con @teachMe')
+  .option('--lang <lang>', 'Lenguaje del template (default: react)')
+  .option('--code', 'Mostrar código completo del template')
+  .option('--force', 'Mostrar template aunque no tenga @teachMe')
   .action(async (templateId, options) => {
-    const { teach } = await import("../src/commands/teach.js")
+    const { teach } = await import('../src/commands/teach.js')
     await teach(templateId, options)
   })
 
+// ─── Learn command (Phase D.1) ────────────────────────────────────────────────
+
+program
+  .command('learn')
+  .description('Aprender desde documentación: genera módulos de lenguaje usando IA')
+  .option('--docs <paths...>', 'Rutas a archivos/directorios de documentación')
+  .option('--from <paths...>', 'Proyectos reales para extraer patrones (opcional)')
+  .option('--name <name>', 'Nombre del lenguaje (si no se puede detectar automáticamente)')
+  .option('--output <dir>', 'Directorio de salida (default: ~/.openprompt/knowledge/langs/<name>)')
+  .option('--update <dir>', 'Actualizar módulo existente en lugar de crear nuevo')
+  .option('--integrate', 'Copiar el módulo generado a src/templates/langs/ (solo maintainers)')
+  .option('--dry-run', 'Analizar y mostrar preview sin escribir archivos')
+  .option('--provider <provider>', 'AI provider: openai | anthropic | ollama | mock')
+  .action(async (options) => {
+    const { learn } = await import('../src/commands/learn.js')
+    await learn(options)
+  })
+
 // ─── QA commands ─────────────────────────────────────────────────────────────
 
 program
-  .command("qa-gen")
-  .description("Generate tests from learned errors (@learn-error)")
-  .option("--lang <lang>", "Language module (default: from INDEX.json)")
-  .option("--source <dir>", "Source directory to scan for @learn-error")
-  .option("--output <dir>", "Output directory for generated tests (default: src/__tests__)")
-  .option("--template <id>", "Generate tests only for a specific template")
-  .option("--dry-run", "Preview without writing files")
-  .option("--no-scan", "Skip scanning source for new @learn-error annotations")
+  .command('qa-gen')
+  .description('Generate tests from learned errors (@learn-error)')
+  .option('--lang <lang>', 'Language module (default: from INDEX.json)')
+  .option('--source <dir>', 'Source directory to scan for @learn-error')
+  .option('--output <dir>', 'Output directory for generated tests (default: src/__tests__)')
+  .option('--template <id>', 'Generate tests only for a specific template')
+  .option('--dry-run', 'Preview without writing files')
+  .option('--no-scan', 'Skip scanning source for new @learn-error annotations')
   .action(async (options) => {
-    const { qaGen } = await import("../src/commands/qa-gen.js")
+    const { qaGen } = await import('../src/commands/qa-gen.js')
     await qaGen(options)
   })
 
 program
-  .command("qa-learn")
-  .description("Parse @learn-error from a file and persist to language module")
-  .option("--file <path>", "Source file to scan for @learn-error annotations")
-  .option("--lang <lang>", "Language module (default: react)")
+  .command('qa-learn')
+  .description('Parse @learn-error from a file and persist to language module')
+  .option('--file <path>', 'Source file to scan for @learn-error annotations')
+  .option('--lang <lang>', 'Language module (default: react)')
   .action(async (options) => {
-    const { qaLearn } = await import("../src/commands/qa-gen.js")
+    const { qaLearn } = await import('../src/commands/qa-gen.js')
     await qaLearn(options)
   })
 
 // ─── Lang command ────────────────────────────────────────────────────────────
 
-const lang = program.command("lang").description("Gestionar módulos de lenguaje plugables")
+const lang = program.command('lang').description('Gestionar módulos de lenguaje plugables')
 
 lang
-  .command("list")
-  .description("Listar lenguajes disponibles")
+  .command('list')
+  .description('Listar lenguajes disponibles')
   .action(async () => {
-    const { langList } = await import("../src/commands/lang.js")
+    const { langList } = await import('../src/commands/lang.js')
     await langList()
   })
 
 lang
-  .command("index <langId>")
-  .description("Mostrar índice de templates de un lenguaje")
-  .option("--category <category>", "Filtrar por categoría")
+  .command('index <langId>')
+  .description('Mostrar índice de templates de un lenguaje')
+  .option('--category <category>', 'Filtrar por categoría')
   .action(async (langId, options) => {
-    const { langIndex } = await import("../src/commands/lang.js")
+    const { langIndex } = await import('../src/commands/lang.js')
     await langIndex(langId, options)
   })
 
 lang
-  .command("search <query>")
-  .description("Buscar templates en todos los lenguajes")
-  .option("--lang <lang>", "Filtrar por lenguaje")
+  .command('search <query>')
+  .description('Buscar templates en todos los lenguajes')
+  .option('--lang <lang>', 'Filtrar por lenguaje')
   .action(async (query, options) => {
-    const { langSearch } = await import("../src/commands/lang.js")
+    const { langSearch } = await import('../src/commands/lang.js')
     await langSearch(query, options)
   })
 
 lang
-  .command("errors [langId]")
-  .description("Mostrar errores aprendidos")
-  .option("--template <id>", "Filtrar por template ID")
+  .command('errors [langId]')
+  .description('Mostrar errores aprendidos')
+  .option('--template <id>', 'Filtrar por template ID')
   .action(async (langId, options) => {
-    const { langErrors } = await import("../src/commands/lang.js")
-    await langErrors(langId || "react", options)
+    const { langErrors } = await import('../src/commands/lang.js')
+    await langErrors(langId || 'react', options)
+  })
+
+// ─── DB Rules command ────────────────────────────────────────────────────────
+
+program
+  .command('db-rules')
+  .description('Consultar reglas de base de datos, anti-patrones y buenas prácticas')
+  .option('--list', 'Listar todas las reglas disponibles')
+  .option('--id <id>', 'Ver detalle de una regla específica (ej: db-001)')
+  .option('--tag <tag>', 'Filtrar por tag (ej: performance, security, supabase)')
+  .option('--category <cat>', 'Filtrar por categoría (ej: rendimiento, arquitectura)')
+  .action(async (options) => {
+    const { dbRules } = await import('../src/commands/db-rules.js')
+    await dbRules(options)
   })
 
 // ─── Extract command ─────────────────────────────────────────────────────────
 
 program
-  .command("extract [sourceDir]")
-  .description("Analyze project and extract reusable components as templates")
-  .option("--lang <lang>", "Language module to extract into (default: from prompt-lang.json)")
-  .option("--min-reuse <n>", "Minimum imports to qualify (default: 2)")
-  .option("--dry-run", "Analyze only, don't write files")
+  .command('extract [sourceDir]')
+  .description('Analyze project and extract reusable components as templates')
+  .option('--lang <lang>', 'Language module to extract into (default: from prompt-lang.json)')
+  .option('--min-reuse <n>', 'Minimum imports to qualify (default: 2)')
+  .option('--dry-run', "Analyze only, don't write files")
+  .option('--learn', 'Deep project analysis: extract patterns, conventions and ways of working')
+  .option('--output <file>', 'Output file for --learn profile (default: aprendizaje-perfil.json)')
   .action(async (sourceDir, options) => {
-    const { extractTemplates } = await import("../src/commands/extract.js")
-    await extractTemplates(sourceDir || "src", options)
+    if (options.learn) {
+      const { extractLearn } = await import('../src/commands/extract.js')
+      await extractLearn(sourceDir || 'src', options)
+      return
+    }
+    const { extractTemplates } = await import('../src/commands/extract.js')
+    await extractTemplates(sourceDir || 'src', options)
   })
 
 program
-  .command("analyze [sourceDir]")
-  .description("Analyze project structure, deps, and code health")
+  .command('analyze [sourceDir]')
+  .description('Analyze project structure, deps, and code health')
   .action(async (sourceDir) => {
-    const { extractAnalyze } = await import("../src/commands/extract.js")
-    await extractAnalyze(sourceDir || "src", {})
+    const { extractAnalyze } = await import('../src/commands/extract.js')
+    await extractAnalyze(sourceDir || 'src', {})
   })
 
 // ─── Integrate command ────────────────────────────────────────────────────────
 
 program
-  .command("integrate")
-  .description("Configure Opencode, Cursor, and VS Code for the project")
-  .option("--all", "Setup all integrations without prompting")
-  .option("--lang <lang>", "Language (auto-detects from prompt-lang.json)")
-  .option("--no-ask", "Skip interactive prompts")
+  .command('integrate')
+  .description('Configure Opencode, Cursor, and VS Code for the project')
+  .option('--all', 'Setup all integrations without prompting')
+  .option('--lang <lang>', 'Language (auto-detects from prompt-lang.json)')
+  .option('--no-ask', 'Skip interactive prompts')
+  .option('--from <dir>', 'Transferir contexto desde otro proyecto (memoria estructurada)')
+  .option('--to <dir>', 'Proyecto destino para la transferencia de contexto')
+  .option('--migrate', 'Modo migración: copiar contexto de negocio entre proyectos')
   .action(async (options) => {
-    const { integrate } = await import("../src/commands/integrate.js")
+    if (options.migrate || options.from) {
+      const { migrateContext } = await import('../src/commands/integrate.js')
+      await migrateContext(options)
+      return
+    }
+    const { integrate } = await import('../src/commands/integrate.js')
     await integrate(options)
   })
 
 // ─── AI commands ─────────────────────────────────────────────────────────────
 
 program
-  .command("ai-gen")
-  .description("Generate components from natural language descriptions")
-  .option("--description <text>", "Description of what to generate")
-  .option("--name <name>", "Component name (auto-suggested if omitted)")
-  .option("--lang <lang>", "Language module (default: react)")
-  .option("--profile <profile>", "senior | mid | junior (default: mid)")
+  .command('ai-gen')
+  .description('Generate components from natural language descriptions')
+  .option('--description <text>', 'Description of what to generate')
+  .option('--name <name>', 'Component name (auto-suggested if omitted)')
+  .option('--lang <lang>', 'Language module (default: react)')
+  .option('--profile <profile>', 'senior | mid | junior (default: mid)')
   .option(
-    "--provider <provider>",
-    "AI provider: openai | anthropic | ollama | mock (default: auto-detect)"
+    '--provider <provider>',
+    'AI provider: openai | anthropic | ollama | mock (default: auto-detect)'
   )
-  .option("--output <dir>", "Output directory (default: src/components)")
-  .option("--force", "Overwrite existing files without asking")
-  .option("--validate", "Run annotation validation after generation")
-  .option("--verbose", "Show prompt and extended output")
-  .option("--temperature <num>", "Temperature for generation (default: 0.3)")
-  .option("--max-tokens <num>", "Max tokens for generation (default: 4096)")
+  .option('--output <dir>', 'Output directory (default: src/components)')
+  .option('--force', 'Overwrite existing files without asking')
+  .option('--validate', 'Run annotation validation after generation')
+  .option('--verbose', 'Show prompt and extended output')
+  .option('--temperature <num>', 'Temperature for generation (default: 0.3)')
+  .option('--max-tokens <num>', 'Max tokens for generation (default: 4096)')
   .action(async (options) => {
-    const { aiGen } = await import("../src/commands/ai-gen.js")
+    const { aiGen } = await import('../src/commands/ai-gen.js')
     await aiGen(options)
   })
 
 program
-  .command("ai-providers")
-  .description("List available AI providers and their status")
+  .command('ai-providers')
+  .description('List available AI providers and their status')
   .action(async () => {
-    const { aiProviders } = await import("../src/commands/ai-gen.js")
+    const { aiProviders } = await import('../src/commands/ai-gen.js')
     await aiProviders()
   })
 
 // ─── Scaffold command ────────────────────────────────────────────────────────
 
 const scaffold = program
-  .command("scaffold")
-  .description("Gestionar scafffolding de proyectos por framework")
+  .command('scaffold')
+  .description('Gestionar scafffolding de proyectos por framework')
 
 scaffold
-  .command("folders <framework>")
-  .description("Crear estructura de carpetas según framework")
-  .option("--name <name>", "Nombre del proyecto (directorio)")
-  .option("--force", "Sobrescribir archivos existentes")
+  .command('folders <framework>')
+  .description('Crear estructura de carpetas según framework')
+  .option('--name <name>', 'Nombre del proyecto (directorio)')
+  .option('--force', 'Sobrescribir archivos existentes')
   .action(async (framework, options) => {
-    const { scaffoldFolders } = await import("../src/commands/scaffold.js")
+    const { scaffoldFolders } = await import('../src/commands/scaffold.js')
     await scaffoldFolders(framework, options)
   })
 
 scaffold
-  .command("list")
-  .description("Listar frameworks disponibles en el catálogo")
+  .command('list')
+  .description('Listar frameworks disponibles en el catálogo')
   .action(async () => {
-    const { scaffoldList } = await import("../src/commands/scaffold.js")
+    const { scaffoldList } = await import('../src/commands/scaffold.js')
     await scaffoldList()
   })
 
 // ─── MCP server command ───────────────────────────────────────────────────────
 
 program
-  .command("mcp")
-  .description("Start MCP server for opencode integration via stdio")
+  .command('mcp')
+  .description('Start MCP server for opencode integration via stdio')
   .action(async () => {
-    const { startServer } = await import("../src/mcp-server.js")
+    const { startServer } = await import('../src/mcp-server.js')
     await startServer()
   })
 
-program.parse(process.argv)
+try {
+  await program.parseAsync(process.argv)
+} catch (err) {
+  console.error(chalk.red(`✘ Error: ${err.message}`))
+  process.exitCode = 1
+}