@adhisang/minecraft-modding-mcp 4.2.1 → 6.0.0

package/dist/entry-tools/inspect-minecraft-service.js

@@ -11,7 +11,7 @@ import { handleClassMembers } from "./inspect-minecraft/handlers/class-members.j
 import { handleSearch } from "./inspect-minecraft/handlers/search.js";
 import { handleFile } from "./inspect-minecraft/handlers/file.js";
 import { handleListFiles } from "./inspect-minecraft/handlers/list-files.js";
-const INCLUDE_GROUPS = ["warnings", "provenance", "candidates", "members", "source", "files", "samples", "artifact", "timings"];
+const INCLUDE_GROUPS = ["warnings", "provenance", "candidates", "members", "descriptors", "source", "files", "samples", "artifact", "timings"];
 const nonEmptyString = z.string().trim().min(1);
 export const inspectMinecraftShape = {
     task: z.enum(TASKS).optional(),

package/dist/entry-tools/manage-cache-service.d.ts

@@ -82,9 +82,9 @@ export declare const manageCacheSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     limit: number;
     executionMode: "preview" | "apply";
-    action: "list" | "summary" | "inspect" | "verify" | "delete" | "prune" | "rebuild";
+    action: "summary" | "list" | "inspect" | "verify" | "delete" | "prune" | "rebuild";
     cursor?: string | undefined;
-    detail?: "full" | "summary" | "standard" | undefined;
+    detail?: "summary" | "standard" | "full" | undefined;
     include?: string[] | undefined;
     cacheKinds?: ("workspace" | "artifact-index" | "downloads" | "mapping" | "registry" | "decompiled-source" | "mod-remap" | "binary-remap")[] | undefined;
     selector?: {
@@ -99,10 +99,10 @@ export declare const manageCacheSchema: z.ZodObject<{
         olderThan?: string | undefined;
     } | undefined;
 }, {
-    action: "list" | "summary" | "inspect" | "verify" | "delete" | "prune" | "rebuild";
+    action: "summary" | "list" | "inspect" | "verify" | "delete" | "prune" | "rebuild";
     limit?: number | undefined;
     cursor?: string | undefined;
-    detail?: "full" | "summary" | "standard" | undefined;
+    detail?: "summary" | "standard" | "full" | undefined;
     include?: string[] | undefined;
     executionMode?: "preview" | "apply" | undefined;
     cacheKinds?: ("workspace" | "artifact-index" | "downloads" | "mapping" | "registry" | "decompiled-source" | "mod-remap" | "binary-remap")[] | undefined;

package/dist/entry-tools/response-contract.d.ts

@@ -1,6 +1,6 @@
 export declare const DETAIL_LEVELS: readonly ["summary", "standard", "full"];
 export type DetailLevel = (typeof DETAIL_LEVELS)[number];
-export declare const CANONICAL_INCLUDE_GROUPS: readonly ["warnings", "provenance", "candidates", "members", "source", "files", "samples", "diff", "issues", "timeline", "matrix", "entries", "workspace", "health", "recovery", "paths", "owners", "preview", "cacheEntries", "timings", "artifact", "classes", "registry"];
+export declare const CANONICAL_INCLUDE_GROUPS: readonly ["warnings", "provenance", "candidates", "members", "descriptors", "source", "files", "samples", "diff", "issues", "timeline", "matrix", "entries", "workspace", "health", "recovery", "paths", "owners", "preview", "cacheEntries", "timings", "artifact", "classes", "registry"];
 export type IncludeGroup = (typeof CANONICAL_INCLUDE_GROUPS)[number];
 export type SummaryStatus = "ok" | "partial" | "ambiguous" | "not_found" | "invalid" | "blocked" | "changed" | "unchanged";
 export type NextAction = {
@@ -30,6 +30,8 @@ export declare function createTruncationMeta(input: {
 }): TruncationMeta;
 export declare function buildEntryToolMeta(input: {
     detail: DetailLevel;
+    /** When set and equal to `detail`, detailApplied is omitted (the default needs no echo). */
+    defaultDetail?: DetailLevel;
     include?: readonly string[];
     warnings?: readonly string[];
     truncated?: TruncationMeta;

package/dist/entry-tools/response-contract.js

@@ -4,6 +4,7 @@ export const CANONICAL_INCLUDE_GROUPS = [
     "provenance",
     "candidates",
     "members",
+    "descriptors",
     "source",
     "files",
     "samples",
@@ -70,8 +71,8 @@ export function createTruncationMeta(input) {
 }
 export function buildEntryToolMeta(input) {
     return {
-        warnings: [...(input.warnings ?? [])],
-        detailApplied: input.detail,
+        ...(input.warnings && input.warnings.length > 0 ? { warnings: [...input.warnings] } : {}),
+        ...(input.detail === input.defaultDetail ? {} : { detailApplied: input.detail }),
         ...(input.include && input.include.length > 0
             ? { includeApplied: normalizeIncludeGroups(input.include) }
             : {}),

package/dist/entry-tools/validate-project/cases/mixin.js

@@ -48,7 +48,8 @@ export async function handleMixin(deps, input, detail, include) {
         warningMode: input.warningMode,
         warningCategoryFilter: input.warningCategoryFilter,
         treatInfoAsWarning: input.treatInfoAsWarning,
-        includeIssues: input.includeIssues
+        includeIssues: input.includeIssues,
+        reportMode: input.reportMode
     });
     const summary = output.summary;
     const invalidCount = summary?.invalid ?? 0;

package/dist/entry-tools/validate-project/cases/project-summary.js

@@ -45,12 +45,13 @@ export async function handleProjectSummary(deps, input, detail, include, options
                         tool: "validate-project",
                         params: {
                             task: "project-summary",
-                            subject: input.subject
+                            subject: input.subject,
+                            preferProjectVersion: true
                         }
                     }
                 ],
                 notes: [
-                    "Pass version explicitly, or retry with preferProjectVersion=true when gradle.properties declares the Minecraft version."
+                    "Pass version explicitly, or retry with preferProjectVersion=true when gradle.properties declares the Minecraft version. The suggested retry sets preferProjectVersion=true for you."
                 ]
             },
             blocks: {
@@ -225,7 +226,8 @@ export async function handleProjectSummary(deps, input, detail, include, options
                 warningMode: input.warningMode,
                 warningCategoryFilter: input.warningCategoryFilter,
                 treatInfoAsWarning: input.treatInfoAsWarning,
-                includeIssues: input.includeIssues
+                includeIssues: input.includeIssues,
+                reportMode: input.reportMode
             }, {
                 stageEmitter: wrappedEmitter
             });

package/dist/entry-tools/validate-project-service.d.ts

@@ -57,13 +57,13 @@ export declare const validateProjectShape: {
     }, "strip", z.ZodTypeAny, {
         kind: "workspace";
         projectPath: string;
-        gradleUserHome?: string | undefined;
         discover?: ("mixins" | "access-wideners" | "access-transformers")[] | undefined;
+        gradleUserHome?: string | undefined;
     }, {
         kind: "workspace";
         projectPath: string;
-        gradleUserHome?: string | undefined;
         discover?: ("mixins" | "access-wideners" | "access-transformers")[] | undefined;
+        gradleUserHome?: string | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"mixin">;
         input: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
@@ -245,6 +245,7 @@ export declare const validateProjectShape: {
     warningCategoryFilter: z.ZodOptional<z.ZodArray<z.ZodEnum<["mapping", "configuration", "validation", "resolution", "parse"]>, "many">>;
     treatInfoAsWarning: z.ZodDefault<z.ZodBoolean>;
     includeIssues: z.ZodDefault<z.ZodBoolean>;
+    reportMode: z.ZodDefault<z.ZodEnum<["compact", "full", "summary-first"]>>;
 };
 export declare const validateProjectSchema: z.ZodEffects<z.ZodObject<{
     task: z.ZodEnum<["project-summary", "mixin", "access-widener", "access-transformer"]>;
@@ -256,13 +257,13 @@ export declare const validateProjectSchema: z.ZodEffects<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         kind: "workspace";
         projectPath: string;
-        gradleUserHome?: string | undefined;
         discover?: ("mixins" | "access-wideners" | "access-transformers")[] | undefined;
+        gradleUserHome?: string | undefined;
     }, {
         kind: "workspace";
         projectPath: string;
-        gradleUserHome?: string | undefined;
         discover?: ("mixins" | "access-wideners" | "access-transformers")[] | undefined;
+        gradleUserHome?: string | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"mixin">;
         input: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
@@ -444,19 +445,21 @@ export declare const validateProjectSchema: z.ZodEffects<z.ZodObject<{
     warningCategoryFilter: z.ZodOptional<z.ZodArray<z.ZodEnum<["mapping", "configuration", "validation", "resolution", "parse"]>, "many">>;
     treatInfoAsWarning: z.ZodDefault<z.ZodBoolean>;
     includeIssues: z.ZodDefault<z.ZodBoolean>;
+    reportMode: z.ZodDefault<z.ZodEnum<["compact", "full", "summary-first"]>>;
 }, "strip", z.ZodTypeAny, {
-    minSeverity: "all" | "error" | "warning";
     hideUncertain: boolean;
     explain: boolean;
     preferProjectMapping: boolean;
+    minSeverity: "all" | "error" | "warning";
+    reportMode: "full" | "summary-first" | "compact";
     treatInfoAsWarning: boolean;
     includeIssues: boolean;
-    task: "mixin" | "project-summary" | "access-widener" | "access-transformer";
+    task: "project-summary" | "mixin" | "access-transformer" | "access-widener";
     subject: {
         kind: "workspace";
         projectPath: string;
-        gradleUserHome?: string | undefined;
         discover?: ("mixins" | "access-wideners" | "access-transformers")[] | undefined;
+        gradleUserHome?: string | undefined;
     } | {
         kind: "mixin";
         input: {
@@ -497,22 +500,22 @@ export declare const validateProjectSchema: z.ZodEffects<z.ZodObject<{
     version?: string | undefined;
     mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
     scope?: "vanilla" | "merged" | "loader" | undefined;
-    sourcePriority?: "loom-first" | "maven-first" | undefined;
-    sourceRoots?: string[] | undefined;
     preferProjectVersion?: boolean | undefined;
+    sourcePriority?: "loom-first" | "maven-first" | undefined;
     warningMode?: "full" | "aggregated" | undefined;
+    sourceRoots?: string[] | undefined;
     warningCategoryFilter?: ("mapping" | "parse" | "validation" | "configuration" | "resolution")[] | undefined;
     configPaths?: string[] | undefined;
-    atNamespace?: "obfuscated" | "mojang" | "srg" | undefined;
-    detail?: "full" | "summary" | "standard" | undefined;
+    detail?: "summary" | "standard" | "full" | undefined;
     include?: string[] | undefined;
+    atNamespace?: "obfuscated" | "mojang" | "srg" | undefined;
 }, {
-    task: "mixin" | "project-summary" | "access-widener" | "access-transformer";
+    task: "project-summary" | "mixin" | "access-transformer" | "access-widener";
     subject: {
         kind: "workspace";
         projectPath: string;
-        gradleUserHome?: string | undefined;
         discover?: ("mixins" | "access-wideners" | "access-transformers")[] | undefined;
+        gradleUserHome?: string | undefined;
     } | {
         kind: "mixin";
         input: {
@@ -553,34 +556,36 @@ export declare const validateProjectSchema: z.ZodEffects<z.ZodObject<{
     version?: string | undefined;
     mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
     scope?: "vanilla" | "merged" | "loader" | undefined;
-    sourcePriority?: "loom-first" | "maven-first" | undefined;
-    sourceRoots?: string[] | undefined;
     preferProjectVersion?: boolean | undefined;
-    minSeverity?: "all" | "error" | "warning" | undefined;
     hideUncertain?: boolean | undefined;
     explain?: boolean | undefined;
-    warningMode?: "full" | "aggregated" | undefined;
     preferProjectMapping?: boolean | undefined;
-    warningCategoryFilter?: ("mapping" | "parse" | "validation" | "configuration" | "resolution")[] | undefined;
+    minSeverity?: "all" | "error" | "warning" | undefined;
+    reportMode?: "full" | "summary-first" | "compact" | undefined;
     treatInfoAsWarning?: boolean | undefined;
     includeIssues?: boolean | undefined;
+    sourcePriority?: "loom-first" | "maven-first" | undefined;
+    warningMode?: "full" | "aggregated" | undefined;
+    sourceRoots?: string[] | undefined;
+    warningCategoryFilter?: ("mapping" | "parse" | "validation" | "configuration" | "resolution")[] | undefined;
     configPaths?: string[] | undefined;
-    atNamespace?: "obfuscated" | "mojang" | "srg" | undefined;
-    detail?: "full" | "summary" | "standard" | undefined;
+    detail?: "summary" | "standard" | "full" | undefined;
     include?: string[] | undefined;
+    atNamespace?: "obfuscated" | "mojang" | "srg" | undefined;
 }>, {
-    minSeverity: "all" | "error" | "warning";
     hideUncertain: boolean;
     explain: boolean;
     preferProjectMapping: boolean;
+    minSeverity: "all" | "error" | "warning";
+    reportMode: "full" | "summary-first" | "compact";
     treatInfoAsWarning: boolean;
     includeIssues: boolean;
-    task: "mixin" | "project-summary" | "access-widener" | "access-transformer";
+    task: "project-summary" | "mixin" | "access-transformer" | "access-widener";
     subject: {
         kind: "workspace";
         projectPath: string;
-        gradleUserHome?: string | undefined;
         discover?: ("mixins" | "access-wideners" | "access-transformers")[] | undefined;
+        gradleUserHome?: string | undefined;
     } | {
         kind: "mixin";
         input: {
@@ -621,22 +626,22 @@ export declare const validateProjectSchema: z.ZodEffects<z.ZodObject<{
     version?: string | undefined;
     mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
     scope?: "vanilla" | "merged" | "loader" | undefined;
-    sourcePriority?: "loom-first" | "maven-first" | undefined;
-    sourceRoots?: string[] | undefined;
     preferProjectVersion?: boolean | undefined;
+    sourcePriority?: "loom-first" | "maven-first" | undefined;
     warningMode?: "full" | "aggregated" | undefined;
+    sourceRoots?: string[] | undefined;
     warningCategoryFilter?: ("mapping" | "parse" | "validation" | "configuration" | "resolution")[] | undefined;
     configPaths?: string[] | undefined;
-    atNamespace?: "obfuscated" | "mojang" | "srg" | undefined;
-    detail?: "full" | "summary" | "standard" | undefined;
+    detail?: "summary" | "standard" | "full" | undefined;
     include?: string[] | undefined;
+    atNamespace?: "obfuscated" | "mojang" | "srg" | undefined;
 }, {
-    task: "mixin" | "project-summary" | "access-widener" | "access-transformer";
+    task: "project-summary" | "mixin" | "access-transformer" | "access-widener";
     subject: {
         kind: "workspace";
         projectPath: string;
-        gradleUserHome?: string | undefined;
         discover?: ("mixins" | "access-wideners" | "access-transformers")[] | undefined;
+        gradleUserHome?: string | undefined;
     } | {
         kind: "mixin";
         input: {
@@ -677,21 +682,22 @@ export declare const validateProjectSchema: z.ZodEffects<z.ZodObject<{
     version?: string | undefined;
     mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
     scope?: "vanilla" | "merged" | "loader" | undefined;
-    sourcePriority?: "loom-first" | "maven-first" | undefined;
-    sourceRoots?: string[] | undefined;
     preferProjectVersion?: boolean | undefined;
-    minSeverity?: "all" | "error" | "warning" | undefined;
     hideUncertain?: boolean | undefined;
     explain?: boolean | undefined;
-    warningMode?: "full" | "aggregated" | undefined;
     preferProjectMapping?: boolean | undefined;
-    warningCategoryFilter?: ("mapping" | "parse" | "validation" | "configuration" | "resolution")[] | undefined;
+    minSeverity?: "all" | "error" | "warning" | undefined;
+    reportMode?: "full" | "summary-first" | "compact" | undefined;
     treatInfoAsWarning?: boolean | undefined;
     includeIssues?: boolean | undefined;
+    sourcePriority?: "loom-first" | "maven-first" | undefined;
+    warningMode?: "full" | "aggregated" | undefined;
+    sourceRoots?: string[] | undefined;
+    warningCategoryFilter?: ("mapping" | "parse" | "validation" | "configuration" | "resolution")[] | undefined;
     configPaths?: string[] | undefined;
-    atNamespace?: "obfuscated" | "mojang" | "srg" | undefined;
-    detail?: "full" | "summary" | "standard" | undefined;
+    detail?: "summary" | "standard" | "full" | undefined;
     include?: string[] | undefined;
+    atNamespace?: "obfuscated" | "mojang" | "srg" | undefined;
 }>;
 export type ValidateProjectInput = z.infer<typeof validateProjectSchema>;
 export type ValidateProjectExecuteOptions = {

package/dist/entry-tools/validate-project-service.js

@@ -67,7 +67,9 @@ export const validateProjectShape = {
     warningMode: z.enum(["full", "aggregated"]).optional(),
     warningCategoryFilter: z.array(z.enum(["mapping", "configuration", "validation", "resolution", "parse"])).optional(),
     treatInfoAsWarning: z.boolean().default(true),
-    includeIssues: z.boolean().default(true)
+    includeIssues: z.boolean().default(true),
+    reportMode: z.enum(["compact", "full", "summary-first"]).default("summary-first")
+        .describe("Mixin report shape forwarded to validate-mixin. Default 'summary-first'; pass 'full' (or explain=true) for per-result resolvedMembers/toolHealth/resolutionTrace.")
 };
 export const validateProjectSchema = z.object(validateProjectShape).superRefine((value, ctx) => {
     if (value.task === "project-summary" && value.subject.kind !== "workspace") {

package/dist/entry-tools/verify-mixin-target-service.d.ts

@@ -14,6 +14,7 @@ export type VerifyMixinTargetInput = {
     };
     mixinMemberName?: string;
     mapping?: SourceMapping;
+    autoRemap?: boolean;
     sourcePriority?: MappingSourcePriority;
     projectPath?: string;
     gradleUserHome?: string;
@@ -91,6 +92,7 @@ export type VerifyMixinTargetDeps = {
         artifactId: string;
         mappingApplied: SourceMapping;
         binaryJarPath?: string;
+        version?: string;
         provenance?: ArtifactProvenance;
         warnings?: string[];
     }>;
@@ -101,11 +103,39 @@ export type VerifyMixinTargetDeps = {
         includeSynthetic: boolean;
         includeInherited: boolean;
     }) => Promise<ExplorerSignatureOutput>;
+    /**
+     * Optional mapping translator used by autoRemap to convert owner/member names
+     * from the request namespace into the artifact namespace. When absent,
+     * autoRemap is unavailable and a namespace mismatch surfaces as an error.
+     */
+    findMapping?: (input: {
+        version: string;
+        kind: "class" | "field" | "method";
+        name: string;
+        owner?: string;
+        descriptor?: string;
+        sourceMapping: SourceMapping;
+        targetMapping: SourceMapping;
+    }) => Promise<{
+        resolved: boolean;
+        resolvedSymbol?: {
+            name: string;
+            owner?: string;
+            descriptor?: string;
+        };
+    }>;
 };
 export declare class VerifyMixinTargetService {
     private readonly deps;
     constructor(deps: VerifyMixinTargetDeps);
     execute(input: VerifyMixinTargetInput): Promise<VerifyMixinTargetOutput>;
+    /**
+     * Translate owner + member from the request namespace into the artifact
+     * namespace via find-mapping, so a caller looking at yarn/intermediary
+     * sources can verify against an obfuscated artifact in one call. Throws a
+     * namespace-mismatch (or invalid-input) error when translation is impossible.
+     */
+    private applyAutoRemap;
 }
 export declare const verifyMixinTargetMemberSchemaExport: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"method">;

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

@@ -5,7 +5,7 @@ import { suggestSimilar } from "../mixin-validator.js";
 export const VERIFY_MIXIN_TARGET_OFF = process.env.VERIFY_MIXIN_TARGET_OFF === "1";
 const ACCESSOR_NAME_RE = /^(get|set|is)([A-Z]\w*)$/;
 const INVOKER_NAME_RE = /^(invoke|call)([A-Z]\w*)$/;
-function decodeAccessFlags(flags) {
+function decodeAccessFlags(flags, kind) {
     const labels = [];
     if (flags == null) {
         return labels;
@@ -23,9 +23,9 @@ function decodeAccessFlags(flags) {
     if ((flags & 0x0020) !== 0)
         labels.push("synchronized");
     if ((flags & 0x0040) !== 0)
-        labels.push("volatile");
+        labels.push(kind === "method" ? "bridge" : "volatile");
     if ((flags & 0x0080) !== 0)
-        labels.push("transient");
+        labels.push(kind === "method" ? "varargs" : "transient");
     if ((flags & 0x0100) !== 0)
         labels.push("native");
     if ((flags & 0x0400) !== 0)
@@ -137,11 +137,11 @@ function deriveVisibility(accessFlags) {
         return "private";
     return "package-private";
 }
-function buildMatch(member) {
+function buildMatch(member, kind) {
     return {
         name: member.name,
         descriptor: member.jvmDescriptor,
-        accessFlags: decodeAccessFlags(member.accessFlags),
+        accessFlags: decodeAccessFlags(member.accessFlags, kind),
         javaSignature: member.javaSignature,
         ...(member.sourceLine ? { sourceLine: member.sourceLine } : {})
     };
@@ -166,14 +166,15 @@ export class VerifyMixinTargetService {
                 details: { fieldErrors: [{ path: "target", message: "target is required" }] }
             });
         }
-        const owner = input.owner.trim();
+        let owner = input.owner.trim();
         if (!owner) {
             throw createError({
                 code: ERROR_CODES.INVALID_INPUT,
                 message: "owner must be non-empty."
             });
         }
-        const memberName = input.member.name.trim();
+        let member = input.member;
+        let memberName = member.name.trim();
         if (!memberName) {
             throw createError({
                 code: ERROR_CODES.INVALID_INPUT,
@@ -192,21 +193,29 @@ export class VerifyMixinTargetService {
         });
         const warnings = [...(resolved.warnings ?? [])];
         if (input.mapping && input.mapping !== resolved.mappingApplied) {
-            throw createError({
-                code: ERROR_CODES.NAMESPACE_MISMATCH,
-                message: `verify-mixin-target requires owner and member.name to be in the artifact's namespace `
-                    + `("${resolved.mappingApplied}"), but the request supplied mapping="${input.mapping}". `
-                    + `Automatic name/descriptor translation is not yet supported; supply owner+member in the artifact namespace, `
-                    + `or omit the mapping argument so the resolver picks the namespace automatically.`,
-                details: {
-                    owner,
-                    requestedMapping: input.mapping,
-                    mappingApplied: resolved.mappingApplied,
-                    artifactId: resolved.artifactId,
-                    nextAction: `Retry with mapping="${resolved.mappingApplied}" and owner/member translated to that namespace, `
-                        + `or use find-mapping to translate before calling verify-mixin-target.`
-                }
-            });
+            if (input.autoRemap) {
+                const remapped = await this.applyAutoRemap(input, resolved, owner, member, warnings);
+                owner = remapped.owner;
+                member = remapped.member;
+                memberName = member.name;
+            }
+            else {
+                throw createError({
+                    code: ERROR_CODES.NAMESPACE_MISMATCH,
+                    message: `verify-mixin-target requires owner and member.name to be in the artifact's namespace `
+                        + `("${resolved.mappingApplied}"), but the request supplied mapping="${input.mapping}". `
+                        + `Set autoRemap=true to translate names automatically, supply owner+member in the artifact namespace, `
+                        + `or omit the mapping argument so the resolver picks the namespace automatically.`,
+                    details: {
+                        owner,
+                        requestedMapping: input.mapping,
+                        mappingApplied: resolved.mappingApplied,
+                        artifactId: resolved.artifactId,
+                        nextAction: `Retry with autoRemap=true, or with mapping="${resolved.mappingApplied}" and owner/member already in that namespace, `
+                            + `or use find-mapping to translate before calling verify-mixin-target.`
+                    }
+                });
+            }
         }
         if (!resolved.binaryJarPath) {
             throw createError({
@@ -248,29 +257,29 @@ export class VerifyMixinTargetService {
             throw error;
         }
         warnings.push(...(signature.warnings ?? []));
-        const memberPool = input.member.kind === "method"
+        const memberPool = member.kind === "method"
             ? [...signature.constructors, ...signature.methods]
             : [...signature.fields];
         const allMemberNames = memberPool.map((m) => m.name);
         const exactNameHits = memberPool.filter((m) => m.name === memberName);
         let matches;
         let candidates = [];
-        if (input.member.descriptor) {
-            const descriptorHits = exactNameHits.filter((m) => m.jvmDescriptor === input.member.descriptor);
+        if (member.descriptor) {
+            const descriptorHits = exactNameHits.filter((m) => m.jvmDescriptor === member.descriptor);
             if (descriptorHits.length > 0) {
-                matches = descriptorHits.map(buildMatch);
+                matches = descriptorHits.map((m) => buildMatch(m, member.kind));
             }
             else {
                 matches = [];
                 candidates = exactNameHits.map((m) => ({
                     name: m.name,
                     descriptor: m.jvmDescriptor,
-                    reason: `name match, descriptor ${m.jvmDescriptor} differs from requested ${input.member.descriptor}`
+                    reason: `name match, descriptor ${m.jvmDescriptor} differs from requested ${member.descriptor}`
                 }));
             }
         }
         else {
-            matches = exactNameHits.map(buildMatch);
+            matches = exactNameHits.map((m) => buildMatch(m, member.kind));
         }
         if (matches.length === 0 && candidates.length === 0) {
             const suggestions = suggestSimilar(memberName, allMemberNames);
@@ -285,7 +294,7 @@ export class VerifyMixinTargetService {
         const exists = matches.length > 0;
         let accessorAdvice;
         if (matches.length === 1) {
-            accessorAdvice = inferAnnotation(input.member, matches[0], input.mixinMemberName);
+            accessorAdvice = inferAnnotation(member, matches[0], input.mixinMemberName);
         }
         return {
             exists,
@@ -306,6 +315,88 @@ export class VerifyMixinTargetService {
             }
         };
     }
+    /**
+     * Translate owner + member from the request namespace into the artifact
+     * namespace via find-mapping, so a caller looking at yarn/intermediary
+     * sources can verify against an obfuscated artifact in one call. Throws a
+     * namespace-mismatch (or invalid-input) error when translation is impossible.
+     */
+    async applyAutoRemap(input, resolved, owner, member, warnings) {
+        const sourceMapping = input.mapping;
+        const targetMapping = resolved.mappingApplied;
+        const mismatchDetails = {
+            owner,
+            member: member.name,
+            requestedMapping: sourceMapping,
+            mappingApplied: targetMapping,
+            artifactId: resolved.artifactId
+        };
+        if (!this.deps.findMapping) {
+            throw createError({
+                code: ERROR_CODES.NAMESPACE_MISMATCH,
+                message: `autoRemap is unavailable (no mapping translator configured); supply owner/member in the artifact namespace ("${targetMapping}").`,
+                details: mismatchDetails
+            });
+        }
+        const version = resolved.version ?? (input.target?.kind === "version" ? input.target.value : undefined);
+        if (!version) {
+            throw createError({
+                code: ERROR_CODES.INVALID_INPUT,
+                message: `autoRemap needs a Minecraft version to translate names; use target.kind="version" or a workspace that resolves one.`,
+                details: mismatchDetails
+            });
+        }
+        const classResult = await this.deps.findMapping({
+            version,
+            kind: "class",
+            name: owner,
+            sourceMapping,
+            targetMapping
+        });
+        if (!classResult.resolved || !classResult.resolvedSymbol) {
+            throw createError({
+                code: ERROR_CODES.NAMESPACE_MISMATCH,
+                message: `autoRemap could not translate owner "${owner}" from ${sourceMapping} to ${targetMapping}.`,
+                details: {
+                    ...mismatchDetails,
+                    nextAction: `Confirm "${owner}" exists in ${sourceMapping} for ${version}, or supply owner/member already in ${targetMapping}.`
+                }
+            });
+        }
+        const translatedOwner = classResult.resolvedSymbol.name;
+        // Look the member up by its source-namespace owner so find-mapping can
+        // locate it, then take the translated name/descriptor.
+        const memberResult = await this.deps.findMapping({
+            version,
+            kind: member.kind,
+            name: member.name,
+            owner,
+            descriptor: member.descriptor,
+            sourceMapping,
+            targetMapping
+        });
+        if (!memberResult.resolved || !memberResult.resolvedSymbol) {
+            throw createError({
+                code: ERROR_CODES.NAMESPACE_MISMATCH,
+                message: `autoRemap could not translate ${member.kind} "${member.name}" of "${owner}" from ${sourceMapping} to ${targetMapping}.`,
+                details: mismatchDetails
+            });
+        }
+        // Use the translated (target-namespace) descriptor only. Never fall back to
+        // the request descriptor: it is still in the source namespace and would
+        // never match the artifact's jvmDescriptor, turning a real member into a
+        // false exists=false. When no descriptor could be translated, match by name.
+        const translatedDescriptor = memberResult.resolvedSymbol.descriptor;
+        if (member.descriptor && !translatedDescriptor) {
+            warnings.push(`autoRemap could not translate the descriptor for ${member.kind} "${member.name}" into ${targetMapping}; matching by name only.`);
+        }
+        const translatedMember = (member.kind === "method"
+            ? { kind: "method", name: memberResult.resolvedSymbol.name, ...(translatedDescriptor ? { descriptor: translatedDescriptor } : {}) }
+            : { kind: "field", name: memberResult.resolvedSymbol.name, ...(translatedDescriptor ? { descriptor: translatedDescriptor } : {}) });
+        warnings.push(`autoRemap translated the target from ${sourceMapping} to ${targetMapping} (artifact namespace): `
+            + `${owner}#${member.name} -> ${translatedOwner}#${translatedMember.name}.`);
+        return { owner: translatedOwner, member: translatedMember };
+    }
 }
 const memberDescriptorSchema = z.string().trim().min(1).optional();
 const verifyMixinTargetMemberSchema = z.discriminatedUnion("kind", [