v0.3.15-pre.008

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: 4
+// version: 5
 
 //! 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_runtime;
 mod route_start;
 mod splash;
 mod tauri;
@@ -57,6 +58,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 by mono-route Store and Worker lifecycle operations.
+pub(crate) use self::constants::TRACING_DOMAIN_ROUTE_RUNTIME;
 /// 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.
@@ -89,6 +92,8 @@ 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 mono-route runtime acknowledgement containing only logical identity and lifecycle.
+pub(crate) use self::dto_route::RawIngestRouteRuntimeDto;
 /// 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.
@@ -111,6 +116,18 @@ 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;
+/// A mono-route Worker runtime already owns the application slot.
+pub(crate) use self::errors::ERROR_CODE_ROUTE_RUNTIME_ACTIVE;
+/// No mono-route Worker runtime is currently active.
+pub(crate) use self::errors::ERROR_CODE_ROUTE_RUNTIME_NOT_ACTIVE;
+/// Store or Worker startup failed after Start-time route revalidation.
+pub(crate) use self::errors::ERROR_CODE_ROUTE_RUNTIME_START_FAILED;
+/// The mono-route runtime reservation/handle state changed unexpectedly.
+pub(crate) use self::errors::ERROR_CODE_ROUTE_RUNTIME_STATE_INVALID;
+/// The opened Store did not prove Ready before Worker launch.
+pub(crate) use self::errors::ERROR_CODE_ROUTE_RUNTIME_STORE_NOT_READY;
+/// The Store could not be reclaimed or explicitly closed after Worker termination.
+pub(crate) use self::errors::ERROR_CODE_ROUTE_RUNTIME_STORE_SHUTDOWN_FAILED;
 /// 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.
@@ -137,6 +154,16 @@ pub(crate) use self::logging_runtime::launch_identity;
 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;
+/// Launch ownership for one mono-route Worker and its caller-owned Store.
+pub(crate) use self::route_runtime::RouteRuntimeLaunch;
+/// Shared mono-route runtime state admitting at most one starting or active Worker.
+pub(crate) use self::route_runtime::RouteRuntimeState;
+/// Opens Store and starts one exact route Worker after Start-time revalidation.
+pub(crate) use self::route_runtime::start_route_runtime;
+/// Fully revalidated Start preparation retaining Store settings and exact Worker resources.
+pub(crate) use self::route_start::PreparedRouteStart;
+/// Revalidates one Start request and retains its backend-only Store/Worker resources.
+pub(crate) use self::route_start::prepare_route_start;
 /// 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.