skannr 0.2.0 → 0.2.1

package/dist/guard/symbol-diff.js

@@ -0,0 +1,243 @@
+"use strict";
+/**
+ * Build symbol-level diff units from staged git changes.
+ * Uses Skannr's existing parser to identify which symbols changed,
+ * instead of working with raw file diffs.
+ */
+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.getStagedFiles = getStagedFiles;
+exports.buildSymbolDiffs = buildSymbolDiffs;
+exports.buildSymbolDiffsFromDiff = buildSymbolDiffsFromDiff;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const child_process_1 = require("child_process");
+const registry_1 = require("../languages/registry");
+const scanner_1 = require("../scanner");
+/** Get the list of staged files (paths relative to root). */
+function getStagedFiles(root) {
+    try {
+        const output = (0, child_process_1.execSync)('git diff --cached --name-only --diff-filter=ACMR', {
+            cwd: root,
+            encoding: 'utf-8',
+        });
+        return output.trim().split('\n').filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/** Get the diff text for a specific staged file. */
+function getStagedDiff(root, file) {
+    try {
+        return (0, child_process_1.execSync)(`git diff --cached -- "${file}"`, {
+            cwd: root,
+            encoding: 'utf-8',
+            maxBuffer: 5 * 1024 * 1024,
+        });
+    }
+    catch {
+        return '';
+    }
+}
+/** Get the old (HEAD) version of a file, or null if newly added. */
+function getHeadContent(root, file) {
+    try {
+        return (0, child_process_1.execSync)(`git show HEAD:"${file}"`, {
+            cwd: root,
+            encoding: 'utf-8',
+            maxBuffer: 5 * 1024 * 1024,
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/** Extract changed line numbers from a unified diff. */
+function extractChangedLines(diff) {
+    const lines = new Set();
+    let currentLine = 0;
+    for (const line of diff.split('\n')) {
+        const hunkMatch = line.match(/^@@ -\d+(?:,\d+)? \+(\d+)/);
+        if (hunkMatch) {
+            currentLine = parseInt(hunkMatch[1], 10);
+            continue;
+        }
+        if (line.startsWith('+') && !line.startsWith('+++')) {
+            lines.add(currentLine);
+            currentLine++;
+        }
+        else if (line.startsWith('-') && !line.startsWith('---')) {
+            // Deleted lines don't advance the new-file line counter
+        }
+        else {
+            currentLine++;
+        }
+    }
+    return lines;
+}
+/**
+ * Determine which symbols in a file were affected by the staged changes.
+ * Matches symbols whose line range overlaps any changed line.
+ */
+function findAffectedSymbols(symbols, changedLines, allSymbols) {
+    if (changedLines.size === 0)
+        return [];
+    // Build approximate end lines: each symbol extends until the next symbol starts
+    const sorted = [...allSymbols].sort((a, b) => a.line - b.line);
+    const affected = [];
+    for (let i = 0; i < sorted.length; i++) {
+        const sym = sorted[i];
+        const startLine = sym.line;
+        const endLine = i + 1 < sorted.length ? sorted[i + 1].line - 1 : startLine + 50;
+        for (let line = startLine; line <= endLine; line++) {
+            if (changedLines.has(line)) {
+                affected.push(sym);
+                break;
+            }
+        }
+    }
+    return affected;
+}
+/**
+ * Build symbol-level diff units for all staged files in the project.
+ * This is the primary input to the review runner.
+ */
+function buildSymbolDiffs(root) {
+    const stagedFiles = getStagedFiles(root);
+    const units = [];
+    for (const relFile of stagedFiles) {
+        const absPath = path.join(root, relFile);
+        if (!fs.existsSync(absPath))
+            continue;
+        const adapter = (0, registry_1.getAdapter)(absPath);
+        const newContent = (0, scanner_1.readFileContent)(absPath);
+        if (!newContent)
+            continue;
+        const newSymbols = adapter.extractSymbols(newContent);
+        const oldContent = getHeadContent(root, relFile);
+        const oldSymbols = oldContent ? adapter.extractSymbols(oldContent) : [];
+        const diff = getStagedDiff(root, relFile);
+        const changedLines = extractChangedLines(diff);
+        // Find symbols that overlap changed lines in the new version
+        const affected = findAffectedSymbols(newSymbols, changedLines, newSymbols);
+        // Determine change type for each affected symbol
+        const oldSymbolNames = new Set(oldSymbols.map((s) => s.name));
+        for (const sym of affected) {
+            if (sym.kind === 'export')
+                continue; // skip synthetic export markers
+            const changeType = oldSymbolNames.has(sym.name) ? 'modified' : 'added';
+            const oldSym = oldSymbols.find((s) => s.name === sym.name);
+            units.push({
+                file: relFile,
+                symbol: sym.name,
+                changeType,
+                oldSignature: oldSym ? `${oldSym.kind} ${oldSym.name}` : undefined,
+                newSignature: `${sym.kind} ${sym.name}`,
+                callers: [], // populated by call-context module
+                callees: [], // populated by call-context module
+                diffText: diff,
+            });
+        }
+        // Handle deleted symbols (in old but not in new)
+        if (oldContent) {
+            const newSymbolNames = new Set(newSymbols.map((s) => s.name));
+            for (const oldSym of oldSymbols) {
+                if (oldSym.kind === 'export')
+                    continue;
+                if (!newSymbolNames.has(oldSym.name)) {
+                    units.push({
+                        file: relFile,
+                        symbol: oldSym.name,
+                        changeType: 'deleted',
+                        oldSignature: `${oldSym.kind} ${oldSym.name}`,
+                        callers: [],
+                        callees: [],
+                        diffText: diff,
+                    });
+                }
+            }
+        }
+    }
+    return units;
+}
+/**
+ * Build symbol diffs from a PR diff string (for --pr-mode).
+ */
+function buildSymbolDiffsFromDiff(root, diffContent) {
+    const parseDiff = require('parse-diff');
+    const parsedFiles = parseDiff(diffContent);
+    const units = [];
+    for (const file of parsedFiles) {
+        const raw = file.to ?? file.from;
+        if (!raw || raw === '/dev/null')
+            continue;
+        const relFile = raw.replace(/^[ab]\//, '');
+        const absPath = path.join(root, relFile);
+        if (!fs.existsSync(absPath))
+            continue;
+        const adapter = (0, registry_1.getAdapter)(absPath);
+        const content = (0, scanner_1.readFileContent)(absPath);
+        if (!content)
+            continue;
+        const symbols = adapter.extractSymbols(content);
+        const changedLines = new Set();
+        for (const chunk of file.chunks) {
+            for (const change of chunk.changes) {
+                if (change.type === 'add' || change.type === 'del') {
+                    const ln = change.ln;
+                    if (typeof ln === 'number')
+                        changedLines.add(ln);
+                }
+            }
+        }
+        const affected = findAffectedSymbols(symbols, changedLines, symbols);
+        for (const sym of affected) {
+            if (sym.kind === 'export')
+                continue;
+            units.push({
+                file: relFile,
+                symbol: sym.name,
+                changeType: 'modified',
+                newSignature: `${sym.kind} ${sym.name}`,
+                callers: [],
+                callees: [],
+                diffText: file.chunks.map((c) => c.content).join('\n'),
+            });
+        }
+    }
+    return units;
+}
+//# sourceMappingURL=symbol-diff.js.map

package/dist/guard/symbol-diff.js.map

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

package/dist/guard/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Shared type definitions for the guard module.
+ */
+/** Severity levels for rules and violations. */
+export type Severity = 'low' | 'medium' | 'high' | 'critical';
+/** A team-defined review rule. */
+export interface GuardRule {
+    id: string;
+    description: string;
+    severity: Severity;
+    fixable: boolean;
+    category: string;
+}
+/** A single symbol-level diff unit sent to the LLM for review. */
+export interface SymbolDiffUnit {
+    file: string;
+    symbol: string;
+    changeType: 'added' | 'modified' | 'deleted';
+    oldSignature?: string;
+    newSignature?: string;
+    callers: string[];
+    callees: string[];
+    diffText: string;
+}
+/** A violation found by the review. */
+export interface Violation {
+    rule_id: string;
+    file: string;
+    symbol: string;
+    line_start: number;
+    line_end: number;
+    severity: Severity;
+    confidence: number;
+    fixable: boolean;
+    message: string;
+    suggested_fix?: string;
+}
+/** The structured response contract from the LLM. */
+export interface ReviewResponse {
+    violations: Violation[];
+    status: 'pass' | 'fail';
+    summary: string;
+}
+/** Result of a full guard run. */
+export interface GuardResult {
+    response: ReviewResponse;
+    rulesUsed: GuardRule[];
+    symbolsReviewed: number;
+    durationMs: number;
+}
+/** Guard configuration (provider, model, etc.). */
+export interface GuardConfig {
+    /** LLM provider: 'gemini' | 'openai' */
+    provider: 'gemini' | 'openai';
+    /** Model name (e.g. 'gemini-2.0-flash-exp', 'gpt-4o'). */
+    model: string;
+    /** API key (resolved from env if not set). */
+    apiKey?: string;
+    /** OpenAI-compatible base URL (for openai provider). */
+    baseUrl?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/guard/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/guard/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gDAAgD;AAChD,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9D,kCAAkC;AAClC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC9B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/guard/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Shared type definitions for the guard module.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/guard/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/guard/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsBH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA8HpD"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsBH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA+KpD"}

package/dist/mcp-server.js

@@ -110,6 +110,32 @@ async function startMcpServer() {
                     required: ['root'],
                 },
             },
+            {
+                name: 'guard_review',
+                description: 'Review staged or diff changes against team-defined rules. Returns structured violations with severity, confidence, and fixability.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        root: {
+                            type: 'string',
+                            description: 'Absolute path to the repo root',
+                        },
+                        diff: {
+                            type: 'string',
+                            description: 'Unified diff content (if omitted, reviews staged files)',
+                        },
+                        diff_only: {
+                            type: 'boolean',
+                            description: 'Skip cross-file context for faster review (default: false)',
+                        },
+                        fix: {
+                            type: 'boolean',
+                            description: 'Apply auto-fixes for fixable violations (default: false)',
+                        },
+                    },
+                    required: ['root'],
+                },
+            },
         ],
     }));
     server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
@@ -156,6 +182,24 @@ async function startMcpServer() {
                 content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
             };
         }
+        if (toolName === 'guard_review') {
+            const { runGuard, formatGuardJson } = await Promise.resolve().then(() => __importStar(require('./guard/index')));
+            const root = String(args.root ?? '');
+            const diffContent = typeof args.diff === 'string' && args.diff.length > 0
+                ? args.diff
+                : undefined;
+            const diffOnly = args.diff_only === true;
+            const fix = args.fix === true;
+            const { result } = await runGuard({
+                root,
+                diffOnly,
+                fix,
+                ...(diffContent ? { prMode: false } : {}),
+            });
+            return {
+                content: [{ type: 'text', text: formatGuardJson(result) }],
+            };
+        }
         throw new Error(`Unknown tool: ${toolName}`);
     });
     const transport = new stdio_js_1.StdioServerTransport();

package/dist/mcp-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBH,wCA+KC;AAnMD,wEAAmE;AACnE,wEAAiF;AACjF,iEAAmG;AACnG,mCAAyC;AAEzC,MAAM,WAAW,GAAG,OAAO,CAAC;AAE5B,SAAS,mBAAmB,CAAC,OAAgB;IAC3C,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAEM,KAAK,UAAU,cAAc;IAClC,MAAM,MAAM,GAAG,IAAI,iBAAM,CACvB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,EACxC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EACT,uIAAuI;gBACzI,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,gDAAgD;yBAC9D;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,gCAAgC;yBAC9C;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,kCAAkC;yBAChD;wBACD,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,0CAA0C;yBACxD;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,gDAAgD;yBAC9D;qBACF;oBACD,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;iBAC/B;aACF;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,WAAW,EACT,+GAA+G;gBACjH,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,gCAAgC;yBAC9C;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,8DAA8D;yBAC5E;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,uDAAuD;yBACrE;qBACF;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;aACF;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,WAAW,EACT,oIAAoI;gBACtI,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,gCAAgC;yBAC9C;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,yDAAyD;yBACvE;wBACD,SAAS,EAAE;4BACT,IAAI,EAAE,SAAS;4BACf,WAAW,EAAE,4DAA4D;yBAC1E;wBACD,GAAG,EAAE;4BACH,IAAI,EAAE,SAAS;4BACf,WAAW,EAAE,0DAA0D;yBACxE;qBACF;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;aACF;SACF;KACF,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,gCAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,SAAoC,CAAC;QAEjE,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACrC,MAAM,KAAK,GACT,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC;gBAC3E,CAAC,CAAC,IAAI,CAAC,KAAK;gBACZ,CAAC,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;YAC7E,MAAM,IAAI,GAAI,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAW,CAAC,QAAQ,CAC7E,OAA0D,CAC3D;gBACC,CAAC,CAAE,OAA2D;gBAC9D,CAAC,CAAC,MAAM,CAAC;YAEX,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAc,EAAC;gBAClC,QAAQ;gBACR,IAAI;gBACJ,KAAK;gBACL,UAAU;gBACV,IAAI;gBACJ,eAAe,EAAE,IAAI;aACtB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YAChC,MAAM,EAAE,kBAAkB,EAAE,GAAG,wDAAa,gBAAgB,GAAC,CAAC;YAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACrC,MAAM,IAAI,GACR,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC;gBACxE,CAAC,CAAC,IAAI,CAAC,IAAI;gBACX,CAAC,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GACf,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBACnD,CAAC,CAAC,IAAI,CAAC,IAAI;gBACX,CAAC,CAAC,SAAS,CAAC;YAEhB,MAAM,MAAM,GAAG,kBAAkB,CAAC;gBAChC,IAAI;gBACJ,WAAW;gBACX,IAAI;aACL,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YAChC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,wDAAa,eAAe,GAAC,CAAC;YACpE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACrC,MAAM,WAAW,GACf,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBACnD,CAAC,CAAC,IAAI,CAAC,IAAI;gBACX,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;YACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC;YAE9B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC;gBAChC,IAAI;gBACJ,QAAQ;gBACR,GAAG;gBACH,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1C,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;aAC3D,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skannr",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "A universal tool to analyze any codebase and generate semantic skeletons for AI agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -35,7 +35,8 @@
     "ignore": "^7.0.5",
     "parse-diff": "0.12.0",
     "ts-morph": "^21.0.1",
-    "web-tree-sitter": "0.26.10"
+    "web-tree-sitter": "0.26.10",
+    "zod": "3.23.8"
   },
   "devDependencies": {
     "@types/jest": "^29.5.11",

package/src/cli.ts

@@ -483,6 +483,102 @@ cacheCommand
     console.log(`    Dir: ${cacheManager.getCacheDir()}\n`);
   });
 
+// ---------------------------------------------------------------------------
+// Subcommand: guard
+// ---------------------------------------------------------------------------
+const guardCommand = program
+  .command('guard')
+  .description('Review staged changes against team-defined rules')
+  .option('--root <path>', 'project root directory', process.cwd())
+  .option('--fix', 'apply auto-fixes for fixable violations')
+  .option('--dry-run', 'show what --fix would change without writing')
+  .option('--pr-mode', 'review full PR diff vs base branch')
+  .option('--diff-only', 'skip cross-file context (faster, cheaper)')
+  .option('--no-cache', 'ignore symbol cache')
+  .option('--json', 'output as JSON')
+  .action(async (cmdOpts: {
+    root: string;
+    fix?: boolean;
+    dryRun?: boolean;
+    prMode?: boolean;
+    diffOnly?: boolean;
+    noCache?: boolean;
+    json?: boolean;
+  }) => {
+    try {
+      const { runGuard, formatGuardText, formatGuardJson } = await import('./guard/index');
+      const { result, exitCode } = await runGuard({
+        root: cmdOpts.root,
+        fix: cmdOpts.fix,
+        dryRun: cmdOpts.dryRun,
+        prMode: cmdOpts.prMode,
+        diffOnly: cmdOpts.diffOnly,
+        noCache: cmdOpts.noCache,
+        json: cmdOpts.json,
+      });
+
+      const output = cmdOpts.json
+        ? formatGuardJson(result)
+        : formatGuardText(result);
+
+      process.stdout.write(output + (output.endsWith('\n') ? '' : '\n'));
+      process.exit(exitCode);
+    } catch (error) {
+      console.error(
+        'Error running guard:',
+        error instanceof Error ? error.message : error,
+      );
+      process.exit(2);
+    }
+  });
+
+guardCommand
+  .command('install')
+  .description('Install git pre-commit hook')
+  .option('--root <path>', 'project root directory', process.cwd())
+  .action(async (cmdOpts: { root: string }) => {
+    const { installHook } = await import('./guard/index');
+    const { installed, message } = installHook(path.resolve(cmdOpts.root));
+    console.log(message);
+    process.exit(installed ? 0 : 1);
+  });
+
+guardCommand
+  .command('uninstall')
+  .description('Remove git pre-commit hook')
+  .option('--root <path>', 'project root directory', process.cwd())
+  .action(async (cmdOpts: { root: string }) => {
+    const { uninstallHook } = await import('./guard/index');
+    const { removed, message } = uninstallHook(path.resolve(cmdOpts.root));
+    console.log(message);
+    process.exit(removed ? 0 : 1);
+  });
+
+guardCommand
+  .command('config')
+  .description('Show loaded rules and provider config')
+  .option('--root <path>', 'project root directory', process.cwd())
+  .action(async (cmdOpts: { root: string }) => {
+    const { loadRules, loadGuardConfig } = await import('./guard/index');
+    const root = path.resolve(cmdOpts.root);
+    try {
+      const rules = loadRules(root);
+      const config = loadGuardConfig(root);
+      console.log('\n  Guard Config:');
+      console.log(`    Provider: ${config.provider}`);
+      console.log(`    Model: ${config.model}`);
+      console.log(`    API Key: ${config.apiKey ? '***' + config.apiKey.slice(-4) : 'not set'}`);
+      console.log(`\n  Rules (${rules.length}):`);
+      for (const r of rules) {
+        console.log(`    [${r.id}] ${r.severity} | fixable=${r.fixable} | ${r.description}`);
+      }
+      console.log('');
+    } catch (error) {
+      console.error(error instanceof Error ? error.message : error);
+      process.exit(2);
+    }
+  });
+
 // ---------------------------------------------------------------------------
 // Help
 // ---------------------------------------------------------------------------
@@ -499,6 +595,11 @@ Examples:
   skannr risk --diff feature.patch         Impact of a patch file
   skannr risk -n 3 --json                  3 hops, JSON for CI
 
+  skannr guard                             Review staged changes against rules
+  skannr guard --fix                       Auto-fix fixable violations
+  skannr guard --pr-mode --json            Review PR diff, JSON output
+  skannr guard install                     Install pre-commit hook
+
   skannr report                            Repo health summary
   skannr agent                             Interactive mode
   skannr cache stats                       Cache hit rate

package/src/guard/call-context.ts

@@ -0,0 +1,101 @@
+/**
+ * Pull caller/callee context from the existing dependency graph.
+ * Enriches SymbolDiffUnit[] with cross-file relationship information
+ * so the LLM can detect breakages beyond the changed file.
+ */
+
+import * as path from 'path';
+import { scanFiles, readFileContent } from '../scanner';
+import { analyzeDependencyGraph } from '../ranker-enhanced';
+import { getAdapter } from '../languages/registry';
+import { buildReverseGraph } from '../blast-radius';
+import { loadConfig } from '../config';
+import type { SymbolDiffUnit } from './types';
+
+/**
+ * Enrich symbol diff units with caller and callee context.
+ * Uses the project's dependency graph to find:
+ * - callers: files that import the changed file (reverse deps)
+ * - callees: files that the changed file imports (forward deps)
+ */
+export function enrichWithCallContext(
+  units: SymbolDiffUnit[],
+  root: string,
+): SymbolDiffUnit[] {
+  if (units.length === 0) return units;
+
+  // Scan project files and build dependency graph
+  const config = loadConfig(root);
+  const allFiles = scanFiles(root, {
+    extensions: config.extensions,
+    exclude: config.exclude,
+  });
+
+  const forwardGraph = analyzeDependencyGraph(allFiles, root);
+  const reverseGraph = buildReverseGraph(forwardGraph);
+
+  // Group units by file
+  const fileSet = new Set(units.map((u) => u.file));
+
+  for (const unit of units) {
+    const fileRel = unit.file;
+    const fileNoExt = fileRel.replace(/\.[^.]+$/, '');
+    const fileBase = path.basename(fileRel, path.extname(fileRel));
+
+    // Find callers (files that import this file)
+    const callers: string[] = [];
+    for (const [key, importers] of reverseGraph.entries()) {
+      const normalizedKey = key.split(path.sep).join('/');
+      if (
+        normalizedKey === fileRel ||
+        normalizedKey === fileNoExt ||
+        normalizedKey.endsWith('/' + fileBase)
+      ) {
+        for (const importer of importers) {
+          callers.push(importer);
+        }
+      }
+    }
+
+    // Find callees (files this file imports)
+    const callees: string[] = [];
+    const normalizedFileRel = fileRel.split(path.sep).join('/');
+    for (const [key, imports] of forwardGraph.entries()) {
+      const normalizedKey = key.split(path.sep).join('/');
+      if (normalizedKey === normalizedFileRel) {
+        callees.push(...imports);
+        break;
+      }
+    }
+
+    // Format as "file:symbol" where possible
+    unit.callers = [...new Set(callers)].slice(0, 10).map((c) => formatCallerRef(c, root));
+    unit.callees = [...new Set(callees)].slice(0, 10);
+  }
+
+  return units;
+}
+
+/**
+ * Format a caller file reference, attempting to identify which symbols
+ * in that file actually reference the changed file.
+ */
+function formatCallerRef(callerFile: string, root: string): string {
+  const absPath = path.join(root, callerFile);
+  const content = readFileContent(absPath);
+  if (!content) return callerFile;
+
+  const adapter = getAdapter(absPath);
+  const symbols = adapter.extractSymbols(content);
+
+  // Return the file with its top exported symbols for context
+  const topSymbols = symbols
+    .filter((s) => s.kind === 'function' || s.kind === 'class')
+    .slice(0, 3)
+    .map((s) => s.name);
+
+  if (topSymbols.length > 0) {
+    return `${callerFile}:${topSymbols.join(',')}`;
+  }
+  return callerFile;
+}