@claritylabs/cl-sdk 0.9.0 → 0.10.1

package/dist/index.mjs

@@ -489,7 +489,9 @@ var FormReferenceSchema = z3.object({
   formNumber: z3.string(),
   editionDate: z3.string().optional(),
   title: z3.string().optional(),
-  formType: z3.enum(["coverage", "endorsement", "declarations", "application", "notice", "other"])
+  formType: z3.enum(["coverage", "endorsement", "declarations", "application", "notice", "other"]),
+  pageStart: z3.number().optional(),
+  pageEnd: z3.number().optional()
 });
 var TaxFeeItemSchema = z3.object({
   name: z3.string(),
@@ -526,12 +528,25 @@ var NamedInsuredSchema = z3.object({
 
 // src/schemas/coverage.ts
 import { z as z4 } from "zod";
+var CoverageValueTypeSchema = z4.enum([
+  "numeric",
+  "included",
+  "not_included",
+  "as_stated",
+  "waiting_period",
+  "referential",
+  "other"
+]);
 var CoverageSchema = z4.object({
   name: z4.string(),
   limit: z4.string(),
+  limitValueType: CoverageValueTypeSchema.optional(),
   deductible: z4.string().optional(),
+  deductibleValueType: CoverageValueTypeSchema.optional(),
+  formNumber: z4.string().optional(),
   pageNumber: z4.number().optional(),
-  sectionRef: z4.string().optional()
+  sectionRef: z4.string().optional(),
+  originalContent: z4.string().optional()
 });
 var EnrichedCoverageSchema = z4.object({
   name: z4.string(),
@@ -540,8 +555,10 @@ var EnrichedCoverageSchema = z4.object({
   formEditionDate: z4.string().optional(),
   limit: z4.string(),
   limitType: LimitTypeSchema.optional(),
+  limitValueType: CoverageValueTypeSchema.optional(),
   deductible: z4.string().optional(),
   deductibleType: DeductibleTypeSchema.optional(),
+  deductibleValueType: CoverageValueTypeSchema.optional(),
   sir: z4.string().optional(),
   sublimit: z4.string().optional(),
   coinsurance: z4.string().optional(),
@@ -552,7 +569,8 @@ var EnrichedCoverageSchema = z4.object({
   included: z4.boolean(),
   premium: z4.string().optional(),
   pageNumber: z4.number().optional(),
-  sectionRef: z4.string().optional()
+  sectionRef: z4.string().optional(),
+  originalContent: z4.string().optional()
 });
 
 // src/schemas/endorsement.ts
@@ -1569,6 +1587,7 @@ function assembleDocument(documentId, documentType, memory) {
   const lossHistory = memory.get("loss_history");
   const sections = memory.get("sections");
   const supplementary = memory.get("supplementary");
+  const formInventory = memory.get("form_inventory");
   const classify = memory.get("classify");
   const base = {
     id: documentId,
@@ -1585,6 +1604,7 @@ function assembleDocument(documentId, documentType, memory) {
     exclusions: exclusions?.exclusions,
     conditions: conditions?.conditions,
     sections: sections?.sections,
+    formInventory: formInventory?.forms,
     declarations: declarations ? sanitizeNulls(declarations) : void 0,
     ...sanitizeNulls(lossHistory ?? {})
   };
@@ -1826,6 +1846,11 @@ async function formatDocumentContent(doc, generateText, options) {
 function chunkDocument(doc) {
   const chunks = [];
   const docId = doc.id;
+  function stringMetadata(entries) {
+    return Object.fromEntries(
+      Object.entries(entries).filter(([, value]) => value !== void 0 && value !== null && String(value).length > 0).map(([key, value]) => [key, String(value)])
+    );
+  }
   chunks.push({
     id: `${docId}:carrier_info:0`,
     documentId: docId,
@@ -1837,7 +1862,7 @@ function chunkDocument(doc) {
       doc.carrierAmBestRating ? `AM Best: ${doc.carrierAmBestRating}` : null,
       doc.mga ? `MGA: ${doc.mga}` : null
     ].filter(Boolean).join("\n"),
-    metadata: { carrier: doc.carrier, documentType: doc.type }
+    metadata: stringMetadata({ carrier: doc.carrier, documentType: doc.type })
   });
   chunks.push({
     id: `${docId}:named_insured:0`,
@@ -1849,17 +1874,32 @@ function chunkDocument(doc) {
       doc.insuredFein ? `FEIN: ${doc.insuredFein}` : null,
       doc.insuredAddress ? `Address: ${doc.insuredAddress.street1}, ${doc.insuredAddress.city}, ${doc.insuredAddress.state} ${doc.insuredAddress.zip}` : null
     ].filter(Boolean).join("\n"),
-    metadata: { insuredName: doc.insuredName, documentType: doc.type }
+    metadata: stringMetadata({ insuredName: doc.insuredName, documentType: doc.type })
   });
   doc.coverages.forEach((cov, i) => {
     chunks.push({
       id: `${docId}:coverage:${i}`,
       documentId: docId,
       type: "coverage",
-      text: `Coverage: ${cov.name}
-Limit: ${cov.limit}${cov.deductible ? `
-Deductible: ${cov.deductible}` : ""}`,
-      metadata: { coverageName: cov.name, limit: cov.limit, documentType: doc.type }
+      text: [
+        `Coverage: ${cov.name}`,
+        `Limit: ${cov.limit}`,
+        cov.limitValueType ? `Limit Type: ${cov.limitValueType}` : null,
+        cov.deductible ? `Deductible: ${cov.deductible}` : null,
+        cov.deductibleValueType ? `Deductible Type: ${cov.deductibleValueType}` : null,
+        cov.originalContent ? `Source: ${cov.originalContent}` : null
+      ].filter(Boolean).join("\n"),
+      metadata: stringMetadata({
+        coverageName: cov.name,
+        limit: cov.limit,
+        limitValueType: cov.limitValueType,
+        deductible: cov.deductible,
+        deductibleValueType: cov.deductibleValueType,
+        formNumber: cov.formNumber,
+        pageNumber: cov.pageNumber,
+        sectionRef: cov.sectionRef,
+        documentType: doc.type
+      })
     });
   });
   doc.endorsements?.forEach((end, i) => {
@@ -1869,7 +1909,13 @@ Deductible: ${cov.deductible}` : ""}`,
       type: "endorsement",
       text: `Endorsement: ${end.title}
 ${end.content}`.trim(),
-      metadata: { endorsementType: end.endorsementType, formNumber: end.formNumber, documentType: doc.type }
+      metadata: stringMetadata({
+        endorsementType: end.endorsementType,
+        formNumber: end.formNumber,
+        pageStart: end.pageStart,
+        pageEnd: end.pageEnd,
+        documentType: doc.type
+      })
     });
   });
   doc.exclusions?.forEach((exc, i) => {
@@ -1879,7 +1925,7 @@ ${end.content}`.trim(),
       type: "exclusion",
       text: `Exclusion: ${exc.name}
 ${exc.content}`.trim(),
-      metadata: { documentType: doc.type }
+      metadata: stringMetadata({ formNumber: exc.formNumber, pageNumber: exc.pageNumber, documentType: doc.type })
     });
   });
   doc.sections?.forEach((sec, i) => {
@@ -1889,7 +1935,7 @@ ${exc.content}`.trim(),
       type: "section",
       text: `Section: ${sec.title}
 ${sec.content}`,
-      metadata: { sectionType: sec.type, documentType: doc.type }
+      metadata: stringMetadata({ sectionType: sec.type, pageStart: sec.pageStart, pageEnd: sec.pageEnd, documentType: doc.type })
     });
   });
   if (doc.premium) {
@@ -1899,7 +1945,7 @@ ${sec.content}`,
       type: "premium",
       text: `Premium: ${doc.premium}${doc.totalCost ? `
 Total Cost: ${doc.totalCost}` : ""}`,
-      metadata: { premium: doc.premium, documentType: doc.type }
+      metadata: stringMetadata({ premium: doc.premium, documentType: doc.type })
     });
   }
   return chunks;
@@ -1951,12 +1997,19 @@ function mergeCoverageLimits(existing, incoming) {
   const merged = mergeShallowPreferPresent(existing, incoming);
   const existingCoverages = Array.isArray(existing.coverages) ? existing.coverages : [];
   const incomingCoverages = Array.isArray(incoming.coverages) ? incoming.coverages : [];
-  merged.coverages = mergeUniqueObjects(existingCoverages, incomingCoverages, (coverage) => [
+  const coverageKey = (coverage) => [
     String(coverage.name ?? "").toLowerCase(),
     String(coverage.limit ?? "").toLowerCase(),
     String(coverage.deductible ?? "").toLowerCase(),
     String(coverage.formNumber ?? "").toLowerCase()
-  ].join("|"));
+  ].join("|");
+  const byKey = /* @__PURE__ */ new Map();
+  for (const coverage of [...existingCoverages, ...incomingCoverages]) {
+    const key = coverageKey(coverage);
+    const current = byKey.get(key);
+    byKey.set(key, current ? mergeShallowPreferPresent(current, coverage) : coverage);
+  }
+  merged.coverages = [...byKey.values()];
   return merged;
 }
 function mergeDeclarations(existing, incoming) {
@@ -2813,9 +2866,45 @@ Return JSON only:
 }`;
 }
 
-// src/prompts/coordinator/page-map.ts
+// src/prompts/coordinator/form-inventory.ts
 import { z as z19 } from "zod";
-var PageExtractorSchema = z19.enum([
+var FormInventoryEntrySchema = FormReferenceSchema.extend({
+  formNumber: FormReferenceSchema.shape.formNumber.describe("Form number or identifier, e.g. PR5070CF"),
+  pageStart: FormReferenceSchema.shape.pageStart.describe("Original document page where the form begins"),
+  pageEnd: FormReferenceSchema.shape.pageEnd.describe("Original document page where the form ends")
+});
+var FormInventorySchema = z19.object({
+  forms: z19.array(FormInventoryEntrySchema)
+});
+function buildFormInventoryPrompt(templateHints) {
+  return `You are building a form inventory for an insurance document.
+
+DOCUMENT TYPE HINTS:
+${templateHints}
+
+Extract every distinct declarations page set, policy form, coverage form, endorsement, application form, and notice form that appears in the document.
+
+For EACH form, extract:
+- formNumber: REQUIRED when present
+- editionDate: if shown
+- title: if shown
+- formType: one of coverage, endorsement, declarations, application, notice, other
+- pageStart: original page where the form begins
+- pageEnd: original page where the form ends
+
+Critical rules:
+- Include declarations page sets even if they do not show a standard form number.
+- Use original document page numbers, not local chunk page numbers.
+- Do not emit duplicate entries for repeated headers/footers.
+- Multi-page forms should be represented once with pageStart/pageEnd covering the full span when visible.
+- If a form number is visible in endorsements, schedules, or form headers, include it even if the full form title is partial.
+
+Respond with JSON only.`;
+}
+
+// src/prompts/coordinator/page-map.ts
+import { z as z20 } from "zod";
+var PageExtractorSchema = z20.enum([
   "carrier_info",
   "named_insured",
   "coverage_limits",
@@ -2828,23 +2917,37 @@ var PageExtractorSchema = z19.enum([
   "sections",
   "supplementary"
 ]);
-var PageAssignmentSchema = z19.object({
-  localPageNumber: z19.number().int().positive().describe("1-based page number within this supplied PDF chunk"),
-  extractorNames: z19.array(PageExtractorSchema).describe("Focused extractors that should inspect this page"),
-  confidence: z19.number().min(0).max(1).optional().describe("Confidence in the page assignment"),
-  notes: z19.string().optional().describe("Short explanation of what appears on the page")
+var PageAssignmentSchema = z20.object({
+  localPageNumber: z20.number().int().positive().describe("1-based page number within this supplied PDF chunk"),
+  extractorNames: z20.array(PageExtractorSchema).describe("Focused extractors that should inspect this page"),
+  pageRole: z20.enum([
+    "declarations_schedule",
+    "endorsement_schedule",
+    "policy_form",
+    "endorsement_form",
+    "condition_exclusion_form",
+    "supplementary",
+    "other"
+  ]).optional().describe("Primary role of the page"),
+  hasScheduleValues: z20.boolean().optional().describe("True only when the page contains insured-specific declaration or schedule values, tables, or rows to extract"),
+  confidence: z20.number().min(0).max(1).optional().describe("Confidence in the page assignment"),
+  notes: z20.string().optional().describe("Short explanation of what appears on the page")
 });
-var PageMapChunkSchema = z19.object({
-  pages: z19.array(PageAssignmentSchema)
+var PageMapChunkSchema = z20.object({
+  pages: z20.array(PageAssignmentSchema)
 });
-function buildPageMapPrompt(templateHints, startPage, endPage) {
+function buildPageMapPrompt(templateHints, startPage, endPage, formInventoryHint) {
+  const inventoryBlock = formInventoryHint ? `
+FORM INVENTORY (already identified \u2014 use this to constrain your assignments):
+${formInventoryHint}
+` : "";
   return `You are mapping insurance document pages to focused extractors.
 
 These supplied pages are ORIGINAL DOCUMENT PAGES ${startPage}-${endPage}.
 
 DOCUMENT TYPE HINTS:
 ${templateHints}
-
+${inventoryBlock}
 For each page in this supplied PDF chunk, decide which extractor(s) should inspect it.
 
 Available extractors:
@@ -2866,7 +2969,11 @@ Rules:
 - Avoid assigning broad ranges mentally; decide page by page.
 - A page may map to multiple extractors if it legitimately contains multiple relevant sections.
 - Prefer declarations and schedules for numeric limits/deductibles over later generic form wording.
-- If a page is mostly generic form language with no declaration-specific values, do not assign "coverage_limits" unless it clearly contains schedule-specific limits.
+- Assign "coverage_limits" only when the page itself contains insured-specific declaration or schedule values to capture, such as location/building rows, coverage tables, limits, deductibles, coinsurance percentages, or scheduled amounts tied to this policy.
+- Do NOT assign "coverage_limits" for generic policy-form or endorsement text that merely explains how limits, deductibles, waiting periods, or coinsurance work, or that says values are "shown in the declarations", "shown in the schedule", "as stated", or "if applicable".
+- Headings like "Limits of Insurance", "Deductible", "Coinsurance", "Loss Conditions", or "Definitions" inside a policy form usually indicate form language, not declarations or schedules.
+- Continuation pages near the end of a form should stay mapped to "sections" plus "conditions"/"exclusions" when applicable, even if they mention limits or deductibles.
+- When a form inventory entry identifies a page range as a specific form type (e.g., endorsement, coverage, application), use that classification to guide your extractor choice. Do not assign "coverage_limits" to pages the inventory identifies as endorsement or condition/exclusion forms unless the page contains actual schedule values.
 - Return every page in the supplied chunk exactly once.
 
 Return JSON:
@@ -2875,6 +2982,8 @@ Return JSON:
     {
       "localPageNumber": 1,
       "extractorNames": ["declarations", "carrier_info", "named_insured", "coverage_limits"],
+      "pageRole": "declarations_schedule",
+      "hasScheduleValues": true,
       "confidence": 0.96,
       "notes": "Declarations page with insured, policy period, and scheduled limits"
     }
@@ -2883,18 +2992,26 @@ Return JSON:
 
 Respond with JSON only.`;
 }
+function formatFormInventoryForPageMap(forms) {
+  if (forms.length === 0) return "";
+  return forms.filter((f) => f.pageStart != null).map((f) => {
+    const range = f.pageEnd && f.pageEnd !== f.pageStart ? `pages ${f.pageStart}-${f.pageEnd}` : `page ${f.pageStart}`;
+    const title = f.title ? ` "${f.title}"` : "";
+    return `- ${f.formNumber}${title} [${f.formType}] \u2192 ${range}`;
+  }).join("\n");
+}
 
 // src/prompts/coordinator/review.ts
-import { z as z20 } from "zod";
-var ReviewResultSchema = z20.object({
-  complete: z20.boolean(),
-  missingFields: z20.array(z20.string()),
-  qualityIssues: z20.array(z20.string()).optional(),
-  additionalTasks: z20.array(z20.object({
-    extractorName: z20.string(),
-    startPage: z20.number(),
-    endPage: z20.number(),
-    description: z20.string()
+import { z as z21 } from "zod";
+var ReviewResultSchema = z21.object({
+  complete: z21.boolean(),
+  missingFields: z21.array(z21.string()),
+  qualityIssues: z21.array(z21.string()).optional(),
+  additionalTasks: z21.array(z21.object({
+    extractorName: z21.string(),
+    startPage: z21.number(),
+    endPage: z21.number(),
+    description: z21.string()
   }))
 });
 function buildReviewPrompt(templateExpected, extractedKeys, extractionSummary, pageMapSummary) {
@@ -2941,20 +3058,20 @@ Respond with JSON only.`;
 }
 
 // src/prompts/extractors/carrier-info.ts
-import { z as z21 } from "zod";
-var CarrierInfoSchema = z21.object({
-  carrierName: z21.string().describe("Primary insurance company name for display"),
-  carrierLegalName: z21.string().optional().describe("Legal entity name of insurer"),
-  naicNumber: z21.string().optional().describe("NAIC company code"),
-  amBestRating: z21.string().optional().describe("AM Best rating, e.g. 'A+ XV'"),
-  admittedStatus: z21.enum(["admitted", "non_admitted", "surplus_lines"]).optional().describe("Admitted status of the carrier"),
-  mga: z21.string().optional().describe("Managing General Agent or Program Administrator name"),
-  underwriter: z21.string().optional().describe("Named individual underwriter"),
-  policyNumber: z21.string().optional().describe("Policy or quote reference number"),
-  effectiveDate: z21.string().optional().describe("Policy effective date (MM/DD/YYYY)"),
-  expirationDate: z21.string().optional().describe("Policy expiration date (MM/DD/YYYY)"),
-  quoteNumber: z21.string().optional().describe("Quote or proposal reference number"),
-  proposedEffectiveDate: z21.string().optional().describe("Proposed effective date for quotes (MM/DD/YYYY)")
+import { z as z22 } from "zod";
+var CarrierInfoSchema = z22.object({
+  carrierName: z22.string().describe("Primary insurance company name for display"),
+  carrierLegalName: z22.string().optional().describe("Legal entity name of insurer"),
+  naicNumber: z22.string().optional().describe("NAIC company code"),
+  amBestRating: z22.string().optional().describe("AM Best rating, e.g. 'A+ XV'"),
+  admittedStatus: z22.enum(["admitted", "non_admitted", "surplus_lines"]).optional().describe("Admitted status of the carrier"),
+  mga: z22.string().optional().describe("Managing General Agent or Program Administrator name"),
+  underwriter: z22.string().optional().describe("Named individual underwriter"),
+  policyNumber: z22.string().optional().describe("Policy or quote reference number"),
+  effectiveDate: z22.string().optional().describe("Policy effective date (MM/DD/YYYY)"),
+  expirationDate: z22.string().optional().describe("Policy expiration date (MM/DD/YYYY)"),
+  quoteNumber: z22.string().optional().describe("Quote or proposal reference number"),
+  proposedEffectiveDate: z22.string().optional().describe("Proposed effective date for quotes (MM/DD/YYYY)")
 });
 function buildCarrierInfoPrompt() {
   return `You are an expert insurance document analyst. Extract carrier and policy identification information from this document.
@@ -2974,18 +3091,18 @@ Return JSON only.`;
 }
 
 // src/prompts/extractors/named-insured.ts
-import { z as z22 } from "zod";
-var AddressSchema2 = z22.object({
-  street1: z22.string(),
-  city: z22.string(),
-  state: z22.string(),
-  zip: z22.string()
+import { z as z23 } from "zod";
+var AddressSchema2 = z23.object({
+  street1: z23.string(),
+  city: z23.string(),
+  state: z23.string(),
+  zip: z23.string()
 });
-var NamedInsuredSchema2 = z22.object({
-  insuredName: z22.string().describe("Name of primary named insured"),
-  insuredDba: z22.string().optional().describe("Doing-business-as name"),
+var NamedInsuredSchema2 = z23.object({
+  insuredName: z23.string().describe("Name of primary named insured"),
+  insuredDba: z23.string().optional().describe("Doing-business-as name"),
   insuredAddress: AddressSchema2.optional().describe("Primary insured mailing address"),
-  insuredEntityType: z22.enum([
+  insuredEntityType: z23.enum([
     "corporation",
     "llc",
     "partnership",
@@ -2998,13 +3115,13 @@ var NamedInsuredSchema2 = z22.object({
     "married_couple",
     "other"
   ]).optional().describe("Legal entity type of the insured"),
-  insuredFein: z22.string().optional().describe("Federal Employer Identification Number"),
-  insuredSicCode: z22.string().optional().describe("SIC code"),
-  insuredNaicsCode: z22.string().optional().describe("NAICS code"),
-  additionalNamedInsureds: z22.array(
-    z22.object({
-      name: z22.string(),
-      relationship: z22.string().optional().describe("e.g. subsidiary, affiliate"),
+  insuredFein: z23.string().optional().describe("Federal Employer Identification Number"),
+  insuredSicCode: z23.string().optional().describe("SIC code"),
+  insuredNaicsCode: z23.string().optional().describe("NAICS code"),
+  additionalNamedInsureds: z23.array(
+    z23.object({
+      name: z23.string(),
+      relationship: z23.string().optional().describe("e.g. subsidiary, affiliate"),
       address: AddressSchema2.optional()
     })
   ).optional().describe("Additional named insureds listed on the policy")
@@ -3025,23 +3142,20 @@ Return JSON only.`;
 }
 
 // src/prompts/extractors/coverage-limits.ts
-import { z as z23 } from "zod";
-var CoverageLimitsSchema = z23.object({
-  coverages: z23.array(
-    z23.object({
-      name: z23.string().describe("Coverage name"),
-      limit: z23.string().describe("Coverage limit, e.g. '$1,000,000'"),
-      deductible: z23.string().optional().describe("Deductible amount"),
-      coverageCode: z23.string().optional().describe("Coverage code or class code"),
-      formNumber: z23.string().optional().describe("Associated form number, e.g. 'CG 00 01'")
-    })
-  ).describe("All coverages with their limits"),
-  coverageForm: z23.enum(["occurrence", "claims_made", "accident"]).optional().describe("Primary coverage trigger type"),
-  retroactiveDate: z23.string().optional().describe("Retroactive date for claims-made policies (MM/DD/YYYY)")
+import { z as z24 } from "zod";
+var ExtractorCoverageSchema = CoverageSchema.extend({
+  coverageCode: z24.string().optional().describe("Coverage code or class code")
+});
+var CoverageLimitsSchema = z24.object({
+  coverages: z24.array(ExtractorCoverageSchema).describe("All coverages with their limits"),
+  coverageForm: z24.enum(["occurrence", "claims_made", "accident"]).optional().describe("Primary coverage trigger type"),
+  retroactiveDate: z24.string().optional().describe("Retroactive date for claims-made policies (MM/DD/YYYY)")
 });
 function buildCoverageLimitsPrompt() {
   return `You are an expert insurance document analyst. Extract all coverage limits and deductibles from this document.
 
+Extract only insured-specific declaration, schedule, or endorsement entries that state actual coverage terms for this policy.
+
 Focus on:
 - Every coverage listed on the declarations page or coverage schedule
 - Per-occurrence, aggregate, and sub-limits for each coverage
@@ -3052,20 +3166,34 @@ Focus on:
 - Standard limit fields: per occurrence, general aggregate, products/completed ops aggregate, personal & advertising injury, fire damage, medical expense, combined single limit, BI/PD splits, umbrella each occurrence/aggregate/retention, statutory (WC), employers liability
 - Defense cost treatment: inside limits, outside limits, or supplementary
 
-Extract ALL coverages \u2014 do not omit any coverage line that appears in the document.
+For EACH coverage, also extract:
+- pageNumber: the original page number where the coverage row/value appears
+- sectionRef: the declarations/schedule/endorsement section heading where it appears
+- originalContent: the verbatim row or short source snippet used for this coverage
+- limitValueType: classify the limit as numeric, included, not_included, as_stated, waiting_period, referential, or other
+- deductibleValueType: classify the deductible/value term similarly when deductible is present
+
+Critical rules:
+- Do not extract table-of-contents lines, index entries, headers, footers, page labels, or cross-references as coverages.
+- Do not create a coverage entry from generic policy-form text that only says a limit/deductible is "shown in the declarations", "shown in the Business Income Declarations", "as stated", "if applicable", or similar referential wording.
+- Do not treat a generic waiting period, deductible explanation, limits clause, coinsurance clause, or definitions text as a standalone coverage unless the page contains an actual policy-specific schedule row or declaration entry.
+- Values like "Included" or "Not Included" are valid only when they appear as an explicit declarations/schedule/endorsement entry for a named coverage. Do not infer them from narrative form language.
+- If a waiting period or hour deductible is shown as part of a specific declarations/schedule row, it may be captured in deductible. Otherwise omit it.
+- Use limitValueType or deductibleValueType to preserve non-numeric terms precisely instead of forcing them into numeric semantics.
+- Preserve one row per real coverage entry. Do not merge adjacent schedule rows into malformed names.
 
 Return JSON only.`;
 }
 
 // src/prompts/extractors/endorsements.ts
-import { z as z24 } from "zod";
-var EndorsementsSchema = z24.object({
-  endorsements: z24.array(
-    z24.object({
-      formNumber: z24.string().describe("Form number, e.g. 'CG 21 47'"),
-      editionDate: z24.string().optional().describe("Edition date, e.g. '12 07'"),
-      title: z24.string().describe("Endorsement title"),
-      endorsementType: z24.enum([
+import { z as z25 } from "zod";
+var EndorsementsSchema = z25.object({
+  endorsements: z25.array(
+    z25.object({
+      formNumber: z25.string().describe("Form number, e.g. 'CG 21 47'"),
+      editionDate: z25.string().optional().describe("Edition date, e.g. '12 07'"),
+      title: z25.string().describe("Endorsement title"),
+      endorsementType: z25.enum([
         "additional_insured",
         "waiver_of_subrogation",
         "primary_noncontributory",
@@ -3085,12 +3213,12 @@ var EndorsementsSchema = z24.object({
         "territorial_extension",
         "other"
       ]).describe("Endorsement type classification"),
-      effectiveDate: z24.string().optional().describe("Endorsement effective date"),
-      affectedCoverageParts: z24.array(z24.string()).optional().describe("Coverage parts affected by this endorsement"),
-      namedParties: z24.array(
-        z24.object({
-          name: z24.string().describe("Party name"),
-          role: z24.enum([
+      effectiveDate: z25.string().optional().describe("Endorsement effective date"),
+      affectedCoverageParts: z25.array(z25.string()).optional().describe("Coverage parts affected by this endorsement"),
+      namedParties: z25.array(
+        z25.object({
+          name: z25.string().describe("Party name"),
+          role: z25.enum([
             "additional_insured",
             "loss_payee",
             "mortgage_holder",
@@ -3099,15 +3227,15 @@ var EndorsementsSchema = z24.object({
             "designated_person",
             "other"
           ]).describe("Party role"),
-          relationship: z24.string().optional().describe("Relationship to insured"),
-          scope: z24.string().optional().describe("Scope of coverage for this party")
+          relationship: z25.string().optional().describe("Relationship to insured"),
+          scope: z25.string().optional().describe("Scope of coverage for this party")
         })
       ).optional().describe("Named parties (additional insureds, loss payees, etc.)"),
-      keyTerms: z24.array(z24.string()).optional().describe("Key terms or notable provisions in the endorsement"),
-      premiumImpact: z24.string().optional().describe("Additional premium or credit"),
-      content: z24.string().describe("Full verbatim text of the endorsement"),
-      pageStart: z24.number().describe("Starting page number of this endorsement"),
-      pageEnd: z24.number().optional().describe("Ending page number of this endorsement")
+      keyTerms: z25.array(z25.string()).optional().describe("Key terms or notable provisions in the endorsement"),
+      premiumImpact: z25.string().optional().describe("Additional premium or credit"),
+      content: z25.string().describe("Full verbatim text of the endorsement"),
+      pageStart: z25.number().describe("Starting page number of this endorsement"),
+      pageEnd: z25.number().optional().describe("Ending page number of this endorsement")
     })
   ).describe("All endorsements found in the document")
 });
@@ -3138,20 +3266,20 @@ Return JSON only.`;
 }
 
 // src/prompts/extractors/exclusions.ts
-import { z as z25 } from "zod";
-var ExclusionsSchema = z25.object({
-  exclusions: z25.array(
-    z25.object({
-      name: z25.string().describe("Exclusion title or short description"),
-      formNumber: z25.string().optional().describe("Form number if part of a named endorsement"),
-      excludedPerils: z25.array(z25.string()).optional().describe("Specific perils excluded"),
-      isAbsolute: z25.boolean().optional().describe("Whether the exclusion is absolute (no exceptions)"),
-      exceptions: z25.array(z25.string()).optional().describe("Exceptions to the exclusion, if any"),
-      buybackAvailable: z25.boolean().optional().describe("Whether coverage can be bought back via endorsement"),
-      buybackEndorsement: z25.string().optional().describe("Form number of the buyback endorsement if available"),
-      appliesTo: z25.array(z25.string()).optional().describe("Coverage types this exclusion applies to"),
-      content: z25.string().describe("Full verbatim exclusion text"),
-      pageNumber: z25.number().optional().describe("Page number where exclusion appears")
+import { z as z26 } from "zod";
+var ExclusionsSchema = z26.object({
+  exclusions: z26.array(
+    z26.object({
+      name: z26.string().describe("Exclusion title or short description"),
+      formNumber: z26.string().optional().describe("Form number if part of a named endorsement"),
+      excludedPerils: z26.array(z26.string()).optional().describe("Specific perils excluded"),
+      isAbsolute: z26.boolean().optional().describe("Whether the exclusion is absolute (no exceptions)"),
+      exceptions: z26.array(z26.string()).optional().describe("Exceptions to the exclusion, if any"),
+      buybackAvailable: z26.boolean().optional().describe("Whether coverage can be bought back via endorsement"),
+      buybackEndorsement: z26.string().optional().describe("Form number of the buyback endorsement if available"),
+      appliesTo: z26.array(z26.string()).optional().describe("Coverage types this exclusion applies to"),
+      content: z26.string().describe("Full verbatim exclusion text"),
+      pageNumber: z26.number().optional().describe("Page number where exclusion appears")
     })
   ).describe("All exclusions found in the document")
 });
@@ -3176,18 +3304,23 @@ Focus on:
 - Exclusions within insuring agreements or conditions if clearly labeled
 - Full verbatim exclusion text \u2014 do not summarize
 
+Critical rules:
+- Ignore table-of-contents entries, running headers/footers, and references that only point to another page or section.
+- Do not emit a standalone exclusion from a fragment unless the fragment itself contains substantive exclusion wording.
+- Always include pageNumber when the exclusion appears on a specific page in the supplied document chunk.
+
 Common personal lines exclusion patterns: animal liability, business pursuits, home daycare, watercraft, aircraft.
 
 Return JSON only.`;
 }
 
 // src/prompts/extractors/conditions.ts
-import { z as z26 } from "zod";
-var ConditionsSchema = z26.object({
-  conditions: z26.array(
-    z26.object({
-      name: z26.string().describe("Condition title"),
-      conditionType: z26.enum([
+import { z as z27 } from "zod";
+var ConditionsSchema = z27.object({
+  conditions: z27.array(
+    z27.object({
+      name: z27.string().describe("Condition title"),
+      conditionType: z27.enum([
         "duties_after_loss",
         "notice_requirements",
         "other_insurance",
@@ -3206,14 +3339,14 @@ var ConditionsSchema = z26.object({
         "separation_of_insureds",
         "other"
       ]).describe("Condition category"),
-      content: z26.string().describe("Full verbatim condition text"),
-      keyValues: z26.array(
-        z26.object({
-          key: z26.string().describe("Key name (e.g. 'noticePeriod', 'suitDeadline')"),
-          value: z26.string().describe("Value (e.g. '30 days', '2 years')")
+      content: z27.string().describe("Full verbatim condition text"),
+      keyValues: z27.array(
+        z27.object({
+          key: z27.string().describe("Key name (e.g. 'noticePeriod', 'suitDeadline')"),
+          value: z27.string().describe("Value (e.g. '30 days', '2 years')")
         })
       ).optional().describe("Key values extracted from the condition (notice periods, deadlines, etc.)"),
-      pageNumber: z26.number().optional().describe("Page number where condition appears")
+      pageNumber: z27.number().optional().describe("Page number where condition appears")
     })
   ).describe("All policy conditions found in the document")
 });
@@ -3225,7 +3358,7 @@ For EACH condition, extract:
 - conditionType: classify as one of: duties_after_loss, notice_requirements, other_insurance, cancellation, nonrenewal, transfer_of_rights, liberalization, arbitration, concealment_fraud, examination_under_oath, legal_action, loss_payment, appraisal, mortgage_holders, policy_territory, separation_of_insureds, other \u2014 REQUIRED
 - content: full verbatim condition text \u2014 REQUIRED
 - keyValues: extract specific values as key-value pairs (e.g. noticePeriod: "30 days", suitDeadline: "2 years")
-- pageNumber: page number where the condition appears
+- pageNumber: original document page number where the substantive condition text appears
 
 Focus on:
 - Duties after loss / notice of occurrence conditions
@@ -3242,32 +3375,37 @@ Focus on:
 - Mortgage holders clause
 - Any other named conditions
 
+Critical rules:
+- Ignore table-of-contents entries, section indexes, running headers/footers, and page references such as "Appraisal ..... 19".
+- Do not emit a condition unless the page contains substantive condition text, not just a heading or reference.
+- If a condition continues from a prior page, keep the substantive text together and use the page where the condition text appears in this extracted chunk.
+
 Return JSON only.`;
 }
 
 // src/prompts/extractors/premium-breakdown.ts
-import { z as z27 } from "zod";
-var PremiumBreakdownSchema = z27.object({
-  premium: z27.string().optional().describe("Total premium amount, e.g. '$5,000'"),
-  totalCost: z27.string().optional().describe("Total cost including taxes and fees, e.g. '$5,250'"),
-  premiumBreakdown: z27.array(
-    z27.object({
-      line: z27.string().describe("Coverage line name"),
-      amount: z27.string().describe("Premium amount for this line")
+import { z as z28 } from "zod";
+var PremiumBreakdownSchema = z28.object({
+  premium: z28.string().optional().describe("Total premium amount, e.g. '$5,000'"),
+  totalCost: z28.string().optional().describe("Total cost including taxes and fees, e.g. '$5,250'"),
+  premiumBreakdown: z28.array(
+    z28.object({
+      line: z28.string().describe("Coverage line name"),
+      amount: z28.string().describe("Premium amount for this line")
     })
   ).optional().describe("Per-coverage-line premium breakdown"),
-  taxesAndFees: z27.array(
-    z27.object({
-      name: z27.string().describe("Fee or tax name"),
-      amount: z27.string().describe("Dollar amount"),
-      type: z27.enum(["tax", "fee", "surcharge", "assessment"]).optional().describe("Fee category")
+  taxesAndFees: z28.array(
+    z28.object({
+      name: z28.string().describe("Fee or tax name"),
+      amount: z28.string().describe("Dollar amount"),
+      type: z28.enum(["tax", "fee", "surcharge", "assessment"]).optional().describe("Fee category")
     })
   ).optional().describe("Taxes, fees, surcharges, and assessments"),
-  minimumPremium: z27.string().optional().describe("Minimum premium if stated"),
-  depositPremium: z27.string().optional().describe("Deposit premium if stated"),
-  paymentPlan: z27.string().optional().describe("Payment plan description"),
-  auditType: z27.enum(["annual", "semi_annual", "quarterly", "monthly", "final", "self"]).optional().describe("Premium audit type"),
-  ratingBasis: z27.string().optional().describe("Rating basis, e.g. payroll, revenue, area, units")
+  minimumPremium: z28.string().optional().describe("Minimum premium if stated"),
+  depositPremium: z28.string().optional().describe("Deposit premium if stated"),
+  paymentPlan: z28.string().optional().describe("Payment plan description"),
+  auditType: z28.enum(["annual", "semi_annual", "quarterly", "monthly", "final", "self"]).optional().describe("Premium audit type"),
+  ratingBasis: z28.string().optional().describe("Rating basis, e.g. payroll, revenue, area, units")
 });
 function buildPremiumBreakdownPrompt() {
   return `You are an expert insurance document analyst. Extract all premium and cost information from this document.
@@ -3287,14 +3425,14 @@ Return JSON only.`;
 }
 
 // src/prompts/extractors/declarations.ts
-import { z as z28 } from "zod";
-var DeclarationsFieldSchema = z28.object({
-  field: z28.string().describe("Descriptive field name (e.g. 'policyNumber', 'effectiveDate', 'coverageALimit')"),
-  value: z28.string().describe("Extracted value exactly as it appears in the document"),
-  section: z28.string().optional().describe("Section or grouping this field belongs to (e.g. 'Coverage Limits', 'Vehicle Schedule')")
+import { z as z29 } from "zod";
+var DeclarationsFieldSchema = z29.object({
+  field: z29.string().describe("Descriptive field name (e.g. 'policyNumber', 'effectiveDate', 'coverageALimit')"),
+  value: z29.string().describe("Extracted value exactly as it appears in the document"),
+  section: z29.string().optional().describe("Section or grouping this field belongs to (e.g. 'Coverage Limits', 'Vehicle Schedule')")
 });
-var DeclarationsExtractSchema = z28.object({
-  fields: z28.array(DeclarationsFieldSchema).describe("All declarations page fields extracted as key-value pairs. Structure varies by line of business.")
+var DeclarationsExtractSchema = z29.object({
+  fields: z29.array(DeclarationsFieldSchema).describe("All declarations page fields extracted as key-value pairs. Structure varies by line of business.")
 });
 function buildDeclarationsPrompt() {
   return `You are an expert insurance document analyst. Extract all declarations page data from this document into a flexible key-value structure.
@@ -3334,21 +3472,21 @@ Preserve original values exactly as they appear. Return JSON only.`;
 }
 
 // src/prompts/extractors/loss-history.ts
-import { z as z29 } from "zod";
-var LossHistorySchema = z29.object({
-  lossSummary: z29.string().optional().describe("Summary of loss history, e.g. '3 claims in past 5 years totaling $125,000'"),
-  individualClaims: z29.array(
-    z29.object({
-      date: z29.string().optional().describe("Date of loss or claim"),
-      type: z29.string().optional().describe("Type of claim, e.g. 'property damage', 'bodily injury'"),
-      description: z29.string().optional().describe("Brief description of the claim"),
-      amountPaid: z29.string().optional().describe("Amount paid"),
-      amountReserved: z29.string().optional().describe("Amount reserved"),
-      status: z29.enum(["open", "closed", "reopened"]).optional().describe("Claim status"),
-      claimNumber: z29.string().optional().describe("Claim reference number")
+import { z as z30 } from "zod";
+var LossHistorySchema = z30.object({
+  lossSummary: z30.string().optional().describe("Summary of loss history, e.g. '3 claims in past 5 years totaling $125,000'"),
+  individualClaims: z30.array(
+    z30.object({
+      date: z30.string().optional().describe("Date of loss or claim"),
+      type: z30.string().optional().describe("Type of claim, e.g. 'property damage', 'bodily injury'"),
+      description: z30.string().optional().describe("Brief description of the claim"),
+      amountPaid: z30.string().optional().describe("Amount paid"),
+      amountReserved: z30.string().optional().describe("Amount reserved"),
+      status: z30.enum(["open", "closed", "reopened"]).optional().describe("Claim status"),
+      claimNumber: z30.string().optional().describe("Claim reference number")
     })
   ).optional().describe("Individual claim records"),
-  experienceMod: z29.string().optional().describe("Experience modification factor for workers comp, e.g. '0.85'")
+  experienceMod: z30.string().optional().describe("Experience modification factor for workers comp, e.g. '0.85'")
 });
 function buildLossHistoryPrompt() {
   return `You are an expert insurance document analyst. Extract all loss history and claims information from this document.
@@ -3365,18 +3503,18 @@ Return JSON only.`;
 }
 
 // src/prompts/extractors/sections.ts
-import { z as z30 } from "zod";
-var SubsectionSchema2 = z30.object({
-  title: z30.string().describe("Subsection title"),
-  sectionNumber: z30.string().optional().describe("Subsection number"),
-  pageNumber: z30.number().optional().describe("Page number"),
-  content: z30.string().describe("Full verbatim text")
+import { z as z31 } from "zod";
+var SubsectionSchema2 = z31.object({
+  title: z31.string().describe("Subsection title"),
+  sectionNumber: z31.string().optional().describe("Subsection number"),
+  pageNumber: z31.number().optional().describe("Page number"),
+  content: z31.string().describe("Full verbatim text")
 });
-var SectionsSchema = z30.object({
-  sections: z30.array(
-    z30.object({
-      title: z30.string().describe("Section title"),
-      type: z30.enum([
+var SectionsSchema = z31.object({
+  sections: z31.array(
+    z31.object({
+      title: z31.string().describe("Section title"),
+      type: z31.enum([
         "declarations",
         "insuring_agreement",
         "policy_form",
@@ -3390,10 +3528,10 @@ var SectionsSchema = z30.object({
         "regulatory",
         "other"
       ]).describe("Section type classification"),
-      content: z30.string().describe("Full verbatim text of the section"),
-      pageStart: z30.number().describe("Starting page number"),
-      pageEnd: z30.number().optional().describe("Ending page number"),
-      subsections: z30.array(SubsectionSchema2).optional().describe("Subsections within this section")
+      content: z31.string().describe("Full verbatim text of the section"),
+      pageStart: z31.number().describe("Starting page number"),
+      pageEnd: z31.number().optional().describe("Ending page number"),
+      subsections: z31.array(SubsectionSchema2).optional().describe("Subsections within this section")
     })
   ).describe("All document sections")
 });
@@ -3412,25 +3550,31 @@ For each section, classify its type:
 - "other" \u2014 anything that doesn't fit the above categories
 
 Include accurate page numbers for every section. Include subsections only if the section has clearly defined subsections with their own titles.
+If a page begins or ends in the middle of a section, treat it as a continuation of the existing section instead of creating a new orphan section from the fragment.
+
+Critical rules:
+- Ignore table-of-contents entries, page-number references, repeating headers/footers, and other navigational artifacts.
+- Do not create a new section from a lone continuation fragment such as a single paragraph tail or list item that clearly belongs to the previous page's section.
+- When a section spans multiple pages, keep it as one section with pageStart/pageEnd covering the full span represented in this extraction.
 
 Return JSON only.`;
 }
 
 // src/prompts/extractors/supplementary.ts
-import { z as z31 } from "zod";
-var ContactSchema2 = z31.object({
-  name: z31.string().optional().describe("Organization or person name"),
-  phone: z31.string().optional().describe("Phone number"),
-  email: z31.string().optional().describe("Email address"),
-  address: z31.string().optional().describe("Mailing address"),
-  type: z31.string().optional().describe("Contact type, e.g. 'State Department of Insurance'")
+import { z as z32 } from "zod";
+var ContactSchema2 = z32.object({
+  name: z32.string().optional().describe("Organization or person name"),
+  phone: z32.string().optional().describe("Phone number"),
+  email: z32.string().optional().describe("Email address"),
+  address: z32.string().optional().describe("Mailing address"),
+  type: z32.string().optional().describe("Contact type, e.g. 'State Department of Insurance'")
 });
-var SupplementarySchema = z31.object({
-  regulatoryContacts: z31.array(ContactSchema2).optional().describe("Regulatory body contacts (state department of insurance, ombudsman)"),
-  claimsContacts: z31.array(ContactSchema2).optional().describe("Claims reporting contacts and instructions"),
-  thirdPartyAdministrators: z31.array(ContactSchema2).optional().describe("Third-party administrators for claims handling"),
-  cancellationNoticeDays: z31.number().optional().describe("Required notice period for cancellation in days"),
-  nonrenewalNoticeDays: z31.number().optional().describe("Required notice period for nonrenewal in days")
+var SupplementarySchema = z32.object({
+  regulatoryContacts: z32.array(ContactSchema2).optional().describe("Regulatory body contacts (state department of insurance, ombudsman)"),
+  claimsContacts: z32.array(ContactSchema2).optional().describe("Claims reporting contacts and instructions"),
+  thirdPartyAdministrators: z32.array(ContactSchema2).optional().describe("Third-party administrators for claims handling"),
+  cancellationNoticeDays: z32.number().optional().describe("Required notice period for cancellation in days"),
+  nonrenewalNoticeDays: z32.number().optional().describe("Required notice period for nonrenewal in days")
 });
 function buildSupplementaryPrompt() {
   return `You are an expert insurance document analyst. Extract supplementary and regulatory information from this document.
@@ -3467,6 +3611,313 @@ function getExtractor(name) {
   return EXTRACTORS[name];
 }
 
+// src/core/quality.ts
+function evaluateQualityGate(params) {
+  const { issues, hasRoundWarnings = false } = params;
+  const hasBlocking = issues.some((issue) => issue.severity === "blocking");
+  const hasWarnings = issues.some((issue) => issue.severity === "warning") || hasRoundWarnings;
+  return hasBlocking ? "failed" : hasWarnings ? "warning" : "passed";
+}
+function shouldFailQualityGate(mode, status) {
+  return mode === "strict" && status === "failed";
+}
+
+// src/extraction/quality.ts
+function normalizeFormNumber(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  return trimmed;
+}
+function addFormEntry(inventory, formNumber, source, extra) {
+  if (!formNumber) return;
+  const existing = inventory.get(formNumber);
+  if (existing) {
+    if (!existing.title && extra?.title) existing.title = extra.title;
+    if (!existing.pageStart && extra?.pageStart) existing.pageStart = extra.pageStart;
+    if (!existing.pageEnd && extra?.pageEnd) existing.pageEnd = extra.pageEnd;
+    if (!existing.sources.includes(source)) existing.sources.push(source);
+    return;
+  }
+  inventory.set(formNumber, {
+    formNumber,
+    title: extra?.title,
+    pageStart: extra?.pageStart,
+    pageEnd: extra?.pageEnd,
+    sources: [source]
+  });
+}
+function looksReferential(value) {
+  if (typeof value !== "string") return false;
+  const normalized = value.toLowerCase();
+  return normalized.includes("shown in the declarations") || normalized.includes("shown in declarations") || normalized.includes("shown in the schedule") || normalized.includes("as stated") || normalized.includes("if applicable");
+}
+function looksTocArtifact(value) {
+  if (typeof value !== "string") return false;
+  return /\.{4,}\d{1,3}$/.test(value.trim()) || /^\d+\.\s+[A-Z][\s\S]*\.{3,}\d{1,3}$/.test(value.trim());
+}
+function sourcePrecedence(sectionRef) {
+  if (typeof sectionRef !== "string") return 0;
+  const normalized = sectionRef.toLowerCase();
+  if (normalized.includes("declaration") || normalized.includes("scheduled coverages") || normalized.includes("schedule")) return 4;
+  if (normalized.includes("endorsement")) return 3;
+  if (normalized.includes("additional coverages")) return 2;
+  if (normalized.includes("coverage form") || normalized.includes("policy form")) return 1;
+  return 0;
+}
+function buildExtractionReviewReport(params) {
+  const { memory, reviewRounds } = params;
+  const deterministicIssues = [];
+  const inventory = /* @__PURE__ */ new Map();
+  const extractedFormInventory = memory.get("form_inventory")?.forms ?? [];
+  const coverages = memory.get("coverage_limits")?.coverages ?? [];
+  const endorsements = memory.get("endorsements")?.endorsements ?? [];
+  const exclusions = memory.get("exclusions")?.exclusions ?? [];
+  const conditions = memory.get("conditions")?.conditions ?? [];
+  const sections = memory.get("sections")?.sections ?? [];
+  for (const form of extractedFormInventory) {
+    addFormEntry(
+      inventory,
+      normalizeFormNumber(form.formNumber),
+      "form_inventory",
+      {
+        title: form.title,
+        pageStart: form.pageStart,
+        pageEnd: form.pageEnd
+      }
+    );
+  }
+  for (const endorsement of endorsements) {
+    addFormEntry(
+      inventory,
+      normalizeFormNumber(endorsement.formNumber),
+      "endorsements",
+      {
+        title: typeof endorsement.title === "string" ? endorsement.title : void 0,
+        pageStart: typeof endorsement.pageStart === "number" ? endorsement.pageStart : void 0,
+        pageEnd: typeof endorsement.pageEnd === "number" ? endorsement.pageEnd : void 0
+      }
+    );
+    if (typeof endorsement.formNumber !== "string" || !endorsement.formNumber.trim()) {
+      deterministicIssues.push({
+        code: "endorsement_missing_form_number",
+        severity: "blocking",
+        message: "Endorsement is missing formNumber.",
+        extractorName: "endorsements",
+        pageNumber: typeof endorsement.pageStart === "number" ? endorsement.pageStart : void 0,
+        itemName: typeof endorsement.title === "string" ? endorsement.title : void 0
+      });
+    }
+    const endorsementFormNumber = normalizeFormNumber(endorsement.formNumber);
+    if (endorsementFormNumber && !inventory.has(endorsementFormNumber)) {
+      deterministicIssues.push({
+        code: "endorsement_form_missing_from_inventory",
+        severity: "warning",
+        message: `Endorsement "${String(endorsement.title ?? endorsementFormNumber)}" is not present in form inventory.`,
+        extractorName: "endorsements",
+        formNumber: endorsementFormNumber,
+        pageNumber: typeof endorsement.pageStart === "number" ? endorsement.pageStart : void 0,
+        itemName: typeof endorsement.title === "string" ? endorsement.title : void 0
+      });
+    }
+  }
+  for (const coverage of coverages) {
+    const formNumber = normalizeFormNumber(coverage.formNumber);
+    addFormEntry(inventory, formNumber, "coverage_limits", {
+      title: typeof coverage.name === "string" ? coverage.name : void 0,
+      pageStart: typeof coverage.pageNumber === "number" ? coverage.pageNumber : void 0,
+      pageEnd: typeof coverage.pageNumber === "number" ? coverage.pageNumber : void 0
+    });
+    if (typeof coverage.name === "string" && /coverage form$/i.test(coverage.name.trim())) {
+      deterministicIssues.push({
+        code: "generic_form_row_as_coverage",
+        severity: "blocking",
+        message: `Coverage "${coverage.name}" looks like a form header rather than a real coverage row.`,
+        extractorName: "coverage_limits",
+        formNumber,
+        pageNumber: typeof coverage.pageNumber === "number" ? coverage.pageNumber : void 0,
+        itemName: coverage.name
+      });
+    }
+    if (typeof coverage.pageNumber !== "number") {
+      deterministicIssues.push({
+        code: "coverage_missing_page_number",
+        severity: "warning",
+        message: `Coverage "${String(coverage.name ?? "unknown")}" is missing pageNumber provenance.`,
+        extractorName: "coverage_limits",
+        formNumber,
+        itemName: typeof coverage.name === "string" ? coverage.name : void 0
+      });
+    }
+    if (typeof coverage.sectionRef !== "string" || !coverage.sectionRef.trim()) {
+      deterministicIssues.push({
+        code: "coverage_missing_section_ref",
+        severity: "warning",
+        message: `Coverage "${String(coverage.name ?? "unknown")}" is missing sectionRef provenance.`,
+        extractorName: "coverage_limits",
+        formNumber,
+        pageNumber: typeof coverage.pageNumber === "number" ? coverage.pageNumber : void 0,
+        itemName: typeof coverage.name === "string" ? coverage.name : void 0
+      });
+    }
+    if (typeof coverage.originalContent !== "string" || !coverage.originalContent.trim()) {
+      deterministicIssues.push({
+        code: "coverage_missing_original_content",
+        severity: "warning",
+        message: `Coverage "${String(coverage.name ?? "unknown")}" is missing originalContent source text.`,
+        extractorName: "coverage_limits",
+        formNumber,
+        pageNumber: typeof coverage.pageNumber === "number" ? coverage.pageNumber : void 0,
+        itemName: typeof coverage.name === "string" ? coverage.name : void 0
+      });
+    }
+    if (looksReferential(coverage.limit) || looksReferential(coverage.deductible)) {
+      deterministicIssues.push({
+        code: "coverage_referential_value",
+        severity: "warning",
+        message: `Coverage "${String(coverage.name ?? "unknown")}" contains referential language instead of a concrete scheduled term.`,
+        extractorName: "coverage_limits",
+        formNumber,
+        pageNumber: typeof coverage.pageNumber === "number" ? coverage.pageNumber : void 0,
+        itemName: typeof coverage.name === "string" ? coverage.name : void 0
+      });
+    }
+    if (formNumber && !inventory.has(formNumber)) {
+      deterministicIssues.push({
+        code: "coverage_form_missing_from_inventory",
+        severity: "warning",
+        message: `Coverage "${String(coverage.name ?? "unknown")}" references form "${formNumber}" that is missing from form inventory.`,
+        extractorName: "coverage_limits",
+        formNumber,
+        pageNumber: typeof coverage.pageNumber === "number" ? coverage.pageNumber : void 0,
+        itemName: typeof coverage.name === "string" ? coverage.name : void 0
+      });
+    }
+  }
+  const coverageGroups = /* @__PURE__ */ new Map();
+  for (const coverage of coverages) {
+    const key = [
+      String(coverage.name ?? "").toLowerCase(),
+      String(coverage.formNumber ?? "").toLowerCase()
+    ].join("|");
+    coverageGroups.set(key, [...coverageGroups.get(key) ?? [], coverage]);
+  }
+  for (const [key, groupedCoverages] of coverageGroups.entries()) {
+    if (groupedCoverages.length < 2) continue;
+    const sorted = [...groupedCoverages].sort((a, b) => sourcePrecedence(b.sectionRef) - sourcePrecedence(a.sectionRef));
+    const highest = sorted[0];
+    for (const lower of sorted.slice(1)) {
+      const highestLimit = String(highest.limit ?? "").trim();
+      const lowerLimit = String(lower.limit ?? "").trim();
+      const highestDeductible = String(highest.deductible ?? "").trim();
+      const lowerDeductible = String(lower.deductible ?? "").trim();
+      if (highestLimit && lowerLimit && highestLimit !== lowerLimit || highestDeductible && lowerDeductible && highestDeductible !== lowerDeductible) {
+        deterministicIssues.push({
+          code: "coverage_precedence_conflict",
+          severity: "warning",
+          message: `Coverage "${String(highest.name ?? key)}" has conflicting extracted terms across sources with different precedence.`,
+          extractorName: "coverage_limits",
+          formNumber: normalizeFormNumber(highest.formNumber) ?? normalizeFormNumber(lower.formNumber),
+          pageNumber: typeof lower.pageNumber === "number" ? lower.pageNumber : void 0,
+          itemName: typeof highest.name === "string" ? highest.name : void 0
+        });
+      }
+    }
+  }
+  for (const exclusion of exclusions) {
+    addFormEntry(inventory, normalizeFormNumber(exclusion.formNumber), "exclusions", {
+      title: typeof exclusion.name === "string" ? exclusion.name : void 0,
+      pageStart: typeof exclusion.pageNumber === "number" ? exclusion.pageNumber : void 0,
+      pageEnd: typeof exclusion.pageNumber === "number" ? exclusion.pageNumber : void 0
+    });
+    if (typeof exclusion.pageNumber !== "number") {
+      deterministicIssues.push({
+        code: "exclusion_missing_page_number",
+        severity: "warning",
+        message: `Exclusion "${String(exclusion.name ?? "unknown")}" is missing pageNumber provenance.`,
+        extractorName: "exclusions",
+        formNumber: normalizeFormNumber(exclusion.formNumber),
+        itemName: typeof exclusion.name === "string" ? exclusion.name : void 0
+      });
+    }
+    if (looksTocArtifact(exclusion.content)) {
+      deterministicIssues.push({
+        code: "exclusion_toc_artifact",
+        severity: "blocking",
+        message: `Exclusion "${String(exclusion.name ?? "unknown")}" appears to be a table-of-contents artifact.`,
+        extractorName: "exclusions",
+        pageNumber: typeof exclusion.pageNumber === "number" ? exclusion.pageNumber : void 0,
+        itemName: typeof exclusion.name === "string" ? exclusion.name : void 0
+      });
+    }
+  }
+  for (const condition of conditions) {
+    if (typeof condition.pageNumber !== "number") {
+      deterministicIssues.push({
+        code: "condition_missing_page_number",
+        severity: "warning",
+        message: `Condition "${String(condition.name ?? "unknown")}" is missing pageNumber provenance.`,
+        extractorName: "conditions",
+        itemName: typeof condition.name === "string" ? condition.name : void 0
+      });
+    }
+    if (looksTocArtifact(condition.content)) {
+      deterministicIssues.push({
+        code: "condition_toc_artifact",
+        severity: "blocking",
+        message: `Condition "${String(condition.name ?? "unknown")}" appears to be a table-of-contents artifact.`,
+        extractorName: "conditions",
+        pageNumber: typeof condition.pageNumber === "number" ? condition.pageNumber : void 0,
+        itemName: typeof condition.name === "string" ? condition.name : void 0
+      });
+    }
+  }
+  for (const section of sections) {
+    if (typeof section.content === "string" && section.content.trim().length < 120 && typeof section.pageStart === "number" && (!("pageEnd" in section) || section.pageEnd === section.pageStart || section.pageEnd === void 0)) {
+      deterministicIssues.push({
+        code: "section_short_fragment",
+        severity: "warning",
+        message: `Section "${String(section.title ?? "unknown")}" may be an orphan continuation fragment.`,
+        extractorName: "sections",
+        pageNumber: typeof section.pageStart === "number" ? section.pageStart : void 0,
+        itemName: typeof section.title === "string" ? section.title : void 0
+      });
+    }
+  }
+  const formInventory = [...inventory.values()].sort((a, b) => a.formNumber.localeCompare(b.formNumber));
+  const rounds = reviewRounds.map((round) => ({
+    round: round.round,
+    kind: "llm_review",
+    status: round.complete && round.qualityIssues.length === 0 ? "passed" : "warning",
+    summary: round.qualityIssues[0] ?? (round.complete ? "Review passed." : "Review requested follow-up extraction.")
+  }));
+  const artifacts = [
+    { kind: "form_inventory", label: "Form Inventory", itemCount: formInventory.length },
+    { kind: "page_map", label: "Page Map", itemCount: params.pageAssignments.length }
+  ];
+  const qualityGateStatus = evaluateQualityGate({
+    issues: deterministicIssues,
+    hasRoundWarnings: reviewRounds.some((round) => round.qualityIssues.length > 0 || !round.complete)
+  });
+  return {
+    issues: deterministicIssues,
+    rounds,
+    artifacts,
+    reviewRoundRecords: reviewRounds,
+    formInventory,
+    qualityGateStatus
+  };
+}
+function toReviewRoundRecord(round, review) {
+  return {
+    round,
+    complete: review.complete,
+    missingFields: review.missingFields,
+    qualityIssues: review.qualityIssues ?? [],
+    additionalTasks: review.additionalTasks
+  };
+}
+
 // src/extraction/coordinator.ts
 function createExtractor(config) {
   const {
@@ -3479,6 +3930,7 @@ function createExtractor(config) {
     onProgress,
     log,
     providerOptions,
+    qualityGate = "warn",
     onCheckpointSave
   } = config;
   const limit = pLimit(concurrency);
@@ -3535,6 +3987,50 @@ function createExtractor(config) {
     if (extractorPages.size === 0) return "No page assignments available.";
     return [...extractorPages.entries()].map(([extractorName, pages]) => `${extractorName}: pages ${pages.join(", ")}`).join("\n");
   }
+  function normalizePageAssignments(pageAssignments, formInventory) {
+    const pageFormTypes = /* @__PURE__ */ new Map();
+    if (formInventory) {
+      for (const form of formInventory.forms) {
+        if (form.pageStart != null) {
+          const end = form.pageEnd ?? form.pageStart;
+          for (let p = form.pageStart; p <= end; p++) {
+            const types = pageFormTypes.get(p) ?? /* @__PURE__ */ new Set();
+            types.add(form.formType);
+            pageFormTypes.set(p, types);
+          }
+        }
+      }
+    }
+    return pageAssignments.map((assignment) => {
+      let extractorNames = [...new Set(
+        (assignment.extractorNames.length > 0 ? assignment.extractorNames : ["sections"]).filter(Boolean)
+      )];
+      const hasDeclarations = extractorNames.includes("declarations");
+      const hasConditions = extractorNames.includes("conditions");
+      const hasExclusions = extractorNames.includes("exclusions");
+      const hasEndorsements = extractorNames.includes("endorsements");
+      const looksLikeScheduleValues = assignment.hasScheduleValues === true;
+      const roleBlocksCoverageLimits = assignment.pageRole === "policy_form" || assignment.pageRole === "condition_exclusion_form" || assignment.pageRole === "endorsement_form";
+      const inventoryTypes = pageFormTypes.get(assignment.localPageNumber);
+      const inventoryBlocksCoverageLimits = inventoryTypes != null && !looksLikeScheduleValues && !hasDeclarations && (inventoryTypes.has("endorsement") || inventoryTypes.has("notice") || inventoryTypes.has("application"));
+      if (extractorNames.includes("coverage_limits")) {
+        const shouldDropCoverageLimits = inventoryBlocksCoverageLimits || !looksLikeScheduleValues && roleBlocksCoverageLimits || !hasDeclarations && !looksLikeScheduleValues && (hasConditions || hasExclusions) || !hasDeclarations && !looksLikeScheduleValues && hasEndorsements;
+        if (shouldDropCoverageLimits) {
+          extractorNames = extractorNames.filter((name) => name !== "coverage_limits");
+        }
+      }
+      if (inventoryTypes?.has("endorsement") && !extractorNames.includes("endorsements")) {
+        extractorNames = [...extractorNames, "endorsements"];
+      }
+      if (extractorNames.length === 0) {
+        extractorNames = ["sections"];
+      }
+      return {
+        ...assignment,
+        extractorNames
+      };
+    });
+  }
   function buildTemplateHints(primaryType, documentType, pageCount, template) {
     return [
       `Document type: ${primaryType} ${documentType}`,
@@ -3653,6 +4149,38 @@ function createExtractor(config) {
     const template = getTemplate(primaryType);
     const pageCount = resumed?.pageCount ?? await getPdfPageCount(pdfBase64);
     const templateHints = buildTemplateHints(primaryType, documentType, pageCount, template);
+    let formInventory;
+    if (resumed?.formInventory && pipelineCtx.isPhaseComplete("form_inventory")) {
+      formInventory = resumed.formInventory;
+      memory.set("form_inventory", formInventory);
+      onProgress?.("Resuming from checkpoint (form inventory complete)...");
+    } else {
+      onProgress?.(`Building form inventory for ${primaryType} ${documentType}...`);
+      const formInventoryResponse = await safeGenerateObject(
+        generateObject,
+        {
+          prompt: buildFormInventoryPrompt(templateHints),
+          schema: FormInventorySchema,
+          maxTokens: 2048,
+          providerOptions: { ...providerOptions, pdfBase64 }
+        },
+        {
+          fallback: { forms: [] },
+          log,
+          onError: (err, attempt) => log?.(`Form inventory attempt ${attempt + 1} failed: ${err instanceof Error ? err.message : String(err)}`)
+        }
+      );
+      trackUsage(formInventoryResponse.usage);
+      formInventory = formInventoryResponse.object;
+      memory.set("form_inventory", formInventory);
+      await pipelineCtx.save("form_inventory", {
+        id,
+        pageCount,
+        classifyResult,
+        formInventory,
+        memory: Object.fromEntries(memory)
+      });
+    }
     let pageAssignments;
     if (resumed?.pageAssignments && pipelineCtx.isPhaseComplete("page_map")) {
       pageAssignments = resumed.pageAssignments;
@@ -3661,13 +4189,14 @@ function createExtractor(config) {
       onProgress?.(`Mapping document pages for ${primaryType} ${documentType}...`);
       const chunkSize = 8;
       const collectedAssignments = [];
+      const formInventoryHint = formInventory?.forms.length ? formatFormInventoryForPageMap(formInventory.forms) : void 0;
       for (let startPage = 1; startPage <= pageCount; startPage += chunkSize) {
         const endPage = Math.min(pageCount, startPage + chunkSize - 1);
         const pagesPdf = await extractPageRange(pdfBase64, startPage, endPage);
         const mapResponse = await safeGenerateObject(
           generateObject,
           {
-            prompt: buildPageMapPrompt(templateHints, startPage, endPage),
+            prompt: buildPageMapPrompt(templateHints, startPage, endPage, formInventoryHint),
             schema: PageMapChunkSchema,
             maxTokens: 2048,
             providerOptions: { ...providerOptions, pdfBase64: pagesPdf }
@@ -3699,10 +4228,12 @@ function createExtractor(config) {
         confidence: 0,
         notes: "Full-document fallback page assignment"
       }));
+      pageAssignments = normalizePageAssignments(pageAssignments, formInventory);
       await pipelineCtx.save("page_map", {
         id,
         pageCount,
         classifyResult,
+        formInventory,
         pageAssignments,
         memory: Object.fromEntries(memory)
       });
@@ -3718,6 +4249,7 @@ function createExtractor(config) {
         id,
         pageCount,
         classifyResult,
+        formInventory,
         pageAssignments,
         plan,
         memory: Object.fromEntries(memory)
@@ -3766,12 +4298,16 @@ function createExtractor(config) {
         id,
         pageCount,
         classifyResult,
+        formInventory,
         pageAssignments,
         plan,
         memory: Object.fromEntries(memory)
       });
     }
+    let reviewRounds = resumed?.reviewReport?.reviewRoundRecords ?? [];
+    let reviewReport = resumed?.reviewReport;
     if (!pipelineCtx.isPhaseComplete("review")) {
+      reviewRounds = [];
       for (let round = 0; round < maxReviewRounds; round++) {
         const extractedKeys = [...memory.keys()].filter((k) => k !== "classify");
         const extractionSummary = summarizeExtraction(memory);
@@ -3791,6 +4327,7 @@ function createExtractor(config) {
           }
         );
         trackUsage(reviewResponse.usage);
+        reviewRounds.push(toReviewRoundRecord(round + 1, reviewResponse.object));
         if (reviewResponse.object.qualityIssues?.length) {
           await log?.(`Review round ${round + 1} quality issues: ${reviewResponse.object.qualityIssues.join("; ")}`);
         }
@@ -3832,23 +4369,45 @@ function createExtractor(config) {
           }
         }
       }
+      reviewReport = buildExtractionReviewReport({
+        memory,
+        pageAssignments,
+        reviewRounds
+      });
+      if (reviewReport.issues.length > 0) {
+        await log?.(
+          `Deterministic review issues: ${reviewReport.issues.map((issue) => issue.message).join("; ")}`
+        );
+      }
+      if (shouldFailQualityGate(qualityGate, reviewReport.qualityGateStatus)) {
+        throw new Error("Extraction quality gate failed. See reviewReport for blocking issues.");
+      }
       await pipelineCtx.save("review", {
         id,
         pageCount,
         classifyResult,
+        formInventory,
         pageAssignments,
         plan,
+        reviewReport,
         memory: Object.fromEntries(memory)
       });
     }
+    reviewReport ?? (reviewReport = buildExtractionReviewReport({
+      memory,
+      pageAssignments,
+      reviewRounds
+    }));
     onProgress?.("Assembling document...");
     const document = assembleDocument(id, documentType, memory);
     await pipelineCtx.save("assemble", {
       id,
       pageCount,
       classifyResult,
+      formInventory,
       pageAssignments,
       plan,
+      reviewReport,
       memory: Object.fromEntries(memory),
       document
     });
@@ -3874,7 +4433,8 @@ function createExtractor(config) {
         callsWithUsage,
         callsMissingUsage
       },
-      checkpoint: finalCheckpoint
+      checkpoint: finalCheckpoint,
+      reviewReport
     };
   }
   return { extract };
@@ -4094,8 +4654,8 @@ Respond with JSON only:
 }`;
 
 // src/schemas/application.ts
-import { z as z32 } from "zod";
-var FieldTypeSchema = z32.enum([
+import { z as z33 } from "zod";
+var FieldTypeSchema = z33.enum([
   "text",
   "numeric",
   "currency",
@@ -4104,100 +4664,131 @@ var FieldTypeSchema = z32.enum([
   "table",
   "declaration"
 ]);
-var ApplicationFieldSchema = z32.object({
-  id: z32.string(),
-  label: z32.string(),
-  section: z32.string(),
+var ApplicationFieldSchema = z33.object({
+  id: z33.string(),
+  label: z33.string(),
+  section: z33.string(),
   fieldType: FieldTypeSchema,
-  required: z32.boolean(),
-  options: z32.array(z32.string()).optional(),
-  columns: z32.array(z32.string()).optional(),
-  requiresExplanationIfYes: z32.boolean().optional(),
-  condition: z32.object({
-    dependsOn: z32.string(),
-    whenValue: z32.string()
+  required: z33.boolean(),
+  options: z33.array(z33.string()).optional(),
+  columns: z33.array(z33.string()).optional(),
+  requiresExplanationIfYes: z33.boolean().optional(),
+  condition: z33.object({
+    dependsOn: z33.string(),
+    whenValue: z33.string()
   }).optional(),
-  value: z32.string().optional(),
-  source: z32.string().optional().describe("Where the value came from: auto-fill, user, lookup"),
-  confidence: z32.enum(["confirmed", "high", "medium", "low"]).optional()
+  value: z33.string().optional(),
+  source: z33.string().optional().describe("Where the value came from: auto-fill, user, lookup"),
+  confidence: z33.enum(["confirmed", "high", "medium", "low"]).optional()
 });
-var ApplicationClassifyResultSchema = z32.object({
-  isApplication: z32.boolean(),
-  confidence: z32.number().min(0).max(1),
-  applicationType: z32.string().nullable()
+var ApplicationClassifyResultSchema = z33.object({
+  isApplication: z33.boolean(),
+  confidence: z33.number().min(0).max(1),
+  applicationType: z33.string().nullable()
+});
+var FieldExtractionResultSchema = z33.object({
+  fields: z33.array(ApplicationFieldSchema)
+});
+var AutoFillMatchSchema = z33.object({
+  fieldId: z33.string(),
+  value: z33.string(),
+  confidence: z33.enum(["confirmed"]),
+  contextKey: z33.string()
+});
+var AutoFillResultSchema = z33.object({
+  matches: z33.array(AutoFillMatchSchema)
 });
-var FieldExtractionResultSchema = z32.object({
-  fields: z32.array(ApplicationFieldSchema)
+var QuestionBatchResultSchema = z33.object({
+  batches: z33.array(z33.array(z33.string()).describe("Array of field IDs in this batch"))
 });
-var AutoFillMatchSchema = z32.object({
-  fieldId: z32.string(),
-  value: z32.string(),
-  confidence: z32.enum(["confirmed"]),
-  contextKey: z32.string()
+var LookupRequestSchema = z33.object({
+  type: z33.string().describe("Type of lookup: 'records', 'website', 'policy'"),
+  description: z33.string(),
+  url: z33.string().optional(),
+  targetFieldIds: z33.array(z33.string())
 });
-var AutoFillResultSchema = z32.object({
-  matches: z32.array(AutoFillMatchSchema)
+var ReplyIntentSchema = z33.object({
+  primaryIntent: z33.enum(["answers_only", "question", "lookup_request", "mixed"]),
+  hasAnswers: z33.boolean(),
+  questionText: z33.string().optional(),
+  questionFieldIds: z33.array(z33.string()).optional(),
+  lookupRequests: z33.array(LookupRequestSchema).optional()
 });
-var QuestionBatchResultSchema = z32.object({
-  batches: z32.array(z32.array(z32.string()).describe("Array of field IDs in this batch"))
+var ParsedAnswerSchema = z33.object({
+  fieldId: z33.string(),
+  value: z33.string(),
+  explanation: z33.string().optional()
 });
-var LookupRequestSchema = z32.object({
-  type: z32.string().describe("Type of lookup: 'records', 'website', 'policy'"),
-  description: z32.string(),
-  url: z32.string().optional(),
-  targetFieldIds: z32.array(z32.string())
+var AnswerParsingResultSchema = z33.object({
+  answers: z33.array(ParsedAnswerSchema),
+  unanswered: z33.array(z33.string()).describe("Field IDs that were not answered")
 });
-var ReplyIntentSchema = z32.object({
-  primaryIntent: z32.enum(["answers_only", "question", "lookup_request", "mixed"]),
-  hasAnswers: z32.boolean(),
-  questionText: z32.string().optional(),
-  questionFieldIds: z32.array(z32.string()).optional(),
-  lookupRequests: z32.array(LookupRequestSchema).optional()
+var LookupFillSchema = z33.object({
+  fieldId: z33.string(),
+  value: z33.string(),
+  source: z33.string().describe("Specific citable reference, e.g. 'GL Policy #POL-12345 (Hartford)'")
 });
-var ParsedAnswerSchema = z32.object({
-  fieldId: z32.string(),
-  value: z32.string(),
-  explanation: z32.string().optional()
+var LookupFillResultSchema = z33.object({
+  fills: z33.array(LookupFillSchema),
+  unfillable: z33.array(z33.string()),
+  explanation: z33.string().optional()
 });
-var AnswerParsingResultSchema = z32.object({
-  answers: z32.array(ParsedAnswerSchema),
-  unanswered: z32.array(z32.string()).describe("Field IDs that were not answered")
+var FlatPdfPlacementSchema = z33.object({
+  fieldId: z33.string(),
+  page: z33.number(),
+  x: z33.number().describe("Percentage from left edge (0-100)"),
+  y: z33.number().describe("Percentage from top edge (0-100)"),
+  text: z33.string(),
+  fontSize: z33.number().optional(),
+  isCheckmark: z33.boolean().optional()
 });
-var LookupFillSchema = z32.object({
-  fieldId: z32.string(),
-  value: z32.string(),
-  source: z32.string().describe("Specific citable reference, e.g. 'GL Policy #POL-12345 (Hartford)'")
+var AcroFormMappingSchema = z33.object({
+  fieldId: z33.string(),
+  acroFormName: z33.string(),
+  value: z33.string()
 });
-var LookupFillResultSchema = z32.object({
-  fills: z32.array(LookupFillSchema),
-  unfillable: z32.array(z32.string()),
-  explanation: z32.string().optional()
+var QualityGateStatusSchema = z33.enum(["passed", "warning", "failed"]);
+var QualitySeveritySchema = z33.enum(["info", "warning", "blocking"]);
+var ApplicationQualityIssueSchema = z33.object({
+  code: z33.string(),
+  severity: QualitySeveritySchema,
+  message: z33.string(),
+  fieldId: z33.string().optional()
 });
-var FlatPdfPlacementSchema = z32.object({
-  fieldId: z32.string(),
-  page: z32.number(),
-  x: z32.number().describe("Percentage from left edge (0-100)"),
-  y: z32.number().describe("Percentage from top edge (0-100)"),
-  text: z32.string(),
-  fontSize: z32.number().optional(),
-  isCheckmark: z32.boolean().optional()
+var ApplicationQualityRoundSchema = z33.object({
+  round: z33.number(),
+  kind: z33.string(),
+  status: QualityGateStatusSchema,
+  summary: z33.string().optional()
 });
-var AcroFormMappingSchema = z32.object({
-  fieldId: z32.string(),
-  acroFormName: z32.string(),
-  value: z32.string()
+var ApplicationQualityArtifactSchema = z33.object({
+  kind: z33.string(),
+  label: z33.string().optional(),
+  itemCount: z33.number().optional()
 });
-var ApplicationStateSchema = z32.object({
-  id: z32.string(),
-  pdfBase64: z32.string().optional().describe("Original PDF, omitted after extraction"),
-  title: z32.string().optional(),
-  applicationType: z32.string().nullable().optional(),
-  fields: z32.array(ApplicationFieldSchema),
-  batches: z32.array(z32.array(z32.string())).optional(),
-  currentBatchIndex: z32.number().default(0),
-  status: z32.enum(["classifying", "extracting", "auto_filling", "batching", "collecting", "confirming", "mapping", "complete"]),
-  createdAt: z32.number(),
-  updatedAt: z32.number()
+var ApplicationEmailReviewSchema = z33.object({
+  issues: z33.array(ApplicationQualityIssueSchema),
+  qualityGateStatus: QualityGateStatusSchema
+});
+var ApplicationQualityReportSchema = z33.object({
+  issues: z33.array(ApplicationQualityIssueSchema),
+  rounds: z33.array(ApplicationQualityRoundSchema).optional(),
+  artifacts: z33.array(ApplicationQualityArtifactSchema).optional(),
+  emailReview: ApplicationEmailReviewSchema.optional(),
+  qualityGateStatus: QualityGateStatusSchema
+});
+var ApplicationStateSchema = z33.object({
+  id: z33.string(),
+  pdfBase64: z33.string().optional().describe("Original PDF, omitted after extraction"),
+  title: z33.string().optional(),
+  applicationType: z33.string().nullable().optional(),
+  fields: z33.array(ApplicationFieldSchema),
+  batches: z33.array(z33.array(z33.string())).optional(),
+  currentBatchIndex: z33.number().default(0),
+  qualityReport: ApplicationQualityReportSchema.optional(),
+  status: z33.enum(["classifying", "extracting", "auto_filling", "batching", "collecting", "confirming", "mapping", "complete"]),
+  createdAt: z33.number(),
+  updatedAt: z33.number()
 });
 
 // src/application/agents/classifier.ts
@@ -4705,6 +5296,87 @@ async function generateBatchEmail(batchFields, batchIndex, totalBatches, opts, g
   return { text, usage };
 }
 
+// src/application/quality.ts
+function isVagueSource(source) {
+  if (!source) return true;
+  const normalized = source.trim().toLowerCase();
+  return normalized === "unknown" || normalized.includes("existing records") || normalized.includes("available data") || normalized === "context" || normalized === "user provided";
+}
+function buildApplicationQualityReport(state) {
+  const issues = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  for (const field of state.fields) {
+    if (seenIds.has(field.id)) {
+      issues.push({
+        code: "duplicate_field_id",
+        severity: "blocking",
+        message: `Field "${field.label}" has a duplicate id "${field.id}".`,
+        fieldId: field.id
+      });
+    }
+    seenIds.add(field.id);
+    if (field.required && !field.value) {
+      issues.push({
+        code: "required_field_unfilled",
+        severity: "warning",
+        message: `Required field "${field.label}" is still unfilled.`,
+        fieldId: field.id
+      });
+    }
+    if (field.value && !field.source) {
+      issues.push({
+        code: "filled_field_missing_source",
+        severity: "blocking",
+        message: `Filled field "${field.label}" is missing source provenance.`,
+        fieldId: field.id
+      });
+    }
+    if (field.value && isVagueSource(field.source)) {
+      issues.push({
+        code: "filled_field_vague_source",
+        severity: "warning",
+        message: `Filled field "${field.label}" has a vague or non-citable source.`,
+        fieldId: field.id
+      });
+    }
+    if (field.value && (!field.confidence || field.confidence === "low")) {
+      issues.push({
+        code: "filled_field_low_confidence",
+        severity: "warning",
+        message: `Filled field "${field.label}" has low or missing confidence.`,
+        fieldId: field.id
+      });
+    }
+  }
+  return {
+    issues,
+    rounds: [],
+    artifacts: [
+      { kind: "application_fields", label: "Application Fields", itemCount: state.fields.length }
+    ],
+    qualityGateStatus: evaluateQualityGate({ issues })
+  };
+}
+function reviewBatchEmail(text, batchFields) {
+  const issues = [];
+  const normalized = text.toLowerCase();
+  for (const field of batchFields) {
+    const label = field.label.trim().toLowerCase();
+    if (label.length >= 6 && !normalized.includes(label)) {
+      issues.push({
+        code: "email_missing_field_prompt",
+        severity: "warning",
+        message: `Generated email does not clearly mention field "${field.label}".`,
+        fieldId: field.id
+      });
+    }
+  }
+  return {
+    issues,
+    qualityGateStatus: evaluateQualityGate({ issues })
+  };
+}
+
 // src/application/coordinator.ts
 function createApplicationPipeline(config) {
   const {
@@ -4719,7 +5391,8 @@ function createApplicationPipeline(config) {
     onTokenUsage,
     onProgress,
     log,
-    providerOptions
+    providerOptions,
+    qualityGate = "warn"
   } = config;
   const limit = pLimit(concurrency);
   let totalUsage = { inputTokens: 0, outputTokens: 0 };
@@ -4741,6 +5414,7 @@ function createApplicationPipeline(config) {
       title: void 0,
       applicationType: null,
       fields: [],
+      qualityReport: void 0,
       batches: void 0,
       currentBatchIndex: 0,
       status: "classifying",
@@ -4765,8 +5439,9 @@ function createApplicationPipeline(config) {
     if (!classifyResult.isApplication) {
       state.status = "complete";
       state.updatedAt = Date.now();
+      state.qualityReport = buildApplicationQualityReport(state);
       await applicationStore?.save(state);
-      return { state, tokenUsage: totalUsage };
+      return { state, tokenUsage: totalUsage, reviewReport: state.qualityReport };
     }
     state.applicationType = classifyResult.applicationType;
     state.status = "extracting";
@@ -4790,8 +5465,9 @@ function createApplicationPipeline(config) {
       await log?.("No fields extracted, completing pipeline with empty result");
       state.status = "complete";
       state.updatedAt = Date.now();
+      state.qualityReport = buildApplicationQualityReport(state);
       await applicationStore?.save(state);
-      return { state, tokenUsage: totalUsage };
+      return { state, tokenUsage: totalUsage, reviewReport: state.qualityReport };
     }
     state.fields = fields;
     state.title = classifyResult.applicationType ?? void 0;
@@ -4891,11 +5567,15 @@ function createApplicationPipeline(config) {
     } else {
       state.status = "confirming";
     }
+    state.qualityReport = buildApplicationQualityReport(state);
     state.updatedAt = Date.now();
     await applicationStore?.save(state);
+    if (shouldFailQualityGate(qualityGate, state.qualityReport.qualityGateStatus)) {
+      throw new Error("Application quality gate failed. See state.qualityReport for blocking issues.");
+    }
     const filledCount = state.fields.filter((f) => f.value).length;
     onProgress?.(`Application processed: ${filledCount}/${state.fields.length} fields filled, ${state.batches?.length ?? 0} batches to collect.`);
-    return { state, tokenUsage: totalUsage };
+    return { state, tokenUsage: totalUsage, reviewReport: state.qualityReport };
   }
   async function processReply(input) {
     totalUsage = { inputTokens: 0, outputTokens: 0 };
@@ -5042,6 +5722,11 @@ Provide a brief, helpful explanation (2-3 sentences). End with "Just reply with
             providerOptions
           );
           trackUsage(emailUsage);
+          const emailReview = reviewBatchEmail(emailText, nextBatchFields);
+          state.qualityReport = {
+            ...buildApplicationQualityReport(state),
+            emailReview
+          };
           if (!responseText) {
             responseText = emailText;
           } else {
@@ -5057,13 +5742,18 @@ ${emailText}`;
       }
     }
     state.updatedAt = Date.now();
+    state.qualityReport = state.qualityReport ?? buildApplicationQualityReport(state);
     await applicationStore?.save(state);
+    if (shouldFailQualityGate(qualityGate, state.qualityReport.qualityGateStatus)) {
+      throw new Error("Application quality gate failed. See state.qualityReport for blocking issues.");
+    }
     return {
       state,
       intent: intent.primaryIntent,
       fieldsFilled,
       responseText,
-      tokenUsage: totalUsage
+      tokenUsage: totalUsage,
+      reviewReport: state.qualityReport
     };
   }
   async function generateCurrentBatchEmail(applicationId, opts) {
@@ -5089,6 +5779,12 @@ ${emailText}`;
       providerOptions
     );
     trackUsage(usage);
+    const emailReview = reviewBatchEmail(text, batchFields);
+    state.qualityReport = {
+      ...buildApplicationQualityReport(state),
+      emailReview
+    };
+    await applicationStore?.save(state);
     return { text, tokenUsage: totalUsage };
   }
   async function getConfirmationSummary(applicationId) {
@@ -5225,73 +5921,73 @@ Respond with the final answer, deduplicated citations array, overall confidence
 }
 
 // src/schemas/query.ts
-import { z as z33 } from "zod";
-var QueryIntentSchema = z33.enum([
+import { z as z34 } from "zod";
+var QueryIntentSchema = z34.enum([
   "policy_question",
   "coverage_comparison",
   "document_search",
   "claims_inquiry",
   "general_knowledge"
 ]);
-var SubQuestionSchema = z33.object({
-  question: z33.string().describe("Atomic sub-question to retrieve and answer independently"),
+var SubQuestionSchema = z34.object({
+  question: z34.string().describe("Atomic sub-question to retrieve and answer independently"),
   intent: QueryIntentSchema,
-  chunkTypes: z33.array(z33.string()).optional().describe("Chunk types to filter retrieval (e.g. coverage, endorsement, declaration)"),
-  documentFilters: z33.object({
-    type: z33.enum(["policy", "quote"]).optional(),
-    carrier: z33.string().optional(),
-    insuredName: z33.string().optional(),
-    policyNumber: z33.string().optional(),
-    quoteNumber: z33.string().optional()
+  chunkTypes: z34.array(z34.string()).optional().describe("Chunk types to filter retrieval (e.g. coverage, endorsement, declaration)"),
+  documentFilters: z34.object({
+    type: z34.enum(["policy", "quote"]).optional(),
+    carrier: z34.string().optional(),
+    insuredName: z34.string().optional(),
+    policyNumber: z34.string().optional(),
+    quoteNumber: z34.string().optional()
   }).optional().describe("Structured filters to narrow document lookup")
 });
-var QueryClassifyResultSchema = z33.object({
+var QueryClassifyResultSchema = z34.object({
   intent: QueryIntentSchema,
-  subQuestions: z33.array(SubQuestionSchema).min(1).describe("Decomposed atomic sub-questions"),
-  requiresDocumentLookup: z33.boolean().describe("Whether structured document lookup is needed"),
-  requiresChunkSearch: z33.boolean().describe("Whether semantic chunk search is needed"),
-  requiresConversationHistory: z33.boolean().describe("Whether conversation history is relevant")
+  subQuestions: z34.array(SubQuestionSchema).min(1).describe("Decomposed atomic sub-questions"),
+  requiresDocumentLookup: z34.boolean().describe("Whether structured document lookup is needed"),
+  requiresChunkSearch: z34.boolean().describe("Whether semantic chunk search is needed"),
+  requiresConversationHistory: z34.boolean().describe("Whether conversation history is relevant")
 });
-var EvidenceItemSchema = z33.object({
-  source: z33.enum(["chunk", "document", "conversation"]),
-  chunkId: z33.string().optional(),
-  documentId: z33.string().optional(),
-  turnId: z33.string().optional(),
-  text: z33.string().describe("Text excerpt from the source"),
-  relevance: z33.number().min(0).max(1),
-  metadata: z33.array(z33.object({ key: z33.string(), value: z33.string() })).optional()
+var EvidenceItemSchema = z34.object({
+  source: z34.enum(["chunk", "document", "conversation"]),
+  chunkId: z34.string().optional(),
+  documentId: z34.string().optional(),
+  turnId: z34.string().optional(),
+  text: z34.string().describe("Text excerpt from the source"),
+  relevance: z34.number().min(0).max(1),
+  metadata: z34.array(z34.object({ key: z34.string(), value: z34.string() })).optional()
 });
-var RetrievalResultSchema = z33.object({
-  subQuestion: z33.string(),
-  evidence: z33.array(EvidenceItemSchema)
+var RetrievalResultSchema = z34.object({
+  subQuestion: z34.string(),
+  evidence: z34.array(EvidenceItemSchema)
 });
-var CitationSchema = z33.object({
-  index: z33.number().describe("Citation number [1], [2], etc."),
-  chunkId: z33.string().describe("Source chunk ID, e.g. doc-123:coverage:2"),
-  documentId: z33.string(),
-  documentType: z33.enum(["policy", "quote"]).optional(),
-  field: z33.string().optional().describe("Specific field path, e.g. coverages[0].deductible"),
-  quote: z33.string().describe("Exact text from source that supports the claim"),
-  relevance: z33.number().min(0).max(1)
+var CitationSchema = z34.object({
+  index: z34.number().describe("Citation number [1], [2], etc."),
+  chunkId: z34.string().describe("Source chunk ID, e.g. doc-123:coverage:2"),
+  documentId: z34.string(),
+  documentType: z34.enum(["policy", "quote"]).optional(),
+  field: z34.string().optional().describe("Specific field path, e.g. coverages[0].deductible"),
+  quote: z34.string().describe("Exact text from source that supports the claim"),
+  relevance: z34.number().min(0).max(1)
 });
-var SubAnswerSchema = z33.object({
-  subQuestion: z33.string(),
-  answer: z33.string(),
-  citations: z33.array(CitationSchema),
-  confidence: z33.number().min(0).max(1),
-  needsMoreContext: z33.boolean().describe("True if evidence was insufficient to answer fully")
+var SubAnswerSchema = z34.object({
+  subQuestion: z34.string(),
+  answer: z34.string(),
+  citations: z34.array(CitationSchema),
+  confidence: z34.number().min(0).max(1),
+  needsMoreContext: z34.boolean().describe("True if evidence was insufficient to answer fully")
 });
-var VerifyResultSchema = z33.object({
-  approved: z33.boolean().describe("Whether all sub-answers are adequately grounded"),
-  issues: z33.array(z33.string()).describe("Specific grounding or consistency issues found"),
-  retrySubQuestions: z33.array(z33.string()).optional().describe("Sub-questions that need additional retrieval or re-reasoning")
+var VerifyResultSchema = z34.object({
+  approved: z34.boolean().describe("Whether all sub-answers are adequately grounded"),
+  issues: z34.array(z34.string()).describe("Specific grounding or consistency issues found"),
+  retrySubQuestions: z34.array(z34.string()).optional().describe("Sub-questions that need additional retrieval or re-reasoning")
 });
-var QueryResultSchema = z33.object({
-  answer: z33.string(),
-  citations: z33.array(CitationSchema),
+var QueryResultSchema = z34.object({
+  answer: z34.string(),
+  citations: z34.array(CitationSchema),
   intent: QueryIntentSchema,
-  confidence: z33.number().min(0).max(1),
-  followUp: z33.string().optional().describe("Suggested follow-up question if applicable")
+  confidence: z34.number().min(0).max(1),
+  followUp: z34.string().optional().describe("Suggested follow-up question if applicable")
 });
 
 // src/query/retriever.ts
@@ -5579,6 +6275,112 @@ async function verify(originalQuestion, subAnswers, allEvidence, config) {
   return { result: object, usage };
 }
 
+// src/query/quality.ts
+function sourceIdForEvidence(evidence) {
+  return evidence.chunkId ?? evidence.documentId ?? evidence.turnId;
+}
+function citationSourceId(citation) {
+  return citation.chunkId || citation.documentId;
+}
+function buildQueryReviewReport(params) {
+  const { subAnswers, evidence, finalResult, verifyRounds } = params;
+  const issues = [];
+  const evidenceBySource = /* @__PURE__ */ new Map();
+  for (const item of evidence) {
+    const sourceId = sourceIdForEvidence(item);
+    if (!sourceId) continue;
+    evidenceBySource.set(sourceId, [...evidenceBySource.get(sourceId) ?? [], item]);
+  }
+  for (const subAnswer of subAnswers) {
+    if (!subAnswer.needsMoreContext && subAnswer.citations.length === 0) {
+      issues.push({
+        code: "subanswer_missing_citations",
+        severity: "blocking",
+        message: `Sub-answer "${subAnswer.subQuestion}" has no citations despite claiming an answer.`,
+        subQuestion: subAnswer.subQuestion
+      });
+    }
+    if (subAnswer.confidence >= 0.85 && subAnswer.citations.length === 0) {
+      issues.push({
+        code: "subanswer_high_confidence_without_citations",
+        severity: "blocking",
+        message: `Sub-answer "${subAnswer.subQuestion}" has high confidence without citations.`,
+        subQuestion: subAnswer.subQuestion
+      });
+    }
+    for (const citation of subAnswer.citations) {
+      const sourceId = citationSourceId(citation);
+      const supportedEvidence = sourceId ? evidenceBySource.get(sourceId) ?? [] : [];
+      if (!sourceId || supportedEvidence.length === 0) {
+        issues.push({
+          code: "citation_missing_from_evidence",
+          severity: "blocking",
+          message: `Citation [${citation.index}] in "${subAnswer.subQuestion}" does not map to retrieved evidence.`,
+          subQuestion: subAnswer.subQuestion,
+          citationIndex: citation.index,
+          sourceId
+        });
+        continue;
+      }
+      const quoteFound = supportedEvidence.some((item) => item.text.includes(citation.quote));
+      if (!quoteFound) {
+        issues.push({
+          code: "citation_quote_not_in_evidence",
+          severity: "warning",
+          message: `Citation [${citation.index}] quote in "${subAnswer.subQuestion}" was not found verbatim in retrieved evidence.`,
+          subQuestion: subAnswer.subQuestion,
+          citationIndex: citation.index,
+          sourceId
+        });
+      }
+    }
+  }
+  if (finalResult) {
+    if (finalResult.answer.trim().length > 0 && finalResult.citations.length === 0 && finalResult.confidence > 0.4) {
+      issues.push({
+        code: "final_answer_missing_citations",
+        severity: "blocking",
+        message: "Final answer has non-trivial confidence but no citations."
+      });
+    }
+    const knownCitationIds = new Set(
+      subAnswers.flatMap((sa) => sa.citations.map((citation) => `${citation.index}|${citation.chunkId}|${citation.documentId}`))
+    );
+    for (const citation of finalResult.citations) {
+      const key = `${citation.index}|${citation.chunkId}|${citation.documentId}`;
+      if (!knownCitationIds.has(key)) {
+        issues.push({
+          code: "final_answer_unknown_citation",
+          severity: "warning",
+          message: `Final answer citation [${citation.index}] was not present in verified sub-answers.`,
+          citationIndex: citation.index,
+          sourceId: citationSourceId(citation)
+        });
+      }
+    }
+  }
+  const rounds = verifyRounds.map((round) => ({
+    round: round.round,
+    kind: "verification",
+    status: round.approved && round.issues.length === 0 ? "passed" : "warning",
+    summary: round.issues[0] ?? (round.approved ? "Verification passed." : "Verification requested retry.")
+  }));
+  const artifacts = [
+    { kind: "evidence", label: "Retrieved Evidence", itemCount: evidence.length },
+    { kind: "sub_answers", label: "Sub Answers", itemCount: subAnswers.length }
+  ];
+  return {
+    issues,
+    rounds,
+    artifacts,
+    verifyRounds,
+    qualityGateStatus: evaluateQualityGate({
+      issues,
+      hasRoundWarnings: verifyRounds.some((round) => !round.approved || round.issues.length > 0)
+    })
+  };
+}
+
 // src/query/coordinator.ts
 function createQueryAgent(config) {
   const {
@@ -5592,7 +6394,8 @@ function createQueryAgent(config) {
     onTokenUsage,
     onProgress,
     log,
-    providerOptions
+    providerOptions,
+    qualityGate = "warn"
   } = config;
   const limit = pLimit(concurrency);
   let totalUsage = { inputTokens: 0, outputTokens: 0 };
@@ -5661,6 +6464,7 @@ function createQueryAgent(config) {
     await pipelineCtx.save("reason", { classification, evidence: allEvidence, subAnswers });
     onProgress?.("Verifying answer grounding...");
     const verifierConfig = { generateObject, providerOptions };
+    const verifyRounds = [];
     for (let round = 0; round < maxVerifyRounds; round++) {
       const { result: verifyResult, usage } = await safeVerify(
         question,
@@ -5669,6 +6473,12 @@ function createQueryAgent(config) {
         verifierConfig
       );
       trackUsage(usage);
+      verifyRounds.push({
+        round: round + 1,
+        approved: verifyResult.approved,
+        issues: verifyResult.issues,
+        retrySubQuestions: verifyResult.retrySubQuestions
+      });
       if (verifyResult.approved) {
         onProgress?.("Verification passed.");
         break;
@@ -5726,6 +6536,24 @@ function createQueryAgent(config) {
       classification,
       context?.platform
     );
+    const reviewReport = buildQueryReviewReport({
+      subAnswers,
+      evidence: allEvidence,
+      finalResult: queryResult,
+      verifyRounds
+    });
+    await pipelineCtx.save("review", {
+      classification,
+      evidence: allEvidence,
+      subAnswers,
+      reviewReport
+    });
+    if (reviewReport.issues.length > 0) {
+      await log?.(`Query deterministic review issues: ${reviewReport.issues.map((issue) => issue.message).join("; ")}`);
+    }
+    if (shouldFailQualityGate(qualityGate, reviewReport.qualityGateStatus)) {
+      throw new Error("Query quality gate failed. See reviewReport for blocking issues.");
+    }
     if (conversationId) {
       try {
         await memoryStore.addTurn({
@@ -5746,7 +6574,7 @@ function createQueryAgent(config) {
         await log?.(`Failed to store conversation turn: ${e}`);
       }
     }
-    return { ...queryResult, tokenUsage: totalUsage };
+    return { ...queryResult, tokenUsage: totalUsage, reviewReport };
   }
   async function classify(question, conversationId) {
     let conversationContext;
@@ -5967,7 +6795,12 @@ export {
   AdmittedStatusSchema,
   AnswerParsingResultSchema,
   ApplicationClassifyResultSchema,
+  ApplicationEmailReviewSchema,
   ApplicationFieldSchema,
+  ApplicationQualityArtifactSchema,
+  ApplicationQualityIssueSchema,
+  ApplicationQualityReportSchema,
+  ApplicationQualityRoundSchema,
   ApplicationStateSchema,
   AuditTypeSchema,
   AutoFillMatchSchema,
@@ -5999,6 +6832,7 @@ export {
   CoverageFormSchema,
   CoverageSchema,
   CoverageTriggerSchema,
+  CoverageValueTypeSchema,
   CrimeDeclarationsSchema,
   CyberDeclarationsSchema,
   DEDUCTIBLE_TYPES,