fix: backfill session archives and split roadmap home

Author: sarthakagrawal927

PROJECT_STATUS.md

@@ -23,15 +23,15 @@ CodeVetter is a local-first desktop workbench for checking agent-generated code.
 - Review Memory Graph has a repo-level and review-scoped first slice: Repo Unpacked now persists a deterministic local `repo_graph` artifact with package scripts, routes, Tauri commands, DB tables, tests, and decision markers; exports local graph JSON plus agent-context markdown sidecars for optional Graphify/Hunk-style interop without adding either dependency; imports graph JSON only through an explicit Repo Unpacked file action, validates CodeVetter or loose graph-shaped JSON, and renders imported graphs as non-mutating previews; CLI review results also carry a bounded local graph over changed files, evidence candidates, procedure gates, blast/history context, the review prompt includes that graph neighborhood, Review shows a compact graph panel plus selected-finding graph focus, copied reviewer proof includes both full graph and focused finding graph nodes/edges, and Review can copy a selected finding as a Hunk-style agent-context note with file/line, evidence status, local history, focused graph, and next verification actions.
 - Agent Verification Timeline has a first normalized spine: Review now builds a shared task/review/QA/evidence/claim-check/fix/worktree timeline contract, attaches bounded raw-session command anchors to evidence rows with transcript excerpts, adds a dedicated Claim check row for failed/stale command claims, explicit extracted agent claims, positive test/check claims contradicted by failed/stale command evidence, unchecked findings, unresolved post-fix QA, and fixes without same-flow reruns, attaches edit-origin anchors for fix changed files to worktree rows, renders timeline stages and anchors in the sidebar, exposes first-class jump targets for findings, files, QA artifacts, fix worktrees, command source anchors, and edited files, shows same-flow post-fix QA before/after deltas with artifact anchors on the QA row, can copy segment-scoped fix packets directly from Review/Evidence/QA/Fix/Worktree timeline rows, includes clicked-row timeline replay metadata and transcript snippets in those packets, and includes the same timeline plus source/event/artifact/jump/edit/transcript anchors in copied reviewer proof.
 - Codebase History Explainer has a first file-level slice: Review now builds bounded, cited "why this code exists" explanations from local commits, decision markers, recurring findings, agent notes, and command anchors, renders them in the sidebar, and includes them in copied reviewer proof.
-- AI Session Intelligence has a first local scorecard slice: indexed sessions produce a schema-versioned six-dimension scorecard with cited evidence refs, anti-gaming notes, recommendations, normalized Claude/Codex/Cursor adapter coverage summaries, production and scorecard adapter run metadata/parse warnings in `session_adapter_runs`, a compact `session_message_archive` for normalized adapter messages/tool calls, a shared raw parser adapter contract with Claude/Codex/Cursor fixtures, Claude/Codex/Cursor production indexing wired through that contract, a Tauri IPC contract, compact Home dashboard panels for scorecard and source health, visible adapter run status, per-adapter run trends, and recent-run drilldowns.
-- Home now has a persistent Verification Workbench launcher plus a visible latest-roadmap-build banner, so Evidence Search, Agent Timeline, Synthetic QA, Memory Graph, History Brief, AI Sessions, transcript replay, claim checks, replay packets, timeline fix packets, edit origins, and post-fix QA deltas are visible immediately after launch instead of only appearing after a Review or Repo Unpacked run.
+- AI Session Intelligence has a first local scorecard slice: indexed sessions produce a schema-versioned six-dimension scorecard with cited evidence refs, anti-gaming notes, recommendations, normalized Claude/Codex/Cursor adapter coverage summaries, production and scorecard adapter run metadata/parse warnings in `session_adapter_runs`, a compact `session_message_archive` for normalized adapter messages/tool calls, local backfill for previously indexed Claude/Codex sessions missing archive rows, a shared raw parser adapter contract with Claude/Codex/Cursor fixtures, Claude/Codex/Cursor production indexing wired through that contract, a Tauri IPC contract, compact Roadmap dashboard panels for scorecard and source health, visible adapter run status, per-adapter run trends, and recent-run drilldowns.
+- Home now opens on usage first. The Verification Workbench launcher and latest-roadmap-build banner live on the Roadmap page, so Evidence Search, Agent Timeline, Synthetic QA, Memory Graph, History Brief, AI Sessions, transcript replay, claim checks, replay packets, timeline fix packets, edit origins, and post-fix QA deltas remain visible without pushing usage down on app launch.
 - OSS repo-analysis engines were evaluated in `docs/oss-integration-evaluation.md`; optional `ast-grep` changed-file evidence is implemented behind PATH detection with no required runtime dependency.
 - Product direction has been consolidated around agent-written code verification, evidence levels, timelines, and explainable codebase history.
 
 ## Planned Next
 
-1. Continue the AI Session Intelligence PRD in `docs/PRD-AI-SESSION-INTELLIGENCE.md`: add full-text search and live update events over the normalized session message archive; Claude, Codex, and Cursor production session rows now use the normalized raw parser adapter contract, production index passes persist adapter run metadata/parse warnings plus compact message/tool-call archive rows, and Home shows latest source-health status with per-adapter trends and recent-run drilldowns.
-2. Continue the Agent Verification Timeline PRD in `docs/PRD-AGENT-VERIFICATION-TIMELINE.md`: add richer claim-vs-evidence discrepancy parsing beyond literal positive test/check claim contradictions, command/QA/evidence-count signals, and fuller multi-turn transcript replay; raw session command anchors with bounded transcript excerpts, explicit agent-claim anchors, dedicated claim-check rows, edit-origin anchors, timeline-specific jump targets, timeline-segment replay packets, same-flow post-fix QA deltas, and the Home latest-roadmap-build banner are now attached to visible Review/Home actions and proof export.
+1. Continue the AI Session Intelligence PRD in `docs/PRD-AI-SESSION-INTELLIGENCE.md`: add full-text search and live update events over the normalized session message archive; Claude, Codex, and Cursor production session rows now use the normalized raw parser adapter contract, production index passes persist adapter run metadata/parse warnings plus compact message/tool-call archive rows, local backfill repairs older Claude/Codex sessions with missing archive rows, and Roadmap shows latest source-health status with per-adapter trends and recent-run drilldowns.
+2. Continue the Agent Verification Timeline PRD in `docs/PRD-AGENT-VERIFICATION-TIMELINE.md`: add richer claim-vs-evidence discrepancy parsing beyond literal positive test/check claim contradictions, command/QA/evidence-count signals, and fuller multi-turn transcript replay; raw session command anchors with bounded transcript excerpts, explicit agent-claim anchors, dedicated claim-check rows, edit-origin anchors, timeline-specific jump targets, timeline-segment replay packets, same-flow post-fix QA deltas, and the Roadmap latest-build banner are now attached to visible Review/Roadmap actions and proof export.
 3. Continue the Codebase History Explainer PRD in `docs/PRD-CODEBASE-HISTORY-EXPLAINER.md`: turn the persisted `history_brief` slice into a queryable local history graph; Repo Unpacked history brief integration and agent-context sidecar export are now implemented.
 4. Curate 20-30 real public agent-generated PR benchmark cases with hand-labeled ground truth before making external catch-rate claims.
 5. Add benchmark fields for unverified-fix count and time/cost impact once review artifacts capture those values consistently.

apps/desktop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@code-reviewer/desktop",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "private": true,
   "scripts": {
     "dev": "lsof -ti:1420 | xargs kill -9 2>/dev/null; vite",

apps/desktop/src-tauri/src/commands/history.rs

@@ -427,10 +427,21 @@ fn full_index_impl(conn: &rusqlite::Connection) -> Result<(u64, u64, u64), Strin
     indexed_messages += codex_messages;
 
     // ── Phase 3: Scan Cursor AI sessions ─────────────────────
-    let (cursor_indexed, cursor_messages, cursor_skipped) = index_cursor_sessions(&conn)?;
-    indexed_sessions += cursor_indexed;
-    indexed_messages += cursor_messages;
-    skipped_sessions += cursor_skipped;
+    match index_cursor_sessions(&conn) {
+        Ok((cursor_indexed, cursor_messages, cursor_skipped)) => {
+            indexed_sessions += cursor_indexed;
+            indexed_messages += cursor_messages;
+            skipped_sessions += cursor_skipped;
+        }
+        Err(error) => {
+            log::warn!("Cursor session index failed; continuing with archive backfill: {error}");
+        }
+    }
+
+    let backfilled_archives = backfill_missing_session_archives(&conn)?;
+    if backfilled_archives > 0 {
+        log::info!("Backfilled normalized session archive for {backfilled_archives} sessions");
+    }
 
     Ok((indexed_sessions, indexed_messages, skipped_sessions))
 }
@@ -732,13 +743,38 @@ fn upsert_adapter_summary_session(
         let _ = queries::bump_session_day(conn, &sid, day, *n);
     }
 
+    replace_archive_messages(
+        conn,
+        &sid,
+        &adapter_id,
+        &agent_type,
+        &source_ref,
+        archive_messages,
+    )?;
+
+    Ok(IndexedAdapterSession {
+        session_id: sid,
+        source_ref,
+        messages_indexed: message_count,
+        parse_warnings,
+    })
+}
+
+fn replace_archive_messages(
+    conn: &rusqlite::Connection,
+    session_id: &str,
+    adapter_id: &str,
+    agent_type: &str,
+    source_ref: &str,
+    archive_messages: Vec<crate::commands::session_adapters::RawSessionArchiveMessage>,
+) -> Result<(), String> {
     let archive_inputs: Vec<_> = archive_messages
         .into_iter()
         .enumerate()
         .map(|(idx, message)| queries::SessionMessageArchiveInput {
-            adapter_id: adapter_id.clone(),
-            agent_type: agent_type.clone(),
-            source_ref: source_ref.clone(),
+            adapter_id: adapter_id.to_string(),
+            agent_type: agent_type.to_string(),
+            source_ref: source_ref.to_string(),
             source_line: message.source_line,
             message_index: idx as i64,
             role: message.role,
@@ -750,15 +786,8 @@ fn upsert_adapter_summary_session(
             raw_type: message.raw_type,
         })
         .collect();
-    queries::replace_session_message_archive(conn, &sid, &archive_inputs)
-        .map_err(|e| e.to_string())?;
-
-    Ok(IndexedAdapterSession {
-        session_id: sid,
-        source_ref,
-        messages_indexed: message_count,
-        parse_warnings,
-    })
+    queries::replace_session_message_archive(conn, session_id, &archive_inputs)
+        .map_err(|e| e.to_string())
 }
 
 // ─────────────────────────────────────────────────────────────────
@@ -840,6 +869,49 @@ fn parse_codex_session(
     )
 }
 
+fn backfill_missing_session_archives(conn: &rusqlite::Connection) -> Result<u64, String> {
+    let candidates =
+        queries::list_sessions_needing_archive_backfill(conn, 5_000).map_err(|e| e.to_string())?;
+    let mut backfilled = 0u64;
+
+    for candidate in candidates {
+        let path = std::path::Path::new(&candidate.jsonl_path);
+        if !path.exists() {
+            continue;
+        }
+        let raw = match std::fs::read_to_string(path) {
+            Ok(raw) => raw,
+            Err(error) => {
+                log::warn!(
+                    "Archive backfill could not read {}: {}",
+                    candidate.jsonl_path,
+                    error
+                );
+                continue;
+            }
+        };
+        let summary = match candidate.agent_type.as_str() {
+            "claude-code" => ClaudeCodeAdapter.parse_raw(&candidate.jsonl_path, &raw),
+            "codex" => CodexAdapter.parse_raw(&candidate.jsonl_path, &raw),
+            _ => continue,
+        };
+        if summary.archive_messages.is_empty() {
+            continue;
+        }
+        replace_archive_messages(
+            conn,
+            &candidate.id,
+            &summary.adapter_id,
+            &summary.agent_type,
+            &summary.source_ref,
+            summary.archive_messages,
+        )?;
+        backfilled += 1;
+    }
+
+    Ok(backfilled)
+}
+
 // ─────────────────────────────────────────────────────────────────
 // Cursor AI session detection & indexing
 // ─────────────────────────────────────────────────────────────────
@@ -1376,6 +1448,58 @@ mod tests {
         assert_eq!(archived[1].raw_type.as_deref(), Some("response_item"));
     }
 
+    #[test]
+    fn archive_backfill_repairs_existing_codex_session_rows() {
+        let conn = memory_conn_with_project();
+        let fixture = std::path::Path::new(concat!(
+            env!("CARGO_MANIFEST_DIR"),
+            "/tests/fixtures/session_adapters/codex.jsonl"
+        ));
+
+        queries::upsert_session(
+            &conn,
+            &queries::SessionInput {
+                id: "codex-session-1".to_string(),
+                project_id: "project".to_string(),
+                agent_type: Some("codex".to_string()),
+                jsonl_path: Some(fixture.to_string_lossy().to_string()),
+                git_branch: None,
+                cwd: Some("/repo/codevetter".to_string()),
+                cli_version: None,
+                first_message: None,
+                last_message: Some("2026-06-12T16:01:00Z".to_string()),
+                message_count: Some(2),
+                total_input_tokens: Some(500),
+                total_output_tokens: Some(150),
+                model_used: Some("o3".to_string()),
+                slug: None,
+                file_size_bytes: Some(123),
+                indexed_at: Some("2026-06-12T16:03:00Z".to_string()),
+                file_mtime: Some("2026-06-12T16:03:00Z".to_string()),
+                cache_read_tokens: Some(100),
+                cache_creation_tokens: Some(0),
+                compaction_count: Some(0),
+                estimated_cost_usd: Some(0.0),
+            },
+        )
+        .expect("existing codex session");
+
+        let candidates =
+            queries::list_sessions_needing_archive_backfill(&conn, 10).expect("candidates");
+        assert_eq!(candidates.len(), 1);
+        assert_eq!(candidates[0].id, "codex-session-1");
+
+        let backfilled = backfill_missing_session_archives(&conn).expect("backfill");
+        assert_eq!(backfilled, 1);
+
+        let archived =
+            queries::list_session_message_archive(&conn, "codex-session-1", 10).expect("archive");
+        assert_eq!(archived.len(), 2);
+        assert_eq!(archived[0].adapter_id, "codex");
+        assert_eq!(archived[0].role.as_deref(), Some("user"));
+        assert_eq!(archived[1].role.as_deref(), Some("assistant"));
+    }
+
     #[test]
     fn cursor_adapter_summary_upserts_session_and_day_bucket() {
         let conn = memory_conn_with_project();

apps/desktop/src-tauri/src/commands/session_adapters.rs

@@ -118,7 +118,13 @@ fn bounded_text(raw: impl Into<String>) -> Option<String> {
     }
     const MAX_ARCHIVE_TEXT: usize = 12_000;
     if value.len() > MAX_ARCHIVE_TEXT {
-        value.truncate(MAX_ARCHIVE_TEXT);
+        let truncate_at = value
+            .char_indices()
+            .map(|(idx, _)| idx)
+            .take_while(|idx| *idx <= MAX_ARCHIVE_TEXT)
+            .last()
+            .unwrap_or(0);
+        value.truncate(truncate_at);
         value.push_str("\n[truncated]");
     }
     Some(value)
@@ -765,4 +771,13 @@ mod tests {
             .iter()
             .any(|warning| warning.contains("missing session_meta id")));
     }
+
+    #[test]
+    fn archive_text_truncation_handles_unicode_boundaries() {
+        let raw = "न".repeat(12_001);
+        let text = bounded_text(raw).expect("bounded unicode text");
+
+        assert!(text.ends_with("\n[truncated]"));
+        assert!(text.is_char_boundary(text.len()));
+    }
 }

apps/desktop/src-tauri/src/db/queries.rs

@@ -331,6 +331,13 @@ pub struct SessionMeta {
     pub archived_message_count: i64,
 }
 
+#[derive(Debug, Clone)]
+pub struct SessionArchiveBackfillCandidate {
+    pub id: String,
+    pub agent_type: String,
+    pub jsonl_path: String,
+}
+
 /// Look up the stored session metadata for a given `jsonl_path`.
 /// Returns `None` if the file has never been indexed.
 pub fn get_session_by_jsonl_path(
@@ -727,6 +734,35 @@ pub fn list_session_message_archive(
     rows.collect()
 }
 
+pub fn list_sessions_needing_archive_backfill(
+    conn: &Connection,
+    limit: i64,
+) -> Result<Vec<SessionArchiveBackfillCandidate>, rusqlite::Error> {
+    let limit = limit.clamp(1, 5_000);
+    let mut stmt = conn.prepare(
+        "SELECT s.id, s.agent_type, s.jsonl_path
+         FROM cc_sessions s
+         WHERE s.jsonl_path IS NOT NULL
+           AND s.message_count > 0
+           AND s.agent_type IN ('claude-code', 'codex')
+           AND (
+             SELECT COUNT(*)
+             FROM session_message_archive a
+             WHERE a.session_id = s.id
+           ) < s.message_count
+         ORDER BY datetime(s.last_message) DESC NULLS LAST
+         LIMIT ?1",
+    )?;
+    let rows = stmt.query_map(params![limit], |row| {
+        Ok(SessionArchiveBackfillCandidate {
+            id: row.get(0)?,
+            agent_type: row.get(1)?,
+            jsonl_path: row.get(2)?,
+        })
+    })?;
+    rows.collect()
+}
+
 // ─────────────────────────────────────────────────────────────────
 // Local Reviews
 // ─────────────────────────────────────────────────────────────────

apps/desktop/src-tauri/tauri.conf.json

@@ -2,7 +2,7 @@
   "$schema": "https://raw.githubusercontent.com/tauri-apps/tauri/dev/crates/tauri-utils/schema.json",
   "identifier": "com.codevetter.desktop",
   "productName": "CodeVetter",
-  "version": "1.1.44",
+  "version": "1.1.45",
   "build": {
     "beforeDevCommand": "npm run dev",
     "beforeBuildCommand": "npm run build",

apps/desktop/src/App.tsx

@@ -15,6 +15,7 @@ import IntentDebugger from "@/pages/IntentDebugger";
 import QaReplay from "@/pages/QaReplay";
 import QuickReview from "@/pages/QuickReview";
 import RepoUnpacked from "@/pages/RepoUnpacked";
+import Roadmap from "@/pages/Roadmap";
 import Rubrics from "@/pages/Rubrics";
 import Settings from "@/pages/Settings";
 
@@ -168,6 +169,7 @@ export default function App() {
       <Route element={<Shell />}>
         <Route path="/" element={<Home />} />
         <Route path="/review" element={<QuickReview />} />
+        <Route path="/roadmap" element={<Roadmap />} />
         <Route path="/rubrics" element={<Rubrics />} />
         <Route path="/unpack" element={<RepoUnpacked />} />
         <Route path="/intent-debugger" element={<IntentDebugger />} />

apps/desktop/src/components/command-palette.tsx

@@ -77,6 +77,7 @@ export default function CommandPalette({ isOpen, onClose }: CommandPaletteProps)
       // Navigation
       { id: "nav-home", label: "Go to Home", icon: "\u2302", shortcut: "g h", group: "Navigation", action: go("/") },
       { id: "nav-review", label: "Go to Review", icon: "\u2714", shortcut: "g r", group: "Navigation", action: go("/review") },
+      { id: "nav-roadmap", label: "Go to Roadmap", icon: "\u25ce", shortcut: "g m", group: "Navigation", action: go("/roadmap") },
       { id: "nav-settings", label: "Go to Settings", icon: "\u2638", shortcut: "g ,", group: "Navigation", action: go("/settings") },
 
       // Actions