summaryrefslogtreecommitdiffstats
path: root/docs/federation-tests.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/federation-tests.md')
-rw-r--r--docs/federation-tests.md19
1 files changed, 16 insertions, 3 deletions
diff --git a/docs/federation-tests.md b/docs/federation-tests.md
index 3aa1996..a39e749 100644
--- a/docs/federation-tests.md
+++ b/docs/federation-tests.md
@@ -120,10 +120,23 @@ UTF-16 units otherwise than by their bytes (one from U+E000 to U+FFFF beside one
U+FFFF); events at federation 1's sizes and just past them; a signature, a version and
its hash, a checkpoint and its ID, the genesis change of a federation's root and of a
fork's, a snapshot after a checkpoint, and a version naming an ECDSA key, with a write
-and a key set `ssh-keygen` signed with it. A vector that changes is a change of the
-federation, which takes its next number ([`federation.md`](federation.md),
+and a key set `ssh-keygen` signed with it. A vector that changes is a change to what
+every node must agree on ([`federation.md`](federation.md),
[Changing the federation](federation.md#changing-the-federation)).
+## The corpus
+
+What each revision takes, refuses and reads, as fixed bytes: for each revision this
+continuum knows, a file in `src/federation/corpus/` of histories generated at that
+revision (of every kind the properties generate, a few seeds each), each event's bytes
+with what became of it, by kind (taken, refused and why, by kind, waiting, held back, gone
+with a move), and what the store reads after. A revision's file is written once, as the
+revision is made (`write_the_corpus`, run by hand), and never edited after: every later
+continuum judges it alike (`every_revision_judges_as_its_corpus_says`), so that a change
+to judging that alters an earlier revision's comes as a later revision. Its first line
+names the revision by its ID: a feature renamed fails as a judgment changed does. It holds
+only what its histories exercise.
+
## Fuzzing and mutants
* **Fuzzing**, with `cargo fuzz` (a nightly compiler), outside `cargo quick`: the event
@@ -137,7 +150,7 @@ federation, which takes its next number ([`federation.md`](federation.md),
* `cargo quick`: the rules and attacks by example, the properties at small sizes and a
few hundred seeds, the store on Automerge by crafted changes and seeded runs, the
- vectors, and the check that every row has its test.
+ vectors, the corpus, and the check that every row has its test.
* `cargo sim`: the simulations.
* Longer runs, by hand or on a schedule: the properties and the store on Automerge with
many more seeds (a count from the environment), fuzzing, mutants.