v0.3.15-pre.007

crates/ksp-app-raw-transaction-ingest-desk/src/lib.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-app-raw-transaction-ingest-desk/src/lib.rs
-// version: 3
+// version: 4
 
 //! Tauri desktop application scaffold for composing and supervising KSP live RAW transaction ingest routes.
 
@@ -16,6 +16,7 @@ mod errors;
 mod frontend_logging;
 mod logging_runtime;
 mod route_inventory;
+mod route_start;
 mod splash;
 mod tauri;
 mod tw_main;
@@ -44,10 +45,10 @@ pub(crate) use self::constants::COMPOSITE_COMPONENT_ID_LOGGING;
 pub(crate) use self::constants::COMPOSITE_COMPONENT_ID_STORE;
 /// Composite-local identifier for the standard Transport component.
 pub(crate) use self::constants::COMPOSITE_COMPONENT_ID_TRANSPORT;
-/// Composite-local optional Transport source for Helius WebSocket capabilities.
-pub(crate) use self::constants::COMPOSITE_COMPONENT_ID_TRANSPORT_HELIUS;
 /// Prefix used by optional same-network Transport capability sources.
 pub(crate) use self::constants::COMPOSITE_COMPONENT_ID_TRANSPORT_PREFIX;
+/// Composite-local optional Transport source for Helius WebSocket capabilities.
+pub(crate) use self::constants::COMPOSITE_COMPONENT_ID_TRANSPORT_HELIUS;
 /// Composite-local optional Transport source for Yellowstone gRPC capabilities.
 pub(crate) use self::constants::COMPOSITE_COMPONENT_ID_TRANSPORT_YELLOWSTONE;
 /// Structured domain used while bootstrapping Config and Logging.
@@ -56,6 +57,8 @@ pub(crate) use self::constants::TRACING_DOMAIN_BOOTSTRAP;
 pub(crate) use self::constants::TRACING_DOMAIN_FRONTEND;
 /// Structured domain used while rebuilding Config-only route inventory.
 pub(crate) use self::constants::TRACING_DOMAIN_INVENTORY;
+/// Structured domain used while revalidating future Start requests.
+pub(crate) use self::constants::TRACING_DOMAIN_ROUTE_START;
 /// Structured domain used by the Raw Transaction Ingest Desk shell.
 pub(crate) use self::constants::TRACING_DOMAIN_SHELL;
 /// Structured domain used by Tauri window lifecycle operations.
@@ -72,6 +75,8 @@ pub(crate) use self::constants::TRACING_TARGET_FRONTEND_SPLASH;
 pub(crate) use self::dto_common::CommandErrorDto;
 /// Safe scaffold/runtime snapshot exposed to the shell.
 pub(crate) use self::dto_common::ShellStatusDto;
+/// Bounded confirmed/finalized commitment accepted by future route Start requests.
+pub(crate) use self::dto_route::RawIngestCommitment;
 /// Safe route inventory for one logical composite profile.
 pub(crate) use self::dto_route::RawIngestProfileInventoryDto;
 /// Safe Config-only composability projection for one logical route.
@@ -84,6 +89,10 @@ pub(crate) use self::dto_route::RawIngestRouteFoundationDto;
 pub(crate) use self::dto_route::RawIngestRouteId;
 /// Complete deterministic Config-only route inventory.
 pub(crate) use self::dto_route::RawIngestRouteInventoryDto;
+/// Safe future Start request containing only logical route selection and inventory generation.
+pub(crate) use self::dto_route::RawIngestRouteStartRequestDto;
+/// Safe acknowledgement that exact Start-time resources were reconstructed without Worker launch.
+pub(crate) use self::dto_route::RawIngestRouteStartValidationDto;
 /// Stable route lifecycle states reserved for runtime projections.
 pub(crate) use self::dto_route::RawIngestRouteState;
 /// Safe reason explaining why one logical route is not composable from Config.
@@ -102,6 +111,12 @@ pub(crate) use self::errors::ERROR_CODE_FRONTEND_LOG_TARGET_INVALID;
 pub(crate) use self::errors::ERROR_CODE_LOGGING_BOOTSTRAP_FAILED;
 /// Config-only route inventory cannot be projected safely.
 pub(crate) use self::errors::ERROR_CODE_ROUTE_INVENTORY_INVALID;
+/// Exact Start-time Transport resources cannot be reconstructed safely.
+pub(crate) use self::errors::ERROR_CODE_ROUTE_START_PREPARATION_FAILED;
+/// Start request references a stale inventory generation.
+pub(crate) use self::errors::ERROR_CODE_ROUTE_START_STALE_INVENTORY;
+/// Start request references a route that is no longer Configured/applicable.
+pub(crate) use self::errors::ERROR_CODE_ROUTE_START_UNAVAILABLE;
 /// Splash readiness originated from an invalid window.
 pub(crate) use self::errors::ERROR_CODE_SPLASH_ORIGIN_INVALID;
 /// Splash timing configuration is invalid.
@@ -120,6 +135,10 @@ pub(crate) use self::frontend_logging::emit_frontend_log_event;
 pub(crate) use self::logging_runtime::launch_identity;
 /// Rebuilds the complete safe route inventory from validated Config without runtime I/O.
 pub(crate) use self::route_inventory::build_route_inventory;
+/// Rebuilds the route inventory from one already captured Config environment snapshot.
+pub(crate) use self::route_inventory::build_route_inventory_with_environment;
+/// Revalidates one future Start request and reconstructs its exact Transport-owned Worker source contract without launch.
+pub(crate) use self::route_start::validate_route_start;
 /// Command emitted by Rust to the splash frontend.
 pub(crate) use self::splash::SplashOrderDto;
 /// Runtime timings used by the common desk splash lifecycle.