/**
 * Pack Diff (W3.3-support of F-NEW-PRODUCT-AGENT-VISIBILITY-CLUSTER-2026-05-12).
 *
 * Computes a structured diff between two pack versions. Two consumers:
 *
 *   1. Live pack editor (W3.3) — "preview your changes" view before publish.
 *   2. Shadow-mode comparison — "what would v2 have done differently than
 *      v1 on the last N events?"
 *
 * Pure function, no IO. Output is a stable, auditor-reproducible PackDiff
 * shape.
 *
 * @connexum/ai-governance  F-NEW-PRODUCT-LIVE-PACK-EDITOR + F-NEW-PRODUCT-PACK-VERSIONING-ROLLBACK
 */
import type { CompliancePackWithClassifiers } from '../classification/pack-driven-classifier.js';
import type { CompliancePack } from '../packs/index.js';
export type DiffActionChange = {
    kind: 'added';
    category: string;
    action: string;
} | {
    kind: 'removed';
    category: string;
    previousAction: string;
} | {
    kind: 'changed';
    category: string;
    previousAction: string;
    newAction: string;
};
export interface PackDiff {
    fromVersion: string;
    toVersion: string;
    packId: string;
    /** Per-category change records. */
    changes: DiffActionChange[];
    /** Set-level summaries. */
    added: string[];
    removed: string[];
    changed: string[];
    /** Isolation mode change, if any. */
    isolationChange?: {
        from: string;
        to: string;
    };
    /** True if from === to in every relevant respect. */
    isNoop: boolean;
}
/**
 * Diff two packs. Categories present only in `from` are 'removed'.
 * Categories present only in `to` are 'added'. Categories in both with
 * different actions are 'changed'. Categories in both with the same action
 * are NOT in the change list.
 */
export declare function diffPacks(from: CompliancePack | CompliancePackWithClassifiers, to: CompliancePack | CompliancePackWithClassifiers): PackDiff;
/**
 * Produce a short human-readable summary of the diff for dashboard cards
 * and email-notification subjects.
 */
export declare function summarizeDiff(diff: PackDiff): string;
//# sourceMappingURL=pack-diff.d.ts.map