@codemem/mcp 0.0.0 → 0.20.0-alpha.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adam Kunicki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * @codemem/mcp — MCP stdio server.
+ *
+ * Runs as a separate process spawned by the host (OpenCode/Claude).
+ * Owns its own better-sqlite3 connection. Communicates via stdio JSON-RPC.
+ *
+ * Port of codemem/mcp_server.py — all 13 tools.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,486 @@
+#!/usr/bin/env node
+import { MemoryStore, VERSION, dedupeOrderedIds, projectClause, resolveDbPath, resolveProject, toJson } from "@codemem/core";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+//#region src/project-scope.ts
+function resolveDefaultProject() {
+	return process.env.CODEMEM_PROJECT?.trim() || resolveProject(process.cwd());
+}
+function buildFilters(raw, defaultProject = resolveDefaultProject()) {
+	const filters = {};
+	let hasAny = false;
+	const resolvedProject = (typeof raw.project === "string" ? raw.project.trim() : void 0) || defaultProject || void 0;
+	if (resolvedProject) {
+		filters.project = resolvedProject;
+		hasAny = true;
+	}
+	for (const key of [
+		"kind",
+		"visibility",
+		"include_visibility",
+		"exclude_visibility",
+		"include_workspace_ids",
+		"exclude_workspace_ids",
+		"include_workspace_kinds",
+		"exclude_workspace_kinds",
+		"include_actor_ids",
+		"exclude_actor_ids",
+		"include_trust_states",
+		"exclude_trust_states",
+		"ownership_scope",
+		"personal_first",
+		"trust_bias",
+		"widen_shared_when_weak",
+		"widen_shared_min_personal_results",
+		"widen_shared_min_personal_score"
+	]) {
+		const val = raw[key];
+		if (val !== void 0 && val !== null) {
+			filters[key] = val;
+			hasAny = true;
+		}
+	}
+	return hasAny ? filters : void 0;
+}
+//#endregion
+//#region src/index.ts
+/**
+* @codemem/mcp — MCP stdio server.
+*
+* Runs as a separate process spawned by the host (OpenCode/Claude).
+* Owns its own better-sqlite3 connection. Communicates via stdio JSON-RPC.
+*
+* Port of codemem/mcp_server.py — all 13 tools.
+*/
+var MEMORY_KINDS = {
+	discovery: "Something learned about the codebase, architecture, or tools",
+	change: "A code change that was made",
+	feature: "A new feature that was implemented",
+	bugfix: "A bug that was found and fixed",
+	refactor: "Code that was refactored or restructured",
+	decision: "A design or architecture decision",
+	exploration: "An experiment or investigation (may not have shipped)"
+};
+var filterSchema = {
+	kind: z.string().optional().describe("Filter by memory kind"),
+	project: z.string().optional().describe("Filter by project scope (matches sessions.project)"),
+	visibility: z.array(z.string()).optional(),
+	include_visibility: z.array(z.string()).optional(),
+	exclude_visibility: z.array(z.string()).optional(),
+	include_workspace_ids: z.array(z.string()).optional(),
+	exclude_workspace_ids: z.array(z.string()).optional(),
+	include_workspace_kinds: z.array(z.string()).optional(),
+	exclude_workspace_kinds: z.array(z.string()).optional(),
+	include_actor_ids: z.array(z.string()).optional(),
+	exclude_actor_ids: z.array(z.string()).optional(),
+	include_trust_states: z.array(z.string()).optional(),
+	exclude_trust_states: z.array(z.string()).optional(),
+	ownership_scope: z.string().optional(),
+	personal_first: z.union([z.boolean(), z.string()]).optional(),
+	trust_bias: z.string().optional(),
+	widen_shared_when_weak: z.union([z.boolean(), z.string()]).optional(),
+	widen_shared_min_personal_results: z.number().int().optional(),
+	widen_shared_min_personal_score: z.number().optional()
+};
+var defaultProject = resolveDefaultProject();
+/** Wrap a JSON result into the MCP text content envelope. */
+function jsonContent(data) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify(data)
+	}] };
+}
+/** Wrap an error message into the MCP text content envelope. */
+function errorContent(message) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify({ error: message })
+	}] };
+}
+/** ISO timestamp. */
+function nowIso() {
+	return (/* @__PURE__ */ new Date()).toISOString();
+}
+/**
+* Fetch multiple memory items by ID. Returns items in ID order, skipping
+* missing IDs. Implemented directly since MemoryStore doesn't have getMany.
+*/
+function getMany(store, ids) {
+	if (ids.length === 0) return [];
+	const results = [];
+	for (const id of ids) {
+		const item = store.get(id);
+		if (item) results.push(item);
+	}
+	return results;
+}
+async function main() {
+	const store = new MemoryStore(resolveDbPath());
+	const server = new McpServer({
+		name: "codemem",
+		version: VERSION
+	});
+	server.tool("memory_search", "Search memories by text query. Returns full body text for each match.", {
+		query: z.string().describe("Search query"),
+		limit: z.number().int().min(1).max(50).default(5).describe("Max results"),
+		...filterSchema
+	}, async (args) => {
+		try {
+			const filters = buildFilters(args);
+			return jsonContent({ items: store.search(args.query, args.limit, filters).map((m) => ({
+				id: m.id,
+				title: m.title,
+				kind: m.kind,
+				body: m.body_text,
+				confidence: m.confidence,
+				score: m.score,
+				session_id: m.session_id,
+				metadata: m.metadata
+			})) });
+		} catch (err) {
+			return errorContent(err instanceof Error ? err.message : String(err));
+		}
+	});
+	server.tool("memory_search_index", "Search memories by text query. Returns compact index entries (no body) for browsing.", {
+		query: z.string().describe("Search query"),
+		limit: z.number().int().min(1).max(50).default(8).describe("Max results"),
+		...filterSchema
+	}, async (args) => {
+		try {
+			const filters = buildFilters(args);
+			return jsonContent({ items: store.search(args.query, args.limit, filters).map((m) => ({
+				id: m.id,
+				kind: m.kind,
+				title: m.title,
+				score: m.score,
+				created_at: m.created_at,
+				session_id: m.session_id,
+				metadata: m.metadata
+			})) });
+		} catch (err) {
+			return errorContent(err instanceof Error ? err.message : String(err));
+		}
+	});
+	server.tool("memory_timeline", "Get a chronological window of memories around an anchor (by ID or query).", {
+		query: z.string().optional().describe("Search query to find anchor"),
+		memory_id: z.number().int().optional().describe("Anchor memory ID"),
+		depth_before: z.number().int().min(0).default(3).describe("Items before anchor"),
+		depth_after: z.number().int().min(0).default(3).describe("Items after anchor"),
+		...filterSchema
+	}, async (args) => {
+		try {
+			const filters = buildFilters(args);
+			return jsonContent({ items: store.timeline(args.query ?? null, args.memory_id ?? null, args.depth_before, args.depth_after, filters) });
+		} catch (err) {
+			return errorContent(err instanceof Error ? err.message : String(err));
+		}
+	});
+	server.tool("memory_explain", "Explain search results with detailed scoring breakdown.", {
+		query: z.string().optional().describe("Search query"),
+		ids: z.array(z.number().int()).max(200).optional().describe("Specific memory IDs to explain"),
+		limit: z.number().int().min(1).max(50).default(10).describe("Max results"),
+		include_pack_context: z.boolean().default(false).describe("Include formatted pack context"),
+		...filterSchema
+	}, async (args) => {
+		try {
+			const filters = buildFilters(args);
+			return jsonContent(store.explain(args.query ?? null, args.ids ?? null, args.limit, filters));
+		} catch (err) {
+			return errorContent(err instanceof Error ? err.message : String(err));
+		}
+	});
+	server.tool("memory_expand", "Fetch memories by ID with surrounding timeline context.", {
+		ids: z.array(z.union([z.number(), z.string()])).max(200).describe("Memory IDs to expand"),
+		depth_before: z.number().int().min(0).default(3).describe("Timeline items before"),
+		depth_after: z.number().int().min(0).default(3).describe("Timeline items after"),
+		include_observations: z.boolean().default(false).describe("Include full observation details"),
+		project: z.string().optional().describe("Project scope filter")
+	}, async (args) => {
+		try {
+			const resolvedProject = args.project !== void 0 ? args.project.trim() || null : defaultProject || null;
+			const filters = resolvedProject ? { project: resolvedProject } : void 0;
+			const { clause: projectFilterClause, params: projectFilterParams } = resolvedProject ? projectClause(resolvedProject) : {
+				clause: "",
+				params: []
+			};
+			const { ordered: orderedIds, invalid: invalidIds } = dedupeOrderedIds(args.ids);
+			const errors = [];
+			if (invalidIds.length > 0) errors.push({
+				code: "INVALID_ARGUMENT",
+				field: "ids",
+				message: "some ids are not valid integers",
+				ids: invalidIds
+			});
+			const missingNotFound = [];
+			const missingProjectMismatch = [];
+			const anchors = [];
+			const timelineItems = [];
+			const timelineSeen = /* @__PURE__ */ new Set();
+			const sessionScopeMatches = /* @__PURE__ */ new Map();
+			for (const memoryId of orderedIds) {
+				const item = store.get(memoryId);
+				if (!item || !item.active) {
+					missingNotFound.push(memoryId);
+					continue;
+				}
+				const sessionId = item.session_id;
+				if (resolvedProject && projectFilterClause && sessionId > 0) {
+					if (!sessionScopeMatches.has(sessionId)) {
+						const row = store.db.prepare(`SELECT 1 FROM sessions WHERE id = ? AND ${projectFilterClause}`).get(sessionId, ...projectFilterParams);
+						sessionScopeMatches.set(sessionId, row != null);
+					}
+					if (!sessionScopeMatches.get(sessionId)) {
+						missingProjectMismatch.push(memoryId);
+						continue;
+					}
+				} else if (resolvedProject && projectFilterClause && sessionId <= 0) {
+					missingProjectMismatch.push(memoryId);
+					continue;
+				}
+				anchors.push(item);
+				const expanded = store.timeline(null, memoryId, args.depth_before, args.depth_after, filters);
+				for (const expandedItem of expanded) {
+					const expandedId = expandedItem.id;
+					if (expandedId <= 0 || timelineSeen.has(expandedId)) continue;
+					timelineSeen.add(expandedId);
+					timelineItems.push(expandedItem);
+				}
+			}
+			if (missingNotFound.length > 0) errors.push({
+				code: "NOT_FOUND",
+				field: "ids",
+				message: "some requested ids were not found",
+				ids: missingNotFound
+			});
+			if (missingProjectMismatch.length > 0) errors.push({
+				code: "PROJECT_MISMATCH",
+				field: "project",
+				message: "some requested ids are outside the requested project scope",
+				ids: missingProjectMismatch
+			});
+			let observations = [];
+			if (args.include_observations) {
+				const observationSeen = /* @__PURE__ */ new Set();
+				const observationIds = [];
+				for (const item of [...anchors, ...timelineItems]) if (item.id > 0 && !observationSeen.has(item.id)) {
+					observationSeen.add(item.id);
+					observationIds.push(item.id);
+				}
+				observations = getMany(store, observationIds);
+			}
+			return jsonContent({
+				anchors,
+				timeline: timelineItems,
+				observations,
+				missing_ids: orderedIds.filter((memoryId) => missingNotFound.includes(memoryId) || missingProjectMismatch.includes(memoryId)),
+				errors,
+				metadata: {
+					project: resolvedProject,
+					requested_ids_count: orderedIds.length,
+					returned_anchor_count: anchors.length,
+					timeline_count: timelineItems.length,
+					include_observations: args.include_observations
+				}
+			});
+		} catch (err) {
+			return errorContent(err instanceof Error ? err.message : String(err));
+		}
+	});
+	server.tool("memory_get", "Fetch a single memory item by ID.", { memory_id: z.number().int().describe("Memory ID") }, async (args) => {
+		try {
+			const item = store.get(args.memory_id);
+			if (!item) return errorContent("not_found");
+			return jsonContent(item);
+		} catch (err) {
+			return errorContent(err instanceof Error ? err.message : String(err));
+		}
+	});
+	server.tool("memory_get_observations", "Fetch multiple memory items by their IDs.", { ids: z.array(z.number().int()).max(200).describe("Memory IDs to fetch") }, async (args) => {
+		try {
+			return jsonContent({ items: getMany(store, args.ids) });
+		} catch (err) {
+			return errorContent(err instanceof Error ? err.message : String(err));
+		}
+	});
+	server.tool("memory_recent", "Return recent memories, newest first.", {
+		limit: z.number().int().min(1).max(100).default(8).describe("Max results"),
+		...filterSchema
+	}, async (args) => {
+		try {
+			const filters = buildFilters(args);
+			return jsonContent({ items: store.recent(args.limit, filters) });
+		} catch (err) {
+			return errorContent(err instanceof Error ? err.message : String(err));
+		}
+	});
+	server.tool("memory_pack", "Build a formatted memory pack from search results — quick one-shot context block.", {
+		context: z.string().describe("Context description to search for"),
+		limit: z.number().int().min(1).max(50).optional().describe("Max items to include"),
+		...filterSchema
+	}, async (args) => {
+		try {
+			const filters = buildFilters(args);
+			return jsonContent(await store.buildMemoryPackAsync(args.context, args.limit ?? void 0, null, filters));
+		} catch (err) {
+			return errorContent(err instanceof Error ? err.message : String(err));
+		}
+	});
+	server.tool("memory_remember", "Create a new memory. Use for milestones, decisions, and notable facts.", {
+		kind: z.enum([
+			"discovery",
+			"change",
+			"feature",
+			"bugfix",
+			"refactor",
+			"decision",
+			"exploration"
+		]).describe("Memory kind"),
+		title: z.string().describe("Short title"),
+		body: z.string().describe("Body text (high-signal content)"),
+		confidence: z.number().min(0).max(1).default(.5).describe("Confidence 0-1"),
+		project: z.string().optional().describe("Project identifier")
+	}, async (args) => {
+		try {
+			return jsonContent({ id: store.db.transaction(() => {
+				const now = nowIso();
+				const user = process.env.USER ?? "unknown";
+				const cwd = process.cwd();
+				const project = args.project ?? process.env.CODEMEM_PROJECT ?? null;
+				const sessionInfo = store.db.prepare(`INSERT INTO sessions(started_at, ended_at, cwd, project, user, tool_version, metadata_json)
+							 VALUES (?, ?, ?, ?, ?, ?, ?)`).run(now, now, cwd, project, user, "mcp-ts", toJson({ mcp: true }));
+				const sessionId = Number(sessionInfo.lastInsertRowid);
+				const memId = store.remember(sessionId, args.kind, args.title, args.body, args.confidence);
+				store.db.prepare("UPDATE sessions SET ended_at = ?, metadata_json = ? WHERE id = ?").run(nowIso(), toJson({ mcp: true }), sessionId);
+				return memId;
+			})() });
+		} catch (err) {
+			return errorContent(err instanceof Error ? err.message : String(err));
+		}
+	});
+	server.tool("memory_forget", "Soft-delete a memory item. Use for incorrect or sensitive data.", { memory_id: z.number().int().describe("Memory ID to forget") }, async (args) => {
+		try {
+			store.forget(args.memory_id);
+			return jsonContent({ status: "ok" });
+		} catch (err) {
+			return errorContent(err instanceof Error ? err.message : String(err));
+		}
+	});
+	server.tool("memory_schema", "Return the memory schema — kinds, fields, and available filters.", {}, async () => {
+		return jsonContent({
+			kinds: Object.keys(MEMORY_KINDS),
+			kind_descriptions: MEMORY_KINDS,
+			fields: {
+				title: "short text",
+				body: "long text",
+				subtitle: "short text",
+				facts: "list<string>",
+				narrative: "long text",
+				concepts: "list<string>",
+				files_read: "list<string>",
+				files_modified: "list<string>",
+				prompt_number: "int"
+			},
+			filters: [
+				"kind",
+				"session_id",
+				"since",
+				"project",
+				"include_actor_ids",
+				"exclude_actor_ids",
+				"include_visibility",
+				"exclude_visibility",
+				"include_workspace_ids",
+				"exclude_workspace_ids",
+				"include_workspace_kinds",
+				"exclude_workspace_kinds"
+			]
+		});
+	});
+	server.tool("memory_learn", "Learn how to use codemem memory tools. Call this first if unfamiliar.", {}, async () => {
+		return jsonContent({
+			intro: "Use this tool when you're new to codemem or unsure when to recall/persist.",
+			client_hint: "If you are unfamiliar with codemem, call memory.learn first.",
+			recall: {
+				when: ["Start of a task or when the user references prior work.", "When you need background context, decisions, or recent changes."],
+				how: [
+					"Use memory.search_index to get compact candidates.",
+					"Use memory.timeline to expand around a promising memory.",
+					"Use memory.get_observations for full details only when needed.",
+					"Use memory.pack for quick one-shot context blocks.",
+					"Use the project filter unless the user requests cross-project context."
+				],
+				examples: [
+					"memory.search_index(\"billing cache bug\", limit=5)",
+					"memory.timeline(memory_id=123)",
+					"memory.get_observations([123, 456])"
+				]
+			},
+			persistence: {
+				when: ["Milestones (task done, key decision, new facts learned).", "Notable regressions or follow-ups that should be remembered."],
+				how: [
+					"Use memory.remember with kind decision/observation/note.",
+					"Keep titles short and bodies high-signal.",
+					"ALWAYS pass the project parameter if known."
+				],
+				examples: ["memory.remember(kind=\"decision\", title=\"Switch to async cache\", body=\"...why...\", project=\"my-service\")", "memory.remember(kind=\"observation\", title=\"Fixed retry loop\", body=\"...impact...\", project=\"my-service\")"]
+			},
+			forget: {
+				when: ["Accidental or sensitive data stored in memory items.", "Obsolete or incorrect items that should no longer surface."],
+				how: ["Call memory.forget(id) to mark the item inactive.", "Prefer forgetting over overwriting to preserve auditability."],
+				examples: ["memory.forget(123)"]
+			},
+			prompt_hint: "At task start: call memory.search_index; during work: memory.timeline + memory.get_observations; at milestones: memory.remember.",
+			recommended_system_prompt: [
+				"Trigger policy (1-liner): If the user references prior work or starts a task,",
+				"immediately call memory.search_index; then use memory.timeline + memory.get_observations;",
+				"at milestones, call memory.remember; use memory.forget for incorrect/sensitive items.",
+				"",
+				"System prompt:",
+				"You have access to codemem MCP tools. If unfamiliar, call memory.learn first.",
+				"",
+				"Recall:",
+				"- Start of any task: call memory.search_index with a concise task query.",
+				"- If prior work is referenced (\"as before\", \"last time\", \"we already did…\", \"regression\"),",
+				"  call memory.search_index or memory.timeline.",
+				"- Use memory.get_observations only after filtering IDs.",
+				"- Prefer project-scoped queries unless the user asks for cross-project.",
+				"",
+				"Persistence:",
+				"- On milestones (task done, key decision, new facts learned), call memory.remember.",
+				"- Use kind=decision for tradeoffs, kind=observation for outcomes, kind=note for small useful facts.",
+				"- Keep titles short and bodies high-signal.",
+				"- ALWAYS pass the project parameter if known.",
+				"",
+				"Safety:",
+				"- Use memory.forget(id) for incorrect or sensitive items.",
+				"",
+				"Examples:",
+				"- memory.search_index(\"billing cache bug\")",
+				"- memory.timeline(memory_id=123)",
+				"- memory.get_observations([123, 456])",
+				"- memory.remember(kind=\"decision\", title=\"Use async cache\", body=\"Chose async cache to avoid lock contention in X.\", project=\"my-service\")",
+				"- memory.remember(kind=\"observation\", title=\"Fixed retry loop\", body=\"Root cause was Y; added guard in Z.\", project=\"my-service\")",
+				"- memory.forget(123)"
+			].join("\n")
+		});
+	});
+	const transport = new StdioServerTransport();
+	const shutdown = () => {
+		try {
+			store.close();
+		} catch {}
+		process.exit(0);
+	};
+	process.on("SIGINT", shutdown);
+	process.on("SIGTERM", shutdown);
+	await server.connect(transport);
+}
+main().catch((err) => {
+	console.error("codemem MCP server failed to start:", err);
+	process.exit(1);
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/project-scope.ts","../src/index.ts"],"sourcesContent":["import { type MemoryFilters, resolveProject } from \"@codemem/core\";\n\nexport function resolveDefaultProject(): string | null {\n\tconst project = process.env.CODEMEM_PROJECT?.trim();\n\treturn project || resolveProject(process.cwd());\n}\n\nexport function buildFilters(\n\traw: Record<string, unknown>,\n\tdefaultProject = resolveDefaultProject(),\n): MemoryFilters | undefined {\n\tconst filters: MemoryFilters = {};\n\tlet hasAny = false;\n\n\tconst explicitProject = typeof raw.project === \"string\" ? raw.project.trim() : undefined;\n\tconst resolvedProject = explicitProject || defaultProject || undefined;\n\tif (resolvedProject) {\n\t\tfilters.project = resolvedProject;\n\t\thasAny = true;\n\t}\n\n\tfor (const key of [\n\t\t\"kind\",\n\t\t\"visibility\",\n\t\t\"include_visibility\",\n\t\t\"exclude_visibility\",\n\t\t\"include_workspace_ids\",\n\t\t\"exclude_workspace_ids\",\n\t\t\"include_workspace_kinds\",\n\t\t\"exclude_workspace_kinds\",\n\t\t\"include_actor_ids\",\n\t\t\"exclude_actor_ids\",\n\t\t\"include_trust_states\",\n\t\t\"exclude_trust_states\",\n\t\t\"ownership_scope\",\n\t\t\"personal_first\",\n\t\t\"trust_bias\",\n\t\t\"widen_shared_when_weak\",\n\t\t\"widen_shared_min_personal_results\",\n\t\t\"widen_shared_min_personal_score\",\n\t] as const) {\n\t\tconst val = raw[key];\n\t\tif (val !== undefined && val !== null) {\n\t\t\t(filters as Record<string, unknown>)[key] = val;\n\t\t\thasAny = true;\n\t\t}\n\t}\n\n\treturn hasAny ? filters : undefined;\n}\n","#!/usr/bin/env node\n\n/**\n * @codemem/mcp — MCP stdio server.\n *\n * Runs as a separate process spawned by the host (OpenCode/Claude).\n * Owns its own better-sqlite3 connection. Communicates via stdio JSON-RPC.\n *\n * Port of codemem/mcp_server.py — all 13 tools.\n */\n\nimport {\n\tdedupeOrderedIds,\n\ttype MemoryItemResponse,\n\ttype MemoryResult,\n\tMemoryStore,\n\tprojectClause,\n\tresolveDbPath,\n\ttoJson,\n\tVERSION,\n} from \"@codemem/core\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\nimport { buildFilters, resolveDefaultProject } from \"./project-scope.js\";\n\n// ---------------------------------------------------------------------------\n// Static data\n// ---------------------------------------------------------------------------\n\nconst MEMORY_KINDS: Record<string, string> = {\n\tdiscovery: \"Something learned about the codebase, architecture, or tools\",\n\tchange: \"A code change that was made\",\n\tfeature: \"A new feature that was implemented\",\n\tbugfix: \"A bug that was found and fixed\",\n\trefactor: \"Code that was refactored or restructured\",\n\tdecision: \"A design or architecture decision\",\n\texploration: \"An experiment or investigation (may not have shipped)\",\n};\n\n// ---------------------------------------------------------------------------\n// Shared zod filter schema (spread into each tool that accepts filters)\n// ---------------------------------------------------------------------------\n\nconst filterSchema = {\n\tkind: z.string().optional().describe(\"Filter by memory kind\"),\n\tproject: z.string().optional().describe(\"Filter by project scope (matches sessions.project)\"),\n\tvisibility: z.array(z.string()).optional(),\n\tinclude_visibility: z.array(z.string()).optional(),\n\texclude_visibility: z.array(z.string()).optional(),\n\tinclude_workspace_ids: z.array(z.string()).optional(),\n\texclude_workspace_ids: z.array(z.string()).optional(),\n\tinclude_workspace_kinds: z.array(z.string()).optional(),\n\texclude_workspace_kinds: z.array(z.string()).optional(),\n\tinclude_actor_ids: z.array(z.string()).optional(),\n\texclude_actor_ids: z.array(z.string()).optional(),\n\tinclude_trust_states: z.array(z.string()).optional(),\n\texclude_trust_states: z.array(z.string()).optional(),\n\townership_scope: z.string().optional(),\n\tpersonal_first: z.union([z.boolean(), z.string()]).optional(),\n\ttrust_bias: z.string().optional(),\n\twiden_shared_when_weak: z.union([z.boolean(), z.string()]).optional(),\n\twiden_shared_min_personal_results: z.number().int().optional(),\n\twiden_shared_min_personal_score: z.number().optional(),\n};\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nconst defaultProject = resolveDefaultProject();\n\n/** Wrap a JSON result into the MCP text content envelope. */\nfunction jsonContent(data: unknown) {\n\treturn { content: [{ type: \"text\" as const, text: JSON.stringify(data) }] };\n}\n\n/** Wrap an error message into the MCP text content envelope. */\nfunction errorContent(message: string) {\n\treturn { content: [{ type: \"text\" as const, text: JSON.stringify({ error: message }) }] };\n}\n\n/** ISO timestamp. */\nfunction nowIso(): string {\n\treturn new Date().toISOString();\n}\n\n/**\n * Fetch multiple memory items by ID. Returns items in ID order, skipping\n * missing IDs. Implemented directly since MemoryStore doesn't have getMany.\n */\nfunction getMany(store: MemoryStore, ids: number[]): MemoryItemResponse[] {\n\tif (ids.length === 0) return [];\n\tconst results: MemoryItemResponse[] = [];\n\tfor (const id of ids) {\n\t\tconst item = store.get(id);\n\t\tif (item) results.push(item);\n\t}\n\treturn results;\n}\n\n// ---------------------------------------------------------------------------\n// Server bootstrap\n// ---------------------------------------------------------------------------\n\nasync function main() {\n\tconst dbPath = resolveDbPath();\n\tconst store = new MemoryStore(dbPath);\n\n\tconst server = new McpServer({ name: \"codemem\", version: VERSION });\n\n\t// -------------------------------------------------------------------\n\t// 1. memory_search\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_search\",\n\t\t\"Search memories by text query. Returns full body text for each match.\",\n\t\t{\n\t\t\tquery: z.string().describe(\"Search query\"),\n\t\t\tlimit: z.number().int().min(1).max(50).default(5).describe(\"Max results\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args);\n\t\t\t\tconst items = store.search(args.query, args.limit, filters);\n\t\t\t\treturn jsonContent({\n\t\t\t\t\titems: items.map((m: MemoryResult) => ({\n\t\t\t\t\t\tid: m.id,\n\t\t\t\t\t\ttitle: m.title,\n\t\t\t\t\t\tkind: m.kind,\n\t\t\t\t\t\tbody: m.body_text,\n\t\t\t\t\t\tconfidence: m.confidence,\n\t\t\t\t\t\tscore: m.score,\n\t\t\t\t\t\tsession_id: m.session_id,\n\t\t\t\t\t\tmetadata: m.metadata,\n\t\t\t\t\t})),\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// 2. memory_search_index\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_search_index\",\n\t\t\"Search memories by text query. Returns compact index entries (no body) for browsing.\",\n\t\t{\n\t\t\tquery: z.string().describe(\"Search query\"),\n\t\t\tlimit: z.number().int().min(1).max(50).default(8).describe(\"Max results\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args);\n\t\t\t\tconst items = store.search(args.query, args.limit, filters);\n\t\t\t\treturn jsonContent({\n\t\t\t\t\titems: items.map((m: MemoryResult) => ({\n\t\t\t\t\t\tid: m.id,\n\t\t\t\t\t\tkind: m.kind,\n\t\t\t\t\t\ttitle: m.title,\n\t\t\t\t\t\tscore: m.score,\n\t\t\t\t\t\tcreated_at: m.created_at,\n\t\t\t\t\t\tsession_id: m.session_id,\n\t\t\t\t\t\tmetadata: m.metadata,\n\t\t\t\t\t})),\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// 3. memory_timeline\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_timeline\",\n\t\t\"Get a chronological window of memories around an anchor (by ID or query).\",\n\t\t{\n\t\t\tquery: z.string().optional().describe(\"Search query to find anchor\"),\n\t\t\tmemory_id: z.number().int().optional().describe(\"Anchor memory ID\"),\n\t\t\tdepth_before: z.number().int().min(0).default(3).describe(\"Items before anchor\"),\n\t\t\tdepth_after: z.number().int().min(0).default(3).describe(\"Items after anchor\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args);\n\t\t\t\tconst items = store.timeline(\n\t\t\t\t\targs.query ?? null,\n\t\t\t\t\targs.memory_id ?? null,\n\t\t\t\t\targs.depth_before,\n\t\t\t\t\targs.depth_after,\n\t\t\t\t\tfilters,\n\t\t\t\t);\n\t\t\t\treturn jsonContent({ items });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// 4. memory_explain\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_explain\",\n\t\t\"Explain search results with detailed scoring breakdown.\",\n\t\t{\n\t\t\tquery: z.string().optional().describe(\"Search query\"),\n\t\t\tids: z.array(z.number().int()).max(200).optional().describe(\"Specific memory IDs to explain\"),\n\t\t\tlimit: z.number().int().min(1).max(50).default(10).describe(\"Max results\"),\n\t\t\tinclude_pack_context: z.boolean().default(false).describe(\"Include formatted pack context\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args);\n\t\t\t\tconst result = store.explain(args.query ?? null, args.ids ?? null, args.limit, filters);\n\t\t\t\treturn jsonContent(result);\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// 5. memory_expand\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_expand\",\n\t\t\"Fetch memories by ID with surrounding timeline context.\",\n\t\t{\n\t\t\tids: z\n\t\t\t\t.array(z.union([z.number(), z.string()]))\n\t\t\t\t.max(200)\n\t\t\t\t.describe(\"Memory IDs to expand\"),\n\t\t\tdepth_before: z.number().int().min(0).default(3).describe(\"Timeline items before\"),\n\t\t\tdepth_after: z.number().int().min(0).default(3).describe(\"Timeline items after\"),\n\t\t\tinclude_observations: z.boolean().default(false).describe(\"Include full observation details\"),\n\t\t\tproject: z.string().optional().describe(\"Project scope filter\"),\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\t// Python: project if project is not None else default_project\n\t\t\t\t// Explicit \"\" clears project scoping; only fall back to default when undefined.\n\t\t\t\tconst resolvedProject =\n\t\t\t\t\targs.project !== undefined ? args.project.trim() || null : defaultProject || null;\n\t\t\t\tconst filters = resolvedProject ? { project: resolvedProject } : undefined;\n\t\t\t\tconst { clause: projectFilterClause, params: projectFilterParams } = resolvedProject\n\t\t\t\t\t? projectClause(resolvedProject)\n\t\t\t\t\t: { clause: \"\", params: [] as string[] };\n\t\t\t\tconst { ordered: orderedIds, invalid: invalidIds } = dedupeOrderedIds(args.ids);\n\t\t\t\tconst errors: Array<Record<string, unknown>> = [];\n\n\t\t\t\tif (invalidIds.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"INVALID_ARGUMENT\",\n\t\t\t\t\t\tfield: \"ids\",\n\t\t\t\t\t\tmessage: \"some ids are not valid integers\",\n\t\t\t\t\t\tids: invalidIds,\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tconst missingNotFound: number[] = [];\n\t\t\t\tconst missingProjectMismatch: number[] = [];\n\t\t\t\tconst anchors: MemoryItemResponse[] = [];\n\t\t\t\tconst timelineItems: MemoryItemResponse[] = [];\n\t\t\t\tconst timelineSeen = new Set<number>();\n\t\t\t\tconst sessionScopeMatches = new Map<number, boolean>();\n\n\t\t\t\tfor (const memoryId of orderedIds) {\n\t\t\t\t\tconst item = store.get(memoryId);\n\t\t\t\t\tif (!item || !item.active) {\n\t\t\t\t\t\tmissingNotFound.push(memoryId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst sessionId = item.session_id;\n\t\t\t\t\tif (resolvedProject && projectFilterClause && sessionId > 0) {\n\t\t\t\t\t\tif (!sessionScopeMatches.has(sessionId)) {\n\t\t\t\t\t\t\tconst row = store.db\n\t\t\t\t\t\t\t\t.prepare(`SELECT 1 FROM sessions WHERE id = ? AND ${projectFilterClause}`)\n\t\t\t\t\t\t\t\t.get(sessionId, ...projectFilterParams);\n\t\t\t\t\t\t\tsessionScopeMatches.set(sessionId, row != null);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (!sessionScopeMatches.get(sessionId)) {\n\t\t\t\t\t\t\tmissingProjectMismatch.push(memoryId);\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (resolvedProject && projectFilterClause && sessionId <= 0) {\n\t\t\t\t\t\tmissingProjectMismatch.push(memoryId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tanchors.push(item);\n\n\t\t\t\t\tconst expanded = store.timeline(\n\t\t\t\t\t\tnull,\n\t\t\t\t\t\tmemoryId,\n\t\t\t\t\t\targs.depth_before,\n\t\t\t\t\t\targs.depth_after,\n\t\t\t\t\t\tfilters,\n\t\t\t\t\t);\n\t\t\t\t\tfor (const expandedItem of expanded) {\n\t\t\t\t\t\tconst expandedId = expandedItem.id;\n\t\t\t\t\t\tif (expandedId <= 0 || timelineSeen.has(expandedId)) continue;\n\t\t\t\t\t\ttimelineSeen.add(expandedId);\n\t\t\t\t\t\ttimelineItems.push(expandedItem);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (missingNotFound.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"NOT_FOUND\",\n\t\t\t\t\t\tfield: \"ids\",\n\t\t\t\t\t\tmessage: \"some requested ids were not found\",\n\t\t\t\t\t\tids: missingNotFound,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (missingProjectMismatch.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"PROJECT_MISMATCH\",\n\t\t\t\t\t\tfield: \"project\",\n\t\t\t\t\t\tmessage: \"some requested ids are outside the requested project scope\",\n\t\t\t\t\t\tids: missingProjectMismatch,\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\t// Collect full observations if requested\n\t\t\t\tlet observations: MemoryItemResponse[] = [];\n\t\t\t\tif (args.include_observations) {\n\t\t\t\t\tconst observationSeen = new Set<number>();\n\t\t\t\t\tconst observationIds: number[] = [];\n\t\t\t\t\tfor (const item of [...anchors, ...timelineItems]) {\n\t\t\t\t\t\tif (item.id > 0 && !observationSeen.has(item.id)) {\n\t\t\t\t\t\t\tobservationSeen.add(item.id);\n\t\t\t\t\t\t\tobservationIds.push(item.id);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tobservations = getMany(store, observationIds);\n\t\t\t\t}\n\n\t\t\t\treturn jsonContent({\n\t\t\t\t\tanchors,\n\t\t\t\t\ttimeline: timelineItems,\n\t\t\t\t\tobservations,\n\t\t\t\t\tmissing_ids: orderedIds.filter(\n\t\t\t\t\t\t(memoryId: number) =>\n\t\t\t\t\t\t\tmissingNotFound.includes(memoryId) || missingProjectMismatch.includes(memoryId),\n\t\t\t\t\t),\n\t\t\t\t\terrors,\n\t\t\t\t\tmetadata: {\n\t\t\t\t\t\tproject: resolvedProject,\n\t\t\t\t\t\trequested_ids_count: orderedIds.length,\n\t\t\t\t\t\treturned_anchor_count: anchors.length,\n\t\t\t\t\t\ttimeline_count: timelineItems.length,\n\t\t\t\t\t\tinclude_observations: args.include_observations,\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// 6. memory_get\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_get\",\n\t\t\"Fetch a single memory item by ID.\",\n\t\t{\n\t\t\tmemory_id: z.number().int().describe(\"Memory ID\"),\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst item = store.get(args.memory_id);\n\t\t\t\tif (!item) return errorContent(\"not_found\");\n\t\t\t\treturn jsonContent(item);\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// 7. memory_get_observations\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_get_observations\",\n\t\t\"Fetch multiple memory items by their IDs.\",\n\t\t{\n\t\t\tids: z.array(z.number().int()).max(200).describe(\"Memory IDs to fetch\"),\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst items = getMany(store, args.ids);\n\t\t\t\treturn jsonContent({ items });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// 8. memory_recent\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_recent\",\n\t\t\"Return recent memories, newest first.\",\n\t\t{\n\t\t\tlimit: z.number().int().min(1).max(100).default(8).describe(\"Max results\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args);\n\t\t\t\tconst items = store.recent(args.limit, filters);\n\t\t\t\treturn jsonContent({ items });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// 9. memory_pack\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_pack\",\n\t\t\"Build a formatted memory pack from search results — quick one-shot context block.\",\n\t\t{\n\t\t\tcontext: z.string().describe(\"Context description to search for\"),\n\t\t\tlimit: z.number().int().min(1).max(50).optional().describe(\"Max items to include\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args);\n\t\t\t\tconst result = await store.buildMemoryPackAsync(\n\t\t\t\t\targs.context,\n\t\t\t\t\targs.limit ?? undefined,\n\t\t\t\t\tnull,\n\t\t\t\t\tfilters,\n\t\t\t\t);\n\t\t\t\treturn jsonContent(result);\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// 10. memory_remember\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_remember\",\n\t\t\"Create a new memory. Use for milestones, decisions, and notable facts.\",\n\t\t{\n\t\t\tkind: z\n\t\t\t\t.enum([\"discovery\", \"change\", \"feature\", \"bugfix\", \"refactor\", \"decision\", \"exploration\"])\n\t\t\t\t.describe(\"Memory kind\"),\n\t\t\ttitle: z.string().describe(\"Short title\"),\n\t\t\tbody: z.string().describe(\"Body text (high-signal content)\"),\n\t\t\tconfidence: z.number().min(0).max(1).default(0.5).describe(\"Confidence 0-1\"),\n\t\t\tproject: z.string().optional().describe(\"Project identifier\"),\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\t// Create a transient session + memory in a transaction for atomicity.\n\t\t\t\t// TS store doesn't have startSession/endSession yet, so\n\t\t\t\t// we insert the session row directly. Wrapped in transaction to\n\t\t\t\t// prevent orphaned sessions if remember() fails.\n\t\t\t\tconst result = store.db.transaction(() => {\n\t\t\t\t\tconst now = nowIso();\n\t\t\t\t\tconst user = process.env.USER ?? \"unknown\";\n\t\t\t\t\tconst cwd = process.cwd();\n\t\t\t\t\tconst project = args.project ?? process.env.CODEMEM_PROJECT ?? null;\n\n\t\t\t\t\tconst sessionInfo = store.db\n\t\t\t\t\t\t.prepare(\n\t\t\t\t\t\t\t`INSERT INTO sessions(started_at, ended_at, cwd, project, user, tool_version, metadata_json)\n\t\t\t\t\t\t\t VALUES (?, ?, ?, ?, ?, ?, ?)`,\n\t\t\t\t\t\t)\n\t\t\t\t\t\t.run(now, now, cwd, project, user, \"mcp-ts\", toJson({ mcp: true }));\n\t\t\t\t\tconst sessionId = Number(sessionInfo.lastInsertRowid);\n\n\t\t\t\t\tconst memId = store.remember(\n\t\t\t\t\t\tsessionId,\n\t\t\t\t\t\targs.kind,\n\t\t\t\t\t\targs.title,\n\t\t\t\t\t\targs.body,\n\t\t\t\t\t\targs.confidence,\n\t\t\t\t\t);\n\n\t\t\t\t\t// End the session\n\t\t\t\t\tstore.db\n\t\t\t\t\t\t.prepare(\"UPDATE sessions SET ended_at = ?, metadata_json = ? WHERE id = ?\")\n\t\t\t\t\t\t.run(nowIso(), toJson({ mcp: true }), sessionId);\n\n\t\t\t\t\treturn memId;\n\t\t\t\t})();\n\n\t\t\t\treturn jsonContent({ id: result });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// 11. memory_forget\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_forget\",\n\t\t\"Soft-delete a memory item. Use for incorrect or sensitive data.\",\n\t\t{\n\t\t\tmemory_id: z.number().int().describe(\"Memory ID to forget\"),\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tstore.forget(args.memory_id);\n\t\t\t\treturn jsonContent({ status: \"ok\" });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// 12. memory_schema\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_schema\",\n\t\t\"Return the memory schema — kinds, fields, and available filters.\",\n\t\t{},\n\t\tasync () => {\n\t\t\treturn jsonContent({\n\t\t\t\tkinds: Object.keys(MEMORY_KINDS),\n\t\t\t\tkind_descriptions: MEMORY_KINDS,\n\t\t\t\tfields: {\n\t\t\t\t\ttitle: \"short text\",\n\t\t\t\t\tbody: \"long text\",\n\t\t\t\t\tsubtitle: \"short text\",\n\t\t\t\t\tfacts: \"list<string>\",\n\t\t\t\t\tnarrative: \"long text\",\n\t\t\t\t\tconcepts: \"list<string>\",\n\t\t\t\t\tfiles_read: \"list<string>\",\n\t\t\t\t\tfiles_modified: \"list<string>\",\n\t\t\t\t\tprompt_number: \"int\",\n\t\t\t\t},\n\t\t\t\tfilters: [\n\t\t\t\t\t\"kind\",\n\t\t\t\t\t\"session_id\",\n\t\t\t\t\t\"since\",\n\t\t\t\t\t\"project\",\n\t\t\t\t\t\"include_actor_ids\",\n\t\t\t\t\t\"exclude_actor_ids\",\n\t\t\t\t\t\"include_visibility\",\n\t\t\t\t\t\"exclude_visibility\",\n\t\t\t\t\t\"include_workspace_ids\",\n\t\t\t\t\t\"exclude_workspace_ids\",\n\t\t\t\t\t\"include_workspace_kinds\",\n\t\t\t\t\t\"exclude_workspace_kinds\",\n\t\t\t\t],\n\t\t\t});\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// 13. memory_learn\n\t// -------------------------------------------------------------------\n\tserver.tool(\n\t\t\"memory_learn\",\n\t\t\"Learn how to use codemem memory tools. Call this first if unfamiliar.\",\n\t\t{},\n\t\tasync () => {\n\t\t\treturn jsonContent({\n\t\t\t\tintro: \"Use this tool when you're new to codemem or unsure when to recall/persist.\",\n\t\t\t\tclient_hint: \"If you are unfamiliar with codemem, call memory.learn first.\",\n\t\t\t\trecall: {\n\t\t\t\t\twhen: [\n\t\t\t\t\t\t\"Start of a task or when the user references prior work.\",\n\t\t\t\t\t\t\"When you need background context, decisions, or recent changes.\",\n\t\t\t\t\t],\n\t\t\t\t\thow: [\n\t\t\t\t\t\t\"Use memory.search_index to get compact candidates.\",\n\t\t\t\t\t\t\"Use memory.timeline to expand around a promising memory.\",\n\t\t\t\t\t\t\"Use memory.get_observations for full details only when needed.\",\n\t\t\t\t\t\t\"Use memory.pack for quick one-shot context blocks.\",\n\t\t\t\t\t\t\"Use the project filter unless the user requests cross-project context.\",\n\t\t\t\t\t],\n\t\t\t\t\texamples: [\n\t\t\t\t\t\t'memory.search_index(\"billing cache bug\", limit=5)',\n\t\t\t\t\t\t\"memory.timeline(memory_id=123)\",\n\t\t\t\t\t\t\"memory.get_observations([123, 456])\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tpersistence: {\n\t\t\t\t\twhen: [\n\t\t\t\t\t\t\"Milestones (task done, key decision, new facts learned).\",\n\t\t\t\t\t\t\"Notable regressions or follow-ups that should be remembered.\",\n\t\t\t\t\t],\n\t\t\t\t\thow: [\n\t\t\t\t\t\t\"Use memory.remember with kind decision/observation/note.\",\n\t\t\t\t\t\t\"Keep titles short and bodies high-signal.\",\n\t\t\t\t\t\t\"ALWAYS pass the project parameter if known.\",\n\t\t\t\t\t],\n\t\t\t\t\texamples: [\n\t\t\t\t\t\t'memory.remember(kind=\"decision\", title=\"Switch to async cache\", body=\"...why...\", project=\"my-service\")',\n\t\t\t\t\t\t'memory.remember(kind=\"observation\", title=\"Fixed retry loop\", body=\"...impact...\", project=\"my-service\")',\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tforget: {\n\t\t\t\t\twhen: [\n\t\t\t\t\t\t\"Accidental or sensitive data stored in memory items.\",\n\t\t\t\t\t\t\"Obsolete or incorrect items that should no longer surface.\",\n\t\t\t\t\t],\n\t\t\t\t\thow: [\n\t\t\t\t\t\t\"Call memory.forget(id) to mark the item inactive.\",\n\t\t\t\t\t\t\"Prefer forgetting over overwriting to preserve auditability.\",\n\t\t\t\t\t],\n\t\t\t\t\texamples: [\"memory.forget(123)\"],\n\t\t\t\t},\n\t\t\t\tprompt_hint:\n\t\t\t\t\t\"At task start: call memory.search_index; during work: memory.timeline + memory.get_observations; at milestones: memory.remember.\",\n\t\t\t\trecommended_system_prompt: [\n\t\t\t\t\t\"Trigger policy (1-liner): If the user references prior work or starts a task,\",\n\t\t\t\t\t\"immediately call memory.search_index; then use memory.timeline + memory.get_observations;\",\n\t\t\t\t\t\"at milestones, call memory.remember; use memory.forget for incorrect/sensitive items.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"System prompt:\",\n\t\t\t\t\t\"You have access to codemem MCP tools. If unfamiliar, call memory.learn first.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Recall:\",\n\t\t\t\t\t\"- Start of any task: call memory.search_index with a concise task query.\",\n\t\t\t\t\t'- If prior work is referenced (\"as before\", \"last time\", \"we already did…\", \"regression\"),',\n\t\t\t\t\t\"  call memory.search_index or memory.timeline.\",\n\t\t\t\t\t\"- Use memory.get_observations only after filtering IDs.\",\n\t\t\t\t\t\"- Prefer project-scoped queries unless the user asks for cross-project.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Persistence:\",\n\t\t\t\t\t\"- On milestones (task done, key decision, new facts learned), call memory.remember.\",\n\t\t\t\t\t\"- Use kind=decision for tradeoffs, kind=observation for outcomes, kind=note for small useful facts.\",\n\t\t\t\t\t\"- Keep titles short and bodies high-signal.\",\n\t\t\t\t\t\"- ALWAYS pass the project parameter if known.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Safety:\",\n\t\t\t\t\t\"- Use memory.forget(id) for incorrect or sensitive items.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Examples:\",\n\t\t\t\t\t'- memory.search_index(\"billing cache bug\")',\n\t\t\t\t\t\"- memory.timeline(memory_id=123)\",\n\t\t\t\t\t\"- memory.get_observations([123, 456])\",\n\t\t\t\t\t'- memory.remember(kind=\"decision\", title=\"Use async cache\", body=\"Chose async cache to avoid lock contention in X.\", project=\"my-service\")',\n\t\t\t\t\t'- memory.remember(kind=\"observation\", title=\"Fixed retry loop\", body=\"Root cause was Y; added guard in Z.\", project=\"my-service\")',\n\t\t\t\t\t\"- memory.forget(123)\",\n\t\t\t\t].join(\"\\n\"),\n\t\t\t});\n\t\t},\n\t);\n\n\t// -------------------------------------------------------------------\n\t// Connect and handle shutdown\n\t// -------------------------------------------------------------------\n\tconst transport = new StdioServerTransport();\n\n\tconst shutdown = () => {\n\t\ttry {\n\t\t\tstore.close();\n\t\t} catch {\n\t\t\t// Best effort — process is exiting\n\t\t}\n\t\tprocess.exit(0);\n\t};\n\n\tprocess.on(\"SIGINT\", shutdown);\n\tprocess.on(\"SIGTERM\", shutdown);\n\n\tawait server.connect(transport);\n}\n\nmain().catch((err) => {\n\tconsole.error(\"codemem MCP server failed to start:\", err);\n\tprocess.exit(1);\n});\n"],"mappings":"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"}

package/dist/project-scope.d.ts

@@ -0,0 +1,4 @@
+import { type MemoryFilters } from "@codemem/core";
+export declare function resolveDefaultProject(): string | null;
+export declare function buildFilters(raw: Record<string, unknown>, defaultProject?: string | null): MemoryFilters | undefined;
+//# sourceMappingURL=project-scope.d.ts.map

package/dist/project-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scope.d.ts","sourceRoot":"","sources":["../src/project-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,eAAe,CAAC;AAEnE,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAGrD;AAED,wBAAgB,YAAY,CAC3B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,cAAc,gBAA0B,GACtC,aAAa,GAAG,SAAS,CAuC3B"}

package/package.json

@@ -1 +1,44 @@
-{"name":"@codemem/mcp","version":"0.0.0","description":"codemem MCP server"}
+{
+  "name": "@codemem/mcp",
+  "version": "0.20.0-alpha.3",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "codemem-mcp-ts": "./dist/index.js"
+  },
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^4.3.6",
+    "@codemem/core": "^0.20.0-alpha.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.8.2",
+    "vite": "^8.0.0",
+    "vitest": "^3.1.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kunickiaj/codemem.git",
+    "directory": "packages/mcp-server"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "build": "pnpm exec vite build --ssr src/index.ts --outDir dist && pnpm exec tsc --build --force",
+    "typecheck": "pnpm exec tsc --noEmit"
+  }
+}