rpgmaker-mz-mcp 1.0.0

package/dist/tools/validationTools.js

@@ -0,0 +1,229 @@
+import { z } from 'zod';
+import { getMap, getMapInfos, getMapEvent } from './mapTools.js';
+import { validateEvent, validateEvents } from '../validation/eventCommands.js';
+import { readJsonFile, readJsonArraySoft, getDataPath } from '../utils/fileHandler.js';
+import { checkReferences } from '../validation/references.js';
+import { checkAssets, } from '../validation/assets.js';
+import { listAssets } from './assetTools.js';
+/**
+ * Validate a single event's command lists against the known-command table.
+ * Warn-by-default: this reports problems, it never modifies anything.
+ */
+export async function validateEventTool(projectPath, mapId, eventId) {
+    const event = await getMapEvent(projectPath, mapId, eventId);
+    if (!event) {
+        throw new Error(`Event ${eventId} not found on map ${mapId}`);
+    }
+    const report = validateEvent(event);
+    return { mapId, eventId, ...report };
+}
+/**
+ * Validate the event command lists of every map in the project. Aggregates each
+ * map's warnings, tagging them with the map ID so callers can locate them.
+ */
+export async function validateProjectTool(projectPath) {
+    const infos = (await getMapInfos(projectPath));
+    const mapIds = infos.filter((info) => info != null).map((info) => info.id);
+    const warnings = [];
+    let mapsChecked = 0;
+    for (const mapId of mapIds) {
+        let map;
+        try {
+            map = await getMap(projectPath, mapId);
+        }
+        catch {
+            // A map listed in MapInfos may not have a MapNNN.json file yet; skip it.
+            continue;
+        }
+        mapsChecked++;
+        const report = validateEvents(map.events);
+        for (const warning of report.warnings) {
+            warnings.push({ mapId, ...warning });
+        }
+    }
+    return { ok: warnings.length === 0, mapsChecked, warnings };
+}
+/**
+ * Read a 1-indexed database array by filename, failing soft to `[]` if the file is
+ * absent. Thin (projectPath, file) convenience over the shared {@link readJsonArraySoft}.
+ */
+async function loadArray(projectPath, file) {
+    return readJsonArraySoft(getDataPath(projectPath, file));
+}
+/**
+ * Load the whole project snapshot the reference linter needs. Every read fails
+ * soft: a missing/unreadable file yields an empty array (or `null` for
+ * `Animations.json`/`System.json`), so the audit degrades to fewer checks rather
+ * than throwing.
+ */
+async function loadProjectData(projectPath) {
+    const mapInfos = await loadArray(projectPath, 'MapInfos.json');
+    const maps = [];
+    for (const info of mapInfos) {
+        if (!info)
+            continue;
+        try {
+            const map = await getMap(projectPath, info.id);
+            maps.push({ id: info.id, events: map.events });
+        }
+        catch {
+            // A map listed in MapInfos may not have a MapNNN.json file yet; skip it.
+        }
+    }
+    let animations = null;
+    try {
+        animations = await readJsonFile(getDataPath(projectPath, 'Animations.json'));
+    }
+    catch {
+        animations = null; // absent -> skip animation-id checks rather than flag everything
+    }
+    let system = null;
+    try {
+        system = await readJsonFile(getDataPath(projectPath, 'System.json'));
+    }
+    catch {
+        system = null;
+    }
+    return {
+        mapInfos,
+        maps,
+        actors: await loadArray(projectPath, 'Actors.json'),
+        classes: await loadArray(projectPath, 'Classes.json'),
+        skills: await loadArray(projectPath, 'Skills.json'),
+        items: await loadArray(projectPath, 'Items.json'),
+        weapons: await loadArray(projectPath, 'Weapons.json'),
+        armors: await loadArray(projectPath, 'Armors.json'),
+        enemies: await loadArray(projectPath, 'Enemies.json'),
+        troops: await loadArray(projectPath, 'Troops.json'),
+        states: await loadArray(projectPath, 'States.json'),
+        commonEvents: await loadArray(projectPath, 'CommonEvents.json'),
+        animations,
+        system,
+    };
+}
+/**
+ * Cross-file reference-integrity audit for the whole project. Read-only and
+ * warn-by-default: reports dangling/cyclic references (a Transfer Player to a
+ * missing map, a skill effect adding a non-existent state, a troop member for a
+ * deleted enemy, a cyclic map tree, …) without changing anything. Complements
+ * `validate_project`, which only checks event-command *shape*.
+ */
+export async function validateReferencesTool(projectPath) {
+    const data = await loadProjectData(projectPath);
+    const warnings = checkReferences(data);
+    return { ok: warnings.length === 0, warnings };
+}
+/** The asset types the filename audit scans (a subset of list_assets' kinds). */
+const AUDITED_ASSET_TYPES = [
+    'characters',
+    'faces',
+    'sv_actors',
+    'enemies',
+    'tilesets',
+    'titles1',
+    'titles2',
+    'battlebacks1',
+    'battlebacks2',
+    'parallaxes',
+    'pictures',
+    'bgm',
+    'bgs',
+    'me',
+    'se',
+];
+/**
+ * Enumerate the available basenames for every audited asset type into a lookup
+ * the pure checker can test against. `listAssets` fails soft (a missing dir →
+ * `[]`), so an unused asset kind maps to an empty set and its references are
+ * skipped rather than flagged.
+ */
+async function buildAvailableAssets(projectPath) {
+    const assets = {};
+    for (const type of AUDITED_ASSET_TYPES) {
+        const { names } = await listAssets(projectPath, type);
+        assets[type] = new Set(names);
+    }
+    return assets;
+}
+/**
+ * Load the project records that carry asset-filename fields (the maps in full,
+ * for their map-level audio/images and event lists). Every read fails soft to an
+ * empty array (or `null` for `System.json`), so a missing file degrades the audit
+ * rather than throwing.
+ */
+async function loadAssetData(projectPath) {
+    const mapInfos = await loadArray(projectPath, 'MapInfos.json');
+    const maps = [];
+    for (const info of mapInfos) {
+        if (!info)
+            continue;
+        try {
+            maps.push({ id: info.id, map: (await getMap(projectPath, info.id)) });
+        }
+        catch {
+            // A map listed in MapInfos may not have a MapNNN.json file yet; skip it.
+        }
+    }
+    let system = null;
+    try {
+        system = await readJsonFile(getDataPath(projectPath, 'System.json'));
+    }
+    catch {
+        system = null;
+    }
+    return {
+        actors: await loadArray(projectPath, 'Actors.json'),
+        enemies: await loadArray(projectPath, 'Enemies.json'),
+        tilesets: await loadArray(projectPath, 'Tilesets.json'),
+        maps,
+        troops: await loadArray(projectPath, 'Troops.json'),
+        commonEvents: await loadArray(projectPath, 'CommonEvents.json'),
+        system,
+    };
+}
+/**
+ * Project-wide asset-*filename* audit (read-only, warn-by-default). Scans every
+ * asset-name field across the database, maps, and system against the files that
+ * actually exist on disk, reporting each dangling reference — the systematic
+ * complement to the per-record create-time warnings (a `battlerName` typo would
+ * otherwise only surface as a runtime "Failed to load …" error). The *id*-
+ * integrity sibling is `validate_references`.
+ */
+export async function validateAssetsTool(projectPath) {
+    const [data, assets] = await Promise.all([
+        loadAssetData(projectPath),
+        buildAvailableAssets(projectPath),
+    ]);
+    const warnings = checkAssets(data, assets);
+    return { ok: warnings.length === 0, warnings };
+}
+export const validationToolDefinitions = [
+    {
+        name: 'validate_event',
+        description: "Validate a single event's command lists against the known RPG Maker MZ command table. Read-only: reports parameter/structure warnings without changing anything.",
+        inputSchema: {
+            mapId: z.number().int().positive().describe('The ID of the map'),
+            eventId: z.number().int().positive().describe('The ID of the event to validate'),
+        },
+        handler: (ctx, args) => validateEventTool(ctx.projectPath, args.mapId, args.eventId),
+    },
+    {
+        name: 'validate_project',
+        description: 'Validate the event command lists of every map in the project. Read-only: returns aggregated, map-tagged warnings for auditing before or after a batch of edits.',
+        inputSchema: {},
+        handler: (ctx) => validateProjectTool(ctx.projectPath),
+    },
+    {
+        name: 'validate_references',
+        description: 'Audit cross-file reference integrity across the whole project (read-only, warn-by-default): Transfer Player targets and starting position point at existing maps; starting party, actor classes, class/enemy skills, troop members, enemy drops, and skill/item effects (states, learned skills, common events, animations) all resolve; and the map tree has no dangling or cyclic parentId. Complements validate_project (which checks command shape). Returns { ok, warnings[] }.',
+        inputSchema: {},
+        handler: (ctx) => validateReferencesTool(ctx.projectPath),
+    },
+    {
+        name: 'validate_assets',
+        description: 'Audit asset-filename integrity across the whole project (read-only, warn-by-default): every image/audio name field — actor characterName/faceName/battlerName, enemy battlerName, tileset sheets, map bgm/bgs/parallax/battlebacks, event page graphics, event Play BGM/BGS/ME/SE / Show Picture / Show Text face / Change Actor Images, and system titles/battlebacks/default audio/vehicle graphics — is checked against the files present under img/ and audio/. Catches a wrong filename (e.g. a battlerName with no matching img/enemies/*.png) before it becomes a runtime "Failed to load" error. An asset kind whose directory is empty/missing is skipped (not flagged). Complements validate_references (which checks id integrity). Returns { ok, warnings[] }.',
+        inputSchema: {},
+        handler: (ctx) => validateAssetsTool(ctx.projectPath),
+    },
+];
+//# sourceMappingURL=validationTools.js.map

package/dist/tools/validationTools.js.map

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

package/dist/utils/commit.d.ts

@@ -0,0 +1,62 @@
+import { AsyncLocalStorage } from 'async_hooks';
+/**
+ * A single leaf-level difference between the old and new file contents.
+ * `from` absent means the value was added; `to` absent means it was removed.
+ */
+export interface ChangeRecord {
+    path: string;
+    from?: unknown;
+    to?: unknown;
+}
+export interface JsonDiff {
+    changes: ChangeRecord[];
+    /** True if the change list was capped (see MAX_CHANGES). */
+    truncated: boolean;
+}
+export interface CommitResult {
+    path: string;
+    changed: boolean;
+    dryRun: boolean;
+    diff: JsonDiff;
+    /** True when this commit deletes the file rather than writing it. */
+    deleted?: boolean;
+}
+/**
+ * Per-request commit context. `commitChange` reads it via AsyncLocalStorage so
+ * dry-run stays a cross-cutting concern: tool functions don't need a `dryRun`
+ * parameter threaded through their signatures. When `dryRun` is set, writes are
+ * skipped and every attempted change is collected in `commits` for the caller
+ * to report back as a preview.
+ */
+export interface CommitContext {
+    dryRun: boolean;
+    commits: CommitResult[];
+}
+export declare const commitStore: AsyncLocalStorage<CommitContext>;
+/**
+ * Structural diff between two JSON-serializable values. Recurses through arrays
+ * and plain objects, recording only the leaves that actually differ. Equal
+ * subtrees produce no records.
+ */
+export declare function diffJson(oldValue: unknown, newValue: unknown): JsonDiff;
+/**
+ * The single write choke point for all tool mutations. Computes the diff against
+ * the file's current contents, then:
+ *  - in dry-run mode, records the diff and skips the write;
+ *  - otherwise, writes only if something actually changed.
+ *
+ * Either way the result is pushed onto the active CommitContext (if any) so the
+ * dispatcher can surface a preview.
+ */
+export declare function commitChange(filePath: string, newData: unknown): Promise<CommitResult>;
+/**
+ * The deletion arm of the write choke point. Mirrors `commitChange` so that
+ * file removals participate in the same dry-run/preview machinery: in dry-run
+ * the deletion is recorded but not performed, otherwise the file is unlinked
+ * (only if it currently exists — a missing file is reported as `changed: false`
+ * and left alone). `changed` reflects whether the file existed to begin with,
+ * so a preview reads "this file would be deleted" rather than dumping the file's
+ * entire contents through `diffJson`.
+ */
+export declare function commitDelete(filePath: string): Promise<CommitResult>;
+//# sourceMappingURL=commit.d.ts.map

package/dist/utils/commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../src/utils/commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIhD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,eAAO,MAAM,WAAW,kCAAyC,CAAC;AAUlE;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAoCvE;AAcD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAmB5F;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAmB1E"}

package/dist/utils/commit.js

@@ -0,0 +1,119 @@
+import { AsyncLocalStorage } from 'async_hooks';
+import { readFile } from 'fs/promises';
+import { writeJsonFile, deleteFile, fileExists } from './fileHandler.js';
+export const commitStore = new AsyncLocalStorage();
+// Cap on reported leaf changes, so a wholesale rewrite (e.g. an entire repainted
+// tile array) can't produce an enormous diff payload.
+const MAX_CHANGES = 200;
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Structural diff between two JSON-serializable values. Recurses through arrays
+ * and plain objects, recording only the leaves that actually differ. Equal
+ * subtrees produce no records.
+ */
+export function diffJson(oldValue, newValue) {
+    const changes = [];
+    let truncated = false;
+    const record = (path, from, to) => {
+        if (changes.length >= MAX_CHANGES) {
+            truncated = true;
+            return;
+        }
+        const entry = { path };
+        if (from !== undefined)
+            entry.from = from;
+        if (to !== undefined)
+            entry.to = to;
+        changes.push(entry);
+    };
+    const walk = (path, oldVal, newVal) => {
+        if (oldVal === newVal)
+            return;
+        if (truncated)
+            return;
+        if (Array.isArray(oldVal) && Array.isArray(newVal)) {
+            const len = Math.max(oldVal.length, newVal.length);
+            for (let i = 0; i < len; i++) {
+                walk(`${path}[${i}]`, oldVal[i], newVal[i]);
+            }
+        }
+        else if (isPlainObject(oldVal) && isPlainObject(newVal)) {
+            const keys = new Set([...Object.keys(oldVal), ...Object.keys(newVal)]);
+            for (const key of keys) {
+                walk(path ? `${path}.${key}` : key, oldVal[key], newVal[key]);
+            }
+        }
+        else {
+            record(path, oldVal, newVal);
+        }
+    };
+    walk('', oldValue, newValue);
+    return { changes, truncated };
+}
+/** Read and parse the existing file, treating a missing file as no prior data. */
+async function readOld(filePath) {
+    try {
+        return JSON.parse(await readFile(filePath, 'utf-8'));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return undefined;
+        }
+        throw error;
+    }
+}
+/**
+ * The single write choke point for all tool mutations. Computes the diff against
+ * the file's current contents, then:
+ *  - in dry-run mode, records the diff and skips the write;
+ *  - otherwise, writes only if something actually changed.
+ *
+ * Either way the result is pushed onto the active CommitContext (if any) so the
+ * dispatcher can surface a preview.
+ */
+export async function commitChange(filePath, newData) {
+    const context = commitStore.getStore();
+    const dryRun = context?.dryRun ?? false;
+    const oldData = await readOld(filePath);
+    const diff = diffJson(oldData, newData);
+    const result = {
+        path: filePath,
+        changed: diff.changes.length > 0,
+        dryRun,
+        diff,
+    };
+    if (!dryRun && result.changed) {
+        await writeJsonFile(filePath, newData);
+    }
+    context?.commits.push(result);
+    return result;
+}
+/**
+ * The deletion arm of the write choke point. Mirrors `commitChange` so that
+ * file removals participate in the same dry-run/preview machinery: in dry-run
+ * the deletion is recorded but not performed, otherwise the file is unlinked
+ * (only if it currently exists — a missing file is reported as `changed: false`
+ * and left alone). `changed` reflects whether the file existed to begin with,
+ * so a preview reads "this file would be deleted" rather than dumping the file's
+ * entire contents through `diffJson`.
+ */
+export async function commitDelete(filePath) {
+    const context = commitStore.getStore();
+    const dryRun = context?.dryRun ?? false;
+    const existed = await fileExists(filePath);
+    const result = {
+        path: filePath,
+        changed: existed,
+        dryRun,
+        diff: { changes: [], truncated: false },
+        deleted: true,
+    };
+    if (!dryRun && existed) {
+        await deleteFile(filePath);
+    }
+    context?.commits.push(result);
+    return result;
+}
+//# sourceMappingURL=commit.js.map

package/dist/utils/commit.js.map

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

package/dist/utils/fileHandler.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Read and parse a JSON file from RPG Maker MZ project
+ */
+export declare function readJsonFile<T>(filePath: string): Promise<T>;
+/**
+ * Write JSON data to a file.
+ *
+ * RPG Maker MZ's editor saves its `data/*.json` files as compact, single-line
+ * JSON (no indentation). We match that format so that:
+ *  - map tile arrays don't explode into thousands of lines, and
+ *  - diffs stay minimal and consistent with what the editor itself writes,
+ *    which keeps the per-session git-checkpoint workflow readable.
+ */
+export declare function writeJsonFile(filePath: string, data: any): Promise<void>;
+/**
+ * Read a 1-indexed database array file, failing soft only on a *missing* file
+ * (ENOENT → `[]`). Used by create-time reference checks that must degrade to
+ * "can't verify" (skip) instead of breaking on a project (or test fixture) that
+ * lacks the target file.
+ *
+ * A *corrupted* (present but malformed) file is a real error and throws — swallowing
+ * it would silently skip reference/troop validation on a broken project instead of
+ * surfacing the corruption. A parsed non-array value still yields `[]` (a wrong-typed
+ * file is treated as "no records" rather than crashing callers that expect an array).
+ */
+export declare function readJsonArraySoft<T>(filePath: string): Promise<(T | null)[]>;
+/**
+ * List all files in a directory with a specific extension
+ */
+export declare function listFiles(dirPath: string, extension: string): Promise<string[]>;
+/**
+ * Whether a file (or directory) exists at the given path.
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Delete a file. A missing file is treated as a no-op (the desired end state —
+ * the file being gone — already holds), so deletions stay idempotent.
+ */
+export declare function deleteFile(filePath: string): Promise<void>;
+/**
+ * Get the full path to a data file in RPG Maker MZ project
+ */
+export declare function getDataPath(projectPath: string, fileName: string): string;
+/**
+ * Get the full path to a map file in RPG Maker MZ project
+ */
+export declare function getMapPath(projectPath: string, mapId: number): string;
+export declare function validateProjectPath(projectPath: string): Promise<boolean>;
+//# sourceMappingURL=fileHandler.d.ts.map

package/dist/utils/fileHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileHandler.d.ts","sourceRoot":"","sources":["../../src/utils/fileHandler.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CASlE;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAYlF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOrF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrE;AAaD,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAc/E"}

package/dist/utils/fileHandler.js

@@ -0,0 +1,137 @@
+import { readFile, writeFile, readdir, access, unlink } from 'fs/promises';
+import { join, extname } from 'path';
+/**
+ * Read and parse a JSON file from RPG Maker MZ project
+ */
+export async function readJsonFile(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        // Unwrap the underlying Error's message so we don't nest `Error: …: Error: …`.
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read JSON file ${filePath}: ${detail}`);
+    }
+}
+/**
+ * Write JSON data to a file.
+ *
+ * RPG Maker MZ's editor saves its `data/*.json` files as compact, single-line
+ * JSON (no indentation). We match that format so that:
+ *  - map tile arrays don't explode into thousands of lines, and
+ *  - diffs stay minimal and consistent with what the editor itself writes,
+ *    which keeps the per-session git-checkpoint workflow readable.
+ */
+export async function writeJsonFile(filePath, data) {
+    try {
+        const jsonString = JSON.stringify(data);
+        await writeFile(filePath, jsonString, 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`Failed to write JSON file ${filePath}: ${error}`);
+    }
+}
+/**
+ * Read a 1-indexed database array file, failing soft only on a *missing* file
+ * (ENOENT → `[]`). Used by create-time reference checks that must degrade to
+ * "can't verify" (skip) instead of breaking on a project (or test fixture) that
+ * lacks the target file.
+ *
+ * A *corrupted* (present but malformed) file is a real error and throws — swallowing
+ * it would silently skip reference/troop validation on a broken project instead of
+ * surfacing the corruption. A parsed non-array value still yields `[]` (a wrong-typed
+ * file is treated as "no records" rather than crashing callers that expect an array).
+ */
+export async function readJsonArraySoft(filePath) {
+    let content;
+    try {
+        content = await readFile(filePath, 'utf-8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+    const parsed = JSON.parse(content);
+    return Array.isArray(parsed) ? parsed : [];
+}
+/**
+ * List all files in a directory with a specific extension
+ */
+export async function listFiles(dirPath, extension) {
+    try {
+        const files = await readdir(dirPath);
+        return files.filter((file) => extname(file) === extension);
+    }
+    catch (error) {
+        throw new Error(`Failed to list files in ${dirPath}: ${error}`);
+    }
+}
+/**
+ * Whether a file (or directory) exists at the given path.
+ */
+export async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Delete a file. A missing file is treated as a no-op (the desired end state —
+ * the file being gone — already holds), so deletions stay idempotent.
+ */
+export async function deleteFile(filePath) {
+    try {
+        await unlink(filePath);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return;
+        throw new Error(`Failed to delete file ${filePath}: ${error}`);
+    }
+}
+/**
+ * Get the full path to a data file in RPG Maker MZ project
+ */
+export function getDataPath(projectPath, fileName) {
+    return join(projectPath, 'data', fileName);
+}
+/**
+ * Get the full path to a map file in RPG Maker MZ project
+ */
+export function getMapPath(projectPath, mapId) {
+    const fileName = `Map${String(mapId).padStart(3, '0')}.json`;
+    return getDataPath(projectPath, fileName);
+}
+/**
+ * Validate RPG Maker MZ project path
+ */
+/**
+ * Paths that have already validated successfully. A directory doesn't stop being
+ * an RPG Maker project mid-session, so the check is memoized after the first pass
+ * — every tool call would otherwise re-run it. Only successes are cached (a path
+ * that isn't yet a project might become one).
+ */
+const validatedProjectPaths = new Set();
+export async function validateProjectPath(projectPath) {
+    if (validatedProjectPaths.has(projectPath)) {
+        return true;
+    }
+    try {
+        // Check the essential files exist (access(), not a full read — we only need
+        // presence, not contents).
+        await access(join(projectPath, 'game.rmmzproject'));
+        await access(getDataPath(projectPath, 'System.json'));
+        validatedProjectPaths.add(projectPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=fileHandler.js.map

package/dist/utils/fileHandler.js.map

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

package/dist/utils/records.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Drop keys whose value is `undefined` so a caller's omitted optional field can't
+ * clobber a template default when spread over it. Used by every `create_*` tool
+ * that merges caller overrides onto a `default*()` template (`{ ...template,
+ * ...definedOnly(overrides), id }`).
+ */
+export declare function definedOnly<T extends object>(obj: T): Partial<T>;
+//# sourceMappingURL=records.d.ts.map

package/dist/utils/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/utils/records.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhE"}

package/dist/utils/records.js

@@ -0,0 +1,10 @@
+/**
+ * Drop keys whose value is `undefined` so a caller's omitted optional field can't
+ * clobber a template default when spread over it. Used by every `create_*` tool
+ * that merges caller overrides onto a `default*()` template (`{ ...template,
+ * ...definedOnly(overrides), id }`).
+ */
+export function definedOnly(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
+}
+//# sourceMappingURL=records.js.map

package/dist/utils/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/utils/records.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAmB,GAAM;IAClD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAe,CAAC;AAClG,CAAC"}