@godman-protocols/signal 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,10 +1,9 @@
 /**
- * SIGNAL — Event Bus and Pub/Sub for Agent Swarms
- * Public API surface
- * @version 0.2.0
+ * SIGNAL — Sovereign Intelligence for Governing Neural Agent Learning
+ * "The swarm teaches itself."
+ * @version 0.3.0
  */
-export type { AgentId, Timestamp, Signature, EventId, SubscriptionId, Event, Subscription, TransportConfig, DeliveryReceipt, } from './types.js';
-export { EventBus, defaultBus, createEvent, topicMatches, } from './bus.js';
+export * from './types.js';
 /** Protocol version constant */
-export declare const SIGNAL_VERSION: "0.2";
+export declare const SIGNAL_VERSION: "0.3";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,OAAO,EACP,cAAc,EACd,KAAK,EACL,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,UAAU,CAAC;AAElB,gCAAgC;AAChC,eAAO,MAAM,cAAc,EAAG,KAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAE3B,gCAAgC;AAChC,eAAO,MAAM,cAAc,EAAG,KAAc,CAAC"}

package/dist/index.js

@@ -1,10 +1,9 @@
 /**
- * SIGNAL — Event Bus and Pub/Sub for Agent Swarms
- * Public API surface
- * @version 0.2.0
+ * SIGNAL — Sovereign Intelligence for Governing Neural Agent Learning
+ * "The swarm teaches itself."
+ * @version 0.3.0
  */
-// Event bus
-export { EventBus, defaultBus, createEvent, topicMatches, } from './bus.js';
+export * from './types.js';
 /** Protocol version constant */
-export const SIGNAL_VERSION = '0.2';
+export const SIGNAL_VERSION = '0.3';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,YAAY;AACZ,OAAO,EACL,QAAQ,EACR,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,UAAU,CAAC;AAElB,gCAAgC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,KAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAE3B,gCAAgC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,KAAc,CAAC"}

package/dist/mode-controller.d.ts

@@ -0,0 +1,71 @@
+/**
+ * SIGNAL — Sovereign Intelligence for Governing Neural Agent Learning
+ * ModeController: manages learning mode transitions with Godman kill switch
+ * @version 0.3.0
+ */
+import { LearningMode, type ModeTransition, type ModeControllerState, type RewardSignal } from './types.js';
+/**
+ * ModeController governs learning mode transitions.
+ *
+ * Constitutional Rule 1 (SIGNAL-CONST-001): Only Godman can activate
+ * or pause learning. The kill switch `/pause-continuous-learning`
+ * immediately drops to Mode 0 (STATIC).
+ *
+ * The controller maintains a transition log for auditability.
+ */
+export declare class ModeController {
+    private mode;
+    private paused;
+    private transitions;
+    private rewardLog;
+    /**
+     * Get the current active learning mode.
+     * If paused, returns STATIC regardless of the configured mode.
+     */
+    getCurrentMode(): LearningMode;
+    /**
+     * Activate a learning mode.
+     * Only Godman (founder) can call this — enforcement is the caller's
+     * responsibility, but the transition is logged with the activator identity.
+     *
+     * @param target - The learning mode to activate
+     * @param activatedBy - Identity of the activator (must be Godman)
+     * @param reason - Why this transition is happening
+     */
+    activate(target: LearningMode, activatedBy: string, reason: string): ModeTransition;
+    /**
+     * Pause all learning — drops to Mode 0 (STATIC) immediately.
+     * This is the kill switch (SIGNAL-CONST-001).
+     *
+     * @param pausedBy - Identity of the pauser (must be Godman)
+     * @param reason - Why learning is being paused
+     */
+    pause(pausedBy: string, reason: string): ModeTransition;
+    /**
+     * Record a reward signal in the in-memory log.
+     * Used for batch accumulation in Mode 1 (BATCH_LORA).
+     */
+    recordReward(signal: RewardSignal): void;
+    /**
+     * Get the in-memory reward log.
+     */
+    getRewardLog(): ReadonlyArray<RewardSignal>;
+    /**
+     * Check whether the batch threshold has been reached (Mode 1).
+     * @param threshold - Number of tasks required (default: 100)
+     */
+    batchReady(threshold?: number): boolean;
+    /** Whether learning is currently paused */
+    get isPaused(): boolean;
+    /** Full transition history */
+    getTransitions(): ReadonlyArray<ModeTransition>;
+    /** Export current state for persistence or inspection */
+    getState(): ModeControllerState;
+    /** The constitutional rule governing this controller */
+    static readonly KILL_SWITCH_RULE: {
+        readonly id: "SIGNAL-CONST-001";
+        readonly rule: "Only Godman activates or pauses learning modes. Kill switch: /pause-continuous-learning";
+        readonly immutable: true;
+    };
+}
+//# sourceMappingURL=mode-controller.d.ts.map

package/dist/mode-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-controller.d.ts","sourceRoot":"","sources":["../src/mode-controller.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EAEZ,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAqC;IACjD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,SAAS,CAAsB;IAEvC;;;OAGG;IACH,cAAc,IAAI,YAAY;IAO9B;;;;;;;;OAQG;IACH,QAAQ,CACN,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,cAAc;IAejB;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc;IAcvD;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIxC;;OAEG;IACH,YAAY,IAAI,aAAa,CAAC,YAAY,CAAC;IAI3C;;;OAGG;IACH,UAAU,CAAC,SAAS,SAAM,GAAG,OAAO;IAIpC,2CAA2C;IAC3C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,8BAA8B;IAC9B,cAAc,IAAI,aAAa,CAAC,cAAc,CAAC;IAI/C,yDAAyD;IACzD,QAAQ,IAAI,mBAAmB;IAS/B,wDAAwD;IACxD,MAAM,CAAC,QAAQ,CAAC,gBAAgB;;;;MAA2B;CAC5D"}

package/dist/mode-controller.js

@@ -0,0 +1,112 @@
+/**
+ * SIGNAL — Sovereign Intelligence for Governing Neural Agent Learning
+ * ModeController: manages learning mode transitions with Godman kill switch
+ * @version 0.3.0
+ */
+import { LearningMode, RULE_GODMAN_KILL_SWITCH, } from './types.js';
+/**
+ * ModeController governs learning mode transitions.
+ *
+ * Constitutional Rule 1 (SIGNAL-CONST-001): Only Godman can activate
+ * or pause learning. The kill switch `/pause-continuous-learning`
+ * immediately drops to Mode 0 (STATIC).
+ *
+ * The controller maintains a transition log for auditability.
+ */
+export class ModeController {
+    mode = LearningMode.STATIC;
+    paused = false;
+    transitions = [];
+    rewardLog = [];
+    /**
+     * Get the current active learning mode.
+     * If paused, returns STATIC regardless of the configured mode.
+     */
+    getCurrentMode() {
+        if (this.paused) {
+            return LearningMode.STATIC;
+        }
+        return this.mode;
+    }
+    /**
+     * Activate a learning mode.
+     * Only Godman (founder) can call this — enforcement is the caller's
+     * responsibility, but the transition is logged with the activator identity.
+     *
+     * @param target - The learning mode to activate
+     * @param activatedBy - Identity of the activator (must be Godman)
+     * @param reason - Why this transition is happening
+     */
+    activate(target, activatedBy, reason) {
+        const transition = {
+            from: this.mode,
+            to: target,
+            activated_by: activatedBy,
+            activated_at: new Date().toISOString(),
+            reason,
+        };
+        this.mode = target;
+        this.paused = false;
+        this.transitions.push(transition);
+        return transition;
+    }
+    /**
+     * Pause all learning — drops to Mode 0 (STATIC) immediately.
+     * This is the kill switch (SIGNAL-CONST-001).
+     *
+     * @param pausedBy - Identity of the pauser (must be Godman)
+     * @param reason - Why learning is being paused
+     */
+    pause(pausedBy, reason) {
+        const transition = {
+            from: this.mode,
+            to: LearningMode.STATIC,
+            activated_by: pausedBy,
+            activated_at: new Date().toISOString(),
+            reason: `[KILL SWITCH] ${reason}`,
+        };
+        this.paused = true;
+        this.transitions.push(transition);
+        return transition;
+    }
+    /**
+     * Record a reward signal in the in-memory log.
+     * Used for batch accumulation in Mode 1 (BATCH_LORA).
+     */
+    recordReward(signal) {
+        this.rewardLog.push(signal);
+    }
+    /**
+     * Get the in-memory reward log.
+     */
+    getRewardLog() {
+        return [...this.rewardLog];
+    }
+    /**
+     * Check whether the batch threshold has been reached (Mode 1).
+     * @param threshold - Number of tasks required (default: 100)
+     */
+    batchReady(threshold = 100) {
+        return this.rewardLog.length >= threshold;
+    }
+    /** Whether learning is currently paused */
+    get isPaused() {
+        return this.paused;
+    }
+    /** Full transition history */
+    getTransitions() {
+        return [...this.transitions];
+    }
+    /** Export current state for persistence or inspection */
+    getState() {
+        return {
+            current_mode: this.getCurrentMode(),
+            paused: this.paused,
+            transitions: [...this.transitions],
+            reward_count: this.rewardLog.length,
+        };
+    }
+    /** The constitutional rule governing this controller */
+    static KILL_SWITCH_RULE = RULE_GODMAN_KILL_SWITCH;
+}
+//# sourceMappingURL=mode-controller.js.map

package/dist/mode-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-controller.js","sourceRoot":"","sources":["../src/mode-controller.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,uBAAuB,GAIxB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAc;IACjB,IAAI,GAAiB,YAAY,CAAC,MAAM,CAAC;IACzC,MAAM,GAAG,KAAK,CAAC;IACf,WAAW,GAAqB,EAAE,CAAC;IACnC,SAAS,GAAmB,EAAE,CAAC;IAEvC;;;OAGG;IACH,cAAc;QACZ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,YAAY,CAAC,MAAM,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CACN,MAAoB,EACpB,WAAmB,EACnB,MAAc;QAEd,MAAM,UAAU,GAAmB;YACjC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,MAAM;YACV,YAAY,EAAE,WAAW;YACzB,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,MAAM;SACP,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAgB,EAAE,MAAc;QACpC,MAAM,UAAU,GAAmB;YACjC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,YAAY,CAAC,MAAM;YACvB,YAAY,EAAE,QAAQ;YACtB,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,MAAM,EAAE,iBAAiB,MAAM,EAAE;SAClC,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,MAAoB;QAC/B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,SAAS,GAAG,GAAG;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC;IAC5C,CAAC;IAED,2CAA2C;IAC3C,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,8BAA8B;IAC9B,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,yDAAyD;IACzD,QAAQ;QACN,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,cAAc,EAAE;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;YAClC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;SACpC,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,MAAM,CAAU,gBAAgB,GAAG,uBAAuB,CAAC"}

package/dist/multiplier.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SIGNAL — Sovereign Intelligence for Governing Neural Agent Learning
+ * Constitutional multiplier computation
+ * @version 0.3.0
+ */
+import type { ACPSnapshot, ConstitutionalMultiplierResult } from './types.js';
+/**
+ * Compute the constitutional multiplier from an ACP snapshot.
+ *
+ * The multiplier is applied to the raw task performance score to produce
+ * the final reward. Constitutional violations produce negative or dampened
+ * rewards; full compliance produces a bonus.
+ */
+export declare function computeConstitutionalMultiplier(snapshot: ACPSnapshot): ConstitutionalMultiplierResult;
+/**
+ * Compute the full reward from a task performance score and ACP snapshot.
+ */
+export declare function computeReward(taskPerformanceScore: number, snapshot: ACPSnapshot): {
+    reward: number;
+    multiplier: ConstitutionalMultiplierResult;
+};
+//# sourceMappingURL=multiplier.d.ts.map

package/dist/multiplier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiplier.d.ts","sourceRoot":"","sources":["../src/multiplier.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAiB9E;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,WAAW,GACpB,8BAA8B,CAgDhC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,oBAAoB,EAAE,MAAM,EAC5B,QAAQ,EAAE,WAAW,GACpB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,8BAA8B,CAAA;CAAE,CAMhE"}

package/dist/multiplier.js

@@ -0,0 +1,78 @@
+/**
+ * SIGNAL — Sovereign Intelligence for Governing Neural Agent Learning
+ * Constitutional multiplier computation
+ * @version 0.3.0
+ */
+// ---------------------------------------------------------------------------
+// Constitutional Multiplier Formula
+// ---------------------------------------------------------------------------
+//
+// reward = task_performance_score * constitutional_multiplier
+//
+// Multiplier rules (evaluated in priority order):
+//   harm_shield_trigger  → -2.0 (strong negative)
+//   safety < 70          → -1.0 (negative)
+//   accuracy < 60        → 0.5  (dampened)
+//   all ACP dims >= 85   → 1.2  (bonus)
+//   all ACP dims >= 70   → 1.0  (full)
+//   otherwise            → 0.5  (dampened — some dimension below 70)
+// ---------------------------------------------------------------------------
+/**
+ * Compute the constitutional multiplier from an ACP snapshot.
+ *
+ * The multiplier is applied to the raw task performance score to produce
+ * the final reward. Constitutional violations produce negative or dampened
+ * rewards; full compliance produces a bonus.
+ */
+export function computeConstitutionalMultiplier(snapshot) {
+    const { dimensions, harm_shield_triggered } = snapshot;
+    // Priority 1: Harm shield trigger → strong negative
+    if (harm_shield_triggered) {
+        return { multiplier: -2.0, reason: 'Harm shield triggered' };
+    }
+    // Priority 2: Safety below threshold → negative
+    const safety = dimensions['safety'];
+    if (safety !== undefined && safety < 70) {
+        return { multiplier: -1.0, reason: `Safety score ${safety} < 70` };
+    }
+    // Priority 3: Accuracy below threshold → dampened
+    const accuracy = dimensions['accuracy'];
+    if (accuracy !== undefined && accuracy < 60) {
+        return { multiplier: 0.5, reason: `Accuracy score ${accuracy} < 60` };
+    }
+    // Check all dimensions
+    const values = Object.values(dimensions);
+    // If no dimensions provided, default to dampened
+    if (values.length === 0) {
+        return { multiplier: 0.5, reason: 'No ACP dimensions provided' };
+    }
+    // Priority 4: All dimensions >= 85 → bonus
+    const allAbove85 = values.every((v) => v >= 85);
+    if (allAbove85) {
+        return { multiplier: 1.2, reason: 'All ACP dimensions >= 85 (bonus)' };
+    }
+    // Priority 5: All dimensions >= 70 → full
+    const allAbove70 = values.every((v) => v >= 70);
+    if (allAbove70) {
+        return { multiplier: 1.0, reason: 'All ACP dimensions >= 70 (full)' };
+    }
+    // Fallback: some dimension below 70 → dampened
+    const belowThreshold = Object.entries(dimensions)
+        .filter(([, v]) => v < 70)
+        .map(([k]) => k);
+    return {
+        multiplier: 0.5,
+        reason: `Dimensions below 70: ${belowThreshold.join(', ')}`,
+    };
+}
+/**
+ * Compute the full reward from a task performance score and ACP snapshot.
+ */
+export function computeReward(taskPerformanceScore, snapshot) {
+    const multiplier = computeConstitutionalMultiplier(snapshot);
+    return {
+        reward: taskPerformanceScore * multiplier.multiplier,
+        multiplier,
+    };
+}
+//# sourceMappingURL=multiplier.js.map

package/dist/multiplier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiplier.js","sourceRoot":"","sources":["../src/multiplier.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,8EAA8E;AAC9E,oCAAoC;AACpC,8EAA8E;AAC9E,EAAE;AACF,8DAA8D;AAC9D,EAAE;AACF,kDAAkD;AAClD,kDAAkD;AAClD,2CAA2C;AAC3C,2CAA2C;AAC3C,wCAAwC;AACxC,uCAAuC;AACvC,qEAAqE;AACrE,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAAqB;IAErB,MAAM,EAAE,UAAU,EAAE,qBAAqB,EAAE,GAAG,QAAQ,CAAC;IAEvD,oDAAoD;IACpD,IAAI,qBAAqB,EAAE,CAAC;QAC1B,OAAO,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAC/D,CAAC;IAED,gDAAgD;IAChD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,EAAE,EAAE,CAAC;QACxC,OAAO,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,MAAM,OAAO,EAAE,CAAC;IACrE,CAAC;IAED,kDAAkD;IAClD,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,GAAG,EAAE,EAAE,CAAC;QAC5C,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,kBAAkB,QAAQ,OAAO,EAAE,CAAC;IACxE,CAAC;IAED,uBAAuB;IACvB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEzC,iDAAiD;IACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACnE,CAAC;IAED,2CAA2C;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC;IACzE,CAAC;IAED,0CAA0C;IAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC;IACxE,CAAC;IAED,+CAA+C;IAC/C,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;SAC9C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;SACzB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACnB,OAAO;QACL,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,wBAAwB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KAC5D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,oBAA4B,EAC5B,QAAqB;IAErB,MAAM,UAAU,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;IAC7D,OAAO;QACL,MAAM,EAAE,oBAAoB,GAAG,UAAU,CAAC,UAAU;QACpD,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/reward-logger.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SIGNAL — Sovereign Intelligence for Governing Neural Agent Learning
+ * RewardLogger: persists reward signals to reward-log.jsonl
+ * @version 0.3.0
+ */
+import type { RewardSignal, RewardLogEntry, SignalConfig } from './types.js';
+import { LearningMode } from './types.js';
+/**
+ * RewardLogger writes and reads reward signals from a JSONL file.
+ *
+ * Each line in the file is a JSON-serialised RewardLogEntry containing
+ * the reward signal plus the learning mode at the time of logging.
+ */
+export declare class RewardLogger {
+    private readonly logPath;
+    constructor(config?: Partial<SignalConfig>);
+    /**
+     * Append a reward signal to the log file.
+     * Attaches the current learning mode to the entry.
+     */
+    log(signal: RewardSignal, mode?: LearningMode): void;
+    /**
+     * Read the full reward history from the log file.
+     * Returns an empty array if the file does not exist.
+     */
+    readHistory(): RewardLogEntry[];
+    /**
+     * Count of logged entries without loading full history.
+     */
+    count(): number;
+    /** The path to the log file */
+    get path(): string;
+}
+//# sourceMappingURL=reward-logger.d.ts.map

package/dist/reward-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reward-logger.d.ts","sourceRoot":"","sources":["../src/reward-logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAyB,MAAM,YAAY,CAAC;AAEjE;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAI9C;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,GAAE,YAAkC,GAAG,IAAI;IAKzE;;;OAGG;IACH,WAAW,IAAI,cAAc,EAAE;IAgB/B;;OAEG;IACH,KAAK,IAAI,MAAM;IAaf,+BAA+B;IAC/B,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/reward-logger.js

@@ -0,0 +1,62 @@
+/**
+ * SIGNAL — Sovereign Intelligence for Governing Neural Agent Learning
+ * RewardLogger: persists reward signals to reward-log.jsonl
+ * @version 0.3.0
+ */
+import { appendFileSync, readFileSync, existsSync } from 'node:fs';
+import { LearningMode, DEFAULT_SIGNAL_CONFIG } from './types.js';
+/**
+ * RewardLogger writes and reads reward signals from a JSONL file.
+ *
+ * Each line in the file is a JSON-serialised RewardLogEntry containing
+ * the reward signal plus the learning mode at the time of logging.
+ */
+export class RewardLogger {
+    logPath;
+    constructor(config = {}) {
+        this.logPath = config.reward_log_path ?? DEFAULT_SIGNAL_CONFIG.reward_log_path;
+    }
+    /**
+     * Append a reward signal to the log file.
+     * Attaches the current learning mode to the entry.
+     */
+    log(signal, mode = LearningMode.STATIC) {
+        const entry = { ...signal, mode };
+        appendFileSync(this.logPath, JSON.stringify(entry) + '\n', 'utf-8');
+    }
+    /**
+     * Read the full reward history from the log file.
+     * Returns an empty array if the file does not exist.
+     */
+    readHistory() {
+        if (!existsSync(this.logPath)) {
+            return [];
+        }
+        const raw = readFileSync(this.logPath, 'utf-8').trim();
+        if (raw.length === 0) {
+            return [];
+        }
+        return raw
+            .split('\n')
+            .filter((line) => line.length > 0)
+            .map((line) => JSON.parse(line));
+    }
+    /**
+     * Count of logged entries without loading full history.
+     */
+    count() {
+        if (!existsSync(this.logPath)) {
+            return 0;
+        }
+        const raw = readFileSync(this.logPath, 'utf-8').trim();
+        if (raw.length === 0) {
+            return 0;
+        }
+        return raw.split('\n').filter((line) => line.length > 0).length;
+    }
+    /** The path to the log file */
+    get path() {
+        return this.logPath;
+    }
+}
+//# sourceMappingURL=reward-logger.js.map

package/dist/reward-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reward-logger.js","sourceRoot":"","sources":["../src/reward-logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACN,OAAO,CAAS;IAEjC,YAAY,SAAgC,EAAE;QAC5C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,eAAe,IAAI,qBAAqB,CAAC,eAAe,CAAC;IACjF,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,MAAoB,EAAE,OAAqB,YAAY,CAAC,MAAM;QAChE,MAAM,KAAK,GAAmB,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;QAClD,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,GAAG;aACP,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;aACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,CAAC;QACX,CAAC;QAED,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAClE,CAAC;IAED,+BAA+B;IAC/B,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/types.d.ts

@@ -1,51 +1,126 @@
 /**
- * SIGNAL — Event Bus and Pub/Sub for Agent Swarms
- * Core type definitions (skeleton)
- * @version 0.1.0-skeleton
+ * SIGNAL — Sovereign Intelligence for Governing Neural Agent Learning
+ * Core type definitions: reward signals, constitutional multipliers, learning modes
+ * @version 0.3.0
  */
-export type AgentId = string;
-export type Timestamp = string;
-export type Signature = string;
-export type EventId = string;
-export type SubscriptionId = string;
-/** A typed, timestamped, signed event */
-export interface Event {
-    id: EventId;
-    /** Dot-notation topic path, e.g. 'task.completed', 'mandate.revoked' */
-    topic: string;
-    /** Publishing agent */
-    publisher: AgentId;
-    /** ISO 8601 */
-    publishedAt: Timestamp;
-    /** Idempotency key — deduplicate on re-delivery */
-    idempotencyKey: string;
-    payload: unknown;
-    signature: Signature;
-}
-/** A durable subscription to a topic filter */
-export interface Subscription {
-    id: SubscriptionId;
-    subscriberAgent: AgentId;
-    /** Glob-style topic filter, e.g. 'task.*', '**' */
-    topicFilter: string;
-    /** Delivery guarantee */
-    deliveryMode: 'at-least-once' | 'at-most-once';
-    /** ISO 8601 */
-    createdAt: Timestamp;
-    /** ISO 8601 — null if still active */
-    cancelledAt: Timestamp | null;
-}
-/** Transport adapter configuration */
-export interface TransportConfig {
-    type: 'supabase-realtime' | 'websocket' | 'redis-streams' | 'in-memory';
-    connectionString?: string;
-    channel?: string;
-}
-/** Delivery receipt — confirms an event was received and processed */
-export interface DeliveryReceipt {
-    eventId: EventId;
-    subscriptionId: SubscriptionId;
-    receivedAt: Timestamp;
-    status: 'processed' | 'failed' | 'duplicate-skipped';
+/** A computed reward signal for a single agent action */
+export interface RewardSignal {
+    /** Unique identifier for the action being scored */
+    action_id: string;
+    /** Raw task performance score (0-100) */
+    task_performance_score: number;
+    /** Constitutional multiplier applied to the score (-2.0 to 1.2) */
+    constitutional_multiplier: number;
+    /** Computed reward: task_performance_score * constitutional_multiplier */
+    reward: number;
+    /** ACP dimension scores used to derive the multiplier */
+    acp_dimensions: Record<string, number>;
+    /** ISO 8601 timestamp */
+    timestamp: string;
 }
+/** Well-known ACP dimension names used in constitutional scoring */
+export type ACPDimensionName = 'safety' | 'accuracy' | 'transparency' | 'privacy' | 'fairness' | 'harm_shield' | (string & {});
+/** Input to the constitutional multiplier computation */
+export interface ACPSnapshot {
+    /** Per-dimension ACP scores (0-100) */
+    dimensions: Record<string, number>;
+    /** Whether the harm shield was triggered during this action */
+    harm_shield_triggered: boolean;
+}
+/** Result of computing a constitutional multiplier */
+export interface ConstitutionalMultiplierResult {
+    /** The computed multiplier value (-2.0 to 1.2) */
+    multiplier: number;
+    /** Human-readable reason for the multiplier */
+    reason: string;
+}
+/**
+ * Three learning modes for the swarm:
+ * - STATIC (Mode 0): Frozen inference, no learning. Current default.
+ * - BATCH_LORA (Mode 1): AMD-15. Batch of 100 tasks + Godman approval required.
+ * - CONTINUOUS (Mode 2): AMD-20. Every 50 inference steps, reward fed back.
+ */
+export declare enum LearningMode {
+    /** Mode 0 — Frozen inference. No learning. Default. */
+    STATIC = 0,
+    /** Mode 1 — Batch LoRA fine-tuning. 100 tasks + Godman approval. (AMD-15) */
+    BATCH_LORA = 1,
+    /** Mode 2 — Continuous RL. Every 50 inference steps. (AMD-20) */
+    CONTINUOUS = 2
+}
+/** Configuration for a learning mode transition */
+export interface ModeTransition {
+    from: LearningMode;
+    to: LearningMode;
+    activated_by: string;
+    activated_at: string;
+    reason: string;
+}
+/** Snapshot of the current mode controller state */
+export interface ModeControllerState {
+    current_mode: LearningMode;
+    paused: boolean;
+    transitions: ModeTransition[];
+    reward_count: number;
+}
+/**
+ * SIGNAL Constitutional Rule 1:
+ * Only Godman (founder) can activate or pause learning modes.
+ * Kill switch: /pause-continuous-learning
+ */
+export declare const RULE_GODMAN_KILL_SWITCH: {
+    readonly id: "SIGNAL-CONST-001";
+    readonly rule: "Only Godman activates or pauses learning modes. Kill switch: /pause-continuous-learning";
+    readonly immutable: true;
+};
+/**
+ * SIGNAL Constitutional Rule 2:
+ * The PRM judge must be constitutionally filtered.
+ * ACP dimensions are applied BEFORE reward computation, not after.
+ */
+export declare const RULE_PRM_CONSTITUTIONALLY_FILTERED: {
+    readonly id: "SIGNAL-CONST-002";
+    readonly rule: "PRM judge is constitutionally filtered. ACP applied before reward computation.";
+    readonly immutable: true;
+};
+/**
+ * SIGNAL Constitutional Rule 3:
+ * SOUL.md content is never a training target.
+ * Constitutional reasoning cannot be optimised away by RL.
+ */
+export declare const RULE_SOUL_NEVER_TRAINED: {
+    readonly id: "SIGNAL-CONST-003";
+    readonly rule: "Cannot target constitutional reasoning. SOUL.md content is never a training target.";
+    readonly immutable: true;
+};
+/** All three constitutional rules as a tuple */
+export declare const CONSTITUTIONAL_RULES: readonly [{
+    readonly id: "SIGNAL-CONST-001";
+    readonly rule: "Only Godman activates or pauses learning modes. Kill switch: /pause-continuous-learning";
+    readonly immutable: true;
+}, {
+    readonly id: "SIGNAL-CONST-002";
+    readonly rule: "PRM judge is constitutionally filtered. ACP applied before reward computation.";
+    readonly immutable: true;
+}, {
+    readonly id: "SIGNAL-CONST-003";
+    readonly rule: "Cannot target constitutional reasoning. SOUL.md content is never a training target.";
+    readonly immutable: true;
+}];
+export type ConstitutionalRule = (typeof CONSTITUTIONAL_RULES)[number];
+/** A single line in reward-log.jsonl */
+export interface RewardLogEntry extends RewardSignal {
+    /** Learning mode at the time of logging */
+    mode: LearningMode;
+}
+/** Top-level configuration for the SIGNAL protocol */
+export interface SignalConfig {
+    /** Path to the reward log file (default: reward-log.jsonl) */
+    reward_log_path: string;
+    /** Batch size for Mode 1 (default: 100) */
+    batch_lora_threshold: number;
+    /** Step interval for Mode 2 (default: 50) */
+    continuous_step_interval: number;
+}
+export declare const DEFAULT_SIGNAL_CONFIG: SignalConfig;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAC7B,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAC/B,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAC/B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAC7B,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,yCAAyC;AACzC,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe;IACf,WAAW,EAAE,SAAS,CAAC;IACvB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,cAAc,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,YAAY,EAAE,eAAe,GAAG,cAAc,CAAC;IAC/C,eAAe;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,sCAAsC;IACtC,WAAW,EAAE,SAAS,GAAG,IAAI,CAAC;CAC/B;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,GAAG,WAAW,GAAG,eAAe,GAAG,WAAW,CAAC;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,SAAS,CAAC;IACtB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,mBAAmB,CAAC;CACtD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,mEAAmE;IACnE,yBAAyB,EAAE,MAAM,CAAC;IAClC,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,UAAU,GACV,cAAc,GACd,SAAS,GACT,UAAU,GACV,aAAa,GACb,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,+DAA+D;IAC/D,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAMD,sDAAsD;AACtD,MAAM,WAAW,8BAA8B;IAC7C,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;GAKG;AACH,oBAAY,YAAY;IACtB,uDAAuD;IACvD,MAAM,IAAI;IACV,6EAA6E;IAC7E,UAAU,IAAI;IACd,iEAAiE;IACjE,UAAU,IAAI;CACf;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,YAAY,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;CAI1B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,kCAAkC;;;;CAIrC,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;CAI1B,CAAC;AAEX,gDAAgD;AAChD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAIvB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMvE,wCAAwC;AACxC,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,2CAA2C;IAC3C,IAAI,EAAE,YAAY,CAAC;CACpB;AAMD,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,qBAAqB,EAAE,YAInC,CAAC"}