Skip to main content

Module sync

Module sync 

Source
Expand description

Serverless git-ref sync for storing reasoning history in the user’s own repo. Serverless git-ref sync for Lore.

This module stores AI reasoning history in the user’s own git repository under refs/lore/*, with no hosted service. A lore store ref points at a commit whose tree holds one encrypted blob per session plus a plaintext salt, so the reasoning rides along with the code over plain git.

The module is intentionally split into focused submodules:

  • [encryption] - Argon2id key derivation and AES-256-GCM encryption on raw bytes.
  • [keystore] - passphrase-to-key derivation, salt generation, and persistence of the derived key (file or OS keychain).
  • [store] - the consolidated session-blob pipeline: serialize a full reasoning record, gzip it, encrypt it, and the inverse.
  • [gitref] - git plumbing (shelling out to the user’s git binary) for reading and writing refs/lore/*.

Only the foundational layers are implemented here. The CLI command, the global personal store, and daemon wiring are built in later phases on top of these primitives.

Modules§

encryption
End-to-end encryption for git-ref sync.
gitref
Git plumbing for the lore store refs under refs/lore/*.
keystore
Passphrase-based key management for git-ref sync.
store
Consolidated session-blob pipeline for git-ref sync.

Enums§

SyncError
Errors produced by the git-ref sync subsystem.