dominds 0.9.1 → 0.9.2

package/dist/llm/driver-v2/core.js

@@ -48,6 +48,17 @@ function resolveMemberDiligencePushMax(team, agentId) {
     }
     return diligence_1.DEFAULT_DILIGENCE_PUSH_MAX;
 }
+function emitDiligenceBudgetEvent(dlg, options) {
+    const maxInjectCount = Math.max(0, Math.floor(options.maxInjectCount));
+    const remainingCount = Math.max(0, Math.floor(options.nextRemainingBudget));
+    (0, evt_registry_1.postDialogEvent)(dlg, {
+        type: 'diligence_budget_evt',
+        maxInjectCount,
+        injectedCount: Math.max(0, maxInjectCount - remainingCount),
+        remainingCount,
+        disableDiligencePush: dlg.disableDiligencePush,
+    });
+}
 function resolveUpNextPrompt(dlg) {
     const upNext = dlg.takeUpNext();
     if (!upNext) {
@@ -733,6 +744,12 @@ async function maybeContinueWithDiligencePrompt(args) {
         kind: 'patch',
         patch: { diligencePushRemainingBudget: dlg.diligencePushRemainingBudget },
     }));
+    if (prepared.kind !== 'disabled') {
+        emitDiligenceBudgetEvent(dlg, {
+            maxInjectCount: prepared.maxInjectCount,
+            nextRemainingBudget: prepared.nextRemainingBudget,
+        });
+    }
     if (prepared.kind === 'budget_exhausted') {
         await (0, runtime_utils_1.suspendForKeepGoingBudgetExhausted)({
             dlg,

package/dist/tools/prompts/team_mgmt/en/tools.md

@@ -75,7 +75,8 @@
 - `mcp_admin`: MCP operations (`mcp_restart` / `mcp_release`), plus env tools (`env_get` / `env_set` / `env_unset`)
 - MCP-declared toolsets: dynamically mapped from `.minds/mcp.yaml` `servers.<serverId>` (toolset name = `serverId`). Exact capabilities depend on each MCP server’s exposed tools; use `team_mgmt_manual({ topics: ["toolsets"] })` to view the current mapping snapshot
   - Optional per-toolset manual can be placed at `servers.<serverId>.manual` using `content` (overview) and `sections` (chapters)
-  - Missing manual does **not** mean the toolset is unavailable; it means team-management documentation is incomplete. Continue by reading each tool’s description/arguments
+  - Missing manual does **not** mean the toolset is unavailable; runtime manual will auto-generate a baseline draft (at least a tools-list section) for temporary use
+  - Auto-generated draft is only a scaffold: team manager must confirm intent/boundaries with the human user, then replace it with accurate manual content
   - Team managers should, after MCP validation passes, carefully read each exposed tool description, align with the human user on intended rtws usage, then write `servers.<serverId>.manual` with typical usage patterns and primary intent directions
 
 ## ripgrep Dependency (Detection & Install)

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

@@ -75,7 +75,8 @@
 - `mcp_admin`：MCP 运维（`mcp_restart` / `mcp_release`），并包含环境变量工具（`env_get` / `env_set` / `env_unset`）
 - MCP 声明型 toolset：来源于 `.minds/mcp.yaml` 的 `servers.<serverId>` 动态映射（toolset 名称 = `serverId`）。具体能力以该 MCP server 实际暴露工具为准；可在 `team_mgmt_manual({ topics: ["toolsets"] })` 查看当前映射快照
   - 可选：在 `servers.<serverId>.manual` 放手册内容，支持 `content`（总说明）+ `sections`（章节）
-  - 注意：没有手册 **不代表** toolset 不可用；这表示团队管理文档不足。应继续阅读每个工具的 description/参数并使用
+  - 注意：没有手册 **不代表** toolset 不可用；运行时手册会自动生成基础草稿（至少包含 tools 列表章节）供临时使用
+  - 自动草稿只是脚手架：团队管理者必须与人类用户确认意图与边界后，再改写成准确手册
   - 团队管理者应在 MCP 配置验证通过后：先精读该 server 各工具说明，再与人类用户讨论本 rtws 的使用意图，最后把典型用法与主要意图方向写入 `servers.<serverId>.manual`
 
 ## ripgrep 依赖（检测与安装）

package/dist/tools/team_mgmt.js

@@ -3396,23 +3396,141 @@ function describeMcpManualState(language, state) {
         ? '手册=缺失（不影响 toolset 可用性；这是团队管理配置不足，请根据每个工具 description/参数自行判断使用）'
         : 'manual=missing (toolset availability is unaffected; this is a team-management gap, so rely on each tool description/arguments and proceed)';
 }
+function inferAutoGeneratedMcpIntentDirections(language, toolNames) {
+    const names = toolNames.map((name) => name.toLowerCase());
+    const out = [];
+    const pushUnique = (line) => {
+        if (!out.includes(line))
+            out.push(line);
+    };
+    const has = (needle) => names.some((name) => name.includes(needle));
+    if (has('browser') || has('page') || has('playwright') || has('screenshot')) {
+        pushUnique(language === 'zh'
+            ? '网页/浏览器自动化：用于页面操作、采样、信息抓取与可视化回归辅助。'
+            : 'Web/browser automation: page actions, sampling, information extraction, and visual-regression assistance.');
+    }
+    if (has('git') || has('repo') || has('diff') || has('pr') || has('commit')) {
+        pushUnique(language === 'zh'
+            ? '仓库协作与变更分析：用于读取仓库状态、比较差异、辅助代码审查。'
+            : 'Repository collaboration and change analysis: inspect repo state, compare diffs, and support review workflows.');
+    }
+    if (has('sql') || has('db') || has('query') || has('table') || has('postgres')) {
+        pushUnique(language === 'zh'
+            ? '数据查询/诊断：用于结构化检索与数据一致性排查。'
+            : 'Data query/diagnostics: structured retrieval and data-consistency investigation.');
+    }
+    if (has('k8s') || has('kubectl') || has('deploy') || has('cluster') || has('helm')) {
+        pushUnique(language === 'zh'
+            ? '部署与运行状态诊断：用于集群状态检查、发布过程观测与故障定位。'
+            : 'Deployment/runtime diagnostics: cluster-state checks, release observation, and incident localization.');
+    }
+    if (has('ticket') || has('issue') || has('jira') || has('linear')) {
+        pushUnique(language === 'zh'
+            ? '任务流转协作：用于工单读取、状态同步与流程追踪。'
+            : 'Ticket/workflow collaboration: ticket lookup, state synchronization, and process tracking.');
+    }
+    if (out.length === 0) {
+        out.push(language === 'zh'
+            ? '未识别出明确领域特征：建议按工具 description/参数逐个确认用途，并与人类用户共同定义边界。'
+            : 'No clear domain signature detected: review each tool description/arguments and define boundaries jointly with the human user.');
+    }
+    return out;
+}
+function renderAutoGeneratedMcpManualDraftSection(language, entry) {
+    const lines = [];
+    const statusText = entry.status === 'registered'
+        ? language === 'zh'
+            ? '已加载'
+            : 'loaded'
+        : entry.status === 'declared_unloaded'
+            ? language === 'zh'
+                ? '已声明但未加载'
+                : 'declared but not loaded'
+            : language === 'zh'
+                ? '声明无效'
+                : 'invalid declaration';
+    const transportText = entry.transport === 'invalid' ? 'invalid' : entry.transport === 'stdio' ? 'stdio' : 'http';
+    lines.push(`\n### toolset \`${entry.serverId}\``);
+    lines.push(...fmtList([
+        language === 'zh'
+            ? '检测到 `servers.<serverId>.manual` 缺失，以下为自动生成的基础手册草稿（供临时使用）。'
+            : '`servers.<serverId>.manual` is missing. Below is an auto-generated baseline manual draft (temporary use).',
+        language === 'zh'
+            ? `运行时状态：status=${statusText}，transport=${transportText}。`
+            : `Runtime status: status=${statusText}, transport=${transportText}.`,
+        language === 'zh'
+            ? '关键提醒：该草稿不等于最终规范。团队管理者必须与人类用户确认本 rtws 的真实意图后，再写入更准确的正式手册。'
+            : 'Critical reminder: this draft is not the final policy. Team manager must confirm actual rtws intent with the human user, then author a more accurate final manual.',
+    ])
+        .trimEnd()
+        .split('\n'));
+    lines.push(...fmtList([
+        language === 'zh'
+            ? '章节：tools 列表（运行时快照）'
+            : 'Section: Tools list (runtime snapshot)',
+    ])
+        .trimEnd()
+        .split('\n'));
+    if ((entry.loadedToolNames?.length ?? 0) > 0) {
+        const tools = entry.loadedToolNames ?? [];
+        lines.push(...fmtCodeBlock('text', tools.map((tool) => `- ${tool}`))
+            .trimEnd()
+            .split('\n'));
+    }
+    else {
+        lines.push(...fmtList([
+            language === 'zh'
+                ? '当前无法给出已加载 tools 清单（通常因为该 server 尚未加载）。先运行 `team_mgmt_validate_mcp_cfg({})`，必要时再 `mcp_restart`。'
+                : 'Loaded tools are not currently available (usually because this server is not loaded yet). Run `team_mgmt_validate_mcp_cfg({})`, then `mcp_restart` if needed.',
+        ])
+            .trimEnd()
+            .split('\n'));
+    }
+    lines.push(...fmtList([
+        language === 'zh'
+            ? '章节：主要意图方向（自动推测，待确认）'
+            : 'Section: Primary intent directions (auto-inferred, pending confirmation)',
+    ])
+        .trimEnd()
+        .split('\n'));
+    lines.push(...fmtList(inferAutoGeneratedMcpIntentDirections(language, entry.loadedToolNames ?? []))
+        .trimEnd()
+        .split('\n'));
+    lines.push(...fmtList([
+        language === 'zh'
+            ? '团队管理者后续动作：精读每个工具说明 -> 与人类用户确认意图与边界 -> 回写 `servers.<serverId>.manual.content + sections`。'
+            : 'Team-manager follow-up: read each tool description carefully -> confirm intent/boundaries with the human user -> write back to `servers.<serverId>.manual.content + sections`.',
+    ])
+        .trimEnd()
+        .split('\n'));
+    return lines.join('\n') + '\n';
+}
 function renderMcpToolsetManualDetailsSection(language, snapshot) {
     const header = language === 'zh'
         ? fmtSubHeader('MCP toolset 手册（来自 `.minds/mcp.yaml` 的 `servers.<serverId>.manual`）')
         : fmtSubHeader('MCP Toolset Manuals (from `.minds/mcp.yaml` `servers.<serverId>.manual`)');
     if (snapshot.kind !== 'loaded')
         return '';
-    const entries = snapshot.entries.filter((entry) => entry.manualState.kind !== 'missing');
+    const entries = snapshot.entries;
     if (entries.length === 0) {
         return (header +
             fmtList([
                 language === 'zh'
-                    ? '当前所有 MCP toolset 都没有配置 `manual`。这不代表不可用；只代表团队管理者没有提供使用章节。请继续依据工具自身 description/参数定义来使用，并提醒团队管理者补齐手册。'
-                    : 'No MCP toolset currently provides `manual`. This does not mean unavailable; it only means the team manager has not provided usage chapters yet. Continue by reading each tool description/argument schema, and ask the team manager to fill manuals.',
+                    ? '当前没有 MCP toolset 可展示。'
+                    : 'There are currently no MCP toolsets to display.',
             ]));
     }
-    let out = header;
+    let out = header +
+        fmtList([
+            language === 'zh'
+                ? '若 `servers.<serverId>.manual` 已配置，显示正式手册；若缺失，则自动生成基础草稿（含 tools 列表与意图方向草稿）供临时使用。'
+                : 'If `servers.<serverId>.manual` is configured, the formal manual is shown; if missing, an auto-generated baseline draft (including tools list and intent directions draft) is provided for temporary use.',
+        ]);
     for (const entry of entries) {
+        if (entry.manualState.kind === 'missing') {
+            out += renderAutoGeneratedMcpManualDraftSection(language, entry);
+            continue;
+        }
         if (entry.manualState.kind === 'invalid') {
             out += `\n### toolset \`${entry.serverId}\`\n`;
             out += fmtList([
@@ -3506,12 +3624,14 @@ async function readMcpToolsetMappingSnapshot() {
         const transport = parsed.config.servers[serverId]?.transport ?? 'invalid';
         const loadedTools = registeredToolsets[serverId];
         if (loadedTools) {
+            const loadedToolNames = loadedTools.map((t) => t.name);
             entries.push({
                 serverId,
                 transport,
                 status: 'registered',
                 loadedToolCount: loadedTools.length,
-                loadedToolNamesPreview: loadedTools.slice(0, 6).map((t) => t.name),
+                loadedToolNames,
+                loadedToolNamesPreview: loadedToolNames.slice(0, 6),
                 manualState,
             });
             continue;
@@ -3964,6 +4084,7 @@ exports.teamMgmtValidateMcpCfgTool = {
             let mcpRaw = null;
             let declaredServerCount = 0;
             let fallbackInvalidServers = [];
+            let fallbackInvalidToolsetManuals = [];
             try {
                 const st = await promises_1.default.stat(mcpYamlAbs);
                 if (!st.isFile()) {
@@ -3994,6 +4115,8 @@ exports.teamMgmtValidateMcpCfgTool = {
                 }
                 declaredServerCount = parsed.serverIdsInYamlOrder.length;
                 fallbackInvalidServers = parsed.invalidServers;
+                const manualInfo = parseMcpManualByServer(mcpRaw);
+                fallbackInvalidToolsetManuals = [...manualInfo.invalidByServerId.entries()].map(([serverId, errorText]) => ({ serverId, errorText }));
             }
             catch (err) {
                 if (!(isFsErrWithCode(err) && err.code === 'ENOENT')) {
@@ -4009,7 +4132,18 @@ exports.teamMgmtValidateMcpCfgTool = {
                     fallbackOnlyInvalidServers.push(s);
                 }
             }
-            if (mcpProblems.length === 0 && fallbackOnlyInvalidServers.length === 0) {
+            const fallbackOnlyInvalidToolsetManuals = [];
+            for (const s of fallbackInvalidToolsetManuals) {
+                const hasMatchingProblem = mcpProblems.some((p) => p.kind === 'mcp_server_error' &&
+                    p.detail.serverId === s.serverId &&
+                    p.detail.errorText.includes(firstNonEmptyLine(s.errorText)));
+                if (!hasMatchingProblem) {
+                    fallbackOnlyInvalidToolsetManuals.push(s);
+                }
+            }
+            if (mcpProblems.length === 0 &&
+                fallbackOnlyInvalidServers.length === 0 &&
+                fallbackOnlyInvalidToolsetManuals.length === 0) {
                 const msg = language === 'zh'
                     ? fmtHeader('mcp.yaml 校验通过') +
                         fmtList([
@@ -4064,19 +4198,29 @@ exports.teamMgmtValidateMcpCfgTool = {
                 issueLines.push(`  serverId: ${s.serverId}`);
                 issueLines.push('  ' + s.errorText.split('\n').join('\n  '));
             }
-            const totalIssues = mcpProblems.length + fallbackOnlyInvalidServers.length;
+            for (const s of fallbackOnlyInvalidToolsetManuals) {
+                issueLines.push(`- [error] ${MCP_SERVER_PROBLEM_PREFIX}${s.serverId}/toolset_manual_error`);
+                issueLines.push(`  serverId: ${s.serverId}`);
+                issueLines.push(language === 'zh'
+                    ? '  toolset manual: servers.<serverId>.manual 声明无效'
+                    : '  toolset manual: servers.<serverId>.manual invalid declaration');
+                issueLines.push('  ' + s.errorText.split('\n').join('\n  '));
+            }
+            const totalIssues = mcpProblems.length +
+                fallbackOnlyInvalidServers.length +
+                fallbackOnlyInvalidToolsetManuals.length;
             const msg = language === 'zh'
                 ? fmtHeader('mcp.yaml 校验失败') +
                     fmtList([
                         `\`${MCP_YAML_REL}\`：❌ 检测到 ${totalIssues} 个问题（详见 Problems 面板）`,
-                        '说明：MCP 配置问题会导致 server/toolset 加载失败、部分工具不可用或运行时异常。',
+                        '说明：MCP 配置问题（含 toolset manual 声明错误）会导致 server/toolset 加载失败、工具手册缺失/错误或运行时异常。',
                     ]) +
                     '\n' +
                     issueLines.join('\n')
                 : fmtHeader('mcp.yaml Validation Failed') +
                     fmtList([
                         `\`${MCP_YAML_REL}\`: ❌ ${totalIssues} issue(s) detected (see Problems panel)`,
-                        'Note: MCP config issues can block server/toolset loading and cause runtime tool failures.',
+                        'Note: MCP config issues (including toolset manual declaration errors) can block server/toolset loading, produce bad/missing manual guidance, or cause runtime tool failures.',
                     ]) +
                     '\n' +
                     issueLines.join('\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dominds",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "DevOps Mindsets — Sustainable Agentic Product Lifecycle",
   "type": "commonjs",
   "private": false,