Struct ProjectManifest 

pub struct ProjectManifest {
    pub project_uuid: Uuid,
    pub name: String,
    pub version: String,
    pub created_at: String,
    pub ontology: Option<String>,
    pub ontology_mode: Option<OntologyMode>,
    pub ir_version: String,
    pub graphforge_version: String,
    pub capabilities: Option<Capabilities>,
}

Deserialised graphforge.yaml.

Constructed via load (existing project) or create_default (new project).

Fields

project_uuid: Uuid

Stable project identity (UUIDv7, generated at creation).

name: String

Human-readable project name.

version: String

Manifest schema version.

created_at: String

RFC 3339 creation timestamp.

ontology: Option<String>

Relative path to the ontology file, or None if the project has none.

ontology_mode: Option<OntologyMode>

Explicit ontology mode override, or None to apply default-mode logic.

ir_version: String

IR schema version the project was created with.

graphforge_version: String

GraphForge version the project was created with.

capabilities: Option<Capabilities>

Capability flags; absent block defaults to the baseline.

Implementations

impl ProjectManifest

pub fn load(dir: &Path) -> Result<Self, GfError>

Read and parse graphforge.yaml from dir.

Errors

Returns GfError::Storage if the file cannot be read and GfError::Validation if its contents are not valid manifest YAML.

pub fn create_default( dir: &Path, name: &str, created_at: impl Into<String>, ) -> Result<Self, GfError>

Create a new project: generate a UUIDv7 identity and write graphforge.yaml into dir.

created_at is supplied by the caller (RFC 3339) so this stays free of ambient clock access; pass None to omit a timestamp.

Errors

Returns GfError::Storage if the manifest cannot be written, or GfError::Validation if it cannot be serialised.

pub fn effective_ontology_mode(&self, dir: &Path) -> OntologyMode

Determine the effective OntologyMode, applying default-mode logic.

Condition	Mode
ontology_mode set in manifest	that value
unset, configured ontology path exists in dir	Advisory
unset, no configured path, ontology.yaml present in dir	Advisory
unset, no ontology file present	Exploratory

The configured ontology path is tested for existence (resolved relative to dir) rather than merely being present in the manifest — a manifest pointing at a missing file falls back to Exploratory.

pub fn enabled_capabilities(&self) -> Capabilities

Return the project’s capabilities with baseline defaults applied.

topology and properties are always enabled regardless of what the manifest declares.

Trait Implementations

impl Clone for ProjectManifest

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ProjectManifest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProjectManifest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ProjectManifest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.