@adhisang/minecraft-modding-mcp 3.2.0 → 4.1.0

package/dist/source-service.d.ts

@@ -1,16 +1,27 @@
-import { type ResponseContext as ExplorerResponseContext, type SignatureMember } from "./minecraft-explorer-service.js";
-import { type MixinValidationResult, type MixinValidationProvenance, type MappingHealthReport, type AccessWidenerValidationResult, type AccessTransformerValidationResult } 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 { MinecraftExplorerService, type ResponseContext as ExplorerResponseContext, type SignatureMember } from "./minecraft-explorer-service.js";
+import { type MixinValidationResult, type MixinValidationProvenance, type MappingHealthReport, type AccessWidenerValidationResult, type AccessTransformerValidationResult, type MixinStageBudgets } from "./mixin-validator.js";
+import { MappingService, 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 { ArtifactsRepo } from "./storage/artifacts-repo.js";
+import { FilesRepo } from "./storage/files-repo.js";
+import { IndexMetaRepo } from "./storage/index-meta-repo.js";
+import { SymbolsRepo } from "./storage/symbols-repo.js";
 import { RuntimeMetrics, type RuntimeMetricSnapshot } from "./observability.js";
-import { type WorkspaceCompileMappingOutput } from "./workspace-mapping-service.js";
-import type { AccessTransformerNamespace, ArtifactProvenance, ArtifactRow, ArtifactScope, Config, MappingSourcePriority, ResolvedSourceArtifact, SourceMapping, SourceTargetInput } from "./types.js";
-import { type ListVersionsInput, type ListVersionsOutput } from "./version-service.js";
-import { type GetRegistryDataInput, type GetRegistryDataOutput } from "./registry-service.js";
-import { type CompareVersionsInput, type CompareVersionsOutput } from "./version-diff-service.js";
-import { type DecompileModJarInput, type DecompileModJarOutput, type GetModClassSourceInput, type GetModClassSourceOutput } from "./mod-decompile-service.js";
-import { type SearchModSourceInput, type SearchModSourceOutput } from "./mod-search-service.js";
+import { SourceServiceState } from "./source/state.js";
+import * as indexer from "./source/indexer.js";
+import * as workspaceTarget from "./source/workspace-target.js";
+import * as validateMixinModule from "./source/validate-mixin.js";
+import * as artifactResolver from "./source/artifact-resolver.js";
+import { type StageEmitter } from "./stage-emitter.js";
+import { WorkspaceMappingService, type WorkspaceCompileMappingOutput } from "./workspace-mapping-service.js";
+import { type WorkspaceContextCache } from "./workspace-context-cache.js";
+import type { AccessTransformerNamespace, ArtifactProvenance, ArtifactRow, ArtifactScope, Config, MappingSourcePriority, ResolveArtifactTargetInput, ResolvedSourceArtifact, RuntimeValidationProvenance, SourceMapping } from "./types.js";
+import { VersionService, type ListVersionsInput, type ListVersionsOutput } from "./version-service.js";
+import { RegistryService, type GetRegistryDataInput, type GetRegistryDataOutput } from "./registry-service.js";
+import { VersionDiffService, type CompareVersionsInput, type CompareVersionsOutput } from "./version-diff-service.js";
+import { ModDecompileService, type DecompileModJarInput, type DecompileModJarOutput, type GetModClassSourceInput, type GetModClassSourceOutput } from "./mod-decompile-service.js";
+import { ModSearchService, type SearchModSourceInput, type SearchModSourceOutput } from "./mod-search-service.js";
 export type ResolveArtifactInput = {
-    target: SourceTargetInput;
+    target: ResolveArtifactTargetInput;
     mapping?: SourceMapping;
     sourcePriority?: MappingSourcePriority;
     allowDecompile?: boolean;
@@ -18,9 +29,11 @@ export type ResolveArtifactInput = {
     scope?: ArtifactScope;
     preferProjectVersion?: boolean;
     strictVersion?: boolean;
+    compact?: boolean;
 };
 export type ResolveArtifactOutput = {
     artifactId: string;
+    artifactAlias: string;
     origin: "local-jar" | "local-m2" | "remote-repo" | "decompiled";
     isDecompiled: boolean;
     resolvedSourceJarPath?: string;
@@ -43,7 +56,7 @@ export type ArtifactContentsSummary = {
     resourcesIncluded: boolean;
     sourceCoverage: "full" | "partial";
 };
-type SymbolKind = "class" | "interface" | "enum" | "record" | "method" | "field";
+export type SymbolKind = "class" | "interface" | "enum" | "record" | "method" | "field";
 type SearchIntent = "symbol" | "text" | "path";
 type SearchMatch = "exact" | "prefix" | "contains" | "regex";
 export type SearchScope = {
@@ -74,6 +87,8 @@ export type SearchClassSourceInput = {
     queryMode?: QueryMode;
     limit?: number;
     cursor?: string;
+    queryNamespace?: SourceMapping;
+    sourcePriority?: MappingSourcePriority;
 };
 export type SearchClassSourceOutput = {
     hits: SearchSourceHit[];
@@ -81,6 +96,13 @@ export type SearchClassSourceOutput = {
     mappingApplied: SourceMapping;
     returnedNamespace: SourceMapping;
     artifactContents: ArtifactContentsSummary;
+    translatedQuery?: {
+        original: string;
+        translated: string;
+        fromNamespace: SourceMapping;
+        toNamespace: SourceMapping;
+    };
+    warnings?: string[];
 };
 export type GetArtifactFileInput = {
     artifactId: string;
@@ -135,7 +157,7 @@ export type ResolveWorkspaceSymbolOutput = MappingSymbolResolutionOutput & {
 export type SourceMode = "metadata" | "snippet" | "full";
 export type GetClassSourceInput = {
     artifactId?: string;
-    target?: SourceTargetInput;
+    target?: ResolveArtifactTargetInput;
     className: string;
     mode?: SourceMode;
     mapping?: SourceMapping;
@@ -192,7 +214,7 @@ export type FindClassOutput = {
 type MemberAccess = "public" | "all";
 export type GetClassMembersInput = {
     artifactId?: string;
-    target?: SourceTargetInput;
+    target?: ResolveArtifactTargetInput;
     className: string;
     mapping?: SourceMapping;
     sourcePriority?: MappingSourcePriority;
@@ -207,6 +229,18 @@ export type GetClassMembersInput = {
     preferProjectVersion?: boolean;
     strictVersion?: boolean;
 };
+export type DecompiledMember = {
+    name: string;
+    line: number;
+    kind: "constructor" | "field" | "method";
+};
+export type DecompiledFallback = {
+    constructors: DecompiledMember[];
+    fields: DecompiledMember[];
+    methods: DecompiledMember[];
+    origin: "source-extracted";
+};
+export type GetClassMembersStatus = "ok" | "members_unavailable" | "partial";
 export type GetClassMembersOutput = {
     className: string;
     members: {
@@ -230,6 +264,19 @@ export type GetClassMembersOutput = {
     provenance: ArtifactProvenance;
     qualityFlags: string[];
     artifactContents: ArtifactContentsSummary;
+    decompiledFallback?: DecompiledFallback;
+    decompiledMemberCounts?: {
+        constructors: number;
+        fields: number;
+        methods: number;
+        total: number;
+    };
+    status?: GetClassMembersStatus;
+    unavailableReason?: string;
+    suggestedCall?: {
+        tool: string;
+        params: Record<string, unknown>;
+    };
     warnings: string[];
 };
 export type TraceSymbolLifecycleInput = {
@@ -269,7 +316,7 @@ export type TraceSymbolLifecycleOutput = {
     timeline?: TraceSymbolLifecycleTimelineEntry[];
     warnings: string[];
 };
-type DiffClassChange = "added" | "removed" | "present_in_both" | "absent_in_both";
+export type DiffClassChange = "added" | "removed" | "present_in_both" | "absent_in_both";
 type DiffMemberChangedField = "accessFlags" | "isSynthetic" | "javaSignature" | "jvmDescriptor";
 export type DiffMember = SignatureMember;
 export type DiffMemberChange = {
@@ -330,24 +377,7 @@ export type DiffClassSignaturesOutput = {
     };
     warnings: string[];
 };
-export type IndexArtifactInput = {
-    artifactId: string;
-    force?: boolean;
-};
-type IndexRebuildReason = "force" | "missing_meta" | "schema_mismatch" | "signature_mismatch" | "already_current";
-export type IndexArtifactOutput = {
-    artifactId: string;
-    reindexed: boolean;
-    reason: IndexRebuildReason;
-    counts: {
-        files: number;
-        symbols: number;
-        ftsRows: number;
-    };
-    indexedAt: string;
-    durationMs: number;
-    mappingApplied: SourceMapping;
-};
+export type { IndexArtifactInput, IndexArtifactOutput } from "./source/indexer.js";
 export type ValidateMixinInput = {
     input: {
         mode: "inline";
@@ -382,6 +412,19 @@ export type ValidateMixinInput = {
     treatInfoAsWarning?: boolean;
     includeIssues?: boolean;
 };
+export type ValidateMixinOptions = {
+    stageEmitter?: StageEmitter;
+    /** Test-only override for stage budgets. Production code uses defaults. */
+    __stageBudgets?: Partial<MixinStageBudgets>;
+    /** Test-only hooks injected at stage boundaries to simulate slow work. */
+    __testHooks?: {
+        afterResolve?: () => Promise<void>;
+        afterMappingHealth?: () => Promise<void>;
+        afterParse?: () => Promise<void>;
+        beforeTargetLoop?: () => Promise<void>;
+        beforeTargetIter?: (targetIndex: number) => Promise<void>;
+    };
+};
 export type ValidateMixinResultSource = {
     kind: "inline" | "path" | "config";
     label: string;
@@ -392,6 +435,10 @@ export type ValidateMixinBatchResult = {
     source: ValidateMixinResultSource;
     result?: MixinValidationResult;
     error?: string;
+    /** Stable error code from AppError when the entry failed with a typed error (e.g. ERR_STAGE_BUDGET_PRE_PARSE). */
+    errorCode?: string;
+    /** AppError details (failedStage, stageBudgetExhausted, budgetMs, elapsedMs, …) preserved across batch aggregation. */
+    errorDetails?: Record<string, unknown>;
 };
 export type ValidateMixinBatchIssueSummaryItem = {
     kind: string;
@@ -440,34 +487,77 @@ export type ValidateAccessTransformerInput = {
 };
 export type ValidateAccessTransformerOutput = AccessTransformerValidationResult;
 export declare class SourceService {
-    private readonly config;
-    private readonly db;
-    private readonly artifactsRepo;
-    private readonly filesRepo;
-    private readonly indexMetaRepo;
-    private readonly symbolsRepo;
-    private readonly metrics;
-    private readonly versionService;
-    private readonly mappingService;
-    private readonly workspaceMappingService;
-    private readonly explorerService;
-    private readonly registryService;
-    private readonly versionDiffService;
-    private readonly modDecompileService;
-    private readonly modSearchService;
-    private cacheMetricsState;
-    constructor(explicitConfig?: Config, metrics?: RuntimeMetrics);
-    private discoverVersionSourceJar;
-    private discoverAccessWidenerRuntimeCandidates;
-    private discoverAccessTransformerRuntimeCandidates;
-    private resolveAccessWidenerRuntimeArtifact;
-    private resolveAccessTransformerNamespace;
-    private resolveAccessTransformerRuntimeArtifact;
-    private buildVersionSourceRecoveryCommand;
-    private buildArtifactContentsSummary;
-    private inferVersionFromContext;
-    private resolveVersionContext;
+    readonly config: Config;
+    readonly db: import("./storage/sqlite.js").default;
+    readonly artifactsRepo: ArtifactsRepo;
+    readonly filesRepo: FilesRepo;
+    readonly indexMetaRepo: IndexMetaRepo;
+    readonly symbolsRepo: SymbolsRepo;
+    readonly metrics: RuntimeMetrics;
+    readonly versionService: VersionService;
+    readonly mappingService: MappingService;
+    readonly workspaceMappingService: WorkspaceMappingService;
+    readonly workspaceContextCache: WorkspaceContextCache;
+    readonly explorerService: MinecraftExplorerService;
+    readonly registryService: RegistryService;
+    readonly versionDiffService: VersionDiffService;
+    readonly modDecompileService: ModDecompileService;
+    readonly modSearchService: ModSearchService;
+    readonly state: SourceServiceState;
+    constructor(explicitConfig?: Config, metrics?: RuntimeMetrics, deps?: {
+        workspaceContextCache?: WorkspaceContextCache;
+    });
     resolveArtifact(input: ResolveArtifactInput): Promise<ResolveArtifactOutput>;
+    synthesizeWorkspaceTarget(input: ResolveArtifactInput, workspace: import("./types.js").WorkspaceTargetInput): ReturnType<typeof workspaceTarget.synthesizeWorkspaceTarget>;
+    synthesizeDependencyTarget(input: ResolveArtifactInput, dep: import("./types.js").DependencyTargetInput): ReturnType<typeof workspaceTarget.synthesizeDependencyTarget>;
+    loadOrDetectWorkspaceContext(projectPath: string): ReturnType<typeof workspaceTarget.loadOrDetectWorkspaceContext>;
+    resolveAccessWidenerRuntimeArtifact(input: {
+        version: string;
+        awNamespace: SourceMapping;
+        projectPath?: string;
+        scope?: ArtifactScope;
+        preferProjectVersion?: boolean;
+    }): Promise<RuntimeValidationProvenance<SourceMapping>>;
+    resolveAccessTransformerNamespace(input: {
+        atNamespace?: AccessTransformerNamespace;
+        projectPath?: string;
+    }): Promise<AccessTransformerNamespace>;
+    resolveAccessTransformerRuntimeArtifact(input: {
+        version: string;
+        atNamespace: AccessTransformerNamespace;
+        projectPath?: string;
+        scope?: ArtifactScope;
+        preferProjectVersion?: boolean;
+    }): Promise<RuntimeValidationProvenance<AccessTransformerNamespace>>;
+    buildArtifactContentsSummary(input: {
+        origin: ResolvedSourceArtifact["origin"];
+        sourceJarPath?: string;
+        isDecompiled?: boolean;
+        qualityFlags: string[];
+    }): ArtifactContentsSummary;
+    discoverVersionSourceJar(input: {
+        version: string;
+        projectPath?: string;
+    }): ReturnType<typeof artifactResolver.discoverVersionSourceJar>;
+    discoverAccessWidenerRuntimeCandidates(input: {
+        version: string;
+        projectPath?: string;
+        requestedScope: ArtifactScope;
+    }): ReturnType<typeof artifactResolver.discoverAccessWidenerRuntimeCandidates>;
+    discoverAccessTransformerRuntimeCandidates(input: {
+        version: string;
+        projectPath?: string;
+        requestedScope: ArtifactScope;
+        atNamespace: AccessTransformerNamespace;
+        loader: import("./workspace-mapping-service.js").WorkspaceProjectLoader | "unknown";
+    }): ReturnType<typeof artifactResolver.discoverAccessTransformerRuntimeCandidates>;
+    buildMappingFallbackSuggestedCall(args: {
+        input: ResolveArtifactInput;
+        kind: import("./types.js").ArtifactTargetKind;
+        value: string;
+        scope: ArtifactScope | undefined;
+        effectiveMapping: SourceMapping;
+    }): ReturnType<typeof artifactResolver.buildMappingFallbackSuggestedCall>;
     searchClassSource(input: SearchClassSourceInput): Promise<SearchClassSourceOutput>;
     getArtifactFile(input: GetArtifactFileInput): Promise<GetArtifactFileOutput>;
     listArtifactFiles(input: ListArtifactFilesInput): Promise<ListArtifactFilesOutput>;
@@ -488,54 +578,37 @@ export declare class SourceService {
     findClass(input: FindClassInput): FindClassOutput;
     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;
+    validateMixin(input: ValidateMixinInput, options?: ValidateMixinOptions): Promise<ValidateMixinOutput>;
+    validateMixinSingle(input: validateMixinModule.ValidateMixinSingleInput): Promise<MixinValidationResult>;
+    remapSignatureMembers(members: SignatureMember[], kind: "field" | "method", version: string, sourceMapping: SourceMapping, targetMapping: SourceMapping, sourcePriority: MappingSourcePriority | undefined, warnings: string[], projectPath?: string): Promise<{
+        members: SignatureMember[];
+        failedNames: Set<string>;
+    }>;
     validateAccessWidener(input: ValidateAccessWidenerInput): Promise<ValidateAccessWidenerOutput>;
     validateAccessTransformer(input: ValidateAccessTransformerInput): Promise<ValidateAccessTransformerOutput>;
+    recordToolCall(tool: string, durationMs: number): void;
     getRuntimeMetrics(): RuntimeMetricSnapshot;
-    indexArtifact(input: IndexArtifactInput): Promise<IndexArtifactOutput>;
-    private searchSymbolIntent;
-    private searchTextIntentIndexed;
-    private searchPathIntentIndexed;
-    private searchTextIntent;
-    private searchPathIntent;
-    private findSymbolHits;
-    private indexedCandidateLimit;
-    private indexedCandidateLimitForMatch;
-    private extractClassMetadata;
-    private resolveClassFilePath;
-    private resolveBinaryFallbackArtifact;
-    private buildProvenance;
-    private buildFallbackProvenance;
-    private resolveClassNameForLookup;
-    private buildClassSourceNotFoundError;
-    private rejectLifecycleClassLikeInput;
-    private releaseLifecycleMappingGraph;
-    private resolveToObfuscatedClassName;
-    private resolveToObfuscatedMemberName;
-    private remapSignatureMembers;
-    private fallbackArtifactSignature;
-    private resolveIndexRebuildReason;
-    private toResolvedArtifact;
-    private rebuildAndPersistArtifactIndex;
-    private buildRebuiltArtifactData;
+    indexArtifact(input: indexer.IndexArtifactInput): Promise<indexer.IndexArtifactOutput>;
+    resolveClassNameForLookup(input: {
+        className: string;
+        version?: string;
+        sourceMapping: SourceMapping;
+        targetMapping: SourceMapping;
+        sourcePriority: MappingSourcePriority | undefined;
+        warnings: string[];
+        context: string;
+    }): Promise<string>;
+    resolveBinaryFallbackArtifact(input: {
+        binaryJarPath?: string;
+        version?: string;
+        coordinate?: string;
+        requestedMapping: SourceMapping;
+        mappingApplied: SourceMapping;
+        provenance?: ArtifactProvenance;
+        qualityFlags: string[];
+    }): Promise<ResolvedSourceArtifact | undefined>;
     getArtifact(artifactId: string): ArtifactRow;
-    private ingestIfNeeded;
-    private loadFromSourceJar;
-    private hasAnyFiles;
-    private enforceCacheLimits;
+    ingestIfNeeded(resolved: ResolvedSourceArtifact): Promise<void>;
     private refreshCacheMetrics;
-    private touchCacheMetrics;
-    private upsertCacheMetrics;
-    private removeCacheMetrics;
-    private publishCacheMetrics;
+    private snapshotLruAccounting;
 }
-export {};