feat(rpc): spawn_transitional helper for async lifecycle ops

lfg2025/archy

Introduces a new RPC-layer helper that bridges the synchronous
ContainerOrchestrator trait with RPC handlers that must return in <1s.

The helper flips the package state to a transitional variant
(Stopping / Starting / Restarting) in the StateManager so WebSocket
clients see the live label immediately, then tokio::spawns the
actual orchestrator call. On success it writes the final state; on
error it reverts to the pre-transition state and logs via
install_log().

The ContainerOrchestrator trait stays synchronous so the reconciler,
boot flow, unit tests, and chaos harness keep deterministic
behaviour. Async only lives in the RPC layer.

Not wired to any handler yet — Commit 2 consumes this helper.
Widens install_log visibility from pub(super) to
pub(in crate::api::rpc) so the new sibling module can reach it.

This commit is contained in:

archipelago

2026-04-23 04:55:52 -04:00

parent cad63bdd76

commit 5baced5f5b

4 changed files with 175 additions and 2 deletions

									
										core/archipelago/src/api/rpc/mod.rs
									
		+1
		
												View File
												
				@@ -31,6 +31,7 @@ mod streaming;

				mod system;

				mod tor;

				mod totp;

				mod transitional;

				mod transport;

				mod update;

				mod vpn;