RAG Expiration Engine

rag-expiration-engine

Validade temporal por documento em bases RAG. Fatos e instrucoes envelhecem — esta skill permite marcar quando cada documento vence e filtrar automaticamente os invalidos antes de injetar no contexto do agente.

Comandos

stamp — adicionar validade a um documento

node cli.mjs stamp <arquivo> <ttl> [--type <tipo>]

• <arquivo>: caminho do documento
• <ttl>: 30d, 6m, 1y, 2026-12-31, ou never
• --type: opcional, aplica politica padrao de TTL

Grava metadado em .rag-expiration-index.json ao lado do documento. Nunca altera o arquivo original.

check — listar status de todos os documentos

node cli.mjs check --directory <dir>

Mostra: expirados, vencendo em <=30 dias, validos, sem validade definida.

filter — retornar apenas documentos validos

node cli.mjs filter <arquivo1> [arquivo2...] --date <data> --directory <dir>

Devolve so os documentos validos na data de referencia. O agente injeta apenas esses no contexto.

Tipos de conteudo e politica padrao

Uso pelo agente

1. Antes de injetar contexto RAG, rode node cli.mjs filter com a data atual
2. Use apenas os arquivos validos no prompt
3. Periodicamente rode check para auditar a base