@zerwiz/ymir 0.1.14 → 0.1.15

package/.agents/skills/galdr-ymirsystem/assets/registry.md

@@ -1,379 +1,115 @@
-# Galdr Registry — skills, tools, commands, profiles, schemas
+# Registry — skills, assets, tools, commands (loaded from AGENTS.md)
 
-The reference registries Galdr routes to when synthesizing or validating a skill.
-Load this when the task is about skill synthesis, the tool inventory, OpenCode
-commands, or compliance assets.
+AGENTS.md loads this when a task needs the live inventories.
 
-## Internal skills registry
+## Skills registry (`.agents/skills/`)
 
 ```
-skills[26]{name,norse,purpose,path,status}:
-  "galdr","Galdr","AXI incantation standards + master builder/maintainer",".agents/skills/galdr-ymirsystem/SKILL.md","live"
-  "tyr-check","Tyr","The judge — validates tools/skills/docs against the 10 principles",".agents/skills/tyr-check/SKILL.md","live"
-  "rules-check-drift","Tyr","Rules-file drift checker — keeps AGENTS.md true after code changes",".agents/skills/rules-check-drift/SKILL.md","live"
-  "smidja-factory","Smíðja","The smithy — agent factory: roster, phases, envelopes, visualizer",".agents/skills/smidja-factory/SKILL.md","live"
-  "no-mistakes","—","The clean-PR gate — vendored engine skill: validate, push, PR, CI",".agents/skills/no-mistakes/SKILL.md","live"
-  "hvild-afk","Hvíld","Away-mode supervision — routine wakes, batched escalations",".agents/skills/hvild-afk/SKILL.md","live"
-  "saga-bearings","Sága","Bearings (/bearings) + recap and unresolved decisions (/ahoy)",".agents/skills/saga-bearings/SKILL.md","live"
-  "muninn-stow","Muninn","Session-knowledge curation, routing, persistence",".agents/skills/muninn-stow/SKILL.md","live"
-  "jord-projects","Jörð","Project registry + delivery posture",".agents/skills/jord-projects/SKILL.md","live"
-  "urdh-hold","Urðr","Allfather-hold lifecycle: decisions held for the Allfather, reconciled",".agents/skills/urdh-hold/SKILL.md","live"
-  "frigg-consent","Frigg","Consent / ask-user authority gate",".agents/skills/frigg-consent/SKILL.md","live"
-  "vor-diagnostics","Vör","Bootstrap + diagnostic reasoning",".agents/skills/vor-diagnostics/SKILL.md","live"
-  "nornir-schedule","Nornir","Fate & schedule: process→event sources + quota-aware dispatch",".agents/skills/nornir-schedule/SKILL.md","live"
-  "nsr-compliance","—","NorthStar scaffold/audit + the .compliance/ harness",".agents/skills/nsr-compliance/SKILL.md","live"
-  "lifecycle","—","Start/stop/status/smoke-test wiring contract",".agents/skills/lifecycle/SKILL.md","live"
-  "gjallarhorn-relay","Gjallarhorn","Public relay replies (X/Discord)",".agents/skills/gjallarhorn-relay/SKILL.md","live"
-  "eindri-homes","Eindri","Isolated worker homes (provisioning)",".agents/skills/eindri-homes/SKILL.md","live"
-  "syn-recovery","Sýn","Stuck-worker recovery playbook",".agents/skills/syn-recovery/SKILL.md","live"
-  "ymir-host","Ymir","Self-update · Omarchy-native operation · the Þjazi backend",".agents/skills/ymir-host/SKILL.md","live"
-  "groa-update","Gróa","The updater shaman — self-update Brokk + every Eindri-home",".agents/skills/groa-update/SKILL.md","live"
-  "herdr-panes","Þjazi","Terminal panes — seat/control panes, tabs, workspaces, agents",".agents/skills/herdr-panes/SKILL.md","live"
-  "ratatoskr-a2a","Ratatoskr","A2A/MCP mesh — a2abridge + wayofteams; registration",".agents/skills/ratatoskr-a2a/SKILL.md","live"
-  "hamr-adapters","Hamr","Per-harness adapter reference",".agents/skills/hamr-adapters/SKILL.md","live"
-  "pr-ops","—","PR lifecycle — create, update, status, request merge",".agents/skills/pr-ops/SKILL.md","live"
-  "hnoss-design","Hnoss","Design artifacts via OpenDesign (prototypes, decks, dashboards, video)",".agents/skills/hnoss-design/SKILL.md","live"
-  "bragi-marketing","Bragi","Marketing — research/crawl (Firecrawl), agentic browser (browser-use)",".agents/skills/bragi-marketing/SKILL.md","live"
+skills[3]{name,norse,purpose,path,status}:
+  "galdr","Galdr","agent-CLI ergonomics + master builder/maintainer",".agents/skills/galdr-ymirsystem/SKILL.md","live"
+  "tyr-check","Tyr","the judge — 10 principles + runtime gates",".agents/skills/tyr-check/SKILL.md","live"
+  "brokk-craft","Brokk","the forger — generates Galdr-compliant skills in TOON","(planned) .agents/skills/brokk-craft/SKILL.md","planned"
 ```
 
-**Loading:** Skills auto-load from `.agents/skills/` via `opencode.json` →
-`skills.paths: [".agents/skills"]`. Use the `skill` tool: `skill galdr`,
-`skill tyr-check`.
+The **canonical, complete** skill index is `.agents/skills/README.md` — read it for
+the live set. The two removed legacy skills (`galdr-compliance`, `galdr-crafter`)
+are superseded by `tyr-check` and the planned `brokk-craft`; their files are gone.
 
-## The Einherjar — agent fleet
+Loading: auto-load from `.agents/skills/` via `opencode.json` →
+`skills.paths: [".agents/skills"]`. Use `skill galdr`, `skill tyr-check`.
 
-Eight specialists, one primary. Each is named for the figure whose role matches its work.
+## Galdr assets (`.agents/skills/galdr-ymirsystem/assets/`)
 
 ```
-einherjar[20]{agent,norse,role,file}:
-  "Brokk","Brokk","Primary — forge-master, dispatcher, supervisor",".agents/agents/brokk.md"
-  "Sindri","Sindri","Developer — code synthesis, refactoring, tests, CLI tools",".agents/agents/sindri-developer.md"
-  "Bragi","Bragi","Marketer — content, SEO, social copy, campaigns",".agents/agents/bragi-marketer.md"
-  "Huginn","Huginn","Researcher — RAG, web search, analysis",".agents/agents/huginn-researcher.md"
-  "Mimir","Mimir","Planner — memory, recall, architecture sequencing",".agents/agents/mimir-planner.md"
-  "Kvasir","Kvasir","Scout — reconnaissance, investigation",".agents/agents/kvasir-scout.md"
-  "Forseti","Forseti","Reviewer — QA, acceptance, compliance",".agents/agents/forseti-reviewer.md"
-  "Snotra","Snotra","Documenter — docs, changelogs, runbooks",".agents/agents/snotra-documenter.md"
-  "Hnoss","Hnoss","Designer — UI/UX, prototypes, decks, visual assets",".agents/agents/hnoss-designer.md"
-  "Galdr","Galdr","Builder — agent-CLI ergonomics, the runtime's master builder",".agents/agents/galdr.md"
-  "Týr","Týr","Judge — the 10 principles + the runtime gates",".agents/agents/tyr-check.md"
-  "Sága","Sága","Seeress — bearings + recap",".agents/agents/saga-bearings.md"
-  "Muninn","Muninn","Rememberer — memory curation",".agents/agents/muninn-stow.md"
-  "Urðr","Urðr","Fate — the hold lifecycle",".agents/agents/urdh-hold.md"
-  "Frigg","Frigg","Knowing — the consent gate",".agents/agents/frigg-consent.md"
-  "Vör","Vör","Aware — diagnostics",".agents/agents/vor-diagnostics.md"
-  "Sýn","Sýn","Seeing — stuck-worker recovery",".agents/agents/syn-recovery.md"
-  "Jörð","Jörð","Grounded — the project registry",".agents/agents/jord-projects.md"
-  "Gróa","Gróa","Renewer — self-update",".agents/agents/groa-update.md"
-  "Völundr","Völundr","Master smith — Smíðja's orchestrator seat",".agents/agents/volundr-smith.md"
+galdr_assets[6]{path,load_when}:
+  "assets/README.md","the full asset routing index"
+  "assets/principles.md","the 10 CLI design principles (full doctrine)"
+  "assets/norse-naming.md","naming law + full component map"
+  "assets/brokk-distro-runtime.md","the runtime spec (home, digest, lock, cron)"
+  "assets/harness-integration/","per-harness adapters (opencode, pi, claude, cursor, codex)"
+  "assets/runtime-compliance.md","runtime acceptance gates + runnable checklist"
 ```
 
-**Rule:** Every agent carries its rune of introduction (Agent Card). Every agent
-reports to Brokk. Brokk reports to the Allfather.
+Galdr scripts: `scripts/toon-check.py` (TOON validation) and
+`scripts/compliance-check.sh` (all gates). Run the latter before claiming done.
 
-## Legacy sub-agent profiles (`.agents/subagents/*.md` — superseded)
+## Assets inventory
 
-These profiles were superseded by the Einherjar fleet above. They remain for
-historical reference only.
-
-```
-eindri[3]{role,norse,domain,capabilities,tools,workspaces}:
-  "developer","Sindri (smith)","code synthesis, refactoring, tests, CLI tools, packaging","code_synthesis, refactoring, test_writing, cli_tools, package_management","yggdrasil, herder, hermes_runner, vector_db, supabase","development/, .agents/tools/, .agents/skills/"
-  "marketer","Bragi (skald)","content, SEO, social copy, campaigns","content_creation, seo_optimization, social_copy, campaign_planning, market_research","vector_db, supabase, hermes_runner, herder, yggdrasil","marketing/, .agents/assets/templates/, .agents/skills/"
-  "researcher","Huginn (sage)","RAG, web search, analysis, knowledge discovery","rag_search, web_search, analysis, summarization, entity_extraction","vector_db, hermes_runner, herder, yggdrasil, supabase","development/, .agents/memory/, .agents/assets/templates/"
-```
-
-All three declare the Utgard security posture: `runs_in_utgard: true`,
-`utgard_network: none`, `utgard_resource_caps: true`, `yggdrasil_worktree: true`,
-`sandboxed: true`.
-
-## Build tool categories (`.agents/skills/galdr-ymirsystem/assets/build-tool-categories.md`)
-
-```
-build_tools[4]{category,role}:
-  "Python smidja tools","deterministic Python orchestrators in `templates/smidja/`"
-  "smidja","validated OSS smidja (agents + typed JSON envelopes + SQLite trace + Vue visualizer)"
-  "Agent-distro orchestration","validated upstream distro pattern (see porting asset)"
-  "Galdr skill assets","internal reference data under `assets/`"
 ```
-
-## TOON output schemas (`.agents/skills/galdr-ymirsystem/schemas/toon-schemas.md`)
-
-```
-schemas[7]{schema,fields}:
-  "Smíðja orchestrator","status, phase, progress, next_action, utgard_sandbox, worktree, phase_complete"
-  "Worker orchestration","status, agent_role, worktree, utgard, sandboxed, session_id"
-  "Galdr skill generator","name, category, toon_output, principles, compliance_status, eindri_role, utgard_sandbox"
-  "Eindri profile","capabilities, tools, workspace_patterns, security"
-  "Norse aett naming","aett pattern, validity, rejection reasons"
-  "Session integration","hook, installed, skill_loaded, ambient_context, context_richness, last_session_start"
-  "Compliance gate results","toon_output_test, principle_compliance, norse_name_validity, frame_integration, mimirsbrunn_observation, eindri_compatibility, utgard_sandbox"
+assets[9]{asset,path,purpose}:
+  "Eindri profiles",".agents/subagents/*.md","Sindri/Bragi/Huginn role profiles"
+  "Build tool categories",".agents/skills/galdr-ymirsystem/assets/build-tool-categories.md","tool categories for synthesis"
+  "TOON schemas",".agents/skills/galdr-ymirsystem/schemas/toon-schemas.md","schema types for validation"
+  "Compliance requirements",".agents/skills/galdr-ymirsystem/assets/runtime-compliance.md","runtime + Utgard gates"
+  "PI boot profile",".agents/skills/galdr-ymirsystem/assets/pi-boot/pi-profile.yml","PI harness profile"
+  "PI herdr profile",".agents/skills/galdr-ymirsystem/assets/pi-boot/herdr-profile.toml","pane layout / Þjazi"
+  "PI dispatch schema",".agents/skills/galdr-ymirsystem/assets/pi-boot/einherjar-spawn.schema.json","dispatch payload"
+  "Templates",".agents/assets/templates/*","PRD, env, system-prompt boilerplate"
+  "Tool manifest schema",".agents/assets/schemas/tool_manifest.json","tool manifest"
 ```
 
-## Norse aett pattern
+## Tools inventory (`.agents/tools/`)
 
 ```
-aett[8]{prefix,pattern,examples}:
-  "galdr-","incantation / chant standards","galdr, galdr-compliance, galdr-crafter"
-  "val-","hall / health","valhalla"
-  "skyr-","giant / file scope","skrymir"
-  "bifr-","bridge / gateway","bifrost"
-  "heimd-","gate / guard","heimdall"
-  "gjallar-","horn / signal","gjallarhorn"
-  "mimir-","memory / wisdom","mimir-recall, mimirsbrunn"
-  "yggd-","tree / worktree","yggdrasil, yggd-branch"
-```
-
-**Naming form:** `<aett>-<verb|noun|adjective>`, e.g. `mimir-recall`, `yggd-branch`.
-The aett table lives in `SKILL.md:288-301` and `assets/norse-naming.md`; keep both
-in sync when an aett gains its first real skill.
-
-**Aett prefix rules:**
-- `galdr-` is reserved for Galdr-family skills (incantation/chant standards)
-- `val-` is for hall/health subsystems
-- `skyr-` is for giant/file-scope tools
-- `bifr-` is for bridge/gateway components
-- `heimd-` is for gate/guard components
-- `gjallar-` is for horn/signal components
-- `mimir-` is for memory/wisdom components
-- `yggd-` is for tree/worktree components
-
-## Internal tools inventory
-
-```
-tools[9]{tool,path,purpose,status}:
-  "tasks-cli",".agents/tools/bin/tasks-cli","AXI task manager (list/view/create/close), TOON output","live"
+tools[8]{tool,path,purpose,status}:
+  "tasks-cli",".agents/tools/bin/tasks-cli","AXI task manager (list/view/create/close), TOON","live"
   "tasks-cli.ts",".agents/tools/tasks-cli.ts","TypeScript source","live"
-  "agents-config.sh","bin/agents-config.sh","Show/apply the personal agent→model combination (config/agents.yaml)","live"
-  "yggdrasil.ts",".agents/tools/yggdrasil.ts","Worktree CLI harness","planned"
-  "hermes_runner.ts",".agents/tools/hermes_runner.ts","Realm agent CLI orchestrator","planned"
-  "herder.ts",".agents/tools/herder.ts","Terminal multiplexer / pane state tracker","planned"
-  "vector_db.ts",".agents/tools/vector_db.ts","Vector indexing / RAG search","planned"
-  "firebase.ts",".agents/tools/firebase.ts","Backend provisioning","planned"
+  "yggdrasil.ts",".agents/tools/yggdrasil.ts","worktree CLI harness","planned"
+  "hermes_runner.ts",".agents/tools/hermes_runner.ts","realm agent CLI orchestrator","planned"
+  "herder.ts",".agents/tools/herder.ts","terminal multiplexer / pane state tracker","planned"
+  "vector_db.ts",".agents/tools/vector_db.ts","vector indexing / RAG search","planned"
+  "firebase.ts",".agents/tools/firebase.ts","backend provisioning","planned"
   "supabase.ts",".agents/tools/supabase.ts","DB / edge function setup","planned"
 ```
 
 Usage: `python3 .agents/tools/bin/tasks-cli <command>`. All tools emit TOON.
 
-### Runtime components added 2026-09-13 (seat-hall · machine lock · guard families)
-
-```
-added[10]{component,path,purpose}:
-  "Sessrúmnir GUI","apps/sessrumnir/","vendored pi-desktop fork rebranded: the seat-hall; width-responsive Home/models/modals, narrative agent surfaces (Brokk/Eindri)"
-  "seat-hall launchers","bin/sessrumnir.sh, bin/sessrumnir-ensure.sh","raise/ensure the Sessrúmnir desktop app (deps+build on first run)"
-  "machine lock","bin/gleipnir-lock-lib.sh","ONE primary session lock per machine; Eindri-homes keep a per-home lock; state/.lock-path pointer"
-  "invariant seatbelt","bin/syn-guard-pretool-check.sh","PreToolUse denial for destructive shapes against the lock, markers, Runes, the guard machinery, secrets, registries"
-  "neutral realm resolver","bin/realm-lib.sh","active realm: data/realm.md → first non-example tenant → default (never a company slug)"
-  "A2A bridge ensure","bin/a2abridge-ensure.sh","install/verify the a2abridge engine + directory daemon (Ratatoskr mesh)"
-  "desktop entry","apps/sessrumnir/resources/ymir-sessrumnir.desktop.in","Omarchy launcher entry rendered by bin/desktop-place.sh"
-  "Gróa (updater shaman)","bin/groa-update.sh","fast-forward Brokk + Eindri-homes, mend forward; the groa-update skill's door (alias bin/brokk-update.sh)"
-  "Eir (doctor)","bin/eir-doctor.sh","diagnose every surface, then mend the broken (composes the *-ensure.sh surfaces)"
-  "install auth","bin/ymir-setup-auth.sh","set the operator credential at install (password or GitHub) into .env.local"
-```
-
-The reference tenant moved to `svartalfaheim/examples/wayof/`; a fresh install
-ships no company of its own (see `installation.md` §Neutral tenant defaults).
-
-## External tools (adopted, not rebuilt)
-
-Ymir adopts validated OSS projects first — never rebuilds a subsystem that already
-exists on this machine. These are the adopted tools, each wearing a Norse name:
-
-| OSS Project | Norse Name | Purpose | Path |
-|---|---|---|---|
-| adopted upstream smithy (provenance: `command-factory`) | **Smíðja** | Deterministic agent pipeline + trace | `.agents/skills/smidja-factory/` |
-| `a2aproject/a2a` | **Ratatoskr** | Agent-to-agent collaboration | `.agents/bus/protocol.ts` |
-| Redis | **Ratatoskr queue** | Pub/sub message queue | platform service |
-| Traefik / Caddy | **Bifrost** | Reverse proxy / routing | platform service |
-| OAuth2-proxy | **Heimdall** | Authentication guardian | platform service |
-| cloudflared | **Gjallarhorn** | Cloudflare tunnel | platform service |
-| MinIO / FileBrowser | **Skrymir** | File browser | platform service |
-| PM2 / Docker | **Valhalla** | Process supervisor | platform service |
-| MCP servers | **Hermóðr** | Tool composition | `.agents/skills/galdr-ymirsystem/assets/pi-boot/herdr-profile.toml` |
-| — (Ymir-owned) | **Gungnir** | Dynamic skill creation | `.agents/skills/` |
-| zerwiz/SkillOpt | **Gunnlöð** | Skill optimization (trajectory-driven skill refinement) | `.venv/bin/skillopt-*` |
-| OpenDesign CLI | **Od** | Design engine (HTML/PDF/PPTX/video) | `od` CLI |
-| Þjazi backend | **Þjazi** | Terminal pane presentation | `config/herdr-presentation-spaces` |
-| llama.cpp router | **llama-swap** | Local model serving | `http://127.0.0.1:8080` |
-
 ## OpenCode commands
 
-Available as `/command-name` in OpenCode:
-
 ```
 commands[8]{command,purpose}:
-  "create-plan","Create detailed implementation plans iteratively"
-  "fixes-bump","Bump version across project files"
-  "fixes-create","Create fix note entry"
-  "implement-plan","Implement approved plan phase-by-phase"
-  "rules","Display/manage coding rules"
-  "standup","Generate daily standup entries"
-  "ticket-create","Interactive ticket creation"
-  "validate-plan","Validate plan before implementation"
+  "/create-plan","create detailed implementation plans iteratively"
+  "/fixes-bump","bump version across project files"
+  "/fixes-create","create fix note entry"
+  "/implement-plan","implement approved plan phase-by-phase"
+  "/rules","display/manage coding rules"
+  "/standup","generate daily standup entries"
+  "/ticket-create","interactive ticket creation"
+  "/validate-plan","validate plan before implementation"
 ```
 
-## Session integration hooks
-
-- **Primary — session hook**: installs/repairs after user intent is clear, provides a
-  compact dashboard as context at session start, loads every session, works only in
-  agents that support hooks.
-- **Secondary — installable skill**: loads on demand when the agent recognizes a
-  matching task, no per-session token cost, works in any agent that supports the
-  skill format.
-- Recommended order: hook first (ambient context + live state), skill second (lower
-  overhead, broader support). They are complementary; install either or both.
-
-## Utgard sandbox compliance checklist
-
-Every Galdr-generated CLI tool must declare:
+## Brokk commands — the Eindri wake bridge (control)
 
 ```
-[runs_in_utgard: true]
-[utgard_network: none]
-[utgard_resource_caps: true]
-[yggdrasil_worktree: true]
-[sandboxed: true]
+commands[4]{command,purpose}:
+  "bin/eindri-watch.sh","the bridge's door: arm/retire/list/reconcile a when-source per smith (Norns' loom)"
+  "bin/eindri-seen.sh","bridge condition: has the smith reported? (report file, or herdr left working)"
+  "bin/eindri-acclaim.sh","bridge action: file the report, mark done, append the wake queue + desktop note"
+  "bin/hall-snapshot.sh","the planning feed: real system state -> public-safe livehall.json for the Óðrerir Hall"
 ```
 
-Failure to declare all five results in compliance-gate rejection.
-
-## Memory (the Well — Mimirsbrunn / engram)
-
-| Component | Path | Purpose |
-|---|---|---|
-| Store | `.agents/memory/kaia.engram` | single shared engram memory |
-| Append log | `.agents/memory/well/episodes.jsonl` | raw episodes; re-seed source |
-| HTTP bridge | `bin/mimir-bridge.py` / `.sh` | `:4602` recall/observe/recent/episode/timeline |
-| CLI | `bin/mimir.sh` | health / recall / observe / timeline |
-| Ingest | `bin/mimir-ingest.sh` | drink a directory into the well |
-| MCP | `engram-mcp` | stdio tools: remember/recall/why/forget/stats |
-| Gate API | `apps/hlidskjalf/server/index.ts` | `/api/well`, `/api/well/episode`, `/api/mimir/health` |
-| UI | `gates/Well.tsx`, `components/RecallPanel.tsx` | live metrics + click-to-read |
-
-Full spec: [`memory-well.md`](memory-well.md). Law: **no mock data in the well**.
+## The marketing stack doors (provisionable — one stack, any computer)
 
-## Smithy runtime (Smíðja)
+`bin/ymir-marketing-stack.sh up|status|down|doors` stands Mautic + Postiz +
+Activepieces (+ optionally Forgejo) on ANY computer — same OSS engines the
+server runs, env-driven, ports virtualized, secrets in the home, never inline.
+The Allfather's server stack (zerwizserver) and the public doors agents reach:
 
-| Component | Path / port | Purpose |
-|---|---|---|
-| Trace DB | `smidja/smidja_data/smidja.db` | sessions/phases/events/gates/envelopes/agent_sessions (WAL, read-only readers) |
-| Roster / config | `smidja/smidja_smidja_config/smidja.config.yaml` | teams, roles, `provider/id` models resolved by **pi** (`~/.pi/agent/models.json`) |
-| Run | `justfile` (`just demo/scout/sdlc`), `uv run smidja/smidja_*.py` | chains |
-| Visualizer (**Smíðja's eye**) | `.agents/skills/smidja-factory/apps/visualizer/`, served at **`:8437`** (API + built UI) | sessions / trace / decisions / stats / chat |
-| Gate API | `apps/hlidskjalf/server/index.ts` → `/api/smidja/*` | read-only trace for the Hlidskjalf gates |
-| Observer (**Huginn**) | `bin/nornir-job-observer.sh` | self-contained Runes lines, incl. `smidja.runs` |
-| Start / stop | `scripts/start.sh` / `scripts/stop.sh` | raises/lowers SPA `:3888`, gate API `:3889`, visualizer `:8437`, Nornir cron, Bifrost bridge |
+```
+marketing_doors[6]{service,door,reach_note}:
+  "Mautic (email automation)","mautic.zerwiz.org -> server 127.0.0.1:8001","list building + campaigns; agent-carved via the local provisioned stack when the public door is closed"
+  "Postiz (social publishing)","postiz.zerwiz.org -> server 127.0.0.1:4007","schedule X/LinkedIn/insta; queue per site"
+  "Activepieces (workflow)","activepieces.zerwiz.org -> server 127.0.0.1:8080","event->post flows; meetup booked -> thread scheduled"
+  "Forgejo (git · issues · PRs)","forgejo.zerwiz.org -> server 127.0.0.1:3030","the local git forge: issues->PR loop lives here"
+  "SearXNG (search)","searxng on the server","private search for research (Bragi)"
+  "Grafana","grafana on the server :3003","fleet + stack observability"
+```
 
-Full spec: [`smidja.md`](smidja.md). Lore: `docs/lore.md` §XI / §XIII.
+An agent (Bragi for marketing, Sindri for git) provisions the stack locally for
+any user with `bin/ymir-marketing-stack.sh`; the server stack is the Allfather's
+live one. Public-door exposure on the server is tunnel-driven (cloudflared) —
+mend the door layer on the server, not in the tree.
 
 ## Maintaining this
 
-- **Owner:** Brokk. **Router:** `.agents/skills/galdr-ymirsystem/SKILL.md`.
-- **Mirror:** `.agents/skills/tyr-check/assets/registry.md`.
-- Update a registry row whenever a skill, tool, command, or profile changes.
-
-## Organisation law — `RULES/` (domains · houses · Eindri)
-
-The house law lives in `RULES/`; Galdr must know it (Rule 01/02/03):
-
-- **A house is a company** — and only that. **WayOf** is the house.
-- **A domain is a field of knowledge — a *Grein* (pl. *Greinar*).** The eight:
-
-| Domain (Grein) | id | Covers |
-|---|---|---|
-| Ymir Labs | `ymirlabs` | the system itself — agents knowledgeable about Ymir |
-| Brokk Forge | `brokkforge` | engineering & build tooling |
-| Runestone Labs | `runestone` | records & compliance |
-| Muninn Labs | `muninn` | memory & knowledge |
-| Dvalin | `dvalin` | crafted tools |
-| Utgard Studios | `utgard` | creative |
-| Askr | `askr` | human-centered products |
-| Mannheim | `mannheim` | holding — allocated when a claim lands |
-
-- **Eindri are the specialists** (marketer, builder, researcher, planner,
-  reviewer, documenter, scout, …); each names its **domain** and its **craft**.
-- **Agents live only in `.agents/agents/*.md`.** `.opencode/agents` and
-  `.pi/agents` are **symlinks** to the canonical profiles — never edit them;
-  edit `.agents/agents/<profile>.md` and run `bin/valknut-load.sh --all`.
-- **No mock agents.** Ids, names, domains, models, status are real and sourced;
-  the demo roster is the one labelled mock and appears only in demo mode.
-
-**In the code:** the eight are `DOMAINS` (type `DomainId`/`DomainDef`) in
-`src/data/realms.ts`; an agent carries `domain` (not `house`); the Forge picker
-is labelled **Domain**. `svartalfaheim/<company>/companies/` holds the house
-card(s); the eight domain cards live under `.../domains/`. The workspace-folder
-union is `TopicId`.
-
-## The personal agent/model combination — `config/agents.yaml`
-
-The Allfather chooses **which smith runs on which model** in one YAML; no other
-file hardcodes a model for him.
-
-- **Source of truth:** `config/agents.yaml` — `default_model` (the fallback),
-  `providers` (local, keyless servers), and `agents` (name → `provider/model`).
-- **Applier:** `bin/agents-config.sh show` prints the live combination (TOON);
-  `apply` writes `model:` into the canonical `.agents/agents/*.md` (matched by
-  their `name:`) **and** into project `opencode.json` (`provider` + `agent.*`).
-  It is idempotent and safe to re-run.
-- **Local servers.** A local llama.cpp **router needs the exact served id** —
-  including the quant suffix, e.g. `frontend-design-expert-8b@q4_k_m`; the bare
-  alias returns `model not found`. Declared under `providers:` so `apply` places
-  it in project `opencode.json`.
-- **Current choice:** Hnoss the designer runs
-  `llama.cpp/frontend-design-expert-8b@q4_k_m` on `127.0.0.1:8080` (no cloud
-  key); the rest inherit `opencode-go/deepseek-v4.1-flash`.
-- **Subagent caveat:** a `mode: subagent` profile (Hnoss) cannot be run with
-  `opencode run --agent`; the lowercased model is taken from its profile when a
-  primary dispatches it. A thin **primary** alias is the way to prove it end to
-  end.
-- **Template & privacy:** `config/agents.yaml.example` is tracked; installation
-  (step `host`) or `bin/agents-config.sh init` copies it to the private,
-  gitignored `config/agents.yaml` — push that to a private repo. Override its
-  path with `YMIR_AGENTS_YAML`.
-- **Harness rule:** the harness is chosen by where the model lives — a local
-  provider runs through **`pi`**, a hosted model through **`opencode`** — unless
-  an agent names `harness:`. The same server is renamed per harness
-  (`llama.cpp` → `llama-cpp` for pi).
-- **Updating this registry:** when a new provider or model is added to
-  `config/agents.yaml`, add its id here and (if it is a new server) to the
-  external-tools inventory.
-
-## Hodd — the private hoard (Rule 04)
-
-`hodd/` is the ONE private place: `secrets/ · docs/ · tenants/ · identity/`.
-`hodd/.gitignore` tracks only itself, the README, and `*.example`; every other
-file beneath is untracked on every clone. Secrets are **referenced by path**
-(`YMIR_HOARD`; `bin/hodd.sh path|init|ls|load|emit|tenant`), never inlined. The
-outer ward is `bin/secret-guard.sh` (pre-commit + CI). Law: `RULES/04-hoard.md`.
-
-## Consolidated skills — galdr-style routers (2026-09-12)
-
-Split pairs were merged into one `SKILL.md` router + `assets/` (a change edits an
-asset, not a new skill). Same-figure split pairs only — merging distinct figures
-is held pending the naming law.
-
-consolidated[5]{skill,absorbed,assets}:
-  "ymir","ymir-update + ymir-omarchy + ymir-thjazi","update · omarchy · thjazi"
-  "urdh","urdh-decisions + urdh-hold","hold · decisions"
-  "saga","saga-bearings + saga-recap","bearings · recap · board-template.html"
-  "nornir","nornir-events + nornir-quota","events · quota"
-  "nsr","NSR + NSRcompliance","nsr/ · nsrcompliance/"
-
-**Ruling (2026-09-12):** `frigg-consent` + `hvild-afk` and `syn-recovery` +
-`vor-diagnostics` stay **separate** — each names a distinct figure, and the
-naming law keeps one figure per skill. Only same-figure split pairs consolidate.
-
-## Operator runbooks — `docs/runbooks/` (indexed by the `ymir` skill)
-
-Task-oriented, operator-facing guides. The `ymir` skill carries the index at
-`assets/runbooks.md`; when a capability gains an operator procedure, add a
-runbook here and a row there.
-
-```
-runbooks[5]{file,subject}:
-  "models.md","models per agent (local llama.cpp / hosted); per-machine overlays"
-  "agents.md","Eindri profiles: home, add, run, dispatch"
-  "tailscale-sync.md","sync pi data across your machines over Tailscale"
-  "updates-and-migrations.md","update the runtime; heal old homes"
-  "secrets-and-hoard.md","Hodd: secrets, secret-guard, rotation + scrub"
-```
+- **Owner:** Brokk. **Loaded by:** `AGENTS.md`. **Mirror:** `.agents/skills/galdr-ymirsystem/assets/registry.md`.

package/.agents/skills/galdr-ymirsystem/assets/runtime-compliance.md

@@ -47,7 +47,7 @@ governed[6]{path,load_first}:
   "bin/ymir-install.sh",".agents/skills/galdr-ymirsystem/assets/installation.md"
   "apps/hlidskjalf/**",".agents/skills/galdr-ymirsystem/assets/hlidskjalf-ui.md"
   "bin/mimir*",".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"
 ```

package/.agents/skills/galdr-ymirsystem/assets/smidja.md

@@ -9,8 +9,10 @@ running a chain, reading its trace, or wiring it into Hlidskjalf.
   **Smíðja's eye**.
 - **Registry:** `.agents/assets/agents/naming.md`, `docs/lore.md` §XI/§XIII.
 - **Skill (adopted upstream):** `.agents/skills/smidja-factory/` (internals + cookbooks +
-  references + `apps/visualizer/` + sibling skills `smidja-launcher`, `smidja-start`,
-  `smidja-instructions`, `volundr`).
+  references + sibling skills `smidja-launcher`, `smidja-start`,
+  `smidja-instructions`, `volundr`). The **visualizer's home is the smidja repo**
+  (`apps/smidja-factory/apps/visualizer` in a clone; the skill tree carries no
+  copy — dropped 2026-09-17).
 
 **Two layouts, one smithy — do not confuse them.** A *target* repo the smithy is
 installed into gets the stamped `smidja/` tree (what `install.py` writes). **In
@@ -102,7 +104,7 @@ installed on this machine) — do not reintroduce `sqlite3`.
 
 - **Open at `http://127.0.0.1:8437/`.** One Bun server serves both the read-only
   API (`bun:sqlite` over the trace db) **and** the built Vue UI from
-  `apps/visualizer/dist`. A Vite dev server on `:8438` is opt-in
+  `apps/smidja-factory/apps/visualizer/dist`. A Vite dev server on `:8438` is opt-in
   (`SMIDJA_VIZ_DEV=1`) and is not needed for use.
 - **The carved cloth (2026-09-13).** The default theme is **fensalir** — the
   landing page's stone/bone/bronze/blood and its three faces (Cormorant display,

package/.agents/skills/galdr-ymirsystem/scripts/compliance-check.sh

@@ -333,7 +333,7 @@ asset_for() {
     *apps/hlidskjalf/*)                        printf '%s' "$GALDR/assets/hlidskjalf-ui.md" ;;
     *bin/mimir*)                               printf '%s' "$GALDR/assets/memory-well.md" ;;
     *bin/gleipnir-lock-lib.sh|*bin/saga-session-start.sh|*state/.lock) printf '%s' "$GALDR/assets/brokk-distro-runtime.md" ;;
-    *bin/nornir-*|*config/cron.yaml)           printf '%s' "$GALDR/assets/nornir-jobs.md" ;;
+    *bin/nornir-*|*config/cron.yaml*)           printf '%s' "$GALDR/assets/nornir-jobs.md" ;;
     *bin/valknut-load.sh|*/.pi/*|*/.opencode/*) printf '%s' "$GALDR/assets/harness-integration/README.md" ;;
     *bin/smidja*|*.agents/skills/smidja-factory/*) printf '%s' "$GALDR/assets/smidja.md" ;;
     *)                                         printf '' ;;

package/.agents/skills/ratatoskr-a2a/SKILL.md

@@ -47,7 +47,7 @@ IP** (never 127.0.0.1), state in `.a2a/<agent>`, the directory as a **service**,
 heartbeat + deregister, and `cert` (ed25519) before federation. Cards are
 UNSIGNED until then. Realm boundaries hold.
 
-Plan + registration spec: `hodd/docs/ratatoskr.md` and `hodd/docs/a2a-runs.md`.
+Plan + registration spec: `$YMIR_HOME/memory/plans/mesh/25-ratatoskr-a2a.md` and `$YMIR_HOME/hodd/docs/a2a-runs.md`.
 
 ## Joining the mesh and talking (skill-driven, no code)
 

package/.agents/skills/tyr-check/SKILL.md

@@ -17,7 +17,7 @@ Tyr also judges the **runtime** and its **Galdr assets** for drift. Galdr is the
 
 ## Before You Start
 
-Understand Ymir's architecture: AGENTS.md governs all agent behavior. docs/Architecture.md is the master blueprint. docs/append-only-log.md records all decisions. TOON output should be used for all compliance reports.
+Understand Ymir's architecture: AGENTS.md governs all agent behavior. docs/Architecture.md is the master blueprint. $YMIR_HOME/hodd/docs/append-only-log.md records all decisions. TOON output should be used for all compliance reports.
 
 Run the gates as one command when you can:
 
@@ -94,7 +94,7 @@ Ymir provides ambient context through:
 Ymir's content-first approach:
 - README.md shows live system map, not usage manual
 - AGENTS.md is the root governance, not a "getting started" doc
-- Plan docs in docs/plans/ are the source of truth
+- Plan docs in `$YMIR_HOME/memory/plans/` are the source of truth
 - Daily logs in workspace/memory/daily/ are the active context
 
 **Assess:** Does your tool/show live data first, or help text first?
@@ -103,8 +103,8 @@ Ymir's content-first approach:
 ### 9. Contextual disclosure
 Ymir's contextual disclosure patterns:
 - After open item → suggest closing (e.g., "Run `tasks close <id>`")
-- After empty list → suggest creating (e.g., "No plans found. ADD: docs/plans/21-company-houses.md")
-- After list → suggest viewing (e.g., "View plan: docs/plans/25-ratatoskr-a2a.md")
+- After empty list → suggest creating (e.g., "No plans found. ADD: memory/plans/<domain>/<name>.md")
+- After list → suggest viewing (e.g., "View plan: memory/plans/mesh/25-ratatoskr-a2a.md")
 - Suggestions use placeholders: <id>, <title>, not concrete values
 - Guide discovery, not prescribed workflows
 
@@ -198,7 +198,7 @@ Compliance assessment per principle and per runtime gate, with "Assess" / "Impro
 
 ## Files referenced
 
-- Governance: `AGENTS.md`, `docs/Architecture.md`, `docs/append-only-log.md`, `docs/plans/*.md`
+- Governance: `AGENTS.md`, `docs/Architecture.md`, `$YMIR_HOME/hodd/docs/append-only-log.md`, `$YMIR_HOME/memory/plans/*.md`
 - Skills: `.agents/skills/*/SKILL.md`
 - Scripts: `.agents/skills/galdr-ymirsystem/scripts/compliance-check.sh`, `.agents/skills/galdr-ymirsystem/scripts/toon-check.py`
 - Galdr assets (also mirrored at `tyr-check/assets/`):

package/.agents/skills/ymir-host/SKILL.md

@@ -30,6 +30,6 @@ assets[6]{path,load_when}:
 A change that adds a host capability adds a row here, not a new skill.
 
 Rule 06 (append-only) governs the memory: the Runes ledger, the
-changelog, `docs/append-only-log.md` and the rules are appended to, never
+changelog, `$YMIR_HOME/hodd/docs/append-only-log.md` and the rules are appended to, never
 rewritten — and a move must carry every one of them plus the hoard.
 Law: `RULES/06-append-only.md`.

package/.agents/state/.wake-queue.seq

@@ -0,0 +1 @@
+11

package/.agents/state/.watcher-down

@@ -0,0 +1 @@
+pending:downtime:2358634.1789341699.Q5Ycld

package/.agents/state/procevent-inbox/when-hall-button.1.adapter

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

package/.agents/state/procevent-inbox/when-hall-button.1.result

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

package/.agents/state/procevent-inbox/when-hall-button.2.adapter

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

package/.agents/state/procevent-inbox/when-hall-button.2.result

@@ -0,0 +1,5 @@
+when: when-hall-button
+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.1.adapter

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