@xbzbing/dsh-git-panel 1.6.2 → 1.7.0

package/lib/host/types.d.ts

@@ -72,6 +72,9 @@ export interface GitRemote {
     /** Known-host classification, for the status-bar icon. */
     readonly hostKind: RemoteHostKind;
 }
+/** Why the change list is incomplete: capped at `maxChanges`, or the status
+ * stream itself was clipped (a lossy read drops the head). */
+export type TruncationReason = 'cap' | 'lossy';
 /** Immutable snapshot of one repository's status at `checkedAt`. */
 export interface GitSnapshot {
     /** Realpath of the repository root (work tree top). */
@@ -97,8 +100,14 @@ export interface GitSnapshot {
     readonly changes: readonly GitChange[];
     /** Working-tree statistics for the changes-page header (single source). */
     readonly stats: WorktreeStats;
-    /** True when the change list was capped at maxChanges. */
+    /** True when the change list is incomplete (capped or clipped). */
     readonly truncated: boolean;
+    /** Which limit produced `truncated`; absent on older hosts. */
+    readonly truncatedReason?: TruncationReason;
+    /** True when untracked files fell back to git's collapsed `?? dir/` entries
+     * because expanding them would overflow `maxChanges` (or the status stream).
+     * Older hosts never set it. */
+    readonly untrackedCollapsed?: boolean;
     /** Polling interval the client should use after this snapshot (0 = off). */
     readonly refreshIntervalMs: number;
     /** Whether the input-bar git marker pill should render (user preference). */
@@ -109,6 +118,9 @@ export interface GitSnapshot {
     readonly graphStyle: GraphStyle;
     /** Whether the commit box shows the AI-suggest button (user preference). */
     readonly suggestEnabled: boolean;
+    /** SHA-256 of the final business snapshot, excluding checkedAt and itself.
+     * Optional for compatibility with hosts that do not provide fingerprints. */
+    readonly stateFingerprint?: string;
     /** Epoch millis of the snapshot. */
     readonly checkedAt: number;
 }
@@ -119,9 +131,15 @@ export interface GitCommit {
     readonly author: string;
     readonly dateIso: string;
 }
-/** A commit with parent links and ref decorations (graph rendering). */
-export interface GraphCommit extends GitCommit {
+/** One node of the commit graph's raw ancestry: a full hash and its raw parent
+ * hashes. `parents` is empty for a true root — and equally for a shallow
+ * boundary, which git cannot tell apart from a root. */
+export interface GitGraphNode {
+    readonly hash: string;
     readonly parents: readonly string[];
+}
+/** A commit with parent links and ref decorations (graph rendering). */
+export interface GraphCommit extends GitCommit, GitGraphNode {
     readonly refs: readonly GitRef[];
 }
 export interface GitRef {
@@ -210,7 +228,7 @@ export type GitAction = {
 /** `git reset` modes, from least to most destructive. Single source so the
  * client dialog and the command builder cannot drift. */
 export type ResetMode = 'soft' | 'mixed' | 'hard';
-export type GitErrorCode = 'cwd-unavailable' | 'not-a-git-repo' | 'git-unavailable' | 'invalid-path' | 'invalid-name' | 'invalid-index' | 'git-error' | 'timeout' | 'cancelled' | 'empty-message' | 'local-changes-block' | 'not-ff' | 'push-rejected' | 'auth-failed' | 'conflict' | 'revert-conflict' | 'revert-stuck' | 'revert-merge' | 'not-found' | 'branch-in-use' | 'stash-switch-failed' | 'index-busy' | 'empty-diff' | 'llm-unavailable' | 'llm-error' | 'llm-output' | 'suggest-disabled';
+export type GitErrorCode = 'cwd-unavailable' | 'not-a-git-repo' | 'git-unavailable' | 'invalid-path' | 'invalid-name' | 'invalid-index' | 'git-error' | 'timeout' | 'cancelled' | 'empty-message' | 'local-changes-block' | 'not-ff' | 'push-rejected' | 'auth-failed' | 'conflict' | 'revert-conflict' | 'revert-stuck' | 'revert-merge' | 'not-found' | 'branch-in-use' | 'stash-switch-failed' | 'index-busy' | 'nested-repo' | 'nested-repo-partial' | 'empty-diff' | 'llm-unavailable' | 'llm-error' | 'llm-output' | 'suggest-disabled';
 export type GitActionResult = {
     readonly ok: true;
     readonly snapshot: GitSnapshot;
@@ -226,6 +244,16 @@ export interface GitActionRequest {
     readonly sessionId: string;
     readonly action: GitAction;
 }
+/**
+ * True when a history `search` is a commit-hash prefix jump rather than a
+ * message regex: 7–40 hex chars after trimming.
+ */
+export declare function isHistoryHashSearch(search: string): boolean;
+/** Whether Git's effective content filters hide commits; hash jumps ignore them.
+ * Shared with clients receiving history from a host that omits topology. */
+export declare function isHistoryFiltered(query: Pick<Extract<GitQuery, {
+    kind: 'history';
+}>, 'search' | 'author' | 'since'>): boolean;
 export type GitQuery = {
     readonly kind: 'history';
     readonly limit: number;
@@ -357,6 +385,11 @@ export type GitQueryResult = {
     readonly kind: 'history';
     readonly commits: readonly GraphCommit[];
     readonly total: number;
+    /** Raw ancestry for a filtered page: the page's commits plus the ancestors
+     * an effective search/author/since filter hid from the page itself. Absent
+     * when no effective filter is active (or on a hash jump); `[]` means the
+     * bounded auxiliary walk failed, so the graph is incomplete. */
+    readonly topology?: readonly GitGraphNode[];
 }
 /**
  * Unified diff text plus the new-side line count. The count is the fact the
@@ -481,6 +514,14 @@ export type GitQueryResult = {
     /** Modification time (epoch ms) from the same stat (all variants). */
     readonly mtimeMs?: number;
 };
+/**
+ * Byte envelope of the file browser's "copy file content" action: a text
+ * document is copyable strictly below this size. Shared by both halves —
+ * the host floors its text read here (so every copyable document can
+ * actually load) and the client hides the copy button at/above it, keeping
+ * one boundary for load and copy.
+ */
+export declare const FILE_COPY_MAX_BYTES: number;
 export type GitQueryResponse = {
     readonly ok: true;
     readonly value: GitQueryResult;

package/lib/host/types.js

@@ -2,8 +2,16 @@ const DIFF_CONTEXT_DEFAULT = 3;
 const DIFF_CONTEXT_MAX = 1e5;
 const DIFF_EXPAND_CONTEXT = 2e3;
 const DIFF_COUNT_READ_MAX = 8 * 1024 * 1024;
+function isHistoryHashSearch(search) {
+  return /^[0-9a-fA-F]{7,40}$/.test(search.trim());
+}
+function isHistoryFiltered(query) {
+  const search = query.search?.trim() ?? "";
+  return !isHistoryHashSearch(search) && (search !== "" || (query.author ?? "") !== "" || (query.since ?? "") !== "");
+}
+const FILE_COPY_MAX_BYTES = 10 * 1024 * 1024;
 const SUGGEST_LIMITS = {
-  maxBytes: { min: 16 * 1024, max: 512 * 1024, default: 128 * 1024 },
+  maxBytes: { min: 16 * 1024, max: 512 * 1024, default: 200 * 1024 },
   maxOutputTokens: { min: 256, max: 16384, default: 4096 },
   timeoutMs: { min: 5e3, max: 12e4, default: 15e3 }
 };
@@ -32,9 +40,12 @@ export {
   DIFF_CONTEXT_MAX,
   DIFF_COUNT_READ_MAX,
   DIFF_EXPAND_CONTEXT,
+  FILE_COPY_MAX_BYTES,
   IMAGE_MIME,
   SUGGEST_LANGUAGES,
   SUGGEST_LANGUAGE_DEFAULT,
   SUGGEST_LIMITS,
-  imageMimeFor
+  imageMimeFor,
+  isHistoryFiltered,
+  isHistoryHashSearch
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbzbing/dsh-git-panel",
-  "version": "1.6.2",
+  "version": "1.7.0",
   "description": "DeepSeek Harness (dsh) plugin: an IDE-style Git panel in the Web GUI — branch/history overview, uncommitted changes with commit & amend, diff stats, and a zsh-style branch marker in the input bar.",
   "type": "module",
   "license": "MIT",
@@ -43,7 +43,7 @@
     "build": "node build.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test:unit": "node build.mjs && node --test --test-force-exit test/unit/*.test.mjs",
-    "test:e2e": "node build.mjs && node test/e2e/setup.mjs && node test/e2e/run.mjs && node test/e2e/run2.mjs && node test/e2e/run3.mjs && node test/e2e/run4.mjs && node test/e2e/run5.mjs",
+    "test:e2e": "node build.mjs && node test/e2e/setup.mjs && node test/e2e/all.mjs",
     "test": "npm run test:unit && npm run test:e2e",
     "check": "npm run typecheck && npm run test && git diff --exit-code -- lib/"
   },