How dagztagz/vesper-runtime works
Vesper is an offline, local-first command-line runtime for maintaining structured notes and producing verifiable signed snapshots. The main workflow is: initialize a workspace, check or heal its schema, maintain and age memory, create a signed fork, verify the fork or workspace head, and optionally export an audit folder. The CLI dispatches these operations; the schema, memory, fork, cryptography, export, and filesystem-safety modules implement the domain stages. Relationships below are limited to visible CLI dispatches, SOURCE INDEX references, and README-documented behavior; unsampled implementation details are not inferred.
Main entry points: cli.py CLI dispatcher · export.py Audit export · fork.py Signed forks · paths.py Workspace path safety
Components 11
Command interface
- CLI dispatcher
src/vesper/cli.py
Notes and snapshots
- Schema check/heal
src/vesper/schema.py - Memory lifecycle
src/vesper/memory.py - Signed forks
src/vesper/fork.py
Integrity and audit
- Key and signatures
src/vesper/crypto.py - Audit export
src/vesper/export.py
Workspace foundations
- Workspace path safety
src/vesper/paths.py - Runtime errors
src/vesper/errors.py
Other components
- Terminal user
- Local workspace files
- Audit folder
Connections 22
- Terminal user → CLI dispatcher: runs commands
README.md - CLI dispatcher → Schema check/heal: dispatches schema
src/vesper/cli.py - CLI dispatcher → Memory lifecycle: dispatches memory
src/vesper/cli.py - CLI dispatcher → Signed forks: dispatches fork/verify
src/vesper/cli.py - CLI dispatcher → Audit export: dispatches export
src/vesper/cli.py - CLI dispatcher → Workspace path safety: resolves workspace
src/vesper/cli.py - CLI dispatcher → Runtime errors: maps failures
src/vesper/cli.py - Schema check/heal → Runtime errors: raises validation
src/vesper/schema.py - Memory lifecycle → Runtime errors: raises validation
src/vesper/memory.py - Signed forks → Key and signatures: signs and verifies
src/vesper/fork.py - Signed forks → Memory lifecycle: uses memory state
src/vesper/fork.py - Signed forks → Workspace path safety: uses workspace paths
src/vesper/fork.py - Key and signatures → Workspace path safety: uses key paths
src/vesper/crypto.py - Audit export → Signed forks: checks fork head
src/vesper/export.py - Audit export → Key and signatures: checks key security
src/vesper/export.py - Audit export → Memory lifecycle: checks memory decay
src/vesper/export.py - Audit export → Schema check/heal: checks schema
src/vesper/export.py - Audit export → Workspace path safety: checks path safety
src/vesper/export.py - Workspace path safety → Local workspace files: jails file access
src/vesper/paths.py - Signed forks → Local workspace files: reads and writes state
README.md - Key and signatures → Local workspace files: stores key material
README.md - Audit export → Audit folder: writes audit record
README.md