import type { WorkState } from "../work-state/types";
import type { MetricsReport } from "./types";
/**
 * Generate a metrics report for a completed plan.
 *
 * Orchestrates:
 * 1. Extract planned files from the plan markdown
 * 2. Get actual changed files via git diff (startSha..HEAD)
 * 3. Calculate adherence (coverage, precision)
 * 4. Aggregate token usage (with per-session and model detail) across all sessions
 * 5. Compute total duration from session summaries
 * 6. Calculate quality score (composite of adherence, task completion, efficiency)
 * 7. Write the report to metrics-reports.jsonl
 *
 * Returns the report if successful, null on error.
 */
export declare function generateMetricsReport(directory: string, state: WorkState): MetricsReport | null;