dsh-git-worktree 0.1.0

package/lib/adapters/registry.js

@@ -0,0 +1,242 @@
+/**
+ * Durable registry adapter: the session-checkout registry (version 2) as one
+ * atomic JSON file under the plugin's state directory. Validation gates every
+ * read — a corrupt file fails loud instead of being silently overwritten;
+ * v1 records migrate conservatively to `recovery_required` like Domi.
+ * @module dsh-git-worktree/adapters/registry
+ */
+import { existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { SessionCheckoutError } from '../index.js';
+import { readJsonFileSafe, writeJsonFileAtomic } from './safe-file.js';
+function emptyRegistry() {
+    return {
+        version: 2,
+        revision: 0,
+        sessionBindings: {},
+        managedCheckouts: {},
+    };
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+function isTargetRef(value) {
+    if (!isRecord(value) || typeof value.kind !== 'string')
+        return false;
+    return value.kind === 'unselected'
+        || value.kind === 'local'
+        || (value.kind === 'isolated' && typeof value.checkoutId === 'string');
+}
+function isSessionBinding(value) {
+    return isRecord(value)
+        && typeof value.sessionId === 'string'
+        && typeof value.projectId === 'string'
+        && typeof value.projectName === 'string'
+        && isTargetRef(value.target)
+        && typeof value.ownerSessionId === 'string'
+        && typeof value.sourceRef === 'string'
+        && typeof value.sourceOid === 'string'
+        && typeof value.revision === 'number';
+}
+function isReview(value) {
+    return isRecord(value)
+        && typeof value.reviewId === 'string'
+        && typeof value.iteration === 'number'
+        && typeof value.preparedAt === 'number'
+        && (value.detailsMarkdown === undefined || typeof value.detailsMarkdown === 'string')
+        && typeof value.summary === 'string'
+        && (value.validationStatus === 'passed' || value.validationStatus === 'failed' || value.validationStatus === 'partial' || value.validationStatus === 'not_run')
+        && (value.validationSummary === undefined || typeof value.validationSummary === 'string')
+        && Array.isArray(value.tests)
+        && value.tests.every((test) => isRecord(test)
+            && typeof test.command === 'string'
+            && (test.status === 'passed' || test.status === 'failed' || test.status === 'not_run')
+            && (test.summary === undefined || typeof test.summary === 'string'))
+        && isStringArray(value.changedFiles)
+        && typeof value.suggestedCommitMessage === 'string'
+        && typeof value.isolatedFingerprint === 'string'
+        && typeof value.isolatedHeadOid === 'string';
+}
+function isDeliveryProof(value) {
+    return isRecord(value)
+        && (value.localBranch === null || typeof value.localBranch === 'string')
+        && typeof value.localHeadBefore === 'string'
+        && typeof value.localHeadAfter === 'string'
+        && isStringArray(value.changedFiles);
+}
+function isDelivery(value) {
+    if (!isRecord(value) || typeof value.state !== 'string')
+        return false;
+    if (value.state === 'working')
+        return typeof value.iteration === 'number';
+    if (value.state === 'ready_for_review')
+        return isReview(value.review);
+    if (value.state === 'finalized') {
+        return isReview(value.review)
+            && (value.commitOid === null || typeof value.commitOid === 'string')
+            && (value.proof === undefined || isDeliveryProof(value.proof))
+            && typeof value.isolatedFingerprint === 'string'
+            && typeof value.finalizedAt === 'number'
+            && (value.cleanup === 'pending' || value.cleanup === 'blocked')
+            && (value.cleanupMessage === undefined || typeof value.cleanupMessage === 'string');
+    }
+    if (value.state === 'retained') {
+        return isReview(value.review)
+            && (value.commitOid === null || typeof value.commitOid === 'string')
+            && (value.proof === undefined || isDeliveryProof(value.proof))
+            && typeof value.isolatedFingerprint === 'string'
+            && (value.retention === 'retain_24h' || value.retention === 'retain_3d' || value.retention === 'retain_manual')
+            && typeof value.retainedAt === 'number'
+            && (value.expiresAt === null || typeof value.expiresAt === 'number')
+            && (value.cleanup === 'scheduled' || value.cleanup === 'blocked')
+            && (value.cleanupMessage === undefined || typeof value.cleanupMessage === 'string');
+    }
+    if (value.state === 'delivered') {
+        return typeof value.iteration === 'number'
+            && (value.commitOid === null || typeof value.commitOid === 'string')
+            && (value.proof === undefined || isDeliveryProof(value.proof))
+            && typeof value.deliveredAt === 'number';
+    }
+    return false;
+}
+function isJournal(value) {
+    if (value === null)
+        return true;
+    if (!isRecord(value)
+        || typeof value.operationId !== 'string'
+        || typeof value.step !== 'string'
+        || typeof value.startedAt !== 'number')
+        return false;
+    if (value.operation === 'create')
+        return value.step === 'creating_worktree';
+    const validOperation = value.operation === 'apply'
+        || value.operation === 'finish'
+        || value.operation === 'cleanup';
+    const validStep = value.step === 'planning'
+        || value.step === 'writing_local'
+        || value.step === 'removing_worktree';
+    return validOperation
+        && validStep
+        && (value.baseOid === undefined || typeof value.baseOid === 'string')
+        && (value.planRevision === undefined || typeof value.planRevision === 'string')
+        && (value.localFingerprint === undefined || typeof value.localFingerprint === 'string')
+        && (value.isolatedFingerprint === undefined || typeof value.isolatedFingerprint === 'string')
+        && (value.effectiveBaseOid === undefined || typeof value.effectiveBaseOid === 'string')
+        && (value.baseStrategy === undefined || value.baseStrategy === 'recorded_base' || value.baseStrategy === 'isolated_contains_local_head' || value.baseStrategy === 'local_contains_isolated_head')
+        && (value.localHeadOid === undefined || typeof value.localHeadOid === 'string')
+        && (value.isolatedHeadOid === undefined || typeof value.isolatedHeadOid === 'string')
+        && (value.commitOid === undefined || typeof value.commitOid === 'string')
+        && (value.retention === undefined || value.retention === 'cleanup' || value.retention === 'retain_24h' || value.retention === 'retain_3d' || value.retention === 'retain_manual')
+        && (value.changedFiles === undefined || isStringArray(value.changedFiles));
+}
+function isManagedCheckout(value) {
+    return isRecord(value)
+        && typeof value.checkoutId === 'string'
+        && typeof value.projectId === 'string'
+        && typeof value.projectName === 'string'
+        && typeof value.ownerSessionId === 'string'
+        && typeof value.localRoot === 'string'
+        && typeof value.managedRoot === 'string'
+        && typeof value.managedGitRoot === 'string'
+        && typeof value.gitCommonDir === 'string'
+        && typeof value.gitDir === 'string'
+        && typeof value.baseOid === 'string'
+        && (value.applyBaseOid === undefined || typeof value.applyBaseOid === 'string')
+        && typeof value.sourceRef === 'string'
+        && (value.phase === 'preparing' || value.phase === 'ready' || value.phase === 'mutating' || value.phase === 'recovery_required' || value.phase === 'finalized' || value.phase === 'retained' || value.phase === 'discarded')
+        && isDelivery(value.delivery)
+        && isJournal(value.journal)
+        && typeof value.revision === 'number';
+}
+function isRegistry(value) {
+    if (!isRecord(value)
+        || value.version !== 2
+        || typeof value.revision !== 'number'
+        || !isRecord(value.sessionBindings)
+        || !isRecord(value.managedCheckouts))
+        return false;
+    return Object.values(value.sessionBindings).every(isSessionBinding)
+        && Object.values(value.managedCheckouts).every(isManagedCheckout);
+}
+function migrateLegacyRegistry(value) {
+    if (!isRecord(value)
+        || value.version !== 1
+        || typeof value.revision !== 'number'
+        || !isRecord(value.sessionBindings)
+        || !isRecord(value.managedCheckouts)
+        || !Object.values(value.sessionBindings).every(isSessionBinding))
+        return null;
+    const managedCheckouts = {};
+    for (const [checkoutId, raw] of Object.entries(value.managedCheckouts)) {
+        if (!isRecord(raw)
+            || typeof raw.checkoutId !== 'string'
+            || typeof raw.projectId !== 'string'
+            || typeof raw.projectName !== 'string'
+            || typeof raw.ownerSessionId !== 'string'
+            || typeof raw.localRoot !== 'string'
+            || typeof raw.managedRoot !== 'string'
+            || typeof raw.managedGitRoot !== 'string'
+            || typeof raw.gitCommonDir !== 'string'
+            || typeof raw.gitDir !== 'string'
+            || typeof raw.baseOid !== 'string'
+            || typeof raw.sourceRef !== 'string'
+            || typeof raw.revision !== 'number')
+            return null;
+        const legacyPhase = raw.phase;
+        const phase = legacyPhase === 'ready' || legacyPhase === 'discarded'
+            ? legacyPhase
+            : 'recovery_required';
+        managedCheckouts[checkoutId] = {
+            checkoutId: raw.checkoutId,
+            projectId: raw.projectId,
+            projectName: raw.projectName,
+            ownerSessionId: raw.ownerSessionId,
+            localRoot: raw.localRoot,
+            managedRoot: raw.managedRoot,
+            managedGitRoot: raw.managedGitRoot,
+            gitCommonDir: raw.gitCommonDir,
+            gitDir: raw.gitDir,
+            baseOid: raw.baseOid,
+            ...(typeof raw.applyBaseOid === 'string' ? { applyBaseOid: raw.applyBaseOid } : {}),
+            sourceRef: raw.sourceRef,
+            phase,
+            delivery: { state: 'working', iteration: 1 },
+            journal: null,
+            revision: raw.revision + (phase === legacyPhase ? 0 : 1),
+        };
+    }
+    return {
+        version: 2,
+        revision: value.revision + 1,
+        sessionBindings: value.sessionBindings,
+        managedCheckouts,
+    };
+}
+/** Atomic JSON registry file with `.tmp`/`.bak` crash recovery (see safe-file). */
+export class AtomicJsonCheckoutRegistry {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    read() {
+        const value = readJsonFileSafe(this.path);
+        if (value && isRegistry(value))
+            return value;
+        const migrated = migrateLegacyRegistry(value);
+        if (migrated) {
+            this.write(migrated);
+            return migrated;
+        }
+        if (!existsSync(this.path))
+            return emptyRegistry();
+        throw new SessionCheckoutError('registry_corrupt', 'managed-checkouts.json 损坏，已停止访问 checkout');
+    }
+    write(registry) {
+        mkdirSync(dirname(this.path), { recursive: true });
+        writeJsonFileAtomic(this.path, registry);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/lib/adapters/registry.js.map

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

package/lib/adapters/safe-file.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 崩溃安全的 JSON 文件读写工具
+ *
+ * 解决系统强制关机/崩溃时 JSON 索引文件被截断导致数据丢失的问题。
+ * - 写入：write-to-temp → rename（POSIX 原子操作）+ .bak 备份
+ * - 读取：主文件 → .tmp 残留 → .bak 回退，多层容错
+ */
+/**
+ * 原子写入 JSON 文件：write-to-temp → rename
+ * 写入前自动保留 .bak 备份
+ */
+export declare function writeJsonFileAtomic(filePath: string, data: object, skipBackup?: boolean): void;
+/** 原子重写文本文件（用于 JSONL 会话等非单个 JSON 文档）。 */
+export declare function writeTextFileAtomic(filePath: string, content: string): void;
+/**
+ * 安全读取 JSON 索引文件
+ * 优先读主文件，损坏则尝试 .tmp / .bak，都失败返回 null
+ */
+export declare function readJsonFileSafe<T>(filePath: string): T | null;

package/lib/adapters/safe-file.js

@@ -0,0 +1,94 @@
+/**
+ * 崩溃安全的 JSON 文件读写工具
+ *
+ * 解决系统强制关机/崩溃时 JSON 索引文件被截断导致数据丢失的问题。
+ * - 写入：write-to-temp → rename（POSIX 原子操作）+ .bak 备份
+ * - 读取：主文件 → .tmp 残留 → .bak 回退，多层容错
+ */
+import { writeFileSync, renameSync, existsSync, copyFileSync, readFileSync, unlinkSync } from 'node:fs';
+/**
+ * 原子写入 JSON 文件：write-to-temp → rename
+ * 写入前自动保留 .bak 备份
+ */
+export function writeJsonFileAtomic(filePath, data, skipBackup = false) {
+    const tmpPath = filePath + '.tmp';
+    const bakPath = filePath + '.bak';
+    // 备份当前文件（如果存在且可读）
+    if (!skipBackup && existsSync(filePath)) {
+        try {
+            copyFileSync(filePath, bakPath);
+        }
+        catch {
+            // 备份失败不阻塞写入
+        }
+    }
+    // 写入临时文件
+    writeFileSync(tmpPath, JSON.stringify(data, null, 2), 'utf-8');
+    // 原子重命名（POSIX rename 是原子操作）
+    renameSync(tmpPath, filePath);
+}
+/** 原子重写文本文件（用于 JSONL 会话等非单个 JSON 文档）。 */
+export function writeTextFileAtomic(filePath, content) {
+    const tmpPath = filePath + '.tmp';
+    writeFileSync(tmpPath, content, 'utf-8');
+    renameSync(tmpPath, filePath);
+}
+/**
+ * 安全读取 JSON 索引文件
+ * 优先读主文件，损坏则尝试 .tmp / .bak，都失败返回 null
+ */
+export function readJsonFileSafe(filePath) {
+    const tmpPath = filePath + '.tmp';
+    const bakPath = filePath + '.bak';
+    // 1. 尝试读取主文件
+    if (existsSync(filePath)) {
+        try {
+            const raw = readFileSync(filePath, 'utf-8');
+            if (raw.trim().length > 0) {
+                return JSON.parse(raw);
+            }
+        }
+        catch {
+            console.warn(`[数据恢复] 主索引文件损坏: ${filePath}`);
+        }
+    }
+    // 2. 检查是否有未完成的 .tmp 文件（上次 rename 前崩溃）
+    if (existsSync(tmpPath)) {
+        try {
+            const raw = readFileSync(tmpPath, 'utf-8');
+            if (raw.trim().length > 0) {
+                const parsed = JSON.parse(raw);
+                // .tmp 有效 → 提升为主文件
+                renameSync(tmpPath, filePath);
+                console.log(`[数据恢复] 从 .tmp 文件恢复: ${filePath}`);
+                return parsed;
+            }
+        }
+        catch {
+            // .tmp 也损坏，继续 fallback
+        }
+        // 清理无效的 .tmp
+        try {
+            unlinkSync(tmpPath);
+        }
+        catch { /* ignore */ }
+    }
+    // 3. Fallback 到 .bak
+    if (existsSync(bakPath)) {
+        try {
+            const raw = readFileSync(bakPath, 'utf-8');
+            if (raw.trim().length > 0) {
+                const parsed = JSON.parse(raw);
+                // 用 .bak 恢复主文件（跳过备份，避免用损坏的主文件覆盖好的 .bak）
+                writeJsonFileAtomic(filePath, parsed, true);
+                console.log(`[数据恢复] 从 .bak 文件恢复: ${filePath}`);
+                return parsed;
+            }
+        }
+        catch {
+            console.error(`[数据恢复] .bak 文件也损坏: ${bakPath}`);
+        }
+    }
+    return null; // 全部失败，需要上层从 JSONL 重建
+}
+//# sourceMappingURL=safe-file.js.map

package/lib/adapters/safe-file.js.map

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

package/lib/commands.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `/worktree` human command surface: create, list, apply, finish, discard,
+ * remove. Commands run against the receiving agent's session like the tools,
+ * but are user-initiated, so destructive verbs carry their own confirmation
+ * semantics (dirty discard is the user's own command).
+ * @module dsh-git-worktree/commands
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import '@deepseek-ai/dsh-commands';
+import type { SessionCheckoutModule } from './index.js';
+/** Register the `/worktree` command. */
+export declare function registerWorktreeCommand(ctx: Context, module: SessionCheckoutModule): void;

package/lib/commands.js

@@ -0,0 +1,121 @@
+/**
+ * `/worktree` human command surface: create, list, apply, finish, discard,
+ * remove. Commands run against the receiving agent's session like the tools,
+ * but are user-initiated, so destructive verbs carry their own confirmation
+ * semantics (dirty discard is the user's own command).
+ * @module dsh-git-worktree/commands
+ */
+import '@deepseek-ai/dsh-commands';
+function targetText(target) {
+    const lines = [
+        `checkout: ${target.checkout.label} (${target.checkout.kind}, phase ${target.checkout.phase})`,
+        `dirty: ${target.dirty}`,
+        `current: ${target.current.branch ?? 'detached'} @ ${target.current.oid.slice(0, 7)}`,
+    ];
+    if (target.delivery)
+        lines.push(`delivery: ${target.delivery.state}`);
+    return lines.join('\n');
+}
+function sessionIdOf(agent) {
+    const session = agent?.session;
+    if (!session || typeof session.id !== 'string')
+        throw new Error('`/worktree` 只能在 DSH Agent 会话中使用');
+    return session.id;
+}
+const USAGE = 'Usage: /worktree create | list | apply | finish <message> | discard | remove <checkoutId>';
+/** Register the `/worktree` command. */
+export function registerWorktreeCommand(ctx, module) {
+    ctx.commands.register({
+        name: 'worktree',
+        description: 'manage Domi-grade git worktrees (create / list / apply / finish / discard / remove)',
+        input: { hint: 'create | list | apply | finish <message> | discard | remove <checkoutId>' },
+        handler: async (invocation) => {
+            const tokens = invocation.rawInput.trim().split(/\s+/u).filter(Boolean);
+            const verb = tokens[0] ?? 'list';
+            const sessionId = sessionIdOf(invocation.agent);
+            try {
+                switch (verb) {
+                    case 'create': {
+                        const target = await module.bind(sessionId, { kind: 'isolated' });
+                        return { kind: 'success', text: `Worktree created:\n${targetText(target)}\n打开新会话并选择该工作区以在其中工作。` };
+                    }
+                    case 'list': {
+                        const summaries = await module.listManagedWorktrees();
+                        if (summaries.length === 0)
+                            return { kind: 'success', text: 'No managed worktrees.' };
+                        return {
+                            kind: 'success',
+                            text: summaries.map((summary) => (`${summary.checkoutId}  ${summary.project.name}  i${summary.iteration}  ${summary.state}/${summary.phase}  dirty=${summary.dirty}`)).join('\n'),
+                        };
+                    }
+                    case 'apply': {
+                        const target = await module.inspect(sessionId);
+                        const result = await module.operate({ action: 'apply', sessionId, expectedRevision: target.revision });
+                        if (result.status === 'applied')
+                            return { kind: 'success', text: `Applied ${result.changedFiles.length} file(s) to Local.` };
+                        if (result.status === 'conflict') {
+                            return { kind: 'error', text: `Conflict: ${result.conflictingFiles.join('、')}\nLocal HEAD: ${result.localHeadOid.slice(0, 7)} — 在 worktree 内同步并解决后重试。` };
+                        }
+                        if (result.status === 'error')
+                            return { kind: 'error', text: `${result.code}: ${result.message}` };
+                        return { kind: 'error', text: 'Apply 未返回预期结果' };
+                    }
+                    case 'finish': {
+                        const commitMessage = tokens.slice(1).join(' ').trim();
+                        if (!commitMessage)
+                            return { kind: 'error', text: USAGE };
+                        const target = await module.inspect(sessionId);
+                        const result = await module.operate({
+                            action: 'finish',
+                            sessionId,
+                            expectedRevision: target.revision,
+                            commitMessage,
+                        });
+                        if (result.status === 'finished') {
+                            return { kind: 'success', text: `Finished: committed ${result.changedFiles.length} file(s) as ${result.commitOid?.slice(0, 7) ?? 'no-op'} (cleanup: ${result.cleanup}).` };
+                        }
+                        if (result.status === 'error')
+                            return { kind: 'error', text: `${result.code}: ${result.message}` };
+                        return { kind: 'error', text: 'Finish 未返回预期结果' };
+                    }
+                    case 'discard': {
+                        const target = await module.inspect(sessionId);
+                        const result = await module.operate({
+                            action: 'discard',
+                            sessionId,
+                            expectedRevision: target.revision,
+                            confirmDirty: true,
+                        });
+                        return result.status === 'discarded'
+                            ? { kind: 'success', text: 'Worktree discarded.' }
+                            : result.status === 'error'
+                                ? { kind: 'error', text: `${result.code}: ${result.message}` }
+                                : { kind: 'error', text: 'Discard 未返回预期结果' };
+                    }
+                    case 'remove': {
+                        const checkoutId = tokens[1];
+                        if (!checkoutId)
+                            return { kind: 'error', text: USAGE };
+                        const summaries = await module.listManagedWorktrees({ checkoutId });
+                        const summary = summaries[0];
+                        if (!summary)
+                            return { kind: 'error', text: `No managed worktree ${checkoutId}.` };
+                        await module.manageManagedWorktree({
+                            checkoutId,
+                            expectedRevision: summary.revision,
+                            action: 'discard',
+                            confirmDirty: true,
+                        });
+                        return { kind: 'success', text: `Removed worktree ${checkoutId}.` };
+                    }
+                    default:
+                        return { kind: 'error', text: `Unknown verb ${JSON.stringify(verb)}.\n${USAGE}` };
+                }
+            }
+            catch (error) {
+                return { kind: 'error', text: error instanceof Error ? error.message : String(error) };
+            }
+        },
+    });
+}
+//# sourceMappingURL=commands.js.map

package/lib/commands.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * dsh-git-worktree plugin entry. The session-checkout domain (state machine,
+ * apply engine, ports) is Domi-ported and host-agnostic; this file is the DSH
+ * plugin face: exports the domain error type and the module contract, builds
+ * the DSH adapters, mounts the state machine, and registers the model tools,
+ * `/worktree` command, and session context note.
+ * @module dsh-git-worktree
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ManagedWorktreeSummaryView, BulkCleanupManagedWorktreeCandidate, BulkCleanupManagedWorktreesResult, SessionCheckoutErrorCode, SessionCheckoutOperation, SessionCheckoutOperationResult, SessionTargetBindChoice, SessionTargetView, WorktreeRetentionMode, WorktreeValidationItem, WorktreeValidationStatus, WorktreeApplyPreflightView } from './types.js';
+/** Stable domain failure raised by the session-checkout state machine and its adapters. */
+export declare class SessionCheckoutError extends Error {
+    readonly code: SessionCheckoutErrorCode;
+    /**
+     * @param code - stable error code from `SESSION_CHECKOUT_ERROR_CODES`.
+     * @param message - user-facing message, surfaced verbatim by tools.
+     */
+    constructor(code: SessionCheckoutErrorCode, message: string);
+}
+export interface SessionCheckoutReconcileSummary {
+    recoveryRequiredCheckoutIds: string[];
+    orphanedCheckoutIds: string[];
+    dirtyOrphanedCheckoutIds: string[];
+    retainedCheckoutCount: number;
+}
+export interface ManageManagedWorktreeInput {
+    checkoutId: string;
+    expectedRevision: number;
+    action: 'cleanup_retained' | 'retry_cleanup' | 'set_retention' | 'discard';
+    retention?: Exclude<WorktreeRetentionMode, 'cleanup'>;
+    confirmDirty?: boolean;
+}
+export interface ListManagedWorktreesInput {
+    projectId?: string;
+    needsAttention?: boolean;
+    checkoutId?: string;
+    includeDiagnostics?: boolean;
+}
+export interface MarkReadyForReviewInput {
+    detailsMarkdown?: string;
+    summary: string;
+    validationStatus: WorktreeValidationStatus;
+    validationSummary?: string;
+    tests: WorktreeValidationItem[];
+    suggestedCommitMessage: string;
+}
+/** Complete core interface the session-checkout module exposes to business callers. */
+export interface SessionCheckoutModule {
+    inspect(sessionId: string): Promise<SessionTargetView>;
+    /** Read-only sync preflight; modifies no Local, worktree, registry, review state, or Git refs. */
+    preflight?(sessionId: string, expectedRevision: number): Promise<WorktreeApplyPreflightView>;
+    /** Cross-module mutation under the same exclusive lock as bind/apply/discard/cleanup. */
+    runExclusiveSessionMutation<T>(sessionId: string, operation: (target: SessionTargetView) => Promise<T>): Promise<T>;
+    bind(sessionId: string, choice: SessionTargetBindChoice): Promise<SessionTargetView>;
+    /** Lazily create the next isolated checkout when a delivered owner session needs code changes. */
+    beginNextIteration(sessionId: string): Promise<SessionTargetView>;
+    markReadyForReview(sessionId: string, input: MarkReadyForReviewInput): Promise<SessionTargetView>;
+    operate(input: SessionCheckoutOperation): Promise<SessionCheckoutOperationResult>;
+    listManagedWorktrees(input?: ListManagedWorktreesInput): Promise<ManagedWorktreeSummaryView[]>;
+    /** Main-owned read-only cleanup inspection; writes no registry, refs, or directories. */
+    inspectManagedWorktreeCleanup(input?: ListManagedWorktreesInput): Promise<ManagedWorktreeSummaryView[]>;
+    bulkCleanupManagedWorktrees(candidates: BulkCleanupManagedWorktreeCandidate[]): Promise<BulkCleanupManagedWorktreesResult>;
+    manageManagedWorktree(input: ManageManagedWorktreeInput): Promise<ManagedWorktreeSummaryView>;
+    /** Resolve a managed checkout's canonical root after identity validation (workspace registration). */
+    resolveManagedRoot(checkoutId: string): Promise<string>;
+    cleanupExpiredRetained(now?: number): Promise<string[]>;
+    reconcile(): Promise<SessionCheckoutReconcileSummary>;
+}
+/**
+ * Mount the plugin: DSH adapters, the session-checkout module, the seven
+ * worktree tools, the `/worktree` command, the once-per-session worktree
+ * context note, startup reconciliation, and the retention-expiry timer.
+ */
+export declare function apply(ctx: Context, config?: {
+    stateDir?: string;
+}): void;