@auto-engineer/information-architect 0.4.4 → 0.5.1

package/.turbo/turbo-build.log

@@ -1,6 +1,5 @@
-
-
-> @auto-engineer/information-architect@0.4.4 build /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
-> tsc && tsx ../../scripts/fix-esm-imports.ts && cp src/auto-ux-schema.json dist/
-
-Fixed ESM imports in dist/
+
+> @auto-engineer/information-architect@0.5.0 build /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
+> tsc && tsx ../../scripts/fix-esm-imports.ts && cp src/auto-ux-schema.json dist/
+
+Fixed ESM imports in dist/

package/.turbo/turbo-format.log

@@ -1,14 +1,16 @@
 
 
-> @auto-engineer/information-architect@0.4.4 format /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
+> @auto-engineer/information-architect@0.5.0 format /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
 > prettier --write "**/*.{js,ts,json,md,yml,yaml}" --ignore-path ../../.prettierignore
 
-CHANGELOG.mdCHANGELOG.md 22ms (unchanged)
-DEBUG.mdDEBUG.md 4ms (unchanged)
-package.jsonpackage.json 22ms (unchanged)
-src/auto-ux-schema.jsonsrc/auto-ux-schema.json 15ms (unchanged)
-src/commands/generate-ia.tssrc/commands/generate-ia.ts 58ms (unchanged)
-src/generate-ia-schema.tssrc/generate-ia-schema.ts 7ms (unchanged)
+CHANGELOG.mdCHANGELOG.md 43ms (unchanged)
+DEBUG.mdDEBUG.md 7ms (unchanged)
+package.jsonpackage.json 41ms (unchanged)
+README.mdREADME.md 85ms (unchanged)
+src/auto-ux-schema.jsonsrc/auto-ux-schema.json 14ms (unchanged)
+src/cli-manifest.tssrc/cli-manifest.ts 12ms (unchanged)
+src/commands/generate-ia.tssrc/commands/generate-ia.ts 40ms (unchanged)
+src/generate-ia-schema.tssrc/generate-ia-schema.ts 19ms (unchanged)
 src/index.tssrc/index.ts 7ms (unchanged)
 src/types.tssrc/types.ts 1ms (unchanged)
 tsconfig.jsontsconfig.json 1ms (unchanged)

package/.turbo/turbo-lint.log

@@ -1,5 +1,5 @@
 
 
-> @auto-engineer/information-architect@0.4.4 lint /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
+> @auto-engineer/information-architect@0.5.0 lint /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
 > eslint 'src/**/*.ts' --max-warnings 0 --config ../../eslint.config.ts
 

package/.turbo/turbo-test.log

@@ -1,14 +1,12 @@
-
-
-> @auto-engineer/information-architect@0.4.4 test /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
-> vitest run
-
-[?25l
- RUN  v3.2.4 /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
-
-No test files found, exiting with code 0
-
-include: **/*.specs.{js,ts}
-exclude:  **/.tmp/**, **/node_modules/**, **/dist/**
-
-[?25h
+
+> @auto-engineer/information-architect@0.5.1 test /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
+> vitest run
+
+
+ RUN  v3.2.4 /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
+
+No test files found, exiting with code 0
+
+include: **/*.specs.{js,ts}
+exclude:  **/.tmp/**, **/node_modules/**, **/dist/**
+

package/.turbo/turbo-type-check.log

@@ -1,5 +1,4 @@
-
-
-> @auto-engineer/information-architect@0.4.4 type-check /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
-> tsc --noEmit
-
+
+> @auto-engineer/information-architect@0.5.1 type-check /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
+> tsc --noEmit
+

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @auto-engineer/information-architect
 
+## 0.5.1
+
+### Patch Changes
+
+- Uses AI with a default provider
+- Updated dependencies
+  - @auto-engineer/ai-gateway@0.5.1
+
+## 0.5.0
+
+### Minor Changes
+
+- • All cli commands now use commands and emit events on the bus
+
+### Patch Changes
+
+- Updated dependencies
+  - @auto-engineer/ai-gateway@0.5.0
+  - @auto-engineer/message-bus@0.4.0
+
 ## 0.4.3
 
 ### Patch Changes

package/README.md

@@ -0,0 +1,408 @@
+# @auto-engineer/information-architect
+
+AI-powered information architecture generation plugin for the Auto Engineer CLI that transforms business requirements into structured application blueprints. This plugin creates information architectures, user experience flows, and content hierarchies from high-level requirements.
+
+## Installation
+
+This is a plugin for the Auto Engineer CLI. Install both the CLI and this plugin:
+
+```bash
+npm install -g @auto-engineer/cli
+npm install @auto-engineer/information-architect
+```
+
+## Configuration
+
+Add this plugin to your `auto.config.ts`:
+
+```typescript
+export default {
+  plugins: [
+    '@auto-engineer/information-architect',
+    // ... other plugins
+  ],
+};
+```
+
+## Commands
+
+This plugin provides the following commands:
+
+- `generate:ia` - Generate information architecture from requirements
+
+## What does this plugin do?
+
+The Information Architect plugin analyzes business requirements and generates structured information architectures that serve as blueprints for application development. It creates user experience flows, content hierarchies, navigation structures, and interaction patterns that guide the development of frontend and backend systems.
+
+## Key Features
+
+### Requirements Analysis
+
+- Parses business requirements
+- Identifies user personas and use cases
+- Extracts functional and non-functional requirements
+- Maps business processes to application features
+
+### Information Architecture Generation
+
+- Creates content structures
+- Defines navigation patterns and user flows
+- Establishes data relationships and dependencies
+- Generates wireframes and interaction specifications
+
+### User Experience Design
+
+- Maps user journeys and task flows
+- Identifies key interaction points and decision moments
+- Defines responsive design requirements
+- Creates accessibility and usability guidelines
+
+### Technical Specifications
+
+- Generates API requirements and data models
+- Creates component hierarchies for frontend development
+- Defines integration points and external dependencies
+- Establishes performance and scalability requirements
+
+## Generated Architecture Components
+
+### Site Map and Navigation
+
+Creates comprehensive navigation structures:
+
+```json
+{
+  "siteMap": {
+    "root": "/",
+    "sections": [
+      {
+        "name": "Dashboard",
+        "path": "/dashboard",
+        "access": "authenticated",
+        "children": [
+          {
+            "name": "Analytics",
+            "path": "/dashboard/analytics",
+            "description": "Performance metrics and insights"
+          },
+          {
+            "name": "Settings",
+            "path": "/dashboard/settings",
+            "description": "Account and application settings"
+          }
+        ]
+      },
+      {
+        "name": "Products",
+        "path": "/products",
+        "access": "public",
+        "children": [
+          {
+            "name": "Catalog",
+            "path": "/products/catalog",
+            "description": "Browse all available products"
+          },
+          {
+            "name": "Product Details",
+            "path": "/products/:id",
+            "description": "Detailed product information and purchasing options"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### User Personas and Journeys
+
+Defines target users and their interaction patterns:
+
+```json
+{
+  "personas": [
+    {
+      "name": "End Consumer",
+      "description": "Individual purchasing products for personal use",
+      "goals": ["Find products quickly", "Compare options easily", "Complete purchases securely"],
+      "painPoints": ["Complex checkout process", "Limited product information", "Poor mobile experience"],
+      "journeys": [
+        {
+          "name": "Product Purchase",
+          "steps": [
+            {
+              "stage": "Discovery",
+              "actions": ["Browse catalog", "Search products", "Filter results"],
+              "touchpoints": ["/products", "/search"],
+              "requirements": ["Fast search", "Intuitive filters", "Product recommendations"]
+            },
+            {
+              "stage": "Evaluation",
+              "actions": ["View details", "Compare products", "Read reviews"],
+              "touchpoints": ["/products/:id", "/compare"],
+              "requirements": ["Detailed information", "High-quality images", "Social proof"]
+            },
+            {
+              "stage": "Purchase",
+              "actions": ["Add to cart", "Checkout", "Payment"],
+              "touchpoints": ["/cart", "/checkout"],
+              "requirements": ["Simple checkout", "Multiple payment options", "Security indicators"]
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
+### Page Specifications
+
+Detailed specifications for each application page:
+
+```json
+{
+  "pages": [
+    {
+      "name": "Product Catalog",
+      "path": "/products",
+      "purpose": "Allow users to browse and discover products",
+      "layout": {
+        "type": "grid",
+        "responsive": true,
+        "components": [
+          {
+            "name": "SearchBar",
+            "position": "header",
+            "functionality": "Real-time product search with autocomplete"
+          },
+          {
+            "name": "FilterSidebar",
+            "position": "left",
+            "functionality": "Category, price, and attribute filtering"
+          },
+          {
+            "name": "ProductGrid",
+            "position": "main",
+            "functionality": "Paginated grid of product cards with sorting options"
+          },
+          {
+            "name": "Pagination",
+            "position": "footer",
+            "functionality": "Navigate through product results"
+          }
+        ]
+      },
+      "dataRequirements": [
+        "Product catalog with metadata",
+        "Category hierarchy",
+        "Search indexing",
+        "User preferences"
+      ],
+      "apiEndpoints": ["GET /api/products", "GET /api/categories", "GET /api/search"]
+    }
+  ]
+}
+```
+
+### Component Architecture
+
+Defines reusable component specifications:
+
+```json
+{
+  "components": [
+    {
+      "name": "ProductCard",
+      "type": "organism",
+      "purpose": "Display product information in a card format",
+      "props": [
+        {
+          "name": "product",
+          "type": "Product",
+          "required": true,
+          "description": "Product data object"
+        },
+        {
+          "name": "onAddToCart",
+          "type": "function",
+          "required": false,
+          "description": "Callback when add to cart is clicked"
+        }
+      ],
+      "composition": ["ProductImage", "ProductTitle", "ProductPrice", "AddToCartButton", "ProductRating"],
+      "states": ["loading", "outOfStock", "onSale"],
+      "interactions": [
+        "hover: show quick actions",
+        "click: navigate to product details",
+        "cart button: add to cart with feedback"
+      ]
+    }
+  ]
+}
+```
+
+### Data Models and Relationships
+
+Defines backend data structure requirements:
+
+```json
+{
+  "dataModels": [
+    {
+      "name": "Product",
+      "description": "Core product entity",
+      "fields": [
+        {
+          "name": "id",
+          "type": "string",
+          "required": true,
+          "description": "Unique product identifier"
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "required": true,
+          "description": "Product display name"
+        },
+        {
+          "name": "price",
+          "type": "decimal",
+          "required": true,
+          "description": "Product price in base currency"
+        },
+        {
+          "name": "category",
+          "type": "Category",
+          "required": true,
+          "relationship": "many-to-one"
+        }
+      ],
+      "relationships": [
+        {
+          "type": "one-to-many",
+          "target": "Review",
+          "description": "Products can have multiple reviews"
+        },
+        {
+          "type": "many-to-many",
+          "target": "Tag",
+          "description": "Products can have multiple tags for categorization"
+        }
+      ]
+    }
+  ]
+}
+```
+
+## Configuration Options
+
+Customize IA generation behavior:
+
+```typescript
+// auto.config.ts
+export default {
+  plugins: [
+    [
+      '@auto-engineer/information-architect',
+      {
+        // Analysis preferences
+        includeUserPersonas: true,
+        includeUserJourneys: true,
+        includeWireframes: false,
+
+        // Output format
+        outputFormat: 'json', // or 'markdown', 'html'
+
+        // Detail level
+        detailLevel: 'comprehensive', // or 'basic', 'detailed'
+
+        // Target platforms
+        platforms: ['web', 'mobile'],
+
+        // Design system integration
+        useDesignSystem: true,
+        designSystemPath: './design-system',
+      },
+    ],
+  ],
+};
+```
+
+## Integration with Other Plugins
+
+The Information Architect serves as a foundation for other plugins:
+
+- **@auto-engineer/flowlang**: Uses IA specifications to generate business flows
+- **@auto-engineer/emmett-generator**: Creates backend models from IA data specifications
+- **@auto-engineer/react-graphql-generator**: Generates frontend structure based on IA navigation
+- **@auto-engineer/design-system-importer**: Applies design system constraints to IA components
+- **@auto-engineer/frontend-implementation**: Implements pages and components per IA specifications
+
+## Workflow
+
+### 1. Requirements Input
+
+Provide business requirements as natural language:
+
+```bash
+auto generate:ia --requirements="Create an e-commerce platform for selling handmade crafts. Users should be able to browse products, add items to cart, and complete purchases. Include user accounts, order history, and seller management."
+```
+
+### 2. IA Generation
+
+The plugin analyzes requirements and generates:
+
+- Complete site map and navigation structure
+- User personas and journey maps
+- Page specifications with component breakdowns
+- Data model requirements
+- API endpoint specifications
+- Technical requirements and constraints
+
+### 3. Architecture Review
+
+Generated architecture includes:
+
+- Visual site map diagrams
+- User flow documentation
+- Component hierarchy specifications
+- Database schema recommendations
+- Integration requirements
+
+### 4. Development Guidance
+
+The IA serves as input for subsequent development phases:
+
+- Frontend scaffolding follows navigation structure
+- Backend models implement data specifications
+- Component implementations follow IA component specs
+- User testing validates against defined user journeys
+
+## Quality Assurance
+
+The plugin ensures architecture through:
+
+- Requirements Coverage: All stated requirements are addressed in the IA
+- User Experience Validation: Generated flows support identified user goals
+- Technical Feasibility: Architecture recommendations are technically sound
+- Scalability Considerations: Structure supports growth and feature expansion
+- Accessibility Standards: IA includes accessibility requirements and guidelines
+
+## Advanced Features
+
+### Iterative Refinement
+
+- Analyzes feedback and refines architecture
+- Supports incremental requirement additions
+- Maintains architecture consistency across changes
+- Tracks requirement evolution and impact
+
+### Multi-Platform Support
+
+- Generates platform-specific considerations
+- Addresses responsive design requirements
+- Includes mobile-first considerations
+- Plans for progressive web app features
+
+The Information Architect plugin transforms high-level business requirements into actionable development blueprints, ensuring that applications are built with clear structure, user experience, and technical soundness from the start.

package/dist/cli-manifest.d.ts

@@ -0,0 +1,3 @@
+import type { CliManifest } from '@auto-engineer/cli/manifest-types';
+export declare const CLI_MANIFEST: CliManifest;
+//# sourceMappingURL=cli-manifest.d.ts.map

package/dist/cli-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-manifest.d.ts","sourceRoot":"","sources":["../src/cli-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAErE,eAAO,MAAM,YAAY,EAAE,WAc1B,CAAC"}

package/dist/cli-manifest.js

@@ -0,0 +1,16 @@
+export const CLI_MANIFEST = {
+    category: '@auto-engineer/information-architect',
+    commands: {
+        'generate:ia': {
+            handler: () => import('./commands/generate-ia.js'),
+            description: 'Generate Information Architecture',
+            usage: 'generate:ia <context> <flows...>',
+            examples: ['$ auto generate:ia ./.context ./flows/*.flow.ts'],
+            args: [
+                { name: 'context', description: 'Context directory', required: true },
+                { name: 'flows...', description: 'Flow files to analyze', required: true },
+            ],
+        },
+    },
+};
+//# sourceMappingURL=cli-manifest.js.map

package/dist/cli-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-manifest.js","sourceRoot":"","sources":["../src/cli-manifest.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC,QAAQ,EAAE,sCAAsC;IAChD,QAAQ,EAAE;QACR,aAAa,EAAE;YACb,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,CAAC;YAC/C,WAAW,EAAE,mCAAmC;YAChD,KAAK,EAAE,kCAAkC;YACzC,QAAQ,EAAE,CAAC,iDAAiD,CAAC;YAC7D,IAAI,EAAE;gBACJ,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE;gBACrE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC3E;SACF;KACF;CACF,CAAC"}

package/dist/commands/generate-ia.d.ts

@@ -13,6 +13,11 @@ export type IAGenerationFailedEvent = Event<'IAGenerationFailed', {
     outputDir: string;
     flowFiles: string[];
 }>;
-export declare function handleGenerateIACommand(command: GenerateIACommand): Promise<IAGeneratedEvent | IAGenerationFailedEvent>;
 export declare const generateIACommandHandler: CommandHandler<GenerateIACommand>;
+interface CliArgs {
+    _: string[];
+    [key: string]: unknown;
+}
+declare const _default: (commandOrArgs: GenerateIACommand | CliArgs) => Promise<void>;
+export default _default;
 //# sourceMappingURL=generate-ia.d.ts.map

package/dist/commands/generate-ia.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-ia.d.ts","sourceRoot":"","sources":["../../src/commands/generate-ia.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAiB3F,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC,YAAY,EACZ;IACE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CACF,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAClC,aAAa,EACb;IACE,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CACF,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,KAAK,CACzC,oBAAoB,EACpB;IACE,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CACF,CAAC;AAqFF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,GAAG,uBAAuB,CAAC,CA6FrD;AAED,eAAO,MAAM,wBAAwB,EAAE,cAAc,CAAC,iBAAiB,CAUtE,CAAC"}
+{"version":3,"file":"generate-ia.d.ts","sourceRoot":"","sources":["../../src/commands/generate-ia.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAkB3F,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC,YAAY,EACZ;IACE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CACF,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAClC,aAAa,EACb;IACE,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CACF,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,KAAK,CACzC,oBAAoB,EACpB;IACE,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CACF,CAAC;AA0JF,eAAO,MAAM,wBAAwB,EAAE,cAAc,CAAC,iBAAiB,CAUtE,CAAC;AAGF,UAAU,OAAO;IACf,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;wCA8EoC,iBAAiB,GAAG,OAAO;AAAhE,wBA0BE"}