Module native_tool 

Shared lifecycle for dynamic tools installed by a managed native runtime.

Cargo and Go-module tools both delegate compilation or package resolution to an exact managed runtime. This module owns the common durable boundary: an identity-qualified lock and install root, a sibling staging directory, a receipt binding the provider/runtime/binary bytes, an adjacent metadata seal, and fail-closed reuse, listing, and removal helpers. The seal detects accidental or isolated install-root mutation; it is not a security boundary against a process that can also rewrite the user’s osdk state directory. Backend-specific command planning stays in the individual backend modules.

Structs

NativeToolBinReceipt

NativeToolLifecycle

Lifecycle state derived entirely from inputs known before installation.

NativeToolReceipt

NativeToolStage

A native install staging root that is deleted unless publication succeeds.

Enums

NativeToolFamily

NativeToolPreparation

Result of atomically selecting or preparing one native install identity.

NativeToolProvider

Constants

LOCKED_NATIVE_REPLAY_OPTION

LOCKED_NATIVE_RUNTIME_OPTION

LOCKED_NATIVE_RUNTIME_VERSION_OPTION

NATIVE_TOOL_RECEIPT_FILE

Functions

exact_runtime_dependency

go_runtime_identity

Content identity for an exact managed Go SDK.

list_installed

load_receipt

receipt_path

remove_exact_install

runtime_tree_identity

Stable content identity for a bounded runtime root. Prefer the cached, layout-aware go_runtime_identity and rust_runtime_identity helpers for managed compiler runtimes.

rust_runtime_identity

Content identity for the build-critical portion of an exact managed Rust toolchain. The compiler payload comes from rustup’s manifest-rustc-*, and every regular file below the selected target’s lib directory is included. Symlinks and non-regular payloads fail closed.

validate_install_candidate

Validate a native candidate without executing its provider or consulting the network. This is the single reuse/activation/shim/lock inspection boundary.