@thehammer/template-verification 0.2.11 → 0.2.13

package/dist/types.d.ts

@@ -91,12 +91,36 @@ export interface SourceDiscrepancy {
     /** The reconciling explanation (which values disagreed, why, and what corroborated the winner). */
     reason: string;
 }
+/**
+ * A recorded CORRECTION — "we normalised/typo-fixed/OCR-corrected this value" — the host's
+ * DataExtraction identity-dedupe pass applies for every field it returns a canonical spelling
+ * for (SG-396), an ordinary case/spacing/punctuation normalisation included (SG-406). Same
+ * shape as {@link SourceDiscrepancy} but a DIFFERENT fact: this is provenance ("we corrected
+ * this value"), never a claim that the source documents disagreed. The two used to share one
+ * field (`source_discrepancy`), which fired the reviewer's genuine-conflict warning on routine
+ * housekeeping — SG-406 gave the correction its own home. Present on any field the block
+ * dedupe touched; null/undefined on every field it never corrected.
+ */
+export interface Correction {
+    /** Which field was corrected — a constant naming the data point (e.g. "name"). */
+    field: string;
+    /** The literal pre-correction spelling(s) recorded before normalisation. */
+    conflicting_values: string[];
+    /** The evidence pages/sources the correction was decided from. */
+    evidence: SourceDiscrepancyEvidence[];
+    /** The canonical value that won. */
+    winning_value: string;
+    /** The correcting explanation. */
+    reason: string;
+}
 /**
  * The extracted (pipeline) candidate — carries provenance: confidence, reasoning, citation.
  *
  * SG-392: the host's BASE render (`data.__meta`) ships only `value`/`confidence`/
- * `state` plus the two `_count` integers below — `reasoning`/`basis`/`sources`/
- * `history` are `undefined` there, and NOTHING IN THIS LIBRARY FILLS THEM IN ANY
+ * `state` plus the two `_count` integers below (`sources`/`history` are `undefined`
+ * there) — `reasoning` and `verbatim` (SG-325) ship in both light and full mode, being
+ * short per-field strings rather than per-attempt arrays. NOTHING IN THIS LIBRARY FILLS
+ * `sources`/`history` IN ANY
  * MORE. They used to be lazy-fetched by the in-letter Inspector dialog, which is
  * deleted; the embedding app reads a data point's full detail against its own
  * session instead. A real production render was shipping every field's
@@ -110,8 +134,16 @@ export interface ExtractedCandidate {
     value: unknown;
     confidence: number | null;
     reasoning?: string | null;
-    /** verbatim | inferred — replaces the retired cited_text/cited_text_verified pair (SG-181). */
-    basis?: "verbatim" | "inferred" | null;
+    /**
+     * What the page literally says for this field — the two-value model (SG-323/SG-324/
+     * SG-325), replacing the retired `basis` discriminator (`verbatim` | `inferred`) the
+     * model used to classify its own output with, non-deterministically. `value` above is
+     * the inferred/normalized reading (or this same string when inference returned null);
+     * `verbatim` is never a provenance flag on `value` — both are first-class and either
+     * (or both) may be null. Consumers show them side by side, never hide `verbatim` when
+     * it equals `value`, and never reintroduce a quote-vs-derived badge.
+     */
+    verbatim?: string | null;
     sources?: VerificationSource[];
     /** Cheap `sources?.length` equivalent — present even when `sources` itself is not (SG-392). */
     sources_count?: number;
@@ -140,6 +172,12 @@ export interface ExtractedCandidate {
      * none of the SG-392 payload-size risk and `hasDiscrepancy()` needs it in light mode too.
      */
     source_discrepancy?: SourceDiscrepancy | null;
+    /**
+     * Non-null when this candidate's value was NORMALISED/typo-fixed by the block dedupe
+     * (SG-406) — a DIFFERENT fact from `source_discrepancy` above, never folded into
+     * `discrepancy`. Shipped in BOTH light and full mode, same argument as `source_discrepancy`.
+     */
+    correction?: Correction | null;
 }
 /**
  * One recorded attempt in a field's extraction history (SG-190). Mirrors the extracted
@@ -150,7 +188,8 @@ export interface VerificationHistoryEntry {
     value: unknown;
     confidence: number | null;
     reasoning?: string | null;
-    basis?: "verbatim" | "inferred" | null;
+    /** See {@link ExtractedCandidate.verbatim} — the same two-value model, per recorded attempt. */
+    verbatim?: string | null;
     state?: "present" | "absent" | "removed" | "failed" | null;
     /** True for the single live/winning attempt; false for losers/FAILED/superseded values. */
     is_chosen: boolean;
@@ -201,6 +240,13 @@ export interface DataPointMeta {
      * purposes — see {@link isSourceDiscrepancy} in `lib/discrepancy.ts`.
      */
     source_discrepancy?: SourceDiscrepancy | null;
+    /**
+     * Present (non-null) when the extracted candidate carries a `correction` (SG-406) — "we
+     * normalised/typo-fixed this value" provenance, distinct from `source_discrepancy` and
+     * deliberately NEVER folded into `discrepancy`. See {@link hasCorrection}/{@link correctionOf}
+     * in `lib/discrepancy.ts`.
+     */
+    correction?: Correction | null;
 }
 /** An object node in the rendered `data` tree carrying a keyed `__meta` map. */
 export type MetaCarrier = Record<string, unknown> & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thehammer/template-verification",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "Read-write verification overlay for rendered template apps — per-data-point confidence, discrepancy, 3-source resolution (override > extracted > claim), inline edit, and a recursive comparison page. Consumes the host's __meta sidecar; fetches nothing.",
   "license": "MIT",
   "type": "module",