@memorax/memorax-code 0.1.10 → 0.1.12

package/docs/configuration.md

@@ -39,13 +39,13 @@ are not a compatibility contract.
 
 ## New configuration
 
-The generated template selects the existing client integrations, including the optional CodeBuddy/WorkBuddy adapter, disables automatic
-retrieval, enables automatic writeback, sets the preferred language to Chinese
-(`zh`), uses a five-turn skill reminder and the adaptive repository-update
-policy, and enables content-bearing local traces for Codex, Claude Code,
-CodeBuddy/WorkBuddy, and OpenCode. Foreground setup may narrow `[clients]` to
-clients detected on the host. The tables below list all fallbacks, including
-tuning fields omitted from the generated file.
+The generated template selects the existing client integrations, including the
+optional CodeBuddy/WorkBuddy and Trae adapters, disables automatic retrieval,
+enables automatic writeback, sets the preferred language to Chinese (`zh`),
+uses a five-turn skill reminder and the adaptive repository-update policy, and
+enables content-bearing local traces for every supported client. Foreground
+setup may narrow `[clients]` to clients detected on the host. The tables below
+list all fallbacks, including tuning fields omitted from the generated file.
 
 On POSIX systems MemoraX Code creates `$MEMORAX_CODE_HOME` with mode `0700`
 and a new `config.toml` with mode `0600`. Windows relies on the current user's
@@ -54,15 +54,19 @@ filesystem ACLs.
 ## Client selection
 
 If `[clients]` is absent, lifecycle commands select Codex, Claude Code, DSH,
-and OpenCode; CodeBuddy is opt-in unless detected during installation. If it is present, `codex`, `claude`, `dsh`, `opencode`, and `codebuddy` are
-boolean fields. Omitted `codex`, `claude`, or `opencode` values are disabled;
-an omitted `dsh` value remains enabled so configurations written before DSH
-support can discover an existing local Harness. Set `dsh = false` explicitly
-to disable that integration. The command-line override accepts a
+and OpenCode; CodeBuddy/WorkBuddy and Trae are opt-in unless detected during
+foreground setup. If the table is present, `codex`, `claude`, `dsh`,
+`opencode`, `codebuddy`, and `trae` are boolean fields. Direct lifecycle
+commands treat omitted `codex`, `claude`, `opencode`, `codebuddy`, or `trae`
+values as disabled. Setup and update reconciliation retain an omitted field as
+an undecided choice for client support added after the configuration was
+written. An omitted `dsh` value remains enabled so configurations written
+before DSH support can discover an existing local Harness. Set `dsh = false`
+explicitly to disable that integration. The command-line override accepts a
 comma-separated subset:
 
 ```text
---clients codex|claude|dsh|opencode|codebuddy|<comma-separated subset>|all|none
+--clients codex|claude|dsh|opencode|codebuddy|trae|<comma-separated subset>|all|none
 ```
 
 Foreground `memorax-code setup` refreshes `[clients]` from the clients
@@ -70,18 +74,23 @@ available at that time. OpenCode is available when its explicit, XDG, or
 default configuration directory exists, or when `opencode` is on `PATH`.
 DSH is available when at least one valid Profile exists under
 `$DSH_HOME/profiles`; `DSH_HOME` defaults to `~/.dsh`. An explicit
-`[clients].dsh = false` is preserved.
-
-On later setup runs, enabled client intent is preserved. Each newly available
-disabled client is offered for activation with a default of yes; declining
-keeps it disabled. A selected client that is temporarily unavailable remains
-selected instead of being permanently disabled. Direct npm installation does
-not detect clients or modify `[clients]`.
-Automatic update reconciliation also preserves the exact persisted selection;
-it does not offer or enable a newly detected client.
+`[clients].dsh = false` is preserved. Trae is available when its data home or
+application is detected. `TRAE_CN_HOME`, then `TRAE_HOME`, overrides its
+default `~/.trae-cn` data home.
+
+On later setup runs, explicit `true` and `false` client choices are preserved.
+A detected client whose field is absent is offered for activation with a
+default of yes; declining records `false`. An absent client that is not
+detected remains absent, while a selected client that is temporarily
+unavailable remains selected. Direct npm installation does not detect clients
+or modify `[clients]`.
+Automatic update reconciliation preserves explicit choices and silently
+enables a detected client whose field is absent. This lets configurations
+written before an adapter was supported adopt it when its runtime is already
+installed, without overriding an explicit `false`.
 
 Client selection controls managed client-integration lifecycle only. It does
-not change Codex, Claude Code, DSH, or OpenCode provider settings.
+not change any coding agent's provider settings.
 `--clients none` runs the Backend without managing a client integration.
 
 ## Setup, automatic update, and package-transition state
@@ -89,8 +98,10 @@ not change Codex, Claude Code, DSH, or OpenCode provider settings.
 npm installation and foreground setup are separate operations.
 `npm install -g @memorax/memorax-code` installs or replaces package files
 without reading terminal input. `memorax-code setup` owns client detection,
-connection setup, configuration writes, Codex Hook activation or review, and
-final readiness checks.
+connection setup, configuration writes, client integration activation or
+review, and final readiness checks. Trae setup installs the managed Hook
+entries but cannot turn on Trae's application-level Global Hooks setting; the
+user must enable that setting once in Trae Settings.
 
 Default setup reuses a complete effective connection. Otherwise it detects the
 logged-in operating-system username and maps the system language to `zh` or
@@ -127,13 +138,14 @@ Backend to disable the scheduler. Client startup Hooks only recover an
 unavailable Backend and do not schedule updates.
 
 The updater installs an exact published version and runs an internal
-non-interactive setup mode. That mode preserves `[clients]`, connection data,
-and memory preferences. For Codex, only new or changed Hooks returned by the
-incremental check are trusted silently, and the exact Hook selection is
-validated again before and after the config write. A changed marketplace
-identity or unverifiable Hook set prevents reconciliation from completing.
-The standalone `memorax-code codex-plugin trust-hooks` command still performs
-explicit review.
+non-interactive setup mode. That mode preserves explicit `[clients]` choices,
+enables detected clients missing from an older configuration, and preserves
+connection data and memory preferences. For Codex, only new or changed Hooks
+returned by the incremental check are trusted silently, and the exact Hook
+selection is validated again before and after the config write. A changed
+marketplace identity or unverifiable Hook set prevents reconciliation from
+completing. The standalone `memorax-code codex-plugin trust-hooks` command
+still performs explicit review.
 
 The installed version and next check deadline are stored in another private
 record:
@@ -209,8 +221,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.
 
@@ -220,6 +235,38 @@ does not receive a `/c/Users/...` plugin path. `memorax-code-codebuddy status
 Hook executes, `observed` afterward, and `invalid` when the installed Hook
 manifest or runtime is incomplete. Restart or refresh WorkBuddy after setup.
 
+## Trae integration paths
+
+The managed Trae Global Hooks and shared Skill use Trae's data home:
+
+```text
+~/.trae-cn/hooks.json
+~/.trae-cn/skills/memorax-code/
+```
+
+`TRAE_CN_HOME`, then `TRAE_HOME`, overrides the default root; lifecycle
+commands can override it for one invocation with `--trae-home`. The ownership
+record and content-addressed Hook runtime live under
+`$MEMORAX_CODE_HOME/adapters/trae/`. Setup merges one marked MemoraX Code Hook
+into each of `SessionStart`, `UserPromptSubmit`, and `Stop`, preserves other
+Trae Hooks and settings, and refuses to replace an unmanaged
+`skills/memorax-code` directory. Disable and uninstall remove only entries
+marked as MemoraX Code-owned and the managed Skill.
+
+Trae does not expose a reliable programmatic switch for application-level
+Global Hooks. After the first setup, enable **Global Hooks** once in Trae
+Settings and start a new session. `memorax-code-trae status --json` reports the
+Hook runtime as `unverified` until Trae executes a managed Hook, then as
+`observed`; it also reports when this one-time activation may still be needed.
+
+Trae does not currently expose a stable raw Session or a headless CLI. The
+adapter therefore correlates the prompt from `UserPromptSubmit` with the final
+assistant message from `Stop` and uses that closed, validated Hook pair as
+Trae's automatic-writeback content authority. It does not guess from another
+Turn or maintain a pending queue. The Skill can still perform explicit Repo
+Memory work, but automatic background Repo Memory jobs are unavailable in
+Trae until the client provides a suitable headless worker.
+
 The managed loader records the exact MemoraX Code home, OpenCode configuration
 directory, installed Node runtime, and `memorax-code` entrypoint. When the
 enabled plugin loads, it performs a best-effort Backend health check and uses
@@ -370,12 +417,14 @@ Supported policies are `every-commit`, `commit-count`, `daily`,
 `pull-request`, `pull-request-or-daily`, and `adaptive`. Invalid policy values
 fall back to `adaptive`.
 
-In Codex, Claude Code, CodeBuddy/WorkBuddy, DSH, and OpenCode, the first eligible prompt starts a
-background build only when the Backend has authorized a Git worktree and that
-worktree has no `.repo_memory/PROFILE.md`. If the Backend or workspace
-authority is unavailable, the client integration skips that attempt instead
-of falling back to its local workspace path. DSH schedules this work through
-its native pre-step integration rather than a Hook.
+In Codex, Claude Code, CodeBuddy/WorkBuddy, DSH, and OpenCode, the first
+eligible prompt starts a background build only when the Backend has authorized
+a Git worktree and that worktree has no `.repo_memory/PROFILE.md`. If the
+Backend or workspace authority is unavailable, the client integration skips
+that attempt instead of falling back to its local workspace path. DSH schedules
+this work through its native pre-step integration rather than a Hook. Trae
+receives the shared Skill, User Profile, and Procedure reminders, but does not
+start this background build because Trae has no supported headless worker.
 
 CodeBuddy/WorkBuddy repository jobs run the headless client under a bounded
 worker. `MEMORAX_CODE_REPO_MEMORY_JOB_TIMEOUT_MS` sets the client execution
@@ -385,24 +434,26 @@ the grace period before the worker force-terminates a client that ignores
 `codebuddy_timeout` (or `<runner>_timeout`) in the job state, so a stalled
 headless client cannot leave an active job and repository marker indefinitely.
 
-A relevant repo-read runs supervised maintenance in all supported clients. The
-configured policy may select a build, update, or no-op. DSH maintenance
-requires an enabled, managed Profile that includes `@deepseek-ai/dsh-headless`.
-OpenCode executes the job through its active local server. Desktop-only
-installations do not require a standalone `opencode` executable in `PATH`.
+A relevant repo-read runs supervised maintenance in the five headless-capable
+client integrations. The configured policy may select a build, update, or
+no-op. DSH maintenance requires an enabled, managed Profile that includes
+`@deepseek-ai/dsh-headless`. OpenCode executes the job through its active local
+server. Desktop-only installations do not require a standalone `opencode`
+executable in `PATH`. Trae users can invoke the Skill explicitly, but Trae is
+not an automatic maintenance runner.
 
 ## Local traces
 
-`[trace.codex]`, `[trace.claude]`, `[trace.dsh]`, `[trace.opencode]`, and `[trace.codebuddy]`
-support the same fields:
+`[trace.codex]`, `[trace.claude]`, `[trace.dsh]`, `[trace.opencode]`,
+`[trace.codebuddy]`, and `[trace.trae]` support the same fields:
 
-| Field | Codex environment | Claude environment | DSH environment | OpenCode environment | CodeBuddy/WorkBuddy environment | Fallback |
-| --- | --- | --- | --- | --- | --- | --- |
-| `enabled` | `MEMORAX_CODE_CODEX_TRACE_ENABLED` | `MEMORAX_CODE_CLAUDE_TRACE_ENABLED` | `MEMORAX_CODE_DSH_TRACE_ENABLED` | `MEMORAX_CODE_OPENCODE_TRACE_ENABLED` | `MEMORAX_CODE_CODEBUDDY_TRACE_ENABLED` | `true` |
-| `capture_content` | `MEMORAX_CODE_CODEX_TRACE_CAPTURE_CONTENT` | `MEMORAX_CODE_CLAUDE_TRACE_CAPTURE_CONTENT` | `MEMORAX_CODE_DSH_TRACE_CAPTURE_CONTENT` | `MEMORAX_CODE_OPENCODE_TRACE_CAPTURE_CONTENT` | `MEMORAX_CODE_CODEBUDDY_TRACE_CAPTURE_CONTENT` | `true` |
-| `retention_days` | `MEMORAX_CODE_CODEX_TRACE_RETENTION_DAYS` | `MEMORAX_CODE_CLAUDE_TRACE_RETENTION_DAYS` | `MEMORAX_CODE_DSH_TRACE_RETENTION_DAYS` | `MEMORAX_CODE_OPENCODE_TRACE_RETENTION_DAYS` | `MEMORAX_CODE_CODEBUDDY_TRACE_RETENTION_DAYS` | `7` |
-| `max_event_chars` | `MEMORAX_CODE_CODEX_TRACE_MAX_EVENT_CHARS` | `MEMORAX_CODE_CLAUDE_TRACE_MAX_EVENT_CHARS` | `MEMORAX_CODE_DSH_TRACE_MAX_EVENT_CHARS` | `MEMORAX_CODE_OPENCODE_TRACE_MAX_EVENT_CHARS` | `MEMORAX_CODE_CODEBUDDY_TRACE_MAX_EVENT_CHARS` | `20000` |
-| `max_file_bytes` | `MEMORAX_CODE_CODEX_TRACE_MAX_FILE_BYTES` | `MEMORAX_CODE_CLAUDE_TRACE_MAX_FILE_BYTES` | `MEMORAX_CODE_DSH_TRACE_MAX_FILE_BYTES` | `MEMORAX_CODE_OPENCODE_TRACE_MAX_FILE_BYTES` | `MEMORAX_CODE_CODEBUDDY_TRACE_MAX_FILE_BYTES` | `52428800` |
+| Field | Codex environment | Claude environment | DSH environment | OpenCode environment | CodeBuddy/WorkBuddy environment | Trae environment | Fallback |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| `enabled` | `MEMORAX_CODE_CODEX_TRACE_ENABLED` | `MEMORAX_CODE_CLAUDE_TRACE_ENABLED` | `MEMORAX_CODE_DSH_TRACE_ENABLED` | `MEMORAX_CODE_OPENCODE_TRACE_ENABLED` | `MEMORAX_CODE_CODEBUDDY_TRACE_ENABLED` | `MEMORAX_CODE_TRAE_TRACE_ENABLED` | `true` |
+| `capture_content` | `MEMORAX_CODE_CODEX_TRACE_CAPTURE_CONTENT` | `MEMORAX_CODE_CLAUDE_TRACE_CAPTURE_CONTENT` | `MEMORAX_CODE_DSH_TRACE_CAPTURE_CONTENT` | `MEMORAX_CODE_OPENCODE_TRACE_CAPTURE_CONTENT` | `MEMORAX_CODE_CODEBUDDY_TRACE_CAPTURE_CONTENT` | `MEMORAX_CODE_TRAE_TRACE_CAPTURE_CONTENT` | `true` |
+| `retention_days` | `MEMORAX_CODE_CODEX_TRACE_RETENTION_DAYS` | `MEMORAX_CODE_CLAUDE_TRACE_RETENTION_DAYS` | `MEMORAX_CODE_DSH_TRACE_RETENTION_DAYS` | `MEMORAX_CODE_OPENCODE_TRACE_RETENTION_DAYS` | `MEMORAX_CODE_CODEBUDDY_TRACE_RETENTION_DAYS` | `MEMORAX_CODE_TRAE_TRACE_RETENTION_DAYS` | `7` |
+| `max_event_chars` | `MEMORAX_CODE_CODEX_TRACE_MAX_EVENT_CHARS` | `MEMORAX_CODE_CLAUDE_TRACE_MAX_EVENT_CHARS` | `MEMORAX_CODE_DSH_TRACE_MAX_EVENT_CHARS` | `MEMORAX_CODE_OPENCODE_TRACE_MAX_EVENT_CHARS` | `MEMORAX_CODE_CODEBUDDY_TRACE_MAX_EVENT_CHARS` | `MEMORAX_CODE_TRAE_TRACE_MAX_EVENT_CHARS` | `20000` |
+| `max_file_bytes` | `MEMORAX_CODE_CODEX_TRACE_MAX_FILE_BYTES` | `MEMORAX_CODE_CLAUDE_TRACE_MAX_FILE_BYTES` | `MEMORAX_CODE_DSH_TRACE_MAX_FILE_BYTES` | `MEMORAX_CODE_OPENCODE_TRACE_MAX_FILE_BYTES` | `MEMORAX_CODE_CODEBUDDY_TRACE_MAX_FILE_BYTES` | `MEMORAX_CODE_TRAE_TRACE_MAX_FILE_BYTES` | `52428800` |
 
 Depending on the enabled client capabilities, content capture can include
 prompts, responses, recalled memory, writeback content, reminder text, and
@@ -415,6 +466,10 @@ DSH trace contains only normalized lifecycle and memory-operation events. Its
 native Session Event Log and raw events remain local to DSH; MemoraX Code does
 not copy that log into trace.
 
+Trae trace contains only normalized lifecycle and memory-operation events from
+the validated Hook pair. Trae does not expose a raw Session authority for
+MemoraX Code to copy.
+
 ## Backend runtime settings
 
 Backend connection and process authority is not stored in `config.toml`.
@@ -462,6 +517,8 @@ memorax-code-codex doctor
 memorax-code-claude doctor
 memorax-code status --clients dsh
 memorax-code-opencode doctor
+memorax-code-codebuddy status --json
+memorax-code-trae status --json
 ```
 
 The status commands do not print the MemoraX API key or Backend token.

package/docs/troubleshooting.md

@@ -9,14 +9,23 @@ memorax-code-codex doctor
 memorax-code-claude doctor
 memorax-code status --clients dsh
 memorax-code-opencode doctor
+memorax-code-codebuddy status --json
+memorax-code-trae status --json
 memorax-code logs
 ```
 
+In Windows PowerShell, use `memorax-cli.cmd` everywhere this guide shows
+`memorax-cli`. If an unqualified command fails with `UnauthorizedAccess` or
+`PSSecurityException` because PowerShell selected `memorax-cli.ps1`, rerun the
+same command once with `memorax-cli.cmd`, preserving its arguments and working
+directory. Do not run `Set-ExecutionPolicy` for MemoraX commands.
+
 `memorax-code status` checks the Backend and selected client integrations,
-including DSH and OpenCode. `memorax-cli status` checks credentials, scope, and
-memory switches without printing secrets. Codex, Claude Code, and OpenCode
-also provide client-specific `doctor` commands; DSH uses the shared lifecycle
-status.
+including DSH, OpenCode, CodeBuddy/WorkBuddy, and Trae. `memorax-cli status`
+checks credentials, scope, and memory switches without printing secrets.
+Codex, Claude Code, and OpenCode provide client-specific `doctor` commands;
+CodeBuddy/WorkBuddy and Trae provide adapter status commands, and DSH uses the
+shared lifecycle status.
 
 ## Package installed, but setup did not start
 
@@ -176,8 +185,9 @@ Memory write and memory search reminders are tracked independently. A reminder
 is emitted when the corresponding remaining quota reaches 10% or less and
 again at 0%; raw quota counts are not shown.
 
-Automatic quota reminders are currently supported in Codex, Claude Code, and
-OpenCode. DeepSeek Harness does not currently surface these reminders.
+Automatic quota reminders are currently supported in Codex, Claude Code,
+CodeBuddy/WorkBuddy, OpenCode, and Trae. DeepSeek Harness does not currently
+surface these reminders.
 
 A guest reminder displays the complete Mark ID when the ready local trial
 identity matches the active API key. Registered-account reminders do not
@@ -268,8 +278,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
@@ -280,6 +293,33 @@ If WorkBuddy still reports a Hook command containing `/c/Users/...`, it is
 loading a stale plugin manifest. Rerun the start command above and fully
 restart WorkBuddy. Do not manually edit the installed Hook command.
 
+## Trae Global Hooks or Skill is inactive
+
+```sh
+memorax-code start --clients trae
+memorax-code-trae status --json
+```
+
+Trae uses `TRAE_CN_HOME`, then `TRAE_HOME`, and otherwise defaults to
+`~/.trae-cn`. Setup merges the managed `SessionStart`, `UserPromptSubmit`, and
+`Stop` entries into `hooks.json` and installs the shared Skill without
+replacing unrelated Hooks. If status reports `globalHooksActivationRequired`
+or a Hook status of `unverified`, open Trae Settings, enable **Global Hooks**
+once, fully restart or refresh Trae, start a new session, and submit one
+prompt. A subsequent status should report `observed`.
+
+If status reports `hooks_invalid`, repair the existing Trae `hooks.json`
+syntax before rerunning the start command. If it reports `skill_conflict`, an
+unmanaged `skills/memorax-code` directory already exists; preserve or move that
+directory deliberately before asking MemoraX Code to manage the Skill. Do not
+copy generated runtime files or edit entries containing
+`--memorax-code-trae-hook-v1` by hand.
+
+Trae currently provides no stable raw Session or headless CLI. Automatic
+writeback therefore requires a matching `UserPromptSubmit` and `Stop` Hook
+pair, and automatic background Repo Memory jobs are not available. Explicit
+Search/Add and Skill-driven Repo Memory remain available.
+
 ## DeepSeek Harness Profile integration is inactive
 
 ```sh
@@ -352,6 +392,7 @@ memorax-code-codex doctor
 memorax-code-claude doctor
 memorax-code status --clients dsh
 memorax-code-opencode doctor
+memorax-code-trae status --json
 /usr/sbin/scutil --proxy
 /bin/launchctl getenv NO_PROXY
 /bin/launchctl getenv no_proxy
@@ -370,6 +411,7 @@ memorax-code-codex doctor
 memorax-code-claude doctor
 memorax-code status --clients dsh
 memorax-code-opencode doctor
+memorax-code-trae status --json
 ```
 
 Common causes are:

package/lib/memorax-code-backend/dist/clients/claude/transcript-turn.js

@@ -488,13 +488,13 @@ function isNamedExecutable(word, name) {
     if (!word)
         return false;
     const normalized = word.replaceAll("\\", "/");
-    if (normalized === name || normalized === `${name}.mjs`)
+    if (normalized === name || normalized === `${name}.cmd` || normalized === `${name}.mjs`)
         return true;
     const absolute = normalized.startsWith("/") || /^[A-Za-z]:\//u.test(normalized);
     if (!absolute)
         return false;
     const basename = normalized.slice(normalized.lastIndexOf("/") + 1);
-    return basename === name || basename === `${name}.mjs`;
+    return basename === name || basename === `${name}.cmd` || basename === `${name}.mjs`;
 }
 function claudeMemoryActivities(assistantMessages) {
     const activities = [];

package/lib/memorax-code-backend/dist/clients/codex/rollout-turn.js

@@ -349,7 +349,7 @@ function activityCandidatesFromResponseItem(payload) {
             operation: match[1] === "build" ? "repo-build" : "repo-update",
         });
     }
-    const memoryCliPattern = /(?:["']?cmd["']?\s*:\s*\\?["'`]|&&|\|\||;)\s*memorax-cli\s+(search|add)\b/giu;
+    const memoryCliPattern = /(?:["']?cmd["']?\s*:\s*\\?["'`]|&&|\|\||;)\s*memorax-cli(?:\.cmd)?\s+(search|add)\b/giu;
     for (const match of input.matchAll(memoryCliPattern)) {
         candidates.push({
             offset: match.index,

package/lib/memorax-code-backend/dist/clients/trae/lifecycle.js

@@ -0,0 +1,53 @@
+export const traeAdapterLifecycle = {
+    async status({ argv, serviceOptions }) {
+        try {
+            return await (await load()).readTraeAdapterStatus(options(argv, serviceOptions));
+        }
+        catch (error) {
+            return { ok: false, action: "status", error: error instanceof Error ? error.message : String(error) };
+        }
+    },
+    async prepareEnable({ argv, serviceOptions }) {
+        try {
+            return await (await load()).enableTraeAdapter(options(argv, serviceOptions));
+        }
+        catch (error) {
+            return { ok: false, action: "enable", error: error instanceof Error ? error.message : String(error) };
+        }
+    },
+    async disable({ argv, serviceOptions }) {
+        try {
+            return await (await load()).disableTraeAdapter(options(argv, serviceOptions));
+        }
+        catch (error) {
+            return { ok: false, action: "disable", error: error instanceof Error ? error.message : String(error) };
+        }
+    },
+    async remove({ argv, serviceOptions }) {
+        try {
+            return await (await load()).removeTraeAdapterInstallation(options(argv, serviceOptions));
+        }
+        catch (error) {
+            return {
+                ok: false,
+                action: "trae-adapter-remove",
+                reason: "adapter_remove_failed",
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+    },
+};
+function options(argv, serviceOptions) {
+    const traeHome = argValue(argv, "--trae-home");
+    return {
+        ...(traeHome ? { traeHome } : {}),
+        memoraxCodeHome: serviceOptions.home,
+    };
+}
+async function load() {
+    return await import(new URL("../../../../memorax-code-trae-adapter/src/config.mjs", import.meta.url).href);
+}
+function argValue(argv, name) {
+    const index = argv.indexOf(name);
+    return index >= 0 ? argv[index + 1] : undefined;
+}