@talonic/docs 0.17.0 → 0.17.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -5052,6 +5052,7 @@ var NAV_SECTIONS2 = [
5052
5052
  { id: "field-registry", label: "Field Registry" },
5053
5053
  { id: "tier-system", label: "Tier System" },
5054
5054
  { id: "semantic-clusters", label: "Semantic Clusters" },
5055
+ { id: "field-resolution", label: "Field Resolution" },
5055
5056
  { id: "master-instructions", label: "Master Instructions" }
5056
5057
  ]
5057
5058
  },
@@ -5115,13 +5116,22 @@ var NAV_SECTIONS2 = [
5115
5116
  { id: "document-graph", label: "Document Graph" }
5116
5117
  ]
5117
5118
  },
5119
+ {
5120
+ id: "data-products",
5121
+ label: "Data Products",
5122
+ children: [
5123
+ { id: "dataset-templates", label: "Dataset Templates" },
5124
+ { id: "assemblies", label: "Assemblies" }
5125
+ ]
5126
+ },
5118
5127
  {
5119
5128
  id: "validation-quality",
5120
5129
  label: "Validation & Quality",
5121
5130
  children: [
5122
5131
  { id: "validation-checks", label: "Validation Checks" },
5123
5132
  { id: "ground-truth", label: "Golden Samples" },
5124
- { id: "approval-gates", label: "Approval Gates" }
5133
+ { id: "approval-gates", label: "Approval Gates" },
5134
+ { id: "approval-queue", label: "Approval Queue" }
5125
5135
  ]
5126
5136
  },
5127
5137
  {
@@ -5530,6 +5540,25 @@ function PlatformGuide({ LinkComponent }) {
5530
5540
  ] }),
5531
5541
  /* @__PURE__ */ jsx6(SubHeading, { id: "semantic-clusters", children: "Semantic Clusters" }),
5532
5542
  /* @__PURE__ */ jsx6(P, { children: 'Fields with similar meanings are automatically grouped using AI embeddings. For example, "Vendor Name", "Supplier Name", and "Company Name" cluster together. You can manually merge or split clusters from the Field Map view.' }),
5543
+ /* @__PURE__ */ jsx6(SubHeading, { id: "field-resolution", children: "Field Resolution" }),
5544
+ /* @__PURE__ */ jsx6(P, { children: "When a document is processed, each extracted field is resolved against the registry using a three-band matching model. The bands determine whether a match is accepted automatically, flagged for confirmation, or treated as a new field." }),
5545
+ /* @__PURE__ */ jsx6(
5546
+ ParamTable,
5547
+ {
5548
+ params: [
5549
+ { name: "Auto band", type: "\u2265 0.80 similarity", description: "High-confidence match. The field is linked to the existing registry entry and its occurrence count is incremented." },
5550
+ { name: "Confirm band", type: "0.50 \u2013 0.79", description: "Candidate match. The field is linked but flagged for manual review in the reconciliation queue." },
5551
+ { name: "New band", type: "< 0.50", description: "No match found. A new Tier 3 field and cluster are created in the registry." }
5552
+ ]
5553
+ }
5554
+ ),
5555
+ /* @__PURE__ */ jsx6(P, { children: "Resolution runs concurrently across documents. Each document\u2019s fields are resolved in an isolated transaction to prevent lock contention. Occurrence rates are updated after each transaction commits, keeping the registry eventually consistent without blocking concurrent ingestion." }),
5556
+ /* @__PURE__ */ jsxs6(Callout, { children: [
5557
+ "Pending confirmations from the confirm band appear in",
5558
+ " ",
5559
+ /* @__PURE__ */ jsx6("strong", { children: "Resolution \u2192 Pending Confirmations" }),
5560
+ ". Accept to merge into an existing cluster, or reject to create a new field."
5561
+ ] }),
5533
5562
  /* @__PURE__ */ jsx6(SubHeading, { id: "master-instructions", children: "Master Instructions" }),
5534
5563
  /* @__PURE__ */ jsxs6(P, { children: [
5535
5564
  "As the same field is extracted from many documents, AI synthesizes a ",
@@ -5876,6 +5905,23 @@ function PlatformGuide({ LinkComponent }) {
5876
5905
  /* @__PURE__ */ jsx6(P, { children: "Each case detail page shows: documents, shared entities, evidence chain (which field keys produced each connection), timeline, and auto-generated AI narration." }),
5877
5906
  /* @__PURE__ */ jsx6(SubHeading, { id: "document-graph", children: "Document Graph" }),
5878
5907
  /* @__PURE__ */ jsx6(P, { children: "The Document Graph provides a visual D3-force layout of the bipartite graph. Toggle between graph and list views from the Cases page. Case templates are auto-discovered after 3+ cases form \u2014 they identify recurring document type patterns." }),
5908
+ /* @__PURE__ */ jsx6(SectionHeading, { id: "data-products", children: "Data Products" }),
5909
+ /* @__PURE__ */ jsx6(P, { children: "Data Products package your extraction and resolution outputs into reusable, shareable artifacts. Dataset Templates define the shape; Assemblies combine sources into a single structured dataset." }),
5910
+ /* @__PURE__ */ jsx6(SubHeading, { id: "dataset-templates", children: "Dataset Templates" }),
5911
+ /* @__PURE__ */ jsx6(P, { children: "A dataset template defines a reusable output specification: which schema to use, which document types to include, column mappings, and default transforms. Templates ensure consistent data product generation across teams and time periods." }),
5912
+ /* @__PURE__ */ jsxs6(P, { children: [
5913
+ "Navigate to ",
5914
+ /* @__PURE__ */ jsx6("strong", { children: "Data Products \u2192 Dataset Templates" }),
5915
+ " to manage templates. Each template is linked to a user schema and can be versioned independently. When creating a new job, select a template instead of configuring the output from scratch."
5916
+ ] }),
5917
+ /* @__PURE__ */ jsx6(SubHeading, { id: "assemblies", children: "Assemblies" }),
5918
+ /* @__PURE__ */ jsx6(P, { children: "An assembly combines documents from one or more sources into a single structured dataset based on a template. Assemblies track their constituent documents, source counts, and processing status." }),
5919
+ /* @__PURE__ */ jsxs6(P, { children: [
5920
+ "Navigate to ",
5921
+ /* @__PURE__ */ jsx6("strong", { children: "Data Products \u2192 Assemblies" }),
5922
+ " to view and create assemblies. Each assembly shows its document count, linked schema, processing status, and the date it was created."
5923
+ ] }),
5924
+ /* @__PURE__ */ jsx6(Callout, { children: "Assemblies are the recommended way to produce production datasets. They provide a single audit trail from source documents through extraction, resolution, and validation to the final output." }),
5879
5925
  /* @__PURE__ */ jsx6(SectionHeading, { id: "validation-quality", children: "Validation & Quality" }),
5880
5926
  /* @__PURE__ */ jsx6(P, { children: "Multiple layers of quality assurance: automated validation checks, ground truth benchmarking, and configurable approval gates." }),
5881
5927
  /* @__PURE__ */ jsx6(SubHeading, { id: "validation-checks", children: "Validation Checks" }),
@@ -5895,6 +5941,13 @@ function PlatformGuide({ LinkComponent }) {
5895
5941
  /* @__PURE__ */ jsx6(InlineCode, { children: "result.approved" }),
5896
5942
  " signal to a destination to only ship approved rows to your downstream systems."
5897
5943
  ] }),
5944
+ /* @__PURE__ */ jsx6(SubHeading, { id: "approval-queue", children: "Approval Queue" }),
5945
+ /* @__PURE__ */ jsxs6(P, { children: [
5946
+ "Results that do not meet auto-approval thresholds are routed to the Approval Queue. Navigate to ",
5947
+ /* @__PURE__ */ jsx6("strong", { children: "Review \u2192 Approval Queue" }),
5948
+ " to see all pending items. Each row shows the source document, schema, confidence score, and whether the result has been flagged by a validation rule."
5949
+ ] }),
5950
+ /* @__PURE__ */ jsx6(P, { children: "Filter the queue by status (pending, flagged), schema, or confidence range. Click \u201CReview\u201D on any row to inspect the extracted values, provenance trails, and validation check results before approving or rejecting." }),
5898
5951
  /* @__PURE__ */ jsx6(SectionHeading, { id: "delivery", children: "Delivery" }),
5899
5952
  /* @__PURE__ */ jsx6(P, { children: "Push extracted, resolved, and reviewed data to any downstream system. Delivery is a typed, at-least-once pipeline with idempotency keys on the wire, append-only history, and a dead-letter queue for terminal failures." }),
5900
5953
  /* @__PURE__ */ jsx6(SubHeading, { id: "delivery-pipeline", children: "How Delivery Works" }),
@@ -6483,6 +6536,7 @@ var PLATFORM_NAV_SECTIONS = [
6483
6536
  { id: "field-registry", label: "Field Registry" },
6484
6537
  { id: "tier-system", label: "Tier System" },
6485
6538
  { id: "semantic-clusters", label: "Semantic Clusters" },
6539
+ { id: "field-resolution", label: "Field Resolution" },
6486
6540
  { id: "master-instructions", label: "Master Instructions" }
6487
6541
  ] },
6488
6542
  { id: "schemas-templates", label: "Schemas & Templates", children: [
@@ -6510,10 +6564,15 @@ var PLATFORM_NAV_SECTIONS = [
6510
6564
  { id: "cases", label: "Cases" },
6511
6565
  { id: "document-graph", label: "Document Graph" }
6512
6566
  ] },
6567
+ { id: "data-products", label: "Data Products", children: [
6568
+ { id: "dataset-templates", label: "Dataset Templates" },
6569
+ { id: "assemblies", label: "Assemblies" }
6570
+ ] },
6513
6571
  { id: "validation-quality", label: "Validation & Quality", children: [
6514
6572
  { id: "validation-checks", label: "Validation Checks" },
6515
6573
  { id: "ground-truth", label: "Golden Samples" },
6516
- { id: "approval-gates", label: "Approval Gates" }
6574
+ { id: "approval-gates", label: "Approval Gates" },
6575
+ { id: "approval-queue", label: "Approval Queue" }
6517
6576
  ] },
6518
6577
  { id: "delivery", label: "Outputs", children: [
6519
6578
  { id: "destinations", label: "Destinations" },
@@ -6576,7 +6635,8 @@ var PLATFORM_SECTION_META = [
6576
6635
  { id: "structuring", title: "Structuring", description: "Vocabulary-driven structuring system with seven field strategies, four processing tiers, capture sub-moves, modifiers, constraints, and synthesize fallback." },
6577
6636
  { id: "extraction-jobs", title: "Extraction Jobs", description: "The 4-phase pipeline: Resolve, Agent, Validation, Re-read. Progressive grid filling with per-cell provenance and confidence." },
6578
6637
  { id: "linking-cases", title: "Linking & Cases", description: "Document linking discovers relationships through shared entities. Related documents grouped into cases with evidence chains." },
6579
- { id: "validation-quality", title: "Validation & Quality", description: "Automated validation checks, golden sample benchmarking, and configurable approval gates for quality assurance." },
6638
+ { id: "data-products", title: "Data Products", description: "Dataset templates for reusable output specifications and assemblies for combining multi-source documents into structured datasets." },
6639
+ { id: "validation-quality", title: "Validation & Quality", description: "Automated validation checks, golden sample benchmarking, configurable approval gates, and a manual review queue for flagged results." },
6580
6640
  { id: "delivery", title: "Outputs & Delivery", description: "Push structured data to webhooks, REST APIs, SFTP, email, or cloud storage with field mappings, triggers, delivery configuration, and telemetry." },
6581
6641
  { id: "workspace-settings", title: "Workspace Settings", description: "Shared dialects for output formatting, reference primitives for lookup tables, and change review governance for production workspaces." },
6582
6642
  { id: "search-filtering", title: "Search & Filtering", description: "Global omnisearch (Cmd+K) and advanced document filtering by extracted field values with saved presets." },