import type { SpecChangelogEntry, SpecChangelogData, AppendChangelogOptions, ReadChangelogOptions } from '../../types/index.js';
/** Format a single changelog entry as Markdown. */
export declare function formatEntry(entry: SpecChangelogEntry, specId: string): string;
/** Parse the timestamp from the first entry in a CHANGELOG.md content. */
export declare function parseFirstEntryTimestamp(content: string): string | null;
/** Parse changelog entries from a CHANGELOG.md content string. */
export declare function parseChangelogEntries(content: string, specId: string): SpecChangelogEntry[];
/** Read the CHANGELOG.md for a spec directory. Returns null if not found. */
export declare function readChangelog(options: ReadChangelogOptions): Promise<SpecChangelogData | null>;
/** Read only the timestamp of the last (most recent) changelog entry. Optimized for list_specs. */
export declare function readLastModifiedTimestamp(specDir: string): Promise<string | null>;
/** Append a new entry to the CHANGELOG.md for a spec. Creates the file if it doesn't exist. */
export declare function appendChangelogEntry(options: AppendChangelogOptions): Promise<boolean>;
/** Format a relative date string (e.g. "hace 2 dias") for a timestamp. */
export declare function formatRelativeDate(timestamp: string): string;
//# sourceMappingURL=core.d.ts.map