memora: Memória Versionada e Tipada para Agentes de IA – Git para Crenças de IA

memora é uma ferramenta CLI que versiona a memória de agentes de IA — tipada, com rastreamento de proveniência, ramificável e mesclável. Pense em git para o que a IA acredita sobre seu código, não para alterações de arquivos. O projeto todo tem ~5k linhas de Rust distribuídas em duas crates, produzindo um único binário estático com zero dependências externas (SQLite empacotado via rusqlite). Roda nos três principais sistemas operacionais com CI.

Estrutura das Crates

• memora-core – biblioteca sem dependências de CLI. Tipos, armazenamento SQLite, mecanismo de snapshot, merge 3-way, gravação de sessão, adaptadores de exportação.
• memora-cli – camada CLI fina baseada em clap.

Destaques Técnicos

• Trait Clock para testes determinísticos – sem timestamps inconsistentes.
• IDs baseados em conteúdo via SHA-256 de strings em forma canônica.
• Merge 3-way com detecção de base de merge BFS no DAG completo de pais.
• Tabela node_versions que captura o estado completo do nó por commit – permitindo diff, rollback e GC reversível.

Decisões de Design e Perguntas em Aberto

O autor busca feedback em várias áreas:

• Fórmula de pontuação de importância para GC e ranking de exportação.
• Se o enum MemorySource deve ser aberto (atualmente possui uma variante Unknown(String)).
• Modelo de sincronização remota – atualmente apenas sistema de arquivos; o limite copy_commits_between é onde o transporte de rede seria conectado.

Repositório: github.com/harshtripathi272/memora – licenciado sob MIT.