🧠 Memória Azteca

Sistema de memória centralizada para agentes e humanos.

Autenticação

Enviar header: CHAVE: $CHAVE

Criar memória

Campos

Campo	Tipo	Obrigatório	Descrição
titulo	string	sim (min 3)	Título da memória
conteudo	string	sim (min 10)	Conteúdo em Markdown
resumo	string	sim (min 10, max 500)	Resumo curto
categoria	enum	sim	Ver categorias abaixo
criado_por	string	sim	Autor (ex: @ag-back)
tipo	enum	não (default: nota)	nota, adr, solucao-problemas, referencia, procedimento
contexto	string	não	Contexto da memória (ex: Módulo Licenças, Projeto Edital Resíduos, Cliente XPTO, Corporativo, etc.)
tags	string[]	não	Tags livres

curl -s -X POST "https://memoria-ia.idz.one/api/memorias/criar" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: $CHAVE" \
  -d '{
    "titulo": "Padrão de resposta API",
    "conteudo": "A API retorna sempre um objeto com sucesso e dados...",
    "resumo": "Padrão de retorno da API com campos sucesso e dados",
    "categoria": "modulos",
    "tipo": "referencia",
    "contexto": "Módulo Licenças",
    "tags": ["api", "resposta"],
    "criado_por": "@ag-back"
  }'

Buscar memórias (full-text)

curl -s -X POST "https://memoria-ia.idz.one/api/busca" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: $CHAVE" \
  -d '{"termo": "validação zod"}'

Listar com filtros

curl -s -X POST "https://memoria-ia.idz.one/api/memorias/listar" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: $CHAVE" \
  -d '{"categoria": "solucao-problemas", "contexto": "Módulo Licenças", "limite": 10}'

Listar por tags

curl -s -X POST "https://memoria-ia.idz.one/api/memorias/listar" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: $CHAVE" \
  -d '{"tags": ["api", "resposta"], "limite": 10}'

Categorias (enum fixo)

modulos | tecnologias | regras-negocio | infraestrutura
decisoes | clientes | solucao-problemas | corporativo

Vínculos entre memórias

Relacione memórias usando {mem:ID} no campo relacao.

Campos

Campo	Tipo	Obrigatório	Descrição
codigo_memoria_a	int	sim	Código da primeira memória
codigo_memoria_b	int	sim	Código da segunda memória
relacao	string	sim (min 3)	Deve conter {mem:A} e {mem:B}
criado_por	string	sim	Autor

Validações

A e B não podem ser iguais
A relação deve conter {mem:codigo_memoria_a} e {mem:codigo_memoria_b}

Exemplos de relação

{mem:1} é sócio de {mem:5}
{mem:3} e {mem:7} são concorrentes
{mem:2} depende de {mem:4}

Criar vínculo

curl -s -X POST "https://memoria-ia.idz.one/api/vinculos/criar" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: $CHAVE" \
  -d '{
    "codigo_memoria_a": 1,
    "codigo_memoria_b": 5,
    "relacao": "{mem:1} é sócio de {mem:5}",
    "criado_por": "@ag-arquiteto"
  }'

Listar vínculos de uma memória

curl -s -X POST "https://memoria-ia.idz.one/api/vinculos/listar" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: $CHAVE" \
  -d '{"codigo_memoria": 1}'

Excluir vínculo

curl -s -X POST "https://memoria-ia.idz.one/api/vinculos/excluir"   -H 'Content-Type: application/json'   -H "CHAVE: $CHAVE"   -d '{"codigo": 42}'

Operações em Lote e Rastreabilidade

Checar Status da API

curl -s -X GET "https://memoria-ia.idz.one/api/status"

Listar Contextos

curl -s -X POST "https://memoria-ia.idz.one/api/contextos/listar"   -H 'Content-Type: application/json'   -H "CHAVE: $CHAVE"   -d '{}'

Mesclar Memórias

curl -s -X POST "https://memoria-ia.idz.one/api/memorias/mesclar"   -H 'Content-Type: application/json'   -H "CHAVE: $CHAVE"   -d '{
    "codigo_origem": 12,
    "codigo_destino": 15,
    "acao_origem": "sinalizar",
    "realizado_por": "@ag-memoria"
  }'

Sinalizar Memória (Obsoleta/Revisão)

curl -s -X POST "https://memoria-ia.idz.one/api/memorias/sinalizar"   -H 'Content-Type: application/json'   -H "CHAVE: $CHAVE"   -d '{
    "codigo": 42,
    "obsoleto": true,
    "motivo": "Esta funcionalidade foi refatorada",
    "sinalizado_por": "@ag-back"
  }'

Operações em Lote (Batch)

curl -s -X POST "https://memoria-ia.idz.one/api/memorias/batch"   -H 'Content-Type: application/json'   -H "CHAVE: $CHAVE"   -d '{
    "criar": [{ "titulo": "Nova", "conteudo": "...", "resumo": "...", "categoria": "modulos", "criado_por": "@ag-back" }],
    "editar": [{ "codigo": 123, "tags": ["nova-tag"], "atualizado_por": "@ag-back" }]
  }'

Consultar Histórico

curl -s -X POST "https://memoria-ia.idz.one/api/memorias/historico"   -H 'Content-Type: application/json'   -H "CHAVE: $CHAVE"   -d '{"codigo": 42}'

Rotas disponíveis

GET  /api/status               — healthcheck da API
POST /api/busca              — busca full-text
POST /api/busca/rapida       — busca simplificada (títulos e resumos)
POST /api/memorias/criar     — criar memória
POST /api/memorias/editar    — editar memória
POST /api/memorias/buscar    — buscar por código
POST /api/memorias/listar    — listar com filtros
POST /api/memorias/excluir   — exclusão lógica
POST /api/memorias/mesclar   — mesclar duas memórias
POST /api/memorias/sinalizar — sinalizar como obsoleta/revisão
POST /api/memorias/batch     — operações em lote
POST /api/memorias/historico — ver histórico de edições
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 (enum fixo)
POST /api/tags/listar        — listar tags
POST /api/tags/populares     — tags mais usadas
POST /api/contextos/listar   — listar todos os contextos