maestro-bundle 1.1.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maestro-bundle",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Instala bundles de governança para projetos com AI agents. Um comando, tudo configurado.",
   "bin": {
     "maestro-bundle": "./src/cli.mjs"

package/src/cli.mjs

@@ -69,9 +69,9 @@ const EDITORS = {
   },
   cursor: {
     name: "Cursor",
-    instructionsFile: null,              // Cursor lê AGENTS.md + .cursor/rules/
-    skillsDir: null,
-    rulesDir: ".cursor/rules",           // Rules como .mdc com frontmatter
+    instructionsFile: null,              // Cursor lê AGENTS.md na raiz
+    skillsDir: ".cursor/skills",         // Skills como SKILL.md (mesmo formato do Claude)
+    rulesDir: null,                      // Não usar rules, usar skills
     needsAgentsMd: true,                 // Cursor lê AGENTS.md na raiz
   },
   codex: {
@@ -116,8 +116,8 @@ function showHelp() {
   }
   console.log("");
   console.log(chalk.dim("  Editores:"));
-  console.log(`    ${chalk.yellow("claude".padEnd(12))} CLAUDE.md + .claude/skills/ + .claude/rules/`);
-  console.log(`    ${chalk.yellow("cursor".padEnd(12))} AGENTS.md + .cursor/rules/*.mdc`);
+  console.log(`    ${chalk.yellow("claude".padEnd(12))} CLAUDE.md + .claude/skills/<nome>/SKILL.md`);
+  console.log(`    ${chalk.yellow("cursor".padEnd(12))} AGENTS.md + .cursor/skills/<nome>/SKILL.md`);
   console.log(`    ${chalk.yellow("codex".padEnd(12))} AGENTS.md (tudo em um arquivo)`);
   console.log(`    ${chalk.yellow("copilot".padEnd(12))} .github/copilot-instructions.md + .github/instructions/`);
   console.log(`    ${chalk.yellow("windsurf".padEnd(12))} .windsurfrules (tudo em um arquivo)`);
@@ -205,21 +205,7 @@ function installForEditor(editorKey, agentsMd, skills, targetDir) {
     for (const skill of skills) {
       const content = readFileSync(join(skill.dir, "SKILL.md"), "utf-8");
 
-      if (editorKey === "cursor") {
-        // Cursor: .mdc com frontmatter (description + globs)
-        // Extrair frontmatter existente e converter
-        const parsed = parseFrontmatter(content);
-        const cursorContent = [
-          "---",
-          `description: "${parsed.description || skill.name}"`,
-          `alwaysApply: false`,
-          "---",
-          "",
-          parsed.body,
-        ].join("\n");
-        writeFileSync(join(rulesPath, `${skill.name}.mdc`), cursorContent);
-
-      } else if (editorKey === "copilot") {
+      if (editorKey === "copilot") {
         // Copilot: .instructions.md
         writeFileSync(join(rulesPath, `${skill.name}.instructions.md`), content);
 
@@ -324,38 +310,97 @@ async function main() {
   }
   spinner2.succeed(`${skills.length} skills canônicas em skills/`);
 
-  // 3. .spec/constitution.md
-  const spinner3 = ora("Instalando Spec Kit constitution").start();
-  const specSrc = join(bundleDir, ".spec");
-  ensureDir(join(targetDir, ".spec"));
-  copyDir(specSrc, join(targetDir, ".spec"));
-  spinner3.succeed(".spec/constitution.md instalado");
-
-  // 4. References
-  const spinner4 = ora("Instalando references").start();
+  // 3. References
+  const spinner3 = ora("Instalando references").start();
   const refsSrc = join(bundleDir, "references");
   ensureDir(join(targetDir, "references"));
   if (existsSync(refsSrc)) {
     copyDir(refsSrc, join(targetDir, "references"));
   }
-  spinner4.succeed("references/ pronto");
-
-  // 5. GitHub Spec Kit
-  const spinner5 = ora("Verificando GitHub Spec Kit").start();
+  spinner3.succeed("references/ pronto");
+
+  // 4. GitHub Spec Kit — instalar CLI + inicializar no projeto
+  // Mapear editor para flag --ai do specify
+  const aiFlags = {
+    claude: "claude",
+    cursor: "cursor",
+    codex: "codex",
+    copilot: "copilot",
+    windsurf: "windsurf",
+  };
+  // Usar o primeiro editor como --ai (ou claude como default)
+  const primaryEditor = editorsToInstall[0];
+  const aiFlag = aiFlags[primaryEditor] || "claude";
+
+  // 4a. Instalar specify-cli se não tiver
+  const spinner4 = ora("Verificando GitHub Spec Kit (specify-cli)").start();
+  let specifyInstalled = false;
   try {
     execSync("specify --version", { stdio: "ignore" });
-    spinner5.succeed("Spec Kit disponível");
+    specifyInstalled = true;
+    spinner4.succeed("specify-cli já instalado");
   } catch {
-    spinner5.info("Spec Kit não encontrado");
-    const spinner5b = ora("Instalando GitHub Spec Kit...").start();
+    spinner4.info("specify-cli não encontrado");
+    const spinner4b = ora("Instalando specify-cli...").start();
     try {
       execSync("uv tool install specify-cli --from git+https://github.com/github/spec-kit.git", {
         stdio: "ignore", timeout: 120000,
       });
-      spinner5b.succeed("Spec Kit instalado");
+      specifyInstalled = true;
+      spinner4b.succeed("specify-cli instalado");
     } catch {
-      spinner5b.warn("Instale manualmente:");
-      console.log(chalk.dim("    uv tool install specify-cli --from git+https://github.com/github/spec-kit.git"));
+      try {
+        execSync("pip install specify-cli", { stdio: "ignore", timeout: 60000 });
+        specifyInstalled = true;
+        spinner4b.succeed("specify-cli instalado via pip");
+      } catch {
+        spinner4b.warn("Não foi possível instalar. Instale manualmente:");
+        console.log(chalk.dim("    uv tool install specify-cli --from git+https://github.com/github/spec-kit.git"));
+      }
+    }
+  }
+
+  // 4b. Rodar specify init no projeto para criar .specify/ e registrar /speckit.* commands
+  if (specifyInstalled) {
+    const spinner4c = ora(`Inicializando Spec Kit no projeto (--ai ${aiFlag})`).start();
+    const specifyEnv = { ...process.env, PYTHONIOENCODING: "utf-8", PYTHONUTF8: "1" };
+    let specInitOk = false;
+    const initCmds = [
+      `specify init --here --ai ${aiFlag}`,
+      `specify init . --ai ${aiFlag}`,
+      `specify init --here --ai ${aiFlag} --no-git`,
+    ];
+    for (const cmd of initCmds) {
+      try {
+        execSync(cmd, { stdio: "ignore", timeout: 30000, cwd: targetDir, env: specifyEnv });
+        specInitOk = true;
+        break;
+      } catch { /* try next */ }
+    }
+    if (specInitOk) {
+      spinner4c.succeed(`Spec Kit inicializado (/speckit.* commands disponíveis)`);
+    } else {
+      spinner4c.warn("Inicialize manualmente no terminal:");
+      console.log(chalk.dim(`    cd ${targetDir}`));
+      console.log(chalk.dim(`    specify init --here --ai ${aiFlag}`));
+    }
+
+    // 4c. Copiar constitution.md do bundle para dentro do .specify/memory/
+    const specifyMemoryDir = join(targetDir, ".specify", "memory");
+    const bundleConstitution = join(bundleDir, ".spec", "constitution.md");
+    if (existsSync(bundleConstitution)) {
+      ensureDir(specifyMemoryDir);
+      const constitutionDest = join(specifyMemoryDir, "constitution.md");
+      // Append os princípios do bundle ao constitution gerado pelo specify
+      if (existsSync(constitutionDest)) {
+        const existing = readFileSync(constitutionDest, "utf-8");
+        const bundleContent = readFileSync(bundleConstitution, "utf-8");
+        writeFileSync(constitutionDest, existing + "\n\n---\n\n" + bundleContent);
+      } else {
+        cpSync(bundleConstitution, constitutionDest);
+      }
+      const spinner4d = ora("Constitution do bundle integrado ao Spec Kit").start();
+      spinner4d.succeed("Constitution do bundle integrado ao Spec Kit");
     }
   }
 
@@ -373,7 +418,7 @@ async function main() {
       console.log(`      ${chalk.cyan(".claude/skills/")} (${skills.length} skills com SKILL.md)`);
     } else if (editorKey === "cursor") {
       console.log(`      ${chalk.cyan("AGENTS.md")} (instruções gerais)`);
-      console.log(`      ${chalk.cyan(".cursor/rules/")} (${skills.length} rules .mdc)`);
+      console.log(`      ${chalk.cyan(".cursor/skills/")} (${skills.length} skills com SKILL.md)`);
     } else if (editorKey === "codex") {
       console.log(`      ${chalk.cyan("AGENTS.md")} (tudo em um arquivo)`);
     } else if (editorKey === "copilot") {
@@ -384,12 +429,17 @@ async function main() {
     }
   }
   console.log(`    ${chalk.cyan("skills/")} (${skills.length} canônicas para Deep Agents)`);
-  console.log(`    ${chalk.cyan(".spec/constitution.md")} (GitHub Spec Kit SDD)`);
+  console.log(`    ${chalk.cyan(".specify/")} (GitHub Spec Kit — /speckit.* commands)`);
+  console.log("");
+  console.log("  Comandos SDD disponíveis no editor:");
+  console.log(`    ${chalk.cyan("/speckit.constitution")}  — Definir princípios do projeto`);
+  console.log(`    ${chalk.cyan("/speckit.specify")}       — Especificar O QUE e POR QUÊ`);
+  console.log(`    ${chalk.cyan("/speckit.plan")}          — Planejar arquitetura e stack`);
+  console.log(`    ${chalk.cyan("/speckit.tasks")}         — Quebrar em tasks atômicas`);
+  console.log(`    ${chalk.cyan("/speckit.implement")}     — Executar as tasks`);
   console.log("");
-  console.log("  Próximos passos:");
-  console.log("    1. Abra o projeto no seu editor AI");
-  console.log("    2. O agente já conhece os padrões");
-  console.log(`    3. Nova demanda? ${chalk.cyan("/speckit.specify")}`);
+  console.log("  Próximo passo:");
+  console.log("    Abra o projeto no editor AI e use " + chalk.cyan("/speckit.specify") + " para começar");
   console.log("");
 }