@oculum/scanner 1.0.11 → 1.0.13

package/dist/detect/structural/xxe-detection.js

@@ -0,0 +1,245 @@
+"use strict";
+/**
+ * Layer 2: XXE (XML External Entity) Detector
+ * Detects XML parsing without entity expansion protection
+ *
+ * OWASP A02:2021 - Cryptographic Failures (was A04 in 2017)
+ * CWE-611: Improper Restriction of XML External Entity Reference
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectXXEPatterns = detectXXEPatterns;
+const file_classifier_1 = require("../../parse/file-classifier");
+const BASE_CONFIDENCE = 0.55;
+const XXE_PATTERNS = [
+    // ==================== Node.js ====================
+    {
+        pattern: /xml2js\.parseString|new\s+xml2js\.Parser/,
+        lang: 'node',
+        lib: 'xml2js',
+        safe: /explicitCharkey|xmlMode/,
+        severity: 'medium', // xml2js v0.5+ doesn't expand entities by default
+        extensions: ['.js', '.ts', '.mjs', '.cjs', '.jsx', '.tsx'],
+    },
+    {
+        pattern: /libxmljs\.parseXml/,
+        lang: 'node',
+        lib: 'libxmljs',
+        safe: /noent\s*:\s*false/,
+        severity: 'high',
+        extensions: ['.js', '.ts', '.mjs', '.cjs'],
+    },
+    {
+        pattern: /new\s+DOMParser\(\)\.parseFromString/,
+        lang: 'node',
+        lib: 'DOMParser',
+        severity: 'low', // Browsers block XXE by default
+        extensions: ['.js', '.ts', '.jsx', '.tsx'],
+    },
+    {
+        pattern: /(?:xmldom|@xmldom\/xmldom)/,
+        lang: 'node',
+        lib: 'xmldom',
+        safe: /entityExpansionEnabled\s*:\s*false/,
+        severity: 'medium',
+        extensions: ['.js', '.ts', '.mjs', '.cjs'],
+    },
+    {
+        pattern: /(?:fast-xml-parser|XMLParser)/,
+        lang: 'node',
+        lib: 'fast-xml-parser',
+        safe: /processEntities\s*:\s*false/,
+        severity: 'medium',
+        extensions: ['.js', '.ts', '.mjs', '.cjs'],
+    },
+    // ==================== Python ====================
+    {
+        pattern: /xml\.etree\.ElementTree\.parse|ET\.parse|etree\.parse/,
+        lang: 'python',
+        lib: 'xml.etree.ElementTree',
+        safe: /defusedxml/,
+        severity: 'high',
+        extensions: ['.py'],
+    },
+    {
+        pattern: /lxml\.etree\.parse|etree\.fromstring/,
+        lang: 'python',
+        lib: 'lxml.etree',
+        safe: /resolve_entities\s*=\s*False|defusedxml/,
+        severity: 'high',
+        extensions: ['.py'],
+    },
+    {
+        pattern: /xml\.sax\.parse|xml\.dom\.minidom\.parse/,
+        lang: 'python',
+        lib: 'xml.sax/minidom',
+        safe: /defusedxml/,
+        severity: 'high',
+        extensions: ['.py'],
+    },
+    {
+        pattern: /xml\.dom\.pulldom/,
+        lang: 'python',
+        lib: 'xml.dom.pulldom',
+        safe: /defusedxml/,
+        severity: 'high',
+        extensions: ['.py'],
+    },
+    // ==================== Java ====================
+    {
+        pattern: /DocumentBuilderFactory\.newInstance/,
+        lang: 'java',
+        lib: 'DocumentBuilderFactory',
+        safe: /disallow-doctype-decl|FEATURE_SECURE_PROCESSING/,
+        severity: 'high',
+        extensions: ['.java'],
+    },
+    {
+        pattern: /SAXParserFactory\.newInstance/,
+        lang: 'java',
+        lib: 'SAXParserFactory',
+        safe: /disallow-doctype-decl|external-general-entities/,
+        severity: 'high',
+        extensions: ['.java'],
+    },
+    {
+        pattern: /XMLInputFactory\.newInstance/,
+        lang: 'java',
+        lib: 'XMLInputFactory',
+        safe: /IS_SUPPORTING_EXTERNAL_ENTITIES|SUPPORT_DTD/,
+        severity: 'high',
+        extensions: ['.java'],
+    },
+    {
+        pattern: /TransformerFactory\.newInstance/,
+        lang: 'java',
+        lib: 'TransformerFactory',
+        safe: /ACCESS_EXTERNAL_DTD|ACCESS_EXTERNAL_STYLESHEET/,
+        severity: 'high',
+        extensions: ['.java'],
+    },
+    // ==================== PHP ====================
+    {
+        pattern: /simplexml_load_string|simplexml_load_file/,
+        lang: 'php',
+        lib: 'simplexml',
+        safe: /libxml_disable_entity_loader\s*\(\s*true\s*\)|LIBXML_NOENT/,
+        severity: 'high',
+        extensions: ['.php'],
+    },
+    {
+        pattern: /DOMDocument.*(?:loadXML|load)\b/,
+        lang: 'php',
+        lib: 'DOMDocument',
+        safe: /libxml_disable_entity_loader\s*\(\s*true\s*\)/,
+        severity: 'high',
+        extensions: ['.php'],
+    },
+    {
+        pattern: /XMLReader.*open/,
+        lang: 'php',
+        lib: 'XMLReader',
+        safe: /setParserProperty.*LOADDTD.*false/,
+        severity: 'high',
+        extensions: ['.php'],
+    },
+];
+/**
+ * Check if the file extension matches the expected language
+ */
+function matchesLanguageExtension(filePath, extensions) {
+    if (!extensions)
+        return true;
+    return extensions.some(ext => filePath.endsWith(ext));
+}
+/**
+ * Check surrounding context for safe configuration
+ */
+function hasSafeConfig(content, lines, lineIndex, safePattern, lang) {
+    if (!safePattern)
+        return false;
+    // For Python: check entire file for defusedxml import
+    if (lang === 'python' && /defusedxml/.test(safePattern.source)) {
+        if (/import\s+defusedxml|from\s+defusedxml/.test(content)) {
+            return true;
+        }
+    }
+    // Check surrounding context (±20 lines for Java setFeature, ±10 for others)
+    const windowSize = lang === 'java' ? 20 : 10;
+    const start = Math.max(0, lineIndex - windowSize);
+    const end = Math.min(lines.length, lineIndex + windowSize + 1);
+    const context = lines.slice(start, end).join('\n');
+    return safePattern.test(context);
+}
+/**
+ * Detect XXE patterns in code
+ */
+function detectXXEPatterns(content, filePath, options) {
+    const vulnerabilities = [];
+    if ((0, file_classifier_1.isScannerOrFixtureFile)(filePath))
+        return vulnerabilities;
+    const isTestFile = (0, file_classifier_1.isTestOrMockFile)(filePath);
+    const lines = options?.parsed?.lines ?? content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if ((0, file_classifier_1.isComment)(line))
+            continue;
+        for (const xxePattern of XXE_PATTERNS) {
+            // Check language extension match
+            if (!matchesLanguageExtension(filePath, xxePattern.extensions))
+                continue;
+            if (!xxePattern.pattern.test(line))
+                continue;
+            // Check for safe configuration
+            if (hasSafeConfig(content, lines, i, xxePattern.safe, xxePattern.lang))
+                continue;
+            let severity = xxePattern.severity || 'high';
+            // Downgrade for test files
+            if (isTestFile) {
+                severity = 'info';
+            }
+            // DOMParser in .tsx client files is inherently safe
+            if (xxePattern.lib === 'DOMParser' && (filePath.endsWith('.tsx') || filePath.endsWith('.jsx'))) {
+                severity = 'info';
+            }
+            vulnerabilities.push({
+                id: `xxe-${filePath}-${i + 1}-${xxePattern.lib}`,
+                filePath,
+                lineNumber: i + 1,
+                lineContent: line.trim(),
+                severity,
+                category: 'xxe',
+                title: `XXE risk: ${xxePattern.lib} XML parser without entity protection`,
+                description: `${xxePattern.lib} XML parser is used without disabling external entity processing. An attacker could supply malicious XML to read server files, perform SSRF, or cause denial-of-service.`,
+                suggestedFix: getSuggestedFix(xxePattern.lang, xxePattern.lib),
+                confidence: severity === 'high' ? 'high' : 'medium',
+                baseConfidence: BASE_CONFIDENCE,
+                layer: 2,
+                source: 'structural',
+                requiresAIValidation: severity !== 'high',
+            });
+            break; // One finding per line
+        }
+    }
+    return vulnerabilities;
+}
+function getSuggestedFix(lang, lib) {
+    switch (lang) {
+        case 'python':
+            return 'Use defusedxml instead of the standard xml library: pip install defusedxml && from defusedxml.ElementTree import parse';
+        case 'java':
+            return 'Disable external entities: factory.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true)';
+        case 'php':
+            return 'Disable entity loading: libxml_disable_entity_loader(true) before parsing XML';
+        case 'node':
+            if (lib === 'fast-xml-parser') {
+                return 'Disable entity processing: new XMLParser({ processEntities: false })';
+            }
+            if (lib === 'xml2js') {
+                return 'Consider upgrading to xml2js v0.5+ which has safer defaults, or use fast-xml-parser with processEntities: false';
+            }
+            return 'Disable external entity processing in the XML parser configuration';
+        default:
+            return 'Disable external entity processing in the XML parser configuration';
+    }
+}
+//# sourceMappingURL=xxe-detection.js.map

package/dist/detect/structural/xxe-detection.js.map

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

package/dist/filtering/context-adjustments.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Centralized Context-Based Severity Adjustments
+ *
+ * Consolidates the duplicate filter logic from:
+ * - layer2/index.ts applyFileContextAdjustments() — per-file with full FileContext
+ * - index.ts applyGlobalContextAdjustments() — post-layers with tooling-dir only
+ *
+ * Both functions are replaced by a single applyContextAdjustments() that handles
+ * all context-based severity downgrades in one place.
+ */
+import type { Vulnerability } from '../types';
+import type { FileContext } from '../utils/context-helpers';
+/**
+ * Apply context-based severity adjustments to findings.
+ *
+ * When called with a FileContext (from Layer 2 per-file processing), applies
+ * full context-aware rules: test files, tooling dirs, server-only files.
+ *
+ * When called without a FileContext (from the orchestrator for Layer 1 findings),
+ * applies only tooling-directory downgrades based on file path.
+ */
+export declare function applyContextAdjustments(findings: Vulnerability[], fileContext?: FileContext): Vulnerability[];
+//# sourceMappingURL=context-adjustments.d.ts.map

package/dist/filtering/context-adjustments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-adjustments.d.ts","sourceRoot":"","sources":["../../src/filtering/context-adjustments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAmB3D;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,EAAE,EACzB,WAAW,CAAC,EAAE,WAAW,GACxB,aAAa,EAAE,CA2DjB"}

package/dist/filtering/context-adjustments.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * Centralized Context-Based Severity Adjustments
+ *
+ * Consolidates the duplicate filter logic from:
+ * - layer2/index.ts applyFileContextAdjustments() — per-file with full FileContext
+ * - index.ts applyGlobalContextAdjustments() — post-layers with tooling-dir only
+ *
+ * Both functions are replaced by a single applyContextAdjustments() that handles
+ * all context-based severity downgrades in one place.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyContextAdjustments = applyContextAdjustments;
+/** Categories that are expected and not risky in tooling directories */
+const TOOLING_DOWNGRADABLE_CATEGORIES = [
+    'dangerous_function', // exec, spawn, etc. are expected in scripts
+    'command_injection', // child_process usage is expected in build scripts
+    'weak_crypto', // Math.random() for seeding is fine in scripts
+    'data_exposure', // Logging is expected in tooling
+    'ai_pattern', // AI patterns in scripts are typically fine
+];
+/** Categories that are expected and not risky in test files */
+const TEST_DOWNGRADABLE_CATEGORIES = [
+    'ai_pattern',
+    'dangerous_function',
+    'sensitive_variable',
+    'data_exposure',
+];
+/**
+ * Apply context-based severity adjustments to findings.
+ *
+ * When called with a FileContext (from Layer 2 per-file processing), applies
+ * full context-aware rules: test files, tooling dirs, server-only files.
+ *
+ * When called without a FileContext (from the orchestrator for Layer 1 findings),
+ * applies only tooling-directory downgrades based on file path.
+ */
+function applyContextAdjustments(findings, fileContext) {
+    return findings.map(finding => {
+        // Never downgrade critical findings
+        if (finding.severity === 'critical') {
+            return finding;
+        }
+        if (fileContext) {
+            // Full per-file context available (Layer 2 path)
+            // Test files: Downgrade specific categories
+            if (fileContext.isTestFile) {
+                if (TEST_DOWNGRADABLE_CATEGORIES.includes(finding.category)) {
+                    return {
+                        ...finding,
+                        severity: 'info',
+                        validationNotes: 'Downgraded: test/fixture file',
+                    };
+                }
+            }
+            // Tooling directories: Downgrade expected patterns
+            if (fileContext.isToolingDir) {
+                if (TOOLING_DOWNGRADABLE_CATEGORIES.includes(finding.category)) {
+                    return {
+                        ...finding,
+                        severity: 'info',
+                        validationNotes: 'Downgraded: tooling/scripts directory',
+                    };
+                }
+            }
+            // Server-only files: Client-exposure concerns don't apply
+            if (fileContext.isServerOnly) {
+                if (finding.category === 'hardcoded_secret' &&
+                    finding.title.toLowerCase().includes('service role')) {
+                    return {
+                        ...finding,
+                        severity: 'info',
+                        validationNotes: 'Downgraded: server-only file (service role key expected)',
+                    };
+                }
+            }
+        }
+        else {
+            // No file context — apply path-based adjustments only (orchestrator path)
+            // This catches Layer 1 findings that didn't go through Layer 2's per-file adjustments
+            const inToolingDir = isToolingPath(finding.filePath);
+            if (inToolingDir && TOOLING_DOWNGRADABLE_CATEGORIES.includes(finding.category)) {
+                return {
+                    ...finding,
+                    severity: 'info',
+                    validationNotes: `${finding.validationNotes || ''} Downgraded: tooling/scripts directory`.trim(),
+                };
+            }
+        }
+        return finding;
+    });
+}
+/**
+ * Tooling-path check for findings without FileContext.
+ * Uses the same regex as utils/context-helpers.ts isToolingDirectory().
+ */
+function isToolingPath(filePath) {
+    return /\/(scripts?|cli|tools?|bin|devtools|build|tasks)\//i.test(filePath);
+}
+//# sourceMappingURL=context-adjustments.js.map

package/dist/filtering/context-adjustments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-adjustments.js","sourceRoot":"","sources":["../../src/filtering/context-adjustments.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AA+BH,0DA8DC;AAxFD,wEAAwE;AACxE,MAAM,+BAA+B,GAAG;IACtC,oBAAoB,EAAI,4CAA4C;IACpE,mBAAmB,EAAK,mDAAmD;IAC3E,aAAa,EAAW,+CAA+C;IACvE,eAAe,EAAS,iCAAiC;IACzD,YAAY,EAAY,4CAA4C;CACrE,CAAA;AAED,+DAA+D;AAC/D,MAAM,4BAA4B,GAAG;IACnC,YAAY;IACZ,oBAAoB;IACpB,oBAAoB;IACpB,eAAe;CAChB,CAAA;AAED;;;;;;;;GAQG;AACH,SAAgB,uBAAuB,CACrC,QAAyB,EACzB,WAAyB;IAEzB,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QAC5B,oCAAoC;QACpC,IAAI,OAAO,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;YACpC,OAAO,OAAO,CAAA;QAChB,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,iDAAiD;YAEjD,4CAA4C;YAC5C,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;gBAC3B,IAAI,4BAA4B,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC5D,OAAO;wBACL,GAAG,OAAO;wBACV,QAAQ,EAAE,MAAe;wBACzB,eAAe,EAAE,+BAA+B;qBACjD,CAAA;gBACH,CAAC;YACH,CAAC;YAED,mDAAmD;YACnD,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;gBAC7B,IAAI,+BAA+B,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC/D,OAAO;wBACL,GAAG,OAAO;wBACV,QAAQ,EAAE,MAAe;wBACzB,eAAe,EAAE,uCAAuC;qBACzD,CAAA;gBACH,CAAC;YACH,CAAC;YAED,0DAA0D;YAC1D,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;gBAC7B,IAAI,OAAO,CAAC,QAAQ,KAAK,kBAAkB;oBACvC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;oBACzD,OAAO;wBACL,GAAG,OAAO;wBACV,QAAQ,EAAE,MAAe;wBACzB,eAAe,EAAE,0DAA0D;qBAC5E,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,0EAA0E;YAC1E,sFAAsF;YACtF,MAAM,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YAEpD,IAAI,YAAY,IAAI,+BAA+B,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/E,OAAO;oBACL,GAAG,OAAO;oBACV,QAAQ,EAAE,MAAe;oBACzB,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,IAAI,EAAE,wCAAwC,CAAC,IAAI,EAAE;iBACjG,CAAA;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,QAAgB;IACrC,OAAO,qDAAqD,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AAC7E,CAAC"}

package/dist/filtering/index.d.ts

@@ -0,0 +1,3 @@
+export { FilterPipeline, type FilterStage, type FilterAction, type FilterDecision, type AnnotatedFinding, type FilterStageSummary, } from './pipeline';
+export { applyContextAdjustments } from './context-adjustments';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/filtering/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/filtering/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyContextAdjustments = exports.FilterPipeline = void 0;
+var pipeline_1 = require("./pipeline");
+Object.defineProperty(exports, "FilterPipeline", { enumerable: true, get: function () { return pipeline_1.FilterPipeline; } });
+var context_adjustments_1 = require("./context-adjustments");
+Object.defineProperty(exports, "applyContextAdjustments", { enumerable: true, get: function () { return context_adjustments_1.applyContextAdjustments; } });
+//# sourceMappingURL=index.js.map

package/dist/filtering/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/filtering/index.ts"],"names":[],"mappings":";;;AAAA,uCAOmB;AANjB,0GAAA,cAAc,OAAA;AAQhB,6DAA+D;AAAtD,8HAAA,uBAAuB,OAAA"}

package/dist/filtering/pipeline.d.ts

@@ -0,0 +1,48 @@
+/**
+ * FilterPipeline — Records every filter decision for auditability.
+ *
+ * Tracks which findings were dismissed, downgraded, aggregated, or deduplicated
+ * at each stage of the scanning pipeline. This enables answering
+ * "why was finding X suppressed?" without rerunning the scan.
+ *
+ * Zero overhead by default — only records when explicitly enabled.
+ */
+export type FilterStage = 'file_context_adjustment' | 'localhost_aggregation' | 'noisy_aggregation' | 'auto_dismiss' | 'tier_filter' | 'ai_validation' | 'global_context' | 'contradiction_resolution' | 'deduplication' | 'user_suppression';
+export type FilterAction = 'kept' | 'dismissed' | 'downgraded' | 'aggregated' | 'deduplicated' | 'suppressed';
+export interface FilterDecision {
+    stage: FilterStage;
+    action: FilterAction;
+    reason: string;
+    originalSeverity?: string;
+    newSeverity?: string;
+    ruleName?: string;
+}
+export interface AnnotatedFinding {
+    findingId: string;
+    decisions: FilterDecision[];
+    finalStatus: 'surfaced' | 'dismissed';
+}
+export interface FilterStageSummary {
+    dismissed: number;
+    downgraded: number;
+    kept: number;
+    aggregated: number;
+    deduplicated: number;
+    suppressed: number;
+}
+export declare class FilterPipeline {
+    private decisions;
+    private readonly enabled;
+    constructor(enabled?: boolean);
+    /** Record a filter decision for a finding. No-op if pipeline is disabled. */
+    record(findingId: string, decision: FilterDecision): void;
+    /** Get the full audit trail for all findings. */
+    getAuditTrail(): AnnotatedFinding[];
+    /** Get all decisions that led to a specific finding being filtered. */
+    explainDismissal(findingId: string): FilterDecision[];
+    /** Get summary statistics per filter stage. */
+    getSummaryStats(): Record<FilterStage, FilterStageSummary>;
+    /** Whether this pipeline is actively recording. */
+    get isEnabled(): boolean;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/filtering/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/filtering/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GACnB,yBAAyB,GACzB,uBAAuB,GACvB,mBAAmB,GACnB,cAAc,GACd,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,0BAA0B,GAC1B,eAAe,GACf,kBAAkB,CAAA;AAEtB,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,YAAY,CAAA;AAEhB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAA;IAClB,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,WAAW,EAAE,UAAU,GAAG,WAAW,CAAA;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,OAAe;IAIpC,6EAA6E;IAC7E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAWzD,iDAAiD;IACjD,aAAa,IAAI,gBAAgB,EAAE;IAcnC,uEAAuE;IACvE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAIrD,+CAA+C;IAC/C,eAAe,IAAI,MAAM,CAAC,WAAW,EAAE,kBAAkB,CAAC;IA8B1D,mDAAmD;IACnD,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF"}

package/dist/filtering/pipeline.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * FilterPipeline — Records every filter decision for auditability.
+ *
+ * Tracks which findings were dismissed, downgraded, aggregated, or deduplicated
+ * at each stage of the scanning pipeline. This enables answering
+ * "why was finding X suppressed?" without rerunning the scan.
+ *
+ * Zero overhead by default — only records when explicitly enabled.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterPipeline = void 0;
+class FilterPipeline {
+    constructor(enabled = false) {
+        this.decisions = new Map();
+        this.enabled = enabled;
+    }
+    /** Record a filter decision for a finding. No-op if pipeline is disabled. */
+    record(findingId, decision) {
+        if (!this.enabled)
+            return;
+        const existing = this.decisions.get(findingId);
+        if (existing) {
+            existing.push(decision);
+        }
+        else {
+            this.decisions.set(findingId, [decision]);
+        }
+    }
+    /** Get the full audit trail for all findings. */
+    getAuditTrail() {
+        const trail = [];
+        for (const [findingId, decisions] of this.decisions) {
+            const finalStatus = decisions.some(d => d.action === 'dismissed' || d.action === 'deduplicated' || d.action === 'suppressed') ? 'dismissed' : 'surfaced';
+            trail.push({ findingId, decisions, finalStatus });
+        }
+        return trail;
+    }
+    /** Get all decisions that led to a specific finding being filtered. */
+    explainDismissal(findingId) {
+        return this.decisions.get(findingId) ?? [];
+    }
+    /** Get summary statistics per filter stage. */
+    getSummaryStats() {
+        const stages = [
+            'file_context_adjustment',
+            'localhost_aggregation',
+            'noisy_aggregation',
+            'auto_dismiss',
+            'tier_filter',
+            'ai_validation',
+            'global_context',
+            'contradiction_resolution',
+            'deduplication',
+            'user_suppression',
+        ];
+        const stats = {};
+        for (const stage of stages) {
+            stats[stage] = { dismissed: 0, downgraded: 0, kept: 0, aggregated: 0, deduplicated: 0, suppressed: 0 };
+        }
+        for (const decisions of this.decisions.values()) {
+            for (const d of decisions) {
+                if (stats[d.stage]) {
+                    stats[d.stage][d.action]++;
+                }
+            }
+        }
+        return stats;
+    }
+    /** Whether this pipeline is actively recording. */
+    get isEnabled() {
+        return this.enabled;
+    }
+}
+exports.FilterPipeline = FilterPipeline;
+//# sourceMappingURL=pipeline.js.map

package/dist/filtering/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/filtering/pipeline.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA8CH,MAAa,cAAc;IAIzB,YAAY,UAAmB,KAAK;QAH5B,cAAS,GAAG,IAAI,GAAG,EAA4B,CAAA;QAIrD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,SAAiB,EAAE,QAAwB;QAChD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QAEzB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QAC9C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACzB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,aAAa;QACX,MAAM,KAAK,GAAuB,EAAE,CAAA;QAEpC,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpD,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACrC,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,cAAc,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY,CACrF,CAAC,CAAC,CAAC,WAAoB,CAAC,CAAC,CAAC,UAAmB,CAAA;YAE9C,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAA;QACnD,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;IAED,uEAAuE;IACvE,gBAAgB,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;IAC5C,CAAC;IAED,+CAA+C;IAC/C,eAAe;QACb,MAAM,MAAM,GAAkB;YAC5B,yBAAyB;YACzB,uBAAuB;YACvB,mBAAmB;YACnB,cAAc;YACd,aAAa;YACb,eAAe;YACf,gBAAgB;YAChB,0BAA0B;YAC1B,eAAe;YACf,kBAAkB;SACnB,CAAA;QAED,MAAM,KAAK,GAAG,EAA6C,CAAA;QAC3D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAA;QACxG,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAChD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnB,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAA;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;IAED,mDAAmD;IACnD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;CACF;AA3ED,wCA2EC"}

package/dist/formatters/ai-context.d.ts

@@ -0,0 +1,23 @@
+/**
+ * AI Context Formatter
+ * Generates structured markdown for AI coding assistants to consume and fix security findings
+ */
+import type { ScanResult } from '../types';
+/**
+ * Options for AI context formatting
+ */
+export interface AIContextOptions {
+    /** Maximum findings to include in detail (default: 20) */
+    maxFindings?: number;
+    /** Include reference URLs (default: true) */
+    includeReferences?: boolean;
+}
+/**
+ * Format scan result as AI-ready context markdown
+ *
+ * @param result - The scan result to format
+ * @param options - Formatting options
+ * @returns Markdown string for AI consumption
+ */
+export declare function formatAIContext(result: ScanResult, options?: AIContextOptions): string;
+//# sourceMappingURL=ai-context.d.ts.map

package/dist/formatters/ai-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-context.d.ts","sourceRoot":"","sources":["../../src/formatters/ai-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAwC,MAAM,UAAU,CAAA;AAGhF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AA2MD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CA2E1F"}