Struct BuildArtifact 

pub(crate) struct BuildArtifact {
    path: PathBuf,
    conn: Connection,
}

Fields

path: PathBuf

conn: Connection

Implementations

impl BuildArtifact

pub(crate) fn open( root: &Path, profile: &str, profile_suffix: Option<&str>, variables: &BTreeMap<String, String>, ) -> Result<Self, CacheError>

Open (or create) the SQLite build artifact database for a profile namespace.

The namespace directory is derived from the active profile name, optional suffix, and compile-time variable bindings, so different profiles use isolated caches. On schema version mismatch the database is dropped and recreated — safe because all cached state is advisory.

fn initialize(&self) -> Result<(), CacheError>

fn create_schema(&self) -> Result<(), CacheError>

pub(crate) fn load_file_hashes( &mut self, fs: &FileSystem, paths: &BTreeSet<PathBuf>, ) -> Result<BTreeMap<PathBuf, String>, CacheError>

Load content hashes for the requested source paths. Stale or missing cache entries are transparently refreshed from disk.

pub(crate) fn load_file_contents( &mut self, fs: &FileSystem, paths: &BTreeSet<PathBuf>, ) -> Result<BTreeMap<PathBuf, String>, CacheError>

Load file contents for the requested source paths. Stale, missing, or contents-NULL cache entries are transparently refreshed from disk.

pub(crate) fn load_object_fingerprints( &self, ) -> Result<BTreeMap<String, String>, CacheError>

Load just the (object_key, fingerprint) pairs from object_state.

Used during the planning phase to detect cache hits without paying the cost of materializing each object’s SQL fragments.

pub(crate) fn load_object_artifacts( &self, keys: &BTreeSet<String>, ) -> Result<BTreeMap<String, CompiledObjectArtifact>, CacheError>

Load full compile artifacts for the requested object keys. Only keys present in object_state produce an entry.

fn prepare_fragment_select( &self, table: &str, ) -> Result<Statement<'_>, CacheError>

pub(crate) fn upsert_object_rows( &mut self, rows: &[ObjectStateRow], ) -> Result<(), CacheError>

Replace each object’s fragment rows so row-count changes (e.g., a removed index) are reflected exactly.

pub(crate) fn prune_object_rows( &mut self, keep: &BTreeSet<String>, ) -> Result<(), CacheError>

Remove object_state rows for objects no longer in the current project.

pub(crate) fn upsert_typecheck_results( &mut self, rows: &[(String, String, BTreeMap<String, ColumnType>)], ) -> Result<(), CacheError>

Persist or update typecheck artifacts for a batch of objects.

Column records for an object are fully replaced (no partial updates).

pub(crate) fn prune_typecheck_results( &mut self, keep: &BTreeSet<String>, ) -> Result<(), CacheError>

Remove stale typecheck artifacts for objects no longer in the current project.

pub(crate) fn load_typecheck_columns( &self, ) -> Result<BTreeMap<String, BTreeMap<String, ColumnType>>, CacheError>

Load every cached typecheck column row, grouped by object key.

Single round-trip so the parallel typecheck DAG can run without holding a live SQLite connection.

pub(crate) fn load_external_type_digests( &self, ) -> Result<BTreeMap<String, String>, CacheError>

Load the digest map for external types (object_key -> digest).

pub(crate) fn replace_external_type_digests( &mut self, digests: &BTreeMap<String, String>, ) -> Result<(), CacheError>

Replace the cached external-type digest set with the provided rows and drop any rows for keys not present.

pub(crate) fn write_project( &mut self, project: &Project, changed_keys: &BTreeSet<String>, deleted_keys: &BTreeSet<String>, root: &Path, ) -> Result<(), CacheError>

Rewrites per-object rows for changed_keys ∪ deleted_keys; small project-wide tables are rewritten in full.

fn load_row_keys(&self, table: &str) -> Result<BTreeSet<String>, CacheError>

fn prune_rows( &mut self, table: &str, keep: &BTreeSet<String>, ) -> Result<(), CacheError>