@de-otio/bibcheck 0.1.0

package/dist/schema/output.d.ts

@@ -0,0 +1,1116 @@
+/**
+ * bibcheck output JSON schema — the contract consumers (LLM agents, CI tools,
+ * editor integrations) read.
+ *
+ * FROZEN. This schema is the contract every renderer and consumer reads;
+ * changes require a surfaced design decision (see tmp/design-review/) and a
+ * `SCHEMA_VERSION` bump. Do not edit ad hoc.
+ *
+ * Versioned independently of the package version via `SCHEMA_VERSION` below.
+ * Bumping rules:
+ *   - Additive changes (new optional fields, new enum members on otherwise-open
+ *     types) bump the minor part and remain backward-compatible.
+ *   - Renames, removals, or changed semantics bump the major part; consumers
+ *     pinning a major version are insulated.
+ *
+ * 0.3.0 (H2 — reverse-linkage / orphan detection): added the `'orphan'`
+ * member to `LinkageStatusSchema` (a bibliography citekey never referenced in
+ * any doc — the inverse of `'unresolved'`) and the OPTIONAL `orphanedEntries`
+ * summary counter. Orphans are INFORMATIONAL: they are surfaced but MUST NOT
+ * gate `bibcheck check` (an uncited bibliography entry is a smell, not proof of
+ * fabrication; gating would train users to disable checks). The change is
+ * purely additive — the `linkageFailures` invariant counts only `'unresolved'`
+ * entries, so orphans (status `'orphan'`) are naturally excluded — and the new
+ * summary counter is optional so existing Output builders that do not populate
+ * it keep emitting valid documents.
+ *
+ * 0.2.0 (Phase 5 — hallucination-hardening): added the existence evidence
+ * vocabulary (`ExistenceEvidenceSchema`) and verification-boundary fields
+ * (`evidence` / `checkedFor` / `notCheckedFor` / `error` on the existence
+ * layer); the per-entry `IdentifiersLayerSchema` (local DOI/ISBN/URL
+ * well-formedness); the `notFoundInDatabases` + `malformedIdentifiers`
+ * summary counters with existence-bucket reconciliation; and the optional
+ * `locator` / `authorSuppressed` linkage/worklist fields for the
+ * citation-parser swap. The new per-entry/summary fields are presently
+ * OPTIONAL so that the v0.1 producer (which does not yet populate them) keeps
+ * emitting valid documents; T21/T22/T25 populate them and a follow-up tightens
+ * them to required (see the `TODO(T22)` markers below).
+ *
+ * Authoritative documentation is the Zod schemas in this file. The published
+ * JSON Schema in `docs/output-schema.md` (when generated) is derived from
+ * these definitions, not maintained by hand.
+ */
+import { z } from 'zod';
+/** Current bibcheck output schema version. Independent of the package version. */
+export declare const SCHEMA_VERSION: "0.3.0";
+export declare const ToolInfoSchema: z.ZodObject<{
+    name: z.ZodLiteral<"bibcheck">;
+    version: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    name: "bibcheck";
+}, {
+    version: string;
+    name: "bibcheck";
+}>;
+export type ToolInfo = z.infer<typeof ToolInfoSchema>;
+export declare const SummarySchema: z.ZodObject<{
+    totalEntries: z.ZodNumber;
+    verified: z.ZodNumber;
+    metadataMismatches: z.ZodNumber;
+    /**
+     * Entries confirmed absent from every applicable database (a fabrication
+     * signal; gates by default per Q1). NEW in 0.2.0.
+     */
+    notFoundInDatabases: z.ZodNumber;
+    /**
+     * Entries with at least one malformed/bad-checksum identifier in the
+     * `identifiers` layer (a cheap fabrication signal; gates by default). NEW
+     * in 0.2.0.
+     */
+    malformedIdentifiers: z.ZodNumber;
+    unverifiable: z.ZodNumber;
+    canonicalIssues: z.ZodNumber;
+    linkageFailures: z.ZodNumber;
+    phraseFlags: z.ZodNumber;
+    worklistItems: z.ZodNumber;
+    /**
+     * Bibliography entries whose citekey is never referenced in any markdown doc
+     * (reverse linkage; the inverse of `linkageFailures`). INFORMATIONAL — an
+     * uncited entry is a smell (e.g. an LLM-padded reference list), not proof of
+     * fabrication, so it does NOT gate `bibcheck check`. OPTIONAL so the counter
+     * is additive: Output builders predating 0.3.0 that omit it stay valid. NEW
+     * in 0.3.0.
+     */
+    orphanedEntries: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    totalEntries: number;
+    verified: number;
+    metadataMismatches: number;
+    notFoundInDatabases: number;
+    malformedIdentifiers: number;
+    unverifiable: number;
+    canonicalIssues: number;
+    linkageFailures: number;
+    phraseFlags: number;
+    worklistItems: number;
+    orphanedEntries?: number | undefined;
+}, {
+    totalEntries: number;
+    verified: number;
+    metadataMismatches: number;
+    notFoundInDatabases: number;
+    malformedIdentifiers: number;
+    unverifiable: number;
+    canonicalIssues: number;
+    linkageFailures: number;
+    phraseFlags: number;
+    worklistItems: number;
+    orphanedEntries?: number | undefined;
+}>;
+export type Summary = z.infer<typeof SummarySchema>;
+export declare const ExistenceCheckSourceSchema: z.ZodEnum<["crossref", "openalex", "openlibrary"]>;
+export type ExistenceCheckSource = z.infer<typeof ExistenceCheckSourceSchema>;
+export declare const ExistenceCheckResultSchema: z.ZodEnum<["no-doi", "found", "not-found", "metadata-mismatch", "error"]>;
+export type ExistenceCheckResult = z.infer<typeof ExistenceCheckResultSchema>;
+export declare const ExistenceCheckSchema: z.ZodObject<{
+    source: z.ZodEnum<["crossref", "openalex", "openlibrary"]>;
+    result: z.ZodEnum<["no-doi", "found", "not-found", "metadata-mismatch", "error"]>;
+    /** Source-specific evidence. Shape varies per source; not strictly typed. */
+    evidence: z.ZodNullable<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    source: "crossref" | "openalex" | "openlibrary";
+    result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+    evidence?: unknown;
+}, {
+    source: "crossref" | "openalex" | "openlibrary";
+    result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+    evidence?: unknown;
+}>;
+export type ExistenceCheck = z.infer<typeof ExistenceCheckSchema>;
+export declare const ExistenceStatusSchema: z.ZodEnum<["verified", "metadata-mismatch", "not-found-in-databases", "unverifiable"]>;
+export type ExistenceStatus = z.infer<typeof ExistenceStatusSchema>;
+/**
+ * Defined per-entry evidence vocabulary, distinct from the bare `status`
+ * rollup, so an LLM-agent consumer cannot read `verified` as "the citation's
+ * claim is sound" (Q2). Deliberately discrete — there is NO numeric confidence
+ * score anywhere in this schema (barred by the project's "no uncalibrated
+ * confidence scores" design default); the vocabulary is the calibrated
+ * alternative.
+ */
+export declare const ExistenceEvidenceSchema: z.ZodEnum<["exists-metadata-match", "exists-metadata-mismatch", "absent", "unverifiable"]>;
+export type ExistenceEvidence = z.infer<typeof ExistenceEvidenceSchema>;
+/**
+ * The verification dimensions bibcheck can report on. Used by the existence
+ * layer's `checkedFor` / `notCheckedFor` arrays to state explicitly what was
+ * and was NOT checked. `claim-support` (does the source actually support the
+ * prose's claim?) is never checked automatically — it is the manual worklist's
+ * job — so it always appears in `notCheckedFor` for v0.1.
+ */
+export declare const CheckDimensionSchema: z.ZodEnum<["existence", "metadata", "canonical-url", "claim-support"]>;
+export type CheckDimension = z.infer<typeof CheckDimensionSchema>;
+export declare const ExistenceLayerSchema: z.ZodObject<{
+    status: z.ZodEnum<["verified", "metadata-mismatch", "not-found-in-databases", "unverifiable"]>;
+    /** Defined evidence vocabulary (Q2). NEW in 0.2.0. */
+    evidence: z.ZodEnum<["exists-metadata-match", "exists-metadata-mismatch", "absent", "unverifiable"]>;
+    /** Dimensions that were checked, e.g. ['existence','metadata']. NEW in 0.2.0. */
+    checkedFor: z.ZodArray<z.ZodEnum<["existence", "metadata", "canonical-url", "claim-support"]>, "many">;
+    /**
+     * Dimensions that were NOT checked. Always includes 'claim-support' for
+     * v0.1 (bibcheck never verifies whether the source supports the prose's
+     * claim; that is the manual worklist's job). NEW in 0.2.0.
+     */
+    notCheckedFor: z.ZodArray<z.ZodEnum<["existence", "metadata", "canonical-url", "claim-support"]>, "many">;
+    checks: z.ZodArray<z.ZodObject<{
+        source: z.ZodEnum<["crossref", "openalex", "openlibrary"]>;
+        result: z.ZodEnum<["no-doi", "found", "not-found", "metadata-mismatch", "error"]>;
+        /** Source-specific evidence. Shape varies per source; not strictly typed. */
+        evidence: z.ZodNullable<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        source: "crossref" | "openalex" | "openlibrary";
+        result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+        evidence?: unknown;
+    }, {
+        source: "crossref" | "openalex" | "openlibrary";
+        result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+        evidence?: unknown;
+    }>, "many">;
+    /**
+     * Set when the layer crashed (vs. a clean unverifiable result), so consumers
+     * can distinguish "we ran and found nothing applicable" from "we failed to
+     * run." NEW in 0.2.0 (also addresses S1). Null when the layer ran cleanly.
+     */
+    error: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    error: string | null;
+    status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+    evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+    checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+    notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+    checks: {
+        source: "crossref" | "openalex" | "openlibrary";
+        result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+        evidence?: unknown;
+    }[];
+}, {
+    error: string | null;
+    status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+    evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+    checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+    notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+    checks: {
+        source: "crossref" | "openalex" | "openlibrary";
+        result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+        evidence?: unknown;
+    }[];
+}>;
+export type ExistenceLayer = z.infer<typeof ExistenceLayerSchema>;
+export declare const IdentifierStatusSchema: z.ZodEnum<["ok", "malformed", "bad-checksum", "not-applicable"]>;
+export type IdentifierStatus = z.infer<typeof IdentifierStatusSchema>;
+export declare const IdentifiersLayerSchema: z.ZodObject<{
+    /** 'malformed' if the DOI fails `^10\.\d{4,}/\S+$`. */
+    doi: z.ZodEnum<["ok", "malformed", "bad-checksum", "not-applicable"]>;
+    /** 'bad-checksum' for a failed ISBN-10/13 check digit; 'malformed' for bad shape. */
+    isbn: z.ZodEnum<["ok", "malformed", "bad-checksum", "not-applicable"]>;
+    /** 'malformed' if the URL is not a well-formed http/https URL. */
+    url: z.ZodEnum<["ok", "malformed", "bad-checksum", "not-applicable"]>;
+}, "strip", z.ZodTypeAny, {
+    doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+    isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+    url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+}, {
+    doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+    isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+    url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+}>;
+export type IdentifiersLayer = z.infer<typeof IdentifiersLayerSchema>;
+export declare const CanonicalStatusSchema: z.ZodEnum<["verified-canonical", "wrong-host", "dead-url", "live-url-not-archived-snapshot", "no-url-on-pre-doi-entry", "not-applicable"]>;
+export type CanonicalStatus = z.infer<typeof CanonicalStatusSchema>;
+export declare const CanonicalLayerSchema: z.ZodObject<{
+    status: z.ZodEnum<["verified-canonical", "wrong-host", "dead-url", "live-url-not-archived-snapshot", "no-url-on-pre-doi-entry", "not-applicable"]>;
+    url: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    /** Redirect chain, in order, if HEAD followed redirects. */
+    redirectChain: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+    url: string | null;
+    redirectChain?: string[] | undefined;
+}, {
+    status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+    url: string | null;
+    redirectChain?: string[] | undefined;
+}>;
+export type CanonicalLayer = z.infer<typeof CanonicalLayerSchema>;
+export declare const EntrySchema: z.ZodObject<{
+    citekey: z.ZodString;
+    /**
+     * Layer 0 local identifier well-formedness (pre-network). Null when not run.
+     * NEW in 0.2.0 (Q5 / T21).
+     */
+    identifiers: z.ZodNullable<z.ZodObject<{
+        /** 'malformed' if the DOI fails `^10\.\d{4,}/\S+$`. */
+        doi: z.ZodEnum<["ok", "malformed", "bad-checksum", "not-applicable"]>;
+        /** 'bad-checksum' for a failed ISBN-10/13 check digit; 'malformed' for bad shape. */
+        isbn: z.ZodEnum<["ok", "malformed", "bad-checksum", "not-applicable"]>;
+        /** 'malformed' if the URL is not a well-formed http/https URL. */
+        url: z.ZodEnum<["ok", "malformed", "bad-checksum", "not-applicable"]>;
+    }, "strip", z.ZodTypeAny, {
+        doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+    }, {
+        doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+    }>>;
+    /** Layer 1 existence findings (commodity layer). Null when not run. */
+    existence: z.ZodNullable<z.ZodObject<{
+        status: z.ZodEnum<["verified", "metadata-mismatch", "not-found-in-databases", "unverifiable"]>;
+        /** Defined evidence vocabulary (Q2). NEW in 0.2.0. */
+        evidence: z.ZodEnum<["exists-metadata-match", "exists-metadata-mismatch", "absent", "unverifiable"]>;
+        /** Dimensions that were checked, e.g. ['existence','metadata']. NEW in 0.2.0. */
+        checkedFor: z.ZodArray<z.ZodEnum<["existence", "metadata", "canonical-url", "claim-support"]>, "many">;
+        /**
+         * Dimensions that were NOT checked. Always includes 'claim-support' for
+         * v0.1 (bibcheck never verifies whether the source supports the prose's
+         * claim; that is the manual worklist's job). NEW in 0.2.0.
+         */
+        notCheckedFor: z.ZodArray<z.ZodEnum<["existence", "metadata", "canonical-url", "claim-support"]>, "many">;
+        checks: z.ZodArray<z.ZodObject<{
+            source: z.ZodEnum<["crossref", "openalex", "openlibrary"]>;
+            result: z.ZodEnum<["no-doi", "found", "not-found", "metadata-mismatch", "error"]>;
+            /** Source-specific evidence. Shape varies per source; not strictly typed. */
+            evidence: z.ZodNullable<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            source: "crossref" | "openalex" | "openlibrary";
+            result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+            evidence?: unknown;
+        }, {
+            source: "crossref" | "openalex" | "openlibrary";
+            result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+            evidence?: unknown;
+        }>, "many">;
+        /**
+         * Set when the layer crashed (vs. a clean unverifiable result), so consumers
+         * can distinguish "we ran and found nothing applicable" from "we failed to
+         * run." NEW in 0.2.0 (also addresses S1). Null when the layer ran cleanly.
+         */
+        error: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        error: string | null;
+        status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+        evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+        checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+        notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+        checks: {
+            source: "crossref" | "openalex" | "openlibrary";
+            result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+            evidence?: unknown;
+        }[];
+    }, {
+        error: string | null;
+        status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+        evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+        checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+        notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+        checks: {
+            source: "crossref" | "openalex" | "openlibrary";
+            result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+            evidence?: unknown;
+        }[];
+    }>>;
+    /** Layer 1 canonical-edition findings (differentiated layer). Null when not run. */
+    canonical: z.ZodNullable<z.ZodObject<{
+        status: z.ZodEnum<["verified-canonical", "wrong-host", "dead-url", "live-url-not-archived-snapshot", "no-url-on-pre-doi-entry", "not-applicable"]>;
+        url: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+        /** Redirect chain, in order, if HEAD followed redirects. */
+        redirectChain: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+        url: string | null;
+        redirectChain?: string[] | undefined;
+    }, {
+        status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+        url: string | null;
+        redirectChain?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    citekey: string;
+    existence: {
+        error: string | null;
+        status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+        evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+        checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+        notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+        checks: {
+            source: "crossref" | "openalex" | "openlibrary";
+            result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+            evidence?: unknown;
+        }[];
+    } | null;
+    identifiers: {
+        doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+    } | null;
+    canonical: {
+        status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+        url: string | null;
+        redirectChain?: string[] | undefined;
+    } | null;
+}, {
+    citekey: string;
+    existence: {
+        error: string | null;
+        status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+        evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+        checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+        notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+        checks: {
+            source: "crossref" | "openalex" | "openlibrary";
+            result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+            evidence?: unknown;
+        }[];
+    } | null;
+    identifiers: {
+        doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+    } | null;
+    canonical: {
+        status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+        url: string | null;
+        redirectChain?: string[] | undefined;
+    } | null;
+}>;
+export type Entry = z.infer<typeof EntrySchema>;
+/**
+ * 'resolved'   — citekey appears in prose AND in the bibliography.
+ * 'unresolved' — citekey appears in prose but NOT in the bibliography (gates).
+ * 'orphan'     — citekey appears in the bibliography but is NOT referenced in
+ *                any prose doc (reverse linkage). INFORMATIONAL; never gates.
+ *                NEW in 0.3.0.
+ */
+export declare const LinkageStatusSchema: z.ZodEnum<["resolved", "unresolved", "orphan"]>;
+export type LinkageStatus = z.infer<typeof LinkageStatusSchema>;
+export declare const LinkageReferenceSchema: z.ZodObject<{
+    file: z.ZodString;
+    line: z.ZodNumber;
+    /** Citation locator, e.g. 'p. 42', 'pp. 33-35'. NEW in 0.2.0 (T25 populates). */
+    locator: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** True when the citation suppressed the author, e.g. '-@key'. NEW in 0.2.0 (T25). */
+    authorSuppressed: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    file: string;
+    line: number;
+    locator?: string | null | undefined;
+    authorSuppressed?: boolean | undefined;
+}, {
+    file: string;
+    line: number;
+    locator?: string | null | undefined;
+    authorSuppressed?: boolean | undefined;
+}>;
+export type LinkageReference = z.infer<typeof LinkageReferenceSchema>;
+export declare const LinkageEntrySchema: z.ZodObject<{
+    citekey: z.ZodString;
+    status: z.ZodEnum<["resolved", "unresolved", "orphan"]>;
+    references: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        /** Citation locator, e.g. 'p. 42', 'pp. 33-35'. NEW in 0.2.0 (T25 populates). */
+        locator: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** True when the citation suppressed the author, e.g. '-@key'. NEW in 0.2.0 (T25). */
+        authorSuppressed: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        line: number;
+        locator?: string | null | undefined;
+        authorSuppressed?: boolean | undefined;
+    }, {
+        file: string;
+        line: number;
+        locator?: string | null | undefined;
+        authorSuppressed?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    status: "resolved" | "unresolved" | "orphan";
+    citekey: string;
+    references: {
+        file: string;
+        line: number;
+        locator?: string | null | undefined;
+        authorSuppressed?: boolean | undefined;
+    }[];
+}, {
+    status: "resolved" | "unresolved" | "orphan";
+    citekey: string;
+    references: {
+        file: string;
+        line: number;
+        locator?: string | null | undefined;
+        authorSuppressed?: boolean | undefined;
+    }[];
+}>;
+export type LinkageEntry = z.infer<typeof LinkageEntrySchema>;
+export declare const PhraseFlagStatusSchema: z.ZodEnum<["flagged", "acknowledged"]>;
+export type PhraseFlagStatus = z.infer<typeof PhraseFlagStatusSchema>;
+export declare const PhraseFlagSchema: z.ZodObject<{
+    status: z.ZodEnum<["flagged", "acknowledged"]>;
+    /** Stable key naming the denylist pattern that matched. */
+    patternKey: z.ZodString;
+    /** Optional project-supplied URL — typically a doc explaining why this phrase is denylisted. */
+    referenceUrl: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    file: z.ZodString;
+    line: z.ZodNumber;
+    /** The substring of the prose that matched the pattern. */
+    matchedText: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "flagged" | "acknowledged";
+    file: string;
+    line: number;
+    patternKey: string;
+    referenceUrl: string | null;
+    matchedText: string;
+}, {
+    status: "flagged" | "acknowledged";
+    file: string;
+    line: number;
+    patternKey: string;
+    referenceUrl: string | null;
+    matchedText: string;
+}>;
+export type PhraseFlag = z.infer<typeof PhraseFlagSchema>;
+export declare const WorklistItemTypeSchema: z.ZodEnum<["direct-quotation", "paraphrase-with-page-ref", "contested-source-type", "non-canonical-edition"]>;
+export type WorklistItemType = z.infer<typeof WorklistItemTypeSchema>;
+export declare const WorklistItemSchema: z.ZodObject<{
+    type: z.ZodEnum<["direct-quotation", "paraphrase-with-page-ref", "contested-source-type", "non-canonical-edition"]>;
+    file: z.ZodString;
+    line: z.ZodNumber;
+    /** The citation invocation in the prose, e.g., `@mill1859onliberty`. */
+    citation: z.ZodString;
+    /** Excerpt of prose around the citation, for context. */
+    snippet: z.ZodString;
+    /** Pre-filled URL the human can use to perform the manual check. */
+    verificationUrl: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+    /** Human-readable description of what the manual check should establish. */
+    recommendedAction: z.ZodString;
+    /** Citation locator, e.g. 'p. 42', 'pp. 33-35'. NEW in 0.2.0 (T25 populates). */
+    locator: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    type: "direct-quotation" | "paraphrase-with-page-ref" | "contested-source-type" | "non-canonical-edition";
+    file: string;
+    line: number;
+    citation: string;
+    snippet: string;
+    verificationUrl: string | null;
+    recommendedAction: string;
+    locator?: string | null | undefined;
+}, {
+    type: "direct-quotation" | "paraphrase-with-page-ref" | "contested-source-type" | "non-canonical-edition";
+    file: string;
+    line: number;
+    citation: string;
+    snippet: string;
+    verificationUrl: string | null;
+    recommendedAction: string;
+    locator?: string | null | undefined;
+}>;
+export type WorklistItem = z.infer<typeof WorklistItemSchema>;
+export declare const OutputSchema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodString;
+    tool: z.ZodObject<{
+        name: z.ZodLiteral<"bibcheck">;
+        version: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        version: string;
+        name: "bibcheck";
+    }, {
+        version: string;
+        name: "bibcheck";
+    }>;
+    summary: z.ZodObject<{
+        totalEntries: z.ZodNumber;
+        verified: z.ZodNumber;
+        metadataMismatches: z.ZodNumber;
+        /**
+         * Entries confirmed absent from every applicable database (a fabrication
+         * signal; gates by default per Q1). NEW in 0.2.0.
+         */
+        notFoundInDatabases: z.ZodNumber;
+        /**
+         * Entries with at least one malformed/bad-checksum identifier in the
+         * `identifiers` layer (a cheap fabrication signal; gates by default). NEW
+         * in 0.2.0.
+         */
+        malformedIdentifiers: z.ZodNumber;
+        unverifiable: z.ZodNumber;
+        canonicalIssues: z.ZodNumber;
+        linkageFailures: z.ZodNumber;
+        phraseFlags: z.ZodNumber;
+        worklistItems: z.ZodNumber;
+        /**
+         * Bibliography entries whose citekey is never referenced in any markdown doc
+         * (reverse linkage; the inverse of `linkageFailures`). INFORMATIONAL — an
+         * uncited entry is a smell (e.g. an LLM-padded reference list), not proof of
+         * fabrication, so it does NOT gate `bibcheck check`. OPTIONAL so the counter
+         * is additive: Output builders predating 0.3.0 that omit it stay valid. NEW
+         * in 0.3.0.
+         */
+        orphanedEntries: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        totalEntries: number;
+        verified: number;
+        metadataMismatches: number;
+        notFoundInDatabases: number;
+        malformedIdentifiers: number;
+        unverifiable: number;
+        canonicalIssues: number;
+        linkageFailures: number;
+        phraseFlags: number;
+        worklistItems: number;
+        orphanedEntries?: number | undefined;
+    }, {
+        totalEntries: number;
+        verified: number;
+        metadataMismatches: number;
+        notFoundInDatabases: number;
+        malformedIdentifiers: number;
+        unverifiable: number;
+        canonicalIssues: number;
+        linkageFailures: number;
+        phraseFlags: number;
+        worklistItems: number;
+        orphanedEntries?: number | undefined;
+    }>;
+    entries: z.ZodArray<z.ZodObject<{
+        citekey: z.ZodString;
+        /**
+         * Layer 0 local identifier well-formedness (pre-network). Null when not run.
+         * NEW in 0.2.0 (Q5 / T21).
+         */
+        identifiers: z.ZodNullable<z.ZodObject<{
+            /** 'malformed' if the DOI fails `^10\.\d{4,}/\S+$`. */
+            doi: z.ZodEnum<["ok", "malformed", "bad-checksum", "not-applicable"]>;
+            /** 'bad-checksum' for a failed ISBN-10/13 check digit; 'malformed' for bad shape. */
+            isbn: z.ZodEnum<["ok", "malformed", "bad-checksum", "not-applicable"]>;
+            /** 'malformed' if the URL is not a well-formed http/https URL. */
+            url: z.ZodEnum<["ok", "malformed", "bad-checksum", "not-applicable"]>;
+        }, "strip", z.ZodTypeAny, {
+            doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        }, {
+            doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        }>>;
+        /** Layer 1 existence findings (commodity layer). Null when not run. */
+        existence: z.ZodNullable<z.ZodObject<{
+            status: z.ZodEnum<["verified", "metadata-mismatch", "not-found-in-databases", "unverifiable"]>;
+            /** Defined evidence vocabulary (Q2). NEW in 0.2.0. */
+            evidence: z.ZodEnum<["exists-metadata-match", "exists-metadata-mismatch", "absent", "unverifiable"]>;
+            /** Dimensions that were checked, e.g. ['existence','metadata']. NEW in 0.2.0. */
+            checkedFor: z.ZodArray<z.ZodEnum<["existence", "metadata", "canonical-url", "claim-support"]>, "many">;
+            /**
+             * Dimensions that were NOT checked. Always includes 'claim-support' for
+             * v0.1 (bibcheck never verifies whether the source supports the prose's
+             * claim; that is the manual worklist's job). NEW in 0.2.0.
+             */
+            notCheckedFor: z.ZodArray<z.ZodEnum<["existence", "metadata", "canonical-url", "claim-support"]>, "many">;
+            checks: z.ZodArray<z.ZodObject<{
+                source: z.ZodEnum<["crossref", "openalex", "openlibrary"]>;
+                result: z.ZodEnum<["no-doi", "found", "not-found", "metadata-mismatch", "error"]>;
+                /** Source-specific evidence. Shape varies per source; not strictly typed. */
+                evidence: z.ZodNullable<z.ZodUnknown>;
+            }, "strip", z.ZodTypeAny, {
+                source: "crossref" | "openalex" | "openlibrary";
+                result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+                evidence?: unknown;
+            }, {
+                source: "crossref" | "openalex" | "openlibrary";
+                result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+                evidence?: unknown;
+            }>, "many">;
+            /**
+             * Set when the layer crashed (vs. a clean unverifiable result), so consumers
+             * can distinguish "we ran and found nothing applicable" from "we failed to
+             * run." NEW in 0.2.0 (also addresses S1). Null when the layer ran cleanly.
+             */
+            error: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            error: string | null;
+            status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+            evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+            checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            checks: {
+                source: "crossref" | "openalex" | "openlibrary";
+                result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+                evidence?: unknown;
+            }[];
+        }, {
+            error: string | null;
+            status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+            evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+            checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            checks: {
+                source: "crossref" | "openalex" | "openlibrary";
+                result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+                evidence?: unknown;
+            }[];
+        }>>;
+        /** Layer 1 canonical-edition findings (differentiated layer). Null when not run. */
+        canonical: z.ZodNullable<z.ZodObject<{
+            status: z.ZodEnum<["verified-canonical", "wrong-host", "dead-url", "live-url-not-archived-snapshot", "no-url-on-pre-doi-entry", "not-applicable"]>;
+            url: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+            /** Redirect chain, in order, if HEAD followed redirects. */
+            redirectChain: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+            url: string | null;
+            redirectChain?: string[] | undefined;
+        }, {
+            status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+            url: string | null;
+            redirectChain?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        citekey: string;
+        existence: {
+            error: string | null;
+            status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+            evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+            checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            checks: {
+                source: "crossref" | "openalex" | "openlibrary";
+                result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+                evidence?: unknown;
+            }[];
+        } | null;
+        identifiers: {
+            doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        } | null;
+        canonical: {
+            status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+            url: string | null;
+            redirectChain?: string[] | undefined;
+        } | null;
+    }, {
+        citekey: string;
+        existence: {
+            error: string | null;
+            status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+            evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+            checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            checks: {
+                source: "crossref" | "openalex" | "openlibrary";
+                result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+                evidence?: unknown;
+            }[];
+        } | null;
+        identifiers: {
+            doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        } | null;
+        canonical: {
+            status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+            url: string | null;
+            redirectChain?: string[] | undefined;
+        } | null;
+    }>, "many">;
+    linkage: z.ZodArray<z.ZodObject<{
+        citekey: z.ZodString;
+        status: z.ZodEnum<["resolved", "unresolved", "orphan"]>;
+        references: z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            line: z.ZodNumber;
+            /** Citation locator, e.g. 'p. 42', 'pp. 33-35'. NEW in 0.2.0 (T25 populates). */
+            locator: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            /** True when the citation suppressed the author, e.g. '-@key'. NEW in 0.2.0 (T25). */
+            authorSuppressed: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            file: string;
+            line: number;
+            locator?: string | null | undefined;
+            authorSuppressed?: boolean | undefined;
+        }, {
+            file: string;
+            line: number;
+            locator?: string | null | undefined;
+            authorSuppressed?: boolean | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        status: "resolved" | "unresolved" | "orphan";
+        citekey: string;
+        references: {
+            file: string;
+            line: number;
+            locator?: string | null | undefined;
+            authorSuppressed?: boolean | undefined;
+        }[];
+    }, {
+        status: "resolved" | "unresolved" | "orphan";
+        citekey: string;
+        references: {
+            file: string;
+            line: number;
+            locator?: string | null | undefined;
+            authorSuppressed?: boolean | undefined;
+        }[];
+    }>, "many">;
+    phraseFlags: z.ZodArray<z.ZodObject<{
+        status: z.ZodEnum<["flagged", "acknowledged"]>;
+        /** Stable key naming the denylist pattern that matched. */
+        patternKey: z.ZodString;
+        /** Optional project-supplied URL — typically a doc explaining why this phrase is denylisted. */
+        referenceUrl: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+        file: z.ZodString;
+        line: z.ZodNumber;
+        /** The substring of the prose that matched the pattern. */
+        matchedText: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "flagged" | "acknowledged";
+        file: string;
+        line: number;
+        patternKey: string;
+        referenceUrl: string | null;
+        matchedText: string;
+    }, {
+        status: "flagged" | "acknowledged";
+        file: string;
+        line: number;
+        patternKey: string;
+        referenceUrl: string | null;
+        matchedText: string;
+    }>, "many">;
+    worklist: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["direct-quotation", "paraphrase-with-page-ref", "contested-source-type", "non-canonical-edition"]>;
+        file: z.ZodString;
+        line: z.ZodNumber;
+        /** The citation invocation in the prose, e.g., `@mill1859onliberty`. */
+        citation: z.ZodString;
+        /** Excerpt of prose around the citation, for context. */
+        snippet: z.ZodString;
+        /** Pre-filled URL the human can use to perform the manual check. */
+        verificationUrl: z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>;
+        /** Human-readable description of what the manual check should establish. */
+        recommendedAction: z.ZodString;
+        /** Citation locator, e.g. 'p. 42', 'pp. 33-35'. NEW in 0.2.0 (T25 populates). */
+        locator: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "direct-quotation" | "paraphrase-with-page-ref" | "contested-source-type" | "non-canonical-edition";
+        file: string;
+        line: number;
+        citation: string;
+        snippet: string;
+        verificationUrl: string | null;
+        recommendedAction: string;
+        locator?: string | null | undefined;
+    }, {
+        type: "direct-quotation" | "paraphrase-with-page-ref" | "contested-source-type" | "non-canonical-edition";
+        file: string;
+        line: number;
+        citation: string;
+        snippet: string;
+        verificationUrl: string | null;
+        recommendedAction: string;
+        locator?: string | null | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        citekey: string;
+        existence: {
+            error: string | null;
+            status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+            evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+            checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            checks: {
+                source: "crossref" | "openalex" | "openlibrary";
+                result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+                evidence?: unknown;
+            }[];
+        } | null;
+        identifiers: {
+            doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        } | null;
+        canonical: {
+            status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+            url: string | null;
+            redirectChain?: string[] | undefined;
+        } | null;
+    }[];
+    phraseFlags: {
+        status: "flagged" | "acknowledged";
+        file: string;
+        line: number;
+        patternKey: string;
+        referenceUrl: string | null;
+        matchedText: string;
+    }[];
+    schemaVersion: string;
+    tool: {
+        version: string;
+        name: "bibcheck";
+    };
+    summary: {
+        totalEntries: number;
+        verified: number;
+        metadataMismatches: number;
+        notFoundInDatabases: number;
+        malformedIdentifiers: number;
+        unverifiable: number;
+        canonicalIssues: number;
+        linkageFailures: number;
+        phraseFlags: number;
+        worklistItems: number;
+        orphanedEntries?: number | undefined;
+    };
+    linkage: {
+        status: "resolved" | "unresolved" | "orphan";
+        citekey: string;
+        references: {
+            file: string;
+            line: number;
+            locator?: string | null | undefined;
+            authorSuppressed?: boolean | undefined;
+        }[];
+    }[];
+    worklist: {
+        type: "direct-quotation" | "paraphrase-with-page-ref" | "contested-source-type" | "non-canonical-edition";
+        file: string;
+        line: number;
+        citation: string;
+        snippet: string;
+        verificationUrl: string | null;
+        recommendedAction: string;
+        locator?: string | null | undefined;
+    }[];
+}, {
+    entries: {
+        citekey: string;
+        existence: {
+            error: string | null;
+            status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+            evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+            checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            checks: {
+                source: "crossref" | "openalex" | "openlibrary";
+                result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+                evidence?: unknown;
+            }[];
+        } | null;
+        identifiers: {
+            doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        } | null;
+        canonical: {
+            status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+            url: string | null;
+            redirectChain?: string[] | undefined;
+        } | null;
+    }[];
+    phraseFlags: {
+        status: "flagged" | "acknowledged";
+        file: string;
+        line: number;
+        patternKey: string;
+        referenceUrl: string | null;
+        matchedText: string;
+    }[];
+    schemaVersion: string;
+    tool: {
+        version: string;
+        name: "bibcheck";
+    };
+    summary: {
+        totalEntries: number;
+        verified: number;
+        metadataMismatches: number;
+        notFoundInDatabases: number;
+        malformedIdentifiers: number;
+        unverifiable: number;
+        canonicalIssues: number;
+        linkageFailures: number;
+        phraseFlags: number;
+        worklistItems: number;
+        orphanedEntries?: number | undefined;
+    };
+    linkage: {
+        status: "resolved" | "unresolved" | "orphan";
+        citekey: string;
+        references: {
+            file: string;
+            line: number;
+            locator?: string | null | undefined;
+            authorSuppressed?: boolean | undefined;
+        }[];
+    }[];
+    worklist: {
+        type: "direct-quotation" | "paraphrase-with-page-ref" | "contested-source-type" | "non-canonical-edition";
+        file: string;
+        line: number;
+        citation: string;
+        snippet: string;
+        verificationUrl: string | null;
+        recommendedAction: string;
+        locator?: string | null | undefined;
+    }[];
+}>, {
+    entries: {
+        citekey: string;
+        existence: {
+            error: string | null;
+            status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+            evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+            checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            checks: {
+                source: "crossref" | "openalex" | "openlibrary";
+                result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+                evidence?: unknown;
+            }[];
+        } | null;
+        identifiers: {
+            doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        } | null;
+        canonical: {
+            status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+            url: string | null;
+            redirectChain?: string[] | undefined;
+        } | null;
+    }[];
+    phraseFlags: {
+        status: "flagged" | "acknowledged";
+        file: string;
+        line: number;
+        patternKey: string;
+        referenceUrl: string | null;
+        matchedText: string;
+    }[];
+    schemaVersion: string;
+    tool: {
+        version: string;
+        name: "bibcheck";
+    };
+    summary: {
+        totalEntries: number;
+        verified: number;
+        metadataMismatches: number;
+        notFoundInDatabases: number;
+        malformedIdentifiers: number;
+        unverifiable: number;
+        canonicalIssues: number;
+        linkageFailures: number;
+        phraseFlags: number;
+        worklistItems: number;
+        orphanedEntries?: number | undefined;
+    };
+    linkage: {
+        status: "resolved" | "unresolved" | "orphan";
+        citekey: string;
+        references: {
+            file: string;
+            line: number;
+            locator?: string | null | undefined;
+            authorSuppressed?: boolean | undefined;
+        }[];
+    }[];
+    worklist: {
+        type: "direct-quotation" | "paraphrase-with-page-ref" | "contested-source-type" | "non-canonical-edition";
+        file: string;
+        line: number;
+        citation: string;
+        snippet: string;
+        verificationUrl: string | null;
+        recommendedAction: string;
+        locator?: string | null | undefined;
+    }[];
+}, {
+    entries: {
+        citekey: string;
+        existence: {
+            error: string | null;
+            status: "verified" | "unverifiable" | "metadata-mismatch" | "not-found-in-databases";
+            evidence: "unverifiable" | "exists-metadata-match" | "exists-metadata-mismatch" | "absent";
+            checkedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            notCheckedFor: ("existence" | "metadata" | "canonical-url" | "claim-support")[];
+            checks: {
+                source: "crossref" | "openalex" | "openlibrary";
+                result: "error" | "no-doi" | "found" | "not-found" | "metadata-mismatch";
+                evidence?: unknown;
+            }[];
+        } | null;
+        identifiers: {
+            doi: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            isbn: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+            url: "ok" | "malformed" | "bad-checksum" | "not-applicable";
+        } | null;
+        canonical: {
+            status: "dead-url" | "wrong-host" | "not-applicable" | "verified-canonical" | "live-url-not-archived-snapshot" | "no-url-on-pre-doi-entry";
+            url: string | null;
+            redirectChain?: string[] | undefined;
+        } | null;
+    }[];
+    phraseFlags: {
+        status: "flagged" | "acknowledged";
+        file: string;
+        line: number;
+        patternKey: string;
+        referenceUrl: string | null;
+        matchedText: string;
+    }[];
+    schemaVersion: string;
+    tool: {
+        version: string;
+        name: "bibcheck";
+    };
+    summary: {
+        totalEntries: number;
+        verified: number;
+        metadataMismatches: number;
+        notFoundInDatabases: number;
+        malformedIdentifiers: number;
+        unverifiable: number;
+        canonicalIssues: number;
+        linkageFailures: number;
+        phraseFlags: number;
+        worklistItems: number;
+        orphanedEntries?: number | undefined;
+    };
+    linkage: {
+        status: "resolved" | "unresolved" | "orphan";
+        citekey: string;
+        references: {
+            file: string;
+            line: number;
+            locator?: string | null | undefined;
+            authorSuppressed?: boolean | undefined;
+        }[];
+    }[];
+    worklist: {
+        type: "direct-quotation" | "paraphrase-with-page-ref" | "contested-source-type" | "non-canonical-edition";
+        file: string;
+        line: number;
+        citation: string;
+        snippet: string;
+        verificationUrl: string | null;
+        recommendedAction: string;
+        locator?: string | null | undefined;
+    }[];
+}>;
+export type Output = z.infer<typeof OutputSchema>;
+//# sourceMappingURL=output.d.ts.map