bistun_lms/lib.rs
1// Bistun Linguistic Metadata Service (LMS)
2// Copyright (C) 2026 Francis Xavier Wazeter IV
3//
4// This program is free software: you can redistribute it and/or modify
5// it under the terms of the GNU General Public License as published by
6// the Free Software Foundation, either version 3 of the License, or
7// (at your option) any later version.
8//
9// This program is distributed in the hope that it will be useful,
10// but WITHOUT ANY WARRANTY; without even the implied warranty of
11// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12// GNU General Public License for more details.
13//
14// You should have received a copy of the GNU General Public License
15// along with this program. If not, see <https://www.gnu.org/licenses/>.
16
17//! # Capability Engine Root
18//! Ref: [012-LMS-ENG]
19//! Location: `crates/bistun-lms/src/lib.rs`
20//!
21//! **Why**: This crate root centralizes the 5-phase capability engine's operational modules and exposes the primary SDK entry point. It serves as the orchestrator for resolving BCP 47 tags into actionable Linguistic DNA.
22//! **Impact**: If this root is compromised or misconfigured, external consumers cannot access the `LinguisticManager`, rendering the entire capability resolution service unreachable and breaking downstream UI/NLP integrations.
23//!
24//! ### Glossary
25//! * **Orchestration**: The coordination of multiple sub-engines (Taxonomy, Typology, etc.) into a unified result.
26//! * **SDK (Software Development Kit)**: The public interface providing tools and libraries for developers to integrate Bistun capabilities.
27
28/// The 5-phase resolution pipeline logic.
29pub mod core;
30
31/// WORM hydration and memory pool management.
32pub mod data;
33
34/// The primary SDK interface for external consumers.
35pub mod manager;
36
37/// System observability and performance telemetry.
38pub mod ops;
39
40/// Cryptographic verification and JWS gates.
41pub mod security;
42
43/// Runtime and pre-persistence integrity checks.
44pub mod validation;
45
46// [Logic Trace: Re-exports]
47// To maintain a "Living Document" and ergonomic API, we surface the primary
48// operational models at the crate root.
49
50// Re-export the operational status enum for SDK health monitoring.
51pub use bistun_core::ops::SdkState;
52
53// Re-export the primary orchestrator for capability resolution.
54pub use manager::LinguisticManager;