Skip to content

armgit / Wake

Public Imported from GitHub
0

All your AI agent sessions in one place — browse, search, resume. Rust + GPUI.

Rust

Add test suite and CI

Corey Chiu71db0d2f2f84
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..a646d6e
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,30 @@
+name: CI
+
+on:
+ push:
+ branches: [main]
+ pull_request:
+
+env:
+ CARGO_TERM_COLOR: always
+
+jobs:
+ test:
+ name: Test & build (macOS)
+ runs-on: macos-14
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Install Rust
+ uses: dtolnay/rust-toolchain@stable
+
+ - name: Cache cargo
+ uses: Swatinem/rust-cache@v2
+
+ # 数据层测试:adapter 解析契约 / seq 一致性 / db 往返 / 扫描终态
+ - name: Test wake-core
+ run: cargo test -p wake-core
+
+ # UI 层无测试套件(gpui),编译通过即门槛
+ - name: Build app
+ run: cargo build -p wake
diff --git a/Cargo.lock b/Cargo.lock
index 59cabfe..92a847f 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -6804,6 +6804,7 @@ dependencies = [
"rusqlite",
"serde",
"serde_json",
+ "tempfile",
"walkdir",
]
diff --git a/README.md b/README.md
index d579ce9..5b11d75 100644
--- a/README.md
+++ b/README.md
@@ -53,11 +53,15 @@ The app is ad-hoc signed, so if you download a prebuilt copy instead of building
```bash
cargo run -p wake # run in dev mode
+cargo test -p wake-core # data-layer tests (adapter contracts, FTS, scanner)
cargo run -p wake-core --bin scan # data-layer smoke test: scan and print stats
cargo run -p wake-core --bin scan -- --search "useEffect(" # search smoke test
WAKE_THEME=dark cargo run -p wake # force dark/light (defaults to system)
+git config core.hooksPath scripts/hooks # optional: run tests before every commit
```
+CI runs `cargo test -p wake-core` plus a full app build on every push and PR. Tests parse synthetic fixture sessions only — your real agent data is never touched.
+
## Architecture
```
diff --git a/crates/wake-core/Cargo.toml b/crates/wake-core/Cargo.toml
index 9d66628..bd0026d 100644
--- a/crates/wake-core/Cargo.toml
+++ b/crates/wake-core/Cargo.toml
@@ -14,6 +14,9 @@ walkdir.workspace = true
notify.workspace = true
chrono.workspace = true
+[dev-dependencies]
+tempfile = "3"
+
[[bin]]
name = "scan"
path = "src/bin/scan.rs"
diff --git a/crates/wake-core/tests/adapter_contracts.rs b/crates/wake-core/tests/adapter_contracts.rs
new file mode 100644
index 0000000..d821616
--- /dev/null
+++ b/crates/wake-core/tests/adapter_contracts.rs
@@ -0,0 +1,604 @@
+//! 七家 adapter 的解析契约测试:全部走公开 API(`AgentAdapter` trait),
+//! fixture 为全合成数据(tests/fixtures/,SQLite 型在临时 HOME 里现建)。
+//!
+//! Copilot/OpenCode 的 parse 只认 `~/.copilot`、`~/.local/share/opencode`
+//! (路径在 `new()` 时由 HOME 解析),Gemini 的 cwd 反查读 `~/.gemini/projects.json`,
+//! 因此测试统一把 HOME 指到临时假家目录(OnceLock 保证 set_var 先于一切
+//! adapter 构造,且只发生一次)。文件型 agent 的 SessionFileRef 直接指向
+//! fixture 路径,不依赖 HOME。
+
+use std::collections::HashSet;
+use std::fs;
+use std::path::{Path, PathBuf};
+use std::sync::OnceLock;
+
+use wake_core::adapters::claude::ClaudeAdapter;
+use wake_core::adapters::codex::CodexAdapter;
+use wake_core::adapters::copilot::CopilotAdapter;
+use wake_core::adapters::cursor::CursorAdapter;
+use wake_core::adapters::gemini::GeminiAdapter;
+use wake_core::adapters::kiro::KiroAdapter;
+use wake_core::adapters::opencode::OpencodeAdapter;
+use wake_core::adapters::AgentAdapter;
+use wake_core::models::*;
+
+// ---------------------------------------------------------------- 测试环境
+
+struct TestEnv {
+ copilot_db: PathBuf,
+ opencode_db: PathBuf,
+ /// 假 HOME 目录本体,持有 TempDir 保证整个测试进程期间不被清理
+ _home: tempfile::TempDir,
+}
+
+static ENV: OnceLock<TestEnv> = OnceLock::new();
+
+/// 所有测试的第一步:建假 HOME(含两只 SQLite fixture 库与 gemini 的
+/// projects.json)并把 HOME 指过去。必须先于任何 Adapter::new()。
+fn setup() -> &'static TestEnv {
+ ENV.get_or_init(|| {
+ let home = tempfile::Builder::new()
+ .prefix("wake-adapter-contracts-")
+ .tempdir()
+ .expect("create fake home");
+
+ let copilot_dir = home.path().join(".copilot");
+ fs::create_dir_all(&copilot_dir).expect("mkdir .copilot");
+ let copilot_db = copilot_dir.join("session-store.db");
+ build_copilot_db(&copilot_db);
+
+ let oc_dir = home.path().join(".local").join("share").join("opencode");
+ fs::create_dir_all(&oc_dir).expect("mkdir opencode dir");
+ let opencode_db = oc_dir.join("opencode.db");
+ build_opencode_db(&opencode_db);
+
+ let gem_dir = home.path().join(".gemini");
+ fs::create_dir_all(&gem_dir).expect("mkdir .gemini");
+ fs::write(
+ gem_dir.join("projects.json"),
+ r#"{"projects":{"/Users/tester/Github/wakefx":"wakefx-gem"}}"#,
+ )
+ .expect("write projects.json");
+
+ std::env::set_var("HOME", home.path());
+ TestEnv {
+ copilot_db,
+ opencode_db,
+ _home: home,
+ }
+ })
+}
+
+/// Copilot `session-store.db` 最小同构库:sessions + turns。
+/// cop-0002 的 summary 为空,验证标题回退首条用户消息。
+fn build_copilot_db(path: &Path) {
+ let conn = rusqlite::Connection::open(path).expect("create copilot fixture db");
+ conn.execute_batch(
+ r#"
+ CREATE TABLE sessions (
+ id TEXT PRIMARY KEY, cwd TEXT, branch TEXT, summary TEXT,
+ created_at TEXT, updated_at TEXT
+ );
+ CREATE TABLE turns (
+ id INTEGER PRIMARY KEY, session_id TEXT, turn_index INTEGER,
+ user_message TEXT, assistant_response TEXT, timestamp TEXT
+ );
+ INSERT INTO sessions VALUES
+ ('cop-0001','/Users/tester/Github/wakefx','main','Copilot QR fix','2026-08-05 09:00:00','2026-08-05 09:30:00'),
+ ('cop-0002','/Users/tester/Github/wakefx','','','2026-08-05 10:00:00','2026-08-05 10:05:00');
+ INSERT INTO turns VALUES
+ (1,'cop-0001',0,'Copilot 看看二维码扫描为何闪退,是不是 useEffect() 的问题','是依赖数组问题,我给出了修复补丁。','2026-08-05 09:05:00'),
+ (2,'cop-0001',1,'谢谢,合并了',NULL,'2026-08-05 09:30:00'),
+ (3,'cop-0002',0,'空 summary 会话的兜底标题应取这句','好的。','2026-08-05 10:05:00');
+ "#,
+ )
+ .expect("populate copilot fixture db");
+}
+
+/// OpenCode `opencode.db` 最小同构库:session + message + part。
+/// msg-a 只有 synthetic part(应归 Meta);msg-c 带 reasoning/tool/unknown part。
+fn build_opencode_db(path: &Path) {
+ let conn = rusqlite::Connection::open(path).expect("create opencode fixture db");
+ conn.execute_batch(
+ r#"
+ CREATE TABLE session (
+ id TEXT PRIMARY KEY, parent_id TEXT, directory TEXT, title TEXT,
+ time_created INTEGER, time_updated INTEGER, model TEXT,
+ tokens_input INTEGER, tokens_output INTEGER, tokens_reasoning INTEGER,
+ time_archived INTEGER
+ );
+ CREATE TABLE message (id TEXT PRIMARY KEY, session_id TEXT, data TEXT, time_created INTEGER);
+ CREATE TABLE part (id TEXT PRIMARY KEY, session_id TEXT, message_id TEXT, data TEXT);
+ INSERT INTO session VALUES
+ ('oc-0001', NULL, '/Users/tester/Github/wakefx', 'OpenCode 二维码排查',
+ 1786000000000, 1786000600000, '{"providerID":"anthropic","id":"claude-sonnet-4-5"}',
+ 100, 50, 25, NULL);
+ INSERT INTO message VALUES
+ ('msg-a','oc-0001','{"id":"msg-a","role":"user","time":{"created":1786000050000}}',1786000050000),
+ ('msg-b','oc-0001','{"id":"msg-b","role":"user","time":{"created":1786000100000}}',1786000100000),
+ ('msg-c','oc-0001','{"id":"msg-c","role":"assistant","time":{"created":1786000200000}}',1786000200000);
+ INSERT INTO part VALUES
+ ('prt-a-01','oc-0001','msg-a','{"type":"text","text":"editor context: QrScanner.tsx is open","synthetic":true}'),
+ ('prt-b-01','oc-0001','msg-b','{"type":"text","text":"OpenCode 查一下二维码组件的 useEffect() 泄漏"}'),
+ ('prt-c-01','oc-0001','msg-c','{"type":"step-start"}'),
+ ('prt-c-02','oc-0001','msg-c','{"type":"reasoning","text":"先查 effect 依赖和清理函数"}'),
+ ('prt-c-03','oc-0001','msg-c','{"type":"tool","callID":"oc_call_1","tool":"grep","state":{"status":"completed","input":{"pattern":"useEffect"},"output":"src/QrScanner.tsx: useEffect(() => watch())"}}'),
+ ('prt-c-04','oc-0001','msg-c','{"type":"text","text":"找到泄漏点,已在清理回调里停止扫描。"}'),
+ ('prt-c-05','oc-0001','msg-c','{"type":"wibble-part"}');
+ "#,
+ )
+ .expect("populate opencode fixture db");
+}
+
+// ---------------------------------------------------------------- 小工具
+
+fn fixture(rel: &str) -> PathBuf {
+ Path::new(env!("CARGO_MANIFEST_DIR")).join("tests").join("fixtures").join(rel)
+}
+
+/// 文件型 agent 的 SessionFileRef(直接指 fixture,不走 list_session_files)
+fn fs_ref(agent: AgentId, path: &Path, native_id: &str) -> SessionFileRef {
+ let meta = fs::metadata(path)
+ .unwrap_or_else(|e| panic!("fixture missing {}: {e}", path.display()));
+ SessionFileRef {
+ agent,
+ native_id: native_id.to_string(),
+ file_path: path.to_string_lossy().to_string(),
+ mtime_ms: meta
+ .modified()
+ .ok()
+ .and_then(|t| t.duration_since(std::time::UNIX_EPOCH).ok())
+ .map(|d| d.as_millis() as i64)
+ .unwrap_or(0),
+ size: meta.len() as i64,
+ }
+}
+
+/// SQLite 型 agent 的虚拟路径引用(`<db>#<id>`,与 sqlite_ro::virtual_path 同构)
+fn db_ref(agent: AgentId, db: &Path, id: &str) -> SessionFileRef {
+ SessionFileRef {
+ agent,
+ native_id: id.to_string(),
+ file_path: format!("{}#{id}", db.display()),
+ mtime_ms: 1,
+ size: 1,
+ }
+}
+
+fn ms(rfc3339: &str) -> i64 {
+ chrono::DateTime::parse_from_rfc3339(rfc3339).expect("test timestamp").timestamp_millis()
+}
+
+fn roles_kinds(mainline: &[TranscriptMessage]) -> Vec<(Role, MessageKind)> {
+ mainline.iter().map(|m| (m.role, m.kind)).collect()
+}
+
+// 各 fixture 的固定引用
+fn claude_ref() -> SessionFileRef {
+ fs_ref(
+ AgentId::ClaudeCode,
+ &fixture("claude/projects/-Users-tester-Github-wakefx/11111111-aaaa-bbbb-cccc-000000000001.jsonl"),
+ "11111111-aaaa-bbbb-cccc-000000000001",
+ )
+}
+fn codex_ref() -> SessionFileRef {
+ fs_ref(
+ AgentId::Codex,
+ &fixture("codex/sessions/2026/08/02/rollout-2026-08-02T09-15-00-22222222-aaaa-bbbb-cccc-000000000002.jsonl"),
+ "22222222-aaaa-bbbb-cccc-000000000002",
+ )
+}
+fn cursor_ref() -> SessionFileRef {
+ fs_ref(
+ AgentId::Cursor,
+ &fixture("cursor/projects/wakefx-cursor-proj/agent-transcripts/33333333-aaaa-bbbb-cccc-000000000003/33333333-aaaa-bbbb-cccc-000000000003.jsonl"),
+ "33333333-aaaa-bbbb-cccc-000000000003",
+ )
+}
+fn kiro_ref() -> SessionFileRef {
+ fs_ref(
+ AgentId::Kiro,
+ &fixture("kiro/sessions/cli/44444444-aaaa-bbbb-cccc-000000000004.jsonl"),
+ "44444444-aaaa-bbbb-cccc-000000000004",
+ )
+}
+fn gemini_ref() -> SessionFileRef {
+ fs_ref(
+ AgentId::Gemini,
+ &fixture("gemini/tmp/wakefx-gem/chats/session-2026-08-04T12-00-00.jsonl"),
+ "session-2026-08-04T12-00-00",
+ )
+}
+
+// ---------------------------------------------------------------- 每家解析
+
+#[test]
+fn claude_parse_contract() {
+ setup();
+ let adapter = ClaudeAdapter::new();
+ let r = claude_ref();
+ let s = adapter.parse_session(&r).expect("claude parse_session");
+ let t = adapter.parse_transcript(&r).expect("claude parse_transcript");
+
+ // 标题=最后一条 custom-title,压过首条用户消息推导
+ assert_eq!(s.meta.title, "QR login revamp");
+ assert_eq!(s.meta.project_path, "/Users/tester/Github/wakefx");
+ assert_eq!(s.meta.project_name, "wakefx");
+ assert_eq!(s.meta.git_branch.as_deref(), Some("main"));
+ assert_eq!(s.meta.model.as_deref(), Some("claude-opus-4-1"));
+ assert_eq!(s.meta.tokens_used, Some(160));
+ assert_eq!(s.meta.message_count, 3);
+ assert_eq!(s.meta.created_at, ms("2026-08-01T09:59:00Z"));
+ assert_eq!(s.meta.updated_at, ms("2026-08-01T10:02:00Z"));
+ // "wibble-experimental" 计 unknown;"summary" 在已知跳过表内不计
+ assert_eq!(s.unknown_line_count, 1);
+
+ assert_eq!(
+ roles_kinds(&t.mainline),
+ vec![
+ (Role::User, MessageKind::Meta), // isMeta caveat
+ (Role::User, MessageKind::Text), // 真实提问
+ (Role::Assistant, MessageKind::Text), // msg_01 两行合并
+ (Role::Assistant, MessageKind::Text), // msg_02
+ (Role::System, MessageKind::CompactSummary), // compact_boundary
+ ]
+ );
+ assert_eq!(t.mainline[1].timestamp, Some(ms("2026-08-01T10:00:00Z")));
+
+ // 同 message.id 的逐块行合并成一条:text + thinking + tool_use 同在 seq 2
+ let a = &t.mainline[2];
+ assert_eq!(a.text, "好的,我先查看现有代码。");
+ assert!(a.thinking.as_deref().unwrap_or_default().contains("二维码"));
+ assert_eq!(a.tool_calls.len(), 1);
+ assert_eq!(a.tool_calls[0].name, "Read");
+ // tool_result 在后续 user 行,应回填到 tool_use
+ assert!(a.tool_calls[0].output.as_deref().unwrap_or_default().contains("useEffect"));
+ assert!(!a.tool_calls[0].is_error);
+
+ // units 只含 Text 消息,tool 名与 input 摘要并入正文
+ assert_eq!(s.units.iter().map(|u| u.seq).collect::<Vec<_>>(), vec![1, 2, 3]);
+ assert!(s.units[1].text.contains("Login.tsx"));
+
+ // 无真实用户消息的变体 → UNTITLED
+ let untitled = fs_ref(
+ AgentId::ClaudeCode,
+ &fixture("claude/projects/-Users-tester-Github-wakefx/aaaaaaaa-0000-4000-8000-00000000000a.jsonl"),
+ "aaaaaaaa-0000-4000-8000-00000000000a",
+ );
+ let s2 = adapter.parse_session(&untitled).expect("claude untitled parse");
+ assert_eq!(s2.meta.title, UNTITLED);
+ assert_eq!(s2.meta.message_count, 1);
+}
+
+#[test]
+fn codex_parse_contract() {
+ setup();
+ let adapter = CodexAdapter::new();
+ // file_ref 是公开 API:rollout-<ts>-<uuid>.jsonl 应剥出 uuid 作 native_id
+ let path = fixture("codex/sessions/2026/08/02/rollout-2026-08-02T09-15-00-22222222-aaaa-bbbb-cccc-000000000002.jsonl");
+ let r = adapter.file_ref(&path).expect("codex file_ref");
+ assert_eq!(r.native_id, "22222222-aaaa-bbbb-cccc-000000000002");
+
+ let s = adapter.parse_session(&r).expect("codex parse_session");
+ let t = adapter.parse_transcript(&r).expect("codex parse_transcript");
+
+ // 标题取首条真实用户消息(environment_context 注入行归 Meta 被跳过)
+ assert_eq!(s.meta.title, "扫码登录报错,帮我查一下 useEffect() 依赖数组");
+ assert_eq!(s.meta.key, "codex:22222222-aaaa-bbbb-cccc-000000000002");
+ assert_eq!(s.meta.project_path, "/Users/tester/Github/wakefx");
+ assert_eq!(s.meta.source.as_deref(), Some("CLI")); // originator codex_cli_rs
+ assert_eq!(s.meta.model.as_deref(), Some("gpt-5.2-codex"));
+ assert_eq!(s.meta.git_branch.as_deref(), Some("feat/qr"));
+ assert_eq!(s.meta.tokens_used, Some(4321));
+ assert_eq!(s.meta.message_count, 3);
+ assert!(!s.meta.archived);
+ assert_eq!(s.meta.created_at, ms("2026-08-02T09:15:00Z"));
+ assert_eq!(s.meta.updated_at, ms("2026-08-02T09:15:21Z"));
+ assert_eq!(s.unknown_line_count, 1);
+
+ assert_eq!(
+ roles_kinds(&t.mainline),
+ vec![
+ (Role::User, MessageKind::Meta), // <environment_context> 注入
+ (Role::User, MessageKind::Text),
+ (Role::Assistant, MessageKind::Text), // reasoning 宿主 + tool call
+ (Role::Assistant, MessageKind::Text),
+ (Role::System, MessageKind::CompactSummary),
+ ]
+ );
+
+ // reasoning 只留明文 summary,encrypted_content 必须丢弃
+ let host = &t.mainline[2];
+ let thinking = host.thinking.as_deref().expect("reasoning summary");
+ assert!(thinking.contains("先全局搜 useEffect"));
+ assert!(!thinking.contains("OPAQUE-CIPHERTEXT"));
+ assert_eq!(host.tool_calls.len(), 1);
+ assert_eq!(host.tool_calls[0].name, "shell");
+ assert!(host.tool_calls[0].output.as_deref().unwrap_or_default().contains("QrScanner"));
+
+ // 空文本的 reasoning 宿主凭 tool call 进入 units
+ assert_eq!(s.units.iter().map(|u| u.seq).collect::<Vec<_>>(), vec![1, 2, 3]);
+}
+
+#[test]
+fn copilot_parse_contract() {
+ let env = setup();
+ let adapter = CopilotAdapter::new();
+ let r = db_ref(AgentId::Copilot, &env.copilot_db, "cop-0001");
+ let s = adapter.parse_session(&r).expect("copilot parse_session");
+ let t = adapter.parse_transcript(&r).expect("copilot parse_transcript");
+
+ assert_eq!(s.meta.title, "Copilot QR fix"); // summary 优先
+ assert_eq!(s.meta.git_branch.as_deref(), Some("main"));
+ assert_eq!(s.meta.project_name, "wakefx");
+ assert_eq!(s.meta.created_at, ms("2026-08-05T09:00:00Z"));
+ assert_eq!(s.meta.updated_at, ms("2026-08-05T09:30:00Z"));
+ assert_eq!(s.meta.message_count, 3);
+ assert!(s.meta.file_path.ends_with("#cop-0001")); // 虚拟路径原样保留
+ assert_eq!(s.unknown_line_count, 0);
+
+ // turn = user+assistant 两条;第二轮 assistant 为 NULL 只出 user
+ assert_eq!(
+ roles_kinds(&t.mainline),
+ vec![
+ (Role::User, MessageKind::Text),
+ (Role::Assistant, MessageKind::Text),
+ (Role::User, MessageKind::Text),
+ ]
+ );
+ assert_eq!(t.mainline[0].timestamp, Some(ms("2026-08-05T09:05:00Z")));
+ assert_eq!(s.units.iter().map(|u| u.seq).collect::<Vec<_>>(), vec![0, 1, 2]);
+
+ // summary 为空的会话回退首条用户消息作标题
+ let r2 = db_ref(AgentId::Copilot, &env.copilot_db, "cop-0002");
+ let s2 = adapter.parse_session(&r2).expect("copilot fallback parse");
+ assert_eq!(s2.meta.title, "空 summary 会话的兜底标题应取这句");
+ assert_eq!(s2.meta.git_branch, None);
+}
+
+#[test]
+fn cursor_parse_contract() {
+ setup();
+ let adapter = CursorAdapter::new();
+ let r = cursor_ref();
+ let s = adapter.parse_session(&r).expect("cursor parse_session");
+ let t = adapter.parse_transcript(&r).expect("cursor parse_transcript");
+
+ // 标题取 <user_query> 壳内正文;无壳的注入行(<workspace>)归 Meta 被跳过
+ assert_eq!(s.meta.title, "把二维码扫描组件抽出来,注意 useEffect() 的清理");
+ // slug 目录 "wakefx-cursor-proj" 磁盘上无对应真实路径 → 直译回退
+ assert_eq!(s.meta.project_path, "/wakefx/cursor/proj");
+ assert_eq!(s.meta.project_name, "proj");
+ assert_eq!(s.meta.created_at, ms("2026-08-01T09:30:00+08:00"));
+ assert_eq!(s.meta.updated_at, ms("2026-08-01T09:40:00+08:00"));
+ assert_eq!(s.meta.message_count, 3);
+ assert_eq!(s.unknown_line_count, 1); // session_started;turn_ended 不计
+
+ assert_eq!(
+ roles_kinds(&t.mainline),
+ vec![
+ (Role::User, MessageKind::Meta), // <workspace> 注入
+ (Role::User, MessageKind::Text),
+ (Role::Assistant, MessageKind::Text), // 连续 assistant 行合并
+ (Role::User, MessageKind::Text),
+ ]
+ );
+ assert_eq!(t.mainline[1].timestamp, Some(ms("2026-08-01T09:30:00+08:00")));
+ let a = &t.mainline[2];
+ assert_eq!(a.tool_calls.len(), 1);
+ assert_eq!(a.tool_calls[0].name, "read_file");
+ assert_eq!(a.tool_calls[0].output, None); // transcript 不落盘工具结果
+ assert_eq!(s.units.iter().map(|u| u.seq).collect::<Vec<_>>(), vec![1, 2, 3]);
+}
+
+#[test]
+fn opencode_parse_contract() {
+ let env = setup();
+ let adapter = OpencodeAdapter::new();
+ let r = db_ref(AgentId::Opencode, &env.opencode_db, "oc-0001");
+ let s = adapter.parse_session(&r).expect("opencode parse_session");
+ let t = adapter.parse_transcript(&r).expect("opencode parse_transcript");
+
+ assert_eq!(s.meta.title, "OpenCode 二维码排查"); // session 表自带标题
+ assert_eq!(s.meta.project_name, "wakefx");
+ assert_eq!(s.meta.model.as_deref(), Some("claude-sonnet-4-5")); // model json 的 id
+ assert_eq!(s.meta.tokens_used, Some(175)); // input+output+reasoning
+ assert!(!s.meta.archived); // time_archived NULL
+ assert_eq!(s.meta.created_at, 1786000000000);
+ assert_eq!(s.meta.updated_at, 1786000600000);
+ assert_eq!(s.meta.message_count, 2);
+ assert_eq!(s.unknown_line_count, 1); // wibble-part
+
+ assert_eq!(
+ roles_kinds(&t.mainline),
+ vec![
+ (Role::User, MessageKind::Meta), // 只有 synthetic part
+ (Role::User, MessageKind::Text),
+ (Role::Assistant, MessageKind::Text),
+ ]
+ );
+ let a = &t.mainline[2];
+ assert!(a.thinking.as_deref().unwrap_or_default().contains("先查 effect 依赖"));
+ assert_eq!(a.tool_calls.len(), 1);
+ assert_eq!(a.tool_calls[0].name, "grep");
+ assert!(a.tool_calls[0].output.as_deref().unwrap_or_default().contains("QrScanner"));
+ assert!(!a.tool_calls[0].is_error);
+ assert_eq!(s.units.iter().map(|u| u.seq).collect::<Vec<_>>(), vec![1, 2]);
+}
+
+#[test]
+fn kiro_parse_contract() {
+ setup();
+ let adapter = KiroAdapter::new();
+ let r = kiro_ref();
+ let s = adapter.parse_session(&r).expect("kiro parse_session");
+ let t = adapter.parse_transcript(&r).expect("kiro parse_transcript");
+
+ // .json 边车给标题与 cwd
+ assert_eq!(s.meta.title, "Kiro QR session");
+ assert_eq!(s.meta.project_path, "/Users/tester/Github/wakefx");
+ assert_eq!(s.meta.created_at, ms("2026-08-03T08:00:00Z"));
+ assert_eq!(s.meta.updated_at, ms("2026-08-03T08:30:00Z")); // 边车晚于消息时间
+ assert_eq!(s.meta.message_count, 2);
+ assert_eq!(s.unknown_line_count, 1); // ToolLog
+
+ assert_eq!(
+ roles_kinds(&t.mainline),
+ vec![(Role::User, MessageKind::Text), (Role::Assistant, MessageKind::Text)]
+ );
+ // jsonl 的 timestamp 是 unix 秒,应换算成 ms
+ assert_eq!(t.mainline[0].timestamp, Some(1785744300000));
+ assert_eq!(t.mainline[1].timestamp, Some(1785744360000));
+ assert_eq!(s.units.iter().map(|u| u.seq).collect::<Vec<_>>(), vec![0, 1]);
+}
+
+#[test]
+fn gemini_parse_contract() {
+ setup();
+ let adapter = GeminiAdapter::new();
+ let r = gemini_ref();
+ let s = adapter.parse_session(&r).expect("gemini parse_session");
+ let t = adapter.parse_transcript(&r).expect("gemini parse_transcript");
+
+ // $set 是覆盖式快照:只认最后一条,旧快照文本不得出现
+ assert_eq!(t.mainline.len(), 2);
+ assert!(t.mainline.iter().all(|m| !m.text.contains("旧快照")));
+ assert_eq!(
+ roles_kinds(&t.mainline),
+ vec![(Role::User, MessageKind::Text), (Role::Assistant, MessageKind::Text)]
+ );
+
+ // id 取 header 的 sessionId(非文件名 stem)
+ assert_eq!(s.meta.id, "55555555-aaaa-bbbb-cccc-000000000005");
+ assert_eq!(s.meta.key, "gemini:55555555-aaaa-bbbb-cccc-000000000005");
+ assert_eq!(s.meta.title, "Gemini 帮我调试二维码解码,顺带看 useEffect()");
+ // cwd 经假 HOME 的 projects.json 路径→slug 反查
+ assert_eq!(s.meta.project_path, "/Users/tester/Github/wakefx");
+ assert_eq!(s.meta.created_at, ms("2026-08-04T12:00:00Z"));
+ assert_eq!(s.meta.updated_at, ms("2026-08-04T12:20:00Z"));
+ assert_eq!(s.meta.message_count, 2);
+ assert_eq!(s.unknown_line_count, 1);
+ assert_eq!(s.units.iter().map(|u| u.seq).collect::<Vec<_>>(), vec![0, 1]);
+}
+
+// ---------------------------------------------------------------- seq 契约
+
+/// 跨文件不变量 1:FTS 单元的 seq 必须能在详情页 mainline 中找到同号消息,
+/// 且 mainline seq 从 0 严格递增(搜索跳转按 seq 定位依赖此契约)。
+fn assert_seq_contract(adapter: &dyn AgentAdapter, r: &SessionFileRef) {
+ let tag = r.agent.as_str();
+ let s = adapter.parse_session(r).unwrap_or_else(|e| panic!("[{tag}] parse_session: {e}"));
+ let t = adapter.parse_transcript(r).unwrap_or_else(|e| panic!("[{tag}] parse_transcript: {e}"));
+
+ assert!(!t.mainline.is_empty(), "[{tag}] mainline 不应为空");
+ for (i, m) in t.mainline.iter().enumerate() {
+ assert_eq!(m.seq, i as i64, "[{tag}] mainline seq 必须从 0 严格递增");
+ }
+
+ assert!(!s.units.is_empty(), "[{tag}] fixture 应产出至少一个 FTS 单元");
+ let seqs: HashSet<i64> = t.mainline.iter().map(|m| m.seq).collect();
+ for u in &s.units {
+ assert!(seqs.contains(&u.seq), "[{tag}] unit seq {} 在 mainline 中不存在", u.seq);
+ let m = &t.mainline[u.seq as usize];
+ assert_eq!(m.role, u.role, "[{tag}] seq {} 两侧角色不一致", u.seq);
+ }
+
+ // 两条解析路径共用核心解析器,meta 关键字段必须一致
+ assert_eq!(s.meta.key, t.meta.key, "[{tag}] key 两侧不一致");
+ assert_eq!(s.meta.title, t.meta.title, "[{tag}] title 两侧不一致");
+ assert_eq!(s.meta.message_count, t.meta.message_count, "[{tag}] message_count 两侧不一致");
+}
+
+#[test]
+fn seq_contract_holds_for_all_seven_agents() {
+ let env = setup();
+ let checks: Vec<(Box<dyn AgentAdapter>, SessionFileRef)> = vec![
+ (Box::new(ClaudeAdapter::new()), claude_ref()),
+ (Box::new(CodexAdapter::new()), codex_ref()),
+ (Box::new(CopilotAdapter::new()), db_ref(AgentId::Copilot, &env.copilot_db, "cop-0001")),
+ (Box::new(CursorAdapter::new()), cursor_ref()),
+ (Box::new(OpencodeAdapter::new()), db_ref(AgentId::Opencode, &env.opencode_db, "oc-0001")),
+ (Box::new(KiroAdapter::new()), kiro_ref()),
+ (Box::new(GeminiAdapter::new()), gemini_ref()),
+ ];
+ for (adapter, r) in &checks {
+ assert_seq_contract(adapter.as_ref(), r);
+ }
+}
+
+// ---------------------------------------------------------------- quickMeta 合并
+
+fn mk_meta(agent: AgentId, key: &str, id: &str, title: &str, source: Option<&str>) -> SessionMeta {
+ SessionMeta {
+ key: key.to_string(),
+ id: id.to_string(),
+ agent,
+ title: title.to_string(),
+ project_path: "/Users/tester/Github/wakefx".to_string(),
+ project_name: "wakefx".to_string(),
+ file_path: "/dev/null".to_string(),
+ created_at: 1,
+ updated_at: 2,
+ message_count: 0,
+ size_bytes: 0,
+ git_branch: None,
+ model: None,
+ tokens_used: None,
+ archived: false,
+ source: source.map(String::from),
+ favorite: false,
+ pinned: false,
+ }
+}
+
+#[test]
+fn merge_quick_meta_default_vs_codex_override() {
+ setup();
+
+ // 默认实现(以 Claude 为代表):parsed 为准,quick 只补 source/model/tokens 缺口
+ let claude = ClaudeAdapter::new();
+ let parsed = mk_meta(AgentId::ClaudeCode, "claude-code:p", "p", "解析出来的标题", None);
+ let mut quick = mk_meta(AgentId::ClaudeCode, "claude-code:q", "q", "手动改名", Some("state"));
+ quick.model = Some("model-q".to_string());
+ quick.tokens_used = Some(7);
+ let merged = claude.merge_quick_meta(parsed, &quick);
+ assert_eq!(merged.title, "解析出来的标题"); // 标题不被 quick 覆盖
+ assert_eq!(merged.key, "claude-code:p"); // key/id 也不动
+ assert_eq!(merged.id, "p");
+ assert_eq!(merged.source.as_deref(), Some("state")); // None 才补
+ assert_eq!(merged.model.as_deref(), Some("model-q"));
+ assert_eq!(merged.tokens_used, Some(7));
+ // parsed 已有 source 时 quick 不覆盖
+ let parsed = mk_meta(AgentId::ClaudeCode, "claude-code:p", "p", "t", Some("CLI"));
+ let merged = claude.merge_quick_meta(parsed, &quick);
+ assert_eq!(merged.source.as_deref(), Some("CLI"));
+
+ // Codex 覆写:state DB 的 title 是用户手动命名,压过解析标题;key/id 以
+ // state 的线程 id 为准;source 相反(rollout originator 更精确,quick 只兜底)
+ let codex = CodexAdapter::new();
+ let parsed = mk_meta(AgentId::Codex, "codex:file-uuid", "file-uuid", "首条消息推导标题", Some("IDE extension"));
+ let mut quick = mk_meta(AgentId::Codex, "codex:thread-1", "thread-1", "用户手动命名", Some("vscode"));
+ quick.model = Some("gpt-5.2".to_string());
+ quick.tokens_used = Some(999);
+ let merged = codex.merge_quick_meta(parsed, &quick);
+ assert_eq!(merged.title, "用户手动命名");
+ assert_eq!(merged.key, "codex:thread-1");
+ assert_eq!(merged.id, "thread-1");
+ assert_eq!(merged.source.as_deref(), Some("IDE extension")); // parsed 优先
+ assert_eq!(merged.model.as_deref(), Some("gpt-5.2")); // None 才补
+ assert_eq!(merged.tokens_used, Some(999));
+
+ // UNTITLED 守卫:quick 的占位标题不得覆盖解析标题,但 key/id 仍取 state
+ let parsed = mk_meta(AgentId::Codex, "codex:file-uuid", "file-uuid", "首条消息推导标题", None);
+ let quick = mk_meta(AgentId::Codex, "codex:thread-1", "thread-1", UNTITLED, Some("vscode"));
+ let merged = codex.merge_quick_meta(parsed, &quick);
+ assert_eq!(merged.title, "首条消息推导标题");
+ assert_eq!(merged.id, "thread-1");
+ assert_eq!(merged.source.as_deref(), Some("vscode")); // parsed 无 source 时兜底
+
+ // 空标题同样不覆盖
+ let parsed = mk_meta(AgentId::Codex, "codex:file-uuid", "file-uuid", "首条消息推导标题", None);
+ let quick = mk_meta(AgentId::Codex, "codex:thread-1", "thread-1", "", None);
+ let merged = codex.merge_quick_meta(parsed, &quick);
+ assert_eq!(merged.title, "首条消息推导标题");
+}
diff --git a/crates/wake-core/tests/db_roundtrip.rs b/crates/wake-core/tests/db_roundtrip.rs
new file mode 100644
index 0000000..d4972b0
--- /dev/null
+++ b/crates/wake-core/tests/db_roundtrip.rs
@@ -0,0 +1,135 @@
+//! Store 写入/搜索/删除语义的往返测试(临时库,不碰真实索引)。
+//! 覆盖 CLAUDE.md 不变量 3:tombstone 防复活、user_data 独立表重建不丢。
+
+use wake_core::db::Store;
+use wake_core::models::*;
+
+fn temp_store() -> (tempfile::TempDir, Store) {
+ let dir = tempfile::tempdir().expect("tempdir");
+ let store = Store::open(&dir.path().join("test.db")).expect("open store");
+ (dir, store)
+}
+
+fn meta(key: &str, title: &str) -> SessionMeta {
+ SessionMeta {
+ key: key.to_string(),
+ id: key.split(':').nth(1).unwrap_or(key).to_string(),
+ agent: AgentId::ClaudeCode,
+ title: title.to_string(),
+ project_path: "/tmp/proj".into(),
+ project_name: "proj".into(),
+ file_path: format!("/tmp/fixtures/{key}.jsonl"),
+ created_at: 1_700_000_000_000,
+ updated_at: 1_700_000_100_000,
+ message_count: 2,
+ size_bytes: 128,
+ git_branch: None,
+ model: None,
+ tokens_used: None,
+ archived: false,
+ source: None,
+ favorite: false,
+ pinned: false,
+ }
+}
+
+fn unit(seq: i64, role: Role, text: &str) -> IndexUnit {
+ IndexUnit {
+ seq,
+ sidechain_id: None,
+ role,
+ timestamp: Some(1_700_000_000_000 + seq),
+ text: text.to_string(),
+ }
+}
+
+#[test]
+fn search_roundtrip_hits_correct_seq() {
+ let (_dir, store) = temp_store();
+ let m = meta("claude-code:s1", "测试会话");
+ let units = vec![
+ unit(0, Role::User, "请帮我实现二维码扫描"),
+ unit(3, Role::Assistant, "好的,用 useEffect( 挂载扫描器"),
+ ];
+ store.write_session(&m, m.updated_at, &units).unwrap();
+
+ // 中文 trigram
+ let (hits, degraded) = store.search("二维码", &[], None, 10).unwrap();
+ assert!(!degraded, "3 码点应走 FTS 不降级");
+ assert_eq!(hits.len(), 1);
+ assert_eq!(hits[0].session.key, "claude-code:s1");
+ assert_eq!(hits[0].seq, 0, "命中 seq 必须等于写入时的消息 seq");
+
+ // 代码子串
+ let (hits, _) = store.search("useEffect(", &[], None, 10).unwrap();
+ assert_eq!(hits.len(), 1);
+ assert_eq!(hits[0].seq, 3);
+
+ // <3 码点降级 LIKE
+ let (hits, degraded) = store.search("好的", &[], None, 10).unwrap();
+ assert!(degraded, "2 码点应降级");
+ assert_eq!(hits.len(), 1);
+}
+
+#[test]
+fn tombstone_primitives() {
+ let (_dir, store) = temp_store();
+ let m = meta("codex:s2", "会被删除的会话");
+ store.write_session(&m, m.updated_at, &[]).unwrap();
+ assert!(store.get_session("codex:s2").unwrap().is_some());
+
+ // remove_session(tombstone=true) 后按 file_path 记墓碑。
+ // 注意分层:write_meta_only 是纯写入原语、不查墓碑——防复活由
+ // scanner 两条路径先过 is_tombstoned 保证(端到端见 scanner_finale.rs)
+ store.remove_session("codex:s2", true).unwrap();
+ assert!(store.get_session("codex:s2").unwrap().is_none());
+ assert!(store.is_tombstoned(&m.file_path));
+ assert!(!store.is_tombstoned("/tmp/other.jsonl"));
+}
+
+#[test]
+fn user_data_survives_rebuild() {
+ let (_dir, store) = temp_store();
+ let m = meta("claude-code:s3", "收藏的会话");
+ store.write_session(&m, m.updated_at, &[]).unwrap();
+ store.set_user_data("claude-code:s3", Some(true), Some(true)).unwrap();
+
+ // 重建索引(sessions/messages 清空重来)后,收藏/置顶必须还在
+ store.rebuild_all().unwrap();
+ store.write_session(&m, m.updated_at, &[]).unwrap();
+ let got = store.get_session("claude-code:s3").unwrap().unwrap();
+ assert!(got.favorite, "重建后收藏丢失 = user_data 未独立");
+ assert!(got.pinned, "重建后置顶丢失 = user_data 未独立");
+}
+
+#[test]
+fn list_sessions_filters_and_counts() {
+ let (_dir, store) = temp_store();
+ let mut a = meta("claude-code:s4", "A 会话");
+ let mut b = meta("codex:s5", "B 会话");
+ b.agent = AgentId::Codex;
+ a.updated_at = 2_000;
+ b.updated_at = 1_000;
+ store.write_session(&a, a.updated_at, &[]).unwrap();
+ store.write_session(&b, b.updated_at, &[]).unwrap();
+
+ let all = SessionFilter {
+ agents: vec![],
+ project_path: None,
+ favorite_only: false,
+ include_archived: false,
+ title_query: None,
+ sort: SortKey::Updated,
+ ascending: false,
+ limit: 10,
+ offset: 0,
+ };
+ let (sessions, total) = store.list_sessions(&all).unwrap();
+ assert_eq!(total, 2);
+ assert_eq!(sessions[0].key, "claude-code:s4", "默认按 updated 降序");
+
+ let only_codex = SessionFilter { agents: vec![AgentId::Codex], ..all };
+ let (sessions, total) = store.list_sessions(&only_codex).unwrap();
+ assert_eq!(total, 1);
+ assert_eq!(sessions[0].key, "codex:s5");
+}
diff --git a/crates/wake-core/tests/fixtures/claude/projects/-Users-tester-Github-wakefx/11111111-aaaa-bbbb-cccc-000000000001.jsonl b/crates/wake-core/tests/fixtures/claude/projects/-Users-tester-Github-wakefx/11111111-aaaa-bbbb-cccc-000000000001.jsonl
new file mode 100644
index 0000000..99d2c75
--- /dev/null
+++ b/crates/wake-core/tests/fixtures/claude/projects/-Users-tester-Github-wakefx/11111111-aaaa-bbbb-cccc-000000000001.jsonl
@@ -0,0 +1,10 @@
+{"type":"summary","summary":"Synthetic auto summary","leafUuid":"leaf-0001"}
+{"parentUuid":null,"isSidechain":false,"userType":"external","cwd":"/Users/tester/Github/wakefx","sessionId":"11111111-aaaa-bbbb-cccc-000000000001","version":"9.9.9","type":"user","isMeta":true,"message":{"role":"user","content":"Caveat: The messages below were generated by the user while running local commands. DO NOT respond to these messages."},"uuid":"u-0001","timestamp":"2026-08-01T09:59:00.000Z"}
+{"parentUuid":"u-0001","isSidechain":false,"userType":"external","cwd":"/Users/tester/Github/wakefx","gitBranch":"main","sessionId":"11111111-aaaa-bbbb-cccc-000000000001","type":"user","message":{"role":"user","content":"帮我实现二维码扫描登录,并解释 useEffect() 的清理逻辑"},"uuid":"u-0002","timestamp":"2026-08-01T10:00:00.000Z"}
+{"parentUuid":"u-0002","isSidechain":false,"cwd":"/Users/tester/Github/wakefx","gitBranch":"main","sessionId":"11111111-aaaa-bbbb-cccc-000000000001","type":"assistant","message":{"id":"msg_01","type":"message","role":"assistant","model":"claude-opus-4-1","content":[{"type":"thinking","thinking":"用户想要二维码扫描登录,先读现有登录组件再动手。"},{"type":"text","text":"好的,我先查看现有代码。"}],"usage":{"input_tokens":100,"output_tokens":50,"cache_creation_input_tokens":10}},"uuid":"a-0001","timestamp":"2026-08-01T10:00:05.000Z"}
+{"parentUuid":"a-0001","isSidechain":false,"cwd":"/Users/tester/Github/wakefx","sessionId":"11111111-aaaa-bbbb-cccc-000000000001","type":"assistant","message":{"id":"msg_01","type":"message","role":"assistant","model":"claude-opus-4-1","content":[{"type":"tool_use","id":"toolu_01","name":"Read","input":{"file_path":"/Users/tester/Github/wakefx/src/Login.tsx"}}]},"uuid":"a-0002","timestamp":"2026-08-01T10:00:06.000Z"}
+{"parentUuid":"a-0002","isSidechain":false,"cwd":"/Users/tester/Github/wakefx","sessionId":"11111111-aaaa-bbbb-cccc-000000000001","type":"user","message":{"role":"user","content":[{"type":"tool_result","tool_use_id":"toolu_01","content":[{"type":"text","text":"export function Login() {\n useEffect(() => () => scanner.stop());\n}"}]}]},"uuid":"u-0003","timestamp":"2026-08-01T10:00:07.000Z"}
+{"parentUuid":"u-0003","isSidechain":false,"cwd":"/Users/tester/Github/wakefx","sessionId":"11111111-aaaa-bbbb-cccc-000000000001","type":"assistant","message":{"id":"msg_02","type":"message","role":"assistant","model":"claude-opus-4-1","content":[{"type":"text","text":"已完成:登录页现在支持二维码扫描,useEffect() 里做了清理。"}]},"uuid":"a-0003","timestamp":"2026-08-01T10:01:00.000Z"}
+{"type":"system","subtype":"compact_boundary","content":"Conversation compacted","isMeta":false,"cwd":"/Users/tester/Github/wakefx","sessionId":"11111111-aaaa-bbbb-cccc-000000000001","uuid":"s-0001","timestamp":"2026-08-01T10:02:00.000Z"}
+{"type":"custom-title","customTitle":"QR login revamp","sessionId":"11111111-aaaa-bbbb-cccc-000000000001"}
+{"type":"wibble-experimental","payload":{"note":"unknown line type, must be counted"}}
diff --git a/crates/wake-core/tests/fixtures/claude/projects/-Users-tester-Github-wakefx/aaaaaaaa-0000-4000-8000-00000000000a.jsonl b/crates/wake-core/tests/fixtures/claude/projects/-Users-tester-Github-wakefx/aaaaaaaa-0000-4000-8000-00000000000a.jsonl
new file mode 100644
index 0000000..adf04c9
--- /dev/null
+++ b/crates/wake-core/tests/fixtures/claude/projects/-Users-tester-Github-wakefx/aaaaaaaa-0000-4000-8000-00000000000a.jsonl
@@ -0,0 +1,2 @@
+{"parentUuid":null,"isSidechain":false,"userType":"external","cwd":"/Users/tester/Github/wakefx","sessionId":"aaaaaaaa-0000-4000-8000-00000000000a","type":"user","isMeta":true,"message":{"role":"user","content":"Caveat: The messages below were generated by the user while running local commands. DO NOT respond to these messages."},"uuid":"u-1001","timestamp":"2026-08-01T11:00:00.000Z"}
+{"parentUuid":"u-1001","isSidechain":false,"cwd":"/Users/tester/Github/wakefx","sessionId":"aaaaaaaa-0000-4000-8000-00000000000a","type":"assistant","message":{"id":"msg_10","type":"message","role":"assistant","model":"claude-opus-4-1","content":[{"type":"text","text":"Synthetic assistant reply with no real user prompt."}]},"uuid":"a-1001","timestamp":"2026-08-01T11:00:05.000Z"}
diff --git a/crates/wake-core/tests/fixtures/codex/sessions/2026/08/02/rollout-2026-08-02T09-15-00-22222222-aaaa-bbbb-cccc-000000000002.jsonl b/crates/wake-core/tests/fixtures/codex/sessions/2026/08/02/rollout-2026-08-02T09-15-00-22222222-aaaa-bbbb-cccc-000000000002.jsonl
new file mode 100644
index 0000000..a88a58a
--- /dev/null
+++ b/crates/wake-core/tests/fixtures/codex/sessions/2026/08/02/rollout-2026-08-02T09-15-00-22222222-aaaa-bbbb-cccc-000000000002.jsonl
@@ -0,0 +1,11 @@
+{"timestamp":"2026-08-02T09:15:00.000Z","type":"session_meta","payload":{"id":"22222222-aaaa-bbbb-cccc-000000000002","timestamp":"2026-08-02T09:15:00.000Z","cwd":"/Users/tester/Github/wakefx","originator":"codex_cli_rs","cli_version":"0.0.1","source":"cli","git":{"commit_hash":"deadbeefdeadbeef","branch":"feat/qr","repository_url":"https://example.invalid/wakefx.git"}}}
+{"timestamp":"2026-08-02T09:15:01.000Z","type":"turn_context","payload":{"cwd":"/Users/tester/Github/wakefx","approval_policy":"on-request","sandbox_policy":{"mode":"workspace-write"},"model":"gpt-5.2-codex","summary":"auto"}}
+{"timestamp":"2026-08-02T09:15:02.000Z","type":"response_item","payload":{"type":"message","role":"user","content":[{"type":"input_text","text":"<environment_context>\n <cwd>/Users/tester/Github/wakefx</cwd>\n <shell>zsh</shell>\n</environment_context>"}]}}
+{"timestamp":"2026-08-02T09:15:03.000Z","type":"response_item","payload":{"type":"message","role":"user","content":[{"type":"input_text","text":"扫码登录报错,帮我查一下 useEffect() 依赖数组"}]}}
+{"timestamp":"2026-08-02T09:15:04.000Z","type":"response_item","payload":{"type":"reasoning","summary":[{"type":"summary_text","text":"先全局搜 useEffect,再核对依赖数组"}],"encrypted_content":"OPAQUE-CIPHERTEXT-MUST-NOT-SURFACE"}}
+{"timestamp":"2026-08-02T09:15:05.000Z","type":"response_item","payload":{"type":"function_call","name":"shell","arguments":"{\"command\":[\"rg\",\"useEffect\",\"src\"]}","call_id":"call_001"}}
+{"timestamp":"2026-08-02T09:15:06.000Z","type":"response_item","payload":{"type":"function_call_output","call_id":"call_001","output":"src/QrScanner.tsx:12: useEffect(() => scan(), [scanner])"}}
+{"timestamp":"2026-08-02T09:15:10.000Z","type":"response_item","payload":{"type":"message","role":"assistant","content":[{"type":"output_text","text":"依赖数组缺了 scanner 实例,我已经补上并验证扫码流程。"}]}}
+{"timestamp":"2026-08-02T09:15:11.000Z","type":"event_msg","payload":{"type":"token_count","info":{"total_token_usage":{"input_tokens":4000,"cached_input_tokens":0,"output_tokens":321,"reasoning_output_tokens":0,"total_tokens":4321}}}}
+{"timestamp":"2026-08-02T09:15:20.000Z","type":"compacted","payload":{"message":"synthetic compaction marker"}}
+{"timestamp":"2026-08-02T09:15:21.000Z","type":"mystery_row","payload":{"note":"unknown envelope type, must be counted"}}
diff --git a/crates/wake-core/tests/fixtures/cursor/projects/wakefx-cursor-proj/agent-transcripts/33333333-aaaa-bbbb-cccc-000000000003/33333333-aaaa-bbbb-cccc-000000000003.jsonl b/crates/wake-core/tests/fixtures/cursor/projects/wakefx-cursor-proj/agent-transcripts/33333333-aaaa-bbbb-cccc-000000000003/33333333-aaaa-bbbb-cccc-000000000003.jsonl
new file mode 100644
index 0000000..3e95c33
--- /dev/null
+++ b/crates/wake-core/tests/fixtures/cursor/projects/wakefx-cursor-proj/agent-transcripts/33333333-aaaa-bbbb-cccc-000000000003/33333333-aaaa-bbbb-cccc-000000000003.jsonl
@@ -0,0 +1,7 @@
+{"role":"user","message":{"content":[{"type":"text","text":"<workspace>open tabs: src/QrScanner.tsx</workspace>"}]}}
+{"role":"user","message":{"content":[{"type":"text","text":"<timestamp>Saturday, Aug 01, 2026, 9:30 AM (UTC+8)</timestamp>\n<user_query>把二维码扫描组件抽出来,注意 useEffect() 的清理</user_query>"}]}}
+{"role":"assistant","message":{"content":[{"type":"text","text":"先看现有组件结构,再抽公共 hook。"}]}}
+{"role":"assistant","message":{"content":[{"type":"tool_use","name":"read_file","input":{"path":"src/QrScanner.tsx"}}]}}
+{"type":"turn_ended"}
+{"role":"user","message":{"content":[{"type":"text","text":"<timestamp>Saturday, Aug 01, 2026, 9:40 AM (UTC+8)</timestamp>\n<user_query>好的,按这个方案继续</user_query>"}]}}
+{"type":"session_started","meta":{"note":"unknown line type, must be counted"}}
diff --git a/crates/wake-core/tests/fixtures/gemini/tmp/wakefx-gem/chats/session-2026-08-04T12-00-00.jsonl b/crates/wake-core/tests/fixtures/gemini/tmp/wakefx-gem/chats/session-2026-08-04T12-00-00.jsonl
new file mode 100644
index 0000000..bf36ea0
--- /dev/null
+++ b/crates/wake-core/tests/fixtures/gemini/tmp/wakefx-gem/chats/session-2026-08-04T12-00-00.jsonl
@@ -0,0 +1,4 @@
+{"sessionId":"55555555-aaaa-bbbb-cccc-000000000005","projectHash":"wakefx-gem","startTime":"2026-08-04T12:00:00.000Z","lastUpdated":"2026-08-04T12:20:00.000Z"}
+{"$set":{"sessionId":"55555555-aaaa-bbbb-cccc-000000000005","messages":[{"id":"m1","type":"user","content":[{"text":"旧快照文本,应被最后一条快照覆盖"}],"timestamp":"2026-08-04T12:01:00.000Z"}]}}
+{"$set":{"sessionId":"55555555-aaaa-bbbb-cccc-000000000005","messages":[{"id":"m1","type":"user","content":[{"text":"Gemini 帮我调试二维码解码,顺带看 useEffect()"}],"timestamp":"2026-08-04T12:01:00.000Z"},{"id":"m2","type":"gemini","content":[{"text":"可以,先在解码回调里打日志。"}],"timestamp":"2026-08-04T12:02:00.000Z"}]}}
+{"checkpoint":"noise-row, unknown line must be counted"}
diff --git a/crates/wake-core/tests/fixtures/kiro/sessions/cli/44444444-aaaa-bbbb-cccc-000000000004.json b/crates/wake-core/tests/fixtures/kiro/sessions/cli/44444444-aaaa-bbbb-cccc-000000000004.json
new file mode 100644
index 0000000..fa9c527
--- /dev/null
+++ b/crates/wake-core/tests/fixtures/kiro/sessions/cli/44444444-aaaa-bbbb-cccc-000000000004.json
@@ -0,0 +1,7 @@
+{
+ "session_id": "44444444-aaaa-bbbb-cccc-000000000004",
+ "cwd": "/Users/tester/Github/wakefx",
+ "title": "Kiro QR session",
+ "created_at": "2026-08-03T08:00:00Z",
+ "updated_at": "2026-08-03T08:30:00Z"
+}
diff --git a/crates/wake-core/tests/fixtures/kiro/sessions/cli/44444444-aaaa-bbbb-cccc-000000000004.jsonl b/crates/wake-core/tests/fixtures/kiro/sessions/cli/44444444-aaaa-bbbb-cccc-000000000004.jsonl
new file mode 100644
index 0000000..43c943a
--- /dev/null
+++ b/crates/wake-core/tests/fixtures/kiro/sessions/cli/44444444-aaaa-bbbb-cccc-000000000004.jsonl
@@ -0,0 +1,3 @@
+{"kind":"Prompt","data":{"content":[{"kind":"text","data":"用 Kiro 重构二维码扫描,注意 useEffect() 清理"}],"meta":{"timestamp":1785744300}}}
+{"kind":"AssistantMessage","data":{"content":[{"kind":"text","data":"已拆分扫描组件并补上清理逻辑。"}],"meta":{"timestamp":1785744360}}}
+{"kind":"ToolLog","data":{"note":"unknown kind, must be counted"}}
diff --git a/crates/wake-core/tests/scanner_finale.rs b/crates/wake-core/tests/scanner_finale.rs
new file mode 100644
index 0000000..9347a00
--- /dev/null
+++ b/crates/wake-core/tests/scanner_finale.rs
@@ -0,0 +1,169 @@
+//! 扫描终态契约(CLAUDE.md 不变量 6):run_scan 无论正常结束、Err 提前返回
+//! 还是 adapter 出错,都必须发出一次 scanning=false 的终态进度事件——
+//! UI 的模态刷新弹窗只认这个事件收场,收不到就永久锁死。
+
+use std::path::Path;
+use std::sync::{Arc, Mutex};
+
+use anyhow::{bail, Result};
+use wake_core::adapters::AgentAdapter;
+use wake_core::db::Store;
+use wake_core::models::*;
+use wake_core::scanner::{run_scan, ScanEvents, ScanProgress};
+
+/// 收集全部进度事件,供断言终态
+struct Recorder(Mutex<Vec<ScanProgress>>);
+
+impl ScanEvents for Recorder {
+ fn on_progress(&self, p: &ScanProgress) {
+ self.0.lock().unwrap().push(p.clone());
+ }
+ fn on_sessions_changed(&self) {}
+}
+
+/// 枚举文件即失败的 adapter,模拟数据源不可读
+struct FailingAdapter;
+
+impl AgentAdapter for FailingAdapter {
+ fn agent(&self) -> AgentId {
+ AgentId::ClaudeCode
+ }
+ fn detect(&self) -> bool {
+ true
+ }
+ fn list_session_files(&self) -> Result<Vec<SessionFileRef>> {
+ bail!("simulated data source failure")
+ }
+ fn parse_session(&self, _: &SessionFileRef) -> Result<ParsedSession> {
+ bail!("unreachable")
+ }
+ fn parse_transcript(&self, _: &SessionFileRef) -> Result<ParsedTranscript> {
+ bail!("unreachable")
+ }
+ fn watch_paths(&self) -> Vec<std::path::PathBuf> {
+ Vec::new()
+ }
+}
+
+fn assert_terminal_event(events: &[ScanProgress], ctx: &str) {
+ let last = events.last().unwrap_or_else(|| panic!("{ctx}: 无任何进度事件"));
+ assert!(
+ !last.scanning,
+ "{ctx}: 最后一个事件 scanning 仍为 true,UI 刷新弹窗将永久锁死"
+ );
+}
+
+fn temp_store(dir: &Path) -> Arc<Store> {
+ Arc::new(Store::open(&dir.join("scan.db")).expect("open store"))
+}
+
+#[test]
+fn finale_fires_on_empty_scan() {
+ let dir = tempfile::tempdir().unwrap();
+ let store = temp_store(dir.path());
+ let adapters: Vec<Box<dyn AgentAdapter>> = Vec::new();
+ let rec = Recorder(Mutex::new(Vec::new()));
+
+ let _ = run_scan(&adapters, &store, &rec, false);
+ assert_terminal_event(&rec.0.lock().unwrap(), "空 adapter 列表");
+}
+
+#[test]
+fn finale_fires_when_adapter_fails() {
+ let dir = tempfile::tempdir().unwrap();
+ let store = temp_store(dir.path());
+ let adapters: Vec<Box<dyn AgentAdapter>> = vec![Box::new(FailingAdapter)];
+ let rec = Recorder(Mutex::new(Vec::new()));
+
+ // list_session_files 报错的路径:无论 run_scan 返回 Ok/Err,终态事件必须送达
+ let _ = run_scan(&adapters, &store, &rec, false);
+ assert_terminal_event(&rec.0.lock().unwrap(), "adapter 枚举失败");
+}
+
+/// 固定提供一个会话(含 quickMeta 快路径)的 adapter,
+/// 模拟 Codex state DB 中删除后仍残留的行
+struct SeedAdapter {
+ r: SessionFileRef,
+ meta: SessionMeta,
+}
+
+impl AgentAdapter for SeedAdapter {
+ fn agent(&self) -> AgentId {
+ AgentId::Codex
+ }
+ fn detect(&self) -> bool {
+ true
+ }
+ fn list_session_files(&self) -> Result<Vec<SessionFileRef>> {
+ Ok(vec![self.r.clone()])
+ }
+ fn quick_meta(
+ &self,
+ _refs: &[SessionFileRef],
+ ) -> Option<std::collections::HashMap<String, SessionMeta>> {
+ let mut m = std::collections::HashMap::new();
+ m.insert(self.r.file_path.clone(), self.meta.clone());
+ Some(m)
+ }
+ fn parse_session(&self, _: &SessionFileRef) -> Result<ParsedSession> {
+ Ok(ParsedSession {
+ meta: self.meta.clone(),
+ units: Vec::new(),
+ unknown_line_count: 0,
+ })
+ }
+ fn parse_transcript(&self, _: &SessionFileRef) -> Result<ParsedTranscript> {
+ bail!("transcript not needed in scan")
+ }
+ fn watch_paths(&self) -> Vec<std::path::PathBuf> {
+ Vec::new()
+ }
+}
+
+/// 不变量 3 端到端:删除(trash+tombstone)后,数据源仍枚举同一文件的
+/// 下一次全量扫描不得让会话复活
+#[test]
+fn tombstoned_session_does_not_resurrect_on_rescan() {
+ let dir = tempfile::tempdir().unwrap();
+ let store = temp_store(dir.path());
+ let meta = SessionMeta {
+ key: "codex:ghost".into(),
+ id: "ghost".into(),
+ agent: AgentId::Codex,
+ title: "残留会话".into(),
+ project_path: "/tmp/p".into(),
+ project_name: "p".into(),
+ file_path: "/tmp/fixtures/ghost.jsonl".into(),
+ created_at: 1,
+ updated_at: 2,
+ message_count: 0,
+ size_bytes: 1,
+ git_branch: None,
+ model: None,
+ tokens_used: None,
+ archived: false,
+ source: None,
+ favorite: false,
+ pinned: false,
+ };
+ let r = SessionFileRef {
+ agent: AgentId::Codex,
+ native_id: "ghost".into(),
+ file_path: meta.file_path.clone(),
+ mtime_ms: 2,
+ size: 1,
+ };
+ let adapters: Vec<Box<dyn AgentAdapter>> =
+ vec![Box::new(SeedAdapter { r, meta: meta.clone() })];
+ let rec = Recorder(Mutex::new(Vec::new()));
+
+ run_scan(&adapters, &store, &rec, true).unwrap();
+ assert!(store.get_session("codex:ghost").unwrap().is_some(), "首扫应写入");
+
+ store.remove_session("codex:ghost", true).unwrap();
+ run_scan(&adapters, &store, &rec, true).unwrap();
+ assert!(
+ store.get_session("codex:ghost").unwrap().is_none(),
+ "tombstoned 会话重扫后复活 = 不变量 3 破坏"
+ );
+}
diff --git a/scripts/hooks/pre-commit b/scripts/hooks/pre-commit
new file mode 100755
index 0000000..950488b
--- /dev/null
+++ b/scripts/hooks/pre-commit
@@ -0,0 +1,12 @@
+#!/bin/zsh
+# 提交前门槛:数据层测试 + 全仓编译检查。
+# 启用(一次):git config core.hooksPath scripts/hooks
+set -e
+
+echo "pre-commit: cargo test -p wake-core"
+cargo test -p wake-core --quiet
+
+echo "pre-commit: cargo check -p wake"
+cargo check -p wake --quiet
+
+echo "pre-commit: ok"