@aliyunrds/ctxdb 1.0.9-beta.1 → 1.0.10-beta.0

package/README.md

@@ -251,7 +251,7 @@ ctxdb setup --agent qwenwork --api-key ctxdb-...
 ctxdb setup --agent codex --api-key ctxdb-...
 # Claude Code (hooks + skill)
 ctxdb setup --agent claude --api-key ctxdb-...
-# WorkBuddy (Claude-Code-isomorphic hooks + skill)
+# WorkBuddy (JSON hooks, full shell command + skill)
 ctxdb setup --agent workbuddy --api-key ctxdb-...
 # OpenCode (plugin shim + skill)
 ctxdb setup --agent opencode --api-key ctxdb-...
@@ -309,7 +309,7 @@ ctxdb status --agent codex --json
 
 Setup first checks that the target agent home exists (`~/.qoder`, `~/.qoderwork`, `~/.qwenwork`, `~/.codex`, `~/.claude`, or either WorkBuddy home: `~/.workbuddy` / `~/.workbuddy-ai`; other declared CN variant homes also satisfy this check). Setup writes hooks and skills into every existing home, so a CN-only install does not create the international product home, and vice versa. If no home exists, install or start that agent once before running `ctxdb setup --agent <name>`. OpenCode and Hermes are config-dir style: setup creates `~/.config/opencode` / `~/.hermes` when they are missing.
 
-For **qoder**, **qoderwork**, **qwenwork**, **codex**, **claude**, and **workbuddy**, restart the harness (CLI: just exit + restart; app: Cmd+R or quit/relaunch) so it picks up the new hooks/skill. For **codex**, setup also writes `[features].hooks = true` into `~/.codex/config.toml` (creating the file if missing) — Codex won't fire any hook entries without it. On first use Codex may prompt you to trust the new hook commands. For **opencode**, restart OpenCode so it loads `~/.config/opencode/plugins/ctxdb.ts`. For **hermes**, setup also checks `~/.hermes/shell-hooks-allowlist.json`; it reports setup as incomplete until both ctxdb hook commands are approved.
+For **qoder**, **qoderwork**, **qwenwork**, **codex**, **claude**, and **workbuddy**, restart the harness (CLI: just exit + restart; app: Cmd+R or quit/relaunch) so it picks up the new hooks/skill. For **codex**, setup also writes `[features].hooks = true` into `~/.codex/config.toml` (creating the file if missing) — Current Codex versions enable hooks by default; the explicit setting also supports older installs. Review and trust each installed or changed hook definition in `/hooks` before use. For **opencode**, restart OpenCode so it loads `~/.config/opencode/plugins/ctxdb.ts`. For **hermes**, setup also checks `~/.hermes/shell-hooks-allowlist.json`; it reports setup as incomplete until both ctxdb hook commands are approved.
 
 Hermes owns this security allowlist, so ctxdb only checks it and never writes approvals. Approve the ctxdb `pre_llm_call` and `post_llm_call` hooks with:
 
@@ -364,6 +364,8 @@ For **qoder**, **qoderwork**, **qwenwork**, **codex**, **claude**, and **workbud
 
 Implementation note: qoder/Claude/WorkBuddy 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.
 
+WorkBuddy 5.5.2 on macOS requires the full shell command in `command`; its runner ignores `args`. Native Auto (default routing label; underlying model unknown) and explicitly selected GPT-5.6-Sol completed automatic Skill Evaluate, suggestion delivery, generation, Upload/Complete, and exact Load. The final package also passed cold-cache Load for both versions. Sol required one native Retry after a platform error; Auto's extra execution was not proven fully isolated. Windows runner behavior and Memory capture/recall were not tested in this acceptance run. See the [Agent/model acceptance report](../../docs/skill-agent-acceptance-20260912.md) and [WorkBuddy evidence](../../docs/workbuddy-acceptance-20260912.md) for version scope, retained failures, and cleanup.
+
 For **opencode**, `ctxdb setup --agent opencode` copies the self-contained plugin bundle to `~/.config/opencode/plugins/ctxdb-bundle.js` and writes a re-export shim at `~/.config/opencode/plugins/ctxdb.ts` referencing it via the relative path `./ctxdb-bundle.js` (Bun on Windows can't resolve absolute-path specifiers from a .ts shim). `ctxdb upgrade --agent opencode` re-copies the bundle + refreshes the shim.
 
 For **hermes**, `ctxdb setup --agent hermes` writes two shell hooks under `~/.hermes/config.yaml`:
@@ -653,6 +655,63 @@ Output semantics worth knowing:
   incomplete by design (deleted endpoints are omitted); relation items always
   keep denormalized endpoint names.
 
+### Knowledge graph create, update and delete
+
+These six commands operate on entities and relations **inside a knowledge base**.
+`kb create/update/delete` manages the knowledge base itself; `memory entity`
+manages memory entities. Graph mutations use the existing DATA API credentials
+selected by `--agent` / `CTXDB_AGENT`, and require graph write permission.
+
+| Command | DATA API |
+|---|---|
+| `kb entity-create` / `kb entity-update` / `kb entity-delete` | POST / PUT / DELETE `/v1/knowledge/entities` |
+| `kb relation-create` / `kb relation-update` / `kb relation-delete` | POST / PUT / DELETE `/v1/knowledge/entity-relations` |
+
+Every command requires `--kb=<kb-id>` (an ID, not a name). Updates and deletes
+require `--entity-id` or `--relation-id`; names, positional locators and bulk
+selectors are not accepted. Find IDs with `entities` and `relations --verbose`.
+Creates return the new ID; entity renaming preserves that ID and updates incident
+relation names. Relation updates cannot change the endpoints or relation ID.
+
+```sh
+ctxdb kb entity-create --kb=<kb-id> --name=ContextDB --type=Product \
+  --description='Context database' --aliases-json='["ctxdb"]' --json
+ctxdb kb entity-get --kb=<kb-id> --entity-id=<id> --verbose --json
+ctxdb kb entity-update --kb=<kb-id> --entity-id=<id> --name=ContextDB --type=Product \
+  --description='' --aliases-json='[]' --json
+
+ctxdb kb relation-create --kb=<kb-id> --source-entity-id=<a> --target-entity-id=<b> \
+  --relation-type=USES --description='' --keywords-json='[]' --weight=1 --json
+ctxdb kb relations --kb=<kb-id> --verbose --json
+ctxdb kb relation-update --kb=<kb-id> --relation-id=<id> \
+  --relation-type=CALLS --description='' --keywords-json='["api"]' --weight=0.5 --json
+
+# Irreversible: delete a relation; both endpoint entities remain.
+ctxdb kb relation-delete --kb=<kb-id> --relation-id=<id> --yes --json
+# Irreversible: delete an entity and ALL its incoming/outgoing relations.
+ctxdb kb entity-delete --kb=<kb-id> --entity-id=<id> --yes --json
+```
+
+Create and update require every editable field shown above. **Update is a full
+replacement**, so read the current values before editing. Explicitly use
+`--description=''` or `--aliases-json='[]'` / `--keywords-json='[]'` to clear a
+field. Arrays must contain strings; `--weight` must be finite, with the server
+enforcing its 0–1 range and other business limits.
+
+Deletion requires the bare `--yes` switch in both terminals and scripts; without
+it, or with `--yes=false`, the CLI exits 2 without sending a delete request.
+The CLI does not prompt interactively. Entity deletion returns the server's
+`deleted`, `deleted_entity_count` and `deleted_relation_count`. Relation deletion
+returns `deleted` and its IDs; its API does not return counts. A `deleted: false`
+result is printed and exits 1, never reported as successful deletion.
+
+Default output preserves the complete mutation `data`; `--json` formats that as
+JSON and `--raw` retains the Box envelope. HTTP and business errors (including
+HTTP 200 with a failing `errorCode`) exit nonzero even with `--raw`. Missing IDs,
+malformed lists and incomplete arguments exit 2 with usage. A second delete of
+an already deleted ID returns the server's not-found error; mutations are not
+automatically retried after an uncertain response.
+
 ### Knowledge review commands
 
 `kb review` covers the Knowledge Review DATA APIs: review-queue handling
@@ -776,6 +835,7 @@ Lives at `~/.ctxdb/ctxdb.json` (co-located with logs at `~/.ctxdb/logs/`). Schem
       "base_url": "https://api.cn-hangzhou.agentcontext.aliyuncs.com",
       "user_id": "default",
       "auto_capture": true,
+      "auto_skill_evolution": true,
       "auto_recall": true,
       "warmup_recall": false,
       "recall_knowledge": false,
@@ -804,6 +864,7 @@ Field reference:
 | `agent_id` | str | null | Optional scope dimension on every capture/recall call. **Default null = not sent** — the server counts `agent_id` as scope on the search path, so emitting it by default would narrow every existing user's recall. Set only when you want per-agent isolation: `CTXDB_AGENT_ID=<id>` (env-only; no setup flag) |
 | `app_id` | str | null | Optional app-scope dimension, same contract as `agent_id` (default null = not sent). Set via `CTXDB_APP_ID=<id>` (env-only) |
 | `auto_capture` | bool | `true` | End-of-turn hook/plugin captures each turn into long-term memory for the selected agent |
+| `auto_skill_evolution` | bool | `true` | Evidence collection and automatic evolution through the selected Agent hooks/plugin. Hermes delivers ready suggestions on the next genuine user turn. Disabling it keeps private Skill discovery and explicit commands available. |
 | `auto_recall` | bool | `true` | UserPromptSubmit hook recalls memory on each user prompt 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 |
@@ -909,6 +970,36 @@ Maintainer-facing docs (source layout, dev/test workflows, server-config archive
 
 Apache-2.0
 
+
+## Private Skills and evolution
+
+`ctxdb skill` provides `manifest`, `sync`, `search`, `load`, `validate`, `upload`, `evaluate`, `disable`, `rollback`, `delete`, `config`, `status` and `purge`. Generic entry templates are installed by `skill install`; private packages remain under the authenticated scope in `~/.ctxdb/skills/`.
+
+Codex startup and Resume refresh a stable private Skill directory. Compact restores it from disk; `sync` returns refreshed context as well as updating disk. The Agent selects relevant Skills and calls Load when needed. Search runs on the server. Skill lifecycle adapters also cover Claude/Qoder/WorkBuddy, Hermes and OpenCode; see the Agent acceptance report for the tested versions and host limitations.
+
+Normal business Stops accumulate projected evidence across turns. At 10 distinct tool calls or 40,960 buffered UTF-8 bytes, a complete checkpoint submits an asynchronous Evaluate. Raw tool bodies and hidden thinking are excluded; no local LLM summarizes the trace. SessionEnd does not force a submission. Resume and genuine user prompts query results. Suggestion delivery follows each host adapter: Codex and Hermes defer it to a genuine user turn. The current Agent reviews evidence, edits a separate draft, validates it and publishes within existing authorization. Maintenance Stops skip collection, queries and delivery. There is no background Author or completion receipt.
+
+```sh
+ctxdb skill bind --agent codex --session-id <host-session-id> --json
+ctxdb skill sync --session <binding-id> --json
+ctxdb skill search "SQL diagnostics" --session <binding-id> --json
+ctxdb skill load --skill-id <id> --editable --session <binding-id> --json
+ctxdb skill validate <draft-directory> --json
+ctxdb skill upload <draft-directory> --source evolution --skill-id <id> --base-version-id <base> --session <binding-id> --json
+ctxdb skill status --resume --session <binding-id> --json
+```
+
+Bindings pin endpoint and credential reference; the server verifies Workspace/Member. Credential rotation must resolve to the same identity. Binding files contain no API Key. Conversations use `--session <binding_id>`; terminal commands can select an existing `--agent` connection.
+
+Packages are limited to 50 MiB compressed, 50 MiB expanded, 200 files and 256 KiB for root SKILL.md. Load reauthorizes cache access and checks ZIP plus extracted files. Upload has its own frozen ZIP and request ID, independent of Evaluate. Before submitting changed draft contents, resolve any previous unknown upload outcome. Exact Version/Hash readback confirms publication; a failed Manifest refresh is retried separately without republishing.
+
+For private Skills, `disable --skill-id <id>` retains history but blocks discovery, Load and new publication; this release has no re-enable command. `rollback --skill-id <id> --version-id <target> --base-version-id <current>` requires an available historical version and the expected Active version; `--revoke-reason <reason>` also revokes the previous Active. `delete --skill-id <id>` revokes and cleans up the Skill, including disabled Skills.
+
+New automatic collection and Evaluate submissions require both local `auto_skill_evolution` and the effective server switch. Server switches cover global, cloud-account and Workspace scopes with a 30-second cache. Disabling a server switch stops new automatic Evaluate admissions; accepted tasks keep polling and may deliver results and publish through Upload/Complete. Local `auto_skill_evolution=false` still pauses automatic delivery and evolution uploads on that client. Manual evaluation and explicit imports retain normal authorization and package checks. `status --resume` retries frozen submissions/uploads and queries results; it does not generate files. `delivery_uncertain` requires inspecting the conversation, without automatic redelivery.
+
+The 256 MiB cache never evicts automatically. `skill purge --cache` previews cache cleanup; stop related sessions/transfers before adding `--apply`. Default purge removes only verified upload payloads, keeping small idempotency receipts. Drafts and unresolved uploads are retained. Evidence/artifacts have a separate 100 MiB budget: pending tails expire after 7 days, successful/consumed payloads after 7 days, failed/oversized evidence after 30 days. Resume and status check expiry while preserving cursors and unresolved recovery bytes.
+
+Codex 0.153.4 has completed the automatic lifecycle against a local test center/object store, including draft generation, upload and exact Version/Hash readback. The deployed ContextDB → XA → OSS path and real central model still require separate acceptance. Claude Code, Qoder, Qwen Code and Hermes automatic adapters are deferred. Codex tools must have authorized network access to the configured ContextDB and object-store endpoints; Hook connectivity alone is insufficient.
 上传时可用 `ctxdb kb upload-text` 或 `ctxdb kb upload-file` 的 `--review-enabled` / `--no-review-enabled` 覆盖本次文档评审开关；不传时沿用服务端默认，不修改知识库策略。两标志互斥，分片上传保留同一选择。上传回执不代表评审或入库完成，应查询实际状态。
 
 `memory get <fact-id> --verbose` 通过原生 Fact 详情接口读取状态、关联实体 ID、来源及参考/记录时间；默认 `memory get` 的 mem0 输出保持兼容。召回统计可从同一身份的 `memory list` 中按 ID 对应读取。

package/dist/{chunk-U4DRH4NZ.js → chunk-5HPYYOPH.js}

@@ -2,7 +2,7 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "./chunk-V7IZ2UYJ.js";
+} from "./chunk-VMBCSFGF.js";
 
 // src/lib/user-prompt-submit-compose.ts
 async function composeUserPromptSubmit(cfg, agent, client, prompt, sessionId = null) {
@@ -20,8 +20,7 @@ async function composeUserPromptSubmit(cfg, agent, client, prompt, sessionId = n
 ${kbBlock}` : kbBlock;
   return { ctx, recall, kbBlock };
 }
-function formatUserPromptSubmitStdout(agent, ctx) {
-  if (agent === "codex") return ctx + "\n";
+function formatUserPromptSubmitStdout(_agent, ctx) {
   const out = {
     hookSpecificOutput: {
       hookEventName: "UserPromptSubmit",

package/dist/chunk-LASAMQQY.js

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+import {
+  isCircuitOpen,
+  isConnectionError,
+  resetCircuit,
+  tripCircuit
+} from "./chunk-XWJAZAMN.js";
+import {
+  CtxdbError,
+  debug,
+  extractSkillSignals,
+  isDataApiReady,
+  isDebug,
+  readTranscript,
+  selectTurnRows,
+  toKbDetectionMessages,
+  toParsedMessages
+} from "./chunk-TZFDXKLJ.js";
+
+// src/lib/capture-orchestrator.ts
+import {
+  filterMessagesForExtraction,
+  isKnowledgeBaseUploadTurn,
+  selectTurnMessages
+} from "@aliyunrds/ctxdb-shared";
+
+// src/lib/git-context.ts
+import { execSync } from "child_process";
+function getGitContext() {
+  try {
+    const raw = execSync("git rev-parse --show-toplevel --abbrev-ref HEAD", {
+      encoding: "utf-8",
+      timeout: 3e3,
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    const lines = raw.split("\n");
+    if (lines.length < 2) return null;
+    const project = lines[0].split(/[/\\]/).pop();
+    if (!project) return null;
+    const branch = lines[1];
+    return { project, branch };
+  } catch {
+    return null;
+  }
+}
+
+// src/lib/capture-orchestrator.ts
+async function captureTurn(transcriptPath, cfg, client, agent = "default", sessionId) {
+  const preflight = capturePreflight(cfg, agent);
+  if (preflight) return preflight;
+  const rows = readTranscript(transcriptPath);
+  if (rows.length === 0) {
+    return { captured: false, reason: "empty_transcript", messageCount: 0 };
+  }
+  const dbg = isDebug();
+  if (dbg) debug("capture", "transcript rows", summarizeTranscriptRows(rows));
+  const parsed = toParsedMessages(rows);
+  if (parsed.length === 0) {
+    return {
+      captured: false,
+      reason: `transcript_schema_mismatch: rows=${rows.length} parsed=0`,
+      messageCount: 0
+    };
+  }
+  const turnRows = selectTurnRows(rows);
+  if (dbg) debug("capture", "current turn rows", summarizeTranscriptRows(turnRows));
+  return captureParsedMessages(parsed, cfg, client, agent, sessionId, {
+    kbDetectionMessages: toKbDetectionMessages(turnRows),
+    skills: extractSkillSignals(rows)
+  });
+}
+async function captureParsedMessages(parsed, cfg, client, agent = "default", sessionId, options = {}) {
+  const preflight = capturePreflight(cfg, agent);
+  if (preflight) return preflight;
+  if (parsed.length === 0) {
+    return { captured: false, reason: "empty_messages", messageCount: 0 };
+  }
+  const dbg = isDebug();
+  if (dbg) debug("capture", "parsed messages", summarizeTextMessages(parsed));
+  const turn = selectTurnMessages(parsed);
+  if (dbg) debug("capture", "selected turn", summarizeTextMessages(turn));
+  if (turn.length === 0) {
+    return { captured: false, reason: "empty_turn_slice", messageCount: 0 };
+  }
+  if (!turn.some((m) => m.role === "user")) {
+    return { captured: false, reason: "no_user_in_turn", messageCount: 0 };
+  }
+  const AUTOMATED_REVIEW_PREFIX = "[SYSTEM: This is an automated background review task. It is NOT a user message.";
+  const userMsgs = turn.filter((m) => m.role === "user");
+  if (userMsgs.every((m) => m.content.startsWith(AUTOMATED_REVIEW_PREFIX))) {
+    return { captured: false, reason: "automated_review_skip", messageCount: 0 };
+  }
+  const kb = isKnowledgeBaseUploadTurn(options.kbDetectionMessages);
+  if (kb.detected) {
+    return {
+      captured: false,
+      reason: `b3c_skip: ${kb.reason ?? "(no reason)"}`,
+      messageCount: 0
+    };
+  }
+  const rawMessages = turn.map((m) => ({ role: m.role, content: m.content }));
+  const filtered = filterMessagesForExtraction(rawMessages);
+  if (dbg) debug("capture", "filtered messages", summarizeTextMessages(filtered));
+  if (filtered.length === 0) {
+    return { captured: false, reason: "all_filtered", messageCount: 0 };
+  }
+  const git = getGitContext();
+  const skills = options.skills ?? [];
+  const bg = {};
+  if (git) bg.git = git;
+  if (skills.length > 0) bg.skills = skills.map(
+    ({ skill, trigger, args }) => args ? { skill, trigger, args } : { skill, trigger }
+  );
+  const hasBackground = Boolean(bg.git || bg.skills);
+  if (hasBackground) debug("capture", "background", bg);
+  const messages = hasBackground ? [{ role: "background", content: JSON.stringify(bg) }, ...filtered] : filtered;
+  const payload = {
+    messages,
+    user_id: cfg.userId,
+    async_mode: true
+  };
+  if (cfg.agentId) payload.agent_id = cfg.agentId;
+  if (cfg.appId) payload.app_id = cfg.appId;
+  if (sessionId) payload.run_id = sessionId;
+  let resp;
+  try {
+    resp = await client.postJson("/v3/memories/add/", payload);
+    resetCircuit(agent);
+  } catch (err) {
+    const msg = err instanceof CtxdbError ? err.message : String(err);
+    if (isConnectionError(err)) tripCircuit(agent, cfg.baseUrl, msg);
+    return {
+      captured: false,
+      reason: `http_error: ${msg}`,
+      messageCount: filtered.length
+    };
+  }
+  return {
+    captured: true,
+    reason: "ok",
+    serverResponse: resp,
+    messageCount: filtered.length
+  };
+}
+function capturePreflight(cfg, agent) {
+  if (!isDataApiReady(cfg)) {
+    return { captured: false, reason: "config_incomplete", messageCount: 0 };
+  }
+  if (!cfg.autoCapture) {
+    return { captured: false, reason: "auto_capture_disabled", messageCount: 0 };
+  }
+  if (isCircuitOpen(agent, cfg.baseUrl)) {
+    return { captured: false, reason: `circuit_open: ${cfg.baseUrl}`, messageCount: 0 };
+  }
+  return null;
+}
+var DEBUG_TAIL_LIMIT = 25;
+var DEBUG_TEXT_LIMIT = 240;
+var DEBUG_BLOCK_LIMIT = 8;
+function summarizeTextMessages(messages) {
+  return {
+    count: messages.length,
+    roles: countRoles(messages),
+    tail: tailWithIndex(messages).map(({ index, item }) => ({
+      index,
+      parsedIndex: typeof item.index === "number" ? item.index : void 0,
+      role: item.role ?? "(unknown)",
+      content: summarizeText(item.content)
+    }))
+  };
+}
+function summarizeTranscriptRows(rows) {
+  return {
+    count: rows.length,
+    tail: tailWithIndex(rows).map(({ index, item: row }) => ({
+      index,
+      type: row.type,
+      role: rowRole(row),
+      isMeta: row.isMeta === true || void 0,
+      payloadType: row.payload?.type,
+      content: summarizeRowContent(row)
+    }))
+  };
+}
+function tailWithIndex(items) {
+  const start = Math.max(0, items.length - DEBUG_TAIL_LIMIT);
+  return items.slice(start).map((item, offset) => ({ index: start + offset, item }));
+}
+function countRoles(messages) {
+  const counts = {};
+  for (const msg of messages) {
+    const role = msg.role ?? "(unknown)";
+    counts[role] = (counts[role] ?? 0) + 1;
+  }
+  return counts;
+}
+function rowRole(row) {
+  const msgRole = row.message && typeof row.message === "object" ? row.message.role : void 0;
+  if (typeof msgRole === "string") return msgRole;
+  const payloadRole = row.payload && typeof row.payload === "object" ? row.payload.role : void 0;
+  return typeof payloadRole === "string" ? payloadRole : void 0;
+}
+function summarizeRowContent(row) {
+  if (row.type === "response_item") {
+    const p = row.payload;
+    if (!p || typeof p !== "object") return { kind: "missing" };
+    if (p.type === "function_call") {
+      return {
+        kind: "function_call",
+        name: p.name,
+        arguments: summarizeText(p.arguments)
+      };
+    }
+    return summarizeContent(p.content);
+  }
+  return summarizeContent(row.message?.content);
+}
+function summarizeContent(content) {
+  if (typeof content === "string") return summarizeText(content);
+  if (!Array.isArray(content)) {
+    return { kind: content === void 0 ? "missing" : typeof content };
+  }
+  return {
+    kind: "blocks",
+    count: content.length,
+    blocks: content.slice(0, DEBUG_BLOCK_LIMIT).map((block) => summarizeBlock(block)),
+    truncated: content.length > DEBUG_BLOCK_LIMIT || void 0
+  };
+}
+function summarizeBlock(block) {
+  if (!block || typeof block !== "object") return { kind: typeof block };
+  const b = block;
+  const summary = { type: b.type };
+  if (typeof b.name === "string") summary.name = b.name;
+  if (typeof b.text === "string") summary.text = summarizeText(b.text);
+  if (typeof b.thinking === "string") summary.thinking = summarizeText(b.thinking);
+  if (typeof b.content === "string") summary.content = summarizeText(b.content);
+  const input = b.input;
+  if (input && typeof input === "object" && !Array.isArray(input)) {
+    const i = input;
+    summary.inputKeys = Object.keys(i).sort();
+    if (typeof i.command === "string") summary.command = summarizeText(i.command);
+  }
+  return summary;
+}
+function summarizeText(text) {
+  if (typeof text !== "string") return { kind: text === void 0 ? "missing" : typeof text };
+  const normalized = text.replace(/\s+/g, " ").trim();
+  return {
+    kind: "text",
+    length: text.length,
+    snippet: normalized.length > DEBUG_TEXT_LIMIT ? `${normalized.slice(0, DEBUG_TEXT_LIMIT)}...` : normalized
+  };
+}
+
+export {
+  captureTurn,
+  captureParsedMessages
+};

package/dist/{chunk-3MEBQDGU.js → chunk-QUPLZ7KF.js}

@@ -4,9 +4,9 @@ import {
 } from "./chunk-5ITT5GSP.js";
 
 // src/lib/self-update.ts
-import { spawnSync } from "child_process";
-import { fileURLToPath } from "url";
-import { dirname } from "path";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname } from "node:path";
 import semver from "semver";
 var NPM_VIEW_TIMEOUT_MS = 1e4;
 function npmCommand(platform = process.platform) {
@@ -149,8 +149,8 @@ function runSelfUpdate(currentVersion, passthroughArgs = [], options = {}) {
 }
 
 // src/lib/update-notifier.ts
-import { randomUUID } from "crypto";
-import { spawn } from "child_process";
+import { randomUUID } from "node:crypto";
+import { spawn } from "node:child_process";
 import {
   mkdirSync,
   readFileSync,
@@ -159,9 +159,9 @@ import {
   statSync,
   unlinkSync,
   writeFileSync
-} from "fs";
-import { homedir } from "os";
-import { dirname as dirname2, join } from "path";
+} from "node:fs";
+import { homedir } from "node:os";
+import { dirname as dirname2, join } from "node:path";
 import semver2 from "semver";
 var VERSION_CHECK_SCHEMA = 1;
 var SUCCESS_TTL_MS = 24 * 60 * 60 * 1e3;

package/dist/{chunk-FD3IPF6R.js → chunk-SG4LQTOF.js}

@@ -2,14 +2,14 @@
 import {
   fetchKbCatalogBlock,
   recallTurn
-} from "./chunk-V7IZ2UYJ.js";
+} from "./chunk-VMBCSFGF.js";
 import {
   debug
-} from "./chunk-2U7G6UXE.js";
+} from "./chunk-TZFDXKLJ.js";
 
 // src/lib/warmup-recall.ts
-import { execSync } from "child_process";
-import { basename } from "path";
+import { execSync } from "node:child_process";
+import { basename } from "node:path";
 function collectGitSignals(cwd) {
   const result = { branch: "", recentCommits: [] };
   try {

package/dist/{chunk-T5ZJEPR4.js → chunk-SZ3AZDMU.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CtxdbError
-} from "./chunk-2U7G6UXE.js";
+} from "./chunk-TZFDXKLJ.js";
 
 // src/lib/kb.ts
 import {
@@ -10,10 +10,10 @@ import {
   existsSync,
   openAsBlob,
   statSync
-} from "fs";
-import { basename, extname } from "path";
-import { homedir } from "os";
-import { resolve } from "path";
+} from "node:fs";
+import { basename, extname } from "node:path";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
 import {
   buildNormalizedGraphContext,
   extractKnowledgeBaseIds,