@auto-engineer/server-generator-apollo-emmett 1.147.0 → 1.149.0

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

@@ -141,4 +141,93 @@ describe('state.ts.ejs', () => {
       "
     `);
   });
+
+  it('should include Given state ref hints when specs use state refs', async () => {
+    const spec: SpecsSchema = {
+      variant: 'specs',
+      scenes: [
+        {
+          name: 'Profile scene',
+          moments: [
+            {
+              type: 'command',
+              name: 'Update profile',
+              stream: 'profile',
+              client: { specs: [] },
+              server: {
+                description: '',
+                specs: [
+                  {
+                    type: 'gherkin',
+                    feature: 'Update profile',
+                    rules: [
+                      {
+                        name: 'Should update profile',
+                        examples: [
+                          {
+                            name: 'Profile updated',
+                            steps: [
+                              {
+                                keyword: 'Given',
+                                text: 'CreatedProfile',
+                                docString: { userId: 'u1', status: 'created' },
+                              },
+                              {
+                                keyword: 'When',
+                                text: 'UpdateProfile',
+                                docString: { userId: 'u1', displayName: 'Alice' },
+                              },
+                              {
+                                keyword: 'Then',
+                                text: 'ProfileUpdated',
+                                docString: { userId: 'u1', displayName: 'Alice' },
+                              },
+                            ],
+                          },
+                        ],
+                      },
+                    ],
+                  },
+                ],
+              },
+            },
+          ],
+        },
+      ],
+      messages: [
+        {
+          type: 'state',
+          name: 'CreatedProfile',
+          fields: [
+            { name: 'userId', type: 'string', required: true },
+            { name: 'status', type: 'string', required: true },
+          ],
+        },
+        {
+          type: 'command',
+          name: 'UpdateProfile',
+          fields: [
+            { name: 'userId', type: 'string', required: true },
+            { name: 'displayName', type: 'string', required: true },
+          ],
+        },
+        {
+          type: 'event',
+          name: 'ProfileUpdated',
+          source: 'internal',
+          fields: [
+            { name: 'userId', type: 'string', required: true },
+            { name: 'displayName', type: 'string', required: true },
+          ],
+        },
+      ],
+    };
+
+    const { plans } = await generateScaffoldFilePlans(spec.scenes, spec.messages, undefined, 'src/domain/narratives');
+    const stateFile = plans.find((p) => p.outputPath.endsWith('state.ts'));
+    const contents = stateFile?.contents ?? '';
+
+    expect(contents).toContain('Given precondition states from specs');
+    expect(contents).toContain("status: 'created'");
+  });
 });

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

@@ -1,3 +1,16 @@
+<%
+const allGivenStateRefs = [];
+for (const [cmd, scenarios] of Object.entries(gwtMapping)) {
+    for (const s of scenarios) {
+        for (const g of (s.given || [])) {
+            if (!events.some(e => e.type === g.eventRef)) {
+                allGivenStateRefs.push(g);
+            }
+        }
+    }
+}
+const uniqueStatusValues = [...new Set(allGivenStateRefs.map(g => g.exampleData?.status).filter(Boolean))];
+-%>
 /**
 * ## IMPLEMENTATION INSTRUCTIONS ##
 *
@@ -40,6 +53,13 @@
 *
 * Note: Status string literals should match your schema's enum values (usually snake_case).
 * If an enum is defined in domain/shared/types.ts, reference the enum type instead of literals.
+<% if (uniqueStatusValues.length > 0) { -%>
+*
+* Given precondition states from specs (your State MUST include a variant for each):
+<% for (const status of uniqueStatusValues) { -%>
+*   - status: '<%= status %>'
+<% } -%>
+<% } -%>
 */
 
 // TODO: Replace with a discriminated union of domain states for the current slice