diff --git a/README.md b/README.md index d249d71..e921dde 100644 --- a/README.md +++ b/README.md @@ -63,6 +63,13 @@ tries a different installation or a package-bundled binary. Missing installation report how to install Atomic or configure `ATOMIC_RUNTIME_DIR`. Errors expose a stable `code` through the exported `AtomicRuntimeError` class. +Use `resolveRuntime()` from `nodeatomic` to check installation discovery before +opening a repository, including in a Git-only workspace. It returns the selected +library path and optional manifest, or throws an `AtomicRuntimeError`. It reads +installation metadata only; it does not load native code, execute the CLI, or +verify binary integrity or the loaded protobuf descriptor. Those checks still +run on the first Atomic operation. Discovery failures are not cached. + ### Validation and compatibility This consumer is generated from the published **Atomic v0.22.0** native runtime diff --git a/ts/index.ts b/ts/index.ts index 532662b..1e2b13c 100644 --- a/ts/index.ts +++ b/ts/index.ts @@ -3,7 +3,7 @@ import type { atomic as Contract } from './generated/proto.cjs'; import { call, proto as atomic } from './native.js'; export { call, proto } from './native.js'; -export { AtomicRuntimeError } from './runtime/loader.mjs'; +export { AtomicRuntimeError, resolveRuntime } from './runtime/loader.mjs'; export { openRepository, AtomicRepository } from './repository.js'; export { KnowledgeClient } from './knowledge.js'; export type {