create-nevex-agent 0.1.0 → 0.1.2

package/bin/create-nevex-agent.mjs

@@ -15,6 +15,7 @@ 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) {
@@ -23,14 +24,20 @@ if (!projectName || args.help) {
 }
 
 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);
+  : await materializeTemplate(
+      args["template-repo"] ?? process.env.NEVEX_AGENT_TEMPLATE_REPO,
+      args["template-ref"],
+    );
 
 mkdirSync(target, { recursive: true });
+
 cpSync(source, target, {
   recursive: true,
   filter: (entry) => !shouldSkip(entry, source),
@@ -39,24 +46,48 @@ cpSync(source, target, {
 customizeProject(target, {
   slug,
   displayName: args["display-name"] ?? titleCase(slug),
+  templateRepo:
+    args["template-path"] ?? args["template-repo"] ?? process.env.NEVEX_AGENT_TEMPLATE_REPO ?? null,
+  templateRef: args["template-path"] ? null : (args["template-ref"] ?? null),
+  templateCommit: args["template-path"] ? null : readTemplateCommit(source),
 });
 
 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) {
+async function materializeTemplate(repository, ref) {
   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" });
+  const refArgs = ref ? ["--branch", ref] : [];
+  execFileSync("git", ["clone", "--depth", "1", ...refArgs, repo, directory], {
+    stdio: "inherit",
+  });
+
   return directory;
 }
 
+function readTemplateCommit(directory) {
+  try {
+    return execFileSync("git", ["rev-parse", "HEAD"], {
+      cwd: directory,
+      encoding: "utf8",
+    }).trim();
+  } catch {
+    return null;
+  }
+}
+
 function customizeProject(directory, values) {
   const packagePath = join(directory, "package.json");
   const packageJson = JSON.parse(readFileSync(packagePath, "utf8"));
@@ -66,8 +97,8 @@ function customizeProject(directory, values) {
 
   replaceInFile(
     join(directory, "src/lib/config.ts"),
-    /APP_NAME = "[^"]*"/,
-    `APP_NAME = ${JSON.stringify(values.displayName)}`,
+    /^export const APP_NAME = .*;$/m,
+    `export const APP_NAME = ${JSON.stringify(values.displayName)};`,
   );
   replaceInFile(
     join(directory, "wrangler.jsonc"),
@@ -84,15 +115,33 @@ function customizeProject(directory, values) {
     /^# Nevex Agent Template/m,
     `# ${values.displayName}`,
   );
+
+  const lines = [
+    "# Template origin",
+    "",
+    `- Template: ${values.templateRepo ?? "git@github.com:nevex-labs/nevex-agent-template.git"}`,
+  ];
+
+  if (values.templateRef) lines.push(`- Ref: ${values.templateRef}`);
+
+  if (values.templateCommit) lines.push(`- Commit: ${values.templateCommit}`);
+  lines.push(`- Generated: ${new Date().toISOString().slice(0, 10)}`, "");
+  writeFileSync(join(directory, "TEMPLATE.md"), `${lines.join("\n")}`);
 }
 
 function replaceInFile(path, pattern, replacement) {
   const content = readFileSync(path, "utf8");
+
+  if (!pattern.test(content)) {
+    throw new Error(`El patrón ${pattern} no matcheó en ${path}.`);
+  }
+
   writeFileSync(path, content.replace(pattern, replacement));
 }
 
 function shouldSkip(entry, source) {
   const relative = entry.slice(source.length + 1);
+
   return (
     relative === ".git" ||
     relative.startsWith(".git/") ||
@@ -110,6 +159,7 @@ function shouldSkip(entry, source) {
 
 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.`);
   }
@@ -120,7 +170,9 @@ function normalizeSlug(value) {
     .toLowerCase()
     .replace(/[^a-z0-9]+/g, "-")
     .replace(/^-|-$/g, "");
+
   if (!slug) throw new Error("El nombre del proyecto no es válido.");
+
   return slug;
 }
 
@@ -130,22 +182,26 @@ function titleCase(value) {
 
 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]
+  console.log(`Uso: npx 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
+  --template-ref <ref>      Rama o tag del template (default: rama por defecto)
   -h, --help                Mostrar esta ayuda`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nevex-agent",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Create a custom Nevex WhatsApp agent project",
   "bin": {
     "create-nevex-agent": "bin/create-nevex-agent.mjs"