import type { SemanticGraph } from './compiler.js';
export interface StateComparison {
    readonly format: 'yarramate/state-comparison/v1';
    readonly from: string;
    readonly to: string;
    readonly added: SemanticGraph['subjects'];
    readonly removed: SemanticGraph['subjects'];
    readonly retained: SemanticGraph['subjects'];
}
export interface StateComparisonIssue {
    readonly code: 'YMS101';
    readonly message: string;
    readonly state: string;
}
export type StateComparisonResult = {
    readonly ok: true;
    readonly comparison: StateComparison;
} | {
    readonly ok: false;
    readonly issues: readonly StateComparisonIssue[];
};
export declare function compareArchitectureStates(graph: SemanticGraph, from: string, to: string): StateComparisonResult;