codeguardian-mcp 1.0.0

package/dist/utils/gitUtils.js

@@ -0,0 +1,81 @@
+/**
+ * Git Utilities
+ *
+ * Provides git-related functionality for branch-aware caching.
+ * Inspired by Augment Code's per-branch context isolation.
+ *
+ * @format
+ */
+import { simpleGit } from "simple-git";
+import { logger } from "./logger.js";
+// Short-lived cache for getGitInfo to avoid spawning redundant git subprocesses
+// during rapid file changes (e.g., vibecoding)
+const gitInfoCache = new Map();
+const GIT_INFO_CACHE_TTL_MS = 5_000; // 5 seconds
+/**
+ * Get current git branch and commit SHA for a project
+ * Returns null if not a git repository
+ */
+export async function getGitInfo(projectPath) {
+    // Return cached result if fresh enough (avoids spawning 2-3 git subprocesses per call)
+    const cached = gitInfoCache.get(projectPath);
+    if (cached && Date.now() - cached.timestamp < GIT_INFO_CACHE_TTL_MS) {
+        return cached.info;
+    }
+    try {
+        const git = simpleGit(projectPath);
+        // Check if it's a git repository
+        const isRepo = await git.checkIsRepo();
+        if (!isRepo) {
+            logger.debug(`${projectPath} is not a git repository`);
+            gitInfoCache.set(projectPath, { info: null, timestamp: Date.now() });
+            return null;
+        }
+        // Get current branch
+        const branch = await git.revparse(["--abbrev-ref", "HEAD"]);
+        // Get current commit SHA (short version for cache key)
+        const commitSHA = await git.revparse(["--short", "HEAD"]);
+        logger.debug(`Git info for ${projectPath}: ${branch}@${commitSHA}`);
+        const info = {
+            branch: branch.trim(),
+            commitSHA: commitSHA.trim(),
+            isRepo: true,
+        };
+        gitInfoCache.set(projectPath, { info, timestamp: Date.now() });
+        return info;
+    }
+    catch (error) {
+        logger.debug(`Failed to get git info for ${projectPath}:`, error);
+        gitInfoCache.set(projectPath, { info: null, timestamp: Date.now() });
+        return null;
+    }
+}
+/**
+ * Generate a cache key that includes git context
+ * Format: projectPath:language:includeTests:branch:commitSHA
+ */
+export function generateCacheKey(projectPath, language, includeTests, gitInfo) {
+    const baseKey = `${projectPath}:${language}:${includeTests}`;
+    if (!gitInfo) {
+        return baseKey;
+    }
+    return `${baseKey}:${gitInfo.branch}:${gitInfo.commitSHA}`;
+}
+/**
+ * Check if git state has changed (branch switch or new commits)
+ */
+export async function hasGitChanged(projectPath, cachedGitInfo) {
+    const currentGitInfo = await getGitInfo(projectPath);
+    // If one is a repo and the other isn't, it changed
+    if ((currentGitInfo === null) !== (cachedGitInfo === null)) {
+        return true;
+    }
+    // If not a repo, no git changes
+    if (!currentGitInfo || !cachedGitInfo) {
+        return false;
+    }
+    // Check if branch or commit changed
+    return (currentGitInfo.branch !== cachedGitInfo.branch ||
+        currentGitInfo.commitSHA !== cachedGitInfo.commitSHA);
+}
+//# sourceMappingURL=gitUtils.js.map

package/dist/utils/gitUtils.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Simple logging utility for CodeGuardian MCP
+ */
+declare class Logger {
+    private level;
+    constructor();
+    private log;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAW;;IAOxB,OAAO,CAAC,GAAG;IAQX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;IAIrC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;IAIpC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;IAIpC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;CAGtC;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,38 @@
+/**
+ * Simple logging utility for CodeGuardian MCP
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+class Logger {
+    level;
+    constructor() {
+        const envLevel = process.env.LOG_LEVEL?.toUpperCase() || 'INFO';
+        this.level = LogLevel[envLevel] || LogLevel.INFO;
+    }
+    log(level, message, ...args) {
+        if (level >= this.level) {
+            const timestamp = new Date().toISOString();
+            const levelName = LogLevel[level];
+            console.error(`[${timestamp}] [${levelName}] ${message}`, ...args);
+        }
+    }
+    debug(message, ...args) {
+        this.log(LogLevel.DEBUG, message, ...args);
+    }
+    info(message, ...args) {
+        this.log(LogLevel.INFO, message, ...args);
+    }
+    warn(message, ...args) {
+        this.log(LogLevel.WARN, message, ...args);
+    }
+    error(message, ...args) {
+        this.log(LogLevel.ERROR, message, ...args);
+    }
+}
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,IAAK,QAKJ;AALD,WAAK,QAAQ;IACX,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;AACX,CAAC,EALI,QAAQ,KAAR,QAAQ,QAKZ;AAED,MAAM,MAAM;IACF,KAAK,CAAW;IAExB;QACE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,MAAM,CAAC;QAChE,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,QAAiC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC;IAC5E,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,GAAG,IAAW;QAC1D,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,SAAS,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/dist/utils/serialization.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Serialization Utilities
+ *
+ * Helper functions to serialize/deserialize complex objects (Maps, Sets)
+ * for JSON storage. required because JSON.stringify doesn't handle Map/Set.
+ *
+ * @format
+ */
+/**
+ * Replacer function for JSON.stringify to handle Map and Set
+ */
+export declare function replacer(key: string, value: any): any;
+/**
+ * Reviver function for JSON.parse to restore Map and Set
+ */
+export declare function reviver(key: string, value: any): any;
+/**
+ * Serialize an object to JSON string, handling Maps and Sets
+ */
+export declare function serialize(data: any): string;
+/**
+ * Deserialize a JSON string to an object, restoring Maps and Sets
+ */
+export declare function deserialize<T>(json: string): T;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/utils/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/utils/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAcrD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAUpD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAE9C"}

package/dist/utils/serialization.js

@@ -0,0 +1,53 @@
+/**
+ * Serialization Utilities
+ *
+ * Helper functions to serialize/deserialize complex objects (Maps, Sets)
+ * for JSON storage. required because JSON.stringify doesn't handle Map/Set.
+ *
+ * @format
+ */
+/**
+ * Replacer function for JSON.stringify to handle Map and Set
+ */
+export function replacer(key, value) {
+    if (value instanceof Map) {
+        return {
+            dataType: "Map",
+            value: Array.from(value.entries()),
+        };
+    }
+    if (value instanceof Set) {
+        return {
+            dataType: "Set",
+            value: Array.from(value),
+        };
+    }
+    return value;
+}
+/**
+ * Reviver function for JSON.parse to restore Map and Set
+ */
+export function reviver(key, value) {
+    if (typeof value === "object" && value !== null) {
+        if (value.dataType === "Map") {
+            return new Map(value.value);
+        }
+        if (value.dataType === "Set") {
+            return new Set(value.value);
+        }
+    }
+    return value;
+}
+/**
+ * Serialize an object to JSON string, handling Maps and Sets
+ */
+export function serialize(data) {
+    return JSON.stringify(data, replacer);
+}
+/**
+ * Deserialize a JSON string to an object, restoring Maps and Sets
+ */
+export function deserialize(json) {
+    return JSON.parse(json, reviver);
+}
+//# sourceMappingURL=serialization.js.map

package/dist/utils/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../src/utils/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,KAAU;IAC9C,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;SACnC,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;SACzB,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,KAAU;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC7B,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC7B,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAS;IACjC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAI,IAAY;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "codeguardian-mcp",
+  "version": "1.0.0",
+  "description": "CodeGuardian MCP - Automated Quality Assurance for Vibe Coding with AI Hallucination Prevention",
+  "main": "dist/server.js",
+  "bin": {
+    "codeguardian-mcp": "dist/server.js"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/server.js",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:jest": "jest",
+    "test:jest:watch": "jest --watch",
+    "test:jest:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix"
+  },
+  "keywords": [
+    "mcp",
+    "code-quality",
+    "vibe-coding",
+    "ai-coding",
+    "quality-assurance",
+    "security",
+    "testing",
+    "hallucination-prevention"
+  ],
+  "author": "BridgeMind",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codegoddy/codeguardian_mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/codegoddy/codeguardian_mcp/issues"
+  },
+  "homepage": "https://github.com/codegoddy/codeguardian_mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "acorn": "^8.15.0",
+    "acorn-walk": "^8.3.4",
+    "chokidar": "^5.0.0",
+    "eslint": "^9.39.2",
+    "glob": "^13.0.0",
+    "minimatch": "^10.0.1",
+    "semver": "^7.7.3",
+    "simple-git": "^3.30.0",
+    "smol-toml": "^1.6.0",
+    "tree-sitter": "^0.25.0",
+    "tree-sitter-javascript": "^0.25.0",
+    "tree-sitter-python": "^0.25.0",
+    "tree-sitter-typescript": "^0.23.2"
+  },
+  "devDependencies": {
+    "@swc/core": "^1.15.10",
+    "@swc/jest": "^0.2.39",
+    "@types/eslint": "^9.6.1",
+    "@types/jest": "^30.0.0",
+    "@types/minimatch": "^5.1.2",
+    "@types/node": "^25.0.9",
+    "@vitest/coverage-v8": "^4.0.18",
+    "fast-check": "^4.5.3",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "pnpm": {
+    "executionEnv": {
+      "nodeVersion": "20.20.0"
+    }
+  }
+}