@cerbur/clutch-dsh-worktree 0.1.7 → 0.1.8

package/lib/provider/subprocess.js

@@ -0,0 +1,319 @@
+import { execFile as execFileCallback } from 'node:child_process';
+import { promisify } from 'node:util';
+import { scrubbedParentEnv } from '@deepseek-ai/dsh-subprocess';
+const execFile = promisify(execFileCallback);
+// Git 的原始进程证据只在 Provider runner 内流转；上层只接收稳定的 Provider 错误。
+// Raw Git process evidence stays inside the Provider runner; callers receive only
+// stable Provider errors at the public boundary.
+export class GitCommandError extends Error {
+    args;
+    cwd;
+    stdout;
+    stderr;
+    exitCode;
+    timedOut;
+    aborted;
+    outputTruncated;
+    processTreeDidNotExit;
+    signal;
+    constructor(args, cwd, stdout, stderr, exitCode, options) {
+        super(stderr || stdout || (options.processTreeDidNotExit
+            ? 'Git subprocess tree did not exit before cleanup deadline'
+            : `git exited with ${String(exitCode)}`));
+        this.name = 'GitCommandError';
+        this.args = args;
+        this.cwd = cwd;
+        this.stdout = stdout;
+        this.stderr = stderr;
+        this.exitCode = exitCode;
+        this.timedOut = options.timedOut;
+        this.aborted = options.aborted;
+        this.outputTruncated = options.outputTruncated;
+        this.processTreeDidNotExit = options.processTreeDidNotExit ?? false;
+        this.signal = options.signal;
+    }
+}
+function createDeadline(timeoutMs, parentSignal) {
+    const controller = new AbortController();
+    let timedOut = false;
+    let aborted = false;
+    let disposed = false;
+    const timer = setTimeout(() => {
+        if (disposed)
+            return;
+        timedOut = true;
+        controller.abort(Object.assign(new Error('Git subprocess timed out'), { code: 'ETIMEDOUT' }));
+    }, timeoutMs);
+    const abortFromParent = () => {
+        if (disposed)
+            return;
+        aborted = true;
+        controller.abort(parentSignal?.reason);
+    };
+    if (parentSignal) {
+        if (parentSignal.aborted) {
+            abortFromParent();
+        }
+        else {
+            parentSignal.addEventListener('abort', abortFromParent, { once: true });
+        }
+    }
+    return {
+        signal: controller.signal,
+        get timedOut() {
+            return timedOut;
+        },
+        get aborted() {
+            return aborted;
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            clearTimeout(timer);
+            parentSignal?.removeEventListener('abort', abortFromParent);
+        },
+    };
+}
+function gitEnvironment(readOnly) {
+    return {
+        ...scrubbedParentEnv(),
+        GIT_TERMINAL_PROMPT: '0',
+        GCM_INTERACTIVE: 'Never',
+        LC_ALL: 'C',
+        LANG: 'C',
+        // Explicitly clear an ambient read-only override for mutations. An
+        // inherited GIT_OPTIONAL_LOCKS=0 would otherwise silently weaken writes.
+        GIT_OPTIONAL_LOCKS: readOnly ? '0' : undefined,
+        GIT_DIR: undefined,
+        GIT_WORK_TREE: undefined,
+        GIT_INDEX_FILE: undefined,
+    };
+}
+function lookupEnvironment(environment) {
+    const result = {};
+    for (const [key, value] of Object.entries(environment)) {
+        if (value !== undefined)
+            result[key] = value;
+    }
+    return result;
+}
+function asText(value) {
+    return typeof value === 'string' ? value : '';
+}
+function asProcessError(error) {
+    return error;
+}
+function errorExitCode(error) {
+    return error.code ?? null;
+}
+function errorSignal(error) {
+    return error.signal;
+}
+function errorOutputTruncated(error) {
+    return error.code === 'ERR_CHILD_PROCESS_STDIO_MAXBUFFER' ||
+        error.message?.includes('maxBuffer') === true;
+}
+function errorAborted(error) {
+    return error.name === 'AbortError' || error.code === 'ABORT_ERR';
+}
+function errorTimedOut(error, aborted) {
+    return error.timedOut === true || error.code === 'ETIMEDOUT' ||
+        (error.killed === true && !aborted);
+}
+function abortReason(signal, fallback) {
+    return signal.reason ?? new Error(fallback);
+}
+async function awaitWithAbort(promise, signal) {
+    if (signal.aborted)
+        throw abortReason(signal, 'Git subprocess was aborted');
+    let onAbort;
+    const aborted = new Promise((_resolve, reject) => {
+        onAbort = () => reject(abortReason(signal, 'Git subprocess was aborted'));
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+    try {
+        return await Promise.race([promise, aborted]);
+    }
+    finally {
+        if (onAbort)
+            signal.removeEventListener('abort', onAbort);
+    }
+}
+function readCollectedStream(handle, stream) {
+    const reader = handle.collected[stream];
+    if (!reader) {
+        throw new Error(`Git subprocess did not expose collected ${stream}`);
+    }
+    const result = reader.readFrom(0);
+    return {
+        text: result.text,
+        truncated: result.lossy,
+    };
+}
+function readCollectedStreams(handle) {
+    const stdout = readCollectedStream(handle, 'stdout');
+    const stderr = readCollectedStream(handle, 'stderr');
+    return {
+        stdout: stdout.text,
+        stderr: stderr.text,
+        outputTruncated: stdout.truncated || stderr.truncated,
+    };
+}
+function readCollectedStreamsSafely(handle) {
+    if (!handle)
+        return { stdout: '', stderr: '', outputTruncated: false };
+    try {
+        return readCollectedStreams(handle);
+    }
+    catch {
+        return { stdout: '', stderr: '', outputTruncated: false };
+    }
+}
+async function waitForExitWithin(handle, timeoutMs) {
+    const controller = new AbortController();
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            controller.abort(new Error('Git subprocess tree cleanup timed out'));
+            resolve(false);
+        }, timeoutMs);
+    });
+    const wait = Promise.resolve().then(() => handle.waitForExit(controller.signal));
+    try {
+        return await Promise.race([wait, timeout]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+        if (!controller.signal.aborted)
+            controller.abort();
+    }
+}
+async function stopAndWait(handle, cleanupTimeoutMs) {
+    try {
+        handle.terminate();
+    }
+    catch {
+        // Preserve the original Git/runtime error; the runtime owns termination details.
+    }
+    try {
+        return await waitForExitWithin(handle, cleanupTimeoutMs);
+    }
+    catch {
+        // Preserve the original Git/runtime error after making a best-effort tree cleanup.
+        return false;
+    }
+}
+function commandErrorFrom(args, cwd, error, output, options) {
+    const processError = asProcessError(error);
+    const aborted = options.aborted || errorAborted(processError);
+    return new GitCommandError(args, cwd, output.stdout || asText(processError.stdout), output.stderr || asText(processError.stderr), errorExitCode(processError), {
+        timedOut: options.timedOut || errorTimedOut(processError, aborted),
+        aborted,
+        outputTruncated: output.outputTruncated || errorOutputTruncated(processError),
+        processTreeDidNotExit: options.processTreeDidNotExit,
+        ...(errorSignal(processError) ? { signal: errorSignal(processError) } : {}),
+    });
+}
+async function runWithSubprocess(args, cwd, executable, executableArgs, options) {
+    const deadline = createDeadline(options.timeoutMs, options.signal);
+    const environment = gitEnvironment(options.readOnly);
+    let handle;
+    let treeSettled = false;
+    try {
+        const resolvedExecutable = await awaitWithAbort(options.subprocess.resolveExecutable(executable, lookupEnvironment(environment), deadline.signal), deadline.signal);
+        handle = options.subprocess.spawn({
+            argv: [resolvedExecutable, ...executableArgs, ...args],
+            cwd,
+            stdio: {
+                stdin: 'ignore',
+                stdout: { maxBytes: options.maxOutputBytes },
+                stderr: { maxBytes: options.maxOutputBytes },
+            },
+            graceMs: options.graceMs,
+            signal: deadline.signal,
+            env: environment,
+        });
+        const outcome = await awaitWithAbort(handle.done, deadline.signal);
+        deadline.dispose();
+        const cleanupCompleted = await stopAndWait(handle, options.cleanupTimeoutMs);
+        treeSettled = cleanupCompleted;
+        const output = readCollectedStreams(handle);
+        const timedOut = deadline.timedOut;
+        const aborted = deadline.aborted && !timedOut;
+        if (!cleanupCompleted) {
+            throw new GitCommandError(args, cwd, output.stdout, output.stderr, outcome.exitCode, {
+                timedOut: deadline.timedOut,
+                aborted,
+                outputTruncated: output.outputTruncated,
+                processTreeDidNotExit: true,
+                ...(outcome.signal ? { signal: outcome.signal } : {}),
+            });
+        }
+        if (timedOut || aborted || output.outputTruncated || outcome.exitCode !== 0 || outcome.signal) {
+            throw new GitCommandError(args, cwd, output.stdout, output.stderr, outcome.exitCode, {
+                timedOut,
+                aborted,
+                outputTruncated: output.outputTruncated,
+                processTreeDidNotExit: false,
+                ...(outcome.signal ? { signal: outcome.signal } : {}),
+            });
+        }
+        return { stdout: output.stdout, stderr: output.stderr };
+    }
+    catch (error) {
+        if (error instanceof GitCommandError)
+            throw error;
+        let cleanupCompleted = treeSettled;
+        if (handle && !treeSettled) {
+            cleanupCompleted = await stopAndWait(handle, options.cleanupTimeoutMs);
+        }
+        throw commandErrorFrom(args, cwd, error, readCollectedStreamsSafely(handle), {
+            timedOut: deadline.timedOut,
+            aborted: deadline.aborted && !deadline.timedOut,
+            processTreeDidNotExit: handle !== undefined && !cleanupCompleted,
+        });
+    }
+    finally {
+        deadline.dispose();
+    }
+}
+async function runWithNode(args, cwd, executable, executableArgs, options) {
+    const environment = gitEnvironment(options.readOnly);
+    try {
+        const result = await execFile(executable, [...executableArgs, ...args], {
+            cwd,
+            encoding: 'utf8',
+            maxBuffer: options.maxOutputBytes,
+            timeout: options.timeoutMs,
+            killSignal: 'SIGTERM',
+            signal: options.signal,
+            shell: false,
+            windowsHide: true,
+            env: environment,
+        });
+        return { stdout: result.stdout, stderr: result.stderr };
+    }
+    catch (error) {
+        const processError = asProcessError(error);
+        const aborted = errorAborted(processError);
+        throw new GitCommandError(args, cwd, asText(processError.stdout), asText(processError.stderr), errorExitCode(processError), {
+            timedOut: errorTimedOut(processError, aborted),
+            aborted,
+            outputTruncated: errorOutputTruncated(processError),
+            ...(errorSignal(processError) ? { signal: errorSignal(processError) } : {}),
+        });
+    }
+}
+/** Execute one fixed Git argv through DSH subprocess or the direct Node fallback. */
+export function runGit(args, cwd, executable, executableArgs, options) {
+    if (options.subprocess) {
+        return runWithSubprocess(args, cwd, executable, executableArgs, {
+            ...options,
+            subprocess: options.subprocess,
+        });
+    }
+    return runWithNode(args, cwd, executable, executableArgs, options);
+}
+//# sourceMappingURL=subprocess.js.map

package/lib/provider/subprocess.js.map

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

package/lib/provider/transaction.d.ts

@@ -0,0 +1,65 @@
+import type { WorktreeRecord } from '../contract/index.js';
+import type { GitWorktreeAdapter, SidecarStore } from './types.js';
+export interface CreateWorktreeTransactionInput {
+    readonly workspaceId: string;
+    readonly workspaceRoot: string;
+    readonly targetPath: string;
+    readonly worktreeId: string;
+    readonly baseBranch: string;
+    readonly newBranch?: string;
+    readonly targetBranch: string;
+}
+export interface RemoveWorktreeTransactionInput {
+    readonly workspaceId: string;
+    readonly workspaceRoot: string;
+    readonly worktreeId: string;
+    readonly mutationToken: string;
+}
+export interface ImportWorktreeTransactionInput {
+    readonly workspaceId: string;
+    readonly workspaceRoot: string;
+    readonly absolutePath: string;
+    readonly worktreeId: string;
+}
+export interface RecoverWorktreesInput {
+    readonly workspaceId: string;
+    readonly workspaceRoot: string;
+}
+export interface WorktreeMutationTransactionOptions {
+    readonly dshHome: string;
+    readonly git: GitWorktreeAdapter;
+    readonly sidecar: SidecarStore;
+}
+export declare class WorktreeMutationTransaction {
+    private readonly dshHome;
+    private readonly git;
+    private readonly sidecar;
+    private readonly repositoryLock;
+    constructor(options: WorktreeMutationTransactionOptions);
+    create(input: CreateWorktreeTransactionInput): Promise<WorktreeRecord>;
+    remove(input: RemoveWorktreeTransactionInput): Promise<void>;
+    import(input: ImportWorktreeTransactionInput): Promise<WorktreeRecord>;
+    recover(input: RecoverWorktreesInput): Promise<void>;
+    private withShardLock;
+    private resolveRepository;
+    private assertMutationAdmitted;
+    private assertMutationToken;
+    private assertRepositoryCompatible;
+    private assertGeneratedTarget;
+    private assertSafeRemovalPath;
+    private assertRecoverableCreatePath;
+    private assertNotSymlink;
+    private findExactWorktree;
+    private findWorktreeByPhysicalPath;
+    private findSidecarWorktreeByPhysicalPath;
+    private isExactCreatedWorktree;
+    private findStaleActiveRecord;
+    private publishCreated;
+    private publishRemoved;
+    private clearPending;
+    private appendRecoveryIssue;
+    private markRecovery;
+    private reconcileCreateFailure;
+    private reconcileRemoveFailure;
+}
+//# sourceMappingURL=transaction.d.ts.map

package/lib/provider/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/provider/transaction.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,OAAO,KAAK,EAEV,kBAAkB,EAOlB,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAqID,qBAAa,2BAA2B;IACtC,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,cAAc,CAA2B;gBAE9C,OAAO,EAAE,kCAAkC;IASjD,MAAM,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,cAAc,CAAC;IAuItE,MAAM,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IAsJ5D,MAAM,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,cAAc,CAAC;IAwFtE,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;YAsJ5C,aAAa;YAUb,iBAAiB;IAU/B,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,0BAA0B;IA0BlC,OAAO,CAAC,qBAAqB;YAcf,qBAAqB;YA2BrB,2BAA2B;YA8B3B,gBAAgB;YAchB,iBAAiB;YAWjB,0BAA0B;YAU1B,iCAAiC;YAUjC,sBAAsB;YAQtB,qBAAqB;YAWrB,cAAc;YAqCd,cAAc;YA8Bd,YAAY;YAgBZ,mBAAmB;YAoBnB,YAAY;YAuBZ,sBAAsB;YA+DtB,sBAAsB;CAgDrC"}