@adhisang/minecraft-modding-mcp 3.1.1 → 4.0.0

package/dist/storage/artifacts-repo.d.ts

@@ -3,6 +3,7 @@ import type { ArtifactProvenance, ArtifactRow, SourceMapping, SourceOrigin } fro
 type SqliteDatabase = InstanceType<typeof Database>;
 interface UpsertArtifactInput {
     artifactId: string;
+    alias?: string;
     origin: SourceOrigin;
     coordinate?: string;
     version?: string;
@@ -27,6 +28,7 @@ export declare class ArtifactsRepo {
     private readonly upsertStmt;
     private readonly getStmt;
     private readonly touchStmt;
+    private readonly setAliasStmt;
     private readonly deleteStmt;
     private readonly listStmt;
     private readonly countStmt;
@@ -34,8 +36,9 @@ export declare class ArtifactsRepo {
     private readonly listLruWithContentBytesStmt;
     constructor(db: SqliteDatabase);
     upsertArtifact(input: UpsertArtifactInput): void;
-    getArtifact(artifactId: string): ArtifactRow | undefined;
+    getArtifact(artifactIdOrAlias: string): ArtifactRow | undefined;
     touchArtifact(artifactId: string, timestamp: string): void;
+    setAlias(artifactId: string, alias: string): void;
     deleteArtifact(artifactId: string): void;
     listArtifactsByLru(limit: number): ArtifactRow[];
     countArtifacts(): number;

package/dist/storage/artifacts-repo.js

@@ -35,6 +35,7 @@ function parseQualityFlags(value) {
 function toArtifactRow(record) {
     return {
         artifactId: record.artifact_id,
+        alias: record.alias ?? undefined,
         origin: record.origin,
         coordinate: record.coordinate ?? undefined,
         version: record.version ?? undefined,
@@ -59,6 +60,7 @@ export class ArtifactsRepo {
     upsertStmt;
     getStmt;
     touchStmt;
+    setAliasStmt;
     deleteStmt;
     listStmt;
     countStmt;
@@ -68,11 +70,12 @@ export class ArtifactsRepo {
         this.db = db;
         this.upsertStmt = this.db.prepare(`
       INSERT INTO artifacts (
-        artifact_id, origin, coordinate, version, binary_jar_path, source_jar_path, repo_url, requested_mapping, mapping_applied, provenance_json, quality_flags_json, artifact_signature, is_decompiled, created_at, updated_at
+        artifact_id, alias, origin, coordinate, version, binary_jar_path, source_jar_path, repo_url, requested_mapping, mapping_applied, provenance_json, quality_flags_json, artifact_signature, is_decompiled, created_at, updated_at
       ) VALUES (
-        @artifact_id, @origin, @coordinate, @version, @binary_jar_path, @source_jar_path, @repo_url, @requested_mapping, @mapping_applied, @provenance_json, @quality_flags_json, @artifact_signature, @is_decompiled, @created_at, @updated_at
+        @artifact_id, @alias, @origin, @coordinate, @version, @binary_jar_path, @source_jar_path, @repo_url, @requested_mapping, @mapping_applied, @provenance_json, @quality_flags_json, @artifact_signature, @is_decompiled, @created_at, @updated_at
       )
       ON CONFLICT(artifact_id) DO UPDATE SET
+        alias = excluded.alias,
         origin = excluded.origin,
         coordinate = excluded.coordinate,
         version = excluded.version,
@@ -87,9 +90,12 @@ export class ArtifactsRepo {
         is_decompiled = excluded.is_decompiled,
         updated_at = excluded.updated_at
     `);
+        // artifact_id is a 64-char SHA hex; alias is `<type>-<...>-<6charhex>` containing
+        // dashes/letters. The two namespaces cannot collide, so OR-matching is unambiguous.
         this.getStmt = this.db.prepare(`
       SELECT
         artifact_id,
+        alias,
         origin,
         coordinate,
         version,
@@ -105,17 +111,28 @@ export class ArtifactsRepo {
         created_at,
         updated_at
       FROM artifacts
-      WHERE artifact_id = ?
+      WHERE artifact_id = ? OR alias = ?
+      LIMIT 1
     `);
         this.touchStmt = this.db.prepare(`
       UPDATE artifacts
       SET updated_at = ?
       WHERE artifact_id = ?
+    `);
+        // Persists alias on cache-hit / migrated-row paths where upsertArtifact would
+        // otherwise be skipped. Conditional WHERE keeps it idempotent and avoids a
+        // pointless write when alias is already correct.
+        this.setAliasStmt = this.db.prepare(`
+      UPDATE artifacts
+      SET alias = ?
+      WHERE artifact_id = ?
+        AND (alias IS NULL OR alias <> ?)
     `);
         this.deleteStmt = this.db.prepare(`DELETE FROM artifacts WHERE artifact_id = ?`);
         this.listStmt = this.db.prepare(`
       SELECT
         artifact_id,
+        alias,
         origin,
         coordinate,
         version,
@@ -157,6 +174,7 @@ export class ArtifactsRepo {
     upsertArtifact(input) {
         this.upsertStmt.run({
             artifact_id: input.artifactId,
+            alias: input.alias ?? null,
             origin: input.origin,
             coordinate: input.coordinate ?? null,
             version: input.version ?? null,
@@ -173,8 +191,11 @@ export class ArtifactsRepo {
             updated_at: input.timestamp
         });
     }
-    getArtifact(artifactId) {
-        const row = this.getStmt.get([artifactId]);
+    // Accepts either an artifact_id (64-char SHA hex) or a human-readable alias
+    // (e.g. `mc-1.21.10-mojang-merged-5ad2e7`). The two key namespaces cannot
+    // collide because aliases always contain `-` and a non-hex prefix.
+    getArtifact(artifactIdOrAlias) {
+        const row = this.getStmt.get([artifactIdOrAlias, artifactIdOrAlias]);
         if (!row) {
             return undefined;
         }
@@ -183,6 +204,13 @@ export class ArtifactsRepo {
     touchArtifact(artifactId, timestamp) {
         this.touchStmt.run([timestamp, artifactId]);
     }
+    // Backfills or rotates the alias for an existing row. Used by warm-cache
+    // resolveArtifact paths where upsertArtifact is skipped, so a freshly
+    // computed alias still reaches the DB and stays in sync with the value the
+    // caller just received in the response.
+    setAlias(artifactId, alias) {
+        this.setAliasStmt.run([alias, artifactId, alias]);
+    }
     deleteArtifact(artifactId) {
         this.deleteStmt.run([artifactId]);
     }

package/dist/storage/files-repo.d.ts

@@ -43,8 +43,6 @@ export declare class FilesRepo {
     private readonly db;
     private readonly deleteStmt;
     private readonly insertFilesStmt;
-    private readonly insertFtsStmt;
-    private readonly deleteFtsStmt;
     private readonly getContentStmt;
     private readonly listStmt;
     private readonly listRowsStmt;

package/dist/storage/files-repo.js

@@ -125,8 +125,6 @@ export class FilesRepo {
     db;
     deleteStmt;
     insertFilesStmt;
-    insertFtsStmt;
-    deleteFtsStmt;
     getContentStmt;
     listStmt;
     listRowsStmt;
@@ -138,17 +136,10 @@ export class FilesRepo {
         this.db = db;
         this.deleteStmt = this.db.prepare(`
       DELETE FROM files WHERE artifact_id = ?
-    `);
-        this.deleteFtsStmt = this.db.prepare(`
-      DELETE FROM files_fts WHERE artifact_id = ?
     `);
         this.insertFilesStmt = this.db.prepare(`
       INSERT INTO files (artifact_id, file_path, content, content_bytes, content_hash)
       VALUES (?, ?, ?, ?, ?)
-    `);
-        this.insertFtsStmt = this.db.prepare(`
-      INSERT INTO files_fts (artifact_id, file_path, content)
-      VALUES (?, ?, ?)
     `);
         this.getContentStmt = this.db.prepare(`
       SELECT artifact_id, file_path, content, content_bytes, content_hash
@@ -187,7 +178,6 @@ export class FilesRepo {
     }
     clearFilesForArtifact(artifactId) {
         this.deleteStmt.run([artifactId]);
-        this.deleteFtsStmt.run([artifactId]);
     }
     insertFilesForArtifact(artifactId, files) {
         for (const file of files) {
@@ -199,7 +189,6 @@ export class FilesRepo {
                 file.contentBytes,
                 contentHash
             ]);
-            this.insertFtsStmt.run([artifactId, file.filePath, file.content]);
         }
     }
     replaceFilesForArtifact(artifactId, files) {

package/dist/storage/migrations.d.ts

@@ -6,6 +6,6 @@ type MigrationRunner = {
     };
     transaction<T>(fn: () => T): () => T;
 };
-export declare const LATEST_SCHEMA_VERSION = 2;
+export declare const LATEST_SCHEMA_VERSION = 4;
 export declare function runMigrations(db: MigrationRunner): number;
 export {};

package/dist/storage/migrations.js

@@ -1,6 +1,6 @@
 import { createError, ERROR_CODES } from "../errors.js";
-import { SCHEMA_V1_STATEMENTS, SCHEMA_V2_STATEMENTS } from "./schema.js";
-export const LATEST_SCHEMA_VERSION = 2;
+import { SCHEMA_V1_STATEMENTS, SCHEMA_V2_STATEMENTS, SCHEMA_V3_STATEMENTS, SCHEMA_V4_STATEMENTS } from "./schema.js";
+export const LATEST_SCHEMA_VERSION = 4;
 const migrations = [
     {
         version: 1,
@@ -9,6 +9,14 @@ const migrations = [
     {
         version: 2,
         statements: SCHEMA_V2_STATEMENTS
+    },
+    {
+        version: 3,
+        statements: SCHEMA_V3_STATEMENTS
+    },
+    {
+        version: 4,
+        statements: SCHEMA_V4_STATEMENTS
     }
 ];
 function selectSchemaVersion(tx) {

package/dist/storage/schema.d.ts

@@ -1,2 +1,4 @@
 export declare const SCHEMA_V1_STATEMENTS: string[];
 export declare const SCHEMA_V2_STATEMENTS: string[];
+export declare const SCHEMA_V4_STATEMENTS: string[];
+export declare const SCHEMA_V3_STATEMENTS: string[];

package/dist/storage/schema.js

@@ -164,4 +164,29 @@ export const SCHEMA_V2_STATEMENTS = [
     `DELETE FROM artifact_index_meta`,
     `DELETE FROM artifacts`
 ];
+export const SCHEMA_V4_STATEMENTS = [
+    `ALTER TABLE artifacts ADD COLUMN alias TEXT`,
+    `CREATE UNIQUE INDEX IF NOT EXISTS idx_artifacts_alias ON artifacts(alias) WHERE alias IS NOT NULL`
+];
+export const SCHEMA_V3_STATEMENTS = [
+    `DROP TABLE IF EXISTS files_fts`,
+    `CREATE VIRTUAL TABLE files_fts USING fts5(
+    artifact_id UNINDEXED,
+    file_path,
+    content,
+    content='files',
+    content_rowid='rowid',
+    tokenize = 'unicode61 separators ''._$'''
+  )`,
+    `CREATE TRIGGER IF NOT EXISTS trg_fts_insert AFTER INSERT ON files BEGIN
+    INSERT INTO files_fts(rowid, artifact_id, file_path, content)
+    VALUES (NEW.rowid, NEW.artifact_id, NEW.file_path, NEW.content);
+  END`,
+    // No UPDATE trigger: FilesRepo uses delete+insert, never updates rows in place.
+    `CREATE TRIGGER IF NOT EXISTS trg_fts_delete BEFORE DELETE ON files BEGIN
+    INSERT INTO files_fts(files_fts, rowid, artifact_id, file_path, content)
+    VALUES ('delete', OLD.rowid, OLD.artifact_id, OLD.file_path, OLD.content);
+  END`,
+    `INSERT INTO files_fts(files_fts) VALUES('rebuild')`
+];
 //# sourceMappingURL=schema.js.map

package/dist/tool-contract-manifest.js

@@ -15,7 +15,7 @@ const SECTION_ROWS = {
             "| `analyze-symbol` | Handle symbol existence checks, namespace mapping, lifecycle tracing, workspace symbol resolution, and API overviews |",
             "| `compare-minecraft` | Compare version pairs, class diffs, registry diffs, and migration-oriented summaries |",
             "| `analyze-mod` | Summarize mod metadata, decompile and search mod code, inspect class source, and preview or apply remaps |",
-            "| `validate-project` | Summarize workspaces and run direct Mixin or Access Widener validation |",
+            "| `validate-project` | Summarize workspaces and run direct Mixin, Access Widener, or Access Transformer validation |",
             "| `manage-cache` | List, verify, and preview or apply cache cleanup and rebuild operations |"
         ],
         ja: [
@@ -23,7 +23,7 @@ const SECTION_ROWS = {
             "| `analyze-symbol` | シンボル存在確認、名前空間変換、ライフサイクル追跡、ワークスペースシンボル解決、API 概要をまとめて扱う |",
             "| `compare-minecraft` | バージョン差分、クラス差分、レジストリ差分、移行向け概要を比較する |",
             "| `analyze-mod` | Mod メタデータの要約、Mod コードのデコンパイル / 検索、クラスソース確認、リマップのプレビュー / 実行を扱う |",
-            "| `validate-project` | ワークスペース要約と、Mixin / Access Widener の直接検証を行う |",
+            "| `validate-project` | ワークスペース要約と、Mixin / Access Widener / Access Transformer の直接検証を行う |",
             "| `manage-cache` | キャッシュの一覧、検証、クリーンアップ / 再構築のプレビュー / 実行を行う |"
         ]
     },
@@ -93,14 +93,14 @@ const SECTION_ROWS = {
     },
     "mod-analysis": {
         en: [
-            "| `analyze-mod-jar` | Extract mod metadata, dependencies, entrypoints, and mixin config info from a JAR |",
+            "| `analyze-mod-jar` | Extract mod metadata, dependencies, entrypoints, mixin config info, and packaged access transformer paths from a JAR |",
             "| `decompile-mod-jar` | Decompile a mod JAR and optionally return one class source |",
             "| `get-mod-class-source` | Read one class source from the decompiled mod cache |",
             "| `search-mod-source` | Search decompiled mod source by class, method, field, or content |",
             "| `remap-mod-jar` | Remap a Fabric or Quilt mod JAR to `yarn` or `mojang` names |"
         ],
         ja: [
-            "| `analyze-mod-jar` | JAR から Mod メタデータ、依存関係、エントリポイント、Mixin 設定情報を抽出する |",
+            "| `analyze-mod-jar` | JAR から Mod メタデータ、依存関係、エントリポイント、Mixin 設定情報、同梱 Access Transformer パスを抽出する |",
             "| `decompile-mod-jar` | Mod JAR をデコンパイルし、必要に応じて 1 つのクラスソースを返す |",
             "| `get-mod-class-source` | デコンパイル済み Mod キャッシュから 1 つのクラスソースを読み取る |",
             "| `search-mod-source` | デコンパイル済み Mod ソースを class、method、field、content で検索する |",
@@ -110,11 +110,13 @@ const SECTION_ROWS = {
     "validation": {
         en: [
             "| `validate-mixin` | Validate Mixin source against a target Minecraft version |",
-            "| `validate-access-widener` | Validate Access Widener content against a target Minecraft version |"
+            "| `validate-access-widener` | Validate Access Widener content against a target Minecraft version, optionally using runtime-aware Loom artifacts |",
+            "| `validate-access-transformer` | Validate Access Transformer content against a target Minecraft version, optionally using Forge/NeoForge runtime artifacts |"
         ],
         ja: [
             "| `validate-mixin` | 対象 Minecraft バージョンに対して Mixin ソースを検証する |",
-            "| `validate-access-widener` | 対象 Minecraft バージョンに対して Access Widener の内容を検証する |"
+            "| `validate-access-widener` | 対象 Minecraft バージョンに対して Access Widener の内容を検証し、必要に応じて Loom runtime artifact も使う |",
+            "| `validate-access-transformer` | 対象 Minecraft バージョンに対して Access Transformer の内容を検証し、必要に応じて Forge / NeoForge runtime artifact も使う |"
         ]
     },
     "registry-diagnostics": {

package/dist/types.d.ts

@@ -1,14 +1,18 @@
 export type SourceOrigin = "local-jar" | "local-m2" | "remote-repo" | "decompiled";
 export type SourceMapping = "obfuscated" | "mojang" | "intermediary" | "yarn";
+export type AccessTransformerNamespace = "srg" | "mojang" | "obfuscated";
+export type RuntimeValidationNamespace = SourceMapping | AccessTransformerNamespace;
 export type MappingSourcePriority = "loom-first" | "maven-first";
 export type ArtifactTargetKind = "version" | "jar" | "coordinate";
 export type ArtifactScope = "vanilla" | "merged" | "loader";
+export type MappingVariant = "pass" | "mojang-remapped";
 export interface SourceTargetInput {
     kind: ArtifactTargetKind;
     value: string;
 }
 export interface ResolvedSourceArtifact {
     artifactId: string;
+    artifactAlias?: string;
     artifactSignature: string;
     origin: SourceOrigin;
     binaryJarPath?: string;
@@ -37,6 +41,21 @@ export interface ArtifactProvenance {
     };
     transformChain: string[];
 }
+export interface RuntimeValidationProvenance<TMapping extends RuntimeValidationNamespace = RuntimeValidationNamespace> {
+    version: string;
+    jarPath: string;
+    requestedScope?: ArtifactScope;
+    appliedScope?: ArtifactScope;
+    requestedMapping: TMapping;
+    mappingApplied: TMapping;
+    origin: SourceOrigin | "loom-cache" | "version-jar";
+    resolutionNotes?: string[];
+    scopeFallback?: {
+        requested: string;
+        applied: string;
+        reason: string;
+    };
+}
 export interface ErrorEnvelope {
     code: string;
     message: string;
@@ -85,6 +104,7 @@ export interface SourceSearchHit {
 }
 export interface ArtifactRow {
     artifactId: string;
+    alias: string | undefined;
     origin: SourceOrigin;
     coordinate: string | undefined;
     version: string | undefined;

package/dist/workspace-mapping-service.d.ts

@@ -13,7 +13,20 @@ export type WorkspaceCompileMappingOutput = {
     evidence: WorkspaceMappingEvidence[];
     warnings: string[];
 };
+export type WorkspaceProjectLoader = "fabric" | "quilt" | "forge" | "neoforge" | "unknown";
+export type WorkspaceLoaderEvidence = {
+    filePath: string;
+    loader: WorkspaceProjectLoader;
+    reason: string;
+};
+export type WorkspaceProjectLoaderOutput = {
+    resolved: boolean;
+    loader?: WorkspaceProjectLoader;
+    evidence: WorkspaceLoaderEvidence[];
+    warnings: string[];
+};
 export declare class WorkspaceMappingService {
     detectCompileMapping(input: WorkspaceCompileMappingInput): Promise<WorkspaceCompileMappingOutput>;
     detectProjectMinecraftVersion(projectPath: string): Promise<string | undefined>;
+    detectProjectLoader(projectPath: string): Promise<WorkspaceProjectLoaderOutput>;
 }

package/dist/workspace-mapping-service.js

@@ -1,7 +1,9 @@
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import fastGlob from "fast-glob";
+import { mapWithConcurrencyLimit } from "./concurrency.js";
 import { createError, ERROR_CODES } from "./errors.js";
+const WORKSPACE_FILE_READ_CONCURRENCY = 4;
 function detectMappingsFromContent(content) {
     const detections = [];
     if (/officialMojangMappings\s*\(/i.test(content)) {
@@ -36,6 +38,46 @@ function detectMappingsFromContent(content) {
     }
     return detections;
 }
+function detectLoadersFromContent(content) {
+    const detections = [];
+    if (/\bid\s*(?:\(\s*)?["']net\.neoforged\.moddev["']\s*\)?/i.test(content)) {
+        detections.push({
+            loader: "neoforge",
+            reason: "net.neoforged.moddev plugin"
+        });
+    }
+    if (/\bid\s*(?:\(\s*)?["']net\.minecraftforge\.gradle["']\s*\)?/i.test(content)) {
+        detections.push({
+            loader: "forge",
+            reason: "net.minecraftforge.gradle plugin"
+        });
+    }
+    if (/\bid\s*(?:\(\s*)?["']org\.quiltmc\.loom["']\s*\)?/i.test(content)) {
+        detections.push({
+            loader: "quilt",
+            reason: "org.quiltmc.loom plugin"
+        });
+    }
+    if (/\bid\s*(?:\(\s*)?["']fabric-loom["']\s*\)?/i.test(content) || /\bid\s*(?:\(\s*)?["']dev\.architectury\.loom["']\s*\)?/i.test(content)) {
+        detections.push({
+            loader: "fabric",
+            reason: "fabric/dev.architectury loom plugin"
+        });
+    }
+    if (/\bminecraft\s*\{[\s\S]*?\baccessTransformer\b/i.test(content)) {
+        detections.push({
+            loader: "forge",
+            reason: "minecraft { accessTransformer ... } block"
+        });
+    }
+    if (/\bneoForge\s*\{[\s\S]*?\baccessTransformers\b/i.test(content)) {
+        detections.push({
+            loader: "neoforge",
+            reason: "neoForge { accessTransformers ... } block"
+        });
+    }
+    return detections;
+}
 export class WorkspaceMappingService {
     async detectCompileMapping(input) {
         const projectPath = input.projectPath?.trim();
@@ -49,30 +91,26 @@ export class WorkspaceMappingService {
             });
         }
         const root = resolve(projectPath);
-        const files = fastGlob.sync(["build.gradle", "build.gradle.kts", "**/build.gradle", "**/build.gradle.kts"], {
+        const files = (await fastGlob.glob(["build.gradle", "build.gradle.kts", "**/build.gradle", "**/build.gradle.kts"], {
             cwd: root,
             absolute: true,
             onlyFiles: true,
             ignore: ["**/.git/**", "**/.gradle/**", "**/build/**", "**/out/**", "**/node_modules/**"]
-        });
-        const evidence = [];
-        for (const filePath of files.sort((left, right) => left.localeCompare(right))) {
+        })).sort((left, right) => left.localeCompare(right));
+        const evidence = (await mapWithConcurrencyLimit(files, WORKSPACE_FILE_READ_CONCURRENCY, async (filePath) => {
             let content;
             try {
                 content = await readFile(filePath, "utf8");
             }
             catch {
-                continue;
+                return [];
             }
-            const detections = detectMappingsFromContent(content);
-            for (const detection of detections) {
-                evidence.push({
-                    filePath,
-                    mapping: detection.mapping,
-                    reason: detection.reason
-                });
-            }
-        }
+            return detectMappingsFromContent(content).map((detection) => ({
+                filePath,
+                mapping: detection.mapping,
+                reason: detection.reason
+            }));
+        })).flat();
         if (evidence.length === 0) {
             return {
                 resolved: false,
@@ -121,5 +159,99 @@ export class WorkspaceMappingService {
         }
         return undefined;
     }
+    async detectProjectLoader(projectPath) {
+        const root = resolve(projectPath);
+        const buildFiles = (await fastGlob.glob(["build.gradle", "build.gradle.kts", "**/build.gradle", "**/build.gradle.kts"], {
+            cwd: root,
+            absolute: true,
+            onlyFiles: true,
+            ignore: ["**/.git/**", "**/.gradle/**", "**/build/**", "**/out/**", "**/node_modules/**"]
+        })).sort((left, right) => left.localeCompare(right));
+        const descriptorFiles = (await fastGlob.glob([
+            "fabric.mod.json",
+            "quilt.mod.json",
+            "META-INF/mods.toml",
+            "META-INF/neoforge.mods.toml",
+            "**/fabric.mod.json",
+            "**/quilt.mod.json",
+            "**/META-INF/mods.toml",
+            "**/META-INF/neoforge.mods.toml"
+        ], {
+            cwd: root,
+            absolute: true,
+            onlyFiles: true,
+            ignore: ["**/.git/**", "**/.gradle/**", "**/build/**", "**/out/**", "**/node_modules/**"]
+        })).sort((left, right) => left.localeCompare(right));
+        const evidence = (await mapWithConcurrencyLimit(buildFiles, WORKSPACE_FILE_READ_CONCURRENCY, async (filePath) => {
+            let content;
+            try {
+                content = await readFile(filePath, "utf8");
+            }
+            catch {
+                return [];
+            }
+            return detectLoadersFromContent(content).map((detection) => ({
+                filePath,
+                loader: detection.loader,
+                reason: detection.reason
+            }));
+        })).flat();
+        for (const descriptorPath of descriptorFiles) {
+            const normalized = descriptorPath.replaceAll("\\", "/");
+            if (normalized.endsWith("fabric.mod.json")) {
+                evidence.push({
+                    filePath: descriptorPath,
+                    loader: "fabric",
+                    reason: "fabric.mod.json"
+                });
+            }
+            else if (normalized.endsWith("quilt.mod.json")) {
+                evidence.push({
+                    filePath: descriptorPath,
+                    loader: "quilt",
+                    reason: "quilt.mod.json"
+                });
+            }
+            else if (normalized.endsWith("META-INF/neoforge.mods.toml")) {
+                evidence.push({
+                    filePath: descriptorPath,
+                    loader: "neoforge",
+                    reason: "META-INF/neoforge.mods.toml"
+                });
+            }
+            else if (normalized.endsWith("META-INF/mods.toml")) {
+                evidence.push({
+                    filePath: descriptorPath,
+                    loader: "forge",
+                    reason: "META-INF/mods.toml"
+                });
+            }
+        }
+        if (evidence.length === 0) {
+            return {
+                resolved: false,
+                evidence,
+                warnings: ["No workspace loader declaration was detected from build.gradle(.kts) files or mod descriptors."]
+            };
+        }
+        const loaderSet = new Set(evidence
+            .map((entry) => entry.loader)
+            .filter((loader) => loader !== "unknown"));
+        if (loaderSet.size !== 1) {
+            return {
+                resolved: false,
+                evidence,
+                warnings: [
+                    `Multiple or ambiguous workspace loaders were detected: ${[...loaderSet].join(", ") || "unknown"}.`
+                ]
+            };
+        }
+        return {
+            resolved: true,
+            loader: [...loaderSet][0],
+            evidence,
+            warnings: []
+        };
+    }
 }
 //# sourceMappingURL=workspace-mapping-service.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhisang/minecraft-modding-mcp",
-  "version": "3.1.1",
+  "version": "4.0.0",
   "description": "MCP server with utilities for Minecraft modding workflows",
   "type": "module",
   "main": "dist/index.js",
@@ -23,6 +23,8 @@
     "start": "node dist/cli.js",
     "check": "tsc --noEmit -p tsconfig.json",
     "test": "node --test --import tsx tests/*.test.ts",
+    "test:file": "node --test --import tsx",
+    "test:grep": "node --test --import tsx --test-name-pattern",
     "test:coverage": "node --test --import tsx --experimental-test-coverage --test-coverage-lines=80 --test-coverage-branches=70 --test-coverage-functions=80 tests/*.test.ts",
     "test:coverage:lcov": "node --input-type=module -e \"import { mkdirSync } from 'node:fs'; mkdirSync('coverage', { recursive: true });\" && node --test --import tsx --experimental-test-coverage --test-reporter=lcov --test-reporter-destination=coverage/lcov.info --test-coverage-lines=80 --test-coverage-branches=70 --test-coverage-functions=80 tests/*.test.ts",
     "test:perf": "node --test --test-concurrency=1 --import tsx tests/perf/*.perf.ts",