Struct FileCache 

pub struct FileCache {
    pub chunks: Vec<CodeChunk>,
    pub embeddings: Vec<f32>,
    pub hidden_dim: usize,
}

Cached chunks and embeddings for a single source file.

Stored as an rkyv archive in the object store, keyed by the blake3 hash of the source file content.

Fields

chunks: Vec<CodeChunk>

The semantic chunks extracted from this file.

embeddings: Vec<f32>

Flat embedding data: [n_chunks × hidden_dim] contiguous f32 values.

hidden_dim: usize

The embedding dimension (e.g., 384 for BGE-small, 768 for ModernBERT).

Implementations

impl FileCache

pub fn to_bytes(&self) -> Vec<u8>

Serialize to zstd-compressed rkyv bytes.

Embedding vectors compress ~8:1 with zstd because most values cluster near zero. Level 1 matches level 3 ratio on this data with faster compression.

Panics

Panics if serialization fails (should not happen for valid data).

pub fn from_bytes(bytes: &[u8]) -> Result<Self>

Deserialize from (optionally zstd-compressed) rkyv bytes.

Transparently handles both compressed and legacy uncompressed objects by checking for the zstd magic number.

Errors

Returns an error if the bytes are not a valid archive.

pub fn to_portable_bytes(&self) -> Vec<u8>

Serialize to portable zstd-compressed bitcode bytes.

Unlike to_bytes (rkyv, architecture-dependent), this format is safe to share across different CPU architectures (e.g., x86_64 CI → aarch64 Mac).

Panics

Panics if zstd compression fails (should not happen for valid data).

pub fn from_portable_bytes(bytes: &[u8]) -> Result<Self>

Deserialize from portable zstd-compressed bitcode bytes.

Expects the BITCODE_MAGIC prefix. Returns an error if the bytes are not a valid portable archive.

Errors

Returns an error if the magic prefix is missing, decompression fails, or bitcode deserialization fails.

Trait Implementations

impl Archive for FileCache

where Vec<CodeChunk>: Archive, Vec<f32>: Archive, usize: Archive,

const COPY_OPTIMIZATION: CopyOptimization<Self>

An optimization flag that allows the bytes of this type to be copied directly to a writer instead of calling serialize.

type Archived = ArchivedFileCache

The archived representation of this type.

type Resolver = FileCacheResolver

The resolver for this type. It must contain all the additional information from serializing needed to make the archived type from the normal type.

fn resolve(&self, resolver: Self::Resolver, out: Place<Self::Archived>)

Creates the archived version of this value at the given position and writes it to the given output.

impl Debug for FileCache

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

Formats the value using the given formatter.

impl<__D: Fallible + ?Sized> Deserialize<FileCache, __D> for Archived<FileCache>

where Vec<CodeChunk>: Archive, <Vec<CodeChunk> as Archive>::Archived: Deserialize<Vec<CodeChunk>, __D>, Vec<f32>: Archive, <Vec<f32> as Archive>::Archived: Deserialize<Vec<f32>, __D>, usize: Archive, <usize as Archive>::Archived: Deserialize<usize, __D>,

fn deserialize( &self, deserializer: &mut __D, ) -> Result<FileCache, <__D as Fallible>::Error>

Deserializes using the given deserializer

impl<__S: Fallible + ?Sized> Serialize<__S> for FileCache

where Vec<CodeChunk>: Serialize<__S>, Vec<f32>: Serialize<__S>, usize: Serialize<__S>,

fn serialize( &self, serializer: &mut __S, ) -> Result<<Self as Archive>::Resolver, <__S as Fallible>::Error>

Writes the dependencies for the object and returns a resolver that can create the archived type.

impl<'__de> Decode<'__de> for FileCache

where '__de:,

impl Encode for FileCache