@aliyunrds/ctxdb 0.0.10 → 1.0.0-beta.1

package/README.md

@@ -55,7 +55,7 @@ For **qoder**, **qoderwork**, **codex**, and **claude**, hooks fire automaticall
 
 Implementation note: qoder/Claude consume the JSON `hookSpecificOutput.additionalContext` shape; Codex has been verified on this machine through `~/.codex/hooks.json`, `[features].hooks = true`, and hook audit logs, where non-empty stdout from `UserPromptSubmit`/`SessionStart` is treated as injected context. The same hook core is shared; setup passes `--agent=<name>` so each hook reads its own config section.
 
-For **opencode**, `ctxdb setup --agent opencode` writes a small re-export shim at `~/.config/opencode/plugins/ctxdb.ts`. The shim points into this package's bundled `dist/opencode/src/index.ts`, so `npm update -g @aliyunrds/ctxdb` updates the plugin implementation without copying source into the user config directory. `ctxdb upgrade --agent opencode` refreshes the absolute shim target after package moves.
+For **opencode**, `ctxdb setup --agent opencode` writes a small re-export shim at `~/.config/opencode/plugins/ctxdb.ts`. The shim points into this package's bundled `dist/opencode/index.js`, so `npm update -g @aliyunrds/ctxdb` updates the plugin implementation without copying source into the user config directory. `ctxdb upgrade --agent opencode` refreshes the absolute shim target after package moves.
 
 ## CLI
 
@@ -95,7 +95,7 @@ Lives at `~/.ctxdb/ctxdb.json` (co-located with logs at `~/.ctxdb/logs/`). Schem
       "user_id": "default",
       "auto_capture": true,
       "auto_recall": true,
-      "warmup_recall": true,
+      "warmup_recall": false,
       "recall_knowledge": false,
       "top_k": 5,
       "threshold": 0.4,
@@ -119,7 +119,7 @@ Field reference:
 | `user_id` | str | `"default"` | mem0-layer bucket key on every capture/recall call. The server's tenant isolation runs on `member_id` (injected from `X-API-Key`), so this is an optional per-user/agent slice. Override with `ctxdb setup --agent <a> --user-id <bucket>` or `CTXDB_USER_ID=<bucket>` when you need to isolate this install from another access layer or machine sharing the same workspace |
 | `auto_capture` | bool | `true` | Stop hook captures each turn into long-term memory for the selected agent |
 | `auto_recall` | bool | `true` | UserPromptSubmit hook recalls memory on each user prompt for the selected agent |
-| `warmup_recall` | bool | `true` | SessionStart hook recalls cwd/git-related memories for the selected agent |
+| `warmup_recall` | bool | `false` | SessionStart hook recalls cwd/git-related memories for the selected agent. **Default is off** — open it per-agent when you want session-start warmup (adds one bounded, circuit-protected recall call on session start) |
 | `recall_knowledge` | bool | `false` | When `auto_recall` is on, also pull KB chunks alongside memory. Default is **off** — the recommended KB-recall path is the agent calling `kb search --agent <name>` explicitly when the user asks |
 | `top_k` / `threshold` | int / float | `5` / `0.4` | Memory recall pagination + similarity floor. `5` keeps the codex TUI `hook context: ...` line short enough to scan and bounds token spend on the modal recall path; raise it per-agent if you want more candidates |
 | `knowledge_top_k` | int | `6` | KB chunks pulled per recall (only effective when `recall_knowledge: true`) |
@@ -132,7 +132,7 @@ Env-var overrides apply to the selected agent config (env wins): `CTXDB_AGENT` /
 ```
 @aliyunrds/ctxdb            ← this package (CLI + setup + hooks + skills)
        │
-       ├─ bundles OpenCode plugin source in dist/opencode/src
+       ├─ bundles OpenCode plugin in dist/opencode/index.js
        │
        └─ depends on @aliyunrds/ctxdb-shared  ← input sanitation,
                                           prompt-injection defenses,

package/dist/{chunk-XWPTIFUK.js → chunk-PLWEIEFH.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   configDir
-} from "./chunk-F25Q3WM4.js";
+} from "./chunk-QHYJ7OXC.js";
 
 // src/lib/circuit.ts
 import { statSync, writeFileSync, unlinkSync, mkdirSync, readdirSync, readFileSync } from "fs";

package/dist/{chunk-F25Q3WM4.js → chunk-QHYJ7OXC.js}

@@ -285,6 +285,7 @@ function agentHomeDir(agent) {
   }
 }
 var AGENT_VARIANT_HOMES = {
+  qoder: [".qoder-cn"],
   qoderwork: [".qoderworkcn"]
 };
 function agentHomeDirs(agent) {

package/dist/{chunk-I5HRGFZO.js → chunk-QPFFMW52.js}

@@ -6,10 +6,10 @@ import {
   isConnectionError,
   resetCircuit,
   tripCircuit
-} from "./chunk-XWPTIFUK.js";
+} from "./chunk-PLWEIEFH.js";
 import {
   CtxdbError
-} from "./chunk-F25Q3WM4.js";
+} from "./chunk-QHYJ7OXC.js";
 
 // src/lib/recall-orchestrator.ts
 import {

package/dist/cli/main.js

@@ -31,7 +31,7 @@ import {
   removeAgent,
   save,
   writeInstalledPkgVersion
-} from "../chunk-F25Q3WM4.js";
+} from "../chunk-QHYJ7OXC.js";
 
 // src/cli/util.ts
 var BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
@@ -115,6 +115,9 @@ var BOLD = "\x1B[1m";
 var RESET = "\x1B[0m";
 var CHECK = `${GREEN}\u2714${RESET}`;
 var CROSS = `${RED}\u2718${RESET}`;
+function dim(text) {
+  return `${DIM}${text}${RESET}`;
+}
 function isSetupResult(v) {
   if (typeof v !== "object" || v === null) return false;
   return "steps" in v && Array.isArray(v.steps);
@@ -279,6 +282,24 @@ var LEGACY_QODER_SKILL_DIRS = [
   "qoder-ctxdb"
 ];
 var HOOK_EVENTS = ["UserPromptSubmit", "Stop", "SessionStart"];
+var MIN_NODE_MAJOR = 20;
+function parseNodeMajor(version) {
+  const match = /^v?(\d+)/.exec(version.trim());
+  if (!match) return null;
+  const major = Number.parseInt(match[1], 10);
+  return Number.isFinite(major) ? major : null;
+}
+function checkCurrentNodeVersion() {
+  const version = process.versions.node;
+  const major = parseNodeMajor(version);
+  if (major !== null && major >= MIN_NODE_MAJOR) return null;
+  const current = version.startsWith("v") ? version : `v${version}`;
+  return {
+    step: "check-node-version",
+    ok: false,
+    detail: `Node.js >=${MIN_NODE_MAJOR} is required by ctxdb; current ${current} at ${process.execPath}. Switch to Node 20+ (for example: \`nvm install 20 && nvm use 20\`), reinstall @aliyunrds/ctxdb, then rerun \`ctxdb setup\`.`
+  };
+}
 async function runSetup(options) {
   const steps = [];
   if (!isAgentSlug(options.agent)) {
@@ -292,6 +313,11 @@ async function runSetup(options) {
   const agent = options.agent;
   const installSkill = options.installSkill !== false;
   const validate = options.validate !== false;
+  const nodeVersionCheck = checkCurrentNodeVersion();
+  if (nodeVersionCheck) {
+    steps.push(nodeVersionCheck);
+    return { ok: false, steps };
+  }
   if (isBuiltinAgent(agent)) {
     const homeCheck = checkAgentHome(agent);
     steps.push(homeCheck);
@@ -418,7 +444,7 @@ async function runSetup(options) {
       steps.push({
         step: "install-opencode-shim",
         ok: false,
-        detail: "could not resolve plugin entry under @aliyunrds/ctxdb/dist/opencode/src"
+        detail: "could not resolve plugin entry under @aliyunrds/ctxdb/dist/opencode"
       });
       return { ok: false, steps };
     }
@@ -789,7 +815,7 @@ function checkHookNodePaths(agent) {
             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")) {
+            if (parts.length >= 2 && !parts[0].endsWith(".js") && !parts[0].endsWith(".ts") && (parts[0].includes("/") || parts[0].includes("\\"))) {
               nodePath = parts[0];
             }
           }
@@ -1021,6 +1047,7 @@ function copySkillDir(src, dest, agent) {
 }
 var SKILL_INSTALL_TARGETS = {
   qoder: join(homedir(), ".qoder", "skills"),
+  qodercn: join(homedir(), ".qoder-cn", "skills"),
   qoderwork: join(homedir(), ".qoderwork", "skills"),
   qoderworkcn: join(homedir(), ".qoderworkcn", "skills"),
   codex: join(homedir(), ".codex", "skills"),
@@ -1090,7 +1117,7 @@ function resolveOpencodePluginEntry() {
   const pkgRoot = walkUpToPackageJson(here, "@aliyunrds/ctxdb");
   if (!pkgRoot) return null;
   const candidates = [
-    join(pkgRoot, "dist", "opencode", "src", "index.ts"),
+    join(pkgRoot, "dist", "opencode", "index.js"),
     join(pkgRoot, "..", "opencode", "src", "index.ts")
   ];
   return candidates.find((candidate) => existsSync(candidate)) ?? null;
@@ -1123,7 +1150,8 @@ var TOOL_SCOPED_EVENTS = /* @__PURE__ */ new Set(["PreToolUse", "PostToolUse"]);
 function appendOne(hooks, event, command, agent) {
   if (!Array.isArray(hooks[event])) hooks[event] = [];
   const useExecForm = agent === "claude";
-  const shellCmd = process.platform === "win32" ? `"${process.execPath.replace(/\\/g, "/")}" "${command.replace(/\\/g, "/")}" --agent=${agent}` : `${process.execPath} ${command} --agent=${agent}`;
+  const cmdRunner = agent === "qoder";
+  const shellCmd = process.platform === "win32" ? cmdRunner ? `node ${command.replace(/\\/g, "/")} --agent=${agent}` : `"${process.execPath.replace(/\\/g, "/")}" "${command.replace(/\\/g, "/")}" --agent=${agent}` : `${process.execPath} ${command} --agent=${agent}`;
   const dup = hooks[event].some(
     (entry2) => Array.isArray(entry2?.hooks) && entry2.hooks.some(
       (h) => h?.type === "command" && (Array.isArray(h.args) && h.args[0] === command || typeof h.command === "string" && h.command.includes(command))
@@ -1462,7 +1490,7 @@ function upgradeOneAgent(agent) {
       steps.push({
         step: "refresh-opencode-shim",
         ok: false,
-        detail: "could not resolve plugin entry under @aliyunrds/ctxdb/dist/opencode/src"
+        detail: "could not resolve plugin entry under @aliyunrds/ctxdb/dist/opencode"
       });
       return { ok: false, steps };
     }
@@ -1594,6 +1622,13 @@ async function setup(args) {
 ${h}
 `);
   }
+  if (!json && agent === "codex" && result.ok) {
+    process.stderr.write(
+      `
+${dim("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")}
+`
+    );
+  }
   return result.ok ? 0 : 1;
 }
 
@@ -1887,7 +1922,11 @@ function skillInstall(args) {
     }
     targetRoot = resolved;
   }
-  const templateAgent = target && isBuiltinAgent(target) ? target : "default";
+  const TARGET_TEMPLATE_AGENT = {
+    qodercn: "qoder",
+    qoderworkcn: "qoderwork"
+  };
+  const templateAgent = TARGET_TEMPLATE_AGENT[target] ?? (target && isBuiltinAgent(target) ? target : "default");
   const result = installSkillsTo(targetRoot, templateAgent);
   const ok = result.ok;
   const output = {

package/dist/hooks/session-start.js

@@ -2,11 +2,11 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "../chunk-I5HRGFZO.js";
+} from "../chunk-QPFFMW52.js";
 import "../chunk-6S5RJYBC.js";
 import {
   isCircuitOpen
-} from "../chunk-XWPTIFUK.js";
+} from "../chunk-PLWEIEFH.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
@@ -14,7 +14,7 @@ import {
   isComplete,
   load,
   setDebug
-} from "../chunk-F25Q3WM4.js";
+} from "../chunk-QHYJ7OXC.js";
 
 // src/hooks/session-start.ts
 import { pathToFileURL } from "url";

package/dist/hooks/stop.js

@@ -4,7 +4,7 @@ import {
   isConnectionError,
   resetCircuit,
   tripCircuit
-} from "../chunk-XWPTIFUK.js";
+} from "../chunk-PLWEIEFH.js";
 import {
   CtxdbError,
   HttpClient,
@@ -13,7 +13,7 @@ import {
   isDebug,
   load,
   setDebug
-} from "../chunk-F25Q3WM4.js";
+} from "../chunk-QHYJ7OXC.js";
 
 // src/lib/capture-orchestrator.ts
 import {

package/dist/hooks/user-prompt-submit.js

@@ -2,11 +2,11 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "../chunk-I5HRGFZO.js";
+} from "../chunk-QPFFMW52.js";
 import "../chunk-6S5RJYBC.js";
 import {
   isCircuitOpen
-} from "../chunk-XWPTIFUK.js";
+} from "../chunk-PLWEIEFH.js";
 import {
   HttpClient,
   agentFromArgvWithFallback,
@@ -14,7 +14,7 @@ import {
   isComplete,
   load,
   setDebug
-} from "../chunk-F25Q3WM4.js";
+} from "../chunk-QHYJ7OXC.js";
 
 // src/hooks/user-prompt-submit.ts
 import { pathToFileURL } from "url";