Tutorials

Update a running navigation Graph

Install and remove an optional feature while explicitly handling entries that would become orphaned.

v0.1.0-dev.2Advanced

Update a running navigation Graph

Use a NavigationRuntime when several Sessions must receive the same definition update.

1. Start with the stable Graph

Create Runtime from the application Graph, then create the primary Session through Runtime. The Session still owns its own stack.

2. Install the feature

Call runtime.updateGraph and add the optional Module and Mount through the builder. The complete candidate Graph is validated before any Session changes.

3. Navigate normally

After commit, the new Destination resolves through the same NavigationPort; no generated router interface changes.

4. Choose uninstall behavior

Removing a Module with active entries requires an explicit strategy. RejectActiveNavigationEntries keeps the old Graph. RemoveActiveNavigationEntries closes those entries. MigrateActiveNavigationEntries maps them to compatible typed Targets.

5. Verify every Session

The Runtime commits one validated Graph transaction across Sessions. Failure does not leave different windows using partially updated definitions.

ARKTELOS

Purpose-built engineering systems for software that has to hold.