@auto-engineer/information-architect 0.11.20 → 0.12.1

package/package.json

@@ -14,14 +14,14 @@
   },
   "dependencies": {
     "fast-glob": "^3.3.2",
-    "@auto-engineer/ai-gateway": "0.11.20",
-    "@auto-engineer/message-bus": "0.11.20",
-    "@auto-engineer/narrative": "0.11.20"
+    "@auto-engineer/ai-gateway": "0.12.1",
+    "@auto-engineer/message-bus": "0.12.1",
+    "@auto-engineer/narrative": "0.12.1"
   },
   "devDependencies": {
-    "@auto-engineer/cli": "0.11.20"
+    "@auto-engineer/cli": "0.12.1"
   },
-  "version": "0.11.20",
+  "version": "0.12.1",
   "scripts": {
     "build": "tsc && tsx ../../scripts/fix-esm-imports.ts && cp src/auto-ux-schema.json dist/",
     "test": "vitest run --reporter=dot",

package/src/auto-ux-schema.json

@@ -29,7 +29,7 @@
                   "items": {
                     "type": "string"
                   },
-                  "description": "Optional. UX and behavioral specifications for this component/page, derived from flow specs."
+                  "description": "Optional. Array of behavioral test specifications. Uses ' → ' to show nested context."
                 }
               },
               "required": ["description"]
@@ -72,7 +72,7 @@
                   "items": {
                     "type": "string"
                   },
-                  "description": "Optional. UX and behavioral specifications for this component/page, derived from flow specs."
+                  "description": "Optional. Array of behavioral test specifications. Uses ' → ' to show nested context."
                 }
               },
               "required": ["description", "composition"]
@@ -154,7 +154,7 @@
                   "items": {
                     "type": "string"
                   },
-                  "description": "Optional. UX and behavioral specifications for this component/page, derived from flow specs."
+                  "description": "Optional. Array of behavioral test specifications. Uses ' → ' to show nested context."
                 }
               },
               "required": ["description", "composition"]
@@ -254,7 +254,7 @@
                   "items": {
                     "type": "string"
                   },
-                  "description": "Optional. UX and behavioral specifications for this component/page, derived from flow specs."
+                  "description": "Optional. Array of behavioral test specifications. Uses ' → ' to show nested context."
                 }
               },
               "required": ["route", "description", "layout"]

package/src/commands/generate-ia.ts

@@ -6,6 +6,7 @@ import { processFlowsWithAI } from '../index';
 import { type UXSchema } from '../types';
 import createDebug from 'debug';
 import { Model } from '@auto-engineer/narrative';
+import { flattenClientSpecs } from '../spec-utils';
 
 const debug = createDebug('auto:information-architect:generate-command');
 const debugSchema = createDebug('auto:information-architect:generate-command:schema');
@@ -110,6 +111,22 @@ async function getModelFromContext(modelPath: string): Promise<Model> {
   return JSON.parse(modelContent) as Model;
 }
 
+function preprocessModelForAI(model: Model): Model {
+  const processedModel = JSON.parse(JSON.stringify(model)) as Model;
+
+  for (const narrative of processedModel.narratives) {
+    for (const slice of narrative.slices) {
+      if ('client' in slice && slice.client !== undefined && slice.client.specs !== undefined) {
+        const flattenedSpecs = flattenClientSpecs(slice.client.specs);
+        (slice.client as Record<string, unknown>).specs = flattenedSpecs;
+        debug('Flattened %d client specs for slice: %s', flattenedSpecs.length, slice.name);
+      }
+    }
+  }
+
+  return processedModel;
+}
+
 async function getUniqueSchemaPath(
   outputDir: string,
 ): Promise<{ filePath: string; existingSchema: object | undefined }> {
@@ -155,6 +172,10 @@ async function handleGenerateIACommandInternal(
     const model = await getModelFromContext(modelPath);
     debugFiles('Reading %d flow files', model.narratives.length);
 
+    // Preprocess model to flatten client specs for AI
+    const processedModel = preprocessModelForAI(model);
+    debug('Model preprocessed with flattened client specs');
+
     // Get unique schema path and existing schema
     const { filePath, existingSchema } = await getUniqueSchemaPath(outputDir);
 
@@ -169,7 +190,7 @@ async function handleGenerateIACommandInternal(
     debug('  Existing schema: %s', existingSchema ? 'yes' : 'no');
     debug('  Atom count: %d', atoms.length);
 
-    const iaSchema = await processFlowsWithAI(model, uxSchema, existingSchema, atoms);
+    const iaSchema = await processFlowsWithAI(processedModel, uxSchema, existingSchema, atoms);
     debug('AI processing complete');
 
     // Write the schema to file

package/src/ia-agent.ts

@@ -92,9 +92,10 @@ Instructions:
     - template (what wrapper does the page use)
     - navigation (array of navigation actions, e.g., { "on": "Click Listing Card", "to": "ListingDetailPage" })
     - data_requirements (array, as above, for page-level data fetching)
-- For each component or page, if there are any specs defined in the model's flow slices (look for slice.specs array where specs have context='client'), extract all spec descriptions and assign them as an array of strings to a 'specs' field for the corresponding component/page.
-- Only include specs where the context is 'client', not 'server' or other contexts.
-- If no specs are found for a component/page, omit the 'specs' field.
+- For each component or page, if there are any specs defined in the model's flow slices, look at slice.client.specs which is an array of strings.
+- These specs describe behavioral requirements with nested context preserved using ' → ' separator (e.g., "Form → Validation → shows error").
+- Assign these specs directly to the 'specs' field for the corresponding component/page.
+- If no client.specs exist for a slice, omit the 'specs' field.
 
 Use the following structure as a template for your response:
 ----

package/src/spec-utils.ts

@@ -0,0 +1,39 @@
+import type { ClientSpecNode } from '@auto-engineer/narrative';
+
+function buildFullPath(path: string[], title: string, separator: string): string {
+  return path.length > 0 ? path.join(separator) + separator + title : title;
+}
+
+function shouldIncludeTitleInPath(title: string | undefined): boolean {
+  return title !== undefined && title !== '' && title.trim() !== '';
+}
+
+function createNewPath(path: string[], title: string | undefined): string[] {
+  return shouldIncludeTitleInPath(title) && title !== undefined ? [...path, title] : path;
+}
+
+function hasChildren(node: ClientSpecNode): boolean {
+  return node.type === 'describe' && node.children !== undefined && node.children.length > 0;
+}
+
+export function flattenClientSpecs(nodes: ClientSpecNode[] | undefined, separator: string = ' → '): string[] {
+  if (!nodes || nodes.length === 0) {
+    return [];
+  }
+
+  const results: string[] = [];
+
+  function traverse(nodes: ClientSpecNode[], path: string[] = []): void {
+    for (const node of nodes) {
+      if (node.type === 'it') {
+        results.push(buildFullPath(path, node.title, separator));
+      } else if (hasChildren(node) && node.children !== undefined) {
+        const newPath = createNewPath(path, node.title);
+        traverse(node.children, newPath);
+      }
+    }
+  }
+
+  traverse(nodes);
+  return results;
+}