From 2a029d126b751f88b21b4f9e2e32571cccced695 Mon Sep 17 00:00:00 2001
From: Luiz Silva <luiz@e-licencie.com.br>
Date: Wed, 24 Jun 2026 10:50:32 -0300
Subject: [PATCH] melhorias de ferramentas

---
 global/skills/memoria-persistente/SKILL | 63 +++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/global/skills/memoria-persistente/SKILL b/global/skills/memoria-persistente/SKILL
index 19f4e85..89c635e 100644
--- a/global/skills/memoria-persistente/SKILL
+++ b/global/skills/memoria-persistente/SKILL
@@ -220,6 +220,7 @@ curl -s -X POST "https://memoria-ia.idz.one/api/tags/populares" \
 
 | Rota | Finalidade |
 |------|-----------|
+| `GET /api/status` | Checar healthcheck da API da memória |
 | `POST /api/busca` | Busca full-text em todas as memórias |
 | `POST /api/busca/rapida` | Busca simplificada (títulos e resumos) |
 | `POST /api/memorias/criar` | Criar nova memória |
@@ -227,12 +228,17 @@ curl -s -X POST "https://memoria-ia.idz.one/api/tags/populares" \
 | `POST /api/memorias/buscar` | Buscar por código |
 | `POST /api/memorias/listar` | Listar com filtros e paginação |
 | `POST /api/memorias/excluir` | Exclusão lógica |
+| `POST /api/memorias/mesclar` | Fundir duas memórias e inativar a origem |
+| `POST /api/memorias/sinalizar` | Marcar memória como obsoleta ou que precisa de revisão |
+| `POST /api/memorias/batch` | Operações em lote (criar e editar múltiplos registros) |
+| `POST /api/memorias/historico` | Ver histórico de alterações de uma memória |
 | `POST /api/vinculos/criar` | Criar vínculo entre memórias |
 | `POST /api/vinculos/listar` | Listar vínculos de uma memória |
 | `POST /api/vinculos/excluir` | Excluir vínculo |
 | `POST /api/categorias/listar` | Listar categorias disponíveis |
 | `POST /api/tags/listar` | Listar todas as tags |
 | `POST /api/tags/populares` | Tags mais usadas |
+| `POST /api/contextos/listar` | Listar todos os contextos existentes |
 
 ---
 
@@ -295,6 +301,63 @@ curl -s -X POST "https://memoria-ia.idz.one/api/vinculos/excluir" \
 
 ---
 
+## PASSO 7 — Operações de Manutenção e Qualidade
+
+Para garantir a qualidade da rede de conhecimento a longo prazo:
+
+### Sinalizar como obsoleta ou em revisão
+
+Se uma memória não faz mais sentido ou o código mudou, sinalize-a (não exclua, a menos que seja lixo):
+
+```bash
+curl -s -X POST "https://memoria-ia.idz.one/api/memorias/sinalizar" \
+  -H 'Content-Type: application/json' \
+  -H "CHAVE: banana" \
+  -d '{
+    "codigo": 42,
+    "obsoleto": true,
+    "motivo": "Este padrão foi refatorado e substituído pelo novo helper",
+    "sinalizado_por": "@ag-back"
+  }'
+```
+
+### Mesclar memórias duplicadas
+
+Se houver duas memórias sobre o mesmo assunto:
+
+```bash
+curl -s -X POST "https://memoria-ia.idz.one/api/memorias/mesclar" \
+  -H 'Content-Type: application/json' \
+  -H "CHAVE: banana" \
+  -d '{
+    "codigo_origem": 10,
+    "codigo_destino": 5,
+    "acao_origem": "sinalizar",
+    "realizado_por": "@ag-memoria"
+  }'
+```
+*(As tags e vínculos da origem irão para o destino. A origem será sinalizada ou excluída de acordo com `acao_origem`)*
+
+### Operações em Lote (Batch)
+
+Se precisar importar ou registrar múltiplas memórias rapidamente:
+
+```bash
+curl -s -X POST "https://memoria-ia.idz.one/api/memorias/batch" \
+  -H 'Content-Type: application/json' \
+  -H "CHAVE: banana" \
+  -d '{
+    "criar": [
+      { "titulo": "Regra 1", "conteudo": "...", "resumo": "...", "categoria": "regras-negocio", "criado_por": "@ag-memoria" }
+    ],
+    "editar": [
+      { "codigo": 8, "tags": ["nova-tag"], "atualizado_por": "@ag-memoria" }
+    ]
+  }'
+```
+
+---
+
 ## Boas práticas
 
 1. **Buscar antes de criar** — evitar duplicatas na base