Skip to content

Commit 46a1ab8

Browse files
Refine terminology in CrypSA Validation Model
Updated terminology for clarity and consistency throughout the document.
1 parent 227f328 commit 46a1ab8

1 file changed

Lines changed: 9 additions & 9 deletions

File tree

spec/CrypSA_Validation_Model.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Validation is the mechanism that:
1414

1515
In CrypSA:
1616

17-
> Observers may simulate freely, but only validated events become part of canonical event history.
17+
> Observers may simulate freely, but only validated events become canonical and are appended to canonical event history
1818
1919
Validation occurs at the **Invariant Boundary**, where proposed actions transition from local simulation to canonical event history.
2020

@@ -86,11 +86,11 @@ Checks include:
8686

8787
### 3. Precondition Validation
8888

89-
Ensures observers assumptions are still true.
89+
Ensures observers assumptions are still valid.
9090

9191
Checks include:
9292

93-
* expected state matches canonical state
93+
* expected state matches derived canonical state
9494
* required resources exist
9595
* required conditions hold
9696

@@ -147,7 +147,7 @@ These are not required for v0.1 runtime behavior.
147147
Validation must be:
148148

149149
* deterministic
150-
* atomic within conflict scope
150+
* atomic within the relevant conflict scope
151151
* based on canonical event history and derived canonical state
152152

153153
---
@@ -221,13 +221,13 @@ Examples:
221221
| ---------------- | --------------- |
222222
| Local simulation | Not validated |
223223
| UI interaction | Not validated |
224-
| Canonical events | Fully validated |
224+
| Candidate events | Fully validated |
225225

226226
---
227227

228228
## Performance Considerations
229229

230-
CrypSA reduces server load by:
230+
CrypSA reduces validator load by:
231231

232232
* avoiding full simulation
233233
* validating only boundary-crossing actions
@@ -241,7 +241,7 @@ CrypSA does not trust observer simulation.
241241

242242
It trusts:
243243

244-
> the validation process that determines canonical event history
244+
> the validation process that determines what becomes canonical
245245
246246
Observers may propose any action, but:
247247

@@ -263,7 +263,7 @@ Strategies include:
263263

264264
* idempotency checks
265265
* conflict resolution
266-
* ordering rules
266+
* ordering rules based on `canonical_sequence`
267267

268268
---
269269

@@ -291,4 +291,4 @@ CrypSA validation is:
291291
It ensures:
292292

293293
> observers may act freely,
294-
> but only valid actions become part of canonical event history
294+
> only validated actions become canonical and are appended to canonical event history

0 commit comments

Comments
 (0)