@zhin.js/workroom 0.0.0 → 0.0.2

package/lib/workroom/journal/contracts.d.ts

@@ -0,0 +1,141 @@
+import type { WorkroomBlocker, WorkroomBlockerKind, WorkroomEvent, WorkroomEventDraft } from '../kernel-contracts.js';
+import type { WorkroomGovernedPayloadReceipt } from '../workroom-task-report-store.js';
+import type { GovernedPayloadPublicationVerification, GovernedPayloadWriteSagaSnapshot } from '../../data-governance/governed-payload-write-saga.js';
+export interface WorkroomJournalPayloadWriteInput {
+    readonly projectId: string;
+    readonly runId: string;
+    readonly eventId: string;
+    readonly eventType: WorkroomEvent['type'];
+    readonly occurredAt: number;
+    readonly fieldPath: string;
+    readonly value: unknown;
+    readonly contentHash: string;
+    readonly source: Readonly<{
+        ref: string;
+        digest: string;
+        bindingDigest: string;
+    }>;
+}
+export interface WorkroomJournalPayloadReadInput {
+    readonly projectId: string;
+    readonly runId: string;
+    readonly eventId: string;
+    readonly eventType: WorkroomEvent['type'];
+    readonly fieldPath: string;
+    readonly contentHash: string;
+    readonly receipt: WorkroomGovernedPayloadReceipt;
+    readonly purpose: 'kernel-replay';
+}
+/**
+ * Narrow P12 boundary for governed Workroom Journal text. Implementations own
+ * storage, current-policy authorization and source-lineage verification.
+ */
+export interface WorkroomJournalPayloadPort {
+    write(input: WorkroomJournalPayloadWriteInput): Promise<WorkroomGovernedPayloadReceipt>;
+    read(input: WorkroomJournalPayloadReadInput): Promise<unknown>;
+    publish?(input: Readonly<{
+        projectId: string;
+        runId: string;
+        receipts: readonly WorkroomGovernedPayloadReceipt[];
+        publicationDigest: string;
+    }>): Promise<void>;
+    prepare?(input: Readonly<{
+        projectId: string;
+        runId: string;
+        receipts: readonly WorkroomGovernedPayloadReceipt[];
+    }>): Promise<void>;
+    abandon?(input: Readonly<{
+        projectId: string;
+        runId: string;
+        receipts: readonly WorkroomGovernedPayloadReceipt[];
+        reason: 'cas_lost' | 'write_failed';
+    }>): Promise<void>;
+    reconcile?(input: Readonly<{
+        projectId: string;
+        runId: string;
+        receipts: readonly WorkroomGovernedPayloadReceipt[];
+        publicationDigest: string;
+    }>): Promise<void>;
+}
+export declare class WorkroomJournalPayloadAuthorityUnavailableError extends Error {
+    constructor();
+}
+export interface GovernedWorkroomJournalPayloadReference {
+    readonly version: 1;
+    readonly kind: 'governed_workroom_journal_payload';
+    readonly fieldPath: string;
+    readonly contentHash: string;
+    readonly receipt: WorkroomGovernedPayloadReceipt;
+}
+export interface StoredWorkroomEvent extends Omit<WorkroomEvent, 'version' | 'payload'> {
+    readonly version: 3;
+    /** Content-free control projection derived before payload protection. */
+    readonly control: WorkroomStoredEventControl;
+    readonly payload: Readonly<Record<string, unknown>>;
+}
+export declare class WorkroomSequenceConflictError extends Error {
+    readonly runId: string;
+    readonly expectedSequence: number;
+    readonly actualSequence: number;
+    constructor(runId: string, expectedSequence: number, actualSequence: number);
+}
+export interface WorkroomJournal {
+    listRunIds(): Promise<readonly string[]>;
+    /** Content-free stored envelopes only; implementations must never materialize governed payloads. */
+    scanStoredHeaders(): Promise<readonly WorkroomStoredRunHeaders[]>;
+    /** Content-free stored envelopes only; implementations must never materialize governed payloads. */
+    readStoredHeaders(runId: string): Promise<WorkroomStoredRunHeaders | null>;
+    /** Content-free generation handoff verification; optional adapters remain fail-closed/pending. */
+    verifyGovernedPayloadPublication?(intent: GovernedPayloadWriteSagaSnapshot): Promise<GovernedPayloadPublicationVerification>;
+    read(runId: string): Promise<readonly WorkroomEvent[]>;
+    append(runId: string, expectedSequence: number, events: readonly WorkroomEventDraft[]): Promise<readonly WorkroomEvent[]>;
+}
+export interface WorkroomStoredEventHeader {
+    readonly version: 1;
+    readonly eventRef: string;
+    readonly runId: string;
+    readonly sequence: number;
+    readonly occurredAt: number;
+    readonly type: WorkroomEvent['type'];
+    /** Minimal opaque state-transition fields; raw identifiers and caller text are excluded. */
+    readonly control: WorkroomStoredEventControl;
+    readonly protectedPayloadDigest: string;
+    readonly protectedReceipts: readonly WorkroomStoredProtectedReceiptHeader[];
+    readonly digest: string;
+}
+export interface WorkroomStoredEventControl {
+    readonly projectId?: string;
+    readonly taskKey?: string;
+    readonly assignmentId?: string;
+    readonly blockerId?: string;
+    readonly blockerKind?: WorkroomBlockerKind;
+    readonly blockerDeadline?: number;
+    readonly blockerAllowedActions?: WorkroomBlocker['allowedActions'];
+    readonly waitId?: string;
+    readonly waitStatus?: string;
+    readonly role?: WorkroomAssignmentRoleHeader;
+    readonly required?: boolean;
+    readonly maxAttempts?: number;
+    readonly attempt?: number;
+    readonly assignmentRevision?: number;
+    readonly fence?: number;
+    readonly outcome?: 'interrupted' | 'committed' | 'outcome_unknown';
+    readonly verdictOutcome?: 'passed' | 'rework';
+    readonly decision?: 'approve' | 'reject' | 'request_changes' | 'cancel';
+    readonly newTaskRevision?: number;
+}
+export type WorkroomAssignmentRoleHeader = 'executor' | 'reviewer' | 'integration';
+export interface WorkroomStoredProtectedReceiptHeader {
+    readonly fieldPath: string;
+    readonly contentHash: string;
+    readonly descriptorDigest: string;
+    readonly sourceDigest: string;
+    readonly sourceBindingDigest: string;
+}
+export interface WorkroomStoredRunHeaders {
+    readonly version: 1;
+    readonly runId: string;
+    readonly events: readonly WorkroomStoredEventHeader[];
+    readonly digest: string;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/lib/workroom/journal/contracts.d.ts.map

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

package/lib/workroom/journal/contracts.js

@@ -0,0 +1,19 @@
+export class WorkroomJournalPayloadAuthorityUnavailableError extends Error {
+    constructor() {
+        super('Governed Workroom Journal payload authority is unavailable');
+        this.name = 'WorkroomJournalPayloadAuthorityUnavailableError';
+    }
+}
+export class WorkroomSequenceConflictError extends Error {
+    runId;
+    expectedSequence;
+    actualSequence;
+    constructor(runId, expectedSequence, actualSequence) {
+        super(`Workroom ${runId} sequence conflict: expected ${expectedSequence}, actual ${actualSequence}`);
+        this.runId = runId;
+        this.expectedSequence = expectedSequence;
+        this.actualSequence = actualSequence;
+        this.name = 'WorkroomSequenceConflictError';
+    }
+}
+//# sourceMappingURL=contracts.js.map

package/lib/workroom/journal/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/workroom/journal/contracts.ts"],"names":[],"mappings":"AAuEA,MAAM,OAAO,+CAAgD,SAAQ,KAAK;IACxE;QACE,KAAK,CAAC,4DAA4D,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,iDAAiD,CAAC;IAChE,CAAC;CACF;AAiBD,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAE3C;IACA;IACA;IAHX,YACW,KAAa,EACb,gBAAwB,EACxB,cAAsB;QAE/B,KAAK,CAAC,YAAY,KAAK,gCAAgC,gBAAgB,YAAY,cAAc,EAAE,CAAC,CAAC;QAJ5F,UAAK,GAAL,KAAK,CAAQ;QACb,qBAAgB,GAAhB,gBAAgB,CAAQ;QACxB,mBAAc,GAAd,cAAc,CAAQ;QAG/B,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF"}

package/lib/workroom/journal/database-journal.d.ts

@@ -0,0 +1,31 @@
+import type { WorkroomEvent, WorkroomEventDraft } from '../kernel-contracts.js';
+import type { GovernedPayloadPublicationVerification, GovernedPayloadWriteSagaSnapshot } from '../../data-governance/governed-payload-write-saga.js';
+import { type WorkroomJournal, type WorkroomJournalPayloadPort, type WorkroomStoredRunHeaders } from './contracts.js';
+interface WorkroomEventModel {
+    select(...fields: string[]): {
+        where(condition: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    };
+}
+interface WorkroomTransaction {
+    select(table: string): {
+        where(condition: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    };
+    insertMany(table: string, rows: Record<string, unknown>[]): Promise<unknown>;
+}
+interface WorkroomDatabase {
+    transaction<T>(operation: (transaction: WorkroomTransaction) => Promise<T>, options: {
+        isolationLevel: 'SERIALIZABLE';
+    }): Promise<T>;
+}
+export declare class DatabaseWorkroomJournal implements WorkroomJournal {
+    #private;
+    constructor(database: WorkroomDatabase, eventModel: WorkroomEventModel, payloads?: WorkroomJournalPayloadPort);
+    listRunIds(): Promise<readonly string[]>;
+    scanStoredHeaders(): Promise<readonly WorkroomStoredRunHeaders[]>;
+    readStoredHeaders(runId: string): Promise<WorkroomStoredRunHeaders | null>;
+    verifyGovernedPayloadPublication(intent: GovernedPayloadWriteSagaSnapshot): Promise<GovernedPayloadPublicationVerification>;
+    read(runId: string): Promise<readonly WorkroomEvent[]>;
+    append(runId: string, expectedSequence: number, drafts: readonly WorkroomEventDraft[]): Promise<readonly WorkroomEvent[]>;
+}
+export {};
+//# sourceMappingURL=database-journal.d.ts.map

package/lib/workroom/journal/database-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-journal.d.ts","sourceRoot":"","sources":["../../../src/workroom/journal/database-journal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EACV,sCAAsC,EACtC,gCAAgC,EACjC,MAAM,sDAAsD,CAAC;AAE9D,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC9B,MAAM,gBAAgB,CAAC;AAmBxB,UAAU,kBAAkB;IAC1B,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG;QAC3B,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;KAC/E,CAAC;CACH;AAED,UAAU,mBAAmB;IAC3B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG;QACrB,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;KAC/E,CAAC;IACF,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9E;AAED,UAAU,gBAAgB;IACxB,WAAW,CAAC,CAAC,EACX,SAAS,EAAE,CAAC,WAAW,EAAE,mBAAmB,KAAK,OAAO,CAAC,CAAC,CAAC,EAC3D,OAAO,EAAE;QAAE,cAAc,EAAE,cAAc,CAAA;KAAE,GAC1C,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAED,qBAAa,uBAAwB,YAAW,eAAe;;gBAM3D,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,CAAC,EAAE,0BAA0B;IAOjC,UAAU,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAIxC,iBAAiB,IAAI,OAAO,CAAC,SAAS,wBAAwB,EAAE,CAAC;IAMjE,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAM1E,gCAAgC,CACpC,MAAM,EAAE,gCAAgC,GACvC,OAAO,CAAC,sCAAsC,CAAC;IAS5C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;IAQtD,MAAM,CACV,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,kBAAkB,EAAE,GACpC,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;CA2ErC"}

package/lib/workroom/journal/database-journal.js

@@ -0,0 +1,114 @@
+import { deepFreezeWorkroomValue as deepFreeze } from '../canonical-value.js';
+import { assertNoLegacyEmbeddedPayloadRecords } from './legacy-payload-guard.js';
+import { WorkroomJournalPayloadAuthorityUnavailableError, WorkroomSequenceConflictError, } from './contracts.js';
+import { legacyDatabaseJournalRecords, materializeEvents, parseStoredRowGroups, parseStoredRows, storedRunHeaders, toRow, } from './event-codec.js';
+import { collectGovernedPayloadReceipts, journalPublicationDigest, materializeStoredEvents, projectIdForAppend, protectEvents, reconcileJournalPayloads, verifyJournalPayloadPublication, } from './payload-governance.js';
+export class DatabaseWorkroomJournal {
+    #database;
+    #eventModel;
+    #payloads;
+    constructor(database, eventModel, payloads) {
+        this.#database = database;
+        this.#eventModel = eventModel;
+        this.#payloads = payloads;
+    }
+    async listRunIds() {
+        return Object.freeze((await this.scanStoredHeaders()).map(run => run.runId));
+    }
+    async scanStoredHeaders() {
+        const rows = await this.#eventModel.select().where({});
+        return Object.freeze([...parseStoredRowGroups(rows).entries()]
+            .map(([runId, events]) => storedRunHeaders(runId, events)));
+    }
+    async readStoredHeaders(runId) {
+        const rows = await this.#eventModel.select().where({ run_id: runId });
+        const events = parseStoredRows(runId, rows);
+        return events.length === 0 ? null : storedRunHeaders(runId, events);
+    }
+    async verifyGovernedPayloadPublication(intent) {
+        if (!intent.publicationScope)
+            return deepFreeze({ status: 'missing' });
+        const rows = await this.#eventModel.select().where({ run_id: intent.publicationScope });
+        return verifyJournalPayloadPublication(intent, parseStoredRows(intent.publicationScope, rows));
+    }
+    async read(runId) {
+        const rows = await this.#eventModel.select().where({ run_id: runId });
+        const events = parseStoredRows(runId, rows);
+        if (events.length === 0)
+            return Object.freeze([]);
+        await reconcileJournalPayloads(runId, events, this.#requirePayloads());
+        return await materializeStoredEvents(events, this.#requirePayloads());
+    }
+    async append(runId, expectedSequence, drafts) {
+        let publication;
+        let headerPublished = false;
+        try {
+            const allRows = await this.#eventModel.select().where({});
+            assertNoLegacyEmbeddedPayloadRecords(legacyDatabaseJournalRecords(allRows));
+            const current = parseStoredRowGroups(allRows).get(runId) ?? Object.freeze([]);
+            if (current.length > 0) {
+                await reconcileJournalPayloads(runId, current, this.#requirePayloads());
+            }
+            const actualSequence = current.at(-1)?.sequence ?? -1;
+            if (actualSequence !== expectedSequence) {
+                throw new WorkroomSequenceConflictError(runId, expectedSequence, actualSequence);
+            }
+            if (drafts.length === 0)
+                return [];
+            const appended = materializeEvents(runId, expectedSequence, drafts);
+            const projectId = projectIdForAppend(current, appended);
+            const protectedEvents = await protectEvents(appended, projectId, this.#requirePayloads());
+            publication = { projectId, protectedEvents, current };
+            await this.#requirePayloads().prepare?.({
+                projectId,
+                runId,
+                receipts: collectGovernedPayloadReceipts(protectedEvents),
+            });
+            await this.#database.transaction(async (transaction) => {
+                const transactionRows = await transaction.select('workroom_events').where({});
+                assertNoLegacyEmbeddedPayloadRecords(legacyDatabaseJournalRecords(transactionRows));
+                const transactionCurrent = parseStoredRowGroups(transactionRows).get(runId)
+                    ?? Object.freeze([]);
+                const transactionSequence = transactionCurrent.at(-1)?.sequence ?? -1;
+                if (transactionSequence !== expectedSequence) {
+                    throw new WorkroomSequenceConflictError(runId, expectedSequence, transactionSequence);
+                }
+                await transaction.insertMany('workroom_events', protectedEvents.map(toRow));
+            }, { isolationLevel: 'SERIALIZABLE' });
+            headerPublished = true;
+            await this.#requirePayloads().publish?.({
+                projectId: publication.projectId,
+                runId,
+                receipts: collectGovernedPayloadReceipts(publication.protectedEvents),
+                publicationDigest: journalPublicationDigest(runId, [...publication.current, ...publication.protectedEvents]),
+            });
+            return appended;
+        }
+        catch (error) {
+            if (publication && !headerPublished) {
+                await this.#requirePayloads().abandon?.({
+                    projectId: publication.projectId,
+                    runId,
+                    receipts: collectGovernedPayloadReceipts(publication.protectedEvents),
+                    reason: error instanceof WorkroomSequenceConflictError ? 'cas_lost' : 'write_failed',
+                });
+            }
+            if (error instanceof WorkroomSequenceConflictError || headerPublished)
+                throw error;
+            // A serializable/unique-key loser is dialect-specific. Re-read the
+            // authoritative sequence and normalize only a proven concurrent winner;
+            // unrelated database failures retain their original error.
+            const actualSequence = (await this.read(runId)).at(-1)?.sequence ?? -1;
+            if (actualSequence !== expectedSequence) {
+                throw new WorkroomSequenceConflictError(runId, expectedSequence, actualSequence);
+            }
+            throw error;
+        }
+    }
+    #requirePayloads() {
+        if (!this.#payloads)
+            throw new WorkroomJournalPayloadAuthorityUnavailableError();
+        return this.#payloads;
+    }
+}
+//# sourceMappingURL=database-journal.js.map

package/lib/workroom/journal/database-journal.js.map

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

package/lib/workroom/journal/event-codec.d.ts

@@ -0,0 +1,26 @@
+import type { WorkroomEvent, WorkroomEventDraft } from '../kernel-contracts.js';
+import type { LegacyEmbeddedPayloadGuardRecord } from './legacy-payload-guard.js';
+import type { StoredWorkroomEvent, WorkroomStoredEventControl, WorkroomStoredRunHeaders } from './contracts.js';
+export declare function legacyDatabaseJournalRecords(rows: readonly Record<string, unknown>[]): readonly LegacyEmbeddedPayloadGuardRecord[];
+export declare function materializeEvents(runId: string, expectedSequence: number, drafts: readonly WorkroomEventDraft[]): readonly WorkroomEvent[];
+export declare function parseStoredEvents(values: readonly unknown[]): readonly StoredWorkroomEvent[];
+export declare function isMissingFile(error: unknown): boolean;
+export declare function isSegmentName(name: string): boolean;
+export declare function isSegmentTemporaryName(name: string): boolean;
+export declare function segmentFirstSequence(name: string): number;
+export declare function toRow(event: StoredWorkroomEvent): Record<string, unknown>;
+export declare function parseStoredRows(runId: string, rows: readonly Record<string, unknown>[]): readonly StoredWorkroomEvent[];
+export declare function parseStoredRowGroups(rows: readonly Record<string, unknown>[]): ReadonlyMap<string, readonly StoredWorkroomEvent[]>;
+export declare function digestStoredWorkroomEvent(event: Readonly<{
+    version: 3;
+    eventId: string;
+    runId: string;
+    sequence: number;
+    occurredAt: number;
+    type: WorkroomEvent['type'];
+    control: WorkroomStoredEventControl;
+    payload: Readonly<Record<string, unknown>>;
+}>): string;
+export declare function digestWorkroomEventRowBinding(row: Readonly<Record<string, unknown>>): string;
+export declare function storedRunHeaders(runId: string, values: readonly StoredWorkroomEvent[]): WorkroomStoredRunHeaders;
+//# sourceMappingURL=event-codec.d.ts.map

package/lib/workroom/journal/event-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-codec.d.ts","sourceRoot":"","sources":["../../../src/workroom/journal/event-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwC,aAAa,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAQtH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,KAAK,EACV,mBAAmB,EAEnB,0BAA0B,EAG1B,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AAsBxB,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACvC,SAAS,gCAAgC,EAAE,CAgB7C;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,kBAAkB,EAAE,GACpC,SAAS,aAAa,EAAE,CAkB1B;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,mBAAmB,EAAE,CAgC5F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAErD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,SAAS,mBAAmB,EAAE,CAoDvH;AAQD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACvC,WAAW,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC,CAUrD;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,0BAA0B,CAAC;IACpC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC5C,CAAC,GAAG,MAAM,CAWV;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAY5F;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,mBAAmB,EAAE,GACrC,wBAAwB,CAyB1B"}

package/lib/workroom/journal/event-codec.js

@@ -0,0 +1,241 @@
+import { canonicalWorkroomJson, compareCanonicalWorkroomText, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue, } from '../canonical-value.js';
+import { assertExactRecordKeys, isFiniteNumber, isNonEmptyString, isRecord, isSequence, isWorkroomEventType, validatePayload, } from './event-validation.js';
+import { isDigest, legacyJournalPayloadError, validateProtectedPayload, } from './payload-reference.js';
+import { storedProtectedReceiptHeaders, validateStoredEventControl, } from './stored-event-projection.js';
+import { assertStoredEventReceiptBindings } from './payload-governance.js';
+export function legacyDatabaseJournalRecords(rows) {
+    return Object.freeze(rows.map(row => {
+        let envelope;
+        try {
+            envelope = JSON.parse(String(row.payload_json));
+        }
+        catch {
+            throw new Error('Legacy Workroom Journal database payload is corrupt or unsupported');
+        }
+        return Object.freeze({
+            recordRef: `workroom-events:${digestCanonicalWorkroomValue({
+                runId: String(row.run_id),
+                sequence: row.sequence,
+            })}`,
+            value: Object.freeze({ version: row.version, envelope }),
+        });
+    }));
+}
+export function materializeEvents(runId, expectedSequence, drafts) {
+    if (!isNonEmptyString(runId) || !Number.isSafeInteger(expectedSequence) || expectedSequence < -1) {
+        throw new Error('Invalid Workroom append position');
+    }
+    return Object.freeze(drafts.map((draft, index) => {
+        if (!isNonEmptyString(draft.eventId) || !isFiniteNumber(draft.occurredAt)
+            || !isWorkroomEventType(draft.type) || !isRecord(draft.payload)) {
+            throw new Error('Invalid Workroom event draft');
+        }
+        validatePayload(draft.type, draft.payload, expectedSequence + index + 1);
+        return Object.freeze({
+            ...draft,
+            version: 1,
+            runId,
+            sequence: expectedSequence + index + 1,
+            payload: Object.freeze({ ...draft.payload }),
+        });
+    }));
+}
+export function parseStoredEvents(values) {
+    const events = values.map((value) => {
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            throw new Error('Invalid Workroom journal event');
+        }
+        const raw = value;
+        if (raw.version === 1 || raw.version === 2)
+            throw legacyJournalPayloadError();
+        assertExactRecordKeys(raw, [
+            'version', 'eventId', 'runId', 'sequence', 'occurredAt', 'type', 'control', 'payload',
+        ], 'Stored Workroom event');
+        const event = value;
+        if (event.version !== 3 || !isNonEmptyString(event.eventId) || !isNonEmptyString(event.runId)
+            || !isSequence(event.sequence) || !isFiniteNumber(event.occurredAt)
+            || !isWorkroomEventType(event.type) || !isRecord(event.control) || !isRecord(event.payload)) {
+            throw new Error('Invalid Workroom journal event');
+        }
+        validateStoredEventControl(event.type, event.control);
+        validateProtectedPayload(event.type, event.payload);
+        const sequence = Number(event.sequence);
+        return Object.freeze({
+            ...event,
+            version: 3,
+            eventId: event.eventId,
+            runId: event.runId,
+            sequence,
+            occurredAt: event.occurredAt,
+            type: event.type,
+            control: deepFreeze({ ...event.control }),
+            payload: Object.freeze({ ...event.payload }),
+        });
+    });
+    return Object.freeze(events.sort((left, right) => left.sequence - right.sequence));
+}
+export function isMissingFile(error) {
+    return !!error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT';
+}
+export function isSegmentName(name) {
+    return /^[a-f0-9]{64}\.[0-9]{16}\.json$/u.test(name);
+}
+export function isSegmentTemporaryName(name) {
+    return /^[a-f0-9]{64}\.[0-9]{16}\.json\.[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}\.tmp$/u
+        .test(name);
+}
+export function segmentFirstSequence(name) {
+    if (!isSegmentName(name))
+        throw new Error('Invalid Workroom journal segment name');
+    const value = Number(name.slice(65, 81));
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error('Invalid Workroom journal segment first sequence');
+    }
+    return value;
+}
+export function toRow(event) {
+    const storedEventDigest = digestStoredWorkroomEvent(event);
+    const row = {
+        id: `${event.runId}:${event.sequence}`,
+        run_id: event.runId,
+        sequence: event.sequence,
+        version: event.version,
+        type: event.type,
+        payload_json: canonicalWorkroomJson({
+            eventId: event.eventId,
+            control: event.control,
+            payload: event.payload,
+        }),
+        occurred_at: event.occurredAt,
+        stored_event_digest: storedEventDigest,
+    };
+    return { ...row, row_binding_digest: digestWorkroomEventRowBinding(row) };
+}
+export function parseStoredRows(runId, rows) {
+    const events = rows.map(storedRow => {
+        const occurredAt = normalizeSafeInteger(storedRow.occurred_at);
+        const row = occurredAt === storedRow.occurred_at
+            ? storedRow
+            : { ...storedRow, occurred_at: occurredAt };
+        if (row.version === 1 || row.version === 2)
+            throw legacyJournalPayloadError();
+        if (!isDigest(row.stored_event_digest) || !isDigest(row.row_binding_digest)) {
+            throw legacyJournalPayloadError();
+        }
+        if (row.version !== 3)
+            throw new Error(`Unsupported Workroom event version: ${String(row.version)}`);
+        let envelope;
+        try {
+            envelope = JSON.parse(String(row.payload_json));
+        }
+        catch {
+            throw new Error('Invalid Workroom event payload JSON');
+        }
+        if (!envelope || !isNonEmptyString(envelope.eventId) || !isRecord(envelope.control)
+            || !isRecord(envelope.payload)
+            || !isSequence(row.sequence) || !isFiniteNumber(occurredAt)
+            || !isWorkroomEventType(row.type)) {
+            throw new Error('Invalid Workroom event payload envelope');
+        }
+        assertExactRecordKeys(envelope, ['eventId', 'control', 'payload'], 'Workroom event payload envelope');
+        const expectedId = `${runId}:${Number(row.sequence)}`;
+        if (row.id !== expectedId)
+            throw new Error('Workroom event row id binding is invalid');
+        if (String(row.payload_json) !== canonicalWorkroomJson(envelope)) {
+            throw new Error('Workroom event payload JSON is not canonical');
+        }
+        validateStoredEventControl(row.type, envelope.control);
+        validateProtectedPayload(row.type, envelope.payload);
+        const event = Object.freeze({
+            version: 3,
+            eventId: envelope.eventId,
+            runId,
+            sequence: row.sequence,
+            occurredAt,
+            type: row.type,
+            control: deepFreeze({ ...envelope.control }),
+            payload: Object.freeze({ ...envelope.payload }),
+        });
+        if (row.stored_event_digest !== digestStoredWorkroomEvent(event)) {
+            throw new Error('Workroom stored event digest mismatch');
+        }
+        if (row.row_binding_digest !== digestWorkroomEventRowBinding(row)) {
+            throw new Error('Workroom event row binding digest mismatch');
+        }
+        return event;
+    }).sort((left, right) => left.sequence - right.sequence);
+    const stored = Object.freeze(events);
+    if (stored.length > 0)
+        assertStoredEventReceiptBindings(stored);
+    return stored;
+}
+function normalizeSafeInteger(value) {
+    if (typeof value !== 'string' || !/^-?\d+$/u.test(value))
+        return value;
+    const number = Number(value);
+    return Number.isSafeInteger(number) ? number : value;
+}
+export function parseStoredRowGroups(rows) {
+    const rowGroups = new Map();
+    for (const row of rows) {
+        const runId = String(row.run_id ?? '');
+        if (!isNonEmptyString(runId))
+            throw new Error('Invalid Workroom event Run id');
+        rowGroups.set(runId, [...(rowGroups.get(runId) ?? []), row]);
+    }
+    return new Map([...rowGroups.entries()]
+        .sort(([left], [right]) => compareCanonicalWorkroomText(left, right))
+        .map(([runId, runRows]) => [runId, parseStoredRows(runId, runRows)]));
+}
+export function digestStoredWorkroomEvent(event) {
+    return digestCanonicalWorkroomValue({
+        version: event.version,
+        eventId: event.eventId,
+        runId: event.runId,
+        sequence: event.sequence,
+        occurredAt: event.occurredAt,
+        type: event.type,
+        control: event.control,
+        payload: event.payload,
+    });
+}
+export function digestWorkroomEventRowBinding(row) {
+    return digestCanonicalWorkroomValue({
+        version: 1,
+        id: row.id,
+        runId: row.run_id,
+        sequence: row.sequence,
+        storedVersion: row.version,
+        type: row.type,
+        payloadJson: row.payload_json,
+        occurredAt: row.occurred_at,
+        storedEventDigest: row.stored_event_digest,
+    });
+}
+export function storedRunHeaders(runId, values) {
+    if (!isNonEmptyString(runId) || values.length === 0
+        || values.some((event, index) => event.runId !== runId || event.sequence !== index)) {
+        throw new Error('Stored Workroom Journal header sequence or Run binding is invalid');
+    }
+    assertStoredEventReceiptBindings(values);
+    const events = values.map((event) => {
+        const protectedPayloadDigest = digestCanonicalWorkroomValue(event.payload);
+        const body = deepFreeze({
+            version: 1,
+            eventRef: `workroom-event:${digestCanonicalWorkroomValue({
+                runId, eventId: event.eventId, sequence: event.sequence,
+            })}`,
+            runId,
+            sequence: event.sequence,
+            occurredAt: event.occurredAt,
+            type: event.type,
+            control: event.control,
+            protectedPayloadDigest,
+            protectedReceipts: storedProtectedReceiptHeaders(event.payload),
+        });
+        return deepFreeze({ ...body, digest: digestCanonicalWorkroomValue(body) });
+    });
+    const body = deepFreeze({ version: 1, runId, events });
+    return deepFreeze({ ...body, digest: digestCanonicalWorkroomValue(body) });
+}
+//# sourceMappingURL=event-codec.js.map

package/lib/workroom/journal/event-codec.js.map

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

package/lib/workroom/journal/event-validation.d.ts

@@ -0,0 +1,10 @@
+import type { WorkroomEvent } from '../kernel-contracts.js';
+export declare function isWorkroomEventType(value: unknown): value is WorkroomEvent['type'];
+export declare function assertAllowedPayloadKeys(type: WorkroomEvent['type'], payload: Readonly<Record<string, unknown>>): void;
+export declare function validatePayload(type: WorkroomEvent['type'], payload: Readonly<Record<string, unknown>>, sequence: number): void;
+export declare function assertExactRecordKeys(value: Readonly<Record<string, unknown>>, expected: readonly string[], label: string): void;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function isNonEmptyString(value: unknown): value is string;
+export declare function isFiniteNumber(value: unknown): value is number;
+export declare function isSequence(value: unknown): value is number;
+//# sourceMappingURL=event-validation.d.ts.map