@civilization/dsh-experimental-git 0.0.0-stage → 0.2.1-rc.2

package/lib/types/types.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Core type declarations for the experimental Git plugin.
+ * Shared across the Host RPC handlers and Client UI viewers.
+ */
+/** File change status representation in git */
+export type GitFileStatusCode = 'modified' | 'added' | 'deleted' | 'renamed' | 'untracked' | 'copied';
+/** One changed file entry in the working directory or staging area */
+export interface GitFileStatus {
+    /** Relative file path from the repository root */
+    readonly path: string;
+    /** Previous path if the file was renamed */
+    readonly originalPath?: string;
+    /** Normalized status kind */
+    readonly status: GitFileStatusCode;
+    /** Whether the change has been staged to index */
+    readonly staged: boolean;
+}
+/** Information about one local git branch */
+export interface GitBranchInfo {
+    /** Branch name (e.g. 'main', 'master', 'feature/xyz') */
+    readonly name: string;
+    /** Whether this branch is currently checked out */
+    readonly isCurrent: boolean;
+    /** Upstream tracking branch if configured */
+    readonly upstream?: string;
+    /** Number of commits ahead of upstream */
+    readonly ahead?: number;
+    /** Number of commits behind upstream */
+    readonly behind?: number;
+}
+/** Full status summary of the workspace repository */
+export interface GitStatusSummary {
+    /** Whether the checked directory is inside a Git worktree/repository */
+    readonly isRepo: boolean;
+    /** Absolute root directory of the repository */
+    readonly rootPath?: string;
+    /** Current branch name, or commit hash if detached */
+    readonly branch?: string;
+    /** Upstream branch name */
+    readonly upstream?: string;
+    /** Commits ahead of upstream */
+    readonly ahead: number;
+    /** Commits behind upstream */
+    readonly behind: number;
+    /** Latest commit summary on current HEAD */
+    readonly headCommit?: {
+        readonly hash: string;
+        readonly shortHash: string;
+        readonly message: string;
+    };
+    /** Staged changes in index */
+    readonly staged: readonly GitFileStatus[];
+    /** Unstaged changes in working tree */
+    readonly unstaged: readonly GitFileStatus[];
+    /** Untracked new files */
+    readonly untracked: readonly GitFileStatus[];
+    /** Total count of all changed/untracked files */
+    readonly totalChanges: number;
+    /** Total count of commits in the current repository */
+    readonly totalCommitsCount?: number;
+}
+/** One commit log entry with optional DAG topology metadata */
+export interface GitCommitItem {
+    /** Full 40-character commit hash */
+    readonly hash: string;
+    /** Abbreviated 7-character commit hash */
+    readonly shortHash: string;
+    /** Author name */
+    readonly author: string;
+    /** Author email address */
+    readonly authorEmail: string;
+    /** Human-readable relative date (e.g. '2 hours ago') */
+    readonly relativeDate: string;
+    /** ISO date string */
+    readonly date: string;
+    /** Commit subject/first line of commit message */
+    readonly subject: string;
+    /** Full multiline commit body message (excluding subject) */
+    readonly body?: string;
+    /** Parent commit hashes */
+    readonly parents?: readonly string[];
+    /** Git branch / tag reference names */
+    readonly refs?: readonly string[];
+    /** Topological vertical lane column index (0-based) */
+    readonly lane?: number;
+    /** Color hex code for the current commit's lane */
+    readonly laneColor?: string;
+    /** Connecting graph rails to parent commits */
+    readonly paths?: readonly GitGraphLanePath[];
+}
+/** Vector path connecting lanes in the DAG graph visualization */
+export interface GitGraphLanePath {
+    /** Starting lane index (from this commit) */
+    readonly fromLane: number;
+    /** Target lane index (to parent commit or pass-through) */
+    readonly toLane: number;
+    /** Type of track: pass-through, fork out, or merge in */
+    readonly kind: 'straight' | 'fork' | 'merge';
+    /** Color of this track line */
+    readonly color: string;
+}
+/** Detail information for a single commit including changed files */
+export interface GitCommitDetail {
+    readonly commit: GitCommitItem;
+    readonly body?: string;
+    readonly parents?: readonly string[];
+    readonly files: readonly {
+        readonly path: string;
+        readonly oldPath?: string;
+        readonly status: GitFileStatusCode;
+        readonly additions: number;
+        readonly deletions: number;
+    }[];
+    readonly totalAdditions: number;
+    readonly totalDeletions: number;
+}
+/** Complete log query summary including commits and total count */
+export interface GitLogSummary {
+    readonly commits: readonly GitCommitItem[];
+    readonly totalCount: number;
+}
+/** One Git tag entry */
+export interface GitTagItem {
+    /** Tag name (e.g. 'v1.0.0', 'dsh-v0.2.1-rc.2') */
+    readonly name: string;
+    /** Target commit full 40-character SHA hash */
+    readonly commitHash: string;
+    /** Target commit abbreviated 7-character hash */
+    readonly shortHash: string;
+    /** ISO 8601 date string of tag or commit */
+    readonly date: string;
+    /** Human-readable relative date (e.g. '3 days ago') */
+    readonly relativeDate: string;
+    /** Tag annotation message or commit subject */
+    readonly message: string;
+    /** Author or tagger name */
+    readonly author: string;
+    /** Whether this is an annotated tag (git tag -a) */
+    readonly isAnnotated: boolean;
+}
+/** Aggregated local and remote branches */
+export interface GitBranchesSummary {
+    readonly current?: string;
+    readonly local: readonly GitBranchInfo[];
+    readonly remote: readonly GitBranchInfo[];
+}
+/** Generic result of executing a git mutative operation */
+export interface GitOperationResult {
+    readonly success: boolean;
+    readonly message?: string;
+    readonly output?: string;
+}
+/** One file's diff result */
+export interface GitDiffFile {
+    /** File path */
+    readonly path: string;
+    /** Old file path if renamed */
+    readonly oldPath?: string;
+    /** Change status */
+    readonly status: GitFileStatusCode;
+    /** Raw unified diff patch lines */
+    readonly diffText: string;
+    /** Count of added lines */
+    readonly additions: number;
+    /** Count of removed lines */
+    readonly deletions: number;
+}
+/** Complete diff result summary */
+export interface GitDiffSummary {
+    /** List of parsed diff files */
+    readonly files: readonly GitDiffFile[];
+    /** Complete raw unified diff output */
+    readonly rawDiff: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Git Source Control",
+    "description": "View project Git status, changed files, code diffs, and commit history in the right sidebar."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Git 版本控制",
+    "description": "在右侧边栏查看项目 Git 状态、变更列表、代码差异与提交历史。"
+  }
+}

package/package.json

@@ -1,6 +1,78 @@
 {
   "name": "@civilization/dsh-experimental-git",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "View project Git repository status, branches, commit log, and diffs in the right sidebar.",
+  "version": "0.2.1-rc.2",
+  "icon": "./icon.svg",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/civilization-os/deepseek-harness.git",
+    "directory": "packages/experimental/git"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json",
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "icon.svg",
+    "locale/*.json",
+    "lib/index.js",
+    "lib/client.js",
+    "cordis.patch.yml",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-sidebar-right",
+        "@deepseek-ai/dsh-client-ui-primitives",
+        "@deepseek-ai/dsh-client-shortcuts"
+      ],
+      "platform": "web"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "~3.18.5"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-shortcuts": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
 }