@auto-engineer/server-generator-apollo-emmett 1.138.0 → 1.140.0

package/src/codegen/templates/command/register.specs.ts

@@ -6,10 +6,10 @@ describe('generateScaffoldFilePlans', () => {
   it('should generate a valid register file', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
           name: 'Host creates a listing',
-          slices: [
+          moments: [
             {
               type: 'command',
               name: 'Create listing',
@@ -105,7 +105,7 @@ describe('generateScaffoldFilePlans', () => {
       ],
     };
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const registerFile = plans.find((p) => p.outputPath.endsWith('register.ts'));
 
     expect(registerFile?.contents).toMatchInlineSnapshot(`

package/src/codegen/templates/command/state.specs.ts

@@ -6,10 +6,10 @@ describe('state.ts.ejs', () => {
   it('should generate an initial state', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
           name: 'Host creates a listing',
-          slices: [
+          moments: [
             {
               type: 'command',
               name: 'Create listing',
@@ -83,7 +83,7 @@ describe('state.ts.ejs', () => {
       ],
     };
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const stateFile = plans.find((p) => p.outputPath.endsWith('state.ts'));
 
     expect(stateFile?.contents).toMatchInlineSnapshot(`

package/src/codegen/templates/query/events.specs.ts

@@ -6,10 +6,10 @@ describe('query events.ts.ejs', () => {
   it('generates events.ts for orphan events not produced by any command slice', async () => {
     const spec: Model = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'appointment-flow',
-          slices: [
+          name: 'appointment-scene',
+          moments: [
             {
               type: 'query',
               name: 'view-appointments',
@@ -89,7 +89,7 @@ describe('query events.ts.ejs', () => {
       ],
     };
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
 
     const eventFile = plans.find((p) => p.outputPath.endsWith('view-appointments/events.ts'));
     expect(eventFile).toBeDefined();

package/src/codegen/templates/query/projection.specs.specs.ts

@@ -6,10 +6,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should generate a valid test spec for a query slice projection', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'listing-flow',
-          slices: [
+          name: 'listing-scene',
+          moments: [
             {
               type: 'command',
               name: 'CreateListing',
@@ -192,7 +192,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     } as SpecsSchema;
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const specFile = plans.find((p) => p.outputPath.endsWith('projection.specs.ts'));
 
     expect(specFile?.contents).toMatchInlineSnapshot(`
@@ -253,10 +253,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should generate a valid test spec for a model with given/when/then pattern', async () => {
     const questionnaireSpec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
           name: 'Questionnaires',
-          slices: [
+          moments: [
             {
               name: 'views the questionnaire',
               type: 'query',
@@ -379,10 +379,10 @@ describe('projection.specs.ts.ejs', () => {
     } as SpecsSchema;
 
     const { plans } = await generateScaffoldFilePlans(
-      questionnaireSpec.narratives,
+      questionnaireSpec.scenes,
       questionnaireSpec.messages,
       undefined,
-      'src/domain/flows',
+      'src/domain/narratives',
     );
     const specFile = plans.find((p) => p.outputPath.endsWith('projection.specs.ts'));
 
@@ -396,10 +396,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should include all events from both given and when clauses in projection imports and types', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
           name: 'questionnaires',
-          slices: [
+          moments: [
             {
               type: 'command',
               name: 'sends-the-questionnaire-link',
@@ -599,7 +599,7 @@ describe('projection.specs.ts.ejs', () => {
     } as SpecsSchema;
 
     const { plans } = await generateScaffoldFilePlans(
-      spec.narratives,
+      spec.scenes,
       [
         {
           type: 'command',
@@ -622,7 +622,7 @@ describe('projection.specs.ts.ejs', () => {
         ...spec.messages,
       ],
       undefined,
-      'src/domain/flows',
+      'src/domain/narratives',
     );
 
     // Check projection.specs.ts file
@@ -654,10 +654,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should generate a valid test spec for singleton projection', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'todo-flow',
-          slices: [
+          name: 'todo-scene',
+          moments: [
             {
               type: 'command',
               name: 'manage-todo',
@@ -787,7 +787,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     } as SpecsSchema;
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const specFile = plans.find((p) => p.outputPath.endsWith('view-summary/projection.specs.ts'));
 
     expect(specFile?.contents).toMatchInlineSnapshot(`
@@ -839,10 +839,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should generate a valid test spec for composite key projection', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'user-project-flow',
-          slices: [
+          name: 'user-project-scene',
+          moments: [
             {
               type: 'command',
               name: 'manage-user-project',
@@ -983,7 +983,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     } as SpecsSchema;
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const specFile = plans.find((p) => p.outputPath.endsWith('view-user-projects/projection.specs.ts'));
 
     expect(specFile?.contents).toMatchInlineSnapshot(`
@@ -1040,10 +1040,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should generate empty when array for query action in projection.specs.ts', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'workout-flow',
-          slices: [
+          name: 'workout-scene',
+          moments: [
             {
               type: 'command',
               name: 'log-workout',
@@ -1162,7 +1162,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     } as SpecsSchema;
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const specFile = plans.find((p) => p.outputPath.endsWith('view-workout-history/projection.specs.ts'));
 
     expect(specFile?.contents).toMatchInlineSnapshot(`
@@ -1216,10 +1216,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should exclude query arg fields that differ from projection-computed values', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'fart-flow',
-          slices: [
+          name: 'fart-scene',
+          moments: [
             {
               type: 'command',
               name: 'log-fart',
@@ -1363,7 +1363,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     } as SpecsSchema;
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const specFile = plans.find((p) => p.outputPath.endsWith('view-fart-history/projection.specs.ts'));
 
     expect(specFile?.contents).toMatchInlineSnapshot(`
@@ -1434,10 +1434,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should serialize inline objects and arrays with Date sub-fields correctly', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'fitness-flow',
-          slices: [
+          name: 'fitness-scene',
+          moments: [
             {
               type: 'command',
               name: 'record-session',
@@ -1572,7 +1572,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     } as SpecsSchema;
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const specFile = plans.find((p) => p.outputPath.endsWith('view-member-stats/projection.specs.ts'));
 
     expect(specFile?.contents).toMatchInlineSnapshot(`
@@ -1630,10 +1630,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should generate valid projection.ts when When clause is a query action (QueryActionRef)', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'workout-flow',
-          slices: [
+          name: 'workout-scene',
+          moments: [
             {
               type: 'command',
               name: 'log-workout',
@@ -1758,7 +1758,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     } as SpecsSchema;
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const projectionFile = plans.find((p) => p.outputPath.endsWith('view-workout-history/projection.ts'));
 
     expect(projectionFile?.contents).toMatchInlineSnapshot(`
@@ -1839,10 +1839,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should include ...document spread in non-removal evolve cases', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'item-flow',
-          slices: [
+          name: 'item-scene',
+          moments: [
             {
               type: 'command',
               name: 'manage-item',
@@ -2003,7 +2003,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     } as SpecsSchema;
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const projectionFile = plans.find((p) => p.outputPath.endsWith('view-items/projection.ts'));
     expect(projectionFile?.contents).toBeDefined();
 
@@ -2020,10 +2020,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should warn when events lack the idField used by getDocumentId', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'order-flow',
-          slices: [
+          name: 'order-scene',
+          moments: [
             {
               type: 'command',
               name: 'manage-order',
@@ -2191,7 +2191,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     } as SpecsSchema;
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const projectionFile = plans.find((p) => p.outputPath.endsWith('view-orders/projection.ts'));
     expect(projectionFile?.contents).toBeDefined();
 
@@ -2202,10 +2202,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should parse stringified JSON arrays in docString values for array-typed fields', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'appointment-flow',
-          slices: [
+          name: 'appointment-scene',
+          moments: [
             {
               type: 'command',
               name: 'book-appointment',
@@ -2317,7 +2317,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     } as SpecsSchema;
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const specFile = plans.find((p) => p.outputPath.endsWith('view-appointments/projection.specs.ts'));
 
     expect(specFile?.contents).toContain("appointmentId: 'appt_789'");
@@ -2328,10 +2328,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should serialize array values correctly when event field is missing from schema', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'fitness-flow',
-          slices: [
+          name: 'fitness-scene',
+          moments: [
             {
               type: 'command',
               name: 'update-leaderboard',
@@ -2437,7 +2437,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     };
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const specFile = plans.find((p) => p.outputPath.endsWith('view-leaderboard/projection.specs.ts'));
 
     expect(specFile?.contents).not.toContain('[object Object]');
@@ -2447,10 +2447,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should resolve idField value from Given/When events when not in Then state data', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'fitness-flow',
-          slices: [
+          name: 'fitness-scene',
+          moments: [
             {
               type: 'command',
               name: 'log-workout',
@@ -2565,7 +2565,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     } as SpecsSchema;
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const specFile = plans.find((p) => p.outputPath.endsWith('view-workout-summary/projection.specs.ts'));
 
     expect(specFile?.contents).toMatchInlineSnapshot(`
@@ -2620,10 +2620,10 @@ describe('projection.specs.ts.ejs', () => {
   it('should escape apostrophes in rule names and test descriptions', async () => {
     const spec: SpecsSchema = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'workout-flow',
-          slices: [
+          name: 'workout-scene',
+          moments: [
             {
               type: 'command',
               name: 'log-workout',
@@ -2735,7 +2735,7 @@ describe('projection.specs.ts.ejs', () => {
       ],
     } as SpecsSchema;
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const specFile = plans.find((p) => p.outputPath.endsWith('view-user-workouts/projection.specs.ts'));
 
     expect(specFile?.contents).toContain('describe("List of user\'s workouts"');

package/src/codegen/templates/query/projection.specs.ts

@@ -4,12 +4,12 @@ import { generateScaffoldFilePlans } from '../../scaffoldFromSchema';
 
 describe('projection.ts.ejs', () => {
   it('should generate a valid projection file with correct relative event import path from producing slice', async () => {
-    const flows: Model = {
+    const scenes: Model = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'listing-flow',
-          slices: [
+          name: 'listing-scene',
+          moments: [
             {
               type: 'command',
               name: 'create-listing',
@@ -213,7 +213,12 @@ describe('projection.ts.ejs', () => {
       ],
     };
 
-    const { plans } = await generateScaffoldFilePlans(flows.narratives, flows.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(
+      scenes.scenes,
+      scenes.messages,
+      undefined,
+      'src/domain/narratives',
+    );
     const projectionFile = plans.find((p) => p.outputPath.endsWith('projection.ts'));
 
     expect(projectionFile?.contents).toMatchInlineSnapshot(`
@@ -321,10 +326,10 @@ describe('projection.ts.ejs', () => {
   it('should generate a valid query resolver using ID type', async () => {
     const spec: Model = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'wishlist-flow',
-          slices: [
+          name: 'wishlist-scene',
+          moments: [
             {
               type: 'query',
               name: 'view-wishlist',
@@ -374,7 +379,7 @@ describe('projection.ts.ejs', () => {
       ],
     };
 
-    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
     const resolverFile = plans.find((p) => p.outputPath.endsWith('query.resolver.ts'));
 
     expect(resolverFile?.contents).toMatchInlineSnapshot(`
@@ -421,12 +426,12 @@ describe('projection.ts.ejs', () => {
   });
 
   it('should generate a valid singleton projection file', async () => {
-    const flows: Model = {
+    const scenes: Model = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'todo-flow',
-          slices: [
+          name: 'todo-scene',
+          moments: [
             {
               type: 'command',
               name: 'manage-todo',
@@ -560,7 +565,12 @@ describe('projection.ts.ejs', () => {
       ],
     };
 
-    const { plans } = await generateScaffoldFilePlans(flows.narratives, flows.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(
+      scenes.scenes,
+      scenes.messages,
+      undefined,
+      'src/domain/narratives',
+    );
     const projectionFile = plans.find((p) => p.outputPath.endsWith('view-summary/projection.ts'));
 
     expect(projectionFile?.contents).toMatchInlineSnapshot(`
@@ -649,12 +659,12 @@ describe('projection.ts.ejs', () => {
   });
 
   it('should generate a valid composite key projection file', async () => {
-    const flows: Model = {
+    const scenes: Model = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'user-project-flow',
-          slices: [
+          name: 'user-project-scene',
+          moments: [
             {
               type: 'command',
               name: 'manage-user-project',
@@ -799,7 +809,12 @@ describe('projection.ts.ejs', () => {
       ],
     };
 
-    const { plans } = await generateScaffoldFilePlans(flows.narratives, flows.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(
+      scenes.scenes,
+      scenes.messages,
+      undefined,
+      'src/domain/narratives',
+    );
     const projectionFile = plans.find((p) => p.outputPath.endsWith('view-user-projects/projection.ts'));
 
     expect(projectionFile?.contents).toMatchInlineSnapshot(`
@@ -878,12 +893,12 @@ describe('projection.ts.ejs', () => {
   });
 
   it('should not treat mixed union type with quotes as enum import', async () => {
-    const flows: Model = {
+    const scenes: Model = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'order-flow',
-          slices: [
+          name: 'order-scene',
+          moments: [
             {
               type: 'command',
               name: 'place-order',
@@ -1002,7 +1017,12 @@ describe('projection.ts.ejs', () => {
       ],
     };
 
-    const { plans } = await generateScaffoldFilePlans(flows.narratives, flows.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(
+      scenes.scenes,
+      scenes.messages,
+      undefined,
+      'src/domain/narratives',
+    );
     const projectionFile = plans.find((p) => p.outputPath.endsWith('view-order-status/projection.ts'));
 
     expect(projectionFile?.contents).not.toContain('number | "pending"');
@@ -1010,12 +1030,12 @@ describe('projection.ts.ejs', () => {
   });
 
   it('should generate switch-based getDocumentId when events come from slices with different id fields', async () => {
-    const flows: Model = {
+    const scenes: Model = {
       variant: 'specs',
-      narratives: [
+      scenes: [
         {
-          name: 'workout-flow',
-          slices: [
+          name: 'workout-scene',
+          moments: [
             {
               type: 'command',
               name: 'create-workout',
@@ -1196,7 +1216,12 @@ describe('projection.ts.ejs', () => {
       ],
     };
 
-    const { plans } = await generateScaffoldFilePlans(flows.narratives, flows.messages, undefined, 'src/domain/flows');
+    const { plans } = await generateScaffoldFilePlans(
+      scenes.scenes,
+      scenes.messages,
+      undefined,
+      'src/domain/narratives',
+    );
     const projectionFile = plans.find((p) => p.outputPath.endsWith('view-workout/projection.ts'));
 
     expect(projectionFile?.contents).toMatchInlineSnapshot(`

package/src/codegen/templates/query/projection.specs.ts.ejs

@@ -109,7 +109,7 @@ if (Array.isArray(slice?.server?.specs)) {
     for (const spec of slice.server.specs) {
         const rules = spec.rules || [];
         for (const rule of rules) {
-            const ruleDescription = rule.name || `${flowName} | ${sliceName}`;
+            const ruleDescription = rule.name || `${sceneName} | ${momentName}`;
             if (!ruleGroups.has(ruleDescription)) {
                 ruleGroups.set(ruleDescription, []);
             }
@@ -139,7 +139,7 @@ if (Array.isArray(slice?.server?.specs)) {
 } else {
     const rules = slice?.server?.specs?.rules || [];
     for (const rule of rules) {
-        const ruleDescription = rule.description || `${flowName} | ${sliceName}`;
+        const ruleDescription = rule.description || `${sceneName} | ${momentName}`;
         if (!ruleGroups.has(ruleDescription)) {
             ruleGroups.set(ruleDescription, []);
         }