@plumbus/core 0.1.0

package/dist/index.js

@@ -0,0 +1,79 @@
+// ════════════════════════════════════════════════════════════════════════════
+// Plumbus Core — Public API
+//
+// This barrel is organized into two tiers:
+//
+//   TIER 1 — SDK Surface (for building applications)
+//     Types, define*() functions, field constructors, execution engine,
+//     data layer, auth, events, flows, AI runtime, config, observability.
+//
+//   TIER 2 — Tooling & CLI Internals (for framework tooling)
+//     CLI commands, scaffolding templates, doctor checks, governance rules,
+//     policy certification, agent briefs, code generators.
+//
+// When adding new exports, place them in the correct tier.
+// ════════════════════════════════════════════════════════════════════════════
+// ── AI Runtime ──
+export { PromptRegistry, UsageAPIError, checkPromptSecurity, chunkDocument, createAIService, createAnthropicAdapter, createCostTracker, createExplainabilityTracker, createInMemoryVectorStore, createOpenAIAdapter, createProviderAdapter, createRAGPipeline, createUsageAPIClient, documentChunksTable, documentsTable, generateWithValidation, singleProviderConfig, } from './ai/index.js';
+// ── API (HTTP route generation) ──
+export { registerAllRoutes, registerCapabilityRoute } from './api/index.js';
+// ── Audit ──
+export { auditRecords, createAuditService } from './audit/index.js';
+// ── Auth ──
+export { createJwtAdapter, createOidcAdapter, createSamlAdapter, createScimService, hashPassword, signJwt, verifyPassword, } from './auth/index.js';
+// ── Config Loader ──
+export { loadConfig, validateConfig } from './config/index.js';
+// ── Data Layer ──
+export { EntityRegistry, applyMigrations, collectSchemas, createRepository, generateDrizzleSchema, generateSchemas, rollbackLastMigration, } from './data/index.js';
+// ── Define Functions ──
+export { defineCapability } from './define/defineCapability.js';
+export { defineEntity } from './define/defineEntity.js';
+export { defineEvent } from './define/defineEvent.js';
+export { defineFlow } from './define/defineFlow.js';
+export { definePrompt } from './define/definePrompt.js';
+// ── Error Utilities ──
+export { errorToHttpResponse, errorToHttpStatus } from './errors/http.js';
+export { createErrorService, isPlumbusError } from './errors/index.js';
+// ── Events ──
+export { ConsumerRegistry, EventRegistry, createEventEmitter, createEventWorker, createIdempotencyService, createInMemoryQueue, createOutboxDispatcher, createRedisQueue, deadLetterTable, idempotencyTable, outboxTable, } from './events/index.js';
+// ── Execution Engine ──
+export { CapabilityRegistry, createExecutionContext, evaluateAccess, executeCapability, } from './execution/index.js';
+// ── Explanation ──
+export { createExplanationTracker } from './explanation/index.js';
+// ── Field Constructors ──
+export { field } from './fields/index.js';
+// ── Flows ──
+export { FlowRegistry, FlowStatus, StepStatus, assertTransition, buildHistoryEntry, computeNextRun, computeRetryDelay, createFlowEngine, createFlowScheduler, createFlowService, createFlowTriggerHandler, deadLetterFlow, executeStep, flowDeadLetterTable, flowExecutionsTable, flowSchedulesTable, isTerminal, isValidTransition, sweepFailedFlows, } from './flows/index.js';
+// ── Observability ──
+export { createChildSpan, createMetricsRegistry, createPlumbusMetrics, createStructuredLogger, createTraceContext, createTracer, extractTraceFromHeaders, formatTraceparent, generateSpanId, generateTraceId, injectTraceHeaders, parseTraceparent, } from './observability/index.js';
+// ── Server Bootstrap ──
+export { createServer } from './server/index.js';
+// ── Types (re-export everything) ──
+export * from './types/index.js';
+// ── Worker Bootstrap ──
+export { createWorkerPool } from './worker/index.js';
+// ── CLI (entry point + scaffolding + code generation) ──
+export { 
+// Scaffolding templates
+capabilityTemplate, capabilityTestTemplate, 
+// Doctor checks
+checkAppStructure, checkConfig, checkNodeVersion, checkPackageJson, checkPlumbusCore, checkPostgreSQL, checkRedis, checkTypeScript, createCli, entityTemplate, 
+// Policy certification (plumbus certify)
+evaluatePolicy, eventTemplate, flowTemplate, 
+// Agent wiring (plumbus init)
+generateAgentsMd, 
+// Code generation
+generateAll, 
+// Agent briefs
+generateCapabilityBrief, generateClientFunction, generateCopilotInstructions, generateCursorCapabilityRule, generateCursorRule, generateEntityBrief, generateManifestEntry, generateOpenApiPath, generateProjectBrief, generateProjectBriefFromResources, 
+// Project scaffolding
+generateProjectStructure, generateReactHook, promptTemplate, 
+// CLI verify rules
+ruleCapabilityAccessPolicy, ruleCapabilityEffects, ruleEncryptedSensitiveFields, ruleEntityFieldClassification, ruleEntityTenantIsolation, 
+// Dev server
+runDev, runDoctorChecks, runFullDoctorChecks, runGovernanceRules, startDevServer, 
+// Utilities
+toCamelCase, toKebabCase, toPascalCase, writeAgentFiles, } from './cli/index.js';
+// ── Governance Engine (advisory governance rules + policy reports) ──
+export { aiRules, applyOverrides, architectureRules, builtInProfiles, createGovernanceRuleEngine, createOverrideStore, evaluatePolicyProfile, formatPolicyReport, generateAllPolicyReports, generatePolicyReport, ruleCapabilityMissingAccessPolicy as govRuleCapabilityMissingAccessPolicy, ruleEntityTenantIsolation as govRuleEntityTenantIsolation, privacyRules, ruleAIWithoutExplanation, ruleCrossTenantDataAccess, ruleEntityMissingDescription, ruleExcessiveAIUsage, ruleExcessiveDataRetention, ruleExcessiveEffects, ruleExcessiveFlowBranching, ruleExcessiveFlowSteps, ruleMissingAuditConfig, ruleMissingFieldClassification, ruleOverlyPermissiveRoles, rulePersonalDataInLogs, ruleSensitiveFieldUnencrypted, securityRules, } from './governance/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/observability/__tests__/metrics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metrics.test.d.ts.map

package/dist/observability/__tests__/metrics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.test.d.ts","sourceRoot":"","sources":["../../../src/observability/__tests__/metrics.test.ts"],"names":[],"mappings":""}

package/dist/observability/__tests__/metrics.test.js

@@ -0,0 +1,301 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { createChildSpan, createMetricsRegistry, createPlumbusMetrics, createStructuredLogger, createTraceContext, generateSpanId, generateTraceId, } from '../metrics.js';
+// ── Tests ──
+describe('Observability', () => {
+    describe('MetricsRegistry', () => {
+        it('creates a registry with counter, histogram, and serialize', () => {
+            const registry = createMetricsRegistry();
+            expect(registry).toHaveProperty('counter');
+            expect(registry).toHaveProperty('histogram');
+            expect(registry).toHaveProperty('serialize');
+        });
+        describe('counter', () => {
+            it('starts at 0', () => {
+                const registry = createMetricsRegistry();
+                const counter = registry.counter('test_counter', 'A test counter');
+                expect(counter.get()).toBe(0);
+            });
+            it('increments by 1 by default', () => {
+                const registry = createMetricsRegistry();
+                const counter = registry.counter('test_counter', 'A test counter');
+                counter.inc();
+                expect(counter.get()).toBe(1);
+            });
+            it('increments by a custom value', () => {
+                const registry = createMetricsRegistry();
+                const counter = registry.counter('test_counter', 'A test counter');
+                counter.inc(undefined, 5);
+                expect(counter.get()).toBe(5);
+            });
+            it('supports labeled counters independently', () => {
+                const registry = createMetricsRegistry();
+                const counter = registry.counter('http_requests', 'Total HTTP requests');
+                counter.inc({ method: 'GET' }, 3);
+                counter.inc({ method: 'POST' }, 2);
+                expect(counter.get({ method: 'GET' })).toBe(3);
+                expect(counter.get({ method: 'POST' })).toBe(2);
+                expect(counter.get()).toBe(0); // unlabeled is separate
+            });
+            it('accumulates increments', () => {
+                const registry = createMetricsRegistry();
+                const counter = registry.counter('test', 't');
+                counter.inc();
+                counter.inc();
+                counter.inc();
+                expect(counter.get()).toBe(3);
+            });
+            it('returns the same counter instance for the same name', () => {
+                const registry = createMetricsRegistry();
+                const c1 = registry.counter('my_counter', 'help');
+                c1.inc();
+                const c2 = registry.counter('my_counter', 'help');
+                expect(c2.get()).toBe(1);
+            });
+        });
+        describe('histogram', () => {
+            it('starts with count 0 and sum 0', () => {
+                const registry = createMetricsRegistry();
+                const h = registry.histogram('test_histogram', 'A test histogram');
+                expect(h.getCount()).toBe(0);
+                expect(h.getSum()).toBe(0);
+            });
+            it('tracks count and sum of observations', () => {
+                const registry = createMetricsRegistry();
+                const h = registry.histogram('duration', 'Duration');
+                h.observe(10);
+                h.observe(20);
+                h.observe(30);
+                expect(h.getCount()).toBe(3);
+                expect(h.getSum()).toBe(60);
+            });
+            it('supports labeled histograms independently', () => {
+                const registry = createMetricsRegistry();
+                const h = registry.histogram('request_duration', 'Request duration');
+                h.observe(100, { route: '/api' });
+                h.observe(200, { route: '/api' });
+                h.observe(50, { route: '/health' });
+                expect(h.getCount({ route: '/api' })).toBe(2);
+                expect(h.getSum({ route: '/api' })).toBe(300);
+                expect(h.getCount({ route: '/health' })).toBe(1);
+                expect(h.getSum({ route: '/health' })).toBe(50);
+            });
+            it('returns the same histogram instance for the same name', () => {
+                const registry = createMetricsRegistry();
+                const h1 = registry.histogram('my_hist', 'help');
+                h1.observe(42);
+                const h2 = registry.histogram('my_hist', 'help');
+                expect(h2.getCount()).toBe(1);
+                expect(h2.getSum()).toBe(42);
+            });
+        });
+        describe('serialize', () => {
+            it('serializes empty registry to empty string', () => {
+                const registry = createMetricsRegistry();
+                expect(registry.serialize()).toBe('');
+            });
+            it('serializes counters in Prometheus format', () => {
+                const registry = createMetricsRegistry();
+                const c = registry.counter('http_total', 'Total HTTP requests');
+                c.inc();
+                c.inc();
+                const output = registry.serialize();
+                expect(output).toContain('# HELP http_total Total HTTP requests');
+                expect(output).toContain('# TYPE http_total counter');
+                expect(output).toContain('http_total 2');
+            });
+            it('serializes labeled counters with label syntax', () => {
+                const registry = createMetricsRegistry();
+                const c = registry.counter('http_total', 'Total');
+                c.inc({ method: 'GET' }, 5);
+                const output = registry.serialize();
+                expect(output).toContain('http_total{method="GET"} 5');
+            });
+            it('serializes histograms with _count and _sum suffixes', () => {
+                const registry = createMetricsRegistry();
+                const h = registry.histogram('latency', 'Latency');
+                h.observe(10);
+                h.observe(20);
+                const output = registry.serialize();
+                expect(output).toContain('# HELP latency Latency');
+                expect(output).toContain('# TYPE latency histogram');
+                expect(output).toContain('latency_count 2');
+                expect(output).toContain('latency_sum 30');
+            });
+            it('serializes multiple metrics together', () => {
+                const registry = createMetricsRegistry();
+                registry.counter('a_counter', 'A').inc();
+                registry.histogram('b_hist', 'B').observe(99);
+                const output = registry.serialize();
+                expect(output).toContain('a_counter');
+                expect(output).toContain('b_hist');
+            });
+            it('sorts labels deterministically', () => {
+                const registry = createMetricsRegistry();
+                const c = registry.counter('test', 'test');
+                c.inc({ z: '1', a: '2' });
+                const output = registry.serialize();
+                // Labels should be sorted: a="2",z="1"
+                expect(output).toContain('test{a="2",z="1"} 1');
+            });
+        });
+    });
+    describe('PlumbusMetrics', () => {
+        it('creates all 14 standard metrics', () => {
+            const metrics = createPlumbusMetrics();
+            expect(metrics.requestDuration).toBeDefined();
+            expect(metrics.requestTotal).toBeDefined();
+            expect(metrics.requestErrors).toBeDefined();
+            expect(metrics.capabilityDuration).toBeDefined();
+            expect(metrics.capabilityTotal).toBeDefined();
+            expect(metrics.eventEmitted).toBeDefined();
+            expect(metrics.eventDelivered).toBeDefined();
+            expect(metrics.eventFailed).toBeDefined();
+            expect(metrics.flowStarted).toBeDefined();
+            expect(metrics.flowCompleted).toBeDefined();
+            expect(metrics.flowFailed).toBeDefined();
+            expect(metrics.aiRequestDuration).toBeDefined();
+            expect(metrics.aiRequestTotal).toBeDefined();
+            expect(metrics.queueDepth).toBeDefined();
+        });
+        it('exposes registry for serialization', () => {
+            const metrics = createPlumbusMetrics();
+            expect(metrics.registry).toBeDefined();
+            expect(typeof metrics.registry.serialize).toBe('function');
+        });
+        it('uses a shared registry so metrics appear in serialize()', () => {
+            const metrics = createPlumbusMetrics();
+            metrics.requestTotal.inc();
+            metrics.requestDuration.observe(42);
+            const output = metrics.registry.serialize();
+            expect(output).toContain('plumbus_request_total');
+            expect(output).toContain('plumbus_request_duration_ms');
+        });
+        it('accepts a custom registry', () => {
+            const registry = createMetricsRegistry();
+            const metrics = createPlumbusMetrics(registry);
+            metrics.flowStarted.inc();
+            const output = registry.serialize();
+            expect(output).toContain('plumbus_flow_started_total');
+        });
+    });
+    describe('StructuredLogger', () => {
+        beforeEach(() => {
+            vi.spyOn(console, 'info').mockImplementation(() => { });
+            vi.spyOn(console, 'warn').mockImplementation(() => { });
+            vi.spyOn(console, 'error').mockImplementation(() => { });
+        });
+        it('outputs JSON to console.info for info level', () => {
+            const logger = createStructuredLogger({ component: 'test' });
+            logger.info('hello');
+            expect(console.info).toHaveBeenCalledTimes(1);
+            const output = JSON.parse(console.info.mock.calls[0][0]);
+            expect(output.level).toBe('info');
+            expect(output.message).toBe('hello');
+            expect(output.component).toBe('test');
+            expect(output.timestamp).toBeDefined();
+        });
+        it('outputs JSON to console.warn for warn level', () => {
+            const logger = createStructuredLogger();
+            logger.warn('watch out');
+            expect(console.warn).toHaveBeenCalledTimes(1);
+            const output = JSON.parse(console.warn.mock.calls[0][0]);
+            expect(output.level).toBe('warn');
+            expect(output.message).toBe('watch out');
+        });
+        it('outputs JSON to console.error for error level', () => {
+            const logger = createStructuredLogger();
+            logger.error('something broke');
+            expect(console.error).toHaveBeenCalledTimes(1);
+            const output = JSON.parse(console.error.mock.calls[0][0]);
+            expect(output.level).toBe('error');
+            expect(output.message).toBe('something broke');
+        });
+        it('includes metadata in the log entry', () => {
+            const logger = createStructuredLogger();
+            logger.info('with meta', { requestId: 'abc' });
+            const output = JSON.parse(console.info.mock.calls[0][0]);
+            expect(output.metadata).toEqual({ requestId: 'abc' });
+        });
+        it('includes correlationId, tenantId, actorId from config', () => {
+            const logger = createStructuredLogger({
+                correlationId: 'corr-1',
+                tenantId: 't-1',
+                actorId: 'u-1',
+            });
+            logger.info('test');
+            const output = JSON.parse(console.info.mock.calls[0][0]);
+            expect(output.correlationId).toBe('corr-1');
+            expect(output.tenantId).toBe('t-1');
+            expect(output.actorId).toBe('u-1');
+        });
+        it('respects minLevel — skips info when minLevel is warn', () => {
+            const logger = createStructuredLogger({ minLevel: 'warn' });
+            logger.info('should be skipped');
+            logger.warn('should appear');
+            expect(console.info).not.toHaveBeenCalled();
+            expect(console.warn).toHaveBeenCalledTimes(1);
+        });
+        it('respects minLevel — skips warn when minLevel is error', () => {
+            const logger = createStructuredLogger({ minLevel: 'error' });
+            logger.info('skip');
+            logger.warn('skip');
+            logger.error('show');
+            expect(console.info).not.toHaveBeenCalled();
+            expect(console.warn).not.toHaveBeenCalled();
+            expect(console.error).toHaveBeenCalledTimes(1);
+        });
+        it('defaults to info minLevel', () => {
+            const logger = createStructuredLogger();
+            logger.info('should appear');
+            expect(console.info).toHaveBeenCalledTimes(1);
+        });
+    });
+    describe('TraceContext', () => {
+        it('creates a root trace context with traceId and spanId', () => {
+            const ctx = createTraceContext();
+            expect(ctx.traceId).toBeDefined();
+            expect(ctx.spanId).toBeDefined();
+            expect(ctx.parentSpanId).toBeUndefined();
+        });
+        it('generates unique trace IDs', () => {
+            const id1 = generateTraceId();
+            const id2 = generateTraceId();
+            expect(id1).not.toBe(id2);
+        });
+        it('generates unique span IDs', () => {
+            const id1 = generateSpanId();
+            const id2 = generateSpanId();
+            expect(id1).not.toBe(id2);
+        });
+        it("trace ID starts with 'trace-'", () => {
+            expect(generateTraceId()).toMatch(/^trace-/);
+        });
+        it("span ID starts with 'span-'", () => {
+            expect(generateSpanId()).toMatch(/^span-/);
+        });
+        it('createChildSpan preserves parent traceId', () => {
+            const parent = createTraceContext();
+            const child = createChildSpan(parent);
+            expect(child.traceId).toBe(parent.traceId);
+        });
+        it('createChildSpan sets parentSpanId to parent spanId', () => {
+            const parent = createTraceContext();
+            const child = createChildSpan(parent);
+            expect(child.parentSpanId).toBe(parent.spanId);
+        });
+        it('createChildSpan generates a new spanId', () => {
+            const parent = createTraceContext();
+            const child = createChildSpan(parent);
+            expect(child.spanId).not.toBe(parent.spanId);
+        });
+        it('supports multi-level spans', () => {
+            const root = createTraceContext();
+            const child = createChildSpan(root);
+            const grandchild = createChildSpan(child);
+            expect(grandchild.traceId).toBe(root.traceId);
+            expect(grandchild.parentSpanId).toBe(child.spanId);
+            expect(grandchild.spanId).not.toBe(child.spanId);
+        });
+    });
+});
+//# sourceMappingURL=metrics.test.js.map

package/dist/observability/__tests__/metrics.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.test.js","sourceRoot":"","sources":["../../../src/observability/__tests__/metrics.test.ts"],"names":[],"mappings":"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"}

package/dist/observability/index.d.ts

@@ -0,0 +1,3 @@
+export { createChildSpan, createMetricsRegistry, createPlumbusMetrics, createStructuredLogger, createTraceContext, createTracer, extractTraceFromHeaders, formatTraceparent, generateSpanId, generateTraceId, injectTraceHeaders, parseTraceparent, } from './metrics.js';
+export type { Counter, Histogram, MetricLabels, MetricsRegistry, PlumbusMetrics, Span, SpanExporter, SpanKind, SpanOptions, SpanStatusCode, StructuredLogEntry, StructuredLoggerConfig, TraceContext, Tracer, W3CTraceContext, } from './metrics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,OAAO,EACP,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,IAAI,EACJ,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,MAAM,EACN,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,7 @@
+// ── Observability Module ──
+// Structured logging, metrics (counters, histograms), and distributed tracing
+// (W3C Trace Context). Provides ctx.logger and trace propagation.
+//
+// Key exports: createStructuredLogger, createPlumbusMetrics, createTracer
+export { createChildSpan, createMetricsRegistry, createPlumbusMetrics, createStructuredLogger, createTraceContext, createTracer, extractTraceFromHeaders, formatTraceparent, generateSpanId, generateTraceId, injectTraceHeaders, parseTraceparent, } from './metrics.js';
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,8EAA8E;AAC9E,kEAAkE;AAClE,EAAE;AACF,0EAA0E;AAE1E,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/observability/metrics.d.ts

@@ -0,0 +1,130 @@
+import type { LoggerService } from '../types/context.js';
+export interface MetricLabels {
+    [key: string]: string;
+}
+export interface Counter {
+    inc(labels?: MetricLabels, value?: number): void;
+    get(labels?: MetricLabels): number;
+}
+export interface Histogram {
+    observe(value: number, labels?: MetricLabels): void;
+    getCount(labels?: MetricLabels): number;
+    getSum(labels?: MetricLabels): number;
+}
+export interface MetricsRegistry {
+    counter(name: string, help: string): Counter;
+    histogram(name: string, help: string): Histogram;
+    /** Prometheus-compatible text exposition */
+    serialize(): string;
+}
+/** Create an in-memory metrics registry (Prometheus-style) */
+export declare function createMetricsRegistry(): MetricsRegistry;
+export interface PlumbusMetrics {
+    requestDuration: Histogram;
+    requestTotal: Counter;
+    requestErrors: Counter;
+    capabilityDuration: Histogram;
+    capabilityTotal: Counter;
+    eventEmitted: Counter;
+    eventDelivered: Counter;
+    eventFailed: Counter;
+    flowStarted: Counter;
+    flowCompleted: Counter;
+    flowFailed: Counter;
+    aiRequestDuration: Histogram;
+    aiRequestTotal: Counter;
+    queueDepth: Counter;
+    registry: MetricsRegistry;
+}
+/** Create the standard set of Plumbus runtime metrics */
+export declare function createPlumbusMetrics(registry?: MetricsRegistry): PlumbusMetrics;
+export interface StructuredLogEntry {
+    level: 'info' | 'warn' | 'error' | 'debug';
+    message: string;
+    timestamp: string;
+    correlationId?: string;
+    tenantId?: string;
+    actorId?: string;
+    component?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface StructuredLoggerConfig {
+    /** Base component name */
+    component?: string;
+    /** Correlation ID for request tracing */
+    correlationId?: string;
+    /** Tenant ID for tenant-scoped logging */
+    tenantId?: string;
+    /** Actor ID for audit trail */
+    actorId?: string;
+    /** Minimum log level to emit (default: "info") */
+    minLevel?: 'debug' | 'info' | 'warn' | 'error';
+}
+/** Create a structured JSON logger conforming to LoggerService */
+export declare function createStructuredLogger(config?: StructuredLoggerConfig): LoggerService;
+export interface TraceContext {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+}
+/** Generate a simple trace ID */
+export declare function generateTraceId(): string;
+/** Generate a simple span ID */
+export declare function generateSpanId(): string;
+/** Create a new root trace context */
+export declare function createTraceContext(): TraceContext;
+/** Create a child span from a parent trace context */
+export declare function createChildSpan(parent: TraceContext): TraceContext;
+export type SpanKind = 'internal' | 'server' | 'client' | 'producer' | 'consumer';
+export type SpanStatusCode = 'unset' | 'ok' | 'error';
+export interface SpanOptions {
+    kind?: SpanKind;
+    attributes?: Record<string, string | number | boolean>;
+    parentSpanId?: string;
+}
+export interface Span {
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly parentSpanId?: string;
+    readonly name: string;
+    readonly kind: SpanKind;
+    readonly startTime: number;
+    endTime?: number;
+    status: SpanStatusCode;
+    statusMessage?: string;
+    attributes: Record<string, string | number | boolean>;
+    /** Set an attribute on the span */
+    setAttribute(key: string, value: string | number | boolean): void;
+    /** Record an error on the span */
+    recordError(error: Error): void;
+    /** End the span with the current timestamp */
+    end(): void;
+}
+export interface SpanExporter {
+    export(spans: Span[]): void;
+}
+export interface Tracer {
+    /** Start a new span, optionally as a child of the current context */
+    startSpan(name: string, options?: SpanOptions): Span;
+    /** Get all finished (exported) spans */
+    getFinishedSpans(): Span[];
+    /** Flush all finished spans to the exporter */
+    flush(): void;
+}
+/** Create an in-memory tracer compatible with OpenTelemetry span semantics */
+export declare function createTracer(traceId?: string, exporter?: SpanExporter): Tracer;
+export interface W3CTraceContext {
+    version: string;
+    traceId: string;
+    parentId: string;
+    traceFlags: number;
+}
+/** Parse a W3C traceparent header into structured trace context */
+export declare function parseTraceparent(header: string): W3CTraceContext | null;
+/** Format a trace context as a W3C traceparent header value */
+export declare function formatTraceparent(ctx: W3CTraceContext): string;
+/** Extract trace context from HTTP headers (case-insensitive lookup) */
+export declare function extractTraceFromHeaders(headers: Record<string, string | string[] | undefined>): W3CTraceContext | null;
+/** Inject trace context into HTTP headers for propagation */
+export declare function injectTraceHeaders(ctx: W3CTraceContext, headers: Record<string, string>): Record<string, string>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"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"}