@jacklika/dsh-memory-curator 0.1.0-alpha.7 → 0.1.0-alpha.9

package/README.md

@@ -5,7 +5,7 @@ Curator tools for the DSH memory vault. This package is a member of the `@jackli
 ## Tools
 
 - `memory_recall(query)` — Search the vault for prior notes before starting a task. Returns `{ query, hits, total }`, where `total` is the vault-wide match count passed through from `wiki_search` and can exceed `hits.length` when the search layer caps its results — so a caller can tell "these are all the matches" from "there are more".
-- `memory_capture(title, summary, ...)` — Persist durable knowledge after significant work, with conflict detection and optional user approval.
+- `memory_capture(title, summary, ...)` — Persist durable knowledge after significant work, with conflict detection and optional user approval. Returns `{ written, id, mode, conflict, version, created?, updated?, committed? }`: `version` is the SHA-1 of the persisted note text, `created` is present on first capture, `updated` is present on appends, and `committed` is present when `memory-git` completed the commit.
 
 ## Note ids
 

package/README.zh.md

@@ -5,7 +5,7 @@ DSH 记忆库的策展工具。本包是 `@jacklika/dsh-memory` Bundle 的成员
 ## 工具
 
 - `memory_recall(query)` — 在任务开始前搜索知识库中的相关笔记。返回 `{ query, hits, total }`，其中 `total` 是从 `wiki_search` 透传的全库命中数，在搜索层截断结果时可能大于 `hits.length`——调用方因此能区分“这就是全部命中”与“还有更多”。
-- `memory_capture(title, summary, ...)` — 在有意义的任务结束后持久化知识，支持冲突检测与可选的用户审批。
+- `memory_capture(title, summary, ...)` — 在有意义的任务结束后持久化知识，支持冲突检测与可选的用户审批。返回 `{ written, id, mode, conflict, version, created?, updated?, committed? }`：`version` 是持久化笔记文本的 SHA-1 指纹；首次入库返回 `created`；追加写入返回 `updated`；挂载 `memory-git` 完成提交时还会返回 `committed`。
 
 ## 笔记 id
 

package/lib/index.js

@@ -180,6 +180,7 @@ export function apply(ctx, config) {
             // any auto-capture hits made it into the capped `hits` list, remove them
             // from the total so curated numbers stay truthful.
             const total = search.total - (search.hits.length - curated.length);
+            ctx.logger?.debug(`memory-curator: recall query=${args.query} hits=${curated.length} total=${total}`);
             return {
                 query: args.query,
                 hits: curated.slice(0, 20),
@@ -291,21 +292,30 @@ export function apply(ctx, config) {
             const appendContent = `${args.summary}${detailsText}\n`;
             const appending = conflictExists && mode === 'append';
             const writeMode = appending ? 'append' : 'overwrite';
+            ctx.logger?.debug(`memory-curator: capture target=${finalId} conflicts=${conflicts.length} writeMode=${writeMode}`);
             const frontmatter = appending ? undefined : await overwriteFrontmatter(ctx, exec, finalId, args.title, tags, now);
             const content = appending
                 ? appendContent
                 : `---\n${yaml.dump(frontmatter).trim()}\n---\n\n# ${args.title}\n\n${appendContent}`;
-            await callTool(ctx, exec, 'wiki_write', {
+            const writeResult = await callTool(ctx, exec, 'wiki_write', {
                 id: finalId,
                 content,
                 mode: writeMode,
             });
-            return {
+            const response = {
                 written: true,
                 id: finalId,
                 mode: writeMode,
                 conflict: conflictExists,
+                version: writeResult.version,
             };
+            if (typeof writeResult.created === 'string' && writeResult.created !== '')
+                response.created = writeResult.created;
+            if (typeof writeResult.updated === 'string' && writeResult.updated !== '')
+                response.updated = writeResult.updated;
+            if (typeof writeResult.committed === 'boolean')
+                response.committed = writeResult.committed;
+            return response;
         },
     })));
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jacklika/dsh-memory-curator",
   "description": "Curator tools for the DSH memory vault: memory_recall before acting and memory_capture after significant work, with conflict detection and optional user approval.",
-  "version": "0.1.0-alpha.7",
+  "version": "0.1.0-alpha.9",
   "publishConfig": {
     "access": "public"
   },