@xbzbing/dsh-git-panel 1.2.0 → 1.4.0

package/lib/host/types.d.ts

@@ -5,6 +5,10 @@
  */
 /** Diff layout: `unified` = single inline column, `split` = side-by-side. */
 export type DiffViewMode = 'unified' | 'split';
+/** Commit-graph line style: `compact` = converge a shared ancestor into one
+ * lane (git log --graph); `parallel` = keep each merge's first parent in its
+ * own lane, converging only at the ancestor (VSCode / GUI tools). */
+export type GraphStyle = 'compact' | 'parallel';
 /** Wire request: the browser sends only session identity, never a path. */
 export interface GitSnapshotRequest {
     readonly sessionId: string;
@@ -62,6 +66,10 @@ export interface GitSnapshot {
     readonly showInputPill: boolean;
     /** Default diff layout the views open with (user preference). */
     readonly defaultDiffView: DiffViewMode;
+    /** Commit-graph line style (user preference). */
+    readonly graphStyle: GraphStyle;
+    /** Whether the commit box shows the AI-suggest button (user preference). */
+    readonly suggestEnabled: boolean;
     /** Epoch millis of the snapshot. */
     readonly checkedAt: number;
 }
@@ -120,8 +128,41 @@ export type GitAction = {
     readonly name: string;
 } | {
     readonly kind: 'fetch';
+} | {
+    readonly kind: 'tag-create';
+    readonly name: string;
+    readonly commit: string;
+    readonly message?: string;
+} | {
+    readonly kind: 'tag-delete';
+    readonly name: string;
+} | {
+    readonly kind: 'stash-push';
+    readonly message?: string;
+} | {
+    readonly kind: 'stash-apply';
+    readonly index: number;
+    readonly sha: string;
+} | {
+    readonly kind: 'stash-pop';
+    readonly index: number;
+    readonly sha: string;
+} | {
+    readonly kind: 'stash-drop';
+    readonly index: number;
+    readonly sha: string;
+} | {
+    readonly kind: 'revert';
+    readonly commit: string;
+} | {
+    readonly kind: 'reset';
+    readonly commit: string;
+    readonly mode: ResetMode;
 };
-export type GitErrorCode = 'cwd-unavailable' | 'not-a-git-repo' | 'git-unavailable' | 'invalid-path' | 'invalid-name' | 'git-error' | 'timeout' | 'cancelled' | 'empty-message' | 'local-changes-block';
+/** `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' | 'conflict' | 'revert-conflict' | 'revert-stuck' | 'revert-merge' | 'not-found' | 'index-busy' | 'empty-diff' | 'llm-unavailable' | 'llm-error' | 'llm-output' | 'suggest-disabled';
 export type GitActionResult = {
     readonly ok: true;
     readonly snapshot: GitSnapshot;
@@ -195,6 +236,8 @@ export type GitQuery = {
     readonly kind: 'branches';
 } | {
     readonly kind: 'tags';
+} | {
+    readonly kind: 'stash-list';
 } | {
     readonly kind: 'authors';
 } | {
@@ -222,6 +265,19 @@ export interface GitBranch {
     readonly ahead?: number;
     readonly behind?: number;
 }
+/** One entry in the stash stack (`git stash list`). */
+export interface StashEntry {
+    /** Stack position (0 = most recent). */
+    readonly index: number;
+    /** The stash commit SHA — a stable id the index position is not (see run). */
+    readonly sha: string;
+    /** The stash message (custom `-m` text, or the auto "WIP on …" subject). */
+    readonly message: string;
+    /** Branch the stash was taken on; null when it could not be parsed. */
+    readonly branch: string | null;
+    /** Human relative time (e.g. "2 hours ago"). */
+    readonly relTime: string;
+}
 /** Working-tree statistics for the changes page header. */
 export interface WorktreeStats {
     /** Distinct changed-file paths (staged ∪ modified ∪ untracked). */
@@ -237,6 +293,13 @@ export interface WorktreeStats {
     readonly lastChangeAt: number | null;
     /** HEAD commit time ISO; null when unborn. */
     readonly headCommittedAt: string | null;
+    /**
+     * True when the per-file fan-outs were skipped because the change set was too
+     * large (issue #16): `insertions` then omits untracked lines and
+     * `lastChangeAt` is null. Counts (fileCount/staged/modified/untracked) and
+     * tracked insertions/deletions stay exact.
+     */
+    readonly partial: boolean;
 }
 export type GitQueryResult = {
     readonly kind: 'history';
@@ -284,6 +347,9 @@ export type GitQueryResult = {
 } | {
     readonly kind: 'tags';
     readonly tags: readonly GitBranch[];
+} | {
+    readonly kind: 'stash-list';
+    readonly entries: readonly StashEntry[];
 } | {
     readonly kind: 'authors';
     readonly authors: readonly string[];
@@ -325,6 +391,34 @@ export interface GitQueryRequest {
     readonly sessionId: string;
     readonly query: GitQuery;
 }
+/**
+ * Wire request for the suggest endpoint: ask the configured model to write a
+ * commit message from the repository's uncommitted changes. `paths` restricts
+ * the diff to the user's selection (bare repo-relative paths); absent means
+ * all uncommitted changes.
+ */
+export interface GitSuggestRequest {
+    readonly sessionId: string;
+    readonly paths?: readonly string[];
+}
+export type GitSuggestResult = {
+    readonly ok: true;
+    readonly value: {
+        /** The generated message, ready for the user to edit and commit. */
+        readonly message: string;
+        /** Actual provider/model route used (display only). */
+        readonly provider?: string;
+        readonly model?: string;
+        /** The diff exceeded the model input cap and was truncated. */
+        readonly truncated?: boolean;
+    };
+} | {
+    readonly ok: false;
+    readonly error: {
+        readonly code: GitErrorCode;
+        readonly message?: string;
+    };
+};
 /**
  * Extensions the image-diff query serves, mapped to MIME types. Part of the
  * query's contract, so both halves gate on this one list and cannot drift.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbzbing/dsh-git-panel",
-  "version": "1.2.0",
+  "version": "1.4.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",
@@ -42,7 +42,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",
+    "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",
     "test": "npm run test:unit && npm run test:e2e",
     "check": "npm run typecheck && npm run test && git diff --exit-code -- lib/"
   },