Create standardized download progress tracker

Default value functions for serde

Delete archive CAS rows for given hashes # Errors Returns an error if the database operation fails.

Detect package format version from .sp file This method first attempts fast header detection, then falls back to manifest parsing if needed. # Error

Determine output path for package

Download a file with progress reporting # Errors Returns an error if the URL is invalid, the download fails, or there are I/O errors while writing t

Core download function requires all parameters for operation

Helper to ensure a `file_verification` row exists.

Ensure the given slot directory exists and return its path. # Errors Returns an error if creating the directory fails.

Set multiple environment variables for the command

Convenience method: Execute a command and get output

Execute a command in the build environment using the environment stored on the struct. # Errors Returns an error if the command fails to spawn or ex

Execute a post-processing step with security context # Errors Returns an error if: - Security validation fails for command execution - Command is di

Execute a source step

Execute two-phase commit flow for a transition

Extract entries from a tar archive with security checks

Extract a .sp package file to a directory # Errors Returns an error if: - Tar extraction fails - The extracted package is missing manifest.toml - I/

Extract tar.bz2 archive # Errors Returns an error if extraction fails.

Extract tar.gz archive # Errors Returns an error if extraction fails.

Extract zip archive # Errors Returns an error if extraction fails.

Find wheel file in directory

Fix permissions on a file if needed

Garbage collect unreferenced packages # Errors Currently returns success, but may return errors in future implementations when state manager integra

Get the path to the GC timestamp file

Fetch all file objects. # Errors Returns an error if the database operation fails.

List all states with metadata # Errors Returns an error if the database operation fails.

Get the arguments

Get the current directory

Fetch a file object. # Errors Returns an error if the database operation fails.

Get changes for initial state (all packages are installs)

Get the install name of a Mach-O file using platform abstraction

Get package dependents # Errors Returns an error if the database query fails.

Fetch package file paths for a given version # Errors Returns an error if the database operation fails.

Get parent state ID # Errors Returns an error if database operations fail.

Get styled prefix for event severity

Get rollback state information with pre-calculated changes

Get packages in a state # Errors Returns an error if the database query fails.

Get the store hash associated with a package archive hash # Errors Returns an error if the database query fails.

Get tool version if possible

Get recent trend direction (acceleration/deceleration)

Alias for `get_unreferenced_items` (kept for callers) # Errors Returns an error if the database operation fails.

Check if a package exists in the store

Execute a HEAD request with retries # Errors Returns an error if the request fails after all retry attempts, including network timeouts, connection

Import a new key into the trusted set # Errors Returns an error if: - The trusted keys cannot be saved to disk

Initialize the key manager with a bootstrap key # Errors Returns an error if: - The keys directory cannot be created - The bootstrap key string cann

Insert GC run entry # Errors Returns an error if the database operation fails.

Complex orchestration function coordinating multiple subsystems

Install packages # Errors Returns an error if package resolution fails, download fails, or installation fails.

Returns true if this is upgrade mode

Link a stored file to a destination # Errors Returns an error if the file doesn't exist or linking fails

Link files from hash results to a destination directory # Errors Returns an error if linking operations fail

Link package from store to staging directory This is a wrapper around the `fs::link_package_to_staging` function that maintains backward compatibilit

Link package contents to a destination # Errors Returns an error if file linking operations fail or the package lacks file-level hashes (legacy pack

List available states for rollback # Errors Returns an error if querying the state database fails.

Heuristic to detect if an argument looks like a path

Run make step only # Errors Returns an error if the make command fails.

Sign raw bytes with a Minisign secret key file and return the signature string. The secret key file is expected to be in Minisign "secret key box" fo

Check if an install name needs fixing based on the style

Normalize file permissions for deterministic output Ensures consistent permissions across different filesystems and umask settings

Internal implementation for recipe-based packaging