spec-first-copilot 0.5.0-beta.7 → 0.5.0-beta.8

package/lib/update.js

@@ -12,6 +12,7 @@ const FRAMEWORK_DIRS = [
 const FRAMEWORK_FILES = [
   path.join('.github', 'rules.md'),
   path.join('.github', 'copilot-instructions.md'),
+  path.join('.github', 'CHANGELOG.md'),
   'sfw.config.yml.example',
 ];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-first-copilot",
-  "version": "0.5.0-beta.7",
+  "version": "0.5.0-beta.8",
   "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

@@ -0,0 +1,112 @@
+# SFW Changelog — spec-first-copilot
+
+> Este arquivo é atualizado automaticamente pelo `spec-first-copilot update`.
+> O agent deve ler este arquivo quando o usuário perguntar sobre mudanças,
+> funcionalidades novas, ou o que está disponível no framework.
+>
+> **Não editar manualmente** — será sobrescrito no próximo update.
+
+---
+
+## 0.5.0-beta.7 (2026-04-12)
+
+### Novo: Comando `/sf-load <nome>`
+Puxa insumos do backend configurado (Confluence ou filesystem) para `workspace/Input/{nome}/`.
+- Busca o scope pelo nome no backend (match exato)
+- Desce recursivamente na árvore (Confluence `get_page_children` é apenas direto — `/sf-load` faz loop)
+- Baixa conteúdo + attachments
+- Log incremental em `.ai/sf-load-log.md` (NOVO/MODIFICADO/INALTERADO via sha256)
+- Idempotente — rodar N vezes sem mudanças no backend não altera nada
+- Referência: `.github/commands/sf-load.md`
+
+### Novo: Adapter layer (Confluence + Filesystem)
+Pipeline agora é backend-agnóstico via adapters plugáveis.
+- **ConfluenceAdapter** — fala com Confluence via MCP `sooperset/mcp-atlassian`
+- **FilesystemAdapter** — lê/escreve direto no disco (também serve como mock pra testes)
+- Configurado em `sfw.config.yml` (copiar de `sfw.config.yml.example`)
+- Interface: `.github/adapters/interface.md` (7 métodos)
+- Erros tipados: `.github/adapters/errors.md` (6 classes)
+- Naming engine: `.github/adapters/naming.md` (placeholders `{scope}`, `{type}`)
+- Registry: `.github/adapters/registry.md`
+- Setup guide: `.github/adapters/SETUP.md` (passo a passo de MCP + Confluence)
+
+### Novo: `sfw.config.yml`
+Manifesto do projeto que define de onde vêm e pra onde vão os artefatos.
+- `input.adapter` — de onde puxar insumos (`confluence` ou `filesystem`)
+- `output.targets[].mode` — ligar/desligar publish (`auto`, `manual`, `off`)
+- `naming.output_container` — template do nome da subpasta no Output (ex: `out_{scope}`)
+- `naming.output_artifact` — template do nome do artefato (ex: `{scope} - {type}`)
+- Copiar `sfw.config.yml.example` e preencher. Zero segredos neste arquivo.
+
+### Novo: `SETUP.md` — Guia de configuração
+Guia passo a passo em `.github/adapters/SETUP.md`:
+- Setup Confluence: uvx, .mcp.json, token Atlassian, space key, page IDs
+- Setup 100% local (filesystem, zero dependências)
+- Como ligar/desligar Confluence via `mode: auto|manual|off`
+- Troubleshooting: tabela com todos os gotchas conhecidos
+- **IMPORTANTE**: Confluence NÃO é CLI. Acesso via MCP tools prefixadas `mcp__atlassian__confluence_*`
+
+### Novo: CLI `update`
+```bash
+npx spec-first-copilot update           # adiciona novos, atualiza framework
+npx spec-first-copilot update --force   # sobrescreve tudo incluindo copilot-instructions.md
+```
+Atualiza projeto existente sem perder arquivos do usuário.
+
+### Breaking: `/sf-setup-projeto` → `/sf-new-project <nome>`
+- Antes: `/sf-setup-projeto` era hardcoded pra pasta `setup_projeto`
+- Agora: `/sf-new-project <nome>` recebe o nome como argumento (simétrico com `/sf-feature <nome>`)
+- `/sf-new-project` gera TRD (bootstrap técnico), `/sf-feature` gera PRD (feature)
+- **Não existe mais pasta mágica** — usuário nomeia livremente em `workspace/Input/`
+- O antigo `setup-projeto.md` foi removido. Usar `new-project.md`
+
+### Breaking: `{sequence}` removido
+- Antes: todo item tinha prefixo numérico `001 - ` pra unicidade no Confluence
+- Agora: usuário nomeia livremente, agent segue o nome do Input
+- Naming simplificado: só `{scope}` e `{type}` como placeholders
+- Premissa: 1 space Confluence = 1 projeto (multi-projeto no mesmo space requer nomes únicos no Input)
+
+### Breaking: Output agrupado por scope
+- Antes: artefatos flat no Output (ex: `001 - TRD setup_projeto`)
+- Agora: subpasta por scope (ex: `out_app_barbearia/app_barbearia - TRD`)
+- Container configurável via `naming.output_container` (default: `out_{scope}`)
+- Artifact configurável via `naming.output_artifact` (default: `{scope} - {type}`)
+
+---
+
+## 0.5.0-beta.2 (2026-04-11)
+
+### Refactor: `docs/specs/` → `specs/` (top-level)
+- Projeções do SDD (brief, contracts, scenarios, tasks) movidas pra raiz
+- Regra: humano lê `workspace/Output/`, agent lê `specs/`
+
+### Refactor: 3-zone separation
+- `.github/` = AI config (rules, templates, commands, agents)
+- `docs/` = system knowledge (5 docs de sistema)
+- `workspace/` = team content (Input/ + Output/)
+
+---
+
+## 0.4.0 (2026-04-10) — v1 stable
+
+### Funcionalidades base
+- 9 commands: setup-projeto, feature, discovery, extract, design, plan, dev, merge-delta, session-finish
+- 7 agents: backend-coder, frontend-coder, db-coder, infra-coder, doc-writer, reviewer, security-reviewer
+- Templates: PRD, TRD, SDD, tasks, Progresso, context, extract-log, backlog, projetos.yaml
+- Templates de estrutura: architecture, domain, conventions, apiContracts, decisions
+- Pipeline: extract → design → plan → dev com checkpoints de aprovação
+- Delta Specs (SDD §11) + merge-delta automático
+- Security Reviewer como gate pós-dev
+- Multi-repo via projetos.yaml
+- Entregáveis contínuos (fases de entrega)
+
+---
+
+## Como usar este arquivo
+
+Se o usuário perguntar:
+- **"O que tem de novo?"** → ler a versão mais recente acima
+- **"Como uso o /sf-load?"** → apontar pra `.github/commands/sf-load.md`
+- **"Como configuro Confluence?"** → apontar pra `.github/adapters/SETUP.md`
+- **"O que é adapter?"** → apontar pra `.github/adapters/interface.md`
+- **"O que mudou de setup-projeto?"** → seção "Breaking" do 0.5.0-beta.7