/**
 * Shared formatting utilities for scar display.
 *
 * Used by:
 *   - prepare-context.ts (MCP tool for sub-agent injection)
 *   - quick-retrieve.ts  (hook-invoked retrieval for auto-inject)
 */
export interface FormattableScar {
    id: string;
    title: string;
    description: string;
    severity: string;
    counter_arguments?: string[];
    similarity?: number;
    source_linear_issue?: string;
    required_verification?: {
        when: string;
        queries: string[];
        must_show: string;
        blocking?: boolean;
    };
    why_this_matters?: string;
    action_protocol?: string[];
    self_check_criteria?: string[];
}
/** Text severity indicators — no emoji (column width is unpredictable across terminals) */
export declare const SEVERITY_EMOJI: Record<string, string>;
export declare const SEVERITY_LABEL: Record<string, string>;
export declare const SEVERITY_ORDER: Record<string, number>;
/**
 * Estimate tokens from a string.
 * Rough heuristic: ~4 characters per token for English text.
 */
export declare function estimateTokens(text: string): number;
/**
 * Format scars in compact mode.
 * One line per scar: emoji LABEL: Title — first sentence of description.
 * Sorted by severity (critical first). Truncated to token budget.
 */
export declare function formatCompact(scars: FormattableScar[], plan: string, maxTokens: number): {
    payload: string;
    included: number;
};
/**
 * Format scars in gate mode.
 * Only blocking scars (required_verification.blocking === true).
 * Returns PASS if none found.
 */
export declare function formatGate(scars: FormattableScar[]): {
    payload: string;
    blocking: number;
};
//# sourceMappingURL=format-utils.d.ts.map