@grafema/mcp 0.2.0-beta → 0.2.5-beta

package/src/types.ts

@@ -45,6 +45,7 @@ export interface QueryGraphArgs {
   limit?: number;
   offset?: number;
   format?: 'table' | 'json' | 'tree';
+  explain?: boolean;
 }
 
 export interface FindCallsArgs {
@@ -52,6 +53,7 @@ export interface FindCallsArgs {
   limit?: number;
   offset?: number;
   include_indirect?: boolean;
+  className?: string;
 }
 
 export interface TraceAliasArgs {
@@ -190,7 +192,7 @@ export interface GraphBackend {
 export interface GraphNode {
   id: string;
   type: string;
-  name: string;
+  name?: string;  // Optional - some nodes (BRANCH, CASE, LOOP) don't have names
   file?: string;
   line?: number;
   [key: string]: unknown;
@@ -265,6 +267,27 @@ export interface GetFunctionDetailsArgs {
 // Re-export types from core for convenience
 export type { CallInfo, CallerInfo, FindCallsOptions } from '@grafema/core';
 
+/**
+ * Datalog query result binding
+ */
+export interface DatalogBinding {
+  name: string;
+  value: string;
+}
+
+/**
+ * Call result structure for filtering
+ */
+export interface CallResult {
+  id: string;
+  name?: string;
+  object?: string;
+  file?: string;
+  line?: number;
+  resolved: boolean;
+  target: { type: string; name: string; file?: string; line?: number } | null;
+}
+
 /**
  * Information about a conditional guard (SCOPE node)
  */
@@ -276,3 +299,32 @@ export interface GuardInfo {
   file: string;
   line: number;
 }
+
+// === PROJECT STRUCTURE (REG-173) ===
+
+export interface ReadProjectStructureArgs {
+  path?: string;
+  depth?: number;
+  include_files?: boolean;
+}
+
+// === WRITE CONFIG (REG-173) ===
+
+export interface WriteConfigArgs {
+  services?: Array<{
+    name: string;
+    path: string;
+    entryPoint?: string;
+  }>;
+  plugins?: {
+    indexing?: string[];
+    analysis?: string[];
+    enrichment?: string[];
+    validation?: string[];
+  };
+  include?: string[];
+  exclude?: string[];
+  workspace?: {
+    roots?: string[];
+  };
+}

package/src/utils.ts

@@ -3,7 +3,7 @@
  */
 
 import { appendFileSync, existsSync, mkdirSync, readdirSync, unlinkSync, statSync } from 'fs';
-import { join, basename } from 'path';
+import { join } from 'path';
 import type { PaginationParams, ToolResult } from './types.js';
 
 // === CONSTANTS ===
@@ -83,7 +83,7 @@ export function normalizeLimit(limit: number | undefined | null): number {
 }
 
 export function formatPaginationInfo(params: PaginationParams): string {
-  const { limit, offset, returned, total, hasMore } = params;
+  const { limit: _limit, offset, returned, total, hasMore } = params;
   let info = `\n📄 Pagination: showing ${returned}`;
   if (total !== undefined) {
     info += ` of ${total}`;