Integrate starterkits and align with demo AI

.ddev/config.yaml

@@ -1,27 +1,80 @@
-name: DrupalPod
-type: drupal
-docroot: web
+type: drupal11
+docroot: docroot/web
 php_version: "8.3"
+composer_root: docroot
 webserver_type: apache-fpm
 xdebug_enabled: false
 additional_hostnames: []
 additional_fqdns: []
 database:
-    type: mariadb
-    version: "10.11"
+    type: mysql
+    version: "8.0"
+hooks:
+    post-start:
+        # Set up debugging.
+        - exec: test -f .vscode/launch.json || mkdir -p .vscode && cp .ddev/launch.json .vscode/
+        # Run initial setup tasks only when needed (DP_REBUILD=1 or Drupal not installed).
+        - exec: 'if [ "${DP_REBUILD:-0}" = "1" ] || ! drush status --field=bootstrap 2>/dev/null | grep -q "Successful"; then bash "$(pwd)/.devpanel/init.sh"; fi'
 use_dns_when_possible: true
 composer_version: "2"
 web_environment:
+    # Set up DevPanel variables. DO NOT CHANGE
     - APP_ROOT=$DDEV_COMPOSER_ROOT
-    - WEB_ROOT=$DDEV_COMPOSER_ROOT/$DDEV_DOCROOT
+    - WEB_ROOT=$DDEV_APPROOT/$DDEV_DOCROOT
     - DB_HOST=db
     - DB_PORT=3306
     - DB_USER=db
     - DB_PASSWORD=db
     - DB_NAME=db
-    - DP_APP_ID=drupalpod
+    - DP_APP_ID=drupalpod_ai_qa
     - DB_DRIVER=mysql
+    - DP_AI_MODULES=ai_provider_litellm,ai_search,ai_agents
+
+    - # ============================================================================
+    - # DevPanel / Drupal defaults - customisable
+    - # ============================================================================
+
+    - # ---------------------------------------------------------------------------
+    - # Direct mappings to your DDEV environment variables (keep names identical)
+    - # ---------------------------------------------------------------------------
+    - DP_STARTER_TEMPLATE=core       # Starter template (e.g., core, demo, etc.)
+    - DP_VERSION=11.x           # Drupal version
+
+    - # ---------------------------------------------------------------------------
+    - # AI module / PR testing defaults
+    - # - DP_AI_MODULE_VERSION behavior:
+    - #   * Empty = Auto-detect from test module (recommended)
+    - #   * Set explicitly = Validate compatibility (fails if test module incompatible)
+    - # - DP_AI_ISSUE_FORK / DP_AI_ISSUE_BRANCH: test a PR for the base module
+    - # ---------------------------------------------------------------------------
+    - DP_AI_MODULE=ai                # Base AI module name
+    - DP_AI_MODULE_VERSION=          # Empty = auto-detect (or set explicitly to validate)
+    - DP_AI_ISSUE_FORK=
+    - DP_AI_ISSUE_BRANCH=
+
+    - # ---------------------------------------------------------------------------
+    - # Test any AI sub-module (ai_search, ai_agents, providers, etc.)
+    - # - Setting DP_TEST_MODULE will auto-detect required AI version!
+    - # - The script clones test module first, reads its AI requirement, then clones AI
+    - # - Use DP_TEST_MODULE_VERSION to pin a release-style version (optional)
+    - # - Use DP_TEST_MODULE_ISSUE_FORK / DP_TEST_MODULE_ISSUE_BRANCH to test PRs
+    - # ---------------------------------------------------------------------------
+    - DP_TEST_MODULE=                # Empty = use auto-detected AI version
+    - DP_TEST_MODULE_VERSION=        # Empty = use dev branch
+    - DP_TEST_MODULE_ISSUE_FORK=
+    - DP_TEST_MODULE_ISSUE_BRANCH=
+
+    - # ---------------------------------------------------------------------------
+    - # Optional: local or cloud API key for LiteLLM / provider testing (empty by default)
+    - # ---------------------------------------------------------------------------
+    - DP_AI_VIRTUAL_KEY=
+
+    - # ---------------------------------------------------------------------------
+    - # Set to 1 if you wish to rebuild the whole project from scratch
+    - # ---------------------------------------------------------------------------
+    - DP_REBUILD=1
 corepack_enable: false
+ddev_version_constraint: '>=1.24.0'
 
 # Key features of DDEV's config.yaml:
 

.ddev/launch.json

@@ -0,0 +1,52 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+
+        {
+            "name": "Listen for Xdebug",
+            "type": "php",
+            "request": "launch",
+            "port": 9003,
+            "pathMappings": {
+                "/var/www/html": "${workspaceFolder}"
+            }
+        },
+        {
+            "name": "Launch currently open script",
+            "type": "php",
+            "request": "launch",
+            "program": "${file}",
+            "cwd": "${fileDirname}",
+            "port": 0,
+            "runtimeArgs": [
+                "-dxdebug.start_with_request=yes"
+            ],
+            "env": {
+                "XDEBUG_MODE": "debug,develop",
+                "XDEBUG_CONFIG": "client_port=${port}"
+            }
+        },
+        {
+            "name": "Launch Built-in web server",
+            "type": "php",
+            "request": "launch",
+            "runtimeArgs": [
+                "-dxdebug.mode=debug",
+                "-dxdebug.start_with_request=yes",
+                "-S",
+                "localhost:0"
+            ],
+            "program": "",
+            "cwd": "${workspaceRoot}",
+            "port": 9003,
+            "serverReadyAction": {
+                "pattern": "Development Server \\(http://localhost:([0-9]+)\\) started",
+                "uriFormat": "http://localhost:%s",
+                "action": "openExternally"
+            }
+        }
+    ]
+}