Add ProjectZomboidServerLog (DebugLog-server.txt)

Concrete Log subclass for the engine debug log. Captures time, level,
and subsystem prefix per entry; stack-trace continuation lines attach
to the triggering ERROR entry via PatternParser's append-on-no-match
behaviour. Detectors: filename match on DebugLog-server.txt plus two
content signatures (the version=X.Y.Z+hash banner and the level/
subsystem/f/t/st header shape). Pattern constants live in
src/Pattern/ProjectZomboid/DebugServerPattern.php with named groups
ready for analyser use in phase B. Synthetic fixture under
test/src/Games/ProjectZomboid/fixtures/ uses zeroed identifiers and
placeholder paths.
This commit is contained in:
2026-04-30 20:34:03 +00:00
parent c032fd34b8
commit d863fae9e6
5 changed files with 170 additions and 0 deletions

View File

@@ -0,0 +1,54 @@
<?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\DebugServerPattern;
/**
* Project Zomboid engine debug log (DebugLog-server.txt).
*
* Multi-line format: ERROR entries are followed by tab-indented stack trace
* frames. PatternParser handles continuation by appending non-matching lines
* to the most recent Entry, which is exactly the behaviour we need.
*/
class ProjectZomboidServerLog extends ProjectZomboidLog
{
public static function getDefaultParser(): ParserInterface
{
return static::makePatternParser(
DebugServerPattern::LINE,
[PatternParser::TIME, PatternParser::LEVEL, PatternParser::PREFIX]
);
}
public static function getDefaultAnalyser(): AnalyserInterface
{
return new PatternAnalyser();
}
public static function getDetectors(): array
{
return [
(new FilenameDetector())
->setPattern('/DebugLog-server\.txt$/')
->setWeight(0.95),
(new WeightedSinglePatternDetector())
->setPattern('/version=\d+\.\d+\.\d+ [a-f0-9]{40}/')
->setWeight(0.95),
(new WeightedSinglePatternDetector())
->setPattern('/^\[\d{2}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\.\d{3}\] (?:LOG|WARN|ERROR):\s+\w+\s+f:\d+, t:\d+, st:[\d,]+>/m')
->setWeight(0.80),
];
}
public function getTitle(): string
{
return "Project Zomboid Debug Server Log";
}
}