/**
 * Canonical schema banners for dxkit's machine-readable analyzer
 * reports. Every `--json` and `--detailed --json` payload carries a
 * top-level `schema` string so downstream consumers (AI agents, CI
 * runners, dashboards) version-gate before reading deeper fields.
 *
 * Schema-evolution contract: a backwards-compatible field addition
 * keeps the existing `vN` banner. A breaking field rename / removal
 * bumps to `v(N+1)`, and the bump is paired with a migration entry
 * in `CHANGELOG.md`. Today every analyzer emits `v1`; future
 * versions land in this map without consumers having to touch each
 * analyzer's emitter.
 *
 * Pure module: the helpers don't allocate beyond the returned
 * envelope.
 */
/**
 * Discriminator the schema-banner map keys off. Mirrors the dxkit
 * subcommand names that emit JSON. `quality` reports remain
 * fingerprint-stable even when re-rendered, so they share the same
 * banner across `--json` and `--detailed --json` paths.
 */
export type ReportKind = 'health' | 'health-detailed' | 'vulnerabilities' | 'vulnerabilities-detailed' | 'test-gaps' | 'test-gaps-detailed' | 'quality' | 'quality-detailed' | 'licenses' | 'licenses-detailed' | 'bom' | 'bom-detailed' | 'dev-report' | 'dev-report-detailed';
/**
 * The canonical banner for each report kind. New analyzers extend
 * this map; consumers read `schema` and compare against the
 * constant they understand.
 */
export declare const REPORT_SCHEMAS: Readonly<Record<ReportKind, string>>;
/**
 * Stamp a report with its canonical `schema` banner. Returns a new
 * object — never mutates the input — so callers can stamp before
 * `JSON.stringify` without worrying about clobbering shared state.
 *
 * Order matters for human-readable JSON: `schema` lands first so a
 * reader skimming a pretty-printed file sees the discriminator
 * immediately rather than scrolling past nested fields.
 */
export declare function stampSchema<T extends object>(report: T, kind: ReportKind): {
    readonly schema: string;
} & T;
//# sourceMappingURL=report-schema.d.ts.map