dsh-vscode-mode 0.9.0 → 0.11.0

package/src/lsp/completionCap.ts

@@ -0,0 +1,80 @@
+/**
+ * dsh-vscode-mode host — 补全结果的前缀感知截断（纯函数，node 可测）。
+ * 背景：RPC 层按固定上限硬截断补全条目，而本仓库的 xLua 绑定桩
+ * （Assets/Scripts/EmmyLuaDefine，形如 CS_IslandSplash_Extensions_Common_ArrayExtension）
+ * 有上万个全局，字母序会把项目自身全局（ECommon / EActivity 等）挤到上限之外；
+ * 截断发生在 Monaco 前缀过滤之前，因此**之后无论输入什么都取不回**该条目。
+ * 改为按当前输入前缀分桶后截断：优先保留真实命中的条目；未超限时零行为变化。
+ * 作者 ddj 2026年09月24号
+ */
+import type { LspCompletionItem } from '../shared/lsp.js'
+
+/** 单次补全返回条目上限（RPC 载荷护栏，与 references 同口径）。 */
+export const COMPLETION_ITEM_CAP = 500
+
+/** 截断结果：items 恒不超上限；truncated 标记本轮是否发生了丢弃。 */
+export interface CappedCompletions {
+  items: LspCompletionItem[]
+  truncated: boolean
+}
+
+/**
+ * 判断 needle 是否为 haystack 的子序列（两侧均已小写）。
+ *
+ * 与 Monaco 候选列表的模糊匹配同口径，保证「分桶判为命中」的条目确实是
+ * 用户输入能筛出来的那些，避免分桶顺序与前端过滤结果互相矛盾。
+ * @author ddj 2026年09月24号
+ * @param haystack 候选文本（已小写）
+ * @param needle 输入前缀（已小写、非空）
+ * @returns 是否为子序列
+ */
+function isSubsequence(haystack: string, needle: string): boolean {
+  let matched = 0
+  for (let i = 0; i < haystack.length && matched < needle.length; i++) {
+    if (haystack[i] === needle[matched]) matched++
+  }
+  return matched === needle.length
+}
+
+/**
+ * 取补全项的匹配文本（Monaco 口径：filterText 优先，回落 label；统一小写）。
+ * @author ddj 2026年09月24号
+ * @param item 补全项
+ * @returns 小写匹配文本；无可用文本时为空串
+ */
+function textOfItem(item: LspCompletionItem): string {
+  const raw = typeof item?.filterText === 'string' && item.filterText ? item.filterText : item?.label
+  return typeof raw === 'string' ? raw.toLowerCase() : ''
+}
+
+/**
+ * 按输入前缀分桶后截断补全列表。
+ *
+ * 分桶优先级：startsWith > includes > 子序列 > 其余；桶内保持服务器原始顺序
+ * （服务器已按相关性排序，不重新打分）。无前缀或未超限时与旧行为完全一致。
+ * @author ddj 2026年09月24号
+ * @param items 服务器归一化后的补全条目
+ * @param prefix 当前输入前缀（Monaco getWordUntilPosition 的词）
+ * @param cap 条目上限（缺省 COMPLETION_ITEM_CAP；测试可注入小值）
+ * @returns 有界条目与截断标记
+ */
+export function capCompletions(
+  items: LspCompletionItem[],
+  prefix?: string,
+  cap: number = COMPLETION_ITEM_CAP,
+): CappedCompletions {
+  if (!Array.isArray(items)) return { items: [], truncated: false }
+  if (items.length <= cap) return { items, truncated: false }
+  const needle = String(prefix ?? '').toLowerCase()
+  if (!needle) return { items: items.slice(0, cap), truncated: true }
+  const buckets: LspCompletionItem[][] = [[], [], [], []]
+  for (const item of items) {
+    const text = textOfItem(item)
+    if (text.startsWith(needle)) buckets[0].push(item)
+    else if (text.includes(needle)) buckets[1].push(item)
+    else if (isSubsequence(text, needle)) buckets[2].push(item)
+    else buckets[3].push(item)
+  }
+  const ordered = buckets[0].concat(buckets[1], buckets[2], buckets[3])
+  return { items: ordered.slice(0, cap), truncated: true }
+}

package/src/lsp/manager.ts

@@ -12,11 +12,13 @@ interface Entry {
   server: LspServer
   refs: number
   failures: number
+  readyAt: number
   restartTimer: ReturnType<typeof setTimeout> | null
 }
 
 const BACKOFF_MS = [1000, 5000, 30000]
 const MAX_FAILURES = 3
+const STABLE_MS = 60000
 
 export interface LspManager {
   /** 获取（或惰性创建）某工作区+语言的服务器；refs+1。 */
@@ -51,6 +53,19 @@ export function createLspManager(logger?: (line: string) => void): LspManager {
 
   const log = (line: string): void => logger?.('[lsp-manager] ' + line)
 
+  /**
+   * 重试耗尽后保留退出根因，并让 UI 不再误报“未启动”。
+   * @author ddj 2026年09月24号
+   * @param entry 服务器条目
+   * @returns 当前可见状态
+   */
+  const statusOf = (entry: Entry): LspServerStatus => {
+    const status = entry.server.status()
+    return entry.failures >= MAX_FAILURES
+      ? { ...status, phase: 'unavailable', reason: (status.reason ?? '服务器已退出') + '（已停止自动重试）' }
+      : status
+  }
+
   /** 同步摘除注册表项并后台回收（refs 归零/工作区清理用；statusAll 立即可见归零）。 */
   const dropEntry = (entry: Entry): void => {
     if (entry.restartTimer) {
@@ -62,20 +77,22 @@ export function createLspManager(logger?: (line: string) => void): LspManager {
   }
 
   const scheduleRestart = (entry: Entry): void => {
-    if (entry.restartTimer) return
+    if (entry.restartTimer || entry.refs === 0 || entries.get(entry.key) !== entry) return
     if (entry.failures >= MAX_FAILURES) {
       log('unavailable after ' + entry.failures + ' failures: ' + entry.key)
+      manager.onStatusChange?.(statusOf(entry))
       return
     }
-    const delay = BACKOFF_MS[Math.min(entry.failures, BACKOFF_MS.length - 1)]
+    const delay = BACKOFF_MS[Math.min(Math.max(entry.failures - 1, 0), BACKOFF_MS.length - 1)]
     entry.restartTimer = setTimeout(() => {
       entry.restartTimer = null
-      if (!entries.has(entry.key)) return
+      if (entries.get(entry.key) !== entry || entry.refs === 0) return
       void (async () => {
         const ok = await entry.server.start()
-        if (!ok) entry.failures++
-        else entry.failures = 0
-        if (!ok && entries.has(entry.key)) scheduleRestart(entry)
+        if (!ok && entries.get(entry.key) === entry && !entry.restartTimer) {
+          entry.failures++
+          scheduleRestart(entry)
+        }
       })()
     }, delay)
   }
@@ -87,13 +104,28 @@ export function createLspManager(logger?: (line: string) => void): LspManager {
       if (!entry) {
         const spec = resolveSpec(languageId)
         const server = createLspServer(spec, root, languageId, log)
-        server.onStateChange = (status) => manager.onStatusChange?.(status)
-        entry = { key, server, refs: 0, failures: 0, restartTimer: null }
+        entry = { key, server, refs: 0, failures: 0, readyAt: 0, restartTimer: null }
         entries.set(key, entry)
+        server.onStateChange = (status) => {
+          const live = entries.get(key)
+          if (live?.server === server) {
+            if (status.phase === 'ready' && live.readyAt === 0) live.readyAt = Date.now()
+            if (status.phase === 'idle' && status.reason?.startsWith('服务器已退出')) {
+              if (live.readyAt && Date.now() - live.readyAt >= STABLE_MS) live.failures = 0
+              live.failures++
+              live.readyAt = 0
+              scheduleRestart(live)
+            }
+          }
+          manager.onStatusChange?.(live?.server === server ? statusOf(live) : status)
+        }
         // 惰性启动：若 spec ready 才启动，否则保持 idle（供 status 展示 reason）
         if (spec.ready) {
           void server.start().then((ok) => {
-            if (!ok && entries.has(key)) entry!.failures++
+            if (!ok && entries.get(key) === entry && server.phase === 'idle' && !entry!.restartTimer) {
+              entry!.failures++
+              scheduleRestart(entry!)
+            }
           })
         }
       }
@@ -126,7 +158,7 @@ export function createLspManager(logger?: (line: string) => void): LspManager {
     },
 
     statusAll(): LspServerStatus[] {
-      return [...entries.values()].map((entry) => entry.server.status())
+      return [...entries.values()].map(statusOf)
     },
 
     peek(root: string, languageId: string): LspServer | undefined {

package/src/lsp/rpc.ts

@@ -10,6 +10,7 @@ import { searchRoot } from '../search/ripgrep.js'
 import { sessionOf, cwdOf } from '../registry.js'
 import { resolveProviderSpec, langOfPath, configFromPlugin, mergeConfig, sanitizeLang, LSP_LANGUAGES, type LspConfig, type LspLangConfig } from './config.js'
 import { clearProviderCache, candidatesFor } from './providers.js'
+import { capCompletions } from './completionCap.js'
 import { onRuntimeProvisioned, envInstallStates } from './dotnetProvision.js'
 import { envRequirementsFor, installRequirement } from './envRequirements.js'
 import type { LspManager } from './manager.js'
@@ -451,11 +452,13 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
           args.context,
         )
         if (!completions) return { ok: true, completions: undefined }
-        const truncated = completions.items.length > 500
-        return {
-          ok: true,
-          completions: truncated ? { ...completions, items: completions.items.slice(0, 500), truncated: true } : completions,
-        }
+        // 前缀感知截断：超限时按当前输入前缀分桶，保证正在打的符号不被挤出上限
+        // （本仓库上万个 CS_* 绑定桩会把 ECommon 等项目全局顶到 500 条之外）。
+        const capped = capCompletions(completions.items, args.prefix)
+        const payload = { ...completions, items: capped.items }
+        if (capped.truncated) payload.truncated = true
+        else delete payload.truncated
+        return { ok: true, completions: payload }
       } catch (error) {
         return { ok: false, error: 'LSP 补全查询失败：' + String(error) }
       }

package/src/lsp/server.ts

@@ -57,6 +57,19 @@ interface OpenDoc {
 }
 
 const RESTARTABLE = true
+const MAX_DOC_VERSION = 2147483647
+
+/**
+ * 使用合法、递增的 Int32 文档版本；旧客户端的毫秒时间戳不能直发给 Roslyn。
+ * @author ddj 2026年09月24号
+ * @param incoming 客户端传来的版本
+ * @param previous 当前服务器记录的版本
+ * @returns 可发送给语言服务器的版本
+ */
+export function lspDocVersion(incoming: number, previous?: number): number {
+  const next = Math.min(MAX_DOC_VERSION, (previous ?? 0) + 1)
+  return Number.isInteger(incoming) && incoming >= next && incoming <= MAX_DOC_VERSION ? incoming : next
+}
 
 /**
  * 创建语言服务器会话。
@@ -237,21 +250,22 @@ export function createLspServer(spec: LspProviderSpec, root: string, languageId:
     sync(path: string, text: string, version: number): void {
       const existing = docs.get(path)
       const uri = existing?.uri ?? docUriOf(path)
+      const safeVersion = lspDocVersion(version, existing?.version)
       if (existing) {
-        existing.version = version
+        existing.version = safeVersion
         existing.text = text
         if (phase === 'ready' || phase === 'indexing') {
           client?.notify('textDocument/didChange', {
-            textDocument: { uri, version },
+            textDocument: { uri, version: safeVersion },
             contentChanges: [{ text }],
           })
         }
         return
       }
-      docs.set(path, { path, uri, version, text })
+      docs.set(path, { path, uri, version: safeVersion, text })
       if (phase === 'ready' || phase === 'indexing') {
         client?.notify('textDocument/didOpen', {
-          textDocument: { uri, languageId, version, text },
+          textDocument: { uri, languageId, version: safeVersion, text },
         })
       }
     },

package/src/rpc.ts

@@ -51,6 +51,7 @@ import { clearDebugLog, debugRecord, isDebugLogName, listDebugLogs, readDebugLog
 import { markActiveSessions, markOfficialFlags, moveOutSessions, planMoveOut, purgeArchive, restoreSession, scanSessionInventory, sessionsArchiveRoot, sessionSizeOf, sidecarSummaryOf, unarchiveOfficial } from './perf.js'
 import { patchHasPerfConfig, patchInsertPerfConfig, patchRemovePerfConfig, perfConfigBlock } from './perfPatch.js'
 import type { FileVersions } from './fileVersions.js'
+import { settingsDocPath } from './settingsDocPath.js'
 
 /** cwd → 上次 stale 自动清理时间：全量轮询（EditorView/DiffBadge/Dock 各自 5s）节流，避免每轮都读文件算指纹。 */
 const staleCheckedAt = new Map<string, number>()
@@ -109,6 +110,23 @@ function snippetTargetOf(path: string): string | null {
   return isSnippetFilePath(path) ? path.replace(/\\/g, '/') : null
 }
 
+
+/**
+ * 返回与当前 settings provider 文档路径精确匹配的授权目标。
+ * @author ddj 2026年10月02号
+ * @param ctx DSH host 上下文
+ * @param path 编辑器请求路径
+ * @returns provider 当前配置文档的绝对路径；未匹配返回 null
+ */
+function settingsTargetOf(ctx: Ctx, path: string): string | null {
+  try {
+    const settings = ctx.get('settings') as { documentPath?: unknown } | undefined
+    return settingsDocPath(settings?.documentPath, path)
+  } catch {
+    return null
+  }
+}
+
 /** readTargetOf 成功形态：解析后的目标路径、stat 信息与 fs 服务句柄。 */
 interface ReadTargetOk {
   target: string
@@ -473,6 +491,18 @@ export function buildHandlers(
       return { ok: true, results }
     },
     'edrv.read': async (args) => {
+      const settingsTarget = settingsTargetOf(ctx, args.path)
+      if (settingsTarget && args.encoding !== 'base64') {
+        try {
+          const info = await stat(settingsTarget)
+          if (!info.isFile()) return { ok: false, error: '设置配置文件不存在' }
+          if (info.size > READ_CAP) return { ok: false, error: '设置配置文件过大（>8MB）' }
+          const content = await readFile(settingsTarget, 'utf8')
+          return { ok: true, content, size: content.length, version: fileVersionOf(info) }
+        } catch (error) {
+          return { ok: false, error: '读取设置配置文件失败：' + String(error), resolvedPath: settingsTarget }
+        }
+      }
       // 全局片段文件（~/.dsh/snippets/*.code-snippets）在工作区之外：直读，不走会话 cwd 解析
       const snippetTarget = snippetTargetOf(args.path)
       if (snippetTarget && args.encoding !== 'base64') {
@@ -522,9 +552,26 @@ export function buildHandlers(
       }
     },
     'edrv.versions': async (args) => {
-      // 外部改动检测：批量返回已打开文件的磁盘版本（观察器同时失效变化的目录树）
+      // 工作区外的 settings 文档按同一精确授权路径直接观察，其余路径保持工作区版本服务策略。
+      const items = []
+      const regularPaths: string[] = []
+      for (const path of args.paths) {
+        const target = settingsTargetOf(ctx, path)
+        if (!target) {
+          regularPaths.push(path)
+          continue
+        }
+        try {
+          const info = await stat(target)
+          items.push({ path, version: fileVersionOf(info), size: info.size, type: 'file' as const })
+        } catch (error) {
+          items.push({ path, version: '', type: 'missing' as const, error: String(error) })
+        }
+      }
+      if (regularPaths.length === 0) return { ok: true, items }
       if (!fileVersions) return { ok: false, error: '文件版本观察器未装配' }
-      return fileVersions.versions(args)
+      const regular = await fileVersions.versions({ ...args, paths: regularPaths })
+      return { ...regular, items: [...items, ...regular.items] }
     },
     'edrv.original': async (args) => {
       // 重建"本批次修改前"内容：DiffEditor 原始侧。仅反解 pending 块；
@@ -553,6 +600,20 @@ export function buildHandlers(
       }
     },
     'edrv.save': async (args) => {
+      const settingsTarget = settingsTargetOf(ctx, args.path)
+      if (settingsTarget) {
+        try {
+          const info = await stat(settingsTarget)
+          const currentRev = fileVersionOf(info)
+          if (args.rev && args.rev !== currentRev) return { ok: false, conflict: true, error: '设置配置文件已被外部修改，请先重新加载' }
+          if (settingsTargetOf(ctx, args.path) !== settingsTarget) return { ok: false, error: '设置配置文件路径已变化，拒绝保存' }
+          await writeFile(settingsTarget, args.content, 'utf8')
+          const saved = await stat(settingsTarget).catch(() => null)
+          return { ok: true, rev: fileVersionOf(saved) || currentRev }
+        } catch (error) {
+          return { ok: false, error: '保存设置配置文件失败：' + String(error) }
+        }
+      }
       // 全局片段文件：直写（工作区外），且不进差异审查（片段变更不是 agent 编辑产物）
       const snippetTarget = snippetTargetOf(args.path)
       if (snippetTarget) {
@@ -925,6 +986,17 @@ export function buildHandlers(
       const value = section?.value as { fileOpenTool?: unknown } | undefined
       return { ok: true, fileOpenTool: normalizeFileOpenTool(value?.fileOpenTool ?? FILE_OPEN_DEFAULT), integrationBaseUrl: await integrationBaseUrlOf(ctx), revision: section?.revision }
     },
+    'vscode.settingsDocumentPath': async () => {
+      try {
+        const settings = ctx.get('settings') as { prepareDocument?: () => Promise<string> } | undefined
+        if (typeof settings?.prepareDocument !== 'function') return { ok: false, error: '设置配置文件不可用' }
+        const path = await settings.prepareDocument()
+        if (typeof path !== 'string' || !path.trim()) return { ok: false, error: '设置配置文件路径为空' }
+        return { ok: true, path }
+      } catch (error) {
+        return { ok: false, error: '准备设置配置文件失败：' + String(error) }
+      }
+    },
     'vscode.fileOpenSettingsUpdate': async (args) => {
       const settings = ctx.get('settings')
       const patch: Record<string, unknown> = { fileOpenTool: normalizeFileOpenTool(args.fileOpenTool) }

package/src/settingsDocPath.ts

@@ -0,0 +1,30 @@
+import { posix, win32 } from 'node:path'
+
+/**
+ * Resolve the settings document only when the request names its exact configured path.
+ *
+ * Both sides are resolved with the path rules of `platform` (win32 → `C:`-style paths and
+ * case-insensitive comparison; otherwise POSIX rules and case-sensitive comparison), so the
+ * function keeps its meaning when the host platform is passed explicitly instead of implied.
+ * @author ddj 2026年10月02号
+ * @param configuredPath Path exposed by the active settings provider
+ * @param requestedPath Path requested by the editor RPC
+ * @param platform Platform whose path rules resolve both sides and drive case comparison
+ * @returns The configured absolute path when authorized; otherwise null
+ */
+export function settingsDocPath(
+  configuredPath: unknown,
+  requestedPath: string,
+  platform = process.platform,
+): string | null {
+  if (typeof configuredPath !== 'string' || !configuredPath.trim() || !requestedPath) return null
+  try {
+    const api = platform === 'win32' ? win32 : posix
+    const configured = api.resolve(configuredPath)
+    const requested = api.resolve(requestedPath)
+    const fold = (value: string): string => platform === 'win32' ? value.toLowerCase() : value
+    return fold(configured) === fold(requested) ? configured : null
+  } catch {
+    return null
+  }
+}

package/src/shared/rpc.ts

@@ -19,7 +19,7 @@ import type { RuleInfo, RuleProject, RuleRefInput, RuleSaveInput } from './rules
 import type { SnippetEntry, SnippetInfo, SnippetProject, SnippetRefInput, SnippetSaveInput } from './snippets.js'
 import type { LspCompletionItem, LspCompletionList, LspEnvInstallState, LspExtInfo, LspExtUpdate, LspHover, LspLocation, LspMarketItem, LspPosition, LspSemanticTokens, LspServerStatus, LspSignatureHelp, LspSymbol } from './lsp.js'
 import type { AiConfigPatch, AiConfigView, AiDirectoryView, AiInlineRequest, AiInlineResult } from './ai.js'
-import type { SvnAction, SvnAiPlan, SvnChangeEntry, SvnConflictArtifact, SvnDiffRevResult, SvnIgnoreItem, SvnLogEntry, SvnRemoteOutdatedEntry, SvnStatusPayload, SvnSumEntry, SvnUpdateResult } from './svn.js'
+import type { SvnAction, SvnAiPlan, SvnChangeEntry, SvnConflictArtifact, SvnDiffRevResult, SvnIgnoreItem, SvnLogEntry, SvnRemoteOutdatedEntry, SvnStatusPayload, SvnSumEntry, SvnUpdatePoll, SvnUpdateResult, SvnUpdateState } from './svn.js'
 import type { DapAction, DapAdapterInfo, DapBreakpointAck, DapBreakpointInput, DapConfigSnippet, DapConfigSource, DapDebugConfig, DapFrameView, DapPhase, DapPollResult, DapProcessInfo, DapScopeView, DapVariableView } from './dap.js'
 import { DAP_ACTIONS } from './dap.js'
 import type { LoggerLevel } from './logger.js'
@@ -371,6 +371,7 @@ export interface RpcRequestMap {
   'mcp.projectToggle': { workspacePath: string; serverName: string; enabled: boolean }
   'mcp.projectRefresh': { workspacePath: string; serverName: string }
   'vscode.fileOpenSettingsGet': {}
+  'vscode.settingsDocumentPath': {}
   'vscode.fileOpenSettingsUpdate': { fileOpenTool: string; integrationBaseUrl?: string; expectedRevision?: number }
   'edrv.integration.status': {}
   'edrv.integration.register': {}
@@ -396,7 +397,7 @@ export interface RpcRequestMap {
   'edrv.lsp.workspaceSymbol': { sessionId?: string; query: string }
   'edrv.lsp.hover': { sessionId?: string; path: string; position: LspPosition }
   'edrv.lsp.semanticTokens': { sessionId?: string; path: string }
-  'edrv.lsp.completion': { sessionId?: string; path: string; position: LspPosition; context?: { triggerKind?: number; triggerCharacter?: string } }
+  'edrv.lsp.completion': { sessionId?: string; path: string; position: LspPosition; context?: { triggerKind?: number; triggerCharacter?: string }; prefix?: string }
   'edrv.lsp.resolveCompletion': { sessionId?: string; path: string; item: LspCompletionItem }
   'edrv.lsp.signatureHelp': { sessionId?: string; path: string; position: LspPosition }
   'edrv.lsp.redetect': { languageId: string }
@@ -447,6 +448,10 @@ export interface RpcRequestMap {
   'svn.wcRev': { sessionId?: string; path?: string }
   'svn.cleanup': { sessionId?: string; removeUnversioned?: boolean; removeIgnored?: boolean }
   'svn.update': { sessionId?: string; path?: string }
+  'svn.updateStart': { sessionId?: string; path?: string }
+  'svn.updatePoll': { sessionId?: string; jobId: string; since: number }
+  'svn.updateCancel': { sessionId?: string; jobId: string }
+  'svn.updateActive': { sessionId?: string }
   'svn.tortoise': { sessionId?: string; action: SvnAction; path?: string }
   'svn.patchText': { sessionId?: string; path: string; whitespace?: 'none' | 'b' | 'w'; ignoreEol?: boolean; unified?: number }
   'svn.diffSum': { sessionId?: string; path?: string; revA: number; revB: number }
@@ -519,6 +524,7 @@ export interface RpcOkMap {
   'mcp.projectToggle': { project: MpcProject }
   'mcp.projectRefresh': { project: MpcProject }
   'vscode.fileOpenSettingsGet': { fileOpenTool: string; integrationBaseUrl: string; revision?: number }
+  'vscode.settingsDocumentPath': { path: string }
   'vscode.fileOpenSettingsUpdate': { fileOpenTool: string; integrationBaseUrl: string; revision?: number }
   'edrv.integration.status': ShellIntegrationStatus
   'edrv.integration.register': ShellIntegrationStatus
@@ -595,6 +601,10 @@ export interface RpcOkMap {
   'svn.wcRev': { revision: number | null }
   'svn.cleanup': { summary: string; output: string }
   'svn.update': SvnUpdateResult
+  'svn.updateStart': SvnUpdateState
+  'svn.updatePoll': SvnUpdatePoll
+  'svn.updateCancel': SvnUpdateState
+  'svn.updateActive': { job: SvnUpdateState | null }
   'svn.tortoise': { launched: string }
   'svn.patchText': { text: string; truncated: boolean; binary: boolean }
   'svn.diffSum': { entries: SvnSumEntry[]; truncated: boolean }

package/src/shared/svn.ts

@@ -99,6 +99,44 @@ export interface SvnUpdateResult {
   output: string
 }
 
+/** 原生更新窗口的真实执行阶段。 */
+export type SvnUpdatePhase = 'starting' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled'
+
+/** 流式更新行；relPath 仅在目标位于当前工作区内时可操作。 */
+export interface SvnUpdateRow {
+  seq: number
+  action: SvnUpdateAction | null
+  path: string
+  relPath: string | null
+  label: string
+  raw: string
+}
+
+/** 分类数量按 svn 输出中的条目行计，不猜文件总数或网络字节。 */
+export type SvnUpdateCounts = Record<SvnUpdateAction, number>
+
+/** 更新任务快照（窗口第一次连接和每次增量 poll 共用）。 */
+export interface SvnUpdateState {
+  jobId: string
+  target: string
+  phase: SvnUpdatePhase
+  counts: SvnUpdateCounts
+  revision: number | null
+  elapsedMs: number
+  error: string
+  rawTail: string
+  truncated: boolean
+  nextSeq: number
+}
+
+/** 增量读取结果：rows 只含 since 之后的一页，offset 表示目前可重放的首条序号。 */
+export interface SvnUpdatePoll extends SvnUpdateState {
+  rows: SvnUpdateRow[]
+  offset: number
+  /** 当前后台总序号；nextSeq 仅是本次前端已经拿到的最后一条。 */
+  totalSeq: number
+}
+
 /** revert/add 等批量动作结果（计数 + 摘要 + 原文）。 */
 export interface SvnActionResult {
   /** 处理条目数（宽松计数）。 */