create-nevex-agent 0.1.2 → 0.2.0

package/README.md

@@ -6,6 +6,18 @@ Genera un proyecto independiente a partir del template de Nevex:
 npx create-nevex-agent coagua --display-name "Coagua"
 ```
 
+Por defecto crea la instalación en modo Cloudflare (Worker + D1 + KV). Para
+VPS/Node:
+
+```bash
+npx create-nevex-agent coagua --mode node
+```
+
+El generador deja solo el modo elegido: borra los adapters, migraciones, tests y
+docs de deploy del otro (ADR-0005) y lo registra en `TEMPLATE.md`. Las
+dependencias del `pnpm-lock.yaml` se conservan completas para no romper
+`--frozen-lockfile`; el código que no corre ya no está.
+
 El CLI se publica en npm. El repositorio template que clona permanece privado
 y requiere acceso SSH a `nevex-labs/nevex-agent-template`.
 

package/bin/create-nevex-agent.mjs

@@ -25,6 +25,8 @@ if (!projectName || args.help) {
 
 const slug = normalizeSlug(projectName);
 
+const mode = normalizeMode(args.mode);
+
 const target = resolve(args.output ?? projectName);
 
 assertTargetIsSafe(target);
@@ -45,6 +47,7 @@ cpSync(source, target, {
 
 customizeProject(target, {
   slug,
+  mode,
   displayName: args["display-name"] ?? titleCase(slug),
   templateRepo:
     args["template-path"] ?? args["template-repo"] ?? process.env.NEVEX_AGENT_TEMPLATE_REPO ?? null,
@@ -89,33 +92,83 @@ function readTemplateCommit(directory) {
 }
 
 function customizeProject(directory, values) {
+  applyMode(directory, values.mode);
+
   const packagePath = join(directory, "package.json");
   const packageJson = JSON.parse(readFileSync(packagePath, "utf8"));
   packageJson.name = values.slug;
   packageJson.private = true;
+  // The CLI smoke lives in the template only; installations must not keep
+  // a script pointing at the package the generator just excluded.
+  delete packageJson.scripts?.["test:cli"];
+
+  if (values.mode === "cloudflare") {
+    delete packageJson.scripts?.["build:node"];
+    delete packageJson.scripts?.start;
+  } else {
+    delete packageJson.scripts?.deploy;
+    delete packageJson.scripts?.["cf-typegen"];
+    packageJson.scripts.dev = "DEPLOY_TARGET=node dotenv -e .env.local -- vite dev";
+    packageJson.scripts.build = "DEPLOY_TARGET=node vite build";
+    packageJson.scripts.preview = "DEPLOY_TARGET=node vite preview";
+  }
+
   writeFileSync(packagePath, `${JSON.stringify(packageJson, null, 2)}\n`);
 
+  replaceInFile(join(directory, ".github/workflows/ci.yml"), /^      - run: pnpm test:cli\n/m, "");
+
+  replaceInFile(join(directory, "pnpm-workspace.yaml"), /^\npackages:\n  - packages\/\*\n/m, "\n");
+
+  for (const file of ["README.md", "docs/workflow.md", "docs/README.md"]) {
+    stripTemplateOnly(join(directory, file));
+  }
+
   replaceInFile(
     join(directory, "src/lib/config.ts"),
     /^export const APP_NAME = .*;$/m,
     `export const 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)}`,
-  );
+
+  if (values.mode === "cloudflare") {
+    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}`,
   );
 
+  replaceInFile(
+    join(directory, "AGENTS.md"),
+    /^This repo is a template\..*$/m,
+    "This repo is a Nevex agent installation: its own repo, database, secrets, and WhatsApp number.",
+  );
+
+  if (values.mode === "node") {
+    replaceInFile(
+      join(directory, "AGENTS.md"),
+      /## Cloudflare resources[\s\S]*$/m,
+      `## Node resources
+
+- **Host**: VPS or container, Node 22+.
+- **Postgres**: database owned by the installation.
+- **Redis**: claims and pauses with TTL.
+- **Cron triggers**: systemd timer or the host scheduler; Cloudflare \`scheduled\` does not exist in this mode.
+- **Backups**: owned by the host; document the policy once provisioned.
+`,
+    );
+  }
+
   const lines = [
     "# Template origin",
     "",
@@ -125,10 +178,92 @@ function customizeProject(directory, values) {
   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)}`, "");
+  lines.push(
+    `- Mode: ${values.mode}`,
+    `- Infrastructure: ${heldInfrastructure(values.mode)}`,
+    `- Generated: ${new Date().toISOString().slice(0, 10)}`,
+    "",
+  );
   writeFileSync(join(directory, "TEMPLATE.md"), `${lines.join("\n")}`);
 }
 
+function heldInfrastructure(mode) {
+  return mode === "cloudflare" ? "Cloudflare Worker + D1 + KV" : "Node + Postgres + Redis";
+}
+
+function normalizeMode(value) {
+  if (value === undefined) return "cloudflare";
+
+  if (value !== "cloudflare" && value !== "node") {
+    throw new Error(`Modo inválido: ${value}. Usá "cloudflare" o "node".`);
+  }
+
+  return value;
+}
+
+function modeDrop(mode) {
+  return {
+    cloudflare: [
+      "compose.yaml",
+      "docs/node-deploy.md",
+      "migrations/postgres",
+      "src/adapters/storage/postgres-conversations.ts",
+      "src/adapters/storage/postgres-conversations.test.ts",
+      "src/adapters/storage/postgres-conversations.integration.test.ts",
+      "src/adapters/storage/redis.ts",
+      "src/adapters/storage/redis.test.ts",
+      "src/infrastructure/migrations.postgres.test.ts",
+      "src/infrastructure/node",
+      "src/infrastructure/runtime.node.ts",
+      "src/infrastructure/runtime.node.test.ts",
+    ],
+    node: [
+      "docs/cloudflare-deploy.md",
+      "wrangler.jsonc",
+      "worker-configuration.d.ts",
+      "src/adapters/storage/cloudflare-kv.test.ts",
+      "src/adapters/storage/cloudflare-kv.ts",
+      "src/adapters/storage/d1.ts",
+      "src/adapters/storage/d1-conversations.test.ts",
+      "src/adapters/storage/d1-conversations.ts",
+      "src/infrastructure/cloudflare",
+      "src/infrastructure/migrations.d1.test.ts",
+      "src/infrastructure/runtime.resolution.test.ts",
+      "src/lib/env.test.ts",
+      "src/test/helpers/local-d1.ts",
+    ],
+  }[mode];
+}
+
+function applyMode(directory, mode) {
+  for (const relative of modeDrop(mode)) {
+    rmSync(join(directory, relative), { recursive: true, force: true });
+  }
+
+  if (mode !== "node") return;
+
+  for (const file of readdirSync(join(directory, "migrations"))) {
+    if (file.endsWith(".sql")) rmSync(join(directory, "migrations", file), { force: true });
+  }
+
+  writeFileSync(
+    join(directory, "src/infrastructure/runtime.ts"),
+    'export * from "./runtime.node";\n',
+  );
+  writeFileSync(
+    join(directory, "src/server.ts"),
+    `import handler from "@tanstack/react-start/server-entry";
+import { withSecurityHeaders } from "#/lib/security-headers";
+
+export default {
+  async fetch(request: Request) {
+    return withSecurityHeaders(request, await handler.fetch(request));
+  },
+};
+`,
+  );
+}
+
 function replaceInFile(path, pattern, replacement) {
   const content = readFileSync(path, "utf8");
 
@@ -139,6 +274,23 @@ function replaceInFile(path, pattern, replacement) {
   writeFileSync(path, content.replace(pattern, replacement));
 }
 
+// Sections wrapped in template-only markers describe the generator itself.
+// They make no sense in an installation, so the generator cuts them out.
+function stripTemplateOnly(path) {
+  const content = readFileSync(path, "utf8");
+
+  const stripped = content.replace(
+    /<!-- template-only:start -->[\s\S]*?<!-- template-only:end -->\n?/g,
+    "",
+  );
+
+  if (stripped.includes("template-only:")) {
+    throw new Error(`Bloque template-only sin cerrar en ${path}.`);
+  }
+
+  writeFileSync(path, stripped);
+}
+
 function shouldSkip(entry, source) {
   const relative = entry.slice(source.length + 1);
 
@@ -199,6 +351,7 @@ function printHelp() {
 
 Opciones:
   --display-name <nombre>   Nombre visible del agente
+  --mode <cloudflare|node>  Infraestructura de la instalación (default: cloudflare)
   --output <directorio>     Directorio de destino
   --template-path <path>    Usar un template local, útil para desarrollo
   --template-repo <repo>    URL o ruta del repositorio template

package/package.json

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