@memorax/memorax-code 0.1.11 → 0.1.12

package/lib/memorax-code-backend/dist/lifecycle/orchestrator.js

@@ -18,6 +18,7 @@ import { claudeAdapterLifecycle } from "../clients/claude/lifecycle.js";
 import { collectDshAdapterLifecycleStatus, withDshAdapterLifecycleLock, } from "../clients/dsh/lifecycle.js";
 import { openCodeAdapterLifecycle } from "../clients/opencode/lifecycle.js";
 import { codeBuddyAdapterLifecycle } from "../clients/codebuddy/lifecycle.js";
+import { traeAdapterLifecycle } from "../clients/trae/lifecycle.js";
 const PACKAGE_REPLACEMENT_ENV = "MEMORAX_CODE_PACKAGE_REPLACEMENT";
 const DSH_OPTIONAL_ENV = "MEMORAX_CODE_DSH_ADAPTER_OPTIONAL";
 const DSH_RECOVERY_ENV = "MEMORAX_CODE_DSH_ADAPTER_RECOVERY";
@@ -62,17 +63,22 @@ export async function collectMemoraxCodeStatus(backendUrl, backendToken, service
     const codebuddyAdapter = clients.codebuddy
         ? await codeBuddyAdapterLifecycle.status({ argv, serviceOptions, backendUrl })
         : undefined;
+    const traeAdapter = clients.trae
+        ? await traeAdapterLifecycle.status({ argv, serviceOptions, backendUrl })
+        : undefined;
     const codexReady = codexAdapter ? isAdapterReady(codexAdapter) : true;
     const claudeReady = claudeAdapter ? isAdapterReady(claudeAdapter) : true;
     const dshReady = dshAdapter ? isAdapterReady(dshAdapter) : true;
     const opencodeReady = opencodeAdapter ? isAdapterReady(opencodeAdapter) : true;
     const codebuddyReady = codebuddyAdapter ? isAdapterReady(codebuddyAdapter) : true;
+    const traeReady = traeAdapter ? isAdapterReady(traeAdapter) : true;
     const optionalDshUnavailable = isOptionalUnavailableDshAdapter(dshAdapter);
     return {
         ok: backend.ok
             && codexReady
             && opencodeReady
             && codebuddyReady
+            && traeReady
             && (isOptionalUnconfiguredClaudeAdapter(claudeAdapter, codexAdapter) || claudeReady)
             && (optionalDshUnavailable || dshReady),
         action: "status",
@@ -83,6 +89,7 @@ export async function collectMemoraxCodeStatus(backendUrl, backendToken, service
         ...(dshAdapter ? { dshAdapter } : {}),
         ...(opencodeAdapter ? { opencodeAdapter } : {}),
         ...(codebuddyAdapter ? { codebuddyAdapter } : {}),
+        ...(traeAdapter ? { traeAdapter } : {}),
     };
 }
 export async function startMemoraxCodeService(serviceOptions, argv, commitReadyState) {
@@ -203,11 +210,15 @@ async function executeMemoraxCodeStart(serviceOptions, argv, backendUrl, memorax
     const deselectedCodeBuddy = previousClients?.codebuddy && !clients.codebuddy
         ? await codeBuddyAdapterLifecycle.disable({ argv, serviceOptions })
         : undefined;
+    const deselectedTrae = previousClients?.trae && !clients.trae
+        ? await traeAdapterLifecycle.disable({ argv, serviceOptions })
+        : undefined;
     if (deselectedCodex?.ok === false
         || deselectedClaude?.ok === false
         || deselectedDsh?.ok === false
         || deselectedOpenCode?.ok === false
-        || deselectedCodeBuddy?.ok === false) {
+        || deselectedCodeBuddy?.ok === false
+        || deselectedTrae?.ok === false) {
         const recovery = await recoverPreparationFailure("adapter_disable_failed");
         return {
             ok: false,
@@ -220,6 +231,7 @@ async function executeMemoraxCodeStart(serviceOptions, argv, backendUrl, memorax
                 : {}),
             ...(deselectedOpenCode ? { opencodeAdapter: deselectedOpenCode } : {}),
             ...(deselectedCodeBuddy ? { codebuddyAdapter: deselectedCodeBuddy } : {}),
+            ...(deselectedTrae ? { traeAdapter: deselectedTrae } : {}),
         };
     }
     // The marker is a conservative cleanup scope, not a readiness signal. Persist
@@ -262,6 +274,9 @@ async function executeMemoraxCodeStart(serviceOptions, argv, backendUrl, memorax
     const codebuddyAdapter = clients.codebuddy
         ? await codeBuddyAdapterLifecycle.prepareEnable({ argv, serviceOptions, backendUrl })
         : undefined;
+    const traeAdapter = clients.trae
+        ? await traeAdapterLifecycle.prepareEnable({ argv, serviceOptions, backendUrl })
+        : undefined;
     if (opencodeAdapter?.ok === false) {
         const recovery = await recoverPreparationFailure("opencode_adapter_enable_failed");
         return {
@@ -273,6 +288,21 @@ async function executeMemoraxCodeStart(serviceOptions, argv, backendUrl, memorax
             ...(recovery.dshAdapter ? { dshAdapter: recovery.dshAdapter } : {}),
             opencodeAdapter,
             ...(codebuddyAdapter ? { codebuddyAdapter } : {}),
+            ...(traeAdapter ? { traeAdapter } : {}),
+        };
+    }
+    if (traeAdapter?.ok === false) {
+        const recovery = await recoverPreparationFailure("trae_adapter_enable_failed");
+        return {
+            ok: false,
+            action: "start",
+            backend: recovery.backend,
+            ...(codexAdapter ? { codexAdapter } : {}),
+            ...(claudeAdapter ? { claudeAdapter } : {}),
+            ...(recovery.dshAdapter ? { dshAdapter: recovery.dshAdapter } : {}),
+            ...(opencodeAdapter ? { opencodeAdapter } : {}),
+            ...(codebuddyAdapter ? { codebuddyAdapter } : {}),
+            traeAdapter,
         };
     }
     const preparedDshAdapter = markOptionalDshAdapter(quiescedDsh?.ok === false
@@ -291,6 +321,7 @@ async function executeMemoraxCodeStart(serviceOptions, argv, backendUrl, memorax
             dshAdapter: recovery.dshAdapter ?? preparedDshAdapter,
             ...(opencodeAdapter ? { opencodeAdapter } : {}),
             ...(codebuddyAdapter ? { codebuddyAdapter } : {}),
+            ...(traeAdapter ? { traeAdapter } : {}),
         };
     }
     const backend = await startBackendService(serviceOptions);
@@ -304,6 +335,9 @@ async function executeMemoraxCodeStart(serviceOptions, argv, backendUrl, memorax
         const disabledCodeBuddy = codebuddyAdapter
             ? await codeBuddyAdapterLifecycle.disable({ argv, serviceOptions })
             : undefined;
+        const disabledTrae = traeAdapter
+            ? await traeAdapterLifecycle.disable({ argv, serviceOptions })
+            : undefined;
         return {
             ok: false,
             action: "start",
@@ -313,6 +347,7 @@ async function executeMemoraxCodeStart(serviceOptions, argv, backendUrl, memorax
             ...(preparedDshAdapter ? { dshAdapter: preparedDshAdapter } : {}),
             ...(disabledOpenCode ? { opencodeAdapter: disabledOpenCode } : {}),
             ...(disabledCodeBuddy ? { codebuddyAdapter: disabledCodeBuddy } : {}),
+            ...(disabledTrae ? { traeAdapter: disabledTrae } : {}),
         };
     }
     const dshAdapter = markOptionalDshAdapter(preparedDshAdapter?.installed === true
@@ -330,6 +365,7 @@ async function executeMemoraxCodeStart(serviceOptions, argv, backendUrl, memorax
         ...(dshAdapter ? { dshAdapter } : {}),
         ...(opencodeAdapter ? { opencodeAdapter } : {}),
         ...(codebuddyAdapter ? { codebuddyAdapter } : {}),
+        ...(traeAdapter ? { traeAdapter } : {}),
     };
 }
 function expectedBackendUrl(serviceOptions) {
@@ -373,14 +409,16 @@ async function executeMemoraxCodeStop(serviceOptions, argv, context, dshLifecycl
             dsh: activeClients.dsh && !clients.dsh,
             opencode: activeClients.opencode && !clients.opencode,
             codebuddy: activeClients.codebuddy && !clients.codebuddy,
+            trae: activeClients.trae && !clients.trae,
         }
         : undefined;
     const hasRemainingClients = remaining?.codex === true
         || remaining?.claude === true
         || remaining?.dsh === true
         || remaining?.opencode === true
-        || remaining?.codebuddy === true;
-    const backendOnlyStop = !clients.codex && !clients.claude && !clients.dsh && !clients.opencode && !clients.codebuddy;
+        || remaining?.codebuddy === true
+        || remaining?.trae === true;
+    const backendOnlyStop = !clients.codex && !clients.claude && !clients.dsh && !clients.opencode && !clients.codebuddy && !clients.trae;
     const packageReplacement = isPackageReplacement();
     const needsBackendStop = packageReplacement || backendOnlyStop || !hasRemainingClients;
     const quiescedDsh = clients.dsh && dshLifecycle
@@ -432,11 +470,15 @@ async function executeMemoraxCodeStop(serviceOptions, argv, context, dshLifecycl
     const codebuddyAdapter = clients.codebuddy
         ? await codeBuddyAdapterLifecycle.disable({ argv, serviceOptions })
         : undefined;
+    const traeAdapter = clients.trae
+        ? await traeAdapterLifecycle.disable({ argv, serviceOptions })
+        : undefined;
     const adaptersOk = codexAdapter?.ok !== false
         && claudeAdapter?.ok !== false
         && dshAdapter?.ok !== false
         && opencodeAdapter?.ok !== false
-        && codebuddyAdapter?.ok !== false;
+        && codebuddyAdapter?.ok !== false
+        && traeAdapter?.ok !== false;
     const backend = stoppedBackend
         ?? (adaptersOk
             ? preservedBackendResult(serviceOptions, "active_clients_remaining")
@@ -446,7 +488,8 @@ async function executeMemoraxCodeStop(serviceOptions, argv, context, dshLifecycl
         && claudeAdapter?.ok !== false
         && dshAdapter?.ok !== false
         && opencodeAdapter?.ok !== false
-        && codebuddyAdapter?.ok !== false;
+        && codebuddyAdapter?.ok !== false
+        && traeAdapter?.ok !== false;
     return {
         report: {
             ok,
@@ -457,6 +500,7 @@ async function executeMemoraxCodeStop(serviceOptions, argv, context, dshLifecycl
             ...(dshAdapter ? { dshAdapter } : {}),
             ...(opencodeAdapter ? { opencodeAdapter } : {}),
             ...(codebuddyAdapter ? { codebuddyAdapter } : {}),
+            ...(traeAdapter ? { traeAdapter } : {}),
         },
         remainingClients: packageReplacement
             ? activeClients
@@ -568,11 +612,15 @@ async function executeMemoraxCodeUninstall(serviceOptions, argv, context, dshLif
     const codebuddyPlugin = clients.codebuddy
         ? await codeBuddyAdapterLifecycle.remove({ argv, serviceOptions })
         : undefined;
+    const traePlugin = clients.trae
+        ? await traeAdapterLifecycle.remove({ argv, serviceOptions })
+        : undefined;
     const pluginCleanupOk = codexPlugin?.ok !== false
         && claudePlugin?.ok !== false
         && dshPlugin?.ok !== false
         && opencodePlugin?.ok !== false
-        && codebuddyPlugin?.ok !== false;
+        && codebuddyPlugin?.ok !== false
+        && traePlugin?.ok !== false;
     const npmPackageRemoval = !pluginCleanupOk
         ? skippedNpmPackageRemoval("plugin_cleanup_failed")
         : canRemoveSharedPackage
@@ -597,12 +645,14 @@ async function executeMemoraxCodeUninstall(serviceOptions, argv, context, dshLif
         ...(dshAdapter ? { dshAdapter } : {}),
         ...(opencodeAdapter ? { opencodeAdapter } : {}),
         ...(codebuddyPlugin ? { codebuddyPlugin } : {}),
+        ...(traePlugin ? { traePlugin } : {}),
         npmPackageRemoval,
         removesPlugin: codexPlugin?.ok === true
             || claudePlugin?.ok === true
             || (dshPlugin?.ok === true && dshPlugin.skipped !== true)
             || opencodePlugin?.ok === true
-            || codebuddyPlugin?.ok === true,
+            || codebuddyPlugin?.ok === true
+            || traePlugin?.ok === true,
         removesUserState: false,
     };
 }
@@ -728,7 +778,8 @@ function includesManagedClients(selection, required) {
         && (!required.claude || selection.claude)
         && (!required.dsh || selection.dsh)
         && (!required.opencode || selection.opencode)
-        && (!required.codebuddy || selection.codebuddy === true);
+        && (!required.codebuddy || selection.codebuddy === true)
+        && (!required.trae || selection.trae === true);
 }
 function isPackageReplacement() {
     return truthyEnv(process.env[PACKAGE_REPLACEMENT_ENV]);
@@ -858,7 +909,9 @@ export function isAdapterReady(report) {
         && report.claudeSkills?.ok !== false
         && report.opencodeSkills?.ok !== false
         && report.codebuddyHooks?.ok !== false
-        && report.codebuddySkills?.ok !== false;
+        && report.codebuddySkills?.ok !== false
+        && report.traeHooks?.ok !== false
+        && report.traeSkills?.ok !== false;
 }
 export function isOptionalUnavailableDshAdapter(report) {
     return Boolean(report?.optional === true && !isAdapterReady(report));

package/lib/memorax-code-backend/dist/memory/hook-command.js

@@ -1,5 +1,6 @@
 import { isRecord } from "../shared/record.js";
 import { codeBuddyPromptDigest, parseCodeBuddyTurnId } from "../clients/codebuddy/turn-id.js";
+import { parseTraeTurnId, traePromptDigest } from "../clients/trae/turn-id.js";
 export const MEMORY_HOOK_COMMAND_VERSION = 1;
 export const INVALID_MEMORY_HOOK_COMMAND = "invalid memory Hook command";
 const BASE_COMMAND_KEYS = [
@@ -15,6 +16,7 @@ const TURN_START_KEYS = {
     opencode: new Set([...BASE_COMMAND_KEYS, "userMessageId", "prompt"]),
     dsh: new Set(["version", "client", "sessionId", "turn", "startSeq", "cwd", "prompt"]),
     codebuddy: new Set([...BASE_COMMAND_KEYS, "turnId", "prompt", "transcriptPath"]),
+    trae: new Set([...BASE_COMMAND_KEYS, "turnId", "prompt"]),
 };
 const WRITEBACK_KEYS = {
     codex: new Set([...BASE_COMMAND_KEYS, "turnId", "lastAssistantMessage", "transcriptPath"]),
@@ -42,6 +44,7 @@ const WRITEBACK_KEYS = {
         "events",
     ]),
     codebuddy: new Set([...BASE_COMMAND_KEYS, "turnId", "transcriptPath"]),
+    trae: new Set([...BASE_COMMAND_KEYS, "turnId", "prompt", "lastAssistantMessage"]),
 };
 const SKILL_REMINDER_KEYS = {
     codex: new Set([...BASE_COMMAND_KEYS, "turnId", "transcriptPath", "content", "triggers"]),
@@ -49,6 +52,7 @@ const SKILL_REMINDER_KEYS = {
     dsh: new Set(["version", "client", "sessionId", "turn", "cwd", "content", "triggers"]),
     opencode: new Set([...BASE_COMMAND_KEYS, "userMessageId", "content", "triggers"]),
     codebuddy: new Set([...BASE_COMMAND_KEYS, "turnId", "transcriptPath", "content", "triggers"]),
+    trae: new Set([...BASE_COMMAND_KEYS, "turnId", "content", "triggers"]),
 };
 export function parseTurnStartCommand(value) {
     if (!isRecord(value))
@@ -56,7 +60,9 @@ export function parseTurnStartCommand(value) {
     const base = parseCommandBase(value, TURN_START_KEYS);
     if (!base)
         return invalidCommand();
-    const prompt = requiredStringField(value, "prompt");
+    const prompt = base.client === "trae"
+        ? requiredContentField(value, "prompt")
+        : requiredStringField(value, "prompt");
     if (!prompt)
         return invalidCommand();
     if (base.client === "dsh") {
@@ -113,6 +119,12 @@ export function parseTurnStartCommand(value) {
             return invalidCommand();
         return { ok: true, command: { ...base, client: "codebuddy", turnId, prompt, transcriptPath } };
     }
+    if (base.client === "trae") {
+        const turnId = requiredStringField(value, "turnId");
+        if (!turnId || !validTraeTurnId(turnId, base.sessionId, prompt))
+            return invalidCommand();
+        return { ok: true, command: { ...base, client: "trae", turnId, prompt } };
+    }
     const promptId = requiredStringField(value, "promptId");
     const transcriptPath = requiredStringField(value, "transcriptPath");
     if (!promptId || !transcriptPath)
@@ -184,6 +196,15 @@ export function parseWritebackCommand(value) {
             return invalidCommand();
         return { ok: true, command: { ...base, client: "codebuddy", turnId, transcriptPath } };
     }
+    if (base.client === "trae") {
+        const turnId = requiredStringField(value, "turnId");
+        const prompt = requiredContentField(value, "prompt");
+        const lastAssistantMessage = requiredContentField(value, "lastAssistantMessage");
+        if (!turnId || !prompt || !lastAssistantMessage || !validTraeTurnId(turnId, base.sessionId, prompt)) {
+            return invalidCommand();
+        }
+        return { ok: true, command: { ...base, client: "trae", turnId, prompt, lastAssistantMessage } };
+    }
     const lastAssistantMessage = requiredStringField(value, "lastAssistantMessage");
     if (!lastAssistantMessage)
         return invalidCommand();
@@ -266,6 +287,12 @@ export function parseSkillReminderCommand(value) {
             return invalidCommand();
         return { ok: true, command: { ...base, client: "codebuddy", turnId, transcriptPath, content, triggers } };
     }
+    if (base.client === "trae") {
+        const turnId = requiredStringField(value, "turnId");
+        if (!turnId || !parseTraeTurnId({ sessionId: base.sessionId, turnId }))
+            return invalidCommand();
+        return { ok: true, command: { ...base, client: "trae", turnId, content, triggers } };
+    }
     const transcriptPath = requiredStringField(value, "transcriptPath");
     if (!transcriptPath)
         return invalidCommand();
@@ -310,7 +337,8 @@ function parseCommandBase(value, allowedKeys) {
         && client !== "claude-code"
         && client !== "opencode"
         && client !== "dsh"
-        && client !== "codebuddy")
+        && client !== "codebuddy"
+        && client !== "trae")
         return undefined;
     const clientKeys = allowedKeys[client];
     if (!clientKeys || Object.keys(value).some((key) => !clientKeys.has(key)))
@@ -372,6 +400,10 @@ function validCodeBuddyTurnId(turnId, sessionId, prompt) {
     const identity = parseCodeBuddyTurnId({ sessionId, turnId });
     return Boolean(identity && (prompt === undefined || identity.promptDigest === codeBuddyPromptDigest(prompt)));
 }
+function validTraeTurnId(turnId, sessionId, prompt) {
+    const identity = parseTraeTurnId({ sessionId, turnId });
+    return Boolean(identity && identity.promptDigest === traePromptDigest(prompt));
+}
 function invalidCommand() {
     return { ok: false, error: INVALID_MEMORY_HOOK_COMMAND };
 }

package/lib/memorax-code-backend/dist/memory/reminder-trace-recorder.js

@@ -1,5 +1,5 @@
 import { parseSkillReminderCommand, } from "./hook-command.js";
-import { traceContextFromClaudeHookBody, traceContextFromDshSkillReminder, traceContextFromHookBody, traceContextFromOpenCodeHookBody, traceContextFromCodeBuddyHookBody, } from "../trace/context.js";
+import { traceContextFromClaudeHookBody, traceContextFromDshSkillReminder, traceContextFromHookBody, traceContextFromOpenCodeHookBody, traceContextFromCodeBuddyHookBody, traceContextFromTraeHookBody, } from "../trace/context.js";
 import { recordTraceEvent } from "../trace/store.js";
 export function createMemoryReminderTraceRecorder(options = {}) {
     return {
@@ -49,6 +49,8 @@ function traceContextForReminder(command) {
         return traceContextFromDshSkillReminder(command);
     if (command.client === "codebuddy")
         return traceContextFromCodeBuddyHookBody(command);
+    if (command.client === "trae")
+        return traceContextFromTraeHookBody(command);
     return traceContextFromOpenCodeHookBody(command);
 }
 function reminderSource(command) {
@@ -60,6 +62,8 @@ function reminderSource(command) {
         return "dsh-cordis";
     if (command.client === "codebuddy")
         return "codebuddy-hook";
+    if (command.client === "trae")
+        return "trae-hook";
     return "opencode-plugin";
 }
 async function recordTraceBestEffort(label, promise, diagnosticLogger) {

package/lib/memorax-code-backend/dist/memory/service.js

@@ -4,6 +4,7 @@ import { createClaudeMemoryHookRuntime, } from "../clients/claude/memory-hook-ru
 import { createDshMemoryHookRuntime, } from "../clients/dsh/memory-hook-runtime.js";
 import { createOpenCodeMemoryHookRuntime, } from "../clients/opencode/memory-hook-runtime.js";
 import { createCodeBuddyMemoryHookRuntime } from "../clients/codebuddy/memory-hook-runtime.js";
+import { createTraeMemoryHookRuntime } from "../clients/trae/memory-hook-runtime.js";
 import { createMemoryTurnCoordinator } from "./turn-coordinator.js";
 import { createRepositoryMemorySessionRuntime, } from "./repository-session.js";
 import { createPendingQuotaNoticeRuntime } from "./quota-notice.js";
@@ -56,6 +57,12 @@ export function createMemoryService(options = {}) {
         repositoryMemorySession,
         turnCoordinator,
     });
+    const traeHook = createTraeMemoryHookRuntime({
+        ...options,
+        pendingQuotaNotice,
+        repositoryMemorySession,
+        turnCoordinator,
+    });
     let closed = false;
     return {
         async recordTurnStart(command) {
@@ -70,6 +77,8 @@ export function createMemoryService(options = {}) {
                     return await dshHook.recordTurnStart(command);
                 case "codebuddy":
                     return await codeBuddyHook.recordTurnStart(command);
+                case "trae":
+                    return await traeHook.recordTurnStart(command);
             }
             return unsupportedMemoryHookCommand(command);
         },
@@ -85,6 +94,8 @@ export function createMemoryService(options = {}) {
                     return await dshHook.writeback(command);
                 case "codebuddy":
                     return await codeBuddyHook.writeback(command);
+                case "trae":
+                    return await traeHook.writeback(command);
             }
             return unsupportedMemoryHookCommand(command);
         },
@@ -100,6 +111,7 @@ export function createMemoryService(options = {}) {
             openCodeHook.close();
             dshHook.close();
             codeBuddyHook.close();
+            traeHook.close();
             turnCoordinator.close();
             repositoryMemorySession.close();
             automaticWriteback.close();

package/lib/memorax-code-backend/dist/trace/config.js

@@ -4,7 +4,7 @@ import { join } from "node:path";
 import { loadMemoraxCodeConfig } from "../config/memorax-code.js";
 import { isTraceClient } from "./context.js";
 export const TRACE_CLIENTS = ["codex", "claude", "dsh", "opencode"];
-export const TRACE_RUNTIME_CLIENTS = [...TRACE_CLIENTS, "codebuddy"];
+export const TRACE_RUNTIME_CLIENTS = [...TRACE_CLIENTS, "codebuddy", "trae"];
 export const CODEX_TRACE_DEFAULT_CONFIG = {
     enabled: true,
     captureContent: true,
@@ -36,12 +36,16 @@ export const OPENCODE_TRACE_DEFAULT_CONFIG = {
 export const CODEBUDDY_TRACE_DEFAULT_CONFIG = {
     ...OPENCODE_TRACE_DEFAULT_CONFIG,
 };
+export const TRAE_TRACE_DEFAULT_CONFIG = {
+    ...OPENCODE_TRACE_DEFAULT_CONFIG,
+};
 const TRACE_DEFAULT_CONFIGS = {
     codex: CODEX_TRACE_DEFAULT_CONFIG,
     claude: CLAUDE_TRACE_DEFAULT_CONFIG,
     dsh: DSH_TRACE_DEFAULT_CONFIG,
     opencode: OPENCODE_TRACE_DEFAULT_CONFIG,
     codebuddy: CODEBUDDY_TRACE_DEFAULT_CONFIG,
+    trae: TRAE_TRACE_DEFAULT_CONFIG,
 };
 const TRACE_ENV_PREFIXES = {
     codex: "MEMORAX_CODE_CODEX_TRACE",
@@ -49,6 +53,7 @@ const TRACE_ENV_PREFIXES = {
     dsh: "MEMORAX_CODE_DSH_TRACE",
     opencode: "MEMORAX_CODE_OPENCODE_TRACE",
     codebuddy: "MEMORAX_CODE_CODEBUDDY_TRACE",
+    trae: "MEMORAX_CODE_TRAE_TRACE",
 };
 export const TRACE_CLEANUP_DEBOUNCE_MS = 60 * 60 * 1000;
 export const TRACE_CURRENT_TURN_TTL_MS = 30 * 60 * 1000;
@@ -71,6 +76,9 @@ export function openCodeTraceConfigFromEnv(env = process.env, fileConfig) {
 export function codeBuddyTraceConfigFromEnv(env = process.env, fileConfig) {
     return clientTraceConfigFromEnv("codebuddy", env, fileConfig);
 }
+export function traeTraceConfigFromEnv(env = process.env, fileConfig) {
+    return clientTraceConfigFromEnv("trae", env, fileConfig);
+}
 export function clientTraceConfigFromEnv(client, env = process.env, fileConfig) {
     assertTraceClient(client);
     const config = fileConfig ?? loadMemoraxCodeConfig(memoraxCodeHomeForTrace(env), { warn: () => undefined });
@@ -103,6 +111,9 @@ export function openCodeTracePaths(memoraxCodeHome = memoraxCodeHomeForTrace(pro
 export function codeBuddyTracePaths(memoraxCodeHome = memoraxCodeHomeForTrace(process.env)) {
     return clientTracePaths("codebuddy", memoraxCodeHome);
 }
+export function traeTracePaths(memoraxCodeHome = memoraxCodeHomeForTrace(process.env)) {
+    return clientTracePaths("trae", memoraxCodeHome);
+}
 export function clientTracePaths(client, memoraxCodeHome = memoraxCodeHomeForTrace(process.env)) {
     assertTraceClient(client);
     const root = join(memoraxCodeHome, "debug", "traces", client);

package/lib/memorax-code-backend/dist/trace/context.js

@@ -82,6 +82,26 @@ export function traceContextFromCodeBuddyHookBody(body, capturedAt = new Date().
         capturedAt,
     });
 }
+export function traceContextFromTraeHookBody(body, capturedAt = new Date().toISOString()) {
+    if (!isRecord(body))
+        return undefined;
+    const sessionId = stringField(body, "session_id") ?? stringField(body, "sessionId");
+    const turnId = stringField(body, "turn_id") ?? stringField(body, "turnId");
+    if (!sessionId || !turnId)
+        return undefined;
+    const cwd = stringField(body, "cwd");
+    return pruneTraceContext({
+        schemaVersion: "1",
+        client: "trae",
+        sessionId,
+        turnId,
+        cwd,
+        memoryProject: resolveMemoryProject(cwd),
+        workspaceKind: stringField(body, "workspace_kind") ?? stringField(body, "workspaceKind"),
+        contextOrigin: "trae-hook-body",
+        capturedAt,
+    });
+}
 export function traceContextFromDshTurnStart(body, capturedAt = new Date().toISOString()) {
     return traceContextFromDshBody(body, "dsh-cordis-turn-start", capturedAt);
 }
@@ -149,7 +169,12 @@ function pruneRecord(value) {
     return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
 }
 export function isTraceClient(value) {
-    return value === "codex" || value === "claude" || value === "dsh" || value === "opencode" || value === "codebuddy";
+    return value === "codex"
+        || value === "claude"
+        || value === "dsh"
+        || value === "opencode"
+        || value === "codebuddy"
+        || value === "trae";
 }
 function traceContextFromDshBody(body, contextOrigin, capturedAt) {
     if (!isRecord(body))

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

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/backend",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "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.11",
+  "version": "0.1.12",
   "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.11",
+  "shellVersion": "0.1.12",
   "runtimeAbi": 1
 }

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

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

package/lib/memorax-code-claude-adapter/skills/memorax-code/SKILL.md

@@ -74,7 +74,9 @@ Examples:
 
 ## Shared Rules
 
-For MemoraX Code coding memory, run `memorax-cli` from the active task workspace. The installed Hook and session binding supply the authoritative workspace root; do not run Git commands to discover or replace it. The Backend resolves repository scope from that trusted workspace and read-only filesystem Git metadata.
+For MemoraX Code coding memory, run the platform command from the active task workspace. In Windows PowerShell, use `memorax-cli.cmd`; on macOS and Linux, use `memorax-cli`. Never invoke `memorax-cli.ps1`. Never run `Set-ExecutionPolicy` or otherwise change PowerShell execution policy for MemoraX commands. If an unqualified Windows invocation is blocked before the CLI starts with `UnauthorizedAccess` or `PSSecurityException`, retry the same command once with `memorax-cli.cmd`, preserving all arguments, the active workspace, and environment variables.
+
+The installed Hook and session binding supply the authoritative workspace root; do not run Git commands to discover or replace it. The Backend resolves repository scope from that trusted workspace and read-only filesystem Git metadata.
 
 Repo memory and personal memory remain local `.repo_memory` authorities. Resolve their repository root exactly as described by the selected reference, including its Git requirements.
 

package/lib/memorax-code-claude-adapter/skills/memorax-code/references/memorax-add.md

@@ -17,9 +17,22 @@ Do not add positive repair lessons based only on unverified edits or assistant s
 
 ## Add Workflow
 
+Select the executable before constructing any Add command. In Windows PowerShell, use `memorax-cli.cmd`; on macOS and Linux, use `memorax-cli`. Never invoke `memorax-cli.ps1`. Never run `Set-ExecutionPolicy` or otherwise change PowerShell execution policy for MemoraX commands. If an unqualified Windows invocation is blocked before the CLI starts with `UnauthorizedAccess` or `PSSecurityException`, retry that command once with `memorax-cli.cmd`, preserving all arguments, the active workspace, and environment variables.
+
 For a proactive add, write all generated prose in `--memory`, `--reason`, and the confirmation in the language of the user's current request; preserve exact code, API, path, workflow, and project identifiers.
 
-Run from the active task workspace. Pass the memory and reason directly. Put every dynamically generated `--memory` and `--reason` value in single quotes, never double quotes. Treat `$HOME`, backticks, and `$(command)` as literal text inside those quotes. Replace each literal single quote in a value with the exact POSIX sequence `'\''`.
+Run from the active task workspace. Pass the memory and reason directly. Put every dynamically generated `--memory` and `--reason` value in single quotes, never double quotes. Apply the escaping rule for the active shell:
+
+- Windows PowerShell: single quotes keep `$HOME`, backticks, and `$(command)` literal. Replace each literal single quote in a value with two single quotes (`''`); for example, `don't` becomes `'don''t'`.
+- macOS and Linux: Treat `$HOME`, backticks, and `$(command)` as literal text inside the quotes. Replace each literal single quote in a value with the exact POSIX sequence `'\''`.
+
+Windows PowerShell:
+
+```powershell
+memorax-cli.cmd add --memory 'Concise reusable memory.' --type procedural --reason 'Capture reusable coding memory.'
+```
+
+macOS and Linux:
 
 ```bash
 memorax-cli add \
@@ -49,7 +62,7 @@ anchors: <stable repository source, tests, or public docs>
 
 Keep the card under 1,100 characters when practical. It must guide future investigation while still requiring live-code inspection.
 
-Pass a completed multi-line card as one single-quoted `--memory` argument:
+Pass a completed multi-line card as one single-quoted `--memory` argument. On Windows PowerShell, the command must start with `memorax-cli.cmd add`; on macOS and Linux, use the form shown below.
 
 ```bash
 memorax-cli add \
@@ -69,7 +82,7 @@ anchors: stable/source/path' \
   --reason 'Capture verified reusable coding memory.'
 ```
 
-If add fails, report the exact failure and do not retry automatically, bypass the CLI, or call MemoraX directly.
+Except for the pre-start Windows shim correction above, if add fails, report the exact failure and do not retry automatically, bypass the CLI, or call MemoraX directly. Do not retry Add after the CLI may have started.
 
 If a successful Add result reports `workspaceScopeFallbackReason: git_metadata_invalid`, malformed or incomplete metadata inside a direct `.git` directory was downgraded to the normalized local folder scope. Add has already been submitted with the reported `effectiveUserId`. Present its `userNotice` once without pausing the current task or asking the user to repair Git first, then continue the current task. After the repository or `.git` metadata is repaired, later Search, Add, and automatic writeback in the same client session automatically use the restored Git repository scope.
 

package/lib/memorax-code-claude-adapter/skills/memorax-code/references/memorax-search.md

@@ -4,6 +4,8 @@ Use these instructions only to search reusable coding memory through `memorax-cl
 
 ## Scope
 
+Select the executable before constructing any Search command. In Windows PowerShell, use `memorax-cli.cmd`; on macOS and Linux, use `memorax-cli`. Never invoke `memorax-cli.ps1`. Never run `Set-ExecutionPolicy` or otherwise change PowerShell execution policy for MemoraX commands. If an unqualified Windows invocation is blocked before the CLI starts with `UnauthorizedAccess` or `PSSecurityException`, retry the same command once with `memorax-cli.cmd`, preserving all arguments, the active workspace, and environment variables.
+
 Run the CLI from the active task workspace. The installed Hook and session binding supply the authoritative workspace root; do not run `git rev-parse`, infer the root from Git metadata, or substitute an unrelated working directory. Do not make `memorax-cli status` a mandatory preflight; use it only to diagnose a configuration or scope failure.
 
 Coding memory uses `<MemoraX base username>@<normalized repository name>` for Git workspaces and the normalized folder name for genuine non-Git directories. MemoraX Code resolves `.git`, `gitdir`, and `commondir` without executing Git. Linked worktrees share one repository scope; another clone, repository, or non-Git directory retains a different local session key even when its readable name matches.
@@ -12,7 +14,7 @@ If a successful Search result reports `workspaceScopeFallbackReason: git_metadat
 
 Require a readable active workspace binding. A CLI command from a linked worktree of the bound repository is valid. If `memorax-cli search` reports `workspace_scope_mismatch` or `workspace_scope_unavailable`, do not bypass the scope or fall back to an unscoped username. Do not change the CLI working directory and retry. Tell the user that memory search was not executed and no request was sent to MemoraX, then present the CLI's `userAction` in natural language. Continue the current task using only live code and documentation.
 
-If `memorax-cli` is not on `PATH`, or memory is disabled, unconfigured, or unavailable, report that briefly and continue with live code or documentation. Authenticate through MemoraX Code configuration; never recover credentials from shell history or place tokens in prompts. Treat injected memory as a hypothesis and verify it against the current checkout.
+If the selected platform command is not on `PATH`, or memory is disabled, unconfigured, or unavailable, report that briefly and continue with live code or documentation. Authenticate through MemoraX Code configuration; never recover credentials from shell history or place tokens in prompts. Treat injected memory as a hypothesis and verify it against the current checkout.
 
 ## Search Decision
 
@@ -50,10 +52,21 @@ State a fact-sized relationship that can change the next action: a target under
 
 For a complementary first-round pair, each query must stand alone and cover a different decision boundary. Use a complementary pair only when the provided context gives each decision boundary a distinct exact code, API, path, workflow, or project identifier; otherwise keep one focused combined query that preserves both user-stated facts. Do not merely restate the same question with synonyms. If the user describes only one tightly coupled decision, emit exactly one query. Use one or two stable exact identifiers when they sharpen the query, and integrate them grammatically instead of appending search tags or filler. Use only user-provided anchors and stable terms from live code or documentation; do not reconstruct unseen fact wording from recalled memory.
 
-Pass the query directly with `--query`. Put every dynamically generated query in single quotes, never double quotes. Treat `$HOME`, backticks, and `$(command)` as literal text inside those quotes. Replace each literal single quote in the value with the exact POSIX sequence `'\''`.
+Pass the query directly with `--query`. Put every dynamically generated query in single quotes, never double quotes. Apply the escaping rule for the active shell:
+
+- Windows PowerShell: single quotes keep `$HOME`, backticks, and `$(command)` literal. Replace each literal single quote in the value with two single quotes (`''`); for example, `don't` becomes `'don''t'`.
+- macOS and Linux: Treat `$HOME`, backticks, and `$(command)` as literal text inside the quotes. Replace each literal single quote in the value with the exact POSIX sequence `'\''`.
 
 Use these actual output shapes as examples. They are queries themselves, not full user prompts or instructions for the user. Each Chinese/English pair is a language variant: choose the one matching the user, never run both merely because both are shown. The comments explain the example only and are not part of emitted query text.
 
+On Windows PowerShell, the first example must be invoked as:
+
+```powershell
+memorax-cli.cmd search --query 'Trace 生产版本：升级后到达的记录中，应以哪个客户端版本字段判断由旧插件产生，而非新版本上传进程？'
+```
+
+On macOS and Linux, use the `memorax-cli search` forms below. For other Windows examples, preserve every argument but replace the leading executable with `memorax-cli.cmd`.
+
 ```bash
 # One tightly coupled decision: emit one query.
 memorax-cli search --query 'Trace 生产版本：升级后到达的记录中，应以哪个客户端版本字段判断由旧插件产生，而非新版本上传进程？'

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.11",
+  "version": "0.1.12",
   "description": "Memory skill and local hooks for MemoraX Code in Claude Code.",
   "author": {
     "name": "MemoraX Code Maintainers"