lib.lssm-os-provider-conformance
Provider-neutral qualification contracts and runner for LSSM OS execution adapters.
@lssm-tech/lib.lssm-os-provider-conformancebun add @lssm-tech/lib.lssm-os-provider-conformanceManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
Provider-neutral V0 contracts and a verifier-controlled offline qualification runner for implementations of ProviderExecutionPort from @lssm-tech/lib.lssm-os-runtime.
The runner owns an observable provider driver, separate mutation and read-only observation counters, credential-use recorder, failure and fencing injection, persistent restart store, and evidence trust verifier. Adapter factories receive only that driver—never a case ID—so a receipt cannot pass by describing an effect that the oracle did not observe.
import {
expectedProviderQualificationTargetV0,
runProviderConformanceV0,
verifyProviderQualificationReceiptV0,
} from "@lssm-tech/lib.lssm-os-provider-conformance";
const target = {
descriptor,
fixture,
identity,
profile,
createAdapter: async (driver) => new MyAdapter(driver),
};
const receipt = await runProviderConformanceV0(target);
const expected = expectedProviderQualificationTargetV0(target);
verifyProviderQualificationReceiptV0(receipt, expected);driver.observe is the reconciliation boundary. It returns an exact, digest-bound present or absent state without changing effects, fences, or evidence. Current qualification requires stale-fence handling and restart replay to use this boundary. Calling driver.apply to rediscover prior state fails qualification even when the provider makes the second mutation idempotent. The method remains optional in the TypeScript interface so existing source continues to compile and receives explicit failed qualification evidence until migrated.
All ten cases are required. Limitations are descriptive and cannot waive scope effect isolation, exact credential-ref use, authoritative plan/effect digests, authorization and receipt attestations, exactly-once effects, exact stale-fence normalization, induced failures, trusted evidence, receipt tamper rejection, verified compensation, or read-only restart replay.
Canonical validation rejects undefined values, cycles, sparse arrays, non-finite numbers, functions, symbols, bigint, Date, Set, custom prototypes, dangerous property names, secret-bearing keys, and secret-shaped values. Qualification receipts bind the expected source revision, environment, profile, capabilities, fixture, driver protocol, case definitions, adapter artifact/package, results, and evidence. The case-registry digest includes the driver-protocol digest, so a legacy apply-only runner cannot restamp itself as current qualification.
This kit makes no live-provider, integration, SDK, or production qualification claim. Its output is evidence about the exact offline target identity supplied to the verifier.
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
2 declarations
@lssm-tech/lib.lssm-os-runtimeworkspace:^
Read the package manual ↗zodcatalog:
Declared capabilities
Provider-neutral qualification contracts and runner for LSSM OS execution adapters.
Scripts
publish:pkgbun publish --tolerate-republish --ignore-scripts --verbosepublish:pkg:canarybun publish:pkg --tag canarybuildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typescleanrimraf dist .turbolintbun run lint:fixlint:fixnode ../../../../scripts/biome.cjs check --write .lint:checknode ../../../../scripts/biome.cjs check .testbun testtypechecktsgo --noEmit