create-nevex-agent 0.1.0

package/README.md

@@ -0,0 +1,22 @@
+# create-nevex-agent
+
+Genera un proyecto independiente a partir del template de Nevex:
+
+```bash
+npx create-nevex-agent coagua --display-name "Coagua"
+```
+
+El CLI se publica en npm. El repositorio template que clona permanece privado
+y requiere acceso SSH a `nevex-labs/nevex-agent-template`.
+
+La publicación automática se dispara desde el repositorio con un tag de la
+forma `create-nevex-agent-v<version>` y el secreto `NPM_TOKEN`.
+
+Para probar el CLI contra un checkout local:
+
+```bash
+node bin/create-nevex-agent.mjs demo --template-path ../../
+```
+
+El generador no crea bases, cuentas ni recursos cloud. Solo copia el template
+y personaliza la identidad inicial del nuevo proyecto.

package/bin/create-nevex-agent.mjs

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+
+import {
+  cpSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  rmSync,
+  writeFileSync,
+} from "node:fs";
+import { join, resolve } from "node:path";
+import { randomUUID } from "node:crypto";
+import { execFileSync } from "node:child_process";
+import { tmpdir } from "node:os";
+
+const args = parseArgs(process.argv.slice(2));
+const projectName = args._[0];
+
+if (!projectName || args.help) {
+  printHelp();
+  process.exit(projectName ? 0 : 1);
+}
+
+const slug = normalizeSlug(projectName);
+const target = resolve(args.output ?? projectName);
+assertTargetIsSafe(target);
+
+const source = args["template-path"]
+  ? resolve(args["template-path"])
+  : await materializeTemplate(args["template-repo"] ?? process.env.NEVEX_AGENT_TEMPLATE_REPO);
+
+mkdirSync(target, { recursive: true });
+cpSync(source, target, {
+  recursive: true,
+  filter: (entry) => !shouldSkip(entry, source),
+});
+
+customizeProject(target, {
+  slug,
+  displayName: args["display-name"] ?? titleCase(slug),
+});
+
+if (!args["template-path"]) rmSync(source, { recursive: true, force: true });
+
+console.log(`\nProyecto creado en ${target}`);
+console.log("\nSiguientes pasos:\n");
+console.log(`  cd ${JSON.stringify(target)}`);
+console.log("  pnpm install");
+console.log("  cp .env.example .env.local");
+console.log("  pnpm dev\n");
+
+async function materializeTemplate(repository) {
+  const repo = repository ?? "git@github.com:nevex-labs/nevex-agent-template.git";
+  const directory = join(tmpdir(), `nevex-agent-template-${randomUUID()}`);
+  execFileSync("git", ["clone", "--depth", "1", repo, directory], { stdio: "inherit" });
+  return directory;
+}
+
+function customizeProject(directory, values) {
+  const packagePath = join(directory, "package.json");
+  const packageJson = JSON.parse(readFileSync(packagePath, "utf8"));
+  packageJson.name = values.slug;
+  packageJson.private = true;
+  writeFileSync(packagePath, `${JSON.stringify(packageJson, null, 2)}\n`);
+
+  replaceInFile(
+    join(directory, "src/lib/config.ts"),
+    /APP_NAME = "[^"]*"/,
+    `APP_NAME = ${JSON.stringify(values.displayName)}`,
+  );
+  replaceInFile(
+    join(directory, "wrangler.jsonc"),
+    /"name": "[^"]*"/,
+    `"name": ${JSON.stringify(values.slug)}`,
+  );
+  replaceInFile(
+    join(directory, "wrangler.jsonc"),
+    /"database_name": "[^"]*"/,
+    `"database_name": ${JSON.stringify(values.slug)}`,
+  );
+  replaceInFile(
+    join(directory, "README.md"),
+    /^# Nevex Agent Template/m,
+    `# ${values.displayName}`,
+  );
+}
+
+function replaceInFile(path, pattern, replacement) {
+  const content = readFileSync(path, "utf8");
+  writeFileSync(path, content.replace(pattern, replacement));
+}
+
+function shouldSkip(entry, source) {
+  const relative = entry.slice(source.length + 1);
+  return (
+    relative === ".git" ||
+    relative.startsWith(".git/") ||
+    relative === "node_modules" ||
+    relative.startsWith("node_modules/") ||
+    relative === "dist" ||
+    relative.startsWith("dist/") ||
+    relative === ".wrangler" ||
+    relative.startsWith(".wrangler/") ||
+    relative === ".github/workflows/publish-create-nevex-agent.yml" ||
+    relative === "packages/create-nevex-agent" ||
+    relative.startsWith("packages/create-nevex-agent/")
+  );
+}
+
+function assertTargetIsSafe(directory) {
+  if (!existsSync(directory)) return;
+  if (readdirSync(directory).length > 0) {
+    throw new Error(`El directorio ${directory} ya existe y no está vacío.`);
+  }
+}
+
+function normalizeSlug(value) {
+  const slug = value
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-|-$/g, "");
+  if (!slug) throw new Error("El nombre del proyecto no es válido.");
+  return slug;
+}
+
+function titleCase(value) {
+  return value.replace(/-/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
+}
+
+function parseArgs(argv) {
+  const result = { _: [] };
+  for (let index = 0; index < argv.length; index += 1) {
+    const value = argv[index];
+    if (value === "--help" || value === "-h") result.help = true;
+    else if (value.startsWith("--")) result[value.slice(2)] = argv[++index];
+    else result._.push(value);
+  }
+  return result;
+}
+
+function printHelp() {
+  console.log(`Uso: npx @nevex/create-nevex-agent <nombre> [opciones]
+
+Opciones:
+  --display-name <nombre>   Nombre visible del agente
+  --output <directorio>     Directorio de destino
+  --template-path <path>    Usar un template local, útil para desarrollo
+  --template-repo <repo>    URL o ruta del repositorio template
+  -h, --help                Mostrar esta ayuda`);
+}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "create-nevex-agent",
+  "version": "0.1.0",
+  "description": "Create a custom Nevex WhatsApp agent project",
+  "bin": {
+    "create-nevex-agent": "bin/create-nevex-agent.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}