modwright 0.1.0

package/dist/surfaces/cyberpunk2077/logs.js

@@ -0,0 +1,742 @@
+const GAME = "cyberpunk2077";
+const PRE = String.raw `^(?:\[[^\]]*\]\s*){0,4}(?:\|[^|]*\|\s*)?`;
+const LEVEL_PRE = String.raw `^(?:\[[^\]]*\]\s*){0,3}\[(?:error|ERROR|err|warning|WARNING|warn|WARN)\]\s*(?:\[[^\]]*\]\s*){0,2}(?:\|[^|]*\|\s*)?`;
+function re(...parts) {
+    return new RegExp(parts.join(""));
+}
+const FIXTURES = "test/fixtures/logs/cp2077";
+const REAL = "test/fixtures/logs/cp2077/real";
+const CDPR_LOGS_DOC = "https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-users/user-guide-troubleshooting/finding-and-reading-log-files";
+const RED4EXT = [
+    {
+        id: "cyberpunk2077.red4ext.initializing",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "info",
+        category: "version",
+        pattern: re(PRE, String.raw `RED4ext \(v(?<version>[^)\s]+)\) is initializing`),
+        explain: "RED4ext started and reported its own version. This is the version every " +
+            "native plugin (ArchiveXL, TweakXL, Codeware) is checked against, so read " +
+            "it before blaming a plugin.",
+        hint: "If plugins below this line fail, compare this version against the game " +
+            "build on the next line: after a game patch RED4ext usually needs updating first.",
+        seenIn: [
+            `${FIXTURES}/red4ext.synthetic.log`,
+            "https://github.com/WopsS/RED4ext/issues/33",
+        ],
+        extract: ["version"],
+    },
+    {
+        id: "cyberpunk2077.red4ext.game-patch",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "info",
+        category: "version",
+        pattern: re(PRE, String.raw `Game patch: (?<patch>[^\n]+)$`),
+        explain: "The game build RED4ext detected. 'Unknown patch (...)' here means the game " +
+            "updated to a build this RED4ext release has never seen, which is the single " +
+            "most common cause of every native mod going silent after a Steam/GOG update.",
+        hint: "Match this build against the RED4ext release notes; if it says Unknown patch, " +
+            "update RED4ext (or roll the game back) before touching individual mods.",
+        seenIn: [
+            `${FIXTURES}/red4ext.synthetic.log`,
+            "https://github.com/WopsS/RED4ext/issues/33",
+        ],
+        extract: ["patch"],
+    },
+    {
+        id: "cyberpunk2077.red4ext.game-version",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "info",
+        category: "version",
+        pattern: re(PRE, String.raw `Product version: (?<version>\d[\w.]*)\s*$`),
+        explain: "RED4ext printed the game's marketing version (2.31 and so on) as it sees it. RED4ext " +
+            "1.30 prints this and a 'File version:' line instead of the older 'Game patch:' line.",
+        hint: "Compare against the game version each plugin's Nexus page states it was built for; " +
+            "a plugin newer or older than this build is the first suspect after a patch.",
+        seenIn: [`${REAL}/red4ext.log`],
+        extract: ["version"],
+    },
+    {
+        id: "cyberpunk2077.red4ext.initialized",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "info",
+        category: "success",
+        pattern: re(PRE, String.raw `RED4ext has (?:been successfully )?initialized`),
+        explain: "RED4ext hooked the game successfully. Everything it hosts — ArchiveXL, " +
+            "TweakXL, Codeware and their dependents — had a chance to run this launch.",
+        seenIn: [`${REAL}/red4ext.log`, `${FIXTURES}/red4ext.synthetic.log`, CDPR_LOGS_DOC],
+    },
+    {
+        id: "cyberpunk2077.red4ext.plugin-loaded",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "info",
+        category: "success",
+        pattern: re(PRE, String.raw `(?<plugin>[^\[\]|\n]+?) \(version: (?<version>[^,)\n]+)`, String.raw `(?:, author\(s\): (?<author>[^)\n]*))?\) has been loaded`),
+        explain: "A native RED4ext plugin loaded, with the exact version now in play. This is " +
+            "the authoritative answer to 'is ArchiveXL/TweakXL/Codeware actually installed " +
+            "and running', which mod managers report unreliably.",
+        hint: "If a mod's required framework is missing from this list, install it; the " +
+            "version here is what a compatibility matrix should be checked against.",
+        seenIn: [`${FIXTURES}/red4ext.synthetic.log`, CDPR_LOGS_DOC],
+        extract: ["plugin", "version", "author"],
+    },
+    {
+        id: "cyberpunk2077.red4ext.plugins-loaded-count",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "info",
+        category: "success",
+        pattern: re(PRE, String.raw `(?<count>\d+) plugin\(s\) loaded\s*$`),
+        explain: "RED4ext finished its plugin pass and reports how many DLLs it loaded. Compare the " +
+            "count against the folders under red4ext/plugins: a lower number means one was skipped.",
+        seenIn: [`${REAL}/red4ext.log`],
+        extract: ["count"],
+    },
+    {
+        id: "cyberpunk2077.red4ext.started",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "info",
+        category: "success",
+        pattern: re(PRE, String.raw `RED4ext has been started\s*$`),
+        explain: "RED4ext handed control back to the game with every plugin loaded. Lines after this " +
+            "one ('scc invoked successfully', 'Scripts blob path was updated') are redscript being " +
+            "driven by RED4ext.",
+        seenIn: [`${REAL}/red4ext.log`],
+    },
+    {
+        id: "cyberpunk2077.red4ext.plugin-load-failed",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "error",
+        category: "load",
+        pattern: re(PRE, String.raw `(?:Could not|Failed to|Unable to) load (?:the )?plugin ['"“](?<plugin>[^'"”\n]+)['"”]`, String.raw `(?:[^\n]*?\bError code: (?<code>\d+))?`),
+        explain: "RED4ext found a plugin DLL but Windows refused to load it. The plugin is not " +
+            "running, and every mod that depends on it will behave as if it were never " +
+            "installed — usually with no error of its own.",
+        hint: "Error code 1114 or 126 normally means the DLL was built for a different game " +
+            "build or a missing runtime: reinstall that plugin for the current game patch " +
+            "and check its own log for more.",
+        seenIn: [
+            "unverified: tolerant pattern",
+            `${CDPR_LOGS_DOC} (search-snippet quote of "Could not load plugin 'X'. Error code: 1114")`,
+        ],
+        extract: ["plugin", "code"],
+    },
+    {
+        id: "cyberpunk2077.red4ext.unsupported-patch",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "error",
+        category: "version",
+        pattern: re(PRE, String.raw `This game patch \((?<patch>[^\n]+)\) is not supported`),
+        explain: "RED4ext refuses to run against this game build, so no native plugin loads at " +
+            "all this launch. Everything downstream (TweakXL tweaks, ArchiveXL .xl files, " +
+            "Codeware-dependent scripts) is dead, and none of them will say so.",
+        hint: "Update RED4ext to a release that supports this build, or roll the game back " +
+            "to the supported patch named on the following line.",
+        seenIn: [
+            `${FIXTURES}/red4ext.synthetic.log`,
+            "https://github.com/WopsS/RED4ext/issues/33",
+        ],
+        extract: ["patch"],
+    },
+    {
+        id: "cyberpunk2077.red4ext.supported-patches",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "error",
+        category: "version",
+        pattern: re(PRE, String.raw `The current version of RED4ext supports only the following patch\(es\): (?<supported>[^\n]+)$`),
+        explain: "The companion line to the unsupported-patch error: this is the game build the " +
+            "installed RED4ext actually targets. The gap between it and the 'Game patch:' " +
+            "line above is the whole problem.",
+        hint: "Either update RED4ext, or roll the game back to this build (Steam: properties " +
+            "→ betas; GOG: an older offline installer).",
+        seenIn: [
+            `${FIXTURES}/red4ext.synthetic.log`,
+            "https://github.com/WopsS/RED4ext/issues/33",
+        ],
+        extract: ["supported"],
+    },
+    {
+        id: "cyberpunk2077.red4ext.hook-failed",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "error",
+        category: "load",
+        pattern: re(PRE, String.raw `Could not attach the hook for (?<target>[^\n]+?)\.\s*Detour error code: (?<code>\d+)`),
+        explain: "RED4ext could not install its detour into the game executable, so it never got " +
+            "control. Typically an overlay, anti-cheat or antivirus holding the process, or " +
+            "a game executable RED4ext does not recognize.",
+        hint: "Close overlays (Discord, RivaTuner, GeForce Experience), whitelist the game " +
+            "folder in your antivirus, and verify the game files; then check that " +
+            "winmm.dll is still in the game root.",
+        seenIn: ["https://github.com/WopsS/RED4ext/issues/58"],
+        extract: ["target", "code"],
+    },
+    {
+        id: "cyberpunk2077.red4ext.init-failed",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "error",
+        category: "load",
+        pattern: re(PRE, String.raw `RED4ext did not initialize properly`),
+        explain: "RED4ext gave up during startup. The game will still launch, but with zero " +
+            "native plugins — treat every other mod symptom this run as a consequence of " +
+            "this line, not as its own bug.",
+        hint: "Read the error immediately above this line (unsupported patch, hook failure or " +
+            "a plugin load failure); fixing that fixes this.",
+        seenIn: ["https://github.com/WopsS/RED4ext/issues/58"],
+    },
+    {
+        id: "cyberpunk2077.red4ext.thread-warning",
+        game: GAME,
+        sources: ["red4ext"],
+        severity: "warn",
+        category: "load",
+        pattern: re(PRE, String.raw `Could not open a thread\.[^\n]*The transaction will continue`),
+        explain: "Known benign RED4ext noise while it suspends threads to install its hooks. It " +
+            "appears in healthy logs and is not the cause of a mod not working.",
+        hint: "Ignore it; keep looking for an [error] line.",
+        seenIn: [
+            `${FIXTURES}/red4ext.synthetic.log`,
+            "https://github.com/WopsS/RED4ext/issues/112",
+        ],
+    },
+];
+const REDSCRIPT = [
+    {
+        id: "cyberpunk2077.redscript.output-saved",
+        game: GAME,
+        sources: ["redscript"],
+        severity: "info",
+        category: "success",
+        pattern: re(PRE, String.raw `Output successfully saved to (?<output>[^\n]+)$`),
+        explain: "redscript compiled every .reds file and wrote the modded script cache. Script " +
+            "mods are live this run; if one still does nothing, the problem is in its logic " +
+            "or its data, not in compilation.",
+        seenIn: [
+            `${FIXTURES}/redscript_rCURRENT.ok.synthetic.log`,
+            "https://wiki.redmodding.org/redscript/help/troubleshooting",
+        ],
+        extract: ["output"],
+    },
+    {
+        id: "cyberpunk2077.redscript.compilation-complete",
+        game: GAME,
+        sources: ["redscript"],
+        severity: "info",
+        category: "success",
+        pattern: re(PRE, String.raw `Compilation complete\s*$`),
+        explain: "The compiler finished every file in r6/scripts. Warnings above this line did not " +
+            "abort the compile; the 'Output successfully saved' line that follows is the proof the " +
+            "bundle was written.",
+        seenIn: [`${REAL}/redscript.log`],
+    },
+    {
+        id: "cyberpunk2077.redscript.compile-error",
+        game: GAME,
+        sources: ["redscript"],
+        severity: "error",
+        category: "compile",
+        pattern: /^\[ERROR\b[^\]]*\]\s*At (?<file>[^\n]+?\.(?:reds|script)):(?<line>\d+):(?<column>\d+):?/,
+        explain: "A .reds file failed to compile at this exact file, line and column. One broken " +
+            "file aborts the whole compile, so the game starts with NO script mods at all, " +
+            "not just this one — the diagnostic text follows on the next lines.",
+        hint: "Open the file at that line. If the code looks right, the API it calls probably " +
+            "changed in the last game patch, or Codeware/a dependency did not load (check " +
+            "red4ext.log first); remove the mod to confirm the rest compile.",
+        seenIn: [
+            `${FIXTURES}/redscript_rCURRENT.error.synthetic.log`,
+            `${CDPR_LOGS_DOC} (verbatim At <path>:<line>:<col> shape)`,
+        ],
+        extract: ["file", "line", "column"],
+    },
+    {
+        id: "cyberpunk2077.redscript.compile-warning",
+        game: GAME,
+        sources: ["redscript"],
+        severity: "warn",
+        category: "compile",
+        pattern: /^\[WARN(?:ING)?\b[^\]]*\]\s*At (?<file>[^\n]+?\.(?:reds|script)):(?<line>\d+):(?<column>\d+):?/,
+        explain: "redscript accepted the file but flagged something at this line — typically a " +
+            "field or method redefined in a class that already has it, which compiles and " +
+            "then silently has no effect at runtime.",
+        hint: "If the mod owning this file appears to do nothing, this is why: two mods are " +
+            "@addField/@replaceMethod-ing the same member, and one of them loses.",
+        seenIn: [
+            `${FIXTURES}/redscript_rCURRENT.error.synthetic.log`,
+            `${CDPR_LOGS_DOC} (verbatim duplicate-field WARN)`,
+        ],
+        extract: ["file", "line", "column"],
+        systemImpact: false,
+    },
+    {
+        id: "cyberpunk2077.redscript.compilation-failed",
+        game: GAME,
+        sources: ["redscript"],
+        severity: "error",
+        category: "compile",
+        pattern: re(PRE, String.raw `(?:(?:RED[Ss]cript|[Ss]cripts?)\s+)?[Cc]ompilation failed\b`, String.raw `(?:[:,]?\s*(?<errors>\d+) error\(s\))?(?:,\s*(?<warnings>\d+) warning\(s\))?`),
+        explain: "The redscript compile aborted, so the game is running the vanilla script cache: " +
+            "every script mod is inert this launch, including the ones that are perfectly " +
+            "fine. Expect a wave of unrelated-looking symptoms.",
+        hint: "Fix the first 'At <file>:<line>:<col>' error above; if there is none, delete " +
+            "r6/cache/modded (it is regenerated at launch) and verify the game files.",
+        seenIn: [
+            `${FIXTURES}/redscript_rCURRENT.error.synthetic.log`,
+            "unverified: tolerant pattern (also matches the 'scripts compilation failed' wording quoted in community threads)",
+        ],
+        extract: ["errors", "warnings"],
+    },
+    {
+        id: "cyberpunk2077.redscript.cache-error",
+        game: GAME,
+        sources: ["redscript"],
+        severity: "error",
+        category: "compile",
+        pattern: re(PRE, String.raw `(?:Failed to|Could not|Unable to) (?:open|read|load|write|create|deserialize) `, String.raw `(?:the )?(?<target>[^\n]*(?:script bundle|final\.redscripts|r6[\\/]cache)[^\n]*)`),
+        explain: "redscript could not read or write the script cache itself, so nothing was " +
+            "compiled. This is a stale or half-written r6/cache after a game patch or a " +
+            "crashed launch, not a mod's fault.",
+        hint: "Delete r6/cache/modded (and r6/cache/final.redscripts.bk if present), then " +
+            "verify/repair the game files so the vanilla bundle is restored; relaunch. This " +
+            "is the community's standard first ritual after a patch.",
+        seenIn: [
+            "unverified: tolerant pattern",
+        ],
+        extract: ["target"],
+    },
+];
+const TWEAKXL = [
+    {
+        id: "cyberpunk2077.tweakxl.initialized",
+        game: GAME,
+        sources: ["tweakxl"],
+        severity: "info",
+        category: "success",
+        pattern: re(PRE, String.raw `TweakXL (?<version>\d[\w.+-]*) (?:is starting|(?:has been )?initialized)`),
+        explain: "TweakXL started, so r6/tweaks YAML and .tweak files are being read this run. Without " +
+            "this line every tweak file is inert.",
+        hint: "If this line is absent, check the RED4ext log first: TweakXL is a RED4ext plugin.",
+        seenIn: [`${REAL}/tweakxl.log`, `${FIXTURES}/TweakXL.synthetic.log`],
+        extract: ["version"],
+    },
+    {
+        id: "cyberpunk2077.tweakxl.tweaks-loaded",
+        game: GAME,
+        sources: ["tweakxl"],
+        severity: "info",
+        category: "success",
+        pattern: re(PRE, String.raw `(?<phase>Import|Execution) completed\.\s*$`),
+        explain: "TweakXL finished applying tweaks (Import = YAML/.tweak files, Execution = scriptable " +
+            "tweaks). Warnings between 'Importing tweaks...' and this line name the record.flat " +
+            "that did not resolve.",
+        seenIn: [`${REAL}/tweakxl.log`],
+        extract: ["phase"],
+    },
+    {
+        id: "cyberpunk2077.tweakxl.file-read",
+        game: GAME,
+        sources: ["tweakxl"],
+        severity: "info",
+        category: "load",
+        pattern: re(PRE, String.raw `Reading "(?<file>[^"\n]+)"\.\.\.\s*$`),
+        explain: "TweakXL picked up a tweak file under r6/tweaks (path relative to that folder). The " +
+            "first such line is reported; `repeats` counts the rest, so the total is the number of " +
+            "files it found.",
+        hint: "If your own file is missing from this list, it is not under r6/tweaks with a .yaml, " +
+            ".yml or .tweak extension — TweakXL never saw it.",
+        seenIn: [`${REAL}/tweakxl.log`],
+        extract: ["file"],
+    },
+    {
+        id: "cyberpunk2077.tweakxl.yaml-parse-error",
+        game: GAME,
+        sources: ["tweakxl"],
+        severity: "error",
+        category: "compile",
+        pattern: re(LEVEL_PRE, String.raw `(?:Failed to parse|Could not parse|Cannot parse|Parse error(?: in)?|YAML error(?: in)?)`, String.raw `[^"\n]*"?(?<file>[^"\n]+?\.ya?ml)"?`, String.raw `(?![^\n]*\bduplicate key\b)`, String.raw `(?:[^\n]*?\bline (?<line>\d+))?`),
+        explain: "A tweak YAML file is malformed, so TweakXL discarded the whole file — every " +
+            "record it defines is missing, not just the broken part. Tabs, inconsistent " +
+            "indentation and stray quotes are the usual causes.",
+        hint: "Run the file through yamllint (the TweakXL wiki tells authors to do exactly " +
+            "this), fix the reported line, and re-check that no line uses tab characters.",
+        seenIn: [
+            `${FIXTURES}/TweakXL.synthetic.log`,
+            "unverified: tolerant pattern",
+            "https://github.com/psiberx/cp2077-tweak-xl/wiki/YAML-Tweaks",
+        ],
+        extract: ["file", "line"],
+    },
+    {
+        id: "cyberpunk2077.tweakxl.duplicate-key",
+        game: GAME,
+        sources: ["tweakxl"],
+        severity: "error",
+        category: "compile",
+        pattern: re(LEVEL_PRE, String.raw `[^\n]*?(?:"(?<file>[^"\n]+\.ya?ml)"[^\n]*?)?\bduplicate key\b`, String.raw `(?:[^\n]*?"(?<key>[^"\n]+)")?(?:[^\n]*?\bline (?<line>\d+))?`),
+        explain: "The same key appears twice in one tweak YAML file. YAML keeps only the last " +
+            "occurrence, and TweakXL rejects the file rather than guessing, so the records " +
+            "in it never reach TweakDB.",
+        hint: "Open the named file at that line and merge the two blocks; this is the most " +
+            "common hand-edited-YAML mistake and yamllint catches it before launch.",
+        seenIn: [
+            `${FIXTURES}/TweakXL.synthetic.log`,
+            "unverified: tolerant pattern",
+            "https://github.com/psiberx/cp2077-tweak-xl/wiki/YAML-Tweaks",
+        ],
+        extract: ["file", "key", "line"],
+    },
+    {
+        id: "cyberpunk2077.tweakxl.missing-base",
+        game: GAME,
+        sources: ["tweakxl"],
+        severity: "error",
+        category: "resource",
+        pattern: re(LEVEL_PRE, String.raw `[^\n]*?(?:\$base|\$type)\s+"?(?<record>[A-Za-z_][\w.]*)"?`, String.raw `[^\n]*?\b(?:does not exist|not found|is unknown|could not be resolved|is invalid)\b`),
+        explain: "A tweak inherits from a TweakDB record that is not there. Either the name is " +
+            "misspelled, or it belongs to a mod that is not installed, or it is an inline " +
+            "record whose generated name changed with the game patch — the tweak is dropped.",
+        hint: "Verify the record name against the shipped tools/redmod/tweaks corpus or with " +
+            "TweakDB.GetRecord('<name>') in the CET console; that corpus, not the docs, is " +
+            "ground truth for TweakDB names.",
+        seenIn: [
+            `${FIXTURES}/TweakXL.synthetic.log`,
+            "unverified: tolerant pattern",
+        ],
+        extract: ["record"],
+    },
+    {
+        id: "cyberpunk2077.tweakxl.unknown-record",
+        game: GAME,
+        sources: ["tweakxl"],
+        severity: "warn",
+        category: "resource",
+        pattern: re(PRE, String.raw `(?<record>[A-Za-z_][\w.]*) refers to a non-existent record or flat`, String.raw `(?:\s*<(?<tdbid>TDBID:[^>]+)>)?`),
+        explain: "A tweak assigned a reference to a record or flat that does not exist in TweakDB, so " +
+            "the game will read a null where the tweak meant a value. The named path is " +
+            "<record>.<flat> on the tweak side; the TDBID is the hash of the missing target.",
+        hint: "Check the target's spelling against the vanilla index (lookup kind 'record' or " +
+            "'reverse'); a typo in a $base or in an inline record reference is the usual cause.",
+        seenIn: [`${REAL}/tweakxl.log`],
+        extract: ["record", "tdbid"],
+        systemImpact: false,
+    },
+    {
+        id: "cyberpunk2077.tweakxl.missing-resource",
+        game: GAME,
+        sources: ["tweakxl"],
+        severity: "warn",
+        category: "resource",
+        pattern: re(PRE, String.raw `(?<record>[A-Za-z_][\w.]*) refers to a non-existent resource\.`),
+        explain: "A tweak points a resource path (an .ent, .app, .mesh, .inkatlas, ...) at a depot path " +
+            "that is not in any loaded archive. In game the entity or icon is missing rather than " +
+            "the game failing.",
+        hint: "Confirm the path exists inside the packed .archive (WolvenKit's archive browser) and " +
+            "that the archive is in archive/pc/mod; case and extension must match exactly.",
+        seenIn: [`${REAL}/tweakxl.log`],
+        extract: ["record"],
+        systemImpact: false,
+    },
+    {
+        id: "cyberpunk2077.tweakxl.hash-collision",
+        game: GAME,
+        sources: ["tweakxl"],
+        severity: "warn",
+        category: "resource",
+        pattern: re(PRE, String.raw `(?<flat>[A-Za-z_][\w.]*) has hash collision with (?<other>[A-Za-z_][\w.]*)\.`),
+        explain: "Two flat names hash to the same TweakDB id, so one of them overwrites the other. " +
+            "Usually a mod-defined record name colliding with a vanilla one.",
+        hint: "Rename the mod-side record; TweakDB ids are 32-bit hashes of the name and cannot be disambiguated.",
+        seenIn: [`${REAL}/tweakxl.log`],
+        extract: ["flat", "other"],
+        systemImpact: false,
+    },
+];
+const ARCHIVEXL = [
+    {
+        id: "cyberpunk2077.archivexl.initialized",
+        game: GAME,
+        sources: ["archivexl"],
+        severity: "info",
+        category: "success",
+        pattern: re(PRE, String.raw `ArchiveXL (?<version>\d[\w.+-]*) (?:is starting|(?:has been )?initialized)`),
+        explain: "ArchiveXL started, so .xl sidecar manifests next to your .archive files are " +
+            "being read this run. Without this line, .xl files are inert and the archives " +
+            "load as plain archives — a very common cause of 'my mod installed but nothing " +
+            "changed'.",
+        hint: "If this line is absent, check the RED4ext log first: ArchiveXL is a RED4ext plugin.",
+        seenIn: [`${REAL}/archivexl.log`, `${FIXTURES}/ArchiveXL.synthetic.log`],
+        extract: ["version"],
+    },
+    {
+        id: "cyberpunk2077.archivexl.extension-loading",
+        game: GAME,
+        sources: ["archivexl"],
+        severity: "info",
+        category: "load",
+        pattern: re(PRE, String.raw `Loading "(?<file>[^"\n]+\.xl)"\.\.\.\s*$`),
+        explain: "ArchiveXL found and is parsing an .xl manifest (name relative to archive/pc/mod). The " +
+            "first is reported; `repeats` counts the rest.",
+        hint: "If your .xl is not in this list, its base name does not match its .archive or it is " +
+            "not in archive/pc/mod.",
+        seenIn: [`${REAL}/archivexl.log`],
+        extract: ["file"],
+    },
+    {
+        id: "cyberpunk2077.archivexl.resources-registered",
+        game: GAME,
+        sources: ["archivexl"],
+        severity: "info",
+        category: "success",
+        pattern: re(PRE, String.raw `All archive extensions loaded\.\s*$`),
+        explain: "ArchiveXL finished reading every .xl manifest it found. Section-level problems " +
+            "([error]/[warning] lines tagged [ResourcePatch], [Localization], [Journal], " +
+            "[WorldStreaming], [QuestPhase]) appear after this line as the game requests resources.",
+        seenIn: [`${REAL}/archivexl.log`],
+    },
+    {
+        id: "cyberpunk2077.archivexl.journal-mappin-unresolved",
+        game: GAME,
+        sources: ["archivexl"],
+        severity: "error",
+        category: "resource",
+        pattern: re(PRE, String.raw `\[Journal\] Can't resolve mappin #(?<id>\d+) \((?<path>[^)\n]+)\) position\.`),
+        explain: "A journal (map pin) entry merged from an .xl manifest names a mappin whose world " +
+            "position cannot be resolved. ArchiveXL logs this at error level; the game keeps " +
+            "running and the pin is simply missing from the map. It is a defect of the mod that " +
+            "declared the journal entry, not of ArchiveXL.",
+        hint: "The path under points_of_interest/ identifies the mod's journal section; check that the " +
+            "mappin's world node exists in a loaded sector.",
+        seenIn: [`${REAL}/archivexl.log`],
+        extract: ["id", "path"],
+        systemImpact: false,
+    },
+    {
+        id: "cyberpunk2077.archivexl.quest-phase-missing",
+        game: GAME,
+        sources: ["archivexl"],
+        severity: "warn",
+        category: "resource",
+        pattern: re(PRE, String.raw `\[QuestPhase\] Phase "(?<phase>[^"\n]+)" doesn't exist\. Skipped\.`),
+        explain: "An .xl manifest asked to merge into a quest phase that is not present, so that merge " +
+            "was skipped. Common after a game patch renames or removes a phase.",
+        seenIn: [`${REAL}/archivexl.log`],
+        extract: ["phase"],
+        systemImpact: false,
+    },
+    {
+        id: "cyberpunk2077.archivexl.localization-overwrite",
+        game: GAME,
+        sources: ["archivexl"],
+        severity: "warn",
+        category: "resource",
+        pattern: re(PRE, String.raw `\[Localization\] Item #(?<item>\d+) overwrites entry (?<entry>\d+)\.`),
+        explain: "Two localization sources define the same string key; the later one wins. Harmless " +
+            "when intended, but a mod's own name showing up wrong usually traces back to this.",
+        seenIn: [`${REAL}/archivexl.log`],
+        extract: ["item", "entry"],
+        systemImpact: false,
+    },
+    {
+        id: "cyberpunk2077.archivexl.resource-resolve-failed",
+        game: GAME,
+        sources: ["archivexl"],
+        severity: "error",
+        category: "resource",
+        pattern: re(LEVEL_PRE, String.raw `(?:Failed to|Could not|Unable to) resolve[^\n]*?\b(?:resource|path|depot)\b`, String.raw `[^\n]*?"(?<resource>[^"\n]+)"`),
+        explain: "A resource path referenced by an .xl manifest or a record is not present in any " +
+            "loaded archive. In game this shows up as an invisible or untextured entity " +
+            "rather than as a crash, so the log is the only place it is visible.",
+        hint: "Check the path's spelling and case against the packed archive contents " +
+            "(WolvenKit's archive browser), and confirm the archive that should contain it " +
+            "is actually in archive/pc/mod.",
+        seenIn: [
+            `${FIXTURES}/ArchiveXL.synthetic.log`,
+            "unverified: tolerant pattern",
+        ],
+        extract: ["resource"],
+    },
+    {
+        id: "cyberpunk2077.archivexl.appearance-resolve-failed",
+        game: GAME,
+        sources: ["archivexl"],
+        severity: "error",
+        category: "resource",
+        pattern: re(LEVEL_PRE, String.raw `(?:Failed to|Could not|Unable to) resolve[^\n]*?\bappearance\b`, String.raw `[^\n]*?"(?<appearance>[^"\n]+)"`, String.raw `(?:[^\n]*?\bfor entity "(?<entity>[^"\n]+)")?`),
+        explain: "An appearance name could not be matched to a variant in the entity's .app file. " +
+            "This is the classic 'entity spawns invisible' failure: the entity exists, its " +
+            "appearance does not resolve, and nothing else complains.",
+        hint: "Compare the appearance name in the .ent/.app pair character for character " +
+            "(appearanceName on the node, appearanceResourceName on the entity); the visuals " +
+            "come from the weapon-level .app via the factory, not from slotPartListPreset.",
+        seenIn: [
+            `${FIXTURES}/ArchiveXL.synthetic.log`,
+            "unverified: tolerant pattern",
+        ],
+        extract: ["appearance", "entity"],
+    },
+    {
+        id: "cyberpunk2077.archivexl.registration-failed",
+        game: GAME,
+        sources: ["archivexl"],
+        severity: "error",
+        category: "resource",
+        pattern: re(LEVEL_PRE, String.raw `(?:Failed to|Could not|Unable to) (?:register|load|apply|read)`, String.raw `[^\n]*?\b(?<kind>factor(?:y|ies)|localization|translations?|onscreens?)\b`, String.raw `(?:[^\n]*?"(?<path>[^"\n]+)")?`),
+        explain: "An .xl manifest section did not register: a factory entry (which is what makes " +
+            "custom items resolve their parts and appearances) or a localization/onscreens " +
+            "entry (which is what gives them names instead of raw LocKey ids).",
+        hint: "Validate the .xl YAML — factories and localization are separate top-level " +
+            "sections and each expects a list of depot paths that must exist in the archive " +
+            "packed beside it.",
+        seenIn: [
+            "unverified: tolerant pattern",
+        ],
+        extract: ["kind", "path"],
+    },
+];
+const CET_PRE = String.raw `\[\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2} UTC[+-]\d{2}:\d{2}\] \[info\] \[[^\]\n]*\] \[\d+\] `;
+const LUA_LOCATION = String.raw `(?<file>[^\n]*?(?:mods[\\/](?<mod>[^\\/\n]+)[\\/])?[^\\/\n]*\.lua):(?<line>\d+):\s*`;
+const LUA_SYNTAX = String.raw `(?:expected|unexpected symbol|unfinished string|malformed number|ambiguous syntax)[^\n]*\bnear\b`;
+const CET = [
+    {
+        id: "cyberpunk2077.cet.version",
+        game: GAME,
+        sources: ["cet"],
+        severity: "info",
+        category: "version",
+        pattern: re(CET_PRE, String.raw `CET version v?(?<version>\d[\w.+-]*)(?: \[(?<build>[^\]\n]+)\])?`),
+        explain: "CET printed its own version at startup. Compare against the game version on the " +
+            "next line: CET is rebuilt for each game patch.",
+        hint: "If the version is older than the game's last patch, CET's Lua mods will not load; " +
+            "update CET before touching any mod.",
+        seenIn: [`${REAL}/cet.log`],
+        extract: ["version", "build"],
+    },
+    {
+        id: "cyberpunk2077.cet.game-version",
+        game: GAME,
+        sources: ["cet"],
+        severity: "info",
+        category: "version",
+        pattern: re(CET_PRE, String.raw `Game version (?<version>\d[\d.]*)\s*$`),
+        explain: "The game build CET attached to, in exe file-version form (3.0.80.51928 is 2.31).",
+        seenIn: [`${REAL}/cet.log`],
+        extract: ["version"],
+    },
+    {
+        id: "cyberpunk2077.cet.starting",
+        game: GAME,
+        sources: ["cet"],
+        severity: "info",
+        category: "load",
+        pattern: re(CET_PRE, String.raw `Cyber Engine Tweaks is starting\.\.\.`),
+        explain: "The start of a CET run. Because the log is appended across launches, count this " +
+            "line's `repeats` to know how many runs the scanned window covers.",
+        seenIn: [`${REAL}/cet.log`],
+    },
+    {
+        id: "cyberpunk2077.cet.hooks-complete",
+        game: GAME,
+        sources: ["cet"],
+        severity: "info",
+        category: "success",
+        pattern: re(CET_PRE, String.raw `Hidden options hook: success\s*$`),
+        explain: "CET installed every engine hook it needs (rendering, Lua VM, options), which is as far " +
+            "as its own log goes: mod loading is logged per mod under mods/<name>/<name>.log.",
+        seenIn: [`${REAL}/cet.log`],
+    },
+    {
+        id: "cyberpunk2077.cet.mod-loaded",
+        game: GAME,
+        sources: ["cet"],
+        severity: "info",
+        category: "success",
+        pattern: re(PRE, String.raw `(?:Loaded mod|Mod loaded)[:\s]+['"“](?<mod>[^'"”\n]+)['"”]`),
+        explain: "A CET Lua mod's chunk loaded without erroring. The mod is registered; anything " +
+            "it still fails to do is a runtime problem, not an install problem.",
+        hint: "A mod folder that never appears here is missing its init.lua or sits at the " +
+            "wrong depth under bin/x64/plugins/cyber_engine_tweaks/mods.",
+        seenIn: [
+            `${FIXTURES}/cyber_engine_tweaks.synthetic.log`,
+            "unverified: tolerant pattern",
+        ],
+        extract: ["mod"],
+    },
+    {
+        id: "cyberpunk2077.cet.lua-syntax-error",
+        game: GAME,
+        sources: ["cet"],
+        severity: "error",
+        category: "compile",
+        pattern: re(PRE, LUA_LOCATION, String.raw `(?<message>[^\n]*`, LUA_SYNTAX, String.raw `[^\n]*)$`),
+        explain: "A CET Lua file does not parse, so the mod never loaded at all — none of its " +
+            "callbacks, commands or UI exist this session. The file and line are exact.",
+        hint: "Fix the syntax at that line and use the CET console's reload rather than " +
+            "restarting the game; Lua reports the error at the first token it could not " +
+            "reconcile, so the real mistake is often on the line above.",
+        seenIn: [
+            `${FIXTURES}/cyber_engine_tweaks.synthetic.log`,
+            `${CDPR_LOGS_DOC} (real captured line: "...\\mods\\BMYC - A car theft mod\\init.lua:1834: ')' expected near '|'")`,
+        ],
+        extract: ["file", "mod", "line", "message"],
+        systemImpact: false,
+    },
+    {
+        id: "cyberpunk2077.cet.lua-runtime-error",
+        game: GAME,
+        sources: ["cet"],
+        severity: "error",
+        category: "script",
+        pattern: re(PRE, LUA_LOCATION, String.raw `(?![^\n]*(?:`, LUA_SYNTAX, String.raw `))(?<message>[^\n]+)$`),
+        explain: "A CET Lua mod threw while running (a nil value, a bad argument, a missing game " +
+            "API). The mod loaded, so the rest of it keeps working — only the code path that " +
+            "threw is dead, which is why the symptom is usually one broken feature.",
+        hint: "The named game API most likely moved or was removed in the current patch: check " +
+            "the value at that line in the CET console before editing the mod.",
+        seenIn: [
+            "unverified: tolerant pattern (same verified file:line shape as the syntax-error case, minus the Lua parser wording)",
+            `${CDPR_LOGS_DOC}`,
+        ],
+        extract: ["file", "mod", "line", "message"],
+        systemImpact: false,
+    },
+];
+const CODEWARE = [
+    {
+        id: "cyberpunk2077.codeware.initializing",
+        game: GAME,
+        sources: ["codeware"],
+        severity: "info",
+        category: "version",
+        pattern: re(PRE, String.raw `Codeware (?<version>\d[\w.+-]*) is initializing\.\.\.`),
+        explain: "Codeware started and printed its version — the one redscript mods that depend on it were built against.",
+        seenIn: [`${REAL}/codeware.log`],
+        extract: ["version"],
+    },
+    {
+        id: "cyberpunk2077.codeware.initialized",
+        game: GAME,
+        sources: ["codeware"],
+        severity: "info",
+        category: "success",
+        pattern: re(PRE, String.raw `Codeware is initialized\.\s*$`),
+        explain: "Codeware finished initializing (resource path registry loaded). Without this line, every " +
+            "redscript mod that imports Codeware fails at runtime even though it compiled.",
+        seenIn: [`${REAL}/codeware.log`],
+    },
+];
+export const SIGNATURES = [
+    ...RED4EXT,
+    ...REDSCRIPT,
+    ...TWEAKXL,
+    ...ARCHIVEXL,
+    ...CET,
+    ...CODEWARE,
+];