import type { Finding } from './core/engine.js';
import type { TrackerConfig } from './types.js';
import { DocumentSource } from './backends/documentSource.js';
/** One already-constructed DocumentSource's header diagnostics as findings — shared by the
 *  tracker-wide sweep below and by `checkFile`'s document mode (src/check.ts), so both surfaces
 *  report the identical `loose_header_ignored` shape for the identical silent-discard. */
export declare function documentSourceHeaderFindings(source: DocumentSource, path: string): Finding[];
/** The "dark sibling" sweep: an `.md` file sitting in the SAME directory as a registered
 *  `format: "document"` source, itself holding issues in document grammar (id-bearing headings —
 *  same digit-carrying detection as `checkFile`'s mode flip, src/check.ts) but NOT registered as
 *  a source — the exact shape of the incident that motivated this: nine `workstream-*.md` files
 *  registered, a tenth authored beside them and silently invisible to `issue list`/`check`/`loop`.
 *  A warning (never gates by default), fired only on an UN-scoped `ztrack check` (inventory-level
 *  advice belongs on the full-tracker view, not on `check <issue-id>` or the per-issue loop
 *  gate). Registration is only ever OFFERED — mutating tracker-config.json is the user's call. */
export declare function unregisteredSiblingFindings(projectRoot: string, config: Pick<TrackerConfig, 'sources'>): Finding[];
/** Everything `checkTracker` needs to know about dialect LENS sources (docs/DIALECTS.md), read
 *  directly off disk the same cross-cutting way header diagnostics are: which issue ids live
 *  behind a lens (the leniency post-filter's key — a lens file never claimed process discipline,
 *  so preset ERRORS on its issues downgrade to warnings), and the engine's own parse diagnostics
 *  as warning findings (duplicate ids, unrecognized status tokens). */
export declare function dialectLensInfo(projectRoot: string, config: Pick<TrackerConfig, 'sources'>): {
    findings: Finding[];
    issueIds: Set<string>;
};
export declare function documentHeaderFindings(projectRoot: string, config: Pick<TrackerConfig, 'sources'>): Finding[];