observability-toolkit 2.0.0 → 2.1.0

package/dist/lib/validation/dashboard-schemas.js

@@ -0,0 +1,186 @@
+/**
+ * Zod schemas for dashboard script data validation.
+ *
+ * Provides runtime validation for:
+ * - derive-evaluations.ts: TraceSpan, OTel evaluation records
+ * - judge-evaluations.ts: Log entries, transcript turns, evaluation records
+ * - sync-to-kv.ts: KV sync state files
+ *
+ * All schemas are strict and coercive where appropriate to handle
+ * telemetry data from various sources.
+ */
+import { z } from 'zod';
+import { scoreUnitSchema, severitySchema, SpanIdSchema, TraceIdSchema } from '../core/shared-schemas.js';
+// ============================================================================
+// Evaluator enums (shared across derive-evaluations and judge-evaluations)
+// ============================================================================
+/**
+ * Identifies which system produced an evaluation record.
+ * Distinct from evaluatorType (which classifies the mechanism).
+ */
+export const genAiEvaluatorSchema = z.enum([
+    'llm-judge',
+    'seed-hash',
+    'telemetry-rule-engine',
+]);
+/**
+ * Classifies the mechanism that produced an evaluation record.
+ * Distinct from GenAiEvaluator (which identifies the system).
+ */
+export const genAiEvaluatorTypeSchema = z.enum([
+    'llm',
+    'seed',
+    'canary',
+    'rule',
+    'human',
+    'trace-backfill',
+]);
+// ============================================================================
+// Evaluation Metrics and Evaluator Constants
+// ============================================================================
+/** Hallucination evaluation metric identifier */
+export const HALLUCINATION_EVAL_NAME_SCHEMA = z.enum(['hallucination']);
+export const HALLUCINATION_EVAL_NAME = HALLUCINATION_EVAL_NAME_SCHEMA.parse('hallucination');
+/** LLM Judge evaluator identifier */
+export const LLM_JUDGE_EVALUATOR_SCHEMA = z.enum(['llm-judge']);
+export const LLM_JUDGE_EVALUATOR = LLM_JUDGE_EVALUATOR_SCHEMA.parse('llm-judge');
+/** LLM evaluator type classification */
+export const LLM_EVALUATOR_TYPE_SCHEMA = z.enum(['llm']);
+export const LLM_EVALUATOR_TYPE = LLM_EVALUATOR_TYPE_SCHEMA.parse('llm');
+// ============================================================================
+// Trace and Span Data
+// ============================================================================
+/**
+ * High-resolution time tuple: [seconds, nanoseconds]
+ */
+export const hrtSchema = z.tuple([z.number(), z.number()]).describe('High-resolution time [seconds, nanoseconds]');
+/**
+ * OpenTelemetry TraceSpan with required attributes and duration.
+ * Used in traces-*.jsonl files read by derive-evaluations.ts and judge-evaluations.ts.
+ */
+export const traceSpanSchema = z.object({
+    traceId: TraceIdSchema.describe('OTel trace ID'),
+    spanId: SpanIdSchema.describe('OTel span ID'),
+    name: z.string().describe('Span operation name'),
+    startTime: hrtSchema,
+    endTime: hrtSchema.optional(),
+    duration: hrtSchema,
+    status: z.object({
+        code: z.number(),
+        message: z.string().optional(),
+    }).optional(),
+    attributes: z.record(z.string(), z.unknown()),
+    events: z.array(z.object({
+        name: z.string(),
+        timestamp: z.number().optional(),
+        attributes: z.record(z.string(), z.unknown()).optional(),
+    })).optional(),
+});
+// ============================================================================
+// Log Entry Data (from telemetry logs)
+// ============================================================================
+/**
+ * OTel log record with structured attributes.
+ * Used by judge-evaluations.ts to discover transcript paths via token-metrics-extraction hook.
+ */
+export const otelLogEntrySchema = z.object({
+    timestamp: z.iso.datetime().optional(),
+    severity: severitySchema.optional(),
+    body: z.string().optional(),
+    attributes: z.record(z.string(), z.unknown()).optional(),
+    traceId: TraceIdSchema.optional(),
+    spanId: SpanIdSchema.optional(),
+});
+// ============================================================================
+// Transcript and Turn Data
+// ============================================================================
+/**
+ * Single turn in a conversation transcript (user message, assistant response, etc).
+ * Used by judge-evaluations.ts when parsing session transcript JSONL files.
+ */
+export const transcriptEntrySchema = z.object({
+    type: z.enum(['user', 'assistant', 'progress', 'file-history-snapshot', 'system']),
+    message: z.object({
+        role: z.string().optional(),
+        content: z.unknown().optional(),
+        model: z.string().optional(),
+        usage: z.object({
+            input_tokens: z.number().optional(),
+            output_tokens: z.number().optional(),
+            cache_read_input_tokens: z.number().optional(),
+            cache_creation_input_tokens: z.number().optional(),
+        }).optional(),
+    }).optional(),
+    timestamp: z.iso.datetime().optional(),
+});
+// ============================================================================
+// Evaluation Record Data (OTel format)
+// ============================================================================
+/**
+ * OTel evaluation record written by derive-evaluations.ts.
+ * Schema: attributes object with gen_ai.evaluation.* fields plus traceId.
+ * Used by both derive-evaluations.ts (preserving non-rule evals) and
+ * judge-evaluations.ts (detecting LLM judge results).
+ */
+export const otelEvaluationRecordSchema = z.object({
+    timestamp: z.iso.datetime(),
+    name: z.literal('gen_ai.evaluation.result'),
+    attributes: z.looseObject({
+        'gen_ai.evaluation.name': z.string().optional(),
+        'gen_ai.evaluation.score.value': z.number().optional(),
+        'gen_ai.evaluation.score.unit': scoreUnitSchema.optional(),
+        'gen_ai.evaluation.explanation': z.string().optional(),
+        'gen_ai.evaluation.evaluator': genAiEvaluatorSchema,
+        'gen_ai.evaluation.evaluator.type': genAiEvaluatorTypeSchema,
+        'session.id': z.string().optional(),
+    }),
+    traceId: TraceIdSchema.optional(),
+    spanId: SpanIdSchema.optional(),
+});
+// ============================================================================
+// KV Sync State (sync-to-kv.ts)
+// ============================================================================
+/**
+ * KV sync state file schema (.kv-sync-state.json).
+ * Tracks hash for entries synced to Cloudflare KV.
+ */
+export const kvSyncEntrySchema = z.object({
+    hash: z.string().describe('Content hash (SHA-256 hex)'),
+});
+/**
+ * KV sync state object (.kv-sync-state.json).
+ * Maps entry keys to sync metadata.
+ */
+export const kvSyncStateSchema = z.record(z.string(), kvSyncEntrySchema);
+// ============================================================================
+// KV Entry Values (dashboard metric data stored in KV)
+// ============================================================================
+/**
+ * Worst-case evaluation reference in metric detail.
+ */
+export const worstEvaluationRefSchema = z.object({
+    traceId: TraceIdSchema.optional(),
+    timestamp: z.iso.datetime().optional(),
+    score: z.number().optional(),
+});
+/**
+ * Metric detail entry value stored in KV.
+ * Contains worst evaluations for a metric×period.
+ */
+export const metricDetailValueSchema = z.looseObject({
+    worstEvaluations: z.array(worstEvaluationRefSchema).optional(),
+    rows: z.array(z.unknown()).optional(),
+});
+/**
+ * Coverage heatmap data structure.
+ */
+export const coverageHeatmapSchema = z.object({
+    totalTraces: z.number(),
+    syncedTraces: z.number(),
+    coveragePercent: z.number(),
+    referencedCoverage: z.number(),
+    runsRemaining: z.number().nullable().optional(),
+    timestamp: z.iso.datetime(),
+    lastChecked: z.iso.datetime(),
+});
+//# sourceMappingURL=dashboard-schemas.js.map

package/dist/lib/validation/dashboard-schemas.js.map

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

package/dist/lib/validation/dashboard-schemas.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Validation tests for dashboard schemas
+ */
+export {};
+//# sourceMappingURL=dashboard-schemas.test.d.ts.map

package/dist/lib/validation/dashboard-schemas.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-schemas.test.d.ts","sourceRoot":"","sources":["../../../src/lib/validation/dashboard-schemas.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/lib/validation/dashboard-schemas.test.js

@@ -0,0 +1,353 @@
+/**
+ * Validation tests for dashboard schemas
+ */
+import { describe, it } from 'vitest';
+import assert from 'node:assert';
+import { testTraceId, testSpanId } from '../../test-helpers/test-data-builders.js';
+import { traceSpanSchema, otelLogEntrySchema, transcriptEntrySchema, otelEvaluationRecordSchema, kvSyncEntrySchema, kvSyncStateSchema, metricDetailValueSchema, coverageHeatmapSchema, hrtSchema, } from './dashboard-schemas.js';
+describe('Dashboard Trace & Span Schemas', () => {
+    describe('hrtSchema', () => {
+        it('validates high-resolution time tuple', () => {
+            const hrt = [1711270800, 500000000];
+            const result = hrtSchema.safeParse(hrt);
+            assert.strictEqual(result.success, true);
+        });
+        it('requires exactly 2 numbers', () => {
+            const result = hrtSchema.safeParse([1711270800]);
+            assert.strictEqual(result.success, false);
+        });
+    });
+    describe('traceSpanSchema', () => {
+        it('validates complete trace span', () => {
+            const span = {
+                traceId: testTraceId(1),
+                spanId: testSpanId(1),
+                name: 'http.request',
+                startTime: [1711270800, 500000000],
+                endTime: [1711270801, 500000000],
+                duration: [1, 0],
+                status: { code: 0, message: 'OK' },
+                attributes: {
+                    'http.method': 'GET',
+                    'http.url': 'https://example.com',
+                },
+            };
+            const result = traceSpanSchema.safeParse(span);
+            assert.strictEqual(result.success, true);
+        });
+        it('validates span with events', () => {
+            const span = {
+                traceId: testTraceId(2),
+                spanId: testSpanId(2),
+                name: 'processing',
+                startTime: [1711270800, 0],
+                duration: [0, 500000000],
+                attributes: {},
+                events: [
+                    { name: 'cache_hit', timestamp: 1711270800, attributes: { key: 'data' } },
+                    { name: 'processing_complete' },
+                ],
+            };
+            const result = traceSpanSchema.safeParse(span);
+            assert.strictEqual(result.success, true);
+        });
+        it('requires traceId, spanId, name, startTime, duration, and attributes', () => {
+            const incomplete = { traceId: 'abc', name: 'span' };
+            const result = traceSpanSchema.safeParse(incomplete);
+            assert.strictEqual(result.success, false);
+        });
+        it('fails when only some required fields are present', () => {
+            const missingDuration = {
+                traceId: 'abc',
+                spanId: 'span1',
+                name: 'test',
+                startTime: [1000, 0],
+                attributes: {},
+            };
+            const result = traceSpanSchema.safeParse(missingDuration);
+            assert.strictEqual(result.success, false);
+        });
+    });
+});
+describe('Dashboard Log Schemas', () => {
+    describe('otelLogEntrySchema', () => {
+        it('validates complete log entry', () => {
+            const entry = {
+                timestamp: '2024-03-24T12:00:00Z',
+                severity: 'INFO',
+                body: 'Processing request',
+                attributes: { 'hook.name': 'token-metrics-extraction', 'transcript.path': '/path/to/file' },
+                traceId: testTraceId(3),
+                spanId: testSpanId(3),
+            };
+            const result = otelLogEntrySchema.safeParse(entry);
+            assert.strictEqual(result.success, true);
+        });
+        it('allows partial fields', () => {
+            const entry = {
+                body: 'Simple log message',
+            };
+            const result = otelLogEntrySchema.safeParse(entry);
+            assert.strictEqual(result.success, true);
+        });
+    });
+});
+describe('Dashboard Transcript Schemas', () => {
+    describe('transcriptEntrySchema', () => {
+        it('validates user message', () => {
+            const entry = {
+                type: 'user',
+                message: {
+                    role: 'user',
+                    content: 'Hello assistant',
+                },
+                timestamp: '2024-03-24T12:00:00Z',
+            };
+            const result = transcriptEntrySchema.safeParse(entry);
+            assert.strictEqual(result.success, true);
+        });
+        it('validates assistant response with usage', () => {
+            const entry = {
+                type: 'assistant',
+                message: {
+                    role: 'assistant',
+                    content: 'Hello! How can I help?',
+                    model: 'claude-3-opus',
+                    usage: {
+                        input_tokens: 50,
+                        output_tokens: 25,
+                        cache_read_input_tokens: 10,
+                        cache_creation_input_tokens: 0,
+                    },
+                },
+                timestamp: '2024-03-24T12:00:01Z',
+            };
+            const result = transcriptEntrySchema.safeParse(entry);
+            assert.strictEqual(result.success, true);
+        });
+        it('validates file-history-snapshot type', () => {
+            const entry = {
+                type: 'file-history-snapshot',
+                timestamp: '2024-03-24T12:00:00Z',
+            };
+            const result = transcriptEntrySchema.safeParse(entry);
+            assert.strictEqual(result.success, true);
+        });
+        it('validates system message type', () => {
+            const entry = {
+                type: 'system',
+                message: { content: 'System notification' },
+            };
+            const result = transcriptEntrySchema.safeParse(entry);
+            assert.strictEqual(result.success, true);
+        });
+        it('rejects invalid types', () => {
+            const entry = { type: 'invalid_type' };
+            const result = transcriptEntrySchema.safeParse(entry);
+            assert.strictEqual(result.success, false);
+        });
+    });
+});
+describe('Dashboard Evaluation Schemas', () => {
+    describe('otelEvaluationRecordSchema', () => {
+        it('validates evaluation with gen_ai attributes', () => {
+            const record = {
+                timestamp: '2024-03-24T12:00:00Z',
+                name: 'gen_ai.evaluation.result',
+                attributes: {
+                    'gen_ai.evaluation.name': 'relevance',
+                    'gen_ai.evaluation.score.value': 0.85,
+                    'gen_ai.evaluation.score.unit': 'ratio_0_1',
+                    'gen_ai.evaluation.explanation': 'Response is relevant',
+                    'gen_ai.evaluation.evaluator': 'llm-judge',
+                    'gen_ai.evaluation.evaluator.type': 'llm',
+                    'session.id': 'sess-123',
+                },
+                traceId: testTraceId(4),
+            };
+            const result = otelEvaluationRecordSchema.safeParse(record);
+            assert.strictEqual(result.success, true);
+        });
+        it('allows passthrough of unknown attributes', () => {
+            const record = {
+                timestamp: '2024-03-24T12:00:00Z',
+                name: 'gen_ai.evaluation.result',
+                attributes: {
+                    'gen_ai.evaluation.name': 'test',
+                    'gen_ai.evaluation.evaluator': 'llm-judge',
+                    'gen_ai.evaluation.evaluator.type': 'llm',
+                    'custom.attribute': 'custom value',
+                    'another.field': 123,
+                },
+            };
+            const result = otelEvaluationRecordSchema.safeParse(record);
+            assert.strictEqual(result.success, true);
+        });
+        it('rejects missing timestamp', () => {
+            const record = {
+                name: 'gen_ai.evaluation.result',
+                attributes: {
+                    'gen_ai.evaluation.evaluator': 'llm-judge',
+                    'gen_ai.evaluation.evaluator.type': 'llm',
+                },
+            };
+            const result = otelEvaluationRecordSchema.safeParse(record);
+            assert.strictEqual(result.success, false);
+        });
+        it('rejects missing name literal', () => {
+            const record = {
+                timestamp: '2024-03-24T12:00:00Z',
+                attributes: {
+                    'gen_ai.evaluation.evaluator': 'llm-judge',
+                    'gen_ai.evaluation.evaluator.type': 'llm',
+                },
+            };
+            const result = otelEvaluationRecordSchema.safeParse(record);
+            assert.strictEqual(result.success, false);
+        });
+        it('rejects attributes missing required evaluator fields', () => {
+            const record = {
+                timestamp: '2024-03-24T12:00:00Z',
+                name: 'gen_ai.evaluation.result',
+                attributes: {},
+            };
+            const result = otelEvaluationRecordSchema.safeParse(record);
+            assert.strictEqual(result.success, false);
+        });
+    });
+});
+describe('Dashboard KV State Schemas', () => {
+    describe('kvSyncEntrySchema', () => {
+        it('validates sync entry with hash', () => {
+            const entry = { hash: 'abc123' };
+            const result = kvSyncEntrySchema.safeParse(entry);
+            assert.strictEqual(result.success, true);
+        });
+        it('strips unknown fields', () => {
+            const entry = {
+                hash: 'a1b2c3d4e5f6',
+                syncedAt: '2024-03-24T12:00:00Z',
+                size: 1024,
+            };
+            const result = kvSyncEntrySchema.safeParse(entry);
+            assert.strictEqual(result.success, true);
+            assert.ok(result.success && !('syncedAt' in result.data));
+            assert.ok(result.success && !('size' in result.data));
+        });
+        it('rejects missing hash', () => {
+            const entry = { syncedAt: '2024-03-24T12:00:00Z' };
+            const result = kvSyncEntrySchema.safeParse(entry);
+            assert.strictEqual(result.success, false);
+        });
+    });
+    describe('kvSyncStateSchema', () => {
+        it('validates sync state object', () => {
+            const state = {
+                'key1': { hash: 'abc123' },
+                'key2': { hash: 'def456' },
+            };
+            const result = kvSyncStateSchema.safeParse(state);
+            assert.strictEqual(result.success, true);
+        });
+        it('allows empty state', () => {
+            const state = {};
+            const result = kvSyncStateSchema.safeParse(state);
+            assert.strictEqual(result.success, true);
+        });
+    });
+});
+describe('Dashboard Metric Detail Schemas', () => {
+    describe('metricDetailValueSchema', () => {
+        it('validates metric detail with worst evaluations', () => {
+            const detail = {
+                worstEvaluations: [
+                    { traceId: testTraceId(5), timestamp: '2024-03-24T12:00:00Z', score: 0.3 },
+                    { traceId: testTraceId(6), timestamp: '2024-03-24T11:00:00Z', score: 0.5 },
+                ],
+                rows: [{ data: 'value' }],
+            };
+            const result = metricDetailValueSchema.safeParse(detail);
+            assert.strictEqual(result.success, true);
+        });
+        it('allows passthrough of additional fields', () => {
+            const detail = {
+                customMetricField: 'custom value',
+                worstEvaluations: [],
+                nestedData: { level1: { level2: 'value' } },
+            };
+            const result = metricDetailValueSchema.safeParse(detail);
+            assert.strictEqual(result.success, true);
+        });
+    });
+});
+describe('Dashboard Coverage Schemas', () => {
+    describe('coverageHeatmapSchema', () => {
+        it('validates coverage heatmap', () => {
+            const coverage = {
+                totalTraces: 1000,
+                syncedTraces: 850,
+                coveragePercent: 85.0,
+                referencedCoverage: 80.0,
+                runsRemaining: 150,
+                timestamp: '2024-03-24T12:00:00Z',
+                lastChecked: '2024-03-24T12:05:00Z',
+            };
+            const result = coverageHeatmapSchema.safeParse(coverage);
+            assert.strictEqual(result.success, true);
+        });
+        it('allows null runsRemaining', () => {
+            const coverage = {
+                totalTraces: 100,
+                syncedTraces: 100,
+                coveragePercent: 100,
+                referencedCoverage: 95,
+                runsRemaining: null,
+                timestamp: '2024-03-24T12:00:00Z',
+                lastChecked: '2024-03-24T12:00:00Z',
+            };
+            const result = coverageHeatmapSchema.safeParse(coverage);
+            assert.strictEqual(result.success, true);
+        });
+        it('requires all coverage statistics', () => {
+            const incomplete = {
+                totalTraces: 100,
+                timestamp: '2024-03-24T12:00:00Z',
+            };
+            const result = coverageHeatmapSchema.safeParse(incomplete);
+            assert.strictEqual(result.success, false);
+        });
+    });
+});
+describe('Dashboard Schema Round-Trip', () => {
+    it('validates trace span through JSON serialization', () => {
+        const original = {
+            traceId: testTraceId(7),
+            spanId: testSpanId(7),
+            name: 'test',
+            startTime: [1000, 0],
+            duration: [0, 500000000],
+            attributes: { 'key': 'value' },
+        };
+        const parsed = traceSpanSchema.parse(original);
+        const json = JSON.stringify(parsed);
+        const reparsed = traceSpanSchema.parse(JSON.parse(json));
+        assert.deepStrictEqual(reparsed, parsed);
+    });
+    it('validates evaluation record through JSON serialization', () => {
+        const original = {
+            timestamp: '2024-03-24T12:00:00Z',
+            name: 'gen_ai.evaluation.result',
+            attributes: {
+                'gen_ai.evaluation.name': 'test',
+                'gen_ai.evaluation.score.value': 0.8,
+                'gen_ai.evaluation.evaluator': 'llm-judge',
+                'gen_ai.evaluation.evaluator.type': 'llm',
+            },
+        };
+        const parsed = otelEvaluationRecordSchema.parse(original);
+        const json = JSON.stringify(parsed);
+        const reparsed = otelEvaluationRecordSchema.parse(JSON.parse(json));
+        assert.deepStrictEqual(reparsed, parsed);
+    });
+});
+//# sourceMappingURL=dashboard-schemas.test.js.map

package/dist/lib/validation/dashboard-schemas.test.js.map

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

package/dist/server.d.ts

@@ -7,9 +7,10 @@
  *
  * Install: claude mcp add observability-toolkit -- npx -y @alyshia/observability-toolkit
  */
-export { RateLimiter, ServerInitError } from './lib/server-utils.js';
+export { RateLimiter, ServerInitError } from './lib/core/server-utils.js';
 /**
  * Remove signal handlers (for testing or error recovery).
+ * Uses stored references to avoid removing third-party handlers (CR-M4).
  * @internal
  */
 export declare function removeSignalHandlers(): void;

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AA0CH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAuNrE;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AA8DH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AA6O1E;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAS3C"}