pi-harness-runtime 0.9.22 → 0.10.0

package/packages/observability/dist/metrics.js

@@ -3,14 +3,14 @@
  *
  * Metrics collection with Prometheus-compatible format.
  */
-// ─── Default Configuration ─────────────────────────────────────────────────
+// --- Default Configuration -------------------------------------------------
 const DEFAULT_CONFIG = {
     serviceName: "unknown",
     defaultLabels: {},
     exportInterval: 60000,
     prefix: "",
 };
-// ─── Timer Helper ─────────────────────────────────────────────────────────
+// --- Timer Helper ---------------------------------------------------------
 export class Timer {
     startTime;
     constructor() {
@@ -29,7 +29,7 @@ export class Timer {
         this.startTime = Date.now();
     }
 }
-// ─── Metrics Collector ────────────────────────────────────────────────────
+// --- Metrics Collector ----------------------------------------------------
 export class Metrics {
     config;
     counters = new Map();
@@ -64,7 +64,7 @@ export class Metrics {
     defaultBuckets() {
         return [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
     }
-    // ─── Counter Methods ──────────────────────────────────────────────────
+    // --- Counter Methods --------------------------------------------------
     /**
      * Register a counter metric
      */
@@ -104,7 +104,7 @@ export class Metrics {
         const key = this.labelKey(labels);
         return this.counters.get(fullName)?.get(key) ?? 0;
     }
-    // ─── Gauge Methods ──────────────────────────────────────────────────
+    // --- Gauge Methods --------------------------------------------------
     /**
      * Register a gauge metric
      */
@@ -147,7 +147,7 @@ export class Metrics {
         const gauge = this.gauges.get(fullName);
         gauge.set(key, (gauge.get(key) ?? 0) - 1);
     }
-    // ─── Histogram Methods ───────────────────────────────────────────────
+    // --- Histogram Methods -----------------------------------------------
     /**
      * Register a histogram metric
      */
@@ -192,7 +192,7 @@ export class Metrics {
             }
         }
     }
-    // ─── Summary Methods ─────────────────────────────────────────────────
+    // --- Summary Methods -------------------------------------------------
     /**
      * Register a summary metric
      */
@@ -215,7 +215,7 @@ export class Metrics {
             count: current.count + 1,
         });
     }
-    // ─── Timing Helpers ─────────────────────────────────────────────────
+    // --- Timing Helpers -------------------------------------------------
     /**
      * Start a timer
      */
@@ -255,7 +255,7 @@ export class Metrics {
             this.observeDuration(name, timer, labels);
         }
     }
-    // ─── Export Methods ──────────────────────────────────────────────────
+    // --- Export Methods --------------------------------------------------
     /**
      * Export metrics in Prometheus format
      */
@@ -340,7 +340,7 @@ export class Metrics {
         this.summaries.clear();
     }
 }
-// ─── Built-in Metrics ────────────────────────────────────────────────────────
+// --- Built-in Metrics --------------------------------------------------------
 /**
  * Create built-in runtime metrics
  */
@@ -363,7 +363,7 @@ export function createBuiltInMetrics(metrics) {
     metrics.registerGauge("harness_sessions_active", "Active sessions");
     metrics.registerCounter("harness_sessions_tokens_total", "Total session tokens");
 }
-// ─── Factory Function ────────────────────────────────────────────────────────
+// --- Factory Function --------------------------------------------------------
 /**
  * Create a metrics collector with the given configuration
  */

package/packages/observability/dist/tracer.js

@@ -5,7 +5,7 @@
  */
 import { randomUUID } from "node:crypto";
 import { Logger } from "./logger.js";
-// ─── Span Handle ─────────────────────────────────────────────────────────────
+// --- Span Handle -------------------------------------------------------------
 export class SpanHandle {
     tracer;
     span;
@@ -65,7 +65,7 @@ export class SpanHandle {
         return this.span;
     }
 }
-// ─── Tracer Class ────────────────────────────────────────────────────────────
+// --- Tracer Class ------------------------------------------------------------
 export class Tracer {
     config;
     logger;
@@ -251,7 +251,7 @@ export class Tracer {
         });
     }
 }
-// ─── Factory Function ────────────────────────────────────────────────────────
+// --- Factory Function --------------------------------------------------------
 /**
  * Create a tracer with the given configuration
  */

package/packages/observability/dist/types.js

@@ -3,7 +3,7 @@
  *
  * Core types for logging, tracing, metrics, and health monitoring.
  */
-// ─── SDK Version ────────────────────────────────────────────────────────────
+// --- SDK Version ------------------------------------------------------------
 /**
  * SDK version for compatibility checks
  */

package/packages/observability/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/observability",
-  "version": "0.9.15",
+  "version": "0.9.25",
   "description": "Comprehensive observability system with structured logging, tracing, metrics, and alerting",
   "type": "module",
   "main": "./dist/index.js",

package/packages/observability/src/alerts.ts

@@ -7,7 +7,7 @@
 import type { Alert, AlertAction, AlertCondition, AlertRule } from "./types.js";
 import { Logger } from "./logger.js";
 
-// ─── Alert Engine Class ─────────────────────────────────────────────────
+// --- Alert Engine Class -------------------------------------------------
 
 export class AlertEngine {
 	private readonly rules: Map<string, AlertRule> = new Map();
@@ -345,7 +345,7 @@ export class AlertEngine {
 	}
 }
 
-// ─── Factory Function ────────────────────────────────────────────────────────
+// --- Factory Function --------------------------------------------------------
 
 /**
  * Create an alert engine

package/packages/observability/src/health.ts

@@ -11,12 +11,12 @@ import type {
 	HealthResult,
 } from "./types.js";
 
-// ─── Default Configuration ─────────────────────────────────────────────────
+// --- Default Configuration -------------------------------------------------
 
 const DEFAULT_SERVICE_NAME = "harness-runtime";
 const DEFAULT_VERSION = "1.0.0";
 
-// ─── Health Monitor Class ─────────────────────────────────────────────────
+// --- Health Monitor Class -------------------------------------------------
 
 export class HealthMonitor {
 	private readonly checks: Map<string, HealthCheckRegistration> = new Map();
@@ -203,7 +203,7 @@ export class HealthMonitor {
 	}
 }
 
-// ─── Built-in Health Checks ────────────────────────────────────────────────
+// --- Built-in Health Checks ------------------------------------------------
 
 /**
  * Create a basic connectivity health check
@@ -312,7 +312,7 @@ export function createDiskSpaceHealthCheck(
 	};
 }
 
-// ─── Factory Function ────────────────────────────────────────────────────────
+// --- Factory Function --------------------------------------------------------
 
 /**
  * Create a health monitor with the given service name

package/packages/observability/src/index.ts

@@ -5,7 +5,7 @@
  * distributed tracing, metrics collection, health monitoring, and alerting.
  */
 
-// ─── Logger ────────────────────────────────────────────────────────────────
+// --- Logger ----------------------------------------------------------------
 
 export { Logger, createLogger, defaultLogger } from "./logger.js";
 export type {
@@ -16,7 +16,7 @@ export type {
 	LogOutput,
 } from "./types.js";
 
-// ─── Tracer ────────────────────────────────────────────────────────────────
+// --- Tracer ----------------------------------------------------------------
 
 export { Tracer, createTracer, SpanHandle } from "./tracer.js";
 export type {
@@ -28,7 +28,7 @@ export type {
 	TracerConfig,
 } from "./types.js";
 
-// ─── Metrics ────────────────────────────────────────────────────────────────
+// --- Metrics ----------------------------------------------------------------
 
 export {
 	Metrics,
@@ -47,7 +47,7 @@ export type {
 	Summary,
 } from "./types.js";
 
-// ─── Health ────────────────────────────────────────────────────────────────
+// --- Health ----------------------------------------------------------------
 
 export {
 	HealthMonitor,
@@ -63,7 +63,7 @@ export type {
 	HealthResult,
 } from "./types.js";
 
-// ─── Alerts ────────────────────────────────────────────────────────────────
+// --- Alerts ----------------------------------------------------------------
 
 export { AlertEngine, createAlertEngine } from "./alerts.js";
 export type {
@@ -74,6 +74,6 @@ export type {
 	AlertSeverity,
 } from "./types.js";
 
-// ─── Re-exports ────────────────────────────────────────────────────────────
+// --- Re-exports ------------------------------------------------------------
 
 export { SDK_VERSION } from "./types.js";

package/packages/observability/src/logger.ts

@@ -10,7 +10,7 @@ import { dirname } from "node:path";
 import type { Writable } from "node:stream";
 import type { LogEntry, LogLevel, LoggerConfig } from "./types.js";
 
-// ─── Level Order ────────────────────────────────────────────────────────────
+// --- Level Order ------------------------------------------------------------
 
 const LOG_LEVEL_ORDER: Record<LogLevel, number> = {
 	debug: 0,
@@ -20,7 +20,7 @@ const LOG_LEVEL_ORDER: Record<LogLevel, number> = {
 	fatal: 4,
 };
 
-// ─── Default Configuration ─────────────────────────────────────────────────
+// --- Default Configuration -------------------------------------------------
 
 const DEFAULT_CONFIG: Required<LoggerConfig> = {
 	level: "info",
@@ -33,7 +33,7 @@ const DEFAULT_CONFIG: Required<LoggerConfig> = {
 	defaultMeta: {},
 };
 
-// ─── Colors for Pretty Output ───────────────────────────────────────────────
+// --- Colors for Pretty Output -----------------------------------------------
 
 const COLORS: Record<LogLevel, string> = {
 	debug: "\x1b[36m", // Cyan
@@ -45,7 +45,7 @@ const COLORS: Record<LogLevel, string> = {
 
 const RESET = "\x1b[0m";
 
-// ─── UUID Generator ─────────────────────────────────────────────────────────
+// --- UUID Generator ---------------------------------------------------------
 
 function generateId(): string {
 	return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
@@ -55,7 +55,7 @@ function generateId(): string {
 	});
 }
 
-// ─── Logger Class ───────────────────────────────────────────────────────────
+// --- Logger Class -----------------------------------------------------------
 
 export class Logger {
 	private readonly config: Required<LoggerConfig>;
@@ -356,7 +356,7 @@ export class Logger {
 	}
 }
 
-// ─── Factory Function ────────────────────────────────────────────────────────
+// --- Factory Function --------------------------------------------------------
 
 /**
  * Create a logger with the given configuration
@@ -365,7 +365,7 @@ export function createLogger(config?: LoggerConfig): Logger {
 	return new Logger(config);
 }
 
-// ─── Default Logger ──────────────────────────────────────────────────────────
+// --- Default Logger ----------------------------------------------------------
 
 /**
  * Default logger instance

package/packages/observability/src/metrics.ts

@@ -6,7 +6,7 @@
 
 import type { HistogramBucket, Labels, MetricsConfig } from "./types.js";
 
-// ─── Default Configuration ─────────────────────────────────────────────────
+// --- Default Configuration -------------------------------------------------
 
 const DEFAULT_CONFIG: Required<MetricsConfig> = {
 	serviceName: "unknown",
@@ -15,7 +15,7 @@ const DEFAULT_CONFIG: Required<MetricsConfig> = {
 	prefix: "",
 };
 
-// ─── Timer Helper ─────────────────────────────────────────────────────────
+// --- Timer Helper ---------------------------------------------------------
 
 export class Timer {
 	private startTime: number;
@@ -39,7 +39,7 @@ export class Timer {
 	}
 }
 
-// ─── Metrics Collector ────────────────────────────────────────────────────
+// --- Metrics Collector ----------------------------------------------------
 
 export class Metrics {
 	private readonly config: Required<MetricsConfig>;
@@ -84,7 +84,7 @@ export class Metrics {
 		return [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
 	}
 
-	// ─── Counter Methods ──────────────────────────────────────────────────
+	// --- Counter Methods --------------------------------------------------
 
 	/**
 	 * Register a counter metric
@@ -133,7 +133,7 @@ export class Metrics {
 		return this.counters.get(fullName)?.get(key) ?? 0;
 	}
 
-	// ─── Gauge Methods ──────────────────────────────────────────────────
+	// --- Gauge Methods --------------------------------------------------
 
 	/**
 	 * Register a gauge metric
@@ -187,7 +187,7 @@ export class Metrics {
 		gauge.set(key, (gauge.get(key) ?? 0) - 1);
 	}
 
-	// ─── Histogram Methods ───────────────────────────────────────────────
+	// --- Histogram Methods -----------------------------------------------
 
 	/**
 	 * Register a histogram metric
@@ -245,7 +245,7 @@ export class Metrics {
 		}
 	}
 
-	// ─── Summary Methods ─────────────────────────────────────────────────
+	// --- Summary Methods -------------------------------------------------
 
 	/**
 	 * Register a summary metric
@@ -273,7 +273,7 @@ export class Metrics {
 		});
 	}
 
-	// ─── Timing Helpers ─────────────────────────────────────────────────
+	// --- Timing Helpers -------------------------------------------------
 
 	/**
 	 * Start a timer
@@ -320,7 +320,7 @@ export class Metrics {
 		}
 	}
 
-	// ─── Export Methods ──────────────────────────────────────────────────
+	// --- Export Methods --------------------------------------------------
 
 	/**
 	 * Export metrics in Prometheus format
@@ -423,7 +423,7 @@ export class Metrics {
 	}
 }
 
-// ─── Built-in Metrics ────────────────────────────────────────────────────────
+// --- Built-in Metrics --------------------------------------------------------
 
 /**
  * Create built-in runtime metrics
@@ -465,7 +465,7 @@ export function createBuiltInMetrics(metrics: Metrics): void {
 	);
 }
 
-// ─── Factory Function ────────────────────────────────────────────────────────
+// --- Factory Function --------------------------------------------------------
 
 /**
  * Create a metrics collector with the given configuration

package/packages/observability/src/tracer.ts

@@ -14,7 +14,7 @@ import type {
 } from "./types.js";
 import { Logger } from "./logger.js";
 
-// ─── Span Handle ─────────────────────────────────────────────────────────────
+// --- Span Handle -------------------------------------------------------------
 
 export class SpanHandle {
 	private readonly tracer: Tracer;
@@ -85,7 +85,7 @@ export class SpanHandle {
 	}
 }
 
-// ─── Tracer Class ────────────────────────────────────────────────────────────
+// --- Tracer Class ------------------------------------------------------------
 
 export class Tracer {
 	private readonly config: TracerConfig;
@@ -326,7 +326,7 @@ export class Tracer {
 	}
 }
 
-// ─── Factory Function ────────────────────────────────────────────────────────
+// --- Factory Function --------------------------------------------------------
 
 /**
  * Create a tracer with the given configuration

package/packages/observability/src/types.ts

@@ -4,14 +4,14 @@
  * Core types for logging, tracing, metrics, and health monitoring.
  */
 
-// ─── SDK Version ────────────────────────────────────────────────────────────
+// --- SDK Version ------------------------------------------------------------
 
 /**
  * SDK version for compatibility checks
  */
 export const SDK_VERSION = "1.0.0";
 
-// ─── Log Types ───────────────────────────────────────────────────────────────
+// --- Log Types ---------------------------------------------------------------
 
 /**
  * Log severity levels
@@ -59,7 +59,7 @@ export interface LoggerConfig {
 	defaultMeta?: Record<string, unknown>;
 }
 
-// ─── Trace Types ────────────────────────────────────────────────────────────
+// --- Trace Types ------------------------------------------------------------
 
 /**
  * Span status
@@ -119,7 +119,7 @@ export interface TracerConfig {
 	logLevel?: LogLevel;
 }
 
-// ─── Metrics Types ──────────────────────────────────────────────────────────
+// --- Metrics Types ----------------------------------------------------------
 
 /**
  * Metric types
@@ -214,7 +214,7 @@ export interface PrometheusMetric {
 	}>;
 }
 
-// ─── Health Types ───────────────────────────────────────────────────────────
+// --- Health Types -----------------------------------------------------------
 
 /**
  * Health check result
@@ -251,7 +251,7 @@ export interface HealthReport {
 	timestamp: string;
 }
 
-// ─── Alert Types ────────────────────────────────────────────────────────────
+// --- Alert Types ------------------------------------------------------------
 
 /**
  * Alert condition types
@@ -374,7 +374,7 @@ export interface Alert {
 	metadata?: Record<string, unknown>;
 }
 
-// ─── Export Types ───────────────────────────────────────────────────────────
+// --- Export Types -----------------------------------------------------------
 
 /**
  * Exporter types

package/packages/observability/test/observability.test.ts

@@ -9,14 +9,14 @@ import { mkdtemp, rm } from "node:fs/promises";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 
-// ─── Module Imports ───────────────────────────────────────────────────────────
+// --- Module Imports -----------------------------------------------------------
 
 import { Logger, createLogger, defaultLogger } from "../src/logger.js";
 import { type Metrics, createMetrics } from "../src/metrics.js";
 import { HealthMonitor, createHealthMonitor } from "../src/health.js";
 import { type AlertEngine, createAlertEngine } from "../src/alerts.js";
 
-// ─── Shared Test State ────────────────────────────────────────────────────────
+// --- Shared Test State --------------------------------------------------------
 
 interface CaptureStdout {
 	stdout: string[];
@@ -25,7 +25,7 @@ interface CaptureStdout {
 
 let tempDir: string;
 
-// ─── Logger Test Helpers ─────────────────────────────────────────────────────
+// --- Logger Test Helpers -----------------------------------------------------
 
 /**
  * Create a logger that captures stdout/stderr output
@@ -70,7 +70,7 @@ async function captureLoggerOutput(
 	return capture;
 }
 
-// ─── Setup / Teardown ────────────────────────────────────────────────────────
+// --- Setup / Teardown --------------------------------------------------------
 
 beforeEach(async () => {
 	tempDir = await mkdtemp(join(tmpdir(), "obs-test-"));