dominds 1.25.17 → 1.25.19

package/dist/bootstrap/rtws-cli.d.ts

@@ -4,5 +4,4 @@ export type RtwsCliParseResult = Readonly<{
 }>;
 export declare function extractGlobalRtwsChdir(params: Readonly<{
     argv: ReadonlyArray<string>;
-    baseCwd: string;
 }>): RtwsCliParseResult;

package/dist/bootstrap/rtws-cli.js

@@ -38,6 +38,12 @@ const path = __importStar(require("path"));
 function extractGlobalRtwsChdir(params) {
     let chdir;
     const out = [];
+    const readAbsoluteChdir = (argName, value) => {
+        if (!path.isAbsolute(value)) {
+            throw new Error(`${argName} requires an absolute directory path: ${value}`);
+        }
+        return value;
+    };
     for (let i = 0; i < params.argv.length; i++) {
         const arg = params.argv[i];
         if (arg === '--') {
@@ -49,7 +55,7 @@ function extractGlobalRtwsChdir(params) {
             if (typeof next !== 'string' || next.length === 0 || next === '--') {
                 throw new Error(`${arg} requires a directory argument`);
             }
-            chdir = path.isAbsolute(next) ? next : path.resolve(params.baseCwd, next);
+            chdir = readAbsoluteChdir(arg, next);
             i++;
             continue;
         }
@@ -57,14 +63,14 @@ function extractGlobalRtwsChdir(params) {
             const value = arg.slice('--cwd='.length);
             if (value.length === 0)
                 throw new Error(`--cwd requires a directory argument`);
-            chdir = path.isAbsolute(value) ? value : path.resolve(params.baseCwd, value);
+            chdir = readAbsoluteChdir('--cwd', value);
             continue;
         }
         if (arg.startsWith('--chdir=')) {
             const value = arg.slice('--chdir='.length);
             if (value.length === 0)
                 throw new Error(`--chdir requires a directory argument`);
-            chdir = path.isAbsolute(value) ? value : path.resolve(params.baseCwd, value);
+            chdir = readAbsoluteChdir('--chdir', value);
             continue;
         }
         out.push(arg);

package/dist/cli/create.d.ts

@@ -8,7 +8,7 @@
  *
  * Notes:
  * - Template can be a short name (resolved via DOMINDS_TEMPLATE_BASE) or a git URL.
- * - rtws directory is `process.cwd()`. Use 'dominds -C <dir> create ...' to create under another base dir.
+ * - rtws directory is `process.cwd()`. Use 'dominds -C <abs-dir> create ...' to create under another base dir.
  */
 declare function main(argv?: readonly string[]): Promise<void>;
 export { main };

package/dist/cli/create.js

@@ -9,7 +9,7 @@
  *
  * Notes:
  * - Template can be a short name (resolved via DOMINDS_TEMPLATE_BASE) or a git URL.
- * - rtws directory is `process.cwd()`. Use 'dominds -C <dir> create ...' to create under another base dir.
+ * - rtws directory is `process.cwd()`. Use 'dominds -C <abs-dir> create ...' to create under another base dir.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;

package/dist/cli/read.js

@@ -59,7 +59,7 @@ function printUsage() {
     console.log('`--audit` runs prompt audit via hidden teammate @fuxi using default LLM config (skips when unavailable), and also includes static toolset checks (registry vs `.minds/mcp.yaml` declarations).');
     console.log('When <member-id> is omitted, reads all visible team members.');
     console.log('');
-    console.log("Note: rtws (runtime workspace) directory is `process.cwd()`. Use 'dominds -C <dir> read' to run in another rtws.");
+    console.log("Note: rtws (runtime workspace) directory is `process.cwd()`. Use 'dominds -C <abs-dir> read' to run in another rtws.");
     console.log('');
     console.log('Examples:');
     console.log('  dominds read                    # Read all team members');

package/dist/cli/tui.js

@@ -76,7 +76,7 @@ function showHelp() {
     console.log('');
     console.log('Start or continue a dialog with an AI team member using a Taskdoc.');
     console.log('');
-    console.log("Note: rtws (runtime workspace) directory is `process.cwd()`. Use 'dominds -C <dir> tui ...' to run in another rtws.");
+    console.log("Note: rtws (runtime workspace) directory is `process.cwd()`. Use 'dominds -C <abs-dir> tui ...' to run in another rtws.");
     console.log('');
     console.log('Arguments:');
     console.log('  <taskdoc-path>    Path to Taskdoc (required for dialog)');

package/dist/cli/webui.js

@@ -30,7 +30,7 @@ Usage:
   dominds webui [options]
 
 Note:
-  rtws (runtime workspace) directory is \`process.cwd()\`. Use 'dominds -C <dir> webui' to run in another rtws.
+  rtws (runtime workspace) directory is \`process.cwd()\`. Use 'dominds -C <abs-dir> webui' to run in another rtws.
 
 Options:
   -p, --port <port>    Port to listen on. Bare port is strict; suffix + tries higher ports; suffix - tries lower ports.

package/dist/cli.js

@@ -107,10 +107,10 @@ function printHelp() {
 Dominds CLI - AI-driven DevOps framework with persistent memory
 
 Usage:
-  dominds [-C <dir>] [subcommand] [options]
+  dominds [-C <abs-dir>] [subcommand] [options]
 
 Global Options:
-  -C <dir>            Change to runtime workspace directory (rtws) before running
+  -C <abs-dir>        Change to absolute runtime workspace directory (rtws) before running
 
 Subcommands:
   webui [options]    Start WebUI server (default)
@@ -133,7 +133,7 @@ Subcommands:
 Examples:
   dominds                    # Start WebUI server (default)
   dominds webui              # Start WebUI server
-  dominds -C ./my-ws webui   # Start in specific rtws
+  dominds -C /path/to/my-ws webui # Start in specific rtws
   dominds tui --help         # Show TUI help
   dominds run task.tsk       # Run task dialog
   dominds read               # Read team configuration
@@ -159,10 +159,9 @@ function printVersion() {
     }
 }
 async function main(argv = process.argv.slice(2)) {
-    const baseCwd = process.cwd();
     let parsed;
     try {
-        parsed = (0, rtws_cli_1.extractGlobalRtwsChdir)({ argv, baseCwd });
+        parsed = (0, rtws_cli_1.extractGlobalRtwsChdir)({ argv });
     }
     catch (err) {
         console.error('Error:', err instanceof Error ? err.message : String(err));
@@ -173,10 +172,7 @@ async function main(argv = process.argv.slice(2)) {
     if (args.length === 0) {
         if (parsed.chdir) {
             try {
-                const absoluteRtwsRoot = path.isAbsolute(parsed.chdir)
-                    ? parsed.chdir
-                    : path.resolve(baseCwd, parsed.chdir);
-                process.chdir(absoluteRtwsRoot);
+                process.chdir(parsed.chdir);
             }
             catch (err) {
                 console.error(`Error: failed to change directory to '${parsed.chdir}':`, err);
@@ -222,10 +218,7 @@ async function main(argv = process.argv.slice(2)) {
     if (!shouldSkipRtwsSetup) {
         if (parsed.chdir) {
             try {
-                const absoluteRtwsRoot = path.isAbsolute(parsed.chdir)
-                    ? parsed.chdir
-                    : path.resolve(baseCwd, parsed.chdir);
-                process.chdir(absoluteRtwsRoot);
+                process.chdir(parsed.chdir);
             }
             catch (err) {
                 console.error(`Error: failed to change directory to '${parsed.chdir}':`, err);

package/dist/docs/cli-usage.md

@@ -4,7 +4,7 @@ Chinese version: [中文版](./cli-usage.zh.md)
 
 The `dominds` CLI provides a unified entry point, but the **primary interaction experience is the Web UI** (the default `dominds` command). This guide focuses on the Web UI workflow.
 
-> Note: In this document, **rtws (runtime workspace)** refers to the runtime root directory Dominds uses (by default `process.cwd()`, switchable via `-C <dir>`).
+> Note: In this document, **rtws (runtime workspace)** refers to the runtime root directory Dominds uses (by default `process.cwd()`, switchable via `-C <abs-dir>`; `-C` only accepts absolute paths).
 
 > Note: `dominds tui` / `dominds run` are currently reserved subcommand names and do not have a stable implementation yet. As a result, this guide does not document TUI options or detailed usage.
 
@@ -49,7 +49,7 @@ dominds webui [options]
 
 # Common: choose port / rtws
 dominds webui -p 8080
-dominds webui -C ./my-rtws
+dominds webui -C /path/to/my-rtws
 
 # Minds reader: inspect team configuration
 dominds read [options] [member-id]
@@ -83,7 +83,7 @@ Start the web-based user interface for the current rtws. This provides a graphic
 
 - `-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
+- `-C, --cwd <abs-dir>` - Change to rtws directory before starting; absolute paths only
 - `--help` - Show help message
 
 **Examples:**
@@ -92,7 +92,7 @@ Start the web-based user interface for the current rtws. This provides a graphic
 dominds
 dominds webui -p 8080
 dominds webui -p 8080+
-dominds webui -C ./my-rtws
+dominds webui -C /path/to/my-rtws
 ```
 
 **Common use cases:**
@@ -122,7 +122,7 @@ Read and inspect agent prompts/configuration for the rtws. This is commonly used
 
 **Options:**
 
-- `-C, --cwd <dir>` - Change to rtws directory before reading
+- `-C, --cwd <abs-dir>` - Change to rtws directory before reading; absolute paths only
 - `--only-prompt` - Show only system prompts
 - `--only-mem` - Show only memory
 - `--help` - Show help message
@@ -132,7 +132,7 @@ Read and inspect agent prompts/configuration for the rtws. This is commonly used
 ```bash
 dominds read
 dominds read developer
-dominds read -C ./my-rtws
+dominds read -C /path/to/my-rtws
 dominds read --only-prompt
 dominds read --only-mem
 ```
@@ -190,7 +190,7 @@ dominds
 dominds webui -p 8080
 
 # 3) Start in a specific rtws
-dominds webui -C ./my-rtws
+dominds webui -C /path/to/my-rtws
 
 # 4) Inspect current team/rtws configuration
 dominds read

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

@@ -4,7 +4,7 @@
 
 `dominds` 提供统一的命令行入口，但**主要交互界面是 Web UI**（默认命令 `dominds`）。本文档以 Web UI 工作流为主。
 
-> 注：本文统一使用 **rtws（运行时工作区）** 表示 Dominds 运行时使用的根目录（默认等于 `process.cwd()`，可通过 `-C <dir>` 切换）。
+> 注：本文统一使用 **rtws（运行时工作区）** 表示 Dominds 运行时使用的根目录（默认等于 `process.cwd()`，可通过 `-C <abs-dir>` 切换；`-C` 只接受绝对路径）。
 
 > 说明：`dominds tui` / `dominds run` 相关功能目前尚未提供稳定实现（子命令名保留用于未来规划），因此本指南不再展开 TUI 的命令选项与用法细节。
 
@@ -49,7 +49,7 @@ dominds webui [options]
 
 # 常用：指定端口 / rtws
 dominds webui -p 8080
-dominds webui -C ./my-rtws
+dominds webui -C /path/to/my-rtws
 
 # Minds 阅读器：分析团队配置
 dominds read [options] [member-id]
@@ -83,7 +83,7 @@ dominds webui [options]
 
 - `-p, --port <port>` - 监听端口；裸端口严格绑定，后缀 `+` 向更大端口自动尝试，后缀 `-` 向更小端口自动尝试（未指定时等价于 `5666-`）
 - `-h, --host <host>` - 绑定的主机（默认：localhost）
-- `-C, --cwd <dir>` - 启动前更改 rtws 目录
+- `-C, --cwd <abs-dir>` - 启动前更改 rtws 目录；只接受绝对路径
 - `--help` - 显示帮助消息
 
 **示例：**
@@ -99,7 +99,7 @@ dominds webui -p 8080
 dominds webui -p 8080+
 
 # 在特定 rtws 启动 Web UI
-dominds webui -C ./my-rtws
+dominds webui -C /path/to/my-rtws
 ```
 
 **常见用途：**
@@ -129,7 +129,7 @@ dominds read [options] [member-id]
 
 **选项：**
 
-- `-C, --cwd <dir>` - 读取前更改 rtws 目录
+- `-C, --cwd <abs-dir>` - 读取前更改 rtws 目录；只接受绝对路径
 - `--only-prompt` - 仅显示系统提示词
 - `--only-mem` - 仅显示内存
 - `--help` - 显示帮助消息
@@ -139,7 +139,7 @@ dominds read [options] [member-id]
 ```bash
 dominds read
 dominds read developer
-dominds read -C ./my-rtws
+dominds read -C /path/to/my-rtws
 dominds read --only-prompt
 dominds read --only-mem
 ```
@@ -204,7 +204,7 @@ dominds
 dominds webui -p 8080
 
 # 3) 在特定 rtws 启动
-dominds webui -C ./my-rtws
+dominds webui -C /path/to/my-rtws
 
 # 4) 查看/核对当前团队配置
 dominds read

package/dist/docs/context-health.md

@@ -19,6 +19,10 @@ Dominds already has:
 
 - Collect **token usage stats** from LLM provider wrappers after each generation.
 - Compute a simple **context health** signal from provider stats + model metadata.
+- When the current computed health is `caution` or `critical`, keep large function results from
+  adding more raw material to the next prompt. Large return content is replaced with a
+  scope-specific, low-cognitive-load instruction that tells the agent the output is too large to see
+  before `clear_mind`.
 - When the dialog context is “too large”, enforce a **v3 remediation** workflow that is short,
   executable, and regression-testable:
   - In **caution**, record an auto-inserted **role=user prompt** as a normal, persisted user message
@@ -152,6 +156,34 @@ Rules:
 - Do not duplicate Taskdoc content except for a short bridge when strictly needed.
 - Do not paste long raw logs/tool outputs into the continuation package.
 
+### Large Function Results During Remediation
+
+When the current generation's computed context health is `caution` or `critical`, Dominds applies a
+runtime visibility limit to every ordinary function result before it is persisted back into dialog
+history. If current usage is unavailable, the driver falls back to the previous known context health
+for this visibility decision. This limit only applies to returned content. Function arguments remain
+unrestricted, because large arguments are often the necessary path for preserving current-dialog
+details into Taskdoc sections or reminders.
+
+If a function result is larger than the runtime visibility budget, measured by the total returned
+bytes visible to the model, Dominds does not insert the raw return content into the model context.
+Text is counted as UTF-8 bytes; image items use their recorded byte length. Instead, Dominds inserts
+a short scope-specific message:
+
+- Main Dialog: tell the agent that this function return is too large to see before `clear_mind`,
+  instruct it not to retry the same kind of large output, then tell it to write needed next-course
+  information into Taskdoc sections, preserve any remaining easy-to-lose details in reminders, and
+  call `clear_mind({})`.
+- Side Dialog: tell the agent that this function return is too large to see before `clear_mind`,
+  instruct it not to retry the same kind of large output, then tell it to organize the conclusion,
+  evidence pointers, and risks for the Main Dialog, preserve any easy-to-lose details in reminders,
+  and finish the Side Dialog reply as soon as possible.
+
+The replacement text may include only a short human-scale detail such as the approximate original
+byte count. It must not present the tool invocation as an execution failure: the function may have
+executed and produced side effects; only its large return content is unavailable before
+`clear_mind`.
+
 ### Caution (yellow)
 
 When `level === 'caution'`, the driver auto-inserts a **role=user** guidance prompt into the _next_
@@ -240,7 +272,9 @@ Additional constraints:
 2. Thread usage stats into the dialog state (persist alongside dialog turns).
 3. Implement the context health monitor computation and persist it per generation.
 4. Implement v3 remediation (persisted role=user prompt insertion + caution reminder-curation cadence + critical countdown + auto clear_mind).
-5. Add minimal regression guards for the v3 behavior (types + gating).
+5. Suppress oversized function-return content during `caution` / `critical` remediation while leaving
+   function arguments unrestricted.
+6. Add minimal regression guards for the v3 behavior (types + gating).
 
 ## Acceptance Criteria
 
@@ -265,4 +299,8 @@ Additional constraints:
     then `clear_mind`; Side Dialog prompts instruct detailed reminder curation only, then `clear_mind`.
     When the countdown reaches 0, the driver auto-executes `clear_mind` and starts a new course (no Q4H,
     no suspension).
+- During `caution` / `critical`, any ordinary function result whose returned content exceeds the
+  runtime visibility byte budget is replaced with the scope-specific “too large to see before
+  `clear_mind`” instruction instead of raw output. This is not reported as tool execution failure,
+  and function arguments are not limited.
 - UI shows context health with green/yellow/red (and “unknown” handling when usage is unavailable).

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

@@ -16,6 +16,9 @@ Dominds 已具备以下功能：
 
 - 从 LLM 提供商包装器收集每次生成后的 **token 使用统计**。
 - 从提供商统计 + 模型元数据计算简单的**上下文健康**信号。
+- 当本轮计算出的健康状态为 `caution` / `critical` 时，避免大函数返回继续把原始材料塞进下一轮
+  prompt。过大的返回内容会被替换成按主线/支线定制的低心智负担指令，告诉智能体：清理头脑之
+  前，这类大输出当前不可见。
 - 当对话上下文"过大"时，执行简短的、可执行的、可回归测试的 **v3 恢复**工作流：
   - 在 **caution（警告）** 级别，记录一条自动插入的 **role=user prompt** 作为正常的、持久化的用户消息（UI 可见并渲染为正常的用户指令）。
   - 在 **critical（严重）** 级别，通过**倒计时恢复**（最多 5 轮）强制执行稳定性：
@@ -119,6 +122,28 @@ Dominds 计算比率：
 - 除非确有必要，不要重复差遣牒已覆盖的内容。
 - 不要把长原始日志/大段 tool output 直接塞进接续包。
 
+### 处置态下的大函数返回
+
+当本轮生成计算出的上下文健康为 `caution` 或 `critical` 时，Dominds 在普通函数结果写回对话
+历史前，对返回内容应用运行时可见性上限。如果本轮 usage 不可用，则回退使用上一轮已知上下文健
+康来做这个可见性判断。这个限制只作用于函数返回内容；函数输入不受限制，因为较大的 `do_mind`
+/ `change_mind` / `add_reminder` / `update_reminder` 参数经常正是把当前对话细节保存进差遣牒
+或提醒项的必要路径。
+
+如果函数返回内容超过运行时可见性预算（按模型可见的返回总字节数计算），Dominds 不把原始返回
+内容插入模型上下文，而是插入一段按对话范围定制的短消息。文本按 UTF-8 字节计算；图片项使用已
+记录的 `byteLength`。
+
+- 主线对话：告诉智能体“这次函数返回内容太大，清理头脑之前当前不可见”；要求不要重试获取这类
+  大段输出；然后要求把下一程还需要知道的信息写入差遣牒合适章节，把差遣牒没有覆盖、但恢复工
+  作会丢的信息写入提醒项，最后调用 `clear_mind({})`。
+- 支线对话：告诉智能体“这次函数返回内容太大，清理头脑之前当前不可见”；要求不要重试获取这类
+  大段输出；然后要求把需要回传给主线对话的结论、证据定位和风险整理清楚，必要时把恢复工作会
+  丢的信息写入提醒项，并尽快完成当前支线回复。
+
+替换文案可以只保留简短的人类可读细节，例如“本次返回约 N 字节”。不要把这件事表述成工具执行
+失败：函数可能已经执行并产生副作用；只是清理头脑之前，其大段返回内容当前不可见。
+
 ### 警告（黄色）
 
 当 `level === 'caution'` 时，驱动程序在**下一个** LLM 生成轮次自动插入一条 **role=user** 指导提示，并**将其持久化为普通用户消息**，以便 UI 将其渲染为正常的用户指令。
@@ -191,7 +216,8 @@ Dominds 计算比率：
 2. 将使用统计传入对话状态（与每程对话一起持久化）。
 3. 实现上下文健康监控计算并每次生成持久化。
 4. 实现 v3 恢复（持久化的 role=user 提示插入 + 警告提醒整理节奏 + 严重倒计时 + 自动 clear_mind）。
-5. 为 v3 行为添加最小回归防护（类型 + 门控）。
+5. 在 `caution` / `critical` 处置态下隐藏超大函数返回内容，同时保持函数输入不受限制。
+6. 为 v3 行为添加最小回归防护（类型 + 门控）。
 
 ## 验收标准
 
@@ -202,4 +228,7 @@ Dominds 计算比率：
 - v3 恢复：
   - `caution`：驱动程序插入持久化的 role=user prompt（UI 可见的用户指令）。进入 `caution` 时插入一次；保持在 `caution` 状态时按节奏重新插入（默认：每 10 次生成；可按模型配置）。主线提示要求先把未落文档、且下一程需要知会的讨论细节补进差遣牒，再至少调用 `update_reminder` / `add_reminder` 之一维护接续包草稿；支线提示要求不要维护差遣牒/更新提案，直接维护足够详尽的接续包提醒项；然后在就绪时执行 `clear_mind`。
   - `critical`：驱动程序使用**记录的角色为 user 的 prompt** 运行倒计时恢复（最多 5 轮）。每次提示包含倒计时；主线提示指示先补差遣牒，再整理提醒项并 `clear_mind`；支线提示指示只维护详尽提醒项并 `clear_mind`。当倒计时归零时，驱动程序自动执行 `clear_mind` 并开始新一程（无 Q4H，无暂停）。
+- 在 `caution` / `critical` 中，任何普通函数结果的返回内容超过运行时可见性字节预算时，都用按
+  范围定制的“清理头脑之前当前不可见”指令替换原始输出；这不表述为工具执行失败，也不限制函数
+  输入。
 - UI 显示上下文健康状态：绿色/黄色/红色（以及使用情况不可用时的"未知"处理）。

package/dist/docs/dialog-persistence.md

@@ -4,7 +4,7 @@ Chinese version: [中文版](./dialog-persistence.zh.md)
 
 This document describes the persistence layer and storage mechanisms for the Dominds dialog system, including file system conventions, data structures, and storage patterns.
 
-> Note: In this document, **rtws (runtime workspace)** refers to Dominds' runtime root directory (by default `process.cwd()`, switchable via `-C <dir>`).
+> Note: In this document, **rtws (runtime workspace)** refers to Dominds' runtime root directory (by default `process.cwd()`, switchable via `-C <abs-dir>`; `-C` only accepts absolute paths).
 
 ## Current Implementation Status
 

package/dist/docs/dominds-terminology.md

@@ -264,8 +264,8 @@ Example / 示例（概念）:
 
 ### rtws（运行时工作区）
 
-- EN: **rtws** (runtime workspace) is the directory Dominds treats as its runtime root (by default it is `process.cwd()`, and can be changed via `-C <dir>`). Files like `.minds/` and `.dialogs/` live under the rtws.
-- ZH: **rtws（运行时工作区）**是 Dominds 运行时使用的根目录（默认等于 `process.cwd()`，可通过 `-C <dir>` 切换）。诸如 `.minds/`、`.dialogs/` 等运行态目录均位于 rtws 下。
+- EN: **rtws** (runtime workspace) is the directory Dominds treats as its runtime root (by default it is `process.cwd()`, and can be changed via `-C <abs-dir>`; `-C` only accepts absolute paths). Files like `.minds/` and `.dialogs/` live under the rtws.
+- ZH: **rtws（运行时工作区）**是 Dominds 运行时使用的根目录（默认等于 `process.cwd()`，可通过 `-C <abs-dir>` 切换；`-C` 只接受绝对路径）。诸如 `.minds/`、`.dialogs/` 等运行态目录均位于 rtws 下。
 
 - EN: Wording rule: when the meaning is **rtws**, prefer writing “rtws (runtime workspace)” (or just “rtws” after the first mention) rather than the ambiguous generic “workspace”.
 - ZH: 用词规则：当语义指向 **rtws** 时，优先写“rtws（运行时工作区）”（或在已定义后只写“rtws”），避免在对外提示/文档中只写“工作区”从而与其他语境的 workspace/workdir 混淆。