Skip to main content

Crate bistun_lms

Crate bistun_lms 

Source
Expand description

§Capability Engine Root

Crate: bistun-lms Ref: [012-LMS-ENG] Domain: Tooling Location: crates/bistun-lms/src/lib.rs

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 capabilities. 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 and NLP integrations.

§Architectural Topology

  • Tier: 1
  • Dependencies: bistun_core
  • Consumers: External applications, edge client integrations
  • State Model: Managed state via LinguisticManager
  • Design Patterns: Orchestration, Shim

§Local Definitions

  • Orchestration: The coordination of multiple sub-engines (Taxonomy, Typology, etc.) into a unified result.
  • SDK (Software Development Kit): The public interface providing tools and libraries for developers to integrate Bistun capabilities.
  • SdkState: The operational health of the manager (Bootstrapping, Ready, Degraded).
  • WORM Storage (Write-Once, Read-Many): A data retention philosophy where registry records are never mutated in place; new versions are appended to create a verifiable audit trail.
  • JWS (JSON Web Signature): The standard cryptographic protocol used to sign database payloads, guaranteeing data integrity between the central database and edge microservices.
  • Resolution Pipeline: The standard execution sequence for processing a request: Resolve → Aggregate → Override → Validate → Record Telemetry.

Re-exports§

pub use manager::LinguisticManager;

Modules§

core
The 5-phase Resolution Pipeline logic.
data
WORM Storage (Write-Once, Read-Many) hydration and memory pool management.
manager
The primary SDK interface for external consumers.
ops
System observability and performance telemetry.
security
Cryptographic verification and JWS gates.
validation
Runtime and pre-persistence integrity checks.

Enums§

SdkState
Represents the operational health and readiness of the SDK.