modwright 0.1.3 → 0.1.5

package/dist/surfaces/skyrimse/validators/plugins.js

@@ -3,7 +3,7 @@ import { readPeFileVersion } from "../../../core/compat/pe.js";
 import { compareVersions, parseVersion } from "../../../core/compat/version.js";
 import { FORM_VERSION_LE, FORM_VERSION_SSE, HEADER_VERSION_EXPANDED_LIGHT_RANGE, MASTER_LIMIT_SSE, PluginHeaderError, VALID_HEADER_VERSIONS_SSE, pluginExtension, readPluginHeader, } from "../plugins.js";
 import { RUNTIME_EXPANDED_LIGHT_RANGE } from "../compat.js";
-const EVIDENCE = ["ModWright research"];
+const HEADER_EVIDENCE = ["sse.plugins.format.record-header-is-24-bytes", "sse.plugins.format.hedr-is-twelve-bytes"];
 function isPluginUnderSource(target, project) {
     if (target.kind !== "file" || pluginExtension(target.path) === undefined)
         return false;
@@ -26,7 +26,7 @@ async function headerOrFinding(id, file) {
             file,
             message: `${path.basename(file)} has no readable TES4 header (${reason}): ${err.message}`,
             fix: "A plugin must begin with a TES4 record; re-save it from the Creation Kit or xEdit, or check the file is not truncated.",
-            evidence: EVIDENCE,
+            evidence: HEADER_EVIDENCE,
         };
     }
 }
@@ -42,6 +42,7 @@ function findEntry(order, name) {
     const key = name.toLowerCase();
     return order.find((e) => e.name.toLowerCase() === key);
 }
+const MASTERSPRESENT_EVIDENCE = ["sse.plugins.format.mast-data-pairs-are-the-master-list", "sse.loadorder.files.five-masters-are-implicit-and-absent"];
 const mastersPresent = {
     id: "sse.plugins.masters-present",
     game: "skyrimse",
@@ -53,7 +54,7 @@ const mastersPresent = {
     needs: { project: true, install: true },
     cost: "edit",
     severity: "block",
-    evidence: EVIDENCE,
+    evidence: MASTERSPRESENT_EVIDENCE,
     async run(ctx) {
         if (ctx.target.kind !== "file")
             return [];
@@ -79,12 +80,13 @@ const mastersPresent = {
                         ? `Master "${master}" is under Data but not in the load order at all; ${path.basename(ctx.target.path)} depends on it.`
                         : `Master "${master}" is neither in the load order nor under Data; ${path.basename(ctx.target.path)} cannot load without it.`,
                 fix: entry ? `Activate ${master} (a * line in Plugins.txt).` : `Install ${master} and activate it ahead of ${path.basename(ctx.target.path)}.`,
-                evidence: EVIDENCE,
+                evidence: MASTERSPRESENT_EVIDENCE,
             });
         }
         return findings;
     },
 };
+const MASTERORDER_EVIDENCE = ["sse.plugins.format.mast-data-pairs-are-the-master-list", "sse.loadorder.files.master-hoisting"];
 const masterOrder = {
     id: "sse.plugins.master-order",
     game: "skyrimse",
@@ -96,7 +98,7 @@ const masterOrder = {
     needs: { project: true, install: true },
     cost: "edit",
     severity: "block",
-    evidence: [...EVIDENCE],
+    evidence: [...MASTERORDER_EVIDENCE],
     async run(ctx) {
         if (ctx.target.kind !== "file")
             return [];
@@ -114,7 +116,7 @@ const masterOrder = {
                     severity: "info",
                     file: ctx.target.path,
                     message: `${path.basename(ctx.target.path)} is not in the load order, so its masters' positions relative to it cannot be checked yet.`,
-                    evidence: EVIDENCE,
+                    evidence: MASTERORDER_EVIDENCE,
                 },
             ];
         }
@@ -129,12 +131,13 @@ const masterOrder = {
                 file: ctx.target.path,
                 message: `Master "${master}" loads at position ${entry.index}, after ${path.basename(ctx.target.path)} at ${self.index}; a plugin must load after every master it depends on.`,
                 fix: `Move ${master} above ${path.basename(ctx.target.path)} in Plugins.txt (LOOT does this).`,
-                evidence: [...EVIDENCE],
+                evidence: [...MASTERORDER_EVIDENCE],
             });
         }
         return findings;
     },
 };
+const ESLHEADERVERSION_EVIDENCE = ["sse.plugins.esl.hedr-1-71-unlocks-the-expanded-range", "sse.plugins.esl.masters-at-1-71-force-the-plugin-to-1-71", "sse.plugins.esl.1-71-plugins-crash-old-game-builds"];
 const eslHeaderVersion = {
     id: "sse.plugins.esl-header-version",
     game: "skyrimse",
@@ -146,7 +149,7 @@ const eslHeaderVersion = {
     needs: { project: true },
     cost: "edit",
     severity: "block",
-    evidence: EVIDENCE,
+    evidence: ESLHEADERVERSION_EVIDENCE,
     async run(ctx) {
         if (ctx.target.kind !== "file")
             return [];
@@ -161,7 +164,7 @@ const eslHeaderVersion = {
                 severity: "block",
                 file: ctx.target.path,
                 message: `${path.basename(ctx.target.path)} has no HEDR subrecord; every plugin's TES4 record carries one.`,
-                evidence: EVIDENCE,
+                evidence: ESLHEADERVERSION_EVIDENCE,
             });
             return findings;
         }
@@ -172,7 +175,7 @@ const eslHeaderVersion = {
                 file: ctx.target.path,
                 message: `HEDR version ${version.toFixed(2)} is not one Skyrim SE accepts (${VALID_HEADER_VERSIONS_SSE.map((v) => v.toFixed(2)).join(", ")}).`,
                 fix: "Re-save the plugin with the Skyrim SE Creation Kit or xEdit in SSE mode.",
-                evidence: EVIDENCE,
+                evidence: ESLHEADERVERSION_EVIDENCE,
             });
             return findings;
         }
@@ -185,7 +188,7 @@ const eslHeaderVersion = {
                     file: ctx.target.path,
                     message: `${path.basename(ctx.target.path)} has HEDR version ${version.toFixed(2)}, which needs game runtime ${RUNTIME_EXPANDED_LIGHT_RANGE} or later; this install is ${runtime}.`,
                     fix: "Update the game, or re-save the plugin with a 1.70 header if it uses no FormID below 0x800.",
-                    evidence: EVIDENCE,
+                    evidence: ESLHEADERVERSION_EVIDENCE,
                 });
             }
         }
@@ -204,7 +207,7 @@ const eslHeaderVersion = {
                                 file: ctx.target.path,
                                 message: `Master "${master}" is a ${mh.headerVersion.toFixed(2)} plugin while ${path.basename(ctx.target.path)} is ${version.toFixed(2)}; referencing or overriding that master's records in the extended FormID range (001-7FF) will error.`,
                                 fix: "Re-save this plugin with a 1.71 header (xEdit 4.1.5b or later, or the current Creation Kit).",
-                                evidence: EVIDENCE,
+                                evidence: ESLHEADERVERSION_EVIDENCE,
                             });
                         }
                     }
@@ -217,6 +220,7 @@ const eslHeaderVersion = {
         return findings;
     },
 };
+const FLAGEXTENSIONMISMATCH_EVIDENCE = ["sse.plugins.esl.extension-does-not-determine-lightness", "sse.plugins.format.tes4-flag-bits"];
 const flagExtensionMismatch = {
     id: "sse.plugins.flag-extension-mismatch",
     game: "skyrimse",
@@ -228,7 +232,7 @@ const flagExtensionMismatch = {
     needs: { project: true },
     cost: "edit",
     severity: "warn",
-    evidence: EVIDENCE,
+    evidence: FLAGEXTENSIONMISMATCH_EVIDENCE,
     async run(ctx) {
         if (ctx.target.kind !== "file")
             return [];
@@ -245,7 +249,7 @@ const flagExtensionMismatch = {
                     file: ctx.target.path,
                     message: `${name} has the ESM flag set: the game treats it as a master regardless of the .esp extension, so it loads among the masters and every header-reading tool disagrees with its name.`,
                     fix: "Clear the ESM flag in xEdit, or rename the file .esm so the extension says what the flag does.",
-                    evidence: EVIDENCE,
+                    evidence: FLAGEXTENSIONMISMATCH_EVIDENCE,
                 },
             ];
         }
@@ -257,13 +261,14 @@ const flagExtensionMismatch = {
                     file: ctx.target.path,
                     message: `${name} has no ESM flag: the .esm extension makes the game load it as a master anyway, but tools reading the header will not.`,
                     fix: "Set the ESM flag in xEdit so the header and the extension agree.",
-                    evidence: EVIDENCE,
+                    evidence: FLAGEXTENSIONMISMATCH_EVIDENCE,
                 },
             ];
         }
         return [];
     },
 };
+const ESLEXTENSIONIMPLIESFLAG_EVIDENCE = ["sse.plugins.esl.flag-is-bit-9-of-the-tes4-header", "sse.plugins.esl.extension-does-not-determine-lightness"];
 const eslExtensionImpliesFlag = {
     id: "sse.plugins.esl-extension-implies-flag",
     game: "skyrimse",
@@ -275,7 +280,7 @@ const eslExtensionImpliesFlag = {
     needs: { project: true },
     cost: "edit",
     severity: "warn",
-    evidence: EVIDENCE,
+    evidence: ESLEXTENSIONIMPLIESFLAG_EVIDENCE,
     async run(ctx) {
         if (ctx.target.kind !== "file")
             return [];
@@ -291,11 +296,12 @@ const eslExtensionImpliesFlag = {
                 file: ctx.target.path,
                 message: `${path.basename(ctx.target.path)} is an .esl without the light flag (0x200) in its header; the game treats it as light because of the extension, header-reading tools do not.`,
                 fix: "Set the ESL flag in xEdit (it checks the plugin's new records fit the light range first).",
-                evidence: EVIDENCE,
+                evidence: ESLEXTENSIONIMPLIESFLAG_EVIDENCE,
             },
         ];
     },
 };
+const FORMVERSION_EVIDENCE = ["sse.plugins.format.form-version-44-for-sse"];
 const formVersion = {
     id: "sse.plugins.form-version",
     game: "skyrimse",
@@ -307,7 +313,7 @@ const formVersion = {
     needs: { project: true },
     cost: "edit",
     severity: "block",
-    evidence: EVIDENCE,
+    evidence: FORMVERSION_EVIDENCE,
     async run(ctx) {
         if (ctx.target.kind !== "file")
             return [];
@@ -326,11 +332,12 @@ const formVersion = {
                     ? `${path.basename(ctx.target.path)} has form version 43: a Skyrim Legendary Edition plugin, not converted for Special Edition.`
                     : `${path.basename(ctx.target.path)} has form version ${header.formVersion}; Skyrim SE plugins carry 44.`,
                 fix: le ? "Open and re-save the plugin in the Skyrim SE Creation Kit to convert it (and re-pack any LE .bsa)." : "Re-save the plugin with the Skyrim SE Creation Kit or xEdit.",
-                evidence: EVIDENCE,
+                evidence: FORMVERSION_EVIDENCE,
             },
         ];
     },
 };
+const MASTERCOUNT_EVIDENCE = ["sse.plugins.esl.master-list-limit-is-253"];
 const masterCount = {
     id: "sse.plugins.master-count",
     game: "skyrimse",
@@ -342,7 +349,7 @@ const masterCount = {
     needs: { project: true },
     cost: "edit",
     severity: "block",
-    evidence: EVIDENCE,
+    evidence: MASTERCOUNT_EVIDENCE,
     async run(ctx) {
         if (ctx.target.kind !== "file")
             return [];
@@ -358,7 +365,7 @@ const masterCount = {
                 file: ctx.target.path,
                 message: `${path.basename(ctx.target.path)} names ${header.masters.length} masters; Skyrim SE allows ${MASTER_LIMIT_SSE}.`,
                 fix: "Clean unused masters in xEdit, or split the plugin.",
-                evidence: EVIDENCE,
+                evidence: MASTERCOUNT_EVIDENCE,
             },
         ];
     },

package/knowledge/cyberpunk2077/cet.natives.yaml

@@ -0,0 +1,48 @@
+game: cyberpunk2077
+topic: cet.natives
+title: CET-added native functions used to set up a test (spawn, teleport, level)
+facts:
+  - id: cp2077.cet.natives.exentityspawner-spawn-despawn
+    claim: "`exEntitySpawner` is a native that CET adds. `exEntitySpawner.Spawn(entPath, transform,
+      appearance)` spawns an entity from a resource path (backslash form, e.g.
+      `base\\characters\\entities\\gang\\gang__wraith_ma.ent`) at the given WorldTransform and
+      returns an entity id handle (userdata); `Game.FindEntityByID(handle)` resolves it to the
+      entity object. `exEntitySpawner.Despawn(entity)` despawns it, and takes the resolved object,
+      not the id handle."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - cet
+      - native
+      - spawn
+      - despawn
+      - workbench
+      - exentityspawner
+    detail: "Backs the probe cp2077.world.spawn. Two caveats from the 2026-09-12 run: spawning at the
+      player's own transform puts the player inside the spawned entity until they separate; and the
+      id handle does not survive across bridge calls (each cp2077.lua.eval is a fresh state), so a
+      despawn or respawn has to resolve the entity within the same call. No call is known that turns
+      a stored id string back into a live EntityID. CET's WorldFunctionalTests
+      (SpawnEntity/DespawnEntity) is the other spawn native it adds; this fact is about
+      exEntitySpawner, the one exercised. On 2026-10-04 the spawned entity appeared, but
+      `Game.FindEntityByID(handle)` in the same call returned nothing: the entity arrives after
+      `Spawn` returns, so resolve it in a later call."
+  - id: cp2077.cet.natives.teleport-and-setlevel-work-from-cet
+    claim: From CET Lua, `Game.GetTeleportationFacility():Teleport(Game.GetPlayer(), Vector4.new(x, y,
+      z, 1), EulerAngles.new(0, 0, yaw))` moves the player to that position, and
+      `Game.SetLevel("Level", n, 1)` sets the player level; both take effect at once. The level
+      reads back as `Game.GetStatsSystem():GetStatValue(Game.GetPlayer():GetEntityID(),
+      gamedataStatType.Level)`.
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    tags:
+      - cet
+      - native
+      - teleport
+      - level
+      - workbench
+    detail: Backs the probes cp2077.player.teleport and cp2077.player.level. The teleport's z settled
+      0.01 above the target, which is the ground under the player. A save that has been teleported
+      or levelled this way should not be kept.

package/knowledge/cyberpunk2077/tweakxl.yaml-syntax.yaml

@@ -60,7 +60,7 @@ facts:
   - id: cp2077.tweakxl.yaml-syntax.duplicate-keys-break-file
     claim: A duplicate key at the same nesting level in a TweakXL yaml file breaks the whole file's
       parse; the community-recommended check is to run the file through yamllint.com before packing.
-    status: community
+    status: contradicted
     source: CDPR-Modding-Documentation/Cyberpunk-Modding-Docs
       for-mod-creators-theory/core-mods-explained/tweakxl/tweakxl-changing-game-records/how-to-yaml-tweak-modding-basics.md,
       section "Key Uniqueness"
@@ -69,6 +69,26 @@ facts:
       - yaml
       - duplicate-key
       - validator
+    detail: "Contradicted for TweakXL 1.11.4: on 2026-10-04 it read seven installed files that repeat a
+      top-level key and logged no error for any of them, while it does log `[error] yaml-cpp: ...`
+      for a file that fails to parse
+      (cp2077.tweakxl.hotreload.parse-error-still-ends-in-import-completed). See
+      cp2077.tweakxl.yaml-syntax.duplicate-keys-do-not-fail-the-parse."
+  - id: cp2077.tweakxl.yaml-syntax.duplicate-keys-do-not-fail-the-parse
+    claim: "TweakXL 1.11.4 reads a yaml file that repeats a top-level key without a parse error: its log
+      shows the file being read and no error line, and the rest of the import goes on. Which
+      occurrence wins, or whether both apply, is not established."
+    status: verified
+    verified_on: "2.31"
+    source: ModWright field verification
+    supersedes: cp2077.tweakxl.yaml-syntax.duplicate-keys-break-file
+    tags:
+      - tweakxl
+      - yaml
+      - duplicate-key
+    detail: ModWright's write census (who_touches) reads such a file with every occurrence, in file
+      order. The yaml-lint rule still reports a repeated key in a project's own file, where it is
+      usually a mistake.
   - id: cp2077.tweakxl.yaml-syntax.record-names-must-be-unique
     claim: Every TweakXL record (a named container grouping properties, which may themselves be other
       records or flats) must have a globally unique name; two records sharing a name overwrite each

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "modwright",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "A game-agnostic MCP server for game modding, with per-game surfaces.",
   "type": "module",
   "main": "dist/index.js",