fwinit 1.4.2 → 1.4.3

package/README.md

@@ -66,7 +66,7 @@ mi-proyecto/
 ├── backend/          # API (template elegido — trae su DB: Prisma o EF)
 ├── frontend/         # App (template frontend elegido)
 ├── .gitignore        # .atl/ · odd  (.opencode/ y .pi/ SÍ se versionan)
-├── .opencode/        # Skills de opencode (create-specs incluida)
+├── .opencode/        # Skills de opencode (create-specs, create-specs-from-code y biblioteca de diseño)
 ├── .pi/              # Mismo bundle de skills para Pi (badlogic)
 ├── README.md         # Cómo correr backend y frontend
 └── specs/            # La creás con /create-specs
@@ -123,7 +123,7 @@ El runtime `bun` de un template se porta automáticamente a `node` (npm/pnpm) si
 2. Extrae y copia el template (o los dos, `backend/` + `frontend/`) al proyecto
 3. Sustituye el nombre del proyecto (package.json, app.json de Expo, proyectos ASP.NET con "Example")
 4. Si corresponde, porta el template de runtime bun a node (npm/pnpm)
-5. Instala `.opencode/` y `.pi/` con la skill `create-specs` y el comando `/create-specs` (mismo bundle para opencode y Pi: elegí el agente que quieras)
+5. Instala `.opencode/` y `.pi/` con las skills `create-specs` y `create-specs-from-code`, sus comandos (`/create-specs` rutea entre ambos según el estado del repo) y la biblioteca de diseño (mismo bundle para opencode y Pi: elegí el agente que quieras)
 6. Limpia los lock files (cada proyecto instala los suyos)
 7. Si lo elegís (o pasás `--git`), inicializa un repositorio git en la raíz
 8. Te muestra los próximos pasos (install y dev de cada carpeta)

package/dist/index.js

@@ -5,7 +5,7 @@ import { Command } from "commander";
 import ora from "ora";
 import chalk from "chalk";
 import { readFileSync } from "fs";
-import { mkdir as mkdir2, cp as cp2, access, readFile as readFile2, readdir as readdir2 } from "fs/promises";
+import { mkdir as mkdir2, cp as cp2, readFile as readFile2 } from "fs/promises";
 import { join as join2, basename } from "path";
 
 // src/templates.ts
@@ -228,6 +228,96 @@ function toPascalCase(str) {
   return str.split(/[-_\s]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
 }
 
+// src/agent-bundle.ts
+var AGENT_BUNDLE = [
+  {
+    kind: "skill",
+    dir: "create-specs",
+    required: true,
+    // Los ejemplos de prompts viajan a <agent>/skills/create-specs/examples/
+    // para que la skill pueda mostrarlos dentro del proyecto generado.
+    extras: ["examples"]
+  },
+  {
+    // Skill espejo para proyectos que YA existen: misma familia, el comando
+    // /create-specs rutea entre las dos según el estado del repo. Comparte el
+    // Spec Tree Contract con create-specs, así que no duplica ejemplos: los
+    // referencia desde ahí.
+    kind: "skill",
+    dir: "create-specs-from-code",
+    required: true
+  },
+  {
+    // Biblioteca de estilos: skills/design/ con una subskill por estilo y sus
+    // commands (/design, /design-<estilo>) que leen specs/frontend/02-design.md.
+    kind: "library",
+    dir: "design",
+    required: false
+  }
+];
+async function exists(path) {
+  try {
+    const { access } = await import("fs/promises");
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function listMarkdown(dir) {
+  try {
+    const { readdir: readdir2 } = await import("fs/promises");
+    return (await readdir2(dir)).filter((f) => f.endsWith(".md"));
+  } catch {
+    return [];
+  }
+}
+async function planAgentBundle(repoRoot, bundle = AGENT_BUNDLE) {
+  const { join: join3 } = await import("path");
+  const installs = [];
+  const skillDirs = [];
+  const missingRequired = [];
+  for (const entry of bundle) {
+    const src = join3(repoRoot, "skills", entry.dir);
+    if (entry.kind === "library") {
+      if (!await exists(src)) {
+        if (entry.required) missingRequired.push(entry.dir);
+        continue;
+      }
+      installs.push({ from: src, to: `skills/${entry.dir}`, recursive: true });
+      const cmds = join3(src, "commands");
+      for (const file of await listMarkdown(cmds)) {
+        installs.push({ from: join3(cmds, file), to: `commands/${file}` });
+      }
+      continue;
+    }
+    const skill = join3(src, "SKILL.md");
+    const command = join3(src, "command.md");
+    if (!await exists(skill)) {
+      if (entry.required) missingRequired.push(entry.dir);
+      continue;
+    }
+    skillDirs.push(`skills/${entry.dir}`);
+    installs.push({ from: skill, to: `skills/${entry.dir}/SKILL.md` });
+    if (await exists(command)) {
+      installs.push({ from: command, to: `commands/${entry.dir}.md` });
+    } else if (entry.required) {
+      missingRequired.push(`${entry.dir}/command.md`);
+    }
+    for (const extra of entry.extras ?? []) {
+      const from = join3(src, extra);
+      if (await exists(from)) {
+        installs.push({
+          from,
+          to: `skills/${entry.dir}/${extra}`,
+          recursive: true
+        });
+      }
+    }
+  }
+  return { installs, skillDirs, commandDirs: ["commands"], missingRequired };
+}
+
 // src/prompts.ts
 import inquirer from "inquirer";
 async function selectScope() {
@@ -417,7 +507,7 @@ function adaptScriptToNode(script) {
   return s;
 }
 async function adaptToNodeRuntime(projectPath) {
-  const { readFile: readFile3, writeFile: writeFile2, readdir: readdir3 } = await import("fs/promises");
+  const { readFile: readFile3, writeFile: writeFile2, readdir: readdir2 } = await import("fs/promises");
   const { join: join3 } = await import("path");
   const pkgPath = join3(projectPath, "package.json");
   const pkg = JSON.parse(await readFile3(pkgPath, "utf-8"));
@@ -430,7 +520,7 @@ async function adaptToNodeRuntime(projectPath) {
   delete pkg.devDependencies["bun-types"];
   await writeFile2(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
   async function walk(dir) {
-    const entries = await readdir3(dir, { withFileTypes: true });
+    const entries = await readdir2(dir, { withFileTypes: true });
     for (const entry of entries) {
       const full = join3(dir, entry.name);
       if (entry.isDirectory()) {
@@ -459,11 +549,11 @@ async function adaptToNodeRuntime(projectPath) {
   }
 }
 async function writeRootGitignore(projectPath) {
-  const { writeFile: writeFile2, access: access2 } = await import("fs/promises");
+  const { writeFile: writeFile2, access } = await import("fs/promises");
   const { join: join3 } = await import("path");
   const gitignorePath = join3(projectPath, ".gitignore");
   try {
-    await access2(gitignorePath);
+    await access(gitignorePath);
   } catch {
     await writeFile2(
       gitignorePath,
@@ -542,59 +632,29 @@ function getCliVersion() {
 }
 var AGENT_DIRS = [".opencode", ".pi"];
 async function installAgentSkills(repoRoot, projectPath) {
-  const skill = join2(repoRoot, "skills", "create-specs", "SKILL.md");
-  const command = join2(repoRoot, "skills", "create-specs", "command.md");
-  const designDir = join2(repoRoot, "skills", "design");
-  try {
-    await access(skill);
-    await access(command);
-  } catch {
-    return;
-  }
+  const plan = await planAgentBundle(repoRoot);
   for (const agentDir of AGENT_DIRS) {
-    const skillsDir = join2(projectPath, agentDir, "skills");
-    const commandsDir = join2(projectPath, agentDir, "commands");
-    const examplesDir = join2(repoRoot, "skills", "create-specs", "examples");
-    let hasExamples = false;
-    try {
-      await access(examplesDir);
-      hasExamples = true;
-    } catch {
+    const root = join2(projectPath, agentDir);
+    for (const dir of plan.skillDirs) {
+      await mkdir2(join2(root, dir), { recursive: true });
     }
-    let hasDesign = false;
-    try {
-      await access(designDir);
-      hasDesign = true;
-    } catch {
+    for (const dir of plan.commandDirs) {
+      await mkdir2(join2(root, dir), { recursive: true });
     }
-    await mkdir2(join2(skillsDir, "create-specs"), { recursive: true });
-    await mkdir2(commandsDir, { recursive: true });
-    await cp2(skill, join2(skillsDir, "create-specs", "SKILL.md"));
-    if (hasExamples) {
-      await cp2(
-        examplesDir,
-        join2(skillsDir, "create-specs", "examples"),
-        { recursive: true }
-      );
-    }
-    await cp2(command, join2(commandsDir, "create-specs.md"));
-    if (hasDesign) {
-      await cp2(designDir, join2(skillsDir, "design"), { recursive: true });
-      try {
-        const designCommandsDir = join2(designDir, "commands");
-        const commandFiles = (await readdir2(designCommandsDir)).filter(
-          (f) => f.endsWith(".md")
-        );
-        for (const file of commandFiles) {
-          await cp2(
-            join2(designCommandsDir, file),
-            join2(commandsDir, file)
-          );
-        }
-      } catch {
-      }
+    for (const item of plan.installs) {
+      await cp2(item.from, join2(root, item.to), {
+        recursive: item.recursive === true
+      });
     }
   }
+  if (plan.missingRequired.length > 0) {
+    console.log(
+      chalk.yellow(
+        `  Skills: el bundle remoto no trae ${plan.missingRequired.join(", ")} \u2014 omitido
+`
+      )
+    );
+  }
 }
 async function readTemplatePostInit(dir) {
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fwinit",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "CLI para crear proyectos desde templates",
   "type": "module",
   "bin": {