ganbatte-os 0.2.38 → 0.2.42

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

@@ -1,271 +0,0 @@
-#!/usr/bin/env node
-
-// slack-notify.js — Slack notification tool (zero-dep)
-// Usage: node slack-notify.js <command> [--options]
-// 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
-const BOT_TOKEN = process.env.SLACK_BOT_TOKEN
-
-function parseArgs(argv) {
-  const result = { _: [] }
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i]
-    if (arg.startsWith('--')) {
-      const key = arg.slice(2)
-      const next = argv[i + 1]
-      if (next && !next.startsWith('--')) {
-        result[key] = next
-        i++
-      } else {
-        result[key] = true
-      }
-    } else {
-      result._.push(arg)
-    }
-  }
-  return result
-}
-
-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 }
-  }
-
-  const res = await fetch(WEBHOOK_URL, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify(payload),
-  })
-
-  const text = await res.text()
-  if (res.ok) {
-    return { sent: true, status: res.status }
-  }
-  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;')
-}
-
-function buildTaskDonePayload(taskId, commit, author, extra = {}) {
-  const sprint = extra.sprint || ''
-  const track = extra.track || ''
-  const message = extra.message || ''
-
-  const lines = [`*:white_check_mark: Task Concluída*`]
-  lines.push(`>*Task:* ${escapeSlack(taskId)}${message ? ` — ${escapeSlack(message)}` : ''}`)
-  if (sprint) lines.push(`>*Sprint:* ${escapeSlack(sprint)}`)
-  if (track) lines.push(`>*Track:* ${escapeSlack(track)}`)
-  lines.push(`>*Commit:* \`${escapeSlack(commit.slice(0, 7))}\`${message ? ` — ${escapeSlack(message)}` : ''}`)
-  lines.push(`>*Author:* ${escapeSlack(author)}`)
-
-  return { text: lines.join('\n') }
-}
-
-function buildSprintSummaryPayload(data) {
-  const summary = data.summary || data
-  const name = data.sprint?.name || data.name || 'Sprint'
-  const now = Math.floor(Date.now() / 1000)
-
-  return {
-    blocks: [
-      {
-        type: 'header',
-        text: { type: 'plain_text', text: `:bar_chart: ${name} — Status Update` }
-      },
-      {
-        type: 'section',
-        fields: [
-          { type: 'mrkdwn', text: `*Total:*\n${summary.totalTasks || 0} tasks` },
-          { type: 'mrkdwn', text: `*Done:*\n${summary.done || 0} (${summary.completionPct || 0}%)` }
-        ]
-      },
-      {
-        type: 'section',
-        fields: [
-          { type: 'mrkdwn', text: `*In Progress:*\n${summary.inProgress || 0}` },
-          { type: 'mrkdwn', text: `*Blocked:*\n${summary.blocked || 0}` }
-        ]
-      },
-      { type: 'divider' },
-      {
-        type: 'context',
-        elements: [
-          { type: 'mrkdwn', text: `Updated: <!date^${now}^{date_short} {time}|${new Date().toISOString()}>` }
-        ]
-      }
-    ]
-  }
-}
-
-async function main() {
-  let result
-
-  switch (cmd) {
-    case 'send': {
-      if (args.text) {
-        result = await sendWebhook({ text: args.text })
-      } else if (args['blocks-file']) {
-        const { readFileSync } = require('node:fs')
-        try {
-          const payload = JSON.parse(readFileSync(args['blocks-file'], 'utf-8'))
-          result = await sendWebhook(payload)
-        } catch (e) {
-          result = { error: `Failed to read ${args['blocks-file']}: ${e.message}` }
-        }
-      } else {
-        result = { error: '--text or --blocks-file required' }
-      }
-      break
-    }
-
-    case 'task-done': {
-      if (!args.task || !args.commit || !args.author) {
-        result = { error: '--task, --commit, and --author required' }; break
-      }
-      const payload = buildTaskDonePayload(args.task, args.commit, args.author, {
-        sprint: args.sprint,
-        track: args.track,
-        message: args.message,
-      })
-      result = await sendWebhook(payload)
-      break
-    }
-
-    case 'sprint-summary': {
-      if (!args.file) { result = { error: '--file (sprint status JSON) required' }; break }
-      const { readFileSync } = require('node:fs')
-      try {
-        const data = JSON.parse(readFileSync(args.file, 'utf-8'))
-        const payload = buildSprintSummaryPayload(data)
-        result = await sendWebhook(payload)
-      } catch (e) {
-        result = { error: `Failed to read ${args.file}: ${e.message}` }
-      }
-      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',
-        usage: {
-          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*',
-          italic: '_text_',
-          strike: '~text~',
-          code: '`code`',
-          codeBlock: '```multi-line```',
-          quote: '>quoted text',
-          link: '<url|display text>',
-          mention: '<@USER_ID>',
-          channel: '<#CHANNEL_ID>',
-          date: '<!date^UNIX_TS^{date_short} {time}|fallback>',
-        },
-        flags: {
-          '--dry-run': 'Show payload without sending',
-        }
-      }
-  }
-
-  console.log(JSON.stringify(result, null, 2))
-}
-
-main().catch(err => {
-  console.error(JSON.stringify({ error: err.message }))
-  process.exit(0) // Always exit 0 — notification failure should never block
-})

package/.gos/skills/clickup/SKILL.md

@@ -1,151 +0,0 @@
----
-name: clickup
-description: >
-  Manage ClickUp workspace, sprints (via folders), lists, tasks, subtasks and custom fields
-  via MCP. Create and sync sprints, import tasks from markdown plans, track sprint status.
-description_pt-BR: >
-  Gerenciar workspace, sprints (via folders), lists, tasks, subtasks e custom fields no
-  ClickUp via MCP. Criar e sincronizar sprints, importar tasks de planos markdown, acompanhar status.
-argument-hint: "[e.g. 'criar sprint S04 com tasks do plano']"
-type: prompt
-version: "2.0.0"
-env:
-  - CLICKUP_TRANSPORT
-categories: [project-management, tasks, sprint, agile, clickup]
-allowedTools: [Read, Glob, Grep, Write, Edit, AskUserQuestion, mcp__clickup__*]
-use-when:
-  - criar sprint no ClickUp a partir de plano ou markdown
-  - sincronizar stories/tasks locais com ClickUp
-  - consultar status de sprint ou tasks no ClickUp
-  - importar tasks de sprint-track markdown para ClickUp
-  - listar workspaces, spaces, folders, lists
-  - marcar task como concluida no ClickUp
-  - criar subtasks
-do-not-use-for:
-  - planejamento de sprint do zero (use /sprint-planner primeiro)
-  - criacao de stories sem plano aprovado (use @sm ou @po)
-  - hotfix ou ajuste pontual sem necessidade de sync
-  - gantt charts ou burndown (nao disponivel via API)
-metadata:
-  category: integration
-  version: 2.0.0
----
-
-# clickup
-
-Voce esta executando a skill `clickup`. Transport: **MCP only**.
-
-## Task
-
-$ARGUMENTS
-
-Se nenhum argumento foi fornecido, pergunte ao usuario o que deseja fazer.
-
-## MCP Tools
-
-Todas as operacoes usam tools `mcp__clickup__*` (OAuth via MCP server).
-
-### Discovery
-
-- Listar hierarchy: `clickup_get_workspace_hierarchy`
-- Buscar tasks: `clickup_search` com keywords
-- Filtrar tasks: `clickup_filter_tasks` com list_ids, assignees, statuses
-- Resolver assignees: `clickup_resolve_assignees` (nome/email -> user ID)
-
-### Sprint (Folder + List)
-
-Sprints sao modelados como Folders no ClickUp:
-
-1. Criar folder: `clickup_create_folder` com `space_id` e nome
-2. Criar list: `clickup_create_list_in_folder` com `folder_id`
-
-Convencao de nomes:
-- Folder: `S04 -- Fractus: Fase 2a Coleta Templates`
-- List: `Backlog`
-
-### Task Operations
-
-- **Criar:** `clickup_create_task` com `list_id`, `name`, `markdown_description`, `priority`, `assignees`, `start_date`, `due_date`
-- **Atualizar:** `clickup_update_task` com `task_id` + campos a alterar
-- **Subtask:** `clickup_create_task` com `parent` (task ID pai)
-- **Tags:** `clickup_add_tag_to_task`
-- **Dependencias:** `clickup_add_task_dependency`, `clickup_add_task_link`
-- **Comentarios:** `clickup_create_task_comment`
-- **Mover:** `clickup_move_task`
-
-### Capabilities adicionais
-
-- Time tracking: `clickup_start_time_tracking`, `clickup_stop_time_tracking`, `clickup_add_time_entry`
-- Docs: `clickup_create_document`, `clickup_create_document_page`, `clickup_update_document_page`
-- Chat: `clickup_send_chat_message`, `clickup_get_chat_channels`
-
-### Limitacoes do MCP
-
-O MCP nao suporta:
-- Checklist nativa (criar/editar)
-- Delete de folder
-- Delete de task
-- Create de tag (tag precisa existir no space)
-
-## Regras de Formatacao
-
-Ao criar ou atualizar tasks no ClickUp via MCP, seguir:
-
-### Descricao
-
-1. **Idioma:** Secoes em portugues com acentos
-2. **Sem emojis:** Nunca usar emojis/icones nos headers ou corpo
-3. **Headers H3:** Usar `###` para secoes (nao H1 ou H2)
-4. **Descricao primeiro:** Texto livre no topo, sem header proprio
-5. **Separador:** `---` entre descricao e secoes estruturadas
-6. **Formatacao inline:**
-   - Arquivos em backticks: `` `lib/prisma.ts` ``
-   - Business rules em backticks separados por ` . `: `` `BR-TPL-001` . `BR-TPL-002` ``
-   - Criterios de aceite como checkboxes: `- [ ] Descricao do criterio`
-7. **Ordem das secoes:** Regras de Negocio -> Arquivos -> Criterios de Aceite
-8. **Usar `markdown_description`** (nao `description`) ao chamar `update_task` ou `create_task`
-
-### Subtasks -- quando usar
-
-| Recurso | Quando usar | Exemplo |
-|---------|------------|---------|
-| **Subtask** | Trabalho decomponivel com status e assignee proprios | Cada endpoint de uma API CRUD, cada step de um wizard |
-| **Criterios na descricao** | Itens verificaveis sem workflow proprio | `- [ ] Testes passando`, `- [ ] Migration sem erros` |
-
-### Template de referencia
-
-```markdown
-Texto livre da descricao aqui.
-
----
-
-### Regras de Negocio
-`BR-TPL-001` . `BR-TPL-002`
-
-### Arquivos
-- `app/api/route.ts`
-- `lib/prisma.ts`
-
-### Criterios de Aceite
-- [ ] Primeiro criterio
-- [ ] Segundo criterio
-```
-
-## Pre-processamento de Texto
-
-O script `scripts/tools/clickup-preprocess.js` pode ser usado para sanitizar textos antes de enviar ao MCP:
-
-```bash
-echo '{"description":"texto","acceptanceCriteria":["item1"]}' | node scripts/tools/clickup-preprocess.js --json
-```
-
-Output inclui `description` formatado com todas as secoes. Usar o campo `description` do output como `markdown_description` no MCP.
-
-No modo MCP direto (sem script), aplicar as mesmas regras manualmente.
-
-## Error Handling
-
-- **Rate limit (429):** MCP retenta automaticamente
-- **Auth error:** Chamar `clickup_authenticate` para iniciar OAuth
-- **Not found (404):** Verificar IDs de space/folder/list/task
-- **Team not authorized:** Re-autenticar via `clickup_authenticate`

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

@@ -1,91 +0,0 @@
----
-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`