modwright 0.1.1 → 0.1.3

package/dist/surfaces/baldursgate3/writes.js

@@ -0,0 +1,152 @@
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { parseStats } from "./index/parsers/stats.js";
+import { localAppData, readTextIfExists } from "../../core/fsutil.js";
+import { parseMetaLsxModuleInfo } from "../../core/lsx.js";
+import { parseModSettings } from "./modsettings.js";
+import { readPakEntry, readPakListing, readPakModuleInfos } from "./pak.js";
+const STATS_FILE = /^Public\/([^/]+)\/Stats\/Generated\/Data\/[^/]+\.txt$/i;
+const MAX_STATS_BYTES = 16 * 1024 * 1024;
+export const LOOSE_UNIT_NOTE = "In the game's Data folder each Public/<Mod> folder with stats files is taken as one unpacked mod.";
+function entryWrites(entries, file, unit) {
+    const writes = [];
+    const withUnit = (w) => (unit ? { ...w, unit } : w);
+    for (const entry of entries) {
+        const value = { type: entry.type };
+        if (entry.using !== undefined)
+            value.using = entry.using;
+        writes.push(withUnit({ key: `stats:${entry.name}`, keyKind: "stats-entry", op: "create", value, file, line: entry.line, certainty: "definite" }));
+        for (const [field, fieldValue] of Object.entries(entry.fields)) {
+            writes.push(withUnit({ key: `stats:${entry.name}.${field}`, keyKind: "stats-field", op: "set", value: fieldValue, file, line: entry.line, certainty: "definite" }));
+        }
+    }
+    return writes;
+}
+const MODSETTINGS = localAppData("Larian Studios", "Baldur's Gate 3", "PlayerProfiles", "Public", "modsettings.lsx");
+const activeCache = new Map();
+async function activeModuleUuids(file) {
+    let mtimeMs;
+    try {
+        mtimeMs = (await fs.stat(file)).mtimeMs;
+    }
+    catch {
+        return undefined;
+    }
+    const cached = activeCache.get(file);
+    if (cached && cached.mtimeMs === mtimeMs)
+        return cached.uuids;
+    try {
+        const uuids = new Set(parseModSettings(await fs.readFile(file, "utf8")).map((e) => e.uuid.toLowerCase()).filter(Boolean));
+        activeCache.set(file, { mtimeMs, uuids });
+        return uuids;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function moduleState(infos, modsettings) {
+    const modules = infos.filter((i) => i.uuid);
+    if (modules.length === 0)
+        return {};
+    const identity = `bg3-module:${modules.map((i) => i.uuid.toLowerCase()).sort().join("+")}`;
+    const active = await activeModuleUuids(modsettings);
+    if (!active || modules.some((i) => active.has(i.uuid.toLowerCase())))
+        return { identity };
+    const named = modules.map((i) => `${i.name ?? i.folder ?? "?"} (${i.uuid})`).join(", ");
+    return { identity, inactive: `module ${named} is not in modsettings.lsx, so the game does not load it` };
+}
+async function pakModuleState(pakPath, modsettings) {
+    try {
+        return moduleState(await readPakModuleInfos(pakPath), modsettings);
+    }
+    catch {
+        return {};
+    }
+}
+async function fromPak(pakPath, modsettings) {
+    const extraction = { writes: [], errors: [] };
+    const state = await pakModuleState(pakPath, modsettings);
+    if (state.inactive)
+        extraction.inactive = state.inactive;
+    if (state.identity)
+        extraction.identity = state.identity;
+    let listing;
+    try {
+        listing = await readPakListing(pakPath);
+    }
+    catch (error) {
+        extraction.errors.push({ file: pakPath, error: error.message });
+        return extraction;
+    }
+    for (const entry of listing.entries) {
+        if (!STATS_FILE.test(entry.name))
+            continue;
+        const file = `${pakPath}!${entry.name}`;
+        try {
+            const text = (await readPakEntry(pakPath, entry, MAX_STATS_BYTES)).toString("utf8");
+            extraction.writes.push(...entryWrites(parseStats(text, file), file, undefined));
+        }
+        catch (error) {
+            extraction.errors.push({ file, error: error.message });
+        }
+    }
+    return extraction;
+}
+async function looseStatsFiles(dataDir) {
+    const out = [];
+    let mods;
+    try {
+        mods = await fs.readdir(path.join(dataDir, "Public"));
+    }
+    catch {
+        return out;
+    }
+    for (const folder of mods) {
+        const dir = path.join("Public", folder, "Stats", "Generated", "Data");
+        let names;
+        try {
+            names = await fs.readdir(path.join(dataDir, dir));
+        }
+        catch {
+            continue;
+        }
+        for (const name of names) {
+            const rel = `${dir}/${name}`.split(path.sep).join("/");
+            if (STATS_FILE.test(rel))
+                out.push(rel);
+        }
+    }
+    return out;
+}
+async function fromLooseData(mod, modsettings) {
+    const extraction = { writes: [], errors: [], unitNote: LOOSE_UNIT_NOTE, unitStates: {} };
+    for (const rel of await looseStatsFiles(mod.path)) {
+        const match = STATS_FILE.exec(rel);
+        if (!match)
+            continue;
+        const unit = match[1];
+        if (!(unit in extraction.unitStates)) {
+            const meta = await readTextIfExists(path.join(mod.path, "Mods", unit, "meta.lsx")).catch(() => undefined);
+            const info = meta ? parseMetaLsxModuleInfo(meta) : undefined;
+            extraction.unitStates[unit] = info ? await moduleState([info], modsettings) : {};
+        }
+        const abs = path.join(mod.path, rel);
+        try {
+            const stat = await fs.stat(abs);
+            if (stat.size > MAX_STATS_BYTES)
+                throw new Error(`larger than ${MAX_STATS_BYTES} bytes; skipped`);
+            extraction.writes.push(...entryWrites(parseStats(await fs.readFile(abs, "utf8"), abs), abs, match[1]));
+        }
+        catch (error) {
+            extraction.errors.push({ file: abs, error: error.message });
+        }
+    }
+    return extraction;
+}
+export async function extractBg3Writes(mod, root, options = {}) {
+    if (root.id === "paks")
+        return fromPak(mod.path, options.modsettings ?? MODSETTINGS);
+    if (root.id === "loose")
+        return fromLooseData(mod, options.modsettings ?? MODSETTINGS);
+    return undefined;
+}

package/dist/surfaces/cyberpunk2077/compat.js

@@ -210,11 +210,15 @@ const RULES = [
         requires: [],
         advisory: true,
         severity: "info",
-        note: "RED4ext plugins are locked to the game build. After a game patch, wait for RED4ext and its " +
-            "plugins to publish updated releases before assuming a mod is broken.",
+        note: "RED4ext plugins are tied to the game build they were compiled for. Before RED4ext 1.30.0 the " +
+            "loader itself refuses an unrecognized patch and no plugin loads; from 1.30.0 the loader runs on " +
+            "any build and skips each plugin pinned to another runtime (\"is incompatible with the current " +
+            "patch\" in red4ext.log), so a patch now breaks plugins one at a time. After a game patch, wait for " +
+            "RED4ext and its plugins to publish updated releases before assuming a mod is broken.",
         source: "https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-users/user-guide-troubleshooting " +
-            "(\"prone to breaking with every update\"); RED4ext itself refuses to run against a game patch " +
-            "it does not recognize (WopsS/RED4ext#33).",
+            "(\"prone to breaking with every update\"); RED4ext before 1.30.0 refuses a game patch it does " +
+            "not recognize (WopsS/RED4ext#33); 1.30.0 moved the check to each plugin's requested runtime " +
+            "(WopsS/RED4ext v1.30.0, src/dll/Systems/PluginSystem.cpp).",
     },
 ];
 export const cyberpunk2077Compat = {

package/dist/surfaces/cyberpunk2077/index/parsers/tweakxl-yaml.js

@@ -140,9 +140,9 @@ function extractBindings(node, file, line) {
     }
     return bindings;
 }
-export function parseTweakXLYaml(text, file) {
+export function parseTweakXLYaml(text, file, options = {}) {
     const lineCounter = new YAML.LineCounter();
-    const doc = YAML.parseDocument(text, { lineCounter });
+    const doc = YAML.parseDocument(text, { lineCounter, uniqueKeys: !options.allowDuplicateKeys });
     if (doc.errors.length > 0) {
         const first = doc.errors[0];
         const line = first.pos ? lineCounter.linePos(first.pos[0]).line : 1;

package/dist/surfaces/cyberpunk2077/logs.js

@@ -137,8 +137,9 @@ const RED4EXT = [
         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.",
+        hint: "Update RED4ext (1.30.0 and later no longer refuse an unrecognized build; they " +
+            "check each plugin instead), 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",
@@ -222,7 +223,7 @@ const REDSCRIPT = [
             "or its data, not in compilation.",
         seenIn: [
             `${FIXTURES}/redscript_rCURRENT.ok.synthetic.log`,
-            "https://wiki.redmodding.org/redscript/help/troubleshooting",
+            "https://wiki.redmodding.org/scripting-cyberpunk/redscript/help/troubleshooting",
         ],
         extract: ["output"],
     },
@@ -354,6 +355,12 @@ const TWEAKXL = [
             ".yml or .tweak extension — TweakXL never saw it.",
         seenIn: [`${REAL}/tweakxl.log`],
         extract: ["file"],
+        attribution: {
+            kind: "read-order",
+            subjectLabel: "TweakXL tweak files (read order; a later file wins the same flat)",
+            actor: "file",
+            alsoFinding: true,
+        },
     },
     {
         id: "cyberpunk2077.tweakxl.yaml-parse-error",
@@ -537,11 +544,12 @@ const ARCHIVEXL = [
         sources: ["archivexl"],
         severity: "warn",
         category: "resource",
-        pattern: re(PRE, String.raw `\[Localization\] Item #(?<item>\d+) overwrites entry (?<entry>\d+)\.`),
+        pattern: re(PRE, String.raw `\[Localization\] Item #(?<item>\d+) overwrites (?<key>entry (?<entry>\d+))(?: \("(?<secondary>[^"\n]*)"\))?\.`),
         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"],
+        seenIn: [`${REAL}/archivexl.log`, "psiberx/cp2077-archive-xl src/App/Extensions/Localization/Extension.cpp (secondary-key form)"],
+        extract: ["item", "entry", "secondary"],
+        attribution: { kind: "overwrite", subject: "key", detail: "secondary", alsoFinding: true },
         systemImpact: false,
     },
     {
@@ -600,6 +608,49 @@ const ARCHIVEXL = [
         ],
         extract: ["kind", "path"],
     },
+    {
+        id: "cyberpunk2077.archivexl.localization-merge-source",
+        game: GAME,
+        sources: ["archivexl"],
+        severity: "info",
+        category: "attribution",
+        pattern: re(PRE, String.raw `\[Localization\] Merging entries from "(?<file>[^"\n]+)"\.\.\.`),
+        explain: "ArchiveXL is merging one localization file; any 'overwrites entry' line after it was " +
+            "caused by this file.",
+        seenIn: [
+            "psiberx/cp2077-archive-xl src/App/Extensions/Localization/Extension.cpp (source-read 2026-09-29; no real sample yet)",
+        ],
+        attribution: { kind: "overwrite", actor: "file", setsContext: true },
+    },
+    {
+        id: "cyberpunk2077.archivexl.animations-target",
+        game: GAME,
+        sources: ["archivexl"],
+        severity: "info",
+        category: "attribution",
+        pattern: re(PRE, String.raw `\[EntityAnimation\] Initializing animations for "(?<target>[^"\n]+)"\.\.\.`),
+        explain: "ArchiveXL is about to merge extra animation sets into one entity component " +
+            "(<template>:<component>); the 'Merging animations from' lines after it name them.",
+        seenIn: [
+            "psiberx/cp2077-archive-xl src/App/Extensions/Animation/Extension.cpp (source-read 2026-09-29; no real sample yet)",
+        ],
+        attribution: { kind: "merge", subject: "target", setsContext: true },
+    },
+    {
+        id: "cyberpunk2077.archivexl.animations-merge",
+        game: GAME,
+        sources: ["archivexl"],
+        severity: "info",
+        category: "attribution",
+        pattern: re(PRE, String.raw `\[EntityAnimation\] Merging animations from "(?<anims>[^"\n]+)" with priority (?<priority>-?\d+)\.\.\.`),
+        explain: "One mod's animation set merged into the component named by the preceding " +
+            "'Initializing animations for' line, at this priority. Two sets animating the same " +
+            "action on one component is the usual 'wrong animation plays' conflict.",
+        seenIn: [
+            "psiberx/cp2077-archive-xl src/App/Extensions/Animation/Extension.cpp (source-read 2026-09-29; no real sample yet)",
+        ],
+        attribution: { kind: "merge", actor: "anims", detail: "priority" },
+    },
 ];
 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*`;
@@ -732,6 +783,34 @@ const CODEWARE = [
         seenIn: [`${REAL}/codeware.log`],
     },
 ];
+const REDHOTTOOLS = [
+    {
+        id: "cyberpunk2077.redhottools.resource-not-found",
+        game: GAME,
+        sources: ["redhottools"],
+        severity: "warn",
+        category: "resource",
+        pattern: re(PRE, String.raw `Resource not found: hash=(?<hash>\d+) path="(?:\?|(?<path>[^"\n]+))" archive="(?:\?|(?<archive>[^"\n]+))"`),
+        explain: "The engine asked for a resource that no loaded archive provides. RHT only logs this for " +
+            "requests tied to a mod archive (it skips the base game's and DLC's), and names that " +
+            "archive — the usual trail from an invisible, purple or 'black and shiny' item back to the " +
+            "mod whose file points at something that is not there. Which role the named archive played " +
+            "in the request (the referencing mod or only the one searched) is not yet confirmed on a real log.",
+        hint: "Check the named archive's depot paths for a typo or a file it forgot to ship, and whether it " +
+            "needs another mod (a body framework, an ArchiveXL resource) that is not installed.",
+        seenIn: ["psiberx/cp2077-red-hot-tools src/App/Archives/ResourceLogger.cpp"],
+        extract: ["hash", "path", "archive"],
+        systemImpact: false,
+        attribution: {
+            kind: "missing-resource",
+            subject: "path",
+            subjectFallback: "hash",
+            actor: "archive",
+            detail: "hash",
+            alsoFinding: true,
+        },
+    },
+];
 export const SIGNATURES = [
     ...RED4EXT,
     ...REDSCRIPT,
@@ -739,4 +818,5 @@ export const SIGNATURES = [
     ...ARCHIVEXL,
     ...CET,
     ...CODEWARE,
+    ...REDHOTTOOLS,
 ];

package/dist/surfaces/cyberpunk2077/surface.js

@@ -5,6 +5,7 @@ import { findInSteam } from "../../core/steam.js";
 import { dedupeByRoot, logs, roots } from "../../core/surfaceutil.js";
 import { cp2077Index } from "./index/index.js";
 import { SIGNATURES } from "./logs.js";
+import { extractCyberpunkWrites } from "./writes.js";
 import { BRIDGE_VALIDATORS } from "./validators/bridge.js";
 import { GARMENT_VALIDATORS } from "./validators/garments.js";
 import { MESH_VALIDATORS } from "./validators/mesh.js";
@@ -59,7 +60,8 @@ export const cyberpunk2077 = {
                 extensions: [".archive", ".xl"],
                 ordered: true,
                 conflictScope: "opaque",
-                notes: "Loaded alphabetically; later names win on identical resource paths. " +
+                notes: "Loaded in ASCII order of filename (modlist.txt overrides it when present); on identical " +
+                    "resource paths the FIRST-loaded archive wins. " +
                     "A .xl sidecar is ArchiveXL and must keep the same base name as its .archive.",
             },
             {
@@ -187,9 +189,19 @@ export const cyberpunk2077 = {
                     "initialized.' A missing 'is initialized' line means every redscript mod that " +
                     "depends on Codeware is running without it.",
             },
+            {
+                id: "redhottools",
+                label: "Red Hot Tools",
+                candidates: pluginLogCandidates(install, "RedHotTools"),
+                rootId: "red4ext",
+                notes: "Red Hot Tools' own log. Besides its hot-reload lines it records 'Resource not found: " +
+                    "hash=… path=\"…\" archive=\"…\"' for every failed request tied to a mod archive, which " +
+                    "names the archive behind a missing resource. Only present when Red Hot Tools is installed.",
+            },
         ]);
     },
     logSignatures: SIGNATURES,
+    extractWrites: (mod, root) => extractCyberpunkWrites(mod, root),
     index: cp2077Index,
     validators: [
         ...TWEAK_VALIDATORS,

package/dist/surfaces/cyberpunk2077/validators/cr2w.js

@@ -169,6 +169,10 @@ const UNIQUE_IDS_EVIDENCE = [
     "cp2077.sectors.sector-json-file-uniqueness",
     "cp2077.toolchain.cli-convert-deserialize",
 ];
+function idSpace(jsonPath) {
+    const at = jsonPath.lastIndexOf(".Data.Chunks[");
+    return at === -1 ? "$" : jsonPath.slice(0, at);
+}
 async function checkUniqueIds(text, root, file) {
     const findings = [];
     for (const key of ["HandleId", "BufferId"]) {
@@ -177,13 +181,15 @@ async function checkUniqueIds(text, root, file) {
         for (const hit of hits) {
             if (typeof hit.value !== "string")
                 continue;
-            const list = byValue.get(hit.value) ?? [];
+            const spaceKey = `${idSpace(hit.jsonPath)}\u0000${hit.value}`;
+            const list = byValue.get(spaceKey) ?? [];
             list.push(hit);
-            byValue.set(hit.value, list);
+            byValue.set(spaceKey, list);
         }
-        for (const [value, list] of byValue) {
+        for (const [spaceKey, list] of byValue) {
             if (list.length < 2)
                 continue;
+            const value = spaceKey.slice(spaceKey.indexOf("\u0000") + 1);
             const lines = list.map((_, i) => lineOfOccurrence(text, `"${key}": "${value}"`, i)).filter((l) => l !== undefined);
             findings.push({
                 validatorId: "cp2077.vehicles.cr2w-unique-ids",

package/dist/surfaces/cyberpunk2077/writes.js

@@ -0,0 +1,67 @@
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { TweakParseError } from "./index/model.js";
+import { parseTweakFile } from "./index/parsers/tweak.js";
+import { parseTweakXLYaml } from "./index/parsers/tweakxl-yaml.js";
+const TWEAK_EXTENSIONS = new Set([".yaml", ".yml", ".tweak"]);
+const MAX_TWEAK_BYTES = 8 * 1024 * 1024;
+export const TWEAKS_UNIT_NOTE = "r6/tweaks is one shared folder and TweakXL has no notion of mods, so each top-level folder there " +
+    "(or a file directly in r6/tweaks) is taken as one mod — how mods are packaged, not something the game records.";
+function recordWrites(records, file, unit) {
+    const writes = [];
+    const withUnit = (w) => (unit ? { ...w, unit } : w);
+    for (const record of records) {
+        if (record.type !== undefined || record.base !== undefined) {
+            const value = {};
+            if (record.type !== undefined)
+                value.$type = record.type;
+            if (record.base !== undefined)
+                value.$base = record.base;
+            writes.push(withUnit({ key: record.name, keyKind: "tweakdb-record", op: "create", value, file, line: record.line, certainty: "definite" }));
+        }
+        for (const flat of record.flats) {
+            writes.push(withUnit({
+                key: `${record.name}.${flat.name}`,
+                keyKind: "tweakdb-flat",
+                op: flat.op,
+                value: flat.value,
+                file,
+                line: record.line,
+                certainty: "definite",
+            }));
+        }
+    }
+    return writes;
+}
+async function parseFile(abs) {
+    const stat = await fs.stat(abs);
+    if (stat.size > MAX_TWEAK_BYTES)
+        throw new Error(`larger than ${MAX_TWEAK_BYTES} bytes; skipped`);
+    const text = await fs.readFile(abs, "utf8");
+    return path.extname(abs).toLowerCase() === ".tweak" ? parseTweakFile(text, abs) : parseTweakXLYaml(text, abs, { allowDuplicateKeys: true });
+}
+export async function extractCyberpunkWrites(mod, root) {
+    let files;
+    if (root.id === "tweaks")
+        files = mod.files;
+    else if (root.id === "redmod")
+        files = mod.files.filter((f) => f.toLowerCase().startsWith("tweaks/"));
+    else
+        return undefined;
+    files = files.filter((f) => TWEAK_EXTENSIONS.has(path.extname(f).toLowerCase()));
+    const extraction = { writes: [], errors: [] };
+    if (root.id === "tweaks")
+        extraction.unitNote = TWEAKS_UNIT_NOTE;
+    for (const rel of files) {
+        const abs = path.join(mod.path, rel);
+        const unit = root.id === "tweaks" ? rel.split("/")[0] : undefined;
+        try {
+            extraction.writes.push(...recordWrites(await parseFile(abs), abs, unit));
+        }
+        catch (error) {
+            const message = error instanceof TweakParseError ? error.message : `${abs}: ${error.message}`;
+            extraction.errors.push({ file: abs, error: message });
+        }
+    }
+    return extraction;
+}

package/dist/surfaces/eldenring/loaders.js

@@ -117,7 +117,13 @@ export async function readModEngine2LoadOrder(install) {
     const configPath = path.join(gameDir(install), MODENGINE2_CONFIG);
     if (!(await pathExists(configPath)))
         return { configPath, entries: [] };
-    const config = parseModEngine2Config(await fs.readFile(configPath, "utf8"));
+    let config;
+    try {
+        config = parseModEngine2Config(await fs.readFile(configPath, "utf8"));
+    }
+    catch (err) {
+        return { configPath, entries: [], error: `${configPath}: ${err.message}` };
+    }
     const modDir = path.resolve(modengine2ModDir(install)).toLowerCase();
     const entries = [];
     let index = 0;

package/dist/surfaces/skyrimse/loadorder.js

@@ -1,6 +1,7 @@
 import { existsSync, promises as fs } from "node:fs";
 import * as path from "node:path";
 import { documents, localAppData, pathExists } from "../../core/fsutil.js";
+import { parseIni } from "../../core/ini.js";
 export const STOREFRONT_FOLDER = {
     steam: "Skyrim Special Edition",
     gog: "Skyrim Special Edition GOG",
@@ -68,32 +69,7 @@ export async function readCcc(root) {
         .map((l) => l.trim())
         .filter((l) => l.length > 0);
 }
-export function parseIni(text) {
-    const out = new Map();
-    let section = "";
-    for (const raw of text.split(/\r?\n/)) {
-        const line = raw.trim();
-        if (!line || line.startsWith(";") || line.startsWith("#"))
-            continue;
-        const sec = /^\[(.+)\]$/.exec(line);
-        if (sec) {
-            section = sec[1].trim().toLowerCase();
-            continue;
-        }
-        const eq = line.indexOf("=");
-        if (eq < 0)
-            continue;
-        const key = line.slice(0, eq).trim().toLowerCase();
-        let value = line.slice(eq + 1).trim();
-        const wrapped = /^@ByteArray\((.*)\)$/.exec(value);
-        if (wrapped)
-            value = wrapped[1];
-        if (!out.has(section))
-            out.set(section, new Map());
-        out.get(section).set(key, value);
-    }
-    return out;
-}
+export { parseIni } from "../../core/ini.js";
 function samePath(a, b) {
     const norm = (p) => path.resolve(p.replace(/\\\\/g, "\\")).replace(/[\\/]+$/, "").toLowerCase();
     return norm(a) === norm(b);

package/dist/surfaces/skyrimse/surface.js

@@ -19,6 +19,7 @@ export const skyrimse = {
     aliases: ["skyrim", "skyrimspecialedition", "sse", "skse"],
     summary: "Creation Engine. Plugins (.esp/.esm/.esl) and archives (.bsa) in Data/, " +
         "with load order in Plugins.txt and native extensions via SKSE64.",
+    managedDataDir: "Data",
     async detect() {
         const installs = [];
         const override = process.env.MODWRIGHT_SKYRIMSE_ROOT;

package/dist/surfaces/stardewvalley/logs.js

@@ -4,6 +4,9 @@ const SCORE = "SMAPI src/SMAPI/Framework/SCore.cs";
 const LOGMANAGER = "SMAPI src/SMAPI/Framework/Logging/LogManager.cs";
 const CP = "Content Patcher ContentPatcher/ModEntry.cs and Framework/PatchLoader.cs";
 const PENDING = "pending a real sample";
+const CONTENT_MANAGER = "SMAPI src/SMAPI/Framework/ContentManagers/GameContentManager.cs (source-read 2026-09-29)";
+const SMAPI_PREFIX = String.raw `^\[(?<time>\d\d[:.]\d\d[:.]\d\d) (?<level>[A-Za-z]+)(?: +screen_(?<screen>\d+))? +SMAPI\] `;
+const ON_BEHALF = String.raw `(?: \(for the '(?<via>.+)' content pack\))?\.$`;
 export const PREFIX = String.raw `^\[(?<time>\d\d[:.]\d\d[:.]\d\d) (?<level>[A-Za-z]+)(?: +screen_(?<screen>\d+))? +(?<source>[^\]]+)\] `;
 function re(body) {
     return new RegExp(PREFIX + body);
@@ -304,4 +307,42 @@ export const SIGNATURES = [
         seenIn: [`${CP}`, PENDING],
         extract: ["pack"],
     }),
+    {
+        id: "stardewvalley.smapi.asset-edited",
+        game: "stardewvalley",
+        sources: ["smapi"],
+        severity: "info",
+        category: "attribution",
+        pattern: new RegExp(SMAPI_PREFIX + String.raw `(?<mod>.+?) edited (?<asset>.+?)` + ON_BEHALF),
+        explain: "SMAPI applied one mod's edit to a game asset (for a content pack when one is named). Every " +
+            "mod that edits an asset gets its own line, in the order the edits were applied, so the list " +
+            "for one asset answers 'which mod is changing this'; for the same field, the later editor wins.",
+        seenIn: [CONTENT_MANAGER, PENDING],
+        attribution: { kind: "edit", subject: "asset", actor: "mod", via: "via" },
+    },
+    {
+        id: "stardewvalley.smapi.asset-loaded",
+        game: "stardewvalley",
+        sources: ["smapi"],
+        severity: "info",
+        category: "attribution",
+        pattern: new RegExp(SMAPI_PREFIX + String.raw `(?<mod>.+?) loaded asset '(?<asset>[^']+)'` + ON_BEHALF),
+        explain: "One mod supplied a whole asset in place of the game's own (a Content Patcher Load, or a C# " +
+            "mod's loader). Only one mod can load a given asset; edits by others then apply on top.",
+        seenIn: [CONTENT_MANAGER, PENDING],
+        attribution: { kind: "replace", subject: "asset", actor: "mod", via: "via" },
+    },
+    smapi("asset-edit-crashed", {
+        severity: "error",
+        category: "resource",
+        pattern: re(String.raw `Mod crashed when (?<op>editing|loading) asset '(?<asset>[^']+)'(?: \(for the '(?<via>.+?)' content pack\))?[,.]`),
+        explain: "A mod threw while loading or editing a game asset. For a load SMAPI falls back to the game's " +
+            "own asset; for an edit the asset keeps whatever the earlier editors did, so the mod's change " +
+            "(and anything depending on it) is missing. The mod is the line's source.",
+        hint: "The continuation lines carry the exception; update or remove the named mod or content pack.",
+        seenIn: [CONTENT_MANAGER, PENDING],
+        extract: ["source", "op", "asset", "via"],
+        systemImpact: false,
+        attribution: { kind: "failed", subject: "asset", actor: "source", via: "via", detail: "op", alsoFinding: true },
+    }),
 ];

package/dist/surfaces/stardewvalley/surface.js

@@ -7,6 +7,7 @@ import { findInSteam } from "../../core/steam.js";
 import { dedupeByRoot, logs, roots } from "../../core/surfaceutil.js";
 import { SIGNATURES } from "./logs.js";
 import { WIKI_FETCH } from "./index/wiki.js";
+import { extractStardewWrites } from "./writes.js";
 import { parseManifest, scanMods } from "./mods.js";
 import { stardewvalleyCompat } from "./compat.js";
 import { readSmapiConfig, stringList } from "./config.js";
@@ -221,6 +222,7 @@ export const stardewvalley = {
         return reasons;
     },
     logSignatures: SIGNATURES,
+    extractWrites: (mod, root) => extractStardewWrites(mod, root),
     validators: [...MANIFEST_VALIDATORS, ...CONTENT_VALIDATORS, ...FIELDS_VALIDATORS, ...LOADORDER_VALIDATORS],
     index: stardewvalleyIndex,
     compat: stardewvalleyCompat,