Documentation for the @zabaca/lattice CLI tool used in this research project.

Documents

DocumentDescription
Entity Schema ReferenceValid entity types and database schema
Embedded DuckDB AlternativeAnalysis of replacing FalkorDB with DuckDB (now implemented)
Graph-Only ArchitectureIMPLEMENTED: No frontmatter, database is source of truth

Quick Reference

Installation

Terminal window
bun add -g @zabaca/lattice
lattice init  # Setup ~/.lattice/ and install slash commands

Storage

All data centralized in ~/.lattice/:

~/.lattice/
├── docs/                  # Markdown documentation
├── lattice.duckdb         # Embedded graph database
└── .env                   # API keys (VOYAGE_API_KEY)

Commands

CommandDescription
lattice initSetup directory structure and slash commands
lattice statusShow documents needing sync
lattice syncSync documents to DuckDB
lattice search "<query>"Semantic search across all entities
lattice sql "<query>"Execute raw SQL against DuckDB
lattice rels <name>Show relationships for an entity
lattice ontologyDerive ontology from documents

Architecture

  • Backend: Embedded DuckDB (zero Docker, zero external deps)
  • Embeddings: Voyage AI (voyage-3-lite, 512 dimensions)
  • Vector Search: DuckDB VSS extension with HNSW index
  • No frontmatter: Entities extracted directly to database