03Sheet 03.05 · Tools

Novelty

make novelty: leave-one-out over every entry's arms, enum members, hazards, sightings and placements. The run fails if any entry holds nothing another entry doesn't.

make novelty                    # node tools/novelty.mjs
node tools/novelty.mjs --json out.json   # also write the per-entry report

The corpus grows by purpose, not volume. Novelty checks that every entry earns its place. It describes each entry as a set of atoms:

AtomWhat counts
Union arms and enum membersthose reached by the entry's own transaction (its envelope and result meta) or by its ledger's own shape (header, transaction-set phases, upgrades, evicted keys), in any variant. Other transactions that share the ledger count for nothing
Hazardseach hazard the entry targets
Sightingseach upstream issue it reproduces
Placementseach pair of a hazard and where in the XDR it sits

An entry is redundant when every one of its atoms is also held by some other entry. Each entry is left out in turn, so the result does not depend on the order entries are read, unlike a greedy "does it add anything new" pass. The run exits 1 if any entry is redundant.

Today

At commit 128b16b: 0 redundant entries, over 975 atoms.

EntriesCount
Hold an arm, enum member, hazard or sighting no other entry holds124
Told apart only by a placement77
… of which every other atom sits inside one single other entry11

Placement is a claim, not a measurement

A placement is text the author wrote. So make novelty lists every entry told apart only by placement, and flags the ones wholly contained in one other entry: for each such pair, the facts must check a different thing.

It needs Node ≥ 22.15 and the native reader (Rust), which finds each variant's transaction hashes.

On this page