DrupalPod AI QA Documentation¶
DrupalPod AI QA is an automation tool for launching Drupal CMS or Drupal core environments preconfigured for testing AI module patches, issue forks, and pull requests.
The DrupalPod AI QA helper extension reads issue details from Drupal.org and can launch the environment to be tested in DrupalForge. You can also run this project locally with DDEV when you need direct control over the codebase.
This documentation is organised into sections covering how the tool works, how to use it, and how to work in the codebase.
Looking to get started?
If you just want to launch and use DrupalPod AI QA, start with the Step-by-Step Guide.
What It Does¶
The extension prepares the environment configuration from the issue context:
The resulting environment is then launched in DrupalForge and exposed through DevPanel:
How It Works¶
- How It Works gives an overview of the build process.
- Build Flow explains the order of the main scripts and the generated manifest.
- Custom Modules explains the Drupal modules included in this repository.
- Resolution Modes explains version resolution, compatibility checks, and lenient dependency handling.
How to Use¶
- Common Use Cases explains the main issue setups supported by the tool.
- Choosing an AI Provider explains how provider selection affects the environment and key flow.
- Step-by-Step Guide covers the hosted workflow using the Chrome extension and DrupalForge.
- VS Code in Browser covers the hosted browser-based editing and terminal workflow.
- Local DDEV Guide covers local setup and override patterns.
- Configuration Reference lists the main environment variables and build inputs.
- Troubleshooting covers common environment, build, and compatibility issues.
Developer Documentation¶
- Developer Guide covers local repo, branch, and fork workflows.
- Development covers the script architecture and implementation notes.
- Testing covers the BATS suite and scenario runner workflow.