spec-first-copilot 0.6.0-beta.9 → 0.7.0

package/templates/.github/scripts/bootstrap-confluence.js

@@ -1,223 +1,289 @@
-#!/usr/bin/env node
-// bootstrap-confluence.js — prepara o ambiente para o backend Confluence do SFW.
-//
-// Propósito: tirar fricção ANTES de abrir Claude Code. Depois de rodar este script,
-// o /sf-mcp confluence vai só descobrir a árvore do projeto no Confluence — credenciais
-// e dependências já estarão prontas.
-//
-// Uso:
-//   node .github/scripts/bootstrap-confluence.js
-//
-// O que faz:
-//   1. Verifica se `uvx` está instalado (roda o MCP Atlassian)
-//   2. Coleta credenciais Atlassian interativamente (email + token + URL)
-//   3. Gera/mescla `.mcp.json` com entry `atlassian` (preserva outras entries)
-//   4. Garante que `.mcp.json` está no `.gitignore`
-//   5. Pré-cacheia `uvx mcp-atlassian` (evita delay no primeiro boot do Claude)
-//
-// O que NÃO faz (fica pro /sf-mcp confluence dentro do Claude):
-//   - Validar credenciais contra o servidor
-//   - Descobrir páginas root do projeto
-//   - Gerar `sfw.config.yml`
-
-const fs = require("fs");
-const path = require("path");
-const readline = require("readline");
-const { execSync, spawn } = require("child_process");
-
-const CWD = process.cwd();
-
-function log(msg) {
-  console.log(msg);
-}
-
-function err(msg) {
-  console.error(`✗ ${msg}`);
-}
-
-function ok(msg) {
-  console.log(`✓ ${msg}`);
-}
-
-function hr() {
-  console.log("─".repeat(60));
-}
-
-function prompt(question) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-  });
-}
-
-function hasCommand(cmd) {
-  try {
-    execSync(`${cmd} --version`, { stdio: "ignore" });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function loadJson(filePath) {
-  if (!fs.existsSync(filePath)) return null;
-  try {
-    return JSON.parse(fs.readFileSync(filePath, "utf8"));
-  } catch (e) {
-    err(`JSON inválido em ${filePath}: ${e.message}`);
-    process.exit(1);
-  }
-}
-
-function saveJson(filePath, data) {
-  fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf8");
-}
-
-function ensureGitignore(entry) {
-  const giPath = path.join(CWD, ".gitignore");
-  let content = "";
-  if (fs.existsSync(giPath)) {
-    content = fs.readFileSync(giPath, "utf8");
-    const lines = content.split(/\r?\n/).map((l) => l.trim());
-    if (lines.includes(entry)) return false; // já tem
-  }
-  const sep = content && !content.endsWith("\n") ? "\n" : "";
-  fs.appendFileSync(giPath, `${sep}${entry}\n`, "utf8");
-  return true;
-}
-
-function validateUrl(url) {
-  return /^https:\/\/[\w.-]+\.atlassian\.net\/wiki\/?$/.test(url);
-}
-
-function validateEmail(email) {
-  return /^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(email);
-}
-
-// ---- Main flow ----
-
-(async function main() {
-  log("");
-  log("SFW — Bootstrap Confluence");
-  hr();
-
-  // 1. Verificar uvx
-  log("1. Verificando dependências...");
-  if (!hasCommand("uvx")) {
-    err("`uvx` não encontrado no PATH.");
-    log("");
-    log("   Instale com:");
-    log("     pip install uv        (Python 3.10+ necessário)");
-    log("");
-    log("   Ou via Homebrew (macOS):");
-    log("     brew install uv");
-    log("");
-    log("   Depois rode este script novamente.");
-    process.exit(1);
-  }
-  ok("uvx disponível");
-
-  // 2. Coletar credenciais
-  log("");
-  log("2. Credenciais Atlassian");
-  log("");
-  log("   → URL do Confluence: abra seu Confluence no browser e copie a URL base.");
-  log("     Ex: https://empresa.atlassian.net/wiki");
-  log("");
-  let url = "";
-  while (!validateUrl(url)) {
-    url = await prompt("     URL: ");
-    if (!validateUrl(url)) {
-      err(`URL inválida. Formato esperado: https://{empresa}.atlassian.net/wiki`);
-    }
-  }
-  if (url.endsWith("/")) url = url.slice(0, -1);
-
-  log("");
-  log("   → Email da conta Atlassian (o que você usa pra logar).");
-  log("");
-  let email = "";
-  while (!validateEmail(email)) {
-    email = await prompt("     Email: ");
-    if (!validateEmail(email)) err("Email inválido.");
-  }
-
-  log("");
-  log("   → API Token.");
-  log("     Gere em: https://id.atlassian.com/manage-profile/security/api-tokens");
-  log("     Clique em 'Create API token' → dê um nome (ex: 'sfw-local') → copie agora");
-  log("     (o token só aparece uma vez, depois some).");
-  log("");
-  let token = "";
-  while (!token) {
-    token = await prompt("     Token: ");
-    if (!token) err("Token não pode estar vazio.");
-  }
-
-  // 3. Gerar/mesclar .mcp.json
-  log("");
-  log("3. Gerando .mcp.json...");
-  const mcpPath = path.join(CWD, ".mcp.json");
-  const existing = loadJson(mcpPath) || {};
-  if (!existing.mcpServers) existing.mcpServers = {};
-
-  const hadEntry = !!existing.mcpServers.atlassian;
-  existing.mcpServers.atlassian = {
-    command: "uvx",
-    args: ["mcp-atlassian"],
-    env: {
-      CONFLUENCE_URL: url,
-      CONFLUENCE_USERNAME: email,
-      CONFLUENCE_API_TOKEN: token,
-    },
-  };
-  saveJson(mcpPath, existing);
-  ok(`.mcp.json ${hadEntry ? "atualizado" : "criado"} (entry: atlassian)`);
-
-  // 4. Garantir .gitignore
-  const added = ensureGitignore(".mcp.json");
-  if (added) ok(".mcp.json adicionado ao .gitignore");
-  else ok(".mcp.json já estava no .gitignore");
-
-  // 5. Pré-cachear MCP
-  log("");
-  log("4. Pré-cacheando mcp-atlassian (baixa 100+ deps na primeira vez, pode demorar 1-3min)...");
-  await new Promise((resolve) => {
-    const child = spawn("uvx", ["mcp-atlassian", "--help"], { stdio: "ignore", shell: true });
-    const timeout = setTimeout(() => {
-      child.kill();
-      log("   (timeout após 5min — segue adiante, Claude pode retomar o download)");
-      resolve();
-    }, 5 * 60 * 1000);
-    child.on("close", (code) => {
-      clearTimeout(timeout);
-      if (code === 0) ok("mcp-atlassian em cache local");
-      else log(`   (uvx retornou código ${code} — pode ser normal, --help às vezes sai != 0)`);
-      resolve();
-    });
-    child.on("error", (e) => {
-      clearTimeout(timeout);
-      err(`Falha ao rodar uvx: ${e.message}`);
-      resolve();
-    });
-  });
-
-  // Final
-  log("");
-  hr();
-  ok("Bootstrap concluído.");
-  log("");
-  log("Próximos passos:");
-  log("  1. Abra o Claude Code neste diretório");
-  log("  2. Rode:  /sf-mcp confluence");
-  log("     → vai descobrir a árvore do seu projeto no Confluence e gerar sfw.config.yml");
-  log("");
-  log("Se reiniciar o Claude Code for necessário (após este setup), ele vai pedir.");
-  log("");
-})().catch((e) => {
-  err(`Erro inesperado: ${e.message}`);
-  process.exit(1);
-});
+#!/usr/bin/env node
+// bootstrap-confluence.js — prepara o ambiente para o backend Confluence do SFW.
+//
+// Propósito: tirar fricção ANTES de abrir Claude Code. Depois de rodar este script,
+// o /sf-mcp confluence vai só descobrir a árvore do projeto no Confluence — credenciais
+// e dependências já estarão prontas.
+//
+// Uso:
+//   node .github/scripts/bootstrap-confluence.js
+//
+// O que faz:
+//   1. Verifica se `uvx` está instalado (roda o MCP Atlassian)
+//   2. Coleta credenciais Atlassian interativamente (email + token + URL)
+//   3. Gera/mescla `.mcp.json` com entry `atlassian` (preserva outras entries)
+//   4. Garante que `.mcp.json` está no `.gitignore`
+//   5. Pré-cacheia `uvx mcp-atlassian` (evita delay no primeiro boot do Claude)
+//
+// O que NÃO faz (fica pro /sf-mcp confluence dentro do Claude):
+//   - Validar credenciais contra o servidor
+//   - Descobrir páginas root do projeto
+//   - Gerar `sfw.config.yml`
+
+const fs = require("fs");
+const path = require("path");
+const readline = require("readline");
+const { execSync, spawn } = require("child_process");
+
+const CWD = process.cwd();
+
+function log(msg) {
+  console.log(msg);
+}
+
+function err(msg) {
+  console.error(`✗ ${msg}`);
+}
+
+function ok(msg) {
+  console.log(`✓ ${msg}`);
+}
+
+function hr() {
+  console.log("─".repeat(60));
+}
+
+function prompt(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+// Pergunta yes/no com default "y". Aceita ENTER, y, yes, s, sim (não case-sensitive).
+async function confirm(question) {
+  const answer = (await prompt(`${question} [S/n]: `)).toLowerCase();
+  if (answer === "" || answer === "s" || answer === "sim" || answer === "y" || answer === "yes") {
+    return true;
+  }
+  return false;
+}
+
+function maskToken(token) {
+  if (!token || token.length < 12) return "****";
+  return token.slice(0, 4) + "…" + token.slice(-4);
+}
+
+function hasCommand(cmd) {
+  try {
+    execSync(`${cmd} --version`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function loadJson(filePath) {
+  if (!fs.existsSync(filePath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+  } catch (e) {
+    err(`JSON inválido em ${filePath}: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+function saveJson(filePath, data) {
+  fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf8");
+}
+
+function ensureGitignore(entry) {
+  const giPath = path.join(CWD, ".gitignore");
+  let content = "";
+  if (fs.existsSync(giPath)) {
+    content = fs.readFileSync(giPath, "utf8");
+    const lines = content.split(/\r?\n/).map((l) => l.trim());
+    if (lines.includes(entry)) return false; // já tem
+  }
+  const sep = content && !content.endsWith("\n") ? "\n" : "";
+  fs.appendFileSync(giPath, `${sep}${entry}\n`, "utf8");
+  return true;
+}
+
+function validateUrl(url) {
+  return /^https:\/\/[\w.-]+\.atlassian\.net\/wiki\/?$/.test(url);
+}
+
+function validateEmail(email) {
+  return /^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(email);
+}
+
+// ---- Main flow ----
+
+(async function main() {
+  log("");
+  log("SFW — Bootstrap Confluence");
+  hr();
+
+  // 1. Verificar uvx
+  log("1. Verificando dependências...");
+  if (!hasCommand("uvx")) {
+    err("`uvx` não encontrado no PATH.");
+    log("");
+    log("   Instale com:");
+    log("     pip install uv        (Python 3.10+ necessário)");
+    log("");
+    log("   Ou via Homebrew (macOS):");
+    log("     brew install uv");
+    log("");
+    log("   Depois rode este script novamente.");
+    process.exit(1);
+  }
+  ok("uvx disponível");
+
+  // 2. Detectar .mcp.json existente e reusar credenciais válidas
+  log("");
+  log("2. Credenciais Atlassian");
+  log("");
+
+  const mcpPath = path.join(CWD, ".mcp.json");
+  const existing = loadJson(mcpPath) || {};
+  if (!existing.mcpServers) existing.mcpServers = {};
+  const existingAtlassian = existing.mcpServers.atlassian;
+  const existingEnv = (existingAtlassian && existingAtlassian.env) || {};
+
+  if (existingAtlassian) {
+    log("   Detectei entry `atlassian` existente em .mcp.json — vou reusar o que já está válido.");
+    log("");
+  }
+
+  // URL
+  let url = existingEnv.CONFLUENCE_URL || "";
+  if (url && validateUrl(url)) {
+    log(`   URL atual: ${url}`);
+    if (await confirm("     Manter esta URL?")) {
+      ok("URL mantida");
+    } else {
+      url = "";
+    }
+    log("");
+  }
+  if (!url) {
+    log("   → URL do Confluence: abra seu Confluence no browser e copie a URL base.");
+    log("     Ex: https://empresa.atlassian.net/wiki");
+    log("");
+    while (!validateUrl(url)) {
+      url = await prompt("     URL: ");
+      if (!validateUrl(url)) {
+        err(`URL inválida. Formato esperado: https://{empresa}.atlassian.net/wiki`);
+      }
+    }
+    if (url.endsWith("/")) url = url.slice(0, -1);
+  }
+
+  // Email
+  let email = existingEnv.CONFLUENCE_USERNAME || "";
+  log("");
+  if (email && validateEmail(email)) {
+    log(`   Email atual: ${email}`);
+    if (await confirm("     Manter este email?")) {
+      ok("Email mantido");
+    } else {
+      email = "";
+    }
+    log("");
+  }
+  if (!email) {
+    log("   → Email da conta Atlassian (o que você usa pra logar).");
+    log("");
+    while (!validateEmail(email)) {
+      email = await prompt("     Email: ");
+      if (!validateEmail(email)) err("Email inválido.");
+    }
+  }
+
+  // Token
+  let token = existingEnv.CONFLUENCE_API_TOKEN || "";
+  log("");
+  if (token) {
+    log(`   Token atual: ${maskToken(token)}`);
+    if (await confirm("     Manter este token?")) {
+      ok("Token mantido");
+    } else {
+      token = "";
+    }
+    log("");
+  }
+  if (!token) {
+    log("   → API Token.");
+    log("     Gere em: https://id.atlassian.com/manage-profile/security/api-tokens");
+    log("     Clique em 'Create API token' → dê um nome (ex: 'sfw-local') → copie agora");
+    log("     (o token só aparece uma vez, depois some).");
+    log("");
+    while (!token) {
+      token = await prompt("     Token: ");
+      if (!token) err("Token não pode estar vazio.");
+    }
+  }
+
+  // 3. Gerar/mesclar .mcp.json (só escreve se algo mudou)
+  log("");
+  log("3. Atualizando .mcp.json...");
+  const nextEntry = {
+    command: "uvx",
+    args: ["mcp-atlassian"],
+    env: {
+      CONFLUENCE_URL: url,
+      CONFLUENCE_USERNAME: email,
+      CONFLUENCE_API_TOKEN: token,
+    },
+  };
+  const unchanged =
+    existingAtlassian &&
+    JSON.stringify(existingAtlassian) === JSON.stringify(nextEntry);
+
+  if (unchanged) {
+    ok(".mcp.json já estava correto (entry: atlassian) — nada a escrever");
+  } else {
+    existing.mcpServers.atlassian = nextEntry;
+    saveJson(mcpPath, existing);
+    ok(`.mcp.json ${existingAtlassian ? "atualizado" : "criado"} (entry: atlassian)`);
+  }
+
+  // 4. Garantir .gitignore
+  const added = ensureGitignore(".mcp.json");
+  if (added) ok(".mcp.json adicionado ao .gitignore");
+  else ok(".mcp.json já estava no .gitignore");
+
+  // 5. Pré-cachear MCP
+  log("");
+  log("4. Pré-cacheando mcp-atlassian (baixa 100+ deps na primeira vez, pode demorar 1-3min)...");
+  await new Promise((resolve) => {
+    const child = spawn("uvx", ["mcp-atlassian", "--help"], { stdio: "ignore", shell: true });
+    const timeout = setTimeout(() => {
+      child.kill();
+      log("   (timeout após 5min — segue adiante, Claude pode retomar o download)");
+      resolve();
+    }, 5 * 60 * 1000);
+    child.on("close", (code) => {
+      clearTimeout(timeout);
+      if (code === 0) ok("mcp-atlassian em cache local");
+      else log(`   (uvx retornou código ${code} — pode ser normal, --help às vezes sai != 0)`);
+      resolve();
+    });
+    child.on("error", (e) => {
+      clearTimeout(timeout);
+      err(`Falha ao rodar uvx: ${e.message}`);
+      resolve();
+    });
+  });
+
+  // Final
+  log("");
+  hr();
+  ok("Bootstrap concluído.");
+  log("");
+  log("Próximos passos:");
+  log("  1. Abra o Claude Code neste diretório");
+  log("  2. Rode:  /sf-mcp confluence");
+  log("     → vai descobrir a árvore do seu projeto no Confluence e gerar sfw.config.yml");
+  log("");
+  log("Se reiniciar o Claude Code for necessário (após este setup), ele vai pedir.");
+  log("");
+})().catch((e) => {
+  err(`Erro inesperado: ${e.message}`);
+  process.exit(1);
+});