aia 1.0.0-alpha2

AI Architect (AIA) 1.0.0-alpha2

Release Date: February 16, 2026

This release adds a complete rollback system, comprehensive task history tracking, and verified Real AI integration with multiple providers.

🎉 What's New in Alpha 2

🔄 Rollback System

• Undo any operation with a single command
• Complete cleanup of content types, fields, taxonomies, and all configurations
• Safe operation with confirmation prompts
• Works for all three action types
• Command: drush aia:rollback <task-id>

📋 Task History & Audit Logging

• Every execution logged to database with new aia_task entity
• Track user, timestamp, payload, result, and rollback status
• Web interface at /admin/reports/aia
• Command: drush aia:tasks
• Full audit trail for compliance and debugging

🤖 Real AI Integration (Verified Working)

• Fixed and tested with AI module 1.2.8+
• Compatible with Anthropic (Claude), Google Gemini, OpenAI, and other providers
• Verified with actual API calls to Gemini and Anthropic
• Proper JSON response cleaning and error handling
• Mock AI remains default for zero-cost development

✨ Enhanced Admin UI

• Task history viewer with status indicators (Success/Failed/Rolled Back)
• Improved error messages and user feedback
• AJAX-powered action selection with descriptions
• Better navigation and polish

📦 Installation

composer require drupal/aia
drush en aia -y

🚀 Quick Start

Using Mock AI (No Setup Required)

# Preview changes
drush aia:dry-run generate_content_type

# Execute with confirmation
drush aia:execute generate_content_type

# View task history
drush aia:tasks

# Rollback if needed
drush aia:rollback 1

Using Real AI (Requires API Key)

1. Install AI module: composer require drupal/ai
2. Configure provider at /admin/config/ai/providers
3. Set as default for "Chat" capability at /admin/config/ai/settings
4. Edit aia.services.yml to switch from Mock to Real AI
5. Clear cache and test

🎯 Use Cases

Example 1: Complete Workflow

# Create content type
drush aia:execute generate_content_type --auto-approve

# Add field to it
drush aia:execute add_field --auto-approve

# Create taxonomy
drush aia:execute generate_taxonomy --auto-approve

# View history
drush aia:tasks

# Rollback if needed (reverse order)
drush aia:rollback 3
drush aia:rollback 2
drush aia:rollback 1

Example 2: Safe Experimentation

# Try different configurations
drush aia:execute generate_taxonomy
# Output: Task ID: 1

# Not happy with the result?
drush aia:rollback 1

# Try again
drush aia:execute generate_taxonomy
# Output: Task ID: 2 (different AI-generated result)

🔧 Technical Details

• New Entity Type: aia_task content entity for persistent task storage
• New Services: aia.task_logger, aia.rollback_service, aia.logger
• Database Schema: Automatically created on module install via entity definition manager
• Architecture: Full dependency injection, no static calls, 100% backward compatible
• Tests: 52 tests, 258 assertions, 100% core coverage

⚠️ Known Limitations

• Rollback only via Drush (UI-based rollback planned for Beta 1)
• Must rollback tasks individually (batch rollback planned)
• Cannot rollback failed tasks (only successful operations)
• Real AI requires external API and associated costs

🛠️ Upgrading from Alpha 1

1. Update code: composer update drupal/aia
2. Database updates: drush updb -y (creates aia_task table)
3. Clear cache: drush cr
4. Test: drush aia:execute generate_taxonomy

No breaking changes - All Alpha 1 functionality remains unchanged.

🚧 Roadmap to Beta 1

• Additional action plugins (Views, Blocks, Menus)
• UI-based rollback with confirmation dialogs
• Batch operations (rollback multiple tasks, execute multiple actions)
• Custom natural language prompts
• Export/import task configurations
• Enhanced validation and error recovery

🙏 Feedback Welcome

This is an alpha release. Please report issues, share feedback, and suggest features in the issue queue.

If you test Real AI integration with your provider, please share your results!

📚 Resources

• Documentation
• Source Code
• Issue Queue

```

---