@tickernelz/paperclip-pro-shared 2026.925.0

package/dist/workspace-file-resource.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-file-resource.test.d.ts","sourceRoot":"","sources":["../src/workspace-file-resource.test.ts"],"names":[],"mappings":""}

package/dist/workspace-file-resource.test.js

@@ -0,0 +1,52 @@
+import { describe, expect, it } from "vitest";
+import { workspaceFileAvailabilityRequestSchema, workspaceFileAvailabilityResponseSchema, } from "./validators/workspace-file-resource.js";
+const projectId = "11111111-1111-4111-8111-111111111111";
+const workspaceId = "22222222-2222-4222-8222-222222222222";
+describe("workspace file availability schemas", () => {
+    it("accepts at most 100 resource queries", () => {
+        const query = { path: "src/app.ts", workspace: "auto" };
+        expect(workspaceFileAvailabilityRequestSchema.safeParse({ queries: Array.from({ length: 100 }, () => query) }).success).toBe(true);
+        expect(workspaceFileAvailabilityRequestSchema.safeParse({ queries: Array.from({ length: 101 }, () => query) }).success).toBe(false);
+    });
+    it("rejects malformed paths and incomplete targets", () => {
+        expect(workspaceFileAvailabilityRequestSchema.safeParse({ queries: [{ path: "src/\u0000app.ts" }] }).success).toBe(false);
+        expect(workspaceFileAvailabilityRequestSchema.safeParse({ queries: [{ path: "src/app.ts", projectId }] }).success).toBe(false);
+        expect(workspaceFileAvailabilityRequestSchema.safeParse({
+            queries: [{ path: "src/app.ts", projectId, workspaceId }],
+        }).success).toBe(true);
+    });
+    it("parses normalized openable and unavailable results", () => {
+        const parsed = workspaceFileAvailabilityResponseSchema.parse({
+            kind: "workspace_file_availability",
+            results: [
+                {
+                    query: { path: "src/app.ts", workspace: "project", projectId: null, workspaceId: null },
+                    openable: true,
+                    resource: {
+                        kind: "file",
+                        provider: "local_fs",
+                        title: "app.ts",
+                        displayPath: "src/app.ts",
+                        workspaceLabel: "Primary workspace",
+                        workspaceKind: "project_workspace",
+                        workspaceId,
+                        projectId,
+                        projectName: "Project",
+                        contentType: "text/plain; charset=utf-8",
+                        byteSize: 12,
+                        previewKind: "text",
+                        capabilities: { preview: true, download: true, listChildren: false },
+                    },
+                },
+                {
+                    query: { path: "missing.ts", workspace: "auto", projectId: null, workspaceId: null },
+                    openable: false,
+                    unavailableReason: "not_found",
+                    resource: null,
+                },
+            ],
+        });
+        expect(parsed.results.map((result) => result.openable)).toEqual([true, false]);
+    });
+});
+//# sourceMappingURL=workspace-file-resource.test.js.map

package/dist/workspace-file-resource.test.js.map

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

package/dist/worktree-port-registry.d.ts

@@ -0,0 +1,5 @@
+export declare function withWorktreePortRegistryLockSync<T>(homeDir: string, run: () => T): T;
+export declare function withWorktreePortRegistryLock<T>(homeDir: string, run: () => Promise<T>): Promise<T>;
+export declare function readWorktreePortRegistry(homeDir: string): Set<string>;
+export declare function writeWorktreePortRegistry(homeDir: string, configPaths: Iterable<string>): void;
+//# sourceMappingURL=worktree-port-registry.d.ts.map

package/dist/worktree-port-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-port-registry.d.ts","sourceRoot":"","sources":["../src/worktree-port-registry.ts"],"names":[],"mappings":"AAyVA,wBAAgB,gCAAgC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAcpF;AAED,wBAAsB,4BAA4B,CAAC,CAAC,EAClD,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAcZ;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAerE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAa9F"}

package/dist/worktree-port-registry.js

@@ -0,0 +1,382 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { setTimeout as delay } from "node:timers/promises";
+import { Worker } from "node:worker_threads";
+const WORKTREE_PORT_REGISTRY_FILE = "worktree-port-reservations.json";
+const WORKTREE_PORT_REGISTRY_LOCK_DIR = ".worktree-port-reservations.lock";
+const WORKTREE_PORT_REGISTRY_LOCK_OWNER_FILE = "owner.json";
+const WORKTREE_PORT_REGISTRY_LOCK_OWNER_BACKUP_FILE = "owner.backup.json";
+const WORKTREE_PORT_REGISTRY_LOCK_STALE_MS = 5_000;
+const WORKTREE_PORT_REGISTRY_LOCK_TIMEOUT_MS = 10_000;
+const WORKTREE_PORT_REGISTRY_LOCK_HEARTBEAT_MS = 1_000;
+const WORKTREE_PORT_REGISTRY_LOCK_PROBE_TIMEOUT_MS = 500;
+const sleepSyncBuffer = new Int32Array(new SharedArrayBuffer(4));
+const REGISTRY_LOCK_HEARTBEAT_SOURCE = `
+const fs = require("node:fs");
+const net = require("node:net");
+const path = require("node:path");
+const { parentPort, workerData } = require("node:worker_threads");
+const control = new Int32Array(workerData.control);
+function touchOwnedLock() {
+  let sawDifferentOwner = false;
+  for (const ownerFile of workerData.ownerFiles) {
+    try {
+      const owner = JSON.parse(fs.readFileSync(path.join(workerData.lockPath, ownerFile), "utf8"));
+      if (owner.token === workerData.token) {
+        try {
+          const now = new Date();
+          fs.utimesSync(workerData.lockPath, now, now);
+          return "refreshed";
+        } catch {
+          return "retry";
+        }
+      }
+      sawDifferentOwner = true;
+    } catch {
+      // The redundant owner file may still be readable.
+    }
+  }
+  return sawDifferentOwner ? "lost" : "retry";
+}
+let finished = false;
+let timer;
+function complete() {
+  Atomics.store(control, 0, 2);
+  Atomics.notify(control, 0);
+}
+function finish() {
+  if (finished) return;
+  finished = true;
+  if (timer) clearInterval(timer);
+  server.close(complete);
+  setTimeout(complete, 250).unref();
+}
+const server = net.createServer((socket) => {
+  socket.setEncoding("utf8");
+  socket.setTimeout(workerData.probeTimeoutMs, () => socket.destroy());
+  socket.once("data", (candidate) => {
+    socket.end(candidate === workerData.token ? "owned" : "denied");
+  });
+});
+parentPort.once("message", finish);
+server.once("error", () => {
+  Atomics.store(control, 0, -1);
+  Atomics.notify(control, 0);
+});
+server.listen(0, "127.0.0.1", () => {
+  const address = server.address();
+  if (!address || typeof address === "string") {
+    Atomics.store(control, 0, -1);
+    Atomics.notify(control, 0);
+    return;
+  }
+  Atomics.store(control, 2, address.port);
+  Atomics.store(control, 0, 1);
+  Atomics.notify(control, 0);
+  touchOwnedLock();
+  timer = setInterval(() => {
+    if (Atomics.load(control, 1) !== 0 || touchOwnedLock() === "lost") finish();
+  }, workerData.heartbeatMs);
+});
+`;
+const REGISTRY_LOCK_PROBE_SOURCE = `
+const net = require("node:net");
+const { workerData } = require("node:worker_threads");
+const control = new Int32Array(workerData.control);
+let finished = false;
+function finish(result) {
+  if (finished) return;
+  finished = true;
+  Atomics.store(control, 0, result);
+  Atomics.notify(control, 0);
+  process.exit(0);
+}
+const socket = net.createConnection({ host: "127.0.0.1", port: workerData.port });
+socket.setEncoding("utf8");
+socket.setTimeout(workerData.timeoutMs, () => finish(2));
+socket.once("connect", () => socket.write(workerData.token));
+socket.once("data", (response) => finish(response === "owned" ? 1 : 2));
+socket.once("error", () => finish(2));
+socket.once("close", () => finish(2));
+`;
+function resolveRegistryLockPath(homeDir) {
+    fs.mkdirSync(homeDir, { recursive: true });
+    return path.resolve(homeDir, WORKTREE_PORT_REGISTRY_LOCK_DIR);
+}
+function readRegistryLockOwner(lockPath) {
+    for (const ownerFile of [
+        WORKTREE_PORT_REGISTRY_LOCK_OWNER_FILE,
+        WORKTREE_PORT_REGISTRY_LOCK_OWNER_BACKUP_FILE,
+    ]) {
+        try {
+            const parsed = JSON.parse(fs.readFileSync(path.join(lockPath, ownerFile), "utf8"));
+            if (parsed.version === 1
+                && Number.isInteger(parsed.pid)
+                && (parsed.pid ?? 0) > 0
+                && typeof parsed.processIdentity === "string"
+                && parsed.processIdentity.length > 0
+                && Number.isInteger(parsed.probePort)
+                && (parsed.probePort ?? 0) > 0
+                && (parsed.probePort ?? 0) <= 65_535
+                && typeof parsed.token === "string"
+                && parsed.token.length > 0) {
+                return parsed;
+            }
+        }
+        catch {
+            // Try the redundant owner record.
+        }
+    }
+    return null;
+}
+function writeRegistryLockOwner(lockPath, owner) {
+    const contents = `${JSON.stringify(owner)}\n`;
+    for (const ownerFile of [
+        WORKTREE_PORT_REGISTRY_LOCK_OWNER_FILE,
+        WORKTREE_PORT_REGISTRY_LOCK_OWNER_BACKUP_FILE,
+    ]) {
+        const ownerPath = path.join(lockPath, ownerFile);
+        const temporaryPath = `${ownerPath}.${owner.token}.tmp`;
+        fs.writeFileSync(temporaryPath, contents, { mode: 0o600 });
+        fs.renameSync(temporaryPath, ownerPath);
+    }
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return !(error instanceof Error && "code" in error && error.code === "ESRCH");
+    }
+}
+function readProcessIdentity(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return null;
+    if (process.platform === "linux") {
+        try {
+            const stat = fs.readFileSync(`/proc/${pid}/stat`, "utf8");
+            const commandEnd = stat.lastIndexOf(")");
+            if (commandEnd < 0)
+                return null;
+            const fields = stat.slice(commandEnd + 1).trim().split(/\s+/);
+            const startTicks = fields[19];
+            if (!startTicks)
+                return null;
+            const bootId = fs.readFileSync("/proc/sys/kernel/random/boot_id", "utf8").trim();
+            return bootId ? `linux:${bootId}:${startTicks}` : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    try {
+        if (process.platform === "win32") {
+            const ticks = execFileSync("powershell.exe", [
+                "-NoProfile",
+                "-NonInteractive",
+                "-Command",
+                `(Get-Process -Id ${pid}).StartTime.ToUniversalTime().Ticks`,
+            ], { encoding: "utf8", windowsHide: true }).trim();
+            return ticks ? `win32:${ticks}` : null;
+        }
+        const startedAt = execFileSync("ps", ["-o", "lstart=", "-p", String(pid)], {
+            encoding: "utf8",
+        }).trim();
+        return startedAt ? `${process.platform}:${startedAt}` : null;
+    }
+    catch {
+        return null;
+    }
+}
+function probeRegistryLockOwner(owner) {
+    const control = new Int32Array(new SharedArrayBuffer(4));
+    const worker = new Worker(REGISTRY_LOCK_PROBE_SOURCE, {
+        eval: true,
+        execArgv: [],
+        workerData: {
+            control: control.buffer,
+            port: owner.probePort,
+            timeoutMs: WORKTREE_PORT_REGISTRY_LOCK_PROBE_TIMEOUT_MS,
+            token: owner.token,
+        },
+    });
+    Atomics.wait(control, 0, 0, WORKTREE_PORT_REGISTRY_LOCK_PROBE_TIMEOUT_MS + 250);
+    const isOwner = Atomics.load(control, 0) === 1;
+    void worker.terminate();
+    return isOwner;
+}
+function removeStaleRegistryLock(lockPath) {
+    try {
+        const ageMs = Date.now() - fs.statSync(lockPath).mtimeMs;
+        if (ageMs <= WORKTREE_PORT_REGISTRY_LOCK_STALE_MS)
+            return false;
+        const owner = readRegistryLockOwner(lockPath);
+        if (owner && isProcessAlive(owner.pid)) {
+            if (probeRegistryLockOwner(owner))
+                return false;
+            const currentIdentity = readProcessIdentity(owner.pid);
+            if (owner.processIdentity === currentIdentity)
+                return false;
+        }
+        const currentOwner = readRegistryLockOwner(lockPath);
+        if (owner ? currentOwner?.token !== owner.token : currentOwner !== null)
+            return false;
+        const currentAgeMs = Date.now() - fs.statSync(lockPath).mtimeMs;
+        if (currentAgeMs <= WORKTREE_PORT_REGISTRY_LOCK_STALE_MS)
+            return false;
+        fs.rmSync(lockPath, { recursive: true, force: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function startRegistryLockHeartbeat(lockPath, token) {
+    const control = new Int32Array(new SharedArrayBuffer(12));
+    const worker = new Worker(REGISTRY_LOCK_HEARTBEAT_SOURCE, {
+        eval: true,
+        execArgv: [],
+        workerData: {
+            control: control.buffer,
+            heartbeatMs: WORKTREE_PORT_REGISTRY_LOCK_HEARTBEAT_MS,
+            lockPath,
+            ownerFiles: [
+                WORKTREE_PORT_REGISTRY_LOCK_OWNER_FILE,
+                WORKTREE_PORT_REGISTRY_LOCK_OWNER_BACKUP_FILE,
+            ],
+            probeTimeoutMs: WORKTREE_PORT_REGISTRY_LOCK_PROBE_TIMEOUT_MS,
+            token,
+        },
+    });
+    Atomics.wait(control, 0, 0, 2_000);
+    if (Atomics.load(control, 0) !== 1) {
+        void worker.terminate();
+        throw new Error(`Failed to start worktree port reservation lock heartbeat at ${lockPath}`);
+    }
+    const probePort = Atomics.load(control, 2);
+    if (probePort <= 0) {
+        void worker.terminate();
+        throw new Error(`Failed to start worktree port reservation lock probe at ${lockPath}`);
+    }
+    return { token, worker, control, probePort };
+}
+function stopRegistryLockHeartbeat(lease) {
+    Atomics.store(lease.control, 1, 1);
+    Atomics.notify(lease.control, 1);
+    lease.worker.postMessage("stop");
+    if (Atomics.load(lease.control, 0) === 1) {
+        Atomics.wait(lease.control, 0, 1, 2_000);
+    }
+    void lease.worker.terminate();
+}
+function acquireRegistryLock(lockPath, deadline) {
+    try {
+        fs.mkdirSync(lockPath);
+        const token = `${process.pid}-${randomUUID()}`;
+        let lease = null;
+        try {
+            const processIdentity = readProcessIdentity(process.pid);
+            if (!processIdentity) {
+                throw new Error("Cannot determine worktree port reservation lock owner identity");
+            }
+            const owner = {
+                version: 1,
+                pid: process.pid,
+                processIdentity,
+                probePort: 1,
+                token,
+            };
+            writeRegistryLockOwner(lockPath, owner);
+            lease = startRegistryLockHeartbeat(lockPath, token);
+            writeRegistryLockOwner(lockPath, { ...owner, probePort: lease.probePort });
+            return lease;
+        }
+        catch (error) {
+            if (lease)
+                stopRegistryLockHeartbeat(lease);
+            fs.rmSync(lockPath, { recursive: true, force: true });
+            throw error;
+        }
+    }
+    catch (error) {
+        const code = error instanceof Error && "code" in error ? error.code : null;
+        if (code !== "EEXIST")
+            throw error;
+        if (removeStaleRegistryLock(lockPath))
+            return null;
+        if (Date.now() >= deadline) {
+            throw new Error(`Timed out waiting for worktree port reservation lock at ${lockPath}`);
+        }
+        return null;
+    }
+}
+function releaseRegistryLock(lockPath, lease) {
+    stopRegistryLockHeartbeat(lease);
+    const owner = readRegistryLockOwner(lockPath);
+    if (owner?.token !== lease.token) {
+        return;
+    }
+    fs.rmSync(lockPath, { recursive: true, force: true });
+}
+export function withWorktreePortRegistryLockSync(homeDir, run) {
+    const lockPath = resolveRegistryLockPath(homeDir);
+    const deadline = Date.now() + WORKTREE_PORT_REGISTRY_LOCK_TIMEOUT_MS;
+    let lease = null;
+    while (!(lease = acquireRegistryLock(lockPath, deadline))) {
+        Atomics.wait(sleepSyncBuffer, 0, 0, 25);
+    }
+    try {
+        return run();
+    }
+    finally {
+        releaseRegistryLock(lockPath, lease);
+    }
+}
+export async function withWorktreePortRegistryLock(homeDir, run) {
+    const lockPath = resolveRegistryLockPath(homeDir);
+    const deadline = Date.now() + WORKTREE_PORT_REGISTRY_LOCK_TIMEOUT_MS;
+    let lease = null;
+    while (!(lease = acquireRegistryLock(lockPath, deadline))) {
+        await delay(25);
+    }
+    try {
+        return await run();
+    }
+    finally {
+        releaseRegistryLock(lockPath, lease);
+    }
+}
+export function readWorktreePortRegistry(homeDir) {
+    const registryPath = path.resolve(homeDir, WORKTREE_PORT_REGISTRY_FILE);
+    if (!fs.existsSync(registryPath))
+        return new Set();
+    try {
+        const parsed = JSON.parse(fs.readFileSync(registryPath, "utf8"));
+        if (parsed.version !== 1 || !Array.isArray(parsed.configPaths))
+            return new Set();
+        return new Set(parsed.configPaths
+            .filter((configPath) => typeof configPath === "string" && configPath.length > 0)
+            .map((configPath) => path.resolve(configPath)));
+    }
+    catch {
+        return new Set();
+    }
+}
+export function writeWorktreePortRegistry(homeDir, configPaths) {
+    fs.mkdirSync(homeDir, { recursive: true });
+    const registryPath = path.resolve(homeDir, WORKTREE_PORT_REGISTRY_FILE);
+    const persistedPaths = Array.from(new Set(Array.from(configPaths, (configPath) => path.resolve(configPath))))
+        .filter((configPath) => fs.existsSync(configPath))
+        .sort();
+    const registry = {
+        version: 1,
+        configPaths: persistedPaths,
+    };
+    const temporaryPath = `${registryPath}.${process.pid}.tmp`;
+    fs.writeFileSync(temporaryPath, `${JSON.stringify(registry, null, 2)}\n`, { mode: 0o600 });
+    fs.renameSync(temporaryPath, registryPath);
+}
+//# sourceMappingURL=worktree-port-registry.js.map

package/dist/worktree-port-registry.js.map

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

package/dist/worktree-port-registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worktree-port-registry.test.d.ts.map

package/dist/worktree-port-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-port-registry.test.d.ts","sourceRoot":"","sources":["../src/worktree-port-registry.test.ts"],"names":[],"mappings":""}

package/dist/worktree-port-registry.test.js

@@ -0,0 +1,118 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
+import { afterEach, describe, expect, it } from "vitest";
+import { withWorktreePortRegistryLock, withWorktreePortRegistryLockSync, } from "./worktree-port-registry.js";
+const temporaryRoots = [];
+function makeTemporaryRoot() {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), "paperclip-port-registry-lock-"));
+    temporaryRoots.push(root);
+    return root;
+}
+function deferred() {
+    let resolve;
+    const promise = new Promise((done) => {
+        resolve = done;
+    });
+    return { promise, resolve };
+}
+afterEach(() => {
+    for (const root of temporaryRoots.splice(0)) {
+        fs.rmSync(root, { recursive: true, force: true });
+    }
+});
+describe("worktree port registry lock", () => {
+    it("does not reclaim a stale lock while its fallback ownership probe responds", async () => {
+        const homeDir = makeTemporaryRoot();
+        const lockPath = path.join(homeDir, ".worktree-port-reservations.lock");
+        const firstEntered = deferred();
+        const releaseFirst = deferred();
+        let secondEntered = false;
+        const first = withWorktreePortRegistryLock(homeDir, async () => {
+            fs.renameSync(path.join(lockPath, "owner.json"), path.join(lockPath, "owner.unavailable.json"));
+            const backupOwnerPath = path.join(lockPath, "owner.backup.json");
+            const owner = JSON.parse(fs.readFileSync(backupOwnerPath, "utf8"));
+            fs.writeFileSync(backupOwnerPath, `${JSON.stringify({
+                ...owner,
+                processIdentity: "unavailable-process-identity",
+            })}\n`);
+            const oldTimestamp = new Date(Date.now() - 10_000);
+            fs.utimesSync(lockPath, oldTimestamp, oldTimestamp);
+            firstEntered.resolve();
+            await releaseFirst.promise;
+        });
+        await firstEntered.promise;
+        expect(Date.now() - fs.statSync(lockPath).mtimeMs).toBeGreaterThan(5_000);
+        const second = withWorktreePortRegistryLock(homeDir, async () => {
+            secondEntered = true;
+        });
+        await delay(100);
+        expect(secondEntered).toBe(false);
+        releaseFirst.resolve();
+        await Promise.all([first, second]);
+        expect(secondEntered).toBe(true);
+    }, 10_000);
+    it("refreshes the lease throughout an async critical section", async () => {
+        const homeDir = makeTemporaryRoot();
+        const lockPath = path.join(homeDir, ".worktree-port-reservations.lock");
+        await withWorktreePortRegistryLock(homeDir, async () => {
+            await delay(5_250);
+            expect(Date.now() - fs.statSync(lockPath).mtimeMs).toBeLessThan(2_000);
+        });
+        expect(fs.existsSync(lockPath)).toBe(false);
+    }, 10_000);
+    it("reclaims an old lock after its owner process exits", async () => {
+        const homeDir = makeTemporaryRoot();
+        const lockPath = path.join(homeDir, ".worktree-port-reservations.lock");
+        fs.mkdirSync(lockPath);
+        fs.writeFileSync(path.join(lockPath, "owner.json"), `${JSON.stringify({
+            version: 1,
+            pid: 2_147_483_647,
+            processIdentity: "dead-process",
+            probePort: 1,
+            token: "dead-owner",
+        })}\n`);
+        const oldTimestamp = new Date(Date.now() - 10_000);
+        fs.utimesSync(lockPath, oldTimestamp, oldTimestamp);
+        let entered = false;
+        await withWorktreePortRegistryLock(homeDir, async () => {
+            entered = true;
+        });
+        expect(entered).toBe(true);
+        expect(fs.existsSync(lockPath)).toBe(false);
+    });
+    it("reclaims an old lock when its pid belongs to a different process", async () => {
+        const homeDir = makeTemporaryRoot();
+        const lockPath = path.join(homeDir, ".worktree-port-reservations.lock");
+        fs.mkdirSync(lockPath);
+        fs.writeFileSync(path.join(lockPath, "owner.json"), `${JSON.stringify({
+            version: 1,
+            pid: process.pid,
+            processIdentity: "reused-pid-owner",
+            probePort: 1,
+            token: "abandoned-owner",
+        })}\n`);
+        const oldTimestamp = new Date(Date.now() - 10_000);
+        fs.utimesSync(lockPath, oldTimestamp, oldTimestamp);
+        let entered = false;
+        await withWorktreePortRegistryLock(homeDir, async () => {
+            entered = true;
+        });
+        expect(entered).toBe(true);
+        expect(fs.existsSync(lockPath)).toBe(false);
+    });
+    it("refreshes the lease while a synchronous critical section blocks the main thread", () => {
+        const homeDir = makeTemporaryRoot();
+        const lockPath = path.join(homeDir, ".worktree-port-reservations.lock");
+        const blocker = new Int32Array(new SharedArrayBuffer(4));
+        withWorktreePortRegistryLockSync(homeDir, () => {
+            const oldTimestamp = new Date(Date.now() - 10_000);
+            fs.utimesSync(lockPath, oldTimestamp, oldTimestamp);
+            Atomics.wait(blocker, 0, 0, 1_500);
+            expect(Date.now() - fs.statSync(lockPath).mtimeMs).toBeLessThan(1_250);
+        });
+        expect(fs.existsSync(lockPath)).toBe(false);
+    });
+});
+//# sourceMappingURL=worktree-port-registry.test.js.map

package/dist/worktree-port-registry.test.js.map

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

package/dist/worktree-seed-source.d.ts

@@ -0,0 +1,43 @@
+export type WorktreeSeedSourceDiagnostic = {
+    configPath?: unknown;
+    instanceId?: unknown;
+};
+export type CanonicalWorktreeSeedSource = {
+    baseWorkspaceCwd: string | null;
+    configPath: string;
+    instanceId: string;
+    targetConfigPath: string;
+    targetInstanceId: string;
+};
+export type RegisteredWorktreeSeedSourceInput = {
+    registeredBaseWorkspaceCwd?: string | null;
+    explicitSourceConfigPath?: string | null;
+    targetConfigPath: string;
+    expectedTargetInstanceId: string;
+};
+/**
+ * Whether a base project workspace declares an instance config of its own.
+ *
+ * This tests directory entries and does not follow them. A dangling or aliased symlink,
+ * at the config itself or at the `.paperclip` directory holding it, still counts as a
+ * declared config, so the resolver rejects the malformed source instead of falling back
+ * to another one.
+ */
+export declare function baseWorkspaceDeclaresInstanceConfig(baseWorkspaceCwd: string): boolean;
+/** Resolve the authoritative source and target identities without consulting diagnostics. */
+export declare function resolveRegisteredWorktreeSeedSource(input: RegisteredWorktreeSeedSourceInput): CanonicalWorktreeSeedSource;
+/**
+ * Resolve a worktree seed source without granting authority to the seed manifest.
+ *
+ * A managed caller supplies the project-workspace cwd from its server-owned row.
+ * An operator may instead supply an explicit source config. A base workspace that
+ * carries its own `.paperclip/config.json` stays authoritative, so an explicit path
+ * must equal it; a base workspace that is a plain checkout has none, and the explicit
+ * path supplies the source. Manifest source fields are diagnostic assertions only and
+ * never select the returned source.
+ */
+export declare function resolveCanonicalWorktreeSeedSource(input: RegisteredWorktreeSeedSourceInput & {
+    manifestSource: WorktreeSeedSourceDiagnostic | null | undefined;
+    manifestTargetInstanceId?: unknown;
+}): CanonicalWorktreeSeedSource;
+//# sourceMappingURL=worktree-seed-source.d.ts.map

package/dist/worktree-seed-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-seed-source.d.ts","sourceRoot":"","sources":["../src/worktree-seed-source.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,4BAA4B,GAAG;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,0BAA0B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;CAClC,CAAC;AA6CF;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAmBrF;AAmBD,6FAA6F;AAC7F,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,iCAAiC,GACvC,2BAA2B,CAyE7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,iCAAiC,GAAG;IAC5F,cAAc,EAAE,4BAA4B,GAAG,IAAI,GAAG,SAAS,CAAC;IAChE,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GAAG,2BAA2B,CAsB9B"}