@memorax/memorax-code 0.1.10 → 0.1.11

package/docs/configuration.md

@@ -209,8 +209,11 @@ native plugin layout:
 └── skills/memorax-code/
 ```
 
-`CODEBUDDY_HOME` or `WORKBUDDY_HOME` overrides the default root. Windows uses
-`%USERPROFILE%\.codebuddy`; other platforms use `~/.workbuddy`. The Skill is
+`CODEBUDDY_HOME` or `WORKBUDDY_HOME` overrides the default root. Windows prefers
+`%USERPROFILE%\.workbuddy` and falls back to an existing `%USERPROFILE%\.codebuddy`
+for legacy CodeBuddy installations. When both homes exist, setup removes only the
+legacy MemoraX-managed plugin state from `.codebuddy`; other platforms use
+`~/.workbuddy`. The Skill is
 materialized from the canonical MemoraX Code Skill and is owned by the managed
 marketplace plugin; user files outside that plugin are not modified.
 

package/docs/troubleshooting.md

@@ -268,8 +268,11 @@ memorax-code start --clients codebuddy
 memorax-code-codebuddy status --json
 ```
 
-On Windows, the managed plugin defaults to `%USERPROFILE%\.codebuddy`, while
-`CODEBUDDY_HOME` or `WORKBUDDY_HOME` remains an explicit override. A
+On Windows, the managed plugin prefers `%USERPROFILE%\.workbuddy` and falls back
+to an existing `%USERPROFILE%\.codebuddy` for legacy CodeBuddy installations,
+while `CODEBUDDY_HOME` or `WORKBUDDY_HOME` remains an explicit override. If both
+homes exist, setup removes only the MemoraX-managed plugin registration,
+marketplace, and cache from `.codebuddy`; unrelated data remains untouched. A
 `codebuddyHooks.status` value of `unverified` means the files are configured but
 the current plugin version has not yet produced a real Hook event. Restart or
 refresh WorkBuddy, submit one prompt, and check status again. `observed` means

package/lib/memorax-code-backend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/backend",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "private": true,
   "type": "module",
   "description": "Local memory integration, lifecycle, trace, and diagnostics for MemoraX Code.",

package/lib/memorax-code-claude-adapter/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorax-code-claude-adapter",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "Memory skill and local hooks for MemoraX Code in Claude Code.",
   "author": {
     "name": "MemoraX Code Maintainers"

package/lib/memorax-code-claude-adapter/hooks/runtime-shell.json

@@ -1,5 +1,5 @@
 {
   "version": 1,
-  "shellVersion": "0.1.10",
+  "shellVersion": "0.1.11",
   "runtimeAbi": 1
 }

package/lib/memorax-code-claude-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/claude-adapter",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "private": true,
   "type": "module",
   "description": "Claude Code Hook adapter for MemoraX Code memory services.",

package/lib/memorax-code-claude-marketplace/plugins/memorax-code-claude-adapter/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorax-code-claude-adapter",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "Memory skill and local hooks for MemoraX Code in Claude Code.",
   "author": {
     "name": "MemoraX Code Maintainers"

package/lib/memorax-code-claude-marketplace/plugins/memorax-code-claude-adapter/hooks/runtime-shell.json

@@ -1,5 +1,5 @@
 {
   "version": 1,
-  "shellVersion": "0.1.10",
+  "shellVersion": "0.1.11",
   "runtimeAbi": 1
 }

package/lib/memorax-code-claude-marketplace/plugins/memorax-code-claude-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/claude-adapter",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "private": true,
   "type": "module",
   "description": "Claude Code Hook adapter for MemoraX Code memory services.",

package/lib/memorax-code-codebuddy-adapter/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorax-code-codebuddy-adapter",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "MemoraX Code memory integration for CodeBuddy and WorkBuddy.",
   "hooks": "./hooks/hooks.json",
   "skills": ["./skills/memorax-code"]

package/lib/memorax-code-codebuddy-adapter/hooks/runtime-hook.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { createHash } from "node:crypto";
+import { existsSync } from "node:fs";
 import { appendFile, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
@@ -40,7 +41,7 @@ const codeBuddyHome = commonStringValue(process.env.CODEBUDDY_HOME)
   ?? commonStringValue(packageMetadata.codeBuddyHome)
   ?? commonStringValue(input?.codebuddy_home)
   ?? commonStringValue(input?.codeBuddyHome)
-  ?? join(homedir(), process.platform === "win32" ? ".codebuddy" : ".workbuddy");
+  ?? defaultCodeBuddyHome();
 try {
   await writeCodeBuddyRuntimeObservation({ memoraxCodeHome: home, codeBuddyHome, pluginRoot });
 } catch (error) {
@@ -239,6 +240,15 @@ async function bindMemoryCliTraceSession(sessionId) {
 function shellSingleQuote(value) { return `'${value.replaceAll("'", "'\"'\"'")}'`; }
 function stringValue(value) { return typeof value === "string" && value.trim() ? value.trim() : undefined; }
 
+function defaultCodeBuddyHome() {
+  const workBuddyHome = join(homedir(), ".workbuddy");
+  if (process.platform !== "win32") return workBuddyHome;
+  const legacyCodeBuddyHome = join(homedir(), ".codebuddy");
+  return existsSync(workBuddyHome) || !existsSync(legacyCodeBuddyHome)
+    ? workBuddyHome
+    : legacyCodeBuddyHome;
+}
+
 function provisionalTurnId(sessionId, boundary, prompt) {
   return `${sessionId}:${boundary}:${createHash("sha256").update(prompt.trim()).digest("hex")}`;
 }

package/lib/memorax-code-codebuddy-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/codebuddy-adapter",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "private": true,
   "type": "module",
   "description": "CodeBuddy and WorkBuddy Hook adapter for MemoraX Code memory services.",

package/lib/memorax-code-codebuddy-adapter/src/config.mjs

@@ -1,7 +1,7 @@
-import { readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { chmod, cp, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import { dirname, join, relative, sep, win32 } from "node:path";
+import { basename, dirname, join, relative, sep, win32 } from "node:path";
 import { fileURLToPath } from "node:url";
 import { resolveHookCodeBuddyCommand } from "../../memorax-code-adapter-common/src/clients/codebuddy-command.mjs";
 import {
@@ -19,10 +19,20 @@ const PLUGIN_NAME = "memorax-code-codebuddy-adapter";
 const MARKETPLACE_NAME = "memorax-code-local";
 const PLUGIN_ID = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
 
-export function defaultCodeBuddyHome(env = process.env, homeDir = homedir(), platform = process.platform) {
-  return env.CODEBUDDY_HOME?.trim()
-    || env.WORKBUDDY_HOME?.trim()
-    || (platform === "win32" ? win32.join(homeDir, ".codebuddy") : join(homeDir, ".workbuddy"));
+export function defaultCodeBuddyHome(
+  env = process.env,
+  homeDir = homedir(),
+  platform = process.platform,
+  pathExists = existsSync,
+) {
+  const configured = env.CODEBUDDY_HOME?.trim() || env.WORKBUDDY_HOME?.trim();
+  if (configured) return configured;
+  if (platform !== "win32") return join(homeDir, ".workbuddy");
+  const workBuddyHome = win32.join(homeDir, ".workbuddy");
+  const legacyCodeBuddyHome = win32.join(homeDir, ".codebuddy");
+  return pathExists(workBuddyHome) || !pathExists(legacyCodeBuddyHome)
+    ? workBuddyHome
+    : legacyCodeBuddyHome;
 }
 // CodeBuddy stores installed plugin caches under the marketplace namespace.
 export function codeBuddyInstallPath(home = defaultCodeBuddyHome()) { return join(home, "plugins", "cache", MARKETPLACE_NAME, PLUGIN_NAME, VERSION); }
@@ -61,20 +71,21 @@ export async function enableCodeBuddyAdapter(options = {}) {
     settings.enabledPlugins[PLUGIN_ID] = true;
   });
   await updateLegacyRegistry(home, { installPath, enabled: true });
+  await removeLegacyManagedInstallation(home, platform);
   return { ok: true, action: "enable", runtime: "codebuddy", integration: "hooks", installed: true, enabled: true, codeBuddyHome: home, installPath, marketplace: MARKETPLACE_NAME, pluginId: PLUGIN_ID, marketplacePath: localPluginPath, codebuddyHooks: { ok: true, configured: true, runtimeObserved: false, status: "unverified" }, codebuddySkills: { ok: true, status: "installed", managed: true, memoraxCode: true, path: join(localPluginPath, "skills", "memorax-code", "SKILL.md") } };
 }
 
 export async function disableCodeBuddyAdapter(options = {}) {
   const home = options.codeBuddyHome ?? defaultCodeBuddyHome();
+  const platform = options.platform ?? process.platform;
   const registryPath = installedRegistryPath(home);
-  const installed = await pathExists(marketplacePluginPath(home)) || await pathExists(codeBuddyInstallPath(home));
-  if (!installed) return { ok: true, action: "disable", runtime: "codebuddy", installed: false, enabled: false, codeBuddyHome: home, statePath: registryPath, marketplace: MARKETPLACE_NAME, pluginId: PLUGIN_ID };
-  await updateSettings(home, (settings) => {
-    settings.enabledPlugins = recordValue(settings.enabledPlugins);
-    settings.enabledPlugins[PLUGIN_ID] = false;
-  });
-  await updateLegacyRegistry(home, { installPath: codeBuddyInstallPath(home), enabled: false });
-  return { ok: true, action: "disable", runtime: "codebuddy", installed: true, enabled: false, codeBuddyHome: home, statePath: registryPath, marketplace: MARKETPLACE_NAME, pluginId: PLUGIN_ID };
+  const legacyHome = legacyCodeBuddyHome(home, platform);
+  const installed = await managedCodeBuddyInstallationExists(home);
+  const legacyInstalled = legacyHome ? await managedCodeBuddyInstallationExists(legacyHome) : false;
+  if (!installed && !legacyInstalled) return { ok: true, action: "disable", runtime: "codebuddy", installed: false, enabled: false, codeBuddyHome: home, statePath: registryPath, marketplace: MARKETPLACE_NAME, pluginId: PLUGIN_ID };
+  if (installed) await disableManagedCodeBuddyInstallation(home);
+  if (legacyInstalled) await disableManagedCodeBuddyInstallation(legacyHome);
+  return { ok: true, action: "disable", runtime: "codebuddy", installed: true, enabled: false, codeBuddyHome: home, statePath: registryPath, marketplace: MARKETPLACE_NAME, pluginId: PLUGIN_ID, legacyCodeBuddyHome: legacyInstalled ? legacyHome : undefined, legacyManaged: legacyInstalled };
 }
 
 export async function readCodeBuddyAdapterStatus(options = {}) {
@@ -94,28 +105,73 @@ export async function readCodeBuddyAdapterStatus(options = {}) {
   const skillInstalled = await pathExists(skillPath);
   const enabled = settings.enabledPlugins?.[PLUGIN_ID] === true;
   const marketplaceReady = Boolean(known[MARKETPLACE_NAME]);
+  const legacyHome = legacyCodeBuddyHome(home, platform);
+  const legacyManaged = legacyHome ? await managedCodeBuddyInstallationExists(legacyHome) : false;
   const hookConfigured = installedRoots.length > 0
     && (await Promise.all(installedRoots.map((root) => codeBuddyHookManifestConfigured(root, platform)))).every(Boolean);
   const observation = await readCodeBuddyRuntimeObservation(memoraxCodeHome);
   const runtimeObserved = hookConfigured && observationMatches(observation, home, platform);
-  return { ok: true, action: "status", runtime: "codebuddy", integration: "hooks", installed, enabled, managed: installed && marketplaceReady, codeBuddyHome: home, installPath, marketplace: MARKETPLACE_NAME, pluginId: PLUGIN_ID, marketplaceReady, codebuddyHooks: { ok: hookConfigured, configured: hookConfigured, runtimeObserved, status: hookConfigured ? (runtimeObserved ? "observed" : "unverified") : "invalid", observationPath: codeBuddyRuntimeObservationPath(memoraxCodeHome) }, codebuddySkills: { ok: skillInstalled, status: skillInstalled ? "installed" : "missing", managed: skillInstalled, memoraxCode: skillInstalled, path: skillPath } };
+  return { ok: true, action: "status", runtime: "codebuddy", integration: "hooks", installed, enabled, managed: installed && marketplaceReady, codeBuddyHome: home, installPath, marketplace: MARKETPLACE_NAME, pluginId: PLUGIN_ID, marketplaceReady, legacyCodeBuddyHome: legacyManaged ? legacyHome : undefined, legacyManaged, codebuddyHooks: { ok: hookConfigured, configured: hookConfigured, runtimeObserved, status: hookConfigured ? (runtimeObserved ? "observed" : "unverified") : "invalid", observationPath: codeBuddyRuntimeObservationPath(memoraxCodeHome) }, codebuddySkills: { ok: skillInstalled, status: skillInstalled ? "installed" : "missing", managed: skillInstalled, memoraxCode: skillInstalled, path: skillPath } };
 }
 
 export async function removeCodeBuddyPluginInstallation(options = {}) {
   const home = options.codeBuddyHome ?? defaultCodeBuddyHome();
-  const installed = await pathExists(marketplacePluginPath(home)) || await pathExists(codeBuddyInstallPath(home));
-  if (!installed) return { ok: true, action: "codebuddy-plugin-remove", runtime: "codebuddy", installed: false, enabled: false, removed: false, codeBuddyHome: home, marketplace: MARKETPLACE_NAME, pluginId: PLUGIN_ID };
-  const status = await disableCodeBuddyAdapter({ codeBuddyHome: home });
+  const platform = options.platform ?? process.platform;
+  const legacyHome = legacyCodeBuddyHome(home, platform);
+  const removed = await removeManagedCodeBuddyInstallation(home);
+  const legacyRemoved = legacyHome ? await removeManagedCodeBuddyInstallation(legacyHome) : false;
+  return { ok: true, action: "codebuddy-plugin-remove", runtime: "codebuddy", installed: false, enabled: false, removed: removed || legacyRemoved, codeBuddyHome: home, statePath: installedRegistryPath(home), marketplace: MARKETPLACE_NAME, pluginId: PLUGIN_ID };
+}
+
+async function disableManagedCodeBuddyInstallation(home) {
   await updateSettings(home, (settings) => {
+    settings.enabledPlugins = recordValue(settings.enabledPlugins);
+    settings.enabledPlugins[PLUGIN_ID] = false;
+  });
+  await updateLegacyRegistry(home, { installPath: codeBuddyInstallPath(home), enabled: false });
+}
+
+async function removeLegacyManagedInstallation(home, platform) {
+  const legacyHome = legacyCodeBuddyHome(home, platform);
+  return legacyHome ? await removeManagedCodeBuddyInstallation(legacyHome) : false;
+}
+
+async function removeManagedCodeBuddyInstallation(home) {
+  if (!await managedCodeBuddyInstallationExists(home)) return false;
+  await updateJsonRecordIfPresent(codeBuddySettingsPath(home), (settings) => {
     settings.enabledPlugins = recordValue(settings.enabledPlugins);
     delete settings.enabledPlugins[PLUGIN_ID];
   });
-  await updateKnownMarketplace(home, false);
-  await updateRegistry(home, (registry) => { delete registry[PLUGIN_ID]; });
-  await rm(codeBuddyInstallPath(home), { recursive: true, force: true });
-  await rm(legacyCodeBuddyInstallPath(home), { recursive: true, force: true });
+  await updateJsonRecordIfPresent(knownMarketplacesPath(home), (known) => {
+    delete known[MARKETPLACE_NAME];
+  });
+  await updateJsonRecordIfPresent(installedRegistryPath(home), (value) => {
+    value.version = 2;
+    value.plugins = recordValue(value.plugins);
+    delete value.plugins[PLUGIN_ID];
+  });
+  await rm(codeBuddyPluginCacheRoot(home), { recursive: true, force: true });
+  await rm(legacyCodeBuddyPluginCacheRoot(home), { recursive: true, force: true });
   await rm(marketplaceRoot(home), { recursive: true, force: true });
-  return { ...status, action: "codebuddy-plugin-remove", installed: false, enabled: false, removed: true };
+  return true;
+}
+
+async function managedCodeBuddyInstallationExists(home) {
+  if (await pathExists(marketplaceRoot(home))
+    || await pathExists(codeBuddyPluginCacheRoot(home))
+    || await pathExists(legacyCodeBuddyPluginCacheRoot(home))) return true;
+  const settings = await readJsonRecord(codeBuddySettingsPath(home));
+  const known = await readJsonRecord(knownMarketplacesPath(home));
+  const registry = await readJsonRecord(installedRegistryPath(home));
+  return Object.hasOwn(recordValue(settings.enabledPlugins), PLUGIN_ID)
+    || Object.hasOwn(known, MARKETPLACE_NAME)
+    || Object.hasOwn(recordValue(registry.plugins), PLUGIN_ID);
+}
+
+function legacyCodeBuddyHome(home, platform) {
+  return platform === "win32" && basename(home).toLowerCase() === ".workbuddy"
+    ? join(dirname(home), ".codebuddy")
+    : undefined;
 }
 
 async function readRegistry(home) {
@@ -196,6 +252,11 @@ async function updateJsonRecord(path, mutate) {
     await rm(lockPath, { force: true });
   }
 }
+
+async function updateJsonRecordIfPresent(path, mutate) {
+  if (await pathExists(path)) await updateJsonRecord(path, mutate);
+}
+
 async function readJsonRecord(path) {
   try {
     const value = JSON.parse(await readFile(path, "utf8"));
@@ -225,6 +286,8 @@ function readPluginVersion() {
   return manifest.version.trim();
 }
 function legacyCodeBuddyInstallPath(home) { return join(home, "plugins", "cache", PLUGIN_NAME, VERSION); }
+function codeBuddyPluginCacheRoot(home) { return dirname(codeBuddyInstallPath(home)); }
+function legacyCodeBuddyPluginCacheRoot(home) { return dirname(legacyCodeBuddyInstallPath(home)); }
 
 async function materializeCanonicalSkill(destination) {
   const packagedSkill = join(ROOT, "skills", "memorax-code");

package/lib/memorax-code-codex-adapter/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorax-code-codex-adapter",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "Codex adapter, memory skill, and local hooks for MemoraX Code.",
   "author": {
     "name": "MemoraX AI"

package/lib/memorax-code-codex-adapter/hooks/runtime-shell.json

@@ -1,5 +1,5 @@
 {
   "version": 1,
-  "shellVersion": "0.1.10",
+  "shellVersion": "0.1.11",
   "runtimeAbi": 1
 }

package/lib/memorax-code-codex-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/codex-adapter",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "private": true,
   "type": "module",
   "description": "Codex Hook and memory integration for MemoraX Code.",

package/lib/memorax-code-dsh-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/dsh-memorax-code",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "private": true,
   "type": "module",
   "description": "DeepSeek Harness native memory adapter for MemoraX Code.",

package/lib/memorax-code-opencode-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/opencode-adapter",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "private": true,
   "type": "module",
   "description": "OpenCode plugin adapter for MemoraX Code memory services.",

package/lib/resolve-codebuddy-command.mjs

@@ -1,3 +1,4 @@
+import { existsSync } from "node:fs";
 import { homedir } from "node:os";
 import { delimiter, join, win32 } from "node:path";
 import {
@@ -80,10 +81,20 @@ export function ensureCodeBuddyCommandEnv(options = {}) {
   return resolved;
 }
 
-export function defaultCodeBuddyHome(env = process.env, homeDir = homedir(), platform = process.platform) {
-  return nonEmpty(env.CODEBUDDY_HOME)
-    ?? nonEmpty(env.WORKBUDDY_HOME)
-    ?? (platform === "win32" ? win32.join(homeDir, ".codebuddy") : join(homeDir, ".workbuddy"));
+export function defaultCodeBuddyHome(
+  env = process.env,
+  homeDir = homedir(),
+  platform = process.platform,
+  pathExists = existsSync,
+) {
+  const configured = nonEmpty(env.CODEBUDDY_HOME) ?? nonEmpty(env.WORKBUDDY_HOME);
+  if (configured) return configured;
+  if (platform !== "win32") return join(homeDir, ".workbuddy");
+  const workBuddyHome = win32.join(homeDir, ".workbuddy");
+  const legacyCodeBuddyHome = win32.join(homeDir, ".codebuddy");
+  return pathExists(workBuddyHome) || !pathExists(legacyCodeBuddyHome)
+    ? workBuddyHome
+    : legacyCodeBuddyHome;
 }
 
 function defaultWindowsRoots(env, homeDir) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax/memorax-code",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "Persistent coding memory for Codex, Claude Code, CodeBuddy/WorkBuddy, DeepSeek Harness, and OpenCode.",
   "license": "MIT",
   "type": "module",