{"id":"@lssm-tech/lib.observability-spec","slug":"lib.observability-spec","name":"@lssm-tech/lib.observability-spec","version":"0.1.0","path":"packages/platform/delivery/observability-spec","manifestPath":"packages/platform/delivery/observability-spec/package.json","manifestBlobSha":"98df3c73c40c76b3fd4de146fb97ac77231d5e71","layer":"platform","physicalArea":"delivery","primaryArea":"observability-and-testing","classification":{"privateDeclared":null,"catalogFamily":"contracts","catalogKind":"library","catalogStatus":"active","adoptionMode":"adoptable","stability":"experimental"},"description":"Pure signal declarations, cost evidence models and deterministic validation shared by observability and billing.","descriptionOrigin":"package.json","catalog":{"family":"contracts","kind":"library","status":"active","adoptionMode":"adoptable","stability":"experimental","platforms":["server","web"],"runtimes":["node","bun","browser"],"entrypoints":[".","./signal-spec","./evidence-record","./analytics/semantic-spec"],"documentation":[{"title":"Observability spec package guide","url":"https://github.com/lssm-tech/contractspec/blob/main/packages/platform/delivery/observability-spec/README.md","kind":"readme"}],"capabilities":[{"id":"observability.spec.signal-evidence","title":"Portable signal declarations and evidence envelopes","description":"Complete existing schema instances, inferred fields and deterministic validation shared by billing and observability.","useCases":["Declare locale-free signals and validate raw-tenant signal evidence without importing observability runtime."],"aliases":["signal spec","evidence record","signal cost evidence"],"canonicalImports":[{"from":"@lssm-tech/lib.observability-spec/signal-spec","symbols":["SignalSpec","SignalSpecModel","defineSignal"]},{"from":"@lssm-tech/lib.observability-spec/evidence-record","symbols":["EvidenceRecord","EvidenceRecordModel","validateEvidenceRecord"]}],"constraints":{"platforms":["server","web"],"runtimes":["node","bun","browser"],"avoidWhen":["Observation, OpenTelemetry instrumentation, database persistence, provider adapters or populated database signal defaults are needed."]}}]},"canonicalImports":[{"capabilityId":"observability.spec.signal-evidence","from":"@lssm-tech/lib.observability-spec/signal-spec","symbols":["SignalSpec","SignalSpecModel","defineSignal"]},{"capabilityId":"observability.spec.signal-evidence","from":"@lssm-tech/lib.observability-spec/evidence-record","symbols":["EvidenceRecord","EvidenceRecordModel","validateEvidenceRecord"]}],"scripts":{"build":"contractspec-bun-build build","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types","prebuild":"contractspec-bun-build prebuild","test":"bun test","typecheck":"tsgo --noEmit","lint:check":"node ../../../../scripts/biome.cjs check ."},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.contracts-spec-core":"workspace:^","@lssm-tech/lib.schema":"workspace:^","zod":"catalog:"},"devDependencies":{"@lssm-tech/tool.bun":"workspace:*","@lssm-tech/tool.typescript":"workspace:*","@types/bun":"catalog:types"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./evidence-record":"./src/evidence-record.ts","./signal-spec":"./src/signal-spec.ts","./analytics/semantic-spec":"./src/analytics/semantic-spec.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","browser":"./dist/browser/index.js","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"},"./evidence-record":{"types":"./dist/evidence-record.d.ts","browser":"./dist/browser/evidence-record.js","bun":"./dist/evidence-record.js","node":"./dist/node/evidence-record.js","default":"./dist/evidence-record.js"},"./signal-spec":{"types":"./dist/signal-spec.d.ts","browser":"./dist/browser/signal-spec.js","bun":"./dist/signal-spec.js","node":"./dist/node/signal-spec.js","default":"./dist/signal-spec.js"},"./analytics/semantic-spec":{"types":"./dist/analytics/semantic-spec.d.ts","bun":"./dist/analytics/semantic-spec.js","node":"./dist/node/analytics/semantic-spec.js","default":"./dist/analytics/semantic-spec.js"}},"types":"./dist/index.d.ts","files":["dist","README.md","LICENSE"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/lib.observability-spec","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/platform/delivery/observability-spec/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability-spec/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./evidence-record","importPath":"@lssm-tech/lib.observability-spec/evidence-record","target":"./src/evidence-record.ts","targets":[{"conditions":[],"target":"./src/evidence-record.ts","sourcePath":"packages/platform/delivery/observability-spec/src/evidence-record.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability-spec/src/evidence-record.ts","sourceStatus":"verified source file"}]},{"subpath":"./signal-spec","importPath":"@lssm-tech/lib.observability-spec/signal-spec","target":"./src/signal-spec.ts","targets":[{"conditions":[],"target":"./src/signal-spec.ts","sourcePath":"packages/platform/delivery/observability-spec/src/signal-spec.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability-spec/src/signal-spec.ts","sourceStatus":"verified source file"}]},{"subpath":"./analytics/semantic-spec","importPath":"@lssm-tech/lib.observability-spec/analytics/semantic-spec","target":"./src/analytics/semantic-spec.ts","targets":[{"conditions":[],"target":"./src/analytics/semantic-spec.ts","sourcePath":"packages/platform/delivery/observability-spec/src/analytics/semantic-spec.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability-spec/src/analytics/semantic-spec.ts","sourceStatus":"verified source file"}]}],"entryCount":4,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Observability spec package guide","url":"https://github.com/lssm-tech/contractspec/blob/main/packages/platform/delivery/observability-spec/README.md","kind":"readme","pinnedUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability-spec/README.md","sourceStatus":"verified pinned repository path"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability-spec","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability-spec/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability-spec/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.observability-spec.txt"},"readme":{"status":"available","body":"# Observability Spec\n\nPortable signal declarations and evidence envelopes shared by observability and billing.\n\nImport `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.\n\nSignal 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.\n\nOpenTelemetry instrumentation, database signal defaults and persistence remain in their runtime owners.\n\nCommands: `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.\n\nThe `/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.\n","sourcePath":"packages/platform/delivery/observability-spec/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/observability-spec/README.md","blobSha":"93c0e283b4a3752039441263289d6e3cabf8db0a","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"observability-and-testing","areaTitle":"Observability, testing and qualification","displayName":"lib.observability-spec","runtimes":["node","bun","browser"],"platforms":["server","web"],"kind":"library","scope":"Package manifest","canonicalRoute":"/docs/packages/lib.observability-spec/","contextUrl":"/docs/packages/lib.observability-spec.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}