Struct LiveSessionFile 

pub struct LiveSessionFile {
    pub version: u8,
    pub sessions: HashMap<SessionKey, HookSession>,
    pub updated_at: Option<DateTime<Utc>>,
}

Contents of ~/.ccboard/live-sessions.json

Fields

version: u8

Schema version — always 1 for now, used for future migrations

sessions: HashMap<SessionKey, HookSession>

Active sessions keyed by “{session_id}:{tty}”

updated_at: Option<DateTime<Utc>>

When this file was last written

Implementations

impl LiveSessionFile

pub fn default_path() -> Option<PathBuf>

Default path: ~/.ccboard/live-sessions.json

pub fn lock_path() -> Option<PathBuf>

Lock file path: ~/.ccboard/live-sessions.lock

pub fn load(path: &Path) -> Result<Self, HookStateError>

Load from disk. Returns Default if file does not exist; errors only on parse failure.

pub fn save(&self, path: &Path) -> Result<(), HookStateError>

Atomic write: write to .tmp, then rename (APFS/ext4-safe)

pub fn prune_stopped(&mut self, max_age: Duration)

Remove Stopped sessions older than max_age

pub fn prune_stale_running(&mut self, max_age: Duration)

Remove Running / WaitingInput sessions not updated within max_age.

Handles Claude processes that crashed or were killed without sending a Stop hook. Default recommended value: 10 minutes.

pub fn upsert( &mut self, key: SessionKey, session_id: String, cwd: String, tty: String, new_status: HookSessionStatus, event_name: String, )

Upsert a session: create if new, update status/timestamp if existing. Special rule: UserPromptSubmit on a Stopped session revives it to Running.

Trait Implementations

impl Clone for LiveSessionFile

fn clone(&self) -> LiveSessionFile

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LiveSessionFile

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LiveSessionFile

fn default() -> LiveSessionFile

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for LiveSessionFile

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LiveSessionFile

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.