Parse install requests from string specifications

Record (or clear) the state marker for a slot and persist metadata. # Errors Returns an error if writing the marker or persisting metadata fails.

Report progress update

Replace the former `run_quality_checks()` V1 – pre‑validation P – patch tree in‑place V2 – must be clean, else the build fails # Errors Returns an

Utility that runs validators and merges their reports.

Save current tools to persistent cache

Search for packages by name (prefix match)

Set environment variable # Errors Currently infallible, but returns Result for future compatibility.

Persist the association between a slot and a state identifier. # Errors Returns an error if persisting the slot state fails.

Setup state transition and staging directory

Get the size of a file or directory # Errors Returns an error if: - Reading file metadata fails - Reading directory contents fails - Any I/O operati

Read the recorded state for a slot.

Get state manager

Check if state exists # Errors Returns an error if the database query fails.

Store a file by its content hash Returns true if the file was newly stored, false if it already existed # Errors Returns an error if file operations

Store a file and compute its hash # Errors Returns an error if file operations fail

Swap the prepared slot into `/opt/pm/live`, preserving the previous live directory under the previously active slot path. # Errors Returns an error

Synchronize `store_refs` and `file_objects` refcounts to match a specific state exactly This sets refcounts to the exact desired values for the given

Sync staging slot to a specific target state This ensures the staging slot mirrors an arbitrary target state by: - Fast-path: if slot already has the

Sync staging slot with parent state Convenience wrapper around `sync_slot_to_state` for the common case where we want to sync to the transition's par

Uninstall packages # Errors Returns an error if package validation fails or uninstall operation fails.

Perform atomic uninstallation # Errors Returns an error if state transition fails, package removal fails, or filesystem operations fail.

Update packages (delegates to install crate) # Errors Returns an error if: - No packages are installed or specified - Update resolution fails - Inst

Internal implementation for both update and upgrade

Validate index format and version # Errors Returns an error if the index version is unsupported, package names are empty, versions are missing, arch

Validate package format compatibility Checks if a package with the given format version can be processed by the current version of sps2. # Errors R

Validate what rm is trying to delete

Validate a shell command (executed with sh -c)

Validate staging directory exists and contains packageable content

Verify basic isolation requirements

Verify environment variables are properly sanitized

Verify PATH isolation

Run verification over the store and emit guard events describing progress.

Returns the identifier of the currently active slot.

Add constraint: at least one version of a required package must be selected

Add a build dependency

Recursively add directory contents to tar

Recursively add directory contents to tar archive with deterministic ordering This is the enhanced deterministic version with improved file ordering a

Add edge between two packages

Add installed package

Add a Mach-O issue

Record package mapping (now writes to `package_versions`) # Errors Returns an error if the database operation fails.

Helper: add package refs and build map PackageId -> db id, returning increment count

Add available package versions to the SAT problem

Add removed package

Add a new repository to the user's configuration. # Errors Returns an error if: - The configuration file cannot be loaded or created - The repositor

Add a runtime dependency

Add a new sample, calculating speed and managing buffer size

Add updated package

Add or update a package version

Check if all variables are assigned

Apply archive refcount deltas when transitioning from `from_state` -> `to_state`. # Errors Returns an error if the database operations fail.

Apply CLI configuration overrides (highest precedence)

Apply command side effects to context

Apply environment configuration before any build steps

Apply file-object refcount deltas when transitioning from `from_state` -> `to_state`. # Errors Returns an error if the database operations fail.

Apply hermetic isolation to the build environment # Errors Returns an error if isolation setup fails.

Apply isolation level to the environment # Errors Returns an error if: - Failed to apply network isolation settings - Failed to configure hermetic e

Apply network isolation # Errors Currently this function never returns an error, but returns `Result` for future extensibility

Apply network isolation environment variables

Apply a patch file # Errors Returns an error if the patch command fails.

Parse the architecture # Errors Returns an error if the architecture string is not supported (currently only "arm64" is supported).

Archive and compression tools

Convenience method: Atomically rename a file

Configure with autotools # Errors Returns an error if the configure or make commands fail.

Build package from recipe (delegates to builder crate) # Errors Returns an error if: - Recipe file doesn't exist or has invalid extension - Recipe c

Build install context and execute installation for packages needing update

Get build dependencies as `PackageSpec` # Errors Returns an error if any dependency specification string is invalid or cannot be parsed.

Build operations context with all required components