@grafema/mcp 0.2.12-beta → 0.3.0-beta

package/dist/config.js

@@ -1,81 +1,25 @@
 /**
  * MCP Server Configuration
+ *
+ * Loads grafema config via the shared loader from @grafema/util.
+ * Plugin instantiation is no longer needed — grafema-orchestrator handles analysis.
  */
-import { join } from 'path';
-import { existsSync, readdirSync } from 'fs';
-import { pathToFileURL } from 'url';
 import { log } from './utils.js';
-import { loadConfig as loadConfigFromCore } from '@grafema/core';
-// === PLUGIN IMPORTS ===
-import { 
-// Indexing
-JSModuleIndexer, RustModuleIndexer, 
-// Analysis
-JSASTAnalyzer, ExpressRouteAnalyzer, ExpressResponseAnalyzer, NestJSRouteAnalyzer, SocketIOAnalyzer, DatabaseAnalyzer, FetchAnalyzer, SocketAnalyzer, ServiceLayerAnalyzer, ReactAnalyzer, RustAnalyzer, 
-// Enrichment
-MethodCallResolver, ArgumentParameterLinker, AliasTracker, ClosureCaptureEnricher, ValueDomainAnalyzer, MountPointResolver, ExpressHandlerLinker, PrefixEvaluator, ImportExportLinker, InstanceOfResolver, HTTPConnectionEnricher, CallbackCallResolver, SocketConnectionEnricher, ConfigRoutingMapBuilder, ServiceConnectionEnricher, RustFFIEnricher, RejectionPropagationEnricher, 
-// Validation
-CallResolverValidator, EvalBanValidator, SQLInjectionValidator, AwaitInLoopValidator, ShadowingDetector, GraphConnectivityValidator, DataFlowValidator, TypeScriptDeadCodeValidator, BrokenImportValidator, UnconnectedRouteValidator, } from '@grafema/core';
+import { loadConfig as loadConfigFromUtil } from '@grafema/util';
 const MCP_DEFAULTS = {
     discovery: {
         enabled: true,
         customOnly: false,
     },
 };
-export const BUILTIN_PLUGINS = {
-    // Indexing
-    JSModuleIndexer: () => new JSModuleIndexer(),
-    RustModuleIndexer: () => new RustModuleIndexer(),
-    // Analysis
-    JSASTAnalyzer: () => new JSASTAnalyzer(),
-    ExpressRouteAnalyzer: () => new ExpressRouteAnalyzer(),
-    ExpressResponseAnalyzer: () => new ExpressResponseAnalyzer(),
-    NestJSRouteAnalyzer: () => new NestJSRouteAnalyzer(),
-    SocketIOAnalyzer: () => new SocketIOAnalyzer(),
-    DatabaseAnalyzer: () => new DatabaseAnalyzer(),
-    FetchAnalyzer: () => new FetchAnalyzer(),
-    SocketAnalyzer: () => new SocketAnalyzer(),
-    ServiceLayerAnalyzer: () => new ServiceLayerAnalyzer(),
-    ReactAnalyzer: () => new ReactAnalyzer(),
-    RustAnalyzer: () => new RustAnalyzer(),
-    // Enrichment
-    MethodCallResolver: () => new MethodCallResolver(),
-    ArgumentParameterLinker: () => new ArgumentParameterLinker(),
-    AliasTracker: () => new AliasTracker(),
-    ClosureCaptureEnricher: () => new ClosureCaptureEnricher(),
-    ValueDomainAnalyzer: () => new ValueDomainAnalyzer(),
-    MountPointResolver: () => new MountPointResolver(),
-    ExpressHandlerLinker: () => new ExpressHandlerLinker(),
-    PrefixEvaluator: () => new PrefixEvaluator(),
-    ImportExportLinker: () => new ImportExportLinker(),
-    InstanceOfResolver: () => new InstanceOfResolver(),
-    HTTPConnectionEnricher: () => new HTTPConnectionEnricher(),
-    CallbackCallResolver: () => new CallbackCallResolver(),
-    SocketConnectionEnricher: () => new SocketConnectionEnricher(),
-    ConfigRoutingMapBuilder: () => new ConfigRoutingMapBuilder(),
-    ServiceConnectionEnricher: () => new ServiceConnectionEnricher(),
-    RustFFIEnricher: () => new RustFFIEnricher(),
-    RejectionPropagationEnricher: () => new RejectionPropagationEnricher(),
-    // Validation
-    CallResolverValidator: () => new CallResolverValidator(),
-    EvalBanValidator: () => new EvalBanValidator(),
-    SQLInjectionValidator: () => new SQLInjectionValidator(),
-    AwaitInLoopValidator: () => new AwaitInLoopValidator(),
-    ShadowingDetector: () => new ShadowingDetector(),
-    GraphConnectivityValidator: () => new GraphConnectivityValidator(),
-    DataFlowValidator: () => new DataFlowValidator(),
-    TypeScriptDeadCodeValidator: () => new TypeScriptDeadCodeValidator(),
-    BrokenImportValidator: () => new BrokenImportValidator(),
-    UnconnectedRouteValidator: () => new UnconnectedRouteValidator(),
-};
 // === CONFIG LOADING ===
 /**
  * Load MCP configuration (extends base GrafemaConfig).
- * Uses shared ConfigLoader but adds MCP-specific defaults.
+ * Uses shared loader but adds MCP-specific defaults.
  */
 export function loadConfig(projectPath) {
     // Use shared loader (handles YAML/JSON, deprecation warnings)
-    const baseConfig = loadConfigFromCore(projectPath, {
+    const baseConfig = loadConfigFromUtil(projectPath, {
         warn: (msg) => log(`[Grafema MCP] ${msg}`),
     });
     // Add MCP-specific defaults
@@ -84,70 +28,4 @@ export function loadConfig(projectPath) {
         ...MCP_DEFAULTS,
     };
 }
-export async function loadCustomPlugins(projectPath) {
-    const pluginsDir = join(projectPath, '.grafema', 'plugins');
-    if (!existsSync(pluginsDir)) {
-        return { plugins: [], pluginMap: {} };
-    }
-    const customPlugins = [];
-    const pluginMap = {};
-    try {
-        const files = readdirSync(pluginsDir).filter((f) => f.endsWith('.js') || f.endsWith('.mjs'));
-        for (const file of files) {
-            try {
-                const pluginPath = join(pluginsDir, file);
-                const pluginUrl = pathToFileURL(pluginPath).href;
-                const module = await import(pluginUrl);
-                const PluginClass = module.default || module[file.replace(/\.(m?js)$/, '')];
-                if (PluginClass && typeof PluginClass === 'function') {
-                    const pluginName = PluginClass.name || file.replace(/\.(m?js)$/, '');
-                    const instance = new PluginClass();
-                    if (instance.config) {
-                        instance.config.sourceFile = pluginPath;
-                    }
-                    customPlugins.push(instance);
-                    pluginMap[pluginName] = PluginClass;
-                    log(`[Grafema MCP] Loaded custom plugin: ${pluginName} from ${file}`);
-                }
-            }
-            catch (err) {
-                const message = err instanceof Error ? err.message : String(err);
-                log(`[Grafema MCP] Failed to load plugin ${file}: ${message}`);
-            }
-        }
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        log(`[Grafema MCP] Error loading custom plugins: ${message}`);
-    }
-    return { plugins: customPlugins, pluginMap };
-}
-// === PLUGIN INSTANTIATION ===
-export function createPlugins(config, customPluginMap = {}) {
-    const pluginNames = [
-        ...config.indexing,
-        ...config.analysis,
-        ...config.enrichment,
-        ...config.validation,
-    ];
-    const plugins = [];
-    const availablePlugins = {
-        ...BUILTIN_PLUGINS,
-        ...Object.fromEntries(Object.entries(customPluginMap).map(([name, PluginClass]) => [
-            name,
-            () => new PluginClass(),
-        ])),
-    };
-    for (const name of pluginNames) {
-        const factory = availablePlugins[name];
-        if (factory) {
-            plugins.push(factory());
-            log(`[Grafema MCP] Enabled plugin: ${name}`);
-        }
-        else {
-            log(`[Grafema MCP] Plugin not found: ${name} (skipping)`);
-        }
-    }
-    return plugins;
-}
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAsB,MAAM,eAAe,CAAC;AAkBrF,MAAM,YAAY,GAAiC;IACjD,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,KAAK;KAClB;CACF,CAAC;AAEF,yBAAyB;AACzB;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,8DAA8D;IAC9D,MAAM,UAAU,GAAG,kBAAkB,CAAC,WAAW,EAAE;QACjD,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,iBAAiB,GAAG,EAAE,CAAC;KAC3C,CAAC,CAAC;IAEH,4BAA4B;IAC5B,OAAO;QACL,GAAG,UAAU;QACb,GAAG,YAAY;KAChB,CAAC;AACJ,CAAC"}

package/dist/definitions/analysis-tools.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Analysis Tools — project analysis and schema inspection
+ */
+import type { ToolDefinition } from './types.js';
+export declare const ANALYSIS_TOOLS: ToolDefinition[];
+//# sourceMappingURL=analysis-tools.d.ts.map

package/dist/definitions/analysis-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-tools.d.ts","sourceRoot":"","sources":["../../src/definitions/analysis-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,cAAc,EAAE,cAAc,EAwH1C,CAAC"}

package/dist/definitions/analysis-tools.js

@@ -0,0 +1,125 @@
+/**
+ * Analysis Tools — project analysis and schema inspection
+ */
+export const ANALYSIS_TOOLS = [
+    {
+        name: 'discover_services',
+        description: `Discover services in the project without running full analysis.
+
+Use this during onboarding to understand project structure BEFORE running analyze_project.
+
+Returns:
+- Service names and paths (e.g., "backend" at "apps/backend")
+- Entry points (e.g., "src/index.ts")
+- No graph data yet — this is fast discovery only
+
+Workflow:
+1. discover_services — see what's in the project
+2. analyze_project — build graph for specific service or all
+3. Query tools — explore the graph
+
+Tip: If project has no .grafema/config.yaml, this scans for common patterns
+(package.json, index.ts, etc.). Use write_config to save the configuration.`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'analyze_project',
+        description: `Build the code graph by analyzing project source code.
+
+REQUIRED before using query tools. Without analysis, the graph is empty.
+
+Options:
+- service: Analyze only one service (faster for multi-service projects)
+- force: Re-analyze even if graph exists (use after code changes)
+- index_only: Fast mode — create MODULE nodes only, skip detailed analysis
+
+Phases: Discovery → Indexing → Analysis → Enrichment → Validation
+Returns: Analysis summary with node/edge counts and timing.
+
+Tip: Use get_stats after analysis to verify graph was built successfully.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                service: {
+                    type: 'string',
+                    description: 'Optional: analyze only this service',
+                },
+                force: {
+                    type: 'boolean',
+                    description: 'Force re-analysis even if already analyzed',
+                },
+                index_only: {
+                    type: 'boolean',
+                    description: 'Only index modules, skip full analysis',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_analysis_status',
+        description: `Get the current analysis status and progress.
+
+Use this to:
+- Poll progress during long-running analysis (started by analyze_project)
+- Check if analysis is still running before making queries
+- See which phase is active (discovery, indexing, analysis, enrichment, validation)
+
+Returns: { running: boolean, phase: string, progress: number, error: string | null }
+
+Call this periodically after analyze_project to monitor progress.`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'get_stats',
+        description: `Get graph statistics: node and edge counts by type.
+
+Use this to:
+- Verify analysis completed: nodeCount > 0 means the graph is loaded
+- Understand graph size before running expensive queries
+- See what node/edge types exist in this particular codebase
+- Debug empty results: check if expected node types are present
+
+Returns:
+- nodeCount, edgeCount: Total counts
+- nodesByType: {FUNCTION: 1234, CLASS: 56, ...}
+- edgesByType: {CALLS: 5678, CONTAINS: 3456, ...}
+
+Use BEFORE querying an unfamiliar graph to understand what data is available.`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'get_schema',
+        description: `Get the graph schema: available node and edge types with counts.
+
+Use this to:
+- Discover what types exist: "What node types does this graph have?"
+- Validate edge types before traverse_graph or get_neighbors
+- Understand graph structure before writing Datalog queries
+- Find correct type names (e.g., "http:route" not "HTTP_ROUTE")
+
+Options:
+- type: "nodes" (node types only), "edges" (edge types only), "all" (default)
+
+Tip: Run this first when exploring a new graph to learn the available vocabulary.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    description: 'nodes, edges, or all (default: all)',
+                    enum: ['nodes', 'edges', 'all'],
+                },
+            },
+        },
+    },
+];
+//# sourceMappingURL=analysis-tools.js.map

package/dist/definitions/analysis-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-tools.js","sourceRoot":"","sources":["../../src/definitions/analysis-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE;;;;;;;;;;;;;;;4EAe2D;QACxE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE;;;;;;;;;;;;0EAYyD;QACtE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;iBACnD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,4CAA4C;iBAC1D;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,wCAAwC;iBACtD;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE;;;;;;;;;kEASiD;QAC9D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE;;;;;;;;;;;;;8EAa6D;QAC1E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE;;;;;;;;;;;kFAWiE;QAC9E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;oBAClD,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC;iBAChC;aACF;SACF;KACF;CACF,CAAC"}

package/dist/definitions/context-tools.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Context Tools — node details, context, file overview, guards
+ */
+import type { ToolDefinition } from './types.js';
+export declare const CONTEXT_TOOLS: ToolDefinition[];
+//# sourceMappingURL=context-tools.d.ts.map

package/dist/definitions/context-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tools.d.ts","sourceRoot":"","sources":["../../src/definitions/context-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,aAAa,EAAE,cAAc,EA4IzC,CAAC"}

package/dist/definitions/context-tools.js

@@ -0,0 +1,144 @@
+/**
+ * Context Tools — node details, context, file overview, guards
+ */
+export const CONTEXT_TOOLS = [
+    {
+        name: 'get_function_details',
+        description: `Get comprehensive details about a function, including what it calls and who calls it.
+
+Graph structure:
+  FUNCTION -[HAS_SCOPE]-> SCOPE -[CONTAINS]-> CALL/METHOD_CALL
+  CALL -[CALLS]-> FUNCTION (target)
+
+Returns:
+- Function metadata (name, file, line, async)
+- calls: What functions/methods this function calls
+- calledBy: What functions call this one
+
+For calls array:
+- resolved=true means target function was found
+- resolved=false means unknown target (external/dynamic)
+- type='CALL' for function calls like foo()
+- type='METHOD_CALL' for method calls like obj.method()
+- depth field shows transitive level (0=direct, 1+=indirect)
+
+Use transitive=true to follow call chains (A calls B calls C).
+Max transitive depth is 5 to prevent explosion.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'Function name to look up',
+                },
+                file: {
+                    type: 'string',
+                    description: 'Optional: file path to disambiguate (partial match)',
+                },
+                transitive: {
+                    type: 'boolean',
+                    description: 'Follow call chains recursively (default: false)',
+                },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'get_context',
+        description: `Get deep context for a graph node: source code + full graph neighborhood.
+
+Shows ALL incoming and outgoing edges grouped by type, with source code
+at each connected node's location. Works for ANY node type.
+
+Use this after find_nodes or query_graph to deep-dive into a specific node.
+
+Output includes:
+- Node info (type, name, semantic ID, location)
+- Source code at the node's location
+- All outgoing edges (what this node connects to)
+- All incoming edges (what connects to this node)
+- Code context at each connected node's location
+
+Primary edges (CALLS, ASSIGNED_FROM, DEPENDS_ON, etc.) include code context.
+Structural edges (CONTAINS, HAS_SCOPE, etc.) are shown in compact form.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                semanticId: {
+                    type: 'string',
+                    description: 'Exact semantic ID of the node (from find_nodes or query_graph)',
+                },
+                contextLines: {
+                    type: 'number',
+                    description: 'Lines of code context around each reference (default: 3)',
+                },
+                edgeType: {
+                    type: 'string',
+                    description: 'Filter by edge type (comma-separated, e.g., "CALLS,ASSIGNED_FROM")',
+                },
+            },
+            required: ['semanticId'],
+        },
+    },
+    {
+        name: 'get_file_overview',
+        description: `Understand what a file does without reading it — shows structure and relationships from the graph.
+
+USE THIS FIRST when you need to understand a file. It replaces reading the file with
+a structured summary: imports, exports, classes, functions, variables, and how they
+connect to the rest of the codebase.
+
+Returns:
+- Imports: what modules are pulled in and which names
+- Exports: what the file exposes to others
+- Classes: with methods and their call targets
+- Functions: with what they call
+- Variables: with their assignment sources
+
+After this, use get_context with specific node IDs to deep-dive into relationships.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                file: {
+                    type: 'string',
+                    description: 'File path (relative to project root or absolute)',
+                },
+                include_edges: {
+                    type: 'boolean',
+                    description: 'Include relationship edges like CALLS, EXTENDS (default: true). Set false for faster results.',
+                },
+            },
+            required: ['file'],
+        },
+    },
+    {
+        name: 'find_guards',
+        description: `Find conditional guards protecting a node.
+
+Returns all SCOPE nodes that guard the given node, walking from inner to outer scope.
+Useful for answering "what conditions must be true for this code to execute?"
+
+Each guard includes:
+- scopeId: The SCOPE node ID
+- scopeType: Type of conditional (if_statement, else_statement, etc.)
+- condition: Raw condition text (e.g., "user !== null")
+- constraints: Parsed constraints (if available)
+- file/line: Location in source
+
+Example use cases:
+- "What conditions guard this API call?"
+- "Is this code protected by a null check?"
+- "What's the full guard chain for this function call?"`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                nodeId: {
+                    type: 'string',
+                    description: 'ID of the node to find guards for (e.g., CALL, VARIABLE)',
+                },
+            },
+            required: ['nodeId'],
+        },
+    },
+];
+//# sourceMappingURL=context-tools.js.map

package/dist/definitions/context-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tools.js","sourceRoot":"","sources":["../../src/definitions/context-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;gDAmB+B;QAC5C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBACxC;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qDAAqD;iBACnE;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,iDAAiD;iBAC/D;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE;;;;;;;;;;;;;;;wEAeuD;QACpE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gEAAgE;iBAC9E;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0DAA0D;iBACxE;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oEAAoE;iBAClF;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE;;;;;;;;;;;;;oFAamE;QAChF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kDAAkD;iBAChE;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,+FAA+F;iBAClG;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE;;;;;;;;;;;;;;;wDAeuC;QACpD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0DAA0D;iBACxE;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;CACF,CAAC"}

package/dist/definitions/graph-tools.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Graph Tools — raw graph traversal primitives
+ * REG-521: get_node, get_neighbors, traverse_graph
+ */
+import type { ToolDefinition } from './types.js';
+export declare const GRAPH_TOOLS: ToolDefinition[];
+//# sourceMappingURL=graph-tools.d.ts.map

package/dist/definitions/graph-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-tools.d.ts","sourceRoot":"","sources":["../../src/definitions/graph-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,WAAW,EAAE,cAAc,EAsHvC,CAAC"}

package/dist/definitions/graph-tools.js

@@ -0,0 +1,124 @@
+/**
+ * Graph Tools — raw graph traversal primitives
+ * REG-521: get_node, get_neighbors, traverse_graph
+ */
+export const GRAPH_TOOLS = [
+    {
+        name: 'get_node',
+        description: `Get a single node by its semantic ID with full metadata.
+
+Use this when you have a node ID from find_nodes, query_graph, or another tool
+and need the complete record.
+
+Returns: All node properties (type, name, file, line, exported) plus
+type-specific metadata (async, params, className, etc.).
+
+Use cases:
+- After find_nodes: get full details for a specific result
+- After query_graph: inspect a violation node
+- Quick lookup without full context (faster than get_context)
+
+Tip: For relationships and code context, use get_context instead.
+For just the direct edges, use get_neighbors.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                semanticId: {
+                    type: 'string',
+                    description: 'Semantic ID of the node (from find_nodes, query_graph, etc.)',
+                },
+            },
+            required: ['semanticId'],
+        },
+    },
+    {
+        name: 'get_neighbors',
+        description: `Get direct neighbors of a node — all incoming and/or outgoing edges.
+
+Returns edges grouped by type with connected node summaries.
+
+Use this when you need:
+- "What does this node connect to?" (outgoing)
+- "What connects to this node?" (incoming)
+- Simple graph exploration without Datalog
+
+Direction options:
+- outgoing: Edges FROM this node (calls, contains, depends on)
+- incoming: Edges TO this node (callers, containers, dependents)
+- both: All edges (default)
+
+Edge type filter: Pass edgeTypes to see only specific relationships.
+Omit to get all edge types.
+
+Cheaper than get_context (no code snippets). Use when you only need
+the graph structure, not source code.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                semanticId: {
+                    type: 'string',
+                    description: 'Semantic ID of the node',
+                },
+                direction: {
+                    type: 'string',
+                    description: 'Edge direction: outgoing, incoming, or both (default: both)',
+                    enum: ['outgoing', 'incoming', 'both'],
+                },
+                edgeTypes: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by edge types (e.g., ["CALLS", "CONTAINS"]). Omit for all.',
+                },
+            },
+            required: ['semanticId'],
+        },
+    },
+    {
+        name: 'traverse_graph',
+        description: `Traverse the graph using BFS from start nodes, following specific edge types.
+
+Use this for:
+- Impact analysis: "What's affected if I change this?" (outgoing CALLS, DEPENDS_ON)
+- Dependency trees: "What does this module import?" (outgoing IMPORTS_FROM)
+- Reverse dependencies: "Who depends on this?" (incoming DEPENDS_ON)
+- Reachability: "Can data flow from X to Y?" (outgoing FLOWS_INTO, ASSIGNED_FROM)
+
+Returns nodes with depth info (0 = start, 1 = direct neighbor, 2+ = transitive).
+
+Direction:
+- outgoing: Follow edges FROM start nodes (default)
+- incoming: Follow edges TO start nodes
+
+Examples:
+- All transitive callers: traverse_graph(startNodeIds=[fnId], edgeTypes=["CALLS"], direction="incoming")
+- Module dependency tree: traverse_graph(startNodeIds=[modId], edgeTypes=["IMPORTS_FROM"], maxDepth=10)
+
+Tip: Start with maxDepth=5. Use get_schema(type="edges") to find valid edge type names.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                startNodeIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Starting node IDs (semantic IDs)',
+                },
+                edgeTypes: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Edge types to follow (e.g., ["CALLS", "DEPENDS_ON"]). Use get_schema to see available types.',
+                },
+                maxDepth: {
+                    type: 'number',
+                    description: 'Maximum traversal depth (default: 5, max: 20)',
+                },
+                direction: {
+                    type: 'string',
+                    description: 'Traversal direction: outgoing or incoming (default: outgoing)',
+                    enum: ['outgoing', 'incoming'],
+                },
+            },
+            required: ['startNodeIds', 'edgeTypes'],
+        },
+    },
+];
+//# sourceMappingURL=graph-tools.js.map

package/dist/definitions/graph-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-tools.js","sourceRoot":"","sources":["../../src/definitions/graph-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;;;;;;;;;;;8CAc6B;QAC1C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8DAA8D;iBAC5E;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE;;;;;;;;;;;;;;;;;;sCAkBqB;QAClC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yBAAyB;iBACvC;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6DAA6D;oBAC1E,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC;iBACvC;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,mEAAmE;iBACjF;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE;;;;;;;;;;;;;;;;;;wFAkBuE;QACpF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,kCAAkC;iBAChD;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,8FAA8F;iBAC5G;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;iBAC7D;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+DAA+D;oBAC5E,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;iBAC/B;aACF;YACD,QAAQ,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;SACxC;KACF;CACF,CAAC"}

package/dist/definitions/graphql-tools.d.ts

@@ -0,0 +1,6 @@
+/**
+ * GraphQL Tool — execute GraphQL queries on the code graph
+ */
+import type { ToolDefinition } from './types.js';
+export declare const GRAPHQL_TOOLS: ToolDefinition[];
+//# sourceMappingURL=graphql-tools.d.ts.map

package/dist/definitions/graphql-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-tools.d.ts","sourceRoot":"","sources":["../../src/definitions/graphql-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,aAAa,EAAE,cAAc,EAyDzC,CAAC"}