Idunn/docs
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Meta Vens a03b36462d Survey heimdall, repixelizer and streampixels: none can take a recipe yet
I called these three "the simple ones" and "compose-shaped". Both were
wrong. None of them is compose -- the legacy actuator restarts all three
with `docker compose -f /srv/compose/yggdrasil-apps.yaml`, and that file
does not exist; /srv/compose holds only odin, voidbot and voidbot-retrieval.
The path is guarded, so every restart of these three has been failing at
the guard. They are running only because nothing has asked them to restart,
which is the difference between a supervised service and one that happens
to be up.

Each needs a change in its own repository before a recipe means anything,
and the changes are different shapes, so this is not one piece of work:

streampixels has real build scripts (tsc, next build) and no external
dependencies, but its service unit runs TypeScript through tsx from a
checkout, and it is two units under one target name. A recipe declares one
[service]; the two have different environments, ports, and an ordering
dependency. It was one target only because a shell line restarted both.

repixelizer has the cleanest dependencies of the three -- no CultLib, no
submodules -- but runs a venv interpreter against a checkout, so there is
no artifact to seal and no revision observable from the process.

heimdall is the most release-shaped and needs the deepest change: it takes
CultLib as file:../CultLib, a sibling checkout outside the repository. The
current manifest works around that by cloning CultLib separately with
cultlib_commit hardcoded in shell -- exactly the untyped authority recipes
exist to replace. It needs vendor/CultLib as a gitlink, like Ghostlight's
vendor/eve.

Also corrects the advice to copy CodexConnector's recipe. That recipe is
stale: it declares required_gitlinks for vendor/cultcache-rs and
vendor/cultnet-rs, and the repo has no .gitmodules, no vendor/, and takes
CultLib as a pinned cargo git dep instead. Recipes drift from their repos
silently because nothing re-checks them; run `idunn validate` in each
target's CI so drift fails at the repo rather than on the host.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-06 00:30:51 +02:00
..
authority-map.md Make the public entry point describe the binary that actually ships 2026-09-05 23:15:46 +02:00
deployment-authority.md Make Idunn independently usable: unit files, docs, and a public entry point 2026-09-05 18:15:40 +02:00
guide.md Make the public entry point describe the binary that actually ships 2026-09-05 23:15:46 +02:00
migration.md Survey heimdall, repixelizer and streampixels: none can take a recipe yet 2026-09-06 00:30:51 +02:00
signed-daemon-health-authority.md Make Idunn independently usable: unit files, docs, and a public entry point 2026-09-05 18:15:40 +02:00