Skip to content
ContractSpec
Start here

Package manual · platform

·Observability, testing and qualification

lib.observability-spec

Pure signal declarations, cost evidence models and deterministic validation shared by observability and billing.

platformlibraryv0.1.0experimentalserverwebnodebunbrowser
@lssm-tech/lib.observability-spec
bun add @lssm-tech/lib.observability-spec
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

Portable signal declarations and evidence envelopes shared by observability and billing.

Import defineSignal, SignalSpecModel and signal types from @lssm-tech/lib.observability-spec/signal-spec. Import evidence models and validateEvidenceRecord from /evidence-record. The root exports both complete families.

Signal identifiers stay canonical and locale-free. Evidence keeps raw tenant identifiers, numeric quantities and the original cost evidence fields. Validation and rejection messages are unchanged. Existing Observability and ContractSpec compatibility leaves forward to these same objects.

OpenTelemetry instrumentation, database signal defaults and persistence remain in their runtime owners.

Commands: bun run test, bun run typecheck, bun run lint:check, bun run build. This candidate requires task-bound adoption and clean declaration/consumer qualification before integration.

The /analytics/semantic-spec entry owns locale-free metric and dimension identifiers with localized labels and aliases. These are type-only declarations; executable audit and time-window SchemaModel declarations remain in Observability runtime.

Relationships

THIS PACKAGElib.observability-spec4 import paths

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

3 declarations

Declared capabilities

Portable signal declarations and evidence envelopes

Complete existing schema instances, inferred fields and deterministic validation shared by billing and observability.

Scripts

  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • prebuildcontractspec-bun-build prebuild
  • testbun test
  • typechecktsgo --noEmit
  • lint:checknode ../../../../scripts/biome.cjs check .