import type { MarkdownArticleInput } from './check.mts'; export type GitLsFilesRunner = (root: string) => Promise; export interface DiscoverMarkdownArticlesOptions { /** Basenames to skip. Defaults to `['README.md']`. */ exclude?: readonly string[]; /** Return an empty list instead of throwing when nothing is found. Defaults to `false`. */ allowEmpty?: boolean; /** Replaces the `git ls-files` runner; receives `root` and returns root-relative tracked paths. */ listTrackedFiles?: GitLsFilesRunner; } /** Runs `git ls-files -z -- '*.md'` with an argv array (no shell) from `root`. */ export declare function gitLsFiles(root: string): Promise; /** * Lists git-tracked `*.md` files directly under `root` (not recursive), minus exclusions, * and returns them as sorted `{ name, source }` inputs. Throws when none are found unless * `allowEmpty` is set, so a wrong root cannot pass silently. */ export declare function discoverMarkdownArticles(root: string, options?: DiscoverMarkdownArticlesOptions): Promise;