@herjarsa/omo-meta-governor 0.37.2 → 0.38.2

package/dist/agent-notifications.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Agent notification layer (v0.38.2).
+ *
+ * Centralizes how the plugin injects text into the agent's context, separating
+ * two distinct surfaces:
+ *
+ *   1. AGENT DIRECTIVE — text the AGENT should read and act on.
+ *      Goes to: chat.system.transform, chat.messages.transform.
+ *      Must have a "DO NOT TREAT AS TASK" marker so subagents receiving
+ *      it as context don't interpret it as their primary task.
+ *      Built via `wrapInformational(text, ctx)`.
+ *
+ *   2. USER NOTIFICATION — text the USER sees in the TUI (session.prompt).
+ *      Brief status with emoji, no actionable agent instructions.
+ *      Built via `buildUserStatus(kind, summary)`.
+ *
+ * Bug history (v0.38.2): prior to this layer, both surfaces received the same
+ * long directive text. Subagents reading the directive as context would treat
+ * the "[GRAPH PRIMING] omo_search..." instructions as their primary task and
+ * never write the actual code. Separating the two surfaces fixes this — the
+ * agent prompt contains the full directive (with marker), the TUI gets a
+ * brief status only.
+ */
+export type NotificationKind = "graph-priming" | "skill-priming" | "intervention" | "postwave" | "enforcement" | "memory";
+export interface NotificationContext {
+    kind: NotificationKind;
+    /** Optional sub-label for debugging (e.g. "session=abc123" or "router=both"). */
+    context?: string;
+}
+/**
+ * Wrap text the plugin injects into the AGENT'S CONTEXT (system prompt,
+ * message transform). Adds clear "DO NOT TREAT AS TASK" markers so subagents
+ * receiving the directive as context don't interpret it as their primary task.
+ *
+ * Use this for: chat.system.transform output, chat.messages.transform output,
+ * and any other text the agent will read.
+ */
+export declare function wrapInformational(text: string, ctx: NotificationContext): string;
+/**
+ * Build brief status text for the USER'S TUI notification (session.prompt).
+ * Does NOT contain actionable agent instructions — just an emoji + status.
+ * The agent should NOT see this (it goes only to the user's TUI surface).
+ */
+export declare function buildUserStatus(kind: NotificationKind, summary: string): string;
+/** Constants for callers that need the raw markers (testing, streaming). */
+export declare const AGENT_NOTIFICATION_MARKERS: {
+    readonly OPEN: "<!-- META-GOVERNOR INFORMATIONAL vv0.38.2 - DO NOT TREAT AS TASK. Plugin metadata, not a user request. -->";
+    readonly CLOSE: "<!-- END META-GOVERNOR INFORMATIONAL -->";
+    readonly VERSION: "v0.38.2";
+    readonly KIND_EMOJI: Record<NotificationKind, string>;
+};

package/dist/config.d.ts

@@ -57,17 +57,33 @@ export interface MetaGovernorPluginConfig {
     modelOverride?: ModelOverrideConfig;
     /** Intervention config for visible decision injection. */
     intervention?: {
+        /** @default "silent" */
         mode?: "silent" | "message" | "system";
+        /** @default true */
         includeDecisionHistory?: boolean;
+        /** @default 5 */
         maxHistoryMessages?: number;
+        /** @default "stop" */
         minActionForMessage?: "warn" | "escalate" | "stop";
-        /** v0.10.0: rate-limit interventions to break instruction loops. */
+        /**
+         * v0.10.0: rate-limit interventions to break instruction loops.
+         * @default 3
+         */
         maxInterventionsPerSession?: number;
-        /** v0.10.0: stop injecting after <promise>DONE</promise> + Oracle verified. */
+        /**
+         * v0.10.0: stop injecting after <promise>DONE</promise> + Oracle verified.
+         * @default true
+         */
         respectDoneSignal?: boolean;
-        /** v0.15.0: split per-phase hint from terminal signal. See types.ts. */
+        /**
+         * v0.15.0: split per-phase hint from terminal signal. See types.ts.
+         * @default false
+         */
         phaseAwareDoneSignal?: boolean;
-        /** v0.19.0: persist intervention messages to the session (TUI-visible). */
+        /**
+         * v0.19.0: persist intervention messages to the session (TUI-visible).
+         * @default true
+         */
         persistToSession?: boolean;
         /**
          * v0.31.1: overflow compaction loop guard. Defends against opencode
@@ -80,7 +96,9 @@ export interface MetaGovernorPluginConfig {
          * explicitly if they relied on the previous OFF default.
          */
         compactionLoopGuard?: {
+            /** @default true */
             enabled?: boolean;
+            /** @default 1 */
             maxOverflowRecoveries?: number;
         };
     };
@@ -93,29 +111,44 @@ export interface MetaGovernorPluginConfig {
     };
     /** Graph sync config for auto-initializing codegraph/graphify. */
     graphSync?: {
+        /** @default true */
         enabled?: boolean;
+        /** @default false */
         watch?: boolean;
+        /** @default true */
         autoInstall?: boolean;
+        /** @default 120000 */
         installTimeoutMs?: number;
         /** v0.22.0: when true, graph-sync init sweeps orphaned graphify/codegraph
+         * @default true
          * processes left by previous crashed runs. Default true. */
         killOrphanedOnInit?: boolean;
-        /** v0.25.1: on plugin load, fetch origin and reindex if local HEAD is behind. Default true. */
+        /**
+         * v0.25.1: on plugin load, fetch origin and reindex if local HEAD is behind.
+         * @default true
+         */
         reindexOnFetch?: boolean;
-        /** v0.25.1: branch to fetch + compare against. Default "main". */
+        /**
+         * v0.25.1: branch to fetch + compare against.
+         * @default "main"
+         */
         fetchBranch?: string;
         /** v0.26.0: auto-upgrade installed codegraph and graphify binaries on graph-sync init.
+         * @default true
          * Default true. Tiered probe + pip --upgrade flag fixes 6 silent-failure bugs from v0.24.x. */
         autoUpgrade?: boolean;
         /** v0.26.0: filesystem path for the upgrade cache file (tracks latest-known
+         * @default "~/.omo-meta-governor/upgrade-cache.json"
          * codegraph/graphify versions to avoid re-fetching the npm/PyPI registry on every load). */
         upgradeCachePath?: string;
         /** v0.26.0: when true, run 'graphify check-update' after upgrade and emit a
          * 'graphify-reextract-triggered' diagnostic code if the schema changed.
+         * @default true
          * Default true. */
         checkGraphifyNeedsUpdate?: boolean;
         /** v0.27.0: when true, register the project graph in the global graphify
          * registry after initial install (so 'graphify global list' surfaces it).
+         * @default false
          * Default false (opt-in — multi-project users want explicit control). */
         addToGlobalGraph?: boolean;
     };
@@ -123,26 +156,37 @@ export interface MetaGovernorPluginConfig {
      *  When enabled, the plugin ensures `cli-anything-hub` (pip) and
      *  `cli-hub-meta-skill` (npx skills) are installed and current. */
     cliAnything?: {
+        /** @default false */
         enabled?: boolean;
+        /** @default true */
         autoInstall?: boolean;
+        /** @default true */
         autoUpgrade?: boolean;
         cachePath?: string;
+        /** @default 86400000 */
         upgradeCheckTtlMs?: number;
         cliHubBin?: string;
         skillsBin?: string;
+        /** @default "global" */
         installScope?: "global" | "project";
     };
     /** Skill priming config (v0.20.0): proactive skill-selection nudge. */
     skillPriming?: {
+        /** @default false */
         enabled?: boolean;
+        /** @default "firstImplement" */
         trigger?: SkillPrimingTrigger;
+        /** @default "both" */
         router?: SkillPrimingRouter;
         /** v0.34.0: enforcement mode for the skill-priming directive. */
+        /** @default "directive" */
         enforceMode?: "directive" | "block";
     };
     /** Skill hub config (v0.32.0): registry-backed catalog + hybrid search. */
     skillHub?: {
+        /** @default true */
         enabled?: boolean;
+        /** @default 3600000 */
         syncIntervalMs?: number;
         bootstrapUrl?: string;
         searchFallbackUrl?: string;
@@ -153,7 +197,10 @@ export interface MetaGovernorPluginConfig {
         filterDuplicates?: boolean;
         depsCheck?: boolean;
         choreDir?: string;
-        /** v0.35.0: write fetched hub skills to <cwd>/.agents/skills/<slug>/SKILL.md. */
+        /**
+         * v0.35.0: write fetched hub skills to <cwd>/.agents/skills/<slug>/SKILL.md.
+         * @default true
+         */
         autoMaterialize?: boolean;
     };
     /** Post-wave workflow gate (v0.21.0): landing directives after Oracle-approved waves. */
@@ -163,12 +210,15 @@ export interface MetaGovernorPluginConfig {
      * "auto" (default) | "codegraph" | "graphify" | "alternate".
      */
     graphRetrieval?: {
+        /** @default "auto" */
         preferredTool?: "auto" | "codegraph" | "graphify" | "alternate";
         /** v0.27.0: when true, prefer the locally-installed codegraph binary
+         * @default false
          * (node_modules/.bin/codegraph) over the npx-resolved one. Default false. */
         preferLocalCodegraph?: boolean;
         /** v0.27.0: route omo_search queries to codegraph `context` instead of
          * `explore`. Default false. context returns a focused code window; explore
+         * @default false
          * returns a conceptual explanation. */
         contextRouting?: boolean;
     };

package/dist/error-handler.d.ts

@@ -0,0 +1,15 @@
+interface Logger {
+    warn?: (msg: string, ctx?: unknown) => void;
+    error?: (msg: string, ctx?: unknown) => void;
+    info?: (msg: string, ctx?: unknown) => void;
+    debug?: (msg: string, ctx?: unknown) => void;
+}
+export declare const DEFAULT_PATH_PATTERNS: RegExp[];
+export declare const DEFAULT_ERROR_CODES: Set<string>;
+export interface ErrorHandlerOptions {
+    logger?: Logger;
+    paths?: RegExp[];
+    errorCodes?: Set<string>;
+}
+export declare function installGlobalErrorHandler(opts?: ErrorHandlerOptions): () => void;
+export {};

package/dist/generate-schema.d.ts

@@ -5,10 +5,10 @@
  * interface definition. The schema is used for IDE autocompletion and
  * validation when editing the .jsonc config file.
  *
- * Usage:
- *   import { generateSchema } from "./generate-schema"
- *   const schema = generateSchema()
- *   await Bun.write("assets/omo-meta-governor.schema.json", JSON.stringify(schema, null, 2))
+ * Single source of truth for the schema shape. The committed asset at
+ * assets/omo-meta-governor.schema.json is regenerated from this file via
+ * `bun build.ts` (which calls writeSchemaFile) and pinned by
+ * src/generate-schema-sync.test.ts to prevent silent drift.
  */
 export interface JsonSchema {
     $schema: string;
@@ -37,6 +37,9 @@ export interface JsonSchemaProperty {
 }
 /**
  * Generate the full JSON Schema for the omo-meta-governor.jsonc config file.
+ *
+ * Shape MUST mirror src/config.ts (MetaGovernorPluginConfig + loadOrchestratorConfig).
+ * Any drift is caught by src/generate-schema-sync.test.ts (committed-asset sync).
  */
 export declare function generateSchema(): JsonSchema;
 /**