@herjarsa/omo-meta-governor 0.50.1 → 0.51.0

package/README.md

@@ -615,9 +615,13 @@ All configuration lives under the `meta_governor` key in
 |-------|------|---------|-------------|
 | `saveDecisions` | boolean | `true` | Whether to save decision records. |
 | `saveLessons` | boolean | `true` | Whether to save lessons. |
-| `autoRemember.enabled` | boolean | `true` | v0.49.1: kill-switch for the Phase 4 auto-remember prompt (warn/escalate/stop → agentmemory_memory_save). Set `false` to disable it entirely. |
-| `autoRemember.cooldownMs` | number | `300000` | v0.49.1: min ms between two auto-remember fires in the same session. |
-| `autoRemember.dedupe` | boolean | `true` | v0.49.1: identical content is never re-queued in the same session. |
+| `autoRemember.enabled` | boolean | `false` | Opt-in kill-switch for the auto-remember prompt (escalate/stop only → `omo_remember`). Conscience fix 2026-09-27: default flipped `true` → `false`; `warn` no longer triggers. |
+| `autoRemember.cooldownMs` | number | `300000` | Min ms between two auto-remember fires in the same session. |
+| `autoRemember.dedupe` | boolean | `true` | Identical content (stable key: action + evidence sources + deviation categories, score floats excluded) is never re-queued in the same session. |
+| `conscience.enabled` | boolean | `false` | Master switch for conscience memory persistence (opt-in). |
+| `conscience.maxMemoriesPerSession` | integer | `5` | Max conscience memories persisted per session. |
+| `conscience.toolRoute` | enum | `omo_remember` | Tool route for conscience writes (`omo_remember` only). |
+| `conscience.requireNovelty` | boolean | `true` | When true, only novel structured content (`mistake`, `whatToDo`, `whereToGo`, `toolRoute`) is persisted; raw dumps forbidden. |
 
 ### `modelOverride`
 

package/dist/closed-loop-learning.d.ts

@@ -15,7 +15,7 @@
  * - Decisions go to agentmemory_memory_save (type: "fact").
  * - No file I/O, no MCP calls — just decision logic + DI write.
  */
-import type { AgentmemoryWriteBackend, ClosedLoopConfig, LearnFromOutcomeInput, LearnFromOutcomeOutput } from "./types";
+import type { AgentmemoryWriteBackend, ClosedLoopConfig, Decision, Deviation, LearnFromOutcomeInput, LearnFromOutcomeOutput } from "./types";
 /** Severity ordering for threshold comparison. */
 declare const SEVERITY_ORDER: Record<string, number>;
 /**
@@ -29,4 +29,53 @@ export declare function observeAndLearn(input: LearnFromOutcomeInput, backend: A
  * Helper: create a default ClosedLoopConfig.
  */
 export declare function defaultClosedLoopConfig(): ClosedLoopConfig;
+/**
+ * Conscience value-gate (D3). Single gate for all conscience memory writes.
+ *
+ * Requires ALL of:
+ * - action in {escalate, stop} (D1 — warn/continue never persist)
+ * - config.enabled
+ * - config.saveLessons !== false
+ * - severityMeetsThreshold(deviations, config.minSeverityToLearn)
+ * - novelty === true (caller-owned novelty check)
+ * - lessonCount < config.maxLessonsPerSession
+ */
+export interface ShouldPersistConscienceMemoryInput {
+    readonly action: Decision["action"];
+    readonly deviations: readonly Deviation[];
+    readonly config: ClosedLoopConfig;
+    readonly novelty: boolean;
+    readonly lessonCount: number;
+}
+export declare function shouldPersistConscienceMemory(input: ShouldPersistConscienceMemoryInput): boolean;
+/**
+ * Stable dedupe key (D5). Hash of stable fields only — action + sorted
+ * evidence sources + sorted deviation categories. Score floats are
+ * deliberately excluded: float jitter previously defeated dedupe.
+ */
+export interface ConscienceDedupeKeyInput {
+    readonly action: string;
+    readonly evidenceSources: readonly string[];
+    readonly deviationCategories: readonly string[];
+}
+export declare function conscienceDedupeKey(input: ConscienceDedupeKeyInput): string;
+/**
+ * Structured conscience memory content (D4/D6). Built via buildLessonContent
+ * + extractConcepts — never a raw dump. Delivery route is always the
+ * Zod-validated omo_remember tool.
+ */
+export interface BuildConscienceMemoryContentInput {
+    readonly action: "escalate" | "stop";
+    readonly mistake: string;
+    readonly whatToDo: string;
+    readonly whereToGo: string;
+    readonly toolRoute: "omo_remember";
+    readonly score: number;
+    readonly files: readonly string[];
+}
+export interface ConscienceMemoryContent {
+    readonly content: string;
+    readonly concepts: string[];
+}
+export declare function buildConscienceMemoryContent(input: BuildConscienceMemoryContentInput): ConscienceMemoryContent;
 export { SEVERITY_ORDER };

package/dist/config.d.ts

@@ -45,8 +45,10 @@ export interface MetaGovernorPluginConfig {
         /** v0.18.0: was silently dropped by loadOrchestratorConfig */
         defaultEscalationTarget?: "oracle" | "user";
         /**
-         * v0.38.4 Option D: Oracle invocation frequency. Derived from
-         * `oracle.frequency` (canonical) — exposed here only as a fallback.
+         * v0.38.4 Option D: Oracle invocation frequency.
+         * @deprecated READ-ONLY fallback — do not set. Canonical knob is
+         * `oracle.frequency`; this field is read only for back-compat with
+         * pre-v0.38.4 configs and is ignored when `oracle.frequency` is set.
          * Users should set `oracle.frequency` in opencode.jsonc, not this field.
          */
         oracleFrequency?: "per-stop" | "final-only" | "off";
@@ -64,6 +66,19 @@ export interface MetaGovernorPluginConfig {
             cooldownMs?: number;
             dedupe?: boolean;
         };
+        /**
+         * v0.50.0 (D10): conscience memory gate config. Canonical source for
+         * high-value memory persistence (escalate|stop only, value-gated).
+         * NOTE: typed structurally (not ConscienceConfig) so config.ts
+         * typechecks regardless of T1 landing order — shapes must match
+         * ClosedLoopConfig.conscience once T1 lands.
+         */
+        conscience?: {
+            enabled?: boolean;
+            maxMemoriesPerSession?: number;
+            toolRoute?: "omo_remember";
+            requireNovelty?: boolean;
+        };
     };
     /** Model override for MetaGovernor internal LLM usage. */
     modelOverride?: ModelOverrideConfig;

package/dist/delivery-registry.d.ts

@@ -34,6 +34,7 @@ export interface PendingDelivery {
 export type DeliveryStatus = "pending" | "delivered" | "expired";
 export declare class PendingDeliveryRegistry {
     private readonly entries;
+    private static readonly MAX_ENTRIES;
     /** When mcpArgs match is disabled (no mcpArgs available on observed call) */
     private deliveredCount;
     private expiredCount;