@rpgm-tools/neo-angband-core 0.12.0 → 0.14.0

package/README.md

@@ -32,7 +32,7 @@ import { Rng, ENGINE_VERSION, PARITY_BASELINE } from "@rpgm-tools/neo-angband-co
 const rng = new Rng(1234);
 console.log(rng.damroll(3, 6), rng.damroll(3, 6), rng.damroll(3, 6)); // 9 13 8
 
-console.log(ENGINE_VERSION, PARITY_BASELINE); // 0.12.0 4.2.6
+console.log(ENGINE_VERSION, PARITY_BASELINE); // 0.14.0 4.2.6
 ```
 
 Two entry points:

package/dist/mod/hooks.d.ts

@@ -184,27 +184,67 @@ export interface ModHooks {
 /**
  * Fold several mods' contributions into the single ModHooks core holds.
  *
- * Order is LOAD order, and what "later wins" means differs per hook because the
- * hooks differ in kind - which is precisely why this is one written-down function
- * and not a generic merge:
+ * Order is LOAD order, and THE LATER MOD WINS EVERY DISAGREEMENT. That is the
+ * rule the mod manager's own row promises the player ("Move later (loads last,
+ * wins conflicts)") and the rule every other composition layer follows, so this
+ * one obeys it too - see the note below for the two folds that look like
+ * exceptions and are not.
  *
+ *  - LAST-HANDLER hooks (walkBlockedByDiggable) are asked in REVERSE load order
+ *    and stop at the first non-null, so the last mod to have an opinion is the
+ *    one whose handling takes effect and no earlier mod can double-spend the
+ *    energy it already paid out.
+ *  - ORDERING hooks (objectListTiebreak) chain the same way round: the last
+ *    mod's comparator is the primary key and earlier ones break the ties it
+ *    leaves, which is a valid total order and is "later wins" for a comparator.
+ *  - TRANSFORM hooks (messageText) compose in load order, each seeing the
+ *    previous one's output - so the last mod still speaks last and has the final
+ *    say over the text that reaches the player.
  *  - VETO hooks (levelGenerated, artifactCommit, historyAdd) are conjunctive:
- *    every contributor must agree, and the first refusal decides. This is the
- *    only safe fold - a mod that vetoes a duplicate artifact must not be
- *    overruled by a later mod that merely has no opinion.
- *  - TRANSFORM hooks (messageText) compose in order, each seeing the previous
- *    one's output.
- *  - FIRST-HANDLER hooks (walkBlockedByDiggable) stop at the first non-null, so
- *    an earlier mod's handling wins and a later one cannot double-spend energy.
+ *    every contributor runs and any refusal decides.
  *  - ANY hooks (saveNoiseScent) are disjunctive: one mod asking for the data is
  *    enough, because the data is additive and a second mod cannot object.
- *  - ORDERING hooks (objectListTiebreak) stop at the first non-zero answer, the
- *    same way a lexicographic comparator chains.
+ *
+ * WHY THE LAST TWO ARE NOT EXCEPTIONS. "Later wins" answers the question "two
+ * mods disagree about one thing - whose answer is used?", and a veto hook is not
+ * asking that question. `true` from historyAdd means "I have nothing to say
+ * about this entry", not "I insist it be written": the hook is called once per
+ * entry, and two mods suppressing two different things are not in conflict at
+ * all. Resolving it last-wins would mean a later mod's silence cancelled an
+ * earlier mod's rule, breaking BOTH mods to satisfy a consistency nobody asked
+ * for. Same for saveNoiseScent, where `false` is "I do not need this" and the
+ * data is additive. The consistency that matters is that no mod's opinion is
+ * ever DISCARDED in favour of an earlier one, and these two discard nothing.
  *
  * Returns undefined when nothing contributed, so the caller can leave the field
  * absent rather than storing an empty object - keeping "no mod loaded" and "a
  * mod loaded that touches nothing" indistinguishable from core's side.
  */
+/**
+ * How composeModHooks folds several mods' contributions to one hook.
+ *
+ * A subset of the vocabulary the pack tooling uses for every composition layer
+ * (mod-sdk's `Fold`), so the host can hand these values straight to the conflict
+ * report and the compiler checks the two agree.
+ */
+export type ModHookFold = "all-must-agree" | "chained" | "last-answer" | "any-yes";
+/**
+ * WHICH FOLD EACH HOOK USES, next to the function that implements it.
+ *
+ * The conflict report needs this to tell the player whether two mods touching
+ * one hook COMBINE or whether one of them is being silently ignored. Every fold
+ * here obeys "the later mod wins"; what differs is whether there is anything for
+ * a winner to win, and only `last-answer` leaves a contribution unrun. That
+ * distinction is the whole reason the report names the fold instead of printing
+ * one sentence about load order.
+ *
+ * It lives in core, beside composeModHooks, because a second copy in the host is
+ * the shape that drifts: the host is where the report is rendered, so a hook
+ * added here and forgotten there would be described by whatever the table
+ * happened to default to. Keyed by `keyof ModHooks`, so adding a member to the
+ * interface without adding it here does not compile.
+ */
+export declare const MOD_HOOK_FOLDS: Readonly<Record<keyof ModHooks, ModHookFold>>;
 /**
  * A mod's hook function threw. Reported to whoever guarded it (guardModHooks).
  *

package/dist/mod/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/mod/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;;;;;;;;;;;OAgBG;IACH,qBAAqB,CAAC,EAAE,CACtB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAC9B,IAAI,EAAE,OAAO,KACV,MAAM,GAAG,IAAI,CAAC;IAEnB;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,CACnB,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAC/C,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAC5C,MAAM,CAAC;IAEZ;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAE3D;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,KAAK,OAAO,CAAC;IAEpE;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;IAE/G;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;IAE/B;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,QAAQ,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACrC,QAAQ,CAmEV;AAED,wBAAgB,eAAe,CAC7B,aAAa,EAAE,SAAS,QAAQ,EAAE,GACjC,QAAQ,GAAG,SAAS,CAkEtB"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/mod/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;;;;;;;;;;;OAgBG;IACH,qBAAqB,CAAC,EAAE,CACtB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAC9B,IAAI,EAAE,OAAO,KACV,MAAM,GAAG,IAAI,CAAC;IAEnB;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,CACnB,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAC/C,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAC5C,MAAM,CAAC;IAEZ;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAE3D;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,KAAK,OAAO,CAAC;IAEpE;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;IAE/G;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;IAE/B;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB,gBAAgB,GAChB,SAAS,GACT,aAAa,GACb,SAAS,CAAC;AAEd;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,QAAQ,EAAE,WAAW,CAAC,CAQxE,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,QAAQ,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACrC,QAAQ,CAmEV;AAED,wBAAgB,eAAe,CAC7B,aAAa,EAAE,SAAS,QAAQ,EAAE,GACjC,QAAQ,GAAG,SAAS,CA8EtB"}

package/dist/mod/hooks.js

@@ -69,6 +69,31 @@
  * break by reaching for a global; the test suite pins it by running generation
  * with a hook installed and asserting the level is bit-identical.
  */
+/**
+ * WHICH FOLD EACH HOOK USES, next to the function that implements it.
+ *
+ * The conflict report needs this to tell the player whether two mods touching
+ * one hook COMBINE or whether one of them is being silently ignored. Every fold
+ * here obeys "the later mod wins"; what differs is whether there is anything for
+ * a winner to win, and only `last-answer` leaves a contribution unrun. That
+ * distinction is the whole reason the report names the fold instead of printing
+ * one sentence about load order.
+ *
+ * It lives in core, beside composeModHooks, because a second copy in the host is
+ * the shape that drifts: the host is where the report is rendered, so a hook
+ * added here and forgotten there would be described by whatever the table
+ * happened to default to. Keyed by `keyof ModHooks`, so adding a member to the
+ * interface without adding it here does not compile.
+ */
+export const MOD_HOOK_FOLDS = {
+    walkBlockedByDiggable: "last-answer",
+    objectListTiebreak: "last-answer",
+    levelGenerated: "all-must-agree",
+    artifactCommit: "all-must-agree",
+    historyAdd: "all-must-agree",
+    saveNoiseScent: "any-yes",
+    messageText: "chained",
+};
 /**
  * ONE mod's contribution, with every hook wrapped so a throw cannot escape into
  * the middle of a turn.
@@ -164,9 +189,18 @@ export function composeModHooks(contributions) {
     if (list.length === 0)
         return undefined;
     const out = {};
-    const walk = list.map((c) => c.walkBlockedByDiggable).filter(isFn);
+    /* REVERSE load order for both of the last-answer folds, so the mod the player
+     * moved to the bottom of the list is the one that gets asked first and
+     * therefore the one that decides. Reversed here, once, rather than by walking
+     * the array backwards at call time: the reversal is a property of the FOLD, and
+     * a `for (let i = n - 1; ...)` in the hot path is the kind of detail a later
+     * edit quietly straightens out. */
+    const walk = list.map((c) => c.walkBlockedByDiggable).filter(isFn).reverse();
     if (walk.length > 0) {
         out.walkBlockedByDiggable = (state, grid, deps) => {
+            /* Declining is contractually free of observable effect (see the member's
+             * doc), so asking a mod that then declines costs nothing - which is what
+             * makes it safe to ask them in any order at all. */
             for (const fn of walk) {
                 const energy = fn(state, grid, deps);
                 if (energy !== null)
@@ -175,9 +209,12 @@ export function composeModHooks(contributions) {
             return null;
         };
     }
-    const tiebreak = list.map((c) => c.objectListTiebreak).filter(isFn);
+    const tiebreak = list.map((c) => c.objectListTiebreak).filter(isFn).reverse();
     if (tiebreak.length > 0) {
         out.objectListTiebreak = (a, b) => {
+            /* The last mod's comparator is the primary sort key and the earlier ones
+             * only break the ties it leaves equal - a lexicographic chain, still a
+             * consistent total order, and "the later mod wins" for a comparator. */
             for (const fn of tiebreak) {
                 const r = fn(a, b);
                 if (r !== 0)

package/dist/mod/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/mod/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/mod/hooks.ts"],"names":[],"mappings":"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"}

package/dist/mod/save-blocks.d.ts

@@ -128,7 +128,7 @@ export type OrphanStore = Record<string, OrphanEntry[]>;
  * core pack outright, and versionMap's versions are only ever used to key
  * quarantined MOD entities. An existing save keeps whatever it recorded.
  */
-export declare const CORE_PACK_VERSION = "0.12.0";
+export declare const CORE_PACK_VERSION = "0.14.0";
 /** A core-only manifest: the base game with no mods, deterministic. */
 export declare function coreOnlyManifest(): SaveManifest;
 /**

package/dist/mod/vocabulary.js.map

@@ -1 +1 @@
-{"version":3,"file":"vocabulary.js","sourceRoot":"","sources":["../../src/mod/vocabulary.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vocabulary.js","sourceRoot":"","sources":["../../src/mod/vocabulary.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -21,5 +21,5 @@ export declare const PARITY_BASELINE = "4.2.6";
  * released tag is iterated takes a MINOR bump, because a published tag is pinned
  * by digest in a catalogue and must never be moved.
  */
-export declare const ENGINE_VERSION = "0.12.0";
+export declare const ENGINE_VERSION = "0.14.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -21,5 +21,5 @@ export const PARITY_BASELINE = "4.2.6";
  * released tag is iterated takes a MINOR bump, because a published tag is pinned
  * by digest in a catalogue and must never be moved.
  */
-export const ENGINE_VERSION = "0.12.0";
+export const ENGINE_VERSION = "0.14.0";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rpgm-tools/neo-angband-core",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Headless Neo Angband game engine: rules, world, entities, effects, generation",
   "license": "GPL-2.0-only",
   "author": "neostryder (RPGM Tools)",

package/src/mod/hooks.ts

@@ -1,402 +1,468 @@
-/**
- * The behaviour seam: the closed set of points where a mod may change what the
- * ENGINE does, as opposed to what content it runs on.
- *
- * WHY THIS EXISTS
- *
- * Content mods are already fully expressible - a pack contributes records and
- * composeContentPacks merges them, and core never learns a mod was involved.
- * Behaviour is different. A fix like "don't log a duplicate unique kill" is not a
- * record; it is a decision taken inside a function, and no amount of data can
- * reach inside that function from outside. So the first cut of the bundled
- * bug-fixes / QoL mods did the only thing that was available: the FIX LIVED IN
- * CORE behind `if (modRuleEnabled(state, "bugfix.x"))`.
- *
- * That was wrong, and neostryder named exactly why (2026-07-29): "the whole point of
- * making them mods was to exclude them from the core game." A flag-gated fix is
- * not excluded from core. It ships in core, it is tested in core, and core
- * carries the string "bugfix.uniqueKillHistory" - so core knows the mod's name.
- * Deleting the mod folder would not delete one line of it.
- *
- * WHAT THIS CHANGES, AND WHAT IT HONESTLY DOES NOT
- *
- * After this, core contains no mod's fix and no mod's name: no `bugfix.*` or
- * `qol.*` literal, no staircase repair, no message rewriter. Each fix body lives
- * in its mod's own folder and arrives as that mod's code.
- *
- * What core still contains - and cannot stop containing - is the SEAM ITSELF:
- * one named, documented extension point per behaviour a mod may override. That
- * is not a residue of the bundled mods; it is the price of behaviour modding at
- * all, and it is the same bargain SKSE, Forge and every other real modding
- * system strikes. The difference from a flag read is the difference that matters:
- * a seam is generic and available to ANY mod, and it holds no opinion about what
- * should plug into it, whereas `if (modRuleEnabled(state, "bugfix.stairsReachable"))`
- * is core implementing one specific mod.
- *
- * SHAPE
- *
- * A plain interface of optional functions rather than a string-keyed registry,
- * for three reasons:
- *
- *  - It is typed end to end. A registry keyed by strings pushes every payload
- *    through `unknown` and moves the errors to runtime.
- *  - "A disabled mod's patches DO NOT EXIST" becomes literally true, not merely
- *    false-y: with no mod loaded the field is ABSENT, the optional call is not
- *    made, and the faithful path is the only path that was ever compiled into
- *    the branch. No flag map is consulted because there is no flag map.
- *  - It costs nothing. `state.modHooks?.historyAdd?.(...)` on an absent object is
- *    one undefined check, not a map lookup per call.
- *
- * COMPOSITION IS THE HOST'S JOB
- *
- * Two enabled mods may both want the same hook. Core deliberately holds ONE
- * ModHooks and knows nothing about mod identity, ordering or enablement - the
- * host (web/cli) collects each enabled mod's contributions in load order and
- * folds them into a single object (see composeModHooks). This is the same
- * layering as content: core consumes a composed result and never the pack list.
- *
- * A hook is arbitrary third-party code running inside a turn, so it can throw.
- * guardModHooks wraps one mod's contribution and turns a throw into that hook's
- * neutral answer - see its comment for why that is the least-bad of the three
- * options, and for the half of the job it deliberately leaves to the host.
- *
- * DETERMINISM
- *
- * Two of these run inside the generation and object pipelines, where an extra
- * RNG draw does not merely change a value, it desynchronises every draw after
- * it - so a seed would stop meaning the same level. Those hooks are documented
- * RNG-FREE and are given no rng to draw from. That is a contract a mod can still
- * break by reaching for a global; the test suite pins it by running generation
- * with a hook installed and asserting the level is bit-identical.
- */
-
-import type { GameState } from "../game/context.js";
-
-/**
- * A mod's behaviour contributions. Every member is optional; an absent member
- * means "this mod does not touch that point" and core takes its faithful path.
- *
- * Each entry documents the ONE core call site it serves, because a hook whose
- * call site is not written down is a hook nobody can verify is still wired -
- * exactly the failure the call-site census exists to catch.
- */
-export interface ModHooks {
-  /**
-   * A walk into a grid the player could tunnel through (cave-cmd.ts,
-   * movementAutoDig's call site).
-   *
-   * Return the energy the move should cost, or null to decline - and declining
-   * MUST be free of observable effect, because faithful core's behaviour here is
-   * to bump into the wall without drawing any RNG. A hook that rolls a dig check
-   * and then returns null has already moved the RNG stream.
-   *
-   * `deps` is the live CaveCmdDeps the session built, passed through because the
-   * work a mod would want to do here (tunnelAux - one real dig attempt with the
-   * upstream roll and payouts) needs dependencies only the session can construct.
-   * Typed as unknown so this seam does not drag the cave-command types into every
-   * consumer of ModHooks; a mod casts it back to CaveCmdDeps, which core exports.
-   *
-   * Serves: the QoL mod's "auto-dig on walk".
-   */
-  walkBlockedByDiggable?: (
-    state: GameState,
-    grid: { y: number; x: number },
-    deps: unknown,
-  ) => number | null;
-
-  /**
-   * Two floor-list entries that compared exactly equal, including on distance
-   * (obj-list.ts, the comparator's final tiebreak).
-   *
-   * Return a negative/positive number to order them, or 0 to leave them equal
-   * (which is what faithful core does - it keeps collect order via a stable
-   * sort). Must be a consistent total order or the sort is meaningless.
-   *
-   * Serves: the bug-fixes mod's strict object-list ordering (#4664).
-   */
-  objectListTiebreak?: (
-    a: { readonly dy: number; readonly dx: number },
-    b: { readonly dy: number; readonly dx: number },
-  ) => number;
-
-  /**
-   * A finished, otherwise-accepted level, before cave_generate returns it
-   * (generate.ts, the accept branch).
-   *
-   * Return false to REJECT the level, which makes cave_generate re-roll exactly
-   * as it does for a monster-maximum overflow. May mutate the level to repair it
-   * and then return true.
-   *
-   * RNG-FREE: no rng is passed and none may be reached. A draw here shifts every
-   * subsequent draw and a seed stops reproducing its dungeon.
-   *
-   * Serves: the bug-fixes mod's reachable-staircase repair.
-   */
-  levelGenerated?: (gen: unknown, quest: boolean) => boolean;
-
-  /**
-   * An object about to be committed as an artifact, when it ALREADY carries one
-   * (obj/make.ts, the `obj.artifact` branch).
-   *
-   * Return false to refuse the commit; the caller then clears the artifact and
-   * reports failure. Faithful core commits it unconditionally.
-   *
-   * RNG-FREE, for the same reason as levelGenerated: this runs inside object
-   * creation, on the main stream.
-   *
-   * Serves: the bug-fixes mod's duplicate-artifact guard (#4510).
-   */
-  artifactCommit?: (aidx: number, alreadyCreated: boolean) => boolean;
-
-  /**
-   * A character-history entry about to be written (session/game.ts and any
-   * other historyAdd call site that passes its context).
-   *
-   * Return false to suppress the entry. Faithful core writes every entry it
-   * reaches, duplicates included.
-   *
-   * Serves: the bug-fixes mod's no-duplicate-unique-kill fix (#4245).
-   */
-  historyAdd?: (entry: { readonly what: string; readonly type: number; readonly duplicate: boolean }) => boolean;
-
-  /**
-   * Whether the noise and scent heatmaps belong in the save (session/save.ts,
-   * snapshotSquares' argument).
-   *
-   * Return true to persist them. Faithful core omits them, which is the upstream
-   * behaviour and the upstream bug.
-   *
-   * Serves: the bug-fixes mod's noise/scent persistence (#4605).
-   */
-  saveNoiseScent?: () => boolean;
-
-  /**
-   * Player-visible message text, on its way to the message line (the host's
-   * message sink).
-   *
-   * Return the text to show. Faithful core shows what it was given, warts and
-   * all. A hook here can only RESTATE a message - it must never change what a
-   * message means, or the port would be showing text upstream never wrote and no
-   * census could see it.
-   *
-   * Serves: the bug-fixes mod's cosmetic string corrections.
-   */
-  messageText?: (raw: string) => string;
-}
-
-/**
- * Fold several mods' contributions into the single ModHooks core holds.
- *
- * Order is LOAD order, and what "later wins" means differs per hook because the
- * hooks differ in kind - which is precisely why this is one written-down function
- * and not a generic merge:
- *
- *  - VETO hooks (levelGenerated, artifactCommit, historyAdd) are conjunctive:
- *    every contributor must agree, and the first refusal decides. This is the
- *    only safe fold - a mod that vetoes a duplicate artifact must not be
- *    overruled by a later mod that merely has no opinion.
- *  - TRANSFORM hooks (messageText) compose in order, each seeing the previous
- *    one's output.
- *  - FIRST-HANDLER hooks (walkBlockedByDiggable) stop at the first non-null, so
- *    an earlier mod's handling wins and a later one cannot double-spend energy.
- *  - ANY hooks (saveNoiseScent) are disjunctive: one mod asking for the data is
- *    enough, because the data is additive and a second mod cannot object.
- *  - ORDERING hooks (objectListTiebreak) stop at the first non-zero answer, the
- *    same way a lexicographic comparator chains.
- *
- * Returns undefined when nothing contributed, so the caller can leave the field
- * absent rather than storing an empty object - keeping "no mod loaded" and "a
- * mod loaded that touches nothing" indistinguishable from core's side.
- */
-/**
- * A mod's hook function threw. Reported to whoever guarded it (guardModHooks).
- *
- * Carries no mod id, because core does not know one - the host wraps ONE mod's
- * contribution at a time and already holds the id in the closure it passes in.
- */
-export interface ModHookFault {
-  /** Which extension point threw, by its ModHooks member name. */
-  readonly hook: keyof ModHooks;
-  /** Whatever the mod threw, unwrapped and uninterpreted. */
-  readonly error: unknown;
-}
-
-/**
- * ONE mod's contribution, with every hook wrapped so a throw cannot escape into
- * the middle of a turn.
- *
- * WHY THIS IS NOT "CATCH AND CARRY ON REGARDLESS". An uncaught throw here lands
- * in the middle of core - halfway through a move, a generation pass or an object
- * roll - and unwinds the rest of the turn. It does not undo what the mod already
- * did before it threw, so the state is no LESS inconsistent for the abort; it is
- * more, because the turn's remaining bookkeeping never ran. And it reaches the
- * host as a bare exception from a function the host did not know a mod was
- * inside, so the player gets a frozen screen and no name.
- *
- * So a throwing hook is treated as a mod that DECLINED to answer at that point,
- * and the neutral answer is per-hook - it has to be, because "no opinion" is
- * `true` for a veto, `null` for a handler, `0` for a comparator and the input
- * itself for a transform. Those values live HERE, next to the fold rule in
- * composeModHooks that already spells out each hook's kind, rather than in the
- * host: two copies of "what does this hook mean by nothing" is the pair that
- * drifts.
- *
- * WHAT THIS DOES NOT DO, deliberately: it does not make the session safe. The
- * mod ran arbitrary code against live state and stopped partway. Neutralising
- * the hook keeps the game on its feet long enough to say so; it is the HOST's
- * job to treat the fault as terminal for the session - stop writing saves and
- * tell the player to reload (packages/web/src/mod-taint.ts). A guard without
- * that second half would be the worst outcome of the three: quietly wrong.
- *
- * LATCHED PER HOOK. Once a hook has thrown it is not called again for the rest
- * of the session. A hook that throws on a bad monster will throw on the next
- * one too, and an exception per call turns one fault into a storm of them; more
- * importantly, "sometimes the mod's rule applies and sometimes it doesn't" is
- * harder to reason about than "it stopped applying at the point it broke". The
- * mod's other hooks are untouched - the latch is per (mod, hook), not per mod.
- */
-export function guardModHooks(
-  hooks: ModHooks,
-  onFault: (fault: ModHookFault) => void,
-): ModHooks {
-  const out: ModHooks = {};
-  const stopped = new Set<keyof ModHooks>();
-
-  function guard<T>(hook: keyof ModHooks, run: () => T, neutral: T): T {
-    if (stopped.has(hook)) return neutral;
-    try {
-      return run();
-    } catch (error) {
-      stopped.add(hook);
-      onFault({ hook, error });
-      return neutral;
-    }
-  }
-
-  const walk = hooks.walkBlockedByDiggable;
-  if (walk) {
-    /* null is DECLINE, so core bumps the wall as it would with no mod loaded. */
-    out.walkBlockedByDiggable = (state, grid, deps): number | null =>
-      guard("walkBlockedByDiggable", () => walk(state, grid, deps), null);
-  }
-
-  const tiebreak = hooks.objectListTiebreak;
-  if (tiebreak) {
-    /* 0 is "still equal", which is exactly faithful core's answer. */
-    out.objectListTiebreak = (a, b): number =>
-      guard("objectListTiebreak", () => tiebreak(a, b), 0);
-  }
-
-  const level = hooks.levelGenerated;
-  if (level) {
-    /* ACCEPT. Rejecting on a throw would re-roll the level, and cave_generate
-     * would then re-roll it again on the next throw, and so on until it gives
-     * up - one broken hook would make the game unable to reach any level. */
-    out.levelGenerated = (gen, quest): boolean =>
-      guard("levelGenerated", () => level(gen, quest), true);
-  }
-
-  const artifact = hooks.artifactCommit;
-  if (artifact) {
-    /* COMMIT, which is what core does unconditionally without the hook. */
-    out.artifactCommit = (aidx, alreadyCreated): boolean =>
-      guard("artifactCommit", () => artifact(aidx, alreadyCreated), true);
-  }
-
-  const history = hooks.historyAdd;
-  if (history) {
-    /* WRITE the entry: faithful core writes every entry it reaches. Suppressing
-     * on a throw would delete history the player earned. */
-    out.historyAdd = (entry): boolean =>
-      guard("historyAdd", () => history(entry), true);
-  }
-
-  const noise = hooks.saveNoiseScent;
-  if (noise) {
-    /* OMIT them, the upstream behaviour. */
-    out.saveNoiseScent = (): boolean => guard("saveNoiseScent", () => noise(), false);
-  }
-
-  const text = hooks.messageText;
-  if (text) {
-    /* The raw message, unrestated - never an empty string, which would silently
-     * eat a message the player needed to read. */
-    out.messageText = (raw): string => guard("messageText", () => text(raw), raw);
-  }
-
-  return out;
-}
-
-export function composeModHooks(
-  contributions: readonly ModHooks[],
-): ModHooks | undefined {
-  const list = contributions.filter((c) => Object.keys(c).length > 0);
-  if (list.length === 0) return undefined;
-
-  const out: ModHooks = {};
-
-  const walk = list.map((c) => c.walkBlockedByDiggable).filter(isFn);
-  if (walk.length > 0) {
-    out.walkBlockedByDiggable = (state, grid, deps): number | null => {
-      for (const fn of walk) {
-        const energy = fn(state, grid, deps);
-        if (energy !== null) return energy;
-      }
-      return null;
-    };
-  }
-
-  const tiebreak = list.map((c) => c.objectListTiebreak).filter(isFn);
-  if (tiebreak.length > 0) {
-    out.objectListTiebreak = (a, b): number => {
-      for (const fn of tiebreak) {
-        const r = fn(a, b);
-        if (r !== 0) return r;
-      }
-      return 0;
-    };
-  }
-
-  const level = list.map((c) => c.levelGenerated).filter(isFn);
-  if (level.length > 0) {
-    out.levelGenerated = (gen, quest): boolean => {
-      /* Every contributor runs even after one has repaired the level, because a
-       * second mod's invariant is not satisfied by the first mod's repair. The
-       * first REFUSAL short-circuits, since the level is being thrown away. */
-      for (const fn of level) if (!fn(gen, quest)) return false;
-      return true;
-    };
-  }
-
-  const artifact = list.map((c) => c.artifactCommit).filter(isFn);
-  if (artifact.length > 0) {
-    out.artifactCommit = (aidx, alreadyCreated): boolean => {
-      for (const fn of artifact) if (!fn(aidx, alreadyCreated)) return false;
-      return true;
-    };
-  }
-
-  const history = list.map((c) => c.historyAdd).filter(isFn);
-  if (history.length > 0) {
-    out.historyAdd = (entry): boolean => {
-      for (const fn of history) if (!fn(entry)) return false;
-      return true;
-    };
-  }
-
-  const noise = list.map((c) => c.saveNoiseScent).filter(isFn);
-  if (noise.length > 0) {
-    out.saveNoiseScent = (): boolean => noise.some((fn) => fn());
-  }
-
-  const text = list.map((c) => c.messageText).filter(isFn);
-  if (text.length > 0) {
-    out.messageText = (raw): string => text.reduce((s, fn) => fn(s), raw);
-  }
-
-  return out;
-}
-
-function isFn<T>(v: T | undefined): v is T {
-  return typeof v === "function";
-}
+/**
+ * The behaviour seam: the closed set of points where a mod may change what the
+ * ENGINE does, as opposed to what content it runs on.
+ *
+ * WHY THIS EXISTS
+ *
+ * Content mods are already fully expressible - a pack contributes records and
+ * composeContentPacks merges them, and core never learns a mod was involved.
+ * Behaviour is different. A fix like "don't log a duplicate unique kill" is not a
+ * record; it is a decision taken inside a function, and no amount of data can
+ * reach inside that function from outside. So the first cut of the bundled
+ * bug-fixes / QoL mods did the only thing that was available: the FIX LIVED IN
+ * CORE behind `if (modRuleEnabled(state, "bugfix.x"))`.
+ *
+ * That was wrong, and neostryder named exactly why (2026-07-29): "the whole point of
+ * making them mods was to exclude them from the core game." A flag-gated fix is
+ * not excluded from core. It ships in core, it is tested in core, and core
+ * carries the string "bugfix.uniqueKillHistory" - so core knows the mod's name.
+ * Deleting the mod folder would not delete one line of it.
+ *
+ * WHAT THIS CHANGES, AND WHAT IT HONESTLY DOES NOT
+ *
+ * After this, core contains no mod's fix and no mod's name: no `bugfix.*` or
+ * `qol.*` literal, no staircase repair, no message rewriter. Each fix body lives
+ * in its mod's own folder and arrives as that mod's code.
+ *
+ * What core still contains - and cannot stop containing - is the SEAM ITSELF:
+ * one named, documented extension point per behaviour a mod may override. That
+ * is not a residue of the bundled mods; it is the price of behaviour modding at
+ * all, and it is the same bargain SKSE, Forge and every other real modding
+ * system strikes. The difference from a flag read is the difference that matters:
+ * a seam is generic and available to ANY mod, and it holds no opinion about what
+ * should plug into it, whereas `if (modRuleEnabled(state, "bugfix.stairsReachable"))`
+ * is core implementing one specific mod.
+ *
+ * SHAPE
+ *
+ * A plain interface of optional functions rather than a string-keyed registry,
+ * for three reasons:
+ *
+ *  - It is typed end to end. A registry keyed by strings pushes every payload
+ *    through `unknown` and moves the errors to runtime.
+ *  - "A disabled mod's patches DO NOT EXIST" becomes literally true, not merely
+ *    false-y: with no mod loaded the field is ABSENT, the optional call is not
+ *    made, and the faithful path is the only path that was ever compiled into
+ *    the branch. No flag map is consulted because there is no flag map.
+ *  - It costs nothing. `state.modHooks?.historyAdd?.(...)` on an absent object is
+ *    one undefined check, not a map lookup per call.
+ *
+ * COMPOSITION IS THE HOST'S JOB
+ *
+ * Two enabled mods may both want the same hook. Core deliberately holds ONE
+ * ModHooks and knows nothing about mod identity, ordering or enablement - the
+ * host (web/cli) collects each enabled mod's contributions in load order and
+ * folds them into a single object (see composeModHooks). This is the same
+ * layering as content: core consumes a composed result and never the pack list.
+ *
+ * A hook is arbitrary third-party code running inside a turn, so it can throw.
+ * guardModHooks wraps one mod's contribution and turns a throw into that hook's
+ * neutral answer - see its comment for why that is the least-bad of the three
+ * options, and for the half of the job it deliberately leaves to the host.
+ *
+ * DETERMINISM
+ *
+ * Two of these run inside the generation and object pipelines, where an extra
+ * RNG draw does not merely change a value, it desynchronises every draw after
+ * it - so a seed would stop meaning the same level. Those hooks are documented
+ * RNG-FREE and are given no rng to draw from. That is a contract a mod can still
+ * break by reaching for a global; the test suite pins it by running generation
+ * with a hook installed and asserting the level is bit-identical.
+ */
+
+import type { GameState } from "../game/context.js";
+
+/**
+ * A mod's behaviour contributions. Every member is optional; an absent member
+ * means "this mod does not touch that point" and core takes its faithful path.
+ *
+ * Each entry documents the ONE core call site it serves, because a hook whose
+ * call site is not written down is a hook nobody can verify is still wired -
+ * exactly the failure the call-site census exists to catch.
+ */
+export interface ModHooks {
+  /**
+   * A walk into a grid the player could tunnel through (cave-cmd.ts,
+   * movementAutoDig's call site).
+   *
+   * Return the energy the move should cost, or null to decline - and declining
+   * MUST be free of observable effect, because faithful core's behaviour here is
+   * to bump into the wall without drawing any RNG. A hook that rolls a dig check
+   * and then returns null has already moved the RNG stream.
+   *
+   * `deps` is the live CaveCmdDeps the session built, passed through because the
+   * work a mod would want to do here (tunnelAux - one real dig attempt with the
+   * upstream roll and payouts) needs dependencies only the session can construct.
+   * Typed as unknown so this seam does not drag the cave-command types into every
+   * consumer of ModHooks; a mod casts it back to CaveCmdDeps, which core exports.
+   *
+   * Serves: the QoL mod's "auto-dig on walk".
+   */
+  walkBlockedByDiggable?: (
+    state: GameState,
+    grid: { y: number; x: number },
+    deps: unknown,
+  ) => number | null;
+
+  /**
+   * Two floor-list entries that compared exactly equal, including on distance
+   * (obj-list.ts, the comparator's final tiebreak).
+   *
+   * Return a negative/positive number to order them, or 0 to leave them equal
+   * (which is what faithful core does - it keeps collect order via a stable
+   * sort). Must be a consistent total order or the sort is meaningless.
+   *
+   * Serves: the bug-fixes mod's strict object-list ordering (#4664).
+   */
+  objectListTiebreak?: (
+    a: { readonly dy: number; readonly dx: number },
+    b: { readonly dy: number; readonly dx: number },
+  ) => number;
+
+  /**
+   * A finished, otherwise-accepted level, before cave_generate returns it
+   * (generate.ts, the accept branch).
+   *
+   * Return false to REJECT the level, which makes cave_generate re-roll exactly
+   * as it does for a monster-maximum overflow. May mutate the level to repair it
+   * and then return true.
+   *
+   * RNG-FREE: no rng is passed and none may be reached. A draw here shifts every
+   * subsequent draw and a seed stops reproducing its dungeon.
+   *
+   * Serves: the bug-fixes mod's reachable-staircase repair.
+   */
+  levelGenerated?: (gen: unknown, quest: boolean) => boolean;
+
+  /**
+   * An object about to be committed as an artifact, when it ALREADY carries one
+   * (obj/make.ts, the `obj.artifact` branch).
+   *
+   * Return false to refuse the commit; the caller then clears the artifact and
+   * reports failure. Faithful core commits it unconditionally.
+   *
+   * RNG-FREE, for the same reason as levelGenerated: this runs inside object
+   * creation, on the main stream.
+   *
+   * Serves: the bug-fixes mod's duplicate-artifact guard (#4510).
+   */
+  artifactCommit?: (aidx: number, alreadyCreated: boolean) => boolean;
+
+  /**
+   * A character-history entry about to be written (session/game.ts and any
+   * other historyAdd call site that passes its context).
+   *
+   * Return false to suppress the entry. Faithful core writes every entry it
+   * reaches, duplicates included.
+   *
+   * Serves: the bug-fixes mod's no-duplicate-unique-kill fix (#4245).
+   */
+  historyAdd?: (entry: { readonly what: string; readonly type: number; readonly duplicate: boolean }) => boolean;
+
+  /**
+   * Whether the noise and scent heatmaps belong in the save (session/save.ts,
+   * snapshotSquares' argument).
+   *
+   * Return true to persist them. Faithful core omits them, which is the upstream
+   * behaviour and the upstream bug.
+   *
+   * Serves: the bug-fixes mod's noise/scent persistence (#4605).
+   */
+  saveNoiseScent?: () => boolean;
+
+  /**
+   * Player-visible message text, on its way to the message line (the host's
+   * message sink).
+   *
+   * Return the text to show. Faithful core shows what it was given, warts and
+   * all. A hook here can only RESTATE a message - it must never change what a
+   * message means, or the port would be showing text upstream never wrote and no
+   * census could see it.
+   *
+   * Serves: the bug-fixes mod's cosmetic string corrections.
+   */
+  messageText?: (raw: string) => string;
+}
+
+/**
+ * Fold several mods' contributions into the single ModHooks core holds.
+ *
+ * Order is LOAD order, and THE LATER MOD WINS EVERY DISAGREEMENT. That is the
+ * rule the mod manager's own row promises the player ("Move later (loads last,
+ * wins conflicts)") and the rule every other composition layer follows, so this
+ * one obeys it too - see the note below for the two folds that look like
+ * exceptions and are not.
+ *
+ *  - LAST-HANDLER hooks (walkBlockedByDiggable) are asked in REVERSE load order
+ *    and stop at the first non-null, so the last mod to have an opinion is the
+ *    one whose handling takes effect and no earlier mod can double-spend the
+ *    energy it already paid out.
+ *  - ORDERING hooks (objectListTiebreak) chain the same way round: the last
+ *    mod's comparator is the primary key and earlier ones break the ties it
+ *    leaves, which is a valid total order and is "later wins" for a comparator.
+ *  - TRANSFORM hooks (messageText) compose in load order, each seeing the
+ *    previous one's output - so the last mod still speaks last and has the final
+ *    say over the text that reaches the player.
+ *  - VETO hooks (levelGenerated, artifactCommit, historyAdd) are conjunctive:
+ *    every contributor runs and any refusal decides.
+ *  - ANY hooks (saveNoiseScent) are disjunctive: one mod asking for the data is
+ *    enough, because the data is additive and a second mod cannot object.
+ *
+ * WHY THE LAST TWO ARE NOT EXCEPTIONS. "Later wins" answers the question "two
+ * mods disagree about one thing - whose answer is used?", and a veto hook is not
+ * asking that question. `true` from historyAdd means "I have nothing to say
+ * about this entry", not "I insist it be written": the hook is called once per
+ * entry, and two mods suppressing two different things are not in conflict at
+ * all. Resolving it last-wins would mean a later mod's silence cancelled an
+ * earlier mod's rule, breaking BOTH mods to satisfy a consistency nobody asked
+ * for. Same for saveNoiseScent, where `false` is "I do not need this" and the
+ * data is additive. The consistency that matters is that no mod's opinion is
+ * ever DISCARDED in favour of an earlier one, and these two discard nothing.
+ *
+ * Returns undefined when nothing contributed, so the caller can leave the field
+ * absent rather than storing an empty object - keeping "no mod loaded" and "a
+ * mod loaded that touches nothing" indistinguishable from core's side.
+ */
+/**
+ * How composeModHooks folds several mods' contributions to one hook.
+ *
+ * A subset of the vocabulary the pack tooling uses for every composition layer
+ * (mod-sdk's `Fold`), so the host can hand these values straight to the conflict
+ * report and the compiler checks the two agree.
+ */
+export type ModHookFold =
+  | "all-must-agree" // every contributor runs; the first refusal decides
+  | "chained" // each sees the previous one's output, so the last one speaks last
+  | "last-answer" // the LAST contributor with an opinion decides; earlier ones are not asked
+  | "any-yes"; // one contributor asking for it is enough
+
+/**
+ * WHICH FOLD EACH HOOK USES, next to the function that implements it.
+ *
+ * The conflict report needs this to tell the player whether two mods touching
+ * one hook COMBINE or whether one of them is being silently ignored. Every fold
+ * here obeys "the later mod wins"; what differs is whether there is anything for
+ * a winner to win, and only `last-answer` leaves a contribution unrun. That
+ * distinction is the whole reason the report names the fold instead of printing
+ * one sentence about load order.
+ *
+ * It lives in core, beside composeModHooks, because a second copy in the host is
+ * the shape that drifts: the host is where the report is rendered, so a hook
+ * added here and forgotten there would be described by whatever the table
+ * happened to default to. Keyed by `keyof ModHooks`, so adding a member to the
+ * interface without adding it here does not compile.
+ */
+export const MOD_HOOK_FOLDS: Readonly<Record<keyof ModHooks, ModHookFold>> = {
+  walkBlockedByDiggable: "last-answer",
+  objectListTiebreak: "last-answer",
+  levelGenerated: "all-must-agree",
+  artifactCommit: "all-must-agree",
+  historyAdd: "all-must-agree",
+  saveNoiseScent: "any-yes",
+  messageText: "chained",
+};
+
+/**
+ * A mod's hook function threw. Reported to whoever guarded it (guardModHooks).
+ *
+ * Carries no mod id, because core does not know one - the host wraps ONE mod's
+ * contribution at a time and already holds the id in the closure it passes in.
+ */
+export interface ModHookFault {
+  /** Which extension point threw, by its ModHooks member name. */
+  readonly hook: keyof ModHooks;
+  /** Whatever the mod threw, unwrapped and uninterpreted. */
+  readonly error: unknown;
+}
+
+/**
+ * ONE mod's contribution, with every hook wrapped so a throw cannot escape into
+ * the middle of a turn.
+ *
+ * WHY THIS IS NOT "CATCH AND CARRY ON REGARDLESS". An uncaught throw here lands
+ * in the middle of core - halfway through a move, a generation pass or an object
+ * roll - and unwinds the rest of the turn. It does not undo what the mod already
+ * did before it threw, so the state is no LESS inconsistent for the abort; it is
+ * more, because the turn's remaining bookkeeping never ran. And it reaches the
+ * host as a bare exception from a function the host did not know a mod was
+ * inside, so the player gets a frozen screen and no name.
+ *
+ * So a throwing hook is treated as a mod that DECLINED to answer at that point,
+ * and the neutral answer is per-hook - it has to be, because "no opinion" is
+ * `true` for a veto, `null` for a handler, `0` for a comparator and the input
+ * itself for a transform. Those values live HERE, next to the fold rule in
+ * composeModHooks that already spells out each hook's kind, rather than in the
+ * host: two copies of "what does this hook mean by nothing" is the pair that
+ * drifts.
+ *
+ * WHAT THIS DOES NOT DO, deliberately: it does not make the session safe. The
+ * mod ran arbitrary code against live state and stopped partway. Neutralising
+ * the hook keeps the game on its feet long enough to say so; it is the HOST's
+ * job to treat the fault as terminal for the session - stop writing saves and
+ * tell the player to reload (packages/web/src/mod-taint.ts). A guard without
+ * that second half would be the worst outcome of the three: quietly wrong.
+ *
+ * LATCHED PER HOOK. Once a hook has thrown it is not called again for the rest
+ * of the session. A hook that throws on a bad monster will throw on the next
+ * one too, and an exception per call turns one fault into a storm of them; more
+ * importantly, "sometimes the mod's rule applies and sometimes it doesn't" is
+ * harder to reason about than "it stopped applying at the point it broke". The
+ * mod's other hooks are untouched - the latch is per (mod, hook), not per mod.
+ */
+export function guardModHooks(
+  hooks: ModHooks,
+  onFault: (fault: ModHookFault) => void,
+): ModHooks {
+  const out: ModHooks = {};
+  const stopped = new Set<keyof ModHooks>();
+
+  function guard<T>(hook: keyof ModHooks, run: () => T, neutral: T): T {
+    if (stopped.has(hook)) return neutral;
+    try {
+      return run();
+    } catch (error) {
+      stopped.add(hook);
+      onFault({ hook, error });
+      return neutral;
+    }
+  }
+
+  const walk = hooks.walkBlockedByDiggable;
+  if (walk) {
+    /* null is DECLINE, so core bumps the wall as it would with no mod loaded. */
+    out.walkBlockedByDiggable = (state, grid, deps): number | null =>
+      guard("walkBlockedByDiggable", () => walk(state, grid, deps), null);
+  }
+
+  const tiebreak = hooks.objectListTiebreak;
+  if (tiebreak) {
+    /* 0 is "still equal", which is exactly faithful core's answer. */
+    out.objectListTiebreak = (a, b): number =>
+      guard("objectListTiebreak", () => tiebreak(a, b), 0);
+  }
+
+  const level = hooks.levelGenerated;
+  if (level) {
+    /* ACCEPT. Rejecting on a throw would re-roll the level, and cave_generate
+     * would then re-roll it again on the next throw, and so on until it gives
+     * up - one broken hook would make the game unable to reach any level. */
+    out.levelGenerated = (gen, quest): boolean =>
+      guard("levelGenerated", () => level(gen, quest), true);
+  }
+
+  const artifact = hooks.artifactCommit;
+  if (artifact) {
+    /* COMMIT, which is what core does unconditionally without the hook. */
+    out.artifactCommit = (aidx, alreadyCreated): boolean =>
+      guard("artifactCommit", () => artifact(aidx, alreadyCreated), true);
+  }
+
+  const history = hooks.historyAdd;
+  if (history) {
+    /* WRITE the entry: faithful core writes every entry it reaches. Suppressing
+     * on a throw would delete history the player earned. */
+    out.historyAdd = (entry): boolean =>
+      guard("historyAdd", () => history(entry), true);
+  }
+
+  const noise = hooks.saveNoiseScent;
+  if (noise) {
+    /* OMIT them, the upstream behaviour. */
+    out.saveNoiseScent = (): boolean => guard("saveNoiseScent", () => noise(), false);
+  }
+
+  const text = hooks.messageText;
+  if (text) {
+    /* The raw message, unrestated - never an empty string, which would silently
+     * eat a message the player needed to read. */
+    out.messageText = (raw): string => guard("messageText", () => text(raw), raw);
+  }
+
+  return out;
+}
+
+export function composeModHooks(
+  contributions: readonly ModHooks[],
+): ModHooks | undefined {
+  const list = contributions.filter((c) => Object.keys(c).length > 0);
+  if (list.length === 0) return undefined;
+
+  const out: ModHooks = {};
+
+  /* REVERSE load order for both of the last-answer folds, so the mod the player
+   * moved to the bottom of the list is the one that gets asked first and
+   * therefore the one that decides. Reversed here, once, rather than by walking
+   * the array backwards at call time: the reversal is a property of the FOLD, and
+   * a `for (let i = n - 1; ...)` in the hot path is the kind of detail a later
+   * edit quietly straightens out. */
+  const walk = list.map((c) => c.walkBlockedByDiggable).filter(isFn).reverse();
+  if (walk.length > 0) {
+    out.walkBlockedByDiggable = (state, grid, deps): number | null => {
+      /* Declining is contractually free of observable effect (see the member's
+       * doc), so asking a mod that then declines costs nothing - which is what
+       * makes it safe to ask them in any order at all. */
+      for (const fn of walk) {
+        const energy = fn(state, grid, deps);
+        if (energy !== null) return energy;
+      }
+      return null;
+    };
+  }
+
+  const tiebreak = list.map((c) => c.objectListTiebreak).filter(isFn).reverse();
+  if (tiebreak.length > 0) {
+    out.objectListTiebreak = (a, b): number => {
+      /* The last mod's comparator is the primary sort key and the earlier ones
+       * only break the ties it leaves equal - a lexicographic chain, still a
+       * consistent total order, and "the later mod wins" for a comparator. */
+      for (const fn of tiebreak) {
+        const r = fn(a, b);
+        if (r !== 0) return r;
+      }
+      return 0;
+    };
+  }
+
+  const level = list.map((c) => c.levelGenerated).filter(isFn);
+  if (level.length > 0) {
+    out.levelGenerated = (gen, quest): boolean => {
+      /* Every contributor runs even after one has repaired the level, because a
+       * second mod's invariant is not satisfied by the first mod's repair. The
+       * first REFUSAL short-circuits, since the level is being thrown away. */
+      for (const fn of level) if (!fn(gen, quest)) return false;
+      return true;
+    };
+  }
+
+  const artifact = list.map((c) => c.artifactCommit).filter(isFn);
+  if (artifact.length > 0) {
+    out.artifactCommit = (aidx, alreadyCreated): boolean => {
+      for (const fn of artifact) if (!fn(aidx, alreadyCreated)) return false;
+      return true;
+    };
+  }
+
+  const history = list.map((c) => c.historyAdd).filter(isFn);
+  if (history.length > 0) {
+    out.historyAdd = (entry): boolean => {
+      for (const fn of history) if (!fn(entry)) return false;
+      return true;
+    };
+  }
+
+  const noise = list.map((c) => c.saveNoiseScent).filter(isFn);
+  if (noise.length > 0) {
+    out.saveNoiseScent = (): boolean => noise.some((fn) => fn());
+  }
+
+  const text = list.map((c) => c.messageText).filter(isFn);
+  if (text.length > 0) {
+    out.messageText = (raw): string => text.reduce((s, fn) => fn(s), raw);
+  }
+
+  return out;
+}
+
+function isFn<T>(v: T | undefined): v is T {
+  return typeof v === "function";
+}

package/src/version.ts

@@ -23,4 +23,4 @@ export const PARITY_BASELINE = "4.2.6";
  * released tag is iterated takes a MINOR bump, because a published tag is pinned
  * by digest in a catalogue and must never be moved.
  */
-export const ENGINE_VERSION = "0.12.0";
+export const ENGINE_VERSION = "0.14.0";