codeguardian-mcp 1.0.0

package/dist/resources/index.js

@@ -0,0 +1,328 @@
+/**
+ * Resource registration for CodeGuardian MCP
+ *
+ * Resources provide access to dynamic data and dashboards.
+ * Uses MCP Resources to expose large validation reports without
+ * overwhelming LLM context windows.
+ *
+ * @format
+ */
+import { ListResourcesRequestSchema, ReadResourceRequestSchema, ListResourceTemplatesRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { logger } from '../utils/logger.js';
+import { validationReportStore } from './validationReportStore.js';
+/**
+ * Register all resources with the MCP server
+ */
+export function registerResources(server) {
+    // =========================================================================
+    // List Resource Templates (for dynamic URIs)
+    // =========================================================================
+    server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+        return {
+            resourceTemplates: [
+                {
+                    uriTemplate: 'codeguardian://validation-report/{jobId}',
+                    name: 'Validation Report Summary',
+                    description: 'Summary of a validation job result. Use query params for chunks: ?type=hallucinations&chunk=0',
+                    mimeType: 'application/json',
+                },
+                {
+                    uriTemplate: 'codeguardian://validation-report/{jobId}/hallucinations/{chunk}',
+                    name: 'Hallucination Details',
+                    description: 'Paginated hallucination issues from a validation report',
+                    mimeType: 'application/json',
+                },
+                {
+                    uriTemplate: 'codeguardian://validation-report/{jobId}/dead-code/{chunk}',
+                    name: 'Dead Code Details',
+                    description: 'Paginated dead code issues from a validation report',
+                    mimeType: 'application/json',
+                },
+                {
+                    uriTemplate: 'codeguardian://validation-report/{jobId}/by-severity/{severity}',
+                    name: 'Issues by Severity',
+                    description: 'Issues filtered by severity (critical, high, medium, low, warning)',
+                    mimeType: 'application/json',
+                },
+                {
+                    uriTemplate: 'codeguardian://validation-report/{jobId}/by-type/{type}',
+                    name: 'Issues by Type',
+                    description: 'Issues filtered by type (e.g. dependencyHallucination)',
+                    mimeType: 'application/json',
+                },
+                {
+                    uriTemplate: 'codeguardian://validation-report/{jobId}/by-file/{filePath}',
+                    name: 'Issues by File',
+                    description: 'Issues filtered by file path',
+                    mimeType: 'application/json',
+                },
+            ],
+        };
+    });
+    // =========================================================================
+    // List Available Resources
+    // =========================================================================
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        // Get dynamic validation reports
+        const validationReports = validationReportStore.list().map(report => ({
+            uri: report.uri,
+            name: `Validation Report: ${report.jobId}`,
+            description: `${report.totalIssues} issues found - Created ${report.createdAt}`,
+            mimeType: 'application/json',
+        }));
+        return {
+            resources: [
+                // Static resources
+                {
+                    uri: 'codeguardian://quality-dashboard',
+                    name: 'Quality Dashboard',
+                    description: 'Real-time code quality metrics and trends',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'codeguardian://vulnerability-db',
+                    name: 'Vulnerability Database',
+                    description: 'Common AI-generated security vulnerabilities',
+                    mimeType: 'application/json',
+                },
+                {
+                    uri: 'codeguardian://best-practices',
+                    name: 'Best Practices Library',
+                    description: 'Context-aware coding best practices',
+                    mimeType: 'application/json',
+                },
+                // Dynamic validation reports
+                ...validationReports,
+            ],
+        };
+    });
+    // =========================================================================
+    // Read Resource Content
+    // =========================================================================
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        logger.info(`Reading resource: ${uri}`);
+        try {
+            // Parse validation report URIs
+            // Pattern: codeguardian://validation-report/{jobId}[/hallucinations|dead-code/{chunk}]
+            const validationMatch = uri.match(/^codeguardian:\/\/validation-report\/([^/]+)(\/(.+))?$/);
+            if (validationMatch) {
+                const jobId = validationMatch[1];
+                const subPath = validationMatch[3];
+                if (!validationReportStore.has(jobId)) {
+                    throw new Error(`Validation report not found: ${jobId}`);
+                }
+                // Return summary if no subpath
+                if (!subPath) {
+                    const summary = validationReportStore.getSummary(jobId);
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify({
+                                    ...summary,
+                                    _help: {
+                                        message: 'This is a summary. Use the URIs below to fetch detailed issue chunks.',
+                                        hallucinations: `${uri}/hallucinations/0`,
+                                        deadCode: `${uri}/dead-code/0`,
+                                        filter: `Use get_validation_results with filters for specific queries`,
+                                    },
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                // Parse chunk requests: hallucinations/{chunk} or dead-code/{chunk}
+                const hallucinationChunkMatch = subPath.match(/^hallucinations\/(\d+)$/);
+                if (hallucinationChunkMatch) {
+                    const chunkIndex = parseInt(hallucinationChunkMatch[1], 10);
+                    const chunk = validationReportStore.getHallucinationsChunk(jobId, chunkIndex);
+                    if (!chunk) {
+                        throw new Error(`Invalid chunk index: ${chunkIndex}`);
+                    }
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify({
+                                    jobId,
+                                    ...chunk,
+                                    nextChunk: chunk.chunkIndex < chunk.totalChunks - 1
+                                        ? `codeguardian://validation-report/${jobId}/hallucinations/${chunk.chunkIndex + 1}`
+                                        : null,
+                                    prevChunk: chunk.chunkIndex > 0
+                                        ? `codeguardian://validation-report/${jobId}/hallucinations/${chunk.chunkIndex - 1}`
+                                        : null,
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                const deadCodeChunkMatch = subPath.match(/^dead-code\/(\d+)$/);
+                if (deadCodeChunkMatch) {
+                    const chunkIndex = parseInt(deadCodeChunkMatch[1], 10);
+                    const chunk = validationReportStore.getDeadCodeChunk(jobId, chunkIndex);
+                    if (!chunk) {
+                        throw new Error(`Invalid chunk index: ${chunkIndex}`);
+                    }
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify({
+                                    jobId,
+                                    ...chunk,
+                                    nextChunk: chunk.chunkIndex < chunk.totalChunks - 1
+                                        ? `codeguardian://validation-report/${jobId}/dead-code/${chunk.chunkIndex + 1}`
+                                        : null,
+                                    prevChunk: chunk.chunkIndex > 0
+                                        ? `codeguardian://validation-report/${jobId}/dead-code/${chunk.chunkIndex - 1}`
+                                        : null,
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                // Parse categorized requests
+                const severityMatch = subPath.match(/^by-severity\/([^/]+)$/);
+                if (severityMatch) {
+                    const severity = severityMatch[1];
+                    const categorized = validationReportStore.getBySeverity(jobId);
+                    if (!categorized || !categorized[severity]) {
+                        throw new Error(`Invalid severity category: ${severity}`);
+                    }
+                    return {
+                        contents: [{
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify({
+                                    jobId,
+                                    category: 'severity',
+                                    filter: severity,
+                                    count: categorized[severity].length,
+                                    issues: categorized[severity],
+                                }, null, 2),
+                            }],
+                    };
+                }
+                const typeMatch = subPath.match(/^by-type\/([^/]+)$/);
+                if (typeMatch) {
+                    const type = typeMatch[1];
+                    const categorized = validationReportStore.getByType(jobId);
+                    if (!categorized || !categorized[type]) {
+                        throw new Error(`Invalid issue type: ${type}`);
+                    }
+                    return {
+                        contents: [{
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify({
+                                    jobId,
+                                    category: 'type',
+                                    filter: type,
+                                    count: categorized[type].length,
+                                    issues: categorized[type],
+                                }, null, 2),
+                            }],
+                    };
+                }
+                const fileMatch = subPath.match(/^by-file\/(.+)$/);
+                if (fileMatch) {
+                    // Decode generic URI component just in case, though usually handled by MCP
+                    const filePath = decodeURIComponent(fileMatch[1]);
+                    const categorized = validationReportStore.getByFile(jobId);
+                    // Try exact match or partial match
+                    let issues = categorized ? categorized[filePath] : undefined;
+                    if (!issues && categorized) {
+                        // Fallback: try finding by partial string if exact match fails
+                        const key = Object.keys(categorized).find(k => k.includes(filePath));
+                        if (key)
+                            issues = categorized[key];
+                    }
+                    if (!issues) {
+                        return {
+                            contents: [{
+                                    uri,
+                                    mimeType: 'application/json',
+                                    text: JSON.stringify({
+                                        jobId,
+                                        category: 'file',
+                                        filter: filePath,
+                                        count: 0,
+                                        issues: [],
+                                        message: "No issues found for this file path."
+                                    }, null, 2),
+                                }],
+                        };
+                    }
+                    return {
+                        contents: [{
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify({
+                                    jobId,
+                                    category: 'file',
+                                    filter: filePath,
+                                    count: issues.length,
+                                    issues: issues,
+                                }, null, 2),
+                            }],
+                    };
+                }
+                throw new Error(`Unknown validation report path: ${subPath}`);
+            }
+            // Static resources
+            switch (uri) {
+                case 'codeguardian://quality-dashboard':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify({
+                                    message: 'Quality dashboard - coming soon',
+                                    metrics: {},
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                case 'codeguardian://vulnerability-db':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify({
+                                    message: 'Vulnerability database - coming soon',
+                                    vulnerabilities: [],
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                case 'codeguardian://best-practices':
+                    return {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: 'application/json',
+                                text: JSON.stringify({
+                                    message: 'Best practices library - coming soon',
+                                    practices: [],
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                default:
+                    throw new Error(`Unknown resource: ${uri}`);
+            }
+        }
+        catch (error) {
+            logger.error(`Error reading resource ${uri}:`, error);
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

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

package/dist/resources/validationReportStore.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Validation Report Store
+ *
+ * In-memory store for validation reports, exposed via MCP Resources.
+ * This allows LLMs to receive a compact URI instead of massive JSON blobs.
+ *
+ * Reports are saved in TWO locations:
+ * 1. `.codeguardian/reports/` - internal cache (gitignored)
+ * 2. `codeguardian-report.json` - LLM-readable file at project root (NOT gitignored)
+ *
+ * The LLM-readable file allows AI assistants to access results via standard
+ * file-reading tools, even when `.codeguardian/` is in `.gitignore`.
+ *
+ * @format
+ */
+export interface ValidationReportChunk {
+    chunkIndex: number;
+    totalChunks: number;
+    type: 'hallucinations' | 'dead_code' | 'summary' | 'full';
+    data: any;
+}
+export interface StoredReport {
+    jobId: string;
+    createdAt: number;
+    expiresAt: number;
+    summary: any;
+    stats: any;
+    hallucinations: any[];
+    deadCode: any[];
+    score?: number;
+    recommendation?: any;
+}
+declare class ValidationReportStore {
+    private reports;
+    private readonly TTL;
+    private cleanupInterval?;
+    private readonly CHUNK_SIZE;
+    private reportsDir;
+    private jobProjectMap;
+    constructor(baseDir?: string);
+    /**
+     * Initialize persistence (create directories and load existing)
+     */
+    private initializePersistence;
+    /**
+     * Save report to disk in the project-specific directory.
+     *
+     * Saves to TWO locations:
+     * 1. `.codeguardian/reports/{jobId}.json` - internal cache (gitignored)
+     * 2. `codeguardian-report.json` - LLM-readable file at project root
+     *
+     * The LLM-readable file is placed OUTSIDE `.codeguardian/` so that
+     * AI assistants using file-reading tools (which often respect .gitignore)
+     * can still access the validation results.
+     */
+    private saveReportToDisk;
+    /**
+     * Save an LLM-readable report file at the project root.
+     *
+     * This file is NOT inside `.codeguardian/` so it can be read by
+     * LLM file-reading tools that respect `.gitignore`.
+     *
+     * The file is intentionally compact: it includes the summary, score,
+     * recommendation, and the full issues list. For very large reports,
+     * the LLM can use pagination via the MCP Resources API.
+     */
+    private saveLLMReadableReport;
+    /**
+     * Get the path to the LLM-readable report file for a project
+     */
+    getLLMReportPath(projectPath: string): string;
+    /**
+     * Get the project path associated with a job
+     */
+    getJobProjectPath(jobId: string): string | undefined;
+    /**
+     * Delete report from disk
+     */
+    private deleteReportFromDisk;
+    /**
+     * Load all reports from disk by scanning known project paths
+     * from guardian persistence configs.
+     */
+    private loadAllReports;
+    /**
+     * Store a validation report
+     *
+     * IMPORTANT: This method is async and waits for the report to be written to disk.
+     * This ensures the file exists immediately when the method resolves.
+     */
+    store(jobId: string, projectPath: string, report: Omit<StoredReport, 'jobId' | 'createdAt' | 'expiresAt'>): Promise<string>;
+    /**
+     * Get the resource URI for a report
+     */
+    getReportUri(jobId: string): string;
+    /**
+     * Get a stored report
+     */
+    get(jobId: string): StoredReport | undefined;
+    /**
+     * Check if a report exists
+     */
+    has(jobId: string): boolean;
+    /**
+     * Get report summary (lightweight)
+     */
+    getSummary(jobId: string): object | undefined;
+    /**
+     * Get a chunk of hallucinations
+     */
+    getHallucinationsChunk(jobId: string, chunkIndex: number): ValidationReportChunk | undefined;
+    /**
+     * Get a chunk of dead code
+     */
+    getDeadCodeChunk(jobId: string, chunkIndex: number): ValidationReportChunk | undefined;
+    /**
+     * Get filtered issues (with severity, file, etc.)
+     */
+    getFilteredIssues(jobId: string, options?: {
+        type?: 'hallucinations' | 'dead_code';
+        severity?: string;
+        file?: string;
+        limit?: number;
+        offset?: number;
+    }): {
+        issues: any[];
+        total: number;
+        hasMore: boolean;
+    } | undefined;
+    /**
+     * Get issues categorized by severity
+     * Returns: { critical: [...], high: [...], medium: [...], low: [...], warning: [...] }
+     */
+    getBySeverity(jobId: string): Record<string, any[]> | undefined;
+    /**
+     * Get issues categorized by type
+     * Returns: { dependencyHallucination: [...], nonExistentFunction: [...], deadCode: [...], etc. }
+     */
+    getByType(jobId: string): Record<string, any[]> | undefined;
+    /**
+     * Get issues categorized by file
+     * Returns: { "src/foo.ts": [...], "src/bar.ts": [...], etc. }
+     */
+    getByFile(jobId: string): Record<string, any[]> | undefined;
+    /**
+     * Get a categorized summary (counts only, no full issue data)
+     * Lightweight for LLM decision-making on what to fetch next.
+     */
+    getCategorizedSummary(jobId: string): object | undefined;
+    /**
+     * List all available reports
+     */
+    list(): Array<{
+        jobId: string;
+        uri: string;
+        createdAt: string;
+        totalIssues: number;
+    }>;
+    /**
+     * Cleanup expired reports
+     */
+    private cleanup;
+    /**
+     * Shutdown
+     */
+    shutdown(): void;
+}
+export declare const validationReportStore: ValidationReportStore;
+export {};
+//# sourceMappingURL=validationReportStore.d.ts.map

package/dist/resources/validationReportStore.d.ts.map

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