bistun-lms 2.1.1

A thread-safe capability engine for resolving BCP 47 language tags into actionable rendering and parsing properties (directionality, morphology, segmentation). Features a wait-free, lock-free memory pool (ArcSwap) enabling zero-downtime registry hot-swaps for high-throughput NLP and UI pipelines.
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

// Bistun Linguistic Metadata Service (LMS)
// Copyright (C) 2026  Francis Xavier Wazeter IV
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.

//! # The Core Engine Domain
//! Ref: [001-LMS-CORE]
//! Location: `src/core/mod.rs`
//!
//! **Why**: This module acts as the primary orchestrator for the 5-Phase Capability Pipeline. It routes requests through the Taxonomic Resolver, Typological Aggregator, and Orthographic Extension mapper to synthesize a finalized manifest.
//! **Impact**: If this module or its internal routing is misconfigured, the service boundaries will fail to communicate, preventing the transformation of raw BCP 47 tags into actionable rendering instructions.
//!
//! ### The 5-Phase Pipeline Architecture
//! This module houses the isolated domains that execute the resolution pipeline:
//! 1. **Phase 1 (Resolve)**: [`crate::core::resolver`] - The Taxonomic Chain of Responsibility (BCP 47).
//! 2. **Phase 2 (Aggregate)**: [`crate::core::aggregator`] - The Typological High-Water Mark engine (ISO 639-3).
//! 3. **Phase 2.5 (Synthesize & Resource)**: [`crate::core::synthesizer`], [`crate::core::resource`] - The Logic Bridge mapping traits to execution rules and physical ICU4X assets.
//! 4. **Phase 3 (Override)**: [`crate::core::extension`] - The BCP 47 `-u-` subtag mutator.
//! 5. **Phase 4 (Integrity)**: Handled externally by `crate::validation`.
//! 6. **Phase 5 (Telemetry)**: Handled globally by `crate::ops::telemetry`.
//!
//! ### Glossary
//! * **Capability Pipeline**: The sequential execution of 5 distinct phases (Resolve, Aggregate, Override, Integrity, Telemetry) to hydrate a manifest.
//! * **Orchestration**: The process of coordinating sub-engine execution without embedding specific business logic in the dispatcher.

/// Phase 2: Handles the merging of typological traits from the Flyweight pool.
pub mod aggregator;

/// Phase 3: Manages Unicode extensions and mechanical script overrides.
pub mod extension;

/// The central coordinator executing the full 5-Phase pipeline.
pub mod pipeline;

/// Phase 1: Resolves BCP 47 tags via the Chain of Responsibility.
pub mod resolver;
/// Phase 2.5: Logic Bridge mapping traits to execution rules and physical ICU4X assets
pub mod resource;
/// Phase 2.5: Logic Bridge mapping traits to execution rules and physical ICU4X assets
pub mod synthesizer;

// Expose the orchestrator securely
pub use pipeline::generate_manifest;