@nt-ai-lab/deterministic-agent-workflow-event-store 0.3.2 → 0.3.3

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export type { SqliteEventStore } from './platform/domain/sqlite-event-store';
 export { createStore, resolveSessionId, } from './platform/domain/sqlite-event-store';
 export type { SqliteDatabase, SqliteStatement, } from './platform/infra/external-clients/sqlite/sqlite-runtime';
 export { enableWalMode, openSqliteDatabase, } from './platform/infra/external-clients/sqlite/sqlite-runtime';
+export { buildReviewFilters } from './platform/domain/sqlite-review-storage';

package/dist/index.js

@@ -1,2 +1,3 @@
 export { createStore, resolveSessionId, } from './platform/domain/sqlite-event-store.js';
 export { enableWalMode, openSqliteDatabase, } from './platform/infra/external-clients/sqlite/sqlite-runtime.js';
+export { buildReviewFilters } from './platform/domain/sqlite-review-storage.js';

package/dist/platform/domain/sqlite-event-store.d.ts

@@ -1,4 +1,4 @@
-import type { RecordReflectionInput, StoredEvent, StoredReflection } from '@nt-ai-lab/deterministic-agent-workflow-engine';
+import type { ListedReview, RecordReviewInput, RecordReflectionInput, ReviewFilters, StoredEvent, StoredReflection, StoredReview } from '@nt-ai-lab/deterministic-agent-workflow-engine';
 import { type SqliteDatabase } from '../infra/external-clients/sqlite/sqlite-runtime';
 /** @riviere-role value-object */
 export type SqliteEventStore = {
@@ -8,6 +8,10 @@ export type SqliteEventStore = {
     readonly hasSessionStarted: (sessionId: string) => boolean;
     readonly recordReflection: (sessionId: string, createdAt: string, input: RecordReflectionInput) => StoredReflection;
     readonly listReflections: (sessionId: string) => readonly StoredReflection[];
+    readonly recordReview: (sessionId: string, createdAt: string, input: RecordReviewInput) => StoredReview;
+    readonly recordReviewWithEvent: (sessionId: string, createdAt: string, input: RecordReviewInput, eventState: string) => StoredReview;
+    readonly listSessionReviews: (sessionId: string) => readonly StoredReview[];
+    readonly listReviews: (filters: ReviewFilters) => readonly ListedReview[];
     readonly listSessions: () => readonly string[];
     readonly db: SqliteDatabase;
 };

package/dist/platform/domain/sqlite-event-store.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
-import { recordReflectionInputSchema, storedReflectionSchema, stripEnvelopeKeys, WorkflowStateError, } from '@nt-ai-lab/deterministic-agent-workflow-engine';
+import { recordReviewInputSchema, recordReflectionInputSchema, storedReflectionSchema, storedReviewSchema, stripEnvelopeKeys, WorkflowStateError, } from '@nt-ai-lab/deterministic-agent-workflow-engine';
 import { enableWalMode, openSqliteDatabase, } from '../infra/external-clients/sqlite/sqlite-runtime.js';
+import { buildReviewFilters, createReviewsBranchIndexSql, createReviewsPullRequestIndexSql, createReviewsSessionIndexSql, createReviewsTableSql, createReviewsTypeVerdictIndexSql, listedReviewRowsSchema, parseListedReviewRow, parseStoredReviewRow, reviewIdRowSchema, reviewRowsSchema, } from './sqlite-review-storage.js';
 const createTableSql = `
   CREATE TABLE IF NOT EXISTS events (
     seq INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -53,6 +54,11 @@ export function createStore(dbPath) {
     db.exec(createTableSql);
     db.exec(createReflectionsTableSql);
     db.exec(createReflectionsIndexSql);
+    db.exec(createReviewsTableSql);
+    db.exec(createReviewsSessionIndexSql);
+    db.exec(createReviewsTypeVerdictIndexSql);
+    db.exec(createReviewsBranchIndexSql);
+    db.exec(createReviewsPullRequestIndexSql);
     ensureStateColumn(db);
     return {
         db,
@@ -124,6 +130,91 @@ export function createStore(dbPath) {
                 });
             });
         },
+        recordReview(sessionId, createdAt, input) {
+            const parsedInput = recordReviewInputSchema.parse(input);
+            const insert = db.prepare('INSERT INTO reviews (session_id, created_at, review_type, verdict, branch, pull_request_number, source_state, payload_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?)');
+            db.exec('BEGIN IMMEDIATE');
+            try {
+                insert.run(sessionId, createdAt, parsedInput.reviewType, parsedInput.verdict, parsedInput.branch ?? null, parsedInput.pullRequestNumber ?? null, parsedInput.sourceState ?? null, JSON.stringify(parsedInput));
+                const rawId = db.prepare('SELECT last_insert_rowid() AS id').get();
+                const parsedId = reviewIdRowSchema.parse(rawId);
+                const id = Number(parsedId.id);
+                db.exec('COMMIT');
+                return storedReviewSchema.parse({
+                    id,
+                    sessionId,
+                    createdAt,
+                    ...parsedInput,
+                });
+            }
+            catch (error) {
+                db.exec('ROLLBACK');
+                throw error;
+            }
+        },
+        recordReviewWithEvent(sessionId, createdAt, input, eventState) {
+            const parsedInput = recordReviewInputSchema.parse(input);
+            const insertReview = db.prepare('INSERT INTO reviews (session_id, created_at, review_type, verdict, branch, pull_request_number, source_state, payload_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?)');
+            const insertEvent = db.prepare('INSERT INTO events (session_id, type, at, state, payload) VALUES (?, ?, ?, ?, ?)');
+            db.exec('BEGIN IMMEDIATE');
+            try {
+                insertReview.run(sessionId, createdAt, parsedInput.reviewType, parsedInput.verdict, parsedInput.branch ?? null, parsedInput.pullRequestNumber ?? null, parsedInput.sourceState ?? null, JSON.stringify(parsedInput));
+                const rawId = db.prepare('SELECT last_insert_rowid() AS id').get();
+                const parsedId = reviewIdRowSchema.parse(rawId);
+                const id = Number(parsedId.id);
+                insertEvent.run(sessionId, 'review-recorded', createdAt, eventState, JSON.stringify({
+                    reviewId: id,
+                    reviewType: parsedInput.reviewType,
+                    verdict: parsedInput.verdict,
+                }));
+                db.exec('COMMIT');
+                return storedReviewSchema.parse({
+                    id,
+                    sessionId,
+                    createdAt,
+                    ...parsedInput,
+                });
+            }
+            catch (error) {
+                db.exec('ROLLBACK');
+                throw error;
+            }
+        },
+        listSessionReviews(sessionId) {
+            const rawRows = db.prepare('SELECT id, session_id, created_at, review_type, verdict, branch, pull_request_number, source_state, payload_json FROM reviews WHERE session_id = ? ORDER BY created_at ASC, id ASC').all(sessionId);
+            const rows = reviewRowsSchema.parse(rawRows);
+            return rows.map(parseStoredReviewRow);
+        },
+        listReviews(filters) {
+            const parsedFilters = buildReviewFilters(filters);
+            const whereClause = parsedFilters.conditions.length === 0
+                ? ''
+                : `WHERE ${parsedFilters.conditions.join(' AND ')}`;
+            const rawRows = db.prepare(`
+        SELECT
+          reviews.id,
+          reviews.session_id,
+          reviews.created_at,
+          reviews.review_type,
+          reviews.verdict,
+          reviews.branch,
+          reviews.pull_request_number,
+          reviews.source_state,
+          reviews.payload_json,
+          (
+            SELECT json_extract(events.payload, '$.repository')
+            FROM events
+            WHERE events.session_id = reviews.session_id AND events.type = 'session-started'
+            ORDER BY events.seq ASC
+            LIMIT 1
+          ) AS repository
+        FROM reviews
+        ${whereClause}
+        ORDER BY reviews.created_at DESC, reviews.id DESC
+      `).all(...parsedFilters.parameters);
+            const rows = listedReviewRowsSchema.parse(rawRows);
+            return rows.map(parseListedReviewRow);
+        },
         listSessions() {
             const rawRows = db.prepare('SELECT session_id FROM events GROUP BY session_id ORDER BY MIN(seq)').all();
             return rowWithSessionIdSchema.parse(rawRows).map((row) => row.session_id);

package/dist/platform/domain/sqlite-review-storage.d.ts

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import type { ListedReview, ReviewFilters, StoredReview } from '@nt-ai-lab/deterministic-agent-workflow-engine';
+export declare const createReviewsTableSql = "\n  CREATE TABLE IF NOT EXISTS reviews (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    session_id TEXT NOT NULL,\n    created_at TEXT NOT NULL,\n    review_type TEXT NOT NULL,\n    verdict TEXT NOT NULL,\n    branch TEXT,\n    pull_request_number INTEGER,\n    source_state TEXT,\n    payload_json TEXT NOT NULL\n  )\n";
+export declare const createReviewsSessionIndexSql = "\n  CREATE INDEX IF NOT EXISTS idx_reviews_session_created_at\n  ON reviews (session_id, created_at ASC, id ASC)\n";
+export declare const createReviewsTypeVerdictIndexSql = "\n  CREATE INDEX IF NOT EXISTS idx_reviews_type_verdict\n  ON reviews (review_type, verdict)\n";
+export declare const createReviewsBranchIndexSql = "\n  CREATE INDEX IF NOT EXISTS idx_reviews_branch\n  ON reviews (branch)\n";
+export declare const createReviewsPullRequestIndexSql = "\n  CREATE INDEX IF NOT EXISTS idx_reviews_pull_request_number\n  ON reviews (pull_request_number)\n";
+export declare const reviewIdRowSchema: z.ZodObject<{
+    id: z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>;
+}, "strip", z.ZodTypeAny, {
+    id: string | number | bigint;
+}, {
+    id: string | number | bigint;
+}>;
+export declare const reviewRowsSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    session_id: z.ZodString;
+    created_at: z.ZodString;
+    review_type: z.ZodString;
+    verdict: z.ZodString;
+    branch: z.ZodNullable<z.ZodString>;
+    pull_request_number: z.ZodNullable<z.ZodNumber>;
+    source_state: z.ZodNullable<z.ZodString>;
+    payload_json: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    session_id: string;
+    created_at: string;
+    review_type: string;
+    verdict: string;
+    branch: string | null;
+    pull_request_number: number | null;
+    source_state: string | null;
+    payload_json: string;
+}, {
+    id: number;
+    session_id: string;
+    created_at: string;
+    review_type: string;
+    verdict: string;
+    branch: string | null;
+    pull_request_number: number | null;
+    source_state: string | null;
+    payload_json: string;
+}>, "many">;
+export declare const listedReviewRowsSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    session_id: z.ZodString;
+    created_at: z.ZodString;
+    review_type: z.ZodString;
+    verdict: z.ZodString;
+    branch: z.ZodNullable<z.ZodString>;
+    pull_request_number: z.ZodNullable<z.ZodNumber>;
+    source_state: z.ZodNullable<z.ZodString>;
+    payload_json: z.ZodString;
+    repository: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    session_id: string;
+    created_at: string;
+    review_type: string;
+    verdict: string;
+    branch: string | null;
+    pull_request_number: number | null;
+    source_state: string | null;
+    payload_json: string;
+    repository: string | null;
+}, {
+    id: number;
+    session_id: string;
+    created_at: string;
+    review_type: string;
+    verdict: string;
+    branch: string | null;
+    pull_request_number: number | null;
+    source_state: string | null;
+    payload_json: string;
+    repository: string | null;
+}>, "many">;
+/** @riviere-role value-object */
+export type ReviewRow = z.infer<typeof reviewRowsSchema>[number];
+/** @riviere-role value-object */
+export type ListedReviewRow = z.infer<typeof listedReviewRowsSchema>[number];
+/** @riviere-role domain-service */
+export declare function buildReviewFilters(filters: ReviewFilters): {
+    readonly conditions: ReadonlyArray<string>;
+    readonly parameters: ReadonlyArray<string | number>;
+};
+/** @riviere-role domain-service */
+export declare function parseStoredReviewRow(row: ReviewRow): StoredReview;
+/** @riviere-role domain-service */
+export declare function parseListedReviewRow(row: ListedReviewRow): ListedReview;

package/dist/platform/domain/sqlite-review-storage.js

@@ -0,0 +1,132 @@
+import { z } from 'zod';
+import { listedReviewSchema, recordReviewInputSchema, reviewFiltersSchema, storedReviewSchema, } from '@nt-ai-lab/deterministic-agent-workflow-engine';
+export const createReviewsTableSql = `
+  CREATE TABLE IF NOT EXISTS reviews (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id TEXT NOT NULL,
+    created_at TEXT NOT NULL,
+    review_type TEXT NOT NULL,
+    verdict TEXT NOT NULL,
+    branch TEXT,
+    pull_request_number INTEGER,
+    source_state TEXT,
+    payload_json TEXT NOT NULL
+  )
+`;
+export const createReviewsSessionIndexSql = `
+  CREATE INDEX IF NOT EXISTS idx_reviews_session_created_at
+  ON reviews (session_id, created_at ASC, id ASC)
+`;
+export const createReviewsTypeVerdictIndexSql = `
+  CREATE INDEX IF NOT EXISTS idx_reviews_type_verdict
+  ON reviews (review_type, verdict)
+`;
+export const createReviewsBranchIndexSql = `
+  CREATE INDEX IF NOT EXISTS idx_reviews_branch
+  ON reviews (branch)
+`;
+export const createReviewsPullRequestIndexSql = `
+  CREATE INDEX IF NOT EXISTS idx_reviews_pull_request_number
+  ON reviews (pull_request_number)
+`;
+export const reviewIdRowSchema = z.object({ id: z.union([z.number(), z.bigint(), z.string()]) });
+export const reviewRowsSchema = z.array(z.object({
+    id: z.number(),
+    session_id: z.string(),
+    created_at: z.string(),
+    review_type: z.string(),
+    verdict: z.string(),
+    branch: z.string().nullable(),
+    pull_request_number: z.number().nullable(),
+    source_state: z.string().nullable(),
+    payload_json: z.string(),
+}));
+export const listedReviewRowsSchema = z.array(z.object({
+    id: z.number(),
+    session_id: z.string(),
+    created_at: z.string(),
+    review_type: z.string(),
+    verdict: z.string(),
+    branch: z.string().nullable(),
+    pull_request_number: z.number().nullable(),
+    source_state: z.string().nullable(),
+    payload_json: z.string(),
+    repository: z.string().nullable(),
+}));
+const persistedReviewPayloadSchema = recordReviewInputSchema.passthrough();
+/** @riviere-role domain-service */
+export function buildReviewFilters(filters) {
+    const parsed = reviewFiltersSchema.parse(filters);
+    const conditions = [];
+    const parameters = [];
+    if (parsed.repository !== undefined) {
+        conditions.push(`(
+      SELECT json_extract(events.payload, '$.repository')
+      FROM events
+      WHERE events.session_id = reviews.session_id AND events.type = 'session-started'
+      ORDER BY events.seq ASC
+      LIMIT 1
+    ) = ?`);
+        parameters.push(parsed.repository);
+    }
+    if (parsed.branch !== undefined) {
+        conditions.push('reviews.branch = ?');
+        parameters.push(parsed.branch);
+    }
+    if (parsed.pullRequestNumber !== undefined) {
+        conditions.push('reviews.pull_request_number = ?');
+        parameters.push(parsed.pullRequestNumber);
+    }
+    if (parsed.reviewType !== undefined) {
+        conditions.push('reviews.review_type = ?');
+        parameters.push(parsed.reviewType);
+    }
+    if (parsed.verdict !== undefined) {
+        conditions.push('reviews.verdict = ?');
+        parameters.push(parsed.verdict);
+    }
+    return {
+        conditions,
+        parameters,
+    };
+}
+/** @riviere-role domain-service */
+export function parseStoredReviewRow(row) {
+    const parsedPayload = JSON.parse(row.payload_json);
+    return storedReviewSchema.parse({
+        ...parseReviewPayload(parsedPayload),
+        id: row.id,
+        sessionId: row.session_id,
+        createdAt: row.created_at,
+        reviewType: row.review_type,
+        verdict: row.verdict,
+        ...(row.branch === null ? {} : { branch: row.branch }),
+        ...(row.pull_request_number === null ? {} : { pullRequestNumber: row.pull_request_number }),
+        ...(row.source_state === null ? {} : { sourceState: row.source_state }),
+    });
+}
+/** @riviere-role domain-service */
+export function parseListedReviewRow(row) {
+    const parsedPayload = JSON.parse(row.payload_json);
+    return listedReviewSchema.parse({
+        ...parseReviewPayload(parsedPayload),
+        id: row.id,
+        sessionId: row.session_id,
+        createdAt: row.created_at,
+        reviewType: row.review_type,
+        verdict: row.verdict,
+        ...(row.branch === null ? {} : { branch: row.branch }),
+        ...(row.pull_request_number === null ? {} : { pullRequestNumber: row.pull_request_number }),
+        ...(row.source_state === null ? {} : { sourceState: row.source_state }),
+        ...(row.repository === null ? {} : { repository: row.repository }),
+    });
+}
+function parseReviewPayload(payload) {
+    const parsed = persistedReviewPayloadSchema.parse(payload);
+    return {
+        findings: parsed.findings,
+        ...(parsed.summary === undefined ? {} : { summary: parsed.summary }),
+        ...(parsed.branch === undefined ? {} : { branch: parsed.branch }),
+        ...(parsed.pullRequestNumber === undefined ? {} : { pullRequestNumber: parsed.pullRequestNumber }),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nt-ai-lab/deterministic-agent-workflow-event-store",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "private": false,
   "type": "module",
   "exports": {
@@ -12,7 +12,7 @@
   ],
   "dependencies": {
     "zod": "^3.25.76",
-    "@nt-ai-lab/deterministic-agent-workflow-engine": "0.3.2"
+    "@nt-ai-lab/deterministic-agent-workflow-engine": "0.3.3"
   },
   "publishConfig": {
     "access": "public"