jonnify·echd /echd/bus/one-bus

echd — Echo on Encore · E3.1

One Bus, Twelve Families

The platform's events, schedules, and jobs ride one owned protocol — twelve families over one braced keyspace behind one versioned wire, so any runtime that speaks it is a peer.

Vision · real substrate

echd speaks in the present tense over a build ladder. Every module, verb, key, and port named on this page is real; the composition into one standing platform is the vision the ladder builds.

§1

The module

docs/echo_mq/specs/emq.commands/README.md · emq.design.md

The bus is one protocol with a wide surface — commands for streams, schedules, claims, retries, locks, and more. What keeps that surface one thing, rather than an accumulation, is a single organizing rule: every command belongs to exactly one of twelve families, every family writes into one braced keyspace, and the whole speaks behind one versioned wire. This module holds the protocol at that structural level — not what each verb does (that is the next two modules), but how the bus is built so that any runtime can speak it.

Turn the structure and its three facets resolve into one discipline seen from three sides. The twelve families are the taxonomy — the map the command registry sorts every version of the protocol by, from admission through lifecycle. The braced keyspace is the master invariant — one root per queue so a queue's keys share a slot, branded JOB ids gated at the key builder, every Lua key declared, the server's clock on every lease — the rules that once broke the wire and are now hard-pinned. And the wire fence is why the protocol travels: because it is Valkey commands and inline Lua at echomq:3.0.0, a reader written in any language stands in the same consumer group as the BEAM. Structure, invariant, fence — one bus, and anyone can read it.

§2

The protocol, drawn

hover a facet
One bus, three facets · the taxonomy, the keyspace, the wire · hover to read
the wire · echomq:3.0.0 · Valkey 9 on :6390 · speak it, you are a peer admission scheduling repeat claim retry flows groups batches locks metrics data lifecycle emq:{q}: · branded JOB · every Lua key declared · the server's clock twelve families · one braced root · one versioned wire
Twelve families — the whole protocol, sorted. Admission, scheduling, repeat, claim, retry, flows, groups, batches, locks, metrics, data, and lifecycle: every command the bus speaks belongs to exactly one family, and that taxonomy is the map the command registry sorts every version of the matrix by.
The keyspace — the master invariant. Every key lives under one braced root, emq:{q}:, so a queue's keys share a hash slot; ids are branded JOB, gated at the key builder; every Lua key is declared, never derived inside the script; and every lease is stamped by the server's clock. These are the rules that once broke the wire — now hard-pinned.
The wire — why polyglot holds. The protocol is Valkey commands and inline Lua behind the echomq:3.0.0 fence — no runtime in the middle. Any runtime with a Valkey client is a first-class peer; the conformance suite proves it, a non-BEAM reader draining the same consumer group as the BEAM.

Hover or focus a facet to read it; click to pin. Without scripting, all three read in sequence.

§3

The dives

three moves down

← Back to modules

§4

Doors

the protocol in depth
§5

References

sources · related

Sources

Related