Document on Registry::open that a Registry owns two directory-co-located stores (runs.jsonl + families.jsonl) #82

New Issue

2026-06-17T15:49:09+02:00

Brummel commented

2026-06-17 15:49:09 +02:00

Source: fieldtest milestone "The World, part II" — finding F8 (spec_gap, ratify).
See docs/specs/fieldtest-milestone-the-world-orchestration-families.md.

The behaviour is a reasonable design; the silence in the docs is the gap.

Registry::append_family writes to path.with_file_name("families.jsonl") — a
fixed filename in the runs path's directory. Two Registry::open calls with
different runs filenames in the same directory therefore share one family
store. A fixture that isolated runs by a per-process filename
(mw1-runs-<pid>.jsonl) got a shared /tmp/families.jsonl and recovered 2
families instead of 1; it had to switch to a per-process temp directory.

The sibling-path is documented on append_family, but Registry::open's own
rustdoc ("Bind to a JSONL path") does not mention that a second, directory-keyed
store rides along.

Action (ratify): note on Registry::open rustdoc (and/or the C18 ledger
entry) that a Registry owns two directory-co-located stores
(runs.jsonl + families.jsonl), so isolation is per-directory.

**Source:** fieldtest milestone "The World, part II" — finding F8 (spec_gap, ratify). See `docs/specs/fieldtest-milestone-the-world-orchestration-families.md`. The behaviour is a reasonable design; the silence in the docs is the gap. `Registry::append_family` writes to `path.with_file_name("families.jsonl")` — a fixed filename in the runs path's **directory**. Two `Registry::open` calls with different runs *filenames* in the same directory therefore share **one** family store. A fixture that isolated runs by a per-process filename (`mw1-runs-<pid>.jsonl`) got a shared `/tmp/families.jsonl` and recovered 2 families instead of 1; it had to switch to a per-process temp *directory*. The sibling-path is documented on `append_family`, but `Registry::open`'s own rustdoc ("Bind to a JSONL path") does not mention that a second, directory-keyed store rides along. **Action (ratify):** note on `Registry::open` rustdoc (and/or the C18 ledger entry) that a `Registry` owns two directory-co-located stores (`runs.jsonl` + `families.jsonl`), so isolation is per-directory.

Brummel added the idea label 2026-06-17 15:49:09 +02:00

Brummel added this to the Runway — real-data ergonomics & honesty hardening milestone 2026-06-18 11:02:35 +02:00

Brummel closed this issue

2026-06-18 19:43:49 +02:00

Brummel referenced this issue from a commit

2026-06-18 21:18:34 +02:00

docs(aura-registry): note Registry::open owns two directory-co-located stores

Sign in to join this conversation.