@auto-engineer/information-architect 0.4.3 → 0.5.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @auto-engineer/information-architect@0.4.3 build /Users/sam/WebstormProjects/top/auto-engineer/packages/information-architect
+> @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,13 +1,16 @@
 
 
-> @auto-engineer/information-architect@0.4.2 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 23ms (unchanged)
-package.jsonpackage.json 14ms (unchanged)
-src/auto-ux-schema.jsonsrc/auto-ux-schema.json 37ms (unchanged)
-src/commands/generate-ia.tssrc/commands/generate-ia.ts 49ms (unchanged)
-src/generate-ia-schema.tssrc/generate-ia-schema.ts 8ms (unchanged)
-src/index.tssrc/index.ts 8ms (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.2 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,12 +1,14 @@
-
-> @auto-engineer/information-architect@0.4.3 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/**
-
+
+
+> @auto-engineer/information-architect@0.5.0 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

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

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

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @auto-engineer/information-architect
 
+## 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/DEBUG.md

@@ -0,0 +1,152 @@
+# Debug Logging - Information Architect
+
+This package uses the [debug](https://www.npmjs.com/package/debug) library for conditional logging.
+
+## Available Debug Namespaces
+
+- `ia:generate-command` - Main IA generation command handling
+- `ia:generate-command:schema` - Schema loading and processing
+- `ia:generate-command:files` - File operations (reading flows, writing output)
+- `ia:generate-command:atoms` - Atom extraction from design system
+- `ia:generate-command:result` - Result generation and output
+
+## Enabling Debug Output
+
+Set the `DEBUG` environment variable to enable logging:
+
+```bash
+# Enable all IA logging
+DEBUG=ia:* pnpm generate-ia
+
+# Enable specific namespace
+DEBUG=ia:generate-command:schema pnpm generate-ia
+
+# Enable multiple namespaces
+DEBUG=ia:generate-command:files,ia:generate-command:atoms pnpm generate-ia
+
+# Enable all logging
+DEBUG=* pnpm generate-ia
+```
+
+## Examples
+
+### Debug IA Generation Command
+
+```bash
+DEBUG=ia:generate-command pnpm generate-ia
+```
+
+Output example:
+
+```
+ia:generate-command Handling GenerateIA command
+ia:generate-command   Output directory: ./output
+ia:generate-command   Flow files: 3
+ia:generate-command   Request ID: req-789
+ia:generate-command   Correlation ID: corr-012
+ia:generate-command Processing flows with AI...
+ia:generate-command   Flow count: 3
+ia:generate-command   Existing schema: yes
+ia:generate-command   Atom count: 15
+ia:generate-command AI processing complete
+```
+
+### Debug Schema Operations
+
+```bash
+DEBUG=ia:generate-command:schema pnpm generate-ia
+```
+
+Output example:
+
+```
+ia:generate-command:schema Loading UX schema from: src/auto-ux-schema.json
+ia:generate-command:schema UX schema loaded successfully
+```
+
+### Debug File Operations
+
+```bash
+DEBUG=ia:generate-command:files pnpm generate-ia
+```
+
+Output example:
+
+```
+ia:generate-command:files Reading 3 flow files
+ia:generate-command:files   Reading: flows/shopping-assistant.flow.ts
+ia:generate-command:files     Size: 4523 bytes
+ia:generate-command:files   Reading: flows/order-management.flow.ts
+ia:generate-command:files     Size: 3210 bytes
+ia:generate-command:files All flow files read successfully
+ia:generate-command:files Finding unique schema path in: ./output
+ia:generate-command:files Found 2 existing IA scheme files
+ia:generate-command:files   File auto-ia-scheme.json -> number 0
+ia:generate-command:files   File auto-ia-scheme-1.json -> number 1
+ia:generate-command:files Highest numbered file: 1
+ia:generate-command:files New file will use suffix: 2
+ia:generate-command:files New schema will be written to: ./output/auto-ia-scheme-2.json
+```
+
+### Debug Atom Extraction
+
+```bash
+DEBUG=ia:generate-command:atoms pnpm generate-ia
+```
+
+Output example:
+
+```
+ia:generate-command:atoms Looking for design-system.md at: ./output/design-system.md
+ia:generate-command:atoms Design system markdown loaded, size: 12450 bytes
+ia:generate-command:atoms Scanning 450 lines for component names
+ia:generate-command:atoms   Found component: Button
+ia:generate-command:atoms   Found component: Input
+ia:generate-command:atoms   Found component: Card
+ia:generate-command:atoms   Found component: Modal
+ia:generate-command:atoms Total components found: 15
+ia:generate-command:atoms Created 15 atom definitions
+```
+
+### Debug Result Generation
+
+```bash
+DEBUG=ia:generate-command:result pnpm generate-ia
+```
+
+Output example:
+
+```
+ia:generate-command:result Writing IA schema to: ./output/auto-ia-scheme-2.json
+ia:generate-command:result Schema JSON size: 45678 bytes
+ia:generate-command:result Schema written successfully
+ia:generate-command:result Returning success event: IAGenerated
+ia:generate-command:result   Output path: ./output/auto-ia-scheme-2.json
+```
+
+## Common Use Cases
+
+### Debug Full IA Generation Pipeline
+
+```bash
+DEBUG=ia:* pnpm generate-ia
+```
+
+### Debug File Processing Only
+
+```bash
+DEBUG=ia:generate-command:files,ia:generate-command:atoms pnpm generate-ia
+```
+
+### Debug with Error Details
+
+```bash
+DEBUG=ia:generate-command,ia:generate-command:result pnpm generate-ia
+```
+
+## Tips
+
+- Use wildcards: `DEBUG=ia:generate-command:*` to see all sub-namespaces
+- Combine with AI gateway debugging: `DEBUG=ia:*,ai-gateway:*`
+- Save to file: `DEBUG=ia:* pnpm generate-ia 2> ia-debug.log`
+- Verbose output: `DEBUG=ia:* pnpm generate-ia --verbose`

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"}