fix(kb-ui): SensitivityBadge tolerates an unset/unknown level

A kb.list row can arrive without a sensitivity (a claim/note, or older data);
SENSITIVITY[level] was then undefined and reading .tone crashed the whole
object list. Fall back to a neutral badge — never defaulting an unknown value
to "Open", which would misstate exposure. (Surfaced building the standalone
webapp against a real corpus.)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

src/_internal.tsx

@@ -117,7 +117,16 @@ const SENSITIVITY: Record<Sensitivity, { label: string; tone: string; icon: Reac
 };
 
 export const SensitivityBadge: FC<{ level: Sensitivity; className?: string }> = ({ level, className }) => {
-  const s = SENSITIVITY[level];
+  // A row can arrive without a sensitivity (e.g. a claim/note, or older data);
+  // fall back to a neutral badge rather than crash — and never default an
+  // unknown value to "Open", which would misstate its exposure.
+  const s =
+    SENSITIVITY[level] ?? {
+      label: level ?? "—",
+      tone: "bg-muted text-muted-foreground",
+      icon: null,
+      title: "Sensitivity not set.",
+    };
   return (
     <Badge tone={s.tone} icon={s.icon} className={className} title={s.title}>
       {s.label}

src/components-claims.tsx

@@ -200,9 +200,12 @@ export const ClaimsReviewQueue: FC<ClaimsReviewQueueProps> = ({
   const inConflict = new Set(conflictGroups.flat().map((c) => c.claim_id));
 
   const proposed = claims.filter((c) => c.status === "proposed" && !inConflict.has(c.claim_id));
-  const unreviewed = claims.filter(
-    (c) => c.status === "active" && c.review_state === "unreviewed" && !inConflict.has(c.claim_id),
-  );
+  // Everything the queue returned that isn't a "proposed" card or a rendered
+  // conflict pair belongs in "Awaiting review". Filtering narrowly (active +
+  // unreviewed only) silently dropped anything else the endpoint surfaced —
+  // e.g. a claim flagged open-conflict whose counterpart isn't in this payload
+  // (a singleton group, not rendered as a pair) rendered nowhere at all.
+  const rest = claims.filter((c) => c.status !== "proposed" && !inConflict.has(c.claim_id));
 
   if (claims.length === 0) {
     return <>{emptyState ?? <Empty />}</>;
@@ -230,8 +233,8 @@ export const ClaimsReviewQueue: FC<ClaimsReviewQueueProps> = ({
         ))}
       </Section>
 
-      <Section title="Awaiting review" count={unreviewed.length} hint="Visible already, labelled by tier — review at your pace.">
-        {unreviewed.map((c) => (
+      <Section title="Awaiting review" count={rest.length} hint="Visible already, labelled by tier — review at your pace.">
+        {rest.map((c) => (
           <ClaimCard key={c.claim_id} claim={c} busy={busyId === c.claim_id} onConfirm={onConfirm} onReject={onReject} onReopen={onReopen} onOpenSource={onOpenSource} />
         ))}
       </Section>

src/components-collections.tsx

@@ -70,6 +70,10 @@ export interface CollectionListProps {
   onCreate?: (ownerType: "account" | "tenant") => void;
   canManageTenant?: boolean;
   onOpen?: (collection: Collection) => void;
+  /** When set, renders a "Load more" affordance (the list is paginated). */
+  onLoadMore?: () => void;
+  hasMore?: boolean;
+  loadingMore?: boolean;
   emptyState?: ReactNode;
   className?: string;
 }
@@ -81,6 +85,9 @@ export const CollectionList: FC<CollectionListProps> = ({
   onCreate,
   canManageTenant = false,
   onOpen,
+  onLoadMore,
+  hasMore,
+  loadingMore,
   emptyState,
   className,
 }) => {
@@ -112,6 +119,18 @@ export const CollectionList: FC<CollectionListProps> = ({
           emptyHint={org.length === 0 ? "No shared corpuses yet." : undefined}
         />
       )}
+      {hasMore && onLoadMore && (
+        <button
+          type="button"
+          data-action="knowledge-load-more-collections"
+          onClick={onLoadMore}
+          disabled={loadingMore}
+          className="inline-flex items-center justify-center gap-1.5 self-center rounded-lg border border-border px-3 py-1.5 text-sm text-muted-foreground transition hover:bg-muted disabled:opacity-50"
+        >
+          {loadingMore && <Loader2 className="size-3.5 animate-spin" />}
+          {loadingMore ? "Loading…" : "Load more"}
+        </button>
+      )}
     </div>
   );
 };

src/components-object.tsx

@@ -32,34 +32,52 @@ import {
 export interface ObjectListProps {
   objects: ObjectSummary[];
   onOpen?: (object: ObjectSummary) => void;
+  /** When set, renders a "Load more" affordance (the list is paginated). */
+  onLoadMore?: () => void;
+  hasMore?: boolean;
+  loadingMore?: boolean;
   emptyState?: ReactNode;
   className?: string;
 }
 
-export const ObjectList: FC<ObjectListProps> = ({ objects, onOpen, emptyState, className }) => {
+export const ObjectList: FC<ObjectListProps> = ({ objects, onOpen, onLoadMore, hasMore, loadingMore, emptyState, className }) => {
   if (objects.length === 0 && emptyState) return <>{emptyState}</>;
   return (
-    <ul className={cn("flex flex-col divide-y divide-border rounded-xl border border-border bg-card", className)}>
-      {objects.map((o) => (
-        <li key={o.object_id}>
-          <button
-            type="button"
-            data-action="knowledge-open-object"
-            data-object-id={o.object_id}
-            onClick={() => onOpen?.(o)}
-            className="flex w-full items-center gap-3 px-4 py-3 text-left transition hover:bg-muted/50 focus:outline-none focus-visible:bg-muted/50"
-          >
-            <span className="text-muted-foreground">{o.kind === "claim" ? <Sparkles className="size-4" /> : <FileText className="size-4" />}</span>
-            <span className="min-w-0 flex-1">
-              <span className={cn("block truncate text-sm font-medium", o.status === "superseded" && "text-muted-foreground line-through")}>{o.title}</span>
-              <span className="text-xs text-muted-foreground">{o.effective_at ? `effective ${formatDate(o.effective_at)}` : `updated ${formatDate(o.updated_at)}`}</span>
-            </span>
-            <StatusBadge status={o.status} />
-            <SensitivityBadge level={o.sensitivity} />
-          </button>
-        </li>
-      ))}
-    </ul>
+    <div className={cn("flex flex-col gap-3", className)}>
+      <ul className="flex flex-col divide-y divide-border rounded-xl border border-border bg-card">
+        {objects.map((o) => (
+          <li key={o.object_id}>
+            <button
+              type="button"
+              data-action="knowledge-open-object"
+              data-object-id={o.object_id}
+              onClick={() => onOpen?.(o)}
+              className="flex w-full items-center gap-3 px-4 py-3 text-left transition hover:bg-muted/50 focus:outline-none focus-visible:bg-muted/50"
+            >
+              <span className="text-muted-foreground">{o.kind === "claim" ? <Sparkles className="size-4" /> : <FileText className="size-4" />}</span>
+              <span className="min-w-0 flex-1">
+                <span className={cn("block truncate text-sm font-medium", o.status === "superseded" && "text-muted-foreground line-through")}>{o.title}</span>
+                <span className="text-xs text-muted-foreground">{o.effective_at ? `effective ${formatDate(o.effective_at)}` : `updated ${formatDate(o.updated_at)}`}</span>
+              </span>
+              <StatusBadge status={o.status} />
+              <SensitivityBadge level={o.sensitivity} />
+            </button>
+          </li>
+        ))}
+      </ul>
+      {hasMore && onLoadMore && (
+        <button
+          type="button"
+          data-action="knowledge-load-more-objects"
+          onClick={onLoadMore}
+          disabled={loadingMore}
+          className="inline-flex items-center justify-center gap-1.5 self-center rounded-lg border border-border px-3 py-1.5 text-sm text-muted-foreground transition hover:bg-muted disabled:opacity-50"
+        >
+          {loadingMore && <Loader2 className="size-3.5 animate-spin" />}
+          {loadingMore ? "Loading…" : "Load more"}
+        </button>
+      )}
+    </div>
   );
 };
 
@@ -237,28 +255,41 @@ export interface TextReaderProps {
 export const TextReader: FC<TextReaderProps> = ({ outline, readText, highlight, activeSection, className }) => {
   const [slice, setSlice] = useState<TextSlice | null>(null);
   const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const [loadingMore, setLoadingMore] = useState(false);
   const markRef = useRef<HTMLSpanElement | null>(null);
+  // Monotonic request id: rapid section/citation nav fires overlapping reads;
+  // only the newest may commit, so a slow earlier response can't clobber it.
+  const reqRef = useRef(0);
 
   const load = useCallback(
     async (sel?: { section?: string; start?: number; end?: number }) => {
+      const req = ++reqRef.current;
       setLoading(true);
+      setError(null);
       try {
-        setSlice(await readText(sel));
+        const next = await readText(sel);
+        if (reqRef.current === req) setSlice(next);
+      } catch {
+        // A failed read must surface, not blank the panel (and never leak as an
+        // unhandled rejection).
+        if (reqRef.current === req) setError("Couldn't load this text. Try again.");
       } finally {
-        setLoading(false);
+        if (reqRef.current === req) setLoading(false);
       }
     },
     [readText],
   );
 
-  // Initial + reactive loads: prefer an explicit highlight span, then an active
-  // section, else the head of the document.
+  // Initial + reactive loads: an explicit outline selection wins (so clicking a
+  // section works even on a citation-opened view), then the highlight span,
+  // else the head of the document.
   useEffect(() => {
-    if (highlight) {
+    if (activeSection) {
+      void load({ section: activeSection });
+    } else if (highlight) {
       const sec = outline.outline.find((s) => highlight.start >= s.start && highlight.end <= s.end);
       void load(sec ? { section: sec.id } : { start: Math.max(0, highlight.start - 200), end: highlight.end + 200 });
-    } else if (activeSection) {
-      void load({ section: activeSection });
     } else {
       void load();
     }
@@ -270,13 +301,20 @@ export const TextReader: FC<TextReaderProps> = ({ outline, readText, highlight,
   }, [slice]);
 
   async function loadMore() {
-    if (!slice?.range) return;
-    const next = await readText({ start: slice.range.end });
-    setSlice((prev) =>
-      prev && prev.range && next.range
-        ? { ...next, text: (prev.text ?? "") + (next.text ?? ""), range: { start: prev.range.start, end: next.range.end } }
-        : next,
-    );
+    if (loadingMore || !slice?.range) return;
+    setLoadingMore(true);
+    try {
+      const next = await readText({ start: slice.range.end });
+      setSlice((prev) =>
+        prev && prev.range && next.range
+          ? { ...next, text: (prev.text ?? "") + (next.text ?? ""), range: { start: prev.range.start, end: next.range.end } }
+          : next,
+      );
+    } catch {
+      setError("Couldn't load more text. Try again.");
+    } finally {
+      setLoadingMore(false);
+    }
   }
 
   if (loading && !slice) {
@@ -286,6 +324,21 @@ export const TextReader: FC<TextReaderProps> = ({ outline, readText, highlight,
       </div>
     );
   }
+  if (error && !slice) {
+    return (
+      <div className={cn("py-8 text-sm", className)}>
+        <p className="text-destructive">{error}</p>
+        <button
+          type="button"
+          data-action="knowledge-text-retry"
+          onClick={() => void load(activeSection ? { section: activeSection } : undefined)}
+          className="mt-2 rounded-lg border border-border px-3 py-1.5 text-sm text-muted-foreground transition hover:bg-muted"
+        >
+          Retry
+        </button>
+      </div>
+    );
+  }
   if (!slice) return null;
 
   const canReadMore = outline.extracted_chars != null && slice.range != null && slice.range.end < outline.extracted_chars;
@@ -295,14 +348,17 @@ export const TextReader: FC<TextReaderProps> = ({ outline, readText, highlight,
       <article className="whitespace-pre-wrap break-words text-sm leading-relaxed text-foreground">
         {renderWithHighlight(slice, highlight, markRef)}
       </article>
+      {error && <p className="mt-2 text-xs text-destructive">{error}</p>}
       {canReadMore && (
         <button
           type="button"
           data-action="knowledge-read-more"
           onClick={() => void loadMore()}
-          className="mt-3 rounded-lg border border-border px-3 py-1.5 text-sm text-muted-foreground transition hover:bg-muted"
+          disabled={loadingMore}
+          className="mt-3 inline-flex items-center gap-1.5 rounded-lg border border-border px-3 py-1.5 text-sm text-muted-foreground transition hover:bg-muted disabled:opacity-50"
         >
-          Read more
+          {loadingMore && <Loader2 className="size-3.5 animate-spin" />}
+          {loadingMore ? "Loading…" : "Read more"}
         </button>
       )}
     </div>
@@ -396,12 +452,24 @@ export const ObjectViewer: FC<ObjectViewerProps> = ({
     !!actions &&
     (actions.onEditMeta || actions.onVerify || actions.onDownload || actions.onArchive || actions.onSupersede || actions.onExtractClaims);
 
+  // Navigating object→object (citation click) reuses this component: clear the
+  // per-object view state so a stale section selection or the previous image
+  // can't bleed into the new object.
+  useEffect(() => {
+    setActiveSection(undefined);
+  }, [outline.object_id]);
+
   useEffect(() => {
     let live = true;
+    setBlob(null);
     if (isImage && outline.has_blob && resolveBlobUrl) {
-      void resolveBlobUrl().then((u) => {
-        if (live) setBlob(u);
-      });
+      void resolveBlobUrl()
+        .then((u) => {
+          if (live) setBlob(u);
+        })
+        .catch(() => {
+          /* leave the placeholder frame; the download action still works */
+        });
     }
     return () => {
       live = false;

src/components-search.tsx

@@ -0,0 +1,151 @@
+// PURPOSE: Corpus search (spec §5) — the input + results panel, lifted out of
+//          the app so every consumer (embedded + standalone) renders search the
+//          same way instead of hand-rolling hit rendering. Owns query state,
+//          paginated results, loading/error/clear; shows the caller's `browse`
+//          content when there is no active search. Pure: the actual search runs
+//          through an injected `onSearch` callback.
+// ===========================================================================
+import { useState, type FC, type FormEvent, type ReactNode } from "react";
+import { Loader2, Search, X } from "lucide-react";
+import type { ObjectSummary, SearchHit, SearchPage } from "./types";
+import { ObjectList } from "./components-object";
+
+function hitToSummary(h: SearchHit): ObjectSummary {
+  return {
+    object_id: h.object_id,
+    kind: h.kind,
+    title: h.title,
+    status: "active",
+    updated_at: h.updated_at ?? "",
+    effective_at: h.effective_at ?? null,
+    sensitivity: h.sensitivity,
+  };
+}
+
+export interface KnowledgeSearchProps {
+  /** Run a search and return a page; `cursor` drives "Load more". */
+  onSearch: (query: string, cursor?: string) => Promise<SearchPage>;
+  onOpen?: (objectId: string) => void;
+  placeholder?: string;
+  /** Shown below the input while there is no active search (the browse list). */
+  browse?: ReactNode;
+  className?: string;
+}
+
+export const KnowledgeSearch: FC<KnowledgeSearchProps> = ({
+  onSearch,
+  onOpen,
+  placeholder,
+  browse,
+  className,
+}) => {
+  const [query, setQuery] = useState("");
+  const [hits, setHits] = useState<SearchHit[] | null>(null);
+  const [cursor, setCursor] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [loadingMore, setLoadingMore] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  function clear() {
+    setHits(null);
+    setCursor(null);
+    setQuery("");
+    setError(null);
+  }
+
+  async function run(e?: FormEvent) {
+    e?.preventDefault();
+    const q = query.trim();
+    if (!q) {
+      clear();
+      return;
+    }
+    setLoading(true);
+    setError(null);
+    try {
+      const page = await onSearch(q);
+      setHits(page.hits);
+      setCursor(page.next_cursor ?? null);
+    } catch {
+      setError("Search failed. Try again.");
+    } finally {
+      setLoading(false);
+    }
+  }
+
+  async function loadMore() {
+    if (!cursor || loadingMore) return;
+    setLoadingMore(true);
+    try {
+      const page = await onSearch(query.trim(), cursor);
+      setHits((prev) => [...(prev ?? []), ...page.hits]);
+      setCursor(page.next_cursor ?? null);
+    } catch {
+      setError("Couldn't load more results. Try again.");
+    } finally {
+      setLoadingMore(false);
+    }
+  }
+
+  return (
+    <div className={className}>
+      <form onSubmit={run} className="mb-4 flex items-center gap-2">
+        <div className="relative flex-1">
+          <Search className="absolute left-3 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" />
+          <input
+            data-action="knowledge-search"
+            className="w-full rounded-lg border border-border bg-background py-2 pl-9 pr-9 text-sm outline-none focus:border-primary/50 focus:ring-2 focus:ring-primary/30"
+            placeholder={placeholder ?? "Search…"}
+            value={query}
+            onChange={(e) => setQuery(e.target.value)}
+          />
+          {query && (
+            <button
+              type="button"
+              onClick={clear}
+              aria-label="Clear search"
+              className="absolute right-2 top-1/2 -translate-y-1/2 rounded p-1 text-muted-foreground transition-colors hover:text-foreground"
+            >
+              <X className="size-4" />
+            </button>
+          )}
+        </div>
+      </form>
+
+      {loading ? (
+        <p className="flex items-center justify-center gap-2 py-8 text-sm text-muted-foreground">
+          <Loader2 className="size-4 animate-spin" /> Searching…
+        </p>
+      ) : error ? (
+        <p className="rounded-lg border border-destructive/30 bg-destructive/5 px-3 py-2 text-sm text-destructive">
+          {error}
+        </p>
+      ) : hits ? (
+        <div>
+          <div className="mb-2 flex items-center justify-between text-xs text-muted-foreground">
+            <span>
+              {hits.length} result{hits.length === 1 ? "" : "s"}
+            </span>
+            <button type="button" className="transition-colors hover:text-foreground" onClick={clear}>
+              Clear
+            </button>
+          </div>
+          <ObjectList
+            objects={hits.map(hitToSummary)}
+            onOpen={(o) => onOpen?.(o.object_id)}
+            onLoadMore={loadMore}
+            hasMore={!!cursor}
+            loadingMore={loadingMore}
+            emptyState={
+              <div className="rounded-xl border border-dashed border-border py-12 text-center text-sm text-muted-foreground">
+                No matches.
+              </div>
+            }
+          />
+        </div>
+      ) : (
+        (browse ?? null)
+      )}
+    </div>
+  );
+};

src/index.tsx

@@ -35,3 +35,4 @@ export * from "./components-collections";
 export * from "./components-object";
 export * from "./components-claims";
 export * from "./components-export";
+export * from "./components-search";