sidekick 0.6.0

Protects your unsaved Neovim work from Claude Code.
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

//! Event schema for sidekick analytics.
//!
//! Events are append-only records of things that happened — every mutation hook
//! decision, every buffer refresh, every nvim launch. The schema is designed to
//! be stable: once written, a line should remain readable across future versions.

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum Event {
    HookDecision(HookDecision),
    BufferRefresh(BufferRefresh),
    NvimLaunch(NvimLaunch),
    /// Logged every time the user opens `sidekick stats`. Powers the
    /// meta-observations in the renderer (e.g. "fourth look today").
    StatsView(StatsView),
}

impl Event {
    pub fn timestamp(&self) -> DateTime<Utc> {
        match self {
            Event::HookDecision(e) => e.at,
            Event::BufferRefresh(e) => e.at,
            Event::NvimLaunch(e) => e.at,
            Event::StatsView(e) => e.at,
        }
    }
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum ToolKind {
    Edit,
    Write,
    MultiEdit,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum Decision {
    Allow,
    Deny,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum DecisionReason {
    /// No nvim sockets matched the cwd hash. Hook degrades to allow.
    NoNvimRunning,
    /// RPC to nvim failed. Hook degrades to allow rather than block the user.
    StatusCheckFailed,
    /// File is open as the current buffer and has unsaved changes. The save.
    BufferDirtyAndCurrent,
    /// File was checked against nvim but was not dirty-and-current. Allowed.
    BufferAvailable,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct HookDecision {
    pub at: DateTime<Utc>,
    pub session_id: String,
    pub cwd: String,
    pub tool: ToolKind,
    pub file: String,
    pub decision: Decision,
    pub reason: DecisionReason,
    pub instances_probed: usize,
    pub latency_ms: u64,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BufferRefresh {
    pub at: DateTime<Utc>,
    pub session_id: String,
    pub cwd: String,
    pub tool: ToolKind,
    pub file: String,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct NvimLaunch {
    pub at: DateTime<Utc>,
    pub pid: u32,
    pub cwd: String,
    pub socket_path: String,
    pub args: Vec<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct StatsView {
    pub at: DateTime<Utc>,
    pub range: String,
}