@spec dry_run(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, map()}

Plan a fork without writing the child Log.

@spec fork(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, map()}

Create a child Session Log from a parent prefix.

@spec fork_root_session_id([Pixir.Event.t()], String.t()) :: String.t()

Resolve the fork-tree root Session id for Provider cache-family routing (ADR 0020).

Returns the root from the first session_fork Event when present; otherwise session_id (a non-fork Session is its own root).

@spec plan(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, map()}

Build a fork plan for CLI dry-run and execution.

@spec replay_types() :: [atom()]

Canonical event types copied into a child fork Log.