@xbzbing/dsh-git-panel 0.1.1 → 0.3.0

package/lib/host/actions.d.ts

@@ -1,7 +1,7 @@
 import type { SnapshotDeps, GitPanelConfig } from './core.ts';
+import { isSafePath } from './validate.ts';
 import type { GitAction, GitActionRequest, GitActionResult, GitErrorCode } from './types.ts';
-/** A repository-relative path is safe when it stays inside the work tree. */
-export declare function isSafePath(path: string): boolean;
+export { isSafePath };
 interface CommandPlan {
     readonly argv: readonly (readonly string[])[];
 }
@@ -13,4 +13,3 @@ type PlanResult = CommandPlan | {
 export declare function planAction(action: GitAction, unborn: boolean): PlanResult;
 /** Execute a management action, returning the fresh snapshot on success. */
 export declare function runAction(deps: SnapshotDeps, config: GitPanelConfig, request: GitActionRequest): Promise<GitActionResult>;
-export {};

package/lib/host/core.d.ts

@@ -1,5 +1,5 @@
 import type { GitRunner } from './git.ts';
-import type { GitChange, GitSnapshotResult } from './types.ts';
+import type { DiffViewMode, GitChange, GitErrorCode, GitSnapshotResult } from './types.ts';
 export interface GitPanelConfig {
     readonly timeoutMs: number;
     /** Per-command stdout cap; also the per-side image-diff payload cap. */
@@ -8,9 +8,13 @@ export interface GitPanelConfig {
     readonly refreshIntervalMs: number;
     /** Whether the input-bar git marker pill is shown. */
     readonly showInputPill: boolean;
+    /** Default diff layout the views open with (user can switch per-diff). */
+    readonly defaultDiffView: DiffViewMode;
 }
 export declare const DEFAULT_CONFIG: GitPanelConfig;
 export declare function normalizeConfig(raw: unknown): GitPanelConfig;
+/** Read the default-diff-view field, unwrapping a schemastery volatile ref. */
+export declare function readDiffView(value: unknown, fallback: DiffViewMode): DiffViewMode;
 /**
  * Read a boolean config field, unwrapping a schemastery volatile reference
  * (`{ get() }`) so a live-editable toggle reflects the latest value. Absent or
@@ -28,6 +32,11 @@ export interface SnapshotDeps {
         }>;
         /** Raw bytes (no encoding) — image sides for the image-diff query. */
         readFile(path: string): Promise<Buffer>;
+        /** One directory's entries (name + is-directory) — the file browser. */
+        readdir(path: string): Promise<ReadonlyArray<{
+            name: string;
+            isDirectory: boolean;
+        }>>;
         /** Best-effort unlink (force) — temp-blob cleanup. */
         remove(path: string): Promise<void>;
     };
@@ -45,6 +54,13 @@ export interface SnapshotDeps {
      * distinct cwd (a session's cwd is effectively stable).
      */
     readonly rootCache?: Map<string, string>;
+    /**
+     * Optional negative cache (cwd → expiry epoch ms) for non-repo cwds, so a
+     * session whose directory is not a git repo does not spawn `rev-parse` on
+     * every 30s poll. Short-lived (see NEG_CACHE_MS) so a repo created under the
+     * cwd is picked up soon after.
+     */
+    readonly rootNegCache?: Map<string, number>;
 }
 export type WorkspaceResolution = {
     readonly ok: true;
@@ -55,14 +71,43 @@ export type WorkspaceResolution = {
         ok: false;
     };
 };
+/**
+ * Resolve a directory root for the file browser, which must work outside a git
+ * repository too. Inside a repo it is the work-tree top; otherwise it falls
+ * back to the session's cwd (realpath'd) so directory listing / file preview
+ * still function. Only a missing cwd is a hard failure.
+ */
+export declare function resolveBrowseRoot(deps: SnapshotDeps, sessionId: string): Promise<{
+    ok: true;
+    root: string;
+    isGitRepo: boolean;
+} | {
+    ok: false;
+    error: {
+        code: GitErrorCode;
+        message?: string;
+    };
+}>;
 /** Resolve the git work-tree root for a session's cwd. */
 export declare function resolveWorkspace(deps: SnapshotDeps, sessionId: string): Promise<WorkspaceResolution>;
 /** Run one git command; a spawn-level failure returns { failure }. */
-export declare function runCommand(runner: GitRunner, argv: readonly string[], cwd: string, _label: string, signal?: AbortSignal): Promise<{
+export declare function runCommand(runner: GitRunner, argv: readonly string[], cwd: string, _label: string, signal?: AbortSignal, stdinData?: string): Promise<{
     run: Awaited<ReturnType<GitRunner['run']>>;
 } | {
     failure: unknown;
 }>;
+/**
+ * Collapse a workspace-resolution failure into the `{ code, message }` shape
+ * the run/query endpoints return. `GitFailure` already carries only endpoint
+ * codes, so no membership test is needed (the previous per-endpoint ternary
+ * that re-listed every code was always true — dead). `detail` becomes message.
+ */
+export declare function mapWorkspaceFailure(failure: GitSnapshotResult & {
+    ok: false;
+}): {
+    code: GitErrorCode;
+    message?: string;
+};
 /** Produce a full snapshot for a session. */
 export declare function snapshotForSession(deps: SnapshotDeps, config: GitPanelConfig, sessionId: string): Promise<GitSnapshotResult>;
 /** Max mtime among changed files (epoch ms), capped for large sets. */

package/lib/host/git.d.ts

@@ -10,7 +10,9 @@ interface SpawnSpec {
     readonly argv: readonly string[];
     readonly cwd: string;
     readonly stdio: {
-        readonly stdin: 'ignore';
+        readonly stdin: 'ignore' | {
+            readonly data: string;
+        };
         readonly stdout: CollectDisposition;
         readonly stderr: CollectDisposition;
     };
@@ -45,12 +47,15 @@ export interface GitRunResult {
     readonly stdout: string;
     readonly stderr: string;
     readonly timedOut: boolean;
+    /** The caller's own signal aborted the run (navigation/reset), not our timeout. */
+    readonly cancelled: boolean;
     readonly stdoutLossy: boolean;
 }
 export interface GitRunner {
     run(argv: readonly string[], opts: {
         readonly cwd: string;
         readonly signal?: AbortSignal;
+        readonly stdinData?: string;
     }): Promise<GitRunResult>;
 }
 /**

package/lib/host/index.d.ts

@@ -10,7 +10,7 @@ import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import type { Context } from '@deepseek-ai/cordis';
 import Schema from '@deepseek-ai/schemastery';
 import type { GitActionRequest, GitActionResult, GitQueryRequest, GitQueryResponse, GitSnapshotRequest, GitSnapshotResult, GitVersionInfo, GitVersionRequest } from './types.ts';
-export type { GitSnapshot, GitSnapshotResult, GitSnapshotRequest, GitFailure, GitCommit, GraphCommit, GitRef, GitChange, GitChangeStatus, GitAction, GitActionRequest, GitActionResult, GitErrorCode, GitQuery, GitQueryRequest, GitQueryResponse, GitQueryResult, GitBranch, GitFileStat, WorktreeStats, GitVersionRequest, GitVersionInfo, } from './types.ts';
+export type { GitSnapshot, GitSnapshotResult, GitSnapshotRequest, GitFailure, GitCommit, GraphCommit, GitRef, GitChange, GitChangeStatus, GitAction, GitActionRequest, GitActionResult, GitErrorCode, GitQuery, GitQueryRequest, GitQueryResponse, GitQueryResult, GitBranch, GitFileStat, WorktreeStats, GitVersionRequest, GitVersionInfo, DiffViewMode, DirEntry, } from './types.ts';
 export { normalizeConfig, DEFAULT_CONFIG, snapshotForSession, resolveWorkspace } from './core.ts';
 export { createGitRunner } from './git.ts';
 export { parseStatus, parseGraphLog, parseBranches, parseNameStatus, sumNumstat } from './parser.ts';
@@ -20,14 +20,17 @@ export { readVersionInfo, checkLatestVersion, compareVersions, parseRepository }
 export declare class GitPanelService extends TypertRemoteService {
     static inject: string[];
     /**
-     * Config schema surfaced on the plugin detail page. Only `showInputPill` is
-     * `.volatile()`, so the settings host renders it as a live-editable toggle;
-     * the operational limits stay profile-only and out of the UI form.
+     * Config schema surfaced on the plugin detail page. `showInputPill` and
+     * `defaultDiffView` are `.volatile()`, so the settings host renders them as
+     * live-editable controls; the operational limits stay profile-only and out
+     * of the UI form.
      */
     static Config: Schema<Schemastery.ObjectS<NoInfer<{
         showInputPill: Schema<boolean, boolean, "volatile-defined">;
+        defaultDiffView: Schema<"split" | "unified", "split" | "unified", "volatile-defined">;
     }>>, Schemastery.ObjectT<NoInfer<{
         showInputPill: Schema<boolean, boolean, "volatile-defined">;
+        defaultDiffView: Schema<"split" | "unified", "split" | "unified", "volatile-defined">;
     }>>, "plain">;
     private readonly deps;
     private config;