@zerwiz/ymir 0.1.7 → 0.1.8

package/bin/ymir.js

@@ -1,19 +1,32 @@
 #!/usr/bin/env node
 /**
- * ymir — the CLI the npm package publishes.
+ * ymir — the CLI the npm package publishes, and the operator's front door.
  *
  * It is a thin, honest wrapper: the real work lives in the shell scripts under
- * bin/, which are the same scripts a git clone runs. This file exists because
- * npm needs a Node entry point (`bin: ymir`) and because a package user should
- * not have to know where the checkout landed.
+ * bin/ and scripts/ — the same scripts a git clone runs. This file exists
+ * because npm needs a Node entry point (`bin: ymir`) and because an operator
+ * should never have to know where the package landed.
  *
- *   ymir                 # the same as `ymir install`
- *   ymir install [--yes] # first setup (idempotent, self-healing)
- *   ymir sense           # what THIS machine is
- *   ymir validate        # prove what stands
- *   ymir migrate         # heal an older home forward
+ * The doors are named for the figure whose work they do (the naming law):
+ * Eir heals, Gróa renews, Heimdall keeps the way in, Smíðja is the smithy and
+ * its board, Hlidskjalf the high seat, Sessrúmnir the seat-hall, Mímir the well.
+ *
+ *   ymir                 first setup (the same as `ymir install`)
+ *   ymir install [...]   first setup, idempotent and self-healing
+ *   ymir raise / lower   lift the hall, or lay it down
+ *   ymir eir             what stands, and mend what does not
+ *   ymir groa            take the latest, and mend this home forward
+ *   ymir heimdall        the way in: your credential, and invites
+ *   ymir smidja          the smithy's board (:8437) — build · start · stop · status
+ *   ymir hlidskjalf      the high seat's window
+ *   ymir sessrumnir      the seat-hall's window
+ *   ymir mimir           the memory well
+ *   ymir sense           what THIS machine is
  *   ymir --version
  *
+ * Colour appears only where a human is watching (a TTY, no NO_COLOR); the data
+ * on stdout is always plain TOON.
+ *
  * Exit codes follow the scripts: 0 ok, 1 error, 2 usage.
  */
 'use strict';
@@ -27,32 +40,65 @@ const pkg = (() => {
   try { return require(path.join(ROOT, 'package.json')); } catch { return { version: '0.0.0' }; }
 })();
 
-const TASKS = {
-  install: 'ymir-install.sh',
-  validate: 'ymir-validate.sh',
-  migrate: 'ymir-migrate.sh',
-  sense: 'host-sense.sh',
+// ── the cloth (the same palette as bin/ymir-style.sh, cut from the tokens) ───
+const colour = process.stderr.isTTY && !process.env.NO_COLOR && process.env.TERM !== 'dumb';
+const wrap = (code) => (s) => (colour ? `\u001b[${code}m${s}\u001b[0m` : `${s}`);
+const bone = wrap('38;2;207;195;169');
+const bronze = wrap('38;2;201;151;79');
+const faint = wrap('38;2;107;98;80');
+const blood = wrap('38;2;194;88;74');
+const bold = wrap('1');
+
+// ── 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.
+const DOORS = {
+  install:    { script: 'bin/ymir-install.sh',    about: 'first setup (idempotent, self-healing)' },
+  raise:      { script: 'scripts/start.sh',       about: 'lift the hall — SPA, gate API, Nornir, bridges, the board' },
+  lower:      { script: 'scripts/stop.sh',        about: 'lay the hall down' },
+  eir:        { script: 'bin/eir-doctor.sh',      about: 'diagnose every surface; mend what is broken' },
+  groa:       { script: 'bin/groa-update.sh',     about: 'take the latest, then mend this home forward' },
+  heimdall:   { script: 'bin/ymir-setup-auth.sh', about: 'the way in — your credential (status · set · github)' },
+  invite:     { script: 'bin/ymir-invite.sh',     about: 'let someone else in (mint · list · revoke)' },
+  smidja:     { script: 'bin/smidja-board.sh',    about: "the smithy's board on :8437 (build · start · stop · status)" },
+  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' },
+  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)" },
+  validate:   { script: 'bin/ymir-validate.sh',   about: 'alias of `ymir eir`' },
 };
 
+// Names the law has not given a home are kept for a while, so a muscle memory
+// built yesterday still works — and says what to type instead.
+const RENAMED = { validate: 'eir', auth: 'heimdall', desktop: 'hlidskjalf', doctor: 'eir', update: 'groa' };
+
 function usage() {
-  process.stdout.write(
-    `ymir ${pkg.version} — the single-tenant agent operating system\n\n` +
-    'Usage:\n' +
-    '  ymir                 first setup (same as `ymir install`)\n' +
-    '  ymir install [--yes] first setup, idempotent and self-healing\n' +
-    '  ymir sense           report THIS machine (distro, session, desktop, capabilities)\n' +
-    '  ymir validate        verify the running system\n' +
-    '  ymir migrate         heal an older home forward\n' +
-    '  ymir --version\n\n' +
-    'Output is TOON. The scripts are the source of truth; this CLI only points at them.\n'
-  );
+  const lines = [];
+  lines.push('');
+  lines.push(`  ${bronze('\u16c9')}  ${bold('Ymir')} ${faint(pkg.version)}`);
+  lines.push(`     ${faint('the single-tenant agent operating system')}`);
+  lines.push('');
+  lines.push(bold('  The doors'));
+  for (const [verb, d] of Object.entries(DOORS)) {
+    lines.push(`    ${bronze(verb.padEnd(11))} ${faint(d.about)}`);
+  }
+  lines.push('');
+  lines.push(bold('  Composed by hand'));
+  lines.push(`    ${bronze('ymir groa migrate'.padEnd(11))} ${faint("heal this home's structure (run by groa / install)")}`);
+  lines.push(`    ${bronze('ymir heimdall set'.padEnd(11))} ${faint('set the operator password (or `github`)')}`);
+  lines.push('');
+  lines.push(faint('  A bare `ymir` runs the first setup. Output is TOON; colour only on a TTY.'));
+  lines.push('');
+  process.stdout.write(lines.join('\n') + '\n');
 }
 
 function run(script, args) {
-  const file = path.join(ROOT, 'bin', script);
+  const file = path.join(ROOT, script);
   if (!fs.existsSync(file)) {
-    process.stderr.write(`error: ${path.relative(ROOT, file)} is missing from this install\n`);
-    process.stderr.write('help: reinstall — npm i -g @zerwiz/ymir, or git clone the distro\n');
+    process.stderr.write(`${blood('error:')} ${script} is missing from this install\n`);
+    process.stderr.write(`${faint('help: reinstall — npm i -g @zerwiz/ymir, or git clone the distro')}\n`);
     process.exit(1);
   }
   const r = spawnSync('bash', [file, ...args], { stdio: 'inherit' });
@@ -62,17 +108,19 @@ function run(script, args) {
 const argv = process.argv.slice(2);
 const first = argv[0];
 
-if (!first) run(TASKS.install, []);
+if (!first) run(DOORS.install.script, []);
 if (first === '--version' || first === '-v' || first === '-V') {
   process.stdout.write(`${pkg.version}\n`);
   process.exit(0);
 }
 if (first === '--help' || first === '-h' || first === 'help') { usage(); process.exit(0); }
 
-const script = TASKS[first];
-if (!script) {
-  process.stderr.write(`error: unknown command ${first}\n`);
-  process.stderr.write('help: ymir [install|sense|validate|migrate|--version]\n');
+let door = DOORS[first];
+if (!door) {
+  const replacement = RENAMED[first];
+  process.stderr.write(`${blood('error:')} unknown door ${bold(first)}\n`);
+  if (replacement) process.stderr.write(`${faint(`help: the door is named \`ymir ${replacement}\` now (the naming law — a figure does the work)`)}\n`);
+  process.stderr.write(`${faint('help: `ymir --help` lists every door')}\n`);
   process.exit(2);
 }
-run(script, argv.slice(1));
+run(door.script, [...(door.args || []), ...argv.slice(1)]);

package/docs/design.md

@@ -226,7 +226,7 @@ everywhere; never put bronze text on bronze.
 - **Runecoded, not emoji.** A minimal, hand-drawn-style rune set replaces emoji
   in all UI: 16×16 and 24×24 grid, 2px stroke, chisel bevel on primary.
 - System subsystems each carry one rune-glyph (reuse Algiz-family geometry:
-  Bifrost gate, Ratatoskr squirrel, the Well). Map is in `midgard/design-system/icons.md` (TBD) — created from this doc.
+  Bifrost gate, Ratatoskr squirrel, the Well). Map is in `midgard/design-system/icons.md` and the library in `midgard/design-system/runes.md`.
 - Status dot: filled rune ring (ok) / half-ring (warn) / broken ring (danger), never color-only.
 
 ### 4.5 Surface & texture
@@ -345,7 +345,7 @@ All components read tokens from `tokens.css`; color-only states are forbidden
 
 - `docs/design.md` — this document (master).
 - `midgard/design-system/tokens.css` — the consumable design tokens.
-- `midgard/design-system/icons.md` — rune-glyph map (to create).
+- `midgard/design-system/icons.md` — rune-glyph map (21 glyphs, drawn in `icons/*.svg`).
 - `docs/ymir-rut.md` Part 3 — the original Rut design-system specification this
   document implements.
 - `docs/lore.md` §VI — house lineage behind the house accents.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerwiz/ymir",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "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/start.sh

@@ -17,6 +17,18 @@ if [ -z "${YMIR_PLATFORM_LOADED:-}" ]; then
 fi
 
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+# 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
+  _ys="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yc in "$_ys/smidja-lib.sh" "$(dirname "$_ys")/bin/smidja-lib.sh"; do
+    [ -r "$_yc" ] && { . "$_yc"; YMIR_SMIDJA_LIB_LOADED=1; break; }
+  done
+  unset _ys _yc
+fi
+smidja_visualizer_dir SMIDJA_VIZ
+smidja_factory_dir SMIDJA_FACTORY
+
 
 # The operator's settings and secrets live in the home they chose, never in the
 # code tree — a packaged install replaces its tree on upgrade, and a credential
@@ -116,7 +128,7 @@ fi
 # Smíðja's eye — the Vue trace visualizer (API :8437, UI :8438). Reads the repo's
 # own smidja.db and exposes the Sessions/Trace/Decisions/Stats views behind the
 # Hlidskjalf Sessions gate's "Open visualizer" button.
-VIZ_DIR="$ROOT/.agents/skills/smidja-factory/apps/visualizer"
+VIZ_DIR="${SMIDJA_VIZ:-}"
 VIZ_API_PORT="${SMIDJA_VIZ_API_PORT:-8437}"
 VIZ_UI_PORT="${SMIDJA_VIZ_UI_PORT:-8438}"
 VIZ_API_PID_FILE="$RUN/smidja-viz-api.pid"