@nt-ai-lab/deterministic-agent-workflow-engine 0.3.5 → 0.4.0

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { reflectionCategorySchema, reflectionConfidenceSchema, reflectionEvidenc
 export type { ReflectionCategory, ReflectionEvidence, ReflectionFinding, ReflectionPayload, RecordReflectionInput, StoredReflection, } from './platform/domain/reflection-types';
 export { reviewTypeSchema, reviewVerdictSchema, reviewFindingSeveritySchema, reviewFindingStatusSchema, reviewFindingSchema, reviewPayloadSchema, recordReviewInputSchema, storedReviewSchema, listedReviewSchema, reviewFiltersSchema, } from './platform/domain/review-types';
 export type { ReviewType, ReviewVerdict, ReviewFindingSeverity, ReviewFindingStatus, ReviewFinding, ReviewPayload, RecordReviewInput, StoredReview, ListedReview, ReviewFilters, } from './platform/domain/review-types';
-export { engineEventSchema } from './platform/domain/engine-events';
+export { engineEventSchema, reviewRecordedEventSchema, } from './platform/domain/engine-events';
 export type { EngineEvent, SessionStartedEvent, TransitionedEvent, AgentRegisteredEvent, AgentShutDownEvent, JournalEntryEvent, WriteCheckedEvent, BashCheckedEvent, PluginReadCheckedEvent, IdleCheckedEvent, IdentityVerifiedEvent, ContextRequestedEvent, ReviewRecordedEvent, } from './platform/domain/engine-events';
 export { isPlatformOwnedEventExcludedFromWorkflowState } from './platform/domain/engine-events';
 export { reduceWorkflowStateFromStoredEvents } from './platform/domain/workflow-state-reducer';

package/dist/index.js

@@ -3,7 +3,7 @@ export { baseEventSchema } from './platform/domain/base-event.js';
 export { flattenStoredEvent, stripEnvelopeKeys, toPayload, } from './platform/domain/stored-event.js';
 export { reflectionCategorySchema, reflectionConfidenceSchema, reflectionEvidenceSchema, reflectionFindingSchema, reflectionPayloadSchema, recordReflectionInputSchema, storedReflectionSchema, } from './platform/domain/reflection-types.js';
 export { reviewTypeSchema, reviewVerdictSchema, reviewFindingSeveritySchema, reviewFindingStatusSchema, reviewFindingSchema, reviewPayloadSchema, recordReviewInputSchema, storedReviewSchema, listedReviewSchema, reviewFiltersSchema, } from './platform/domain/review-types.js';
-export { engineEventSchema } from './platform/domain/engine-events.js';
+export { engineEventSchema, reviewRecordedEventSchema, } from './platform/domain/engine-events.js';
 export { isPlatformOwnedEventExcludedFromWorkflowState } from './platform/domain/engine-events.js';
 export { reduceWorkflowStateFromStoredEvents } from './platform/domain/workflow-state-reducer.js';
 export { repositoryMetadataEventSchema } from './platform/domain/repository-tracking-events.js';

package/dist/platform/domain/engine-events.d.ts

@@ -208,7 +208,7 @@ declare const contextRequestedSchema: z.ZodObject<{
     at: string;
     agentName: string;
 }>;
-declare const reviewRecordedSchema: z.ZodObject<{
+export declare const reviewRecordedEventSchema: z.ZodObject<{
     type: z.ZodLiteral<"review-recorded">;
     at: z.ZodString;
     reviewId: z.ZodNumber;
@@ -471,5 +471,5 @@ export type IdentityVerifiedEvent = z.infer<typeof identityVerifiedSchema>;
 /** @riviere-role value-object */
 export type ContextRequestedEvent = z.infer<typeof contextRequestedSchema>;
 /** @riviere-role value-object */
-export type ReviewRecordedEvent = z.infer<typeof reviewRecordedSchema>;
+export type ReviewRecordedEvent = z.infer<typeof reviewRecordedEventSchema>;
 export {};

package/dist/platform/domain/engine-events.js

@@ -76,7 +76,7 @@ const contextRequestedSchema = z.object({
     at: z.string(),
     agentName: z.string(),
 });
-const reviewRecordedSchema = z.object({
+export const reviewRecordedEventSchema = z.object({
     type: z.literal('review-recorded'),
     at: z.string(),
     reviewId: z.number().int().positive(),
@@ -95,7 +95,7 @@ export const engineEventSchema = z.discriminatedUnion('type', [
     idleCheckedSchema,
     identityVerifiedSchema,
     contextRequestedSchema,
-    reviewRecordedSchema,
+    reviewRecordedEventSchema,
 ]);
 const platformOwnedEventTypesExcludedFromWorkflowState = new Set([
     'agent-registered',
@@ -107,7 +107,6 @@ const platformOwnedEventTypesExcludedFromWorkflowState = new Set([
     'idle-checked',
     'identity-verified',
     'context-requested',
-    'review-recorded',
 ]);
 /** @riviere-role domain-service */
 export function isPlatformOwnedEventExcludedFromWorkflowState(type) {

package/dist/platform/domain/workflow-engine.spec.js

@@ -1,9 +1,18 @@
 import { describe, expect, it, } from 'vitest';
 import { z } from 'zod';
-import { pass, WorkflowEngine, WorkflowStateError, } from '../../index.js';
+import { flattenStoredEvent, pass, reduceWorkflowStateFromStoredEvents, reviewRecordedEventSchema, WorkflowEngine, WorkflowStateError, } from '../../index.js';
 function isSessionStartedEvent(event) {
     return event.type === 'session-started';
 }
+function allowAgentRegistration(agentType, agentId) {
+    void agentType;
+    void agentId;
+    return pass();
+}
+function allowIdleCheck(agentName) {
+    void agentName;
+    return pass();
+}
 class StrictPlanningWorkflow {
     state;
     pendingEvents;
@@ -45,13 +54,40 @@ class StrictPlanningWorkflow {
         return this.state.transcriptPath;
     }
     registerAgent(agentType, agentId) {
-        void agentType;
-        void agentId;
-        return pass();
+        return allowAgentRegistration(agentType, agentId);
+    }
+    handleTeammateIdle(agentName) {
+        return allowIdleCheck(agentName);
+    }
+}
+class ReviewTrackingWorkflow {
+    state;
+    constructor(state) {
+        this.state = state;
+    }
+    getState() {
+        return this.state;
+    }
+    appendEvent(event) {
+        void event;
+        throw new WorkflowStateError('appendEvent is not used in this test');
+    }
+    getPendingEvents() {
+        return [];
+    }
+    startSession(transcriptPath, repository) {
+        void transcriptPath;
+        void repository;
+        throw new WorkflowStateError('startSession is not used in this test');
+    }
+    getTranscriptPath() {
+        return '';
+    }
+    registerAgent(agentType, agentId) {
+        return allowAgentRegistration(agentType, agentId);
     }
     handleTeammateIdle(agentName) {
-        void agentName;
-        return pass();
+        return allowIdleCheck(agentName);
     }
 }
 class InMemoryWorkflowEventStore {
@@ -147,6 +183,62 @@ const workflowDefinition = {
         };
     },
 };
+const reviewTrackingWorkflowDefinition = {
+    fold(state, event) {
+        const reviewRecordedEvent = reviewRecordedEventSchema.parse(event);
+        if (reviewRecordedEvent.reviewType !== 'code-review') {
+            return state;
+        }
+        return {
+            ...state,
+            codeReviewPassed: reviewRecordedEvent.verdict === 'PASS',
+        };
+    },
+    buildWorkflow(state) {
+        return new ReviewTrackingWorkflow(state);
+    },
+    stateSchema: z.literal('REVIEWING'),
+    initialState() {
+        return {
+            currentStateMachineState: 'REVIEWING',
+            codeReviewPassed: false,
+        };
+    },
+    getRegistry() {
+        return {
+            REVIEWING: {
+                emoji: '🔎',
+                agentInstructions: 'states/reviewing.md',
+                canTransitionTo: [],
+                allowedWorkflowOperations: ['record-review'],
+            },
+        };
+    },
+    buildTransitionContext(state, from, to) {
+        return {
+            state,
+            from,
+            to,
+            gitInfo: {
+                currentBranch: 'main',
+                workingTreeClean: true,
+                headCommit: 'abc123',
+                changedFilesVsDefault: [],
+                hasCommitsVsDefault: false,
+            },
+        };
+    },
+};
+function buildStoredEvent(type, at, state, payload) {
+    return {
+        envelope: {
+            type,
+            at,
+            state,
+        },
+        payload,
+    };
+}
 function createEngine() {
     const store = new InMemoryWorkflowEventStore();
     const engineDeps = {
@@ -190,4 +282,24 @@ describe('WorkflowEngine platform-owned events', () => {
             'write-checked',
         ]);
     });
+    it('keeps review-recorded available to consumer workflow state reconstruction', () => {
+        const storedEvents = [buildStoredEvent('review-recorded', '2026-01-01T00:01:00Z', 'REVIEWING', {
+                reviewId: 7,
+                reviewType: 'code-review',
+                verdict: 'PASS',
+            })];
+        const state = reduceWorkflowStateFromStoredEvents(reviewTrackingWorkflowDefinition, storedEvents);
+        const flattenedEvent = flattenStoredEvent(storedEvents[0]);
+        expect(reviewRecordedEventSchema.parse(flattenedEvent)).toStrictEqual({
+            type: 'review-recorded',
+            at: '2026-01-01T00:01:00Z',
+            reviewId: 7,
+            reviewType: 'code-review',
+            verdict: 'PASS',
+        });
+        expect(state).toStrictEqual({
+            currentStateMachineState: 'REVIEWING',
+            codeReviewPassed: true,
+        });
+    });
 });

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "@nt-ai-lab/deterministic-agent-workflow-engine",
-  "version": "0.3.5",
+  "version": "0.4.0",
   "private": false,
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NTCoding/deterministic-agent-workflows.git",
+    "directory": "packages/deterministic-agent-workflows-engine"
+  },
   "exports": {
     ".": "./dist/index.js"
   },