@runcore-sh/runcore 0.3.1 → 0.4.0

package/dist/pulse/activation-event.js

@@ -81,16 +81,33 @@ export function createCdtEvent(opts) {
         timestamp: new Date().toISOString(),
     };
 }
+// ─── Aggregate CDT rate limiter ──────────────────────────────────────────────
+// Prevents cascade storms where N different CDT sources pile on in the same
+// tick, each adding 15mV. Per-source refractory (5 min) handles individual
+// sources; this caps total CDT voltage contributions globally.
+const CDT_AGGREGATE_WINDOW_MS = 60_000; // 1 minute
+const CDT_AGGREGATE_MAX = 3; // max voltage-contributing CDTs per window
+let cdtAggregateCount = 0;
+let cdtAggregateWindowStart = Date.now();
+function isCdtAggregateExhausted() {
+    const now = Date.now();
+    if (now - cdtAggregateWindowStart > CDT_AGGREGATE_WINDOW_MS) {
+        cdtAggregateCount = 0;
+        cdtAggregateWindowStart = now;
+    }
+    return cdtAggregateCount >= CDT_AGGREGATE_MAX;
+}
 // ─── Emission API ───────────────────────────────────────────────────────────
 /**
  * Emit a CDT activation event.
  *
  * Handles the full pipeline:
  * 1. CDT refractory check (per-source 5 min window)
- * 2. Voltage snapshot
- * 3. Event creation and persistence
- * 4. Voltage contribution (via bridge)
- * 5. Subscriber notification
+ * 2. Aggregate CDT rate check (max 3 voltage contributions per 60s)
+ * 3. Voltage snapshot
+ * 4. Event creation and persistence
+ * 5. Voltage contribution (via bridge, if within aggregate limit)
+ * 6. Subscriber notification
  *
  * @returns true if emitted, false if suppressed by refractory
  */
@@ -108,13 +125,19 @@ export function emitCdt(opts) {
             ? Math.round(currentVoltage * 10) / 10
             : undefined,
     });
-    // Persist + refractory bookkeeping
+    // Persist + refractory bookkeeping (always record, even if voltage is capped)
     recordActivation(event, opts.sourceKey).catch(() => { });
-    // Contribute voltage to the pressure system
+    // Contribute voltage to the pressure system — capped by aggregate limiter
     const contribution = event.voltageContribution ?? 0;
     if (contribution > 0 && voltageContributor) {
-        voltageContributor(contribution);
-        log.debug(`CDT +${contribution}mV (${opts.sourceKey}): emitted trigger=${opts.triggerId}`);
+        if (isCdtAggregateExhausted()) {
+            log.debug(`CDT voltage suppressed (aggregate limit ${CDT_AGGREGATE_MAX}/${CDT_AGGREGATE_WINDOW_MS}ms): ${opts.sourceKey}`);
+        }
+        else {
+            cdtAggregateCount++;
+            voltageContributor(contribution);
+            log.debug(`CDT +${contribution}mV (${opts.sourceKey}): emitted trigger=${opts.triggerId} [${cdtAggregateCount}/${CDT_AGGREGATE_MAX}]`);
+        }
     }
     // Notify subscribers
     notifyListeners(event);

package/dist/pulse/activation-event.js.map

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

package/dist/pulse/activation-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activation-log.d.ts","sourceRoot":"","sources":["../../src/pulse/activation-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAyClD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAI1D;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,eAAe,EAAE,CAEhE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAElD"}
+{"version":3,"file":"activation-log.d.ts","sourceRoot":"","sources":["../../src/pulse/activation-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAwClD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAI1D;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,eAAe,EAAE,CAEhE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAElD"}

package/dist/pulse/activation-log.js.map

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

package/dist/pulse/index.d.ts

@@ -7,5 +7,8 @@
 export { emitCdt, emitVoltage, onActivation, bridgeVoltageSystem, unbridgeVoltageSystem, createCdtEvent, createVoltageEvent, } from "./activation-event.js";
 export { recordActivation, getActivationEvents, isCdtRefractory, getCdtVoltageContribution, } from "./activation-log.js";
 export { PressureIntegrator, getPressureIntegrator, initPressureIntegrator, } from "./pressure.js";
+export { computeWorkSignal, computeFromTrend, getWorkSignalBreakdown, setInferenceMetricsProvider, type WorkSignalBreakdown, type TrendWindow, type InferenceMetricsProvider, } from "./work.js";
+export { calculateFlywheelTier, dotStateToTier, DOT_PRODUCT_MAP, TIER_COLORS, } from "./tier.js";
+export type { DotState, DotTier, DotName, DotStatus, FlywheelTier, FlywheelStatus, } from "./tier.js";
 export type { ActivationEvent, ActivationEventBase, VoltageActivation, CdtActivation, ActivationListener, EmitCdtOptions, EmitVoltageOptions, PulseConfig, PulseStatus, VoltageSnapshot, VoltageWeight, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pulse/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,OAAO,EACP,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pulse/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,OAAO,EACP,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,EAC3B,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,wBAAwB,GAC9B,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,QAAQ,EACR,OAAO,EACP,OAAO,EACP,SAAS,EACT,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/pulse/index.js

@@ -10,4 +10,8 @@ export { emitCdt, emitVoltage, onActivation, bridgeVoltageSystem, unbridgeVoltag
 export { recordActivation, getActivationEvents, isCdtRefractory, getCdtVoltageContribution, } from "./activation-log.js";
 // ─── PressureIntegrator (voltage system) ────────────────────────────────────
 export { PressureIntegrator, getPressureIntegrator, initPressureIntegrator, } from "./pressure.js";
+// ─── Work signal (inference metrics → pulse) ─────────────────────────────────
+export { computeWorkSignal, computeFromTrend, getWorkSignalBreakdown, setInferenceMetricsProvider, } from "./work.js";
+// ─── Flywheel tier system ─────────────────────────────────────────────────────
+export { calculateFlywheelTier, dotStateToTier, DOT_PRODUCT_MAP, TIER_COLORS, } from "./tier.js";
 //# sourceMappingURL=index.js.map

package/dist/pulse/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pulse/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,OAAO,EACL,OAAO,EACP,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,8EAA8E;AAC9E,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,+EAA+E;AAC/E,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pulse/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,OAAO,EACL,OAAO,EACP,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,8EAA8E;AAC9E,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,+EAA+E;AAC/E,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,gFAAgF;AAChF,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,GAI5B,MAAM,WAAW,CAAC;AAEnB,iFAAiF;AACjF,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,WAAW,GACZ,MAAM,WAAW,CAAC"}

package/dist/pulse/tier.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Flywheel Tier System.
+ *
+ * The flywheel is a three-body system: Sense (Core), Work (GMR), Joy (BragBin).
+ * All three dots must reach the same level for the flywheel to advance a tier.
+ * The weakest dot determines the overall tier — no dot can be left behind.
+ *
+ * Tiers represent trust maturity (ICI reduction), not gamification:
+ *   Tier 0 — Dormant: no signal from one or more dots
+ *   Tier 1 — Stirring: all dots have signal, high instinct cost
+ *   Tier 2 — Spinning: all dots flowing, trust building, UI fading
+ *   Tier 3 — Instinct: all dots deep green, system disappears
+ *
+ * Sundial principle: no numbers, no countdowns, no anxiety triggers.
+ * Tier changes are felt through color deepening and capability shifts.
+ */
+/** The state of a single dot (sense, work, or joy). */
+export type DotState = "green" | "blue" | "amber";
+/** Dot-level tier: how mature this dot's signal is. */
+export type DotTier = 0 | 1 | 2 | 3;
+/** Flywheel tier — the system-wide tier (min of all three dots). */
+export type FlywheelTier = 0 | 1 | 2 | 3;
+/** Which product maps to which dot. */
+export type DotName = "sense" | "work" | "joy";
+/** Product → dot mapping. */
+export declare const DOT_PRODUCT_MAP: Record<DotName, string>;
+/** Color palette that deepens with tier. No sharp transitions. */
+export declare const TIER_COLORS: Record<FlywheelTier, {
+    hue: string;
+    depth: string;
+}>;
+export interface DotStatus {
+    name: DotName;
+    state: DotState;
+    tier: DotTier;
+    why: string;
+}
+export interface FlywheelStatus {
+    tier: FlywheelTier;
+    dots: Record<DotName, DotStatus>;
+    color: {
+        hue: string;
+        depth: string;
+    };
+    /** Quiet narrative — no metrics, just a sentence about the flywheel's state. */
+    narrative: string;
+}
+/**
+ * Map a dot's instantaneous state to a tier level.
+ *
+ *   green  → 3 (flowing / aligned / active)
+ *   blue   → 2 (calm / present but not urgent)
+ *   amber  → 1 (attention needed / signal present but strained)
+ *
+ * A dot with no data at all gets state "amber" from the pulse endpoint,
+ * so tier 0 (dormant) only applies when explicitly passed.
+ */
+export declare function dotStateToTier(state: DotState): DotTier;
+/**
+ * Calculate the flywheel tier from three dot states.
+ *
+ * The flywheel tier is the MINIMUM of all three dot tiers.
+ * All three must be at the same level to advance — the weakest dot
+ * determines the overall tier. This prevents lopsided growth.
+ */
+export declare function calculateFlywheelTier(sense: DotState, work: DotState, joy: DotState): FlywheelStatus;
+//# sourceMappingURL=tier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tier.d.ts","sourceRoot":"","sources":["../../src/pulse/tier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,uDAAuD;AACvD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD,uDAAuD;AACvD,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEpC,oEAAoE;AACpE,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEzC,uCAAuC;AACvC,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAE/C,6BAA6B;AAC7B,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAInD,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAK5E,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACjC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAOvD;AAID;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,QAAQ,GACZ,cAAc,CAmBhB"}

package/dist/pulse/tier.js

@@ -0,0 +1,104 @@
+/**
+ * Flywheel Tier System.
+ *
+ * The flywheel is a three-body system: Sense (Core), Work (GMR), Joy (BragBin).
+ * All three dots must reach the same level for the flywheel to advance a tier.
+ * The weakest dot determines the overall tier — no dot can be left behind.
+ *
+ * Tiers represent trust maturity (ICI reduction), not gamification:
+ *   Tier 0 — Dormant: no signal from one or more dots
+ *   Tier 1 — Stirring: all dots have signal, high instinct cost
+ *   Tier 2 — Spinning: all dots flowing, trust building, UI fading
+ *   Tier 3 — Instinct: all dots deep green, system disappears
+ *
+ * Sundial principle: no numbers, no countdowns, no anxiety triggers.
+ * Tier changes are felt through color deepening and capability shifts.
+ */
+/** Product → dot mapping. */
+export const DOT_PRODUCT_MAP = {
+    sense: "Core",
+    work: "GMReports",
+    joy: "BragBin",
+};
+/** Color palette that deepens with tier. No sharp transitions. */
+export const TIER_COLORS = {
+    0: { hue: "neutral", depth: "faint" },
+    1: { hue: "warm", depth: "soft" },
+    2: { hue: "warm", depth: "medium" },
+    3: { hue: "warm", depth: "deep" },
+};
+// ─── Dot tier calculation ───────────────────────────────────────────────────
+/**
+ * Map a dot's instantaneous state to a tier level.
+ *
+ *   green  → 3 (flowing / aligned / active)
+ *   blue   → 2 (calm / present but not urgent)
+ *   amber  → 1 (attention needed / signal present but strained)
+ *
+ * A dot with no data at all gets state "amber" from the pulse endpoint,
+ * so tier 0 (dormant) only applies when explicitly passed.
+ */
+export function dotStateToTier(state) {
+    switch (state) {
+        case "green": return 3;
+        case "blue": return 2;
+        case "amber": return 1;
+        default: return 0;
+    }
+}
+// ─── Flywheel tier calculation ──────────────────────────────────────────────
+/**
+ * Calculate the flywheel tier from three dot states.
+ *
+ * The flywheel tier is the MINIMUM of all three dot tiers.
+ * All three must be at the same level to advance — the weakest dot
+ * determines the overall tier. This prevents lopsided growth.
+ */
+export function calculateFlywheelTier(sense, work, joy) {
+    const senseTier = dotStateToTier(sense);
+    const workTier = dotStateToTier(work);
+    const joyTier = dotStateToTier(joy);
+    const tier = Math.min(senseTier, workTier, joyTier);
+    const dots = {
+        sense: { name: "sense", state: sense, tier: senseTier, why: dotNarrative("sense", sense) },
+        work: { name: "work", state: work, tier: workTier, why: dotNarrative("work", work) },
+        joy: { name: "joy", state: joy, tier: joyTier, why: dotNarrative("joy", joy) },
+    };
+    return {
+        tier,
+        dots,
+        color: TIER_COLORS[tier],
+        narrative: flywheelNarrative(tier, senseTier, workTier, joyTier),
+    };
+}
+// ─── Narratives (sundial: no numbers, no anxiety) ───────────────────────────
+function dotNarrative(dot, state) {
+    const label = DOT_PRODUCT_MAP[dot];
+    switch (state) {
+        case "green": return `${label} is flowing`;
+        case "blue": return `${label} is present`;
+        case "amber": return `${label} needs attention`;
+        default: return `${label} is quiet`;
+    }
+}
+function flywheelNarrative(tier, sense, work, joy) {
+    if (tier === 3)
+        return "The flywheel is spinning on instinct.";
+    if (tier === 2)
+        return "The flywheel is building momentum.";
+    if (tier === 1) {
+        // Identify which dot(s) are holding back progress
+        const lagging = [];
+        if (sense === 1)
+            lagging.push("Sense");
+        if (work === 1)
+            lagging.push("Work");
+        if (joy === 1)
+            lagging.push("Joy");
+        if (lagging.length === 3)
+            return "All three dots are stirring. The flywheel is waking up.";
+        return `The flywheel is stirring. ${lagging.join(" and ")} ${lagging.length === 1 ? "needs" : "need"} warmth.`;
+    }
+    return "The flywheel is still.";
+}
+//# sourceMappingURL=tier.js.map

package/dist/pulse/tier.js.map

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

package/dist/pulse/work.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Work signal — derives a 0-1 Work value from inference metrics.
+ *
+ * The Work dot in the Sense/Work/Joy flywheel represents how much
+ * productive inference activity is happening. This module reads
+ * trend data and normalizes it into a [0, 1] signal suitable for
+ * pulse emission and field participation.
+ *
+ * Factors:
+ *   - Call volume (more calls = more work)
+ *   - Error rate (high errors dampen work signal)
+ *   - Escalation rate (escalations indicate harder work)
+ *   - Token throughput (more tokens = more substance)
+ *
+ * Portability: InferenceMetricsProvider is injectable. The server
+ * injects the concrete implementation at runtime; the module itself
+ * has no direct dependency on any specific metrics backend.
+ */
+/** Trend window data — a snapshot of inference metrics over a time window. */
+export interface TrendWindow {
+    callCount: number;
+    errorRate: number;
+    escalationRate: number;
+    tokensByTarget: {
+        cloud: number;
+        local: number;
+    };
+}
+/** Provider for inference metrics. Injected by the server at runtime. */
+export interface InferenceMetricsProvider {
+    trend(windowMs: number): TrendWindow;
+}
+/** Register the inference metrics provider. Called once at startup. */
+export declare function setInferenceMetricsProvider(provider: InferenceMetricsProvider): void;
+/**
+ * Compute the current Work signal (0-1) from inference metrics.
+ *
+ * Returns 0 when no inference activity has occurred or no provider is registered.
+ * Approaches 1.0 as call volume and token throughput increase,
+ * modulated by error rate and escalation intensity.
+ */
+export declare function computeWorkSignal(): number;
+/**
+ * Compute Work signal from a pre-fetched trend window.
+ * Useful when the caller already has trend data.
+ */
+export declare function computeFromTrend(trend: TrendWindow): number;
+/**
+ * Get a diagnostic breakdown of the Work signal components.
+ * Useful for debugging and HUD display.
+ */
+export declare function getWorkSignalBreakdown(): WorkSignalBreakdown;
+export interface WorkSignalBreakdown {
+    /** Composite Work signal (0-1). */
+    work: number;
+    /** Individual component values (0-1 each). */
+    components: {
+        calls: number;
+        tokens: number;
+        escalation: number;
+        success: number;
+    };
+    /** The trend window used for calculation. */
+    trend: TrendWindow;
+}
+//# sourceMappingURL=work.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"work.d.ts","sourceRoot":"","sources":["../../src/pulse/work.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAED,yEAAyE;AACzE,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC;CACtC;AAMD,uEAAuE;AACvE,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAEpF;AAwBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA0B3D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAgC5D;AAED,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,6CAA6C;IAC7C,KAAK,EAAE,WAAW,CAAC;CACpB"}

package/dist/pulse/work.js

@@ -0,0 +1,117 @@
+/**
+ * Work signal — derives a 0-1 Work value from inference metrics.
+ *
+ * The Work dot in the Sense/Work/Joy flywheel represents how much
+ * productive inference activity is happening. This module reads
+ * trend data and normalizes it into a [0, 1] signal suitable for
+ * pulse emission and field participation.
+ *
+ * Factors:
+ *   - Call volume (more calls = more work)
+ *   - Error rate (high errors dampen work signal)
+ *   - Escalation rate (escalations indicate harder work)
+ *   - Token throughput (more tokens = more substance)
+ *
+ * Portability: InferenceMetricsProvider is injectable. The server
+ * injects the concrete implementation at runtime; the module itself
+ * has no direct dependency on any specific metrics backend.
+ */
+// ─── Module state ───────────────────────────────────────────────────────────
+let metricsProvider = null;
+/** Register the inference metrics provider. Called once at startup. */
+export function setInferenceMetricsProvider(provider) {
+    metricsProvider = provider;
+}
+// ─── Tuning knobs ───────────────────────────────────────────────────────────
+/** Tuning knobs for Work signal normalization. */
+const WORK_PARAMS = {
+    /** Calls per hour that maps to work=1.0 (saturation point). */
+    callSaturation: 100,
+    /** Tokens per hour that maps to full token contribution. */
+    tokenSaturation: 50_000,
+    /** Weight of call volume in the composite signal. */
+    callWeight: 0.4,
+    /** Weight of token throughput in the composite signal. */
+    tokenWeight: 0.3,
+    /** Weight of escalation intensity (harder work). */
+    escalationWeight: 0.15,
+    /** Weight of success rate (errors dampen). */
+    successWeight: 0.15,
+    /** Rolling window for trend calculation (ms). */
+    windowMs: 60 * 60 * 1000, // 1 hour
+};
+// ─── Signal computation ─────────────────────────────────────────────────────
+/**
+ * Compute the current Work signal (0-1) from inference metrics.
+ *
+ * Returns 0 when no inference activity has occurred or no provider is registered.
+ * Approaches 1.0 as call volume and token throughput increase,
+ * modulated by error rate and escalation intensity.
+ */
+export function computeWorkSignal() {
+    if (!metricsProvider)
+        return 0;
+    const trend = metricsProvider.trend(WORK_PARAMS.windowMs);
+    if (trend.callCount === 0)
+        return 0;
+    return computeFromTrend(trend);
+}
+/**
+ * Compute Work signal from a pre-fetched trend window.
+ * Useful when the caller already has trend data.
+ */
+export function computeFromTrend(trend) {
+    if (trend.callCount === 0)
+        return 0;
+    // Call volume: saturates at callSaturation calls/window
+    const callSignal = Math.min(trend.callCount / WORK_PARAMS.callSaturation, 1);
+    // Token throughput: total tokens in window, saturates at tokenSaturation
+    const totalTokens = trend.tokensByTarget.cloud + trend.tokensByTarget.local;
+    const tokenSignal = Math.min(totalTokens / WORK_PARAMS.tokenSaturation, 1);
+    // Escalation intensity: escalations indicate harder, more complex work
+    // Cap at 0.5 escalation rate for full signal (beyond that is pathological)
+    const escalationSignal = Math.min(trend.escalationRate / 0.5, 1);
+    // Success rate: errors dampen the work signal (broken work isn't real work)
+    const successSignal = 1 - trend.errorRate;
+    // Weighted composite
+    const raw = callSignal * WORK_PARAMS.callWeight +
+        tokenSignal * WORK_PARAMS.tokenWeight +
+        escalationSignal * WORK_PARAMS.escalationWeight +
+        successSignal * WORK_PARAMS.successWeight;
+    // Clamp to [0, 1]
+    return Math.min(Math.max(raw, 0), 1);
+}
+/**
+ * Get a diagnostic breakdown of the Work signal components.
+ * Useful for debugging and HUD display.
+ */
+export function getWorkSignalBreakdown() {
+    if (!metricsProvider) {
+        const emptyTrend = { callCount: 0, errorRate: 0, escalationRate: 0, tokensByTarget: { cloud: 0, local: 0 } };
+        return { work: 0, components: { calls: 0, tokens: 0, escalation: 0, success: 0 }, trend: emptyTrend };
+    }
+    const trend = metricsProvider.trend(WORK_PARAMS.windowMs);
+    if (trend.callCount === 0) {
+        return {
+            work: 0,
+            components: { calls: 0, tokens: 0, escalation: 0, success: 0 },
+            trend,
+        };
+    }
+    const callSignal = Math.min(trend.callCount / WORK_PARAMS.callSaturation, 1);
+    const totalTokens = trend.tokensByTarget.cloud + trend.tokensByTarget.local;
+    const tokenSignal = Math.min(totalTokens / WORK_PARAMS.tokenSaturation, 1);
+    const escalationSignal = Math.min(trend.escalationRate / 0.5, 1);
+    const successSignal = 1 - trend.errorRate;
+    return {
+        work: computeFromTrend(trend),
+        components: {
+            calls: Math.round(callSignal * 1000) / 1000,
+            tokens: Math.round(tokenSignal * 1000) / 1000,
+            escalation: Math.round(escalationSignal * 1000) / 1000,
+            success: Math.round(successSignal * 1000) / 1000,
+        },
+        trend,
+    };
+}
+//# sourceMappingURL=work.js.map

package/dist/pulse/work.js.map

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

package/dist/runtime-lock.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Runtime Lock — PID file with port for instance discovery.
+ *
+ * On startup: writes brain/runtime/instance.json with pid, port, name, startedAt.
+ * On shutdown: deletes it.
+ * Discovery: other processes read the file to find running instances.
+ *
+ * Stale lock detection: if the PID in the file isn't running, the lock is stale
+ * and gets cleaned up automatically.
+ */
+export interface RuntimeLock {
+    pid: number;
+    port: number;
+    name: string;
+    brainDir: string;
+    startedAt: string;
+}
+/**
+ * Write the runtime lock file. Call after the server starts
+ * and the actual port is known.
+ */
+export declare function acquireLock(port: number, name: string): RuntimeLock;
+/**
+ * Release the runtime lock file. Call during graceful shutdown.
+ * Only deletes if the lock belongs to this process (prevents
+ * a shutting-down instance from deleting a freshly-started one's lock).
+ */
+export declare function releaseLock(): void;
+/**
+ * Read the current lock file. Returns null if no lock exists
+ * or the file is malformed.
+ */
+export declare function readLock(): RuntimeLock | null;
+/**
+ * Discover a running instance from the lock file.
+ * Returns the lock if the process is alive, null otherwise.
+ * Cleans up stale locks automatically.
+ */
+export declare function discoverRunning(): RuntimeLock | null;
+/**
+ * Get the port from the last runtime lock, regardless of whether
+ * the process is still alive. Used for sticky port on restart.
+ * Returns 0 if no previous lock found.
+ */
+export declare function getLastPort(): number;
+/**
+ * Discover running instances across multiple brain directories.
+ * Useful for finding all Core instances on this machine.
+ */
+export declare function discoverAll(brainDirs: string[]): RuntimeLock[];
+//# sourceMappingURL=runtime-lock.d.ts.map

package/dist/runtime-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-lock.d.ts","sourceRoot":"","sources":["../src/runtime-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAYD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CA0BnE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,WAAW,GAAG,IAAI,CAQ7C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAepD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAsB9D"}