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

pub mod agent;
mod budget;
pub mod chat_api;
mod control;
mod decision;
mod delivery;
mod dispatch;
pub(crate) mod evidence;
mod git_ops;
mod integration;
mod lifecycle;
mod merge;
mod open_pr;
mod oracle;
mod planner;
mod progress;
mod proof;
mod queries;
mod replay;
mod review;
mod state;
mod supervisor;
mod task_graph;
mod types;
mod verifier;
mod worktree;

// Public API
#[doc(hidden)]
pub use agent::leases::{LeaseError, LeaseGuard, LeaseManager};
pub use agent::{check_task_path_policy, GoalAgentTaskProposal};
pub use budget::{
    add_goal_budget, add_goal_budget_limits, evaluate_task_budget, goal_budget, GoalBudgetAdd,
    GoalBudgetCheckpoint, GoalBudgetReport, PerTaskBudgetSnapshot,
};
pub use chat_api::{create_child, ChildGoalHandle};
pub use control::{cancel_goal, pause_goal, resume_goal};
pub use delivery::{
    attempt_auto_merge, deliver_goal_open_pr_with_client, open_goal_pr_with_client,
    poll_github_pr_checks, AutoMergeAction, AutoMergeContext, GoalDeliveryPolicy,
    GoalGithubPrClient, GoalGithubPrCommandClient, GoalGithubPrDeliveryOptions,
    GoalGithubPrDeliveryOutcome, GoalGithubPrMutation, GoalGithubPrOperation, GoalGithubPrRequest,
    GoalMergePolicy,
};
pub use evidence::GoalGitEvidence;
pub use lifecycle::{execute_goal, review_goal, verify_goal, verify_goal_with_slices};
pub use merge::merge_goal;
pub use open_pr::GoalOpenPrDraft;
pub use oracle::GoalKind;

// Review gate types for integration tests.
pub use planner::discover_relevant_files;
pub use progress::{GoalProgressLine, GoalProgressLineKind, GoalProgressSnapshot};
pub use proof::GoalProof;
pub use queries::{list_goals, resolve_goal, resolve_goal_proof};
pub use replay::{replay_goal, GoalReplay, GoalReplayEntry};
#[doc(hidden)]
pub use review::dispatcher::{aggregate_verdict, AggregateReviewVerdict};
#[doc(hidden)]
pub use review::test_slice_review_outcome;
#[doc(hidden)]
pub use review::SliceReviewArtifact;
pub use state::{
    CreateGoalOptions, FileSystemGoalStateStore, GoalArtifact, GoalFailure, GoalPhase, GoalState,
    GoalStateError, GoalStateStore, GoalStatus, GoalTerminalCriteria, GOALS_DIR,
    GOAL_AGENT_RUNS_DIR, GOAL_ARTIFACTS_DIR, GOAL_BUDGET_CHECKPOINTS_FILE, GOAL_DECISIONS_FILE,
    GOAL_FAILURE_FILE, GOAL_GATE_ARTIFACTS_DIR, GOAL_PRD_FILE, GOAL_PROOF_FILE, GOAL_STATE_FILE,
    GOAL_TASK_GRAPH_FILE, GOAL_TECHNICAL_PLAN_FILE, GOAL_TEST_SPEC_FILE,
};
pub use supervisor::{claim_goal, list_orphaned_goals, release_goal};
pub use task_graph::{
    load_goal_task_delivery_records, plan_goal_delivery_slices, read_goal_task_delivery_metadata,
    record_goal_delivery_slice_plan, update_goal_task_delivery_metadata,
    GoalDeliveryOverlapSerialization, GoalDeliverySlice, GoalDeliverySlicePlan, GoalTask,
    GoalTaskDeliveryMetadata, GoalTaskDeliveryMetadataUpdate, GoalTaskDeliveryRecord,
    GoalTaskDeliveryStatus, GoalTaskEvidence, GoalTaskGraph, GoalTaskGraphSummary, GoalTaskStatus,
};
pub use types::{GoalBudget, GoalControllerStepKind, GoalId};

// Test-only helpers for integration tests.  Not for production use.
#[doc(hidden)]
pub use supervisor::test_goal_record;
#[doc(hidden)]
pub use supervisor::{claim_goal_for_test, list_orphaned_goals_for_test, release_goal_for_test};

pub use git_ops::auto_rebase::ConflictClassification;

pub use worktree::{
    detect_goal_merge_conflicts, materialize_goal_worktrees, plan_goal_worktree,
    plan_goal_worktrees, GoalMergeConflictCheckRequest, GoalMergeConflictEvidence,
    GoalWorktreeMaterializeOutcome, GoalWorktreeMaterializeRequest, GoalWorktreePlan,
};

#[doc(hidden)]
pub use integration::write_rejection_rollback_plan;

// Internal API
pub(crate) use control::run_goal_until_ready;
pub(crate) use integration::{accept_goal, reject_goal};
pub(crate) use open_pr::render_goal_open_pr;
pub(crate) use state::parse_budget_duration;
pub(crate) use types::GoalRunUntilReadyOutcome;

pub use agent::{GoalAgentDispatchPlan, GoalAgentWaveKind};
pub use dispatch::GoalDispatcher;
pub use evidence::GoalAgentRunEvidence;
pub use lifecycle::execute_goal_with_dispatcher;

// Facade functions
pub async fn create_goal(
    goal: &str,
    options: CreateGoalOptions,
    planner: Option<&dyn crate::llm::Planner>,
) -> anyhow::Result<GoalState> {
    planner::create_goal_with_scaffold(goal, options, planner).await
}

pub async fn plan_goal(
    goal: &str,
    planner: Option<&dyn crate::llm::Planner>,
) -> anyhow::Result<GoalState> {
    planner::create_goal_with_scaffold(
        goal,
        CreateGoalOptions {
            until_ready: false,
            budget_time: None,
            budget_tokens: None,
            budget_usd: None,
            max_agents: None,
            delivery_policy: GoalDeliveryPolicy::Local,
            merge_policy: GoalMergePolicy::Disabled,
            slice_execution: false,
            enforce_protection: false,
        },
        planner,
    )
    .await
}