@grafema/mcp 0.1.0-alpha.1

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Grafema MCP Server
+ *
+ * Provides code analysis tools via Model Context Protocol.
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/server.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+/**
+ * Grafema MCP Server
+ *
+ * Provides code analysis tools via Model Context Protocol.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { TOOLS } from './definitions.js';
+import { initializeFromArgs, setupLogging, getProjectPath } from './state.js';
+import { textResult, errorResult, log } from './utils.js';
+import { discoverServices } from './analysis.js';
+import { handleQueryGraph, handleFindCalls, handleFindNodes, handleTraceAlias, handleTraceDataFlow, handleCheckInvariant, handleAnalyzeProject, handleGetAnalysisStatus, handleGetStats, handleGetSchema, handleCreateGuarantee, handleListGuarantees, handleCheckGuarantees, handleDeleteGuarantee, handleGetCoverage, handleGetDocumentation, handleReportIssue, } from './handlers.js';
+// Initialize from command line args
+initializeFromArgs();
+setupLogging();
+const projectPath = getProjectPath();
+log(`[Grafema MCP] Starting server for project: ${projectPath}`);
+// Create MCP server
+const server = new Server({
+    name: 'grafema-mcp',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async (_request, _extra) => {
+    return { tools: TOOLS };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+    void extra; // suppress unused warning
+    const { name, arguments: args } = request.params;
+    const startTime = Date.now();
+    const argsPreview = args ? JSON.stringify(args).slice(0, 200) : '{}';
+    log(`[Grafema MCP] ▶ ${name} args=${argsPreview}`);
+    try {
+        let result;
+        switch (name) {
+            case 'query_graph':
+                result = await handleQueryGraph(args);
+                break;
+            case 'find_calls':
+                result = await handleFindCalls(args);
+                break;
+            case 'find_nodes':
+                result = await handleFindNodes(args);
+                break;
+            case 'trace_alias':
+                result = await handleTraceAlias(args);
+                break;
+            case 'trace_dataflow':
+                result = await handleTraceDataFlow(args);
+                break;
+            case 'check_invariant':
+                result = await handleCheckInvariant(args);
+                break;
+            case 'discover_services':
+                const services = await discoverServices();
+                result = textResult(`Found ${services.length} service(s):\n${JSON.stringify(services, null, 2)}`);
+                break;
+            case 'analyze_project':
+                result = await handleAnalyzeProject(args);
+                break;
+            case 'get_analysis_status':
+                result = await handleGetAnalysisStatus();
+                break;
+            case 'get_stats':
+                result = await handleGetStats();
+                break;
+            case 'get_schema':
+                result = await handleGetSchema(args);
+                break;
+            case 'create_guarantee':
+                result = await handleCreateGuarantee(args);
+                break;
+            case 'list_guarantees':
+                result = await handleListGuarantees();
+                break;
+            case 'check_guarantees':
+                result = await handleCheckGuarantees(args);
+                break;
+            case 'delete_guarantee':
+                result = await handleDeleteGuarantee(args);
+                break;
+            case 'get_coverage':
+                result = await handleGetCoverage(args);
+                break;
+            case 'get_documentation':
+                result = await handleGetDocumentation(args);
+                break;
+            case 'report_issue':
+                result = await handleReportIssue(args);
+                break;
+            default:
+                result = errorResult(`Unknown tool: ${name}`);
+        }
+        const duration = Date.now() - startTime;
+        const resultSize = JSON.stringify(result).length;
+        const status = result.isError ? '✗' : '✓';
+        log(`[Grafema MCP] ${status} ${name} completed in ${duration}ms (${resultSize} bytes)`);
+        return result;
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        log(`[Grafema MCP] ✗ ${name} FAILED after ${duration}ms: ${error.message}`);
+        return errorResult(error.message);
+    }
+});
+// Main entry point
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log('[Grafema MCP] Server connected via stdio');
+}
+main().catch((error) => {
+    log(`[Grafema MCP] Fatal error: ${error.message}`);
+    process.exit(1);
+});

package/dist/state.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP Server State Management
+ */
+import { GuaranteeManager, GuaranteeAPI } from '@grafema/core';
+import type { AnalysisStatus } from './types.js';
+import type { GraphBackend } from '@grafema/types';
+export declare function getProjectPath(): string;
+export declare function getIsAnalyzed(): boolean;
+export declare function getAnalysisStatus(): AnalysisStatus;
+export declare function getBackgroundPid(): number | null;
+export declare function getGuaranteeManager(): GuaranteeManager | null;
+export declare function getGuaranteeAPI(): GuaranteeAPI | null;
+export declare function setProjectPath(path: string): void;
+export declare function setIsAnalyzed(value: boolean): void;
+export declare function setAnalysisStatus(status: Partial<AnalysisStatus>): void;
+export declare function setBackgroundPid(pid: number | null): void;
+export declare function updateAnalysisTimings(timings: Partial<AnalysisStatus['timings']>): void;
+export declare function getOrCreateBackend(): Promise<GraphBackend>;
+export declare function getBackendIfExists(): GraphBackend | null;
+export declare function setupLogging(): void;
+export declare function initializeFromArgs(): void;
+export declare function cleanup(): Promise<void>;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAqB,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAgCnD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAE7D;AAED,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAElD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAEvE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEzD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAEvF;AAGD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CAgChE;AAkBD,wBAAgB,kBAAkB,IAAI,YAAY,GAAG,IAAI,CAExD;AAGD,wBAAgB,YAAY,IAAI,IAAI,CAMnC;AAGD,wBAAgB,kBAAkB,IAAI,IAAI,CAQzC;AAGD,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAI7C"}

package/dist/state.js

@@ -0,0 +1,138 @@
+/**
+ * MCP Server State Management
+ */
+import { join } from 'path';
+import { existsSync, mkdirSync } from 'fs';
+import { RFDBServerBackend, GuaranteeManager, GuaranteeAPI } from '@grafema/core';
+import { loadConfig } from './config.js';
+import { log, initLogger } from './utils.js';
+// === GLOBAL STATE ===
+let projectPath = process.cwd();
+let backend = null;
+let isAnalyzed = false;
+let backgroundPid = null;
+// Guarantee managers
+let guaranteeManager = null;
+let guaranteeAPI = null;
+let analysisStatus = {
+    running: false,
+    phase: null,
+    message: null,
+    servicesDiscovered: 0,
+    servicesAnalyzed: 0,
+    startTime: null,
+    endTime: null,
+    error: null,
+    timings: {
+        discovery: null,
+        indexing: null,
+        analysis: null,
+        enrichment: null,
+        validation: null,
+        total: null,
+    },
+};
+// === GETTERS ===
+export function getProjectPath() {
+    return projectPath;
+}
+export function getIsAnalyzed() {
+    return isAnalyzed;
+}
+export function getAnalysisStatus() {
+    return analysisStatus;
+}
+export function getBackgroundPid() {
+    return backgroundPid;
+}
+export function getGuaranteeManager() {
+    return guaranteeManager;
+}
+export function getGuaranteeAPI() {
+    return guaranteeAPI;
+}
+// === SETTERS ===
+export function setProjectPath(path) {
+    projectPath = path;
+}
+export function setIsAnalyzed(value) {
+    isAnalyzed = value;
+}
+export function setAnalysisStatus(status) {
+    analysisStatus = { ...analysisStatus, ...status };
+}
+export function setBackgroundPid(pid) {
+    backgroundPid = pid;
+}
+export function updateAnalysisTimings(timings) {
+    analysisStatus.timings = { ...analysisStatus.timings, ...timings };
+}
+// === BACKEND ===
+export async function getOrCreateBackend() {
+    if (backend)
+        return backend;
+    const grafemaDir = join(projectPath, '.grafema');
+    const dbPath = join(grafemaDir, 'graph.rfdb');
+    if (!existsSync(grafemaDir)) {
+        mkdirSync(grafemaDir, { recursive: true });
+    }
+    const config = loadConfig(projectPath);
+    // Socket path from config, or let RFDBServerBackend derive it from dbPath
+    const socketPath = config.analysis?.parallel?.socketPath;
+    log(`[Grafema MCP] Using RFDB server backend: socket=${socketPath || 'auto'}, db=${dbPath}`);
+    const rfdbBackend = new RFDBServerBackend({ socketPath, dbPath });
+    await rfdbBackend.connect();
+    backend = rfdbBackend;
+    const nodeCount = await backend.nodeCount();
+    if (nodeCount > 0) {
+        isAnalyzed = true;
+        log(`[Grafema MCP] Connected to existing database: ${nodeCount} nodes`);
+    }
+    else {
+        log(`[Grafema MCP] Empty database, analysis needed`);
+    }
+    // Initialize guarantee managers
+    initializeGuaranteeManagers(rfdbBackend);
+    return backend;
+}
+/**
+ * Initialize GuaranteeManager (Datalog-based) and GuaranteeAPI (contract-based)
+ */
+function initializeGuaranteeManagers(rfdbBackend) {
+    // GuaranteeManager for Datalog-based guarantees
+    // Cast to GuaranteeGraph interface expected by GuaranteeManager
+    const guaranteeGraph = rfdbBackend;
+    guaranteeManager = new GuaranteeManager(guaranteeGraph, projectPath);
+    log(`[Grafema MCP] GuaranteeManager initialized`);
+    // GuaranteeAPI for contract-based guarantees
+    const guaranteeGraphBackend = rfdbBackend;
+    guaranteeAPI = new GuaranteeAPI(guaranteeGraphBackend);
+    log(`[Grafema MCP] GuaranteeAPI initialized`);
+}
+export function getBackendIfExists() {
+    return backend;
+}
+// === LOGGING SETUP ===
+export function setupLogging() {
+    const grafemaDir = join(projectPath, '.grafema');
+    if (!existsSync(grafemaDir)) {
+        mkdirSync(grafemaDir, { recursive: true });
+    }
+    initLogger(grafemaDir);
+}
+// === INITIALIZATION ===
+export function initializeFromArgs() {
+    const args = process.argv.slice(2);
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--project' && args[i + 1]) {
+            projectPath = args[i + 1];
+            i++;
+        }
+    }
+}
+// === CLEANUP ===
+export async function cleanup() {
+    if (backend && 'close' in backend && typeof backend.close === 'function') {
+        await backend.close();
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,197 @@
+/**
+ * MCP Server Types
+ */
+import type { WriteStream } from 'fs';
+export interface AnalysisTimings {
+    discovery: number | null;
+    indexing: number | null;
+    analysis: number | null;
+    enrichment: number | null;
+    validation: number | null;
+    total: number | null;
+}
+export interface AnalysisStatus {
+    running: boolean;
+    phase: string | null;
+    message: string | null;
+    servicesDiscovered: number;
+    servicesAnalyzed: number;
+    startTime: number | null;
+    endTime: number | null;
+    error: string | null;
+    timings: AnalysisTimings;
+}
+export interface PaginationParams {
+    limit: number;
+    offset: number;
+    returned: number;
+    total?: number;
+    hasMore: boolean;
+}
+export interface GrafemaConfig {
+    project_path?: string;
+    backend?: 'local' | 'rfdb';
+    rfdb_socket?: string;
+    plugins?: string[];
+    ignore_patterns?: string[];
+}
+export interface QueryGraphArgs {
+    query: string;
+    limit?: number;
+    offset?: number;
+    format?: 'table' | 'json' | 'tree';
+}
+export interface FindCallsArgs {
+    target: string;
+    limit?: number;
+    offset?: number;
+    include_indirect?: boolean;
+}
+export interface TraceAliasArgs {
+    identifier: string;
+    file?: string;
+    max_depth?: number;
+}
+export interface TraceDataFlowArgs {
+    source: string;
+    file?: string;
+    direction?: 'forward' | 'backward' | 'both';
+    max_depth?: number;
+    limit?: number;
+}
+export interface CheckInvariantArgs {
+    rule: string;
+    name?: string;
+}
+export interface GetSchemaArgs {
+    type?: 'nodes' | 'edges' | 'all';
+}
+export interface GetValueSetArgs {
+    node_id: string;
+    property?: string;
+}
+export interface FindNodesArgs {
+    type?: string;
+    name?: string;
+    file?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface AnalyzeProjectArgs {
+    service?: string;
+    force?: boolean;
+    index_only?: boolean;
+}
+export interface GetCoverageArgs {
+    path?: string;
+    depth?: number;
+}
+export interface GetDocumentationArgs {
+    topic?: string;
+}
+export type GuaranteePriority = 'critical' | 'important' | 'observed' | 'tracked';
+export type GuaranteeStatus = 'discovered' | 'reviewed' | 'active' | 'changing' | 'deprecated';
+export interface CreateGuaranteeArgs {
+    name: string;
+    rule?: string;
+    description?: string;
+    severity?: 'error' | 'warning' | 'info';
+    type?: 'guarantee:queue' | 'guarantee:api' | 'guarantee:permission';
+    priority?: GuaranteePriority;
+    status?: GuaranteeStatus;
+    owner?: string;
+    schema?: Record<string, unknown>;
+    condition?: string;
+    governs?: string[];
+}
+export interface CheckGuaranteesArgs {
+    names?: string[];
+}
+export interface DeleteGuaranteeArgs {
+    name: string;
+}
+export interface ExportGuaranteesArgs {
+    format?: 'json' | 'yaml';
+}
+export interface ImportGuaranteesArgs {
+    guarantees: Array<{
+        name: string;
+        rule: string;
+        description?: string;
+        severity?: string;
+    }>;
+    merge?: boolean;
+}
+export interface GuaranteeDriftArgs {
+    baseline?: string;
+}
+export interface CheckGuaranteeFeasibilityArgs {
+    rule: string;
+}
+export interface ToolResult {
+    [x: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+}
+export interface GraphBackend {
+    nodeCount(): Promise<number>;
+    edgeCount(): Promise<number>;
+    countNodesByType(types?: string[] | null): Promise<Record<string, number>>;
+    countEdgesByType(types?: string[] | null): Promise<Record<string, number>>;
+    getNode(id: string): Promise<GraphNode | null>;
+    findByType(type: string): Promise<string[]>;
+    findByAttr(query: Record<string, unknown>): Promise<string[]>;
+    getOutgoingEdges(id: string, types?: string[] | null): Promise<GraphEdge[]>;
+    getIncomingEdges(id: string, types?: string[] | null): Promise<GraphEdge[]>;
+    queryNodes(filter: Record<string, unknown>): AsyncIterable<GraphNode>;
+    getAllNodes(filter?: Record<string, unknown>): Promise<GraphNode[]>;
+    runDatalogQuery?(query: string): Promise<unknown[]>;
+    close?(): Promise<void>;
+}
+export interface GraphNode {
+    id: string;
+    type: string;
+    name: string;
+    file?: string;
+    line?: number;
+    [key: string]: unknown;
+}
+export interface GraphEdge {
+    src: string;
+    dst: string;
+    type: string;
+    edgeType?: string;
+    [key: string]: unknown;
+}
+export interface MCPState {
+    projectPath: string;
+    backend: GraphBackend | null;
+    isAnalyzed: boolean;
+    analysisStatus: AnalysisStatus;
+    logStream: WriteStream | null;
+    backgroundPid: number | null;
+}
+export interface FileClassification {
+    category: 'source' | 'config' | 'test' | 'doc' | 'asset' | 'generated' | 'other';
+    language?: string;
+    framework?: string;
+}
+export interface ExtensionGroup {
+    [ext: string]: string[];
+}
+export interface AnalyzerSuggestion {
+    name: string;
+    reason: string;
+    priority: number;
+}
+export interface ReportIssueArgs {
+    title: string;
+    description: string;
+    context?: string;
+    labels?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAGtC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;CAC1B;AAGD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAGD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAGlF,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAE/F,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAExC,IAAI,CAAC,EAAE,iBAAiB,GAAG,eAAe,GAAG,sBAAsB,CAAC;IACpE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAGD,MAAM,WAAW,YAAY;IAC3B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3E,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3E,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC/C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9D,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5E,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5E,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACtE,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACpE,eAAe,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAGD,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAGD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,4 @@
+/**
+ * MCP Server Types
+ */
+export {};

package/dist/utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * MCP Server Utilities
+ */
+import type { PaginationParams, ToolResult } from './types.js';
+export declare const DEFAULT_LIMIT = 10;
+export declare const MAX_LIMIT = 500;
+export declare const DEFAULT_RESPONSE_SIZE_LIMIT = 100000;
+export declare function initLogger(grafemaDir: string): void;
+export declare function getLogsDir(): string | null;
+export declare function log(msg: string): void;
+export declare function guardResponseSize(text: string, maxSize?: number): string;
+export declare function normalizeLimit(limit: number | undefined | null): number;
+export declare function formatPaginationInfo(params: PaginationParams): string;
+export declare function findSimilarTypes(queriedType: string, availableTypes: string[], maxDistance?: number): string[];
+export declare function levenshtein(a: string, b: string): number;
+export declare function serializeBigInt(obj: unknown): unknown;
+export declare function textResult(text: string): ToolResult;
+export declare function errorResult(message: string): ToolResult;
+export declare function jsonResult(data: unknown, pretty?: boolean): ToolResult;
+export declare function isProcessRunning(pid: number): boolean;
+export declare function formatDuration(ms: number): string;
+export declare function formatNumber(n: number): string;
+export declare function truncate(s: string, maxLen: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG/D,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,eAAO,MAAM,2BAA2B,SAAU,CAAC;AAkCnD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAOnD;AAED,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CASrC;AAGD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAoC,GAAG,MAAM,CAOrG;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAGvE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAarE;AAGD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EAAE,EACxB,WAAW,GAAE,MAAU,GACtB,MAAM,EAAE,CAYV;AAGD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBxD;AAGD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAYrD;AAGD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAInD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAKvD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,GAAE,OAAc,GAAG,UAAU,CAG5E;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOrD;AAGD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG1D"}