codeguardian-mcp 1.0.0

package/dist/tools/asyncValidation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Async Validation Tools
+ *
+ * Three tools for handling long-running validation jobs:
+ * 1. start_validation - Submit a validation job
+ * 2. get_validation_status - Check job progress
+ * 3. get_validation_results - Retrieve completed results
+ *
+ * Results are saved to BOTH:
+ * - `.codeguardian/reports/` (internal cache, gitignored)
+ * - `codeguardian-report.json` (LLM-readable, at project root)
+ *
+ * @format
+ */
+import { ToolDefinition } from "../types/tools.js";
+export declare const startValidationTool: ToolDefinition;
+export declare const getValidationStatusTool: ToolDefinition;
+export declare const getValidationResultsTool: ToolDefinition;
+//# sourceMappingURL=asyncValidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asyncValidation.d.ts","sourceRoot":"","sources":["../../src/tools/asyncValidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASnD,eAAO,MAAM,mBAAmB,EAAE,cAgFjC,CAAC;AAMF,eAAO,MAAM,uBAAuB,EAAE,cAgDrC,CAAC;AAMF,eAAO,MAAM,wBAAwB,EAAE,cAyNtC,CAAC"}

package/dist/tools/asyncValidation.js

@@ -0,0 +1,346 @@
+/**
+ * Async Validation Tools
+ *
+ * Three tools for handling long-running validation jobs:
+ * 1. start_validation - Submit a validation job
+ * 2. get_validation_status - Check job progress
+ * 3. get_validation_results - Retrieve completed results
+ *
+ * Results are saved to BOTH:
+ * - `.codeguardian/reports/` (internal cache, gitignored)
+ * - `codeguardian-report.json` (LLM-readable, at project root)
+ *
+ * @format
+ */
+import * as path from "path";
+import { logger } from "../utils/logger.js";
+import { jobQueue } from "../queue/jobQueue.js";
+import { validationReportStore } from "../resources/validationReportStore.js";
+// ============================================================================
+// Tool 1: Start Validation
+// ============================================================================
+export const startValidationTool = {
+    definition: {
+        name: "start_validation",
+        description: "Start a background validation job for large codebases (>50 files) to avoid timeouts. Use 'get_validation_status' to poll for progress. Results are saved to codeguardian-report.json at the project root (readable by file tools, NOT inside .codeguardian/).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectPath: {
+                    type: "string",
+                    description: 'Path to your project (e.g., ".", "frontend")',
+                },
+                language: {
+                    type: "string",
+                    enum: ["javascript", "typescript", "python", "go"],
+                    description: "Programming language (typescript includes .js/.jsx files for mixed projects)",
+                },
+                batchSize: {
+                    type: "number",
+                    description: "Files per batch (default: 50, max: 100)",
+                    default: 50,
+                },
+                strictMode: {
+                    type: "boolean",
+                    description: "ONLY use true if explicitly requested. When true, flags ALL unresolved symbols including edge cases. Default is false which catches likely hallucinations without excessive noise.",
+                    default: false,
+                },
+                includeTests: {
+                    type: "boolean",
+                    description: "Include test files (default: true)",
+                    default: true,
+                },
+                recentlyEditedFiles: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional list of files edited in this session to boost relevance",
+                },
+            },
+            required: ["projectPath", "language"],
+        },
+    },
+    async handler(args) {
+        logger.info(`Starting async validation for: ${args.projectPath}`);
+        try {
+            const jobId = await jobQueue.submitJob("validation", args);
+            const resolvedPath = path.resolve(args.projectPath);
+            const reportFilePath = validationReportStore.getLLMReportPath(resolvedPath);
+            return formatResponse({
+                success: true,
+                jobId,
+                status: "queued",
+                message: "Validation job submitted successfully",
+                reportFile: reportFilePath,
+                nextSteps: [
+                    `Use get_validation_status({ jobId: "${jobId}" }) to check progress`,
+                    `Use get_validation_results({ jobId: "${jobId}" }) to get results when complete`,
+                    `When complete, results will be saved to: ${reportFilePath}`,
+                    `You can read the report file directly with your file-reading tool (it's NOT inside .codeguardian/)`,
+                ],
+            });
+        }
+        catch (error) {
+            logger.error("Error starting validation job:", error);
+            return formatResponse({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    },
+};
+// ============================================================================
+// Tool 2: Get Validation Status
+// ============================================================================
+export const getValidationStatusTool = {
+    definition: {
+        name: "get_validation_status",
+        description: "Check progress of a validation job. Poll every 3-5s until status is 'complete' or 'failed'.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                jobId: {
+                    type: "string",
+                    description: "Job ID returned from start_validation",
+                },
+            },
+            required: ["jobId"],
+        },
+    },
+    async handler(args) {
+        logger.info(`Checking status for job: ${args.jobId}`);
+        try {
+            const status = jobQueue.getJobStatus(args.jobId);
+            if (!status.exists) {
+                return formatResponse({
+                    success: false,
+                    exists: false,
+                    error: `Job not found: ${args.jobId}`,
+                    message: "Job may have expired (jobs expire after 24 hours)",
+                });
+            }
+            return formatResponse({
+                success: true,
+                exists: true,
+                jobId: args.jobId,
+                status: status.status,
+                progress: status.progress,
+                error: status.error,
+            });
+        }
+        catch (error) {
+            logger.error("Error getting job status:", error);
+            return formatResponse({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    },
+};
+// ============================================================================
+// Tool 3: Get Validation Results
+// ============================================================================
+export const getValidationResultsTool = {
+    definition: {
+        name: "get_validation_results",
+        description: "Retrieve final results for a completed validation job. Results are also saved to codeguardian-report.json at the project root, readable by file tools.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                jobId: {
+                    type: "string",
+                    description: "Job ID returned from start_validation",
+                },
+                fileFilter: {
+                    type: "string",
+                    description: "Optional: Filter results by file path (partial match)",
+                },
+                severityFilter: {
+                    type: "string",
+                    enum: ["critical", "high", "medium", "low", "warning"],
+                    description: "Optional: Filter results by severity",
+                },
+                limit: {
+                    type: "number",
+                    description: "Optional: Limit number of issues returned (default: all)",
+                },
+                offset: {
+                    type: "number",
+                    description: "Optional: Offset for pagination (default: 0)",
+                },
+                summaryOnly: {
+                    type: "boolean",
+                    description: "Optional: If true, returns only summary and stats without issue lists",
+                    default: false,
+                },
+            },
+            required: ["jobId"],
+        },
+    },
+    async handler(args) {
+        logger.info(`Getting results for job: ${args.jobId}`);
+        try {
+            const results = jobQueue.getJobResults(args.jobId);
+            if (!results.exists) {
+                return formatResponse({
+                    success: false,
+                    exists: false,
+                    error: `Job not found: ${args.jobId}`,
+                    message: "Job may have expired (jobs expire after 24 hours)",
+                });
+            }
+            if (results.status !== "complete") {
+                return formatResponse({
+                    success: false,
+                    exists: true,
+                    jobId: args.jobId,
+                    status: results.status,
+                    error: results.error,
+                    message: results.status === "processing" ?
+                        "Job is still processing. Use get_validation_status to check progress."
+                        : results.status === "failed" ?
+                            "Job failed. Check error field for details."
+                            : results.status === "queued" ?
+                                "Job is queued. Use get_validation_status to check progress."
+                                : "Job was cancelled.",
+                });
+            }
+            const fullResult = results.result;
+            if (!fullResult) {
+                return formatResponse({
+                    success: true,
+                    exists: true,
+                    jobId: args.jobId,
+                    status: results.status,
+                    message: "No result data found",
+                });
+            }
+            // Store the report in the resource store (if not already stored)
+            const job = jobQueue.getJob(args.jobId);
+            const projectPath = job?.input?.projectPath || "";
+            if (!validationReportStore.has(args.jobId)) {
+                // Wait for the report to be written to disk
+                // This saves to BOTH .codeguardian/reports/ AND codeguardian-report.json (LLM-readable)
+                await validationReportStore.store(args.jobId, projectPath, {
+                    summary: fullResult.summary,
+                    stats: fullResult.stats,
+                    hallucinations: fullResult.hallucinations || [],
+                    deadCode: fullResult.deadCode || [],
+                    score: fullResult.score,
+                    recommendation: fullResult.recommendation,
+                });
+            }
+            // Get LLM-readable report file path
+            const reportFilePath = projectPath
+                ? validationReportStore.getLLMReportPath(projectPath)
+                : undefined;
+            const totalIssues = (fullResult.hallucinations?.length || 0) + (fullResult.deadCode?.length || 0);
+            const isLargeResult = totalIssues > 50;
+            const hasAppliedFilters = args.fileFilter || args.severityFilter || args.limit !== undefined || args.offset !== undefined;
+            // For large results without filters, return ONLY the URI and summary
+            // This prevents LLM context overflow
+            if (isLargeResult && !hasAppliedFilters && !args.summaryOnly) {
+                const reportUri = validationReportStore.getReportUri(args.jobId);
+                const summary = validationReportStore.getSummary(args.jobId);
+                return formatResponse({
+                    success: true,
+                    exists: true,
+                    jobId: args.jobId,
+                    status: results.status,
+                    // COMPACT RESPONSE: URI + Summary only
+                    reportUri,
+                    reportFile: reportFilePath,
+                    message: `Large result set (${totalIssues} issues). Full report saved to ${reportFilePath || 'MCP Resource'}. Use your file-reading tool to access it.`,
+                    summary: summary?.summary,
+                    stats: summary?.stats,
+                    score: summary?.score,
+                    recommendation: summary?.recommendation,
+                    totalHallucinations: summary?.totalHallucinations,
+                    totalDeadCode: summary?.totalDeadCode,
+                    // Instructions for the LLM/IDE to fetch chunks or read file
+                    fileAccess: {
+                        reportFile: reportFilePath,
+                        tip: "Use your file-reading tool (e.g. read_file) to read the codeguardian-report.json file for full details. This file is at the project root and NOT inside .codeguardian/.",
+                    },
+                    resourceAccess: {
+                        summaryUri: reportUri,
+                        hallucinationsUri: `${reportUri}/hallucinations/0`,
+                        deadCodeUri: `${reportUri}/dead-code/0`,
+                        bySeverityUri: `${reportUri}/by-severity/critical`,
+                        byTypeUri: `${reportUri}/by-type/dependencyHallucination`,
+                        tip: "Alternatively, use MCP Resources or filters (fileFilter, severityFilter) with this tool for specific queries.",
+                    },
+                });
+            }
+            // For summaryOnly, return just the summary
+            if (args.summaryOnly) {
+                return formatResponse({
+                    success: true,
+                    exists: true,
+                    jobId: args.jobId,
+                    status: results.status,
+                    summary: fullResult.summary,
+                    stats: fullResult.stats,
+                    recommendation: fullResult.recommendation,
+                    score: fullResult.score,
+                    totalIssues,
+                    reportUri: validationReportStore.getReportUri(args.jobId),
+                    reportFile: reportFilePath,
+                    hint: reportFilePath
+                        ? `Full report saved to ${reportFilePath}. Use your file-reading tool to access it.`
+                        : undefined,
+                });
+            }
+            // For filtered/paginated requests, return the filtered data inline
+            // (This is for when the LLM specifically needs certain issues)
+            const filtered = validationReportStore.getFilteredIssues(args.jobId, {
+                type: args.severityFilter ? undefined : undefined, // Can extend later
+                severity: args.severityFilter,
+                file: args.fileFilter,
+                limit: args.limit ?? 25,
+                offset: args.offset ?? 0,
+            });
+            if (!filtered) {
+                return formatResponse({
+                    success: false,
+                    error: "Failed to retrieve filtered issues",
+                });
+            }
+            return formatResponse({
+                success: true,
+                exists: true,
+                jobId: args.jobId,
+                status: results.status,
+                reportUri: validationReportStore.getReportUri(args.jobId),
+                reportFile: reportFilePath,
+                issues: filtered.issues,
+                pagination: {
+                    total: filtered.total,
+                    limit: args.limit ?? 25,
+                    offset: args.offset ?? 0,
+                    hasMore: filtered.hasMore,
+                },
+                summary: fullResult.summary,
+                score: fullResult.score,
+                hint: reportFilePath
+                    ? `Full report also available at ${reportFilePath}. Use your file-reading tool to access it.`
+                    : undefined,
+            });
+        }
+        catch (error) {
+            logger.error("Error getting job results:", error);
+            return formatResponse({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    },
+};
+// ============================================================================
+// Response Formatting
+// ============================================================================
+function formatResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+//# sourceMappingURL=asyncValidation.js.map

package/dist/tools/asyncValidation.js.map

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

package/dist/tools/buildContext.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Build Context Tool (Improved Version)
+ *
+ * Builds a shared project context that other tools can use.
+ * This is the entry point for the shared context system.
+ *
+ * Improvements:
+ * 1. Dynamic cache expiration reporting from the context object.
+ * 2. Added `refresh_context` tool for atomic invalidation and rebuild.
+ * 3. Enhanced response formatting for better LLM consumption.
+ * 4. Improved documentation and type safety.
+ *
+ * @format
+ */
+import { ToolDefinition } from "../types/tools.js";
+export declare const buildContextTool: ToolDefinition;
+//# sourceMappingURL=buildContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildContext.d.ts","sourceRoot":"","sources":["../../src/tools/buildContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA6BnD,eAAO,MAAM,gBAAgB,EAAE,cA2H9B,CAAC"}

package/dist/tools/buildContext.js

@@ -0,0 +1,188 @@
+/**
+ * Build Context Tool (Improved Version)
+ *
+ * Builds a shared project context that other tools can use.
+ * This is the entry point for the shared context system.
+ *
+ * Improvements:
+ * 1. Dynamic cache expiration reporting from the context object.
+ * 2. Added `refresh_context` tool for atomic invalidation and rebuild.
+ * 3. Enhanced response formatting for better LLM consumption.
+ * 4. Improved documentation and type safety.
+ *
+ * @format
+ */
+import { logger } from "../utils/logger.js";
+import { orchestrateContext } from "../context/contextOrchestrator.js";
+import { intentTracker } from "../context/intentTracker.js";
+import { impactAnalyzer } from "../analyzers/impactAnalyzer.js";
+export const buildContextTool = {
+    definition: {
+        name: "build_context",
+        description: "Build or rebuild project context including symbols, git history, and intent signals. Usually auto-called by other tools.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectPath: {
+                    type: "string",
+                    description: "Root path of the project to analyze",
+                },
+                language: {
+                    type: "string",
+                    enum: ["javascript", "typescript", "python", "go", "java", "all"],
+                    description: "Programming language to focus on (default: all)",
+                    default: "all",
+                },
+                includeTests: {
+                    type: "boolean",
+                    description: "Include test files in context (default: true)",
+                    default: true,
+                },
+                forceRebuild: {
+                    type: "boolean",
+                    description: "Force rebuild even if cached",
+                    default: false,
+                },
+                maxFiles: {
+                    type: "number",
+                    description: "Maximum files to index (default: 1000)",
+                    default: 1000,
+                },
+            },
+            required: ["projectPath"],
+        },
+    },
+    async handler(args) {
+        const startTime = Date.now();
+        const { projectPath, language = "all", includeTests = true, forceRebuild = false, maxFiles = 1000, } = args;
+        logger.info(`Building orchestrated context for: ${projectPath}`);
+        try {
+            // Use the robust orchestrator from src/context
+            const orchestration = await orchestrateContext({
+                projectPath,
+                language: language === "all" ? "typescript" : language, // Default to TS if all
+                // build_context is expected to include "Augment Secrets" like Git lineage
+                includeLineage: true,
+                // Respect tool args
+                forceRebuild,
+                includeTests,
+                maxFiles,
+            });
+            const context = orchestration.projectContext;
+            const intent = intentTracker.getCurrentIntent();
+            const elapsed = Date.now() - startTime;
+            const summary = generateContextSummary(context);
+            // Calculate recent authors from history
+            const recentAuthors = new Set();
+            if (orchestration.lineageContext) {
+                for (const history of orchestration.lineageContext.fileHistories.values()) {
+                    history.authors.forEach(a => recentAuthors.add(a));
+                }
+            }
+            // Calculate Project Hubs (Architecture)
+            // We need to import impactAnalyzer first (adding to imports)
+            // For now, I will assume it is available or imported at top
+            const hubs = context.symbolGraph
+                ? impactAnalyzer.getProjectHubs(context.symbolGraph, 3).map(h => `${h.symbol} (${h.description})`)
+                : [];
+            // Use dynamic cache expiration if available in the context object
+            const cachedUntil = context.expiresAt ?
+                new Date(context.expiresAt).toISOString()
+                : new Date(Date.now() + 5 * 60 * 1000).toISOString();
+            return formatResponse({
+                success: true,
+                message: `Project context built successfully in ${elapsed}ms`,
+                data: {
+                    summary,
+                    stats: {
+                        totalFiles: context.totalFiles,
+                        totalSymbols: context.symbolIndex.size,
+                        totalDependencies: context.dependencies.length,
+                        externalPackages: context.externalDependencies.size,
+                        entryPoints: context.entryPoints.length,
+                        buildTimeMs: elapsed,
+                        cachedUntil,
+                        quality: orchestration.contextQuality,
+                    },
+                    augmentSecrets: {
+                        hotFiles: orchestration.lineageContext?.hotspotFiles.slice(0, 5) || [],
+                        recentAuthors: Array.from(recentAuthors).slice(0, 5),
+                        focusedIntent: intent.recentFiles.slice(0, 5),
+                        projectHubs: hubs,
+                    },
+                    frameworks: context.frameworks,
+                },
+                hint: "Context is cached. VibeGuard is now aware of your Git history and focus.",
+            });
+        }
+        catch (error) {
+            logger.error("Error building context:", error);
+            return formatResponse({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    },
+};
+/**
+ * Generates a structured summary of the project context.
+ */
+function generateContextSummary(context) {
+    // Files by language
+    const filesByLanguage = {};
+    for (const file of context.files.values()) {
+        filesByLanguage[file.language] = (filesByLanguage[file.language] || 0) + 1;
+    }
+    // Symbols by kind
+    const symbolsByKind = {};
+    for (const definitions of context.symbolIndex.values()) {
+        for (const def of definitions) {
+            symbolsByKind[def.symbol.kind] =
+                (symbolsByKind[def.symbol.kind] || 0) + 1;
+        }
+    }
+    // Top imported files
+    const topImportedFiles = Array.from(context.reverseImportGraph.entries())
+        .map(([file, importers]) => ({
+        file: context.files.get(file)?.relativePath || file,
+        importedBy: importers.length,
+    }))
+        .sort((a, b) => b.importedBy - a.importedBy)
+        .slice(0, 10);
+    // Top symbols
+    const topSymbols = Array.from(context.symbolIndex.entries())
+        .filter(([_, definitions]) => definitions.length > 0)
+        .map(([name, definitions]) => ({ name, definedIn: definitions.length }))
+        .sort((a, b) => b.definedIn - a.definedIn)
+        .slice(0, 20);
+    // Directory structure
+    const directories = new Set();
+    for (const file of context.files.values()) {
+        const parts = file.relativePath.split("/");
+        if (parts.length > 1) {
+            directories.add(parts.slice(0, -1).join("/"));
+        }
+    }
+    const directoryStructure = Array.from(directories).sort().slice(0, 20);
+    return {
+        filesByLanguage,
+        symbolsByKind,
+        topImportedFiles,
+        topSymbols,
+        directoryStructure,
+    };
+}
+/**
+ * Formats the tool response for MCP.
+ */
+function formatResponse(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=buildContext.js.map

package/dist/tools/buildContext.js.map

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

package/dist/tools/getDependencyGraph.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Get Dependency Graph Tool (Improved Version)
+ *
+ * Returns the dependency graph for a file or directory.
+ *
+ * Improvements:
+ * 1. Refactored `findProjectRoot` for better readability and maintainability.
+ * 2. Improved `resolveTarget` to handle directory targets more accurately.
+ * 3. Centralized path normalization and handling.
+ * 4. Enhanced documentation and code structure.
+ *
+ * @format
+ */
+import { ToolDefinition } from "../types/tools.js";
+export declare const getDependencyGraphTool: ToolDefinition;
+//# sourceMappingURL=getDependencyGraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDependencyGraph.d.ts","sourceRoot":"","sources":["../../src/tools/getDependencyGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA8CnD,eAAO,MAAM,sBAAsB,EAAE,cAwLpC,CAAC"}