jarvy 0.2.0

Jarvy is a fast, cross-platform CLI that installs and manages developer tools across macOS and Linux.
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
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

//! Canonical hook event taxonomy.
//!
//! Jarvy normalizes hook events across agents into a single enum, then
//! delegates per-agent name mapping to the [`agents`](crate::ai_hooks::agents)
//! module. Not every agent supports every event — providers return
//! [`AiHookError::UnsupportedEvent`](crate::ai_hooks::error::AiHookError) when
//! an entry maps onto an event the target agent cannot fire.

use std::fmt;

use serde::{Deserialize, Serialize};

#[derive(Copy, Clone, Debug, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum HookEvent {
    /// Fires before a tool call executes. Most common interception point;
    /// used by all `block-*` library hooks.
    PreToolUse,
    /// Fires after a tool call returns. Useful for logging / redaction.
    PostToolUse,
    /// Fires when the user submits a prompt — agent-specific support varies.
    UserPromptSubmit,
    /// Fires at session start (banner, env setup).
    SessionStart,
    /// Fires when the agent stops.
    Stop,
    /// Fires before context compaction.
    PreCompact,
    /// Fires before a shell/bash command specifically. Cursor + Windsurf
    /// expose this as a distinct event; Claude Code/Codex fold it into
    /// `PreToolUse` filtered to the Bash tool.
    PreShellExecution,
}

impl HookEvent {
    /// Every variant in a stable order. Used by integration tests and
    /// reserved for future CLI surface (e.g. `--event` filters).
    #[allow(dead_code)]
    pub const ALL: &'static [HookEvent] = &[
        HookEvent::PreToolUse,
        HookEvent::PostToolUse,
        HookEvent::UserPromptSubmit,
        HookEvent::SessionStart,
        HookEvent::Stop,
        HookEvent::PreCompact,
        HookEvent::PreShellExecution,
    ];

    pub fn as_str(self) -> &'static str {
        match self {
            HookEvent::PreToolUse => "pre_tool_use",
            HookEvent::PostToolUse => "post_tool_use",
            HookEvent::UserPromptSubmit => "user_prompt_submit",
            HookEvent::SessionStart => "session_start",
            HookEvent::Stop => "stop",
            HookEvent::PreCompact => "pre_compact",
            HookEvent::PreShellExecution => "pre_shell_execution",
        }
    }
}

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

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn all_variants_have_unique_strings() {
        let mut seen = std::collections::HashSet::new();
        for event in HookEvent::ALL {
            assert!(seen.insert(event.as_str()), "duplicate str for {event:?}");
        }
    }

    #[test]
    fn round_trip_through_serde() {
        for event in HookEvent::ALL {
            let json = serde_json::to_string(event).unwrap();
            let parsed: HookEvent = serde_json::from_str(&json).unwrap();
            assert_eq!(*event, parsed);
        }
    }
}