@cerbur/clutch-dsh-worktree 0.1.0

package/lib/host/dsh-read-adapter.d.ts

@@ -0,0 +1,58 @@
+import type { SessionHeader, SessionId } from '@deepseek-ai/dsh-session/types';
+import type { DshReadAdapter, DshSessionSummary, DshWorkspaceSummary } from '../provider/types.js';
+interface DshWorkspaceView {
+    readonly id: string;
+    readonly path: string;
+    readonly sessionIds: readonly SessionId[];
+}
+type DshSessionHeaderView = Pick<SessionHeader, 'id' | 'cwd'>;
+interface DshSessionView {
+    readonly id: SessionId;
+    readonly header: DshSessionHeaderView;
+}
+/**
+ * plugin 从 DSH Host 消费的最小只读 service slice。
+ *
+ * 接口刻意只包含 Workspace 身份/路径/成员关系和 Session header 查询；没有
+ * Project/Session mutation、transcript、消息或事件内容加载能力。
+ *
+ * Minimal read-only service slice consumed from the DSH Host. It intentionally contains
+ * only Workspace identity/path/membership and Session header queries, with no
+ * Project/Session mutation or transcript, message, or event-content loading capability.
+ */
+export interface DshHostReadContext {
+    /** Workspace 身份、根路径与 Session 成员关系。 / Workspace identity, root, and membership. */
+    readonly workspaceRegistry: {
+        get(id: string): DshWorkspaceView | undefined;
+        list(): readonly DshWorkspaceView[];
+    };
+    /** 当前内存中的 Session header 视图。 / Live in-memory Session header views. */
+    readonly sessions: {
+        get(id: SessionId): DshSessionView | undefined;
+        list(): readonly DshSessionView[];
+    };
+    /**
+     * 仅列出持久化 header；不提供 inspect/load/mutation。
+     * Lists persisted headers only; inspect, load, and mutation are deliberately absent.
+     */
+    readonly sessionPersistence: {
+        list(): Promise<readonly DshSessionHeaderView[]>;
+    };
+}
+/**
+ * 把真实 DSH Host 读取服务适配到 Provider port，同时保持 DSH 是 Workspace 和
+ * Session facts 的唯一来源。
+ *
+ * Adapts real DSH Host reads to the Provider port while preserving DSH as the sole source
+ * of Workspace and Session facts.
+ */
+export declare class DshHostReadAdapter implements DshReadAdapter {
+    private readonly ctx;
+    constructor(ctx: DshHostReadContext);
+    getWorkspace(workspaceId: string): Promise<DshWorkspaceSummary | undefined>;
+    getSession(sessionId: string): Promise<DshSessionSummary | undefined>;
+    listSessions(): Promise<readonly DshSessionSummary[]>;
+    private sessionSummary;
+}
+export {};
+//# sourceMappingURL=dsh-read-adapter.d.ts.map

package/lib/host/dsh-read-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-read-adapter.d.ts","sourceRoot":"","sources":["../../src/host/dsh-read-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE/E,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAE9B,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;CAC3C;AACD,KAAK,oBAAoB,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;AAC9D,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,QAAQ,CAAC,iBAAiB,EAAE;QAC1B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;QAC9C,IAAI,IAAI,SAAS,gBAAgB,EAAE,CAAC;KACrC,CAAC;IACF,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE;QACjB,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,cAAc,GAAG,SAAS,CAAC;QAC/C,IAAI,IAAI,SAAS,cAAc,EAAE,CAAC;KACnC,CAAC;IACF;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,EAAE;QAC3B,IAAI,IAAI,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAC;KAClD,CAAC;CACH;AAED;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,kBAAkB;IAE9C,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAM3E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAYrE,YAAY,IAAI,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;IAe3D,OAAO,CAAC,cAAc;CAcvB"}

package/lib/host/dsh-read-adapter.js

@@ -0,0 +1,59 @@
+/**
+ * 把真实 DSH Host 读取服务适配到 Provider port，同时保持 DSH 是 Workspace 和
+ * Session facts 的唯一来源。
+ *
+ * Adapts real DSH Host reads to the Provider port while preserving DSH as the sole source
+ * of Workspace and Session facts.
+ */
+export class DshHostReadAdapter {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    async getWorkspace(workspaceId) {
+        const workspace = this.ctx.workspaceRegistry.get(workspaceId);
+        if (workspace === undefined)
+            return undefined;
+        return { workspaceId: workspace.id, rootPath: workspace.path };
+    }
+    async getSession(sessionId) {
+        // live header 优先，持久化列表只补齐未加载的 Session；两条路径都不读取 transcript。
+        // Live headers win; the persistence list only fills unloaded Sessions, and neither
+        // path reads transcripts.
+        const live = this.ctx.sessions.get(sessionId);
+        if (live !== undefined)
+            return this.sessionSummary(live.header);
+        const header = (await this.ctx.sessionPersistence.list()).find((candidate) => candidate.id === sessionId);
+        return header === undefined ? undefined : this.sessionSummary(header);
+    }
+    async listSessions() {
+        // 以 Session ID 合并两种 header 来源，既覆盖活跃 Session，也覆盖尚未载入内存的历史
+        // Session，并让最新的 live 视图保留优先级。
+        // Merge both header sources by Session ID to cover active and unloaded historical
+        // Sessions while preserving the live view's precedence.
+        const summaries = new Map();
+        for (const session of this.ctx.sessions.list()) {
+            summaries.set(session.id, this.sessionSummary(session.header));
+        }
+        for (const header of await this.ctx.sessionPersistence.list()) {
+            if (!summaries.has(header.id))
+                summaries.set(header.id, this.sessionSummary(header));
+        }
+        return [...summaries.values()];
+    }
+    sessionSummary(header) {
+        // Workspace 归属从 DSH registry 的成员关系派生，而不是从 cwd 猜测或写入 plugin
+        // sidecar；cwd 也只是读取现有 header fact。
+        // Workspace ownership is derived from DSH registry membership rather than inferred
+        // from cwd or written to the plugin sidecar; cwd is likewise read only as a header fact.
+        const workspaceId = this.ctx.workspaceRegistry
+            .list()
+            .find((workspace) => workspace.sessionIds.includes(header.id))?.id;
+        return {
+            sessionId: header.id,
+            ...(workspaceId === undefined ? {} : { workspaceId }),
+            cwd: header.cwd ?? '',
+        };
+    }
+}
+//# sourceMappingURL=dsh-read-adapter.js.map

package/lib/host/dsh-read-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-read-adapter.js","sourceRoot":"","sources":["../../src/host/dsh-read-adapter.ts"],"names":[],"mappings":"AAiDA;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;IAAG,CAAC;IAExD,KAAK,CAAC,YAAY,CAAC,WAAmB;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9D,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC9C,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,2DAA2D;QAC3D,mFAAmF;QACnF,0BAA0B;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAsB,CAAC,CAAC;QAC3D,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAC5D,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,SAAS,CAC1C,CAAC;QACF,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,yDAAyD;QACzD,8BAA8B;QAC9B,kFAAkF;QAClF,wDAAwD;QACxD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;QACvD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/C,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAAE,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;IAEO,cAAc,CAAC,MAA4B;QACjD,2DAA2D;QAC3D,mCAAmC;QACnC,mFAAmF;QACnF,yFAAyF;QACzF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB;aAC3C,IAAI,EAAE;aACN,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QACrE,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,EAAE;YACpB,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;YACrD,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;CACF"}

package/lib/host/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Host-only 组合面：连接真实 DSH 服务、Manage 用例与 Typert Remote 投影。
+ * 浏览器 Consumer 必须经 `../client/index.js` 的 facade 访问，不能导入这里的运行时。
+ *
+ * Host-only composition surface connecting real DSH services, Manage use cases, and
+ * the Typert Remote projection. Browser consumers must go through the facade in
+ * `../client/index.js` rather than importing this runtime surface.
+ *
+ * @packageDocumentation
+ */
+export { DshHostReadAdapter } from './dsh-read-adapter.js';
+export type { DshHostReadContext } from './dsh-read-adapter.js';
+export { createWorktreeRemoteProjection } from './remote.js';
+export { WorktreeRemoteService } from './service.js';
+export type { WorktreeHostConfig } from './service.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/host/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/lib/host/index.js

@@ -0,0 +1,14 @@
+/**
+ * Host-only 组合面：连接真实 DSH 服务、Manage 用例与 Typert Remote 投影。
+ * 浏览器 Consumer 必须经 `../client/index.js` 的 facade 访问，不能导入这里的运行时。
+ *
+ * Host-only composition surface connecting real DSH services, Manage use cases, and
+ * the Typert Remote projection. Browser consumers must go through the facade in
+ * `../client/index.js` rather than importing this runtime surface.
+ *
+ * @packageDocumentation
+ */
+export { DshHostReadAdapter } from './dsh-read-adapter.js';
+export { createWorktreeRemoteProjection } from './remote.js';
+export { WorktreeRemoteService } from './service.js';
+//# sourceMappingURL=index.js.map

package/lib/host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/lib/host/remote.d.ts

@@ -0,0 +1,16 @@
+import { type WorktreeManager, type WorktreeRemoteManager } from '../contract/index.js';
+/**
+ * 将 Host 内的 Manage 能力投影为 DSH Remote 可传输的 plain-JSON contract。
+ *
+ * 该边界只暴露稳定结果和错误值，不泄漏 Manager 实例、Provider class、Git、sidecar
+ * 或其他 Node-only 对象。
+ *
+ * Projects Host-side Manage capabilities into the plain-JSON contract carried by DSH
+ * Remote. The boundary exposes only stable result and error values, never Manager
+ * instances, Provider classes, Git, sidecar, or other Node-only objects.
+ *
+ * @param manager - Host 内已组合完成的用例接口。 / Fully composed Host use-case port.
+ * @returns 可供生成 Remote 暴露的安全投影。 / Safe projection for generated Remote export.
+ */
+export declare function createWorktreeRemoteProjection(manager: WorktreeManager): WorktreeRemoteManager;
+//# sourceMappingURL=remote.d.ts.map

package/lib/host/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/host/remote.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAE3B,MAAM,sBAAsB,CAAC;AAkC9B;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,eAAe,GAAG,qBAAqB,CAgB9F"}

package/lib/host/remote.js

@@ -0,0 +1,61 @@
+import { WORKTREE_ERROR_CODES, createWorktreeError, } from '../contract/index.js';
+const worktreeErrorCodes = new Set(WORKTREE_ERROR_CODES);
+function isWorktreeError(error) {
+    if (typeof error !== 'object' || error === null || Array.isArray(error))
+        return false;
+    const candidate = error;
+    return (typeof candidate.code === 'string' &&
+        worktreeErrorCodes.has(candidate.code) &&
+        typeof candidate.message === 'string' &&
+        typeof candidate.details === 'object' &&
+        candidate.details !== null &&
+        !Array.isArray(candidate.details));
+}
+async function project(operation) {
+    try {
+        return { ok: true, value: await operation() };
+    }
+    catch (error) {
+        // 只有稳定、可识别的领域错误进入 browser-safe Result；未知异常继续交给 DSH
+        // Gateway 作为 transport/Host failure 处理，避免把基础设施故障伪装成业务拒绝。
+        // Only stable, recognized domain errors enter the browser-safe Result. Unknown
+        // exceptions continue to the DSH Gateway as transport/Host failures instead of being
+        // disguised as business rejections.
+        if (!isWorktreeError(error))
+            throw error;
+        return {
+            ok: false,
+            error: createWorktreeError(error.code, error.message, error.details),
+        };
+    }
+}
+/**
+ * 将 Host 内的 Manage 能力投影为 DSH Remote 可传输的 plain-JSON contract。
+ *
+ * 该边界只暴露稳定结果和错误值，不泄漏 Manager 实例、Provider class、Git、sidecar
+ * 或其他 Node-only 对象。
+ *
+ * Projects Host-side Manage capabilities into the plain-JSON contract carried by DSH
+ * Remote. The boundary exposes only stable result and error values, never Manager
+ * instances, Provider classes, Git, sidecar, or other Node-only objects.
+ *
+ * @param manager - Host 内已组合完成的用例接口。 / Fully composed Host use-case port.
+ * @returns 可供生成 Remote 暴露的安全投影。 / Safe projection for generated Remote export.
+ */
+export function createWorktreeRemoteProjection(manager) {
+    return {
+        listWorktrees: (input) => project(() => manager.listWorktrees(input)),
+        listBranches: (input) => project(() => manager.listBranches(input)),
+        createWorktree: (input) => project(() => manager.createWorktree(input)),
+        removeWorktree: (input) => project(async () => {
+            await manager.removeWorktree(input);
+            // `void` 没有 JSON 表示，因此成功删除在 wire contract 中显式投影为 null。
+            // `void` has no JSON representation, so successful removal is explicitly projected
+            // to null in the wire contract.
+            return null;
+        }),
+        listBindings: (input) => project(() => manager.listBindings(input)),
+        bindSession: (input) => project(() => manager.bindSession(input)),
+    };
+}
+//# sourceMappingURL=remote.js.map

package/lib/host/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../src/host/remote.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GAKpB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS,oBAAoB,CAAC,CAAC;AAEjE,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,SAAS,GAAG,KAA+B,CAAC;IAClD,OAAO,CACL,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAClC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;QACtC,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ;QACrC,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ;QACrC,SAAS,CAAC,OAAO,KAAK,IAAI;QAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAClC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,OAAO,CAAQ,SAA+B;IAC3D,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,SAAS,EAAE,EAAE,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mDAAmD;QACnD,yDAAyD;QACzD,+EAA+E;QAC/E,qFAAqF;QACrF,oCAAoC;QACpC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC;QACzC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;SACrE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAAwB;IACrE,OAAO;QACL,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACrE,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACnE,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACvE,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CACxB,OAAO,CAAC,KAAK,IAAI,EAAE;YACjB,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACpC,uDAAuD;YACvD,mFAAmF;YACnF,gCAAgC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QACJ,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACnE,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/lib/host/service.d.ts

@@ -0,0 +1,58 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { BranchRecord, SessionBinding, WorktreeRecord, WorktreeRemoteResult } from '../contract/index.js';
+/**
+ * Host composition 所需且由 DSH bundle 注入的配置。
+ * Configuration supplied by the DSH bundle to the Host composition.
+ */
+export interface WorktreeHostConfig {
+    /** DSH 解析后的绝对数据根目录。 / Absolute DSH data root resolved by the Host. */
+    readonly dshHome: string;
+}
+/**
+ * Worktree plugin 的真实 composition root。
+ *
+ * Cordis 构造该服务时，以 `worktreeManager` 注册 Typert namespace，并把只读 DSH
+ * adapter、Manage 实现和 browser-safe projection 组合成一个同生命周期对象；所属
+ * Cordis fiber 卸载时，服务注册也随之移除。
+ *
+ * The real composition root for the Worktree plugin. When Cordis constructs it, the
+ * service registers the `worktreeManager` Typert namespace and composes the read-only
+ * DSH adapter, Manage implementation, and browser-safe projection into one
+ * lifecycle-bound object. Its service registration is removed with the owning fiber.
+ */
+export declare class WorktreeRemoteService extends TypertRemoteService {
+    static inject: string[];
+    private readonly remote;
+    /**
+     * 为当前 Cordis fiber 建立一次 Host 组合，并复用同一个 Remote projection 处理调用。
+     * Builds the Host composition once for the current Cordis fiber and reuses one Remote
+     * projection for all calls.
+     */
+    constructor(ctx: Context, config: WorktreeHostConfig);
+    listWorktrees(input: {
+        readonly workspaceId: string;
+    }): Promise<WorktreeRemoteResult<readonly WorktreeRecord[]>>;
+    listBranches(input: {
+        readonly workspaceId: string;
+    }): Promise<WorktreeRemoteResult<readonly BranchRecord[]>>;
+    createWorktree(input: {
+        readonly workspaceId: string;
+        readonly branch: string;
+        readonly newBranch?: string;
+    }): Promise<WorktreeRemoteResult<WorktreeRecord>>;
+    removeWorktree(input: {
+        readonly workspaceId: string;
+        readonly worktreeId: string;
+    }): Promise<WorktreeRemoteResult<null>>;
+    listBindings(input: {
+        readonly workspaceId: string;
+    }): Promise<WorktreeRemoteResult<readonly SessionBinding[]>>;
+    bindSession(input: {
+        readonly workspaceId: string;
+        readonly worktreeId: string;
+        readonly sessionId: string;
+    }): Promise<WorktreeRemoteResult<SessionBinding>>;
+}
+export default WorktreeRemoteService;
+//# sourceMappingURL=service.d.ts.map

package/lib/host/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/host/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAU,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE/E,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EAEd,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAQ9B;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,qBAAsB,SAAQ,mBAAmB;IAI5D,MAAM,CAAC,MAAM,WAA2D;IAExE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAE/C;;;;OAIG;gBACS,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB;IAgBpD,aAAa,CAAC,KAAK,EAAE;QACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;KAC9B,GAAG,OAAO,CAAC,oBAAoB,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IAK5D,YAAY,CAAC,KAAK,EAAE;QAClB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;KAC9B,GAAG,OAAO,CAAC,oBAAoB,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IAK1D,cAAc,CAAC,KAAK,EAAE;QACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;KAC7B,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAKjD,cAAc,CAAC,KAAK,EAAE;QACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,GAAG,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAKvC,YAAY,CAAC,KAAK,EAAE;QAClB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;KAC9B,GAAG,OAAO,CAAC,oBAAoB,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IAK5D,WAAW,CAAC,KAAK,EAAE;QACjB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;CAGlD;AAED,eAAe,qBAAqB,CAAC"}

package/lib/host/service.js

@@ -0,0 +1,121 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import { createWorktreeManager } from '../manage/index.js';
+import { DshHostReadAdapter, } from './dsh-read-adapter.js';
+import { createWorktreeRemoteProjection } from './remote.js';
+/**
+ * Worktree plugin 的真实 composition root。
+ *
+ * Cordis 构造该服务时，以 `worktreeManager` 注册 Typert namespace，并把只读 DSH
+ * adapter、Manage 实现和 browser-safe projection 组合成一个同生命周期对象；所属
+ * Cordis fiber 卸载时，服务注册也随之移除。
+ *
+ * The real composition root for the Worktree plugin. When Cordis constructs it, the
+ * service registers the `worktreeManager` Typert namespace and composes the read-only
+ * DSH adapter, Manage implementation, and browser-safe projection into one
+ * lifecycle-bound object. Its service registration is removed with the owning fiber.
+ */
+let WorktreeRemoteService = (() => {
+    let _classSuper = TypertRemoteService;
+    let _instanceExtraInitializers = [];
+    let _listWorktrees_decorators;
+    let _listBranches_decorators;
+    let _createWorktree_decorators;
+    let _removeWorktree_decorators;
+    let _listBindings_decorators;
+    let _bindSession_decorators;
+    return class WorktreeRemoteService extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _listWorktrees_decorators = [Remote];
+            _listBranches_decorators = [Remote];
+            _createWorktree_decorators = [Remote];
+            _removeWorktree_decorators = [Remote];
+            _listBindings_decorators = [Remote];
+            _bindSession_decorators = [Remote];
+            __esDecorate(this, null, _listWorktrees_decorators, { kind: "method", name: "listWorktrees", static: false, private: false, access: { has: obj => "listWorktrees" in obj, get: obj => obj.listWorktrees }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _listBranches_decorators, { kind: "method", name: "listBranches", static: false, private: false, access: { has: obj => "listBranches" in obj, get: obj => obj.listBranches }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _createWorktree_decorators, { kind: "method", name: "createWorktree", static: false, private: false, access: { has: obj => "createWorktree" in obj, get: obj => obj.createWorktree }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _removeWorktree_decorators, { kind: "method", name: "removeWorktree", static: false, private: false, access: { has: obj => "removeWorktree" in obj, get: obj => obj.removeWorktree }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _listBindings_decorators, { kind: "method", name: "listBindings", static: false, private: false, access: { has: obj => "listBindings" in obj, get: obj => obj.listBindings }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _bindSession_decorators, { kind: "method", name: "bindSession", static: false, private: false, access: { has: obj => "bindSession" in obj, get: obj => obj.bindSession }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        // Cordis 在实例化前保证这三个只读 Host 服务可用；这里不注入任何 DSH mutation API。
+        // Cordis ensures these three read-only Host services exist before instantiation; no
+        // DSH mutation API is injected here.
+        static inject = ['workspaceRegistry', 'sessions', 'sessionPersistence'];
+        remote = __runInitializers(this, _instanceExtraInitializers);
+        /**
+         * 为当前 Cordis fiber 建立一次 Host 组合，并复用同一个 Remote projection 处理调用。
+         * Builds the Host composition once for the current Cordis fiber and reuses one Remote
+         * projection for all calls.
+         */
+        constructor(ctx, config) {
+            super(ctx, 'worktreeManager');
+            this.remote = createWorktreeRemoteProjection(createWorktreeManager({
+                dsh: new DshHostReadAdapter(ctx),
+                dshHome: config.dshHome,
+            }));
+        }
+        // 这些方法保持为薄边界，生成的 Typert 描述符只看到 contract-safe 签名；错误归一化
+        // 和 JSON 投影集中由 `createWorktreeRemoteProjection` 负责。
+        // These methods stay deliberately thin so generated Typert descriptors see only
+        // contract-safe signatures; error normalization and JSON projection remain centralized
+        // in `createWorktreeRemoteProjection`.
+        listWorktrees(input) {
+            return this.remote.listWorktrees(input);
+        }
+        listBranches(input) {
+            return this.remote.listBranches(input);
+        }
+        createWorktree(input) {
+            return this.remote.createWorktree(input);
+        }
+        removeWorktree(input) {
+            return this.remote.removeWorktree(input);
+        }
+        listBindings(input) {
+            return this.remote.listBindings(input);
+        }
+        bindSession(input) {
+            return this.remote.bindSession(input);
+        }
+    };
+})();
+export { WorktreeRemoteService };
+export default WorktreeRemoteService;
+//# sourceMappingURL=service.js.map

package/lib/host/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/host/service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAS/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EACL,kBAAkB,GAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAW7D;;;;;;;;;;;GAWG;IACU,qBAAqB;sBAAS,mBAAmB;;;;;;;;iBAAjD,qBAAsB,SAAQ,WAAmB;;;yCA4B3D,MAAM;wCAON,MAAM;0CAON,MAAM;0CASN,MAAM;wCAQN,MAAM;uCAON,MAAM;YArCP,0LAAA,aAAa,6DAIZ;YAGD,uLAAA,YAAY,6DAIX;YAGD,6LAAA,cAAc,6DAMb;YAGD,6LAAA,cAAc,6DAKb;YAGD,uLAAA,YAAY,6DAIX;YAGD,oLAAA,WAAW,6DAMV;;;QAxED,0DAA0D;QAC1D,oFAAoF;QACpF,qCAAqC;QACrC,MAAM,CAAC,MAAM,GAAG,CAAC,mBAAmB,EAAE,UAAU,EAAE,oBAAoB,CAAC,CAAC;QAEvD,MAAM,GANZ,mDAAqB,CAMe;QAE/C;;;;WAIG;QACH,YAAY,GAAY,EAAE,MAA0B;YAClD,KAAK,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,8BAA8B,CAC1C,qBAAqB,CAAC;gBACpB,GAAG,EAAE,IAAI,kBAAkB,CAAC,GAAmC,CAAC;gBAChE,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CACH,CAAC;QACJ,CAAC;QAED,sDAAsD;QACtD,oDAAoD;QACpD,gFAAgF;QAChF,uFAAuF;QACvF,uCAAuC;QAEvC,aAAa,CAAC,KAEb;YACC,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QAGD,YAAY,CAAC,KAEZ;YACC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAGD,cAAc,CAAC,KAId;YACC,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC;QAGD,cAAc,CAAC,KAGd;YACC,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC;QAGD,YAAY,CAAC,KAEZ;YACC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAGD,WAAW,CAAC,KAIX;YACC,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;;;SAzEU,qBAAqB;AA4ElC,eAAe,qBAAqB,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * package 的 Host 入口：汇总稳定 contract、Node 侧 Provider/Manage 实现与真实 DSH
+ * composition root。浏览器代码应改用 `./client`，避免把 Git、sidecar 或 Host 运行时
+ * 带入 browser bundle。
+ *
+ * Package Host entry: it gathers the stable contract, Node-side Provider/Manage
+ * implementations, and the real DSH composition root. Browser code should import
+ * `./client` instead so Git, sidecar, and Host runtime code stay out of browser bundles.
+ *
+ * @packageDocumentation
+ */
+export { WORKTREE_ERROR_CODES, WORKTREE_REMOTE_METHODS, createWorktreeError, } from './contract/index.js';
+export type { BranchRecord, BindingStatus, JsonPrimitive, JsonValue, SessionBinding, WorktreeError, WorktreeErrorCode, WorktreeErrorDetails, WorktreeManager, WorktreeRemoteManager, WorktreeRemoteMethod, WorktreeRemoteResult, WorktreeRecord, WorktreeStatus, WorktreeId, WorkspaceId, SessionId, } from './contract/index.js';
+export { LocalGitAdapter } from './provider/git.js';
+export { WorkspaceShardedSidecarRepository, validateSidecarSnapshot, } from './provider/sidecar.js';
+export { SIDECAR_SCHEMA_VERSION, WorktreeProviderError, isWorktreeProviderError, providerError, } from './provider/types.js';
+export type { DshReadAdapter, DshSessionSummary, DshWorkspaceSummary, GitWorktreeAdapter, GitWorktreeInfo, SidecarMutation, SidecarSnapshot, SidecarStore, } from './provider/types.js';
+export { WorktreeManagerImpl, createWorktreeManager } from './manage/index.js';
+export type { RuntimeCwdInput, WorktreeManagerOptions, WorktreeManagerService, } from './manage/index.js';
+export { DshHostReadAdapter, WorktreeRemoteService, createWorktreeRemoteProjection, } from './host/index.js';
+export type { DshHostReadContext, WorktreeHostConfig } from './host/index.js';
+export { WorktreeRemoteService as default } from './host/index.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,SAAS,EACT,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,UAAU,EACV,WAAW,EACX,SAAS,GACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,iCAAiC,EACjC,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAK9E,OAAO,EAAE,qBAAqB,IAAI,OAAO,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/index.js

@@ -0,0 +1,22 @@
+/**
+ * package 的 Host 入口：汇总稳定 contract、Node 侧 Provider/Manage 实现与真实 DSH
+ * composition root。浏览器代码应改用 `./client`，避免把 Git、sidecar 或 Host 运行时
+ * 带入 browser bundle。
+ *
+ * Package Host entry: it gathers the stable contract, Node-side Provider/Manage
+ * implementations, and the real DSH composition root. Browser code should import
+ * `./client` instead so Git, sidecar, and Host runtime code stay out of browser bundles.
+ *
+ * @packageDocumentation
+ */
+export { WORKTREE_ERROR_CODES, WORKTREE_REMOTE_METHODS, createWorktreeError, } from './contract/index.js';
+export { LocalGitAdapter } from './provider/git.js';
+export { WorkspaceShardedSidecarRepository, validateSidecarSnapshot, } from './provider/sidecar.js';
+export { SIDECAR_SCHEMA_VERSION, WorktreeProviderError, isWorktreeProviderError, providerError, } from './provider/types.js';
+export { WorktreeManagerImpl, createWorktreeManager } from './manage/index.js';
+export { DshHostReadAdapter, WorktreeRemoteService, createWorktreeRemoteProjection, } from './host/index.js';
+// bundle patch 以默认导出装载同一个 Cordis 服务；命名导出保留给显式 Host 组合。
+// The bundle patch loads the same Cordis service through the default export; the named
+// export remains available to explicit Host compositions.
+export { WorktreeRemoteService as default } from './host/index.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAoB7B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,iCAAiC,EACjC,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAW7B,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAM/E,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AAGzB,uDAAuD;AACvD,uFAAuF;AACvF,0DAA0D;AAC1D,OAAO,EAAE,qBAAqB,IAAI,OAAO,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/manage/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Manage 模块的公开入口：暴露用例编排与 runtime cwd 服务，并通过注入隐藏底层 Git/sidecar 实现。
+ * Public Manage entrypoint: exposes use-case orchestration and runtime cwd services while keeping Git/sidecar implementations behind injection.
+ *
+ * @packageDocumentation
+ */
+export { WorktreeManagerImpl, createWorktreeManager } from './manager.js';
+export type { RuntimeCwdInput, WorktreeManagerOptions, WorktreeManagerService, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/manage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1E,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/lib/manage/index.js

@@ -0,0 +1,8 @@
+/**
+ * Manage 模块的公开入口：暴露用例编排与 runtime cwd 服务，并通过注入隐藏底层 Git/sidecar 实现。
+ * Public Manage entrypoint: exposes use-case orchestration and runtime cwd services while keeping Git/sidecar implementations behind injection.
+ *
+ * @packageDocumentation
+ */
+export { WorktreeManagerImpl, createWorktreeManager } from './manager.js';
+//# sourceMappingURL=index.js.map

package/lib/manage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/manage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/lib/manage/manager.d.ts

@@ -0,0 +1,86 @@
+import type { BranchRecord, SessionBinding, WorktreeRecord, WorkspaceId } from '../contract/index.js';
+import type { WorktreeManagerOptions, WorktreeManagerService } from './types.js';
+/**
+ * Worktree/Session 用例编排器：DSH 只提供权威只读事实，Git 承担 worktree 副作用，sidecar 只保存外部关系。
+ * Worktree/Session use-case orchestrator: DSH supplies authoritative read-only facts, Git owns worktree side effects, and the sidecar stores only external relations.
+ */
+export declare class WorktreeManagerImpl implements WorktreeManagerService {
+    private readonly dsh;
+    private readonly dshHome;
+    private readonly git;
+    private readonly sidecar;
+    private readonly idFactory;
+    /**
+     * 使用可注入端口组合 Manager；未注入的 Git 与 sidecar 端口会绑定到本地 Provider 实现。
+     * Composes the Manager from injectable ports; omitted Git and sidecar ports bind to local Provider implementations.
+     */
+    constructor(options: WorktreeManagerOptions);
+    /**
+     * 返回含 active/removed 状态的 sidecar Worktree 投影。
+     * Returns the sidecar Worktree projection, including active/removed state.
+     */
+    listWorktrees(input: {
+        workspaceId: WorkspaceId;
+    }): Promise<readonly WorktreeRecord[]>;
+    /**
+     * 将本地分支与所有 Git worktree 联合投影，以便调用方禁用已 checkout 的分支。
+     * Projects local branches against every Git worktree so callers can disable branches that are already checked out.
+     */
+    listBranches(input: {
+        workspaceId: WorkspaceId;
+    }): Promise<readonly BranchRecord[]>;
+    /**
+     * 创建受 DSH Home 边界管理的 Git Worktree，并仅在 sidecar 提交成功后返回；已 checkout 的
+     * base branch 可以通过 newBranch 创建新的本地 branch。持久化失败会补偿删除 Git Worktree。
+     * Creates a Git Worktree inside the managed DSH Home boundary and returns only after sidecar
+     * commit. An already checked-out base branch can create a new local branch through newBranch.
+     * Persistence failure compensates by removing the Git Worktree.
+     */
+    createWorktree(input: {
+        workspaceId: WorkspaceId;
+        branch: string;
+        newBranch?: string;
+    }): Promise<WorktreeRecord>;
+    /**
+     * 先删除 Git Worktree，再原子标记 record 为 removed 并保留 detached bindings；失败阶段决定该操作是否可直接重试或需要同步修复。
+     * Removes the Git Worktree first, then atomically marks its record removed and preserves detached bindings; the failure phase determines whether retry or synchronization repair is required.
+     */
+    removeWorktree(input: {
+        workspaceId: WorkspaceId;
+        worktreeId: string;
+    }): Promise<void>;
+    /**
+     * 返回 Workspace 的 active/detached Session 关系。
+     * Returns active/detached Session relations for the Workspace.
+     */
+    listBindings(input: {
+        workspaceId: WorkspaceId;
+    }): Promise<readonly SessionBinding[]>;
+    /**
+     * 将已由 DSH 创建且 cwd 指向目标 Worktree 的 Session 绑定到 sidecar；相同 active 请求幂等，其他既有关系一律冲突。
+     * Binds a DSH-created Session whose cwd already targets the Worktree; the same active request is idempotent and every other existing relation conflicts.
+     */
+    bindSession(input: {
+        workspaceId: WorkspaceId;
+        worktreeId: string;
+        sessionId: string;
+    }): Promise<SessionBinding>;
+    /**
+     * 派生一次执行的 cwd：无 binding 或 detached 时使用 Workspace root，active 时要求对应 Worktree 记录和目录均有效。
+     * Derives cwd for one execution: no binding or detached uses the Workspace root, while active requires both a valid Worktree record and directory.
+     */
+    resolveRuntimeCwd(input: {
+        workspaceId: WorkspaceId;
+        sessionId: string;
+    }): Promise<string>;
+    private requireWorkspace;
+    private validateGeneratedPath;
+    private validatePhysicalGeneratedPath;
+    private assertSessionMatchesWorkspace;
+}
+/**
+ * 创建实现 `WorktreeManagerService` 的默认编排器，同时保留所有底层端口的注入能力。
+ * Creates the default `WorktreeManagerService` orchestrator while preserving injection for every low-level port.
+ */
+export declare function createWorktreeManager(options: WorktreeManagerOptions): WorktreeManagerService;
+//# sourceMappingURL=manager.d.ts.map

package/lib/manage/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/manage/manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAc9B,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AA2FjF;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,sBAAsB;IAChE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgC;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC;;;OAGG;gBACS,OAAO,EAAE,sBAAsB;IAa3C;;;OAGG;IACG,aAAa,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IAsC5F;;;OAGG;IACG,YAAY,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC;IAyBzF;;;;;;OAMG;IACG,cAAc,CAAC,KAAK,EAAE;QAC1B,WAAW,EAAE,WAAW,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,cAAc,CAAC;IA0I3B;;;OAGG;IACG,cAAc,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,WAAW,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgF5F;;;OAGG;IACG,YAAY,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IAK3F;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE;QACvB,WAAW,EAAE,WAAW,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,cAAc,CAAC;IAwD3B;;;OAGG;IACG,iBAAiB,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,WAAW,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YAqClF,gBAAgB;IA6B9B,OAAO,CAAC,qBAAqB;YAaf,6BAA6B;IA4B3C,OAAO,CAAC,6BAA6B;CAuBtC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,sBAAsB,CAE7F"}