codemini-cli 0.2.8 → 0.3.0

package/src/core/tools.js

@@ -14,7 +14,7 @@ import {
 } from './shell.js';
 import { evaluateCommandPolicy } from './command-policy.js';
 import { queryAst, readAstNode, resolveAstTarget } from './ast.js';
-import { initializeProjectIndex, refreshIndexedFile } from './project-index.js';
+import { initializeProjectIndex, queryProjectIndex, refreshIndexedFile } from './project-index.js';
 import { checkReadDedup } from './agent-loop.js';
 
 const SKIP_DIRS = new Set(['.git', 'node_modules', '.codemini', '.codemini-global', 'dist', 'coverage']);
@@ -1928,6 +1928,24 @@ export function getBuiltinTools({ workspaceRoot = process.cwd(), config, onSyste
         }
       }
     },
+    {
+      type: 'function',
+      function: {
+        name: 'query_project_index',
+        description:
+          'Query the lightweight project index before broad file reads. Uses both project-map metadata and file-index symbols to suggest the most relevant files for the current task.',
+        parameters: {
+          type: 'object',
+          properties: {
+            query: { type: 'string', description: 'Task or code search phrase such as "login auth" or "tui presenters"' },
+            path: { type: 'string', description: 'Optional path prefix like src or src/auth to narrow results' },
+            path_prefix: { type: 'string', description: 'Alias for path' },
+            language: { type: 'string', description: 'Optional language filter such as ts, js, python, or go' },
+            max_results: { type: 'number', description: 'Max result files to return' }
+          }
+        }
+      }
+    },
     {
       type: 'function',
       function: {
@@ -2182,6 +2200,10 @@ export function getBuiltinTools({ workspaceRoot = process.cwd(), config, onSyste
         if (readPath) lastReadPath = readPath;
         return result;
       }),
+    query_project_index: async (args) => {
+      await ensureProjectIndex();
+      return queryProjectIndex(workspaceRoot, args);
+    },
     grep: (args) => grep(workspaceRoot, args),
     glob: (args) => glob(workspaceRoot, args),
     list: (args) => list(workspaceRoot, args),
@@ -2311,6 +2333,33 @@ export function getBuiltinTools({ workspaceRoot = process.cwd(), config, onSyste
       return `${header}\n${dirs.join('\n')}${dirs.length && files.length ? '\n' : ''}${files.join('\n')}`;
     },
 
+    query_project_index(result) {
+      if (!result || typeof result !== 'object') return String(result);
+      const lines = [];
+      if (result.query) lines.push(`[project_index: "${result.query}"]`);
+      if (result.project_root) lines.push(`project_root: ${result.project_root}`);
+      const projectMap = result.project_map;
+      if (projectMap) {
+        lines.push(`languages: ${(projectMap.languages || []).join(', ') || 'unknown'}`);
+        lines.push(`source_roots: ${(projectMap.source_roots || []).join(', ') || 'none'}`);
+        lines.push(`test_roots: ${(projectMap.test_roots || []).join(', ') || 'none'}`);
+        lines.push(`entry_candidates: ${(projectMap.entry_candidates || []).join(', ') || 'none'}`);
+        lines.push(`framework_hints: ${(projectMap.framework_hints || []).join(', ') || 'none'}`);
+      }
+      const matches = Array.isArray(result.matches) ? result.matches : [];
+      if (matches.length === 0) {
+        lines.push('No indexed file matches found.');
+        return lines.join('\n');
+      }
+      lines.push('matches:');
+      for (const item of matches) {
+        lines.push(
+          `- ${item.file} [score=${item.score}] exports=[${(item.exports || []).join(', ')}] functions=[${(item.functions || []).join(', ')}] classes=[${(item.classes || []).join(', ')}]`
+        );
+      }
+      return lines.join('\n');
+    },
+
     edit(result) {
       if (!result || typeof result !== 'object') return String(result);
       const p = result.path || '';

package/src/tui/chat-app.js

@@ -2,6 +2,20 @@ import React, { useEffect, useMemo, useRef, useState } from 'react';
 import { Box, Text, useApp, useInput } from 'ink';
 import { shouldCaptureEscapeSequence } from './input-escape.js';
 import { classifyCommandIntent } from '../core/shell.js';
+import {
+  buildInterToolNotice as buildRegisteredInterToolNotice,
+  buildPreToolNotice as buildRegisteredPreToolNotice,
+  buildSyntheticCompletionText as buildRegisteredSyntheticCompletionText
+} from './tool-narration.js';
+import {
+  describeToolActivity as describeRegisteredToolActivity,
+  isCodeGenerationActivityName
+} from './tool-activity/index.js';
+import {
+  describeAutoSkillActivity as describeRegisteredAutoSkillActivity,
+  describeSkillActivity as describeRegisteredSkillActivity,
+  formatAutoSkillBadge as formatRegisteredAutoSkillBadge
+} from './skill-activity/index.js';
 
 const h = React.createElement;
 const SUGGESTION_PAGE_SIZE = 8;
@@ -675,33 +689,8 @@ function parseToolDisplayName(name) {
   };
 }
 
-function isCodeGenerationActivityName(name) {
-  return String(name || '').trim() === 'Code generation';
-}
-
 export function buildPreToolNotice(name, copy) {
-  const parsed = parseToolDisplayName(name);
-  const base = parsed.base;
-  const target = parsed.target ? trimText(parsed.target, 48) : '';
-  const isEnglish = String(copy?.roleLabels?.coder || '').trim() === 'CODER' && String(copy?.roleLabels?.you || '').trim() === 'YOU';
-
-  if (isEnglish) {
-    if (base === 'read') return target ? `I'll inspect ${target} first.` : `I'll inspect the relevant file first.`;
-    if (base === 'list' || base === 'glob') return target ? `I'll inspect the ${target} directory first.` : `I'll inspect the relevant directory first.`;
-    if (base === 'grep') return `I'll search the relevant code first.`;
-    if (base === 'edit' || base === 'write' || base === 'patch' || base === 'generate_diff') {
-      return `I'll inspect the current code first, then make the change.`;
-    }
-    if (base === 'run') return `I'll verify the current project state first.`;
-    return `I'll check the relevant project context first.`;
-  }
-
-  if (base === 'read') return target ? `我先查看 ${target} 的内容。` : '我先查看相关文件内容。';
-  if (base === 'list' || base === 'glob') return target ? `我先查看 ${target} 目录里的内容。` : '我先查看相关目录内容。';
-  if (base === 'grep') return '我先搜索相关代码位置。';
-  if (base === 'edit' || base === 'write' || base === 'patch' || base === 'generate_diff') return '我先确认当前代码上下文，再动手修改。';
-  if (base === 'run') return '我先检查当前项目状态。';
-  return '我先查看相关上下文。';
+  return buildRegisteredPreToolNotice(name, copy);
 }
 
 export function shouldInjectPreToolNotice(msg) {
@@ -712,6 +701,33 @@ export function shouldInjectPreToolNotice(msg) {
   return !text && !hasTextSegment;
 }
 
+function getLastToolActivity(msg, statuses = []) {
+  const allowed = new Set((Array.isArray(statuses) ? statuses : []).map((status) => String(status)));
+  const segments = Array.isArray(msg?.segments) ? msg.segments : [];
+  for (let idx = segments.length - 1; idx >= 0; idx -= 1) {
+    const segment = segments[idx];
+    if (segment?.type !== 'tool' && segment?.type !== 'system_tool') continue;
+    if (allowed.size === 0 || allowed.has(String(segment.status || ''))) return segment;
+  }
+  return null;
+}
+
+function hasOnlySyntheticNarration(msg) {
+  if (!msg?.syntheticPrelude) return false;
+  const segments = Array.isArray(msg?.segments) ? msg.segments : [];
+  const hasToolRows = segments.some((segment) => segment?.type === 'tool' || segment?.type === 'system_tool');
+  const textSegments = segments.filter((segment) => segment?.type === 'text' && String(segment.text || '').trim());
+  return hasToolRows && textSegments.length <= 1;
+}
+
+export function buildInterToolNotice(previousActivity, nextToolName, copy) {
+  return buildRegisteredInterToolNotice(previousActivity, nextToolName, copy);
+}
+
+export function buildSyntheticCompletionText(msg, copy) {
+  return buildRegisteredSyntheticCompletionText(msg, copy);
+}
+
 function formatDurationMs(ms) {
   const safeMs = Math.max(0, Number(ms) || 0);
   return `${(safeMs / 1000).toFixed(1)}s`;
@@ -818,168 +834,19 @@ export function shouldShowCompletionFooter(msg) {
 }
 
 function describeToolActivity(name, copy, { done = false, blocked = false } = {}) {
-  const parsed = parseToolDisplayName(name);
-  if (parsed.base === 'project_index') {
-    return blocked
-      ? `${copy.toolActivity.blocked}: project index`
-      : done
-        ? copy.toolActivity.doneProjectIndex
-        : copy.toolActivity.doingProjectIndex;
-  }
-  if (parsed.base === 'file_index') {
-    const safeTarget = trimText(parsed.target || '.codemini-project/file-index.json', 72);
-    return blocked
-      ? `${copy.toolActivity.blocked}: ${safeTarget}`
-      : done
-        ? `${copy.toolActivity.doneFileIndex}: ${safeTarget}`
-        : `${copy.toolActivity.doingFileIndex}: ${safeTarget}`;
-  }
-  if (parsed.base === 'run' || parsed.base === 'start_service') {
-    const intent = classifyCommandIntent(parsed.target);
-    const target = parsed.target || intent.kind || 'command';
-    if (intent.kind === 'install') {
-      return blocked
-        ? `${copy.toolActivity.blocked}: ${target}`
-        : done
-          ? `${copy.toolActivity.doneInstall}: ${target}`
-          : `${copy.toolActivity.doingInstall}: ${target}`;
-    }
-    if (intent.kind === 'build') {
-      return blocked
-        ? `${copy.toolActivity.blocked}: ${target}`
-        : done
-          ? `${copy.toolActivity.doneBuild}: ${target}`
-          : `${copy.toolActivity.doingBuild}: ${target}`;
-    }
-    if (intent.kind === 'test') {
-      return blocked
-        ? `${copy.toolActivity.blocked}: ${target}`
-        : done
-          ? `${copy.toolActivity.doneTest}: ${target}`
-          : `${copy.toolActivity.doingTest}: ${target}`;
-    }
-    if (intent.kind === 'frontend-service') {
-      return blocked
-        ? `${copy.toolActivity.blocked}: ${target}`
-        : done
-          ? `${copy.toolActivity.doneFrontend}: ${target}`
-          : `${copy.toolActivity.doingFrontend}: ${target}`;
-    }
-    if (intent.kind === 'backend-service') {
-      return blocked
-        ? `${copy.toolActivity.blocked}: ${target}`
-        : done
-          ? `${copy.toolActivity.doneBackend}: ${target}`
-          : `${copy.toolActivity.doingBackend}: ${target}`;
-    }
-    if (intent.kind === 'database-service') {
-      return blocked
-        ? `${copy.toolActivity.blocked}: ${target}`
-        : done
-          ? `${copy.toolActivity.doneDatabase}: ${target}`
-          : `${copy.toolActivity.doingDatabase}: ${target}`;
-    }
-    if (intent.kind === 'docker-service') {
-      return blocked
-        ? `${copy.toolActivity.blocked}: ${target}`
-        : done
-          ? `${copy.toolActivity.doneDocker}: ${target}`
-          : `${copy.toolActivity.doingDocker}: ${target}`;
-    }
-    if (intent.kind === 'service') {
-      return blocked
-        ? `${copy.toolActivity.blocked}: ${target}`
-        : done
-          ? `${copy.toolActivity.doneGeneric}: ${target}`
-          : `${copy.toolActivity.doingGeneric}: ${target}`;
-    }
-  }
-  if (isCodeGenerationActivityName(name)) {
-    return blocked
-      ? `${copy.toolActivity.blocked}: code generation`
-      : done
-        ? copy.toolActivity.doneCodeGeneration
-        : copy.toolActivity.doingCodeGeneration;
-  }
-  const { raw, base, target } = parseToolDisplayName(name);
-  const safeTarget = trimText(target, 72);
-  if (base === 'read') {
-    return blocked
-      ? `${copy.toolActivity.blocked}: ${base}(${safeTarget || '.'})`
-      : done
-        ? `${copy.toolActivity.doneRead}: ${safeTarget || '.'}`
-        : `${copy.toolActivity.doingRead}: ${safeTarget || '.'}`;
-  }
-  if (base === 'edit') {
-    return blocked
-      ? `${copy.toolActivity.blocked}: ${base}(${safeTarget || '.'})`
-      : done
-        ? `${copy.toolActivity.doneEdit}: ${safeTarget || '.'}`
-        : `${copy.toolActivity.doingEdit}: ${safeTarget || '.'}`;
-  }
-  if (base === 'write') {
-    return blocked
-      ? `${copy.toolActivity.blocked}: ${base}(${safeTarget || '.'})`
-      : done
-        ? `${copy.toolActivity.doneWrite}: ${safeTarget || '.'}`
-        : `${copy.toolActivity.doingWrite}: ${safeTarget || '.'}`;
-  }
-  if (base === 'patch') {
-    return blocked
-      ? `${copy.toolActivity.blocked}: ${base}(${safeTarget || '.'})`
-      : done
-        ? `${copy.toolActivity.donePatch}: ${safeTarget || '.'}`
-        : `${copy.toolActivity.doingPatch}: ${safeTarget || '.'}`;
-  }
-  if (base === 'list' || base === 'glob' || base === 'grep') {
-    return blocked
-      ? `${copy.toolActivity.blocked}: ${base}(${safeTarget || '.'})`
-      : done
-        ? `${copy.toolActivity.doneList}: ${safeTarget || '.'}`
-        : `${copy.toolActivity.doingList}: ${safeTarget || '.'}`;
-  }
-  if (base === 'run') {
-    return blocked
-      ? `${copy.toolActivity.blocked}: ${safeTarget || base}`
-      : done
-        ? `${copy.toolActivity.doneCommand}: ${safeTarget || base}`
-        : `${copy.toolActivity.doingCommand}: ${safeTarget || base}`;
-  }
-  if (base === 'start_service' || base === 'list_services' || base === 'get_service_status' || base === 'get_service_logs' || base === 'stop_service') {
-    return blocked
-      ? `${copy.toolActivity.blocked}: ${safeTarget || base}`
-      : done
-        ? `${copy.toolActivity.doneGeneric}: ${safeTarget || base}`
-        : `${copy.toolActivity.doingGeneric}: ${safeTarget || base}`;
-  }
-  if (base === 'create_task') {
-    return blocked ? `${copy.toolActivity.blocked}: create_task` : done ? copy.toolActivity.doneCreateTask : copy.toolActivity.doingCreateTask;
-  }
-  if (base === 'update_task') {
-    return blocked ? `${copy.toolActivity.blocked}: update_task` : done ? copy.toolActivity.doneUpdateTask : copy.toolActivity.doingUpdateTask;
-  }
-  return blocked ? `${copy.toolActivity.blocked}: ${raw}` : done ? `${copy.toolActivity.doneGeneric}: ${raw}` : `${copy.toolActivity.doingGeneric}: ${raw}`;
+  return describeRegisteredToolActivity(copy, name, { done, blocked });
 }
 
 function describeSkillActivity(name, copy, { done = false, failed = false } = {}) {
-  if (failed) return `${copy.runtime.skillFailed}: /${name}`;
-  if (done) return `${copy.toolActivity.doneSkill}: /${name}`;
-  return `${copy.toolActivity.doingSkill}: /${name}`;
+  return describeRegisteredSkillActivity(copy, name, { done, failed });
 }
 
 function describeAutoSkillActivity(names, copy) {
-  const safeNames = Array.isArray(names) ? names.filter(Boolean) : [];
-  if (safeNames.length === 0) return '';
-  return copy.runtime.autoSkillInjected(safeNames);
+  return describeRegisteredAutoSkillActivity(copy, names);
 }
 
 function formatAutoSkillBadge(names, copy) {
-  const safeNames = Array.isArray(names) ? names.filter(Boolean) : [];
-  if (safeNames.length === 0) return '';
-  const [first, ...rest] = safeNames;
-  const suffix = rest.length > 0 ? ` +${rest.length}` : '';
-  const prefix = copy?.roleLabels?.system === 'SYSTEM' ? 'AUTO' : '自动';
-  return `${prefix} /${first}${suffix}`;
+  return formatRegisteredAutoSkillBadge(copy, names);
 }
 
 function normalizeRuntimeStatus(status, copy) {
@@ -2967,6 +2834,26 @@ export function ChatApp({ runtime, sessionId, model, language = 'zh', shellName
     return aid;
   };
 
+  const maybeRefreshSyntheticNarration = (nextToolName) => {
+    const targetId = activeAssistantIdRef.current;
+    if (!targetId || !nextToolName) return;
+    setMessages((prev) =>
+      prev.map((m) => {
+        if (m.id !== targetId) return m;
+        if (!hasOnlySyntheticNarration(m)) return m;
+        const previousActivity = getLastToolActivity(m, ['done', 'running']);
+        if (!previousActivity) return m;
+        const bridge = buildInterToolNotice(previousActivity, nextToolName, copy);
+        if (!bridge) return m;
+        return {
+          ...m,
+          text: bridge,
+          syntheticPrelude: true
+        };
+      })
+    );
+  };
+
   const runSubmission = (line, userMessageId = null) => {
     inFlightRef.current = true;
     activeUserMessageIdRef.current = userMessageId;
@@ -3060,9 +2947,15 @@ export function ChatApp({ runtime, sessionId, model, language = 'zh', shellName
             setMessages((prev) =>
               prev.map((m) => {
                 if (m.id !== targetId) return m;
+                const responseText = typeof event.text === 'string' ? event.text.trim() : '';
+                const shouldSynthesizeCompletion = !responseText && m.syntheticPrelude;
                 return {
                   ...m,
-                  ...(typeof event.text === 'string' && event.text.length > 0 ? { text: event.text } : {}),
+                  ...(responseText
+                    ? { text: event.text, syntheticPrelude: false }
+                    : shouldSynthesizeCompletion
+                      ? { text: buildSyntheticCompletionText(m, copy), syntheticPrelude: false }
+                      : {}),
                   loading: false,
                   phase: undefined,
                   liveStatus: undefined,
@@ -3086,6 +2979,7 @@ export function ChatApp({ runtime, sessionId, model, language = 'zh', shellName
         }
         if (event?.type === 'tool:start') {
           ensureActiveAssistant();
+          maybeRefreshSyntheticNarration(event.name);
           const detail = describeToolActivity(event.name, copy);
           setRuntimeStatus(makeStatus(copy.runtime.toolRunning, detail, 'magentaBright'));
           setInputStage('tooling');

package/src/tui/skill-activity/index.js

@@ -0,0 +1,20 @@
+export function describeSkillActivity(copy, name, { done = false, failed = false } = {}) {
+  if (failed) return `${copy.runtime.skillFailed}: /${name}`;
+  if (done) return `${copy.toolActivity.doneSkill}: /${name}`;
+  return `${copy.toolActivity.doingSkill}: /${name}`;
+}
+
+export function describeAutoSkillActivity(copy, names) {
+  const safeNames = Array.isArray(names) ? names.filter(Boolean) : [];
+  if (safeNames.length === 0) return '';
+  return copy.runtime.autoSkillInjected(safeNames);
+}
+
+export function formatAutoSkillBadge(copy, names) {
+  const safeNames = Array.isArray(names) ? names.filter(Boolean) : [];
+  if (safeNames.length === 0) return '';
+  const [first, ...rest] = safeNames;
+  const suffix = rest.length > 0 ? ` +${rest.length}` : '';
+  const prefix = copy?.roleLabels?.system === 'SYSTEM' ? 'AUTO' : '自动';
+  return `${prefix} /${first}${suffix}`;
+}

package/src/tui/tool-activity/common.js

@@ -0,0 +1,29 @@
+import { classifyCommandIntent } from '../../core/shell.js';
+
+export function parseToolDisplayName(name) {
+  const raw = String(name || '').trim();
+  const match = raw.match(/^([^(]+)\((.*)\)$/);
+  return {
+    raw,
+    base: match ? match[1] : raw,
+    target: match ? match[2] : ''
+  };
+}
+
+export function trimText(text, max = 72) {
+  const value = String(text || '').trim();
+  if (!value) return '';
+  return value.length > max ? `${value.slice(0, Math.max(0, max - 3)).trimEnd()}...` : value;
+}
+
+export function makeBlocked(copy, target) {
+  return `${copy.toolActivity.blocked}: ${target}`;
+}
+
+export function makePhase(copy, doneLabel, doingLabel, target) {
+  return target ? `${doneLabel}: ${target}` : doneLabel || doingLabel;
+}
+
+export function classifyRunIntent(target) {
+  return classifyCommandIntent(target);
+}

package/src/tui/tool-activity/index.js

@@ -0,0 +1,17 @@
+import { parseToolDisplayName } from './common.js';
+import { describeCommandToolActivity } from './presenters/command.js';
+import { describeFileToolActivity } from './presenters/files.js';
+import { describeMiscToolActivity } from './presenters/misc.js';
+import { describeSystemToolActivity } from './presenters/system.js';
+
+export { isCodeGenerationActivityName } from './presenters/misc.js';
+
+export function describeToolActivity(copy, name, options = {}) {
+  const parsed = parseToolDisplayName(name);
+  return (
+    describeSystemToolActivity(copy, parsed, options) ||
+    describeCommandToolActivity(copy, parsed, options) ||
+    describeFileToolActivity(copy, parsed, options) ||
+    describeMiscToolActivity(copy, parsed, name, options)
+  );
+}

package/src/tui/tool-activity/presenters/command.js

@@ -0,0 +1,29 @@
+import { classifyRunIntent, makeBlocked, trimText } from '../common.js';
+
+function phaseText(copy, blocked, done, target, doingLabel, doneLabel) {
+  if (blocked) return makeBlocked(copy, target);
+  return done ? `${doneLabel}: ${target}` : `${doingLabel}: ${target}`;
+}
+
+export function describeCommandToolActivity(copy, parsed, { done = false, blocked = false } = {}) {
+  const target = parsed.target || 'command';
+  const intent = classifyRunIntent(parsed.target);
+
+  if (parsed.base === 'run' || parsed.base === 'start_service') {
+    if (intent.kind === 'install') return phaseText(copy, blocked, done, target, copy.toolActivity.doingInstall, copy.toolActivity.doneInstall);
+    if (intent.kind === 'build') return phaseText(copy, blocked, done, target, copy.toolActivity.doingBuild, copy.toolActivity.doneBuild);
+    if (intent.kind === 'test') return phaseText(copy, blocked, done, target, copy.toolActivity.doingTest, copy.toolActivity.doneTest);
+    if (intent.kind === 'frontend-service') return phaseText(copy, blocked, done, target, copy.toolActivity.doingFrontend, copy.toolActivity.doneFrontend);
+    if (intent.kind === 'backend-service') return phaseText(copy, blocked, done, target, copy.toolActivity.doingBackend, copy.toolActivity.doneBackend);
+    if (intent.kind === 'database-service') return phaseText(copy, blocked, done, target, copy.toolActivity.doingDatabase, copy.toolActivity.doneDatabase);
+    if (intent.kind === 'docker-service') return phaseText(copy, blocked, done, target, copy.toolActivity.doingDocker, copy.toolActivity.doneDocker);
+    if (intent.kind === 'service') return phaseText(copy, blocked, done, target, copy.toolActivity.doingGeneric, copy.toolActivity.doneGeneric);
+    if (parsed.base === 'run') return phaseText(copy, blocked, done, trimText(target, 72) || parsed.base, copy.toolActivity.doingCommand, copy.toolActivity.doneCommand);
+  }
+
+  if (parsed.base === 'start_service' || parsed.base === 'list_services' || parsed.base === 'get_service_status' || parsed.base === 'get_service_logs' || parsed.base === 'stop_service') {
+    return phaseText(copy, blocked, done, trimText(parsed.target, 72) || parsed.base, copy.toolActivity.doingGeneric, copy.toolActivity.doneGeneric);
+  }
+
+  return '';
+}

package/src/tui/tool-activity/presenters/files.js

@@ -0,0 +1,26 @@
+import { makeBlocked, trimText } from '../common.js';
+
+function describePathTool(copy, parsed, labels, { done = false, blocked = false } = {}) {
+  const safeTarget = trimText(parsed.target, 72) || '.';
+  if (blocked) return makeBlocked(copy, `${parsed.base}(${safeTarget})`);
+  return done ? `${labels.done}: ${safeTarget}` : `${labels.doing}: ${safeTarget}`;
+}
+
+export function describeFileToolActivity(copy, parsed, options = {}) {
+  if (parsed.base === 'read') {
+    return describePathTool(copy, parsed, { done: copy.toolActivity.doneRead, doing: copy.toolActivity.doingRead }, options);
+  }
+  if (parsed.base === 'edit') {
+    return describePathTool(copy, parsed, { done: copy.toolActivity.doneEdit, doing: copy.toolActivity.doingEdit }, options);
+  }
+  if (parsed.base === 'write') {
+    return describePathTool(copy, parsed, { done: copy.toolActivity.doneWrite, doing: copy.toolActivity.doingWrite }, options);
+  }
+  if (parsed.base === 'patch') {
+    return describePathTool(copy, parsed, { done: copy.toolActivity.donePatch, doing: copy.toolActivity.doingPatch }, options);
+  }
+  if (parsed.base === 'list' || parsed.base === 'glob' || parsed.base === 'grep') {
+    return describePathTool(copy, parsed, { done: copy.toolActivity.doneList, doing: copy.toolActivity.doingList }, options);
+  }
+  return '';
+}

package/src/tui/tool-activity/presenters/misc.js

@@ -0,0 +1,19 @@
+import { makeBlocked } from '../common.js';
+
+export function isCodeGenerationActivityName(name) {
+  return String(name || '').trim() === 'Code generation';
+}
+
+export function describeMiscToolActivity(copy, parsed, rawName, { done = false, blocked = false } = {}) {
+  if (isCodeGenerationActivityName(rawName)) {
+    if (blocked) return `${copy.toolActivity.blocked}: code generation`;
+    return done ? copy.toolActivity.doneCodeGeneration : copy.toolActivity.doingCodeGeneration;
+  }
+  if (parsed.base === 'create_task') {
+    return blocked ? makeBlocked(copy, 'create_task') : done ? copy.toolActivity.doneCreateTask : copy.toolActivity.doingCreateTask;
+  }
+  if (parsed.base === 'update_task') {
+    return blocked ? makeBlocked(copy, 'update_task') : done ? copy.toolActivity.doneUpdateTask : copy.toolActivity.doingUpdateTask;
+  }
+  return blocked ? `${copy.toolActivity.blocked}: ${parsed.raw}` : done ? `${copy.toolActivity.doneGeneric}: ${parsed.raw}` : `${copy.toolActivity.doingGeneric}: ${parsed.raw}`;
+}

package/src/tui/tool-activity/presenters/system.js

@@ -0,0 +1,14 @@
+import { makeBlocked, trimText } from '../common.js';
+
+export function describeSystemToolActivity(copy, parsed, { done = false, blocked = false } = {}) {
+  if (parsed.base === 'project_index') {
+    if (blocked) return `${copy.toolActivity.blocked}: project index`;
+    return done ? copy.toolActivity.doneProjectIndex : copy.toolActivity.doingProjectIndex;
+  }
+  if (parsed.base === 'file_index') {
+    const safeTarget = trimText(parsed.target || '.codemini-project/file-index.json', 72);
+    if (blocked) return makeBlocked(copy, safeTarget);
+    return done ? `${copy.toolActivity.doneFileIndex}: ${safeTarget}` : `${copy.toolActivity.doingFileIndex}: ${safeTarget}`;
+  }
+  return '';
+}

package/src/tui/tool-narration/common.js

@@ -0,0 +1,37 @@
+export function trimText(text, max = 48) {
+  const value = String(text || '').trim();
+  if (!value) return '';
+  return value.length > max ? `${value.slice(0, Math.max(0, max - 3)).trimEnd()}...` : value;
+}
+
+export function parseToolDisplayName(name) {
+  const raw = String(name || '').trim();
+  const match = raw.match(/^([^(]+)\((.*)\)$/);
+  return {
+    raw,
+    base: match ? match[1] : raw,
+    target: match ? match[2] : ''
+  };
+}
+
+export function isEnglishCopy(copy) {
+  return String(copy?.roleLabels?.coder || '').trim() === 'CODER' && String(copy?.roleLabels?.you || '').trim() === 'YOU';
+}
+
+export function renderLocalizedEntry(entry, copy, context) {
+  if (!entry) return '';
+  const locale = isEnglishCopy(copy) ? 'en' : 'zh';
+  const renderer = entry[locale];
+  return typeof renderer === 'function' ? renderer(context) : '';
+}
+
+export function getLastToolActivity(msg, statuses = []) {
+  const allowed = new Set((Array.isArray(statuses) ? statuses : []).map((status) => String(status)));
+  const segments = Array.isArray(msg?.segments) ? msg.segments : [];
+  for (let idx = segments.length - 1; idx >= 0; idx -= 1) {
+    const segment = segments[idx];
+    if (segment?.type !== 'tool' && segment?.type !== 'system_tool') continue;
+    if (allowed.size === 0 || allowed.has(String(segment.status || ''))) return segment;
+  }
+  return null;
+}