cgn-core 0.1.1

Cognitora shared library: config, errors, hashing, prefix-trie
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

//! Cognitora shared library.
//!
//! Lean cross-cutting concerns reused by every binary: configuration,
//! errors, BLAKE3 prefix hashing, and the concurrent prefix index.
//!
//! Telemetry, TLS, and Kubernetes helpers live in dedicated `cgn-*`
//! crates so this crate stays free of heavy transitive dependencies.

#![forbid(unsafe_code)]

pub mod config;
pub mod error;
pub mod hash;
pub mod prefix;

pub use error::{exit_code, Error, Result};

/// Default UNIX domain socket directory used by the daemons.
pub const DEFAULT_UDS_DIR: &str = "/run/cognitora";

/// Default config search path.
pub const DEFAULT_CONFIG_PATH: &str = "/etc/cognitora/cognitora.toml";

/// Cluster state key prefixes (etcd) used by router/agent/operator.
pub mod etcd_keys {
    pub const NODES: &str = "/cognitora/nodes/";
    pub const MODELS: &str = "/cognitora/models/";
    pub const ROUTING: &str = "/cognitora/routing/policy";
    pub const ROUTER_LEADER: &str = "/cognitora/router/leader";
}

/// Default ports.
pub mod ports {
    /// `cgn-router` OpenAI-compatible HTTP/SSE.
    pub const ROUTER_HTTP: u16 = 8080;
    /// `cgn-router` admin gRPC (metrics, control RPCs).
    pub const ROUTER_GRPC: u16 = 9090;
    /// `cgn-router` admin HTTP (Prometheus scrape).
    pub const ROUTER_ADMIN: u16 = 9091;
    /// `cgn-agent` gRPC (router → agent).
    pub const AGENT_GRPC: u16 = 7070;
    /// `cgn-kvcached` gRPC (cross-host KV ops).
    pub const KV_GRPC: u16 = 7071;
    /// `cgn-kvcached` QUIC transfer port.
    pub const KV_QUIC: u16 = 7072;
    /// `cgn-metrics` HTTP scrape.
    pub const METRICS_HTTP: u16 = 9092;
    /// vLLM HTTP (private to the agent).
    pub const VLLM_HTTP: u16 = 8000;
}

/// Build / version metadata.
pub mod build {
    /// Crate version (from Cargo).
    pub const VERSION: &str = env!("CARGO_PKG_VERSION");
}