@xbzbing/dsh-git-panel 0.1.0 → 0.2.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 { GitChange, GitErrorCode, GitSnapshotResult } from './types.ts';
 export interface GitPanelConfig {
     readonly timeoutMs: number;
     /** Per-command stdout cap; also the per-side image-diff payload cap. */
@@ -45,6 +45,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;
@@ -63,6 +70,18 @@ export declare function runCommand(runner: GitRunner, argv: readonly string[], c
 } | {
     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

@@ -45,6 +45,8 @@ 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 {