dsh-vscode-mode 0.21.4 → 0.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/README.md +52 -4
  2. package/lib/client.js +3442 -183
  3. package/lib/client.js.map +2 -2
  4. package/lib/index.js +3510 -222
  5. package/lib/index.js.map +1 -1
  6. package/package.json +1 -1
  7. package/src/client/index.ts +166 -0
  8. package/src/client/quickMenuHost.ts +46 -0
  9. package/src/client/quickMenuStore.ts +260 -0
  10. package/src/client/state/diffSummary.ts +52 -8
  11. package/src/client/styles/quickmenu.css +1049 -0
  12. package/src/client/ui/DiffLauncher.ts +1 -1
  13. package/src/client/ui/EditorView.ts +10 -2
  14. package/src/client/ui/OfficialDiffBar.tsx +1 -12
  15. package/src/client/ui/OfficialReview.ts +13 -3
  16. package/src/client/ui/QuickMenuDialog.tsx +835 -0
  17. package/src/client/ui/QuickMenuLauncher.tsx +792 -0
  18. package/src/client/ui/QuickMenuPickers.ts +577 -0
  19. package/src/client/ui/SidecarDiffBar.tsx +0 -22
  20. package/src/index.ts +9 -0
  21. package/src/missingReview.ts +36 -14
  22. package/src/paths.ts +10 -0
  23. package/src/pending/capture.ts +165 -0
  24. package/src/pending/decide.ts +213 -0
  25. package/src/pending/hunks.ts +241 -0
  26. package/src/pending/kernel.ts +233 -0
  27. package/src/pending/persist.ts +329 -0
  28. package/src/pending/store.ts +472 -0
  29. package/src/pending/vcs.ts +444 -0
  30. package/src/pendingCompat.ts +184 -0
  31. package/src/pendingRpc.ts +210 -0
  32. package/src/quickMenu.ts +269 -0
  33. package/src/reviewDb.ts +3 -0
  34. package/src/reviewRpc.ts +52 -1
  35. package/src/rpc.ts +66 -2
  36. package/src/shared/pathKey.ts +54 -0
  37. package/src/shared/pendingReview.ts +105 -0
  38. package/src/shared/quickMenu.ts +1009 -0
  39. package/src/shared/quickPick.ts +67 -0
  40. package/src/shared/rpc.ts +28 -0
  41. package/src/shared/skillCatalog.ts +60 -0
  42. package/src/skillCatalog.ts +138 -0
  43. package/src/store.ts +19 -0
@@ -0,0 +1,472 @@
1
+ /**
2
+ * 待审投影的工作区存储:把采集到的写入折进单条累计条目,并承接 Keep/Revert 与外部改动的吸收。
3
+ * @author ddj 2026年10月29号
4
+ */
5
+ import type { PendingDecide, PendingDetail, PendingHistoryMove, PendingItem, PendingPage } from '../shared/pendingReview.js'
6
+ import type { ReviewBlockState } from '../shared/reviewRegions.js'
7
+ import { reviewBlocks } from '../shared/reviewRegions.js'
8
+ import { unlink } from 'node:fs/promises'
9
+ import { resolve, sep } from 'node:path'
10
+ import type { PendingWrite } from './capture.js'
11
+ import { readText } from './capture.js'
12
+ import type { ShellLike, VcsImportOptions } from './vcs.js'
13
+ import { importVcsChanges } from './vcs.js'
14
+ import type { DecideOutcome, WriteResult } from './decide.js'
15
+ import { capabilityOf, decide, diffOf } from './decide.js'
16
+ import { entryFromNew, isSettled, mergeEntries } from './kernel.js'
17
+ import type { PendingEntry } from './kernel.js'
18
+ import type { PendingFlags, StoredEntry } from './persist.js'
19
+ import {
20
+ dropEntry, earliestUndone, latestApplied, loadBlocks, loadEntries, pushHistory,
21
+ readOp, saveBlocks, saveEntry, setHistoryState, writeOp,
22
+ } from './persist.js'
23
+
24
+ /**
25
+ * @author ddj 2026年10月29号
26
+ * @description: 统计一次差异的增删行数;非文本差异统一记 0/0。
27
+ * @param entry 待审条目
28
+ * @returns 增删行数
29
+ */
30
+ function countsOf(entry: PendingEntry): { added: number; deleted: number } {
31
+ const diff = diffOf(entry)
32
+ if (diff.kind !== 'text') return { added: 0, deleted: 0 }
33
+ let added = 0
34
+ let deleted = 0
35
+ for (const hunk of diff.hunks) {
36
+ for (const line of hunk.lines) {
37
+ if (line.startsWith('+')) added++
38
+ else if (line.startsWith('-')) deleted++
39
+ }
40
+ }
41
+ return { added, deleted }
42
+ }
43
+
44
+ /**
45
+ * @author ddj 2026年10月30号
46
+ * @description: 由当前累计条目现场推导块身份;块是差异的纯函数,落库的只是决定状态。
47
+ * @param entry 累计条目
48
+ * @returns 块状态列表(决定一律 pending,判定推进后由下一次推导自然收窄)
49
+ */
50
+ function blockStatesOf(entry: PendingEntry): ReviewBlockState[] {
51
+ const diff = diffOf(entry)
52
+ if (diff.kind !== 'text') return []
53
+ return reviewBlocks(diff).map((block) => ({ id: block.id, decision: 'pending' as const }))
54
+ }
55
+
56
+ /**
57
+ * @author ddj 2026年10月29号
58
+ * @description: 把一次已确认写入折进累计条目:同一身份只保留一条,基线留最早、内容取最新。
59
+ * @param stored 已有条目(可为空)
60
+ * @param write 采集到的写入
61
+ * @returns 折叠后的条目与标记
62
+ */
63
+ export function foldWrite(stored: StoredEntry | undefined, write: PendingWrite): StoredEntry {
64
+ const fresh: PendingEntry = entryFromNew({
65
+ id: write.identity,
66
+ path: write.path,
67
+ sessionId: write.sessionId,
68
+ earlierVersion: write.before === null ? 'none' : 'file',
69
+ oldText: write.before ?? '',
70
+ newText: write.after ?? '',
71
+ updatedAt: write.now,
72
+ })
73
+ if (!stored) {
74
+ return {
75
+ entry: fresh,
76
+ flags: { missing: write.after === null, diverged: false, oversized: false, revision: 0 },
77
+ }
78
+ }
79
+ const merged = mergeEntries(stored.entry, fresh)
80
+ merged.path = write.path
81
+ return {
82
+ entry: merged,
83
+ flags: {
84
+ missing: write.after === null,
85
+ diverged: false,
86
+ oversized: stored.flags.oversized,
87
+ revision: stored.flags.revision + 1,
88
+ },
89
+ }
90
+ }
91
+
92
+ /**
93
+ * @author ddj 2026年10月29号
94
+ * @description: 条目转列表投影,已解决条目仍保留但不可再决定。
95
+ * @param stored 条目与标记
96
+ * @returns 列表项
97
+ */
98
+ export function itemOf(stored: StoredEntry): PendingItem {
99
+ const { entry, flags } = stored
100
+ const counts = countsOf(entry)
101
+ const item: PendingItem = {
102
+ id: entry.id,
103
+ path: entry.path,
104
+ earlierVersion: entry.earlierVersion,
105
+ added: counts.added,
106
+ deleted: counts.deleted,
107
+ settled: isSettled(entry),
108
+ unseen: entry.unseen === true,
109
+ missing: flags.missing,
110
+ diverged: flags.diverged,
111
+ oversized: flags.oversized,
112
+ revision: flags.revision,
113
+ updatedAt: entry.updatedAt,
114
+ sessionId: entry.sessionId,
115
+ sessionIds: entry.sessionIds,
116
+ }
117
+ if (entry.lineage !== undefined) item.lineage = entry.lineage
118
+ return item
119
+ }
120
+
121
+ /**
122
+ * @author ddj 2026年10月29号
123
+ * @description: 读一页待审条目,按更新时间升序;会话过滤走血缘集合。
124
+ * @param cwd 工作区
125
+ * @param sessionId 当前会话
126
+ * @returns 列表
127
+ */
128
+ export function loadPage(cwd: string, sessionId?: string): PendingPage {
129
+ const all = loadEntries(cwd)
130
+ const visible = sessionId ? all.filter((stored) => stored.entry.sessionIds.includes(sessionId)) : all
131
+ const items = visible.map(itemOf)
132
+ const gaps: string[] = []
133
+ for (const stored of visible) {
134
+ if (stored.flags.oversized) gaps.push(`${stored.entry.path}: 文本超出上限,仅保留标记`)
135
+ }
136
+ return { items, pending: items.filter((item) => !item.settled).length, nextCursor: null, gaps }
137
+ }
138
+
139
+ /**
140
+ * @author ddj 2026年10月29号
141
+ * @description: 读单条详情,包含可交给现有面板渲染的差异与块决定。
142
+ * @param cwd 工作区
143
+ * @param id 条目身份
144
+ * @returns 详情,条目不存在时 null
145
+ */
146
+ export function loadDetail(cwd: string, id: string): PendingDetail | null {
147
+ const stored = loadEntries(cwd).find((item) => item.entry.id === id)
148
+ if (!stored) return null
149
+ const diff = diffOf(stored.entry)
150
+ return {
151
+ item: itemOf(stored),
152
+ diff,
153
+ blocks: blockStatesOf(stored.entry),
154
+ capability: capabilityOf(stored.entry, stored.flags),
155
+ }
156
+ }
157
+
158
+ /**
159
+ * @author ddj 2026年10月29号
160
+ * @description: 采集入口:折叠写入并落库。
161
+ * @param write 已确认写入
162
+ * @returns 无
163
+ */
164
+ export function recordWrite(write: PendingWrite): void {
165
+ const stored = loadEntries(write.cwd).find((item) => item.entry.id === write.identity)
166
+ if (stored && stored.entry.oldText === stored.entry.newText && stored.entry.newText === (write.after ?? '')) return
167
+ saveEntry(write.cwd, foldWrite(stored, write))
168
+ }
169
+
170
+ /**
171
+ * @author ddj 2026年10月29号
172
+ * @description: 外部改动吸收:当前内容与条目最新内容不同时采纳并标分歧,基线不动。
173
+ * @param stored 条目
174
+ * @param content 磁盘当前内容
175
+ * @param now 时间
176
+ * @returns 新条目与标记
177
+ */
178
+ export function absorbed(stored: StoredEntry, content: string, now: number): StoredEntry {
179
+ return {
180
+ entry: { ...stored.entry, newText: content, updatedAt: now, unseen: true },
181
+ flags: { ...stored.flags, diverged: true, missing: false, revision: stored.flags.revision + 1 },
182
+ }
183
+ }
184
+
185
+ /**
186
+ * @author ddj 2026年10月29号
187
+ * @description: 读回磁盘并把可读的外部改动吸收进条目;缺失只标标记不删条目。
188
+ * @param stored 条目
189
+ * @param content 磁盘当前内容,null 表示缺失或不可读
190
+ * @param now 时间
191
+ * @returns 需要落库的新状态,无需改动时为 null
192
+ */
193
+ export function refreshed(stored: StoredEntry, content: string | null, now: number): StoredEntry | null {
194
+ if (content === null) {
195
+ if (stored.flags.missing) return null
196
+ return { entry: stored.entry, flags: { ...stored.flags, missing: true, revision: stored.flags.revision + 1 } }
197
+ }
198
+ if (content === stored.entry.newText) {
199
+ if (!stored.flags.missing) return null
200
+ return { entry: stored.entry, flags: { ...stored.flags, missing: false, revision: stored.flags.revision + 1 } }
201
+ }
202
+ return absorbed(stored, content, now)
203
+ }
204
+
205
+ /**
206
+ * @author ddj 2026年10月29号
207
+ * @description: 构造带版本守卫与读回校验的写盘函数;内容已被外部改动时直接拒绝。
208
+ * @param fs 文件系统
209
+ * @param cwd 工作区
210
+ * @param identity 目标身份
211
+ * @param expected 写前应当具备的内容
212
+ * @param signal 取消信号
213
+ * @param policy 沙箱策略
214
+ * @param allowCreate 文件已被删除时是否允许按快照重建(仅撤销/重做路径使用)
215
+ * @returns 写盘函数
216
+ */
217
+ export function writerFor(
218
+ fs: any, cwd: string, identity: string, expected: string, signal?: AbortSignal, policy?: unknown,
219
+ allowCreate = false,
220
+ ): (content: string | null) => Promise<WriteResult> {
221
+ return async (content) => {
222
+ let target: any
223
+ try {
224
+ target = await fs.resolve(identity, { cwd, signal })
225
+ } catch {
226
+ return { ok: false, reason: 'resolve-failed' }
227
+ }
228
+ const current = await readText(fs, target).catch(() => undefined)
229
+ if (current === undefined) return { ok: false, reason: 'read-failed' }
230
+ // 撤销「Revert 删除新建文件」时文件已不存在,只有显式允许重建才放行
231
+ const recreate = allowCreate && current === null
232
+ if (!recreate && current !== expected) return { ok: false, reason: 'diverged' }
233
+ const currentStat = await fs.stat(target, signal).catch(() => undefined)
234
+ try {
235
+ // 第五个实参是沙箱策略;缺它时 provider 会以 FS_SANDBOX_DENIED 拒绝写入
236
+ const written = await fs.writeText(
237
+ target, content ?? '', currentStat ? { kind: 'replaceIfVersion', version: currentStat.version } : undefined, signal, policy,
238
+ )
239
+ const readBack = await readText(fs, target)
240
+ if ((content ?? '') !== (readBack ?? '')) return { ok: false, reason: 'read-back-mismatch' }
241
+ if (content === null && readBack !== null) return { ok: false, reason: 'delete-failed' }
242
+ void written
243
+ return { ok: true, content }
244
+ } catch (error) {
245
+ return { ok: false, reason: reasonOf(error) }
246
+ }
247
+ }
248
+ }
249
+
250
+ /**
251
+ * @author ddj 2026年10月29号
252
+ * @description: 执行一次 Keep/Revert 并把结果落库;失败只返回原因,不写任何状态。
253
+ * @param fs 文件系统
254
+ * @param cwd 工作区
255
+ * @param request 判定请求
256
+ * @param signal 取消信号
257
+ * @returns 判定结果
258
+ */
259
+ export async function applyDecide(
260
+ fs: any, cwd: string, request: PendingDecide, signal?: AbortSignal, policy?: unknown,
261
+ ): Promise<DecideOutcome | { ok: false; reason: string }> {
262
+ const stored = loadEntries(cwd).find((item) => item.entry.id === request.id)
263
+ if (!stored) return { ok: false, reason: 'unknown-item' }
264
+ const beforeBlocks = blockStatesOf(stored.entry)
265
+ const outcome = await decide({
266
+ request,
267
+ entry: stored.entry,
268
+ flags: stored.flags,
269
+ blocks: beforeBlocks,
270
+ now: Date.now(),
271
+ write: (content) => {
272
+ if (content === null) return deleteTarget(fs, cwd, stored.entry.id, signal)
273
+ return writerFor(fs, cwd, stored.entry.id, stored.entry.newText, signal, policy)(content)
274
+ },
275
+ })
276
+ if (!outcome.ok) return { ok: false, reason: outcome.reason }
277
+ saveEntry(cwd, { entry: outcome.entry, flags: outcome.flags })
278
+ saveBlocks(cwd, request.id, outcome.blocks)
279
+ // 记录撤销快照(含是否真的写过盘),撤销/重做都从这条记录反推
280
+ pushHistory(cwd, 'decide', request.id, JSON.stringify({
281
+ before: { entry: stored.entry, flags: stored.flags, blocks: beforeBlocks },
282
+ after: { entry: outcome.entry, flags: outcome.flags, blocks: outcome.blocks as ReviewBlockState[] },
283
+ wrote: outcome.wrote,
284
+ }), Date.now())
285
+ return outcome
286
+ }
287
+
288
+ /**
289
+ * @author ddj 2026年10月30号
290
+ * @description: 版本库导入:把工作副本相对基线的改动折进待审条目,已存在条目按折叠规则并入。
291
+ * @param shell shell 能力
292
+ * @param cwd 工作区
293
+ * @param sessionId 触发导入的会话
294
+ * @param options 导入选项
295
+ * @returns 导入条数与探测到的改动数
296
+ */
297
+ export async function importFromVcs(
298
+ shell: ShellLike, cwd: string, sessionId: string, options: VcsImportOptions = {},
299
+ ): Promise<{ imported: number; changes: number }> {
300
+ const changes = await importVcsChanges(shell, cwd, options)
301
+ const now = Date.now()
302
+ for (const change of changes) {
303
+ recordWrite({
304
+ cwd,
305
+ sessionId,
306
+ path: change.path,
307
+ identity: change.path,
308
+ before: change.earlierVersion === 'none' ? null : change.oldText,
309
+ after: change.newText,
310
+ now,
311
+ })
312
+ }
313
+ return { imported: changes.length, changes: changes.length }
314
+ }
315
+
316
+ /**
317
+ * @author ddj 2026年10月30号
318
+ * @description: 撤销或重做最近一次判定。先按 operationId 判幂等,再据栈顶记录判定方向是否合法,
319
+ * 只有写盘过的判定才反向写盘,写盘失败时条目状态保持原样。
320
+ * @param fs 文件系统
321
+ * @param cwd 工作区
322
+ * @param move 撤销/重做请求
323
+ * @param signal 取消信号
324
+ * @returns 结果条目与是否写盘
325
+ */
326
+ export async function undoDecide(
327
+ fs: any, cwd: string, move: PendingHistoryMove, signal?: AbortSignal, policy?: unknown,
328
+ ): Promise<{ ok: true; item: PendingItem; wrote: boolean } | { ok: false; reason: string }> {
329
+ const replay = readOp(cwd, move.operationId)
330
+ if (replay && replay.state === 'committed' && replay.result) return JSON.parse(replay.result) as { ok: true; item: PendingItem; wrote: boolean }
331
+
332
+ const record = move.direction === 'undo' ? latestApplied(cwd) : earliestUndone(cwd)
333
+ if (!record) return { ok: false, reason: move.direction === 'undo' ? 'no-undo' : 'no-redo' }
334
+ const snapshot = parseSnapshot(record.snapshot)
335
+ if (!snapshot) return { ok: false, reason: 'bad-history' }
336
+ const stored = loadEntries(cwd).find((item) => item.entry.id === record.entryId)
337
+ if (!stored) return { ok: false, reason: 'unknown-item' }
338
+ const target = move.direction === 'undo' ? snapshot.before : snapshot.after
339
+
340
+ writeOp(cwd, move.operationId, JSON.stringify(move), 'prepared')
341
+ let wrote = false
342
+ if (snapshot.wrote) {
343
+ const result = await writeBack(fs, cwd, stored, target, signal, policy)
344
+ if (!result.ok) return { ok: false, reason: result.reason }
345
+ wrote = true
346
+ }
347
+
348
+ saveEntry(cwd, { entry: target.entry, flags: target.flags })
349
+ saveBlocks(cwd, record.entryId, target.blocks)
350
+ setHistoryState(cwd, record.id, move.direction === 'undo' ? 'undone' : 'applied')
351
+ const outcome = { ok: true as const, item: itemOf({ entry: target.entry, flags: target.flags }), wrote }
352
+ writeOp(cwd, move.operationId, JSON.stringify(move), 'committed', { result: JSON.stringify(outcome) })
353
+ return outcome
354
+ }
355
+
356
+ /**
357
+ * @author ddj 2026年10月30号
358
+ * @description: 把文件内容恢复到目标快照:目标为缺失则删除,否则按版本守卫写回并读回校验。
359
+ * @param fs 文件系统
360
+ * @param cwd 工作区
361
+ * @param stored 当前条目
362
+ * @param target 目标快照
363
+ * @param signal 取消信号
364
+ * @returns 写盘结果
365
+ */
366
+ async function writeBack(
367
+ fs: any, cwd: string, stored: StoredEntry, target: HistoryState, signal?: AbortSignal, policy?: unknown,
368
+ ): Promise<WriteResult> {
369
+ if (target.flags.missing) return deleteTarget(fs, cwd, stored.entry.id, signal)
370
+ const write = writerFor(fs, cwd, stored.entry.id, stored.entry.newText, signal, policy, true)
371
+ return write(target.entry.newText)
372
+ }
373
+
374
+ /** 历史快照中单侧状态。 */
375
+ interface HistoryState {
376
+ entry: PendingEntry
377
+ flags: PendingFlags
378
+ blocks: ReviewBlockState[]
379
+ }
380
+
381
+ /** 一次判定的双向快照。 */
382
+ interface HistorySnapshot {
383
+ before: HistoryState
384
+ after: HistoryState
385
+ wrote: boolean
386
+ }
387
+
388
+ /**
389
+ * @author ddj 2026年10月30号
390
+ * @description: 解析历史快照;损坏时返回 null,不猜测内容。
391
+ * @param text 快照文本
392
+ * @returns 快照或 null
393
+ */
394
+ function parseSnapshot(text: string): HistorySnapshot | null {
395
+ try {
396
+ const parsed = JSON.parse(text) as HistorySnapshot
397
+ if (!parsed?.before?.entry || !parsed?.after?.entry) return null
398
+ return parsed
399
+ } catch {
400
+ return null
401
+ }
402
+ }
403
+
404
+ /**
405
+ * @author ddj 2026年10月29号
406
+ * @description: Revert 的删除分支:FileSystem 抽象没有删除能力,只有确认仍在工作区内才用宿主 unlink。
407
+ * @param fs 文件系统
408
+ * @param cwd 工作区
409
+ * @param identity 目标身份
410
+ * @param signal 取消信号
411
+ * @returns 删除结果
412
+ */
413
+ async function deleteTarget(fs: any, cwd: string, identity: string, signal?: AbortSignal): Promise<WriteResult> {
414
+ let target: any
415
+ try {
416
+ target = await fs.resolve(identity, { cwd, signal })
417
+ } catch {
418
+ return { ok: false, reason: 'resolve-failed' }
419
+ }
420
+ const currentStat = await fs.stat(target, signal).catch(() => undefined)
421
+ if (!currentStat) return { ok: true, content: null }
422
+ const absolute = String(fs.processPath(target))
423
+ if (!insideWorkspace(cwd, absolute)) return { ok: false, reason: 'outside-workspace' }
424
+ try {
425
+ await unlink(absolute)
426
+ } catch (error) {
427
+ return { ok: false, reason: reasonOf(error) }
428
+ }
429
+ const after = await fs.stat(target, signal).catch(() => undefined)
430
+ return after ? { ok: false, reason: 'delete-failed' } : { ok: true, content: null }
431
+ }
432
+
433
+ /**
434
+ * @author ddj 2026年10月29号
435
+ * @description: 判断宿主路径是否位于工作区内,Windows 下按大小写不敏感比较。
436
+ * @param cwd 工作区
437
+ * @param absolute 目标绝对路径
438
+ * @returns 是否在工作区内
439
+ */
440
+ function insideWorkspace(cwd: string, absolute: string): boolean {
441
+ const root = resolve(cwd)
442
+ const candidate = resolve(absolute)
443
+ const normalize = (value: string) => (process.platform === 'win32' ? value.toLowerCase() : value)
444
+ const rootKey = normalize(root).endsWith(sep) ? normalize(root) : normalize(root) + sep
445
+ return normalize(candidate).startsWith(rootKey)
446
+ }
447
+
448
+ /**
449
+ * @author ddj 2026年10月29号
450
+ * @description: 从列表移除已解决条目;未解决条目拒绝移除,避免表里看不到却被删掉。
451
+ * @param cwd 工作区
452
+ * @param id 条目身份
453
+ * @param revision 并发校验版本
454
+ * @returns 是否移除
455
+ */
456
+ export function removeEntry(cwd: string, id: string, revision: number): boolean {
457
+ const stored = loadEntries(cwd).find((item) => item.entry.id === id)
458
+ if (!stored || stored.flags.revision !== revision || !isSettled(stored.entry)) return false
459
+ dropEntry(cwd, id)
460
+ return true
461
+ }
462
+
463
+ /**
464
+ * @author ddj 2026年10月29号
465
+ * @description: 取错误码用于拒绝原因,没有则回落到消息文本。
466
+ * @param error 抛出的错误
467
+ * @returns 原因字符串
468
+ */
469
+ function reasonOf(error: unknown): string {
470
+ const code = (error as { code?: unknown }).code
471
+ return typeof code === 'string' ? code : String(error)
472
+ }