feat: Signatur-Fingerabdruck der Divi-Aufrufe (Reflection); fingerprints.json enthält sig:-Einträge, divi-check --update-reference schreibt sie; Referenz für Divi 5.15.1

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
Jan-Niclas Loosen
2026-10-18 22:01:56 +02:00
co-authored by Claude Sonnet 5.5
parent 392fe7c569
commit 710444e88d
8 changed files with 525 additions and 20 deletions
@@ -4,25 +4,99 @@ declare(strict_types=1);
namespace LIT\MCP\Tests\Unit\Integrations\Divi\Release;
use LIT\MCP\Integrations\Divi\Release\Call;
use LIT\MCP\Integrations\Divi\Release\DiviAdapters;
use LIT\MCP\Integrations\Divi\Release\DiviReference;
use LIT\MCP\Integrations\Divi\Release\SignatureFingerprint;
use PHPUnit\Framework\TestCase;
use RuntimeException;
final class DiviReferenceTest extends TestCase
{
public function testEveryMirrorHasAnExpectedFingerprintAndAReferenceSource(): void
public function testEveryMirrorAndEveryCallHasAnExpectedFingerprintAndEveryMirrorAReferenceSource(): void
{
$ids = array_map(static fn ($mirror): string => $mirror->id, DiviAdapters::mirrors());
sort($ids);
$mirrorIds = array_map(static fn ($mirror): string => $mirror->id, DiviAdapters::mirrors());
$signatureKeys = [];
foreach (DiviAdapters::manifests() as $manifest) {
foreach ($manifest->calls as $call) {
$signatureKeys[] = 'sig:' . ltrim($call->symbol, '\\');
}
}
$keys = array_values(array_unique(array_merge($mirrorIds, $signatureKeys)));
sort($keys);
$expected = DiviReference::expected();
self::assertSame($ids, array_keys($expected));
foreach ($expected as $id => $hash) {
self::assertMatchesRegularExpression('/^[0-9a-f]{64}$/', $hash, $id);
self::assertSame($keys, array_keys($expected));
foreach ($expected as $key => $hash) {
self::assertMatchesRegularExpression('/^[0-9a-f]{64}$/', $hash, $key);
}
foreach ($mirrorIds as $id) {
self::assertNotNull(DiviReference::readSource($id, (string) DiviReference::sourceDir()), $id);
}
}
public function testEverySignatureKeyStartsWithThePrefixNoMirrorIdUses(): void
{
foreach (DiviAdapters::mirrors() as $mirror) {
self::assertStringStartsNotWith(DiviReference::SIGNATURE_PREFIX, $mirror->id);
}
self::assertSame('sig:et_pb_is_allowed', DiviReference::signatureKey(new Call('et_pb_is_allowed', 1)));
self::assertSame(
'sig:ET_Core_PageResource::remove_static_resources',
DiviReference::signatureKey(new Call('\\ET_Core_PageResource::remove_static_resources', 3))
);
}
public function testCallsListsEverySymbolOnceAcrossTheManifests(): void
{
$symbols = array_map(static fn (Call $call): string => ltrim($call->symbol, '\\'), DiviAdapters::calls());
self::assertSame($symbols, array_values(array_unique($symbols)));
self::assertContains('ET_Core_PageResource::remove_static_resources', $symbols);
self::assertCount(1, array_keys($symbols, 'ET_Core_PageResource::remove_static_resources', true));
self::assertContains('et_pb_is_allowed', $symbols);
}
public function testCurrentSignaturesAreSortedAndKeyedLikeTheReference(): void
{
$signatures = DiviReference::currentSignatures([
new Call('strlen', 1),
new Call('\\str_replace', 3),
new Call('strlen', 1),
]);
self::assertSame(['sig:str_replace', 'sig:strlen'], array_keys($signatures));
self::assertSame(SignatureFingerprint::of(new Call('strlen')), $signatures['sig:strlen']);
}
public function testCurrentSignaturesRefuseASymbolThatIsNotLoaded(): void
{
$this->expectException(RuntimeException::class);
$this->expectExceptionMessage('signature of lit_mcp_missing_function(): symbol is not loaded');
DiviReference::currentSignatures([new Call('strlen', 1), new Call('lit_mcp_missing_function', 0)]);
}
public function testSignatureKeysAreWrittenAndReadLikeMirrorIds(): void
{
$file = (string) tempnam(sys_get_temp_dir(), 'lit');
try {
DiviReference::writeExpected([
'sig:Z\\Klass::run' => str_repeat('c', 64),
'tb-api-save' => str_repeat('b', 64),
'sig:a_function' => str_repeat('a', 64),
], $file);
self::assertSame(
['sig:Z\\Klass::run', 'sig:a_function', 'tb-api-save'],
array_keys(DiviReference::expected($file))
);
} finally {
unlink($file);
}
}
public function testWritesAndReadsExpectedFingerprintsSorted(): void
{
$file = (string) tempnam(sys_get_temp_dir(), 'lit');