@allocator-one/rcl 4.5.4 → 4.5.5

package/dist/converge/recovery-state.js

@@ -0,0 +1,306 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { constants } from 'node:fs';
+import { link, mkdir, open, realpath, rename, rm } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { claimHistoryContent, sameClaimHistoryEvidence } from '../evidence/claim-recovery/carrier-inventory.js';
+import { deriveCurrentClaimProjection } from '../evidence/claim-recovery/validation/current-projection.js';
+import { nativeMaterial, operationOccurrences, packNativeMaterial } from '../evidence/claim-recovery/validation/native-material.js';
+import { deriveNativeOccurrenceEvidence } from '../evidence/claim-recovery/validation/native-occurrences.js';
+import { validateRetainedNativeEvidence, effectivePendingIdentities, recoveryAnchors, validateNativeRecoveryOperationInput, verifyNativeRecoveryLineage, MAX_NATIVE_RECOVERY_SNAPSHOT_BYTES } from '../evidence/claim-recovery/validation/native-state.js';
+import { validateRecoveryMaterials } from '../evidence/claim-recovery/validation/materials.js';
+import { decodeRecoveryOriginal } from '../evidence/claim-recovery/validation/recovery-json.js';
+import { object } from '../evidence/claim-recovery/validation/primitives.js';
+import { inspectRecoveryDirectory } from '../evidence/original-run/lock-path.js';
+import { syncDirectory } from '../evidence/original-run/journal.js';
+import { readStable } from '../telemetry/recovery/files.js';
+import { assertRecoveryTargetOwnership, withOwnedNativeOperation } from './target-ownership.js';
+import { convergeRunStatePath, loadConvergeRunStateEvidence } from './run-state.js';
+const MAX_BYTES = 64 * 1024 * 1024;
+export { MAX_NATIVE_RECOVERY_SNAPSHOT_BYTES };
+const sha = (raw) => createHash('sha256').update(raw).digest('hex');
+const requireSource = (valid) => {
+    if (!valid)
+        throw new Error('native_recovery_source_conflict');
+};
+function mergeMaterials(first, second) {
+    const rows = new Map();
+    for (const row of [...first, ...second]) {
+        const old = rows.get(row.sha256);
+        requireSource(!old || old.text === row.text);
+        rows.set(row.sha256, row);
+    }
+    return [...rows.values()];
+}
+/** Pure exact-byte preview. Effectful authority is checked by applyNativeRecovery. */
+export function deriveNativeRecovery(input, projectionVersion = 2) {
+    try {
+        const source = verifyNativeRecoveryLineage(input.sourceJson, input.target, input.nativeSourceJsons).state;
+        validateNativeRecoveryOperationInput(input);
+        const priorOccurrences = source.recovery?.operations.flatMap(operation => {
+            const value = operationOccurrences(operation, input.recoveryMaterials ?? []);
+            return value ? [value] : [];
+        }) ?? [];
+        const occurrences = deriveNativeOccurrenceEvidence(input, {
+            target: input.target,
+            sourceJson: input.sourceJson,
+            nativeSourceJsons: input.nativeSourceJsons,
+            anchors: [...recoveryAnchors(source), ...input.anchors],
+            previous: priorOccurrences,
+        });
+        const currentProjection = input.currentHistory
+            ? deriveCurrentClaimProjection(source, [...recoveryAnchors(source), ...input.anchors], [...priorOccurrences, ...(occurrences ? [occurrences] : [])], input.currentHistory, input.nativeSourceJsons, input.sourceJson, projectionVersion)
+            : undefined;
+        requireSource(!currentProjection || input.externalMaterial);
+        const packed = input.externalMaterial && (occurrences || currentProjection)
+            ? packNativeMaterial({ ...(occurrences ? { occurrences } : {}), ...(currentProjection ? { currentProjection } : {}) })
+            : undefined;
+        const operation = {
+            operationId: input.operationId,
+            sourceVersion: source.version,
+            sourceSha256: sha(input.sourceJson),
+            anchors: structuredClone(input.anchors),
+            sourceReceipts: structuredClone(input.sourceReceipts),
+            ...(packed ? { material: packed.reference } : occurrences ? { occurrences } : {}),
+        };
+        const materials = packed
+            ? mergeMaterials(input.recoveryMaterials ?? [], packed.materials)
+            : structuredClone(input.recoveryMaterials ?? []);
+        const result = {
+            ...source,
+            version: 3,
+            sightings: source.sightings ?? [],
+            recovery: {
+                version: packed || source.recovery?.version === 2 ? 2 : 1,
+                operations: [...(source.recovery?.operations ?? []), operation],
+            },
+        };
+        const resultJson = `${JSON.stringify(result, null, 2)}\n`;
+        requireSource(Buffer.byteLength(resultJson) <= MAX_BYTES);
+        return {
+            ...structuredClone(input),
+            ...(packed ? { recoveryMaterials: materials } : {}),
+            sourceVersion: source.version,
+            sourceSha256: operation.sourceSha256,
+            resultJson,
+            resultSha256: sha(resultJson),
+            actionableIdentities: effectivePendingIdentities(result),
+        };
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.startsWith('native_recovery_'))
+            throw error;
+        throw new Error('native_recovery_source_conflict', { cause: error });
+    }
+}
+export function nativeRecoveryPlanProjectionVersion(plan) {
+    if (!plan.currentHistory)
+        return 2;
+    requireSource(sha(plan.resultJson) === plan.resultSha256);
+    const result = decodeState(plan.resultJson, plan.target);
+    const operation = result.recovery?.operations.at(-1);
+    requireSource(operation?.operationId === plan.operationId && operation.sourceSha256 === plan.sourceSha256 && operation.material);
+    const projection = nativeMaterial(operation.material, plan.recoveryMaterials ?? []).currentProjection;
+    requireSource(projection && isDeepStrictEqual(projection.history, plan.currentHistory));
+    return projection.version;
+}
+function materialPath(commonDir, target, digest) {
+    requireSource(/^[a-f0-9]{64}$/.test(digest));
+    return `${convergeRunStatePath(commonDir, target)}.recovery-materials/${digest}`;
+}
+function snapshotPath(commonDir, target, digest) {
+    requireSource(/^[a-f0-9]{64}$/.test(digest));
+    return `${convergeRunStatePath(commonDir, target)}.recovery-sources/${digest}.json`;
+}
+function reportPath(commonDir, target, digest) {
+    requireSource(/^[a-f0-9]{64}$/.test(digest));
+    return `${convergeRunStatePath(commonDir, target)}.evidence/${digest}.json`;
+}
+function decodeState(raw, target) {
+    const decoded = decodeRecoveryOriginal(raw, { exactNumbers: true });
+    requireSource(decoded.transformations.length === 0 && object(decoded.value));
+    const state = decoded.value;
+    requireSource([1, 2, 3].includes(state.version) && state.target === target && Array.isArray(state.rounds) && object(state.findings));
+    return state;
+}
+export async function readNativeRecoveryMaterials(commonDir, state) {
+    const ids = [...new Set(state.recovery?.operations.flatMap(operation => operation.material?.sha256s ?? []) ?? [])];
+    requireSource(ids.length <= 20_000);
+    const rows = [];
+    let remaining = MAX_BYTES;
+    for (const id of ids) {
+        const raw = await readStable(materialPath(commonDir, state.target, id), remaining);
+        requireSource(raw.sha256 === id);
+        remaining -= raw.raw.length;
+        requireSource(remaining >= 0);
+        rows.push({ sha256: id, text: raw.text });
+    }
+    validateRecoveryMaterials(rows);
+    return rows;
+}
+/** Read only canonical exact predecessors, with one aggregate pre-read budget. */
+export async function readNativeRecoverySourceJsons(commonDir, state) {
+    const snapshots = [];
+    const seen = new Set();
+    const maximum = (state.recovery?.operations.length ?? 0) + (state.migration ? 1 : 0);
+    let remaining = MAX_NATIVE_RECOVERY_SNAPSHOT_BYTES;
+    let current = state;
+    while (current.version === 3) {
+        requireSource(snapshots.length < maximum && current.recovery?.operations.length);
+        const operation = current.recovery.operations.at(-1);
+        requireSource(/^[a-f0-9]{64}$/.test(operation.sourceSha256) && !seen.has(operation.sourceSha256));
+        seen.add(operation.sourceSha256);
+        const source = await readStable(snapshotPath(commonDir, state.target, operation.sourceSha256), remaining);
+        remaining -= source.raw.length;
+        requireSource(remaining >= 0 && source.sha256 === operation.sourceSha256);
+        snapshots.push(source.text);
+        current = decodeState(source.text, state.target);
+    }
+    if (current.version === 2 && current.migration) {
+        requireSource(snapshots.length < maximum);
+        const migration = current.migration;
+        requireSource(await realpath(migration.snapshotPath) ===
+            await realpath(`${convergeRunStatePath(commonDir, state.target)}.v1-${migration.sourceSha256}.snapshot`));
+        const source = await readStable(migration.snapshotPath, remaining);
+        requireSource(source.sha256 === migration.sourceSha256 && !seen.has(source.sha256));
+        snapshots.push(source.text);
+    }
+    return snapshots;
+}
+/** Validate exact retained bytes and all physical recovery reads. */
+export async function validateNativeRecoveryState(state, commonDir, raw) {
+    try {
+        requireSource(state.version === 3);
+        const sourceRaw = raw ?? Buffer.from(`${JSON.stringify(state, null, 2)}\n`);
+        requireSource(sourceRaw.equals(Buffer.from(sourceRaw.toString('utf8'))));
+        const sources = await readNativeRecoverySourceJsons(commonDir, state);
+        const admissionSourceJsons = [];
+        let admissionSourceBytes = MAX_BYTES;
+        for (const digest of [...new Set(state.rounds.flatMap(round => round.admission ? [round.admission.sourceStateSha256] : []))]) {
+            const source = await readStable(snapshotPath(commonDir, state.target, digest), admissionSourceBytes);
+            admissionSourceBytes -= source.raw.length;
+            requireSource(admissionSourceBytes >= 0 && source.sha256 === digest);
+            admissionSourceJsons.push(source.text);
+        }
+        const materials = await readNativeRecoveryMaterials(commonDir, state);
+        const reportDigests = [...new Set([
+                ...state.recovery.operations.flatMap(operation => operation.anchors.map(anchor => anchor.source.reportSha256)),
+                ...state.rounds.flatMap(round => round.reportBinding ? [round.reportBinding.reportSha256] : []),
+            ])];
+        let remaining = MAX_BYTES;
+        const reports = [];
+        for (const digest of reportDigests) {
+            const report = await readStable(reportPath(commonDir, state.target, digest), remaining);
+            remaining -= report.raw.length;
+            requireSource(remaining >= 0 && report.sha256 === digest);
+            reports.push(report.text);
+        }
+        validateRetainedNativeEvidence({
+            sourceJson: sourceRaw.toString('utf8'), target: state.target, reports,
+            nativeSourceJsons: sources, admissionSourceJsons, recoveryMaterials: materials,
+        });
+    }
+    catch (cause) {
+        throw new Error('native_recovery_state_invalid', { cause });
+    }
+}
+async function retainRaw(path, raw) {
+    const directory = dirname(path);
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    await inspectRecoveryDirectory(directory, true);
+    await syncDirectory(dirname(directory));
+    const temporary = `${path}.${randomUUID()}.retain-tmp`;
+    let handle;
+    let created = false;
+    try {
+        handle = await open(temporary, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY | (constants.O_NOFOLLOW ?? 0), 0o600);
+        created = true;
+        await handle.writeFile(raw);
+        await handle.sync();
+        await handle.close();
+        handle = undefined;
+        try {
+            await link(temporary, path);
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST' || (await readStable(path, MAX_BYTES)).text !== raw)
+                throw error;
+            const retained = await open(path, constants.O_RDWR | (constants.O_NOFOLLOW ?? 0));
+            try {
+                await retained.sync();
+            }
+            finally {
+                await retained.close();
+            }
+        }
+        await syncDirectory(directory);
+    }
+    finally {
+        try {
+            if (handle)
+                await handle.close();
+        }
+        finally {
+            if (created)
+                await rm(temporary, { force: true });
+        }
+    }
+}
+/** Retain the exact pre-admission native bytes authenticated by a round report. */
+export async function retainNativeRecoverySource(commonDir, target, raw) {
+    const digest = sha(raw);
+    await retainRaw(snapshotPath(commonDir, target, digest), raw);
+    return digest;
+}
+/** Exact CAS under strict target ownership; an already-applied result is not rewritten. */
+export function applyNativeRecovery(options) {
+    const plan = structuredClone(options.plan);
+    const commonInput = options.gitCommonDir;
+    return withOwnedNativeOperation(options.ownership, commonInput, plan.target, async (ownership) => {
+        await assertRecoveryTargetOwnership(ownership, commonInput, plan.target);
+        const commonDir = await realpath(commonInput);
+        if (plan.currentHistory) {
+            requireSource(options.history && sameClaimHistoryEvidence(claimHistoryContent(options.history), plan.currentHistory) &&
+                Date.parse(plan.currentHistory.readWindow.completedAt) <= Date.parse(claimHistoryContent(options.history).readWindow.completedAt));
+        }
+        validateRecoveryMaterials(plan.recoveryMaterials ?? []);
+        const expected = deriveNativeRecovery(plan, nativeRecoveryPlanProjectionVersion(plan));
+        requireSource(plan.sourceVersion === expected.sourceVersion && plan.sourceSha256 === expected.sourceSha256 &&
+            plan.resultJson === expected.resultJson && plan.resultSha256 === expected.resultSha256 &&
+            isDeepStrictEqual(plan.actionableIdentities, expected.actionableIdentities));
+        const { assertReviewCyclePair, assertNoPendingFreshReview } = await import('./fresh-review.js');
+        await assertNoPendingFreshReview(commonDir, plan.target);
+        await assertReviewCyclePair(commonDir, plan.target, decodeState(plan.resultJson, plan.target).cycle);
+        const path = convergeRunStatePath(commonDir, plan.target);
+        await inspectRecoveryDirectory(dirname(path), true);
+        const observed = await readStable(path, MAX_BYTES);
+        const snapshot = snapshotPath(commonDir, plan.target, plan.sourceSha256);
+        if (observed.sha256 === plan.resultSha256 && observed.text === plan.resultJson) {
+            await validateNativeRecoveryState(decodeState(observed.text, plan.target), commonDir, observed.raw);
+            await retainRaw(path, plan.resultJson);
+            return { status: 'already_applied', snapshotPath: snapshot, resultSha256: plan.resultSha256 };
+        }
+        requireSource(observed.sha256 === plan.sourceSha256 && observed.text === plan.sourceJson);
+        const native = await loadConvergeRunStateEvidence(commonDir, plan.target);
+        requireSource(native?.sha256 === observed.sha256);
+        await retainRaw(snapshot, plan.sourceJson);
+        for (const report of plan.reports)
+            await retainRaw(reportPath(commonDir, plan.target, sha(report)), report);
+        for (const row of plan.recoveryMaterials ?? [])
+            await retainRaw(materialPath(commonDir, plan.target, row.sha256), row.text);
+        await validateNativeRecoveryState(decodeState(plan.resultJson, plan.target), commonDir, Buffer.from(plan.resultJson));
+        const temporary = `${path}.${randomUUID()}.recovery-tmp`;
+        try {
+            await retainRaw(temporary, plan.resultJson);
+            requireSource((await readStable(path, MAX_BYTES)).sha256 === plan.sourceSha256);
+            await rename(temporary, path);
+            await syncDirectory(dirname(path));
+        }
+        finally {
+            await rm(temporary, { force: true });
+        }
+        return { status: 'applied', snapshotPath: snapshot, resultSha256: plan.resultSha256 };
+    });
+}
+export { effectivePendingIdentities, recoveryAnchors, verifyNativeRecoveryLineage };
+//# sourceMappingURL=recovery-state.js.map

package/dist/converge/recovery-state.js.map

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

package/dist/converge/run-state.d.ts

@@ -4,8 +4,13 @@ import { type NativeTargetOwnership } from './target-ownership.js';
 import { type RoundGapEntry } from './round-gap-schema.js';
 import { type HistoricalDeliveryReconciliationEntry } from './historical-delivery-reconciliation-schema.js';
 import type { ConsensusFinding } from '../consensus/types.js';
+import type { ClaimDescriptor } from '../evidence/claim-recovery/validation/claims.js';
+import type { NativeRecoveryMetadata, ReportBinding, RoundAdmissionSnapshot, SemanticSighting } from '../evidence/claim-recovery/validation/types.js';
+import { type RecoveryProjectionFreshness } from '../evidence/claim-recovery/validation/current-projection.js';
 import type { GuardedLaunchState } from './launch-guard.js';
 import { type NativeReviewCycle } from './review-cycle.js';
+import { verdictClearsPending } from '../evidence/claim-recovery/validation/obligations.js';
+export { verdictClearsPending };
 /**
  * Per-converge-run state (RCL-24): the machine-enforced round cap and the
  * cross-round finding ledger (identity, verdicts, suppression). Lives next
@@ -55,6 +60,8 @@ export interface FindingEntry {
      * pre-2.1.1 states — the retained `severity` is frozen before new sightings.
      */
     verdictSeverity?: string;
+    claimDescriptor?: ClaimDescriptor;
+    pendingRound?: number;
 }
 export interface RoundCounts {
     new: number;
@@ -63,8 +70,15 @@ export interface RoundCounts {
     regating: number;
 }
 export interface ConvergeRunState {
-    version: 1 | 2;
+    version: 1 | 2 | 3;
     cycle?: NativeReviewCycle;
+    recovery?: NativeRecoveryMetadata;
+    sightings?: SemanticSighting[];
+    migration?: {
+        sourceSha256: string;
+        snapshotPath: string;
+        migratedAt: string;
+    };
     target: string;
     roundCap: number;
     /** `runId` is the report's `run.id` (rcl ≥ 3.0), which converge-verdict sends with every verdict. */
@@ -72,6 +86,9 @@ export interface ConvergeRunState {
         round: number;
         counts: RoundCounts;
         runId?: string;
+        reportBinding?: ReportBinding;
+        /** Immutable obligations at semantic admission, before verdict or later recovery mutation. */
+        admission?: RoundAdmissionSnapshot;
         /** Strongest sighting per identity in this round, including for delayed verdicts. Absent in legacy state. */
         severities?: Record<string, ConsensusFinding['severity']>;
     }>;
@@ -104,6 +121,8 @@ export interface ConvergeRunState {
             status: FindingStatus;
             gating: string;
         }>;
+        /** Pending obligations as admitted, before verdicts can clear them. */
+        actionableBeforeTriage?: string[];
     };
 }
 export type FindingStatus = 'new' | 'repeat' | 'suppressed' | 'regating';
@@ -112,10 +131,15 @@ export interface AnnotatedRoundFinding {
     status: FindingStatus;
     suppressReason?: string;
     finding: ConsensusFinding;
+    sighting?: SemanticSighting;
 }
 export interface RoundReport {
     roundCap: number;
     counts: RoundCounts;
+    actionableIdentities?: string[];
+    reportBinding?: ReportBinding;
+    classificationVersion?: 1;
+    legacyPendingIdentities?: string[];
     findings: AnnotatedRoundFinding[];
 }
 export declare function convergeRunStatePath(gitCommonDir: string, target: string): string;
@@ -127,6 +151,8 @@ export declare function loadConvergeRunStateEvidence(gitCommonDir: string, targe
 } | undefined>;
 /** Persist only under live explicit target authority; started writes drain before release. */
 export declare function writeState(gitCommonDir: string, state: ConvergeRunState, ownership: NativeTargetOwnership): Promise<void>;
+/** Exact ordinary CAS for retained transitions under the same target lease. */
+export declare function writeStateIfUnchanged(gitCommonDir: string, sourceSha256: string, next: ConvergeRunState, ownership: NativeTargetOwnership): Promise<'written' | 'already-written'>;
 /** Read-only qualification for an update to an existing native state file. */
 export declare function preflightConvergeRunStateWrite(gitCommonDir: string, state: ConvergeRunState, ownership: NativeTargetOwnership): Promise<void>;
 export declare function loadConvergeRunState(gitCommonDir: string, target: string): Promise<ConvergeRunState | undefined>;
@@ -176,6 +202,9 @@ export interface ProcessRoundOptions {
     lineWindow?: number;
     /** The report's own run id, kept so verdicts can be bound to the round's run. */
     runId?: string;
+    evidence?: {
+        reportJson: string;
+    };
     reportSha256?: string;
     cycleId?: string;
     ownership?: NativeTargetOwnership;
@@ -196,6 +225,7 @@ export interface RoundResolution {
     /** Identities recorded fixed this round (any status — every fix changes the patch). */
     fixedThisRound: number;
     status: 'converged-dismissal-only' | 'fixes-pending-fresh-round' | 'unresolved';
+    recoveryProjection?: RecoveryProjectionFreshness;
 }
 export interface RecordVerdictsResult {
     runId?: string;
@@ -222,7 +252,15 @@ export interface RecordVerdictsOptions {
         verdict: FindingVerdict;
         reason?: string;
     }>;
+    requireVerifiedBinding?: boolean;
     ownership?: NativeTargetOwnership;
 }
 export declare function recordVerdicts(options: RecordVerdictsOptions): Promise<RecordVerdictsResult>;
 export declare function resolveRoundResolution(state: ConvergeRunState, round: number): RoundResolution | undefined;
+/** Pure ordinary verdict projection for retained persistence before any write. */
+export declare function prepareVerdicts(source: ConvergeRunState, options: Omit<RecordVerdictsOptions, 'gitCommonDir' | 'ownership' | 'requireVerifiedBinding'> & {
+    recordedAt: string;
+}): {
+    state: ConvergeRunState;
+    result: RecordVerdictsResult;
+};