@avinashchby/aireview 0.1.0

package/dist/reporters/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getReporter = getReporter;
+const text_reporter_js_1 = require("./text-reporter.js");
+const json_reporter_js_1 = require("./json-reporter.js");
+const ci_reporter_js_1 = require("./ci-reporter.js");
+/** Get the appropriate reporter based on format and CI mode. */
+function getReporter(format = 'text', ci = false) {
+    if (ci)
+        return ci_reporter_js_1.reportCi;
+    if (format === 'json')
+        return json_reporter_js_1.reportJson;
+    return text_reporter_js_1.reportText;
+}
+//# sourceMappingURL=index.js.map

package/dist/reporters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reporters/index.ts"],"names":[],"mappings":";;AASA,kCAOC;AAfD,yDAAgD;AAChD,yDAAgD;AAChD,qDAA4C;AAK5C,gEAAgE;AAChE,SAAgB,WAAW,CACzB,SAA0B,MAAM,EAChC,KAAc,KAAK;IAEnB,IAAI,EAAE;QAAE,OAAO,yBAAQ,CAAC;IACxB,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,6BAAU,CAAC;IACzC,OAAO,6BAAU,CAAC;AACpB,CAAC"}

package/dist/reporters/json-reporter.d.ts

@@ -0,0 +1,4 @@
+import type { ScanResult } from '../types.js';
+/** Output scan results as formatted JSON to stdout. */
+export declare function reportJson(result: ScanResult): void;
+//# sourceMappingURL=json-reporter.d.ts.map

package/dist/reporters/json-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-reporter.d.ts","sourceRoot":"","sources":["../../src/reporters/json-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAEnD"}

package/dist/reporters/json-reporter.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportJson = reportJson;
+/** Output scan results as formatted JSON to stdout. */
+function reportJson(result) {
+    console.log(JSON.stringify(result, null, 2));
+}
+//# sourceMappingURL=json-reporter.js.map

package/dist/reporters/json-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-reporter.js","sourceRoot":"","sources":["../../src/reporters/json-reporter.ts"],"names":[],"mappings":";;AAGA,gCAEC;AAHD,uDAAuD;AACvD,SAAgB,UAAU,CAAC,MAAkB;IAC3C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/reporters/text-reporter.d.ts

@@ -0,0 +1,4 @@
+import type { ScanResult } from '../types.js';
+/** Format and print scan results as pretty terminal output. */
+export declare function reportText(result: ScanResult): void;
+//# sourceMappingURL=text-reporter.d.ts.map

package/dist/reporters/text-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-reporter.d.ts","sourceRoot":"","sources":["../../src/reporters/text-reporter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAiC,MAAM,aAAa,CAAC;AAE7E,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAgBnD"}

package/dist/reporters/text-reporter.js

@@ -0,0 +1,110 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportText = reportText;
+const chalk_1 = __importDefault(require("chalk"));
+/** Format and print scan results as pretty terminal output. */
+function reportText(result) {
+    if (result.totalFindings === 0) {
+        console.log(chalk_1.default.green('\n  No issues found!\n'));
+        printSummary(result);
+        return;
+    }
+    for (const file of result.files) {
+        if (file.findings.length === 0)
+            continue;
+        printFileHeader(file);
+        for (const finding of file.findings) {
+            printFinding(finding);
+        }
+    }
+    printSummary(result);
+}
+/** Print the file header with path and confidence score. */
+function printFileHeader(file) {
+    const scoreColor = file.confidenceScore >= 80
+        ? chalk_1.default.green
+        : file.confidenceScore >= 50
+            ? chalk_1.default.yellow
+            : chalk_1.default.red;
+    console.log(`\n${chalk_1.default.underline(file.filePath)} ` +
+        `(confidence: ${scoreColor(`${file.confidenceScore}%`)})`);
+}
+/** Print a single finding with icon, location, and details. */
+function printFinding(f) {
+    const icon = getSeverityIcon(f.severity);
+    const loc = chalk_1.default.dim(`${f.line}:${f.column}`);
+    const ruleId = chalk_1.default.dim(`[${f.ruleId}]`);
+    console.log(`  ${icon} ${loc}  ${f.message}  ${ruleId}`);
+    printSnippet(f.snippet, f.line);
+    printExplanation(f.explanation);
+    printFix(f);
+}
+/** Get the severity icon string. */
+function getSeverityIcon(severity) {
+    switch (severity) {
+        case 'error': return chalk_1.default.red('\u2717');
+        case 'warning': return chalk_1.default.yellow('\u26A0');
+        case 'info': return chalk_1.default.blue('\u2139');
+    }
+}
+/** Print the code snippet with the offending line. */
+function printSnippet(snippet, _line) {
+    if (!snippet)
+        return;
+    const lines = snippet.split('\n');
+    for (const line of lines) {
+        console.log(chalk_1.default.dim(`    | ${line}`));
+    }
+}
+/** Print the explanation. */
+function printExplanation(explanation) {
+    if (!explanation)
+        return;
+    console.log(chalk_1.default.cyan(`    ${explanation}`));
+}
+/** Print the suggested fix if available. */
+function printFix(f) {
+    if (!f.fix)
+        return;
+    console.log(chalk_1.default.green(`    Fix: ${f.fix.description}`));
+    if (f.fix.replacement !== undefined) {
+        console.log(chalk_1.default.green(`    Replacement: ${f.fix.replacement}`));
+    }
+}
+/** Print the summary section. */
+function printSummary(result) {
+    console.log(chalk_1.default.dim('\n---'));
+    console.log(`Scanned ${chalk_1.default.bold(String(result.scannedFiles))} files in ` +
+        `${chalk_1.default.bold(String(result.duration))}ms`);
+    const parts = [];
+    if (result.errorCount > 0)
+        parts.push(chalk_1.default.red(`${result.errorCount} errors`));
+    if (result.warningCount > 0)
+        parts.push(chalk_1.default.yellow(`${result.warningCount} warnings`));
+    if (result.infoCount > 0)
+        parts.push(chalk_1.default.blue(`${result.infoCount} info`));
+    if (parts.length > 0) {
+        console.log(`Found ${parts.join(', ')}`);
+    }
+    printConfidenceScores(result);
+    console.log('');
+}
+/** Print per-file confidence scores. */
+function printConfidenceScores(result) {
+    const filesWithFindings = result.files.filter((f) => f.findings.length > 0);
+    if (filesWithFindings.length === 0)
+        return;
+    console.log(chalk_1.default.dim('\nConfidence scores:'));
+    for (const file of filesWithFindings) {
+        const scoreColor = file.confidenceScore >= 80
+            ? chalk_1.default.green
+            : file.confidenceScore >= 50
+                ? chalk_1.default.yellow
+                : chalk_1.default.red;
+        console.log(`  ${file.filePath}: ${scoreColor(`${file.confidenceScore}%`)}`);
+    }
+}
+//# sourceMappingURL=text-reporter.js.map

package/dist/reporters/text-reporter.js.map

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

package/dist/rules/confidence-patterns.d.ts

@@ -0,0 +1,4 @@
+import { Rule } from '../types.js';
+/** The confidence-patterns rule. */
+export declare const confidencePatternsRule: Rule;
+//# sourceMappingURL=confidence-patterns.d.ts.map

package/dist/rules/confidence-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence-patterns.d.ts","sourceRoot":"","sources":["../../src/rules/confidence-patterns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmC,MAAM,aAAa,CAAC;AA6PpE,oCAAoC;AACpC,eAAO,MAAM,sBAAsB,EAAE,IAgBpC,CAAC"}

package/dist/rules/confidence-patterns.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confidencePatternsRule = void 0;
+/** Variable names considered overly generic. */
+const GENERIC_NAMES = new Set([
+    'data', 'result', 'temp', 'tmp', 'item', 'thing',
+    'stuff', 'foo', 'bar', 'baz', 'test', 'value', 'obj', 'x',
+]);
+/** LLM hedging comment patterns. */
+const HEDGING_PATTERNS = [
+    /this\s+should\s+work/i,
+    /you\s+may\s+need\s+to/i,
+    /adjust\s+as\s+needed/i,
+    /modify\s+as\s+necessary/i,
+    /depending\s+on\s+your/i,
+    /replace\s+with\s+your/i,
+    /example\s+implementation/i,
+    /basic\s+implementation/i,
+    /simple\s+implementation/i,
+];
+/** Common magic number exceptions that should not be flagged. */
+const ALLOWED_NUMBERS = new Set([
+    0, 1, 2, 10, 100, 1000, 0.5, -1,
+]);
+/** Create a finding for confidence-patterns. */
+function makeFinding(line, column, snippet, message, explanation, severity, filePath) {
+    return {
+        ruleId: 'confidence-patterns',
+        category: 'confidence-patterns',
+        severity,
+        message,
+        filePath,
+        line,
+        column,
+        snippet,
+        explanation,
+    };
+}
+/**
+ * Check for functions where ALL parameter names are generic.
+ * Skip lambdas / short functions (1-line arrow functions).
+ */
+function checkGenericNames(parserResult, filePath) {
+    const findings = [];
+    for (const fn of parserResult.functionDecls) {
+        if (fn.params.length === 0)
+            continue;
+        // Skip short lambdas (body <= 1 line)
+        if (fn.bodyLineCount <= 1)
+            continue;
+        const allGeneric = fn.params.every((p) => GENERIC_NAMES.has(p));
+        if (allGeneric && fn.params.length > 0) {
+            findings.push(makeFinding(fn.line, 1, `function ${fn.name}(${fn.params.join(', ')})`, `All parameters in '${fn.name}' use generic names: ${fn.params.join(', ')}`, 'Use descriptive parameter names that convey purpose.', 'info', filePath));
+        }
+    }
+    return findings;
+}
+/** Check comments for LLM hedging language. */
+function checkHedgingComments(parserResult, filePath) {
+    const findings = [];
+    for (const comment of parserResult.comments) {
+        for (const pattern of HEDGING_PATTERNS) {
+            if (pattern.test(comment.text)) {
+                findings.push(makeFinding(comment.line, comment.column, comment.text, `Hedging comment: "${extractMatch(comment.text, pattern)}"`, 'LLM-generated code often includes hedging language. Review and verify the implementation.', 'warning', filePath));
+                break; // One finding per comment
+            }
+        }
+    }
+    return findings;
+}
+/** Extract the matched portion of text. */
+function extractMatch(text, pattern) {
+    const match = pattern.exec(text);
+    return match ? match[0] : text.slice(0, 40);
+}
+/** Check for inconsistent quote styles in string literals. */
+function checkQuoteConsistency(parserResult, filePath) {
+    const literals = parserResult.stringLiterals;
+    if (literals.length < 4)
+        return []; // Not enough to judge
+    let singles = 0;
+    let doubles = 0;
+    for (const lit of literals) {
+        if (lit.quoteStyle === 'single')
+            singles++;
+        else if (lit.quoteStyle === 'double')
+            doubles++;
+        // backticks excluded from consistency check
+    }
+    const total = singles + doubles;
+    if (total === 0)
+        return [];
+    const singlePct = singles / total;
+    const doublePct = doubles / total;
+    // Flag if neither dominates > 70%
+    if (singlePct <= 0.7 && doublePct <= 0.7 && total >= 4) {
+        return [makeFinding(1, 1, `${singles} single-quoted, ${doubles} double-quoted`, `Inconsistent quote style: ${singles} single vs ${doubles} double quotes`, 'Mixed quote styles may indicate code from multiple sources. Standardize on one style.', 'info', filePath)];
+    }
+    return [];
+}
+/** Check for 3+ identical catch block bodies. */
+function checkIdenticalCatchBlocks(parserResult, filePath) {
+    const catchBodies = new Map();
+    for (const cb of parserResult.catchBlocks) {
+        const bodyKey = extractCatchBody(parserResult.lines, cb.line, cb.endLine);
+        if (!bodyKey)
+            continue;
+        const lines = catchBodies.get(bodyKey) ?? [];
+        lines.push(cb.line);
+        catchBodies.set(bodyKey, lines);
+    }
+    const findings = [];
+    for (const [body, lines] of catchBodies) {
+        if (lines.length >= 3) {
+            findings.push(makeFinding(lines[0], 1, body.slice(0, 80), `${lines.length} identical catch blocks found (lines: ${lines.join(', ')})`, 'Identical catch blocks suggest copy-pasted error handling. Consider a shared error handler.', 'warning', filePath));
+        }
+    }
+    return findings;
+}
+/** Extract the body text of a catch block from source lines. */
+function extractCatchBody(lines, startLine, endLine) {
+    const bodyLines = [];
+    for (let i = startLine; i <= Math.min(endLine, lines.length); i++) {
+        const line = lines[i - 1];
+        if (line !== undefined)
+            bodyLines.push(line.trim());
+    }
+    return bodyLines.join('\n');
+}
+/** Check for magic numbers in source lines. */
+function checkMagicNumbers(parserResult, filePath) {
+    const findings = [];
+    const magicPattern = /(?<!\w)(-?\d+\.?\d*(?:e[+-]?\d+)?)(?!\w)/gi;
+    for (let i = 0; i < parserResult.lines.length; i++) {
+        const line = parserResult.lines[i];
+        const trimmed = line.trim();
+        const lineNum = i + 1;
+        // Skip comments, imports, and common declarations
+        if (isSkippableLine(trimmed))
+            continue;
+        checkLineForMagicNumbers(trimmed, lineNum, magicPattern, filePath, findings);
+    }
+    return findings;
+}
+/** Determine if a line should be skipped for magic number checks. */
+function isSkippableLine(trimmed) {
+    return (trimmed.startsWith('//') ||
+        trimmed.startsWith('#') ||
+        trimmed.startsWith('*') ||
+        trimmed.startsWith('import ') ||
+        trimmed.startsWith('from ') ||
+        trimmed.startsWith('const ') && trimmed.includes('=') && !trimmed.includes('(') ||
+        /^\s*export\s/.test(trimmed) ||
+        trimmed === '');
+}
+/** Check a single line for magic numbers. */
+function checkLineForMagicNumbers(trimmed, lineNum, pattern, filePath, findings) {
+    pattern.lastIndex = 0;
+    let match;
+    const seen = new Set();
+    while ((match = pattern.exec(trimmed)) !== null) {
+        const num = parseFloat(match[1]);
+        if (isNaN(num) || ALLOWED_NUMBERS.has(num) || seen.has(num))
+            continue;
+        seen.add(num);
+        findings.push(makeFinding(lineNum, match.index + 1, trimmed, `Magic number ${num} — consider extracting to a named constant`, 'Unexplained numeric literals reduce code readability.', 'info', filePath));
+    }
+}
+/** The confidence-patterns rule. */
+exports.confidencePatternsRule = {
+    id: 'confidence-patterns',
+    category: 'confidence-patterns',
+    severity: 'info',
+    languages: ['javascript', 'typescript', 'python'],
+    description: 'Detect patterns suggesting low-confidence LLM-generated code.',
+    check(parserResult, filePath) {
+        const findings = [];
+        findings.push(...checkGenericNames(parserResult, filePath));
+        findings.push(...checkHedgingComments(parserResult, filePath));
+        findings.push(...checkQuoteConsistency(parserResult, filePath));
+        findings.push(...checkIdenticalCatchBlocks(parserResult, filePath));
+        findings.push(...checkMagicNumbers(parserResult, filePath));
+        return findings;
+    },
+};
+//# sourceMappingURL=confidence-patterns.js.map

package/dist/rules/confidence-patterns.js.map

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

package/dist/rules/engine.d.ts

@@ -0,0 +1,19 @@
+import { Rule, Finding, ParserResult, Severity } from '../types.js';
+/**
+ * Run all applicable rules against parsed source and collect findings.
+ * Only runs rules whose languages array includes the file's language.
+ * Returns findings sorted by line number ascending.
+ */
+export declare function runRules(rules: Rule[], parserResult: ParserResult, filePath: string): Finding[];
+/**
+ * Filter out findings below the minimum severity threshold.
+ * Severity ordering: error > warning > info.
+ */
+export declare function filterBySeverity(findings: Finding[], minSeverity: Severity): Finding[];
+/**
+ * Compute a confidence score for a file based on its findings.
+ * Score ranges from 0 (low confidence) to 100 (high confidence).
+ * Formula: max(0, round(100 - (errors*5 + warnings*2 + infos*0.5) / max(lineCount,1) * 100))
+ */
+export declare function computeConfidenceScore(findings: Finding[], lineCount: number): number;
+//# sourceMappingURL=engine.d.ts.map

package/dist/rules/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/rules/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AASpE;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,IAAI,EAAE,EACb,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,EAAE,CAYX;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EAAE,EACnB,WAAW,EAAE,QAAQ,GACpB,OAAO,EAAE,CAGX;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAcR"}

package/dist/rules/engine.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runRules = runRules;
+exports.filterBySeverity = filterBySeverity;
+exports.computeConfidenceScore = computeConfidenceScore;
+/** Severity weight ordering: higher index = more severe. */
+const SEVERITY_ORDER = {
+    info: 0,
+    warning: 1,
+    error: 2,
+};
+/**
+ * Run all applicable rules against parsed source and collect findings.
+ * Only runs rules whose languages array includes the file's language.
+ * Returns findings sorted by line number ascending.
+ */
+function runRules(rules, parserResult, filePath) {
+    const language = parserResult.language;
+    const findings = [];
+    for (const rule of rules) {
+        if (!rule.languages.includes(language))
+            continue;
+        const ruleFindings = rule.check(parserResult, filePath);
+        findings.push(...ruleFindings);
+    }
+    findings.sort((a, b) => a.line - b.line);
+    return findings;
+}
+/**
+ * Filter out findings below the minimum severity threshold.
+ * Severity ordering: error > warning > info.
+ */
+function filterBySeverity(findings, minSeverity) {
+    const minLevel = SEVERITY_ORDER[minSeverity];
+    return findings.filter((f) => SEVERITY_ORDER[f.severity] >= minLevel);
+}
+/**
+ * Compute a confidence score for a file based on its findings.
+ * Score ranges from 0 (low confidence) to 100 (high confidence).
+ * Formula: max(0, round(100 - (errors*5 + warnings*2 + infos*0.5) / max(lineCount,1) * 100))
+ */
+function computeConfidenceScore(findings, lineCount) {
+    let errors = 0;
+    let warnings = 0;
+    let infos = 0;
+    for (const f of findings) {
+        if (f.severity === 'error')
+            errors++;
+        else if (f.severity === 'warning')
+            warnings++;
+        else
+            infos++;
+    }
+    const penalty = errors * 5 + warnings * 2 + infos * 0.5;
+    const denominator = Math.max(lineCount, 1);
+    return Math.max(0, Math.round(100 - (penalty / denominator) * 100));
+}
+//# sourceMappingURL=engine.js.map

package/dist/rules/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/rules/engine.ts"],"names":[],"mappings":";;AAcA,4BAgBC;AAMD,4CAMC;AAOD,wDAiBC;AAhED,4DAA4D;AAC5D,MAAM,cAAc,GAA6B;IAC/C,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;CACT,CAAC;AAEF;;;;GAIG;AACH,SAAgB,QAAQ,CACtB,KAAa,EACb,YAA0B,EAC1B,QAAgB;IAEhB,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;IACvC,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,SAAS;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACxD,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;IACjC,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAC9B,QAAmB,EACnB,WAAqB;IAErB,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC7C,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CACpC,QAAmB,EACnB,SAAiB;IAEjB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;YAAE,MAAM,EAAE,CAAC;aAChC,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;YAAE,QAAQ,EAAE,CAAC;;YACzC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,QAAQ,GAAG,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC;IACxD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/rules/error-handling.d.ts

@@ -0,0 +1,4 @@
+import { Rule } from '../types.js';
+/** Rule detecting error handling anti-patterns across languages. */
+export declare const errorHandlingRule: Rule;
+//# sourceMappingURL=error-handling.d.ts.map

package/dist/rules/error-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handling.d.ts","sourceRoot":"","sources":["../../src/rules/error-handling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAyB,MAAM,aAAa,CAAC;AAyN1D,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,EAAE,IAO/B,CAAC"}

package/dist/rules/error-handling.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorHandlingRule = void 0;
+const RULE_ID = 'error-handling';
+const CATEGORY = 'error-handling';
+/** Build a finding with standard fields pre-filled. */
+function makeFinding(filePath, line, snippet, severity, message, explanation) {
+    return {
+        ruleId: RULE_ID,
+        category: CATEGORY,
+        severity,
+        message,
+        filePath,
+        line,
+        column: 0,
+        snippet,
+        explanation,
+    };
+}
+/** Detect empty catch blocks and catch-only-logs from AST data. */
+function detectCatchBlockIssues(pr, filePath) {
+    const findings = [];
+    for (const cb of pr.catchBlocks) {
+        const snippet = pr.lines[cb.line - 1] ?? '';
+        if (cb.isEmpty) {
+            findings.push(makeFinding(filePath, cb.line, snippet, 'error', 'Empty catch block silently swallows errors', 'Empty catch blocks hide failures, making bugs impossible to diagnose. ' +
+                'At minimum, log the error. Ideally, re-throw, return an error result, or handle specifically.'));
+        }
+        else if (cb.onlyLogs) {
+            findings.push(makeFinding(filePath, cb.line, snippet, 'warning', 'Catch block only logs the error without handling it', 'Logging alone does not recover from the error. The caller may assume success. ' +
+                'Re-throw the error, return a failure result, or implement specific recovery logic.'));
+        }
+    }
+    return findings;
+}
+/** Detect bare except: in Python (no exception type specified). */
+function detectBareExcept(pr, filePath) {
+    if (pr.language !== 'python')
+        return [];
+    const findings = [];
+    for (let i = 0; i < pr.lines.length; i++) {
+        const line = pr.lines[i];
+        if (/^\s*except\s*:/.test(line)) {
+            findings.push(makeFinding(filePath, i + 1, line, 'warning', 'Bare `except:` catches all exceptions including SystemExit and KeyboardInterrupt', 'Use `except Exception:` to catch only standard errors, or catch specific ' +
+                'exception types for targeted error handling.'));
+        }
+    }
+    return findings;
+}
+/** Detect swallowed promise rejections: .catch(() => {}) or .catch(() => null). */
+function detectSwallowedPromises(pr, filePath) {
+    if (pr.language === 'python')
+        return [];
+    const findings = [];
+    for (let i = 0; i < pr.lines.length; i++) {
+        const line = pr.lines[i];
+        if (/\.catch\(\s*\(\s*\)\s*=>\s*\{\s*\}\s*\)/.test(line) ||
+            /\.catch\(\s*\(\s*\w*\s*\)\s*=>\s*\{\s*\}\s*\)/.test(line) ||
+            /\.catch\(\s*\(\s*\)\s*=>\s*null\s*\)/.test(line)) {
+            findings.push(makeFinding(filePath, i + 1, line, 'error', 'Promise rejection is silently swallowed', 'Empty .catch() handlers hide async errors. Handle the error, re-throw it, ' +
+                'or use a logging handler that also propagates the failure.'));
+        }
+    }
+    return findings;
+}
+/** Detect catch blocks that return null/undefined (error swallowing). */
+function detectCatchReturnNull(pr, filePath) {
+    if (pr.language === 'python')
+        return [];
+    const findings = [];
+    for (let i = 0; i < pr.lines.length; i++) {
+        const line = pr.lines[i];
+        if (/catch\s*\(\s*\w+\s*\)\s*\{\s*return\s+(null|undefined)\s*;?\s*\}/.test(line)) {
+            findings.push(makeFinding(filePath, i + 1, line, 'warning', 'Catch block swallows error by returning null/undefined', 'Returning null from a catch block hides the error from the caller. Return a ' +
+                'Result/Either type, throw a domain error, or use a sentinel that callers can check.'));
+        }
+    }
+    return findings;
+}
+/** Detect .then() without a corresponding .catch(). */
+function detectMissingCatch(pr, filePath) {
+    if (pr.language === 'python')
+        return [];
+    const findings = [];
+    for (let i = 0; i < pr.lines.length; i++) {
+        const line = pr.lines[i];
+        if (/\.then\s*\(/.test(line) && !/\.catch\s*\(/.test(line)) {
+            const nextLine = pr.lines[i + 1] ?? '';
+            if (!/\.catch\s*\(/.test(nextLine)) {
+                findings.push(makeFinding(filePath, i + 1, line, 'info', 'Promise chain may be missing .catch() handler', 'Unhandled promise rejections crash Node.js and cause silent failures in browsers. ' +
+                    'Add .catch() or use async/await with try/catch. Note: this may be a false positive ' +
+                    'if the promise is awaited or handled elsewhere.'));
+            }
+        }
+    }
+    return findings;
+}
+/** Detect process.exit() without a preceding error log. */
+function detectProcessExit(pr, filePath) {
+    if (pr.language === 'python')
+        return [];
+    const findings = [];
+    for (let i = 0; i < pr.lines.length; i++) {
+        if (/process\.exit\s*\(\s*[01]\s*\)/.test(pr.lines[i])) {
+            const prevLine = i > 0 ? pr.lines[i - 1] : '';
+            const hasLog = /console\.(error|warn|log)|logger\.(error|warn)/.test(prevLine);
+            if (!hasLog) {
+                findings.push(makeFinding(filePath, i + 1, pr.lines[i], 'info', 'process.exit() called without a preceding error log', 'Calling process.exit() without logging makes it hard to diagnose why the process ' +
+                    'terminated. Log an error message before exiting, or throw an error and let the ' +
+                    'top-level handler manage shutdown.'));
+            }
+        }
+    }
+    return findings;
+}
+/** Max lines for a reasonable try block. */
+const MAX_TRY_LINES = 50;
+/** Detect overly large try blocks by estimating from catch positions. */
+function detectLargeTryBlocks(pr, filePath) {
+    const findings = [];
+    for (const cb of pr.catchBlocks) {
+        const catchLine = cb.line;
+        let tryLine = -1;
+        for (let i = catchLine - 2; i >= 0; i--) {
+            if (/\btry\s*\{/.test(pr.lines[i]) || /^\s*try\s*:/.test(pr.lines[i])) {
+                tryLine = i + 1;
+                break;
+            }
+        }
+        if (tryLine > 0) {
+            const blockSize = catchLine - tryLine;
+            if (blockSize > MAX_TRY_LINES) {
+                findings.push(makeFinding(filePath, tryLine, pr.lines[tryLine - 1] ?? '', 'info', `Try block is ${blockSize} lines long (>${MAX_TRY_LINES})`, 'Large try blocks make it unclear which operation might fail and catch ' +
+                    'unrelated errors. Extract smaller operations and wrap only the specific ' +
+                    'call that can throw.'));
+            }
+        }
+    }
+    return findings;
+}
+/** Main check: runs all sub-detectors and merges results. */
+function check(parserResult, filePath) {
+    return [
+        ...detectCatchBlockIssues(parserResult, filePath),
+        ...detectBareExcept(parserResult, filePath),
+        ...detectSwallowedPromises(parserResult, filePath),
+        ...detectCatchReturnNull(parserResult, filePath),
+        ...detectMissingCatch(parserResult, filePath),
+        ...detectProcessExit(parserResult, filePath),
+        ...detectLargeTryBlocks(parserResult, filePath),
+    ];
+}
+/** Rule detecting error handling anti-patterns across languages. */
+exports.errorHandlingRule = {
+    id: RULE_ID,
+    category: CATEGORY,
+    severity: 'error',
+    languages: ['javascript', 'typescript', 'python'],
+    description: 'Detects error handling anti-patterns including empty catches, swallowed errors, and missing handlers',
+    check,
+};
+//# sourceMappingURL=error-handling.js.map