Skip to content

Latest commit

 

History

History

README.md

Concepts

This directory contains documentation for XDB's core concepts — the data model (URIs, tuples, records, schemas, namespaces, types) and the infrastructure around it (stores, encoding, config, daemon).

The CLI exposes these concepts as the primitives of a small language: URIs are the noun, records/schemas/namespaces are what the nouns resolve to, and types define the value space filters and payloads operate on.

Data Model

  • Tuples — The fundamental building block of XDB
  • Records — Groups of tuples representing a single entity
  • Schemas — Structure definitions and validation modes
  • Namespaces — Logical grouping of schemas

Addressing

  • URIs — Unique resource identifiers for all XDB resources

Type System

  • Types — Supported value types and typed accessors

Querying

  • Filters — CEL-based record filtering with SQL generation

Storage & Encoding

  • Stores — Storage interfaces and implementations
  • Encoding — JSON encoding and decoding of records

CLI & Daemon

  • Configuration — Config file loading, validation, and defaults
  • Daemon — Background daemon lifecycle management