Skip to content
ContractSpec
Start here

lib.lssm-os-provider-conformance

Provider-neutral qualification contracts and runner for LSSM OS execution adapters.

platformlibraryv2.0.4experimentalserverbunnode
@lssm-tech/lib.lssm-os-provider-conformance
bun add @lssm-tech/lib.lssm-os-provider-conformance
Package source ↗Manifest ↗

Manifest 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.

ts
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

THIS PACKAGElib.lssm-os-provider-conformance12 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

2 declarations

Declared capabilities

Lib Lssm Os Provider Conformance

Provider-neutral qualification contracts and runner for LSSM OS execution adapters.

Scripts

  • publish:pkgbun publish --tolerate-republish --ignore-scripts --verbose
  • publish:pkg:canarybun publish:pkg --tag canary
  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • cleanrimraf dist .turbo
  • lintbun run lint:fix
  • lint:fixnode ../../../../scripts/biome.cjs check --write .
  • lint:checknode ../../../../scripts/biome.cjs check .
  • testbun test
  • typechecktsgo --noEmit