From ec31722a1237f42147f4eba3b172e4455b19271f Mon Sep 17 00:00:00 2001 From: Bradley Hilton Date: Mon, 16 Nov 2026 16:54:22 -0800 Subject: [PATCH] feat: expose read-only runtime discovery for consumers --- README.md | 7 +++++++ ts/index.ts | 2 +- 2 files changed, 8 insertions(+), 1 deletion(-) 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 {