cvx_graph/lib.rs
1//! # `cvx-graph` — Knowledge Graph for ChronosVector
2//!
3//! Provides a typed property graph for compositional reasoning over
4//! entities and their relationships. Designed for:
5//!
6//! - Task structure: "heat_then_place requires steps: find→take→heat→take→put"
7//! - Shared sub-plans: "clean and heat share find→take prefix"
8//! - Constraint validation: "after take, valid next actions are go/use/put"
9//! - Cross-entity transfer: "entity A is-similar-to entity B"
10//!
11//! ## Graph Model
12//!
13//! - **Nodes**: typed entities (task, action, object, location, step)
14//! - **Edges**: typed relations (requires, precedes, located_at, similar_to)
15//! - **Properties**: key-value attributes on nodes and edges
16//!
17//! ## References
18//!
19//! - Hogan et al. (2021). *Knowledge Graphs*. ACM Computing Surveys.
20//! - Ji et al. (2022). *A Survey on Knowledge Graphs*. Expert Systems.
21
22#![deny(unsafe_code)]
23#![warn(missing_docs)]
24
25pub mod entity;
26pub mod graph;
27pub mod relation;
28
29pub use entity::{Entity, EntityId, EntityType};
30pub use graph::KnowledgeGraph;
31pub use relation::{Relation, RelationType};