@xbzbing/dsh-git-panel 0.1.0

package/lib/host/parser.d.ts

@@ -0,0 +1,28 @@
+/**
+ * git output parsers: porcelain status, log, branch, numstat, name-status.
+ * Pure functions over raw stdout, no I/O.
+ */
+import type { GitBranch, GitChange, GitFileStat, GraphCommit, GitRef } from './types.ts';
+/**
+ * Parse `git status --porcelain=v1 -z`. A mixed XY (both non-space, e.g. MM)
+ * is split into a staged side (X) and an unstaged side (Y). Untracked (??) is
+ * a single unstaged entry. Real conflicts (UU/AA/DD…) stay one entry.
+ */
+export declare function parseStatus(stdout: string): GitChange[];
+/**
+ * Parse a graph log emitted with the record format:
+ *   %H%x1f%h%x1f%P%x1f%an%x1f%aI%x1f%D%x1f%s%x1e
+ * (unit sep 0x1f between fields, record sep 0x1e between commits.)
+ */
+export declare function parseGraphLog(stdout: string): GraphCommit[];
+/** Parse the `%D` decoration into structured refs. */
+export declare function parseRefs(decoration: string): GitRef[];
+/** Parse `git for-each-ref` local/remote branch lines: `name\0shortHash\0track`. */
+export declare function parseBranches(stdout: string): GitBranch[];
+/** Parse `git show --name-status -z` file lines into stats. */
+export declare function parseNameStatus(stdout: string): GitFileStat[];
+/** Sum `git diff --numstat` output: { insertions, deletions }. Binary rows ("-") skipped. */
+export declare function sumNumstat(stdout: string): {
+    insertions: number;
+    deletions: number;
+};

package/lib/host/queries.d.ts

@@ -0,0 +1,3 @@
+import type { SnapshotDeps, GitPanelConfig } from './core.ts';
+import type { GitQueryRequest, GitQueryResponse } from './types.ts';
+export declare function runQuery(deps: SnapshotDeps, config: GitPanelConfig, request: GitQueryRequest): Promise<GitQueryResponse>;

package/lib/host/types.d.ts

@@ -0,0 +1,289 @@
+/**
+ * dsh-git-panel host wire data model — the authoritative type source.
+ * The client half (src/client/rpc.ts) reuses these types directly, so the
+ * wire contract has a single definition and cannot drift.
+ */
+/** Wire request: the browser sends only session identity, never a path. */
+export interface GitSnapshotRequest {
+    readonly sessionId: string;
+}
+export type GitSnapshotResult = {
+    readonly ok: true;
+    readonly value: GitSnapshot;
+} | {
+    readonly ok: false;
+    readonly error: GitFailure;
+};
+export type GitFailure = {
+    readonly code: 'session-not-found';
+    readonly sessionId: string;
+} | {
+    readonly code: 'cwd-unavailable';
+    readonly sessionId: string;
+} | {
+    readonly code: 'not-a-git-repo';
+    readonly cwd?: string;
+    readonly showInputPill?: boolean;
+} | {
+    readonly code: 'git-unavailable';
+    readonly detail: string;
+} | {
+    readonly code: 'timeout';
+};
+/** Immutable snapshot of one repository's status at `checkedAt`. */
+export interface GitSnapshot {
+    /** Realpath of the repository root (work tree top). */
+    readonly root: string;
+    /** Current branch name; null when detached. */
+    readonly branch: string | null;
+    /** Short HEAD hash; null when the repository has no commits (unborn). */
+    readonly head: string | null;
+    /** True when the repository has no commits yet. */
+    readonly unborn: boolean;
+    /** staged + modified + untracked > 0. */
+    readonly dirty: boolean;
+    readonly staged: number;
+    readonly modified: number;
+    readonly untracked: number;
+    readonly ahead: number;
+    readonly behind: number;
+    readonly lastCommit: GitCommit | null;
+    readonly changes: readonly GitChange[];
+    /** True when the change list was capped at maxChanges. */
+    readonly truncated: 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). */
+    readonly showInputPill: boolean;
+    /** Epoch millis of the snapshot. */
+    readonly checkedAt: number;
+}
+export interface GitCommit {
+    readonly hash: string;
+    readonly shortHash: string;
+    readonly subject: string;
+    readonly author: string;
+    readonly dateIso: string;
+}
+/** A commit with parent links and ref decorations (graph rendering). */
+export interface GraphCommit extends GitCommit {
+    readonly parents: readonly string[];
+    readonly refs: readonly GitRef[];
+}
+export interface GitRef {
+    readonly kind: 'branch' | 'remote' | 'tag';
+    readonly name: string;
+    /** True for the `HEAD -> name` current branch. */
+    readonly head: boolean;
+}
+export type GitChangeStatus = 'added' | 'modified' | 'deleted' | 'renamed' | 'untracked' | 'conflicted' | 'typechange';
+/**
+ * One changed-file entry. A mixed porcelain XY (e.g. MM/AM) is split into two
+ * entries: a `staged: true` side (X column) and a `staged: false` side (Y
+ * column), so the UI can list "Staged" vs "Changes" IDE-style.
+ */
+export interface GitChange {
+    readonly path: string;
+    readonly status: GitChangeStatus;
+    readonly staged: boolean;
+    readonly isDirectory: boolean;
+}
+export type GitAction = {
+    readonly kind: 'stage';
+    readonly paths: readonly string[];
+} | {
+    readonly kind: 'stage-all';
+} | {
+    readonly kind: 'unstage';
+    readonly paths: readonly string[];
+} | {
+    readonly kind: 'unstage-all';
+} | {
+    readonly kind: 'discard';
+    readonly paths: readonly string[];
+} | {
+    readonly kind: 'commit';
+    readonly message: string;
+    /** Commit only these paths; absent/empty commits everything staged. */
+    readonly paths?: readonly string[];
+    /** True → git commit --amend (replace the previous commit). */
+    readonly amend?: boolean;
+} | {
+    readonly kind: 'branch-checkout';
+    readonly name: string;
+} | {
+    readonly kind: 'fetch';
+};
+export type GitErrorCode = 'session-not-found' | 'cwd-unavailable' | 'not-a-git-repo' | 'git-unavailable' | 'invalid-path' | 'invalid-name' | 'git-error' | 'timeout' | 'empty-message' | 'local-changes-block';
+export type GitActionResult = {
+    readonly ok: true;
+    readonly snapshot: GitSnapshot;
+    readonly output?: string;
+} | {
+    readonly ok: false;
+    readonly error: {
+        readonly code: GitErrorCode;
+        readonly message?: string;
+    };
+};
+export interface GitActionRequest {
+    readonly sessionId: string;
+    readonly action: GitAction;
+}
+export type GitQuery = {
+    readonly kind: 'history';
+    readonly limit: number;
+    readonly skip: number;
+    /** Optional ref filter (branch/remote/tag); absent = --all. */
+    readonly ref?: string;
+    /** Text search: 7+ hex chars = hash prefix jump; else message regex (-i -E). */
+    readonly search?: string;
+    /** Author filter (--author). */
+    readonly author?: string;
+    /** Date lower bound (--since). */
+    readonly since?: string;
+} | {
+    readonly kind: 'diff';
+    readonly path: string;
+    readonly base: 'worktree' | 'staged';
+    readonly context?: number;
+} | {
+    readonly kind: 'diff';
+    readonly path: string;
+    readonly base: 'commit';
+    readonly commit: string;
+    readonly context?: number;
+} | {
+    readonly kind: 'image-diff';
+    readonly path: string;
+    readonly base: 'worktree' | 'staged';
+} | {
+    readonly kind: 'image-diff';
+    readonly path: string;
+    readonly base: 'commit';
+    readonly commit: string;
+} | {
+    readonly kind: 'show';
+    readonly ref: string;
+} | {
+    readonly kind: 'branches';
+} | {
+    readonly kind: 'tags';
+} | {
+    readonly kind: 'authors';
+} | {
+    readonly kind: 'last-commit-message';
+} | {
+    readonly kind: 'worktree-stats';
+};
+/** One commit's changed-file line (from --name-status). */
+export interface GitFileStat {
+    readonly path: string;
+    readonly status: GitChangeStatus;
+}
+export interface GitBranch {
+    readonly name: string;
+    readonly shortHash: string | null;
+    readonly ahead?: number;
+    readonly behind?: number;
+}
+/** Working-tree statistics for the changes page header. */
+export interface WorktreeStats {
+    /** Distinct changed-file paths (staged ∪ modified ∪ untracked). */
+    readonly fileCount: number;
+    readonly staged: number;
+    readonly modified: number;
+    readonly untracked: number;
+    /** Summed added lines across worktree + index diff (binary skipped). */
+    readonly insertions: number;
+    /** Summed deleted lines. */
+    readonly deletions: number;
+    /** Max mtime (epoch ms) among changed files; null when none/unavailable. */
+    readonly lastChangeAt: number | null;
+    /** HEAD commit time ISO; null when unborn. */
+    readonly headCommittedAt: string | null;
+}
+export type GitQueryResult = {
+    readonly kind: 'history';
+    readonly commits: readonly GraphCommit[];
+    readonly total: number;
+} | {
+    readonly kind: 'diff';
+    readonly path: string;
+    readonly text: string;
+} | {
+    /**
+     * Old/new images for a binary image diff, as data URLs. The sides mirror
+     * what the text diff compares: worktree rows read index vs working file,
+     * staged rows read HEAD vs index, commit rows read parent vs commit.
+     */
+    readonly kind: 'image-diff';
+    readonly path: string;
+    /** null → the extension is not a browser-renderable image. */
+    readonly mime: string | null;
+    /** Pre-change image; absent when that side does not exist (added/untracked/root). */
+    readonly old?: string;
+    /** Post-change image; absent when that side does not exist (deleted). */
+    readonly new?: string;
+    /** A side exceeded the byte cap, so no URLs are returned. */
+    readonly tooLarge?: true;
+} | {
+    readonly kind: 'show';
+    readonly ref: string;
+    readonly commit: GitCommit | null;
+    /** Full commit body (without the subject line); right-pane comment. */
+    readonly body: string;
+    readonly stats: readonly GitFileStat[];
+} | {
+    readonly kind: 'branches';
+    readonly current: string | null;
+    readonly defaultBranch: string | null;
+    readonly local: readonly GitBranch[];
+    readonly remote: readonly GitBranch[];
+} | {
+    readonly kind: 'tags';
+    readonly tags: readonly GitBranch[];
+} | {
+    readonly kind: 'authors';
+    readonly authors: readonly string[];
+} | {
+    readonly kind: 'last-commit-message';
+    readonly message: string;
+} | {
+    readonly kind: 'worktree-stats';
+    readonly stats: WorktreeStats;
+};
+export type GitQueryResponse = {
+    readonly ok: true;
+    readonly value: GitQueryResult;
+} | {
+    readonly ok: false;
+    readonly error: {
+        readonly code: GitErrorCode;
+        readonly message?: string;
+    };
+};
+export interface GitQueryRequest {
+    readonly sessionId: string;
+    readonly query: GitQuery;
+}
+/**
+ * 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.
+ */
+export declare const IMAGE_MIME: Readonly<Record<string, string>>;
+/** MIME for a path's extension; null when it is not a served image type. */
+export declare function imageMimeFor(path: string): string | null;
+export interface GitVersionRequest {
+    /** True → query the GitHub releases API; false/absent → local view only. */
+    readonly check?: boolean;
+}
+export interface GitVersionInfo {
+    readonly current: string;
+    readonly repositoryUrl?: string;
+    readonly latest?: string;
+    readonly updateAvailable: boolean;
+    readonly releaseUrl?: string;
+    readonly checkedRemote: boolean;
+    readonly error?: string;
+}

package/lib/host/version.d.ts

@@ -0,0 +1,40 @@
+export type VersionFetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export interface VersionInfo {
+    /** Version declared in this plugin's package.json. */
+    readonly current: string;
+    /** Browsable GitHub repository URL, or undefined when it cannot be derived. */
+    readonly repositoryUrl?: string;
+    /** Latest release tag reported by GitHub, without the leading "v". */
+    readonly latest?: string;
+    /** True only when a strictly newer release than {@link current} exists. */
+    readonly updateAvailable: boolean;
+    /** Browsable URL of the latest release, or undefined when unknown. */
+    readonly releaseUrl?: string;
+    /** True when the remote registry was queried (false for the local-only view). */
+    readonly checkedRemote: boolean;
+    /** Present when the remote check could not complete. */
+    readonly error?: string;
+}
+/** Extract "git+https://…/owner/repo.git", "github:owner/repo", or "owner/repo" into { owner, repo }. */
+export declare function parseRepository(repository: unknown): {
+    owner: string;
+    repo: string;
+} | undefined;
+/**
+ * Compare dotted numeric versions with basic prerelease handling; returns 1
+ * when a > b, -1 when a < b, 0 when equal. A release outranks a prerelease
+ * sharing the same core (e.g. 0.2.0 > 0.2.0-beta.1).
+ */
+export declare function compareVersions(a: string, b: string): number;
+/** Local-only view: current version + repository URL, no network access. */
+export declare function readVersionInfo(options?: {
+    manifestPath?: string;
+}): Promise<VersionInfo>;
+/**
+ * Query the GitHub releases API for the latest tag and compare it to the
+ * bundled version. Failures are reported through `error` instead of throwing.
+ */
+export declare function checkLatestVersion(options?: {
+    manifestPath?: string;
+    fetchFn?: VersionFetch;
+}): Promise<VersionInfo>;

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Git Panel",
+    "description": "An IDE-style Git panel in the Web GUI: branch and commit-history overview, uncommitted changes with commit and amend, diff stats, and a zsh-style branch marker in the input bar."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Git 面板",
+    "description": "在 Web GUI 里提供 IDE 风格的 Git 面板：分支与提交历史总览、未提交变更的提交与 amend、差异统计，以及输入框上的 zsh 风格分支标记。"
+  }
+}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@xbzbing/dsh-git-panel",
+  "version": "0.1.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",
+  "publishConfig": {
+    "access": "public"
+  },
+  "icon": "./icon.svg",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xbzbing/dsh-git-panel.git"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "main": "lib/host/index.js",
+  "types": "lib/host/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/host/index.d.ts",
+      "default": "./lib/host/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./locale/*.json": "./locale/*.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/client.js",
+    "lib/host",
+    "locale/*.json",
+    "icon.svg",
+    "cordis.patch.yml",
+    "README.md",
+    "README_EN.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "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": "npm run test:unit && npm run test:e2e",
+    "check": "npm run typecheck && npm run test"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ]
+    }
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "git",
+    "web-ui",
+    "diff",
+    "commit"
+  ],
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-session": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-subprocess": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.1.2-rc.1",
+    "@deepseek-ai/schemastery": ">=3.18.4"
+  },
+  "dependencies": {
+    "highlight.js": "11.11.1"
+  },
+  "devDependencies": {
+    "@types/node": "22.10.5",
+    "@types/react": "18.3.18",
+    "@types/react-dom": "18.3.5",
+    "esbuild": "0.24.2",
+    "playwright-core": "1.63.0",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "typescript": "5.7.3"
+  }
+}