@herjarsa/omo-meta-governor 0.24.0 → 0.24.2

package/dist/config.d.ts

@@ -69,8 +69,6 @@ export interface MetaGovernorPluginConfig {
         phaseAwareDoneSignal?: boolean;
         /** v0.19.0: persist intervention messages to the session (TUI-visible). */
         persistToSession?: boolean;
-        /** v0.24.0: TUI toast notifications on intervention. Default true. */
-        toasts?: boolean;
     };
     /** Sisyphus protocol enforcement config. */
     protocolEnforcement?: {
@@ -88,6 +86,10 @@ export interface MetaGovernorPluginConfig {
         /** v0.22.0: when true, graph-sync init sweeps orphaned graphify/codegraph
          * 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. */
+        reindexOnFetch?: boolean;
+        /** v0.25.1: branch to fetch + compare against. Default "main". */
+        fetchBranch?: string;
     };
     /** Skill priming config (v0.20.0): proactive skill-selection nudge. */
     skillPriming?: {
@@ -97,6 +99,13 @@ export interface MetaGovernorPluginConfig {
     };
     /** Post-wave workflow gate (v0.21.0): landing directives after Oracle-approved waves. */
     postWave?: PostWaveConfig;
+    /**
+     * v0.25.0: explicit routing between codegraph and graphify.
+     * "auto" (default) | "codegraph" | "graphify" | "alternate".
+     */
+    graphRetrieval?: {
+        preferredTool?: "auto" | "codegraph" | "graphify" | "alternate";
+    };
 }
 /**
  * Project the full MetaGovernorPluginConfig into OrchestratorConfig.

package/dist/graph-retrieval.d.ts

@@ -23,6 +23,24 @@
  */
 import { existsSync } from "node:fs";
 export type GraphToolKind = "codegraph" | "graphify" | null;
+/**
+ * v0.25.0: explicit routing preference between codegraph and graphify.
+ * - "auto" (default): codegraph first, graphify as fallback.
+ * - "codegraph": always codegraph when available (never graphify).
+ * - "graphify": always graphify when available (never codegraph).
+ * - "alternate": deterministic per-query round-robin (hash parity).
+ */
+export type GraphToolPreference = "auto" | "codegraph" | "graphify" | "alternate";
+/**
+ * v0.25.0: pure selection logic — pick which graph tool to invoke.
+ * Deterministic (same inputs → same choice), platform-independent,
+ * unit-testable without subprocesses.
+ */
+export declare function selectGraphTool(preference: GraphToolPreference, codegraphAvailable: boolean, graphifyAvailable: boolean, query?: string): {
+    kind: "codegraph" | "graphify";
+    cmd: string;
+    args: string[];
+} | null;
 export interface GraphInvocationResult {
     /** Which tool was actually invoked. */
     kind: GraphToolKind;
@@ -42,6 +60,8 @@ export interface GraphRetrievalConfig {
     cacheTtlMs?: number;
     /** Max cache entries per session. Default: 10. */
     maxEntriesPerSession?: number;
+    /** v0.25.0: explicit codegraph/graphify routing. Default "auto". */
+    preferredTool?: GraphToolPreference;
 }
 export interface InvokeOptions {
     /** Override codegraph CLI path (default: lookup in PATH). */
@@ -52,6 +72,8 @@ export interface InvokeOptions {
     timeoutMs?: number;
     /** v0.16.0: project working directory. Defaults to process.cwd(). */
     projectDir?: string;
+    /** v0.25.0: per-call routing override. Default: instance preference. */
+    preferredTool?: GraphToolPreference;
 }
 /** Deterministic hash for a query string. Used as cache key suffix. */
 export declare function hashQuery(query: string): string;
@@ -60,7 +82,11 @@ export declare class GraphRetrieval {
     private readonly cacheTtlMs;
     private readonly maxEntriesPerSession;
     private readonly cache;
+    /** v0.25.0: routing preference. Mutable — configureDefaultGraphRetrieval updates it. */
+    private preferredTool;
     constructor(config?: GraphRetrievalConfig);
+    /** v0.25.0: runtime routing update (used by configureDefaultGraphRetrieval). */
+    setPreferredTool(preference: GraphToolPreference): void;
     /** Returns true if .codegraph/ exists in the project dir. */
     hasCodegraphDir(projectDir: string): boolean;
     /** Returns true if graphify-out/ exists in the project dir. */
@@ -83,9 +109,10 @@ export declare class GraphRetrieval {
      * Invoke a graph tool for the given query. Returns structured result.
      * Never throws — all errors are caught and returned as `result: null`.
      *
-     * Selection logic:
-     * 1. If `.codegraph/` exists and `codegraph` CLI is found → invoke codegraph
-     * 2. Else if `graphify-out/` exists and `graphify` CLI is found → invoke graphify
+     * Selection logic (v0.25.0 — explicit routing via selectGraphTool):
+     * - preferredTool "auto": codegraph first, graphify fallback.
+     * - "codegraph" / "graphify": only that tool (when available).
+     * - "alternate": deterministic hash-parity round-robin when both exist.
      * 3. Else → return null result
      */
     invoke(projectDir: string, query: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
@@ -132,4 +159,11 @@ export declare class GraphRetrieval {
 }
 /** Returns the process-wide singleton, creating it on first use. */
 export declare function getDefaultGraphRetrieval(): GraphRetrieval;
+/**
+ * v0.25.0: update the singleton's routing preference WITHOUT replacing the
+ * instance — tools capture the reference at build time (omo_search) or
+ * resolve it at execute time (omo_path/omo_explain); replacing would
+ * strand the captured instance.
+ */
+export declare function configureDefaultGraphRetrieval(config: GraphRetrievalConfig): void;
 export { existsSync };

package/dist/graph-sync.d.ts

@@ -207,17 +207,13 @@ export declare function isCacheFresh(cache: UpgradeCache | null, ttlMs: number):
  * - If installed >= effective-latest → false.
  * - Otherwise → true.
  */
-export declare function shouldUpgrade(installed: string | null | undefined, registryLatest: string | null | undefined, cache: UpgradeCache | null, ttlMs: number): boolean;
+export declare function shouldUpgrade(installed: string | null | undefined, registryLatest: string | null | undefined, cache: UpgradeCache | null, ttlMs: number, latestField?: "codegraphLatest" | "graphifyLatest"): boolean;
 /**
  * v0.12.0: fetch the latest version of codegraph from npm registry.
  * Returns null on failure (best-effort, never throws).
  */
 export declare function fetchCodegraphLatestVersion(): Promise<string | null>;
-/**
- * v0.12.0: fetch the latest version of graphify from pip.
- * Returns null on failure (best-effort, never throws).
- */
-export declare function fetchGraphifyLatestVersion(): Promise<string | null>;
+export declare function fetchGraphifyLatestVersion(runner?: typeof execSync): Promise<string | null>;
 /**
  * v0.12.0: get the installed version of codegraph by running its CLI.
  * Returns null on failure.
@@ -228,3 +224,9 @@ export declare function getInstalledCodegraphVersion(): Promise<string | null>;
  * Returns null on failure.
  */
 export declare function getInstalledGraphifyVersion(): Promise<string | null>;
+/**
+* v0.25.1: count commits the local HEAD is behind origin/&lt;branch&gt;.
+* Best-effort, never throws — returns 0 on any failure (no git, offline, no remote).
+* Used by the plugin-load watcher to decide whether to trigger a reindex.
+*/
+export declare function detectRemoteNewCommits(projectDir: string, branch: string | undefined, runner?: typeof execSync): number;