@oddessentials/odd-ai-reviewers 1.0.0

package/dist/telemetry/backends/jsonl.js

@@ -0,0 +1,121 @@
+/**
+ * JSONL File Telemetry Backend
+ *
+ * Feature: 007-pnpm-timeout-telemetry
+ * Implements: FR-011, FR-014a
+ *
+ * Appends JSON objects to a file in JSONL format (one JSON object per line).
+ * Uses append-mode writes for durability without explicit flush.
+ */
+import { appendFile } from 'node:fs/promises';
+/**
+ * Formats a timeout event for JSONL output based on verbosity level.
+ */
+function formatEvent(event, verbosity) {
+    switch (verbosity) {
+        case 'minimal':
+            return JSON.stringify({
+                operation_id: event.operation_id,
+                duration_ms: event.duration_ms,
+                severity: event.severity,
+            });
+        case 'standard':
+            return JSON.stringify({
+                operation_id: event.operation_id,
+                duration_ms: event.duration_ms,
+                threshold_ms: event.threshold_ms,
+                timestamp: event.timestamp,
+                severity: event.severity,
+            });
+        case 'verbose':
+            return JSON.stringify(event);
+    }
+}
+/**
+ * Creates a JSONL file telemetry backend.
+ *
+ * @param options - Configuration options
+ * @returns TelemetryBackend implementation
+ */
+export function createJsonlBackend(options) {
+    const { filePath, verbosity, bufferSize = 100, flushIntervalMs = 5000 } = options;
+    const buffer = [];
+    let flushTimer = null;
+    let hasLoggedError = false;
+    let closed = false;
+    /**
+     * Writes buffered events to file.
+     * @param force - If true, write even if closed (used during shutdown)
+     */
+    async function writeBuffer(force = false) {
+        if (buffer.length === 0)
+            return;
+        if (closed && !force)
+            return;
+        const lines = buffer.splice(0).join('\n') + '\n';
+        try {
+            // Use append mode for durability
+            await appendFile(filePath, lines, { encoding: 'utf8' });
+        }
+        catch (error) {
+            // Log error once per run (FR-014)
+            if (!hasLoggedError) {
+                hasLoggedError = true;
+                console.error(`[TELEMETRY] JSONL write error: ${error}`);
+            }
+        }
+    }
+    /**
+     * Starts periodic flush timer.
+     */
+    function startFlushTimer() {
+        if (flushTimer === null && flushIntervalMs > 0) {
+            flushTimer = setInterval(() => {
+                writeBuffer().catch(() => {
+                    // Swallow errors in timer callback
+                });
+            }, flushIntervalMs);
+            // Unref timer so it doesn't keep the process alive
+            flushTimer.unref();
+        }
+    }
+    /**
+     * Stops periodic flush timer.
+     */
+    function stopFlushTimer() {
+        if (flushTimer !== null) {
+            clearInterval(flushTimer);
+            flushTimer = null;
+        }
+    }
+    return {
+        async emit(event) {
+            if (closed)
+                return;
+            try {
+                const line = formatEvent(event, verbosity);
+                buffer.push(line);
+                // Start timer on first event
+                startFlushTimer();
+                // Auto-flush if buffer is full
+                if (buffer.length >= bufferSize) {
+                    await writeBuffer();
+                }
+            }
+            catch {
+                // Best-effort: swallow errors to avoid affecting control flow (FR-014)
+            }
+        },
+        async flush() {
+            await writeBuffer();
+        },
+        async close() {
+            if (closed)
+                return;
+            closed = true;
+            stopFlushTimer();
+            await writeBuffer(true); // Force write remaining buffer
+        },
+    };
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/telemetry/backends/jsonl.js.map

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

package/dist/telemetry/emitter.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Telemetry Emitter
+ *
+ * Feature: 007-pnpm-timeout-telemetry
+ * Implements: FR-014
+ *
+ * Low-overhead event emission with failure logging (once per run).
+ */
+import type { TelemetryBackend, TimeoutEvent } from './types.js';
+/**
+ * Emitter that dispatches events to multiple backends.
+ * Implements best-effort semantics with failure logging.
+ */
+export declare class TelemetryEmitter {
+    private backends;
+    private hasLoggedEmitError;
+    /**
+     * Registers a backend for event dispatch.
+     */
+    addBackend(backend: TelemetryBackend): void;
+    /**
+     * Removes all registered backends.
+     */
+    clearBackends(): void;
+    /**
+     * Emits an event to all registered backends.
+     * Best-effort: failures are logged once per run (FR-014).
+     */
+    emit(event: TimeoutEvent): Promise<void>;
+    /**
+     * Flushes all backends.
+     */
+    flush(): Promise<void>;
+    /**
+     * Closes all backends and releases resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Returns the number of registered backends.
+     */
+    get backendCount(): number;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/telemetry/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/telemetry/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEjE;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,kBAAkB,CAAS;IAEnC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAI3C;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;CACF"}

package/dist/telemetry/emitter.js

@@ -0,0 +1,83 @@
+/**
+ * Telemetry Emitter
+ *
+ * Feature: 007-pnpm-timeout-telemetry
+ * Implements: FR-014
+ *
+ * Low-overhead event emission with failure logging (once per run).
+ */
+/**
+ * Emitter that dispatches events to multiple backends.
+ * Implements best-effort semantics with failure logging.
+ */
+export class TelemetryEmitter {
+    backends = [];
+    hasLoggedEmitError = false;
+    /**
+     * Registers a backend for event dispatch.
+     */
+    addBackend(backend) {
+        this.backends.push(backend);
+    }
+    /**
+     * Removes all registered backends.
+     */
+    clearBackends() {
+        this.backends = [];
+    }
+    /**
+     * Emits an event to all registered backends.
+     * Best-effort: failures are logged once per run (FR-014).
+     */
+    async emit(event) {
+        if (this.backends.length === 0)
+            return;
+        // Fire-and-forget to all backends in parallel
+        await Promise.all(this.backends.map(async (backend) => {
+            try {
+                await backend.emit(event);
+            }
+            catch (error) {
+                // Log once per run
+                if (!this.hasLoggedEmitError) {
+                    this.hasLoggedEmitError = true;
+                    console.error(`[TELEMETRY] Emit error: ${error}`);
+                }
+            }
+        }));
+    }
+    /**
+     * Flushes all backends.
+     */
+    async flush() {
+        await Promise.all(this.backends.map(async (backend) => {
+            try {
+                await backend.flush();
+            }
+            catch {
+                // Swallow flush errors
+            }
+        }));
+    }
+    /**
+     * Closes all backends and releases resources.
+     */
+    async close() {
+        await Promise.all(this.backends.map(async (backend) => {
+            try {
+                await backend.close();
+            }
+            catch {
+                // Swallow close errors
+            }
+        }));
+        this.clearBackends();
+    }
+    /**
+     * Returns the number of registered backends.
+     */
+    get backendCount() {
+        return this.backends.length;
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/telemetry/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/telemetry/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACnB,QAAQ,GAAuB,EAAE,CAAC;IAClC,kBAAkB,GAAG,KAAK,CAAC;IAEnC;;OAEG;IACH,UAAU,CAAC,OAAyB;QAClC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,KAAmB;QAC5B,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEvC,8CAA8C;QAC9C,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,mBAAmB;gBACnB,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;oBAC7B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;oBAC/B,OAAO,CAAC,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QACF,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;CACF"}

package/dist/telemetry/hook.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Telemetry Hook Orchestrator
+ *
+ * Feature: 007-pnpm-timeout-telemetry
+ * Implements: FR-008, FR-014
+ *
+ * Coordinates telemetry configuration and event dispatch.
+ */
+import type { TelemetryConfig, TimeoutEventInput } from './types.js';
+/**
+ * TelemetryHook manages the telemetry lifecycle and dispatches events.
+ */
+export declare class TelemetryHook {
+    private config;
+    private emitter;
+    private initialized;
+    /**
+     * Configures telemetry with the given settings.
+     * Creates backends based on the configuration.
+     */
+    configure(config: Partial<TelemetryConfig>): Promise<void>;
+    /**
+     * Initializes backends based on current configuration.
+     */
+    private initializeBackends;
+    /**
+     * Emits a timeout event if telemetry is enabled.
+     * Best-effort: failures do not affect control flow.
+     */
+    emit(input: TimeoutEventInput): Promise<void>;
+    /**
+     * Flushes all pending events.
+     * Called at shutdown/run summary points.
+     */
+    flush(): Promise<void>;
+    /**
+     * Closes all backends and releases resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Returns whether telemetry is enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Returns the current configuration (for testing).
+     */
+    getConfig(): TelemetryConfig;
+}
+/**
+ * Factory function for creating TelemetryHook (for testability).
+ */
+export declare function createTelemetryHook(): TelemetryHook;
+//# sourceMappingURL=hook.d.ts.map

package/dist/telemetry/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/telemetry/hook.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AAMvF;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAoD;IAClE,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBhE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnD;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,eAAe;CAG7B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/telemetry/hook.js

@@ -0,0 +1,118 @@
+/**
+ * Telemetry Hook Orchestrator
+ *
+ * Feature: 007-pnpm-timeout-telemetry
+ * Implements: FR-008, FR-014
+ *
+ * Coordinates telemetry configuration and event dispatch.
+ */
+import { DEFAULT_TELEMETRY_CONFIG, createTimeoutEvent, TelemetryConfigSchema } from './types.js';
+import { TelemetryEmitter } from './emitter.js';
+import { createConsoleBackend } from './backends/console.js';
+import { createJsonlBackend } from './backends/jsonl.js';
+/**
+ * TelemetryHook manages the telemetry lifecycle and dispatches events.
+ */
+export class TelemetryHook {
+    config = { ...DEFAULT_TELEMETRY_CONFIG };
+    emitter = new TelemetryEmitter();
+    initialized = false;
+    /**
+     * Configures telemetry with the given settings.
+     * Creates backends based on the configuration.
+     */
+    async configure(config) {
+        // Merge with defaults and validate
+        const merged = TelemetryConfigSchema.parse({
+            ...this.config,
+            ...config,
+        });
+        // Close existing backends if reconfiguring
+        // Await close() to prevent race condition - close() already clears backends
+        if (this.initialized) {
+            await this.emitter.close();
+        }
+        this.config = merged;
+        // Create backends if enabled
+        if (this.config.enabled) {
+            this.initializeBackends();
+        }
+        this.initialized = true;
+    }
+    /**
+     * Initializes backends based on current configuration.
+     */
+    initializeBackends() {
+        for (const backendType of this.config.backends) {
+            let backend;
+            switch (backendType) {
+                case 'console':
+                    backend = createConsoleBackend({
+                        verbosity: this.config.verbosity,
+                    });
+                    break;
+                case 'jsonl':
+                    if (!this.config.jsonl_path) {
+                        console.error('[TELEMETRY] JSONL backend requires jsonl_path');
+                        continue;
+                    }
+                    backend = createJsonlBackend({
+                        filePath: this.config.jsonl_path,
+                        verbosity: this.config.verbosity,
+                        bufferSize: this.config.buffer_size,
+                        flushIntervalMs: this.config.flush_interval_ms,
+                    });
+                    break;
+            }
+            this.emitter.addBackend(backend);
+        }
+    }
+    /**
+     * Emits a timeout event if telemetry is enabled.
+     * Best-effort: failures do not affect control flow.
+     */
+    async emit(input) {
+        if (!this.config.enabled)
+            return;
+        try {
+            const event = createTimeoutEvent(input);
+            await this.emitter.emit(event);
+        }
+        catch {
+            // Best-effort: swallow errors
+        }
+    }
+    /**
+     * Flushes all pending events.
+     * Called at shutdown/run summary points.
+     */
+    async flush() {
+        await this.emitter.flush();
+    }
+    /**
+     * Closes all backends and releases resources.
+     */
+    async close() {
+        await this.emitter.close();
+        this.initialized = false;
+    }
+    /**
+     * Returns whether telemetry is enabled.
+     */
+    isEnabled() {
+        return this.config.enabled;
+    }
+    /**
+     * Returns the current configuration (for testing).
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+/**
+ * Factory function for creating TelemetryHook (for testability).
+ */
+export function createTelemetryHook() {
+    return new TelemetryHook();
+}
+//# sourceMappingURL=hook.js.map

package/dist/telemetry/hook.js.map

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

package/dist/telemetry/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Timeout Telemetry Public API
+ *
+ * Feature: 007-pnpm-timeout-telemetry
+ * Implements: FR-010
+ *
+ * Public exports for the telemetry module.
+ */
+import { TelemetryHook, createTelemetryHook } from './hook.js';
+import type { TelemetryConfig, TimeoutEventInput, TimeoutEvent, TelemetryBackend, TelemetryBackendType, TelemetryVerbosity, TimeoutSeverity, AllowedContext } from './types.js';
+import { TelemetryConfigSchema } from './types.js';
+/**
+ * Parses telemetry configuration from environment variables.
+ *
+ * Environment Variables:
+ * - TELEMETRY_ENABLED: 'true' or 'false' (default: 'false')
+ * - TELEMETRY_BACKENDS: Comma-separated list of backends (default: 'console')
+ * - TELEMETRY_JSONL_PATH: Path for JSONL output (required if jsonl backend used)
+ * - TELEMETRY_VERBOSITY: 'minimal', 'standard', or 'verbose' (default: 'standard')
+ * - TELEMETRY_BUFFER_SIZE: Max events to buffer (default: 100)
+ * - TELEMETRY_FLUSH_INTERVAL_MS: Flush interval in ms (default: 5000)
+ */
+export declare function parseEnvConfig(): Partial<TelemetryConfig>;
+/**
+ * Configures the global telemetry instance.
+ *
+ * @param config - Telemetry configuration
+ */
+export declare function configureTelemetry(config: Partial<TelemetryConfig>): Promise<void>;
+/**
+ * Configures telemetry from environment variables.
+ * Convenience function that parses env vars and applies config.
+ */
+export declare function configureFromEnv(): Promise<void>;
+/**
+ * Emits a timeout event if telemetry is enabled.
+ * Best-effort: failures do not affect control flow.
+ *
+ * @param event - Timeout event data (timestamp auto-generated)
+ */
+export declare function emitTimeoutEvent(event: TimeoutEventInput): Promise<void>;
+/**
+ * Flushes all pending telemetry events.
+ * Should be called at shutdown/run summary points.
+ */
+export declare function flushTelemetry(): Promise<void>;
+/**
+ * Closes the telemetry system and releases resources.
+ */
+export declare function closeTelemetry(): Promise<void>;
+/**
+ * Returns whether telemetry is enabled.
+ */
+export declare function isTelemetryEnabled(): boolean;
+export type { TelemetryConfig, TimeoutEventInput, TimeoutEvent, TelemetryBackend, TelemetryBackendType, TelemetryVerbosity, TimeoutSeverity, AllowedContext, };
+export { TelemetryConfigSchema, createTelemetryHook, TelemetryHook };
+export { TimeoutEventSchema, TimeoutSeverity as TimeoutSeveritySchema } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAA6C,MAAM,YAAY,CAAC;AAsB9F;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAAC,eAAe,CAAC,CAwDzD;AAMD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKtD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAKpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAMD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,cAAc,GACf,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,aAAa,EAAE,CAAC;AAGrE,OAAO,EAAE,kBAAkB,EAAE,eAAe,IAAI,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/telemetry/index.js

@@ -0,0 +1,143 @@
+/**
+ * Timeout Telemetry Public API
+ *
+ * Feature: 007-pnpm-timeout-telemetry
+ * Implements: FR-010
+ *
+ * Public exports for the telemetry module.
+ */
+import { TelemetryHook, createTelemetryHook } from './hook.js';
+import { TelemetryConfigSchema, TelemetryBackendType as BackendTypeSchema } from './types.js';
+// =============================================================================
+// Global Telemetry Instance
+// =============================================================================
+let globalHook = null;
+/**
+ * Gets or creates the global telemetry hook instance.
+ */
+function getGlobalHook() {
+    if (globalHook === null) {
+        globalHook = createTelemetryHook();
+    }
+    return globalHook;
+}
+// =============================================================================
+// Environment Variable Configuration
+// =============================================================================
+/**
+ * Parses telemetry configuration from environment variables.
+ *
+ * Environment Variables:
+ * - TELEMETRY_ENABLED: 'true' or 'false' (default: 'false')
+ * - TELEMETRY_BACKENDS: Comma-separated list of backends (default: 'console')
+ * - TELEMETRY_JSONL_PATH: Path for JSONL output (required if jsonl backend used)
+ * - TELEMETRY_VERBOSITY: 'minimal', 'standard', or 'verbose' (default: 'standard')
+ * - TELEMETRY_BUFFER_SIZE: Max events to buffer (default: 100)
+ * - TELEMETRY_FLUSH_INTERVAL_MS: Flush interval in ms (default: 5000)
+ */
+export function parseEnvConfig() {
+    const config = {};
+    // TELEMETRY_ENABLED
+    const enabledStr = process.env['TELEMETRY_ENABLED'];
+    if (enabledStr !== undefined) {
+        config.enabled = enabledStr.toLowerCase() === 'true';
+    }
+    // TELEMETRY_BACKENDS
+    const backendsStr = process.env['TELEMETRY_BACKENDS'];
+    if (backendsStr) {
+        const backends = backendsStr.split(',').map((b) => b.trim());
+        const validBackends = [];
+        for (const b of backends) {
+            const result = BackendTypeSchema.safeParse(b);
+            if (result.success) {
+                validBackends.push(result.data);
+            }
+        }
+        if (validBackends.length > 0) {
+            config.backends = validBackends;
+        }
+    }
+    // TELEMETRY_JSONL_PATH
+    const jsonlPath = process.env['TELEMETRY_JSONL_PATH'];
+    if (jsonlPath) {
+        config.jsonl_path = jsonlPath;
+    }
+    // TELEMETRY_VERBOSITY
+    const verbosity = process.env['TELEMETRY_VERBOSITY'];
+    if (verbosity === 'minimal' || verbosity === 'standard' || verbosity === 'verbose') {
+        config.verbosity = verbosity;
+    }
+    // TELEMETRY_BUFFER_SIZE
+    const bufferSizeStr = process.env['TELEMETRY_BUFFER_SIZE'];
+    if (bufferSizeStr) {
+        const bufferSize = parseInt(bufferSizeStr, 10);
+        if (!isNaN(bufferSize) && bufferSize > 0) {
+            config.buffer_size = bufferSize;
+        }
+    }
+    // TELEMETRY_FLUSH_INTERVAL_MS
+    const flushIntervalStr = process.env['TELEMETRY_FLUSH_INTERVAL_MS'];
+    if (flushIntervalStr) {
+        const flushInterval = parseInt(flushIntervalStr, 10);
+        if (!isNaN(flushInterval) && flushInterval >= 100) {
+            config.flush_interval_ms = flushInterval;
+        }
+    }
+    return config;
+}
+// =============================================================================
+// Public API Functions
+// =============================================================================
+/**
+ * Configures the global telemetry instance.
+ *
+ * @param config - Telemetry configuration
+ */
+export async function configureTelemetry(config) {
+    await getGlobalHook().configure(config);
+}
+/**
+ * Configures telemetry from environment variables.
+ * Convenience function that parses env vars and applies config.
+ */
+export async function configureFromEnv() {
+    const config = parseEnvConfig();
+    if (Object.keys(config).length > 0) {
+        await configureTelemetry(config);
+    }
+}
+/**
+ * Emits a timeout event if telemetry is enabled.
+ * Best-effort: failures do not affect control flow.
+ *
+ * @param event - Timeout event data (timestamp auto-generated)
+ */
+export async function emitTimeoutEvent(event) {
+    await getGlobalHook().emit(event);
+}
+/**
+ * Flushes all pending telemetry events.
+ * Should be called at shutdown/run summary points.
+ */
+export async function flushTelemetry() {
+    await getGlobalHook().flush();
+}
+/**
+ * Closes the telemetry system and releases resources.
+ */
+export async function closeTelemetry() {
+    if (globalHook !== null) {
+        await globalHook.close();
+        globalHook = null;
+    }
+}
+/**
+ * Returns whether telemetry is enabled.
+ */
+export function isTelemetryEnabled() {
+    return getGlobalHook().isEnabled();
+}
+export { TelemetryConfigSchema, createTelemetryHook, TelemetryHook };
+// Re-export types schema for validation
+export { TimeoutEventSchema, TimeoutSeverity as TimeoutSeveritySchema } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

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