openprompt-lang 0.3.0 → 0.4.0

package/bin/cli.js

@@ -1,22 +1,20 @@
 #!/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 { createRequire } from "module";
+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 require = createRequire(import.meta.url);
-const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"))
 
-const program = new Command();
+const program = new Command()
 
 program
   .name("openPrompt-Lang")
   .description(chalk.cyan("Framework de anotaciones para desarrollo asistido por IA"))
-  .version(pkg.version);
+  .version(pkg.version)
 
 program
   .command("init")
@@ -25,17 +23,17 @@ program
   .option("--describe <text>", "Descripción del proyecto para sugerencia IA")
   .option("--existing", "Configurar en proyecto existente (solo archivos de configuración)")
   .action(async (options) => {
-    const { init } = await import("../src/commands/init.js");
-    await init(options);
-  });
+    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")
   .action(async () => {
-    const { figma } = await import("../src/commands/figma.js");
-    await figma();
-  });
+    const { figma } = await import("../src/commands/figma.js")
+    await figma()
+  })
 
 program
   .command("context")
@@ -44,49 +42,54 @@ program
   .option("--scope <module>", "Filtrar por módulo (@scope)")
   .option("--no-ai", "No incluir anotaciones PromptLang en el output")
   .action(async (options) => {
-    const { context } = await import("../src/commands/context.js");
-    await context(options);
-  });
+    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")
   .action(async (options) => {
-    const { validate } = await import("../src/commands/validate.js");
-    await validate(options);
-  });
+    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")
   .action(async (description) => {
-    const { suggest } = await import("../src/commands/suggest.js");
-    await suggest(description);
-  });
+    const { suggest } = await import("../src/commands/suggest.js")
+    await suggest(description)
+  })
 
 const component = program
   .command("component")
-  .description("Gestionar biblioteca de componentes reutilizables");
+  .description("Gestionar biblioteca de componentes reutilizables")
 
 component
   .command("list")
   .description("Listar componentes disponibles")
   .option("--library <path>", "Ruta a la biblioteca de componentes")
   .action(async (options) => {
-    const { componentList } = await import("../src/commands/component.js");
-    await componentList(options);
-  });
+    const { componentList } = await import("../src/commands/component.js")
+    await componentList(options)
+  })
 
 component
   .command("add <name>")
-  .description("Agregar componente de la biblioteca al proyecto")
+  .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")
   .action(async (name, options) => {
-    const { componentAdd } = await import("../src/commands/component.js");
-    await componentAdd(name, options);
-  });
+    const { componentAdd } = await import("../src/commands/component.js")
+    await componentAdd(name, options)
+  })
 
 component
   .command("init")
@@ -94,17 +97,205 @@ component
   .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");
-    await componentInit(options);
-  });
+    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")
   .action(async (options) => {
-    const { componentManifest } = await import("../src/commands/component.js");
-    await componentManifest(options);
-  });
+    const { componentManifest } = await import("../src/commands/component.js")
+    await componentManifest(options)
+  })
 
-program.parse(process.argv);
+// ─── Wizard command ──────────────────────────────────────────────────────────
+
+program
+  .command("wizard")
+  .description("Asistente interactivo para configurar proyecto openPrompt-Lang")
+  .action(async () => {
+    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")
+  .action(async (templateId, options) => {
+    const { teach } = await import("../src/commands/teach.js")
+    await teach(templateId, 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")
+  .action(async (options) => {
+    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)")
+  .action(async (options) => {
+    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")
+
+lang
+  .command("list")
+  .description("Listar lenguajes disponibles")
+  .action(async () => {
+    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")
+  .action(async (langId, options) => {
+    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")
+  .action(async (query, options) => {
+    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")
+  .action(async (langId, options) => {
+    const { langErrors } = await import("../src/commands/lang.js")
+    await langErrors(langId || "react", 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")
+  .action(async (sourceDir, options) => {
+    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")
+  .action(async (sourceDir) => {
+    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")
+  .action(async (options) => {
+    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)")
+  .option(
+    "--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)")
+  .action(async (options) => {
+    const { aiGen } = await import("../src/commands/ai-gen.js")
+    await aiGen(options)
+  })
+
+program
+  .command("ai-providers")
+  .description("List available AI providers and their status")
+  .action(async () => {
+    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")
+
+scaffold
+  .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")
+    await scaffoldFolders(framework, options)
+  })
+
+scaffold
+  .command("list")
+  .description("Listar frameworks disponibles en el catálogo")
+  .action(async () => {
+    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")
+  .action(async () => {
+    const { startServer } = await import("../src/mcp-server.js")
+    await startServer()
+  })
+
+program.parse(process.argv)

package/bin/create.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+
+import { execSync } from "child_process"
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync, rmSync } from "fs"
+import { join, dirname } from "path"
+import { fileURLToPath } from "url"
+import chalk from "chalk"
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+async function main() {
+  const args = process.argv.slice(2)
+  const projectName = args[0] || "mi-app"
+  const depsIndex = args.indexOf("--deps")
+  const deps = depsIndex !== -1 ? args[depsIndex + 1]?.split(",") || [] : []
+  const deployIndex = args.indexOf("--deploy")
+  const deploy = deployIndex !== -1 ? args[deployIndex + 1] : null
+  const hasIonic = args.includes("--ionic")
+  const hasTauri = args.includes("--tauri")
+  const force = args.includes("--force")
+
+  const projectDir = join(process.cwd(), projectName)
+
+  console.log(chalk.cyan(`\n🚀 Creando proyecto: ${projectName}\n`))
+
+  // 1. Crear con Vite
+  try {
+    console.log(chalk.blue("  [1/5] Creando base Vite + React + TS..."))
+    execSync(
+      `npx create-vite@latest ${projectName} --template react-ts ${force ? "--force" : ""}`,
+      {
+        stdio: "pipe",
+        cwd: process.cwd(),
+      }
+    )
+    console.log(chalk.green("  ✅ Base Vite creada"))
+  } catch {
+    console.log(chalk.yellow("  ⚠️  Vite base ya existe o falló. Continuando..."))
+  }
+
+  // 2. Limpiar boilerplate predecible
+  console.log(chalk.blue("  [2/5] Limpiando boilerplate innecesario..."))
+  const toDelete = ["src/App.css", "src/assets", "public/vite.svg"]
+  for (const file of toDelete) {
+    const fullPath = join(projectDir, file)
+    if (existsSync(fullPath)) {
+      rmSync(fullPath, { recursive: true, force: true })
+    }
+  }
+  // Reescribir App.tsx minimal
+  const appContent = `function App() {
+  return <div className="min-h-screen bg-gray-50" />
+}
+
+export default App
+`
+  writeFileSync(join(projectDir, "src/App.tsx"), appContent, "utf-8")
+
+  // 3. Instalar dependencias adicionales
+  if (deps.length > 0) {
+    console.log(chalk.blue(`  [3/5] Instalando dependencias: ${deps.join(", ")}...`))
+    try {
+      execSync(`npm install ${deps.join(" ")}`, { stdio: "pipe", cwd: projectDir })
+      console.log(chalk.green("  ✅ Dependencias instaladas"))
+    } catch {
+      console.log(
+        chalk.yellow("  ⚠️  Error instalando dependencias. Continúa con npm install manual.")
+      )
+    }
+  }
+
+  // 4. Copiar scaffolds
+  console.log(chalk.blue("  [4/5] Copiando archivos de configuración..."))
+  const scaffoldsDir = join(__dirname, "..", "scaffolds")
+
+  const scaffoldFiles = [
+    ["tailwind.config.js", "tailwind.config.js"],
+    ["prompt-lang.json", "prompt-lang.json"],
+  ]
+
+  if (deploy === "railway") scaffoldFiles.push(["railway.json", "railway.json"])
+  if (deploy === "netlify") scaffoldFiles.push(["netlify.toml", "netlify.toml"])
+  if (hasIonic) scaffoldFiles.push(["capacitor.config.ts", "capacitor.config.ts"])
+  if (hasTauri) scaffoldFiles.push(["tauri.conf.json", "tauri.conf.json"])
+
+  for (const [src, dest] of scaffoldFiles) {
+    const srcPath = join(scaffoldsDir, src)
+    const destPath = join(projectDir, dest)
+    if (existsSync(srcPath) && (!existsSync(destPath) || force)) {
+      copyFileSync(srcPath, destPath)
+      console.log(`  ✅ ${dest}`)
+    }
+  }
+
+  // 5. Configurar package.json con scripts descriptivos
+  console.log(chalk.blue("  [5/5] Agregando scripts descriptivos..."))
+  const pkgPath = join(projectDir, "package.json")
+  if (existsSync(pkgPath)) {
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"))
+    const descriptiveScripts = {
+      "dev:start": "vite",
+      "dev:preview": "vite preview",
+      "build:prod": "vite build",
+      "build:analyze": "vite build --analyze",
+      "lint:check": "eslint src --ext .ts,.tsx",
+      "lint:fix": "eslint src --ext .ts,.tsx --fix",
+      "type:check": "tsc --noEmit",
+      "test:unit": "vitest run",
+      "test:watch": "vitest",
+      "test:coverage": "vitest run --coverage",
+      "validate:all": "npm run lint:check && npm run type:check && npm run test:unit",
+    }
+    pkg.scripts = { ...descriptiveScripts, ...pkg.scripts }
+    writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8")
+    console.log(chalk.green("  ✅ Scripts descriptivos agregados"))
+  }
+
+  // Ionic plug
+  if (hasIonic) {
+    console.log(chalk.blue("  🔌 Integrando Ionic..."))
+    try {
+      execSync("npx cap init App com.app.app --web-dir=dist", { stdio: "pipe", cwd: projectDir })
+      execSync("npx cap add android", { stdio: "pipe", cwd: projectDir })
+      console.log(chalk.green("  ✅ Ionic/Capacitor configurado"))
+    } catch {
+      console.log(chalk.yellow("  ⚠️  Error en setup Ionic. Configura manualmente."))
+    }
+  }
+
+  console.log(chalk.cyan(`\n✅ ${projectName} listo!`))
+  console.log(chalk.cyan(`   cd ${projectName}`))
+  console.log(chalk.cyan(`   npm run dev:start\n`))
+}
+
+main().catch(console.error)

package/bin/lint.js

@@ -1,50 +1,49 @@
 #!/usr/bin/env node
 
-import { readFileSync, existsSync } from "fs";
-import { join } from "path";
-import { loadConfig } from "../src/utils/config.js";
-import { lintFile } from "../src/utils/annotations.js";
-import chalk from "chalk";
+import { readFileSync, existsSync } from "fs"
+import { join } from "path"
+import { lintFile } from "../src/utils/annotations.js"
+import chalk from "chalk"
 
-const targetFile = join(process.cwd(), process.argv[2] || "");
+const targetFile = join(process.cwd(), process.argv[2] || "")
 
 if (!targetFile || !existsSync(targetFile)) {
-  console.log(chalk.red("❌ Archivo no encontrado"));
-  console.log("Uso: node bin/lint.js <archivo>");
-  process.exit(1);
+  console.log(chalk.red("❌ Archivo no encontrado"))
+  console.log("Uso: node bin/lint.js <archivo>")
+  process.exit(1)
 }
 
-const content = readFileSync(targetFile, "utf-8");
-const { annotations, errors, warnings } = lintFile(content);
+const content = readFileSync(targetFile, "utf-8")
+const { annotations, errors, warnings } = lintFile(content)
 
 if (annotations.length === 0) {
-  console.log(chalk.cyan("📭 Sin anotaciones PromptLang en este archivo"));
-  process.exit(0);
+  console.log(chalk.cyan("📭 Sin anotaciones PromptLang en este archivo"))
+  process.exit(0)
 }
 
-console.log(chalk.cyan(`\n🔍 Anotaciones encontradas: ${annotations.length}\n`));
+console.log(chalk.cyan(`\n🔍 Anotaciones encontradas: ${annotations.length}\n`))
 
 for (const ann of annotations) {
   const argsStr = ann.args.length
     ? ann.args.map((a) => (a.key ? `${a.key}: ${a.value}` : a.value)).join(", ")
-    : "";
-  console.log(`  @${ann.name}${argsStr ? `(${argsStr})` : ""}`);
+    : ""
+  console.log(`  @${ann.name}${argsStr ? `(${argsStr})` : ""}`)
 }
 
 if (errors.length > 0) {
-  console.log(chalk.red(`\n❌ Errores (${errors.length}):\n`));
+  console.log(chalk.red(`\n❌ Errores (${errors.length}):\n`))
   for (const err of errors) {
-    console.log(chalk.red(`  • ${err}`));
+    console.log(chalk.red(`  • ${err}`))
   }
 }
 
 if (warnings.length > 0) {
-  console.log(chalk.yellow(`\n⚠️  Advertencias (${warnings.length}):\n`));
+  console.log(chalk.yellow(`\n⚠️  Advertencias (${warnings.length}):\n`))
   for (const warn of warnings) {
-    console.log(chalk.yellow(`  • ${warn}`));
+    console.log(chalk.yellow(`  • ${warn}`))
   }
 }
 
 if (errors.length === 0 && warnings.length === 0) {
-  console.log(chalk.green("\n✅ Todas las anotaciones válidas\n"));
+  console.log(chalk.green("\n✅ Todas las anotaciones válidas\n"))
 }