@vurb/core 3.2.0

package/dist/observability/TelemetryBus.js

@@ -0,0 +1,463 @@
+/**
+ * TelemetryBus — Shadow Socket IPC Server
+ *
+ * Fire-and-forget out-of-band telemetry transport. Creates a Named Pipe
+ * (Windows) or Unix Domain Socket (POSIX) that streams NDJSON events
+ * to connected `vurb top` / `inspector` TUI clients.
+ *
+ * Architecture:
+ *   ┌─────────────────────────────────────────────────────┐
+ *   │  MCP Server Process (owns the IPC server)           │
+ *   │                                                     │
+ *   │  createTelemetryBus()                               │
+ *   │    │                                                │
+ *   │    ▼                                                │
+ *   │  net.createServer() → Named Pipe / Unix Socket      │
+ *   │    │                                                │
+ *   │    ▼                                                │
+ *   │  emit(event) → NDJSON → broadcast to all clients    │
+ *   │    │                                                │
+ *   │    └─ If 0 clients → silent no-op (zero overhead)   │
+ *   └─────────────────────────────────────────────────────┘
+ *
+ * Security mitigations (Staff Engineer Gotchas):
+ *   1. chmod 0o600 on Unix sockets (prevents PII sniffing)
+ *   2. Ghost socket recovery (stale file → probe → unlink)
+ *   3. Backpressure: slow clients disconnected at 64KB buffer
+ *   4. Clean shutdown on process exit / SIGTERM
+ *
+ * @module
+ */
+import { createServer, connect } from 'node:net';
+import { existsSync, unlinkSync, chmodSync, statSync, mkdirSync, writeFileSync, readdirSync, readFileSync } from 'node:fs';
+import { platform, tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Maximum write buffer per client before forced disconnect */
+const MAX_CLIENT_BUFFER_BYTES = 65_536; // 64KB
+/** Heartbeat interval in milliseconds */
+const HEARTBEAT_INTERVAL_MS = 5_000;
+/** Registry directory for cross-platform server discovery */
+const REGISTRY_DIR = join(tmpdir(), 'vurb-registry');
+// ============================================================================
+// Path Convention — Deterministic Socket Paths
+// ============================================================================
+/**
+ * Compute a deterministic fingerprint from `process.cwd()`.
+ *
+ * The fingerprint is a 12-char hex string (SHA-256 truncated),
+ * stable across server restarts for the same project directory.
+ * This enables the Inspector TUI to automatically reconnect
+ * when the server process restarts with a new PID.
+ *
+ * @returns 12-character hex fingerprint
+ * @internal
+ */
+function cwdFingerprint() {
+    return createHash('sha256').update(process.cwd()).digest('hex').slice(0, 12);
+}
+/**
+ * Compute the IPC path for the telemetry socket.
+ *
+ * Uses a deterministic fingerprint based on `process.cwd()` so the
+ * socket path remains stable across server restarts. This enables
+ * the Inspector TUI to reconnect automatically without PID tracking.
+ *
+ * - Windows: `\\.\pipe\vurb-{fingerprint}` (Named Pipe, auto-cleaned by OS)
+ * - POSIX:   `/tmp/vurb-{fingerprint}.sock` (Unix Domain Socket)
+ *
+ * @param fingerprint - Custom fingerprint (defaults to SHA-256 of cwd)
+ * @returns The IPC path string
+ */
+export function getTelemetryPath(fingerprint) {
+    const id = fingerprint ?? cwdFingerprint();
+    if (platform() === 'win32') {
+        return `\\\\.\\pipe\\vurb-${id}`;
+    }
+    return `/tmp/vurb-${id}.sock`;
+}
+// ============================================================================
+// Registry File Helpers (Cross-Platform Discovery)
+// ============================================================================
+/**
+ * Write a registry marker file so `discoverSockets()` can find this server.
+ * Creates `{REGISTRY_DIR}/{pid}.json` with metadata.
+ *
+ * @param pid - Process ID
+ * @param serverName - Optional server name for display
+ * @internal
+ */
+function writeRegistryFile(pid, serverName) {
+    try {
+        mkdirSync(REGISTRY_DIR, { recursive: true });
+        const data = JSON.stringify({
+            pid,
+            path: getTelemetryPath(),
+            name: serverName,
+            cwd: process.cwd(),
+            startedAt: Date.now(),
+        });
+        writeFileSync(join(REGISTRY_DIR, `${pid}.json`), data, 'utf8');
+    }
+    catch {
+        // Non-fatal — discovery won't work but server still runs
+    }
+}
+/**
+ * Remove the registry marker file for a given PID.
+ * @internal
+ */
+function removeRegistryFile(pid) {
+    try {
+        unlinkSync(join(REGISTRY_DIR, `${pid}.json`));
+    }
+    catch {
+        // File may not exist — ignore
+    }
+}
+/**
+ * Check if a process is still alive using signal 0 (probes without killing).
+ * Works cross-platform (Windows, Mac, Linux).
+ *
+ * @param pid - Process ID to check
+ * @returns `true` if the process exists, `false` if it's dead
+ * @internal
+ */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0); // Signal 0 = existence check, doesn't kill
+        return true;
+    }
+    catch {
+        return false; // ESRCH — process does not exist
+    }
+}
+/**
+ * Discover active telemetry sockets by scanning the registry directory.
+ * Works on Windows, Mac, and Linux.
+ *
+ * Reads `{REGISTRY_DIR}/*.json` marker files written by running servers.
+ * Each file contains `{ pid, path }`. Stale files from crashed processes
+ * (e.g. SIGKILL where cleanup handlers never run) are detected via PID
+ * probing and automatically cleaned up.
+ *
+ * @returns Array of discovered sockets with their PIDs
+ */
+export function discoverSockets() {
+    const results = [];
+    // ── Primary: scan registry directory (all platforms) ────
+    try {
+        const files = readdirSync(REGISTRY_DIR);
+        for (const file of files) {
+            const match = file.match(/^(\d+)\.json$/);
+            if (!match)
+                continue;
+            try {
+                const raw = readFileSync(join(REGISTRY_DIR, file), 'utf8');
+                const entry = JSON.parse(raw);
+                // ── Stale PID check ──────────────────────────
+                // If the process is dead (e.g. SIGKILL'd), the registry
+                // file is orphaned — remove it and skip.
+                if (!isProcessAlive(entry.pid)) {
+                    try {
+                        unlinkSync(join(REGISTRY_DIR, file));
+                    }
+                    catch { /* ignore */ }
+                    continue;
+                }
+                results.push({ pid: entry.pid, path: entry.path, ...(entry.cwd ? { cwd: entry.cwd } : {}) });
+            }
+            catch {
+                // Corrupted file — clean up
+                try {
+                    unlinkSync(join(REGISTRY_DIR, file));
+                }
+                catch { /* ignore */ }
+            }
+        }
+    }
+    catch {
+        // Registry dir doesn't exist yet — no servers registered
+    }
+    // ── Fallback: POSIX socket scan (backward compat) ──────
+    // Matches both legacy PID-based and new fingerprint-based sockets
+    if (platform() !== 'win32' && results.length === 0) {
+        try {
+            const files = readdirSync('/tmp');
+            for (const file of files) {
+                const match = file.match(/^vurb-([a-f0-9]+)\.sock$/);
+                if (match) {
+                    const idStr = match[1];
+                    const pid = /^\d+$/.test(idStr) ? parseInt(idStr, 10) : 0;
+                    // For PID-based sockets, check if alive; for hash-based, always include
+                    if (pid > 0 && !isProcessAlive(pid))
+                        continue;
+                    results.push({ pid, path: `/tmp/${file}` });
+                }
+            }
+        }
+        catch { /* ignore */ }
+    }
+    return results;
+}
+// ============================================================================
+// Ghost Socket Recovery (Gotcha #2)
+// ============================================================================
+/**
+ * Check if a socket file is a "ghost" (stale, left by a crashed process).
+ *
+ * Attempts a dummy connection. If `ECONNREFUSED`, the socket is stale
+ * and safe to unlink. If the connection succeeds, it's alive — don't touch it.
+ *
+ * @param socketPath - Path to the Unix socket file
+ * @returns Promise that resolves to `true` if the ghost was cleaned up
+ * @internal
+ */
+function cleanGhostSocket(socketPath) {
+    return new Promise((resolve) => {
+        // On Windows, Named Pipes are auto-cleaned — skip
+        if (platform() === 'win32') {
+            resolve(false);
+            return;
+        }
+        if (!existsSync(socketPath)) {
+            resolve(false);
+            return;
+        }
+        // Verify it's actually a socket file, not a regular file
+        try {
+            const stats = statSync(socketPath);
+            if (!stats.isSocket()) {
+                // Not a socket — don't touch it
+                resolve(false);
+                return;
+            }
+        }
+        catch {
+            resolve(false);
+            return;
+        }
+        // Probe with a dummy client connection
+        const probe = connect(socketPath);
+        const timeout = setTimeout(() => {
+            // Connection hanging — assume ghost, clean up
+            probe.destroy();
+            try {
+                unlinkSync(socketPath);
+            }
+            catch { /* ignore */ }
+            resolve(true);
+        }, 500);
+        probe.on('connect', () => {
+            // Socket is alive — another server is using it!
+            clearTimeout(timeout);
+            probe.destroy();
+            resolve(false);
+        });
+        probe.on('error', (err) => {
+            clearTimeout(timeout);
+            probe.destroy();
+            if (err.code === 'ECONNREFUSED') {
+                // Ghost socket — safe to remove
+                try {
+                    unlinkSync(socketPath);
+                }
+                catch { /* ignore */ }
+                resolve(true);
+            }
+            resolve(false);
+        });
+    });
+}
+/**
+ * Create an out-of-band telemetry bus for Vurb.
+ *
+ * The returned `emit` function is the {@link TelemetrySink} to pass
+ * to `AttachOptions.telemetry`. It broadcasts events as NDJSON
+ * to all connected TUI clients via IPC.
+ *
+ * When no clients are connected, `emit()` is a no-op — zero overhead.
+ *
+ * @param config - Optional configuration
+ * @returns A promise that resolves to the running bus instance
+ *
+ * @example
+ * ```typescript
+ * import { createTelemetryBus } from 'vurb/observability';
+ *
+ * const bus = await createTelemetryBus();
+ *
+ * // Pass to server attachment
+ * registry.attachToServer(server, {
+ *     contextFactory: createContext,
+ *     telemetry: bus.emit,
+ * });
+ *
+ * // On shutdown
+ * await bus.close();
+ * ```
+ */
+export async function createTelemetryBus(config) {
+    const socketPath = config?.path ?? getTelemetryPath();
+    const clients = new Set();
+    // ── Gotcha #2: Ghost Socket Recovery ──────────────────
+    await cleanGhostSocket(socketPath);
+    // ── Create IPC Server ─────────────────────────────────
+    const server = createServer((client) => {
+        clients.add(client);
+        // Send initial topology snapshot if available
+        if (config?.onConnect) {
+            const topology = config.onConnect();
+            if (topology) {
+                try {
+                    client.write(JSON.stringify(topology) + '\n');
+                }
+                catch { /* swallow */ }
+            }
+        }
+        client.on('error', () => {
+            clients.delete(client);
+        });
+        client.on('close', () => {
+            clients.delete(client);
+        });
+    });
+    // ── Start Listening ───────────────────────────────────
+    await new Promise((resolve, reject) => {
+        server.once('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                // On POSIX: unlink stale socket file and retry.
+                // On Windows: Named Pipes can't be unlinked — just retry
+                // (the OS will reclaim the pipe name if the owner is dead).
+                try {
+                    unlinkSync(socketPath);
+                }
+                catch { /* ignore on Windows */ }
+                server.once('error', (retryErr) => reject(retryErr));
+                server.listen(socketPath, () => resolve());
+            }
+            else {
+                reject(err);
+            }
+        });
+        server.listen(socketPath, () => resolve());
+    });
+    // ── Registry: announce this server for auto-discovery ──
+    writeRegistryFile(process.pid, config?.path ? undefined : 'vurb');
+    // ── Gotcha #1: IPC Security (chmod 0o600) ─────────────
+    // Restrict socket to owner-only on POSIX to prevent PII sniffing
+    if (platform() !== 'win32') {
+        try {
+            chmodSync(socketPath, 0o600);
+        }
+        catch {
+            // Non-fatal — log warning via stderr (never stdout!)
+            process.stderr.write('[vurb] Warning: Could not restrict socket permissions.\n');
+        }
+    }
+    // ── Heartbeat Timer ───────────────────────────────────
+    const heartbeatTimer = setInterval(() => {
+        if (clients.size === 0)
+            return;
+        const mem = process.memoryUsage();
+        emit({
+            type: 'heartbeat',
+            heapUsedBytes: mem.heapUsed,
+            heapTotalBytes: mem.heapTotal,
+            rssBytes: mem.rss,
+            uptimeSeconds: Math.floor(process.uptime()),
+            timestamp: Date.now(),
+        });
+    }, HEARTBEAT_INTERVAL_MS);
+    // Don't let the heartbeat timer keep the process alive
+    heartbeatTimer.unref();
+    // ── Emit Function (Fire-and-Forget) ───────────────────
+    function emit(event) {
+        // Zero overhead when no clients
+        if (clients.size === 0)
+            return;
+        let line;
+        try {
+            line = JSON.stringify(event) + '\n';
+        }
+        catch {
+            return; // Non-serializable event — silently drop
+        }
+        for (const client of clients) {
+            // ── Gotcha #3 (Backpressure) ──────────────────
+            // If the client's write buffer exceeds the limit,
+            // disconnect it to protect the server from memory bloat
+            if (client.writableLength > MAX_CLIENT_BUFFER_BYTES) {
+                client.destroy();
+                clients.delete(client);
+                continue;
+            }
+            try {
+                client.write(line);
+            }
+            catch {
+                // Write failed — client is dead, remove it
+                client.destroy();
+                clients.delete(client);
+            }
+        }
+    }
+    // ── Clean Shutdown ────────────────────────────────────
+    function cleanup() {
+        clearInterval(heartbeatTimer);
+        for (const client of clients) {
+            try {
+                client.destroy();
+            }
+            catch { /* ignore */ }
+        }
+        clients.clear();
+        try {
+            server.close();
+        }
+        catch { /* ignore */ }
+        // Remove socket file on POSIX
+        if (platform() !== 'win32') {
+            try {
+                unlinkSync(socketPath);
+            }
+            catch { /* ignore */ }
+        }
+        // Remove registry file (cross-platform discovery)
+        removeRegistryFile(process.pid);
+    }
+    // Register cleanup on process exit signals
+    const exitHandler = () => { cleanup(); };
+    process.on('exit', exitHandler);
+    // Use process.once for SIGINT/SIGTERM and re-emit the signal after cleanup
+    // so the process actually terminates (Bug #15)
+    const sigHandler = (signal) => {
+        cleanup();
+        process.kill(process.pid, signal);
+    };
+    // Bug #49 fix: store arrow function references so close() can remove them
+    const sigintHandler = () => sigHandler('SIGINT');
+    const sigtermHandler = () => sigHandler('SIGTERM');
+    process.once('SIGINT', sigintHandler);
+    process.once('SIGTERM', sigtermHandler);
+    // ── Close Method ──────────────────────────────────────
+    async function close() {
+        process.removeListener('exit', exitHandler);
+        // Signal handlers were registered with process.once, so they
+        // auto-remove after firing. Remove them explicitly only if
+        // close() is called before a signal arrives.
+        process.removeListener('SIGINT', sigintHandler);
+        process.removeListener('SIGTERM', sigtermHandler);
+        cleanup();
+    }
+    return {
+        emit,
+        path: socketPath,
+        clientCount: () => clients.size,
+        close,
+    };
+}
+//# sourceMappingURL=TelemetryBus.js.map

package/dist/observability/TelemetryBus.js.map

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

package/dist/observability/TelemetryEvent.d.ts

@@ -0,0 +1,177 @@
+/**
+ * TelemetryEvent — Enriched Out-of-Band Telemetry Types
+ *
+ * Extends the core {@link DebugEvent} discriminated union with
+ * domain-specific telemetry events for the Shadow Socket transport.
+ *
+ * These events are emitted over an IPC channel (Named Pipe on Windows,
+ * Unix Domain Socket on POSIX) and consumed by `vurb top`.
+ * They NEVER touch stdio — the MCP JSON-RPC channel is 100% safe.
+ *
+ * Design rules:
+ * - All events are JSON-serializable (no Date objects, no functions)
+ * - All events carry a `timestamp` (epoch ms) for chronological ordering
+ * - The `type` field is the discriminator for exhaustive `switch` handling
+ * - Events are fire-and-forget — dropping them must never affect the server
+ *
+ * @module
+ */
+import type { DebugEvent } from './DebugObserver.js';
+/**
+ * Emitted after the DLP RedactEngine masks PII fields.
+ * Allows the TUI to display live redaction activity and field paths.
+ */
+export interface DlpRedactEvent {
+    readonly type: 'dlp.redact';
+    readonly tool: string;
+    readonly action: string;
+    /** Number of fields that were masked */
+    readonly fieldsRedacted: number;
+    /** The configured redaction paths that matched */
+    readonly paths: readonly string[];
+    /** Short hex trace ID for correlating events in the same request lifecycle */
+    readonly traceId?: string;
+    readonly timestamp: number;
+}
+/**
+ * Emitted after the Presenter's Late Guillotine slices data.
+ * Shows the token-saving ratio — the visual ROI proof.
+ */
+export interface PresenterSliceEvent {
+    readonly type: 'presenter.slice';
+    readonly tool: string;
+    readonly action: string;
+    /** Size of the raw data from the handler (bytes) */
+    readonly rawBytes: number;
+    /** Size after Presenter filtering for the LLM wire (bytes) */
+    readonly wireBytes: number;
+    /** Number of raw rows/items before filtering */
+    readonly rowsRaw: number;
+    /** Number of rows/items after filtering */
+    readonly rowsWire: number;
+    /** Short hex trace ID for correlating events in the same request lifecycle */
+    readonly traceId?: string;
+    readonly timestamp: number;
+}
+/**
+ * Emitted after the Presenter injects cognitive rules.
+ * Allows the TUI to display the JIT domain rules sent to the LLM.
+ */
+export interface PresenterRulesEvent {
+    readonly type: 'presenter.rules';
+    readonly tool: string;
+    readonly action: string;
+    /** The system rules injected into the response */
+    readonly rules: readonly string[];
+    /** Short hex trace ID for correlating events in the same request lifecycle */
+    readonly traceId?: string;
+    readonly timestamp: number;
+}
+/**
+ * Emitted after a SandboxEngine execution completes.
+ * Shows V8 isolate metrics for the computation delegation.
+ */
+export interface SandboxExecEvent {
+    readonly type: 'sandbox.exec';
+    /** Execution time in milliseconds */
+    readonly executionMs: number;
+    /** Whether the execution succeeded */
+    readonly ok: boolean;
+    /** Error code if execution failed */
+    readonly errorCode?: string;
+    readonly timestamp: number;
+}
+/**
+ * Emitted after an FSM state transition.
+ * Shows the temporal anti-hallucination gate in action.
+ */
+export interface FsmTransitionEvent {
+    readonly type: 'fsm.transition';
+    readonly previousState: string;
+    readonly currentState: string;
+    /** The event that triggered the transition */
+    readonly event: string;
+    /** Number of tools visible in the new state */
+    readonly toolsVisible: number;
+    readonly timestamp: number;
+}
+/**
+ * Emitted once on TUI client connection.
+ * Provides the full server topology for immediate panel population.
+ */
+export interface TopologyEvent {
+    readonly type: 'topology';
+    readonly serverName: string;
+    readonly pid: number;
+    readonly tools: readonly TopologyTool[];
+    /** Current FSM state, if FSM is configured */
+    readonly fsmState?: string;
+    readonly timestamp: number;
+}
+/** Tool entry within a {@link TopologyEvent} */
+export interface TopologyTool {
+    readonly name: string;
+    readonly actions: readonly string[];
+    /** Read-only or destructive annotation */
+    readonly readOnly?: boolean;
+    readonly destructive?: boolean;
+    /** Whether this tool runs in the V8 Sandbox */
+    readonly sandboxed?: boolean;
+    /** FSM states where this tool is visible */
+    readonly fsmStates?: readonly string[];
+}
+/**
+ * Periodic heartbeat with process-level metrics.
+ * Emitted every 5 seconds to keep the TUI header bar alive.
+ */
+export interface HeartbeatEvent {
+    readonly type: 'heartbeat';
+    /** V8 heap used in bytes */
+    readonly heapUsedBytes: number;
+    /** V8 heap total in bytes */
+    readonly heapTotalBytes: number;
+    /** RSS in bytes */
+    readonly rssBytes: number;
+    /** Process uptime in seconds */
+    readonly uptimeSeconds: number;
+    readonly timestamp: number;
+}
+/**
+ * All possible telemetry events that flow through the Shadow Socket.
+ *
+ * This is a superset of {@link DebugEvent} — the core pipeline events
+ * are included alongside the domain-specific telemetry.
+ *
+ * Use `switch (event.type)` for exhaustive handling:
+ * ```typescript
+ * function handle(event: TelemetryEvent) {
+ *     switch (event.type) {
+ *         case 'route':           // DebugEvent
+ *         case 'validate':        // DebugEvent
+ *         case 'execute':         // DebugEvent
+ *         case 'error':           // DebugEvent
+ *         case 'middleware':       // DebugEvent
+ *         case 'governance':      // DebugEvent
+ *         case 'dlp.redact':      // DlpRedactEvent
+ *         case 'presenter.slice': // PresenterSliceEvent
+ *         case 'presenter.rules': // PresenterRulesEvent
+ *         case 'sandbox.exec':    // SandboxExecEvent
+ *         case 'fsm.transition':  // FsmTransitionEvent
+ *         case 'topology':        // TopologyEvent
+ *         case 'heartbeat':       // HeartbeatEvent
+ *     }
+ * }
+ * ```
+ */
+export type TelemetryEvent = DebugEvent | DlpRedactEvent | PresenterSliceEvent | PresenterRulesEvent | SandboxExecEvent | FsmTransitionEvent | TopologyEvent | HeartbeatEvent;
+/**
+ * A function that accepts telemetry events for out-of-band delivery.
+ *
+ * The implementation is a fire-and-forget NDJSON writer to the IPC socket.
+ * If no TUI client is connected, the events are silently discarded.
+ *
+ * This type is passed to `AttachOptions.telemetry` and to individual
+ * subsystems (Presenter, RedactEngine, SandboxEngine) for event emission.
+ */
+export type TelemetrySink = (event: TelemetryEvent) => void;
+//# sourceMappingURL=TelemetryEvent.d.ts.map

package/dist/observability/TelemetryEvent.d.ts.map

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

package/dist/observability/TelemetryEvent.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TelemetryEvent.js.map

package/dist/observability/TelemetryEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryEvent.js","sourceRoot":"","sources":["../../src/observability/TelemetryEvent.ts"],"names":[],"mappings":""}