Struct ContextRetriever 

pub struct ContextRetriever { /* private fields */ }

Context retriever for gathering relevant code context

Implementations

impl ContextRetriever

pub fn new(working_dir: PathBuf) -> Self

Create a new context retriever

pub fn with_max_file_bytes(self, bytes: usize) -> Self

Set max bytes per file

pub fn with_max_context_bytes(self, bytes: usize) -> Self

Set max total context bytes

pub fn search(&self, pattern: &str, max_results: usize) -> Vec<SearchHit>

Search for a pattern in the workspace using ripgrep Respects .gitignore and common ignore patterns

pub fn read_file_truncated(&self, path: &Path) -> Result<String>

Read a file with truncation if it exceeds max bytes

pub fn get_task_context( &self, context_files: &[PathBuf], output_files: &[PathBuf], ) -> String

Get context for a task based on its context_files and output_files Returns a formatted string suitable for LLM prompts

pub fn search_for_context(&self, query: &str, max_results: usize) -> String

Search for relevant code based on a query (e.g., function name, class name) Returns formatted context for LLM

pub fn build_restriction_map( &self, node: &SRBNNode, manifest: &OwnershipManifest, ) -> RestrictionMap

PSP-5 Phase 3: Build a restriction map for a node

The restriction map defines the context boundary: what files, digests, and summaries a node is allowed to see. Built from the ownership manifest, task graph, and parent scope.

pub fn assemble_context_package( &self, node: &SRBNNode, restriction_map: &RestrictionMap, ) -> ContextPackage

PSP-5 Phase 3: Assemble a reproducible context package for a node

Builds a complete, bounded context package from the restriction map. Prioritizes: owned files (full content) > sealed interfaces (digest or content) > summaries.

pub fn compute_structural_digest( &self, path: &str, artifact_kind: ArtifactKind, source_node_id: &str, ) -> Result<StructuralDigest>

PSP-5 Phase 3: Compute a structural digest for a file

pub fn format_context_package(&self, package: &ContextPackage) -> String

PSP-5 Phase 3: Format a context package as text for LLM prompts

pub fn validate_provenance_record( &self, record: &ContextProvenanceRecord, ) -> Vec<String>

PSP-5 Phase 3: Validate a persisted provenance record against the current workspace.

Parses structural digest references from the provenance record and checks whether the referenced source files still exist on disk. Returns a list of missing file paths — empty means no drift detected.

pub fn get_project_summary(&self) -> String

Gather a structured project summary for injection into sheafification prompts.

Returns a formatted string describing: detected language plugins, dependency manifests, entry points, test locations, and build system. Uses the plugin registry and file-system inspection; zero LLM calls.