@miphamai/cli 0.56.0 → 0.57.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miphamai/cli",
-  "version": "0.56.0",
+  "version": "0.57.0",
   "description": "Mipham Code — Multi-model open-core intelligent coding terminal by MiphamAI",
   "keywords": [
     "ai",

package/src/commands/project.ts

@@ -115,17 +115,20 @@ Mode:       ${ctx.config.permission}
 Messages:   ${msgs.length} in context
 Tools:      ${ctx.engine.getTools().size} available
 
-Permission levels:
-  auto    — run tools automatically without asking
-  ask     — prompt before each tool execution (default)
-  bypass  — skip all permission checks (use with caution)
+Switch mode with Shift+Tab. Modes (least → most permissive):
+  default            — per-tool defaults (Bash/Write/Edit ask first)
+  acceptEdits        — reads + edits free; Bash auto-runs read/check commands
+  plan               — reads only (Read/Grep/Glob); nothing writes or runs
+  auto               — run everything without asking (hooks are the safety gate)
+  dontAsk            — only allowlisted tools free; everything else asks
+  bypassPermissions  — skip ALL permission checks (⚠️ use with caution)
 
-Change with /config permission <level>.
+To let Bash run without asking: press Shift+Tab until the status line shows
+"acceptEdits" (or "auto"), then send your message again.
 
 Current directory permissions:
   CWD:      ${process.cwd()}
 
-To add a directory: use /add-dir (coming soon).
 Tool execution is sandboxed to the project directory by default.`,
   }
 }

package/src/core/engine.ts

@@ -764,7 +764,9 @@ export class QueryEngine {
   }
 
   private async *continueWithTools(signal?: AbortSignal): AsyncGenerator<StreamChunk> {
-    const MAX_TURNS = 20
+    // Tool-calling round cap. 20 was too low for real multi-step tasks — the model
+    // hit "max turns" and dropped pending tools mid-task. 100 stays bounded.
+    const MAX_TURNS = 100
     const toolDefs = this.getToolDefinitions()
 
     for (let turn = 0; turn < MAX_TURNS; turn++) {

package/src/i18n-core/locales/en-US.json

@@ -804,8 +804,7 @@
     "assistant": { "role_label": "Mipham Code" },
     "user": { "role_label": "User" },
     "input": {
-      "placeholder": "Type a message (Esc to cancel)...",
-      "vim_help": "[NORMAL] h/j/k/l w/b 0/$ dd yy p u / (Esc to insert)"
+      "placeholder": "Type a message (Esc to clear)..."
     },
     "slash_hints": {
       "label": "Commands:",
@@ -942,7 +941,7 @@
     "mcp": { "name": "MCP", "description": "Manage MCP server connections" }
   },
   "errors": {
-    "tool_not_allowed": "Tool \"{name}\" requires user approval (permission: ask). The tool was not executed.",
+    "tool_not_allowed": "Tool \"{name}\" requires user approval (permission: ask). The tool was not executed. Press Shift+Tab to switch permission mode, or run /permissions.",
     "tool_blocked": "Tool \"{name}\" blocked by hook",
     "user_input_blocked": "User input blocked by hook.",
     "dlp_blocked": "Request blocked by DLP policy.",

package/src/i18n-core/locales/zh-CN.json

@@ -804,8 +804,7 @@
     "assistant": { "role_label": "Mipham Code" },
     "user": { "role_label": "用户" },
     "input": {
-      "placeholder": "输入消息（Esc 取消）...",
-      "vim_help": "[NORMAL] h/j/k/l w/b 0/$ dd yy p u /（Esc 插入）"
+      "placeholder": "输入消息（Esc 清空）..."
     },
     "slash_hints": {
       "label": "命令：",
@@ -942,7 +941,7 @@
     "mcp": { "name": "MCP", "description": "管理 MCP 服务器连接" }
   },
   "errors": {
-    "tool_not_allowed": "工具 \"{name}\" 需要用户批准（权限：ask），未执行。",
+    "tool_not_allowed": "工具 \"{name}\" 需要用户批准（权限：ask），未执行。按 Shift+Tab 切换权限模式，或运行 /permissions。",
     "tool_blocked": "工具 \"{name}\" 被钩子拦截",
     "user_input_blocked": "用户输入被钩子拦截。",
     "dlp_blocked": "请求被 DLP 策略阻止。",

package/src/security/gate.ts

@@ -28,8 +28,9 @@ const PROMPT_INJECTION_PATTERNS: Array<{ regex: RegExp; label: string }> = [
 ]
 
 const DANGEROUS_BASH_PATTERNS: Array<{ regex: RegExp; label: string }> = [
-  { regex: /\$\(.+\)/, label: 'command-substitution' },
-  { regex: /`[^`]+`/, label: 'backtick-substitution' },
+  // NOTE: command substitution ($( … ) / `…`) is legitimate Bash syntax and is NOT
+  // blocked here — its dangerous content (a pipe to sh/bash, a chained rm/cat/sh,
+  // …) is still caught by the pipe/chain patterns below.
   { regex: /;\s*(rm|cat|sh|bash)\b/, label: 'command-chain-injection' },
   { regex: /curl.+\|\s*(sh|bash)\b/, label: 'curl-pipe-shell' },
   { regex: /\|\s*(sh|bash)\b/, label: 'pipe-to-shell' },

package/src/shared/graft-stats.ts

@@ -1,5 +1,5 @@
 import { readFileSync, existsSync } from 'node:fs'
-import { join } from 'node:path'
+import { join, resolve, dirname } from 'node:path'
 
 /** Graft's hook-maintained stats cache (`graft/.cache/stats.json`). */
 export interface GraftStats {
@@ -34,3 +34,20 @@ export function readGraftStats(cwd: string): GraftStats | null {
     return null
   }
 }
+
+/**
+ * Find the nearest graft graph by walking up from `cwd` to the filesystem root.
+ * Graft builds its cache at the repo root (`graft/.cache/stats.json`), so this
+ * also resolves when `cwd` is a subdirectory of a graft-indexed repo — not only
+ * the repo root itself.
+ */
+export function findGraftStats(cwd: string): GraftStats | null {
+  let dir = resolve(cwd)
+  for (;;) {
+    const stats = readGraftStats(dir)
+    if (stats) return stats
+    const parent = dirname(dir)
+    if (parent === dir) return null
+    dir = parent
+  }
+}

package/src/shared/package-info.ts

@@ -9,7 +9,7 @@
 export const PACKAGE_NAME = '@miphamai/cli' as const
 
 /** 当前发布版本 */
-export const PACKAGE_VERSION = '0.56.0' as const
+export const PACKAGE_VERSION = '0.57.0' as const
 
 /** npm install 全局安装命令 */
 export const NPM_INSTALL_COMMAND = `npm install -g ${PACKAGE_NAME}` as const

package/src/tools/exec/bash.ts

@@ -29,10 +29,10 @@ const BLOCKED_PATTERNS = [
   />\s*\/dev\/sd[a-z]/,
   // SSH private key theft
   /\bcat\s+.*\/\.ssh\/id_/,
-  // Shell command substitution (commonly used for obfuscation/evasion)
-  /\$\(/,
-  // Backtick command substitution
-  /`[^`]+`/,
+  // NOTE: command substitution ($( … ) / `…`) is a legitimate Bash feature, so it is
+  // NOT blocked wholesale. The dangerous content inside a substitution (curl|sh,
+  // base64 -d, python -c, eval, bash -c, source, …) is still caught by the specific
+  // patterns below, which test the whole command string including inside $().
   // Interpreter code execution (bypass vector) — covers python, python2, python3
   /\bpython[23]?\s+-c\b/,
   /\bpython[23]?\s+-m\b/,

package/src/ui/app.tsx

@@ -791,7 +791,6 @@ export function App({
 
   useInput((_input, key) => {
     // Escape: close apiKeyPrompt → close picker → abort loading (does NOT exit app)
-    // Vim mode toggle is handled by InputBar
     if (key.escape) {
       if (apiKeyPrompt) {
         setApiKeyPrompt(null)
@@ -806,8 +805,7 @@ export function App({
         abortRef.current.abort()
         return
       }
-      // When input is empty and not loading, let InputBar handle Escape
-      // (it toggles vim mode or clears pending sequences)
+      // Otherwise let InputBar handle Escape (clear draft)
       return
     }
     // All other global hotkeys (Shift+Tab, Ctrl+P, Ctrl+F, Ctrl+O)

package/src/ui/graft-status.tsx

@@ -1,7 +1,7 @@
 import React, { useState } from 'react'
 import { Box, Text } from 'ink'
 import { basename } from 'node:path'
-import { readGraftStats, type GraftStats } from '../shared/graft-stats'
+import { findGraftStats, type GraftStats } from '../shared/graft-stats'
 import { getGraftSavings } from '../shared/graft-savings'
 
 /** Freshness segment mirroring graft's own statusline (see @nanonets/graft format.js). */
@@ -17,16 +17,18 @@ function freshnessSegment(stats: GraftStats): { label: string; color: string } {
  * Bottom-of-screen graft status line — mirrors graft's own "◤ graft · …" bar:
  *   ◤ graft · N nodes / E edges · ✓ synced · ~T tok saved
  *   ▸ ctx X% · last: file
- * Reads `graft/.cache/stats.json` once at mount; the session's tok-saved total
- * is read live each render (the app re-renders on the agent tick). Returns
- * null (renders nothing) when graft isn't built here.
+ * Reads `graft/.cache/stats.json` (walking up to the repo root) once at mount;
+ * the session's tok-saved total is read live each render (the app re-renders on
+ * the agent tick). Renders nothing only when there's no graft graph AND no known
+ * ctx% — the ctx% line shows even when graft isn't built in this directory.
  */
 export function GraftStatusLine({ cwd, ctxPct }: { cwd: string; ctxPct?: number }) {
-  const [stats] = useState(() => readGraftStats(cwd))
-  if (!stats) return null
-  const fresh = freshnessSegment(stats)
+  const [stats] = useState(() => findGraftStats(cwd))
+  const showCtx = typeof ctxPct === 'number'
+  if (!stats && !showCtx) return null
+  const fresh = stats ? freshnessSegment(stats) : null
   const saved = getGraftSavings()
-  const lastFile = stats.lastFile ? basename(stats.lastFile) : null
+  const lastFile = stats?.lastFile ? basename(stats.lastFile) : null
 
   const bottom: string[] = []
   if (typeof ctxPct === 'number') bottom.push(`ctx ${ctxPct}%`)
@@ -34,21 +36,23 @@ export function GraftStatusLine({ cwd, ctxPct }: { cwd: string; ctxPct?: number
 
   return (
     <Box flexDirection="column">
-      <Box>
-        <Text dimColor>◤ </Text>
-        <Text color="blue">graft</Text>
-        <Text dimColor>
-          {' '}
-          · {stats.nodeCount} nodes / {stats.edgeCount} edges ·{' '}
-        </Text>
-        <Text color={fresh.color}>{fresh.label}</Text>
-        {saved > 0 && (
-          <>
-            <Text dimColor> · </Text>
-            <Text color="blue">~{saved.toLocaleString()} tok saved</Text>
-          </>
-        )}
-      </Box>
+      {stats && fresh && (
+        <Box>
+          <Text dimColor>◤ </Text>
+          <Text color="blue">graft</Text>
+          <Text dimColor>
+            {' '}
+            · {stats.nodeCount} nodes / {stats.edgeCount} edges ·{' '}
+          </Text>
+          <Text color={fresh.color}>{fresh.label}</Text>
+          {saved > 0 && (
+            <>
+              <Text dimColor> · </Text>
+              <Text color="blue">~{saved.toLocaleString()} tok saved</Text>
+            </>
+          )}
+        </Box>
+      )}
       {bottom.length > 0 && (
         <Box>
           <Text dimColor>▸ {bottom.join(' · ')}</Text>

package/src/ui/input.tsx

@@ -1,7 +1,6 @@
 import React, { useState, useEffect, useRef, useMemo } from 'react'
 import { Box, Text, useInput } from 'ink'
 import TextInput from 'ink-text-input'
-import { VimMotionEngine, handleSearchBackspace, type VimMode } from './vim-motions.js'
 import { getCommandList } from './commands.js'
 import { CommandPicker } from './command-picker.js'
 import { useI18n } from '../i18n-context'
@@ -20,7 +19,7 @@ interface InputBarProps {
   onToggleAgentView?: () => void
   /** Shift+Tab → cycle permission mode */
   onCyclePermission?: () => void
-  /** Escape → cancel loading (when input is empty) */
+  /** Escape → cancel loading / clear draft */
   onCancel?: () => void
 }
 
@@ -145,15 +144,6 @@ export function InputBar({
     prevLoading.current = isLoading
   }, [isLoading])
 
-  const [vimMode, setVimMode] = useState<VimMode>('insert')
-  // NOTE: Dual mode state — React state (vimMode) drives UI re-renders (prompt color,
-  // placeholder); engine mode (vimEngine.current.mode) drives logic inside useInput so
-  // the handler always reads the authoritative mode without stale-closure risk.
-  const vimEngine = useRef(new VimMotionEngine())
-  const vimPending = useRef<string | null>(null)
-  const [searchMode, setSearchMode] = useState(false)
-  const [searchQuery, setSearchQuery] = useState('')
-
   // Track pre-shortcut value so we can revert ink-text-input's Ctrl-key insertions.
   // ink-text-input inserts 'p'/'f'/'o' for Ctrl+P/F/O (Ink normalizes control chars
   // to their letter names before passing to useInput).
@@ -163,32 +153,21 @@ export function InputBar({
     valueBeforeShortcut.current = value
   }, [value])
 
-  // ── Vim motions: intercept keys in normal mode ──
-
   useInput((input, key) => {
-    // ── Escape: cancel loading → toggle vim mode ──
+    // ── Escape: cancel loading → clear draft ──
     if (key.escape) {
-      // Cancel search mode if active
-      if (searchMode) {
-        setSearchMode(false)
-        setSearchQuery('')
-        return
-      }
-      // Escape while loading → abort (priority over vim toggle)
+      // Escape while loading → abort
       if (isLoading) {
         onCancel?.()
         return
       }
-      // Clear any pending multi-key sequence
-      if (vimPending.current) {
-        vimPending.current = null
-      }
-      setVimMode((prev) => (prev === 'insert' ? 'normal' : 'insert'))
-      vimEngine.current.mode = vimEngine.current.mode === 'insert' ? 'normal' : 'insert'
+      // Idle → clear the draft (the intuitive "cancel")
+      setValue('')
+      valueRef.current = ''
       return
     }
 
-    // ── Global hotkeys (work in both insert and normal modes) ──
+    // ── Global hotkeys ──
     // Shift+Tab → cycle permission mode
     if (key.shift && key.tab) {
       onCyclePermission?.()
@@ -221,121 +200,43 @@ export function InputBar({
       return
     }
 
-    // ── Arrow-key history navigation (insert mode only, Claude Code parity) ──
-    if (vimEngine.current.mode === 'insert' && !searchMode) {
-      if (key.upArrow || key.downArrow) {
-        // Ignore if picker is active (command picker handles its own arrows)
-        if (value.startsWith('/')) return
-
-        if (key.upArrow) {
-          if (submittedHistory.length === 0) return
-          // Save current draft the first time we enter history browsing
-          if (historyIndexRef.current === -1) {
-            // Flush any pending throttle so its deferred setValue doesn't overwrite
-            // history navigation (paste → immediate ↑ race). Save the latest value
-            // from the ref — state `value` is stale inside the throttle window.
-            if (onChangeTimerRef.current) {
-              clearTimeout(onChangeTimerRef.current)
-              onChangeTimerRef.current = null
-            }
-            savedDraftRef.current = valueRef.current
-          }
-          const newIndex = Math.min(historyIndexRef.current + 1, submittedHistory.length - 1)
-          historyIndexRef.current = newIndex
-          setValue(submittedHistory[submittedHistory.length - 1 - newIndex]!)
-          return
-        }
-        if (key.downArrow) {
-          if (historyIndexRef.current === -1) return
-          const newIndex = historyIndexRef.current - 1
-          historyIndexRef.current = newIndex
-          if (newIndex === -1) {
-            // Back to the original draft
-            setValue(savedDraftRef.current)
-            savedDraftRef.current = ''
-          } else {
-            setValue(submittedHistory[submittedHistory.length - 1 - newIndex]!)
+    // ── Arrow-key history navigation (Claude Code parity) ──
+    if (key.upArrow || key.downArrow) {
+      // Ignore if picker is active (command picker handles its own arrows)
+      if (value.startsWith('/')) return
+
+      if (key.upArrow) {
+        if (submittedHistory.length === 0) return
+        // Save current draft the first time we enter history browsing
+        if (historyIndexRef.current === -1) {
+          // Flush any pending throttle so its deferred setValue doesn't overwrite
+          // history navigation (paste → immediate ↑ race). Save the latest value
+          // from the ref — state `value` is stale inside the throttle window.
+          if (onChangeTimerRef.current) {
+            clearTimeout(onChangeTimerRef.current)
+            onChangeTimerRef.current = null
           }
-          return
+          savedDraftRef.current = valueRef.current
         }
-      }
-    }
-
-    if (vimEngine.current.mode !== 'normal') return
-
-    // Handle search mode — collect query characters
-    if (searchMode) {
-      if (key.return) {
-        const action = vimEngine.current.handleSearch(value, searchQuery)
-        if (action.text !== undefined) setValue(action.text)
-        // NOTE: action.cursor is not settable on ink-text-input — user repositions manually
-        setSearchMode(false)
-        setSearchQuery('')
+        const newIndex = Math.min(historyIndexRef.current + 1, submittedHistory.length - 1)
+        historyIndexRef.current = newIndex
+        setValue(submittedHistory[submittedHistory.length - 1 - newIndex]!)
         return
       }
-      if (key.backspace || key.delete) {
-        const next = handleSearchBackspace(searchQuery)
-        setSearchQuery(next.query)
-        if (next.exit) setSearchMode(false)
+      if (key.downArrow) {
+        if (historyIndexRef.current === -1) return
+        const newIndex = historyIndexRef.current - 1
+        historyIndexRef.current = newIndex
+        if (newIndex === -1) {
+          // Back to the original draft
+          setValue(savedDraftRef.current)
+          savedDraftRef.current = ''
+        } else {
+          setValue(submittedHistory[submittedHistory.length - 1 - newIndex]!)
+        }
         return
       }
-      // Accumulate printable characters
-      if (input && input.length === 1 && !key.escape && !key.return) {
-        setSearchQuery((q) => q + input)
-      }
-      return
     }
-
-    // Handle pending two-key sequences (dd, yy)
-    if (vimPending.current !== null) {
-      if (vimPending.current === 'd' && input === 'd') {
-        const action = vimEngine.current.handleDD(value)
-        setValue(action.text ?? value)
-      } else if (vimPending.current === 'y' && input === 'y') {
-        vimEngine.current.handleYY(value)
-      }
-      // Always clear pending — even when second key doesn't match
-      vimPending.current = null
-      return
-    }
-
-    // Handle p (paste) — pastes clipboard at cursor position
-    if (input === 'p') {
-      const action = vimEngine.current.handlePaste(value, value.length)
-      if (action.text !== undefined) setValue(action.text)
-      return
-    }
-
-    // Handle u (undo)
-    if (input === 'u') {
-      const action = vimEngine.current.handleUndo(value)
-      if (action.text !== undefined) setValue(action.text)
-      return
-    }
-
-    // Handle / (enter search mode)
-    if (input === '/') {
-      setSearchMode(true)
-      setSearchQuery('')
-      return
-    }
-
-    // Handle single-key motions (h, j, k, l, w, b, 0, $, d, y)
-    const action = vimEngine.current.handleNormal(input, value, value.length)
-    if (!action) return
-
-    if (action.pending) {
-      vimPending.current = action.pending
-      return
-    }
-
-    if (action.text !== undefined) {
-      setValue(action.text)
-    }
-
-    // NOTE: action.cursor is returned by motions (h/j/k/l/w/b/0/$) but
-    // ink-text-input does not expose a programmatic cursor-position API.
-    // The cursor hint is informational only; the user repositions manually.
   })
 
   // ── Command picker state ──
@@ -344,7 +245,7 @@ export function InputBar({
 
   // Auto-activate picker when user types "/"
   useEffect(() => {
-    if (value.startsWith('/') && !prevValueRef.current.startsWith('/') && vimMode === 'insert') {
+    if (value.startsWith('/') && !prevValueRef.current.startsWith('/')) {
       setPickerActive(true)
     }
     // Dismiss picker when user clears the / prefix
@@ -352,7 +253,7 @@ export function InputBar({
       setPickerActive(false)
     }
     prevValueRef.current = value
-  }, [value, vimMode])
+  }, [value])
 
   // Keep valueRef in sync with state (so useInput handlers read latest value)
   useEffect(() => {
@@ -379,7 +280,7 @@ export function InputBar({
   }
 
   // ── Picker mode: CommandPicker overlay ──
-  if (pickerActive && vimMode === 'insert') {
+  if (pickerActive) {
     return (
       <Box flexDirection="column" marginTop={1}>
         <CommandPicker
@@ -403,15 +304,11 @@ export function InputBar({
     <Box flexDirection="column" marginTop={1}>
       <Box>
         <Box marginRight={1}>
-          <Text color={vimMode === 'normal' ? 'magenta' : isLoading ? 'yellow' : 'cyan'}>
-            {vimMode === 'normal' ? ':' : '>'}
-          </Text>
+          <Text color={isLoading ? 'yellow' : 'cyan'}>{'>'}</Text>
         </Box>
         <TextInput
           value={value}
           onChange={(val) => {
-            // Block text changes during search mode — keys go to search query
-            if (searchMode) return
             // Reset history browsing when user starts typing
             if (historyIndexRef.current !== -1) {
               historyIndexRef.current = -1
@@ -434,20 +331,12 @@ export function InputBar({
           }}
           onSubmit={handleSubmit}
           placeholder={
-            searchMode
-              ? `/${searchQuery}`
-              : vimMode === 'normal'
-                ? t('ui.input.vim_help')
-                : isLoading
-                  ? `${verb}...`
-                  : completionVerb
-                    ? completionVerb
-                    : t('ui.input.placeholder')
+            isLoading ? `${verb}...` : completionVerb ? completionVerb : t('ui.input.placeholder')
           }
         />
       </Box>
-      {/* Slash command hints — shown when typing / in INSERT mode (only when picker is NOT active) */}
-      {slashHints.length > 0 && vimMode === 'insert' && !pickerActive && (
+      {/* Slash command hints — shown when typing / (only when picker is NOT active) */}
+      {slashHints.length > 0 && !pickerActive && (
         <Box marginTop={1} flexDirection="column" gap={1}>
           <Text dimColor>{t('ui.slash_hints.label')} </Text>
           {slashHints.map((cmd, _i) => (
@@ -468,7 +357,7 @@ export function InputBar({
         </Box>
       )}
       {/* @mention hints — active sessions (cross-session messaging) */}
-      {mentionHints.length > 0 && vimMode === 'insert' && !pickerActive && (
+      {mentionHints.length > 0 && !pickerActive && (
         <Box marginTop={1} flexDirection="column" gap={1}>
           <Text dimColor>{t('ui.mention_hints.label')} </Text>
           {mentionHints.map((name) => (

package/src/ui/vim-motions.ts

@@ -1,113 +0,0 @@
-export type VimMode = 'insert' | 'normal'
-
-export class VimMotionEngine {
-  mode: VimMode = 'insert'
-  private clipboard = ''
-  private undoStack: string[] = []
-
-  /** Handle a keypress in normal mode. Returns new cursor position delta and any text mutation. */
-  handleNormal(key: string, text: string, cursor: number): VimAction | null {
-    switch (key) {
-      case 'h':
-        return { cursor: cursor - 1 }
-      case 'j':
-        return { cursor: text.length } // end of line (like $)
-      case 'k':
-        return { cursor: 0 } // start of line (like 0)
-      case 'l':
-        return { cursor: cursor + 1 }
-      case '0':
-        return { cursor: 0 }
-      case '$':
-        return { cursor: text.length }
-      case 'w':
-        return { cursor: this.nextWord(text, cursor) }
-      case 'b':
-        return { cursor: this.prevWord(text, cursor) }
-      case 'd':
-        return { pending: 'd' }
-      case 'y':
-        return { pending: 'y' }
-      default:
-        return null
-    }
-  }
-
-  /** Handle dd — delete entire line */
-  handleDD(text: string): VimAction {
-    this.clipboard = text
-    this.pushUndo(text)
-    return { text: '', cursor: 0 }
-  }
-
-  /** Handle yy — yank entire line */
-  handleYY(text: string): VimAction {
-    this.clipboard = text
-    return { cursor: 0 } // no change
-  }
-
-  /** Handle p — paste after cursor */
-  handlePaste(text: string, cursor: number): VimAction {
-    const newText = text.slice(0, cursor) + this.clipboard + text.slice(cursor)
-    this.pushUndo(text)
-    return { text: newText, cursor: cursor + this.clipboard.length }
-  }
-
-  /** Handle u — undo */
-  handleUndo(text: string): VimAction {
-    const prev = this.undoStack.pop()
-    if (prev !== undefined) {
-      return { text: prev, cursor: prev.length }
-    }
-    return { cursor: text.length }
-  }
-
-  /** Handle /search */
-  handleSearch(text: string, query: string): VimAction {
-    const idx = text.indexOf(query)
-    return idx >= 0 ? { cursor: idx } : { cursor: 0 }
-  }
-
-  private nextWord(text: string, cursor: number): number {
-    // Skip word characters, then skip whitespace
-    let i = cursor
-    while (i < text.length && text[i] !== ' ') i++
-    while (i < text.length && text[i] === ' ') i++
-    return i
-  }
-
-  private prevWord(text: string, cursor: number): number {
-    let i = cursor - 1
-    while (i > 0 && text[i] === ' ') i--
-    while (i > 0 && text[i] !== ' ') i--
-    return i > 0 ? i + 1 : 0
-  }
-
-  private pushUndo(text: string): void {
-    this.undoStack.push(text)
-    if (this.undoStack.length > 50) this.undoStack.shift()
-  }
-}
-
-export interface VimAction {
-  text?: string
-  cursor?: number
-  pending?: string
-}
-
-export interface SearchBackspaceResult {
-  query: string
-  /** true → the `/` prefix should be removed by exiting search mode */
-  exit: boolean
-}
-
-/**
- * Backspace while in `/` search mode.
- * Trims the query; when the query is already empty, signals that search mode
- * should exit so the `/` placeholder disappears (the user can "delete" the
- * slash instead of being trapped).
- */
-export function handleSearchBackspace(query: string): SearchBackspaceResult {
-  if (query.length === 0) return { query: '', exit: true }
-  return { query: query.slice(0, -1), exit: false }
-}