fix(gestao): corrige YAML frontmatter invalido em qw/worklog, remove ijfw_memory_recall morto, recupera report-5w2h perdido, bump 1.6.1

2026-07-04 14:21:39 +01:00
parent 2439e3b41c
commit 49502c59da
8 changed files with 958 additions and 136 deletions
@@ -0,0 +1,202 @@
+# Exemplos de Uso — /qw
+
+## Exemplo 1: Criar Ficheiro Novo
+
+**Contexto:** Acabaste de criar `novo-modulo.js` com 150 linhas.
+
+```bash
+/qw
+```
+
+**Processamento automático:**
+1. Detecta novo ficheiro: `novo-modulo.js`
+2. Actualiza `README.md` secção "Estrutura" com: `- novo-modulo.js — módulo XYZ`
+3. Cria memória mem0:
+   - Subject: "novo-modulo.js"
+   - Predicate: "criado para"
+   - Object: "funcionalidade XYZ"
+   - Tags: "feature", "javascript"
+   - Tier: "project"
+
+**Output:**
+```
+✅ Quick Wrap-up — 2026-07-02 14:23
+
+📝 RESUMO
+• novo-modulo.js criado — 150 linhas, export default class XYZ
+• README actualizado — secção Estrutura
+• Memória guardada — mem0 (feature/javascript)
+
+📦 FICHEIROS
+ + novo-modulo.js
+ ~ README.md
+
+💾 MEM0 ID: mem0_abc123...
+
+⏱️ 38s | OK
+```
+
+---
+
+## Exemplo 2: Bugfix + Docs
+
+**Contexto:** Corrigiste bug em `auth.js` linha 45 (return typo).
+
+```bash
+/qw
+```
+
+**Processamento:**
+1. Detecta ficheiro alterado: `auth.js`
+2. Actualiza `CHANGELOG.md` em `## [Unreleased]`:
+   ```
+   - 2026-07-02 [auth] Corrigido typo return em validação token
+   ```
+3. Memória mem0:
+   - Subject: "auth.js"
+   - Predicate: "bugfix"
+   - Object: "return typo validação token (linha 45)"
+   - Tags: "bugfix", "javascript"
+
+**Output:**
+```
+✅ Quick Wrap-up — 2026-07-02 14:25
+
+📝 RESUMO
+• auth.js corrigido — typo return em validação token (linha 45)
+• CHANGELOG actualizado — entrada [Unreleased]
+• Memória guardada — mem0 (bugfix/javascript)
+
+📦 FICHEIROS
+ ~ auth.js
+
+💾 MEM0 ID: mem0_def456...
+
+⏱️ 22s | OK
+```
+
+---
+
+## Exemplo 3: Usar Flag --docs
+
+**Contexto:** Já refiste 3 ficheiros mas esqueceste de actualizar README.
+
+```bash
+/qw --docs
+```
+
+**Processamento:**
+1. Detecta ficheiros alterados
+2. Apenas actualiza README/CHANGELOG
+3. Omite resumo e memória
+4. Output minimalista
+
+**Output:**
+```
+✅ Docs Updated — 2026-07-02 14:27
+
+📦 FICHEIROS
+ ~ README.md
+ ~ CHANGELOG.md
+
+⏱️ 8s | OK
+```
+
+---
+
+## Exemplo 4: Usar Flag --mem
+
+**Contexto:** Descobriste um padrão interessante durante a sessão.
+
+```bash
+/qw --mem
+```
+
+**Processamento:**
+1. Pede input: "Qual o insight para guardar?"
+2. Utilizador responde: "Usar useCallback para memoização em loops React"
+3. Formata e guarda em mem0
+4. Output: apenas ID memória
+
+**Output:**
+```
+💾 MEM0 Saved
+
+ID: mem0_ghi789...
+Entrada: "useCallback | memoização | loops React evita re-renders"
+Tags: react, performance, padrão
+Tier: global
+
+⏱️ 15s | OK
+```
+
+---
+
+## Exemplo 5: Integração com Desk CRM
+
+**Contexto:** Estás a trabalhar na tarefa #2401 do Desk.
+
+```bash
+/qw
+```
+
+**Processamento automático (se `.desk-project` detectado):**
+1. Lê `.desk-project` → tarefa_id = 2401
+2. Gera resumo com link à tarefa
+3. Memória mem0 inclui ref task_id
+
+**Output:**
+```
+✅ Quick Wrap-up — 2026-07-02 14:30
+
+📝 RESUMO
+• Tarefa #2401 — implementação API endpoint /users
+• Documentação atualizada — docs/api.md com endpoint spec
+• Memória guardada — mem0 com ref task #2401
+
+📦 FICHEIROS
+ + src/api/endpoints/users.js
+ ~ docs/api.md
+
+💾 MEM0 ID: mem0_jkl012... [task_id: 2401]
+
+⏱️ 35s | OK
+```
+
+---
+
+## Exemplo 6: Nenhum Ficheiro Alterado
+
+**Contexto:** Tiveste uma sessão de investigação/leitura apenas (sem edições).
+
+```bash
+/qw
+```
+
+**Processamento:**
+1. Detecta: sem Edit/Write calls
+2. Omite output (nada para registar)
+3. Log silencioso: `[QW] Nada para registar — sessão leitura`
+
+**Output:**
+```
+ℹ️ Quick Wrap-up
+
+Nenhum ficheiro alterado nesta sessão. Omitido.
+```
+
+---
+
+## Checklist Implementação (Para Testar)
+
+- [ ] Criar novo ficheiro, rodar `/qw`, verificar README/CHANGELOG
+- [ ] Editar ficheiro existente, rodar `/qw`, verificar CHANGELOG
+- [ ] Testar `/qw --docs` (só docs)
+- [ ] Testar `/qw --mem` (só memória, com input)
+- [ ] Verificar mem0 entries criadas em gateway.descomplicar.pt
+- [ ] Testar em projecto com `.desk-project` (task link)
+- [ ] Testar sem alterações (nada para registar)
+
+---
+
+**Versão:** 1.0 | 2026-07-02