codeguardian-mcp 1.0.0

package/dist/prompts/templates.js

@@ -0,0 +1,97 @@
+/**
+ * Validation Prompt Templates
+ *
+ * Based on prompt engineering best practices:
+ * - Zero-shot: Direct validation
+ * - Few-shot: Learning from examples
+ * - Chain-of-Thought: Step-by-step reasoning
+ * - Self-consistency: Multiple perspectives
+ *
+ * @format
+ */
+import { PROMPT_PATTERNS, VALIDATION_CONSTRAINTS } from "./library.js";
+export const VALIDATION_TEMPLATES = {
+    /**
+     * Zero-shot: Direct validation without examples
+     * Best for: Simple, straightforward validation tasks
+     */
+    zeroShot: (code) => `Use validate_code to check this code for hallucinations (non-existent functions, wrong methods, etc.):\n\n${code}`,
+    /**
+     * Few-shot: Validation with examples of common mistakes
+     * Best for: Teaching the model what to look for
+     */
+    fewShot: (code) => {
+        const task = "Check this code for hallucinations, missing dependencies, and wrong methods.";
+        const examples = [
+            {
+                input: "const user = getUserById(id);",
+                output: "❌ BAD: function doesn't exist",
+                explanation: "The project uses findUserById instead."
+            },
+            {
+                input: "import { Button } from 'react-ui';",
+                output: "❌ BAD: package not installed",
+                explanation: "Package 'react-ui' is missing from package.json."
+            }
+        ];
+        return PROMPT_PATTERNS.withExamples(task, examples) + `\n\nCode to validate:\n\`\`\`\n${code}\n\`\`\``;
+    },
+    /**
+     * Chain-of-Thought: Step-by-step reasoning
+     * Best for: Complex validation requiring detailed analysis
+     */
+    chainOfThought: (code) => {
+        const task = `Analyze this code systematically using validate_code:\n\n\`\`\`\n${code}\n\`\`\``;
+        const steps = [
+            "Extract all function calls and class instantiations",
+            "Check each symbol against the project's symbol table",
+            "Verify all imports exist in package.json/requirements.txt",
+            "Check for dead code (unused exports)",
+            "Provide specific fixes with reasoning"
+        ];
+        return PROMPT_PATTERNS.stepByStep(task, steps);
+    },
+    /**
+     * Self-consistency: Multiple validation perspectives
+     * Best for: High-stakes code requiring thorough review
+     */
+    selfConsistency: (code) => {
+        const task = `Validate this code from multiple perspectives using validate_code:\n\n\`\`\`\n${code}\n\`\`\``;
+        const perspectives = [
+            "Symbol Validation: Are all functions, classes, and methods defined?",
+            "Dependency Validation: Are all packages in the manifest?",
+            "Logic Validation: Does the code make logical sense?"
+        ];
+        return PROMPT_PATTERNS.multiPerspective(task, perspectives);
+    },
+    /**
+     * Structured output: Validation with explicit format requirements
+     * Best for: Integration with automated systems
+     */
+    structuredOutput: (code) => {
+        const task = `Use validate_code to analyze this code:\n\n\`\`\`\n${code}\n\`\`\``;
+        const format = `
+VALIDATION SUMMARY:
+- Status: [PASS/FAIL]
+- Score: [0-100]
+- Hallucinations Found: [count]
+
+CRITICAL ISSUES (if any):
+1. [Issue description]
+   - Severity: [critical/high/medium/low]
+   - Suggestion: [specific fix]
+   - Confidence: [0-100%]
+    `;
+        return PROMPT_PATTERNS.structuredOutput(task, format);
+    },
+    /**
+     * Role-based: Validation from expert perspective
+     * Best for: Domain-specific validation
+     */
+    roleBased: (code, role = "senior code reviewer") => {
+        const task = `Thoroughly review this code for hallucinations and missing dependencies:\n\n\`\`\`\n${code}\n\`\`\``;
+        const rolePrompt = PROMPT_PATTERNS.role(role, task);
+        return PROMPT_PATTERNS.withConstraints(rolePrompt, VALIDATION_CONSTRAINTS);
+    },
+};
+//# sourceMappingURL=templates.js.map

package/dist/prompts/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/prompts/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEvE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE,CACzB,6GAA6G,IAAI,EAAE;IAErH;;;OAGG;IACH,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,8EAA8E,CAAC;QAC5F,MAAM,QAAQ,GAAG;YACf;gBACE,KAAK,EAAE,+BAA+B;gBACtC,MAAM,EAAE,+BAA+B;gBACvC,WAAW,EAAE,wCAAwC;aACtD;YACD;gBACE,KAAK,EAAE,oCAAoC;gBAC3C,MAAM,EAAE,8BAA8B;gBACtC,WAAW,EAAE,kDAAkD;aAChE;SACF,CAAC;QAEF,OAAO,eAAe,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,kCAAkC,IAAI,UAAU,CAAC;IACzG,CAAC;IAED;;;OAGG;IACH,cAAc,EAAE,CAAC,IAAY,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,oEAAoE,IAAI,UAAU,CAAC;QAChG,MAAM,KAAK,GAAG;YACZ,qDAAqD;YACrD,sDAAsD;YACtD,2DAA2D;YAC3D,sCAAsC;YACtC,uCAAuC;SACxC,CAAC;QAEF,OAAO,eAAe,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,eAAe,EAAE,CAAC,IAAY,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,iFAAiF,IAAI,UAAU,CAAC;QAC7G,MAAM,YAAY,GAAG;YACnB,qEAAqE;YACrE,0DAA0D;YAC1D,qDAAqD;SACtD,CAAC;QAEF,OAAO,eAAe,CAAC,gBAAgB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,gBAAgB,EAAE,CAAC,IAAY,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,sDAAsD,IAAI,UAAU,CAAC;QAClF,MAAM,MAAM,GAAG;;;;;;;;;;;KAWd,CAAC;QAEF,OAAO,eAAe,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAY,EAAE,OAAe,sBAAsB,EAAE,EAAE;QACjE,MAAM,IAAI,GAAG,uFAAuF,IAAI,UAAU,CAAC;QACnH,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO,eAAe,CAAC,eAAe,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;IAC7E,CAAC;CACF,CAAC"}

package/dist/queue/jobPersistence.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Job Persistence Layer
+ *
+ * Saves job state to disk so jobs survive server restarts.
+ *
+ * @format
+ */
+import type { Job } from "./jobQueue.js";
+export declare class JobPersistence {
+    private jobsDir;
+    constructor(baseDir?: string);
+    /**
+     * Initialize persistence (create directories)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Save job to disk
+     */
+    saveJob(job: Job): Promise<void>;
+    /**
+     * Load job from disk
+     */
+    loadJob(jobId: string): Promise<Job | null>;
+    /**
+     * Delete job from disk
+     */
+    deleteJob(jobId: string): Promise<void>;
+    /**
+     * Load all jobs from disk
+     */
+    loadAllJobs(): Promise<Job[]>;
+    /**
+     * Clean up old jobs
+     */
+    cleanupExpiredJobs(expirationTime: number): Promise<number>;
+    /**
+     * Get job file path
+     */
+    private getJobPath;
+    /**
+     * Check if persistence is available
+     */
+    isAvailable(): Promise<boolean>;
+}
+export declare const jobPersistence: JobPersistence;
+//# sourceMappingURL=jobPersistence.d.ts.map

package/dist/queue/jobPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobPersistence.d.ts","sourceRoot":"","sources":["../../src/queue/jobPersistence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAYzC,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAiB;IAItC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtC;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAejD;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IA2BnC;;OAEG;IACG,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBjE;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAQtC;AAMD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/queue/jobPersistence.js

@@ -0,0 +1,158 @@
+/**
+ * Job Persistence Layer
+ *
+ * Saves job state to disk so jobs survive server restarts.
+ *
+ * @format
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+import { logger } from "../utils/logger.js";
+// ============================================================================
+// Configuration
+// ============================================================================
+const JOBS_DIR = ".codeguardian/jobs";
+// ============================================================================
+// Persistence API
+// ============================================================================
+export class JobPersistence {
+    jobsDir;
+    constructor(baseDir = JOBS_DIR) {
+        this.jobsDir = baseDir;
+    }
+    /**
+     * Initialize persistence (create directories)
+     */
+    async initialize() {
+        try {
+            await fs.mkdir(this.jobsDir, { recursive: true });
+            logger.info(`Job persistence initialized: ${this.jobsDir}`);
+        }
+        catch (error) {
+            logger.error("Failed to initialize job persistence:", error);
+            throw error;
+        }
+    }
+    /**
+     * Save job to disk
+     */
+    async saveJob(job) {
+        try {
+            const filePath = this.getJobPath(job.id);
+            await fs.writeFile(filePath, JSON.stringify(job, null, 2), "utf-8");
+            logger.debug(`Job saved: ${job.id}`);
+        }
+        catch (error) {
+            logger.error(`Failed to save job ${job.id}:`, error);
+            // Don't throw - persistence failure shouldn't break job execution
+        }
+    }
+    /**
+     * Load job from disk
+     */
+    async loadJob(jobId) {
+        try {
+            const filePath = this.getJobPath(jobId);
+            const content = await fs.readFile(filePath, "utf-8");
+            const job = JSON.parse(content);
+            logger.debug(`Job loaded: ${jobId}`);
+            return job;
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                logger.error(`Failed to load job ${jobId}:`, error);
+            }
+            return null;
+        }
+    }
+    /**
+     * Delete job from disk
+     */
+    async deleteJob(jobId) {
+        try {
+            const filePath = this.getJobPath(jobId);
+            await fs.unlink(filePath);
+            logger.debug(`Job deleted: ${jobId}`);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                logger.error(`Failed to delete job ${jobId}:`, error);
+            }
+        }
+    }
+    /**
+     * Load all jobs from disk
+     */
+    async loadAllJobs() {
+        try {
+            const files = await fs.readdir(this.jobsDir);
+            const jobs = [];
+            for (const file of files) {
+                if (file.endsWith(".json")) {
+                    const jobId = file.replace(".json", "");
+                    const job = await this.loadJob(jobId);
+                    if (job) {
+                        jobs.push(job);
+                    }
+                }
+            }
+            logger.info(`Loaded ${jobs.length} jobs from disk`);
+            return jobs;
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                // Directory doesn't exist yet
+                return [];
+            }
+            logger.error("Failed to load jobs:", error);
+            return [];
+        }
+    }
+    /**
+     * Clean up old jobs
+     */
+    async cleanupExpiredJobs(expirationTime) {
+        try {
+            const jobs = await this.loadAllJobs();
+            const now = Date.now();
+            let cleaned = 0;
+            for (const job of jobs) {
+                if (job.expiresAt < now) {
+                    await this.deleteJob(job.id);
+                    cleaned++;
+                }
+            }
+            if (cleaned > 0) {
+                logger.info(`Cleaned up ${cleaned} expired jobs from disk`);
+            }
+            return cleaned;
+        }
+        catch (error) {
+            logger.error("Failed to cleanup expired jobs:", error);
+            return 0;
+        }
+    }
+    /**
+     * Get job file path
+     */
+    getJobPath(jobId) {
+        return path.join(this.jobsDir, `${jobId}.json`);
+    }
+    /**
+     * Check if persistence is available
+     */
+    async isAvailable() {
+        try {
+            await fs.access(this.jobsDir);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// ============================================================================
+// Singleton Instance
+// ============================================================================
+export const jobPersistence = new JobPersistence();
+//# sourceMappingURL=jobPersistence.js.map

package/dist/queue/jobPersistence.js.map

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

package/dist/queue/jobQueue.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Job Queue Manager - Noise Reduction Applied
+ *
+ * Handles long-running validation jobs that exceed MCP timeout limits.
+ * Jobs run in background and results are retrieved separately.
+ *
+ * @format
+ */
+import { EventEmitter } from "node:events";
+export type JobStatus = "queued" | "processing" | "complete" | "failed" | "cancelled";
+export interface Job<TInput = any, TResult = any> {
+    id: string;
+    type: string;
+    input: TInput;
+    status: JobStatus;
+    progress?: JobProgress;
+    result?: TResult;
+    error?: string;
+    createdAt: number;
+    startedAt?: number;
+    completedAt?: number;
+    expiresAt: number;
+}
+export interface JobProgress {
+    phase: string;
+    percent: number;
+    message?: string;
+    details?: Record<string, any>;
+}
+export type JobHandler<TInput = any, TResult = any> = (input: TInput, updateProgress: (progress: JobProgress) => void) => Promise<TResult>;
+export declare class JobQueue extends EventEmitter {
+    private jobs;
+    private handlers;
+    private processing;
+    private maxConcurrent;
+    private jobTTL;
+    private cleanupInterval?;
+    constructor(options?: {
+        maxConcurrent?: number;
+        jobTTL?: number;
+    });
+    /**
+     * Initialize persistence and load existing jobs
+     */
+    private initializePersistence;
+    /**
+     * Register a job handler
+     */
+    registerHandler<TInput, TResult>(type: string, handler: JobHandler<TInput, TResult>): void;
+    /**
+     * Submit a new job
+     */
+    submitJob<TInput, TResult>(type: string, input: TInput): Promise<string>;
+    /**
+     * Get job status
+     */
+    getJob(jobId: string): Job | undefined;
+    /**
+     * Get job status (public API)
+     */
+    getJobStatus(jobId: string): {
+        exists: boolean;
+        status?: JobStatus;
+        progress?: JobProgress;
+        error?: string;
+    };
+    /**
+     * Get job results
+     */
+    getJobResults<TResult>(jobId: string): {
+        exists: boolean;
+        status?: JobStatus;
+        result?: TResult;
+        error?: string;
+    };
+    /**
+     * Cancel a job
+     */
+    cancelJob(jobId: string): boolean;
+    /**
+     * List all jobs (for debugging)
+     */
+    listJobs(filter?: {
+        status?: JobStatus;
+        type?: string;
+    }): Job[];
+    /**
+     * Process next job in queue
+     */
+    private processNext;
+    /**
+     * Cleanup expired jobs
+     */
+    private cleanupExpiredJobs;
+    /**
+     * Generate unique job ID
+     */
+    private generateJobId;
+    /**
+     * Get queue statistics
+     */
+    getStats(): {
+        total: number;
+        queued: number;
+        processing: number;
+        complete: number;
+        failed: number;
+        cancelled: number;
+    };
+    /**
+     * Shutdown the job queue and cleanup resources
+     */
+    shutdown(): void;
+}
+export declare const jobQueue: JobQueue;
+//# sourceMappingURL=jobQueue.d.ts.map

package/dist/queue/jobQueue.d.ts.map

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