@aliyunrds/ctxdb 1.0.3 → 1.0.6-beta.0

package/dist/cli/main.js

@@ -12,7 +12,7 @@ import {
   pollIngest,
   uploadFile,
   uploadText
-} from "../chunk-3PFMHU3C.js";
+} from "../chunk-L4GVGVOP.js";
 import {
   DEFAULT_BASE_URL,
   DEFAULT_USER_ID,
@@ -25,6 +25,7 @@ import {
   agentPlatformSupport,
   configuredAgents,
   detectInstalledAgents,
+  hasConfiguredAgent,
   inspectAgentHomes,
   isAgentSlug,
   isBuiltinAgent,
@@ -32,13 +33,14 @@ import {
   load,
   removeAgent,
   save,
+  updateConfiguredDebug,
   writeInstalledPkgVersion
-} from "../chunk-JFTKYEVN.js";
+} from "../chunk-ARZX2RLR.js";
 import {
   beginUpdateNotification,
   completeUpdateNotification,
   runSelfUpdate
-} from "../chunk-BQA7YSXT.js";
+} from "../chunk-Z6OHSEF2.js";
 
 // src/cli/util.ts
 var BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
@@ -70,8 +72,10 @@ var BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   // kb upload-text / upload-file
   "verbose",
   // memory search / kb search (three-tier projection)
-  "raw"
+  "raw",
   // kb search / memory search --knowledge (W3 compaction bypass)
+  "full"
+  // debug recall full-content human output
 ]);
 function parseArgs(argv, booleanFlags = BOOLEAN_FLAGS) {
   const positional = [];
@@ -127,8 +131,14 @@ var BOLD = "\x1B[1m";
 var RESET = "\x1B[0m";
 var CHECK = `${GREEN}\u2714${RESET}`;
 var CROSS = `${RED}\u2718${RESET}`;
+function highlightInlineCode(text, surroundingStyle = "") {
+  return text.replace(
+    /`([^`\n]+)`/g,
+    (_match, content) => `${RESET}${BOLD}${content}${RESET}${surroundingStyle}`
+  );
+}
 function dim(text) {
-  return `${DIM}${text}${RESET}`;
+  return `${DIM}${highlightInlineCode(text, DIM)}${RESET}`;
 }
 function isSetupResult(v) {
   if (typeof v !== "object" || v === null) return false;
@@ -153,7 +163,7 @@ function formatSetupResult(r, command = "setup") {
 `);
   for (const s of r.steps) {
     const icon = s.ok ? CHECK : CROSS;
-    const detail = s.detail ? `  ${DIM}${s.detail}${RESET}` : "";
+    const detail = s.detail ? `  ${dim(s.detail)}` : "";
     lines.push(`  ${icon} ${s.step}${detail}`);
   }
   return lines.join("\n");
@@ -168,7 +178,7 @@ function formatUpgradeResult(r) {
     lines.push(`  ${icon} ${BOLD}${name}${RESET}`);
     for (const s of result.steps) {
       const sIcon = s.ok ? CHECK : CROSS;
-      const detail = s.detail ? `  ${DIM}${s.detail}${RESET}` : "";
+      const detail = s.detail ? `  ${dim(s.detail)}` : "";
       lines.push(`      ${sIcon} ${s.step}${detail}`);
     }
   }
@@ -186,16 +196,19 @@ function formatMultiAgentResult(r) {
     lines.push(`  ${agentOk ? CHECK : CROSS} ${BOLD}${name}${RESET}`);
     if (r.operation === "setup") {
       for (const step of result.steps ?? []) {
-        const detail = step.detail ? `  ${DIM}${step.detail}${RESET}` : "";
+        const detail = step.detail ? `  ${dim(step.detail)}` : "";
         lines.push(`      ${step.ok ? CHECK : CROSS} ${step.step}${detail}`);
       }
       for (const hint of result.hints ?? []) {
-        lines.push(`      ${DIM}hint${RESET}  ${hint}`);
+        lines.push(`      ${DIM}hint${RESET}  ${highlightInlineCode(hint)}`);
       }
       continue;
     }
     lines.push(`      ${DIM}config${RESET}     ${result.ok ? "complete" : "incomplete"}`);
     lines.push(`      ${DIM}connected${RESET}  ${result.connected ? "yes" : "no"}`);
+    lines.push(
+      `      ${DIM}debug${RESET}      ${result.debug ? "enabled" : "disabled"} (configured=${result.debug_configured ? "enabled" : "disabled"}, forced=${result.debug_forced ? "yes" : "no"}, reason=${result.debug_reason ?? "-"})`
+    );
     if (result.hooks_node !== void 0) {
       lines.push(`      ${DIM}hooks${RESET}      ${result.hooks_node}`);
     }
@@ -227,6 +240,10 @@ function formatStatusResult(r) {
     ["top_k", r.top_k],
     ["threshold", r.threshold],
     ["knowledge_top_k", r.knowledge_top_k],
+    ["debug", r.debug],
+    ["debug_configured", r.debug_configured],
+    ["debug_forced", r.debug_forced],
+    ["debug_reason", r.debug_reason],
     ["connected", r.connected],
     ["version", r.version]
   ];
@@ -318,6 +335,8 @@ function skillInstallRoot(agent) {
       return join(homedir(), ".qoder", "skills");
     case "qoderwork":
       return join(homedir(), ".qoderwork", "skills");
+    case "qwenwork":
+      return join(homedir(), ".qwenwork", "skills");
     case "codex":
       return join(homedir(), ".codex", "skills");
     case "claude":
@@ -340,6 +359,8 @@ function hookConfigPath(agent) {
       return join(homedir(), ".qoder", "settings.json");
     case "qoderwork":
       return join(homedir(), ".qoderwork", "settings.json");
+    case "qwenwork":
+      return join(homedir(), ".qwenwork", "settings.json");
     case "codex":
       return join(homedir(), ".codex", "hooks.json");
     case "claude":
@@ -375,6 +396,7 @@ function checkCurrentNodeVersion() {
 }
 async function runSetup(options) {
   const steps = [];
+  let existingAgentHomes = [];
   if (!isAgentSlug(options.agent)) {
     steps.push({
       step: "validate-agent",
@@ -395,6 +417,7 @@ async function runSetup(options) {
     const homeCheck = checkAgentHome(agent);
     steps.push(homeCheck);
     if (!homeCheck.ok) return { ok: false, steps };
+    existingAgentHomes = inspectAgentHomes(agent).existing;
   }
   const cfg = load({ agent });
   if (options.apiKey) cfg.apiKey = options.apiKey;
@@ -423,7 +446,7 @@ async function runSetup(options) {
       detail: `default: copied from ${agent}`
     });
   }
-  if (installSkill && isBuiltinAgent(agent)) {
+  if (installSkill && isBuiltinAgent(agent) && existingAgentHomes.includes(agentHomeDir(agent))) {
     const installRoot = skillInstallRoot(agent);
     for (const legacy of LEGACY_SKILL_DIRS) {
       const legacyDir = join(installRoot, legacy);
@@ -445,6 +468,8 @@ async function runSetup(options) {
     if (!skillResult.ok) return { ok: false, steps };
   }
   if (isBuiltinAgent(agent) && agentSupportsHooks(agent)) {
+    const primaryHome = agentHomeDir(agent);
+    const primaryHomeExists = existingAgentHomes.includes(primaryHome);
     const hookPaths = locateHookPaths();
     steps.push({
       step: "locate-hooks",
@@ -460,26 +485,28 @@ async function runSetup(options) {
       detail: nodeCheck.ok ? `${nodePath} (${nodeCheck.version})` : `node not executable: ${nodeCheck.error}`
     });
     if (!nodeCheck.ok) return { ok: false, steps };
-    try {
-      backupSettingsJson(agent);
-      steps.push({ step: "backup-settings", ok: true });
-      const removed = stripCtxdbHooks(agent);
-      if (removed > 0) {
+    if (primaryHomeExists) {
+      try {
+        backupSettingsJson(agent);
+        steps.push({ step: "backup-settings", ok: true });
+        const removed = stripCtxdbHooks(agent);
+        if (removed > 0) {
+          steps.push({
+            step: "clean-legacy-hooks",
+            ok: true,
+            detail: `removed ${removed} existing entries`
+          });
+        }
+        appendHooks(agent, hookPaths);
+        steps.push({ step: "append-hooks", ok: true });
+      } catch (err) {
         steps.push({
-          step: "clean-legacy-hooks",
-          ok: true,
-          detail: `removed ${removed} existing entries`
+          step: "settings-update",
+          ok: false,
+          detail: err?.message ?? String(err)
         });
+        return { ok: false, steps };
       }
-      appendHooks(agent, hookPaths);
-      steps.push({ step: "append-hooks", ok: true });
-    } catch (err) {
-      steps.push({
-        step: "settings-update",
-        ok: false,
-        detail: err?.message ?? String(err)
-      });
-      return { ok: false, steps };
     }
     try {
       chmodSync(hookPaths.userPromptSubmit, 493);
@@ -499,8 +526,7 @@ async function runSetup(options) {
     if (agent === "codex") {
       steps.push(enableCodexHooksFeature());
     }
-    const primaryHome = agentHomeDir(agent);
-    const variantHomes = agentHomeDirs(agent).filter((d) => d !== primaryHome && existsSync(d));
+    const variantHomes = existingAgentHomes.filter((d) => d !== primaryHome);
     for (const vHome of variantHomes) {
       const tag = vHome.split("/").pop() ?? vHome;
       if (installSkill) {
@@ -1093,42 +1119,49 @@ function checkHookNodePaths(agent) {
     nodeOk: true,
     detail: "no hooks installed"
   };
-  const path = hookConfigPath(agent);
-  if (!path || !existsSync(path)) return empty;
-  let data;
-  try {
-    data = JSON.parse(readFileSync(path, "utf-8"));
-  } catch {
-    return empty;
-  }
-  if (!data?.hooks || typeof data.hooks !== "object") return empty;
+  const primaryHome = agentHomeDir(agent);
+  const primaryPath = hookConfigPath(agent);
+  const configPaths = agentHomeDirs(agent).filter((home) => existsSync(home)).map((home) => home === primaryHome ? primaryPath : join(home, "settings.json")).filter((path) => path !== null && existsSync(path));
+  if (configPaths.length === 0) return empty;
+  let foundHooksObject = false;
   const nodePaths = /* @__PURE__ */ new Set();
-  for (const event of HOOK_EVENTS) {
-    const entries = data.hooks[event];
-    if (!Array.isArray(entries)) continue;
-    for (const entry of entries) {
-      if (!entryIsCtxdb(entry)) continue;
-      for (const h of entry.hooks ?? []) {
-        if (h?.type !== "command" || typeof h.command !== "string") continue;
-        if (Array.isArray(h.args) && h.args.length > 0) {
-          nodePaths.add(h.command);
-        } else {
-          const cmd = h.command;
-          let nodePath;
-          if (cmd.startsWith('"')) {
-            const closeQuote = cmd.indexOf('"', 1);
-            if (closeQuote > 1) nodePath = cmd.slice(1, closeQuote);
+  for (const configPath of configPaths) {
+    let data;
+    try {
+      data = JSON.parse(readFileSync(configPath, "utf-8"));
+    } catch {
+      continue;
+    }
+    if (!data?.hooks || typeof data.hooks !== "object") continue;
+    foundHooksObject = true;
+    for (const event of HOOK_EVENTS) {
+      const entries = data.hooks[event];
+      if (!Array.isArray(entries)) continue;
+      for (const entry of entries) {
+        if (!entryIsCtxdb(entry)) continue;
+        for (const h of entry.hooks ?? []) {
+          if (h?.type !== "command" || typeof h.command !== "string") continue;
+          if (Array.isArray(h.args) && h.args.length > 0) {
+            nodePaths.add(h.command);
           } else {
-            const parts = cmd.split(" ");
-            if (parts.length >= 2 && !parts[0].endsWith(".js") && !parts[0].endsWith(".ts") && (parts[0].includes("/") || parts[0].includes("\\"))) {
-              nodePath = parts[0];
+            const cmd = h.command;
+            let nodePath;
+            if (cmd.startsWith('"')) {
+              const closeQuote = cmd.indexOf('"', 1);
+              if (closeQuote > 1) nodePath = cmd.slice(1, closeQuote);
+            } else {
+              const parts = cmd.split(" ");
+              if (parts.length >= 2 && !parts[0].endsWith(".js") && !parts[0].endsWith(".ts") && (parts[0].includes("/") || parts[0].includes("\\"))) {
+                nodePath = parts[0];
+              }
             }
+            if (nodePath) nodePaths.add(nodePath);
           }
-          if (nodePath) nodePaths.add(nodePath);
         }
       }
     }
   }
+  if (!foundHooksObject) return empty;
   if (nodePaths.size === 0) {
     return { installed: true, nodePaths: [], nodeOk: true, detail: "hooks use shebang (no explicit node path)" };
   }
@@ -1360,6 +1393,8 @@ var SKILL_INSTALL_TARGETS = {
   qodercn: join(homedir(), ".qoder-cn", "skills"),
   qoderwork: join(homedir(), ".qoderwork", "skills"),
   qoderworkcn: join(homedir(), ".qoderworkcn", "skills"),
+  qwenwork: join(homedir(), ".qwenwork", "skills"),
+  qwenworkcn: join(homedir(), ".qwenworkcn", "skills"),
   codex: join(homedir(), ".codex", "skills"),
   claude: join(homedir(), ".claude", "skills"),
   opencode: join(homedir(), ".config", "opencode", "skills"),
@@ -1518,7 +1553,7 @@ function hermesAllowlistPath() {
   return join(dirname(hermesConfigPath()), HERMES_ALLOWLIST_FILENAME);
 }
 function hermesHookApprovalHint(events = HERMES_HOOK_EVENTS) {
-  const hookNames = events.map((event) => `\`${event}\``).join(" and ");
+  const hookNames = events.join(" and ");
   return `Approve the Hermes ctxdb hooks ${hookNames}: run \`hermes --accept-hooks chat\` once. This command opens an interactive chat; after Hermes starts, exit the chat, rerun \`ctxdb setup --agent hermes\`, then restart any running Hermes CLI or gateway process.`;
 }
 function backupHermesConfig() {
@@ -1971,7 +2006,7 @@ async function runUpgrade(options = {}) {
 var STATUS_HELP = `ctxdb status \u2014 inspect configuration and connectivity
 
 USAGE
-  ctxdb status [--agent <qoder|qoderwork|codex|claude|opencode|hermes|default> | --all] [--json]
+  ctxdb status [--agent <qoder|qoderwork|qwenwork|codex|claude|opencode|hermes|default> | --all] [--json]
 
 FLAGS
   --agent <name>  Inspect exactly one Agent profile
@@ -2005,6 +2040,10 @@ async function inspectStatus(agent) {
       top_k: cfg.topK,
       threshold: cfg.threshold,
       knowledge_top_k: cfg.knowledgeTopK,
+      debug: cfg.debug,
+      debug_configured: cfg.debugConfigured,
+      debug_forced: cfg.debugForced,
+      debug_reason: cfg.debugReason,
       connected,
       ping_error: pingError,
       hooks_node: hookHealth.detail,
@@ -2093,7 +2132,7 @@ async function ping(args) {
 var HELP = `ctxdb setup \u2014 configure an agent
 
 USAGE
-  ctxdb setup [--agent <qoder|qoderwork|codex|claude|opencode|hermes> | --all]
+  ctxdb setup [--agent <qoder|qoderwork|qwenwork|codex|claude|opencode|hermes> | --all]
               [--api-key=K] [--base-url=URL] [--user-id=ID]
               [--no-install-skill] [--no-validate] [--json]
 
@@ -2114,7 +2153,7 @@ BEHAVIOR
                    any running Hermes CLI/gateway process to load the hooks.
 
 FLAGS
-  --agent <name>        Target agent (qoder|qoderwork|codex|claude|opencode|hermes)
+  --agent <name>        Target agent (qoder|qoderwork|qwenwork|codex|claude|opencode|hermes)
   --all                 Target every setup-compatible detected Agent
   --api-key <key>       API key (required on first setup)
   --base-url <url>      Server URL (default: https://context-database.aliyuncs.com)
@@ -2124,9 +2163,27 @@ FLAGS
   --json                Machine-readable JSON output
 `;
 var CODEX_HOOKS_TRUST_REMINDER = [
-  "codex hooks \u914D\u7F6E\u540E\uFF0C\u9700\u8981\u91CD\u542F Codex \u5BF9\u8BDD\uFF0C\u5728\u5F39\u51FA\u7684 hooks \u786E\u8BA4\u754C\u9762\u9009\u62E9\u63A5\u6536\u6240\u6709 hooks(\u94A9\u5B50)\u9009\u9879\u3002",
-  "\u5982\u679C\u4F7F\u7528\u7684\u662F Codex App \u684C\u9762\u7248\uFF0C\u64CD\u4F5C\u8DEF\u5F84\u662F\uFF1A\u5DE6\u4E0B\u89D2\u70B9\u51FB\u7528\u6237\u540D \u2192 \u70B9\u51FB\u8BBE\u7F6E \u2192 \u70B9\u51FB\u4FA7\u8FB9\u680F\u7684 Hooks\uFF08\u94A9\u5B50\uFF09\u2192 \u70B9\u51FB\u7528\u6237\u914D\u7F6E\uFF0C\u4FE1\u4EFB UserPromptSubmit \u548C SessionStart \u91CC\u7684 aliyunrds/ctxdb \u94A9\u5B50\u3002"
+  "codex hooks \u914D\u7F6E\u540E\uFF0C\u9700\u8981\u91CD\u542F Codex \u5BF9\u8BDD\uFF0C\u5728\u5F39\u51FA\u7684 hooks \u786E\u8BA4\u754C\u9762\u9009\u62E9`\u63A5\u6536\u6240\u6709 hooks(\u94A9\u5B50)`\u9009\u9879\u3002",
+  "\u5982\u679C\u4F7F\u7528\u7684\u662F Codex App \u684C\u9762\u7248\uFF0C\u64CD\u4F5C\u8DEF\u5F84\u662F\uFF1A\u5DE6\u4E0B\u89D2\u70B9\u51FB\u7528\u6237\u540D \u2192 \u70B9\u51FB\u8BBE\u7F6E \u2192 \u70B9\u51FB\u4FA7\u8FB9\u680F\u7684 `Hooks\uFF08\u94A9\u5B50\uFF09`\u2192 \u70B9\u51FB`\u7528\u6237\u914D\u7F6E`\uFF0C\u4FE1\u4EFB `UserPromptSubmit`\u3001`SessionStart` \u548C `Stop` \u91CC\u7684 `aliyunrds/ctxdb` \u94A9\u5B50\u3002"
 ].join("\n");
+var FULL_APP_RESTART_REMINDERS = {
+  qoder: "Next action: \u8BF7\u5B8C\u5168\u9000\u51FA\u5E76\u91CD\u65B0\u542F\u52A8 Qoder\uFF08\u4E0D\u662F\u53EA\u5173\u95ED\u5F53\u524D\u5BF9\u8BDD\uFF09\uFF0C\u4F7F\u65B0\u7684 hooks \u548C skill \u751F\u6548\u3002",
+  qoderwork: "Next action: \u8BF7\u5B8C\u5168\u9000\u51FA\u5E76\u91CD\u65B0\u542F\u52A8 QoderWork\uFF08\u4E0D\u662F\u53EA\u5173\u95ED\u5F53\u524D\u5BF9\u8BDD\uFF09\uFF0C\u4F7F\u65B0\u7684 hooks \u548C skill \u751F\u6548\u3002",
+  qwenwork: "Next action: \u8BF7\u5B8C\u5168\u9000\u51FA\u5E76\u91CD\u65B0\u542F\u52A8 QwenWork\uFF08\u4E0D\u662F\u53EA\u5173\u95ED\u5F53\u524D\u5BF9\u8BDD\uFF09\uFF0C\u4F7F\u65B0\u7684 hooks \u548C skill \u751F\u6548\u3002"
+};
+function printPostSetupReminder(agent) {
+  const restartReminder = FULL_APP_RESTART_REMINDERS[agent];
+  if (restartReminder) {
+    process.stderr.write(`
+${dim(restartReminder)}
+`);
+  }
+  if (agent === "codex") {
+    process.stderr.write(`
+${dim(CODEX_HOOKS_TRUST_REMINDER)}
+`);
+  }
+}
 function parseAgent(args) {
   const raw = args.flags.agent;
   if (raw === void 0) return "default";
@@ -2158,23 +2215,25 @@ async function setup(args) {
     });
     printResult(result2, json);
     if (!json && result2.hints) {
-      for (const hint of result2.hints) process.stderr.write(`
-${hint}
+      for (const hint of result2.hints) {
+        process.stderr.write(`
+${highlightInlineCode(hint)}
 `);
+      }
     }
-    if (!json && result2.agents.codex?.ok) {
-      process.stderr.write(
-        `
-${dim(CODEX_HOOKS_TRUST_REMINDER)}
-`
-      );
+    if (!json) {
+      for (const agent2 of ["qoder", "qoderwork", "qwenwork", "codex"]) {
+        if (result2.agents[agent2]?.ok) {
+          printPostSetupReminder(agent2);
+        }
+      }
     }
     return result2.ok ? 0 : 1;
   }
   const agent = parseAgent(args);
   if (agent === "default" && !json && !configuredAgents().includes("default")) {
     process.stderr.write(
-      `hint: creating CLI-only "default" agent (no hooks/skills). Use --agent <claude|qoder|qoderwork|codex|opencode|hermes> for full setup.
+      `hint: creating CLI-only "default" agent (no hooks/skills). Use --agent <claude|qoder|qoderwork|qwenwork|codex|opencode|hermes> for full setup.
 `
     );
   }
@@ -2188,16 +2247,14 @@ ${dim(CODEX_HOOKS_TRUST_REMINDER)}
   });
   printResult(result, json);
   if (!json && result.hints) {
-    for (const h of result.hints) process.stderr.write(`
-${h}
+    for (const h of result.hints) {
+      process.stderr.write(`
+${highlightInlineCode(h)}
 `);
+    }
   }
-  if (!json && agent === "codex" && result.ok) {
-    process.stderr.write(
-      `
-${dim(CODEX_HOOKS_TRUST_REMINDER)}
-`
-    );
+  if (!json && result.ok) {
+    printPostSetupReminder(agent);
   }
   return result.ok ? 0 : 1;
 }
@@ -2206,11 +2263,11 @@ ${dim(CODEX_HOOKS_TRUST_REMINDER)}
 var HELP2 = `ctxdb uninstall \u2014 remove hooks + skills
 
 USAGE
-  ctxdb uninstall [--agent <qoder|qoderwork|codex|claude|opencode|hermes>] [--purge-config] [--purge-logs] [--purge-all] [--json]
+  ctxdb uninstall [--agent <qoder|qoderwork|qwenwork|codex|claude|opencode|hermes>] [--purge-config] [--purge-logs] [--purge-all] [--json]
 
 DEFAULT BEHAVIOR (no --agent, no purge flags)
   Strips ctxdb hook entries and skill directories for ALL agents (qoder,
-  qoderwork, codex, claude, opencode, hermes). Keeps ~/.ctxdb/ctxdb.json (credentials) and ~/.ctxdb/logs/
+  qoderwork, qwenwork, codex, claude, opencode, hermes). Keeps ~/.ctxdb/ctxdb.json (credentials) and ~/.ctxdb/logs/
   so you can re-run \`ctxdb setup\` later without losing configuration.
 
 WITH --agent <name>
@@ -2218,7 +2275,7 @@ WITH --agent <name>
   Other agents remain untouched.
 
 FLAGS
-  --agent <name>   Target a single agent (qoder|qoderwork|codex|claude|opencode|hermes)
+  --agent <name>   Target a single agent (qoder|qoderwork|qwenwork|codex|claude|opencode|hermes)
   --purge-config   Also delete ~/.ctxdb/ctxdb.json
   --purge-logs     Also delete ~/.ctxdb/logs/
   --purge-all      Delete everything under ~/.ctxdb/
@@ -2270,7 +2327,7 @@ ${h}
 var HELP3 = `ctxdb upgrade \u2014 refresh skills + hooks
 
 USAGE
-  ctxdb upgrade [--agent <qoder|qoderwork|codex|claude|opencode|hermes>] [--no-self-update] [--json]
+  ctxdb upgrade [--agent <qoder|qoderwork|qwenwork|codex|claude|opencode|hermes>] [--no-self-update] [--json]
 
 BEHAVIOR
   Pulls the latest @aliyunrds/ctxdb package from npm, then re-runs setup
@@ -2280,7 +2337,7 @@ BEHAVIOR
   With --agent:    sets up only the specified agent.
 
 FLAGS
-  --agent <name>   Target a single agent (qoder|qoderwork|codex|claude|opencode|hermes)
+  --agent <name>   Target a single agent (qoder|qoderwork|qwenwork|codex|claude|opencode|hermes)
   --self-update    Pull latest package from npm (enabled by default)
   --no-self-update Skip the npm package update and only re-run setup
   --json           Machine-readable JSON output
@@ -2408,7 +2465,8 @@ function skillInstall(args) {
   }
   const TARGET_TEMPLATE_AGENT = {
     qodercn: "qoder",
-    qoderworkcn: "qoderwork"
+    qoderworkcn: "qoderwork",
+    qwenworkcn: "qwenwork"
   };
   const templateAgent = TARGET_TEMPLATE_AGENT[target] ?? (target && isBuiltinAgent(target) ? target : "default");
   const result = installSkillsTo(targetRoot, templateAgent);
@@ -2670,6 +2728,163 @@ async function kbSearch(args) {
   return 0;
 }
 
+// src/cli/debug-cli.ts
+import {
+  readRecallTraces
+} from "@aliyunrds/ctxdb-shared";
+var CONTROL_HELP = `ctxdb debug enable|disable \u2014 control local recall tracing
+
+USAGE
+  ctxdb debug enable [--agent=<name>] [--json]
+  ctxdb debug disable [--agent=<name>] [--json]
+
+Debug is forced on when the final CTXDB base URL is not the official
+production URL. A forced profile cannot be disabled until its endpoint changes.
+`;
+var RECALL_HELP = `ctxdb debug recall \u2014 replay local recall traces
+
+USAGE
+  ctxdb debug recall (--session=<id> | --event=<id>) [--full] [--json]
+
+Reads ~/.ctxdb/logs/recall-trace.jsonl and its rotated generations.
+An unmatched recall.start means the hook was interrupted or terminated before
+recall.finish; it is not a completed timeout outcome.
+`;
+function resultFor(agent, changed) {
+  const cfg = load({ agent });
+  return {
+    ok: true,
+    agent,
+    debug: cfg.debug,
+    debug_configured: cfg.debugConfigured,
+    debug_forced: cfg.debugForced,
+    debug_reason: cfg.debugReason,
+    changed
+  };
+}
+function printControlResult(result, json) {
+  if (json) {
+    process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+    return;
+  }
+  const configured = result.debug_configured ? "enabled" : "disabled";
+  const effective = result.debug ? "enabled" : "disabled";
+  const forced = result.debug_forced ? "yes" : "no";
+  process.stdout.write(
+    `ctxdb debug (${result.agent}): ${effective}
+  configured: ${configured}
+  forced: ${forced}
+  reason: ${result.debug_reason ?? "-"}
+`
+  );
+}
+async function controlDebug(args, configured) {
+  if (args.flags.help || args.flags.h) {
+    process.stdout.write(CONTROL_HELP);
+    return 0;
+  }
+  const agent = agentFromFlags(args.flags);
+  const current = load({ agent });
+  if (!hasConfiguredAgent(agent)) {
+    const hint = agent === "default" ? "run `ctxdb setup --api-key=<key>` or select a configured --agent" : `run \`ctxdb setup --agent ${agent}\` first`;
+    process.stderr.write(`no configured profile for agent ${agent}; ${hint}
+`);
+    return 1;
+  }
+  if (!configured && current.debugForced) {
+    const result2 = {
+      ok: false,
+      agent,
+      debug: current.debug,
+      debug_configured: current.debugConfigured,
+      debug_forced: current.debugForced,
+      debug_reason: current.debugReason,
+      changed: false
+    };
+    if (args.flags.json) {
+      process.stdout.write(`${JSON.stringify(result2, null, 2)}
+`);
+    } else {
+      process.stderr.write(
+        `cannot disable debug for ${agent}: debug is forced by non-production base_url (reason: ${current.debugReason})
+`
+      );
+      printControlResult(result2, false);
+    }
+    return 1;
+  }
+  const changed = current.debugConfigured !== configured;
+  if (!updateConfiguredDebug(agent, configured)) {
+    process.stderr.write(`failed to update debug for agent ${agent}
+`);
+    return 1;
+  }
+  const result = resultFor(agent, changed);
+  printControlResult(result, Boolean(args.flags.json));
+  return 0;
+}
+function debugEnable(args) {
+  return controlDebug(args, true);
+}
+function debugDisable(args) {
+  return controlDebug(args, false);
+}
+function compactRecord(record) {
+  const base = `${record.timestamp} ${record.agent}/${record.kind} ${record.type} event=${record.recall_event_id} session=${record.session_id ?? "-"}`;
+  if (record.type === "recall.start") {
+    return `${base} query_chars=${record.query.length}`;
+  }
+  return `${base} outcome=${record.outcome} duration_ms=${record.duration_ms} returned=${record.returned_memories.length} selected=${record.selection.selected.length} knowledge=${record.returned_knowledge.length}`;
+}
+async function debugRecall(args) {
+  if (args.flags.help || args.flags.h) {
+    process.stdout.write(RECALL_HELP);
+    return 0;
+  }
+  const session = typeof args.flags.session === "string" && args.flags.session ? args.flags.session : null;
+  const event = typeof args.flags.event === "string" && args.flags.event ? args.flags.event : null;
+  if (session && event || !session && !event) {
+    process.stderr.write(
+      "exactly one of --session=<id> or --event=<id> is required\n"
+    );
+    return 2;
+  }
+  const result = readRecallTraces({
+    ...session ? { sessionId: session } : { recallEventId: event }
+  });
+  const output = {
+    ok: true,
+    selector: session ? { session } : { event },
+    count: result.records.length,
+    malformed_lines: result.malformedLines,
+    records: result.records
+  };
+  if (args.flags.json) {
+    process.stdout.write(`${JSON.stringify(output, null, 2)}
+`);
+    return 0;
+  }
+  if (result.records.length === 0) {
+    process.stdout.write("No matching recall traces.\n");
+    return 0;
+  }
+  if (args.flags.full) {
+    process.stdout.write(`${JSON.stringify(result.records, null, 2)}
+`);
+  } else {
+    process.stdout.write(`${result.records.map(compactRecord).join("\n")}
+`);
+  }
+  if (result.malformedLines > 0) {
+    process.stderr.write(
+      `skipped ${result.malformedLines} malformed recall trace line(s)
+`
+    );
+  }
+  return 0;
+}
+
 // src/cli/main.ts
 var HELP5 = `ctxdb v${PACKAGE_VERSION} \u2014 RDS ContextDatabase CLI (multi-agent)
 
@@ -2677,7 +2892,7 @@ USAGE
   ctxdb <command> [args] [--flags]
 
 COMMANDS
-  setup [--agent <qoder|qoderwork|codex|claude|opencode|hermes> | --all]
+  setup [--agent <qoder|qoderwork|qwenwork|codex|claude|opencode|hermes> | --all]
         [--api-key=K] [--base-url=URL] [--user-id=ID]
         [--no-install-skill] [--no-validate] [--json]
                                  Without --agent \u2192 writes agents.default (CLI-only, no hooks/skills)
@@ -2706,6 +2921,10 @@ COMMANDS
   upgrade|update [--agent <name>] [--no-self-update] [--json]
                                  Pull latest package from npm, then re-run
                                  setup. Self-update is enabled by default.
+  debug enable|disable [--agent <name>] [--json]
+                                 Control configured debug for an existing profile.
+  debug recall (--session=<id> | --event=<id>) [--full] [--json]
+                                 Replay local full-fidelity recall traces.
 
   memory add <text> [--agent=<name>] [--user-id=...] [--metadata=K1=V1,K2=V2] [--no-infer]
   memory search <query> [--agent=<name>] [--top-k=10] [--threshold=0.4] [--knowledge]
@@ -2740,7 +2959,7 @@ COMMANDS
                                  doc_id?/tags? for citation.
                                  --raw: server response verbatim (curl parity).
 
-  skill install --target <qoder|qoderwork|codex|claude|opencode|openclaw|hermes> [--json]
+  skill install --target <qoder|qoderwork|qwenwork|codex|claude|opencode|openclaw|hermes> [--json]
   skill install --path <dir> [--json]
                                  Install skill files (contextdb-memory,
                                  contextdb-knowledge) to an agent's skill directory.
@@ -2763,7 +2982,7 @@ HOOK ENV VARS:
                               Direct ctxdb CLI commands are unchanged.
 
 CONFIG: ~/.ctxdb/ctxdb.json (agents.default / agents.qoder / agents.qoderwork / agents.codex / agents.claude / agents.opencode / agents.hermes)
-LOGS:   ~/.ctxdb/logs/ctxdb.log
+LOGS:   ~/.ctxdb/logs/ctxdb.log, ~/.ctxdb/logs/recall-trace.jsonl
 `;
 var ROUTES = {
   setup,
@@ -2773,6 +2992,11 @@ var ROUTES = {
   teardown: uninstall,
   upgrade,
   update: upgrade,
+  debug: {
+    enable: debugEnable,
+    disable: debugDisable,
+    recall: debugRecall
+  },
   skill: {
     install: skillInstall
   },