export declare function initDocsContext(opts: {
    repoRoot: string;
    submodules: readonly string[];
    extraExcludedPrefixes?: readonly string[];
    docsRootAllowlist?: readonly string[];
}): void;
import { type DocsRepositorySource } from "./docs-repository-view.js";
/**
 * Documentation linter. Enforces the docs directory-layout + naming contract.
 *
 * Each violation carries a severity: `error` fails the lint, `warning` is
 * informational. `--fast` mode skips content-reading checks so the pre-commit
 * hook stays cheap.
 */
export type Severity = "error" | "warning";
export interface Violation {
    severity: Severity;
    repo: string;
    path: string;
    rule: string;
    message: string;
}
export interface LintOpts {
    fast?: boolean;
    repo?: string;
    source?: DocsRepositorySource;
}
/** Detect whether a file carries lifecycle status in leading YAML frontmatter. */
export declare function hasStatusHeader(path: string): boolean;
export declare function runLint(opts: LintOpts): Promise<Violation[]>;
//# sourceMappingURL=docs-lint.d.ts.map