agentera 3.0.0-dev.20 → 3.0.0-dev.21

package/dist/state/archivePublication.js

@@ -0,0 +1,225 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { dumpYamlMapping } from "../core/yaml.js";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { ArtifactSchemaValidator } from "../hooks/validateArtifact/index.js";
+import { assertRealpathBoundary } from "../registries/artifactRegistry.js";
+import { canonicalRecordJson, discoverNumberedArchives, numberedArchiveContract, } from "./archiveDiscovery.js";
+import { reject } from "./write/errors.js";
+const nodeFileSystem = {
+    exists: (candidate) => fs.existsSync(candidate),
+    mkdir: (directory) => fs.mkdirSync(directory),
+    openExclusive: (stage) => fs.openSync(stage, "wx"),
+    write: (fd, bytes) => fs.writeFileSync(fd, bytes, "utf8"),
+    syncFile: (fd) => fs.fsyncSync(fd),
+    close: (fd) => fs.closeSync(fd),
+    link: (stage, target) => fs.linkSync(stage, target),
+    unlink: (stage) => fs.unlinkSync(stage),
+    syncDirectory: (directory) => {
+        const fd = fs.openSync(directory, "r");
+        try {
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    },
+};
+function nearestExistingDirectory(directory, fileSystem) {
+    let cursor = path.resolve(directory);
+    while (!fileSystem.exists(cursor)) {
+        const parent = path.dirname(cursor);
+        if (parent === cursor)
+            return cursor;
+        cursor = parent;
+    }
+    return cursor;
+}
+function ensureDurableDirectory(directory, fileSystem, options) {
+    const root = path.resolve(options.directoryDurabilityRoot ?? nearestExistingDirectory(directory, fileSystem));
+    const relative = path.relative(root, path.resolve(directory));
+    if (relative.startsWith("..") || path.isAbsolute(relative))
+        throw new Error(`directory durability root '${root}' does not contain '${directory}'`);
+    let parent = root;
+    for (const segment of relative.split(path.sep).filter(Boolean)) {
+        const child = path.join(parent, segment);
+        let created = false;
+        if (!fileSystem.exists(child)) {
+            try {
+                fileSystem.mkdir(child);
+                created = true;
+            }
+            catch (error) {
+                if (error.code !== "EEXIST")
+                    throw error;
+            }
+        }
+        fileSystem.syncDirectory(parent);
+        if (created)
+            options.afterDirectoryEntrySync?.(child);
+        parent = child;
+    }
+}
+let stageSequence = 0;
+export function publishImmutableFile(target, bytes, options = {}) {
+    const fileSystem = options.fileSystem ?? nodeFileSystem;
+    const directory = path.dirname(target);
+    ensureDurableDirectory(directory, fileSystem, options);
+    const stage = stagePath(directory, path.basename(target));
+    let stageCreated = false;
+    let fd;
+    try {
+        fd = fileSystem.openExclusive(stage);
+        stageCreated = true;
+        fileSystem.write(fd, bytes);
+        fileSystem.syncFile(fd);
+        fileSystem.close(fd);
+        fd = undefined;
+        try {
+            fileSystem.link(stage, target);
+            fileSystem.syncDirectory(directory);
+            options.afterDirectorySync?.();
+            return true;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            options.onExisting?.();
+            return false;
+        }
+    }
+    finally {
+        if (fd !== undefined)
+            fileSystem.close(fd);
+        if (stageCreated) {
+            try {
+                fileSystem.unlink(stage);
+                fileSystem.syncDirectory(directory);
+            }
+            catch {
+                // A linked file is authoritative; a private stage can be cleaned on retry.
+            }
+        }
+    }
+}
+function rejectConflict(stableId, message) {
+    reject({
+        class: "conflict",
+        message,
+        syntax: "agentera state <artifact-id> append ... --format json",
+        example: "retry the same append for an identical record; change the entry content for a new record",
+        violations: [`immutable archive identity: ${stableId}`],
+    });
+}
+function assertNoSymlinkPath(projectRoot, candidate) {
+    const relative = path.relative(path.resolve(projectRoot), candidate);
+    let cursor = path.resolve(projectRoot);
+    for (const segment of relative.split(path.sep)) {
+        if (!segment)
+            continue;
+        cursor = path.join(cursor, segment);
+        let stat;
+        try {
+            stat = fs.lstatSync(cursor);
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                continue;
+            throw error;
+        }
+        if (stat.isSymbolicLink())
+            reject({
+                class: "unsupported_target",
+                message: `numbered archive path contains a symbolic link: '${cursor}'`,
+                syntax: "agentera state <artifact-id> append ... --format json",
+                example: "remove the symbolic link and retry the append",
+            });
+    }
+}
+function archivePath(projectRoot, artifactId, entryNumber, sourceRoot) {
+    if (!Number.isSafeInteger(entryNumber) || entryNumber <= 0)
+        reject({
+            class: "invalid_int",
+            message: `entry number must be a positive safe integer, got '${entryNumber}'`,
+            syntax: "entry number N",
+            example: "use the number assigned by the state writer",
+        });
+    const contract = numberedArchiveContract(artifactId, sourceRoot);
+    const target = path.join(path.resolve(projectRoot), contract.archiveRoot, contract.artifactId, `${entryNumber}${contract.archiveExtension}`);
+    try {
+        assertRealpathBoundary(projectRoot, target, "numbered archive");
+    }
+    catch (error) {
+        reject({
+            class: "unsupported_target",
+            message: error.message,
+            syntax: "agentera state <artifact-id> append ... --format json",
+            example: "select a project-local archive path and retry",
+        });
+    }
+    assertNoSymlinkPath(projectRoot, target);
+    return { target, stableId: `${artifactId}:${entryNumber}`, contract };
+}
+function validateRecord(sourceRoot, contract, entryNumber, record) {
+    if (typeof record[contract.entryNumberField] !== "number" ||
+        !Number.isSafeInteger(record[contract.entryNumberField]) ||
+        record[contract.entryNumberField] !== entryNumber) {
+        throw new Error(`archive record ${contract.entryNumberField} must equal its positive entry number ${entryNumber}`);
+    }
+    const validator = new ArtifactSchemaValidator(path.join(sourceRoot, "skills", "agentera", "schemas", "artifacts"));
+    const schema = validator.loadSchema(contract.artifactId);
+    if (!schema)
+        throw new Error(`archive artifact '${contract.artifactId}' schema is unavailable`);
+    const violations = validator.validateYaml(dumpYamlMapping({ [contract.entryCollection]: [record] }), schema, contract.artifactId);
+    if (violations.length > 0)
+        throw new Error(`archive record failed ${contract.artifactId} schema validation: ${violations.join("; ")}`);
+    return canonicalRecordJson(record);
+}
+function stagePath(directory, filename) {
+    stageSequence += 1;
+    return path.join(directory, `.${filename}.writer.${process.pid}.${stageSequence}.tmp`);
+}
+function existingArchiveMatches(projectRoot, target, stableId, record, sourceRoot) {
+    const discovered = discoverNumberedArchives(projectRoot, { sourceRoot });
+    const existing = discovered.entries.find((entry) => entry.path === target);
+    if (existing && canonicalRecordJson(existing.record) === canonicalRecordJson(record))
+        return true;
+    rejectConflict(stableId, `immutable archive '${target}' already exists with different or invalid canonical content; existing bytes were preserved`);
+}
+export function publishNumberedArchive(projectRoot, artifactId, entryNumber, record, options = {}) {
+    const sourceRoot = options.sourceRoot ?? resolveSourceRoot();
+    const fileSystem = options.fileSystem ?? nodeFileSystem;
+    const location = archivePath(projectRoot, artifactId, entryNumber, sourceRoot);
+    const serialized = serializeNumberedArchive(artifactId, entryNumber, record, sourceRoot);
+    const published = publishImmutableFile(location.target, serialized.bytes, {
+        fileSystem,
+        directoryDurabilityRoot: projectRoot,
+        afterDirectorySync: options.afterDirectorySync,
+        onExisting: () => {
+            existingArchiveMatches(projectRoot, location.target, location.stableId, record, sourceRoot);
+        },
+    });
+    return {
+        path: location.target,
+        stableId: location.stableId,
+        recordSha256: serialized.recordSha256,
+        replay: !published,
+    };
+}
+export function serializeNumberedArchive(artifactId, entryNumber, record, sourceRoot = resolveSourceRoot()) {
+    const contract = numberedArchiveContract(artifactId, sourceRoot);
+    const canonical = validateRecord(sourceRoot, contract, entryNumber, record);
+    const recordSha256 = createHash("sha256").update(canonical, "utf8").digest("hex");
+    return {
+        bytes: dumpYamlMapping({
+            schemaVersion: contract.entrySchemaVersion,
+            artifact_id: artifactId,
+            entry_number: entryNumber,
+            record,
+            record_sha256: recordSha256,
+        }),
+        recordSha256,
+    };
+}
+//# sourceMappingURL=archivePublication.js.map

package/dist/state/archivePublication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archivePublication.js","sourceRoot":"","sources":["../../src/state/archivePublication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAkC3C,MAAM,cAAc,GAAiC;IACnD,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;IAC/C,KAAK,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC;IAC7C,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAClD,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC;IACzD,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;IAClC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;IAC/B,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACnD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;IACvC,aAAa,EAAE,CAAC,SAAS,EAAE,EAAE;QAC3B,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;CACF,CAAC;AAEF,SAAS,wBAAwB,CAC/B,SAAiB,EACjB,UAAwC;IAExC,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC;QACrC,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,sBAAsB,CAC7B,SAAiB,EACjB,UAAwC,EACxC,OAAwC;IAExC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CACvB,OAAO,CAAC,uBAAuB,IAAI,wBAAwB,CAAC,SAAS,EAAE,UAAU,CAAC,CACnF,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9D,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,uBAAuB,SAAS,GAAG,CAAC,CAAC;IACzF,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACxB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,KAAK,CAAC;YACtE,CAAC;QACH,CAAC;QACD,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,OAAO;YAAE,OAAO,CAAC,uBAAuB,EAAE,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,GAAG,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,IAAI,aAAa,GAAG,CAAC,CAAC;AAEtB,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,KAAa,EACb,UAA2C,EAAE;IAE7C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,cAAc,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,sBAAsB,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,EAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,EAAE,GAAG,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACrC,YAAY,GAAG,IAAI,CAAC;QACpB,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC5B,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxB,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrB,EAAE,GAAG,SAAS,CAAC;QACf,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC/B,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YACpC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YACpE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,EAAE,KAAK,SAAS;YAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACzB,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,2EAA2E;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB,EAAE,OAAe;IACvD,MAAM,CAAC;QACL,KAAK,EAAE,UAAU;QACjB,OAAO;QACP,MAAM,EAAE,uDAAuD;QAC/D,OAAO,EAAE,0FAA0F;QACnG,UAAU,EAAE,CAAC,+BAA+B,QAAQ,EAAE,CAAC;KACxD,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,WAAmB,EAAE,SAAiB;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;IACrE,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,IAAI,IAAc,CAAC;QACnB,IAAI,CAAC;YACH,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YACjE,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,cAAc,EAAE;YACvB,MAAM,CAAC;gBACL,KAAK,EAAE,oBAAoB;gBAC3B,OAAO,EAAE,oDAAoD,MAAM,GAAG;gBACtE,MAAM,EAAE,uDAAuD;gBAC/D,OAAO,EAAE,+CAA+C;aACzD,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAClB,WAAmB,EACnB,UAAkB,EAClB,WAAmB,EACnB,UAAkB;IAElB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC;QACxD,MAAM,CAAC;YACL,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,sDAAsD,WAAW,GAAG;YAC7E,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,6CAA6C;SACvD,CAAC,CAAC;IACL,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CACtB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EACzB,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,UAAU,EACnB,GAAG,WAAW,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CAC7C,CAAC;IACF,IAAI,CAAC;QACH,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC;YACL,KAAK,EAAE,oBAAoB;YAC3B,OAAO,EAAG,KAAe,CAAC,OAAO;YACjC,MAAM,EAAE,uDAAuD;YAC/D,OAAO,EAAE,+CAA+C;SACzD,CAAC,CAAC;IACL,CAAC;IACD,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,IAAI,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,cAAc,CACrB,UAAkB,EAClB,QAAoD,EACpD,WAAmB,EACnB,MAAkB;IAElB,IACE,OAAO,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,QAAQ;QACrD,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QACxD,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,WAAW,EACjD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,kBAAkB,QAAQ,CAAC,gBAAgB,yCAAyC,WAAW,EAAE,CAClG,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,uBAAuB,CAC3C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CACpE,CAAC;IACF,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,UAAU,yBAAyB,CAAC,CAAC;IAChG,MAAM,UAAU,GAAG,SAAS,CAAC,YAAY,CACvC,eAAe,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EACzD,MAAM,EACN,QAAQ,CAAC,UAAU,CACpB,CAAC;IACF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,CAAC,UAAU,uBAAuB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9G,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,SAAS,CAAC,SAAiB,EAAE,QAAgB;IACpD,aAAa,IAAI,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,QAAQ,WAAW,OAAO,CAAC,GAAG,IAAI,aAAa,MAAM,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,sBAAsB,CAC7B,WAAmB,EACnB,MAAc,EACd,QAAgB,EAChB,MAAkB,EAClB,UAAkB;IAElB,MAAM,UAAU,GAAG,wBAAwB,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAC3E,IAAI,QAAQ,IAAI,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,mBAAmB,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAClG,cAAc,CACZ,QAAQ,EACR,sBAAsB,MAAM,6FAA6F,CAC1H,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,UAAkB,EAClB,WAAmB,EACnB,MAAkB,EAClB,UAII,EAAE;IAEN,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;IAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,cAAc,CAAC;IACxD,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,wBAAwB,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACzF,MAAM,SAAS,GAAG,oBAAoB,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE;QACxE,UAAU;QACV,uBAAuB,EAAE,WAAW;QACpC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,UAAU,EAAE,GAAG,EAAE;YACf,sBAAsB,CACpB,WAAW,EACX,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,QAAQ,EACjB,MAAM,EACN,UAAU,CACX,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,MAAM;QACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,MAAM,EAAE,CAAC,SAAS;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,UAAkB,EAClB,WAAmB,EACnB,MAAkB,EAClB,aAAqB,iBAAiB,EAAE;IAExC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClF,OAAO;QACL,KAAK,EAAE,eAAe,CAAC;YACrB,aAAa,EAAE,QAAQ,CAAC,kBAAkB;YAC1C,WAAW,EAAE,UAAU;YACvB,YAAY,EAAE,WAAW;YACzB,MAAM;YACN,aAAa,EAAE,YAAY;SAC5B,CAAC;QACF,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/state/archiveRecovery.js

@@ -0,0 +1,238 @@
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { canonicalRecordJson, discoverNumberedArchives, numberedArchiveContract, } from "./archiveDiscovery.js";
+const PROJECTION_COMMAND = "agentera check compact --mode fix --format json";
+function entryNumber(record, contract) {
+    const value = record[contract.entryNumberField];
+    if (typeof value === "number" && Number.isSafeInteger(value) && value > 0)
+        return value;
+    if (typeof value === "string" && /^[1-9][0-9]*$/.test(value)) {
+        const parsed = Number(value);
+        return Number.isSafeInteger(parsed) ? parsed : null;
+    }
+    return null;
+}
+function stableId(artifactId, number) {
+    return `${artifactId}:${number ?? "?"}`;
+}
+function archivePath(projectRoot, contract, artifactId, number) {
+    if (number === null)
+        return undefined;
+    return path.join(path.resolve(projectRoot), contract.archiveRoot, artifactId, `${number}${contract.archiveExtension}`);
+}
+function rejectionForEntry(rejectionList, target, contract, number) {
+    if (!target || number === null)
+        return undefined;
+    const artifactDirectory = path.dirname(target);
+    return rejectionList.find((candidate) => {
+        const candidatePath = path.resolve(candidate.path);
+        const resolvedTarget = path.resolve(target);
+        const targetFromCandidate = path.relative(candidatePath, resolvedTarget);
+        if (candidatePath === resolvedTarget ||
+            candidatePath === path.resolve(artifactDirectory) ||
+            (targetFromCandidate !== "" &&
+                !targetFromCandidate.startsWith(".." + path.sep) &&
+                !path.isAbsolute(targetFromCandidate))) {
+            return true;
+        }
+        const relative = path.relative(artifactDirectory, candidatePath);
+        if (!relative || relative.includes(path.sep))
+            return false;
+        const stem = relative.endsWith(contract.archiveExtension)
+            ? relative.slice(0, -contract.archiveExtension.length)
+            : "";
+        return /^\+?[0-9]+$/.test(stem) && Number(stem.replace(/^\+/, "")) === number;
+    });
+}
+function errorClassForRejection(rejection) {
+    return rejection.class === "unsupported_artifact" ||
+        rejection.reason === "unsupported_artifact" ||
+        (rejection.reason === "invalid_envelope" && rejection.message.startsWith("schemaVersion must be"))
+        ? "unsupported_state"
+        : "corrupt";
+}
+function failure(projectRoot, artifactId, number, contract, recoveryClass, message, details = {}) {
+    const archive = contract ? archivePath(projectRoot, contract, artifactId, number) : undefined;
+    const id = stableId(artifactId, number);
+    const recovery = recoveryClass === "not_found"
+        ? "Keep the current full entry and publish or restore its validated numbered archive before retrying."
+        : recoveryClass === "corrupt"
+            ? "Keep the current full entry, preserve the archive bytes for diagnostics, repair the archive, then retry."
+            : recoveryClass === "immutable_conflict"
+                ? "Keep the current full entry, preserve the immutable archive bytes, reconcile the conflicting record, then retry."
+                : "Keep the current full entry and use a state format supported by the storage authority before retrying.";
+    const status = recoveryClass === "not_found"
+        ? "degraded"
+        : recoveryClass === "unsupported_state"
+            ? "unsupported"
+            : "blocked";
+    return {
+        stable_id: id,
+        artifact_id: artifactId,
+        ...(number === null ? {} : { entry_number: number }),
+        ...(archive ? { archive_path: archive } : {}),
+        status,
+        reason: recoveryClass,
+        detail_availability: "full",
+        source: "current_projection",
+        error: {
+            schemaVersion: "agentera.stateFailure.v1",
+            class: recoveryClass,
+            message,
+            syntax: PROJECTION_COMMAND,
+            example: PROJECTION_COMMAND,
+            recovery,
+            details: {
+                artifact_id: artifactId,
+                entry_number: number,
+                stable_id: id,
+                ...(archive ? { archive_path: archive } : {}),
+                ...details,
+            },
+        },
+    };
+}
+function verifyWithDiscovery(projectRoot, artifactId, record, contract, discovery) {
+    const number = entryNumber(record, contract);
+    const target = archivePath(projectRoot, contract, artifactId, number);
+    const id = stableId(artifactId, number);
+    if (number === null) {
+        return failure(projectRoot, artifactId, number, contract, "unsupported_state", `full entry ${id} has no supported positive archive entry number`);
+    }
+    const candidate = discovery.entries.find((entry) => entry.stableId === id);
+    if (candidate) {
+        let expectedHash;
+        try {
+            expectedHash = createHash("sha256").update(canonicalRecordJson(record), "utf8").digest("hex");
+        }
+        catch (error) {
+            return failure(projectRoot, artifactId, number, contract, "unsupported_state", `full entry ${id} cannot be represented as canonical archive content: ${error.message}`);
+        }
+        if (candidate.recordSha256 === expectedHash && canonicalRecordJson(candidate.record) === canonicalRecordJson(record)) {
+            return {
+                stable_id: id,
+                artifact_id: artifactId,
+                entry_number: number,
+                archive_path: candidate.path,
+                status: "complete",
+                reason: "verified",
+                detail_availability: "full",
+                source: "archive",
+            };
+        }
+        return failure(projectRoot, artifactId, number, contract, "immutable_conflict", `archive record ${id} is valid but conflicts with the full current entry; summary publication is refused`, {
+            archive_record_sha256: candidate.recordSha256,
+            expected_record_sha256: expectedHash,
+        });
+    }
+    const rejection = rejectionForEntry(discovery.rejected, target, contract, number);
+    if (rejection) {
+        const recoveryClass = errorClassForRejection(rejection);
+        return failure(projectRoot, artifactId, number, contract, recoveryClass, `archive record ${id} cannot be verified: ${rejection.message}; summary publication is refused`, { archive_rejection: rejection.reason, archive_rejection_class: rejection.class });
+    }
+    return failure(projectRoot, artifactId, number, contract, "not_found", `validated archive record ${id} is absent; summary publication is refused`);
+}
+function aggregateStatus(refusals) {
+    if (refusals.some((entry) => entry.status === "blocked"))
+        return "blocked";
+    if (refusals.some((entry) => entry.status === "unsupported"))
+        return "unsupported";
+    if (refusals.some((entry) => entry.status === "degraded"))
+        return "degraded";
+    return "complete";
+}
+function unsupportedVerification(projectRoot, artifactId, record, message) {
+    const number = typeof record.number === "number" && Number.isSafeInteger(record.number) ? record.number : null;
+    return failure(projectRoot, artifactId, number, undefined, "unsupported_state", message);
+}
+export function verifyArchiveForProjection(projectRoot, artifactId, record, options = {}) {
+    let contract;
+    try {
+        contract = numberedArchiveContract(artifactId, options.sourceRoot);
+    }
+    catch (error) {
+        return unsupportedVerification(projectRoot, artifactId, record, `artifact '${artifactId}' is outside the numbered archive authority: ${error.message}`);
+    }
+    try {
+        return verifyWithDiscovery(projectRoot, artifactId, record, contract, discoverNumberedArchives(projectRoot, { sourceRoot: options.sourceRoot }));
+    }
+    catch (error) {
+        return failure(projectRoot, artifactId, entryNumber(record, contract), contract, "unsupported_state", `archive authority could not verify ${stableId(artifactId, entryNumber(record, contract))}: ${error.message}`);
+    }
+}
+export function gateProjectionEntries(projectRoot, artifactId, records, options = {}) {
+    if (records.length === 0) {
+        return {
+            verified: [],
+            refused: [],
+            recovery: { status: "complete", attempted: 0, verified: 0, retained_full: 0, refused_count: 0, refusals: [] },
+        };
+    }
+    let contract;
+    try {
+        contract = numberedArchiveContract(artifactId, options.sourceRoot);
+    }
+    catch (error) {
+        const refused = records.map((entry) => ({
+            entry,
+            recovery: unsupportedVerification(projectRoot, artifactId, entry, `artifact '${artifactId}' is outside the numbered archive authority: ${error.message}`),
+        }));
+        return {
+            verified: [],
+            refused,
+            recovery: {
+                status: "unsupported",
+                attempted: records.length,
+                verified: 0,
+                retained_full: records.length,
+                refused_count: refused.length,
+                refusals: refused.map(({ recovery }) => recovery),
+            },
+        };
+    }
+    let discovery;
+    try {
+        discovery = discoverNumberedArchives(projectRoot, { sourceRoot: options.sourceRoot });
+    }
+    catch (error) {
+        const refused = records.map((entry) => ({
+            entry,
+            recovery: failure(projectRoot, artifactId, entryNumber(entry, contract), contract, "unsupported_state", `archive authority could not verify ${stableId(artifactId, entryNumber(entry, contract))}: ${error.message}`),
+        }));
+        return {
+            verified: [],
+            refused,
+            recovery: {
+                status: "unsupported",
+                attempted: records.length,
+                verified: 0,
+                retained_full: records.length,
+                refused_count: refused.length,
+                refusals: refused.map(({ recovery }) => recovery),
+            },
+        };
+    }
+    const verified = [];
+    const refused = [];
+    for (const entry of records) {
+        const recovery = verifyWithDiscovery(projectRoot, artifactId, entry, contract, discovery);
+        if (recovery.reason === "verified")
+            verified.push(entry);
+        else
+            refused.push({ entry, recovery });
+    }
+    const refusals = refused.map(({ recovery }) => recovery);
+    return {
+        verified,
+        refused,
+        recovery: {
+            status: aggregateStatus(refusals),
+            attempted: records.length,
+            verified: verified.length,
+            retained_full: refused.length,
+            refused_count: refused.length,
+            refusals,
+        },
+    };
+}
+//# sourceMappingURL=archiveRecovery.js.map

package/dist/state/archiveRecovery.js.map

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

package/dist/state/archiveReplay.js

@@ -0,0 +1,54 @@
+import { isDeepStrictEqual } from "node:util";
+import { discoverNumberedArchives } from "./archiveDiscovery.js";
+import { reject } from "./write/errors.js";
+function mappingPath(entry, field) {
+    let value = entry;
+    for (const part of field.split(".")) {
+        if (!value || typeof value !== "object" || Array.isArray(value))
+            return undefined;
+        value = value[part];
+    }
+    return value;
+}
+export function isExactArchiveReplay(entry, payload) {
+    if (!entry)
+        return false;
+    const projected = {};
+    for (const [key, expected] of Object.entries(payload)) {
+        if (expected === undefined)
+            continue;
+        const parts = key.split(".");
+        let cursor = projected;
+        for (const part of parts.slice(0, -1)) {
+            if (!cursor[part] || typeof cursor[part] !== "object")
+                cursor[part] = {};
+            cursor = cursor[part];
+        }
+        cursor[parts.at(-1)] = mappingPath(entry, key);
+    }
+    return isDeepStrictEqual(projected, payload);
+}
+export function findArchivedReplay(projectRoot, artifact, payload) {
+    if (Object.keys(payload).length === 0)
+        return undefined;
+    return discoverNumberedArchives(projectRoot).entries
+        .filter((entry) => entry.artifactId === artifact)
+        .find((entry) => isExactArchiveReplay(entry.record, payload))?.record;
+}
+export function recoverArchivedEntry(candidate, collection, entries, recovered, descending) {
+    const number = Number(recovered.number);
+    const sameNumber = entries.find((entry) => Number(entry.number) === number);
+    if (sameNumber && !isDeepStrictEqual(sameNumber, recovered)) {
+        reject({
+            class: "conflict",
+            message: `archived entry ${number} conflicts with the current ${collection} projection`,
+        });
+    }
+    if (sameNumber)
+        return;
+    candidate[collection] = [...entries, recovered].sort((a, b) => {
+        const difference = Number(a.number) - Number(b.number);
+        return descending ? -difference : difference;
+    });
+}
+//# sourceMappingURL=archiveReplay.js.map

package/dist/state/archiveReplay.js.map

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