Struct ContextDocsManager 

pub struct ContextDocsManager { /* private fields */ }

Manages context-document metadata and dependency edges inside a Lore workspace.

Usage

let manager = ContextDocsManager::new(workspace_path);
manager.register("task-123.md", &[("status", "active")])?;
manager.add_dependency("task-123.md", "characters/hero.yaml")?;
let deps = manager.dependents_of("characters/hero.yaml")?;

Implementations

impl ContextDocsManager

pub fn new(workspace_root: &Path) -> Self

Create a new manager.

The graph is not loaded from Lore until the first operation that requires it (lazy init).

pub fn persist(&self) -> Result<(), NapError>

Write the current in-memory graph back to Lore metadata.

This is a two-step process:

1. Serialise nodes and edges to JSON.
2. Write to .lore/metadata/nap.context_docs and .lore/metadata/nap.context_deps via the VCS.

pub fn register( &self, path: &str, metadata: &[(&str, &str)], ) -> Result<(), NapError>

Register a document with its metadata.

If the document already exists, its metadata is merged with the new entries (new keys overwrite old ones; existing keys not in metadata are preserved).

pub fn unregister(&self, path: &str) -> Result<(), NapError>

Remove a document from the graph.

Also removes all dependency edges where this document is the target or a source.

pub fn all_documents(&self) -> Result<Vec<ContextDocument>, NapError>

Get all documents and their metadata as a list.

pub fn get_document( &self, path: &str, ) -> Result<Option<ContextDocument>, NapError>

Get a specific document by path.

pub fn add_dependency(&self, source: &str, target: &str) -> Result<(), NapError>

Declare that source depends on target.

This adds source to the adjacency list of target. Both paths must be registered; registering is implicit if they are not yet known (the graph auto-vivifies them with empty metadata).

pub fn remove_dependency( &self, source: &str, target: &str, ) -> Result<(), NapError>

Remove a dependency edge.

pub fn dependents_of(&self, target: &str) -> Result<Vec<String>, NapError>

Get the set of documents that directly depend on target.

pub fn dependencies_of(&self, source: &str) -> Result<Vec<String>, NapError>

Get the set of documents that source depends on.

This is a reverse lookup: we scan all edges for where source appears as a dependent.

pub fn graph_as_json(&self) -> Result<String, NapError>

Get the full dependency graph as a JSON string (for debugging or context-graph assembly).