@adhisang/minecraft-modding-mcp 2.0.0 → 3.0.0

package/dist/source-service.d.ts

@@ -1,5 +1,5 @@
 import { type ResponseContext as ExplorerResponseContext, type SignatureMember } from "./minecraft-explorer-service.js";
-import { type MixinValidationResult, type MappingHealthReport, type AccessWidenerValidationResult } from "./mixin-validator.js";
+import { type MixinValidationResult, type MixinValidationProvenance, type MappingHealthReport, type AccessWidenerValidationResult } from "./mixin-validator.js";
 import { type ClassApiMatrixInput as MappingClassApiMatrixInput, type ClassApiMatrixOutput as MappingClassApiMatrixOutput, type FindMappingInput as MappingFindMappingInput, type FindMappingOutput as MappingFindMappingOutput, type ResolveMethodMappingExactInput as MappingResolveMethodMappingExactInput, type ResolveMethodMappingExactOutput as MappingResolveMethodMappingExactOutput, type SymbolResolutionOutput as MappingSymbolResolutionOutput, type SymbolExistenceInput as MappingSymbolExistenceInput, type SymbolExistenceOutput as MappingSymbolExistenceOutput } from "./mapping-service.js";
 import { RuntimeMetrics, type RuntimeMetricSnapshot } from "./observability.js";
 import { type WorkspaceCompileMappingOutput } from "./workspace-mapping-service.js";
@@ -33,9 +33,16 @@ export type ResolveArtifactOutput = {
     provenance: ArtifactProvenance;
     qualityFlags: string[];
     repoUrl?: string;
+    artifactContents: ArtifactContentsSummary;
     warnings: string[];
     sampleEntries?: string[];
 };
+export type ArtifactContentsSummary = {
+    sourceKind: "source-jar" | "decompiled-binary";
+    indexedContentKinds: string[];
+    resourcesIncluded: boolean;
+    sourceCoverage: "full" | "partial";
+};
 type SymbolKind = "class" | "interface" | "enum" | "record" | "method" | "field";
 type SearchIntent = "symbol" | "text" | "path";
 type SearchMatch = "exact" | "prefix" | "contains" | "regex";
@@ -72,6 +79,8 @@ export type SearchClassSourceOutput = {
     hits: SearchSourceHit[];
     nextCursor?: string;
     mappingApplied: SourceMapping;
+    returnedNamespace: SourceMapping;
+    artifactContents: ArtifactContentsSummary;
 };
 export type GetArtifactFileInput = {
     artifactId: string;
@@ -84,6 +93,8 @@ export type GetArtifactFileOutput = {
     contentBytes: number;
     truncated: boolean;
     mappingApplied: SourceMapping;
+    returnedNamespace: SourceMapping;
+    artifactContents: ArtifactContentsSummary;
 };
 export type ListArtifactFilesInput = {
     artifactId: string;
@@ -95,6 +106,8 @@ export type ListArtifactFilesOutput = {
     items: string[];
     nextCursor?: string;
     mappingApplied: SourceMapping;
+    artifactContents: ArtifactContentsSummary;
+    warnings: string[];
 };
 export type FindMappingInput = MappingFindMappingInput;
 export type FindMappingOutput = MappingFindMappingOutput;
@@ -114,6 +127,7 @@ export type ResolveWorkspaceSymbolInput = {
     descriptor?: string;
     sourceMapping: SourceMapping;
     sourcePriority?: MappingSourcePriority;
+    maxCandidates?: number;
 };
 export type ResolveWorkspaceSymbolOutput = MappingSymbolResolutionOutput & {
     workspaceDetection: WorkspaceCompileMappingOutput;
@@ -152,8 +166,10 @@ export type GetClassSourceOutput = {
     artifactId: string;
     requestedMapping: SourceMapping;
     mappingApplied: SourceMapping;
+    returnedNamespace: SourceMapping;
     provenance: ArtifactProvenance;
     qualityFlags: string[];
+    artifactContents: ArtifactContentsSummary;
     outputFile?: string;
     warnings: string[];
 };
@@ -210,8 +226,10 @@ export type GetClassMembersOutput = {
     artifactId: string;
     requestedMapping: SourceMapping;
     mappingApplied: SourceMapping;
+    returnedNamespace: SourceMapping;
     provenance: ArtifactProvenance;
     qualityFlags: string[];
+    artifactContents: ArtifactContentsSummary;
     warnings: string[];
 };
 export type TraceSymbolLifecycleInput = {
@@ -256,9 +274,9 @@ type DiffMemberChangedField = "accessFlags" | "isSynthetic" | "javaSignature" |
 export type DiffMember = SignatureMember;
 export type DiffMemberChange = {
     key: string;
-    from: DiffMember;
-    to: DiffMember;
     changed: DiffMemberChangedField[];
+    from?: DiffMember;
+    to?: DiffMember;
 };
 export type DiffClassMemberDelta = {
     added: DiffMember[];
@@ -271,6 +289,7 @@ export type DiffClassSignaturesInput = {
     toVersion: string;
     mapping?: SourceMapping;
     sourcePriority?: MappingSourcePriority;
+    includeFullDiff?: boolean;
 };
 export type DiffClassSignaturesOutput = {
     query: {
@@ -342,6 +361,9 @@ export type ValidateMixinInput = {
     } | {
         mode: "config";
         configPaths: string[];
+    } | {
+        mode: "project";
+        path: string;
     };
     sourceRoots?: string[];
     version: string;
@@ -355,9 +377,10 @@ export type ValidateMixinInput = {
     explain?: boolean;
     warningMode?: "full" | "aggregated";
     preferProjectMapping?: boolean;
-    reportMode?: "compact" | "full";
+    reportMode?: "compact" | "full" | "summary-first";
     warningCategoryFilter?: ("mapping" | "configuration" | "validation" | "resolution" | "parse")[];
     treatInfoAsWarning?: boolean;
+    includeIssues?: boolean;
 };
 export type ValidateMixinResultSource = {
     kind: "inline" | "path" | "config";
@@ -383,12 +406,15 @@ export type ValidateMixinOutput = {
     summary: {
         total: number;
         valid: number;
+        partial: number;
         invalid: number;
         processingErrors: number;
         totalValidationErrors: number;
         totalValidationWarnings: number;
     };
     issueSummary?: ValidateMixinBatchIssueSummaryItem[];
+    provenance?: MixinValidationProvenance;
+    incompleteReasons?: string[];
     toolHealth?: MappingHealthReport;
     confidenceScore?: number;
     warnings: string[];
@@ -416,9 +442,13 @@ export declare class SourceService {
     private readonly versionDiffService;
     private readonly modDecompileService;
     private readonly modSearchService;
+    private cacheMetricsState;
     constructor(explicitConfig?: Config, metrics?: RuntimeMetrics);
     private discoverVersionSourceJar;
     private buildVersionSourceRecoveryCommand;
+    private buildArtifactContentsSummary;
+    private inferVersionFromContext;
+    private resolveVersionContext;
     resolveArtifact(input: ResolveArtifactInput): Promise<ResolveArtifactOutput>;
     searchClassSource(input: SearchClassSourceInput): Promise<SearchClassSourceOutput>;
     getArtifactFile(input: GetArtifactFileInput): Promise<GetArtifactFileOutput>;
@@ -440,10 +470,14 @@ export declare class SourceService {
     getClassSource(input: GetClassSourceInput): Promise<GetClassSourceOutput>;
     getClassMembers(input: GetClassMembersInput): Promise<GetClassMembersOutput>;
     validateMixin(input: ValidateMixinInput): Promise<ValidateMixinOutput>;
+    private createProjectValidateMixinConfigInput;
+    private shouldRetryValidateMixinWithMavenFirst;
+    private findValidateMixinClassMapping;
     private validateMixinSingle;
     private resolveMixinInputPath;
     private resolveMixinConfigSources;
     private validateMixinMany;
+    private applyValidateMixinOutputCompaction;
     private buildValidateMixinOutput;
     validateAccessWidener(input: ValidateAccessWidenerInput): Promise<ValidateAccessWidenerOutput>;
     getRuntimeMetrics(): RuntimeMetricSnapshot;
@@ -478,5 +512,9 @@ export declare class SourceService {
     private hasAnyFiles;
     private enforceCacheLimits;
     private refreshCacheMetrics;
+    private touchCacheMetrics;
+    private upsertCacheMetrics;
+    private removeCacheMetrics;
+    private publishCacheMetrics;
 }
 export {};