Struct FileRecord 

pub struct FileRecord {

    pub path: String,
    pub purpose: String,
    pub entry_points: Vec<String>,
    pub imports: Vec<String>,
    pub gotcha_keys: Vec<String>,
    pub decision_keys: Vec<String>,
    pub todos: Vec<TodoComment>,
    pub unsafe_count: u32,
    pub unwrap_count: u32,
    pub change_frequency: u32,
    pub last_author: Option<String>,
    pub is_hotspot: bool,
    pub token_cost_estimate: u32,
    pub last_modified_session: u64,
    pub content_hash: Option<String>,
    pub line_count: u32,
    pub blast_radius: Option<BlastRadius>,
    pub propagated_staleness: Option<PropagatedStaleness>,
}

Per-file knowledge — stored under file:<path>, linked to gotcha:* and decision:* via graph edges.

Does not derive PartialEq — contains token_cost_estimate which may be computed and is not meaningful to compare directly.

Fields

path: String

purpose: String

One-sentence purpose extracted by Layer 1 enrichment. Empty at Layer 0.

entry_points: Vec<String>

Public functions / types / entry points visible from other modules.

imports: Vec<String>

Import / use paths found by tree-sitter.

gotcha_keys: Vec<String>

Keys of associated gotcha:* records.

decision_keys: Vec<String>

Keys of associated decision:* records.

todos: Vec<TodoComment>

unsafe_count: u32

unwrap_count: u32

change_frequency: u32

Commit count touching this file (from git2, capped at 5 000 most recent non-merge commits).

last_author: Option<String>

is_hotspot: bool

True when change_frequency puts this file in the top 10% of the repo.

token_cost_estimate: u32

Rough token count estimate for mem_bootstrap budget enforcement.

last_modified_session: u64

Session timestamp of the last time this record was updated.

content_hash: Option<String>

SHA-256 hex digest of file content at the time of last Layer 0 scan. None for non-parseable files or the first scan (no stored baseline).

line_count: u32

Newline count at last scan (≈ line count). 0 for non-parseable files.

blast_radius: Option<BlastRadius>

Blast radius — how many files depend on this one (direct + transitive). Computed during mati init Phase 10a from Imports edges in the graph. None for stores created before blast radius was introduced.

propagated_staleness: Option<PropagatedStaleness>

Staleness inherited from upstream stale sources via Imports edges. None for stores created before staleness propagation was introduced.

Implementations

impl FileRecord

pub fn layer0_stub( path: impl Into<String>, entry_points: Vec<String>, imports: Vec<String>, todos: Vec<TodoComment>, unsafe_count: u32, unwrap_count: u32, change_frequency: u32, last_author: Option<String>, is_hotspot: bool, token_cost_estimate: u32, last_modified_session: u64, ) -> Self

Construct a layer-0 file stub from static-analysis signals.

purpose, gotcha_keys, and decision_keys intentionally start empty. The Layer 0 pipeline only records structural facts; enrichment fills in the human-readable purpose later.

Trait Implementations

impl Clone for FileRecord

fn clone(&self) -> FileRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FileRecord

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

where __S: Serializer,

Serialize this value into the given Serde serializer.