ai-provenance-chain
Cadeia de procedencia em quatro elos para rastrear como um resultado foi produzido.
Como usar
Registrar um elo
node cli.mjs link --file chain.jsonl --type documento --summary "Artigo base" --id doc1
node cli.mjs link --file chain.jsonl --type contexto --summary "Contexto da busca" --id ctx1 --parent doc1
node cli.mjs link --file chain.jsonl --type decisao --summary "Decidiu usar abordagem X" --id dec1 --parent ctx1
node cli.mjs link --file chain.jsonl --type ferramenta --summary "Busca web" --id fer1 --parent dec1
node cli.mjs link --file chain.jsonl --type resultado --summary "Resposta final" --id res1 --parent fer1
Importar recibos agent-receipt
node cli.mjs link --file chain.jsonl --from-receipt recibos.jsonl --summary "Importacao de recibos"
Ver a cadeia de um resultado
node cli.mjs chain --file chain.jsonl --id res1
Listar resultados sem procedencia
node cli.mjs orphans --file chain.jsonl
Estatisticas
node cli.mjs stats --file chain.jsonl
Tipos de elo
- documento: fonte original (artigo, PDF, webpage)
- contexto: informacao extraida ou resumo do documento
- decisao: escolha tomada com base no contexto
- ferramenta: ferramenta chamada para produzir o resultado
- resultado: saida final entregue ao usuario
Protecoes
- Deteccao de ciclos: se um elo aponta para si mesmo ou forma ciclo,
chaindetecta e reporta - JSONL append-only: nada e sobrescrito, tudo e auditavel
- Zero dependencias externas
- IDs normalizados como string: ids numericos de recibos sao convertidos para texto
- Prefixo de origem: ao importar, cada id recebe
nome-do-arquivo:idpara evitar colisao entre arquivos