@herjarsa/omo-meta-governor 0.24.7 → 0.26.0

package/dist/custom-tools.d.ts

@@ -237,4 +237,55 @@ export declare function buildOmoExplainTool(deps: OmoExplainDeps): {
         concept: string;
     }, context: ToolContext): Promise<ToolResult>;
 };
+export interface OmoFilesDeps {
+    /** Optional pre-configured GraphRetrieval. Defaults to getDefaultGraphRetrieval(). */
+    graphRetrieval?: GraphRetrieval;
+    cwd: string;
+}
+/**
+ * Build the `omo_files` tool. Lists files indexed by codegraph or graphify.
+ * Uses `codegraph files --project-path <cwd>` (falls back to graphify's
+ * graphify-out/wiki/index.md when codegraph is unavailable).
+ */
+export declare function buildOmoFilesTool(deps: OmoFilesDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+export interface OmoCallersDeps {
+    graphRetrieval?: GraphRetrieval;
+    cwd: string;
+}
+/**
+ * Build the `omo_callers` tool. Lists all call sites of a symbol.
+ * Uses `codegraph callers <symbol> --project-path <cwd>`. Returns null
+ * when codegraph is unavailable (codegraph-specific subcommand).
+ */
+export declare function buildOmoCallersTool(deps: OmoCallersDeps): {
+    description: string;
+    args: {
+        symbol: import("zod").ZodString;
+    };
+    execute(args: {
+        symbol: string;
+    }, context: ToolContext): Promise<ToolResult>;
+};
+export interface OmoNodeDeps {
+    graphRetrieval?: GraphRetrieval;
+    cwd: string;
+}
+/**
+ * Build the `omo_node` tool. Returns the source code of a symbol and its
+ * direct callers. Uses `codegraph node <symbol> --project-path <cwd>`.
+ * Returns null when codegraph is unavailable.
+ */
+export declare function buildOmoNodeTool(deps: OmoNodeDeps): {
+    description: string;
+    args: {
+        symbol: import("zod").ZodString;
+    };
+    execute(args: {
+        symbol: string;
+    }, context: ToolContext): Promise<ToolResult>;
+};
 export {};

package/dist/graph-sync.d.ts

@@ -36,9 +36,13 @@ export interface GraphSyncConfig {
     autoUpgrade?: boolean;
     /** v0.12.0: Min ms between registry queries for version check. Default 24h. */
     upgradeCheckTtlMs?: number;
+    /** v0.26.0: Override the upgrade cache file path (default ~/.config/opencode/omo-meta-governor-upgrade-check.json). Tests use this. */
+    upgradeCachePath?: string;
+    /** v0.26.0: also call `graphify check-update` on plugin load and trigger re-extraction when the semantic-update flag is set. Default true. */
+    checkGraphifyNeedsUpdate?: boolean;
     /** v0.21.0: test-only DI seam — replaces execSync so availability probes
-     * never spawn real npx/pip/graphify in hermetic tests (CI Windows: the
-     * npx download + 4 fallbacks exceeded the 30s test timeout). */
+       * never spawn real npx/pip/graphify in hermetic tests (CI Windows: the
+       * npx download + 4 fallbacks exceeded the 30s test timeout). */
     runner?: typeof execSync;
     /** v0.22.0: when true, graph-sync init sweeps orphaned graphify/codegraph
      * processes left by previous crashed runs. Default true. */
@@ -49,13 +53,13 @@ export type InstallCode = "codegraph-installed" | "codegraph-install-failed" | "
  * Install codegraph via `npm i -D @colbymchenry/codegraph`.
  * Best-effort, never throws.
  */
-export declare function installCodegraph(projectDir: string, timeoutMs?: number): Promise<InstallCode>;
+export declare function installCodegraph(projectDir: string, timeoutMs?: number, runner?: typeof execSync): Promise<InstallCode>;
 /**
  * Install graphify via `pip install graphifyy --break-system-packages`.
  * Falls back to `uv tool install graphifyy`.
  * Best-effort, never throws.
  */
-export declare function installGraphify(timeoutMs?: number): Promise<InstallCode>;
+export declare function installGraphify(timeoutMs?: number, runner?: typeof execSync): Promise<InstallCode>;
 export declare function resetInitializedProjects(): void;
 /**
  * Track a new session for a project. Increments reference count.
@@ -127,7 +131,7 @@ export interface GraphSyncResult {
     /** Whether this project was already initialized this session */
     alreadyInitialized: boolean;
 }
-export type GraphSyncCode = "codegraph-initialized" | "codegraph-init-failed" | "codegraph-already-exists" | "codegraph-unavailable" | "codegraph-install-failed" | "codegraph-install-skipped" | "graphify-initialized" | "graphify-init-failed" | "graphify-already-exists" | "graphify-unavailable" | "graphify-install-failed" | "graphify-install-skipped" | "watch-started-codegraph" | "watch-started-graphify" | "disabled" | "error" | "graphify-hook-installed" | "codegraph-upgraded" | "graphify-upgraded" | "upgrade-check-skipped";
+export type GraphSyncCode = "codegraph-initialized" | "codegraph-init-failed" | "codegraph-already-exists" | "codegraph-unavailable" | "codegraph-install-failed" | "codegraph-install-skipped" | "graphify-initialized" | "graphify-init-failed" | "graphify-already-exists" | "graphify-unavailable" | "graphify-install-failed" | "graphify-install-skipped" | "watch-started-codegraph" | "watch-started-graphify" | "disabled" | "error" | "graphify-hook-installed" | "codegraph-upgraded" | "graphify-upgraded" | "upgrade-check-skipped" | "codegraph-upgrade-broken" | "graphify-reextract-triggered" | "upgrade-cache-written";
 /**
 * Run the graphSync pipeline. Best-effort, never throws.
 */
@@ -218,12 +222,12 @@ export declare function fetchGraphifyLatestVersion(runner?: typeof execSync): Pr
  * v0.12.0: get the installed version of codegraph by running its CLI.
  * Returns null on failure.
  */
-export declare function getInstalledCodegraphVersion(): Promise<string | null>;
+export declare function getInstalledCodegraphVersion(runner?: typeof execSync): Promise<string | null>;
 /**
  * v0.12.0: get the installed version of graphify via pip show.
  * Returns null on failure.
  */
-export declare function getInstalledGraphifyVersion(): Promise<string | null>;
+export declare function getInstalledGraphifyVersion(runner?: typeof execSync): 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).