create-auto-app 0.3.0 → 0.8.5

package/templates/shopping-app/flows/shopping-assistant.flow.ts

@@ -3,11 +3,10 @@ import {
   querySlice,
   reactSlice,
   flow,
-  createBuilders,
   should,
-  given,
-  when,
   specs,
+  rule,
+  example,
   gql,
   source,
   data,
@@ -17,7 +16,7 @@ import {
   type State,
 } from '@auto-engineer/flow';
 
-import { AI, ProductCatalog, type DoChat, type ChatCompleted, type Products } from '../server/src/integrations';
+import { AI, ProductCatalog, type Products } from '../server/src/integrations';
 
 type ShoppingCriteriaEntered = Event<
   'ShoppingCriteriaEntered',
@@ -77,13 +76,7 @@ type AddItemsToCart = Command<
   }
 >;
 
-const { Events, Commands, State } = createBuilders()
-  .events<ShoppingCriteriaEntered | ShoppingItemsSuggested | ChatCompleted | ItemsAddedToCart>()
-  .commands<EnterShoppingCriteria | SuggestShoppingItems | DoChat | AddItemsToCart>()
-  .state<{
-    Products: Products['data'];
-    SuggestedItems: SuggestedItems['data'];
-  }>();
+// Using generic DSL instead of typed builders
 
 flow('Seasonal Assistant', () => {
   commandSlice('enters shopping criteria into assistant')
@@ -111,43 +104,49 @@ flow('Seasonal Assistant', () => {
     .server(() => {
       data([sink().event('ShoppingCriteriaEntered').toStream('shopping-session-${sessionId}')]);
       specs('When shopper submits criteria, a shopping session is started', () => {
-        when(
-          Commands.EnterShoppingCriteria({
-            sessionId: 'shopper-123',
-            criteria:
-              'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
-          }),
-        ).then([
-          Events.ShoppingCriteriaEntered({
-            sessionId: 'shopper-123',
-            criteria:
-              'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
-            timestamp: new Date(),
-          }),
-        ]);
+        rule('Valid criteria should start a shopping session', () => {
+          example('User submits shopping criteria for children')
+            .when<EnterShoppingCriteria>({
+              sessionId: 'shopper-123',
+              criteria:
+                'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
+            })
+            .then<ShoppingCriteriaEntered>([
+              {
+                sessionId: 'shopper-123',
+                criteria:
+                  'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
+                timestamp: new Date(),
+              },
+            ]);
+        });
       });
     });
 
-  reactSlice('creates a chat session ').server(() => {
+  reactSlice('creates a chat session').server(() => {
     specs('When shopping criteria are entered, request wishlist creation', () => {
-      when([
-        Events.ShoppingCriteriaEntered({
-          sessionId: 'session-abc',
-          criteria:
-            'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
-          timestamp: new Date(),
-        }),
-      ]).then([
-        Commands.SuggestShoppingItems({
-          sessionId: 'session-abc',
-          prompt:
-            'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
-        }),
-      ]);
+      rule('Shopping criteria should trigger item suggestion', () => {
+        example('Criteria entered triggers wishlist creation')
+          .when<ShoppingCriteriaEntered>([
+            {
+              sessionId: 'session-abc',
+              criteria:
+                'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
+              timestamp: new Date(),
+            },
+          ])
+          .then<SuggestShoppingItems>([
+            {
+              sessionId: 'session-abc',
+              prompt:
+                'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
+            },
+          ]);
+      });
     });
   });
 
-  commandSlice('selects items relevant to the shopping criteria ').server(() => {
+  commandSlice('selects items relevant to the shopping criteria').server(() => {
     data([
       sink()
         .command('SuggestShoppingItems')
@@ -160,82 +159,83 @@ flow('Seasonal Assistant', () => {
     ]);
 
     specs('When chat is triggered, AI suggests items based on product catalog', () => {
-      given([
-        State.Products({
-          products: [
-            {
-              productId: 'prod-soccer-ball',
-              name: 'Super Soccer Ball',
-              category: 'Sports',
-              price: 10,
-              tags: ['soccer', 'sports'],
-              imageUrl: 'https://example.com/soccer-ball.jpg',
-            },
-            {
-              productId: 'prod-craft-kit',
-              name: 'Deluxe Craft Kit',
-              category: 'Arts & Crafts',
-              price: 25,
-              tags: ['crafts', 'art', 'creative'],
-              imageUrl: 'https://example.com/craft-kit.jpg',
-            },
-            {
-              productId: 'prod-laptop-bag',
-              name: 'Tech Laptop Backpack',
-              category: 'School Supplies',
-              price: 45,
-              tags: ['computers', 'tech', 'school'],
-              imageUrl: 'https://example.com/laptop-bag.jpg',
-            },
+      rule('AI should suggest relevant items from available products', () => {
+        example('Product catalog with matching items generates suggestions')
+          .given<Products>([
             {
-              productId: 'prod-mtg-starter',
-              name: 'Magic the Gathering Starter Set',
-              category: 'Games',
-              price: 30,
-              tags: ['magic', 'tcg', 'games'],
-              imageUrl: 'https://example.com/mtg-starter.jpg',
+              products: [
+                {
+                  productId: 'prod-soccer-ball',
+                  name: 'Super Soccer Ball',
+                  category: 'Sports',
+                  price: 10,
+                  tags: ['soccer', 'sports'],
+                  imageUrl: 'https://example.com/soccer-ball.jpg',
+                },
+                {
+                  productId: 'prod-craft-kit',
+                  name: 'Deluxe Craft Kit',
+                  category: 'Arts & Crafts',
+                  price: 25,
+                  tags: ['crafts', 'art', 'creative'],
+                  imageUrl: 'https://example.com/craft-kit.jpg',
+                },
+                {
+                  productId: 'prod-laptop-bag',
+                  name: 'Tech Laptop Backpack',
+                  category: 'School Supplies',
+                  price: 45,
+                  tags: ['computers', 'tech', 'school'],
+                  imageUrl: 'https://example.com/laptop-bag.jpg',
+                },
+                {
+                  productId: 'prod-mtg-starter',
+                  name: 'Magic the Gathering Starter Set',
+                  category: 'Games',
+                  price: 30,
+                  tags: ['magic', 'tcg', 'games'],
+                  imageUrl: 'https://example.com/mtg-starter.jpg',
+                },
+              ],
             },
-          ],
-        }),
-      ])
-        .when(
-          Commands.SuggestShoppingItems({
+          ])
+          .when<SuggestShoppingItems>({
             sessionId: 'session-abc',
             prompt:
               'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
-          }),
-        )
-        .then([
-          Events.ShoppingItemsSuggested({
-            sessionId: 'session-abc',
-            suggestedItems: [
-              {
-                productId: 'prod-soccer-ball',
-                name: 'Super Soccer Ball',
-                quantity: 1,
-                reason: 'Perfect for your daughter who loves soccer',
-              },
-              {
-                productId: 'prod-craft-kit',
-                name: 'Deluxe Craft Kit',
-                quantity: 1,
-                reason: 'Great for creative activities and crafts',
-              },
-              {
-                productId: 'prod-laptop-bag',
-                name: 'Tech Laptop Backpack',
-                quantity: 1,
-                reason: `Essential for your son's school computer needs`,
-              },
-              {
-                productId: 'prod-mtg-starter',
-                name: 'Magic the Gathering Starter Set',
-                quantity: 1,
-                reason: 'Ideal starter set for Magic the Gathering enthusiasts',
-              },
-            ],
-          }),
-        ]);
+          })
+          .then<ShoppingItemsSuggested>([
+            {
+              sessionId: 'session-abc',
+              suggestedItems: [
+                {
+                  productId: 'prod-soccer-ball',
+                  name: 'Super Soccer Ball',
+                  quantity: 1,
+                  reason: 'Perfect for your daughter who loves soccer',
+                },
+                {
+                  productId: 'prod-craft-kit',
+                  name: 'Deluxe Craft Kit',
+                  quantity: 1,
+                  reason: 'Great for creative activities and crafts',
+                },
+                {
+                  productId: 'prod-laptop-bag',
+                  name: 'Tech Laptop Backpack',
+                  quantity: 1,
+                  reason: `Essential for your son's school computer needs`,
+                },
+                {
+                  productId: 'prod-mtg-starter',
+                  name: 'Magic the Gathering Starter Set',
+                  quantity: 1,
+                  reason: 'Ideal starter set for Magic the Gathering enthusiasts',
+                },
+              ],
+            },
+          ]);
+      });
     });
   });
 
@@ -264,67 +264,67 @@ flow('Seasonal Assistant', () => {
       data([source().state('SuggestedItems').fromProjection('SuggestedItemsProjection', 'sessionId')]);
 
       specs('Suggested items are available for viewing', () => {
-        given([
-          Events.ShoppingItemsSuggested({
-            sessionId: 'session-abc',
-            suggestedItems: [
-              {
-                productId: 'prod-soccer-ball',
-                name: 'Super Soccer Ball',
-                quantity: 1,
-                reason: 'Perfect for your daughter who loves soccer',
-              },
-              {
-                productId: 'prod-craft-kit',
-                name: 'Deluxe Craft Kit',
-                quantity: 1,
-                reason: 'Great for creative activities and crafts',
-              },
-              {
-                productId: 'prod-laptop-bag',
-                name: 'Tech Laptop Backpack',
-                quantity: 1,
-                reason: `Essential for your son's school computer needs`,
-              },
-              {
-                productId: 'prod-mtg-starter',
-                name: 'Magic the Gathering Starter Set',
-                quantity: 1,
-                reason: 'Ideal starter set for Magic the Gathering enthusiasts',
-              },
-            ],
-          }),
-        ]).then([
-          State.SuggestedItems({
-            sessionId: 'session-abc',
-            items: [
-              {
-                productId: 'prod-soccer-ball',
-                name: 'Super Soccer Ball',
-                quantity: 1,
-                reason: 'Perfect for your daughter who loves soccer',
-              },
-              {
-                productId: 'prod-craft-kit',
-                name: 'Deluxe Craft Kit',
-                quantity: 1,
-                reason: 'Great for creative activities and crafts',
-              },
-              {
-                productId: 'prod-laptop-bag',
-                name: 'Tech Laptop Backpack',
-                quantity: 1,
-                reason: `Essential for your son's school computer needs`,
-              },
-              {
-                productId: 'prod-mtg-starter',
-                name: 'Magic the Gathering Starter Set',
-                quantity: 1,
-                reason: 'Ideal starter set for Magic the Gathering enthusiasts',
-              },
-            ],
-          }),
-        ]);
+        rule('Items should be available for viewing after suggestion', () => {
+          example('Item becomes available after AI suggestion event')
+            .when<ShoppingItemsSuggested>({
+              sessionId: 'session-abc',
+              suggestedItems: [
+                {
+                  productId: 'prod-soccer-ball',
+                  name: 'Super Soccer Ball',
+                  quantity: 1,
+                  reason: 'Perfect for your daughter who loves soccer',
+                },
+                {
+                  productId: 'prod-craft-kit',
+                  name: 'Deluxe Craft Kit',
+                  quantity: 1,
+                  reason: 'Great for creative activities and crafts',
+                },
+                {
+                  productId: 'prod-laptop-bag',
+                  name: 'Tech Laptop Backpack',
+                  quantity: 1,
+                  reason: `Essential for your son's school computer needs`,
+                },
+                {
+                  productId: 'prod-mtg-starter',
+                  name: 'Magic the Gathering Starter Set',
+                  quantity: 1,
+                  reason: 'Ideal starter set for Magic the Gathering enthusiasts',
+                },
+              ],
+            })
+            .then<SuggestedItems>({
+              sessionId: 'session-abc',
+              items: [
+                {
+                  productId: 'prod-soccer-ball',
+                  name: 'Super Soccer Ball',
+                  quantity: 1,
+                  reason: 'Perfect for your daughter who loves soccer',
+                },
+                {
+                  productId: 'prod-craft-kit',
+                  name: 'Deluxe Craft Kit',
+                  quantity: 1,
+                  reason: 'Great for creative activities and crafts',
+                },
+                {
+                  productId: 'prod-laptop-bag',
+                  name: 'Tech Laptop Backpack',
+                  quantity: 1,
+                  reason: `Essential for your son's school computer needs`,
+                },
+                {
+                  productId: 'prod-mtg-starter',
+                  name: 'Magic the Gathering Starter Set',
+                  quantity: 1,
+                  reason: 'Ideal starter set for Magic the Gathering enthusiasts',
+                },
+              ],
+            });
+        });
       });
     });
 
@@ -339,28 +339,28 @@ flow('Seasonal Assistant', () => {
     .server(() => {
       data([sink().event('ItemsAddedToCart').toStream('shopping-session-${sessionId}')]);
       specs('When shopper accepts items, they are added to cart', () => {
-        when(
-          Commands.AddItemsToCart({
-            sessionId: 'session-abc',
-            items: [
-              { productId: 'prod-soccer-ball', quantity: 1 },
-              { productId: 'prod-craft-kit', quantity: 1 },
-              { productId: 'prod-laptop-bag', quantity: 1 },
-              { productId: 'prod-mtg-starter', quantity: 1 },
-            ],
-          }),
-        ).then([
-          Events.ItemsAddedToCart({
-            sessionId: 'session-abc',
-            items: [
-              { productId: 'prod-soccer-ball', quantity: 1 },
-              { productId: 'prod-craft-kit', quantity: 1 },
-              { productId: 'prod-laptop-bag', quantity: 1 },
-              { productId: 'prod-mtg-starter', quantity: 1 },
-            ],
-            timestamp: new Date(),
-          }),
-        ]);
+        rule('Accepted items should be added to the shopping cart', () => {
+          example('User selects all suggested items for cart')
+            .when<AddItemsToCart>({
+              sessionId: 'session-abc',
+              items: [
+                { productId: 'prod-soccer-ball', quantity: 1 },
+                { productId: 'prod-craft-kit', quantity: 1 },
+                { productId: 'prod-laptop-bag', quantity: 1 },
+                { productId: 'prod-mtg-starter', quantity: 1 },
+              ],
+            })
+            .then<ItemsAddedToCart>({
+              sessionId: 'session-abc',
+              items: [
+                { productId: 'prod-soccer-ball', quantity: 1 },
+                { productId: 'prod-craft-kit', quantity: 1 },
+                { productId: 'prod-laptop-bag', quantity: 1 },
+                { productId: 'prod-mtg-starter', quantity: 1 },
+              ],
+              timestamp: new Date(),
+            });
+        });
       });
     });
 });

package/templates/shopping-app/package.json

@@ -1,10 +1,12 @@
 {
   "name": "shopping-assistant",
+  "private": true,
   "type": "module",
   "scripts": {
     "auto": "auto",
+    "auto:debug": "DEBUG=flow:*,cli:* auto",
     "start": "dotenv -e .env -- pnpm --parallel start",
-    "build": "pnpm --parallel build",
+    "build": "tsc",
     "start:ecommerce-site": "cd examples/ecommerce-site && pnpm start",
     "start:product-api": "cd examples/product-catalogue-api && pnpm start",
     "start:cart-api": "cd examples/cart-api && pnpm start",
@@ -21,9 +23,11 @@
     "@auto-engineer/message-bus": "workspace:*",
     "@auto-engineer/server-checks": "workspace:*",
     "@auto-engineer/server-generator-apollo-emmett": "workspace:*",
-    "@auto-engineer/server-implementer": "workspace:*"
+    "@auto-engineer/server-implementer": "workspace:*",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
+    "@types/node": "^24.3.1",
     "chokidar": "^3.6.0",
     "dotenv": "^16.4.5",
     "dotenv-cli": "^9.0.0",

package/templates/shopping-app/server/package.json

@@ -6,12 +6,12 @@
   "scripts": {
     "start": "tsx --no-deprecation src/server.ts",
     "type-check": "tsc --noEmit",
-    "test": "vitest run",
+    "test": "vitest run --reporter=dot",
     "dev": "tsx watch --no-deprecation src/server.ts"
   },
   "dependencies": {
-    "@auto-engineer/ai-gateway": "latest",
-    "@auto-engineer/flow": "^0.1.1",
+    "@auto-engineer/ai-gateway": "workspace:*",
+    "@auto-engineer/flow": "workspace:*",
     "axios": "^1.11.0",
     "@event-driven-io/emmett": "^0.38.2",
     "type-graphql": "^2.0.0-rc.2",
@@ -19,7 +19,8 @@
     "fast-glob": "^3.3.3",
     "reflect-metadata": "^0.2.2",
     "apollo-server": "^3.13.0",
-    "uuid": "^10.0.0"
+    "uuid": "^10.0.0",
+    "zod": "^3.25.67"
   },
   "devDependencies": {}
 }

package/templates/shopping-app/server/src/integrations/ai-integration.ts

@@ -52,7 +52,7 @@ export const AI: Integration<'ai', Record<string, never>, AICommands> = {
         const schema = getSchemaByName(schemaName);
 
         if (schema) {
-          return await generateStructuredDataWithAI(fullPrompt, AIProvider.Anthropic, {
+          return await generateStructuredDataWithAI(fullPrompt, {
             schema: schema as z.ZodSchema<T>,
             schemaName,
             schemaDescription: `AI output matching schema '${schemaName}'`,
@@ -60,7 +60,7 @@ export const AI: Integration<'ai', Record<string, never>, AICommands> = {
           });
         }
       }
-      const raw = await generateTextWithAI(fullPrompt, AIProvider.Anthropic, {
+      const raw = await generateTextWithAI(fullPrompt, {
         includeTools: true,
       });
 

package/templates/shopping-app/server/src/integrations/index.ts

@@ -1,3 +1,3 @@
 export * from './ai-integration';
 export * from './cart-integration';
-export * from './product-catalogue-integration';
+export * from './product-catalogue';