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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157

use anyhow::Result;
use clap::Parser;

/// HUD / statusline
#[derive(Parser, Debug, Clone)]
pub struct Args {
    /// Team name to monitor
    pub team_name: Option<String>,

    /// Show live TUI
    #[arg(long)]
    pub tui: bool,

    /// Start web dashboard
    #[arg(long)]
    pub web: bool,

    /// Port for web dashboard
    #[arg(long, default_value = "8080")]
    pub port: u16,

    /// Print single snapshot and exit
    #[arg(long)]
    pub once: bool,

    /// Output JSON instead of text
    #[arg(long)]
    pub json: bool,
}

pub(crate) async fn run(args: Args) -> Result<()> {
    if args.tui {
        if let Some(team_name) = args.team_name {
            let state_dir = crate::runtime::config::omk_state_dir()
                .join("team")
                .join(&team_name);

            if !state_dir.exists() {
                anyhow::bail!(
                    "Team '{}' not found. Expected state at: {}",
                    team_name,
                    state_dir.display()
                );
            }

            #[cfg(feature = "tui")]
            {
                let mut hud_tui = crate::vis::hud_tui::HudTui::new(&team_name, state_dir);
                hud_tui.run().await?;
            }
            #[cfg(not(feature = "tui"))]
            {
                anyhow::bail!("TUI requires --features tui");
            }
        } else {
            println!("omk hud <team_name> --tui");
            println!("  --tui requires a team name to monitor");
        }
    } else if args.web {
        #[cfg(feature = "server")]
        {
            crate::vis::server::run_server(args.port).await?;
        }
        #[cfg(not(feature = "server"))]
        {
            anyhow::bail!("Server feature is not enabled. Rebuild with --features server");
        }
    } else if let Some(team_name) = args.team_name {
        run_team_hud(team_name, args.once, args.json).await?;
    } else {
        println!("omk hud");
        println!("  <team_name>  Monitor a specific team");
        println!("  --tui        Run interactive TUI");
        println!("  --web        Start web dashboard");
        println!("  --port       Port for web dashboard (default: 8080)");
        println!("  --once       Print single snapshot and exit");
        println!("  --json       Output JSON instead of text");
    }
    Ok(())
}

async fn run_team_hud(team_name: String, once: bool, json: bool) -> Result<()> {
    let state_dir = crate::runtime::config::omk_state_dir()
        .join("team")
        .join(&team_name);

    if !state_dir.exists() {
        anyhow::bail!(
            "Team '{}' not found. Expected state at: {}",
            team_name,
            state_dir.display()
        );
    }

    let events_path = state_dir.join("events.jsonl");
    let mut event_stream = crate::vis::event_stream::EventStream::new(&events_path);
    let watchdog = crate::runtime::watchdog::Watchdog::with_defaults();

    let run_id = team_name.clone();
    let mut hud_state = crate::vis::hud::HudState::new(&team_name, &run_id);

    // Initial refresh
    hud_state
        .refresh(&mut event_stream, &watchdog, &state_dir)
        .await?;

    if once {
        if json {
            println!("{}", hud_state.render_json()?);
        } else {
            println!("{}", hud_state.render_text());
        }
        return Ok(());
    }

    // Loop with Ctrl+C handling
    let mut interval = tokio::time::interval(std::time::Duration::from_secs(2));

    loop {
        tokio::select! {
            _ = interval.tick() => {
                hud_state
                    .refresh(&mut event_stream, &watchdog, &state_dir)
                    .await?;

                // Clear screen and re-render
                print!("\x1B[2J\x1B[H"); // ANSI clear screen + home cursor
                if json {
                    println!("{}", hud_state.render_json()?);
                } else {
                    println!("{}", hud_state.render_text());
                }

                // Check if run is complete
                let is_complete = hud_state.events.iter().any(|e| {
                    matches!(
                        e.kind,
                        crate::runtime::events::EventKind::RunCompleted
                            | crate::runtime::events::EventKind::RunFailed
                            | crate::runtime::events::EventKind::ManualInterrupt
                    )
                });

                if is_complete {
                    println!("\nRun complete. Exiting.");
                    break;
                }
            }
            _ = tokio::signal::ctrl_c() => {
                println!("\nExiting HUD.");
                break;
            }
        }
    }

    Ok(())
}