Skip to content

Commit 4962a9b

Browse files
Update README.md for clarity and precision
1 parent 46a1ab8 commit 4962a9b

1 file changed

Lines changed: 10 additions & 9 deletions

File tree

spec/README.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ the `spec/` folder defines:
1616

1717
## 🧭 Purpose of This Folder
1818

19-
The documents in this folder define the **minimum required runtime behavior** of CrypSA, including:
19+
The documents in this folder define the **minimum required runtime behavior** of the CrypSA system, including:
2020

2121
* event structure and lifecycle
2222
* validation and invariant enforcement
@@ -28,26 +28,27 @@ The documents in this folder define the **minimum required runtime behavior** of
2828
* identity and object lifecycle
2929
* observer ↔ validator communication
3030

31-
These specifications make CrypSA:
31+
These specifications make CrypSA systems:
3232

3333
* implementable
3434
* testable
35-
* technically reviewable
35+
* technically verifiable
3636

3737
They do **not** define full production systems.
3838

3939
---
4040

4141
## ⚙️ Core Runtime Principle
4242

43-
> Canonical truth is defined by validated canonical events — not by synchronized state.
43+
> Canonical event history is the source of truth.
44+
> Derived canonical state is a projection of canonical event history. It is not the source of truth.
4445
4546
At runtime:
4647

4748
* observers propose candidate events
4849
* the validator evaluates them
4950
* accepted events are appended to canonical event history
50-
* derived canonical state is reconstructed via deterministic replay
51+
* derived canonical state is reconstructed by deterministic replay of canonical event history
5152

5253
This model applies regardless of validator deployment:
5354

@@ -82,10 +83,10 @@ This includes:
8283

8384
* event structure
8485
* validation behavior
85-
* canonical event handling
86+
* canonical event lifecycle and handling
8687
* ordering (`canonical_sequence`)
8788
* consistency and reconciliation rules
88-
* replay and derived state behavior
89+
* replay and derived canonical state behavior
8990
* snapshot behavior
9091
* identity and minting
9192
* transport expectations
@@ -150,7 +151,7 @@ All documents in this folder must:
150151

151152
If ambiguity exists:
152153

153-
> the Runtime Model defines final behavior
154+
> the Runtime Model defines authoritative runtime behavior
154155
155156
---
156157

@@ -243,4 +244,4 @@ These specifications are:
243244

244245
## One Sentence Summary
245246

246-
The `spec/` folder defines the authoritative runtime behavior of CrypSA—how events, validation, consistency, replay, identity, snapshots, and transport work together to produce shared canonical reality through validator-controlled canonical event history.
247+
The `spec/` folder defines the authoritative runtime behavior of CrypSA—how events, validation, consistency, replay, identity, snapshots, and transport work together to produce shared canonical reality defined by canonical event history.

0 commit comments

Comments
 (0)