spec-first-copilot 0.5.0-beta.12 → 0.5.0-beta.14

package/lib/init.js

@@ -1,6 +1,5 @@
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
 
 const PLACEHOLDER = '{{PROJECT_NAME}}';
 
@@ -8,7 +7,9 @@ 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);
-    const destPath = path.join(dest, 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 {
@@ -24,7 +25,7 @@ function copyFile(src, dest, replacements) {
   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('.');
+  const isText = textExtensions.includes(ext) || basename.startsWith('.') || basename === '_gitignore';
 
   if (isText) {
     let content = fs.readFileSync(src, 'utf-8');
@@ -47,23 +48,12 @@ function init({ name, templatesDir, targetDir }) {
   copyDir(templatesDir, dest, replacements);
   patchProjectName(dest, name);
 
-  try {
-    execSync('git init', { cwd: dest, stdio: 'pipe' });
-    execSync('git add -A', { cwd: dest, stdio: 'pipe' });
-    execSync(`git commit -m "chore: init project ${name} via spec-first-workflow"`, {
-      cwd: dest,
-      stdio: 'pipe',
-    });
-    console.log('Git initialized with initial commit.');
-  } catch {
-    console.log('Git init skipped (git not available or error).');
-  }
-
-  console.log(`\nDone! Project "${name}" is ready.`);
+  console.log(`Done! Project "${name}" is ready.`);
   console.log('\nNext steps:');
   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. Run /sf-new-project <folder-name> to start the pipeline');
+  console.log('  3. Copy sfw.config.yml.example to sfw.config.yml and configure your backend');
+  console.log('  4. Run /sf-new-project <folder-name> to start the pipeline');
   console.log('');
 }
 

package/lib/update.js

@@ -37,9 +37,6 @@ function update({ templatesDir, targetDir, force }) {
   const stats = { added: [], updated: [], skipped: 0 };
   syncDir(templatesDir, dest, force, stats, dest);
 
-  // Auto-configure .gitignore based on sfw.config.yml (before printing results)
-  adjustGitignore(dest, stats);
-
   console.log('');
   if (stats.added.length > 0) {
     console.log(`Added (${stats.added.length}):`);
@@ -62,7 +59,8 @@ 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 destPath = path.join(dest, 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 {
@@ -131,37 +129,4 @@ function isFrameworkPath(rel) {
   return false;
 }
 
-const WORKSPACE_IGNORE_MARKER = '# SFW: workspace ignored (external backend detected)';
-const WORKSPACE_IGNORE_BLOCK = `
-${WORKSPACE_IGNORE_MARKER}
-# Content lives in the external backend (Confluence, etc.) — local is just cache
-workspace/Output/**
-!workspace/Output/.gitkeep
-`;
-
-function adjustGitignore(dest, stats) {
-  const configPath = path.join(dest, 'sfw.config.yml');
-  const gitignorePath = path.join(dest, '.gitignore');
-
-  if (!fs.existsSync(configPath) || !fs.existsSync(gitignorePath)) return;
-
-  const config = fs.readFileSync(configPath, 'utf-8');
-  const gitignore = fs.readFileSync(gitignorePath, 'utf-8');
-
-  const inputMatch = config.match(/^\s*adapter:\s*(\S+)/m);
-  const inputAdapter = inputMatch ? inputMatch[1] : 'filesystem';
-  const isExternal = inputAdapter !== 'filesystem';
-
-  const alreadyHasBlock = gitignore.includes(WORKSPACE_IGNORE_MARKER);
-
-  if (isExternal && !alreadyHasBlock) {
-    fs.appendFileSync(gitignorePath, WORKSPACE_IGNORE_BLOCK);
-    stats.updated.push('.gitignore (workspace ignored — external backend)');
-  } else if (!isExternal && alreadyHasBlock) {
-    const cleaned = gitignore.split(WORKSPACE_IGNORE_MARKER)[0].trimEnd() + '\n';
-    fs.writeFileSync(gitignorePath, cleaned, 'utf-8');
-    stats.updated.push('.gitignore (workspace restored — local mode)');
-  }
-}
-
 module.exports = { update };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-first-copilot",
-  "version": "0.5.0-beta.12",
+  "version": "0.5.0-beta.14",
   "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/skills/sf-load/SKILL.md

@@ -156,7 +156,29 @@ Formato append-only:
 - Se não existia no log → status `NOVO`
 - Arquivo que existia no log mas sumiu do backend → status `REMOVIDO` (log only, não deleta local)
 
-### 5. Informar o usuário
+### 5. Ajustar `.gitignore` conforme o adapter
+
+Se o adapter NÃO é `filesystem` (ou seja, é um backend externo como Confluence):
+- Verificar se `.gitignore` contém o bloco `# SFW: workspace ignored`
+- Se NÃO contém, **adicionar** ao final do `.gitignore`:
+  ```
+  # SFW: workspace ignored (external backend detected)
+  # Content lives in the external backend (Confluence, etc.) — local is just cache
+  workspace/Output/**
+  !workspace/Output/.gitkeep
+  ```
+- Informar ao usuário: "workspace/Output/ adicionado ao .gitignore (conteúdo vive no {adapter})"
+
+Se o adapter É `filesystem`:
+- Se `.gitignore` contém o bloco `# SFW: workspace ignored`, **removê-lo**
+- Informar ao usuário: "workspace/Output/ removido do .gitignore (modo local)"
+
+Isso garante que:
+- Projetos com Confluence não commitam cache local
+- Projetos que mudam de Confluence → filesystem voltam a rastrear
+- A lógica roda no momento certo (após configurar `sfw.config.yml`, não no `init`)
+
+### 6. Informar o usuário
 
 ```
 Insumos carregados em workspace/Input/{nome}/

package/templates/_gitignore

@@ -0,0 +1,35 @@
+# Insumos brutos do usuário — conteúdo nunca vai pro repositório
+# A pasta workspace/Input/ existe no repo (via .gitkeep), mas seu conteúdo é ignorado
+workspace/Input/**
+!workspace/Input/.gitkeep
+!workspace/Input/**/.gitkeep
+
+# Memory pessoal (opcional — commit napkin.md se quiser compartilhar com o time)
+# .ai/memory/napkin.md
+
+# Repositórios de serviços (clonados/criados pelo workflow — cada um tem seu próprio .git)
+projetos/
+
+# MCP config — contém credenciais hardcoded (Confluence token, etc.)
+.mcp.json
+
+# Logs internos do workflow (append-only, gerados pelos commands)
+.ai/load-log.md
+.ai/publish-log.md
+
+# IDEs
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Node
+node_modules/
+dist/
+
+# Env
+.env
+.env.*
+!.env.example