khora_control/
lib.rs

1// Copyright 2025 eraflo
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15//! The strategic brain of the Khora Engine, responsible for the **[C]ontrol Plane**.
16//!
17//! This crate implements the core logic of the Symbiotic Adaptive Architecture (SAA).
18//! It is designed to make high-level, strategic decisions based on telemetry data,
19//! but it never performs real-time, performance-critical work itself.
20//!
21//! Its primary responsibilities include:
22//!
23//! - **The Dynamic Context Core (DCC):** A service that aggregates engine-wide
24//!   telemetry (from `khora-telemetry`) to build a constantly updated situational
25//!   model of the application's performance and state.
26//!
27//! - **Goal-Oriented Resource Negotiation & Allocation (GORNA):** The protocol
28//!   and logic used by the DCC to analyze requests from `Agents` and to allocate
29//!   resource budgets (e.g., CPU/GPU time) to them in order to meet high-level
30//!   performance goals.
31//!
32//! This crate represents the "cold path" of the engine, operating at a lower
33//! frequency and focusing on intelligent analysis rather than raw execution speed.
34
35#![warn(missing_docs)]
khora_control/lib.rs

khora_control/
lib.rs
