dsh-git-ui 0.0.2 → 0.1.1

package/src/host/types.ts

@@ -58,10 +58,40 @@ export interface GitCommit {
   readonly dateIso: string
 }
 
+/**
+ * 带父引用的提交（图渲染用）。
+ * `parents` 为完整 SHA（线上格式以空格分隔）；根提交为空数组。
+ * `refs` 为 `%D` 装饰（分支 / 远程 / 标签）。
+ */
+export interface GraphCommit extends GitCommit {
+  readonly parents: readonly string[]
+  readonly refs: readonly GitRef[]
+}
+
+/** 提交上挂载的一个 ref 装饰（分支 / 远程 / 标签）。 */
+export interface GitRef {
+  readonly kind: 'branch' | 'remote' | 'tag'
+  readonly name: string
+  /** `HEAD -> name` 的当前分支为 true。 */
+  readonly head: boolean
+}
+
+/**
+ * 一条变更文件条目。混合状态（porcelain XY 双列均非空，如 MM/AM）会被
+ * 拆为两条：`staged: true` 一侧（状态取 X 列）与 `staged: false` 一侧
+ * （状态取 Y 列），UI 据此分列「已暂存更改 / 更改」两组（IDEA 式）。
+ * 真实冲突（UU/AA/DD 等）保持单条 `conflicted`。
+ */
 export interface GitChange {
   readonly path: string
   readonly status: GitChangeStatus
   readonly staged: boolean
+  /**
+   * 目录条目（git status 对未跟踪目录输出 `dir/`，host 解析时权威标记）。
+   * 展示层必须以此字段判断目录而非字符串派生——任何路径规范化剥离尾斜杠
+   * 都不会丢失目录性（`.agent/` 曾被当文件展示的根因防护）。
+   */
+  readonly isDirectory: boolean
 }
 
 export type GitChangeStatus =
@@ -92,6 +122,10 @@ export type GitAction =
      * empty commits everything already staged. */
     readonly paths?: readonly string[]
   }
+  | { readonly kind: 'branch-create'; readonly name: string; readonly from?: string }
+  | { readonly kind: 'branch-checkout'; readonly name: string }
+  | { readonly kind: 'branch-delete'; readonly name: string; readonly force?: boolean }
+  | { readonly kind: 'fetch' }
 
 export type GitOperationErrorCode =
   | 'session-not-found'
@@ -99,8 +133,13 @@ export type GitOperationErrorCode =
   | 'path-not-found'
   | 'not-a-git-repo'
   | 'invalid-path'
+  | 'invalid-name'
   | 'git-error'
   | 'timeout'
+  /** 切分支被工作区未提交变更阻止（git: "would be overwritten by checkout"）。
+   * host 归一化为业务错误：client 用友好文案 +「处理变更」引导，不再直接
+   * 抛原始多行 git stderr。原始信息保留在 message。 */
+  | 'local-changes-block'
 
 export type GitActionResult =
   | { readonly ok: true; readonly snapshot: GitSnapshot; readonly output?: string }
@@ -111,3 +150,68 @@ export interface GitActionRequest {
   readonly sessionId: string
   readonly action: GitAction
 }
+
+// ── Query endpoint (read-only inspections: history / diff / show / branches) ──
+
+/** 一条只读查询，对应 `gitInfo/query` 端点。 */
+export type GitQuery =
+  | {
+    readonly kind: 'history'
+    readonly limit: number
+    readonly skip: number
+    /** 可选 ref 过滤（分支/远程/标签）；缺省为 --all 全分支。 */
+    readonly ref?: string
+    /** 文本搜索：7+ 位十六进制视为哈希前缀跳转；否则提交信息正则搜索（-i -E）。 */
+    readonly search?: string
+    /** 作者过滤（--author）。 */
+    readonly author?: string
+    /** 日期下限（--since，如 '7 days ago'）。 */
+    readonly since?: string
+  }
+  | { readonly kind: 'diff'; readonly path: string; readonly base: 'worktree' | 'staged' }
+  | { readonly kind: 'show'; readonly ref: string }
+  | { readonly kind: 'branches' }
+  | { readonly kind: 'tags' }
+  | { readonly kind: 'authors' }
+
+/** 提交变更文件行（`--name-status` 源：状态 + 路径，不再携带 +/- 行数）。 */
+export interface GitFileStat {
+  readonly path: string
+  readonly status: GitChangeStatus
+}
+
+/** One branch row from `git branch --format`. Local branches may carry
+ * ahead/behind counts relative to their upstream (from `%(upstream:track)`). */
+export interface GitBranch {
+  readonly name: string
+  readonly shortHash: string | null
+  /** 本地分支领先上游的提交数（仅本地有上游时存在）。 */
+  readonly ahead?: number
+  /** 本地分支落后上游的提交数（仅本地有上游时存在）。 */
+  readonly behind?: number
+}
+
+export type GitQueryResult =
+  | { readonly kind: 'history'; readonly commits: readonly GraphCommit[]; readonly total: number }
+  | { readonly kind: 'diff'; readonly path: string; readonly text: string }
+  | {
+    readonly kind: 'show'
+    readonly ref: string
+    readonly commit: GitCommit | null
+    /** 提交完整正文（不含 subject 行）；IDEA 式右栏展示用。 */
+    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[] }
+
+export type GitQueryResponse =
+  | { readonly ok: true; readonly value: GitQueryResult }
+  | { readonly ok: false; readonly error: { readonly code: GitOperationErrorCode; readonly message?: string } }
+
+/** Wire request of the `query` endpoint. */
+export interface GitQueryRequest {
+  readonly sessionId: string
+  readonly query: GitQuery
+}