@cerbur/clutch-dsh-worktree 0.1.6 → 0.1.8

package/lib/client/worktree-permission-icon.js

@@ -0,0 +1,119 @@
+const PLUGIN_ID = '@cerbur/clutch-dsh-worktree';
+const STYLE_ID = `${PLUGIN_ID}/permission-icon`;
+const WORKTREE_PERMISSION_LABEL = 'Worktree Full Access';
+/** DOM marker owned only by this plugin's permission icon decorator. */
+export const WORKTREE_PERMISSION_ICON_ATTRIBUTE = 'data-clutch-dsh-worktree-permission-icon';
+// The native DSH menu has no icon extension point for host-configured values.
+// A branch glyph keeps the custom option visually distinct while preserving
+// the same 16px geometry as the built-in permission glyphs.
+const ICON_SVG = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M13.0762 1.37207C14.0846 1.37228 14.9021 2.19077 14.9023 3.19922C14.9022 4.20772 14.0847 5.02518 13.0762 5.02539C12.2967 5.02539 11.6325 4.53691 11.3701 3.84961H4.35547C4.79397 4.26458 5.15861 4.7644 5.41699 5.33496L7.10645 9.06738C7.88526 10.7875 9.55104 11.9228 11.4189 12.0371C11.7085 11.4109 12.3411 10.9756 13.0762 10.9756C14.0843 10.9759 14.9023 11.7936 14.9023 12.8018C14.9023 13.81 14.0843 14.6277 13.0762 14.6279C12.2534 14.6279 11.5574 14.0832 11.3291 13.335C8.9868 13.1879 6.89981 11.7612 5.92285 9.60352L4.23242 5.87109C3.67503 4.64033 2.44878 3.84961 1.09766 3.84961V2.54883C1.10665 2.54883 1.11601 2.54975 1.125 2.5498L11.3701 2.54883C11.6326 1.86151 12.2969 1.37207 13.0762 1.37207ZM13.0762 12.2764C12.7858 12.2764 12.5508 12.5114 12.5508 12.8018C12.5508 13.0921 12.7858 13.3281 13.0762 13.3281C13.3664 13.3279 13.6025 13.092 13.6025 12.8018C13.6025 12.5115 13.3664 12.2766 13.0762 12.2764ZM13.0762 2.67285C12.7855 2.67285 12.55 2.90861 12.5498 3.19922C12.5499 3.48987 12.7855 3.72559 13.0762 3.72559C13.3667 3.72538 13.6024 3.48975 13.6025 3.19922C13.6023 2.90874 13.3666 2.67306 13.0762 2.67285Z" fill="black"/></svg>';
+function iconStyles() {
+    const mask = `url("data:image/svg+xml,${encodeURIComponent(ICON_SVG)}")`;
+    return `
+[${WORKTREE_PERMISSION_ICON_ATTRIBUTE}]::before {
+  content: "";
+  display: inline-block;
+  flex: 0 0 auto;
+  width: 16px;
+  height: 16px;
+  background-color: var(--dsw-alias-label-tertiary, currentColor);
+  -webkit-mask-image: ${mask};
+  mask-image: ${mask};
+  -webkit-mask-position: center;
+  mask-position: center;
+  -webkit-mask-repeat: no-repeat;
+  mask-repeat: no-repeat;
+  -webkit-mask-size: contain;
+  mask-size: contain;
+}
+[${WORKTREE_PERMISSION_ICON_ATTRIBUTE}="trigger"]::before {
+  width: 14px;
+  height: 14px;
+}
+@container (max-width: 460px) {
+  [${WORKTREE_PERMISSION_ICON_ATTRIBUTE}="trigger"] > span:first-of-type {
+    display: none;
+  }
+}
+`;
+}
+function normalizedText(element) {
+    return (element.textContent ?? '').replace(/\s+/g, ' ').trim();
+}
+function isWorktreeMenuItem(element) {
+    return element.matches('button[role="menuitem"]') &&
+        normalizedText(element) === WORKTREE_PERMISSION_LABEL &&
+        element.closest('[role="menu"]') !== null;
+}
+function isWorktreeTrigger(element) {
+    if (!element.matches('button[aria-label]'))
+        return false;
+    const label = element.getAttribute('aria-label') ?? '';
+    return /^(?:access mode,\s*current:\s*|访问模式，当前：\s*)worktree full access$/iu.test(label.trim());
+}
+/** Mark the native custom permission row and trigger for CSS decoration. */
+export function decorateWorktreePermissionIcons(document) {
+    for (const marked of document.querySelectorAll(`[${WORKTREE_PERMISSION_ICON_ATTRIBUTE}]`)) {
+        const kind = marked.getAttribute(WORKTREE_PERMISSION_ICON_ATTRIBUTE);
+        if ((kind === 'menu' && !isWorktreeMenuItem(marked)) ||
+            (kind === 'trigger' && !isWorktreeTrigger(marked))) {
+            marked.removeAttribute(WORKTREE_PERMISSION_ICON_ATTRIBUTE);
+        }
+    }
+    for (const item of document.querySelectorAll('button[role="menuitem"]')) {
+        if (isWorktreeMenuItem(item)) {
+            item.setAttribute(WORKTREE_PERMISSION_ICON_ATTRIBUTE, 'menu');
+        }
+    }
+    for (const button of document.querySelectorAll('button[aria-label]')) {
+        if (isWorktreeTrigger(button)) {
+            button.setAttribute(WORKTREE_PERMISSION_ICON_ATTRIBUTE, 'trigger');
+        }
+    }
+}
+/** Install the Worktree permission icon and return a plugin-local disposer. */
+export function installWorktreePermissionIcon(document) {
+    for (const existing of document.querySelectorAll('style[data-plugin-css]')) {
+        if (existing.getAttribute('data-plugin-css') === STYLE_ID)
+            existing.remove();
+    }
+    const style = document.createElement('style');
+    style.setAttribute('data-plugin', PLUGIN_ID);
+    style.setAttribute('data-plugin-css', STYLE_ID);
+    style.textContent = iconStyles();
+    document.head.appendChild(style);
+    let active = true;
+    let queued = false;
+    const scan = () => {
+        if (!active || queued)
+            return;
+        queued = true;
+        queueMicrotask(() => {
+            queued = false;
+            if (active)
+                decorateWorktreePermissionIcons(document);
+        });
+    };
+    decorateWorktreePermissionIcons(document);
+    const observer = typeof MutationObserver === 'function'
+        ? new MutationObserver(scan)
+        : undefined;
+    observer?.observe(document.documentElement, {
+        attributes: true,
+        attributeFilter: ['aria-label'],
+        characterData: true,
+        childList: true,
+        subtree: true,
+    });
+    return () => {
+        if (!active)
+            return;
+        active = false;
+        observer?.disconnect();
+        style.remove();
+        for (const marked of document.querySelectorAll(`[${WORKTREE_PERMISSION_ICON_ATTRIBUTE}]`)) {
+            marked.removeAttribute(WORKTREE_PERMISSION_ICON_ATTRIBUTE);
+        }
+    };
+}
+//# sourceMappingURL=worktree-permission-icon.js.map

package/lib/client/worktree-permission-icon.js.map

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

package/lib/client/worktree-permission.d.ts

@@ -0,0 +1,21 @@
+export interface WorktreeFullAccessConfirmationInput {
+    readonly workspaceId: string;
+    readonly worktreeId: string;
+    readonly sessionId: string;
+    readonly cwd: string;
+}
+export interface WorktreeFullAccessConfirmationController {
+    readonly getSnapshot: () => WorktreeFullAccessConfirmationInput | undefined;
+    readonly subscribe: (listener: () => void) => () => void;
+    readonly request: (input: WorktreeFullAccessConfirmationInput) => Promise<boolean>;
+    readonly resolve: (confirmed: boolean) => void;
+    readonly dispose: () => void;
+}
+export declare function worktreeFullAccessConfirmationMessage(input: WorktreeFullAccessConfirmationInput, locale?: string): string;
+/**
+ * Coordinate async permission requests with the one in-page confirmation
+ * rendered by the Worktree surface. Requests are serialized so concurrent
+ * Worktree Session creations cannot replace one another's dialog.
+ */
+export declare function createWorktreeFullAccessConfirmationController(): WorktreeFullAccessConfirmationController;
+//# sourceMappingURL=worktree-permission.d.ts.map

package/lib/client/worktree-permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-permission.d.ts","sourceRoot":"","sources":["../../src/client/worktree-permission.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,mCAAmC,GAAG,SAAS,CAAC;IAC5E,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,mCAAmC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAWD,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,mCAAmC,EAC1C,MAAM,SAAiC,GACtC,MAAM,CAKR;AAED;;;;GAIG;AACH,wBAAgB,8CAA8C,IAC5D,wCAAwC,CAqDzC"}

package/lib/client/worktree-permission.js

@@ -0,0 +1,70 @@
+const englishReason = 'This Worktree Session may need Git metadata and linked Worktree files outside the Session directory. '
+    + 'Full Access disables filesystem confinement for this Session; approval prompts remain enabled, '
+    + 'and network and process policy is unchanged. Continue?';
+const chineseReason = '这个 Worktree Session 可能需要访问 Session 目录之外的 Git 元数据和关联 Worktree 文件。'
+    + '完全访问会关闭此 Session 的文件系统沙箱，但会保留审批提示，网络和进程策略不变。'
+    + '是否继续？';
+export function worktreeFullAccessConfirmationMessage(input, locale = globalThis.navigator?.language) {
+    const reason = locale?.toLocaleLowerCase().startsWith('zh') === true
+        ? chineseReason
+        : englishReason;
+    return `${reason}\n\nWorktree: ${input.cwd}`;
+}
+/**
+ * Coordinate async permission requests with the one in-page confirmation
+ * rendered by the Worktree surface. Requests are serialized so concurrent
+ * Worktree Session creations cannot replace one another's dialog.
+ */
+export function createWorktreeFullAccessConfirmationController() {
+    let active;
+    const queue = [];
+    const listeners = new Set();
+    let disposed = false;
+    const notify = () => {
+        for (const listener of listeners)
+            listener();
+    };
+    const showNext = () => {
+        if (active !== undefined)
+            return;
+        active = queue.shift();
+        notify();
+    };
+    const controller = {
+        getSnapshot: () => active?.input,
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        request: (input) => {
+            if (disposed)
+                return Promise.resolve(false);
+            return new Promise((resolve) => {
+                queue.push({ input, resolve });
+                showNext();
+            });
+        },
+        resolve: (confirmed) => {
+            if (active === undefined)
+                return;
+            const current = active;
+            active = undefined;
+            current.resolve(confirmed);
+            showNext();
+        },
+        dispose: () => {
+            if (disposed)
+                return;
+            disposed = true;
+            active?.resolve(false);
+            active = undefined;
+            for (const pending of queue.splice(0))
+                pending.resolve(false);
+            notify();
+        },
+    };
+    return controller;
+}
+//# sourceMappingURL=worktree-permission.js.map

package/lib/client/worktree-permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-permission.js","sourceRoot":"","sources":["../../src/client/worktree-permission.ts"],"names":[],"mappings":"AAeA,MAAM,aAAa,GACjB,uGAAuG;MACrG,iGAAiG;MACjG,wDAAwD,CAAC;AAC7D,MAAM,aAAa,GACjB,kEAAkE;MAChE,8CAA8C;MAC9C,OAAO,CAAC;AAEZ,MAAM,UAAU,qCAAqC,CACnD,KAA0C,EAC1C,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE,QAAQ;IAEvC,MAAM,MAAM,GAAG,MAAM,EAAE,iBAAiB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI;QAClE,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,aAAa,CAAC;IAClB,OAAO,GAAG,MAAM,iBAAiB,KAAK,CAAC,GAAG,EAAE,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8CAA8C;IAO5D,IAAI,MAAkC,CAAC;IACvC,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IACxC,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,KAAK,MAAM,QAAQ,IAAI,SAAS;YAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QACjC,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QACvB,MAAM,EAAE,CAAC;IACX,CAAC,CAAC;IAEF,MAAM,UAAU,GAA6C;QAC3D,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,KAAK;QAChC,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,IAAI,QAAQ;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5C,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;gBACtC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC/B,QAAQ,EAAE,CAAC;YACb,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE;YACrB,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO;YACjC,MAAM,OAAO,GAAG,MAAM,CAAC;YACvB,MAAM,GAAG,SAAS,CAAC;YACnB,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC3B,QAAQ,EAAE,CAAC;QACb,CAAC;QACD,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACvB,MAAM,GAAG,SAAS,CAAC;YACnB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9D,MAAM,EAAE,CAAC;QACX,CAAC;KACF,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/lib/client/worktree-session-fork.d.ts

@@ -0,0 +1,65 @@
+import type { SessionBinding } from '../contract/index.js';
+/** The public options accepted by the native DSH Session fork service. */
+export interface WorktreeForkInput {
+    readonly sessionId: string;
+    readonly atSeq?: number;
+    readonly increaseTitle?: boolean;
+}
+/** The lineage facts exposed by DSH's browser Session list. */
+export interface WorktreeForkSessionSummary {
+    readonly blank?: boolean;
+    readonly parentId?: string;
+    readonly origin?: string;
+}
+export interface WorktreeForkSessionListSnapshot {
+    readonly phase?: 'pending' | 'ready';
+    readonly ids: readonly string[];
+    readonly byId: Readonly<Record<string, WorktreeForkSessionSummary | undefined>>;
+}
+export interface WorktreeForkSessionListReader {
+    getSnapshot(): WorktreeForkSessionListSnapshot;
+}
+export interface WorktreeForkRecovery {
+    readonly key: string;
+    readonly sourceSessionId: string;
+    readonly childSessionId: string;
+    readonly binding?: SessionBinding;
+    readonly error: unknown;
+}
+export interface WorktreeForkRecoverySnapshot {
+    readonly revision: number;
+    readonly pending: readonly WorktreeForkRecovery[];
+}
+export interface WorktreeForkRecoveryStore {
+    getSnapshot(): WorktreeForkRecoverySnapshot;
+    subscribe(listener: () => void): () => void;
+}
+export interface WorktreeForkCoordinatorOptions {
+    /** The unwrapped DSH fork method. */
+    readonly fork: (input: WorktreeForkInput) => Promise<string>;
+    /** Find the parent's active sidecar binding across all native Workspaces. */
+    readonly findBinding: (sessionId: string) => Promise<SessionBinding | undefined>;
+    /** Existing Worktree sidecar mutation; it remains the only binding writer. */
+    readonly bindSession: (input: {
+        workspaceId: string;
+        worktreeId: string;
+        sessionId: string;
+    }) => Promise<unknown>;
+    readonly sessions?: WorktreeForkSessionListReader;
+    /** Called after a child binding has been committed and before the view refresh. */
+    readonly onBound?: (binding: SessionBinding) => void;
+}
+export interface WorktreeForkCoordinator {
+    readonly recovery: WorktreeForkRecoveryStore;
+    fork(input: WorktreeForkInput): Promise<string>;
+    reconcile(): Promise<void>;
+    retry(key: string): Promise<boolean>;
+    dispose(): void;
+}
+/**
+ * Coordinate native Session fork with the plugin-owned Worktree relation.
+ * Native Session creation always wins: plugin lookup/bind failures are kept as
+ * recovery state and never turn an already-created child into a failed fork.
+ */
+export declare function createWorktreeSessionForkCoordinator(options: WorktreeForkCoordinatorOptions): WorktreeForkCoordinator;
+//# sourceMappingURL=worktree-session-fork.d.ts.map

package/lib/client/worktree-session-fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-session-fork.d.ts","sourceRoot":"","sources":["../../src/client/worktree-session-fork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,+DAA+D;AAC/D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,0BAA0B,GAAG,SAAS,CAAC,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,IAAI,+BAA+B,CAAC;CAChD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,IAAI,4BAA4B,CAAC;IAC5C,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,8BAA8B;IAC7C,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACjF,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE;QAC5B,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,6BAA6B,CAAC;IAClD,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;CACjB;AAUD;;;;GAIG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,8BAA8B,GACtC,uBAAuB,CAgLzB"}

package/lib/client/worktree-session-fork.js

@@ -0,0 +1,174 @@
+function recoveryKey(sourceSessionId, childSessionId) {
+    return `${sourceSessionId}\u0000${childSessionId}`;
+}
+/**
+ * Coordinate native Session fork with the plugin-owned Worktree relation.
+ * Native Session creation always wins: plugin lookup/bind failures are kept as
+ * recovery state and never turn an already-created child into a failed fork.
+ */
+export function createWorktreeSessionForkCoordinator(options) {
+    let disposed = false;
+    let revision = 0;
+    let pending = new Map();
+    let recoverySnapshot = { revision: 0, pending: [] };
+    const subscribers = new Set();
+    const boundChildren = new Set();
+    const bindingInFlight = new Map();
+    let reconciliationInFlight;
+    let reconciliationAgain = false;
+    const publish = () => {
+        revision += 1;
+        recoverySnapshot = { revision, pending: [...pending.values()] };
+        for (const subscriber of subscribers)
+            subscriber();
+    };
+    const setRecovery = (sourceSessionId, childSessionId, error, target) => {
+        if (disposed)
+            return;
+        const key = recoveryKey(sourceSessionId, childSessionId);
+        pending = new Map(pending).set(key, {
+            key,
+            sourceSessionId,
+            childSessionId,
+            ...(target === undefined ? {} : { binding: target }),
+            error,
+        });
+        publish();
+    };
+    const clearRecovery = (sourceSessionId, childSessionId) => {
+        const key = recoveryKey(sourceSessionId, childSessionId);
+        if (!pending.has(key))
+            return;
+        const next = new Map(pending);
+        next.delete(key);
+        pending = next;
+        publish();
+    };
+    const attemptBinding = async (sourceSessionId, childSessionId) => {
+        if (disposed || boundChildren.has(childSessionId))
+            return { bound: false };
+        let target;
+        try {
+            target = await options.findBinding(sourceSessionId);
+        }
+        catch (error) {
+            setRecovery(sourceSessionId, childSessionId, error);
+            return { bound: false };
+        }
+        if (disposed)
+            return { bound: false };
+        if (target === undefined || target.status !== 'active') {
+            clearRecovery(sourceSessionId, childSessionId);
+            return { bound: false };
+        }
+        try {
+            await options.bindSession({
+                workspaceId: target.workspaceId,
+                worktreeId: target.worktreeId,
+                sessionId: childSessionId,
+            });
+            if (disposed)
+                return { bound: false };
+            const childBinding = {
+                workspaceId: target.workspaceId,
+                worktreeId: target.worktreeId,
+                sessionId: childSessionId,
+                status: 'active',
+            };
+            boundChildren.add(childSessionId);
+            clearRecovery(sourceSessionId, childSessionId);
+            options.onBound?.(childBinding);
+            publish();
+            return { bound: true };
+        }
+        catch (error) {
+            setRecovery(sourceSessionId, childSessionId, error, target);
+            return { bound: false };
+        }
+    };
+    const bindChild = (sourceSessionId, childSessionId) => {
+        if (disposed || boundChildren.has(childSessionId)) {
+            return Promise.resolve({ bound: false });
+        }
+        const key = recoveryKey(sourceSessionId, childSessionId);
+        const current = bindingInFlight.get(key);
+        if (current !== undefined)
+            return current;
+        const promise = attemptBinding(sourceSessionId, childSessionId).finally(() => {
+            if (bindingInFlight.get(key) === promise)
+                bindingInFlight.delete(key);
+        });
+        bindingInFlight.set(key, promise);
+        return promise;
+    };
+    const reconcileNow = async () => {
+        if (disposed || options.sessions === undefined)
+            return;
+        const snapshot = options.sessions.getSnapshot();
+        if (snapshot.phase === 'pending')
+            return;
+        if (!Array.isArray(snapshot.ids) || typeof snapshot.byId !== 'object' || snapshot.byId === null) {
+            return;
+        }
+        const candidates = snapshot.ids.flatMap((childSessionId) => {
+            const summary = snapshot.byId[childSessionId];
+            if (summary?.parentId === undefined ||
+                summary.parentId === childSessionId ||
+                summary.blank === true ||
+                summary.origin === 'subagent' ||
+                snapshot.byId[summary.parentId] === undefined) {
+                return [];
+            }
+            return [{ childSessionId, sourceSessionId: summary.parentId }];
+        });
+        await Promise.all(candidates.map(({ childSessionId, sourceSessionId }) => bindChild(sourceSessionId, childSessionId).then(() => undefined)));
+    };
+    const reconcile = () => {
+        if (reconciliationInFlight !== undefined) {
+            reconciliationAgain = true;
+            return reconciliationInFlight;
+        }
+        const run = async () => {
+            do {
+                reconciliationAgain = false;
+                await reconcileNow();
+            } while (!disposed && reconciliationAgain);
+        };
+        const promise = run().finally(() => {
+            if (reconciliationInFlight === promise)
+                reconciliationInFlight = undefined;
+        });
+        reconciliationInFlight = promise;
+        return promise;
+    };
+    return {
+        recovery: {
+            getSnapshot() {
+                return recoverySnapshot;
+            },
+            subscribe(listener) {
+                subscribers.add(listener);
+                return () => subscribers.delete(listener);
+            },
+        },
+        async fork(input) {
+            const childSessionId = await options.fork(input);
+            if (!disposed)
+                await bindChild(input.sessionId, childSessionId);
+            return childSessionId;
+        },
+        reconcile,
+        async retry(key) {
+            const item = pending.get(key);
+            if (item === undefined || disposed)
+                return false;
+            return (await bindChild(item.sourceSessionId, item.childSessionId)).bound;
+        },
+        dispose() {
+            disposed = true;
+            bindingInFlight.clear();
+            subscribers.clear();
+        },
+    };
+}
+//# sourceMappingURL=worktree-session-fork.js.map

package/lib/client/worktree-session-fork.js.map

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

package/lib/client/worktree-session-order.d.ts

@@ -0,0 +1,36 @@
+import type { createSnapshotStore as runtimeCreateSnapshotStore, SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+/** Browser-only persistence key; this state never crosses the DSH or sidecar boundary. */
+export declare const WORKTREE_SESSION_ORDER_STORAGE_KEY = "clutch-dsh-worktree.session-order";
+export interface SessionOrderAccountState {
+    order: string[];
+    observedUpdatedAt: Record<string, number>;
+}
+export interface WorktreeSessionOrderState {
+    accounts: Record<string, SessionOrderAccountState>;
+}
+export interface WorktreeSessionOrderActions {
+    reconcile: (accountKey: string, baseIds: readonly string[], updatedAtById: Readonly<Record<string, number | undefined>>) => void;
+    setOrder: (accountKey: string, order: readonly string[]) => void;
+    retain: (accountKeys: readonly string[]) => void;
+}
+export interface WorktreeSessionOrderStore extends SnapshotStore<WorktreeSessionOrderState> {
+    readonly actions: WorktreeSessionOrderActions;
+    readonly dispose: () => void;
+}
+export type SnapshotStoreFactory = typeof runtimeCreateSnapshotStore;
+/** Normalize persisted state without trusting any browser-local JSON shape. */
+export declare function normalizeWorktreeSessionOrderState(value: unknown): WorktreeSessionOrderState;
+/**
+ * Native-style activity order transition. The first observation records timestamps
+ * without turning an existing list into a recency sort.
+ */
+export declare function nextSessionOrderAccount(input: {
+    readonly baseIds: readonly string[];
+    readonly updatedAtById: Readonly<Record<string, number | undefined>>;
+    readonly previous?: Readonly<SessionOrderAccountState>;
+}): SessionOrderAccountState;
+/** Apply a successful manual drag without dropping IDs hidden by search. */
+export declare function reorderSessionIds(order: readonly string[], sessionId: string, overSessionId: string, half: 'before' | 'after'): string[];
+/** Create one apply-scoped, browser-local Session ordering store. */
+export declare function createWorktreeSessionOrderStore(snapshotStoreFactory: SnapshotStoreFactory): WorktreeSessionOrderStore;
+//# sourceMappingURL=worktree-session-order.d.ts.map

package/lib/client/worktree-session-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-session-order.d.ts","sourceRoot":"","sources":["../../src/client/worktree-session-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,IAAI,0BAA0B,EACjD,aAAa,EACd,MAAM,wCAAwC,CAAC;AAEhD,0FAA0F;AAC1F,eAAO,MAAM,kCAAkC,sCAAsC,CAAC;AAEtF,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,CACT,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,KACxD,IAAI,CAAC;IACV,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IACjE,MAAM,EAAE,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,yBAA0B,SAAQ,aAAa,CAAC,yBAAyB,CAAC;IACzF,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,0BAA0B,CAAC;AAuCrE,+EAA+E;AAC/E,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CAS5F;AA6BD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC;CACxD,GAAG,wBAAwB,CA4D3B;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,QAAQ,GAAG,OAAO,GACvB,MAAM,EAAE,CAMV;AASD,qEAAqE;AACrE,wBAAgB,+BAA+B,CAC7C,oBAAoB,EAAE,oBAAoB,GACzC,yBAAyB,CAyD3B"}