ganbatte-os 0.2.41 → 0.2.42

package/.gos/docs/slack-notifications.md

@@ -1,219 +0,0 @@
-# Slack Notifications — Pipeline com aprovação
-
-Workflow de notificações Slack que disparam a partir de commits com `T-NNN` no message. Tudo passa por uma fila de aprovação — nada é enviado sem revisão humana.
-
-## Overview
-
-```
-git commit -m "fix: ... Refs T-NNN"
-      │
-      ▼
-.git/hooks/post-commit (shim bash, define GANBATTE_ROOT)
-      │
-      ▼
-scripts/hooks/post-commit-sync.js
-      │  1. extrai T-NNN do message
-      │  2. lê registry.taskDetails + taskStatus
-      │  3. constrói payload via slack-notify.buildTaskDonePayload
-      │     (sanitiza texto com text-sanitize.js)
-      │  4. chama slack-notify.enqueueDraft
-      ▼
-.gos/slack-queue/<timestamp>-<taskId>-<hash>.json  (status: pending)
-      │
-      │  [commit termina — nada foi enviado]
-      │
-      ▼
-/slack-review  (Douglas roda quando quiser)
-      │  lista drafts, mostra preview, AskUserQuestion
-      │  ações: approve / edit / reject / skip
-      ▼
-node slack-queue.js approve <id>
-      │  POST webhook Slack
-      ▼
-Slack #cspo-tech ← notificação enriquecida e revisada
-      │
-      ▼
-.gos/slack-queue/sent/<id>.json   (histórico)
-```
-
-## Anatomia do payload
-
-Campos extraídos de `data/sprints/registry.json`:
-
-| Fonte | Campo | Uso no payload |
-|---|---|---|
-| `taskDetails[T-NNN].name` | nome da task | linha 2 do payload |
-| `taskDetails[T-NNN].assignee` | responsável | linha meta (primeiro nome) |
-| `taskDetails[T-NNN].sprint` | sprint | linha meta |
-| `taskDetails[T-NNN].ac[]` | array de ACs | rodapé — "N ACs" |
-| `taskStatus[T-NNN].points` | story points | linha meta |
-| `taskStatus[T-NNN].dueDate` | prazo | linha meta (MM/DD) |
-| `taskMap[T-NNN]` | ID ClickUp | link ClickUp no rodapé |
-
-Formato renderizado:
-
-```
-:white_check_mark: T-110 concluída — S07 · Douglas · 8 pts · due 04/17
-Resolver drift TypeScript + instalar pre-commit hook
-> Commit: 54d8fe6 — fix: drift resolvido
-> 7 ACs · por Douglas Oliveira · <ClickUp>
-```
-
-## Pipeline de sanitização
-
-`text-sanitize.js` aplica, em ordem, sobre qualquer texto que entra em payload:
-
-1. **Protege code fences** (```` ``` ````) e inline code (`` ` ``).
-2. **P17 emoji-bullets**: remove emojis (✅ ❌ ⚠ 🚀 ⭐ 🎯 💡 🔧 🎉 🔥 👍 👌) no início de linhas.
-3. **P14 em-dash entre palavras**: `word—word` → `word-word` (mantém travessão legítimo com espaços).
-4. **Acentos pt-BR**: dicionário determinístico — `concluida → concluída`, `atualizacao → atualização`, ~80 termos.
-5. **P07 vocabulário IA**: `aprimorar → melhorar`, `fomentar → estimular`, `crucial → importante`, ~25 termos com preservação de flexão (gerúndio, plural) e case.
-6. **Restaura code spans** intactos.
-
-Estender dicionários: editar `AI_VOCAB` e `MISSING_ACCENTS` em `.gos/scripts/tools/text-sanitize.js`.
-
-## Fila de aprovação
-
-**Localização**: `.gos/slack-queue/` (gitignored)
-
-**Estados**:
-
-| Estado | Diretório | Remoção |
-|---|---|---|
-| `pending` | `.gos/slack-queue/*.json` | manual (approve/reject) |
-| `sent` | `.gos/slack-queue/sent/*.json` | manual, após confirmação |
-| `rejected` | `.gos/slack-queue/rejected/*.json` | auditoria, manter histórico |
-
-**TTL**: sem expiração automática. Limpar manualmente `sent/` e `rejected/` a cada sprint via `rm -rf .gos/slack-queue/{sent,rejected}`.
-
-**Estrutura do draft**:
-
-```json
-{
-  "id": "20260417T143100-T110-54d8fe6",
-  "createdAt": "2026-04-17T14:31:00Z",
-  "taskId": "T-110",
-  "commit": "54d8fe6",
-  "channel": "default",
-  "author": "Douglas Oliveira",
-  "payload": { "text": "..." },
-  "status": "pending"
-}
-```
-
-## Comandos
-
-### slack-queue.js
-
-```bash
-# Listar pendentes
-node .gos/scripts/tools/slack-queue.js list
-node .gos/scripts/tools/slack-queue.js list --json
-
-# Mostrar um draft
-node .gos/scripts/tools/slack-queue.js show <id>
-
-# Editar inline (abre $EDITOR / VISUAL / notepad no Windows)
-node .gos/scripts/tools/slack-queue.js edit <id>
-
-# Aprovar e enviar
-node .gos/scripts/tools/slack-queue.js approve <id>
-
-# Rejeitar
-node .gos/scripts/tools/slack-queue.js reject <id> --reason "duplicate"
-
-# Aprovar todos pendentes (CI, depois de revisão visual)
-node .gos/scripts/tools/slack-queue.js flush
-```
-
-### slack-notify.js
-
-```bash
-# Enfileirar manualmente (default)
-node .gos/scripts/tools/slack-notify.js task-done \
-  --task T-110 --commit 54d8fe6 --author "Douglas Oliveira" \
-  --registry data/sprints/registry.json
-
-# Envio imediato sem fila (bypass revisão — usar só em CI)
-node .gos/scripts/tools/slack-notify.js task-done \
-  --task T-110 --commit 54d8fe6 --author "Douglas Oliveira" \
-  --registry data/sprints/registry.json --send-now
-
-# Dry-run (monta payload sem enviar nem enfileirar)
-node .gos/scripts/tools/slack-notify.js task-done \
-  --task T-110 --commit 54d8fe6 --author "Douglas Oliveira" \
-  --registry data/sprints/registry.json --send-now --dry-run
-```
-
-### text-sanitize.js
-
-```bash
-# CLI
-node .gos/scripts/tools/text-sanitize.js --text "Task concluida aprimorando"
-node .gos/scripts/tools/text-sanitize.js --file path/to/content.md --json
-echo "texto sujo" | node .gos/scripts/tools/text-sanitize.js --stdin
-
-# Como módulo
-const { sanitize } = require('./.gos/scripts/tools/text-sanitize.js')
-const { text, changes } = sanitize(input)
-```
-
-## Skill `/slack-review`
-
-Ver `.gos/skills/slack-review/SKILL.md`. Wrapper interativo do `slack-queue.js list|show|edit|approve|reject` com preview renderizado e `AskUserQuestion` para cada ação.
-
-## Como pular aprovação
-
-**CI / automação** onde revisão humana não faz sentido:
-
-```bash
-node .gos/scripts/tools/slack-notify.js <cmd> --send-now
-```
-
-**Flush programado** (ex: cron de fim de dia):
-
-```bash
-node .gos/scripts/tools/slack-queue.js flush
-```
-
-Usar com cuidado — fila existe justamente para evitar envio acidental.
-
-## Troubleshooting
-
-### Commit rodou mas fila não tem drafts
-
-- Verificar que o commit message contém `T-NNN` (regex `\bT-\d{3}\b`).
-- Confirmar hook instalado: `ls packages/fractus/.git/hooks/post-commit`.
-- Confirmar hook aponta para `$GANBATTE_ROOT/scripts/hooks/post-commit-sync.js` e exporta `GANBATTE_ROOT`.
-- Rodar manual: `cd packages/fractus && GANBATTE_ROOT=$(git rev-parse --show-superproject-working-tree || pwd) node ../../scripts/hooks/post-commit-sync.js`.
-
-### Approve falha com "SLACK_WEBHOOK_URL not set"
-
-- Arquivo `.env` na raiz (`e:\Github\Ganbatte\.env`) contém `SLACK_WEBHOOK_URL=...`?
-- `slack-queue.js` carrega `.env` automaticamente via `loadRootEnv()` — se variável está no `.env` mas não é lida, conferir formatação (sem aspas extras, `KEY=VALUE` puro).
-
-### Draft stuck em pending após approve
-
-- Abrir o JSON em `.gos/slack-queue/sent/<id>.json` — se existe, o envio OK mas `unlink` do original falhou (permission issue Windows). Remover manualmente.
-- Se não existe, o POST webhook falhou — ver output do comando (status HTTP + body).
-
-### Edição travada
-
-- `edit` abre `$VISUAL` → `$EDITOR` → `notepad` (Windows) / `vi` (Unix). Se o editor não fechar, o comando fica bloqueado.
-- Alternativa: editar o JSON direto em `.gos/slack-queue/<id>.json` e rodar approve em seguida.
-
-### Texto sanitizado incorretamente
-
-- Ver `changes[]` do sanitize: `node .gos/scripts/tools/text-sanitize.js --text "..." --json`.
-- Se uma substituição está errada, remover do dicionário em `text-sanitize.js:AI_VOCAB` / `MISSING_ACCENTS`.
-- Code spans (`` ` `` e ```` ``` ````) são preservados — se precisar isolar um termo, envolver em backticks.
-
-## Referências
-
-- [`text-sanitize.js`](../scripts/tools/text-sanitize.js) — sanitizador
-- [`slack-queue.js`](../scripts/tools/slack-queue.js) — fila
-- [`slack-notify.js`](../scripts/tools/slack-notify.js) — payload + envio
-- [`post-commit-sync.js`](../../scripts/hooks/post-commit-sync.js) — hook
-- [`ai-writing-patterns.md`](../libraries/content/ai-writing-patterns.md) — catálogo base
-- [`humanizer`](../skills/humanizer/SKILL.md) — skill de humanização criativa
-- [`slack-review`](../skills/slack-review/SKILL.md) — skill de aprovação interativa

package/.gos/playbooks/sprint-planner-playbook.md

@@ -1,127 +0,0 @@
-# Sprint Planner — Playbook Operacional
-
-> Guia a execucao completa do sprint-planner: do input ate sprint montada com PRD, ADR, roadmap e tasks.
-
-## Objetivo
-
-Transformar qualquer input (caminho de projeto, design Figma, transcricao, documento)
-em um pacote completo de sprint com artefatos prontos para execucao.
-
-## Pre-requisitos
-
-- [ ] Input disponivel (caminho de projeto, design, transcricao ou descricao)
-- [ ] Acesso ao projeto/codebase (se for project-path)
-- [ ] Usuario disponivel para loops de discovery (15-30 min)
-- [ ] Branch correta (`dev` para framework, feature branch para projetos)
-
-## Step 1 — Triage do Input (5 min)
-
-- [ ] Classificar tipo: project-path | design | transcription | document | free-text | mixed
-- [ ] Se project-path: executar `/project-brief <path>` para contexto
-- [ ] Se design: analise visual — extrair telas, fluxos, componentes
-- [ ] Se transcription: extrair requisitos, fluxos, restricoes, decisoes
-- [ ] Se document: ler, sumarizar, identificar gaps
-- [ ] Gerar `input-analysis.md`
-- [ ] Apresentar resumo ao usuario
-
-## Step 2 — Discovery Loops (15-30 min)
-
-- [ ] Loop 1: Contexto e Objetivo (SCQA + Analise de Premissas)
-- [ ] Loop 2: Usuarios e Escopo (Task-Oriented Thought + Brainstorming)
-- [ ] Loop 3: Fluxos e Regras (Verificacao de Consistencia)
-- [ ] Loop 4 (se necessario): Dados e Restricoes (ReAct + Feynman)
-- [ ] Avaliar clarity checklist (>= 70%?)
-- [ ] Se < 70% apos 4 loops: consolidar e sinalizar gaps
-
-## Step 3 — PRD (20-30 min)
-
-- [ ] Gerar `sprint-planner/<slug>/PRD.md`
-- [ ] Escopo IN/OUT explicito
-- [ ] Criterios de aceite verificaveis (Given/When/Then)
-- [ ] Decisoes menores embedded (contexto, opcoes, escolha)
-- [ ] **GATE: Usuario aprova PRD**
-
-## Step 4 — Arquitetura & Schema (15-30 min)
-
-- [ ] Identificar decisoes arquiteturais significativas
-- [ ] Gerar `ADR-NNN.md` para cada decisao com 3+ opcoes e trade-offs
-- [ ] Se projeto envolve banco: gerar `schema.dbml`
-- [ ] Se projeto envolve APIs: listar endpoints com contratos
-- [ ] **GATE: Usuario aprova ADRs e schema**
-
-## Step 5 — Roadmap (10 min)
-
-- [ ] Classificar complexidade: simples | medio | complexo
-- [ ] Gerar `ROADMAP.md` com fases, duracoes e entregaveis
-- [ ] Validar: soma duracoes <= total + 20% margem
-- [ ] Validar: cada fase tem pelo menos 1 entregavel concreto
-- [ ] **GATE: Fases e prazos validados**
-
-## Step 6 — Task Decomposition (15-20 min)
-
-- [ ] Executar `/plan-to-tasks` no PRD
-- [ ] Validar: cada task max 1 dia, DoD mensuravel
-- [ ] User stories em Given/When/Then
-- [ ] Complexidade scoring (1-25) por story
-- [ ] Ordenar por dependencias
-
-## Step 7 — Setup Tasks (10 min)
-
-- [ ] Detectar necessidades: contas, credenciais, infra, repos
-- [ ] Gerar tasks P0 com area devops/general
-- [ ] Incluir instrucoes passo-a-passo
-- [ ] Vincular como pre-requisitos das tasks de dev
-
-## Step 8 — Sprint Assembly (10 min)
-
-- [ ] Gerar `SPRINT-OVERVIEW.md` consolidando tudo
-- [ ] Registrar decisoes no `memory/decision-log.json`
-- [ ] Apresentar resumo final ao usuario
-- [ ] Indicar proximos passos (qual skill usar para executar)
-
-## Armadilhas Comuns
-
-| Armadilha | Sintoma | Solucao |
-|-----------|---------|---------|
-| Discovery infinito | Mais de 5 loops sem convergir | Consolidar o que tem, sinalizar gaps |
-| Scope creep no PRD | PRD com 20+ tasks | Dividir em 2+ sprints |
-| ADR para tudo | ADR para decisoes triviais | Embedded no PRD se < 3 opcoes |
-| Schema sem RLS | Tabelas sem politicas de seguranca | Sempre incluir nota sobre RLS |
-| Setup esquecido | Dev trava por falta de credencial | Phase 6 existe para isso |
-| Pular gates | Avancar sem aprovacao | Cada fase TEM que ter aprovacao |
-
-## Tempo Estimado
-
-| Complexidade | Tempo total |
-|-------------|-------------|
-| Simples (escopo claro, 3-5 tasks) | 45-60 min |
-| Medio (ambiguidade moderada, 5-15 tasks) | 60-90 min |
-| Complexo (multi-dominio, 15+ tasks) | 90-150 min |
-
-## Continuacao
-
-Apos sprint-planner concluir, o usuario escolhe como executar:
-
-| Objetivo | Comando |
-|----------|---------|
-| Executar spec-driven (completo) | `/sdd sprint-planner/<slug>/PRD.md` |
-| Orquestrar execucao (composicao) | `/compose TASK-YYYYMM-001` |
-| Refinar backlog | `@sm` ou `@po` |
-| Frontend direto | `/fe` com tasks geradas |
-| Backend direto | `/be` com tasks geradas |
-
-## Referencias
-
-- `skills/sprint-planner/SKILL.md` — skill completa
-- `templates/adr-tmpl.yaml` — template ADR
-- `playbooks/story-creation-playbook.md` — formato de stories
-- `playbooks/gsd-agent-decomposition-playbook.md` — padrao de handoff por artefatos
-- `skills/sdd/SKILL.md` — para continuacao com execucao
-- `skills/plan-to-tasks/SKILL.md` — decomposicao em tasks
-
-## Cadencia Sugerida
-
-- Ao iniciar qualquer projeto novo (greenfield)
-- Ao receber novo escopo ou fase de projeto existente (brownfield)
-- Quando receber designs Figma ou transcricoes de reuniao para planejar
-- Antes de sprints que envolvem multiplos dominios (FE + BE + infra)

package/.gos/scripts/hooks/post-commit-notify.js

@@ -1,175 +0,0 @@
-#!/usr/bin/env node
-
-// post-commit-notify.js — Post-commit hook: marks tasks done in ClickUp + notifies Slack
-// Trigger: Claude Code Stop hook or git post-commit
-// Rule: ALWAYS exit 0 (observation hook, never blocks)
-
-const { execFileSync } = require('node:child_process')
-const { existsSync, readFileSync } = require('node:fs')
-const { resolve } = require('node:path')
-
-// Find repo root
-function findRepoRoot() {
-  try {
-    return execFileSync('git', ['rev-parse', '--show-toplevel'], { encoding: 'utf-8' }).trim()
-  } catch {
-    return process.cwd()
-  }
-}
-
-// Parse last commit
-function getLastCommit() {
-  try {
-    const log = execFileSync('git', ['log', '-1', '--format=%H|%s|%an'], { encoding: 'utf-8' }).trim()
-    const sepIdx = log.indexOf('|')
-    const hash = log.slice(0, sepIdx)
-    const rest = log.slice(sepIdx + 1)
-    const lastSep = rest.lastIndexOf('|')
-    const message = rest.slice(0, lastSep)
-    const author = rest.slice(lastSep + 1)
-    return { hash, message, author }
-  } catch {
-    return null
-  }
-}
-
-// Extract task refs from commit message (T-NNN pattern)
-function extractTaskRefs(message) {
-  const matches = message.match(/\bT-(\d{3})\b/g)
-  return matches ? [...new Set(matches)] : []
-}
-
-// Load sprint registry to resolve local IDs -> ClickUp IDs
-function loadRegistry(repoRoot) {
-  const paths = [
-    resolve(repoRoot, 'data/sprints/registry.json'),
-    resolve(repoRoot, '.gos/data/sprints/registry.json'),
-  ]
-  for (const p of paths) {
-    if (existsSync(p)) {
-      try {
-        return { data: JSON.parse(readFileSync(p, 'utf-8')), path: p }
-      } catch { continue }
-    }
-  }
-  return { data: { version: '1.0', sprints: [], taskMap: {}, taskSprintMap: {} }, path: paths[0] }
-}
-
-// Run a CLI tool safely (no shell injection)
-function runTool(repoRoot, tool, toolArgs) {
-  const toolPaths = [
-    resolve(repoRoot, `.gos/scripts/tools/${tool}`),
-    resolve(repoRoot, `scripts/tools/${tool}`),
-  ]
-  const toolPath = toolPaths.find(p => existsSync(p))
-  if (!toolPath) return null
-
-  try {
-    const result = execFileSync('node', [toolPath, ...toolArgs], {
-      encoding: 'utf-8',
-      timeout: 15000,
-      env: process.env,
-    })
-    return JSON.parse(result)
-  } catch (e) {
-    return { error: e.message }
-  }
-}
-
-// Detect if commit implies task completion
-function isCompletionCommit(message) {
-  const completionPatterns = [
-    /^feat[:(]/i,
-    /^fix[:(]/i,
-    /\b(close[sd]?|complete[sd]?|finish|done|resolve[sd]?)\b/i,
-  ]
-  return completionPatterns.some(p => p.test(message))
-}
-
-// Detect if commit is a start/WIP commit
-function isStartCommit(message) {
-  const startPatterns = [
-    /^(wip|chore|progress|draft|start|refactor|test|docs|style)[:(]/i,
-    /\b(wip|in.?progress|draft|start)\b/i,
-  ]
-  return startPatterns.some(p => p.test(message))
-}
-
-// Find sprint for a task reference
-function findSprintForTask(registry, taskRef) {
-  if (registry.taskSprintMap?.[taskRef]) {
-    return registry.sprints.find(s => s.id === registry.taskSprintMap[taskRef]) || null
-  }
-  return registry.sprints.filter(s => !s.end || new Date(s.end) >= new Date())
-    .sort((a, b) => new Date(b.start) - new Date(a.start))[0] || null
-}
-
-async function main() {
-  const repoRoot = findRepoRoot()
-  const commit = getLastCommit()
-  if (!commit) return
-
-  const taskRefs = extractTaskRefs(commit.message)
-  if (taskRefs.length === 0) return
-
-  const hasClickUp = !!process.env.CLICKUP_API_KEY
-  const hasSlack = !!process.env.SLACK_WEBHOOK_URL
-  if (!hasClickUp && !hasSlack) return
-
-  const { data: registry } = loadRegistry(repoRoot)
-  const shouldComplete = isCompletionCommit(commit.message)
-  const shouldStart = isStartCommit(commit.message)
-
-  for (const ref of taskRefs) {
-    const clickupId = registry.taskMap?.[ref]
-
-    // Update ClickUp task status
-    if (hasClickUp && clickupId) {
-      if (shouldComplete) {
-        runTool(repoRoot, 'clickup.js', ['task', 'update', '--task-id', clickupId, '--status', 'complete'])
-      } else if (shouldStart) {
-        runTool(repoRoot, 'clickup.js', ['task', 'update', '--task-id', clickupId, '--status', 'in progress'])
-      }
-    }
-
-    // Notify Slack
-    if (hasSlack) {
-      const status = shouldComplete ? 'concluida' : shouldStart ? 'em andamento' : 'atualizada'
-      runTool(repoRoot, 'slack-notify.js', [
-        'task-update',
-        '--task', ref,
-        '--status', status,
-        '--commit', commit.hash,
-        '--author', commit.author,
-        '--message', commit.message,
-      ])
-    }
-
-    // Sprint completion check (if task completed)
-    if (shouldComplete) {
-      const sprint = findSprintForTask(registry, ref)
-      if (sprint) {
-        const tasksInSprint = Object.entries(registry.taskSprintMap || {})
-          .filter(([, sid]) => sid === sprint.id)
-          .map(([tid]) => tid)
-        const completedTasks = tasksInSprint.filter(tid => {
-          const cuId = registry.taskMap?.[tid]
-          if (!cuId) return false
-          return true
-        })
-        if (tasksInSprint.length > 0 && completedTasks.length === tasksInSprint.length) {
-          if (hasSlack) {
-            runTool(repoRoot, 'slack-notify.js', [
-              'sprint-complete',
-              '--sprint', sprint.id,
-              '--name', sprint.name,
-              '--tasks', tasksInSprint.join(', '),
-            ])
-          }
-        }
-      }
-    }
-  }
-}
-
-main().catch(() => {}).finally(() => process.exit(0))