@zerwiz/ymir 0.1.11 → 0.1.13

package/CHANGELOG.md

@@ -1,4 +1,57 @@
 
+## 2026-09-17 — 0.1.13: the re-voiced seat arrives, and the packages are listed
+
+- **`@zerwiz/sessrumnir` 0.1.9** — the seat that says Sessrúmnir and "Brokk is working", with the fork`s name gone from its source, its bundles, its installer and its package identity. Pinned so a fresh install receives it.
+- **The README lists every package** on npm, and why the smithy is `@zerwiz/smidja-factory`.
+
+## 2026-09-17 — the README lists the packages, and the pin moves to the re-voiced seat
+
+- **The README says what is on npm.** Five packages serve — `@zerwiz/ymir` (the
+  distro) and the four surfaces it depends on — and the section says so with a
+  table, plus the one line that matters to a reader: *why the smithy is not
+  `@zerwiz/smiddja`*. That name was accepted twice and served never (package
+  document 404, website 403, republish refused as already published); it was
+  renamed to `@zerwiz/smidja-factory`, which resolves.
+- **The distro's pin moves to `@zerwiz/sessrumnir@0.1.9`** — the seat that speaks
+  its own name rather than the fork's. A fresh install was still receiving the
+  old voice through the `0.1.8-alpha` pin.
+- **`@zerwiz/ymir@0.1.13`** is the packet that carries them.
+
+## 2026-09-17 — 0.1.12: the icons reach the live tree, and a missing surface is a failure
+
+- **The launcher entries name the door** (`Exec=ymir hlidskjalf`, …) instead of an absolute path into whichever tree minted them — the fault that made every icon do nothing.
+- **All three npm shapes resolve**: a clone (`apps/<app>`), a nested package, and a **sibling** package (`<prefix>/lib/node_modules/@zerwiz/<app>`), which is where a global install puts a dependency it hoists out of the distro.
+- **@zerwiz/sessrumnir pinned exact** — a prerelease range resolved in one prefix and was skipped in another.
+- **A missing surface is a FAILURE with the remedy**, never "skipped".
+
+## 2026-09-17 — the icons reach the live tree, and a missing surface is a failure
+
+The Allfather clicked the launcher icons and nothing happened. Both faults were
+mine, and both are the same mistake wearing different clothes: **something named a
+path where it should have named a door.**
+
+- **The entry launched a temp directory.** Every `.desktop` file carried
+  `Exec=bash <the tree that minted it>/scripts/electron.sh …` — and I had minted
+  from `/tmp/opencode/…` while testing, so every icon on his launcher pointed into
+  a scratch tree. Entries now name the **door**: `Exec=ymir hlidskjalf`, resolved
+  from PATH, so a click reaches whichever install is live. A launcher entry must
+  outlive the tree that wrote it.
+- **The fourth surface was missing and the raise shrugged.** `Sessrúmnir — skipped
+  (the sessrumnir surface is not present)` and the raise carried on. It was a
+  **sibling**: npm put it at `<prefix>/lib/node_modules/@zerwiz/sessrumnir`, beside
+  ymir, not inside it. The resolver knew a clone (`apps/<app>`) and a nested
+  package (`<pkg>/node_modules/@zerwiz/<app>`) but not that third shape — which is
+  the one a **global** install uses when it hoists a dependency out of the distro.
+  All three are resolved now, and a surface that is absent is a **FAILURE with the
+  exact remedy**, never a shrug.
+- **A dependency must resolve every time.** `@zerwiz/sessrumnir` was declared as a
+  prerelease range (`^0.1.8-alpha`): npm resolved it in one prefix and skipped it
+  in another. Pinned to the exact version.
+
+Verified from his own install (`~/.npm-global`): Hlidskjalf `:3888`, Óðrerir
+`:4322`, the board `:8437`, the gate API `:3889` (401 — up, auth enforced), Nornir
+cron started, Bifrost and the well up, and the launcher entries naming the doors.
+
 ## 2026-09-17 — 0.1.11: four surfaces, their marks, and a door that mends
 
 - **All four surfaces rise from one npm install** — Hlidskjalf `:3888`, Óðrerir

package/README.md

@@ -700,6 +700,33 @@ when the work will take a while, tells you plainly:
       Your patience is noted, and it is earned.
 ```
 
+### The packages — what is on npm
+
+Six names were published; five serve. The distro **depends on the four
+surfaces**, so one command brings the whole platform — and each can be installed
+alone if you want only that hall.
+
+```
+packages[5]{package,what,live}:
+  "@zerwiz/ymir","the distro — the runtime, the doors, the installer, the plan","0.1.12"
+  "@zerwiz/hlidskjalf","the high seat — the control plane, the gate and the landing","0.1.0"
+  "@zerwiz/odrerir","the live hall — the board on :4322","0.1.0"
+  "@zerwiz/smidja-factory","the smithy — the agent factory, its skills and the visualizer on :8437","0.1.1"
+  "@zerwiz/sessrumnir","the seat-hall — the desktop where you speak with Brokk","0.1.9"
+```
+
+```bash
+npm install -g @zerwiz/ymir          # the distro AND the four surfaces (dependencies)
+npm install -g @zerwiz/hlidskjalf    # or one hall on its own
+```
+
+**Why the smithy's name is not `@zerwiz/smidja`.** It was published under that
+name and the registry accepted it twice — `0.1.0`, then `0.1.1` — while serving
+neither: the package document answered 404, the website 403, and a republish was
+refused as *already published*. The name was retired and the smithy ships as
+**`@zerwiz/smidja-factory`**, which resolves. A second look before publishing
+costs less than explaining a name that never worked.
+
 ### Both shapes — a clone and a package are one tree
 
 Ymir runs the same whether you **cloned** it or **installed** it from npm. The

package/bin/app-lib.sh

@@ -38,7 +38,17 @@ app_dir() {  # <surface> <result-var> — a clone's apps/<x>, else the package
   _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
+  # Three shapes, and npm uses the third more than anyone expects:
+  #   a clone            apps/<surface>
+  #   a nested package   <pkg>/node_modules/@zerwiz/<package>
+  #   a SIBLING package  <prefix>/lib/node_modules/@zerwiz/<package> — beside ymir,
+  #                      where a global install puts a dependency it hoists out
+  # (the sibling is found through dirname, so no parent-climbing path is written)
+  for _apd_c in \
+    "$_apd_root/apps/$_apd_surface" \
+    "$_apd_root/node_modules/@zerwiz/$_apd_pkg" \
+    "$(dirname "$_apd_root")/$_apd_pkg"
+  do
     [ -d "$_apd_c" ] && { printf -v "$_apd_rv" '%s' "$_apd_c"; return 0; }
   done
   printf -v "$_apd_rv" '%s' ""

package/bin/design-icon.sh

@@ -43,11 +43,11 @@ ACTION="${1:-list}"; shift || true
 # dir|glyph|tint|says|icon-name|exec|wm-class
 # FIVE UI surfaces, FIVE DIFFERENT glyphs — no app borrows another's rune.
 APPS=(
-  "apps/hlidskjalf|ehwaz|#c9973f|the seat — Hlidskjalf, the high seat of the control plane|ymir-hlidskjalf|scripts/electron.sh start --view hlidskjalf|ymir-hlidskjalf|Ymir · Hlidskjalf"
-  "apps/hlidskjalf-mobile|raidho|#c9973f|the road — the seat carried, Hlidskjalf on a phone|ymir-hlidskjalf-mobile|scripts/electron.sh start --view hlidskjalf|ymir-hlidskjalf-mobile|Ymir · Hlidskjalf Mobile"
-  "apps/odrerir|ansuz|#c9973f|the mead — Óðrerir, the Live Hall (Odin's breath, inspiration)|ymir-odrerir|scripts/electron.sh start --view odrerir|ymir-odrerir|Ymir · Óðrerir"
-  "apps/sessrumnir|othala|#c9973f|the hall — Sessrúmnir, the seat that holds the cloth|ymir-sessrumnir|bin/sessrumnir.sh start|ymir-sessrumnir|Ymir · Sessrúmnir"
-  "apps/smidja-factory/apps/visualizer|kaunan|#f59e0b|the torch — the forge's eye, Smíðja's trace|ymir-smidja|scripts/electron.sh start --view smidja|ymir-smidja|Ymir · Smíðja"
+  "apps/hlidskjalf|ehwaz|#c9973f|the seat — Hlidskjalf, the high seat of the control plane|ymir-hlidskjalf|ymir hlidskjalf|ymir-hlidskjalf|Ymir · Hlidskjalf"
+  "apps/hlidskjalf-mobile|raidho|#c9973f|the road — the seat carried, Hlidskjalf on a phone|ymir-hlidskjalf-mobile|ymir hlidskjalf|ymir-hlidskjalf-mobile|Ymir · Hlidskjalf Mobile"
+  "apps/odrerir|ansuz|#c9973f|the mead — Óðrerir, the Live Hall (Odin's breath, inspiration)|ymir-odrerir|ymir odrerir|ymir-odrerir|Ymir · Óðrerir"
+  "apps/sessrumnir|othala|#c9973f|the hall — Sessrúmnir, the seat that holds the cloth|ymir-sessrumnir|ymir sessrumnir|ymir-sessrumnir|Ymir · Sessrúmnir"
+  "apps/smidja-factory/apps/visualizer|kaunan|#f59e0b|the torch — the forge's eye, Smíðja's trace|ymir-smidja|ymir smidja|ymir-smidja|Ymir · Smíðja"
 )
 
 list() {
@@ -115,11 +115,11 @@ icons_dir="$data_home/icons/hicolor/scalable/apps"
 apps_dir="$data_home/applications"
 # app | entry name | Exec | StartupWMClass
 ENTRIES=(
-  "hlidskjalf|Ymir · Hlidskjalf|scripts/electron.sh start --view hlidskjalf|ymir-hlidskjalf"
-  "odrerir|Ymir · Óðrerir|scripts/electron.sh start --view odrerir|ymir-odrerir"
-  "sessrumnir|Ymir · Sessrúmnir|bin/sessrumnir.sh start|ymir-sessrumnir"
-  "visualizer|Ymir · Smíðja|scripts/electron.sh start --view smidja|ymir-smidja"
-  "hlidskjalf-mobile|Ymir · Hlidskjalf Mobile|scripts/electron.sh start --view hlidskjalf|ymir-hlidskjalf-mobile"
+  "hlidskjalf|Ymir · Hlidskjalf|ymir hlidskjalf|ymir-hlidskjalf"
+  "odrerir|Ymir · Óðrerir|ymir odrerir|ymir-odrerir"
+  "sessrumnir|Ymir · Sessrúmnir|ymir sessrumnir|ymir-sessrumnir"
+  "visualizer|Ymir · Smíðja|ymir smidja|ymir-smidja"
+  "hlidskjalf-mobile|Ymir · Hlidskjalf Mobile|ymir hlidskjalf|ymir-hlidskjalf-mobile"
 )
 install_all() {
   # A phone app gets an icon for its own bundle, never a desktop entry.
@@ -149,7 +149,10 @@ install_all() {
       printf '[Desktop Entry]\nType=Application\nVersion=1.0\n'
       printf 'Name=%s\n' "$display"
       printf 'Comment=%s\n' "$says"
-      printf 'Exec=bash %s/%s\n' "$ROOT" "$exec"
+      # The door, never a path: a launcher entry outlives the tree that wrote it,
+      # and `ymir <door>` reaches whichever install is live. (The CLI is on PATH
+      # from npm's global bin, and from bin/ in a clone — ymir.js is a bin entry.)
+      printf 'Exec=%s\n' "$exec"
       printf 'Icon=%s\n' "$iconname"
       printf 'Terminal=false\nCategories=Development;Utility;\n'
       printf 'StartupWMClass=%s\nStartupNotify=true\n' "$klass"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerwiz/ymir",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "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",
@@ -62,7 +62,7 @@
   "optionalDependencies": {
     "@zerwiz/hlidskjalf": "^0.1.0",
     "@zerwiz/odrerir": "^0.1.0",
-    "@zerwiz/sessrumnir": "^0.1.8-alpha",
+    "@zerwiz/sessrumnir": "0.1.9",
     "@zerwiz/smidja-factory": "^0.1.0"
   }
 }

package/scripts/start.sh

@@ -108,7 +108,8 @@ if [ -x "$ROOT/bin/sessrumnir.sh" ]; then
       echo "Sessrúmnir — the seat-hall did not rise (run: bin/sessrumnir.sh start)" >&2
     fi
   else
-    echo "Sessrúmnir — skipped (the sessrumnir surface is not present)" >&2
+    echo "Sessrúmnir — NOT raised: the sessrumnir surface is missing from this install" >&2
+    echo "help: npm i -g @zerwiz/ymir (it is a dependency), or from a clone: bin/sessrumnir-ensure.sh install" >&2
   fi
 fi
 
@@ -256,7 +257,8 @@ if [ -n "$HALL_DIR" ] && [ -d "$HALL_DIR" ]; then
     fi
   fi
 else
-  echo "Óðrerir — Live Hall skipped (the odrerir surface is not present)." >&2
+  echo "Óðrerir — NOT raised: the odrerir surface is missing from this install" >&2
+  echo "help: npm i -g @zerwiz/ymir (it is a dependency)" >&2
 fi
 
 cd "$APP"