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
158
159
160
161
162
163
164
165
166
167

/// A persisted goal record.
#[derive(Debug, Clone)]
pub struct GoalRecord {
    pub goal_id: String,
    pub status: String,
    pub phase: String,
    pub kind: Option<String>,
    pub original_goal: String,
    pub normalized_goal: String,
    pub goal_text: String,
    pub project_dir: String,
    pub state_dir: String,
    pub policy: String,
    pub delivery_policy: String,
    pub merge_policy: String,
    pub until_ready: bool,
    pub slice_execution: bool,
    pub max_agents: Option<i32>,
    pub budget_time: Option<String>,
    pub budget_tokens: Option<i64>,
    pub budget_usd: Option<i64>, // cents
    pub cost_tracker_path: Option<String>,
    pub terminal_criteria: Option<String>, // JSON
    pub failure: Option<String>,           // JSON
    pub created_at: i64,
    pub updated_at: i64,
    pub completed_at: Option<i64>,
    pub controller_pid: Option<i32>,
    pub version: i32,
}

/// A persisted task record.
#[derive(Debug, Clone)]
pub struct TaskRecord {
    pub task_id: String,
    pub goal_id: String,
    pub title: String,
    pub description: String,
    pub kind: String,
    pub status: String,
    pub owner: Option<String>,
    pub read_set: Option<String>,   // JSON array
    pub write_set: Option<String>,  // JSON array
    pub depends_on: Option<String>, // JSON array
    pub risk: String,
    pub acceptance: Option<String>, // JSON array
    pub evidence: Option<String>,   // JSON array
    pub retry_count: i32,
    pub max_retries: i32,
    pub lease_expires_at: Option<i64>,
    pub completed_at: Option<i64>,
    pub created_at: i64,
    pub updated_at: i64,
}

/// A persisted event record.
#[derive(Debug, Clone)]
pub struct EventRecord {
    pub event_id: i64,
    pub event_uuid: Option<String>,
    pub run_id: Option<String>,
    pub goal_id: String,
    pub schema_version: i32,
    pub kind: String,
    pub actor: Option<String>,
    pub payload: String, // JSON
    pub created_at: i64,
}

/// A persisted proof record.
#[derive(Debug, Clone)]
pub struct ProofRecord {
    pub goal_id: String,
    pub version: i32,
    pub status: String,
    pub readiness: String,
    pub summary: String,
    pub task_graph_summary: Option<String>, // JSON
    pub changed_files: Option<String>,      // JSON array
    pub commits: Option<String>,            // JSON array
    pub git: Option<String>,                // JSON
    pub gates: Option<String>,              // JSON array
    pub gates_passed: i32,
    pub gates_total: i32,
    pub post_mutation_gates_ran: bool,
    pub known_gaps: Option<String>,               // JSON array
    pub human_decisions_required: Option<String>, // JSON array
    pub recovery_status: Option<String>,
    pub delivery_metadata: Option<String>,    // JSON array
    pub review_artifacts: Option<String>,     // JSON array
    pub integration_evidence: Option<String>, // JSON
    pub oracle_evidence: Option<String>,      // JSON
    pub generated_at: i64,
}

/// A persisted decision record.
#[derive(Debug, Clone)]
pub struct DecisionRecord {
    pub decision_id: Option<i64>,
    pub goal_id: String,
    pub version: i32,
    pub actor: String,
    pub phase: String,
    pub kind: String,
    pub decision: String,
    pub rationale: String,
    pub constraints: Option<String>, // JSON array
    pub artifacts: Option<String>,   // JSON array
    pub created_at: i64,
}

/// A budget checkpoint.
#[derive(Debug, Clone)]
pub struct BudgetCheckpoint {
    pub checkpoint_id: Option<i64>,
    pub goal_id: String,
    pub version: i32,
    pub label: String,
    pub status: String,
    pub phase: String,
    pub recorded_at: i64,
    pub budget_time: Option<String>,
    pub total_budget_secs: Option<i64>,
    pub elapsed_since_created_secs: i64,
    pub remaining_budget_secs: Option<i64>,
    pub budget_tokens: Option<i64>,
    pub used_tokens: i64,
    pub remaining_budget_tokens: Option<i64>,
    pub budget_usd: Option<i64>,           // cents
    pub estimated_cost_usd: i64,           // cents
    pub remaining_budget_usd: Option<i64>, // cents
    pub limit_value: Option<i64>,
    pub used_value: Option<i64>,
    pub created_at: i64,
}

/// A registered artifact.
#[derive(Debug, Clone)]
pub struct ArtifactRecord {
    pub artifact_id: i64,
    pub goal_id: String,
    pub kind: String,
    pub path: String,
    pub mime_type: Option<String>,
    pub created_at: i64,
}

/// Filter for listing goals.
#[derive(Debug, Clone, Default)]
pub struct GoalFilter {
    pub status: Option<String>,
    pub phase: Option<String>,
    pub kind: Option<String>,
    pub older_than: Option<i64>, // unix seconds
    pub limit: Option<usize>,
}

/// Summary of a goal for list views.
#[derive(Debug, Clone)]
pub struct GoalSummary {
    pub goal_id: String,
    pub status: String,
    pub phase: String,
    pub goal_text: String,
    pub created_at: i64,
    pub updated_at: i64,
}