This small Node‑JS library provides a single async function `resolveHomeDirTildeByUserPlan` that expands a file‑system path beginning with `~` into the absolute home directory of a planned user, using a “spawn context” to look up the user’s planned home location (and falling back to a default username when none is supplied). It’s intended for developers building the **ubborg** planning tools (e.g., `ubborg-planner-pmb`) who need to resolve tilde‑paths according to a user‑plan rather than the current OS user.