@adhisang/minecraft-modding-mcp 4.1.1 → 4.2.0

package/dist/entry-tools/verify-mixin-target-service.js

@@ -185,6 +185,7 @@ export class VerifyMixinTargetService {
             mapping: input.mapping,
             sourcePriority: input.sourcePriority,
             projectPath: input.projectPath,
+            gradleUserHome: input.gradleUserHome,
             scope: input.scope,
             preferProjectVersion: input.preferProjectVersion,
             strictVersion: input.strictVersion

package/dist/gradle-paths.d.ts

@@ -1,4 +1,9 @@
 export declare function normalizeOptionalProjectPath(projectPath: string | undefined): string | undefined;
-export declare function resolveGradleUserHomePath(): string;
-export declare function buildVersionSourceSearchRoots(projectPath: string | undefined): string[];
-export declare function buildLoaderRuntimeSearchRoots(projectPath: string | undefined): string[];
+export declare function normalizeOptionalGradleUserHomePath(gradleUserHome: string | undefined): string | undefined;
+export declare function resolveGradleUserHomePath(gradleUserHome?: string): string;
+export type GradleCacheSearchInput = string | {
+    projectPath?: string;
+    gradleUserHome?: string;
+} | undefined;
+export declare function buildVersionSourceSearchRoots(input: GradleCacheSearchInput): string[];
+export declare function buildLoaderRuntimeSearchRoots(input: GradleCacheSearchInput): string[];

package/dist/gradle-paths.js

@@ -12,7 +12,22 @@ export function normalizeOptionalProjectPath(projectPath) {
     const normalized = normalizePathForHost(trimmed, undefined, "projectPath");
     return isAbsolute(normalized) ? normalized : resolvePath(process.cwd(), normalized);
 }
-export function resolveGradleUserHomePath() {
+export function normalizeOptionalGradleUserHomePath(gradleUserHome) {
+    if (!gradleUserHome) {
+        return undefined;
+    }
+    const trimmed = gradleUserHome.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    const normalized = normalizePathForHost(trimmed, undefined, "gradleUserHome");
+    return isAbsolute(normalized) ? normalized : resolvePath(process.cwd(), normalized);
+}
+export function resolveGradleUserHomePath(gradleUserHome) {
+    const explicit = normalizeOptionalGradleUserHomePath(gradleUserHome);
+    if (explicit) {
+        return explicit;
+    }
     const configured = process.env.GRADLE_USER_HOME?.trim();
     if (!configured) {
         return resolvePath(homedir(), ".gradle");
@@ -20,7 +35,20 @@ export function resolveGradleUserHomePath() {
     const normalized = normalizePathForHost(configured, undefined, "GRADLE_USER_HOME");
     return isAbsolute(normalized) ? normalized : resolvePath(process.cwd(), normalized);
 }
-export function buildVersionSourceSearchRoots(projectPath) {
+function normalizeGradleCacheSearchInput(input) {
+    if (typeof input === "string" || input === undefined) {
+        return {
+            projectPath: normalizeOptionalProjectPath(input)
+        };
+    }
+    const gradleUserHome = normalizeOptionalGradleUserHomePath(input.gradleUserHome);
+    return {
+        projectPath: normalizeOptionalProjectPath(input.projectPath),
+        gradleUserHome
+    };
+}
+export function buildVersionSourceSearchRoots(input) {
+    const { projectPath, gradleUserHome } = normalizeGradleCacheSearchInput(input);
     const roots = new Set();
     if (projectPath) {
         roots.add(resolvePath(projectPath, ".gradle", "loom-cache"));
@@ -30,12 +58,13 @@ export function buildVersionSourceSearchRoots(projectPath) {
         roots.add(resolvePath(projectParent, ".gradle-user-home", "loom-cache"));
         roots.add(resolvePath(projectParent, ".gradle-user-home", "caches", "fabric-loom"));
     }
-    const homeGradle = resolveGradleUserHomePath();
+    const homeGradle = resolveGradleUserHomePath(gradleUserHome);
     roots.add(resolvePath(homeGradle, "loom-cache"));
     roots.add(resolvePath(homeGradle, "caches", "fabric-loom"));
     return [...roots];
 }
-export function buildLoaderRuntimeSearchRoots(projectPath) {
+export function buildLoaderRuntimeSearchRoots(input) {
+    const { projectPath, gradleUserHome } = normalizeGradleCacheSearchInput(input);
     const roots = new Set();
     if (projectPath) {
         roots.add(resolvePath(projectPath, "build"));
@@ -47,7 +76,7 @@ export function buildLoaderRuntimeSearchRoots(projectPath) {
         roots.add(resolvePath(projectPath, ".gradle", "caches", "neoformruntime"));
         roots.add(resolvePath(projectPath, ".gradle", "caches", "moddev"));
     }
-    const homeGradle = resolveGradleUserHomePath();
+    const homeGradle = resolveGradleUserHomePath(gradleUserHome);
     roots.add(resolvePath(homeGradle, "caches", "forge_gradle"));
     roots.add(resolvePath(homeGradle, "caches", "neogradle"));
     roots.add(resolvePath(homeGradle, "caches", "neoformruntime"));

package/dist/index.js

@@ -142,6 +142,7 @@ const validateProjectService = new ValidateProjectService({
             mapping: input.mapping,
             sourcePriority: input.sourcePriority,
             projectPath: input.projectPath,
+            gradleUserHome: input.gradleUserHome,
             scope: input.scope,
             preferProjectVersion: input.preferProjectVersion
         });
@@ -166,6 +167,7 @@ const verifyMixinTargetService = new VerifyMixinTargetService({
             mapping: input.mapping,
             sourcePriority: input.sourcePriority,
             projectPath: input.projectPath,
+            gradleUserHome: input.gradleUserHome,
             scope: input.scope,
             preferProjectVersion: input.preferProjectVersion,
             strictVersion: input.strictVersion
@@ -406,19 +408,19 @@ server.tool("list-versions", "List available Minecraft versions from Mojang mani
     limit: input.limit
 })));
 registerToolSchema("list-versions", listVersionsSchema);
-server.tool("inspect-minecraft", "High-level v3 entry tool for version discovery, artifact resolution, class inspection, source search, file reads, and file listings.", inspectMinecraftShape, { readOnlyHint: true }, async (args) => runTool("inspect-minecraft", args, inspectMinecraftSchema, async (input) => inspectMinecraftService.execute(input)));
+server.tool("inspect-minecraft", "Top-level workflow tool for version discovery, artifact resolution, class inspection, source search, file reads, and file listings.", inspectMinecraftShape, { readOnlyHint: true }, async (args) => runTool("inspect-minecraft", args, inspectMinecraftSchema, async (input) => inspectMinecraftService.execute(input)));
 registerToolSchema("inspect-minecraft", inspectMinecraftSchema);
-server.tool("analyze-symbol", "High-level v3 entry tool for symbol existence, mapping, lifecycle, workspace analysis, and API overview.", analyzeSymbolShape, { readOnlyHint: true }, async (args) => runTool("analyze-symbol", args, analyzeSymbolSchema, async (input) => analyzeSymbolService.execute(input)));
+server.tool("analyze-symbol", "Top-level workflow tool for symbol existence, mapping, lifecycle, workspace analysis, and API overview.", analyzeSymbolShape, { readOnlyHint: true }, async (args) => runTool("analyze-symbol", args, analyzeSymbolSchema, async (input) => analyzeSymbolService.execute(input)));
 registerToolSchema("analyze-symbol", analyzeSymbolSchema);
-server.tool("compare-minecraft", "High-level v3 entry tool for version comparisons, class diffs, registry diffs, and migration overviews.", compareMinecraftShape, { readOnlyHint: true }, async (args) => runTool("compare-minecraft", args, compareMinecraftSchema, async (input) => compareMinecraftService.execute(input)));
+server.tool("compare-minecraft", "Top-level workflow tool for version comparisons, class diffs, registry diffs, and migration overviews.", compareMinecraftShape, { readOnlyHint: true }, async (args) => runTool("compare-minecraft", args, compareMinecraftSchema, async (input) => compareMinecraftService.execute(input)));
 registerToolSchema("compare-minecraft", compareMinecraftSchema);
-server.tool("analyze-mod", "High-level v3 entry tool for mod metadata inspection, decompile/search flows, class source, and safe remap previews/applies.", analyzeModShape, { readOnlyHint: false }, async (args) => runTool("analyze-mod", args, analyzeModSchema, async (input) => analyzeModService.execute(input)));
+server.tool("analyze-mod", "Top-level workflow tool for mod metadata inspection, decompile/search flows, class source, and safe remap previews/applies.", analyzeModShape, { readOnlyHint: false }, async (args) => runTool("analyze-mod", args, analyzeModSchema, async (input) => analyzeModService.execute(input)));
 registerToolSchema("analyze-mod", analyzeModSchema);
-server.tool("validate-project", "High-level v3 entry tool for project summary, direct mixin validation, and access widener/access transformer validation.", validateProjectShape, { readOnlyHint: true }, async (args, extra) => runTool("validate-project", args, validateProjectSchema, async (input) => validateProjectService.execute(input, {
+server.tool("validate-project", "Top-level workflow tool for project summary, direct mixin validation, and access widener/access transformer validation.", validateProjectShape, { readOnlyHint: true }, async (args, extra) => runTool("validate-project", args, validateProjectSchema, async (input) => validateProjectService.execute(input, {
     stageEmitter: makeStageEmitter(extra)
 })));
 registerToolSchema("validate-project", validateProjectSchema);
-server.tool("manage-cache", "High-level v3 entry tool for cache summaries, listing, verification, previewed mutation, and explicit apply operations.", manageCacheShape, { readOnlyHint: false }, async (args) => runTool("manage-cache", args, manageCacheSchema, async (input) => manageCacheService.execute(input)));
+server.tool("manage-cache", "Top-level workflow tool for cache summaries, listing, verification, previewed mutation, and explicit apply operations.", manageCacheShape, { readOnlyHint: false }, async (args) => runTool("manage-cache", args, manageCacheSchema, async (input) => manageCacheService.execute(input)));
 registerToolSchema("manage-cache", manageCacheSchema);
 if (!VERIFY_MIXIN_TARGET_OFF) {
     server.tool("verify-mixin-target", "Single-call probe: does this target owner / member exist and which @Shadow / @Accessor / @Invoker should the mixin use? Reuses target.kind workspace/version/coordinate/dependency/jar.", verifyMixinTargetShape, { readOnlyHint: true }, async (args) => runTool("verify-mixin-target", args, verifyMixinTargetSchema, async (input) => verifyMixinTargetService.execute({
@@ -428,6 +430,7 @@ if (!VERIFY_MIXIN_TARGET_OFF) {
         mapping: input.mapping,
         sourcePriority: input.sourcePriority,
         projectPath: input.projectPath,
+        gradleUserHome: input.gradleUserHome,
         target: input.target,
         scope: input.scope,
         preferProjectVersion: input.preferProjectVersion,
@@ -451,6 +454,7 @@ server.tool("resolve-artifact", "Resolve source artifact from a target object ({
     sourcePriority: input.sourcePriority,
     allowDecompile: input.allowDecompile,
     projectPath: input.projectPath,
+    gradleUserHome: input.gradleUserHome,
     scope: input.scope,
     preferProjectVersion: input.preferProjectVersion,
     strictVersion: input.strictVersion,
@@ -480,6 +484,7 @@ server.tool("get-class-source", "Get Java source for a class by target ({ type:
         sourcePriority: input.sourcePriority,
         allowDecompile: input.allowDecompile,
         projectPath: input.projectPath,
+        gradleUserHome: input.gradleUserHome,
         scope: input.scope,
         preferProjectVersion: input.preferProjectVersion,
         strictVersion: input.strictVersion,
@@ -506,6 +511,7 @@ server.tool("get-class-members", "Get fields/methods/constructors for one class
         memberPattern: input.memberPattern,
         maxMembers: input.maxMembers,
         projectPath: input.projectPath,
+        gradleUserHome: input.gradleUserHome,
         scope: input.scope,
         preferProjectVersion: input.preferProjectVersion,
         strictVersion: input.strictVersion
@@ -530,7 +536,8 @@ server.tool("search-class-source", "Search indexed class source files for one ar
         limit: input.limit,
         cursor: input.cursor,
         queryNamespace: input.queryNamespace,
-        sourcePriority: input.sourcePriority
+        sourcePriority: input.sourcePriority,
+        gradleUserHome: input.gradleUserHome
     });
 }));
 registerToolSchema("search-class-source", searchClassSourceSchema);
@@ -554,6 +561,7 @@ server.tool("trace-symbol-lifecycle", "Trace which Minecraft versions contain a
     toVersion: input.toVersion,
     mapping: input.mapping,
     sourcePriority: input.sourcePriority,
+    gradleUserHome: input.gradleUserHome,
     includeSnapshots: input.includeSnapshots,
     maxVersions: input.maxVersions,
     includeTimeline: input.includeTimeline
@@ -565,6 +573,7 @@ server.tool("diff-class-signatures", "Compare one class signature between two Mi
     toVersion: input.toVersion,
     mapping: input.mapping,
     sourcePriority: input.sourcePriority,
+    gradleUserHome: input.gradleUserHome,
     includeFullDiff: input.includeFullDiff
 })));
 registerToolSchema("diff-class-signatures", diffClassSignaturesSchema);
@@ -577,6 +586,7 @@ server.tool("find-mapping", "Find symbol mapping candidates between namespaces u
     sourceMapping: input.sourceMapping,
     targetMapping: input.targetMapping,
     sourcePriority: input.sourcePriority,
+    gradleUserHome: input.gradleUserHome,
     signatureMode: input.signatureMode,
     disambiguation: input.disambiguation,
     maxCandidates: input.maxCandidates
@@ -590,6 +600,7 @@ server.tool("resolve-method-mapping-exact", "Resolve one method mapping exactly
     sourceMapping: input.sourceMapping,
     targetMapping: input.targetMapping,
     sourcePriority: input.sourcePriority,
+    gradleUserHome: input.gradleUserHome,
     maxCandidates: input.maxCandidates
 })));
 registerToolSchema("resolve-method-mapping-exact", resolveMethodMappingExactSchema);
@@ -599,6 +610,7 @@ server.tool("get-class-api-matrix", "List class/member API rows across obfuscate
     classNameMapping: input.classNameMapping,
     includeKinds: parseClassApiKinds(input.includeKinds),
     sourcePriority: input.sourcePriority,
+    gradleUserHome: input.gradleUserHome,
     maxRows: input.maxRows
 })));
 registerToolSchema("get-class-api-matrix", getClassApiMatrixSchema);
@@ -611,6 +623,7 @@ server.tool("resolve-workspace-symbol", "Resolve class/field/method names as see
     descriptor: input.descriptor,
     sourceMapping: input.sourceMapping,
     sourcePriority: input.sourcePriority,
+    gradleUserHome: input.gradleUserHome,
     maxCandidates: input.maxCandidates
 })));
 registerToolSchema("resolve-workspace-symbol", resolveWorkspaceSymbolSchema);
@@ -622,6 +635,7 @@ server.tool("check-symbol-exists", "Check whether a class/field/method symbol ex
     descriptor: input.descriptor,
     sourceMapping: input.sourceMapping,
     sourcePriority: input.sourcePriority,
+    gradleUserHome: input.gradleUserHome,
     nameMode: input.nameMode,
     signatureMode: input.signatureMode,
     maxCandidates: input.maxCandidates
@@ -657,6 +671,7 @@ server.tool("validate-mixin", "Validate Mixin source against Minecraft bytecode
     sourcePriority: input.sourcePriority,
     scope: input.scope,
     projectPath: input.projectPath,
+    gradleUserHome: input.gradleUserHome,
     preferProjectVersion: input.preferProjectVersion,
     minSeverity: input.minSeverity,
     hideUncertain: input.hideUncertain,
@@ -677,6 +692,7 @@ server.tool("validate-access-widener", "Validate Access Widener file entries aga
     mapping: input.mapping,
     sourcePriority: input.sourcePriority,
     projectPath: input.projectPath,
+    gradleUserHome: input.gradleUserHome,
     scope: input.scope,
     preferProjectVersion: input.preferProjectVersion
 })));
@@ -687,6 +703,7 @@ server.tool("validate-access-transformer", "Validate Access Transformer file ent
     atNamespace: input.atNamespace,
     sourcePriority: input.sourcePriority,
     projectPath: input.projectPath,
+    gradleUserHome: input.gradleUserHome,
     scope: input.scope,
     preferProjectVersion: input.preferProjectVersion
 })));

package/dist/mapping/loaders/tiny-loom.d.ts

@@ -1,2 +1,2 @@
 import type { MappingLoaderResult } from "./types.js";
-export declare function loadTinyPairsFromLoom(version: string, projectPath?: string): Promise<MappingLoaderResult>;
+export declare function loadTinyPairsFromLoom(version: string, projectPath?: string, gradleUserHome?: string): Promise<MappingLoaderResult>;

package/dist/mapping/loaders/tiny-loom.js

@@ -7,8 +7,11 @@ import { effectiveLoomSearchProjectPath } from "../lookup.js";
 import { mergeDirectionIndexes } from "../parsers/symbol-records.js";
 import { parseTinyMappings } from "../parsers/tiny.js";
 const GLOB_SPECIAL_CHARS = /[\\!*+?()[\]{}@|]/g;
-export async function loadTinyPairsFromLoom(version, projectPath) {
-    const searchRoots = buildVersionSourceSearchRoots(effectiveLoomSearchProjectPath(projectPath));
+export async function loadTinyPairsFromLoom(version, projectPath, gradleUserHome) {
+    const searchRoots = buildVersionSourceSearchRoots({
+        projectPath: effectiveLoomSearchProjectPath(projectPath),
+        gradleUserHome
+    });
     const merged = new Map();
     const discoveredPaths = new Set();
     for (const root of searchRoots) {

package/dist/mapping/types.d.ts

@@ -60,6 +60,7 @@ export type FindMappingInput = {
     targetMapping: SourceMapping;
     sourcePriority?: MappingSourcePriority;
     projectPath?: string;
+    gradleUserHome?: string;
     disambiguation?: {
         ownerHint?: string;
         descriptorHint?: string;
@@ -73,6 +74,7 @@ export type EnsureMappingAvailableInput = {
     targetMapping: SourceMapping;
     sourcePriority?: MappingSourcePriority;
     projectPath?: string;
+    gradleUserHome?: string;
 };
 export type EnsureMappingAvailableOutput = {
     transformChain: string[];
@@ -88,6 +90,7 @@ export type ResolveMethodMappingExactInput = {
     targetMapping: SourceMapping;
     sourcePriority?: MappingSourcePriority;
     projectPath?: string;
+    gradleUserHome?: string;
     maxCandidates?: number;
 };
 export type ResolveMethodMappingExactOutput = SymbolResolutionOutput;
@@ -97,6 +100,7 @@ export type ClassApiMatrixInput = {
     className: string;
     classNameMapping: SourceMapping;
     sourcePriority?: MappingSourcePriority;
+    gradleUserHome?: string;
     includeKinds?: ClassApiMatrixKind[];
     maxRows?: number;
 };
@@ -134,6 +138,7 @@ export type SymbolExistenceInput = {
     descriptor?: string;
     sourceMapping: SourceMapping;
     sourcePriority?: MappingSourcePriority;
+    gradleUserHome?: string;
     nameMode?: "fqcn" | "auto";
     signatureMode?: "exact" | "name-only";
     maxCandidates?: number;

package/dist/mapping-service.d.ts

@@ -41,6 +41,7 @@ export declare class MappingService {
         version: string;
         requestedMapping: SourceMapping;
         sourcePriority?: MappingSourcePriority;
+        gradleUserHome?: string;
     }): Promise<{
         mojangMappingsAvailable: boolean;
         tinyMappingsAvailable: boolean;

package/dist/mapping-service.js

@@ -3,6 +3,7 @@ import { mkdir, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { buildSuggestedCall } from "./build-suggested-call.js";
 import { createError, ERROR_CODES } from "./errors.js";
+import { resolveGradleUserHomePath } from "./gradle-paths.js";
 import { defaultDownloadPath, downloadToCache } from "./repo-downloader.js";
 import { collectMatchedJarEntriesAsUtf8 } from "./source-jar-reader.js";
 import { VersionService, isUnobfuscatedVersion } from "./version-service.js";
@@ -112,7 +113,7 @@ export class MappingService {
                 warnings: []
             };
         }
-        const graph = await this.loadGraph(version, priority, requiresOnlyObfuscatedMojangGraph(sourceMapping, targetMapping) ? "obfuscated-mojang-only" : "full", input.projectPath);
+        const graph = await this.loadGraph(version, priority, requiresOnlyObfuscatedMojangGraph(sourceMapping, targetMapping) ? "obfuscated-mojang-only" : "full", input.projectPath, input.gradleUserHome);
         const path = namespacePath(graph, sourceMapping, targetMapping);
         if (!path) {
             return {
@@ -254,7 +255,7 @@ export class MappingService {
                 warnings: []
             };
         }
-        const graph = await this.loadGraph(version, priority, requiresOnlyObfuscatedMojangGraph(sourceMapping, targetMapping) ? "obfuscated-mojang-only" : "full", input.projectPath);
+        const graph = await this.loadGraph(version, priority, requiresOnlyObfuscatedMojangGraph(sourceMapping, targetMapping) ? "obfuscated-mojang-only" : "full", input.projectPath, input.gradleUserHome);
         const path = namespacePath(graph, sourceMapping, targetMapping);
         if (!path) {
             throw createError({
@@ -338,7 +339,7 @@ export class MappingService {
                 warnings: []
             };
         }
-        const graph = await this.loadGraph(version, priority, requiresOnlyObfuscatedMojangGraph(sourceMapping, targetMapping) ? "obfuscated-mojang-only" : "full", input.projectPath);
+        const graph = await this.loadGraph(version, priority, requiresOnlyObfuscatedMojangGraph(sourceMapping, targetMapping) ? "obfuscated-mojang-only" : "full", input.projectPath, input.gradleUserHome);
         const path = namespacePath(graph, sourceMapping, targetMapping);
         if (!path) {
             return {
@@ -448,7 +449,7 @@ export class MappingService {
             });
         }
         const priority = mappingPriorityFromInput(this.config.mappingSourcePriority, input.sourcePriority);
-        const graph = await this.loadGraph(version, priority, "full");
+        const graph = await this.loadGraph(version, priority, "full", undefined, input.gradleUserHome);
         const warnings = [...graph.warnings];
         const includeKinds = normalizeIncludedKinds(input.includeKinds);
         const pathCache = new Map();
@@ -669,7 +670,7 @@ export class MappingService {
                     querySymbol
                 };
             })();
-        const graph = await this.loadGraph(version, priority, sourceMapping === "mojang" ? "obfuscated-mojang-only" : "full");
+        const graph = await this.loadGraph(version, priority, sourceMapping === "mojang" ? "obfuscated-mojang-only" : "full", undefined, input.gradleUserHome);
         const warnings = [...graph.warnings];
         const records = collectTargetRecords(graph, sourceMapping);
         if (records.length === 0) {
@@ -950,7 +951,7 @@ export class MappingService {
         }
         let graph;
         try {
-            graph = await this.loadGraph(input.version, priority, needsTinyMappings ? "full" : "obfuscated-mojang-only");
+            graph = await this.loadGraph(input.version, priority, needsTinyMappings ? "full" : "obfuscated-mojang-only", undefined, input.gradleUserHome);
         }
         catch {
             return {
@@ -994,9 +995,10 @@ export class MappingService {
             degradations
         };
     }
-    async loadGraph(version, priority, mode, projectPath) {
+    async loadGraph(version, priority, mode, projectPath, gradleUserHome) {
         const effectiveProjectPath = effectiveLoomSearchProjectPath(projectPath);
-        const cacheKey = `${version}|${priority}|${mode}|${effectiveProjectPath ?? ""}`;
+        const effectiveGradleUserHome = resolveGradleUserHomePath(gradleUserHome);
+        const cacheKey = `${version}|${priority}|${mode}|${effectiveProjectPath ?? ""}|${effectiveGradleUserHome}`;
         const cached = this.graphCache.get(cacheKey);
         if (cached) {
             this.graphCache.delete(cacheKey);
@@ -1007,7 +1009,7 @@ export class MappingService {
         if (existingLock) {
             return existingLock;
         }
-        const buildPromise = this.buildGraph(version, priority, mode, effectiveProjectPath);
+        const buildPromise = this.buildGraph(version, priority, mode, effectiveProjectPath, effectiveGradleUserHome);
         this.buildLocks.set(cacheKey, buildPromise);
         try {
             const built = await buildPromise;
@@ -1019,7 +1021,7 @@ export class MappingService {
             this.buildLocks.delete(cacheKey);
         }
     }
-    async buildGraph(version, priority, mode, projectPath) {
+    async buildGraph(version, priority, mode, projectPath, gradleUserHome) {
         if (isUnobfuscatedVersion(version)) {
             return {
                 version,
@@ -1052,7 +1054,7 @@ export class MappingService {
             const deferredTinyWarnings = [];
             for (const source of mappingSourceOrder(priority)) {
                 const tinyLoad = source === "loom-cache"
-                    ? await this.loadTinyPairsFromLoom(version, projectPath)
+                    ? await this.loadTinyPairsFromLoom(version, projectPath, gradleUserHome)
                     : await this.loadTinyPairsFromMaven(version);
                 if (tinyLoad.pairs.size === 0) {
                     deferredTinyWarnings.push(...tinyLoad.warnings);
@@ -1095,8 +1097,8 @@ export class MappingService {
     async loadMojangPairs(version) {
         return loadMojangPairs(this.loaderDeps(), version);
     }
-    async loadTinyPairsFromLoom(version, projectPath) {
-        return loadTinyPairsFromLoom(version, projectPath);
+    async loadTinyPairsFromLoom(version, projectPath, gradleUserHome) {
+        return loadTinyPairsFromLoom(version, projectPath, gradleUserHome);
     }
     async loadTinyPairsFromMaven(version) {
         return loadTinyPairsFromMaven(this.loaderDeps(), version);
@@ -1152,6 +1154,7 @@ export class MappingService {
             input.targetMapping,
             input.sourcePriority ?? "",
             effectiveLoomSearchProjectPath(input.projectPath) ?? "",
+            resolveGradleUserHomePath(input.gradleUserHome),
             effectiveSignatureMode,
             String(input.maxCandidates ?? ""),
             JSON.stringify(input.disambiguation ?? "")

package/dist/mixin-validator.d.ts

@@ -1,7 +1,7 @@
 /**
  * Public barrel for the mixin validation engine. The implementation lives
  * under `src/mixin/`; this file preserves the historical entry point used
- * by source-service, entry tools, and tests.
+ * by source-service, top-level workflow tools, and tests.
  */
 export type { AccessTransformerValidationResult, AccessWidenerValidationResult, AggregatedWarningGroup, ConfidenceBreakdown, ConfidencePenalty, IssueCategory, IssueConfidence, MappingHealthReport, MixinStageBudgets, MixinValidationProvenance, MixinValidationResult, ResolutionPath, ResolvedMember, ResolvedTargetMembers, StructuredWarning, TargetOutcome, ValidationIssue, ValidationStatus, ValidationSummary } from "./mixin/types.js";
 export { loadMixinStageBudgets } from "./mixin/types.js";

package/dist/mixin-validator.js

@@ -1,7 +1,7 @@
 /**
  * Public barrel for the mixin validation engine. The implementation lives
  * under `src/mixin/`; this file preserves the historical entry point used
- * by source-service, entry tools, and tests.
+ * by source-service, top-level workflow tools, and tests.
  */
 export { loadMixinStageBudgets } from "./mixin/types.js";
 export { accessLevelFromFlags, buildQuickSummary, computeConfidenceBreakdown, computeFalsePositiveRisk, computeValidationStatus, extractMethodDescriptor, extractMethodName, levenshteinDistance, refreshMixinValidationOutcome, suggestSimilar, summarizeResolvedMembers } from "./mixin/helpers.js";

package/dist/source/access-validate.js

@@ -56,6 +56,7 @@ export async function validateAccessWidener(svc, input) {
             version,
             awNamespace,
             projectPath: input.projectPath,
+            gradleUserHome: input.gradleUserHome,
             scope: input.scope,
             preferProjectVersion: input.preferProjectVersion
         });
@@ -85,7 +86,8 @@ export async function validateAccessWidener(svc, input) {
                     sourceMapping: awNamespace,
                     targetMapping: lookupMapping,
                     sourcePriority: input.sourcePriority,
-                    projectPath: input.projectPath
+                    projectPath: input.projectPath,
+                    gradleUserHome: input.gradleUserHome
                 });
                 if (mapped.resolved && mapped.resolvedSymbol) {
                     lookupFqn = mapped.resolvedSymbol.name;
@@ -110,9 +112,9 @@ export async function validateAccessWidener(svc, input) {
             let fields = sig.fields;
             if (needsLookupMapping) {
                 const [ctorResult, methodResult, fieldResult] = await Promise.all([
-                    svc.remapSignatureMembers(sig.constructors, "method", resolvedVersion, lookupMapping, awNamespace, input.sourcePriority, warnings, input.projectPath),
-                    svc.remapSignatureMembers(sig.methods, "method", resolvedVersion, lookupMapping, awNamespace, input.sourcePriority, warnings, input.projectPath),
-                    svc.remapSignatureMembers(sig.fields, "field", resolvedVersion, lookupMapping, awNamespace, input.sourcePriority, warnings, input.projectPath)
+                    svc.remapSignatureMembers(sig.constructors, "method", resolvedVersion, lookupMapping, awNamespace, input.sourcePriority, warnings, input.projectPath, input.gradleUserHome),
+                    svc.remapSignatureMembers(sig.methods, "method", resolvedVersion, lookupMapping, awNamespace, input.sourcePriority, warnings, input.projectPath, input.gradleUserHome),
+                    svc.remapSignatureMembers(sig.fields, "field", resolvedVersion, lookupMapping, awNamespace, input.sourcePriority, warnings, input.projectPath, input.gradleUserHome)
                 ]);
                 constructors = ctorResult.members;
                 methods = methodResult.members;
@@ -163,6 +165,7 @@ export async function validateAccessTransformer(svc, input) {
             version,
             atNamespace,
             projectPath: input.projectPath,
+            gradleUserHome: input.gradleUserHome,
             scope: input.scope,
             preferProjectVersion: input.preferProjectVersion
         });
@@ -197,7 +200,8 @@ export async function validateAccessTransformer(svc, input) {
                         sourceMapping: atNamespace,
                         targetMapping: lookupMapping,
                         sourcePriority: input.sourcePriority,
-                        projectPath: input.projectPath
+                        projectPath: input.projectPath,
+                        gradleUserHome: input.gradleUserHome
                     });
                     if (mapped.resolved && mapped.resolvedSymbol) {
                         lookupFqn = mapped.resolvedSymbol.name;
@@ -223,9 +227,9 @@ export async function validateAccessTransformer(svc, input) {
             let fields = sig.fields;
             if (needsLookupMapping && isSourceMappingNamespace(atNamespace) && isSourceMappingNamespace(lookupMapping)) {
                 const [ctorResult, methodResult, fieldResult] = await Promise.all([
-                    svc.remapSignatureMembers(sig.constructors, "method", resolvedVersion, lookupMapping, atNamespace, input.sourcePriority, warnings, input.projectPath),
-                    svc.remapSignatureMembers(sig.methods, "method", resolvedVersion, lookupMapping, atNamespace, input.sourcePriority, warnings, input.projectPath),
-                    svc.remapSignatureMembers(sig.fields, "field", resolvedVersion, lookupMapping, atNamespace, input.sourcePriority, warnings, input.projectPath)
+                    svc.remapSignatureMembers(sig.constructors, "method", resolvedVersion, lookupMapping, atNamespace, input.sourcePriority, warnings, input.projectPath, input.gradleUserHome),
+                    svc.remapSignatureMembers(sig.methods, "method", resolvedVersion, lookupMapping, atNamespace, input.sourcePriority, warnings, input.projectPath, input.gradleUserHome),
+                    svc.remapSignatureMembers(sig.fields, "field", resolvedVersion, lookupMapping, atNamespace, input.sourcePriority, warnings, input.projectPath, input.gradleUserHome)
                 ]);
                 constructors = ctorResult.members;
                 methods = methodResult.members;

package/dist/source/artifact-resolver.d.ts

@@ -32,11 +32,13 @@ export declare function hasExactVersionToken(path: string, version: string): boo
 export declare function discoverVersionSourceJar(_svc: SourceService, input: {
     version: string;
     projectPath?: string;
+    gradleUserHome?: string;
 }): Promise<VersionSourceDiscovery>;
 export declare function probeMinecraftArtifact(svc: SourceService, input: ProbeMinecraftArtifactInput): Promise<ProbeMinecraftArtifactOutput>;
 export declare function discoverAccessWidenerRuntimeCandidates(_svc: SourceService, input: {
     version: string;
     projectPath?: string;
+    gradleUserHome?: string;
     requestedScope: ArtifactScope;
 }): Promise<{
     searchedPaths: string[];
@@ -46,6 +48,7 @@ export declare function discoverAccessWidenerRuntimeCandidates(_svc: SourceServi
 export declare function discoverAccessTransformerRuntimeCandidates(_svc: SourceService, input: {
     version: string;
     projectPath?: string;
+    gradleUserHome?: string;
     requestedScope: ArtifactScope;
     atNamespace: AccessTransformerNamespace;
     loader: WorkspaceProjectLoader | "unknown";
@@ -58,6 +61,7 @@ export declare function resolveAccessWidenerRuntimeArtifact(svc: SourceService,
     version: string;
     awNamespace: SourceMapping;
     projectPath?: string;
+    gradleUserHome?: string;
     scope?: ArtifactScope;
     preferProjectVersion?: boolean;
 }): Promise<RuntimeValidationProvenance<SourceMapping>>;
@@ -69,6 +73,7 @@ export declare function resolveAccessTransformerRuntimeArtifact(svc: SourceServi
     version: string;
     atNamespace: AccessTransformerNamespace;
     projectPath?: string;
+    gradleUserHome?: string;
     scope?: ArtifactScope;
     preferProjectVersion?: boolean;
 }): Promise<RuntimeValidationProvenance<AccessTransformerNamespace>>;