skannr 0.2.0 → 0.2.2

package/dist/guard/hook-installer.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * Git hook installer for skannr guard.
+ * Appends to existing hooks using markers — never overwrites.
+ */
+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.installHook = installHook;
+exports.uninstallHook = uninstallHook;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const HOOK_START_MARKER = '# >>> skannr-guard start >>>';
+const HOOK_END_MARKER = '# <<< skannr-guard end <<<';
+const HOOK_CONTENT = `
+${HOOK_START_MARKER}
+# Run skannr guard on staged files before committing.
+# Exit code 1 blocks the commit; exit code 2 is a tool error (non-blocking).
+npx skannr guard
+GUARD_EXIT=$?
+if [ $GUARD_EXIT -eq 1 ]; then
+  echo ""
+  echo "  Commit blocked by skannr guard. Fix violations or use --no-verify to skip."
+  echo ""
+  exit 1
+fi
+${HOOK_END_MARKER}
+`;
+/**
+ * Install the pre-commit hook (append-safe).
+ */
+function installHook(root) {
+    const hooksDir = path.join(root, '.git', 'hooks');
+    if (!fs.existsSync(path.join(root, '.git'))) {
+        return { installed: false, message: 'Not a git repository (no .git directory found).' };
+    }
+    if (!fs.existsSync(hooksDir)) {
+        fs.mkdirSync(hooksDir, { recursive: true });
+    }
+    const hookPath = path.join(hooksDir, 'pre-commit');
+    if (fs.existsSync(hookPath)) {
+        const existing = fs.readFileSync(hookPath, 'utf-8');
+        // Already installed?
+        if (existing.includes(HOOK_START_MARKER)) {
+            return { installed: true, message: 'Hook already installed.' };
+        }
+        // Append to existing hook
+        const updated = existing.trimEnd() + '\n\n' + HOOK_CONTENT.trim() + '\n';
+        fs.writeFileSync(hookPath, updated, { mode: 0o755 });
+    }
+    else {
+        // Create new hook
+        const content = '#!/bin/sh\n' + HOOK_CONTENT;
+        fs.writeFileSync(hookPath, content, { mode: 0o755 });
+    }
+    return { installed: true, message: `Hook installed at ${hookPath}` };
+}
+/**
+ * Uninstall the pre-commit hook (remove only our markers).
+ */
+function uninstallHook(root) {
+    const hookPath = path.join(root, '.git', 'hooks', 'pre-commit');
+    if (!fs.existsSync(hookPath)) {
+        return { removed: false, message: 'No pre-commit hook found.' };
+    }
+    const content = fs.readFileSync(hookPath, 'utf-8');
+    if (!content.includes(HOOK_START_MARKER)) {
+        return { removed: false, message: 'Skannr guard hook not found in pre-commit.' };
+    }
+    // Remove everything between (and including) the markers
+    const startIdx = content.indexOf(HOOK_START_MARKER);
+    const endIdx = content.indexOf(HOOK_END_MARKER);
+    if (startIdx === -1 || endIdx === -1) {
+        return { removed: false, message: 'Malformed hook markers.' };
+    }
+    const before = content.slice(0, startIdx).trimEnd();
+    const after = content.slice(endIdx + HOOK_END_MARKER.length).trimStart();
+    const updated = (before + '\n' + after).trim();
+    if (updated === '#!/bin/sh' || updated === '') {
+        // Hook is now empty — remove the file
+        fs.unlinkSync(hookPath);
+    }
+    else {
+        fs.writeFileSync(hookPath, updated + '\n', { mode: 0o755 });
+    }
+    return { removed: true, message: 'Skannr guard hook removed.' };
+}
+//# sourceMappingURL=hook-installer.js.map

package/dist/guard/hook-installer.js.map

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

package/dist/guard/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Skannr Guard — entry point.
+ * Reviews staged changes against team-defined rules using symbol-level analysis.
+ */
+import type { GuardResult } from './types';
+export interface GuardCliOptions {
+    root: string;
+    fix?: boolean;
+    dryRun?: boolean;
+    prMode?: boolean;
+    diffOnly?: boolean;
+    noCache?: boolean;
+    json?: boolean;
+}
+/**
+ * Run the guard review and return the result + exit code.
+ * Exit codes: 0 = pass, 1 = fail (violations), 2 = tool error.
+ */
+export declare function runGuard(options: GuardCliOptions): Promise<{
+    result: GuardResult;
+    exitCode: number;
+}>;
+/**
+ * Format the guard result for terminal output.
+ */
+export declare function formatGuardText(result: GuardResult): string;
+/**
+ * Format the guard result as JSON.
+ */
+export declare function formatGuardJson(result: GuardResult): string;
+export { installHook, uninstallHook } from './hook-installer';
+export { loadRules, loadGuardConfig } from './rules-loader';
+export type { GuardResult, Violation } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guard/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,SAAS,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA6C3G;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAsC3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAS3D;AAGD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}

package/dist/guard/index.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Skannr Guard — entry point.
+ * Reviews staged changes against team-defined rules using symbol-level analysis.
+ */
+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.loadGuardConfig = exports.loadRules = exports.uninstallHook = exports.installHook = void 0;
+exports.runGuard = runGuard;
+exports.formatGuardText = formatGuardText;
+exports.formatGuardJson = formatGuardJson;
+const path = __importStar(require("path"));
+const review_runner_1 = require("./review-runner");
+const fix_applier_1 = require("./fix-applier");
+/**
+ * Run the guard review and return the result + exit code.
+ * Exit codes: 0 = pass, 1 = fail (violations), 2 = tool error.
+ */
+async function runGuard(options) {
+    const { root, fix = false, dryRun = false, prMode = false, diffOnly = false, noCache = false } = options;
+    const absoluteRoot = path.resolve(root);
+    // Get PR diff if in --pr-mode
+    let diffContent;
+    if (prMode) {
+        const { execSync } = await Promise.resolve().then(() => __importStar(require('child_process')));
+        try {
+            diffContent = execSync('git diff origin/main...HEAD', {
+                cwd: absoluteRoot,
+                encoding: 'utf-8',
+                maxBuffer: 10 * 1024 * 1024,
+            });
+        }
+        catch {
+            diffContent = execSync('git diff main...HEAD', {
+                cwd: absoluteRoot,
+                encoding: 'utf-8',
+                maxBuffer: 10 * 1024 * 1024,
+            });
+        }
+    }
+    const result = await (0, review_runner_1.runGuardReview)({
+        root: absoluteRoot,
+        diffContent,
+        diffOnly,
+        noCache,
+    });
+    // Handle --fix
+    if (fix && result.response.violations.length > 0) {
+        if (dryRun) {
+            const previews = (0, fix_applier_1.previewFixes)(result.response.violations, absoluteRoot);
+            const output = (0, fix_applier_1.formatFixResults)(previews, true);
+            process.stdout.write(output + '\n');
+        }
+        else {
+            const applied = (0, fix_applier_1.applyFixes)(result.response.violations, absoluteRoot);
+            const output = (0, fix_applier_1.formatFixResults)(applied, false);
+            process.stdout.write(output + '\n');
+        }
+    }
+    const exitCode = result.response.status === 'fail' ? 1 : 0;
+    return { result, exitCode };
+}
+/**
+ * Format the guard result for terminal output.
+ */
+function formatGuardText(result) {
+    const lines = [];
+    const { response } = result;
+    lines.push('');
+    lines.push('  Skannr Guard');
+    lines.push('  ' + '─'.repeat(50));
+    lines.push('');
+    lines.push(`  Status: ${response.status.toUpperCase()}`);
+    lines.push(`  ${response.summary}`);
+    lines.push(`  Reviewed ${result.symbolsReviewed} symbol(s) against ${result.rulesUsed.length} rule(s) in ${result.durationMs}ms`);
+    lines.push('');
+    if (response.violations.length > 0) {
+        lines.push('  Violations:');
+        lines.push('');
+        for (const v of response.violations) {
+            const fixTag = v.fixable ? ' [FIXABLE]' : '';
+            const confTag = `(${Math.round(v.confidence * 100)}% confidence)`;
+            lines.push(`    ${v.severity.toUpperCase()} ${v.file}:${v.line_start} ${confTag}${fixTag}`);
+            lines.push(`      Rule: ${v.rule_id}`);
+            lines.push(`      Symbol: ${v.symbol}`);
+            lines.push(`      ${v.message}`);
+            if (v.suggested_fix) {
+                lines.push(`      Fix: ${v.suggested_fix}`);
+            }
+            lines.push('');
+        }
+        const fixableCount = response.violations.filter((v) => v.fixable).length;
+        if (fixableCount > 0) {
+            lines.push(`  ${fixableCount} violation(s) are auto-fixable. Run: skannr guard --fix`);
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Format the guard result as JSON.
+ */
+function formatGuardJson(result) {
+    return JSON.stringify({
+        status: result.response.status,
+        summary: result.response.summary,
+        violations: result.response.violations,
+        symbolsReviewed: result.symbolsReviewed,
+        rulesUsed: result.rulesUsed.length,
+        durationMs: result.durationMs,
+    }, null, 2);
+}
+// Re-export for CLI/MCP wiring
+var hook_installer_1 = require("./hook-installer");
+Object.defineProperty(exports, "installHook", { enumerable: true, get: function () { return hook_installer_1.installHook; } });
+Object.defineProperty(exports, "uninstallHook", { enumerable: true, get: function () { return hook_installer_1.uninstallHook; } });
+var rules_loader_1 = require("./rules-loader");
+Object.defineProperty(exports, "loadRules", { enumerable: true, get: function () { return rules_loader_1.loadRules; } });
+Object.defineProperty(exports, "loadGuardConfig", { enumerable: true, get: function () { return rules_loader_1.loadGuardConfig; } });
+//# sourceMappingURL=index.js.map

package/dist/guard/index.js.map

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

package/dist/guard/provider.d.ts

@@ -0,0 +1,12 @@
+/**
+ * LLM provider abstraction for guard reviews.
+ * Supports Gemini (existing dep) and OpenAI-compatible APIs.
+ * Enforces structured JSON output — never parses free text.
+ */
+import type { GuardConfig, GuardRule, ReviewResponse, SymbolDiffUnit } from './types';
+/**
+ * Run the LLM review and return a validated response.
+ * Retries once on validation failure with a correction prompt.
+ */
+export declare function runLlmReview(config: GuardConfig, rules: GuardRule[], units: SymbolDiffUnit[]): Promise<ReviewResponse>;
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/guard/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAgJtF;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,cAAc,EAAE,GACtB,OAAO,CAAC,cAAc,CAAC,CAiDzB"}

package/dist/guard/provider.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * LLM provider abstraction for guard reviews.
+ * Supports Gemini (existing dep) and OpenAI-compatible APIs.
+ * Enforces structured JSON output — never parses free text.
+ */
+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.runLlmReview = runLlmReview;
+const schema_1 = require("./schema");
+/** Maximum number of retry attempts when LLM returns invalid JSON. */
+const MAX_RETRIES = 1;
+/**
+ * Build the system prompt for the guard review.
+ */
+function buildSystemPrompt(rules) {
+    const rulesText = rules
+        .map((r) => `- [${r.id}] (${r.severity}, fixable=${r.fixable}): ${r.description}`)
+        .join('\n');
+    return [
+        'You are a code review tool. Review the provided symbol-level diffs against the rules below.',
+        'For each violation found, output a structured JSON object matching the exact schema.',
+        '',
+        'Rules:',
+        rulesText,
+        '',
+        'Response format (strict JSON, no text before or after):',
+        '{',
+        '  "violations": [{ "rule_id": "...", "file": "...", "symbol": "...", "line_start": N, "line_end": N, "severity": "...", "confidence": 0.0-1.0, "fixable": bool, "message": "...", "suggested_fix": "..." }],',
+        '  "status": "pass" | "fail",',
+        '  "summary": "..."',
+        '}',
+        '',
+        'IMPORTANT:',
+        '- Only flag violations for rules listed above.',
+        '- The "fixable" field MUST match the rule definition — do not override it.',
+        '- "confidence" reflects how certain you are this is a real violation (0.0-1.0).',
+        '- "suggested_fix" is required only when fixable=true.',
+        '- If no violations found, return status "pass" with an empty violations array.',
+        '- Return ONLY the JSON object. No markdown, no explanation, no preamble.',
+    ].join('\n');
+}
+/**
+ * Build the user prompt with symbol diff units.
+ */
+function buildUserPrompt(units) {
+    const parts = ['Review these symbol-level changes:\n'];
+    for (const unit of units) {
+        parts.push(`--- ${unit.file} :: ${unit.symbol} (${unit.changeType}) ---`);
+        if (unit.oldSignature)
+            parts.push(`Old: ${unit.oldSignature}`);
+        if (unit.newSignature)
+            parts.push(`New: ${unit.newSignature}`);
+        if (unit.callers.length > 0)
+            parts.push(`Callers: ${unit.callers.join(', ')}`);
+        if (unit.callees.length > 0)
+            parts.push(`Callees: ${unit.callees.join(', ')}`);
+        parts.push('');
+        // Include a trimmed diff (first 100 lines to avoid token explosion)
+        const diffLines = unit.diffText.split('\n').slice(0, 100);
+        parts.push(diffLines.join('\n'));
+        parts.push('');
+    }
+    return parts.join('\n');
+}
+/**
+ * Extract JSON from a response that might have text before/after.
+ * This handles the exact failure mode from gga: providers prepending
+ * acknowledgment text before the actual JSON response.
+ */
+function extractJson(text) {
+    // Try to find a JSON object in the response
+    const firstBrace = text.indexOf('{');
+    const lastBrace = text.lastIndexOf('}');
+    if (firstBrace === -1 || lastBrace === -1 || lastBrace <= firstBrace) {
+        throw new Error('No JSON object found in response');
+    }
+    return text.slice(firstBrace, lastBrace + 1);
+}
+/**
+ * Call Gemini API with structured output enforcement.
+ */
+async function callGemini(config, systemPrompt, userPrompt) {
+    const { GoogleGenerativeAI } = await Promise.resolve().then(() => __importStar(require('@google/generative-ai')));
+    if (!config.apiKey) {
+        throw new Error('No API key. Set GEMINI_API_KEY or SKANNR_GUARD_API_KEY.');
+    }
+    const genAI = new GoogleGenerativeAI(config.apiKey);
+    const model = genAI.getGenerativeModel({
+        model: config.model,
+        generationConfig: {
+            responseMimeType: 'application/json',
+        },
+    });
+    const result = await model.generateContent({
+        contents: [{ role: 'user', parts: [{ text: userPrompt }] }],
+        systemInstruction: { role: 'system', parts: [{ text: systemPrompt }] },
+    });
+    return result.response.text();
+}
+/**
+ * Call OpenAI-compatible API with structured output enforcement.
+ */
+async function callOpenAI(config, systemPrompt, userPrompt) {
+    const baseUrl = config.baseUrl || 'https://api.openai.com/v1';
+    const url = `${baseUrl}/chat/completions`;
+    if (!config.apiKey) {
+        throw new Error('No API key. Set OPENAI_API_KEY or SKANNR_GUARD_API_KEY.');
+    }
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${config.apiKey}`,
+        },
+        body: JSON.stringify({
+            model: config.model,
+            messages: [
+                { role: 'system', content: systemPrompt },
+                { role: 'user', content: userPrompt },
+            ],
+            response_format: { type: 'json_object' },
+            temperature: 0.1,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`OpenAI API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    return data.choices?.[0]?.message?.content ?? '';
+}
+/**
+ * Run the LLM review and return a validated response.
+ * Retries once on validation failure with a correction prompt.
+ */
+async function runLlmReview(config, rules, units) {
+    const systemPrompt = buildSystemPrompt(rules);
+    const userPrompt = buildUserPrompt(units);
+    let lastError = null;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+        const prompt = attempt === 0
+            ? userPrompt
+            : `${userPrompt}\n\n[RETRY: Your last response didn't match the required schema. Error: ${lastError}. Return ONLY valid JSON matching the schema.]`;
+        let rawResponse;
+        try {
+            rawResponse = config.provider === 'openai'
+                ? await callOpenAI(config, systemPrompt, prompt)
+                : await callGemini(config, systemPrompt, prompt);
+        }
+        catch (err) {
+            throw new Error(`Provider call failed (${config.provider}): ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Extract and validate JSON
+        try {
+            const jsonStr = extractJson(rawResponse);
+            const parsed = JSON.parse(jsonStr);
+            const result = schema_1.ReviewResponseSchema.safeParse(parsed);
+            if (result.success) {
+                // Enforce: fixable field must match the rule definition
+                for (const violation of result.data.violations) {
+                    const rule = rules.find((r) => r.id === violation.rule_id);
+                    if (rule) {
+                        violation.fixable = rule.fixable;
+                    }
+                }
+                return result.data;
+            }
+            lastError = result.error.issues
+                .map((i) => `${i.path.join('.')}: ${i.message}`)
+                .join('; ');
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err.message : String(err);
+        }
+    }
+    // All retries exhausted
+    throw new Error(`LLM response failed schema validation after ${MAX_RETRIES + 1} attempts: ${lastError}`);
+}
+//# sourceMappingURL=provider.js.map

package/dist/guard/provider.js.map

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

package/dist/guard/review-runner.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Review runner — orchestrates the full guard pipeline:
+ * build symbol diffs → enrich with call context → batch → call LLM → validate.
+ */
+import type { GuardResult } from './types';
+export interface RunOptions {
+    /** Project root directory. */
+    root: string;
+    /** If provided, review this diff instead of staged files. */
+    diffContent?: string;
+    /** Skip cross-file caller/callee context (faster, cheaper). */
+    diffOnly?: boolean;
+    /** Skip symbol cache. */
+    noCache?: boolean;
+}
+/**
+ * Run the full guard review pipeline.
+ * Returns a GuardResult with violations, or throws with exit code 2 errors.
+ */
+export declare function runGuardReview(options: RunOptions): Promise<GuardResult>;
+//# sourceMappingURL=review-runner.d.ts.map

package/dist/guard/review-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-runner.d.ts","sourceRoot":"","sources":["../../src/guard/review-runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAkC,MAAM,SAAS,CAAC;AAK3E,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yBAAyB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAuE9E"}