Struct CacheInstallOutcome 

pub struct CacheInstallOutcome {
    pub mem_name: String,
    pub schema: SchemaRef,
    pub cache_path: PathBuf,
    pub cache_key: String,
    pub copied_to_cache: bool,
    pub schema_files: Vec<(String, Vec<u8>)>,
    pub warnings: Vec<WarningHint>,
}

Install a sealed mem archive into the global cache and register it in a writable mem’s config. Accepts the .mem archive format.

Two independent side effects, both idempotent:

1. If the content-addressed cache file does not exist: run the submitted bytes through validate_and_normalize_archive and write the validator’s canonical_bytes via a .tmp sibling + atomic rename. A mid-write crash leaves the temp file behind, never a partial cache file. Existing cache files are left untouched — overwrite-on-newer-version is an app-level update flow, not a CLI install semantic. Users who want to force-replace can delete the cache file first.
2. If the target mem’s config does not already list this mem under readMems, add an entry with source: { type: "local" }. Existing entries are left untouched so re-running install never clobbers a type: "url" (etc.) source the user configured by hand.

The target parameter selects where the registration lands:

• TargetMem::Disk(mem_dir) writes the updated config back to <mem_dir>/.memstead/config.json (legacy disk shape).
• TargetMem::MemRepo { workspace_root, mem_name } commits the updated configs/<mem_name>.json to mem-repo-git:main (post- cutover shape).

ctx and commit_message are used only by the MemRepo arm — the disk arm rewrites the file via the existing config-update path which has its own (file-mtime-based) provenance trail.

Returns an InstallOutcome describing which effects fired. The authoritative mem name comes from the validator’s approved config, not from the submitted filename or caller argument. Outcome of install_to_cache — the cache-side half of an install, with everything the caller needs to register the archive as a workspace-level read-only mount.

Fields

mem_name: String

Mem name, taken from the validator’s approved config — the archive’s sole identity.

schema: SchemaRef

The archive’s schema pin, from its bundled config.

cache_path: PathBuf

Content-addressed cache file the mount’s Archive storage points at.

cache_key: String

The content digest half of the cache filename.

copied_to_cache: bool

true if canonical bytes were written on this call; false on the idempotent dedup path.

schema_files: Vec<(String, Vec<u8>)>

The archive’s embedded schema package, package-relative (schema.yaml, types/<t>.yaml, schema-format.json) and byte-verbatim. Carried out of the validator because the mount that follows can only be registered once this schema resolves, and for a third party’s vocabulary the archive is the only place it exists. Empty when the archive embeds no schema tree.

warnings: Vec<WarningHint>

Typed non-fatal issues surfaced by the install.

Trait Implementations

impl Clone for CacheInstallOutcome

fn clone(&self) -> CacheInstallOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheInstallOutcome

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

Formats the value using the given formatter.