@contractspec/lib.observability 3.7.6 → 3.7.10

package/AGENTS.md

@@ -2,33 +2,58 @@
 
 Scope: `packages/libs/observability/*`
 
-OpenTelemetry-based observability primitives. Provides tracing, metrics, logging, and anomaly detection for contract-driven systems.
+OpenTelemetry-based observability primitives.
 
 ## Quick Context
 
-- **Layer**: lib
-- **Consumers**: evolution, progressive-delivery, bundles
-
-## Public Exports
-
-- `.` — main entry
-- `./anomaly/*` — anomaly detection sub-modules
-- `./intent/*` — intent tracking sub-modules
-- `./logging` — structured logging integration
-- `./metrics` — metric collection helpers
-- `./pipeline/*` — telemetry pipeline interfaces
-- `./telemetry/*` — telemetry primitives
-- `./tracing` — distributed tracing helpers
+- Layer: `lib`.
+- Package visibility: published package.
+- Primary consumers are other libs, modules, bundles, and apps in the monorepo.
+- Related packages: `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.lifecycle`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+
+## Architecture
+
+- `src/anomaly` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/intent` is part of the package's public or composition surface.
+- `src/logging` is part of the package's public or composition surface.
+- `src/metrics` is part of the package's public or composition surface.
+- `src/pipeline/` contains pipeline stages and orchestration helpers.
+- `src/telemetry` is part of the package's public or composition surface.
+
+## Public Surface
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./anomaly/alert-manager` resolves through `./src/anomaly/alert-manager.ts`.
+- Export `./anomaly/anomaly-detector` resolves through `./src/anomaly/anomaly-detector.ts`.
+- Export `./anomaly/baseline-calculator` resolves through `./src/anomaly/baseline-calculator.ts`.
+- Export `./anomaly/root-cause-analyzer` resolves through `./src/anomaly/root-cause-analyzer.ts`.
+- Export `./intent/aggregator` resolves through `./src/intent/aggregator.ts`.
+- Export `./intent/detector` resolves through `./src/intent/detector.ts`.
+- Export `./logging` resolves through `./src/logging/index.ts`.
+- Export `./metrics` resolves through `./src/metrics/index.ts`.
+- Export `./pipeline/evolution-pipeline` resolves through `./src/pipeline/evolution-pipeline.ts`.
+- The package publishes 18 total export subpaths; keep docs aligned with `package.json`.
 
 ## Guardrails
 
-- OTel span and metric naming conventions must stay consistent across the platform
-- Pipeline interfaces are adapter boundaries — do not leak vendor-specific details
-- Anomaly detection thresholds affect alerting; changes require validation
+- OTel span and metric naming conventions must stay consistent across the platform.
+- Pipeline interfaces are adapter boundaries — do not leak vendor-specific details.
+- Anomaly detection thresholds affect alerting; changes require validation.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.lifecycle`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
 ## Local Commands
 
-- Build: `bun run build`
-- Test: `bun test`
-- Lint: `bun run lint`
-- Dev: `bun run dev`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @contractspec/lib.observability
 
+## 3.7.10
+
+### Patch Changes
+
+- 1a44cb6: feat: improve examples to increase coverage of Contracts type
+- Updated dependencies [1a44cb6]
+  - @contractspec/lib.contracts-integrations@3.8.2
+  - @contractspec/lib.contracts-spec@4.1.2
+  - @contractspec/lib.lifecycle@3.7.10
+
+## 3.7.9
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/lib.contracts-integrations@3.8.1
+  - @contractspec/lib.contracts-spec@4.1.1
+  - @contractspec/lib.lifecycle@3.7.9
+
 ## 3.7.6
 
 ### Patch Changes
@@ -417,6 +437,7 @@
 - 7f3203a: fix: make workspace test runs resilient when packages have no tests
 
   Updates package test scripts to pass cleanly when no matching test files exist:
+
   - Uses `bun test --pass-with-no-tests` in Bun-based packages that currently ship without test files.
   - Uses `jest --passWithNoTests` for the UI kit web package.
   - Adds `.vscode-test.mjs` for `vscode-contractspec` so VS Code extension test runs have an explicit config and stop failing on missing default configuration.
@@ -722,14 +743,17 @@
   feat: Contract layers support (features, examples, app-configs)
 
   ### New CLI Commands
+
   - `contractspec list layers` - List all contract layers with filtering
 
   ### Enhanced Commands
+
   - `contractspec ci` - New `layers` check category validates features/examples/config
   - `contractspec doctor` - New `layers` health checks
   - `contractspec integrity` - Now shows layer statistics
 
   ### New APIs
+
   - `discoverLayers()` - Scan workspace for all layer files
   - `scanExampleSource()` - Parse ExampleSpec from source code
   - `isExampleFile()` - Check if file is an example spec

package/README.md

@@ -1,85 +1,78 @@
 # @contractspec/lib.observability
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**OpenTelemetry-based observability primitives.**
 
-OpenTelemetry integration for tracing, metrics, and structured logging.
+## What It Provides
 
-## Features
-
-- **Distributed Tracing**: Automatic span creation and propagation
-- **Metrics**: Counters, histograms, and gauges
-- **Structured Logging**: JSON logs with trace correlation
+- **Layer**: lib.
+- **Consumers**: evolution, progressive-delivery, bundles.
+- `src/pipeline/` contains pipeline stages and orchestration helpers.
+- Related ContractSpec packages include `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.lifecycle`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- `src/pipeline/` contains pipeline stages and orchestration helpers.
 
 ## Installation
 
-```bash
-npm install @contractspec/lib.observability @opentelemetry/api
-```
-
-## Quick Start
-
-### Tracing
-
-```typescript
-import { traceAsync } from '@contractspec/lib.observability/tracing';
-
-await traceAsync('process_order', async (span) => {
-  span.setAttribute('order_id', order.id);
-  await db.save(order);
-});
-```
-
-### Metrics
-
-```typescript
-import { createCounter } from '@contractspec/lib.observability/metrics';
-
-const ordersCounter = createCounter('orders_total');
-ordersCounter.add(1, { status: 'success' });
-```
-
-### Middleware
-
-```typescript
-import { createTracingMiddleware } from '@contractspec/lib.observability/tracing/middleware';
-
-app.use(createTracingMiddleware());
-```
-
-## Documentation
-
-Full docs: https://contractspec.io/docs/libraries/observability
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+`npm install @contractspec/lib.observability`
 
+or
 
+`bun add @contractspec/lib.observability`
 
+## Usage
 
+Import the root entrypoint from `@contractspec/lib.observability`, or choose a documented subpath when you only need one part of the package surface.
 
+## Architecture
 
+- `src/anomaly` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/intent` is part of the package's public or composition surface.
+- `src/logging` is part of the package's public or composition surface.
+- `src/metrics` is part of the package's public or composition surface.
+- `src/pipeline/` contains pipeline stages and orchestration helpers.
+- `src/telemetry` is part of the package's public or composition surface.
 
+## Public Entry Points
 
+- Export `.` resolves through `./src/index.ts`.
+- Export `./anomaly/alert-manager` resolves through `./src/anomaly/alert-manager.ts`.
+- Export `./anomaly/anomaly-detector` resolves through `./src/anomaly/anomaly-detector.ts`.
+- Export `./anomaly/baseline-calculator` resolves through `./src/anomaly/baseline-calculator.ts`.
+- Export `./anomaly/root-cause-analyzer` resolves through `./src/anomaly/root-cause-analyzer.ts`.
+- Export `./intent/aggregator` resolves through `./src/intent/aggregator.ts`.
+- Export `./intent/detector` resolves through `./src/intent/detector.ts`.
+- Export `./logging` resolves through `./src/logging/index.ts`.
+- Export `./metrics` resolves through `./src/metrics/index.ts`.
+- Export `./pipeline/evolution-pipeline` resolves through `./src/pipeline/evolution-pipeline.ts`.
+- The package publishes 18 total export subpaths; keep docs aligned with `package.json`.
 
+## Local Commands
 
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
 
+## Recent Updates
 
+- Replace eslint+prettier by biomejs to optimize speed.
+- Circular import issue.
+- Normalize formatting across contracts-integrations, composio, and observability.
+- Add AI provider ranking system with ranking-driven model selection.
 
+## Notes
 
+- OTel span and metric naming conventions must stay consistent across the platform.
+- Pipeline interfaces are adapter boundaries — do not leak vendor-specific details.
+- Anomaly detection thresholds affect alerting; changes require validation.

package/dist/index.d.ts

@@ -1,17 +1,17 @@
-export { getTracer, traceAsync, traceSync } from './tracing';
-export { traceModelSelection, type ModelSelectionSpanInput, type ModelSelectionSpanAttributes, } from './tracing/model-selection.span';
-export { ModelSelectionTelemetry, type ModelSelectionEventProperties, } from './telemetry/model-selection-telemetry';
-export { getMeter, createCounter, createUpDownCounter, createHistogram, standardMetrics, } from './metrics';
-export { Logger, logger } from './logging';
-export { createTracingMiddleware, type TracingMiddlewareOptions, } from './tracing/middleware';
+export { AlertManager } from './anomaly/alert-manager';
+export { AnomalyDetector, type AnomalySignal, type AnomalyThresholds, } from './anomaly/anomaly-detector';
+export { BaselineCalculator } from './anomaly/baseline-calculator';
+export { type RootCauseAnalysis, RootCauseAnalyzer, } from './anomaly/root-cause-analyzer';
 export { IntentAggregator, type IntentAggregatorSnapshot, type TelemetrySample, } from './intent/aggregator';
 export { IntentDetector, type IntentSignal, type IntentSignalType, } from './intent/detector';
+export type { LogEntry, LogLevel } from './logging';
+export { Logger, logger } from './logging';
+export { createCounter, createHistogram, createUpDownCounter, getMeter, standardMetrics, } from './metrics';
 export { EvolutionPipeline, type EvolutionPipelineEvent, type EvolutionPipelineOptions, } from './pipeline/evolution-pipeline';
 export { LifecycleKpiPipeline, type LifecycleKpiPipelineOptions, type LifecyclePipelineEvent, } from './pipeline/lifecycle-pipeline';
-export { PosthogTelemetryProvider, type PosthogTelemetryProviderOptions, } from './telemetry/posthog-telemetry';
+export { type ModelSelectionEventProperties, ModelSelectionTelemetry, } from './telemetry/model-selection-telemetry';
 export { PosthogBaselineReader } from './telemetry/posthog-baseline-reader';
-export type { LogLevel, LogEntry } from './logging';
-export { BaselineCalculator } from './anomaly/baseline-calculator';
-export { AnomalyDetector, type AnomalySignal, type AnomalyThresholds, } from './anomaly/anomaly-detector';
-export { RootCauseAnalyzer, type RootCauseAnalysis, } from './anomaly/root-cause-analyzer';
-export { AlertManager } from './anomaly/alert-manager';
+export { PosthogTelemetryProvider, type PosthogTelemetryProviderOptions, } from './telemetry/posthog-telemetry';
+export { getTracer, traceAsync, traceSync } from './tracing';
+export { createTracingMiddleware, type TracingMiddlewareOptions, } from './tracing/middleware';
+export { type ModelSelectionSpanAttributes, type ModelSelectionSpanInput, traceModelSelection, } from './tracing/model-selection.span';