Struct LifecycleWorkspace 

pub struct LifecycleWorkspace<'a> { /* private fields */ }

What: The candidate state as the planner reads it. 'a names how long the borrows of the store, the corrections and the candidate paths last. Why: Both listings are read once, when first needed, and kept as versions of the store’s current generation, whose bytes the store reads.

In TS you’d write (pseudocode):

type LifecycleWorkspace = { store: CandidateStore; corrected: Map<string, InstallChange>; candidates: string[] };

Implementations

impl LifecycleWorkspace<'_>

What: impl LifecycleWorkspace<'_> { ... } attaches the two listings and the lookups. Why: The planner, and a direct fix admitting a file it did not select, read both.

In TS you’d write (pseudocode):

class LifecycleWorkspace { index() {} head() {} indexEntry(path) {} headEntry(path) {} }

pub fn index_entry( &mut self, path: &[u8], ) -> Result<Option<(CandidateMode, ObjectId)>, ContentUnavailable>

What: The mode and object of a path’s private index entry, if it has one. Why: A direct fix compares it with HEAD before changing a file it did not select.

In TS you’d write (pseudocode):

async indexEntry(path): Promise<{ mode; object } | undefined>;

pub fn head_entry( &mut self, path: &[u8], ) -> Result<Option<(CandidateMode, ObjectId)>, ContentUnavailable>

What: The mode and object of a path in HEAD, if HEAD has it. Why: See index_entry.

In TS you’d write (pseudocode):

async headEntry(path): Promise<{ mode; object } | undefined>;

Trait Implementations

impl WorkspaceContent for LifecycleWorkspace<'_>

What: impl WorkspaceContent for LifecycleWorkspace<'_> is the planner’s content seam. Why: The planner stays free of Git; this is the only place it meets the store.

In TS you’d write (pseudocode):

class LifecycleWorkspace implements WorkspaceContent {}

fn tracked_paths(&mut self) -> Result<Vec<TrackedPath>, ContentUnavailable>

What: Every tracked path of the candidate state with its mode, in index order. Why: The planner selects manifests, the configuration and sources itself.

In TS you’d write (pseudocode):

trackedPaths(): Promise<TrackedPath[]>;

fn candidate_bytes( &mut self, path: &[u8], ) -> Result<Vec<u8>, ContentUnavailable>

What: A tracked file’s candidate-state bytes, corrected ones first. Why: A later pass of a direct fix reads what the earlier passes made of the file.

In TS you’d write (pseudocode):

candidateBytes(path): Promise<Uint8Array>;

fn base_bytes( &mut self, path: &[u8], ) -> Result<Option<Vec<u8>>, ContentUnavailable>

What: A file’s bytes in HEAD, or nothing when HEAD lacks it. Why: A manifest’s version is raised when it differs from its HEAD version.

In TS you’d write (pseudocode):

baseBytes(path): Promise<Uint8Array | undefined>;