export type LintSeverity = 'error' | 'warning';
export interface LintError {
    file?: string;
    line?: number;
    severity: LintSeverity;
    code: string;
    message: string;
}
export interface LintOptions {
    filename?: string;
    /**
     * v0.0.7 — when set, `lintSpec` validates each `depends-on` entry resolves
     * to a file under `<cwd>/docs/specs/<id>.md` or `<cwd>/docs/specs/done/<id>.md`,
     * emitting a `spec/depends-on-missing` warning when missing. Absent → only
     * id-format checks run. CLI sets this; programmatic callers may opt out.
     */
    cwd?: string;
}
export declare function lintSpec(source: string, opts?: LintOptions): LintError[];
/**
 * Read a spec file from disk and lint it. The default `cwd` is the spec's
 * `<file>/../..` (i.e., the project root if the spec lives under `docs/specs/`).
 * Pass `opts.cwd` explicitly to override.
 */
export declare function lintSpecFile(filePath: string, opts?: LintOptions): LintError[];
//# sourceMappingURL=lint.d.ts.map