@runcore-sh/runcore 0.1.2

package/dist/metrics/collector.js

@@ -0,0 +1,346 @@
+/**
+ * Metrics collector — background collection of system, HTTP, agent, and error metrics.
+ * Follows queue/timer.ts pattern: module-level state, idempotent start/stop, dynamic intervals.
+ */
+import { logActivity } from "../activity/log.js";
+import { createLogger } from "../utils/logger.js";
+import { collectFirewallMetrics } from "./firewall-metrics.js";
+import { collectSystemMetrics, initCpuBaseline } from "./system.js";
+import { runAggregation } from "./aggregator.js";
+const log = createLogger("metrics");
+import { agentSpawnsTotal, agentExecutionsTotal, agentExecutionDuration, agentExecutionsInFlight, agentSuccessRate, agentMemoryUsageBytes, errorsTotal, eventLoopDriftSeconds, } from "./prometheus.js";
+const DEFAULT_COLLECT_INTERVAL_MS = 30_000; // 30 seconds
+const ROTATION_CHECK_CYCLES = 60; // check rotation every ~30 min at 30s interval
+const AGGREGATION_CHECK_CYCLES = 120; // aggregate every ~60 min at 30s interval
+// ─── Module-level state ──────────────────────────────────────────────────────
+let timer = null;
+let store = null;
+let metricsDir = null;
+let collectCycles = 0;
+// ─── In-memory counters (written to store on each collect cycle) ─────────────
+/** HTTP request tracking — populated by middleware via recordHttp(). */
+const httpLatencies = [];
+const httpStatusCounts = new Map();
+let httpTotal = 0;
+let httpErrors = 0;
+let httpConcurrent = 0;
+let httpConcurrentMax = 0;
+/** Per-endpoint request counts — populated by middleware via recordHttp(). */
+const httpEndpointCounts = new Map();
+/** Agent lifecycle tracking — populated via recordAgentSpawn/Completion(). */
+let agentSpawnCount = 0;
+let agentCompleteCount = 0;
+let agentFailCount = 0;
+const agentDurations = [];
+/** Cumulative agent success/total for computing success rate gauge. */
+let cumulativeAgentSuccesses = 0;
+let cumulativeAgentTotal = 0;
+/** Error tracking — populated via recordError(). */
+let errorCount = 0;
+const errorsBySource = new Map();
+// ─── Collection ──────────────────────────────────────────────────────────────
+/** Collect all metrics and write to store. */
+async function collect() {
+    if (!store)
+        return;
+    const now = new Date().toISOString();
+    const points = [];
+    // System: memory, CPU, and disk (brain/ directory size)
+    points.push(...await collectSystemMetrics(now));
+    // System: Event loop drift
+    const driftStart = performance.now();
+    await new Promise((resolve) => setTimeout(resolve, 0));
+    const drift = performance.now() - driftStart;
+    const driftRounded = Math.round(drift * 100) / 100;
+    points.push({
+        timestamp: now,
+        name: "system.event_loop.drift",
+        value: driftRounded,
+        unit: "ms",
+    });
+    eventLoopDriftSeconds.set(undefined, driftRounded / 1000);
+    // Snapshot accumulators (sync) so new data arriving during the async
+    // write goes into fresh accumulators, not into the void.
+    const hadHttp = httpLatencies.length > 0;
+    const hadAgent = agentSpawnCount > 0 || agentCompleteCount > 0 || agentFailCount > 0;
+    const hadErrors = errorCount > 0;
+    // HTTP: snapshot and drain
+    const httpSnap = hadHttp ? httpLatencies.splice(0) : [];
+    const httpStatusSnap = hadHttp ? new Map(httpStatusCounts) : null;
+    const httpEndpointSnap = hadHttp ? new Map(httpEndpointCounts) : null;
+    const httpTotalSnap = httpTotal;
+    const httpErrorsSnap = httpErrors;
+    const httpConcurrentSnap = httpConcurrent;
+    const httpConcurrentMaxSnap = httpConcurrentMax;
+    if (hadHttp) {
+        httpStatusCounts.clear();
+        httpEndpointCounts.clear();
+        httpTotal = 0;
+        httpErrors = 0;
+        httpConcurrentMax = httpConcurrent;
+    }
+    // Agent: snapshot and drain
+    const agentSpawnSnap = agentSpawnCount;
+    const agentCompleteSnap = agentCompleteCount;
+    const agentFailSnap = agentFailCount;
+    const agentDurSnap = hadAgent ? agentDurations.splice(0) : [];
+    if (hadAgent) {
+        agentSpawnCount = 0;
+        agentCompleteCount = 0;
+        agentFailCount = 0;
+    }
+    // Error: snapshot and drain
+    const errorCountSnap = errorCount;
+    const errorsBySourceSnap = hadErrors ? new Map(errorsBySource) : null;
+    if (hadErrors) {
+        errorCount = 0;
+        errorsBySource.clear();
+    }
+    // Build points from snapshots
+    if (hadHttp) {
+        const sorted = [...httpSnap].sort((a, b) => a - b);
+        const sum = sorted.reduce((a, v) => a + v, 0);
+        points.push({ timestamp: now, name: "http.request.count", value: httpTotalSnap, unit: "count" }, { timestamp: now, name: "http.request.error_count", value: httpErrorsSnap, unit: "count" }, { timestamp: now, name: "http.request.latency.avg", value: Math.round(sum / sorted.length), unit: "ms" }, { timestamp: now, name: "http.request.latency.p50", value: percentile(sorted, 50), unit: "ms" }, { timestamp: now, name: "http.request.latency.p95", value: percentile(sorted, 95), unit: "ms" }, { timestamp: now, name: "http.request.latency.p99", value: percentile(sorted, 99), unit: "ms" }, { timestamp: now, name: "http.request.latency.max", value: sorted[sorted.length - 1], unit: "ms" });
+        for (const [code, count] of httpStatusSnap) {
+            points.push({
+                timestamp: now,
+                name: "http.request.status",
+                value: count,
+                unit: "count",
+                tags: { status: String(code) },
+            });
+        }
+        // Per-endpoint request counts
+        for (const [key, count] of httpEndpointSnap) {
+            const [method, ...rest] = key.split(" ");
+            const endpoint = rest.join(" ");
+            points.push({
+                timestamp: now,
+                name: "http.request.by_endpoint",
+                value: count,
+                unit: "count",
+                tags: { method, endpoint },
+            });
+        }
+    }
+    // Concurrent requests gauge (always emitted — useful even when no new requests arrived)
+    points.push({
+        timestamp: now,
+        name: "http.concurrent_requests",
+        value: httpConcurrentSnap,
+        unit: "count",
+    });
+    if (hadHttp) {
+        points.push({
+            timestamp: now,
+            name: "http.concurrent_requests.max",
+            value: httpConcurrentMaxSnap,
+            unit: "count",
+        });
+    }
+    if (hadAgent) {
+        points.push({ timestamp: now, name: "agent.spawn.count", value: agentSpawnSnap, unit: "count" }, { timestamp: now, name: "agent.complete.count", value: agentCompleteSnap, unit: "count" }, { timestamp: now, name: "agent.fail.count", value: agentFailSnap, unit: "count" });
+        if (agentDurSnap.length > 0) {
+            const sorted = [...agentDurSnap].sort((a, b) => a - b);
+            const sum = sorted.reduce((a, v) => a + v, 0);
+            points.push({ timestamp: now, name: "agent.duration.avg", value: Math.round(sum / sorted.length), unit: "ms" }, { timestamp: now, name: "agent.duration.p95", value: percentile(sorted, 95), unit: "ms" }, { timestamp: now, name: "agent.duration.max", value: sorted[sorted.length - 1], unit: "ms" });
+        }
+    }
+    // Agent execution tracking gauges (always emitted when data exists)
+    if (cumulativeAgentTotal > 0) {
+        points.push({
+            timestamp: now,
+            name: "agent.success_rate",
+            value: Math.round((cumulativeAgentSuccesses / cumulativeAgentTotal) * 10000) / 10000,
+            unit: "ratio",
+        });
+    }
+    points.push({
+        timestamp: now,
+        name: "agent.memory_usage",
+        value: process.memoryUsage().heapUsed,
+        unit: "bytes",
+    });
+    if (hadErrors) {
+        points.push({
+            timestamp: now,
+            name: "error.total",
+            value: errorCountSnap,
+            unit: "count",
+        });
+        for (const [source, count] of errorsBySourceSnap) {
+            points.push({
+                timestamp: now,
+                name: "error.by_source",
+                value: count,
+                unit: "count",
+                tags: { source },
+            });
+        }
+    }
+    // Firewall metrics: drain accumulators
+    points.push(...collectFirewallMetrics());
+    // Write all points in a single batch
+    try {
+        await store.recordBatch(points);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.error(`Failed to write: ${msg}`);
+        // Restore snapshots so data is retried on next cycle
+        if (hadHttp) {
+            httpLatencies.push(...httpSnap);
+            for (const [code, count] of httpStatusSnap) {
+                httpStatusCounts.set(code, (httpStatusCounts.get(code) ?? 0) + count);
+            }
+            for (const [key, count] of httpEndpointSnap) {
+                httpEndpointCounts.set(key, (httpEndpointCounts.get(key) ?? 0) + count);
+            }
+            httpTotal += httpTotalSnap;
+            httpErrors += httpErrorsSnap;
+        }
+        if (hadAgent) {
+            agentSpawnCount += agentSpawnSnap;
+            agentCompleteCount += agentCompleteSnap;
+            agentFailCount += agentFailSnap;
+            agentDurations.push(...agentDurSnap);
+        }
+        if (hadErrors) {
+            errorCount += errorCountSnap;
+            for (const [source, count] of errorsBySourceSnap) {
+                errorsBySource.set(source, (errorsBySource.get(source) ?? 0) + count);
+            }
+        }
+    }
+    // Periodic rotation check
+    collectCycles++;
+    if (collectCycles % ROTATION_CHECK_CYCLES === 0 && store.shouldRotate()) {
+        try {
+            const { before, after } = await store.rotate();
+            if (before !== after) {
+                logActivity({
+                    source: "system",
+                    summary: `Metrics rotated: ${before} → ${after} points`,
+                });
+            }
+        }
+        catch {
+            // Rotation failure is non-critical
+        }
+    }
+    // Periodic aggregation (non-blocking — fire and forget)
+    if (collectCycles % AGGREGATION_CHECK_CYCLES === 0 && metricsDir) {
+        runAggregation(store, metricsDir).catch((err) => {
+            log.error(`Aggregation error: ${err instanceof Error ? err.message : String(err)}`);
+        });
+    }
+}
+// ─── Public recording API (called by middleware/hooks) ────────────────────────
+/** Record an HTTP request's latency and status. Called by the metrics middleware. */
+export function recordHttp(durationMs, statusCode, method, endpoint) {
+    httpLatencies.push(durationMs);
+    httpTotal++;
+    if (statusCode >= 400)
+        httpErrors++;
+    httpStatusCounts.set(statusCode, (httpStatusCounts.get(statusCode) ?? 0) + 1);
+    // Track per-endpoint counts for JSONL output
+    if (method && endpoint) {
+        const key = `${method} ${endpoint}`;
+        httpEndpointCounts.set(key, (httpEndpointCounts.get(key) ?? 0) + 1);
+    }
+}
+/** Adjust concurrent request count. Called by the metrics middleware. */
+export function recordConcurrentRequests(delta) {
+    httpConcurrent += delta;
+    if (httpConcurrent > httpConcurrentMax) {
+        httpConcurrentMax = httpConcurrent;
+    }
+}
+/** Record an agent spawn event. */
+export function recordAgentSpawn() {
+    agentSpawnCount++;
+    agentSpawnsTotal.inc();
+    agentExecutionsInFlight.inc();
+    agentMemoryUsageBytes.set(undefined, process.memoryUsage().heapUsed);
+}
+/** Record an agent completion. durationMs is startedAt→finishedAt. */
+export function recordAgentCompletion(durationMs, success) {
+    const status = success ? "success" : "failure";
+    if (success) {
+        agentCompleteCount++;
+        cumulativeAgentSuccesses++;
+    }
+    else {
+        agentFailCount++;
+    }
+    cumulativeAgentTotal++;
+    agentDurations.push(durationMs);
+    // Prometheus instruments
+    agentExecutionsTotal.inc({ status });
+    agentExecutionDuration.observe({ status }, durationMs / 1000);
+    agentExecutionsInFlight.dec();
+    agentSuccessRate.set(undefined, cumulativeAgentTotal > 0 ? cumulativeAgentSuccesses / cumulativeAgentTotal : 0);
+    agentMemoryUsageBytes.set(undefined, process.memoryUsage().heapUsed);
+}
+/** Record an error by source category. */
+export function recordError(source) {
+    errorCount++;
+    errorsBySource.set(source, (errorsBySource.get(source) ?? 0) + 1);
+    // Prometheus instrument
+    errorsTotal.inc({ source });
+}
+// ─── Lifecycle ───────────────────────────────────────────────────────────────
+/**
+ * Start the background metrics collector. Idempotent.
+ * Collects system, HTTP, agent, and error metrics at a fixed interval.
+ * @param brainDir - Path to the brain directory, used for aggregation output.
+ */
+export function startCollector(metricsStore, intervalMs, brainDir) {
+    if (timer)
+        return;
+    store = metricsStore;
+    metricsDir = brainDir ? `${brainDir}/metrics` : null;
+    const interval = intervalMs ?? DEFAULT_COLLECT_INTERVAL_MS;
+    // Initialize CPU baseline for delta calculations
+    initCpuBaseline();
+    collectCycles = 0;
+    timer = setInterval(() => {
+        collect().catch((err) => {
+            log.error(`Collection error: ${err instanceof Error ? err.message : String(err)}`);
+        });
+    }, interval);
+    // Fire once immediately
+    collect().catch(() => { });
+    // Run initial aggregation for any missed windows (non-blocking)
+    if (metricsDir) {
+        runAggregation(store, metricsDir).catch(() => { });
+    }
+    log.info(`Metrics collector: every ${Math.round(interval / 1000)}s`);
+}
+/** Stop the metrics collector. */
+export function stopCollector() {
+    if (timer) {
+        clearInterval(timer);
+        timer = null;
+    }
+    store = null;
+    metricsDir = null;
+}
+/** Check if the collector is running. */
+export function isCollectorRunning() {
+    return timer !== null;
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function percentile(sorted, p) {
+    if (sorted.length === 0)
+        return 0;
+    if (sorted.length === 1)
+        return sorted[0];
+    const idx = (p / 100) * (sorted.length - 1);
+    const lower = Math.floor(idx);
+    const upper = Math.ceil(idx);
+    if (lower === upper)
+        return sorted[lower];
+    return sorted[lower] + (sorted[upper] - sorted[lower]) * (idx - lower);
+}
+//# sourceMappingURL=collector.js.map

package/dist/metrics/collector.js.map

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

package/dist/metrics/firewall-metrics.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Metabolic Firewall metrics — tracks dedup guard, routine classifier,
+ * cooldown manager, autonomous action rate, and resolved pattern filter.
+ *
+ * Records into the existing MetricsStore as MetricPoints with "firewall.*" names.
+ * Provides a report generator for before/after comparison over 2-4 weeks.
+ */
+import type { MetricPoint } from "./types.js";
+import { MetricsStore } from "./store.js";
+export declare const FIREWALL_METRICS: {
+    /** Autonomous actions spawned in a 10-min window. */
+    readonly AUTONOMOUS_ACTIONS: "firewall.autonomous.actions";
+    /** Dedup guard blocks (each block is one count). */
+    readonly DEDUP_BLOCKS: "firewall.dedup.blocks";
+    /** Routine entries filtered per analysis cycle. */
+    readonly ROUTINE_FILTERED: "firewall.routine.filtered";
+    /** Entries filtered by resolved pattern match per analysis cycle. */
+    readonly RESOLVED_FILTERED: "firewall.resolved.filtered";
+    /** Cooldown activations (task put on cooldown). */
+    readonly COOLDOWN_ACTIVATIONS: "firewall.cooldown.activations";
+    /** Cooldown skips (task skipped because on cooldown). */
+    readonly COOLDOWN_SKIPS: "firewall.cooldown.skips";
+    /** Bridge reports generated (3+ failure handoffs). */
+    readonly BRIDGE_REPORTS: "firewall.bridge.reports";
+    /** Spawn rate limiter blocks. */
+    readonly SPAWN_RATE_BLOCKS: "firewall.spawn_rate.blocks";
+    /** Total entries entering analysis pipeline. */
+    readonly ANALYSIS_ENTRIES_RAW: "firewall.analysis.entries_raw";
+    /** Entries remaining after all filters. */
+    readonly ANALYSIS_ENTRIES_KEPT: "firewall.analysis.entries_kept";
+};
+/** Record an autonomous action (agent spawned by the autonomous loop). */
+export declare function recordAutonomousAction(): void;
+/** Record a dedup guard block. */
+export declare function recordDedupBlock(reason: string): void;
+/** Record routine entries filtered in an analysis cycle. */
+export declare function recordRoutineFiltered(count: number): void;
+/** Record resolved-pattern entries filtered in an analysis cycle. */
+export declare function recordResolvedFiltered(count: number): void;
+/** Record a cooldown activation (task failure → cooldown). */
+export declare function recordCooldownActivation(): void;
+/** Record a cooldown skip (task skipped because on cooldown). */
+export declare function recordCooldownSkip(): void;
+/** Record a bridge report generation. */
+export declare function recordBridgeReport(): void;
+/** Record a spawn rate limiter block. */
+export declare function recordSpawnRateBlock(): void;
+/** Record analysis pipeline throughput for one cycle. */
+export declare function recordAnalysisThroughput(raw: number, kept: number): void;
+/**
+ * Drain in-memory accumulators and return MetricPoints.
+ * Designed to be called from the main collect() cycle in collector.ts.
+ */
+export declare function collectFirewallMetrics(): MetricPoint[];
+export interface FirewallPeriodStats {
+    periodStart: string;
+    periodEnd: string;
+    /** Autonomous actions per 10-min window (avg). */
+    autonomousActionsPer10Min: number;
+    /** Total dedup guard blocks. */
+    dedupBlocksTotal: number;
+    /** Avg routine entries filtered per analysis cycle. */
+    routineFilteredPerCycle: number;
+    /** Avg resolved-pattern entries filtered per cycle. */
+    resolvedFilteredPerCycle: number;
+    /** Total cooldown activations. */
+    cooldownActivationsTotal: number;
+    /** Total cooldown skips. */
+    cooldownSkipsTotal: number;
+    /** Total bridge reports. */
+    bridgeReportsTotal: number;
+    /** Spawn rate limiter blocks. */
+    spawnRateBlocksTotal: number;
+    /** Filter efficiency: % of raw entries filtered before LLM. */
+    filterEfficiencyPercent: number;
+}
+/**
+ * Generate stats for a time period from the metrics store.
+ * @param store MetricsStore instance
+ * @param since ISO timestamp for period start
+ * @param until ISO timestamp for period end (defaults to now)
+ */
+export declare function generatePeriodStats(store: MetricsStore, since: string, until?: string): Promise<FirewallPeriodStats>;
+/**
+ * Generate a markdown comparison report between two periods.
+ * Designed for the 2-4 week before/after writeup.
+ */
+export declare function generateComparisonReport(store: MetricsStore, before: {
+    since: string;
+    until: string;
+}, after: {
+    since: string;
+    until: string;
+}): Promise<string>;
+//# sourceMappingURL=firewall-metrics.d.ts.map

package/dist/metrics/firewall-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firewall-metrics.d.ts","sourceRoot":"","sources":["../../src/metrics/firewall-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1C,eAAO,MAAM,gBAAgB;IAC3B,qDAAqD;;IAErD,oDAAoD;;IAEpD,mDAAmD;;IAEnD,qEAAqE;;IAErE,mDAAmD;;IAEnD,yDAAyD;;IAEzD,sDAAsD;;IAEtD,iCAAiC;;IAEjC,gDAAgD;;IAEhD,2CAA2C;;CAEnC,CAAC;AAkBX,0EAA0E;AAC1E,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGrD;AAED,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,8DAA8D;AAC9D,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,yCAAyC;AACzC,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,yCAAyC;AACzC,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,yDAAyD;AACzD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGxE;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,WAAW,EAAE,CAiGtD;AAID,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,yBAAyB,EAAE,MAAM,CAAC;IAClC,gCAAgC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,uBAAuB,EAAE,MAAM,CAAC;IAChC,uDAAuD;IACvD,wBAAwB,EAAE,MAAM,CAAC;IACjC,kCAAkC;IAClC,wBAAwB,EAAE,MAAM,CAAC;IACjC,4BAA4B;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iCAAiC;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,+DAA+D;IAC/D,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,CA2D9B;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACxC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC,OAAO,CAAC,MAAM,CAAC,CAoCjB"}