holonovel 2026.8.22

package/dist/rulesets.js

@@ -0,0 +1,212 @@
+// Ruleset package manager — declarative ruleset packages (REQ-389, REQ-390).
+//
+// A ruleset package is a self-contained declarative artifact in the install
+// directory (REQ-389): six JSON files — manifest.json, index.json, model.json,
+// tools.json, resources.json, prompts.json. The host loads a package without
+// reading or re-parsing ruleset Markdown source, using only the prebuilt index
+// and model the package ships.
+import * as fs from "fs";
+import * as path from "path";
+import * as crypto from "crypto";
+import { createRng, sessionRoll } from "./core/rng.js";
+export const HOST_VERSION = "2026.08.18";
+// The content hash covers the canonical JSON of the five content files,
+// concatenated in this fixed order (REQ-389). "Canonical" is minified JSON
+// with the properties serialized exactly as they appear in the source object.
+export function computeContentHash(index, model, tools, resources, prompts) {
+    const canonical = (obj) => JSON.stringify(JSON.parse(JSON.stringify(obj)));
+    const h = crypto.createHash("sha256");
+    for (const obj of [index, model, tools, resources, prompts]) {
+        h.update(canonical(obj));
+    }
+    return h.digest("hex");
+}
+// NdM[+|-X] dice parser. Returns total, per-die results, and modifier.
+// Accepts an optional seed for a deterministic isolated draw (REQ-050).
+export function rollDice(notation, seed) {
+    const m = String(notation).trim().match(/^(\d+)d(\d+)(?:([+-])(\d+))?$/i);
+    if (!m) {
+        throw new Error(`Invalid dice notation '${notation}'. Use NdM, e.g. 1d20, 3d6, 4d6+2.`);
+    }
+    const count = parseInt(m[1], 10);
+    const sides = parseInt(m[2], 10);
+    if (count < 1 || count > 1000 || sides < 2 || sides > 100000) {
+        throw new Error(`Dice notation '${notation}' out of range.`);
+    }
+    const dice = [];
+    if (seed !== undefined) {
+        const rng = createRng(seed);
+        for (let i = 0; i < count; i++)
+            dice.push(rng.roll(sides));
+    }
+    else {
+        for (let i = 0; i < count; i++)
+            dice.push(sessionRoll(sides));
+    }
+    const sign = m[3] === "-" ? -1 : 1;
+    const modifier = m[4] ? sign * parseInt(m[4], 10) : 0;
+    const total = dice.reduce((a, b) => a + b, 0) + modifier;
+    return { total, dice, modifier, notation: notation.trim() };
+}
+export class RulesetManager {
+    installDir;
+    hostVersion;
+    installed = new Map();
+    hydrated = new Map();
+    constructor(installDir, hostVersion = HOST_VERSION) {
+        this.installDir = installDir;
+        this.hostVersion = hostVersion;
+    }
+    // Scan the install directory and record installed package metadata, WITHOUT
+    // loading index/model (lazy hydration — REQ-390). Returns an array of
+    // per-slug validation errors (empty means clean).
+    scan() {
+        this.installed.clear();
+        const errors = [];
+        if (!fs.existsSync(this.installDir))
+            return errors;
+        const entries = fs.readdirSync(this.installDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const slug = entry.name;
+            const manifestPath = path.join(this.installDir, slug, "manifest.json");
+            if (!fs.existsSync(manifestPath)) {
+                errors.push(`${slug}: missing manifest.json`);
+                continue;
+            }
+            try {
+                const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+                if (manifest.slug !== slug) {
+                    errors.push(`${slug}: manifest slug mismatch ('${manifest.slug}')`);
+                    continue;
+                }
+                if (manifest.host_version !== this.hostVersion) {
+                    errors.push(`${slug}: incompatible host_version '${manifest.host_version}' (expected '${this.hostVersion}')`);
+                    continue;
+                }
+                this.installed.set(slug, manifest);
+            }
+            catch (e) {
+                errors.push(`${slug}: unreadable manifest — ${e.message}`);
+            }
+        }
+        return errors;
+    }
+    installedSlugs() {
+        return [...this.installed.keys()];
+    }
+    isInstalled(slug) {
+        return this.installed.has(slug);
+    }
+    isHydrated(slug) {
+        return this.hydrated.has(slug);
+    }
+    prefixMap() {
+        const map = {};
+        for (const slug of this.installed.keys())
+            map[slug] = slug;
+        return map;
+    }
+    // Load a package fully (index + model + tools + resources + prompts) after
+    // validating its content hash against the host algorithm. Returns the loaded
+    // package, cached for subsequent calls.
+    hydrate(slug) {
+        if (this.hydrated.has(slug))
+            return this.hydrated.get(slug);
+        const manifest = this.installed.get(slug);
+        if (!manifest) {
+            throw new Error(`Ruleset '${slug}' is not installed.`);
+        }
+        const dir = path.join(this.installDir, slug);
+        const read = (name) => {
+            const p = path.join(dir, name);
+            if (!fs.existsSync(p))
+                throw new Error(`Ruleset '${slug}' is missing ${name}.`);
+            return JSON.parse(fs.readFileSync(p, "utf-8"));
+        };
+        const index = read("index.json");
+        const model = read("model.json");
+        const tools = read("tools.json");
+        const resources = read("resources.json");
+        const prompts = read("prompts.json");
+        const hash = computeContentHash(index, model, tools, resources, prompts);
+        if (hash !== manifest.content_hash) {
+            throw new Error(`Ruleset '${slug}' content hash mismatch. Expected ${manifest.content_hash}, received ${hash}.`);
+        }
+        const pkg = { slug, manifest, index, model, tools, resources, prompts };
+        this.hydrated.set(slug, pkg);
+        return pkg;
+    }
+    toolSchemas(slug) {
+        const pkg = this.hydrate(slug);
+        return pkg.tools;
+    }
+    // Full-text search over the hydrated index. Simple normalized substring
+    // scoring across id/anchor/content/category.
+    search(slug, query, maxResults = 10) {
+        const pkg = this.hydrate(slug);
+        const q = query.trim().toLowerCase();
+        if (!q)
+            return pkg.index.slice(0, maxResults);
+        const scored = [];
+        for (const entry of pkg.index) {
+            const hay = `${entry.id} ${entry.anchor} ${entry.category} ${entry.content}`.toLowerCase();
+            let score = 0;
+            if (hay.includes(q))
+                score += 10;
+            for (const term of q.split(/\s+/)) {
+                if (term && hay.includes(term))
+                    score += 2;
+            }
+            if (entry.id.includes(q) || entry.anchor.toLowerCase().includes(q))
+                score += 5;
+            if (score > 0)
+                scored.push({ entry, score });
+        }
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, maxResults).map((s) => s.entry);
+    }
+    // Install a package bundle (the six files) under the install dir, validating
+    // slug uniqueness, host-version compatibility, and content-hash integrity.
+    installPackage(slug, files) {
+        if (this.installed.has(slug)) {
+            throw new Error(`[STATE_CONFLICT] Ruleset '${slug}' is already installed.`);
+        }
+        const manifest = files.manifest;
+        if (!manifest || manifest.slug !== slug) {
+            throw new Error(`[INVALID_INPUT] manifest.slug must equal '${slug}'.`);
+        }
+        if (manifest.host_version !== this.hostVersion) {
+            throw new Error(`[INVALID_INPUT] incompatible host_version '${manifest.host_version}' (expected '${this.hostVersion}').`);
+        }
+        const hash = computeContentHash(files.index ?? [], files.model ?? {}, files.tools ?? [], files.resources ?? [], files.prompts ?? []);
+        if (hash !== manifest.content_hash) {
+            throw new Error(`[INVALID_INPUT] content hash mismatch. Expected ${manifest.content_hash}, received ${hash}.`);
+        }
+        const dir = path.join(this.installDir, slug);
+        fs.mkdirSync(dir, { recursive: true });
+        for (const [name, obj] of Object.entries({
+            "manifest.json": files.manifest,
+            "index.json": files.index ?? [],
+            "model.json": files.model ?? {},
+            "tools.json": files.tools ?? [],
+            "resources.json": files.resources ?? [],
+            "prompts.json": files.prompts ?? [],
+        })) {
+            fs.writeFileSync(path.join(dir, name), JSON.stringify(obj, null, 2) + "\n");
+        }
+        this.scan();
+        return this.hydrate(slug);
+    }
+    removePackage(slug) {
+        if (!this.installed.has(slug)) {
+            throw new Error(`[STATE_CONFLICT] Ruleset '${slug}' is not installed.`);
+        }
+        const dir = path.join(this.installDir, slug);
+        fs.rmSync(dir, { recursive: true, force: true });
+        this.installed.delete(slug);
+        this.hydrated.delete(slug);
+    }
+}
+//# sourceMappingURL=rulesets.js.map

package/dist/rulesets.js.map

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

package/dist/world/index.d.ts

@@ -0,0 +1,4 @@
+export { WORLD_MODEL_KINDS, ROOM_DIRECTIONS, oppositeDirection, createEmptyWorldModel, convertSource, worldMap, worldKinds, BASE_PARSER_COMMANDS, resolveThingName, resolveThingInInventory, } from "./model.js";
+export type { WorldKind, Direction, WorldModel, WorldRoom, WorldThing, } from "./model.js";
+export { dispatchCommand, resolveGoMovement } from "./parser.js";
+export type { ParserContext, ParserResult } from "./parser.js";

package/dist/world/index.js

@@ -0,0 +1,3 @@
+export { WORLD_MODEL_KINDS, ROOM_DIRECTIONS, oppositeDirection, createEmptyWorldModel, convertSource, worldMap, worldKinds, BASE_PARSER_COMMANDS, resolveThingName, resolveThingInInventory, } from "./model.js";
+export { dispatchCommand, resolveGoMovement } from "./parser.js";
+//# sourceMappingURL=index.js.map

package/dist/world/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/world/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,QAAQ,EACR,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/world/model.d.ts

@@ -0,0 +1,125 @@
+export declare const WORLD_MODEL_KINDS: {
+    readonly thing: {
+        readonly parent: null;
+        readonly description: "A physical object in the world.";
+    };
+    readonly container: {
+        readonly parent: "thing";
+        readonly description: "A thing that can hold other things. Portable by default. When closed, contents are blocked.";
+    };
+    readonly supporter: {
+        readonly parent: "thing";
+        readonly description: "A thing that other things can rest on. Fixed by default.";
+    };
+    readonly door: {
+        readonly parent: "thing";
+        readonly description: "A thing that connects two rooms and may be opened or closed. Blocks passage when closed. Lockable.";
+    };
+    readonly device: {
+        readonly parent: "thing";
+        readonly description: "A thing that can be switched on or off. Portable by default.";
+    };
+    readonly vehicle: {
+        readonly parent: "thing";
+        readonly description: "An enterable thing with a virtual interior room. Moves between rooms. Fixed by default.";
+    };
+    readonly person: {
+        readonly parent: "thing";
+        readonly description: "An animate being. Visible and examinable in rooms.";
+    };
+    readonly backdrop: {
+        readonly parent: "thing";
+        readonly description: "A thing present in multiple rooms; scenery-level.";
+    };
+    readonly region: {
+        readonly parent: null;
+        readonly description: "A named area spanning multiple rooms.";
+    };
+};
+export type WorldKind = keyof typeof WORLD_MODEL_KINDS;
+export declare const ROOM_DIRECTIONS: readonly ["north", "south", "east", "west", "northeast", "northwest", "southeast", "southwest", "up", "down", "in", "out"];
+export type Direction = (typeof ROOM_DIRECTIONS)[number];
+export declare function oppositeDirection(dir: Direction): Direction;
+export interface WorldThing {
+    name: string;
+    description: string;
+    kind: WorldKind;
+    location: string | null;
+    locationType: "room" | "container" | "supporter" | "vehicle" | null;
+    portable: boolean;
+    openable: boolean;
+    open: boolean;
+    lockable: boolean;
+    locked: boolean;
+    lit: boolean;
+    capacity?: number;
+    doorConnects?: {
+        roomA: string;
+        roomB: string;
+    };
+    switchable: boolean;
+    switched_on: boolean;
+    enterable: boolean;
+    vehicleInterior?: string;
+    vehiclePassengers: string[];
+    wearable: boolean;
+    worn_by: string | null;
+    readable: boolean;
+    read_text: string | null;
+    edible: boolean;
+    drinkable: boolean;
+    climbable: boolean;
+    transparent: boolean;
+    annotations: {
+        encounter?: string;
+        trap?: string;
+        npc?: string;
+        lore?: string;
+    };
+}
+export interface WorldRoom {
+    name: string;
+    description: string;
+    exits: Map<string, string>;
+    doorRefs: Map<string, string>;
+    annotations: {
+        encounter?: string;
+        trap?: string;
+        npc?: string;
+        lore?: string;
+    };
+}
+export interface WorldModel {
+    rooms: Map<string, WorldRoom>;
+    things: Map<string, WorldThing>;
+}
+export declare function createEmptyWorldModel(): WorldModel;
+export declare const BASE_PARSER_COMMANDS: {
+    verb: string;
+    category: string;
+    args: string[];
+}[];
+export declare function resolveThingName(input: string, thingsInRoom: WorldThing[], inventory: string[]): WorldThing[];
+export declare function resolveThingInInventory(input: string, heldThings: WorldThing[]): WorldThing[];
+export interface ConvertResult {
+    rooms: number;
+    things: number;
+    exits: number;
+    annotations: {
+        encounters: number;
+        npcs: number;
+        traps: number;
+        lore: number;
+    };
+    warnings: {
+        line: number;
+        pattern: string;
+        message: string;
+    }[];
+}
+export declare function convertSource(source: string, existingWorld: WorldModel): {
+    world: WorldModel;
+    result: ConvertResult;
+};
+export declare function worldMap(world: WorldModel): string;
+export declare function worldKinds(): string;