pi-harness-runtime 0.5.0 → 0.6.3-beta.13

package/packages/observability/dist/tracer.js

@@ -0,0 +1,261 @@
+/**
+ * Observability Package - Tracer
+ *
+ * Distributed tracing with OpenTelemetry-compatible interface.
+ */
+import { randomUUID } from "node:crypto";
+import { Logger } from "./logger.js";
+// ─── Span Handle ─────────────────────────────────────────────────────────────
+export class SpanHandle {
+    tracer;
+    span;
+    ended = false;
+    constructor(tracer, span) {
+        this.tracer = tracer;
+        this.span = span;
+    }
+    /**
+     * End the span
+     */
+    end() {
+        if (this.ended)
+            return;
+        this.ended = true;
+        this.span.endTime = Date.now();
+        this.tracer.recordCompletedSpan(this.span);
+    }
+    /**
+     * Set span status
+     */
+    setStatus(status) {
+        this.span.status = status;
+    }
+    /**
+     * Set an attribute
+     */
+    setAttribute(key, value) {
+        this.span.attributes[key] = value;
+    }
+    /**
+     * Add an event to the span
+     */
+    addEvent(name, attributes) {
+        const event = {
+            name,
+            timestamp: Date.now(),
+            attributes,
+        };
+        this.span.events.push(event);
+    }
+    /**
+     * Record an exception
+     */
+    recordException(error) {
+        this.span.status = "error";
+        this.addEvent("exception", {
+            "exception.type": error.name,
+            "exception.message": error.message,
+            "exception.stacktrace": error.stack ?? "",
+        });
+    }
+    /**
+     * Get the underlying span
+     */
+    getSpan() {
+        return this.span;
+    }
+}
+// ─── Tracer Class ────────────────────────────────────────────────────────────
+export class Tracer {
+    config;
+    logger;
+    spans = [];
+    currentSpan;
+    constructor(config) {
+        this.config = config;
+        this.logger = new Logger({ level: config.logLevel ?? "warn" });
+    }
+    /**
+     * Generate a new trace ID
+     */
+    generateTraceId() {
+        return randomUUID();
+    }
+    /**
+     * Generate a new span ID
+     */
+    generateSpanId() {
+        return randomUUID().replace(/-/g, "").slice(0, 16);
+    }
+    /**
+     * Start a new span
+     */
+    startSpan(name, options) {
+        const traceId = this.generateTraceId();
+        const spanId = this.generateSpanId();
+        const span = {
+            name,
+            traceId,
+            spanId,
+            parentSpanId: options?.parentSpanId,
+            startTime: Date.now(),
+            status: "ok",
+            attributes: options?.attributes ?? {},
+            events: [],
+            links: options?.links ?? [],
+        };
+        const handle = new SpanHandle(this, span);
+        this.currentSpan = handle;
+        return handle;
+    }
+    /**
+     * Get the current active span
+     */
+    getCurrentSpan() {
+        return this.currentSpan ?? null;
+    }
+    /**
+     * Record a completed span (called by SpanHandle)
+     */
+    recordCompletedSpan(span) {
+        this.spans.push(span);
+        // Export span based on configuration
+        switch (this.config.exporter) {
+            case "console":
+                this.exportToConsole(span);
+                break;
+            case "otlp":
+            case "jaeger":
+                this.exportToOTLP(span);
+                break;
+        }
+        // Clear current span if this was the current span
+        if (this.currentSpan?.getSpan() === span) {
+            this.currentSpan = undefined;
+        }
+    }
+    /**
+     * Export span to console
+     */
+    exportToConsole(span) {
+        const duration = span.endTime
+            ? span.endTime - span.startTime
+            : Date.now() - span.startTime;
+        const output = {
+            service: this.config.serviceName,
+            traceId: span.traceId,
+            spanId: span.spanId,
+            parentSpanId: span.parentSpanId,
+            name: span.name,
+            status: span.status,
+            durationMs: duration,
+            attributes: span.attributes,
+            events: span.events,
+            timestamp: new Date(span.startTime).toISOString(),
+        };
+        if (span.status === "error") {
+            console.error("[Tracer]", JSON.stringify(output));
+        }
+        else {
+            console.log("[Tracer]", JSON.stringify(output));
+        }
+    }
+    /**
+     * Export span to OTLP/Jaeger
+     */
+    exportToOTLP(span) {
+        // In a real implementation, this would send to OTLP endpoint
+        if (this.config.endpoint) {
+            this.logger.debug("Exporting span to OTLP", {
+                endpoint: this.config.endpoint,
+                traceId: span.traceId,
+                spanId: span.spanId,
+            });
+        }
+    }
+    async trace(name, optionsOrFn, fn) {
+        const spanOptions = typeof optionsOrFn === "function" ? undefined : optionsOrFn;
+        const handler = typeof optionsOrFn === "function" ? optionsOrFn : fn;
+        const span = this.startSpan(name, spanOptions);
+        try {
+            const result = await handler();
+            span.end();
+            return result;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                span.recordException(error);
+            }
+            span.end();
+            throw error;
+        }
+    }
+    traceSync(name, optionsOrFn, fn) {
+        const spanOptions = typeof optionsOrFn === "function" ? undefined : optionsOrFn;
+        const handler = typeof optionsOrFn === "function" ? optionsOrFn : fn;
+        const span = this.startSpan(name, spanOptions);
+        try {
+            const result = handler();
+            span.end();
+            return result;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                span.recordException(error);
+            }
+            span.end();
+            throw error;
+        }
+    }
+    /**
+     * Record an exception on the current span
+     */
+    recordException(error) {
+        if (this.currentSpan) {
+            this.currentSpan.recordException(error);
+        }
+    }
+    /**
+     * Add an event to the current span
+     */
+    addEvent(name, attributes) {
+        if (this.currentSpan) {
+            this.currentSpan.addEvent(name, attributes);
+        }
+    }
+    /**
+     * Get all recorded spans
+     */
+    getSpans() {
+        return [...this.spans];
+    }
+    /**
+     * Clear all recorded spans
+     */
+    clearSpans() {
+        this.spans.length = 0;
+    }
+    /**
+     * Export all spans
+     */
+    exportSpans() {
+        return [...this.spans];
+    }
+    /**
+     * Create a child tracer
+     */
+    childTracer(additionalConfig) {
+        return new Tracer({
+            ...this.config,
+            ...additionalConfig,
+        });
+    }
+}
+// ─── Factory Function ────────────────────────────────────────────────────────
+/**
+ * Create a tracer with the given configuration
+ */
+export function createTracer(config) {
+    return new Tracer(config);
+}
+//# sourceMappingURL=tracer.js.map

package/packages/observability/dist/tracer.js.map

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

package/packages/observability/dist/types.d.ts

@@ -0,0 +1,329 @@
+/**
+ * Observability Package - Types
+ *
+ * Core types for logging, tracing, metrics, and health monitoring.
+ */
+/**
+ * SDK version for compatibility checks
+ */
+export declare const SDK_VERSION = "1.0.0";
+/**
+ * Log severity levels
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error" | "fatal";
+/**
+ * Log output format
+ */
+export type LogFormat = "json" | "pretty";
+/**
+ * Log output destination
+ */
+export type LogOutput = "stdout" | "stderr" | "file" | "both";
+/**
+ * Log entry structure
+ */
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    correlationId?: string;
+    traceId?: string;
+    spanId?: string;
+    jobId?: string;
+    taskId?: string;
+    component?: string;
+    durationMs?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Logger configuration
+ */
+export interface LoggerConfig {
+    level?: LogLevel;
+    format?: LogFormat;
+    output?: LogOutput;
+    filePath?: string;
+    maxFileSize?: number;
+    maxFiles?: number;
+    correlationIdHeader?: string;
+    defaultMeta?: Record<string, unknown>;
+}
+/**
+ * Span status
+ */
+export type SpanStatus = "ok" | "error";
+/**
+ * Span event
+ */
+export interface SpanEvent {
+    name: string;
+    timestamp: number;
+    attributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Span link
+ */
+export interface SpanLink {
+    traceId: string;
+    spanId: string;
+}
+/**
+ * Span
+ */
+export interface Span {
+    name: string;
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    startTime: number;
+    endTime?: number;
+    status: SpanStatus;
+    attributes: Record<string, string | number | boolean>;
+    events: SpanEvent[];
+    links: SpanLink[];
+}
+/**
+ * Start span options
+ */
+export interface StartSpanOptions {
+    parentSpanId?: string;
+    attributes?: Record<string, string | number | boolean>;
+    links?: SpanLink[];
+}
+/**
+ * Tracer configuration
+ */
+export interface TracerConfig {
+    serviceName: string;
+    exporter: "console" | "otlp" | "jaeger";
+    endpoint?: string;
+    sampleRate: number;
+    logLevel?: LogLevel;
+}
+/**
+ * Metric types
+ */
+export type MetricType = "counter" | "gauge" | "histogram" | "summary";
+/**
+ * Labels for metrics
+ */
+export type Labels = Record<string, string>;
+/**
+ * Counter metric
+ */
+export interface Counter {
+    name: string;
+    help: string;
+    labels: string[];
+    value: Map<string, number>;
+}
+/**
+ * Gauge metric
+ */
+export interface Gauge {
+    name: string;
+    help: string;
+    labels: string[];
+    value: Map<string, number>;
+}
+/**
+ * Histogram bucket
+ */
+export interface HistogramBucket {
+    le: number;
+    count: number;
+}
+/**
+ * Histogram metric
+ */
+export interface Histogram {
+    name: string;
+    help: string;
+    labels: string[];
+    buckets: HistogramBucket[];
+    sum: Map<string, number>;
+    count: Map<string, number>;
+}
+/**
+ * Quantile for summary
+ */
+export interface SummaryQuantile {
+    quantile: number;
+    value: number;
+}
+/**
+ * Summary metric
+ */
+export interface Summary {
+    name: string;
+    help: string;
+    labels: string[];
+    quantiles: SummaryQuantile[];
+    sum: Map<string, number>;
+    count: Map<string, number>;
+}
+/**
+ * Metrics configuration
+ */
+export interface MetricsConfig {
+    serviceName?: string;
+    defaultLabels?: Labels;
+    exportInterval?: number;
+    prefix?: string;
+}
+/**
+ * Prometheus format metric output
+ */
+export interface PrometheusMetric {
+    name: string;
+    help: string;
+    type: MetricType;
+    values: Array<{
+        labels: Labels;
+        value: number;
+    }>;
+}
+/**
+ * Health check result
+ */
+export interface HealthResult {
+    status: "healthy" | "degraded" | "unhealthy";
+    message?: string;
+    details?: Record<string, unknown>;
+    timestamp: string;
+}
+/**
+ * Health check function
+ */
+export type HealthCheck = () => Promise<HealthResult>;
+/**
+ * Health check registration
+ */
+export interface HealthCheckRegistration {
+    name: string;
+    check: HealthCheck;
+    critical: boolean;
+}
+/**
+ * Health report
+ */
+export interface HealthReport {
+    overall: "healthy" | "degraded" | "unhealthy";
+    version: string;
+    uptime: number;
+    checks: Record<string, HealthResult>;
+    timestamp: string;
+}
+/**
+ * Alert condition types
+ */
+export type AlertConditionType = "threshold" | "rate" | "error_rate";
+/**
+ * Threshold condition
+ */
+export interface ThresholdCondition {
+    type: "threshold";
+    metric: string;
+    operator: ">" | "<" | ">=" | "<=" | "==";
+    value: number;
+}
+/**
+ * Rate condition
+ */
+export interface RateCondition {
+    type: "rate";
+    metric: string;
+    window: number;
+    threshold: number;
+}
+/**
+ * Error rate condition
+ */
+export interface ErrorRateCondition {
+    type: "error_rate";
+    component: string;
+    threshold: number;
+}
+/**
+ * Alert condition
+ */
+export type AlertCondition = ThresholdCondition | RateCondition | ErrorRateCondition;
+/**
+ * Alert severity
+ */
+export type AlertSeverity = "info" | "warning" | "critical";
+/**
+ * Alert action types
+ */
+export type AlertActionType = "log" | "notify" | "webhook" | "execute";
+/**
+ * Log action
+ */
+export interface LogAction {
+    type: "log";
+    level: LogLevel;
+}
+/**
+ * Notify action
+ */
+export interface NotifyAction {
+    type: "notify";
+    channel: string;
+    message: string;
+}
+/**
+ * Webhook action
+ */
+export interface WebhookAction {
+    type: "webhook";
+    url: string;
+    method?: "GET" | "POST";
+    headers?: Record<string, string>;
+}
+/**
+ * Execute action
+ */
+export interface ExecuteAction {
+    type: "execute";
+    command: string;
+}
+/**
+ * Alert action
+ */
+export type AlertAction = LogAction | NotifyAction | WebhookAction | ExecuteAction;
+/**
+ * Alert rule
+ */
+export interface AlertRule {
+    name: string;
+    condition: AlertCondition;
+    severity: AlertSeverity;
+    cooldown: number;
+    actions: AlertAction[];
+    enabled?: boolean;
+}
+/**
+ * Alert
+ */
+export interface Alert {
+    ruleName: string;
+    severity: AlertSeverity;
+    message: string;
+    triggeredAt: string;
+    resolvedAt?: string;
+    fired: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Exporter types
+ */
+export type ExporterType = "prometheus" | "otlp" | "json";
+/**
+ * Export result
+ */
+export interface ExportResult {
+    format: ExporterType;
+    content: string;
+    timestamp: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/observability/dist/types.d.ts.map

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

package/packages/observability/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * Observability Package - Types
+ *
+ * Core types for logging, tracing, metrics, and health monitoring.
+ */
+// ─── SDK Version ────────────────────────────────────────────────────────────
+/**
+ * SDK version for compatibility checks
+ */
+export const SDK_VERSION = "1.0.0";
+//# sourceMappingURL=types.js.map

package/packages/observability/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/packages/observability/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@pi/observability",
+  "version": "0.6.3-beta.13",
+  "description": "Comprehensive observability system with structured logging, tracing, metrics, and alerting",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "observability",
+    "logging",
+    "tracing",
+    "metrics",
+    "health"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  }
+}