why conformance
soft3 is fourteen repos that all serialize, hash, prove, and verify each other's values. one repo silently changes an encoding; every snapshot, proof, and signal produced before that change becomes unverifiable. the harness catches the change at the moment it happens, not months later at a downstream verifier.
the federated drift problem
an encoding change surfaces in three places at different times:
- the author who changes the encoding sees green tests — local tests pass because the encoding stays internally consistent
- a downstream verifier rejects previously valid commitments weeks later
- protocol governance learns afterwards, from the rejection
each link in this chain is invisible to the others. silent drift across repo boundaries is the failure mode of any federated stack.
the harness model
a single rule: every value whose encoding the protocol depends on registers a hemera fingerprint as a snapshot. every mechanism whose output the protocol depends on registers a fingerprint of its output on a fixed input. CI compares each snapshot to the registered fingerprint. drift fails the build. the snapshot moves only through a tier-appropriate bless ceremony.
why hemera makes it cheap
a snapshot stores 32 bytes — the hemera fingerprint of the canonical encoding. no test corpus, no fixture files, no encoded payloads on disk. one conformance/encoding.snap file per crate, ~100 lines, covers every stable type.
why nox makes mechanisms work
a mechanism snapshot is the hemera fingerprint of a nox program's output on a fixed input. nox executes deterministically by construction, so the scenario is its own simulator. mechanism conformance reduces to encoding conformance applied to a deterministic VM trace. same input, same nox version, same output, same fingerprint.
this also dissolves the "deterministic simulation runtime" gap separately: nox-as-simulator is stronger than a swappable async scheduler, because the trace is provable as well as reproducible.
the provable manifest
the conformance/ directory of every soft3 repo is itself a value. its canonical encoding has a hemera fingerprint. the union across all soft3 repos is the protocol's stability manifest at a given git revision. a zheng proof can be produced over this manifest root, attesting "this protocol revision conforms to manifest M" to any verifier without re-running the harness.
a field-native fingerprint stack makes the manifest a witness, not just a hash. snapshots become proof inputs.
relationship to Commonware's conformance primitive
Commonware introduced the idea of a conformance crate: encoded forms and mechanism outputs that should stay stable. their primitive uses traditional hashes; the snapshot is a fixture, the harness is a test.
cyber's version inherits the discipline and gains provability for free, because every fingerprint is already a Goldilocks-field element. the harness produces witnesses that ride the same proof rails as everything else in soft3.
Homonyms
soft3/hemera/docs
Hemera documentation explanation why Hemera works the way it does — design decisions and rationale. see explanation/ for the full index. guides task-oriented how-tos (phase 2 — not yet written). cli.md — hash files, check sums, encode/decode streams streaming.md — verified streaming for large files…
warriors/trisha/docs
Trisha documentation explanation why Trisha works the way it does — design decisions and rationale. architecture — how trisha fits in the soft3 stack gpu-backend — seven shaders, one pipeline, Metal/Vulkan/DX12 proof-file-format — TOML envelope + bincode proof bytes patching — vendor patching…
soft3/radio/docs
docs
neural/trident/docs
🔱 Trident Documentation [← Project Root](/neural/trident/readme) Organized following the [Diataxis](https://diataxis.fr/) framework: tutorials, how-to guides, reference, and explanation. 🎓 Tutorials: learning-oriented The Builder's Journey — six chapters that build one complete private application,…
neural/inf/docs
inf — a whitepaper inf is the language of a provable graph. you ask the cybergraph a question and get an answer; you state a change and the graph takes it. both come with a zheng proof that the result follows from the graph's committed state, and anyone holding the 32-byte graph root checks that…
soft3/zheng/docs
docs
neural/rune/docs
rune documentation Documentation follows [Diataxis](https://diataxis.fr) — four kinds, each serving a different need. The [specs](/neural/rune/specs) are the canonical reference (the fourth quadrant); this directory holds the other three. | | learning | working | |---|---|---| | **practical** |…
cyb/wysm/docs
docs
soft3/mir/docs
docs
neural/rs/docs
docs
soft3/foculus/docs
docs
bootloader/go-cyber/docs
Concepts (WIP) soft2 and soft3 [soft2 and soft3](/bootloader/go-cyber/docs/soft2-soft3-concepts) content from presentation knowledge graph content oracle particle cyberlink neuron consensus computer [cyber-sdk](#cyber-sdk-modules-documentation) resources tendermint abci ibc ikp sequential…
soft3/cybergraph/docs
cybergraph a knowledge graph where every change is a proven computation. not "someone wrote a fact and we trust them," and not "a contract moved tokens and we re-execute to check." instead: a neuron declares what it will do, runs it, and publishes a proof that it did exactly that — and anyone…
soft3/nox/docs
docs
soft3/glia/docs
docs
soft3/tru/docs
tru docs teaching and explanation for tru — the convergence VM. the normative contracts live in [specs/](/soft3/tru/specs); this tree explains and references them, it never duplicates them. explanation why tru works the way it does — narrative, derivations, background. see…
soft3/bbg/docs
docs
bootloader/space-pussy/docs
Documentation [WIP] Contents 1. **[Run validator guide](/bootloader/space-pussy/docs/run-validator)** 2. **[Use CLI guide](/bootloader/space-pussy/docs/ultimate-commands-guide)** 3. **[Setup daemon config guide](/bootloader/space-pussy/docs/setup-pussy-configuration)** 4. **[Setup local dev…
bootloader/space-pussy/client/docs
docs
cyb/honeycrisp/unimem/docs
docs
soft3/strata/genies/docs
docs
soft3/strata/jali/docs
docs
soft3/radio/iroh/docs
docs
cyb/honeycrisp/aruminium/docs
docs/ documentation for humans. three levels of depth. | file | audience | what's inside | |------|----------|--------------| | `tutorial.md` | newcomers | step-by-step first GPU program | | `guide.md` | practitioners | patterns, best practices, real workflows | | `explanations.md` | curious minds…
soft3/strata/trop/docs
docs
soft3/radio/docs/docs
docs eventually-consistent multi-dimensional key-value documents replica a document instance identified by a NamespaceId (public key). contains unlimited entries. the namespace private key grants write authority over the entire document entries and authors an entry is identified by the tuple…
bootloader/space-pussy/ts/docs
docs
soft3/radio/iroh-willow/docs
docs
soft3/radio/quinn/docs
docs
soft3/strata/nebu/docs
docs
soft3/strata/kuro/docs
docs
soft3/radio/iroh-blobs/docs
docs
bootloader/go-cyber/client/docs
docs
cyb/honeycrisp/acpu/docs
docs
cyb/honeycrisp/rane/docs
docs