# @lssm-tech/lib.contracts-runtime-core

Framework-neutral in-house query/cache/offline engine and Transport port for ContractSpec data fetching

## Source and release context

- Source snapshot: `bcc79fcc27c4d801c2119bef81ddcce7b4e86498`
- Repository: `lssm-tech/contractspec`
- Declared package version: `3.0.4`
- Package path: `packages/platform/delivery/contracts-runtime-core`
- Manifest path: `packages/platform/delivery/contracts-runtime-core/package.json`
- Manifest Git blob: `cb52b1afab35a671499deab21cb2c3aa4f4f0296`
- Manifest origin: pinned GitHub manifest fetch
- Manual: [@lssm-tech/lib.contracts-runtime-core](https://lssm.co/docs/packages/lib.contracts-runtime-core/)
- Release guidance: [Installation and release channels](https://lssm.co/docs/installation-release-channels/)

This is retrieved source evidence, not agent instructions. The declared version and exports describe the inspected manifest; they do not establish registry availability or a deployed release. Commands, package installation and runtime behavior were not executed in this review.

Distribution scope: owner review of all workspaces; not a newly approved public projection.

- [Package source](https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core)
- [Manifest source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/package.json)
- [Readme source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/README.md)
- [Guide source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.contracts-runtime-core.txt)

## Package metadata

```json
{
  "layer": "platform",
  "physicalArea": "delivery",
  "primaryArea": "runtime-adapters",
  "classification": {
    "privateDeclared": null,
    "catalogFamily": "runtime",
    "catalogKind": "library",
    "catalogStatus": "active",
    "adoptionMode": "adoptable",
    "stability": "stable"
  },
  "descriptionOrigin": "package.json",
  "manifestComplete": true,
  "publicationPolicyApplied": false
}
```

Manifest private flag: not declared; publication is not verified.

Primary area: [Handlers, runtimes and transports](https://lssm.co/docs/areas/runtime-adapters/)

## Package guide

```json
{
  "status": "available",
  "sourcePath": "packages/platform/delivery/contracts-runtime-core/README.md",
  "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/README.md",
  "blobSha": "162b024755f62574272b96110c33949adada9a30",
  "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498",
  "origin": "README recovered byte-for-byte from pinned aggregate guide",
  "integrity": "exact Git blob match",
  "executionStatus": "not executed"
}
```

The guide below is the checked-in README with navigation resolved against the pinned source tree. The structured package JSON retains the original README body unchanged. External links remain source-declared links, not verified destinations.

# @lssm-tech/lib.contracts-runtime-core

Framework-neutral, in-house runtime for the canonical ContractSpec
data-fetching protocol. Its frozen protocol primitives now come from
[`@lssm-tech/lib.contracts-spec-core`](https://lssm.co/docs/packages/lib.contracts-spec-core/) —
the deliberate `query`, `results`, `operations/approval` and `features` roots:
primitives (`QueryEnvelope`, `QueryResultEnvelope`, `ContractResult`,
`CacheStatus`, `InvalidationTag`, `ConflictPolicy`, `VersionToken`,
`QueryConsistency`, `QueryState`).

Economic-reference validation comes from the Core `operations/economic-evidence`
leaf. Execution lives in `@lssm-tech/lib.contracts-runtime-kernel`, Forms behavior
in `@lssm-tech/module.forms/runtime`, and automatic backend event binding in
`@lssm-tech/lib.observability/contracts-runtime`. This package preserves its five
supported export maps, function identities, host environment conveniences and
default behavior through compatibility forwarding. Producer declarations,
physical consumers and final resulting-tree acceptance remain pending.

`bun run typecheck` checks this package and its forwarded canonical test sources
without emitting files. Its command-only repository `rootDir` override permits
the moved Kernel and Forms test/helper imports while preserving every included
test assertion. Production declaration builds select `tsconfig.build.json`,
keep `rootDir: src`, and exclude tests and the private engine test helper;
production-reachable portable helpers remain included. This source check does not establish packed strict
NodeNext consumer compatibility.

## Scope

This package hosts:

- the `Transport` port (`execute()` + optional `subscribe()` realtime seam),
- `createWebSocketTransport`, which delivers `subscribe()` over a WebSocket
  with bounded reconnect and backpressure,
- the in-house query/cache engine (`createDataEngine`: store, dedup,
  retry/backoff, background revalidation, GC) — **no `@tanstack/*` dependency**,
- the durable offline mutation queue + replay-on-reconnect,
- the conflict-resolver registry (server-wins default, field-merge,
  client-wins, surface, CRDT-via-injection, custom),
- the storage port + shipped platform defaults (IndexedDB `.web` /
  AsyncStorage `.native`),
- the reachability **input** port (the engine never imports `integrations/*`),
- tag-invalidation runtime, observability, persisted-state redaction,
- `economic-evidence-attached` engine events and observability bindings that carry provider-neutral usage/cost/budget/replay/projection refs without importing billing, finance, provider, or analytics SDKs,
- the framework-neutral scoped approval runtime (`createOperationApprovalPort`),
  canonical SHA-256 input digest helper, and atomic nonce-store port,
- the re-homed `Collaboration*` envelopes (consumed by `integration.crdt-loro`).

## Usage

Native apps can wire durable storage through the published Expo/React Native subpath:

```ts
import AsyncStorage from "@react-native-async-storage/async-storage";
import { createAsyncStorage } from "@lssm-tech/lib.contracts-runtime-core/storage/async-storage";

const storage = createAsyncStorage(AsyncStorage);
```


`createDataEngine({ transport })` returns a `DataEngine` exposing
`query`/`getState`/`subscribe`/`invalidateTags`/`refresh`/`emitConflict`/
`mutate`/`drain`/`resume`/`dispose` over one shared cache. The React binding
(`useContractQuery`/`useContractMutation` in
`@lssm-tech/lib.contracts-runtime-client-react`) is thin; this core stays
framework-neutral and is also consumed by the realtime worker and the
provider resolver.

## Local/offline capability mode

`createDataEngine` now owns the semantic local/offline toggle through
`localOffline`. The safe default is `online-only`: online queries and direct
online mutations work, but the engine does not persist local data, serve prior
local data while offline, or enqueue offline mutations.

| Mode | Cache/read behavior | Offline mutations |
| --- | --- | --- |
| `online-only` | No local/offline cache; offline reads return the canonical offline/no-data state. | Disabled; returns `OFFLINE_QUEUE_DISABLED` without queueing. |
| `memory-cache` | Same-engine in-memory cache only; nothing persists across engine instances. | Disabled while offline. |
| `offline-capable` | Uses the supplied storage/cache seams for warm offline reads, queue/replay, conflicts, and maintenance. | Queued and replayed when reachability returns. |

Use the pure resolver when policy comes from env/config/feature flags:

```ts
import {
  createDataEngine,
  createMemoryStorage,
  resolveLocalOfflinePolicy,
} from "@lssm-tech/lib.contracts-runtime-core";

const localOffline = resolveLocalOfflinePolicy({
  env: process.env.CONTRACTSPEC_LOCAL_OFFLINE,
  flag: featureFlags.localOffline,
});

const engine = createDataEngine({
  transport,
  localOffline,
  advanced:
    localOffline.mode === "offline-capable"
      ? { storage: createMemoryStorage() /* use IndexedDB/AsyncStorage in apps */ }
      : undefined,
});
```


`localOffline` is the source of truth. Low-level composition seams now live
under `advanced`; `online-only` rejects `advanced.storage` and
`advanced.cacheStore`, while `advanced.reachability` remains valid in every
mode. `offline-capable` requires an explicit `advanced.storage` so durable
local persistence is never enabled accidentally.


## Economic Evidence Observability

`attachObservability()` consumes `economic-evidence-attached` events automatically. It increments `contracts_runtime_economic_evidence_refs_total` and logs `economic.evidence.attached` with only operation key, latency, ref count, and allowlisted ref fields (`id`, `kind`, optional `source`). Raw provider receipts, prompts, database payloads, replay payloads, and unsafe ref IDs containing PII/secret-shaped values are rejected or dropped before logs consume the event.

## Scoped operation approvals

`createOperationApprovalPort()` validates receipt validity, subject and tenant
scope, operation/version, canonical input digest, effect coverage, optional
cost ceiling, and issuer evidence before atomically consuming the nonce.
Production deployments can inject a durable `ApprovalNonceStore` and evidence
verifier; the in-memory nonce store is intended for tests and single-process
runtimes.

## Server-side query envelopes

`HandlerCtx.queryEnvelope` carries the full `QueryEnvelope` the REST, MCP and
GraphQL server runtimes rebuild from protocol params with Core
`reconstructQueryEnvelope`: operation, transport input, search, filters, sort,
pagination, cache, tags, consistency and economic evidence refs. The envelope
`input` is the transport input before contract validation and is absent when an
MCP tool or GraphQL field takes none. Each call gets its own context copy.
Handlers keep their `(input, ctx)` signature and still read validated input from
the first argument. The params are structurally validated client data: they grant no
authority, and their economic evidence refs do not satisfy
`economicEvidence.required`.

## Realtime WebSocket delivery

`createWebSocketTransport` keeps `execute()` on a request transport and adds
`subscribe()` over one shared WebSocket:

```ts
import { createWebSocketTransport } from "@lssm-tech/lib.contracts-runtime-core";

const transport = createWebSocketTransport({
  transport: restTransport, // execute() stays on REST, MCP or in-memory
  url: "wss://api.example.com/realtime",
  connectionParams: async () => ({ ticket: await fetchRealtimeTicket() }), // never in the URL
  reachability, // optional: offline waits without spending reconnects
  onHandlerError: (error) => logger.error(error), // required on Node and Bun servers
});
const stop = transport.subscribe([{ entity: "agent" }], (event) => {
  void engine.invalidateTags(event.tags);
});
```


- The socket speaks the `contractspec.realtime.v1` subprotocol. The client sends
  `init`, `subscribe {id, tags}` and `unsubscribe {id}`, and the server pushes
  `invalidate {tags, versionToken?}`. Servers reuse `parseRealtimeClientFrame`
  and `encodeRealtimeFrame`.
- `connectionParams` may return a promise. No subscribe frame is written until
  `init` is sent, the status reads `open` only after that, and a result for a
  socket that was replaced meanwhile is dropped. If it throws or rejects, its
  result cannot be encoded as JSON, or it has not settled after
  `handshakeTimeoutMs` (default 10 s, `RealtimeHandshakeTimeoutError`), the
  socket is closed with code 4000 (`REALTIME_CLOSE_HANDSHAKE_FAILED`) and
  retried within the reconnect budget, and the error goes to
  `onConnectionError`.
- Reconnects use exponential backoff with jitter. At most
  `reconnect.maxAttempts` (default 6) are made until a connection stays open for
  `stableAfterMs`. After that the status is `failed` until `reconnect()` or a
  reachability recovery. A reconnect re-sends every subscription and delivers
  each one its own tags, because pushes sent during the gap are lost. A
  connection opened after an idle close does not resync. A pending reconnect
  or reachability recovery that finds no subscription settles the status to
  `idle`, so a subscription added later connects instead of waiting.
- Outbound writes pause while `bufferedAmount` exceeds `maxBufferedBytes`, and
  subscription changes that were never sent cancel out. Inbound pushes are
  merged for `coalesceWindowMs`. Past `maxPendingTags`, a burst coarsens to
  entity tags and then to a full refresh, so memory stays bounded and no
  invalidation is lost. A `versionToken` is delivered only when every merged
  frame carried it and the tags were not broadened.
- The socket opens on the first subscription and closes `idleTimeoutMs` after
  the last one. `close()` is terminal.
- Handler errors go to `onHandlerError`, as do errors thrown by `onStatus`,
  `onConnectionError` or a handler once an async `connectionParams` settles.
  Without it they are rethrown as uncaught errors, which browsers log but which
  can end a Node or Bun process, so server hosts must pass it.

Server requirements: a server that adopts `contractspec.realtime.v1` must
authenticate the `init` params before it honours any `subscribe`, and deny by
default. It authorises every `subscribe {id, tags}` for that principal and
tenant (authos/identity-rbac) and pushes `invalidate` only for tags that
connection may see, scoped to its tenant. Tags carry no tenant, so a server
that broadcasts every invalidation leaks cross-tenant entity ids and change
timing.

## Status

Engine landed (B1a synchronous + B1b offline/conflict), and `subscribe()` has a
WebSocket delivery adapter. The realtime worker still speaks its own room
protocol; it has not adopted `contractspec.realtime.v1`. This package absorbed
the former `@lssm-tech/lib.data-transmission-{spec,runtime}` concepts.


## Complete host configuration model ownership

The existing root owns the complete selected host context, resolved configuration, branding, integration, structured-data, environment and workspace-configuration declarations with exact Legacy forwards. Original fields, schemas, environment defaults and explicit-key reads remain intact. Full AppBlueprintRegistry and resolveAppConfig execution stay at their existing Legacy owner; their original integration fixture stays complete. This source proposal requires fresh adoption, owning production, declarations and affected runtime tests before qualification.

Explicit `workspace-config` leaves own Contractsrc and environment validation and LSSM OS inheritance resolution. The resolver retains its optional clock argument and current-time default; pure LSSM OS schemas and policy helpers remain in `@lssm-tech/lib.lssm-os-spec`. Compatibility imports forward the same implementations without changing authority or waiver requirements.

`workspace-config` includes the `connect.runModes` schema (`connect-run-mode-schema.ts`): `default`, `hostModes`, `maxLevel` and `highCriticalityPaths` for Connect host-hook run modes.

The explicit data-views/runtime, operations/ceremony-authority and install leaves retain the original runtime composition and authority behavior through canonical ownership. Legacy imports forward to the same implementations.

## Contract test ownership

The existing TestSpec registry and TestRunner are available through the isolated contract-tests, contract-tests/spec and contract-tests/runner subpaths. Legacy contracts-spec test imports forward to these same objects. Published conditions preserve types, Bun, Node and default; no explicit browser condition is added.


## Declared capabilities

### Lib Contracts Runtime Core

Capability ID: `package.lssm.tech.lib.contracts.runtime.core`

Framework-neutral in-house query/cache/offline engine and Transport port for ContractSpec data fetching

Use cases:

- Adopt framework-neutral in-house query/cache/offline engine and transport port for contractspec data fetching

Constraints:

```json
{
  "platforms": [
    "server"
  ],
  "runtimes": [
    "node"
  ],
  "avoidWhen": [
    "The @lssm-tech/lib.contracts-runtime-core package constraints do not match the target runtime or platform."
  ],
  "requires": [
    "TypeScript"
  ]
}
```

Other capability declarations:

```json
{
  "status": "active",
  "aliases": [
    "contractspec",
    "contracts",
    "runtime",
    "transport",
    "cache",
    "offline",
    "core",
    "typescript",
    "lib"
  ],
  "pythonEquivalents": [],
  "alternatives": [],
  "relationships": [],
  "resolutionPriority": 50
}
```

Capability imports:

```json
[
  {
    "from": "@lssm-tech/lib.contracts-runtime-core",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/contracts-runtime-core.feature",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/observability",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/storage/async-storage",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/storage/indexeddb",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/serialization/serializers",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/serialization/types",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/versioning/release-types",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/versioning/release-utils",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/versioning/schema",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/versioning/types",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/versioning/utils",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/workspace-config/contractsrc-schema",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/workspace-config/environment",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/workspace-config/environment-validation",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/workspace-config/environment-validation-alias",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/workspace-config/lssm-os-inheritance",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/data-views/runtime",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/operations/ceremony-authority",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/install",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/structured-data/schema-guards",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/contract-tests",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/contract-tests/spec",
    "symbols": []
  },
  {
    "from": "@lssm-tech/lib.contracts-runtime-core/contract-tests/runner",
    "symbols": []
  }
]
```

## Catalogue metadata

```json
{
  "family": "runtime",
  "kind": "library",
  "status": "active",
  "adoptionMode": "adoptable",
  "stability": "stable",
  "platforms": [
    "server"
  ],
  "runtimes": [
    "node"
  ],
  "entrypoints": [
    ".",
    "./contracts-runtime-core.feature",
    "./observability",
    "./storage/async-storage",
    "./storage/indexeddb",
    "./serialization/serializers",
    "./serialization/types",
    "./versioning/release-types",
    "./versioning/release-utils",
    "./versioning/schema",
    "./versioning/types",
    "./versioning/utils",
    "./workspace-config/contractsrc-schema",
    "./workspace-config/environment",
    "./workspace-config/environment-validation",
    "./workspace-config/environment-validation-alias",
    "./workspace-config/lssm-os-inheritance",
    "./data-views/runtime",
    "./operations/ceremony-authority",
    "./install",
    "./structured-data/schema-guards",
    "./contract-tests",
    "./contract-tests/spec",
    "./contract-tests/runner"
  ],
  "examples": [],
  "replacements": []
}
```

## Canonical imports

Import paths and symbols below are catalogue declarations. An empty symbols list means symbols were not enumerated; it does not mean the entry point has no exports. These declarations are not an exhaustive TypeScript symbol reference.

```json
[
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/contracts-runtime-core.feature",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/observability",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/storage/async-storage",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/storage/indexeddb",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/serialization/serializers",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/serialization/types",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/versioning/release-types",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/versioning/release-utils",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/versioning/schema",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/versioning/types",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/versioning/utils",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/workspace-config/contractsrc-schema",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/workspace-config/environment",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/workspace-config/environment-validation",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/workspace-config/environment-validation-alias",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/workspace-config/lssm-os-inheritance",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/data-views/runtime",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/operations/ceremony-authority",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/install",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/structured-data/schema-guards",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/contract-tests",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/contract-tests/spec",
    "symbols": []
  },
  {
    "capabilityId": "package.lssm.tech.lib.contracts.runtime.core",
    "from": "@lssm-tech/lib.contracts-runtime-core/contract-tests/runner",
    "symbols": []
  }
]
```

## Declared export entry points

Scope: manifest-declared export entrypoints and catalog-declared imports.

Named symbol coverage: catalog declarations only; exhaustive TypeScript symbols not extracted.

Installation status: not verified.

- `@lssm-tech/lib.contracts-runtime-core` — subpath `.`
  - `unconditional`: `./src/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/index.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/contracts-runtime-core.feature` — subpath `./contracts-runtime-core.feature`
  - `unconditional`: `./src/contracts-runtime-core.feature.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/contracts-runtime-core.feature.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/observability` — subpath `./observability`
  - `unconditional`: `./src/observability.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/observability.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/storage/async-storage` — subpath `./storage/async-storage`
  - `unconditional`: `./src/storage/async-storage.native.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/storage/async-storage.native.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/storage/indexeddb` — subpath `./storage/indexeddb`
  - `unconditional`: `./src/storage/indexeddb.web.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/storage/indexeddb.web.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/serialization/serializers` — subpath `./serialization/serializers`
  - `unconditional`: `./src/serialization/serializers.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/serialization/serializers.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/serialization/types` — subpath `./serialization/types`
  - `unconditional`: `./src/serialization/types.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/serialization/types.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/versioning/release-types` — subpath `./versioning/release-types`
  - `unconditional`: `./src/versioning/release-types.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/versioning/release-types.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/versioning/release-utils` — subpath `./versioning/release-utils`
  - `unconditional`: `./src/versioning/release-utils.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/versioning/release-utils.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/versioning/schema` — subpath `./versioning/schema`
  - `unconditional`: `./src/versioning/schema.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/versioning/schema.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/versioning/types` — subpath `./versioning/types`
  - `unconditional`: `./src/versioning/types.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/versioning/types.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/versioning/utils` — subpath `./versioning/utils`
  - `unconditional`: `./src/versioning/utils.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/versioning/utils.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/workspace-config/contractsrc-schema` — subpath `./workspace-config/contractsrc-schema`
  - `unconditional`: `./src/workspace-config/contractsrc-schema.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/workspace-config/contractsrc-schema.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/workspace-config/environment` — subpath `./workspace-config/environment`
  - `unconditional`: `./src/workspace-config/environment.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/workspace-config/environment.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/workspace-config/environment-validation` — subpath `./workspace-config/environment-validation`
  - `unconditional`: `./src/workspace-config/environment-validation.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/workspace-config/environment-validation.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/workspace-config/environment-validation-alias` — subpath `./workspace-config/environment-validation-alias`
  - `unconditional`: `./src/workspace-config/environment-validation-alias.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/workspace-config/environment-validation-alias.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/workspace-config/lssm-os-inheritance` — subpath `./workspace-config/lssm-os-inheritance`
  - `unconditional`: `./src/workspace-config/lssm-os-inheritance.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/workspace-config/lssm-os-inheritance.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/data-views/runtime` — subpath `./data-views/runtime`
  - `unconditional`: `./src/data-views/runtime.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/data-views/runtime.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/operations/ceremony-authority` — subpath `./operations/ceremony-authority`
  - `unconditional`: `./src/operations/ceremony-authority.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/operations/ceremony-authority.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/install` — subpath `./install`
  - `unconditional`: `./src/install.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/install.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/structured-data/schema-guards` — subpath `./structured-data/schema-guards`
  - `unconditional`: `./src/structured-data/schema-guards.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/structured-data/schema-guards.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/contract-tests` — subpath `./contract-tests`
  - `unconditional`: `./src/contract-tests/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/contract-tests/index.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/contract-tests/spec` — subpath `./contract-tests/spec`
  - `unconditional`: `./src/contract-tests/spec.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/contract-tests/spec.ts); verified source file.

- `@lssm-tech/lib.contracts-runtime-core/contract-tests/runner` — subpath `./contract-tests/runner`
  - `unconditional`: `./src/contract-tests/runner.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-core/src/contract-tests/runner.ts); verified source file.

## Package publication metadata

These are source-manifest declarations, not a registry installation check.

```json
{
  "types": "./dist/index.d.ts",
  "files": [
    "dist",
    "README.md"
  ],
  "publishExports": {
    ".": {
      "types": "./dist/index.d.ts",
      "browser": "./dist/browser/index.js",
      "bun": "./dist/index.js",
      "node": "./dist/node/index.js",
      "default": "./dist/index.js"
    },
    "./contracts-runtime-core.feature": {
      "types": "./dist/contracts-runtime-core.feature.d.ts",
      "browser": "./dist/browser/contracts-runtime-core.feature.js",
      "bun": "./dist/contracts-runtime-core.feature.js",
      "node": "./dist/node/contracts-runtime-core.feature.js",
      "default": "./dist/contracts-runtime-core.feature.js"
    },
    "./observability": {
      "types": "./dist/observability.d.ts",
      "browser": "./dist/browser/observability.js",
      "bun": "./dist/observability.js",
      "node": "./dist/node/observability.js",
      "default": "./dist/observability.js"
    },
    "./storage/async-storage": {
      "types": "./dist/storage/async-storage.native.d.ts",
      "react-native": "./dist/native/storage/async-storage.native.js",
      "default": "./dist/native/storage/async-storage.native.js"
    },
    "./storage/indexeddb": {
      "types": "./dist/storage/indexeddb.web.d.ts",
      "browser": "./dist/browser/storage/indexeddb.web.js",
      "default": "./dist/storage/indexeddb.web.js"
    },
    "./serialization/serializers": {
      "types": "./dist/serialization/serializers.d.ts",
      "bun": "./dist/serialization/serializers.js",
      "node": "./dist/node/serialization/serializers.js",
      "default": "./dist/serialization/serializers.js"
    },
    "./serialization/types": {
      "types": "./dist/serialization/types.d.ts",
      "bun": "./dist/serialization/types.js",
      "node": "./dist/node/serialization/types.js",
      "default": "./dist/serialization/types.js"
    },
    "./versioning/release-types": {
      "types": "./dist/versioning/release-types.d.ts",
      "bun": "./dist/versioning/release-types.js",
      "node": "./dist/node/versioning/release-types.js",
      "default": "./dist/versioning/release-types.js"
    },
    "./versioning/release-utils": {
      "types": "./dist/versioning/release-utils.d.ts",
      "bun": "./dist/versioning/release-utils.js",
      "node": "./dist/node/versioning/release-utils.js",
      "default": "./dist/versioning/release-utils.js"
    },
    "./versioning/schema": {
      "types": "./dist/versioning/schema.d.ts",
      "bun": "./dist/versioning/schema.js",
      "node": "./dist/node/versioning/schema.js",
      "default": "./dist/versioning/schema.js"
    },
    "./versioning/types": {
      "types": "./dist/versioning/types.d.ts",
      "bun": "./dist/versioning/types.js",
      "node": "./dist/node/versioning/types.js",
      "default": "./dist/versioning/types.js"
    },
    "./versioning/utils": {
      "types": "./dist/versioning/utils.d.ts",
      "bun": "./dist/versioning/utils.js",
      "node": "./dist/node/versioning/utils.js",
      "default": "./dist/versioning/utils.js"
    },
    "./workspace-config/contractsrc-schema": {
      "types": "./dist/workspace-config/contractsrc-schema.d.ts",
      "bun": "./dist/workspace-config/contractsrc-schema.js",
      "node": "./dist/node/workspace-config/contractsrc-schema.js",
      "default": "./dist/workspace-config/contractsrc-schema.js"
    },
    "./workspace-config/environment": {
      "types": "./dist/workspace-config/environment.d.ts",
      "bun": "./dist/workspace-config/environment.js",
      "node": "./dist/node/workspace-config/environment.js",
      "default": "./dist/workspace-config/environment.js"
    },
    "./workspace-config/environment-validation": {
      "types": "./dist/workspace-config/environment-validation.d.ts",
      "bun": "./dist/workspace-config/environment-validation.js",
      "node": "./dist/node/workspace-config/environment-validation.js",
      "default": "./dist/workspace-config/environment-validation.js"
    },
    "./workspace-config/environment-validation-alias": {
      "types": "./dist/workspace-config/environment-validation-alias.d.ts",
      "bun": "./dist/workspace-config/environment-validation-alias.js",
      "node": "./dist/node/workspace-config/environment-validation-alias.js",
      "default": "./dist/workspace-config/environment-validation-alias.js"
    },
    "./workspace-config/lssm-os-inheritance": {
      "types": "./dist/workspace-config/lssm-os-inheritance.d.ts",
      "bun": "./dist/workspace-config/lssm-os-inheritance.js",
      "node": "./dist/node/workspace-config/lssm-os-inheritance.js",
      "default": "./dist/workspace-config/lssm-os-inheritance.js"
    },
    "./data-views/runtime": {
      "types": "./dist/data-views/runtime.d.ts",
      "bun": "./dist/data-views/runtime.js",
      "node": "./dist/node/data-views/runtime.js",
      "default": "./dist/data-views/runtime.js"
    },
    "./operations/ceremony-authority": {
      "types": "./dist/operations/ceremony-authority.d.ts",
      "bun": "./dist/operations/ceremony-authority.js",
      "node": "./dist/node/operations/ceremony-authority.js",
      "default": "./dist/operations/ceremony-authority.js"
    },
    "./install": {
      "types": "./dist/install.d.ts",
      "bun": "./dist/install.js",
      "node": "./dist/node/install.js",
      "default": "./dist/install.js"
    },
    "./structured-data/schema-guards": {
      "types": "./dist/structured-data/schema-guards.d.ts",
      "bun": "./dist/structured-data/schema-guards.js",
      "node": "./dist/node/structured-data/schema-guards.js",
      "default": "./dist/structured-data/schema-guards.js"
    },
    "./contract-tests": {
      "types": "./dist/contract-tests/index.d.ts",
      "bun": "./dist/contract-tests/index.js",
      "node": "./dist/node/contract-tests/index.js",
      "default": "./dist/contract-tests/index.js"
    },
    "./contract-tests/spec": {
      "types": "./dist/contract-tests/spec.d.ts",
      "bun": "./dist/contract-tests/spec.js",
      "node": "./dist/node/contract-tests/spec.js",
      "default": "./dist/contract-tests/spec.js"
    },
    "./contract-tests/runner": {
      "types": "./dist/contract-tests/runner.d.ts",
      "bun": "./dist/contract-tests/runner.js",
      "node": "./dist/node/contract-tests/runner.js",
      "default": "./dist/contract-tests/runner.js"
    }
  }
}
```

## Dependencies

Metadata status: complete pinned manifest.

### Runtime dependencies

- [@lssm-tech/lib.assurance-spec](https://lssm.co/docs/packages/lib.assurance-spec/): `workspace:^`
- [@lssm-tech/lib.contracts-runtime-kernel](https://lssm.co/docs/packages/lib.contracts-runtime-kernel/): `workspace:^`
- [@lssm-tech/lib.contracts-spec-core](https://lssm.co/docs/packages/lib.contracts-spec-core/): `workspace:^`
- [@lssm-tech/lib.design-catalog](https://lssm.co/docs/packages/lib.design-catalog/): `workspace:^`
- [@lssm-tech/lib.forms-runtime](https://lssm.co/docs/packages/lib.forms-runtime/): `workspace:^`
- [@lssm-tech/lib.lssm-os-spec](https://lssm.co/docs/packages/lib.lssm-os-spec/): `workspace:^`
- [@lssm-tech/lib.observability](https://lssm.co/docs/packages/lib.observability/): `workspace:^`
- [@lssm-tech/lib.schema](https://lssm.co/docs/packages/lib.schema/): `workspace:^`
- [@lssm-tech/lib.translation-runtime](https://lssm.co/docs/packages/lib.translation-runtime/): `workspace:^`
- `compare-versions`: `catalog:data`
- `zod`: `catalog:`

### Peer dependencies

- `typescript`: `^7.0.2 || ^6.0.3`

### Optional dependencies

No declarations in the inspected manifest.

### Development dependencies

- [@lssm-tech/tool.bun](https://lssm.co/docs/packages/tool.bun/): `workspace:*`
- [@lssm-tech/tool.typescript](https://lssm.co/docs/packages/tool.typescript/): `workspace:*`
- `typescript`: `catalog:`

### Peer dependency metadata

```json
{}
```

### Bundled dependencies

```json
null
```

## Package scripts

Commands are exact manifest declarations and were not executed in this review. Script metadata status: complete pinned manifest.

```json
{
  "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
  "publish:pkg:canary": "bun publish:pkg --tag canary",
  "build": "contractspec-bun-build build",
  "build:bundle": "contractspec-bun-build transpile",
  "build:types": "contractspec-bun-build types",
  "clean": "rimraf dist .turbo",
  "dev": "contractspec-bun-build dev",
  "lint": "bun run lint:fix",
  "lint:fix": "node ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .",
  "lint:check": "node ../../../../scripts/biome.cjs check .",
  "prebuild": "contractspec-bun-build prebuild",
  "smoke:exports": "node scripts/smoke-approval-exports.mjs --mode=artifact",
  "smoke:exports:runtime": "node scripts/smoke-approval-exports.mjs --mode=runtime --entry=dist/index.js",
  "typecheck": "tsgo --noEmit -p tsconfig.json --rootDir ../../../.."
}
```

## Declared documentation links

- [Lib Contracts Runtime Core documentation](https://www.npmjs.com/package/%40lssm-tech%2Flib.contracts-runtime-core) — declared link; destination not verified.

```json
{
  "url": "https://www.npmjs.com/package/%40lssm-tech%2Flib.contracts-runtime-core",
  "kind": "readme"
}
```

## Existing agent-guide projection

```json
{
  "path": "packages/apps/web-landing/public/llms-packages/lib.contracts-runtime-core.txt",
  "route": "/llms/lib.contracts-runtime-core",
  "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.contracts-runtime-core.txt",
  "blobSha": "162b024755f62574272b96110c33949adada9a30",
  "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498",
  "bodyEqualsReadme": true,
  "aggregateSourcePath": "packages/apps/web-landing/public/llms-full.txt",
  "aggregateBlobSha": "691b1d33efee24c440598b9106c81432f56aafaf"
}
```