ganbatte-os 0.2.25 → 0.2.27

package/.gos/scripts/tools/slack-notify.js

@@ -1,16 +1,13 @@
 #!/usr/bin/env node
 
-// slack-notify.js — Slack notification tool via Incoming Webhooks (zero-dep)
+// slack-notify.js — Slack notification tool (zero-dep)
 // Usage: node slack-notify.js <command> [--options]
-// Auth: SLACK_WEBHOOK_URL env var (Incoming Webhook URL)
+// Auth:
+//   - Webhook commands (send, task-done, sprint-summary): SLACK_WEBHOOK_URL
+//   - Web API commands (fetch-thread, find-thread): SLACK_BOT_TOKEN
 
 const WEBHOOK_URL = process.env.SLACK_WEBHOOK_URL
-
-if (!WEBHOOK_URL) {
-  // Graceful skip — no webhook configured is not an error
-  console.log(JSON.stringify({ skipped: true, reason: 'SLACK_WEBHOOK_URL not set' }))
-  process.exit(0)
-}
+const BOT_TOKEN = process.env.SLACK_BOT_TOKEN
 
 function parseArgs(argv) {
   const result = { _: [] }
@@ -35,6 +32,19 @@ function parseArgs(argv) {
 const args = parseArgs(process.argv.slice(2))
 const [cmd, sub, ...rest] = args._
 
+const WEBHOOK_COMMANDS = new Set(['send', 'task-done', 'sprint-summary'])
+const API_COMMANDS = new Set(['fetch-thread', 'find-thread'])
+
+if (WEBHOOK_COMMANDS.has(cmd) && !WEBHOOK_URL) {
+  console.log(JSON.stringify({ skipped: true, reason: 'SLACK_WEBHOOK_URL not set' }))
+  process.exit(0)
+}
+
+if (API_COMMANDS.has(cmd) && !BOT_TOKEN) {
+  console.log(JSON.stringify({ error: 'SLACK_BOT_TOKEN not set (required for Web API commands)' }))
+  process.exit(0)
+}
+
 async function sendWebhook(payload) {
   if (args['dry-run']) {
     return { _dry_run: true, url: WEBHOOK_URL.replace(/\/[^/]{6,}$/, '/***'), payload }
@@ -53,6 +63,22 @@ async function sendWebhook(payload) {
   return { sent: false, status: res.status, body: text }
 }
 
+async function slackApi(method, params) {
+  if (args['dry-run']) {
+    return { _dry_run: true, method, params: { ...params, token: '***' } }
+  }
+  const body = new URLSearchParams(params).toString()
+  const res = await fetch(`https://slack.com/api/${method}`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/x-www-form-urlencoded',
+      'Authorization': `Bearer ${BOT_TOKEN}`,
+    },
+    body,
+  })
+  return res.json()
+}
+
 function escapeSlack(text) {
   return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
 }
@@ -155,6 +181,55 @@ async function main() {
       break
     }
 
+    case 'fetch-thread': {
+      const channel = args['channel-id'] || process.env.SLACK_CHANNEL_ID_WEEKLY
+      const ts = args['thread-ts'] || args.ts
+      if (!channel || !ts) {
+        result = { error: '--channel-id (or SLACK_CHANNEL_ID_WEEKLY) and --thread-ts required' }
+        break
+      }
+      const limit = args.limit || '100'
+      const api = await slackApi('conversations.replies', { channel, ts, limit })
+      if (!api.ok) {
+        result = { ok: false, error: api.error, needed: api.needed }
+        break
+      }
+      const messages = (api.messages || []).map(m => ({
+        user: m.user,
+        ts: m.ts,
+        text: m.text || '',
+        reply_count: m.reply_count,
+      }))
+      result = { ok: true, count: messages.length, messages }
+      break
+    }
+
+    case 'find-thread': {
+      const channel = args['channel-id'] || process.env.SLACK_CHANNEL_ID_WEEKLY
+      const pattern = args.pattern
+      if (!channel || !pattern) {
+        result = { error: '--channel-id (or SLACK_CHANNEL_ID_WEEKLY) and --pattern required' }
+        break
+      }
+      const api = await slackApi('conversations.history', { channel, limit: args.limit || '50' })
+      if (!api.ok) {
+        result = { ok: false, error: api.error, needed: api.needed }
+        break
+      }
+      const re = new RegExp(pattern, 'i')
+      const match = (api.messages || []).find(m => re.test(m.text || ''))
+      if (!match) {
+        result = { found: false }
+        break
+      }
+      result = {
+        found: true,
+        ts: match.ts,
+        text_preview: (match.text || '').slice(0, 200),
+      }
+      break
+    }
+
     default:
       result = {
         error: cmd ? `Unknown command: ${cmd}` : 'No command provided',
@@ -162,6 +237,12 @@ async function main() {
           send: 'send --text "Hello *bold* _italic_" | send --blocks-file payload.json',
           'task-done': 'task-done --task T-001 --commit abc1234 --author "Name" [--sprint "S01"] [--track backend] [--message "feat: ..."]',
           'sprint-summary': 'sprint-summary --file sprint-status.json',
+          'fetch-thread': 'fetch-thread --channel-id C... --thread-ts 1234567890.123456 [--limit 100]',
+          'find-thread': 'find-thread --channel-id C... --pattern "regex" [--limit 50]',
+        },
+        auth: {
+          webhook_commands: 'send, task-done, sprint-summary — require SLACK_WEBHOOK_URL',
+          api_commands: 'fetch-thread, find-thread — require SLACK_BOT_TOKEN (scopes: groups:history for private channels)',
         },
         formatting: {
           bold: '*text*',

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

@@ -1,5 +1,58 @@
 # weekly-update — Changelog
 
+## 2026-04-20 — v1.2.0 (modos `simple` e `detailed`, controlados por env)
+
+Motivação: na thread "Conversa semanal" de 2026-04-17, PO (U07M07M6R42) e PM (U0ADE3FT9HB) pediram explicitamente resumo em linguagem não-técnica. Citações literais:
+
+- PM: "consegue trazer um resumo em linguem nao técnica pra mim ahaha, por favor?"
+- PO: "Pensa que está em uma reunião com a gente, o que você compartilharia?"
+
+### Novo argumento e env var
+
+- `$ARGUMENTS --mode simple|detailed` sobrescreve via linha de comando.
+- `WEEKLY_UPDATE_MODE=simple|detailed` no `.env` define o padrão do projeto.
+- Se ambos ausentes, fallback para `detailed` (comportamento anterior).
+- Skill não pergunta mais — resolve via env/arg e informa o modo no início da Phase 2.
+
+### Modo `simple` (novo)
+
+Audiência não-técnica (PO/PM/clientes). Regras obrigatórias:
+
+1. Zero IDs de task (nada de T-084, T-110).
+2. Zero jargão técnico. Lista banida: API, endpoint, FK, hook, webhook, migration, deploy, pipeline, CI/CD, TypeScript, Zod, backend, frontend, SPA routing, commit, branch, merge, PR, rebase, drift, build, pre-commit.
+3. Bullets curtos em vez de parágrafos densos.
+4. Foco no valor entregue, não em como foi feito.
+5. Tom de reunião casual (primeira pessoa, contrações como "pra", "to", "tá").
+6. Alvo: 150-250 palavras.
+
+Calibração humanizer: conversacional (intensidade alta), contra os 30 pontos de padrões AI.
+
+### Modo `detailed` (comportamento anterior, preservado)
+
+Audiência técnica (tech lead, outros devs). Permite IDs de task, jargão apropriado, narrativa em parágrafos, dependências explícitas. Alvo: 300-500 palavras.
+
+### Checklist de aprovação expandido
+
+Novos itens na Phase 4:
+- Modo confirmado antes do envio.
+- Em `simple`: nenhum termo banido aparece no texto final.
+- Em `simple`: nenhum ID de task (T-XXX) aparece no texto final.
+
+### Arquivos afetados
+
+- `.gos/skills/weekly-update/SKILL.md` — Gate 3 novo, Phase 2 refatorada com templates por modo, Phase 3 com calibração por modo, Phase 4 checklist expandido.
+- `.env-example` — nova var `WEEKLY_UPDATE_MODE=simple`.
+- `.env` local Ganbatte — adicionado `WEEKLY_UPDATE_MODE=simple`.
+
+### Companion: `slack-notify.js` ganhou `fetch-thread` e `find-thread`
+
+Comandos Web API via `SLACK_BOT_TOKEN` (scope `groups:history` para canais privados). Usado pela skill e disponível para auditoria de threads passadas. Allow-rules adicionadas em `~/.claude/settings.json`:
+
+- `Bash(node .gos/scripts/tools/slack-notify.js fetch-thread:*)`
+- `Bash(node .gos/scripts/tools/slack-notify.js find-thread:*)`
+
+---
+
 ## 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.

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

@@ -3,15 +3,17 @@ name: weekly-update
 description: >
   Gera resumo das tasks concluidas nos ultimos 10 dias no ClickUp, humaniza o texto
   em pt-BR e posta como resposta na thread "Conversa semanal" do Slack (#cspo-tech).
+  Suporta dois modos: simple (curto, ~150 palavras) e detailed (completo, ~400 palavras).
   Requer aprovacao do usuario antes do envio.
 description_pt-BR: >
   Resumo semanal das tasks concluidas, humanizado com anti-AI patterns,
-  com aprovacao antes de postar na Conversa semanal do Slack.
-argument-hint: "[link da mensagem 'Conversa semanal' no Slack (opcional)]"
+  com aprovacao antes de postar na Conversa semanal do Slack. Modo simple ou detailed.
+argument-hint: "[--mode simple|detailed] [link da mensagem 'Conversa semanal' no Slack]"
 type: prompt
-version: "1.1.0"
+version: "1.2.0"
 env:
   - WEEKLY_UPDATE
+  - WEEKLY_UPDATE_MODE
   - SLACK_WEBHOOK_CSPO_TECH
 categories: [reporting, slack, clickup, weekly]
 allowedTools:
@@ -87,6 +89,28 @@ Se o valor retornado for `__MISSING__` ou vazio:
 
 Se ambos os gates passarem, prosseguir normalmente.
 
+### Gate 3 — Resolver modo de escrita
+
+Determinar `MODE` nesta ordem de precedência:
+
+1. **`$ARGUMENTS`** (maior prioridade):
+   - Contém `--mode simple` → `MODE=simple`
+   - Contém `--mode detailed` → `MODE=detailed`
+2. **Variável de ambiente `WEEKLY_UPDATE_MODE`** (default do projeto):
+   ```bash
+   echo "${WEEKLY_UPDATE_MODE:-}"
+   ```
+   - Valor `simple` → `MODE=simple`
+   - Valor `detailed` → `MODE=detailed`
+   - Vazio ou qualquer outro valor → cair para passo 3
+3. **Fallback final**: `MODE=detailed`.
+
+**Não perguntar ao usuário.** O padrão fica no `.env` (recomendado: `WEEKLY_UPDATE_MODE=simple` alinhado ao pedido da PO/PM na thread "Conversa semanal"). Só sobrescrever via argumento quando precisar de um envio técnico pontual.
+
+Informar ao usuário o modo resolvido no início da Phase 2 (ex: "Modo resolvido: `simple` (via env)").
+
+**Contexto histórico (por que existem dois modos):** a PO (não-técnica) e o PM (não-técnico) na thread "Conversa semanal" pediram explicitamente "resumo em linguagem não técnica" e "pensa que está em uma reunião com a gente, o que você compartilharia?". O modo `simple` foi desenhado para atender esse pedido. O `detailed` segue para audiência técnica (tech lead, outros devs).
+
 ---
 
 ## Phase 1 — Buscar tasks concluidas no ClickUp (ultimos 10 dias)
@@ -112,13 +136,13 @@ Se nenhuma task encontrada: informar ao usuario e encerrar.
 
 ## Phase 2 — Gerar resumo pt-BR
 
-### Template padrao
+O template e as regras variam por `MODE`. Secoes marcadas com (?) sao opcionais — incluir somente se houver conteudo relevante.
 
-O resumo DEVE seguir este template. Secoes marcadas com (?) sao opcionais — incluir somente se houver conteudo relevante.
+### Template (comum aos dois modos)
 
 ```
 *O que foi feito*
-[Narrativa agrupada por tema, tom conversacional]
+[Conteudo conforme regras do modo]
 
 *Desafios encontrados* (?)
 [Dependencias, bloqueios, decisoes dificeis]
@@ -133,17 +157,74 @@ O resumo DEVE seguir este template. Secoes marcadas com (?) sao opcionais — in
 [Pedidos de alinhamento, decisao, recurso]
 ```
 
-### Regras de redacao
+Regras comuns aos dois modos:
+- Sem emojis.
+- Titulos de secao em negrito Slack: `*titulo*`.
+- Uma linha em branco entre titulo e corpo (Slack renderiza colado sem isso).
+
+---
 
-- Agrupar entregas por **tema** (nao listar tasks uma a uma)
-- Tom: conversacional, direto, como se estivesse contando para um colega nao tecnico
-- Foco em **o que foi entregue e por que importa**, nao em nomes de tasks ou IDs
-- Sem jargao tecnico (trocar "API endpoint" por "integracao", "migration" por "ajuste no banco", etc.)
-- Sem emojis
-- Os titulos das secoes usam negrito Slack: `*titulo*`
+### Modo `detailed` — Relatório executivo (audiência técnica)
 
-Exemplo de tom desejado:
-> Nessa semana finalizei a integração do formulário de coleta com validação dos campos obrigatórios, ajustei o layout da tela de dashboard pra funcionar melhor em tablets, e corrigi um problema no fluxo de login que impedia usuários com email corporativo de acessar o sistema.
+Audiência: tech lead, outros devs, stakeholders técnicos.
+
+Regras:
+- Permite referenciar **IDs de task** (T-082, T-110, etc.) quando importa para rastreio.
+- Permite **termos técnicos** quando a audiência é técnica (API, FK, hook, TypeScript, deploy, Storybook, webhook).
+- Narrativa em **parágrafos** agrupados por tema; bullets só para listas de tasks ou bloqueios.
+- Explica **decisões** e **trade-offs** quando houver (por que X e não Y).
+- Inclui dependências explícitas ("T-084 depende da T-082 nova").
+- Tamanho alvo: 300-500 palavras.
+
+Exemplo de tom (extraído do envio real 2026-04-17):
+> *O que foi feito*
+>
+> A semana concentrou na frente de Storybook e infra de deploy. Criei a conta Vercel pra hospedar o Storybook separado, customizei a home com branding Fractus, corrigi o SPA routing e atualizei o README. Pluguei Vercel Analytics e Speed Insights nos dois apps.
+
+---
+
+### Modo `simple` — Linguagem acessível (audiência não-técnica)
+
+Audiência: PO/PM sem background técnico, clientes, time de negócio.
+
+Regras **obrigatórias** (violar qualquer uma implica reescrever):
+
+1. **Zero IDs de task.** Nunca mencionar "T-084", "T-110", "task X". Só o que foi entregue, em linguagem de valor.
+2. **Zero jargão técnico.** Banidos: API, endpoint, FK, foreign key, hook, webhook, migration, deploy, pipeline, CI/CD, TypeScript, Zod, Storybook (a menos que seja nome conhecido do produto), backend, frontend, regex, SPA routing, commit, branch, merge, PR, rebase, drift, build. Traduzir cada um:
+   - "API de diagnóstico" → "formulário de diagnóstico" ou "ferramenta pra coletar dados do diagnóstico"
+   - "Deploy no Vercel" → "publicar a página online"
+   - "Corrigi o SPA routing" → "arrumei a navegação entre telas que estava quebrada"
+   - "Hook de pre-commit" → "trava automática que impede erros de passar"
+   - "Migration" → "ajuste no banco de dados" (se precisar) ou omitir
+   - "Regras de negócio em doc próprio" → "organizei as regras do produto num documento pra validar com o time"
+3. **Bullets curtos**, não parágrafos densos. Cada bullet com 1 linha, no máximo 2. Inspirado no tom do PM do time:
+   > • Sigo trabalhando nas telas do figma.
+   > • Nessa semana liberei PRD Novo e novo padrão no Figma.
+   > • Agora to trabalhando nuns ajustes que o Adri pediu.
+4. **Foco no valor entregue**, não em como foi feito. Em vez de "configurei X e corrigi Y", usar "agora Z funciona / está disponível / está mais rápido".
+5. **Tom de reunião casual.** Primeira pessoa (eu/a gente), contrações permitidas ("pra", "to", "tá"), sem formalismo corporativo.
+6. Tamanho alvo: 150-250 palavras.
+
+Teste de validação (aplicar mentalmente antes de aprovar):
+- Se minha mãe lesse esse texto, ela entenderia o que eu fiz essa semana? Se não, reescrever.
+- Se o PO leu e vai perguntar "o que é X?" — termo X é jargão, trocar.
+
+Exemplo de tom (re-escrita do envio 2026-04-17 em modo simple):
+> *O que foi feito*
+>
+> • Coloquei o catálogo de componentes do Fractus online, com a cara nova (logo e cores).
+> • Organizei as regras do produto num documento próprio pra gente revisar junto na reunião de terça.
+> • Arrumei umas travas automáticas que impedem erros de passar adiante — ficou mais seguro pra todo mundo mexer no código.
+> • Entreguei pro Adriano Morais a ferramenta que extrai contatos de grupo do WhatsApp.
+>
+> *Pendências*
+>
+> Cinco coisas dependem de decisão da PO/PM pra destravar:
+> 1. Templates/Formulários — aguardando validação do Adriano Morais.
+> 2. Impacto — precisa definir quais métricas entram no MVP.
+> 3. Faturamento — regra de consolidação ainda em aberto.
+> 4. Acesso do Financiador — permissões não definidas.
+> 5. Toggle Ativo — comportamento ao desativar ainda não documentado.
 
 ## Phase 3 — Humanizar
 
@@ -166,10 +247,18 @@ Carregar e aplicar:
 1. `.gos/libraries/content/ai-writing-patterns.md` — catálogo de 26 padrões
 2. `.gos/skills/humanizer/SKILL.md` — processo de 5 passos
 
-Calibração: **Relatório executivo** (intensidade média)
-- Cortar enchimento e inflação
-- Manter formalidade leve
-- Não forçar primeira pessoa se não couber
+Calibração varia por `MODE`:
+
+- **`detailed`** — **Relatório executivo** (intensidade média)
+  - Cortar enchimento e inflação
+  - Manter formalidade leve
+  - Não forçar primeira pessoa se não couber
+
+- **`simple`** — **Conversacional casual** (intensidade alta)
+  - Primeira pessoa obrigatória (eu/a gente)
+  - Contrações permitidas e encorajadas (pra, to, tá, né)
+  - Cortar qualquer palavra que soe de relatório corporativo
+  - Após a passagem de humanização, validar também a regra de zero jargão técnico (Phase 2, regra 2) — se qualquer termo banido reaparecer, reescrever
 
 Processo:
 1. Identificar padrões presentes no resumo (especialmente P01, P03, P04, P07, P10, P15, P17, P19, P22)
@@ -190,10 +279,13 @@ Apresentar ao usuário:
 ### Checklist antes de aprovar
 
 Verificar e apresentar junto com o texto:
+- [ ] Modo de escrita confirmado (`simple` ou `detailed`)
 - [ ] Acentuação correta em todo o texto (não, é, há, também, além, etc.)
 - [ ] Sem uso de hífen (-) onde deveria ser travessão (—)
 - [ ] Assinatura do autor presente no final
 - [ ] Catálogo ai-writing-patterns.md foi carregado e aplicado
+- [ ] Se `MODE=simple`: nenhum termo banido apareceu (API, endpoint, FK, hook, deploy, migration, TypeScript, SPA, commit, branch, PR, merge, build, etc.)
+- [ ] Se `MODE=simple`: nenhum ID de task (T-XXX) no texto
 
 Perguntar com AskUserQuestion:
 - **"Aprovar e enviar"** — prosseguir para Phase 5
@@ -255,8 +347,10 @@ Verificar resposta:
 | Período | Últimos 10 dias |
 | Slack canal | `#cspo-tech` |
 | Webhook env var | `SLACK_WEBHOOK_CSPO_TECH` |
-| Calibração humanizer | Relatório executivo (média) |
+| Calibração humanizer | `detailed`: Relatório executivo (média) · `simple`: Conversacional (alta) |
 | Score máximo AI | 30 |
 | Template | *O que foi feito* / *Desafios* / *Em andamento* / *Pendências* / *Ajuda?* |
+| Modos | `--mode simple` (leigos, sem jargão) · `--mode detailed` (técnicos) |
+| Default (env) | `WEEKLY_UPDATE_MODE=simple` no `.env`; fallback se ausente: `detailed` |
 | Ortografia | OBRIGATÓRIA — acentos pt-BR, crase, travessão |
 | Assinatura | `— {git config user.name}` no final |

package/README.md

@@ -12,25 +12,27 @@ O **ganbatte-os** organiza agentes de IA, skills e squads num workspace pronto p
 
 ## Quick Start
 
-### 1. Instalação (Recomendado — via GitHub)
+### 1. Instalação
 
 ```bash
 mkdir meu-projeto && cd meu-projeto
 git init
-npm install github:adrianomorais-ganbatte/g-os
+npm install ganbatte-os
 ./node_modules/.bin/gos install
 ```
 
-> [!IMPORTANT]
-> **Use install via GitHub enquanto ajustamos o publish no npm registry.** A metadata `bin` esta sendo filtrada pelo registry, quebrando `npx ganbatte-os` e `npm install -g`. Track em [docs/ganbatte-os-test-report-2026-04-20.md](./docs/ganbatte-os-test-report-2026-04-20.md).
+Alternativa global:
+
+```bash
+npm install -g ganbatte-os
+gos install
+```
 
-### 1b. Instalação via npm (workaround)
+Alternativa direto do GitHub (ultima versao do main):
 
 ```bash
-mkdir meu-projeto && cd meu-projeto
-git init
-npm install ganbatte-os
-node ./node_modules/ganbatte-os/.gos/scripts/cli/gos-cli.js install
+npm install github:adrianomorais-ganbatte/g-os
+./node_modules/.bin/gos install
 ```
 
 ### 2. Pós-Instalação

package/package.json

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