linesmith-core 0.1.3

Internal core engine for linesmith. No SemVer guarantee for direct dependents — depend on the `linesmith` binary or accept breakage between minor versions.
Documentation 
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

//! [`DataDep`] enumerates the data sources a segment may declare via
//! [`Segment::data_deps`](crate::segments::Segment::data_deps).
//!
//! Canonical definition: `docs/specs/data-fetching.md` §Segment
//! dependency declaration.

/// Which data source on [`DataContext`](super::DataContext) a segment reads.
///
/// Segments return `&'static [DataDep]` from `data_deps()`. The runtime
/// unions the declared deps across all enabled segments and only
/// lazy-fetches sources that some segment needs.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
#[non_exhaustive]
pub enum DataDep {
    /// Parsed stdin payload. Always populated eagerly; listing is optional.
    Status,
    /// `~/.claude/settings.json` + overlays.
    Settings,
    /// `~/.claude.json` per-user state.
    ClaudeJson,
    /// JSONL transcripts under `~/.claude/projects/**`.
    Jsonl,
    /// OAuth `/api/oauth/usage` endpoint + cache.
    Usage,
    /// macOS Keychain / `.credentials.json` — not plugin-accessible
    /// (reserved in `plugin-api.md` §@data_deps header syntax).
    Credentials,
    /// `~/.claude/sessions/{pid}.json` live process directory.
    Sessions,
    /// Git repo state via `gix`.
    Git,
}

impl DataDep {
    /// The lowercase-token name used in the plugin-api `@data_deps`
    /// header (`plugin-api.md` §@data_deps header syntax) and in log /
    /// doctor output. Single source of truth for the wire name.
    #[must_use]
    pub fn as_str(&self) -> &'static str {
        match self {
            Self::Status => "status",
            Self::Settings => "settings",
            Self::ClaudeJson => "claude_json",
            Self::Jsonl => "jsonl",
            Self::Usage => "usage",
            Self::Credentials => "credentials",
            Self::Sessions => "sessions",
            Self::Git => "git",
        }
    }
}

impl std::fmt::Display for DataDep {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(self.as_str())
    }
}