@runcore-sh/runcore 0.1.2

package/dist/pulse/pressure.js

@@ -0,0 +1,304 @@
+/**
+ * PressureIntegrator — the nervous system of Core.
+ *
+ * Accumulates voltage from events, decays exponentially over time,
+ * and fires a pulse (checkForWork) when tension crosses the threshold.
+ * Silent when idle, instantly responsive under pressure.
+ *
+ * Core metaphor: Action Potential.
+ *   Events → voltage accumulation → Θ exceeded → pulse → refractory cooldown
+ */
+import { createLogger } from "../utils/logger.js";
+import { logActivity } from "../activity/log.js";
+import { appendFileSync } from "node:fs";
+import { join } from "node:path";
+import { emitVoltage, emitCdt, bridgeVoltageSystem, unbridgeVoltageSystem } from "./activation-event.js";
+const log = createLogger("pulse");
+// ─── Voltage weights (source → base mV) ─────────────────────────────────────
+const VOLTAGE_WEIGHTS = [
+    { source: "agent", weight: 50, keywords: ["fail", "error", "crash", "exception"] },
+    { source: "system", weight: 20, keywords: ["commit", "push", "merge"] },
+    { source: "open-loop", weight: 25 },
+    { source: "board", weight: 70, keywords: ["created", "todo"] }, // new work → cross threshold immediately
+    { source: "autonomous", weight: 5 },
+    { source: "scheduling", weight: 40, keywords: ["overdue", "missed", "deadline", "skipped"] },
+];
+const USER_CHAT_WEIGHT = 30;
+const DEFAULT_WEIGHT = 5;
+const VOLTAGE_HISTORY_MAX = 100;
+const VOLTAGE_HISTORY_PATH = join(process.cwd(), "brain", "metrics", "voltage-history.jsonl");
+function resolveWeight(source, summary) {
+    // Agent failures are highest priority — but only if it actually failed
+    if (source === "agent") {
+        const isFail = /fail|error|crash|exception/i.test(summary);
+        return isFail ? 50 : DEFAULT_WEIGHT;
+    }
+    for (const entry of VOLTAGE_WEIGHTS) {
+        if (entry.source !== source)
+            continue;
+        if (!entry.keywords)
+            return entry.weight;
+        const hasKeyword = entry.keywords.some((kw) => summary.toLowerCase().includes(kw));
+        return hasKeyword ? entry.weight : DEFAULT_WEIGHT;
+    }
+    return DEFAULT_WEIGHT;
+}
+// ─── Defaults ────────────────────────────────────────────────────────────────
+const DEFAULT_CONFIG = {
+    threshold: 60,
+    refractoryMs: 60_000,
+    relativeRefractoryMs: 300_000,
+    decayLambda: 0.000001, // per-ms — half-life ≈ 11.5 minutes
+    basalLeakMv: 10,
+    basalLeakIntervalMs: 3_600_000, // 1 hour — just a boredom drip, real triggers are event-driven
+};
+// ─── Singleton ───────────────────────────────────────────────────────────────
+let instance = null;
+export function getPressureIntegrator() {
+    return instance;
+}
+export function initPressureIntegrator(pulseFn, config) {
+    if (instance) {
+        instance.shutdown();
+    }
+    instance = new PressureIntegrator(pulseFn, config);
+    return instance;
+}
+// ─── Class ───────────────────────────────────────────────────────────────────
+export class PressureIntegrator {
+    voltage = 0;
+    lastDecayAt = Date.now();
+    lastPulseAt = 0;
+    refractoryUntil = 0;
+    pulseCount = 0;
+    recentEventCount = 0;
+    recentEventWindowStart = Date.now();
+    config;
+    pulseFn;
+    basalLeakTimer = null;
+    /** Ring buffer for voltage snapshots (Gap 8.1 — voltage attribution). */
+    voltageHistory = [];
+    historyHead = 0;
+    historySize = 0;
+    constructor(pulseFn, config) {
+        this.pulseFn = pulseFn;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.startBasalLeak();
+        // DASH-102: Register as the voltage bridge so CDT events can contribute tension
+        bridgeVoltageSystem({
+            contribute: (amount) => {
+                this.voltage += amount;
+                log.debug(`Bridge +${amount}mV: voltage=${this.voltage.toFixed(1)}/${this.getEffectiveThreshold()}`);
+                this.maybeFirePulse();
+            },
+            readVoltage: () => {
+                this.applyDecay();
+                return this.voltage;
+            },
+        });
+        log.info(`Initialized: Θ=${this.config.threshold}mV, λ=${this.config.decayLambda}, refractory=${this.config.refractoryMs}ms`);
+    }
+    /** Feed an event into the pressure system. */
+    addTension(source, summary) {
+        // Special handling: user chat messages are detected by the caller
+        const weight = source === "user-chat" ? USER_CHAT_WEIGHT : resolveWeight(source, summary);
+        this.applyDecay();
+        this.voltage += weight;
+        this.recentEventCount++;
+        // Reset event window every hour
+        const now = Date.now();
+        if (now - this.recentEventWindowStart > 3_600_000) {
+            this.recentEventCount = 1;
+            this.recentEventWindowStart = now;
+        }
+        log.debug(`+${weight}mV (${source}): voltage=${this.voltage.toFixed(1)}/${this.getEffectiveThreshold()}`);
+        // Record snapshot before checking pulse (fired flag set by firePulse snapshot)
+        this.recordSnapshot(source, weight, false);
+        this.maybeFirePulse();
+    }
+    /** Manually inject voltage (used for user chat detection from server.ts). */
+    addUserChatTension() {
+        this.addTension("user-chat", "user chat message");
+    }
+    /**
+     * Accept a CDT (cognitive dissonance threshold) event.
+     * Delegates to the unified ActivationEvent primitive (DASH-102).
+     *
+     * @deprecated Prefer calling `emitCdt()` from `pulse/activation-event.ts` directly.
+     *   This method is kept for backward compatibility during migration.
+     */
+    addCdtTension(triggerId, sourceKey, opts) {
+        emitCdt({
+            triggerId,
+            sourceKey,
+            anchor: opts?.anchor,
+            loopsInvolved: opts?.loopsInvolved,
+            voltageContribution: opts?.voltageContribution,
+        });
+    }
+    /** Get current system status for API/HUD. */
+    getStatus() {
+        this.applyDecay();
+        const now = Date.now();
+        const effectiveThreshold = this.getEffectiveThreshold();
+        let state = "ready";
+        let refractoryRemaining = 0;
+        if (now < this.refractoryUntil) {
+            refractoryRemaining = this.refractoryUntil - now;
+            // Check if in absolute or relative refractory
+            const absoluteEnd = this.lastPulseAt + this.config.refractoryMs;
+            state = now < absoluteEnd ? "refractory" : "relative-refractory";
+        }
+        // Decay rate in mV/hour: d(voltage)/dt = -λ * voltage, so rate = λ * voltage * 3600000
+        const decayRate = this.config.decayLambda * this.voltage * 3_600_000;
+        return {
+            voltage: Math.round(this.voltage * 10) / 10,
+            threshold: this.config.threshold,
+            effectiveThreshold,
+            refractoryRemaining: Math.round(refractoryRemaining),
+            lastPulseAge: this.lastPulseAt > 0 ? now - this.lastPulseAt : -1,
+            pulseCount: this.pulseCount,
+            decayRate: Math.round(decayRate * 10) / 10,
+            state,
+        };
+    }
+    /** Update threshold (e.g. from settings change). */
+    setThreshold(theta) {
+        this.config.threshold = theta;
+        log.info(`Threshold updated: Θ=${theta}mV`);
+    }
+    /** Return voltage history ordered oldest → newest. */
+    getVoltageHistory() {
+        if (this.historySize === 0)
+            return [];
+        if (this.historySize < VOLTAGE_HISTORY_MAX) {
+            return this.voltageHistory.slice(0, this.historySize);
+        }
+        // Ring buffer wrap: [head..end, 0..head)
+        return [
+            ...this.voltageHistory.slice(this.historyHead),
+            ...this.voltageHistory.slice(0, this.historyHead),
+        ];
+    }
+    /** Clean up timers, unbridge voltage, and persist voltage history. */
+    shutdown() {
+        if (this.basalLeakTimer) {
+            clearInterval(this.basalLeakTimer);
+            this.basalLeakTimer = null;
+        }
+        unbridgeVoltageSystem();
+        this.persistVoltageHistory();
+        log.info("Shut down");
+    }
+    // ─── Private ─────────────────────────────────────────────────────────────
+    applyDecay() {
+        const now = Date.now();
+        const elapsed = now - this.lastDecayAt;
+        if (elapsed <= 0)
+            return;
+        // Exponential decay: voltage *= e^(-λ * elapsed)
+        this.voltage *= Math.exp(-this.config.decayLambda * elapsed);
+        // Floor tiny values to zero
+        if (this.voltage < 0.1)
+            this.voltage = 0;
+        this.lastDecayAt = now;
+    }
+    getEffectiveThreshold() {
+        const now = Date.now();
+        if (now < this.refractoryUntil && now >= this.lastPulseAt + this.config.refractoryMs) {
+            // Relative refractory: threshold doubles
+            return this.config.threshold * 2;
+        }
+        return this.config.threshold;
+    }
+    maybeFirePulse() {
+        const now = Date.now();
+        // Absolute refractory: cannot fire at all
+        if (now < this.lastPulseAt + this.config.refractoryMs)
+            return;
+        const effectiveThreshold = this.getEffectiveThreshold();
+        if (this.voltage < effectiveThreshold)
+            return;
+        this.firePulse();
+    }
+    firePulse() {
+        const now = Date.now();
+        this.pulseCount++;
+        this.lastPulseAt = now;
+        this.refractoryUntil = now + this.config.refractoryMs + this.config.relativeRefractoryMs;
+        // Snapshot voltage before drain for the activation event
+        const preDrainVoltage = this.voltage;
+        // Drain voltage by 50% — unaddressed tension persists
+        this.voltage *= 0.5;
+        log.info(`PULSE #${this.pulseCount} fired at ${this.voltage.toFixed(1)}mV (post-drain). Refractory until +${this.config.refractoryMs}ms absolute, +${this.config.relativeRefractoryMs}ms relative`);
+        // Record pulse-fired snapshot (delta is the drain amount, negative)
+        this.recordSnapshot("pulse-fired", -(preDrainVoltage * 0.5), true);
+        // DASH-102: Emit voltage activation via unified primitive
+        emitVoltage({
+            triggerId: `pulse_${this.pulseCount}`,
+            anchor: `Metabolic pulse #${this.pulseCount}`,
+            voltageAtTrigger: Math.round(preDrainVoltage * 10) / 10,
+        });
+        logActivity({
+            source: "system",
+            summary: `Metabolic pulse #${this.pulseCount} fired — tension threshold crossed`,
+            actionLabel: "AUTONOMOUS",
+            reason: "pressure integrator threshold exceeded",
+        });
+        // Fire the pulse function asynchronously — don't block the event that triggered it
+        this.pulseFn().catch((err) => {
+            log.error(`Pulse function error: ${err instanceof Error ? err.message : String(err)}`);
+        });
+    }
+    recordSnapshot(source, delta, fired) {
+        const snap = {
+            timestamp: new Date().toISOString(),
+            voltage: Math.round(this.voltage * 10) / 10,
+            source,
+            delta: Math.round(delta * 10) / 10,
+            fired,
+            refractory: Date.now() < this.refractoryUntil,
+        };
+        if (this.historySize < VOLTAGE_HISTORY_MAX) {
+            this.voltageHistory.push(snap);
+            this.historySize++;
+        }
+        else {
+            this.voltageHistory[this.historyHead] = snap;
+            this.historyHead = (this.historyHead + 1) % VOLTAGE_HISTORY_MAX;
+        }
+    }
+    persistVoltageHistory() {
+        const history = this.getVoltageHistory();
+        if (history.length === 0)
+            return;
+        try {
+            const lines = history.map((s) => JSON.stringify(s)).join("\n") + "\n";
+            appendFileSync(VOLTAGE_HISTORY_PATH, lines, "utf-8");
+            log.info(`Persisted ${history.length} voltage snapshots to ${VOLTAGE_HISTORY_PATH}`);
+        }
+        catch (err) {
+            log.error(`Failed to persist voltage history: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Board-aware basal leak — checks every 15min.
+     *
+     * Slow background drip for total silence. Only matters when zero
+     * events are flowing. Real work triggers come from logActivity →
+     * addTension (event-driven, not polled).
+     */
+    startBasalLeak() {
+        this.basalLeakTimer = setInterval(() => {
+            if (this.recentEventCount >= 5) {
+                log.debug(`Basal leak skipped: ${this.recentEventCount} events in window`);
+                return;
+            }
+            this.applyDecay();
+            this.voltage += this.config.basalLeakMv;
+            log.debug(`Basal leak: +${this.config.basalLeakMv}mV → ${this.voltage.toFixed(1)}mV`);
+            this.maybeFirePulse();
+        }, this.config.basalLeakIntervalMs);
+    }
+}
+//# sourceMappingURL=pressure.js.map

package/dist/pulse/pressure.js.map

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

package/dist/pulse/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Metabolic Pulse — type definitions.
+ * Tension-based heartbeat that replaces the fixed-interval autonomous timer.
+ */
+export interface PulseConfig {
+    threshold: number;
+    refractoryMs: number;
+    relativeRefractoryMs: number;
+    decayLambda: number;
+    basalLeakMv: number;
+    basalLeakIntervalMs: number;
+}
+export interface PulseStatus {
+    voltage: number;
+    threshold: number;
+    effectiveThreshold: number;
+    refractoryRemaining: number;
+    lastPulseAge: number;
+    pulseCount: number;
+    decayRate: number;
+    state: "ready" | "refractory" | "relative-refractory";
+}
+export interface VoltageWeight {
+    source: string;
+    baseWeight: number;
+    keywords?: string[];
+}
+/**
+ * VoltageSnapshot — a point-in-time record of voltage state.
+ * Stored in a ring buffer for debugging pulse behavior and
+ * retrospective voltage attribution (Gap 8.1).
+ */
+export interface VoltageSnapshot {
+    timestamp: string;
+    voltage: number;
+    source: string;
+    delta: number;
+    fired: boolean;
+    refractory: boolean;
+}
+/**
+ * Unified ActivationEvent — bridges voltage and CDT activation mechanisms.
+ * Discriminated union: type-specific fields enable precise handling while
+ * sharing a common base for the unified activation log.
+ *
+ * DASH-92: deepest architectural seam — semantic CDT actions must be
+ * visible to the voltage layer for refractory enforcement and retrospective analysis.
+ *
+ * DASH-102: promoted to a first-class primitive with factory functions,
+ * centralized emission, and subscriber pattern. CDT sources emit directly
+ * without coupling to PressureIntegrator.
+ */
+/** Shared fields for all activation events. */
+export interface ActivationEventBase {
+    triggerId: string;
+    anchor?: string;
+    voltageAtTrigger?: number;
+    timestamp: string;
+}
+/** A voltage pulse fired by PressureIntegrator when Θ is crossed. */
+export interface VoltageActivation extends ActivationEventBase {
+    type: "voltage";
+}
+/** A semantic CDT event from OLP resonance, trace insights, goal loop, etc. */
+export interface CdtActivation extends ActivationEventBase {
+    type: "cdt";
+    sourceKey?: string;
+    loopsInvolved?: string[];
+    voltageContribution?: number;
+}
+/** Discriminated union — the unified ActivationEvent primitive. */
+export type ActivationEvent = VoltageActivation | CdtActivation;
+/** Options for emitting a CDT activation event. */
+export interface EmitCdtOptions {
+    triggerId: string;
+    sourceKey: string;
+    anchor?: string;
+    loopsInvolved?: string[];
+    voltageContribution?: number;
+}
+/** Options for emitting a voltage activation event. */
+export interface EmitVoltageOptions {
+    triggerId: string;
+    anchor?: string;
+    voltageAtTrigger?: number;
+}
+/** Callback signature for activation event subscribers. */
+export type ActivationListener = (event: ActivationEvent) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/pulse/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pulse/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,qBAAqB,CAAC;CACvD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AAEH,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACxD,IAAI,EAAE,KAAK,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAEhE,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,2DAA2D;AAC3D,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC"}

package/dist/pulse/types.js

@@ -0,0 +1,6 @@
+/**
+ * Metabolic Pulse — type definitions.
+ * Tension-based heartbeat that replaces the fixed-interval autonomous timer.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pulse/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pulse/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/queue/grooming.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Periodic local backlog grooming — finds vague items, stale tasks,
+ * auto-promotes ready backlog items to todo, and nudges the user
+ * when attention is needed.
+ *
+ * Extracted from the former sync timer; runs on a simple interval
+ * with no external API dependencies.
+ */
+import { QueueStore } from "./store.js";
+/**
+ * Start the periodic grooming timer. Idempotent — calling twice is a no-op.
+ */
+export declare function startGroomingTimer(store: QueueStore, intervalMs?: number): void;
+/** Stop the grooming timer. */
+export declare function stopGroomingTimer(): void;
+//# sourceMappingURL=grooming.d.ts.map

package/dist/queue/grooming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grooming.d.ts","sourceRoot":"","sources":["../../src/queue/grooming.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAwQxC;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,UAAU,GAAE,MAAkC,GAC7C,IAAI,CAwBN;AAED,+BAA+B;AAC/B,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC"}