@creeperhost/modlens-mcp 1.6.0

package/dist/tools/compat-check.js.map

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

package/dist/tools/compat-check.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compat-check.test.d.ts.map

package/dist/tools/compat-check.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat-check.test.d.ts","sourceRoot":"","sources":["../../src/tools/compat-check.test.ts"],"names":[],"mappings":""}

package/dist/tools/compat-check.test.js

@@ -0,0 +1,179 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { checkModCompat } from "./compat-check.js";
+vi.mock("../processor.js", () => ({ parseJar: vi.fn() }));
+vi.mock("../jar.js", () => ({ listEntries: vi.fn(), extractEntry: vi.fn() }));
+vi.mock("../repositories/mod.js", () => ({
+    listModsSlim: vi.fn(),
+}));
+vi.mock("../security.js", () => ({ validatePath: vi.fn(), normalizeJarPath: (p) => p, assertJarPath: vi.fn() }));
+vi.mock("../db.js", () => ({
+    getDb: vi.fn().mockResolvedValue({
+        $queryRawUnsafe: vi.fn().mockResolvedValue([]),
+    }),
+}));
+import { parseJar } from "../processor.js";
+import { listEntries, extractEntry } from "../jar.js";
+import { listModsSlim } from "../repositories/mod.js";
+import { getDb } from "../db.js";
+const BASE_MANIFEST = {
+    modId: "newmod", displayName: "New Mod", version: "1.0",
+    mcVersion: "1.21", loader: "neoforge",
+    dependencies: [], mixinConfigs: [], hasMixins: false,
+    hasAt: false, hasAw: false,
+    atEntries: [], awEntries: [], mixinTargets: [],
+    description: "", sourceUrl: null,
+    metadataSource: "mods.toml",
+};
+const EXISTING_MOD = {
+    id: 1, modId: "existingmod", displayName: "Existing Mod", version: "2.0",
+    jarPath: "/existing.jar", loader: "neoforge", mcVersion: "1.21",
+};
+beforeEach(() => {
+    vi.resetAllMocks();
+    vi.mocked(listModsSlim).mockResolvedValue([]);
+    vi.mocked(listEntries).mockReturnValue([]);
+    vi.mocked(extractEntry).mockReturnValue(null);
+    vi.mocked(getDb).mockResolvedValue({ $queryRawUnsafe: vi.fn().mockResolvedValue([]) });
+});
+describe("checkModCompat", () => {
+    it("returns no issues for a clean candidate", async () => {
+        vi.mocked(parseJar).mockResolvedValue({ ...BASE_MANIFEST });
+        const result = await checkModCompat("/clean.jar");
+        expect(result.issues).toHaveLength(0);
+        expect(result.summary.safe).toBe(true);
+        expect(result.summary.errors).toBe(0);
+    });
+    it("returns candidate metadata in output", async () => {
+        vi.mocked(parseJar).mockResolvedValue({ ...BASE_MANIFEST });
+        const result = await checkModCompat("/test.jar", "1.21", "neoforge");
+        expect(result.candidate.modId).toBe("newmod");
+        expect(result.candidate.version).toBe("1.0");
+        expect(result.candidate.loader).toBe("neoforge");
+        expect(result.candidate.mcVersion).toBe("1.21");
+        expect(result.candidate.metadataSource).toBe("mods.toml");
+    });
+    it("warns when metadataSource is filename", async () => {
+        vi.mocked(parseJar).mockResolvedValue({ ...BASE_MANIFEST, metadataSource: "filename" });
+        const result = await checkModCompat("/degraded.jar");
+        const degraded = result.issues.find((i) => i.type === "degraded_metadata");
+        expect(degraded).toBeDefined();
+        expect(degraded.severity).toBe("warn");
+    });
+    it("emits info when metadataSource is @Mod annotation", async () => {
+        vi.mocked(parseJar).mockResolvedValue({ ...BASE_MANIFEST, metadataSource: "@Mod annotation" });
+        const result = await checkModCompat("/annotation.jar");
+        const degraded = result.issues.find((i) => i.type === "degraded_metadata");
+        expect(degraded).toBeDefined();
+        expect(degraded.severity).toBe("info");
+    });
+    it("reports mixin conflict as error", async () => {
+        vi.mocked(parseJar).mockResolvedValue({
+            ...BASE_MANIFEST,
+            hasMixins: true,
+            mixinTargets: ["net/minecraft/world/level/Level"],
+        });
+        vi.mocked(getDb).mockResolvedValue({ $queryRawUnsafe: vi.fn().mockResolvedValue([
+                { mod_id: "existingmod", display_name: "Existing Mod", matched: ["net/minecraft/world/level/Level"] },
+            ]) });
+        const result = await checkModCompat("/new.jar");
+        const mixinIssues = result.issues.filter((i) => i.type === "mixin_conflict");
+        expect(mixinIssues).toHaveLength(1);
+        expect(mixinIssues[0].severity).toBe("error");
+        expect(mixinIssues[0].relatedMod).toBe("existingmod");
+        expect(mixinIssues[0].path).toBe("net/minecraft/world/level/Level");
+        expect(result.summary.safe).toBe(false);
+    });
+    it("reports multiple mixin conflicts across different mods", async () => {
+        vi.mocked(parseJar).mockResolvedValue({
+            ...BASE_MANIFEST,
+            hasMixins: true,
+            mixinTargets: ["net/minecraft/world/level/Level", "net/minecraft/server/level/ServerLevel"],
+        });
+        vi.mocked(getDb).mockResolvedValue({ $queryRawUnsafe: vi.fn().mockResolvedValue([
+                { mod_id: "mod_a", display_name: "Mod A", matched: ["net/minecraft/world/level/Level"] },
+                { mod_id: "mod_b", display_name: "Mod B", matched: ["net/minecraft/server/level/ServerLevel"] },
+            ]) });
+        const result = await checkModCompat("/new.jar");
+        expect(result.summary.errors).toBe(2);
+        expect(result.issues.filter((i) => i.type === "mixin_conflict")).toHaveLength(2);
+    });
+    it("skips mixin check when candidate has no mixin targets", async () => {
+        vi.mocked(parseJar).mockResolvedValue({ ...BASE_MANIFEST, mixinTargets: [] });
+        await checkModCompat("/new.jar");
+        const result = await checkModCompat("/new.jar");
+        expect(result.issues.filter((i) => i.type === "mixin_conflict")).toHaveLength(0);
+    });
+    it("reports asset conflict as warn", async () => {
+        vi.mocked(parseJar).mockResolvedValue({ ...BASE_MANIFEST });
+        vi.mocked(listModsSlim).mockResolvedValue([EXISTING_MOD]);
+        // listEntries: first call (candidate assets), second call (existing mod assets)
+        vi.mocked(listEntries)
+            .mockReturnValueOnce(["assets/newmod/textures/item/thing.png"]) // candidate
+            .mockReturnValueOnce(["assets/newmod/textures/item/thing.png"]); // existing mod
+        const result = await checkModCompat("/new.jar");
+        const assetIssues = result.issues.filter((i) => i.type === "asset_conflict");
+        expect(assetIssues).toHaveLength(1);
+        expect(assetIssues[0].severity).toBe("warn");
+        expect(assetIssues[0].relatedMod).toBe("existingmod");
+    });
+    it("reports missing dep as warn", async () => {
+        vi.mocked(parseJar).mockResolvedValue({
+            ...BASE_MANIFEST,
+            dependencies: [{ id: "missinglib", version: ">=1.0", required: true }],
+        });
+        vi.mocked(listModsSlim).mockResolvedValue([]);
+        const result = await checkModCompat("/new.jar");
+        const depIssues = result.issues.filter((i) => i.type === "missing_dep");
+        expect(depIssues).toHaveLength(1);
+        expect(depIssues[0].severity).toBe("warn");
+        expect(depIssues[0].detail).toContain("missinglib");
+    });
+    it("ignores loader-level pseudo-deps in missing dep check", async () => {
+        vi.mocked(parseJar).mockResolvedValue({
+            ...BASE_MANIFEST,
+            dependencies: [
+                { id: "minecraft", version: "1.21", required: true },
+                { id: "neoforge", version: ">=21", required: true },
+                { id: "java", version: ">=21", required: true },
+            ],
+        });
+        vi.mocked(listModsSlim).mockResolvedValue([]);
+        const result = await checkModCompat("/new.jar");
+        expect(result.issues.filter((i) => i.type === "missing_dep")).toHaveLength(0);
+    });
+    it("does not report missing dep when dep is ingested", async () => {
+        vi.mocked(parseJar).mockResolvedValue({
+            ...BASE_MANIFEST,
+            dependencies: [{ id: "presentlib", version: "1.0", required: true }],
+        });
+        vi.mocked(listModsSlim).mockResolvedValue([
+            { id: 5, modId: "presentlib", displayName: "Present Lib", version: "1.0", jarPath: "/lib.jar", loader: "neoforge", mcVersion: "1.21" },
+        ]);
+        const result = await checkModCompat("/new.jar");
+        expect(result.issues.filter((i) => i.type === "missing_dep")).toHaveLength(0);
+    });
+    it("summary.safe is false when there are errors", async () => {
+        vi.mocked(parseJar).mockResolvedValue({
+            ...BASE_MANIFEST,
+            hasMixins: true,
+            mixinTargets: ["net/minecraft/world/level/Level"],
+        });
+        vi.mocked(getDb).mockResolvedValue({ $queryRawUnsafe: vi.fn().mockResolvedValue([
+                { mod_id: "other", display_name: "Other", matched: ["net/minecraft/world/level/Level"] },
+            ]) });
+        const result = await checkModCompat("/new.jar");
+        expect(result.summary.safe).toBe(false);
+        expect(result.summary.errors).toBeGreaterThan(0);
+    });
+    it("summary.safe is true when only warnings", async () => {
+        vi.mocked(parseJar).mockResolvedValue({
+            ...BASE_MANIFEST,
+            dependencies: [{ id: "missinglib", version: "*", required: false }],
+        });
+        vi.mocked(listModsSlim).mockResolvedValue([]);
+        const result = await checkModCompat("/new.jar");
+        expect(result.summary.safe).toBe(true);
+        expect(result.summary.warnings).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=compat-check.test.js.map

package/dist/tools/compat-check.test.js.map

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

package/dist/tools/diagnostics.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Diagnostics tools for modpack developers.
+ *
+ * - analyzeCrashLog: rank suspect mods from a NeoForge/Fabric/Forge crash log
+ *   by cross-referencing stack frames with the ModClass index.
+ * - findMissingDeps: find declared dependencies not satisfied by ingested mods.
+ */
+export declare function analyzeCrashLog(logText: string): Promise<object>;
+export declare function findMissingDeps(mcVersion?: string, loader?: string): Promise<object>;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/tools/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/tools/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2EtE;AAED,wBAAsB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyD1F"}

package/dist/tools/diagnostics.js

@@ -0,0 +1,133 @@
+/**
+ * Diagnostics tools for modpack developers.
+ *
+ * - analyzeCrashLog: rank suspect mods from a NeoForge/Fabric/Forge crash log
+ *   by cross-referencing stack frames with the ModClass index.
+ * - findMissingDeps: find declared dependencies not satisfied by ingested mods.
+ */
+import { findModClassesByClassNames, listAllMods } from "../repositories/mod.js";
+// Loader-level pseudo-deps that are never in the mod DB
+const SKIP_DEP_IDS = new Set([
+    "minecraft", "neoforge", "forge", "fabric-api",
+    "fabricloader", "quilt_loader", "java",
+]);
+const MAX_SUSPECTS = 10;
+export async function analyzeCrashLog(logText) {
+    const FRAME_RE = /\tat ([\w.$]+)\.([\w$<>[\]]+)\(/g;
+    const rawFrames = [];
+    for (const m of logText.matchAll(FRAME_RE)) {
+        rawFrames.push(m[1].replace(/\./g, "/"));
+    }
+    if (rawFrames.length === 0) {
+        return {
+            suspects: [],
+            modsInLogSection: [],
+            totalFrames: 0,
+            recognizedFrames: 0,
+            unrecognizedFrames: 0,
+        };
+    }
+    const uniqueClasses = [...new Set(rawFrames)];
+    const rows = await findModClassesByClassNames(uniqueClasses);
+    // className → mod info
+    const classToMod = new Map();
+    for (const row of rows) {
+        classToMod.set(row.className, { modId: row.mod.modId, dbId: row.modId, display: row.mod.displayName });
+    }
+    // Accumulate per-mod frame lists (deduped class names) and frame counts
+    const modInfo = new Map();
+    let recognized = 0;
+    for (const cls of rawFrames) {
+        const mod = classToMod.get(cls);
+        if (!mod)
+            continue;
+        recognized++;
+        const entry = modInfo.get(mod.dbId) ?? { modId: mod.modId, display: mod.display, dbId: mod.dbId, frames: [] };
+        if (!entry.frames.includes(cls))
+            entry.frames.push(cls);
+        modInfo.set(mod.dbId, entry);
+    }
+    // Build suspect list sorted by raw frame count (counts duplicates)
+    const suspects = [...modInfo.values()]
+        .map((s) => ({
+        modId: s.modId,
+        display: s.display,
+        dbId: s.dbId,
+        frameCount: rawFrames.filter((c) => classToMod.get(c)?.dbId === s.dbId).length,
+        frames: s.frames.slice(0, 5),
+    }))
+        .sort((a, b) => b.frameCount - a.frameCount)
+        .slice(0, MAX_SUSPECTS);
+    // Parse "-- Mod List --" section (NeoForge crash format)
+    const modsInLogSection = [];
+    const modListMatch = logText.match(/-- Mod List --\n([\s\S]*?)(?:\n--|$)/);
+    if (modListMatch) {
+        for (const line of modListMatch[1].split("\n")) {
+            const m = line.match(/^\s*(\S+)\|/);
+            if (m)
+                modsInLogSection.push(m[1].trim());
+        }
+    }
+    const unrecognized = rawFrames.length - recognized;
+    const coverageWarning = rawFrames.length >= 5 && unrecognized / rawFrames.length > 0.5
+        ? `${unrecognized}/${rawFrames.length} stack frames could not be matched to ingested mods. Run reindex_classes to improve coverage.`
+        : undefined;
+    return {
+        suspects,
+        modsInLogSection,
+        totalFrames: rawFrames.length,
+        recognizedFrames: recognized,
+        unrecognizedFrames: unrecognized,
+        ...(coverageWarning ? { coverageWarning } : {}),
+    };
+}
+export async function findMissingDeps(mcVersion, loader) {
+    const allMods = await listAllMods();
+    // Full ingested modId set (not filtered — deps may cross mcVersion boundaries)
+    const ingestedIds = new Set(allMods.map((m) => m.modId));
+    // Filter comparison pool to mcVersion/loader if requested
+    const pool = allMods.filter((m) => {
+        if (mcVersion && !m.mcVersion.includes(mcVersion))
+            return false;
+        if (loader && m.loader !== loader)
+            return false;
+        return true;
+    });
+    const missing = [];
+    let satisfied = 0;
+    for (const mod of pool) {
+        let deps = [];
+        try {
+            const raw = mod.dependencies;
+            deps = Array.isArray(raw) ? raw : [];
+        }
+        catch {
+            deps = [];
+        }
+        for (const dep of deps) {
+            if (!dep.id || SKIP_DEP_IDS.has(dep.id))
+                continue;
+            if (ingestedIds.has(dep.id)) {
+                satisfied++;
+            }
+            else {
+                missing.push({
+                    requiredBy: mod.modId,
+                    requiredByDisplay: mod.displayName,
+                    depModId: dep.id,
+                    versionRange: dep.version ?? "*",
+                    mandatory: dep.required ?? true,
+                });
+            }
+        }
+    }
+    return {
+        mcVersion: mcVersion ?? "all",
+        loader: loader ?? "all",
+        modsChecked: pool.length,
+        missing,
+        satisfied,
+        unsatisfied: missing.length,
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/tools/diagnostics.js.map

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

package/dist/tools/diagnostics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diagnostics.test.d.ts.map

package/dist/tools/diagnostics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.test.d.ts","sourceRoot":"","sources":["../../src/tools/diagnostics.test.ts"],"names":[],"mappings":""}

package/dist/tools/diagnostics.test.js

@@ -0,0 +1,168 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { analyzeCrashLog, findMissingDeps } from "./diagnostics.js";
+vi.mock("../repositories/mod.js", () => ({
+    findModClassesByClassNames: vi.fn(),
+    listAllMods: vi.fn(),
+}));
+import { findModClassesByClassNames, listAllMods } from "../repositories/mod.js";
+const SAMPLE_CRASH = `
+---- Minecraft Crash Report ----
+java.lang.NullPointerException: Cannot invoke method
+\tat net.minecraft.world.level.Level.tickChunk(Level.java:345)
+\tat com.example.mymod.MyWorldMixin.tickChunk(MyWorldMixin.java:12)
+\tat net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:890)
+\tat com.example.other.OtherMixin.runServer(OtherMixin.java:5)
+\tat com.example.other.OtherMixin.extra(OtherMixin.java:30)
+
+-- Mod List --
+mymod|1.0
+othermod|2.0
+`;
+describe("analyzeCrashLog", () => {
+    beforeEach(() => vi.resetAllMocks());
+    it("ranks mods by frame count and returns suspects", async () => {
+        vi.mocked(findModClassesByClassNames).mockResolvedValue([
+            { className: "com/example/mymod/MyWorldMixin", modId: 1, mod: { modId: "mymod", displayName: "My Mod" } },
+            { className: "com/example/other/OtherMixin", modId: 2, mod: { modId: "othermod", displayName: "Other Mod" } },
+        ]);
+        const result = await analyzeCrashLog(SAMPLE_CRASH);
+        expect(result.suspects).toHaveLength(2);
+        // othermod appears in 2 frames — should rank first
+        expect(result.suspects[0].modId).toBe("othermod");
+        expect(result.suspects[0].frameCount).toBe(2);
+        expect(result.suspects[1].modId).toBe("mymod");
+        expect(result.suspects[1].frameCount).toBe(1);
+    });
+    it("reports unrecognized frames and emits coverageWarning", async () => {
+        vi.mocked(findModClassesByClassNames).mockResolvedValue([]);
+        const result = await analyzeCrashLog(SAMPLE_CRASH);
+        expect(result.unrecognizedFrames).toBeGreaterThan(0);
+        expect(result.coverageWarning).toBeDefined();
+        expect(result.coverageWarning).toContain("reindex_classes");
+    });
+    it("returns empty suspects for empty log", async () => {
+        vi.mocked(findModClassesByClassNames).mockResolvedValue([]);
+        const result = await analyzeCrashLog("");
+        expect(result.suspects).toHaveLength(0);
+        expect(result.totalFrames).toBe(0);
+    });
+    it("parses -- Mod List -- section", async () => {
+        vi.mocked(findModClassesByClassNames).mockResolvedValue([]);
+        const result = await analyzeCrashLog(SAMPLE_CRASH);
+        expect(result.modsInLogSection).toContain("mymod");
+        expect(result.modsInLogSection).toContain("othermod");
+    });
+    it("does not emit coverageWarning when all frames recognized", async () => {
+        vi.mocked(findModClassesByClassNames).mockResolvedValue([
+            { className: "com/example/mymod/MyWorldMixin", modId: 1, mod: { modId: "mymod", displayName: "My Mod" } },
+            { className: "com/example/other/OtherMixin", modId: 2, mod: { modId: "othermod", displayName: "Other Mod" } },
+            { className: "net/minecraft/world/level/Level", modId: 3, mod: { modId: "mcmod", displayName: "MC Mod" } },
+            { className: "net/minecraft/server/MinecraftServer", modId: 3, mod: { modId: "mcmod", displayName: "MC Mod" } },
+        ]);
+        const result = await analyzeCrashLog(SAMPLE_CRASH);
+        expect(result.coverageWarning).toBeUndefined();
+    });
+    it("caps suspects at 10", async () => {
+        // Build a crash log with 15 different mods
+        const lines = Array.from({ length: 15 }, (_, i) => `\tat com.example.mod${i}.Mixin.method(Mixin.java:1)`).join("\n");
+        vi.mocked(findModClassesByClassNames).mockResolvedValue(Array.from({ length: 15 }, (_, i) => ({
+            className: `com/example/mod${i}/Mixin`,
+            modId: i + 1,
+            mod: { modId: `mod${i}`, displayName: `Mod ${i}` },
+        })));
+        const result = await analyzeCrashLog(lines);
+        expect(result.suspects.length).toBeLessThanOrEqual(10);
+    });
+});
+describe("findMissingDeps", () => {
+    beforeEach(() => vi.resetAllMocks());
+    it("flags a mod dependency that is not ingested", async () => {
+        vi.mocked(listAllMods).mockResolvedValue([
+            {
+                id: 1, modId: "mymod", displayName: "My Mod", version: "1.0",
+                mcVersion: "1.21", loader: "neoforge", jarPath: "/a.jar",
+                dependencies: [
+                    { id: "requiredmod", version: ">=1.0", required: true },
+                    { id: "minecraft", version: "1.21", required: true },
+                ],
+            },
+        ]);
+        const result = await findMissingDeps();
+        expect(result.unsatisfied).toBe(1);
+        expect(result.missing[0].depModId).toBe("requiredmod");
+        expect(result.missing[0].requiredBy).toBe("mymod");
+        expect(result.missing[0].mandatory).toBe(true);
+    });
+    it("ignores loader-level pseudo-deps", async () => {
+        vi.mocked(listAllMods).mockResolvedValue([
+            {
+                id: 1, modId: "mymod", displayName: "My Mod", version: "1.0",
+                mcVersion: "1.21", loader: "neoforge", jarPath: "/a.jar",
+                dependencies: [
+                    { id: "minecraft", version: "1.21", required: true },
+                    { id: "neoforge", version: ">=21", required: true },
+                    { id: "java", version: ">=21", required: true },
+                    { id: "fabric-api", version: "*", required: false },
+                    { id: "fabricloader", version: "*", required: false },
+                    { id: "quilt_loader", version: "*", required: false },
+                    { id: "forge", version: "*", required: false },
+                ],
+            },
+        ]);
+        const result = await findMissingDeps();
+        expect(result.unsatisfied).toBe(0);
+        expect(result.missing).toHaveLength(0);
+    });
+    it("reports satisfied when dep is ingested", async () => {
+        vi.mocked(listAllMods).mockResolvedValue([
+            {
+                id: 1, modId: "mymod", displayName: "My Mod", version: "1.0",
+                mcVersion: "1.21", loader: "neoforge", jarPath: "/a.jar",
+                dependencies: [{ id: "lib", version: "1.0", required: true }],
+            },
+            {
+                id: 2, modId: "lib", displayName: "Lib", version: "1.0",
+                mcVersion: "1.21", loader: "neoforge", jarPath: "/lib.jar",
+                dependencies: [],
+            },
+        ]);
+        const result = await findMissingDeps();
+        expect(result.satisfied).toBe(1);
+        expect(result.unsatisfied).toBe(0);
+    });
+    it("filters pool by mcVersion", async () => {
+        vi.mocked(listAllMods).mockResolvedValue([
+            {
+                id: 1, modId: "oldmod", displayName: "Old Mod", version: "1.0",
+                mcVersion: "1.20", loader: "neoforge", jarPath: "/old.jar",
+                dependencies: [{ id: "missingdep", version: "*", required: true }],
+            },
+            {
+                id: 2, modId: "newmod", displayName: "New Mod", version: "1.0",
+                mcVersion: "1.21", loader: "neoforge", jarPath: "/new.jar",
+                dependencies: [],
+            },
+        ]);
+        // Filter to 1.21 — oldmod (1.20) should be excluded from pool
+        const result = await findMissingDeps("1.21");
+        expect(result.modsChecked).toBe(1);
+        expect(result.unsatisfied).toBe(0);
+    });
+    it("handles mods with empty or null dependencies gracefully", async () => {
+        vi.mocked(listAllMods).mockResolvedValue([
+            {
+                id: 1, modId: "nodeps", displayName: "No Deps", version: "1.0",
+                mcVersion: "1.21", loader: "neoforge", jarPath: "/nd.jar",
+                dependencies: [],
+            },
+            {
+                id: 2, modId: "nulldeps", displayName: "Null Deps", version: "1.0",
+                mcVersion: "1.21", loader: "neoforge", jarPath: "/null.jar",
+                dependencies: null,
+            },
+        ]);
+        const result = await findMissingDeps();
+        expect(result.unsatisfied).toBe(0);
+    });
+});
+//# sourceMappingURL=diagnostics.test.js.map

package/dist/tools/diagnostics.test.js.map

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

package/dist/tools/docs.d.ts

@@ -0,0 +1,19 @@
+export interface DocEntryInput {
+    className?: string;
+    title: string;
+    summary?: string;
+    url: string;
+    category?: string;
+    namespace?: string;
+    tags?: string[];
+    source?: string;
+}
+export declare function ingestDocumentation(entries: DocEntryInput[]): Promise<object>;
+export declare function getDocumentation(query: string): Promise<object>;
+export declare function searchDocumentation(query: string, category?: string, namespace?: string): Promise<object>;
+export declare function listDocumentation(category?: string, namespace?: string, tag?: string, limit?: number): Promise<object>;
+export declare function deleteDocumentation(id: number): Promise<object>;
+export declare function seedDefaultDocumentation(): Promise<object>;
+export declare function semanticSearchDocumentation(query: string, limit?: number): Promise<object>;
+export declare function backfillDocEmbeddings(): Promise<object>;
+//# sourceMappingURL=docs.d.ts.map

package/dist/tools/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/tools/docs.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,aAAa;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCnF;AAGD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBrE;AAGD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB/G;AAGD,wBAAsB,iBAAiB,CACnC,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,EACZ,KAAK,SAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAcjB;AAGD,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMrE;AAqDD,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAGhE;AAeD,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAU5F;AAID,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAiB7D"}