vexp-mcp 1.2.14

package/dist/tools/search-logic-flow.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+export const SearchLogicFlowSchema = z.object({
+    start: z.string().describe("FQN of the starting symbol"),
+    end: z.string().describe("FQN of the ending symbol"),
+    max_paths: z.number().optional().default(3).describe("Max number of paths to return"),
+    cross_repo: z.boolean().optional().default(false).describe("Allow cross-repo traversal"),
+});
+export const SEARCH_LOGIC_FLOW_DEFINITION = {
+    name: "search_logic_flow",
+    description: "Find execution paths between two symbols — shows how data or control flows from A to B through the call graph. " +
+        "WHEN TO USE: (1) When asked 'how does X reach Y?' or 'what happens between A and B?'. " +
+        "(2) To trace an indirect call chain (e.g. HTTP handler → DB query). " +
+        "(3) To understand the execution path for a bug report or feature trace. " +
+        "Both start and end must be exact FQNs from get_context_capsule or get_impact_graph results.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            start: { type: "string", description: "FQN of the start symbol" },
+            end: { type: "string", description: "FQN of the end symbol" },
+            max_paths: { type: "number", description: "Max paths to return (default: 3)" },
+            cross_repo: { type: "boolean", description: "Allow tracing across repo boundaries (e.g. frontend→API→backend). Reports linking edges when start/end are in different repos" },
+        },
+        required: ["start", "end"],
+    },
+};
+export async function handleSearchLogicFlow(params, daemon) {
+    const validated = SearchLogicFlowSchema.parse(params);
+    const result = await daemon.call("search_logic_flow", validated);
+    // Handle cross-repo gap response
+    if (typeof result === 'object' && result !== null && 'cross_repo_gap' in result) {
+        return formatCrossRepoGap(result);
+    }
+    return formatFlowAsText(validated.start, validated.end, result);
+}
+function formatCrossRepoGap(gap) {
+    const lines = [];
+    lines.push(`# Cross-Repo Logic Flow`);
+    lines.push(`> \`${gap.start.fqn}\` (${gap.start.repo}) → \`${gap.end.fqn}\` (${gap.end.repo})`);
+    lines.push("");
+    lines.push(gap.message);
+    lines.push("");
+    if (gap.linking_edges.length > 0) {
+        lines.push("## Linking Edges");
+        lines.push("");
+        for (const edge of gap.linking_edges) {
+            lines.push(`- **${edge.edge_type}**: \`${edge.source_fqn}\` (${edge.source_repo}) → \`${edge.target_fqn}\` (${edge.target_repo}) — confidence: ${(edge.confidence * 100).toFixed(0)}%`);
+        }
+        lines.push("");
+    }
+    if (gap.start_neighborhood) {
+        lines.push("## Start Symbol Neighborhood");
+        lines.push("");
+        lines.push(gap.start_neighborhood);
+    }
+    return lines.join("\n");
+}
+function formatFlowAsText(start, end, paths) {
+    const lines = [];
+    lines.push(`# Logic Flow: \`${start}\` → \`${end}\``);
+    lines.push(`> ${paths.length} path(s) found`);
+    lines.push("");
+    if (!Array.isArray(paths) || paths.length === 0) {
+        lines.push("*No execution path found between these symbols. " +
+            "They may not be connected, or the path may exceed the search depth.*");
+        return lines.join("\n");
+    }
+    paths.forEach((path, idx) => {
+        lines.push(`## Path ${idx + 1} — ${path.nodes.length} steps (cost: ${path.total_cost.toFixed(1)})`);
+        lines.push("");
+        path.nodes.forEach((node, nodeIdx) => {
+            const isLast = nodeIdx === path.nodes.length - 1;
+            const edge = path.edges_description[nodeIdx] ?? "";
+            if (nodeIdx === 0) {
+                lines.push(`1. **START** \`${node.fqn}\``);
+                lines.push(`   *${node.file_path}:${node.start_line}*`);
+            }
+            else {
+                const edgeLabel = edge ? ` via \`${edge}\`` : "";
+                lines.push(`${nodeIdx + 1}.${edgeLabel} → \`${node.fqn}\``);
+                lines.push(`   *${node.file_path}:${node.start_line}*`);
+            }
+            if (!isLast) {
+                lines.push("   ↓");
+            }
+        });
+        lines.push("");
+    });
+    return lines.join("\n");
+}
+//# sourceMappingURL=search-logic-flow.js.map

package/dist/tools/search-logic-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-logic-flow.js","sourceRoot":"","sources":["../../src/tools/search-logic-flow.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-memory.d.ts

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import type { DaemonClient } from "../daemon-client.js";
+export declare const SearchMemorySchema: z.ZodObject<{
+    query: z.ZodString;
+    max_results: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    include_stale: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    time_range_days: z.ZodOptional<z.ZodNumber>;
+    session_filter: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    max_results: number;
+    include_stale: boolean;
+    time_range_days?: number | undefined;
+    session_filter?: string | undefined;
+}, {
+    query: string;
+    max_results?: number | undefined;
+    include_stale?: boolean | undefined;
+    time_range_days?: number | undefined;
+    session_filter?: string | undefined;
+}>;
+export type SearchMemoryParams = z.infer<typeof SearchMemorySchema>;
+export declare const SEARCH_MEMORY_DEFINITION: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            max_results: {
+                type: string;
+                description: string;
+            };
+            include_stale: {
+                type: string;
+                description: string;
+            };
+            time_range_days: {
+                type: string;
+                description: string;
+            };
+            session_filter: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleSearchMemory(params: unknown, daemon: DaemonClient): Promise<string>;
+//# sourceMappingURL=search-memory.d.ts.map

package/dist/tools/search-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-memory.d.ts","sourceRoot":"","sources":["../../src/tools/search-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBpC,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/tools/search-memory.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+export const SearchMemorySchema = z.object({
+    query: z.string().describe("Search query for memories"),
+    max_results: z.number().optional().default(10).describe("Max results"),
+    include_stale: z.boolean().optional().default(true).describe("Include stale observations (demoted but shown)"),
+    time_range_days: z.number().optional().describe("Only search last N days (default: 30)"),
+    session_filter: z.string().optional().describe("Filter to specific session ID"),
+});
+export const SEARCH_MEMORY_DEFINITION = {
+    name: "search_memory",
+    description: "Search across all session memories using keywords and semantic similarity. " +
+        "Finds relevant observations from any session, ranked by relevance, recency, " +
+        "and code-graph proximity. Stale observations (linked to changed code) are " +
+        "demoted but still included. Each result explains WHY it surfaced (transparency). " +
+        "Use this to find past decisions, explored code paths, or previously encountered patterns.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Search query for memories" },
+            max_results: { type: "number", description: "Max results (default: 10)" },
+            include_stale: { type: "boolean", description: "Include stale observations (default: true, but demoted)" },
+            time_range_days: { type: "number", description: "Only search last N days (default: 30)" },
+            session_filter: { type: "string", description: "Filter to specific session ID" },
+        },
+        required: ["query"],
+    },
+};
+export async function handleSearchMemory(params, daemon) {
+    const validated = SearchMemorySchema.parse(params);
+    const results = await daemon.call("search_memory", validated);
+    return formatSearchResults(results, validated.max_results ?? 10);
+}
+function formatSearchResults(results, maxResults) {
+    const lines = [];
+    lines.push("# Memory Search Results");
+    lines.push(`> ${results.length} results found`);
+    lines.push("");
+    if (results.length === 0) {
+        lines.push("*No matching memories found.*");
+        return lines.join("\n");
+    }
+    // Use detailed format (Layer 3) when few results
+    const detailed = maxResults <= 5;
+    for (const mem of results) {
+        const date = new Date(mem.created_at * 1000);
+        const timeStr = `${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")} ${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
+        const staleTag = mem.stale ? " ~stale~" : "";
+        lines.push(`- [${timeStr}${staleTag}] (${mem.obs_type}) ${mem.content}`);
+        if (detailed) {
+            lines.push(`  Score: ${mem.score.toFixed(2)} | Session: ${mem.session_id.slice(0, 8)} | Why: ${mem.why}`);
+        }
+        else {
+            lines.push(`  Why: ${mem.why}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=search-memory.js.map

package/dist/tools/search-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-memory.js","sourceRoot":"","sources":["../../src/tools/search-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACvD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;IACtE,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC9G,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACxF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CAChF,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,6EAA6E;QAC7E,8EAA8E;QAC9E,4EAA4E;QAC5E,mFAAmF;QACnF,2FAA2F;IAC7F,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YACnE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YACzE,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yDAAyD,EAAE;YAC1G,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;YACzF,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;SACjF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAe,EACf,MAAoB;IAEpB,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAyB,CAAC;IACtF,OAAO,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;AACnE,CAAC;AAaD,SAAS,mBAAmB,CAAC,OAA6B,EAAE,UAAkB;IAC5E,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,MAAM,gBAAgB,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,iDAAiD;IACjD,MAAM,QAAQ,GAAG,UAAU,IAAI,CAAC,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACvM,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAE7C,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,GAAG,QAAQ,MAAM,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAEzE,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5G,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/workspace-setup.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import type { DaemonClient } from "../daemon-client.js";
+export declare const WorkspaceSetupSchema: z.ZodObject<{
+    workspace_root: z.ZodOptional<z.ZodString>;
+    detect_agents: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    detect_agents: boolean;
+    workspace_root?: string | undefined;
+}, {
+    workspace_root?: string | undefined;
+    detect_agents?: boolean | undefined;
+}>;
+export type WorkspaceSetupParams = z.infer<typeof WorkspaceSetupSchema>;
+export declare const WORKSPACE_SETUP_DEFINITION: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            workspace_root: {
+                type: string;
+                description: string;
+            };
+            detect_agents: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handleWorkspaceSetup(params: unknown, daemon: DaemonClient): Promise<string>;
+//# sourceMappingURL=workspace-setup.d.ts.map

package/dist/tools/workspace-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-setup.d.ts","sourceRoot":"","sources":["../../src/tools/workspace-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;CAoBtC,CAAC;AAsBF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/tools/workspace-setup.js

@@ -0,0 +1,115 @@
+import { z } from "zod";
+export const WorkspaceSetupSchema = z.object({
+    workspace_root: z.string().optional().describe("Workspace root path (default: CWD)"),
+    detect_agents: z.boolean().optional().default(true).describe("Auto-detect AI agents"),
+});
+export const WORKSPACE_SETUP_DEFINITION = {
+    name: "workspace_setup",
+    description: "Set up vexp for the current workspace. Generates configuration files, " +
+        "detects AI coding agents (Claude Code, Cursor, Windsurf, Continue), " +
+        "and provides setup instructions. Run this once when starting to work on a new project.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            workspace_root: {
+                type: "string",
+                description: "Workspace root path (default: current directory)",
+            },
+            detect_agents: {
+                type: "boolean",
+                description: "Auto-detect installed AI agents (default: true)",
+            },
+        },
+        required: [],
+    },
+};
+export async function handleWorkspaceSetup(params, daemon) {
+    const validated = WorkspaceSetupSchema.parse(params);
+    const result = await daemon.call("workspace_setup", validated);
+    return formatSetupAsText(result);
+}
+function formatSetupAsText(setup) {
+    const lines = [];
+    lines.push(`# vexp Workspace Setup`);
+    lines.push(`> v${setup.vexp_version} | \`${setup.workspace_root}\``);
+    lines.push("");
+    // Generated files
+    if (setup.generated_files.length > 0) {
+        lines.push("## Generated Files");
+        lines.push("");
+        for (const f of setup.generated_files) {
+            lines.push(`- \`${f}\``);
+        }
+        lines.push("");
+    }
+    // workspace.json preview
+    if (setup.workspace_json) {
+        lines.push("## workspace.json");
+        lines.push("");
+        lines.push("```json");
+        lines.push(setup.workspace_json);
+        lines.push("```");
+        lines.push("");
+    }
+    // Detected agents
+    if (setup.detected_agents.length > 0) {
+        lines.push("## Detected AI Agents");
+        lines.push("");
+        for (const agent of setup.detected_agents) {
+            lines.push(`- **${agent}**`);
+        }
+        lines.push("");
+    }
+    // Agent configs
+    if (setup.agent_configs.length > 0) {
+        lines.push("## Agent Configuration Files");
+        lines.push("");
+        for (const cfg of setup.agent_configs) {
+            const existsLabel = cfg.already_exists ? " *(already exists — merge manually)*" : " *(created)*";
+            lines.push(`### ${cfg.agent} — \`${cfg.config_file}\`${existsLabel}`);
+            lines.push("");
+            lines.push("```");
+            lines.push(cfg.content);
+            lines.push("```");
+            lines.push("");
+        }
+    }
+    // Git hooks
+    if (setup.git_hooks_installed) {
+        lines.push("## Git Hooks");
+        lines.push("");
+        lines.push("✓ Git hooks installed: `pre-commit`, `post-merge`, `post-checkout`");
+        lines.push("✓ Merge driver configured for `index.db`");
+        lines.push("");
+    }
+    // .gitignore additions
+    if (setup.suggested_gitignore_additions.length > 0) {
+        lines.push("## Suggested .gitignore Additions");
+        lines.push("");
+        lines.push("Add these to your `.gitignore`:");
+        lines.push("```gitignore");
+        for (const line of setup.suggested_gitignore_additions) {
+            lines.push(line);
+        }
+        lines.push("```");
+        lines.push("");
+    }
+    // Index status
+    if (setup.index_started) {
+        lines.push("## Indexing");
+        lines.push("");
+        lines.push("✓ Initial indexing started in background. Use `index_status` to check progress.");
+        lines.push("");
+    }
+    // Setup instructions
+    if (setup.setup_instructions.length > 0) {
+        lines.push("## Next Steps");
+        lines.push("");
+        for (let i = 0; i < setup.setup_instructions.length; i++) {
+            lines.push(`${i + 1}. ${setup.setup_instructions[i]}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=workspace-setup.js.map

package/dist/tools/workspace-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-setup.js","sourceRoot":"","sources":["../../src/tools/workspace-setup.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "vexp-mcp",
+  "version": "1.2.14",
+  "description": "vexp MCP server — AI context tools for coding agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "node --experimental-vm-modules node_modules/.bin/jest",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "express": "^4.18.3",
+    "winston": "^3.11.0",
+    "better-sqlite3": "^9.4.3",
+    "uuid": "^9.0.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/better-sqlite3": "^7.6.8",
+    "@types/node": "^20.11.0",
+    "@types/uuid": "^9.0.7",
+    "typescript": "^5.4.0",
+    "tsx": "^4.7.0",
+    "jest": "^29.7.0",
+    "@jest/globals": "^29.7.0",
+    "ts-jest": "^29.1.2"
+  }
+}

package/src/daemon-client.ts

@@ -0,0 +1,134 @@
+import * as net from "net";
+import * as path from "path";
+import * as os from "os";
+import { randomUUID } from "crypto";
+
+interface SocketRequest {
+  id: number;
+  tool: string;
+  params: unknown;
+  session_id?: string;
+}
+
+interface SocketResponse {
+  type: "response" | "error";
+  result?: unknown;
+  message?: string;
+}
+
+/**
+ * Client per comunicare con il vexp-core daemon via Unix socket / Named pipe.
+ * Protocol: JSON lines (newline-delimited JSON).
+ */
+export class DaemonClient {
+  private socketPath: string;
+  private requestCounter = 0;
+  private sessionId: string;
+
+  constructor(socketPath?: string, sessionId?: string) {
+    this.socketPath = socketPath ?? getDefaultSocketPath();
+    this.sessionId = sessionId ?? randomUUID();
+  }
+
+  /**
+   * Invia una richiesta al daemon e attende la risposta.
+   */
+  async call(tool: string, params: unknown): Promise<unknown> {
+    return new Promise((resolve, reject) => {
+      const id = ++this.requestCounter;
+      const request: SocketRequest = { id, tool, params, session_id: this.sessionId };
+      const requestLine = JSON.stringify(request) + "\n";
+
+      let client: net.Socket;
+      let responseBuffer = "";
+      let settled = false;
+
+      const timeout = setTimeout(() => {
+        if (!settled) {
+          settled = true;
+          client?.destroy();
+          reject(new Error(`Timeout: no response from daemon for tool '${tool}' after 30s`));
+        }
+      }, 30_000);
+
+      const settle = (fn: () => void) => {
+        if (!settled) {
+          settled = true;
+          clearTimeout(timeout);
+          fn();
+        }
+      };
+
+      if (process.platform === "win32") {
+        client = net.createConnection(this.socketPath);
+      } else {
+        client = net.createConnection({ path: this.socketPath });
+      }
+
+      client.on("connect", () => {
+        client.write(requestLine);
+      });
+
+      client.on("data", (chunk: Buffer) => {
+        responseBuffer += chunk.toString();
+        const newlineIndex = responseBuffer.indexOf("\n");
+        if (newlineIndex !== -1) {
+          const line = responseBuffer.slice(0, newlineIndex);
+          client.destroy();
+          try {
+            const response: SocketResponse = JSON.parse(line);
+            if (response.type === "response") {
+              settle(() => resolve(response.result));
+            } else {
+              settle(() => reject(new Error(response.message ?? "Daemon error")));
+            }
+          } catch (e) {
+            settle(() => reject(new Error(`Invalid response JSON: ${line}`)));
+          }
+        }
+      });
+
+      client.on("error", (err: Error) => {
+        settle(() => reject(new Error(`Daemon connection error: ${err.message}. Is vexp daemon running?`)));
+      });
+
+      client.on("close", () => {
+        settle(() => reject(new Error("Daemon connection closed unexpectedly")));
+      });
+    });
+  }
+
+  /**
+   * Verifica se il daemon è raggiungibile
+   */
+  async health(): Promise<boolean> {
+    try {
+      await this.call("index_status", {});
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
+
+/** FNV-1a 64-bit hash — must match vexp-core/src/utils.rs md5_hash() */
+function fnvHash(input: string): string {
+  let hash = BigInt("0xcbf29ce484222325");
+  const prime = BigInt("0x100000001b3");
+  const mask = BigInt("0xffffffffffffffff");
+  const bytes = Buffer.from(input, "utf-8");
+  for (const byte of bytes) {
+    hash ^= BigInt(byte);
+    hash = (hash * prime) & mask;
+  }
+  return hash.toString(16);
+}
+
+function getDefaultSocketPath(): string {
+  const workspaceRoot = process.env["VEXP_WORKSPACE"] ?? process.cwd();
+  if (process.platform === "win32") {
+    const hash = fnvHash(workspaceRoot);
+    return `\\\\.\\pipe\\vexp-${hash.slice(0, 8)}`;
+  }
+  return path.join(workspaceRoot, ".vexp", "daemon.sock");
+}