Skip to main content

kranz_engine/
lib.rs

1#![allow(rustdoc::private_intra_doc_links)]
2
3//! Kranz engine — orchestration core (no UI deps).
4//!
5//! Kranz is a local mission-control harness: an orchestrator plans, fresh
6//! Claude Code sessions implement features one at a time, independent
7//! validator sessions judge each milestone, and git is the source of truth.
8//! An append-only event log makes every mission resumable (`kill -9` safe).
9//!
10//! Module map (build order per plan §5 Phase 1):
11//! - contracts: [`types`], [`events`], [`error`], [`backend`]
12//! - foundation: [`paths`], [`event_log`], [`reducer`], [`scrub`], [`git_ops`],
13//!   [`config`], [`cost`], [`prompts`], [`backend_mock`]
14//! - orchestration: [`backend_claude`], [`permissions`], [`runner`],
15//!   [`control`], [`digest`], [`orchestrator`]
16
17pub mod backend;
18pub mod error;
19pub mod events;
20pub mod paths;
21pub mod plan_fit;
22pub mod types;
23
24pub mod acp_worker;
25pub mod agent_env;
26#[cfg(windows)]
27pub(crate) mod appcontainer_windows;
28pub mod auth_verify;
29pub mod backend_readiness;
30pub mod command_exec;
31pub mod comparison_metrics;
32pub mod config;
33pub mod container_egress;
34pub mod contract_controls;
35pub mod contract_gates;
36pub mod contract_health;
37pub mod contract_lint;
38pub mod contract_sweep;
39pub mod corpus_export;
40pub mod cost;
41pub mod decompose;
42pub mod deps;
43pub mod disk_preflight;
44pub mod domain_lint;
45pub mod egress_proxy;
46pub mod escalation_metrics;
47pub mod event_log;
48pub mod evidence_bundle;
49pub mod findings;
50pub mod gate;
51pub mod gate_evaluation;
52pub mod gate_results;
53pub mod gate_score_flags;
54pub mod gate_scores;
55pub mod git_ops;
56pub mod hook_gates;
57pub mod hook_status;
58pub mod hooks;
59pub mod judgement;
60pub mod knowledge;
61pub mod lessons;
62pub mod live_permission;
63pub mod merge;
64pub mod merged;
65pub mod migrate_state;
66pub mod mission_catalog;
67pub mod outcomes;
68pub mod pack;
69pub mod planning;
70pub mod pr_handoff;
71pub mod preflight;
72pub mod prompts;
73pub mod provenance;
74pub mod pty_harness;
75pub mod queue;
76pub mod reducer;
77pub mod report_render;
78pub mod review_artifact;
79pub mod review_packet;
80pub mod reviewer_independence;
81pub mod routing;
82pub mod routing_rules;
83pub mod sandbox;
84pub mod sandbox_container;
85pub mod sandbox_windows;
86pub mod scrub;
87pub mod sgian;
88pub mod standards_attestation;
89pub mod standards_coverage;
90pub mod standards_enforcement;
91pub mod standards_metrics;
92pub mod standards_waiver;
93mod stream_bounds;
94mod strict_json;
95/// Runtime-gated test support: skip loudly, and fail where the capability is
96/// required, so a silent skip cannot masquerade as a pass.
97pub mod test_capability;
98/// Portable `sh`/`cmd` snippets for test fixtures; see the module docs for why
99/// literal `true`/`false`/`test`/`sleep` must not appear in one.
100#[cfg(test)]
101pub(crate) mod test_shell;
102pub mod ticket;
103pub mod ticket_notes;
104pub mod trace_export;
105pub mod validator_integrity;
106pub mod validator_snapshot;
107pub mod work;
108pub mod workspace_container;
109pub mod workspace_contract;
110pub mod workspace_data;
111pub mod workspace_gate;
112pub mod workspace_provider;
113pub mod workspace_remote;
114
115#[cfg(any(target_os = "macos", target_os = "linux"))]
116mod acp_container;
117pub mod backend_acp;
118pub mod backend_claude;
119pub mod backend_codex;
120pub mod backend_cursor;
121pub mod backend_droid;
122pub mod backend_kimi;
123pub mod backend_local;
124pub mod backend_mock;
125mod backend_probe;
126pub mod control;
127pub mod digest;
128pub mod draft;
129pub mod merge_gate;
130pub mod orchestrator;
131pub mod permissions;
132pub mod runner;
133
134// Re-exported at the crate root so callers (and tests) that only need to
135// inject a scripted backend don't need the full `backend_mock` path.
136pub use backend_mock::MockBackend;