Skip to main content

Module causal

Module causal 

Source
Expand description

Causal graph DAG with typed/weighted directed edges.

Provides a concurrent, lock-free causal reasoning graph where nodes represent events or observations and edges encode causal relationships with weights and provenance metadata. Built on DashMap for safe concurrent access from multiple agent threads.

Structs§

CausalChain
A traced causal chain from source to target through the graph.
CausalEdge
A weighted, typed directed edge between two causal graph nodes.
CausalGraph
A concurrent directed acyclic graph for causal reasoning.
CausalNode
A node in the causal graph representing an event, observation, or concept.
ChangeEvent
A temporal change event: a set of nodes that changed together.
ChangePrediction
A prediction that a node will change soon.
CouplingPair
Coupling between two nodes based on co-modification frequency.
ShadowingConfig
Configuration for geometric shadowing (memory decay).
SpectralResult
Result of spectral analysis on the causal graph.
VqCodebook
Vector quantization codebook for bootstrapping new entity embeddings.

Enums§

CausalEdgeType
The kind of causal relationship an edge represents.
SpectralMethod
Algorithm used to estimate algebraic connectivity (lambda₂).

Constants§

SPECTRAL_EML_MIN_NODES
Prefer pure EML (O(1)) once the graph has this many nodes.
SPECTRAL_RFF_MIN_NODES
Prefer RFF over Lanczos once the graph has this many nodes.

Functions§

compute_shadows
Compute shadow-adjusted relevance for each node in the graph.
max_volatility_batched
Maximum edge-type volatility across an iterator of edges, using a clawft_treecalc::triage dispatch on the edge-kind stream so a uniform-kind incident set collapses to a single match branch (Sequence form) instead of one per edge.
select_spectral_method
Select the spectral path for a graph of node_count nodes.

Type Aliases§

NodeId
Numeric identifier for causal graph nodes.