@zerwiz/ymir 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -1,4 +1,46 @@
 
+## 2026-09-17 — 0.1.9: both shapes reach the registry
+
+- **`ymir raise` works on a packaged install.** 0.1.8 shipped before the resolver,
+  so a user who installed from npm hit `cd …/apps/hlidskjalf: No such file or
+  directory` — every package had arrived, and eighteen scripts were looking in the
+  clone's `apps/`. `bin/app-lib.sh` resolves a surface in either shape now.
+- **A clone and a package are one tree to the scripts.** Proven against both: the
+  five surfaces resolve from `/home/zerwiz/Ymir` and from an npm-installed
+  package, and `ymir raise` against a packaged tree fetches the app's
+  dependencies, raises the gate API, starts Nornir cron, and brings up Bifrost and
+  the well.
+- **The patience words** — `style_patience` — open the installer's long chain and
+  the raise path's build, so a long hour says what it is doing.
+
+## 2026-09-17 — both shapes: a clone and an npm install, and the patience words
+
+- **`ymir raise` failed on a packaged install** — and the reason was ours, not
+  npm's. Every package had arrived; the scripts looked for the apps in the clone's
+  `apps/`, where a package keeps nothing. `scripts/start.sh` died on
+  `cd …/apps/hlidskjalf: No such file or directory`. **Eighteen files assumed the
+  clone's layout.**
+- **One resolver, both shapes:** `bin/app-lib.sh` — `apps/<surface>` in a clone,
+  `node_modules/@zerwiz/<package>` in a package, with the surface→package map
+  (`smidja` → `@zerwiz/smidja-factory`). Wired into the raise path, the windows,
+  the invite door, the seat-hall, Eir, the icons, the placement, the hall snapshot
+  and the installer's own SPA and shell steps. `bin/smidja-lib.sh` delegates to it
+  now, so there is one truth about where things live.
+- **Proven in both trees**: all five surfaces resolve from `/home/zerwiz/Ymir`
+  (a clone) and from an npm-installed package. And `ymir raise` run against the
+  packaged tree no longer dies — it fetches the app's dependencies, raises the
+  gate API, **starts Nornir cron**, and brings up Bifrost and the well.
+- **A trap worth naming:** `printf -v <name>` writes to the *function's* scope, so
+  a helper whose scratch variable shares the caller's requested name swallows the
+  answer. Every scratch name in the resolvers is function-prefixed for that
+  reason.
+- **The patience words.** A long install should say what it is doing and why it
+  takes a while. `style_patience` — the cloth's own line — now opens the
+  installer's long chain and the raise path's build:
+  *much moves · the halls are being set right · this hour is long, and nothing of
+  yours is lost in it — roots come home, shapes are re-cut, names are set true
+  again. Your patience is noted, and it is earned.*
+
 ## 2026-09-17 — 0.1.8: the day's work reaches npm
 
 - **The doors.** `ymir` now carries the operator's verbs, each named for the

package/bin/app-lib.sh

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+# app-lib.sh — where an app actually lives.
+#
+# Two installs, one name. In a clone the apps sit at `apps/<surface>` (the
+# registry's `repo: apps/<path>` block clones them there). In a packaged install
+# the tree has no `apps/` at all: each surface arrives as a dependency, at
+# `node_modules/@zerwiz/<package>`.
+#
+#            surface            package
+#            ----------------   ---------------------
+#            hlidskjalf         hlidskjalf
+#            hlidskjalf-mobile  hlidskjalf-mobile
+#            odrerir            odrerir
+#            sessrumnir         sessrumnir
+#            smidja             smidja-factory
+#
+# A surface's name is not always its package's name — and a path is not a name at
+# all. Every script that needs an app resolves it HERE, so the two shapes can
+# never disagree (Rule 07). Source-safe; functions only.
+#
+#   app_dir <surface> <result-var>   the app's directory (empty + exit 1 if absent)
+#   app_pkg <surface>                the npm package name for that surface
+set -u
+
+app_pkg() {  # <surface> → the package name npm serves
+  case "${1-}" in
+    smidja) printf '%s' 'smidja-factory' ;;
+    *)      printf '%s' "${1-}" ;;
+  esac
+}
+
+app_dir() {  # <surface> <result-var> — a clone's apps/<x>, else the package
+  # Scratch names are function-prefixed on purpose: `printf -v <name>` writes to THIS
+  # function's scope, so a scratch variable sharing the caller's requested name
+  # would swallow the answer (a caller asking for "c" or "root" would get nothing).
+  local _apd_surface="${1-}" _apd_rv="${2-}" _apd_root _apd_pkg _apd_c
+  [ -n "$_apd_surface" ] && [ -n "$_apd_rv" ] || return 2
+  _apd_root="${YMIR_ROOT_DIR:-}"
+  if [ -z "$_apd_root" ]; then _apd_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"; fi
+  _apd_pkg="$(app_pkg "$_apd_surface")"
+  for _apd_c in "$_apd_root/apps/$_apd_surface" "$_apd_root/node_modules/@zerwiz/$_apd_pkg"; do
+    [ -d "$_apd_c" ] && { printf -v "$_apd_rv" '%s' "$_apd_c"; return 0; }
+  done
+  printf -v "$_apd_rv" '%s' ""
+  return 1
+}
+
+# Some callers need the directory a mint writes INTO (an app's public/, electron/,
+# dist/…). A packaged app is read-only in spirit, so the clone's apps/ is preferred
+# when it exists; otherwise the package is the only truth there is.
+app_root() {  # <result-var> — where apps live in THIS tree
+  local _apr_rv="${1-}" _apr_root
+  [ -n "$_apr_rv" ] || return 2
+  _apr_root="${YMIR_ROOT_DIR:-}"
+  if [ -z "$_apr_root" ]; then _apr_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"; fi
+  if [ -d "$_apr_root/apps" ]; then printf -v "$_apr_rv" '%s' "$_apr_root/apps"; return 0; fi
+  printf -v "$_apr_rv" '%s' "$_apr_root/node_modules/@zerwiz"
+}

package/bin/design-check.sh

@@ -19,8 +19,19 @@ set -u
 VERSION="1.0.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+# Where an app lives: apps/<surface> in a clone, node_modules/@zerwiz/<pkg> in an
+# npm install — both shapes, one resolver (bin/app-lib.sh).
+if [ -z "${YMIR_APP_LIB_LOADED:-}" ]; then
+  _ya="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yac in "$_ya/app-lib.sh" "$(dirname "$_ya")/bin/app-lib.sh"; do
+    [ -r "$_yac" ] && { . "$_yac"; YMIR_APP_LIB_LOADED=1; break; }
+  done
+  unset _ya _yac
+fi
+app_dir sessrumnir APP_SESSRUMNIR || APP_SESSRUMNIR=""
+
 TOKENS="$ROOT/midgard/design-system/tokens.css"
-SEEDS="$ROOT/apps/sessrumnir/src/renderer/src/themes/fensalir.json"
+SEEDS="$APP_SESSRUMNIR/src/renderer/src/themes/fensalir.json"
 
 case "${1-}" in
   -v|-V|--version) printf '%s\n' "$VERSION"; exit 0 ;;

package/bin/design-icon.sh

@@ -16,6 +16,21 @@ set -u
 VERSION="1.0.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+# Where an app lives: apps/<surface> in a clone, node_modules/@zerwiz/<pkg> in an
+# npm install — both shapes, one resolver (bin/app-lib.sh).
+if [ -z "${YMIR_APP_LIB_LOADED:-}" ]; then
+  _ya="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yac in "$_ya/app-lib.sh" "$(dirname "$_ya")/bin/app-lib.sh"; do
+    [ -r "$_yac" ] && { . "$_yac"; YMIR_APP_LIB_LOADED=1; break; }
+  done
+  unset _ya _yac
+fi
+app_dir hlidskjalf APP_HLIDSKJALF || APP_HLIDSKJALF=""
+app_dir hlidskjalf-mobile APP_HLIDSKJALF_MOBILE || APP_HLIDSKJALF_MOBILE=""
+app_dir odrerir APP_ODRERIR || APP_ODRERIR=""
+app_dir sessrumnir APP_SESSRUMNIR || APP_SESSRUMNIR=""
+app_dir smidja-factory APP_SMIDJA_FACTORY || APP_SMIDJA_FACTORY=""
+
 ICONS="$ROOT/midgard/design-system/icons"
 STONE="#0e0c09"
 

package/bin/desktop-place.sh

@@ -29,6 +29,19 @@ fi
 VERSION="1.0.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+# Where an app lives: apps/<surface> in a clone, node_modules/@zerwiz/<pkg> in an
+# npm install — both shapes, one resolver (bin/app-lib.sh).
+if [ -z "${YMIR_APP_LIB_LOADED:-}" ]; then
+  _ya="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yac in "$_ya/app-lib.sh" "$(dirname "$_ya")/bin/app-lib.sh"; do
+    [ -r "$_yac" ] && { . "$_yac"; YMIR_APP_LIB_LOADED=1; break; }
+  done
+  unset _ya _yac
+fi
+app_dir hlidskjalf APP_HLIDSKJALF || APP_HLIDSKJALF=""
+app_dir sessrumnir APP_SESSRUMNIR || APP_SESSRUMNIR=""
+app_dir odrerir APP_ODRERIR || APP_ODRERIR=""
+
 HYPR_DIR="$HOME/.config/hypr"
 RULE_FILE="$HYPR_DIR/ymir-desktops.lua"
 # The three Ymir surfaces, in the order they should claim desktops.
@@ -46,7 +59,7 @@ CLASS_odrerir="ymir-odrerir"
 # not a branch of this one.
 install_entries() {
   local dst="$HOME/.local/share/applications" n=0
-  local dirs=("$ROOT/apps/hlidskjalf/electron" "$ROOT/apps/sessrumnir/resources" "$ROOT/apps/odrerir/electron")
+  local dirs=("$APP_HLIDSKJALF/electron" "$APP_SESSRUMNIR/resources" "$APP_ODRERIR/electron")
   if [ "$(ymir_os)" != linux ] && [ "$(ymir_os)" != wsl ]; then
     printf 'skip: desktop entries are Omarchy/Linux-shaped; this host is %s\n' "$(ymir_os)" >&2
     return 0

package/bin/eir-doctor.sh

@@ -22,6 +22,17 @@ STATE="${BROKK_STATE_OVERRIDE:-$YMIR_HOME/state}"
 # stdout stay the data (bin/ymir-style.sh).
 if [ -z "${YMIR_STYLE_LOADED:-}" ]; then . "$SCRIPT_DIR/ymir-style.sh"; YMIR_STYLE_LOADED=1; fi
 style_init
+# Where an app lives: apps/<surface> in a clone, node_modules/@zerwiz/<pkg> in an
+# npm install — both shapes, one resolver (bin/app-lib.sh).
+if [ -z "${YMIR_APP_LIB_LOADED:-}" ]; then
+  _ya="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yac in "$_ya/app-lib.sh" "$(dirname "$_ya")/bin/app-lib.sh"; do
+    [ -r "$_yac" ] && { . "$_yac"; YMIR_APP_LIB_LOADED=1; break; }
+  done
+  unset _ya _yac
+fi
+app_dir sessrumnir APP_SESSRUMNIR || APP_SESSRUMNIR=""
+
 
 case "${1-}" in -v|-V|--version) printf '%s\n' "$VERSION"; exit 0 ;; -h|--help|"") sed -n '2,15p' "$0" | sed 's/^# \{0,1\}//'; exit 0 ;; esac
 ACTION="${1:-check}"; shift || true
@@ -154,7 +165,7 @@ detail() { # <name> -> one short fact
     herdr)     "have herdr && herdr --version 2>/dev/null | head -1 || echo 'herdr absent'" ;;
     a2abridge) "have a2abridge && a2abridge --version 2>/dev/null | head -1 || echo 'engine absent'" ;;
     hermes)    "have hermes && echo present || echo absent" ;;
-    sessrumnir)"[ -d $ROOT/apps/sessrumnir/out ] && echo built || echo 'not built'" ;;
+    sessrumnir)"[ -d $APP_SESSRUMNIR/out ] && echo built || echo 'not built'" ;;
     well)      "echo 'engram :4602'" ;;
     mcp)       "echo 'a2abridge + engram'" ;;
     lock)      "cat $STATE/.lock 2>/dev/null | tr -d '[:space:]' | sed 's/^/pid /' || echo none" ;;

package/bin/hall-snapshot.sh

@@ -16,6 +16,17 @@
 #   (the Live Hall's own deck; the merged public site takes it from its build).
 set -u
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Where an app lives: apps/<surface> in a clone, node_modules/@zerwiz/<pkg> in an
+# npm install — both shapes, one resolver (bin/app-lib.sh).
+if [ -z "${YMIR_APP_LIB_LOADED:-}" ]; then
+  _ya="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yac in "$_ya/app-lib.sh" "$(dirname "$_ya")/bin/app-lib.sh"; do
+    [ -r "$_yac" ] && { . "$_yac"; YMIR_APP_LIB_LOADED=1; break; }
+  done
+  unset _ya _yac
+fi
+app_dir odrerir APP_ODRERIR || APP_ODRERIR=""
+
 ROOT="${BROKK_ROOT_OVERRIDE:-$(cd "$SCRIPT_DIR/.." && pwd)}"
 
 # The operator's settings and secrets live in the home they chose, never in the
@@ -37,7 +48,7 @@ hoard_data_dir YMIR_DATA_DIR
 # runtime state belong to the home the operator chose at installation, never in
 # the tree — a packaged install replaces its tree on upgrade (Rule 04).
 STATE="${BROKK_STATE_OVERRIDE:-$YMIR_STATE_DIR}"
-OUT="${1:-$ROOT/apps/odrerir/public/livehall.json}"
+OUT="${1:-$APP_ODRERIR/public/livehall.json}"
 
 runes_file="${BROKK_RUNES_FILE:-${YMIR_HOME:-$HOME/Documents/Ymir}/hodd/memory/runes_audit.md}"
 PROJECTS_FILE="${YMIR_HOME:-$HOME/Documents/Ymir}/hodd/identity/projects.yaml"

package/bin/sessrumnir-ensure.sh

@@ -20,7 +20,18 @@ set -u
 VERSION="1.0.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-APP="$ROOT/apps/sessrumnir"
+# Where an app lives: apps/<surface> in a clone, node_modules/@zerwiz/<pkg> in an
+# npm install — both shapes, one resolver (bin/app-lib.sh).
+if [ -z "${YMIR_APP_LIB_LOADED:-}" ]; then
+  _ya="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yac in "$_ya/app-lib.sh" "$(dirname "$_ya")/bin/app-lib.sh"; do
+    [ -r "$_yac" ] && { . "$_yac"; YMIR_APP_LIB_LOADED=1; break; }
+  done
+  unset _ya _yac
+fi
+app_dir sessrumnir APP_SESSRUMNIR || APP_SESSRUMNIR=""
+
+APP="$APP_SESSRUMNIR"
 
 case "${1-}" in -v|-V|--version) printf '%s\n' "$VERSION"; exit 0 ;; -h|--help|"") sed -n '2,16p' "$0" | sed 's/^# \{0,1\}//'; exit 0 ;; esac
 CMD="${1-}"; shift || true

package/bin/sessrumnir-sync.sh

@@ -24,7 +24,18 @@
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-APP="$ROOT/apps/sessrumnir"
+# Where an app lives: apps/<surface> in a clone, node_modules/@zerwiz/<pkg> in an
+# npm install — both shapes, one resolver (bin/app-lib.sh).
+if [ -z "${YMIR_APP_LIB_LOADED:-}" ]; then
+  _ya="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yac in "$_ya/app-lib.sh" "$(dirname "$_ya")/bin/app-lib.sh"; do
+    [ -r "$_yac" ] && { . "$_yac"; YMIR_APP_LIB_LOADED=1; break; }
+  done
+  unset _ya _yac
+fi
+app_dir sessrumnir APP_SESSRUMNIR || APP_SESSRUMNIR=""
+
+APP="$APP_SESSRUMNIR"
 FORK="$APP/fork"
 UPSTREAM_REPO="${SESSRUMNIR_UPSTREAM:-https://github.com/zerwiz/pi-desktop.git}"
 OWNED_JSON="$FORK/owned.json"

package/bin/sessrumnir.sh

@@ -14,6 +14,17 @@ set -u
 VERSION="1.0.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+# Where an app lives: apps/<surface> in a clone, node_modules/@zerwiz/<pkg> in an
+# npm install — both shapes, one resolver (bin/app-lib.sh).
+if [ -z "${YMIR_APP_LIB_LOADED:-}" ]; then
+  _ya="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yac in "$_ya/app-lib.sh" "$(dirname "$_ya")/bin/app-lib.sh"; do
+    [ -r "$_yac" ] && { . "$_yac"; YMIR_APP_LIB_LOADED=1; break; }
+  done
+  unset _ya _yac
+fi
+app_dir sessrumnir APP_SESSRUMNIR || APP_SESSRUMNIR=""
+
 
 # The roots that live OUTSIDE the code tree: this machine's records and the
 # runtime state belong to the home the operator chose at installation, never in
@@ -27,7 +38,7 @@ if [ -z "${YMIR_HOARD_LIB_LOADED:-}" ]; then
 fi
 hoard_state_dir YMIR_STATE_DIR
 hoard_data_dir YMIR_DATA_DIR
-APP="$ROOT/apps/sessrumnir"
+APP="$APP_SESSRUMNIR"
 PID_FILE="$YMIR_STATE_DIR/sessrumnir.pid"
 LOG_FILE="$YMIR_STATE_DIR/sessrumnir.log"
 

package/bin/smidja-lib.sh

@@ -20,20 +20,21 @@ SMIDJA_SURFACE="smidja"
 SMIDJA_PACKAGE="smidja-factory"
 
 smidja_factory_dir() {  # <result-var> — the smithy's directory, or empty
-  local result_var=${1-} root="${YMIR_ROOT_DIR:-}" c
-  [ -n "$result_var" ] || return 2
-  if [ -z "$root" ]; then
-    root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+  # The general resolver (bin/app-lib.sh) knows both shapes; the smithy is one
+  # surface among them. The old skill symlink is the last resort, and a dangling
+  # one is not a home — the visualizer must be readable there.
+  local _smd_rv=${1-} _smd_c
+  [ -n "$_smd_rv" ] || return 2
+  if [ -z "${YMIR_APP_LIB_LOADED:-}" ]; then
+    local _sl; _sl="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    [ -r "$_sl/app-lib.sh" ] && { . "$_sl/app-lib.sh"; YMIR_APP_LIB_LOADED=1; }
   fi
-  for c in \
-    "$root/apps/$SMIDJA_PACKAGE" \
-    "$root/node_modules/@zerwiz/$SMIDJA_PACKAGE" \
-    "$root/.agents/skills/$SMIDJA_PACKAGE"
-  do
-    # A dangling symlink is not a home: the visualizer must be readable there.
-    [ -d "$c/apps/visualizer" ] && { printf -v "$result_var" '%s' "$c"; return 0; }
-  done
-  printf -v "$result_var" '%s' ""
+  if app_dir smidja _smd_c 2>/dev/null && [ -d "$_smd_c/apps/visualizer" ]; then
+    printf -v "$_smd_rv" '%s' "$_smd_c"; return 0
+  fi
+  _smd_c="${YMIR_ROOT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}/.agents/skills/$SMIDJA_PACKAGE"
+  [ -d "$_smd_c/apps/visualizer" ] && { printf -v "$_smd_rv" '%s' "$_smd_c"; return 0; }
+  printf -v "$_smd_rv" '%s' ""
   return 1
 }
 

package/bin/ymir-install.sh

@@ -53,6 +53,8 @@ hoard_local_env YMIR_ENV_FILE
 # repo (Rule 04).
 # shellcheck source=bin/hoard-lib.sh
 . "$SCRIPT_DIR/hoard-lib.sh"
+# shellcheck source=bin/app-lib.sh
+. "$SCRIPT_DIR/app-lib.sh"
 ymir_home_root YMIR_HOME
 # Where the smithy's parts live: apps/smidja-factory in a clone, or the
 # @zerwiz/smidja-factory package in an npm install (bin/smidja-lib.sh).
@@ -585,7 +587,8 @@ step_smidja() {
 # Hlidskjalf installs with npm (its own lockfile), not bun, and its API serves the
 # UI from ./dist. Without this step a fresh clone has no SPA and no build.
 step_spa() {
-  local app="$ROOT/apps/hlidskjalf"
+  local app; app_dir hlidskjalf app || app=""
+  local app_ok="$app"
   [ -d "$app" ] || { add hlidskjalf SKIP "no apps/hlidskjalf"; return 0; }
   if [ "$CHECK" = 0 ]; then
     if ! have npm; then
@@ -708,8 +711,8 @@ step_desktop() {
   fi
   local shell partial=""
   for shell in hlidskjalf odrerir sessrumnir; do
-    local dir="$ROOT/apps/$shell" d
-    [ -d "$dir" ] || dir="$(cd "$ROOT" && npm root 2>/dev/null)/@zerwiz/$shell"
+    local dir d
+    app_dir "$shell" dir || continue
     d="$(electron_runtime_state "$dir" 2>/dev/null || true)"
     [ "$d" = partial ] && partial="$partial $shell"
   done
@@ -819,6 +822,7 @@ step_panes() {
 
 # Ask before touching the machine; --check only previews and never asks.
 [ "$CHECK" = 0 ] && confirm_install
+[ "$CHECK" = 0 ] && style_patience "the halls are being stood up for the first time"
 
 step_panes; step_prereqs; step_home; step_tree; step_apps; step_engines; step_models; step_hermes; step_sessrumnir; step_backend; step_host; step_sandbox; step_memory; step_smidja; step_spa; step_omarchy; step_loaders; step_gates; step_marks
 # Migrations MOVE private data — that is a write, and `--check` promises none.

package/bin/ymir-invite.sh

@@ -16,8 +16,19 @@
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-MODULE="$ROOT/apps/hlidskjalf/server/accounts.ts"
-STORE="$ROOT/apps/hlidskjalf/server/accounts.ts" # absolute: one definition of an account, wherever this is run from
+# Where an app lives: apps/<surface> in a clone, node_modules/@zerwiz/<pkg> in an
+# npm install — both shapes, one resolver (bin/app-lib.sh).
+if [ -z "${YMIR_APP_LIB_LOADED:-}" ]; then
+  _ya="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yac in "$_ya/app-lib.sh" "$(dirname "$_ya")/bin/app-lib.sh"; do
+    [ -r "$_yac" ] && { . "$_yac"; YMIR_APP_LIB_LOADED=1; break; }
+  done
+  unset _ya _yac
+fi
+app_dir hlidskjalf APP_HLIDSKJALF || APP_HLIDSKJALF=""
+
+MODULE="$APP_HLIDSKJALF/server/accounts.ts"
+STORE="$APP_HLIDSKJALF/server/accounts.ts" # absolute: one definition of an account, wherever this is run from
 
 die() { printf 'ymir-invite: %s\n' "$1" >&2; exit 1; }
 
@@ -25,7 +36,7 @@ command -v bun >/dev/null 2>&1 || die "bun is required (bin/ymir-install.sh inst
 
 # A tiny bun program per action — the module is the single source of truth.
 accounts() {
-  ( cd "$ROOT/apps/hlidskjalf" && bun -e "$1" )
+  ( cd "$APP_HLIDSKJALF" && bun -e "$1" )
 }
 
 [ -f "$MODULE" ] || die "the account store module is missing: $MODULE"

package/bin/ymir-style.sh

@@ -95,6 +95,19 @@ style_line() {  # <state> <name> <detail> — the one line per thing
 
 style_heading() { printf '\n%s%s%s\n' "$C_BRONZE" "$1" "$C_OFF" >&2; }
 
+# For a long hour: say what is happening and why it takes a while. A user who
+# knows the halls are being set right waits; a user watching a silent cursor
+# wonders whether it has broken.
+style_patience() {  # [what is being set right]
+  local what="${1:-the halls are being set right}"
+  printf '\n' >&2
+  style_line DO "much moves" "$what"
+  style_hint "      this hour is long, and nothing of yours is lost in it —"
+  style_hint "      roots come home, shapes are re-cut, names are set true again."
+  style_hint "      Your patience is noted, and it is earned."
+  printf '\n' >&2
+}
+
 # The ending: what stands, then exactly what to type next. Every CLI deserves
 # to leave the operator with the next step and nothing else to guess.
 style_next() {  # one command per line, as "verb — what it does"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerwiz/ymir",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Ymir \u2014 the single-tenant agent operating system. Omarchy-first, host-aware, self-healing.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/zerwiz/ymir",

package/scripts/electron.sh

@@ -26,6 +26,19 @@ fi
 VERSION="1.1.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+# Where an app lives: apps/<surface> in a clone, node_modules/@zerwiz/<pkg> in an
+# npm install — both shapes, one resolver (bin/app-lib.sh).
+if [ -z "${YMIR_APP_LIB_LOADED:-}" ]; then
+  _ya="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yac in "$_ya/app-lib.sh" "$(dirname "$_ya")/bin/app-lib.sh"; do
+    [ -r "$_yac" ] && { . "$_yac"; YMIR_APP_LIB_LOADED=1; break; }
+  done
+  unset _ya _yac
+fi
+app_dir hlidskjalf APP_HLIDSKJALF || APP_HLIDSKJALF=""
+app_dir odrerir APP_ODRERIR || APP_ODRERIR=""
+app_dir sessrumnir APP_SESSRUMNIR || APP_SESSRUMNIR=""
+
 
 # The roots that live OUTSIDE the code tree: this machine's records and the
 # runtime state belong to the home the operator chose at installation, never in
@@ -39,8 +52,8 @@ if [ -z "${YMIR_HOARD_LIB_LOADED:-}" ]; then
 fi
 hoard_state_dir YMIR_STATE_DIR
 hoard_data_dir YMIR_DATA_DIR
-APP="$ROOT/apps/hlidskjalf"
-Odrerir_app="$ROOT/apps/odrerir"
+APP="$APP_HLIDSKJALF"
+Odrerir_app="$APP_ODRERIR"
 NO_INSTALL=0
 VIEW="${YMIR_DESKTOP_VIEW:-hlidskjalf}"
 VIEWS=(hlidskjalf smidja odrerir)

package/scripts/start.sh

@@ -17,6 +17,21 @@ if [ -z "${YMIR_PLATFORM_LOADED:-}" ]; then
 fi
 
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+# The cloth (bin/ymir-style.sh) — colour and words for the human watching.
+if [ -z "${YMIR_STYLE_LOADED:-}" ] && [ -r "$ROOT/bin/ymir-style.sh" ]; then
+  . "$ROOT/bin/ymir-style.sh"; YMIR_STYLE_LOADED=1; style_init
+fi
+# Where an app lives: apps/<surface> in a clone, node_modules/@zerwiz/<pkg> in an
+# npm install — both shapes, one resolver (bin/app-lib.sh).
+if [ -z "${YMIR_APP_LIB_LOADED:-}" ]; then
+  _ya="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yac in "$_ya/app-lib.sh" "$(dirname "$_ya")/bin/app-lib.sh"; do
+    [ -r "$_yac" ] && { . "$_yac"; YMIR_APP_LIB_LOADED=1; break; }
+  done
+  unset _ya _yac
+fi
+app_dir hlidskjalf APP_HLIDSKJALF || APP_HLIDSKJALF=""
+
 # Where the smithy's parts live: apps/smidja-factory in a clone, or the
 # @zerwiz/smidja-factory package in an npm install (bin/smidja-lib.sh).
 if [ -z "${YMIR_SMIDJA_LIB_LOADED:-}" ]; then
@@ -48,7 +63,7 @@ hoard_data_dir YMIR_DATA_DIR
 # The roots that live OUTSIDE the code tree: this machine's records and the
 # runtime state belong to the home the operator chose at installation, never in
 # the tree — a packaged install replaces its tree on upgrade (Rule 04).
-APP="$ROOT/apps/hlidskjalf"
+APP="$APP_HLIDSKJALF"
 RUN="$ROOT/.run"
 PID_FILE="$RUN/hlidskjalf.pid"
 LOG="$RUN/hlidskjalf.log"
@@ -80,7 +95,8 @@ else
 fi
 
 if [[ ! -d "$APP/node_modules" ]]; then
-  echo "Installing dependencies…"
+  style_patience "the seat's own dependencies are being fetched, then the hall is raised"
+echo "Installing dependencies…"
   (cd "$APP" && npm install --no-audit --no-fund)
 fi