captainhook: Fatal Error During Execution After Branch Change

We use local Composer repositories, so our composer.json contains something like this:

"local-packages": {
    "type": "path",
    "url": "./local-packages/*/*"
}

This means that our local packages reside under ./local-packages/Namespace/Module and can be included via Composer. Since these are client-specific packages, we require the @dev version from it. This way, the modules are symlinked into the vendor directory and we always have the latest version installed. Example:

$ ll vendor/namespace/module
lrwxrwxrwx 1 www-data tape 23 May  6 07:52 vendor/namespace/module -> ../../local-packages/Namespace/Module

When I now switch branches and one of these local modules is not available in the new branch, we have a broken symlink and I get a fatal error during the CaptainHook execution:

$ vendor/captainhook/captainhook/bin/captainhook -vvv                                                                                07:49:25
PHP Warning:  require(/var/www/html/vendor/composer/../namespace/module/registration.php): failed to open stream: No such file or directory in /var/www/html/vendor/composer/autoload_real.php on line 75

Warning: require(/var/www/html/vendor/composer/../namespace/module/registration.php): failed to open stream: No such file or directory in /var/www/html/vendor/composer/autoload_real.php on line 75
PHP Fatal error:  require(): Failed opening required '/var/www/html/vendor/composer/../namespace/module/registration.php' (include_path='/var/www/html/vendor/magento/zendframework1/library:.:/usr/share/pear:/usr/share/php') in /var/www/html/vendor/composer/autoload_real.php on line 75

Fatal error: require(): Failed opening required '/var/www/html/vendor/composer/../namespace/module/registration.php' (include_path='/var/www/html/vendor/magento/zendframework1/library:.:/usr/share/pear:/usr/share/php') in /var/www/html/vendor/composer/autoload_real.php on line 75

It breaks exactly at the line require CAPTAINHOOK_COMPOSER_AUTOLOAD; of bin/captainhook. I tried dumping the autoloader via composer dump-autoload before the hook execution, but even this does not work. Only a composer install before the hook execution fixes the issue.

Do you see any way to fix this, @sebastianfeldmann? My current idea would be to wrap the require call in a try-catch-block and if an exception occurs, run composer install automagically and try to require the autoload file again. I think this should work, but not sure if you find this workaround acceptable…?