@allocator-one/rcl 4.5.3 → 4.5.5

package/dist/converge/historical-delivery-reconciliation-schema.js

@@ -0,0 +1,111 @@
+import { isDeepStrictEqual } from 'node:util';
+import { z } from 'zod';
+import { reviewerHealthSchema, strongDeliveryReconciliationSchema } from './launch-record.js';
+import { decodeRecoveryDocument } from '../evidence/original-run/decode.js';
+import { serializeRecoveryDocument } from '../evidence/original-run/journal.js';
+import { sha256 } from '../telemetry/recovery/files.js';
+const digest = z.string().regex(/^[a-f0-9]{64}$/);
+const commit = z.string().regex(/^[a-f0-9]{40}$/);
+const uuid = z.string().uuid();
+export const historicalServerProjectionSchema = z.object({
+    origin: z.string().url(),
+    runId: uuid,
+    provenance: z.literal('live'),
+    receivedAt: z.string().datetime({ offset: true }),
+    cycleId: uuid,
+    repoVerified: z.literal(true),
+    isCrossRepository: z.literal(false),
+    headVerified: z.string().min(1),
+    target: z.object({
+        kind: z.enum(['pr', 'patch']),
+        repo: z.string().min(1),
+        prNumber: z.number().int().positive().safe(),
+        headSha: commit,
+        baseSha: commit,
+        diffSha256: digest,
+    }).strict(),
+    converge: z.object({
+        target: z.string().min(1),
+        attempt: z.number().int().positive().safe(),
+        round: z.number().int().positive().safe(),
+    }).strict(),
+    report: z.object({
+        declaredSha256: digest,
+        declaredBytes: z.number().int().nonnegative().safe(),
+        stored: z.literal(true),
+    }).strict(),
+}).strict();
+export const historicalDeliveryReconciliationManifestSchema = z.object({
+    kind: z.literal('rcl-historical-delivery-reconciliation'),
+    version: z.literal(1),
+    operationId: uuid,
+    createdAt: z.string().datetime({ offset: true }),
+    gitCommonDir: z.string().min(1),
+    target: z.string().min(1),
+    runId: uuid,
+    nativeStateSha256: digest,
+    attemptStateSha256: digest,
+    sourceStaleManifestSha256s: z.array(digest).min(1).max(100).refine(values => new Set(values).size === values.length && isDeepStrictEqual(values, [...values].sort()), 'Historical stale manifest digests must be unique and sorted'),
+    successor: z.object({
+        runId: uuid,
+        attempt: z.number().int().positive().safe(),
+        round: z.number().int().positive().safe(),
+        headSha: commit,
+        inputSha256: digest,
+    }).strict(),
+    reconciliation: strongDeliveryReconciliationSchema,
+    baseSha: commit,
+    diffSha256: digest,
+    reviewerHealth: reviewerHealthSchema,
+    server: historicalServerProjectionSchema,
+    serverProjectionSha256: digest,
+}).strict();
+export const historicalDeliveryReconciliationReceiptSchema = z.object({
+    kind: z.literal('rcl-historical-delivery-reconciliation-receipt'),
+    version: z.literal(1),
+    operationId: uuid,
+    runId: uuid,
+    manifestSha256: digest,
+    beforeStateSha256: digest,
+    afterStateSha256: digest,
+    attemptStateSha256: digest,
+    sourceStaleManifestSha256s: z.array(digest).min(1).max(100),
+    serverProjectionSha256: digest,
+}).strict();
+const historicalDeliveryReconciliationEntrySchema = z.object({
+    manifestJson: z.string().max(128 * 1024), manifestSha256: digest,
+}).strict();
+export function historicalDeliveryManifest(entry) {
+    const parsedEntry = historicalDeliveryReconciliationEntrySchema.parse(entry);
+    if (sha256(parsedEntry.manifestJson) !== parsedEntry.manifestSha256)
+        throw new Error('historical_delivery_reconciliation_manifest_digest_mismatch');
+    const manifest = historicalDeliveryReconciliationManifestSchema.parse(decodeRecoveryDocument(parsedEntry.manifestJson));
+    if (parsedEntry.manifestJson !== serializeRecoveryDocument(manifest)) {
+        throw new Error('historical_delivery_reconciliation_manifest_noncanonical');
+    }
+    return manifest;
+}
+export function validateHistoricalDeliveryReconciliationAudit(value) {
+    const audit = value.historicalDeliveryReconciliationAudit;
+    if (audit === undefined) {
+        if (value.historicalDeliveryReconciliationAuditCount !== undefined) {
+            throw new Error('historical_delivery_reconciliation_audit_count_mismatch');
+        }
+        return;
+    }
+    if (!Array.isArray(audit) || audit.length === 0 || audit.length > 10_000 ||
+        value.historicalDeliveryReconciliationAuditCount !== audit.length) {
+        throw new Error('historical_delivery_reconciliation_audit_count_mismatch');
+    }
+    const operations = new Set();
+    const runs = new Set();
+    for (const entry of audit) {
+        const manifest = historicalDeliveryManifest(entry);
+        if (manifest.target !== value.target || operations.has(manifest.operationId) || runs.has(manifest.runId)) {
+            throw new Error('historical_delivery_reconciliation_audit_duplicate');
+        }
+        operations.add(manifest.operationId);
+        runs.add(manifest.runId);
+    }
+}
+//# sourceMappingURL=historical-delivery-reconciliation-schema.js.map

package/dist/converge/historical-delivery-reconciliation-schema.js.map

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

package/dist/converge/historical-delivery-reconciliation.d.ts

@@ -0,0 +1,15 @@
+import { type HistoricalDeliveryReconciliationManifest } from './historical-delivery-reconciliation-schema.js';
+import { type ConvergeRunState } from './run-state.js';
+import { getRun } from '../evidence/reads.js';
+import type { HarnessSink } from '../telemetry/sink.js';
+interface HistoricalReconciliationOptions {
+    getRun?: typeof getRun;
+    now?: () => Date;
+}
+/** Print-only qualification; callers may write the returned reviewed manifest separately. */
+export declare function previewHistoricalDeliveryReconciliation(input: unknown, gitCommonDir: string, sink: HarnessSink, options?: HistoricalReconciliationOptions): Promise<HistoricalDeliveryReconciliationManifest>;
+/** Reverify every authority source under the target lock, then append one local receipt atomically. */
+export declare function applyHistoricalDeliveryReconciliation(input: unknown, gitCommonDir: string, sink: HarnessSink, options?: HistoricalReconciliationOptions): Promise<'applied' | 'unchanged'>;
+/** Local fail-closed verification used before claims and report admission. */
+export declare function verifyHistoricalDeliveryReconciliations(common: string, state: ConvergeRunState): Promise<void>;
+export {};

package/dist/converge/historical-delivery-reconciliation.js

@@ -0,0 +1,326 @@
+import { randomUUID } from 'node:crypto';
+import { realpath } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { z } from 'zod';
+import { convergeAttemptStatePath, validateConvergeAttemptState } from './attempt-budget.js';
+import { assertNoPendingFreshReview } from './fresh-review.js';
+import { historicalDeliveryManifest, historicalDeliveryReconciliationManifestSchema, historicalDeliveryReconciliationReceiptSchema, historicalServerProjectionSchema, validateHistoricalDeliveryReconciliationAudit, } from './historical-delivery-reconciliation-schema.js';
+import { strongDeliveryReconciliationSchema } from './launch-record.js';
+import { convergeRunStatePath, loadConvergeRunStateEvidence, writeState, } from './run-state.js';
+import { inspectVerifiedStaleReportReceipts } from './stale-report.js';
+import { readStaleObject, retainStaleFile as retain, selectedStaleFile as selected } from './stale-report-storage.js';
+import { assertDeadOwner } from './terminal-rejection.js';
+import { withRecoveryTarget } from './target-ownership.js';
+import { getRun } from '../evidence/reads.js';
+import { decodeRecoveryDocument } from '../evidence/original-run/decode.js';
+import { serializeRecoveryDocument, syncDirectory } from '../evidence/original-run/journal.js';
+import { inspectRecoveryDirectory, prepareLockRoot } from '../evidence/original-run/lock-path.js';
+import { normalizeUrl } from '../telemetry/credentials.js';
+import { readStable, sha256 } from '../telemetry/recovery/files.js';
+const digest = z.string().regex(/^[a-f0-9]{64}$/);
+const selectionSchema = z.object({
+    target: z.string().min(1).max(200).refine(value => value.trim() === value),
+    runId: z.string().uuid(),
+}).strict();
+const applySchema = z.object({ manifest: z.string().min(1), manifestSha256: digest }).strict();
+function fail(code) { throw new Error(`historical_delivery_reconciliation_${code}`); }
+function endpoint(value) {
+    const normalized = normalizeUrl(value);
+    if (!normalized)
+        fail('origin_invalid');
+    return normalized;
+}
+function selectedServerProjection(sink, detail, local) {
+    const cycle = local.state.cycle;
+    if (!cycle || endpoint(sink.baseUrl) !== endpoint(cycle.url))
+        fail('server_origin_mismatch');
+    const reports = detail.artifacts?.filter(artifact => artifact.kind === 'report_json') ?? [];
+    const report = reports[0];
+    if (detail.id.toLowerCase() !== local.runId.toLowerCase() || detail.provenance !== 'live' ||
+        detail.repo_verified !== true || detail.is_cross_repository !== false ||
+        typeof detail.head_verified !== 'string' || detail.head_verified.length === 0 ||
+        detail.cycle_id !== cycle.id || reports.length !== 1 || !report ||
+        report.stored !== true || report.declared_sha256 !== local.reportSha256 ||
+        report.declared_bytes !== local.reportBytes || detail.target.kind !== local.targetKind ||
+        detail.target.repo?.toLowerCase() !== cycle.repo.toLowerCase() || detail.target.pr_number !== cycle.prNumber ||
+        detail.target.head_sha !== local.headSha || detail.target.base_sha !== local.baseSha ||
+        detail.target.diff_sha256 !== local.diffSha256 ||
+        detail.converge?.target !== local.target || detail.converge.attempt !== local.attempt ||
+        detail.converge.round !== local.round || typeof detail.received_at !== 'string') {
+        fail('server_binding_mismatch');
+    }
+    const parsed = z.string().datetime({ offset: true }).safeParse(detail.received_at);
+    if (!parsed.success)
+        fail('server_binding_mismatch');
+    return historicalServerProjectionSchema.parse({
+        origin: endpoint(sink.baseUrl), runId: detail.id, provenance: 'live', receivedAt: detail.received_at,
+        cycleId: cycle.id, repoVerified: true, isCrossRepository: false,
+        headVerified: detail.head_verified,
+        target: { kind: detail.target.kind, repo: detail.target.repo, prNumber: detail.target.pr_number,
+            headSha: detail.target.head_sha, baseSha: detail.target.base_sha, diffSha256: detail.target.diff_sha256 },
+        converge: { target: detail.converge.target, attempt: detail.converge.attempt, round: detail.converge.round },
+        report: { declaredSha256: report.declared_sha256, declaredBytes: report.declared_bytes, stored: true },
+    });
+}
+async function readServerProjection(sink, local, options) {
+    const outcome = await (options.getRun ?? getRun)(sink, local.runId, { requireCompleteRead: true });
+    if (outcome.kind !== 'ok')
+        fail(`server_${outcome.kind}`);
+    return selectedServerProjection(sink, outcome.value, local);
+}
+function commonPredecessor(proofs, target, runId) {
+    const matches = proofs.filter((proof) => proof.m.version === 2 &&
+        proof.m.outcome === 'delivered-hard-failure' && proof.m.target === target &&
+        proof.m.runId.toLowerCase() === runId.toLowerCase());
+    if (matches.length === 0)
+        fail('predecessor_not_found');
+    const first = matches[0];
+    const launch = first.previous;
+    const marker = launch.deliveryReconciliation;
+    if (marker?.version !== 1 || launch.status !== 'completed' || launch.hardFailure !== true ||
+        launch.deliveryPending !== false || launch.exitCode !== 4 || !launch.reviewerHealth ||
+        launch.runId !== runId || launch.reportJsonSha256 !== first.m.reportSha256 ||
+        first.m.deliveryReconciliation.version !== 1 || !isDeepStrictEqual(first.m.deliveryReconciliation, marker)) {
+        fail('predecessor_ineligible');
+    }
+    const binding = {
+        target: first.m.target, runId: first.m.runId, reportSha256: first.m.reportSha256,
+        headSha: first.m.previousHeadSha, inputSha256: first.m.previousInputSha256,
+        attempt: first.m.attempt, round: first.m.round, cycleId: first.m.cycleId,
+        marker: first.m.deliveryReconciliation, reviewerHealth: first.m.reviewerHealth,
+        launch, evidence: first.evidence,
+    };
+    for (const proof of matches.slice(1)) {
+        const candidate = {
+            target: proof.m.target, runId: proof.m.runId, reportSha256: proof.m.reportSha256,
+            headSha: proof.m.previousHeadSha, inputSha256: proof.m.previousInputSha256,
+            attempt: proof.m.attempt, round: proof.m.round, cycleId: proof.m.cycleId,
+            marker: proof.m.deliveryReconciliation, reviewerHealth: proof.m.reviewerHealth,
+            launch: proof.previous, evidence: proof.evidence,
+        };
+        if (!isDeepStrictEqual(candidate, binding))
+            fail('predecessor_ambiguous');
+    }
+    return { binding, sourceDigests: matches.map(proof => proof.entry.manifestSha256).sort() };
+}
+async function deriveLocalAuthority(common, target, runId, state, nativeSha256, attemptFile, requireDeadOwner) {
+    validateHistoricalDeliveryReconciliationAudit(state);
+    if (!state.cycle)
+        fail('cycle_missing');
+    const attemptsPath = convergeAttemptStatePath(common, target);
+    const attempts = validateConvergeAttemptState(decodeRecoveryDocument(attemptFile.text), target, attemptsPath);
+    if (!isDeepStrictEqual(attempts.cycle, state.cycle))
+        fail('cycle_mismatch');
+    const proofs = await inspectVerifiedStaleReportReceipts(common, state.staleReportAudit ?? []);
+    const { binding, sourceDigests } = commonPredecessor(proofs, target, runId);
+    if (binding.cycleId !== state.cycle.id || !isDeepStrictEqual(binding.evidence.attempts.cycle, state.cycle)) {
+        fail('cycle_mismatch');
+    }
+    const claim = attempts.attempts.find(record => record.attempt === binding.attempt && record.source === 'claim');
+    if (!claim || claim.pid !== binding.launch.pid || binding.launch.pid !== binding.evidence.attempts.attempts
+        .find(record => record.attempt === binding.attempt && record.source === 'claim')?.pid)
+        fail('attempt_mismatch');
+    if (requireDeadOwner)
+        assertDeadOwner(binding.launch.pid);
+    const reportTarget = binding.evidence.report.run.target;
+    if (!['pr', 'patch'].includes(reportTarget.kind))
+        fail('retained_report_target_kind_mismatch');
+    if (reportTarget.repo?.toLowerCase() !== state.cycle.repo.toLowerCase())
+        fail('retained_report_repository_mismatch');
+    if (reportTarget.pr_number !== state.cycle.prNumber)
+        fail('retained_report_pull_request_mismatch');
+    if (reportTarget.head_sha !== binding.headSha)
+        fail('retained_report_head_mismatch');
+    if (!/^[a-f0-9]{40}$/.test(reportTarget.base_sha ?? ''))
+        fail('retained_report_base_missing');
+    if (!/^[a-f0-9]{64}$/.test(reportTarget.diff_sha256 ?? ''))
+        fail('retained_report_diff_missing');
+    const retainedReport = await readStaleObject(common, binding.reportSha256);
+    const successor = state.lastLaunch;
+    if (!successor?.runId || successor.status !== 'completed' || successor.attempt <= binding.attempt ||
+        successor.runId === binding.runId)
+        fail('successor_missing');
+    const successorClaim = attempts.attempts.find(record => record.attempt === successor.attempt && record.source === 'claim');
+    if (attempts.attemptsUsed !== successor.attempt || !successorClaim || successorClaim.pid !== successor.pid) {
+        fail('successor_attempt_mismatch');
+    }
+    const reconciliation = strongDeliveryReconciliationSchema.parse({ version: 2, runId: binding.runId,
+        reportJsonSha256: binding.reportSha256, headSha: binding.headSha, inputSha256: binding.inputSha256,
+        attempt: binding.attempt, round: binding.round, claimPid: binding.launch.pid, cycleId: state.cycle.id,
+        reconciledAt: '1970-01-01T00:00:00.000Z' });
+    return { common, target, runId, state, nativeSha256, attempts, attemptFile, attemptSha256: attemptFile.sha256,
+        sourceDigests, headSha: binding.headSha, reportSha256: binding.reportSha256, attempt: binding.attempt,
+        round: binding.round, reviewerHealth: binding.reviewerHealth, reconciliation,
+        targetKind: reportTarget.kind, baseSha: reportTarget.base_sha,
+        diffSha256: reportTarget.diff_sha256, reportBytes: retainedReport.raw.byteLength,
+        successor: { runId: successor.runId, attempt: successor.attempt, round: successor.round,
+            headSha: successor.headSha, inputSha256: successor.inputSha256 } };
+}
+async function localAuthority(common, target, runId) {
+    await assertNoPendingFreshReview(common, target);
+    const native = await loadConvergeRunStateEvidence(common, target);
+    if (!native)
+        fail('state_missing');
+    if (native.state.historicalDeliveryReconciliationAudit?.some(entry => historicalDeliveryManifest(entry).runId === runId))
+        fail('already_applied');
+    const attemptFile = await readStable(convergeAttemptStatePath(common, target));
+    return deriveLocalAuthority(common, target, runId, native.state, native.sha256, attemptFile, true);
+}
+function assertServerBinding(local, server) {
+    const cycle = local.state.cycle;
+    if (!cycle || server.origin !== endpoint(cycle.url) || server.runId.toLowerCase() !== local.runId.toLowerCase() ||
+        server.cycleId !== cycle.id || server.target.kind !== local.targetKind ||
+        server.target.repo.toLowerCase() !== cycle.repo.toLowerCase() || server.target.prNumber !== cycle.prNumber ||
+        server.target.headSha !== local.headSha || server.target.baseSha !== local.baseSha ||
+        server.target.diffSha256 !== local.diffSha256 || server.converge.target !== local.target ||
+        server.converge.attempt !== local.attempt || server.converge.round !== local.round ||
+        server.report.declaredSha256 !== local.reportSha256 || server.report.declaredBytes !== local.reportBytes) {
+        fail('retained_server_binding_mismatch');
+    }
+}
+function buildManifest(local, server, operationId, createdAt) {
+    assertServerBinding(local, server);
+    return historicalDeliveryReconciliationManifestSchema.parse({
+        kind: 'rcl-historical-delivery-reconciliation', version: 1, operationId, createdAt,
+        gitCommonDir: local.common, target: local.target, runId: local.runId,
+        nativeStateSha256: local.nativeSha256, attemptStateSha256: local.attemptSha256,
+        sourceStaleManifestSha256s: local.sourceDigests, successor: local.successor,
+        reconciliation: { ...local.reconciliation, reconciledAt: createdAt },
+        baseSha: server.target.baseSha, diffSha256: server.target.diffSha256,
+        reviewerHealth: local.reviewerHealth, server,
+        serverProjectionSha256: sha256(Buffer.from(serializeRecoveryDocument(server))),
+    });
+}
+/** Print-only qualification; callers may write the returned reviewed manifest separately. */
+export async function previewHistoricalDeliveryReconciliation(input, gitCommonDir, sink, options = {}) {
+    const selection = selectionSchema.parse(input);
+    const common = await realpath(resolve(gitCommonDir));
+    const local = await localAuthority(common, selection.target, selection.runId);
+    const server = await readServerProjection(sink, local, options);
+    return buildManifest(local, server, randomUUID(), (options.now ?? (() => new Date()))().toISOString());
+}
+function nextState(before, entry, at) {
+    const { staleReportAudit, staleReportAuditCount, historicalDeliveryReconciliationAudit: audit = [], historicalDeliveryReconciliationAuditCount: _historicalCount, updatedAt: _updatedAt, ...rest } = before;
+    return {
+        ...(staleReportAudit ? { staleReportAudit } : {}), ...rest,
+        historicalDeliveryReconciliationAudit: [...audit, entry],
+        historicalDeliveryReconciliationAuditCount: audit.length + 1,
+        ...(staleReportAuditCount !== undefined ? { staleReportAuditCount } : {}), updatedAt: at,
+    };
+}
+function directory(common, manifest) {
+    return join(common, 'rcl-historical-delivery-reconciliations', manifest.operationId);
+}
+function receiptFor(manifest, manifestSha256, afterStateSha256) {
+    return historicalDeliveryReconciliationReceiptSchema.parse({
+        kind: 'rcl-historical-delivery-reconciliation-receipt', version: 1,
+        operationId: manifest.operationId, runId: manifest.runId, manifestSha256,
+        beforeStateSha256: manifest.nativeStateSha256, afterStateSha256,
+        attemptStateSha256: manifest.attemptStateSha256,
+        sourceStaleManifestSha256s: manifest.sourceStaleManifestSha256s,
+        serverProjectionSha256: manifest.serverProjectionSha256,
+    });
+}
+/** Reverify every authority source under the target lock, then append one local receipt atomically. */
+export async function applyHistoricalDeliveryReconciliation(input, gitCommonDir, sink, options = {}) {
+    const pinned = applySchema.parse(input);
+    const selectedManifest = await readStable(pinned.manifest, 128 * 1024);
+    if (selectedManifest.sha256 !== pinned.manifestSha256)
+        fail('manifest_digest_mismatch');
+    const manifest = historicalDeliveryReconciliationManifestSchema.parse(decodeRecoveryDocument(selectedManifest.text));
+    if (selectedManifest.text !== serializeRecoveryDocument(manifest))
+        fail('manifest_noncanonical');
+    const common = await realpath(resolve(gitCommonDir));
+    if (manifest.gitCommonDir !== common)
+        fail('repository_mismatch');
+    return withRecoveryTarget(common, manifest.target, async (ownership) => {
+        const currentFile = await readStable(convergeRunStatePath(common, manifest.target));
+        const current = await loadConvergeRunStateEvidence(common, manifest.target);
+        if (!current || current.sha256 !== currentFile.sha256)
+            fail('state_missing');
+        validateHistoricalDeliveryReconciliationAudit(current.state);
+        await verifyHistoricalDeliveryReconciliations(common, current.state);
+        const entry = {
+            manifestJson: selectedManifest.text, manifestSha256: selectedManifest.sha256,
+        };
+        const prior = current.state.historicalDeliveryReconciliationAudit?.find(entry => historicalDeliveryManifest(entry).runId === manifest.runId);
+        if (prior) {
+            if (!isDeepStrictEqual(prior, entry))
+                fail('operation_conflict');
+            return 'unchanged';
+        }
+        await assertNoPendingFreshReview(common, manifest.target);
+        if (current.sha256 !== manifest.nativeStateSha256)
+            fail('state_changed');
+        const attemptFile = await readStable(convergeAttemptStatePath(common, manifest.target));
+        const local = await deriveLocalAuthority(common, manifest.target, manifest.runId, current.state, current.sha256, attemptFile, true);
+        const server = await readServerProjection(sink, local, options);
+        assertServerBinding(local, server);
+        const expected = buildManifest(local, server, manifest.operationId, manifest.createdAt);
+        if (!isDeepStrictEqual(expected, manifest))
+            fail('manifest_binding_mismatch');
+        const next = nextState(current.state, entry, manifest.createdAt);
+        validateHistoricalDeliveryReconciliationAudit(next);
+        const afterBytes = Buffer.from(serializeRecoveryDocument(next));
+        const serverBytes = Buffer.from(serializeRecoveryDocument(server));
+        if (sha256(serverBytes) !== manifest.serverProjectionSha256)
+            fail('server_projection_digest_mismatch');
+        const receipt = receiptFor(manifest, selectedManifest.sha256, sha256(afterBytes));
+        const dir = directory(common, manifest);
+        await prepareLockRoot(dirname(dir));
+        await syncDirectory(common);
+        await prepareLockRoot(dir);
+        await syncDirectory(dirname(dir));
+        await retain(join(dir, 'manifest.json'), selectedManifest.raw);
+        await retain(join(dir, 'native-before.json'), currentFile.raw);
+        await retain(join(dir, 'attempts-before.json'), attemptFile.raw);
+        await retain(join(dir, 'server-projection.json'), serverBytes);
+        await retain(join(dir, 'complete.json'), Buffer.from(serializeRecoveryDocument(receipt)));
+        const finalState = await selected(convergeRunStatePath(common, manifest.target), manifest.nativeStateSha256);
+        const finalAttempts = await selected(convergeAttemptStatePath(common, manifest.target), manifest.attemptStateSha256);
+        const finalLocal = await deriveLocalAuthority(common, manifest.target, manifest.runId, decodeRecoveryDocument(finalState.text), finalState.sha256, finalAttempts, true);
+        const finalServer = await readServerProjection(sink, finalLocal, options);
+        assertServerBinding(finalLocal, finalServer);
+        if (!isDeepStrictEqual(buildManifest(finalLocal, finalServer, manifest.operationId, manifest.createdAt), manifest)) {
+            fail('manifest_binding_mismatch');
+        }
+        await verifyHistoricalDeliveryReconciliations(common, next);
+        await writeState(common, next, ownership);
+        await selected(convergeRunStatePath(common, manifest.target), sha256(afterBytes));
+        return 'applied';
+    });
+}
+/** Local fail-closed verification used before claims and report admission. */
+export async function verifyHistoricalDeliveryReconciliations(common, state) {
+    validateHistoricalDeliveryReconciliationAudit(state);
+    const audit = state.historicalDeliveryReconciliationAudit ?? [];
+    if (audit.length === 0)
+        return;
+    const root = join(common, 'rcl-historical-delivery-reconciliations');
+    await inspectRecoveryDirectory(root, true);
+    const prefix = [];
+    for (const entry of audit) {
+        const manifest = historicalDeliveryManifest(entry);
+        const dir = directory(common, manifest);
+        await inspectRecoveryDirectory(dir, true);
+        await selected(join(dir, 'manifest.json'), entry.manifestSha256);
+        const beforeFile = await selected(join(dir, 'native-before.json'), manifest.nativeStateSha256);
+        const before = decodeRecoveryDocument(beforeFile.text);
+        if (!isDeepStrictEqual(before.historicalDeliveryReconciliationAudit ?? [], prefix))
+            fail('audit_prefix');
+        const attemptFile = await selected(join(dir, 'attempts-before.json'), manifest.attemptStateSha256);
+        const serverFile = await selected(join(dir, 'server-projection.json'), manifest.serverProjectionSha256);
+        const server = historicalServerProjectionSchema.parse(decodeRecoveryDocument(serverFile.text));
+        const local = await deriveLocalAuthority(common, manifest.target, manifest.runId, before, beforeFile.sha256, attemptFile, false);
+        assertServerBinding(local, server);
+        if (!isDeepStrictEqual(buildManifest(local, server, manifest.operationId, manifest.createdAt), manifest)) {
+            fail('retained_source_mismatch');
+        }
+        const after = Buffer.from(serializeRecoveryDocument(nextState(before, entry, manifest.createdAt)));
+        const receipt = receiptFor(manifest, entry.manifestSha256, sha256(after));
+        await selected(join(dir, 'complete.json'), sha256(Buffer.from(serializeRecoveryDocument(receipt))));
+        prefix.push(entry);
+    }
+}
+//# sourceMappingURL=historical-delivery-reconciliation.js.map

package/dist/converge/historical-delivery-reconciliation.js.map

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

package/dist/converge/launch-guard.js

@@ -19,6 +19,8 @@ import { scrubText } from '../telemetry/scrub.js';
 import { verifyBoundFixRecovery } from './bound-fix-recovery.js';
 import { boundFixRecoverySourceSchema } from './bound-fix-recovery-source.js';
 import { createOriginalLaunch, encodeOriginalLaunch, remainingOriginalBudget } from '../dispatch/original-launch.js';
+import { verifyCyclePendingFinalization } from './pending-finalization-receipt.js';
+import { captureCurrentProcessIdentity } from './process-identity.js';
 export class ReviewLaunchRefused extends Error {
     code;
     constructor(code, message) {
@@ -120,6 +122,18 @@ async function requireLaunch(options, state, attemptsUsed) {
         return { round };
     }
     if (previous.status !== 'completed') {
+        if (state.cycle && ((previous.status === 'pending' && !previous.runId) || previous.pendingRecovery)) {
+            if (!await verifyCyclePendingFinalization(options.gitCommonDir, state, previous)) {
+                refuse('cycle_pending_recovery_required', 'The previous cycle dispatch is not terminal. Authenticate and finalize its pending recovery before launching a successor.');
+            }
+            if (previous.headSha === options.headSha && previous.inputSha256 === options.inputSha256) {
+                refuse('cycle_pending_inputs_unchanged', 'The recovered dispatch remains unknown; its successor must use materially changed exact review inputs.');
+            }
+            if (!options.retryReason) {
+                refuse('dispatch_unknown', 'The recovered dispatch remains spent; supply a bounded retry reason for its successor.');
+            }
+            return { round };
+        }
         if (!options.retryReason)
             refuse('dispatch_unknown', 'Previous dispatch is unknown; no automatic retry. Supply a bounded retry reason only after recovery.');
         return { round };
@@ -280,6 +294,9 @@ async function guardReviewLaunchOwned(options, ownership) {
     else {
         await assertNoPendingFreshReview(options.gitCommonDir, options.target);
     }
+    const processIdentity = process.platform === 'linux' || process.platform === 'darwin' || process.platform === 'win32'
+        ? await captureCurrentProcessIdentity()
+        : undefined;
     const claim = await claimConvergeAttempt({
         gitCommonDir: options.gitCommonDir,
         target: options.target,
@@ -290,6 +307,8 @@ async function guardReviewLaunchOwned(options, ownership) {
             try {
                 state = await loadConvergeRunState(options.gitCommonDir, options.target) ?? initialConvergeRunState(options.target);
                 await verifyStaleReportReceipts(options.gitCommonDir, state.staleReportAudit ?? []);
+                const { verifyHistoricalDeliveryReconciliations } = await import('./historical-delivery-reconciliation.js');
+                await verifyHistoricalDeliveryReconciliations(options.gitCommonDir, state);
                 await verifyTerminalRejections(options.gitCommonDir, state);
             }
             catch (error) {
@@ -331,13 +350,12 @@ async function guardReviewLaunchOwned(options, ownership) {
                 await options.originalLaunch.beforeClaim(preparedOriginal, ownership);
                 assertOriginalLive();
             }
-            // Pending-package export covers ordinary launches only. Special launch
-            // modes keep their own recovery contract and must not inherit this
-            // capture's size or storage requirements.
-            const ordinaryLaunch = !options.startOver && !state.cycle && !options.originalLaunch &&
-                !options.legacyRetry && !options.boundFixRecovery;
+            // Retain normal dispatch inputs, including cycle-backed launches. Bound
+            // original/retry recovery modes keep their own immutable input contract.
+            const ordinaryLaunch = !options.originalLaunch && !options.legacyRetry && !options.boundFixRecovery;
             const retained = ordinaryLaunch ? await options.beforeClaim?.(Object.freeze({ target: options.target, round,
-                attempt: (attempts?.attemptsUsed ?? 0) + 1 }), ownership) : undefined;
+                attempt: (attempts?.attemptsUsed ?? 0) + 1,
+                ...(state.cycle ? { cycleId: state.cycle.id } : {}) }), ownership) : undefined;
             const ordinaryInputs = retained === undefined ? undefined : ordinaryLaunchInputsBindingSchema.parse(retained.ordinaryInputs);
             if (retryProof)
                 await retainLegacyRetry(options.gitCommonDir, retryProof);
@@ -346,6 +364,7 @@ async function guardReviewLaunchOwned(options, ownership) {
                 status: 'pending', attempt: (attempts?.attemptsUsed ?? 0) + 1, round,
                 headSha: options.headSha, inputSha256: options.inputSha256,
                 startedAt: new Date().toISOString(), pid: process.pid,
+                ...(processIdentity ? { processIdentity } : {}),
                 ...(ordinaryInputs ? { ordinaryInputs } : {}),
                 ...(preparedOriginal ? { retainedOriginal: { version: 1, runId: preparedOriginal.launch.runId,
                         planDigest: preparedOriginal.launch.planDigest, capturedInputsSha256: preparedOriginal.launch.capturedInputsSha256 } } : {}),