@inoceanlee/brc 2.1.1 → 2.1.2

package/dist/lifecycle/lock-store.d.ts

@@ -0,0 +1,28 @@
+import type { BrcPaths } from '../config/paths.js';
+import type { ProcessIdentity } from './identity.js';
+export interface LockOwner extends ProcessIdentity {
+    version: 1;
+    workspaceRoot: string;
+    token: string;
+}
+interface LockSnapshot {
+    owner: LockOwner;
+    contents: string;
+    dev: number;
+    ino: number;
+    birthtimeMs: number;
+}
+export declare class LockStore {
+    private readonly paths;
+    readonly lockPath: string;
+    constructor(paths: BrcPaths);
+    private verifyDirectory;
+    acquire(owner: LockOwner): Promise<boolean>;
+    isMissing(): Promise<boolean>;
+    readOwner(): Promise<LockSnapshot>;
+    isolateAndDelete(snapshot: LockSnapshot, verify?: () => Promise<boolean>): Promise<void>;
+    private readMoved;
+    releaseIfOwned(token: string): Promise<void>;
+    reclaimExpired(inspect: (pid: number) => Promise<ProcessIdentity | null>): Promise<boolean>;
+}
+export {};

package/dist/lifecycle/lock-store.js

@@ -0,0 +1,204 @@
+import { randomUUID } from 'node:crypto';
+import { lstat, mkdir, mkdtemp, readFile, rename, rmdir, unlink, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+function code(error) {
+    return error && typeof error === 'object' && 'code' in error && typeof error.code === 'string'
+        ? error.code : undefined;
+}
+function validOwner(value, root) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const v = value;
+    return v.version === 1 && v.workspaceRoot === root
+        && typeof v.token === 'string' && /^[0-9a-f-]{36}$/i.test(v.token)
+        && typeof v.pid === 'number' && Number.isSafeInteger(v.pid) && v.pid > 0
+        && typeof v.createdAt === 'string' && v.createdAt.length > 0
+        && typeof v.executablePath === 'string' && path.isAbsolute(v.executablePath)
+        && typeof v.commandLine === 'string' && v.commandLine.length > 0;
+}
+function sameSnapshot(a, b) {
+    return a.dev === b.dev && a.ino === b.ino && a.birthtimeMs === b.birthtimeMs
+        && a.contents === b.contents;
+}
+export class LockStore {
+    paths;
+    lockPath;
+    constructor(paths) {
+        this.paths = paths;
+        this.lockPath = path.join(paths.runtime, 'lifecycle.lock');
+    }
+    async verifyDirectory(dir) {
+        const info = await lstat(dir);
+        if (!info.isDirectory() || info.isSymbolicLink()) {
+            throw new Error('Lifecycle lock path is not a plain directory.');
+        }
+    }
+    async acquire(owner) {
+        if (!validOwner(owner, this.paths.root))
+            throw new Error('Invalid lifecycle lock owner.');
+        try {
+            await this.verifyDirectory(this.paths.root);
+        }
+        catch (error) {
+            if (code(error) !== 'ENOENT')
+                throw error;
+            await mkdir(this.paths.root, { recursive: true });
+            await this.verifyDirectory(this.paths.root);
+        }
+        try {
+            await mkdir(this.paths.runtime);
+        }
+        catch (error) {
+            if (code(error) !== 'EEXIST')
+                throw error;
+        }
+        await this.verifyDirectory(this.paths.runtime);
+        const stage = await mkdtemp(path.join(this.paths.runtime, '.lifecycle-stage-'));
+        try {
+            await writeFile(path.join(stage, 'owner.json'), JSON.stringify(owner), { encoding: 'utf8', flag: 'wx', mode: 0o600 });
+            // Exclusive mkdir prevents Windows rename from replacing an existing lock file.
+            // A crash before owner publication leaves a detectable, unclaimed directory.
+            try {
+                await mkdir(this.lockPath);
+            }
+            catch (error) {
+                if (code(error) !== 'EEXIST' && code(error) !== 'EPERM' && code(error) !== 'EACCES')
+                    throw error;
+                try {
+                    await lstat(this.lockPath);
+                    return false;
+                }
+                catch (probe) {
+                    if (code(probe) === 'ENOENT')
+                        throw error;
+                    throw probe;
+                }
+            }
+            await rename(path.join(stage, 'owner.json'), path.join(this.lockPath, 'owner.json'));
+            return true;
+        }
+        finally {
+            try {
+                await unlink(path.join(stage, 'owner.json'));
+            }
+            catch (error) {
+                if (code(error) !== 'ENOENT')
+                    throw error;
+            }
+            try {
+                await rmdir(stage);
+            }
+            catch (error) {
+                if (code(error) !== 'ENOENT')
+                    throw error;
+            }
+        }
+    }
+    async isMissing() {
+        try {
+            await lstat(this.lockPath);
+            return false;
+        }
+        catch (error) {
+            if (code(error) === 'ENOENT')
+                return true;
+            throw error;
+        }
+    }
+    async readOwner() {
+        await this.verifyDirectory(this.paths.runtime);
+        const info = await lstat(this.lockPath);
+        if (!info.isDirectory() || info.isSymbolicLink())
+            throw new Error('Lifecycle lock is not a plain directory.');
+        const filename = path.join(this.lockPath, 'owner.json');
+        const fileInfo = await lstat(filename);
+        if (!fileInfo.isFile() || fileInfo.isSymbolicLink())
+            throw new Error('Lifecycle lock owner is not a plain file.');
+        const contents = await readFile(filename, 'utf8');
+        let parsed;
+        try {
+            parsed = JSON.parse(contents);
+        }
+        catch {
+            throw new Error('Lifecycle lock owner is malformed.');
+        }
+        if (!validOwner(parsed, this.paths.root))
+            throw new Error('Lifecycle lock owner is incomplete or belongs to another data root.');
+        return { owner: parsed, contents, dev: info.dev, ino: info.ino, birthtimeMs: info.birthtimeMs };
+    }
+    async isolateAndDelete(snapshot, verify) {
+        const current = await this.readOwner();
+        if (!sameSnapshot(snapshot, current))
+            throw new Error('Lifecycle lock changed before isolation.');
+        const moved = path.join(this.paths.runtime, '.lifecycle-isolated-' + randomUUID());
+        await rename(this.lockPath, moved);
+        let safe = false;
+        try {
+            const isolated = await this.readMoved(moved);
+            if (!sameSnapshot(snapshot, isolated))
+                throw new Error('Lifecycle lock was replaced during isolation.');
+            if (verify && !await verify())
+                throw new Error('Lifecycle lock owner changed during recovery.');
+            // Refuse to remove any unexpected new files or ownership changes.
+            const final = await this.readMoved(moved);
+            if (!sameSnapshot(snapshot, final))
+                throw new Error('Lifecycle lock changed after isolation.');
+            safe = true;
+            await unlink(path.join(moved, 'owner.json'));
+            await rmdir(moved);
+        }
+        catch (error) {
+            if (!safe) {
+                try {
+                    await rename(moved, this.lockPath);
+                }
+                catch { /* Preserve isolated contents for investigation. */ }
+            }
+            throw error;
+        }
+    }
+    async readMoved(dir) {
+        const info = await lstat(dir);
+        if (!info.isDirectory() || info.isSymbolicLink())
+            throw new Error('Isolated lock is not a plain directory.');
+        const file = path.join(dir, 'owner.json');
+        const fileInfo = await lstat(file);
+        if (!fileInfo.isFile() || fileInfo.isSymbolicLink())
+            throw new Error('Isolated owner is not a plain file.');
+        const contents = await readFile(file, 'utf8');
+        const value = JSON.parse(contents);
+        if (!validOwner(value, this.paths.root))
+            throw new Error('Isolated lock owner is invalid.');
+        return { owner: value, contents, dev: info.dev, ino: info.ino, birthtimeMs: info.birthtimeMs };
+    }
+    async releaseIfOwned(token) {
+        let snapshot;
+        try {
+            snapshot = await this.readOwner();
+        }
+        catch (error) {
+            if (code(error) === 'ENOENT')
+                return;
+            throw error;
+        }
+        if (snapshot.owner.token !== token)
+            return;
+        await this.isolateAndDelete(snapshot);
+    }
+    async reclaimExpired(inspect) {
+        const snapshot = await this.readOwner();
+        const identity = await inspect(snapshot.owner.pid);
+        if (identity) {
+            // A reused PID is not sufficient evidence to delete the previous owner's lock.
+            if (identity.createdAt !== snapshot.owner.createdAt
+                || identity.executablePath !== snapshot.owner.executablePath
+                || identity.commandLine !== snapshot.owner.commandLine) {
+                throw new Error('Lifecycle lock PID was reused or its owner identity changed.');
+            }
+            return false;
+        }
+        await this.isolateAndDelete(snapshot, async () => (await inspect(snapshot.owner.pid)) === null);
+        return true;
+    }
+}
+//# sourceMappingURL=lock-store.js.map

package/dist/lifecycle/lock-store.js.map

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

package/dist/lifecycle/lock.d.ts

@@ -1,10 +1,19 @@
 import type { BrcPaths } from '../config/paths.js';
+export interface LockWaitOptions {
+    waitMs?: number;
+    pollMs?: number;
+}
 export declare class LifecycleLock {
-    private readonly paths;
+    private static ownIdentity;
+    private static inspectSelf;
     private queue;
     private readonly context;
-    constructor(paths: BrcPaths);
+    private readonly store;
+    private readonly paths;
+    private waitMs;
+    private pollMs;
+    constructor(paths: BrcPaths, options?: LockWaitOptions);
+    updateWaitSettings(options: LockWaitOptions): void;
     runExclusive<T>(operation: () => Promise<T>): Promise<T>;
     private execute;
-    private releaseIfOwned;
 }

package/dist/lifecycle/lock.js

@@ -1,19 +1,37 @@
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { randomUUID } from 'node:crypto';
-import { open, mkdir, readFile, stat, unlink } from 'node:fs/promises';
-import path from 'node:path';
-import { inspectProcess } from './processes.js';
-function errorCode(error) {
-    return error && typeof error === 'object' && 'code' in error && typeof error.code === 'string'
-        ? error.code
-        : undefined;
-}
+import { setTimeout as sleep } from 'node:timers/promises';
+import { DEFAULT_SETTINGS } from '../config/settings.js';
+import { inspectProcess } from './identity.js';
+import { LockStore } from './lock-store.js';
 export class LifecycleLock {
-    paths;
+    static ownIdentity;
+    static inspectSelf() {
+        this.ownIdentity ??= inspectProcess(process.pid).then((identity) => {
+            if (!identity)
+                throw new Error('Cannot verify the CLI process identity for lifecycle locking.');
+            return identity;
+        }).catch((error) => {
+            this.ownIdentity = undefined;
+            throw error;
+        });
+        return this.ownIdentity;
+    }
     queue = Promise.resolve();
     context = new AsyncLocalStorage();
-    constructor(paths) {
+    store;
+    paths;
+    waitMs;
+    pollMs;
+    constructor(paths, options = {}) {
         this.paths = paths;
+        this.store = new LockStore(paths);
+        this.waitMs = options.waitMs ?? DEFAULT_SETTINGS.runtime.lockWaitMs;
+        this.pollMs = options.pollMs ?? DEFAULT_SETTINGS.runtime.lockPollMs;
+    }
+    updateWaitSettings(options) {
+        this.waitMs = options.waitMs ?? this.waitMs;
+        this.pollMs = options.pollMs ?? this.pollMs;
     }
     runExclusive(operation) {
         if (this.context.getStore() === this) {
@@ -24,77 +42,35 @@ export class LifecycleLock {
         return result;
     }
     async execute(operation) {
-        await mkdir(this.paths.runtime, { recursive: true });
-        const identity = await inspectProcess(process.pid);
-        if (!identity)
-            throw new Error('Cannot verify the CLI process identity for lifecycle locking.');
-        const filename = path.join(this.paths.runtime, 'lifecycle.lock');
-        const id = randomUUID();
-        let handle;
-        try {
-            handle = await open(filename, 'wx', 0o600);
-        }
-        catch (error) {
-            if (errorCode(error) === 'EEXIST')
-                throw new Error('Another BRC lifecycle operation is in progress.');
-            throw error;
-        }
-        const identityOnDisk = await handle.stat();
-        let recordWritten = false;
-        try {
-            await handle.writeFile(`${JSON.stringify({ version: 1, ...identity, workspaceRoot: this.paths.root, id })}\n`, 'utf8');
-            recordWritten = true;
-            return await this.context.run(this, operation);
-        }
-        finally {
+        const identity = await LifecycleLock.inspectSelf();
+        const owner = { version: 1, ...identity, workspaceRoot: this.paths.root, token: randomUUID() };
+        const started = Date.now();
+        while (!await this.store.acquire(owner)) {
             try {
-                await handle.close();
-            }
-            finally {
-                await this.releaseIfOwned(filename, id, identityOnDisk, recordWritten);
-            }
-        }
-    }
-    async releaseIfOwned(filename, id, identityOnDisk, recordWritten) {
-        if (recordWritten) {
-            let contents;
-            try {
-                contents = await readFile(filename, 'utf8');
+                if (await this.store.reclaimExpired(inspectProcess))
+                    continue;
             }
             catch (error) {
-                if (errorCode(error) === 'ENOENT')
-                    return;
-                throw error;
+                if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT') {
+                    if (await this.store.isMissing())
+                        continue;
+                    // A newly claimed directory may be publishing owner.json. Wait, never steal it.
+                    if (Date.now() - started < this.waitMs) {
+                        await sleep(this.pollMs);
+                        continue;
+                    }
+                }
+                throw new Error('Lifecycle lock cannot be safely reclaimed.', { cause: error });
             }
-            let record;
-            try {
-                record = JSON.parse(contents);
-            }
-            catch {
-                return;
-            }
-            if (!record || typeof record !== 'object' || Array.isArray(record) || !('id' in record) || record.id !== id)
-                return;
-        }
-        else {
-            let current;
-            try {
-                current = await stat(filename);
-            }
-            catch (error) {
-                if (errorCode(error) === 'ENOENT')
-                    return;
-                throw error;
-            }
-            if (current.dev !== identityOnDisk.dev || current.ino !== identityOnDisk.ino)
-                return;
+            if (Date.now() - started >= this.waitMs)
+                throw new Error('Another BRC lifecycle operation is in progress.');
+            await sleep(this.pollMs);
         }
         try {
-            await unlink(filename);
+            return await this.context.run(this, operation);
         }
-        catch (error) {
-            if (errorCode(error) !== 'ENOENT')
-                throw error;
+        finally {
+            await this.store.releaseIfOwned(owner.token);
         }
     }
 }

package/dist/lifecycle/lock.js.map

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

package/dist/lifecycle/processes.d.ts

@@ -1,5 +1,8 @@
 import type { BrcPaths } from '../config/paths.js';
 import { type BrcSettings } from '../config/settings.js';
+import { type ProcessIdentity } from './identity.js';
+export { inspectProcess } from './identity.js';
+export type { ProcessIdentity } from './identity.js';
 export type ManagedServiceName = 'relay' | 'traefik' | 'agent';
 export type ServiceState = 'stopped' | 'starting' | 'pairing' | 'running' | 'degraded';
 export interface ServiceStatus {
@@ -17,12 +20,6 @@ export interface ManagedServiceSpec {
     env?: NodeJS.ProcessEnv;
     startupTimeoutMs?: number;
 }
-export interface ProcessIdentity {
-    pid: number;
-    createdAt: string;
-    executablePath: string;
-    commandLine: string;
-}
 export interface ManagedProcessRecord extends ProcessIdentity {
     version: 1;
     id: string;
@@ -39,19 +36,20 @@ export interface ProcessManagerOptions {
     pollIntervalMs?: number;
     inspectProcess?: ProcessInspector;
 }
-export declare function inspectProcess(pid: number): Promise<ProcessIdentity | null>;
 export declare class ProcessManager {
     private readonly paths;
     private startupTimeoutMs;
     private shutdownTimeoutMs;
     private readonly pollIntervalMs;
     private readonly inspect;
+    private readonly customInspector;
     private readonly starting;
     constructor(paths: BrcPaths, options?: ProcessManagerOptions);
     updateRuntimeSettings(settings: Readonly<Pick<BrcSettings['runtime'], 'startupTimeoutMs' | 'shutdownTimeoutMs'>>): void;
     start(spec: ManagedServiceSpec): Promise<void>;
     stop(spec: ManagedServiceSpec): Promise<void>;
     status(spec: ManagedServiceSpec): Promise<ServiceStatus>;
+    statusMany(specs: readonly ManagedServiceSpec[]): Promise<ServiceStatus[]>;
     private inspectForStatus;
     private waitForReady;
     private waitForHealthy;