@herjarsa/omo-meta-governor 0.31.2 → 0.31.4

package/README.md

@@ -549,8 +549,8 @@ All configuration lives under the `meta_governor` key in
 | `maxInterventionsPerSession` | integer | `3` | v0.10.0: hard cap before auto-disable. |
 | `respectDoneSignal` | boolean | `true` | Stop injecting once terminal signal + Oracle verified. |
 | `phaseAwareDoneSignal` | boolean | `false` | v0.15.0: split per-phase hint from terminal signal. |
-| `compactionLoopGuard.enabled` | boolean | `false` | v0.31.1: opt-in defense against opencode [#27924](https://github.com/anomalyco/opencode/issues/27924) (infinite overflow-compaction loop). |
-| `compactionLoopGuard.maxOverflowRecoveries` | integer | `2` | v0.31.1: consecutive overflow compactions tolerated before the guard trips. |
+| `compactionLoopGuard.enabled` | boolean | `true` | v0.31.2: defense against opencode [#27924](https://github.com/anomalyco/opencode/issues/27924) (infinite overflow-compaction loop). |
+| `compactionLoopGuard.maxOverflowRecoveries` | integer | `1` | v0.31.2: consecutive overflow compactions tolerated before the guard trips. |
 
 ### `protocolEnforcement`
 

package/dist/config.d.ts

@@ -69,6 +69,16 @@ export interface MetaGovernorPluginConfig {
         phaseAwareDoneSignal?: boolean;
         /** v0.19.0: persist intervention messages to the session (TUI-visible). */
         persistToSession?: boolean;
+        /**
+         * v0.31.1: overflow compaction loop guard. Defends against opencode
+         * bug #27924 (recursive overflow-only compactions). When the guard
+         * trips, the plugin flips opencode's autocontinue to disabled so the
+         * model can resume its pending tasks.
+         */
+        compactionLoopGuard?: {
+            enabled?: boolean;
+            maxOverflowRecoveries?: number;
+        };
     };
     /** Sisyphus protocol enforcement config. */
     protocolEnforcement?: {

package/dist/health.d.ts

@@ -101,3 +101,34 @@ export declare function describeLogFile(logPath: string): {
     sizeBytes: number;
     rotatedFiles: number;
 };
+/** Structural subset of MetricsCollector.getMetrics() the composer needs. */
+export interface MetricsSnapshotLike {
+    startedAtISO: string;
+    uptimeMs: number;
+    counters: Record<string, {
+        count?: number;
+        lastOccurrenceISO?: string | null;
+    } | undefined>;
+}
+export interface BuildPluginHealthInput {
+    version: string;
+    enabled: boolean;
+    sessionID: string;
+    snapshot: MetricsSnapshotLike;
+    logFilePath: string;
+}
+/**
+ * Compose a PluginHealth snapshot from a metrics snapshot. Single source
+ * of truth for BOTH omo_health and the plugin-side periodic writer, so
+ * the on-disk schema can never drift between the two paths.
+ */
+export declare function buildPluginHealth(input: BuildPluginHealthInput): PluginHealth;
+/**
+ * Rate-limited health writer. The first write always passes through;
+ * writes inside `minIntervalMs` of the previous accepted write are
+ * dropped, so audit-hook callers can invoke it on every event without
+ * hammering the disk.
+ */
+export declare function createThrottledHealthWriter(write: (health: PluginHealth) => void, minIntervalMs: number, now?: () => number): {
+    write: (health: PluginHealth) => void;
+};