Add AdminAddedItemInformation insight

src/Analysis/ProjectZomboid/AdminAddedItemInformation.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace IndifferentKetchup\Codex\Analysis\ProjectZomboid;
+
+use IndifferentKetchup\Codex\Analysis\Information;
+use IndifferentKetchup\Codex\Analysis\PatternInsightInterface;
+use IndifferentKetchup\Codex\Pattern\ProjectZomboid\AdminPattern;
+
+class AdminAddedItemInformation extends Information implements PatternInsightInterface
+{
+    public static function getPatterns(): array
+    {
+        return [AdminPattern::ADDED_ITEM_ENTRY];
+    }
+
+    public function setMatches(array $matches, mixed $patternKey): void
+    {
+        $this->setLabel('Admin added item');
+        $this->setValue(sprintf(
+            '%s added %s to %s',
+            $matches['admin'],
+            $matches['item'],
+            $matches['target']
+        ));
+    }
+}

src/Pattern/ProjectZomboid/AdminPattern.php

@@ -25,4 +25,12 @@ class AdminPattern
     public const string RELOADED_OPTIONS = '/^(?<admin>.+?) reloaded options$/';
 
     public const string TELEPORTED = '/^(?<admin>.+?) teleported (?<target>.+?) to (?<x>\d+),(?<y>\d+),(?<z>-?\d+)$/';
-}
+
+    /**
+     * Entry-anchored variants for analyser use. PatternAnalyser passes the
+     * full Entry text (including the [time] prefix) to preg_match_all, so
+     * these include the timestamp prefix and are anchored at start/end of
+     * the line. The body-only constants above are kept for direct-message
+     * matching.
+     */
+    public const string ADDED_ITEM_ENTRY = '/^\[\d{2}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\.\d{3}\] (?<admin>.+?) added item (?<item>Base\.\S+) in (?<target>.+?)\'s inventory\.?$/';

test/tests/Games/ProjectZomboid/Analysis/AdminAddedItemInformationTest.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace IndifferentKetchup\Codex\Test\Tests\Games\ProjectZomboid\Analysis;
+
+use IndifferentKetchup\Codex\Analysis\ProjectZomboid\AdminAddedItemInformation;
+use IndifferentKetchup\Codex\Pattern\ProjectZomboid\AdminPattern;
+use PHPUnit\Framework\TestCase;
+
+class AdminAddedItemInformationTest extends TestCase
+{
+    public function testGetPatternsReturnsEntryRegex(): void
+    {
+        $this->assertSame([AdminPattern::ADDED_ITEM_ENTRY], AdminAddedItemInformation::getPatterns());
+    }
+
+    public function testEntryRegexMatchesFullLine(): void
+    {
+        $line = "[16-04-26 18:33:34.289] AdminUser added item Base.ShotgunShells in Player1's inventory.";
+        $this->assertSame(1, preg_match(AdminPattern::ADDED_ITEM_ENTRY, $line, $m));
+
+        $insight = new AdminAddedItemInformation();
+        $insight->setMatches($m, 0);
+
+        $this->assertSame('Admin added item', $insight->getLabel());
+        $this->assertSame('AdminUser added Base.ShotgunShells to Player1', $insight->getValue());
+    }
+
+    public function testIsEqualCoalescesIdenticalAddedItem(): void
+    {
+        $a = $this->insightFor('AdminUser', 'Base.X', 'Player1');
+        $b = $this->insightFor('AdminUser', 'Base.X', 'Player1');
+        $c = $this->insightFor('AdminUser', 'Base.Y', 'Player1');
+
+        $this->assertTrue($a->isEqual($b));
+        $this->assertFalse($a->isEqual($c));
+    }
+
+    private function insightFor(string $admin, string $item, string $target): AdminAddedItemInformation
+    {
+        $insight = new AdminAddedItemInformation();
+        $insight->setMatches([
+            'admin' => $admin,
+            'item' => $item,
+            'target' => $target,
+        ], 0);
+        return $insight;
+    }
+}