Struct Cache 

pub struct Cache {

    pub schema: String,
    pub version: String,
    pub generated_at: DateTime<Utc>,
    pub git_commit: Option<String>,
    pub project: ProjectInfo,
    pub stats: Stats,
    pub source_files: HashMap<String, DateTime<Utc>>,
    pub files: HashMap<String, FileEntry>,
    pub symbols: HashMap<String, SymbolEntry>,
    pub graph: Option<CallGraph>,
    pub domains: HashMap<String, DomainEntry>,
    pub constraints: Option<ConstraintIndex>,
    pub provenance: ProvenanceStats,
    pub bridge: BridgeStats,
    pub conventions: Conventions,
}

@acp:summary “Complete ACP cache file structure (schema-compliant)” @acp:lock normal

Fields

schema: String

JSON Schema URL for validation

version: String

Schema version (required)

generated_at: DateTime<Utc>

Generation timestamp (required)

git_commit: Option<String>

Git commit SHA (optional)

project: ProjectInfo

Project metadata (required)

stats: Stats

Aggregate statistics (required)

source_files: HashMap<String, DateTime<Utc>>

Map of file paths to modification times for staleness detection (required)

files: HashMap<String, FileEntry>

Files indexed by path (required)

symbols: HashMap<String, SymbolEntry>

Symbols indexed by name (required)

graph: Option<CallGraph>

Call graph relationships (optional)

domains: HashMap<String, DomainEntry>

Domain groupings (optional)

constraints: Option<ConstraintIndex>

AI behavioral constraints (optional)

provenance: ProvenanceStats

RFC-0003: Annotation provenance statistics (optional)

bridge: BridgeStats

RFC-0006: Bridge statistics (optional)

conventions: Conventions

RFC-0015: Auto-detected naming and import conventions (optional)

Implementations

impl Cache

pub fn new(project_name: &str, root: &str) -> Self

@acp:summary “Create a new empty cache”

pub fn from_json<P: AsRef<Path>>(path: P) -> Result<Self>

@acp:summary “Load cache from JSON file”

pub fn write_json<P: AsRef<Path>>(&self, path: P) -> Result<()>

@acp:summary “Write cache to JSON file”

pub fn get_symbol(&self, name: &str) -> Option<&SymbolEntry>

@acp:summary “Get a symbol by name - O(1) lookup”

pub fn get_file(&self, path: &str) -> Option<&FileEntry>

@acp:summary “Get a file by path - O(1) lookup with cross-platform path normalization”

Handles various path formats:

• With or without ./ prefix: src/file.ts and ./src/file.ts
• Windows backslashes: src\file.ts
• Redundant separators: src//file.ts
• Relative components: src/../src/file.ts

pub fn get_callers(&self, symbol: &str) -> Option<&Vec<String>>

@acp:summary “Get callers of a symbol from reverse call graph”

pub fn get_callees(&self, symbol: &str) -> Option<&Vec<String>>

@acp:summary “Get callees of a symbol from forward call graph”

pub fn get_domain_files(&self, domain: &str) -> Option<&Vec<String>>

@acp:summary “Get all files in a domain”

pub fn update_stats(&mut self)

@acp:summary “Recalculate statistics after indexing”

Trait Implementations

impl Clone for Cache

fn clone(&self) -> Cache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Cache

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Cache

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Cache

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

where __S: Serializer,

Serialize this value into the given Serde serializer.