@zhin.js/agent 1.1.23 → 1.1.27

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

@@ -0,0 +1,15 @@
+import type { WorkroomEvent, WorkroomEventDraft } from '../kernel-contracts.js';
+import type { GovernedPayloadPublicationVerification, GovernedPayloadWriteSagaSnapshot } from '../../data-governance/governed-payload-write-saga.js';
+import type { WorkroomJournal, WorkroomStoredRunHeaders } from './contracts.js';
+export declare class ActivatableWorkroomJournal implements WorkroomJournal {
+    #private;
+    get active(): boolean;
+    activate(delegate: WorkroomJournal): void;
+    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, events: readonly WorkroomEventDraft[]): Promise<readonly WorkroomEvent[]>;
+}
+//# sourceMappingURL=activatable-journal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activatable-journal.d.ts","sourceRoot":"","sources":["../../../src/workroom/journal/activatable-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;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAEhF,qBAAa,0BAA2B,YAAW,eAAe;;IAGhE,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAKzC,UAAU,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAIxC,iBAAiB,IAAI,OAAO,CAAC,SAAS,wBAAwB,EAAE,CAAC;IAIjE,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAI1E,gCAAgC,CAC9B,MAAM,EAAE,gCAAgC,GACvC,OAAO,CAAC,sCAAsC,CAAC;IAOlD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;IAItD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;CAQ1H"}

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

@@ -0,0 +1,39 @@
+import { deepFreezeWorkroomValue as deepFreeze } from '../canonical-value.js';
+export class ActivatableWorkroomJournal {
+    #delegate = null;
+    get active() {
+        return this.#delegate !== null;
+    }
+    activate(delegate) {
+        if (this.#delegate)
+            throw new Error('Workroom journal is already active');
+        this.#delegate = delegate;
+    }
+    listRunIds() {
+        return this.#require().listRunIds();
+    }
+    scanStoredHeaders() {
+        return this.#require().scanStoredHeaders();
+    }
+    readStoredHeaders(runId) {
+        return this.#require().readStoredHeaders(runId);
+    }
+    verifyGovernedPayloadPublication(intent) {
+        const delegate = this.#require();
+        return delegate.verifyGovernedPayloadPublication
+            ? delegate.verifyGovernedPayloadPublication(intent)
+            : Promise.resolve(deepFreeze({ status: 'unknown' }));
+    }
+    read(runId) {
+        return this.#require().read(runId);
+    }
+    append(runId, expectedSequence, events) {
+        return this.#require().append(runId, expectedSequence, events);
+    }
+    #require() {
+        if (!this.#delegate)
+            throw new Error('Workroom journal is not active');
+        return this.#delegate;
+    }
+}
+//# sourceMappingURL=activatable-journal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activatable-journal.js","sourceRoot":"","sources":["../../../src/workroom/journal/activatable-journal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,IAAI,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAO9E,MAAM,OAAO,0BAA0B;IACrC,SAAS,GAA2B,IAAI,CAAC;IAEzC,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;IACjC,CAAC;IAED,QAAQ,CAAC,QAAyB;QAChC,IAAI,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC1E,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,CAAC;IACtC,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,iBAAiB,EAAE,CAAC;IAC7C,CAAC;IAED,iBAAiB,CAAC,KAAa;QAC7B,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,gCAAgC,CAC9B,MAAwC;QAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,gCAAgC;YAC9C,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC,MAAM,CAAC;YACnD,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAkB,EAAE,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,gBAAwB,EAAE,MAAqC;QACnF,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}

package/lib/workroom/{journal.d.ts → journal/contracts.d.ts}

@@ -1,6 +1,6 @@
-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';
+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;
@@ -60,6 +60,19 @@ export interface WorkroomJournalPayloadPort {
 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;
@@ -111,7 +124,7 @@ export interface WorkroomStoredEventControl {
     readonly decision?: 'approve' | 'reject' | 'request_changes' | 'cancel';
     readonly newTaskRevision?: number;
 }
-type WorkroomAssignmentRoleHeader = 'executor' | 'reviewer' | 'integration';
+export type WorkroomAssignmentRoleHeader = 'executor' | 'reviewer' | 'integration';
 export interface WorkroomStoredProtectedReceiptHeader {
     readonly fieldPath: string;
     readonly contentHash: string;
@@ -125,95 +138,4 @@ export interface WorkroomStoredRunHeaders {
     readonly events: readonly WorkroomStoredEventHeader[];
     readonly digest: string;
 }
-export declare class MemoryWorkroomJournal implements WorkroomJournal {
-    #private;
-    constructor(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[]>;
-}
-/** In-memory authority used by the non-production Memory journal. */
-export declare class MemoryWorkroomJournalPayloadPort implements WorkroomJournalPayloadPort {
-    #private;
-    write(input: WorkroomJournalPayloadWriteInput): Promise<WorkroomGovernedPayloadReceipt>;
-    read(input: WorkroomJournalPayloadReadInput): Promise<unknown>;
-}
-/**
- * Durable append-only journal. Every committed batch is an immutable segment;
- * publishing its first sequence with an exclusive hard-link is the filesystem
- * CAS. Separate generation instances and separate processes therefore cannot
- * overwrite one another after reading the same expectedSequence.
- */
-export declare class FileWorkroomJournal implements WorkroomJournal {
-    #private;
-    constructor(directory: string, 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[]>;
-}
-/** Candidate-owned latch: no caller can observe a placeholder journal. */
-export declare class ActivatableWorkroomJournal implements WorkroomJournal {
-    #private;
-    get active(): boolean;
-    activate(delegate: WorkroomJournal): void;
-    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, events: readonly WorkroomEventDraft[]): Promise<readonly WorkroomEvent[]>;
-}
-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 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 createWorkroomJournalPayloadObjectId(input: Readonly<{
-    projectId: string;
-    runId: string;
-    eventId: string;
-    eventType: WorkroomEvent['type'];
-    occurredAt: number;
-    fieldPath: string;
-    contentHash: string;
-}>): string;
-export {};
-//# sourceMappingURL=journal.d.ts.map
+//# 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;CA+ErC"}

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

@@ -0,0 +1,118 @@
+import { deepFreezeWorkroomValue as deepFreeze } from '../canonical-value.js';
+import { assertActiveStoreHasNoLegacyEmbeddedPayload } from '../legacy-embedded-payload-migration.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({});
+            await assertActiveStoreHasNoLegacyEmbeddedPayload({
+                read: async () => 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({});
+                await assertActiveStoreHasNoLegacyEmbeddedPayload({
+                    read: async () => 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 { LegacyEmbeddedPayloadRecord } from '../legacy-embedded-payload-migration.js';
+import type { StoredWorkroomEvent, WorkroomStoredEventControl, WorkroomStoredRunHeaders } from './contracts.js';
+export declare function legacyDatabaseJournalRecords(rows: readonly Record<string, unknown>[]): readonly LegacyEmbeddedPayloadRecord[];
+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,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAC3F,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,2BAA2B,EAAE,CAkBxC;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"}