universal-game-modder 0.1.4

package/dist/core/model-db.js

@@ -0,0 +1,517 @@
+/**
+ * model-db.ts — The Model SQLite writer (shared core).
+ *
+ * Owns the `<game>.autopsy.db` file: the single, portable, per-game persistent
+ * understanding the whole Autopsy Engine reads and writes. This module is the
+ * ONLY thing that knows the on-disk schema (MODEL_SCHEMA.md V1 subset).
+ *
+ * Design contract (PR-1):
+ *  - better-sqlite3, synchronous. One file per game.
+ *  - CREATE TABLE IF NOT EXISTS for game / binary / asset / data_store, every
+ *    fact-bearing row carrying provenance + source_tool columns.
+ *  - Idempotent writes: UNIQUE natural keys + INSERT ... ON CONFLICT DO UPDATE,
+ *    so re-running unpack_game never duplicates rows (append-and-confirm).
+ *  - WAL journal mode for crash safety.
+ *  - Read-only with respect to GAME files. The only thing this writes is the
+ *    .autopsy.db itself.
+ */
+import Database from 'better-sqlite3';
+import { dirname } from 'path';
+import { existsSync, mkdirSync } from 'fs';
+/**
+ * The schema version this writer emits. Stored on the game row.
+ *  v1 (PR-0): game / binary / asset / data_store.
+ *  v2 (PR-3): + function / xref / symbol (ADDITIVE — v1 tables untouched; existing
+ *             .autopsy.db files gain the empty new tables via CREATE TABLE IF NOT EXISTS).
+ */
+export const AUTOPSY_SCHEMA_VERSION = 2;
+/**
+ * AutopsyModel — opens/creates a `<game>.autopsy.db` and writes the V1 tables.
+ *
+ * Usage:
+ *   const model = new AutopsyModel('C:/.../MyGame.autopsy.db');
+ *   const gameId = model.upsertGame({ ... });
+ *   model.addBinary({ game_id: gameId, ... });
+ *   ...
+ *   model.close();
+ */
+export class AutopsyModel {
+    db;
+    dbPath;
+    constructor(dbPath) {
+        this.dbPath = dbPath;
+        // Ensure the containing directory exists (.autopsy/ dir or sibling of game).
+        const dir = dirname(dbPath);
+        if (dir && !existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        this.db = new Database(dbPath);
+        // WAL for crash safety + concurrent reads while we append.
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+        // Reasonable durability without the full-fsync cost on every statement.
+        this.db.pragma('synchronous = NORMAL');
+        this.createSchema();
+    }
+    /** Create the V1 tables (idempotent). Called on every open. */
+    createSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS game (
+        id              INTEGER PRIMARY KEY,
+        name            TEXT    NOT NULL,
+        install_path    TEXT    NOT NULL,
+        engine          TEXT,
+        runtime         TEXT,
+        arch            TEXT,
+        package_type    TEXT,
+        autopsy_version INTEGER NOT NULL,
+        provenance      TEXT    NOT NULL DEFAULT 'inferred',
+        source_tool     TEXT    NOT NULL DEFAULT 'unpack_game',
+        created_at      TEXT    NOT NULL DEFAULT (datetime('now')),
+        UNIQUE (install_path)
+      );
+
+      CREATE TABLE IF NOT EXISTS binary (
+        id          INTEGER PRIMARY KEY,
+        game_id     INTEGER NOT NULL REFERENCES game(id) ON DELETE CASCADE,
+        path        TEXT    NOT NULL,
+        kind        TEXT    NOT NULL,
+        managed     INTEGER NOT NULL DEFAULT 0,
+        arch        TEXT,
+        size        INTEGER NOT NULL DEFAULT 0,
+        sha256      TEXT,
+        role        TEXT,
+        notes       TEXT,
+        provenance  TEXT    NOT NULL DEFAULT 'inferred',
+        source_tool TEXT    NOT NULL DEFAULT 'unpack_game',
+        UNIQUE (game_id, path)
+      );
+
+      CREATE TABLE IF NOT EXISTS asset (
+        id             INTEGER PRIMARY KEY,
+        game_id        INTEGER NOT NULL REFERENCES game(id) ON DELETE CASCADE,
+        container_path TEXT    NOT NULL,
+        internal_path  TEXT    NOT NULL DEFAULT '',
+        type           TEXT    NOT NULL DEFAULT 'other',
+        format         TEXT,
+        decoded        INTEGER NOT NULL DEFAULT 0,
+        decoded_path   TEXT,
+        size           INTEGER NOT NULL DEFAULT 0,
+        notes          TEXT,
+        provenance     TEXT    NOT NULL DEFAULT 'inferred',
+        source_tool    TEXT    NOT NULL DEFAULT 'unpack_game',
+        UNIQUE (game_id, container_path, internal_path)
+      );
+
+      CREATE TABLE IF NOT EXISTS data_store (
+        id           INTEGER PRIMARY KEY,
+        game_id      INTEGER NOT NULL REFERENCES game(id) ON DELETE CASCADE,
+        path         TEXT    NOT NULL,
+        kind         TEXT    NOT NULL,
+        scope        TEXT,
+        schema_known INTEGER NOT NULL DEFAULT 0,
+        notes        TEXT,
+        provenance   TEXT    NOT NULL DEFAULT 'inferred',
+        source_tool  TEXT    NOT NULL DEFAULT 'unpack_game',
+        UNIQUE (game_id, path)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_binary_game     ON binary(game_id);
+      CREATE INDEX IF NOT EXISTS idx_asset_game      ON asset(game_id);
+      CREATE INDEX IF NOT EXISTS idx_asset_type      ON asset(game_id, type);
+      CREATE INDEX IF NOT EXISTS idx_data_store_game ON data_store(game_id);
+    `);
+        // ── Schema v2 (PR-3, V3 Native Comprehension) — ADDITIVE ────────────────
+        // New tables only. The v1 block above is byte-for-byte unchanged, so existing
+        // .autopsy.db files simply gain these three empty tables on next open.
+        // NB: "function" is a SQL keyword — the identifier is double-quoted everywhere.
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS "function" (
+        id          INTEGER PRIMARY KEY,
+        binary_id   INTEGER NOT NULL REFERENCES binary(id) ON DELETE CASCADE,
+        rva         INTEGER NOT NULL,
+        size        INTEGER NOT NULL DEFAULT 0,
+        insn_count  INTEGER NOT NULL DEFAULT 0,
+        name        TEXT,
+        label       TEXT,
+        notes       TEXT,
+        provenance  TEXT    NOT NULL DEFAULT 'inferred',
+        source_tool TEXT    NOT NULL DEFAULT 'disassemble_function',
+        UNIQUE (binary_id, rva)
+      );
+
+      CREATE TABLE IF NOT EXISTS xref (
+        id          INTEGER PRIMARY KEY,
+        binary_id   INTEGER NOT NULL REFERENCES binary(id) ON DELETE CASCADE,
+        from_rva    INTEGER NOT NULL,
+        to_rva      INTEGER NOT NULL,
+        kind        TEXT    NOT NULL,
+        mnemonic    TEXT,
+        notes       TEXT,
+        provenance  TEXT    NOT NULL DEFAULT 'verified',
+        source_tool TEXT    NOT NULL DEFAULT 'build_call_graph',
+        UNIQUE (binary_id, from_rva, to_rva, kind)
+      );
+
+      CREATE TABLE IF NOT EXISTS symbol (
+        id          INTEGER PRIMARY KEY,
+        binary_id   INTEGER NOT NULL REFERENCES binary(id) ON DELETE CASCADE,
+        rva         INTEGER NOT NULL,
+        name        TEXT    NOT NULL,
+        kind        TEXT    NOT NULL,
+        notes       TEXT,
+        provenance  TEXT    NOT NULL DEFAULT 'verified',
+        source_tool TEXT    NOT NULL DEFAULT 'ingest_pdb',
+        UNIQUE (binary_id, rva, kind)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_function_binary ON "function"(binary_id);
+      CREATE INDEX IF NOT EXISTS idx_xref_binary     ON xref(binary_id);
+      CREATE INDEX IF NOT EXISTS idx_xref_to         ON xref(binary_id, to_rva);
+      CREATE INDEX IF NOT EXISTS idx_symbol_binary   ON symbol(binary_id);
+    `);
+    }
+    /**
+     * Insert-or-update the single game header row, keyed by install_path.
+     * Returns the game_id (stable across re-runs — append-and-confirm, A6).
+     */
+    upsertGame(input) {
+        const stmt = this.db.prepare(`
+      INSERT INTO game (
+        name, install_path, engine, runtime, arch, package_type,
+        autopsy_version, provenance, source_tool
+      ) VALUES (
+        @name, @install_path, @engine, @runtime, @arch, @package_type,
+        @autopsy_version, @provenance, @source_tool
+      )
+      ON CONFLICT (install_path) DO UPDATE SET
+        name            = excluded.name,
+        engine          = excluded.engine,
+        runtime         = excluded.runtime,
+        arch            = excluded.arch,
+        package_type    = excluded.package_type,
+        autopsy_version = excluded.autopsy_version,
+        provenance      = excluded.provenance,
+        source_tool     = excluded.source_tool
+      RETURNING id
+    `);
+        const row = stmt.get({
+            name: input.name,
+            install_path: input.install_path,
+            engine: input.engine,
+            runtime: input.runtime,
+            arch: input.arch,
+            package_type: input.package_type,
+            autopsy_version: input.autopsy_version,
+            provenance: input.provenance,
+            source_tool: input.source_tool,
+        });
+        if (!row) {
+            throw new Error('upsertGame: INSERT ... RETURNING id produced no row');
+        }
+        return row.id;
+    }
+    /**
+     * Insert-or-update a binary, keyed by (game_id, path). Idempotent (A6).
+     * Returns the binary id.
+     */
+    addBinary(input) {
+        const stmt = this.db.prepare(`
+      INSERT INTO binary (
+        game_id, path, kind, managed, arch, size, sha256, role, notes,
+        provenance, source_tool
+      ) VALUES (
+        @game_id, @path, @kind, @managed, @arch, @size, @sha256, @role, @notes,
+        @provenance, @source_tool
+      )
+      ON CONFLICT (game_id, path) DO UPDATE SET
+        kind        = excluded.kind,
+        managed     = excluded.managed,
+        arch        = excluded.arch,
+        size        = excluded.size,
+        sha256      = excluded.sha256,
+        role        = excluded.role,
+        notes       = excluded.notes,
+        provenance  = excluded.provenance,
+        source_tool = excluded.source_tool
+      RETURNING id
+    `);
+        const row = stmt.get({
+            game_id: input.game_id,
+            path: input.path,
+            kind: input.kind,
+            managed: input.managed ? 1 : 0,
+            arch: input.arch,
+            size: input.size,
+            sha256: input.sha256,
+            role: input.role,
+            notes: input.notes,
+            provenance: input.provenance,
+            source_tool: input.source_tool,
+        });
+        if (!row) {
+            throw new Error('addBinary: INSERT ... RETURNING id produced no row');
+        }
+        return row.id;
+    }
+    /**
+     * Insert-or-update an asset, keyed by (game_id, container_path, internal_path).
+     * Idempotent (A6). Unknown files arrive here as type='other' with a reason in
+     * notes — they are catalogued, never dropped (A3). Returns the asset id.
+     */
+    addAsset(input) {
+        const stmt = this.db.prepare(`
+      INSERT INTO asset (
+        game_id, container_path, internal_path, type, format, decoded,
+        decoded_path, size, notes, provenance, source_tool
+      ) VALUES (
+        @game_id, @container_path, @internal_path, @type, @format, @decoded,
+        @decoded_path, @size, @notes, @provenance, @source_tool
+      )
+      ON CONFLICT (game_id, container_path, internal_path) DO UPDATE SET
+        type         = excluded.type,
+        format       = excluded.format,
+        decoded      = excluded.decoded,
+        decoded_path = excluded.decoded_path,
+        size         = excluded.size,
+        notes        = excluded.notes,
+        provenance   = excluded.provenance,
+        source_tool  = excluded.source_tool
+      RETURNING id
+    `);
+        const row = stmt.get({
+            game_id: input.game_id,
+            container_path: input.container_path,
+            internal_path: input.internal_path ?? '',
+            type: input.type,
+            format: input.format,
+            decoded: input.decoded ? 1 : 0,
+            decoded_path: input.decoded_path,
+            size: input.size,
+            notes: input.notes,
+            provenance: input.provenance,
+            source_tool: input.source_tool,
+        });
+        if (!row) {
+            throw new Error('addAsset: INSERT ... RETURNING id produced no row');
+        }
+        return row.id;
+    }
+    /**
+     * Insert-or-update a data_store, keyed by (game_id, path). Idempotent (A6).
+     * Containers (.pak/.bundle/.pck) may land here as kind='binary-blob' rather
+     * than being walked as Unity (A7). Returns the data_store id.
+     */
+    addDataStore(input) {
+        const stmt = this.db.prepare(`
+      INSERT INTO data_store (
+        game_id, path, kind, scope, schema_known, notes,
+        provenance, source_tool
+      ) VALUES (
+        @game_id, @path, @kind, @scope, @schema_known, @notes,
+        @provenance, @source_tool
+      )
+      ON CONFLICT (game_id, path) DO UPDATE SET
+        kind         = excluded.kind,
+        scope        = excluded.scope,
+        schema_known = excluded.schema_known,
+        notes        = excluded.notes,
+        provenance   = excluded.provenance,
+        source_tool  = excluded.source_tool
+      RETURNING id
+    `);
+        const row = stmt.get({
+            game_id: input.game_id,
+            path: input.path,
+            kind: input.kind,
+            scope: input.scope,
+            schema_known: input.schema_known ? 1 : 0,
+            notes: input.notes,
+            provenance: input.provenance,
+            source_tool: input.source_tool,
+        });
+        if (!row) {
+            throw new Error('addDataStore: INSERT ... RETURNING id produced no row');
+        }
+        return row.id;
+    }
+    /**
+     * Insert-or-update a function, keyed by (binary_id, rva). Idempotent (A6).
+     * PR-3.1 writes the disassembled region's extent; name/label fill in later
+     * slices. Returns the function id.
+     */
+    addFunction(input) {
+        const stmt = this.db.prepare(`
+      INSERT INTO "function" (
+        binary_id, rva, size, insn_count, name, label, notes,
+        provenance, source_tool
+      ) VALUES (
+        @binary_id, @rva, @size, @insn_count, @name, @label, @notes,
+        @provenance, @source_tool
+      )
+      ON CONFLICT (binary_id, rva) DO UPDATE SET
+        size        = excluded.size,
+        insn_count  = excluded.insn_count,
+        name        = COALESCE(excluded.name, "function".name),
+        label       = COALESCE(excluded.label, "function".label),
+        notes       = excluded.notes,
+        provenance  = excluded.provenance,
+        source_tool = excluded.source_tool
+      RETURNING id
+    `);
+        const row = stmt.get({
+            binary_id: input.binary_id,
+            rva: input.rva,
+            size: input.size,
+            insn_count: input.insn_count,
+            name: input.name,
+            label: input.label,
+            notes: input.notes,
+            provenance: input.provenance,
+            source_tool: input.source_tool,
+        });
+        if (!row) {
+            throw new Error('addFunction: INSERT ... RETURNING id produced no row');
+        }
+        return row.id;
+    }
+    /**
+     * Insert-or-update a cross-reference, keyed by (binary_id, from_rva, to_rva,
+     * kind). Idempotent (A6). Returns the xref id.
+     */
+    addXref(input) {
+        const stmt = this.db.prepare(`
+      INSERT INTO xref (
+        binary_id, from_rva, to_rva, kind, mnemonic, notes,
+        provenance, source_tool
+      ) VALUES (
+        @binary_id, @from_rva, @to_rva, @kind, @mnemonic, @notes,
+        @provenance, @source_tool
+      )
+      ON CONFLICT (binary_id, from_rva, to_rva, kind) DO UPDATE SET
+        mnemonic    = excluded.mnemonic,
+        notes       = excluded.notes,
+        provenance  = excluded.provenance,
+        source_tool = excluded.source_tool
+      RETURNING id
+    `);
+        const row = stmt.get({
+            binary_id: input.binary_id,
+            from_rva: input.from_rva,
+            to_rva: input.to_rva,
+            kind: input.kind,
+            mnemonic: input.mnemonic,
+            notes: input.notes,
+            provenance: input.provenance,
+            source_tool: input.source_tool,
+        });
+        if (!row) {
+            throw new Error('addXref: INSERT ... RETURNING id produced no row');
+        }
+        return row.id;
+    }
+    /**
+     * Insert-or-update a symbol, keyed by (binary_id, rva, kind). Idempotent (A6).
+     * Returns the symbol id.
+     */
+    addSymbol(input) {
+        const stmt = this.db.prepare(`
+      INSERT INTO symbol (
+        binary_id, rva, name, kind, notes, provenance, source_tool
+      ) VALUES (
+        @binary_id, @rva, @name, @kind, @notes, @provenance, @source_tool
+      )
+      ON CONFLICT (binary_id, rva, kind) DO UPDATE SET
+        name        = excluded.name,
+        notes       = excluded.notes,
+        provenance  = excluded.provenance,
+        source_tool = excluded.source_tool
+      RETURNING id
+    `);
+        const row = stmt.get({
+            binary_id: input.binary_id,
+            rva: input.rva,
+            name: input.name,
+            kind: input.kind,
+            notes: input.notes,
+            provenance: input.provenance,
+            source_tool: input.source_tool,
+        });
+        if (!row) {
+            throw new Error('addSymbol: INSERT ... RETURNING id produced no row');
+        }
+        return row.id;
+    }
+    /**
+     * Run many writes inside one transaction. Returns the callback's result.
+     * Far faster for a full-install walk, and atomic: a crash mid-walk leaves
+     * the DB at its prior consistent state rather than half-populated.
+     */
+    transaction(fn) {
+        const wrapped = this.db.transaction(fn);
+        return wrapped();
+    }
+    /** Row counts per table — for the unpack summary / verifier / tests. */
+    counts() {
+        // `table` is a trusted literal from this method only (never user input).
+        // "function" is a SQL keyword, so callers pass the already-quoted identifier.
+        const one = (table) => {
+            const row = this.db
+                .prepare(`SELECT COUNT(*) AS n FROM ${table}`)
+                .get();
+            return row.n;
+        };
+        return {
+            game: one('game'),
+            binary: one('binary'),
+            asset: one('asset'),
+            data_store: one('data_store'),
+            function: one('"function"'),
+            xref: one('xref'),
+            symbol: one('symbol'),
+        };
+    }
+    /** Row counts scoped to a single game_id. Convenience for per-game summaries. */
+    countsForGame(gameId) {
+        const one = (table) => {
+            const row = this.db
+                .prepare(`SELECT COUNT(*) AS n FROM ${table} WHERE game_id = ?`)
+                .get(gameId);
+            return row.n;
+        };
+        // Native tables (v2) key on binary_id, so scope them through binary(game_id).
+        const viaBinary = (table) => {
+            const row = this.db
+                .prepare(`SELECT COUNT(*) AS n FROM ${table} t
+           JOIN binary b ON b.id = t.binary_id
+           WHERE b.game_id = ?`)
+                .get(gameId);
+            return row.n;
+        };
+        return {
+            // The game table is keyed on id, not game_id.
+            game: this.db.prepare('SELECT COUNT(*) AS n FROM game WHERE id = ?').get(gameId).n,
+            binary: one('binary'),
+            asset: one('asset'),
+            data_store: one('data_store'),
+            function: viaBinary('"function"'),
+            xref: viaBinary('xref'),
+            symbol: viaBinary('symbol'),
+        };
+    }
+    /** Escape hatch for verifiers/tests that need a raw read. Read-only by convention. */
+    raw() {
+        return this.db;
+    }
+    /** Flush WAL back into the main DB and close the handle. */
+    close() {
+        try {
+            this.db.pragma('wal_checkpoint(TRUNCATE)');
+        }
+        catch {
+            // Best-effort checkpoint; closing is what matters.
+        }
+        this.db.close();
+    }
+}
+//# sourceMappingURL=model-db.js.map

package/dist/core/model-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-db.js","sourceRoot":"","sources":["../../src/core/model-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAmL3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,OAAO,YAAY;IACN,EAAE,CAAoB;IACvB,MAAM,CAAS;IAE/B,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,6EAA6E;QAC7E,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE/B,2DAA2D;QAC3D,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACpC,wEAAwE;QACxE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAEvC,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED,+DAA+D;IACvD,YAAY;QAClB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiEZ,CAAC,CAAC;QAEH,2EAA2E;QAC3E,8EAA8E;QAC9E,uEAAuE;QACvE,gFAAgF;QAChF,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4CZ,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,KAAgB;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;KAkB5B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YACnB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAA+B,CAAC;QAEjC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,GAAG,CAAC,EAAE,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAAkB;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;KAmB5B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YACnB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAA+B,CAAC;QAEjC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,GAAG,CAAC,EAAE,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,KAAiB;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;KAkB5B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YACnB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE;YACxC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAA+B,CAAC;QAEjC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,GAAG,CAAC,EAAE,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,KAAqB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;KAgB5B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YACnB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAA+B,CAAC;QAEjC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,GAAG,CAAC,EAAE,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,KAAoB;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;KAiB5B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YACnB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAA+B,CAAC;QAEjC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,GAAG,CAAC,EAAE,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAgB;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;KAc5B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YACnB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAA+B,CAAC;QAEjC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,GAAG,CAAC,EAAE,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAAkB;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;KAY5B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YACnB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAA+B,CAAC;QAEjC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,GAAG,CAAC,EAAE,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAI,EAAW;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACxC,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,wEAAwE;IACxE,MAAM;QACJ,yEAAyE;QACzE,8EAA8E;QAC9E,MAAM,GAAG,GAAG,CAAC,KAAa,EAAU,EAAE;YACpC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;iBAChB,OAAO,CAAC,6BAA6B,KAAK,EAAE,CAAC;iBAC7C,GAAG,EAAmB,CAAC;YAC1B,OAAO,GAAG,CAAC,CAAC,CAAC;QACf,CAAC,CAAC;QACF,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC;YACjB,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC;YACrB,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC;YACnB,UAAU,EAAE,GAAG,CAAC,YAAY,CAAC;YAC7B,QAAQ,EAAE,GAAG,CAAC,YAAY,CAAC;YAC3B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC;YACjB,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC;SACtB,CAAC;IACJ,CAAC;IAED,iFAAiF;IACjF,aAAa,CAAC,MAAc;QAC1B,MAAM,GAAG,GAAG,CAAC,KAAa,EAAU,EAAE;YACpC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;iBAChB,OAAO,CAAC,6BAA6B,KAAK,oBAAoB,CAAC;iBAC/D,GAAG,CAAC,MAAM,CAAkB,CAAC;YAChC,OAAO,GAAG,CAAC,CAAC,CAAC;QACf,CAAC,CAAC;QACF,8EAA8E;QAC9E,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;iBAChB,OAAO,CACN,6BAA6B,KAAK;;+BAEb,CACtB;iBACA,GAAG,CAAC,MAAM,CAAkB,CAAC;YAChC,OAAO,GAAG,CAAC,CAAC,CAAC;QACf,CAAC,CAAC;QACF,OAAO;YACL,8CAA8C;YAC9C,IAAI,EACF,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC,GAAG,CAAC,MAAM,CAG1E,CAAC,CAAC;YACH,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC;YACrB,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC;YACnB,UAAU,EAAE,GAAG,CAAC,YAAY,CAAC;YAC7B,QAAQ,EAAE,SAAS,CAAC,YAAY,CAAC;YACjC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC;YACvB,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC;SAC5B,CAAC;IACJ,CAAC;IAED,sFAAsF;IACtF,GAAG;QACD,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,4DAA4D;IAC5D,KAAK;QACH,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/core/router.d.ts

@@ -0,0 +1,6 @@
+import { BackendName } from '../backends/child-pool.js';
+export type ToolBackend = 'native' | 'workflow' | BackendName;
+export declare function getToolBackend(toolName: string): ToolBackend | undefined;
+export declare function getAllToolNames(): string[];
+export declare function getToolsByBackend(backend: ToolBackend): string[];
+export declare function isValidTool(toolName: string): boolean;

package/dist/core/router.js

@@ -0,0 +1,143 @@
+// Static route map: tool name -> backend
+const ROUTE_MAP = new Map([
+    // === Detection & Session (workflow) ===
+    ['detect_engine', 'workflow'],
+    ['load_game', 'workflow'],
+    ['game_status', 'workflow'],
+    ['list_available_tools', 'workflow'],
+    ['find_steam_games', 'workflow'],
+    // === Workflow Tools ===
+    ['mod_this_game', 'workflow'],
+    ['find_gameplay_values', 'workflow'],
+    ['build_and_deploy', 'workflow'],
+    ['debug_mod', 'workflow'],
+    ['scaffold_mod', 'workflow'],
+    // === Native Analysis Tools (ported from binary-analyzer-ultra) ===
+    ['analyze_pe_full', 'native'],
+    ['analyze_dll_exports', 'native'],
+    ['analyze_dll_imports', 'native'],
+    ['analyze_file_format', 'native'],
+    ['analyze_memory_layout', 'native'],
+    ['hex_read', 'native'],
+    ['hex_write', 'native'],
+    ['hex_search', 'native'],
+    ['hex_replace', 'native'],
+    ['pattern_scan', 'native'],
+    ['pattern_scan_all', 'native'],
+    ['extract_strings_advanced', 'native'],
+    ['extract_resources_full', 'native'],
+    ['edit_string_table', 'native'],
+    ['inject_resource', 'native'],
+    ['compare_binaries_detailed', 'native'],
+    ['calculate_checksums', 'native'],
+    ['fix_pe_checksum', 'native'],
+    ['rva_to_offset', 'native'],
+    ['offset_to_rva', 'native'],
+    ['disassemble_function', 'native'],
+    ['create_patch', 'native'],
+    ['apply_patch', 'native'],
+    ['compress_file', 'native'],
+    ['decompress_file', 'native'],
+    ['encrypt_decrypt_file', 'native'],
+    ['analyze_wad', 'native'],
+    // IL2CPP native tools
+    ['unity_il2cpp_dump_metadata', 'native'],
+    ['unity_il2cpp_find_class', 'native'],
+    ['actk_scan_obscured_values', 'native'],
+    ['actk_decrypt_value', 'native'],
+    ['actk_struct_info', 'native'],
+    // PlayerPrefs native tools
+    ['unity_playerprefs_read', 'native'],
+    ['unity_playerprefs_write', 'native'],
+    // Godot native tools
+    ['analyze_godot_pck', 'native'],
+    // Game save tools
+    ['analyze_game_save', 'native'],
+    // Smart binary analyzer (ported)
+    ['search_binary_pattern', 'native'],
+    ['extract_dll_classes', 'native'],
+    ['extract_strings', 'native'],
+    ['analyze_dll_structure', 'native'],
+    // === Unity Mono Delegate (-> UnityDecompilerMcp.exe) ===
+    ['load_assembly', 'unity-decompiler'],
+    ['list_types', 'unity-decompiler'],
+    ['inspect_type', 'unity-decompiler'],
+    ['decompile_type', 'unity-decompiler'],
+    ['decompile_method', 'unity-decompiler'],
+    ['get_method_il', 'unity-decompiler'],
+    ['search_code', 'unity-decompiler'],
+    ['find_references', 'unity-decompiler'],
+    ['get_inheritance_tree', 'unity-decompiler'],
+    ['list_monobehaviours', 'unity-decompiler'],
+    ['list_scriptableobjects', 'unity-decompiler'],
+    ['get_serialized_fields', 'unity-decompiler'],
+    ['generate_harmony_patch', 'unity-decompiler'],
+    ['generate_plugin', 'unity-decompiler'],
+    ['compile_plugin', 'unity-decompiler'],
+    ['validate_assembly', 'unity-decompiler'],
+    ['validate_patch_target', 'unity-decompiler'],
+    ['verify_patches', 'unity-decompiler'],
+    ['compare_signatures', 'unity-decompiler'],
+    ['diff_assemblies', 'unity-decompiler'],
+    ['find_renamed_types', 'unity-decompiler'],
+    ['detect_networking', 'unity-decompiler'],
+    ['analyze_bepinex_log', 'unity-decompiler'],
+    ['analyze_save_format', 'unity-decompiler'],
+    ['read_playerprefs', 'unity-decompiler'],
+    ['read_unity_assets_info', 'unity-decompiler'],
+    ['list_patchable_methods', 'unity-decompiler'],
+    // === Unreal Delegate (-> UnrealAssetMcp.exe) ===
+    ['open_game', 'unreal-assets'],
+    ['unreal_game_status', 'unreal-assets'],
+    ['list_assets', 'unreal-assets'],
+    ['search_assets', 'unreal-assets'],
+    ['read_asset', 'unreal-assets'],
+    ['read_asset_export', 'unreal-assets'],
+    ['list_exports', 'unreal-assets'],
+    ['read_blueprint', 'unreal-assets'],
+    ['find_blueprints_of_type', 'unreal-assets'],
+    ['read_datatable', 'unreal-assets'],
+    ['get_class_hierarchy', 'unreal-assets'],
+    // === Java Delegate (-> jar-editor server.py) ===
+    ['jar_open', 'jar-editor'],
+    ['jar_close', 'jar-editor'],
+    ['jar_list', 'jar-editor'],
+    ['jar_list_sessions', 'jar-editor'],
+    ['jar_read_class', 'jar-editor'],
+    ['jar_read_file', 'jar-editor'],
+    ['jar_search', 'jar-editor'],
+    ['jar_search_bytecode', 'jar-editor'],
+    ['jar_search_opcodes', 'jar-editor'],
+    ['jar_inspect_constant_pool', 'jar-editor'],
+    ['jar_edit_class_constants', 'jar-editor'],
+    ['jar_edit_constant_pool', 'jar-editor'],
+    ['jar_edit_file', 'jar-editor'],
+    ['jar_hex_edit', 'jar-editor'],
+    ['jar_hex_view', 'jar-editor'],
+    ['jar_compile_java', 'jar-editor'],
+    ['jar_repack', 'jar-editor'],
+    ['jar_diff', 'jar-editor'],
+    ['jar_add_file', 'jar-editor'],
+    ['jar_add_file_content', 'jar-editor'],
+    ['jar_restore_file', 'jar-editor'],
+    ['jar_scaffold_mod', 'jar-editor'],
+    ['jar_preset_apply', 'jar-editor'],
+    ['jar_preset_list', 'jar-editor'],
+    ['jar_preset_save', 'jar-editor'],
+    ['jar_detect_mod_info', 'jar-editor'],
+]);
+export function getToolBackend(toolName) {
+    return ROUTE_MAP.get(toolName);
+}
+export function getAllToolNames() {
+    return Array.from(ROUTE_MAP.keys());
+}
+export function getToolsByBackend(backend) {
+    return Array.from(ROUTE_MAP.entries())
+        .filter(([_, b]) => b === backend)
+        .map(([name]) => name);
+}
+export function isValidTool(toolName) {
+    return ROUTE_MAP.has(toolName);
+}
+//# sourceMappingURL=router.js.map