dsh-diff-approval 0.19.2 → 0.19.3

package/lib/index.js

@@ -440,6 +440,18 @@ function isPathInside(absolutePath, root) {
 	if (path === base) return true;
 	return path.startsWith(base + sep);
 }
+/**
+* Whether one changed path belongs to the scan: inside the workspace, and inside
+* the narrowed `scope` when the caller set one.
+* @param absolutePath - the changed file's absolute path.
+* @param workspaceRoot - the session's workspace root.
+* @param scope - one path to restrict the scan to, or undefined for all of it.
+* @returns whether the change is in scope.
+*/
+function inScanScope(absolutePath, workspaceRoot, scope) {
+	if (!isPathInside(absolutePath, workspaceRoot)) return false;
+	return scope === void 0 || isPathInside(absolutePath, scope);
+}
 /** The VCS marker of one directory, or undefined when it holds none. */
 function markerOf(directory) {
 	if (existsSync(resolve(directory, ".git"))) return "git";
@@ -511,12 +523,12 @@ function parseGitPorcelainZ(output) {
 }
 /** Enumerate the workspace's local changes in a git checkout. */
 async function gitChanges(input) {
-	const { root, workspaceRoot, includeUntracked, shell, readText, signal } = input;
+	const { root, workspaceRoot, includeUntracked, scope, shell, readText, signal } = input;
 	const stdout = await runShell(shell, "git -c status.renames=false status --porcelain=v1 -z --untracked-files=all", root, signal);
 	const changes = [];
 	for (const { xy, rel } of parseGitPorcelainZ(stdout)) {
 		const absolute = resolve(root, rel);
-		if (!isPathInside(absolute, workspaceRoot)) continue;
+		if (!inScanScope(absolute, workspaceRoot, scope)) continue;
 		if (xy === "??") {
 			if (!includeUntracked) continue;
 			const newText = await readText(absolute) ?? "";
@@ -559,7 +571,7 @@ function xmlUnescape(value) {
 }
 /** Enumerate the workspace's local changes in an svn working copy. */
 async function svnChanges(input) {
-	const { root, workspaceRoot, includeUntracked, shell, readText, signal } = input;
+	const { root, workspaceRoot, includeUntracked, scope, shell, readText, signal } = input;
 	const stdout = await runShell(shell, "svn status --xml", root, signal);
 	const changes = [];
 	const entryPattern = /<entry[^>]*path="([^"]*)"[^>]*>\s*<wc-status[^>]*item="([^"]*)"/g;
@@ -568,7 +580,7 @@ async function svnChanges(input) {
 		const rel = xmlUnescape(match[1]);
 		const item = match[2];
 		const absolute = resolve(root, rel);
-		if (!isPathInside(absolute, workspaceRoot)) continue;
+		if (!inScanScope(absolute, workspaceRoot, scope)) continue;
 		if (item === "modified" || item === "deleted") {
 			let oldText = "";
 			try {
@@ -623,7 +635,7 @@ function p4ChangeOf(line) {
 * not yet opened for add; off keeps to already-opened files (`p4 opened`) so
 * the scan — which can be slow — is skipped. */
 async function p4Changes(input) {
-	const { root, workspaceRoot, includeUntracked, shell, readText, signal } = input;
+	const { root, workspaceRoot, includeUntracked, scope, shell, readText, signal } = input;
 	const stdout = await runShell(shell, includeUntracked ? "p4 status" : "p4 opened", root, signal);
 	const changes = [];
 	for (const line of stdout.split("\n")) {
@@ -632,7 +644,7 @@ async function p4Changes(input) {
 		const local = (await runShell(shell, `p4 where ${shq(opened.depot)}`, root, signal)).trim().split(/\s+/).pop();
 		if (local === void 0 || local.length === 0) continue;
 		const absolute = resolve(local);
-		if (!isPathInside(absolute, workspaceRoot)) continue;
+		if (!inScanScope(absolute, workspaceRoot, scope)) continue;
 		const deleted = opened.action === "delete" || opened.action === "move/delete";
 		const created = opened.action === "add" || opened.action === "move/add";
 		const newText = deleted ? "" : await readText(absolute) ?? "";
@@ -1298,6 +1310,33 @@ function apply(ctx, config) {
 						value: { outcome: "missing" }
 					};
 				}
+				if (payload.keepListed === true) {
+					store.update(target.id, { oldText: entry.newText });
+					const afterEntry = {
+						...entry,
+						oldText: entry.newText,
+						updatedAt: Date.now()
+					};
+					pushUndo(target.sessionId, {
+						id: entry.path,
+						path: entry.path,
+						entry,
+						fileText: void 0
+					}, {
+						id: entry.path,
+						path: entry.path,
+						entry: afterEntry,
+						fileText: void 0
+					});
+					persistSession(true);
+					return {
+						ok: true,
+						value: {
+							outcome: "kept",
+							resolved: true
+						}
+					};
+				}
 				store.remove(target.id);
 				pushUndo(target.sessionId, {
 					id: entry.path,
@@ -1334,6 +1373,34 @@ function apply(ctx, config) {
 				} catch (error) {
 					return rpcError(`revert failed: ${errorMessage(error)}`);
 				}
+				if (payload.keepListed === true) {
+					const content = undo?.after.fileText ?? "";
+					store.update(target.id, { newText: content });
+					const afterEntry = {
+						...entry,
+						newText: content,
+						updatedAt: Date.now()
+					};
+					if (undo !== void 0) pushUndo(target.sessionId, {
+						id: entry.path,
+						path: entry.path,
+						entry,
+						fileText: undo.before.fileText
+					}, {
+						id: entry.path,
+						path: entry.path,
+						entry: afterEntry,
+						fileText: content
+					});
+					persistSession(true);
+					return {
+						ok: true,
+						value: {
+							outcome: "reverted",
+							resolved: true
+						}
+					};
+				}
 				store.remove(target.id);
 				if (undo !== void 0) pushUndo(target.sessionId, undo.before, undo.after);
 				persistSession(true);
@@ -1687,6 +1754,74 @@ function apply(ctx, config) {
 					}
 				};
 			}
+			case "vcs-refresh": {
+				const target = targetOf(payload);
+				if (target === void 0) return rpcError("sessionId and id must be non-empty strings");
+				await ensureLoaded();
+				const entry = store.get(target.id);
+				if (entry === void 0) return {
+					ok: true,
+					value: { outcome: "missing" }
+				};
+				const workspace = workspaceOf(target.sessionId);
+				if (workspace === void 0) return rpcError("refresh unavailable: the session has no workspace");
+				const root = detectVcsRoot(workspace.path);
+				if (root === void 0) return {
+					ok: true,
+					value: { outcome: "no-vcs" }
+				};
+				const shell = ctx.get("shell");
+				if (shell === void 0) return rpcError("refresh unavailable: the deployment has no shell executor");
+				let changes;
+				try {
+					changes = await listVcsChanges({
+						kind: root.kind,
+						root: root.root,
+						workspaceRoot: workspace.path,
+						includeUntracked: payload.includeUntracked === true,
+						scope: entry.path,
+						shell,
+						readText: (path) => readFile(path, "utf8").catch(() => void 0),
+						signal
+					});
+				} catch (error) {
+					return rpcError(`refresh failed: ${errorMessage(error)}`);
+				}
+				const folded = (value) => process.platform === "win32" ? resolve(value).toLowerCase() : resolve(value);
+				const change = changes.find((candidate) => folded(candidate.path) === folded(entry.path));
+				if (change === void 0) return {
+					ok: true,
+					value: { outcome: "no-change" }
+				};
+				if (change.kind === entry.kind && change.oldText === entry.oldText && change.newText === entry.newText) return {
+					ok: true,
+					value: { outcome: "unchanged" }
+				};
+				const refreshed = {
+					...entry,
+					kind: change.kind,
+					oldText: change.oldText,
+					newText: change.newText,
+					updatedAt: Date.now()
+				};
+				store.restore(refreshed);
+				pushUndo(target.sessionId, {
+					id: entry.path,
+					path: entry.path,
+					entry,
+					fileText: void 0
+				}, {
+					id: entry.path,
+					path: entry.path,
+					entry: refreshed,
+					fileText: void 0
+				});
+				persistSession(true);
+				return {
+					ok: true,
+					value: { outcome: "refreshed" }
+				};
+			}
 			case "open": {
 				const target = openTargetOf(payload);
 				if (target === void 0) return rpcError("sessionId, id, and action must be valid");

package/lib/types/client/PendingPanel.d.ts

@@ -66,7 +66,11 @@ interface RowRange {
 export interface SplitDiffHandle {
     jump: (direction: -1 | 1, wrapGuard?: boolean, singleToast?: boolean) => void;
     openSearch: () => void;
+    toggleSearch: () => void;
+    closeSearch: () => boolean;
     searchNext: (direction: -1 | 1) => boolean;
+    toggleMatchCase: () => boolean;
+    toggleMatchWholeWord: () => boolean;
 }
 /** The two-column (side-by-side) whole-file diff view. */
 export declare const SplitDiff: import("react").ForwardRefExoticComponent<{
@@ -93,5 +97,5 @@ export declare const SplitDiff: import("react").ForwardRefExoticComponent<{
  */
 export declare function selectedPlainText(): string | undefined;
 /** Render the pending-edit review panel and its unified footer action. */
-export declare function PendingPanel({ wide, useSessions, usePending, onRefresh, onKeep, onRevert, onBlockKeep, onBlockRevert, onOpen, onPreviewImage, onPasteReference, onUndo, onRedo, onImportVcs, onKeepAll, onRevertAll, onAckRedoCleared, collapseSidebar, t, }: PendingPanelProps): import("react").JSX.Element;
+export declare function PendingPanel({ wide, useSessions, usePending, onRefresh, onKeep, onRevert, onBlockKeep, onBlockRevert, onOpen, onPreviewImage, onPasteReference, onUndo, onRedo, onImportVcs, onRefreshVcs, onKeepAll, onRevertAll, onAckRedoCleared, collapseSidebar, t, }: PendingPanelProps): import("react").JSX.Element;
 export {};

package/lib/types/client/locales.d.ts

@@ -59,6 +59,8 @@ export declare const zh: {
     'panel.key.openSearch': string;
     'panel.key.searchNext': string;
     'panel.key.searchPrev': string;
+    'panel.key.matchCase': string;
+    'panel.key.matchWholeWord': string;
     'panel.key.undo': string;
     'panel.key.redo': string;
     'panel.key.cycleNext': string;
@@ -116,6 +118,18 @@ export declare const zh: {
     'status.missing': string;
     'panel.resolvedAsk': string;
     'panel.keepInList': string;
+    'panel.fileKeptAsk': string;
+    'panel.fileRevertedAsk': string;
+    'panel.confirmFileRemove': string;
+    'panel.confirmFileRemoveDesc': string;
+    'action.refreshVcs': string;
+    'action.matchCase': string;
+    'action.matchWholeWord': string;
+    'panel.refreshDone': string;
+    'panel.refreshUnchanged': string;
+    'panel.refreshNone': string;
+    'panel.refreshUntrackedHint': string;
+    'panel.refreshFailed': string;
 };
 /** Translation keys owned by the pending-edit review namespace. */
 export type DiffApprovalKey = keyof typeof zh;
@@ -184,6 +198,8 @@ export declare const en: {
     'panel.key.openSearch': string;
     'panel.key.searchNext': string;
     'panel.key.searchPrev': string;
+    'panel.key.matchCase': string;
+    'panel.key.matchWholeWord': string;
     'panel.key.undo': string;
     'panel.key.redo': string;
     'panel.key.cycleNext': string;
@@ -241,4 +257,16 @@ export declare const en: {
     'status.missing': string;
     'panel.resolvedAsk': string;
     'panel.keepInList': string;
+    'panel.fileKeptAsk': string;
+    'panel.fileRevertedAsk': string;
+    'panel.confirmFileRemove': string;
+    'panel.confirmFileRemoveDesc': string;
+    'action.refreshVcs': string;
+    'action.matchCase': string;
+    'action.matchWholeWord': string;
+    'panel.refreshDone': string;
+    'panel.refreshUnchanged': string;
+    'panel.refreshNone': string;
+    'panel.refreshUntrackedHint': string;
+    'panel.refreshFailed': string;
 };

package/lib/types/client/port.d.ts

@@ -5,17 +5,17 @@
  * @module dsh-diff-approval/client/port
  */
 import type { ClientConnectionRpc, SessionId } from '@deepseek-ai/dsh-client-connection/client';
-import type { DiffApprovalActionValue, DiffApprovalBlockRange, DiffApprovalBulkValue, DiffApprovalListValue, DiffApprovalOpenAction, DiffApprovalOpenValue, DiffApprovalPreviewImageValue, VcsImportValue } from '../types.ts';
+import type { DiffApprovalActionValue, DiffApprovalBlockRange, DiffApprovalBulkValue, DiffApprovalListValue, DiffApprovalOpenAction, DiffApprovalOpenValue, DiffApprovalPreviewImageValue, DiffApprovalRefreshValue, VcsImportValue } from '../types.ts';
 /** The channel the host half registers and this port calls. */
 export declare const DIFF_APPROVAL_CHANNEL = "/diff-approval";
 /** This package's business verbs over the review channel. */
 export interface DiffApprovalPort {
     /** Read one session's pending entries (plus its workspace root), oldest capture first. */
     list(sessionId: SessionId): Promise<DiffApprovalListValue>;
-    /** Keep one operation. */
-    keep(sessionId: SessionId, id: string): Promise<DiffApprovalActionValue>;
-    /** Revert one operation. */
-    revert(sessionId: SessionId, id: string): Promise<DiffApprovalActionValue>;
+    /** Keep one operation. `keepListed` leaves the resolved entry in the list. */
+    keep(sessionId: SessionId, id: string, keepListed?: boolean): Promise<DiffApprovalActionValue>;
+    /** Revert one operation. `keepListed` leaves the resolved entry in the list. */
+    revert(sessionId: SessionId, id: string, keepListed?: boolean): Promise<DiffApprovalActionValue>;
     /** Keep one diff block (accept its change into the tracked baseline). */
     blockKeep(sessionId: SessionId, id: string, block: DiffApprovalBlockRange, removeWhenResolved?: boolean): Promise<DiffApprovalActionValue>;
     /** Revert one diff block (restore its old lines in the file). */
@@ -26,6 +26,8 @@ export interface DiffApprovalPort {
     redo(sessionId: SessionId): Promise<DiffApprovalActionValue>;
     /** Import the workspace's local VCS changes as pending entries. */
     importVcs(sessionId: SessionId, includeUntracked: boolean): Promise<VcsImportValue>;
+    /** Replace one entry's diff with the file's current local VCS change. */
+    refreshVcs(sessionId: SessionId, id: string, includeUntracked: boolean): Promise<DiffApprovalRefreshValue>;
     /** Open one file with its default application or reveal it in the folder. */
     open(sessionId: SessionId, id: string, action: DiffApprovalOpenAction): Promise<DiffApprovalOpenValue>;
     /** Keep every pending entry of one session in a single host call (one batch). */

package/lib/types/client/search.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The in-file search matcher, shared by the unified diff and the split view so
+ * both highlight and count the same occurrences.
+ * @module dsh-diff-approval/client/search
+ */
+/** Which occurrences an in-file search accepts. */
+export interface SearchOptions {
+    /** Match the query's letter case exactly. */
+    caseSensitive: boolean;
+    /** Accept only whole words (no identifier character touching either end). */
+    wholeWord: boolean;
+}
+/** The plain search: case-insensitive, substring. */
+export declare const DEFAULT_SEARCH_OPTIONS: SearchOptions;
+/**
+ * Character ranges of every occurrence of `query` in `text` that the options
+ * accept. Case-insensitive and substring-based unless narrowed.
+ * @param text - the line to search.
+ * @param query - the search text; empty matches nothing.
+ * @param options - case and whole-word narrowing.
+ * @returns `[start, end)` ranges in ascending order.
+ */
+export declare function matchRangesOf(text: string, query: string, options?: SearchOptions): [number, number][];

package/lib/types/client/settings.d.ts

@@ -36,6 +36,31 @@ export declare function setPasteOnCopyEnabled(value: boolean): void;
 export declare function includeUntrackedEnabled(): boolean;
 /** Persist the import-untracked preference. */
 export declare function setIncludeUntrackedEnabled(value: boolean): void;
+/**
+ * Whether a whole-file keep/revert asks before dropping the resolved file from
+ * the list. Defaults to on; only an explicit `'0'` disables it, which then
+ * removes the file straight away.
+ * @returns whether the remove prompt is enabled.
+ */
+export declare function confirmFileRemoveEnabled(): boolean;
+/** Persist the whole-file remove-prompt preference. */
+export declare function setConfirmFileRemoveEnabled(value: boolean): void;
+/**
+ * Whether the in-file search matches letter case exactly. Defaults to off, so a
+ * plain query keeps matching either case; only an explicit `'1'` turns it on.
+ * @returns whether the search is case-sensitive.
+ */
+export declare function searchCaseSensitive(): boolean;
+/** Persist the search case-sensitivity preference. */
+export declare function setSearchCaseSensitive(value: boolean): void;
+/**
+ * Whether the in-file search only matches whole words. Defaults to off; only an
+ * explicit `'1'` enables it.
+ * @returns whether the search matches whole words only.
+ */
+export declare function searchWholeWord(): boolean;
+/** Persist the search whole-word preference. */
+export declare function setSearchWholeWord(value: boolean): void;
 /**
  * Whether lines wrap (auto-wrap) in the diff for one highlight language.
  * Defaults to off; only an explicit `'1'` enables it. Stored per language, so

package/lib/types/client/slots.d.ts

@@ -1,7 +1,7 @@
 /** The panel's injected business face and its observable snapshot. */
 import type { HostObservable } from '@deepseek-ai/dsh-client-ui-slots';
 import type { SessionId } from '@deepseek-ai/dsh-client-connection/client';
-import type { DiffApprovalBlockRange, DiffApprovalOpenAction, PendingFileDiff, VcsImportValue } from '../types.ts';
+import type { DiffApprovalBlockRange, DiffApprovalOpenAction, DiffApprovalRefreshValue, PendingFileDiff, VcsImportValue } from '../types.ts';
 /** What the panel reads and drives: the pending list plus in-flight entries. */
 export interface PendingDiffSnapshot {
     /** Whether a list read has completed at least once. */
@@ -29,10 +29,11 @@ export interface PendingPanelFace {
     };
     /** Read the pending list for the current session into the snapshot. */
     onRefresh: (sessionId: SessionId | undefined) => void;
-    /** Keep one operation (remove it from the pending list). */
-    onKeep: (sessionId: SessionId, id: string) => Promise<void>;
-    /** Revert one operation (restore its prior content, or remove a created file). */
-    onRevert: (sessionId: SessionId, id: string) => Promise<void>;
+    /** Keep one operation. `keepListed` leaves the resolved entry in the list. */
+    onKeep: (sessionId: SessionId, id: string, keepListed?: boolean) => Promise<void>;
+    /** Revert one operation (restore its prior content, or remove a created file).
+     *  `keepListed` leaves the resolved entry in the list. */
+    onRevert: (sessionId: SessionId, id: string, keepListed?: boolean) => Promise<void>;
     /** Keep one diff block (accept its change into the tracked baseline). */
     onBlockKeep: (sessionId: SessionId, id: string, block: DiffApprovalBlockRange, removeWhenResolved?: boolean) => Promise<void>;
     /** Revert one diff block (restore its old lines in the file). */
@@ -50,6 +51,9 @@ export interface PendingPanelFace {
     onRedo: (sessionId: SessionId) => Promise<string | undefined>;
     /** Import the workspace's local VCS changes as pending entries (detection included). */
     onImportVcs: (sessionId: SessionId, includeUntracked: boolean) => Promise<VcsImportValue>;
+    /** Replace one entry's diff with the file's current local VCS change, then
+     *  refresh the list; resolves to what the scan found. */
+    onRefreshVcs: (sessionId: SessionId, id: string, includeUntracked: boolean) => Promise<DiffApprovalRefreshValue>;
     /** Keep every pending entry of one session in a single host call (bulk). */
     onKeepAll: (sessionId: SessionId) => Promise<void>;
     /** Revert every pending entry of one session in a single host call (bulk). */

package/lib/types/client/split-diff.d.ts

@@ -8,6 +8,7 @@
  * @module dsh-diff-approval/client/split-diff
  */
 import type { WholeFileDiffRow } from './whole-file-diff.ts';
+import type { SearchOptions } from './search.ts';
 /** One side of a split pair: text plus its 1-based line number (absent on a pure add). */
 export interface SplitSide {
     /** The side's source line content, without the terminating newline. */
@@ -43,12 +44,13 @@ export interface SplitDiff {
  */
 export declare function computeSideBySideDiff(rows: readonly WholeFileDiffRow[], alignBySimilarity?: boolean): SplitDiff;
 /**
- * Pair indices whose left or right text contains the query (case-insensitive).
- * A pair counts once however many times the query appears, so split search
- * highlights the whole pair on both columns and a single "current" pair is
- * stepped through — not each individual left/right occurrence.
+ * Pair indices whose left or right text matches the query. A pair counts once
+ * however many times the query appears, so split search highlights the whole pair
+ * on both columns and a single "current" pair is stepped through — not each
+ * individual left/right occurrence.
  * @param pairs - the split pairs.
  * @param query - the query text; an empty query matches nothing.
+ * @param options - case and whole-word narrowing.
  * @returns matching pair indices, in file order.
  */
-export declare function searchPairs(pairs: readonly SplitPair[], query: string): number[];
+export declare function searchPairs(pairs: readonly SplitPair[], query: string, options?: SearchOptions): number[];

package/lib/types/client/store.d.ts

@@ -7,17 +7,17 @@
  */
 import type { SessionId } from '@deepseek-ai/dsh-client-connection/client';
 import type { HostObservable } from '@deepseek-ai/dsh-client-ui-slots';
-import type { DiffApprovalBlockRange, DiffApprovalOpenAction, VcsImportValue } from '../types.ts';
+import type { DiffApprovalBlockRange, DiffApprovalOpenAction, DiffApprovalRefreshValue, VcsImportValue } from '../types.ts';
 import type { PendingDiffSnapshot } from './slots.ts';
 import type { DiffApprovalPort } from './port.ts';
 /** The observable the panel reads and the plugin body drives. */
 export interface PendingDiffStore extends HostObservable<PendingDiffSnapshot> {
     /** Re-read one session's pending list (an absent session empties the view). */
     refresh: (sessionId: SessionId | undefined) => Promise<void>;
-    /** Keep one operation. */
-    keep: (sessionId: SessionId, id: string) => Promise<void>;
-    /** Revert one operation. */
-    revert: (sessionId: SessionId, id: string) => Promise<void>;
+    /** Keep one operation. `keepListed` leaves the resolved entry in the list. */
+    keep: (sessionId: SessionId, id: string, keepListed?: boolean) => Promise<void>;
+    /** Revert one operation. `keepListed` leaves the resolved entry in the list. */
+    revert: (sessionId: SessionId, id: string, keepListed?: boolean) => Promise<void>;
     /** Keep one diff block, then refresh so the entry's diff reflects the accept. */
     blockKeep: (sessionId: SessionId, id: string, block: DiffApprovalBlockRange, removeWhenResolved?: boolean) => Promise<void>;
     /** Revert one diff block, then refresh so the entry's diff reflects the undo. */
@@ -28,6 +28,9 @@ export interface PendingDiffStore extends HostObservable<PendingDiffSnapshot> {
     redo: (sessionId: SessionId) => Promise<string | undefined>;
     /** Import the workspace's local VCS changes as pending entries, then refresh. */
     importVcs: (sessionId: SessionId, includeUntracked: boolean) => Promise<VcsImportValue>;
+    /** Replace one entry's diff with the file's current local VCS change, then
+     *  refresh; resolves to what the scan found. */
+    refreshVcs: (sessionId: SessionId, id: string, includeUntracked: boolean) => Promise<DiffApprovalRefreshValue>;
     /** Open one file with its default application or reveal it in the folder. */
     open: (sessionId: SessionId, id: string, action: DiffApprovalOpenAction) => Promise<void>;
     /** Keep every pending entry of one session in a single host call, then refresh. */

package/lib/types/index.d.ts

@@ -35,7 +35,7 @@
  */
 import { Context } from '@deepseek-ai/cordis';
 import type { DiffApprovalOpenAction } from './types.ts';
-export type { DiffApprovalActionOutcome, DiffApprovalActionValue, DiffApprovalBlockRange, DiffApprovalBlockTarget, DiffApprovalListValue, DiffApprovalOpenAction, DiffApprovalOpenValue, PendingEntry, PendingEntryKind, PendingFileDiff, } from './types.ts';
+export type { DiffApprovalActionOutcome, DiffApprovalActionValue, DiffApprovalBlockRange, DiffApprovalBlockTarget, DiffApprovalListValue, DiffApprovalOpenAction, DiffApprovalOpenValue, DiffApprovalRefreshOutcome, DiffApprovalRefreshValue, PendingEntry, PendingEntryKind, PendingFileDiff, } from './types.ts';
 export { PendingDiffStore } from './pending.ts';
 export { PendingPersistence, defaultStorageDir } from './persist.ts';
 export { defaultOpenPath } from './open.ts';

package/lib/types/types.d.ts

@@ -123,6 +123,22 @@ export interface DiffApprovalBulkValue {
     /** How many pending entries were kept/reverted (0 when the session had none). */
     affected: number;
 }
+/** What one file's VCS refresh found. */
+export type DiffApprovalRefreshOutcome = 
+/** The tracked diff was replaced with the file's current VCS change. */
+'refreshed'
+/** A VCS change exists but matches what the entry already tracks. */
+ | 'unchanged'
+/** The file has no local VCS change (untracked-and-excluded, or already clean). */
+ | 'no-change'
+/** No pending entry existed for the id. */
+ | 'missing'
+/** The workspace is not inside a git/svn/p4 checkout. */
+ | 'no-vcs';
+/** Value returned by the channel's vcs-refresh endpoint. */
+export interface DiffApprovalRefreshValue {
+    outcome: DiffApprovalRefreshOutcome;
+}
 /** Value returned by the channel's keep and revert endpoints. */
 export interface DiffApprovalActionValue {
     /** What the request did; `missing` means no pending entry existed. */

package/lib/types/vcs.d.ts

@@ -68,6 +68,12 @@ export interface VcsImportInput {
     workspaceRoot: string;
     /** Whether new/untracked files are imported (git `??`, svn `?`). */
     includeUntracked: boolean;
+    /**
+     * Restrict the scan to one absolute path (a file, or a directory's subtree).
+     * Absent scans the whole workspace, which is what an import does; the review
+     * panel's per-file refresh passes the file so a large tree is not rescanned.
+     */
+    scope?: string | undefined;
     shell: ShellExecutorLike;
     /** Reads working-file content (the host passes a node fs reader). */
     readText: VcsFileReader;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-diff-approval",
-  "version": "0.19.2",
+  "version": "0.19.3",
   "description": "DeepSeek Harness plugin: pending-edit review with whole-file diff and Keep/Revert",
   "packageManager": "pnpm@11.21.0",
   "author": "Wu Zhiwei",