O que dossier faz?
Cada agente deixa um rastro de papel. Registros de auditoria JSONL à prova de adulteração para fluxos de trabalho agentivos.
Visão Geral
dossier permite que agentes de IA gerem logs de auditoria imutáveis e encadeados criptograficamente. Cada ação do agente é registrada como uma linha JSON em um arquivo .jsonl, com um hash que vincula cada entrada à anterior, formando uma cadeia à prova de adulteração.
Funcionalidades
- Imutabilidade: Cada entrada de log inclui o hash da entrada anterior, criando uma cadeia verificável.
- Formato JSONL: Leve, legível por máquina e fácil de processar com ferramentas padrão.
- Fácil Integração: Funciona com Claude Code, Cursor, Codex e outros agentes.
- Verificação: Ferramenta CLI para verificar a integridade de todo o arquivo de log.
Como Usar
Instalação
Adicione a dependência ao seu projeto:
npm install @stefanhoth/dossier
Uso Básico
import { logAction } from '@stefanhoth/dossier';
await logAction({
action: 'search_database',
params: { query: 'users' },
result: { count: 42 }
});
Verificação de Logs
npx dossier-verify ./logs/dossier.jsonl
Exemplo de Log
{
"hash": "a1b2c3d4e5...",
"previousHash": "f6g7h8i9j0...",
"timestamp": "2024-01-15T10:30:00Z",
"action": "file_write",
"params": { "path": "/tmp/data.txt" },
"result": { "success": true },
"agent": "claude-code-v1"
}
Configuração
Defina a variável de ambiente DOSSIER_LOG_PATH para o diretório de logs desejado:
export DOSSIER_LOG_PATH=./logs
Compatibilidade
- Claude Code
- Cursor
- Codex (OpenAI)
- Qualquer agente com suporte a Node.js
Licença
MIT