import type { SpecFrontmatter, SpecFilterOptions, LeanSpecConfig } from '../types/index.js';
/**
 * Convert Date objects to YYYY-MM-DD string format
 * (gray-matter auto-parses YYYY-MM-DD strings as Date objects)
 */
export declare function normalizeDateFields(data: Record<string, unknown>): void;
/**
 * Enrich frontmatter with timestamps for velocity tracking
 * Auto-generates timestamps when missing and tracks status transitions
 */
export declare function enrichWithTimestamps(data: Record<string, unknown>, previousData?: Record<string, unknown>): void;
/**
 * Normalize tags field - parse JSON strings into arrays
 * Handles cases where AI accidentally creates tags as '["..",".."]' strings
 */
export declare function normalizeTagsField(data: Record<string, unknown>): void;
/**
 * Validate and coerce custom field types
 */
export declare function validateCustomField(value: unknown, expectedType: 'string' | 'number' | 'boolean' | 'array'): {
    valid: boolean;
    coerced?: unknown;
    error?: string;
};
/**
 * Validate custom fields according to config
 */
export declare function validateCustomFields(frontmatter: Record<string, unknown>, config?: LeanSpecConfig): Record<string, unknown>;
/**
 * Parse frontmatter from markdown content string
 */
export declare function parseFrontmatterFromString(content: string, filePath?: string, config?: LeanSpecConfig): SpecFrontmatter | null;
/**
 * Create updated frontmatter with changes
 */
export declare function createUpdatedFrontmatter(existingContent: string, updates: Partial<SpecFrontmatter>): {
    content: string;
    frontmatter: SpecFrontmatter;
};
/**
 * Filter specs by criteria
 */
export declare function matchesFilter(frontmatter: SpecFrontmatter, filter: SpecFilterOptions): boolean;
//# sourceMappingURL=frontmatter.d.ts.map