devkit-debugging-mcp 0.1.0

package/dist/tools/refactor_guarded.d.ts

@@ -0,0 +1,50 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { ToolResult } from "../types/contracts.js";
+declare const InputSchema: z.ZodObject<{
+    goal: z.ZodEnum<["readability", "testability", "dedupe"]>;
+    targets: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        symbol: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        symbol?: string | undefined;
+    }, {
+        file: string;
+        symbol?: string | undefined;
+    }>, "many">;
+    constraints: z.ZodOptional<z.ZodObject<{
+        noBehaviorChange: z.ZodOptional<z.ZodBoolean>;
+        maxFiles: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        noBehaviorChange?: boolean | undefined;
+        maxFiles?: number | undefined;
+    }, {
+        noBehaviorChange?: boolean | undefined;
+        maxFiles?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    goal: "readability" | "testability" | "dedupe";
+    targets: {
+        file: string;
+        symbol?: string | undefined;
+    }[];
+    constraints?: {
+        noBehaviorChange?: boolean | undefined;
+        maxFiles?: number | undefined;
+    } | undefined;
+}, {
+    goal: "readability" | "testability" | "dedupe";
+    targets: {
+        file: string;
+        symbol?: string | undefined;
+    }[];
+    constraints?: {
+        noBehaviorChange?: boolean | undefined;
+        maxFiles?: number | undefined;
+    } | undefined;
+}>;
+export declare function runRefactorGuarded(rawArgs: z.infer<typeof InputSchema>): Promise<ToolResult>;
+export declare function registerRefactorGuardedTool(server: McpServer): void;
+export {};
+//# sourceMappingURL=refactor_guarded.d.ts.map

package/dist/tools/refactor_guarded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor_guarded.d.ts","sourceRoot":"","sources":["../../src/tools/refactor_guarded.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWf,CAAC;AAEH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAoClG;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,QAe5D"}

package/dist/tools/refactor_guarded.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+import { toMcpResult } from "../core/mcp/mcpResult.js";
+import { runTool } from "../core/toolRunner.js";
+import { ToolEnvelopeSchema } from "./schemas.js";
+const InputSchema = z.object({
+    goal: z.enum(["readability", "testability", "dedupe"]),
+    targets: z
+        .array(z.object({ file: z.string().min(1), symbol: z.string().min(1).optional() }))
+        .min(1),
+    constraints: z
+        .object({
+        noBehaviorChange: z.boolean().optional(),
+        maxFiles: z.number().int().min(1).max(20).optional(),
+    })
+        .optional(),
+});
+export async function runRefactorGuarded(rawArgs) {
+    const noBehaviorChange = rawArgs.constraints?.noBehaviorChange ?? true;
+    const maxFiles = rawArgs.constraints?.maxFiles ?? 5;
+    const plan = [];
+    plan.push("Establish a baseline: run `npm test` and `npm run typecheck` before refactoring.");
+    if (noBehaviorChange)
+        plan.push("Guardrail: no functional behavior changes; only restructure and clarify code.");
+    plan.push("Identify seams: extract pure functions, isolate side effects, and reduce implicit dependencies.");
+    plan.push("Keep diffs small: refactor one concept at a time and verify after each step.");
+    plan.push("Add/adjust tests only to lock behavior, not to rewrite expectations to fit new code.");
+    const verification = ["npm run typecheck", "npm test"];
+    return {
+        ok: true,
+        message: "Guarded refactor plan generated.",
+        data: {
+            goal: rawArgs.goal,
+            targets: rawArgs.targets.slice(0, maxFiles),
+            guardrails: {
+                noBehaviorChange,
+                maxFiles,
+                avoid: [
+                    "Large-scale renames and file moves",
+                    "Architecture rewrites (routing/data layer)",
+                    "Security-sensitive changes (auth, RLS, env handling) without explicit review",
+                ],
+            },
+            plan,
+            verification,
+        },
+        nextSteps: [
+            "Share the target file(s) and the current failing tests or pain points.",
+            "If you want automated patches, call `suggest_patch` with the exact failing output and project root.",
+        ],
+    };
+}
+export function registerRefactorGuardedTool(server) {
+    server.registerTool("refactor_guarded", {
+        title: "Generate a guarded refactor plan",
+        description: "Produces a no-behavior-change refactor plan with verification steps and safety guardrails.",
+        inputSchema: {
+            goal: InputSchema.shape.goal,
+            targets: InputSchema.shape.targets,
+            constraints: InputSchema.shape.constraints,
+        },
+        outputSchema: ToolEnvelopeSchema,
+    }, async (rawArgs) => toMcpResult(await runTool(() => runRefactorGuarded(rawArgs))));
+}
+//# sourceMappingURL=refactor_guarded.js.map

package/dist/tools/refactor_guarded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor_guarded.js","sourceRoot":"","sources":["../../src/tools/refactor_guarded.ts"],"names":[],"mappings":"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"}

package/dist/tools/schemas.d.ts

@@ -0,0 +1,103 @@
+import { z } from "zod";
+export declare const ChangePreviewSchema: z.ZodObject<{
+    type: z.ZodEnum<["create", "update", "delete"]>;
+    path: z.ZodString;
+    preview: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "create" | "update" | "delete";
+    path: string;
+    preview: string;
+}, {
+    type: "create" | "update" | "delete";
+    path: string;
+    preview: string;
+}>;
+export declare const ToolEnvelopeSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    message: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodUnknown>;
+    changes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["create", "update", "delete"]>;
+        path: z.ZodString;
+        preview: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "create" | "update" | "delete";
+        path: string;
+        preview: string;
+    }, {
+        type: "create" | "update" | "delete";
+        path: string;
+        preview: string;
+    }>, "many">>;
+    filesWritten: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    nextSteps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        code: string;
+        path?: string | undefined;
+    }, {
+        message: string;
+        code: string;
+        path?: string | undefined;
+    }>, "many">>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        code: string;
+        details?: unknown;
+    }, {
+        message: string;
+        code: string;
+        details?: unknown;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    ok: boolean;
+    message?: string | undefined;
+    data?: unknown;
+    changes?: {
+        type: "create" | "update" | "delete";
+        path: string;
+        preview: string;
+    }[] | undefined;
+    filesWritten?: string[] | undefined;
+    nextSteps?: string[] | undefined;
+    warnings?: {
+        message: string;
+        code: string;
+        path?: string | undefined;
+    }[] | undefined;
+    error?: {
+        message: string;
+        code: string;
+        details?: unknown;
+    } | undefined;
+}, {
+    ok: boolean;
+    message?: string | undefined;
+    data?: unknown;
+    changes?: {
+        type: "create" | "update" | "delete";
+        path: string;
+        preview: string;
+    }[] | undefined;
+    filesWritten?: string[] | undefined;
+    nextSteps?: string[] | undefined;
+    warnings?: {
+        message: string;
+        code: string;
+        path?: string | undefined;
+    }[] | undefined;
+    error?: {
+        message: string;
+        code: string;
+        details?: unknown;
+    } | undefined;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAI9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiB7B,CAAC"}

package/dist/tools/schemas.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export const ChangePreviewSchema = z.object({
+    type: z.enum(["create", "update", "delete"]),
+    path: z.string(),
+    preview: z.string(),
+});
+export const ToolEnvelopeSchema = z.object({
+    ok: z.boolean(),
+    message: z.string().optional(),
+    data: z.unknown().optional(),
+    changes: z.array(ChangePreviewSchema).optional(),
+    filesWritten: z.array(z.string()).optional(),
+    nextSteps: z.array(z.string()).optional(),
+    warnings: z
+        .array(z.object({ code: z.string(), message: z.string(), path: z.string().optional() }))
+        .optional(),
+    error: z
+        .object({
+        code: z.string(),
+        message: z.string(),
+        details: z.unknown().optional(),
+    })
+        .optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE;IAChD,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;SACvF,QAAQ,EAAE;IACb,KAAK,EAAE,CAAC;SACL,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KAChC,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC"}

package/dist/tools/suggest_patch.d.ts

@@ -0,0 +1,23 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { ToolResult } from "../types/contracts.js";
+declare const InputSchema: z.ZodObject<{
+    projectRoot: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+    changeLevel: z.ZodOptional<z.ZodEnum<["minimal", "medium"]>>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    projectRoot?: string | undefined;
+    changeLevel?: "minimal" | "medium" | undefined;
+    dryRun?: boolean | undefined;
+}, {
+    text: string;
+    projectRoot?: string | undefined;
+    changeLevel?: "minimal" | "medium" | undefined;
+    dryRun?: boolean | undefined;
+}>;
+export declare function runSuggestPatch(rawArgs: z.infer<typeof InputSchema>): Promise<ToolResult>;
+export declare function registerSuggestPatchTool(server: McpServer): void;
+export {};
+//# sourceMappingURL=suggest_patch.d.ts.map

package/dist/tools/suggest_patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest_patch.d.ts","sourceRoot":"","sources":["../../src/tools/suggest_patch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;EAKf,CAAC;AAEH,wBAAsB,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAgB/F;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,QAiBzD"}

package/dist/tools/suggest_patch.js

@@ -0,0 +1,41 @@
+import path from "node:path";
+import { z } from "zod";
+import { toMcpResult } from "../core/mcp/mcpResult.js";
+import { runTool } from "../core/toolRunner.js";
+import { suggestPatchPlan } from "../core/patch/suggestPatch.js";
+import { ToolEnvelopeSchema } from "./schemas.js";
+const InputSchema = z.object({
+    projectRoot: z.string().min(1).optional(),
+    text: z.string().min(1),
+    changeLevel: z.enum(["minimal", "medium"]).optional(),
+    dryRun: z.boolean().optional(),
+});
+export async function runSuggestPatch(rawArgs) {
+    const projectRoot = path.resolve(rawArgs.projectRoot ?? process.cwd());
+    const dryRun = rawArgs.dryRun ?? true;
+    const changeLevel = rawArgs.changeLevel ?? "minimal";
+    const planned = await suggestPatchPlan({ projectRoot, text: rawArgs.text, changeLevel, dryRun });
+    return {
+        ok: true,
+        message: dryRun ? "Patch plan generated (dry-run)." : "Patch applied.",
+        data: planned.data,
+        changes: planned.changes,
+        filesWritten: planned.filesWritten.length > 0 ? planned.filesWritten : undefined,
+        warnings: planned.warnings.length > 0 ? planned.warnings : undefined,
+        nextSteps: planned.nextSteps,
+    };
+}
+export function registerSuggestPatchTool(server) {
+    server.registerTool("suggest_patch", {
+        title: "Suggest a minimal patch",
+        description: "Generates a guarded, deterministic patch plan for common debugging issues (dry-run by default).",
+        inputSchema: {
+            projectRoot: InputSchema.shape.projectRoot,
+            text: InputSchema.shape.text,
+            changeLevel: InputSchema.shape.changeLevel,
+            dryRun: InputSchema.shape.dryRun,
+        },
+        outputSchema: ToolEnvelopeSchema,
+    }, async (rawArgs) => toMcpResult(await runTool(() => runSuggestPatch(rawArgs))));
+}
+//# sourceMappingURL=suggest_patch.js.map

package/dist/tools/suggest_patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest_patch.js","sourceRoot":"","sources":["../../src/tools/suggest_patch.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrD,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAoC;IACxE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;IACtC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,SAAS,CAAC;IAErD,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IAEjG,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,gBAAgB;QACtE,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;QAChF,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QACpE,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,iGAAiG;QACnG,WAAW,EAAE;YACX,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW;YAC1C,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI;YAC5B,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW;YAC1C,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM;SACjC;QACD,YAAY,EAAE,kBAAkB;KACjC,EACD,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAC9E,CAAC;AACJ,CAAC"}

package/dist/tools/triage_issue.d.ts

@@ -0,0 +1,17 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { ToolResult } from "../types/contracts.js";
+declare const InputSchema: z.ZodObject<{
+    text: z.ZodString;
+    contextHint: z.ZodOptional<z.ZodEnum<["next", "supabase", "jest", "vitest", "playwright", "tsc", "eslint"]>>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    contextHint?: "next" | "supabase" | "jest" | "vitest" | "playwright" | "eslint" | "tsc" | undefined;
+}, {
+    text: string;
+    contextHint?: "next" | "supabase" | "jest" | "vitest" | "playwright" | "eslint" | "tsc" | undefined;
+}>;
+export declare function runTriageIssue(rawArgs: z.infer<typeof InputSchema>): Promise<ToolResult>;
+export declare function registerTriageIssueTool(server: McpServer): void;
+export {};
+//# sourceMappingURL=triage_issue.d.ts.map

package/dist/tools/triage_issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage_issue.d.ts","sourceRoot":"","sources":["../../src/tools/triage_issue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,QAAA,MAAM,WAAW;;;;;;;;;EAGf,CAAC;AAEH,wBAAsB,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAY9F;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,QAcxD"}

package/dist/tools/triage_issue.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { toMcpResult } from "../core/mcp/mcpResult.js";
+import { runTool } from "../core/toolRunner.js";
+import { triageIssue } from "../core/triage/triageIssue.js";
+import { ToolEnvelopeSchema } from "./schemas.js";
+const InputSchema = z.object({
+    text: z.string().min(1),
+    contextHint: z.enum(["next", "supabase", "jest", "vitest", "playwright", "tsc", "eslint"]).optional(),
+});
+export async function runTriageIssue(rawArgs) {
+    const result = triageIssue(rawArgs.text);
+    return {
+        ok: true,
+        message: "Triage complete.",
+        data: result,
+        nextSteps: [
+            "Provide the exact command that produced this output (e.g. `npm test`, `next build`).",
+            "If a file/line is referenced, share that file content around the failing line (redact secrets).",
+        ],
+    };
+}
+export function registerTriageIssueTool(server) {
+    server.registerTool("triage_issue", {
+        title: "Triage an error or failing test",
+        description: "Classifies an error log/test failure and returns an actionable checklist (secrets redacted).",
+        inputSchema: {
+            text: InputSchema.shape.text,
+            contextHint: InputSchema.shape.contextHint,
+        },
+        outputSchema: ToolEnvelopeSchema,
+    }, async (rawArgs) => toMcpResult(await runTool(() => runTriageIssue(rawArgs))));
+}
+//# sourceMappingURL=triage_issue.js.map

package/dist/tools/triage_issue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage_issue.js","sourceRoot":"","sources":["../../src/tools/triage_issue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtG,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAoC;IACvE,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,kBAAkB;QAC3B,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE;YACT,sFAAsF;YACtF,iGAAiG;SAClG;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,iCAAiC;QACxC,WAAW,EAAE,8FAA8F;QAC3G,WAAW,EAAE;YACX,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI;YAC5B,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW;SAC3C;QACD,YAAY,EAAE,kBAAkB;KACjC,EACD,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAC7E,CAAC;AACJ,CAAC"}

package/dist/types/contracts.d.ts

@@ -0,0 +1,36 @@
+export type ToolError = {
+    code: string;
+    message: string;
+    details?: unknown;
+};
+export type ChangePreview = {
+    type: "create" | "update" | "delete";
+    path: string;
+    preview: string;
+};
+export type ToolResult<TData = unknown> = {
+    ok: true;
+    message?: string;
+    data?: TData;
+    changes?: ChangePreview[];
+    filesWritten?: string[];
+    nextSteps?: string[];
+    warnings?: Array<{
+        code: string;
+        message: string;
+        path?: string;
+    }>;
+} | {
+    ok: false;
+    error: ToolError;
+    message?: string;
+    data?: TData;
+    changes?: ChangePreview[];
+    nextSteps?: string[];
+    warnings?: Array<{
+        code: string;
+        message: string;
+        path?: string;
+    }>;
+};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/types/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/types/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,KAAK,GAAG,OAAO,IAClC;IACE,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE,CAAC"}

package/dist/types/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/types/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/types/contracts.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "devkit-debugging-mcp",
+  "version": "0.1.0",
+  "description": "Custom MCP server for debugging and testing Next.js + Supabase projects.",
+  "type": "module",
+  "bin": {
+    "devkit-debugging-mcp": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "PRD.md",
+    "TRD.md",
+    "AGENTS.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "node --import tsx --test",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "nextjs",
+    "supabase",
+    "testing",
+    "debugging",
+    "refactoring"
+  ],
+  "license": "MIT"
+}