csift 0.12.3

ripgrep for Claude Code session transcripts: fast regex list/search over ~/.claude/projects/**/*.jsonl
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

//! list background-handoff lineage: the parent-side `continued-in` line.

use crate::harness::*;

const ENC: &str = "-Users-dev-example-project";
const PARENT: &str = "11111111-2222-4333-8444-555555555555";
const CHILD: &str = "99999999-2222-4333-8444-555555555555";

/// The handoff line exactly as Claude Code appends it: four keys, no `uuid`.
fn handoff(parent: &str, child: &str) -> String {
    format!(
        r#"{{"type":"continued-in","timestamp":"2026-06-07T05:10:00.000Z","sessionId":"{parent}","continuedInSessionId":"{child}"}}"#
    )
}

fn turn(uuid: &str, ts: &str, text: &str) -> String {
    format!(
        r#"{{"type":"user","uuid":"{uuid}","timestamp":"{ts}","message":{{"role":"user","content":"{text}"}}}}"#
    )
}

fn session_row(out: &Output) -> serde_json::Value {
    out.stdout
        .lines()
        .filter_map(|l| serde_json::from_str(l).ok())
        .find(|v: &serde_json::Value| v["kind"] == "session")
        .expect("session row")
}

#[test]
fn list_names_the_child_a_background_handoff_continued_in() {
    let h = Home::new();
    h.write(
        &format!("{ENC}/{PARENT}.jsonl"),
        &format!(
            "{}\n{}\n",
            turn("u1", "2026-06-07T05:00:00.000Z", "do the thing"),
            handoff(PARENT, CHILD)
        ),
    );

    let out = h.run(&["list", &format!("@{PARENT}")]);
    assert!(out.success, "stderr: {}", out.stderr);
    assert!(
        out.stdout.contains(
            "handoff  continued in 99999999 (a background handoff: Claude Code names the \
             child itself, so this one is no inference)"
        ),
        "the row names the child by its first-8 token and says the fact is stated:\n{}",
        out.stdout
    );

    let row = session_row(&h.run(&["list", &format!("@{PARENT}"), "--format", "json"]));
    assert_eq!(row["continued_in"], CHILD, "{row}");
    // The handoff is NOT the clone or the clear lineage: those stay null here.
    assert!(row["minted_by"].is_null(), "{row}");
    assert!(row["cleared_from"].is_null(), "{row}");
    assert_eq!(row["is_clone"], false, "{row}");
}

#[test]
fn a_session_never_handed_over_reports_a_null_continued_in() {
    let h = Home::new();
    h.write(
        &format!("{ENC}/{PARENT}.jsonl"),
        &format!("{}\n", turn("u1", "2026-06-07T05:00:00.000Z", "hello")),
    );
    let out = h.run(&["list", &format!("@{PARENT}")]);
    assert!(
        !out.stdout.contains("handoff"),
        "no line, no row:\n{}",
        out.stdout
    );
    let row = session_row(&h.run(&["list", &format!("@{PARENT}"), "--format", "json"]));
    assert!(row["continued_in"].is_null(), "{row}");
}

#[test]
fn a_quoted_field_name_in_a_prompt_is_not_a_handoff() {
    // The field is a TOP-LEVEL key. A transcript that discusses the shape (this repo's own
    // dev sessions do) must not read as having been handed over.
    let h = Home::new();
    h.write(
        &format!("{ENC}/{PARENT}.jsonl"),
        &format!(
            "{}\n",
            turn(
                "u1",
                "2026-06-07T05:00:00.000Z",
                "the line carries \\\"continuedInSessionId\\\" and no uuid"
            )
        ),
    );
    let out = h.run(&["list", &format!("@{PARENT}")]);
    assert!(out.success, "stderr: {}", out.stderr);
    assert!(
        !out.stdout.contains("handoff"),
        "prose is not lineage:\n{}",
        out.stdout
    );
    let row = session_row(&h.run(&["list", &format!("@{PARENT}"), "--format", "json"]));
    assert!(row["continued_in"].is_null(), "{row}");
}

#[test]
fn stats_counts_the_handoff_line_type_whole_file() {
    // The documented escape from `list`'s window limit: `stats` validates every line, so
    // its type census reaches a handoff line wherever it sits.
    let h = Home::new();
    h.write(
        &format!("{ENC}/{PARENT}.jsonl"),
        &format!(
            "{}\n{}\n{}\n",
            turn("u1", "2026-06-07T05:00:00.000Z", "first"),
            handoff(PARENT, CHILD),
            turn(
                "u2",
                "2026-06-07T05:20:00.000Z",
                "resumed after the handoff"
            ),
        ),
    );
    let out = h.run(&["stats", &format!("@{PARENT}")]);
    assert!(out.success, "stderr: {}", out.stderr);
    assert!(
        out.stdout.contains("continued-in×1"),
        "the line type is a census key:\n{}",
        out.stdout
    );
}