@tekmidian/pai 0.1.0

package/dist/ipc-client-DPy7s3iu.mjs

@@ -0,0 +1,156 @@
+import { t as __exportAll } from "./rolldown-runtime-95iHPtFO.mjs";
+import { randomUUID } from "node:crypto";
+import { connect } from "node:net";
+
+//#region src/daemon/ipc-client.ts
+/**
+* ipc-client.ts — IPC client for the PAI Daemon MCP shim
+*
+* PaiClient connects to the Unix Domain Socket served by daemon.ts
+* and forwards tool calls to the daemon. Uses a fresh socket connection per
+* call (connect → write JSON + newline → read response line → parse → destroy).
+* This keeps the client stateless and avoids connection management complexity.
+*
+* Adapted from the Coogle ipc-client pattern (which was adapted from Whazaa).
+*/
+var ipc_client_exports = /* @__PURE__ */ __exportAll({
+	IPC_SOCKET_PATH: () => IPC_SOCKET_PATH,
+	PaiClient: () => PaiClient
+});
+/** Default socket path */
+const IPC_SOCKET_PATH = "/tmp/pai.sock";
+/** Timeout for IPC calls (60 seconds) */
+const IPC_TIMEOUT_MS = 6e4;
+/**
+* Thin IPC proxy that forwards tool calls to pai-daemon over a Unix
+* Domain Socket. Each call opens a fresh connection, sends one NDJSON request,
+* reads the response, and closes. Stateless and simple.
+*/
+var PaiClient = class {
+	socketPath;
+	constructor(socketPath) {
+		this.socketPath = socketPath ?? IPC_SOCKET_PATH;
+	}
+	/**
+	* Call a PAI tool by name with the given params.
+	* Returns the tool result or throws on error.
+	*/
+	async call(method, params) {
+		return this.send(method, params);
+	}
+	/**
+	* Check daemon status.
+	*/
+	async status() {
+		return await this.send("status", {});
+	}
+	/**
+	* Trigger an immediate index run.
+	*/
+	async triggerIndex() {
+		await this.send("index_now", {});
+	}
+	/**
+	* Get the current notification config from the daemon.
+	*/
+	async getNotificationConfig() {
+		return await this.send("notification_get_config", {});
+	}
+	/**
+	* Patch the notification config on the daemon (and persist to disk).
+	*/
+	async setNotificationConfig(patch) {
+		return await this.send("notification_set_config", patch);
+	}
+	/**
+	* Send a notification via the daemon (routes to configured channels).
+	*/
+	async sendNotification(payload) {
+		return await this.send("notification_send", payload);
+	}
+	/**
+	* Check whether the provided context text has drifted to a different project
+	* than the session's current routing.
+	*/
+	async topicCheck(params) {
+		return await this.send("topic_check", params);
+	}
+	/**
+	* Automatically detect which project a session belongs to.
+	* Tries path match, PAI.md marker walk, then topic detection (if context given).
+	*/
+	async sessionAutoRoute(params) {
+		const toolResult = await this.send("session_auto_route", params);
+		if (toolResult.isError) return null;
+		const text = toolResult.content?.[0]?.text ?? "";
+		try {
+			return JSON.parse(text);
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* Send a single IPC request and wait for the response.
+	* Opens a new socket connection per call — simple and reliable.
+	*/
+	send(method, params) {
+		const socketPath = this.socketPath;
+		return new Promise((resolve, reject) => {
+			let socket = null;
+			let done = false;
+			let buffer = "";
+			let timer = null;
+			function finish(error, value) {
+				if (done) return;
+				done = true;
+				if (timer !== null) {
+					clearTimeout(timer);
+					timer = null;
+				}
+				try {
+					socket?.destroy();
+				} catch {}
+				if (error) reject(error);
+				else resolve(value);
+			}
+			socket = connect(socketPath, () => {
+				const request = {
+					id: randomUUID(),
+					method,
+					params
+				};
+				socket.write(JSON.stringify(request) + "\n");
+			});
+			socket.on("data", (chunk) => {
+				buffer += chunk.toString();
+				const nl = buffer.indexOf("\n");
+				if (nl === -1) return;
+				const line = buffer.slice(0, nl);
+				buffer = buffer.slice(nl + 1);
+				let response;
+				try {
+					response = JSON.parse(line);
+				} catch {
+					finish(/* @__PURE__ */ new Error(`IPC parse error: ${line}`));
+					return;
+				}
+				if (!response.ok) finish(new Error(response.error ?? "IPC call failed"));
+				else finish(null, response.result);
+			});
+			socket.on("error", (e) => {
+				if (e.code === "ENOENT" || e.code === "ECONNREFUSED") finish(/* @__PURE__ */ new Error("PAI daemon not running. Start it with: pai daemon serve"));
+				else finish(e);
+			});
+			socket.on("end", () => {
+				if (!done) finish(/* @__PURE__ */ new Error("IPC connection closed before response"));
+			});
+			timer = setTimeout(() => {
+				finish(/* @__PURE__ */ new Error("IPC call timed out after 60s"));
+			}, IPC_TIMEOUT_MS);
+		});
+	}
+};
+
+//#endregion
+export { ipc_client_exports as n, PaiClient as t };
+//# sourceMappingURL=ipc-client-DPy7s3iu.mjs.map

package/dist/ipc-client-DPy7s3iu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-client-DPy7s3iu.mjs","names":[],"sources":["../src/daemon/ipc-client.ts"],"sourcesContent":["/**\n * ipc-client.ts — IPC client for the PAI Daemon MCP shim\n *\n * PaiClient connects to the Unix Domain Socket served by daemon.ts\n * and forwards tool calls to the daemon. Uses a fresh socket connection per\n * call (connect → write JSON + newline → read response line → parse → destroy).\n * This keeps the client stateless and avoids connection management complexity.\n *\n * Adapted from the Coogle ipc-client pattern (which was adapted from Whazaa).\n */\n\nimport { connect, Socket } from \"node:net\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  NotificationConfig,\n  NotificationMode,\n  NotificationEvent,\n  SendResult,\n} from \"../notifications/types.js\";\nimport type { TopicCheckParams, TopicCheckResult } from \"../topics/detector.js\";\nimport type { AutoRouteResult } from \"../session/auto-route.js\";\n\n// ---------------------------------------------------------------------------\n// Protocol types\n// ---------------------------------------------------------------------------\n\n/** Default socket path */\nexport const IPC_SOCKET_PATH = \"/tmp/pai.sock\";\n\n/** Timeout for IPC calls (60 seconds) */\nconst IPC_TIMEOUT_MS = 60_000;\n\ninterface IpcRequest {\n  id: string;\n  method: string;\n  params: Record<string, unknown>;\n}\n\ninterface IpcResponse {\n  id: string;\n  ok: boolean;\n  result?: unknown;\n  error?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Client\n// ---------------------------------------------------------------------------\n\n/**\n * Thin IPC proxy that forwards tool calls to pai-daemon over a Unix\n * Domain Socket. Each call opens a fresh connection, sends one NDJSON request,\n * reads the response, and closes. Stateless and simple.\n */\nexport class PaiClient {\n  private readonly socketPath: string;\n\n  constructor(socketPath?: string) {\n    this.socketPath = socketPath ?? IPC_SOCKET_PATH;\n  }\n\n  /**\n   * Call a PAI tool by name with the given params.\n   * Returns the tool result or throws on error.\n   */\n  async call(method: string, params: Record<string, unknown>): Promise<unknown> {\n    return this.send(method, params);\n  }\n\n  /**\n   * Check daemon status.\n   */\n  async status(): Promise<Record<string, unknown>> {\n    const result = await this.send(\"status\", {});\n    return result as Record<string, unknown>;\n  }\n\n  /**\n   * Trigger an immediate index run.\n   */\n  async triggerIndex(): Promise<void> {\n    await this.send(\"index_now\", {});\n  }\n\n  // -------------------------------------------------------------------------\n  // Notification methods\n  // -------------------------------------------------------------------------\n\n  /**\n   * Get the current notification config from the daemon.\n   */\n  async getNotificationConfig(): Promise<{\n    config: NotificationConfig;\n    activeChannels: string[];\n  }> {\n    const result = await this.send(\"notification_get_config\", {});\n    return result as { config: NotificationConfig; activeChannels: string[] };\n  }\n\n  /**\n   * Patch the notification config on the daemon (and persist to disk).\n   */\n  async setNotificationConfig(patch: {\n    mode?: NotificationMode;\n    channels?: Partial<NotificationConfig[\"channels\"]>;\n    routing?: Partial<NotificationConfig[\"routing\"]>;\n  }): Promise<{ config: NotificationConfig }> {\n    const result = await this.send(\"notification_set_config\", patch as Record<string, unknown>);\n    return result as { config: NotificationConfig };\n  }\n\n  /**\n   * Send a notification via the daemon (routes to configured channels).\n   */\n  async sendNotification(payload: {\n    event: NotificationEvent;\n    message: string;\n    title?: string;\n  }): Promise<SendResult> {\n    const result = await this.send(\"notification_send\", payload as Record<string, unknown>);\n    return result as SendResult;\n  }\n\n  // -------------------------------------------------------------------------\n  // Topic detection methods\n  // -------------------------------------------------------------------------\n\n  /**\n   * Check whether the provided context text has drifted to a different project\n   * than the session's current routing.\n   */\n  async topicCheck(params: TopicCheckParams): Promise<TopicCheckResult> {\n    const result = await this.send(\"topic_check\", params as Record<string, unknown>);\n    return result as TopicCheckResult;\n  }\n\n  // -------------------------------------------------------------------------\n  // Session routing methods\n  // -------------------------------------------------------------------------\n\n  /**\n   * Automatically detect which project a session belongs to.\n   * Tries path match, PAI.md marker walk, then topic detection (if context given).\n   */\n  async sessionAutoRoute(params: {\n    cwd?: string;\n    context?: string;\n  }): Promise<AutoRouteResult | null> {\n    // session_auto_route returns a ToolResult (content array). Extract the text\n    // and parse JSON from it.\n    const result = await this.send(\"session_auto_route\", params as Record<string, unknown>);\n    const toolResult = result as { content?: Array<{ text: string }>; isError?: boolean };\n    if (toolResult.isError) return null;\n    const text = toolResult.content?.[0]?.text ?? \"\";\n    // Text is either JSON (on match) or a human-readable \"no match\" message\n    try {\n      return JSON.parse(text) as AutoRouteResult;\n    } catch {\n      return null;\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Internal transport\n  // -------------------------------------------------------------------------\n\n  /**\n   * Send a single IPC request and wait for the response.\n   * Opens a new socket connection per call — simple and reliable.\n   */\n  private send(\n    method: string,\n    params: Record<string, unknown>\n  ): Promise<unknown> {\n    const socketPath = this.socketPath;\n\n    return new Promise((resolve, reject) => {\n      let socket: Socket | null = null;\n      let done = false;\n      let buffer = \"\";\n      let timer: ReturnType<typeof setTimeout> | null = null;\n\n      function finish(error: Error | null, value?: unknown): void {\n        if (done) return;\n        done = true;\n        if (timer !== null) {\n          clearTimeout(timer);\n          timer = null;\n        }\n        try {\n          socket?.destroy();\n        } catch {\n          // ignore\n        }\n        if (error) {\n          reject(error);\n        } else {\n          resolve(value);\n        }\n      }\n\n      socket = connect(socketPath, () => {\n        const request: IpcRequest = {\n          id: randomUUID(),\n          method,\n          params,\n        };\n        socket!.write(JSON.stringify(request) + \"\\n\");\n      });\n\n      socket.on(\"data\", (chunk: Buffer) => {\n        buffer += chunk.toString();\n        const nl = buffer.indexOf(\"\\n\");\n        if (nl === -1) return;\n\n        const line = buffer.slice(0, nl);\n        buffer = buffer.slice(nl + 1);\n\n        let response: IpcResponse;\n        try {\n          response = JSON.parse(line) as IpcResponse;\n        } catch {\n          finish(new Error(`IPC parse error: ${line}`));\n          return;\n        }\n\n        if (!response.ok) {\n          finish(new Error(response.error ?? \"IPC call failed\"));\n        } else {\n          finish(null, response.result);\n        }\n      });\n\n      socket.on(\"error\", (e: NodeJS.ErrnoException) => {\n        if (e.code === \"ENOENT\" || e.code === \"ECONNREFUSED\") {\n          finish(\n            new Error(\n              \"PAI daemon not running. Start it with: pai daemon serve\"\n            )\n          );\n        } else {\n          finish(e);\n        }\n      });\n\n      socket.on(\"end\", () => {\n        if (!done) {\n          finish(new Error(\"IPC connection closed before response\"));\n        }\n      });\n\n      timer = setTimeout(() => {\n        finish(new Error(\"IPC call timed out after 60s\"));\n      }, IPC_TIMEOUT_MS);\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2BA,MAAa,kBAAkB;;AAG/B,MAAM,iBAAiB;;;;;;AAwBvB,IAAa,YAAb,MAAuB;CACrB,AAAiB;CAEjB,YAAY,YAAqB;AAC/B,OAAK,aAAa,cAAc;;;;;;CAOlC,MAAM,KAAK,QAAgB,QAAmD;AAC5E,SAAO,KAAK,KAAK,QAAQ,OAAO;;;;;CAMlC,MAAM,SAA2C;AAE/C,SADe,MAAM,KAAK,KAAK,UAAU,EAAE,CAAC;;;;;CAO9C,MAAM,eAA8B;AAClC,QAAM,KAAK,KAAK,aAAa,EAAE,CAAC;;;;;CAUlC,MAAM,wBAGH;AAED,SADe,MAAM,KAAK,KAAK,2BAA2B,EAAE,CAAC;;;;;CAO/D,MAAM,sBAAsB,OAIgB;AAE1C,SADe,MAAM,KAAK,KAAK,2BAA2B,MAAiC;;;;;CAO7F,MAAM,iBAAiB,SAIC;AAEtB,SADe,MAAM,KAAK,KAAK,qBAAqB,QAAmC;;;;;;CAYzF,MAAM,WAAW,QAAqD;AAEpE,SADe,MAAM,KAAK,KAAK,eAAe,OAAkC;;;;;;CAYlF,MAAM,iBAAiB,QAGa;EAIlC,MAAM,aADS,MAAM,KAAK,KAAK,sBAAsB,OAAkC;AAEvF,MAAI,WAAW,QAAS,QAAO;EAC/B,MAAM,OAAO,WAAW,UAAU,IAAI,QAAQ;AAE9C,MAAI;AACF,UAAO,KAAK,MAAM,KAAK;UACjB;AACN,UAAO;;;;;;;CAYX,AAAQ,KACN,QACA,QACkB;EAClB,MAAM,aAAa,KAAK;AAExB,SAAO,IAAI,SAAS,SAAS,WAAW;GACtC,IAAI,SAAwB;GAC5B,IAAI,OAAO;GACX,IAAI,SAAS;GACb,IAAI,QAA8C;GAElD,SAAS,OAAO,OAAqB,OAAuB;AAC1D,QAAI,KAAM;AACV,WAAO;AACP,QAAI,UAAU,MAAM;AAClB,kBAAa,MAAM;AACnB,aAAQ;;AAEV,QAAI;AACF,aAAQ,SAAS;YACX;AAGR,QAAI,MACF,QAAO,MAAM;QAEb,SAAQ,MAAM;;AAIlB,YAAS,QAAQ,kBAAkB;IACjC,MAAM,UAAsB;KAC1B,IAAI,YAAY;KAChB;KACA;KACD;AACD,WAAQ,MAAM,KAAK,UAAU,QAAQ,GAAG,KAAK;KAC7C;AAEF,UAAO,GAAG,SAAS,UAAkB;AACnC,cAAU,MAAM,UAAU;IAC1B,MAAM,KAAK,OAAO,QAAQ,KAAK;AAC/B,QAAI,OAAO,GAAI;IAEf,MAAM,OAAO,OAAO,MAAM,GAAG,GAAG;AAChC,aAAS,OAAO,MAAM,KAAK,EAAE;IAE7B,IAAI;AACJ,QAAI;AACF,gBAAW,KAAK,MAAM,KAAK;YACrB;AACN,4BAAO,IAAI,MAAM,oBAAoB,OAAO,CAAC;AAC7C;;AAGF,QAAI,CAAC,SAAS,GACZ,QAAO,IAAI,MAAM,SAAS,SAAS,kBAAkB,CAAC;QAEtD,QAAO,MAAM,SAAS,OAAO;KAE/B;AAEF,UAAO,GAAG,UAAU,MAA6B;AAC/C,QAAI,EAAE,SAAS,YAAY,EAAE,SAAS,eACpC,wBACE,IAAI,MACF,0DACD,CACF;QAED,QAAO,EAAE;KAEX;AAEF,UAAO,GAAG,aAAa;AACrB,QAAI,CAAC,KACH,wBAAO,IAAI,MAAM,wCAAwC,CAAC;KAE5D;AAEF,WAAQ,iBAAiB;AACvB,2BAAO,IAAI,MAAM,+BAA+B,CAAC;MAChD,eAAe;IAClB"}

package/dist/mcp/index.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/mcp/index.mjs

@@ -0,0 +1,373 @@
+#!/usr/bin/env node
+import { n as openRegistry } from "../db-4lSqLFb8.mjs";
+import { n as openFederation } from "../db-BcDxXVBu.mjs";
+import "../embeddings-mfqv-jFu.mjs";
+import "../search-PjftDxxs.mjs";
+import { a as record, i as number, n as array, o as string, r as boolean, s as unknown, t as _enum } from "../schemas-DjdwzIQ8.mjs";
+import { a as toolProjectHealth, d as toolSessionRoute, f as toolTopicDetect, i as toolProjectDetect, l as toolRegistrySearch, n as toolMemorySearch, o as toolProjectInfo, r as toolNotificationConfig, s as toolProjectList, t as toolMemoryGet, u as toolSessionList } from "../tools-CLK4080-.mjs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+//#region src/mcp/server.ts
+/**
+* PAI Knowledge OS — MCP Server (Phase 3)
+*
+* Exposes PAI registry and memory as MCP tools callable by Claude Code.
+*
+* Tools:
+*   memory_search   — BM25 search across indexed memory/notes
+*   memory_get      — Read a specific file or lines from a project
+*   project_info    — Get details for a project (by slug or current dir)
+*   project_list    — List projects with optional filters
+*   session_list    — List sessions for a project
+*   registry_search — Full-text search over project slugs/names/paths
+*   project_detect  — Detect which project a path belongs to
+*   project_health  — Audit all projects for moved/deleted directories
+*   session_route   — Auto-route session to project (path/marker/topic)
+*
+* NOTE: All tool logic lives in tools.ts (shared with the daemon).
+* This file wires MCP schema definitions to those pure functions.
+*/
+let _registryDb = null;
+let _federationDb = null;
+function getRegistryDb() {
+	if (!_registryDb) _registryDb = openRegistry();
+	return _registryDb;
+}
+function getFederationDb() {
+	if (!_federationDb) _federationDb = openFederation();
+	return _federationDb;
+}
+async function startMcpServer() {
+	const server = new McpServer({
+		name: "pai",
+		version: "0.1.0"
+	});
+	server.tool("memory_search", [
+		"Search PAI federated memory using BM25 full-text ranking, semantic similarity, or a hybrid of both.",
+		"",
+		"Use this BEFORE answering questions about past work, decisions, dates, people,",
+		"preferences, project status, todos, technical choices, or anything that might",
+		"have been recorded in session notes or memory files.",
+		"",
+		"Modes:",
+		"  keyword  — BM25 full-text search (default, fast, no embeddings required)",
+		"  semantic — Cosine similarity over vector embeddings (requires prior embed run)",
+		"  hybrid   — Normalized combination of BM25 + cosine (best quality)",
+		"",
+		"Returns ranked snippets with project slug, file path, line range, and score.",
+		"Higher score = more relevant."
+	].join("\n"), {
+		query: string().describe("Free-text search query. Multiple words are ORed together — any matching word returns a result, ranked by relevance."),
+		project: string().optional().describe("Scope search to a single project by slug. Omit to search all projects."),
+		all_projects: boolean().optional().describe("Explicitly search all projects (default behaviour when project is omitted)."),
+		sources: array(_enum(["memory", "notes"])).optional().describe("Restrict to specific source types: 'memory' or 'notes'."),
+		limit: number().int().min(1).max(100).optional().describe("Maximum results to return. Default: 10."),
+		mode: _enum([
+			"keyword",
+			"semantic",
+			"hybrid"
+		]).optional().describe("Search mode: 'keyword' (BM25, default), 'semantic' (vector cosine), or 'hybrid' (both combined).")
+	}, async (args) => {
+		const result = await toolMemorySearch(getRegistryDb(), getFederationDb(), args);
+		return {
+			content: result.content.map((c) => ({
+				type: c.type,
+				text: c.text
+			})),
+			isError: result.isError
+		};
+	});
+	server.tool("memory_get", [
+		"Read the content of a specific file from a registered PAI project.",
+		"",
+		"Use this to read a full memory file, session note, or document after finding",
+		"it via memory_search. Optionally restrict to a line range.",
+		"",
+		"The path must be a relative path within the project root (no ../ traversal)."
+	].join("\n"), {
+		project: string().describe("Project slug identifying which project's files to read from."),
+		path: string().describe("Relative path within the project root (e.g. 'Notes/0001 - 2026-01-01 - Example.md')."),
+		from: number().int().min(1).optional().describe("Starting line number (1-based, inclusive). Default: 1."),
+		lines: number().int().min(1).optional().describe("Number of lines to return. Default: entire file.")
+	}, async (args) => {
+		const result = toolMemoryGet(getRegistryDb(), args);
+		return {
+			content: result.content.map((c) => ({
+				type: c.type,
+				text: c.text
+			})),
+			isError: result.isError
+		};
+	});
+	server.tool("project_info", [
+		"Get detailed information about a PAI registered project.",
+		"",
+		"Use this to look up a project's root path, type, status, tags, session count,",
+		"and last active date. If no slug is provided, attempts to detect the current",
+		"project from the caller's working directory."
+	].join("\n"), { slug: string().optional().describe("Project slug. Omit to auto-detect from the current working directory.") }, async (args) => {
+		const result = toolProjectInfo(getRegistryDb(), args);
+		return {
+			content: result.content.map((c) => ({
+				type: c.type,
+				text: c.text
+			})),
+			isError: result.isError
+		};
+	});
+	server.tool("project_list", [
+		"List registered PAI projects with optional filters.",
+		"",
+		"Use this to browse all known projects, find projects by status or tag,",
+		"or get a quick overview of the PAI registry."
+	].join("\n"), {
+		status: _enum([
+			"active",
+			"archived",
+			"migrating"
+		]).optional().describe("Filter by project status. Default: all statuses."),
+		tag: string().optional().describe("Filter by tag name (exact match)."),
+		limit: number().int().min(1).max(500).optional().describe("Maximum number of projects to return. Default: 50.")
+	}, async (args) => {
+		const result = toolProjectList(getRegistryDb(), args);
+		return {
+			content: result.content.map((c) => ({
+				type: c.type,
+				text: c.text
+			})),
+			isError: result.isError
+		};
+	});
+	server.tool("session_list", [
+		"List session notes for a PAI project.",
+		"",
+		"Use this to find what sessions exist for a project, see their dates and titles,",
+		"and identify specific session notes to read via memory_get."
+	].join("\n"), {
+		project: string().describe("Project slug to list sessions for."),
+		limit: number().int().min(1).max(500).optional().describe("Maximum sessions to return. Default: 10 (most recent first)."),
+		status: _enum([
+			"open",
+			"completed",
+			"compacted"
+		]).optional().describe("Filter by session status.")
+	}, async (args) => {
+		const result = toolSessionList(getRegistryDb(), args);
+		return {
+			content: result.content.map((c) => ({
+				type: c.type,
+				text: c.text
+			})),
+			isError: result.isError
+		};
+	});
+	server.tool("registry_search", [
+		"Search PAI project registry by slug, display name, or path.",
+		"",
+		"Use this to find the slug for a project when you know its name or path,",
+		"or to check if a project is registered. Returns matching project entries."
+	].join("\n"), { query: string().describe("Search term matched against project slugs, display names, and root paths (case-insensitive substring match).") }, async (args) => {
+		const result = toolRegistrySearch(getRegistryDb(), args);
+		return {
+			content: result.content.map((c) => ({
+				type: c.type,
+				text: c.text
+			})),
+			isError: result.isError
+		};
+	});
+	server.tool("project_detect", [
+		"Detect which registered PAI project a filesystem path belongs to.",
+		"",
+		"Use this at session start to auto-identify the current project from the",
+		"working directory, or to map any path back to its registered project.",
+		"",
+		"Returns: slug, display_name, root_path, type, status, match_type (exact|parent),",
+		"relative_path (if the given path is inside a project), and session stats.",
+		"",
+		"match_type 'exact' means the path IS the project root.",
+		"match_type 'parent' means the path is a subdirectory of the project root."
+	].join("\n"), { cwd: string().optional().describe("Absolute path to detect project for. Defaults to the MCP server's process.cwd().") }, async (args) => {
+		const result = toolProjectDetect(getRegistryDb(), args);
+		return {
+			content: result.content.map((c) => ({
+				type: c.type,
+				text: c.text
+			})),
+			isError: result.isError
+		};
+	});
+	server.tool("project_health", [
+		"Audit all registered PAI projects to find moved or deleted directories.",
+		"",
+		"Returns a JSON report categorising every project as:",
+		"  active  — root_path exists on disk",
+		"  stale   — root_path missing, but a directory with the same name was found nearby",
+		"  dead    — root_path missing, no candidate found",
+		"",
+		"Use this to diagnose orphaned sessions or missing project paths."
+	].join("\n"), { category: _enum([
+		"active",
+		"stale",
+		"dead",
+		"all"
+	]).optional().describe("Filter results to a specific health category. Default: all.") }, async (args) => {
+		const result = await toolProjectHealth(getRegistryDb(), args);
+		return {
+			content: result.content.map((c) => ({
+				type: c.type,
+				text: c.text
+			})),
+			isError: result.isError
+		};
+	});
+	server.tool("notification_config", [
+		"Query or update the PAI unified notification configuration.",
+		"",
+		"Actions:",
+		"  get  — Return the current notification mode, active channels, and routing table.",
+		"  set  — Change the notification mode or update channel/routing config.",
+		"  send — Send a notification through the configured channels.",
+		"",
+		"Notification modes:",
+		"  auto      — Use the per-event routing table (default)",
+		"  voice     — All events sent as WhatsApp voice (TTS)",
+		"  whatsapp  — All events sent as WhatsApp text",
+		"  ntfy      — All events sent to ntfy.sh",
+		"  macos     — All events sent as macOS notifications",
+		"  cli       — All events written to CLI output only",
+		"  off       — Suppress all notifications",
+		"",
+		"Event types for send: error | progress | completion | info | debug",
+		"",
+		"Examples:",
+		"  { \"action\": \"get\" }",
+		"  { \"action\": \"set\", \"mode\": \"voice\" }",
+		"  { \"action\": \"send\", \"event\": \"completion\", \"message\": \"Done!\" }"
+	].join("\n"), {
+		action: _enum([
+			"get",
+			"set",
+			"send"
+		]).describe("Action: 'get' (read config), 'set' (update config), 'send' (send notification)."),
+		mode: _enum([
+			"auto",
+			"voice",
+			"whatsapp",
+			"ntfy",
+			"macos",
+			"cli",
+			"off"
+		]).optional().describe("For action=set: new notification mode."),
+		channels: record(string(), unknown()).optional().describe("For action=set: partial channel config overrides as a JSON object. E.g. { \"whatsapp\": { \"enabled\": true }, \"macos\": { \"enabled\": false } }"),
+		routing: record(string(), unknown()).optional().describe("For action=set: partial routing overrides as a JSON object. E.g. { \"error\": [\"whatsapp\", \"macos\"], \"progress\": [\"cli\"] }"),
+		event: _enum([
+			"error",
+			"progress",
+			"completion",
+			"info",
+			"debug"
+		]).optional().describe("For action=send: event type. Default: 'info'."),
+		message: string().optional().describe("For action=send: the notification message body."),
+		title: string().optional().describe("For action=send: optional notification title (used by macOS and ntfy).")
+	}, async (args) => {
+		const result = await toolNotificationConfig(args);
+		return {
+			content: result.content.map((c) => ({
+				type: c.type,
+				text: c.text
+			})),
+			isError: result.isError
+		};
+	});
+	server.tool("topic_detect", [
+		"Detect whether recent conversation context has shifted to a different project.",
+		"",
+		"Call this when the conversation may have drifted away from the initially-routed project.",
+		"Provide a short summary of the recent context (last few messages or tool call results).",
+		"",
+		"Returns:",
+		"  shifted          — true if a topic shift was detected",
+		"  current_project  — the project the session is currently routed to",
+		"  suggested_project — the project that best matches the context",
+		"  confidence       — [0,1] fraction of memory mass held by suggested_project",
+		"  chunks_scored    — number of memory chunks that contributed to scoring",
+		"  top_matches      — top-3 projects with their confidence percentages",
+		"",
+		"A shift is reported when confidence >= threshold (default 0.6) and the",
+		"best-matching project differs from current_project.",
+		"",
+		"Use cases:",
+		"  - Call at session start to confirm routing is correct",
+		"  - Call periodically when working across multiple concerns",
+		"  - Integrate with pre-tool hooks for automatic drift detection"
+	].join("\n"), {
+		context: string().describe("Recent conversation context: a few sentences summarising what the session has been discussing. Can include file paths, feature names, commands run, or any relevant text."),
+		current_project: string().optional().describe("The project slug this session is currently routed to. If omitted, the tool still returns the best-matching project but shifted will always be false."),
+		threshold: number().min(0).max(1).optional().describe("Minimum confidence [0,1] to declare a shift. Default: 0.6. Increase to reduce false positives. Decrease to catch subtle drifts.")
+	}, async (args) => {
+		const result = await toolTopicDetect(args);
+		return {
+			content: result.content.map((c) => ({
+				type: c.type,
+				text: c.text
+			})),
+			isError: result.isError
+		};
+	});
+	server.tool("session_route", [
+		"Automatically detect which project this session belongs to.",
+		"",
+		"Call this at session start (e.g., from CLAUDE.md or a session-start hook)",
+		"to route the session to the correct project automatically.",
+		"",
+		"Detection strategy (in priority order):",
+		"  1. path   — exact or parent-directory match in the project registry",
+		"  2. marker — walk up from cwd looking for Notes/PAI.md marker files",
+		"  3. topic  — BM25 keyword search against memory (only if context provided)",
+		"",
+		"Returns:",
+		"  slug         — the matched project slug",
+		"  display_name — human-readable project name",
+		"  root_path    — absolute path to the project root",
+		"  method       — how it was detected: 'path', 'marker', or 'topic'",
+		"  confidence   — 1.0 for path/marker matches, BM25 fraction for topic",
+		"",
+		"If no match is found, returns a message explaining what was tried.",
+		"Run 'pai project add .' to register the current directory."
+	].join("\n"), {
+		cwd: string().optional().describe("Working directory to detect from. Defaults to process.cwd(). Pass the session's actual working directory for accurate detection."),
+		context: string().optional().describe("Optional conversation context for topic-based fallback routing. A few sentences summarising what the session will work on. Only used if path and marker detection both fail.")
+	}, async (args) => {
+		const result = await toolSessionRoute(getRegistryDb(), getFederationDb(), args);
+		return {
+			content: result.content.map((c) => ({
+				type: c.type,
+				text: c.text
+			})),
+			isError: result.isError
+		};
+	});
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+}
+
+//#endregion
+//#region src/mcp/index.ts
+/**
+* PAI Knowledge OS — MCP server entry point
+*
+* When invoked as `node dist/mcp/index.mjs` (or via the `pai-mcp` bin),
+* starts the PAI MCP server on stdio transport so Claude Code can call
+* memory_search, memory_get, project_info, project_list, session_list,
+* and registry_search tools directly during conversations.
+*/
+startMcpServer().catch((err) => {
+	process.stderr.write(`PAI MCP server fatal error: ${String(err)}\n`);
+	process.exit(1);
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=index.mjs.map

package/dist/mcp/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["z\n        .string","z\n        .boolean","z\n        .array","z.enum","z\n        .number","z\n        .enum","z.string","z\n        .record","z.unknown"],"sources":["../../src/mcp/server.ts","../../src/mcp/index.ts"],"sourcesContent":["/**\n * PAI Knowledge OS — MCP Server (Phase 3)\n *\n * Exposes PAI registry and memory as MCP tools callable by Claude Code.\n *\n * Tools:\n *   memory_search   — BM25 search across indexed memory/notes\n *   memory_get      — Read a specific file or lines from a project\n *   project_info    — Get details for a project (by slug or current dir)\n *   project_list    — List projects with optional filters\n *   session_list    — List sessions for a project\n *   registry_search — Full-text search over project slugs/names/paths\n *   project_detect  — Detect which project a path belongs to\n *   project_health  — Audit all projects for moved/deleted directories\n *   session_route   — Auto-route session to project (path/marker/topic)\n *\n * NOTE: All tool logic lives in tools.ts (shared with the daemon).\n * This file wires MCP schema definitions to those pure functions.\n */\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\nimport { openRegistry } from \"../registry/db.js\";\nimport { openFederation } from \"../memory/db.js\";\nimport {\n  toolMemorySearch,\n  toolMemoryGet,\n  toolProjectInfo,\n  toolProjectList,\n  toolSessionList,\n  toolRegistrySearch,\n  toolProjectDetect,\n  toolProjectHealth,\n  toolNotificationConfig,\n  toolTopicDetect,\n  toolSessionRoute,\n} from \"./tools.js\";\n\n// ---------------------------------------------------------------------------\n// Database singletons (opened lazily, once per MCP server process)\n// ---------------------------------------------------------------------------\n\nlet _registryDb: ReturnType<typeof openRegistry> | null = null;\nlet _federationDb: ReturnType<typeof openFederation> | null = null;\n\nfunction getRegistryDb() {\n  if (!_registryDb) _registryDb = openRegistry();\n  return _registryDb;\n}\n\nfunction getFederationDb() {\n  if (!_federationDb) _federationDb = openFederation();\n  return _federationDb;\n}\n\n// ---------------------------------------------------------------------------\n// MCP server startup\n// ---------------------------------------------------------------------------\n\nexport async function startMcpServer(): Promise<void> {\n  const server = new McpServer({\n    name: \"pai\",\n    version: \"0.1.0\",\n  });\n\n  // -------------------------------------------------------------------------\n  // Tool: memory_search\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"memory_search\",\n    [\n      \"Search PAI federated memory using BM25 full-text ranking, semantic similarity, or a hybrid of both.\",\n      \"\",\n      \"Use this BEFORE answering questions about past work, decisions, dates, people,\",\n      \"preferences, project status, todos, technical choices, or anything that might\",\n      \"have been recorded in session notes or memory files.\",\n      \"\",\n      \"Modes:\",\n      \"  keyword  — BM25 full-text search (default, fast, no embeddings required)\",\n      \"  semantic — Cosine similarity over vector embeddings (requires prior embed run)\",\n      \"  hybrid   — Normalized combination of BM25 + cosine (best quality)\",\n      \"\",\n      \"Returns ranked snippets with project slug, file path, line range, and score.\",\n      \"Higher score = more relevant.\",\n    ].join(\"\\n\"),\n    {\n      query: z\n        .string()\n        .describe(\"Free-text search query. Multiple words are ORed together — any matching word returns a result, ranked by relevance.\"),\n      project: z\n        .string()\n        .optional()\n        .describe(\n          \"Scope search to a single project by slug. Omit to search all projects.\"\n        ),\n      all_projects: z\n        .boolean()\n        .optional()\n        .describe(\n          \"Explicitly search all projects (default behaviour when project is omitted).\"\n        ),\n      sources: z\n        .array(z.enum([\"memory\", \"notes\"]))\n        .optional()\n        .describe(\"Restrict to specific source types: 'memory' or 'notes'.\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(100)\n        .optional()\n        .describe(\"Maximum results to return. Default: 10.\"),\n      mode: z\n        .enum([\"keyword\", \"semantic\", \"hybrid\"])\n        .optional()\n        .describe(\n          \"Search mode: 'keyword' (BM25, default), 'semantic' (vector cosine), or 'hybrid' (both combined).\"\n        ),\n    },\n    async (args) => {\n      const result = await toolMemorySearch(\n        getRegistryDb(),\n        getFederationDb(),\n        args\n      );\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: memory_get\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"memory_get\",\n    [\n      \"Read the content of a specific file from a registered PAI project.\",\n      \"\",\n      \"Use this to read a full memory file, session note, or document after finding\",\n      \"it via memory_search. Optionally restrict to a line range.\",\n      \"\",\n      \"The path must be a relative path within the project root (no ../ traversal).\",\n    ].join(\"\\n\"),\n    {\n      project: z\n        .string()\n        .describe(\"Project slug identifying which project's files to read from.\"),\n      path: z\n        .string()\n        .describe(\n          \"Relative path within the project root (e.g. 'Notes/0001 - 2026-01-01 - Example.md').\"\n        ),\n      from: z\n        .number()\n        .int()\n        .min(1)\n        .optional()\n        .describe(\"Starting line number (1-based, inclusive). Default: 1.\"),\n      lines: z\n        .number()\n        .int()\n        .min(1)\n        .optional()\n        .describe(\"Number of lines to return. Default: entire file.\"),\n    },\n    async (args) => {\n      const result = toolMemoryGet(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: project_info\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"project_info\",\n    [\n      \"Get detailed information about a PAI registered project.\",\n      \"\",\n      \"Use this to look up a project's root path, type, status, tags, session count,\",\n      \"and last active date. If no slug is provided, attempts to detect the current\",\n      \"project from the caller's working directory.\",\n    ].join(\"\\n\"),\n    {\n      slug: z\n        .string()\n        .optional()\n        .describe(\n          \"Project slug. Omit to auto-detect from the current working directory.\"\n        ),\n    },\n    async (args) => {\n      const result = toolProjectInfo(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: project_list\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"project_list\",\n    [\n      \"List registered PAI projects with optional filters.\",\n      \"\",\n      \"Use this to browse all known projects, find projects by status or tag,\",\n      \"or get a quick overview of the PAI registry.\",\n    ].join(\"\\n\"),\n    {\n      status: z\n        .enum([\"active\", \"archived\", \"migrating\"])\n        .optional()\n        .describe(\"Filter by project status. Default: all statuses.\"),\n      tag: z\n        .string()\n        .optional()\n        .describe(\"Filter by tag name (exact match).\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(500)\n        .optional()\n        .describe(\"Maximum number of projects to return. Default: 50.\"),\n    },\n    async (args) => {\n      const result = toolProjectList(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: session_list\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"session_list\",\n    [\n      \"List session notes for a PAI project.\",\n      \"\",\n      \"Use this to find what sessions exist for a project, see their dates and titles,\",\n      \"and identify specific session notes to read via memory_get.\",\n    ].join(\"\\n\"),\n    {\n      project: z.string().describe(\"Project slug to list sessions for.\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(500)\n        .optional()\n        .describe(\"Maximum sessions to return. Default: 10 (most recent first).\"),\n      status: z\n        .enum([\"open\", \"completed\", \"compacted\"])\n        .optional()\n        .describe(\"Filter by session status.\"),\n    },\n    async (args) => {\n      const result = toolSessionList(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: registry_search\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"registry_search\",\n    [\n      \"Search PAI project registry by slug, display name, or path.\",\n      \"\",\n      \"Use this to find the slug for a project when you know its name or path,\",\n      \"or to check if a project is registered. Returns matching project entries.\",\n    ].join(\"\\n\"),\n    {\n      query: z\n        .string()\n        .describe(\n          \"Search term matched against project slugs, display names, and root paths (case-insensitive substring match).\"\n        ),\n    },\n    async (args) => {\n      const result = toolRegistrySearch(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: project_detect\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"project_detect\",\n    [\n      \"Detect which registered PAI project a filesystem path belongs to.\",\n      \"\",\n      \"Use this at session start to auto-identify the current project from the\",\n      \"working directory, or to map any path back to its registered project.\",\n      \"\",\n      \"Returns: slug, display_name, root_path, type, status, match_type (exact|parent),\",\n      \"relative_path (if the given path is inside a project), and session stats.\",\n      \"\",\n      \"match_type 'exact' means the path IS the project root.\",\n      \"match_type 'parent' means the path is a subdirectory of the project root.\",\n    ].join(\"\\n\"),\n    {\n      cwd: z\n        .string()\n        .optional()\n        .describe(\n          \"Absolute path to detect project for. Defaults to the MCP server's process.cwd().\"\n        ),\n    },\n    async (args) => {\n      const result = toolProjectDetect(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: project_health\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"project_health\",\n    [\n      \"Audit all registered PAI projects to find moved or deleted directories.\",\n      \"\",\n      \"Returns a JSON report categorising every project as:\",\n      \"  active  — root_path exists on disk\",\n      \"  stale   — root_path missing, but a directory with the same name was found nearby\",\n      \"  dead    — root_path missing, no candidate found\",\n      \"\",\n      \"Use this to diagnose orphaned sessions or missing project paths.\",\n    ].join(\"\\n\"),\n    {\n      category: z\n        .enum([\"active\", \"stale\", \"dead\", \"all\"])\n        .optional()\n        .describe(\"Filter results to a specific health category. Default: all.\"),\n    },\n    async (args) => {\n      const result = await toolProjectHealth(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: notification_config\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"notification_config\",\n    [\n      \"Query or update the PAI unified notification configuration.\",\n      \"\",\n      \"Actions:\",\n      \"  get  — Return the current notification mode, active channels, and routing table.\",\n      \"  set  — Change the notification mode or update channel/routing config.\",\n      \"  send — Send a notification through the configured channels.\",\n      \"\",\n      \"Notification modes:\",\n      \"  auto      — Use the per-event routing table (default)\",\n      \"  voice     — All events sent as WhatsApp voice (TTS)\",\n      \"  whatsapp  — All events sent as WhatsApp text\",\n      \"  ntfy      — All events sent to ntfy.sh\",\n      \"  macos     — All events sent as macOS notifications\",\n      \"  cli       — All events written to CLI output only\",\n      \"  off       — Suppress all notifications\",\n      \"\",\n      \"Event types for send: error | progress | completion | info | debug\",\n      \"\",\n      \"Examples:\",\n      '  { \"action\": \"get\" }',\n      '  { \"action\": \"set\", \"mode\": \"voice\" }',\n      '  { \"action\": \"send\", \"event\": \"completion\", \"message\": \"Done!\" }',\n    ].join(\"\\n\"),\n    {\n      action: z\n        .enum([\"get\", \"set\", \"send\"])\n        .describe(\"Action: 'get' (read config), 'set' (update config), 'send' (send notification).\"),\n      mode: z\n        .enum([\"auto\", \"voice\", \"whatsapp\", \"ntfy\", \"macos\", \"cli\", \"off\"])\n        .optional()\n        .describe(\"For action=set: new notification mode.\"),\n      channels: z\n        .record(z.string(), z.unknown())\n        .optional()\n        .describe(\n          \"For action=set: partial channel config overrides as a JSON object. \" +\n          'E.g. { \"whatsapp\": { \"enabled\": true }, \"macos\": { \"enabled\": false } }'\n        ),\n      routing: z\n        .record(z.string(), z.unknown())\n        .optional()\n        .describe(\n          \"For action=set: partial routing overrides as a JSON object. \" +\n          'E.g. { \"error\": [\"whatsapp\", \"macos\"], \"progress\": [\"cli\"] }'\n        ),\n      event: z\n        .enum([\"error\", \"progress\", \"completion\", \"info\", \"debug\"])\n        .optional()\n        .describe(\"For action=send: event type. Default: 'info'.\"),\n      message: z\n        .string()\n        .optional()\n        .describe(\"For action=send: the notification message body.\"),\n      title: z\n        .string()\n        .optional()\n        .describe(\"For action=send: optional notification title (used by macOS and ntfy).\"),\n    },\n    async (args) => {\n      const result = await toolNotificationConfig(args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: topic_detect\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"topic_detect\",\n    [\n      \"Detect whether recent conversation context has shifted to a different project.\",\n      \"\",\n      \"Call this when the conversation may have drifted away from the initially-routed project.\",\n      \"Provide a short summary of the recent context (last few messages or tool call results).\",\n      \"\",\n      \"Returns:\",\n      \"  shifted          — true if a topic shift was detected\",\n      \"  current_project  — the project the session is currently routed to\",\n      \"  suggested_project — the project that best matches the context\",\n      \"  confidence       — [0,1] fraction of memory mass held by suggested_project\",\n      \"  chunks_scored    — number of memory chunks that contributed to scoring\",\n      \"  top_matches      — top-3 projects with their confidence percentages\",\n      \"\",\n      \"A shift is reported when confidence >= threshold (default 0.6) and the\",\n      \"best-matching project differs from current_project.\",\n      \"\",\n      \"Use cases:\",\n      \"  - Call at session start to confirm routing is correct\",\n      \"  - Call periodically when working across multiple concerns\",\n      \"  - Integrate with pre-tool hooks for automatic drift detection\",\n    ].join(\"\\n\"),\n    {\n      context: z\n        .string()\n        .describe(\n          \"Recent conversation context: a few sentences summarising what the session has been discussing. \" +\n          \"Can include file paths, feature names, commands run, or any relevant text.\"\n        ),\n      current_project: z\n        .string()\n        .optional()\n        .describe(\n          \"The project slug this session is currently routed to. \" +\n          \"If omitted, the tool still returns the best-matching project but shifted will always be false.\"\n        ),\n      threshold: z\n        .number()\n        .min(0)\n        .max(1)\n        .optional()\n        .describe(\n          \"Minimum confidence [0,1] to declare a shift. Default: 0.6. \" +\n          \"Increase to reduce false positives. Decrease to catch subtle drifts.\"\n        ),\n    },\n    async (args) => {\n      const result = await toolTopicDetect(args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: session_route\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"session_route\",\n    [\n      \"Automatically detect which project this session belongs to.\",\n      \"\",\n      \"Call this at session start (e.g., from CLAUDE.md or a session-start hook)\",\n      \"to route the session to the correct project automatically.\",\n      \"\",\n      \"Detection strategy (in priority order):\",\n      \"  1. path   — exact or parent-directory match in the project registry\",\n      \"  2. marker — walk up from cwd looking for Notes/PAI.md marker files\",\n      \"  3. topic  — BM25 keyword search against memory (only if context provided)\",\n      \"\",\n      \"Returns:\",\n      \"  slug         — the matched project slug\",\n      \"  display_name — human-readable project name\",\n      \"  root_path    — absolute path to the project root\",\n      \"  method       — how it was detected: 'path', 'marker', or 'topic'\",\n      \"  confidence   — 1.0 for path/marker matches, BM25 fraction for topic\",\n      \"\",\n      \"If no match is found, returns a message explaining what was tried.\",\n      \"Run 'pai project add .' to register the current directory.\",\n    ].join(\"\\n\"),\n    {\n      cwd: z\n        .string()\n        .optional()\n        .describe(\n          \"Working directory to detect from. Defaults to process.cwd(). \" +\n          \"Pass the session's actual working directory for accurate detection.\"\n        ),\n      context: z\n        .string()\n        .optional()\n        .describe(\n          \"Optional conversation context for topic-based fallback routing. \" +\n          \"A few sentences summarising what the session will work on. \" +\n          \"Only used if path and marker detection both fail.\"\n        ),\n    },\n    async (args) => {\n      const result = await toolSessionRoute(getRegistryDb(), getFederationDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Connect transport and start serving\n  // -------------------------------------------------------------------------\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n\n  // Keep the process alive — the server runs until stdin closes\n}\n","#!/usr/bin/env node\n/**\n * PAI Knowledge OS — MCP server entry point\n *\n * When invoked as `node dist/mcp/index.mjs` (or via the `pai-mcp` bin),\n * starts the PAI MCP server on stdio transport so Claude Code can call\n * memory_search, memory_get, project_info, project_list, session_list,\n * and registry_search tools directly during conversations.\n */\n\nimport { startMcpServer } from \"./server.js\";\n\nstartMcpServer().catch((err) => {\n  // Write errors to stderr only — stdout is reserved for JSON-RPC messages\n  process.stderr.write(`PAI MCP server fatal error: ${String(err)}\\n`);\n  process.exit(1);\n});\n"],"mappings":"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"}