VALKYRIE

Deep Dive

Architecture

Valkyrie is a compositor core plus policy/control subsystems that run under strict contracts: NDJSON IPC, guarded plugins, replayable events, transactional operations, and release-verified artifacts.

Control Spine

IPC Contract

Single NDJSON envelope with stable `hello/exec/subscribe/unsubscribe` capability negotiation.

{"id":1,"op":"hello"}
{"id":2,"op":"exec","cmd":"snapshot list"}

Timeline + Rings

Event sequence + tx ring + snapshot events provide deterministic diagnostics and replay targets.

Selector Grammar

Unified selectors (`@focused`, `@id:`, `@app:`, `@title~`) give command power without command sprawl.

Safety Model

Plugin Guardrails

  • tick/frame/dmabuf budgets
  • degrade tiers
  • cooldown + quarantine
  • host failover paths

Transactional Ops

Bulk policy/profile changes apply atomically with rollback if a step fails.

Snapshot Rollback

State + config + relaunch descriptors captured/restored with dry-run verify and import/export archives.

Ship Path

Build pipeline emits core/companion/apps bundles, generates manifest metadata, runs post-deploy smoke in clean rootfs, and publishes only on green.