@oculum/scanner 1.0.11 → 1.0.13

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-adjustments.js","sourceRoot":"","sources":["../../../src/postprocess/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/postprocess/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/postprocess/filtering/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/postprocess/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/postprocess/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/postprocess/filtering/index.js.map

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

package/dist/postprocess/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' | 'confidence_scoring' | '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/postprocess/filtering/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/postprocess/filtering/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GACnB,yBAAyB,GACzB,uBAAuB,GACvB,mBAAmB,GACnB,cAAc,GACd,oBAAoB,GACpB,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/postprocess/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',
+            'confidence_scoring',
+            '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/postprocess/filtering/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../src/postprocess/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,oBAAoB;YACpB,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/postprocess/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Postprocessing Pipeline — Runs the full postprocessing chain on findings.
+ *
+ * Dedup → context adjustments → contradiction resolution → suppression.
+ * Records audit decisions for each sub-step via FilterPipeline.
+ */
+import type { Vulnerability, ScanFile } from '../shared/types';
+import type { MiddlewareAuthConfig } from '../model/middleware-detector';
+import type { FilterPipeline } from './filtering/pipeline';
+import type { SuppressionResult } from './suppression/types';
+export interface PostprocessInput {
+    /** Raw findings to postprocess */
+    findings: Vulnerability[];
+    /** Source files (for inline suppression parsing) */
+    files: ScanFile[];
+    /** Middleware config for contradiction resolution */
+    middlewareConfig?: MiddlewareAuthConfig;
+    /** Project path for suppression config loading */
+    projectPath?: string;
+    /** FilterPipeline for audit recording */
+    filterPipeline: FilterPipeline;
+    /** Whether to show suppressed findings */
+    showSuppressed?: boolean;
+}
+export interface PostprocessResult {
+    /** Findings after all postprocessing */
+    findings: Vulnerability[];
+    /** Suppression result (for stats and suppressed findings) */
+    suppressionResult: SuppressionResult;
+}
+/**
+ * Run the full postprocessing chain on findings.
+ *
+ * Pipeline: dedup → context adjustments → contradiction resolution → suppression
+ */
+export declare function postprocessFindings(input: PostprocessInput): PostprocessResult;
+export { deduplicateVulnerabilities } from './dedup';
+export { aggregateNoisyFindings } from './aggregation';
+export { resolveContradictions } from './contradictions';
+export { capValidationCandidatesPerFile, MAX_VALIDATION_CANDIDATES_PER_FILE } from './validation-cap';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/postprocess/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAM5D,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,oDAAoD;IACpD,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,oBAAoB,CAAA;IACvC,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,cAAc,EAAE,cAAc,CAAA;IAC9B,0CAA0C;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,6DAA6D;IAC7D,iBAAiB,EAAE,iBAAiB,CAAA;CACrC;AAKD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAiE9E;AAGD,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,8BAA8B,EAAE,kCAAkC,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/postprocess/index.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Postprocessing Pipeline — Runs the full postprocessing chain on findings.
+ *
+ * Dedup → context adjustments → contradiction resolution → suppression.
+ * Records audit decisions for each sub-step via FilterPipeline.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_VALIDATION_CANDIDATES_PER_FILE = exports.capValidationCandidatesPerFile = exports.resolveContradictions = exports.aggregateNoisyFindings = exports.deduplicateVulnerabilities = void 0;
+exports.postprocessFindings = postprocessFindings;
+const dedup_1 = require("./dedup");
+const context_adjustments_1 = require("./filtering/context-adjustments");
+const contradictions_1 = require("./contradictions");
+const suppression_1 = require("./suppression");
+const fid = (v) => `${v.filePath}:${v.lineNumber}:${v.category}`;
+/**
+ * Run the full postprocessing chain on findings.
+ *
+ * Pipeline: dedup → context adjustments → contradiction resolution → suppression
+ */
+function postprocessFindings(input) {
+    const { findings, files, middlewareConfig, projectPath, filterPipeline, } = input;
+    // 1. Deduplicate vulnerabilities
+    const uniqueVulnerabilities = (0, dedup_1.deduplicateVulnerabilities)(findings);
+    if (filterPipeline.isEnabled) {
+        const uniqueIds = new Set(uniqueVulnerabilities.map(fid));
+        for (const v of findings) {
+            if (!uniqueIds.has(fid(v))) {
+                filterPipeline.record(fid(v), { stage: 'deduplication', action: 'deduplicated', reason: 'Duplicate finding removed' });
+            }
+        }
+    }
+    // 2. Apply file context-based severity adjustments (Phase 2b)
+    const contextAdjustedVulnerabilities = (0, context_adjustments_1.applyContextAdjustments)(uniqueVulnerabilities);
+    if (filterPipeline.isEnabled) {
+        for (let i = 0; i < uniqueVulnerabilities.length; i++) {
+            const before = uniqueVulnerabilities[i];
+            const after = contextAdjustedVulnerabilities[i];
+            if (before.severity !== after.severity) {
+                filterPipeline.record(fid(after), { stage: 'global_context', action: 'downgraded', reason: after.validationNotes || 'Context-based severity downgrade', originalSeverity: before.severity, newSeverity: after.severity });
+            }
+        }
+    }
+    // 3. Resolve contradictions
+    const resolvedVulnerabilities = (0, contradictions_1.resolveContradictions)(contextAdjustedVulnerabilities, middlewareConfig);
+    if (filterPipeline.isEnabled) {
+        const resolvedIds = new Set(resolvedVulnerabilities.map(fid));
+        for (const v of contextAdjustedVulnerabilities) {
+            if (!resolvedIds.has(fid(v))) {
+                filterPipeline.record(fid(v), { stage: 'contradiction_resolution', action: 'dismissed', reason: 'Removed by contradiction resolution' });
+            }
+        }
+        for (let i = 0; i < contextAdjustedVulnerabilities.length; i++) {
+            const before = contextAdjustedVulnerabilities[i];
+            const after = resolvedVulnerabilities.find(v => fid(v) === fid(before));
+            if (after && before.severity !== after.severity) {
+                filterPipeline.record(fid(after), { stage: 'contradiction_resolution', action: 'downgraded', reason: 'Downgraded by contradiction resolution', originalSeverity: before.severity, newSeverity: after.severity });
+            }
+        }
+    }
+    // 4. Apply suppressions (inline comments + config file)
+    const resolvedProjectPath = projectPath || process.cwd();
+    const suppressionManager = new suppression_1.SuppressionManager({ projectPath: resolvedProjectPath });
+    const suppressionResult = suppressionManager.applySuppressions(resolvedVulnerabilities, files);
+    if (filterPipeline.isEnabled) {
+        for (const s of suppressionResult.suppressed) {
+            filterPipeline.record(fid(s.vulnerability), { stage: 'user_suppression', action: 'suppressed', reason: s.suppression.reason || `Suppressed by ${s.suppression.type}` });
+        }
+    }
+    return {
+        findings: suppressionResult.findings,
+        suppressionResult,
+    };
+}
+// Re-export sub-modules for direct access
+var dedup_2 = require("./dedup");
+Object.defineProperty(exports, "deduplicateVulnerabilities", { enumerable: true, get: function () { return dedup_2.deduplicateVulnerabilities; } });
+var aggregation_1 = require("./aggregation");
+Object.defineProperty(exports, "aggregateNoisyFindings", { enumerable: true, get: function () { return aggregation_1.aggregateNoisyFindings; } });
+var contradictions_2 = require("./contradictions");
+Object.defineProperty(exports, "resolveContradictions", { enumerable: true, get: function () { return contradictions_2.resolveContradictions; } });
+var validation_cap_1 = require("./validation-cap");
+Object.defineProperty(exports, "capValidationCandidatesPerFile", { enumerable: true, get: function () { return validation_cap_1.capValidationCandidatesPerFile; } });
+Object.defineProperty(exports, "MAX_VALIDATION_CANDIDATES_PER_FILE", { enumerable: true, get: function () { return validation_cap_1.MAX_VALIDATION_CANDIDATES_PER_FILE; } });
+//# sourceMappingURL=index.js.map

package/dist/postprocess/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/postprocess/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAyCH,kDAiEC;AApGD,mCAAoD;AACpD,yEAAyE;AACzE,qDAAwD;AACxD,+CAAkD;AAwBlD,MAAM,GAAG,GAAG,CAAC,CAA8D,EAAE,EAAE,CAC7E,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAA;AAE/C;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,KAAuB;IACzD,MAAM,EACJ,QAAQ,EACR,KAAK,EACL,gBAAgB,EAChB,WAAW,EACX,cAAc,GACf,GAAG,KAAK,CAAA;IAET,iCAAiC;IACjC,MAAM,qBAAqB,GAAG,IAAA,kCAA0B,EAAC,QAAQ,CAAC,CAAA;IAClE,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QACzD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3B,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC,CAAA;YACxH,CAAC;QACH,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,MAAM,8BAA8B,GAAG,IAAA,6CAAuB,EAAC,qBAAqB,CAAC,CAAA;IACrF,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,qBAAqB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtD,MAAM,MAAM,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAA;YACvC,MAAM,KAAK,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAA;YAC/C,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACvC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,eAAe,IAAI,kCAAkC,EAAE,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;YAC3N,CAAC;QACH,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,MAAM,uBAAuB,GAAG,IAAA,sCAAqB,EAAC,8BAA8B,EAAE,gBAAgB,CAAC,CAAA;IACvG,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,uBAAuB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QAC7D,KAAK,MAAM,CAAC,IAAI,8BAA8B,EAAE,CAAC;YAC/C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,qCAAqC,EAAE,CAAC,CAAA;YAC1I,CAAC;QACH,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,8BAA8B,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/D,MAAM,MAAM,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAA;YAChD,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;YACvE,IAAI,KAAK,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAChD,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,wCAAwC,EAAE,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;YAClN,CAAC;QACH,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,MAAM,mBAAmB,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IACxD,MAAM,kBAAkB,GAAG,IAAI,gCAAkB,CAAC,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC,CAAA;IACvF,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAA;IAE9F,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,iBAAiB,CAAC,UAAU,EAAE,CAAC;YAC7C,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,IAAI,iBAAiB,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QACzK,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,iBAAiB,CAAC,QAAQ;QACpC,iBAAiB;KAClB,CAAA;AACH,CAAC;AAED,0CAA0C;AAC1C,iCAAoD;AAA3C,mHAAA,0BAA0B,OAAA;AACnC,6CAAsD;AAA7C,qHAAA,sBAAsB,OAAA;AAC/B,mDAAwD;AAA/C,uHAAA,qBAAqB,OAAA;AAC9B,mDAAqG;AAA5F,gIAAA,8BAA8B,OAAA;AAAE,oIAAA,kCAAkC,OAAA"}

package/dist/postprocess/suppression/config-loader.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Suppression Config Loader
+ * Loads and validates suppression configuration from various file formats
+ */
+import type { SuppressionConfig, RuleSuppression, FindingSuppression } from './types';
+/**
+ * Result of loading suppression config
+ */
+export interface ConfigLoadResult {
+    /** The loaded config (or default if none found) */
+    config: SuppressionConfig;
+    /** Path to the config file (if found) */
+    configPath?: string;
+    /** Whether a config file was found */
+    found: boolean;
+    /** Any errors encountered during loading */
+    errors: string[];
+}
+/**
+ * Find the config file by walking up the directory tree
+ */
+export declare function findConfigFile(startPath: string): string | null;
+/**
+ * Load suppression config from a specific path
+ */
+export declare function loadConfigFromPath(configPath: string): ConfigLoadResult;
+/**
+ * Load suppression config from a project directory
+ * Searches up the directory tree for a config file
+ */
+export declare function loadSuppressionConfig(projectPath: string): ConfigLoadResult;
+/**
+ * Write suppression config to a file
+ */
+export declare function writeSuppressionConfig(configPath: string, config: SuppressionConfig): void;
+/**
+ * Add a finding suppression to the config file
+ */
+export declare function addFindingSuppression(projectPath: string, suppression: FindingSuppression): {
+    success: boolean;
+    configPath: string;
+    error?: string;
+};
+/**
+ * Remove a finding suppression from the config file
+ */
+export declare function removeFindingSuppression(projectPath: string, hash: string): {
+    success: boolean;
+    configPath?: string;
+    error?: string;
+    removed: boolean;
+};
+/**
+ * Add a rule suppression to the config file
+ */
+export declare function addRuleSuppression(projectPath: string, suppression: RuleSuppression): {
+    success: boolean;
+    configPath: string;
+    error?: string;
+};
+/**
+ * List all suppressions in the config
+ */
+export declare function listSuppressions(projectPath: string): {
+    rules: RuleSuppression[];
+    findings: FindingSuppression[];
+    configPath?: string;
+    errors: string[];
+};
+/**
+ * Check if a date string is expired
+ */
+export declare function isExpired(dateString: string | undefined): boolean;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/postprocess/suppression/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../../src/postprocess/suppression/config-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EACnB,MAAM,SAAS,CAAA;AAOhB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,MAAM,EAAE,iBAAiB,CAAA;IACzB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,KAAK,EAAE,OAAO,CAAA;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuB/D;AAgHD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CA2CvE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAY3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,iBAAiB,GACxB,IAAI,CAgBN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,kBAAkB,GAC9B;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAkD1D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAwC7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,eAAe,GAC3B;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAmD1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG;IACrD,KAAK,EAAE,eAAe,EAAE,CAAA;IACxB,QAAQ,EAAE,kBAAkB,EAAE,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB,CASA;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAajE"}