From 27424f6a14e42dcc0b4738a62bc9361717cc88ba Mon Sep 17 00:00:00 2001
From: indifferentketchup <samkintop@gmail.com>
Date: Thu, 30 Apr 2026 20:42:52 +0000
Subject: [PATCH] Add ProjectZomboidBurdJournalsLog (BurdJournals.txt)

Per-line warnings emitted by the BurdJournals mod, format
'[time] [BurdJournals] LEVEL: message.'. Parser captures time, the
[BurdJournals] tag as the entry prefix, and the LEVEL token. Detectors:
filename match plus content signature on the literal '[BurdJournals]'
tag bracket.
---
 .../ProjectZomboidBurdJournalsLog.php         | 44 +++++++++++++++++++
 .../ProjectZomboid/BurdJournalsPattern.php    | 18 ++++++++
 .../fixtures/burd-journals-minimal.txt        |  5 +++
 .../Log/ProjectZomboidBurdJournalsLogTest.php | 44 +++++++++++++++++++
 4 files changed, 111 insertions(+)
 create mode 100644 src/Log/ProjectZomboid/ProjectZomboidBurdJournalsLog.php
 create mode 100644 src/Pattern/ProjectZomboid/BurdJournalsPattern.php
 create mode 100644 test/src/Games/ProjectZomboid/fixtures/burd-journals-minimal.txt
 create mode 100644 test/tests/Games/ProjectZomboid/Log/ProjectZomboidBurdJournalsLogTest.php

diff --git a/src/Log/ProjectZomboid/ProjectZomboidBurdJournalsLog.php b/src/Log/ProjectZomboid/ProjectZomboidBurdJournalsLog.php
new file mode 100644
index 0000000..9f039c3
--- /dev/null
+++ b/src/Log/ProjectZomboid/ProjectZomboidBurdJournalsLog.php
@@ -0,0 +1,44 @@
+<?php
+
+namespace IndifferentKetchup\Codex\Log\ProjectZomboid;
+
+use IndifferentKetchup\Codex\Analyser\AnalyserInterface;
+use IndifferentKetchup\Codex\Analyser\PatternAnalyser;
+use IndifferentKetchup\Codex\Detective\FilenameDetector;
+use IndifferentKetchup\Codex\Detective\WeightedSinglePatternDetector;
+use IndifferentKetchup\Codex\Parser\ParserInterface;
+use IndifferentKetchup\Codex\Parser\PatternParser;
+use IndifferentKetchup\Codex\Pattern\ProjectZomboid\BurdJournalsPattern;
+
+class ProjectZomboidBurdJournalsLog extends ProjectZomboidEventLog
+{
+    public static function getDefaultParser(): ParserInterface
+    {
+        return static::makePatternParser(
+            BurdJournalsPattern::LINE,
+            [PatternParser::TIME, PatternParser::PREFIX, PatternParser::LEVEL]
+        );
+    }
+
+    public static function getDefaultAnalyser(): AnalyserInterface
+    {
+        return new PatternAnalyser();
+    }
+
+    public static function getDetectors(): array
+    {
+        return [
+            (new FilenameDetector())
+                ->setPattern('/_BurdJournals\.txt$/')
+                ->setWeight(0.95),
+            (new WeightedSinglePatternDetector())
+                ->setPattern('/\[BurdJournals\]/')
+                ->setWeight(0.95),
+        ];
+    }
+
+    public function getTitle(): string
+    {
+        return "Project Zomboid BurdJournals Mod Log";
+    }
+}
diff --git a/src/Pattern/ProjectZomboid/BurdJournalsPattern.php b/src/Pattern/ProjectZomboid/BurdJournalsPattern.php
new file mode 100644
index 0000000..6c556b1
--- /dev/null
+++ b/src/Pattern/ProjectZomboid/BurdJournalsPattern.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace IndifferentKetchup\Codex\Pattern\ProjectZomboid;
+
+/**
+ * Regex constants for the Project Zomboid BurdJournals.txt format.
+ *
+ *   [time] [BurdJournals] LEVEL: message.
+ *
+ * LINE captures, in order:
+ *   1. time
+ *   2. tag    (e.g. BurdJournals)
+ *   3. level  (WARNING | ERROR | INFO | DEBUG)
+ */
+class BurdJournalsPattern
+{
+    public const string LINE = '/^\[(\d{2}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\.\d{3})\] \[(\w+)\] (WARNING|ERROR|INFO|DEBUG): .+\.?$/';
+}
diff --git a/test/src/Games/ProjectZomboid/fixtures/burd-journals-minimal.txt b/test/src/Games/ProjectZomboid/fixtures/burd-journals-minimal.txt
new file mode 100644
index 0000000..98a648a
--- /dev/null
+++ b/test/src/Games/ProjectZomboid/fixtures/burd-journals-minimal.txt
@@ -0,0 +1,5 @@
+[28-04-26 16:57:42.411] [BurdJournals] WARNING: Character ID mismatch in deleteBaseline! Client sent: local_a_b_c, Server computed: 0_a_b.
+[28-04-26 17:05:58.532] [BurdJournals] WARNING: Character ID mismatch in deleteBaseline! Client sent: local_d_e_f, Server computed: 0_d_e.
+[28-04-26 18:03:09.499] [BurdJournals] WARNING: No transferable recipes detected! authoritativeKnown=0 excludeStarting=false.
+[28-04-26 18:06:10.282] [BurdJournals] WARNING: Character ID mismatch in deleteBaseline! Client sent: local_g_h_i, Server computed: 0_g_h.
+[28-04-26 18:08:36.070] [BurdJournals] WARNING: No transferable recipes detected! authoritativeKnown=0 excludeStarting=false.
diff --git a/test/tests/Games/ProjectZomboid/Log/ProjectZomboidBurdJournalsLogTest.php b/test/tests/Games/ProjectZomboid/Log/ProjectZomboidBurdJournalsLogTest.php
new file mode 100644
index 0000000..2e112ee
--- /dev/null
+++ b/test/tests/Games/ProjectZomboid/Log/ProjectZomboidBurdJournalsLogTest.php
@@ -0,0 +1,44 @@
+<?php
+
+namespace IndifferentKetchup\Codex\Test\Tests\Games\ProjectZomboid\Log;
+
+use IndifferentKetchup\Codex\Detective\Detective;
+use IndifferentKetchup\Codex\Log\File\PathLogFile;
+use IndifferentKetchup\Codex\Log\Level;
+use IndifferentKetchup\Codex\Log\ProjectZomboid\ProjectZomboidBurdJournalsLog;
+use PHPUnit\Framework\TestCase;
+
+class ProjectZomboidBurdJournalsLogTest extends TestCase
+{
+    private function fixturePath(): string
+    {
+        return __DIR__ . '/../../../../src/Games/ProjectZomboid/fixtures/burd-journals-minimal.txt';
+    }
+
+    public function testParsesEachLineAsAnEntry(): void
+    {
+        $log = (new ProjectZomboidBurdJournalsLog())->setLogFile(new PathLogFile($this->fixturePath()));
+        $log->parse();
+
+        $this->assertCount(5, $log->getEntries());
+    }
+
+    public function testLevelAndPrefixAreParsed(): void
+    {
+        $log = (new ProjectZomboidBurdJournalsLog())->setLogFile(new PathLogFile($this->fixturePath()));
+        $log->parse();
+
+        $first = $log->getEntries()[0];
+        $this->assertSame(Level::WARNING, $first->getLevel());
+        $this->assertSame('BurdJournals', $first->getPrefix());
+    }
+
+    public function testDetectiveDispatchesByContent(): void
+    {
+        $detective = (new Detective())
+            ->setLogFile(new PathLogFile($this->fixturePath()))
+            ->addPossibleLogClass(ProjectZomboidBurdJournalsLog::class);
+
+        $this->assertInstanceOf(ProjectZomboidBurdJournalsLog::class, $detective->detect());
+    }
+}