[tyrsson]

PhpDb\Sql\Exception\ExceptionInterface no longer exists. Commit 01a9406b in php-db/phpdb, "Make PhpDb\Exception\ExceptionInterface the only marker, extending Throwable", removed the Sql namespaced one.

This is a prerequisite for #92, which crosses that commit and currently fails mago analyze:

error[non-existent-use-import]: Imported class, interface, trait, or enum
`PhpDb\Sql\Exception\ExceptionInterface` does not exist.

Why the import cannot simply be left alone

The removed interface was not a supertype of the new one. When the import cannot resolve, analyze has no type to match against, so every throwable in the hierarchy becomes unhandled and no @throws tag can cover it. The unhandled-thrown-type error follows from the missing class, not from a separate defect.

Two files, not one

File	Use
src/Console/InitDbCommand.php	aliased as SqlException
src/Handler/PhpDbHandler.php	direct import, used by the write() docblock

The second only surfaced after fixing the first, because analyze reports the first failure and the earlier CI log tail showed only the handler.

The replacement is stricter, not looser

PhpDb\Exception\ExceptionInterface extends Throwable, and every exception in the hierarchy implements it. The Sql namespaced subclasses extend their PhpDb\Exception counterparts:

class InvalidArgumentException extends Exception\InvalidArgumentException
class RuntimeException extends Exception\RuntimeException

so PhpDb\Sql\Exception\InvalidArgumentException is still covered by a @throws PhpDb\Exception\ExceptionInterface tag.

Verified against the failure, not just the current pin

• confirmed the old interface is absent at 7d1b659 and present at 69c8da3, and that 01a9406b is not an ancestor of the current pin, which is why 2.0.x is green today
• temporarily moved php-db/phpdb to 7d1b659 and reproduced the CI failure, then confirmed analyze clean with the fix
• mago analyze at 7d1b659: no issues
• restored the lock, so this PR is source only and does not collide with Lock file maintenance #92

Gates at the current pin, phpdb 69c8da3:

• mago format --check: already formatted
• mago lint: no issues
• mago analyze: no issues
• mago guard: no issues
• composer test: 100 tests, 179 assertions, OK

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!