spec-first-copilot 0.7.0-beta.1 → 0.7.0

package/lib/init.js

@@ -1,92 +1,92 @@
-const fs = require('fs');
-const path = require('path');
-
-const PLACEHOLDER = '{{PROJECT_NAME}}';
-
-function copyDir(src, dest, replacements) {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const srcPath = path.join(src, entry.name);
-    // Rename _gitignore → .gitignore (npm strips .gitignore from packages)
-    const destName = entry.name === '_gitignore' ? '.gitignore' : entry.name;
-    const destPath = path.join(dest, destName);
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath, replacements);
-    } else {
-      copyFile(srcPath, destPath, replacements);
-    }
-  }
-}
-
-function copyFile(src, dest, replacements) {
-  // Skip if file already exists (preserve user's files)
-  if (fs.existsSync(dest)) return;
-
-  const textExtensions = ['.md', '.yaml', '.yml', '.json', '.js', '.ts', '.gitignore', '.gitkeep', ''];
-  const ext = path.extname(src).toLowerCase();
-  const basename = path.basename(src);
-  const isText = textExtensions.includes(ext) || basename.startsWith('.') || basename === '_gitignore';
-
-  if (isText) {
-    let content = fs.readFileSync(src, 'utf-8');
-    for (const [placeholder, value] of Object.entries(replacements)) {
-      content = content.split(placeholder).join(value);
-    }
-    fs.writeFileSync(dest, content, 'utf-8');
-  } else {
-    fs.copyFileSync(src, dest);
-  }
-}
-
-function init({ name, templatesDir, targetDir }) {
-  const dest = targetDir || path.resolve(process.cwd(), name);
-
-  const existed = fs.existsSync(dest);
-  console.log(`\n${existed ? 'Inicializando' : 'Criando'} projeto "${name}" em ${dest}\n`);
-
-  const replacements = { [PLACEHOLDER]: name };
-  copyDir(templatesDir, dest, replacements);
-  patchProjectName(dest, name);
-
-  console.log(`Pronto! Projeto "${name}" criado.`);
-  console.log('\nPróximos passos:');
-  console.log(`  1. cd ${name}`);
-  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('');
-}
-
-function patchProjectName(dest, name) {
-  const filesToPatch = [
-    path.join('.ai', 'memory', 'napkin.md'),
-    path.join('.github', 'copilot-instructions.md'),
-    'CLAUDE.md',
-  ];
-
-  for (const relPath of filesToPatch) {
-    const filePath = path.join(dest, relPath);
-    if (!fs.existsSync(filePath)) continue;
-
-    let content = fs.readFileSync(filePath, 'utf-8');
-    content = content.replace(/# Napkin Runbook\b/, `# Napkin Runbook — ${name}`);
-    content = content.replace(/# Copilot Instructions — Projeto\b/, `# Copilot Instructions — ${name}`);
-    content = content.replace(/# CLAUDE\.md — Projeto\b/, `# CLAUDE.md — ${name}`);
-    fs.writeFileSync(filePath, content, 'utf-8');
-  }
-}
-
-module.exports = { init };
+const fs = require('fs');
+const path = require('path');
+
+const PLACEHOLDER = '{{PROJECT_NAME}}';
+
+function copyDir(src, dest, replacements) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    // Rename _gitignore → .gitignore (npm strips .gitignore from packages)
+    const destName = entry.name === '_gitignore' ? '.gitignore' : entry.name;
+    const destPath = path.join(dest, destName);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath, replacements);
+    } else {
+      copyFile(srcPath, destPath, replacements);
+    }
+  }
+}
+
+function copyFile(src, dest, replacements) {
+  // Skip if file already exists (preserve user's files)
+  if (fs.existsSync(dest)) return;
+
+  const textExtensions = ['.md', '.yaml', '.yml', '.json', '.js', '.ts', '.gitignore', '.gitkeep', ''];
+  const ext = path.extname(src).toLowerCase();
+  const basename = path.basename(src);
+  const isText = textExtensions.includes(ext) || basename.startsWith('.') || basename === '_gitignore';
+
+  if (isText) {
+    let content = fs.readFileSync(src, 'utf-8');
+    for (const [placeholder, value] of Object.entries(replacements)) {
+      content = content.split(placeholder).join(value);
+    }
+    fs.writeFileSync(dest, content, 'utf-8');
+  } else {
+    fs.copyFileSync(src, dest);
+  }
+}
+
+function init({ name, templatesDir, targetDir }) {
+  const dest = targetDir || path.resolve(process.cwd(), name);
+
+  const existed = fs.existsSync(dest);
+  console.log(`\n${existed ? 'Inicializando' : 'Criando'} projeto "${name}" em ${dest}\n`);
+
+  const replacements = { [PLACEHOLDER]: name };
+  copyDir(templatesDir, dest, replacements);
+  patchProjectName(dest, name);
+
+  console.log(`Pronto! Projeto "${name}" criado.`);
+  console.log('\nPróximos passos:');
+  console.log(`  1. cd ${name}`);
+  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('');
+}
+
+function patchProjectName(dest, name) {
+  const filesToPatch = [
+    path.join('.ai', 'memory', 'napkin.md'),
+    path.join('.github', 'copilot-instructions.md'),
+    'CLAUDE.md',
+  ];
+
+  for (const relPath of filesToPatch) {
+    const filePath = path.join(dest, relPath);
+    if (!fs.existsSync(filePath)) continue;
+
+    let content = fs.readFileSync(filePath, 'utf-8');
+    content = content.replace(/# Napkin Runbook\b/, `# Napkin Runbook — ${name}`);
+    content = content.replace(/# Copilot Instructions — Projeto\b/, `# Copilot Instructions — ${name}`);
+    content = content.replace(/# CLAUDE\.md — Projeto\b/, `# CLAUDE.md — ${name}`);
+    fs.writeFileSync(filePath, content, 'utf-8');
+  }
+}
+
+module.exports = { init };

package/lib/update.js

@@ -1,132 +1,132 @@
-const fs = require('fs');
-const path = require('path');
-
-const FRAMEWORK_DIRS = [
-  path.join('.github', 'adapters'),
-  path.join('.github', 'skills'),
-  path.join('.github', 'agents'),
-  path.join('.github', 'templates'),
-  path.join('.github', 'instructions'),
-];
-
-const FRAMEWORK_FILES = [
-  path.join('.github', 'rules.md'),
-  path.join('.github', 'copilot-instructions.md'),
-  path.join('.github', 'CHANGELOG.md'),
-  'sfw.config.yml.example',
-];
-
-function update({ templatesDir, targetDir, force }) {
-  const dest = targetDir || process.cwd();
-
-  if (!fs.existsSync(dest)) {
-    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('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(`\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(`Adicionados (${stats.added.length}):`);
-    for (const f of stats.added) console.log(`  + ${f}`);
-  }
-  if (stats.updated.length > 0) {
-    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('Já está atualizado — nenhum arquivo novo pra adicionar.');
-  } else {
-    console.log(`\n${stats.added.length} adicionado(s), ${stats.updated.length} atualizado(s), ${stats.skipped} inalterado(s)`);
-  }
-
-  console.log('');
-}
-
-function syncDir(src, dest, force, stats, root) {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const srcPath = path.join(src, entry.name);
-    const destName = entry.name === '_gitignore' ? '.gitignore' : entry.name;
-    const destPath = path.join(dest, destName);
-    if (entry.isDirectory()) {
-      syncDir(srcPath, destPath, force, stats, root);
-    } else {
-      syncFile(srcPath, destPath, force, stats, root);
-    }
-  }
-}
-
-function syncFile(src, dest, force, stats, root) {
-  const rel = path.relative(root, dest);
-  const exists = fs.existsSync(dest);
-
-  if (exists && !force) {
-    const isFramework = isFrameworkPath(rel);
-    if (!isFramework) {
-      stats.skipped++;
-      return;
-    }
-    const srcContent = fs.readFileSync(src, 'utf-8');
-    const destContent = fs.readFileSync(dest, 'utf-8');
-    if (srcContent === destContent) {
-      stats.skipped++;
-      return;
-    }
-    fs.writeFileSync(dest, srcContent, 'utf-8');
-    stats.updated.push(rel);
-    return;
-  }
-
-  if (exists && force) {
-    const srcContent = fs.readFileSync(src, 'utf-8');
-    const destContent = fs.readFileSync(dest, 'utf-8');
-    if (srcContent === destContent) {
-      stats.skipped++;
-      return;
-    }
-    fs.writeFileSync(dest, srcContent, 'utf-8');
-    stats.updated.push(rel);
-    return;
-  }
-
-  const textExtensions = ['.md', '.yaml', '.yml', '.json', '.js', '.ts', '.gitignore', '.gitkeep', ''];
-  const ext = path.extname(src).toLowerCase();
-  const basename = path.basename(src);
-  const isText = textExtensions.includes(ext) || basename.startsWith('.');
-
-  if (isText) {
-    const content = fs.readFileSync(src, 'utf-8');
-    fs.writeFileSync(dest, content, 'utf-8');
-  } else {
-    fs.copyFileSync(src, dest);
-  }
-  stats.added.push(rel);
-}
-
-function isFrameworkPath(rel) {
-  const normalized = rel.split(path.sep).join('/');
-  for (const dir of FRAMEWORK_DIRS) {
-    const normalizedDir = dir.split(path.sep).join('/');
-    if (normalized.startsWith(normalizedDir + '/')) return true;
-  }
-  for (const file of FRAMEWORK_FILES) {
-    const normalizedFile = file.split(path.sep).join('/');
-    if (normalized === normalizedFile) return true;
-  }
-  return false;
-}
-
-module.exports = { update };
+const fs = require('fs');
+const path = require('path');
+
+const FRAMEWORK_DIRS = [
+  path.join('.github', 'adapters'),
+  path.join('.github', 'skills'),
+  path.join('.github', 'agents'),
+  path.join('.github', 'templates'),
+  path.join('.github', 'instructions'),
+];
+
+const FRAMEWORK_FILES = [
+  path.join('.github', 'rules.md'),
+  path.join('.github', 'copilot-instructions.md'),
+  path.join('.github', 'CHANGELOG.md'),
+  'sfw.config.yml.example',
+];
+
+function update({ templatesDir, targetDir, force }) {
+  const dest = targetDir || process.cwd();
+
+  if (!fs.existsSync(dest)) {
+    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('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(`\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(`Adicionados (${stats.added.length}):`);
+    for (const f of stats.added) console.log(`  + ${f}`);
+  }
+  if (stats.updated.length > 0) {
+    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('Já está atualizado — nenhum arquivo novo pra adicionar.');
+  } else {
+    console.log(`\n${stats.added.length} adicionado(s), ${stats.updated.length} atualizado(s), ${stats.skipped} inalterado(s)`);
+  }
+
+  console.log('');
+}
+
+function syncDir(src, dest, force, stats, root) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destName = entry.name === '_gitignore' ? '.gitignore' : entry.name;
+    const destPath = path.join(dest, destName);
+    if (entry.isDirectory()) {
+      syncDir(srcPath, destPath, force, stats, root);
+    } else {
+      syncFile(srcPath, destPath, force, stats, root);
+    }
+  }
+}
+
+function syncFile(src, dest, force, stats, root) {
+  const rel = path.relative(root, dest);
+  const exists = fs.existsSync(dest);
+
+  if (exists && !force) {
+    const isFramework = isFrameworkPath(rel);
+    if (!isFramework) {
+      stats.skipped++;
+      return;
+    }
+    const srcContent = fs.readFileSync(src, 'utf-8');
+    const destContent = fs.readFileSync(dest, 'utf-8');
+    if (srcContent === destContent) {
+      stats.skipped++;
+      return;
+    }
+    fs.writeFileSync(dest, srcContent, 'utf-8');
+    stats.updated.push(rel);
+    return;
+  }
+
+  if (exists && force) {
+    const srcContent = fs.readFileSync(src, 'utf-8');
+    const destContent = fs.readFileSync(dest, 'utf-8');
+    if (srcContent === destContent) {
+      stats.skipped++;
+      return;
+    }
+    fs.writeFileSync(dest, srcContent, 'utf-8');
+    stats.updated.push(rel);
+    return;
+  }
+
+  const textExtensions = ['.md', '.yaml', '.yml', '.json', '.js', '.ts', '.gitignore', '.gitkeep', ''];
+  const ext = path.extname(src).toLowerCase();
+  const basename = path.basename(src);
+  const isText = textExtensions.includes(ext) || basename.startsWith('.');
+
+  if (isText) {
+    const content = fs.readFileSync(src, 'utf-8');
+    fs.writeFileSync(dest, content, 'utf-8');
+  } else {
+    fs.copyFileSync(src, dest);
+  }
+  stats.added.push(rel);
+}
+
+function isFrameworkPath(rel) {
+  const normalized = rel.split(path.sep).join('/');
+  for (const dir of FRAMEWORK_DIRS) {
+    const normalizedDir = dir.split(path.sep).join('/');
+    if (normalized.startsWith(normalizedDir + '/')) return true;
+  }
+  for (const file of FRAMEWORK_FILES) {
+    const normalizedFile = file.split(path.sep).join('/');
+    if (normalized === normalizedFile) return true;
+  }
+  return false;
+}
+
+module.exports = { update };

package/package.json

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

package/templates/.ai/memory/napkin.md

@@ -1,68 +1,68 @@
-# Napkin Runbook
-
-> Sistema de memória persistente do projeto.
-> Lido no início de cada sessão. Curado continuamente. Runbook, não log.
-
-## Regras de Curadoria
-- Re-priorizar a cada leitura (mais importante primeiro)
-- Manter apenas notas recorrentes e de alto valor
-- Máximo 10 itens por categoria
-- Cada item inclui data + ação concreta ("Fazer:" / "Evitar:")
-- Remover itens obsoletos ou de baixo sinal
-- Fundir duplicatas
-- Adaptar categorias ao projeto conforme ele evolui
-
----
-
-## Princípios Invioláveis
-
-1. **Spec-first**: NUNCA gerar código sem SDD aprovado
-   Fazer: seguir pipeline extract → design → plan → dev.
-
-2. **Entregáveis contínuos**: toda feature é faseada em entregáveis incrementais.
-   Cada fase entrega valor ao usuário e pode ir pra produção.
-   Fazer: nunca "tudo ou nada". Sempre pequeno e constante.
-
-3. **Nunca na main**: todo código em branch própria. Merge via PR aprovado pelo usuário.
-   Fazer: seguir git workflow (5 passos no rules.md).
-
-4. **SDD é auto-contido**: o coder lê APENAS SDD + task. Nunca PRD ou PM direto.
-   Fazer: se falta info no SDD, parar e reportar.
-
-5. **Docker dev = infra only**: docker-compose.yml tem APENAS dependências (banco, redis, rabbit).
-   Apps (API, Worker, Web) rodam direto: `dotnet run`, `npm run dev`.
-   Evitar: NUNCA colocar apps no docker-compose.yml de dev.
-
-## Padrões de Execução
-
-1. **Projeto-base = orquestrador, projetos/ = código**
-   Specs, docs, tasks, progresso ficam aqui. Código fica nos repos em projetos/.
-   Commits de código nos repos do serviço, NUNCA no projeto-base.
-
-2. **Auth por endpoint é obrigatória**
-   Todo endpoint deve ter Autenticação e Autorização definidos no SDD §5.
-   Se SDD omitiu → PARAR e reportar. Se público → escrever "público" explicitamente.
-
-3. **Temas críticos geram ambiguidades automáticas**
-   Se os insumos não mencionam: auth, authz, separação de serviços, ambientes,
-   dados sensíveis → o /extract gera ambiguidades obrigatórias.
-
-## Armadilhas do Ambiente
-
-<!-- Adicionar conforme descoberto durante o projeto -->
-
-## Decisões de Design
-
-<!-- Populado pelo /design e /dev conforme o projeto evolui -->
-
-## Regras de Negócio Aprendidas
-
-<!-- Populado pelo /extract e feedback do usuário -->
-
-## Preferências do Usuário
-
-<!-- Populado conforme interações com o usuário -->
-
-## Sessão Atual
-
-<!-- Atualizado pelo /session-finish ao encerrar cada sessão -->
+# Napkin Runbook
+
+> Sistema de memória persistente do projeto.
+> Lido no início de cada sessão. Curado continuamente. Runbook, não log.
+
+## Regras de Curadoria
+- Re-priorizar a cada leitura (mais importante primeiro)
+- Manter apenas notas recorrentes e de alto valor
+- Máximo 10 itens por categoria
+- Cada item inclui data + ação concreta ("Fazer:" / "Evitar:")
+- Remover itens obsoletos ou de baixo sinal
+- Fundir duplicatas
+- Adaptar categorias ao projeto conforme ele evolui
+
+---
+
+## Princípios Invioláveis
+
+1. **Spec-first**: NUNCA gerar código sem PRD e/ou TRD aprovados (+ `specs/{nome}/` gerado)
+   Fazer: seguir pipeline discovery → extract → design → plan → dev.
+
+2. **Entregáveis contínuos**: toda feature é faseada em entregáveis incrementais.
+   Cada fase entrega valor ao usuário e pode ir pra produção.
+   Fazer: nunca "tudo ou nada". Sempre pequeno e constante.
+
+3. **Nunca na main**: todo código em branch própria. Merge via PR aprovado pelo usuário.
+   Fazer: seguir git workflow (5 passos no rules.md).
+
+4. **specs/ é auto-contido**: o coder lê APENAS `specs/{nome}/` + task. Nunca PRD/TRD ou PM direto.
+   Fazer: se falta info em `specs/`, parar e reportar.
+
+5. **Docker dev = infra only**: docker-compose.yml tem APENAS dependências (banco, redis, rabbit).
+   Apps (API, Worker, Web) rodam direto: `dotnet run`, `npm run dev`.
+   Evitar: NUNCA colocar apps no docker-compose.yml de dev.
+
+## Padrões de Execução
+
+1. **Projeto-base = orquestrador, projetos/ = código**
+   Specs, docs, tasks, progresso ficam aqui. Código fica nos repos em projetos/.
+   Commits de código nos repos do serviço, NUNCA no projeto-base.
+
+2. **Auth por endpoint é obrigatória**
+   Todo endpoint deve ter Autenticação e Autorização definidos no TRD §2.1 (Backend) + §7 (Segurança).
+   Se TRD omitiu → PARAR e reportar. Se público → escrever "público" explicitamente.
+
+3. **Temas críticos geram ambiguidades automáticas**
+   Se os insumos não mencionam: auth, authz, separação de serviços, ambientes,
+   dados sensíveis → o /extract gera ambiguidades obrigatórias.
+
+## Armadilhas do Ambiente
+
+<!-- Adicionar conforme descoberto durante o projeto -->
+
+## Decisões de Design
+
+<!-- Populado pelo /design e /dev conforme o projeto evolui -->
+
+## Regras de Negócio Aprendidas
+
+<!-- Populado pelo /extract e feedback do usuário -->
+
+## Preferências do Usuário
+
+<!-- Populado conforme interações com o usuário -->
+
+## Sessão Atual
+
+<!-- Atualizado pelo /session-finish ao encerrar cada sessão -->