mocode-ai 0.5.5 → 0.5.6

package/dist/agent/core.js

@@ -138,6 +138,7 @@ function pushToolResult(history, tc, output, pruner, lifecycle, scheduler) {
  */
 export async function runAgentCore(opts) {
     const { history, userInput, signal, onContextUpdate, hooks, skipRollback } = opts;
+    const runtimeContextState = opts.contextState ?? contextState;
     const maxSteps = opts.maxSteps ?? config.maxSteps;
     // 中断回滚快照:入口(本 turn push 任何消息前)整段浅拷贝。abort 时 length=0;push(...saved) 还原。
     // 用 slice() 而非 length:maybeCompact 会原地重建(length=0;push(...rebuilt)),savedLen 会失效。
@@ -187,7 +188,7 @@ export async function runAgentCore(opts) {
     // 预算调度器:每个 runAgentCore 实例一个,步前 evaluateBudget + scheduleActions。
     // 决策按 ROI 分发(cold tools 优先 / history 摘要最后);contextBudget 开关关闭时为 null。
     const scheduler = config.contextBudget !== false
-        ? createBudgetScheduler() // 在 step 循环之外实例化一次,跨步持有 lastRunLog
+        ? createBudgetScheduler(runtimeContextState) // 在 step 循环之外实例化一次,跨步持有 lastRunLog
         : null;
     // 本轮流式状态:首个正文 token 到达即停 spinner(思考期间 spinner 持续转「思考中…」,不写思考内容)。
     let mode = 'idle';
@@ -235,7 +236,7 @@ export async function runAgentCore(opts) {
                 await scheduler.runStep(history, step);
             }
             else {
-                await maybeCompact(history);
+                await maybeCompact(history, undefined, undefined, runtimeContextState);
             }
             hooks.onStepStart?.(); // 主 agent:spinner.start('思考中')
             mode = 'idle';
@@ -260,7 +261,7 @@ export async function runAgentCore(opts) {
                 }
                 throw e;
             }
-            contextState.lastUsage = result.usage; // 供 /context 与状态行显示实测 token
+            runtimeContextState.lastUsage = result.usage; // 供 /context 与状态行显示实测 token
             addUsage(result.usage); // 本轮累计:onDone 摘要行 + AgentRunResult.usage 透传
             // 校正系数:API 实测 prompt_tokens / 估算 token。
             // 每次 chat 响应后刷新,让下次 evaluateBudget 用更接近真实的 actual。
@@ -269,7 +270,7 @@ export async function runAgentCore(opts) {
                 const estimated = estimateMessagesTokens(history) + estimateToolSchemaTokens();
                 if (estimated > 100) {
                     const raw = result.usage.promptTokens / estimated;
-                    contextState.correction = Math.max(0.5, Math.min(2.0, raw));
+                    runtimeContextState.correction = Math.max(0.5, Math.min(2.0, raw));
                 }
             }
             hooks.onChatDone?.(); // 主 agent:spinner.stop()

package/dist/agent/index.js

@@ -66,8 +66,11 @@ function flushToolBatch(expandSingleEntry = false) {
     batch.endBatch(id, layout);
     if (expandSingleEntry)
         batch.expandSingleEntryFully(id, layout);
-    // 摘要本身已有行尾；再补一行，保持工具与后续正文/状态摘要之间的原有间距。
-    layout.contentWrite('\n');
+    // 普通摘要只有一个“当前空行”，再 break 一次把它提交为分隔空行。
+    // mutation 自动展开时 content.insertAfter 已先把该当前空行提交到 rows；若这里仍补 \n，
+    // diff 后就会固定出现两条空白行。
+    if (!expandSingleEntry)
+        layout.contentWrite('\n');
 }
 /**
  * agent 核心循环(主 agent,TUI 渲染版):
@@ -104,6 +107,7 @@ onContextUpdate) {
     // 不能按普通字符串的“两个换行才有一个空行”来计算。
     let textBoundaryNewlines = 0;
     let hasPendingTextBoundary = false;
+    let toolBatchFollowsText = false;
     const hooks = {
         onText: (s) => {
             // 纯空白 chunk 在视觉上不是正文：既不切 batch，也不写入 markdown 缓冲。
@@ -130,6 +134,7 @@ onContextUpdate) {
             // 文本/思考已流完,模型转而生成 tool_call 参数(可能很长,如 write_file 整篇内容):
             // 补换行(让随后的 ● 行与 diff 不黏在正文末尾)+ 启「生成中」内联 spinner,内容区不再干等。
             if (hasPendingTextBoundary) {
+                toolBatchFollowsText = true;
                 if (textBoundaryNewlines < 1) {
                     layout.contentWrite('\n');
                 }
@@ -150,7 +155,15 @@ onContextUpdate) {
                     textBoundaryNewlines = 1;
             }
         },
-        onToolHeader: (tc) => writeToolHeader(tc),
+        onToolHeader: (tc) => {
+            // mutation 的自动展开会把 current/committed 空行状态互相转换；在首摘要真正
+            // 落屏前按视觉行归一，避免同样的文本→edit 边界偶发 1 行或 2 行。
+            if (toolBatchFollowsText && isMutationTool(tc.name)) {
+                layout.normalizeMutationBoundary();
+            }
+            toolBatchFollowsText = false;
+            writeToolHeader(tc);
+        },
         onToolStart: (name) => spinner.start(`执行 ${name}`),
         onToolDone: () => spinner.stop(),
         onToolResult: (tc, output, parsed, preWriteOld, editStartLine) => writeToolResult(tc, output, parsed, preWriteOld, editStartLine),

package/dist/agent/spawn.js

@@ -7,8 +7,8 @@
 //  - 独立 history:不共享主对话,避免子任务的工具噪声污染主上下文。
 //  - 系统提示复用主 agent 组装链(config.systemPrompt + memory 段 + skills 段)+ 子 agent 角色后缀。
 //  - 工具子集:按白名单从 chatTools 过滤;无白名单 = 全量(但 task 工具调用方通常会限定只读)。
-//  - 不调 beginTurn(不进主回滚链);但文件 mutation 仍经 executeTool→recordMutation,
-//    归入当前主轮次(语义:子 agent 的改动属于当前主轮,可随 /rollback 一起撤销)。
+//  - 不调 beginTurn(不进主回滚链);skipRollback=true 使文件 mutation 跳过 recordMutation,
+//    子 agent 的改动不进主回滚快照链(靠 git 兜底,见下方 skipRollback 注释)。
 //  - 步数上限默认更低(config.subAgentMaxSteps ?? 50),防子任务失控耗尽配额。
 //  - 中断透传:opts.signal(主 agent 的 abort signal)透传给 runAgentCore → chat/executeTool,
 //    主 Ctrl+C 树杀子 agent(chat 流式 abort + run_command/web_fetch 即时取消)。
@@ -21,6 +21,7 @@ import { buildMemorySection, buildMemoryIndexSection } from '../memory/index.js'
 import { ui } from '../ui/theme.js';
 import { runAgentCore } from './core.js';
 import { summarizeToolCall, summarizeToolResult, truncateDisplay } from '../ui/render.js';
+import { createContextState } from '../session/compact.js';
 /** 子 agent 系统提示后缀:角色与约束。 */
 const SUBAGENT_SUFFIX = `
 
@@ -115,6 +116,9 @@ export async function spawnAgent(opts) {
         // onStepStart / onChatDone / onToolStart / onToolDone / onAbort:子 agent 静默,无需 spinner / 中断渲染。
         // abort 还原(history 还原 + 模式还原)由 core 的 abortRestore 处理,hooks 只管展示。
     };
+    // 每个子 agent 独享统计/预算状态。不能保存再恢复模块级单例：多个 task 并发时
+    // save/restore 会竞态，且 lastEstimate / schedulerLog 仍会污染主 agent。
+    const localContextState = createContextState();
     const result = await runAgentCore({
         history,
         userInput: opts.prompt,
@@ -123,6 +127,7 @@ export async function spawnAgent(opts) {
         maxSteps,
         toolsOverride,
         skipRollback: true, // 逻辑隔离:子 agent 文件改动不进主回滚快照链,主 /rollback 不撤销(靠 git 兜底)
+        contextState: localContextState,
     });
     return {
         summary: result.finalText,

package/dist/project-skill/initializer.js

@@ -5,63 +5,63 @@ import { spawnAgent } from '../agent/spawn.js';
 /**
  * 子 agent 的系统提示后缀：角色与输出格式约束
  */
-const SKILL_INIT_SUFFIX = `You are a project exploration agent. Your task is to deeply understand this project and generate a concise "Project Skill" document.
-
-## ⚠️ Complementary to Snapshot — CRITICAL
-The following information is ALREADY provided by Project Snapshot — **do NOT repeat**:
-- ✗ Project one-liner description (快照已有)
-- ✗ Module names and file locations (快照 srcTree 已有)
-- ✗ Tech stack names and versions (快照 techStack 已有)
-- ✗ Build/test commands (快照 keyCommands 已有)
-- ✗ File lists and directory structure (快照 srcTree 已有)
-
-**Your job is to capture INSIGHTS only:**
-- **WHY** — design decisions, trade-offs, reasons for choosing X over Y
-- **HOW** — module behaviors, data flows, call chains, non-obvious interactions
-- **GOTCHAS** — pitfalls, edge cases, non-intuitive behaviors
-- **CONVENTIONS** — naming patterns, code style, unwritten rules
-
-## Exploration Strategy
-1. Use \`codegraph\` to trace call chains and understand module interactions
-2. Read core modules to understand **behaviors** (not just names)
-3. Look for complex logic, error handling patterns, unusual configs
-4. Identify naming conventions, common abstractions
-
-## Output Format
-Output the skill document between these exact delimiters:
-
-\`\`\`skill-start
-## 架构要点
-### 核心模块及职责
-- **\`path/to/module\`** — 行为描述（做什么 + 怎么做）
-...
-
-### 关键设计决策
-- 决策：原因
-...
-
-## 项目约定
-- 约定（具体的，有例子的）
-...
-
-## 开发流程
-- 命令 + 注意事项/坑点（命令本身快照已有，这里只写注意什么）
-...
-
-## 常见坑点
-- 坑：解法
-...
-\`\`\`skill-end
-
-## Rules — MUST FOLLOW
-1. 禁止列出文件名清单或目录结构
-2. 禁止列出依赖名和版本
-3. 禁止写项目概述/一句话描述
-4. 禁止只写命令本身（快照已有），只写注意事项
-5. 每个模块描述必须包含行为（做什么 + 怎么协作），不只是名称
-6. **总长度目标 3000-4000 字符，硬上限 4000**
-7. 写可操作的内容，用具体路径和例子
-8. 如果某个 section 没有实质内容，省略它
+const SKILL_INIT_SUFFIX = `You are a project exploration agent. Your task is to deeply understand this project and generate a concise "Project Skill" document.
+
+## ⚠️ Complementary to Snapshot — CRITICAL
+The following information is ALREADY provided by Project Snapshot — **do NOT repeat**:
+- ✗ Project one-liner description (快照已有)
+- ✗ Module names and file locations (快照 srcTree 已有)
+- ✗ Tech stack names and versions (快照 techStack 已有)
+- ✗ Build/test commands (快照 keyCommands 已有)
+- ✗ File lists and directory structure (快照 srcTree 已有)
+
+**Your job is to capture INSIGHTS only:**
+- **WHY** — design decisions, trade-offs, reasons for choosing X over Y
+- **HOW** — module behaviors, data flows, call chains, non-obvious interactions
+- **GOTCHAS** — pitfalls, edge cases, non-intuitive behaviors
+- **CONVENTIONS** — naming patterns, code style, unwritten rules
+
+## Exploration Strategy
+1. Use \`codegraph\` to trace call chains and understand module interactions
+2. Read core modules to understand **behaviors** (not just names)
+3. Look for complex logic, error handling patterns, unusual configs
+4. Identify naming conventions, common abstractions
+
+## Output Format
+Output the skill document between these exact delimiters:
+
+\`\`\`skill-start
+## 架构要点
+### 核心模块及职责
+- **\`path/to/module\`** — 行为描述（做什么 + 怎么做）
+...
+
+### 关键设计决策
+- 决策：原因
+...
+
+## 项目约定
+- 约定（具体的，有例子的）
+...
+
+## 开发流程
+- 命令 + 注意事项/坑点（命令本身快照已有，这里只写注意什么）
+...
+
+## 常见坑点
+- 坑：解法
+...
+\`\`\`skill-end
+
+## Rules — MUST FOLLOW
+1. 禁止列出文件名清单或目录结构
+2. 禁止列出依赖名和版本
+3. 禁止写项目概述/一句话描述
+4. 禁止只写命令本身（快照已有），只写注意事项
+5. 每个模块描述必须包含行为（做什么 + 怎么协作），不只是名称
+6. **总长度目标 3000-4000 字符，硬上限 4000**
+7. 写可操作的内容，用具体路径和例子
+8. 如果某个 section 没有实质内容，省略它
 `;
 /**
  * 生成初始项目 Skill（使用子 agent 深度探索）
@@ -72,35 +72,35 @@ export async function generateInitialSkill(existingSkill, signal) {
     const hasExisting = !!existingSkill;
     let prompt;
     if (hasExisting) {
-        prompt = `以下是当前的项目 Skill 内容，请深度探索项目并优化/完善它：
-
-\`\`\`markdown
-${existingSkill}
-\`\`\`
-
-## 优化方向
-1. 补充缺失的信息（架构要点、设计决策、调用链等）
-2. 修正过时或不准确的内容
-3. 让描述更具体（用实际路径和例子）
-4. 删除冗余或空泛的描述
-5. 如果发现新的坑点或约定，添加进去
-
+        prompt = `以下是当前的项目 Skill 内容，请深度探索项目并优化/完善它：
+
+\`\`\`markdown
+${existingSkill}
+\`\`\`
+
+## 优化方向
+1. 补充缺失的信息（架构要点、设计决策、调用链等）
+2. 修正过时或不准确的内容
+3. 让描述更具体（用实际路径和例子）
+4. 删除冗余或空泛的描述
+5. 如果发现新的坑点或约定，添加进去
+
 记住：保持精简，总长度控制在 4000-5000 字符。输出完整的优化后版本。`;
     }
     else {
-        prompt = `请深度探索当前项目，生成一份项目专属 Skill 文档。
-
-## 探索步骤
-1. 先用 glob 扫描项目结构（**/*.ts, **/*.json 等）
-2. 读取 package.json、README.md、tsconfig.json 等关键文件
-3. 用 codegraph 或 grep 找到主入口、核心模块、关键接口
-4. 理解架构模式、数据流向、调用关系
-5. 识别命名约定、代码风格、测试策略
-6. 找出可能的坑点（复杂配置、特殊依赖、构建陷阱）
-
-## 输出
-探索完成后，将完整的 skill 文档输出在 \`\`\`skill-start 和 \`\`\`skill-end 之间。
-
+        prompt = `请深度探索当前项目，生成一份项目专属 Skill 文档。
+
+## 探索步骤
+1. 先用 glob 扫描项目结构（**/*.ts, **/*.json 等）
+2. 读取 package.json、README.md、tsconfig.json 等关键文件
+3. 用 codegraph 或 grep 找到主入口、核心模块、关键接口
+4. 理解架构模式、数据流向、调用关系
+5. 识别命名约定、代码风格、测试策略
+6. 找出可能的坑点（复杂配置、特殊依赖、构建陷阱）
+
+## 输出
+探索完成后，将完整的 skill 文档输出在 \`\`\`skill-start 和 \`\`\`skill-end 之间。
+
 记住：内容要精简、可操作、有具体路径和例子。总长度控制在 4000-5000 字符。`;
     }
     try {

package/dist/project-snapshot/llm-snapshot.js

@@ -2,64 +2,64 @@ import { spawnAgent } from '../agent/spawn.js';
 /**
  * 子 agent 系统提示：让 agent 自主探索项目并生成 markdown 快照
  */
-const SNAPSHOT_LLM_SUFFIX = `You are a project analysis agent. Your task is to explore this project and generate a concise markdown snapshot for an AI coding assistant.
-
-## Your Mission
-Explore the project using available tools (read_file, glob, grep) and generate a structured markdown snapshot that captures:
-- WHAT exists (project description, tech stack, commands, modules, directory structure)
-- WHERE it is (paths, locations)
-
-Do NOT explain WHY or HOW (that's Project Skill's job).
-
-## Exploration Strategy
-1. Read package.json, README.md, tsconfig.json (or equivalent for other languages)
-2. List top-level directories to identify modules
-3. Scan src/ directory structure (depth ≤3, directories only)
-4. Extract key commands from package.json scripts
-5. Identify tech stack from dependencies
-
-## Output Format
-Output a markdown document between these exact delimiters:
-
-\`\`\`snapshot-md
-# Project Snapshot
-
-## Description
-(一句话描述项目，≤80字，中文)
-
-## Tech Stack
-(关键技术栈，逗号分隔，含版本，≤15项)
-
-## Commands
-| Command | Description |
-|---------|-------------|
-| \`npm run build\` | 构建项目 |
-| \`npm test\` | 运行测试 |
-| ... | ... |
-
-## Modules
-- **module-name** — 一句话职责描述（≤20字）
-- **module-name** — 一句话职责描述
-- ...
-
-## Source Tree
-\`\`\`
-src/
-  agent/
-  tools/
-  ui/
-\`\`\`
-\`\`\`snapshot-md
-
-## Rules
-1. **Description**: ≤80字，中文，从 README 和 package.json description 提炼。不要"一个..."开头。
-2. **Tech Stack**: ≤15项，逗号分隔，含版本。格式如 "TypeScript 5.x, Node.js ≥18, openai@^4"。
-3. **Commands**: 5-8个最重要的命令，从 package.json scripts 提取。Description ≤15字。用表格格式。
-4. **Modules**: 每个顶层模块目录一条。职责≤20字，只写 WHAT（做什么）。
-5. **Source Tree**: 只列目录（不列文件），深度≤3，用缩进表示层级，放在代码块中。
-6. 不要包含：设计决策、注意事项、坑点、约定 → 这些是 Skill 的职责。
-7. 总 markdown ≤ 2500 字符。
-8. 使用中文。
+const SNAPSHOT_LLM_SUFFIX = `You are a project analysis agent. Your task is to explore this project and generate a concise markdown snapshot for an AI coding assistant.
+
+## Your Mission
+Explore the project using available tools (read_file, glob, grep) and generate a structured markdown snapshot that captures:
+- WHAT exists (project description, tech stack, commands, modules, directory structure)
+- WHERE it is (paths, locations)
+
+Do NOT explain WHY or HOW (that's Project Skill's job).
+
+## Exploration Strategy
+1. Read package.json, README.md, tsconfig.json (or equivalent for other languages)
+2. List top-level directories to identify modules
+3. Scan src/ directory structure (depth ≤3, directories only)
+4. Extract key commands from package.json scripts
+5. Identify tech stack from dependencies
+
+## Output Format
+Output a markdown document between these exact delimiters:
+
+\`\`\`snapshot-md
+# Project Snapshot
+
+## Description
+(一句话描述项目，≤80字，中文)
+
+## Tech Stack
+(关键技术栈，逗号分隔，含版本，≤15项)
+
+## Commands
+| Command | Description |
+|---------|-------------|
+| \`npm run build\` | 构建项目 |
+| \`npm test\` | 运行测试 |
+| ... | ... |
+
+## Modules
+- **module-name** — 一句话职责描述（≤20字）
+- **module-name** — 一句话职责描述
+- ...
+
+## Source Tree
+\`\`\`
+src/
+  agent/
+  tools/
+  ui/
+\`\`\`
+\`\`\`snapshot-md
+
+## Rules
+1. **Description**: ≤80字，中文，从 README 和 package.json description 提炼。不要"一个..."开头。
+2. **Tech Stack**: ≤15项，逗号分隔，含版本。格式如 "TypeScript 5.x, Node.js ≥18, openai@^4"。
+3. **Commands**: 5-8个最重要的命令，从 package.json scripts 提取。Description ≤15字。用表格格式。
+4. **Modules**: 每个顶层模块目录一条。职责≤20字，只写 WHAT（做什么）。
+5. **Source Tree**: 只列目录（不列文件），深度≤3，用缩进表示层级，放在代码块中。
+6. 不要包含：设计决策、注意事项、坑点、约定 → 这些是 Skill 的职责。
+7. 总 markdown ≤ 2500 字符。
+8. 使用中文。
 `;
 /**
  * 生成 LLM 快照（markdown 格式）
@@ -67,17 +67,17 @@ src/
  * @param signal AbortSignal
  */
 export async function generateLLMSnapshot(root, signal) {
-    const prompt = `请探索项目 ${root}，生成项目快照（markdown 格式）。
-
-## 探索步骤
-1. 读取 package.json（或等效配置文件）
-2. 读取 README.md
-3. 列出顶层目录，识别模块
-4. 扫描 src/ 目录结构（深度≤3，只列目录）
-5. 从 package.json scripts 提取关键命令
-6. 从 dependencies 识别技术栈
-
-## 输出
+    const prompt = `请探索项目 ${root}，生成项目快照（markdown 格式）。
+
+## 探索步骤
+1. 读取 package.json（或等效配置文件）
+2. 读取 README.md
+3. 列出顶层目录，识别模块
+4. 扫描 src/ 目录结构（深度≤3，只列目录）
+5. 从 package.json scripts 提取关键命令
+6. 从 dependencies 识别技术栈
+
+## 输出
 严格按照系统提示的 markdown 格式输出，不要添加额外解释。`;
     try {
         const result = await spawnAgent({

package/dist/repl/index.js

@@ -169,7 +169,7 @@ function refreshStatusBase(history, lastTurnUsage) {
         model: config.model,
         contextBar: renderContextBarInline(history),
         cwd: process.cwd(),
-        modeTag: getAgentMode() === 'plan' ? 'plan' : 'auto',
+        modeTag: getAgentMode() === 'plan' ? 'Plan' : 'Auto',
         planSummary: hasActivePlan() ? getActivePlanSummary(process.stdout.columns ?? 80) : '',
         lastTurnUsage,
     });

package/dist/session/compact.js

@@ -6,10 +6,9 @@ import { Spinner } from '../ui/spinner.js';
 import * as layout from '../ui/layout.js';
 import { pruneAfterCompaction } from '../rollback/index.js';
 import { toText } from '../context/utils.js';
-/** 跨模块共享的上下文状态:agent 写 lastUsage,compact 写 lastEstimate,repl 的 /context 读。
- *  scheduler.ts 写最近一次调度日志(可选,repl 可读不到时 no-op)。
- *  correction:API 实测 token / 估算 token 的校正系数(1.0 = 无偏差;>1 = 低估;<1 = 高估)。
- *  由 agent/core.ts 在每次 chat 响应后更新;compact/repl 在 usage 失效时同步重置。 */
+export function createContextState() {
+    return { lastEstimate: 0, correction: 1 };
+}
 export const contextState = {
     lastEstimate: 0,
     correction: 1,
@@ -240,9 +239,10 @@ async function defaultSummarize(older, focus) {
  * 不检查阈值——调用方(maybeCompact)决定是否调;/compact 直接调以强制压缩。
  */
 export async function compactHistory(history, opts) {
+    const state = opts.contextState ?? contextState;
     const schemaTokens = estimateToolSchemaTokens();
     const estimateBefore = estimateMessagesTokens(history) + schemaTokens;
-    contextState.lastEstimate = estimateBefore;
+    state.lastEstimate = estimateBefore;
     const groups = groupFromEnd(history);
     // 保近期:从尾向前累积直到预算花完(至少保 1 组),永不劈开 group。
     const keepBudget = Math.floor(opts.window * 0.4);
@@ -313,9 +313,9 @@ export async function compactHistory(history, opts) {
             history.push(...rebuilt);
             pruneAfterCompaction(history);
             const estimateAfter = estimateMessagesTokens(history) + schemaTokens;
-            contextState.lastEstimate = estimateAfter;
-            contextState.lastUsage = undefined;
-            contextState.correction = 1;
+            state.lastEstimate = estimateAfter;
+            state.lastUsage = undefined;
+            state.correction = 1;
             layout.contentWrite(`  ${ui.bold}${ui.accent}●${ui.reset} ${ui.accent}强制压缩(focus on early history)${ui.reset}  ${ui.dim}${estimateBefore} → ${estimateAfter} tokens${ui.reset}\n`);
             return {
                 compacted: true,
@@ -400,9 +400,9 @@ export async function compactHistory(history, opts) {
         history.push(...rebuilt);
         pruneAfterCompaction(history); // 摘要删了旧轮次 → 按存活轮次裁剪回滚日志
         const estimateAfter = estimateMessagesTokens(history) + schemaTokens;
-        contextState.lastEstimate = estimateAfter;
-        contextState.lastUsage = undefined; // 压缩后旧 usage 失效,/context 改用估算
-        contextState.correction = 1;
+        state.lastEstimate = estimateAfter;
+        state.lastUsage = undefined; // 压缩后旧 usage 失效,/context 改用估算
+        state.correction = 1;
         layout.contentWrite(`  ${ui.bold}${ui.accent}●${ui.reset} ${ui.accent}压缩上下文${ui.reset}  ${ui.dim}${estimateBefore} → ${estimateAfter} tokens${ui.reset}\n`);
         // 抖动保护:压缩后仍超阈 → 提示 /clear,不死循环
         if (estimateAfter >= opts.threshold * opts.window) {
@@ -418,9 +418,9 @@ export async function compactHistory(history, opts) {
     }
     // 摘要失败:回退仅微压缩(tool content 已原地改),结构不动
     const estimateAfter = estimateMessagesTokens(history) + schemaTokens;
-    contextState.lastEstimate = estimateAfter;
-    contextState.lastUsage = undefined; // 结构虽未变,但 token 数已变,旧 usage 失效
-    contextState.correction = 1;
+    state.lastEstimate = estimateAfter;
+    state.lastUsage = undefined; // 结构虽未变,但 token 数已变,旧 usage 失效
+    state.correction = 1;
     if (microcompactDone) {
         layout.contentWrite(`  ${ui.bold}${ui.accent}●${ui.reset} ${ui.accent}微压缩旧工具结果${ui.reset}  ${ui.dim}${estimateBefore} → ${estimateAfter} tokens${ui.reset}\n`);
         return {
@@ -458,10 +458,10 @@ export async function compactHistory(history, opts) {
  * 强制走 compactHistory(manual/force 参数透传)。返 CompactResult 给 caller 文案展示。
  * 默认 manual=false 自动路径完全不变。
  */
-export async function maybeCompact(history, report, manualOpts) {
+export async function maybeCompact(history, report, manualOpts, state = contextState) {
     const schemaTokens = estimateToolSchemaTokens();
     const est = estimateMessagesTokens(history) + schemaTokens;
-    contextState.lastEstimate = est;
+    state.lastEstimate = est;
     const isManual = manualOpts?.manual === true;
     // 手动路径:旁路 autoCompact / report / 总阈三重门
     if (!isManual) {
@@ -485,6 +485,7 @@ export async function maybeCompact(history, report, manualOpts) {
         focus: manualOpts?.focus,
         manual: isManual,
         force: manualOpts?.force,
+        contextState: state,
     });
     if (isManual)
         return r;

package/dist/session/index.js

@@ -4,7 +4,7 @@
  *  - persist.ts:history 序列化到磁盘 + --resume / /resume
  * 依赖方向:session → {llm(摘要复用 chat), config, ui};llm 不反向依赖 session。
  */
-export { compactHistory, maybeCompact, capToolResultForHistory, truncateMid, contextState, } from './compact.js';
+export { compactHistory, maybeCompact, capToolResultForHistory, truncateMid, contextState, createContextState, } from './compact.js';
 // ── Context Budget Scheduler 接缝 ────────────────────────────────────────
 // agent/core.ts 步前调 runScheduler(history, step):评估五区预算 → 按 ROI 调度
 // shrink_cold_tools / cap_hot_tools / compact_history。开关关闭时退化为 maybeCompact。

package/dist/session/scheduler.js

@@ -38,14 +38,14 @@ import { ui } from '../ui/theme.js';
 /** 创建 runAgentCore 闭包持有的 scheduler(每次 agent 启动一个新实例)。
  *  observePush 当前只是占位:真正 L1/L2/L3 已由 cap / pruner / lifecycle 在 push 时跑;
  *  保留接口为后续「调度器注入 hotBoundary 给 lifecycle」演进留接缝。 */
-export function createBudgetScheduler() {
+export function createBudgetScheduler(state = contextState) {
     const obs = {
         lastRunLog: null,
         observePush(_history, _idx) {
             // 占位:push-time 三闸(cap / pruner / lifecycle)已自动跑;此接缝供将来演进。
         },
         async runStep(history, step) {
-            const report = evaluateBudget(history, config.contextWindowTokens, step, contextState.correction);
+            const report = evaluateBudget(history, config.contextWindowTokens, step, state.correction);
             const actions = scheduleActions(report);
             let compactHistoryCalled = false;
             for (const a of actions) {
@@ -55,7 +55,7 @@ export function createBudgetScheduler() {
                 }
                 else if (a.kind === 'compact_history') {
                     // 路由到 maybeCompact(history, report)——按 ROI 调度(只有 history 超 / totalOver 才真压)
-                    await maybeCompact(history, report);
+                    await maybeCompact(history, report, undefined, state);
                     compactHistoryCalled = true;
                 }
                 // shrink_cold_tools L1/L2/L3 与 cap_hot_tools:已由 push-time 闸在每次 push 自动跑
@@ -71,14 +71,14 @@ export function createBudgetScheduler() {
             };
             obs.lastRunLog = log;
             // 暴露给 /context 共享读(repl / context 命令)
-            contextState.schedulerLog = log;
+            state.schedulerLog = log;
         },
     };
     return obs;
 }
 /** 便捷:agent/core.ts 不需要每次 createBudgetScheduler,直接 runScheduler(history, step)。 */
-export async function runScheduler(history, step) {
-    const s = createBudgetScheduler();
+export async function runScheduler(history, step, state = contextState) {
+    const s = createBudgetScheduler(state);
     await s.runStep(history, step);
 }
 /** 手动 /compact 入口(repl):与自动路径完全一致——五区 ROI 调度,但 history 摘要强制执行。

package/dist/ui/content.js

@@ -136,6 +136,22 @@ export function totalRows() {
 export function committedRows() {
     return rows.length;
 }
+/** 把缓冲尾部的视觉空白行归一化为恰好 count 条，并结束在“无当前行”状态。
+ * 供 markdown→mutation 边界使用；ANSI reset/颜色码和空格均按视觉空白处理。 */
+export function normalizeTrailingBlankRows(count) {
+    if (hasCurrent) {
+        rows.push(rowStartSgr + curRaw + '\x1B[0m');
+    }
+    const isBlank = (line) => line.replace(/\x1b\[[0-9;]*m/g, '').trim().length === 0;
+    while (rows.length > 0 && isBlank(rows[rows.length - 1]))
+        rows.pop();
+    for (let i = 0; i < Math.max(0, count); i++)
+        rows.push('\x1B[0m');
+    curSgr = '';
+    rowStartSgr = '';
+    curRaw = '';
+    hasCurrent = false;
+}
 /** 取绝对行索引(0-based,含当前行)的原始自洽行;越界返 null。供鼠标选区文本提取。 */
 export function lineAt(abs) {
     const all = snapshot();

package/dist/ui/layout.js

@@ -3,6 +3,7 @@ import { charWidth, displayWidth, truncateDisplay, truncateDisplayHead, truncate
 import { ui } from './theme.js';
 import * as content from './content.js';
 import * as mouse from './mouse.js';
+import { shiftBatchesAfter } from './batch.js';
 import { copyToClipboard, readClipboard } from './clipboard.js';
 import { renderMarkdown } from './markdown.js';
 // ── 内部状态 ──
@@ -541,8 +542,9 @@ export function contentInsertAfter(after, lines) {
             scrollOffset = Math.min(delta, Math.max(0, content.totalRows() - g.contentBottom));
         }
     }
-    // batch 摘要行索引平移
-    void import('./batch.js').then((m) => m.shiftBatchesAfter(after, delta));
+    // 必须同步平移 batch 索引。若延迟到 dynamic import.then，下一条 mutation 可能已经
+    // 按插入后的 buffer 创建；旧回调会再平移它一次，导致详情插到空行之后。
+    shiftBatchesAfter(after, delta);
     repaintViewport();
 }
 /**
@@ -570,14 +572,32 @@ export function contentDeleteFrom(startIdx, n) {
     if (scrolled) {
         scrollOffset = Math.max(0, scrollOffset - delta);
     }
-    // batch 摘要行索引平移(用 -delta 表示后段索引前移)
-    void import('./batch.js').then((m) => m.shiftBatchesAfter(startIdx, -delta));
+    // batch 摘要行索引平移(用 -delta 表示后段索引前移)，同插入路径必须同步。
+    shiftBatchesAfter(startIdx, -delta);
     repaintViewport();
 }
 /** 当前内容物理行总数(含当前未提交行)。供 batch 渲染器在 endBatch 时定位摘要行索引。 */
 export function totalRows() {
     return content.totalRows();
 }
+/** 正文→mutation 首摘要前，把尾部间距强制归一为一条视觉空行。 */
+export function normalizeMutationBoundary() {
+    if (!active || !ui.isTTY)
+        return;
+    if (mdActive)
+        commitMd();
+    const totalBefore = content.totalRows();
+    content.normalizeTrailingBlankRows(1);
+    const g = getGeo();
+    const delta = content.totalRows() - totalBefore;
+    if (scrollOffset > 0 && delta !== 0) {
+        scrollOffset = Math.max(0, Math.min(scrollOffset + delta, Math.max(0, content.totalRows() - g.contentBottom)));
+    }
+    contentRow = Math.min(content.committedRows() + 1, g.contentBottom);
+    contentCol = 1;
+    if (scrollOffset === 0)
+        repaintViewport();
+}
 /** 原地刷新一条内容行（行数不变），用于运行中的工具 batch 更新计数。 */
 export function contentReplaceLine(absIdx, line) {
     if (!active)
@@ -1273,11 +1293,11 @@ function composeModelLine(status, cols) {
     const ctxW = ansiDisplayWidth(ctx);
     // 左段:模式标识 + 切换提示(灰)+ 本轮 token chip。token chip 仅展示总量,用 mid 灰,不抢主色。
     const modeTag = status.modeTag ?? '';
-    const modeColor = modeTag === 'plan' ? ui.yellow : ui.accent;
+    const modeColor = modeTag === 'Plan' ? ui.yellow : ui.accent;
     const modePart = modeTag ? `${modeColor}${modeTag}${ui.reset}` : '';
     const modeW = modeTag ? displayWidth(modeTag) : 0;
     // 切换提示:告诉用户怎么切模式。灰(dim)降优先级,不与 modeTag 抢色;只在有 modeTag 时出现。
-    const HINT = 'Shift+Tab 切换模式';
+    const HINT = 'Shift+Tab 切换';
     const hintW = modeTag ? displayWidth(HINT) : 0;
     const hintPart = modeTag ? `${ui.dim}${HINT}${ui.reset}` : '';
     const tokChip = formatTurnTokenChip(status.lastTurnUsage);

package/dist/ui/markdown.js

@@ -13,7 +13,7 @@
 // clipAnsiLine 兜底,绝不溢出。颜色一律嵌入式 ANSI(ui.*)写进字符串。
 import { highlight, supportsLanguage } from 'cli-highlight';
 import { ui, getThemeVersion } from './theme.js';
-import { charWidth, displayWidth, ansiDisplayWidth } from './render.js';
+import { charWidth, displayWidth, ansiDisplayWidth, stripAnsi } from './render.js';
 const RESET = '\x1b[0m';
 // theme 无 italic/strike,自备(TTY 感知:!isTTY 退化为空串,同 ui.* 契约)。
 const ITALIC = ui.isTTY ? '\x1b[3m' : '';
@@ -577,13 +577,14 @@ function renderMarkdownImpl(text, cols) {
     // 独立 markdown 段的外部间距由 agent/batch 边界统一管理。流式后端可能把
     // "\n\n" 与首段正文拆成不同 chunk；仅清洗首个正文 chunk 不够，因为 mdBuf
     // 累积重渲染时这些换行仍会变成段首空行。这里最终兜底，正文段永不自带前导空行。
-    while (out.length > 0 && out[0] === '')
+    const isVisualBlank = (line) => stripAnsi(line).trim().length === 0;
+    while (out.length > 0 && isVisualBlank(out[0]))
         out.shift();
     // 末尾不留空行:agent onText 后接 onToolCall 的 contentWrite('\n') 会补 1 空行分隔正文与 ● 行;
     // 若 md 末尾自带空行(段落/代码块后)则叠成 2 空行。裁掉末尾连续空行,让 onToolCall / 轮末
     // contentWrite('\n') 恰好补 1 行(与改造前 raw 文本行为一致)。块间空行(flushPara/flushCode 中段
     // push 的)不受影响——只裁末尾。
-    while (out.length > 0 && out[out.length - 1] === '')
+    while (out.length > 0 && isVisualBlank(out[out.length - 1]))
         out.pop();
     return out;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mocode-ai",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "description": "终端编码 agent:LLM + tool-call 循环 + 流式输出(含思考)+ 16 个工具,接任意 OpenAI 兼容后端。",
   "type": "module",
   "bin": {