codemem 0.20.4 → 0.20.5-alpha.1

package/.opencode/lib/compat.js

@@ -1,5 +1,5 @@
 export const parseSemver = (value) => {
-  const match = String(value || "").trim().match(/^(\d+)\.(\d+)\.(\d+)$/);
+  const match = String(value || "").trim().match(/^(\d+)\.(\d+)\.(\d+)(?:-.*)?$/);
   if (!match) return null;
   return [Number(match[1]), Number(match[2]), Number(match[3])];
 };

package/.opencode/plugins/codemem.js

@@ -15,7 +15,7 @@ import {
 
 const TRUTHY_VALUES = ["1", "true", "yes"];
 const DISABLED_VALUES = ["0", "false", "off"];
-const PINNED_BACKEND_VERSION = "0.20.4";
+const PINNED_BACKEND_VERSION = "0.20.5-alpha.1";
 
 const normalizeEnvValue = (value) => (value || "").toLowerCase();
 const envHasValue = (value, truthyValues) =>

package/dist/commands/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAEN,KAAK,uBAAuB,EAG5B,MAAM,uBAAuB,CAAC;AAQ/B,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKhE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASjD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ9D;AAED,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,WAAW,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,GAAG,IAAI,CAGf;AA0KD,wBAAgB,yBAAyB,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,uBAAuB,EACnC,QAAQ,GAAE,MAAM,EAAqB,GACnC,MAAM,EAAE,CAgBV;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUpF;AA0OD,eAAO,MAAM,YAAY,SAuBtB,CAAC"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAEN,KAAK,uBAAuB,EAG5B,MAAM,uBAAuB,CAAC;AAQ/B,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKhE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASjD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ9D;AAED,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,WAAW,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,GAAG,IAAI,CAGf;AAmLD,wBAAgB,yBAAyB,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,uBAAuB,EACnC,QAAQ,GAAE,MAAM,EAAqB,GACnC,MAAM,EAAE,CAgBV;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUpF;AA+OD,eAAO,MAAM,YAAY,SAuBtB,CAAC"}

package/dist/commands/setup.d.ts

@@ -4,9 +4,9 @@
  * Replaces Python's install_plugin_cmd + install_mcp_cmd.
  *
  * What it does:
- * 1. Copies the plugin file to ~/.config/opencode/plugin/codemem.js
- * 2. Adds/updates the MCP entry in ~/.config/opencode/opencode.json
- * 3. Copies the compat lib to ~/.config/opencode/lib/compat.js
+ * 1. Adds "codemem" to the plugin array in ~/.config/opencode/opencode.jsonc
+ * 2. Adds/updates the MCP entry in ~/.config/opencode/opencode.jsonc
+ * 3. For Claude Code: installs MCP config and guides marketplace plugin install
  *
  * Designed to be safe to run repeatedly (idempotent unless --force).
  */

package/dist/commands/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmKpC,eAAO,MAAM,YAAY,SA6BtB,CAAC"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyQpC,eAAO,MAAM,YAAY,SA6BtB,CAAC"}

package/dist/index.js

@@ -2,7 +2,7 @@
 import { DEFAULT_COORDINATOR_DB_PATH, MemoryStore, ObserverClient, RawEventSweeper, VERSION, backfillTagsText, backfillVectors, buildRawEventEnvelopeFromHook, connect, coordinatorCreateInviteAction, coordinatorImportInviteAction, coordinatorListJoinRequestsAction, coordinatorReviewJoinRequestAction, createCoordinatorApp, deactivateLowSignalMemories, deactivateLowSignalObservations, ensureDeviceIdentity, exportMemories, fingerprintPublicKey, getRawEventStatus, importMemories, initDatabase, isEmbeddingDisabled, loadPublicKey, loadSqliteVec, rawEventsGate, readCodememConfigFile, readCoordinatorSyncConfig, readImportPayload, resolveDbPath, resolveProject, retryRawEventFailures, runSyncDaemon, runSyncPass, schema, setPeerProjectFilter, stripJsonComments, stripPrivateObj, stripTrailingCommas, syncPassPreflight, updatePeerAddresses, vacuumDatabase, writeCodememConfigFile } from "@codemem/core";
 import { Command } from "commander";
 import omelette from "omelette";
-import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { styleText } from "node:util";
 import * as p from "@clack/prompts";
 import { homedir, networkInterfaces } from "node:os";
@@ -1020,6 +1020,14 @@ async function waitForProcessExit(pid, timeoutMs = 5e3) {
 		await new Promise((resolve) => setTimeout(resolve, 100));
 	}
 }
+async function waitForPortRelease(host, port, timeoutMs = 1e4) {
+	const deadline = Date.now() + timeoutMs;
+	while (Date.now() < deadline) {
+		if (!await isPortOpen(host, port)) return true;
+		await new Promise((resolve) => setTimeout(resolve, 200));
+	}
+	return false;
+}
 async function stopExistingViewer(dbPath, target) {
 	const pidPath = pidFilePath(dbPath);
 	const record = readViewerPidRecord(dbPath);
@@ -1250,6 +1258,7 @@ async function runServeInvocation(invocation) {
 				p.outro("done");
 				return;
 			}
+			if (!await waitForPortRelease(invocation.host, invocation.port)) p.log.warn(`Port ${invocation.port} still in use after stop — restart may fail`);
 		} else if (invocation.mode === "stop") {
 			p.intro("codemem viewer");
 			p.outro("No background viewer found");
@@ -1313,9 +1322,9 @@ function writeJsonConfig(path, data) {
 * Replaces Python's install_plugin_cmd + install_mcp_cmd.
 *
 * What it does:
-* 1. Copies the plugin file to ~/.config/opencode/plugin/codemem.js
-* 2. Adds/updates the MCP entry in ~/.config/opencode/opencode.json
-* 3. Copies the compat lib to ~/.config/opencode/lib/compat.js
+* 1. Adds "codemem" to the plugin array in ~/.config/opencode/opencode.jsonc
+* 2. Adds/updates the MCP entry in ~/.config/opencode/opencode.jsonc
+* 3. For Claude Code: installs MCP config and guides marketplace plugin install
 *
 * Designed to be safe to run repeatedly (idempotent unless --force).
 */
@@ -1325,57 +1334,93 @@ function opencodeConfigDir() {
 function claudeConfigDir() {
 	return join(homedir(), ".claude");
 }
-/**
-* Find the plugin source file — walk up from this module's location
-* to find the .opencode/plugins/codemem.js in the package tree.
-*/
-function findPluginSource() {
-	let dir = dirname(import.meta.url.replace("file://", ""));
-	for (let i = 0; i < 6; i++) {
-		const candidate = join(dir, ".opencode", "plugins", "codemem.js");
-		if (existsSync(candidate)) return candidate;
-		const nmCandidate = join(dir, "node_modules", "codemem", ".opencode", "plugins", "codemem.js");
-		if (existsSync(nmCandidate)) return nmCandidate;
-		const parent = dirname(dir);
-		if (parent === dir) break;
-		dir = parent;
+/** The npm package name used in the OpenCode plugin array. */
+var OPENCODE_PLUGIN_SPEC = "codemem";
+/** Remove legacy copied plugin JS file from ~/.config/opencode/plugins/codemem.js */
+function migrateLegacyOpencodePlugin() {
+	const legacyPlugin = join(opencodeConfigDir(), "plugins", "codemem.js");
+	const legacyCompat = join(opencodeConfigDir(), "lib", "compat.js");
+	if (existsSync(legacyPlugin)) try {
+		rmSync(legacyPlugin);
+		p.log.step("Removed legacy copied plugin: ~/.config/opencode/plugins/codemem.js");
+	} catch {
+		p.log.warn("Could not remove legacy plugin file — remove manually if needed");
 	}
-	return null;
+	if (existsSync(legacyCompat)) try {
+		rmSync(legacyCompat);
+		p.log.step("Removed legacy compat lib: ~/.config/opencode/lib/compat.js");
+	} catch {}
+}
+/** Detect and upgrade legacy uvx/uv-based MCP entries in OpenCode config. */
+function migrateLegacyOpencodeMcp(config) {
+	const mcpConfig = config.mcp;
+	if (!mcpConfig || typeof mcpConfig !== "object") return false;
+	const entry = mcpConfig.codemem;
+	if (!entry || typeof entry !== "object") return false;
+	const command = entry.command;
+	if (Array.isArray(command) && command.some((arg) => typeof arg === "string" && (arg === "uvx" || arg === "uv")) || typeof command === "string" && (command === "uvx" || command === "uv")) {
+		p.log.step("Upgrading legacy uvx MCP entry to npx");
+		mcpConfig.codemem = {
+			type: "local",
+			command: [
+				"npx",
+				"codemem",
+				"mcp"
+			],
+			enabled: true
+		};
+		return true;
+	}
+	return false;
 }
-function findCompatSource() {
-	let dir = dirname(import.meta.url.replace("file://", ""));
-	for (let i = 0; i < 6; i++) {
-		const candidate = join(dir, ".opencode", "lib", "compat.js");
-		if (existsSync(candidate)) return candidate;
-		const nmCandidate = join(dir, "node_modules", "codemem", ".opencode", "lib", "compat.js");
-		if (existsSync(nmCandidate)) return nmCandidate;
-		const legacyCandidate = join(dir, "node_modules", "@kunickiaj", "codemem", ".opencode", "lib", "compat.js");
-		if (existsSync(legacyCandidate)) return legacyCandidate;
-		const parent = dirname(dir);
-		if (parent === dir) break;
-		dir = parent;
+/** Detect and upgrade legacy uvx-based MCP entries in Claude settings. */
+function migrateLegacyClaudeMcp(settings) {
+	const mcpServers = settings.mcpServers;
+	if (!mcpServers || typeof mcpServers !== "object") return false;
+	const entry = mcpServers.codemem;
+	if (!entry || typeof entry !== "object") return false;
+	const command = entry.command;
+	const args = entry.args;
+	if (typeof command === "string" && (command === "uvx" || command === "uv") || Array.isArray(args) && args.some((arg) => typeof arg === "string" && (arg.startsWith("codemem==") || arg === "uvx"))) {
+		p.log.step("Upgrading legacy uvx Claude MCP entry to npx");
+		mcpServers.codemem = {
+			command: "npx",
+			args: [
+				"-y",
+				"codemem",
+				"mcp"
+			]
+		};
+		return true;
 	}
-	return null;
+	return false;
 }
 function installPlugin(force) {
-	const source = findPluginSource();
-	if (!source) {
-		p.log.error("Plugin file not found in package tree");
+	migrateLegacyOpencodePlugin();
+	const configPath = resolveOpencodeConfigPath(opencodeConfigDir());
+	let config;
+	try {
+		config = loadJsoncConfig(configPath);
+	} catch (err) {
+		p.log.error(`Failed to parse ${configPath}: ${err instanceof Error ? err.message : String(err)}`);
 		return false;
 	}
-	const destDir = join(opencodeConfigDir(), "plugins");
-	const dest = join(destDir, "codemem.js");
-	if (existsSync(dest) && !force) p.log.info(`Plugin already installed at ${dest}`);
-	else {
-		mkdirSync(destDir, { recursive: true });
-		copyFileSync(source, dest);
-		p.log.success(`Plugin installed: ${dest}`);
+	let plugins = config.plugin;
+	if (!Array.isArray(plugins)) plugins = [];
+	const hasCodemem = plugins.some((entry) => typeof entry === "string" && (entry === OPENCODE_PLUGIN_SPEC || entry.startsWith(`${OPENCODE_PLUGIN_SPEC}@`)));
+	if (hasCodemem && !force) {
+		p.log.info(`Plugin "${OPENCODE_PLUGIN_SPEC}" already in plugin array`);
+		return true;
 	}
-	const compatSource = findCompatSource();
-	if (compatSource) {
-		const compatDir = join(opencodeConfigDir(), "lib");
-		mkdirSync(compatDir, { recursive: true });
-		copyFileSync(compatSource, join(compatDir, "compat.js"));
+	if (hasCodemem && force) plugins = plugins.filter((entry) => typeof entry !== "string" || entry !== OPENCODE_PLUGIN_SPEC && !entry.startsWith(`${OPENCODE_PLUGIN_SPEC}@`));
+	plugins.push(OPENCODE_PLUGIN_SPEC);
+	config.plugin = plugins;
+	try {
+		writeJsonConfig(configPath, config);
+		p.log.success(`Plugin "${OPENCODE_PLUGIN_SPEC}" added to ${configPath}`);
+	} catch (err) {
+		p.log.error(`Failed to write ${configPath}: ${err instanceof Error ? err.message : String(err)}`);
+		return false;
 	}
 	return true;
 }
@@ -1390,20 +1435,23 @@ function installMcp(force) {
 	}
 	let mcpConfig = config.mcp;
 	if (mcpConfig == null || typeof mcpConfig !== "object" || Array.isArray(mcpConfig)) mcpConfig = {};
-	if ("codemem" in mcpConfig && !force) {
+	const migrated = migrateLegacyOpencodeMcp(config);
+	if ("codemem" in mcpConfig && !force && !migrated) {
 		p.log.info(`MCP entry already exists in ${configPath}`);
 		return true;
 	}
-	mcpConfig.codemem = {
-		type: "local",
-		command: [
-			"npx",
-			"codemem",
-			"mcp"
-		],
-		enabled: true
-	};
-	config.mcp = mcpConfig;
+	if (!migrated) {
+		mcpConfig.codemem = {
+			type: "local",
+			command: [
+				"npx",
+				"codemem",
+				"mcp"
+			],
+			enabled: true
+		};
+		config.mcp = mcpConfig;
+	}
 	try {
 		writeJsonConfig(configPath, config);
 		p.log.success(`MCP entry installed: ${configPath}`);
@@ -1413,6 +1461,12 @@ function installMcp(force) {
 	}
 	return true;
 }
+function isClaudeHooksPluginInstalled() {
+	const pluginDir = join(claudeConfigDir(), "plugins", "codemem");
+	if (existsSync(pluginDir)) return true;
+	if (existsSync(join(pluginDir, "hooks", "hooks.json"))) return true;
+	return false;
+}
 function installClaudeMcp(force) {
 	const settingsPath = join(claudeConfigDir(), "settings.json");
 	let settings;
@@ -1423,22 +1477,36 @@ function installClaudeMcp(force) {
 	}
 	let mcpServers = settings.mcpServers;
 	if (mcpServers == null || typeof mcpServers !== "object" || Array.isArray(mcpServers)) mcpServers = {};
-	if ("codemem" in mcpServers && !force) {
-		p.log.info(`Claude MCP entry already exists in ${settingsPath}`);
-		return true;
-	}
-	mcpServers.codemem = {
-		command: "npx",
-		args: ["codemem", "mcp"]
-	};
-	settings.mcpServers = mcpServers;
-	try {
-		writeJsonConfig(settingsPath, settings);
-		p.log.success(`Claude MCP entry installed: ${settingsPath}`);
-	} catch (err) {
-		p.log.error(`Failed to write ${settingsPath}: ${err instanceof Error ? err.message : String(err)}`);
-		return false;
+	const migrated = migrateLegacyClaudeMcp(settings);
+	if ("codemem" in mcpServers && !force && !migrated) p.log.info(`Claude MCP entry already exists in ${settingsPath}`);
+	else {
+		if (!migrated) {
+			mcpServers.codemem = {
+				command: "npx",
+				args: [
+					"-y",
+					"codemem",
+					"mcp"
+				]
+			};
+			settings.mcpServers = mcpServers;
+		}
+		try {
+			writeJsonConfig(settingsPath, settings);
+			p.log.success(`Claude MCP entry installed: ${settingsPath}`);
+		} catch (err) {
+			p.log.error(`Failed to write ${settingsPath}: ${err instanceof Error ? err.message : String(err)}`);
+			return false;
+		}
 	}
+	if (!isClaudeHooksPluginInstalled() || force) {
+		p.log.info("To install the Claude Code hooks plugin, run in Claude Code:");
+		p.log.info("  /plugin marketplace add kunickiaj/codemem");
+		p.log.info("  /plugin install codemem");
+		p.log.info("");
+		p.log.info("To update an existing install:");
+		p.log.info("  /plugin marketplace update codemem-marketplace");
+	} else p.log.info("Claude Code hooks plugin appears to be installed");
 	return true;
 }
 var setupCommand = new Command("setup").configureHelp(helpStyle).description("Install codemem plugin + MCP config for OpenCode and Claude Code").option("--force", "overwrite existing installations").option("--opencode-only", "only install for OpenCode").option("--claude-only", "only install for Claude Code").action((opts) => {