@adhisang/minecraft-modding-mcp 4.0.0 → 4.1.1

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

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { type CacheRegistry } from "../cache-registry.js";
 export declare const manageCacheShape: {
     action: z.ZodEnum<["summary", "list", "inspect", "delete", "prune", "rebuild", "verify"]>;
-    cacheKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["artifact-index", "downloads", "mapping", "registry", "decompiled-source", "mod-remap", "binary-remap"]>, "many">>;
+    cacheKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["artifact-index", "downloads", "mapping", "registry", "decompiled-source", "mod-remap", "binary-remap", "workspace"]>, "many">>;
     selector: z.ZodOptional<z.ZodObject<{
         artifactId: z.ZodOptional<z.ZodString>;
         version: z.ZodOptional<z.ZodString>;
@@ -14,23 +14,23 @@ export declare const manageCacheShape: {
         scope: z.ZodOptional<z.ZodString>;
         projectPath: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        version?: string | undefined;
+        projectPath?: string | undefined;
         mapping?: string | undefined;
         jarPath?: string | undefined;
-        projectPath?: string | undefined;
         entryId?: string | undefined;
         artifactId?: string | undefined;
         status?: "healthy" | "partial" | "stale" | "orphaned" | "corrupt" | "in_use" | undefined;
-        version?: string | undefined;
         scope?: string | undefined;
         olderThan?: string | undefined;
     }, {
+        version?: string | undefined;
+        projectPath?: string | undefined;
         mapping?: string | undefined;
         jarPath?: string | undefined;
-        projectPath?: string | undefined;
         entryId?: string | undefined;
         artifactId?: string | undefined;
         status?: "healthy" | "partial" | "stale" | "orphaned" | "corrupt" | "in_use" | undefined;
-        version?: string | undefined;
         scope?: string | undefined;
         olderThan?: string | undefined;
     }>>;
@@ -42,7 +42,7 @@ export declare const manageCacheShape: {
 };
 export declare const manageCacheSchema: z.ZodObject<{
     action: z.ZodEnum<["summary", "list", "inspect", "delete", "prune", "rebuild", "verify"]>;
-    cacheKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["artifact-index", "downloads", "mapping", "registry", "decompiled-source", "mod-remap", "binary-remap"]>, "many">>;
+    cacheKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["artifact-index", "downloads", "mapping", "registry", "decompiled-source", "mod-remap", "binary-remap", "workspace"]>, "many">>;
     selector: z.ZodOptional<z.ZodObject<{
         artifactId: z.ZodOptional<z.ZodString>;
         version: z.ZodOptional<z.ZodString>;
@@ -54,23 +54,23 @@ export declare const manageCacheSchema: z.ZodObject<{
         scope: z.ZodOptional<z.ZodString>;
         projectPath: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        version?: string | undefined;
+        projectPath?: string | undefined;
         mapping?: string | undefined;
         jarPath?: string | undefined;
-        projectPath?: string | undefined;
         entryId?: string | undefined;
         artifactId?: string | undefined;
         status?: "healthy" | "partial" | "stale" | "orphaned" | "corrupt" | "in_use" | undefined;
-        version?: string | undefined;
         scope?: string | undefined;
         olderThan?: string | undefined;
     }, {
+        version?: string | undefined;
+        projectPath?: string | undefined;
         mapping?: string | undefined;
         jarPath?: string | undefined;
-        projectPath?: string | undefined;
         entryId?: string | undefined;
         artifactId?: string | undefined;
         status?: "healthy" | "partial" | "stale" | "orphaned" | "corrupt" | "in_use" | undefined;
-        version?: string | undefined;
         scope?: string | undefined;
         olderThan?: string | undefined;
     }>>;
@@ -86,15 +86,15 @@ export declare const manageCacheSchema: z.ZodObject<{
     cursor?: string | undefined;
     detail?: "full" | "summary" | "standard" | undefined;
     include?: string[] | undefined;
-    cacheKinds?: ("artifact-index" | "downloads" | "mapping" | "registry" | "decompiled-source" | "mod-remap" | "binary-remap")[] | undefined;
+    cacheKinds?: ("workspace" | "artifact-index" | "downloads" | "mapping" | "registry" | "decompiled-source" | "mod-remap" | "binary-remap")[] | undefined;
     selector?: {
+        version?: string | undefined;
+        projectPath?: string | undefined;
         mapping?: string | undefined;
         jarPath?: string | undefined;
-        projectPath?: string | undefined;
         entryId?: string | undefined;
         artifactId?: string | undefined;
         status?: "healthy" | "partial" | "stale" | "orphaned" | "corrupt" | "in_use" | undefined;
-        version?: string | undefined;
         scope?: string | undefined;
         olderThan?: string | undefined;
     } | undefined;
@@ -105,15 +105,15 @@ export declare const manageCacheSchema: z.ZodObject<{
     detail?: "full" | "summary" | "standard" | undefined;
     include?: string[] | undefined;
     executionMode?: "preview" | "apply" | undefined;
-    cacheKinds?: ("artifact-index" | "downloads" | "mapping" | "registry" | "decompiled-source" | "mod-remap" | "binary-remap")[] | undefined;
+    cacheKinds?: ("workspace" | "artifact-index" | "downloads" | "mapping" | "registry" | "decompiled-source" | "mod-remap" | "binary-remap")[] | undefined;
     selector?: {
+        version?: string | undefined;
+        projectPath?: string | undefined;
         mapping?: string | undefined;
         jarPath?: string | undefined;
-        projectPath?: string | undefined;
         entryId?: string | undefined;
         artifactId?: string | undefined;
         status?: "healthy" | "partial" | "stale" | "orphaned" | "corrupt" | "in_use" | undefined;
-        version?: string | undefined;
         scope?: string | undefined;
         olderThan?: string | undefined;
     } | undefined;

package/dist/entry-tools/validate-project/cases/access-transformer.d.ts

@@ -0,0 +1,6 @@
+import { type DetailLevel } from "../../response-contract.js";
+import type { ValidateProjectInput } from "../../validate-project-service.js";
+import { type ValidateProjectDeps } from "../internal.js";
+export declare function handleAccessTransformer(deps: ValidateProjectDeps, input: ValidateProjectInput, detail: DetailLevel, include: string[]): Promise<{
+    warnings: string[];
+}>;

package/dist/entry-tools/validate-project/cases/access-transformer.js

@@ -0,0 +1,106 @@
+import { readFile } from "node:fs/promises";
+import { buildEntryToolResult, createSummarySubject } from "../../response-contract.js";
+import { ERROR_CODES, createError } from "../../../errors.js";
+import { buildSuggestedCall } from "../../../build-suggested-call.js";
+export async function handleAccessTransformer(deps, input, detail, include) {
+    if (input.subject.kind !== "access-transformer") {
+        throw createError({
+            code: ERROR_CODES.INVALID_INPUT,
+            message: "task=access-transformer requires subject.kind=access-transformer.",
+            details: {
+                task: input.task,
+                subjectKind: input.subject.kind,
+                failedStage: "input-validation",
+                nextAction: "Set subject.kind to \"access-transformer\" for task=\"access-transformer\"."
+            }
+        });
+    }
+    if (!input.version) {
+        throw createError({
+            code: ERROR_CODES.INVALID_INPUT,
+            message: "task=access-transformer requires version.",
+            details: {
+                task: "access-transformer",
+                failedStage: "input-validation",
+                nextAction: "Pass version explicitly (e.g. \"1.21.10\"). Access Transformer validation resolves class names against a specific Minecraft version.",
+                ...buildSuggestedCall({
+                    tool: "validate-project",
+                    params: {
+                        task: "access-transformer",
+                        subject: input.subject,
+                        version: "1.21.10"
+                    }
+                })
+            }
+        });
+    }
+    const content = input.subject.input.mode === "inline"
+        ? input.subject.input.content
+        : await readFile(input.subject.input.path, "utf8");
+    if (!deps.validateAccessTransformer) {
+        throw createError({
+            code: ERROR_CODES.CONTEXT_UNRESOLVED,
+            message: "Access Transformer validation is not configured.",
+            details: {
+                task: "access-transformer",
+                failedStage: "dependency-resolution",
+                nextAction: "The current runtime was built without an Access Transformer validator. Rebuild the MCP server with validateAccessTransformer configured, or use task=\"access-widener\" if the workspace uses Fabric AccessWideners."
+            }
+        });
+    }
+    const output = await deps.validateAccessTransformer({
+        content,
+        version: input.version,
+        atNamespace: input.atNamespace,
+        sourcePriority: input.sourcePriority,
+        scope: input.scope,
+        preferProjectVersion: input.preferProjectVersion
+    });
+    const issueEntries = Array.isArray(output.entries)
+        ? output.entries.filter((entry) => {
+            if (!entry || typeof entry !== "object" || !("valid" in entry)) {
+                return true;
+            }
+            return entry.valid !== true;
+        })
+        : undefined;
+    return {
+        ...buildEntryToolResult({
+            task: "access-transformer",
+            detail,
+            include,
+            summary: {
+                status: output.valid ? "ok" : "invalid",
+                headline: output.valid
+                    ? "Access Transformer is valid."
+                    : "Access Transformer contains validation issues.",
+                subject: createSummarySubject({
+                    task: "access-transformer",
+                    kind: input.subject.kind,
+                    input: input.subject.input,
+                    version: input.version,
+                    sourcePriority: input.sourcePriority,
+                    scope: input.scope,
+                    atNamespace: input.atNamespace
+                }),
+                counts: {
+                    valid: output.valid ? 1 : 0,
+                    invalid: output.valid ? 0 : 1
+                }
+            },
+            blocks: {
+                project: {
+                    summary: {
+                        total: 1,
+                        valid: output.valid ? 1 : 0,
+                        invalid: output.valid ? 0 : 1
+                    }
+                },
+                issues: include.includes("issues") || detail !== "summary" ? issueEntries : undefined
+            },
+            alwaysBlocks: ["project"]
+        }),
+        warnings: Array.isArray(output.warnings) ? output.warnings : []
+    };
+}
+//# sourceMappingURL=access-transformer.js.map

package/dist/entry-tools/validate-project/cases/access-widener.d.ts

@@ -0,0 +1,6 @@
+import { type DetailLevel } from "../../response-contract.js";
+import type { ValidateProjectInput } from "../../validate-project-service.js";
+import { type ValidateProjectDeps } from "../internal.js";
+export declare function handleAccessWidener(deps: ValidateProjectDeps, input: ValidateProjectInput, detail: DetailLevel, include: string[]): Promise<{
+    warnings: string[];
+}>;

package/dist/entry-tools/validate-project/cases/access-widener.js

@@ -0,0 +1,86 @@
+import { readFile } from "node:fs/promises";
+import { buildEntryToolResult, createSummarySubject } from "../../response-contract.js";
+import { ERROR_CODES, createError } from "../../../errors.js";
+import { buildSuggestedCall } from "../../../build-suggested-call.js";
+export async function handleAccessWidener(deps, input, detail, include) {
+    if (input.subject.kind !== "access-widener") {
+        throw createError({
+            code: ERROR_CODES.INVALID_INPUT,
+            message: "task=access-widener requires subject.kind=access-widener.",
+            details: {
+                task: input.task,
+                subjectKind: input.subject.kind,
+                failedStage: "input-validation",
+                nextAction: "Set subject.kind to \"access-widener\" for task=\"access-widener\"."
+            }
+        });
+    }
+    if (!input.version) {
+        throw createError({
+            code: ERROR_CODES.INVALID_INPUT,
+            message: "task=access-widener requires version.",
+            details: {
+                task: "access-widener",
+                failedStage: "input-validation",
+                nextAction: "Pass version explicitly (e.g. \"1.21.10\"). Access Widener validation resolves class names against a specific Minecraft version.",
+                ...buildSuggestedCall({
+                    tool: "validate-project",
+                    params: {
+                        task: "access-widener",
+                        subject: input.subject,
+                        version: "1.21.10"
+                    }
+                })
+            }
+        });
+    }
+    const content = input.subject.input.mode === "inline"
+        ? input.subject.input.content
+        : await readFile(input.subject.input.path, "utf8");
+    const output = await deps.validateAccessWidener({
+        content,
+        version: input.version,
+        mapping: input.mapping,
+        sourcePriority: input.sourcePriority,
+        scope: input.scope,
+        preferProjectVersion: input.preferProjectVersion
+    });
+    return {
+        ...buildEntryToolResult({
+            task: "access-widener",
+            detail,
+            include,
+            summary: {
+                status: output.valid ? "ok" : "invalid",
+                headline: output.valid
+                    ? "Access Widener is valid."
+                    : "Access Widener contains validation issues.",
+                subject: createSummarySubject({
+                    task: "access-widener",
+                    kind: input.subject.kind,
+                    input: input.subject.input,
+                    version: input.version,
+                    mapping: input.mapping,
+                    sourcePriority: input.sourcePriority
+                }),
+                counts: {
+                    valid: output.valid ? 1 : 0,
+                    invalid: output.valid ? 0 : 1
+                }
+            },
+            blocks: {
+                project: {
+                    summary: {
+                        total: 1,
+                        valid: output.valid ? 1 : 0,
+                        invalid: output.valid ? 0 : 1
+                    }
+                },
+                issues: include.includes("issues") || detail !== "summary" ? output.issues : undefined
+            },
+            alwaysBlocks: ["project"]
+        }),
+        warnings: Array.isArray(output.warnings) ? output.warnings : []
+    };
+}
+//# sourceMappingURL=access-widener.js.map

package/dist/entry-tools/validate-project/cases/mixin.d.ts

@@ -0,0 +1,6 @@
+import { type DetailLevel } from "../../response-contract.js";
+import type { ValidateProjectInput } from "../../validate-project-service.js";
+import { type ValidateProjectDeps } from "../internal.js";
+export declare function handleMixin(deps: ValidateProjectDeps, input: ValidateProjectInput, detail: DetailLevel, include: string[]): Promise<{
+    warnings: string[];
+}>;

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

@@ -0,0 +1,90 @@
+import { buildEntryToolResult, createSummarySubject } from "../../response-contract.js";
+import { ERROR_CODES, createError } from "../../../errors.js";
+import { buildSuggestedCall } from "../../../build-suggested-call.js";
+export async function handleMixin(deps, input, detail, include) {
+    if (input.subject.kind !== "mixin") {
+        throw createError({
+            code: ERROR_CODES.INVALID_INPUT,
+            message: "task=mixin requires subject.kind=mixin.",
+            details: {
+                task: input.task,
+                subjectKind: input.subject.kind,
+                failedStage: "input-validation",
+                nextAction: "Set subject.kind to \"mixin\" for task=\"mixin\"."
+            }
+        });
+    }
+    if (!input.version) {
+        throw createError({
+            code: ERROR_CODES.INVALID_INPUT,
+            message: "task=mixin requires version.",
+            details: {
+                task: "mixin",
+                failedStage: "input-validation",
+                nextAction: "Pass version explicitly (e.g. \"1.21.10\"). task=\"project-summary\" supports preferProjectVersion for auto-detection from gradle.properties, but direct task=\"mixin\" requires an explicit version.",
+                ...buildSuggestedCall({
+                    tool: "validate-project",
+                    params: {
+                        task: "mixin",
+                        subject: input.subject,
+                        version: "1.21.10"
+                    }
+                })
+            }
+        });
+    }
+    const output = await deps.validateMixin({
+        input: input.subject.input,
+        version: input.version,
+        mapping: input.mapping,
+        sourcePriority: input.sourcePriority,
+        scope: input.scope,
+        preferProjectVersion: input.preferProjectVersion,
+        preferProjectMapping: input.preferProjectMapping,
+        sourceRoots: input.sourceRoots,
+        minSeverity: input.minSeverity,
+        hideUncertain: input.hideUncertain,
+        explain: input.explain,
+        warningMode: input.warningMode,
+        warningCategoryFilter: input.warningCategoryFilter,
+        treatInfoAsWarning: input.treatInfoAsWarning,
+        includeIssues: input.includeIssues
+    });
+    const summary = output.summary;
+    const invalidCount = summary?.invalid ?? 0;
+    const partialCount = summary?.partial ?? 0;
+    return {
+        ...buildEntryToolResult({
+            task: "mixin",
+            detail,
+            include,
+            summary: {
+                status: invalidCount > 0 ? "invalid" : partialCount > 0 ? "partial" : "ok",
+                headline: `Validated ${summary?.total ?? 0} mixin input(s).`,
+                subject: createSummarySubject({
+                    task: "mixin",
+                    kind: input.subject.kind,
+                    input: input.subject.input,
+                    version: input.version,
+                    mapping: input.mapping,
+                    sourcePriority: input.sourcePriority,
+                    scope: input.scope
+                }),
+                counts: {
+                    valid: summary?.valid ?? 0,
+                    partial: partialCount,
+                    invalid: invalidCount
+                }
+            },
+            blocks: {
+                project: {
+                    summary
+                },
+                issues: include.includes("issues") || detail !== "summary" ? output.results : undefined
+            },
+            alwaysBlocks: ["project"]
+        }),
+        warnings: Array.isArray(output.warnings) ? output.warnings : []
+    };
+}
+//# sourceMappingURL=mixin.js.map

package/dist/entry-tools/validate-project/cases/project-summary.d.ts

@@ -0,0 +1,102 @@
+import { type DetailLevel } from "../../response-contract.js";
+import type { StageEmitter } from "../../../stage-emitter.js";
+import type { ValidateProjectInput } from "../../validate-project-service.js";
+import { type ValidateProjectDeps } from "../internal.js";
+type ProjectSummaryOptions = {
+    stageEmitter?: StageEmitter;
+};
+export declare function handleProjectSummary(deps: ValidateProjectDeps, input: ValidateProjectInput, detail: DetailLevel, include: string[], options?: ProjectSummaryOptions): Promise<{
+    warnings: string[];
+    tasks?: {
+        "workspace.detected": {
+            status: "error" | "ok" | "skipped" | "missing";
+            durationMs?: number;
+            error?: {
+                code: string;
+                detail: string;
+            };
+            warnings?: string[];
+        } & {
+            evidence?: string[];
+        };
+        "gradle.readable": {
+            status: "error" | "ok" | "skipped" | "missing";
+            durationMs?: number;
+            error?: {
+                code: string;
+                detail: string;
+            };
+            warnings?: string[];
+        } & {
+            propertiesPath?: string;
+            buildScripts?: string[];
+        };
+        "loom.cache.found": {
+            status: "error" | "ok" | "skipped" | "missing";
+            durationMs?: number;
+            error?: {
+                code: string;
+                detail: string;
+            };
+            warnings?: string[];
+        } & {
+            cachePath?: string;
+        };
+        "minecraft.artifact.resolved": {
+            status: "error" | "ok" | "skipped" | "missing";
+            durationMs?: number;
+            error?: {
+                code: string;
+                detail: string;
+            };
+            warnings?: string[];
+        } & {
+            artifactId?: string;
+            mapping?: import("../../../types.js").SourceMapping;
+        };
+        "mixins.validated": {
+            status: "error" | "ok" | "skipped" | "missing";
+            durationMs?: number;
+            error?: {
+                code: string;
+                detail: string;
+            };
+            warnings?: string[];
+        } & {
+            counts?: {
+                ok: number;
+                partial: number;
+                invalid: number;
+            };
+        };
+        "accessWideners.validated": {
+            status: "error" | "ok" | "skipped" | "missing";
+            durationMs?: number;
+            error?: {
+                code: string;
+                detail: string;
+            };
+            warnings?: string[];
+        } & {
+            counts?: {
+                ok: number;
+                invalid: number;
+            };
+        };
+        "accessTransformers.validated": {
+            status: "error" | "ok" | "skipped" | "missing";
+            durationMs?: number;
+            error?: {
+                code: string;
+                detail: string;
+            };
+            warnings?: string[];
+        } & {
+            counts?: {
+                ok: number;
+                invalid: number;
+            };
+        };
+    } | undefined;
+}>;
+export {};