@allocator-one/rcl 4.4.19

package/dist/converge/fresh-review.js

@@ -0,0 +1,351 @@
+import { readStable } from '../telemetry/recovery/files.js';
+import { serializeRecoveryDocument, writeExclusiveBytes } from '../evidence/original-run/journal.js';
+import { checkDarwinLockACL } from '../evidence/original-run/lock-path.js';
+import { lockSystemCommand } from '../evidence/original-run/lock-scope.js';
+import { ReviewCycleRejected } from './cycle-remote.js';
+import { createHash, randomUUID } from 'node:crypto';
+import { isDeepStrictEqual } from 'node:util';
+import { lstat, mkdir, readFile, realpath, rename, rm } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+import { z } from 'zod';
+import { convergeAttemptStatePath, loadConvergeAttemptState, previewConvergeAttemptState, validateAttemptCap, DEFAULT_CONVERGE_ATTEMPT_CAP } from './attempt-budget.js';
+import { convergeRunStatePath, initialConvergeRunState, loadConvergeRunState, validateRoundCap, DEFAULT_CONVERGE_ROUND_CAP } from './run-state.js';
+import { ownedNativeTargetCommonDir } from './target-ownership.js';
+import { syncNativeDirectory, writeNativeStateExclusive } from './native-lock.js';
+import { cycleHistorySchema, nativeReviewCycleSchema, reviewCycleReceiptSchema } from './review-cycle.js';
+const MAX_ARCHIVE_BYTES = 64 * 1024 * 1024;
+const hash = (value) => createHash('sha256').update(value).digest('hex');
+const snapshotSchema = z.object({ bytes: z.string(), sha256: z.string().regex(/^[a-f0-9]{64}$/) }).strict().nullable();
+const archiveSchema = z.object({
+    version: z.literal(1), target: z.string(), operationId: z.string().uuid(),
+    files: z.object({ run: snapshotSchema, attempts: snapshotSchema, ledger: snapshotSchema }).strict(),
+    history: cycleHistorySchema,
+}).strict();
+const operationSchema = z.object({
+    version: z.literal(1), target: z.string(), operationId: z.string().uuid(),
+    repo: z.string(), prNumber: z.number().int().positive(), url: z.string().url(),
+    headSha: z.string().regex(/^[a-f0-9]{40}$/), previousCycleId: z.string().uuid().nullable(),
+    attemptCap: z.number().int().positive().safe(), roundCap: z.number().int().positive().safe(),
+    archiveSha256: z.string().regex(/^[a-f0-9]{64}$/),
+    phase: z.enum(['prepared', 'recorded', 'active', 'rejected', 'terminal']),
+    rejection: z.string().optional(),
+    receipt: reviewCycleReceiptSchema.optional(),
+}).strict();
+export function reviewCycleDirectory(common, target) {
+    return join(common, 'rcl-review-cycles', basename(convergeRunStatePath(common, target), '.json'));
+}
+async function readOptional(path) {
+    try {
+        return (await readStable(path, 64 * 1024 * 1024)).raw;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+async function privateDirectory(path, strict = true) {
+    try {
+        await mkdir(path, { mode: 0o700 });
+    }
+    catch (error) {
+        if (error.code !== 'EEXIST')
+            throw error;
+    }
+    await inspectDirectory(path, strict);
+    await syncNativeDirectory(dirname(path));
+}
+async function inspectDirectory(path, strict = true) {
+    const stat = await lstat(path);
+    if (await realpath(path) !== path || !stat.isDirectory() || stat.isSymbolicLink() || (process.platform !== 'win32' &&
+        (stat.uid !== process.geteuid?.() || (strict ? (stat.mode & 0o7777) !== 0o700 : (stat.mode & 0o022) !== 0))))
+        throw new Error('unsafe_review_cycle_directory');
+    if (process.platform === 'darwin')
+        checkDarwinLockACL(await lockSystemCommand('/bin/ls', ['-lde', path]));
+}
+async function replaceJson(path, value) {
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    try {
+        await writeNativeStateExclusive(temporary, value);
+        await rename(temporary, path);
+        await syncNativeDirectory(dirname(path));
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+}
+async function snapshot(path) {
+    const bytes = await readOptional(path);
+    return bytes ? { bytes: bytes.toString('base64'), sha256: hash(bytes) } : null;
+}
+async function currentOperation(directory, target) {
+    try {
+        await inspectDirectory(dirname(directory));
+        await inspectDirectory(directory);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+    const pointer = await readOptional(join(directory, 'current.json'));
+    if (!pointer)
+        return undefined;
+    const { operationId } = z.object({ operationId: z.string().uuid() }).strict().parse(JSON.parse(pointer.toString()));
+    const operation = operationSchema.parse(JSON.parse((await readStable(join(directory, `${operationId}.json`), 64 * 1024)).text));
+    if (operation.operationId !== operationId || operation.target !== target)
+        throw new Error('fresh_review_operation_mismatch');
+    return operation;
+}
+/** Capture the request generation before waiting for another launcher. */
+export async function freshReviewRequestVersion(common, target) {
+    const operation = await currentOperation(reviewCycleDirectory(common, target), target);
+    return operation ? `${operation.operationId}:${operation.phase}` : undefined;
+}
+/** A durably completed first dispatch needs no new provider/output preflight. */
+export async function freshReviewCompletionPending(common, target) {
+    const operation = await currentOperation(reviewCycleDirectory(common, target), target);
+    return operation?.phase === 'active' && (await loadConvergeRunState(common, target))?.lastLaunch?.status === 'completed';
+}
+/** A pending transition cannot be bypassed by an ordinary guarded continuation. */
+export async function assertNoPendingFreshReview(common, target) {
+    const operation = await currentOperation(reviewCycleDirectory(common, target), target);
+    if (operation && operation.phase !== 'terminal')
+        throw new Error('fresh_review_pending: resume the same review with --start-over');
+}
+/** Only the owning fresh guard may claim while its first dispatch is unfinished. */
+export async function assertFreshReviewClaim(common, target, operationId) {
+    const operation = await currentOperation(reviewCycleDirectory(common, target), target);
+    if (operationId !== undefined) {
+        if (!operation || operation.operationId !== operationId || operation.phase !== 'active')
+            throw new Error('fresh_review_operation_changed');
+    }
+    else if (operation && operation.phase !== 'terminal') {
+        throw new Error('fresh_review_pending: resume the same review with --start-over');
+    }
+}
+async function readArchive(directory, operation) {
+    const bytes = (await readStable(join(directory, `${operation.operationId}.archive.json`), MAX_ARCHIVE_BYTES)).raw;
+    if (hash(bytes) !== operation.archiveSha256)
+        throw new Error('fresh_review_archive_changed');
+    const archive = archiveSchema.parse(JSON.parse(bytes.toString()));
+    if (archive.target !== operation.target || archive.operationId !== operation.operationId)
+        throw new Error('fresh_review_archive_mismatch');
+    for (const file of Object.values(archive.files)) {
+        if (file && hash(Buffer.from(file.bytes, 'base64')) !== file.sha256)
+            throw new Error('fresh_review_archive_changed');
+    }
+    return archive;
+}
+/** Verify history before any further spending, without rewriting its original bytes. */
+export async function verifyReviewCycle(common, target, cycle) {
+    nativeReviewCycleSchema.parse(cycle);
+    const directory = reviewCycleDirectory(common, target);
+    if (cycle.archivePath !== join(directory, `${cycle.operationId}.archive.json`))
+        throw new Error('fresh_review_archive_path_mismatch');
+    await inspectDirectory(dirname(directory));
+    await inspectDirectory(directory);
+    const bytes = (await readStable(cycle.archivePath, MAX_ARCHIVE_BYTES)).raw;
+    if (hash(bytes) !== cycle.archiveSha256)
+        throw new Error('fresh_review_archive_changed');
+    const archive = archiveSchema.parse(JSON.parse(bytes.toString()));
+    if (archive.target !== target || archive.operationId !== cycle.operationId || !isDeepStrictEqual(archive.history, cycle.history)) {
+        throw new Error('fresh_review_history_mismatch');
+    }
+}
+/** Preflight and create/resume exactly one operation while the caller owns the native target. */
+export async function prepareFreshReview(options) {
+    const common = await ownedNativeTargetCommonDir(options.ownership, options.gitCommonDir, options.target);
+    const directory = reviewCycleDirectory(common, options.target);
+    const attemptCap = validateAttemptCap(options.maxAttempts ?? DEFAULT_CONVERGE_ATTEMPT_CAP);
+    const roundCap = validateRoundCap(options.maxRounds ?? DEFAULT_CONVERGE_ROUND_CAP);
+    let operation = await currentOperation(directory, options.target);
+    if (!operation || operation.phase === 'terminal') {
+        // Capability/access failure must leave the native budget and evidence untouched.
+        const current = await options.remote.current();
+        if (current)
+            reviewCycleReceiptSchema.parse(current);
+        const run = await loadConvergeRunState(common, options.target);
+        const attempts = await previewConvergeAttemptState(common, options.target);
+        if (!isDeepStrictEqual(run?.cycle, attempts?.cycle))
+            throw new Error('fresh_review_state_pair_mismatch');
+        if (run?.cycle)
+            await verifyReviewCycle(common, options.target, run.cycle);
+        const history = cycleHistorySchema.parse({
+            attempts: (run?.cycle?.history.attempts ?? 0) + (attempts?.attemptsUsed ?? run?.lastLaunch?.attempt ?? 0),
+            rounds: (run?.cycle?.history.rounds ?? 0) + (run?.rounds.length ?? 0),
+            ...(run?.cycle?.history.incomplete || (attempts?.migratedAttempts ?? 0) > 0 || (run && (run.rounds.length > 0 || run.lastLaunch) && !attempts) ? { incomplete: true } : {}),
+        });
+        const operationId = randomUUID();
+        const ledger = /^[A-Za-z0-9._-]+$/.test(options.target)
+            ? await snapshot(join(common, `rcl-converge-${options.target}-ledger.md`)) : null;
+        const archive = { version: 1, target: options.target, operationId, history,
+            files: { run: await snapshot(convergeRunStatePath(common, options.target)),
+                attempts: await snapshot(convergeAttemptStatePath(common, options.target)), ledger } };
+        // Bound the exact encoded document before publishing any operation/barrier.
+        // Each individually bounded snapshot may grow during base64 encoding.
+        if (Buffer.byteLength(serializeRecoveryDocument(archive)) > MAX_ARCHIVE_BYTES) {
+            throw new Error('fresh_review_archive_too_large: prior history exceeds the supported archive limit; no fresh operation was published');
+        }
+        await privateDirectory(dirname(directory));
+        await privateDirectory(directory);
+        const archivePath = join(directory, `${operationId}.archive.json`);
+        await writeNativeStateExclusive(archivePath, archive);
+        operation = { version: 1, target: options.target, operationId, repo: options.remote.repo.toLowerCase(),
+            prNumber: options.remote.prNumber, url: options.remote.url, headSha: options.headSha,
+            previousCycleId: current?.id ?? null, attemptCap, roundCap,
+            archiveSha256: hash(await readFile(archivePath)), phase: 'prepared' };
+        operationSchema.parse(operation);
+        await replaceJson(join(directory, `${operationId}.json`), operation);
+        await replaceJson(join(directory, 'current.json'), { operationId });
+    }
+    if (operation.repo !== options.remote.repo.toLowerCase() || operation.prNumber !== options.remote.prNumber ||
+        operation.url !== options.remote.url ||
+        (options.maxAttempts !== undefined && options.maxAttempts !== operation.attemptCap) ||
+        (options.maxRounds !== undefined && options.maxRounds !== operation.roundCap))
+        throw new Error('fresh_review_operation_inputs_changed');
+    const archive = await readArchive(directory, operation);
+    if (operation.phase === 'rejected') {
+        await restoreRejected(common, directory, operation, archive);
+        throw new ReviewCycleRejected(operation.rejection ?? 'Fresh review was not created; repeat the explicit request when ready');
+    }
+    if (operation.phase === 'prepared') {
+        // Attempt state goes first: older standalone claimers read only this file.
+        await installBarrier(convergeAttemptStatePath(common, options.target), archive.files.attempts, operation, 3);
+        await installBarrier(convergeRunStatePath(common, options.target), archive.files.run, operation, 2);
+        let receipt;
+        try {
+            receipt = reviewCycleReceiptSchema.parse(await options.remote.start({ operation_id: operation.operationId,
+                previous_cycle_id: operation.previousCycleId, head_sha: operation.headSha }));
+        }
+        catch (error) {
+            if (error instanceof ReviewCycleRejected) {
+                operation = { ...operation, phase: 'rejected', rejection: error.message };
+                await replaceJson(join(directory, `${operation.operationId}.json`), operation);
+                await restoreRejected(common, directory, operation, archive);
+            }
+            throw error;
+        }
+        if (receipt.operation_id !== operation.operationId || receipt.previous_cycle_id !== operation.previousCycleId ||
+            receipt.head_sha !== operation.headSha)
+            throw new Error('fresh_review_receipt_mismatch');
+        operation = { ...operation, phase: 'recorded', receipt };
+        await replaceJson(join(directory, `${operation.operationId}.json`), operation);
+    }
+    if (!operation.receipt)
+        throw new Error('fresh_review_receipt_missing');
+    const active = await options.remote.current();
+    if (!active)
+        throw new Error('fresh_review_superseded');
+    const activeReceipt = reviewCycleReceiptSchema.parse(active);
+    const superseded = activeReceipt.id !== operation.receipt.id;
+    if (!superseded && !isDeepStrictEqual(activeReceipt, operation.receipt))
+        throw new Error('fresh_review_receipt_mismatch');
+    const cycle = { id: operation.receipt.id, operationId: operation.operationId,
+        previousCycleId: operation.previousCycleId, repo: operation.repo, prNumber: operation.prNumber, url: operation.url,
+        archivePath: join(directory, `${operation.operationId}.archive.json`), archiveSha256: operation.archiveSha256,
+        history: archive.history };
+    if (operation.phase === 'recorded') {
+        const attempts = { version: 3, cycle, target: options.target, cap: operation.attemptCap,
+            migratedAttempts: 0, attemptsUsed: 0, attempts: [], updatedAt: new Date().toISOString() };
+        await activate(convergeAttemptStatePath(common, options.target), attempts, operation);
+        await activate(convergeRunStatePath(common, options.target), {
+            ...initialConvergeRunState(options.target), version: 2, cycle, roundCap: operation.roundCap,
+        }, operation);
+        operation = { ...operation, phase: 'active' };
+        await replaceJson(join(directory, `${operation.operationId}.json`), operation);
+    }
+    await assertReviewCyclePair(common, options.target, cycle);
+    if (superseded) {
+        // Preserve this operation's history and claims, but do not leave its local
+        // transition permanently pending. This call spends nothing and never retires
+        // the remote winner; another deliberate request may start from that winner.
+        await finishFreshReview(common, options.target, operation.operationId, options.ownership);
+        throw new Error('fresh_review_superseded: this operation ended without new reviewer work; a later explicit --start-over can request a new cycle');
+    }
+    if (operation.headSha !== options.headSha) {
+        // Recover the original remote receipt and finish local activation first:
+        // a lost POST acknowledgement must never be mistaken for a noncommit.
+        await finishFreshReview(common, options.target, operation.operationId, options.ownership);
+        throw new Error('fresh_review_operation_head_changed: this operation ended without new reviewer work; inspect its retained outcome before a later explicit fresh request');
+    }
+    return { cycle, operationId: operation.operationId };
+}
+async function installBarrier(path, original, operation, version) {
+    await privateDirectory(dirname(path), false);
+    const bytes = await readOptional(path);
+    const barrier = { version, target: operation.target, startOverPending: operation.operationId };
+    if (bytes && isDeepStrictEqual(JSON.parse(bytes.toString()), barrier))
+        return;
+    if (original ? !bytes || hash(bytes) !== original.sha256 : bytes !== undefined)
+        throw new Error('fresh_review_native_state_changed');
+    await replaceJson(path, barrier);
+}
+async function activate(path, state, operation) {
+    const current = JSON.parse(await readFile(path, 'utf8'));
+    if (current.startOverPending === operation.operationId && current.target === operation.target)
+        await replaceJson(path, state);
+    else {
+        // A crash can occur between the two activations. Accept the already-written
+        // empty partner, but never erase claims made after activation.
+        const { updatedAt: _currentTime, ...stored } = current;
+        const { updatedAt: _newTime, ...expected } = state;
+        if (!isDeepStrictEqual(stored, expected))
+            throw new Error('fresh_review_activation_changed');
+    }
+}
+/** Mark a returned dispatch outcome terminal; a later explicit request may create another cycle. */
+export async function finishFreshReview(common, target, operationId, ownership) {
+    common = await ownedNativeTargetCommonDir(ownership, common, target);
+    const directory = reviewCycleDirectory(common, target);
+    const operation = await currentOperation(directory, target);
+    if (!operation || operation.operationId !== operationId || operation.phase !== 'active')
+        throw new Error('fresh_review_operation_changed');
+    await replaceJson(join(directory, `${operationId}.json`), { ...operation, phase: 'terminal' });
+}
+/** Neither a missing partner nor a legacy ledger may replenish a cycle's budget. */
+export async function assertReviewCyclePair(common, target, expected) {
+    const run = await loadConvergeRunState(common, target);
+    const attempts = await loadConvergeAttemptState(common, target);
+    if (!isDeepStrictEqual(run?.cycle, expected) || !isDeepStrictEqual(attempts?.cycle, expected)) {
+        throw new Error('fresh_review_state_pair_mismatch');
+    }
+    if (expected)
+        await verifyReviewCycle(common, target, expected);
+}
+/** Default retained outputs make the explicit command usable without bookkeeping flags. */
+export async function freshReviewOutputPaths(common) {
+    const directory = join(common, 'rcl-fresh-reports');
+    await privateDirectory(directory);
+    const id = randomUUID();
+    return { jsonFile: join(directory, `${id}.json`), markdown: join(directory, `${id}.md`) };
+}
+/** Roll back only a proven noncommit, retaining the archive and rejected operation. */
+async function restoreRejected(common, directory, operation, archive) {
+    for (const [path, original] of [
+        [convergeRunStatePath(common, operation.target), archive.files.run],
+        [convergeAttemptStatePath(common, operation.target), archive.files.attempts],
+    ]) {
+        const bytes = await readOptional(path);
+        if (original ? bytes && hash(bytes) === original.sha256 : !bytes)
+            continue;
+        const current = bytes ? JSON.parse(bytes.toString()) : undefined;
+        if (current?.startOverPending !== operation.operationId || current?.target !== operation.target)
+            throw new Error('fresh_review_restore_changed');
+        if (original) {
+            const temp = `${path}.${randomUUID()}.tmp`;
+            try {
+                await writeExclusiveBytes(temp, Buffer.from(original.bytes, 'base64'));
+                await rename(temp, path);
+            }
+            finally {
+                await rm(temp, { force: true });
+            }
+        }
+        else
+            await rm(path);
+        await syncNativeDirectory(dirname(path));
+    }
+    await replaceJson(join(directory, `${operation.operationId}.json`), { ...operation, phase: 'terminal' });
+}
+//# sourceMappingURL=fresh-review.js.map

package/dist/converge/fresh-review.js.map

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

package/dist/converge/launch-guard.d.ts

@@ -0,0 +1,55 @@
+import { type LegacyRetrySelection } from './legacy-launch-health.js';
+import { type GuardedLaunchState, type GuardedLaunchCompletion, type OrdinaryLaunchInputsBinding } from './launch-record.js';
+export { launchSchema, type GuardedLaunchState, type GuardedLaunchCompletion, type OrdinaryLaunchInputsBinding } from './launch-record.js';
+import type { ReviewCycleRemote } from './review-cycle.js';
+import { type NativeTargetOwnership } from './target-ownership.js';
+import { type ConvergeAttemptClaim } from './attempt-budget.js';
+import type { ConvergeContext } from '../report/run-header.js';
+import { type BoundFixRecoverySelection } from './bound-fix-recovery.js';
+import { type OriginalLaunch, type OriginalLaunchInput } from '../dispatch/original-launch.js';
+/** Canonical original descriptor prepared under target ownership, before its claim is spent. */
+export interface PreparedOriginalLaunch {
+    readonly launch: OriginalLaunch;
+    readonly launchBytes: string;
+}
+export interface OriginalLaunchPreflight {
+    input: Omit<OriginalLaunchInput, 'target' | 'originalNativeClaim'>;
+    /** Persist the immutable package while the target is exclusively owned, before spending the claim. */
+    beforeClaim: (value: PreparedOriginalLaunch, ownership: NativeTargetOwnership) => Promise<void>;
+    nowMs?: () => number;
+}
+export interface GuardedLaunchOptions {
+    gitCommonDir: string;
+    target: string;
+    headSha: string;
+    inputSha256: string;
+    round?: number;
+    maxAttempts?: number;
+    maxRounds?: number;
+    intent?: 'review' | 'stop-upstream' | 'stop-review' | 'retry-delivery';
+    retryReason?: string;
+    legacyRetry?: LegacyRetrySelection;
+    boundFixRecovery?: BoundFixRecoverySelection;
+    startOver?: boolean;
+    cycleRemote?: ReviewCycleRemote;
+    validate: () => Promise<void>;
+    /** Optional retained execution only; ordinary launch behavior is unchanged. */
+    originalLaunch?: OriginalLaunchPreflight;
+    /** Retain authenticated launch inputs under ownership after validation, before spending the native claim. */
+    beforeClaim?: (context: ConvergeContext, ownership: NativeTargetOwnership) => Promise<void | {
+        ordinaryInputs: OrdinaryLaunchInputsBinding;
+    }>;
+    onClaim?: (claim: ConvergeAttemptClaim) => Promise<void>;
+    /** Reuse this ownership for durable reviewer checkpoints; never take a second target lock. */
+    run: (context: ConvergeContext, ownership: NativeTargetOwnership, original?: PreparedOriginalLaunch) => Promise<GuardedLaunchCompletion>;
+}
+export declare class ReviewLaunchRefused extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/** Shared launch-health decision; recovery paths must use the guard's policy. */
+export declare function hasHealthyGuardedLaunch(previous: GuardedLaunchState): boolean;
+export interface GuardedLaunchClaim extends ConvergeAttemptClaim {
+    resumedCompletion?: GuardedLaunchCompletion;
+}
+export declare function guardReviewLaunch(input: GuardedLaunchOptions): Promise<GuardedLaunchClaim>;