@thehammer/template-verification 0.2.5 → 0.2.7

package/dist/types.d.ts

@@ -8,8 +8,13 @@
  * entry is a {@link DataPointMeta} describing that one field's verification state.
  */
 import type { PreviewFile } from "@thehammer/danx-ui";
-/** Status bucket derived from the integer 1-5 confidence (orthogonal to discrepancy). */
-export type VerificationStatus = "high" | "medium" | "low" | "unverifiable";
+/**
+ * Status bucket derived from the integer 1-5 confidence (orthogonal to discrepancy),
+ * plus 'failed' (SG-189) — a distinct extraction/citation-correction OUTCOME, not a
+ * confidence bucket. 'failed' is resolved from the extracted candidate's `state`
+ * field, never from bucketing a confidence integer.
+ */
+export type VerificationStatus = "high" | "medium" | "low" | "unverifiable" | "failed";
 /** The winning candidate key for a resolved data point, or `none` when no candidate exists. */
 export type ResolvedSource = "override" | "extracted" | "claim" | "none";
 /** The basis a user picked when saving an override. */
@@ -27,6 +32,12 @@ export interface VerificationSource {
     explanation?: string | null;
     stored_file_id?: number | string | null;
     agent_thread_message_id?: number | string | null;
+    /**
+     * Ordered verbatim snippets cited on this source's page (SG-181 — replaces the
+     * retired attribute-level `cited_text` column). Empty only when the page has no
+     * text transcript at all (image-only).
+     */
+    texts?: string[] | null;
     file_id?: number | string;
     page?: number;
     file_url?: string;
@@ -54,9 +65,41 @@ export interface ExtractedCandidate {
     value: unknown;
     confidence: number | null;
     reasoning?: string | null;
-    cited_text?: string | null;
-    cited_text_verified?: boolean | null;
+    /** verbatim | inferred — replaces the retired cited_text/cited_text_verified pair (SG-181). */
+    basis?: "verbatim" | "inferred" | null;
+    sources?: VerificationSource[];
+    /**
+     * Extraction/citation-correction outcome (SG-189). 'failed' means extraction/
+     * citation-correction failed for this field; when 'failed', `reasoning` carries
+     * the failure explanation instead of citation reasoning. Undefined/null for
+     * candidates predating this field.
+     */
+    state?: "extracted" | "corrected" | "failed" | "absent" | null;
+    /**
+     * The full per-field extraction history (SG-190) — every recorded attempt for this
+     * field, oldest first, including the live winner and every non-live loser / FAILED
+     * candidate / superseded value. The verification layer drills into this to show each
+     * attempt's timestamp, provenance, and confidence, with the chosen entry marked.
+     * Undefined for hosts predating SG-190.
+     */
+    history?: VerificationHistoryEntry[];
+}
+/**
+ * One recorded attempt in a field's extraction history (SG-190). Mirrors the extracted
+ * candidate's provenance plus `is_chosen` (the single live winner) and its timestamp.
+ */
+export interface VerificationHistoryEntry {
+    id?: number | string;
+    value: unknown;
+    confidence: number | null;
+    reasoning?: string | null;
+    basis?: "verbatim" | "inferred" | null;
+    state?: "extracted" | "corrected" | "failed" | "absent" | null;
+    /** True for the single live/winning attempt; false for losers/FAILED/superseded values. */
+    is_chosen: boolean;
+    page?: number | null;
     sources?: VerificationSource[];
+    created_at?: string | null;
 }
 /** A user-saved override candidate — always the highest-priority resolution. */
 export interface OverrideCandidate {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thehammer/template-verification",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "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",
@@ -43,6 +43,7 @@
     "@thehammer/danx-ui": "^0.8.17",
     "@vitejs/plugin-vue": "^5.0.0",
     "@vue/test-utils": "^2.4.6",
+    "@vueuse/core": "^14.4.0",
     "happy-dom": "^20.3.9",
     "tailwindcss": "^4.0.0",
     "typescript": "~5.4.0",

package/dist/lib/sources.d.ts

@@ -1,28 +0,0 @@
-import type { PreviewFile } from "@thehammer/danx-ui";
-import type { VerificationSource } from "../types";
-/** A set of sources sharing one file identity, for grouped rendering in the modal. */
-export interface SourceGroup {
-    /** Display label for the file (file_name, then a derived id, then a fallback). */
-    fileLabel: string;
-    /** A view/download URL when the host resolved one; the group links only when set. */
-    fileUrl?: string;
-    /**
-     * The resolved StoredFile (danx-ui `PreviewFile`-shaped), when the host resolved
-     * one — renders a real `DanxFile` thumbnail + `DanxFileViewer` preview. Falls back
-     * to the plain `fileLabel`/`fileUrl` text link when absent (host predates file
-     * resolution, or the source has no linked file).
-     */
-    file?: PreviewFile | null;
-    /** The sources belonging to this file. */
-    sources: VerificationSource[];
-}
-/**
- * Group an extracted candidate's sources by file identity so the modal can render
- * one block per file with its pages beneath. Links a group when a `file_url` (the
- * idealized shape) is present on any of its sources, falling back to the resolved
- * `file.url` (the live gpt-manager backend shape — `TemplateDataResource` never
- * emits `file_url`, only `file: {id,name,url,mime,size,thumb}`).
- */
-export declare function groupSources(sources?: VerificationSource[] | null): SourceGroup[];
-/** Human page/citation label for a single source row. */
-export declare function sourceRowLabel(source: VerificationSource): string;