@runcore-sh/runcore 0.1.2

package/dist/metrics/reporter.js

@@ -0,0 +1,207 @@
+/**
+ * Metrics reporter — dashboard snapshots and alert evaluation.
+ * Follows health/checker.ts pattern: configurable thresholds, aggregated output.
+ */
+import { logActivity } from "../activity/log.js";
+const startTime = Date.now();
+// ─── Alert state ─────────────────────────────────────────────────────────────
+const thresholds = [];
+const recentAlerts = [];
+const MAX_RECENT_ALERTS = 50;
+/** Cooldown: don't fire the same alert more than once per window. */
+const alertCooldowns = new Map();
+// ─── Default thresholds ──────────────────────────────────────────────────────
+/** Register built-in alert thresholds for common system metrics. */
+export function registerDefaultThresholds() {
+    registerThreshold({
+        metric: "system.cpu.percent",
+        warnAbove: 80,
+        critAbove: 95,
+        minSamples: 3,
+        windowMs: 120_000,
+    });
+    registerThreshold({
+        metric: "system.memory.rss",
+        warnAbove: 512 * 1024 * 1024, // 512 MB
+        critAbove: 1024 * 1024 * 1024, // 1 GB
+        minSamples: 2,
+        windowMs: 60_000,
+    });
+    registerThreshold({
+        metric: "system.event_loop.drift",
+        warnAbove: 100,
+        critAbove: 500,
+        minSamples: 3,
+        windowMs: 120_000,
+    });
+    registerThreshold({
+        metric: "http.request.latency.p95",
+        warnAbove: 2000,
+        critAbove: 5000,
+        minSamples: 5,
+        windowMs: 120_000,
+    });
+    registerThreshold({
+        metric: "error.total",
+        warnAbove: 10,
+        critAbove: 50,
+        minSamples: 1,
+        windowMs: 300_000,
+    });
+}
+// ─── Threshold management ────────────────────────────────────────────────────
+/** Register an alert threshold. */
+export function registerThreshold(t) {
+    thresholds.push(t);
+}
+/** Clear all thresholds. */
+export function clearThresholds() {
+    thresholds.length = 0;
+}
+/** Get all registered thresholds. */
+export function getThresholds() {
+    return thresholds;
+}
+// ─── Alert evaluation ────────────────────────────────────────────────────────
+/** Evaluate all thresholds against current data. Returns newly fired alerts. */
+export async function evaluateAlerts(store) {
+    const fired = [];
+    const now = Date.now();
+    for (const t of thresholds) {
+        const windowMs = t.windowMs ?? 60_000;
+        const since = new Date(now - windowMs).toISOString();
+        const points = await store.query({ name: t.metric, tags: t.tags, since });
+        if (points.length < (t.minSamples ?? 1))
+            continue;
+        // Use the average value over the window for evaluation
+        const avg = points.reduce((s, p) => s + p.value, 0) / points.length;
+        const cooldownKey = `${t.metric}:${JSON.stringify(t.tags ?? {})}`;
+        // Check critical first, then warn
+        const checks = [];
+        if (t.critAbove != null && avg > t.critAbove) {
+            checks.push({ severity: "crit", value: avg, threshold: t.critAbove, direction: "above" });
+        }
+        else if (t.warnAbove != null && avg > t.warnAbove) {
+            checks.push({ severity: "warn", value: avg, threshold: t.warnAbove, direction: "above" });
+        }
+        if (t.critBelow != null && avg < t.critBelow) {
+            checks.push({ severity: "crit", value: avg, threshold: t.critBelow, direction: "below" });
+        }
+        else if (t.warnBelow != null && avg < t.warnBelow) {
+            checks.push({ severity: "warn", value: avg, threshold: t.warnBelow, direction: "below" });
+        }
+        for (const check of checks) {
+            // Cooldown: skip if recently fired
+            const lastFired = alertCooldowns.get(`${cooldownKey}:${check.severity}`);
+            if (lastFired && now - lastFired < windowMs)
+                continue;
+            const alert = {
+                timestamp: new Date().toISOString(),
+                severity: check.severity,
+                metric: t.metric,
+                value: Math.round(check.value * 100) / 100,
+                threshold: check.threshold,
+                message: `${t.metric} is ${check.direction} ${check.severity} threshold: ${formatValue(check.value, points[0]?.unit)} > ${formatValue(check.threshold, points[0]?.unit)}`,
+                tags: t.tags,
+            };
+            fired.push(alert);
+            recentAlerts.push(alert);
+            alertCooldowns.set(`${cooldownKey}:${check.severity}`, now);
+            // Trim recent alerts
+            while (recentAlerts.length > MAX_RECENT_ALERTS) {
+                recentAlerts.shift();
+            }
+            // Log to activity
+            logActivity({
+                source: "system",
+                summary: `Alert [${check.severity}]: ${alert.message}`,
+            });
+        }
+    }
+    return fired;
+}
+/** Get recent alerts. */
+export function getRecentAlerts(limit) {
+    const n = limit ?? MAX_RECENT_ALERTS;
+    return recentAlerts.slice(-n);
+}
+// ─── Dashboard ───────────────────────────────────────────────────────────────
+/** Build a dashboard snapshot from the metrics store. */
+export async function buildDashboard(store) {
+    const now = new Date().toISOString();
+    const windowMs = 300_000; // 5-minute window for dashboard
+    // System metrics: most recent values
+    const cpuPoints = await store.query({ name: "system.cpu.percent", limit: 1 });
+    const heapUsedPoints = await store.query({ name: "system.memory.heap_used", limit: 1 });
+    const heapTotalPoints = await store.query({ name: "system.memory.heap_total", limit: 1 });
+    const rssPoints = await store.query({ name: "system.memory.rss", limit: 1 });
+    const driftPoints = await store.query({ name: "system.event_loop.drift", limit: 1 });
+    // HTTP: aggregate over window
+    const httpLatency = await store.summarize("http.request.latency.avg", { windowMs });
+    const httpCountPoints = await store.query({
+        name: "http.request.count",
+        since: new Date(Date.now() - windowMs).toISOString(),
+    });
+    const httpErrorPoints = await store.query({
+        name: "http.request.error_count",
+        since: new Date(Date.now() - windowMs).toISOString(),
+    });
+    const totalRequests = httpCountPoints.reduce((s, p) => s + p.value, 0);
+    const totalErrors = httpErrorPoints.reduce((s, p) => s + p.value, 0);
+    // Agent: aggregate over window
+    const agentSpawnPoints = await store.query({
+        name: "agent.spawn.count",
+        since: new Date(Date.now() - windowMs).toISOString(),
+    });
+    const agentCompletePoints = await store.query({
+        name: "agent.complete.count",
+        since: new Date(Date.now() - windowMs).toISOString(),
+    });
+    const agentFailPoints = await store.query({
+        name: "agent.fail.count",
+        since: new Date(Date.now() - windowMs).toISOString(),
+    });
+    const agentDurationSummary = await store.summarize("agent.duration.avg", { windowMs });
+    return {
+        timestamp: now,
+        uptime: Date.now() - startTime,
+        system: {
+            cpuPercent: last(cpuPoints)?.value ?? 0,
+            heapUsedMB: Math.round((last(heapUsedPoints)?.value ?? 0) / 1024 / 1024),
+            heapTotalMB: Math.round((last(heapTotalPoints)?.value ?? 0) / 1024 / 1024),
+            rssMB: Math.round((last(rssPoints)?.value ?? 0) / 1024 / 1024),
+            eventLoopDriftMs: last(driftPoints)?.value ?? 0,
+        },
+        http: {
+            totalRequests,
+            errorRate: totalRequests > 0 ? totalErrors / totalRequests : 0,
+            latency: httpLatency,
+        },
+        agents: {
+            totalSpawned: agentSpawnPoints.reduce((s, p) => s + p.value, 0),
+            totalCompleted: agentCompletePoints.reduce((s, p) => s + p.value, 0),
+            totalFailed: agentFailPoints.reduce((s, p) => s + p.value, 0),
+            avgDurationMs: agentDurationSummary?.avg ?? 0,
+        },
+        recentAlerts: getRecentAlerts(10),
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function last(arr) {
+    return arr.length > 0 ? arr[arr.length - 1] : undefined;
+}
+function formatValue(value, unit) {
+    if (unit === "bytes") {
+        if (value > 1024 * 1024 * 1024)
+            return `${(value / (1024 * 1024 * 1024)).toFixed(1)}GB`;
+        if (value > 1024 * 1024)
+            return `${(value / (1024 * 1024)).toFixed(1)}MB`;
+        return `${(value / 1024).toFixed(1)}KB`;
+    }
+    if (unit === "ms")
+        return `${Math.round(value)}ms`;
+    if (unit === "%")
+        return `${value.toFixed(1)}%`;
+    return String(Math.round(value * 100) / 100);
+}
+//# sourceMappingURL=reporter.js.map

package/dist/metrics/reporter.js.map

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

package/dist/metrics/store.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Time-series metrics store with JSONL persistence and rotation.
+ * Follows queue/store.ts pattern: append-only JSONL, lazy load + cache, periodic compaction.
+ * All metrics encrypted at rest via brain-io.
+ */
+import type { MetricPoint, MetricSummary, RotationConfig } from "./types.js";
+export declare class MetricsStore {
+    private readonly filePath;
+    private cache;
+    private readonly maxPoints;
+    private readonly maxAgeMs;
+    private appendsSinceLoad;
+    private rotating;
+    private rotationBuffer;
+    constructor(brainDir: string, config?: RotationConfig);
+    /** Append a metric data point. Writes to disk immediately. */
+    record(point: MetricPoint): Promise<void>;
+    /** Append multiple points in a single write. */
+    recordBatch(points: MetricPoint[]): Promise<void>;
+    /** Query points by name and/or time range. */
+    query(opts?: {
+        name?: string;
+        tags?: Record<string, string>;
+        since?: string;
+        until?: string;
+        limit?: number;
+    }): Promise<MetricPoint[]>;
+    /** Compute an aggregate summary for a named metric within a window. */
+    summarize(name: string, opts?: {
+        tags?: Record<string, string>;
+        windowMs?: number;
+    }): Promise<MetricSummary | null>;
+    /** Rotate: drop old/excess points, rewrite file. Returns points removed. */
+    rotate(): Promise<{
+        before: number;
+        after: number;
+    }>;
+    /** Check if rotation is needed (heuristic: >50% over max or old appends). */
+    shouldRotate(): boolean;
+    /** Get approximate number of data points. */
+    pointCount(): Promise<number>;
+    /** Return distinct metric names in the store. */
+    metricNames(): Promise<string[]>;
+    private load;
+    private ensureFile;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/metrics/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/metrics/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAM7E,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAqB;gBAE/B,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc;IAMrD,8DAA8D;IACxD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/C,gDAAgD;IAC1C,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvD,8CAA8C;IACxC,KAAK,CAAC,IAAI,CAAC,EAAE;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA0B1B,uEAAuE;IACjE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA+BjC,4EAA4E;IACtE,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IA2C1D,6EAA6E;IAC7E,YAAY,IAAI,OAAO;IAKvB,6CAA6C;IACvC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAKnC,iDAAiD;IAC3C,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAOxB,IAAI;YAoBJ,UAAU;CASzB"}

package/dist/metrics/store.js

@@ -0,0 +1,209 @@
+/**
+ * Time-series metrics store with JSONL persistence and rotation.
+ * Follows queue/store.ts pattern: append-only JSONL, lazy load + cache, periodic compaction.
+ * All metrics encrypted at rest via brain-io.
+ */
+import { mkdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { readBrainLines, appendBrainLine, writeBrainLines } from "../lib/brain-io.js";
+const SCHEMA_HEADER = JSON.stringify({ _schema: "metrics", _version: "1.0" });
+const DEFAULT_MAX_POINTS = 10_000;
+const DEFAULT_MAX_AGE_MS = 24 * 60 * 60 * 1000; // 24 hours
+export class MetricsStore {
+    filePath;
+    cache = null;
+    maxPoints;
+    maxAgeMs;
+    appendsSinceLoad = 0;
+    rotating = false;
+    rotationBuffer = [];
+    constructor(brainDir, config) {
+        this.filePath = join(brainDir, "metrics", "metrics.jsonl");
+        this.maxPoints = config?.maxPoints ?? DEFAULT_MAX_POINTS;
+        this.maxAgeMs = config?.maxAgeMs ?? DEFAULT_MAX_AGE_MS;
+    }
+    /** Append a metric data point. Writes to disk immediately. */
+    async record(point) {
+        if (this.rotating) {
+            this.rotationBuffer.push(point);
+            return;
+        }
+        await this.ensureFile();
+        await appendBrainLine(this.filePath, JSON.stringify(point));
+        if (this.cache) {
+            this.cache.push(point);
+        }
+        this.appendsSinceLoad++;
+    }
+    /** Append multiple points in a single write. */
+    async recordBatch(points) {
+        if (points.length === 0)
+            return;
+        // Buffer writes during rotation to prevent race condition:
+        // rotate() reads snapshot → writeBrainLines overwrites file →
+        // any appends between those two steps would be lost.
+        if (this.rotating) {
+            this.rotationBuffer.push(...points);
+            return;
+        }
+        await this.ensureFile();
+        for (const p of points) {
+            await appendBrainLine(this.filePath, JSON.stringify(p));
+        }
+        if (this.cache) {
+            this.cache.push(...points);
+        }
+        this.appendsSinceLoad += points.length;
+    }
+    /** Query points by name and/or time range. */
+    async query(opts) {
+        const all = await this.load();
+        let filtered = all;
+        if (opts?.name) {
+            filtered = filtered.filter((p) => p.name === opts.name);
+        }
+        if (opts?.tags) {
+            const tagEntries = Object.entries(opts.tags);
+            filtered = filtered.filter((p) => p.tags != null && tagEntries.every(([k, v]) => p.tags[k] === v));
+        }
+        if (opts?.since) {
+            filtered = filtered.filter((p) => p.timestamp >= opts.since);
+        }
+        if (opts?.until) {
+            filtered = filtered.filter((p) => p.timestamp <= opts.until);
+        }
+        if (opts?.limit && opts.limit > 0) {
+            filtered = filtered.slice(-opts.limit);
+        }
+        return filtered;
+    }
+    /** Compute an aggregate summary for a named metric within a window. */
+    async summarize(name, opts) {
+        const windowMs = opts?.windowMs ?? 60_000;
+        const cutoff = new Date(Date.now() - windowMs).toISOString();
+        const points = await this.query({
+            name,
+            tags: opts?.tags,
+            since: cutoff,
+        });
+        if (points.length === 0)
+            return null;
+        const values = points.map((p) => p.value).sort((a, b) => a - b);
+        const sum = values.reduce((acc, v) => acc + v, 0);
+        return {
+            name,
+            count: values.length,
+            sum,
+            min: values[0],
+            max: values[values.length - 1],
+            avg: sum / values.length,
+            p50: percentile(values, 50),
+            p95: percentile(values, 95),
+            p99: percentile(values, 99),
+            unit: points[0].unit,
+            tags: opts?.tags,
+            windowStart: cutoff,
+            windowEnd: new Date().toISOString(),
+        };
+    }
+    /** Rotate: drop old/excess points, rewrite file. Returns points removed. */
+    async rotate() {
+        this.rotating = true;
+        try {
+            const all = await this.load();
+            const before = all.length;
+            const cutoff = new Date(Date.now() - this.maxAgeMs).toISOString();
+            let kept = all.filter((p) => p.timestamp >= cutoff);
+            if (kept.length > this.maxPoints) {
+                kept = kept.slice(kept.length - this.maxPoints);
+            }
+            const lines = [SCHEMA_HEADER, ...kept.map((p) => JSON.stringify(p))];
+            await writeBrainLines(this.filePath, lines);
+            this.cache = kept;
+            this.appendsSinceLoad = 0;
+            // Flush buffer WHILE STILL HOLDING the rotation flag —
+            // prevents concurrent recordBatch() calls from racing with the flush.
+            if (this.rotationBuffer.length > 0) {
+                const buffered = this.rotationBuffer.splice(0);
+                try {
+                    for (const p of buffered) {
+                        await appendBrainLine(this.filePath, JSON.stringify(p));
+                    }
+                    if (this.cache) {
+                        this.cache.push(...buffered);
+                    }
+                    this.appendsSinceLoad += buffered.length;
+                }
+                catch {
+                    // Restore unwritten points to buffer for retry on next cycle
+                    this.rotationBuffer.unshift(...buffered);
+                }
+            }
+            return { before, after: kept.length };
+        }
+        finally {
+            // Flag reset is the LAST thing that happens
+            this.rotating = false;
+        }
+    }
+    /** Check if rotation is needed (heuristic: >50% over max or old appends). */
+    shouldRotate() {
+        if (!this.cache)
+            return this.appendsSinceLoad > this.maxPoints;
+        return this.cache.length > this.maxPoints * 1.5 || this.appendsSinceLoad > this.maxPoints;
+    }
+    /** Get approximate number of data points. */
+    async pointCount() {
+        const all = await this.load();
+        return all.length;
+    }
+    /** Return distinct metric names in the store. */
+    async metricNames() {
+        const all = await this.load();
+        return [...new Set(all.map((p) => p.name))];
+    }
+    // ─── Internal ───────────────────────────────────────────────────────────────
+    async load() {
+        if (this.cache)
+            return this.cache;
+        const lines = await readBrainLines(this.filePath);
+        const points = [];
+        for (const line of lines) {
+            try {
+                const obj = JSON.parse(line);
+                if (obj._schema)
+                    continue;
+                points.push(obj);
+            }
+            catch {
+                // skip malformed lines
+            }
+        }
+        this.cache = points;
+        return points;
+    }
+    async ensureFile() {
+        try {
+            await stat(this.filePath);
+        }
+        catch {
+            const dir = join(this.filePath, "..");
+            await mkdir(dir, { recursive: true });
+            await appendBrainLine(this.filePath, SCHEMA_HEADER);
+        }
+    }
+}
+/** Calculate percentile from a sorted array. */
+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=store.js.map

package/dist/metrics/store.js.map

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

package/dist/metrics/system.d.ts

@@ -0,0 +1,20 @@
+/**
+ * System metrics collection — memory, CPU, and disk usage.
+ * Extracts system-level metric gathering into a dedicated module
+ * for use by the collector and Prometheus exposition.
+ */
+import type { MetricPoint } from "./types.js";
+/** Initialize the CPU baseline. Call once at collector start. */
+export declare function initCpuBaseline(): void;
+/** Collect process memory metrics (heap used, heap total, RSS, external). */
+export declare function collectMemoryMetrics(timestamp: string): MetricPoint[];
+/** Collect CPU usage as a percentage since the last call. */
+export declare function collectCpuMetrics(timestamp: string): MetricPoint[];
+/** Collect disk usage for the brain/ directory. */
+export declare function collectDiskMetrics(timestamp: string, brainDir?: string): Promise<MetricPoint[]>;
+/**
+ * Collect all system metrics: memory, CPU, and disk.
+ * Returns an array of MetricPoints ready for the store.
+ */
+export declare function collectSystemMetrics(timestamp: string, brainDir?: string): Promise<MetricPoint[]>;
+//# sourceMappingURL=system.d.ts.map

package/dist/metrics/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/metrics/system.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAc9C,iEAAiE;AACjE,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAID,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAerE;AAID,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAoBlE;AAiCD,mDAAmD;AACnD,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAYxB;AAID;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAMxB"}

package/dist/metrics/system.js

@@ -0,0 +1,109 @@
+/**
+ * System metrics collection — memory, CPU, and disk usage.
+ * Extracts system-level metric gathering into a dedicated module
+ * for use by the collector and Prometheus exposition.
+ */
+import { join } from "node:path";
+import { readdir, stat } from "node:fs/promises";
+import { memoryUsageBytes, cpuUsagePercent, diskUsageBytes, } from "./prometheus.js";
+// ─── CPU state ───────────────────────────────────────────────────────────────
+let lastCpuUsage = null;
+let lastCpuTime = 0;
+const DEFAULT_INTERVAL_MS = 30_000;
+/** Initialize the CPU baseline. Call once at collector start. */
+export function initCpuBaseline() {
+    lastCpuUsage = process.cpuUsage();
+    lastCpuTime = performance.now();
+}
+// ─── Memory ──────────────────────────────────────────────────────────────────
+/** Collect process memory metrics (heap used, heap total, RSS, external). */
+export function collectMemoryMetrics(timestamp) {
+    const mem = process.memoryUsage();
+    // Update Prometheus gauges
+    memoryUsageBytes.set({ type: "heap_used" }, mem.heapUsed);
+    memoryUsageBytes.set({ type: "heap_total" }, mem.heapTotal);
+    memoryUsageBytes.set({ type: "rss" }, mem.rss);
+    memoryUsageBytes.set({ type: "external" }, mem.external);
+    return [
+        { timestamp, name: "system.memory.heap_used", value: mem.heapUsed, unit: "bytes" },
+        { timestamp, name: "system.memory.heap_total", value: mem.heapTotal, unit: "bytes" },
+        { timestamp, name: "system.memory.rss", value: mem.rss, unit: "bytes" },
+        { timestamp, name: "system.memory.external", value: mem.external, unit: "bytes" },
+    ];
+}
+// ─── CPU ─────────────────────────────────────────────────────────────────────
+/** Collect CPU usage as a percentage since the last call. */
+export function collectCpuMetrics(timestamp) {
+    const cpuUsage = process.cpuUsage(lastCpuUsage ?? undefined);
+    const elapsed = lastCpuTime ? performance.now() - lastCpuTime : DEFAULT_INTERVAL_MS;
+    const cpuPercent = elapsed > 0
+        ? ((cpuUsage.user + cpuUsage.system) / 1000) / elapsed * 100
+        : 0;
+    // Update baseline
+    lastCpuUsage = process.cpuUsage();
+    lastCpuTime = performance.now();
+    const rounded = Math.round(cpuPercent * 100) / 100;
+    cpuUsagePercent.set(undefined, rounded);
+    return [{
+            timestamp,
+            name: "system.cpu.percent",
+            value: rounded,
+            unit: "%",
+        }];
+}
+// ─── Disk ────────────────────────────────────────────────────────────────────
+/**
+ * Recursively calculate the total size of a directory in bytes.
+ * Skips entries that can't be stat'd (permission errors, broken symlinks).
+ */
+async function dirSize(dirPath) {
+    let total = 0;
+    let entries;
+    try {
+        entries = await readdir(dirPath);
+    }
+    catch {
+        return 0;
+    }
+    for (const entry of entries) {
+        const fullPath = join(dirPath, entry);
+        try {
+            const s = await stat(fullPath);
+            if (s.isDirectory()) {
+                total += await dirSize(fullPath);
+            }
+            else {
+                total += s.size;
+            }
+        }
+        catch {
+            // Skip inaccessible entries
+        }
+    }
+    return total;
+}
+/** Collect disk usage for the brain/ directory. */
+export async function collectDiskMetrics(timestamp, brainDir) {
+    const dir = brainDir ?? join(process.cwd(), "brain");
+    const bytes = await dirSize(dir);
+    diskUsageBytes.set(undefined, bytes);
+    return [{
+            timestamp,
+            name: "system.disk.brain_bytes",
+            value: bytes,
+            unit: "bytes",
+        }];
+}
+// ─── Combined ────────────────────────────────────────────────────────────────
+/**
+ * Collect all system metrics: memory, CPU, and disk.
+ * Returns an array of MetricPoints ready for the store.
+ */
+export async function collectSystemMetrics(timestamp, brainDir) {
+    const points = [];
+    points.push(...collectMemoryMetrics(timestamp));
+    points.push(...collectCpuMetrics(timestamp));
+    points.push(...await collectDiskMetrics(timestamp, brainDir));
+    return points;
+}
+//# sourceMappingURL=system.js.map

package/dist/metrics/system.js.map

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