Module oracle 

Oracle Mode - Intelligent query interface for the Sovereign AI Stack

Provides:

• Knowledge graph of stack components
• Natural language query interface
• Component recommendations
• Integration pattern discovery
• RAG-based documentation retrieval (APR-Powered)
• Cookbook with practical recipes
• Local workspace discovery and multi-project intelligence
• Popperian falsification test generation

Re-exports

pub use rag::RagOracle;

pub use rag::RagOracleConfig;

pub use local_workspace::DependencyInfo;

pub use local_workspace::DevState;

pub use local_workspace::DriftType;

pub use local_workspace::GitStatus;

pub use local_workspace::LocalProject;

pub use local_workspace::LocalWorkspaceOracle;

pub use local_workspace::PublishOrder;

pub use local_workspace::PublishStep;

pub use local_workspace::VersionDrift;

pub use local_workspace::WorkspaceSummary;

Modules

arxiv

arXiv Paper Enrichment for Oracle Mode

cookbook

Cookbook - Practical recipes for common Sovereign AI Stack patterns

coursera

Coursera Reading Asset Generation

falsify

Popperian Falsification QA Generator

local_workspace

Local Workspace Oracle - Multi-project development intelligence

rag

RAG Oracle - Intelligent retrieval-augmented generation for Sovereign AI Stack

svg

SVG Generation Module

Structs

Capability

A capability provided by a component

Citation

Academic citation/reference

ComponentRecommendation

Component recommendation with confidence

ComputeRecommendation

Compute recommendation

DistributionRecommendation

Distribution recommendation

HardwareSpec

Hardware specification for queries

IntegrationPattern

Integration pattern between components

KnowledgeGraph

Knowledge graph containing all stack components and their relationships

OracleQuery

Oracle query structure

OracleResponse

Complete Oracle response

QueryConstraints

Query constraints

QueryEngine

Query engine that processes queries and generates responses

QueryPreferences

Query preferences

Recommender

Oracle recommendation engine

StackComponent

A component in the Sovereign AI Stack

Enums

Backend

Compute backend selection

CapabilityCategory

Category of capability

DataSize

Data size specification

OpComplexity

Operation complexity classification

OptimizationTarget

Optimization target for queries

ProblemDomain

Problem domain for classification

StackLayer

Layer in the Sovereign AI Stack hierarchy

Functions

select_backend

Select optimal backend based on workload characteristics Based on PCIe transfer overhead analysis (Gregg & Hazelwood, 2011)

should_distribute

Determine if distributed execution is beneficial Based on Amdahl’s Law and communication overhead