@oddessentials/odd-ai-reviewers 1.0.0

package/dist/report/github.js

@@ -0,0 +1,409 @@
+/**
+ * GitHub Reporter
+ * Posts findings as PR comments and check run summaries
+ * Includes deduplication and throttling
+ */
+import { Octokit } from '@octokit/rest';
+import { deduplicateFindings, sortFindings, generateSummaryMarkdown, renderPartialFindingsSection, toGitHubAnnotation, countBySeverity, extractFingerprintMarkers, getDedupeKey, buildProximityMap, isDuplicateByProximity, identifyStaleComments, updateProximityMap, } from './formats.js';
+import { buildCommentToMarkersMap, shouldResolveComment, getPartiallyResolvedMarkers, hasMalformedMarkers, applyPartialResolutionVisual, stripOwnFingerprintMarkers, emitResolutionLog, emitMalformedMarkerWarning, } from './resolution.js';
+import { canonicalizeDiffFiles } from '../diff.js';
+import { delay, INLINE_COMMENT_DELAY_MS, formatInlineComment, formatGroupedInlineComment, } from './base.js';
+import { buildLineResolver, normalizeFindingsForDiff, computeDriftSignal, generateDriftMarkdown, } from './line-resolver.js';
+/**
+ * Start a check run in 'in_progress' state
+ * Call this at the beginning of the review to show users the review is running
+ */
+export async function startCheckRun(context) {
+    const octokit = new Octokit({ auth: context.token });
+    const response = await octokit.checks.create({
+        owner: context.owner,
+        repo: context.repo,
+        name: 'AI Code Review',
+        head_sha: context.headSha,
+        status: 'in_progress',
+        started_at: new Date().toISOString(),
+        output: {
+            title: 'AI Code Review in progress...',
+            summary: 'Analyzing code changes. This may take a moment.',
+        },
+    });
+    console.log(`[github] Started check run ${response.data.id} (in_progress)`);
+    return response.data.id;
+}
+/**
+ * Post findings to GitHub
+ *
+ * (012-fix-agent-result-regressions) - Now accepts partialFindings to include
+ * in check summaries and PR comments. Partial findings are rendered in a dedicated
+ * section that makes clear they're from failed agents and don't affect gating.
+ */
+export async function reportToGitHub(findings, partialFindings, context, config, diffFiles) {
+    const octokit = new Octokit({ auth: context.token });
+    const reportingConfig = config.reporting.github ?? {
+        mode: 'checks_and_comments',
+        max_inline_comments: 20,
+        summary: true,
+    };
+    // CANONICAL ENTRYPOINT: Ensure all diff paths are normalized FIRST
+    // This must happen before buildLineResolver, deleted set, or rename maps
+    const canonicalFiles = canonicalizeDiffFiles(diffFiles);
+    // Build line resolver and normalize findings from canonical files
+    const lineResolver = buildLineResolver(canonicalFiles);
+    const normalizationResult = normalizeFindingsForDiff(findings, lineResolver);
+    if (normalizationResult.stats.dropped > 0 || normalizationResult.stats.normalized > 0) {
+        console.log(`[github] Line validation: ${normalizationResult.stats.valid} valid, ` +
+            `${normalizationResult.stats.normalized} normalized, ${normalizationResult.stats.dropped} dropped`);
+    }
+    // Compute drift signal for visibility in check summary
+    const driftSignal = computeDriftSignal(normalizationResult.stats, normalizationResult.invalidDetails);
+    // Process normalized findings
+    const deduplicated = deduplicateFindings(normalizationResult.findings);
+    const sorted = sortFindings(deduplicated);
+    const counts = countBySeverity(sorted);
+    try {
+        let checkRunId;
+        let commentId;
+        let skippedDuplicates = 0;
+        // Create check run if enabled
+        if (reportingConfig.mode === 'checks_only' || reportingConfig.mode === 'checks_and_comments') {
+            checkRunId = await createCheckRun(octokit, context, sorted, partialFindings, counts, config, driftSignal);
+        }
+        // Post PR comment if enabled and we have a PR number
+        if (context.prNumber &&
+            (reportingConfig.mode === 'comments_only' || reportingConfig.mode === 'checks_and_comments')) {
+            // Build set of deleted files for belt-and-suspenders guard in postPRComment
+            // FR-003: Use canonicalFiles for path normalization consistency with findings
+            const deletedFiles = new Set(canonicalFiles.filter((f) => f.status === 'deleted').map((f) => f.path));
+            const result = await postPRComment(octokit, context, sorted, partialFindings, reportingConfig.max_inline_comments, deletedFiles);
+            commentId = result.commentId;
+            skippedDuplicates = result.skippedDuplicates;
+        }
+        return {
+            success: true,
+            checkRunId,
+            commentId,
+            skippedDuplicates,
+            validationStats: normalizationResult.stats,
+            invalidLineDetails: normalizationResult.invalidDetails.length > 0
+                ? normalizationResult.invalidDetails
+                : undefined,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+/**
+ * Create or update a GitHub check run with annotations
+ * If context.checkRunId is provided, updates existing check run (proper lifecycle)
+ * Otherwise creates a new check run (legacy/fallback behavior)
+ *
+ * (012-fix-agent-result-regressions) - Now includes partialFindings in summary
+ */
+async function createCheckRun(octokit, context, findings, partialFindings, counts, config, driftSignal) {
+    // Determine conclusion based on gating config
+    let conclusion = 'success';
+    if (config.gating.enabled) {
+        if (config.gating.fail_on_severity === 'error' && counts.error > 0) {
+            conclusion = 'failure';
+        }
+        else if (config.gating.fail_on_severity === 'warning' &&
+            (counts.error > 0 || counts.warning > 0)) {
+            conclusion = 'failure';
+        }
+        else if (config.gating.fail_on_severity === 'info' &&
+            (counts.error > 0 || counts.warning > 0 || counts.info > 0)) {
+            conclusion = 'failure';
+        }
+    }
+    // Convert findings to annotations (max 50 per request)
+    const annotations = findings
+        .map(toGitHubAnnotation)
+        .filter((a) => a !== null)
+        .slice(0, 50);
+    const summary = generateSummaryMarkdown(findings);
+    // (012-fix-agent-result-regressions) - Append partial findings section if present
+    const partialSection = renderPartialFindingsSection(partialFindings);
+    // Append drift signal to summary (only shows when warn/fail threshold exceeded)
+    const driftMarkdown = generateDriftMarkdown(driftSignal);
+    const fullSummary = summary + partialSection + driftMarkdown;
+    const output = {
+        title: `AI Review: ${counts.error} errors, ${counts.warning} warnings, ${counts.info} info`,
+        summary: fullSummary,
+        annotations,
+    };
+    // If we have an existing check run ID, update it (proper lifecycle)
+    if (context.checkRunId) {
+        await octokit.checks.update({
+            owner: context.owner,
+            repo: context.repo,
+            check_run_id: context.checkRunId,
+            status: 'completed',
+            conclusion,
+            completed_at: new Date().toISOString(),
+            output,
+        });
+        console.log(`[github] Updated check run ${context.checkRunId} with conclusion: ${conclusion}`);
+        return context.checkRunId;
+    }
+    // Fallback: create new check run (legacy behavior if startCheckRun wasn't called)
+    const response = await octokit.checks.create({
+        owner: context.owner,
+        repo: context.repo,
+        name: 'AI Code Review',
+        head_sha: context.headSha,
+        status: 'completed',
+        conclusion,
+        output,
+    });
+    console.log(`[github] Created check run ${response.data.id} with conclusion: ${conclusion}`);
+    return response.data.id;
+}
+/**
+ * Post a summary comment on the PR with deduplication
+ */
+async function postPRComment(octokit, context, findings, partialFindings, maxInlineComments, deletedFiles = new Set()) {
+    if (!context.prNumber) {
+        throw new Error('PR number required for comments');
+    }
+    // (012-fix-agent-result-regressions) - Include partial findings section in PR comment
+    const summary = generateSummaryMarkdown(findings) + renderPartialFindingsSection(partialFindings);
+    // Find existing comment to update
+    const existingComments = await octokit.issues.listComments({
+        owner: context.owner,
+        repo: context.repo,
+        issue_number: context.prNumber,
+    });
+    const botComment = existingComments.data.find((c) => c.user?.type === 'Bot' && c.body?.includes('## AI Code Review Summary'));
+    let commentId;
+    if (botComment) {
+        // Update existing comment
+        const response = await octokit.issues.updateComment({
+            owner: context.owner,
+            repo: context.repo,
+            comment_id: botComment.id,
+            body: summary,
+        });
+        commentId = response.data.id;
+        console.log(`[github] Updated existing comment ${commentId}`);
+    }
+    else {
+        // Create new comment
+        const response = await octokit.issues.createComment({
+            owner: context.owner,
+            repo: context.repo,
+            issue_number: context.prNumber,
+            body: summary,
+        });
+        commentId = response.data.id;
+        console.log(`[github] Created new comment ${commentId}`);
+    }
+    // Get existing review comments for deduplication
+    const existingReviewComments = await octokit.pulls.listReviewComments({
+        owner: context.owner,
+        repo: context.repo,
+        pull_number: context.prNumber,
+    });
+    // Build set of existing comment fingerprints and map to comment IDs for resolution
+    const existingDedupeKeys = [];
+    const dedupeKeyToCommentId = new Map();
+    for (const comment of existingReviewComments.data) {
+        if (comment.body) {
+            const markers = extractFingerprintMarkers(comment.body);
+            for (const marker of markers) {
+                existingDedupeKeys.push(marker);
+                dedupeKeyToCommentId.set(marker, comment.id);
+            }
+        }
+    }
+    // Build proximity-based deduplication structures
+    const existingFingerprintSet = new Set(existingDedupeKeys);
+    const proximityMap = buildProximityMap(existingDedupeKeys);
+    // Filter findings for inline comments
+    // Belt-and-suspenders: also filter out deleted files (should already be file-level)
+    const inlineFindings = findings
+        .filter((f) => f.line !== undefined && !deletedFiles.has(f.file))
+        .sort((a, b) => {
+        // Sort by severity (error > warning > info)
+        const severityOrder = { error: 0, warning: 1, info: 2 };
+        return (severityOrder[a.severity] ?? 2) - (severityOrder[b.severity] ?? 2);
+    });
+    // Group adjacent findings (within 3 lines of each other in same file)
+    const groupedFindings = groupAdjacentFindings(inlineFindings);
+    let skippedDuplicates = 0;
+    let postedCount = 0;
+    for (const findingOrGroup of groupedFindings) {
+        if (postedCount >= maxInlineComments)
+            break;
+        const findingsInGroup = Array.isArray(findingOrGroup) ? findingOrGroup : [findingOrGroup];
+        // Use proximity-based deduplication: skip if ALL findings in group are duplicates
+        // A finding is a duplicate if:
+        // 1. Exact dedupe key match (same fingerprint + file + line), OR
+        // 2. Same fingerprint+file within LINE_PROXIMITY_THRESHOLD lines
+        const allDuplicates = findingsInGroup.every((f) => isDuplicateByProximity(f, existingFingerprintSet, proximityMap));
+        if (allDuplicates) {
+            skippedDuplicates++;
+            continue;
+        }
+        const finding = findingsInGroup[0];
+        if (!finding)
+            continue;
+        const body = Array.isArray(findingOrGroup)
+            ? formatGroupedInlineComment(findingOrGroup)
+            : formatInlineComment(finding);
+        try {
+            const commentParams = {
+                owner: context.owner,
+                repo: context.repo,
+                pull_number: context.prNumber,
+                body,
+                commit_id: context.headSha,
+                path: finding.file,
+                line: finding.line,
+                side: 'RIGHT', // Always comment on new file (right side of diff)
+            };
+            // Add multi-line comment support if endLine is present
+            if (finding.endLine && finding.endLine !== finding.line) {
+                commentParams.start_line = finding.line;
+                commentParams.start_side = 'RIGHT';
+                commentParams.line = finding.endLine;
+            }
+            await octokit.pulls.createReviewComment(commentParams);
+            postedCount++;
+            // Update tracking structures with newly posted findings
+            for (const f of findingsInGroup) {
+                const key = getDedupeKey(f);
+                existingFingerprintSet.add(key);
+                // FR-001: Update proximityMap using canonical pattern
+                updateProximityMap(proximityMap, f);
+            }
+            // Rate limiting delay
+            await delay(INLINE_COMMENT_DELAY_MS);
+        }
+        catch (error) {
+            // Inline comments can fail for various reasons (line not in diff, etc.)
+            console.warn(`[github] Failed to post inline comment: ${error}`);
+        }
+    }
+    // Resolve stale comments (comments for issues that no longer exist)
+    // FIX: Use grouped comment resolution - only resolve when ALL markers are stale
+    const staleKeys = identifyStaleComments(existingDedupeKeys, findings);
+    const staleKeySet = new Set(staleKeys);
+    // Build reverse map: commentId -> all markers in that comment
+    const commentIdToMarkers = buildCommentToMarkersMap(dedupeKeyToCommentId);
+    // Track which comments we've already processed to avoid duplicate API calls
+    const processedCommentIds = new Set();
+    let resolvedCount = 0;
+    let partiallyResolvedCount = 0;
+    // Process each comment that has at least one stale marker
+    for (const staleKey of staleKeys) {
+        const commentIdToProcess = dedupeKeyToCommentId.get(staleKey);
+        if (!commentIdToProcess || processedCommentIds.has(commentIdToProcess))
+            continue;
+        processedCommentIds.add(commentIdToProcess);
+        // Get ALL markers for this comment
+        const allMarkersInComment = commentIdToMarkers.get(commentIdToProcess) ?? [];
+        // Emit warning if any markers are malformed (FR-010: exactly one warning per comment)
+        if (hasMalformedMarkers(allMarkersInComment)) {
+            emitMalformedMarkerWarning('github', commentIdToProcess);
+        }
+        // Check if comment should be resolved (ALL markers must be stale)
+        const shouldResolve = shouldResolveComment(allMarkersInComment, staleKeySet);
+        // Get partially resolved markers for visual indication
+        const partiallyResolved = getPartiallyResolvedMarkers(allMarkersInComment, staleKeySet);
+        // Emit resolution log (once per comment per run)
+        // FR-005: Simplified staleCount calculation for clarity
+        const staleCount = shouldResolve ? allMarkersInComment.length : partiallyResolved.length;
+        emitResolutionLog('github', commentIdToProcess, allMarkersInComment.length, staleCount, shouldResolve);
+        try {
+            // Get the existing comment to preserve its content
+            // Note: O(n) linear search is acceptable here - only called once per processed comment
+            // (not per marker), and processedCommentIds prevents duplicates. For enterprise PRs
+            // with 1000+ comments, consider indexing existingReviewComments.data by ID upfront.
+            const existingComment = existingReviewComments.data.find((c) => c.id === commentIdToProcess);
+            if (!existingComment?.body)
+                continue;
+            // Skip if already marked as fully resolved
+            if (existingComment.body.includes('✅ **Resolved**')) {
+                continue;
+            }
+            if (shouldResolve) {
+                // ALL markers are stale - resolve the entire comment
+                // Strip only our fingerprint markers, preserving any user-added HTML comments (FR-019)
+                const bodyWithoutOurMarkers = stripOwnFingerprintMarkers(existingComment.body);
+                const resolvedBody = `~~${bodyWithoutOurMarkers}~~\n\n` +
+                    `✅ **Resolved** - This issue appears to have been fixed.\n\n` +
+                    allMarkersInComment
+                        .map((m) => `<!-- odd-ai-reviewers:fingerprint:v1:${m} -->`)
+                        .join('\n');
+                await octokit.pulls.updateReviewComment({
+                    owner: context.owner,
+                    repo: context.repo,
+                    comment_id: commentIdToProcess,
+                    body: resolvedBody,
+                });
+                resolvedCount++;
+            }
+            else if (partiallyResolved.length > 0) {
+                // Only SOME markers are stale - apply visual indication (strikethrough)
+                const updatedBody = applyPartialResolutionVisual(existingComment.body, partiallyResolved);
+                // Only update if the body actually changed
+                if (updatedBody !== existingComment.body) {
+                    await octokit.pulls.updateReviewComment({
+                        owner: context.owner,
+                        repo: context.repo,
+                        comment_id: commentIdToProcess,
+                        body: updatedBody,
+                    });
+                    partiallyResolvedCount++;
+                }
+            }
+            await delay(INLINE_COMMENT_DELAY_MS);
+        }
+        catch (error) {
+            console.warn(`[github] Failed to resolve/update comment ${commentIdToProcess}: ${error}`);
+        }
+    }
+    console.log(`[github] Posted ${postedCount} inline comments, skipped ${skippedDuplicates} duplicates, resolved ${resolvedCount} comments, ${partiallyResolvedCount} partially resolved`);
+    return { commentId, skippedDuplicates };
+}
+/**
+ * Group adjacent findings (within 3 lines in the same file)
+ */
+function groupAdjacentFindings(findings) {
+    if (findings.length === 0)
+        return [];
+    const result = [];
+    const firstFinding = findings[0];
+    if (!firstFinding)
+        return [];
+    let currentGroup = [firstFinding];
+    for (let i = 1; i < findings.length; i++) {
+        const prev = currentGroup[currentGroup.length - 1];
+        const curr = findings[i];
+        if (!prev || !curr)
+            continue;
+        // Group if same file and within 3 lines
+        if (prev.file === curr.file && Math.abs(curr.line - prev.line) <= 3) {
+            currentGroup.push(curr);
+        }
+        else {
+            // Finish current group
+            const firstInGroup = currentGroup[0];
+            if (firstInGroup) {
+                result.push(currentGroup.length === 1 ? firstInGroup : currentGroup);
+            }
+            currentGroup = [curr];
+        }
+    }
+    // Don't forget the last group
+    const firstInGroup = currentGroup[0];
+    if (firstInGroup) {
+        result.push(currentGroup.length === 1 ? firstInGroup : currentGroup);
+    }
+    return result;
+}
+//# sourceMappingURL=github.js.map

package/dist/report/github.js.map

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

package/dist/report/line-resolver.d.ts

@@ -0,0 +1,208 @@
+/**
+ * Line Resolver Module
+ *
+ * Resolves and validates finding line numbers against unified diffs to prevent
+ * misaligned inline comments on GitHub and Azure DevOps.
+ *
+ * Design Philosophy:
+ * - Early normalization before deduplication (INVARIANTS #22)
+ * - Comprehensive validation with detailed reporting
+ * - Agent-aware resolution (LLMs may emit diff lines, static tools emit file lines)
+ * - Graceful degradation (drop unresolvable lines to file-level comments)
+ */
+import type { CanonicalDiffFile } from '../diff.js';
+import type { Finding } from '../agents/types.js';
+/**
+ * Represents a single diff hunk with line tracking
+ */
+export interface DiffHunk {
+    /** Starting line number in the new file (from @@ header) */
+    newFileStart: number;
+    /** All valid line numbers in new file (added + context) */
+    newFileLines: number[];
+    /** Line numbers for added lines only ('+' prefix) */
+    addedLines: number[];
+    /** Line numbers for context lines only (' ' prefix) */
+    contextLines: number[];
+}
+/**
+ * Per-file mapping of valid lines from diff
+ */
+export interface FileLineMapping {
+    /** All valid commentable lines (added + context) */
+    allLines: Set<number>;
+    /** Only added lines ('+' prefix in diff) */
+    addedLines: Set<number>;
+    /** Only context lines (' ' prefix in diff) */
+    contextLines: Set<number>;
+    /** Hunk metadata for debugging and summaries */
+    hunks: DiffHunk[];
+}
+/**
+ * Result of validating a single line number
+ */
+export interface LineValidationResult {
+    /** Whether the line is valid for commenting */
+    valid: boolean;
+    /** The line number being validated */
+    line: number;
+    /** Whether this is an added line (vs context line) */
+    isAddition?: boolean;
+    /** Reason for invalid line (if applicable) */
+    reason?: string;
+    /** Suggested nearest valid line (if requested and available) */
+    nearestValidLine?: number;
+}
+/**
+ * Statistics from finding normalization (fine-grained accounting)
+ */
+export interface ValidationStats {
+    /** Total findings processed */
+    total: number;
+    /** Findings with valid lines (no changes needed) */
+    valid: number;
+    /** Findings auto-fixed to nearest valid line */
+    normalized: number;
+    /** Findings downgraded to file-level (invalid line or deleted file) */
+    downgraded: number;
+    /** Findings dropped entirely (removed) */
+    dropped: number;
+    /** Subset of downgraded: findings on deleted files */
+    deletedFiles: number;
+    /** Subset of downgraded: findings on ambiguous rename paths */
+    ambiguousRenames: number;
+    /** Findings remapped from old path to new path (successful rename handling) */
+    remappedPaths: number;
+}
+/**
+ * Details about an invalid line finding
+ */
+export interface InvalidLineDetail {
+    file: string;
+    line?: number;
+    reason: string;
+    nearestValidLine?: number;
+    sourceAgent?: string;
+}
+/**
+ * Line resolver interface for validating and normalizing line numbers
+ */
+export interface LineResolver {
+    /** Validate a line number for a file */
+    validateLine(filePath: string, line: number | undefined, options?: LineValidationOptions): LineValidationResult;
+    /** Get debug summary for a file */
+    getFileSummary(filePath: string): string;
+    /** Check if a file exists in the diff */
+    hasFile(filePath: string): boolean;
+    /** Check if a file is deleted (no inline comments allowed) */
+    isDeleted(filePath: string): boolean;
+    /**
+     * Remap an old path to its new canonical path (for renames)
+     * Returns the new path if rename mapping exists, otherwise returns original path
+     */
+    remapPath(filePath: string): string;
+    /**
+     * Check if a path mapping is ambiguous (multiple old paths map to same new path)
+     * Ambiguous renames should be downgraded to file-level comments
+     */
+    isAmbiguousRename(filePath: string): boolean;
+}
+export interface LineValidationOptions {
+    /** Only accept added lines ('+'), not context lines */
+    additionsOnly?: boolean;
+    /** Find and suggest nearest valid line when invalid */
+    suggestNearest?: boolean;
+    /** Agent source for resolution strategy */
+    sourceAgent?: string;
+}
+/**
+ * Parse unified diff hunks from a patch string
+ *
+ * Extracts line number information from diff hunks, distinguishing:
+ * - Added lines ('+' prefix) - exist in new file
+ * - Deleted lines ('-' prefix) - do NOT exist in new file
+ * - Context lines (' ' prefix) - exist in new file
+ *
+ * @param patch - Unified diff patch content
+ * @returns Array of parsed hunks with line tracking
+ */
+export declare function parseDiffHunks(patch: string): DiffHunk[];
+/**
+ * Build a line resolver from diff files
+ *
+ * @param files - Array of DiffFile objects with patches
+ * @returns LineResolver instance for validation and normalization
+ */
+export declare function buildLineResolver(files: CanonicalDiffFile[]): LineResolver;
+/**
+ * Normalize findings against diff, validating and adjusting line numbers
+ *
+ * Strategy:
+ * - Valid lines pass through unchanged
+ * - Invalid lines are dropped (line set to undefined) for file-level comment
+ * - Stats and invalid details are collected for reporting
+ *
+ * @param findings - Array of findings to normalize
+ * @param resolver - Line resolver built from diff
+ * @param options - Normalization options
+ * @returns Normalized findings with statistics
+ */
+export declare function normalizeFindingsForDiff(findings: Finding[], resolver: LineResolver, options?: {
+    additionsOnly?: boolean;
+    autoFix?: boolean;
+}): {
+    findings: Finding[];
+    stats: ValidationStats;
+    invalidDetails: InvalidLineDetail[];
+};
+/**
+ * Drift signal result - indicates overall health of line validation
+ */
+export interface DriftSignal {
+    /** Signal level: ok (< warn threshold), warn (< fail threshold), fail (>= fail threshold) */
+    level: 'ok' | 'warn' | 'fail';
+    /** Degradation percentage (dropped + downgraded) / total */
+    degradationPercent: number;
+    /** Auto-fix percentage (normalized) / total */
+    autoFixPercent: number;
+    /** Human-readable message explaining the signal */
+    message: string;
+    /** Top invalid samples for debugging (up to maxSamples) */
+    samples: InvalidLineDetail[];
+}
+/**
+ * Configuration for drift signal thresholds
+ */
+export interface DriftConfig {
+    /** Warn threshold for degradation percentage (default: 20) */
+    warnThresholdPercent: number;
+    /** Fail threshold for degradation percentage (default: 50) */
+    failThresholdPercent: number;
+    /** Maximum samples to include in signal (default: 5) */
+    maxSamples: number;
+}
+/** Default drift configuration */
+export declare const DEFAULT_DRIFT_CONFIG: DriftConfig;
+/**
+ * Compute drift signal from validation stats and invalid details
+ *
+ * This provides an enterprise-grade health check for line validation:
+ * - ok: Everything is fine, degradation is within acceptable limits
+ * - warn: Degradation is concerning, should investigate
+ * - fail: Degradation is too high, likely indicates a systemic issue
+ *
+ * @param stats - Validation statistics from normalizeFindingsForDiff
+ * @param invalidDetails - Details about invalid lines
+ * @param config - Optional configuration for thresholds
+ * @returns DriftSignal indicating health and samples for debugging
+ */
+export declare function computeDriftSignal(stats: ValidationStats, invalidDetails: InvalidLineDetail[], config?: Partial<DriftConfig>): DriftSignal;
+/**
+ * Generate markdown section for drift signal to include in check summaries
+ * Only generates content when drift level is warn or fail
+ *
+ * @param drift - Computed drift signal
+ * @returns Markdown string (empty if level is 'ok')
+ */
+export declare function generateDriftMarkdown(drift: DriftSignal): string;
+//# sourceMappingURL=line-resolver.d.ts.map

package/dist/report/line-resolver.d.ts.map

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