chore: update README and test script for Makefile integration and fixed project naming

Author: TerrorSquad

tools/internal-test/README.md

@@ -11,17 +11,15 @@ This test suite provides automated testing of the PHP Booster integration proces
 ### Quick Start
 
 ```bash
-# Check environment and requirements
-./test-integration.py env-check
-
-# Set up a Laravel test project
-./test-integration.py setup laravel my-test-app
-
-# Run complete integration test
-./test-integration.py full laravel my-test-app
+# Using Makefile (recommended)
+make test              # Run Laravel test
+make test-symfony      # Run Symfony test
+make test-clean        # Clean up test environments
 
-# Clean up when done
-./test-integration.py clean laravel my-test-app
+# Or using Python script directly
+./test-integration.py env-check
+./test-integration.py full laravel
+./test-integration.py clean laravel
 ```
 
 ### Available Actions
@@ -46,14 +44,25 @@ This test suite provides automated testing of the PHP Booster integration proces
 ### Examples
 
 ```bash
-# Test with custom project directory
-./test-integration.py setup laravel my-app --target-dir /tmp/my-test
-
-# Test Symfony project
-./test-integration.py full symfony symfony-test
+# Makefile shortcuts
+make test              # Run full Laravel integration test
+make test-symfony      # Run full Symfony integration test
+make test-hooks        # Test git hooks functionality
+make test-env          # Check environment and requirements
+make test-status       # Show test environment status
+make test-clean        # Clean up all test environments
+
+# Python script directly
+./test-integration.py full laravel
+./test-integration.py full symfony
+./test-integration.py setup laravel
+./test-integration.py verify laravel
+./test-integration.py test-hooks laravel
+./test-integration.py status laravel
+./test-integration.py clean laravel
 
-# Check status of existing project
-./test-integration.py status laravel my-test-app
+# Custom target directory (advanced)
+./test-integration.py full laravel --target-dir /tmp/my-test
 ```
 
 ## Dependencies
@@ -125,32 +134,32 @@ Run `env-check` to verify all required commands are available:
 Check DDEV status and restart if needed:
 ```bash
 # Check DDEV status
-./test-integration.py status laravel my-project
+./test-integration.py status laravel
 
 # Resume a stopped project
-./test-integration.py setup-resume laravel my-project
+./test-integration.py setup-resume laravel
 ```
-./test-integration.py
-
-# Full test with specific framework
-./test-integration.py full symfony
 
-# Full test with custom project name
-./test-integration.py full laravel my-custom-project
-
-# Individual test steps
-./test-integration.py setup            # Only create and set up project
-./test-integration.py integrate        # Only run booster integration
-./test-integration.py verify           # Only verify integration worked
-./test-integration.py test-hooks       # Only test git hooks and branch validation
-./test-integration.py status           # Show current test environment status
-./test-integration.py clean            # Clean up test environment
+## Command Reference
 
+```bash
 # Environment check
 ./test-integration.py env-check
 
-# Custom target directory
-./test-integration.py full laravel custom-project /path/to/target
+# Full test (complete suite)
+./test-integration.py full laravel
+./test-integration.py full symfony
+
+# Individual test steps
+./test-integration.py setup laravel      # Only create and set up project
+./test-integration.py integrate laravel  # Only run booster integration
+./test-integration.py verify laravel     # Only verify integration worked
+./test-integration.py test-hooks laravel # Only test git hooks
+./test-integration.py status laravel     # Show status
+./test-integration.py clean laravel      # Clean up
+
+# Custom target directory (advanced use case)
+./test-integration.py full laravel --target-dir /path/to/target
 ```
 
 **Available Actions:**
@@ -168,6 +177,8 @@ Check DDEV status and restart if needed:
 - `laravel` (default)
 - `symfony`
 
+**Note:** Project name is fixed as `booster-test` to ensure consistent, reproducible test environments.
+
 ## GitHub Actions
 
 Integration tests are automatically run via GitHub Actions on:
@@ -185,8 +196,8 @@ The workflow uses the same Python test script and provides the same comprehensiv
 The Python test script provides comprehensive verification:
 
 ### Project Setup
-- Creates fresh Laravel or Symfony projects using DDEV with framework-specific naming
-- Framework-specific project names prevent DDEV conflicts (e.g., `booster-test-laravel`, `booster-test-symfony`)
+- Creates fresh Laravel or Symfony projects using DDEV
+- Fixed project name `booster-test` ensures consistent test environments
 - Initializes git repository with proper configuration
 - Sets up DDEV containers and services with unique project identification
 
@@ -227,21 +238,22 @@ The test script provides:
 
 ## Cleaning Up
 
-The Python script creates test projects with framework-specific naming:
-- Laravel: `tests/laravel/booster-test-laravel` 
-- Symfony: `tests/symfony/booster-test-symfony`
-
-This prevents DDEV project name conflicts when testing multiple frameworks.
+The test script creates projects in:
+- Laravel: `tests/laravel/booster-test` 
+- Symfony: `tests/symfony/booster-test`
 
 To clean up:
 ```bash
-# Automatic cleanup (specify framework)
+# Using Makefile (recommended)
+make test-clean
+
+# Or using Python script directly
 ./test-integration.py clean laravel
 ./test-integration.py clean symfony
 
-# Manual cleanup example
-cd tests/laravel/booster-test-laravel && ddev delete -y
-rm -rf tests/laravel/booster-test-laravel
+# Manual cleanup example (if needed)
+cd tests/laravel/booster-test && ddev delete -y
+rm -rf tests/laravel/booster-test
 ```
 
 ## Local Development Mode
@@ -253,5 +265,9 @@ For testing local changes to the booster before committing:
 # Set these environment variables if needed:
 export BOOSTER_LOCAL_DEV=1
 export BOOSTER_LOCAL_PATH="/path/to/booster"
-./test-integration.py full
+
+# Run tests
+make test
+# or
+./test-integration.py full laravel
 ```

tools/internal-test/test-integration.py

@@ -22,21 +22,21 @@ def create_config() -> Config:
         epilog="""
 Examples:
   %(prog)s env-check                    # Check environment and requirements
-  %(prog)s setup laravel my-test-app    # Set up a Laravel test project
-  %(prog)s integrate laravel my-test-app # Integrate booster into existing project
-  %(prog)s full laravel my-test-app     # Run complete test suite
-  %(prog)s test-hooks laravel my-test-app # Test git hooks functionality
-  %(prog)s test-github-actions laravel my-test-app # Test GitHub Actions integration
+  %(prog)s setup laravel                # Set up a Laravel test project
+  %(prog)s integrate laravel            # Integrate booster into existing project
+  %(prog)s full laravel                 # Run complete test suite
+  %(prog)s test-hooks laravel           # Test git hooks functionality
+  %(prog)s test-github-actions laravel  # Test GitHub Actions integration
   %(prog)s test-interactive             # Test interactive mode without requiring a project
-  %(prog)s test-interactive-project laravel my-test-app # Test interactive mode with a project
-  %(prog)s test-interactive-project laravel my-test-app --automated # Automated interactive test
+  %(prog)s test-interactive-project laravel # Test interactive mode with a project
+  %(prog)s test-interactive-project laravel --automated # Automated interactive test
   %(prog)s clean-interactive-test       # Clean up interactive test directory
-  %(prog)s clean laravel my-test-app    # Clean up test environment
-  %(prog)s status laravel my-test-app   # Show current status
+  %(prog)s clean laravel                # Clean up test environment
+  %(prog)s status laravel               # Show current status
 
 Supported project types: laravel, symfony
 
-The script creates test projects in tests/<project_type>/<project_name>
+The script creates test projects in tests/<project_type>/booster-test
 relative to the repository root unless --target-dir is specified.
 """,
     )
@@ -70,17 +70,10 @@ def create_config() -> Config:
         help="Type of project to create (default: laravel)",
     )
 
-    parser.add_argument(
-        "project_name",
-        nargs="?",
-        default="test-project",
-        help="Name of the test project (default: test-project)",
-    )
-
     parser.add_argument(
         "--target-dir",
         type=Path,
-        help="Target directory for the test project (default: tests/<project_type>/<project_name>)",
+        help="Target directory for the test project (default: tests/<project_type>/booster-test)",
     )
 
     parser.add_argument(
@@ -91,20 +84,23 @@ def create_config() -> Config:
 
     args = parser.parse_args()
 
+    # Use fixed project name
+    project_name = "booster-test"
+
     # Determine paths
     script_dir = Path(__file__).parent.absolute()
     root_dir = script_dir.parent.parent
 
     # Set target directory
     if args.target_dir is None:
-        target_dir = root_dir / "tests" / args.project_type / args.project_name
+        target_dir = root_dir / "tests" / args.project_type / project_name
     else:
         target_dir = Path(args.target_dir)
 
     return Config(
         action=args.action,
         project_type=args.project_type,
-        project_name=args.project_name,
+        project_name=project_name,
         target_dir=target_dir,
         script_dir=script_dir,
         root_dir=root_dir,