instar 1.3.1674 → 1.3.1676

package/dist/core/CodexLifecycleProductionComposition.d.ts

@@ -58,10 +58,10 @@ export declare function createInboundDeliveryTransferHandler(deps: {
     accepted: boolean;
     reason: string;
 } | {
-    reason?: undefined;
     imported: number;
     duplicate: number;
     activeEpoch: number;
+    reason?: undefined;
     accepted: boolean;
 };
 export declare function createProductionSessionRecoveryConsumer(input: {

package/dist/core/CodexLifecycleProductionComposition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CodexLifecycleProductionComposition.d.ts","sourceRoot":"","sources":["../../src/core/CodexLifecycleProductionComposition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CodexLifecycleProductionComposition.d.ts","sourceRoot":"","sources":["../../src/core/CodexLifecycleProductionComposition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAKtC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,wBAAgB,iCAAiC,CAAC,IAAI,EAAE;IACtD,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,yBAAyB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5E,cAAc,EAAE,CAAC,KAAK,EAAE;QACtB,cAAc,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAC9F,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,yBAAyB,EAAE,MAAM,CAAC;KAC/E,KAAK,yBAAyB,GAAG,IAAI,CAAC;IACvC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAC3F,QAAQ,EAAE,yBAAyB,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpF,aAAa,EAAE,MAAM,CAAC;CACvB,WACsB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;QAHpE,OAAO;aAAW,MAAM;GAgBjF;AAED,wBAAgB,oCAAoC,CAAC,IAAI,EAAE;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/I,uBAAuB,EAAE,MAAM,MAAM,CAAC,SAAS,CAAC;IAChD,cAAc,EAAE,CAAC,KAAK,EAAE;QACtB,QAAQ,EAAE,yBAAyB,CAAC;QAAC,uBAAuB,EAAE,MAAM,CAAC,SAAS,CAAC;QAC/E,4BAA4B,EAAE,MAAM,CAAC;QAAC,uBAAuB,EAAE,MAAM,CAAC;QACtE,sBAAsB,EAAE,MAAM,CAAC;QAAC,qBAAqB,EAAE,MAAM,CAAC;KAC/D,KAAK;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3E,WACgB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,yBAAyB,CAAA;CAAE,UAAU,MAAM;;;;cAFjH,MAAM;eAAa,MAAM;iBAAe,MAAM;;;EAoBjE;AAED,wBAAgB,uCAAuC,CAAC,KAAK,EAAE;IAC7D,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IACpF,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/E,GAAG,uBAAuB,CAO1B;AAID,2FAA2F;AAC3F,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,SAAc,EAC3D,iBAAiB,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAA4B,GACxE,IAAI,CASN;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAAE,iBAAiB,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAA4B,GAC1F,OAAO,CAOT"}

package/dist/core/EvolutionArchive.d.ts

@@ -0,0 +1,79 @@
+import type { ActionArchiveEntry, ActionItem, CapabilityGap, EvolutionProposal, LearningEntry } from './types.js';
+export declare const EVOLUTION_ARCHIVE_MAX_BYTES: number;
+export declare const EVOLUTION_ARCHIVE_PAGE_BYTES: number;
+export type EvolutionArchiveKind = 'proposals' | 'learnings' | 'gaps' | 'actions';
+export type EvolutionArchiveRecord = EvolutionProposal | LearningEntry | CapabilityGap | ActionItem;
+export interface EvolutionArchiveEnvelope {
+    origin: string;
+    kind: EvolutionArchiveKind;
+    record: EvolutionArchiveRecord;
+    digest: string;
+}
+export interface EvolutionRetentionEntry {
+    kind: EvolutionArchiveKind;
+    record: EvolutionArchiveRecord;
+    archivedAt: string;
+}
+export interface EvolutionArchiveSyncPeer {
+    url: string;
+    offset: number;
+    incarnation?: string;
+    failures: number;
+    nextAttemptAt: number;
+    parked: boolean;
+}
+export interface EvolutionArchiveDocument {
+    entries: ActionArchiveEntry[];
+    retentionEntries?: EvolutionRetentionEntry[];
+    replicaEntries?: EvolutionArchiveEnvelope[];
+    archiveId?: string;
+    exportOrder?: string[];
+    syncPeers?: Record<string, EvolutionArchiveSyncPeer>;
+    [key: string]: unknown;
+}
+export interface EvolutionArchivePage {
+    entries: EvolutionArchiveEnvelope[];
+    nextOffset: number | null;
+    incarnation: string;
+    offset: number;
+    total: number;
+    oversized?: Array<{
+        digest: string;
+        origin: string;
+        kind: EvolutionArchiveKind;
+        id: string;
+        reason: 'oversized';
+    }>;
+}
+/** Historical IDs are opaque labels. New allocation syntax must not invalidate old references. */
+export declare function isEvolutionRecordId(value: unknown): value is string;
+/** Structural custody validation only. Received content never becomes a local work item. */
+export declare function validateEvolutionArchiveRecord(kind: EvolutionArchiveKind, record: unknown): asserts record is EvolutionArchiveRecord;
+export declare function evolutionArchiveDigest(origin: string, kind: EvolutionArchiveKind, record: EvolutionArchiveRecord): string;
+export declare class EvolutionArchive {
+    private readonly explicitOrigin?;
+    readonly filePath: string;
+    private originValue;
+    private readonly generatedOrigin;
+    private readonly emptyIncarnation;
+    constructor(stateDir: string, explicitOrigin?: string | undefined);
+    get origin(): string;
+    read(): EvolutionArchiveDocument;
+    private envelope;
+    private envelopes;
+    /** Fsync archive contents and directory before readback; callers may evict only after return. */
+    write(doc: EvolutionArchiveDocument): void;
+    preserve(kind: EvolutionArchiveKind, records: readonly EvolutionArchiveRecord[]): void;
+    localEntries(kind: EvolutionArchiveKind): EvolutionArchiveRecord[];
+    /** Read-only pagination. Persisted export order never shifts when a different kind is appended. */
+    page(opts?: {
+        kind?: EvolutionArchiveKind;
+        id?: string;
+        offset?: number;
+        limit?: number;
+    }): EvolutionArchivePage;
+    /** Validate the complete page before changing any memory or advancing its peer cursor. */
+    importPage(page: EvolutionArchivePage): void;
+    static validatePage(page: unknown): asserts page is EvolutionArchivePage;
+}
+//# sourceMappingURL=EvolutionArchive.d.ts.map

package/dist/core/EvolutionArchive.d.ts.map

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

package/dist/core/EvolutionArchive.js

@@ -0,0 +1,309 @@
+/** EVO-022: full memory custody, shared with the existing action auto-expiry archive. */
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash, randomUUID } from 'node:crypto';
+import { stableJson } from './stableJson.js';
+import { SafeFsExecutor } from './SafeFsExecutor.js';
+export const EVOLUTION_ARCHIVE_MAX_BYTES = 64 * 1024 * 1024;
+export const EVOLUTION_ARCHIVE_PAGE_BYTES = 1024 * 1024;
+const kinds = new Set(['proposals', 'learnings', 'gaps', 'actions']);
+const object = (x) => !!x && typeof x === 'object' && !Array.isArray(x);
+const integer = (x) => Number.isSafeInteger(x) && x >= 0;
+/** Historical IDs are opaque labels. New allocation syntax must not invalidate old references. */
+export function isEvolutionRecordId(value) {
+    return typeof value === 'string' && value.length > 0 && value.length <= 100 && !value.includes(String.fromCharCode(0));
+}
+/** Structural custody validation only. Received content never becomes a local work item. */
+export function validateEvolutionArchiveRecord(kind, record) {
+    if (!object(record) || typeof record.id !== 'string' || typeof record.title !== 'string' || typeof record.description !== 'string')
+        throw new Error('invalid evolution archive record');
+    if (!isEvolutionRecordId(record.id))
+        throw new Error('invalid evolution archive id');
+    if (kind === 'learnings') {
+        if (typeof record.applied !== 'boolean')
+            throw new Error('invalid archived learning applied flag');
+    }
+    else {
+        const statuses = kind === 'proposals' ? ['proposed', 'approved', 'in_progress', 'implemented', 'rejected', 'deferred']
+            : kind === 'actions' ? ['pending', 'in_progress', 'completed', 'cancelled'] : ['identified', 'addressed', 'wont_fix'];
+        if (!statuses.includes(record.status))
+            throw new Error('invalid evolution archive status');
+    }
+}
+export function evolutionArchiveDigest(origin, kind, record) {
+    return createHash('sha256').update(stableJson({ origin, kind, record })).digest('hex');
+}
+function assertEnvelope(raw) {
+    if (!object(raw) || typeof raw.origin !== 'string' || !raw.origin || raw.origin.length > 200 || !kinds.has(raw.kind) || typeof raw.digest !== 'string')
+        throw new Error('invalid evolution archive envelope');
+    validateEvolutionArchiveRecord(raw.kind, raw.record);
+    if (raw.digest !== evolutionArchiveDigest(raw.origin, raw.kind, raw.record))
+        throw new Error('evolution archive digest mismatch');
+}
+function assertDocument(raw) {
+    if (!object(raw) || !Array.isArray(raw.entries))
+        throw new Error('archive has no entries array');
+    for (const entry of raw.entries) {
+        if (!object(entry) || typeof entry.archivedAt !== 'string' || typeof entry.class !== 'string' || typeof entry.ageDays !== 'number' || !Number.isFinite(entry.ageDays))
+            throw new Error('invalid action archive entry');
+        validateEvolutionArchiveRecord('actions', entry.action);
+        if (entry.restoredAt !== undefined && typeof entry.restoredAt !== 'string')
+            throw new Error('invalid archive restore marker');
+    }
+    if (raw.retentionEntries !== undefined) {
+        if (!Array.isArray(raw.retentionEntries))
+            throw new Error('invalid retention archive entries');
+        for (const entry of raw.retentionEntries) {
+            if (!object(entry) || !kinds.has(entry.kind) || typeof entry.archivedAt !== 'string')
+                throw new Error('invalid retention archive entry');
+            validateEvolutionArchiveRecord(entry.kind, entry.record);
+        }
+    }
+    if (raw.replicaEntries !== undefined) {
+        if (!Array.isArray(raw.replicaEntries))
+            throw new Error('invalid archive replicas');
+        for (const entry of raw.replicaEntries)
+            assertEnvelope(entry);
+    }
+    if (raw.archiveId !== undefined && (typeof raw.archiveId !== 'string' || !raw.archiveId))
+        throw new Error('invalid archive incarnation');
+    if (raw.exportOrder !== undefined && (!Array.isArray(raw.exportOrder) || raw.exportOrder.some(x => typeof x !== 'string' || !/^[a-f0-9]{64}$/.test(x)) || new Set(raw.exportOrder).size !== raw.exportOrder.length))
+        throw new Error('invalid archive export order');
+    if (raw.syncPeers !== undefined) {
+        if (!object(raw.syncPeers))
+            throw new Error('invalid archive sync state');
+        for (const peer of Object.values(raw.syncPeers)) {
+            if (!object(peer) || typeof peer.url !== 'string' || !integer(peer.offset) || !integer(peer.failures) || typeof peer.nextAttemptAt !== 'number' || !Number.isFinite(peer.nextAttemptAt) || typeof peer.parked !== 'boolean' || (peer.incarnation !== undefined && typeof peer.incarnation !== 'string'))
+                throw new Error('invalid archive peer state');
+        }
+    }
+}
+export class EvolutionArchive {
+    explicitOrigin;
+    filePath;
+    originValue;
+    generatedOrigin = `archive:${randomUUID()}`;
+    emptyIncarnation = randomUUID();
+    constructor(stateDir, explicitOrigin) {
+        this.explicitOrigin = explicitOrigin;
+        this.filePath = path.join(stateDir, 'state', 'evolution', 'action-archive.json');
+    }
+    get origin() {
+        if (this.originValue === undefined)
+            this.read();
+        return this.originValue;
+    }
+    read() {
+        let text;
+        try {
+            const stat = fs.statSync(this.filePath);
+            if (stat.size > EVOLUTION_ARCHIVE_MAX_BYTES)
+                throw new Error('evolution archive exceeds 64 MiB ceiling');
+            text = fs.readFileSync(this.filePath, 'utf8');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                this.originValue ??= this.explicitOrigin ?? this.generatedOrigin;
+                return { entries: [], archiveId: this.emptyIncarnation, localOrigin: this.originValue };
+            }
+            throw err;
+        }
+        if (Buffer.byteLength(text) > EVOLUTION_ARCHIVE_MAX_BYTES)
+            throw new Error('evolution archive exceeds 64 MiB ceiling');
+        const doc = JSON.parse(text);
+        assertDocument(doc);
+        if (doc.localOrigin !== undefined && (typeof doc.localOrigin !== 'string' || !doc.localOrigin || doc.localOrigin.length > 200))
+            throw new Error('invalid archive local origin');
+        // Legacy read-only exports must be stable across processes before adoption writes.
+        // A missing empty archive may use a new UUID; an existing legacy document may not.
+        this.originValue = typeof doc.localOrigin === 'string' ? doc.localOrigin : this.explicitOrigin
+            ?? `legacy:${createHash('sha256').update(stableJson(doc)).digest('hex')}`;
+        return doc;
+    }
+    envelope(kind, record) {
+        return { origin: this.origin, kind, record, digest: evolutionArchiveDigest(this.origin, kind, record) };
+    }
+    envelopes(doc) {
+        const all = new Map();
+        for (const entry of doc.entries) {
+            const e = this.envelope('actions', entry.action);
+            all.set(e.digest, e);
+        }
+        for (const entry of doc.retentionEntries ?? []) {
+            const e = this.envelope(entry.kind, entry.record);
+            all.set(e.digest, e);
+        }
+        for (const e of doc.replicaEntries ?? [])
+            all.set(e.digest, e);
+        return all;
+    }
+    /** Fsync archive contents and directory before readback; callers may evict only after return. */
+    write(doc) {
+        assertDocument(doc);
+        const prior = this.read();
+        if (doc.localOrigin !== undefined && doc.localOrigin !== this.origin)
+            throw new Error('archive origin cannot change');
+        const all = this.envelopes(doc);
+        for (const digest of this.envelopes(prior).keys())
+            if (!all.has(digest))
+                throw new Error('archive write would remove exported memory');
+        const order = [...(prior.exportOrder ?? doc.exportOrder ?? [])];
+        if (order.some(digest => !all.has(digest)))
+            throw new Error('archive write would remove exported memory');
+        const seen = new Set(order);
+        for (const digest of all.keys())
+            if (!seen.has(digest)) {
+                order.push(digest);
+                seen.add(digest);
+            }
+        const stored = { ...doc, localOrigin: doc.localOrigin ?? this.origin, archiveId: doc.archiveId ?? randomUUID(), exportOrder: order };
+        const serialized = JSON.stringify(stored, null, 2);
+        if (Buffer.byteLength(serialized) > EVOLUTION_ARCHIVE_MAX_BYTES)
+            throw new Error('evolution archive write exceeds 64 MiB ceiling');
+        const dir = path.dirname(this.filePath);
+        fs.mkdirSync(dir, { recursive: true });
+        const temp = `${this.filePath}.${process.pid}.${randomUUID()}.tmp`;
+        try {
+            const fd = fs.openSync(temp, 'wx', 0o600);
+            try {
+                fs.writeFileSync(fd, serialized);
+                fs.fsyncSync(fd);
+            }
+            finally {
+                fs.closeSync(fd);
+            }
+            fs.renameSync(temp, this.filePath);
+            const directoryFd = fs.openSync(dir, 'r');
+            try {
+                fs.fsyncSync(directoryFd);
+            }
+            finally {
+                fs.closeSync(directoryFd);
+            }
+            if (fs.readFileSync(this.filePath, 'utf8') !== serialized)
+                throw new Error('evolution archive readback mismatch');
+        }
+        catch (err) {
+            try {
+                SafeFsExecutor.safeUnlinkSync(temp, { operation: 'EvolutionArchive:failed-write-temp' });
+            }
+            catch { /* original error preserved */ }
+            throw err;
+        }
+    }
+    preserve(kind, records) {
+        const doc = this.read();
+        const existing = this.envelopes(doc);
+        for (const record of records) {
+            validateEvolutionArchiveRecord(kind, record);
+            // Normalize JSON once so equality/digests match persisted content, including undefined members.
+            const clone = JSON.parse(JSON.stringify(record));
+            const e = this.envelope(kind, clone);
+            if (Buffer.byteLength(JSON.stringify(e)) > EVOLUTION_ARCHIVE_PAGE_BYTES - 65536)
+                throw new Error('oversized evolution archive record; retain hot record');
+            if (kind === 'actions') {
+                // A restored occurrence no longer licenses restore. Re-eviction needs a
+                // new unrestored custody occurrence even when its content digest repeats.
+                if (doc.entries.some(entry => !entry.restoredAt && this.envelope('actions', entry.action).digest === e.digest))
+                    continue;
+                doc.entries.push({ action: clone, archivedAt: new Date().toISOString(), ageDays: 0, class: 'retention' });
+            }
+            else {
+                if (existing.has(e.digest))
+                    continue;
+                (doc.retentionEntries ??= []).push({ kind, record: clone, archivedAt: new Date().toISOString() });
+            }
+            existing.set(e.digest, e);
+        }
+        this.write(doc);
+        const verified = this.envelopes(this.read());
+        for (const record of records)
+            if (!verified.has(this.envelope(kind, record).digest))
+                throw new Error('evolution archive preservation readback missing record');
+    }
+    localEntries(kind) {
+        const doc = this.read();
+        return kind === 'actions' ? doc.entries.map(e => e.action) : (doc.retentionEntries ?? []).filter(e => e.kind === kind).map(e => e.record);
+    }
+    /** Read-only pagination. Persisted export order never shifts when a different kind is appended. */
+    page(opts = {}) {
+        const offset = opts.offset ?? 0, limit = opts.limit ?? 50;
+        if (!integer(offset) || !integer(limit) || limit < 1 || limit > 50)
+            throw new Error('invalid archive pagination');
+        const doc = this.read(), all = this.envelopes(doc);
+        const order = [...(doc.exportOrder ?? [])];
+        const seen = new Set(order);
+        for (const digest of all.keys())
+            if (!seen.has(digest)) {
+                order.push(digest);
+                seen.add(digest);
+            }
+        const selected = order.map(d => all.get(d)).filter((e) => !!e && (!opts.kind || e.kind === opts.kind) && (!opts.id || e.record.id === opts.id));
+        const entries = [], oversized = [];
+        let index = Math.min(offset, selected.length), bytes = 65536;
+        while (index < selected.length && entries.length + oversized.length < limit) {
+            const entry = selected[index], size = Buffer.byteLength(JSON.stringify(entry));
+            if (size > EVOLUTION_ARCHIVE_PAGE_BYTES - 65536) {
+                oversized.push({ digest: entry.digest, origin: entry.origin, kind: entry.kind, id: entry.record.id, reason: 'oversized' });
+                index++;
+                continue;
+            }
+            if (bytes + size > EVOLUTION_ARCHIVE_PAGE_BYTES)
+                break;
+            entries.push(entry);
+            bytes += size;
+            index++;
+        }
+        return { entries, nextOffset: index < selected.length ? index : null, incarnation: doc.archiveId ?? createHash('sha256').update(stableJson(doc)).digest('hex'), offset, total: selected.length, ...(oversized.length ? { oversized } : {}) };
+    }
+    /** Validate the complete page before changing any memory or advancing its peer cursor. */
+    importPage(page) {
+        EvolutionArchive.validatePage(page);
+        if (page.oversized?.length)
+            throw new Error('peer archive contains oversized records; incomplete preservation');
+        const doc = this.read(), known = this.envelopes(doc);
+        for (const entry of page.entries) {
+            if (known.has(entry.digest))
+                continue;
+            (doc.replicaEntries ??= []).push(entry);
+            known.set(entry.digest, entry);
+        }
+        this.write(doc);
+    }
+    static validatePage(page) {
+        if (!object(page) || !Array.isArray(page.entries) || page.entries.length > 50 || typeof page.incarnation !== 'string' || !page.incarnation || page.incarnation.length > 200 || !integer(page.offset) || !integer(page.total) || (page.nextOffset !== null && !integer(page.nextOffset)))
+            throw new Error('invalid evolution archive page');
+        if (Buffer.byteLength(JSON.stringify(page)) > EVOLUTION_ARCHIVE_PAGE_BYTES)
+            throw new Error('evolution archive page exceeds byte ceiling');
+        if (page.oversized !== undefined && (!Array.isArray(page.oversized) || page.oversized.length > 50))
+            throw new Error('invalid oversized archive metadata');
+        const oversized = (page.oversized ?? []);
+        for (const entry of oversized) {
+            if (!object(entry) || typeof entry.digest !== 'string' || !/^[a-f0-9]{64}$/.test(entry.digest)
+                || typeof entry.origin !== 'string' || !entry.origin || entry.origin.length > 200
+                || !kinds.has(entry.kind) || typeof entry.id !== 'string' || entry.id.length > 100
+                || entry.reason !== 'oversized')
+                throw new Error('invalid oversized archive metadata');
+            if (!isEvolutionRecordId(entry.id))
+                throw new Error('invalid oversized archive id');
+        }
+        const delivered = page.entries.length + oversized.length;
+        if (delivered > 50)
+            throw new Error('evolution archive page exceeds record ceiling');
+        if (page.nextOffset !== null) {
+            if (page.nextOffset !== page.offset + delivered || page.nextOffset <= page.offset || page.nextOffset > page.total)
+                throw new Error('invalid archive cursor coverage');
+        }
+        else if (page.offset + delivered !== page.total && !(page.offset > page.total && delivered === 0)) {
+            // A rebuilt stream may answer an old cursor past its new end. The worker
+            // verifies incarnation and rescans zero, rather than accepting missing rows.
+            throw new Error('invalid terminal archive coverage');
+        }
+        for (const entry of page.entries)
+            assertEnvelope(entry);
+        const digests = [...page.entries.map((entry) => entry.digest), ...oversized.map(entry => entry.digest)];
+        if (new Set(digests).size !== digests.length)
+            throw new Error('duplicate evolution archive page digest');
+    }
+}
+//# sourceMappingURL=EvolutionArchive.js.map

package/dist/core/EvolutionArchive.js.map

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

package/dist/core/EvolutionArchiveSync.d.ts

@@ -0,0 +1,26 @@
+/** Bounded archive anti-entropy on the existing authenticated peer-presence cadence. */
+import { EvolutionArchive, type EvolutionArchivePage, type EvolutionArchiveSyncPeer } from './EvolutionArchive.js';
+export declare const EVOLUTION_ARCHIVE_SYNC_MAX_FAILURES = 6;
+/** Shared runtime/ratchet brake: unchanged evidence eventually permits no more requests. */
+export declare function evolutionArchiveSyncAttemptDue(peer: EvolutionArchiveSyncPeer, now: number): boolean;
+/** Pessimistic attempt reservation: only durable validated import earns the budget back. */
+export declare function advanceEvolutionArchiveFailure(peer: EvolutionArchiveSyncPeer, now: number): EvolutionArchiveSyncPeer;
+export interface EvolutionArchiveSyncDeps {
+    fetchPage(peerId: string, url: string, offset: number, signal: AbortSignal): Promise<EvolutionArchivePage>;
+    now?: () => number;
+    log?: (event: string, detail: Record<string, unknown>) => void;
+}
+export declare class EvolutionArchiveSync {
+    private readonly archive;
+    private readonly deps;
+    private readonly active;
+    private stopped;
+    constructor(archive: EvolutionArchive, deps: EvolutionArchiveSyncDeps);
+    private peer;
+    private persist;
+    /** Explicit agent-owned re-arm; repeated presence alone never resets a parked peer. */
+    resetPeer(peerId: string): void;
+    onPeerRecorded(peerId: string, url: string): Promise<void>;
+    stop(): void;
+}
+//# sourceMappingURL=EvolutionArchiveSync.d.ts.map

package/dist/core/EvolutionArchiveSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvolutionArchiveSync.d.ts","sourceRoot":"","sources":["../../src/core/EvolutionArchiveSync.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEnH,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD,4FAA4F;AAC5F,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,wBAAwB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnG;AAED,4FAA4F;AAC5F,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,wBAAwB,EAAE,GAAG,EAAE,MAAM,GAAG,wBAAwB,CAIpH;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3G,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAChE;AAED,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAoB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAF7E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,OAAO,CAAS;IACxB,YAA6B,OAAO,EAAE,gBAAgB,EAAmB,IAAI,EAAE,wBAAwB,EAAI;IAE3G,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,OAAO;IAKf,uFAAuF;IACvF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAM9B;IACK,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C/D;IACD,IAAI,IAAI,IAAI,CAGX;CACF"}

package/dist/core/EvolutionArchiveSync.js

@@ -0,0 +1,109 @@
+/** Bounded archive anti-entropy on the existing authenticated peer-presence cadence. */
+import { EvolutionArchive } from './EvolutionArchive.js';
+export const EVOLUTION_ARCHIVE_SYNC_MAX_FAILURES = 6;
+/** Shared runtime/ratchet brake: unchanged evidence eventually permits no more requests. */
+export function evolutionArchiveSyncAttemptDue(peer, now) {
+    return !peer.parked && peer.failures < EVOLUTION_ARCHIVE_SYNC_MAX_FAILURES && now >= peer.nextAttemptAt;
+}
+/** Pessimistic attempt reservation: only durable validated import earns the budget back. */
+export function advanceEvolutionArchiveFailure(peer, now) {
+    const failures = peer.failures + 1;
+    return { ...peer, failures, nextAttemptAt: now + Math.min(30 * 60_000, 30_000 * 2 ** (failures - 1)),
+        parked: failures >= EVOLUTION_ARCHIVE_SYNC_MAX_FAILURES };
+}
+/* @self-action-controller: evolution-archive-sync */
+export class EvolutionArchiveSync {
+    archive;
+    deps;
+    active = new Map();
+    stopped = false;
+    constructor(archive, deps) {
+        this.archive = archive;
+        this.deps = deps;
+    }
+    peer(peerId, url) {
+        const doc = this.archive.read();
+        const prior = doc.syncPeers?.[peerId];
+        return prior?.url === url ? { ...prior } : { url, offset: 0, failures: 0, nextAttemptAt: 0, parked: false };
+    }
+    persist(peerId, peer) {
+        const doc = this.archive.read(); // Always re-read after any asynchronous fetch/import.
+        doc.syncPeers = { ...(doc.syncPeers ?? {}), [peerId]: peer };
+        this.archive.write(doc);
+    }
+    /** Explicit agent-owned re-arm; repeated presence alone never resets a parked peer. */
+    resetPeer(peerId) {
+        const doc = this.archive.read();
+        if (doc.syncPeers?.[peerId]) {
+            doc.syncPeers[peerId] = { ...doc.syncPeers[peerId], failures: 0, nextAttemptAt: 0, parked: false };
+            this.archive.write(doc);
+        }
+    }
+    async onPeerRecorded(peerId, url) {
+        if (this.stopped || this.active.has(peerId))
+            return;
+        const now = this.deps.now ?? Date.now;
+        // A corrupt ledger must refuse ALL requests; never silently reset its bound.
+        let peer;
+        try {
+            peer = this.peer(peerId, url);
+        }
+        catch (err) {
+            this.deps.log?.('evolution-archive-sync-unavailable', { peerId, error: String(err) });
+            return;
+        }
+        if (!evolutionArchiveSyncAttemptDue(peer, now()))
+            return;
+        const controller = new AbortController();
+        this.active.set(peerId, controller);
+        const deadline = setTimeout(() => controller.abort(), 5_000);
+        deadline.unref();
+        try {
+            for (let pages = 0; pages < 4 && !this.stopped && !controller.signal.aborted; pages++) {
+                if (!evolutionArchiveSyncAttemptDue(peer, now()))
+                    return;
+                // Spend and fsync the retry budget BEFORE sending. A full/unwritable archive
+                // authorizes zero requests; process loss or failed custody cannot reset attempts.
+                const reserved = advanceEvolutionArchiveFailure(peer, now());
+                this.persist(peerId, reserved);
+                peer = reserved;
+                const page = await this.deps.fetchPage(peerId, url, peer.offset, controller.signal);
+                if (this.stopped || controller.signal.aborted)
+                    return;
+                EvolutionArchive.validatePage(page);
+                if (peer.incarnation !== undefined && peer.incarnation !== page.incarnation && peer.offset !== 0) {
+                    // Do not accept a stale-offset page from a rebuilt stream; rescan its beginning.
+                    const reset = { ...peer, offset: 0, incarnation: page.incarnation, failures: 0, nextAttemptAt: 0, parked: false };
+                    this.persist(peerId, reset);
+                    peer = reset;
+                    continue;
+                }
+                if (page.offset !== peer.offset)
+                    throw new Error('peer archive offset mismatch');
+                this.archive.importPage(page); // fsync custody first; cursor is durable only afterwards.
+                const imported = { ...peer, incarnation: page.incarnation, offset: page.nextOffset ?? 0, failures: 0, nextAttemptAt: 0, parked: false };
+                this.persist(peerId, imported);
+                peer = imported;
+                if (page.nextOffset === null)
+                    return;
+            }
+        }
+        catch (err) {
+            if (!this.stopped) {
+                // The attempt was already charged before fetch; never double-charge or
+                // depend on a second write succeeding after a disk/custody failure.
+                this.deps.log?.(peer.parked ? 'evolution-archive-sync-parked' : 'evolution-archive-sync-failed', { peerId, failures: peer.failures, nextAttemptAt: peer.nextAttemptAt, error: String(err) });
+            }
+        }
+        finally {
+            clearTimeout(deadline);
+            this.active.delete(peerId);
+        }
+    }
+    stop() {
+        this.stopped = true;
+        for (const controller of this.active.values())
+            controller.abort();
+    }
+}
+//# sourceMappingURL=EvolutionArchiveSync.js.map

package/dist/core/EvolutionArchiveSync.js.map

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