feat(detail): conversation transcript loader on every surface

Phase 4.5.

Core (lovcode-core::detail):
- get_conversation(id) — TermQuery on the id field, read source + raw_path
  from the stored doc, route to the owning adapter, parse the file
  fresh and return the conversation whose id matches.

Surfaces wired:
- CLI:   `lovcode show <id> [--json]`
- HTTP:  `GET /conversation/{id}`
- MCP:   new `get_conversation` tool
- Tauri: `get_conversation` command + `focus_main_window` (palette can
  hide itself, focus main, and emit a navigate event with the id)

Frontend:
- New /conversation/:id route (pages/conversation/[id].tsx) — renders
  the message list with role / timestamp / pre-wrapped content.
- ResultCard is now clickable: main → react-router navigate, palette →
  invoke focus_main_window so the main window navigates instead.
- main.tsx listens for `lovcode:navigate-conversation` events from the
  Tauri side and routes the hash router accordingly.

Smoke-tested: `lovcode show <id>` prints the full transcript of the
in-progress refactor session correctly, including CJK content.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: MarkShawn2020

crates/lovcode-cli/src/cmd_serve.rs

@@ -1,16 +1,17 @@
 //! HTTP server — axum. Used by the web UI and external clients.
 
 use anyhow::Result;
-use axum::extract::{Query, State};
+use axum::extract::{Path as AxumPath, Query, State};
 use axum::http::StatusCode;
 use axum::response::Json;
 use axum::routing::get;
 use axum::Router;
 use clap::Args as ClapArgs;
 use lovcode_core::adapter::builtin_adapters;
+use lovcode_core::detail;
 use lovcode_core::index::LovcodeIndex;
 use lovcode_core::query;
-use lovcode_core::types::{SearchQuery, SearchResult};
+use lovcode_core::types::{Conversation, SearchQuery, SearchResult};
 use serde::Deserialize;
 use std::net::{IpAddr, SocketAddr};
 use std::path::Path;
@@ -48,6 +49,7 @@ async fn serve(index_dir: &Path, args: Args) -> Result<()> {
         .route("/health", get(|| async { "ok" }))
         .route("/sources", get(list_sources))
         .route("/search", get(do_search))
+        .route("/conversation/{id}", get(get_conversation))
         .with_state(state);
 
     if args.cors {
@@ -88,6 +90,15 @@ async fn do_search(
     Ok(Json(r))
 }
 
+async fn get_conversation(
+    State(s): State<AppState>,
+    AxumPath(id): AxumPath<String>,
+) -> Result<Json<Conversation>, (StatusCode, String)> {
+    detail::get_conversation(&s.index, &id)
+        .map(Json)
+        .map_err(|e| (StatusCode::NOT_FOUND, e.to_string()))
+}
+
 async fn list_sources() -> Json<Vec<serde_json::Value>> {
     let out = builtin_adapters()
         .iter()

crates/lovcode-cli/src/cmd_show.rs

@@ -0,0 +1,33 @@
+use anyhow::Result;
+use clap::Args as ClapArgs;
+use lovcode_core::detail;
+use lovcode_core::index::LovcodeIndex;
+use std::path::Path;
+
+#[derive(ClapArgs)]
+pub struct Args {
+    pub id: String,
+    #[arg(long)]
+    pub json: bool,
+}
+
+pub fn run(index_dir: &Path, args: Args) -> Result<()> {
+    let idx = LovcodeIndex::open_or_create(index_dir)?;
+    let conv = detail::get_conversation(&idx, &args.id)?;
+    if args.json {
+        println!("{}", serde_json::to_string_pretty(&conv)?);
+        return Ok(());
+    }
+    println!("# {}", conv.title.as_deref().unwrap_or(&conv.id));
+    println!("source: {}   id: {}", conv.source, conv.id);
+    if let Some(p) = &conv.project { println!("project: {p}"); }
+    println!();
+    for (i, m) in conv.messages.iter().enumerate() {
+        let role = format!("{:?}", m.role).to_lowercase();
+        let ts = m.timestamp.map(|t| t.format("%H:%M:%S").to_string()).unwrap_or_default();
+        println!("─── [{i}] {role}  {ts} ───");
+        println!("{}", m.content);
+        println!();
+    }
+    Ok(())
+}

crates/lovcode-cli/src/main.rs

@@ -4,6 +4,7 @@ mod cmd_index;
 mod cmd_mcp;
 mod cmd_search;
 mod cmd_serve;
+mod cmd_show;
 mod cmd_sources;
 
 use clap::{Parser, Subcommand};
@@ -28,6 +29,9 @@ enum Cmd {
     /// Search the index.
     Search(cmd_search::Args),
 
+    /// Show one conversation by id.
+    Show(cmd_show::Args),
+
     /// List configured source adapters.
     Sources,
 
@@ -55,6 +59,7 @@ fn main() -> anyhow::Result<()> {
     match cli.command {
         Cmd::Index(a) => cmd_index::run(&index_dir, a),
         Cmd::Search(a) => cmd_search::run(&index_dir, a),
+        Cmd::Show(a) => cmd_show::run(&index_dir, a),
         Cmd::Sources => cmd_sources::run(&index_dir),
         Cmd::Serve(a) => cmd_serve::run(&index_dir, a),
         Cmd::Mcp => cmd_mcp::run(&index_dir),

crates/lovcode-core/src/detail.rs

@@ -0,0 +1,47 @@
+//! Conversation detail loader — re-parse from raw file using the id stored in the index.
+
+use crate::adapter::builtin_adapters;
+use crate::index::LovcodeIndex;
+use crate::types::Conversation;
+use anyhow::{anyhow, Result};
+use std::path::PathBuf;
+use tantivy::query::TermQuery;
+use tantivy::schema::{IndexRecordOption, Value};
+use tantivy::TantivyDocument;
+
+pub fn get_conversation(idx: &LovcodeIndex, id: &str) -> Result<Conversation> {
+    let reader = idx.reader()?;
+    let searcher = reader.searcher();
+    let schema = idx.schema();
+
+    let term = tantivy::Term::from_field_text(schema.id, id);
+    let query = TermQuery::new(term, IndexRecordOption::Basic);
+    let hits = searcher.search(&query, &tantivy::collector::TopDocs::with_limit(1))?;
+    let (_, addr) = hits.first().ok_or_else(|| anyhow!("not found: {id}"))?;
+    let doc: TantivyDocument = searcher.doc(*addr)?;
+
+    let source = doc
+        .get_first(schema.source)
+        .and_then(|v| v.as_str())
+        .ok_or_else(|| anyhow!("missing source field"))?
+        .to_string();
+    let raw_path: Option<PathBuf> = doc
+        .get_first(schema.raw_path)
+        .and_then(|v| v.as_str())
+        .map(PathBuf::from);
+
+    let Some(path) = raw_path else {
+        return Err(anyhow!("conversation has no raw_path (transient?): {id}"));
+    };
+
+    let adapter = builtin_adapters()
+        .into_iter()
+        .find(|a| a.id() == source)
+        .ok_or_else(|| anyhow!("unknown source adapter: {source}"))?;
+
+    let conversations = adapter.parse_many(&path)?;
+    conversations
+        .into_iter()
+        .find(|c| c.id == id)
+        .ok_or_else(|| anyhow!("conversation {id} not found in file {}", path.display()))
+}

crates/lovcode-core/src/lib.rs

@@ -14,3 +14,4 @@ pub mod adapter;
 pub mod index;
 pub mod query;
 pub mod watcher;
+pub mod detail;

crates/lovcode-mcp/src/lib.rs

@@ -8,6 +8,7 @@
 //! server (e.g. `lovcode mcp`).
 
 use lovcode_core::adapter::builtin_adapters;
+use lovcode_core::detail;
 use lovcode_core::index::LovcodeIndex;
 use lovcode_core::query;
 use lovcode_core::types::SearchQuery;
@@ -28,6 +29,12 @@ pub struct LovcodeMcp {
     tool_router: ToolRouter<LovcodeMcp>,
 }
 
+#[derive(Debug, serde::Deserialize, schemars::JsonSchema)]
+pub struct GetArgs {
+    /// Conversation id returned by `search_conversations`.
+    pub id: String,
+}
+
 #[derive(Debug, serde::Deserialize, schemars::JsonSchema)]
 pub struct SearchArgs {
     /// Search query string. Supports phrases.
@@ -76,6 +83,18 @@ impl LovcodeMcp {
         Ok(CallToolResult::success(vec![Content::text(json)]))
     }
 
+    #[tool(description = "Fetch the full message transcript of one conversation by id.")]
+    async fn get_conversation(
+        &self,
+        Parameters(args): Parameters<GetArgs>,
+    ) -> Result<CallToolResult, McpError> {
+        let conv = detail::get_conversation(&self.index, &args.id)
+            .map_err(|e| McpError::internal_error(format!("get failed: {e}"), None))?;
+        let json = serde_json::to_string_pretty(&conv)
+            .map_err(|e| McpError::internal_error(format!("serialize failed: {e}"), None))?;
+        Ok(CallToolResult::success(vec![Content::text(json)]))
+    }
+
     #[tool(description = "List configured conversation source adapters and their discovered counts.")]
     async fn list_sources(&self) -> Result<CallToolResult, McpError> {
         let out: Vec<_> = builtin_adapters()

src-tauri/src/commands.rs

@@ -1,9 +1,10 @@
 //! Tauri command wrappers — thin adapters over `lovcode-core`.
 
 use lovcode_core::adapter::builtin_adapters;
+use lovcode_core::detail;
 use lovcode_core::index::{default_index_dir, LovcodeIndex};
 use lovcode_core::query;
-use lovcode_core::types::{SearchQuery, SearchResult};
+use lovcode_core::types::{Conversation, SearchQuery, SearchResult};
 use lovcode_core::watcher;
 use serde::Serialize;
 use std::sync::OnceLock;
@@ -60,6 +61,11 @@ pub fn search(
     query::search(index(), &query).map_err(|e| e.to_string())
 }
 
+#[tauri::command]
+pub fn get_conversation(id: String) -> Result<Conversation, String> {
+    detail::get_conversation(index(), &id).map_err(|e| e.to_string())
+}
+
 #[tauri::command]
 pub async fn rebuild_index() -> Result<usize, String> {
     tokio::task::spawn_blocking(|| {

src-tauri/src/lib.rs

@@ -2,7 +2,7 @@
 
 mod commands;
 
-use tauri::Manager;
+use tauri::{Emitter, Manager};
 use tauri_plugin_global_shortcut::{Code, GlobalShortcutExt, Modifiers, Shortcut, ShortcutState};
 
 #[cfg_attr(mobile, tauri::mobile_entry_point)]
@@ -36,8 +36,10 @@ pub fn run() {
             commands::ping,
             commands::list_sources,
             commands::search,
+            commands::get_conversation,
             commands::rebuild_index,
             toggle_search_overlay,
+            focus_main_window,
         ])
         .run(tauri::generate_context!())
         .expect("error while running tauri application");
@@ -59,3 +61,18 @@ fn toggle_search_window(app: &tauri::AppHandle) {
 fn toggle_search_overlay(app: tauri::AppHandle) {
     toggle_search_window(&app);
 }
+
+/// Focus the main window and emit a navigation event with the target conversation id.
+#[tauri::command]
+fn focus_main_window(app: tauri::AppHandle, conversation_id: Option<String>) {
+    if let Some(win) = app.get_webview_window("main") {
+        let _ = win.show();
+        let _ = win.set_focus();
+        if let Some(id) = conversation_id {
+            let _ = win.emit("lovcode:navigate-conversation", id);
+        }
+    }
+    if let Some(win) = app.get_webview_window("search") {
+        let _ = win.hide();
+    }
+}

src/components/SearchUI.tsx

@@ -1,12 +1,14 @@
 import { useEffect, useMemo, useRef, useState } from "react";
-import { listSources, rebuildIndex, search, type SearchResult, type SourceSummary } from "@/lib/api";
+import { focusMainWindow, listSources, rebuildIndex, search, type SearchResult, type SourceSummary } from "@/lib/api";
+import { useNavigate } from "react-router-dom";
 
 interface Props {
   /** Compact = floating palette (no header, no rebuild). */
   compact?: boolean;
 }
 
 export function SearchUI({ compact = false }: Props) {
+  const navigate = useNavigate();
   const [q, setQ] = useState("");
   const [source, setSource] = useState<string>("");
   const [sources, setSources] = useState<SourceSummary[]>([]);
@@ -124,7 +126,18 @@ export function SearchUI({ compact = false }: Props) {
           )}
           <ul className="space-y-3">
             {results.map((r) => (
-              <ResultCard key={r.conversation_id + r.source} r={r} compact={compact} />
+              <ResultCard
+                key={r.conversation_id + r.source}
+                r={r}
+                compact={compact}
+                onSelect={() => {
+                  if (compact) {
+                    focusMainWindow(r.conversation_id).catch(() => {});
+                  } else {
+                    navigate(`/conversation/${encodeURIComponent(r.conversation_id)}`);
+                  }
+                }}
+              />
             ))}
           </ul>
         </div>
@@ -133,10 +146,16 @@ export function SearchUI({ compact = false }: Props) {
   );
 }
 
-function ResultCard({ r, compact }: { r: SearchResult; compact: boolean }) {
+function ResultCard({ r, compact, onSelect }: { r: SearchResult; compact: boolean; onSelect: () => void }) {
   const date = r.timestamp ? new Date(r.timestamp).toISOString().slice(0, 10) : "—";
   return (
-    <li className={`rounded-xl border border-border bg-card ${compact ? "p-3" : "p-4"}`}>
+    <li
+      role="button"
+      tabIndex={0}
+      onClick={onSelect}
+      onKeyDown={(e) => { if (e.key === "Enter") onSelect(); }}
+      className={`cursor-pointer rounded-xl border border-border bg-card transition hover:border-primary/40 hover:bg-muted/50 ${compact ? "p-3" : "p-4"}`}
+    >
       <div className="flex items-baseline gap-3 text-xs text-muted-foreground">
         <span className="rounded bg-muted px-1.5 py-0.5 font-mono">{r.source}</span>
         <span>{date}</span>

src/lib/api.ts

@@ -35,3 +35,30 @@ export function search(args: {
 export function rebuildIndex(): Promise<number> {
   return invoke<number>("rebuild_index");
 }
+
+export type ConversationRole = "user" | "assistant" | "system" | "tool" | "other";
+
+export interface ConversationMessage {
+  role: ConversationRole;
+  content: string;
+  timestamp: string | null;
+}
+
+export interface Conversation {
+  id: string;
+  source: string;
+  project: string | null;
+  title: string | null;
+  created_at: string | null;
+  updated_at: string | null;
+  messages: ConversationMessage[];
+  raw_path: string | null;
+}
+
+export function getConversation(id: string): Promise<Conversation> {
+  return invoke<Conversation>("get_conversation", { id });
+}
+
+export function focusMainWindow(conversationId?: string): Promise<void> {
+  return invoke("focus_main_window", { conversationId: conversationId ?? null });
+}