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 reviewer_independence;
80pub mod routing;
81pub mod routing_rules;
82pub mod sandbox;
83pub mod sandbox_container;
84pub mod sandbox_windows;
85pub mod scrub;
86pub mod standards_attestation;
87pub mod standards_coverage;
88pub mod standards_enforcement;
89pub mod standards_metrics;
90pub mod standards_waiver;
91mod stream_bounds;
92mod strict_json;
93/// Runtime-gated test support: skip loudly, and fail where the capability is
94/// required, so a silent skip cannot masquerade as a pass.
95pub mod test_capability;
96/// Portable `sh`/`cmd` snippets for test fixtures; see the module docs for why
97/// literal `true`/`false`/`test`/`sleep` must not appear in one.
98#[cfg(test)]
99pub(crate) mod test_shell;
100pub mod ticket;
101pub mod ticket_notes;
102pub mod trace_export;
103pub mod validator_integrity;
104pub mod validator_snapshot;
105pub mod work;
106pub mod workspace_container;
107pub mod workspace_contract;
108pub mod workspace_data;
109pub mod workspace_gate;
110pub mod workspace_provider;
111pub mod workspace_remote;
112
113#[cfg(any(target_os = "macos", target_os = "linux"))]
114mod acp_container;
115pub mod backend_acp;
116pub mod backend_claude;
117pub mod backend_codex;
118pub mod backend_cursor;
119pub mod backend_droid;
120pub mod backend_kimi;
121pub mod backend_local;
122pub mod backend_mock;
123mod backend_probe;
124pub mod control;
125pub mod digest;
126pub mod draft;
127pub mod merge_gate;
128pub mod orchestrator;
129pub mod permissions;
130pub mod runner;
131
132// Re-exported at the crate root so callers (and tests) that only need to
133// inject a scripted backend don't need the full `backend_mock` path.
134pub use backend_mock::MockBackend;