ganbatte-os 0.2.20 → 0.2.22

package/.gos/scripts/tools/text-sanitize.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+
+// text-sanitize.js — Sanitizador de texto pt-BR determinístico
+// Zero-dep. Aplica subset de .gos/libraries/content/ai-writing-patterns.md + acentos.
+//
+// Uso:
+//   node text-sanitize.js --text "texto aqui"
+//   node text-sanitize.js --file path.md
+//   node text-sanitize.js --text "..." --json
+//
+// Export:
+//   const { sanitize } = require('./text-sanitize.js')
+//   const { text, changes } = sanitize(input)
+
+'use strict'
+
+// ---------------------------------------------------------------------------
+// Dicionários (word-boundary, case preservado no prefixo)
+// ---------------------------------------------------------------------------
+
+// P07 — vocabulário IA → equivalente natural pt-BR
+const AI_VOCAB = {
+  'aprimorar': 'melhorar',
+  'aprimorando': 'melhorando',
+  'aprimorada': 'melhorada',
+  'aprimorado': 'melhorado',
+  'fomentar': 'estimular',
+  'fomentando': 'estimulando',
+  'intrincado': 'complexo',
+  'intrincada': 'complexa',
+  'adicionalmente': 'além disso',
+  'aprofundar': 'detalhar',
+  'aprofundando': 'detalhando',
+  'crucial': 'importante',
+  'cruciais': 'importantes',
+  'fundamental': 'essencial',
+  'fundamentais': 'essenciais',
+  'duradouro': 'permanente',
+  'duradoura': 'permanente',
+  'vibrante': 'ativo',
+  'vibrantes': 'ativos',
+  'renomado': 'conhecido',
+  'renomada': 'conhecida',
+  'deslumbrante': 'impressionante',
+  'imperdivel': 'recomendado',
+  'imperdível': 'recomendado',
+  'testemunho': 'exemplo',
+  'tapecaria': 'conjunto',
+  'tapeçaria': 'conjunto',
+  'sublimar': 'destacar',
+}
+
+// Acentos faltantes pt-BR — apenas adiciona acento, não muda palavra
+const MISSING_ACCENTS = {
+  'concluida': 'concluída', 'concluidas': 'concluídas', 'concluido': 'concluído', 'concluidos': 'concluídos',
+  'atualizacao': 'atualização', 'atualizacoes': 'atualizações',
+  'implementacao': 'implementação', 'implementacoes': 'implementações',
+  'validacao': 'validação', 'validacoes': 'validações',
+  'notificacao': 'notificação', 'notificacoes': 'notificações',
+  'configuracao': 'configuração', 'configuracoes': 'configurações',
+  'integracao': 'integração', 'integracoes': 'integrações',
+  'migracao': 'migração', 'migracoes': 'migrações',
+  'correcao': 'correção', 'correcoes': 'correções',
+  'execucao': 'execução',
+  'sessao': 'sessão', 'sessoes': 'sessões',
+  'descricao': 'descrição', 'descricoes': 'descrições',
+  'operacao': 'operação', 'operacoes': 'operações',
+  'geracao': 'geração',
+  'criacao': 'criação',
+  'remocao': 'remoção',
+  'revisao': 'revisão',
+  'versao': 'versão', 'versoes': 'versões',
+  'decisao': 'decisão', 'decisoes': 'decisões',
+  'conexao': 'conexão', 'conexoes': 'conexões',
+  'expressao': 'expressão', 'expressoes': 'expressões',
+  'apos': 'após',
+  'pos': 'pós',
+  'ate': 'até',
+  'tambem': 'também',
+  'alem': 'além',
+  'porem': 'porém',
+  'ja': 'já',
+  'nao': 'não',
+  'sao': 'são',
+  'pre': 'pré',
+  'nivel': 'nível', 'niveis': 'níveis',
+  'codigo': 'código', 'codigos': 'códigos',
+  'usuario': 'usuário', 'usuarios': 'usuários',
+  'relatorio': 'relatório', 'relatorios': 'relatórios',
+  'diretorio': 'diretório', 'diretorios': 'diretórios',
+  'arquivo': 'arquivo', // no-op control
+  'servico': 'serviço', 'servicos': 'serviços',
+  'pratica': 'prática', 'praticas': 'práticas',
+  'basico': 'básico', 'basicos': 'básicos',
+  'automatico': 'automático', 'automaticos': 'automáticos',
+  'automatica': 'automática', 'automaticas': 'automáticas',
+  'dinamico': 'dinâmico', 'dinamica': 'dinâmica',
+  'estatico': 'estático', 'estatica': 'estática',
+  'historico': 'histórico', 'historica': 'histórica',
+  'pagina': 'página', 'paginas': 'páginas',
+  'duvida': 'dúvida', 'duvidas': 'dúvidas',
+  'area': 'área', 'areas': 'áreas',
+  'apos': 'após',
+  'proximo': 'próximo', 'proxima': 'próxima', 'proximos': 'próximos', 'proximas': 'próximas',
+  'unico': 'único', 'unica': 'única', 'unicos': 'únicos', 'unicas': 'únicas',
+  'publico': 'público', 'publica': 'pública',
+  'pratico': 'prático', 'pratica': 'prática',
+  'possivel': 'possível', 'possiveis': 'possíveis',
+  'disponivel': 'disponível', 'disponiveis': 'disponíveis',
+  'responsavel': 'responsável', 'responsaveis': 'responsáveis',
+  'util': 'útil', 'uteis': 'úteis',
+  'tres': 'três',
+  'seculo': 'século', 'seculos': 'séculos',
+  'hifen': 'hífen', 'hifens': 'hífens',
+  'voce': 'você', 'voces': 'vocês',
+  'portugues': 'português',
+  'ingles': 'inglês',
+  'contem': 'contém',
+  'atencao': 'atenção',
+  'instalacao': 'instalação',
+  'organizacao': 'organização', 'organizacoes': 'organizações',
+  'informacao': 'informação', 'informacoes': 'informações',
+  'documentacao': 'documentação',
+  'autenticacao': 'autenticação',
+  'aplicacao': 'aplicação', 'aplicacoes': 'aplicações',
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+const CODE_FENCE = /```[\s\S]*?```/g
+const INLINE_CODE = /`[^`\n]+`/g
+const COMMIT_HASH = /\b[0-9a-f]{7,40}\b/g
+const TASK_ID = /\bT-\d{3}\b/g
+
+function protectSpans(text) {
+  const spans = []
+  const replaced = text
+    .replace(CODE_FENCE, (m) => { spans.push(m); return `\u0000${spans.length - 1}\u0000` })
+    .replace(INLINE_CODE, (m) => { spans.push(m); return `\u0000${spans.length - 1}\u0000` })
+  return { text: replaced, spans }
+}
+
+function restoreSpans(text, spans) {
+  return text.replace(/\u0000(\d+)\u0000/g, (_, idx) => spans[Number(idx)])
+}
+
+function matchCase(original, replacement) {
+  if (original === original.toUpperCase() && original.length > 1) return replacement.toUpperCase()
+  if (original[0] === original[0].toUpperCase()) return replacement[0].toUpperCase() + replacement.slice(1)
+  return replacement
+}
+
+function applyDict(text, dict, ruleName, changes) {
+  // ordena por tamanho desc para evitar que "concluida" case com "concluidas"
+  const keys = Object.keys(dict).sort((a, b) => b.length - a.length)
+  for (const from of keys) {
+    const to = dict[from]
+    const re = new RegExp(`\\b${from.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`, 'gi')
+    text = text.replace(re, (m) => {
+      const out = matchCase(m, to)
+      changes.push({ rule: ruleName, before: m, after: out })
+      return out
+    })
+  }
+  return text
+}
+
+// ---------------------------------------------------------------------------
+// Transformações
+// ---------------------------------------------------------------------------
+
+function stripLeadingEmojis(text, changes) {
+  const emojiAtLineStart = /^[ \t]*([\u2705\u274C\u26A0\u{1F680}\u2B50\u{1F3AF}\u{1F4A1}\u{1F527}\u{1F389}\u{1F525}\u{1F44D}\u{1F44C}])\s+/gmu
+  return text.replace(emojiAtLineStart, (m, emoji) => {
+    changes.push({ rule: 'P17-emoji-bullet', before: emoji, after: '' })
+    return m.replace(emojiAtLineStart, '').replace(/^[ \t]+/, '') || ''
+  })
+}
+
+function normalizeDashes(text, changes) {
+  // em-dash entre palavras sem espaço de travessão legítimo → hyphen
+  // Padrão travessão: " — " (espaço-dash-espaço) é legítimo; "word—word" não
+  const re = /(\w)—(\w)/g
+  return text.replace(re, (m, a, b) => {
+    changes.push({ rule: 'P14-dash', before: '—', after: '-' })
+    return `${a}-${b}`
+  })
+}
+
+// ---------------------------------------------------------------------------
+// API pública
+// ---------------------------------------------------------------------------
+
+function sanitize(input) {
+  if (!input || typeof input !== 'string') return { text: input || '', changes: [] }
+  const changes = []
+  const { text: protectedText, spans } = protectSpans(input)
+  let out = protectedText
+  out = stripLeadingEmojis(out, changes)
+  out = normalizeDashes(out, changes)
+  out = applyDict(out, MISSING_ACCENTS, 'spell-accent', changes)
+  out = applyDict(out, AI_VOCAB, 'P07-ai-vocab', changes)
+  out = restoreSpans(out, spans)
+  return { text: out, changes }
+}
+
+module.exports = { sanitize, AI_VOCAB, MISSING_ACCENTS }
+
+// ---------------------------------------------------------------------------
+// CLI
+// ---------------------------------------------------------------------------
+
+if (require.main === module) {
+  const args = process.argv.slice(2)
+  let input = ''
+  let json = false
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i]
+    if (a === '--text') input = args[++i] || ''
+    else if (a === '--file') {
+      const fs = require('node:fs')
+      input = fs.readFileSync(args[++i], 'utf8')
+    } else if (a === '--json') json = true
+    else if (a === '--stdin') {
+      input = require('node:fs').readFileSync(0, 'utf8')
+    }
+  }
+  if (!input) {
+    try { input = require('node:fs').readFileSync(0, 'utf8') } catch { /* empty */ }
+  }
+  const result = sanitize(input)
+  if (json) process.stdout.write(JSON.stringify(result, null, 2) + '\n')
+  else process.stdout.write(result.text)
+}

package/.gos/skills/registry.json

@@ -18,6 +18,7 @@
     { "slug": "agent-teams", "path": "skills/agent-teams/SKILL.md" },
     { "slug": "git-ssh-setup", "path": "skills/git-ssh-setup/SKILL.md" },
     { "slug": "humanizer", "path": "skills/humanizer/SKILL.md" },
-    { "slug": "weekly-update", "path": "skills/weekly-update/SKILL.md" }
+    { "slug": "weekly-update", "path": "skills/weekly-update/SKILL.md" },
+    { "slug": "slack-review", "path": "skills/slack-review/SKILL.md" }
   ]
 }

package/.gos/skills/slack-review/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: slack-review
+description: Revisar, editar e aprovar drafts de notificações Slack pendentes em .gos/slack-queue/. Use quando o usuário pedir para "revisar notificações", "aprovar Slack", "enviar notificações pendentes" ou após commits que dispararam o hook post-commit-sync.
+argument-hint: "[opcional: id específico, --flush, --reject-all]"
+use-when:
+  - usuário pediu para revisar/aprovar notificações Slack pendentes
+  - após commit em branch com hook post-commit-sync instalado
+  - fila .gos/slack-queue/ tem drafts pendentes
+  - preciso enviar atualização de task para o Slack com aprovação humana
+do-not-use-for:
+  - envio imediato sem revisão (use `node slack-notify.js --send-now`)
+  - textos longos (propostas, emails) — use /humanizer primeiro
+  - drafts em canal custom sem webhook configurado
+metadata:
+  category: workflow
+  version: "1.0.0"
+---
+
+# Skill: /slack-review — Aprovar notificações Slack
+
+Revisar drafts enfileirados por `post-commit-sync.js` antes de enviar ao Slack. Aprovar, editar inline ou rejeitar cada um.
+
+## Quando usar
+
+- Depois de um commit com `T-NNN` no message — hook enfileira draft em `.gos/slack-queue/`.
+- Usuário pediu para revisar ou aprovar notificações pendentes.
+- Antes de push/deploy quando vários commits foram feitos e é preciso consolidar notificações.
+
+## Pré-requisitos
+
+- `SLACK_WEBHOOK_URL` configurado em `.env` na raiz.
+- Fila em `.gos/slack-queue/` existe (criada automaticamente pelo hook).
+
+## Fluxo
+
+### 1. Listar pendentes
+
+```bash
+node .gos/scripts/tools/slack-queue.js list
+```
+
+Saída esperada: lista de drafts com id, task, commit, author e primeira linha do payload.
+
+Se vazio → informar usuário e encerrar.
+
+### 2. Iterar cada draft
+
+Para cada draft pendente:
+
+1. Mostrar preview via `node .gos/scripts/tools/slack-queue.js show <id>`.
+2. Renderizar o `payload.text` em bloco markdown para o usuário ver.
+3. Via `AskUserQuestion`, perguntar: **aprovar · editar · rejeitar · pular**.
+
+### 3. Ações
+
+- **Aprovar**: `node .gos/scripts/tools/slack-queue.js approve <id>` — envia e move para `sent/`.
+- **Editar**: propor reescrita do texto (aplicar princípios do `/humanizer` mentalmente se o texto tiver padrões IA residuais). Mostrar diff, pedir confirmação. Salvar via editar o JSON direto ou chamar `slack-queue.js edit <id>` (abre $EDITOR).
+- **Rejeitar**: `node .gos/scripts/tools/slack-queue.js reject <id> [--reason "..."]` — move para `rejected/`.
+- **Pular**: deixa pendente para próxima run.
+
+### 4. Atalhos
+
+- `node .gos/scripts/tools/slack-queue.js flush` — aprova todos pendentes de uma vez (só usar quando já revisou visualmente e tem certeza).
+- `node .gos/scripts/tools/slack-queue.js list --json` — saída JSON para processamento programático.
+
+## Exemplos
+
+### Exemplo 1 — Revisão simples
+
+Usuário: "Revisa as notificações Slack pendentes"
+
+1. `slack-queue.js list` → 2 drafts (T-110, T-082).
+2. Para T-110: mostrar preview, perguntar. Usuário aprova → `approve`.
+3. Para T-082: mostrar preview, usuário pede para editar "Commit: wip" → propor "Commit: progresso inicial", confirmar, aplicar, approve.
+
+### Exemplo 2 — Edição com humanização leve
+
+Preview traz "Task concluida aprimorando a validacao". O `text-sanitize.js` já teria corrigido isso, mas se escapou (ex: texto veio via `send --text` sem pipeline), propor reescrita: "Task concluída: validação melhorada". Confirmar com usuário.
+
+## Troubleshooting
+
+- **"SLACK_WEBHOOK_URL não configurado"** no approve: checar `.env` na raiz, recarregar env.
+- **Draft preso em pending após approve**: verificar se `sent/` foi criado e o arquivo foi movido. Se falhou no POST, ver status no output JSON.
+- **Lista vazia mas esperava drafts**: confirmar que commit usou `T-NNN` e hook rodou (`ls .git/hooks/post-commit`). Ver [docs/slack-notifications.md](../docs/slack-notifications.md).
+
+## Referências
+
+- Pipeline completo: `.gos/docs/slack-notifications.md`
+- CLI: `.gos/scripts/tools/slack-queue.js`
+- Sanitização: `.gos/scripts/tools/text-sanitize.js`
+- Payload builders: `.gos/scripts/tools/slack-notify.js`

package/.gos/skills/weekly-update/CHANGELOG.md

@@ -0,0 +1,84 @@
+# weekly-update — Changelog
+
+## 2026-04-17 — v2.0 (Web API, thread obrigatória, auto-descoberta)
+
+Mudanças estruturais motivadas por incidente em produção: o envio via incoming webhook caiu fora da thread "Conversa semanal" e gerou mensagem isolada no canal #cnpq-tech.
+
+### Incidente
+
+- **O quê:** weekly-update postou como mensagem nova no canal em vez de dentro da thread.
+- **Causa raiz:** incoming webhook do Slack não suporta `thread_ts`. O skill (v1.x) tentava passar `--thread-ts` para `slack-notify.js send`, mas o script ignorava (webhook path).
+- **Impacto:** poluição do canal + confusão visual; mensagem correta teve que ser reenviada e a errada deletada manualmente (API rejeitou `chat.delete` com `cant_delete_message` porque webhook é identidade separada mesmo dentro do mesmo app).
+
+### Migração obrigatória: Web API (chat.postMessage)
+
+- Weekly-update **não usa mais webhook**. Passa a usar `chat.postMessage` via Web API com bot token.
+- Env vars novas (ambas obrigatórias):
+  - `SLACK_BOT_TOKEN=xoxb-...` — Bot User OAuth Token.
+  - `SLACK_CHANNEL_ID_WEEKLY=C0ADYLL6W0K` — ID do canal #cnpq-tech.
+- Env var antiga `SLACK_WEBHOOK_CSPO_TECH` **não é mais usada pelo weekly-update** (continua viva para hooks de commit/task, sem impacto).
+
+### Scopes necessários no bot (app Slack)
+
+- `chat:write` — postar mensagens.
+- `chat:write.public` — postar em canais públicos sem invite (opcional).
+- `groups:history` — ler histórico de canais privados (necessário para auto-descoberta de thread).
+- Após adicionar qualquer scope: **Reinstall to Ganbatte** no painel OAuth (sem reinstall o token não ganha o scope).
+- Bot precisa ser convidado no canal privado: `/invite @autocommit` em `#cnpq-tech`.
+
+### Thread obrigatória
+
+- Skill cancela o envio se não conseguir resolver `thread_ts`. Nunca mais cai em "mensagem nova no canal".
+- Ordem de resolução do `thread_ts` (Phase 5):
+  1. Link do Slack em `$ARGUMENTS` → extrai ts.
+  2. **Auto-descoberta** via `slack-notify.js find-thread` (novo) — busca mensagem mais recente que bata com o regex.
+  3. Fallback: `AskUserQuestion` pedindo o link.
+
+### Auto-descoberta de thread
+
+Novo comando no CLI:
+
+```bash
+node .gos/scripts/tools/slack-notify.js find-thread \
+  --channel-id "$SLACK_CHANNEL_ID_WEEKLY" \
+  --pattern "CHECK-POINT ASSÍNCRONO|Conversa semanal"
+```
+
+Retorno:
+```json
+{ "found": true, "ts": "1776445206.005489", "text_preview": "..." }
+```
+
+Resolve o `thread_ts` da última mensagem que bate com o pattern — dispensa cole manual de link a cada semana.
+
+### Anti-sobreposição entre updates (Phase 1)
+
+Dois mecanismos cumulativos:
+
+1. **Arquivo de estado** `.gos/.weekly-update-last-run.json` — armazena `last_run_date` (YYYY-MM-DD). Skill usa como piso do filtro ClickUp (`date_done_from`). Gravado apenas após `sent: true`.
+2. **Arquivo do update anterior** `.gos/weekly-updates/YYYY-MM-DD.md` — texto íntegro do último envio. Skill lê o mais recente em Phase 1 e cruza contra o draft em Phase 2/4, descartando menções duplicadas (cobre casos em que uma task foi reportada proativamente e só fechou no ClickUp na janela seguinte).
+
+### Janela de busca default
+
+- Era 10 dias. Agora 7 (fallback quando não há `last_run_date`). Alinha com cadência semanal.
+
+### Template — quebra visual entre título e corpo
+
+- Todas as seções (`*O que foi feito*`, `*Desafios encontrados*`, etc.) agora têm linha em branco entre título e primeiro parágrafo. Slack renderia colado antes.
+
+### Novos comandos no `slack-notify.js`
+
+| Comando | Uso | Scope necessário |
+|---|---|---|
+| `send --channel-id C... --thread-ts TS` | Post via Web API em thread | `chat:write` |
+| `delete --channel-id C... --ts TS` | Apagar mensagem do próprio bot | `chat:write` (do app autor) |
+| `find-thread --channel-id C... --pattern REGEX` | Achar ts mais recente que bata com regex | `groups:history` (privado) |
+
+### Limitações conhecidas
+
+- `chat.delete` só funciona para mensagens postadas pelo **mesmo token**. Webhook conta como identidade separada — mensagens antigas postadas via webhook não podem ser deletadas via API mesmo que o app seja o mesmo. Delete manual no Slack UI é o único caminho nesse caso.
+
+### Coexistência com hooks de commit
+
+- Hooks pós-commit (`task-done`, `task-update`, `sprint-summary`) continuam em `SLACK_WEBHOOK_URL` via `sendWebhook`. Zero impacto.
+- Weekly-update é o único fluxo que migrou para Web API.

package/.gos/tests/hooks/storybook-branch-check.test.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# Smoke test do hook storybook-branch-check.sh (T-104)
+set -e
+
+HOOK=".claude/hooks/storybook-branch-check.sh"
+export CLAUDE_PROJECT_DIR="$(pwd)"
+
+fail() { echo "FAIL: $1"; exit 1; }
+
+echo "=== Test 1: UserPromptSubmit com 'storybook' ==="
+OUT=$(echo '{"user_prompt":"edite a story do Button no storybook"}' | bash "$HOOK")
+current=$(git -C packages/fractus branch --show-current 2>/dev/null || echo unknown)
+if [ "$current" != "feat/storybook" ]; then
+  [[ "$OUT" == *"STORYBOOK BRANCH CONTEXT"* ]] || fail "warning nao injetado (branch=$current). Output: $OUT"
+  echo "PASS: warning injetado (branch=$current)"
+else
+  [[ -z "$OUT" ]] || fail "deveria ser silencioso em feat/storybook. Output: $OUT"
+  echo "PASS: silencioso em feat/storybook"
+fi
+
+echo "=== Test 2: prompt sem storybook (silencioso) ==="
+OUT=$(echo '{"user_prompt":"liste as tasks abertas"}' | bash "$HOOK")
+[[ -z "$OUT" ]] || fail "deveria ser silencioso. Output: $OUT"
+echo "PASS: silencioso"
+
+echo "=== Test 3: PreToolUse em .stories.tsx ==="
+OUT=$(echo '{"tool_input":{"file_path":"/e/Github/Ganbatte/packages/fractus/src/components/Button.stories.tsx"}}' | bash "$HOOK")
+if [ "$current" != "feat/storybook" ]; then
+  [[ "$OUT" == *"STORYBOOK BRANCH CONTEXT"* ]] || fail "warning nao injetado por file_path. Output: $OUT"
+  echo "PASS: warning por file_path"
+else
+  echo "PASS: silencioso em feat/storybook"
+fi
+
+echo "=== Test 4: exit code sempre 0 ==="
+echo '{}' | bash "$HOOK"
+code=$?
+[ "$code" -eq 0 ] || fail "exit code=$code"
+echo "PASS: exit=0"
+
+echo ""
+echo "Todos os testes passaram"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ganbatte-os",
-  "version": "0.2.20",
+  "version": "0.2.22",
   "description": "Framework operacional para design-to-code, squads de entrega e sprint sync com ClickUp.",
   "bin": {
     "ganbatte-os": ".gos/scripts/cli/gos-cli.js",