@cerbur/clutch-dsh-worktree 0.1.3 → 0.1.4

package/lib/client/worktree-surface-types.d.ts

@@ -0,0 +1,233 @@
+import type { ReactNode } from 'react';
+import type { PropsLocale, PropsRuntime, PropsStore, TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { WorktreeManager, WorktreeRecord } from '../contract/index.js';
+import { WORKTREE_NS } from './locales.js';
+import type { createWorktreeViewStore } from './view-mode-store.js';
+import type { SessionListLike } from './session-view.js';
+import type { CreateSessionForWorktreeInput, WorktreeGitReadiness, WorktreeViewError, WorktreeWorkspaceView } from './worktree-view.js';
+export interface WorkspaceLike {
+    readonly workspaceId: string;
+    readonly title: string;
+    readonly sessionIds: readonly string[];
+}
+export interface WorkspaceListLike {
+    readonly items: readonly WorkspaceLike[];
+    readonly archivedSessionIds?: readonly string[];
+}
+/** Apply-time facts and DSH navigation callbacks used by the surface. */
+export interface WorktreeSurfaceInjected {
+    readonly available: boolean;
+    readonly manager?: WorktreeManager;
+    readonly createWorkspace?: () => Promise<void>;
+    readonly createSessionForWorktree?: (input: CreateSessionForWorktreeInput) => Promise<string>;
+    readonly invalidateWorktreeContext?: (workspaceId?: string) => Promise<void>;
+    readonly createMainSession?: (workspaceId: string) => void;
+    readonly renameWorkspace?: (workspaceId: string, title: string) => Promise<void>;
+    readonly deleteWorkspace?: (workspaceId: string) => Promise<void>;
+    readonly insertWorkspaceBefore?: (workspaceId: string, beforeWorkspaceId?: string) => Promise<void>;
+    readonly insertSessionBefore?: (workspaceId: string, sessionId: string, beforeSessionId?: string) => Promise<void>;
+    readonly insertWorktreeBefore?: (workspaceId: string, worktreeId: string, beforeWorktreeId?: string) => Promise<readonly string[]>;
+    readonly renameSession?: (sessionId: string, title: string) => Promise<void>;
+    readonly forkSession?: (sessionId: string) => void;
+    readonly archiveSession?: (sessionId: string) => Promise<void>;
+    readonly ensureSessionWorkspace?: (workspaceId: string, sessionId: string) => void;
+    readonly syncSessionWorkspaces?: (bindings: readonly {
+        workspaceId: string;
+        sessionId: string;
+    }[]) => void;
+    readonly openSession: (sessionId: string) => void;
+}
+/** Props derived from the frame overlay slot, shared state, and injected face. */
+export type WorktreeSurfaceProps = PropsRuntime<'shell.overlay'> & PropsStore<ReturnType<typeof createWorktreeViewStore>> & PropsLocale<typeof WORKTREE_NS> & WorktreeSurfaceInjected;
+export type WorktreeTranslate = TranslateNS<typeof WORKTREE_NS>;
+export type WorktreeSetupStatus = Exclude<WorktreeGitReadiness['status'], 'ready'>;
+export interface ReadState {
+    readonly status: 'idle' | 'loading' | 'ready' | 'error';
+    readonly views: readonly WorktreeWorkspaceView[];
+    readonly error?: WorktreeViewError;
+}
+export interface RefreshOptions {
+    readonly preserveCurrent?: boolean;
+    readonly invalidateContext?: boolean;
+}
+export interface PendingSessionBinding extends CreateSessionForWorktreeInput {
+    readonly sessionId: string;
+}
+export interface SessionRenameTarget {
+    readonly sessionId: string;
+    readonly currentTitle: string;
+}
+export interface SessionDragProps {
+    readonly active: boolean;
+    readonly marker: 'before' | 'after' | null;
+    readonly start: () => void;
+    readonly hover: (half: 'before' | 'after') => void;
+    readonly drop: (half: 'before' | 'after') => void;
+    readonly end: () => void;
+}
+export interface WorkspaceDragProps {
+    readonly active: boolean;
+    readonly marker: 'before' | 'after' | null;
+    readonly start: () => void;
+    readonly hover: (half: 'before' | 'after') => void;
+    readonly drop: (half: 'before' | 'after') => void;
+    readonly end: () => void;
+}
+export interface WorktreeDragProps {
+    readonly active: boolean;
+    readonly marker: 'before' | 'after' | null;
+    readonly start: () => void;
+    readonly hover: (half: 'before' | 'after') => void;
+    readonly drop: (half: 'before' | 'after') => void;
+    readonly end: () => void;
+}
+export interface WorktreeSessionRowProps {
+    readonly t: WorktreeTranslate;
+    readonly sessionId: string;
+    readonly blank: boolean;
+    readonly label: string;
+    readonly drag: SessionDragProps;
+    readonly actionPending: boolean;
+    readonly onOpen: () => void;
+    readonly onRename?: (sessionId: string, currentTitle: string) => void;
+    readonly onFork?: (sessionId: string) => void;
+    readonly onArchive?: (sessionId: string) => void;
+}
+export interface WorktreeWorkspaceRowProps {
+    readonly t: WorktreeTranslate;
+    readonly workspace: WorkspaceLike;
+    readonly expanded: boolean;
+    readonly actionPending: boolean;
+    readonly menuOpen: boolean;
+    readonly drag: WorkspaceDragProps;
+    readonly onToggle: () => void;
+    readonly onCreateWorktree: () => void;
+    readonly onRename: () => void;
+    readonly onDelete: () => void;
+    readonly onMenuOpenChange: (open: boolean) => void;
+}
+export interface WorktreeGroupMenuProps {
+    readonly open: boolean;
+    readonly label: string;
+    readonly disabled: boolean;
+    readonly onOpenChange: (open: boolean) => void;
+    readonly onRemove: () => void;
+}
+export type WorktreeGroupKind = 'main' | 'worktree';
+export interface WorktreeGroupRowProps {
+    readonly t: WorktreeTranslate;
+    readonly kind: WorktreeGroupKind;
+    readonly label: string;
+    readonly worktreeId?: string;
+    readonly expanded: boolean;
+    readonly icon: ReactNode;
+    readonly workspaceTitle: string;
+    readonly state?: 'done' | 'warning' | 'error';
+    readonly stateLabel?: string;
+    readonly onToggle: () => void;
+    readonly onCreateSession?: () => void;
+    readonly menu?: WorktreeGroupMenuProps;
+    readonly drag?: WorktreeDragProps;
+}
+export interface WorktreeSessionGroupProps {
+    readonly t: WorktreeTranslate;
+    readonly groupKey: string;
+    readonly sessionIds: readonly string[];
+    readonly workspaceId: string;
+    readonly expanded: boolean;
+    readonly actionPending: boolean;
+    readonly sessions: SessionListLike;
+    readonly dragState: SessionDragState | undefined;
+    readonly onToggleExpanded: () => void;
+    readonly onStartDrag: (groupKey: string, sessionId: string) => void;
+    readonly onHoverDrag: (sessionId: string, half: 'before' | 'after') => void;
+    readonly onClearDrag: () => void;
+    readonly onFinishDrag: () => void;
+    readonly onCommitDrag: (activeDrag: SessionDragState, over: NonNullable<SessionDragState['over']>, sessionIds: readonly string[], workspaceId: string) => void;
+    readonly onOpen: (sessionId: string) => void;
+    readonly onRename?: (sessionId: string, currentTitle: string) => void;
+    readonly onFork?: (sessionId: string) => void;
+    readonly onArchive?: (sessionId: string) => void;
+}
+export interface WorkspaceDragState {
+    readonly workspaceId: string;
+    readonly over: {
+        readonly workspaceId: string;
+        readonly half: 'before' | 'after';
+    } | null;
+}
+export interface WorkspaceRenameTarget {
+    readonly workspaceId: string;
+    readonly currentTitle: string;
+}
+export interface WorkspaceDeleteTarget {
+    readonly workspaceId: string;
+    readonly title: string;
+}
+export interface SessionDragState {
+    readonly groupKey: string;
+    readonly sessionId: string;
+    readonly over: {
+        readonly sessionId: string;
+        readonly half: 'before' | 'after';
+    } | null;
+}
+export interface WorktreeDragState {
+    readonly workspaceId: string;
+    readonly worktreeId: string;
+    readonly over: {
+        readonly worktreeId: string;
+        readonly half: 'before' | 'after';
+    } | null;
+}
+export interface SessionRenameDialogProps {
+    readonly t: WorktreeTranslate;
+    readonly target: SessionRenameTarget | undefined;
+    readonly draft: string;
+    readonly pending: boolean;
+    readonly error: WorktreeViewError | undefined;
+    readonly onClose: () => void;
+    readonly onDraftChange: (draft: string) => void;
+    readonly onSubmit: () => void;
+}
+export interface WorkspaceRenameDialogProps {
+    readonly t: WorktreeTranslate;
+    readonly target: WorkspaceRenameTarget | undefined;
+    readonly draft: string;
+    readonly pending: boolean;
+    readonly duplicate: boolean;
+    readonly error: WorktreeViewError | undefined;
+    readonly onClose: () => void;
+    readonly onDraftChange: (draft: string) => void;
+    readonly onSubmit: () => void;
+}
+export interface WorkspaceDeleteDialogProps {
+    readonly t: WorktreeTranslate;
+    readonly target: WorkspaceDeleteTarget | undefined;
+    readonly pending: boolean;
+    readonly error: WorktreeViewError | undefined;
+    readonly onClose: () => void;
+    readonly onSubmit: () => void;
+}
+export interface WorktreeCreateDialogProps {
+    readonly t: WorktreeTranslate;
+    readonly workspace: WorkspaceLike | undefined;
+    readonly view: WorktreeWorkspaceView | undefined;
+    readonly setupStatus: WorktreeSetupStatus | undefined;
+    readonly canCreate: boolean;
+    readonly selectedBranch: string;
+    readonly newBranch: string;
+    readonly actionPending: boolean;
+    readonly onClose: () => void;
+    readonly onSelectedBranchChange: (branch: string) => void;
+    readonly onNewBranchChange: (branch: string) => void;
+    readonly onSubmit: () => void;
+}
+export interface WorktreeRemovalDialogProps {
+    readonly t: WorktreeTranslate;
+    readonly worktree: WorktreeRecord | undefined;
+    readonly actionPending: boolean;
+    readonly onClose: () => void;
+    readonly onSubmit: () => void;
+}
+//# sourceMappingURL=worktree-surface-types.d.ts.map

package/lib/client/worktree-surface-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-surface-types.d.ts","sourceRoot":"","sources":["../../src/client/worktree-surface-types.ts"],"names":[],"mappings":"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"}

package/lib/client/worktree-surface-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worktree-surface-types.js.map

package/lib/client/worktree-surface-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-surface-types.js","sourceRoot":"","sources":["../../src/client/worktree-surface-types.ts"],"names":[],"mappings":""}

package/lib/client/worktree-view-actions.d.ts

@@ -0,0 +1,34 @@
+import type { WorktreeManager, WorktreeRecord } from '../contract/index.js';
+/** Generate a short, editable default branch name without colliding with known local names. */
+export declare function createDefaultWorktreeName(existingNames: Iterable<string>, randomUuid?: () => string): string;
+export interface CreateSessionForWorktreeInput {
+    readonly workspaceId: string;
+    readonly worktreeId: string;
+    readonly cwd: string;
+}
+export type WorktreeViewAction = {
+    readonly type: 'createWorktree';
+    readonly input: Parameters<WorktreeManager['createWorktree']>[0];
+} | {
+    readonly type: 'removeWorktree';
+    readonly input: Parameters<WorktreeManager['removeWorktree']>[0];
+};
+/** Resolve a row-half drop target to native-style optional before-anchor semantics. */
+export declare function resolveWorktreeMove(worktreeIds: readonly string[], sourceWorktreeId: string, targetWorktreeId: string, half: 'before' | 'after'): {
+    readonly beforeWorktreeId?: string;
+} | undefined;
+/** Keep mutation routing in the browser Consumer while leaving wire details to the adapter. */
+export declare function executeWorktreeAction(manager: WorktreeManager, action: WorktreeViewAction): Promise<WorktreeRecord | void>;
+/**
+ * Create a normal DSH Session at a Worktree cwd, then add the external binding.
+ * A binding failure deliberately leaves the DSH-created Session intact.
+ */
+export declare function createSessionForWorktree(input: CreateSessionForWorktreeInput & {
+    readonly createSession: (input: {
+        cwd: string;
+    }) => Promise<string>;
+    readonly manager: Pick<WorktreeManager, 'bindSession'>;
+    readonly beforeOpen?: (sessionId: string) => void;
+    readonly openSession: (sessionId: string) => void;
+}): Promise<string>;
+//# sourceMappingURL=worktree-view-actions.d.ts.map

package/lib/client/worktree-view-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-view-actions.d.ts","sourceRoot":"","sources":["../../src/client/worktree-view-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAS5E,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC/B,UAAU,GAAE,MAAM,MAA0B,GAC3C,MAAM,CASR;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClE,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClE,CAAC;AAEN,uFAAuF;AACvF,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,QAAQ,GAAG,OAAO,GACvB;IAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAepD;AAED,+FAA+F;AAC/F,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAQhC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG;IACpF,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD,GAAG,OAAO,CAAC,MAAM,CAAC,CAclB"}

package/lib/client/worktree-view-actions.js

@@ -0,0 +1,69 @@
+import { WorktreeSessionBindingError } from './worktree-view-errors.js';
+function browserRandomUuid() {
+    const randomUUID = globalThis.crypto?.randomUUID;
+    if (typeof randomUUID === 'function')
+        return randomUUID.call(globalThis.crypto);
+    return `${Date.now().toString(16)}-${Math.random().toString(16).slice(2)}`;
+}
+/** Generate a short, editable default branch name without colliding with known local names. */
+export function createDefaultWorktreeName(existingNames, randomUuid = browserRandomUuid) {
+    const usedNames = new Set([...existingNames].map((name) => name.trim()));
+    for (let attempt = 0; attempt < 100; attempt += 1) {
+        const suffix = randomUuid().replace(/[^a-z0-9]/gi, '').slice(0, 8).toLowerCase();
+        if (suffix.length < 8)
+            continue;
+        const candidate = `dsh/${suffix}`;
+        if (!usedNames.has(candidate))
+            return candidate;
+    }
+    throw new Error('Unable to generate an available default Worktree name.');
+}
+/** Resolve a row-half drop target to native-style optional before-anchor semantics. */
+export function resolveWorktreeMove(worktreeIds, sourceWorktreeId, targetWorktreeId, half) {
+    const sourceIndex = worktreeIds.indexOf(sourceWorktreeId);
+    const targetIndex = worktreeIds.indexOf(targetWorktreeId);
+    if (sourceIndex === -1 || targetIndex === -1)
+        return undefined;
+    const beforeWorktreeId = half === 'before'
+        ? targetWorktreeId
+        : worktreeIds[targetIndex + 1];
+    if (beforeWorktreeId === sourceWorktreeId)
+        return undefined;
+    const anchorIndex = beforeWorktreeId === undefined
+        ? worktreeIds.length
+        : worktreeIds.indexOf(beforeWorktreeId);
+    if (anchorIndex === sourceIndex || anchorIndex === sourceIndex + 1)
+        return undefined;
+    return beforeWorktreeId === undefined ? {} : { beforeWorktreeId };
+}
+/** Keep mutation routing in the browser Consumer while leaving wire details to the adapter. */
+export async function executeWorktreeAction(manager, action) {
+    if (action.type === 'createWorktree') {
+        return manager.createWorktree(action.input);
+    }
+    if (action.type === 'removeWorktree') {
+        await manager.removeWorktree(action.input);
+        return;
+    }
+}
+/**
+ * Create a normal DSH Session at a Worktree cwd, then add the external binding.
+ * A binding failure deliberately leaves the DSH-created Session intact.
+ */
+export async function createSessionForWorktree(input) {
+    const sessionId = await input.createSession({ cwd: input.cwd });
+    try {
+        await input.manager.bindSession({
+            workspaceId: input.workspaceId,
+            worktreeId: input.worktreeId,
+            sessionId,
+        });
+    }
+    catch (error) {
+        throw new WorktreeSessionBindingError(sessionId, error);
+    }
+    input.beforeOpen?.(sessionId);
+    input.openSession(sessionId);
+    return sessionId;
+}
+//# sourceMappingURL=worktree-view-actions.js.map

package/lib/client/worktree-view-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-view-actions.js","sourceRoot":"","sources":["../../src/client/worktree-view-actions.ts"],"names":[],"mappings":"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"}

package/lib/client/worktree-view-errors.d.ts

@@ -0,0 +1,20 @@
+export interface WorktreeViewError {
+    readonly code: string;
+    readonly message: string;
+    readonly retryable: boolean;
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+/** A DSH Session exists even when the external Worktree binding needs repair. */
+export declare class WorktreeSessionBindingError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly details: Readonly<Record<string, unknown>>;
+    readonly sessionId: string;
+    readonly cause: unknown;
+    constructor(sessionId: string, cause: unknown);
+}
+/** Convert any adapter/Gateway failure into renderable, retry-aware UI data. */
+export declare function toWorktreeViewError(error: unknown): WorktreeViewError;
+/** Keep ordering mutation/refresh failures reachable from the surface Retry control. */
+export declare function toRetryableWorktreeOrderError(error: unknown): WorktreeViewError;
+//# sourceMappingURL=worktree-view-errors.d.ts.map

package/lib/client/worktree-view-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-view-errors.d.ts","sourceRoot":"","sources":["../../src/client/worktree-view-errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,iFAAiF;AACjF,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBAEZ,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CA0B9C;AASD,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAsBrE;AAED,wFAAwF;AACxF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAK/E"}

package/lib/client/worktree-view-errors.js

@@ -0,0 +1,65 @@
+/** A DSH Session exists even when the external Worktree binding needs repair. */
+export class WorktreeSessionBindingError extends Error {
+    code;
+    retryable;
+    details;
+    sessionId;
+    cause;
+    constructor(sessionId, cause) {
+        const candidate = typeof cause === 'object' && cause !== null
+            ? cause
+            : undefined;
+        const reason = cause instanceof Error
+            ? cause.message
+            : typeof candidate?.message === 'string'
+                ? candidate.message
+                : String(cause);
+        super(reason);
+        this.name = 'WorktreeSessionBindingError';
+        const conflict = candidate?.code === 'SESSION_ALREADY_BOUND';
+        this.code = conflict ? 'SESSION_ALREADY_BOUND' : 'SESSION_BINDING_FAILED';
+        this.retryable = conflict ? false : candidate?.retryable !== false;
+        this.details = typeof candidate?.details === 'object' && candidate.details !== null
+            && !Array.isArray(candidate.details)
+            ? candidate.details
+            : {};
+        this.sessionId = sessionId;
+        this.cause = cause;
+    }
+}
+function recordDetails(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return undefined;
+    const details = value.details;
+    if (typeof details !== 'object' || details === null || Array.isArray(details))
+        return undefined;
+    return details;
+}
+/** Convert any adapter/Gateway failure into renderable, retry-aware UI data. */
+export function toWorktreeViewError(error) {
+    if (typeof error === 'object' && error !== null) {
+        const candidate = error;
+        const details = error instanceof WorktreeSessionBindingError
+            ? { ...(recordDetails(error) ?? {}), sessionId: error.sessionId }
+            : recordDetails(error);
+        return {
+            code: typeof candidate.code === 'string' ? candidate.code : 'WORKTREE_VIEW_FAILED',
+            message: typeof candidate.message === 'string' ? candidate.message : '',
+            retryable: candidate.retryable !== false,
+            ...(details === undefined ? {} : { details }),
+        };
+    }
+    return {
+        code: 'WORKTREE_VIEW_FAILED',
+        message: '',
+        retryable: true,
+    };
+}
+/** Keep ordering mutation/refresh failures reachable from the surface Retry control. */
+export function toRetryableWorktreeOrderError(error) {
+    return {
+        ...toWorktreeViewError(error),
+        retryable: true,
+    };
+}
+//# sourceMappingURL=worktree-view-errors.js.map

package/lib/client/worktree-view-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-view-errors.js","sourceRoot":"","sources":["../../src/client/worktree-view-errors.ts"],"names":[],"mappings":"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"}

package/lib/client/worktree-view-read.d.ts

@@ -0,0 +1,48 @@
+import type { BranchRecord, SessionBinding, WorktreeManager, WorktreeRecord } from '../contract/index.js';
+import { type WorktreeViewError } from './worktree-view-errors.js';
+export type WorktreeGitReadiness = {
+    readonly status: 'ready';
+} | {
+    readonly status: 'noRepository';
+    readonly error: WorktreeViewError;
+} | {
+    readonly status: 'noInitialCommit';
+    readonly error: WorktreeViewError;
+} | {
+    readonly status: 'noLocalBranch';
+};
+export interface WorktreeViewData {
+    readonly worktrees: readonly WorktreeRecord[];
+    readonly branches: readonly BranchRecord[];
+    readonly bindings: readonly SessionBinding[];
+    readonly readiness: WorktreeGitReadiness;
+}
+export interface WorktreeWorkspaceView extends WorktreeViewData {
+    readonly workspaceId: string;
+}
+export interface LoadWorktreeViewsOptions {
+    readonly invalidateContext?: boolean;
+    readonly invalidateWorktreeContext?: () => Promise<void>;
+}
+/** Reuse the previous ID snapshot when DSH republishes equivalent Workspace items. */
+export declare function stableWorkspaceIds(previous: readonly string[], next: readonly string[]): readonly string[];
+/** Keep only the most recently started Worktree surface refresh authoritative. */
+export declare function createWorktreeRefreshGuard(): {
+    begin: () => number;
+    isCurrent: (generation: number) => boolean;
+    invalidate: () => void;
+    run<T>(load: () => Promise<T>, onSuccess: (value: T) => void, onError: (error: unknown) => void): Promise<void>;
+};
+/** Prefer the branch checked out by the DSH Workspace, then fall back to any local branch. */
+export declare function selectDefaultBaseBranch(branches: readonly BranchRecord[]): string;
+/** Keep a valid user choice across branch-list refreshes, otherwise choose the current branch. */
+export declare function reconcileBaseBranchSelection(selectedBranch: string, branches: readonly BranchRecord[]): string;
+/** Return copyable, read-only setup commands for a Git readiness state. */
+export declare function worktreeSetupCommands(status: WorktreeGitReadiness['status']): readonly string[];
+/** Read all three Worktree projections needed by the surface in one refresh. */
+export declare function loadWorktreeView(manager: WorktreeManager, workspaceId: string): Promise<WorktreeViewData>;
+/** Load one independent projection per DSH Workspace for the flat sidebar hierarchy. */
+export declare function loadWorktreeViews(manager: WorktreeManager, workspaceIds: readonly string[], options?: LoadWorktreeViewsOptions): Promise<readonly WorktreeWorkspaceView[]>;
+/** Hide DSH-archived Sessions from the browser-local Worktree projection. */
+export declare function filterArchivedSessionIds(sessionIds: readonly string[], archivedSessionIds: readonly string[]): readonly string[];
+//# sourceMappingURL=worktree-view-read.d.ts.map

package/lib/client/worktree-view-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-view-read.d.ts","sourceRoot":"","sources":["../../src/client/worktree-view-read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAExF,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACtE;IAAE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACzE;IAAE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,SAAS,MAAM,EAAE,CAMnB;AAED,kFAAkF;AAClF,wBAAgB,0BAA0B;iBAEtB,MAAM;4BAIO,MAAM,KAAG,OAAO;sBACxB,IAAI;QAQf,CAAC,QACH,MAAM,OAAO,CAAC,CAAC,CAAC,aACX,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,WACpB,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAChC,OAAO,CAAC,IAAI,CAAC;EAcnB;AAED,8FAA8F;AAC9F,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAEjF;AAED,kGAAkG;AAClG,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,SAAS,YAAY,EAAE,GAChC,MAAM,CAGR;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACrC,SAAS,MAAM,EAAE,CAoBnB;AAaD,gFAAgF;AAChF,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CA8B3B;AAED,wFAAwF;AACxF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC,CAW3C;AAED,6EAA6E;AAC7E,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,kBAAkB,EAAE,SAAS,MAAM,EAAE,GACpC,SAAS,MAAM,EAAE,CAEnB"}