export interface HealthGap {
    check: string;
    severity: "warning" | "error";
    message: string;
}
export interface HealthCheckResult {
    clean: boolean;
    gaps: HealthGap[];
    configPresent: boolean;
    summary: string;
}
/**
 * Run a programmatic health check on a Forge project.
 *
 * @param cwd - project working directory (where .forge/ lives)
 * @param bundleRoot - path to dist/forge-payload/ (contains tools/)
 * @param forgeRoot - optional path to the installed Forge plugin root (for plugin integrity check)
 */
export declare function runHealthCheck(cwd: string, bundleRoot: string, forgeRoot?: string): Promise<HealthCheckResult>;
/**
 * Check for architecture docs not updated in over 90 days.
 * Returns one HealthGap per stale file.
 * Silently returns [] if the architecture directory does not exist.
 */
export declare function checkStaleDocs(cwd: string, config: Record<string, unknown>): HealthGap[];
/**
 * Check for generated files that have been manually edited.
 * Spawns generation-manifest.cjs list --modified from the bundled tools.
 * Returns one HealthGap per modified/missing file.
 * Silently returns [] if the tool is absent.
 */
export declare function checkModifiedGeneratedFiles(cwd: string, bundleRoot: string): HealthGap[];
/**
 * Check plugin files against the integrity.json manifest.
 * Natively implemented in TypeScript — no subprocess required.
 * Returns one HealthGap per modified or missing file.
 * Silently returns [] if forgeRoot is not provided or integrity.json is missing.
 */
export declare function checkPluginIntegrity(forgeRoot: string): HealthGap[];
/**
 * Run check-structure.cjs to verify expected generated files exist.
 * Returns one HealthGap per missing/extra file, or silently [] if absent.
 */
export declare function checkStructure(cwd: string, bundleRoot: string): HealthGap[];
/**
 * Run verify-integrity.cjs to detect plugin file tampering.
 * Returns one HealthGap per modified file, or silently [] if absent.
 */
export declare function checkVerifyIntegrity(forgeRoot: string): HealthGap[];