pi-harness-runtime 0.10.7 → 0.10.12

package/packages/notification/types.ts

@@ -1,89 +0,0 @@
-/**
- * Notification Center Types — RFC-0022
- *
- * Type definitions for notification events, channels, and payloads.
- */
-
-export type NotificationEvent =
-	| "JobStarted"
-	| "TaskCompleted"
-	| "TaskFailed"
-	| "QuotaPaused"
-	| "ResumeScheduled"
-	| "ContextCompacted"
-	| "OutputLimitContinued"
-	| "E2EFailed"
-	| "HumanReviewNeeded"
-	| "ReadyForClient"
-	| "JobCancelled"
-	| "Error";
-
-export interface NotificationPayload {
-	event: NotificationEvent;
-	jobId: string;
-	timestamp: string;
-	title: string;
-	message: string;
-	details?: Record<string, unknown>;
-	// Redacted fields for security
-	redacted?: string[];
-}
-
-export interface NotificationConfig {
-	channels: NotificationChannelConfig[];
-	// Global settings
-	enabled?: boolean;
-	redactPatterns?: RegExp[];
-}
-
-export interface NotificationChannelConfig {
-	id: string;
-	type: NotificationChannelType;
-	enabled: boolean;
-	config: TelegramConfig | NtfyConfig | EmailConfig | WebhookConfig;
-}
-
-export type NotificationChannelType = "telegram" | "ntfy" | "email" | "webhook";
-
-export interface TelegramConfig {
-	botToken: string;
-	chatId: string;
-	parseMode?: "MarkdownV2" | "HTML" | "Markdown";
-}
-
-export interface NtfyConfig {
-	server: string; // e.g., "https://ntfy.sh"
-	topic: string;
-	authToken?: string;
-}
-
-export interface EmailConfig {
-	smtpHost: string;
-	smtpPort: number;
-	smtpUser: string;
-	smtpPassword: string;
-	from: string;
-	to: string[];
-	tls?: boolean;
-}
-
-export interface WebhookConfig {
-	url: string;
-	method?: "POST" | "PUT";
-	headers?: Record<string, string>;
-	authToken?: string;
-}
-
-export interface NotificationResult {
-	success: boolean;
-	channel: string;
-	error?: string;
-}
-
-export interface NotificationContext {
-	jobId: string;
-	requirement: string;
-	taskId?: string;
-	taskTitle?: string;
-	error?: string;
-}

package/packages/observability/README.md

@@ -1,241 +0,0 @@
-# @pi/observability
-
-Comprehensive observability system with structured logging, distributed tracing, metrics collection, health monitoring, and alerting.
-
-## Features
-
-- **Structured Logging** - JSON and pretty-printed logs with correlation IDs
-- **Distributed Tracing** - OpenTelemetry-compatible tracing with spans and events
-- **Metrics Collection** - Prometheus-compatible metrics (counters, gauges, histograms)
-- **Health Monitoring** - Liveness and readiness probes for Kubernetes
-- **Alerting Engine** - Rule-based alerts with multiple action types
-
-## Installation
-
-```bash
-npm install @pi/observability
-```
-
-## Quick Start
-
-### Structured Logging
-
-```typescript
-import { createLogger } from "@pi/observability";
-
-const logger = createLogger({
-  level: "info",
-  format: "json",
-  output: "stdout"
-});
-
-// Basic logging
-logger.info("Application started");
-logger.error("Request failed", { requestId: "123" });
-
-// With correlation
-const jobLogger = logger.withJob("job-123");
-jobLogger.info("Processing task");
-```
-
-### Distributed Tracing
-
-```typescript
-import { createTracer } from "@pi/observability";
-
-const tracer = createTracer({
-  serviceName: "my-service",
-  exporter: "console",
-  sampleRate: 1.0
-});
-
-// Trace a function
-const result = await tracer.trace("processOrder", async (span) => {
-  span.setAttribute("orderId", order.id);
-  
-  await tracer.trace("validateOrder", async () => {
-    // validation logic
-  });
-  
-  return result;
-});
-```
-
-### Metrics
-
-```typescript
-import { createMetrics, createBuiltInMetrics } from "@pi/observability";
-
-const metrics = createMetrics({ serviceName: "my-service" });
-createBuiltInMetrics(metrics);
-
-// Counter
-metrics.incrementCounter("requests_total", { endpoint: "/api" });
-
-// Gauge
-metrics.setGauge("active_connections", 42);
-
-// Histogram
-metrics.observeHistogram("request_duration_seconds", 0.125, { method: "GET" });
-
-// Export metrics
-const prometheusOutput = metrics.exportPrometheus();
-```
-
-### Health Checks
-
-```typescript
-import { createHealthMonitor, createMemoryHealthCheck } from "@pi/observability";
-
-const health = createHealthMonitor("my-service", "1.0.0");
-
-// Register checks
-health.registerHealthCheck("memory", createMemoryHealthCheck("memory", 90));
-
-// Kubernetes probes
-app.get("/health/liveness", async (req, res) => {
-  const result = await health.checkLiveness();
-  res.status(result.status === "healthy" ? 200 : 503).json(result);
-});
-
-app.get("/health/readiness", async (req, res) => {
-  const result = await health.checkReadiness();
-  res.status(result.status === "healthy" ? 200 : 503).json(result);
-});
-```
-
-### Alerting
-
-```typescript
-import { createAlertEngine } from "@pi/observability";
-
-const alertEngine = createAlertEngine();
-
-alertEngine.registerRule({
-  name: "high_error_rate",
-  condition: {
-    type: "threshold",
-    metric: "error_rate",
-    operator: ">",
-    value: 0.05
-  },
-  severity: "critical",
-  cooldown: 300000, // 5 minutes
-  actions: [
-    { type: "log", level: "error" },
-    { type: "notify", channel: "slack", message: "High error rate detected" }
-  ]
-});
-
-// Evaluate alerts
-const alerts = await alertEngine.evaluate(metrics);
-```
-
-## API Reference
-
-### Logger
-
-```typescript
-const logger = createLogger({
-  level: "debug" | "info" | "warn" | "error" | "fatal",
-  format: "json" | "pretty",
-  output: "stdout" | "stderr" | "file",
-  filePath?: string,
-  defaultMeta?: Record<string, unknown>
-});
-
-logger.debug(message, meta?);
-logger.info(message, meta?);
-logger.warn(message, meta?);
-logger.error(message, error?, meta?);
-logger.fatal(message, error?, meta?);
-
-logger.child(defaults);  // Create child logger
-logger.withJob(jobId);   // Attach job ID
-logger.withTask(taskId); // Attach task ID
-logger.withCorrelationId(id); // Set correlation ID
-```
-
-### Tracer
-
-```typescript
-const tracer = createTracer({
-  serviceName: string,
-  exporter: "console" | "otlp" | "jaeger",
-  endpoint?: string,
-  sampleRate?: number
-});
-
-tracer.startSpan(name, options?);
-tracer.trace(name, fn);
-tracer.trace(name, options, fn);
-tracer.traceSync(name, fn);
-```
-
-### Metrics
-
-```typescript
-const metrics = createMetrics({
-  serviceName: string,
-  prefix?: string,
-  defaultLabels?: Labels
-});
-
-metrics.registerCounter(name, help, labels?);
-metrics.incrementCounter(name, labels?);
-metrics.registerGauge(name, help, labels?);
-metrics.setGauge(name, value, labels?);
-metrics.registerHistogram(name, help, buckets?, labels?);
-metrics.observeHistogram(name, value, labels?);
-
-metrics.asyncTimer(name, fn, labels?);
-metrics.timer(name, fn, labels?);
-
-metrics.exportPrometheus();
-metrics.exportJSON();
-```
-
-### Health Monitor
-
-```typescript
-const health = createHealthMonitor(serviceName, version);
-
-health.registerHealthCheck(name, check, critical?);
-health.checkHealth(name);
-health.checkHealthAll();
-health.checkLiveness();
-health.checkReadiness();
-```
-
-### Alert Engine
-
-```typescript
-const alertEngine = createAlertEngine(logger?);
-
-alertEngine.registerRule(rule);
-alertEngine.unregisterRule(name);
-alertEngine.evaluate(metrics);
-alertEngine.getActiveAlerts();
-alertEngine.getAlertHistory(limit?);
-```
-
-## Metrics Format
-
-Prometheus format example:
-
-```
-# HELP my_service_requests_total Total requests
-# TYPE my_service_requests_total counter
-my_service_requests_total{endpoint="/api"} 1234
-
-# HELP my_service_request_duration_seconds Request duration
-# TYPE my_service_request_duration_seconds histogram
-my_service_request_duration_seconds_bucket{le="0.1"} 1000
-my_service_request_duration_seconds_bucket{le="0.5"} 1200
-my_service_request_duration_seconds_sum 150.5
-my_service_request_duration_seconds_count 1234
-```
-
-## License
-
-MIT

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

@@ -1,99 +0,0 @@
-/**
- * Observability Package - Alert Engine
- *
- * Alert rule evaluation and alerting.
- */
-import type { Alert, AlertRule } from "./types.js";
-import { Logger } from "./logger.js";
-export declare class AlertEngine {
-    private readonly rules;
-    private readonly activeAlerts;
-    private readonly alertHistory;
-    private readonly logger;
-    constructor(logger?: Logger, _maxHistory?: number);
-    /**
-     * Register an alert rule
-     */
-    registerRule(rule: AlertRule): void;
-    /**
-     * Unregister an alert rule
-     */
-    unregisterRule(name: string): void;
-    /**
-     * Get a rule by name
-     */
-    getRule(name: string): AlertRule | undefined;
-    /**
-     * Enable or disable a rule
-     */
-    setRuleEnabled(name: string, enabled: boolean): void;
-    /**
-     * Evaluate all rules
-     */
-    evaluate(metrics: Record<string, number>): Promise<Alert[]>;
-    /**
-     * Evaluate a single condition
-     */
-    private evaluateCondition;
-    /**
-     * Create an alert from a rule
-     */
-    private createAlert;
-    /**
-     * Format alert message
-     */
-    private formatAlertMessage;
-    /**
-     * Trigger alert actions
-     */
-    private triggerActions;
-    /**
-     * Execute a single action
-     */
-    private executeAction;
-    /**
-     * Log an alert
-     */
-    private logAlert;
-    /**
-     * Send a notification
-     */
-    private sendNotification;
-    /**
-     * Send a webhook
-     */
-    private sendWebhook;
-    /**
-     * Execute a command
-     */
-    private executeCommand;
-    /**
-     * Get active alerts
-     */
-    getActiveAlerts(): Alert[];
-    /**
-     * Get alert history
-     */
-    getAlertHistory(limit?: number): Alert[];
-    /**
-     * Clear alert history
-     */
-    clearHistory(): void;
-    /**
-     * List all rules
-     */
-    listRules(): AlertRule[];
-    /**
-     * Get rule count
-     */
-    getRuleCount(): {
-        total: number;
-        enabled: number;
-        disabled: number;
-    };
-}
-/**
- * Create an alert engine
- */
-export declare function createAlertEngine(logger?: Logger): AlertEngine;
-//# sourceMappingURL=alerts.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../src/alerts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAA+B,SAAS,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,YAAY,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,SAAO,EAE9C;IAED;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAGlC;IAED;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGjC;IAED;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE3C;IAED;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAKnD;IAED;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAsChE;IAED;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2CzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;YACW,cAAc;IAS5B;;OAEG;YACW,aAAa;IAuB3B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAwBhB;;OAEG;YACW,gBAAgB;IAW9B;;OAEG;YACW,WAAW;IA4BzB;;OAEG;YACW,cAAc;IAO5B;;OAEG;IACH,eAAe,IAAI,KAAK,EAAE,CAEzB;IAED;;OAEG;IACH,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAMvC;IAED;;OAEG;IACH,YAAY,IAAI,IAAI,CAEnB;IAED;;OAEG;IACH,SAAS,IAAI,SAAS,EAAE,CAEvB;IAED;;OAEG;IACH,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAiBnE;CACD;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAE9D"}