@herjarsa/omo-meta-governor 0.26.3 → 0.27.0

package/dist/config.d.ts

@@ -100,6 +100,10 @@ export interface MetaGovernorPluginConfig {
          * 'graphify-reextract-triggered' diagnostic code if the schema changed.
          * 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 (opt-in — multi-project users want explicit control). */
+        addToGlobalGraph?: boolean;
     };
     /** Skill priming config (v0.20.0): proactive skill-selection nudge. */
     skillPriming?: {
@@ -115,6 +119,13 @@ export interface MetaGovernorPluginConfig {
      */
     graphRetrieval?: {
         preferredTool?: "auto" | "codegraph" | "graphify" | "alternate";
+        /** v0.27.0: when true, prefer the locally-installed codegraph binary
+         * (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
+         * returns a conceptual explanation. */
+        contextRouting?: boolean;
     };
 }
 /**

package/dist/custom-tools.d.ts

@@ -288,4 +288,157 @@ export declare function buildOmoNodeTool(deps: OmoNodeDeps): {
         symbol: string;
     }, context: ToolContext): Promise<ToolResult>;
 };
+export interface OmoGraphToolDeps {
+    graphRetrieval?: GraphRetrieval;
+    cwd: string;
+}
+/** `codegraph context <task>` — task-focused code context window. */
+export declare function buildOmoContextTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {
+        task: import("zod").ZodString;
+    };
+    execute(args: {
+        task: string;
+    }, context: ToolContext): Promise<ToolResult>;
+};
+/** `codegraph affected <files>` — files affected by changes in the given files. */
+export declare function buildOmoAffectedCgTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {
+        files: import("zod").ZodArray<import("zod").ZodString>;
+    };
+    execute(args: {
+        files: string[];
+    }, context: ToolContext): Promise<ToolResult>;
+};
+/** `codegraph status` — codegraph health (node count, version, last update). */
+export declare function buildOmoStatusTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `codegraph unlock` — remove stale lock file. */
+export declare function buildOmoUnlockTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `codegraph mark-dirty` — mark the graph as needing a re-sync. */
+export declare function buildOmoMarkDirtyTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `codegraph sync-if-dirty` — sync only if the graph was marked dirty. */
+export declare function buildOmoSyncIfDirtyTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `codegraph index` — manual full index trigger. */
+export declare function buildOmoIndexTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `codegraph visualize` — generate visualization HTML. */
+export declare function buildOmoVisualizeTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `codegraph serve --port <n>` — start the codegraph server. */
+export declare function buildOmoServeTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {
+        port: import("zod").ZodNumber;
+    };
+    execute(args: {
+        port: number;
+    }, context: ToolContext): Promise<ToolResult>;
+};
+/** `codegraph uninit` — remove the codegraph index from disk. */
+export declare function buildOmoUninitTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `graphify diagnose` — find multigraph warnings and inconsistencies. */
+export declare function buildOmoDiagnoseTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `graphify merge-driver` — 3-way merge of conflicting graph segments. */
+export declare function buildOmoMergeGraphsTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `graphify save-result` — persist the last query result. */
+export declare function buildOmoSaveResultTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `graphify extract` — re-run semantic extraction over the source tree. */
+export declare function buildOmoExtractTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `graphify cluster-only` — re-run clustering only. */
+export declare function buildOmoClusterOnlyTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `graphify label <node>` — apply a label to a node. */
+export declare function buildOmoLabelTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {
+        node: import("zod").ZodString;
+    };
+    execute(args: {
+        node: string;
+    }, context: ToolContext): Promise<ToolResult>;
+};
+/** `graphify tree` — emit a tree visualization. */
+export declare function buildOmoTreeTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `graphify clone` — clone the graph to a new path. */
+export declare function buildOmoCloneTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+/** `graphify add <files>` — add specific files to the graph. */
+export declare function buildOmoAddTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {
+        files: import("zod").ZodString;
+    };
+    execute(args: {
+        files: string;
+    }, context: ToolContext): Promise<ToolResult>;
+};
+/** `graphify check-update` — check if schema or extractors changed. */
+export declare function buildOmoCheckUpdateTool(deps: OmoGraphToolDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
+export interface OmoHookStatusDeps {
+    cwd: string;
+}
+/** `graphify hook status` — check whether the graphify post-commit hook is installed. */
+export declare function buildOmoHookStatusTool(deps: OmoHookStatusDeps): {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
+};
 export {};

package/dist/graph-retrieval.d.ts

@@ -138,6 +138,26 @@ export declare class GraphRetrieval {
      * Runs `codegraph files --project-path <cwd>`.
      */
     invokeFiles(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `codegraph context <task>` — task-focused context window. */
+    invokeContext(task: string, projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `codegraph affected <file...>` — files affected by changes in the given files. */
+    invokeAffected(files: string[], projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `codegraph status` — codegraph health (node count, version, last update). */
+    invokeStatus(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `codegraph unlock` — remove stale lock file. */
+    invokeUnlock(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `codegraph mark-dirty` — mark the graph dirty. */
+    invokeMarkDirty(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `codegraph sync-if-dirty` — sync if the graph was marked dirty. */
+    invokeSyncIfDirty(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `codegraph index` — manual full index trigger. */
+    invokeIndex(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `codegraph visualize` — generate visualization HTML. */
+    invokeVisualize(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `codegraph serve --port <n>` — start the codegraph server. */
+    invokeServe(port: number, projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `codegraph uninit` — remove the codegraph index from disk. */
+    invokeUninit(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
     /**
      * Run a codegraph sub-command and return the result.
      * Returns null result if codegraph is not available.
@@ -156,6 +176,26 @@ export declare class GraphRetrieval {
      */
     invokeExplain(concept: string, projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
     private invokeGraphifySubcommand;
+    /** `graphify diagnose` — find multigraph warnings and inconsistencies. */
+    invokeDiagnose(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `graphify merge-driver` — 3-way merge of conflicting graph segments. */
+    invokeMergeDriver(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `graphify save-result` — persist the last query result. */
+    invokeSaveResult(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `graphify extract` — re-run semantic extraction over the source tree. */
+    invokeExtract(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `graphify cluster-only` — re-run clustering only (skip extraction). */
+    invokeClusterOnly(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `graphify label <node>` — apply a label to a node. */
+    invokeLabel(node: string, projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `graphify tree` — emit a tree visualization. */
+    invokeTree(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `graphify clone` — clone the graph to a new path. */
+    invokeClone(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `graphify add <files>` — add specific files to the graph. */
+    invokeAdd(files: string, projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
+    /** `graphify check-update` — check if schema or extractors changed. */
+    invokeCheckUpdate(projectDir: string, options?: InvokeOptions): Promise<GraphInvocationResult>;
 }
 /** Returns the process-wide singleton, creating it on first use. */
 export declare function getDefaultGraphRetrieval(): GraphRetrieval;

package/dist/graph-sync.d.ts

@@ -40,6 +40,9 @@ export interface GraphSyncConfig {
     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.27.0: opt-in. Register the project graph in the global graphify
+     * registry after initial install so 'graphify global list' surfaces it. */
+    addToGlobalGraph?: 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). */
@@ -131,7 +134,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" | "codegraph-upgrade-broken" | "graphify-reextract-triggered" | "upgrade-cache-written";
+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" | "graphify-added-to-global" | "graphify-global-add-failed";
 /**
 * Run the graphSync pipeline. Best-effort, never throws.
 */