v0.2.5-pre.010.fix.002

crates/ksp-app-config-desk/src/bootstrap.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-app-config-desk/src/bootstrap.rs
-// version: 5
+// version: 6
 
 //! Config and Logging bootstrap for the desktop application.
 
@@ -49,7 +49,7 @@ pub(crate) fn config_management(arguments: &[std::ffi::OsString]) -> ksp_core_li
 pub(crate) fn initialize_logging(
     management: &ksp_config_lib::ConfigManagement,
     runtime_identity: &ksp_logging_lib::LoggingRuntimeIdentity,
-) -> ksp_core_lib::Result<LoggingStartup> {
+) -> ksp_core_lib::Result<crate::LoggingStartup> {
     let plan = resolve_logging_startup(management);
     return match plan {
         LoggingStartupPlan::Managed { active_profile_id, settings } => {
@@ -110,7 +110,7 @@ fn fallback_startup_plan(initial_error: ksp_core_lib::Error) -> LoggingStartupPl
 fn initialize_fallback_logging(
     initial_error: ksp_core_lib::Error,
     runtime_identity: &ksp_logging_lib::LoggingRuntimeIdentity,
-) -> ksp_core_lib::Result<LoggingStartup> {
+) -> ksp_core_lib::Result<crate::LoggingStartup> {
     let diagnostic = crate::CommandErrorDto::from_error(&initial_error);
     return initialize_planned_fallback_logging(initial_error, diagnostic, fallback_logging_settings(), runtime_identity);
 }
@@ -120,7 +120,7 @@ fn initialize_planned_fallback_logging(
     diagnostic: crate::CommandErrorDto,
     settings: ksp_logging_lib::LoggingSettings,
     runtime_identity: &ksp_logging_lib::LoggingRuntimeIdentity,
-) -> ksp_core_lib::Result<LoggingStartup> {
+) -> ksp_core_lib::Result<crate::LoggingStartup> {
     let guard = ksp_logging_lib::initialize_with_identity(&settings, runtime_identity);
     let guard = match guard {
         std::result::Result::Ok(value) => value,

crates/ksp-app-config-desk/src/documents.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-app-config-desk/src/documents.rs
-// version: 2
+// version: 3
 
 //! Generic Config document inventory, diagnostics and validated repair services.
 
@@ -148,7 +148,7 @@ pub(crate) fn save_document_source(
         std::result::Result::Ok(value) => value,
         std::result::Result::Err(error) => return std::result::Result::Err(ConfigDocumentErrorDto::from_error(&error)),
     };
-    let document = detail(state, file_id.as_str());
+    let document = crate::document_detail(state, file_id.as_str());
     let document = match document {
         std::result::Result::Ok(value) => value,
         std::result::Result::Err(error) => return std::result::Result::Err(error),

crates/ksp-app-config-desk/src/environment.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-app-config-desk/src/environment.rs
-// version: 3
+// version: 4
 
 //! Safe Config environment reports and `.env` management projections for Config Desk.
 

crates/ksp-app-config-desk/src/profiles.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-app-config-desk/src/profiles.rs
-// version: 3
+// version: 4
 
 //! Safe Config profile inspection and provenance projections for Config Desk.
 

crates/ksp-app-config-desk/src/tw_main.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-app-config-desk/src/tw_main.rs
-// version: 3
+// version: 4
 
 //! Tauri-window helpers for the Config Desk main window.
 
@@ -22,7 +22,7 @@ pub(crate) fn require_main_window(manager: &impl Manager<tauri::Wry>) -> ksp_cor
 
 /// Shows main window.
 pub(crate) fn show_main_window(app: &tauri::AppHandle) -> ksp_core_lib::Result<()> {
-    let window = require_window(app);
+    let window = crate::require_main_window(app);
     let window = match window {
         std::result::Result::Ok(value) => value,
         std::result::Result::Err(error) => return std::result::Result::Err(error),

crates/ksp-app-config-desk/src/tw_splash.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-app-config-desk/src/tw_splash.rs
-// version: 4
+// version: 5
 
 //! Tauri-window lifecycle for the Config Desk splash window.
 
@@ -8,6 +8,7 @@ use tauri::Manager; // rust-rules: trait-import
 
 /// Crate-internal `WINDOW_LABEL_SPLASH` constant.
 pub(crate) const WINDOW_LABEL_SPLASH: &str = "splash";
+
 const SPLASH_EVENT_NAME: &str = "ksp-splash-order";
 
 /// Resolves the required splash window or returns a typed error.

crates/ksp-app-config-desk/unit_tests/environment.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-app-config-desk/unit_tests/environment.rs
-// version: 3
+// version: 4
 
 #[test]
 fn namespace_projection_distinguishes_ksp_and_kspb_sensitivity_families() {
@@ -53,7 +53,7 @@ fn committed_environment_report_is_safe_and_deterministic_when_present() {
     let management = committed_management();
     assert!(management.is_ok(), "committed management should construct: {management:?}");
     if let std::result::Result::Ok(management) = management {
-        let report = crate::environment_report_from_management(&management);
+        let report = super::report_from_management(&management);
         assert!(report.is_ok(), "environment report should project safely: {report:?}");
         if let std::result::Result::Ok(report) = report {
             let mut previous = std::option::Option::<&str>::None;

crates/ksp-app-config-desk/unit_tests/logging_editor.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-app-config-desk/unit_tests/logging_editor.rs
-// version: 6
+// version: 7
 
 #[test]
 fn committed_logging_document_maps_complete_read_only_editor_contract() {
@@ -8,7 +8,7 @@ fn committed_logging_document_maps_complete_read_only_editor_contract() {
     if let std::result::Result::Ok(management) = management {
         let source = management.load_logging_document();
         assert!(source.is_ok(), "typed Logging source should load: {source:?}");
-        let document = crate::logging_document_from_management(&management);
+        let document = super::document_from_management(&management);
         assert!(document.is_ok(), "Logging editor document should load: {document:?}");
         if let (std::result::Result::Ok(source), std::result::Result::Ok(document)) = (source, document) {
             assert_eq!(document.file_id, ksp_config_lib::FILE_ID_STD_LOGGING);
@@ -63,7 +63,7 @@ fn editor_candidate_round_trips_through_typed_config_contract() {
     let management = committed_management();
     assert!(management.is_ok(), "committed management should construct: {management:?}");
     if let std::result::Result::Ok(management) = management {
-        let document = crate::logging_document_from_management(&management);
+        let document = super::document_from_management(&management);
         assert!(document.is_ok(), "Logging editor document should load: {document:?}");
         if let std::result::Result::Ok(document) = document {
             let candidate = crate::LoggingDocumentCandidateDto {

crates/ksp-app-config-desk/unit_tests/profiles.rs

@@ -1,12 +1,12 @@
 // file: crates/ksp-app-config-desk/unit_tests/profiles.rs
-// version: 4
+// version: 5
 
 #[test]
 fn profile_inventory_exposes_registered_standard_profile_documents() {
     let management = fixture_management();
     assert!(management.is_ok(), "fixture management should construct: {management:?}");
     if let std::result::Result::Ok(management) = management {
-        let inventory = crate::profile_inventory_from_management(&management);
+        let inventory = super::inventory_from_management(&management);
         assert!(inventory.is_ok(), "profile inventory should resolve: {inventory:?}");
         if let std::result::Result::Ok(inventory) = inventory {
             assert!(inventory.iter().any(|document| -> bool {
@@ -32,7 +32,7 @@ fn default_profile_detail_uses_safe_effective_value_and_dotenv_provenance() {
     if let std::result::Result::Ok(management) = management {
         let source = management.load_logging_document();
         assert!(source.is_ok(), "typed Logging source should load: {source:?}");
-        let detail = crate::profile_detail_from_management(&management, ksp_config_lib::FILE_ID_STD_LOGGING, std::option::Option::None);
+        let detail = super::detail_from_management(&management, ksp_config_lib::FILE_ID_STD_LOGGING, std::option::Option::None);
         assert!(detail.is_ok(), "default profile should inspect safely: {detail:?}");
         if let (std::result::Result::Ok(source), std::result::Result::Ok(detail)) = (source, detail) {
             assert_eq!(detail.selected_profile, source.default_profile());
@@ -60,8 +60,7 @@ fn explicit_profile_inspection_reports_explicit_selection_source() {
         assert!(source.is_ok(), "typed Logging source should load: {source:?}");
         if let std::result::Result::Ok(source) = source {
             let profile_id = source.default_profile().to_owned();
-            let detail =
-                crate::profile_detail_from_management(&management, ksp_config_lib::FILE_ID_STD_LOGGING, std::option::Option::Some(profile_id.as_str()));
+            let detail = super::detail_from_management(&management, ksp_config_lib::FILE_ID_STD_LOGGING, std::option::Option::Some(profile_id.as_str()));
             assert!(detail.is_ok(), "explicit profile should inspect: {detail:?}");
             if let std::result::Result::Ok(detail) = detail {
                 assert_eq!(detail.selected_profile, profile_id);

crates/ksp-config-lib/src/environment.rs

@@ -1,10 +1,11 @@
 // file: crates/ksp-config-lib/src/environment.rs
-// version: 7
+// version: 8
 
 /// Versioned environment contract template expected at the repository/runtime root.
 pub const DEFAULT_DOTENV_EXAMPLE_PATH: &str = ".env.example";
 /// Default local environment file read by Config from the process launch directory.
 pub const DEFAULT_DOTENV_PATH: &str = ".env";
+
 const LOGGING_DOMAIN: &str = "config.environment";
 
 /// Source that supplied one resolved Config environment variable.

crates/ksp-core-lib/src/program_ids.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-core-lib/src/program_ids.rs
-// version: 3
+// version: 4
 
 const DOMAIN_SOLANA: &str = "solana";
 const FAMILY_CONSENSUS: &str = "consensus";

crates/ksp-logging-lib/src/runtime.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-logging-lib/src/runtime.rs
-// version: 15
+// version: 16
 
 use tracing_subscriber::Layer; // rust-rules: trait-import
 use tracing_subscriber::layer::SubscriberExt; // rust-rules: trait-import
@@ -473,6 +473,7 @@ const fn map_filter_level(level: crate::LogFilterLevel) -> tracing_subscriber::f
         crate::LogFilterLevel::Trace => tracing_subscriber::filter::LevelFilter::TRACE,
     };
 }
+
 const fn map_file_rotation(rotation: crate::FileRotation) -> tracing_appender::rolling::Rotation {
     return match rotation {
         crate::FileRotation::Never => tracing_appender::rolling::Rotation::NEVER,

crates/ksp-onchain-transport-lib/src/rpc_cluster.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-onchain-transport-lib/src/rpc_cluster.rs
-// version: 6
+// version: 7
 
 const MAX_GET_SLOT_LEADERS: u64 = 5_000;
 
@@ -29,71 +29,85 @@ impl SolanaClusterNode {
     pub const fn pubkey(&self) -> &ksp_core_lib::Pubkey {
         return &self.pubkey;
     }
+
     /// Returns the optional feature-set identifier.
     #[must_use]
     pub const fn feature_set(&self) -> std::option::Option<u32> {
         return self.feature_set;
     }
+
     /// Returns the optional gossip endpoint.
     #[must_use]
     pub fn gossip(&self) -> std::option::Option<&str> {
         return self.gossip.as_deref();
     }
+
     /// Returns the optional PubSub endpoint.
     #[must_use]
     pub fn pubsub(&self) -> std::option::Option<&str> {
         return self.pubsub.as_deref();
     }
+
     /// Returns the optional JSON-RPC endpoint.
     #[must_use]
     pub fn rpc(&self) -> std::option::Option<&str> {
         return self.rpc.as_deref();
     }
+
     /// Returns the optional repair endpoint.
     #[must_use]
     pub fn serve_repair(&self) -> std::option::Option<&str> {
         return self.serve_repair.as_deref();
     }
+
     /// Returns the optional shred version.
     #[must_use]
     pub const fn shred_version(&self) -> std::option::Option<u16> {
         return self.shred_version;
     }
+
     /// Returns the optional TPU endpoint.
     #[must_use]
     pub fn tpu(&self) -> std::option::Option<&str> {
         return self.tpu.as_deref();
     }
+
     /// Returns the optional TPU forwards endpoint.
     #[must_use]
     pub fn tpu_forwards(&self) -> std::option::Option<&str> {
         return self.tpu_forwards.as_deref();
     }
+
     /// Returns the optional TPU forwards QUIC endpoint.
     #[must_use]
     pub fn tpu_forwards_quic(&self) -> std::option::Option<&str> {
         return self.tpu_forwards_quic.as_deref();
     }
+
     /// Returns the optional TPU QUIC endpoint.
     #[must_use]
     pub fn tpu_quic(&self) -> std::option::Option<&str> {
         return self.tpu_quic.as_deref();
     }
+
     /// Returns the optional TPU vote endpoint.
     #[must_use]
     pub fn tpu_vote(&self) -> std::option::Option<&str> {
         return self.tpu_vote.as_deref();
     }
+
     /// Returns the optional TVU endpoint.
     #[must_use]
     pub fn tvu(&self) -> std::option::Option<&str> {
         return self.tvu.as_deref();
     }
+
     /// Returns the optional software-version string.
     #[must_use]
     pub fn version(&self) -> std::option::Option<&str> {
         return self.version.as_deref();
     }
+
     /// Returns the optional Agave client identifier extension.
     #[must_use]
     pub fn client_id(&self) -> std::option::Option<&str> {
@@ -149,26 +163,31 @@ impl SolanaEpochInfo {
     pub const fn absolute_slot(&self) -> u64 {
         return self.absolute_slot;
     }
+
     /// Returns the block height.
     #[must_use]
     pub const fn block_height(&self) -> u64 {
         return self.block_height;
     }
+
     /// Returns the epoch number.
     #[must_use]
     pub const fn epoch(&self) -> u64 {
         return self.epoch;
     }
+
     /// Returns the slot index within the epoch.
     #[must_use]
     pub const fn slot_index(&self) -> u64 {
         return self.slot_index;
     }
+
     /// Returns the number of slots in the epoch.
     #[must_use]
     pub const fn slots_in_epoch(&self) -> u64 {
         return self.slots_in_epoch;
     }
+
     /// Returns the nullable transaction count.
     #[must_use]
     pub const fn transaction_count(&self) -> std::option::Option<u64> {
@@ -208,21 +227,25 @@ impl SolanaEpochSchedule {
     pub const fn first_normal_epoch(&self) -> u64 {
         return self.first_normal_epoch;
     }
+
     /// Returns the first normal slot.
     #[must_use]
     pub const fn first_normal_slot(&self) -> u64 {
         return self.first_normal_slot;
     }
+
     /// Returns the leader-schedule slot offset.
     #[must_use]
     pub const fn leader_schedule_slot_offset(&self) -> u64 {
         return self.leader_schedule_slot_offset;
     }
+
     /// Returns the number of slots per epoch.
     #[must_use]
     pub const fn slots_per_epoch(&self) -> u64 {
         return self.slots_per_epoch;
     }
+
     /// Returns whether epoch warmup is enabled.
     #[must_use]
     pub const fn warmup(&self) -> bool {
@@ -258,6 +281,7 @@ impl SolanaSnapshotSlotInfo {
     pub const fn full(&self) -> u64 {
         return self.full;
     }
+
     /// Returns the optional highest incremental snapshot slot.
     #[must_use]
     pub const fn incremental(&self) -> std::option::Option<u64> {
@@ -287,20 +311,24 @@ impl SolanaLeaderScheduleConfig {
     pub const fn new(identity: std::option::Option<ksp_core_lib::Pubkey>, commitment: std::option::Option<crate::SolanaCommitment>) -> Self {
         return Self { identity, commitment };
     }
+
     /// Returns the optional validator identity filter.
     #[must_use]
     pub const fn identity(&self) -> std::option::Option<&ksp_core_lib::Pubkey> {
         return self.identity.as_ref();
     }
+
     /// Returns the optional commitment level.
     #[must_use]
     pub const fn commitment(&self) -> std::option::Option<crate::SolanaCommitment> {
         return self.commitment;
     }
+
     /// Returns whether empty.
     pub(crate) const fn is_empty(&self) -> bool {
         return self.identity.is_none() && self.commitment.is_none();
     }
+
     /// Executes the crate-internal to json value operation for `SolanaLeaderScheduleConfig`.
     pub(crate) fn to_json_value(&self) -> serde_json::Value {
         let mut object = serde_json::Map::new();
@@ -402,30 +430,36 @@ impl SolanaVoteAccountsConfig {
     ) -> Self {
         return Self { commitment, vote_pubkey, keep_unstaked_delinquents, delinquent_slot_distance };
     }
+
     /// Returns the optional commitment.
     #[must_use]
     pub const fn commitment(&self) -> std::option::Option<crate::SolanaCommitment> {
         return self.commitment;
     }
+
     /// Returns the optional vote-account public key filter.
     #[must_use]
     pub const fn vote_pubkey(&self) -> std::option::Option<&ksp_core_lib::Pubkey> {
         return self.vote_pubkey.as_ref();
     }
+
     /// Returns whether unstaked delinquent validators should be kept.
     #[must_use]
     pub const fn keep_unstaked_delinquents(&self) -> std::option::Option<bool> {
         return self.keep_unstaked_delinquents;
     }
+
     /// Returns the optional delinquent slot distance.
     #[must_use]
     pub const fn delinquent_slot_distance(&self) -> std::option::Option<u64> {
         return self.delinquent_slot_distance;
     }
+
     /// Returns whether empty.
     pub(crate) const fn is_empty(&self) -> bool {
         return self.commitment.is_none() && self.vote_pubkey.is_none() && self.keep_unstaked_delinquents.is_none() && self.delinquent_slot_distance.is_none();
     }
+
     /// Serializes this config to the Solana JSON-RPC wire object.
     #[must_use]
     pub(crate) fn to_json_value(&self) -> serde_json::Value {
@@ -460,11 +494,13 @@ impl SolanaEpochCredits {
     pub const fn epoch(&self) -> u64 {
         return self.epoch;
     }
+
     /// Returns cumulative credits at the end of the epoch.
     #[must_use]
     pub const fn credits(&self) -> u64 {
         return self.credits;
     }
+
     /// Returns cumulative credits before the epoch.
     #[must_use]
     pub const fn previous_credits(&self) -> u64 {
@@ -492,41 +528,49 @@ impl SolanaVoteAccountInfo {
     pub const fn vote_pubkey(&self) -> &ksp_core_lib::Pubkey {
         return &self.vote_pubkey;
     }
+
     /// Returns the validator identity public key.
     #[must_use]
     pub const fn node_pubkey(&self) -> &ksp_core_lib::Pubkey {
         return &self.node_pubkey;
     }
+
     /// Returns the activated stake in lamports.
     #[must_use]
     pub const fn activated_stake(&self) -> u64 {
         return self.activated_stake;
     }
+
     /// Returns the legacy/effective percentage commission field.
     #[must_use]
     pub const fn commission(&self) -> u8 {
         return self.commission;
     }
+
     /// Returns the optional raw inflation-rewards commission in basis points.
     #[must_use]
     pub const fn inflation_rewards_commission_bps(&self) -> std::option::Option<u16> {
         return self.inflation_rewards_commission_bps;
     }
+
     /// Returns whether the vote account is staked for the current epoch.
     #[must_use]
     pub const fn epoch_vote_account(&self) -> bool {
         return self.epoch_vote_account;
     }
+
     /// Returns the bounded RPC epoch-credit history.
     #[must_use]
     pub fn epoch_credits(&self) -> &[crate::SolanaEpochCredits] {
         return self.epoch_credits.as_slice();
     }
+
     /// Returns the latest voted slot or zero when no vote exists.
     #[must_use]
     pub const fn last_vote(&self) -> u64 {
         return self.last_vote;
     }
+
     /// Returns the current root slot or zero when no root exists.
     #[must_use]
     pub const fn root_slot(&self) -> u64 {
@@ -581,6 +625,7 @@ impl SolanaVoteAccountStatus {
     pub fn current(&self) -> &[crate::SolanaVoteAccountInfo] {
         return self.current.as_slice();
     }
+
     /// Returns delinquent vote accounts.
     #[must_use]
     pub fn delinquent(&self) -> &[crate::SolanaVoteAccountInfo] {

crates/ksp-onchain-transport-lib/src/rpc_method.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-onchain-transport-lib/src/rpc_method.rs
-// version: 4
+// version: 5
 
 const CURRENT_HTTP_RPC_METHODS: [crate::HttpRpcMethodDescriptor; 52] = [
     crate::HttpRpcMethodDescriptor::new(
@@ -1080,6 +1080,7 @@ impl HttpRpcMethodDescriptor {
 pub const fn current_http_rpc_methods() -> &'static [crate::HttpRpcMethodDescriptor] {
     return &CURRENT_HTTP_RPC_METHODS;
 }
+
 /// Returns the 14 historically documented deprecated HTTP RPC descriptors retained for compliance history.
 #[must_use]
 pub const fn historical_http_rpc_methods() -> &'static [crate::HttpRpcMethodDescriptor] {

crates/ksp-wallet-lib/src/constants.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-wallet-lib/src/constants.rs
-// version: 6
+// version: 7
 
 //! Wallet-owned constants.
 
@@ -85,5 +85,6 @@ pub const KSPWALLET_V1_STATE_TRANSCRIPT_DOMAIN: &[u8] = b"KSPWALLET-V1-STATE";
 pub const KSPWALLET_V1_VIEW_SLOT_AAD_DOMAIN: &[u8] = b"KSPWALLET-V1-AAD-VIEW-SLOT";
 /// Byte length of an XChaCha20-Poly1305 nonce.
 pub const KSPWALLET_V1_XCHACHA_NONCE_BYTES: usize = 24;
+
 /// Owning tracing target for events emitted by the Wallet crate.
 pub(crate) const TRACING_TARGET: &str = "ksp-wallet-lib";