@zhin.js/agent 1.1.13 → 1.1.14

package/lib/workroom/file-interaction-space-binding-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-interaction-space-binding-repository.d.ts","sourceRoot":"","sources":["../../src/workroom/file-interaction-space-binding-repository.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,uBAAuB,EACvB,iCAAiC,EAClC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,iCAAiC,GAAG,iBAAiB,CAAC;AAElE,0DAA0D;AAC1D,MAAM,WAAW,iCAAkC,SAAQ,iBAAiB;IAC1E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3D;AAsBD;;;;;;GAMG;AACH,qBAAa,qCACb,YAAW,iCAAiC;;IAIxC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,UAAU,EAAE,iCAAiC;gBAD7C,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,iCAAkD;IAKnE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC;IAO1E,MAAM,CACV,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,uBAAuB,EAAE,GACzC,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC;CAmF/C"}

package/lib/workroom/file-interaction-space-binding-repository.js

@@ -0,0 +1,293 @@
+import { createHash } from 'node:crypto';
+import { readFile as nodeReadFile, readdir as nodeReaddir, } from 'node:fs/promises';
+import { join } from 'node:path';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue, } from './canonical-value.js';
+import { DurableFileStore, nodeDurableFileSystem, } from './durable-file-store.js';
+const nodeFileSystem = Object.freeze({
+    ...nodeDurableFileSystem,
+    readdir: async (path) => await nodeReaddir(path),
+    readFile: async (path, encoding) => await nodeReadFile(path, encoding),
+});
+/**
+ * Crash-durable Interaction Space binding history.
+ *
+ * The leaf directory is created non-recursively, so its parent must already be
+ * durable. Immutable segments are published through a hard-link pathname whose
+ * conversation-key hash and first binding revision form the cross-process CAS.
+ */
+export class FileInteractionSpaceBindingRepository {
+    directory;
+    fileSystem;
+    #durable;
+    constructor(directory, fileSystem = nodeFileSystem) {
+        this.directory = directory;
+        this.fileSystem = fileSystem;
+        this.#durable = new DurableFileStore(directory, fileSystem);
+    }
+    async read(conversationKey) {
+        const key = identifier(conversationKey, 'conversationKey');
+        const bindings = await this.#readBindings(key);
+        if (bindings.length > 0)
+            await this.#durable.syncLeaf();
+        return bindings;
+    }
+    async append(conversationKey, expectedRevision, values) {
+        const key = identifier(conversationKey, 'conversationKey');
+        revision(expectedRevision, 'expectedRevision', true);
+        const bindings = snapshotBindings(values, key);
+        if (bindings.length === 0) {
+            throw new Error('Interaction Space binding append requires facts');
+        }
+        const current = await this.#readBindings(key);
+        const replay = exactReplay(current, expectedRevision, bindings);
+        if (replay) {
+            if (current.length > 0)
+                await this.#durable.syncLeaf();
+            return replay;
+        }
+        if (current.length !== expectedRevision) {
+            throw revisionConflict(key, expectedRevision, current.length);
+        }
+        validateHistory(key, Object.freeze([...current, ...bindings]));
+        const firstBindingRevision = bindings[0].bindingRevision;
+        const payload = deepFreeze({
+            version: 1,
+            conversationKey: key,
+            expectedRevision,
+            firstBindingRevision,
+            lastBindingRevision: bindings.at(-1).bindingRevision,
+            bindings,
+        });
+        const segment = deepFreeze({
+            ...payload,
+            payloadDigest: digestCanonicalWorkroomValue(payload),
+        });
+        await this.#durable.ensureDurableLeaf('Interaction Space binding repository');
+        const path = this.#segmentPath(key, firstBindingRevision);
+        const published = await this.#durable.publishCreateOnly({
+            target: path,
+            content: JSON.stringify(segment),
+            createdValue: bindings,
+            onConflict: async () => {
+                const winner = await this.#readBindings(key);
+                const exact = exactReplay(winner, expectedRevision, bindings);
+                if (exact)
+                    return exact;
+                throw revisionConflict(key, expectedRevision, winner.length);
+            },
+        });
+        return published.value;
+    }
+    async #readBindings(conversationKey) {
+        let names;
+        try {
+            names = await this.fileSystem.readdir(this.directory);
+        }
+        catch (error) {
+            if (isMissingFile(error))
+                return Object.freeze([]);
+            throw error;
+        }
+        const segmentNames = names.filter(name => name.endsWith('.json')).sort();
+        const segments = await Promise.all(segmentNames.map(async (name) => parseSegment(await this.fileSystem.readFile(join(this.directory, name), 'utf8'), name)));
+        const selected = segments
+            .filter(segment => segment.conversationKey === conversationKey)
+            .sort((left, right) => left.firstBindingRevision - right.firstBindingRevision);
+        const bindings = [];
+        let expectedRevision = 0;
+        for (const segment of selected) {
+            if (segment.expectedRevision !== expectedRevision
+                || segment.firstBindingRevision !== expectedRevision + 1) {
+                throw new Error('Interaction Space binding segment revision gap');
+            }
+            bindings.push(...segment.bindings);
+            expectedRevision = segment.lastBindingRevision;
+        }
+        const frozen = deepFreeze(bindings);
+        validateHistory(conversationKey, frozen);
+        return frozen;
+    }
+    #segmentPath(conversationKey, firstRevision) {
+        return join(this.directory, segmentName(conversationKey, firstRevision));
+    }
+}
+function snapshotBindings(values, conversationKey) {
+    if (!Array.isArray(values))
+        throw new Error('Invalid Interaction Space binding facts');
+    return deepFreeze(values.map(value => {
+        const encoded = JSON.stringify(value);
+        if (typeof encoded !== 'string')
+            throw new Error('Invalid Interaction Space binding fact');
+        return parseBinding(JSON.parse(encoded), conversationKey);
+    }));
+}
+function exactReplay(current, expectedRevision, bindings) {
+    if (expectedRevision + bindings.length > current.length)
+        return undefined;
+    const persisted = current.slice(expectedRevision, expectedRevision + bindings.length);
+    if (canonicalWorkroomJson(persisted) === canonicalWorkroomJson(bindings)) {
+        return deepFreeze(persisted);
+    }
+    if (persisted.length > 0) {
+        throw new Error(`Interaction Space binding replay payload drift at revision ${expectedRevision}`);
+    }
+    return undefined;
+}
+function parseSegment(value, name) {
+    const match = /^([a-f0-9]{64})\.(\d{16})\.json$/u.exec(name);
+    if (!match)
+        throw new Error('Invalid Interaction Space binding segment name');
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error('Invalid Interaction Space binding segment JSON', { cause: error });
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('Invalid Interaction Space binding segment');
+    }
+    assertExactKeys(parsed, [
+        'version', 'conversationKey', 'expectedRevision', 'firstBindingRevision',
+        'lastBindingRevision', 'bindings', 'payloadDigest',
+    ], 'segment');
+    const segment = parsed;
+    if (segment.version !== 1
+        || typeof segment.conversationKey !== 'string'
+        || !Number.isSafeInteger(segment.expectedRevision)
+        || !Number.isSafeInteger(segment.firstBindingRevision)
+        || !Number.isSafeInteger(segment.lastBindingRevision)
+        || !Array.isArray(segment.bindings)
+        || typeof segment.payloadDigest !== 'string') {
+        throw new Error('Invalid Interaction Space binding segment');
+    }
+    const conversationKey = identifier(segment.conversationKey, 'conversationKey');
+    const expectedRevision = revision(segment.expectedRevision, 'expectedRevision', true);
+    const firstBindingRevision = revision(segment.firstBindingRevision, 'firstBindingRevision');
+    const lastBindingRevision = revision(segment.lastBindingRevision, 'lastBindingRevision');
+    if (match[1] !== conversationKeyHash(conversationKey)
+        || Number(match[2]) !== firstBindingRevision) {
+        throw new Error('Interaction Space binding segment name binding mismatch');
+    }
+    const bindings = deepFreeze(segment.bindings.map(binding => parseBinding(binding, conversationKey)));
+    if (bindings.length === 0
+        || firstBindingRevision !== expectedRevision + 1
+        || bindings[0].bindingRevision !== firstBindingRevision
+        || bindings.at(-1).bindingRevision !== lastBindingRevision) {
+        throw new Error('Invalid Interaction Space binding segment position');
+    }
+    for (let index = 0; index < bindings.length; index += 1) {
+        if (bindings[index].bindingRevision !== firstBindingRevision + index) {
+            throw new Error('Invalid Interaction Space binding position');
+        }
+    }
+    const payload = deepFreeze({
+        version: 1,
+        conversationKey,
+        expectedRevision,
+        firstBindingRevision,
+        lastBindingRevision,
+        bindings,
+    });
+    if (segment.payloadDigest !== digestCanonicalWorkroomValue(payload)) {
+        throw new Error('Interaction Space binding segment payload digest mismatch');
+    }
+    validateHistory(conversationKey, bindings, firstBindingRevision - 1);
+    return deepFreeze({ ...payload, payloadDigest: segment.payloadDigest });
+}
+function parseBinding(value, conversationKey) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Invalid Interaction Space binding');
+    }
+    assertExactKeys(value, [
+        'version', 'conversationKey', 'bindingRevision', 'effectiveAfterConversationSequence',
+        'space', 'projectId', 'sourceRef', 'sourceDigest', 'digest',
+    ], 'binding');
+    const binding = value;
+    if (binding.version !== 1 || binding.conversationKey !== conversationKey) {
+        throw new Error('Interaction Space binding conversation mismatch');
+    }
+    const bindingRevision = revision(binding.bindingRevision, 'bindingRevision');
+    const effectiveAfterConversationSequence = revision(binding.effectiveAfterConversationSequence, 'effectiveAfterConversationSequence', true);
+    if (binding.space !== 'chat' && binding.space !== 'workroom' && binding.space !== 'sponsor_room') {
+        throw new Error('Invalid Interaction Space binding space');
+    }
+    const projectId = binding.projectId === undefined
+        ? undefined
+        : identifier(binding.projectId, 'projectId');
+    if (binding.space === 'chat' && projectId !== undefined) {
+        throw new Error('Interaction Space chat binding cannot carry projectId');
+    }
+    if (binding.space !== 'chat' && projectId === undefined) {
+        throw new Error(`Interaction Space ${binding.space} binding requires projectId`);
+    }
+    const sourceRef = identifier(binding.sourceRef, 'sourceRef');
+    const sourceDigest = sha256(binding.sourceDigest, 'sourceDigest');
+    const projection = deepFreeze({
+        version: 1,
+        conversationKey,
+        bindingRevision,
+        effectiveAfterConversationSequence,
+        space: binding.space,
+        ...(projectId === undefined ? {} : { projectId }),
+        sourceRef,
+        sourceDigest,
+    });
+    if (binding.digest !== digestCanonicalWorkroomValue(projection)) {
+        throw new Error('Interaction Space binding digest mismatch');
+    }
+    return deepFreeze({ ...projection, digest: binding.digest });
+}
+function validateHistory(conversationKey, bindings, revisionOffset = 0) {
+    let previous;
+    bindings.forEach((value, index) => {
+        const binding = parseBinding(value, conversationKey);
+        if (binding.bindingRevision !== revisionOffset + index + 1) {
+            throw new Error('Interaction Space binding revisions must be contiguous');
+        }
+        if (previous
+            && binding.effectiveAfterConversationSequence
+                < previous.effectiveAfterConversationSequence) {
+            throw new Error('Interaction Space binding anchor must not move backwards');
+        }
+        previous = binding;
+    });
+}
+function segmentName(conversationKey, firstRevision) {
+    return `${conversationKeyHash(conversationKey)}.${String(firstRevision).padStart(16, '0')}.json`;
+}
+function conversationKeyHash(conversationKey) {
+    return createHash('sha256').update(conversationKey).digest('hex');
+}
+function identifier(value, field) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Invalid Interaction Space binding ${field}`);
+    }
+    return value;
+}
+function revision(value, field, allowZero = false) {
+    if (!Number.isSafeInteger(value) || value < (allowZero ? 0 : 1)) {
+        throw new Error(`Invalid Interaction Space binding ${field}`);
+    }
+    return value;
+}
+function sha256(value, field) {
+    if (typeof value !== 'string' || !/^sha256:[a-f0-9]{64}$/u.test(value)) {
+        throw new Error(`Invalid Interaction Space binding ${field}`);
+    }
+    return value;
+}
+function assertExactKeys(value, allowed, label) {
+    const allow = new Set(allowed);
+    const unexpected = Object.keys(value).find(key => !allow.has(key));
+    if (unexpected)
+        throw new Error(`Invalid Interaction Space binding ${label} field: ${unexpected}`);
+}
+function revisionConflict(conversationKey, expected, actual) {
+    return new Error(`Interaction Space binding ${conversationKey} revision conflict: expected ${expected}, actual ${actual}`);
+}
+function isMissingFile(error) {
+    return Boolean(error && typeof error === 'object' && 'code' in error
+        && error.code === 'ENOENT');
+}
+//# sourceMappingURL=file-interaction-space-binding-repository.js.map

package/lib/workroom/file-interaction-space-binding-repository.js.map

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

package/lib/workroom/file-profile-journal.d.ts

@@ -0,0 +1,32 @@
+import { type ProjectProfileEvent, type ProjectProfileEventDraft, type ProjectProfileJournal } from './profile-registry.js';
+export interface ProjectProfileJournalFileHandle {
+    writeFile(value: string, encoding: 'utf8'): Promise<void>;
+    sync(): Promise<void>;
+    close(): Promise<void>;
+}
+/** Injectable only at the durable filesystem boundary. */
+export interface ProjectProfileJournalFileSystem {
+    mkdir(path: string): Promise<void>;
+    readdir(path: string): Promise<readonly string[]>;
+    readFile(path: string, encoding: 'utf8'): Promise<string>;
+    open(path: string, flags: 'wx' | 'r'): Promise<ProjectProfileJournalFileHandle>;
+    link(existingPath: string, newPath: string): Promise<void>;
+    unlink(path: string): Promise<void>;
+}
+/**
+ * Crash-durable Project Profile Registry Journal.
+ *
+ * The configured leaf is created non-recursively. Its parent must already be
+ * durable; the adapter fsyncs that parent before publishing the first segment.
+ * Every append is an immutable segment, and a hard link to the first-sequence
+ * pathname is the cross-process expected-revision CAS.
+ */
+export declare class FileProjectProfileJournal implements ProjectProfileJournal {
+    #private;
+    readonly directory: string;
+    readonly fileSystem: ProjectProfileJournalFileSystem;
+    constructor(directory: string, fileSystem?: ProjectProfileJournalFileSystem);
+    read(projectId: string): Promise<readonly ProjectProfileEvent[]>;
+    append(projectId: string, expectedRevision: number, drafts: readonly ProjectProfileEventDraft[]): Promise<readonly ProjectProfileEvent[]>;
+}
+//# sourceMappingURL=file-profile-journal.d.ts.map

package/lib/workroom/file-profile-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-profile-journal.d.ts","sourceRoot":"","sources":["../../src/workroom/file-profile-journal.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,+BAA+B;IAC9C,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,0DAA0D;AAC1D,MAAM,WAAW,+BAA+B;IAC9C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,GAAG,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAChF,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AA+BD;;;;;;;GAOG;AACH,qBAAa,yBAA0B,YAAW,qBAAqB;;IAEnE,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,UAAU,EAAE,+BAA+B;gBAD3C,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,+BAAgD;IAGjE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAQhE,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,wBAAwB,EAAE,GAC1C,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;CAyJ3C"}

package/lib/workroom/file-profile-journal.js

@@ -0,0 +1,308 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { link as nodeLink, mkdir as nodeMkdir, open as nodeOpen, readFile as nodeReadFile, readdir as nodeReaddir, unlink as nodeUnlink, } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue, } from './canonical-value.js';
+import { ProfileRegistrySequenceConflictError, replayProjectProfileJournal, } from './profile-registry.js';
+const nodeFileSystem = Object.freeze({
+    mkdir: async (path) => {
+        await nodeMkdir(path);
+    },
+    readdir: async (path) => await nodeReaddir(path),
+    readFile: async (path, encoding) => await nodeReadFile(path, encoding),
+    open: async (path, flags) => await nodeOpen(path, flags),
+    link: async (existingPath, newPath) => await nodeLink(existingPath, newPath),
+    unlink: async (path) => await nodeUnlink(path),
+});
+/**
+ * Crash-durable Project Profile Registry Journal.
+ *
+ * The configured leaf is created non-recursively. Its parent must already be
+ * durable; the adapter fsyncs that parent before publishing the first segment.
+ * Every append is an immutable segment, and a hard link to the first-sequence
+ * pathname is the cross-process expected-revision CAS.
+ */
+export class FileProjectProfileJournal {
+    directory;
+    fileSystem;
+    constructor(directory, fileSystem = nodeFileSystem) {
+        this.directory = directory;
+        this.fileSystem = fileSystem;
+    }
+    async read(projectId) {
+        const events = await this.#readEvents(identifier(projectId, 'projectId'));
+        // A previous writer may have linked the segment and then observed a failed
+        // directory fsync. Re-sync before a retry is allowed to confirm that fact.
+        if (events.length > 0)
+            await this.#syncDirectoryPath(this.directory);
+        return events;
+    }
+    async append(projectId, expectedRevision, drafts) {
+        const id = identifier(projectId, 'projectId');
+        expectedRegistryRevision(expectedRevision);
+        const snapshottedDrafts = snapshotDrafts(drafts);
+        const current = await this.#readEvents(id);
+        const replayed = exactReplay(current, expectedRevision, snapshottedDrafts);
+        if (replayed) {
+            if (current.length > 0)
+                await this.#syncDirectoryPath(this.directory);
+            return replayed;
+        }
+        const actualRevision = current.at(-1)?.sequence ?? -1;
+        if (actualRevision !== expectedRevision) {
+            throw new ProfileRegistrySequenceConflictError(id, expectedRevision, actualRevision);
+        }
+        if (snapshottedDrafts.length === 0)
+            return Object.freeze([]);
+        const events = deepFreeze(snapshottedDrafts.map((draft, index) => ({
+            ...draft,
+            version: 1,
+            projectId: id,
+            sequence: expectedRevision + index + 1,
+        })));
+        replayProjectProfileJournal(id, Object.freeze([...current, ...events]));
+        const payload = deepFreeze({
+            version: 1,
+            projectId: id,
+            expectedRegistryRevision: expectedRevision,
+            firstSequence: events[0].sequence,
+            lastSequence: events.at(-1).sequence,
+            events,
+        });
+        const segment = deepFreeze({
+            ...payload,
+            payloadDigest: digestCanonicalWorkroomValue(payload),
+        });
+        await this.#ensureDurableLeaf();
+        const path = this.#segmentPath(id, segment.firstSequence);
+        const temporaryPath = path + '.' + randomUUID() + '.tmp';
+        let temporaryExists = false;
+        try {
+            const handle = await this.fileSystem.open(temporaryPath, 'wx');
+            temporaryExists = true;
+            try {
+                await handle.writeFile(JSON.stringify(segment), 'utf8');
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+            await this.fileSystem.link(temporaryPath, path);
+            await this.fileSystem.unlink(temporaryPath);
+            temporaryExists = false;
+            await this.#syncDirectoryPath(this.directory);
+        }
+        catch (error) {
+            if (temporaryExists) {
+                await this.#removeTemporary(temporaryPath);
+                temporaryExists = false;
+            }
+            if (isAlreadyExists(error)) {
+                const winner = await this.#readEvents(id);
+                const exact = exactReplay(winner, expectedRevision, snapshottedDrafts);
+                await this.#syncDirectoryPath(this.directory);
+                if (exact)
+                    return exact;
+                throw new ProfileRegistrySequenceConflictError(id, expectedRevision, winner.at(-1)?.sequence ?? -1);
+            }
+            throw error;
+        }
+        finally {
+            if (temporaryExists)
+                await this.#removeTemporary(temporaryPath);
+        }
+        return events;
+    }
+    async #readEvents(projectId) {
+        const prefix = projectFilePrefix(projectId);
+        let names;
+        try {
+            names = await this.fileSystem.readdir(this.directory);
+        }
+        catch (error) {
+            if (isMissingFile(error))
+                return Object.freeze([]);
+            throw error;
+        }
+        const segmentNames = names
+            .filter(name => name.startsWith(prefix) && name.endsWith('.json'))
+            .sort();
+        for (const name of segmentNames) {
+            if (!segmentNamePattern(prefix).test(name)) {
+                throw new Error('Invalid Project Profile Journal segment name');
+            }
+        }
+        const segments = await Promise.all(segmentNames.map(async (name) => parseSegment(await this.fileSystem.readFile(join(this.directory, name), 'utf8'), projectId, Number(name.slice(prefix.length, prefix.length + 16)))));
+        const events = [];
+        let expectedFirstSequence = 0;
+        for (const segment of segments) {
+            if (segment.firstSequence !== expectedFirstSequence
+                || segment.expectedRegistryRevision !== expectedFirstSequence - 1) {
+                throw new Error('Project Profile Journal segment sequence gap');
+            }
+            events.push(...segment.events);
+            expectedFirstSequence = segment.lastSequence + 1;
+        }
+        const frozen = deepFreeze(events);
+        replayProjectProfileJournal(projectId, frozen);
+        return frozen;
+    }
+    #segmentPath(projectId, firstSequence) {
+        return join(this.directory, projectFilePrefix(projectId) + String(firstSequence).padStart(16, '0') + '.json');
+    }
+    async #ensureDurableLeaf() {
+        try {
+            await this.fileSystem.mkdir(this.directory);
+        }
+        catch (error) {
+            if (!isAlreadyExists(error)) {
+                if (isMissingFile(error)) {
+                    throw new Error('Project Profile Journal requires a pre-existing durable parent directory: '
+                        + dirname(this.directory), { cause: error });
+                }
+                throw error;
+            }
+        }
+        await this.#syncDirectoryPath(dirname(this.directory));
+    }
+    async #syncDirectoryPath(path) {
+        const handle = await this.fileSystem.open(path, 'r');
+        try {
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    async #removeTemporary(path) {
+        await this.fileSystem.unlink(path).catch(error => {
+            if (!isMissingFile(error))
+                throw error;
+        });
+    }
+}
+function snapshotDrafts(drafts) {
+    if (!Array.isArray(drafts))
+        throw new Error('Invalid Project Profile Journal event drafts');
+    return deepFreeze(drafts.map(draft => {
+        const encoded = JSON.stringify(draft);
+        if (typeof encoded !== 'string')
+            throw new Error('Invalid Project Profile Journal event draft');
+        return JSON.parse(encoded);
+    }));
+}
+function exactReplay(current, expectedRevision, drafts) {
+    if (drafts.length === 0)
+        return current.at(-1)?.sequence === expectedRevision
+            ? Object.freeze([])
+            : undefined;
+    const firstSequence = expectedRevision + 1;
+    if (firstSequence < 0 || firstSequence + drafts.length > current.length)
+        return undefined;
+    const persisted = current.slice(firstSequence, firstSequence + drafts.length);
+    const persistedDrafts = persisted.map(({ version: _version, projectId: _projectId, sequence: _sequence, ...draft }) => draft);
+    if (canonicalWorkroomJson(persistedDrafts) === canonicalWorkroomJson(drafts)) {
+        return deepFreeze(persisted);
+    }
+    if (persisted.length > 0) {
+        throw new Error('Project Profile Journal replay payload drift at registry revision '
+            + expectedRevision);
+    }
+    return undefined;
+}
+function parseSegment(value, projectId, fileFirstSequence) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error('Invalid Project Profile Journal segment JSON', { cause: error });
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('Invalid Project Profile Journal segment');
+    }
+    const segment = parsed;
+    if (segment.version !== 1
+        || segment.projectId !== projectId
+        || !Number.isSafeInteger(segment.expectedRegistryRevision)
+        || !Number.isSafeInteger(segment.firstSequence)
+        || !Number.isSafeInteger(segment.lastSequence)
+        || !Array.isArray(segment.events)
+        || typeof segment.payloadDigest !== 'string') {
+        throw new Error('Invalid Project Profile Journal segment');
+    }
+    const segmentExpectedRevision = segment.expectedRegistryRevision;
+    const segmentFirstSequence = segment.firstSequence;
+    const segmentLastSequence = segment.lastSequence;
+    const events = segment.events.map(parseEvent);
+    if (segmentFirstSequence !== fileFirstSequence) {
+        throw new Error('Project Profile Journal segment name position mismatch');
+    }
+    if (events.length === 0
+        || events[0].sequence !== segmentFirstSequence
+        || events.at(-1).sequence !== segmentLastSequence
+        || segmentFirstSequence !== segmentExpectedRevision + 1) {
+        throw new Error('Invalid Project Profile Journal segment position');
+    }
+    for (let index = 0; index < events.length; index += 1) {
+        const event = events[index];
+        if (event.projectId !== projectId || event.sequence !== segmentFirstSequence + index) {
+            throw new Error('Invalid Project Profile Journal event position');
+        }
+    }
+    const payload = deepFreeze({
+        version: 1,
+        projectId,
+        expectedRegistryRevision: segmentExpectedRevision,
+        firstSequence: segmentFirstSequence,
+        lastSequence: segmentLastSequence,
+        events,
+    });
+    if (segment.payloadDigest !== digestCanonicalWorkroomValue(payload)) {
+        throw new Error('Project Profile Journal segment payload digest mismatch');
+    }
+    return deepFreeze({ ...payload, payloadDigest: segment.payloadDigest });
+}
+function parseEvent(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Invalid Project Profile Journal event');
+    }
+    const event = value;
+    if (event.version !== 1
+        || typeof event.projectId !== 'string'
+        || !Number.isSafeInteger(event.sequence)
+        || !['profile.revision_registered', 'profile.revision_activated', 'run.profile_pinned']
+            .includes(event.type ?? '')
+        || !event.payload
+        || typeof event.payload !== 'object'
+        || Array.isArray(event.payload)) {
+        throw new Error('Invalid Project Profile Journal event');
+    }
+    return deepFreeze(event);
+}
+function identifier(value, name) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error('Invalid Project Profile Journal ' + name);
+    }
+    return value;
+}
+function expectedRegistryRevision(value) {
+    if (!Number.isSafeInteger(value) || value < -1) {
+        throw new Error('Invalid Project Profile Journal expected registry revision');
+    }
+    return value;
+}
+function projectFilePrefix(projectId) {
+    return createHash('sha256').update(projectId).digest('hex') + '.';
+}
+function segmentNamePattern(prefix) {
+    return new RegExp('^' + prefix.replace('.', '\\.') + '\\d{16}\\.json$', 'u');
+}
+function isAlreadyExists(error) {
+    return Boolean(error && typeof error === 'object' && 'code' in error
+        && error.code === 'EEXIST');
+}
+function isMissingFile(error) {
+    return Boolean(error && typeof error === 'object' && 'code' in error
+        && error.code === 'ENOENT');
+}
+//# sourceMappingURL=file-profile-journal.js.map