csift 0.9.4

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

//! SubagentScope / Caller + the env-session resolver.

use super::*;

/// Whether a session-file resolution spans subagent transcripts.
///
/// Every span-aware subcommand (`search` / `agents` / `recover` / `turns` / `list` / `files` /
/// `image` / `plan`) needs only the two-state include/exclude decision, built from a
/// `--no-subagents` bool via `From<bool>`.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum SubagentScope {
    /// Top-level session jsonl(s) PLUS each one's subagent transcripts (the default).
    WithSubagents,
    /// Only the top-level `<uuid>.jsonl` session(s); no subagent transcripts.
    TopLevelOnly,
}

/// Which subcommand is resolving session files - threaded into [`resolve_session_files`] so a
/// future subcommand-aware remediation message can branch on the caller. Inert today (the body
/// does not read it), kept for that extension point.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Caller {
    /// `csift files`.
    Files,
    /// Any other span-aware subcommand (`search` / `agents` / `recover` / `turns` / `list` /
    /// `image` / `plan`).
    Other,
}

impl From<bool> for SubagentScope {
    /// `true` (subagents spanned) ⇒ `WithSubagents`; `false` (`--no-subagents`) ⇒
    /// `TopLevelOnly`.
    fn from(include_subagents: bool) -> Self {
        if include_subagents {
            SubagentScope::WithSubagents
        } else {
            SubagentScope::TopLevelOnly
        }
    }
}

/// Resolve the CALLING session id from the environment - the value of `CLAUDE_CODE_SESSION_ID`,
/// which CC sets to the process-global MAIN session id even inside a subagent (verified
/// empirically + against the cleanroom; an in-process subagent's OWN id is NOT exported to the
/// subprocess env). Used by `@main` and as the `@trap:` search root. There is no env-based
/// `@self` because CC withholds the per-subagent id from the Bash env - `@trap:<marker>`
/// recovers it from the transcript instead.
pub fn resolve_env_session() -> Result<String> {
    let read = |k: &str| std::env::var(k).ok().filter(|v| !v.trim().is_empty());
    read("CLAUDE_CODE_SESSION_ID")
        .or_else(|| read("CODEX_COMPANION_SESSION_ID"))
        .ok_or_else(|| {
            anyhow::anyhow!(
                "needs the calling session id, but CLAUDE_CODE_SESSION_ID is not set (running \
                 outside Claude Code, or an old build). Pass an explicit `@<uuid>` target instead."
            )
        })
}