Files
WP-LIT-MCP/tests/Unit/Abilities/ErrorsTest.php
T
janniclas.loosenandClaude Opus 5.5 fea75b03d6 docs: name tools and error codes the way the client sees them
Indirect abilities are written lit/<name> (via mcp-adapter-execute-ability) in
guides, descriptions and hints, direct tools lit-<name>; guides use the
client-visible codes (write_failed, partial_write) and say exactly which tools
return a revision_id. ToolNamingTest keeps guides and sources consistent with
Ability::isDirect() and checks the overview's direct-tool list.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01At3V6SjwbMe6eMzVGW3Hs7
2026-09-26 01:28:18 +02:00

94 lines
3.8 KiB
PHP

<?php
declare(strict_types=1);
namespace LIT\MCP\Tests\Unit\Abilities;
use LIT\MCP\Abilities\Errors;
use LIT\MCP\Tests\Unit\TestCase;
final class ErrorsTest extends TestCase
{
public function testMessageCarriesCodeMessageHintAndFieldsAsJson(): void
{
$error = Errors::invalidInput('Titel fehlt.', ['title' => 'Pflichtfeld']);
self::assertSame('lit_validation_failed', $error->get_error_code());
$payload = json_decode($error->get_error_message(), true);
self::assertSame('validation_failed', $payload['code']);
self::assertSame('Titel fehlt.', $payload['message']);
self::assertNotSame('', $payload['hint']);
self::assertSame(['title' => 'Pflichtfeld'], $payload['fields']);
self::assertSame(400, $error->get_error_data()['status']);
self::assertSame($payload['hint'], $error->get_error_data()['hint']);
}
public function testUmlautsStayReadableInTheMessage(): void
{
$error = Errors::forbidden('Dein Benutzerkonto ist für LIT MCP nicht freigegeben.');
self::assertStringContainsString('für LIT MCP nicht freigegeben', $error->get_error_message());
}
public function testInUseCarriesTheUsages(): void
{
$error = Errors::inUse('Bild wird verwendet.', [['post_id' => 7, 'where' => 'featured']]);
$payload = json_decode($error->get_error_message(), true);
self::assertSame('lit_in_use', $error->get_error_code());
self::assertSame(7, $payload['usages'][0]['post_id']);
}
public function testEveryFactoryUsesLitPrefixAndANonEmptyHint(): void
{
$errors = [
Errors::forbidden('x'),
Errors::notFound('x'),
Errors::revMismatch(),
Errors::confirmRequired('x'),
Errors::unsupported('x', 'y'),
Errors::internal(),
];
foreach ($errors as $error) {
self::assertStringStartsWith('lit_', $error->get_error_code());
self::assertNotSame('', json_decode($error->get_error_message(), true)['hint']);
}
}
public function testWriteFailedSaysNothingWasSaved(): void
{
$error = Errors::writeFailed('Felder konnten nicht gespeichert werden.');
$payload = json_decode($error->get_error_message(), true);
self::assertSame('lit_write_failed', $error->get_error_code());
self::assertStringContainsString('Nichts wurde gespeichert.', $payload['message']);
self::assertStringContainsString('Felder konnten nicht gespeichert werden.', $payload['message']);
self::assertStringContainsString('erneut', $payload['hint']);
}
public function testPartialWriteNamesWhatMayHaveBeenSavedAndWarnsAgainstRetrying(): void
{
$error = Errors::partialWrite('Felder konnten nicht gespeichert werden.', 5, 811);
$payload = json_decode($error->get_error_message(), true);
self::assertSame('lit_partial_write', $error->get_error_code());
self::assertStringContainsString('Eintrag 5', $payload['message']);
self::assertStringContainsString('Revision 811', $payload['message']);
self::assertStringContainsString('lit-content-get', $payload['hint']);
self::assertStringContainsString('lit/revisions-list', $payload['hint']);
self::assertStringContainsString('mcp-adapter-execute-ability', $payload['hint']);
self::assertStringContainsString('nicht einfach wiederholen', $payload['hint']);
self::assertSame(5, $payload['post_id']);
self::assertSame(811, $payload['revision_id']);
}
public function testPartialWriteWithoutIdSaysADraftMayExist(): void
{
$payload = json_decode(Errors::partialWrite('Anlegen fehlgeschlagen.')->get_error_message(), true);
self::assertStringContainsString('Entwurf', $payload['message']);
self::assertArrayNotHasKey('post_id', $payload);
}
}