@allocator-one/rcl 4.5.2 → 4.5.4

package/README.md

@@ -437,11 +437,30 @@ commands are documented in
 | --- | --- |
 | `rcl converge-report` | Dedupe a round report against earlier rounds, enforce the round cap, classify findings (`new` / `repeat` / `suppressed` / `regating`); refuses inconclusive reviewer health |
 | `rcl converge-verdict` | Record fixed/dismissed verdicts and report the round's resolution |
+| `rcl converge-reconcile-history` | Authenticate and append a reconciliation receipt for an exact historical guarded launch after `lastLaunch` advanced |
 | `rcl converge-stale` | Audited disposition of a healthy or reconciled delivered-hard-failure report that became stale before admission |
 | `rcl converge-gap` | Audited record of one evidenced missing terminal report |
 | `rcl converge-rejected` | Audited disposition of a report rejected locally before delivery |
 | `rcl converge-attempt` | Legacy attempt accounting; guarded launches claim their own attempts |
 
+Delivered hard-failure continuation requires RCL 4.5.3 or later. Re-run
+`rcl telemetry flush --run <run-id>` to authenticate or upgrade the durable
+reconciliation marker before previewing `converge-stale`. The strong marker is
+bound to the exact run, report, head, input digest, attempt, round, claim PID,
+cycle, reconciliation time and live repository/pull-request authority. New
+stale dispositions are version 3; published 4.5.2 version 2 receipts remain
+verifiable and can be
+followed by a changed-input version 3 disposition only after that exact marker
+upgrade.
+
+If a published version 1 marker belongs to a retained version 2 stale receipt
+but a later launch has already replaced `lastLaunch`, use
+`converge-reconcile-history`. Preview prints one reviewed manifest to stdout and
+its SHA-256 to stderr. Apply accepts only those pinned bytes, re-reads every
+local source and the complete live server projection under the target lock,
+and appends a historical audit receipt. It never admits findings, claims an
+attempt or calls a reviewer.
+
 ---
 
 ## Configuration

package/dist/converge/delivery-reconciliation.js

@@ -1,8 +1,8 @@
 import { resolveGitCommonDir } from './attempt-budget.js';
 import { loadConvergeRunState, writeState } from './run-state.js';
+import { strongDeliveryReconciliationSchema } from './launch-record.js';
 import { withNativeTarget } from './target-ownership.js';
 import { getRun } from '../evidence/reads.js';
-import { deliveryReconciliationSchema } from './launch-record.js';
 export function shouldReconcileDeliveredRun(runId, summary) {
     return runId !== undefined && summary.remaining.length === 0 && summary.failed.length === 0 && summary.dropped.length === 0;
 }
@@ -23,25 +23,38 @@ export async function reconcileDeliveredRun(runId, sink, options = {}) {
     return withNativeTarget(common, target, async (ownership) => {
         const state = await loadConvergeRunState(common, target), launch = state?.lastLaunch;
         const round = detail.converge?.round, attempt = detail.converge?.attempt, headSha = detail.target.head_sha;
+        const marker = launch?.deliveryReconciliation;
+        const markerlessLegacy = launch?.deliveryPending === false && launch.hardFailure === true &&
+            launch.exitCode === 4 && launch.deliveryReconciliation === undefined;
+        const weakMarker = marker?.version === 1 && launch?.hardFailure === true && launch.deliveryPending === false &&
+            launch.exitCode === 4 && marker.runId === launch.runId && marker.reportJsonSha256 === launch.reportJsonSha256 &&
+            marker.headSha === launch.headSha && marker.attempt === launch.attempt && marker.round === launch.round;
+        const needsStrongMarker = launch?.hardFailure === true &&
+            (launch.deliveryPending === true || markerlessLegacy || weakMarker);
         const reports = detail.artifacts?.filter(artifact => artifact.kind === 'report_json') ?? [];
-        if (!state || !launch || launch.status !== 'completed' || launch.deliveryReconciliation !== undefined ||
-            (launch.deliveryPending !== true && !(launch.deliveryPending === false && launch.hardFailure === true &&
-                launch.deliveryFailure !== 'local-invalid' && launch.exitCode === 4 &&
-                launch.deliveryReconciliation === undefined)) ||
+        const reconciledAt = new Date().toISOString();
+        const strongMarker = needsStrongMarker ? strongDeliveryReconciliationSchema.safeParse({ version: 2,
+            runId: launch.runId, reportJsonSha256: launch.reportJsonSha256, headSha: launch.headSha,
+            inputSha256: launch.inputSha256, attempt: launch.attempt, round: launch.round,
+            claimPid: launch.pid, cycleId: state?.cycle?.id ?? null, reconciledAt }) : undefined;
+        if (!state || !launch || launch.status !== 'completed' ||
+            (!launch.deliveryPending && !markerlessLegacy && !weakMarker) ||
+            (launch.deliveryReconciliation !== undefined && !weakMarker) || launch.deliveryFailure === 'local-invalid' ||
             typeof launch.runId !== 'string' || typeof launch.reportJsonSha256 !== 'string' ||
             !Number.isSafeInteger(launch.round) || !Number.isSafeInteger(launch.attempt) || typeof launch.headSha !== 'string' ||
             !Number.isSafeInteger(round) || !Number.isSafeInteger(attempt) || typeof headSha !== 'string' ||
             launch.runId.toLowerCase() !== runId.toLowerCase() ||
             round !== launch.round || attempt !== launch.attempt || headSha !== launch.headSha ||
             reports.length !== 1 || reports[0].stored !== true ||
-            typeof reports[0].declared_sha256 !== 'string' ||
-            reports[0].declared_sha256 !== launch.reportJsonSha256)
+            reports[0].declared_sha256 !== launch.reportJsonSha256 ||
+            (strongMarker && (!strongMarker.success || detail.provenance !== 'live' ||
+                (detail.cycle_id ?? null) !== (state.cycle?.id ?? null) ||
+                (state.cycle !== undefined && (detail.target.repo?.toLowerCase() !== state.cycle.repo.toLowerCase() ||
+                    detail.target.pr_number !== state.cycle.prNumber)))))
             return 'unchanged';
-        const deliveryReconciliation = deliveryReconciliationSchema.parse({ version: 1, runId: launch.runId,
-            reportJsonSha256: launch.reportJsonSha256, round: launch.round, attempt: launch.attempt,
-            headSha: launch.headSha });
-        state.lastLaunch = { ...launch, deliveryPending: false, deliveryReconciliation };
-        state.updatedAt = new Date().toISOString();
+        state.lastLaunch = { ...launch, deliveryPending: false,
+            ...(strongMarker?.success ? { deliveryReconciliation: strongMarker.data } : {}) };
+        state.updatedAt = reconciledAt;
         await writeState(common, state, ownership);
         return 'reconciled';
     });

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

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

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

@@ -0,0 +1,131 @@
+import { z } from 'zod';
+export declare const historicalServerProjectionSchema: z.ZodObject<{
+    origin: z.ZodString;
+    runId: z.ZodString;
+    provenance: z.ZodLiteral<"live">;
+    receivedAt: z.ZodString;
+    cycleId: z.ZodString;
+    repoVerified: z.ZodLiteral<true>;
+    isCrossRepository: z.ZodLiteral<false>;
+    headVerified: z.ZodString;
+    target: z.ZodObject<{
+        kind: z.ZodEnum<{
+            patch: "patch";
+            pr: "pr";
+        }>;
+        repo: z.ZodString;
+        prNumber: z.ZodNumber;
+        headSha: z.ZodString;
+        baseSha: z.ZodString;
+        diffSha256: z.ZodString;
+    }, z.core.$strict>;
+    converge: z.ZodObject<{
+        target: z.ZodString;
+        attempt: z.ZodNumber;
+        round: z.ZodNumber;
+    }, z.core.$strict>;
+    report: z.ZodObject<{
+        declaredSha256: z.ZodString;
+        declaredBytes: z.ZodNumber;
+        stored: z.ZodLiteral<true>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const historicalDeliveryReconciliationManifestSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"rcl-historical-delivery-reconciliation">;
+    version: z.ZodLiteral<1>;
+    operationId: z.ZodString;
+    createdAt: z.ZodString;
+    gitCommonDir: z.ZodString;
+    target: z.ZodString;
+    runId: z.ZodString;
+    nativeStateSha256: z.ZodString;
+    attemptStateSha256: z.ZodString;
+    sourceStaleManifestSha256s: z.ZodArray<z.ZodString>;
+    successor: z.ZodObject<{
+        runId: z.ZodString;
+        attempt: z.ZodNumber;
+        round: z.ZodNumber;
+        headSha: z.ZodString;
+        inputSha256: z.ZodString;
+    }, z.core.$strict>;
+    reconciliation: z.ZodObject<{
+        version: z.ZodLiteral<2>;
+        runId: z.ZodString;
+        reportJsonSha256: z.ZodString;
+        headSha: z.ZodString;
+        inputSha256: z.ZodString;
+        attempt: z.ZodNumber;
+        round: z.ZodNumber;
+        claimPid: z.ZodNumber;
+        cycleId: z.ZodNullable<z.ZodString>;
+        reconciledAt: z.ZodString;
+    }, z.core.$strict>;
+    baseSha: z.ZodString;
+    diffSha256: z.ZodString;
+    reviewerHealth: z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        policy: z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            fraction: z.ZodNumber;
+            seatCount: z.ZodNumber;
+            minimumSuccessful: z.ZodNumber;
+        }, z.core.$strict>;
+        successfulSeats: z.ZodNumber;
+    }, z.core.$strict>;
+    server: z.ZodObject<{
+        origin: z.ZodString;
+        runId: z.ZodString;
+        provenance: z.ZodLiteral<"live">;
+        receivedAt: z.ZodString;
+        cycleId: z.ZodString;
+        repoVerified: z.ZodLiteral<true>;
+        isCrossRepository: z.ZodLiteral<false>;
+        headVerified: z.ZodString;
+        target: z.ZodObject<{
+            kind: z.ZodEnum<{
+                patch: "patch";
+                pr: "pr";
+            }>;
+            repo: z.ZodString;
+            prNumber: z.ZodNumber;
+            headSha: z.ZodString;
+            baseSha: z.ZodString;
+            diffSha256: z.ZodString;
+        }, z.core.$strict>;
+        converge: z.ZodObject<{
+            target: z.ZodString;
+            attempt: z.ZodNumber;
+            round: z.ZodNumber;
+        }, z.core.$strict>;
+        report: z.ZodObject<{
+            declaredSha256: z.ZodString;
+            declaredBytes: z.ZodNumber;
+            stored: z.ZodLiteral<true>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    serverProjectionSha256: z.ZodString;
+}, z.core.$strict>;
+export type HistoricalDeliveryReconciliationManifest = z.infer<typeof historicalDeliveryReconciliationManifestSchema>;
+export declare const historicalDeliveryReconciliationReceiptSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"rcl-historical-delivery-reconciliation-receipt">;
+    version: z.ZodLiteral<1>;
+    operationId: z.ZodString;
+    runId: z.ZodString;
+    manifestSha256: z.ZodString;
+    beforeStateSha256: z.ZodString;
+    afterStateSha256: z.ZodString;
+    attemptStateSha256: z.ZodString;
+    sourceStaleManifestSha256s: z.ZodArray<z.ZodString>;
+    serverProjectionSha256: z.ZodString;
+}, z.core.$strict>;
+export type HistoricalDeliveryReconciliationReceipt = z.infer<typeof historicalDeliveryReconciliationReceiptSchema>;
+export interface HistoricalDeliveryReconciliationEntry {
+    manifestJson: string;
+    manifestSha256: string;
+}
+export declare function historicalDeliveryManifest(entry: HistoricalDeliveryReconciliationEntry): HistoricalDeliveryReconciliationManifest;
+export declare function validateHistoricalDeliveryReconciliationAudit(value: {
+    target?: string;
+    historicalDeliveryReconciliationAudit?: HistoricalDeliveryReconciliationEntry[];
+    historicalDeliveryReconciliationAuditCount?: number;
+}): void;

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 {};