dominds 1.20.2 → 1.20.4

package/dist/tools/ctrl.js

@@ -2,20 +2,22 @@
 /**
  * Module: tools/ctrl
  *
- * Intrinsic dialog control tools - ALWAYS AVAILABLE TO ALL AGENTS
+ * Intrinsic dialog control tools.
  *
- * These tools are automatically included for every agent without needing to be
- * explicitly listed in team.yaml toolsets or tools configuration. They provide
- * core functionality for reminder management and mind control that should be
- * universally accessible.
+ * These tools are injected by runtime according to dialog scope without needing
+ * to be explicitly listed in team.yaml toolsets or tools configuration. Reminder
+ * and course-control tools are available in all dialog scopes; Taskdoc mutation
+ * tools are only exposed in Main Dialogs.
  *
  * INTRINSIC TOOLS:
  * - add_reminder: Add a reminder
  * - delete_reminder: Delete a reminder by id
  * - update_reminder: Update reminder content
  * - clear_mind: Start a new course, optionally add a reminder
- * - change_mind: Update a `.tsk/` Taskdoc section without starting a new course
- * - mind_more: Append entries to a `.tsk/` Taskdoc section without starting a new course
+ * - do_mind: Main Dialog only; create a new `.tsk/` Taskdoc section without starting a new course
+ * - 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)
  *
  * USAGE CONTEXT:
@@ -61,7 +63,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.recallTaskdocTool = exports.mindMoreTool = exports.changeMindTool = exports.clearMindTool = exports.updateReminderTool = exports.addReminderTool = exports.deleteReminderTool = void 0;
+exports.recallTaskdocTool = exports.mindMoreTool = exports.neverMindTool = exports.doMindTool = exports.changeMindTool = exports.clearMindTool = exports.updateReminderTool = exports.addReminderTool = exports.deleteReminderTool = void 0;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const dialog_1 = require("../dialog");
@@ -367,9 +369,11 @@ function getCtrlMessages(language) {
             reminderContentEmpty: '提醒内容不能为空',
             invalidReminderPosition: (positionHuman, totalPlusOne) => `位置 ${positionHuman} 无效。有效范围：1-${totalPlusOne}`,
             invalidFormatUpdate: '参数格式不对。用法：update_reminder({ reminder_id: string, content: string })',
+            invalidFormatDoMind: '参数格式不对。用法：do_mind({ selector: string, category?: string, content: string })',
             invalidFormatChangeMind: '参数格式不对。用法：change_mind({ selector: string, category?: string, content: string })',
             tooManyArgsChangeMind: '参数格式不对。用法：change_mind({ selector: string, category?: string, content: string })',
             invalidFormatMindMore: '参数格式不对。用法：mind_more({ items: string[], sep?: string, selector?: string, category?: string })（selector 默认 progress）',
+            invalidFormatNeverMind: '参数格式不对。用法：never_mind({ selector: string, category?: string })',
             mindMoreItemsRequired: '需要提供要追加的条目（items），且每一项都必须是非空字符串。\n' +
                 '示例：mind_more({"items":["- 下一步：复核验证结果（详见 <文档路径>#<章节>）","- 阻塞：等待 API 验收口径确认"]})',
             invalidFormatRecallTaskdoc: '参数格式不对。用法：recall_taskdoc({ category: string, selector: string })',
@@ -391,7 +395,10 @@ function getCtrlMessages(language) {
             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}'）。`,
-            taskDocSectionMissing: (relativePath) => `未找到：${relativePath}。\n\n少量追加/创建可用 mind_more；整章创建/替换用 change_mind：\n- mind_more({"category":"<category>","selector":"<selector>","items":["..."]})\n- change_mind({"category":"<category>","selector":"<selector>","content":"..."})`,
+            taskDocSectionAlreadyExists: (relativePath) => `无法新增：${relativePath} 已存在。若确有把握要改写已有章节，请使用 change_mind({ ... })。`,
+            taskDocSectionChangeMissing: (relativePath) => `无法修改：${relativePath} 不存在。若要新增章节，请使用 do_mind({ ... })。`,
+            taskDocSectionMissing: (relativePath) => `未找到：${relativePath}。\n\n新增章节请使用 do_mind；已有章节追加小条目用 mind_more；改写已有章节用 change_mind：\n- do_mind({"category":"<category>","selector":"<selector>","content":"..."})\n- mind_more({"category":"<category>","selector":"<selector>","items":["..."]})\n- change_mind({"category":"<category>","selector":"<selector>","content":"..."})`,
+            taskDocSectionDeleteMissing: (relativePath) => `无法删除：${relativePath} 不存在。请先确认要删除的差遣牒章节。`,
             clearedCoursePrompt: (nextCourse) => (0, driver_messages_1.formatNewCourseStartPrompt)('zh', { nextCourse, source: 'clear_mind' }),
         };
     }
@@ -404,9 +411,11 @@ function getCtrlMessages(language) {
         reminderContentEmpty: 'Error: Reminder content cannot be empty',
         invalidReminderPosition: (positionHuman, totalPlusOne) => `Error: Invalid reminder position ${positionHuman}. Valid range: 1-${totalPlusOne}`,
         invalidFormatUpdate: 'Error: Invalid args. Use: update_reminder({ reminder_id: string, content: string })',
+        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 })',
         tooManyArgsChangeMind: 'Error: Invalid args. Use: change_mind({ selector: string, category?: string, content: string })',
         invalidFormatMindMore: 'Error: Invalid args. Use: mind_more({ items: string[], sep?: string, selector?: string, category?: string }) (selector defaults to progress).',
+        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 })',
@@ -428,7 +437,10 @@ function getCtrlMessages(language) {
         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}').`,
-        taskDocSectionMissing: (relativePath) => `Not found: \`${relativePath}\`.\n\nUse \`mind_more\` for small append/create updates, or \`change_mind\` for full-section create/replace:\n- \`mind_more({\"category\":\"<category>\",\"selector\":\"<selector>\",\"items\":[\"...\"]})\`\n- \`change_mind({\"category\":\"<category>\",\"selector\":\"<selector>\",\"content\":\"...\"})\``,
+        taskDocSectionAlreadyExists: (relativePath) => `Cannot add: \`${relativePath}\` already exists. If you are sure you need to rewrite an existing section, use \`change_mind({ ... })\`.`,
+        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\` 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\":\"...\"})\``,
+        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' }),
     };
 }
@@ -701,10 +713,10 @@ exports.clearMindTool = {
 exports.changeMindTool = {
     type: 'func',
     name: 'change_mind',
-    description: 'Replace one shared Taskdoc section in the Main Dialog.',
+    description: 'Replace one existing shared Taskdoc section in the Main Dialog.',
     descriptionI18n: {
-        en: 'Replace one shared Taskdoc section in the Main Dialog.',
-        zh: '在主线对话中替换一段共享差遣牒章节。',
+        en: 'Replace one existing shared Taskdoc section in the Main Dialog.',
+        zh: '在主线对话中替换一段已存在的共享差遣牒章节。',
     },
     parameters: {
         type: 'object',
@@ -730,16 +742,19 @@ exports.changeMindTool = {
             const maintainerId = dlg instanceof dialog_1.SideDialog ? dlg.mainDialog.agentId : dlg.agentId;
             if (language === 'zh') {
                 return (0, tool_1.toolFailure)(`错误：\`change_mind\` 仅允许在主线对话中使用（支线对话中不可用）。\n` +
-                    `请诉请差遣牒维护人 @${maintainerId} 在其对话中执行 \`mind_more\` 或 \`change_mind\`，并提供要追加的条目或已合并好的“分段全文替换稿”（禁止覆盖/抹掉他人条目）。`);
+                    `请诉请差遣牒维护人 @${maintainerId} 在其对话中执行 \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\`，并提供要新增的章节、要追加的条目、已合并好的“分段全文替换稿”或要删除的章节（禁止覆盖/抹掉他人条目）。`);
             }
             return (0, tool_1.toolFailure)(`Error: \`change_mind\` is only available in the Main Dialog (not in Side Dialogs).\n` +
-                `Ask the Taskdoc maintainer @${maintainerId} to run \`mind_more\` or \`change_mind\` with entries to append or a fully merged full-section replacement draft (do not overwrite/delete other contributors).`);
+                `Ask the Taskdoc maintainer @${maintainerId} to run \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\` with the new section to create, entries to append, a fully merged full-section replacement draft, or the section to delete (do not overwrite/delete other contributors).`);
         }
         const selectorValue = args['selector'];
         const selector = typeof selectorValue === 'string' ? selectorValue.trim() : '';
         if (!selector)
             return (0, tool_1.toolFailure)(t.selectorRequired);
         const categoryValue = args['category'];
+        if (categoryValue !== undefined && typeof categoryValue !== 'string') {
+            return (0, tool_1.toolFailure)(t.invalidFormatChangeMind);
+        }
         const category = typeof categoryValue === 'string' ? categoryValue.trim() : undefined;
         const contentValue = args['content'];
         const newTaskDocContent = typeof contentValue === 'string' ? contentValue.trim() : '';
@@ -780,13 +795,222 @@ exports.changeMindTool = {
                 }
             }
         }
-        await (0, task_package_1.updateTaskPackageByChangeMindTarget)({
+        const result = await (0, task_package_1.updateTaskPackageByChangeMindTarget)({
             taskPackageDirFullPath: fullPath,
             target: parsed.target,
             content: newTaskDocContent,
             updatedBy: caller.id,
         });
-        return (0, tool_result_messages_1.formatToolActionResult)(language, 'mindChanged');
+        switch (result.kind) {
+            case 'updated':
+                return (0, tool_result_messages_1.formatToolActionResult)(language, 'mindChanged');
+            case 'missing':
+                return (0, tool_1.toolFailure)(t.taskDocSectionChangeMissing((0, task_package_1.taskPackageRelativePathForChangeMindTarget)(parsed.target)));
+            default: {
+                const _exhaustive = result;
+                return _exhaustive;
+            }
+        }
+    },
+};
+exports.doMindTool = {
+    type: 'func',
+    name: 'do_mind',
+    description: 'Create one new shared Taskdoc section in the Main Dialog.',
+    descriptionI18n: {
+        en: 'Create one new shared Taskdoc section in the Main Dialog.',
+        zh: '在主线对话中新增一段共享差遣牒章节。',
+    },
+    parameters: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['selector', 'content'],
+        properties: {
+            selector: {
+                type: 'string',
+                description: 'Target section selector. Top-level: goals|constraints|progress. Under category="bearinmind": contracts|acceptance|grants|runbook|decisions|risks. For other categories: any identifier.',
+            },
+            category: {
+                type: 'string',
+                description: 'Optional category directory within the Taskdoc package. When present, selector targets <category>/<selector>.md.',
+            },
+            content: { type: 'string', description: 'New section content.' },
+        },
+    },
+    argsValidation: 'dominds',
+    async call(dlg, caller, args) {
+        const language = (0, work_language_1.getWorkLanguage)();
+        const t = getCtrlMessages(language);
+        if (dlg.askerDialog !== undefined) {
+            const maintainerId = dlg instanceof dialog_1.SideDialog ? dlg.mainDialog.agentId : dlg.agentId;
+            if (language === 'zh') {
+                return (0, tool_1.toolFailure)(`错误：\`do_mind\` 仅允许在主线对话中使用（支线对话中不可用）。\n` +
+                    `请诉请差遣牒维护人 @${maintainerId} 在其对话中执行 \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\`，并提供要新增的章节、要追加的条目、已合并好的“分段全文替换稿”或要删除的章节（禁止覆盖/抹掉他人条目）。`);
+            }
+            return (0, tool_1.toolFailure)(`Error: \`do_mind\` is only available in the Main Dialog (not in Side Dialogs).\n` +
+                `Ask the Taskdoc maintainer @${maintainerId} to run \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\` with the new section to create, entries to append, a fully merged full-section replacement draft, or the section to delete (do not overwrite/delete other contributors).`);
+        }
+        const selectorValue = args['selector'];
+        const selector = typeof selectorValue === 'string' ? selectorValue.trim() : '';
+        if (!selector)
+            return (0, tool_1.toolFailure)(t.selectorRequired);
+        const categoryValue = args['category'];
+        if (categoryValue !== undefined && typeof categoryValue !== 'string') {
+            return (0, tool_1.toolFailure)(t.invalidFormatDoMind);
+        }
+        const category = typeof categoryValue === 'string' ? categoryValue.trim() : undefined;
+        const contentValue = args['content'];
+        const newTaskDocContent = typeof contentValue === 'string' ? contentValue.trim() : '';
+        if (!newTaskDocContent)
+            return (0, tool_1.toolFailure)(t.taskDocContentRequired);
+        // Taskdoc path is immutable for the dialog lifecycle.
+        const taskDocPath = dlg.taskDocPath;
+        if (!taskDocPath)
+            return (0, tool_1.toolFailure)(t.noTaskDocPathConfigured);
+        const workspaceRoot = path.resolve(process.cwd());
+        const fullPath = path.resolve(workspaceRoot, taskDocPath);
+        if (!isPathWithinDirectory(fullPath, workspaceRoot)) {
+            return (0, tool_1.toolFailure)(t.pathMustBeWithinWorkspace);
+        }
+        if (!(0, task_package_1.isTaskPackagePath)(taskDocPath))
+            return (0, tool_1.toolFailure)(t.invalidTaskDocPath(taskDocPath));
+        const parsed = (0, task_package_1.parseTaskPackageChangeMindTarget)({ selector, category });
+        if (parsed.kind !== 'ok') {
+            const e = parsed.error;
+            switch (e.kind) {
+                case 'selector_required':
+                    return (0, tool_1.toolFailure)(t.selectorRequired);
+                case 'invalid_category_name':
+                    return (0, tool_1.toolFailure)(t.invalidCategory(e.category));
+                case 'invalid_category_selector':
+                    return (0, tool_1.toolFailure)(t.invalidCategorySelector(e.selector));
+                case 'invalid_top_level_selector':
+                    return (0, tool_1.toolFailure)(t.invalidSelector(e.selector));
+                case 'invalid_bearinmind_selector':
+                    return (0, tool_1.toolFailure)(t.invalidSelector(e.selector));
+                case 'top_level_selector_requires_no_category':
+                    return (0, tool_1.toolFailure)(t.topLevelSelectorRequiresNoCategory(e.category, e.selector));
+                case 'bearinmind_selector_requires_bearinmind_category':
+                    return (0, tool_1.toolFailure)(t.bearInMindSelectorRequiresBearInMindCategory(e.category, e.selector));
+                default: {
+                    const _exhaustive = e;
+                    return (0, tool_1.toolFailure)(String(_exhaustive));
+                }
+            }
+        }
+        const result = await (0, task_package_1.createTaskPackageByChangeMindTarget)({
+            taskPackageDirFullPath: fullPath,
+            target: parsed.target,
+            content: newTaskDocContent,
+            updatedBy: caller.id,
+        });
+        switch (result.kind) {
+            case 'created':
+                return (0, tool_result_messages_1.formatToolActionResult)(language, 'mindChanged');
+            case 'exists':
+                return (0, tool_1.toolFailure)(t.taskDocSectionAlreadyExists((0, task_package_1.taskPackageRelativePathForChangeMindTarget)(parsed.target)));
+            default: {
+                const _exhaustive = result;
+                return _exhaustive;
+            }
+        }
+    },
+};
+exports.neverMindTool = {
+    type: 'func',
+    name: 'never_mind',
+    description: 'Delete one shared Taskdoc section file in the Main Dialog.',
+    descriptionI18n: {
+        en: 'Delete one shared Taskdoc section file in the Main Dialog.',
+        zh: '在主线对话中删除一段共享差遣牒章节文件。',
+    },
+    parameters: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['selector'],
+        properties: {
+            selector: {
+                type: 'string',
+                description: 'Target section selector. Top-level: goals|constraints|progress. Under category="bearinmind": contracts|acceptance|grants|runbook|decisions|risks. For other categories: any identifier.',
+            },
+            category: {
+                type: 'string',
+                description: 'Optional category directory within the Taskdoc package. When present, selector targets <category>/<selector>.md.',
+            },
+        },
+    },
+    argsValidation: 'dominds',
+    async call(dlg, _caller, args) {
+        const language = (0, work_language_1.getWorkLanguage)();
+        const t = getCtrlMessages(language);
+        if (dlg.askerDialog !== undefined) {
+            const maintainerId = dlg instanceof dialog_1.SideDialog ? dlg.mainDialog.agentId : dlg.agentId;
+            if (language === 'zh') {
+                return (0, tool_1.toolFailure)(`错误：\`never_mind\` 仅允许在主线对话中使用（支线对话中不可用）。\n` +
+                    `请诉请差遣牒维护人 @${maintainerId} 在其对话中执行 \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\`，并提供要新增的章节、要追加的条目、已合并好的“分段全文替换稿”或要删除的章节（禁止覆盖/抹掉他人条目）。`);
+            }
+            return (0, tool_1.toolFailure)(`Error: \`never_mind\` is only available in the Main Dialog (not in Side Dialogs).\n` +
+                `Ask the Taskdoc maintainer @${maintainerId} to run \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\` with the new section to create, entries to append, a fully merged full-section replacement draft, or the section to delete (do not overwrite/delete other contributors).`);
+        }
+        const selectorValue = args['selector'];
+        const selector = typeof selectorValue === 'string' ? selectorValue.trim() : '';
+        if (!selector)
+            return (0, tool_1.toolFailure)(t.selectorRequired);
+        const categoryValue = args['category'];
+        if (categoryValue !== undefined && typeof categoryValue !== 'string') {
+            return (0, tool_1.toolFailure)(t.invalidFormatNeverMind);
+        }
+        const category = typeof categoryValue === 'string' ? categoryValue.trim() : undefined;
+        // Taskdoc path is immutable for the dialog lifecycle.
+        const taskDocPath = dlg.taskDocPath;
+        if (!taskDocPath)
+            return (0, tool_1.toolFailure)(t.noTaskDocPathConfigured);
+        const workspaceRoot = path.resolve(process.cwd());
+        const fullPath = path.resolve(workspaceRoot, taskDocPath);
+        if (!isPathWithinDirectory(fullPath, workspaceRoot)) {
+            return (0, tool_1.toolFailure)(t.pathMustBeWithinWorkspace);
+        }
+        if (!(0, task_package_1.isTaskPackagePath)(taskDocPath))
+            return (0, tool_1.toolFailure)(t.invalidTaskDocPath(taskDocPath));
+        const parsed = (0, task_package_1.parseTaskPackageChangeMindTarget)({ selector, category });
+        if (parsed.kind !== 'ok') {
+            const e = parsed.error;
+            switch (e.kind) {
+                case 'selector_required':
+                    return (0, tool_1.toolFailure)(t.selectorRequired);
+                case 'invalid_category_name':
+                    return (0, tool_1.toolFailure)(t.invalidCategory(e.category));
+                case 'invalid_category_selector':
+                    return (0, tool_1.toolFailure)(t.invalidCategorySelector(e.selector));
+                case 'invalid_top_level_selector':
+                    return (0, tool_1.toolFailure)(t.invalidSelector(e.selector));
+                case 'invalid_bearinmind_selector':
+                    return (0, tool_1.toolFailure)(t.invalidSelector(e.selector));
+                case 'top_level_selector_requires_no_category':
+                    return (0, tool_1.toolFailure)(t.topLevelSelectorRequiresNoCategory(e.category, e.selector));
+                case 'bearinmind_selector_requires_bearinmind_category':
+                    return (0, tool_1.toolFailure)(t.bearInMindSelectorRequiresBearInMindCategory(e.category, e.selector));
+                default: {
+                    const _exhaustive = e;
+                    return (0, tool_1.toolFailure)(String(_exhaustive));
+                }
+            }
+        }
+        const result = await (0, task_package_1.deleteTaskPackageByChangeMindTarget)({
+            taskPackageDirFullPath: fullPath,
+            target: parsed.target,
+        });
+        switch (result.kind) {
+            case 'deleted':
+                return (0, tool_result_messages_1.formatToolActionResult)(language, 'deleted');
+            case 'missing': {
+                return (0, tool_1.toolFailure)(t.taskDocSectionDeleteMissing((0, task_package_1.taskPackageRelativePathForChangeMindTarget)(parsed.target)));
+            }
+            default: {
+                const _exhaustive = result;
+                return _exhaustive;
+            }
+        }
     },
 };
 exports.mindMoreTool = {
@@ -829,10 +1053,10 @@ exports.mindMoreTool = {
             const maintainerId = dlg instanceof dialog_1.SideDialog ? dlg.mainDialog.agentId : dlg.agentId;
             if (language === 'zh') {
                 return (0, tool_1.toolFailure)(`错误：\`mind_more\` 仅允许在主线对话中使用（支线对话中不可用）。\n` +
-                    `请诉请差遣牒维护人 @${maintainerId} 在其对话中执行 \`mind_more\` 或 \`change_mind\`，并提供要追加或已合并好的内容（禁止覆盖/抹掉他人条目）。`);
+                    `请诉请差遣牒维护人 @${maintainerId} 在其对话中执行 \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\`，并提供要新增的章节、要追加的条目、已合并好的“分段全文替换稿”或要删除的章节（禁止覆盖/抹掉他人条目）。`);
             }
             return (0, tool_1.toolFailure)(`Error: \`mind_more\` is only available in the Main Dialog (not in Side Dialogs).\n` +
-                `Ask the Taskdoc maintainer @${maintainerId} to run \`mind_more\` or \`change_mind\` with the entries to append or a merged draft (do not overwrite/delete other contributors).`);
+                `Ask the Taskdoc maintainer @${maintainerId} to run \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\` with the new section to create, entries to append, a merged full-section replacement draft, or the section to delete (do not overwrite/delete other contributors).`);
         }
         const rawItems = args['items'];
         if (!Array.isArray(rawItems) || rawItems.length === 0) {
@@ -860,6 +1084,9 @@ exports.mindMoreTool = {
         if (!selector)
             return (0, tool_1.toolFailure)(t.selectorRequired);
         const categoryValue = args['category'];
+        if (categoryValue !== undefined && typeof categoryValue !== 'string') {
+            return (0, tool_1.toolFailure)(t.invalidFormatMindMore);
+        }
         const category = typeof categoryValue === 'string' ? categoryValue.trim() : undefined;
         // Taskdoc path is immutable for the dialog lifecycle.
         const taskDocPath = dlg.taskDocPath;
@@ -971,23 +1198,10 @@ exports.recallTaskdocTool = {
             }
         }
         const target = parsed.target;
-        const relPath = (() => {
-            switch (target.kind) {
-                case 'bearinmind':
-                    return path.join('bearinmind', (0, task_package_1.bearInMindFilenameForSection)(target.section));
-                case 'category':
-                    return path.join(target.category, `${target.selector}.md`);
-                case 'top_level':
-                    return null;
-                default: {
-                    const _exhaustive = target;
-                    return _exhaustive;
-                }
-            }
-        })();
-        if (relPath === null) {
+        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)) {
             return (0, tool_1.toolFailure)(t.pathMustBeWithinWorkspace);

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

@@ -93,9 +93,9 @@ A: `dialog` reminders are only for the current dialog's working set. `personal`
 
 A: Use `personal` only for responsibility-related reminders that you should keep seeing in all later dialogs you lead. Everything else should default to `dialog`.
 
-### Q: Do mind_more / change_mind reset dialog rounds?
+### Q: Do do_mind / mind_more / change_mind / never_mind start a new course?
 
-A: No. `mind_more` / `change_mind` only update Taskdoc content; they do not reset dialog rounds.
+A: No. `do_mind` / `mind_more` / `change_mind` / `never_mind` only update Taskdoc content; they do not start a new course.
 
 ### Q: Are taskdoc updates immediately visible to all teammates?
 

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

@@ -27,7 +27,7 @@
 control is Dominds' **dialog control toolset** for managing dialog state, reminders, taskdocs, and inter-dialog reply closure semantics:
 
 - **Reminder management**: Two reminder scopes. Default to dialog-local working set; use `personal` only for responsibility-linked notes that you should keep seeing in all later dialogs you lead
-- **Taskdoc operations**: Append to or replace task contract sections (goals/constraints/progress); within Taskdoc, `progress` is the team-shared, quasi-real-time, scannable task bulletin board
+- **Taskdoc operations**: Append to, replace, or delete task contract sections (goals/constraints/progress); within Taskdoc, `progress` is the team-shared, quasi-real-time, scannable task bulletin board
 - **Context maintenance**: Reduce cognitive load without losing key resume state
 - **Reply routing**: Separate `tellaskBack`, `replyTellask*`, and plain text by responsibility in Side Dialog / ask-back flows
 

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

@@ -73,8 +73,8 @@ Taskdoc is a **task contract** and the task's **team-shared source of current tr
 
 **Update Rules:**
 
-- `mind_more` appends small entries; `change_mind` replaces a full section
-- Does not reset dialog rounds
+- `do_mind` creates a new section; `mind_more` appends small entries; `change_mind` replaces an existing full section; `never_mind` deletes a whole section file
+- Does not start a new course
 - Changes visible to all teammates
 - When writing `progress`, assume teammates will skim it to synchronize on the current task truth rather than read your private process log
 - Do not keep blindly calling `mind_more` until `progress` becomes a chronology; when the bulletin board starts accumulating duplicates, stale entries, or noisy history, use `change_mind` to condense it around facts that are still effective now
@@ -82,14 +82,16 @@ Taskdoc is a **task contract** and the task's **team-shared source of current tr
 
 ## Tool Overview
 
-| Tool            | Function                                             |
-| --------------- | ---------------------------------------------------- |
-| add_reminder    | Add reminder                                         |
-| delete_reminder | Delete reminder                                      |
-| update_reminder | Update reminder content                              |
-| mind_more       | Append entries to Taskdoc (defaults to progress)     |
-| change_mind     | Replace Taskdoc section (goals/constraints/progress) |
-| recall_taskdoc  | Read taskdoc chapter                                 |
+| Tool            | Function                                         |
+| --------------- | ------------------------------------------------ |
+| add_reminder    | Add reminder                                     |
+| delete_reminder | Delete reminder                                  |
+| update_reminder | Update reminder content                          |
+| do_mind         | Create new Taskdoc section                       |
+| mind_more       | Append entries to Taskdoc (defaults to progress) |
+| change_mind     | Replace existing Taskdoc section                 |
+| never_mind      | Delete Taskdoc section file                      |
+| recall_taskdoc  | Read taskdoc chapter                             |
 
 ## Inter-dialog Reply Routing
 
@@ -154,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 `mind_more` for small Taskdoc additions; use `change_mind` for full-section replacement and merge existing content first. Do not treat `mind_more` as a chronology tool; when cleanup, stale-entry removal, or same-topic consolidation is needed, use `change_mind`
-3. `mind_more` / `change_mind` do not reset dialog rounds
+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 and merge existing content first; 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`
+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/tools.md

@@ -136,13 +136,32 @@ status: ok|error
 - If you just finished writing the same continuation info via `add_reminder` / `update_reminder`, prefer `clear_mind({})`
 - If you are not sure whether it duplicates something, a small amount of redundancy is acceptable; do not risk losing information just to force perfect dedupe
 
-### 5. change_mind
+### 5. do_mind
+
+Create a new Taskdoc section. It fails if the target section already exists.
+
+**Parameters:**
+
+- `selector` (required): Chapter selector (goals/constraints/progress)
+- `category` (optional): Extra section directory; with `selector`, targets `<category>/<selector>.md`
+- `content` (required): New section content
+
+**Characteristics:**
+
+- 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`
+- Does not start a new course
+- Changes visible to all teammates
+
+### 6. change_mind
 
 Update taskdoc chapter.
 
 **Parameters:**
 
 - `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)
 
 **Returns:**
@@ -155,12 +174,12 @@ updated_at: <update timestamp>
 
 **Characteristics:**
 
-- Each call replaces entire chapter
-- Does not reset dialog rounds
+- Each call replaces an existing entire chapter; it does not create missing sections
+- Does not start a new course
 - Changes visible to all teammates
 - Constraint rule: `constraints` must include only task-specific hard requirements; do not repeat global rules. If a duplicate is found, delete it and inform the user
 
-### 6. mind_more
+### 7. mind_more
 
 Append entries to a Taskdoc section; defaults to `progress`, reducing full-section replacement pressure.
 
@@ -187,10 +206,25 @@ 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` for a full-section replacement
+- If stale entries must be removed, reordered, or compressed, use `change_mind` 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`
 
-### 7. recall_taskdoc
+### 8. never_mind
+
+Delete a Taskdoc section file.
+
+**Parameters:**
+
+- `selector` (required): Chapter selector. Top-level sections use `goals` / `constraints` / `progress`
+- `category` (optional): Extra section directory; with `selector`, targets `<category>/<selector>.md`
+
+**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
+- Does not start a new course
+
+### 9. recall_taskdoc
 
 Read taskdoc chapter.
 

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

@@ -93,9 +93,9 @@ A: `dialog` 提醒只用于当前对话的工作集。`personal` 提醒会在所
 
 A: 只有当这条提醒与你的持续职责相关，且在所有由你主理的后续对话里也应该继续被看到时，才用 `personal`。其它情况默认都用 `dialog`。
 
-### Q: mind_more / change_mind 会重置对话轮次吗？
+### Q: do_mind / mind_more / change_mind / never_mind 会开启新 course 吗？
 
-A: 不会。`mind_more` / `change_mind` 仅更新差遣牒内容，不重置对话轮次。
+A: 不会。`do_mind` / `mind_more` / `change_mind` / `never_mind` 仅更新差遣牒内容，不开启新 course。
 
 ### Q: 差遣牒更新后立即对所有队友可见吗？
 

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

@@ -27,7 +27,7 @@
 control 是 Dominds 的**对话控制工具集**，用于管理对话状态、提醒、差遣牒，以及跨对话回复收口语义：
 
 - **提醒管理**：提醒分 `dialog` / `personal` 两个 scope；默认保持对话内工作集，只有职责相关且在所有由你主理的后续对话里也应继续看到的提醒才用 `personal`
-- **差遣牒操作**：追加或替换任务契约章节（goals/constraints/progress）；其中 `progress` 是全队共享、准实时、可扫读的任务公告牌
+- **差遣牒操作**：追加、替换或删除任务契约章节（goals/constraints/progress）；其中 `progress` 是全队共享、准实时、可扫读的任务公告牌
 - **上下文维护**：在不丢关键恢复线索的前提下降低认知负载
 - **回复路由**：在支线/回问语境下，区分 `tellaskBack`、`replyTellask*` 与普通文本的职责边界
 

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

@@ -73,8 +73,8 @@
 
 **更新规则：**
 
-- `mind_more` 用于少量追加条目；`change_mind` 用于整章替换
-- 不重置对话轮次
+- `do_mind` 用于创建新章节；`mind_more` 用于少量追加条目；`change_mind` 用于替换已有整章；`never_mind` 用于删除整章文件
+- 不开启新 course
 - 变更对所有队友可见
 - 写入 `progress` 时，应默认假设全队成员会用它快速同步“当前任务真相”，而不是阅读你的个人过程记录
 - 不要无脑连续使用 `mind_more` 把 `progress` 写成流水账；当公告牌开始堆积、重复或含过期信息时，用 `change_mind` 按当前仍有效的事实压缩整理
@@ -82,14 +82,16 @@
 
 ## 工具概览
 
-| 工具            | 功能                                         |
-| --------------- | -------------------------------------------- |
-| add_reminder    | 添加提醒                                     |
-| delete_reminder | 删除提醒                                     |
-| update_reminder | 更新提醒内容                                 |
-| mind_more       | 向差遣牒追加条目（默认 progress）            |
-| change_mind     | 整章替换差遣牒（goals/constraints/progress） |
-| recall_taskdoc  | 读取差遣牒章节                               |
+| 工具            | 功能                              |
+| --------------- | --------------------------------- |
+| add_reminder    | 添加提醒                          |
+| delete_reminder | 删除提醒                          |
+| update_reminder | 更新提醒内容                      |
+| do_mind         | 创建新差遣牒章节                  |
+| mind_more       | 向差遣牒追加条目（默认 progress） |
+| change_mind     | 整章替换已有差遣牒章节            |
+| never_mind      | 删除差遣牒章节文件                |
+| recall_taskdoc  | 读取差遣牒章节                    |
 
 ## 跨对话回复路由
 
@@ -154,7 +156,7 @@
 ## 限制与注意事项
 
 1. `dialog` 提醒会随对话结束而结束；`personal` 提醒会在所有由你主理的后续对话里继续可见
-2. 差遣牒少量新增可用 `mind_more` 追加；整段替换用 `change_mind`，请确保合并已有内容。不要把 `mind_more` 当流水账工具；需要整理、去旧、合并同主题记录时直接 `change_mind`
-3. `mind_more` / `change_mind` 不重置对话轮次
+2. 缺失差遣牒章节用 `do_mind` 创建；差遣牒少量新增可用 `mind_more` 追加；已有章节整段替换用 `change_mind`，请确保合并已有内容；确需删除整章文件时用 `never_mind`。不要把 `mind_more` 当流水账工具；需要整理、去旧、合并同主题记录时直接 `change_mind`
+3. `do_mind` / `mind_more` / `change_mind` / `never_mind` 不开启新 course
 4. 接续包提醒项只保留差遣牒仍未覆盖、但恢复工作容易丢的细节；主线对话应先把当前对话历史中应由下一程知会的未落文档讨论细节写入差遣牒合适章节；支线对话在吃紧/告急时只维护足够详尽的接续包提醒项
 5. 不要把 `personal` 提醒堆成长期事实仓库；耐久知识应迁到 `personal_memory`