dominds 1.20.2 → 1.20.4

package/dist/utils/taskdoc-search-worker-client.js

@@ -0,0 +1,320 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTaskDocumentSuggestionRequestKey = buildTaskDocumentSuggestionRequestKey;
+exports.searchTaskDocumentSuggestionsInWorker = searchTaskDocumentSuggestionsInWorker;
+const fs_1 = __importDefault(require("fs"));
+const module_1 = require("module");
+const path = __importStar(require("path"));
+const worker_threads_1 = require("worker_threads");
+const requireFn = (0, module_1.createRequire)(__filename);
+const TASKDOC_SUGGESTION_WORKER_TIMEOUT_MS = 10000;
+const TASKDOC_SUGGESTION_MAX_WORKERS = 2;
+const TASKDOC_SUGGESTION_MAX_PENDING_WORKERS = 8;
+const TASKDOC_SUGGESTION_CACHE_TTL_MS = 3000;
+const TASKDOC_SUGGESTION_CACHE_MAX_ENTRIES = 64;
+let activeTaskdocSuggestionWorkers = 0;
+const pendingTaskdocSuggestionWorkerSlots = [];
+const taskdocSuggestionCache = new Map();
+const taskdocSuggestionInFlightByCacheKey = new Map();
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function normalizeTaskdocSuggestionLimit(limit) {
+    return typeof limit === 'number' && Number.isFinite(limit) && limit > 0 ? Math.floor(limit) : 50;
+}
+function normalizeTaskdocSuggestionQueryKey(query) {
+    const normalized = query.trim().toLowerCase();
+    return normalized.endsWith('.tsk') ? normalized.slice(0, -4) : normalized;
+}
+function buildTaskDocumentSuggestionRequestKey(payload) {
+    return normalizeTaskdocSuggestionQueryKey(payload.query);
+}
+function buildTaskDocumentSuggestionCacheKey(payload) {
+    return [
+        path.resolve(payload.rootDir ?? '.'),
+        String(normalizeTaskdocSuggestionLimit(payload.limit)),
+        buildTaskDocumentSuggestionRequestKey(payload),
+    ].join('\u0000');
+}
+function readTaskDocumentSuggestionCache(cacheKey) {
+    const cached = taskdocSuggestionCache.get(cacheKey);
+    if (!cached)
+        return undefined;
+    if (cached.expiresAtMs <= Date.now()) {
+        taskdocSuggestionCache.delete(cacheKey);
+        return undefined;
+    }
+    return cached.result;
+}
+function writeTaskDocumentSuggestionCache(cacheKey, result) {
+    if (result.kind !== 'ok')
+        return;
+    const now = Date.now();
+    for (const [key, cached] of taskdocSuggestionCache) {
+        if (cached.expiresAtMs <= now)
+            taskdocSuggestionCache.delete(key);
+    }
+    taskdocSuggestionCache.delete(cacheKey);
+    taskdocSuggestionCache.set(cacheKey, {
+        expiresAtMs: now + TASKDOC_SUGGESTION_CACHE_TTL_MS,
+        result,
+    });
+    while (taskdocSuggestionCache.size > TASKDOC_SUGGESTION_CACHE_MAX_ENTRIES) {
+        const oldestKey = taskdocSuggestionCache.keys().next().value;
+        if (typeof oldestKey !== 'string')
+            break;
+        taskdocSuggestionCache.delete(oldestKey);
+    }
+}
+async function waitForTaskDocumentSuggestionResult(promise, signal) {
+    if (!signal)
+        return await promise;
+    if (signal.aborted) {
+        return { kind: 'error', errorText: 'Taskdoc suggestion request aborted' };
+    }
+    return await new Promise((resolve) => {
+        let settled = false;
+        const settle = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener('abort', abortWait);
+            resolve(result);
+        };
+        const abortWait = () => {
+            settle({ kind: 'error', errorText: 'Taskdoc suggestion request aborted' });
+        };
+        signal.addEventListener('abort', abortWait, { once: true });
+        promise.then(settle, (error) => {
+            settle({
+                kind: 'error',
+                errorText: error instanceof Error ? error.message : 'Taskdoc suggestion worker failed',
+            });
+        });
+    });
+}
+function parseWorkerMessage(value) {
+    if (!isRecord(value))
+        throw new Error('Taskdoc suggestion worker returned non-object message');
+    const kind = value['kind'];
+    switch (kind) {
+        case 'ok': {
+            const suggestionsRaw = value['suggestions'];
+            if (!isRecord(suggestionsRaw)) {
+                throw new Error('Taskdoc suggestion worker ok message missing suggestions');
+            }
+            if (suggestionsRaw['kind'] === 'ok') {
+                const listRaw = suggestionsRaw['suggestions'];
+                if (!Array.isArray(listRaw)) {
+                    throw new Error('Taskdoc suggestion worker ok result missing suggestions list');
+                }
+                return {
+                    kind: 'ok',
+                    suggestions: {
+                        kind: 'ok',
+                        suggestions: listRaw.map((item) => {
+                            if (!isRecord(item)) {
+                                throw new Error('Taskdoc suggestion worker returned invalid suggestion item');
+                            }
+                            const pathRaw = item['path'];
+                            const relativePath = item['relativePath'];
+                            const name = item['name'];
+                            if (typeof pathRaw !== 'string' ||
+                                typeof relativePath !== 'string' ||
+                                typeof name !== 'string') {
+                                throw new Error('Taskdoc suggestion worker returned malformed suggestion item');
+                            }
+                            return { path: pathRaw, relativePath, name };
+                        }),
+                    },
+                };
+            }
+            if (suggestionsRaw['kind'] === 'error') {
+                const errorText = suggestionsRaw['errorText'];
+                if (typeof errorText !== 'string') {
+                    throw new Error('Taskdoc suggestion worker error result missing errorText');
+                }
+                return { kind: 'ok', suggestions: { kind: 'error', errorText } };
+            }
+            throw new Error('Taskdoc suggestion worker returned unknown suggestions kind');
+        }
+        case 'error': {
+            const errorText = value['errorText'];
+            if (typeof errorText !== 'string') {
+                throw new Error('Taskdoc suggestion worker error message missing errorText');
+            }
+            return { kind: 'error', errorText };
+        }
+        default:
+            throw new Error(`Taskdoc suggestion worker returned unknown message kind: ${String(kind)}`);
+    }
+}
+function resolveTaskdocSuggestionWorkerEntrypointAbs() {
+    const distCandidate = path.resolve(__dirname, 'taskdoc-search-worker.js');
+    if (fs_1.default.existsSync(distCandidate)) {
+        return { ok: true, kind: 'compiled_js', scriptAbs: distCandidate };
+    }
+    const tsCandidate = path.resolve(__dirname, 'taskdoc-search-worker.ts');
+    if (fs_1.default.existsSync(tsCandidate)) {
+        const tsxCjsRegisterAbs = requireFn.resolve('tsx/cjs');
+        return { ok: true, kind: 'tsx_cjs_bridge', scriptAbs: tsCandidate, tsxCjsRegisterAbs };
+    }
+    return {
+        ok: false,
+        errorText: `Cannot find taskdoc suggestion worker entrypoint at ${distCandidate} or ${tsCandidate}`,
+    };
+}
+async function acquireTaskdocSuggestionWorkerSlot() {
+    if (activeTaskdocSuggestionWorkers < TASKDOC_SUGGESTION_MAX_WORKERS) {
+        activeTaskdocSuggestionWorkers += 1;
+        return;
+    }
+    if (pendingTaskdocSuggestionWorkerSlots.length >= TASKDOC_SUGGESTION_MAX_PENDING_WORKERS) {
+        throw new Error('Taskdoc suggestion worker queue is full');
+    }
+    await new Promise((resolve) => {
+        const grantSlot = () => {
+            activeTaskdocSuggestionWorkers += 1;
+            resolve();
+        };
+        pendingTaskdocSuggestionWorkerSlots.push(grantSlot);
+    });
+}
+function releaseTaskdocSuggestionWorkerSlot() {
+    activeTaskdocSuggestionWorkers = Math.max(0, activeTaskdocSuggestionWorkers - 1);
+    const next = pendingTaskdocSuggestionWorkerSlots.shift();
+    if (next) {
+        next();
+        return;
+    }
+}
+async function runTaskDocumentSuggestionsWorker(payload) {
+    const entry = resolveTaskdocSuggestionWorkerEntrypointAbs();
+    if (!entry.ok)
+        return { kind: 'error', errorText: entry.errorText };
+    let acquiredWorkerSlot = false;
+    try {
+        await acquireTaskdocSuggestionWorkerSlot();
+        acquiredWorkerSlot = true;
+        const worker = entry.kind === 'compiled_js'
+            ? new worker_threads_1.Worker(entry.scriptAbs, { workerData: payload })
+            : new worker_threads_1.Worker('const { workerData } = require("worker_threads"); require(workerData.tsxCjsRegisterAbs); require(workerData.scriptAbs);', {
+                eval: true,
+                workerData: {
+                    ...payload,
+                    scriptAbs: entry.scriptAbs,
+                    tsxCjsRegisterAbs: entry.tsxCjsRegisterAbs,
+                },
+            });
+        return await new Promise((resolve) => {
+            let settled = false;
+            const timeout = setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                releaseTaskdocSuggestionWorkerSlot();
+                void worker.terminate();
+                resolve({ kind: 'error', errorText: 'Taskdoc suggestion worker timed out' });
+            }, TASKDOC_SUGGESTION_WORKER_TIMEOUT_MS);
+            const settle = (result) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timeout);
+                releaseTaskdocSuggestionWorkerSlot();
+                void worker.terminate();
+                resolve(result);
+            };
+            worker.once('message', (raw) => {
+                try {
+                    const message = parseWorkerMessage(raw);
+                    if (message.kind === 'ok') {
+                        settle(message.suggestions);
+                        return;
+                    }
+                    settle({ kind: 'error', errorText: message.errorText });
+                }
+                catch (error) {
+                    settle({
+                        kind: 'error',
+                        errorText: error instanceof Error ? error.message : 'Invalid taskdoc worker response',
+                    });
+                }
+            });
+            worker.once('error', (error) => {
+                settle({ kind: 'error', errorText: error.message });
+            });
+            worker.once('exit', (code) => {
+                if (settled)
+                    return;
+                settle({ kind: 'error', errorText: `Taskdoc suggestion worker exited with code ${code}` });
+            });
+        });
+    }
+    catch (error) {
+        if (acquiredWorkerSlot)
+            releaseTaskdocSuggestionWorkerSlot();
+        return {
+            kind: 'error',
+            errorText: error instanceof Error ? error.message : 'Failed to start taskdoc worker',
+        };
+    }
+}
+async function searchTaskDocumentSuggestionsInWorker(payload, options = {}) {
+    if (options.signal?.aborted) {
+        return { kind: 'error', errorText: 'Taskdoc suggestion request aborted' };
+    }
+    const cacheKey = buildTaskDocumentSuggestionCacheKey(payload);
+    const cached = readTaskDocumentSuggestionCache(cacheKey);
+    if (cached)
+        return cached;
+    let inFlight = taskdocSuggestionInFlightByCacheKey.get(cacheKey);
+    if (!inFlight) {
+        inFlight = runTaskDocumentSuggestionsWorker(payload)
+            .then((result) => {
+            writeTaskDocumentSuggestionCache(cacheKey, result);
+            return result;
+        })
+            .finally(() => {
+            taskdocSuggestionInFlightByCacheKey.delete(cacheKey);
+        });
+        taskdocSuggestionInFlightByCacheKey.set(cacheKey, inFlight);
+    }
+    return await waitForTaskDocumentSuggestionResult(inFlight, options.signal);
+}

package/dist/utils/taskdoc-search-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/taskdoc-search-worker.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const worker_threads_1 = require("worker_threads");
+const taskdoc_search_1 = require("./taskdoc-search");
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function parseWorkerPayload(value) {
+    if (!isRecord(value)) {
+        throw new Error('Taskdoc suggestion worker payload must be an object');
+    }
+    const query = value['query'];
+    if (typeof query !== 'string') {
+        throw new Error('Taskdoc suggestion worker payload.query must be a string');
+    }
+    const rootDirRaw = value['rootDir'];
+    const limitRaw = value['limit'];
+    return {
+        query,
+        ...(typeof rootDirRaw === 'string' ? { rootDir: rootDirRaw } : {}),
+        ...(typeof limitRaw === 'number' ? { limit: limitRaw } : {}),
+    };
+}
+async function main() {
+    if (worker_threads_1.parentPort === null) {
+        throw new Error('Taskdoc suggestion worker requires a parentPort');
+    }
+    try {
+        const payload = parseWorkerPayload(worker_threads_1.workerData);
+        const suggestions = await (0, taskdoc_search_1.searchTaskDocumentSuggestionsInRtws)(payload);
+        const message = { kind: 'ok', suggestions };
+        worker_threads_1.parentPort.postMessage(message);
+    }
+    catch (error) {
+        const message = {
+            kind: 'error',
+            errorText: error instanceof Error ? error.message : 'Taskdoc suggestion worker failed',
+        };
+        worker_threads_1.parentPort.postMessage(message);
+    }
+}
+void main();

package/dist/utils/taskdoc-search.d.ts

@@ -1,10 +1,19 @@
-export interface TaskDocumentSummary {
-    path: string;
-    relativePath: string;
-    name: string;
-    size: number;
-    lastModified: string;
-}
+/**
+ * Module: utils/taskdoc-search
+ *
+ * rtws (runtime workspace) search utilities for Taskdocs (`*.tsk/`).
+ *
+ * Taskdocs are encapsulated directories ending in `.tsk`. For search, we treat each `*.tsk/`
+ * directory as a single unit and do not recurse into it.
+ *
+ * Ignore rules:
+ * - Default ignore patterns skip common non-task directories (at any depth).
+ * - A `.taskdoc-ignore` file may exist in any directory. Its patterns apply to that directory's
+ *   subtree only (like a simplified `.gitignore`).
+ * - Patterns are interpreted as paths relative to the `.taskdoc-ignore` directory (unless they
+ *   start with `/`, in which case they are rtws-root-relative).
+ */
+import type { TaskDocumentSuggestion, TaskDocumentSummary } from '@longrun-ai/kernel/types/taskdoc';
 export type ListTaskDocumentsResult = {
     kind: 'ok';
     taskDocuments: TaskDocumentSummary[];
@@ -12,8 +21,20 @@ export type ListTaskDocumentsResult = {
     kind: 'error';
     errorText: string;
 };
+export type SearchTaskDocumentSuggestionsResult = {
+    kind: 'ok';
+    suggestions: TaskDocumentSuggestion[];
+} | {
+    kind: 'error';
+    errorText: string;
+};
 interface ListTaskDocumentsParams {
     rootDir?: string;
 }
+interface SearchTaskDocumentSuggestionsParams extends ListTaskDocumentsParams {
+    query: string;
+    limit?: number;
+}
 export declare function listTaskDocumentsInRtws(params?: ListTaskDocumentsParams): Promise<ListTaskDocumentsResult>;
+export declare function searchTaskDocumentSuggestionsInRtws(params: SearchTaskDocumentSuggestionsParams): Promise<SearchTaskDocumentSuggestionsResult>;
 export {};

package/dist/utils/taskdoc-search.js

@@ -37,21 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.listTaskDocumentsInRtws = listTaskDocumentsInRtws;
-/**
- * Module: utils/taskdoc-search
- *
- * rtws (runtime workspace) search utilities for Taskdocs (`*.tsk/`).
- *
- * Taskdocs are encapsulated directories ending in `.tsk`. For search, we treat each `*.tsk/`
- * directory as a single unit and do not recurse into it.
- *
- * Ignore rules:
- * - Default ignore patterns skip common non-task directories (at any depth).
- * - A `.taskdoc-ignore` file may exist in any directory. Its patterns apply to that directory's
- *   subtree only (like a simplified `.gitignore`).
- * - Patterns are interpreted as paths relative to the `.taskdoc-ignore` directory (unless they
- *   start with `/`, in which case they are rtws-root-relative).
- */
+exports.searchTaskDocumentSuggestionsInRtws = searchTaskDocumentSuggestionsInRtws;
 const time_1 = require("@longrun-ai/kernel/utils/time");
 const promises_1 = __importDefault(require("fs/promises"));
 const path = __importStar(require("path"));
@@ -64,6 +50,22 @@ const DEFAULT_IGNORE_PATTERNS = [
 function normalizePosixPath(p) {
     return p.replace(/\\/g, '/').replace(/^\.\//, '');
 }
+function stripTaskdocSuffixForMatch(value) {
+    return value.endsWith('.tsk') ? value.slice(0, -4) : value;
+}
+function calculateTaskDocumentSuggestionScore(params) {
+    if (params.nameExactMatch)
+        return 100;
+    if (params.nameStartsWith)
+        return 90;
+    if (params.pathStartsWith)
+        return 80;
+    if (params.nameMatch)
+        return 70;
+    if (params.pathMatch)
+        return 60;
+    return 0;
+}
 function escapeRegexLiteralChar(ch) {
     // Regex special chars: \ ^ $ . | ? * + ( ) [ ] { }
     if ('\\^$.|?*+()[]{}'.includes(ch))
@@ -293,3 +295,48 @@ async function listTaskDocumentsInRtws(params = {}) {
         return { kind: 'error', errorText: 'Failed to list Taskdocs' };
     }
 }
+async function searchTaskDocumentSuggestionsInRtws(params) {
+    const normalizedQuery = stripTaskdocSuffixForMatch(params.query.trim().toLowerCase());
+    if (normalizedQuery === '')
+        return { kind: 'ok', suggestions: [] };
+    const listed = await listTaskDocumentsInRtws({ rootDir: params.rootDir });
+    if (listed.kind === 'error')
+        return listed;
+    const limit = typeof params.limit === 'number' && Number.isFinite(params.limit) && params.limit > 0
+        ? Math.floor(params.limit)
+        : 50;
+    const suggestions = listed.taskDocuments
+        .map((doc) => {
+        const normalizedRelativePathForMatch = stripTaskdocSuffixForMatch(doc.relativePath.toLowerCase());
+        const normalizedNameForMatch = stripTaskdocSuffixForMatch(doc.name.toLowerCase());
+        const nameMatch = normalizedNameForMatch.includes(normalizedQuery);
+        const pathMatch = normalizedRelativePathForMatch.includes(normalizedQuery);
+        if (!nameMatch && !pathMatch)
+            return null;
+        return {
+            doc,
+            score: calculateTaskDocumentSuggestionScore({
+                nameMatch,
+                pathMatch,
+                nameStartsWith: normalizedNameForMatch.startsWith(normalizedQuery),
+                pathStartsWith: normalizedRelativePathForMatch.startsWith(normalizedQuery),
+                nameExactMatch: normalizedNameForMatch === normalizedQuery,
+            }),
+        };
+    })
+        .filter((entry) => entry !== null)
+        .sort((a, b) => {
+        if (a.score !== b.score)
+            return b.score - a.score;
+        if (a.doc.name.length !== b.doc.name.length)
+            return a.doc.name.length - b.doc.name.length;
+        return a.doc.name.localeCompare(b.doc.name);
+    })
+        .slice(0, limit)
+        .map(({ doc }) => ({
+        path: doc.path,
+        relativePath: doc.relativePath,
+        name: doc.name,
+    }));
+    return { kind: 'ok', suggestions };
+}

package/dist/utils/taskdoc.js

@@ -239,17 +239,40 @@ If you provided a regular file path (e.g. a \`.md\`), that is unexpected. Please
                         .map((n) => `\`${n}\``)
                         .join(', ')}`
                     : '';
+                const missingSectionsZh = [
+                    goalsStatus === 'missing' ? 'goals' : null,
+                    constraintsStatus === 'missing' ? 'constraints' : null,
+                    progressStatus === 'missing' ? 'progress' : null,
+                ].filter((section) => section !== null);
+                const presentSectionsZh = [
+                    goalsStatus === 'present' ? 'goals' : null,
+                    constraintsStatus === 'present' ? 'constraints' : null,
+                    progressStatus === 'present' ? 'progress' : null,
+                ].filter((section) => section !== null);
+                const missingSectionLines = missingSectionsZh.length === 0
+                    ? []
+                    : [
+                        ``,
+                        `缺失的常驻分段请用函数工具 \`do_mind\` 创建（不要用通用文件工具）：`,
+                        ...missingSectionsZh.map((section) => `- \`do_mind({"selector":"${section}","content":"..."})\``),
+                    ];
+                const presentSectionLine = presentSectionsZh.length === 0
+                    ? []
+                    : [
+                        `- 已存在常驻分段（${presentSectionsZh.map((s) => `\`${s}\``).join(' / ')}）需要追加少量条目时，使用 \`mind_more\`；需要整体改写/合并时，使用 \`change_mind\`。没有把握时不要覆盖，优先新增额外章节或追加小条目。`,
+                    ];
                 const maintenanceLine = isSideDialog
-                    ? `- 支线对话中不允许 \`mind_more\` / \`change_mind\`：需要更新时请诉请差遣牒维护人 @${taskdocMaintainerId} 执行更新，并提供要追加的条目或已合并好的“分段全文替换稿”（禁止覆盖/抹掉他人条目）。`
+                    ? `- 支线对话中不允许 \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\`：需要更新时请诉请差遣牒维护人 @${taskdocMaintainerId} 执行更新，并提供要新增的章节、要追加的条目、已合并好的“分段全文替换稿”或要删除的章节（禁止覆盖/抹掉他人条目）。`
                     : `- 维护方式：少量新增条目优先用 \`mind_more({\"items\":[\"...\"]})\` 追加到 \`progress\`（也可指定 selector/category）；需要删除陈旧项、重排或压缩时，用 \`change_mind\` 指定分段做整章替换。`;
                 return [
                     `**差遣牒结构（封装差遣牒 \`*.tsk/\`）：**`,
                     `- 我们的差遣牒是一个 \`*.tsk/\` 目录：顶层 3 个分段（\`goals\` / \`constraints\` / \`progress\`）一定会自动注入；\`bearinmind/\`（固定白名单）可选自动注入；其他章节不会自动注入，仅以“目录索引”形式提示并需用 \`recall_taskdoc\` 显式读取。`,
                     `- 全队共享：三个分段对所有队友与支线对话可见。更新时禁止覆盖/抹掉他人条目；建议为自己维护的条目标注责任人（如 \`- [owner:@<id>] ...\`）。`,
                     `- 章节语义约定：\`goals\` / \`constraints\` 是任务契约；\`progress\` 是全队共享、准实时、可扫读的任务公告牌，用于当前有效状态、关键决策、下一步与仍成立阻塞，不是“我当前在做什么”的个人笔记。`,
-                    `- 差遣牒维护人（负责执行 \`mind_more\` / \`change_mind\`）：@${taskdocMaintainerId}`,
+                    `- 差遣牒维护人（负责执行 \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\`）：@${taskdocMaintainerId}`,
                     `- 重要：差遣牒内容已被系统以内联形式注入到上下文中（本程生成视角下即为最新）。请直接基于上下文里的差遣牒回顾与决策，不要试图用通用文件工具读取 \`*.tsk/\` 下的文件（会被拒绝）。`,
                     maintenanceLine,
+                    ...presentSectionLine,
                     ``,
                     `**分段状态：**`,
                     `- \`goals.md\`：${goalsZh}`,
@@ -259,16 +282,34 @@ If you provided a regular file path (e.g. a \`.md\`), that is unexpected. Please
                     ...(bearExtrasLine ? [bearExtrasLine] : []),
                     ``,
                     extraSectionsBlock,
-                    ``,
-                    `若某个分段缺失，请用函数工具 \`change_mind\` 创建（不要用通用文件工具）：`,
-                    `- \`change_mind({\"selector\":\"goals\",\"content\":\"...\"})\``,
-                    `- \`change_mind({\"selector\":\"constraints\",\"content\":\"...\"})\``,
-                    `- \`change_mind({\"selector\":\"progress\",\"content\":\"...\"})\``,
+                    ...missingSectionLines,
                     ...(violationsBlock ? ['', violationsBlock] : []),
                 ].join('\n');
             }
+            const missingSectionsEn = [
+                goalsStatus === 'missing' ? 'goals' : null,
+                constraintsStatus === 'missing' ? 'constraints' : null,
+                progressStatus === 'missing' ? 'progress' : null,
+            ].filter((section) => section !== null);
+            const presentSectionsEn = [
+                goalsStatus === 'present' ? 'goals' : null,
+                constraintsStatus === 'present' ? 'constraints' : null,
+                progressStatus === 'present' ? 'progress' : null,
+            ].filter((section) => section !== null);
+            const missingSectionLines = missingSectionsEn.length === 0
+                ? []
+                : [
+                    ``,
+                    `Create missing resident sections with the function tool \`do_mind\` (never via general file tools):`,
+                    ...missingSectionsEn.map((section) => `- \`do_mind({"selector":"${section}","content":"..."})\``),
+                ];
+            const presentSectionLine = presentSectionsEn.length === 0
+                ? []
+                : [
+                    `- For existing resident sections (${presentSectionsEn.map((s) => `\`${s}\``).join(' / ')}), use \`mind_more\` to append small notes, and use \`change_mind\` for full-section rewrite/merge. If unsure, do not overwrite; prefer creating an extra section or appending small notes.`,
+                ];
             const maintenanceLine = isSideDialog
-                ? `- Side Dialogs cannot call \`mind_more\` / \`change_mind\`: ask the Taskdoc maintainer @${taskdocMaintainerId} to apply updates, and provide entries to append or a fully merged full-section replacement draft (do not overwrite/delete other contributors).`
+                ? `- Side Dialogs cannot call \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\`: ask the Taskdoc maintainer @${taskdocMaintainerId} to apply updates, and provide 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).`
                 : `- Maintenance: for small additions, prefer \`mind_more({\"items\":[\"...\"]})\` to append to \`progress\` (selector/category may be specified); when stale entries must be removed, reordered, or compressed, use \`change_mind\` for a full-section replacement.`;
             const bearEn = bearInMindStatus === 'absent'
                 ? 'absent'
@@ -285,9 +326,10 @@ If you provided a regular file path (e.g. a \`.md\`), that is unexpected. Please
                 `- Our Taskdoc is a \`*.tsk/\` directory: it always auto-injects the 3 top-level sections (\`goals\` / \`constraints\` / \`progress\`); it may auto-inject \`bearinmind/\` (fixed whitelist); any other sections are NOT auto-injected and must be read via \`recall_taskdoc\` (only an index is shown).`,
                 `- Team-shared: all 3 sections are visible to teammates and sideDialogs. Do not overwrite/delete other contributors; add an owner marker for entries you maintain (e.g. \`- [owner:@<id>] ...\`).`,
                 `- Section semantics: \`goals\` / \`constraints\` are the task contract; \`progress\` is the team-shared, quasi-real-time, scannable task bulletin board for current effective state, key decisions, next steps, and still-active blockers, not a personal “what I'm doing now” notebook.`,
-                `- Taskdoc maintainer (runs \`mind_more\` / \`change_mind\`): @${taskdocMaintainerId}`,
+                `- Taskdoc maintainer (runs \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\`): @${taskdocMaintainerId}`,
                 `- Important: Taskdoc content is injected inline into the context (the latest as of this generation). Review the injected Taskdoc; do not try to read files under \`*.tsk/\` via general file tools (they will be rejected).`,
                 maintenanceLine,
+                ...presentSectionLine,
                 ``,
                 `**Sections:**`,
                 `- \`goals.md\`: ${goalsStatus}`,
@@ -297,11 +339,7 @@ If you provided a regular file path (e.g. a \`.md\`), that is unexpected. Please
                 ...(bearExtrasLine ? [bearExtrasLine] : []),
                 ``,
                 extraSectionsBlock,
-                ``,
-                `If any section is missing, create it with the function tool \`change_mind\` (never via general file tools):`,
-                `- \`change_mind({\"selector\":\"goals\",\"content\":\"...\"})\``,
-                `- \`change_mind({\"selector\":\"constraints\",\"content\":\"...\"})\``,
-                `- \`change_mind({\"selector\":\"progress\",\"content\":\"...\"})\``,
+                ...missingSectionLines,
                 ...(violationsBlock ? ['', violationsBlock] : []),
             ].join('\n');
         })();
@@ -311,8 +349,8 @@ If you provided a regular file path (e.g. a \`.md\`), that is unexpected. Please
         if (bytes > maxSize) {
             if (language === 'zh') {
                 const howToUpdate = isSideDialog
-                    ? `⚠️ **注意：** 差遣牒是封装的。不要用文件工具去读/写/列目录 \`*.tsk/\` 下的任何路径。\n支线对话中不允许 \`mind_more\` / \`change_mind\`：请诉请差遣牒维护人 @${taskdocMaintainerId} 执行更新，并提供要追加的条目或合并好的“分段全文替换稿”（禁止覆盖/抹掉他人条目）。`
-                    : `⚠️ **注意：** 差遣牒是封装的。不要用文件工具去读/写/列目录 \`*.tsk/\` 下的任何路径。\n请在当前对话中用函数工具 \`mind_more\` 追加少量条目，或用 \`change_mind\` 做整章替换；禁止覆盖/抹掉他人条目。`;
+                    ? `⚠️ **注意：** 差遣牒是封装的。不要用文件工具去读/写/列目录 \`*.tsk/\` 下的任何路径。\n支线对话中不允许 \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\`：请诉请差遣牒维护人 @${taskdocMaintainerId} 执行更新，并提供要新增的章节、要追加的条目、合并好的“分段全文替换稿”或要删除的章节（禁止覆盖/抹掉他人条目）。`
+                    : `⚠️ **注意：** 差遣牒是封装的。不要用文件工具去读/写/列目录 \`*.tsk/\` 下的任何路径。\n请在当前对话中用函数工具 \`mind_more\` 追加少量条目，或用 \`change_mind\` 做整章替换；缺失章节用 \`do_mind\` 创建；禁止覆盖/抹掉他人条目。`;
                 return {
                     type: 'environment_msg',
                     role: 'user',
@@ -326,8 +364,8 @@ ${howToUpdate}`,
                 };
             }
             const howToUpdate = isSideDialog
-                ? `⚠️ **Note:** Taskdocs are encapsulated. Do not use file tools to read/write/list anything under \`*.tsk/\`.\nSide Dialogs cannot call \`mind_more\` / \`change_mind\`; ask the Taskdoc maintainer @${taskdocMaintainerId} with entries to append or a merged full-section replacement draft (do not overwrite/delete other contributors).`
-                : `⚠️ **Note:** Taskdocs are encapsulated. Do not use file tools to read/write/list anything under \`*.tsk/\`.\nIn this dialog, use \`mind_more\` for small append-only updates, or \`change_mind\` for full-section replacements; do not overwrite/delete other contributors.`;
+                ? `⚠️ **Note:** Taskdocs are encapsulated. Do not use file tools to read/write/list anything under \`*.tsk/\`.\nSide Dialogs cannot call \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\`; ask the Taskdoc maintainer @${taskdocMaintainerId} 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).`
+                : `⚠️ **Note:** Taskdocs are encapsulated. Do not use file tools to read/write/list anything under \`*.tsk/\`.\nIn this dialog, use \`mind_more\` for small append-only updates, or \`change_mind\` for full-section replacements; create missing sections with \`do_mind\`; do not overwrite/delete other contributors.`;
             return {
                 type: 'environment_msg',
                 role: 'user',
@@ -342,8 +380,8 @@ ${howToUpdate}`,
         }
         if (language === 'zh') {
             const footerLine = isSideDialog
-                ? `*支线对话中不允许 \`mind_more\` / \`change_mind\`：请诉请差遣牒维护人 @${taskdocMaintainerId} 执行更新，并提供要追加的条目或合并好的“分段全文替换稿”（禁止覆盖/抹掉他人条目）。*`
-                : `*在当前对话中用 \`mind_more\` 追加少量条目，或用 \`change_mind\` 替换整段；更新时禁止覆盖他人条目。*`;
+                ? `*支线对话中不允许 \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\`：请诉请差遣牒维护人 @${taskdocMaintainerId} 执行更新，并提供要新增的章节、要追加的条目、合并好的“分段全文替换稿”或要删除的章节（禁止覆盖/抹掉他人条目）。*`
+                : `*在当前对话中用 \`mind_more\` 追加少量条目，或用 \`change_mind\` 替换整段；缺失章节用 \`do_mind\` 创建；更新时禁止覆盖他人条目。*`;
             return {
                 type: 'environment_msg',
                 role: 'user',
@@ -365,8 +403,8 @@ ${footerLine}
             };
         }
         const footerLine = isSideDialog
-            ? `*Side Dialogs cannot call \`mind_more\` / \`change_mind\`; ask the Taskdoc maintainer @${taskdocMaintainerId} with entries to append or a merged full-section replacement draft (do not overwrite/delete other contributors).*`
-            : `*In this dialog, use \`mind_more\` for small append-only updates, or \`change_mind\` for full-section replacements; do not overwrite other contributors.*`;
+            ? `*Side Dialogs cannot call \`do_mind\` / \`mind_more\` / \`change_mind\` / \`never_mind\`; ask the Taskdoc maintainer @${taskdocMaintainerId} 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).*`
+            : `*In this dialog, use \`mind_more\` for small append-only updates, or \`change_mind\` for full-section replacements; create missing sections with \`do_mind\`; do not overwrite other contributors.*`;
         return {
             type: 'environment_msg',
             role: 'user',