@allocator-one/rcl 4.4.19

package/dist/coordination/registry-lock.js

@@ -0,0 +1,498 @@
+import { randomUUID } from 'node:crypto';
+import { constants } from 'node:fs';
+import { link, lstat, mkdir, open, readdir, rename, rmdir, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { readStable, sha256 } from '../telemetry/recovery/files.js';
+import { LOCK_UUID } from '../evidence/original-run/lock-scope.js';
+function code(error) { return error?.code; }
+/**
+ * Reserve the legacy recovery-lock pathname for the duration of `work`.
+ * Creation, stale-owner reclamation, and release are all ownership checked so
+ * the bridge cannot be a check-then-act preflight beside the bakery registry.
+ */
+export async function withLegacyReservation(root, identity, owner, work, options = { sync: async () => { } }) {
+    const timeout = options.lockTimeoutMs ?? 5_000;
+    const retry = options.lockRetryMs ?? 25;
+    if (!Number.isSafeInteger(timeout) || timeout < 1 || !Number.isSafeInteger(retry) || retry < 1) {
+        throw new Error('invalid_registry_lock_timing');
+    }
+    const now = options.now ?? (() => performance.now());
+    const deadline = now() + timeout;
+    const wait = options.wait ?? (() => new Promise(resolve => setTimeout(resolve, retry)));
+    const checkTime = () => { if (now() >= deadline)
+        throw new Error('recovery_run_locked'); };
+    const path = join(root, `${sha256(identity)}.lock`);
+    const reclaim = `${path}.reclaim`;
+    const read = options.read ?? (async (file) => (await readStable(file, 2048)).text);
+    const readOwner = async () => {
+        let text;
+        try {
+            text = await read(path);
+        }
+        catch (error) {
+            if (code(error) === 'ENOENT')
+                return undefined;
+            if (error instanceof Error && error.message === 'changing_source')
+                return undefined;
+            throw error;
+        }
+        let current;
+        try {
+            current = JSON.parse(text);
+        }
+        catch {
+            throw new Error('incomplete_recovery_lock_requires_inspection');
+        }
+        if (!current || typeof current !== 'object' || !Number.isSafeInteger(current.pid) ||
+            current.pid < 1 || typeof current.token !== 'string') {
+            throw new Error('invalid_recovery_lock_requires_inspection');
+        }
+        return current;
+    };
+    const create = async () => {
+        let created = false;
+        let published = false;
+        const temporary = `${path}.${owner.token}.${randomUUID()}.tmp`;
+        try {
+            const handle = await open(temporary, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY | constants.O_NOFOLLOW, 0o600);
+            created = true;
+            try {
+                await options.onPrepared?.();
+                await handle.writeFile(JSON.stringify(owner) + '\n');
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+            // Link publication gives legacy readers either no owner or a complete,
+            // fsynced document. They must never parse our private write in flight.
+            await link(temporary, path);
+            published = true;
+            await unlink(temporary);
+            created = false;
+            await options.sync(root);
+            return true;
+        }
+        catch (error) {
+            if (code(error) === 'EEXIST')
+                return false;
+            if (published) {
+                try {
+                    await unlink(path);
+                    await options.sync(root);
+                }
+                catch (cleanup) {
+                    throw new AggregateError([error, cleanup], 'legacy_recovery_lock_cleanup_failed', { cause: error });
+                }
+            }
+            throw error;
+        }
+        finally {
+            if (created) {
+                try {
+                    await unlink(temporary);
+                }
+                catch (cleanup) {
+                    if (code(cleanup) !== 'ENOENT')
+                        throw cleanup;
+                }
+            }
+        }
+    };
+    for (;;) {
+        let reclaiming = false;
+        try {
+            await lstat(reclaim);
+            reclaiming = true;
+        }
+        catch (error) {
+            if (code(error) !== 'ENOENT')
+                throw error;
+        }
+        if (reclaiming)
+            throw new Error('legacy_recovery_lock_requires_inspection');
+        if (await create())
+            break;
+        let snapshot;
+        try {
+            snapshot = await readStable(path, 2048);
+        }
+        catch (error) {
+            if (code(error) === 'ENOENT')
+                continue;
+            if (error instanceof Error && error.message === 'changing_source') {
+                checkTime();
+                await wait();
+                continue;
+            }
+            throw error;
+        }
+        let existing;
+        try {
+            existing = JSON.parse(snapshot.text);
+        }
+        catch {
+            throw new Error('incomplete_recovery_lock_requires_inspection');
+        }
+        if (!Number.isSafeInteger(existing.pid) || existing.pid < 1 || typeof existing.token !== 'string') {
+            throw new Error('invalid_recovery_lock_requires_inspection');
+        }
+        // A scoped document is a modern owner, even when it occupies the legacy
+        // pathname for compatibility. A local PID observation cannot establish
+        // that an owner from another boot or PID namespace is dead. PID-only
+        // documents retain the caller's explicit compatibility policy.
+        if (existing.scope !== undefined) {
+            if (!options.qualifiedLegacy?.(existing))
+                throw new Error('legacy_recovery_lock_requires_inspection');
+            if (options.mayProbeLegacy && !options.mayProbeLegacy(existing))
+                throw new Error('legacy_recovery_lock_requires_inspection');
+        }
+        else if (options.reclaimLegacy === false) {
+            throw new Error('legacy_recovery_lock_requires_inspection');
+        }
+        let alive = true;
+        try {
+            (options.probe ?? (pid => process.kill(pid, 0)))(existing.pid);
+        }
+        catch (error) {
+            if (code(error) === 'ESRCH')
+                alive = false;
+        }
+        if (!alive) {
+            try {
+                await mkdir(reclaim, { mode: 0o700 });
+            }
+            catch (error) {
+                if (code(error) === 'EEXIST')
+                    throw new Error('legacy_recovery_lock_requires_inspection');
+                if (code(error) === 'ENOENT')
+                    continue;
+                throw error;
+            }
+            try {
+                if ((await readStable(path, 2048)).sha256 === snapshot.sha256) {
+                    await unlink(path);
+                    await options.sync(root);
+                }
+            }
+            catch (error) {
+                if (code(error) !== 'ENOENT')
+                    throw error;
+            }
+            finally {
+                try {
+                    await rmdir(reclaim);
+                }
+                catch (error) {
+                    if (code(error) !== 'ENOENT')
+                        throw error;
+                }
+            }
+            continue;
+        }
+        checkTime();
+        await wait();
+    }
+    const release = async () => {
+        const current = await readOwner();
+        if (!current || current.pid !== owner.pid || current.token !== owner.token ||
+            (owner.scope !== undefined && !isDeepStrictEqual(current.scope, owner.scope))) {
+            throw new Error('legacy_recovery_lock_owner_changed');
+        }
+        await unlink(path);
+        await options.sync(root);
+    };
+    let failed = false;
+    let failure;
+    let completed = false;
+    let result;
+    try {
+        result = await work();
+        completed = true;
+        return result;
+    }
+    catch (error) {
+        if (error instanceof RegistryCleanupError) {
+            result = error.result;
+            completed = true;
+            failure = error;
+        }
+        else {
+            failed = true;
+            failure = error;
+        }
+        throw error;
+    }
+    finally {
+        try {
+            await release();
+        }
+        catch (error) {
+            if (completed) {
+                const cause = failure ? new AggregateError([failure, error], 'recovery_lock_cleanup_failed', { cause: failure }) : error;
+                throw new RegistryCleanupError(result, cause);
+            }
+            if (failed)
+                throw new AggregateError([failure, error], 'recovery_lock_cleanup_failed', { cause: failure });
+            throw error;
+        }
+    }
+}
+/** Work completed; only coordination cleanup failed. Never replay the result. */
+export class RegistryCleanupError extends Error {
+    result;
+    constructor(result, cause) {
+        super(cause instanceof Error ? cause.message : 'registry_cleanup_failed', { cause });
+        this.result = result;
+        this.name = 'RegistryCleanupError';
+    }
+}
+/**
+ * Dynamic Lamport bakery on coherent local storage: choosing is visible before
+ * ticket selection, then one fixed (ticket, token) orders this acquisition.
+ * Each path is unique for all time. No shared reclaim guard or TTL is involved.
+ */
+export async function withRegistryLock(root, identity, work, policy, hooks = {}) {
+    const sync = policy.sync;
+    const scope = await (hooks.scope ?? policy.scope)();
+    if (!policy.validScope(scope))
+        throw new Error('unsupported_recovery_lock_scope');
+    root = await policy.prepareRoot(root);
+    const key = sha256(identity);
+    const token = (hooks.token ?? randomUUID)();
+    if (!LOCK_UUID.test(token))
+        throw new Error('invalid_recovery_lock_token');
+    return withLegacyReservation(root, identity, { pid: process.pid, token, scope }, async () => {
+        // Keep this directory permanently: removing it on release could split two
+        // contenders across different inodes of the same registry pathname.
+        const registry = join(root, `${key}.bakery`);
+        try {
+            await mkdir(registry, { mode: 0o700 });
+        }
+        catch (error) {
+            if (code(error) !== 'EEXIST')
+                throw error;
+        }
+        await sync(root);
+        await policy.inspectRegistry(registry);
+        const path = join(registry, `${token}.json`);
+        let owner = { version: 1, pid: process.pid, token, scope, state: 'choosing' };
+        const lockTimeoutMs = policy.lockTimeoutMs ?? 5_000;
+        const lockRetryMs = policy.lockRetryMs ?? 25;
+        if (!Number.isSafeInteger(lockTimeoutMs) || lockTimeoutMs < 1 ||
+            !Number.isSafeInteger(lockRetryMs) || lockRetryMs < 1) {
+            throw new Error('invalid_registry_lock_timing');
+        }
+        const now = hooks.now ?? (() => performance.now());
+        const deadline = now() + lockTimeoutMs;
+        const wait = hooks.wait ?? (() => new Promise(resolve => setTimeout(resolve, lockRetryMs)));
+        const checkTime = () => { if (now() >= deadline)
+            throw new Error('recovery_run_locked'); };
+        const read = hooks.read ?? policy.read ?? (async (file) => (await readStable(file, 2048)).text);
+        let published = false;
+        const emit = (stage, peer) => hooks.onEvent?.({ stage, registration: owner, peer });
+        const readOwner = async (file) => {
+            for (;;) {
+                let text;
+                try {
+                    text = await read(file);
+                }
+                catch (error) {
+                    if (code(error) === 'ENOENT')
+                        return undefined;
+                    if (error instanceof Error && error.message === 'changing_source') {
+                        checkTime();
+                        await wait();
+                        continue;
+                    }
+                    throw error;
+                }
+                let value;
+                try {
+                    value = JSON.parse(text);
+                }
+                catch {
+                    throw new Error('incomplete_recovery_lock_requires_inspection');
+                }
+                if (!value || value.version !== 1 || !Number.isSafeInteger(value.pid) || value.pid < 1 ||
+                    typeof value.token !== 'string' || !LOCK_UUID.test(value.token) || file !== join(registry, `${value.token}.json`) ||
+                    !policy.validScope(value.scope) || !['choosing', 'ready'].includes(value.state) ||
+                    (value.state === 'choosing' ? value.ticket !== undefined : !Number.isSafeInteger(value.ticket) || value.ticket < 1)) {
+                    throw new Error('invalid_recovery_lock_requires_inspection');
+                }
+                if (!isDeepStrictEqual(value.scope, scope))
+                    throw new Error('foreign_recovery_lock_scope');
+                return value;
+            }
+        };
+        const verifyOwned = async () => {
+            if (!isDeepStrictEqual(await readOwner(path), owner))
+                throw new Error('recovery_lock_owner_changed');
+        };
+        const publish = async (value, initial) => {
+            const temporary = join(registry, `${token}.${randomUUID()}.tmp`);
+            let created = false;
+            try {
+                const handle = await open(temporary, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY | constants.O_NOFOLLOW, 0o600);
+                created = true;
+                try {
+                    await handle.writeFile(JSON.stringify(value) + '\n');
+                    await handle.sync();
+                }
+                finally {
+                    await handle.close();
+                }
+                if (initial)
+                    await link(temporary, path);
+                else {
+                    await verifyOwned();
+                    await rename(temporary, path);
+                    created = false;
+                }
+                // Set ownership before any fallible post-publication operation, including
+                // temp unlink and directory fsync, so the finally block can release it.
+                published = true;
+                owner = value;
+            }
+            finally {
+                if (created)
+                    await unlink(temporary);
+            }
+            await sync(registry);
+        };
+        const names = async () => {
+            const all = await readdir(registry);
+            const result = [];
+            for (const name of all) {
+                // An interrupted private write is not a choosing registration. Only
+                // atomic publication into the .json namespace joins the protocol.
+                const parts = name.split('.');
+                if (parts.length === 3 && parts[2] === 'tmp' && LOCK_UUID.test(parts[0]) && LOCK_UUID.test(parts[1]))
+                    continue;
+                if (!name.endsWith('.json') || !LOCK_UUID.test(name.slice(0, -5)))
+                    throw new Error('invalid_recovery_lock_registration');
+                result.push(name);
+            }
+            return result.sort();
+        };
+        const scan = async () => {
+            for (;;) {
+                checkTime();
+                const directory = await lstat(registry, { bigint: true });
+                const before = await names();
+                const peers = [];
+                for (const name of before) {
+                    checkTime();
+                    const peer = await readOwner(join(registry, name));
+                    if (peer)
+                        peers.push(peer);
+                }
+                // Under the supported local visibility contract, unchanged full name
+                // scans prevent a disappearing registration from hiding a chooser that
+                // predated our ready publication. A newly arriving chooser must see us.
+                const after = await names();
+                const current = await lstat(registry, { bigint: true });
+                if (peers.length === before.length && isDeepStrictEqual(before, after) &&
+                    directory.ino === current.ino && directory.dev === current.dev &&
+                    directory.ctimeNs === current.ctimeNs && directory.mtimeNs === current.mtimeNs)
+                    return peers;
+                await wait();
+            }
+        };
+        const release = async () => {
+            if (!published)
+                return;
+            await verifyOwned();
+            await unlink(path);
+            published = false;
+            await sync(registry);
+        };
+        let failed = false;
+        let failure;
+        let completed = false;
+        let result;
+        try {
+            await emit('legacy_reserved');
+            await publish(owner, true);
+            await emit('choosing_published');
+            const peers = await scan();
+            const maximum = peers.reduce((max, peer) => Math.max(max, peer.ticket ?? 0), 0);
+            if (maximum >= Number.MAX_SAFE_INTEGER)
+                throw new Error('recovery_lock_ticket_exhausted');
+            const ready = { ...owner, state: 'ready', ticket: maximum + 1 };
+            // The hook observes the selected value without mutating the visible owner.
+            await hooks.onEvent?.({ stage: 'ticket_selected', registration: ready });
+            await publish(ready, false);
+            await emit('ready_published');
+            for (;;) {
+                const peers = await scan();
+                let blocked = false;
+                // Validate the entire scan's scopes before making any local PID probe.
+                for (const peer of peers) {
+                    if (peer.token === token)
+                        continue;
+                    let dead = false;
+                    try {
+                        if (policy.mayProbePid(peer.scope))
+                            (hooks.probe ?? (pid => process.kill(pid, 0)))(peer.pid);
+                    }
+                    catch (error) {
+                        if (code(error) !== 'ESRCH')
+                            throw new Error('recovery_lock_liveness_unknown');
+                        dead = true;
+                    }
+                    if (dead) {
+                        await emit('before_reap', peer);
+                        // This pathname is never reused, so another/delayed reaper can only
+                        // unlink this dead generation; ENOENT means it already did so.
+                        try {
+                            await unlink(join(registry, `${peer.token}.json`));
+                            await sync(registry);
+                        }
+                        catch (error) {
+                            if (code(error) !== 'ENOENT')
+                                throw error;
+                        }
+                        await emit('after_reap', peer);
+                    }
+                    else if (peer.state === 'choosing' || peer.ticket < owner.ticket ||
+                        (peer.ticket === owner.ticket && peer.token < token))
+                        blocked = true;
+                }
+                if (!blocked) {
+                    await verifyOwned();
+                    checkTime();
+                    await emit('scan_complete');
+                    result = await work();
+                    completed = true;
+                    return result;
+                }
+                checkTime();
+                await wait();
+            }
+        }
+        catch (error) {
+            failed = true;
+            failure = error;
+            throw error;
+        }
+        finally {
+            try {
+                await release();
+            }
+            catch (error) {
+                if (failed)
+                    throw new AggregateError([failure, error], 'recovery_lock_cleanup_failed', { cause: failure });
+                if (completed)
+                    throw new RegistryCleanupError(result, error);
+                throw error;
+            }
+        }
+    }, { sync, read: hooks.read ?? policy.read, probe: hooks.probe, now: hooks.now, wait: hooks.wait,
+        lockTimeoutMs: policy.lockTimeoutMs, lockRetryMs: policy.lockRetryMs, onPrepared: hooks.onLegacyPrepared,
+        qualifiedLegacy: owner => policy.validScope(owner.scope) &&
+            isDeepStrictEqual(owner.scope, scope),
+        mayProbeLegacy: owner => policy.validScope(owner.scope) && policy.mayProbePid(owner.scope) });
+}
+//# sourceMappingURL=registry-lock.js.map

package/dist/coordination/registry-lock.js.map

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

package/dist/discuss.d.ts

@@ -0,0 +1,53 @@
+import type { ReviewAdapter, AdapterOptions, ModelAnswer } from './dispatch/adapter.js';
+import type { ConsensusFinding, ReviewResult } from './consensus/types.js';
+import type { ReasoningEffort } from './config/schema.js';
+/**
+ * One-shot council discussion of a single finding from a saved report
+ * (`rcl review --json-file`). No session state: the finding's own report
+ * entry — description, consensus, per-model positions — is the
+ * reconstructed context, and each model that flagged the finding answers
+ * the follow-up question independently, in parallel.
+ */
+export interface DiscussInput {
+    result: ReviewResult;
+    findingId: string;
+    question: string;
+    /** Override which models answer; defaults to the models that flagged it. */
+    models?: string[];
+    contextDocs?: Array<{
+        label: string;
+        content: string;
+    }>;
+}
+/**
+ * Resolve `--finding <id>` against kept findings first, then the
+ * below-threshold appendix (appendix findings are prime discussion
+ * targets — one model saw something nobody confirmed). Model-generated ids
+ * can collide across reviewers, so `<id>:<n>` picks the nth match (1-based).
+ */
+export declare function resolveFinding(result: ReviewResult, findingRef: string): ConsensusFinding;
+export declare function buildDiscussPrompts(input: {
+    finding: ConsensusFinding;
+    question: string;
+    contextDocs?: Array<{
+        label: string;
+        content: string;
+    }>;
+}): {
+    systemPrompt: string;
+    userPrompt: string;
+};
+export interface DiscussOptions extends AdapterOptions {
+    reasoningEffort?: ReasoningEffort;
+    /** Test seam; defaults to the builtin providers. */
+    adapterFactory?: (provider: string) => ReviewAdapter;
+}
+/** Ask every target model the same question in parallel. */
+export declare function runDiscussion(models: string[], prompts: {
+    systemPrompt: string;
+    userPrompt: string;
+}, options: DiscussOptions): Promise<ModelAnswer[]>;
+export declare function loadContextDocs(paths: string[]): Promise<Array<{
+    label: string;
+    content: string;
+}>>;