driftdetect-core 0.1.0

package/dist/rules/severity-manager.d.ts

@@ -0,0 +1,394 @@
+/**
+ * Severity Manager - Severity handling
+ *
+ * Manages default severity per category, config overrides,
+ * and severity escalation logic. Provides methods to get effective
+ * severity for patterns, check if severity blocks, apply escalation
+ * rules, and sort violations by severity.
+ *
+ * @requirements 24.1 - THE Enforcement_System SHALL support severity levels: error, warning, info, hint
+ * @requirements 24.2 - WHEN severity is error, THE Violation SHALL block commits and merges
+ * @requirements 24.3 - WHEN severity is warning, THE Violation SHALL be displayed but not block
+ * @requirements 24.4 - THE Enforcement_System SHALL allow severity overrides per pattern in config
+ * @requirements 24.5 - THE Enforcement_System SHALL support severity escalation after N violations
+ */
+import type { PatternCategory, Severity } from '../store/types.js';
+import type { Violation, SeverityConfig, SeverityEscalationConfig, SeverityEscalationRule } from './types.js';
+/**
+ * Default severity levels per pattern category
+ *
+ * Security and auth patterns default to error (blocking)
+ * Most patterns default to warning (non-blocking)
+ * Documentation and hints default to info/hint
+ *
+ * @requirements 24.1 - Support severity levels: error, warning, info, hint
+ */
+export declare const DEFAULT_CATEGORY_SEVERITY: Record<PatternCategory, Severity>;
+/**
+ * Default escalation rules
+ *
+ * @requirements 24.5 - Support severity escalation after N violations
+ */
+export declare const DEFAULT_ESCALATION_RULES: SeverityEscalationRule[];
+/**
+ * Configuration options for the SeverityManager
+ */
+export interface SeverityManagerConfig {
+    /** Default severity for patterns without explicit configuration */
+    defaultSeverity: Severity;
+    /** Severity overrides by pattern ID */
+    patternOverrides: Record<string, Severity>;
+    /** Severity overrides by category */
+    categoryOverrides: Record<string, Severity>;
+    /** Escalation configuration */
+    escalation: SeverityEscalationConfig;
+}
+/**
+ * Default SeverityManager configuration
+ */
+export declare const DEFAULT_SEVERITY_MANAGER_CONFIG: SeverityManagerConfig;
+/**
+ * Tracks violation counts for escalation purposes
+ */
+export interface ViolationCounts {
+    /** Violation count by pattern ID */
+    byPattern: Record<string, number>;
+    /** Violation count by category */
+    byCategory: Record<string, number>;
+    /** Total violation count */
+    total: number;
+}
+/**
+ * SeverityManager class for managing severity levels for patterns.
+ *
+ * Provides functionality for:
+ * - Getting effective severity for a pattern (considering overrides)
+ * - Checking if a severity level blocks commits/merges
+ * - Applying severity escalation rules
+ * - Sorting violations by severity
+ *
+ * @requirements 24.1, 24.2, 24.3, 24.4, 24.5
+ */
+export declare class SeverityManager {
+    private config;
+    private violationCounts;
+    /**
+     * Create a new SeverityManager instance.
+     *
+     * @param config - Optional custom configuration
+     */
+    constructor(config?: Partial<SeverityManagerConfig>);
+    /**
+     * Get the effective severity for a pattern.
+     *
+     * Priority order:
+     * 1. Pattern-specific override (highest priority)
+     * 2. Category override
+     * 3. Default category severity
+     * 4. Default severity (lowest priority)
+     *
+     * @param patternId - The pattern ID
+     * @param category - The pattern category
+     * @returns The effective severity level
+     *
+     * @requirements 24.4 - Allow severity overrides per pattern in config
+     */
+    getEffectiveSeverity(patternId: string, category: PatternCategory): Severity;
+    /**
+     * Get the effective severity with escalation applied.
+     *
+     * Applies escalation rules based on violation counts.
+     *
+     * @param patternId - The pattern ID
+     * @param category - The pattern category
+     * @returns The effective severity level (potentially escalated)
+     *
+     * @requirements 24.5 - Support severity escalation after N violations
+     */
+    getEffectiveSeverityWithEscalation(patternId: string, category: PatternCategory): Severity;
+    /**
+     * Check if a severity level blocks commits and merges.
+     *
+     * Only 'error' severity blocks.
+     *
+     * @param severity - The severity level to check
+     * @returns True if the severity blocks, false otherwise
+     *
+     * @requirements 24.2 - WHEN severity is error, THE Violation SHALL block commits and merges
+     * @requirements 24.3 - WHEN severity is warning, THE Violation SHALL be displayed but not block
+     */
+    isBlocking(severity: Severity): boolean;
+    /**
+     * Check if any violations in a list are blocking.
+     *
+     * @param violations - Array of violations to check
+     * @returns True if any violation has blocking severity
+     *
+     * @requirements 24.2 - Error severity blocks commits and merges
+     */
+    hasBlockingViolations(violations: Violation[]): boolean;
+    /**
+     * Get the count of blocking violations.
+     *
+     * @param violations - Array of violations to check
+     * @returns Number of violations with blocking severity
+     */
+    getBlockingViolationCount(violations: Violation[]): number;
+    /**
+     * Apply escalation rules to a severity level.
+     *
+     * Checks violation counts and applies escalation rules if thresholds are met.
+     *
+     * @param baseSeverity - The base severity level
+     * @param patternId - The pattern ID
+     * @param category - The pattern category
+     * @returns The escalated severity level
+     *
+     * @requirements 24.5 - Support severity escalation after N violations
+     */
+    applyEscalation(baseSeverity: Severity, patternId: string, category: PatternCategory): Severity;
+    /**
+     * Find the applicable escalation rule for a severity and count.
+     *
+     * @param severity - The current severity level
+     * @param violationCount - The number of violations
+     * @returns The applicable escalation rule, or null if none applies
+     */
+    private findApplicableEscalationRule;
+    /**
+     * Record a violation for escalation tracking.
+     *
+     * @param patternId - The pattern ID
+     * @param category - The pattern category
+     */
+    recordViolation(patternId: string, category: PatternCategory): void;
+    /**
+     * Record multiple violations for escalation tracking.
+     *
+     * @param violations - Array of violations to record
+     * @param categoryMap - Map of pattern ID to category
+     */
+    recordViolations(violations: Violation[], categoryMap: Record<string, PatternCategory>): void;
+    /**
+     * Reset violation counts.
+     */
+    resetViolationCounts(): void;
+    /**
+     * Get current violation counts.
+     *
+     * @returns Copy of current violation counts
+     */
+    getViolationCounts(): ViolationCounts;
+    /**
+     * Sort violations by severity (most severe first).
+     *
+     * Errors come before warnings, warnings before info, info before hints.
+     *
+     * @param violations - Array of violations to sort
+     * @returns New array sorted by severity (descending)
+     *
+     * @requirements 24.1 - Support severity levels: error, warning, info, hint
+     */
+    sortBySeverity(violations: Violation[]): Violation[];
+    /**
+     * Sort violations by severity (least severe first).
+     *
+     * @param violations - Array of violations to sort
+     * @returns New array sorted by severity (ascending)
+     */
+    sortBySeverityAscending(violations: Violation[]): Violation[];
+    /**
+     * Group violations by severity level.
+     *
+     * @param violations - Array of violations to group
+     * @returns Object with violations grouped by severity
+     */
+    groupBySeverity(violations: Violation[]): Record<Severity, Violation[]>;
+    /**
+     * Filter violations by minimum severity level.
+     *
+     * @param violations - Array of violations to filter
+     * @param minSeverity - Minimum severity level to include
+     * @returns Filtered array of violations
+     */
+    filterByMinSeverity(violations: Violation[], minSeverity: Severity): Violation[];
+    /**
+     * Filter violations by maximum severity level.
+     *
+     * @param violations - Array of violations to filter
+     * @param maxSeverity - Maximum severity level to include
+     * @returns Filtered array of violations
+     */
+    filterByMaxSeverity(violations: Violation[], maxSeverity: Severity): Violation[];
+    /**
+     * Compare two severity levels.
+     *
+     * @param a - First severity level
+     * @param b - Second severity level
+     * @returns Negative if a < b, positive if a > b, 0 if equal
+     */
+    compareSeverity(a: Severity, b: Severity): number;
+    /**
+     * Check if severity a is more severe than severity b.
+     *
+     * @param a - First severity level
+     * @param b - Second severity level
+     * @returns True if a is more severe than b
+     */
+    isMoreSevere(a: Severity, b: Severity): boolean;
+    /**
+     * Check if severity a is less severe than severity b.
+     *
+     * @param a - First severity level
+     * @param b - Second severity level
+     * @returns True if a is less severe than b
+     */
+    isLessSevere(a: Severity, b: Severity): boolean;
+    /**
+     * Get the most severe severity from a list.
+     *
+     * @param severities - Array of severity levels
+     * @returns The most severe level, or 'hint' if empty
+     */
+    getMostSevere(severities: Severity[]): Severity;
+    /**
+     * Get the least severe severity from a list.
+     *
+     * @param severities - Array of severity levels
+     * @returns The least severe level, or 'error' if empty
+     */
+    getLeastSevere(severities: Severity[]): Severity;
+    /**
+     * Set a pattern-specific severity override.
+     *
+     * @param patternId - The pattern ID
+     * @param severity - The severity level to set
+     *
+     * @requirements 24.4 - Allow severity overrides per pattern in config
+     */
+    setPatternOverride(patternId: string, severity: Severity): void;
+    /**
+     * Remove a pattern-specific severity override.
+     *
+     * @param patternId - The pattern ID
+     */
+    removePatternOverride(patternId: string): void;
+    /**
+     * Set a category severity override.
+     *
+     * @param category - The pattern category
+     * @param severity - The severity level to set
+     *
+     * @requirements 24.4 - Allow severity overrides per pattern in config
+     */
+    setCategoryOverride(category: PatternCategory, severity: Severity): void;
+    /**
+     * Remove a category severity override.
+     *
+     * @param category - The pattern category
+     */
+    removeCategoryOverride(category: PatternCategory): void;
+    /**
+     * Enable or disable escalation.
+     *
+     * @param enabled - Whether escalation should be enabled
+     *
+     * @requirements 24.5 - Support severity escalation after N violations
+     */
+    setEscalationEnabled(enabled: boolean): void;
+    /**
+     * Set escalation threshold.
+     *
+     * @param threshold - Number of violations before escalation
+     *
+     * @requirements 24.5 - Support severity escalation after N violations
+     */
+    setEscalationThreshold(threshold: number): void;
+    /**
+     * Set escalation rules.
+     *
+     * @param rules - Array of escalation rules
+     *
+     * @requirements 24.5 - Support severity escalation after N violations
+     */
+    setEscalationRules(rules: SeverityEscalationRule[]): void;
+    /**
+     * Add an escalation rule.
+     *
+     * @param rule - The escalation rule to add
+     *
+     * @requirements 24.5 - Support severity escalation after N violations
+     */
+    addEscalationRule(rule: SeverityEscalationRule): void;
+    /**
+     * Get the current configuration.
+     *
+     * @returns Copy of current configuration
+     */
+    getConfig(): SeverityManagerConfig;
+    /**
+     * Create a SeverityConfig object from current state.
+     *
+     * @returns SeverityConfig object
+     */
+    toSeverityConfig(): SeverityConfig;
+    /**
+     * Create a SeverityManager from a SeverityConfig object.
+     *
+     * @param config - The SeverityConfig to use
+     * @returns New SeverityManager instance
+     */
+    static fromSeverityConfig(config: SeverityConfig): SeverityManager;
+}
+/**
+ * Get the default severity for a category.
+ *
+ * @param category - The pattern category
+ * @returns The default severity for the category
+ */
+export declare function getDefaultCategorySeverity(category: PatternCategory): Severity;
+/**
+ * Check if a severity level is blocking.
+ *
+ * @param severity - The severity level to check
+ * @returns True if the severity blocks commits/merges
+ *
+ * @requirements 24.2 - Error severity blocks commits and merges
+ */
+export declare function isBlockingSeverity(severity: Severity): boolean;
+/**
+ * Compare two severity levels.
+ *
+ * @param a - First severity level
+ * @param b - Second severity level
+ * @returns Negative if a < b, positive if a > b, 0 if equal
+ */
+export declare function compareSeverity(a: Severity, b: Severity): number;
+/**
+ * Sort violations by severity (most severe first).
+ *
+ * @param violations - Array of violations to sort
+ * @returns New array sorted by severity (descending)
+ */
+export declare function sortViolationsBySeverity(violations: Violation[]): Violation[];
+/**
+ * Get severity summary from violations.
+ *
+ * @param violations - Array of violations
+ * @returns Object with counts by severity
+ */
+export declare function getSeveritySummary(violations: Violation[]): Record<Severity, number>;
+/**
+ * Create a SeverityManager with default configuration.
+ *
+ * @returns New SeverityManager instance with defaults
+ */
+export declare function createSeverityManager(): SeverityManager;
+/**
+ * Create a SeverityManager from DriftConfig severity settings.
+ *
+ * @param severityOverrides - Severity overrides from config
+ * @returns New SeverityManager instance
+ */
+export declare function createSeverityManagerFromConfig(severityOverrides?: Record<string, Severity>): SeverityManager;
+//# sourceMappingURL=severity-manager.d.ts.map

package/dist/rules/severity-manager.d.ts.map

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