@contractspec/lib.observability 3.7.5 → 3.7.7

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,15 @@
 # @contractspec/lib.observability
 
+## 3.7.6
+
+### Patch Changes
+
+- fix: release manifest
+- Updated dependencies
+  - @contractspec/lib.contracts-integrations@3.7.6
+  - @contractspec/lib.contracts-spec@3.7.6
+  - @contractspec/lib.lifecycle@3.7.6
+
 ## 3.7.5
 
 ### Patch Changes

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';