pub fn discover(root: &Path) -> Result<FoundationSnapshot, FoundationError>Expand description
Full filesystem discovery — parses foundation.json, profiles.json,
and packages.lock (when present). Returns a typed snapshot or a
typed error. All reads are best-effort for the lockfile: the
foundation is usable without installed packages.