omk 0.5.0

A Rust runtime for Kimi CLI. Turns prompts into proof-backed engineering runs with gates, worktrees, and replay.
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

/// Typed error for goal state loading failures.
///
/// Distinguishes missing files from corrupted or invalid-format state
/// so callers and tests can match on the root cause.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum GoalStateError {
    MissingFile { path: String },
    IoError { path: String, reason: String },
    InvalidFormat { path: String, reason: String },
}

impl std::fmt::Display for GoalStateError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Self::MissingFile { path } => write!(f, "Goal state file missing: {path}"),
            Self::IoError { path, reason } => {
                write!(f, "Goal state file unreadable at {path}: {reason}")
            }
            Self::InvalidFormat { path, reason } => {
                write!(f, "Goal state file has invalid format at {path}: {reason}")
            }
        }
    }
}

impl std::error::Error for GoalStateError {}

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

    #[test]
    fn goal_state_error_missing_file_display() {
        let err = GoalStateError::MissingFile {
            path: "/tmp/state.json".to_string(),
        };
        assert_eq!(err.to_string(), "Goal state file missing: /tmp/state.json");
    }

    #[test]
    fn goal_state_error_io_error_display() {
        let err = GoalStateError::IoError {
            path: "/tmp/state.json".to_string(),
            reason: "permission denied".to_string(),
        };
        assert_eq!(
            err.to_string(),
            "Goal state file unreadable at /tmp/state.json: permission denied"
        );
    }

    #[test]
    fn goal_state_error_invalid_format_display() {
        let err = GoalStateError::InvalidFormat {
            path: "/tmp/state.json".to_string(),
            reason: "bad json".to_string(),
        };
        assert_eq!(
            err.to_string(),
            "Goal state file has invalid format at /tmp/state.json: bad json"
        );
    }

    #[test]
    fn goal_state_error_implements_error() {
        let err: Box<dyn std::error::Error> = Box::new(GoalStateError::MissingFile {
            path: "p".to_string(),
        });
        assert!(err.to_string().contains("Goal state file missing"));
    }
}