@absolutejs/rag 0.0.14 → 0.0.16

package/dist/index.js

@@ -11221,6 +11221,161 @@ var summarizeRAGRetrievalComparison = (entries) => ({
   bestByLowestRuntimeCandidateBudgetExhaustedCases: selectComparisonEntryByLowestTraceMetric(entries, "retrievalId", "runtimeCandidateBudgetExhaustedCases"),
   bestByLowestRuntimeUnderfilledTopKCases: selectComparisonEntryByLowestTraceMetric(entries, "retrievalId", "runtimeUnderfilledTopKCases")
 });
+// src/presentation/htmxRenderers.ts
+var STREAM_STAGES = [
+  "submitting",
+  "retrieving",
+  "retrieved",
+  "streaming",
+  "complete"
+];
+var escapeHtml = (text) => text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+var formatTime = (timestamp) => {
+  if (!timestamp) {
+    return "n/a";
+  }
+  return new Date(timestamp).toLocaleTimeString([], {
+    hour: "numeric",
+    minute: "2-digit",
+    second: "2-digit"
+  });
+};
+var formatDuration = (durationMs) => typeof durationMs !== "number" || durationMs < 0 ? "n/a" : `${durationMs}ms`;
+var makeTracePanel = (prefix) => ({
+  title,
+  summary,
+  trace
+}) => {
+  if (!trace) {
+    return "";
+  }
+  const presentation = buildRAGRetrievalTracePresentation(trace);
+  return [
+    `<div class="${prefix}-results">`,
+    `<h4>${escapeHtml(title)}</h4>`,
+    `<p class="${prefix}-metadata">${escapeHtml(summary)}</p>`,
+    `<div class="${prefix}-stat-grid">`,
+    presentation.stats.map((row) => `<article class="${prefix}-stat-card"><p class="${prefix}-section-caption">${escapeHtml(row.label)}</p><strong>${escapeHtml(row.value)}</strong></article>`).join(""),
+    "</div>",
+    "<div>",
+    presentation.details.map((row) => `<p class="${prefix}-key-value-row"><strong>${escapeHtml(row.label)}</strong><span>${escapeHtml(row.value)}</span></p>`).join(""),
+    "</div>",
+    `<div class="${prefix}-result-grid">`,
+    presentation.steps.map((step, index) => `<details class="${prefix}-collapsible ${prefix}-result-item" ${index === 0 ? "open" : ""}><summary><strong>${index + 1}. ${escapeHtml(step.label)}</strong></summary>${step.rows.map((row) => `<p class="${prefix}-key-value-row"><strong>${escapeHtml(row.label)}</strong><span>${escapeHtml(row.value)}</span></p>`).join("")}</details>`).join(""),
+    "</div>",
+    "</div>"
+  ].join("");
+};
+var makeStageRow = (prefix) => (currentStage) => `<div class="${prefix}-stage-row">${STREAM_STAGES.map((stage) => {
+  const classNames = [`${prefix}-stage-pill`];
+  if (stage === "complete") {
+    classNames.push("complete");
+  }
+  if (stage === currentStage) {
+    classNames.push("current");
+  }
+  return `<span class="${classNames.join(" ")}">${escapeHtml(stage)}</span>`;
+}).join("")}</div>`;
+var makeCapabilities = (prefix) => (capabilities) => {
+  if (!capabilities) {
+    return `<p class="${prefix}-metadata">Backend capabilities unavailable.</p>`;
+  }
+  const values = [
+    capabilities.backend,
+    capabilities.persistence,
+    capabilities.nativeVectorSearch ? "native vector search" : "managed fallback search",
+    capabilities.serverSideFiltering ? "server-side filters" : "client-side filters",
+    capabilities.streamingIngestStatus ? "streaming ingest status" : "polled ingest status"
+  ];
+  return `<p class="${prefix}-metadata">Backend capabilities: <strong>${escapeHtml(values.join(" \xB7 "))}</strong></p>`;
+};
+var defaultNativeSource = (status) => {
+  const native = status?.native;
+  if (!native || !native.active) {
+    return "Not applicable";
+  }
+  if (status?.backend === "sqlite") {
+    return "Packaged sqlite-vec";
+  }
+  if (status?.backend === "postgres") {
+    return "PostgreSQL pgvector extension";
+  }
+  return "Managed by AbsoluteJS";
+};
+var defaultStatusSummary = (status) => {
+  if (!status) {
+    return "No backend status is available.";
+  }
+  if (status.native?.active) {
+    return "Native vector acceleration is active.";
+  }
+  if (status.vectorMode === "json_fallback") {
+    return "Owned JSON fallback retrieval is active.";
+  }
+  return `Vector mode ${status.vectorMode} is active.`;
+};
+var defaultStatusMessage = (status) => {
+  if (!status) {
+    return "Backend status unavailable.";
+  }
+  return status.native?.fallbackReason ?? defaultStatusSummary(status);
+};
+var makeDetailList = (prefix) => (lines, fallback) => {
+  const values = lines.length > 0 ? lines : [fallback];
+  return `<ul class="${prefix}-detail-list">${values.map((line) => `<li>${escapeHtml(line)}</li>`).join("")}</ul>`;
+};
+var makeAdminJobCards = (prefix) => (jobs) => {
+  const records = (jobs ?? []).slice(0, 3);
+  if (records.length === 0) {
+    return `<p class="${prefix}-metadata">No admin jobs recorded yet.</p>`;
+  }
+  return `<div class="${prefix}-stat-grid">${records.map((job) => {
+    const target = job.target ?? "global";
+    const timing = typeof job.startedAt === "number" ? formatTime(job.startedAt) : "n/a";
+    return `<article class="${prefix}-stat-card">
+        <span class="${prefix}-stat-label">${escapeHtml(job.action)}</span>
+        <strong>${escapeHtml(job.status.toUpperCase())}</strong>
+        <p>${escapeHtml(target)}</p>
+        <div class="${prefix}-key-value-list">
+          <div class="${prefix}-key-value-row"><span>Started</span><strong>${escapeHtml(timing)}</strong></div>
+          ${typeof job.elapsedMs === "number" ? `<div class="${prefix}-key-value-row"><span>Elapsed</span><strong>${escapeHtml(formatDuration(job.elapsedMs))}</strong></div>` : ""}
+        </div>
+      </article>`;
+  }).join("")}</div>`;
+};
+var makeAdminActionCards = (prefix) => (actions) => {
+  const records = (actions ?? []).slice(0, 3);
+  if (records.length === 0) {
+    return `<p class="${prefix}-metadata">No admin actions recorded yet.</p>`;
+  }
+  return `<div class="${prefix}-stat-grid">${records.map((action) => {
+    const target = action.documentId ?? action.target ?? "global";
+    const timing = typeof action.elapsedMs === "number" ? formatDuration(action.elapsedMs) : typeof action.startedAt === "number" ? formatTime(action.startedAt) : "n/a";
+    return `<article class="${prefix}-stat-card">
+        <span class="${prefix}-stat-label">${escapeHtml(action.action)}</span>
+        <strong>${escapeHtml(action.status.toUpperCase())}</strong>
+        <p>${escapeHtml(target)}</p>
+        <div class="${prefix}-key-value-list">
+          <div class="${prefix}-key-value-row"><span>When</span><strong>${escapeHtml(timing)}</strong></div>
+        </div>
+      </article>`;
+  }).join("")}</div>`;
+};
+var resolveRAGHTMXRenderers = (custom = {}) => {
+  const classPrefix = custom.classPrefix ?? "rag";
+  return {
+    adminActionCards: custom.adminActionCards ?? makeAdminActionCards(classPrefix),
+    adminJobCards: custom.adminJobCards ?? makeAdminJobCards(classPrefix),
+    capabilities: custom.capabilities ?? makeCapabilities(classPrefix),
+    classPrefix,
+    detailList: custom.detailList ?? makeDetailList(classPrefix),
+    nativeSource: custom.nativeSource ?? defaultNativeSource,
+    stageRow: custom.stageRow ?? makeStageRow(classPrefix),
+    statusMessage: custom.statusMessage ?? defaultStatusMessage,
+    statusSummary: custom.statusSummary ?? defaultStatusSummary,
+    tracePanel: custom.tracePanel ?? makeTracePanel(classPrefix)
+  };
+};
 // src/chat/chat.ts
 import { Elysia } from "elysia";
 
@@ -21131,8 +21286,8 @@ var ingestRAGDocuments = async (collection, input) => collection.ingest(buildRAG
 var searchDocuments = async (collection, input) => collection.search(input);
 
 // src/presentation/htmxWorkflowRenderers.ts
-var escapeHtml = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-var renderLabelValueRows = (rows) => rows.length > 0 ? `<dl class="rag-status">${rows.map((row) => `<div><dt>${escapeHtml(row.label)}</dt><dd>${escapeHtml(row.value)}</dd></div>`).join("")}</dl>` : "";
+var escapeHtml2 = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+var renderLabelValueRows = (rows) => rows.length > 0 ? `<dl class="rag-status">${rows.map((row) => `<div><dt>${escapeHtml2(row.label)}</dt><dd>${escapeHtml2(row.value)}</dd></div>`).join("")}</dl>` : "";
 var renderBenchmarkRuntimePanel = (input) => {
   const rows = [
     {
@@ -21146,7 +21301,7 @@ var renderBenchmarkRuntimePanel = (input) => {
   const recentRuns = input.response.historyPresentation?.recentRuns ?? [];
   const snapshotRows = input.response.snapshotHistoryPresentation?.rows ?? [];
   const snapshots = input.response.snapshotHistoryPresentation?.snapshots ?? [];
-  return `<section class="rag-status-governance"><h3>${escapeHtml(input.title)}</h3>` + renderLabelValueRows(rows) + `<h4>Run history</h4>` + renderLabelValueRows(latestRows) + (recentRuns.length > 0 ? `<ul class="rag-status-capabilities">${recentRuns.slice(0, 3).map((run) => `<li><strong>${escapeHtml(run.label)}</strong> ${escapeHtml(run.summary)}</li>`).join("")}</ul>` : `<p class="rag-empty">No persisted benchmark runs yet.</p>`) + `<h4>Snapshot history</h4>` + renderLabelValueRows(snapshotRows) + (snapshots.length > 0 ? `<ul class="rag-status-capabilities">${snapshots.slice(0, 3).map((snapshot) => `<li><strong>${escapeHtml(snapshot.label)}</strong> ${escapeHtml(snapshot.summary)}</li>`).join("")}</ul>` : `<p class="rag-empty">No saved suite snapshots yet.</p>`) + `</section>`;
+  return `<section class="rag-status-governance"><h3>${escapeHtml2(input.title)}</h3>` + renderLabelValueRows(rows) + `<h4>Run history</h4>` + renderLabelValueRows(latestRows) + (recentRuns.length > 0 ? `<ul class="rag-status-capabilities">${recentRuns.slice(0, 3).map((run) => `<li><strong>${escapeHtml2(run.label)}</strong> ${escapeHtml2(run.summary)}</li>`).join("")}</ul>` : `<p class="rag-empty">No persisted benchmark runs yet.</p>`) + `<h4>Snapshot history</h4>` + renderLabelValueRows(snapshotRows) + (snapshots.length > 0 ? `<ul class="rag-status-capabilities">${snapshots.slice(0, 3).map((snapshot) => `<li><strong>${escapeHtml2(snapshot.label)}</strong> ${escapeHtml2(snapshot.summary)}</li>`).join("")}</ul>` : `<p class="rag-empty">No saved suite snapshots yet.</p>`) + `</section>`;
 };
 var renderBenchmarkSnapshotPanel = (input) => {
   const summaryRows = [
@@ -21161,16 +21316,16 @@ var renderBenchmarkSnapshotPanel = (input) => {
   ].filter((row) => Boolean(row));
   const snapshotRows = input.response.snapshotHistoryPresentation?.rows ?? [];
   const snapshots = input.response.snapshotHistoryPresentation?.snapshots ?? [];
-  return `<section class="rag-status-governance"><h3>${escapeHtml(input.title)}</h3>` + renderLabelValueRows(summaryRows) + renderLabelValueRows(snapshotRows) + (snapshots.length > 0 ? `<ul class="rag-status-capabilities">${snapshots.slice(0, 3).map((snapshot) => `<li><strong>${escapeHtml(snapshot.label)}</strong> ${escapeHtml(snapshot.summary)}</li>`).join("")}</ul>` : `<p class="rag-empty">No saved suite snapshots yet.</p>`) + `</section>`;
+  return `<section class="rag-status-governance"><h3>${escapeHtml2(input.title)}</h3>` + renderLabelValueRows(summaryRows) + renderLabelValueRows(snapshotRows) + (snapshots.length > 0 ? `<ul class="rag-status-capabilities">${snapshots.slice(0, 3).map((snapshot) => `<li><strong>${escapeHtml2(snapshot.label)}</strong> ${escapeHtml2(snapshot.summary)}</li>`).join("")}</ul>` : `<p class="rag-empty">No saved suite snapshots yet.</p>`) + `</section>`;
 };
 var renderSourceLabels = (input) => {
   if (!input) {
     return "";
   }
   const rows = [
-    input.contextLabel ? `<li><strong>Context</strong> ${escapeHtml(input.contextLabel)}</li>` : "",
-    input.locatorLabel ? `<li><strong>Location</strong> ${escapeHtml(input.locatorLabel)}</li>` : "",
-    input.provenanceLabel ? `<li><strong>Provenance</strong> ${escapeHtml(input.provenanceLabel)}</li>` : ""
+    input.contextLabel ? `<li><strong>Context</strong> ${escapeHtml2(input.contextLabel)}</li>` : "",
+    input.locatorLabel ? `<li><strong>Location</strong> ${escapeHtml2(input.locatorLabel)}</li>` : "",
+    input.provenanceLabel ? `<li><strong>Provenance</strong> ${escapeHtml2(input.provenanceLabel)}</li>` : ""
   ].filter((row) => row.length > 0);
   return rows.length > 0 ? `<ul class="rag-source-labels">${rows.join("")}</ul>` : "";
 };
@@ -21199,12 +21354,12 @@ var renderChunkStructure = (structure) => {
     return "";
   }
   const rows = [
-    structure.section?.kind ? `<li><strong>Kind</strong> ${escapeHtml(formatStructureKindLabel(structure.section.kind) ?? structure.section.kind)}</li>` : "",
-    structure.section?.title ? `<li><strong>Section</strong> ${escapeHtml(structure.section.title)}</li>` : "",
-    structure.section?.path && structure.section.path.length > 1 ? `<li><strong>Section path</strong> ${escapeHtml(structure.section.path.join(" > "))}</li>` : "",
+    structure.section?.kind ? `<li><strong>Kind</strong> ${escapeHtml2(formatStructureKindLabel(structure.section.kind) ?? structure.section.kind)}</li>` : "",
+    structure.section?.title ? `<li><strong>Section</strong> ${escapeHtml2(structure.section.title)}</li>` : "",
+    structure.section?.path && structure.section.path.length > 1 ? `<li><strong>Section path</strong> ${escapeHtml2(structure.section.path.join(" > "))}</li>` : "",
     typeof structure.sequence?.sectionChunkIndex === "number" && typeof structure.sequence?.sectionChunkCount === "number" ? `<li><strong>Section chunk</strong> ${structure.sequence.sectionChunkIndex + 1} of ${structure.sequence.sectionChunkCount}</li>` : "",
-    structure.sequence?.previousChunkId ? `<li><strong>Previous</strong> ${escapeHtml(structure.sequence.previousChunkId)}</li>` : "",
-    structure.sequence?.nextChunkId ? `<li><strong>Next</strong> ${escapeHtml(structure.sequence.nextChunkId)}</li>` : ""
+    structure.sequence?.previousChunkId ? `<li><strong>Previous</strong> ${escapeHtml2(structure.sequence.previousChunkId)}</li>` : "",
+    structure.sequence?.nextChunkId ? `<li><strong>Next</strong> ${escapeHtml2(structure.sequence.nextChunkId)}</li>` : ""
   ].filter((row) => row.length > 0);
   return rows.length > 0 ? `<ul class="rag-chunk-structure">${rows.join("")}</ul>` : "";
 };
@@ -21213,9 +21368,9 @@ var renderChunkExcerpts = (input) => {
     return "";
   }
   const rows = [
-    input.chunkExcerpt ? `<li><strong>Chunk excerpt</strong> ${escapeHtml(input.chunkExcerpt)}</li>` : "",
-    input.windowExcerpt ? `<li><strong>Neighbor window</strong> ${escapeHtml(input.windowExcerpt)}</li>` : "",
-    input.sectionExcerpt ? `<li><strong>Section excerpt</strong> ${escapeHtml(input.sectionExcerpt)}</li>` : ""
+    input.chunkExcerpt ? `<li><strong>Chunk excerpt</strong> ${escapeHtml2(input.chunkExcerpt)}</li>` : "",
+    input.windowExcerpt ? `<li><strong>Neighbor window</strong> ${escapeHtml2(input.windowExcerpt)}</li>` : "",
+    input.sectionExcerpt ? `<li><strong>Section excerpt</strong> ${escapeHtml2(input.sectionExcerpt)}</li>` : ""
   ].filter((row) => row.length > 0);
   return rows.length > 0 ? `<ul class="rag-chunk-structure">${rows.join("")}</ul>` : "";
 };
@@ -21225,17 +21380,17 @@ var renderExcerptSelection = (selection) => {
   }
   const modeLabel = selection.mode === "chunk" ? "Chunk excerpt" : selection.mode === "window" ? "Neighbor window" : "Section excerpt";
   const reasonLabel = selection.reason === "single_chunk" ? "single chunk" : selection.reason === "chunk_too_narrow" ? "chunk too narrow" : selection.reason === "section_small_enough" ? "section small enough" : "section too large, used window";
-  return `<ul class="rag-chunk-structure"><li><strong>Preferred excerpt</strong> ${escapeHtml(modeLabel)}</li><li><strong>Promotion reason</strong> ${escapeHtml(reasonLabel)}</li></ul>`;
+  return `<ul class="rag-chunk-structure"><li><strong>Preferred excerpt</strong> ${escapeHtml2(modeLabel)}</li><li><strong>Promotion reason</strong> ${escapeHtml2(reasonLabel)}</li></ul>`;
 };
 var renderSectionJumpList = (label, items) => {
-  const rows = items.map((item) => item.href ? `<li><strong>${escapeHtml(label)}</strong> <a href="${escapeHtml(item.href)}"${item.active ? ' aria-current="true"' : ""}>${escapeHtml(item.label)}</a></li>` : `<li><strong>${escapeHtml(label)}</strong> ${escapeHtml(item.label)}</li>`).join("");
+  const rows = items.map((item) => item.href ? `<li><strong>${escapeHtml2(label)}</strong> <a href="${escapeHtml2(item.href)}"${item.active ? ' aria-current="true"' : ""}>${escapeHtml2(item.label)}</a></li>` : `<li><strong>${escapeHtml2(label)}</strong> ${escapeHtml2(item.label)}</li>`).join("");
   return rows ? `<ul class="rag-chunk-structure">${rows}</ul>` : "";
 };
 var renderSectionDiagnostics = (diagnostics) => {
   if (diagnostics.length === 0) {
     return "";
   }
-  return `<section class="rag-search-results"><h3>Section diagnostics</h3>` + diagnostics.map((diagnostic) => `<article class="rag-search-result" id="rag-section-diagnostic-${escapeHtml(diagnostic.key)}">` + `<h4>${escapeHtml(diagnostic.path?.join(" > ") ?? diagnostic.label)}</h4>` + `<p class="rag-search-source">${escapeHtml(diagnostic.summary)}</p>` + `<ul class="rag-source-labels">` + `<li><strong>Top hit</strong> ${diagnostic.bestScore.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES)}</li>` + `<li><strong>Average</strong> ${diagnostic.averageScore.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES)}</li>` + `<li><strong>Sources</strong> ${diagnostic.sourceCount}</li>` + `<li><strong>Channels</strong> vector ${diagnostic.vectorHits} \xB7 lexical ${diagnostic.lexicalHits} \xB7 hybrid ${diagnostic.hybridHits}</li>` + `${diagnostic.topContextLabel ? `<li><strong>Lead context</strong> ${escapeHtml(diagnostic.topContextLabel)}</li>` : ""}` + `${diagnostic.topLocatorLabel ? `<li><strong>Lead location</strong> ${escapeHtml(diagnostic.topLocatorLabel)}</li>` : ""}` + `${diagnostic.sourceAwareChunkReasonLabel ? `<li><strong>Chunk boundary</strong> ${escapeHtml(diagnostic.sourceAwareChunkReasonLabel)}</li>` : ""}` + `${diagnostic.sourceAwareUnitScopeLabel ? `<li><strong>Source-aware scope</strong> ${escapeHtml(diagnostic.sourceAwareUnitScopeLabel)}</li>` : ""}` + `${diagnostic.stageCounts.length > 0 ? `<li><strong>Stage flow</strong> ${escapeHtml(diagnostic.stageCounts.map((entry) => `${entry.stage} ${entry.count}`).join(" \u2192 "))}</li>` : ""}` + `${diagnostic.firstSeenStage ? `<li><strong>First seen</strong> ${escapeHtml(diagnostic.firstSeenStage)}</li>` : ""}` + `${diagnostic.lastSeenStage ? `<li><strong>Last seen</strong> ${escapeHtml(diagnostic.lastSeenStage)}</li>` : ""}` + `<li><strong>Query attribution</strong> ${escapeHtml(`${diagnostic.queryAttribution.mode} \xB7 primary ${diagnostic.queryAttribution.primaryHits} \xB7 transformed ${diagnostic.queryAttribution.transformedHits} \xB7 variant ${diagnostic.queryAttribution.variantHits}`)}</li>` + `${diagnostic.queryAttribution.reasons.length > 0 ? `<li><strong>Query attribution reasons</strong> ${escapeHtml(diagnostic.queryAttribution.reasons.join(", "))}</li>` : ""}` + `${diagnostic.peakStage ? `<li><strong>Peak stage</strong> ${escapeHtml(diagnostic.peakStage)} (${diagnostic.peakCount})</li>` : ""}` + `${typeof diagnostic.finalRetentionRate === "number" ? `<li><strong>Final retention</strong> ${(diagnostic.finalRetentionRate * 100).toFixed(0)}%</li>` : ""}` + `${typeof diagnostic.dropFromPeak === "number" ? `<li><strong>Drop from peak</strong> ${diagnostic.dropFromPeak}</li>` : ""}` + `${diagnostic.retrievalMode ? `<li><strong>Trace mode</strong> ${escapeHtml(diagnostic.retrievalMode)}</li>` : ""}` + `${diagnostic.rerankApplied !== undefined ? `<li><strong>Rerank</strong> ${diagnostic.rerankApplied ? "applied" : "skipped"}</li>` : ""}` + `${diagnostic.sourceBalanceApplied ? `<li><strong>Source balance</strong> applied</li>` : ""}` + `${diagnostic.scoreThresholdApplied ? `<li><strong>Score threshold</strong> applied</li>` : ""}` + `<li><strong>Reasons</strong> ${escapeHtml(diagnostic.reasons.join(", ") || "none")}</li>` + `${diagnostic.strongestSiblingLabel ? `<li><strong>Strongest sibling</strong> ${escapeHtml(diagnostic.strongestSiblingLabel)} (${diagnostic.strongestSiblingScore?.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES) ?? "n/a"})</li>` : ""}` + `${typeof diagnostic.parentShareGap === "number" ? `<li><strong>Parent share gap</strong> ${(diagnostic.parentShareGap * 100).toFixed(0)}%</li>` : ""}` + `</ul>` + `${diagnostic.stageWeights.length > 0 ? `<ul class="rag-source-labels">${diagnostic.stageWeights.map((entry) => `<li><strong>${escapeHtml(entry.stage)}</strong> ${(entry.stageShare * 100).toFixed(0)}% of stage` + `${typeof entry.retentionRate === "number" ? ` \xB7 ${(entry.retentionRate * 100).toFixed(0)}% retained from ${escapeHtml(entry.previousStage ?? "previous")}` : ""}` + `${typeof entry.countDelta === "number" ? ` \xB7 delta ${entry.countDelta >= 0 ? "+" : ""}${entry.countDelta}` : ""}` + `${typeof entry.stageScoreShare === "number" ? ` \xB7 ${(entry.stageScoreShare * 100).toFixed(0)}% of stage score` : ""}` + `${typeof entry.parentStageScoreShare === "number" ? ` \xB7 ${(entry.parentStageScoreShare * 100).toFixed(0)}% of parent stage score` : ""}` + `${typeof entry.stageScoreShareGap === "number" ? ` \xB7 score gap ${(entry.stageScoreShareGap * 100).toFixed(0)}%` : ""}` + `${typeof entry.parentStageShare === "number" ? ` \xB7 ${(entry.parentStageShare * 100).toFixed(0)}% of parent stage` : ""}` + `${typeof entry.stageShareGap === "number" ? ` \xB7 gap ${(entry.stageShareGap * 100).toFixed(0)}%` : ""}` + `${entry.strongestSiblingLabel ? ` \xB7 runner-up ${escapeHtml(entry.strongestSiblingLabel)}` : ""}` + `${entry.reasons.length > 0 ? ` \xB7 ${escapeHtml(entry.reasons.join(", "))}` : ""}</li>`).join("")}</ul>` : ""}` + `${diagnostic.parentDistribution.length > 0 ? `<ul class="rag-source-labels">${diagnostic.parentDistribution.map((entry) => `<li><strong>${entry.isActive ? "Active section" : "Peer section"}</strong> ${escapeHtml(entry.label)} \xB7 ${(entry.parentShare * 100).toFixed(0)}% \xB7 ${entry.count} hit${entry.count === 1 ? "" : "s"}</li>`).join("")}</ul>` : ""}` + `</article>`).join("") + `</section>`;
+  return `<section class="rag-search-results"><h3>Section diagnostics</h3>` + diagnostics.map((diagnostic) => `<article class="rag-search-result" id="rag-section-diagnostic-${escapeHtml2(diagnostic.key)}">` + `<h4>${escapeHtml2(diagnostic.path?.join(" > ") ?? diagnostic.label)}</h4>` + `<p class="rag-search-source">${escapeHtml2(diagnostic.summary)}</p>` + `<ul class="rag-source-labels">` + `<li><strong>Top hit</strong> ${diagnostic.bestScore.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES)}</li>` + `<li><strong>Average</strong> ${diagnostic.averageScore.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES)}</li>` + `<li><strong>Sources</strong> ${diagnostic.sourceCount}</li>` + `<li><strong>Channels</strong> vector ${diagnostic.vectorHits} \xB7 lexical ${diagnostic.lexicalHits} \xB7 hybrid ${diagnostic.hybridHits}</li>` + `${diagnostic.topContextLabel ? `<li><strong>Lead context</strong> ${escapeHtml2(diagnostic.topContextLabel)}</li>` : ""}` + `${diagnostic.topLocatorLabel ? `<li><strong>Lead location</strong> ${escapeHtml2(diagnostic.topLocatorLabel)}</li>` : ""}` + `${diagnostic.sourceAwareChunkReasonLabel ? `<li><strong>Chunk boundary</strong> ${escapeHtml2(diagnostic.sourceAwareChunkReasonLabel)}</li>` : ""}` + `${diagnostic.sourceAwareUnitScopeLabel ? `<li><strong>Source-aware scope</strong> ${escapeHtml2(diagnostic.sourceAwareUnitScopeLabel)}</li>` : ""}` + `${diagnostic.stageCounts.length > 0 ? `<li><strong>Stage flow</strong> ${escapeHtml2(diagnostic.stageCounts.map((entry) => `${entry.stage} ${entry.count}`).join(" \u2192 "))}</li>` : ""}` + `${diagnostic.firstSeenStage ? `<li><strong>First seen</strong> ${escapeHtml2(diagnostic.firstSeenStage)}</li>` : ""}` + `${diagnostic.lastSeenStage ? `<li><strong>Last seen</strong> ${escapeHtml2(diagnostic.lastSeenStage)}</li>` : ""}` + `<li><strong>Query attribution</strong> ${escapeHtml2(`${diagnostic.queryAttribution.mode} \xB7 primary ${diagnostic.queryAttribution.primaryHits} \xB7 transformed ${diagnostic.queryAttribution.transformedHits} \xB7 variant ${diagnostic.queryAttribution.variantHits}`)}</li>` + `${diagnostic.queryAttribution.reasons.length > 0 ? `<li><strong>Query attribution reasons</strong> ${escapeHtml2(diagnostic.queryAttribution.reasons.join(", "))}</li>` : ""}` + `${diagnostic.peakStage ? `<li><strong>Peak stage</strong> ${escapeHtml2(diagnostic.peakStage)} (${diagnostic.peakCount})</li>` : ""}` + `${typeof diagnostic.finalRetentionRate === "number" ? `<li><strong>Final retention</strong> ${(diagnostic.finalRetentionRate * 100).toFixed(0)}%</li>` : ""}` + `${typeof diagnostic.dropFromPeak === "number" ? `<li><strong>Drop from peak</strong> ${diagnostic.dropFromPeak}</li>` : ""}` + `${diagnostic.retrievalMode ? `<li><strong>Trace mode</strong> ${escapeHtml2(diagnostic.retrievalMode)}</li>` : ""}` + `${diagnostic.rerankApplied !== undefined ? `<li><strong>Rerank</strong> ${diagnostic.rerankApplied ? "applied" : "skipped"}</li>` : ""}` + `${diagnostic.sourceBalanceApplied ? `<li><strong>Source balance</strong> applied</li>` : ""}` + `${diagnostic.scoreThresholdApplied ? `<li><strong>Score threshold</strong> applied</li>` : ""}` + `<li><strong>Reasons</strong> ${escapeHtml2(diagnostic.reasons.join(", ") || "none")}</li>` + `${diagnostic.strongestSiblingLabel ? `<li><strong>Strongest sibling</strong> ${escapeHtml2(diagnostic.strongestSiblingLabel)} (${diagnostic.strongestSiblingScore?.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES) ?? "n/a"})</li>` : ""}` + `${typeof diagnostic.parentShareGap === "number" ? `<li><strong>Parent share gap</strong> ${(diagnostic.parentShareGap * 100).toFixed(0)}%</li>` : ""}` + `</ul>` + `${diagnostic.stageWeights.length > 0 ? `<ul class="rag-source-labels">${diagnostic.stageWeights.map((entry) => `<li><strong>${escapeHtml2(entry.stage)}</strong> ${(entry.stageShare * 100).toFixed(0)}% of stage` + `${typeof entry.retentionRate === "number" ? ` \xB7 ${(entry.retentionRate * 100).toFixed(0)}% retained from ${escapeHtml2(entry.previousStage ?? "previous")}` : ""}` + `${typeof entry.countDelta === "number" ? ` \xB7 delta ${entry.countDelta >= 0 ? "+" : ""}${entry.countDelta}` : ""}` + `${typeof entry.stageScoreShare === "number" ? ` \xB7 ${(entry.stageScoreShare * 100).toFixed(0)}% of stage score` : ""}` + `${typeof entry.parentStageScoreShare === "number" ? ` \xB7 ${(entry.parentStageScoreShare * 100).toFixed(0)}% of parent stage score` : ""}` + `${typeof entry.stageScoreShareGap === "number" ? ` \xB7 score gap ${(entry.stageScoreShareGap * 100).toFixed(0)}%` : ""}` + `${typeof entry.parentStageShare === "number" ? ` \xB7 ${(entry.parentStageShare * 100).toFixed(0)}% of parent stage` : ""}` + `${typeof entry.stageShareGap === "number" ? ` \xB7 gap ${(entry.stageShareGap * 100).toFixed(0)}%` : ""}` + `${entry.strongestSiblingLabel ? ` \xB7 runner-up ${escapeHtml2(entry.strongestSiblingLabel)}` : ""}` + `${entry.reasons.length > 0 ? ` \xB7 ${escapeHtml2(entry.reasons.join(", "))}` : ""}</li>`).join("")}</ul>` : ""}` + `${diagnostic.parentDistribution.length > 0 ? `<ul class="rag-source-labels">${diagnostic.parentDistribution.map((entry) => `<li><strong>${entry.isActive ? "Active section" : "Peer section"}</strong> ${escapeHtml2(entry.label)} \xB7 ${(entry.parentShare * 100).toFixed(0)}% \xB7 ${entry.count} hit${entry.count === 1 ? "" : "s"}</li>`).join("")}</ul>` : ""}` + `</article>`).join("") + `</section>`;
 };
 var renderEmptyState = (kind) => {
   switch (kind) {
@@ -21264,7 +21419,7 @@ var renderCapabilityList = (capabilities) => {
     `serverSideFiltering=${capabilities.serverSideFiltering ? "true" : "false"}`,
     `streamingIngestStatus=${capabilities.streamingIngestStatus ? "true" : "false"}`
   ];
-  return `<ul class="rag-status-capabilities">${items.map((item) => `<li>${escapeHtml(item)}</li>`).join("")}</ul>`;
+  return `<ul class="rag-status-capabilities">${items.map((item) => `<li>${escapeHtml2(item)}</li>`).join("")}</ul>`;
 };
 var formatByteSize = (value) => {
   if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
@@ -21292,7 +21447,7 @@ var renderPostgresNativeStatus = (status) => {
     status.native.lastReindexError ? `Native index rebuild failed: ${status.native.lastReindexError}` : "",
     typeof status.native.indexBytes === "number" && typeof status.native.totalBytes === "number" && status.native.totalBytes > 0 && status.native.indexBytes / status.native.totalBytes >= 0.7 ? "Index-heavy storage footprint" : ""
   ].filter((entry) => entry.length > 0);
-  return `<dl class="rag-status">` + `<div><dt>Index type</dt><dd>${escapeHtml(status.native.indexType ?? "n/a")}</dd></div>` + `<div><dt>Index name</dt><dd>${escapeHtml(status.native.indexName ?? "n/a")}</dd></div>` + `<div><dt>Index present</dt><dd>${typeof status.native.indexPresent === "boolean" ? status.native.indexPresent ? "true" : "false" : "n/a"}</dd></div>` + `<div><dt>Estimated rows</dt><dd>${typeof status.native.estimatedRowCount === "number" ? String(status.native.estimatedRowCount) : "n/a"}</dd></div>` + `<div><dt>Table bytes</dt><dd>${formatByteSize(status.native.tableBytes)}</dd></div>` + `<div><dt>Index bytes</dt><dd>${formatByteSize(status.native.indexBytes)}</dd></div>` + `<div><dt>Total bytes</dt><dd>${formatByteSize(status.native.totalBytes)}</dd></div>` + `<div><dt>Health check</dt><dd>${typeof status.native.lastHealthCheckAt === "number" ? escapeHtml(new Date(status.native.lastHealthCheckAt).toLocaleString("en-US")) : "n/a"}</dd></div>` + `<div><dt>Last analyze</dt><dd>${typeof status.native.lastAnalyzeAt === "number" ? escapeHtml(new Date(status.native.lastAnalyzeAt).toLocaleString("en-US")) : "n/a"}</dd></div>` + `<div><dt>Last index rebuild</dt><dd>${typeof status.native.lastReindexAt === "number" ? escapeHtml(new Date(status.native.lastReindexAt).toLocaleString("en-US")) : "n/a"}</dd></div>` + `</dl>` + (warnings.length > 0 ? `<ul class="rag-status-capabilities">${warnings.map((warning) => `<li>${escapeHtml(warning)}</li>`).join("")}</ul>` : "");
+  return `<dl class="rag-status">` + `<div><dt>Index type</dt><dd>${escapeHtml2(status.native.indexType ?? "n/a")}</dd></div>` + `<div><dt>Index name</dt><dd>${escapeHtml2(status.native.indexName ?? "n/a")}</dd></div>` + `<div><dt>Index present</dt><dd>${typeof status.native.indexPresent === "boolean" ? status.native.indexPresent ? "true" : "false" : "n/a"}</dd></div>` + `<div><dt>Estimated rows</dt><dd>${typeof status.native.estimatedRowCount === "number" ? String(status.native.estimatedRowCount) : "n/a"}</dd></div>` + `<div><dt>Table bytes</dt><dd>${formatByteSize(status.native.tableBytes)}</dd></div>` + `<div><dt>Index bytes</dt><dd>${formatByteSize(status.native.indexBytes)}</dd></div>` + `<div><dt>Total bytes</dt><dd>${formatByteSize(status.native.totalBytes)}</dd></div>` + `<div><dt>Health check</dt><dd>${typeof status.native.lastHealthCheckAt === "number" ? escapeHtml2(new Date(status.native.lastHealthCheckAt).toLocaleString("en-US")) : "n/a"}</dd></div>` + `<div><dt>Last analyze</dt><dd>${typeof status.native.lastAnalyzeAt === "number" ? escapeHtml2(new Date(status.native.lastAnalyzeAt).toLocaleString("en-US")) : "n/a"}</dd></div>` + `<div><dt>Last index rebuild</dt><dd>${typeof status.native.lastReindexAt === "number" ? escapeHtml2(new Date(status.native.lastReindexAt).toLocaleString("en-US")) : "n/a"}</dd></div>` + `</dl>` + (warnings.length > 0 ? `<ul class="rag-status-capabilities">${warnings.map((warning) => `<li>${escapeHtml2(warning)}</li>`).join("")}</ul>` : "");
 };
 var renderSQLiteNativeStatus = (status) => {
   if (status?.backend !== "sqlite" || !status.native || !("mode" in status.native) || status.native.mode !== "vec0") {
@@ -21304,15 +21459,15 @@ var renderSQLiteNativeStatus = (status) => {
     status.native.lastAnalyzeError ? `Analyze failed: ${status.native.lastAnalyzeError}` : "",
     typeof status.native.pageCount === "number" && typeof status.native.freelistCount === "number" && status.native.pageCount > 0 && status.native.freelistCount / status.native.pageCount >= 0.2 ? "SQLite freelist growth suggests running optimize" : ""
   ].filter((entry) => entry.length > 0);
-  return `<dl class="rag-status">` + `<div><dt>Native table</dt><dd>${escapeHtml(status.native.tableName ?? "n/a")}</dd></div>` + `<div><dt>Distance metric</dt><dd>${escapeHtml(status.native.distanceMetric ?? "n/a")}</dd></div>` + `<div><dt>Native active</dt><dd>${status.native.active ? "true" : "false"}</dd></div>` + `<div><dt>Row count</dt><dd>${typeof status.native.rowCount === "number" ? String(status.native.rowCount) : "n/a"}</dd></div>` + `<div><dt>Database bytes</dt><dd>${formatByteSize(status.native.databaseBytes)}</dd></div>` + `<div><dt>Page count</dt><dd>${typeof status.native.pageCount === "number" ? String(status.native.pageCount) : "n/a"}</dd></div>` + `<div><dt>Freelist pages</dt><dd>${typeof status.native.freelistCount === "number" ? String(status.native.freelistCount) : "n/a"}</dd></div>` + `<div><dt>Health check</dt><dd>${typeof status.native.lastHealthCheckAt === "number" ? escapeHtml(new Date(status.native.lastHealthCheckAt).toLocaleString("en-US")) : "n/a"}</dd></div>` + `<div><dt>Last analyze</dt><dd>${typeof status.native.lastAnalyzeAt === "number" ? escapeHtml(new Date(status.native.lastAnalyzeAt).toLocaleString("en-US")) : "n/a"}</dd></div>` + `</dl>` + (warnings.length > 0 ? `<ul class="rag-status-capabilities">${warnings.map((warning) => `<li>${escapeHtml(warning)}</li>`).join("")}</ul>` : "");
+  return `<dl class="rag-status">` + `<div><dt>Native table</dt><dd>${escapeHtml2(status.native.tableName ?? "n/a")}</dd></div>` + `<div><dt>Distance metric</dt><dd>${escapeHtml2(status.native.distanceMetric ?? "n/a")}</dd></div>` + `<div><dt>Native active</dt><dd>${status.native.active ? "true" : "false"}</dd></div>` + `<div><dt>Row count</dt><dd>${typeof status.native.rowCount === "number" ? String(status.native.rowCount) : "n/a"}</dd></div>` + `<div><dt>Database bytes</dt><dd>${formatByteSize(status.native.databaseBytes)}</dd></div>` + `<div><dt>Page count</dt><dd>${typeof status.native.pageCount === "number" ? String(status.native.pageCount) : "n/a"}</dd></div>` + `<div><dt>Freelist pages</dt><dd>${typeof status.native.freelistCount === "number" ? String(status.native.freelistCount) : "n/a"}</dd></div>` + `<div><dt>Health check</dt><dd>${typeof status.native.lastHealthCheckAt === "number" ? escapeHtml2(new Date(status.native.lastHealthCheckAt).toLocaleString("en-US")) : "n/a"}</dd></div>` + `<div><dt>Last analyze</dt><dd>${typeof status.native.lastAnalyzeAt === "number" ? escapeHtml2(new Date(status.native.lastAnalyzeAt).toLocaleString("en-US")) : "n/a"}</dd></div>` + `</dl>` + (warnings.length > 0 ? `<ul class="rag-status-capabilities">${warnings.map((warning) => `<li>${escapeHtml2(warning)}</li>`).join("")}</ul>` : "");
 };
 var renderStatusActions = (input) => {
   if (!input.path) {
     return "";
   }
   const actions = [
-    input.admin?.canAnalyzeBackend ? `<button type="button" hx-post="${escapeHtml(`${input.path}/backend/analyze`)}" hx-target="#rag-status-feedback" hx-swap="innerHTML">Analyze backend</button>` : "",
-    input.status?.backend === "postgres" && input.admin?.canRebuildNativeIndex ? `<button type="button" hx-post="${escapeHtml(`${input.path}/backend/reindex-native`)}" hx-target="#rag-status-feedback" hx-swap="innerHTML">Rebuild native index</button>` : ""
+    input.admin?.canAnalyzeBackend ? `<button type="button" hx-post="${escapeHtml2(`${input.path}/backend/analyze`)}" hx-target="#rag-status-feedback" hx-swap="innerHTML">Analyze backend</button>` : "",
+    input.status?.backend === "postgres" && input.admin?.canRebuildNativeIndex ? `<button type="button" hx-post="${escapeHtml2(`${input.path}/backend/reindex-native`)}" hx-target="#rag-status-feedback" hx-swap="innerHTML">Rebuild native index</button>` : ""
   ].filter((entry) => entry.length > 0);
   if (actions.length === 0) {
     return "";
@@ -21339,7 +21494,7 @@ var renderBackendMaintenance = (input) => {
   if (recommendations.length === 0 && activeJobs.length === 0 && recentActions.length === 0) {
     return "";
   }
-  return `<section class="rag-status-maintenance">` + `<h3>Backend maintenance</h3>` + (recommendations.length > 0 ? `<ul class="rag-status-capabilities">${recommendations.map((entry) => `<li>${escapeHtml(entry)}</li>`).join("")}</ul>` : '<p class="rag-empty">No immediate maintenance recommendations.</p>') + (activeJobs.length > 0 ? `<ul class="rag-status-capabilities">${activeJobs.map((job) => `<li><strong>Running</strong> ${escapeHtml(job.action)}${job.target ? ` \xB7 ${escapeHtml(job.target)}` : ""}</li>`).join("")}</ul>` : "") + (recentActions.length > 0 ? `<ul class="rag-status-capabilities">${recentActions.map((action) => `<li><strong>${escapeHtml(action.action)}</strong> ${escapeHtml(action.status)}${typeof action.finishedAt === "number" ? ` \xB7 ${escapeHtml(new Date(action.finishedAt).toLocaleString("en-US"))}` : ""}${action.error ? ` \xB7 ${escapeHtml(action.error)}` : ""}</li>`).join("")}</ul>` : "") + `</section>`;
+  return `<section class="rag-status-maintenance">` + `<h3>Backend maintenance</h3>` + (recommendations.length > 0 ? `<ul class="rag-status-capabilities">${recommendations.map((entry) => `<li>${escapeHtml2(entry)}</li>`).join("")}</ul>` : '<p class="rag-empty">No immediate maintenance recommendations.</p>') + (activeJobs.length > 0 ? `<ul class="rag-status-capabilities">${activeJobs.map((job) => `<li><strong>Running</strong> ${escapeHtml2(job.action)}${job.target ? ` \xB7 ${escapeHtml2(job.target)}` : ""}</li>`).join("")}</ul>` : "") + (recentActions.length > 0 ? `<ul class="rag-status-capabilities">${recentActions.map((action) => `<li><strong>${escapeHtml2(action.action)}</strong> ${escapeHtml2(action.status)}${typeof action.finishedAt === "number" ? ` \xB7 ${escapeHtml2(new Date(action.finishedAt).toLocaleString("en-US"))}` : ""}${action.error ? ` \xB7 ${escapeHtml2(action.error)}` : ""}</li>`).join("")}</ul>` : "") + `</section>`;
 };
 var renderMaintenancePanel = (input) => {
   input.maintenance;
@@ -21350,7 +21505,7 @@ var renderMaintenancePanel = (input) => {
     status: input.status
   }) || (input.status && input.status.backend !== "in_memory" ? `<section class="rag-status-maintenance"><h3>Backend maintenance</h3><p class="rag-empty">No immediate maintenance recommendations.</p></section>` : renderEmptyState("status"));
   const route = input.path ? `${input.path}/status/maintenance` : undefined;
-  return route ? `<div id="rag-status-maintenance-panel" hx-get="${escapeHtml(route)}" hx-trigger="load, rag:mutated from:body" hx-swap="outerHTML">${content}</div>` : `<div id="rag-status-maintenance-panel">${content}</div>`;
+  return route ? `<div id="rag-status-maintenance-panel" hx-get="${escapeHtml2(route)}" hx-trigger="load, rag:mutated from:body" hx-swap="outerHTML">${content}</div>` : `<div id="rag-status-maintenance-panel">${content}</div>`;
 };
 var renderRetrievalGovernancePanel = (retrievalComparisons) => {
   if (!retrievalComparisons?.latest && !retrievalComparisons?.alerts?.length) {
@@ -21360,9 +21515,9 @@ var renderRetrievalGovernancePanel = (retrievalComparisons) => {
   const alerts = (retrievalComparisons.alerts ?? []).slice(0, 3);
   const releaseGroups = (retrievalComparisons.releaseGroups ?? []).slice(0, 2);
   const formatClassification = (classification) => classification === "multivector" ? "multivector regression" : classification === "evidence" ? "evidence regression" : classification === "cue" ? "cue regression" : classification === "runtime" ? "runtime regression" : classification === "general" ? "general regression" : undefined;
-  return `<section class="rag-status-governance"><h3>Retrieval governance</h3>` + (latest ? `<dl class="rag-status">` + `<div><dt>Latest comparison</dt><dd>${escapeHtml(latest.label)}</dd></div>` + (latest.bestByPassingRate ? `<div><dt>Best passing rate</dt><dd>${escapeHtml(latest.bestByPassingRate)}</dd></div>` : "") + (latest.bestByAverageF1 ? `<div><dt>Best average F1</dt><dd>${escapeHtml(latest.bestByAverageF1)}</dd></div>` : "") + (latest.bestByMultivectorCollapsedCases ? `<div><dt>Best multivector collapse</dt><dd>${escapeHtml(latest.bestByMultivectorCollapsedCases)}</dd></div>` : "") + (latest.bestByMultivectorLexicalHitCases ? `<div><dt>Best multivector lexical hits</dt><dd>${escapeHtml(latest.bestByMultivectorLexicalHitCases)}</dd></div>` : "") + (latest.bestByMultivectorVectorHitCases ? `<div><dt>Best multivector vector hits</dt><dd>${escapeHtml(latest.bestByMultivectorVectorHitCases)}</dd></div>` : "") + (latest.decisionSummary?.gate?.status ? `<div><dt>Gate</dt><dd>${escapeHtml(latest.decisionSummary.gate.status)}</dd></div>` : "") + (latest.releaseVerdict?.status ? `<div><dt>Verdict</dt><dd>${escapeHtml(latest.releaseVerdict.status)}</dd></div>` : "") + `</dl>` : "") + `<h4>Active alerts</h4>` + (alerts.length > 0 ? `<ul class="rag-status-capabilities">${alerts.map((alert) => `<li><strong>${escapeHtml(alert.kind)}</strong>${formatClassification(alert.classification) ? ` <span>${escapeHtml(formatClassification(alert.classification) ?? "")}</span>` : ""} ${escapeHtml(alert.message)}</li>`).join("")}</ul>` : `<p class="rag-empty">No active retrieval comparison alerts.</p>`) + (releaseGroups.length > 0 ? `<h4>Release groups</h4><ul class="rag-status-capabilities">${releaseGroups.map((group) => {
+  return `<section class="rag-status-governance"><h3>Retrieval governance</h3>` + (latest ? `<dl class="rag-status">` + `<div><dt>Latest comparison</dt><dd>${escapeHtml2(latest.label)}</dd></div>` + (latest.bestByPassingRate ? `<div><dt>Best passing rate</dt><dd>${escapeHtml2(latest.bestByPassingRate)}</dd></div>` : "") + (latest.bestByAverageF1 ? `<div><dt>Best average F1</dt><dd>${escapeHtml2(latest.bestByAverageF1)}</dd></div>` : "") + (latest.bestByMultivectorCollapsedCases ? `<div><dt>Best multivector collapse</dt><dd>${escapeHtml2(latest.bestByMultivectorCollapsedCases)}</dd></div>` : "") + (latest.bestByMultivectorLexicalHitCases ? `<div><dt>Best multivector lexical hits</dt><dd>${escapeHtml2(latest.bestByMultivectorLexicalHitCases)}</dd></div>` : "") + (latest.bestByMultivectorVectorHitCases ? `<div><dt>Best multivector vector hits</dt><dd>${escapeHtml2(latest.bestByMultivectorVectorHitCases)}</dd></div>` : "") + (latest.decisionSummary?.gate?.status ? `<div><dt>Gate</dt><dd>${escapeHtml2(latest.decisionSummary.gate.status)}</dd></div>` : "") + (latest.releaseVerdict?.status ? `<div><dt>Verdict</dt><dd>${escapeHtml2(latest.releaseVerdict.status)}</dd></div>` : "") + `</dl>` : "") + `<h4>Active alerts</h4>` + (alerts.length > 0 ? `<ul class="rag-status-capabilities">${alerts.map((alert) => `<li><strong>${escapeHtml2(alert.kind)}</strong>${formatClassification(alert.classification) ? ` <span>${escapeHtml2(formatClassification(alert.classification) ?? "")}</span>` : ""} ${escapeHtml2(alert.message)}</li>`).join("")}</ul>` : `<p class="rag-empty">No active retrieval comparison alerts.</p>`) + (releaseGroups.length > 0 ? `<h4>Release groups</h4><ul class="rag-status-capabilities">${releaseGroups.map((group) => {
     const reasons = group.recommendedActionReasons?.slice(0, 2).join("; ") ?? "No recommended action.";
-    return `<li><strong>${escapeHtml(group.groupKey)}</strong>${formatClassification(group.classification) ? ` <span>${escapeHtml(formatClassification(group.classification) ?? "")}</span>` : ""} ${escapeHtml(group.recommendedAction ?? "monitor")} \xB7 ${escapeHtml(reasons)}</li>`;
+    return `<li><strong>${escapeHtml2(group.groupKey)}</strong>${formatClassification(group.classification) ? ` <span>${escapeHtml2(formatClassification(group.classification) ?? "")}</span>` : ""} ${escapeHtml2(group.recommendedAction ?? "monitor")} \xB7 ${escapeHtml2(reasons)}</li>`;
   }).join("")}</ul>` : "") + `</section>`;
 };
 var defaultStatus = ({
@@ -21379,7 +21534,7 @@ var defaultStatus = ({
   if (!status) {
     return renderEmptyState("status");
   }
-  return `<section class="rag-status-panel">` + `<dl class="rag-status">` + `<div><dt>Backend</dt><dd>${escapeHtml(status.backend)}</dd></div>` + `<div><dt>Vector mode</dt><dd>${escapeHtml(status.vectorMode)}</dd></div>` + `<div><dt>Embedding dimensions</dt><dd>${status.dimensions ?? "n/a"}</dd></div>` + `<div><dt>Vector acceleration</dt><dd>${status.native?.active ? "active" : "inactive"}</dd></div>` + `<div><dt>Documents</dt><dd>${documents?.total ?? "n/a"}</dd></div>` + `<div><dt>Total chunks</dt><dd>${documents?.chunkCount ?? "n/a"}</dd></div>` + `<div><dt>Seed docs</dt><dd>${documents?.byKind.seed ?? 0}</dd></div>` + `<div><dt>Custom docs</dt><dd>${documents?.byKind.custom ?? 0}</dd></div>` + `</dl>${renderPostgresNativeStatus(status)}${renderSQLiteNativeStatus(status)}${renderRetrievalGovernancePanel(retrievalComparisons)}${renderMaintenancePanel({
+  return `<section class="rag-status-panel">` + `<dl class="rag-status">` + `<div><dt>Backend</dt><dd>${escapeHtml2(status.backend)}</dd></div>` + `<div><dt>Vector mode</dt><dd>${escapeHtml2(status.vectorMode)}</dd></div>` + `<div><dt>Embedding dimensions</dt><dd>${status.dimensions ?? "n/a"}</dd></div>` + `<div><dt>Vector acceleration</dt><dd>${status.native?.active ? "active" : "inactive"}</dd></div>` + `<div><dt>Documents</dt><dd>${documents?.total ?? "n/a"}</dd></div>` + `<div><dt>Total chunks</dt><dd>${documents?.chunkCount ?? "n/a"}</dd></div>` + `<div><dt>Seed docs</dt><dd>${documents?.byKind.seed ?? 0}</dd></div>` + `<div><dt>Custom docs</dt><dd>${documents?.byKind.custom ?? 0}</dd></div>` + `</dl>${renderPostgresNativeStatus(status)}${renderSQLiteNativeStatus(status)}${renderRetrievalGovernancePanel(retrievalComparisons)}${renderMaintenancePanel({
     admin,
     adminActions,
     adminJobs,
@@ -21392,7 +21547,7 @@ var defaultStatus = ({
     status
   })}</section>`;
 };
-var defaultSearchResultItem = (source, index, sectionJumps = "") => `<article class="rag-search-result" id="rag-search-result-${escapeHtml(source.chunkId)}">` + `<h3>${escapeHtml(source.title ?? source.chunkId ?? `Result ${index + 1}`)}</h3>` + `<p class="rag-search-source">${escapeHtml(source.source ?? "unknown source")}</p>` + renderSourceLabels(source.labels) + renderChunkStructure(source.structure) + sectionJumps + `<p class="rag-search-score">score ${source.score.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES)}</p>` + `<p class="rag-search-text">${escapeHtml(source.text)}</p>` + "</article>";
+var defaultSearchResultItem = (source, index, sectionJumps = "") => `<article class="rag-search-result" id="rag-search-result-${escapeHtml2(source.chunkId)}">` + `<h3>${escapeHtml2(source.title ?? source.chunkId ?? `Result ${index + 1}`)}</h3>` + `<p class="rag-search-source">${escapeHtml2(source.source ?? "unknown source")}</p>` + renderSourceLabels(source.labels) + renderChunkStructure(source.structure) + sectionJumps + `<p class="rag-search-score">score ${source.score.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES)}</p>` + `<p class="rag-search-text">${escapeHtml2(source.text)}</p>` + "</article>";
 var defaultSearchResults = ({
   query,
   results,
@@ -21401,7 +21556,7 @@ var defaultSearchResults = ({
   const graph = buildRAGChunkGraph(results);
   const sectionDiagnostics = buildRAGSectionRetrievalDiagnostics(results, trace);
   const availableChunkIds = new Set(results.map((result) => result.chunkId));
-  return `<section class="rag-search-results">` + `<p class="rag-search-summary">${results.length} results for ${escapeHtml(query)}</p>` + `<p class="rag-search-summary">sections=${sectionDiagnostics.length}</p>` + (trace ? `<p class="rag-search-summary">mode=${escapeHtml(trace.mode)} \xB7 final=${trace.resultCounts.final} \xB7 vector=${trace.resultCounts.vector} \xB7 lexical=${trace.resultCounts.lexical}</p>` : "") + renderSectionDiagnostics(sectionDiagnostics) + `${results.map((result, index) => {
+  return `<section class="rag-search-results">` + `<p class="rag-search-summary">${results.length} results for ${escapeHtml2(query)}</p>` + `<p class="rag-search-summary">sections=${sectionDiagnostics.length}</p>` + (trace ? `<p class="rag-search-summary">mode=${escapeHtml2(trace.mode)} \xB7 final=${trace.resultCounts.final} \xB7 vector=${trace.resultCounts.vector} \xB7 lexical=${trace.resultCounts.lexical}</p>` : "") + renderSectionDiagnostics(sectionDiagnostics) + `${results.map((result, index) => {
     const navigation = buildRAGChunkGraphNavigation(graph, result.chunkId);
     const sectionJumps = [
       navigation.parentSection?.leadChunkId ? renderSectionJumpList("Parent section", [
@@ -21455,7 +21610,7 @@ var defaultSpreadsheetCueBenchmarkSnapshot = (input) => renderBenchmarkSnapshotP
   response: input,
   title: "Spreadsheet cue snapshots"
 });
-var defaultDocumentItem = (document, index) => '<article class="rag-document">' + `<h3>${escapeHtml(document.title || `Document ${index + 1}`)}</h3>` + `<p class="rag-document-id">${escapeHtml(document.id)}</p>` + `<p class="rag-document-source">${escapeHtml(document.source)}</p>` + renderSourceLabels(document.labels) + `<p class="rag-document-meta">${escapeHtml(document.format ?? "text")} \xB7 ${escapeHtml(document.chunkStrategy ?? "paragraphs")} \xB7 ${document.chunkCount ?? 0} chunks</p>` + "</article>";
+var defaultDocumentItem = (document, index) => '<article class="rag-document">' + `<h3>${escapeHtml2(document.title || `Document ${index + 1}`)}</h3>` + `<p class="rag-document-id">${escapeHtml2(document.id)}</p>` + `<p class="rag-document-source">${escapeHtml2(document.source)}</p>` + renderSourceLabels(document.labels) + `<p class="rag-document-meta">${escapeHtml2(document.format ?? "text")} \xB7 ${escapeHtml2(document.chunkStrategy ?? "paragraphs")} \xB7 ${document.chunkCount ?? 0} chunks</p>` + "</article>";
 var defaultDocuments = ({
   documents
 }) => documents.length === 0 ? renderEmptyState("documents") : `<section class="rag-documents">${documents.map((document, index) => defaultDocumentItem(document, index)).join("")}</section>`;
@@ -21481,10 +21636,10 @@ var defaultChunkPreview = (input) => {
     return acc;
   }, []);
   const groupHtml = groups.map((group) => {
-    const chunkHtml = group.chunks.map((chunk) => '<article class="rag-chunk">' + `<h5>${escapeHtml(chunk.chunkId)}</h5>` + `<p class="rag-chunk-meta">chunk ${typeof chunk.metadata?.chunkIndex === "number" ? chunk.metadata.chunkIndex : 0} of ${typeof chunk.metadata?.chunkCount === "number" ? chunk.metadata.chunkCount : input.chunks.length}</p>` + renderSourceLabels(chunk.labels) + renderChunkStructure(chunk.structure) + renderChunkExcerpts(chunk.excerpts) + renderExcerptSelection(chunk.excerptSelection) + `<pre>${escapeHtml(chunk.text)}</pre>` + "</article>").join("");
-    return `<section class="rag-chunk-group"><h4>${escapeHtml(group.title)}</h4>${chunkHtml}</section>`;
+    const chunkHtml = group.chunks.map((chunk) => '<article class="rag-chunk">' + `<h5>${escapeHtml2(chunk.chunkId)}</h5>` + `<p class="rag-chunk-meta">chunk ${typeof chunk.metadata?.chunkIndex === "number" ? chunk.metadata.chunkIndex : 0} of ${typeof chunk.metadata?.chunkCount === "number" ? chunk.metadata.chunkCount : input.chunks.length}</p>` + renderSourceLabels(chunk.labels) + renderChunkStructure(chunk.structure) + renderChunkExcerpts(chunk.excerpts) + renderExcerptSelection(chunk.excerptSelection) + `<pre>${escapeHtml2(chunk.text)}</pre>` + "</article>").join("");
+    return `<section class="rag-chunk-group"><h4>${escapeHtml2(group.title)}</h4>${chunkHtml}</section>`;
   }).join("");
-  return `<section class="rag-chunk-preview">` + `<h3>${escapeHtml(input.document.title)}</h3>` + `<p class="rag-chunk-preview-source">${escapeHtml(input.document.source)}</p>` + renderSourceLabels(input.document.labels) + (navigation.parentSection ? renderSectionJumpList("Parent section", [
+  return `<section class="rag-chunk-preview">` + `<h3>${escapeHtml2(input.document.title)}</h3>` + `<p class="rag-chunk-preview-source">${escapeHtml2(input.document.source)}</p>` + renderSourceLabels(input.document.labels) + (navigation.parentSection ? renderSectionJumpList("Parent section", [
     {
       label: navigation.parentSection.title ?? navigation.parentSection.path?.join(" > ") ?? navigation.parentSection.id
     }
@@ -21492,11 +21647,11 @@ var defaultChunkPreview = (input) => {
     label: section.title ?? section.path?.join(" > ") ?? section.id
   }))) : "") + (navigation.childSections.length > 0 ? renderSectionJumpList("Child section", navigation.childSections.map((section) => ({
     label: section.title ?? section.path?.join(" > ") ?? section.id
-  }))) : "") + `<article class="rag-chunk-normalized">` + `<h4>Normalized text</h4>` + `<pre>${escapeHtml(input.normalizedText)}</pre>` + `</article>${groupHtml}</section>`;
+  }))) : "") + `<article class="rag-chunk-normalized">` + `<h4>Normalized text</h4>` + `<pre>${escapeHtml2(input.normalizedText)}</pre>` + `</article>${groupHtml}</section>`;
 };
 var defaultMutationResult = (input) => {
   if (!input.ok) {
-    return `<div class="rag-mutation error">${escapeHtml(input.error ?? "Request failed")}</div>`;
+    return `<div class="rag-mutation error">${escapeHtml2(input.error ?? "Request failed")}</div>`;
   }
   const details = [];
   if (input.status) {
@@ -21511,7 +21666,7 @@ var defaultMutationResult = (input) => {
   if (typeof input.documents === "number") {
     details.push(`documents=${input.documents}`);
   }
-  return `<div class="rag-mutation ok">${escapeHtml(details.join(" \xB7 ") || "ok")}</div>`;
+  return `<div class="rag-mutation ok">${escapeHtml2(details.join(" \xB7 ") || "ok")}</div>`;
 };
 var defaultEvaluateResult = ({
   cases,
@@ -21520,11 +21675,11 @@ var defaultEvaluateResult = ({
   if (cases.length === 0) {
     return renderEmptyState("evaluation");
   }
-  const caseRows = cases.map((entry) => `<tr class="rag-eval-row rag-eval-${entry.status}">` + `<td>${escapeHtml(entry.caseId)}</td>` + `<td>${escapeHtml(entry.mode)}</td>` + `<td>${escapeHtml(entry.status)}</td>` + `<td>${entry.elapsedMs}</td>` + `<td>${entry.retrievedCount}</td>` + `<td>${entry.expectedCount}</td>` + `<td>${entry.matchedCount}</td>` + `<td>${entry.precision.toFixed(4)}</td>` + `<td>${entry.recall.toFixed(4)}</td>` + `<td>${entry.f1.toFixed(4)}</td>` + `<td>${escapeHtml(entry.label ?? "n/a")}</td>` + `<td>${escapeHtml(entry.missingIds.join(", ") || "none")}</td>` + `</tr>`).join("");
+  const caseRows = cases.map((entry) => `<tr class="rag-eval-row rag-eval-${entry.status}">` + `<td>${escapeHtml2(entry.caseId)}</td>` + `<td>${escapeHtml2(entry.mode)}</td>` + `<td>${escapeHtml2(entry.status)}</td>` + `<td>${entry.elapsedMs}</td>` + `<td>${entry.retrievedCount}</td>` + `<td>${entry.expectedCount}</td>` + `<td>${entry.matchedCount}</td>` + `<td>${entry.precision.toFixed(4)}</td>` + `<td>${entry.recall.toFixed(4)}</td>` + `<td>${entry.f1.toFixed(4)}</td>` + `<td>${escapeHtml2(entry.label ?? "n/a")}</td>` + `<td>${escapeHtml2(entry.missingIds.join(", ") || "none")}</td>` + `</tr>`).join("");
   const passingRate = summary.totalCases > 0 ? (summary.passedCases / summary.totalCases * 100).toFixed(1) : "0.0";
   return `<section class="rag-evaluation">` + `<h3>Evaluation</h3>` + `<p>${summary.totalCases} cases \xB7 ${summary.passedCases} pass \xB7 ${summary.partialCases} partial \xB7 ${summary.failedCases} fail \xB7 passing ${passingRate}%</p>` + `<table class="rag-eval-table"><thead><tr><th>Case</th><th>Mode</th><th>Status</th><th>ms</th><th>Retrieved</th><th>Expected</th><th>Matched</th><th>Precision</th><th>Recall</th><th>F1</th><th>Label</th><th>Missing</th></tr></thead><tbody>${caseRows}</tbody></table>` + `<dl class="rag-eval-summary"><div><dt>Average precision</dt><dd>${summary.averagePrecision.toFixed(4)}</dd></div><div><dt>Average recall</dt><dd>${summary.averageRecall.toFixed(4)}</dd></div><div><dt>Average F1</dt><dd>${summary.averageF1.toFixed(4)}</dd></div><div><dt>Average latency</dt><dd>${summary.averageLatencyMs.toFixed(1)}ms</dd></div></dl>` + `</section>`;
 };
-var defaultError = (message) => `<div class="rag-error">${escapeHtml(message)}</div>`;
+var defaultError = (message) => `<div class="rag-error">${escapeHtml2(message)}</div>`;
 var defaultMaintenance = (input) => renderMaintenancePanel(input);
 var resolveRAGWorkflowRenderers = (custom) => ({
   adaptiveNativePlannerBenchmark: custom?.adaptiveNativePlannerBenchmark ?? defaultAdaptiveNativePlannerBenchmark,
@@ -21548,7 +21703,7 @@ var resolveRAGWorkflowRenderers = (custom) => ({
   status: custom?.status ?? defaultStatus
 });
 
-// src/types.ts
+// src/retrieval/context.ts
 var getContextNumber3 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var getContextString3 = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
 var formatMediaTimestamp3 = (value) => {
@@ -37649,5 +37804,5 @@ export {
   addRAGEvaluationSuiteCase
 };
 
-//# debugId=54C2E8505F23B34964756E2164756E21
+//# debugId=81C188D9E871FD2564756E2164756E21
 //# sourceMappingURL=index.js.map