dsh-diff-approval 0.19.2 → 0.20.0

package/lib/types/pending.d.ts

@@ -74,6 +74,16 @@ export declare class PendingDiffStore {
      * @returns whether the store changed.
      */
     restore(entry: PendingEntry): boolean;
+    /**
+     * Admit one entry into the list without the change guard {@link fold} applies.
+     * A listed entry may carry no diff at all: a path the user added by hand has
+     * no local change until one appears, and a fully-resolved file has already
+     * folded its diff away. This is the guard-free put {@link restore} performs,
+     * named for its other caller.
+     * @param entry - the entry to insert or replace by path.
+     * @returns whether the store changed.
+     */
+    insert(entry: PendingEntry): boolean;
     /**
      * Merge persisted entries into the store, one per path after folding. A live
      * entry wins over a persisted one only when its time is newer (folders are

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. */
@@ -133,3 +149,54 @@ export interface DiffApprovalActionValue {
      * block (the entry stays listed with no pending diff). */
     resolved?: boolean | undefined;
 }
+/** One row of a browsed directory level. */
+export interface DiffApprovalBrowseEntry {
+    /** Base name inside the listed directory. */
+    name: string;
+    /** What the child is; `other` covers anything neither file nor directory. */
+    type: 'file' | 'directory' | 'other';
+    /** Absolute host path — the same value `add-path` takes, so the panel can show
+     *  (and add) exactly what a row names. */
+    path: string;
+    /** Byte size, present only for a regular file the backend reports. */
+    size?: number | undefined;
+}
+/** Value returned by the channel's list-path endpoint: one directory level. */
+export interface DiffApprovalBrowseValue {
+    /** The listed directory's absolute path. */
+    path: string;
+    /** Direct children: directories first, then files, each name-sorted. */
+    entries: DiffApprovalBrowseEntry[];
+    /** The response hit the entry cap, so children are missing from `entries`. */
+    truncated: boolean;
+}
+/** What one hand-added path did. */
+export type DiffApprovalAddOutcome = 
+/** At least one entry landed in the list (a directory can add many). */
+'added'
+/** Everything scanned was already listed; nothing changed. */
+ | 'duplicate'
+/** The path has no local VCS change and the caller did not ask to add those. */
+ | 'unchanged'
+/** A directory scan found nothing to add and nothing was listed already. */
+ | 'empty'
+/** The path does not exist (or is neither a file nor a directory). */
+ | 'missing'
+/** The path lies outside the session's workspace. */
+ | 'outside'
+/** The workspace is not inside a git/svn/p4 checkout. */
+ | 'no-vcs'
+/** The scan itself failed; `message` carries the reason. */
+ | 'failed';
+/** Value returned by the channel's add-path endpoint. */
+export interface DiffApprovalAddValue {
+    outcome: DiffApprovalAddOutcome;
+    /** How many entries the add put into the list. */
+    added: number;
+    /** How many scanned paths were already listed (left untouched). */
+    duplicates: number;
+    /** Whether the no-change walk hit its file cap, so some files were not added. */
+    truncated?: boolean | undefined;
+    /** Failure detail for `outcome: 'failed'`. */
+    message?: string | undefined;
+}

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.20.0",
   "description": "DeepSeek Harness plugin: pending-edit review with whole-file diff and Keep/Revert",
   "packageManager": "pnpm@11.21.0",
   "author": "Wu Zhiwei",