@mohantn/gate-keeper 2.1.0

package/dist/mcp/handlers/impact.js

@@ -0,0 +1,139 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleImpactAnalysis = handleImpactAnalysis;
+exports.handlePredictImpactWithRemediation = handlePredictImpactWithRemediation;
+const path = __importStar(require("path"));
+const helpers_1 = require("../helpers");
+const shared_1 = require("./shared");
+const impact_format_1 = require("./impact-format");
+// ── Graph traversal helpers ─────────────────────────────────
+function buildReverseAdjacency(graph) {
+    const reverseAdj = new Map();
+    for (const edge of graph.edges) {
+        const sources = reverseAdj.get(edge.target) ?? [];
+        sources.push(edge.source);
+        reverseAdj.set(edge.target, sources);
+    }
+    return reverseAdj;
+}
+function collectTransitiveDependents(reverseAdj, filePath) {
+    const direct = new Set(reverseAdj.get(filePath) ?? []);
+    const all = new Set();
+    const stack = [...direct];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (all.has(current))
+            continue;
+        all.add(current);
+        for (const next of reverseAdj.get(current) ?? []) {
+            if (!all.has(next))
+                stack.push(next);
+        }
+    }
+    return { direct, all };
+}
+// ── Handlers ───────────────────────────────────────────────
+async function handleImpactAnalysis(args) {
+    const filePath = String(args.file_path ?? '');
+    if (!filePath)
+        return (0, shared_1.text)('Error: file_path is required.');
+    const repo = String(args.repo ?? (0, helpers_1.findGitRoot)(path.dirname(filePath)));
+    const encodedRepo = encodeURIComponent(repo);
+    const graphRaw = await (0, helpers_1.fetchDaemonApi)(`/api/graph?repo=${encodedRepo}`);
+    if (!graphRaw) {
+        return (0, shared_1.text)('Error: Gate Keeper daemon is not running. Start it with `npm run daemon` or `npm run dev`.');
+    }
+    const graph = graphRaw;
+    const reverseAdj = buildReverseAdjacency(graph);
+    const { direct: directDeps, all: allDeps } = collectTransitiveDependents(reverseAdj, filePath);
+    const transitiveDeps = [...allDeps].filter(d => !directDeps.has(d));
+    const lines = [
+        `## Impact Analysis: ${path.basename(filePath)}`,
+        `**Path:** ${filePath}`,
+        `**Direct dependents:** ${directDeps.size} | **Total affected (transitive):** ${allDeps.size}`,
+        '',
+        ...(0, impact_format_1.renderDirectDependents)(graph, directDeps, repo),
+        ...(0, impact_format_1.renderTransitiveDependents)(graph, transitiveDeps, repo),
+        ...(0, impact_format_1.renderAtRiskDependents)(graph, allDeps, repo),
+    ];
+    if (allDeps.size === 0) {
+        lines.push('No other files depend on this file. Changes here have no downstream impact.');
+    }
+    const affectedNodes = graph.nodes.filter(n => allDeps.has(n.id));
+    const atRisk = affectedNodes.filter(n => n.rating < 6).sort((a, b) => a.rating - b.rating);
+    const data = {
+        filePath,
+        direct: [...directDeps],
+        transitive: transitiveDeps,
+        atRisk,
+    };
+    return (0, shared_1.envelope)('get_impact_analysis', data, lines.join('\n'));
+}
+async function handlePredictImpactWithRemediation(args) {
+    const filePath = String(args.file_path ?? '');
+    if (!filePath)
+        return (0, shared_1.text)('Error: file_path is required.');
+    const repo = String(args.repo ?? (0, helpers_1.findGitRoot)(path.dirname(filePath)));
+    const encodedRepo = encodeURIComponent(repo);
+    const [graphRaw, cyclesRaw] = await Promise.all([
+        (0, helpers_1.fetchDaemonApi)(`/api/graph?repo=${encodedRepo}`),
+        (0, helpers_1.fetchDaemonApi)(`/api/cycles?repo=${encodedRepo}`),
+    ]);
+    if (!graphRaw) {
+        return (0, shared_1.text)('Error: Gate Keeper daemon is not running. Start it with `npm run daemon` or `npm run dev`.');
+    }
+    const graph = graphRaw;
+    const cycles = (cyclesRaw ?? []);
+    const reverseAdj = buildReverseAdjacency(graph);
+    const { direct: directDeps, all: allDeps } = collectTransitiveDependents(reverseAdj, filePath);
+    const transitiveDeps = [...allDeps].filter(d => !directDeps.has(d));
+    const remediation = await (0, impact_format_1.renderRemediationPlan)(graph, allDeps, cycles, repo);
+    const plan = await (0, impact_format_1.buildRemediationPlan)(filePath, graph, directDeps, allDeps);
+    const lines = [
+        `## Impact + Remediation: ${path.basename(filePath)}`,
+        `**Path:** ${filePath}`,
+        `**Direct dependents:** ${directDeps.size} | **Total affected (transitive):** ${allDeps.size}`,
+        '',
+        ...(0, impact_format_1.renderDirectDependents)(graph, directDeps, repo),
+        ...(0, impact_format_1.renderTransitiveDependents)(graph, transitiveDeps, repo),
+        ...remediation,
+    ];
+    if (allDeps.size === 0) {
+        lines.push('No other files depend on this file. Changes here have no downstream impact.');
+    }
+    return (0, shared_1.envelope)('predict_impact_with_remediation', plan, lines.join('\n'));
+}
+//# sourceMappingURL=impact.js.map

package/dist/mcp/handlers/impact.js.map

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

package/dist/mcp/handlers/improvement.d.ts

@@ -0,0 +1,4 @@
+import { McpResponse } from './shared';
+export declare function handleSuggestRefactoring(args: Record<string, unknown>): Promise<McpResponse>;
+export declare function handleViolationPatterns(args: Record<string, unknown>): Promise<McpResponse>;
+//# sourceMappingURL=improvement.d.ts.map

package/dist/mcp/handlers/improvement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improvement.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/improvement.ts"],"names":[],"mappings":"AAQA,OAAO,EAAkB,WAAW,EAAE,MAAM,UAAU,CAAC;AAUvD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAiDlG;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CA4DjG"}

package/dist/mcp/handlers/improvement.js

@@ -0,0 +1,136 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSuggestRefactoring = handleSuggestRefactoring;
+exports.handleViolationPatterns = handleViolationPatterns;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const universal_analyzer_1 = require("../../analyzer/universal-analyzer");
+const refactoring_advisor_1 = require("../../analyzer/refactoring-advisor");
+const pattern_detector_1 = require("../../analyzer/pattern-detector");
+const helpers_1 = require("../helpers");
+const shared_1 = require("./shared");
+// ── Shared instances ───────────────────────────────────────
+const fileAnalyzer = new universal_analyzer_1.UniversalAnalyzer();
+const refactoringAdvisor = new refactoring_advisor_1.RefactoringAdvisor();
+const patternDetector = new pattern_detector_1.PatternDetector();
+// ── Handlers ───────────────────────────────────────────────
+async function handleSuggestRefactoring(args) {
+    const filePath = String(args.file_path ?? '');
+    if (!filePath)
+        return (0, shared_1.text)('Error: file_path is required.');
+    if (!fs.existsSync(filePath))
+        return (0, shared_1.text)(`Error: File not found: ${filePath}`);
+    if (!fileAnalyzer.isSupportedFile(filePath)) {
+        return (0, shared_1.text)('Error: Unsupported file type. Supported: .ts, .tsx, .jsx, .js, .cs');
+    }
+    const analysis = await fileAnalyzer.analyze(filePath);
+    if (!analysis)
+        return (0, shared_1.text)('Error: Analysis returned no results.');
+    const repo = (0, helpers_1.findGitRoot)(path.dirname(filePath));
+    const encodedRepo = encodeURIComponent(repo);
+    const cyclesRaw = await (0, helpers_1.fetchDaemonApi)(`/api/cycles?repo=${encodedRepo}`);
+    const cycles = (cyclesRaw ?? []);
+    const hints = refactoringAdvisor.suggest(analysis, cycles);
+    if (hints.length === 0) {
+        return (0, shared_1.envelope)('suggest_refactoring', { file: analysis, hints: [], rating: analysis.rating, totalPotentialGain: 0 }, `## Refactoring Suggestions: ${path.basename(filePath)}\n\nNo refactoring hints — file looks clean!`);
+    }
+    const lines = [
+        `## Refactoring Suggestions: ${path.basename(filePath)}`,
+        `**Current Rating: ${analysis.rating}/10** | **${hints.length} hint(s) found**`,
+        `**Total Potential Gain: +${Math.round(hints.reduce((s, h) => s + h.estimatedRatingGain, 0) * 10) / 10} pts**`,
+        '',
+    ];
+    hints.forEach((hint, i) => {
+        const priorityIcon = hint.priority === 'high' ? '🔴' : hint.priority === 'medium' ? '🟡' : '🟢';
+        lines.push(`### ${i + 1}. ${hint.patternName} ${priorityIcon}`);
+        lines.push(`**Pattern:** \`${hint.violationType}\` | **Estimated Gain:** +${hint.estimatedRatingGain} pts`);
+        lines.push(`**Why:** ${hint.rationale}`);
+        lines.push('**Steps:**');
+        hint.steps.forEach((step, j) => lines.push(`${j + 1}. ${step}`));
+        lines.push('');
+    });
+    const totalPotentialGain = Math.round(hints.reduce((s, h) => s + h.estimatedRatingGain, 0) * 10) / 10;
+    return (0, shared_1.envelope)('suggest_refactoring', { file: analysis, hints, rating: analysis.rating, totalPotentialGain }, lines.join('\n'));
+}
+async function handleViolationPatterns(args) {
+    const repo = String(args.repo ?? (0, helpers_1.findGitRoot)(process.cwd()));
+    const encodedRepo = encodeURIComponent(repo);
+    let reports = null;
+    const daemonRaw = await (0, helpers_1.fetchDaemonApi)(`/api/patterns?repo=${encodedRepo}`);
+    if (daemonRaw && Array.isArray(daemonRaw)) {
+        reports = daemonRaw;
+    }
+    if (!reports) {
+        const files = (0, helpers_1.findSourceFiles)(repo, 200);
+        const analyses = [];
+        for (const f of files) {
+            const a = await fileAnalyzer.analyze(f);
+            if (a)
+                analyses.push(a);
+        }
+        reports = patternDetector.detect(analyses);
+    }
+    if (reports.length === 0) {
+        return (0, shared_1.envelope)('get_violation_patterns', { repo, patterns: [], totalGain: 0, fixOrder: [] }, '## Violation Patterns\n\nNo violations found across the codebase. Everything looks clean!');
+    }
+    const totalGain = Math.round(reports.reduce((s, r) => s + r.estimatedRatingGain, 0) * 10) / 10;
+    const lines = [
+        `## Violation Patterns — ${path.basename(repo)}`,
+        `**${reports.length} distinct violation types** across the codebase | **Total estimated gain if all fixed: +${totalGain} pts**`,
+        '',
+        '| Rank | Pattern | Severity | Files | Occurrences | Est. Gain |',
+        '|------|---------|----------|-------|-------------|-----------|',
+    ];
+    reports.forEach((r, i) => {
+        const sev = r.severity === 'error' ? '🔴 error' : r.severity === 'warning' ? '🟡 warning' : '🟢 info';
+        lines.push(`| ${i + 1} | \`${r.violationType}\` | ${sev} | ${r.fileCount} | ${r.totalOccurrences} | +${r.estimatedRatingGain} |`);
+    });
+    lines.push('');
+    lines.push('### Module-Wide Fix Suggestions (top 5 by impact)');
+    for (const r of reports.slice(0, 5)) {
+        lines.push(`**\`${r.violationType}\`** — ${r.moduleSuggestion}`);
+        lines.push(`  Affects: ${r.affectedFiles.slice(0, 3).map(f => path.relative(repo, f)).join(', ')}${r.fileCount > 3 ? ` ... and ${r.fileCount - 3} more` : ''}`);
+        lines.push('');
+    }
+    // Aggregate files across all patterns to give the queue a single fix order.
+    const fileSet = new Set();
+    for (const r of reports)
+        for (const f of r.affectedFiles)
+            fileSet.add(f);
+    const fixOrder = [...fileSet];
+    return (0, shared_1.envelope)('get_violation_patterns', { repo, patterns: reports, totalGain, fixOrder }, lines.join('\n'));
+}
+//# sourceMappingURL=improvement.js.map

package/dist/mcp/handlers/improvement.js.map

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

package/dist/mcp/handlers/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP Tool Handlers — barrel module
+ *
+ * Re-exports handler functions and provides the tool-call router
+ * used by the JSON-RPC message handler.
+ */
+import { text, McpResponse } from './shared';
+import { handleCodebaseHealth, handleQualityRules } from './analysis';
+import { handleFileContext, handleDependencyGraph, handleGraphSummary } from './graph';
+export { text };
+export { handleCodebaseHealth, handleQualityRules };
+export { handleFileContext, handleDependencyGraph, handleGraphSummary };
+export declare function handleToolCall(name: string, args: Record<string, unknown>): Promise<McpResponse>;
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,IAAI,EAAE,CAAC;AAChB,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC;AAExE,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC,CAetB"}

package/dist/mcp/handlers/index.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * MCP Tool Handlers — barrel module
+ *
+ * Re-exports handler functions and provides the tool-call router
+ * used by the JSON-RPC message handler.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleGraphSummary = exports.handleDependencyGraph = exports.handleFileContext = exports.handleQualityRules = exports.handleCodebaseHealth = exports.text = void 0;
+exports.handleToolCall = handleToolCall;
+const shared_1 = require("./shared");
+Object.defineProperty(exports, "text", { enumerable: true, get: function () { return shared_1.text; } });
+const analysis_1 = require("./analysis");
+Object.defineProperty(exports, "handleCodebaseHealth", { enumerable: true, get: function () { return analysis_1.handleCodebaseHealth; } });
+Object.defineProperty(exports, "handleQualityRules", { enumerable: true, get: function () { return analysis_1.handleQualityRules; } });
+const graph_1 = require("./graph");
+Object.defineProperty(exports, "handleFileContext", { enumerable: true, get: function () { return graph_1.handleFileContext; } });
+Object.defineProperty(exports, "handleDependencyGraph", { enumerable: true, get: function () { return graph_1.handleDependencyGraph; } });
+Object.defineProperty(exports, "handleGraphSummary", { enumerable: true, get: function () { return graph_1.handleGraphSummary; } });
+async function handleToolCall(name, args) {
+    switch (name) {
+        case 'get_codebase_health':
+            return (0, analysis_1.handleCodebaseHealth)(args);
+        case 'get_quality_rules':
+            return (0, analysis_1.handleQualityRules)();
+        case 'get_file_context':
+            return (0, graph_1.handleFileContext)(args);
+        case 'get_dependency_graph':
+            return (0, graph_1.handleDependencyGraph)(args);
+        case 'get_graph_summary':
+            return (0, graph_1.handleGraphSummary)(args);
+        default:
+            return (0, shared_1.text)(`Unknown tool: ${name}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/handlers/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAiBH,wCAkBC;AAjCD,qCAA6C;AAWpC,qFAXA,aAAI,OAWA;AAVb,yCAGoB;AAQX,qGAVP,+BAAoB,OAUO;AAAE,mGAT7B,6BAAkB,OAS6B;AAPjD,mCAIiB;AAIR,kGAPP,yBAAiB,OAOO;AAAE,sGAN1B,6BAAqB,OAM0B;AAAE,mGALjD,0BAAkB,OAKiD;AAE9D,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,IAA6B;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,qBAAqB;YACxB,OAAO,IAAA,+BAAoB,EAAC,IAAI,CAAC,CAAC;QACpC,KAAK,mBAAmB;YACtB,OAAO,IAAA,6BAAkB,GAAE,CAAC;QAC9B,KAAK,kBAAkB;YACrB,OAAO,IAAA,yBAAiB,EAAC,IAAI,CAAC,CAAC;QACjC,KAAK,sBAAsB;YACzB,OAAO,IAAA,6BAAqB,EAAC,IAAI,CAAC,CAAC;QACrC,KAAK,mBAAmB;YACtB,OAAO,IAAA,0BAAkB,EAAC,IAAI,CAAC,CAAC;QAClC;YACE,OAAO,IAAA,aAAI,EAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/mcp/handlers/platform-installer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP handlers for platform integration and git hook installation.
+ *
+ * install_platform — writes AI assistant config files (CLAUDE.md, copilot-instructions.md, etc.)
+ * install_git_hooks — installs post-commit / post-checkout hooks into .git/hooks/
+ */
+import { McpResponse } from './shared';
+export declare function handleInstallPlatform(args: Record<string, unknown>): Promise<McpResponse>;
+export declare function handleInstallGitHooks(args: Record<string, unknown>): Promise<McpResponse>;
+//# sourceMappingURL=platform-installer.d.ts.map

package/dist/mcp/handlers/platform-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-installer.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/platform-installer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAkB,WAAW,EAAE,MAAM,UAAU,CAAC;AAQvD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAyD/F;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAwC/F"}

package/dist/mcp/handlers/platform-installer.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * MCP handlers for platform integration and git hook installation.
+ *
+ * install_platform — writes AI assistant config files (CLAUDE.md, copilot-instructions.md, etc.)
+ * install_git_hooks — installs post-commit / post-checkout hooks into .git/hooks/
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleInstallPlatform = handleInstallPlatform;
+exports.handleInstallGitHooks = handleInstallGitHooks;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const helpers_1 = require("../helpers");
+const shared_1 = require("./shared");
+const installer_1 = require("../installer");
+const git_hooks_1 = require("../../hooks/git-hooks");
+const GATE_KEEPER_DIR = path.join(__dirname, '..', '..', '..');
+const SUPPORTED_PLATFORMS = ['claude-code', 'copilot', 'cursor', 'vscode', 'github-action'];
+async function handleInstallPlatform(args) {
+    const platform = String(args.platform ?? '');
+    if (!SUPPORTED_PLATFORMS.includes(platform)) {
+        return (0, shared_1.text)(`Error: unknown platform "${platform}". ` +
+            `Supported: ${SUPPORTED_PLATFORMS.join(', ')}.`);
+    }
+    const repo = String(args.repo ?? (0, helpers_1.findGitRoot)(process.cwd()));
+    const force = Boolean(args.force ?? false);
+    const gkPath = String(args.gate_keeper_path ?? GATE_KEEPER_DIR);
+    const config = (0, installer_1.getPlatformConfig)(platform, repo, gkPath);
+    const targetPath = config.filePath;
+    const exists = fs.existsSync(targetPath);
+    if (exists && !force && !config.append) {
+        return (0, shared_1.text)(`File already exists: ${targetPath}\n` +
+            `Pass force=true to overwrite, or use append mode if available.`);
+    }
+    try {
+        const dir = path.dirname(targetPath);
+        fs.mkdirSync(dir, { recursive: true });
+        if (config.append && exists) {
+            const current = fs.readFileSync(targetPath, 'utf8');
+            if (current.includes('Gate Keeper')) {
+                return (0, shared_1.text)(`Gate Keeper section already present in ${targetPath}. No changes made.`);
+            }
+            fs.appendFileSync(targetPath, config.content, 'utf8');
+        }
+        else {
+            fs.writeFileSync(targetPath, config.content, 'utf8');
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return (0, shared_1.text)(`Error writing ${targetPath}: ${msg}`);
+    }
+    const action = config.append ? 'appended to' : (exists ? 'updated' : 'created');
+    const lines = [
+        `## Platform Integration: ${platform}`,
+        `**${action}:** ${targetPath}`,
+        `**Description:** ${config.description}`,
+        '',
+        config.append
+            ? `Content appended to existing file.`
+            : `File written (${config.content.length} bytes).`,
+        '',
+        '**Next steps:**',
+        ...nextSteps(platform, repo),
+    ];
+    return (0, shared_1.envelope)('install_platform', { platform, filePath: targetPath, action }, lines.join('\n'));
+}
+async function handleInstallGitHooks(args) {
+    const repo = String(args.repo ?? (0, helpers_1.findGitRoot)(process.cwd()));
+    const force = Boolean(args.force ?? false);
+    const gkPath = String(args.gate_keeper_path ?? GATE_KEEPER_DIR);
+    let results;
+    try {
+        results = (0, git_hooks_1.installGitHooks)(repo, gkPath, force);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return (0, shared_1.text)(`Error installing git hooks: ${msg}`);
+    }
+    const created = results.filter(r => r.action === 'created').length;
+    const updated = results.filter(r => r.action === 'updated').length;
+    const skipped = results.filter(r => r.action === 'skipped').length;
+    const lines = [
+        '## Git Hooks Installation',
+        `**Repository:** ${repo}`,
+        `**Created:** ${created} | **Updated:** ${updated} | **Skipped:** ${skipped}`,
+        '',
+        '| Hook | Path | Action |',
+        '|------|------|--------|',
+        ...results.map(r => `| ${r.hook} | ${path.relative(repo, r.path)} | ${r.action} |`),
+        '',
+        '**Merge driver (optional):**',
+        'To prevent merge conflicts in graph.json, add to .gitattributes:',
+        '```',
+        (0, git_hooks_1.gitAttributesEntry)().trim(),
+        '```',
+        'And to .git/config:',
+        '```',
+        (0, git_hooks_1.gitConfigEntry)(gkPath).trim(),
+        '```',
+        '',
+        '_Hooks run non-blocking after commits/checkouts — they do not slow down git operations._',
+    ];
+    return (0, shared_1.envelope)('install_git_hooks', { repo, results }, lines.join('\n'));
+}
+function nextSteps(platform, repo) {
+    switch (platform) {
+        case 'claude-code':
+            return [
+                '- Restart Claude Code to load the updated CLAUDE.md.',
+                '- The session-start protocol will now automatically call `get_graph_report`.',
+            ];
+        case 'copilot':
+            return [
+                '- GitHub Copilot will read .github/copilot-instructions.md automatically.',
+                '- Ensure the gate-keeper MCP server is running: `npm run mcp`.',
+            ];
+        case 'cursor':
+            return [
+                '- Cursor reads .cursorrules automatically on project open.',
+                '- Ensure the gate-keeper MCP server is registered in Cursor settings.',
+            ];
+        case 'vscode':
+            return [
+                '- Open VS Code and accept the MCP server popup.',
+                '- Or run: `npm run mcp` and check the MCP panel.',
+            ];
+        case 'github-action':
+            return [
+                `- Commit .github/workflows/gate-keeper.yml to activate the workflow.`,
+                '- The workflow runs on push and PR, posting quality summaries as comments.',
+            ];
+    }
+}
+//# sourceMappingURL=platform-installer.js.map

package/dist/mcp/handlers/platform-installer.js.map

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

package/dist/mcp/handlers/pr-review.d.ts

@@ -0,0 +1,33 @@
+/**
+ * PR review handler — risk-scores a set of changed files against the graph.
+ *
+ * Each changed file gets a traffic-light verdict:
+ *   GREEN  — leaf node, no dependents, rating ≥ 7
+ *   YELLOW — some dependents OR rating 5–7
+ *   RED    — god node with fragile dependents OR rating < 5
+ *
+ * Returns an overall risk summary plus per-file breakdown.
+ */
+import { GraphResponse } from './types';
+import { McpResponse } from './shared';
+export type FileVerdict = 'GREEN' | 'YELLOW' | 'RED';
+export interface FileRisk {
+    file: string;
+    verdict: FileVerdict;
+    rating: number | null;
+    directDependents: number;
+    fragileImpacted: number;
+    reasons: string[];
+}
+export interface PRReviewResult {
+    overallVerdict: FileVerdict;
+    changedFiles: number;
+    redFiles: number;
+    yellowFiles: number;
+    greenFiles: number;
+    fileRisks: FileRisk[];
+    recommendation: string;
+}
+export declare function assessFile(filePath: string, graph: GraphResponse, revAdj: Map<string, string[]>, ratings: Map<string, number>): FileRisk;
+export declare function handlePRReview(args: Record<string, unknown>): Promise<McpResponse>;
+//# sourceMappingURL=pr-review.d.ts.map

package/dist/mcp/handlers/pr-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-review.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/pr-review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAkB,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAErD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,WAAW,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAQD,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC7B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,QAAQ,CAsCV;AAgBD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CA6ExF"}