dominds 1.23.0 → 1.23.2

package/dist/tools/ctrl.js

@@ -18,7 +18,7 @@
  * - change_mind: Main Dialog only; update a `.tsk/` Taskdoc section without starting a new course
  * - mind_more: Main Dialog only; append entries to a `.tsk/` Taskdoc section without starting a new course
  * - never_mind: Main Dialog only; delete a `.tsk/` Taskdoc section file without starting a new course
- * - recall_taskdoc: Read a Taskdoc section from `*.tsk/` by (category, selector)
+ * - recall_taskdoc: Read a Taskdoc section from `*.tsk/` by selector and optional category
  *
  * USAGE CONTEXT:
  * Can both be triggered by an agent autonomously, or by human with role='user' msg,
@@ -372,8 +372,8 @@ function getCtrlMessages(language) {
             invalidFormatDoMind: '参数格式不对。用法：do_mind({ selector: string, category?: string, content: string })',
             invalidFormatChangeMind: '参数格式不对。用法：change_mind({ selector: string, category?: string, content: string, previous_content_hash: string })',
             tooManyArgsChangeMind: '参数格式不对。用法：change_mind({ selector: string, category?: string, content: string, previous_content_hash: string })',
-            taskDocPreviousContentHashRequired: '错误：change_mind 需要 previous_content_hash。请先基于已注入的顶层差遣牒内容或 recall_taskdoc 返回的 content_hash，合并原有内容后再整段替换；没有把握时用 mind_more 追加小条目。',
-            taskDocPreviousContentHashInvalid: '错误：previous_content_hash 格式无效。它必须是 recall_taskdoc 或已注入差遣牒状态中显示的 sha256:<64位十六进制> content_hash。',
+            taskDocPreviousContentHashRequired: '错误：change_mind 需要 previous_content_hash。请先调用 recall_taskdoc 显式取得当前章节的 content_hash，合并原有内容后再整段替换；没有把握时用 mind_more 追加小条目。',
+            taskDocPreviousContentHashInvalid: '错误：previous_content_hash 格式无效。它必须是 recall_taskdoc 返回的 crc32:<8位十六进制> content_hash。',
             taskDocContentHashMismatch: (relativePath, currentContentHash) => `错误：${relativePath} 的内容哈希不匹配，说明该章节已变化或你没有基于当前内容改写。\n` +
                 `当前 content_hash：${currentContentHash}\n\n` +
                 `请重新读取/回顾当前章节内容，并只在已充分合并原有内容后重试。若新内容会冲掉、删除或实质替换原有内容，必须满足其一：\n` +
@@ -384,7 +384,7 @@ function getCtrlMessages(language) {
             invalidFormatNeverMind: '参数格式不对。用法：never_mind({ selector: string, category?: string })',
             mindMoreItemsRequired: '需要提供要追加的条目（items），且每一项都必须是非空字符串。\n' +
                 '示例：mind_more({"items":["- 下一步：复核验证结果（详见 <文档路径>#<章节>）","- 阻塞：等待 API 验收口径确认"]})',
-            invalidFormatRecallTaskdoc: '参数格式不对。用法：recall_taskdoc({ category: string, selector: string })',
+            invalidFormatRecallTaskdoc: '参数格式不对。用法：recall_taskdoc({ selector: string, category?: string })',
             taskDocContentRequired: '需要提供差遣牒内容（content）。\n' +
                 '示例：\n' +
                 '```json\n' +
@@ -397,15 +397,14 @@ function getCtrlMessages(language) {
             pathMustBeWithinWorkspace: '路径必须位于 rtws（运行时工作区）内',
             invalidTaskDocPath: (taskDocPath) => `差遣牒路径 '${taskDocPath}' 无效。应为 *.tsk/ 目录。`,
             selectorRequired: '需要提供选择器（selector）。',
-            categoryRequired: '需要提供章节目录（category）。',
             invalidSelector: (selector) => `选择器 '${selector}' 无效。可用：顶层 goals | constraints | progress；bearinmind 下 contracts | acceptance | grants | runbook | decisions | risks；或任意标识符（如 ux.checklist）。`,
             invalidCategory: (category) => `目录名 '${category}' 无效。需匹配 ^[a-zA-Z][a-zA-Z0-9_-]*(\\.[a-zA-Z0-9_-]*)*$。`,
             invalidCategorySelector: (selector) => `选择器 '${selector}' 无效。需匹配 ^[a-zA-Z][a-zA-Z0-9_-]*(\\.[a-zA-Z0-9_-]*)*$。`,
             topLevelSelectorRequiresNoCategory: (category, selector) => `选择器 '${selector}' 是顶层保留分段（goals/constraints/progress），不能与 category='${category}' 一起用。`,
             bearInMindSelectorRequiresBearInMindCategory: (category, selector) => `选择器 '${selector}' 只能在 category='bearinmind' 下用（当前 category='${category}'）。`,
-            taskDocSectionAlreadyExists: (relativePath) => `无法新增：${relativePath} 已存在。若确有把握要改写已有章节，请先取得当前 content_hash，再使用 change_mind({"selector":"<selector>","content":"...","previous_content_hash":"sha256:..."})。`,
+            taskDocSectionAlreadyExists: (relativePath) => `无法新增：${relativePath} 已存在。若确有把握要改写已有章节，请先用 recall_taskdoc 取得当前 content_hash，再使用 change_mind({"selector":"<selector>","content":"...","previous_content_hash":"crc32:..."})。`,
             taskDocSectionChangeMissing: (relativePath) => `无法修改：${relativePath} 不存在。若要新增章节，请使用 do_mind({ ... })。`,
-            taskDocSectionMissing: (relativePath) => `未找到：${relativePath}。\n\n新增章节请使用 do_mind；已有章节追加小条目用 mind_more；改写已有章节用 change_mind 并带上当前 content_hash：\n- do_mind({"category":"<category>","selector":"<selector>","content":"..."})\n- mind_more({"category":"<category>","selector":"<selector>","items":["..."]})\n- change_mind({"category":"<category>","selector":"<selector>","content":"...","previous_content_hash":"sha256:..."})`,
+            taskDocSectionMissing: (relativePath) => `未找到：${relativePath}。\n\n新增章节请使用 do_mind；已有章节追加小条目用 mind_more；改写已有章节时先用 recall_taskdoc 取得当前 content_hash，再用 change_mind 带上它：\n- do_mind({"category":"<category>","selector":"<selector>","content":"..."})\n- mind_more({"category":"<category>","selector":"<selector>","items":["..."]})\n- recall_taskdoc({"category":"<category>","selector":"<selector>"})\n- change_mind({"category":"<category>","selector":"<selector>","content":"...","previous_content_hash":"crc32:..."})`,
             taskDocSectionDeleteMissing: (relativePath) => `无法删除：${relativePath} 不存在。请先确认要删除的差遣牒章节。`,
             clearedCoursePrompt: (nextCourse) => (0, driver_messages_1.formatNewCourseStartPrompt)('zh', { nextCourse, source: 'clear_mind' }),
         };
@@ -422,8 +421,8 @@ function getCtrlMessages(language) {
         invalidFormatDoMind: 'Error: Invalid args. Use: do_mind({ selector: string, category?: string, content: string })',
         invalidFormatChangeMind: 'Error: Invalid args. Use: change_mind({ selector: string, category?: string, content: string, previous_content_hash: string })',
         tooManyArgsChangeMind: 'Error: Invalid args. Use: change_mind({ selector: string, category?: string, content: string, previous_content_hash: string })',
-        taskDocPreviousContentHashRequired: 'Error: change_mind requires previous_content_hash. Use the content_hash from the injected top-level Taskdoc section or recall_taskdoc result, merge the existing content, then replace the full section. If unsure, use mind_more for small append-only updates.',
-        taskDocPreviousContentHashInvalid: 'Error: invalid previous_content_hash. It must be the sha256:<64 hex chars> content_hash shown by recall_taskdoc or the injected Taskdoc status block.',
+        taskDocPreviousContentHashRequired: 'Error: change_mind requires previous_content_hash. Call recall_taskdoc first to get the current section content_hash, merge the existing content, then replace the full section. If unsure, use mind_more for small append-only updates.',
+        taskDocPreviousContentHashInvalid: 'Error: invalid previous_content_hash. It must be the crc32:<8 hex chars> content_hash returned by recall_taskdoc.',
         taskDocContentHashMismatch: (relativePath, currentContentHash) => `Error: content hash mismatch for \`${relativePath}\`; the section changed or your replacement was not based on the current content.\n` +
             `Current content_hash: ${currentContentHash}\n\n` +
             `Re-read/review the current section and retry only after fully merging existing content. If the new content would overwrite, delete, or materially replace existing content, one of these must be true:\n` +
@@ -434,7 +433,7 @@ function getCtrlMessages(language) {
         invalidFormatNeverMind: 'Error: Invalid args. Use: never_mind({ selector: string, category?: string })',
         mindMoreItemsRequired: 'Error: items are required, and every item must be a non-empty string.\n' +
             'Example: mind_more({"items":["- Next: review verification results (details: <doc-path>#<section>)","- Blocker: API acceptance criteria pending"]})',
-        invalidFormatRecallTaskdoc: 'Error: Invalid args. Use: recall_taskdoc({ category: string, selector: string })',
+        invalidFormatRecallTaskdoc: 'Error: Invalid args. Use: recall_taskdoc({ selector: string, category?: string })',
         taskDocContentRequired: 'Error: Taskdoc content is required (content).\n' +
             'Copy/paste example:\n' +
             '```json\n' +
@@ -447,15 +446,14 @@ function getCtrlMessages(language) {
         pathMustBeWithinWorkspace: 'Error: Path must be within rtws (runtime workspace)',
         invalidTaskDocPath: (taskDocPath) => `Error: Invalid Taskdoc path '${taskDocPath}'. Expected a \`*.tsk/\` directory.`,
         selectorRequired: 'Error: selector is required.',
-        categoryRequired: 'Error: category is required.',
         invalidSelector: (selector) => `Error: Invalid selector '${selector}'. Use: top-level goals|constraints|progress; under bearinmind: contracts|acceptance|grants|runbook|decisions|risks; or any identifier (e.g. \`ux.checklist\`).`,
         invalidCategory: (category) => `Error: Invalid category '${category}'. Must match \`^[a-zA-Z][a-zA-Z0-9_-]*(\\.[a-zA-Z0-9_-]+)*$\`.`,
         invalidCategorySelector: (selector) => `Error: Invalid category selector '${selector}'. Must match \`^[a-zA-Z][a-zA-Z0-9_-]*(\\.[a-zA-Z0-9_-]+)*$\`.`,
         topLevelSelectorRequiresNoCategory: (category, selector) => `Error: Selector '${selector}' is reserved for top-level sections (goals/constraints/progress) and must not be used with category='${category}'.`,
         bearInMindSelectorRequiresBearInMindCategory: (category, selector) => `Error: Selector '${selector}' is only valid under category='bearinmind' (got category='${category}').`,
-        taskDocSectionAlreadyExists: (relativePath) => `Cannot add: \`${relativePath}\` already exists. If you are sure you need to rewrite an existing section, get the current content_hash first, then use \`change_mind({"selector":"<selector>","content":"...","previous_content_hash":"sha256:..."})\`.`,
+        taskDocSectionAlreadyExists: (relativePath) => `Cannot add: \`${relativePath}\` already exists. If you are sure you need to rewrite an existing section, call \`recall_taskdoc\` for the current content_hash first, then use \`change_mind({"selector":"<selector>","content":"...","previous_content_hash":"crc32:..."})\`.`,
         taskDocSectionChangeMissing: (relativePath) => `Cannot change: \`${relativePath}\` does not exist. To create a new section, use \`do_mind({ ... })\`.`,
-        taskDocSectionMissing: (relativePath) => `Not found: \`${relativePath}\`.\n\nUse \`do_mind\` to create a section, \`mind_more\` for small append-only updates to existing sections, and \`change_mind\` with the current content_hash to rewrite existing sections:\n- \`do_mind({\"category\":\"<category>\",\"selector\":\"<selector>\",\"content\":\"...\"})\`\n- \`mind_more({\"category\":\"<category>\",\"selector\":\"<selector>\",\"items\":[\"...\"]})\`\n- \`change_mind({\"category\":\"<category>\",\"selector\":\"<selector>\",\"content\":\"...\",\"previous_content_hash\":\"sha256:...\"})\``,
+        taskDocSectionMissing: (relativePath) => `Not found: \`${relativePath}\`.\n\nUse \`do_mind\` to create a section, \`mind_more\` for small append-only updates to existing sections, and \`recall_taskdoc\` then \`change_mind\` with the current content_hash to rewrite existing sections:\n- \`do_mind({\"category\":\"<category>\",\"selector\":\"<selector>\",\"content\":\"...\"})\`\n- \`mind_more({\"category\":\"<category>\",\"selector\":\"<selector>\",\"items\":[\"...\"]})\`\n- \`recall_taskdoc({\"category\":\"<category>\",\"selector\":\"<selector>\"})\`\n- \`change_mind({\"category\":\"<category>\",\"selector\":\"<selector>\",\"content\":\"...\",\"previous_content_hash\":\"crc32:...\"})\``,
         taskDocSectionDeleteMissing: (relativePath) => `Cannot delete: \`${relativePath}\` does not exist. Check the Taskdoc section target first.`,
         clearedCoursePrompt: (nextCourse) => (0, driver_messages_1.formatNewCourseStartPrompt)('en', { nextCourse, source: 'clear_mind' }),
     };
@@ -750,7 +748,7 @@ exports.changeMindTool = {
             content: { type: 'string', description: 'New section content.' },
             previous_content_hash: {
                 type: 'string',
-                description: 'Content hash of the current section being replaced. Use the content_hash shown in the injected Taskdoc for top-level sections or returned by recall_taskdoc for extra sections.',
+                description: 'Content hash of the current section being replaced. Call recall_taskdoc first and use the returned content_hash.',
             },
         },
     },
@@ -784,7 +782,7 @@ exports.changeMindTool = {
         const previousContentHash = typeof previousContentHashValue === 'string' ? previousContentHashValue.trim() : '';
         if (!previousContentHash)
             return (0, tool_1.toolFailure)(t.taskDocPreviousContentHashRequired);
-        if (!/^sha256:[0-9a-f]{64}$/u.test(previousContentHash)) {
+        if (!/^crc32:[0-9a-f]{8}$/u.test(previousContentHash)) {
             return (0, tool_1.toolFailure)(t.taskDocPreviousContentHashInvalid);
         }
         // Taskdoc path is immutable for the dialog lifecycle.
@@ -1166,18 +1164,24 @@ exports.mindMoreTool = {
 exports.recallTaskdocTool = {
     type: 'func',
     name: 'recall_taskdoc',
-    description: 'Read one Taskdoc section by (category, selector).',
+    description: 'Read one Taskdoc section and return its content_hash.',
     descriptionI18n: {
-        en: 'Read one Taskdoc section by (category, selector).',
-        zh: '按 (category, selector) 读取一段差遣牒章节。',
+        en: 'Read one Taskdoc section and return its content_hash.',
+        zh: '读取一段差遣牒章节并返回 content_hash。',
     },
     parameters: {
         type: 'object',
         additionalProperties: false,
-        required: ['category', 'selector'],
+        required: ['selector'],
         properties: {
-            category: { type: 'string', description: 'Category directory within the Taskdoc.' },
-            selector: { type: 'string', description: 'Section selector within the category.' },
+            category: {
+                type: 'string',
+                description: 'Optional category directory within the Taskdoc. Omit for top-level goals|constraints|progress.',
+            },
+            selector: {
+                type: 'string',
+                description: 'Section selector. Top-level: goals|constraints|progress. With category: selector within that category.',
+            },
         },
     },
     argsValidation: 'dominds',
@@ -1185,9 +1189,10 @@ exports.recallTaskdocTool = {
         const language = (0, work_language_1.getWorkLanguage)();
         const t = getCtrlMessages(language);
         const categoryValue = args['category'];
-        const category = typeof categoryValue === 'string' ? categoryValue.trim() : '';
-        if (category === '')
-            return (0, tool_1.toolFailure)(t.categoryRequired);
+        if (categoryValue !== undefined && typeof categoryValue !== 'string') {
+            return (0, tool_1.toolFailure)(t.invalidFormatRecallTaskdoc);
+        }
+        const category = typeof categoryValue === 'string' ? categoryValue.trim() : undefined;
         const selectorValue = args['selector'];
         const selector = typeof selectorValue === 'string' ? selectorValue.trim() : '';
         if (selector === '')
@@ -1228,9 +1233,6 @@ exports.recallTaskdocTool = {
             }
         }
         const target = parsed.target;
-        if (target.kind === 'top_level') {
-            return (0, tool_1.toolFailure)(t.invalidFormatRecallTaskdoc);
-        }
         const relPath = (0, task_package_1.taskPackageRelativePathForChangeMindTarget)(target);
         const sectionPath = path.resolve(fullPath, relPath);
         if (!isPathWithinDirectory(sectionPath, fullPath)) {

package/dist/tools/prompts/control/en/principles.md

@@ -132,7 +132,7 @@ Taskdoc is a **task contract** and the task's **team-shared source of current tr
 
 - Keep concise: reminders are often 1-3 items; prefer `update_reminder` to compress/merge
 - Separate carriers: information that must synchronize the team's current effective state, key decisions, next steps, or still-active blockers belongs in `progress`, the quasi-real-time task bulletin board; reminders keep local resume details
-- Team-facing: keep `progress` scannable and centered on what is still effective now; do not let it degrade into a personal log, raw chronology, scratchpad, or stale history pile. Use `mind_more` for small additions and `change_mind` with the current `content_hash` as `previous_content_hash` when cleanup/reordering/compression is needed
+- Team-facing: keep `progress` scannable and centered on what is still effective now; do not let it degrade into a personal log, raw chronology, scratchpad, or stale history pile. Use `mind_more` for small additions; when cleanup/reordering/compression is needed, call `recall_taskdoc` first and then use `change_mind` with the returned `content_hash` as `previous_content_hash`
 - Condense when needed: `mind_more` is not the default bookkeeping move. If one topic already has several phase notes, prefer `change_mind` to merge them into the current summary; put the detailed expansion in formal rtws documentation and keep a document pointer in Taskdoc. If the replacement would overwrite existing content, proceed only with direct human confirmation or after applying a human-approved SOP/acceptance standard that considers the existing content
 - Collapse before clearing: the Main Dialog first records undocumented discussion details the next course needs to know into the appropriate Taskdoc sections, then creates a structured continuation-package reminder; a Side Dialog must not maintain Taskdoc or draft Taskdoc update proposals, and should directly maintain sufficiently detailed continuation-package reminders. If the current course is already under system remediation, rough multi-reminder carry-over is acceptable but must be reconciled first in the new course
 - Avoid raw-material dumps: do not paste long logs or large tool outputs into reminders
@@ -156,7 +156,7 @@ Taskdoc is a **task contract** and the task's **team-shared source of current tr
 ## Limitations and Notes
 
 1. `dialog` reminders end with the dialog; `personal` reminders stay visible in all later dialogs you lead
-2. Use `do_mind` to create missing Taskdoc sections; use `mind_more` for small Taskdoc additions; use `change_mind` for full-section replacement of existing sections after merging existing content and include the current `content_hash` as `previous_content_hash`; use `never_mind` when a whole section file should be deleted. Do not treat `mind_more` as a chronology tool; when cleanup, stale-entry removal, or same-topic consolidation is needed, use `change_mind`
+2. Use `do_mind` to create missing Taskdoc sections; use `mind_more` for small Taskdoc additions; use `change_mind` for full-section replacement of existing sections only after merging existing content and calling `recall_taskdoc` for the current `content_hash`; use `never_mind` when a whole section file should be deleted. Do not treat `mind_more` as a chronology tool; when cleanup, stale-entry removal, or same-topic consolidation is needed, use `recall_taskdoc` then `change_mind`
 3. `do_mind` / `mind_more` / `change_mind` / `never_mind` do not start a new course
 4. A continuation-package reminder should keep only details still not covered by Taskdoc but easy to lose during resume; in the Main Dialog, undocumented discussion details from current dialog history that the next course needs to know should be written to the appropriate Taskdoc sections first; in a Side Dialog under caution/critical remediation, maintain sufficiently detailed continuation-package reminders only
 5. Do not turn `personal` reminders into a long-term fact dump; move durable knowledge into `personal_memory`

package/dist/tools/prompts/control/en/scenarios.md

@@ -130,11 +130,15 @@ mind_more({
 });
 
 // Full-section replacement when cleanup, reordering, same-topic consolidation, or chronology compression is needed
+recall_taskdoc({
+  selector: 'progress',
+});
+
 change_mind({
   selector: 'progress',
   content:
     '## Progress\n\n### Current Effective State\n- The memory-carrier boundary cleanup is complete; next we strengthen the Taskdoc bulletin-board semantics; details: <doc-path>#<section>\n\n### Decisions In Effect\n- `personal_memory` is no longer treated as a short-term junk drawer\n- `team_memory` now carries only long-lived team conventions and invariants\n\n### Next Step\n- Add stronger `progress` bulletin-board guidance in control / team_mgmt manuals\n\n### Still-Active Blockers\n- None',
-  previous_content_hash: 'sha256:...',
+  previous_content_hash: 'crc32:...',
 });
 ```
 
@@ -147,11 +151,15 @@ Update task objectives.
 ### Example
 
 ```typescript
+recall_taskdoc({
+  selector: 'goals',
+});
+
 change_mind({
   selector: 'goals',
   content:
     '## Goals\n\n- [ ] Create all toolset manuals\n  - [x] ws_mod\n  - [x] team_mgmt\n  - [x] personal_memory\n  - [ ] control (In Progress)\n- [ ] Write tool descriptions',
-  previous_content_hash: 'sha256:...',
+  previous_content_hash: 'crc32:...',
 });
 ```
 
@@ -164,11 +172,15 @@ Update task constraints.
 ### Example
 
 ```typescript
+recall_taskdoc({
+  selector: 'constraints',
+});
+
 change_mind({
   selector: 'constraints',
   content:
     '## Constraints\n\n- man function must dynamically filter toolsets based on team.yaml\n- Runtime effective: Changes to team.yaml immediately visible\n- Toolset names use underscore format\n- New constraint: Each toolset needs 5 topics × 2 languages',
-  previous_content_hash: 'sha256:...',
+  previous_content_hash: 'crc32:...',
 });
 ```
 
@@ -181,6 +193,11 @@ Read taskdoc chapter content.
 ### Example
 
 ```typescript
+// Top-level sections are injected as content, but recall_taskdoc returns their content_hash
+recall_taskdoc({
+  selector: 'progress',
+});
+
 // Read bearinmind runbook
 recall_taskdoc({
   category: 'bearinmind',
@@ -204,10 +221,14 @@ Maintain taskdoc integrity and consistency, and keep `progress` as a team-scanna
 
 ```typescript
 // Update progress (keep goals / constraints / progress consistent)
+recall_taskdoc({
+  selector: 'progress',
+});
+
 change_mind({
   selector: 'progress',
   content:
     '## Progress\n\n### Current Effective State\n- The boundary wording has been propagated into handbook sources and tests; details: <doc-path>#<section>\n\n### Decisions In Effect\n- role assets / personal_memory / team_memory / Taskdoc-progress / reminders now have separated responsibilities\n\n### Next Step\n- Re-verify control manual wording, Taskdoc display text, and boundary tests\n\n### Still-Active Blockers\n- None',
-  previous_content_hash: 'sha256:...',
+  previous_content_hash: 'crc32:...',
 });
 ```

package/dist/tools/prompts/control/en/tools.md

@@ -150,7 +150,7 @@ Create a new Taskdoc section. It fails if the target section already exists.
 
 - Create-only: it does not overwrite existing content
 - Use this for missing resident sections or new extra sections that preserve details without touching existing Taskdoc text
-- If the target already exists and only needs small additions, use `mind_more`; if it needs a full rewrite/merge, use `change_mind` with the current `content_hash` as `previous_content_hash`
+- If the target already exists and only needs small additions, use `mind_more`; if it needs a full rewrite/merge, call `recall_taskdoc` first and then use `change_mind` with the returned `content_hash` as `previous_content_hash`
 - Does not start a new course
 - Changes visible to all teammates
 
@@ -163,7 +163,7 @@ Update taskdoc chapter.
 - `selector` (required): Chapter selector (goals/constraints/progress)
 - `category` (optional): Extra section directory; with `selector`, targets `<category>/<selector>.md`
 - `content` (required): New content (full section replacement)
-- `previous_content_hash` (required): The current section `content_hash` you based the replacement on
+- `previous_content_hash` (required): The current section `content_hash` returned by `recall_taskdoc`
 
 **Returns:**
 
@@ -208,7 +208,7 @@ mind_more({
 - Append-only: it does not deduplicate, rewrite, or compress old content
 - Good for adding one or two still-effective states, decisions, next steps, or blockers to `progress`
 - Not for appending every investigation step, long log, full plan, or acceptance record as a chronology; those details belong in formal rtws documentation, while Taskdoc keeps the summary and document pointer
-- If stale entries must be removed, reordered, or compressed, use `change_mind` with the current `content_hash` as `previous_content_hash` for a full-section replacement; if a whole section file should be deleted, use `never_mind`
+- If stale entries must be removed, reordered, or compressed, call `recall_taskdoc` first and then use `change_mind` with the returned `content_hash` as `previous_content_hash` for a full-section replacement; if a whole section file should be deleted, use `never_mind`
 - When one topic already has several phase notes, prefer `change_mind` to merge them into a concise current announcement instead of continuing to call `mind_more`
 
 ### 8. never_mind
@@ -223,7 +223,7 @@ Delete a Taskdoc section file.
 **Characteristics:**
 
 - Deletes only the whole section file; it does not edit content
-- Use it only when the whole section is no longer valid. If you only need to remove stale entries or compress structure, prefer `change_mind` with the cleaned full section and current `content_hash` as `previous_content_hash`
+- Use it only when the whole section is no longer valid. If you only need to remove stale entries or compress structure, prefer `recall_taskdoc` followed by `change_mind` with the cleaned full section and returned `content_hash` as `previous_content_hash`
 - Does not start a new course
 
 ### 9. recall_taskdoc
@@ -232,15 +232,16 @@ Read taskdoc chapter.
 
 **Parameters:**
 
-- `category` (required): Category directory
-- `selector` (required): Chapter selector
+- `selector` (required): Chapter selector. Omit `category` for top-level sections (`goals` / `constraints` / `progress`)
+- `category` (optional): Category directory. Use `bearinmind` for fixed bear-in-mind sections, or an extra section directory
 
 **Returns:**
 
 ```yaml
 status: ok|error
-category: <category>
 selector: <selector>
+category: <category, when supplied>
+content_hash: <crc32 checksum>
 content: <chapter content>
 retrieved_at: <retrieval timestamp>
 ```
@@ -307,17 +308,25 @@ mind_more({
 ### Replace Taskdoc Progress
 
 ```typescript
+recall_taskdoc({
+  selector: 'progress',
+});
+
 change_mind({
   selector: 'progress',
   content:
     '## Progress\n\n### Current Effective State\n- The handbook boundary split is now agreed: role assets / personal long-lived experience / Taskdoc-progress / reminders; details: <doc-path>#<section>\n\n### Decisions In Effect\n- `persona / knowhow / pitfalls` no longer absorb daily member experience\n- `personal_memory` is reserved for one member\\'s reusable long-lived experience\n\n### Next Step\n- Strengthen the bulletin-board semantics of Taskdoc `progress`\n\n### Still-Active Blockers\n- None',
-  previous_content_hash: 'sha256:...',
+  previous_content_hash: 'crc32:...',
 });
 ```
 
 ### Read Taskdoc Chapter
 
 ```typescript
+recall_taskdoc({
+  selector: 'progress',
+});
+
 recall_taskdoc({
   category: 'bearinmind',
   selector: 'runbook',

package/dist/tools/prompts/control/zh/principles.md

@@ -132,7 +132,7 @@
 
 - 保持简洁：默认提醒项常见 1–3 条，优先 `update_reminder` 压缩/合并
 - 区分载体：需要向全队同步的当前有效状态、关键决策、下一步与仍成立阻塞，写入 `progress` 这一准实时任务公告牌；提醒项只留个人/当前对话恢复所需细节
-- 面向全队：`progress` 应保持可扫读、以“当前仍有效”为准，不要退化成个人日志、流水账、临时便签或历史残影堆积；少量新增用 `mind_more`，需要清旧/重排/压缩时用 `change_mind`，并携带当前 `content_hash` 作为 `previous_content_hash`
+- 面向全队：`progress` 应保持可扫读、以“当前仍有效”为准，不要退化成个人日志、流水账、临时便签或历史残影堆积；少量新增用 `mind_more`，需要清旧/重排/压缩时先调用 `recall_taskdoc`，再用 `change_mind` 并携带返回的 `content_hash` 作为 `previous_content_hash`
 - 按需整理：`mind_more` 不是默认记账动作。若同一主题已有多条阶段性记录，优先用 `change_mind` 合并成当前摘要；把细节放进 rtws 正式文档，并在差遣牒里保留文档定位 pointer。若会冲掉原有内容，必须有直接人类确认，或已按人类认可 SOP/验收标准充分考虑原有内容后再改写
 - 换程前收束：主线对话先把尚未落实到文档、且下一程需要知会的讨论细节写入差遣牒合适章节，再整理结构化接续包提醒项；支线对话不要维护差遣牒，也不要整理差遣牒更新提案，直接维护足够详尽的接续包提醒项。若系统已把当前程切到吃紧/告急处置态，则先保留多条粗略提醒项过桥也可以；当前程只做落文档/保信息 + `clear_mind`（支线只做保信息 + `clear_mind`），系统真正开启新一程后第一步再收敛
 - 拒绝原料堆积：不要把长日志/大段 tool output 直接塞进提醒项
@@ -156,7 +156,7 @@
 ## 限制与注意事项
 
 1. `dialog` 提醒会随对话结束而结束；`personal` 提醒会在所有由你主理的后续对话里继续可见
-2. 缺失差遣牒章节用 `do_mind` 创建；差遣牒少量新增可用 `mind_more` 追加；已有章节整段替换用 `change_mind`，请确保合并已有内容并带上当前 `content_hash` 作为 `previous_content_hash`；确需删除整章文件时用 `never_mind`。不要把 `mind_more` 当流水账工具；需要整理、去旧、合并同主题记录时直接 `change_mind`
+2. 缺失差遣牒章节用 `do_mind` 创建；差遣牒少量新增可用 `mind_more` 追加；已有章节整段替换用 `change_mind`，请确保合并已有内容，并先调用 `recall_taskdoc` 取得当前 `content_hash` 作为 `previous_content_hash`；确需删除整章文件时用 `never_mind`。不要把 `mind_more` 当流水账工具；需要整理、去旧、合并同主题记录时先 `recall_taskdoc` 再 `change_mind`
 3. `do_mind` / `mind_more` / `change_mind` / `never_mind` 不开启新 course
 4. 接续包提醒项只保留差遣牒仍未覆盖、但恢复工作容易丢的细节；主线对话应先把当前对话历史中应由下一程知会的未落文档讨论细节写入差遣牒合适章节；支线对话在吃紧/告急时只维护足够详尽的接续包提醒项
 5. 不要把 `personal` 提醒堆成长期事实仓库；耐久知识应迁到 `personal_memory`

package/dist/tools/prompts/control/zh/scenarios.md

@@ -127,11 +127,15 @@ mind_more({
 });
 
 // 需要清理旧项、重排、同主题合并或压缩流水账时，整章替换
+recall_taskdoc({
+  selector: 'progress',
+});
+
 change_mind({
   selector: 'progress',
   content:
     '## Progress\n\n### 当前有效状态\n- 已完成三类记忆载体边界收口，准备补 Taskdoc 公告牌属性；细节见 <文档路径>#<章节>\n\n### 已生效决策\n- `personal_memory` 不再作为短期杂物柜\n- `team_memory` 只承接团队长期共识与不变量\n\n### 下一步\n- 在 control / team_mgmt 手册中补强 `progress` 的公告牌语义\n\n### 仍成立阻塞\n- 无',
-  previous_content_hash: 'sha256:...',
+  previous_content_hash: 'crc32:...',
 });
 ```
 
@@ -144,11 +148,15 @@ change_mind({
 ### 示例
 
 ```typescript
+recall_taskdoc({
+  selector: 'goals',
+});
+
 change_mind({
   selector: 'goals',
   content:
     '## Goals\n\n- [ ] 创建所有工具集手册\n  - [x] ws_mod\n  - [x] team_mgmt\n  - [x] personal_memory\n  - [ ] control (进行中)\n- [ ] 编写工具描述',
-  previous_content_hash: 'sha256:...',
+  previous_content_hash: 'crc32:...',
 });
 ```
 
@@ -161,11 +169,15 @@ change_mind({
 ### 示例
 
 ```typescript
+recall_taskdoc({
+  selector: 'constraints',
+});
+
 change_mind({
   selector: 'constraints',
   content:
     '## Constraints\n\n- man 函数必须根据 team.yaml 动态过滤工具集\n- 运行时生效：team.yaml 配置变更后立即可见\n- 工具集名称使用下划线格式\n- 新增约束：每个工具集需要 5 个 topic × 2 个语言',
-  previous_content_hash: 'sha256:...',
+  previous_content_hash: 'crc32:...',
 });
 ```
 
@@ -178,6 +190,11 @@ change_mind({
 ### 示例
 
 ```typescript
+// 顶层章节正文会自动注入，但 content_hash 由 recall_taskdoc 返回
+recall_taskdoc({
+  selector: 'progress',
+});
+
 // 读取 bearinmind/runbook
 recall_taskdoc({
   category: 'bearinmind',
@@ -201,10 +218,14 @@ recall_taskdoc({
 
 ```typescript
 // 更新 progress（保持 goals / constraints / progress 一致）
+recall_taskdoc({
+  selector: 'progress',
+});
+
 change_mind({
   selector: 'progress',
   content:
     '## Progress\n\n### 当前有效状态\n- 边界口径已统一到手册源头与测试；细节见 <文档路径>#<章节>\n\n### 已生效决策\n- 角色级资产 / personal_memory / team_memory / Taskdoc-progress / reminders 的职责已经切开\n\n### 下一步\n- 复验 control 手册、Taskdoc 展示文案与边界测试\n\n### 仍成立阻塞\n- 无',
-  previous_content_hash: 'sha256:...',
+  previous_content_hash: 'crc32:...',
 });
 ```

package/dist/tools/prompts/control/zh/tools.md

@@ -150,7 +150,7 @@ status: ok|error
 
 - 只创建，不覆盖已有内容
 - 适合创建缺失的常驻章节，或新增额外章节来保留细节，同时不触碰已有差遣牒正文
-- 若目标已存在且只需少量补充，用 `mind_more`；若需要整章改写/合并，用 `change_mind` 并带上当前 `content_hash` 作为 `previous_content_hash`
+- 若目标已存在且只需少量补充，用 `mind_more`；若需要整章改写/合并，先调用 `recall_taskdoc`，再用 `change_mind` 并带上返回的 `content_hash` 作为 `previous_content_hash`
 - 不开启新 course
 - 变更对所有队友可见
 
@@ -163,7 +163,7 @@ status: ok|error
 - `selector`（必需）：章节选择器（goals/constraints/progress）
 - `category`（可选）：额外章节目录；与 `selector` 组合定位 `<category>/<selector>.md`
 - `content`（必需）：新内容（整段替换）
-- `previous_content_hash`（必需）：本次替换所基于的当前章节 `content_hash`
+- `previous_content_hash`（必需）：`recall_taskdoc` 返回的当前章节 `content_hash`
 
 **返回：**
 
@@ -205,7 +205,7 @@ mind_more({
 - 只追加，不会自动去重、改写或压缩旧内容
 - 适合给 `progress` 补一两条当前仍有效的状态、决策、下一步或阻塞
 - 不适合把每一步调查过程、长日志、完整方案或验收记录当流水账追加进去；这些细节应写入 rtws 正式文档，差遣牒只写摘要和文档定位 pointer
-- 若需要删除陈旧项、重排结构或压缩公告牌，仍使用带当前 `content_hash` 作为 `previous_content_hash` 的 `change_mind` 做整章替换；若要删除整个章节文件，使用 `never_mind`
+- 若需要删除陈旧项、重排结构或压缩公告牌，先调用 `recall_taskdoc`，再使用带返回 `content_hash` 作为 `previous_content_hash` 的 `change_mind` 做整章替换；若要删除整个章节文件，使用 `never_mind`
 - 当同一主题已经有多条阶段记录时，优先 `change_mind` 合并成当前仍有效的简明公告，而不是继续 `mind_more`
 
 ### 8. never_mind
@@ -220,7 +220,7 @@ mind_more({
 **特点：**
 
 - 只删除整章文件，不做内容编辑
-- 仅用于章节整体不再成立；如果只是删除几条陈旧项或压缩结构，优先用带当前 `content_hash` 作为 `previous_content_hash` 的 `change_mind` 写回整理后的全文
+- 仅用于章节整体不再成立；如果只是删除几条陈旧项或压缩结构，优先先 `recall_taskdoc`，再用带返回 `content_hash` 作为 `previous_content_hash` 的 `change_mind` 写回整理后的全文
 - 不开启新 course
 
 ### 9. recall_taskdoc
@@ -229,15 +229,16 @@ mind_more({
 
 **参数：**
 
-- `category`（必需）：类别目录
-- `selector`（必需）：章节选择器
+- `selector`（必需）：章节选择器。顶层章节（`goals` / `constraints` / `progress`）省略 `category`
+- `category`（可选）：类别目录。固定 bear-in-mind 章节使用 `bearinmind`，其他额外章节使用对应目录
 
 **返回：**
 
 ```yaml
 status: ok|error
-category: <类别>
 selector: <选择器>
+category: <传入 category 时返回>
+content_hash: <crc32 校验值>
 content: <章节内容>
 retrieved_at: <读取时间戳>
 ```
@@ -300,17 +301,25 @@ mind_more({
 ### 整章替换差遣牒进度
 
 ```typescript
+recall_taskdoc({
+  selector: 'progress',
+});
+
 change_mind({
   selector: 'progress',
   content:
     '## Progress\n\n### 当前有效状态\n- 手册边界方案已确定：角色级资产 / 个人长期经验 / Taskdoc-progress / reminders 分流；细节见 <文档路径>#<章节>\n\n### 已生效决策\n- `persona / knowhow / pitfalls` 不承接成员日常经验\n- `personal_memory` 只承接成员自己的长期可复用经验\n\n### 下一步\n- 补齐 Taskdoc `progress` 的公告牌属性说明\n\n### 仍成立阻塞\n- 无',
-  previous_content_hash: 'sha256:...',
+  previous_content_hash: 'crc32:...',
 });
 ```
 
 ### 读取差遣牒章节
 
 ```typescript
+recall_taskdoc({
+  selector: 'progress',
+});
+
 recall_taskdoc({
   category: 'bearinmind',
   selector: 'runbook',

package/dist/utils/task-package.d.ts

@@ -107,7 +107,7 @@ export type TaskPackageChangeMindTargetParseResult = {
     kind: 'err';
     error: TaskPackageChangeMindTargetError;
 };
-export type TaskPackageContentHash = `sha256:${string}`;
+export type TaskPackageContentHash = `crc32:${string}`;
 export declare function isTaskPackagePath(taskDocPath: string): boolean;
 export declare function taskPackageSectionFromSelector(selector: string): TaskPackageSection | null;
 export declare function bearInMindSectionFromSelector(selector: string): BearInMindSection | null;

package/dist/utils/task-package.js

@@ -65,9 +65,9 @@ exports.formatEffectiveTaskDocFromSections = formatEffectiveTaskDocFromSections;
 exports.validateTaskPackageLayout = validateTaskPackageLayout;
 exports.readTaskPackageForInjection = readTaskPackageForInjection;
 exports.updateTaskPackageSection = updateTaskPackageSection;
-const crypto_1 = require("crypto");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const zlib_1 = require("zlib");
 const async_fifo_mutex_1 = require("../runtime/async-fifo-mutex");
 const taskPackageIdentifierRe = /^[a-zA-Z][a-zA-Z0-9_-]*(?:\.[a-zA-Z0-9_-]+)*$/;
 function isTaskPackageIdentifier(value) {
@@ -354,9 +354,8 @@ function withCanonicalMarkdownFileEnding(content) {
     return `${stripped}\n`;
 }
 function computeTaskPackageContentHash(content) {
-    return `sha256:${(0, crypto_1.createHash)('sha256')
-        .update(withCanonicalMarkdownFileEnding(content), 'utf8')
-        .digest('hex')}`;
+    const checksum = (0, zlib_1.crc32)(withCanonicalMarkdownFileEnding(content)) >>> 0;
+    return `crc32:${checksum.toString(16).padStart(8, '0')}`;
 }
 function taskPackageRelativePathForChangeMindTarget(target) {
     switch (target.kind) {