eidos_kernel/lib.rs
1//! `eidos-kernel` — the pure-logic brain engine.
2//!
3//! This crate is L1 of the Eidos layer model. It owns the graph schema, the deterministic
4//! retrieval engine (BM25F with calibrated confidence bands), the golden-set eval harness, and the
5//! ranking policy (floor, scope, canonical dominance). It has **no IO** — no `tokio`, no `rmcp`,
6//! no `clap`, no `std::fs`. Every function is a pure transformation over `Graph`, fully unit-
7//! testable with zero files on disk.
8//!
9//! The grounding law lives here: a source *proposes* nodes and edges; the kernel owns and
10//! verifies every receipt — each `file:line` is checked against the real file before a hit is
11//! returned. Sources compute nodes; the kernel never fabricates provenance.
12//!
13//! ## Modules
14//!
15//! | module | owns |
16//! |-------------|-------------------------------------------------------------|
17//! | [`schema`] | `Node`, `Edge`, `Graph`, `Kind`, `Span`, relation vocabulary |
18//! | [`retrieval`] | `ground`, `ground_scoped`, BM25F scoring, confidence bands |
19//! | [`eval`] | the golden-set eval harness (`GoldenSet`, `evaluate`) |
20//! | [`relational`] | callers, impact, kind-intent, rerank-by-kind |
21//! | [`workflow`] | deterministic task brief decomposition and validation |
22
23pub mod calibration;
24pub mod eval;
25pub mod graph_index;
26pub mod relational;
27pub mod retrieval;
28pub mod schema;
29pub mod trigram;
30pub mod workflow;