dominds 1.19.3 → 1.20.2

package/dist/tools/ctrl.js

@@ -15,6 +15,7 @@
  * - 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
  * - recall_taskdoc: Read a Taskdoc section from `*.tsk/` by (category, selector)
  *
  * USAGE CONTEXT:
@@ -60,7 +61,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.recallTaskdocTool = exports.changeMindTool = exports.clearMindTool = exports.updateReminderTool = exports.addReminderTool = exports.deleteReminderTool = void 0;
+exports.recallTaskdocTool = exports.mindMoreTool = 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");
@@ -98,6 +99,10 @@ function isJsonValue(value) {
 function isJsonObject(value) {
     return isRecord(value) && Object.values(value).every((item) => isJsonValue(item));
 }
+function isPathWithinDirectory(childPath, parentDir) {
+    const relative = path.relative(parentDir, childPath);
+    return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
+}
 function getManagerTool(meta) {
     if (!isRecord(meta)) {
         return undefined;
@@ -251,11 +256,112 @@ async function resolveReminderTarget(dlg, reminderIdRaw) {
     }
     return { ok: true, target };
 }
+function runReminderIndexMutation(mutation) {
+    try {
+        mutation();
+        return true;
+    }
+    catch (error) {
+        if (error instanceof dialog_1.InvalidReminderIndexError) {
+            return false;
+        }
+        throw error;
+    }
+}
+function findReminderIndexById(sourceLabel, reminders, reminderId) {
+    let foundIndex = null;
+    for (let index = 0; index < reminders.length; index += 1) {
+        const reminder = reminders[index];
+        if (reminder?.id !== reminderId)
+            continue;
+        if (foundIndex !== null) {
+            throw new Error(`Duplicate ${sourceLabel} reminder_id detected: ${reminderId}`);
+        }
+        foundIndex = index;
+    }
+    return foundIndex;
+}
+async function deleteSharedReminderById(agentId, reminderId) {
+    return (0, shared_reminders_1.mutateAgentSharedReminders)(agentId, (reminders) => {
+        const index = findReminderIndexById('shared', reminders, reminderId);
+        if (index === null)
+            return false;
+        reminders.splice(index, 1);
+        return true;
+    });
+}
+async function updateSharedReminderById(agentId, reminderId, updateReminder) {
+    return (0, shared_reminders_1.mutateAgentSharedReminders)(agentId, (reminders) => {
+        const index = findReminderIndexById('shared', reminders, reminderId);
+        if (index === null)
+            return false;
+        const reminder = reminders[index];
+        if (reminder === undefined) {
+            throw new Error(`Shared reminder index ${index} disappeared while updating reminder_id ${reminderId}`);
+        }
+        reminders[index] = updateReminder(reminder);
+        return true;
+    });
+}
+function replaceReminderContent(reminder, content, meta, renderMode) {
+    return (0, tool_1.materializeReminder)({
+        id: reminder.id,
+        content,
+        owner: reminder.owner,
+        meta: meta !== undefined ? meta : reminder.meta,
+        echoback: reminder.echoback,
+        scope: reminder.scope,
+        createdAt: reminder.createdAt,
+        priority: reminder.priority,
+        renderMode: renderMode ?? reminder.renderMode,
+    });
+}
+async function deleteResolvedReminderTarget(dlg, target) {
+    switch (target.source) {
+        case 'dialog': {
+            const index = findReminderIndexById('dialog', dlg.reminders, target.reminder.id);
+            if (index === null)
+                return false;
+            return runReminderIndexMutation(() => {
+                dlg.deleteReminder(index);
+            });
+        }
+        case 'agent_shared': {
+            const deleted = await deleteSharedReminderById(target.agentId, target.reminder.id);
+            if (deleted)
+                dlg.touchReminders();
+            return deleted;
+        }
+    }
+    const _exhaustive = target;
+    return _exhaustive;
+}
+async function updateResolvedReminderTarget(dlg, target, content, meta, renderMode) {
+    switch (target.source) {
+        case 'dialog': {
+            const index = findReminderIndexById('dialog', dlg.reminders, target.reminder.id);
+            if (index === null)
+                return false;
+            return runReminderIndexMutation(() => {
+                dlg.updateReminder(index, content, meta, { renderMode });
+            });
+        }
+        case 'agent_shared': {
+            const updated = await updateSharedReminderById(target.agentId, target.reminder.id, (current) => replaceReminderContent(current, content, meta, renderMode));
+            if (updated)
+                dlg.touchReminders();
+            return updated;
+        }
+    }
+    const _exhaustive = target;
+    return _exhaustive;
+}
 function getCtrlMessages(language) {
     if (language === 'zh') {
         return {
             invalidFormatDelete: '参数格式不对。用法：delete_reminder({ reminder_id: string })',
             reminderDoesNotExist: (reminderId) => `提醒项 '${reminderId}' 不存在。`,
+            reminderTargetChanged: '错误：提醒项列表已变化，这条提醒项当前不在可见列表中。请重新查看提醒项列表后，用当前的 reminder_id 重试。',
             invalidFormatAdd: '参数格式不对。用法：add_reminder({ content: string, position?: number, scope?: "dialog" | "personal" })（省略 position 表示追加）',
             personalPositionUnsupported: 'personal 范围提醒当前只支持追加，不能指定 position。',
             reminderContentEmpty: '提醒内容不能为空',
@@ -263,6 +369,9 @@ function getCtrlMessages(language) {
             invalidFormatUpdate: '参数格式不对。用法：update_reminder({ reminder_id: 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）',
+            mindMoreItemsRequired: '需要提供要追加的条目（items），且每一项都必须是非空字符串。\n' +
+                '示例：mind_more({"items":["- 下一步：复核验证结果（详见 <文档路径>#<章节>）","- 阻塞：等待 API 验收口径确认"]})',
             invalidFormatRecallTaskdoc: '参数格式不对。用法：recall_taskdoc({ category: string, selector: string })',
             taskDocContentRequired: '需要提供差遣牒内容（content）。\n' +
                 '示例：\n' +
@@ -282,13 +391,14 @@ 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用 change_mind 创建或更新：\n- change_mind({"category":string,"selector":string,"content":string})`,
+            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":"..."})`,
             clearedCoursePrompt: (nextCourse) => (0, driver_messages_1.formatNewCourseStartPrompt)('zh', { nextCourse, source: 'clear_mind' }),
         };
     }
     return {
         invalidFormatDelete: 'Error: Invalid args. Use: delete_reminder({ reminder_id: string })',
         reminderDoesNotExist: (reminderId) => `Error: Reminder '${reminderId}' does not exist.`,
+        reminderTargetChanged: 'Error: The reminder list changed, and this reminder is no longer visible. Refresh the reminders and retry with the current reminder_id.',
         invalidFormatAdd: 'Error: Invalid args. Use: add_reminder({ content: string, position?: number, scope?: "dialog" | "personal" }) (omit position to append).',
         personalPositionUnsupported: 'Error: personal-scope reminders currently support append only; do not pass position.',
         reminderContentEmpty: 'Error: Reminder content cannot be empty',
@@ -296,6 +406,9 @@ function getCtrlMessages(language) {
         invalidFormatUpdate: 'Error: Invalid args. Use: update_reminder({ reminder_id: 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).',
+        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 })',
         taskDocContentRequired: 'Error: Taskdoc content is required (content).\n' +
             'Copy/paste example:\n' +
@@ -315,7 +428,7 @@ 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 \`change_mind\` to create/update it (whole-section replace):\n- \`change_mind({\"category\":\"<category>\",\"selector\":\"<selector>\",\"content\":\"...\"})\``,
+        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\":\"...\"})\``,
         clearedCoursePrompt: (nextCourse) => (0, driver_messages_1.formatNewCourseStartPrompt)('en', { nextCourse, source: 'clear_mind' }),
     };
 }
@@ -351,18 +464,10 @@ exports.deleteReminderTool = {
         if (deleteAltInstruction !== undefined) {
             return (0, tool_1.toolFailure)(formatManualDeleteBlockedError(language, deleteAltInstruction));
         }
-        if (resolved.target.source === 'dialog') {
-            dlg.deleteReminder(resolved.target.index);
-            return (0, tool_result_messages_1.formatToolActionResult)(language, 'deleted');
-        }
-        if (resolved.target.source === 'agent_shared') {
-            await (0, shared_reminders_1.mutateAgentSharedReminders)(resolved.target.agentId, (reminders) => {
-                reminders.splice(resolved.target.index, 1);
-            });
-            dlg.touchReminders();
-            return (0, tool_result_messages_1.formatToolActionResult)(language, 'deleted');
-        }
-        return (0, tool_1.toolFailure)(t.invalidFormatDelete);
+        const deleted = await deleteResolvedReminderTarget(dlg, resolved.target);
+        if (!deleted)
+            return (0, tool_1.toolFailure)(t.reminderTargetChanged);
+        return (0, tool_result_messages_1.formatToolActionResult)(language, 'deleted');
     },
 };
 exports.addReminderTool = {
@@ -532,39 +637,14 @@ exports.updateReminderTool = {
         if (contextHealthLevel === undefined) {
             const stripResult = removeContinuationPackageReminderMeta(reminder?.meta);
             if (stripResult.changed) {
-                if (resolved.target.source === 'dialog') {
-                    dlg.updateReminder(resolved.target.index, reminderContent, stripResult.nextMeta, {
-                        renderMode: reminderRenderMode,
-                    });
-                }
-                else {
-                    await (0, shared_reminders_1.mutateAgentSharedReminders)(resolved.target.agentId, (reminders) => {
-                        reminders[resolved.target.index] = {
-                            ...reminders[resolved.target.index],
-                            content: reminderContent,
-                            meta: stripResult.nextMeta,
-                            renderMode: reminderRenderMode ?? reminders[resolved.target.index]?.renderMode,
-                        };
-                    });
-                    dlg.touchReminders();
-                }
+                const updated = await updateResolvedReminderTarget(dlg, resolved.target, reminderContent, stripResult.nextMeta, reminderRenderMode);
+                if (!updated)
+                    return (0, tool_1.toolFailure)(t.reminderTargetChanged);
                 return (0, tool_result_messages_1.formatToolActionResult)(language, 'updated');
             }
-            if (resolved.target.source === 'dialog') {
-                dlg.updateReminder(resolved.target.index, reminderContent, undefined, {
-                    renderMode: reminderRenderMode,
-                });
-            }
-            else {
-                await (0, shared_reminders_1.mutateAgentSharedReminders)(resolved.target.agentId, (reminders) => {
-                    reminders[resolved.target.index] = {
-                        ...reminders[resolved.target.index],
-                        content: reminderContent,
-                        renderMode: reminderRenderMode ?? reminders[resolved.target.index]?.renderMode,
-                    };
-                });
-                dlg.touchReminders();
-            }
+            const updated = await updateResolvedReminderTarget(dlg, resolved.target, reminderContent, undefined, reminderRenderMode);
+            if (!updated)
+                return (0, tool_1.toolFailure)(t.reminderTargetChanged);
             return (0, tool_result_messages_1.formatToolActionResult)(language, 'updated');
         }
         const reminderMeta = buildContinuationPackageReminderMeta({
@@ -572,22 +652,9 @@ exports.updateReminderTool = {
             createdBy: 'context_health',
             contextHealthLevel,
         });
-        if (resolved.target.source === 'dialog') {
-            dlg.updateReminder(resolved.target.index, reminderContent, reminderMeta, {
-                renderMode: reminderRenderMode,
-            });
-        }
-        else {
-            await (0, shared_reminders_1.mutateAgentSharedReminders)(resolved.target.agentId, (reminders) => {
-                reminders[resolved.target.index] = {
-                    ...reminders[resolved.target.index],
-                    content: reminderContent,
-                    meta: reminderMeta,
-                    renderMode: reminderRenderMode ?? reminders[resolved.target.index]?.renderMode,
-                };
-            });
-            dlg.touchReminders();
-        }
+        const updated = await updateResolvedReminderTarget(dlg, resolved.target, reminderContent, reminderMeta, reminderRenderMode);
+        if (!updated)
+            return (0, tool_1.toolFailure)(t.reminderTargetChanged);
         return (0, tool_result_messages_1.formatToolActionResult)(language, 'updated');
     },
 };
@@ -663,10 +730,10 @@ 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} 在其对话中执行 \`change_mind\`，并提供你已合并好的“分段全文替换稿”（禁止覆盖/抹掉他人条目）。`);
+                    `请诉请差遣牒维护人 @${maintainerId} 在其对话中执行 \`mind_more\` 或 \`change_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 \`change_mind\` and provide a fully merged full-section replacement draft (do not overwrite/delete other contributors).`);
+                `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).`);
         }
         const selectorValue = args['selector'];
         const selector = typeof selectorValue === 'string' ? selectorValue.trim() : '';
@@ -684,8 +751,9 @@ exports.changeMindTool = {
             return (0, tool_1.toolFailure)(t.noTaskDocPathConfigured);
         const workspaceRoot = path.resolve(process.cwd());
         const fullPath = path.resolve(workspaceRoot, taskDocPath);
-        if (!fullPath.startsWith(workspaceRoot))
+        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 });
@@ -721,6 +789,123 @@ exports.changeMindTool = {
         return (0, tool_result_messages_1.formatToolActionResult)(language, 'mindChanged');
     },
 };
+exports.mindMoreTool = {
+    type: 'func',
+    name: 'mind_more',
+    description: 'Append entries to one shared Taskdoc section in the Main Dialog.',
+    descriptionI18n: {
+        en: 'Append entries to one shared Taskdoc section in the Main Dialog.',
+        zh: '在主线对话中向一段共享差遣牒章节追加条目。',
+    },
+    parameters: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['items'],
+        properties: {
+            items: {
+                type: 'array',
+                description: 'Entries to append. Each entry must be a non-empty string.',
+                items: { type: 'string' },
+            },
+            sep: {
+                type: 'string',
+                description: 'Separator inserted between existing content and new entries, and between entries. Defaults to "\\n".',
+            },
+            selector: {
+                type: 'string',
+                description: 'Target section selector. Defaults to progress. 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)(`错误：\`mind_more\` 仅允许在主线对话中使用（支线对话中不可用）。\n` +
+                    `请诉请差遣牒维护人 @${maintainerId} 在其对话中执行 \`mind_more\` 或 \`change_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).`);
+        }
+        const rawItems = args['items'];
+        if (!Array.isArray(rawItems) || rawItems.length === 0) {
+            return (0, tool_1.toolFailure)(t.mindMoreItemsRequired);
+        }
+        const items = [];
+        for (const item of rawItems) {
+            if (typeof item !== 'string')
+                return (0, tool_1.toolFailure)(t.mindMoreItemsRequired);
+            const normalized = item.trim();
+            if (!normalized)
+                return (0, tool_1.toolFailure)(t.mindMoreItemsRequired);
+            items.push(normalized);
+        }
+        const sepValue = args['sep'];
+        const sep = sepValue === undefined ? '\n' : typeof sepValue === 'string' ? sepValue : null;
+        if (sep === null)
+            return (0, tool_1.toolFailure)(t.invalidFormatMindMore);
+        const selectorValue = args['selector'];
+        const selector = selectorValue === undefined
+            ? 'progress'
+            : typeof selectorValue === 'string'
+                ? selectorValue.trim()
+                : '';
+        if (!selector)
+            return (0, tool_1.toolFailure)(t.selectorRequired);
+        const categoryValue = args['category'];
+        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));
+                }
+            }
+        }
+        await (0, task_package_1.appendTaskPackageByChangeMindTarget)({
+            taskPackageDirFullPath: fullPath,
+            target: parsed.target,
+            content: items.join(sep),
+            sep,
+            updatedBy: caller.id,
+        });
+        return (0, tool_result_messages_1.formatToolActionResult)(language, 'mindChanged');
+    },
+};
 exports.recallTaskdocTool = {
     type: 'func',
     name: 'recall_taskdoc',
@@ -756,8 +941,9 @@ exports.recallTaskdocTool = {
             return (0, tool_1.toolFailure)(t.noTaskDocPathConfigured);
         const workspaceRoot = path.resolve(process.cwd());
         const fullPath = path.resolve(workspaceRoot, taskDocPath);
-        if (!fullPath.startsWith(workspaceRoot))
+        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 });
@@ -803,7 +989,7 @@ exports.recallTaskdocTool = {
             return (0, tool_1.toolFailure)(t.invalidFormatRecallTaskdoc);
         }
         const sectionPath = path.resolve(fullPath, relPath);
-        if (!sectionPath.startsWith(fullPath)) {
+        if (!isPathWithinDirectory(sectionPath, fullPath)) {
             return (0, tool_1.toolFailure)(t.pathMustBeWithinWorkspace);
         }
         try {
@@ -830,6 +1016,7 @@ exports.recallTaskdocTool = {
                 ? `\n\n⚠️ 已截断：内容过大（${bytes} bytes），仅回显前 ${maxSize} bytes。`
                 : `\n\n⚠️ Truncated: content is too large (${bytes} bytes); showing first ${maxSize} bytes.`
             : '';
-        return (0, tool_1.toolSuccess)(`**recall_taskdoc:** \`${relPath}\`\n\n---\n${clipped}\n---${note}`);
+        const closingSeparatorPrefix = clipped.endsWith('\n') ? '' : '\n';
+        return (0, tool_1.toolSuccess)(`**recall_taskdoc:** \`${relPath}\`\n\n---\n${clipped}${closingSeparatorPrefix}---${note}`);
     },
 };