baxian 0.0.1 → 0.2.0

package/dist/state/error-record-store.js

@@ -0,0 +1,203 @@
+import { appendFile, readFile, readdir, rename, unlink, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+export class ErrorRecordStore {
+    dir;
+    chain = Promise.resolve();
+    constructor(dir) {
+        this.dir = dir;
+    }
+    async append(input) {
+        const write = this.chain.then(async () => {
+            const occurredAt = input.occurredAt ?? new Date().toISOString();
+            const record = {
+                id: `err_${randomUUID()}`,
+                agentId: input.agentId,
+                projectId: input.projectId,
+                operation: input.operation,
+                reason: input.reason,
+                message: input.message,
+                occurredAt,
+                ...(input.taskId ? { taskId: input.taskId } : {}),
+                ...(input.observation ? { observation: input.observation } : {}),
+                ...(input.recommendation ? { recommendation: input.recommendation } : {}),
+            };
+            await appendFile(join(this.dir, `${occurredAt.slice(0, 10)}.jsonl`), JSON.stringify(record) + '\n');
+            return record;
+        });
+        this.chain = write.catch(() => undefined);
+        return write;
+    }
+    async latestForAgent(agentId) {
+        const records = await this.readAll();
+        return records
+            .filter(record => record.agentId === agentId)
+            .sort((a, b) => b.occurredAt.localeCompare(a.occurredAt))[0];
+    }
+    async latestBootstrapForAgent(agentId) {
+        const records = await this.readAll();
+        return records
+            .filter(record => record.agentId === agentId && record.operation === 'bootstrap')
+            .sort((a, b) => b.occurredAt.localeCompare(a.occurredAt))[0];
+    }
+    // Batched variant for buildAllAgentSnapshots — one readAll() per snapshot pass instead of
+    // N (agent count) × full-history scan. Returns the most recent bootstrap record per agentId.
+    async latestBootstrapByAgent() {
+        const records = await this.readAll();
+        const latest = new Map();
+        for (const record of records) {
+            if (record.operation !== 'bootstrap')
+                continue;
+            const prev = latest.get(record.agentId);
+            if (!prev || record.occurredAt > prev.occurredAt) {
+                latest.set(record.agentId, record);
+            }
+        }
+        return latest;
+    }
+    // Drops every record for an agentId by rewriting each affected jsonl. Called from
+    // agent-delete so an id reused later (delete + recreate) doesn't inherit stale bootstrap
+    // errors from the previous incarnation. Best-effort; partial failures are logged not thrown.
+    async purgeAgent(agentId) {
+        const idMarker = `"agentId":${JSON.stringify(agentId)}`;
+        return this.rewriteFiltered({
+            mayMatch: content => content.includes(idMarker),
+            shouldDrop: record => record.agentId === agentId,
+        });
+    }
+    // Narrower variant: drops only bootstrap-operation records for one agent, called from
+    // runSingleTarget's success path on EVERY tick. Hot path — quickCheck must be cheap and
+    // truly short-circuit (read alone, no parse, no rewrite) in the common no-stale case.
+    async purgeBootstrapForAgent(agentId) {
+        const idMarker = `"agentId":${JSON.stringify(agentId)}`;
+        const opMarker = '"operation":"bootstrap"';
+        return this.rewriteFiltered({
+            mayMatch: content => content.includes(idMarker) && content.includes(opMarker),
+            shouldDrop: record => record.agentId === agentId && record.operation === 'bootstrap',
+        });
+    }
+    // One-shot sweep on startup / config-replace: drop bootstrap-operation records for every
+    // agent NOT currently in the auto-bootstrap set. Covers:
+    //   (a) agent transitioned from auto-mode to explicit workdir (id stays, leaves bootstrap)
+    //   (b) agent deleted while server was down
+    //   (c) PATCH /config saved then restartRequired — old poller appended a fresh stale record
+    //       in the window before restart; sweep on next startup clears it
+    // Done in a single rewriteFiltered pass — one full-history scan per startup rather than
+    // N (stale agents) × full scans.
+    async sweepStaleBootstrapErrors(activeAgentIds) {
+        return this.rewriteFiltered({
+            mayMatch: content => content.includes('"operation":"bootstrap"'),
+            shouldDrop: record => record.operation === 'bootstrap' && !activeAgentIds.has(record.agentId),
+        });
+    }
+    // Shared rewrite-with-filter helper. shouldDrop returns true for records to remove.
+    // Uses tmp file + atomic rename per jsonl to survive crash/disk-full mid-rewrite
+    // (in-place writeFile would otherwise truncate the file and lose unrelated history).
+    // mayMatch lets callers short-circuit per file BEFORE the parse loop — without it, every
+    // call still parses the whole history even when nothing matches, defeating the rewrite skip.
+    rewriteFiltered(opts) {
+        const result = this.chain.then(async () => {
+            let files;
+            try {
+                files = await readdir(this.dir);
+            }
+            catch {
+                return { removed: 0 };
+            }
+            let removed = 0;
+            for (const file of files.filter(f => f.endsWith('.jsonl'))) {
+                const path = join(this.dir, file);
+                let content;
+                try {
+                    content = await readFile(path, 'utf-8');
+                }
+                catch (err) {
+                    console.warn(`[ErrorRecordStore] rewriteFiltered: skipping unreadable ${file}:`, err);
+                    continue;
+                }
+                if (!opts.mayMatch(content))
+                    continue;
+                const lines = content.split('\n');
+                const kept = [];
+                let fileRemoved = 0;
+                for (const line of lines) {
+                    if (!line)
+                        continue;
+                    let record;
+                    try {
+                        record = JSON.parse(line);
+                    }
+                    catch {
+                        kept.push(line);
+                        continue;
+                    }
+                    if (opts.shouldDrop(record)) {
+                        fileRemoved++;
+                        continue;
+                    }
+                    kept.push(line);
+                }
+                if (fileRemoved === 0)
+                    continue;
+                const tmp = `${path}.${process.pid}.${Date.now()}.tmp`;
+                try {
+                    await writeFile(tmp, kept.length > 0 ? kept.join('\n') + '\n' : '');
+                    await rename(tmp, path);
+                    // Only count records as removed after the atomic rename succeeds. If writeFile or
+                    // rename fails the original file is untouched, and callers (bootstrap.ts uses
+                    // removed > 0 as a state-change signal) must not be misled into publishing a
+                    // "stale error cleared" event for a purge that didn't actually happen.
+                    removed += fileRemoved;
+                }
+                catch (err) {
+                    console.warn(`[ErrorRecordStore] rewriteFiltered: atomic rewrite failed for ${file}:`, err);
+                    // Best-effort tmp cleanup so a partial write doesn't accumulate orphan .tmp files.
+                    try {
+                        await unlink(tmp);
+                    }
+                    catch { /* ignore — tmp may not exist if writeFile failed early */ }
+                }
+            }
+            return { removed };
+        });
+        this.chain = result.catch(() => undefined);
+        return result;
+    }
+    toSummary(record) {
+        return {
+            id: record.id,
+            reason: record.reason,
+            message: record.message,
+            occurredAt: record.occurredAt,
+            ...(record.recommendation ? { recommendation: record.recommendation } : {}),
+        };
+    }
+    async readAll() {
+        let files;
+        try {
+            files = await readdir(this.dir);
+        }
+        catch {
+            return [];
+        }
+        const records = [];
+        for (const file of files.filter(f => f.endsWith('.jsonl')).sort()) {
+            try {
+                const content = await readFile(join(this.dir, file), 'utf-8');
+                for (const line of content.trim().split('\n').filter(Boolean)) {
+                    try {
+                        records.push(JSON.parse(line));
+                    }
+                    catch (err) {
+                        console.warn(`[ErrorRecordStore] skipping unreadable line in ${file}:`, err);
+                    }
+                }
+            }
+            catch (err) {
+                console.warn(`[ErrorRecordStore] skipping unreadable file ${file}:`, err);
+            }
+        }
+        return records;
+    }
+}
+//# sourceMappingURL=error-record-store.js.map

package/dist/state/error-record-store.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,5 @@
+export { initStateDir } from './init.js';
+export { AgentStore } from './agent-store.js';
+export { TaskStore, type TaskFilter } from './task-store.js';
+export { LockManager } from './lock.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/state/index.js

@@ -0,0 +1,5 @@
+export { initStateDir } from './init.js';
+export { AgentStore } from './agent-store.js';
+export { TaskStore } from './task-store.js';
+export { LockManager } from './lock.js';
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/state/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initStateDir(baseDir: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/state/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/state/init.ts"],"names":[],"mappings":"AAGA,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASjE"}

package/dist/state/init.js

@@ -0,0 +1,13 @@
+import { mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+export async function initStateDir(baseDir) {
+    await Promise.all([
+        mkdir(join(baseDir, 'state', 'agents'), { recursive: true }),
+        mkdir(join(baseDir, 'state', 'errors'), { recursive: true }),
+        mkdir(join(baseDir, 'state', 'tasks'), { recursive: true }),
+        mkdir(join(baseDir, 'state', 'post-approve'), { recursive: true }),
+        mkdir(join(baseDir, 'events'), { recursive: true }),
+        mkdir(join(baseDir, 'locks'), { recursive: true }),
+    ]);
+}
+//# sourceMappingURL=init.js.map

package/dist/state/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/state/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACnD,CAAC,CAAC;AACL,CAAC"}

package/dist/state/lock.d.ts

@@ -0,0 +1,9 @@
+export declare class LockManager {
+    private dir;
+    constructor(dir: string);
+    acquire(agentId: string): Promise<boolean>;
+    release(agentId: string): Promise<void>;
+    isLocked(agentId: string): Promise<boolean>;
+    private path;
+}
+//# sourceMappingURL=lock.d.ts.map

package/dist/state/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/state/lock.ts"],"names":[],"mappings":"AAGA,qBAAa,WAAW;IACV,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,MAAM;IAEzB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa1C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASjD,OAAO,CAAC,IAAI;CAGb"}

package/dist/state/lock.js

@@ -0,0 +1,36 @@
+import { writeFile, unlink, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+export class LockManager {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+    }
+    async acquire(agentId) {
+        try {
+            await writeFile(this.path(agentId), JSON.stringify({ agentId, acquiredAt: new Date().toISOString() }) + '\n', { flag: 'wx' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async release(agentId) {
+        try {
+            await unlink(this.path(agentId));
+        }
+        catch { /* ignore */ }
+    }
+    async isLocked(agentId) {
+        try {
+            await stat(this.path(agentId));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    path(agentId) {
+        return join(this.dir, `${agentId}.lock`);
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/state/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/state/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,OAAO,WAAW;IACF;IAApB,YAAoB,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAEnC,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,IAAI,CAAC;YACH,MAAM,SAAS,CACb,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAClB,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,GAAG,IAAI,EACxE,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/state/post-approve-store.d.ts

@@ -0,0 +1,23 @@
+export interface PostApproveCompletion {
+    token: string;
+    approvedHeadSha: string;
+    updatedAt: string;
+    redispatchCount?: number;
+    pendingRedispatch?: boolean;
+}
+export declare class PostApproveStore {
+    private readonly dir?;
+    private readonly memory;
+    constructor(dir?: string | undefined);
+    get(taskId: string): Promise<PostApproveCompletion | null>;
+    set(taskId: string, value: {
+        token: string;
+        approvedHeadSha: string;
+        redispatchCount?: number;
+        pendingRedispatch?: boolean;
+    }): Promise<void>;
+    clear(taskId: string): Promise<void>;
+    clearIfMatches(taskId: string, token: string): Promise<boolean>;
+    private path;
+}
+//# sourceMappingURL=post-approve-store.d.ts.map

package/dist/state/post-approve-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-approve-store.d.ts","sourceRoot":"","sources":["../../src/state/post-approve-store.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAElB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAiBD,qBAAa,gBAAgB;IAGf,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;IAFjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;gBAEtC,GAAG,CAAC,EAAE,MAAM,YAAA;IAEnC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAU1D,GAAG,CACP,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,GACA,OAAO,CAAC,IAAI,CAAC;IAmBV,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAapC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOrE,OAAO,CAAC,IAAI;CAGb"}

package/dist/state/post-approve-store.js

@@ -0,0 +1,79 @@
+import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+function sanitizeCompletion(raw) {
+    const value = (raw ?? {});
+    if (typeof value.token !== 'string' || value.token.trim() === '')
+        return null;
+    if (typeof value.approvedHeadSha !== 'string' || value.approvedHeadSha.trim() === '')
+        return null;
+    return {
+        token: value.token,
+        approvedHeadSha: value.approvedHeadSha,
+        updatedAt: typeof value.updatedAt === 'string' ? value.updatedAt : new Date().toISOString(),
+        ...(typeof value.redispatchCount === 'number' && Number.isFinite(value.redispatchCount)
+            ? { redispatchCount: value.redispatchCount }
+            : {}),
+        ...(value.pendingRedispatch === true ? { pendingRedispatch: true } : {}),
+    };
+}
+export class PostApproveStore {
+    dir;
+    memory = new Map();
+    constructor(dir) {
+        this.dir = dir;
+    }
+    async get(taskId) {
+        if (!this.dir)
+            return this.memory.get(taskId) ?? null;
+        try {
+            const content = await readFile(this.path(taskId), 'utf-8');
+            return sanitizeCompletion(JSON.parse(content));
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(taskId, value) {
+        const completion = {
+            token: value.token,
+            approvedHeadSha: value.approvedHeadSha,
+            updatedAt: new Date().toISOString(),
+            ...(typeof value.redispatchCount === 'number' ? { redispatchCount: value.redispatchCount } : {}),
+            ...(value.pendingRedispatch === true ? { pendingRedispatch: true } : {}),
+        };
+        if (!this.dir) {
+            this.memory.set(taskId, completion);
+            return;
+        }
+        await mkdir(this.dir, { recursive: true });
+        const final = this.path(taskId);
+        const tmp = `${final}.${process.pid}.${Date.now()}.tmp`;
+        await writeFile(tmp, JSON.stringify(completion, null, 2) + '\n');
+        await rename(tmp, final);
+    }
+    async clear(taskId) {
+        if (!this.dir) {
+            this.memory.delete(taskId);
+            return;
+        }
+        try {
+            await unlink(this.path(taskId));
+        }
+        catch (err) {
+            const code = err?.code;
+            if (code !== 'ENOENT')
+                throw err;
+        }
+    }
+    async clearIfMatches(taskId, token) {
+        const current = await this.get(taskId);
+        if (!current || current.token !== token)
+            return false;
+        await this.clear(taskId);
+        return true;
+    }
+    path(taskId) {
+        return join(this.dir, `${encodeURIComponent(taskId)}.json`);
+    }
+}
+//# sourceMappingURL=post-approve-store.js.map

package/dist/state/post-approve-store.js.map

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

package/dist/state/process-lock.d.ts

@@ -0,0 +1,24 @@
+export interface ProcessLockInfo {
+    pid: number;
+    acquiredAt: string;
+    ownerId: string;
+}
+export declare class ProcessLockError extends Error {
+    readonly existing?: ProcessLockInfo | undefined;
+    constructor(message: string, existing?: ProcessLockInfo | undefined);
+}
+/** Single-instance guard. Stale locks require manual cleanup (auto-unlink races). */
+export declare class ProcessLock {
+    private acquired;
+    private ownerId;
+    private readonly path;
+    constructor(stateDir: string, fileName?: string);
+    /** Returns the lock info on success; throws {@link ProcessLockError} otherwise. */
+    acquire(): Promise<ProcessLockInfo>;
+    release(): Promise<void>;
+    releaseSync(): void;
+    isAcquired(): boolean;
+    getPath(): string;
+    private readExistingDetailed;
+}
+//# sourceMappingURL=process-lock.d.ts.map

package/dist/state/process-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-lock.d.ts","sourceRoot":"","sources":["../../src/state/process-lock.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aACI,QAAQ,CAAC,EAAE,eAAe;gBAA3D,OAAO,EAAE,MAAM,EAAkB,QAAQ,CAAC,EAAE,eAAe,YAAA;CAIxE;AAED,qFAAqF;AACrF,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAkB;IAI1D,mFAAmF;IAC7E,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IAyCnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0C9B,WAAW,IAAI,IAAI;IA8BnB,UAAU,IAAI,OAAO;IAIrB,OAAO,IAAI,MAAM;YAIH,oBAAoB;CA+BnC"}

package/dist/state/process-lock.js

@@ -0,0 +1,175 @@
+import { writeFile, readFile, unlink } from 'node:fs/promises';
+import { readFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+const LOCK_FILE = '.baxian-server.lock';
+const STALE_PROBE_SIGNAL = 0;
+export class ProcessLockError extends Error {
+    existing;
+    constructor(message, existing) {
+        super(message);
+        this.existing = existing;
+        this.name = 'ProcessLockError';
+    }
+}
+/** Single-instance guard. Stale locks require manual cleanup (auto-unlink races). */
+export class ProcessLock {
+    acquired = false;
+    ownerId = null;
+    path;
+    constructor(stateDir, fileName = LOCK_FILE) {
+        this.path = join(stateDir, fileName);
+    }
+    /** Returns the lock info on success; throws {@link ProcessLockError} otherwise. */
+    async acquire() {
+        const ownerId = randomUUID();
+        const info = {
+            pid: process.pid,
+            acquiredAt: new Date().toISOString(),
+            ownerId,
+        };
+        const payload = `${JSON.stringify(info)}\n`;
+        try {
+            await writeFile(this.path, payload, { flag: 'wx' });
+            this.acquired = true;
+            this.ownerId = ownerId;
+            return info;
+        }
+        catch (err) {
+            const code = err?.code;
+            if (code !== 'EEXIST')
+                throw err;
+        }
+        const status = await this.readExistingDetailed();
+        if (status.kind === 'info' && isAlive(status.info.pid)) {
+            throw new ProcessLockError(`another baxian server appears to hold the lock at ${this.path} ` +
+                `(pid=${status.info.pid}, acquiredAt=${status.info.acquiredAt}); refusing to start`, status.info);
+        }
+        const detail = status.kind === 'info'
+            ? `(prior owner pid=${status.info.pid} acquiredAt=${status.info.acquiredAt} no longer alive); `
+            : status.kind === 'malformed'
+                ? '(file is malformed / unreadable owner info); '
+                : '(file vanished between EEXIST and re-read; another process may be racing); ';
+        throw new ProcessLockError(`stale lock file at ${this.path} ${detail}` +
+            `verify no baxian server is running and remove the file manually before retrying`, status.kind === 'info' ? status.info : undefined);
+    }
+    async release() {
+        if (!this.acquired)
+            return;
+        const ownerId = this.ownerId;
+        const status = await this.readExistingDetailed();
+        if (status.kind === 'missing') {
+            this.acquired = false;
+            this.ownerId = null;
+            return;
+        }
+        if (status.kind === 'malformed') {
+            throw new ProcessLockError(`lock file at ${this.path} is malformed; cannot prove ownership, refusing to delete. ` +
+                `Verify no baxian server is running and remove the file manually if appropriate.`);
+        }
+        if (status.info.ownerId !== ownerId) {
+            this.acquired = false;
+            this.ownerId = null;
+            throw new ProcessLockError(`lock at ${this.path} was replaced by a different owner ` +
+                `(expected ${ownerId}, found ${status.info.ownerId} pid=${status.info.pid}); ` +
+                `not deleting another process's lock`, status.info);
+        }
+        try {
+            await unlink(this.path);
+            this.acquired = false;
+            this.ownerId = null;
+        }
+        catch (err) {
+            const code = err?.code;
+            if (code === 'ENOENT') {
+                this.acquired = false;
+                this.ownerId = null;
+                return;
+            }
+            throw err;
+        }
+    }
+    // Best-effort sync release for `process.once('exit', ...)` where async fs is dropped.
+    releaseSync() {
+        if (!this.acquired)
+            return;
+        let raw;
+        try {
+            raw = readFileSync(this.path, 'utf-8');
+        }
+        catch (err) {
+            if (err?.code === 'ENOENT') {
+                this.acquired = false;
+                this.ownerId = null;
+            }
+            return;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        if (typeof parsed.ownerId !== 'string' || parsed.ownerId !== this.ownerId) {
+            return;
+        }
+        try {
+            unlinkSync(this.path);
+            this.acquired = false;
+            this.ownerId = null;
+        }
+        catch {
+            // best-effort: process is exiting anyway
+        }
+    }
+    isAcquired() {
+        return this.acquired;
+    }
+    getPath() {
+        return this.path;
+    }
+    async readExistingDetailed() {
+        let raw;
+        try {
+            raw = await readFile(this.path, 'utf-8');
+        }
+        catch (err) {
+            const code = err?.code;
+            if (code === 'ENOENT')
+                return { kind: 'missing' };
+            throw err;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return { kind: 'malformed' };
+        }
+        if (typeof parsed.pid !== 'number' || typeof parsed.acquiredAt !== 'string') {
+            return { kind: 'malformed' };
+        }
+        return {
+            kind: 'info',
+            info: {
+                pid: parsed.pid,
+                acquiredAt: parsed.acquiredAt,
+                ownerId: typeof parsed.ownerId === 'string' ? parsed.ownerId : '',
+            },
+        };
+    }
+}
+function isAlive(pid) {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, STALE_PROBE_SIGNAL);
+        return true;
+    }
+    catch (err) {
+        // EPERM: process exists, owned by another user.
+        return err?.code === 'EPERM';
+    }
+}
+//# sourceMappingURL=process-lock.js.map

package/dist/state/process-lock.js.map

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