dominds 1.20.3 → 1.20.5

package/README.md

@@ -156,7 +156,7 @@ There are two common ways to create an rtws:
 - **Recommended**: start from a scaffold/template (see [Quick Start](#quick-start)).
 - **Minimal**: start from an empty folder (see [Start from scratch](#start-from-scratch)).
 
-Dominds uses your current working directory as the runtime workspace (rtws). When you start `dominds`, the WebUI will automatically redirect you to `http://localhost:5666/setup` if the rtws is missing required configuration (for example `.minds/team.yaml` or provider env vars).
+Dominds uses your current working directory as the runtime workspace (rtws). When you start `dominds`, the WebUI listens on `5666` or the next available lower port, then automatically redirects to `/setup` if the rtws is missing required configuration (for example `.minds/team.yaml` or provider env vars).
 
 Note: In production mode, Dominds enables a local shared-secret auth key by default, so the browser may open with a URL containing `?auth=...`. Treat that token as sensitive.
 
@@ -195,7 +195,7 @@ dominds
 
 Then:
 
-1. Your browser should land on `http://localhost:5666/setup` (either directly, or via an automatic redirect).
+1. Your browser should land on the local WebUI `/setup` page (usually `http://localhost:5666/setup`, unless that port was already occupied).
 2. In **Setup**, pick a provider + model. If your template didn’t create `.minds/team.yaml`, use Setup to create/overwrite it (this writes a minimal `member_defaults` config).
 3. Still in **Setup**, set the required provider env var (the name comes from the provider catalog, e.g. `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `CODEX_HOME`, etc.).
    - The setup UI can write it to `.env.local` (all platforms), and on Linux/macOS it can also write into `~/.zshrc` / `~/.bashrc` in managed blocks. It also applies the value to the running server process immediately.
@@ -213,11 +213,11 @@ Starting from scratch means: create an empty folder, run `dominds`, let Setup ge
 mkdir my-rtws
 cd my-rtws
 
-# Starts the WebUI server and opens a browser (default port: 5666)
+# Starts the WebUI server and opens a browser (default port behavior: 5666-)
 dominds
 ```
 
-1. The WebUI should redirect you to `http://localhost:5666/setup` because the rtws has no `.minds/team.yaml` yet.
+1. The WebUI should redirect you to the local `/setup` page because the rtws has no `.minds/team.yaml` yet.
 2. In **Setup**:
    - Select a provider + model and click **Create `.minds/team.yaml`**.
    - Provide the required provider env var and write it to your shell rc (or set it manually). Setup applies it immediately to the running server.

package/README.zh.md

@@ -130,11 +130,11 @@ pnpm run lint:types
 dominds create web-scaffold my-project
 cd my-project
 
-# 2) 启动 WebUI（默认自动打开浏览器，默认端口 5666）
+# 2) 启动 WebUI（默认自动打开浏览器；未指定端口时等价于 5666-）
 dominds
 ```
 
-首次启动后，通常会自动跳转至 `http://localhost:5666/setup` 配置页面，按以下步骤操作：
+首次启动后，通常会自动跳转至本机 WebUI 的 `/setup` 配置页面（优先使用 `http://localhost:5666/setup`，如果端口被占用则自动尝试更小端口），按以下步骤操作：
 
 1. 选择提供商（provider）及模型（model），创建或覆盖 `.minds/team.yaml`（最小化可运行配置文件）。
 2. 根据提示设置提供商所需的环境变量（配置页可将变量写入 `.env.local`，并在 Linux/macOS 上额外支持写入 `~/.zshrc` 或 `~/.bashrc` 的托管区块）。

package/dist/access-control.js

@@ -312,12 +312,12 @@ function getAccessDeniedMessage(operation, targetPath, language = 'en') {
         lines.push('');
         if (language === 'zh') {
             lines.push(`- 说明：\`*.tsk/\` 是封装差遣牒。通用文件工具无法读/写/列目录/删除其中内容（硬编码无条件拒绝）。`);
-            lines.push(`- 提示：少量追加请使用 \`mind_more\`（默认 progress：\`mind_more({\"items\":[\"...\"]})\`）；整章替换请使用 \`change_mind\`（顶层：\`change_mind({\"selector\":\"goals|constraints|progress\",\"content\":\"...\"})\`；额外章节：\`change_mind({\"category\":\"<category>\",\"selector\":\"<selector>\",\"content\":\"...\"})\`）。`);
+            lines.push(`- 提示：新增章节请使用 \`do_mind\`；少量追加请使用 \`mind_more\`（默认 progress：\`mind_more({\"items\":[\"...\"]})\`）；改写已有整章请使用 \`change_mind\`（顶层：\`change_mind({\"selector\":\"goals|constraints|progress\",\"content\":\"...\"})\`；额外章节：\`change_mind({\"category\":\"<category>\",\"selector\":\"<selector>\",\"content\":\"...\"})\`）。`);
             lines.push(`- 提示：读取额外章节请使用函数工具 \`recall_taskdoc\`：\`recall_taskdoc({\"category\":\"<category>\",\"selector\":\"<selector>\"})\`。`);
         }
         else {
             lines.push(`- Note: \`*.tsk/\` is an encapsulated Taskdoc. It is hard-denied for all general file tools.`);
-            lines.push(`- Hint: For small append-only updates, use \`mind_more\` (defaults to progress: \`mind_more({\"items\":[\"...\"]})\`); for full-section replacements, use \`change_mind\` (top-level: \`change_mind({\"selector\":\"goals|constraints|progress\",\"content\":\"...\"})\`; extra sections: \`change_mind({\"category\":\"<category>\",\"selector\":\"<selector>\",\"content\":\"...\"})\`).`);
+            lines.push(`- Hint: To create a section, use \`do_mind\`; for small append-only updates, use \`mind_more\` (defaults to progress: \`mind_more({\"items\":[\"...\"]})\`); for full-section replacements of existing sections, use \`change_mind\` (top-level: \`change_mind({\"selector\":\"goals|constraints|progress\",\"content\":\"...\"})\`; extra sections: \`change_mind({\"category\":\"<category>\",\"selector\":\"<selector>\",\"content\":\"...\"})\`).`);
             lines.push(`- Hint: To read extra sections, use \`recall_taskdoc({\"category\":\"<category>\",\"selector\":\"<selector>\"})\`.`);
         }
     }

package/dist/cli/webui.d.ts

@@ -6,7 +6,7 @@
  *   dominds webui [options]
  *
  * Options:
- *   -p, --port <port>    Port to listen on (default: 5666)
+ *   -p, --port <port>    Port to listen on. Bare port is strict; suffix + tries higher ports; suffix - tries lower ports.
  *   -h, --host <host>    Host to bind to (default: localhost)
  *   --nobrowser          Do not open a browser (opt-out)
  *   -h, --help           Show help

package/dist/cli/webui.js

@@ -7,7 +7,7 @@
  *   dominds webui [options]
  *
  * Options:
- *   -p, --port <port>    Port to listen on (default: 5666)
+ *   -p, --port <port>    Port to listen on. Bare port is strict; suffix + tries higher ports; suffix - tries lower ports.
  *   -h, --host <host>    Host to bind to (default: localhost)
  *   --nobrowser          Do not open a browser (opt-out)
  *   -h, --help           Show help
@@ -19,6 +19,7 @@ const log_1 = require("../log");
 const work_language_1 = require("../runtime/work-language");
 const server_1 = require("../server");
 const auth_1 = require("../server/auth");
+const port_selection_1 = require("../server/port-selection");
 const log = (0, log_1.createLogger)('webui');
 function printHelp() {
     console.log(`
@@ -31,15 +32,18 @@ Note:
   rtws (runtime workspace) directory is \`process.cwd()\`. Use 'dominds -C <dir> webui' to run in another rtws.
 
 Options:
-  -p, --port <port>    Port to listen on (default: 5666)
+  -p, --port <port>    Port to listen on. Bare port is strict; suffix + tries higher ports; suffix - tries lower ports.
+                       Default without --port: auto from 5666 downward.
   -h, --host <host>    Host to bind to (default: localhost)
   --mode <dev|prod>    Server mode (default: prod; dev if NODE_ENV=dev)
   --nobrowser          Do not open a browser (opt-out)
   --help               Show this help message
 
 Examples:
-  dominds webui                   # Start on default port 5666
-  dominds webui -p 8888           # Start on port 8888
+  dominds webui                   # Start on 5666, or the next available lower port
+  dominds webui -p 8888           # Start strictly on port 8888
+  dominds webui -p 8888+          # Start on 8888, or the next available higher port
+  dominds webui -p 8888-          # Start on 8888, or the next available lower port
   dominds webui --mode dev        # Start in dev mode
   dominds webui --nobrowser       # Start without opening a browser
 `);
@@ -60,22 +64,38 @@ function openInBrowser(url) {
 }
 async function main() {
     const args = process.argv.slice(2);
-    let port = 5666;
+    let port;
     let host = 'localhost';
     let mode = process.env.NODE_ENV === 'dev' ? 'dev' : 'prod';
     let shouldOpen = true;
+    let strictPort = false;
+    let portAutoDirection = 'down';
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
         if (arg === '-p' || arg === '--port') {
             const next = args[i + 1];
-            if (!next || isNaN(parseInt(next))) {
-                console.error('Error: --port requires a valid port number');
+            const parsedPort = next ? (0, port_selection_1.parseWebuiPortSpec)(next) : null;
+            if (parsedPort === null) {
+                console.error('Error: --port requires a valid port number, optionally suffixed with + or -');
                 printHelp();
                 process.exit(1);
             }
-            port = parseInt(next);
+            port = parsedPort.port;
+            strictPort = parsedPort.strictPort;
+            portAutoDirection = parsedPort.portAutoDirection;
             i++;
         }
+        else if (arg.startsWith('--port=')) {
+            const parsedPort = (0, port_selection_1.parseWebuiPortSpec)(arg.slice('--port='.length));
+            if (parsedPort === null) {
+                console.error('Error: --port requires a valid port number, optionally suffixed with + or -');
+                printHelp();
+                process.exit(1);
+            }
+            port = parsedPort.port;
+            strictPort = parsedPort.strictPort;
+            portAutoDirection = parsedPort.portAutoDirection;
+        }
         else if (arg === '-h' || arg === '--host') {
             const next = args[i + 1];
             if (!next) {
@@ -114,7 +134,7 @@ async function main() {
         const { language: resolvedLanguage, source } = (0, work_language_1.resolveWorkLanguage)({ env: process.env });
         (0, work_language_1.setWorkLanguage)(resolvedLanguage);
         log.info(`working language: ${(0, work_language_1.getWorkLanguage)()} (source: ${source})`);
-        const started = await (0, server_1.startServer)({ port, host, mode });
+        const started = await (0, server_1.startServer)({ port, host, mode, strictPort, portAutoDirection });
         const httpServer = started.httpServer;
         const auth = started.auth;
         const baseUrl = `http://${started.host}:${started.port}`;

package/dist/dialog-factory.d.ts

@@ -4,6 +4,7 @@
  * Factory for creating Dialog instances with proper type hierarchy.
  * Provides a single point of dialog creation to ensure consistent initialization.
  */
+import type { CallSiteCourseNo, CallSiteGenseqNo } from '@longrun-ai/kernel/types/storage';
 import { Dialog, DialogID, DialogInitParams, DialogStore, MainDialog, SideDialog } from './dialog';
 /**
  * Factory for creating Dialog instances.
@@ -22,6 +23,8 @@ export declare class DialogFactory {
         originMemberId: string;
         askerDialogId: string;
         callId: string;
+        callSiteCourse: CallSiteCourseNo;
+        callSiteGenseq: CallSiteGenseqNo;
         sessionSlug?: string;
         collectiveTargets?: string[];
         effectiveFbrEffort?: number;

package/dist/dialog-factory.js

@@ -1,12 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DialogFactory = void 0;
-/**
- * Module: dialog-factory
- *
- * Factory for creating Dialog instances with proper type hierarchy.
- * Provides a single point of dialog creation to ensure consistent initialization.
- */
 const dialog_1 = require("./dialog");
 const dialog_global_registry_1 = require("./dialog-global-registry");
 const id_1 = require("./utils/id");
@@ -45,6 +39,8 @@ class DialogFactory {
                 originMemberId: options.originMemberId,
                 askerDialogId: options.askerDialogId,
                 callId: options.callId,
+                callSiteCourse: options.callSiteCourse,
+                callSiteGenseq: options.callSiteGenseq,
                 collectiveTargets: options.collectiveTargets,
                 effectiveFbrEffort: options.effectiveFbrEffort,
             },

package/dist/dialog-fork.js

@@ -140,7 +140,8 @@ function isPersistedMessageRecord(record) {
         case 'user_image_ingest_record':
         case 'sideDialog_request_record':
         case 'tellask_reply_resolution_record':
-        case 'tellask_call_anchor_record':
+        case 'tellask_anchor_record':
+        case 'tellask_callee_record':
         case 'gen_start_record':
         case 'gen_finish_record':
         case 'sideDialog_created_record':
@@ -212,7 +213,8 @@ function rewriteRecordForFork(record, newRootId) {
         case 'native_tool_call_record':
         case 'sideDialog_request_record':
         case 'tellask_reply_resolution_record':
-        case 'tellask_call_anchor_record':
+        case 'tellask_anchor_record':
+        case 'tellask_callee_record':
         case 'gen_start_record':
         case 'gen_finish_record':
             return record;

package/dist/dialog.d.ts

@@ -122,6 +122,8 @@ export interface AssignmentFromAsker {
     originMemberId: string;
     askerDialogId: string;
     callId: string;
+    callSiteCourse: CallSiteCourseNo;
+    callSiteGenseq: CallSiteGenseqNo;
     collectiveTargets?: string[];
     effectiveFbrEffort?: number;
 }
@@ -253,8 +255,11 @@ export declare abstract class Dialog {
         originMemberId: string;
         askerDialogId: string;
         callId: string;
+        callSiteCourse: CallSiteCourseNo;
+        callSiteGenseq: CallSiteGenseqNo;
         sessionSlug?: string;
         collectiveTargets?: string[];
+        effectiveFbrEffort?: number;
     }): Promise<SideDialog>;
     /**
      * Post a dialog event using the standard event registry.
@@ -468,6 +473,8 @@ export declare class SideDialog extends Dialog {
         originMemberId: string;
         askerDialogId: string;
         callId: string;
+        callSiteCourse: CallSiteCourseNo;
+        callSiteGenseq: CallSiteGenseqNo;
         sessionSlug?: string;
         collectiveTargets?: string[];
         effectiveFbrEffort?: number;
@@ -528,6 +535,8 @@ export declare class MainDialog extends Dialog {
         originMemberId: string;
         askerDialogId: string;
         callId: string;
+        callSiteCourse: CallSiteCourseNo;
+        callSiteGenseq: CallSiteGenseqNo;
         sessionSlug?: string;
         collectiveTargets?: string[];
         effectiveFbrEffort?: number;
@@ -561,6 +570,8 @@ export declare abstract class DialogStore {
         originMemberId: string;
         askerDialogId: string;
         callId: string;
+        callSiteCourse: CallSiteCourseNo;
+        callSiteGenseq: CallSiteGenseqNo;
         sessionSlug?: string;
         collectiveTargets?: string[];
         effectiveFbrEffort?: number;

package/dist/dialog.js

@@ -126,6 +126,8 @@ function buildSideDialogAssignmentPromptMeta(sideDialog) {
                     ownerDialogId: assignment.askerDialogId,
                     callType: 'B',
                     callId: assignment.callId,
+                    callSiteCourse: assignment.callSiteCourse,
+                    callSiteGenseq: assignment.callSiteGenseq,
                 },
             };
         case 'tellaskSessionless':
@@ -141,6 +143,8 @@ function buildSideDialogAssignmentPromptMeta(sideDialog) {
                     ownerDialogId: assignment.askerDialogId,
                     callType: 'C',
                     callId: assignment.callId,
+                    callSiteCourse: assignment.callSiteCourse,
+                    callSiteGenseq: assignment.callSiteGenseq,
                 },
             };
     }
@@ -1791,6 +1795,8 @@ class DialogStore {
             originMemberId: options.originMemberId,
             askerDialogId: options.askerDialogId,
             callId: options.callId,
+            callSiteCourse: options.callSiteCourse,
+            callSiteGenseq: options.callSiteGenseq,
             collectiveTargets: options.collectiveTargets,
             effectiveFbrEffort: options.effectiveFbrEffort,
         };

package/dist/docs/cli-usage.md

@@ -81,7 +81,7 @@ Start the web-based user interface for the current rtws. This provides a graphic
 
 **Options:**
 
-- `-p, --port <port>` - Port to listen on (default: 5666)
+- `-p, --port <port>` - Port to listen on; a bare port binds strictly, suffix `+` tries higher ports, and suffix `-` tries lower ports (omitting `--port` is equivalent to `5666-`)
 - `-h, --host <host>` - Host to bind to (default: localhost)
 - `-C, --cwd <dir>` - Change to rtws directory before starting
 - `--help` - Show help message
@@ -91,6 +91,7 @@ Start the web-based user interface for the current rtws. This provides a graphic
 ```bash
 dominds
 dominds webui -p 8080
+dominds webui -p 8080+
 dominds webui -C ./my-rtws
 ```
 

package/dist/docs/cli-usage.zh.md

@@ -81,7 +81,7 @@ dominds webui [options]
 
 **选项：**
 
-- `-p, --port <port>` - 监听的端口（默认：5666）
+- `-p, --port <port>` - 监听端口；裸端口严格绑定，后缀 `+` 向更大端口自动尝试，后缀 `-` 向更小端口自动尝试（未指定时等价于 `5666-`）
 - `-h, --host <host>` - 绑定的主机（默认：localhost）
 - `-C, --cwd <dir>` - 启动前更改 rtws 目录
 - `--help` - 显示帮助消息
@@ -89,12 +89,15 @@ dominds webui [options]
 **示例：**
 
 ```bash
-# 在默认端口启动 Web UI
+# 从 5666 开始，向更小端口尝试可用端口
 dominds
 
-# 在特定端口启动 Web UI
+# 严格绑定 8080；占用时启动失败
 dominds webui -p 8080
 
+# 从 8080 开始，向更大端口尝试可用端口
+dominds webui -p 8080+
+
 # 在特定 rtws 启动 Web UI
 dominds webui -C ./my-rtws
 ```

package/dist/docs/context-health.md

@@ -169,7 +169,7 @@ Current behavior:
   generations; configurable per model).
 - Each inserted prompt is split by the program according to dialog scope, so the agent does not decide
   whether it is in the Main Dialog or a Side Dialog:
-  - Main Dialog: update Taskdoc first with `mind_more` / `change_mind`, then curate reminders (at least one call)
+  - Main Dialog: create or update Taskdoc first with `do_mind` / `change_mind`, then curate reminders (at least one call)
   - Side Dialog: do not maintain Taskdoc and do not draft Taskdoc update proposals; directly curate sufficiently detailed reminders (at least one call)
   - `update_reminder` (preferred) / `add_reminder`
   - Default to one structured continuation-package reminder; if the current course is already under remediation and one structured reminder cannot be produced directly from already observed facts, rough multi-reminder carry-over is acceptable
@@ -182,7 +182,7 @@ When `level === 'critical'`, the driver enters a **countdown remediation** (max
 - On each turn, the driver records a **role=user prompt** (persisted as a user message) that is
   visible in the UI as a user prompt. The prompt is scope-specific:
   - Main Dialog prompt: first write undocumented discussion details that the next course needs to know
-    into the appropriate Taskdoc sections with `mind_more` / `change_mind`, then curate reminders via
+    into the appropriate Taskdoc sections with `do_mind` / `change_mind`, then curate reminders via
     `update_reminder` / `add_reminder`, and call `clear_mind`.
   - Side Dialog prompt: do not maintain Taskdoc and do not draft Taskdoc update proposals; directly
     maintain sufficiently detailed continuation-package reminders with no technical length limit, then

package/dist/docs/context-health.zh.md

@@ -130,7 +130,7 @@ Dominds 计算比率：
 - 进入 `caution` 时，Dominds 插入一次提示（入口注入）。
 - 保持在 `caution` 状态时，Dominds 按节奏重新插入（默认：每 **10** 次生成；可按模型配置）。
 - 每次插入的提示都由程序按范围分流，不要求智能体自己判断主线/支线：
-  - 主线对话：先使用 `mind_more` / `change_mind` 补齐差遣牒，再整理提醒项（至少一次调用）
+  - 主线对话：先使用 `do_mind` / `change_mind` 补齐差遣牒，再整理提醒项（至少一次调用）
   - 支线对话：不维护差遣牒，也不整理差遣牒更新提案；直接整理足够详尽的提醒项（至少一次调用）
   - `update_reminder`（首选）/ `add_reminder`
   - 在提醒项内维护接续包草稿
@@ -141,7 +141,7 @@ Dominds 计算比率：
 当 `level === 'critical'` 时，驱动程序进入**倒计时恢复**（最多 **5** 轮）：
 
 - 每轮，驱动程序记录一条 **role=user prompt**（持久化为用户消息），在 UI 中作为用户 prompt 可见。提示按范围分开：
-  - 主线对话提示：先用 `mind_more` / `change_mind` 把未落文档、且下一程需要知会的讨论细节写入差遣牒合适章节，再通过 `update_reminder` / `add_reminder` 整理提醒项并调用 `clear_mind`。
+  - 主线对话提示：先用 `do_mind` / `change_mind` 把未落文档、且下一程需要知会的讨论细节写入差遣牒合适章节，再通过 `update_reminder` / `add_reminder` 整理提醒项并调用 `clear_mind`。
   - 支线对话提示：不要维护差遣牒，也不要整理差遣牒更新提案；直接维护足够详尽的接续包提醒项，提醒项长度没有技术限制，然后调用 `clear_mind`。
 - 提示包含倒计时：经过 **N** 轮后系统将自动清空。
 - 当倒计时归零时，驱动程序**自动调用** `clear_mind`（带空参数；不要求 `reminder_content`），开始新一程且无需暂停。

package/dist/docs/design.md

@@ -412,7 +412,7 @@ For detailed implementation specifications, including core tools, technical arch
 **Key Implementation Components**:
 
 - **`clear_mind`**: Function tool for clearing conversational noise and starting a new course
-- **`change_mind`**: Function tool for updating authoritative Taskdocs across dialog hierarchies (no course reset)
+- **Taskdoc mutation tools**: `do_mind`, `mind_more`, `change_mind`, and `never_mind` update authoritative Taskdocs across dialog hierarchies (no course reset)
 - **Reminder Management**: Dialog-scoped working memory that persists across clarity operations
 - **Hierarchical Dialog Architecture**: Tree-structured dialogs with flat storage and autonomous management
 - **Memory Layers**: Dialog-scoped and rtws-persistent memory with autonomous evolution
@@ -549,9 +549,9 @@ dominds dialog start --taskdoc-path tasks/auth-system.tsk
 **Development Phase**:
 
 - Multiple dialog trees can reference the same Taskdoc
-- Team members collaborate by updating the same Taskdoc (via `change_mind` operations)
+- Team members collaborate by updating the same Taskdoc (via explicit Taskdoc mutation tools)
 - Progress tracking persists across conversations
-- Requirements evolve through `change_mind` operations
+- Requirements evolve through Taskdoc mutation operations
 - rtws hard rules:
   - `*.tsk/**` is encapsulated Taskdoc state and is hard-denied for all general file tools.
   - `.minds/**` is reserved rtws state (team config/memory/assets) and is hard-denied for all general file tools; manage it via dedicated tools like `team_mgmt`.

package/dist/docs/design.zh.md

@@ -412,7 +412,7 @@ Dominds 为 AI 智能体实现了**社会分工**——一种通过战略性心
 **关键实现组件：**
 
 - **`clear_mind`**：开启新一程对话的函数工具（用于清除对话噪音）
-- **`change_mind`**：用于跨对话层次结构更新权威差遣牒的函数工具（不会开启新一程对话）
+- **差遣牒变更工具**：`do_mind`、`mind_more`、`change_mind` 和 `never_mind` 用于跨对话层次结构更新权威差遣牒（不会开启新一程对话）
 - **提醒项管理**：跨清理操作持续存在的对话范围工作记忆
 - **层次对话架构**：具有扁平存储和自主管理的树结构对话
 - **记忆层**：具有自主演进的对话范围和 rtws 持久化记忆
@@ -547,9 +547,9 @@ dominds dialog start --taskdoc-path tasks/auth-system.tsk
 **开发阶段：**
 
 - 多个对话树可以引用相同的差遣牒
-- 团队成员通过 `change_mind` 操作更新相同的差遣牒进行协作
+- 团队成员通过显式差遣牒变更工具更新相同的差遣牒进行协作
 - 进度跟踪跨越对话持续存在
-- 要求通过 `change_mind` 操作演变
+- 要求通过差遣牒变更操作演变
 - rtws 硬性规则：
   - `*.tsk/**` 是封装的差遣牒状态，所有通用文件工具都硬性拒绝。
   - `.minds/**` 是保留的 rtws 状态（团队配置/内存/资产），所有通用文件工具都硬性拒绝；通过 `team_mgmt` 等专用工具进行管理。

package/dist/docs/dialog-system.md

@@ -813,24 +813,32 @@ Invoke the function tool `clear_mind` with:
 - Taskdoc remains unchanged and accessible
 - Reminders provide continuity across the clarity operation
 
-### `change_mind`
+### Taskdoc Mutation Tools
 
-**Purpose**: Update the shared Taskdoc content that all dialogs in the dialog tree reference (without starting a new dialog course). Treat the Taskdoc as the task’s **live coordination bulletin board**.
+**Purpose**: Mutate the shared Taskdoc content that all dialogs in the dialog tree reference (without starting a new dialog course). Treat the Taskdoc as the task’s **live coordination bulletin board**.
 
-**Function tool arguments**:
+**Tools**:
+
+- `do_mind`: create one new section; fails if the target already exists.
+- `mind_more`: append small entries to an existing section; defaults to `progress`.
+- `change_mind`: replace one existing section; fails if the target does not exist.
+- `never_mind`: delete one existing section.
 
-- `selector: "goals" | "constraints" | "progress"`
-- `content: string`
+**Common section arguments**:
+
+- `selector: "goals" | "constraints" | "progress"` for top-level sections; or a valid selector with `category`
+- `category?: string`
+- `content: string` for `do_mind` / `change_mind`
 
 Example:
 
 ```text
-Invoke the function tool `change_mind` with:
+Invoke `do_mind` to create a missing section, or `change_mind` to replace an existing section.
 ```
 
 **Behavior**:
 
-- Updates the rtws (runtime workspace) Taskdoc content (exactly one section file in a `*.tsk/` Taskdoc package)
+- Updates the rtws (runtime workspace) Taskdoc content (exactly one section file per call in a `*.tsk/` Taskdoc package)
 - **Does not change the Taskdoc path.** `dlg.taskDocPath` is immutable for the dialog's entire lifecycle.
 - The updated file immediately becomes available to all dialogs referencing it
 - **Does not start a new dialog course.** If starting a new dialog course is desired, use `clear_mind` separately.
@@ -840,7 +848,7 @@ Invoke the function tool `change_mind` with:
 
 **Implementation Notes**:
 
-- `change_mind` is only available in main dialogs (not sideDialogs); sideDialogs must ask the tellasker via a TellaskBack (`tellaskBack({ tellaskContent: "..." })`) to update the shared Taskdoc.
+- Taskdoc mutation tools are only available in main dialogs (not sideDialogs); sideDialogs must ask the Taskdoc maintainer to update the shared Taskdoc and provide the new section, append entries, merged replacement draft, or section deletion request.
 - For `*.tsk/` Taskdoc packages, the Taskdoc is encapsulated: general file tools must not read/write/list/delete anything under `*.tsk/`. See [`encapsulated-taskdoc.md`](./encapsulated-taskdoc.md).
 
 ---
@@ -855,7 +863,7 @@ Invoke the function tool `change_mind` with:
 
 - Scoped to individual dialogs
 - **Survive clear_mind operations**
-- **Survive change_mind operations**
+- **Survive Taskdoc mutation operations**
 - Provide guidance for refreshed mental focus
 - Support structured capture of insights, decisions, and next steps
 
@@ -1297,6 +1305,21 @@ sequenceDiagram
   end
 ```
 
+Call-site correspondence invariant: every `tellask` call-site `callId` must later have a
+same-`callId` historical correspondence point in the tellasker's dialog. A normal sideDialog reply,
+cross-course carryover, or registered-session replacement notice can close the call; silently removing
+or overwriting a pending round cannot.
+
+WebUI external-link invariant: every `/dl/*` URL must be generated at the business call site with the
+target semantics written out there; avoid generic deep-link helpers. `/dl/callsite` only means the
+originating bubble in the tellasker's dialog: `selfId/course` are tellasker-dialog coordinates, and
+`callId` is that dialog's function-call id. SideDialog assignment/update targets are not call sites;
+they use `/dl/dialog` for the sideDialog, or `/dl/genseq` once the delivered assignment `genseq` is
+known.
+When an existing registered sideDialog is reused, the WebUI first links the new call-site bubble to
+the sideDialog via `tellask_call_callee_evt`; the later `tellask_call_anchor_evt` upgrades that target
+to the delivered sideDialog `genseq`.
+
 #### TYPE C: Transient SideDialog Tellask (`Fresh Tellask`) (`tellaskSessionless({ targetAgentId: "agentId", tellaskContent: "..." })`; `freshBootsReasoning({ tellaskContent: "..." })` is FBR tool-less)
 
 ```mermaid
@@ -1437,7 +1460,7 @@ sequenceDiagram
 | Reminders     | Preserved                                    |
 | Registry      | Preserved                                    |
 
-`change_mind` is not a clarity operation; it updates Taskdoc content in-place and does not clear messages/Q4H/reminders/registry.
+Taskdoc mutation tools are not clarity operations; they update Taskdoc content in-place and do not clear messages/Q4H/reminders/registry.
 
 ---
 

package/dist/docs/dialog-system.zh.md

@@ -790,24 +790,32 @@ async function checkSideDialogRevival(askerDialog: Dialog): Promise<void> {
 - 差遣牒保持不变且可访问
 - 提醒在清晰操作中提供连续性
 
-### `change_mind`
+### 差遣牒变更工具
 
-**目的**：更新对话树中所有对话引用的共享差遣牒内容（不开启新一程对话）。把差遣牒当作任务的**实时协调公告板**。
+**目的**：变更对话树中所有对话引用的共享差遣牒内容（不开启新一程对话）。把差遣牒当作任务的**实时协调公告板**。
 
-**函数工具参数**：
+**工具**：
+
+- `do_mind`：创建一个新章节；若目标已存在则失败。
+- `mind_more`：向已有章节追加少量条目；默认追加到 `progress`。
+- `change_mind`：替换一个已有章节；若目标不存在则失败。
+- `never_mind`：删除一个已有章节。
+
+**通用章节参数**：
 
-- `selector: "goals" | "constraints" | "progress"`
-- `content: string`
+- 顶层章节使用 `selector: "goals" | "constraints" | "progress"`；额外章节使用有效 `selector` 加 `category`
+- `category?: string`
+- `do_mind` / `change_mind` 使用 `content: string`
 
 示例：
 
 ```text
-调用函数工具 `change_mind`：
+调用 `do_mind` 创建缺失章节，或调用 `change_mind` 替换已有章节。
 ```
 
 **行为**：
 
-- 更新 rtws（运行时工作区）差遣牒内容（`*.tsk/` 任务包中恰好一个章节文件）
+- 更新 rtws（运行时工作区）差遣牒内容（每次调用变更 `*.tsk/` 任务包中恰好一个章节文件）
 - **不更改差遣牒路径。** `dlg.taskDocPath` 在对话的整个生命周期中是不可变的。
 - 更新的文件立即对引用它的所有对话可用
 - **不开启新一程对话。** 如需开启新一程对话，请单独使用 `clear_mind`。
@@ -817,7 +825,7 @@ async function checkSideDialogRevival(askerDialog: Dialog): Promise<void> {
 
 **实现说明**：
 
-- `change_mind` 仅在主线对话中可用（不在支线对话中）；支线对话必须通过回问诉请（`tellaskBack({ tellaskContent: "..." })`）询问诉请者以更新共享差遣牒。
+- 差遣牒变更工具仅在主线对话中可用（不在支线对话中）；支线对话必须诉请差遣牒维护人更新共享差遣牒，并提供要新增的章节、要追加的条目、已合并好的替换稿或要删除的章节。
 - 对于 `*.tsk/` 差遣牒任务包，差遣牒是封装的：通用文件工具不得读取/写入/列出/删除 `*.tsk/` 下的任何内容。请参阅 [`encapsulated-taskdoc.zh.md`](./encapsulated-taskdoc.zh.md)。
 
 ---
@@ -832,7 +840,7 @@ async function checkSideDialogRevival(askerDialog: Dialog): Promise<void> {
 
 - 作用域为单个对话
 - **在 clear_mind 操作中存活**
-- **在 change_mind 操作中存活**
+- **在差遣牒变更操作中存活**
 - 为刷新后的精神焦点提供指导
 - 支持结构化捕获见解、决策和下一步
 
@@ -1279,6 +1287,17 @@ sequenceDiagram
   end
 ```
 
+call-site 呼应不变量：每个 `tellask` 发起点的 `callId`，后续都必须在诉请者对话历史里留下同
+`callId` 的呼应点。正常支线回复、跨程 carryover、已注册会话被更新后的替代通知都可以结束这次
+call；不能静默删除或覆盖 pending 轮次。
+
+WebUI 外链不变量：生成 `/dl/*` URL 时必须在业务现场显式写出目标语义，避免复用泛化 deep-link
+helper。`/dl/callsite` 只表示诉请者对话里的发起气泡：`selfId/course` 是诉请者对话坐标，`callId`
+是该对话内的 function-call id。支线投递/更新目标不是 call-site，应使用 `/dl/dialog` 指向支线对话，
+或在投递 `genseq` 已知后使用 `/dl/genseq` 指向支线对话内的投递生成。
+复用已有注册支线时，WebUI 先用 `tellask_call_callee_evt` 把新发起气泡连到支线对话；后续
+`tellask_call_anchor_evt` 到达后再升级为支线投递 `genseq`。
+
 #### TYPE C：瞬态支线对话诉请（一次性诉请）（`tellaskSessionless({ targetAgentId: "agentId", tellaskContent: "..." })`，或 `freshBootsReasoning({ tellaskContent: "..." })`）
 
 ```mermaid
@@ -1432,7 +1451,7 @@ sequenceDiagram
 | 提醒项   | 保留                            |
 | 注册表   | 保留                            |
 
-`change_mind` 不是清晰度操作；它就地更新差遣牒内容，不会清除消息/Q4H/提醒项/注册表。
+差遣牒变更工具不是清晰度操作；它们就地更新差遣牒内容，不会清除消息/Q4H/提醒项/注册表。
 
 ---
 

package/dist/docs/dominds-terminology.md

@@ -248,16 +248,16 @@ Example / 示例（概念）:
 - EN: **Taskdoc package** (ZH: **任务包**) is the on-disk directory ending in `.tsk/` that contains those three section files.
 - ZH: **任务包（Taskdoc package）**是落地到磁盘上的目录形态：以 `.tsk/` 结尾的目录，包含上述三个分段文件。
 
-- EN: Taskdocs are the "single source of truth" for team-shared task contracts. They MUST be edited via the explicit control tool `change_mind`; generic file tools are **banned** from reading/writing anything under `**/*.tsk/`.
-- ZH: 差遣牒是全队共享任务契约的"单一事实来源"。必须通过显式控制工具 `change_mind` 进行修改；通用文件工具**禁止**读/写 `**/*.tsk/` 下的任何内容。
+- EN: Taskdocs are the "single source of truth" for team-shared task contracts. They MUST be edited via explicit Taskdoc control tools (`do_mind`, `mind_more`, `change_mind`, `never_mind`); generic file tools are **banned** from reading/writing anything under `**/*.tsk/`.
+- ZH: 差遣牒是全队共享任务契约的"单一事实来源"。必须通过显式差遣牒控制工具（`do_mind`、`mind_more`、`change_mind`、`never_mind`）进行修改；通用文件工具**禁止**读/写 `**/*.tsk/` 下的任何内容。
 
 - EN: Practically: treat the Taskdoc as the task’s **live coordination bulletin board**. If a decision/status/next-step affects others, write it back to `progress` (or `constraints`) — don’t leave it only in chat or reminders.
 - ZH: 实践上：把差遣牒当作任务的**实时协调公告板**。任何会影响他人的关键决策/当前状态/下一步，都要写回 `progress`（或 `constraints`），不要只留在对话或提醒项里。
 
 #### Section selector / 分段选择器
 
-- EN: The selector passed to `change_mind`: `goals` / `constraints` / `progress`.
-- ZH: `change_mind` 的分段选择器：`goals` / `constraints` / `progress`。
+- EN: The selector passed to Taskdoc mutation tools: `goals` / `constraints` / `progress`.
+- ZH: 差遣牒变更工具的分段选择器：`goals` / `constraints` / `progress`。
 
 ### rtws（运行时工作区）