Leliel Knowledge API

Leliel is a domain-agnostic signal intelligence API. It ingests records from any producer, accumulates them in an in-memory quantum factor graph, and re-ranks query results using a gravitational lensing traversal model grounded in quantum walk physics.

---

How it works

# Data flow from any signal source through to the quantum factor graph
Signal producer emits a record (any domain: CI/CD, monitoring, logs, sensor data, etc.)
      ↓
POST /api/v1/records with record_id, source_id, signal_value (and optional extra_data)
      ↓
LelielStore: columnar in-memory store + FactorGraph (co-occurrence edges, mass field)
      ↓
Quantum walk re-ranks query results; high-mass (problematic) records are suppressed

Component	Technology
API service	HTTP.jl (Julia)
In-memory store	LelielStore -- columnar vectors + FactorGraph
Durability	DuckDB (write-through; warm start on restart)
Walk engine	Chebyshev evolution over lensing Hamiltonian H = L + V(mass)

---

Schema-agnostic ingest

Only three fields are required to ingest a record:

Field	Required	Notes
record_id	Yes	Unique identifier for this record
source_id	Yes	Producer identifier; used to scope query results
signal_value	Yes	Normalised quality signal in [0.0, declared_upper_bound]
declared_upper_bound	No	Upper bound for signal_value; defaults to 1.0
timestamp	No	ISO 8601 string; used for recency fallback ordering
extra_data	No	Any JSON object up to 64KB; drives the semantic psi cold-start feature

The extra_data field accepts any JSON object. Field-value pairs are indexed into IDF feature vectors at ingest time and used by the semantic walk to bias cold-start queries toward semantically similar records.

---

Getting started

New here? Start with Quick Deploy.

Need endpoint details? See the API Reference.

Want to understand the mass field and lensing? See Gravity Field.

Want to understand the quantum walk modules? See Quantum Walk.