@zerwiz/ymir 0.1.13 → 0.1.15

package/.agents/state/procevent-inbox/when-odrerir.1.result

@@ -0,0 +1,8 @@
+when: when-odrerir
+status: fired
+detail: the condition held and the action exited 0
+condition_polls: 2
+action_exit: 0
+output:
+eindri-acclaim[1]{agent,detail}:
+  "odrerir","report filed at state/eindri-reports/odrerir.md"

package/.agents/state/procevent-inbox/when-odrerir.2.adapter

@@ -0,0 +1 @@
+when

package/.agents/state/procevent-inbox/when-odrerir.2.result

@@ -0,0 +1,5 @@
+when: when-odrerir
+status: ambiguous
+detail: the action was already claimed but its outcome was never captured; verify its effect manually before retiring
+condition_polls: 0
+output:

package/.agents/state/procevent-inbox/when-odrerir.3.adapter

@@ -0,0 +1 @@
+when

package/.agents/state/procevent-inbox/when-odrerir.3.result

@@ -0,0 +1,5 @@
+when: when-odrerir
+status: ambiguous
+detail: the action was already claimed but its outcome was never captured; verify its effect manually before retiring
+condition_polls: 0
+output:

package/.agents/state/procevent-inbox/when-odrerir.4.adapter

@@ -0,0 +1 @@
+when

package/.agents/state/procevent-inbox/when-odrerir.4.result

@@ -0,0 +1,8 @@
+when: when-odrerir
+status: fired
+detail: the condition held and the action exited 0
+condition_polls: 59
+action_exit: 0
+output:
+eindri-acclaim[1]{agent,detail}:
+  "odrerir","left working (herdr state flipped; read the pane: herdr agent read odrerir)"

package/.agents/state/procevent-inbox/when-odrerir.5.adapter

@@ -0,0 +1 @@
+when

package/.agents/state/procevent-inbox/when-odrerir.5.result

@@ -0,0 +1,8 @@
+when: when-odrerir
+status: fired
+detail: the condition held and the action exited 0
+condition_polls: 110
+action_exit: 0
+output:
+eindri-acclaim[1]{agent,detail}:
+  "odrerir","left working (herdr state flipped; read the pane: herdr agent read odrerir)"

package/.agents/state/procevent-inbox/when-sessrumnir-cloth.1.adapter

@@ -0,0 +1 @@
+when

package/.agents/state/procevent-inbox/when-sessrumnir-cloth.1.result

@@ -0,0 +1,8 @@
+when: when-sessrumnir-cloth
+status: fired
+detail: the condition held and the action exited 0
+condition_polls: 105
+action_exit: 0
+output:
+eindri-acclaim[1]{agent,detail}:
+  "sessrumnir-cloth","left working (herdr state flipped; read the pane: herdr agent read sessrumnir-cloth)"

package/AGENTS.md

@@ -89,7 +89,7 @@ governed[7]{path,load_first}:
   "apps/hlidskjalf/**",".agents/skills/galdr-ymirsystem/assets/hlidskjalf-ui.md"
   "apps/odrerir/**",".agents/skills/galdr-ymirsystem/assets/odrerir-hall.md"
   "bin/mimir*.sh | bin/mimir-bridge.py",".agents/skills/galdr-ymirsystem/assets/memory-well.md"
-  "bin/nornir-* | config/cron.yaml",".agents/skills/galdr-ymirsystem/assets/nornir-jobs.md"
+  "bin/nornir-* | config/cron.yaml*",".agents/skills/galdr-ymirsystem/assets/nornir-jobs.md"
   "bin/valknut-load.sh | .pi/** | .opencode/**",".agents/skills/galdr-ymirsystem/assets/harness-integration/README.md"
   "bin/smidja* | .agents/skills/smidja-factory/**",".agents/skills/galdr-ymirsystem/assets/smidja.md"
 ```
@@ -167,8 +167,8 @@ them may ever be written inside this repo** (see "Private data — YMIR_HOME").
 outputs[7]{kind,path}:
   "Business / strategy","$YMIR_HOME/hodd/identity/companies/"
   "Marketing / social","$YMIR_HOME/hodd/workspaces/marketing/"
-  "Software specs","$YMIR_HOME/hodd/workspaces/development/"
-  "Personal / schedules","$YMIR_HOME/hodd/workspaces/life/"
+  "Software specs","$YMIR_HOME/hodd/workspaces/work/"
+  "Personal / schedules","$YMIR_HOME/hodd/workspaces/personal/"
   "Daily logs","$YMIR_HOME/hodd/memory/daily/YYYY-MM-DD.md"
   "Shared PUBLIC assets","midgard/"
   "Global audit entries","$YMIR_HOME/hodd/memory/runes_audit.md"
@@ -207,7 +207,7 @@ isolation[8]{id,rule}:
 - Redis pub/sub is the queue *under* the A2A task model (A2A = semantics, Redis =
   throughput). Messages follow `.agents/bus/protocol.ts`.
 - Every A2A message is observed into **Mimirsbrunn** and logged to **Runes**.
-- **Status:** the native backbone is **planned, not built** — the plan is private at `hodd/docs/ratatoskr.md`. Today an external `a2abridge` daemon (A2A + MCP over Tailscale) is what runs; `.agents/bus/` is a stub. Way of Teams (`~/CodeP/wayofteams`) is the sold control plane; Ymir's daemon must also work standalone.
+- **Status:** the native backbone is **planned, not built** — the plan is private at `memory/plans/mesh/25-ratatoskr-a2a.md` (in `$YMIR_HOME`). Today an external `a2abridge` daemon (A2A + MCP over Tailscale) is what runs; `.agents/bus/` is a stub. Way of Teams (`~/CodeP/wayofteams`) is the sold control plane; Ymir's daemon must also work standalone.
 - Kaia orchestrates: dispatch Eindri as A2A tasks, recall memory before dispatch,
   honour the anti-hallucination gate; specialists reach tools via MCP.
 
@@ -389,21 +389,28 @@ env-driven, **never** in this repo. The real layout:
 
 ```
 YMIR_HOME/                          ← private git repo (pushed to the user's private GitHub)
+├── README.md / AGENTS.md           # home map + the private home contract
 ├── hodd/                           ← THE HOARD: all private data lives under here
-│   ├── identity/                   # projects.yaml, workspaces.yaml, companies/, realms
 │   ├── data/                       # operator, fleet, machines, inventories
-│   ├── docs/                       # masterplan, plans/, runbooks, incidents
+│   ├── docs/                       # masterplan.md, business/, daily/, server-knowledge/
+│   ├── identity/                   # companies/, realms, entity cards
+│   ├── memory/                     # well, daily logs, runes audit ledger
+│   ├── plans/                      # live working plans
 │   ├── secrets/                    # platform.env.age + age.key (the vault)
-│   ├── tenants/                    # per-tenant private trees
-│   └── memory/                     # well, daily logs, audit ledger
+│   ├── state/                      # runtime state; stale-* backups
+│   └── workspaces/                 # marketing/ · personal/ · work/
+├── memory/plans/<domain>/          # plan archive, domain-sorted (tracked)
 ├── config/                         # agents.yaml and per-machine overlays
-├── memory/                         # the live engram (kaia.engram)
 ├── state/                          # runtime state (ephemeral)
 ├── smidja/                         # factory databases (ephemeral)
-├── workspaces/                     # work/, personal/, companies/
 └── svartalfaheim/                  # per-realm scoped material
 ```
 
+> 2026-09-17: the home was re-laid out — plans moved from `hodd/docs/plans/`
+> to `memory/plans/<domain>/`, workspaces moved under `hodd/workspaces/`, and
+> dropped-from-git material rests in `hodd/state/stale-*`. The hodd example
+> (`hodd/AGENTS.example.md`) teaches the shape.
+
 `$YMIR_HOME/hodd/` **is** the private data path — there is no second, flat copy.
 `bin/hoard-lib.sh` resolves it (`hoard_root`), and it is the single source of
 truth: a script that needs the hoard calls it, never a hardcoded path.

package/CHANGELOG.md

@@ -1,4 +1,132 @@
 
+
+## 2026-09-17 — the npm door stands the surfaces
+
+- **`@zerwiz/ymir` now depends on its surfaces**: `@zerwiz/{hlidskjalf,
+  odrerir, sessrumnir, smidja-factory}` are declared dependencies (bump
+  `0.1.14` → `0.1.15`), so `npm i -g @zerwiz/ymir` (or a packaged install)
+  delivers the app shells under `node_modules/@zerwiz/*`, which `app-lib`
+  resolves. The audit's one gap — the platform carried no apps — is closed.
+- **`@zerwiz/smidja-factory` `0.1.1` → `0.1.2`**: the visualizer's nanoid fix
+  and the eye's-home SKILL line reach npm.
+
+## 2026-09-17 — the seat's name and the visualizer's home
+
+- **omarchy, not omarchy-1** — the machine is `omarchy`; the fleet config docs
+  and the tailscale-sync map say so.
+- **The Smíðja visualizer's home is the smidja repo clone** —
+  `apps/smidja-factory/apps/visualizer`; the skill tree carries no copy (the
+  stale build was moved aside). `smidja.md` (the governed asset), the smithy
+  SKILL, and the install asset all point at the clone.
+
+## 2026-09-17 — the layout swept: every reader taught the new doors
+
+- **bin/nornir-job-observer.sh** — masterplan, runes ledger, and the well now
+  resolve to the hoard homes (`hodd/docs/masterplan.md`,
+  `hodd/memory/runes_audit.md`, `hodd/memory/well`), overridable via
+  `BROKK_MASTERPLAN`/`BROKK_WELL_DIR`.
+- **bin/saga-session-start.sh** — the Sága digest's open-orders read follows
+  the home (`hodd/docs/masterplan.md`).
+- **bin/nornir-job-daily-briefing.sh** — message/comment paths updated to the
+  same doors.
+- **bin/docs-guard.sh** — block message names both new homes (hodd/docs,
+  memory/plans).
+- **.agents/agents/{brokk,forseti-reviewer,mimir-planner}.md** — the plan
+  shelf, masterplan, and append-only log pointers moved to their hoard
+  homes (`memory/plans/<domain>/`, `hodd/docs/*`).
+- **.agents/skills/{tyr-check,ymir-host,ratatoskr-a2a}/SKILL.md** — the same
+  pointers, plus the Ratatoskr spec → `memory/plans/mesh/25-ratatoskr-a2a.md`
+  and `hodd/docs/a2a-runs.md`.
+- **docs/workspaces.md** — status note: workspaces settled under
+  `hodd/workspaces/` (2026-09-17).
+
+## 2026-09-17 — the home's re-laid layout taught to the system
+
+- **The layout changed (2026-09-17):** plans filed by domain under
+  `$YMIR_HOME/memory/plans/<domain>/`, live plans in `hodd/plans/`,
+  workspaces under `hodd/workspaces/`, dropped-from-git material in
+  `hodd/state/stale-*`. The hodd example (`hodd/AGENTS.example.md`) now
+  teaches the new shape.
+- **AGENTS.md** — the private-home tree block, the outputs table
+  (`hodd/workspaces/work/`, `hodd/workspaces/personal/`), and the Ratatoskr
+  plan pointer updated to the new homes.
+- **bin/nornir-job-daily-briefing.sh** — the morning brief's masterplan and
+  plan-status reads follow the new layout (`hodd/docs/masterplan.md`,
+  `memory/plans`) with `BROKK_MASTERPLAN`/`BROKK_PLANS_DIR` overrides.
+
+## 2026-09-17 — the installer has a design of its own
+
+- **The result is rendered, not dumped.** The plan got the cloth and the install did not: twenty-nine raw TOON rows and a poem, which the Allfather rightly called zero design. Now the same rows are rendered for the eye on stderr — a rule, a verdict (*"it stands — 22 steps done · 7 warned · 1 skipped"*), every warning with its reason, and the skips in one line. The TOON stays the data on stdout; the design is for the person.
+- **The consent shows the plan again.** `--colour` renders on stderr and I had sent *both* streams to `/dev/null`, so the plan was invisible at the very moment it was being accepted.
+- **The seat can mend its own runtime**, and says why when it cannot — npm gates Electron postinstall, so a fresh install otherwise ends with a window that cannot open.
+
+
+## 2026-09-17 — one well, in the hoard: every reader of Kaia's memory resolves the hoard store
+
+- **The memory is ONE store and it lives in the hoard** —
+  `$YMIR_HOME/hodd/memory/kaia.engram` — never in the tree, never in a
+  migrated copy. `bin/hoard-lib.sh` gains `hoard_memory_store` (the one
+  resolver); every reader honors it or an explicit `ENGRAM_DB`:
+  `mimir-bridge.sh`/`mimir-bridge.py`, `mimir-reflect.sh`, `a2a-mcp.sh`,
+  `ymir-install.sh` step_memory, and the rendered `.pi/mcp.json.example`
+  (`__YMIR_HOME__/hodd/memory/kaia.engram`).
+- **The duplicate is dead.** The old store (`$YMIR_HOME/memory/kaia.engram`,
+  plus the migration seed copy) is struck from this machine and the vault;
+  its 8 episodes were seeded into the hoard store first. The public ymir
+  repo's `.agents/memory/kaia.engram*` leftovers are deleted (already guarded
+  by `.gitignore`) and the 0003 migration now copies INTO the hoard.
+- The Allfather's decision, accepted and recorded everywhere: the well must
+  travel between his computers, so it rides the private vault as one store.
+
+galdr-reread: `.agents/skills/galdr-ymirsystem/assets/memory-well.md` — the
+Store row, MCP command, law #4, and the Python recipe now name the hoard path.
+
+## 2026-09-17 — the local git round joins the loom; the stack's doors are in the registry
+
+- **`bin/nornir-job-forgejo-git.sh` (02:45)** — reads the local forge's open
+  issues each night (`$YMIR_HOME/config/forge.env` names the door; token
+  optional), writes a daily digest to the hoard, carves Rune
+  `forgejo / git.issues` — or `git.door-down` (exit 1) when the tunnel is
+  closed, so a dead door is seen at sunrise. Unarmed without a URL, honestly.
+- **The marketing stack's doors are now in the registry** —
+  `marketing_doors[6]` (Mautic · Postiz · Activepieces · Forgejo · SearXNG ·
+  Grafana) with reach notes, mirrored to the Galdr asset. Agents (Bragi ·
+  Sindri) provision the stack for any user via
+  `bin/ymir-marketing-stack.sh`, or reach the Allfather's live server stack.
+
+galdr-reread: `.agents/skills/galdr-ymirsystem/assets/nornir-jobs.md` — §3.7
+(Forgejo round) and §3.8 (marketing stack provisioner); registry mirrored.
+
+## 2026-09-17 — the schedule is the user's: cron leaves the tree, lives in the home
+
+- **The tracked tree no longer carries the live cron schedule.** The Nornir
+  scheduler now resolves the schedule in this order: `BROKK_CONFIG_OVERRIDE`
+  (explicit) → **the home's own `$YMIR_HOME/config/cron.yaml`** (users set
+  their jobs there) → the repo's `config/cron.yaml.example` (a template, never
+  the live list). `bin/nornir-cron-start.sh` resolves the home through
+  `bin/hoard-lib.sh`, the one answer the whole runtime shares.
+- `config/cron.yaml` → `config/cron.yaml.example` (the tracked template stays;
+  the live schedule lives in the operator's home).
+- **The marketing stack can be provisioned on any computer** —
+  `bin/ymir-marketing-stack.sh up|status|down|doors` stands Mautic + Postiz +
+  Activepieces (+ optionally Forgejo) from the same OSS engines the server
+  runs, env-driven, ports virtualized, secrets generated once into the home
+  (never inline); agents (Bragi · Sindri) provision it for any user.
+- **Bragi's scrape round, honest to Firecrawl** — `bin/nornir-job-bragi-scrape.sh`
+  reads the operator's `config/scrape-sources.yaml` and scrapes with the real
+  Firecrawl SDK (scrape/search + markdown, BYOK key from the home's secrets),
+  landing clean markdown in the marketing workspace and carving a Rune.
+
+galdr-reread: `.agents/skills/galdr-ymirsystem/assets/nornir-jobs.md` — §2
+rewritten (the schedule is the user's; example template; the four-inputs
+contract unchanged).
+
+## 2026-09-17 — 0.1.14: the panels reach the gate, and the fourth window ships
+
+- **`@zerwiz/hlidskjalf` 0.1.1** — the package now declares its own `name`, `files` and the absence of `private`, and ships **`vite.config.ts`**. Without that config a packaged SPA is served by `vite preview` with **no `/api` proxy**, so every panel answered `index.html` and died on `Unexpected token '<'<`. That was the whole panel fault.
+- **`@zerwiz/odrerir` 0.1.1** — ships its **`electron/`** half, so the fourth hall can have a window; its name is `@zerwiz/odrerir` and it is no longer marked private (npm refuses those, EPRIVATE).
+- Both apps declared what ships **in their own repos**, instead of a manifest rewritten at publish time — which is how the wrong things shipped in the first place.
+
 ## 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.
@@ -17,6 +145,7 @@
   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.

package/bin/a2a-mcp.sh

@@ -36,8 +36,15 @@ if [ "$PROJECT" = 1 ]; then PI_MCP="$ROOT/.pi/mcp.json"; else PI_MCP="$HOME/.pi/
 
 WOTES="$(command -v wayofteams-mcp 2>/dev/null || true)"
 ENGRAM_BIN="${ENGRAM_BIN:-$HOME/.local/bin/engram-mcp}"
-YMIR_HOME="${YMIR_HOME:-$HOME/Documents/Ymir}"
-ENGRAM_DB="${ENGRAM_DB:-$YMIR_HOME/memory/kaia.engram}"
+# The well is ONE memory and it lives in the hoard — always. An explicit
+# ENGRAM_DB is the operator's escape hatch; without it the hoard decides.
+if [ -n "${ENGRAM_DB:-}" ]; then
+  ENGRAM_DB_ABS="$ENGRAM_DB"
+else
+  . "$SCRIPT_DIR/hoard-lib.sh" 2>/dev/null || true
+  hoard_memory_store ENGRAM_DB_ABS
+fi
+ENGRAM_DB="$ENGRAM_DB_ABS"
 
 # The Teams plane (WayOfTeams) and Anchor memory are REMOTE MCP servers, named by
 # URL. The URL is credential-ish, so it comes from the environment — never the

package/bin/app-lib.sh

@@ -49,7 +49,14 @@ app_dir() {  # <surface> <result-var> — a clone's apps/<x>, else the package
     "$_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; }
+    # A hollow directory is not an app. An install step used to `mkdir` — or a
+    # clone used to fail — leaving `apps/<name>` empty, and that empty shell
+    # shadowed the real package beside it until the SPA could not be served and
+    # nobody knew why. An app declares itself: a manifest, a build, or sources.
+    if [ -d "$_apd_c" ] \
+       && { [ -f "$_apd_c/package.json" ] || [ -d "$_apd_c/dist" ] || [ -d "$_apd_c/src" ]; }; then
+      printf -v "$_apd_rv" '%s' "$_apd_c"; return 0
+    fi
   done
   printf -v "$_apd_rv" '%s' ""
   return 1

package/bin/docs-guard.sh

@@ -35,5 +35,5 @@ if [ "${1:-}" = "--all" ]; then
   scan_list < <(git -C "$ROOT" ls-files)
 else
   scan_list < <(git -C "$ROOT" diff --cached --name-only --diff-filter=ACM)
-fi || { printf 'docs-guard: blocked — docs/ is public; move it to $YMIR_HOME/hodd/docs/ (Rule 04)\n' >&2; exit 1; }
+fi || { printf 'docs-guard: blocked — docs/ is public; move it to $YMIR_HOME/hodd/docs/ (or $YMIR_HOME/memory/plans/ for plans) (Rule 04)\n' >&2; exit 1; }
 exit 0

package/bin/erindi-brief.sh

@@ -6,7 +6,7 @@
 # readable "Delivery contract: mode=<mode>" line, the worktree-isolation
 # assertion, the status protocol, and the steering-inbox receive/ack section.
 # Ported from the upstream distro brief scaffold for plan 29
-# (docs/plans/29-brokk-distro-runtime.md).
+# (memory/plans/core/29-brokk-distro-runtime.md).
 #
 # Usage:
 #   erindi-brief.sh <task-id> <repo-name> --mode <no-mistakes|direct-PR|local-only>

package/bin/hamr-harness.sh

@@ -5,7 +5,7 @@
 # runtime the process tree is wearing so Brokk can choose the correct adapter,
 # launch flags, and dispatch profile. Ported from the upstream agent-distro
 # reference (bin/hamr-harness.sh) and retargeted to the Brokk runtime
-# (docs/plans/29-brokk-distro-runtime.md).
+# (memory/plans/core/29-brokk-distro-runtime.md).
 #
 # Usage:
 #   hamr-harness.sh                 print own harness:

package/bin/hoard-lib.sh

@@ -103,3 +103,13 @@ hoard_local_env() {  # <result-var> — the operator's env file (secrets, ports)
   ymir_home_root home
   printf -v "$result_var" '%s' "${YMIR_ENV_FILE:-$home/.env.local}"
 }
+
+hoard_memory_store() {  # <result-var> — Kaia's engram store, ALWAYS in the hoard
+  # The well is one memory and it lives in the hoard (hodd/memory) — never in
+  # the tree, never in a migrated copy. Everything that reads the store resolves
+  # through here so no script can point the well at a duplicate (Rule 04/07).
+  local result_var=${1-} home
+  [ -n "$result_var" ] || return 2
+  ymir_home_root home
+  printf -v "$result_var" '%s' "$home/hodd/memory/kaia.engram"
+}

package/bin/mimir-bridge.py

@@ -29,7 +29,14 @@ from pathlib import Path
 from urllib.parse import parse_qs, urlparse
 
 ROOT = Path(__file__).resolve().parent.parent
-STORE = Path(os.environ.get("ENGRAM_DB", str(ROOT / ".agents/memory/kaia.engram")))
+# The well is ONE memory and it lives in the hoard — never in the tree and
+# never in a migrated copy. The shell bridge passes ENGRAM_DB; this default
+# (hoard | legacy-local) keeps a hand-started bridge honest either way.
+_home = Path(os.environ.get("YMIR_HOME", str(Path.home() / "Documents/Ymir")))
+STORE = Path(os.environ.get(
+    "ENGRAM_DB",
+    str(_home / "hodd/memory/kaia.engram")
+)).expanduser()
 HOST = os.environ.get("MIMIRSBRUNN_HOST", "127.0.0.1")
 PORT = int(os.environ.get("MIMIRSBRUNN_PORT", os.environ.get("ENGRAM_PORT", "4602")))
 DEFAULT_AGENT = os.environ.get("ENGRAM_AGENT_ID", "kaia")

package/bin/mimir-bridge.sh

@@ -33,7 +33,13 @@ hoard_state_dir YMIR_STATE_DIR
 hoard_data_dir YMIR_DATA_DIR
 YMIR_HOME="${YMIR_HOME:-$HOME/Documents/Ymir}"
 BRIDGE="$ROOT/bin/mimir-bridge.py"
-DB="${ENGRAM_DB:-$YMIR_HOME/memory/kaia.engram}"
+# The well is ONE memory and it lives in the hoard — always. An explicit
+# ENGRAM_DB is the operator's escape hatch; without it the hoard decides.
+if [ -n "${ENGRAM_DB:-}" ]; then
+  DB="$ENGRAM_DB"
+else
+  hoard_memory_store DB
+fi
 PORT="${MIMIRSBRUNN_PORT:-4602}"
 PID_FILE="${YMIR_STATE_DIR:-$YMIR_HOME/state}/mimir-bridge.pid"
 LOG_FILE="${YMIR_STATE_DIR:-$YMIR_HOME/state}/mimir-bridge.log"

package/bin/mimir-reflect.sh

@@ -11,7 +11,14 @@
 #   YMIR_ROUTER_URL=http://127.0.0.1:8080/v1 YMIR_REFLECT_MODEL=qwen3.6-35b-a3b bin/mimir-reflect.sh
 set -euo pipefail
 
-WELL="${YMIR_WELL:-${YMIR_HOME:-$HOME/Documents/Ymir}/memory/kaia.engram}"
+# The well is ONE memory and it lives in the hoard — always (Rule 04/07).
+# An explicit YMIR_WELL/ENGRAM_DB is the operator's escape hatch.
+if [ -n "${YMIR_WELL:-}" ] || [ -n "${ENGRAM_DB:-}" ]; then
+  WELL="${YMIR_WELL:-${ENGRAM_DB:-}}"
+else
+  . "$SCRIPT_DIR/hoard-lib.sh" 2>/dev/null || true
+  hoard_memory_store WELL
+fi
 BASE="${YMIR_ROUTER_URL:-http://127.0.0.1:1234/v1}"
 MODEL="${YMIR_REFLECT_MODEL:-apodex-1.0-mini}"
 

package/bin/nornir-cron-start.sh

@@ -34,8 +34,28 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 ROOT="${BROKK_ROOT_OVERRIDE:-$(cd "$SCRIPT_DIR/.." && pwd)}"
 BROKK_HOME="${BROKK_HOME:-$ROOT}"
 STATE="${BROKK_STATE_OVERRIDE:-$BROKK_HOME/state}"
-CONFIG="${BROKK_CONFIG_OVERRIDE:-$BROKK_HOME/config}"
+# The schedule is the USER'S, not the distro's: an explicit BROKK_CONFIG_OVERRIDE
+# wins, then the home's own config/cron.yaml, then the repo's example (which
+# ships what a fresh hour suggests but never claims to be the live schedule).
+if [ -n "${BROKK_CONFIG_OVERRIDE:-}" ]; then
+  CONFIG="$BROKK_CONFIG_OVERRIDE"
+else
+  . "$SCRIPT_DIR/hoard-lib.sh"  # ymir_home_root — one answer, never drift
+  ymir_home_root _h
+  if [ -r "$_h/config/cron.yaml" ]; then
+    CONFIG="$_h/config"
+  elif [ -r "$BROKK_HOME/config/cron.yaml" ] && [ "$BROKK_HOME" != "$_h" ]; then
+    CONFIG="$BROKK_HOME/config"
+  else
+    CONFIG="$BROKK_HOME/config"
+  fi
+fi
 CRON_CONFIG="$CONFIG/cron.yaml"
+# Fall back to the shipped example ONLY when no user schedule exists yet — the
+# example is a template, never the live job list.
+if [ ! -r "$CRON_CONFIG" ] && [ -r "$BROKK_HOME/config/cron.yaml.example" ]; then
+  CRON_CONFIG="$BROKK_HOME/config/cron.yaml.example"
+fi
 PID_FILE="$STATE/cron.pid"
 LOG_FILE="$STATE/cron.log"
 STAMP_DIR="$STATE/.cron-fired"

package/bin/nornir-job-bragi-scrape.sh

@@ -0,0 +1,116 @@
+#!/usr/bin/env bash
+# nornir-job-bragi-scrape.sh — Bragi, on the loom: the scheduled scrape round.
+#
+# Reads a list of sources from the USER'S home (never the tree) and scrapes
+# each with Firecrawl into clean markdown, landed in the marketing workspace.
+# The source list is the operator's:  $YMIR_HOME/config/scrape-sources.yaml
+#
+#   format:
+#     sources:
+#       - name: monster-stack
+#         url: https://example.com/docs
+#         kind: scrape|search        # default scrape
+#         note: why this source matters
+#
+# Firecrawl is BYOK: FIRECRAWL_API_KEY comes from the home's platform.env
+# (bin/hodd.sh emit), never inline. A missing key is reported, not faked — the
+# job is honest about what it could not do.
+#
+# Stateless: read sources → scrape → write markdown under the marketing
+# workspace → carve one Rune → exit.
+set -u
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="${BROKK_ROOT_OVERRIDE:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+
+# The home the operator chose — one answer, never drift (Rule 04/07).
+if [ -z "${YMIR_HOARD_LIB_LOADED:-}" ]; then
+  _yr="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  for _yc in "$_yr/hoard-lib.sh" "$(dirname "$_yr")/bin/hoard-lib.sh"; do
+    [ -r "$_yc" ] && { . "$_yc"; YMIR_HOARD_LIB_LOADED=1; break; }
+  done
+  unset _yr _yc
+fi
+hoard_root _HOME
+hoard_data_dir _DATA
+
+SOURCES="${BROKK_SCRAPE_SOURCES:-$_HOME/config/scrape-sources.yaml}"
+OUT_DIR="${BROKK_SCRAPE_OUT:-$_HOME/workspaces/marketing/scraped}"
+mkdir -p "$OUT_DIR"
+
+# Firecrawl key: from the home's secrets, by path — never inline.
+FIRECRAWL_API_KEY="${FIRECRAWL_API_KEY:-}"
+if [ -z "$FIRECRAWL_API_KEY" ] && [ -x "$ROOT/bin/hodd.sh" ]; then
+  FIRECRAWL_API_KEY="$("$ROOT/bin/hodd.sh" emit secrets/platform.env 2>/dev/null | grep -m1 '^FIRECRAWL_API_KEY=' | cut -d= -f2-)"
+fi
+
+[ -r "$SOURCES" ] || {
+  printf 'bragi-scrape: no sources at %s — nothing scheduled to scrape (exit 0)\n' "$SOURCES"
+  exit 0
+}
+
+command -v python3 >/dev/null 2>&1 || { printf 'error: python3 required for Firecrawl SDK\n'; exit 1; }
+
+# Parse the YAML sources (name/url/kind) and scrape each with the SDK.
+TODAY="$(date -u +%Y-%m-%d)"
+ok=0; failed=0; skipped=0
+rows="$(python3 - "$SOURCES" <<'PY'
+import sys, re
+txt = open(sys.argv[1]).read()
+items = []
+for m in re.finditer(r'^\s*-\s+name:\s*(\S+)\s*$', txt, re.M):
+    start = m.end()
+    name = m.group(1)
+    url = kind = ""
+    for line in txt[start:].splitlines():
+        line = line.strip()
+        if line.startswith("- name:") : break
+        if line.startswith("url:") and not url: url = line[4:].strip()
+        if line.startswith("kind:") and not kind: kind = line[5:].strip()
+    items.append((name, url, kind or "scrape"))
+for i in items: print("|".join(i))
+PY
+)"
+
+if [ -z "$FIRECRAWL_API_KEY" ]; then
+  failed=$failed; skipped=1
+  printf 'bragi-scrape: FIRECRAWL_API_KEY absent — sources listed, nothing scraped\n'
+  # still record the rune honestly
+else
+  while IFS='|' read -r name url kind; do
+    [ -n "$name" ] || continue
+    out="$OUT_DIR/$TODAY-$name.md"
+    if python3 - "$url" "$kind" "$out" "$FIRECRAWL_API_KEY" <<'PY'
+import os, sys
+url, kind, out, key = sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4]
+try:
+    from firecrawl import FirecrawlApp
+except ImportError:
+    sys.exit(2)  # engine not installed
+app = FirecrawlApp(api_key=key)
+try:
+    doc = app.scrape_url(url, params={"formats": ["markdown"]}) if kind == "scrape" \
+        else app.search(url, params={"formats": ["markdown"]})
+    text = doc.get("markdown", "") if isinstance(doc, dict) else str(doc)
+    with open(out, "w") as f:
+        f.write("<!-- source: %s ; kind: %s ; fetched: %s -->\n\n%s\n" % (url, kind, __import__("datetime").datetime.utcnow().isoformat() + "Z", text))
+    sys.exit(0)
+except Exception as exc:
+    print("scrape error: %s" % exc, file=sys.stderr)
+    sys.exit(1)
+PY
+    then ok=$((ok+1))
+    elif [ $? -eq 2 ]; then skipped=$((skipped+1))
+    else failed=$((failed+1)); fi
+  done <<< "$rows"
+fi
+
+printf 'bragi-scrape: sources=%s ok=%s failed=%s skipped=%s out=%s\n' \
+  "$(printf '%s\n' "$rows" | grep -c .)" "$ok" "$failed" "$skipped" "$OUT_DIR"
+
+# Carve the Rune — the ledger lives in the hoard.
+# shellcheck source=bin/runes-append.sh
+. "$ROOT/bin/runes-append.sh"
+runes_append "bragi" "scrape.round" --realm "${BROKK_REALM:-}" \
+  --message "scrape round: ok=$ok failed=$failed skipped=$skipped -> $OUT_DIR" >/dev/null \
+  || printf 'bragi-scrape: rune append failed (non-fatal)\n'
+[ "$failed" = 0 ] && exit 0 || exit 1

package/bin/nornir-job-daily-briefing.sh

@@ -5,7 +5,7 @@
 # briefing — no model call — from four grounded inputs:
 #   1. open forge orders parsed from docs/masterplan.md (append-only source)
 #   2. live fleet/state under state/ (cron, metas, status, session lock)
-#   3. active plan status from docs/plans/*.md
+#   3. active plan status from memory/plans/*.md
 #   4. today's Runes tail from workspace/memory/runes_audit.md
 #
 # Output: svartalfaheim/<realm>/workspace/memory/daily/YYYY-MM-DD.md
@@ -40,8 +40,8 @@ BRIEF_DIR="${BROKK_BRIEF_DIR:-${YMIR_HOME:-$HOME/Documents/Ymir}/svartalfaheim/$
 BRIEF_FILE="$BRIEF_DIR/$DATE.md"
 MAX_ORDERS="${BROKK_BRIEF_MAX_ORDERS:-15}"
 MAX_RUNES="${BROKK_BRIEF_MAX_RUNES:-12}"
-MASTERPLAN="$ROOT/docs/masterplan.md"
-PLANS_DIR="$ROOT/docs/plans"
+MASTERPLAN="${BROKK_MASTERPLAN:-${YMIR_HOME:-$HOME/Documents/Ymir}/hodd/docs/masterplan.md}"
+PLANS_DIR="${BROKK_PLANS_DIR:-${YMIR_HOME:-$HOME/Documents/Ymir}/memory/plans}"
 
 mkdir -p "$BRIEF_DIR" || { printf 'error: cannot create %s\n' "$BRIEF_DIR"; exit 1; }
 TMP="$BRIEF_DIR/.$DATE.md.tmp.$$"
@@ -90,11 +90,11 @@ if [ -r "$MASTERPLAN" ]; then
   done
   if [ "${total:-0}" -gt "$MAX_ORDERS" ]; then
     emit ""
-    emit "_(truncated — ${total} open orders total; see docs/masterplan.md §3)_"
+    emit "_(truncated — ${total} open orders total; see hodd/docs/masterplan.md §3)_"
   fi
   rm -f "$orders_tmp"
 else
-  emit "ABSENT: docs/masterplan.md not readable"
+  emit "ABSENT: hodd/docs/masterplan.md not readable"
 fi
 emit ""
 
@@ -105,7 +105,7 @@ if [ -r "$MASTERPLAN" ]; then
   awk '/^## 2\. Active Queue/ {on=1; next} /^## 3\./ {on=0} on && /^[0-9]+\. / {print}' "$MASTERPLAN" \
     | while IFS= read -r q; do emit "- ${q#* }"; done
 else
-  emit "ABSENT: docs/masterplan.md not readable"
+  emit "ABSENT: hodd/docs/masterplan.md not readable"
 fi
 emit ""
 
@@ -156,7 +156,7 @@ if [ -d "$PLANS_DIR" ]; then
     emit "- \`$pname\` — ${pstatus:-unknown}"
   done
 else
-  emit "ABSENT: docs/plans/ not readable"
+  emit "ABSENT: memory/plans/ not readable"
 fi
 emit ""