dominds 0.7.0 → 0.7.1

package/dist/agent-priming.js

@@ -57,6 +57,26 @@ const BASELINE_ENV_SNAPSHOT_CMD = 'uname -a';
 const PRIMING_VCS_SESSION_SLUG = 'rtws-vcs-inventory';
 const cacheByAgentId = new Map();
 const inflightByAgentId = new Map();
+class AgentPrimingInterruptedError extends Error {
+    constructor(reason) {
+        super(`Agent Priming interrupted: ${reason}`);
+        this.name = 'AgentPrimingInterruptedError';
+        this.reason = reason;
+    }
+}
+function isAgentPrimingInterruptedError(error) {
+    return error instanceof AgentPrimingInterruptedError;
+}
+function throwIfAgentPrimingStopped(dlg, abortSignal) {
+    if (!abortSignal.aborted) {
+        return;
+    }
+    const reason = (0, dialog_run_state_1.getStopRequestedReason)(dlg.id);
+    if (reason === 'emergency_stop' || reason === 'user_stop') {
+        throw new AgentPrimingInterruptedError(reason);
+    }
+    throw new AgentPrimingInterruptedError('user_stop');
+}
 async function emitSayingEventsAndPersist(dlg, content) {
     const calls = await (0, driver_entry_1.emitSayingEvents)(dlg, content);
     const genseq = dlg.activeGenSeqOrUndefined;
@@ -156,8 +176,23 @@ function scheduleAgentPrimingForNewDialog(dlg, options) {
             }
             // mode === 'do': wait for in-flight then run again for this dialog.
             if (options.mode === 'do') {
-                return runAgentPrimingLive(dlg).then((next) => {
+                return runAgentPrimingLive(dlg)
+                    .then((next) => {
                     cacheByAgentId.set(agentId, next);
+                })
+                    .catch((err) => {
+                    if (isAgentPrimingInterruptedError(err)) {
+                        log_1.log.info('Agent Priming interrupted; will retry on next dialog', undefined, {
+                            agentId,
+                            reason: err.reason,
+                        });
+                    }
+                    else {
+                        log_1.log.warn('Agent Priming live run failed; will retry on next dialog', err, {
+                            agentId,
+                        });
+                    }
+                    return undefined;
                 });
             }
             return Promise.resolve();
@@ -170,7 +205,15 @@ function scheduleAgentPrimingForNewDialog(dlg, options) {
     })
         .catch((err) => {
         // Best-effort: avoid unhandled rejections; the dialog itself is already marked interrupted.
-        log_1.log.warn('Agent Priming live run failed; will retry on next dialog', err, { agentId });
+        if (isAgentPrimingInterruptedError(err)) {
+            log_1.log.info('Agent Priming interrupted; will retry on next dialog', undefined, {
+                agentId,
+                reason: err.reason,
+            });
+        }
+        else {
+            log_1.log.warn('Agent Priming live run failed; will retry on next dialog', err, { agentId });
+        }
         return null;
     })
         .finally(() => {
@@ -834,7 +877,7 @@ function formatFbrTellaskBody(language, snapshotText, options) {
     ].join('\n');
 }
 async function generatePrimingNoteViaMainlineAgent(options) {
-    const { dlg, shellSnapshotText, shellResponseText, vcsRound1Text, vcsRound2Text, fbrResponses, fbrTellaskHead, fbrCallId, } = options;
+    const { dlg, shellSnapshotText, shellResponseText, vcsRound1Text, vcsRound2Text, fbrResponses, fbrTellaskHead, fbrCallId, assertNotStopped, } = options;
     // Trigger a normal drive and rely on driver.ts context assembly.
     // Agent Priming must not trigger Diligence Push (“鞭策”); it should be best-effort
     // one-shot distillation with no keep-going injection.
@@ -949,6 +992,7 @@ async function generatePrimingNoteViaMainlineAgent(options) {
             ].join('\n');
         // IMPORTANT: this is an internal (non-persisted) prompt. driver.ts will inject it into
         // the LLM context for this drive only, without polluting dialog history.
+        assertNotStopped?.();
         await (0, driver_entry_1.driveDialogStream)(dlg, {
             content: internalPrompt,
             msgId: (0, id_1.generateShortId)(),
@@ -956,6 +1000,7 @@ async function generatePrimingNoteViaMainlineAgent(options) {
             persistMode: 'internal',
             skipTaskdoc: true,
         }, true);
+        assertNotStopped?.();
         const afterMsgs = dlg.msgs.length;
         if (afterMsgs <= beforeMsgs) {
             throw new Error('Agent Priming distillation produced no new messages.');
@@ -1077,15 +1122,24 @@ function buildCoursePrefixMsgs(entry) {
     return out;
 }
 async function replayAgentPriming(dlg, entry) {
+    const hadActiveRunBefore = (0, dialog_run_state_1.hasActiveRun)(dlg.id);
+    const primingAbortSignal = (0, dialog_run_state_1.createActiveRun)(dlg.id);
+    const ownsActiveRun = !hadActiveRunBefore;
+    const assertNotStopped = () => {
+        throwIfAgentPrimingStopped(dlg, primingAbortSignal);
+    };
     const release = await dlg.acquire();
+    let interruptedRunState = null;
     try {
         const language = (0, runtime_language_1.getWorkLanguage)();
         dlg.setCoursePrefixMsgs(buildCoursePrefixMsgs(entry));
         await (0, dialog_run_state_1.setDialogRunState)(dlg.id, { kind: 'proceeding' });
+        assertNotStopped();
         // Phase 1: shell ask (and optional prelude intro)
         let shellCallId = null;
         let shellTellaskHead = null;
         try {
+            assertNotStopped();
             await dlg.notifyGeneratingStart();
             await emitUiOnlyMarkdownEventsAndPersist(dlg, formatPreludeIntro(language, true, entry.shellPolicy, entry.shell.kind === 'specialist_tellask' ? entry.shell.specialistId : null));
             if (entry.shell.kind === 'specialist_tellask') {
@@ -1115,6 +1169,7 @@ async function replayAgentPriming(dlg, entry) {
         }
         // Phase 2: shell response (separate bubble)
         if (entry.shell.kind === 'specialist_tellask' && shellCallId && shellTellaskHead) {
+            assertNotStopped();
             await dlg.receiveTeammateResponse(entry.shell.specialistId, shellTellaskHead, 'completed', dlg.id, {
                 response: entry.shell.responseText,
                 agentId: entry.shell.specialistId,
@@ -1129,6 +1184,7 @@ async function replayAgentPriming(dlg, entry) {
             let round2CallId = null;
             let round2TellaskHead = null;
             try {
+                assertNotStopped();
                 await dlg.notifyGeneratingStart();
                 const round1Content = [
                     `!?@${entry.vcs.specialistId} !tellaskSession ${entry.vcs.sessionSlug}`,
@@ -1151,6 +1207,7 @@ async function replayAgentPriming(dlg, entry) {
                 }
             }
             if (round1CallId && round1TellaskHead) {
+                assertNotStopped();
                 await dlg.receiveTeammateResponse(entry.vcs.specialistId, round1TellaskHead, 'completed', dlg.id, {
                     response: entry.vcs.round1.responseText,
                     agentId: entry.vcs.specialistId,
@@ -1159,6 +1216,7 @@ async function replayAgentPriming(dlg, entry) {
                 });
             }
             try {
+                assertNotStopped();
                 await dlg.notifyGeneratingStart();
                 const round2Content = [
                     `!?@${entry.vcs.specialistId} !tellaskSession ${entry.vcs.sessionSlug}`,
@@ -1181,6 +1239,7 @@ async function replayAgentPriming(dlg, entry) {
                 }
             }
             if (round2CallId && round2TellaskHead) {
+                assertNotStopped();
                 await dlg.receiveTeammateResponse(entry.vcs.specialistId, round2TellaskHead, 'completed', dlg.id, {
                     response: entry.vcs.round2.responseText,
                     agentId: entry.vcs.specialistId,
@@ -1191,6 +1250,7 @@ async function replayAgentPriming(dlg, entry) {
         }
         else {
             try {
+                assertNotStopped();
                 await dlg.notifyGeneratingStart();
                 await emitSayingEventsAndPersist(dlg, entry.vcs.round1NoteMarkdown);
             }
@@ -1203,6 +1263,7 @@ async function replayAgentPriming(dlg, entry) {
                 }
             }
             try {
+                assertNotStopped();
                 await dlg.notifyGeneratingStart();
                 await emitSayingEventsAndPersist(dlg, entry.vcs.round2NoteMarkdown);
             }
@@ -1221,6 +1282,7 @@ async function replayAgentPriming(dlg, entry) {
         const effort = Math.max(0, Math.floor(entry.fbr.effort));
         if (effort >= 1 && entry.fbr.responses.length > 0) {
             try {
+                assertNotStopped();
                 await dlg.notifyGeneratingStart();
                 const fbrCallBody = [entry.fbr.selfTeaser, '', entry.fbr.tellaskBody].join('\n');
                 const fbrCallContent = [
@@ -1248,6 +1310,7 @@ async function replayAgentPriming(dlg, entry) {
                 const normalized = Math.max(1, effort);
                 const responses = entry.fbr.responses.slice(0, normalized);
                 for (let i = 0; i < responses.length; i++) {
+                    assertNotStopped();
                     const raw = responses[i] ?? '';
                     await dlg.receiveTeammateResponse(entry.fbr.responderAgentId, fbrTellaskHead, 'completed', dlg.id, {
                         response: raw,
@@ -1260,6 +1323,7 @@ async function replayAgentPriming(dlg, entry) {
         }
         // Phase 5: summary bubble
         try {
+            assertNotStopped();
             await dlg.notifyGeneratingStart();
             await emitSayingEventsAndPersist(dlg, entry.primingNote);
         }
@@ -1273,25 +1337,55 @@ async function replayAgentPriming(dlg, entry) {
         }
     }
     catch (err) {
-        log_1.log.warn('Agent Priming replay failed (best-effort)', err, { dialogId: dlg.id.valueOf() });
+        if (isAgentPrimingInterruptedError(err)) {
+            interruptedRunState = {
+                kind: 'interrupted',
+                reason: { kind: err.reason },
+            };
+            log_1.log.info('Agent Priming replay interrupted by stop request', undefined, {
+                dialogId: dlg.id.valueOf(),
+                reason: err.reason,
+            });
+        }
+        else {
+            log_1.log.warn('Agent Priming replay failed (best-effort)', err, { dialogId: dlg.id.valueOf() });
+        }
     }
     finally {
-        let nextIdle = { kind: 'idle_waiting_user' };
         try {
-            nextIdle = await (0, dialog_run_state_1.computeIdleRunState)(dlg);
+            if (interruptedRunState) {
+                await (0, dialog_run_state_1.setDialogRunState)(dlg.id, interruptedRunState);
+            }
+            else {
+                let nextIdle = { kind: 'idle_waiting_user' };
+                try {
+                    nextIdle = await (0, dialog_run_state_1.computeIdleRunState)(dlg);
+                }
+                catch (err) {
+                    log_1.log.warn('Failed to compute idle runState after Agent Priming replay; falling back', err, {
+                        dialogId: dlg.id.valueOf(),
+                    });
+                }
+                await (0, dialog_run_state_1.setDialogRunState)(dlg.id, nextIdle);
+            }
         }
-        catch (err) {
-            log_1.log.warn('Failed to compute idle runState after Agent Priming replay; falling back', err, {
-                dialogId: dlg.id.valueOf(),
-            });
+        finally {
+            if (ownsActiveRun) {
+                (0, dialog_run_state_1.clearActiveRun)(dlg.id);
+            }
+            release();
         }
-        await (0, dialog_run_state_1.setDialogRunState)(dlg.id, nextIdle);
-        release();
     }
 }
 async function runAgentPrimingLive(dlg) {
     const createdAt = (0, time_1.formatUnifiedTimestamp)(new Date());
     const language = (0, runtime_language_1.getWorkLanguage)();
+    const hadActiveRunBefore = (0, dialog_run_state_1.hasActiveRun)(dlg.id);
+    const primingAbortSignal = (0, dialog_run_state_1.createActiveRun)(dlg.id);
+    const ownsActiveRun = !hadActiveRunBefore;
+    const assertNotStopped = () => {
+        throwIfAgentPrimingStopped(dlg, primingAbortSignal);
+    };
     const prevDisableDiligencePush = dlg.disableDiligencePush;
     // Agent Priming is a bounded bootstrap routine; no keep-going injection should appear
     // during the priming lifecycle (including any auto-revive drives triggered by subdialog replies).
@@ -1319,7 +1413,9 @@ async function runAgentPrimingLive(dlg) {
     const fbrResponsesForInjection = [];
     try {
         await (0, dialog_run_state_1.setDialogRunState)(dlg.id, { kind: 'proceeding' });
+        assertNotStopped();
         const team = await team_1.Team.load();
+        assertNotStopped();
         const member = team.getMember(dlg.agentId);
         const specialists = team.shellSpecialists
             .filter((s) => typeof s === 'string')
@@ -1339,6 +1435,7 @@ async function runAgentPrimingLive(dlg) {
         // Phase 1: shell ask (and optional prelude intro)
         if (shellPolicy === 'specialist_only' && specialistId !== null) {
             shellTellaskBody = formatShellTellaskBody(language, specialistId);
+            assertNotStopped();
             await dlg.withLock(async () => {
                 try {
                     await dlg.notifyGeneratingStart();
@@ -1372,6 +1469,7 @@ async function runAgentPrimingLive(dlg) {
             // In both cases we skip the shell Tellask step and let the runtime capture a baseline snapshot.
             // Keep it safe and deterministic: no network, no writes.
             const unameOutput = await runUnameA();
+            assertNotStopped();
             shellResponseText = unameOutput;
             snapshotText = unameOutput;
             const directNote = (() => {
@@ -1401,6 +1499,7 @@ async function runAgentPrimingLive(dlg) {
                     ].join('\n');
             })();
             directNoteMarkdown = directNote;
+            assertNotStopped();
             await dlg.withLock(async () => {
                 try {
                     await dlg.notifyGeneratingStart();
@@ -1435,6 +1534,7 @@ async function runAgentPrimingLive(dlg) {
                 throw new Error('Missing shell tellaskHead');
             }
             const tellaskBody = shellTellaskBodyForSubdialog ?? shellTellaskBody;
+            assertNotStopped();
             const sub = await dlg.withLock(async () => {
                 return await dlg.createSubDialog(ensuredSpecialistId, ensuredShellTellaskHead, tellaskBody, {
                     originMemberId: dlg.agentId,
@@ -1452,6 +1552,7 @@ async function runAgentPrimingLive(dlg) {
                 collectiveTargets: [ensuredSpecialistId],
             });
             await (0, driver_entry_1.driveDialogStream)(sub, { content: initPrompt, msgId: (0, id_1.generateShortId)(), grammar: 'markdown', skipTaskdoc: true }, true);
+            assertNotStopped();
             shellResponseText = extractLastAssistantSaying(sub.msgs);
             const toolResult = extractLastShellCmdResultText(sub.msgs);
             snapshotText = toolResult ? toolResult : shellResponseText;
@@ -1459,7 +1560,9 @@ async function runAgentPrimingLive(dlg) {
                 // Specialist produced no usable output (misconfigured tools, provider issues, etc.).
                 // Fall back to a runtime-executed `uname -a` so we can still proceed to FBR.
                 snapshotText = await runUnameA();
+                assertNotStopped();
             }
+            assertNotStopped();
             await dlg.withLock(async () => {
                 await dlg.receiveTeammateResponse(ensuredSpecialistId, ensuredShellTellaskHead, 'completed', sub.id, {
                     response: shellResponseText,
@@ -1503,6 +1606,7 @@ async function runAgentPrimingLive(dlg) {
                         }
                     }
                 });
+                assertNotStopped();
                 const round1Sub = await dlg.withLock(async () => {
                     return await dlg.createSubDialog(ensuredSpecialistId, round1TellaskHead, round1TellaskBodyForSubdialog || vcsRound1Body, {
                         originMemberId: dlg.agentId,
@@ -1514,6 +1618,7 @@ async function runAgentPrimingLive(dlg) {
                 });
                 const rootDialog = dlg instanceof dialog_1.RootDialog ? dlg : dlg instanceof dialog_1.SubDialog ? dlg.rootDialog : undefined;
                 if (rootDialog) {
+                    assertNotStopped();
                     rootDialog.registerSubdialog(round1Sub);
                     await rootDialog.saveSubdialogRegistry();
                 }
@@ -1531,10 +1636,12 @@ async function runAgentPrimingLive(dlg) {
                     grammar: 'markdown',
                     skipTaskdoc: true,
                 }, true);
+                assertNotStopped();
                 vcsRound1ResponseText = extractLastAssistantSaying(round1Sub.msgs).trim();
                 if (!vcsRound1ResponseText) {
                     throw new Error('Specialist VCS session round-1 returned empty output');
                 }
+                assertNotStopped();
                 await dlg.withLock(async () => {
                     await dlg.receiveTeammateResponse(ensuredSpecialistId, round1TellaskHead, 'completed', round1Sub.id, {
                         response: vcsRound1ResponseText,
@@ -1587,10 +1694,12 @@ async function runAgentPrimingLive(dlg) {
                     grammar: 'markdown',
                     skipTaskdoc: true,
                 }, true);
+                assertNotStopped();
                 vcsRound2ResponseText = extractLastAssistantSaying(round1Sub.msgs).trim();
                 if (!vcsRound2ResponseText) {
                     throw new Error('Specialist VCS session round-2 returned empty output');
                 }
+                assertNotStopped();
                 await dlg.withLock(async () => {
                     await dlg.receiveTeammateResponse(ensuredSpecialistId, round2TellaskHead, 'completed', round1Sub.id, {
                         response: vcsRound2ResponseText,
@@ -1609,6 +1718,7 @@ async function runAgentPrimingLive(dlg) {
             }
         }
         const runtimeInventory = await collectRtwsGitInventory();
+        assertNotStopped();
         const runtimeRound1Text = formatRtwsGitInventoryRound1(language, runtimeInventory);
         const runtimeRound2Text = formatRtwsGitInventoryRound2(language, runtimeInventory);
         const runtimeInventoryText = [runtimeRound1Text, '', runtimeRound2Text].join('\n');
@@ -1630,6 +1740,7 @@ async function runAgentPrimingLive(dlg) {
             vcsRound1NoteMarkdown = formatRuntimeVcsRoundNote(language, 1, vcsRound1ResponseText);
             vcsRound2NoteMarkdown = formatRuntimeVcsRoundNote(language, 2, vcsRound2ResponseText);
             vcsInventoryText = runtimeInventoryText;
+            assertNotStopped();
             await dlg.withLock(async () => {
                 try {
                     await dlg.notifyGeneratingStart();
@@ -1644,6 +1755,7 @@ async function runAgentPrimingLive(dlg) {
                     }
                 }
             });
+            assertNotStopped();
             await dlg.withLock(async () => {
                 try {
                     await dlg.notifyGeneratingStart();
@@ -1683,6 +1795,7 @@ async function runAgentPrimingLive(dlg) {
         let fbrTellaskHead = null;
         // Phase 3: FBR ask (call bubble)
         if (fbrEffort >= 1) {
+            assertNotStopped();
             await dlg.withLock(async () => {
                 try {
                     await dlg.notifyGeneratingStart();
@@ -1718,6 +1831,7 @@ async function runAgentPrimingLive(dlg) {
             const ensuredFbrTellaskHead = fbrTellaskHead;
             const perInstance = Array.from({ length: fbrEffort }, (_, idx) => idx + 1);
             const created = await Promise.all(perInstance.map(async (i) => {
+                assertNotStopped();
                 const instanceBody = fbrEffort > 1
                     ? [
                         fbrCallBody,
@@ -1727,6 +1841,7 @@ async function runAgentPrimingLive(dlg) {
                             : 'Hint: try to provide a distinct angle vs other FBR drafts (e.g. security/constraints/verifiability/risk).',
                     ].join('\n')
                     : fbrCallBody;
+                assertNotStopped();
                 const sub = await dlg.withLock(async () => {
                     return await dlg.createSubDialog(dlg.agentId, ensuredFbrTellaskHead, instanceBody, {
                         originMemberId: dlg.agentId,
@@ -1749,10 +1864,13 @@ async function runAgentPrimingLive(dlg) {
                     grammar: 'markdown',
                     skipTaskdoc: true,
                 }, true);
+                assertNotStopped();
                 const responseText = extractLastAssistantSaying(sub.msgs);
                 return { sub, responseText };
             }));
+            assertNotStopped();
             for (const r of created) {
+                assertNotStopped();
                 const responseText = r.responseText;
                 fbrResponsesForCache.push(responseText);
                 fbrResponsesForInjection.push({ subdialogId: r.sub.id.selfId, response: responseText });
@@ -1783,7 +1901,9 @@ async function runAgentPrimingLive(dlg) {
             fbrResponses: fbrResponsesForInjection,
             fbrTellaskHead: fbrTellaskHead,
             fbrCallId: fbrCallId,
+            assertNotStopped,
         });
+        assertNotStopped();
         const entry = {
             createdAt,
             workLanguage: language,
@@ -1844,6 +1964,17 @@ async function runAgentPrimingLive(dlg) {
         return entry;
     }
     catch (err) {
+        if (isAgentPrimingInterruptedError(err)) {
+            fatalRunState = {
+                kind: 'interrupted',
+                reason: { kind: err.reason },
+            };
+            log_1.log.info('Agent Priming live run interrupted by stop request', undefined, {
+                dialogId: dlg.id.valueOf(),
+                reason: err.reason,
+            });
+            throw err;
+        }
         const errText = err instanceof Error ? (err.stack ?? err.message) : String(err);
         const errTextTrimmed = errText.trim().slice(0, 4000);
         fatalRunState = {
@@ -1882,20 +2013,27 @@ async function runAgentPrimingLive(dlg) {
     }
     finally {
         dlg.disableDiligencePush = prevDisableDiligencePush;
-        if (fatalRunState) {
-            await (0, dialog_run_state_1.setDialogRunState)(dlg.id, fatalRunState);
-        }
-        else {
-            let nextIdle = { kind: 'idle_waiting_user' };
-            try {
-                nextIdle = await (0, dialog_run_state_1.computeIdleRunState)(dlg);
+        try {
+            if (fatalRunState) {
+                await (0, dialog_run_state_1.setDialogRunState)(dlg.id, fatalRunState);
             }
-            catch (err) {
-                log_1.log.warn('Failed to compute idle runState after Agent Priming live run; falling back', err, {
-                    dialogId: dlg.id.valueOf(),
-                });
+            else {
+                let nextIdle = { kind: 'idle_waiting_user' };
+                try {
+                    nextIdle = await (0, dialog_run_state_1.computeIdleRunState)(dlg);
+                }
+                catch (err) {
+                    log_1.log.warn('Failed to compute idle runState after Agent Priming live run; falling back', err, {
+                        dialogId: dlg.id.valueOf(),
+                    });
+                }
+                await (0, dialog_run_state_1.setDialogRunState)(dlg.id, nextIdle);
+            }
+        }
+        finally {
+            if (ownsActiveRun) {
+                (0, dialog_run_state_1.clearActiveRun)(dlg.id);
             }
-            await (0, dialog_run_state_1.setDialogRunState)(dlg.id, nextIdle);
         }
     }
 }

package/dist/docs/keep-going.zh.md

@@ -0,0 +1,162 @@
+# Keep-Going（鞭策）— 设计文档
+
+## 概述
+
+Dominds 根对话旨在长期运行。根对话"停止"（变为空闲）通常不是操作员想要的：他们希望智能体持续推进，直到：
+
+- 合法地暂停等待人类决策（Q4H），或
+- 合法地暂停等待子对话（tellask/backfill）。
+
+本文档指定了一个运行时机制（"keep-going"），仅针对**根/主对话**，防止对话停止：每当驱动程序即将停止时，它会自动发送一个简短的鞭策语（渲染为正常的用户气泡）并继续生成，除非对话处于合法暂停状态（Q4H 或待处理的子对话）。
+
+## 目标
+
+- 防止根对话停止，除非处于合法暂停状态（Q4H / 子对话）。
+- 保持行为可预测和有界（无无限循环）。
+- 使鞭策语文本可按工作区（rtws）和语言配置。
+- 提供清晰的用户控制的"禁用"机制。
+
+## 非目标
+
+- 自动完成/自动将对话标记为完成。
+- 将此行为应用于子对话（子对话保持范围，应向其调用者报告）。
+
+## 定义
+
+- **根/主对话**：`RootDialog`（`dlg.id.rootId === dlg.id.selfId`），主要对话线程。
+- **子对话**：`SubDialog`，为 tellask / 作用域工作创建。
+- **Q4H**："Questions for Human"，通过 `!?@human` 发起，暂停对话进度直到人类响应。
+
+## 预期的"正常"完成路径（推荐）
+
+当智能体需要人类决策来结束时（例如，确认选择或决定是否将对话标记为完成），正确的路径是：
+
+1. 智能体发出 Q4H（`!?@human`）并提供必要的上下文和明确的决策请求。
+2. WebUI 清楚地呈现 Q4H。
+3. 人类决定并：
+   - 手动将根对话标记为"完成"，或
+   - 提供请求的信息以便对话继续。
+
+这是"受控收敛"路径。keep-going 机制不应覆盖合法的暂停状态。
+
+## Keep-Going 行为（"自动继续"回退）
+
+### 触发条件（必须全部满足）
+
+- 对话是**根/主对话**（绝不会是子对话）。
+- 对话**未暂停**：
+  - 没有待处理的 Q4H，并且
+  - 没有待处理的子对话（等待回填）。
+- 驱动程序即将停止生成循环（即没有工具/函数输出需要另一次迭代）。
+
+### 操作
+
+运行时自动发送一个鞭策语（渲染为正常的用户气泡）并运行另一次生成迭代。
+
+### 有界性
+
+为避免无限循环，keep-going 有一个按对话的预算（每个成员的 `diligence-push-max`），控制对于给定对话在运行时强制 Q4H 暂停之前可以注入多少个自动继续的鞭策语。
+
+- 默认值：**3**
+- 如果 `< 1`，则该成员的 keep-going 有效禁用
+- 可通过 `.minds/team.yaml` 中的 `diligence-push-max` 按成员配置
+
+### Q4H 时重置
+
+当对话因待处理的 Q4H（Questions for Human）而暂停时，keep-going 注入计数器会被重置。这确保在人类回答 Q4H 并恢复对话后，对话会获得新的 keep-going 预算。
+
+### 预算耗尽 → 强制 Q4H
+
+当 keep-going 预算耗尽时，运行时会创建一个 Q4H 条目，询问人类是否继续或停止。这将"有界性"转换为合法的暂停点，并避免无限自动继续循环。
+
+### 禁用开关
+
+可以通过以下任一方式按 rtws 禁用 keep-going：
+
+- 如果选中的鞭策语文件存在但其内容为空/仅空白，则禁用 keep-going（不注入）。
+
+可以通过以下任一方式按成员禁用 keep-going：
+
+- 如果 `diligence-push-max < 1`，则该成员的 keep-going 被禁用（不注入）。
+
+## 鞭策语解析
+
+让 `<rtws>` 为当前运行时工作区（即 `process.cwd()`）。
+
+解析顺序：
+
+1. `<rtws>/.minds/diligence.<work-lang-id>.md`（例如，`diligence.zh.md`）
+2. `<rtws>/.minds/diligence.md`（语言无关的回退）
+3. 内置回退文本（硬编码的 i18n；`zh` 是规范的并嵌入在源代码中）
+
+如果上述顺序中第一个存在的文件具有空/空白内容，则**禁用** keep-going。
+
+注意：鞭策语文件中的 YAML frontmatter 会被运行时忽略。如果存在，它被视为非内容元数据并从提示正文中剥离。
+
+### 团队成员上限：`diligence-push-max`
+
+每个团队成员可以选择通过 `.minds/team.yaml` 限制 keep-going：
+
+```yaml
+members:
+  alice:
+    diligence-push-max: 10
+```
+
+规则：
+
+- 如果缺失，`diligence-push-max` 对于该成员默认为 **3**。
+- 如果 `diligence-push-max < 1`，则该成员的 keep-going 被禁用（不注入），即使鞭策语文件存在。
+- 内置影子成员 `fuxi` 和 `pangu` 默认为 `diligence-push-max: 0`，除非在 team.yaml 中显式覆盖。
+
+## UX 备注
+
+- Keep-going 是一个仅运行时的提示，但它应该是**可见的**：鞭策语渲染为正常的用户消息气泡（由运行时自动发送），以便操作员理解为什么会出现额外的迭代。
+- 用户应该观察到智能体在仅工具操作后继续简短的跟进。
+- 当智能体真正需要用户干预时，它应该使用 Q4H。Keep-going 不应试图"假装"完成。
+
+## 实现（后端）
+
+### 位置
+
+在 LLM 驱动程序循环中实现（`dominds/main/llm/driver.ts`），作为迭代后的小检查：
+
+1. 如果 `suspendForHuman` 为 true，则停止（Q4H / 子对话待处理）。
+2. 如果有任何工具反馈，则正常继续。
+3. 否则（仅限根），尝试 keep-going 自动继续：
+   - 如果禁用 → 正常停止。
+   - 如果预算耗尽 → 创建 Q4H 并停止。
+   - 否则 → 自动发送鞭策语并继续。
+
+### 消息类型
+
+我们将鞭策语作为自动发送的用户消息注入：
+
+- 类型为 `prompting_msg`、角色为 `'user'` 的 `ChatMessage`
+
+这确保了：
+
+- 它存在于模型上下文中
+- 它作为人类消息记录持久化
+- 它在聊天时间线中渲染为正常的用户气泡（像任何其他用户消息一样）
+
+## 可观察性
+
+建议的后续步骤（初始实现不需要）：
+
+- 当触发 keep-going 时添加结构化日志行，包括：
+  - 对话 id
+  - 语言
+  - 使用的鞭策语来源（语言特定/通用/内置/禁用）
+- 为"keep-going 触发"和"keep-going 因空文件禁用"添加可选的指标计数器。
+
+## 测试
+
+回归测试应覆盖：
+
+- 根对话：仅工具输出 → 鞭策语注入 → 继续响应
+- 根对话：空助手输出 → 鞭策语注入 → 继续响应
+- 子对话：无鞭策语注入
+- 工作区配置：
+  - 当语言特定文件缺失时，`.minds/diligence.md` 被遵守
+  - 空的鞭策语文件禁用 keep-going