@absolutejs/rag 0.0.15 → 0.0.17

package/dist/index.js

@@ -11221,6 +11221,437 @@ var summarizeRAGRetrievalComparison = (entries) => ({
   bestByLowestRuntimeCandidateBudgetExhaustedCases: selectComparisonEntryByLowestTraceMetric(entries, "retrievalId", "runtimeCandidateBudgetExhaustedCases"),
   bestByLowestRuntimeUnderfilledTopKCases: selectComparisonEntryByLowestTraceMetric(entries, "retrievalId", "runtimeUnderfilledTopKCases")
 });
+// src/presentation/htmxCitationFragments.ts
+var formatScore = (value) => Number.isFinite(value) ? value.toFixed(3) : "0.000";
+var buildSearchTargetId = (prefix, value) => {
+  const normalized = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return `${prefix}-${normalized || "item"}`;
+};
+var buildSourceSummarySectionGroups = (summaries) => {
+  const groups = new Map;
+  for (const summary of summaries ?? []) {
+    const label = summary.contextLabel ?? summary.label;
+    const id = buildSearchTargetId("source-summary-section", label);
+    const existing = groups.get(id);
+    if (existing) {
+      existing.summaries.push(summary);
+      existing.summary = `${existing.summaries.length} evidence summar${existing.summaries.length === 1 ? "y" : "ies"}`;
+      continue;
+    }
+    groups.set(id, {
+      id,
+      label,
+      targetId: id,
+      summary: "1 evidence summary",
+      summaries: [summary]
+    });
+  }
+  return [...groups.values()].sort((left, right) => {
+    const leftScore = Math.max(...left.summaries.map((summary) => summary.bestScore));
+    const rightScore = Math.max(...right.summaries.map((summary) => summary.bestScore));
+    return rightScore - leftScore;
+  });
+};
+var buildGroundingReferenceGroups = (references) => {
+  const groups = new Map;
+  for (const reference of references ?? []) {
+    const label = reference.contextLabel ?? reference.label ?? reference.source ?? reference.chunkId;
+    const id = buildSearchTargetId("grounding-reference-section", label);
+    const existing = groups.get(id);
+    if (existing) {
+      existing.references.push(reference);
+      existing.summary = `${existing.references.length} grounding reference${existing.references.length === 1 ? "" : "s"}`;
+      continue;
+    }
+    groups.set(id, {
+      id,
+      label,
+      targetId: id,
+      summary: "1 grounding reference",
+      references: [reference]
+    });
+  }
+  return [...groups.values()].sort((left, right) => {
+    const leftScore = Math.max(...left.references.map((reference) => reference.score));
+    const rightScore = Math.max(...right.references.map((reference) => reference.score));
+    return rightScore - leftScore;
+  });
+};
+var buildCitationGroups = (citations) => {
+  const groups = new Map;
+  for (const citation of citations ?? []) {
+    const label = citation.contextLabel ?? citation.label ?? citation.source ?? citation.chunkId;
+    const id = buildSearchTargetId("citation-section", label);
+    const existing = groups.get(id);
+    if (existing) {
+      existing.citations.push(citation);
+      existing.summary = `${existing.citations.length} citation${existing.citations.length === 1 ? "" : "s"}`;
+      continue;
+    }
+    groups.set(id, {
+      id,
+      label,
+      targetId: id,
+      summary: "1 citation",
+      citations: [citation]
+    });
+  }
+  return [...groups.values()].sort((left, right) => {
+    const leftScore = Math.max(...left.citations.map((citation) => citation.score));
+    const rightScore = Math.max(...right.citations.map((citation) => citation.score));
+    return rightScore - leftScore;
+  });
+};
+var formatCitationLabel = (citation) => [citation.label, citation.contextLabel, citation.locatorLabel].filter(Boolean).join(" \xB7 ");
+var formatCitationSummary = (citation) => citation.source ?? citation.title ?? citation.chunkId;
+var formatCitationExcerpt = (citation) => citation.excerpt || citation.text;
+var formatEvidenceDetailLine = (label, value) => value && value.length > 0 ? `${label}: ${value}` : "";
+var formatEvidenceContextLine = (contextLabel, locatorLabel) => {
+  const value = [locatorLabel, contextLabel].filter((entry) => Boolean(entry && entry.length > 0)).join(" \xB7 ");
+  return value.length > 0 ? `location: ${value}` : "";
+};
+var formatSourceSummaryDetails = (summary) => [
+  `best score: ${formatScore(summary.bestScore)}`,
+  `coverage: ${summary.count} chunk(s) \xB7 citations ${summary.citationNumbers.map((value) => `[${value}]`).join(" ") || "none"}`,
+  formatEvidenceContextLine(summary.contextLabel, summary.locatorLabel),
+  formatEvidenceDetailLine("provenance", summary.provenanceLabel)
+].filter((value) => value.length > 0);
+var formatCitationDetails = (citation) => [
+  formatEvidenceDetailLine("evidence", citation.source ?? citation.title ?? citation.chunkId),
+  formatEvidenceContextLine(citation.contextLabel, citation.locatorLabel),
+  formatEvidenceDetailLine("provenance", citation.provenanceLabel),
+  `score: ${formatScore(citation.score)}`
+].filter((value) => value.length > 0);
+var formatSectionDiagnosticPercent = (value) => typeof value === "number" ? `${Math.round(value * 100)}%` : null;
+var formatSectionDiagnosticReason = (reason) => reason.replaceAll("_", " ");
+var formatSectionDiagnosticStage = (stage) => stage.replaceAll("_", " ");
+var formatSectionDiagnosticWeightReason = (reason) => ({
+  final_stage_concentration: "final stage concentrated on this section",
+  final_stage_dominant_within_parent: "final stage stayed ahead inside its parent",
+  rerank_preserved_lead: "rerank kept this section in front",
+  stage_runner_up_pressure: "runner-up stayed close in this stage",
+  stage_expanded: "this section expanded in this stage",
+  stage_held: "this section held steady in this stage",
+  stage_narrowed: "this section narrowed in this stage"
+})[reason] ?? reason.replaceAll("_", " ");
+var formatSectionQueryAttributionReason = (reason) => ({
+  base_query_only: "came only from the base query",
+  transformed_query_only: "came only from the transformed query",
+  variant_only: "came only from query variants",
+  transform_introduced: "the transformed query introduced this section",
+  variant_supported: "query variants reinforced this section",
+  mixed_query_sources: "multiple query forms contributed"
+})[reason] ?? reason.replaceAll("_", " ");
+var formatSectionDiagnosticChannels = (diagnostic) => `Channels \xB7 hybrid ${diagnostic.hybridHits} \xB7 vector ${diagnostic.vectorHits} \xB7 lexical ${diagnostic.lexicalHits}`;
+var formatSectionDiagnosticAttributionFocus = (diagnostic) => {
+  const mode = diagnostic.queryAttribution?.mode ?? "mixed";
+  const label = mode === "primary" ? "Attribution \xB7 base-query-only" : mode === "transformed" ? "Attribution \xB7 transformed-only" : mode === "variant" ? "Attribution \xB7 variant-only" : "Attribution \xB7 mixed";
+  const parts = [label];
+  if ((diagnostic.queryAttribution?.primaryHits ?? 0) > 0)
+    parts.push(`base ${diagnostic.queryAttribution?.primaryHits}`);
+  if ((diagnostic.queryAttribution?.transformedHits ?? 0) > 0)
+    parts.push(`transformed ${diagnostic.queryAttribution?.transformedHits}`);
+  if ((diagnostic.queryAttribution?.variantHits ?? 0) > 0)
+    parts.push(`variant ${diagnostic.queryAttribution?.variantHits}`);
+  return parts.join(" \xB7 ");
+};
+var formatSectionDiagnosticPipeline = (diagnostic) => {
+  const requestedMode = diagnostic.requestedMode ?? diagnostic.retrievalMode ?? "n/a";
+  const selectedMode = diagnostic.retrievalMode ?? "n/a";
+  const routeLabel = diagnostic.routingLabel ?? "default route";
+  const transformLabel = diagnostic.queryTransformLabel ?? "no transform";
+  return `Mode ${selectedMode} \xB7 requested ${requestedMode} \xB7 route ${routeLabel} \xB7 transform ${transformLabel} \xB7 rerank ${diagnostic.rerankApplied ? "on" : "off"} \xB7 source balance ${diagnostic.sourceBalanceApplied ? "on" : "off"} \xB7 threshold ${diagnostic.scoreThresholdApplied ? "on" : "off"} \xB7 query ${diagnostic.queryAttribution?.mode ?? "n/a"}`;
+};
+var formatSectionDiagnosticStageFlow = (diagnostic) => diagnostic.stageCounts.length > 0 ? `Stage flow \xB7 ${diagnostic.stageCounts.map((entry) => `${formatSectionDiagnosticStage(entry.stage)} ${entry.count}`).join(" \u2192 ")}` : null;
+var formatSectionDiagnosticStageBounds = (diagnostic) => {
+  const parts = [];
+  if (diagnostic.firstSeenStage)
+    parts.push(`first seen ${formatSectionDiagnosticStage(diagnostic.firstSeenStage)}`);
+  if (diagnostic.lastSeenStage)
+    parts.push(`last seen ${formatSectionDiagnosticStage(diagnostic.lastSeenStage)}`);
+  if (diagnostic.peakStage)
+    parts.push(`peak ${formatSectionDiagnosticStage(diagnostic.peakStage)} ${diagnostic.peakCount}`);
+  const finalRetention = formatSectionDiagnosticPercent(diagnostic.finalRetentionRate);
+  if (finalRetention)
+    parts.push(`final retention ${finalRetention}`);
+  if (typeof diagnostic.dropFromPeak === "number")
+    parts.push(`drop from peak ${diagnostic.dropFromPeak}`);
+  return parts.length > 0 ? parts.join(" \xB7 ") : null;
+};
+var formatSectionDiagnosticStageWeightRows = (diagnostic) => (diagnostic.stageWeights ?? []).filter((entry) => entry.reasons.length > 0 || entry.stage === "rerank" || entry.stage === "finalize").map((entry) => {
+  const parts = [
+    `${formatSectionDiagnosticStage(entry.stage)} ${(entry.stageShare * 100).toFixed(0)}% of stage`,
+    typeof entry.stageScoreShare === "number" ? `${(entry.stageScoreShare * 100).toFixed(0)}% of stage score` : null,
+    typeof entry.retentionRate === "number" && entry.previousStage && entry.retentionRate !== 1 ? `${(entry.retentionRate * 100).toFixed(0)}% retained from ${formatSectionDiagnosticStage(entry.previousStage)}` : null,
+    typeof entry.countDelta === "number" && entry.countDelta !== 0 ? `delta ${entry.countDelta >= 0 ? "+" : ""}${entry.countDelta}` : null,
+    typeof entry.parentStageShare === "number" && entry.strongestSiblingLabel ? `${(entry.parentStageShare * 100).toFixed(0)}% of parent stage` : null,
+    typeof entry.parentStageScoreShare === "number" && entry.strongestSiblingLabel ? `${(entry.parentStageScoreShare * 100).toFixed(0)}% of parent stage score` : null,
+    typeof entry.stageShareGap === "number" ? `gap ${(entry.stageShareGap * 100).toFixed(0)}%` : null,
+    typeof entry.stageScoreShareGap === "number" ? `score gap ${(entry.stageScoreShareGap * 100).toFixed(0)}%` : null,
+    entry.strongestSiblingLabel ? `runner-up ${entry.strongestSiblingLabel}` : null
+  ].filter((value) => Boolean(value));
+  return parts.join(" \xB7 ");
+});
+var formatSectionDiagnosticStageWeightReasons = (diagnostic) => (diagnostic.stageWeights ?? []).flatMap((entry) => entry.reasons.map((reason) => `${formatSectionDiagnosticStage(entry.stage)} \xB7 ${formatSectionDiagnosticWeightReason(reason)}`));
+var formatSectionDiagnosticQueryAttributionReasons = (diagnostic) => (diagnostic.queryAttribution?.reasons ?? []).map((reason) => formatSectionQueryAttributionReason(reason));
+var formatSectionDiagnosticCompetition = (diagnostic) => {
+  const parts = [];
+  const parentShare = formatSectionDiagnosticPercent(diagnostic.parentShare);
+  const parentShareGap = formatSectionDiagnosticPercent(diagnostic.parentShareGap);
+  if (!diagnostic.strongestSiblingLabel)
+    return "";
+  if (parentShare)
+    parts.push(`parent share ${parentShare}`);
+  if (parentShareGap)
+    parts.push(`gap ${parentShareGap}`);
+  parts.push(`runner-up ${diagnostic.strongestSiblingLabel}`);
+  return parts.join(" \xB7 ");
+};
+var formatSectionDiagnosticTopEntry = (diagnostic) => {
+  const parts = [];
+  if (diagnostic.topSource)
+    parts.push(`top source ${diagnostic.topSource}`);
+  if (diagnostic.topChunkId)
+    parts.push(`lead chunk ${diagnostic.topChunkId}`);
+  parts.push(`${diagnostic.sourceCount} source${diagnostic.sourceCount === 1 ? "" : "s"}`);
+  parts.push(`primary ${diagnostic.queryAttribution?.primaryHits ?? 0} \xB7 transformed ${diagnostic.queryAttribution?.transformedHits ?? 0} \xB7 variant ${diagnostic.queryAttribution?.variantHits ?? 0}`);
+  return parts.join(" \xB7 ");
+};
+var formatSectionDiagnosticReasons = (diagnostic) => [
+  ...diagnostic.reasons.map((reason) => formatSectionDiagnosticReason(reason)),
+  ...formatSectionDiagnosticQueryAttributionReasons(diagnostic),
+  ...diagnostic.routingReason ? [`routing \xB7 ${diagnostic.routingReason}`] : [],
+  ...diagnostic.queryTransformReason ? [`transform \xB7 ${diagnostic.queryTransformReason}`] : []
+];
+var formatSectionDiagnosticDistributionRows = (diagnostic) => diagnostic.parentDistribution.map((entry) => `${entry.isActive ? "Active" : "Peer"} \xB7 ${entry.label} \xB7 ${entry.count} hit${entry.count === 1 ? "" : "s"} \xB7 ${formatSectionDiagnosticPercent(entry.parentShare) ?? "0%"}`);
+
+// 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 makeCitations = (prefix) => (sources) => {
+  const citations = buildRAGCitations(sources);
+  if (citations.length === 0) {
+    return "";
+  }
+  return [
+    `<div class="${prefix}-results">`,
+    "<h4>Citation Trail</h4>",
+    `<p class="${prefix}-metadata">Each citation maps a concrete retrieved chunk to a stable reference number you can carry into the answer UI.</p>`,
+    `<div class="${prefix}-result-grid">`,
+    buildCitationGroups(citations).map((group) => `
+          <article class="${prefix}-result-item" id="${escapeHtml(group.targetId)}">
+            <h3>${escapeHtml(group.label)}</h3>
+            <p class="${prefix}-result-source">${escapeHtml(group.summary)}</p>
+            <div class="${prefix}-result-grid">
+              ${group.citations.map((citation, index) => `
+                    <article class="${prefix}-result-item ${prefix}-citation-card">
+                      <p class="${prefix}-citation-badge">[${index + 1}] ${escapeHtml(formatCitationLabel(citation))}</p>
+                      <p class="${prefix}-result-score">${escapeHtml(formatCitationSummary(citation))}</p>
+                      ${formatCitationDetails(citation).map((line) => `<p class="${prefix}-metadata">${escapeHtml(line)}</p>`).join("")}
+                      <p class="${prefix}-result-text">${escapeHtml(formatCitationExcerpt(citation))}</p>
+                    </article>`).join("")}
+            </div>
+          </article>`).join(""),
+    "</div>",
+    "</div>"
+  ].join("");
+};
+var makeSourceSummaries = (prefix) => (sources) => {
+  const summaries = buildRAGSourceSummaries(sources);
+  if (summaries.length === 0) {
+    return `<p class="${prefix}-metadata">Retrieved source groups: 0</p>`;
+  }
+  const groups = buildSourceSummarySectionGroups(summaries);
+  return [
+    `<p class="${prefix}-metadata">Retrieved source groups: ${summaries.length}</p>`,
+    `<div class="${prefix}-result-grid">`,
+    groups.map((group) => `
+          <article class="${prefix}-result-item" id="${escapeHtml(group.targetId)}">
+            <h3>${escapeHtml(group.label)}</h3>
+            <p class="${prefix}-result-source">${escapeHtml(group.summary)}</p>
+            <div class="${prefix}-result-grid">
+              ${group.summaries.map((summary) => `
+                    <article class="${prefix}-result-item">
+                      <h4>${escapeHtml(summary.label)}</h4>
+                      ${formatSourceSummaryDetails(summary).map((line) => `<p class="${prefix}-metadata">${escapeHtml(line)}</p>`).join("")}
+                      <p class="${prefix}-result-text">${escapeHtml(summary.excerpt)}</p>
+                    </article>`).join("")}
+            </div>
+          </article>`).join(""),
+    "</div>"
+  ].join("");
+};
+var makeSectionDiagnosticCard = (prefix) => (diagnostic) => [
+  `<article class="${prefix}-result-item">`,
+  `<h4>${escapeHtml(diagnostic.label)}</h4>`,
+  `<p class="${prefix}-result-source">${escapeHtml(diagnostic.summary)}</p>`,
+  `<p class="${prefix}-metadata">${escapeHtml(formatSectionDiagnosticChannels(diagnostic))}</p>`,
+  `<p class="${prefix}-metadata">${escapeHtml(formatSectionDiagnosticAttributionFocus(diagnostic))}</p>`,
+  `<p class="${prefix}-metadata">${escapeHtml(formatSectionDiagnosticPipeline(diagnostic))}</p>`,
+  `${formatSectionDiagnosticStageFlow(diagnostic) ? `<p class="${prefix}-metadata">${escapeHtml(formatSectionDiagnosticStageFlow(diagnostic) ?? "")}</p>` : ""}`,
+  `${formatSectionDiagnosticStageBounds(diagnostic) ? `<p class="${prefix}-metadata">${escapeHtml(formatSectionDiagnosticStageBounds(diagnostic) ?? "")}</p>` : ""}`,
+  `${formatSectionDiagnosticStageWeightRows(diagnostic).map((line) => `<p class="${prefix}-metadata">${escapeHtml(line)}</p>`).join("")}`,
+  `<p class="${prefix}-metadata">${escapeHtml(formatSectionDiagnosticTopEntry(diagnostic))}</p>`,
+  `${formatSectionDiagnosticCompetition(diagnostic) ? `<p class="${prefix}-metadata">${escapeHtml(formatSectionDiagnosticCompetition(diagnostic) ?? "")}</p>` : ""}`,
+  `${[...formatSectionDiagnosticReasons(diagnostic), ...formatSectionDiagnosticStageWeightReasons(diagnostic)].length > 0 ? `<div class="${prefix}-badge-row">${[...formatSectionDiagnosticReasons(diagnostic), ...formatSectionDiagnosticStageWeightReasons(diagnostic)].map((reason) => `<span class="${prefix}-state-chip">${escapeHtml(reason)}</span>`).join("")}</div>` : ""}`,
+  `${formatSectionDiagnosticDistributionRows(diagnostic).map((line) => `<p class="${prefix}-metadata">${escapeHtml(line)}</p>`).join("")}`,
+  `</article>`
+].join("");
+var resolveRAGHTMXRenderers = (custom = {}) => {
+  const classPrefix = custom.classPrefix ?? "rag";
+  return {
+    adminActionCards: custom.adminActionCards ?? makeAdminActionCards(classPrefix),
+    adminJobCards: custom.adminJobCards ?? makeAdminJobCards(classPrefix),
+    capabilities: custom.capabilities ?? makeCapabilities(classPrefix),
+    citations: custom.citations ?? makeCitations(classPrefix),
+    classPrefix,
+    detailList: custom.detailList ?? makeDetailList(classPrefix),
+    nativeSource: custom.nativeSource ?? defaultNativeSource,
+    sectionDiagnosticCard: custom.sectionDiagnosticCard ?? makeSectionDiagnosticCard(classPrefix),
+    sourceSummaries: custom.sourceSummaries ?? makeSourceSummaries(classPrefix),
+    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 +21562,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 +21577,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 +21592,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 +21630,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 +21644,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 +21656,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 +21695,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 +21723,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 +21735,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 +21770,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 +21781,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 +21791,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 +21810,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 +21823,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 +21832,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 +21886,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 +21912,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 +21923,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 +21942,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 +21951,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,
@@ -37649,5 +38080,5 @@ export {
   addRAGEvaluationSuiteCase
 };
 
-//# debugId=74D455A5F912939764756E2164756E21
+//# debugId=1EFB64CE5660478364756E2164756E21
 //# sourceMappingURL=index.js.map