dominds 1.20.2 → 1.20.4

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

@@ -136,13 +136,32 @@ status: ok|error
 - 若你刚刚已经 `add_reminder` / `update_reminder` 完同一份接续信息，优先直接 `clear_mind({})`
 - 若不确定是否重复，少量重复可以接受；不要为了“绝不重复”而冒信息丢失风险
 
-### 5. change_mind
+### 5. do_mind
+
+创建新的差遣牒章节。若目标章节已存在，会失败。
+
+**参数：**
+
+- `selector`（必需）：章节选择器（goals/constraints/progress）
+- `category`（可选）：额外章节目录；与 `selector` 组合定位 `<category>/<selector>.md`
+- `content`（必需）：新章节内容
+
+**特点：**
+
+- 只创建，不覆盖已有内容
+- 适合创建缺失的常驻章节，或新增额外章节来保留细节，同时不触碰已有差遣牒正文
+- 若目标已存在且只需少量补充，用 `mind_more`；若需要整章改写/合并，用 `change_mind`
+- 不开启新 course
+- 变更对所有队友可见
+
+### 6. change_mind
 
 更新差遣牒章节。
 
 **参数：**
 
 - `selector`（必需）：章节选择器（goals/constraints/progress）
+- `category`（可选）：额外章节目录；与 `selector` 组合定位 `<category>/<selector>.md`
 - `content`（必需）：新内容（整段替换）
 
 **返回：**
@@ -155,12 +174,12 @@ updated_at: <更新时间戳>
 
 **特点：**
 
-- 每次调用替换整个章节
-- 不重置对话轮次
+- 每次调用替换已有的整个章节；不会创建缺失章节
+- 不开启新 course
 - 变更对所有队友可见
 - 约束规则：`constraints` 只写任务特有硬要求，不得重复系统提示/工具文档中的全局规则；一经发现重复，必须删除并告知用户
 
-### 6. mind_more
+### 7. mind_more
 
 向差遣牒章节追加条目；默认追加到 `progress`，用于降低整章替换压力。
 
@@ -184,10 +203,25 @@ mind_more({
 - 只追加，不会自动去重、改写或压缩旧内容
 - 适合给 `progress` 补一两条当前仍有效的状态、决策、下一步或阻塞
 - 不适合把每一步调查过程、长日志、完整方案或验收记录当流水账追加进去；这些细节应写入 rtws 正式文档，差遣牒只写摘要和文档定位 pointer
-- 若需要删除陈旧项、重排结构或压缩公告牌，仍使用 `change_mind` 做整章替换
+- 若需要删除陈旧项、重排结构或压缩公告牌，仍使用 `change_mind` 做整章替换；若要删除整个章节文件，使用 `never_mind`
 - 当同一主题已经有多条阶段记录时，优先 `change_mind` 合并成当前仍有效的简明公告，而不是继续 `mind_more`
 
-### 7. recall_taskdoc
+### 8. never_mind
+
+删除差遣牒章节文件。
+
+**参数：**
+
+- `selector`（必需）：章节选择器；顶层章节可用 `goals` / `constraints` / `progress`
+- `category`（可选）：额外章节目录；与 `selector` 组合定位 `<category>/<selector>.md`
+
+**特点：**
+
+- 只删除整章文件，不做内容编辑
+- 仅用于章节整体不再成立；如果只是删除几条陈旧项或压缩结构，优先用 `change_mind` 写回整理后的全文
+- 不开启新 course
+
+### 9. recall_taskdoc
 
 读取差遣牒章节。
 

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

@@ -90,7 +90,7 @@ The `personal_memory` toolset uses a **path key-value storage** model:
 
 - **team_memory**: Team shared memory, visible to all members
 - **reminder**: Temporary reminder, session-level
-- **mind_more / change_mind**: Append to or replace Taskdoc (goals/constraints/progress)
+- **do_mind / mind_more / change_mind / never_mind**: Create, append to, replace, or delete Taskdoc sections
 
 ## Limitations and Notes
 

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

@@ -90,7 +90,7 @@ personal_memory 工具集采用**路径键值存储**模型：
 
 - **team_memory**：团队共享记忆，所有成员可见
 - **reminder**：临时提醒，会话级别
-- **mind_more / change_mind**：追加或替换差遣牒（goals/constraints/progress）
+- **do_mind / mind_more / change_mind / never_mind**：创建、追加、替换或删除差遣牒章节
 
 ## 限制与注意事项
 

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

@@ -80,7 +80,7 @@ The team_memory toolset uses a **path key-value storage** model, similar to pers
 
 - **personal_memory**: Personal memory, only current agent visible
 - **reminder**: Temporary reminder, session-level
-- **mind_more / change_mind**: Append to or replace Taskdoc (goals/constraints/progress)
+- **do_mind / mind_more / change_mind / never_mind**: Create, append to, replace, or delete Taskdoc sections
 
 > Note: `team_memory` carries long-lived team consensus; Taskdoc `progress` carries quasi-real-time team-wide task announcements during execution. Do not mix them.
 

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

@@ -80,7 +80,7 @@ team_memory 工具集采用**路径键值存储**模型，与 personal_memory
 
 - **personal_memory**：个人记忆，仅当前智能体可见
 - **reminder**：临时提醒，会话级别
-- **mind_more / change_mind**：追加或替换差遣牒（goals/constraints/progress）
+- **do_mind / mind_more / change_mind / never_mind**：创建、追加、替换或删除差遣牒章节
 
 > 注：`team_memory` 承接团队长期共识；Taskdoc `progress` 承接任务执行期的准实时全队公告，不应混淆。
 

package/dist/tools/registry.d.ts

@@ -11,6 +11,12 @@ export declare const toolsRegistry: Map<string, Tool>;
 export declare const toolsetsRegistry: Map<string, Tool[]>;
 export type ToolsetMeta = {
     source?: ToolsetSource;
+    /**
+     * Whether `.minds/team.yaml` may assign this toolset to members. Defaults to
+     * true. Set false for intrinsic runtime toolsets that must be injected by the
+     * system according to dialog scope rather than granted by team config.
+     */
+    assignable?: boolean;
     descriptionI18n?: I18nText;
     /**
      * Toolset-level prompt injected into the agent system prompt when the member

package/dist/tools/team_mgmt.js

@@ -3221,7 +3221,7 @@ function renderPermissionsManual(language) {
                 '模式支持 `*` 和 `**`，按“目录范围”语义匹配（按目录/路径前缀范围来理解）。',
                 '示例：`dominds/**` 会匹配 `dominds/README.md`、`dominds/main/server.ts`、`dominds/webapp/src/...` 等路径。',
                 '示例：`.minds/**` 会匹配 `.minds/team.yaml`、`.minds/team/<id>/persona.zh.md` 等；常用于限制普通成员访问 minds 资产。',
-                '`*.tsk/` 是封装差遣牒：只能用函数工具 `mind_more` / `change_mind` 维护。任何通用文件工具都无法访问该目录树（硬编码无条件拒绝）。',
+                '`*.tsk/` 是封装差遣牒：只能用函数工具 `do_mind` / `mind_more` / `change_mind` / `never_mind` 维护。任何通用文件工具都无法访问该目录树（硬编码无条件拒绝）。',
                 '`.minds/**` 是 rtws（运行时工作区）的“团队配置/记忆/资产”目录：任何通用文件工具都无法访问（硬编码无条件拒绝）。只有专用的 `.minds/` 工具集（例如 `team_mgmt`）可访问它。',
                 '在当前内建模型中，`.minds/team/**`、`.minds/team.yaml`、`.minds/skills/**`、`.minds/priming/**` 等团队资产目录，只有持有 `team_mgmt` 的成员才应修改。',
                 '`.minds/team/<id>/*` 的“角色归属对象”只表示它描述哪个角色，不构成任何额外写权限。未持有 `team_mgmt` 的成员，即使只是想更新“自己的” persona/knowhow/pitfalls，也应通过回贴建议内容，由具备权限的团队管理者代写。',
@@ -3249,7 +3249,7 @@ function renderPermissionsManual(language) {
             'Patterns support `*` and `**` with directory-scope semantics (think directory/path-range matching).',
             'Example: `dominds/**` matches `dominds/README.md`, `dominds/main/server.ts`, `dominds/webapp/src/...`, etc.',
             'Example: `.minds/**` matches `.minds/team.yaml` and `.minds/team/<id>/persona.*.md`; commonly used to restrict normal members from minds assets.',
-            '`*.tsk/` is an encapsulated Taskdoc: it must be maintained via `mind_more` / `change_mind` only. It is hard-denied for all general file tools.',
+            '`*.tsk/` is an encapsulated Taskdoc: it must be maintained via `do_mind` / `mind_more` / `change_mind` / `never_mind` only. It is hard-denied for all general file tools.',
             '`.minds/**` stores rtws (runtime workspace) team config/memory/assets: it is hard-denied for all general file tools. Only dedicated `.minds/`-scoped toolsets (e.g. `team_mgmt`) may access it.',
             'In the current built-in model, team asset paths such as `.minds/team/**`, `.minds/team.yaml`, `.minds/skills/**`, and `.minds/priming/**` should only be modified by members who hold `team_mgmt`.',
             'The “owner role” of `.minds/team/<id>/*` only tells you which role the asset describes; it does not grant extra write permission. Without `team_mgmt`, a member should not rewrite even “their own” persona/knowhow/pitfalls directly, and should instead hand back suggested content for an authorized team manager to apply.',
@@ -3767,11 +3767,11 @@ function renderToolsetCapabilitySummary(language, ids, toolsetsById) {
 async function renderToolsets(language) {
     const windowsHost = isWindowsRuntimeHost();
     const toolsetsById = (0, registry_2.listToolsets)();
-    const ids = Object.keys(toolsetsById).filter((id) => id !== 'control');
+    const ids = Object.keys(toolsetsById).filter((id) => (0, registry_2.getToolsetMeta)(id)?.assignable !== false);
     const header = language === 'zh' ? fmtHeader('已注册 toolsets') : fmtHeader('Registered toolsets');
     const intro = language === 'zh'
         ? fmtList([
-            '`control`：对话控制类工具属于“内建必备能力”，运行时会自动包含给所有成员；因此不需要（也不建议）在 `members.<id>.toolsets` 里显式列出，本页也默认不展示它。',
+            '`control`：对话控制类工具属于内建运行时能力，会按对话范围自动注入；不能在 `members.<id>.toolsets` 里显式列出，本页也默认不展示它。',
             '`diag`：诊断类工具集不应默认授予任何成员；仅当用户明确要求“诊断/排查/验证解析/流式分段”等能力时才添加。',
             '多数情况下推荐用 `members.<id>.toolsets` 做粗粒度授权；`members.<id>.tools` 更适合做少量补充/收敛。',
             windowsHost
@@ -3785,7 +3785,7 @@ async function renderToolsets(language) {
             '常见三种模式（示例写在 `.minds/team.yaml` 的 `members.<id>.toolsets` 下）：',
         ])
         : fmtList([
-            '`control`: dialog-control tools are intrinsic and automatically included for all members at runtime; you do not need (and should not) list it under `members.<id>.toolsets`. It is omitted from the list below.',
+            '`control`: dialog-control tools are intrinsic runtime capabilities injected according to dialog scope; it cannot be listed under `members.<id>.toolsets`. It is omitted from the list below.',
             '`diag`: diagnostics tools should not be granted by default; only add it when the user explicitly asks for diagnostics/troubleshooting/streaming-parse verification.',
             'Typically use `members.<id>.toolsets` for coarse-grained access; use `members.<id>.tools` for a small number of additions/limits.',
             windowsHost

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

@@ -121,7 +121,21 @@ export declare function updateTaskPackageByChangeMindTarget(params: {
     target: TaskPackageChangeMindTarget;
     content: string;
     updatedBy?: string;
-}): Promise<void>;
+}): Promise<{
+    kind: 'updated';
+} | {
+    kind: 'missing';
+}>;
+export declare function createTaskPackageByChangeMindTarget(params: {
+    taskPackageDirFullPath: string;
+    target: TaskPackageChangeMindTarget;
+    content: string;
+    updatedBy?: string;
+}): Promise<{
+    kind: 'created';
+} | {
+    kind: 'exists';
+}>;
 export declare function appendTaskPackageByChangeMindTarget(params: {
     taskPackageDirFullPath: string;
     target: TaskPackageChangeMindTarget;
@@ -129,6 +143,15 @@ export declare function appendTaskPackageByChangeMindTarget(params: {
     sep: string;
     updatedBy?: string;
 }): Promise<void>;
+export declare function deleteTaskPackageByChangeMindTarget(params: {
+    taskPackageDirFullPath: string;
+    target: TaskPackageChangeMindTarget;
+}): Promise<{
+    kind: 'deleted';
+} | {
+    kind: 'missing';
+}>;
+export declare function taskPackageRelativePathForChangeMindTarget(target: TaskPackageChangeMindTarget): string;
 export declare function ensureTaskPackage(taskPackageDirFullPath: string, _updatedBy?: string): Promise<void>;
 export declare function readTaskPackageSections(taskPackageDirFullPath: string): Promise<TaskPackageSectionsState>;
 export declare function formatEffectiveTaskDocFromSections(language: LanguageCode, sections: TaskPackageSectionsState, bearInMind?: TaskPackageBearInMindState): string;

package/dist/utils/task-package.js

@@ -53,7 +53,10 @@ exports.parseTaskPackageChangeMindTarget = parseTaskPackageChangeMindTarget;
 exports.taskPackageFilenameForSection = taskPackageFilenameForSection;
 exports.bearInMindFilenameForSection = bearInMindFilenameForSection;
 exports.updateTaskPackageByChangeMindTarget = updateTaskPackageByChangeMindTarget;
+exports.createTaskPackageByChangeMindTarget = createTaskPackageByChangeMindTarget;
 exports.appendTaskPackageByChangeMindTarget = appendTaskPackageByChangeMindTarget;
+exports.deleteTaskPackageByChangeMindTarget = deleteTaskPackageByChangeMindTarget;
+exports.taskPackageRelativePathForChangeMindTarget = taskPackageRelativePathForChangeMindTarget;
 exports.ensureTaskPackage = ensureTaskPackage;
 exports.readTaskPackageSections = readTaskPackageSections;
 exports.formatEffectiveTaskDocFromSections = formatEffectiveTaskDocFromSections;
@@ -185,11 +188,44 @@ function bearInMindFilenameForSection(section) {
     return bearInMindSectionToFilename[section];
 }
 async function updateTaskPackageByChangeMindTarget(params) {
+    const { taskPackageDirFullPath, target, content } = params;
+    const filePath = taskPackageFilePathForChangeMindTarget(taskPackageDirFullPath, target);
+    try {
+        const st = await fs.promises.stat(filePath);
+        if (!st.isFile()) {
+            throw new Error(`Taskdoc section target is not a file: ${filePath}`);
+        }
+        await writeExistingMarkdownFileWithCanonicalEnding(filePath, content);
+        return { kind: 'updated' };
+    }
+    catch (err) {
+        if (typeof err === 'object' &&
+            err !== null &&
+            'code' in err &&
+            err.code === 'ENOENT') {
+            return { kind: 'missing' };
+        }
+        throw err;
+    }
+}
+async function createTaskPackageByChangeMindTarget(params) {
     const { taskPackageDirFullPath, target, content, updatedBy } = params;
     await ensureTaskPackage(taskPackageDirFullPath, updatedBy);
     const filePath = taskPackageFilePathForChangeMindTarget(taskPackageDirFullPath, target);
     await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
-    await writeMarkdownFileWithCanonicalEnding(filePath, content);
+    try {
+        await writeNewMarkdownFileWithCanonicalEnding(filePath, content);
+        return { kind: 'created' };
+    }
+    catch (err) {
+        if (typeof err === 'object' &&
+            err !== null &&
+            'code' in err &&
+            err.code === 'EEXIST') {
+            return { kind: 'exists' };
+        }
+        throw err;
+    }
 }
 async function appendTaskPackageByChangeMindTarget(params) {
     const { taskPackageDirFullPath, target, content, sep, updatedBy } = params;
@@ -200,29 +236,68 @@ async function appendTaskPackageByChangeMindTarget(params) {
     const next = current === null || current.trim() === '' ? content : joinForAppend(current, content, sep);
     await writeMarkdownFileWithCanonicalEnding(filePath, next);
 }
+async function deleteTaskPackageByChangeMindTarget(params) {
+    const filePath = taskPackageFilePathForChangeMindTarget(params.taskPackageDirFullPath, params.target);
+    try {
+        const st = await fs.promises.stat(filePath);
+        if (!st.isFile()) {
+            throw new Error(`Taskdoc section target is not a file: ${filePath}`);
+        }
+        await fs.promises.unlink(filePath);
+        return { kind: 'deleted' };
+    }
+    catch (err) {
+        if (typeof err === 'object' &&
+            err !== null &&
+            'code' in err &&
+            err.code === 'ENOENT') {
+            return { kind: 'missing' };
+        }
+        throw err;
+    }
+}
 async function writeMarkdownFileWithCanonicalEnding(filePath, content) {
     await fs.promises.writeFile(filePath, withCanonicalMarkdownFileEnding(content), 'utf8');
 }
+async function writeExistingMarkdownFileWithCanonicalEnding(filePath, content) {
+    const handle = await fs.promises.open(filePath, 'r+');
+    try {
+        await handle.truncate(0);
+        await handle.writeFile(withCanonicalMarkdownFileEnding(content), 'utf8');
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function writeNewMarkdownFileWithCanonicalEnding(filePath, content) {
+    await fs.promises.writeFile(filePath, withCanonicalMarkdownFileEnding(content), {
+        encoding: 'utf8',
+        flag: 'wx',
+    });
+}
 function withCanonicalMarkdownFileEnding(content) {
     const stripped = stripTrailingMarkdownFileNewlines(content);
     if (stripped === '')
         return '';
     return `${stripped}\n`;
 }
-function taskPackageFilePathForChangeMindTarget(taskPackageDirFullPath, target) {
+function taskPackageRelativePathForChangeMindTarget(target) {
     switch (target.kind) {
         case 'top_level':
-            return path.join(taskPackageDirFullPath, taskPackageFilenameForSection(target.section));
+            return taskPackageFilenameForSection(target.section);
         case 'bearinmind':
-            return path.join(taskPackageDirFullPath, 'bearinmind', bearInMindFilenameForSection(target.section));
+            return path.join('bearinmind', bearInMindFilenameForSection(target.section));
         case 'category':
-            return path.join(taskPackageDirFullPath, target.category, `${target.selector}.md`);
+            return path.join(target.category, `${target.selector}.md`);
         default: {
             const _exhaustive = target;
             return _exhaustive;
         }
     }
 }
+function taskPackageFilePathForChangeMindTarget(taskPackageDirFullPath, target) {
+    return path.join(taskPackageDirFullPath, taskPackageRelativePathForChangeMindTarget(target));
+}
 async function readTextFileIfPresent(filePath) {
     try {
         return await fs.promises.readFile(filePath, 'utf8');

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

@@ -0,0 +1,12 @@
+import type { SearchTaskDocumentSuggestionsResult } from './taskdoc-search';
+export type TaskdocSuggestionWorkerPayload = {
+    rootDir?: string;
+    query: string;
+    limit?: number;
+};
+type TaskdocSuggestionWorkerOptions = {
+    signal?: AbortSignal;
+};
+export declare function buildTaskDocumentSuggestionRequestKey(payload: TaskdocSuggestionWorkerPayload): string;
+export declare function searchTaskDocumentSuggestionsInWorker(payload: TaskdocSuggestionWorkerPayload, options?: TaskdocSuggestionWorkerOptions): Promise<SearchTaskDocumentSuggestionsResult>;
+export {};