---
name: daily-changelog
description: Generates daily technical changelogs and audit reports from git commits, CLI sessions, and code diffs, confirming the responsible author, categorizing by domain, and synchronizing posts to Discord Forum channel.
when_to_use: "When the user asks to generate, update, or audit daily changelogs, list daily commits/modifications, report work progress, or sync changelogs to Discord. NOT for general git operations or generic code writing."
allowed-tools: Read, Write, Edit, Grep, Glob, Bash
effort: medium
version: 2.0.0
---

# Daily Changelog — Auditoria e Registro Diário com Sync Discord Forum

> Registro técnico cirúrgico, estruturado, factual e à prova de desinformação das alterações diárias no servidor, sincronizado automaticamente com o canal Fórum do Discord.

---

## Overview

A skill `daily-changelog` padroniza e automatiza a geração de changelogs técnicos no padrão FiveM / Qbox do Distrito Paulista e sincroniza cada arquivo com o canal Fórum do Discord.
Ela assegura que:
1. **Fuso Horário Oficial Obrigatório:** Todos os registros, timestamps e datas no nome do arquivo (`YYYY-MM-DD`) DEVEM seguir obrigatoriamente o horário de Brasília / São Paulo (`America/Sao_Paulo` - UTC-3). É proibido usar a data/hora em UTC do servidor/container caso haja virada de dia.
2. **Cada desenvolvedor tem seu próprio changelog isolado** (Dege, Lomba, Morgan, etc.).
3. **NUNCA presume quem é o desenvolvedor**. É estritamente proibido herdar o nome do autor de conversas anteriores ou arquivos abertos.
4. **Seleção interativa neutra obrigatória:** Se o autor não for informado explicitamente no prompt, o agente DEVE apresentar as opções de seleção sem marcar nenhuma como recomendada.
5. **Precisão Factual Cirúrgica (Anti-Ego / Anti-Alucinação):** O agente NUNCA deve inflar ou alegar ter "recriado", "migrado completamente" ou "desenvolvido do zero" rotinas, comandos ou scripts que já existiam na base. Mudanças em parâmetros ou consultas SQL devem ser descritas com exatidão técnica.
6. **Sincronização Ativa no Fórum do Discord (Tópico com Edição Contínua):**
   - Cria uma postagem (thread) no canal Fórum do Discord com o título `[YYYY-MM-DD] Changelog - AUTOR`.
   - Conforme novas tarefas forem adicionadas ao `.md` local ao longo do dia, **a mensagem existente na thread é editada/atualizada via webhook**, mantendo o canal limpo e sempre espelhando o `.md`.
   - Se o log ultrapassar 2000 caracteres, o sincronizador divide o texto em blocos inteligentes respeitando quebras de linha e cria/edita mensagens filhas dentro da thread.

---

## Protocol

### Passo 1: Confirmação Obrigatória do Desenvolvedor via Seleção Neutra (Zero Recomendado / BLOQUEANTE)

> 🔴 **REGRA DE OURO:** NUNCA presuma quem é o desenvolvedor baseando-se em sessões anteriores ou arquivos abertos.
> Se o autor não foi explicitamente informado na mensagem atual do usuário, o agente DEVE acionar a ferramenta `ask_question` ou apresentar a seleção interativa antes de tocar em qualquer changelog:
>
> 🔴 **PROIBIÇÃO ABSOLUTA DE RECOMENDAÇÃO:** É TERMINANTEMENTE PROIBIDO prefixar qualquer opção com `(Recommended)`. Não use `(Recommended) Dege`, nem qualquer outro nome. O array `options` do `ask_question` DEVE conter estritamente nomes neutros sem qualquer tag ou prefixo de recomendação:
> ```json
> "options": ["Dege", "Lomba", "Morgan", "Outro"]
> ```
> A escolha deve ser 100% ativa, imparcial e consciente pelo usuário.

### Separação Estrita de Arquivos por Desenvolvedor:
- **Dege:** `mri_paulista/docs/changelogs/YYYY-MM-DD-dege.md`
- **Lomba:** `mri_paulista/docs/changelogs/YYYY-MM-DD-lomba.md`
- **Morgan:** `mri_paulista/docs/changelogs/YYYY-MM-DD-morgan.md`
- **Outro:** `mri_paulista/docs/changelogs/YYYY-MM-DD-[slug].md`

❌ **PROIBIÇÃO ABSOLUTA:** Jamais gravar, editar ou sobrescrever o changelog de um desenvolvedor com o trabalho de outro desenvolvedor.

---

### Passo 2: Coleta e Verificação Factual de Evidências (Anti-Inflação)

Antes de redigir qualquer item:
1. **Verifique se o recurso ou comando já existia antes:** Se um comando como `/addcasa` ou `/remcasa` já estava registrado no arquivo, NÃO escreva "criado comando". Escreva "ajustados argumentos do comando existente".
2. **Diferencie Código de Dados (Banco vs Script):** Se apenas rodou script para inserir linhas no banco MySQL a partir de um `.sql` antigo, NÃO diga que "migrou a arquitetura do script". Descreva como "importação de dados / seed no banco de dados".
3. **Evite Jargões de Auto-Promoção:** Descreva exatamente a linha, evento, callback ou tabela alterada com sobriedade técnica.

---

### Passo 3: Elaboração ou Atualização do Changelog Local (.md)

Estrutura canônica do arquivo:
```markdown
# Changelog Diário · Distrito Paulista

> **Data:** YYYY-MM-DD  
> **Responsável / Desenvolvedor:** [Nome do Desenvolvedor Confirmado]  
> **Ambiente:** [Antigravity CLI / Antigravity IDE] / FiveM Development  

---

### 📦 Resources & Coleções Modificadas
- `[colecao]/[subcolecao]/resource_name_1`
- `[colecao]/resource_name_2`

---

## [Categoria Funcional]
- **resource_name (Título Real da Modificação):**
  - Detalhe factual 1.
  - Detalhe factual 2.
```

> 💡 **Regra de Ouro da Seção de Resources Modificadas:**
> Logo após o cabeçalho inicial e antes do detalhamento das alterações, DEVE existir a lista enxuta de todos os resources modificados no dia com o caminho completo de coleções (pastas entre colchetes, ex: `[paulista]/[vanguard]/[vanguard-paulista]/[illegal]/dp_robberies`), **sem detalhamento**. Isso viabiliza a localização e envio cirúrgico dos arquivos para produção.

- Salve o arquivo no caminho canônico: `mri_paulista/docs/changelogs/YYYY-MM-DD-[autor].md`.

---

### Passo 4: Sincronização Automática com o Fórum do Discord (MANDATÓRIO)

Após criar ou atualizar o arquivo markdown local, execute o script de sincronização:

```bash
node /home/bases/.agents/skills/daily-changelog/scripts/sync-discord-forum.mjs "mri_paulista/docs/changelogs/YYYY-MM-DD-[autor].md"
```

**Como funciona a sincronização:**
1. **Canal Fórum & Webhook Oficial:** Usa o webhook configurado (`https://discord.com/api/webhooks/1567175440303525989/C2fU3oxyF3zLiY6m9ZOjuN0zy1-8ZHd8EjQeO_HbHp4tHcbFr-4o7l7iQjH83BmaTMf_`).
2. **Criação de Thread Única Diária por Autor:** Se o dia ainda não tiver postagem aberta, o script dispara `POST /webhooks/.../?wait=true` com `thread_name: "[YYYY-MM-DD] Changelog - [AUTOR]"`.
3. **Edição Conforme Cresce:** O ID da thread e das mensagens fica persistido em `mri_paulista/docs/changelogs/.discord-threads-map.json`. Quando novas alterações forem adicionadas na mesma data, o script executa `PATCH` nas mensagens existentes, mantendo o changelog no Discord perfeitamente atualizado sem poluir o fórum com posts duplicados.
4. **Tratamento de Textos Extensos:** Se o changelog ultrapassar o limite de 2000 caracteres do Discord, o script particiona o conteúdo em chunks seguros de até 1900 caracteres respeitando quebras de linhas de tópicos, editando cada mensagem correspondente ou adicionando uma nova mensagem filha à thread se novos blocos forem necessários.
