lance-graph/crates/lance-graph-contract/src/lib.rs at 4faa7e471d3a60b62ef3a8d1de669447d03ececc · AdaWorldAPI/lance-graph · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
//! # lance-graph-contract — The Single Source of Truth
//!
//! Zero-dependency trait crate that defines the contract between:
//! - **lance-graph-planner** (implements these traits)
//! - **ladybug-rs** (calls Planner + CamPq + OrchestrationBridge)
//! - **crewai-rust** (calls ThinkingStyleContract + MulContract)
//! - **n8n-rs** (calls JitContract + OrchestrationBridge)
//!
//! # Why This Exists
//!
//! Before this crate, each consumer duplicated thinking style enums,
//! field modulation structs, and query plan types. Now:
//!
//! ```text
//! crewai-rust ──┐
//!               │
//! n8n-rs ───────┤── depend on ──► lance-graph-contract (traits only)
//!               │
//! ladybug-rs ───┘
//!
//! lance-graph-planner ──► implements lance-graph-contract traits
//! ```
//!
//! # Module Layout
//!
//! - [`thinking`] — 36 thinking styles, 6 clusters, τ addresses, 23D vectors
//! - [`mul`] — MUL assessment (Dunning-Kruger, trust, flow, compass)
//! - [`plan`] — Query planning traits (PlanStrategy, PlanResult)
//! - [`cam`] — CAM-PQ distance contract (6-byte fingerprint ops)
//! - [`jit`] — JIT compilation contract (jitson template → kernel)
//! - [`orchestration`] — Bridge trait for single-binary routing
//! - [`nars`] — NARS inference types shared across all consumers
//! - [`collapse_gate`] — Per-row write airgap (`GateDecision`, `MergeMode`)
//! - [`cycle_accumulator`] — Per-cadence flush gate; absorbs the L1↔L3
//!   speed ratio. Distinct from `collapse_gate` per topology I-4.

pub mod cognition;
pub mod transaction;

pub mod a2a_blackboard;
pub mod atoms;
pub mod auth;
pub mod callcenter;
pub mod cam;
pub mod class_view;
pub mod codegen_spine;
pub mod cognitive_shader;
pub mod collapse_gate;
pub mod container;
pub mod counterfactual;
pub mod crystal;
pub mod cycle_accumulator;
pub mod distance;
pub mod episodic_edges;
pub mod escalation;
pub mod exploration;
pub mod external_membrane;
pub mod faculty;
pub mod grammar;
pub mod graph_render;
pub mod head2head;
pub mod hash;
pub mod hhtl;
pub mod high_heel;
pub mod jit;
pub mod kanban;
pub mod literal_graph;
pub mod mail;
pub mod manifest;
pub mod mul;
pub mod nars;
pub mod ocr;
pub mod ontology;
pub mod orchestration;
pub mod orchestration_mode;
pub mod pearl_junction;
pub mod persona;
pub mod plan;
pub mod property;
pub mod proprioception;
pub mod qualia;
pub use qualia::{
    axis_index, axis_label, qualia_to_state, QualiaI4_16D, QualiaVector, AXIS_LABELS, MIDPOINT,
    QUALIA_DIMS, QUALIA_I4_DIMS, QUALIA_I4_LABELS, ZERO,
};
pub mod reasoning;
pub mod recipe_kernels;
pub mod recipes;
pub mod repository;
pub mod savants;
pub mod scenario;
pub mod scheduler;
pub mod sensorium;
pub mod sigma_propagation;
pub mod sla;
pub mod soa_view;
pub mod splat;
pub mod tax;
pub mod thinking;
pub mod view_angle;
pub mod vsa;
pub mod witness_table;
pub mod world_map;
pub mod world_model;

// Re-exports for the most commonly used collapse_gate types.
pub use class_view::{ClassId, ClassProjection, ClassView, FieldMask, RenderRow};
pub use collapse_gate::{CollapseGateEmission, GateDecision, MailboxId, MergeMode};
pub use episodic_edges::{EdgeRef, EpisodicEdges64};
pub use head2head::{CompetitionOutcome, Head2Head, WinnerCriterion};
pub use kanban::{ExecTarget, KanbanColumn, KanbanMove, RubiconTransitionError};
pub use scheduler::{DatasetVersion, NextPhaseScheduler, VersionScheduler};
pub use soa_view::{MailboxSoaOwner, MailboxSoaView};
pub use view_angle::ViewAngle;