export declare function initDocsContext(opts: {
    repoRoot: string;
    submodules: readonly string[];
}): void;
/**
 * Regenerates index READMEs in docs/audits/ and docs/issues/ directories.
 * Idempotent: safe to run on every commit. Reads the first ~30 lines of
 * each dated file to extract title and (for issues) status.
 *
 * Targets: the host root, every initialized git submodule, and first-level
 * in-tree packages that keep `docs/audits` or `docs/issues` without being
 * git submodules. Marker rules are unchanged.
 *
 * Preserves hand-written preambles. The command updates only the section
 * between `<!-- BEGIN INDEX -->` and `<!-- END INDEX -->` markers. If a
 * README exists without markers, the command refuses to overwrite it and
 * reports it as `needs-markers` so the human can insert them explicitly.
 * New READMEs (no file yet) are created with a minimal default preamble.
 */
export interface IndexOpts {
    dryRun?: boolean;
    repo?: string;
}
export type IndexStatus = "unchanged" | "updated" | "needs-markers" | "created";
export interface IndexResult {
    path: string;
    status: IndexStatus;
    before: string;
    after: string;
}
export declare function extractStatus(content: string): string | undefined;
/** Root + initialized submodules + first-level in-tree packages with docs indexes. */
export declare function collectIndexTargets(): {
    name: string;
    path: string;
}[];
export declare function runIndex(opts: IndexOpts): Promise<IndexResult[]>;
//# sourceMappingURL=docs-index.d.ts.map