Merge branch 'develop' into update/client-ability-execution

Author: dkotter

.distignore

@@ -4,8 +4,10 @@
 /.wordpress-org
 /docs
 /node_modules
+/routes
 /src
 /tests
+/tools
 
 # Files
 .*

.github/workflows/plugin-check.yml

@@ -69,5 +69,6 @@ jobs:
                       plugin_header_unsupported_plugin_name
                   exclude-directories: |
                       .github
+                      build
                       docs
                       tests

.gitignore

@@ -19,6 +19,7 @@ Thumbs.db
 # Build output
 build/
 build-module/
+build-scripts/
 build-types/
 
 # Environment

ai.php

@@ -29,6 +29,8 @@
 /**
  * Shortcut constant to the path of this file.
  */
-define( 'WPAI_DIR', plugin_dir_path( __FILE__ ) );
+if ( ! defined( 'WPAI_DIR' ) ) {
+	define( 'WPAI_DIR', plugin_dir_path( __FILE__ ) );
+}
 
 require_once WPAI_DIR . 'includes/bootstrap.php';

docs/ARCHITECTURE_OVERVIEW.md

@@ -6,7 +6,8 @@ The plugin follows a modular, experiment-based architecture:
 ```
 ai/
 ├── ai.php                            # Plugin bootstrap
-├── build/                            # Built assets
+├── build/                            # wp-build route assets
+├── build-scripts/                    # wp-scripts built assets
 ├── docs/                             # Documentation
 │   ├── experiments/                  # Experiment specific documentation
 │   ├── ARCHITECTURE_OVERVIEW.md      # Architecture Overview

docs/DEVELOPER_GUIDE.md

@@ -242,7 +242,7 @@ The plugin also includes the following action hooks:
 
 ### Asset Loading
 
-The plugin provides a utility class for loading assets. This uses `wp-scripts` to build assets which are expected to live within the `src/` directory. They will then be built into the `build/` directory, where the asset loader will look for the files, pulling in the proper dependencies and versioning.
+The plugin provides a utility class for loading assets. This uses `wp-scripts` to build assets which are expected to live within the `src/` directory. They will then be built into the `build-scripts/` directory, where the asset loader will look for the files, pulling in the proper dependencies and versioning.
 
 ```php
 use WordPress\AI\Asset_Loader;
@@ -252,7 +252,7 @@ use WordPress\AI\Asset_Loader;
  *
  * First argument is the script handle.
  * The second argument is the script file name.
- * This script file name should be in the build/ directory.
+ * This script file name should be in the build-scripts/ directory.
  * The source script files should be in the src/ directory. If needed,
  * you can add the entry point to the webpack.config.js file.
  */
@@ -263,7 +263,7 @@ Asset_Loader::enqueue_script( 'my-experiment', 'experiments/my-experiment' );
  *
  * First argument is the style handle.
  * The second argument is the style file name.
- * This style file name should be in the build/ directory.
+ * This style file name should be in the build-scripts/ directory.
  * The source style files should be in the src/ directory. If needed,
  * you can add the entry point to the webpack.config.js file.
  */