Check if the import line has obvious placeholder indicators. Returns True if line contains comments like: - # TODO -

Re-bind numpy's Python layer from the correct bubble after a version switch. When numpy's C extension (.so) is already mapped by the

Monkey-patch Python's resource_tracker to ignore SharedMemory segments. In HFT/Daemon mode, we manage memory lifecycles manually for

Import dispatcher module; skip if not importable.

Import flask_port_finder; skip entire module if unavailable.

Import numpy while temporarily hiding bubble paths from sys.path AND evicting bubble-numpy from sys.modules cache. Python's import machi

Initialize SQLite cache for GitHub metadata

Initialize loader's own cache connection for isolated processes

Tasks performed by the final, detached daemon process before serving.

Initialize paths with strict Python version isolation. Ensures we only work with version-compatible directories.

Copy the freshly compiled binary into target_bin, replacing all omnipkg entry-point names and updating the hash marker. Returns list of name

Install a missing bubble directly. If any ABI package (.so already dlopen'd) is resident in sys.modules, running the install

Install a bubble by shelling out to `8pkg install <spec>` in a fresh interpreter. Used when ABI packages are already mapped in this

Downloads and installs a specific, self-contained version of Python from the python-build-standalone project. Returns the path to the

Install Python warnings filters for common annoyances.

Set TensorFlow environment variables to silence warnings.

FS-based check — no pip subprocess. Scans dist-info for active packages and .omnipkg_versions/ for bubbles. pip freeze is intentionally N

Check if cache entry is still valid

Detect imports that cross the C++/Python boundary.

Additional heuristic: check if filename suggests it's an executable. Used as a final fallback for edge cases.

Check if we're in a partially initialized TensorFlow module.

Check if a path is a reparse point (symlink, junction, etc.) on Windows.

Check if source is the same as target or a child of target.

Check if path is a system-critical directory that shouldn't be copied.

Check if a name looks like a valid Python package. Returns False for malformed cloak filenames.

Check if a name looks like a valid Python package. Returns False for malformed cloak filenames.

Validate that the source looks like a proper Python installation.

Lazily initialize C++ reality anchors only when first needed.

Load existing compatibility test results.

Load the file path registry from JSON.

Load the package index registry from disk or use defaults.

Load metadata for an already-built library.

Checks a Redis flag to see if manifests have already been migrated for the current omnipkg version. If not, triggers migrate_manifest

Drop the in-process _dependency_cache if the sentinel file is newer than when the cache was built. One stat() call per __enter__.

Interactive idle-policy configurator. Shows current policy, lets the user edit counts per-version, and pushes changes to the daemon via

Interactive kill sub-menu (one-time process kill, not config change).

Open a URL in the default browser without letting Chrome/Chromium spew GPU errors and session noise into the terminal. Launches detached

Organize distributions into verification groups with Namespace Clustering. Returns: Dict mapping group_name -> {dists: [

Parses the JSON output from `pip audit` and transforms it into the same format used by the `safety` tool for consistency.

Parse the RECORD file to identify top-level modules.

Append a one-time source block to $VENV/bin/activate so that profile.d/omnipkg_pythons.sh is loaded in every shell that activates the ven

Compute a deterministic SHA for a single Python version's sync state.

Returns True if the stored SHA matches — safe to skip this Python.

Performs concurrent healing only when necessary. This is the slow path - only hit when versions are actually out of sync. CR

FIXED: Passes the specific distribution to the verification function.

Performs a one-time, automatic migration of Redis keys from the old global format to the new environment-and-python-specific format.

Perform the actual copy operation with additional safety measures.

Runs a quick functional test. Importing isn't enough - we need to verify the C++ backend is alive.

Resolve which lock file to use for sync. Priority: 1. Explicit path passed by user/script → use it directly, no discovery. 2. fo

Apply post-import stabilization to C++ modules.

(NEW) Proactively builds the omnipkgLoader dependency cache if it doesn't exist. This ensures the first auto-healing run is as fast a

Print all recognized omnipkg env vars with descriptions and current values.

Print a formatted summary of verification results.

Push the already-compiled binary from native_bin into target_bin without recompiling. Used to heal adopted interpreter bin/ dirs that were a

After adoption, push the native C dispatcher binary into the adopted interpreter's bin/ so 8pkg/omnipkg there are fast from the first

Extract meta fields for the picker without a full parse.

Read an existing lock file and return its content SHA. Returns None if the file doesn't exist or can't be parsed.

Reads the self-heal cache from a JSON file.

Remove workers idle longer than IDLE_TTL.

Cross-process mutex over a sentinel file. Falls through tiers until something works; warns if fully unprotected.

Releases the lock and sets self._context.lock_file_fd to None.

Remove orphaned .dist-info directories that have no corresponding package. Args: pkg_name: Original package name

(AUTHORITATIVE FIX) Fallback for ancient pip. When `pip download` fails, it intelligently parses the error and RAISES NoCompatiblePyt

Restore main-env cloaked modules using the safe lock queue.

Run a conda command with automatic corruption healing. Args: cmd_args: Conda command arguments (e.g., ['install', 'packa

(THE ONE TRUE VERIFIER) Executes an import test for a list of candidate modules in a specific directory using an isolated subprocess.

Top-level daemon management menu shown after the stats block.

Run compatibility test in completely isolated subprocess.

Fixed version that works on Windows (TCP) and Unix (domain socket)

Run a uv install through the DEDICATED UV worker for this Python. Architecture: - self.uv_workers[python_exe] - one p

Resolve a path safely for omnipkg identity and path comparisons. Uses resolve() when possible, falls back to absolute() if resolution fails.

Safely restores environment state using snapshot data instead of trusting pip. Args: package_name: The package that trig

Save compatibility test results.

Save the file path registry to JSON with atomic write.

Score a wheel filename for compatibility with current platform. Higher score = better match. Returns 0 if incompatible.

Select the best file (wheel or sdist) for the current platform. Returns the file dict or None if no compatible file found.

(V25 - FILE-BASED CACHE) Ultra-fast version checking with persistent cache. CRITICAL SAFETY RULES: 1. Only the NATIVE interp

Called by the plan callback after a successful intercept.