/**
 * Graph Maintenance Service
 *
 * Proactive graph health analysis: aggregates lint issues, orphan entities,
 * stale entities, and broken wikilinks into a unified health report.
 * Designed to run periodically or on-demand, with results surfaced
 * in the dashboard digest.
 */
import type { WorkspaceManager } from '../core/workspace-manager.js';
import { type LintIssue } from './lint-service.js';
import { type OrphanEntity } from './orphan-service.js';
export interface GraphHealthReport {
    generatedAt: string;
    summary: {
        totalEntities: number;
        totalIssues: number;
        missingFields: number;
        orphanEntities: number;
        staleEntities: number;
        brokenWikilinks: number;
    };
    missingFields: LintIssue[];
    orphans: OrphanEntity[];
    stale: StaleEntity[];
    brokenLinks: BrokenWikilink[];
}
export interface StaleEntity {
    repo: string;
    entityType: string;
    entityId: string;
    name: string;
    lastUpdated: string;
    daysSinceUpdate: number;
}
export interface BrokenWikilink {
    repo: string;
    entityType: string;
    entityId: string;
    name: string;
    brokenLink: string;
}
export declare function analyzeGraphHealth(manager: WorkspaceManager): Promise<GraphHealthReport>;
