export interface HistoryReportMetadata {
  kind: string;
  generatedAt: string | null;
  sinceRef: string | null;
  scopePath: string | null;
  pathKind: string | null;
  summary: string | null;
  whyChanged: string | null;
  relatedFiles: string[];
  commitThemes: string[];
  topOwners: string[];
  readingOrder: string[];
  query?: string | null;
  traceMatches?: string[];
}

export function buildHistoryReportMetadata(kind: string, payload: Record<string, unknown>): HistoryReportMetadata;
export function buildHistoryMetadataText(metadata: HistoryReportMetadata): string;