Skip to main content

Module graph_id

Module graph_id 

Source
Expand description

GraphId — registry-level identity for a graph in multi-graph mode (MR-668).

Validation lives in GraphId::try_from(String); nothing else can construct a GraphId. The newtype prevents graph_id strings from escaping the storage root via path traversal or colliding with engine-reserved filenames.

Regex: ^[a-zA-Z0-9-]{1,64}$

The engine reserves every filename starting with _ at the graph root (_schema.pg, _schema.ir.json, __schema_state.json, __manifest/, __recovery/, etc.). Disallowing leading underscores at the regex level means a graph_id can never collide with engine-managed files. Path traversal (.., /) is unrepresentable.

policies is additionally reserved as a future-proofing measure for a potential /graphs/policies/... cluster route.

Structs§

GraphId
Validated registry-level identity for a graph.

Constants§

GRAPH_ID_MAX_LEN
Maximum length of a GraphId value.