@zerwiz/ymir 0.1.9 → 0.1.11

package/bin/ymir.js

@@ -49,6 +49,39 @@ const faint = wrap('38;2;107;98;80');
 const blood = wrap('38;2;194;88;74');
 const bold = wrap('1');
 
+// ── what a user went from, and to ────────────────────────────────────────────
+// `npm install -g` prints "changed 266 packages" and no versions, so an operator
+// cannot see what moved. We can: record the version we last ran, and say the
+// transition once, on the first run after an update.
+const STATE_DIR = process.env.YMIR_STATE_DIR || path.join(process.env.YMIR_HOME || path.join(require('node:os').homedir(), 'Documents', 'Ymir'), 'state');
+function noticeState(key) {
+  try {
+    const s = process.env.YMIR_SETTINGS_DIR
+      || path.join(process.env.YMIR_HOME || path.join(require('node:os').homedir(), 'Documents', 'Ymir'), 'config');
+    const f = path.join(s, 'notices.conf');
+    if (!fs.existsSync(f)) return 'on';
+    const line = fs.readFileSync(f, 'utf8').split('\n').find((l) => l.startsWith(key + '='));
+    return line ? line.slice(key.length + 1).trim() : 'on';
+  } catch { return 'on'; }
+}
+
+function versionNotice() {
+  try {
+    if (noticeState('version') === 'off') return;
+    const f = path.join(STATE_DIR, 'version');
+    const seen = fs.existsSync(f) ? fs.readFileSync(f, 'utf8').trim() : '';
+    if (seen === pkg.version) return;
+    fs.mkdirSync(STATE_DIR, { recursive: true });
+    fs.writeFileSync(f, pkg.version + '\n');
+    if (!seen) return;                       // a first install has nothing to compare
+    process.stderr.write(
+      bone(`  the tree moved  `) + faint(`${seen} → `) + bronze(`${pkg.version}`) + '\n' +
+      faint(`  run \`ymir eir\` to see what stands, \`ymir raise\` to lift the hall\n`) +
+      (noticeState('hints') === 'off' ? '' : faint(`      (not again: ymir config notice version off)\n`)) +
+      '\n');
+  } catch { /* a version notice must never break a door */ }
+}
+
 // ── the doors ────────────────────────────────────────────────────────────────
 // verb → { script, args } — args are prepended to whatever the operator passes,
 // so a verb can be a doorway to a sub-verb of a script that has several.
@@ -64,6 +97,7 @@ const DOORS = {
   hlidskjalf: { script: 'scripts/electron.sh',    about: "the high seat's window", args: ['start', '--view', 'hlidskjalf'] },
   sessrumnir: { script: 'scripts/electron.sh',    about: "the seat-hall's window", args: ['start', '--view', 'sessrumnir'] },
   mimir:      { script: 'bin/mimir.sh',           about: 'the memory well' },
+  config:     { script: 'bin/ymir-config.sh',     about: 'your preferences — which notices are shown (stay silent with `notice <key> off`)' },
   sense:      { script: 'bin/host-sense.sh',      about: 'what THIS machine is' },
   plan:       { script: 'bin/ymir-plan.sh',       about: 'what an install would do here — writes nothing' },
   migrate:    { script: 'bin/ymir-migrate.sh',    about: "heal this home's structure forward (Gr\u00f3a's mend)" },
@@ -108,6 +142,7 @@ function run(script, args) {
 const argv = process.argv.slice(2);
 const first = argv[0];
 
+versionNotice();
 if (!first) run(DOORS.install.script, []);
 if (first === '--version' || first === '-v' || first === '-V') {
   process.stdout.write(`${pkg.version}\n`);

package/midgard/README.md

@@ -0,0 +1,16 @@
+# MIDGARD — Shared Design Assets
+
+Cross-tenant assets that are **public by design**: the design system and the
+shared libraries any realm may pull.
+
+**What does NOT belong here.** Company knowledge — policies, vision, specs,
+client names, wiki pages. That is tenant data, scoped per company, and lives at
+`$YMIR_HOME/hodd/identity/companies/`. This repo is public; a company wiki in it
+would publish that company's internals.
+
+## Contents
+- `design-system/` — shared UI components, design tokens, icon set
+- `shared-packages/` — internal npm/cargo/python libraries (public)
+- `infrastructure/` — shared Terraform / Docker / Kubernetes configs
+- `github_org_repos/` — central repositories
+  - `shared-core-api/` — example shared repo (with `.yggdrasil/` worktrees)

package/midgard/design-system/ember.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Type declarations for the shared hearth (ember.js).
+ *
+ * The implementation is plain JS so any surface — React, Vue, Astro, or a bare
+ * page — can import the same fire. These types keep TypeScript consumers honest
+ * without forcing the module itself into a build step.
+ */
+
+/** Start the hearth on <host> (a canvas, or an element to receive one). Returns a stop function. */
+export function startEmbers(host: Element | null): () => void;
+
+/** Light every element marked `data-ember`. Returns one stop function per hearth. */
+export function startAllEmbers(root?: ParentNode): Array<() => void>;

package/midgard/design-system/ember.js

@@ -0,0 +1,183 @@
+/**
+ * ember.js — the hearth, in one place.
+ *
+ * The fire that warms Sessrúmnir's chat came from the landing page's hero
+ * (Ginnungagap): embers rising slowly with a gentle sway, over a few drifting
+ * haze pools. Sessrúmnir carries a React port; this is the framework-neutral
+ * original, so every surface can share one fire instead of four copies.
+ *
+ *   import { startEmbers } from '.../midgard/design-system/ember.js'
+ *   const stop = startEmbers(document.querySelector('[data-ember]'))
+ *
+ * Or simply mark an element and let it find its own:
+ *
+ *   <canvas data-ember></canvas>
+ *   <script type="module" src="/ember.js"></script>
+ *
+ * It is decorative: the canvas is given `pointer-events: none` and
+ * `aria-hidden`, and a reader who has asked their machine for less motion gets a
+ * still, single-frame hearth instead of an animation.
+ */
+
+const EMBERS = 30;
+const HAZE = 6;
+const EMBER_RGB = '236,166,84';
+const HAZE_RGB = '214,138,64';
+
+/** Draw one still frame — also the whole effect under reduced motion. */
+function paint(ctx, W, H, embers, haze) {
+  ctx.clearRect(0, 0, W, H);
+  for (const ha of haze) {
+    const g = ctx.createRadialGradient(ha.x, ha.y, 0, ha.x, ha.y, ha.r);
+    g.addColorStop(0, `rgba(${HAZE_RGB},0.030)`);
+    g.addColorStop(1, 'rgba(0,0,0,0)');
+    ctx.fillStyle = g;
+    ctx.beginPath();
+    ctx.arc(ha.x, ha.y, ha.r, 0, 6.283);
+    ctx.fill();
+  }
+  for (const e of embers) {
+    ctx.fillStyle = `rgba(${EMBER_RGB},${e.a.toFixed(3)})`;
+    ctx.beginPath();
+    ctx.arc(e.x, e.y, e.r, 0, 6.283);
+    ctx.fill();
+  }
+}
+
+function seed(W, H) {
+  const embers = [];
+  for (let i = 0; i < EMBERS; i++) {
+    embers.push({
+      x: Math.random() * W,
+      y: H + Math.random() * H * 0.3 - 6,
+      r: 1.0 + Math.random() * 1.6,
+      v: 0.14 + Math.random() * 0.34,
+      ph: Math.random() * 6.28,
+      sp: 0.6 + Math.random() * 1.4,
+      a: 0.26,
+    });
+  }
+  const haze = [];
+  for (let i = 0; i < HAZE; i++) {
+    haze.push({ x: Math.random() * W, y: H * 0.3 + Math.random() * H * 0.7, r: 130 + Math.random() * 170, v: (Math.random() - 0.5) * 0.15 });
+  }
+  return { embers, haze };
+}
+
+/**
+ * Start the hearth on <host>. Returns a stop function. Safe to call on a host
+ * that has no box yet (it simply draws nothing until it has one).
+ */
+export function startEmbers(host) {
+  if (!host) return () => {};
+  const canvas = host.tagName === 'CANVAS' ? host : document.createElement('canvas');
+  if (canvas !== host) {
+    canvas.style.position = 'absolute';
+    canvas.style.inset = '0';
+    host.appendChild(canvas);
+  }
+  canvas.setAttribute('aria-hidden', 'true');
+  canvas.style.pointerEvents = 'none';
+
+  const ctx = canvas.getContext('2d');
+  if (!ctx) return () => {};
+
+  const dpr = Math.min(window.devicePixelRatio || 1, 2);
+  let W = 0;
+  let H = 0;
+  let t = 0;
+  let raf = 0;
+  let { embers, haze } = seed(1, 1);
+
+  const reduced = window.matchMedia?.('(prefers-reduced-motion: reduce)').matches === true;
+
+  function size() {
+    const rect = canvas.getBoundingClientRect();
+    W = rect.width || canvas.clientWidth || 0;
+    H = rect.height || canvas.clientHeight || 0;
+    canvas.width = Math.max(1, W * dpr);
+    canvas.height = Math.max(1, H * dpr);
+    ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+  }
+
+  function reseed() {
+    ({ embers, haze } = seed(W, H));
+    if (reduced) {
+      for (const e of embers) e.a = 0.3 + 0.4 * Math.random();
+      paint(ctx, W, H, embers, haze);
+    }
+  }
+
+  function frame() {
+    t += 0.016;
+    for (const ha of haze) {
+      ha.x += ha.v;
+      if (ha.x < -ha.r) ha.x = W + ha.r;
+      if (ha.x > W + ha.r) ha.x = -ha.r;
+    }
+    for (const e of embers) {
+      e.y -= e.v;
+      e.x += Math.sin(t * e.sp + e.ph) * 0.18;
+      if (e.y < -6) {
+        e.y = H + 6;
+        e.x = Math.random() * W;
+      }
+      e.a = 0.26 + 0.4 * (0.5 + 0.5 * Math.sin(t * e.sp * 2 + e.ph));
+    }
+    paint(ctx, W, H, embers, haze);
+  }
+
+  function loop() {
+    frame();
+    raf = requestAnimationFrame(loop);
+  }
+
+  size();
+  reseed();
+  if (!reduced) raf = requestAnimationFrame(loop);
+
+  const onResize = () => {
+    size();
+    reseed();
+  };
+  window.addEventListener('resize', onResize);
+
+  // The hearth warms a *container*, and containers change without a window
+  // resize (a split pane, a toggled sidebar). Watch the host: re-size and
+  // re-seed only when its dimensions actually changed, never per-frame.
+  let ro = null;
+  if (typeof ResizeObserver !== 'undefined' && canvas.parentElement) {
+    const host = canvas.parentElement;
+    let lastW = 0;
+    let lastH = 0;
+    ro = new ResizeObserver((entries) => {
+      const e = entries[0];
+      if (!e) return;
+      const w = e.contentRect?.width ?? e.contentBoxSize?.[0]?.inlineSize ?? 0;
+      const h = e.contentRect?.height ?? e.contentBoxSize?.[0]?.blockSize ?? 0;
+      if (Math.abs(w - lastW) > 0.5 || Math.abs(h - lastH) > 0.5) {
+        lastW = w;
+        lastH = h;
+        onResize();
+      }
+    });
+    ro.observe(host);
+  }
+
+  return () => {
+    if (raf) cancelAnimationFrame(raf);
+    window.removeEventListener('resize', onResize);
+    if (ro) ro.disconnect();
+  };
+}
+
+/** Every element marked `data-ember` lights its own hearth. */
+export function startAllEmbers(root = document) {
+  return Array.from(root.querySelectorAll('[data-ember]')).map(startEmbers);
+}
+
+if (typeof document !== 'undefined') {
+  const boot = () => startAllEmbers();
+  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', boot, { once: true });
+  else boot();
+}

package/midgard/design-system/icons/algiz.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Algiz — Reviews / protection">
+  <title>Algiz — Reviews / protection</title>
+  <path d="M12 20V10 M12 10L5 3 M12 10L19 3" />
+</svg>

package/midgard/design-system/icons/ansuz.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Ansuz — Forge">
+  <title>Ansuz — Forge</title>
+  <path d="M12 4V20 M12 9L7 4 M12 9L17 4" />
+</svg>

package/midgard/design-system/icons/berkana.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Berkanan — Profile">
+  <title>Berkanan — Profile</title>
+  <path d="M9 4V20 M9 4L17 8V14L9 18" />
+</svg>

package/midgard/design-system/icons/dagaz.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Dagaz — Processes">
+  <title>Dagaz — Processes</title>
+  <path d="M5 5L19 19 M19 5L5 19 M5 5V19 M19 5V19" />
+</svg>

package/midgard/design-system/icons/ehwaz.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Ehwaz — Runtime">
+  <title>Ehwaz — Runtime</title>
+  <path d="M4 20V8L12 14L20 8V20" />
+</svg>

package/midgard/design-system/icons/fehu.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Fehu — Fleet">
+  <title>Fehu — Fleet</title>
+  <path d="M12 20V4 M12 8L6 4 M12 8L18 4" />
+</svg>

package/midgard/design-system/icons/gjallarhorn.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Gjallarhorn — tunnel">
+  <title>Gjallarhorn — tunnel</title>
+  <path d="M6 5L18 19 M18 5L6 19" />
+</svg>

package/midgard/design-system/icons/gungnir.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Gungnir — skills">
+  <title>Gungnir — skills</title>
+  <path d="M7 20V4 M7 6L17 12L7 18" />
+</svg>

package/midgard/design-system/icons/heimdall.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Heimdall — auth">
+  <title>Heimdall — auth</title>
+  <path d="M7 4V20 M17 4V20 M7 12H17" />
+</svg>

package/midgard/design-system/icons/ingwaz.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Ingwaz — Well">
+  <title>Ingwaz — Well</title>
+  <path d="M12 4L20 12L12 20L4 12Z" />
+</svg>

package/midgard/design-system/icons/jera.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Jera — Cron">
+  <title>Jera — Cron</title>
+  <path d="M6 20L12 12L6 4 M18 4L12 12L18 20" />
+</svg>

package/midgard/design-system/icons/kaunan.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Kaunan — OmniChat">
+  <title>Kaunan — OmniChat</title>
+  <path d="M18 4L6 12L18 20" />
+</svg>

package/midgard/design-system/icons/midgard.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Midgard — shared">
+  <title>Midgard — shared</title>
+  <path d="M4 12H20 M12 4V20 M6 6L18 18 M18 6L6 18" />
+</svg>

package/midgard/design-system/icons/mimirsbrunn.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Mimirsbrunn — memory">
+  <title>Mimirsbrunn — memory</title>
+  <path d="M12 4L20 12L12 20L4 12Z" />
+</svg>

package/midgard/design-system/icons/othala.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Othala — inheritance, the hall">
+  <title>Othala — inheritance, the hall</title>
+  <path d="M12 4L19 9L12 14L5 9Z M9 12L7 20 M15 12L17 20" />
+</svg>

package/midgard/design-system/icons/raidho.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Raidho — Runes">
+  <title>Raidho — Runes</title>
+  <path d="M8 20V4H14L18 8L14 12H8 M14 12L18 20" />
+</svg>

package/midgard/design-system/icons/ratatoskr.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Ratatoskr — A2A bus">
+  <title>Ratatoskr — A2A bus</title>
+  <path d="M9 4V20 M9 4L17 8V14L9 18" />
+</svg>

package/midgard/design-system/icons/sowilo.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Sowilo — the sun">
+  <title>Sowilo — the sun</title>
+  <path d="M16 4L8 4L16 20L8 20" />
+</svg>

package/midgard/design-system/icons/tiwaz.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Tiwaz — Tasks">
+  <title>Tiwaz — Tasks</title>
+  <path d="M12 20V4 M12 4L6 11 M12 4L18 11" />
+</svg>

package/midgard/design-system/icons/utgard.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Utgard — sandbox">
+  <title>Utgard — sandbox</title>
+  <path d="M8 20V8C8 5 16 5 16 8V20" />
+</svg>

package/midgard/design-system/icons/valhalla.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Valhalla — processes">
+  <title>Valhalla — processes</title>
+  <path d="M7 20V4 M7 4L17 8L7 12" />
+</svg>

package/midgard/design-system/icons/yggdrasil.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="square" stroke-linejoin="miter" role="img" aria-label="Yggdrasil — worktrees">
+  <title>Yggdrasil — worktrees</title>
+  <path d="M6 20L12 12L6 4 M18 4L12 12L18 20" />
+</svg>

package/midgard/design-system/icons.md

@@ -0,0 +1,59 @@
+# Rune-Glyph Icon Map
+
+**Runecoded, not emoji.** Every icon in Ymir is an Elder Futhark rune drawn as a
+24px stroke glyph, colored by `currentColor`. Emoji are never used as icons.
+
+## Set
+
+The glyphs live in `midgard/design-system/icons/*.svg` (24×24 viewBox; render at
+16px or 24px). Stroke uses `currentColor`, square caps, miter joins — the chisel
+bevel. The primary seat may add a 1px inner bevel via the `--ymir-bevel` token.
+
+```
+icons[21]{glyph,name,unicode,figure,used_for}:
+  "fehu","Fehu","ᚠ","Ymir (cattle/wealth)","Fleet — the herd of agents"
+  "tiwaz","Tiwaz","ᛏ","Týr (justice)","Tasks — the A2A lifecycle board"
+  "ingwaz","Ingwaz","ᛜ","Ing (the well)","Well — Mimirsbrunn recall"
+  "raidho","Raidho","ᚱ","ride/journey","Runes — the ledger (a road carved)"
+  "othala","Othala","ᛟ","inheritance, the hall","Sessrúmnir — the seat that holds the cloth"
+  "algiz","Algiz","ᛉ","protection","Reviews / Glitnir — the protective gate; the Ymir emblem"
+  "dagaz","Dagaz","ᛞ","day/dawn","Processes — Valhalla supervision"
+  "sowilo","Sowilo","ᛊ","sun","Files — Skrymir (light on the tree)"
+  "kaunan","Kaunan","ᚴ","torch","OmniChat — Kaia's flame"
+  "ansuz","Ansuz","ᚨ","Odin's breath","Óðrerir — the mead of poetry, the Live Hall"
+  "ehwaz","Ehwaz","ᛖ","horse/journey","Runtime — the seat and its transit"
+  "jera","Jera","ᛃ","year/harvest","Cron — the Nornir's seasons"
+  "berkana","Berkanan","ᛒ","birch","Profile — the self"
+  "midgard","Midgard","—","the shared world","shared workspace / cross-tenant assets"
+  "utgard","Utgard","ᚢ","the outer realm","Utgard — the sandbox barrier"
+  "yggdrasil","Yggdrasil","ᛃ","the world-tree","Yggdrasil — worktrees"
+  "ratatoskr","Ratatoskr","ᛒ","the squirrel","Ratatoskr — the A2A bus"
+  "mimirsbrunn","Mimirsbrunn","ᛜ","the well of wisdom","Mimirsbrunn — memory"
+  "valhalla","Wunjo","ᚹ","joy","Valhalla — process health (the glyph ᚹ is drawn here)"
+  "gungnir","Gungnir","ᚦ","Odin's spear","Gungnir — skill synthesis"
+  "heimdall","Heimdall","ᚺ","the watchman","Heimdall — auth / the gate"
+  "gjallarhorn","Gjallarhorn","ᚷ","the horn","Gjallarhorn — the tunnel and its call"
+```
+
+## Usage
+
+- Reference a glyph as an inline `<svg>` (copy the path) or `<img src>`; stroke
+  with `currentColor`, never a raw hex.
+- Render at **24px** in panels, **16px** inline in tables and chips.
+- A status glyph is always paired with **glyph + colour + text** — never
+  colour-only state.
+- The active realm/accent may tint glyphs via `--realm-tint`.
+
+## Verification
+
+```bash
+ls midgard/design-system/icons/*.svg | wc -l      # 21
+# no emoji used as icons in the UI:
+rg -n "[\x{1F300}-\x{1FAFF}\x{2600}-\x{27BF}]" apps/hlidskjalf/src || echo "no emoji icons"
+```
+
+## Maintaining this
+
+- **Owner:** Brokk. **Tokens:** `midgard/design-system/tokens.css`.
+- Add a rune here and its glyph in `icons/` in the same pass; keep the count in the
+  `icons[N]` block true (Galdr TOON check: `.agents/skills/galdr-ymirsystem/scripts/toon-check.py`).

package/midgard/design-system/runes.md

@@ -0,0 +1,78 @@
+# The Rune Library
+
+**Runecoded, not emoji.** Every icon in Ymir is an Elder Futhark rune drawn as a
+24×24 stroke glyph, coloured by `currentColor` (or the app's house tint). This is
+the library: the full futhark, what each rune means, and where Ymir uses it.
+
+- **Glyphs:** `midgard/design-system/icons/*.svg` (24×24 viewBox, stroke 1.8,
+  square caps, miter joins — the chisel bevel).
+- **Names in code:** the file name is the rune's name, lower-case (`ehwaz.svg`).
+- **Usage rules:** inline `<svg>` or `<img src>`; stroke with `currentColor`,
+  never a raw hex; 24px in panels, 16px inline; a status glyph is always paired
+  with **glyph + colour + text**, never colour alone.
+- **The app runes:** five UI surfaces, five different glyphs — see the foot.
+
+## The futhark
+
+```
+runes[24]{glyph,name,sound,meaning,ymir_use,file}:
+  "ᚠ","Fehu","f","cattle, wealth","Fleet — the herd of agents","fehu"
+  "ᚢ","Uruz","u","aurochs, strength","Utgard — the sandbox barrier","utgard"
+  "ᚦ","Thurisaz","th","thorn, giant","Gungnir — skill synthesis","gungnir"
+  "ᚨ","Ansuz","a","Odin's breath","Óðrerir — the mead of poetry, the Live Hall","ansuz"
+  "ᚱ","Raido","r","ride, journey","Runes — the ledger (a road carved)","raidho"
+  "ᚲ","Kaunan","k","torch, ulcer","Smíðja's eye — the trace of the forge, OmniChat's flame","kaunan"
+  "ᚷ","Gebo","g","gift","Gjallarhorn — the tunnel and its call","gjallarhorn"
+  "ᚹ","Wunjo","w","joy","Valhalla — the hall of the supervisor","valhalla"
+  "ᚺ","Hagall","h","hail","Heimdall — auth, the gate","heimdall"
+  "ᚾ","Naudiz","n","need, constraint","(no glyph yet)","—"
+  "ᛁ","Isaz","i","ice","(no glyph yet)","—"
+  "ᛃ","Jera","j","year, harvest","Nornir — the seasons; Yggdrasil — the world-tree's cycle","jera"
+  "ᛇ","Eihwaz","ï","yew","(no glyph yet)","—"
+  "ᛈ","Perthro","p","lot, fate","(no glyph yet)","—"
+  "ᛉ","Algiz","z","protection","Glitnir's reviews — the protective gate; **the Ymir emblem**","algiz"
+  "ᛊ","Sowilo","s","sun","Skrymir — files (light on the tree)","sowilo"
+  "ᛏ","Tiwaz","t","Týr, justice","Tasks — the A2A lifecycle board","tiwaz"
+  "ᛒ","Berkanan","b","birch","Profile — the self; Ratatoskr — the messenger","berkana"
+  "ᛖ","Ehwaz","e","horse","Runtime — the seat and its transit; Hlidskjalf","ehwaz"
+  "ᛗ","Mannaz","m","man, self","(no glyph yet)","—"
+  "ᛚ","Laguz","l","water, flow","(no glyph yet)","—"
+  "ᛜ","Ingwaz","ng","Ing, the seed","Mimirsbrunn — the well of wisdom","ingwaz"
+  "ᛞ","Dagaz","d","day, dawn","Valhalla — process health","dagaz"
+  "ᛟ","Othala","o","inheritance, estate","(no glyph yet)","—"
+```
+
+**Twenty-one of the twenty-four are drawn; three are not yet:** Naudiz, Isaz,
+Eihwaz, Perthro, Mannaz, Laguz and Othala have no file — add the glyph and its
+row in `icons.md` in the same pass.
+
+**Every file is a rune.** It was not always so: eight files used to be *drawings*
+of the thing they were named after (a hall, a horn, a shield, a spear, a well, a
+squirrel, a gate, a world-tree) while `icons.md` claimed a rune for each. Corrected
+2026-09-16 — Gungnir took Thurisaz, since Gebo was already Gjallarhorn's.
+
+## The app runes
+
+Five UI surfaces, five different glyphs — no app borrows another's rune:
+
+```
+app_runes[5]{app,glyph,rune,house_tint}:
+  "Hlidskjalf","ᛖ","ehwaz — the seat","#c9973f bronze (ymirlabs)"
+  "Hlidskjalf Mobile","ᚱ","raidho — the road, the seat carried","#c9973f bronze"
+  "Óðrerir","ᚨ","ansuz — Odin's breath, the mead of poetry","#c9973f bronze (ymirlabs)"
+  "Sessrúmnir","ᛟ","othala — inheritance, the hall that holds what is kept","#c9973f bronze (ymirlabs)"
+  "Smíðja (visualizer)","ᚲ","kaunan — the torch, the forge's eye","#f59e0b amber (brokkforge)"
+```
+
+Minted and installed by `bin/design-icon.sh` (`list` · `mint --all` · `install`):
+the icon into the user's icon theme, the `.desktop` entry into their applications
+dir, so every app is dockable and carries the house mark.
+
+## Adding a rune
+
+1. Draw it in `icons/<name>.svg` — 24×24, stroke 1.8, square caps, miter joins,
+   `stroke="currentColor"`, a `<title>` naming the rune and its use.
+2. Add its row to `icons.md` **and** to the futhark table above, in the same
+   change. Keep both counts true (the TOON check counts rows).
+3. If an app should wear it, add the app to `bin/design-icon.sh`'s table and run
+   `mint --all && install`.