holonovel 2026.8.22

package/dist/core/enrichment.js

@@ -0,0 +1,269 @@
+// Enrichment Manifest — Tier 1 vendor + ruleset-native enrichment
+// REQ-080: additive only, never modifies mechanics
+// REQ-225: Tier 1 enrichment — vendor content processed at build time
+// REQ-227: Tier 1 (ruleset-native + vendor, never removed by revert_synthesis)
+import * as fs from "fs";
+const SPEC_VERSION = JSON.parse(fs.readFileSync(new URL("../../package.json", import.meta.url), "utf-8")).version;
+export const DEFAULT_ENRICHMENT = {
+    collected_at: new Date().toISOString(),
+    spec_version: SPEC_VERSION,
+    voice_examples: [
+        {
+            content: "NPC voice design framework — define pitch, speed, tone, accent, and quirks for each named NPC. Use descriptive voice tags ('raspy baritone', 'clipped military cadence') rather than acting instructions. Voice descriptions should suggest character history: a hoarse whisper implies decades of secrets, a booming laugh implies untested confidence.",
+            source_url: "narrative_world_model/narrative/dmcp/README.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+        },
+    ],
+    briefing_order: {
+        sections: ["scene", "active_threads", "immediate_situation", "entity_states", "lore_triggered", "pending_decisions", "guidance"],
+        reason: "Prioritize actionable narrative state over reference content — scene first, then thread urgency, then immediate player-facing situation, then entity states and triggered memories, then pending decisions the GM flagged, then guidance",
+        source_url: "narrative_world_model/narrative/dmcp/README.md",
+        confidence: "HIGH",
+    },
+    lore_templates: [
+        {
+            content: "Worldbuilding seed — a location, faction, or event that shapes the setting. Three known facts, one secret, one rumor. NPCs who know each. A clock tracking how soon it becomes relevant.",
+            source_url: "narrative_world_model/narrative/if-craft-corpus/README.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "worldbuilding",
+        },
+        {
+            content: "Faction relationship network — for each faction, record allies, rivals, neutral parties, and a hidden agenda. When a faction takes action, ripple effects propagate through the relationship graph.",
+            source_url: "narrative_world_model/narrative/dmcp/README.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "faction_network",
+        },
+        {
+            content: "Kind hierarchy design — the world model classifies everything under 'thing', subdivided into kinds: container (openable, lockable), supporter (sit/stand), door (connects rooms), device (switched on/off), vehicle (enterable, mobile), person (NPCs), backdrop (scenery), region (spatial grouping). Each kind carries mechanical contracts: a container holds inventory, a door blocks passage when closed, a device changes state, a vehicle has an interior that functions as a contained space. Choose the kind that matches the object's behavior, not just its name.",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "kind_hierarchy",
+        },
+        {
+            content: "Device world design — devices are the simplest form of machine: always in one of two states, switched on or switched off. Use devices where binary state changes the fiction: a powered generator changes what's visible, an active alarm changes who's present, a running machine changes the environment turn by turn. The device's state is separate from its description — switching it changes the fiction without changing the object. Design puzzles where device states cascade: switching one changes what another does.",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "device_world_design",
+        },
+        {
+            content: "Vehicles as world fragments — a vehicle is a mobile room container. Its interior is a sub-world with its own contents and exits. Boarding a vehicle changes what the player can see, touch, and interact with. Exits from a vehicle interior connect to the outside world when the vehicle is stationary. Design vehicles as story engines: a ship's crew quarters, an elevator's single-button control, a train's dining car filling with water. The vehicle is never just transport — it's a location that moves.",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "vehicle_world_design",
+        },
+        {
+            content: "Environmental text storytelling — readable objects deliver exposition through discovery, not narration. A readable inscription on a wall, a diary entry in a drawer, a warning carved into a doorframe — each tells the player something the world's past occupants chose to record. The read_text property holds discoverable text; the description property holds immediately visible text. Use the gap: a readable object that says one thing while its description shows another creates tension (a cheerful sign on a crumbling wall, a locked diary with a bookmark at a crucial entry).",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "environmental_text",
+        },
+    ],
+    action_patterns: [
+        {
+            intent: "present structured choices to the player",
+            expected_categories: ["Command"],
+            ruleset_section: "Guidance — DMCP player interaction",
+            source_url: "narrative_world_model/narrative/dmcp/README.md",
+        },
+        {
+            intent: "manage combat with initiative, conditions, and turn order",
+            expected_categories: ["Resolution", "Command"],
+            ruleset_section: "Guidance — DMCP combat management",
+            source_url: "narrative_world_model/narrative/dmcp/README.md",
+        },
+        {
+            intent: "interact with world objects using parser commands",
+            expected_categories: ["Command"],
+            ruleset_section: "World Model — parser command dispatch (REQ-319)",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+        },
+        {
+            intent: "turn devices and machines on or off",
+            expected_categories: ["Command"],
+            ruleset_section: "World Model — device kind (REQ-316)",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+        },
+        {
+            intent: "enter, exit, or navigate aboard a vehicle",
+            expected_categories: ["Command"],
+            ruleset_section: "World Model — vehicle kind (REQ-317)",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+        },
+        {
+            intent: "wear, remove, eat, drink, or climb an object",
+            expected_categories: ["Command"],
+            ruleset_section: "World Model — extended property commands (REQ-318)",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+        },
+        {
+            intent: "read text or inspect readable objects",
+            expected_categories: ["Command"],
+            ruleset_section: "World Model — readable property (REQ-318)",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+        },
+        {
+            intent: "ask, tell, give, show, or throw something at an NPC",
+            expected_categories: ["Command"],
+            ruleset_section: "World Model — narrative-intent verbs (REQ-320)",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+        },
+    ],
+    supplementary_guidance: [
+        {
+            content: "Separate mechanics from fiction at the table. Track dice rolls, modifiers, and system resolution on one axis; track narrative outcomes, character reactions, and scene evolution on another. Both coexist without blurring — the Lonelog notation model (action → roll → outcome → oracle).",
+            source_url: "narrative_world_model/narrative/lonelog/lonelog.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "session_notation",
+        },
+        {
+            content: "Before ending a session, capture pause context: current scene description, immediate situation, scene atmosphere, pending player action, short-term GM plans, long-term GM plans, active threads with urgency, NPC attitude snapshots, and player apparent goals. This context enables seamless resumption.",
+            source_url: "narrative_world_model/narrative/dmcp/README.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "session_management",
+        },
+        {
+            content: "Use clocks to track progressive tension — for dangers approaching (alert level, pursuit proximity), races against time (escape vs capture), linked multi-phase obstacles (defense then vulnerability), faction projects ticking forward during downtime, and tug-of-war situations where events can fill or empty the clock.",
+            source_url: "narrative_world_model/narrative/bitd/progress-clocks.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "clock_design",
+        },
+        {
+            content: "Parser command tier system — the world-model parser organizes commands into four tiers. Core (go, look, examine, take, drop, inventory, wait, open, close, unlock, lock) covers fundamental interaction every player needs. Standard (wear, remove, eat, drink, climb, enter, exit, switch on, switch off, sit, stand, push, pull, light, extinguish, listen, smell, touch, insert, read) extends to object properties and sensory verbs. Narrative (ask, tell, give, show, throw) covers NPC-directed social verbs that route to the GM surface. Meta (again, g, help, verbs) covers parser-level operations. Unknown commands fall through to the GM for narrative interpretation — the parser is a floor, not a ceiling.",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "parser_tiers",
+        },
+        {
+            content: "Device interaction patterns — devices work at the fiction level, not the mechanics level. Switching a device on or off changes what the world describes, not what dice resolve. Design device puzzles around observation: a player who understands what each device controls can solve the puzzle without a skill check. Group devices by effect domain — the lighting devices, the access devices, the alarm devices — so patterns are discoverable. A device whose effect is remote (switching it changes something in another room) creates exploration incentives.",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "device_patterns",
+        },
+        {
+            content: "Vehicle design for interactive worlds — treat a vehicle's interior as a room with dynamic exits. The exits from a vehicle change with context: boarding creates 'out' exits to the embarkation point, docking creates exits to the dock, crash-landing creates exits to the crash site. Design vehicle events as environmental changes — a flood filling a compartment, a fire spreading through a hold, a hull breach exposing a room to vacuum. Passengers act independently: NPCs aboard a vehicle may pilot, repair, guard, or panic based on their disposition and the vehicle's state.",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "vehicle_patterns",
+        },
+        {
+            content: "Extended property design patterns — wearable creates inventory slots on a character's body, not in their pack (invisible to 'take' unless removed first). Edible and drinkable are single-use, consumed on use (the object is removed after eating/drinking) — use for potions, rations, and consumable clues. Climbable associates with adjacent directional exits (a climbable rope next to an 'up' exit becomes that exit's access method). Readable separates discoverable text from visible description — a book's description is 'a leather-bound tome', its read_text is the passage the player discovers. Transparent lets players see container contents without opening — a glass display case, a jar of specimens, a window.",
+            source_url: "narrative_world_model/world/world-model-provider.md",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+            category: "extended_properties",
+        },
+    ],
+    adventure_advice: {
+        templates: [
+            {
+                content: "Open scenes in media res — place characters at a decision point that tests their values, personality, or background. The first scene should ask a question the player answers through action.",
+                source_url: "narrative_world_model/narrative/if-craft-corpus/README.md",
+                confidence: "HIGH",
+                tag: "vendor",
+                badge_scope: "game_master",
+            },
+            {
+                content: "Design obstacles, not solutions. A progress clock tracks the obstacle ('Interior Patrols', 'The Tower') — never the method ('Sneak Past the Guards'). This preserves player agency over how they overcome each challenge.",
+                source_url: "narrative_world_model/narrative/bitd/progress-clocks.md",
+                confidence: "HIGH",
+                tag: "vendor",
+                badge_scope: "game_master",
+            },
+            {
+                content: "Interactive object design principles — every object in a room should do or tell something. A lever that does nothing, a book that says nothing, a locked door with no key — these are dead ends that teach the player not to investigate. The world-model property system makes object behavior explicit: a readable object carries a discoverable text, a switchable object changes state, an edible object is consumable. Design rooms where at least one object responds to each parser tier (core, standard, narrative) — this rewards thorough investigation.",
+                source_url: "narrative_world_model/world/world-model-provider.md",
+                confidence: "HIGH",
+                tag: "vendor",
+                badge_scope: "game_master",
+            },
+            {
+                content: "Compound puzzle design — combine object kinds to create multi-step interactions. A device in a locked container behind a climbable barrier that the player must read about in a readable inscription. The player learns the solution by reading, reaches the device by climbing, opens the container by unlocking, then switches the device. Each step uses a different parser tier. Design compound puzzles so the order matters — the inscription mentions the device's location, the climbable object is only accessible after unlocking, the container's key is in another room.",
+                source_url: "narrative_world_model/world/world-model-provider.md",
+                confidence: "HIGH",
+                tag: "vendor",
+                badge_scope: "game_master",
+            },
+        ],
+        scenario_starters: [
+            {
+                content: "A faction clock reaches its final segment — the world changes independently of the players. What ripple effects reach their location? Who benefits? Who is harmed? How does the status quo shift?",
+                source_url: "narrative_world_model/narrative/bitd/progress-clocks.md",
+                confidence: "HIGH",
+                tag: "vendor",
+                badge_scope: "game_master",
+            },
+            {
+                content: "Two racing clocks — the party's objective versus an environmental or antagonist clock. Both advance with consequences. If the party's clock fills first, they succeed at a cost. If the antagonist clock fills first, the situation escalates but the party has a new angle.",
+                source_url: "narrative_world_model/narrative/bitd/progress-clocks.md",
+                confidence: "HIGH",
+                tag: "vendor",
+                badge_scope: "game_master",
+            },
+            {
+                content: "Device-based mystery — a room with three devices and no explanation of what they control. Each device changes something in a different room. The player must explore, toggle, and observe to deduce the mapping. The solution is not a correct combination — it's understanding what each device does. The puzzle teaches the player how to read the world before the real challenge begins.",
+                source_url: "narrative_world_model/world/world-model-provider.md",
+                confidence: "HIGH",
+                tag: "vendor",
+                badge_scope: "game_master",
+            },
+            {
+                content: "Vehicle journey — a multi-room vehicle with an onboard crisis. The engine room floods, the passenger cabin loses pressure, the bridge loses navigation. Players move between interiors, each with its own challenge. Exits from the vehicle change as the crisis evolves — a damaged hatch becomes an escape route, a sealed bulkhead creates a new boundary. The vehicle is both location and antagonist.",
+                source_url: "narrative_world_model/world/world-model-provider.md",
+                confidence: "HIGH",
+                tag: "vendor",
+                badge_scope: "game_master",
+            },
+        ],
+        table_expansions: [],
+    },
+    narrative_voices: [
+        {
+            name: "Horror — Atmospheric Dread",
+            source: "narrative_world_model/narrative/if-craft-corpus/README.md",
+            media_title: "IF Craft Corpus (genre-conventions cluster)",
+            media_type: "other",
+            description: "Build tension through what is withheld rather than revealed. Use environmental detail as emotional register — oppressive silence, wrong shadows, sounds that shouldn't be there. The horror is in the anticipation, not the reveal. Players fill gaps with their own fears.",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+        },
+        {
+            name: "Fiction-First — Blades in the Dark",
+            source: "narrative_world_model/narrative/bitd/progress-clocks.md",
+            media_title: "Blades in the Dark (John Harper)",
+            media_type: "game",
+            description: "Clocks reflect the fictional situation — they show speed, they don't determine it. Start from what makes sense in the story, then choose the mechanic. Obstacles are named for what they are in the world, not how the players intend to overcome them. The fiction drives the mechanics, not the reverse.",
+            confidence: "HIGH",
+            tag: "vendor",
+            badge_scope: "game_master",
+        },
+    ],
+};
+//# sourceMappingURL=enrichment.js.map

package/dist/core/enrichment.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,8 @@
+export { expandMacros } from "./macros.js";
+export type { MacroContext } from "./macros.js";
+export { StateManager, normalizeBadge, migrateNovelData } from "./state.js";
+export type { Badge, NovelState, NovelEntity, NpcState, LoreEntry, Countdown, CombatState, AuditEntry, } from "./state.js";
+export { initServer, getBadge, requireGM, requirePlayer, requireNotObserver, requireNovel, novelSnapshot, withForbiddenAudit, } from "./server.js";
+export type { ToolCtx, ToolHandler } from "./server.js";
+export { DEFAULT_ENRICHMENT } from "./enrichment.js";
+export type { EnrichmentItem, ActionPattern, EnrichmentManifest, NarrativeVoice, } from "./enrichment.js";

package/dist/core/index.js

@@ -0,0 +1,5 @@
+export { expandMacros } from "./macros.js";
+export { StateManager, normalizeBadge, migrateNovelData } from "./state.js";
+export { initServer, getBadge, requireGM, requirePlayer, requireNotObserver, requireNovel, novelSnapshot, withForbiddenAudit, } from "./server.js";
+export { DEFAULT_ENRICHMENT } from "./enrichment.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAW5E,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/macros.d.ts

@@ -0,0 +1,21 @@
+export interface MacroContext {
+    entityName?: string;
+    sceneCurrent?: string;
+    sceneLocation?: string;
+    sceneTimeOfDay?: string;
+    sceneAtmosphere?: string;
+    sceneType?: string;
+    countdowns?: Record<string, {
+        remaining: number;
+        total: number;
+        scope?: string;
+        direction?: string;
+    }>;
+    novelSlug?: string;
+    badgeActive?: string;
+    partySize?: number;
+    currentRoom?: string;
+    worldRoomCount?: number;
+    worldThingCount?: number;
+}
+export declare function expandMacros(text: string, ctx: MacroContext): string;

package/dist/core/macros.js

@@ -0,0 +1,50 @@
+// Macro expansion for {{entity.name}}, {{scene.current}}, etc.
+// REQ-085: macro tokens of the form {{<path>}}
+export function expandMacros(text, ctx) {
+    return text.replace(/\{\{([^}]+)\}\}/g, (_match, path) => {
+        const parts = path.trim().split(".");
+        if (parts[0] === "entity") {
+            if (parts[1] === "name" && ctx.entityName)
+                return ctx.entityName;
+        }
+        if (parts[0] === "scene") {
+            if (parts[1] === "current" && ctx.sceneCurrent)
+                return ctx.sceneCurrent;
+            if (parts[1] === "type" && ctx.sceneType)
+                return ctx.sceneType;
+            if (parts[1] === "location" && ctx.sceneLocation)
+                return ctx.sceneLocation;
+            if (parts[1] === "time_of_day" && ctx.sceneTimeOfDay)
+                return ctx.sceneTimeOfDay;
+            if (parts[1] === "atmosphere" && ctx.sceneAtmosphere)
+                return ctx.sceneAtmosphere;
+        }
+        if (parts[0] === "countdown") {
+            const name = parts[1];
+            if (name && ctx.countdowns?.[name]) {
+                if (parts[2] === "remaining")
+                    return String(ctx.countdowns[name].remaining);
+                if (parts[2] === "total")
+                    return String(ctx.countdowns[name].total);
+                if (parts[2] === "scope" && ctx.countdowns[name].scope)
+                    return ctx.countdowns[name].scope;
+                if (parts[2] === "direction" && ctx.countdowns[name].direction)
+                    return ctx.countdowns[name].direction;
+            }
+        }
+        if (parts[0] === "novel" && parts[1] === "slug" && ctx.novelSlug)
+            return ctx.novelSlug;
+        if (parts[0] === "badge" && parts[1] === "active" && ctx.badgeActive)
+            return ctx.badgeActive;
+        if (parts[0] === "party" && parts[1] === "size" && ctx.partySize !== undefined)
+            return String(ctx.partySize);
+        if (parts[0] === "world" && parts[1] === "room" && ctx.currentRoom)
+            return ctx.currentRoom;
+        if (parts[0] === "world" && parts[1] === "room_count" && ctx.worldRoomCount !== undefined)
+            return String(ctx.worldRoomCount);
+        if (parts[0] === "world" && parts[1] === "thing_count" && ctx.worldThingCount !== undefined)
+            return String(ctx.worldThingCount);
+        return `{{${path}}}`;
+    });
+}
+//# sourceMappingURL=macros.js.map

package/dist/core/macros.js.map

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

package/dist/core/rng.d.ts

@@ -0,0 +1,17 @@
+export interface Rng {
+    nextState(): number;
+    roll(faces: number): number;
+}
+export declare function createRng(seed: number | string): Rng;
+export declare function sessionRoll(faces: number): number;
+export interface DiceRoll {
+    dice: number[];
+    total: number;
+}
+export declare function rollWithRng(rng: Rng, count: number, sides: number, dropLowest?: number): DiceRoll;
+export declare function rollNotationWithRng(rng: Rng, notation: string): {
+    dice: number[];
+    total: number;
+    modifier: number;
+};
+export declare function roll4d6DropLowest(seed: string): number[];

package/dist/core/rng.js

@@ -0,0 +1,72 @@
+// Deterministic seeded PRNG (REQ-050).
+//
+// Reference randomizer contract (Appendix B.4):
+//   32-bit linear congruential generator
+//   state <- (state * 1664525 + 1013904223) mod 2^32
+//   initial state = parseInt(seed, 10)
+//   draw N faces = floor(next * N) + 1  where next = state / 2^32
+//
+// The session PRNG is seeded once at startup from TTRPG_SEED (default 0).
+// Per-call seeds use an ISOLATED draw: they never advance the session PRNG
+// position (REQ-050b).
+export function createRng(seed) {
+    let state = typeof seed === "number" ? seed : parseInt(String(seed), 10);
+    if (!Number.isFinite(state) || Number.isNaN(state))
+        state = 0;
+    state = state >>> 0; // keep as 32-bit unsigned
+    return {
+        nextState() {
+            // state <- (state * 1664525 + 1013904223) mod 2^32, computed in 64-bit
+            state = (Math.imul(state, 1664525) + 1013904223) >>> 0;
+            return state;
+        },
+        roll(faces) {
+            const s = this.nextState();
+            return Math.floor((s / 0x100000000) * faces) + 1;
+        },
+    };
+}
+// Session PRNG — seeded once from TTRPG_SEED (default 0). Advances with each
+// session-seeded draw. Per-call seeds construct a fresh isolated Rng instead.
+const SESSION_SEED = process.env.TTRPG_SEED ?? "0";
+const sessionRng = createRng(SESSION_SEED);
+// Log the active seed at startup (REQ-050b) so operators can verify determinism.
+console.error(`[info] PRNG seed: ${SESSION_SEED} (source: ${process.env.TTRPG_SEED ? "env" : "default"})`);
+// Session draw — advances the session PRNG position.
+export function sessionRoll(faces) {
+    return sessionRng.roll(faces);
+}
+export function rollWithRng(rng, count, sides, dropLowest = 0) {
+    const dice = [];
+    for (let i = 0; i < count; i++)
+        dice.push(rng.roll(sides));
+    if (dropLowest > 0 && dice.length >= 1) {
+        const sorted = [...dice].sort((a, b) => a - b);
+        for (let i = 0; i < dropLowest; i++) {
+            const idx = dice.indexOf(sorted[i]);
+            if (idx >= 0)
+                dice.splice(idx, 1);
+        }
+    }
+    return { dice, total: dice.reduce((a, b) => a + b, 0) };
+}
+// Roll a dice notation string like "4d6" or "3d6+2" against a given Rng.
+export function rollNotationWithRng(rng, notation) {
+    const m = String(notation).trim().match(/^(\d+)d(\d+)(?:([+-])(\d+))?$/i);
+    if (!m)
+        throw new Error(`Invalid dice notation '${notation}'.`);
+    const count = parseInt(m[1], 10);
+    const sides = parseInt(m[2], 10);
+    const res = rollWithRng(rng, count, sides);
+    const sign = m[3] === "-" ? -1 : 1;
+    const modifier = m[4] ? sign * parseInt(m[4], 10) : 0;
+    return { dice: res.dice, total: res.total + modifier, modifier };
+}
+// Deterministic 4d6 drop-lowest ability roll for stat generation (REQ-104c).
+// Uses an ISOLATED Rng so it does not advance the session PRNG position.
+export function roll4d6DropLowest(seed) {
+    const rng = createRng(seed);
+    const res = rollWithRng(rng, 4, 6, 1);
+    return res.dice;
+}
+//# sourceMappingURL=rng.js.map

package/dist/core/rng.js.map

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

package/dist/core/server.d.ts

@@ -0,0 +1,18 @@
+import { StateManager, Badge, NovelState } from "./state.js";
+export type ToolCtx = {
+    badge: Badge;
+};
+export type ToolHandler = (args: any, ctx: ToolCtx) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export declare function initServer(state: StateManager): void;
+export declare function getBadge(): Badge;
+export declare function requireGM(): void;
+export declare function requirePlayer(): void;
+export declare function requireNotObserver(): void;
+export declare function requireNovel(): NovelState;
+export declare function novelSnapshot(): void;
+export declare function withForbiddenAudit(handler: ToolHandler, toolName: string): ToolHandler;

package/dist/core/server.js

@@ -0,0 +1,40 @@
+// Core server helpers — shared MCP boilerplate for all Holonovel servers
+// Provides badge gating helpers, error prefixing, and novel/snapshot utilities.
+let _state;
+export function initServer(state) {
+    _state = state;
+}
+export function getBadge() {
+    return _state.activeNovel?.badge ?? "none";
+}
+export function requireGM() {
+    _state.requireGM(getBadge());
+}
+export function requirePlayer() {
+    _state.requirePlayer(getBadge());
+}
+export function requireNotObserver() {
+    _state.requireNotObserver(getBadge());
+}
+export function requireNovel() {
+    return _state.requireNovel();
+}
+export function novelSnapshot() {
+    const novel = _state.activeNovel;
+    if (novel)
+        _state.snapshot(novel, getBadge());
+}
+export function withForbiddenAudit(handler, toolName) {
+    return async (args, ctx) => {
+        try {
+            return await handler(args, ctx);
+        }
+        catch (e) {
+            if (e.message?.startsWith("[FORBIDDEN]")) {
+                _state.auditForbidden(ctx.badge, toolName, args);
+            }
+            throw e;
+        }
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/core/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,gFAAgF;AAUhF,IAAI,MAAoB,CAAC;AAEzB,MAAM,UAAU,UAAU,CAAC,KAAmB;IAC5C,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,CAAC,WAAW,EAAE,KAAK,IAAI,MAAM,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,YAAY,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC;IACjC,IAAI,KAAK;QAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAoB,EACpB,QAAgB;IAEhB,OAAO,KAAK,EAAE,IAAS,EAAE,GAAY,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACzC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}