instar 0.28.95 → 0.28.97

package/dist/core/ProjectRoundExecution.js

@@ -0,0 +1,359 @@
+/**
+ * ProjectRoundExecution — the autonomous run loop for a project round.
+ *
+ * Spec: docs/specs/PROJECT-SCOPE-SPEC.md § Phase 1.5 ("Run loop", steps 1-11).
+ *
+ * What this module is responsible for:
+ *   1. Acquiring the round-runner lock (delegated to ProjectRoundLock).
+ *   2. Spawning the autonomous child process in a detached process
+ *      group, so SIGTERM/SIGKILL of the group never reaps the runner.
+ *   3. Polling the project record every `pollIntervalMs` to detect
+ *      mid-round mutations to the round's itemIds (e.g., a user
+ *      manually skips an item) — when detected, SIGTERM the group
+ *      (5s grace, then SIGKILL) and relaunch with a recomputed stop
+ *      condition.
+ *   4. On the autonomous child's NATURAL exit, verify per-item
+ *      artifacts and set round.status = complete | partially-complete.
+ *   5. Cleanup: `git worktree prune` for the round namespace.
+ *   6. Release the lock.
+ *
+ * What this module is NOT responsible for:
+ *   - The preflight gate. That's `ProjectRoundRunner.preflight`. The
+ *     caller (the auto-advance poller, the /project run-round skill,
+ *     a future HTTP endpoint) is expected to preflight before calling
+ *     `runRound(input)`.
+ *   - Drift checking. Same — preflight handles it.
+ *   - Choosing the autonomous command. The `spawnCommand` is injected,
+ *     defaulting to `claude` (which invokes the local /autonomous skill).
+ *     Tests pass a custom command so they don't depend on the skill.
+ *
+ * Process group safety:
+ *   The child is spawned with `detached: true` so it gets its own
+ *   process group. `kill(-pgid, signal)` (Node passes negative PIDs
+ *   for group signals) targets only the child's group — never reaps
+ *   the runner.
+ */
+import { spawn } from 'node:child_process';
+import { ProjectRoundLock } from './ProjectRoundLock.js';
+import { ProjectRoundWorktrees } from './ProjectRoundWorktrees.js';
+import { SafeGitExecutor } from './SafeGitExecutor.js';
+/** Per-spec defaults. Tests dial both down to keep the suite fast. */
+export const DEFAULT_POLL_INTERVAL_MS = 60_000;
+export const DEFAULT_SIGTERM_GRACE_MS = 5_000;
+/** Resume cap from spec § Phase 1.5 step 11. */
+export const DEFAULT_MAX_RESUME_ATTEMPTS = 3;
+/**
+ * Run one round to completion. Caller is expected to preflight first.
+ */
+export async function runRound(input, deps) {
+    const pollIntervalMs = input.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const sigtermGraceMs = input.sigtermGraceMs ?? DEFAULT_SIGTERM_GRACE_MS;
+    const maxResumeAttempts = input.maxResumeAttempts ?? DEFAULT_MAX_RESUME_ATTEMPTS;
+    const verifyMergedItems = input.verifyMergedItems ?? defaultVerifyMergedItems(input.targetRepoPath);
+    const lock = new ProjectRoundLock({ stateDir: deps.stateDir });
+    // Step 1: acquire lock.
+    const acquired = lock.acquire(input.projectId, input.roundIndex);
+    if (!acquired.ok) {
+        return {
+            outcome: 'failed',
+            mergedItemIds: [],
+            unmergedItemIds: [],
+            relaunchCount: 0,
+            resumeAttempts: 0,
+            reason: `lock held by pid ${acquired.currentHolder.pid}`,
+        };
+    }
+    let relaunchCount = 0;
+    let resumeAttempts = 0;
+    try {
+        let snapshot = await readRound(input.tracker, input.projectId, input.roundIndex);
+        if (!snapshot) {
+            return {
+                outcome: 'failed',
+                mergedItemIds: [],
+                unmergedItemIds: [],
+                relaunchCount,
+                resumeAttempts,
+                reason: 'project or round disappeared',
+            };
+        }
+        let lastItemIds = [...snapshot.itemIds];
+        // Step 3: lazy worktree allocation for round items. The autonomous
+        // child opens more as it reaches them; we kick off only the first
+        // here to give the child a starting cwd.
+        if (lastItemIds.length > 0) {
+            try {
+                ProjectRoundWorktrees.allocate({
+                    targetRepoPath: input.targetRepoPath,
+                    projectId: input.projectId,
+                    roundIndex: input.roundIndex,
+                    itemId: lastItemIds[0],
+                }, { refuseExisting: false });
+            }
+            catch {
+                // First-item worktree may pre-exist if a previous attempt
+                // crashed mid-way. Continue.
+            }
+        }
+        // Inner relaunch loop: steps 4-5.
+        // We loop until either the child exits naturally or we detect a
+        // halt / stop-condition-met.
+        let outcome = 'failed';
+        let mergedItemIds = [];
+        let unmergedItemIds = [];
+        let reason;
+        for (;;) {
+            // Per-step halt checkpoint.
+            const halted = await readHaltedAt(input.tracker, input.projectId, input.roundIndex);
+            if (halted) {
+                outcome = 'halted';
+                reason = `round halted at ${halted}`;
+                unmergedItemIds = [...lastItemIds];
+                break;
+            }
+            // Compute current stop condition: itemIds verified-merged.
+            const verified = await verifyMergedItems(lastItemIds);
+            if (lastItemIds.every((id) => verified.has(id))) {
+                outcome = 'complete';
+                mergedItemIds = [...lastItemIds];
+                break;
+            }
+            // Spawn the autonomous child with stop condition + ids in env.
+            const child = spawnAutonomousChild(input, lastItemIds);
+            const exit = await waitForExitOrPollChange(child, input.tracker, input.projectId, input.roundIndex, lastItemIds, pollIntervalMs, sigtermGraceMs);
+            if (exit.kind === 'set-changed') {
+                relaunchCount++;
+                const fresh = await readRound(input.tracker, input.projectId, input.roundIndex);
+                if (!fresh) {
+                    outcome = 'failed';
+                    reason = 'project disappeared during round';
+                    break;
+                }
+                lastItemIds = [...fresh.itemIds];
+                // Loop continues; next iteration re-checks stop condition then
+                // either spawns again or proceeds to step 6.
+                continue;
+            }
+            if (exit.kind === 'halted') {
+                outcome = 'halted';
+                reason = 'round halted via API during run';
+                unmergedItemIds = [...lastItemIds];
+                break;
+            }
+            // Natural exit.
+            if (exit.kind === 'exited' && exit.code === 0) {
+                // Step 6: verify per-item artifacts.
+                const finalVerified = await verifyMergedItems(lastItemIds);
+                mergedItemIds = lastItemIds.filter((id) => finalVerified.has(id));
+                unmergedItemIds = lastItemIds.filter((id) => !finalVerified.has(id));
+                if (unmergedItemIds.length === 0)
+                    outcome = 'complete';
+                else
+                    outcome = 'partially-complete';
+                break;
+            }
+            // Non-zero exit → resume attempt.
+            resumeAttempts++;
+            if (resumeAttempts >= maxResumeAttempts) {
+                outcome = 'failed';
+                reason = `${resumeAttempts} resume attempts exhausted (last exit code: ${exit.kind === 'exited' ? exit.code : exit.kind})`;
+                unmergedItemIds = [...lastItemIds];
+                break;
+            }
+            // Backoff before relaunch.
+            await sleep(1000 * resumeAttempts);
+        }
+        // Step 7: cleanup worktrees.
+        try {
+            ProjectRoundWorktrees.prune(input.targetRepoPath);
+        }
+        catch { /* best-effort */ }
+        // Step 9-11: record round status. We DO NOT touch
+        // unacknowledgedAdvanceCount here — that's the auto-advance poller's
+        // job. We just record the round status.
+        if (outcome !== 'halted') {
+            await recordOutcome(input.tracker, input.projectId, input.roundIndex, outcome);
+        }
+        return { outcome, mergedItemIds, unmergedItemIds, relaunchCount, resumeAttempts, reason };
+    }
+    finally {
+        // Step 8: release lock.
+        lock.release();
+    }
+}
+async function readRound(tracker, projectId, roundIndex) {
+    const proj = tracker.get(projectId);
+    if (!proj)
+        return null;
+    const round = (proj.rounds ?? [])[roundIndex];
+    if (!round)
+        return null;
+    return { itemIds: round.itemIds ?? [], status: (round.status ?? 'pending') };
+}
+async function readHaltedAt(tracker, projectId, roundIndex) {
+    const proj = tracker.get(projectId);
+    if (!proj)
+        return null;
+    const round = (proj.rounds ?? [])[roundIndex];
+    return round?.haltedAt ?? null;
+}
+async function recordOutcome(tracker, projectId, roundIndex, outcome) {
+    const proj = tracker.get(projectId);
+    if (!proj)
+        return;
+    const map = {
+        complete: 'complete',
+        'partially-complete': 'partially-complete',
+        failed: 'failed',
+        halted: 'failed',
+    };
+    const newStatus = map[outcome];
+    const completedAt = new Date().toISOString();
+    const rounds = (proj.rounds ?? []).map((r, i) => i === roundIndex ? { ...r, status: newStatus, completedAt } : r);
+    try {
+        await tracker.update(projectId, { rounds, ifMatch: proj.version });
+    }
+    catch {
+        // OCC race — caller (or next reconcile) will retry.
+    }
+}
+function spawnAutonomousChild(input, itemIds) {
+    const cmd = input.spawnCommand ?? 'claude';
+    const args = input.spawnArgs ?? ['--skill', 'autonomous'];
+    const workdir = input.initialWorkdir ??
+        (itemIds.length > 0
+            ? ProjectRoundWorktrees.pathFor({
+                targetRepoPath: input.targetRepoPath,
+                projectId: input.projectId,
+                roundIndex: input.roundIndex,
+                itemId: itemIds[0],
+            })
+            : input.targetRepoPath);
+    const child = spawn(cmd, args, {
+        cwd: workdir,
+        detached: true, // critical — makes the child its own process group leader
+        stdio: 'ignore',
+        env: {
+            ...process.env,
+            INSTAR_PROJECT_ID: input.projectId,
+            INSTAR_ROUND_INDEX: String(input.roundIndex),
+            INSTAR_ROUND_ITEM_IDS: JSON.stringify(itemIds),
+            INSTAR_STOP_CONDITION: 'all-items-merged-on-main',
+        },
+    });
+    return child;
+}
+async function waitForExitOrPollChange(child, tracker, projectId, roundIndex, initialItemIds, pollIntervalMs, sigtermGraceMs) {
+    let exited = false;
+    let exitCode = null;
+    let exitSignal = null;
+    const exitPromise = new Promise((resolve) => {
+        child.once('exit', (code, signal) => {
+            exited = true;
+            exitCode = code;
+            exitSignal = signal;
+            resolve();
+        });
+    });
+    while (!exited) {
+        // Wait either pollIntervalMs OR exit, whichever comes first.
+        await Promise.race([exitPromise, sleep(pollIntervalMs)]);
+        if (exited)
+            break;
+        // Halt check.
+        const halted = await readHaltedAt(tracker, projectId, roundIndex);
+        if (halted) {
+            await killProcessGroup(child, sigtermGraceMs);
+            return { kind: 'halted' };
+        }
+        // Stop-condition revalidation: did itemIds change?
+        const snap = await readRound(tracker, projectId, roundIndex);
+        if (!snap) {
+            await killProcessGroup(child, sigtermGraceMs);
+            return { kind: 'halted' };
+        }
+        if (!arraysEqual(snap.itemIds, initialItemIds)) {
+            await killProcessGroup(child, sigtermGraceMs);
+            return { kind: 'set-changed' };
+        }
+    }
+    return { kind: 'exited', code: exitCode, signal: exitSignal };
+}
+async function killProcessGroup(child, graceMs) {
+    if (!child.pid || child.exitCode !== null)
+        return;
+    try {
+        // Negative PID targets the process group. child is its own group
+        // leader because we spawned with detached:true.
+        process.kill(-child.pid, 'SIGTERM');
+    }
+    catch {
+        return; // Already dead.
+    }
+    const start = Date.now();
+    while (child.exitCode === null && Date.now() - start < graceMs) {
+        await sleep(100);
+    }
+    if (child.exitCode === null) {
+        try {
+            process.kill(-child.pid, 'SIGKILL');
+        }
+        catch { /* already dead */ }
+        // Brief wait for the OS to register the kill.
+        await sleep(100);
+    }
+}
+function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++)
+        if (a[i] !== b[i])
+            return false;
+    return true;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Real `gh pr view`-backed merged-state verifier. For each child id,
+ * looks up the child's `prNumber` + `mergeCommitOid` from the tracker
+ * and runs `git merge-base --is-ancestor <oid> origin/main` to confirm
+ * the merge is reachable. Tests inject a stub instead.
+ *
+ * For PR 7's scope, this default is intentionally simple: it only
+ * confirms reachability of `mergeCommitOid` if the child has one.
+ * Real CI-green checks via `gh pr view` ship in a follow-up (the
+ * StageTransitionValidator already performs them for /advance — when
+ * the merged-state reconciler wires up in the next PR, it'll call
+ * the validator here too).
+ */
+function defaultVerifyMergedItems(targetRepoPath) {
+    return async (_childIds) => {
+        const verified = new Set();
+        // Best-effort no-op default — production callers should pass a
+        // real verifyMergedItems that calls StageTransitionValidator.
+        // The point of this default is to avoid a spurious shell-out
+        // during tests that didn't override it (rare; tests should
+        // override).
+        void targetRepoPath;
+        return verified;
+    };
+}
+/** Helper exported so callers can wire a SafeGit-backed verifier. */
+export async function verifyMergedItemsViaGit(targetRepoPath, childIds, tracker) {
+    const verified = new Set();
+    for (const id of childIds) {
+        const child = tracker.get(id);
+        if (!child || !child.mergeCommitOid)
+            continue;
+        try {
+            SafeGitExecutor.run(['merge-base', '--is-ancestor', child.mergeCommitOid, 'origin/main'], { cwd: targetRepoPath, operation: 'ProjectRoundExecution.verifyMergedItemsViaGit' });
+            verified.add(id);
+        }
+        catch {
+            // Not an ancestor of origin/main — not verified.
+        }
+    }
+    return verified;
+}
+//# sourceMappingURL=ProjectRoundExecution.js.map

package/dist/core/ProjectRoundExecution.js.map

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

package/dist/core/ProjectRoundLock.d.ts

@@ -0,0 +1,67 @@
+/**
+ * ProjectRoundLock — machine-local lock for the round runner.
+ *
+ * Spec: docs/specs/PROJECT-SCOPE-SPEC.md § Phase 1.5 ("Lock file
+ * .instar/local/round-runner.lock is free."). The path is MACHINE-LOCAL
+ * (under .instar/local/, NOT git-synced) so two machines never fight
+ * over a 0-byte lockfile in the sync layer; cross-machine ownership is
+ * separately controlled by `ownerMachineId` on the project record and
+ * the claim-ownership flow (later PR).
+ *
+ * Contract:
+ *   - At most one round-runner active per machine. The lock encodes the
+ *     PID, projectId, and roundIndex of the holder.
+ *   - Stale lock detection: if the recorded PID is no longer alive, the
+ *     lock is considered free (handles crash without restart). This is
+ *     intentional and matches the spec's pre-flight step 2 ("PID in lock
+ *     is alive; if not, remove").
+ *   - Acquisition is best-effort atomic: `O_CREAT | O_EXCL` rename of a
+ *     tmp file holding the JSON payload. Concurrent acquirers race on
+ *     the rename; the loser fails fast. This is the standard non-fcntl
+ *     local-process mutex pattern; proper-lockfile is overkill for a
+ *     single-machine single-runner gate.
+ */
+export interface ProjectRoundLockPayload {
+    pid: number;
+    projectId: string;
+    roundIndex: number;
+    acquiredAt: string;
+}
+export interface ProjectRoundLockConfig {
+    /** Absolute path to the agent's `.instar/` directory. */
+    stateDir: string;
+}
+export type AcquireResult = {
+    ok: true;
+    payload: ProjectRoundLockPayload;
+} | {
+    ok: false;
+    reason: 'held';
+    currentHolder: ProjectRoundLockPayload;
+};
+export declare class ProjectRoundLock {
+    private stateDir;
+    constructor(config: ProjectRoundLockConfig);
+    /**
+     * Try to acquire the lock for the given (projectId, roundIndex). Returns
+     * a structured result rather than throwing — callers decide whether to
+     * wait, abort, or report.
+     */
+    acquire(projectId: string, roundIndex: number, now?: Date): AcquireResult;
+    /**
+     * Release the lock unconditionally. Returns true if a lock was removed,
+     * false if it was already gone. Does NOT verify the caller owns it —
+     * callers higher in the stack (the runner itself) own that semantics.
+     */
+    release(): boolean;
+    /** Read the current holder, if any. */
+    read(): ProjectRoundLockPayload | null;
+    private ensureDir;
+    private lockPath;
+}
+/**
+ * Cross-platform "is this PID still running" check.
+ * `kill(pid, 0)` doesn't send a signal but throws if the PID isn't valid.
+ */
+export declare function isAlive(pid: number): boolean;
+//# sourceMappingURL=ProjectRoundLock.d.ts.map

package/dist/core/ProjectRoundLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectRoundLock.d.ts","sourceRoot":"","sources":["../../src/core/ProjectRoundLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,uBAAuB,CAAA;CAAE,GAC9C;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,uBAAuB,CAAC;CACxC,CAAC;AAEN,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,sBAAsB;IAI1C;;;;OAIG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,aAAa;IAmDrF;;;;OAIG;IACH,OAAO,IAAI,OAAO;IAWlB,uCAAuC;IACvC,IAAI,IAAI,uBAAuB,GAAG,IAAI;IAgBtC,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,QAAQ;CAGjB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW5C"}

package/dist/core/ProjectRoundLock.js

@@ -0,0 +1,161 @@
+/**
+ * ProjectRoundLock — machine-local lock for the round runner.
+ *
+ * Spec: docs/specs/PROJECT-SCOPE-SPEC.md § Phase 1.5 ("Lock file
+ * .instar/local/round-runner.lock is free."). The path is MACHINE-LOCAL
+ * (under .instar/local/, NOT git-synced) so two machines never fight
+ * over a 0-byte lockfile in the sync layer; cross-machine ownership is
+ * separately controlled by `ownerMachineId` on the project record and
+ * the claim-ownership flow (later PR).
+ *
+ * Contract:
+ *   - At most one round-runner active per machine. The lock encodes the
+ *     PID, projectId, and roundIndex of the holder.
+ *   - Stale lock detection: if the recorded PID is no longer alive, the
+ *     lock is considered free (handles crash without restart). This is
+ *     intentional and matches the spec's pre-flight step 2 ("PID in lock
+ *     is alive; if not, remove").
+ *   - Acquisition is best-effort atomic: `O_CREAT | O_EXCL` rename of a
+ *     tmp file holding the JSON payload. Concurrent acquirers race on
+ *     the rename; the loser fails fast. This is the standard non-fcntl
+ *     local-process mutex pattern; proper-lockfile is overkill for a
+ *     single-machine single-runner gate.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { SafeFsExecutor } from './SafeFsExecutor.js';
+export class ProjectRoundLock {
+    stateDir;
+    constructor(config) {
+        this.stateDir = config.stateDir;
+    }
+    /**
+     * Try to acquire the lock for the given (projectId, roundIndex). Returns
+     * a structured result rather than throwing — callers decide whether to
+     * wait, abort, or report.
+     */
+    acquire(projectId, roundIndex, now = new Date()) {
+        this.ensureDir();
+        // Stale-PID sweep first.
+        const existing = this.read();
+        if (existing && !isAlive(existing.pid)) {
+            try {
+                SafeFsExecutor.safeUnlinkSync(this.lockPath(), { operation: 'ProjectRoundLock.acquire:sweep-stale' });
+            }
+            catch {
+                // Race with another acquirer doing the same — fine.
+            }
+        }
+        else if (existing) {
+            return { ok: false, reason: 'held', currentHolder: existing };
+        }
+        const payload = {
+            pid: process.pid,
+            projectId,
+            roundIndex,
+            acquiredAt: now.toISOString(),
+        };
+        const body = JSON.stringify(payload);
+        const tmp = this.lockPath() + '.tmp.' + process.pid;
+        try {
+            // O_CREAT | O_EXCL: fails if tmp already exists (in case of a
+            // previous crash with the same pid — unlikely but harmless).
+            const fd = fs.openSync(tmp, 'wx', 0o600);
+            fs.writeSync(fd, body);
+            fs.closeSync(fd);
+        }
+        catch (err) {
+            try {
+                SafeFsExecutor.safeUnlinkSync(tmp, { operation: 'ProjectRoundLock.acquire:cleanup-tmp' });
+            }
+            catch { /* ignore */ }
+            throw err;
+        }
+        try {
+            // POSIX rename is atomic on the same filesystem. If another process
+            // sneaked in between our stale-sweep and the rename, our rename
+            // overwrites theirs — which is wrong. So we re-check after.
+            // BUT: the spec accepts "at most one runner per machine" which is
+            // a single-process guarantee for serial invocation; concurrent
+            // acquires from the same process don't happen because the routes
+            // layer hold the call inside one promise. Cross-process concurrent
+            // acquires are a theoretical edge — round runners only spawn from
+            // the supervised AgentServer. We accept the rename racing on the
+            // narrow window between read() and rename() as acceptable.
+            fs.renameSync(tmp, this.lockPath());
+        }
+        catch (err) {
+            try {
+                SafeFsExecutor.safeUnlinkSync(tmp, { operation: 'ProjectRoundLock.acquire:cleanup-tmp' });
+            }
+            catch { /* ignore */ }
+            throw err;
+        }
+        return { ok: true, payload };
+    }
+    /**
+     * Release the lock unconditionally. Returns true if a lock was removed,
+     * false if it was already gone. Does NOT verify the caller owns it —
+     * callers higher in the stack (the runner itself) own that semantics.
+     */
+    release() {
+        try {
+            SafeFsExecutor.safeUnlinkSync(this.lockPath(), { operation: 'ProjectRoundLock.release' });
+            return true;
+        }
+        catch (err) {
+            const e = err;
+            if (e.code === 'ENOENT')
+                return false;
+            throw err;
+        }
+    }
+    /** Read the current holder, if any. */
+    read() {
+        try {
+            const raw = fs.readFileSync(this.lockPath(), 'utf-8');
+            const obj = JSON.parse(raw);
+            if (typeof obj.pid !== 'number')
+                return null;
+            if (typeof obj.projectId !== 'string')
+                return null;
+            if (typeof obj.roundIndex !== 'number')
+                return null;
+            if (typeof obj.acquiredAt !== 'string')
+                return null;
+            return obj;
+        }
+        catch {
+            return null;
+        }
+    }
+    // ── Internals ─────────────────────────────────────────────────────
+    ensureDir() {
+        const localDir = path.join(this.stateDir, 'local');
+        if (!fs.existsSync(localDir))
+            fs.mkdirSync(localDir, { recursive: true });
+    }
+    lockPath() {
+        return path.join(this.stateDir, 'local', 'round-runner.lock');
+    }
+}
+/**
+ * Cross-platform "is this PID still running" check.
+ * `kill(pid, 0)` doesn't send a signal but throws if the PID isn't valid.
+ */
+export function isAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        const e = err;
+        // EPERM means the PID exists but we don't have permission; still alive.
+        if (e.code === 'EPERM')
+            return true;
+        return false;
+    }
+}
+//# sourceMappingURL=ProjectRoundLock.js.map

package/dist/core/ProjectRoundLock.js.map

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