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

package/bin/cli.js

@@ -8,19 +8,19 @@ const args = process.argv.slice(2);
 const command = args[0];
 
 function printUsage() {
-  console.log('Usage:');
-  console.log('  spec-first-copilot init --name=<project-name> [--target=<path>]');
-  console.log('  spec-first-copilot update [--target=<path>] [--force]');
+  console.log('Uso:');
+  console.log('  spec-first-copilot init --name=<nome-do-projeto> [--target=<caminho>]');
+  console.log('  spec-first-copilot update [--target=<caminho>] [--force]');
   console.log('');
-  console.log('Commands:');
-  console.log('  init     Create a new spec-first project');
-  console.log('  update   Update an existing project with new framework files');
-  console.log('           (adds missing files, updates framework files like skills/adapters/agents)');
+  console.log('Comandos:');
+  console.log('  init     Cria um novo projeto spec-first');
+  console.log('  update   Atualiza projeto existente com arquivos novos do framework');
+  console.log('           (adiciona faltantes, atualiza skills/adapters/agents/templates)');
   console.log('');
-  console.log('Options:');
-  console.log('  --name=<name>    Project name (required for init)');
-  console.log('  --target=<path>  Target directory (defaults to ./<name> for init, cwd for update)');
-  console.log('  --force          Force update all files, not just framework files (use with caution)');
+  console.log('Opções:');
+  console.log('  --name=<nome>      Nome do projeto (obrigatório no init)');
+  console.log('  --target=<path>    Diretório destino (default: ./<nome> no init, cwd no update)');
+  console.log('  --force            Força atualizar TODOS arquivos, não só os do framework (cuidado)');
 }
 
 function parseArgs(args) {
@@ -40,7 +40,7 @@ if (command === 'init') {
   const opts = parseArgs(args.slice(1));
 
   if (!opts.name) {
-    console.error('Error: --name is required.\n');
+    console.error('Erro: --name é obrigatório.\n');
     printUsage();
     process.exit(1);
   }
@@ -64,7 +64,7 @@ if (command === 'init') {
 } else {
   printUsage();
   if (command) {
-    console.error(`\nUnknown command: "${command}"`);
+    console.error(`\nComando desconhecido: "${command}"`);
   }
   process.exit(command ? 1 : 0);
 }

package/lib/init.js

@@ -42,19 +42,31 @@ function init({ name, templatesDir, targetDir }) {
   const dest = targetDir || path.resolve(process.cwd(), name);
 
   const existed = fs.existsSync(dest);
-  console.log(`\n${existed ? 'Initializing' : 'Creating'} project "${name}" in ${dest}\n`);
+  console.log(`\n${existed ? 'Inicializando' : 'Criando'} projeto "${name}" em ${dest}\n`);
 
   const replacements = { [PLACEHOLDER]: name };
   copyDir(templatesDir, dest, replacements);
   patchProjectName(dest, name);
 
-  console.log(`Done! Project "${name}" is ready.`);
-  console.log('\nNext steps:');
+  console.log(`Pronto! Projeto "${name}" criado.`);
+  console.log('\nPróximos passos:');
   console.log(`  1. cd ${name}`);
-  console.log('  2. Create a folder in workspace/Input/ with your project files (e.g. workspace/Input/my_app/)');
-  console.log('  3. (Optional) Copy sfw.config.yml.example to sfw.config.yml and configure your backend');
-  console.log('  4. Open VS Code with Copilot Chat and run: /sf-start <folder-name>');
-  console.log('     Framework detects first-run automatically (creates docs/) vs feature (updates docs/).');
+  console.log('  2. Crie uma pasta em workspace/Input/ com os insumos do seu projeto');
+  console.log('     (ex: workspace/Input/meu_app/requisitos.md)');
+  console.log('');
+  console.log('  3. (Opcional) Configure o backend de input/output:');
+  console.log('       cp sfw.config.yml.example sfw.config.yml');
+  console.log('     Sem isso, o framework roda 100% local (sem Confluence/etc.)');
+  console.log('');
+  console.log('  4. (Opcional, se vai usar Confluence) Prepare o ambiente ANTES de abrir o VS Code:');
+  console.log('       node .github/scripts/bootstrap-confluence.js');
+  console.log('     Valida uvx, coleta credenciais, gera .mcp.json e pré-cacheia o MCP.');
+  console.log('     Evita o ciclo "abrir Copilot → faltar dep → reiniciar VS Code".');
+  console.log('');
+  console.log('  5. Abra o VS Code com Copilot Chat e rode:');
+  console.log('       /sf-start <nome-da-pasta-em-Input>');
+  console.log('     O framework detecta first-run automaticamente (cria docs/) vs feature');
+  console.log('     (atualiza docs/ via merge).');
   console.log('');
 }
 

package/lib/update.js

@@ -20,36 +20,36 @@ function update({ templatesDir, targetDir, force }) {
   const dest = targetDir || process.cwd();
 
   if (!fs.existsSync(dest)) {
-    console.error(`Error: directory "${dest}" does not exist.`);
-    console.error('Run "spec-first-copilot init --name=<name>" first to create a project.');
+    console.error(`Erro: diretório "${dest}" não existe.`);
+    console.error('Rode "spec-first-copilot init --name=<nome>" primeiro pra criar o projeto.');
     process.exit(1);
   }
 
   const githubDir = path.join(dest, '.github');
   if (!fs.existsSync(githubDir)) {
-    console.error('Error: not a spec-first project (missing .github/ directory).');
-    console.error('Run "spec-first-copilot init --name=<name>" first.');
+    console.error('Erro: não é um projeto spec-first (pasta .github/ não encontrada).');
+    console.error('Rode "spec-first-copilot init --name=<nome>" primeiro.');
     process.exit(1);
   }
 
-  console.log(`\nUpdating project in ${dest}\n`);
+  console.log(`\nAtualizando projeto em ${dest}\n`);
 
   const stats = { added: [], updated: [], skipped: 0 };
   syncDir(templatesDir, dest, force, stats, dest);
 
   console.log('');
   if (stats.added.length > 0) {
-    console.log(`Added (${stats.added.length}):`);
+    console.log(`Adicionados (${stats.added.length}):`);
     for (const f of stats.added) console.log(`  + ${f}`);
   }
   if (stats.updated.length > 0) {
-    console.log(`Updated (${stats.updated.length}):`);
+    console.log(`Atualizados (${stats.updated.length}):`);
     for (const f of stats.updated) console.log(`  ~ ${f}`);
   }
   if (stats.added.length === 0 && stats.updated.length === 0) {
-    console.log('Already up to date — no new files to add.');
+    console.log('Já está atualizado — nenhum arquivo novo pra adicionar.');
   } else {
-    console.log(`\n${stats.added.length} added, ${stats.updated.length} updated, ${stats.skipped} unchanged`);
+    console.log(`\n${stats.added.length} adicionado(s), ${stats.updated.length} atualizado(s), ${stats.skipped} inalterado(s)`);
   }
 
   console.log('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-first-copilot",
-  "version": "0.6.0-beta.7",
+  "version": "0.6.0-beta.9",
   "description": "Spec-first workflow kit for GitHub Copilot — AI-driven development with specs, not guesswork",
   "bin": {
     "spec-first-copilot": "bin/cli.js"

package/templates/.github/CHANGELOG.md

@@ -8,6 +8,67 @@
 
 ---
 
+## 0.6.0-beta.9 (2026-04-13)
+
+### CLI em pt-BR + dica de bootstrap-confluence no init
+
+Mensagens do CLI (`init` e `update`) traduzidas para pt-BR — usuário final é o público.
+
+Mensagem do `init` reescrita para deixar **explícito o passo opcional de pré-setup
+do Confluence**:
+
+```
+Pronto! Projeto "X" criado.
+
+Próximos passos:
+  1. cd X
+  2. Crie uma pasta em workspace/Input/ com os insumos do seu projeto
+  3. (Opcional) Configure o backend de input/output:
+       cp sfw.config.yml.example sfw.config.yml
+  4. (Opcional, se vai usar Confluence) Prepare o ambiente ANTES de abrir o VS Code:
+       node .github/scripts/bootstrap-confluence.js
+  5. Abra o VS Code com Copilot Chat e rode: /sf-start <nome-da-pasta>
+```
+
+O passo 4 era invisível antes — só aparecia inline na "Dica" do skill `/sf-mcp`.
+Agora aparece logo no fim do `init`, no momento exato em que o usuário vai decidir
+se prepara o Confluence ou não.
+
+---
+
+## 0.6.0-beta.8 (2026-04-13)
+
+### Novo: `bootstrap-confluence.js` (opcional, pré-Copilot)
+
+Script Node cross-platform em `.github/scripts/bootstrap-confluence.js` que prepara
+o ambiente para o backend Confluence **antes** de abrir o VS Code com Copilot. Evita
+o ciclo "abrir Copilot → descobrir que falta `uvx` ou credenciais → sair, ajustar,
+reiniciar".
+
+O que faz:
+1. Valida `uvx` instalado (orienta install se faltar — não instala automaticamente)
+2. Coleta URL do Confluence, email Atlassian e API Token (com link pra gerar o token)
+3. Gera/mescla `.mcp.json` preservando outras entries de MCP existentes
+4. Garante `.mcp.json` no `.gitignore`
+5. Pré-cacheia o pacote `mcp-atlassian` via `uvx` (100+ deps no primeiro uso)
+
+Depois é só abrir o VS Code e rodar `/sf-mcp confluence` — vai direto pra descoberta
+da árvore no Confluence, sem reiniciar.
+
+Uso: `node .github/scripts/bootstrap-confluence.js`
+Opcional — `/sf-mcp confluence` sozinho também cobre esses passos, mas exige reiniciar
+VS Code após criar `.mcp.json`.
+
+Skill `/sf-mcp` ganhou nota referenciando o script como atalho recomendado.
+
+### Primeira release sincronizada automaticamente
+
+Primeira release onde o conteúdo compartilhado entre kits veio direto do script
+`npm run sync-kits` no repo SFW — sem cópia manual. Zero drift entre Claude e Copilot
+validado antes do publish.
+
+---
+
 ## 0.6.0-beta.7 (2026-04-13)
 
 ### Fix: 27 referências a slash-commands faltando prefix `sf-`

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

@@ -0,0 +1,223 @@
+#!/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);
+});

package/templates/.github/skills/sf-mcp/SKILL.md

@@ -15,6 +15,18 @@ Setup interativo de backend externo. Idempotente — pode rodar múltiplas vezes
 /sf-mcp confluence test      ← só testa conexão
 ```
 
+> **Dica**: para evitar o ciclo "abrir VS Code → descobrir que falta uvx ou credenciais →
+> sair, ajustar, reiniciar", há um script opcional que prepara o ambiente antes:
+>
+> ```bash
+> node .github/scripts/bootstrap-confluence.js
+> ```
+>
+> Ele valida `uvx`, coleta credenciais, gera `.mcp.json` e pré-cacheia o MCP. Depois
+> você abre o Copilot Chat e `/sf-mcp confluence` só descobre a árvore do projeto. Uso
+> opcional — `/sf-mcp confluence` sozinho também cobre esses passos, mas demanda reiniciar
+> o VS Code após gerar `.mcp.json` (MCPs só sobem no startup).
+
 ---
 
 ## Provider: Confluence