Update verification status for a hash. # Errors Returns an error if the database operation fails.

Atomically writes the journal file # Errors Returns an error if file write or rename fails

Write `manifest.toml` to a path # Errors Returns an error if serialization or writing fails.

Acquire a download permit # Errors Returns an error if the semaphore is closed or acquisition fails.

Acquire a semaphore permit with proper error handling This helper function provides consistent error handling for semaphore acquisition across all mo

Add a hardcoded path finding

Add a package to the package map # Errors Returns an error if the database operation fails.

Add an argument to the command

Assign a variable

Atomic rename with swap support This function uses macOS `renamex_np` with `RENAME_SWAP` when both paths exist, or regular rename when only source ex

Check arguments for paths and validate them

Check if uv is available

Cleanup old states according to retention policy

Clear all cached entries

Convenience method: Clone a file using APFS clonefile

Recursively copy directory contents

Create package archive and sign it # Errors Returns an error if: - Package creation fails - Package signing fails (when enabled)

Insert a new state row # Errors Returns an error if the database operation fails.

Emit an operation failed event

Ensure store reference exists for a hash # Errors Returns an error if the database operation fails.

Extract compressed tar archive using async-compression

Convenience method: Get binary dependencies

Fetch package file entries for a state + name + version. # Errors Returns an error if the database operation fails.

Get package count for a specific state

Strict retention: keep only N newest states # Errors Returns an error if the database operation fails.

Return summary statistics without performing verification.

Execute a GET request with custom headers and retries # Errors Returns an error if the request fails after all retry attempts, including network tim

Hash a single file and collect metadata # Errors Returns an error if the file cannot be read or metadata cannot be accessed

Check if a file is executable

Check if a path is within the build root

Returns the lifecycle operation enum

Helper to merge compiler flags without duplicating

Get the index metadata file path (for `ETag`, etc.)

Returns the operation name as a string

Get all phases

Process a single file for RPATH and install name fixes

Reads and deserializes the journal file, if it exists # Errors Returns an error if file read or deserialization fails

Remove package files from staging directory This function: - Queries the database for all files belonging to the package - Removes files in safe orde

Execute a request with retries

Save configuration to the default location # Errors Returns an error if the configuration cannot be serialized or if the file cannot be written.

Update the current working directory

Store all files from a directory Returns a list of file hash results # Errors Returns an error if directory traversal or file operations fail

Convert to JSON string # Errors Returns an error if JSON serialization fails.

Try to acquire a semaphore permit without waiting This helper function attempts to acquire a semaphore permit immediately without blocking. Useful fo

Change to a specific phase by name and mark it as done

Verify raw bytes against a minisign signature string using any of the provided trusted keys. # Errors Returns an error if: - The signature string ca

Add another report’s data into `self`.

Add constraint: at most one version of a package can be selected # Panics Panics if variables for package versions are not found. This should not ha

Add package from file with specific name and version # Errors Returns an error if package addition fails

Add a package version to the problem

Add package with venv path (venv ignored in v2 schema) # Errors Returns an error if the database operation fails.

Get all package names

Analyze conflict for external explanation

Apply both archive and file refcount deltas. # Errors Returns an error if either the archive or file refcount operations fail.

Apply default compiler flags for optimization and security This method sets recommended compiler flags for macOS ARM64 builds. It preserves existing

Backtrack to a given level

Build wheel using PEP 517

Bump activity of a single variable

Calculate hash of existing file content for resume

Check if a staging directory can be safely removed A staging directory can only be removed if: 1. No journal file exists, OR 2. The journal file exis

Change to a specific phase