Idunn/docs
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Meta Vens c8c1f400e9 Add idunn validate, so a binding can be checked before it is installed
The migration procedure told operators to dry-run a target, and no dry-run
existed. `up` needs a running daemon and a state store, so the only way to
find out whether a binding was well-formed was to install it and see
whether `serve` refused to start -- on the host, with the authority down.

`idunn validate --recipe PATH [--binding PATH]` runs the same
TargetDeclaration::parse and OperatorBinding::admit the daemon runs at
load. It opens no store, contacts no host, and actuates nothing.

Owner: the existing control-plane CLI, no new module or target. Consumer:
whoever authors a binding, starting with this migration. Invariant: a
binding installed on the host admits against its target's recipe. It
replaces the install-and-see loop rather than adding a layer.

Verified against the real estate: Odin, CodexConnector and Ghostlight
recipes all parse. Negative paths checked too, because a validator that
only ever passes is worse than none -- an unknown recipe field (the
privilege-escalation shape), a missing --recipe, and an unreadable file
all fail with the reason.

A test asserts validate stays declarative and refuses --deploy-command,
matching the guarantee cli_exposes_only_declarative_commands makes for the
rest of the surface. 64 passed / 18 failed, against a 63/18 baseline: one
added pass, no new failures, and the 18 remain the known Windows
absolute-path cases. cargo check for x86_64-unknown-linux-gnu is clean.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-06 00:27:36 +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 Add idunn validate, so a binding can be checked before it is installed 2026-09-06 00:27:36 +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