@adhisang/minecraft-modding-mcp 4.1.0 → 4.2.0

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

@@ -58,6 +58,7 @@ export const subjectSchema = z.discriminatedUnion("kind", [
         mapping: z.enum(["obfuscated", "mojang", "intermediary", "yarn"]).optional(),
         scope: z.enum(["vanilla", "merged", "loader"]).optional(),
         projectPath: nonEmptyString.optional(),
+        gradleUserHome: nonEmptyString.optional(),
         preferProjectVersion: z.boolean().optional(),
         strictVersion: z.boolean().optional()
     }),
@@ -67,6 +68,7 @@ export const subjectSchema = z.discriminatedUnion("kind", [
         mapping: z.enum(["obfuscated", "mojang", "intermediary", "yarn"]).optional(),
         scope: z.enum(["vanilla", "merged", "loader"]).optional(),
         projectPath: nonEmptyString.optional(),
+        gradleUserHome: nonEmptyString.optional(),
         preferProjectVersion: z.boolean().optional(),
         strictVersion: z.boolean().optional()
     }),
@@ -77,6 +79,7 @@ export const subjectSchema = z.discriminatedUnion("kind", [
         mapping: z.enum(["obfuscated", "mojang", "intermediary", "yarn"]).optional(),
         scope: z.enum(["vanilla", "merged", "loader"]).optional(),
         projectPath: nonEmptyString.optional(),
+        gradleUserHome: nonEmptyString.optional(),
         preferProjectVersion: z.boolean().optional(),
         strictVersion: z.boolean().optional()
     }),
@@ -101,6 +104,7 @@ export const subjectSchema = z.discriminatedUnion("kind", [
         projectPath: nonEmptyString,
         mapping: z.enum(["obfuscated", "mojang", "intermediary", "yarn"]).optional(),
         scope: z.enum(["vanilla", "merged", "loader"]).optional(),
+        gradleUserHome: nonEmptyString.optional(),
         preferProjectVersion: z.boolean().optional(),
         strictVersion: z.boolean().optional(),
         focus: workspaceFocusSchema.optional()
@@ -171,6 +175,7 @@ export function buildClassSubject(subject) {
         className: workspaceFocus.className,
         artifact: workspaceFocus.artifact,
         projectPath: subject.projectPath,
+        ...(subject.gradleUserHome !== undefined ? { gradleUserHome: subject.gradleUserHome } : {}),
         mapping: subject.mapping,
         scope: subject.scope,
         preferProjectVersion: subject.preferProjectVersion,
@@ -198,6 +203,7 @@ export async function resolveWorkspaceArtifactReference(deps, subject, artifactR
         mapping: subject.mapping,
         scope: subject.scope,
         projectPath: subject.projectPath,
+        ...(subject.gradleUserHome !== undefined ? { gradleUserHome: subject.gradleUserHome } : {}),
         preferProjectVersion: subject.preferProjectVersion,
         strictVersion: subject.strictVersion
     });
@@ -343,6 +349,7 @@ export async function resolveBinaryBackedClass(deps, className, input) {
             kind: "class",
             name: className,
             sourceMapping: input.mapping ?? "obfuscated",
+            ...(input.gradleUserHome !== undefined ? { gradleUserHome: input.gradleUserHome } : {}),
             nameMode: className.includes(".") ? "fqcn" : "auto",
             maxCandidates: 10
         });
@@ -391,6 +398,7 @@ export async function resolveArtifactReference(deps, subject, task) {
             mapping: subject.mapping,
             scope: subject.scope,
             projectPath: subject.projectPath,
+            ...(subject.gradleUserHome !== undefined ? { gradleUserHome: subject.gradleUserHome } : {}),
             preferProjectVersion: subject.preferProjectVersion,
             strictVersion: subject.strictVersion
         });
@@ -414,6 +422,7 @@ export async function resolveArtifactReference(deps, subject, task) {
         mapping: subject.mapping,
         scope: subject.scope,
         projectPath: subject.projectPath,
+        ...(subject.gradleUserHome !== undefined ? { gradleUserHome: subject.gradleUserHome } : {}),
         preferProjectVersion: subject.preferProjectVersion ?? true,
         strictVersion: subject.strictVersion
     });
@@ -436,6 +445,7 @@ async function resolveArtifactRef(deps, ref, subject) {
         mapping: "mapping" in subject ? subject.mapping : undefined,
         scope: "scope" in subject ? subject.scope : undefined,
         projectPath: "projectPath" in subject ? subject.projectPath : undefined,
+        ...("gradleUserHome" in subject && subject.gradleUserHome !== undefined ? { gradleUserHome: subject.gradleUserHome } : {}),
         preferProjectVersion: "preferProjectVersion" in subject ? subject.preferProjectVersion : undefined,
         strictVersion: "strictVersion" in subject ? subject.strictVersion : undefined
     });

package/dist/entry-tools/inspect-minecraft-service.d.ts

@@ -8,6 +8,7 @@ export declare const inspectMinecraftShape: {
         mapping: z.ZodOptional<z.ZodEnum<["obfuscated", "mojang", "intermediary", "yarn"]>>;
         scope: z.ZodOptional<z.ZodEnum<["vanilla", "merged", "loader"]>>;
         projectPath: z.ZodOptional<z.ZodString>;
+        gradleUserHome: z.ZodOptional<z.ZodString>;
         preferProjectVersion: z.ZodOptional<z.ZodBoolean>;
         strictVersion: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
@@ -16,6 +17,7 @@ export declare const inspectMinecraftShape: {
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     }, {
@@ -24,6 +26,7 @@ export declare const inspectMinecraftShape: {
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     }>, z.ZodObject<{
@@ -65,6 +68,7 @@ export declare const inspectMinecraftShape: {
         mapping: z.ZodOptional<z.ZodEnum<["obfuscated", "mojang", "intermediary", "yarn"]>>;
         scope: z.ZodOptional<z.ZodEnum<["vanilla", "merged", "loader"]>>;
         projectPath: z.ZodOptional<z.ZodString>;
+        gradleUserHome: z.ZodOptional<z.ZodString>;
         preferProjectVersion: z.ZodOptional<z.ZodBoolean>;
         strictVersion: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
@@ -82,6 +86,7 @@ export declare const inspectMinecraftShape: {
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     }, {
@@ -99,6 +104,7 @@ export declare const inspectMinecraftShape: {
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     }>, z.ZodObject<{
@@ -141,6 +147,7 @@ export declare const inspectMinecraftShape: {
         mapping: z.ZodOptional<z.ZodEnum<["obfuscated", "mojang", "intermediary", "yarn"]>>;
         scope: z.ZodOptional<z.ZodEnum<["vanilla", "merged", "loader"]>>;
         projectPath: z.ZodOptional<z.ZodString>;
+        gradleUserHome: z.ZodOptional<z.ZodString>;
         preferProjectVersion: z.ZodOptional<z.ZodBoolean>;
         strictVersion: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
@@ -149,6 +156,7 @@ export declare const inspectMinecraftShape: {
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         artifact?: {
@@ -167,6 +175,7 @@ export declare const inspectMinecraftShape: {
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         artifact?: {
@@ -328,6 +337,7 @@ export declare const inspectMinecraftShape: {
         projectPath: z.ZodString;
         mapping: z.ZodOptional<z.ZodEnum<["obfuscated", "mojang", "intermediary", "yarn"]>>;
         scope: z.ZodOptional<z.ZodEnum<["vanilla", "merged", "loader"]>>;
+        gradleUserHome: z.ZodOptional<z.ZodString>;
         preferProjectVersion: z.ZodOptional<z.ZodBoolean>;
         strictVersion: z.ZodOptional<z.ZodBoolean>;
         focus: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
@@ -543,6 +553,7 @@ export declare const inspectMinecraftShape: {
         projectPath: string;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         focus?: {
@@ -596,6 +607,7 @@ export declare const inspectMinecraftShape: {
         projectPath: string;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         focus?: {
@@ -659,6 +671,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         mapping: z.ZodOptional<z.ZodEnum<["obfuscated", "mojang", "intermediary", "yarn"]>>;
         scope: z.ZodOptional<z.ZodEnum<["vanilla", "merged", "loader"]>>;
         projectPath: z.ZodOptional<z.ZodString>;
+        gradleUserHome: z.ZodOptional<z.ZodString>;
         preferProjectVersion: z.ZodOptional<z.ZodBoolean>;
         strictVersion: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
@@ -667,6 +680,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     }, {
@@ -675,6 +689,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     }>, z.ZodObject<{
@@ -716,6 +731,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         mapping: z.ZodOptional<z.ZodEnum<["obfuscated", "mojang", "intermediary", "yarn"]>>;
         scope: z.ZodOptional<z.ZodEnum<["vanilla", "merged", "loader"]>>;
         projectPath: z.ZodOptional<z.ZodString>;
+        gradleUserHome: z.ZodOptional<z.ZodString>;
         preferProjectVersion: z.ZodOptional<z.ZodBoolean>;
         strictVersion: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
@@ -733,6 +749,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     }, {
@@ -750,6 +767,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     }>, z.ZodObject<{
@@ -792,6 +810,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         mapping: z.ZodOptional<z.ZodEnum<["obfuscated", "mojang", "intermediary", "yarn"]>>;
         scope: z.ZodOptional<z.ZodEnum<["vanilla", "merged", "loader"]>>;
         projectPath: z.ZodOptional<z.ZodString>;
+        gradleUserHome: z.ZodOptional<z.ZodString>;
         preferProjectVersion: z.ZodOptional<z.ZodBoolean>;
         strictVersion: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
@@ -800,6 +819,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         artifact?: {
@@ -818,6 +838,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         artifact?: {
@@ -979,6 +1000,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath: z.ZodString;
         mapping: z.ZodOptional<z.ZodEnum<["obfuscated", "mojang", "intermediary", "yarn"]>>;
         scope: z.ZodOptional<z.ZodEnum<["vanilla", "merged", "loader"]>>;
+        gradleUserHome: z.ZodOptional<z.ZodString>;
         preferProjectVersion: z.ZodOptional<z.ZodBoolean>;
         strictVersion: z.ZodOptional<z.ZodBoolean>;
         focus: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
@@ -1194,6 +1216,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath: string;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         focus?: {
@@ -1247,6 +1270,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath: string;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         focus?: {
@@ -1312,6 +1336,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     } | {
@@ -1329,6 +1354,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     } | {
@@ -1337,6 +1363,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         artifact?: {
@@ -1386,6 +1413,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath: string;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         focus?: {
@@ -1448,6 +1476,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     } | {
@@ -1465,6 +1494,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     } | {
@@ -1473,6 +1503,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         artifact?: {
@@ -1522,6 +1553,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath: string;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         focus?: {
@@ -1584,6 +1616,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     } | {
@@ -1601,6 +1634,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     } | {
@@ -1609,6 +1643,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         artifact?: {
@@ -1658,6 +1693,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath: string;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         focus?: {
@@ -1720,6 +1756,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     } | {
@@ -1737,6 +1774,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
     } | {
@@ -1745,6 +1783,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath?: string | undefined;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         artifact?: {
@@ -1794,6 +1833,7 @@ export declare const inspectMinecraftSchema: z.ZodEffects<z.ZodObject<{
         projectPath: string;
         mapping?: "obfuscated" | "mojang" | "intermediary" | "yarn" | undefined;
         scope?: "vanilla" | "merged" | "loader" | undefined;
+        gradleUserHome?: string | undefined;
         preferProjectVersion?: boolean | undefined;
         strictVersion?: boolean | undefined;
         focus?: {

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

@@ -1,7 +1,11 @@
 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";
-export declare function handleProjectSummary(deps: ValidateProjectDeps, input: ValidateProjectInput, detail: DetailLevel, include: string[]): Promise<{
+type ProjectSummaryOptions = {
+    stageEmitter?: StageEmitter;
+};
+export declare function handleProjectSummary(deps: ValidateProjectDeps, input: ValidateProjectInput, detail: DetailLevel, include: string[], options?: ProjectSummaryOptions): Promise<{
     warnings: string[];
     tasks?: {
         "workspace.detected": {
@@ -95,3 +99,4 @@ export declare function handleProjectSummary(deps: ValidateProjectDeps, input: V
         };
     } | undefined;
 }>;
+export {};

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

@@ -2,7 +2,24 @@ import { readFile } from "node:fs/promises";
 import { buildEntryToolResult, createSummarySubject } from "../../response-contract.js";
 import { ERROR_CODES, createError } from "../../../errors.js";
 import { buildEarlyTasksForBlocked, buildFullTaskStatusReport } from "../internal.js";
-export async function handleProjectSummary(deps, input, detail, include) {
+// Telemetry failures must not change validation outcomes; swallow rejections
+// so a broken emitter does not abort the summary or count as a validation error.
+async function safeEmit(emitter, stage, payload) {
+    if (!emitter)
+        return;
+    try {
+        await emitter(stage, payload);
+    }
+    catch {
+        // swallow telemetry failure
+    }
+}
+export async function handleProjectSummary(deps, input, detail, include, options = {}) {
+    // Forwarded emitter for nested validators and probes; same swallow contract
+    // as safeEmit so a rejecting raw emitter cannot leak into their outcomes.
+    const wrappedEmitter = options.stageEmitter
+        ? (stage, meta) => safeEmit(options.stageEmitter, stage, meta)
+        : undefined;
     if (input.subject.kind !== "workspace") {
         throw createError({
             code: ERROR_CODES.INVALID_INPUT,
@@ -42,7 +59,11 @@ export async function handleProjectSummary(deps, input, detail, include) {
                 }
             }
         });
-        const tasks = await buildEarlyTasksForBlocked(input.subject.projectPath, detail, include);
+        await safeEmit(options.stageEmitter, "validate-project:task-report", {
+            projectPath: input.subject.projectPath,
+            reason: "missing-version"
+        });
+        const tasks = await buildEarlyTasksForBlocked(input.subject.projectPath, detail, include, undefined, input.subject.gradleUserHome);
         return {
             ...baseResult,
             ...(tasks ? { tasks } : {}),
@@ -50,11 +71,16 @@ export async function handleProjectSummary(deps, input, detail, include) {
         };
     }
     const projectPath = input.subject.projectPath;
+    const gradleUserHome = input.subject.gradleUserHome;
+    const discover = input.subject.discover ?? ["mixins", "access-wideners"];
+    await safeEmit(options.stageEmitter, "validate-project:workspace-discovery", {
+        projectPath,
+        discover
+    });
     const detectedProjectVersion = input.preferProjectVersion
         ? await deps.detectProjectMinecraftVersion?.(projectPath)
         : undefined;
     const resolvedVersion = detectedProjectVersion ?? input.version;
-    const discover = input.subject.discover ?? ["mixins", "access-wideners"];
     const [mixinConfigs, accessWideners, accessTransformers] = await Promise.all([
         discover.includes("mixins")
             ? deps.discoverMixins(projectPath, input.configPaths)
@@ -102,11 +128,18 @@ export async function handleProjectSummary(deps, input, detail, include) {
                 }
             }
         });
-        const tasks = await buildEarlyTasksForBlocked(projectPath, detail, include, {
+        await safeEmit(options.stageEmitter, "validate-project:task-report", {
+            projectPath,
+            reason: "version-unresolved",
             mixinDiscoveryCount: mixinConfigs.length,
             awDiscoveryCount: accessWideners.length,
             atDiscoveryCount: accessTransformers.length
         });
+        const tasks = await buildEarlyTasksForBlocked(projectPath, detail, include, {
+            mixinDiscoveryCount: mixinConfigs.length,
+            awDiscoveryCount: accessWideners.length,
+            atDiscoveryCount: accessTransformers.length
+        }, gradleUserHome);
         return {
             ...baseResult,
             ...(tasks ? { tasks } : {}),
@@ -144,7 +177,11 @@ export async function handleProjectSummary(deps, input, detail, include) {
                 }
             }
         });
-        const tasks = await buildEarlyTasksForBlocked(projectPath, detail, include);
+        await safeEmit(options.stageEmitter, "validate-project:task-report", {
+            projectPath,
+            reason: "version-not-required"
+        });
+        const tasks = await buildEarlyTasksForBlocked(projectPath, detail, include, undefined, gradleUserHome);
         return {
             ...baseResult,
             ...(tasks ? { tasks } : {}),
@@ -158,8 +195,16 @@ export async function handleProjectSummary(deps, input, detail, include) {
     let partialMixins = 0;
     let invalidMixins = 0;
     let mixinCaughtErrors = 0;
-    for (const configPath of mixinConfigs) {
+    await safeEmit(options.stageEmitter, "validate-project:mixin-validation", {
+        targetTotal: mixinConfigs.length
+    });
+    for (const [mixinIndex, configPath] of mixinConfigs.entries()) {
         try {
+            await safeEmit(options.stageEmitter, "validate-project:mixin-validation", {
+                targetIndex: mixinIndex + 1,
+                targetTotal: mixinConfigs.length,
+                configPath
+            });
             const mixinResult = await deps.validateMixin({
                 input: {
                     mode: "config",
@@ -170,6 +215,7 @@ export async function handleProjectSummary(deps, input, detail, include) {
                 sourcePriority: input.sourcePriority,
                 scope: input.scope,
                 projectPath,
+                gradleUserHome,
                 preferProjectVersion: false,
                 preferProjectMapping: input.preferProjectMapping,
                 sourceRoots: input.sourceRoots,
@@ -180,6 +226,8 @@ export async function handleProjectSummary(deps, input, detail, include) {
                 warningCategoryFilter: input.warningCategoryFilter,
                 treatInfoAsWarning: input.treatInfoAsWarning,
                 includeIssues: input.includeIssues
+            }, {
+                stageEmitter: wrappedEmitter
             });
             const summary = mixinResult.summary;
             validMixins += summary?.valid ?? 0;
@@ -202,14 +250,23 @@ export async function handleProjectSummary(deps, input, detail, include) {
     let validAw = 0;
     let invalidAw = 0;
     let awCaughtErrors = 0;
-    for (const awPath of accessWideners) {
+    await safeEmit(options.stageEmitter, "validate-project:access-widener-validation", {
+        targetTotal: accessWideners.length
+    });
+    for (const [awIndex, awPath] of accessWideners.entries()) {
         try {
+            await safeEmit(options.stageEmitter, "validate-project:access-widener-validation", {
+                targetIndex: awIndex + 1,
+                targetTotal: accessWideners.length,
+                filePath: awPath
+            });
             const output = await deps.validateAccessWidener({
                 content: await readFile(awPath, "utf8"),
                 version: validationVersion,
                 mapping: input.mapping,
                 sourcePriority: input.sourcePriority,
                 projectPath,
+                gradleUserHome,
                 scope: input.scope,
                 preferProjectVersion: input.preferProjectVersion
             });
@@ -236,8 +293,16 @@ export async function handleProjectSummary(deps, input, detail, include) {
     let validAt = 0;
     let invalidAt = 0;
     let atCaughtErrors = 0;
-    for (const atPath of accessTransformers) {
+    await safeEmit(options.stageEmitter, "validate-project:access-transformer-validation", {
+        targetTotal: accessTransformers.length
+    });
+    for (const [atIndex, atPath] of accessTransformers.entries()) {
         try {
+            await safeEmit(options.stageEmitter, "validate-project:access-transformer-validation", {
+                targetIndex: atIndex + 1,
+                targetTotal: accessTransformers.length,
+                filePath: atPath
+            });
             if (!deps.validateAccessTransformer) {
                 throw createError({
                     code: ERROR_CODES.CONTEXT_UNRESOLVED,
@@ -250,6 +315,7 @@ export async function handleProjectSummary(deps, input, detail, include) {
                 atNamespace: input.atNamespace,
                 sourcePriority: input.sourcePriority,
                 projectPath,
+                gradleUserHome,
                 scope: input.scope,
                 preferProjectVersion: input.preferProjectVersion
             });
@@ -315,6 +381,12 @@ export async function handleProjectSummary(deps, input, detail, include) {
         },
         alwaysBlocks: ["project"]
     });
+    await safeEmit(options.stageEmitter, "validate-project:task-report", {
+        projectPath,
+        mixinDiscoveryCount: mixinConfigs.length,
+        awDiscoveryCount: accessWideners.length,
+        atDiscoveryCount: accessTransformers.length
+    });
     const tasks = await buildFullTaskStatusReport(deps, {
         projectPath,
         detail,
@@ -322,6 +394,7 @@ export async function handleProjectSummary(deps, input, detail, include) {
         resolvedVersion: validationVersion,
         mapping: input.mapping,
         sourcePriority: input.sourcePriority,
+        gradleUserHome,
         scope: input.scope,
         preferProjectVersion: input.preferProjectVersion,
         mixinDiscoveryCount: mixinConfigs.length,
@@ -335,7 +408,8 @@ export async function handleProjectSummary(deps, input, detail, include) {
         atDiscoveryCount: accessTransformers.length,
         atCaughtErrors,
         atCounts: { ok: validAt, invalid: invalidAt },
-        atDurationMs
+        atDurationMs,
+        stageEmitter: wrappedEmitter
     });
     return {
         ...baseResult,