@maka/maka-cli 5.63.1 → 5.65.0

package/bundle/typescript/src/commands/game/sideQuest/models/device.js

@@ -0,0 +1,145 @@
+import { matchesCredential } from '../utilities/credentials.js';
+import { AFFORDANCE_FLAVOR, verbsFor } from '../utilities/affordances.js';
+import { hint } from '../utilities/hints.js';
+/**
+ * A DEVICE: a thing in a room that is shut and can be opened.
+ *
+ * The replacement for Puzzle, and the difference is not cosmetic. A
+ * puzzle was a riddle wearing the costume of an object -- it had an
+ * answer, a prerequisite, a "solved" flag and a burnable shortcut, and
+ * the fiction had to be bent around that shape. A device is an OBJECT
+ * with an interface, and the verbs that work it are the ones that would
+ * work the real thing. The user's framing is the whole specification:
+ * "A lock is not a puzzle, it has a key. A keypad has an interface (to
+ * use). An NPC in the doorway can be persuaded/bluffed/conned to move
+ * aside. A persistent forcewall can be dispelled."
+ *
+ * A DEVICE IS ALWAYS ROOM-OWNED. There is no Device hanging off a Door,
+ * because a keypad beside a grate physically stands in ONE room -- the
+ * one you have to be standing in to reach it. Puzzles could be attached
+ * to a door OR placed in a room, which meant every consumer had to
+ * handle both, two validators had to agree about it, and a normaliser
+ * had to reconcile them; the comments record that fault family killing
+ * two consecutive generations. Being in a room is not a special case
+ * here, it is the only case.
+ *
+ * STATE IS EXACTLY ONE FIELD: `open`. Not solved-and-burned-and-locked;
+ * a thing is shut or it isn't. Everything else -- whether you may try,
+ * what it says when you get it wrong, what opening it does -- is
+ * derived from the kind and the config.
+ *
+ * A CODE ONLY BELONGS ON A PANEL. User ruling, verbatim: "if it's a
+ * _mechanical_ lock, it has a key or can be picked. You can't talk at a
+ * _mechanical_ lock." A 'lock' therefore opens by key or by force, and
+ * a 'ward' by the Art -- neither has anything to hear a phrase with.
+ * The migration enforces this by dropping the phrase off anything that
+ * isn't a panel.
+ */
+export class Device {
+    kind;
+    name;
+    description;
+    code;
+    keyItem;
+    grantsItem;
+    atSpot;
+    opensExit;
+    openMessage;
+    refuseMessage;
+    /** The whole of this device's state. */
+    open = false;
+    constructor(config) {
+        this.kind = config.kind;
+        this.name = config.name;
+        this.description = config.description;
+        // Enforced here as well as in the migration, because a generated
+        // seed can reach this constructor directly.
+        this.code = config.kind === 'panel' ? config.code : undefined;
+        this.keyItem = config.keyItem;
+        this.grantsItem = config.grantsItem;
+        this.atSpot = config.atSpot;
+        this.opensExit = config.opensExit;
+        this.openMessage = config.openMessage || 'It opens.';
+        this.refuseMessage = config.refuseMessage || `Nothing happens.`;
+    }
+    isOpen() {
+        return this.open;
+    }
+    /** Every verb that works this device, for telling the player exactly
+     *  what they may type. */
+    verbs() {
+        return verbsFor(this.kind);
+    }
+    /**
+     * OFFER a credential or a key to this device -- the deterministic
+     * route, from solve(). Succeeds when the code matches or the right
+     * item is in hand; a device with neither can only be forced.
+     *
+     * No prerequisite branch: `requiresPuzzle` is gone. A thing that
+     * needs something else to happen first is modelled by that something
+     * else -- a door that is locked, a person in the way -- not by a
+     * device refusing on behalf of a puzzle elsewhere.
+     */
+    offer(providedAnswer, held) {
+        if (this.open) {
+            return { success: false, message: `${this.name} is already open.` };
+        }
+        const byKey = this.keyItem ? held.hasItem(this.keyItem.name) : false;
+        const byCode = matchesCredential(this.code, providedAnswer);
+        if (byKey || byCode) {
+            this.open = true;
+            return { success: true, message: this.openMessage };
+        }
+        return { success: false, message: this.refuseMessage };
+    }
+    /**
+     * MAY this device be forced by the given verb -- the gate, from
+     * checkBypassGate(). Two of that method's four refusals are gone with
+     * the concepts behind them: 'locked' (no prerequisites) and 'burned'
+     * (no one-shot shortcut; a lock you failed to pick is a lock you can
+     * try again, which is what a lock is).
+     */
+    canForce(verb) {
+        if (this.open) {
+            return { allowed: false, message: `${this.name} is already open.` };
+        }
+        if (!this.verbs().includes(verb)) {
+            return { allowed: false, message: this.wrongRouteMessage() };
+        }
+        return { allowed: true };
+    }
+    /**
+     * Apply an outcome decided elsewhere (a skill roll in the command).
+     * Assumes canForce() passed. No burn write -- failing to force a
+     * thing does not spend the thing.
+     */
+    force(succeeded) {
+        if (succeeded) {
+            this.open = true;
+            return { success: true, message: this.openMessage, alarmed: false };
+        }
+        return { success: false, message: AFFORDANCE_FLAVOR[this.kind].failureMessage, alarmed: true };
+    }
+    /**
+     * The wrong-verb answer, in this device's own fiction -- keyed on what
+     * it IS, never on what was typed.
+     */
+    wrongRouteMessage() {
+        const safeRoute = this.code
+            ? `(The code itself always works, if you turn it up: "use ${this.name.toLowerCase()} <the code>".)`
+            : this.keyItem
+                ? `(The right key opens it clean: "unlock" with ${this.keyItem.name} in hand.)`
+                : `(There's no code on this one -- force is the only way through.)`;
+        return `That finds no purchase here. ${AFFORDANCE_FLAVOR[this.kind].resists}\n${safeRoute}`;
+    }
+    /** The coaching line, behind the hints toggle. */
+    getHint() {
+        const text = hint(AFFORDANCE_FLAVOR[this.kind].hint);
+        return text.length > 0 ? text : undefined;
+    }
+    /** Persistence-only: one flag in, nothing out. */
+    restoreState(state) {
+        this.open = state.open;
+    }
+}
+//# sourceMappingURL=device.js.map

package/bundle/typescript/src/commands/game/sideQuest/models/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/models/device.ts"],"names":[],"mappings":"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"}

package/bundle/typescript/src/commands/game/sideQuest/models/door.d.ts

@@ -1,13 +1,32 @@
 import { Logger } from '../utilities/logger.js';
 import { Room } from './room.js';
-import { Puzzle } from './puzzle.js';
 import { AbstractDoor } from '../types/shared/abstracts.js';
 export interface IDoorConstructorConfig {
     roomA: Room;
     roomB: Room;
     isLocked?: boolean;
     unlockItemOrSolution?: string;
-    puzzle?: Puzzle;
+}
+/**
+ * WHICH DEVICE HOLDS THIS DOOR, and where that device stands.
+ *
+ * A Door is ONE object filed in BOTH rooms' exits maps, so a device in
+ * the chapel locks the same door a player standing in the crypt below
+ * is looking at -- with no device visible from their side. Without
+ * this, that player gets "the way up is locked" and nothing to act on:
+ * the dead-end refusal this codebase has spent four waves removing.
+ *
+ * Written ONCE, at wiring time (scene-factory step 4.9), and read by
+ * go.ts's refusal. Deliberately NOT a lookup across every room's
+ * devices at refusal time: that would be a second source of truth free
+ * to disagree with the lock itself, computed in the hot path of every
+ * failed move.
+ */
+export interface IDoorHolder {
+    /** The device's name, as the player would say it. */
+    device: string;
+    /** The room it physically stands in. */
+    room: string;
 }
 export declare class Door extends AbstractDoor {
     name: string;
@@ -15,17 +34,17 @@ export declare class Door extends AbstractDoor {
     roomB: Room;
     isLocked: boolean;
     unlockItemOrSolution?: string;
-    puzzle?: Puzzle;
+    /** Set when a Device holds this door shut -- see IDoorHolder. */
+    heldBy?: IDoorHolder;
     logger: Logger;
     isLockable: boolean;
     constructor(config: IDoorConstructorConfig);
     /**
-     * Wired in after synthesis has built every puzzle in the scene (see
-     * scene-factory.ts) -- a door's guarding puzzle may not exist yet at the
-     * point the door itself is created from "exits[]". Locks the door if it
-     * wasn't already (a puzzle-guarded door starts locked by definition).
+     * Marks this door as held by a Device, and locks it. Called once at
+     * wiring time; the back-reference is what lets a refusal on EITHER
+     * side name where the mechanism actually is.
      */
-    attachPuzzle(puzzle: Puzzle): void;
+    heldByDevice(deviceName: string, roomName: string): void;
     getOtherSide(currentRoom: Room): Room;
     getOtherSideToName(currentRoom: Room): string;
     attemptUnlock(itemOrSolution: string): boolean;

package/bundle/typescript/src/commands/game/sideQuest/models/door.js

@@ -6,7 +6,8 @@ export class Door extends AbstractDoor {
     roomB; // The other side of the door
     isLocked;
     unlockItemOrSolution;
-    puzzle;
+    /** Set when a Device holds this door shut -- see IDoorHolder. */
+    heldBy;
     logger;
     isLockable;
     constructor(config) {
@@ -14,21 +15,25 @@ export class Door extends AbstractDoor {
         this.roomA = config.roomA;
         this.roomB = config.roomB;
         this.name = `${this.roomA.name} <-> ${this.roomB.name}`;
-        this.isLocked = config.isLocked || !!config.puzzle || false;
+        // A door starts locked only if the seed says so, or if a key is
+        // required. It NO LONGER infers a locked start from carrying a
+        // puzzle -- there is no puzzle. A Device that opens this door locks
+        // it explicitly at wiring time (scene-factory step 4.9), and the
+        // golden test asserts that, because a dropped lock step fails
+        // silently: the hub's only gated content would simply stand open.
+        this.isLocked = config.isLocked || false;
         this.unlockItemOrSolution = config.unlockItemOrSolution;
-        this.puzzle = config.puzzle;
         this.logger = Logger.getInstance();
-        this.isLockable = !!config.unlockItemOrSolution || !!config.puzzle;
+        this.isLockable = !!config.unlockItemOrSolution;
         this.logger.write(`Door created between ${this.roomA.name} and ${this.roomB.name}. Is Locked: ${this.isLocked}`);
     }
     /**
-     * Wired in after synthesis has built every puzzle in the scene (see
-     * scene-factory.ts) -- a door's guarding puzzle may not exist yet at the
-     * point the door itself is created from "exits[]". Locks the door if it
-     * wasn't already (a puzzle-guarded door starts locked by definition).
+     * Marks this door as held by a Device, and locks it. Called once at
+     * wiring time; the back-reference is what lets a refusal on EITHER
+     * side name where the mechanism actually is.
      */
-    attachPuzzle(puzzle) {
-        this.puzzle = puzzle;
+    heldByDevice(deviceName, roomName) {
+        this.heldBy = { device: deviceName, room: roomName };
         this.isLocked = true;
         this.isLockable = true;
     }

package/bundle/typescript/src/commands/game/sideQuest/models/door.js.map

@@ -1 +1 @@
-{"version":3,"file":"door.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/models/door.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAIhD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAU5D,MAAM,OAAO,IAAK,SAAQ,YAAY;IACpC,IAAI,CAAS;IACb,KAAK,CAAO,CAAE,uBAAuB;IACrC,KAAK,CAAO,CAAE,6BAA6B;IAC3C,QAAQ,CAAU;IAClB,oBAAoB,CAAU;IAC9B,MAAM,CAAU;IAChB,MAAM,CAAS;IACf,UAAU,CAAS;IAEnB,YAAY,MAA8B;QACxC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC;QAC5D,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,oBAAoB,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QAEnE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,KAAK,CAAC,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,gBAAgB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnH,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,MAAc;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED,YAAY,CAAC,WAAiB;QAC5B,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAChE,CAAC;IAED,kBAAkB,CAAC,WAAiB;QAClC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1F,CAAC;IAED,aAAa,CAAC,cAAsB;QAClC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,oBAAoB,KAAK,cAAc,EAAE,CAAC;YAC/F,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,IAAI,WAAW,cAAc,EAAE,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,IAAI,CAAC,IAAI,WAAW,cAAc,EAAE,CAAC,CAAC;QAClF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"door.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/models/door.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AA+B5D,MAAM,OAAO,IAAK,SAAQ,YAAY;IACpC,IAAI,CAAS;IACb,KAAK,CAAO,CAAE,uBAAuB;IACrC,KAAK,CAAO,CAAE,6BAA6B;IAC3C,QAAQ,CAAU;IAClB,oBAAoB,CAAU;IAC9B,iEAAiE;IACjE,MAAM,CAAe;IACrB,MAAM,CAAS;IACf,UAAU,CAAS;IAEnB,YAAY,MAA8B;QACxC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACxD,gEAAgE;QAChE,+DAA+D;QAC/D,oEAAoE;QACpE,iEAAiE;QACjE,8DAA8D;QAC9D,kEAAkE;QAClE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC;QACzC,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC;QAEhD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,KAAK,CAAC,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,gBAAgB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnH,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,UAAkB,EAAE,QAAgB;QAC/C,IAAI,CAAC,MAAM,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED,YAAY,CAAC,WAAiB;QAC5B,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAChE,CAAC;IAED,kBAAkB,CAAC,WAAiB;QAClC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1F,CAAC;IAED,aAAa,CAAC,cAAsB;QAClC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,oBAAoB,KAAK,cAAc,EAAE,CAAC;YAC/F,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,IAAI,WAAW,cAAc,EAAE,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,IAAI,CAAC,IAAI,WAAW,cAAc,EAAE,CAAC,CAAC;QAClF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/bundle/typescript/src/commands/game/sideQuest/models/npc.d.ts

@@ -8,6 +8,87 @@ export interface INPCConstructorConfig {
     description: string;
     playerConstructorConfig: IPlayerConstructorConfig;
 }
+/**
+ * One barrier as the prompt needs to see it.
+ *
+ * STRUCTURAL on purpose, and that is the entire reason this interface
+ * exists rather than the functions below taking a `Puzzle`. The
+ * puzzle/solve mechanic is being replaced by a `Device` model, and these
+ * two functions are the last thing standing between an NPC and inventing
+ * a door code. Typing them over a SHAPE rather than a class means the
+ * type swap is a change of adapter at one call site, with these
+ * functions and their tests untouched -- so "the rewrite preserved the
+ * behaviour" becomes something the suite proves rather than something we
+ * hope.
+ *
+ * `description` is optional and interpolated raw, which preserves an
+ * existing wart exactly: a barrier with no description renders the
+ * literal string "undefined" into the prompt today. Recorded rather than
+ * fixed, because this extraction is behaviour-preserving by contract and
+ * a silent improvement here would make the swap unprovable.
+ *
+ * `sealingDirection` is a plain string so this pair depends on nothing:
+ * a `Direction` is assignable to it, and the functions stay importable
+ * from anywhere.
+ */
+export interface IBarrierPost {
+    name: string;
+    /**
+     * MANDATORY, as of the Device flip. It was optional while Puzzle fed
+     * this interface (a riddle genuinely could be absent), and the cost
+     * was that barrierPostNote interpolated it raw and rendered the
+     * literal string "undefined" into an NPC's prompt. Device cannot be
+     * constructed without a description, so that branch is DEAD rather
+     * than guarded -- a deletion, not a fix.
+     */
+    description: string;
+    /** The credential that opens it. Absent means even its keeper doesn't know. */
+    code?: string;
+    /**
+     * The item that opens it outright, if one exists. Present ONLY so the
+     * brief can stop asserting "no key" about a lock that takes exactly
+     * one key -- see the note in barrierPostNote. A plain string, like
+     * sealingDirection, so this pair keeps depending on nothing.
+     */
+    keyItem?: string;
+    open: boolean;
+    /** Set only when this barrier seals an EXIT rather than sitting in the room. */
+    sealingDirection?: string;
+}
+/**
+ * BARRIERS AT YOUR POST (a real session: a beaten sentry announced he
+ * was "unlocking" a spell-sealed hatch he could never open -- his AI had
+ * no idea what guarded his own door, tried a doomed "unlock", and
+ * claimed success). An NPC standing at a barrier knows what seals it,
+ * that he cannot wish it open, and HOW it opens -- as a guarded secret,
+ * so coercion and bribery become a real path to the pass.
+ *
+ * The CALLER decides whose barriers these are. Companions get an empty
+ * list: a bound spirit that knew the code would simply hand it to its
+ * master and skip the barrier entirely.
+ *
+ * Exported and pure for the reason the note below is: it fails SILENTLY.
+ * Nothing throws when this stops handing over the real pass -- the NPC
+ * just starts inventing one, and the only detector is a player three
+ * rooms away typing a code that was never real.
+ */
+export declare function barrierPostNote(barriers: IBarrierPost[]): string;
+/**
+ * How many real credentials this NPC was actually handed -- the number
+ * credentialHonestyNote turns into "you know the pass for the barrier at
+ * your own post, and NO others" versus "you hold NONE".
+ *
+ * A barrier only counts if it is SHUT and has a code. An open one is
+ * nothing to guard, and one with no code is a secret its own keeper
+ * doesn't have.
+ *
+ * It counts DEVICES only. A guard once carried a passphrase of their
+ * own and it was counted here; the user removed the concept
+ * (2026-08-27) because the way past a person is social or violent, and
+ * because a guard's phrase had no clue guarantee behind it -- see the
+ * note where Player.passphrase used to be.
+ */
+export declare function passesHeldBy(barriers: IBarrierPost[]): number;
 /**
  * THE CAST PIN -- geographySummary's missing twin. See the note at its
  * call site in respondTo(). Exported and PURE for the same reason as
@@ -30,6 +111,68 @@ export declare function castPin(names: string[]): string;
  * notice.
  */
 export declare function credentialHonestyNote(passesHeld: number): string;
+/**
+ * WHAT YOU KNOW ENDS AT THIS ROOM -- audit findings #9 and #10, the last
+ * two unpinned facts from the credential sweep, and the same shape as
+ * the credential hole: pinned for the NPC's own room, invented for
+ * anywhere else.
+ *
+ *   #9  an NPC asked where something is names a REAL room the item is
+ *       not in. Real, because geography is pinned -- which makes it
+ *       worse, not better. A vague answer costs a player nothing; a
+ *       plausible, checkable, wrong one costs them the walk there, the
+ *       search, and their trust in the next true thing they hear.
+ *   #10 an NPC asked what a door ELSEWHERE needs invents a requirement.
+ *       They only ever see their own room's exits.
+ *
+ * Deliberately NOT an index of the world's items and doors: that would
+ * spoil the game and cost prompt budget to do it. Pin what the NPC can
+ * legitimately know, deny the rest, index nothing.
+ *
+ * The scoping matters and is the whole difficulty. An NPC absolutely may
+ * say where things are when they were TOLD -- the client's briefing, the
+ * legwork facts ask.ts hands over, their own scripted talking points are
+ * all real knowledge, engine-supplied, and a blanket denial would gag
+ * the Johnson mid-brief. What is banned is GUESSING TO BE HELPFUL, which
+ * is the specific thing a model does when it has no answer and wants to
+ * give one.
+ */
+export declare function localKnowledgeNote(roomName?: string): string;
+/**
+ * OUT-OF-CHARACTER LEAKAGE on the exposition channel.
+ *
+ * Playtest 2026-08-27 (Sherry): "The response from Mr. Krow was OOC" --
+ * Krow answered in the game's own voice instead of in his.
+ *
+ * This is the SAME SEAM as splitSpokenLines, one layer up, and widening
+ * it was the right move rather than building a second mechanism. The
+ * exposition channel is the only place a model's non-fiction voice can
+ * reach the screen: `say` lines are attributed dialogue and [COMMAND]
+ * lines are parsed, so anything that is neither prints as narration in
+ * narration blue. A filter for exactly this already existed and was
+ * built from ONE report -- the first-person director ("I'll have Deacon
+ * Ruy stay guarded but crack slightly under the pressure...") -- so it
+ * only ever matched that one shape.
+ *
+ * The shapes it missed are the ordinary ones: the assistant preamble
+ * ("Certainly! Here's how he responds"), the frame ("As Mr. Krow, I'd
+ * say..."), the explicit marker ("OOC:", "Note:"), and talk about the
+ * player rather than to them ("The player is trying to...").
+ *
+ * SUPPRESSED, not restyled. The player also asked for OOC to be visibly
+ * distinct from fiction, and that is a real and separate feature -- but
+ * "Certainly! Here's what he'd say" is not out-of-character INFORMATION,
+ * it is the model failing to stay in the fiction, and there is nothing
+ * in it worth showing in any colour. The genuine OOC channels
+ * (logger.meta for mechanics, hint() for coaching) already exist and are
+ * already visibly distinct; routing leakage into them would fill the
+ * player's straight-talk channel with noise.
+ *
+ * Exported and PURE because it fails silently in the usual way: nothing
+ * throws when a pattern stops matching, the line just prints, and the
+ * only detector is a player watching their fixer break character.
+ */
+export declare function isOutOfCharacter(line: string, npcName?: string): boolean;
 /**
  * SPEECH REPAIR: turns a model reply's raw lines into lines the
  * classifier below can actually read. Exported and PURE so the rules