@adhisang/minecraft-modding-mcp 3.2.0 → 4.1.0

package/dist/mapping-pipeline-service.js

@@ -1,10 +1,12 @@
+import { buildSuggestedCall } from "./build-suggested-call.js";
 import { createError, ERROR_CODES } from "./errors.js";
 /**
  * Mapping pipeline for v0.3.
  * Current implementation enforces explicit guarantees:
  * - obfuscated: always pass-through
  * - mojang: requires source-backed artifacts on legacy obfuscated versions,
- *   but unobfuscated runtime jars can pass through directly
+ *   but unobfuscated runtime jars can pass through directly,
+ *   or binary-only artifacts may be remapped + decompiled when allowBinaryRemap=true
  */
 export function applyMappingPipeline(input) {
     const transformChain = [];
@@ -51,6 +53,17 @@ export function applyMappingPipeline(input) {
     }
     const hasSource = Boolean(input.resolved.sourceJarPath);
     if (!hasSource) {
+        if (input.requestedMapping === "mojang" &&
+            input.allowBinaryRemap === true &&
+            Boolean(input.resolved.binaryJarPath)) {
+            transformChain.push("binary-remap:obf->mojang", "decompile:vineflower");
+            qualityFlags.push("binary-remapped", "decompiled");
+            return {
+                mappingApplied: "mojang",
+                qualityFlags,
+                transformChain
+            };
+        }
         throw createError({
             code: ERROR_CODES.MAPPING_NOT_APPLIED,
             message: `Requested ${input.requestedMapping} mapping cannot be guaranteed for this artifact because only decompile path is available.`,
@@ -62,13 +75,13 @@ export function applyMappingPipeline(input) {
                 binaryJarPath: input.resolved.binaryJarPath,
                 sourceJarPath: input.resolved.sourceJarPath,
                 nextAction: "Provide a source-backed artifact (source jar) or use mapping=obfuscated.",
-                suggestedCall: {
+                ...buildSuggestedCall({
                     tool: "resolve-artifact",
                     params: {
                         target: input.target,
                         mapping: "obfuscated"
                     }
-                }
+                })
             }
         });
     }

package/dist/mapping-service.d.ts

@@ -1,153 +1,24 @@
 import type { Config, MappingSourcePriority, SourceMapping } from "./types.js";
 import { VersionService } from "./version-service.js";
-type MappingLookupSource = "loom-cache" | "maven" | "mojang-client-mappings";
-type MappingSymbolKind = "class" | "field" | "method";
+import type { ClassApiMatrixInput, ClassApiMatrixOutput, EnsureMappingAvailableInput, EnsureMappingAvailableOutput, FindMappingInput, FindMappingOutput, ResolveMethodMappingExactInput, ResolveMethodMappingExactOutput, SymbolExistenceInput, SymbolExistenceOutput } from "./mapping/types.js";
+export type { ClassApiMatrixEntry, ClassApiMatrixInput, ClassApiMatrixKind, ClassApiMatrixOutput, ClassApiMatrixRow, EnsureMappingAvailableInput, EnsureMappingAvailableOutput, FindMappingInput, FindMappingOutput, MappingLookupCandidate, MappingLookupProvenance, MappingMatchKind, ResolveMethodMappingExactInput, ResolveMethodMappingExactOutput, SymbolExistenceInput, SymbolExistenceOutput, SymbolQueryInput, SymbolQueryKind, SymbolReference, SymbolResolutionOutput, SymbolResolutionStatus } from "./mapping/types.js";
 type VersionMappingsResolver = Pick<VersionService, "resolveVersionMappings">;
-export type MappingMatchKind = "exact" | "normalized" | "simple-name";
-export type MappingLookupCandidate = {
-    symbol: string;
-    matchKind: MappingMatchKind;
-    confidence: number;
-    kind: MappingSymbolKind;
-    owner?: string;
-    name: string;
-    descriptor?: string;
-};
-export type MappingLookupProvenance = {
-    source: MappingLookupSource;
-    mappingArtifact: string;
-    version: string;
-    priority: MappingSourcePriority;
-};
-export type SymbolQueryKind = MappingSymbolKind;
-export type SymbolQueryInput = {
-    kind: SymbolQueryKind;
-    name: string;
-    owner?: string;
-    descriptor?: string;
-};
-export type SymbolReference = {
-    kind: SymbolQueryKind;
-    name: string;
-    owner?: string;
-    descriptor?: string;
-    symbol: string;
-};
-export type SymbolResolutionStatus = "resolved" | "not_found" | "ambiguous" | "mapping_unavailable";
-export type SymbolResolutionOutput = {
-    querySymbol: SymbolReference;
-    mappingContext: {
-        version: string;
-        sourceMapping: SourceMapping;
-        targetMapping?: SourceMapping;
-        sourcePriorityApplied: MappingSourcePriority;
-    };
-    resolved: boolean;
-    status: SymbolResolutionStatus;
-    resolvedSymbol?: SymbolReference;
-    candidates: Array<SymbolReference & Pick<MappingLookupCandidate, "matchKind" | "confidence">>;
-    candidateCount: number;
-    candidatesTruncated?: boolean;
-    warnings: string[];
-    provenance?: MappingLookupProvenance;
-    ambiguityReasons?: string[];
-};
-export type FindMappingInput = {
-    version: string;
-    kind: SymbolQueryKind;
-    name: string;
-    owner?: string;
-    descriptor?: string;
-    signatureMode?: "exact" | "name-only";
-    sourceMapping: SourceMapping;
-    targetMapping: SourceMapping;
-    sourcePriority?: MappingSourcePriority;
-    projectPath?: string;
-    disambiguation?: {
-        ownerHint?: string;
-        descriptorHint?: string;
-    };
-    maxCandidates?: number;
-};
-export type FindMappingOutput = SymbolResolutionOutput;
-export type EnsureMappingAvailableInput = {
-    version: string;
-    sourceMapping: SourceMapping;
-    targetMapping: SourceMapping;
-    sourcePriority?: MappingSourcePriority;
-    projectPath?: string;
-};
-export type EnsureMappingAvailableOutput = {
-    transformChain: string[];
-    warnings: string[];
-    provenance?: MappingLookupProvenance;
-};
-export type ResolveMethodMappingExactInput = {
-    version: string;
-    name: string;
-    owner: string;
-    descriptor: string;
-    sourceMapping: SourceMapping;
-    targetMapping: SourceMapping;
-    sourcePriority?: MappingSourcePriority;
-    projectPath?: string;
-    maxCandidates?: number;
-};
-export type ResolveMethodMappingExactOutput = SymbolResolutionOutput;
-export type ClassApiMatrixKind = "class" | "field" | "method";
-export type ClassApiMatrixInput = {
-    version: string;
-    className: string;
-    classNameMapping: SourceMapping;
-    sourcePriority?: MappingSourcePriority;
-    includeKinds?: ClassApiMatrixKind[];
-    maxRows?: number;
-};
-export type ClassApiMatrixEntry = {
-    symbol: string;
-    owner?: string;
-    name: string;
-    descriptor?: string;
-};
-export type ClassApiMatrixRow = {
-    kind: ClassApiMatrixKind;
-    descriptor?: string;
-    obfuscated?: ClassApiMatrixEntry;
-    mojang?: ClassApiMatrixEntry;
-    intermediary?: ClassApiMatrixEntry;
-    yarn?: ClassApiMatrixEntry;
-    completeness: boolean;
-};
-export type ClassApiMatrixOutput = {
-    version: string;
-    className: string;
-    classNameMapping: SourceMapping;
-    classIdentity: Partial<Record<SourceMapping, string>>;
-    rows: ClassApiMatrixRow[];
-    rowCount: number;
-    rowsTruncated?: boolean;
-    warnings: string[];
-    ambiguousRowCount?: number;
-};
-export type SymbolExistenceInput = {
-    version: string;
-    kind: SymbolQueryKind;
-    name: string;
-    owner?: string;
-    descriptor?: string;
-    sourceMapping: SourceMapping;
-    sourcePriority?: MappingSourcePriority;
-    nameMode?: "fqcn" | "auto";
-    signatureMode?: "exact" | "name-only";
-    maxCandidates?: number;
-};
-export type SymbolExistenceOutput = SymbolResolutionOutput;
 export declare class MappingService {
     private readonly config;
     private readonly versionService;
     private readonly fetchFn;
     private readonly graphCache;
     private readonly buildLocks;
+    private readonly resolutionCache;
+    private static readonly RESOLUTION_CACHE_MAX;
+    private static readonly RESOLUTION_CACHE_TTL_MS;
+    private resolutionCacheHits;
+    private resolutionCacheMisses;
+    get resolutionCacheStats(): {
+        hits: number;
+        misses: number;
+        size: number;
+    };
     constructor(config: Config, versionService?: VersionMappingsResolver, fetchFn?: typeof fetch);
     findMapping(input: FindMappingInput): Promise<FindMappingOutput>;
     ensureMappingAvailable(input: EnsureMappingAvailableInput): Promise<EnsureMappingAvailableOutput>;
@@ -178,10 +49,11 @@ export declare class MappingService {
     private loadMojangPairs;
     private loadTinyPairsFromLoom;
     private loadTinyPairsFromMaven;
-    private parseTinyFromJar;
-    private fetchYarnCoordinates;
+    private loaderDeps;
     private trimGraphCache;
     releaseGraphCacheEntry(version: string, sourcePriority?: MappingSourcePriority): void;
+    private buildResolutionCacheKey;
+    private trimResolutionCache;
 }
 /**
  * Resolve and cache a Tiny v2 mapping file for the given Minecraft version.
@@ -193,4 +65,3 @@ export declare class MappingService {
  * @returns Path to the extracted Tiny v2 file
  */
 export declare function resolveTinyMappingFile(version: string, mapping: "intermediary" | "yarn", cacheDir: string, fetchFn?: typeof fetch): Promise<string>;
-export {};