@thehammer/template-verification 0.2.8 → 0.2.10

package/dist/components/AuditCallCard.vue.d.ts

@@ -1,4 +1,4 @@
-import type { AuditLlmCall } from "../lib/audit";
+import type { AuditLlmCall } from "../lib/dataPointDetail";
 /**
  * One LLM call in the Inspector's Audit trail — model/service chips, status +
  * timing header, and collapsible JSON request/response viewers (danx-ui

package/dist/components/VerificationModal.vue.d.ts

@@ -14,8 +14,20 @@ import type { DataPointMeta, SourceChoice } from "../types";
  *  - History: the live value's confidence + reasoning above the full extraction
  *    history; every attempt (winner, losers, FAILED) collapses to a summary row
  *    and expands to its own reasoning and page-grouped citations.
- *  - Audit trail: lazily fetched LLM calls (token-sealed host endpoint) rendered
- *    as AuditCallCards; hidden entirely when the host minted no audit_url.
+ *  - Audit trail: every LLM call the pipeline made for this field; hidden
+ *    entirely when the host minted no `detail_url`.
+ *
+ * SG-392: `props.meta.candidates.extracted` may be LIGHT (no `sources`/
+ * `history` — the base template render never ships those, only their
+ * `*_count`; see `types.ts`'s `ExtractedCandidate` docblock for why). The
+ * instant this dialog opens, it fetches the FULL detail (citation sources +
+ * extraction history + the LLM audit trace, all in one request — one host
+ * endpoint, `verification.detailUrl`) and merges it in; `extracted` (the
+ * merged computed) below is what every tab actually reads. A caller that already passed a FULL
+ * `extracted` (e.g. the live meta right after a save, which always carries
+ * full detail) is used as-is — the fetch still fires (the audit trace is
+ * needed either way) but never clobbers already-present sources/history with
+ * an absent one.
  *
  * `save` is null when the field is read-only (no transport / no anchor) — the
  * resolution actions are hidden in that case.

package/dist/constants.d.ts

@@ -1,6 +1,6 @@
 /**
  * Class applied to EVERY piece of library chrome (settings button + panel,
- * overlay icons, discrepancy indicators, comparison-page trigger, modal). A single
+ * overlay icons, discrepancy indicators, modal). A single
  * `@media print` rule hides all of it so the host template prints/exports clean —
  * the library never touches the host's own content. Kept as a constant so
  * components and the print-chrome regression test agree on one source of truth.

package/dist/context.d.ts

@@ -27,11 +27,14 @@ export interface InitVerificationConfig {
     /** Opaque workflow input id echoed back in saves. */
     workflowInputId?: number | string | null;
     /**
-     * Token-sealed audit endpoint base (`__verification.audit_url` from the host).
-     * Present ⇒ the Inspector's Audit tab lazy-loads a data point's LLM-call trace
-     * from `{auditUrl}?object_id=&field=`. Absent ⇒ the Audit tab is hidden.
+     * Token-sealed per-field detail endpoint base (`__verification.detail_url` from
+     * the host). Present ⇒ the Inspector dialog lazy-loads a data point's full
+     * citation sources, extraction history, and LLM-call audit trace from
+     * `{detailUrl}?object_id=&field=` the instant it opens for that field (SG-392).
+     * Absent ⇒ the Audit tab is hidden, and the base render's light `extracted`
+     * candidate (see `types.ts`) is all any tab ever shows.
      */
-    auditUrl?: string | null;
+    detailUrl?: string | null;
     /** Seeds the overlay toggle ONLY when localStorage holds no prior value. */
     defaultEnabled?: boolean;
     /**
@@ -54,12 +57,10 @@ export interface Verification {
     saveOverride?: SaveOverrideFn;
     /** Opaque workflow input id echoed back in saves. */
     workflowInputId?: number | string | null;
-    /** Token-sealed audit endpoint base; null/absent hides the Audit tab. */
-    auditUrl?: string | null;
+    /** Token-sealed per-field detail endpoint base; null/absent hides the Audit tab. */
+    detailUrl?: string | null;
     /** True while the host is fetching a new data source; see {@link InitVerificationConfig.loading}. */
     loading: boolean;
-    /** Open the comparison page (rendered by `<VerificationChrome>`). */
-    openComparison: () => void;
 }
 /**
  * Establish the app-wide verification config. Call ONCE at App.vue root setup —
@@ -75,11 +76,6 @@ export declare function initVerification(config: InitVerificationConfig): void;
  * advanced hosts.
  */
 export declare function useVerification(): Verification;
-/**
- * @internal Binds the comparison dialog's open-state for `<VerificationChrome>`.
- * Not part of the public surface — chrome and `openComparison()` share one ref.
- */
-export declare function useComparisonDialog(): Ref<boolean>;
 /**
  * @internal Test-only: clear the module singleton so each test starts from the
  * uninitialized state. Not exported from the package entry point.

package/dist/index.d.ts

@@ -1,10 +1,13 @@
 /**
  * @thehammer/template-verification — read-write verification overlay for rendered
  * template apps. Consumes the host's `__meta` sidecar (override > extracted >
- * claim resolution + discrepancy), overlays confidence/status icons, a
- * click-through detail modal with inline + modal-driven override editing, and a
- * recursive comparison page. Fetches nothing — the host calls `initVerification`
- * once with `data` and an optional `saveOverride` transport.
+ * claim resolution + discrepancy), overlays confidence/status icons, and a
+ * click-through Inspector dialog with inline + modal-driven override editing.
+ * The host calls `initVerification` once with `data` and an optional
+ * `saveOverride` transport. SG-392: the base `__meta` is LIGHT (no citation
+ * sources/history — only their `*_count`); the ONE thing this library fetches
+ * on its own is that full per-field detail, via `detailUrl`, the instant the
+ * Inspector dialog opens for a field (see `fetchDataPointDetail`).
  */
 import "./styles.css";
 export { initVerification, useVerification } from "./context";
@@ -13,7 +16,6 @@ export { default as VerifiedField } from "./components/VerifiedField.vue";
 export { default as VerificationChrome } from "./components/VerificationChrome.vue";
 export { default as ConfidenceIcon } from "./components/ConfidenceIcon.vue";
 export { default as VerificationModal } from "./components/VerificationModal.vue";
-export { default as ComparisonPage } from "./components/ComparisonPage.vue";
 export { default as CitationEvidence } from "./components/CitationEvidence.vue";
 export { default as CitationPageList } from "./components/CitationPageList.vue";
 export { default as CitationPage } from "./components/CitationPage.vue";
@@ -26,7 +28,7 @@ export { citationEvidence, citationSummary } from "./lib/citations";
 export type { CitationPage as CitationPageModel, CitationEvidence as CitationEvidenceModel } from "./lib/citations";
 export { computeProgress } from "./lib/progress";
 export type { VerificationProgress } from "./lib/progress";
-export { fetchDataPointAudit } from "./lib/audit";
-export type { AuditLlmCall } from "./lib/audit";
+export { fetchDataPointDetail } from "./lib/dataPointDetail";
+export type { AuditLlmCall, DataPointDetail } from "./lib/dataPointDetail";
 export { CHROME_CLASS, ENABLED_STORAGE_KEY } from "./constants";
 export type { VerificationStatus, ResolvedSource, SourceChoice, VerificationSource, ExtractedCandidate, OverrideCandidate, ClaimCandidate, CandidateSet, DataPointAnchor, ResolvedValue, DataPointMeta, MetaCarrier, SaveOverrideArgs, SaveOverrideFn, } from "./types";

package/dist/lib/dataPointDetail.d.ts

@@ -0,0 +1,41 @@
+import type { DataPointAnchor, ExtractedCandidate } from "../types";
+/**
+ * One sanitized LLM call from the host's token-sealed data-point detail endpoint
+ * (gpt-manager `TemplateRenderDataController::dataPointDetail()`).
+ * Request/response are the raw JSON payloads the team owns; headers/stack traces
+ * never ship.
+ */
+export interface AuditLlmCall {
+    id: number | string;
+    service?: string | null;
+    endpoint?: string | null;
+    model?: string | null;
+    status_code?: number | null;
+    run_time_ms?: number | null;
+    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;
+}
+/** One host detail-endpoint response — the full candidate + its LLM-call trace. */
+export interface DataPointDetail {
+    /** The full extracted candidate (sources/history included), or null when the
+     * field has no verification provenance at all. */
+    extracted: ExtractedCandidate | null;
+    audit: AuditLlmCall[];
+}
+/**
+ * Lazy-fetch the FULL detail for one data point (SG-392): its citation sources,
+ * full extraction history, and the LLM-call trace behind it, all in ONE request.
+ * The anchor's NEAREST object id + leaf field identify the attribute; the host
+ * re-resolves its sources server-side (the client never names ApiLog ids). Throws
+ * on a non-OK response — callers surface the failure state; an empty `audit`
+ * array or a null `extracted` is a valid "nothing there" result, not an error.
+ */
+export declare function fetchDataPointDetail(detailUrl: string, anchor: DataPointAnchor): Promise<DataPointDetail>;