@thehammer/template-verification 0.2.1 → 0.2.3

package/README.md

@@ -2,12 +2,27 @@
 
 A read-write **verification overlay** for rendered template apps. It overlays a
 trust layer on top of an already-rendered document template: per-data-point
-confidence/status icons, discrepancy indicators, a click-through detail modal,
-inline editing, and a recursive comparison page.
-
-The library **fetches nothing** — the host passes in the rendered `data` (with an
-embedded `__meta` sidecar) and a `saveOverride` transport via a single
-`initVerification()` call. It is backend-agnostic and unit-testable standalone.
+confidence pills + verified check chips, discrepancy indicators, and a
+click-through **Inspector** dialog — a hero strip (resolved value, gradient
+confidence meter, discrepancy alert) over three tabs:
+
+- **Evidence** — readonly-markdown reasoning, cited-text quote, an embedded
+  `DanxFileViewer` over the cited source pages, and per-document drill-down
+  to the FULL parent PDF in a stacked dialog.
+- **Candidates** — the resolution flow: one card per candidate
+  (override/extracted/claim) with Accept actions + custom-value entry;
+  saves toast and flip the in-document pill to a verified chip.
+- **Audit trail** — the LLM calls behind the data point (model, status,
+  timing, collapsible JSON request/response), lazy-fetched from the host's
+  token-sealed `audit_url`. Tab hidden when the host mints none.
+
+`VerificationChrome` adds a review-progress meter (X of Y human-verified),
+a needs-review jump button, and completion celebration.
+
+Render data + `__meta` arrive via a single `initVerification()` call — the
+only network the library touches is the host-supplied `saveOverride`
+transport and the optional `auditUrl` endpoint. Backend-agnostic and
+unit-testable standalone.
 
 ## Install
 
@@ -51,7 +66,9 @@ async function saveOverride(args) {
 initVerification({
   data: props.data,
   saveOverride,
-  workflowInputId: props.data.workflow_input_id
+  workflowInputId: props.data.__verification?.workflow_input_id,
+  // Token-sealed audit endpoint (optional) — enables the Inspector's Audit tab.
+  auditUrl: props.data.__verification?.audit_url ?? null
 })
 </script>
 

package/dist/lib/audit.d.ts

@@ -14,6 +14,13 @@ export interface AuditLlmCall {
     started_at?: string | null;
     request?: unknown;
     response?: unknown;
+    /**
+     * Which pipeline stage this call belongs to (e.g. "Data Extraction Directive") —
+     * the TaskOrchestrator name the host resolved this call's TaskWorker back to.
+     * Null when the host could not attribute a stage (see gpt-manager's
+     * DataPointAuditService for the current Extraction-only attribution scope).
+     */
+    stage?: string | null;
 }
 /**
  * Lazy-fetch the LLM-call trace for one data point. The anchor's NEAREST object

package/dist/lib/progress.d.ts

@@ -1,3 +1,4 @@
+import type { DataPointMeta } from "../types";
 /** Review-progress summary over a rendered data tree. */
 export interface VerificationProgress {
     /** Anchored data points (have a __meta entry) — the reviewable universe. */
@@ -9,6 +10,18 @@ export interface VerificationProgress {
     /** 0-100 integer percent (100 when total is 0 — nothing to review is "done"). */
     percent: number;
 }
+/**
+ * One data point's "needs review" predicate — the SAME criteria
+ * {@link computeProgress} tallies, exported so a single point can be classified
+ * outside a full-tree walk (e.g. {@link ../components/VerifiedField.vue} tags its
+ * own rendered DOM node so `VerificationChrome`'s jump-to-next-flagged button can
+ * find it via a plain `.tv-needs-review` query, without duplicating this logic).
+ *
+ * Unverified (no override candidate) AND (disagreeing OR extracted confidence is
+ * low (≤2) or absent — which includes a data point with NO extracted candidate
+ * at all, e.g. a field never covered by any extraction directive).
+ */
+export declare function pointNeedsReview(meta: DataPointMeta): boolean;
 /**
  * Compute review progress by walking the data tree ({@link walkDataPoints}).
  * "Verified" = an override candidate exists (a human explicitly locked a value —

package/dist/lib/sources.d.ts

@@ -18,8 +18,10 @@ export interface SourceGroup {
 }
 /**
  * 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 only when a `file_url`
- * is present on any of its sources.
+ * 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. */