feat(recall): add corpus browser page (kenn-io#1243)

Adds Recall as a top-level corpus browser. Accepted entries appear in a padded, single-row table for quick comparison; each row expands in place to show the full fact, trigger, uncertainty, extraction metadata, provenance state, and transcript evidence. Search and filters cover project, type, active extraction generation, and review state.

Browsing stays bounded with cursor pagination. Ranked searches preserve relevance semantics, reject stale continuations after corpus mutations, and disclose the existing 500-result cap. The page also reports extraction coverage and stays unavailable on read-only backends.

Co-authored-by: Wes McKinney <wesm@users.noreply.github.com>

Author: wesm

cmd/agentsview/main.go

@@ -23,6 +23,7 @@ import (
 	"go.kenn.io/agentsview/internal/config"
 	"go.kenn.io/agentsview/internal/db"
 	"go.kenn.io/agentsview/internal/parser"
+	"go.kenn.io/agentsview/internal/recall/extract"
 	"go.kenn.io/agentsview/internal/remotesync"
 	"go.kenn.io/agentsview/internal/secrets"
 	"go.kenn.io/agentsview/internal/server"
@@ -490,6 +491,10 @@ func runServe(cfg config.Config, opts serveOptions) {
 		// no sync activity follows. Notify never blocks.
 		srvOpts = append(srvOpts,
 			server.WithSessionMutationNotifier(extractSched.Notify))
+		if manager, ok := extractSched.mgr.(*extract.Manager); ok {
+			srvOpts = append(srvOpts,
+				server.WithRecallExtractionStatusProvider(manager))
+		}
 	}
 	if engine != nil {
 		srvOpts = append(srvOpts, server.WithLocalSyncRunner(

frontend/messages/en.json

@@ -19,6 +19,7 @@
   "nav_more_navigation": "More navigation",
   "nav_more": "More",
   "nav_trends": "Trends",
+  "nav_recall": "Recall",
   "nav_pinned": "Pinned",
   "nav_insights": "Insights",
   "nav_trash": "Trash",
@@ -1280,6 +1281,41 @@
   "session_recall_provenance_revoked": "Provenance revoked",
   "session_recall_evidence_range": "Messages {start}–{end}",
   "session_recall_jump_evidence": "Jump to transcript messages {start}–{end}",
+  "recall_page_title": "Recall",
+  "recall_page_subtitle": "Browse distilled entries and extraction coverage.",
+  "recall_page_search_placeholder": "Search Recall entries…",
+  "recall_page_clear_search": "Clear Recall search",
+  "recall_page_type_filter": "Entry type",
+  "recall_page_all_types": "All types",
+  "recall_page_generation_filter": "Extraction generation",
+  "recall_page_all_generations": "All generations",
+  "recall_page_review_filter": "Review state",
+  "recall_page_all_review_states": "All review states",
+  "recall_page_table_label": "Recall entries",
+  "recall_page_fact_column": "Fact",
+  "recall_page_project_column": "Project",
+  "recall_page_expand_entry": "Expand {title}",
+  "recall_page_collapse_entry": "Collapse {title}",
+  "recall_page_trigger_label": "Trigger",
+  "recall_page_uncertainty_label": "Uncertainty",
+  "recall_page_loading": "Loading Recall entries…",
+  "recall_page_unavailable_read_only": "Recall is unavailable in read-only mode.",
+  "recall_page_empty": "No Recall entries match these filters.",
+  "recall_page_error": "Could not load Recall entries.",
+  "recall_page_load_more": "Load more",
+  "recall_page_loading_more": "Loading more…",
+  "recall_page_ranked_result_cap": "Ranked search is limited to the first {countLabel} matches.",
+  "recall_page_entries_shown": "Entries shown: {countLabel}",
+  "recall_page_extraction_title": "Extraction status",
+  "recall_page_extraction_unconfigured": "Recall extraction is not configured.",
+  "recall_page_extraction_error": "Could not load extraction status.",
+  "recall_page_status_done": "{countLabel} done",
+  "recall_page_status_failed": "{countLabel} failed",
+  "recall_page_status_eligible": "{countLabel} eligible",
+  "recall_page_status_pending": "{countLabel} pending",
+  "recall_page_status_partial": "{countLabel} partial",
+  "recall_page_status_units": "Units {doneLabel}/{totalLabel}",
+  "recall_page_status_entries": "{countLabel} entries",
   "session_vitals_title": "Analysis",
   "session_vitals_subtitle": "Session vital signs",
   "session_vitals_close": "Close session analysis",

frontend/messages/fr.json

@@ -19,6 +19,7 @@
   "nav_more_navigation": "Plus de navigation",
   "nav_more": "Plus",
   "nav_trends": "Tendances",
+  "nav_recall": "Rappel",
   "nav_pinned": "Épinglés",
   "nav_insights": "Analyses",
   "nav_trash": "Corbeille",
@@ -1280,6 +1281,41 @@
   "session_recall_provenance_revoked": "Provenance révoquée",
   "session_recall_evidence_range": "Messages {start}–{end}",
   "session_recall_jump_evidence": "Aller aux messages {start}–{end} de la transcription",
+  "recall_page_title": "Rappel",
+  "recall_page_subtitle": "Parcourir les entrées distillées et la couverture d’extraction.",
+  "recall_page_search_placeholder": "Rechercher dans le rappel…",
+  "recall_page_clear_search": "Effacer la recherche de rappel",
+  "recall_page_type_filter": "Type d’entrée",
+  "recall_page_all_types": "Tous les types",
+  "recall_page_generation_filter": "Génération d’extraction",
+  "recall_page_all_generations": "Toutes les générations",
+  "recall_page_review_filter": "État de révision",
+  "recall_page_all_review_states": "Tous les états de révision",
+  "recall_page_table_label": "Entrées de rappel",
+  "recall_page_fact_column": "Fait",
+  "recall_page_project_column": "Projet",
+  "recall_page_expand_entry": "Développer {title}",
+  "recall_page_collapse_entry": "Réduire {title}",
+  "recall_page_trigger_label": "Déclencheur",
+  "recall_page_uncertainty_label": "Incertitude",
+  "recall_page_loading": "Chargement des entrées de rappel…",
+  "recall_page_unavailable_read_only": "Le rappel n’est pas disponible en mode lecture seule.",
+  "recall_page_empty": "Aucune entrée de rappel ne correspond à ces filtres.",
+  "recall_page_error": "Impossible de charger les entrées de rappel.",
+  "recall_page_load_more": "Afficher plus",
+  "recall_page_loading_more": "Chargement…",
+  "recall_page_ranked_result_cap": "La recherche classée est limitée aux {countLabel} premiers résultats.",
+  "recall_page_entries_shown": "Entrées affichées : {countLabel}",
+  "recall_page_extraction_title": "État de l’extraction",
+  "recall_page_extraction_unconfigured": "L’extraction du rappel n’est pas configurée.",
+  "recall_page_extraction_error": "Impossible de charger l’état de l’extraction.",
+  "recall_page_status_done": "{countLabel} terminées",
+  "recall_page_status_failed": "{countLabel} échouées",
+  "recall_page_status_eligible": "{countLabel} éligibles",
+  "recall_page_status_pending": "{countLabel} en attente",
+  "recall_page_status_partial": "{countLabel} partielles",
+  "recall_page_status_units": "Unités {doneLabel}/{totalLabel}",
+  "recall_page_status_entries": "{countLabel} entrées",
   "session_vitals_title": "Analyse",
   "session_vitals_subtitle": "Signes vitaux de la session",
   "session_vitals_close": "Fermer l'analyse de la session",

frontend/messages/ko.json

@@ -19,6 +19,7 @@
   "nav_more_navigation": "추가 내비게이션",
   "nav_more": "더 보기",
   "nav_trends": "트렌드",
+  "nav_recall": "리콜",
   "nav_pinned": "고정됨",
   "nav_insights": "인사이트",
   "nav_trash": "휴지통",
@@ -1250,6 +1251,41 @@
   "session_recall_provenance_revoked": "출처가 취소됨",
   "session_recall_evidence_range": "메시지 {start}–{end}",
   "session_recall_jump_evidence": "대화 기록 메시지 {start}–{end}(으)로 이동",
+  "recall_page_title": "리콜",
+  "recall_page_subtitle": "추출된 항목과 추출 범위를 살펴봅니다.",
+  "recall_page_search_placeholder": "리콜 항목 검색…",
+  "recall_page_clear_search": "리콜 검색 지우기",
+  "recall_page_type_filter": "항목 유형",
+  "recall_page_all_types": "모든 유형",
+  "recall_page_generation_filter": "추출 세대",
+  "recall_page_all_generations": "모든 세대",
+  "recall_page_review_filter": "검토 상태",
+  "recall_page_all_review_states": "모든 검토 상태",
+  "recall_page_table_label": "리콜 항목",
+  "recall_page_fact_column": "사실",
+  "recall_page_project_column": "프로젝트",
+  "recall_page_expand_entry": "{title} 펼치기",
+  "recall_page_collapse_entry": "{title} 접기",
+  "recall_page_trigger_label": "트리거",
+  "recall_page_uncertainty_label": "불확실성",
+  "recall_page_loading": "리콜 항목을 불러오는 중…",
+  "recall_page_unavailable_read_only": "읽기 전용 모드에서는 리콜을 사용할 수 없습니다.",
+  "recall_page_empty": "이 필터와 일치하는 리콜 항목이 없습니다.",
+  "recall_page_error": "리콜 항목을 불러올 수 없습니다.",
+  "recall_page_load_more": "더 보기",
+  "recall_page_loading_more": "더 불러오는 중…",
+  "recall_page_ranked_result_cap": "순위 검색은 처음 {countLabel}개의 일치 항목으로 제한됩니다.",
+  "recall_page_entries_shown": "표시된 항목: {countLabel}",
+  "recall_page_extraction_title": "추출 상태",
+  "recall_page_extraction_unconfigured": "리콜 추출이 구성되지 않았습니다.",
+  "recall_page_extraction_error": "추출 상태를 불러올 수 없습니다.",
+  "recall_page_status_done": "완료 {countLabel}",
+  "recall_page_status_failed": "실패 {countLabel}",
+  "recall_page_status_eligible": "대상 {countLabel}",
+  "recall_page_status_pending": "대기 {countLabel}",
+  "recall_page_status_partial": "부분 완료 {countLabel}",
+  "recall_page_status_units": "단위 {doneLabel}/{totalLabel}",
+  "recall_page_status_entries": "항목 {countLabel}",
   "session_vitals_title": "분석",
   "session_vitals_subtitle": "세션 바이탈 사인",
   "session_vitals_close": "세션 분석 닫기",

frontend/messages/zh-CN.json

@@ -19,6 +19,7 @@
   "nav_more_navigation": "更多导航",
   "nav_more": "更多",
   "nav_trends": "趋势",
+  "nav_recall": "召回",
   "nav_pinned": "已固定",
   "nav_insights": "洞察",
   "nav_trash": "回收站",
@@ -1248,6 +1249,41 @@
   "session_recall_provenance_revoked": "来源已撤销",
   "session_recall_evidence_range": "消息 {start}–{end}",
   "session_recall_jump_evidence": "跳转到转录消息 {start}–{end}",
+  "recall_page_title": "召回",
+  "recall_page_subtitle": "浏览提炼条目和提取覆盖情况。",
+  "recall_page_search_placeholder": "搜索召回条目…",
+  "recall_page_clear_search": "清除召回搜索",
+  "recall_page_type_filter": "条目类型",
+  "recall_page_all_types": "所有类型",
+  "recall_page_generation_filter": "提取代次",
+  "recall_page_all_generations": "所有代次",
+  "recall_page_review_filter": "审核状态",
+  "recall_page_all_review_states": "所有审核状态",
+  "recall_page_table_label": "召回条目",
+  "recall_page_fact_column": "事实",
+  "recall_page_project_column": "项目",
+  "recall_page_expand_entry": "展开 {title}",
+  "recall_page_collapse_entry": "收起 {title}",
+  "recall_page_trigger_label": "触发条件",
+  "recall_page_uncertainty_label": "不确定性",
+  "recall_page_loading": "正在加载召回条目…",
+  "recall_page_unavailable_read_only": "只读模式下无法使用召回。",
+  "recall_page_empty": "没有符合这些筛选条件的召回条目。",
+  "recall_page_error": "无法加载召回条目。",
+  "recall_page_load_more": "加载更多",
+  "recall_page_loading_more": "正在加载更多…",
+  "recall_page_ranked_result_cap": "排序搜索仅显示前 {countLabel} 个匹配项。",
+  "recall_page_entries_shown": "显示条目：{countLabel}",
+  "recall_page_extraction_title": "提取状态",
+  "recall_page_extraction_unconfigured": "尚未配置召回提取。",
+  "recall_page_extraction_error": "无法加载提取状态。",
+  "recall_page_status_done": "已完成 {countLabel}",
+  "recall_page_status_failed": "失败 {countLabel}",
+  "recall_page_status_eligible": "符合条件 {countLabel}",
+  "recall_page_status_pending": "待处理 {countLabel}",
+  "recall_page_status_partial": "部分完成 {countLabel}",
+  "recall_page_status_units": "单元 {doneLabel}/{totalLabel}",
+  "recall_page_status_entries": "条目 {countLabel}",
   "session_vitals_title": "分析",
   "session_vitals_subtitle": "会话指标",
   "session_vitals_close": "关闭会话分析",

frontend/messages/zh-TW.json

@@ -19,6 +19,7 @@
   "nav_more_navigation": "更多導航",
   "nav_more": "更多",
   "nav_trends": "趨勢",
+  "nav_recall": "召回",
   "nav_pinned": "已釘選",
   "nav_insights": "洞察",
   "nav_trash": "垃圾桶",
@@ -1248,6 +1249,41 @@
   "session_recall_provenance_revoked": "來源已撤銷",
   "session_recall_evidence_range": "訊息 {start}-{end}",
   "session_recall_jump_evidence": "跳至逐字稿訊息 {start}-{end}",
+  "recall_page_title": "召回",
+  "recall_page_subtitle": "瀏覽提煉項目和擷取涵蓋情況。",
+  "recall_page_search_placeholder": "搜尋召回項目…",
+  "recall_page_clear_search": "清除召回搜尋",
+  "recall_page_type_filter": "項目類型",
+  "recall_page_all_types": "所有類型",
+  "recall_page_generation_filter": "擷取代次",
+  "recall_page_all_generations": "所有代次",
+  "recall_page_review_filter": "審核狀態",
+  "recall_page_all_review_states": "所有審核狀態",
+  "recall_page_table_label": "召回項目",
+  "recall_page_fact_column": "事實",
+  "recall_page_project_column": "專案",
+  "recall_page_expand_entry": "展開 {title}",
+  "recall_page_collapse_entry": "收合 {title}",
+  "recall_page_trigger_label": "觸發條件",
+  "recall_page_uncertainty_label": "不確定性",
+  "recall_page_loading": "正在載入召回項目…",
+  "recall_page_unavailable_read_only": "唯讀模式下無法使用召回。",
+  "recall_page_empty": "沒有符合這些篩選條件的召回項目。",
+  "recall_page_error": "無法載入召回項目。",
+  "recall_page_load_more": "載入更多",
+  "recall_page_loading_more": "正在載入更多…",
+  "recall_page_ranked_result_cap": "排序搜尋僅顯示前 {countLabel} 個相符項目。",
+  "recall_page_entries_shown": "顯示項目：{countLabel}",
+  "recall_page_extraction_title": "擷取狀態",
+  "recall_page_extraction_unconfigured": "尚未設定召回擷取。",
+  "recall_page_extraction_error": "無法載入擷取狀態。",
+  "recall_page_status_done": "已完成 {countLabel}",
+  "recall_page_status_failed": "失敗 {countLabel}",
+  "recall_page_status_eligible": "符合條件 {countLabel}",
+  "recall_page_status_pending": "待處理 {countLabel}",
+  "recall_page_status_partial": "部分完成 {countLabel}",
+  "recall_page_status_units": "單元 {doneLabel}/{totalLabel}",
+  "recall_page_status_entries": "項目 {countLabel}",
   "session_vitals_title": "分析",
   "session_vitals_subtitle": "對話指標",
   "session_vitals_close": "關閉對話分析",

frontend/src/App.svelte

@@ -39,6 +39,7 @@
 
 <script lang="ts">
   import { onMount, untrack } from "svelte";
+  import { EmptyState } from "@kenn-io/kit-ui";
   import AppHeader from "./lib/components/layout/AppHeader.svelte";
   import ThreeColumnLayout from "./lib/components/layout/ThreeColumnLayout.svelte";
   import SessionBreadcrumb from "./lib/components/layout/SessionBreadcrumb.svelte";
@@ -60,6 +61,7 @@
   import UsagePage from "./lib/components/usage/UsagePage.svelte";
   import ActivityPage from "./lib/components/activity/ActivityPage.svelte";
   import TrendsPage from "./lib/components/trends/TrendsPage.svelte";
+  import RecallPage from "./lib/components/recall/RecallPage.svelte";
   import InsightsPage from "./lib/components/insights/InsightsPage.svelte";
   import PinnedPage from "./lib/components/pinned/PinnedPage.svelte";
   import TrashPage from "./lib/components/trash/TrashPage.svelte";
@@ -98,6 +100,13 @@
   } from "./lib/stores/sessionRouteParams.js";
 
   let globalAuthToken: string = $state("");
+  const recallModeKnown = $derived(
+    sync.serverVersion !== null ||
+      (settings.loaded && settings.error === null),
+  );
+  const recallUnavailable = $derived(
+    sync.readOnly || settings.readOnly,
+  );
 
   function handleGlobalAuth() {
     const token = globalAuthToken.trim();
@@ -667,6 +676,18 @@
   <div class="page-scroll">
     <TrendsPage />
   </div>
+{:else if router.route === "recall"}
+  <div class="page-scroll">
+    {#if recallUnavailable}
+      <div class="recall-route-state">
+        <EmptyState title={m.recall_page_unavailable_read_only()} />
+      </div>
+    {:else if recallModeKnown}
+      <RecallPage />
+    {:else}
+      <p class="recall-route-state">{m.recall_page_loading()}</p>
+    {/if}
+  </div>
 {:else if router.route === "insights"}
   <div class="page-scroll">
     <InsightsPage />
@@ -792,6 +813,12 @@
     overflow: hidden;
   }
 
+  .recall-route-state {
+    padding: 32px 24px;
+    color: var(--text-muted);
+    font-size: 13px;
+  }
+
   /* kit-ui-check-ignore: undo toast carries an inline restore action; kit-ui FlashBanner only supports text+dismiss today, so replacing this would change the delete/undo workflow. */
   .undo-toast {
     position: fixed;