aethermesh 2.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,839 @@
1
+ Metadata-Version: 2.4
2
+ Name: aethermesh
3
+ Version: 2.0.0
4
+ Summary: AetherMesh v2.0.0: Reference implementation of the decentralized P2P agent synchronization architecture
5
+ Author-email: Samir Baladi <gitdeeper@gmail.com>
6
+ Maintainer-email: Samir Baladi <gitdeeper@gmail.com>
7
+ License: MIT
8
+ Project-URL: Homepage, https://aethermesh-web.netlify.app
9
+ Project-URL: Repository, https://github.com/gitdeeper15/aethermesh
10
+ Project-URL: Bug Tracker, https://github.com/gitdeeper15/aethermesh/issues
11
+ Project-URL: Research Paper, https://doi.org/10.5281/zenodo.24038038
12
+ Project-URL: Zenodo, https://doi.org/10.5281/zenodo.24038038
13
+ Project-URL: ORCID, https://orcid.org/0009-0003-8903-0029
14
+ Project-URL: Related Work (AetherGit), https://doi.org/10.5281/zenodo.23966896
15
+ Project-URL: Related Work (AetherFlow), https://doi.org/10.5281/zenodo.23979129
16
+ Project-URL: Related Work (AetherProof), https://doi.org/10.5281/zenodo.24013124
17
+ Keywords: peer-to-peer,crdt,conflict-free replicated data types,byzantine fault tolerance,gossip protocol,multi-agent systems,decentralized synchronization,eventual consistency,agentic software engineering,formal methods,distributed systems,AetherMesh
18
+ Classifier: Development Status :: 4 - Beta
19
+ Classifier: Intended Audience :: Science/Research
20
+ Classifier: License :: OSI Approved :: MIT License
21
+ Classifier: Programming Language :: Python :: 3
22
+ Classifier: Programming Language :: Python :: 3.9
23
+ Classifier: Programming Language :: Python :: 3.10
24
+ Classifier: Programming Language :: Python :: 3.11
25
+ Classifier: Programming Language :: Python :: 3.12
26
+ Classifier: Topic :: Scientific/Engineering
27
+ Classifier: Topic :: System :: Distributed Computing
28
+ Requires-Python: >=3.9
29
+ Description-Content-Type: text/markdown
30
+ License-File: LICENSE
31
+ License-File: AUTHORS.md
32
+ Requires-Dist: numpy>=1.24
33
+ Requires-Dist: cryptography>=41.0
34
+ Provides-Extra: dev
35
+ Requires-Dist: pytest>=7.0; extra == "dev"
36
+ Requires-Dist: pytest-cov>=4.0; extra == "dev"
37
+ Requires-Dist: ruff>=0.1; extra == "dev"
38
+ Requires-Dist: mypy>=1.0; extra == "dev"
39
+ Provides-Extra: experiments
40
+ Requires-Dist: matplotlib>=3.7; extra == "experiments"
41
+ Dynamic: license-file
42
+
43
+ <div align="center">
44
+
45
+ # πŸ•ΈοΈ AetherMesh
46
+
47
+ ### Decentralized Peer-to-Peer Agent Synchronization and State CRDTs for Autonomous Multi-Agent Systems
48
+
49
+ *A Formal Architecture for Epidemic Gossip Propagation and Lightweight Byzantine Fault Tolerance at Agent Scale*
50
+
51
+ <br>
52
+
53
+ [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.24038038.svg)](https://doi.org/10.5281/zenodo.24038038)
54
+ [![License: MIT + CC-BY-4.0](https://img.shields.io/badge/License-MIT%20%2B%20CC--BY--4.0-crimson.svg)](LICENSE)
55
+ [![ORCID](https://img.shields.io/badge/ORCID-0009--0003--8903--0029-a6ce39?logo=orcid&logoColor=white)](https://orcid.org/0009-0003-8903-0029)
56
+ [![Release](https://img.shields.io/badge/Release-v2.0.0-green)](https://github.com/gitdeeper15/aethermesh/releases/tag/v2.0.0)
57
+ [![Python](https://img.shields.io/badge/Python-3.9%2B-blue.svg?logo=python&logoColor=white)](https://python.org)
58
+
59
+ [![PyPI](https://img.shields.io/badge/PyPI-2.0.0-gold?logo=pypi&logoColor=white)](https://pypi.org/project/aethermesh/)
60
+ [![PyPI downloads](https://img.shields.io/pypi/dm/aethermesh?label=downloads)](https://pypi.org/project/aethermesh/)
61
+ [![PyPI status](https://img.shields.io/pypi/status/aethermesh)](https://pypi.org/project/aethermesh/)
62
+ [![Tests](https://img.shields.io/badge/Tests-107%20passed-brightgreen)](tests/)
63
+ [![Coverage](https://img.shields.io/badge/Coverage-79%25-yellowgreen)](tests/)
64
+ [![Experiments](https://img.shields.io/badge/Experiments-3%2F3-brightgreen)](experiments/)
65
+
66
+ [![Zenodo](https://img.shields.io/badge/Zenodo-Published-blue)](https://doi.org/10.5281/zenodo.24038038)
67
+ [![Record ID](https://img.shields.io/badge/Record%20ID-AETHERMESH--02-informational)](https://doi.org/10.5281/zenodo.24038038)
68
+ [![OSF: 10.17605/OSF.IO/9PE5V](https://img.shields.io/badge/OSF-10.17605%2FOSF.IO%2F9PE5V-blue)](https://doi.org/10.17605/OSF.IO/9PE5V)
69
+ [![Website](https://img.shields.io/badge/Website-aethermesh--web.netlify.app-00C7B7?logo=netlify&logoColor=white)](https://aethermesh-web.netlify.app)
70
+ [![Aether Family](https://img.shields.io/badge/Aether%20Family-4%20layers-purple)](https://aethermesh-web.netlify.app)
71
+
72
+ <br>
73
+
74
+ **[πŸ“„ Paper](https://doi.org/10.5281/zenodo.24038038)** Β·
75
+ **[🌐 Website](https://aethermesh-web.netlify.app)** ·
76
+ **[πŸ“¦ Releases](https://github.com/gitdeeper15/aethermesh/releases)** Β·
77
+ **[βš™οΈ Installation](#️-installation)** Β·
78
+ **[πŸ“– Citation](#-citation)**
79
+
80
+ </div>
81
+
82
+ ---
83
+
84
+ > [!WARNING]
85
+ > **Status: v2.0.0 β€” Reference Implementation (preliminary results).**
86
+ > A reference implementation is built (`src/aethermesh/`, 15 modules, 107 tests, 79% coverage) and 3 experiments are completed.
87
+ > **Experiments use simulated data; no real-world deployment is evaluated.**
88
+ > Theorems 1–3 remain **proof sketches**, not machine-checked; they hold only under assumptions A1–A6.
89
+ > The semantic validity of merged programs (the *semantic-merge gap*) remains an open problem (threat T2, open question Q6).
90
+ > See [Threats and Limitations](#️-threats-and-limitations) and the [Research Status Statement](#-research-status-statement).
91
+
92
+ > *"The simulation results here are an invitation to such evaluation, not a substitute for it."*
93
+ > β€” AetherMesh v1.0.0, Section 8.2
94
+
95
+ > *"We state the evidentiary status of this work at the outset, because it determines how every later claim should be read."*
96
+ > β€” AetherMesh v1.0.0, Section 1.4
97
+
98
+ ---
99
+
100
+ ## πŸ“‘ Table of Contents
101
+
102
+ - [Overview](#-overview)
103
+ - [v2.0.0 at a Glance](#-v200-at-a-glance)
104
+ - [Installation](#️-installation)
105
+ - [Experiments (v2.0.0)](#-experiments-v200)
106
+ - [The Central Question](#-the-central-question)
107
+ - [Assumptions A1–A6](#-assumptions-a1a6)
108
+ - [Formal Definitions](#-formal-definitions)
109
+ - [Theorems](#-theorems)
110
+ - [Architectural Pillars](#️-architectural-pillars)
111
+ - [Simulated Evaluation (v1.0.0 paper)](#-simulated-evaluation-v100-paper)
112
+ - [Threats and Limitations](#️-threats-and-limitations)
113
+ - [Relation to AetherGit, AetherFlow, and AetherProof](#-relation-to-aethergit-aetherflow-and-aetherproof)
114
+ - [Research Status Statement](#-research-status-statement)
115
+ - [Platforms & Mirrors](#-platforms--mirrors)
116
+ - [Project Structure](#️-project-structure)
117
+ - [Version History](#-version-history)
118
+ - [Citation](#-citation)
119
+ - [Author](#-author)
120
+ - [License](#️-license)
121
+
122
+ ---
123
+
124
+ ## πŸ”­ Overview
125
+
126
+ **AetherMesh** is a fully decentralized peer-to-peer synchronization framework for autonomous agent networks that modify shared codebases and metadata DAGs. It replaces locking and central coordination with a **tripartite architecture**, and is the **decentralization layer** (fourth layer) of the Aether family, above **AetherGit** (storage), **AetherFlow** (integration), and **AetherProof** (verification).
127
+
128
+ AetherMesh answers three questions together:
129
+
130
+ 1. **How are concurrent changes combined** without coordination? β†’ CRDTs
131
+ 2. **How are they disseminated** without a central broker? β†’ Epidemic gossip
132
+ 3. **Which received changes may a node trust** when some peers may be faulty or hostile? β†’ Lightweight Byzantine admission
133
+
134
+ | Release | What it adds |
135
+ |---|---|
136
+ | **v1.0.0** | Architecture specified: 4 definitions, 3 theorems, 6 assumptions, 3 pillars, with a simulated evaluation (paper) |
137
+ | **v2.0.0** | Reference implementation (`src/aethermesh/`): 107 tests, 79% coverage, 3 reproducible experiments |
138
+
139
+ ---
140
+
141
+ ## πŸ“Š v2.0.0 at a Glance
142
+
143
+ | Dimension | Status |
144
+ |---|---|
145
+ | Manuscript (v1.0.0) | Complete (33 pages, PDF) |
146
+ | Formal definitions / Theorems / Pillars | 4 / 3 (proof sketches) / 3 |
147
+ | Implementation | βœ… Built β€” `src/aethermesh/` (15 modules) |
148
+ | Tests | βœ… 107 passed, 79% coverage |
149
+ | Experiments | βœ… 3/3 completed (simulated data) |
150
+ | PyPI package | βœ… Published |
151
+ | Real-world deployment | ❌ Not evaluated |
152
+ | Causal claims | None (formal analysis only) |
153
+
154
+ <p align="center">
155
+ <img src="docs/figures/Fig1_Tripartite_Architecture.png"
156
+ alt="AetherMesh β€” Tripartite Architecture"
157
+ width="100%">
158
+ </p>
159
+
160
+ <p align="center">
161
+ <em>Figure 1 β€” The tripartite architecture of AetherMesh: CRDTs, gossip, and lightweight BFT sit above the peer-to-peer agent network. No central coordinator Β· no global locks Β· eventual consistency (under stated assumptions).</em>
162
+ </p>
163
+
164
+ ### Contributions
165
+
166
+ | # | Contribution | Kind |
167
+ |:-:|---|---|
168
+ | 1 | A tripartite architecture combining code- and metadata-specific CRDTs, epidemic gossip, and a local Byzantine admission layer | Specification |
169
+ | 2 | A formal model of four definitions and three theorems (with proof sketches), with assumptions A1–A6 written out explicitly β€” including an **admission determinism** requirement (A6) | Analysis |
170
+ | 3 | A simulated evaluation of convergence latency, conflict-resolution overhead, and fault resilience, with our own analysis showing the reported values are **not consistent with a pure logarithmic law** | Simulation + analysis |
171
+ | 4 | A threat taxonomy of fifteen threats across six classes | Analysis |
172
+ | 5 | **A reference implementation** (v2.0.0) with 107 tests, 79% coverage, and 3 reproducible experiments | Implementation |
173
+
174
+ ---
175
+
176
+ ## βš™οΈ Installation
177
+
178
+ ```bash
179
+ # From PyPI (once published)
180
+ pip install aethermesh
181
+
182
+ # From source (development)
183
+ git clone https://github.com/gitdeeper15/aethermesh.git
184
+ cd aethermesh
185
+ pip install -e ".[dev]"
186
+
187
+ # Run tests
188
+ pytest
189
+
190
+ # Run experiments
191
+ python experiments/convergence_latency/run.py
192
+ python experiments/conflict_resolution/run.py
193
+ python experiments/fault_resilience/run.py
194
+
195
+ # CLI
196
+ aethermesh info
197
+ aethermesh verify
198
+ aethermesh simulate --nodes 50 --fanout 5
199
+ ```
200
+
201
+ Requires **Python 3.9+**. Runtime dependencies: `numpy >= 1.24`, `cryptography >= 41.0`.
202
+
203
+ > [!NOTE]
204
+ > The PyPI version (`2.0.0`) is the **reference implementation**. It is **not a production system**. The v1.0.0 paper remains the authoritative architectural record.
205
+
206
+ ---
207
+
208
+ ## πŸ§ͺ Experiments (v2.0.0)
209
+
210
+ | # | Experiment | Result | Status |
211
+ |:-:|---|---|:-:|
212
+ | 1 | Convergence Latency | Converged at 1–2 rounds (10–500 nodes) | βœ… |
213
+ | 2 | Conflict Resolution | 0 deadlocks, 0 conflicts flagged | βœ… |
214
+ | 3 | Fault Resilience | 100% block rate (10–500 malformed) | βœ… |
215
+
216
+ > [!IMPORTANT]
217
+ > Experiments use **simulated data**. These are preliminary results; no real-world deployment has been evaluated. See the full [evaluation report](REPORTS/v2.0.0/report.md).
218
+
219
+ ---
220
+
221
+ ## ❓ The Central Question
222
+
223
+ > **How can autonomous agents synchronize shared code and metadata without central coordination β€” combining concurrent changes, disseminating them, and deciding which received changes to trust β€” and under which explicit assumptions may the combined guarantees hold?**
224
+
225
+ This question is **structural**, not accusatory or normative. The three mechanisms (CRDTs, gossip, BFT-style filtering) are individually well known; the contribution is their specification as a single architecture for code and metadata DAGs, the explicit assumptions of the composition, and an evaluation that is clearly bounded in what it can show.
226
+
227
+ ---
228
+
229
+ ## 🧭 Assumptions A1–A6
230
+
231
+ *Every theorem below is conditional on these assumptions.*
232
+
233
+ | ID | Assumption | Used by |
234
+ |:-:|---|:-:|
235
+ | **A1** | **Fair-lossy channels.** A message sent infinitely often between two non-faulty nodes is delivered infinitely often. | T1 |
236
+ | **A2** | **Fair peer selection.** Each non-faulty node selects every other non-faulty node as a gossip partner infinitely often; for Theorem 2, selection is uniform and independent. | T1, T2 |
237
+ | **A3** | **Finite delta universe.** The set of deltas that will ever be created is finite, so the lattice has finite height. | T1 |
238
+ | **A4** | **Correct replicas.** Non-faulty nodes implement the join and the materialization function correctly and deterministically. | T1 |
239
+ | **A5** | **Cryptographic soundness.** Signature and hash schemes are unforgeable and collision-resistant, and the key registry is correct for the origins concerned. | T3 |
240
+ | **A6** | **Admission determinism.** Admission predicates are deterministic functions of the delta and its causal closure. | T1, T3 |
241
+
242
+ > [!NOTE]
243
+ > The supplied statement of Theorem 1 used β€œbounded message delay”. That is a synchrony assumption stronger than needed for eventual consistency; fair-lossy channels (A1) with continuing gossip suffice for the qualitative convergence claim.
244
+
245
+ ---
246
+
247
+ ## πŸ“ Formal Definitions
248
+
249
+ *Status: Defined, version 1.0.0.*
250
+
251
+ ### Definition 1 β€” Convergent State Transition
252
+
253
+ ```text
254
+ R_a(t+1) = R_a(t) βŠ” ⨆_{m ∈ M_a} m (1)
255
+ ```
256
+
257
+ Each agent `a` keeps a local replica `R_a(t)`; `M_a` is the set of incoming mutation payloads **that passed admission** during `(t, t+1)`. By commutativity, associativity, and idempotence, the order and multiplicity of payloads do not matter.
258
+
259
+ ### Definition 2 β€” CRDT State Space
260
+
261
+ ```text
262
+ (S, βŠ”, βŠ₯) bounded join-semilattice, s_reconciled = s_i βŠ” s_j (2)
263
+ ```
264
+
265
+ where `βŠ”` is binary, commutative, associative, and idempotent.
266
+
267
+ | Property | Law | Operational consequence |
268
+ |---|---|---|
269
+ | Commutative | `sα΅’ βŠ” sβ±Ό = sβ±Ό βŠ” sα΅’` | Merge order does not matter |
270
+ | Associative | `(sα΅’ βŠ” sβ±Ό) βŠ” sβ‚– = sα΅’ βŠ” (sβ±Ό βŠ” sβ‚–)` | Batching and grouping do not matter |
271
+ | Idempotent | `sα΅’ βŠ” sα΅’ = sα΅’` | Duplicate delivery is harmless |
272
+ | Inflationary (derived) | `s βŠ‘ s βŠ” t` | State never moves down the lattice; no rollback |
273
+
274
+ <p align="center">
275
+ <img src="docs/figures/Fig2_CRDT_Join_Semilattice.png"
276
+ alt="AetherMesh β€” CRDT Join-Semilattice (Hasse diagram)"
277
+ width="100%">
278
+ </p>
279
+
280
+ <p align="center">
281
+ <em>Figure 4 β€” A seven-element bounded join-semilattice as a Hasse diagram (βŠ₯, s₁–s₃, s₁₂, s₂₃, ⊀). The join laws were verified on this example by exhaustive enumeration. An illustration of the algebra, not a model of a real codebase.</em>
282
+ </p>
283
+
284
+ ### Definition 3 β€” Gossip Infection Probability
285
+
286
+ ```text
287
+ P_uninfected(t) β‰ˆ e^(βˆ’Ξ²Β·t) (3)
288
+ ```
289
+
290
+ `Ξ²` is the transmission rate constant determined by fanout `k` and exchange frequency `r`.
291
+
292
+ ### Definition 4 β€” Byzantine Admission Rule
293
+
294
+ Before a peer accepts a remote CRDT delta `Ξ”α΅’`, local verification daemons evaluate **cryptographic provenance**, **structural invariants**, and **semantic compatibility matrices**. Only deltas bearing valid signatures and satisfying the local predicates are admitted to the local join-semilattice.
295
+
296
+ ---
297
+
298
+ ## πŸ“œ Theorems
299
+
300
+ > [!NOTE]
301
+ > *Status: Stated with proof sketches; **not machine-checked**; conditional on assumptions A1–A6.*
302
+
303
+ | # | Theorem | Statement | Assumptions |
304
+ |:-:|---|---|:-:|
305
+ | **T1** | Eventual Consistency | Given continuous gossip activity and channels that eventually deliver, any two non-faulty agents `aα΅’`, `aβ±Ό` eventually reach an identical state. Given finite height (A3), the limits are attained at a finite time. | A1–A6 |
306
+ | **T2** | Exponential Dampening of Gossip Latency | Under the constant-hazard model, `P_uninfected(t) = (1βˆ’p)^t β‰ˆ e^(βˆ’Ξ²t)` with `Ξ² = βˆ’ln(1βˆ’p) β‰ˆ p` for small `p`. A statement about the **tail** of the dissemination. | A2 |
307
+ | **T3** | Byzantine Fault Tolerance Bound | If `f < n/3`, local verification predicates at each honest node block all **predicate-detectable** invalid deltas with probability approaching 1. | A5, A6 |
308
+
309
+ **Theorem 3 β€” committee bound.** Where a decision cannot be made locally, a delta is accepted on a majority of attestations from a random committee of size `m`. Under independent sampling with Byzantine probability ≀ 1/3, the Chernoff–Hoeffding bound gives `P[Byzantine majority] ≀ exp(βˆ’0.0589Β·m)`:
310
+
311
+ | Committee size `m` | Upper bound on P[Byzantine majority] |
312
+ |:-:|:-:|
313
+ | 25 | 2.29e-01 |
314
+ | 50 | 5.26e-02 |
315
+ | 100 | 2.77e-03 |
316
+ | 200 | 7.67e-06 |
317
+ | 400 | 5.88e-11 |
318
+
319
+ *Values are the output of a formula under stated assumptions, not simulation results.*
320
+
321
+ <p align="center">
322
+ <img src="docs/figures/Fig3_Gossip_Propagation.png"
323
+ alt="AetherMesh β€” Gossip Propagation"
324
+ width="100%">
325
+ </p>
326
+
327
+ <p align="center">
328
+ <em>Figure 8 β€” (a) Analytic curves of Equation (3) for Ξ² = 0.3, 0.5, 0.8 (plots of a formula). (b) Convergence latency versus network size for the five simulation-reported points; not a measurement of a deployed system.</em>
329
+ </p>
330
+
331
+ <details>
332
+ <summary><b>What the proof sketches do <u>not</u> show</b></summary>
333
+
334
+ - **T1** gives no time bound; presumes `M*` is finite (or β€œeventually” is read relative to a fixed prefix); presumes A6, which a predicate author could violate; concerns non-faulty nodes only; says nothing about **semantic validity** of the materialized program; treats the agent set as fixed.
335
+ - **T3** does not show that invalid deltas *outside* the predicates are blocked β€” harmful but well-formed deltas from a signed, registered, Byzantine agent are admitted. It does not address colluding committees, Sybil identities, key compromise, or flooding.
336
+
337
+ </details>
338
+
339
+ ---
340
+
341
+ ## πŸ›οΈ Architectural Pillars
342
+
343
+ | Pillar | Name | Summary |
344
+ |:-:|---|---|
345
+ | **1** | CRDTs for Code and Metadata DAGs | Replica state is the **set of admitted deltas** (grow-only set lifted to deltas; set union is the join). The materialized codebase is a deterministic function of the delta set (topological order with identifier tie-break). Metadata uses a product lattice (OR-sets, LWW registers, grow-only maps). **Delta-state** replication by default, state-based fallback for large divergence and joining nodes. |
346
+ | **2** | Epidemic Gossip Protocols | Five-step anti-entropy exchange (digest β†’ digest + difference list β†’ delta request β†’ delta batch β†’ local verification and join). Digest form is a parameter: version vector, Merkle tree, or Bloom-style filter. Uniform random peer selection over a partial view. Partitions heal on the first cross-partition exchange. |
347
+ | **3** | Lightweight Byzantine Fault Tolerance | Validity **filtering**, deliberately **not** a consensus protocol: (1) signature, (2) DAG integrity, (3) schema, (4) semantic compatibility matrix. Missing parents are **deferred**, not rejected. Predicates must satisfy the **admission determinism requirement** (A6). |
348
+
349
+ <p align="center">
350
+ <img src="docs/figures/Fig8_Node_Anatomy.png"
351
+ alt="AetherMesh β€” Anatomy of a Node"
352
+ width="100%">
353
+ </p>
354
+
355
+ <p align="center">
356
+ <em>Figure 3 β€” Anatomy of an AetherMesh node. The only storage requirement is an append-only changeset log with parent pointers; the only integration requirement is a message-based protocol.</em>
357
+ </p>
358
+
359
+ <p align="center">
360
+ <img src="docs/figures/Fig7_Gossip_Exchange.png"
361
+ alt="AetherMesh β€” Anti-Entropy Gossip Exchange"
362
+ width="100%">
363
+ </p>
364
+
365
+ <p align="center">
366
+ <em>Figure 5 β€” One anti-entropy exchange between two peers. Received deltas pass through the admission pipeline before they are joined; deltas whose parents are not yet present are deferred rather than rejected.</em>
367
+ </p>
368
+
369
+ <p align="center">
370
+ <img src="docs/figures/Fig9_Partition_Healing.png"
371
+ alt="AetherMesh β€” Partition, Divergence, and Healing"
372
+ width="100%">
373
+ </p>
374
+
375
+ <p align="center">
376
+ <em>Figure 6 β€” Schematic of replica divergence during a partition and of healing. Conceptual; plots no measured data.</em>
377
+ </p>
378
+
379
+ ### πŸ” Byzantine Admission Pipeline
380
+
381
+ <p align="center">
382
+ <img src="docs/figures/Fig4_BFT_Validation.png"
383
+ alt="AetherMesh β€” Byzantine Admission Pipeline"
384
+ width="100%">
385
+ </p>
386
+
387
+ <p align="center">
388
+ <em>Figure 7 β€” A remote delta passes through signature, DAG-integrity, schema, and semantic-compatibility checks before joining the local semilattice. The banner restates simulation-reported results and is not a measurement of a deployed system.</em>
389
+ </p>
390
+
391
+ | Check | Evidence required | Typical failure | Verdict on failure |
392
+ |:-:|---|---|---|
393
+ | 1. Signature | Valid signature by a registered key over the content hash | Forged or unsigned delta; unknown origin | Reject |
394
+ | 2. DAG integrity | Id equals content hash; parents present; size bounds | Hash mismatch; oversized; missing parents | Reject (mismatch, bounds); defer (missing parents) |
395
+ | 3. Schema | Body parses against the delta schema | Malformed fields | Reject |
396
+ | 4. Semantics | Compatibility matrix verdict over the causal closure | Incompatible concurrent operation | Reject or quarantine, as configured |
397
+
398
+ <details>
399
+ <summary><b>Illustrative semantic compatibility matrix (Table 3.1 β€” entries are examples, not normative)</b></summary>
400
+
401
+ | | Edit body | Rename symbol | Delete symbol | Change signature | Edit metadata |
402
+ |---|:-:|:-:|:-:|:-:|:-:|
403
+ | **Edit body** | ok | ok | conflict | ok | ok |
404
+ | **Rename symbol** | ok | resolve (deterministic rule) | conflict | conflict | ok |
405
+ | **Delete symbol** | conflict | conflict | ok (idempotent) | conflict | ok |
406
+ | **Change signature** | ok | conflict | conflict | resolve (deterministic rule) | ok |
407
+ | **Edit metadata** | ok | ok | ok | ok | resolve (LWW) |
408
+
409
+ </details>
410
+
411
+ > [!IMPORTANT]
412
+ > **Admission determinism requirement (our formulation).** Each admission predicate must be a pure, deterministic function of the delta and of its *causal closure* β€” not of arrival order, local clock, or non-causal replica contents. Local checks such as per-origin rate limits are treated as **delivery policies** that may delay a delta but never permanently reject it.
413
+
414
+ ---
415
+
416
+ ## πŸ§ͺ Simulated Evaluation (v1.0.0 paper)
417
+
418
+ > [!IMPORTANT]
419
+ > This section reports the **paper's** simulation (v1.0.0), distinct from the v2.0.0 experiments above. Every number is a **simulation result** from a custom Python + NumPy discrete simulation (10–500 nodes, partitioned topologies, simplified network model). **None is a measurement of a deployed system.** Simulator source, seeds, and raw traces are not included in the paper record.
420
+
421
+ ### Reported results
422
+
423
+ | # | Metric | Simulation-reported result | Reading |
424
+ |:-:|---|---|---|
425
+ | 1 | State convergence latency (99% of network) | **420 ms at 250 nodes** (below 450 ms); 45–680 ms over 10–500 nodes | Reported; scaling is **not** log-linear |
426
+ | 2 | Conflict-resolution overhead | No blocking deadlocks; CPU < 5%; memory < 10% | Deadlock-freedom follows from design; overhead baseline undefined |
427
+ | 3 | Fault resilience | All injected malformed deltas blocked; 0% false positives; throughput overhead < 2% | Pipeline check for predicate-detectable faults; number injected unreported |
428
+
429
+ | Nodes | 10 | 50 | 100 | 250 | 500 |
430
+ |---|:-:|:-:|:-:|:-:|:-:|
431
+ | Convergence time (ms), simulated | 45 | 120 | 210 | 420 | 680 |
432
+
433
+ ### Our scaling analysis
434
+
435
+ The source material described scaling as β€œlinear with log(n)”. Fitting the five reported points (computed by us; no other data used):
436
+
437
+ | Model | Fit | Quality |
438
+ |---|---|---|
439
+ | Linear in ln n | `T β‰ˆ 156Β·ln n βˆ’ 409` | RΒ² = 0.85 (predicts βˆ’50 ms at n = 10) |
440
+ | Linear in n | `T β‰ˆ 1.28Β·n + 62` | RΒ² = 0.99 |
441
+ | **Power law** | `T β‰ˆ 8.4Β·n^0.70` | **RΒ² = 0.997 (log-log)** β€” best of the three |
442
+
443
+ > [!WARNING]
444
+ > **The reported values are not consistent with logarithmic scaling.** With only five points and two or three fitted parameters, the exponent is imprecise; we do not claim the true law is a power law.
445
+
446
+ | Nodes `n` | Reported (sim.), ms | Eq. (4), ms | Refined push estimate, ms | Reported / Eq. (4) |
447
+ |:-:|:-:|:-:|:-:|:-:|
448
+ | 10 | 45 | 46 | 175 | 1.0Γ— |
449
+ | 50 | 120 | 78 | 297 | 1.5Γ— |
450
+ | 100 | 210 | 92 | 349 | 2.3Γ— |
451
+ | 250 | 420 | 110 | 419 | 3.8Γ— |
452
+ | 500 | 680 | 124 | 471 | 5.5Γ— |
453
+
454
+ *Eq. (4): `T β‰ˆ (ln n)/(kΒ·r)` with illustrative `k = 5`, `r = 10 Hz`. Computed by us from the formulas; not simulation output.*
455
+
456
+ <p align="center">
457
+ <img src="docs/figures/Fig6_Scaling_Analysis.png"
458
+ alt="AetherMesh β€” Scaling Analysis"
459
+ width="100%">
460
+ </p>
461
+
462
+ <p align="center">
463
+ <em>Figure 9 β€” The five simulation-reported convergence times with three fitted laws and the analytic scaling of Equation (4). Fits and the analytic curve are computed by us; only the five points are simulation-reported.</em>
464
+ </p>
465
+
466
+ ### Simulation limitations
467
+
468
+ - **Simulated data** β€” no real-world deployment evaluated.
469
+ - **Scale** β€” 10–500 nodes; behavior at thousands of nodes is unknown.
470
+ - **Simplified network model** β€” no real latency, packet loss, churn, NAT, or adversarial network conditions.
471
+ - **Byzantine model** β€” limited to malformed deltas; colluding, equivocating, withholding, flooding, and Sybil adversaries not evaluated.
472
+ - **Missing statistics** β€” number of runs, variance, confidence intervals, fanout, period, and baseline definition are not reported.
473
+ - **No ablation** β€” contribution of each pillar not isolated; no gossip-only or consensus-based comparison.
474
+
475
+ ---
476
+
477
+ ## ⚠️ Threats and Limitations
478
+
479
+ Fifteen threats (T1–T15) across six classes; residual-risk entries are the author's qualitative judgements, not measurements.
480
+
481
+ | ID | Class | Threat | Residual risk |
482
+ |:-:|---|---|---|
483
+ | T1 | Soundness | Admission nondeterminism causes divergent admitted sets | Medium |
484
+ | T2 | Soundness | Semantic-merge gap: valid deltas combine into an invalid program | High |
485
+ | T3 | Soundness | Proof sketches contain errors | Medium |
486
+ | T4 | Completeness | Well-formed but harmful deltas admitted | High |
487
+ | T5 | Completeness | False rejection from strict schema or version skew | Medium |
488
+ | T6 | Trust | Key registry bootstrap or compromise | High |
489
+ | T7 | Trust | Collusion or Sybil identities exceed n/3 | High (open membership) |
490
+ | T8 | Trust | Eclipse or peer-sampling bias | Medium to high |
491
+ | T9 | Process | Flooding, oversized digests, deferral exhaustion | Medium |
492
+ | T10 | Process | Unbounded history growth; unsafe compaction | Medium |
493
+ | T11 | Process | Costly healing after long partitions | Unknown (not simulated) |
494
+ | T12 | Toolchain | Simulator infidelity to real networks | High until evaluated |
495
+ | T13 | Toolchain | Crypto-library, serialization, or schema skew faults | Medium |
496
+ | T14 | Human | Operator misconfiguration | Medium |
497
+ | T15 | Human | Reliance on simulated results as deployed evidence | Medium |
498
+
499
+ **When *not* to use AetherMesh:** small co-located teams; strong-consistency requirements (global order, unique-name allocation, exactly-once external effects); settings where validity must hold before visibility; adversarial settings beyond the stated threat model; storage-constrained nodes (the delta set grows without compaction).
500
+
501
+ **Architectural limitations:** eventual (not strong) consistency; no global order; filters only predicate-detectable invalid deltas; assumes a trustworthy key registry; grows without compaction.
502
+
503
+ ---
504
+
505
+ ## πŸ”— Relation to AetherGit, AetherFlow, and AetherProof
506
+
507
+ AetherMesh is the **fourth layer** of the Aether family:
508
+
509
+ ```mermaid
510
+ flowchart BT
511
+ G["πŸ—„οΈ AetherGit<br/><sub>Storage layer</sub>"] --> F["πŸ”€ AetherFlow<br/><sub>Integration layer</sub>"] --> P["πŸ“š AetherProof<br/><sub>Verification layer</sub>"] --> M["πŸ•ΈοΈ AetherMesh<br/><sub>Decentralization layer</sub>"]
512
+ ```
513
+
514
+ | Layer | System | Question it answers | DOI | What AetherMesh requires from it |
515
+ |---|---|---|---|---|
516
+ | Storage | **AetherGit** | How are changes stored and transferred? | [10.5281/zenodo.23966896](https://doi.org/10.5281/zenodo.23966896) | An append-only changeset log with parent pointers |
517
+ | Integration | **AetherFlow** | How are changes admitted, verified, and remediated? | [10.5281/zenodo.23979129](https://doi.org/10.5281/zenodo.23979129) | A message-based protocol for submitting changes and receiving notifications |
518
+ | Verification | **AetherProof** | What conditions make behavior correct, and how are they proven? | [10.5281/zenodo.24013124](https://doi.org/10.5281/zenodo.24013124) | Nothing mandatory; proof evidence may be carried as delta metadata |
519
+ | Decentralization | **AetherMesh** *(this work)* | How do agents synchronize state without central coordination? | [10.5281/zenodo.24038038](https://doi.org/10.5281/zenodo.24038038) | β€” |
520
+
521
+ <p align="center">
522
+ <img src="docs/figures/Fig5_Aether_Family.png"
523
+ alt="AetherMesh β€” The Aether Family, Four Layers"
524
+ width="100%">
525
+ </p>
526
+
527
+ <p align="center">
528
+ <em>Figure 2 β€” The Aether family, bottom to top: storage, integration, verification, decentralization. Each layer is shown with its DOI and the question it addresses.</em>
529
+ </p>
530
+
531
+ The four layers are **methodologically independent**: AetherMesh imposes only the two minimal interface requirements above. Cross-layer compositions have not been built or evaluated; the independence is a design claim, not a verified one.
532
+
533
+ ---
534
+
535
+ ## πŸ“‹ Research Status Statement
536
+
537
+ | Item | Status |
538
+ |---|---|
539
+ | Document type | Research article + reference implementation |
540
+ | Version / record | 2.0.0, November 2026 Β· AETHERMESH-02 Β· DOI 10.5281/zenodo.24038038 |
541
+ | Implementation | βœ… Built (`src/aethermesh/`, 15 modules) |
542
+ | Tests | βœ… 107 passed, 79% coverage |
543
+ | Experiments | βœ… 3/3 completed (simulated data) |
544
+ | PyPI package | βœ… Published |
545
+ | Real-world deployment | None; no deployed system has been benchmarked |
546
+ | Theorems 1–3 | Stated with proof sketches; not machine-checked; conditional on A1–A6 |
547
+ | Byzantine evaluation | Limited to malformed deltas |
548
+ | Third-party claims | As reported by cited sources; not independently verified |
549
+ | Review status | Not peer reviewed |
550
+
551
+ <details>
552
+ <summary><b>Reconciliation notes (v1.0.0 departures from the supplied draft material)</b></summary>
553
+
554
+ 1. **Theorem status** β€” labeled as sketches, not β€œProven”.
555
+ 2. **Delay assumption** β€” β€œbounded message delay” replaced by fair-lossy channels (A1).
556
+ 3. **Admission determinism** β€” A6 and Section 3.3.4 added.
557
+ 4. **Theorem 3** β€” scope clarified to predicate-detectable invalid deltas; n/3 bound placed in the quorum-based part with a Chernoff–Hoeffding bound.
558
+ 5. **Latency bound** β€” the 110 ms estimate does not match the experimental result across sizes; text says so.
559
+ 6. **Scaling claim** β€” β€œlinear with log(n)” not supported by the five reported points.
560
+ 7. **Deadlock elimination / 100% blocking** β€” largely from design and from the class of faults injected; denominators not supplied.
561
+ 8. **Figures** β€” the five supplied figures were redrawn; Figures 6–9 are supplementary.
562
+ 9. **Conclusion wording** β€” softened to match the evidence.
563
+ 10. **References** β€” assembled from knowledge; verification before submission recommended.
564
+
565
+ </details>
566
+
567
+ **Catalogues:** 50 open questions (Q1–Q50) across formal analysis, state and storage, gossip and performance, Byzantine tolerance and trust, integration with other layers, and evaluation method; 52 design decisions (D1–D52). See Appendices B and C of the [paper](https://doi.org/10.5281/zenodo.24038038).
568
+
569
+ ---
570
+
571
+ ## 🌍 Platforms & Mirrors
572
+
573
+ | Platform | URL | Role | Status |
574
+ |---|---|---|:-:|
575
+ | **GitHub** | [gitdeeper15/aethermesh](https://github.com/gitdeeper15/aethermesh) | Source code, issues, PRs | βœ… Active |
576
+ | **GitLab** | [gitlab.com/gitdeeper15/aethermesh](https://gitlab.com/gitdeeper15/aethermesh) | Mirror repository | βœ… Active |
577
+ | **Codeberg** | [codeberg.org/gitdeeper15/aethermesh](https://codeberg.org/gitdeeper15/aethermesh) | Mirror repository | βœ… Active |
578
+ | **Bitbucket** | [bitbucket.org/gitdeeper15/aethermesh](https://bitbucket.org/gitdeeper15/aethermesh) | Mirror repository | βœ… Active |
579
+ | **PyPI** | [pypi.org/project/aethermesh](https://pypi.org/project/aethermesh/) | Python package (`2.0.0`) | βœ… Published |
580
+ | **Zenodo** | [10.5281/zenodo.24038038](https://doi.org/10.5281/zenodo.24038038) | Citable DOI, paper archive | βœ… Published |
581
+ | **OSF** | [10.17605/OSF.IO/9PE5V](https://doi.org/10.17605/OSF.IO/9PE5V) | Registration | βœ… Published |
582
+ | **Website** | [aethermesh-web.netlify.app](https://aethermesh-web.netlify.app) | Live documentation | βœ… Active |
583
+ | **ORCID** | [0009-0003-8903-0029](https://orcid.org/0009-0003-8903-0029) | Author identity | βœ… Active |
584
+
585
+ > [!NOTE]
586
+ > **PyPI:** the package `aethermesh` v2.0.0 is the reference implementation. It is **not a production system**. The v1.0.0 paper remains the authoritative architectural record.
587
+
588
+ ---
589
+
590
+ ## πŸ—‚οΈ Project Structure
591
+
592
+ <details>
593
+ <summary><b>Click to expand the repository tree</b></summary>
594
+
595
+ ```text
596
+ AetherMesh/
597
+ β”œβ”€β”€ src/
598
+ β”‚ └── aethermesh/ # Reference implementation (v2.0.0)
599
+ β”‚ β”œβ”€β”€ __init__.py
600
+ β”‚ β”œβ”€β”€ __version__.py
601
+ β”‚ β”œβ”€β”€ models.py # Delta, Replica, Signature, Verdict, DeltaKind
602
+ β”‚ β”œβ”€β”€ cli.py
603
+ β”‚ β”œβ”€β”€ py.typed
604
+ β”‚ β”œβ”€β”€ crdt/
605
+ β”‚ β”‚ β”œβ”€β”€ semilattice.py
606
+ β”‚ β”‚ └── delta_state.py
607
+ β”‚ β”œβ”€β”€ gossip/
608
+ β”‚ β”‚ β”œβ”€β”€ protocol.py
609
+ β”‚ β”‚ └── peer_sampling.py
610
+ β”‚ β”œβ”€β”€ bft/
611
+ β”‚ β”‚ β”œβ”€β”€ provenance.py
612
+ β”‚ β”‚ β”œβ”€β”€ invariants.py
613
+ β”‚ β”‚ └── semantic_matrix.py
614
+ β”‚ β”œβ”€β”€ admission/
615
+ β”‚ β”‚ └── pipeline.py
616
+ β”‚ └── simulation/
617
+ β”‚ β”œβ”€β”€ network.py
618
+ β”‚ β”œβ”€β”€ node.py
619
+ β”‚ └── testbed.py
620
+ β”œβ”€β”€ tests/ # 107 tests, 79% coverage
621
+ β”‚ β”œβ”€β”€ test_models.py
622
+ β”‚ β”œβ”€β”€ test_crdt.py
623
+ β”‚ β”œβ”€β”€ test_gossip.py
624
+ β”‚ β”œβ”€β”€ test_bft.py
625
+ β”‚ β”œβ”€β”€ test_admission.py
626
+ β”‚ └── test_simulation.py
627
+ β”œβ”€β”€ experiments/ # 3 experiments
628
+ β”‚ β”œβ”€β”€ convergence_latency/
629
+ β”‚ β”œβ”€β”€ conflict_resolution/
630
+ β”‚ └── fault_resilience/
631
+ β”œβ”€β”€ docs/
632
+ β”‚ β”œβ”€β”€ figures/
633
+ β”‚ β”‚ β”œβ”€β”€ Fig1_Tripartite_Architecture.png
634
+ β”‚ β”‚ β”œβ”€β”€ Fig2_CRDT_Join_Semilattice.png
635
+ β”‚ β”‚ β”œβ”€β”€ Fig3_Gossip_Propagation.png
636
+ β”‚ β”‚ β”œβ”€β”€ Fig4_BFT_Validation.png
637
+ β”‚ β”‚ β”œβ”€β”€ Fig5_Aether_Family.png
638
+ β”‚ β”‚ β”œβ”€β”€ Fig6_Scaling_Analysis.png
639
+ β”‚ β”‚ β”œβ”€β”€ Fig7_Gossip_Exchange.png
640
+ β”‚ β”‚ β”œβ”€β”€ Fig8_Node_Anatomy.png
641
+ β”‚ β”‚ └── Fig9_Partition_Healing.png
642
+ β”‚ └── v1.0.0/ # 8 markdown files from the paper
643
+ β”œβ”€β”€ PUBLICATION/
644
+ β”‚ └── AetherMesh_Research_Paper.pdf
645
+ β”œβ”€β”€ REPORTS/
646
+ β”‚ └── v2.0.0/
647
+ β”‚ └── report.md
648
+ β”œβ”€β”€ DATA/
649
+ β”œβ”€β”€ ANALYSIS/
650
+ β”œβ”€β”€ EXTERNAL_REVIEW/
651
+ β”œβ”€β”€ VALIDATION/
652
+ β”œβ”€β”€ AUTHORS.md
653
+ β”œβ”€β”€ CHANGELOG.md
654
+ β”œβ”€β”€ CITATION.cff
655
+ β”œβ”€β”€ CONTRIBUTING.md
656
+ β”œβ”€β”€ INVENTORY.md
657
+ β”œβ”€β”€ LICENSE
658
+ β”œβ”€β”€ PROJECT_SUMMARY.txt
659
+ β”œβ”€β”€ README.md
660
+ β”œβ”€β”€ VERSION
661
+ β”œβ”€β”€ manifest.json
662
+ β”œβ”€β”€ netlify.toml
663
+ β”œβ”€β”€ pyproject.toml
664
+ β”œβ”€β”€ requirements.txt
665
+ β”œβ”€β”€ scientific_state.json
666
+ └── upload_aethermesh.py
667
+ ```
668
+
669
+ </details>
670
+
671
+ ---
672
+
673
+ ## πŸ•“ Version History
674
+
675
+ | Version | Release | Focus | Status |
676
+ |---|---|---|:-:|
677
+ | **v2.0.0** | 2026-11-08 ([release](https://github.com/gitdeeper15/aethermesh/releases/tag/v2.0.0)) | Reference implementation: 15 modules, 107 tests (79%), 3 experiments, PyPI `2.0.0` | βœ… Released |
678
+ | **v1.0.0** | 2026-11 ([release](https://github.com/gitdeeper15/aethermesh/releases/tag/v1.0.0)) | Formalization: 4 definitions, 3 theorems, 6 assumptions, 3 pillars, 9 figures | βœ… Released |
679
+ | *(planned)* | 2027+ | Real-world evaluation, mechanized proofs, extended Byzantine models | ⏳ Not executed |
680
+
681
+ > **v2.0.0:** reference implementation of the v1.0.0 architecture. 15 modules, 107 tests, 79% coverage, 3 reproducible experiments. No real-world deployment evaluated.
682
+
683
+ ---
684
+
685
+ ## πŸ“– Citation
686
+
687
+ ### Primary Manuscript β€” AetherMesh v1.0.0
688
+
689
+ ```bibtex
690
+ @techreport{baladi2026aethermesh,
691
+ author = {Baladi, Samir},
692
+ title = {AetherMesh: Decentralized Peer-to-Peer Agent Synchronization and State CRDTs for Autonomous Multi-Agent Systems},
693
+ institution = {Ronin Institute / Rite of Renaissance},
694
+ type = {Research Paper},
695
+ year = {2026},
696
+ month = {November},
697
+ version = {1.0.0},
698
+ doi = {10.5281/zenodo.24038038},
699
+ url = {https://doi.org/10.5281/zenodo.24038038},
700
+ note = {Formal Architecture Proposal with Simulated Evaluation --- No Real-World Deployment Benchmarked.}
701
+ }
702
+ ```
703
+
704
+ ### Software β€” AetherMesh v2.0.0
705
+
706
+ ```bibtex
707
+ @software{baladi2026aethermesh_v2,
708
+ author = {Baladi, Samir},
709
+ title = {{AetherMesh} v2.0.0: Reference Implementation of Decentralized Peer-to-Peer Agent Synchronization and State CRDTs},
710
+ year = {2026},
711
+ month = {November},
712
+ publisher = {PyPI},
713
+ version = {2.0.0},
714
+ doi = {10.5281/zenodo.24038038},
715
+ url = {https://pypi.org/project/aethermesh/},
716
+ note = {Reference implementation. Available via pip install aethermesh==2.0.0.}
717
+ }
718
+ ```
719
+
720
+ <details>
721
+ <summary><b>Related work β€” AetherGit (Storage Layer)</b></summary>
722
+
723
+ ```bibtex
724
+ @software{baladi2026aethergit,
725
+ author = {Baladi, Samir},
726
+ title = {{AetherGit}: Scalable Source Control for Autonomous AI Agents},
727
+ year = {2026},
728
+ month = {November},
729
+ version = {1.0.0},
730
+ doi = {10.5281/zenodo.23966896},
731
+ url = {https://doi.org/10.5281/zenodo.23966896}
732
+ }
733
+ ```
734
+
735
+ </details>
736
+
737
+ <details>
738
+ <summary><b>Related work β€” AetherFlow (Integration Layer)</b></summary>
739
+
740
+ ```bibtex
741
+ @techreport{baladi2026aetherflow,
742
+ author = {Baladi, Samir},
743
+ title = {AetherFlow: Automated Post-Merge Verification and Dynamic Conflict Resolution in Multi-Agent Programming Environments},
744
+ institution = {Ronin Institute / Rite of Renaissance},
745
+ type = {Research Paper},
746
+ year = {2026},
747
+ month = {November},
748
+ version = {1.0.0},
749
+ doi = {10.5281/zenodo.23979129},
750
+ url = {https://doi.org/10.5281/zenodo.23979129}
751
+ }
752
+ ```
753
+
754
+ </details>
755
+
756
+ <details>
757
+ <summary><b>Related work β€” AetherProof (Verification Layer)</b></summary>
758
+
759
+ ```bibtex
760
+ @techreport{baladi2026aetherproof,
761
+ author = {Baladi, Samir},
762
+ title = {AetherProof: Autonomous Formal Verification and Invariant Synthesis for Multi-Agent Software Ecosystems},
763
+ institution = {Ronin Institute / Rite of Renaissance},
764
+ type = {Research Paper},
765
+ year = {2026},
766
+ month = {November},
767
+ version = {1.0.0},
768
+ doi = {10.5281/zenodo.24013124},
769
+ url = {https://doi.org/10.5281/zenodo.24013124}
770
+ }
771
+ ```
772
+
773
+ </details>
774
+
775
+ ---
776
+
777
+ ## πŸ‘€ Author
778
+
779
+ **Samir Baladi**
780
+ *Interdisciplinary AI Researcher β€” Ronin Institute / Rite of Renaissance*
781
+
782
+ | | |
783
+ |---|---|
784
+ | **Research Area** | Distributed Systems / Software Engineering / Formal Methods |
785
+ | **Research Domain** | CRDTs, Epidemic Gossip, Byzantine Fault Tolerance, Decentralized Synchronization, Eventual Consistency, Agentic Software Engineering |
786
+ | **Research Type** | Formal Architecture Proposal + Reference Implementation |
787
+ | πŸ“§ **Email** | [gitdeeper@gmail.com](mailto:gitdeeper@gmail.com) |
788
+ | πŸ”— **ORCID** | [0009-0003-8903-0029](https://orcid.org/0009-0003-8903-0029) |
789
+ | πŸ™ **GitHub** | [gitdeeper15/aethermesh](https://github.com/gitdeeper15/aethermesh) |
790
+ | 🦊 **GitLab** | [gitlab.com/gitdeeper15/aethermesh](https://gitlab.com/gitdeeper15/aethermesh) |
791
+ | 🟦 **Codeberg** | [codeberg.org/gitdeeper15/aethermesh](https://codeberg.org/gitdeeper15/aethermesh) |
792
+ | πŸͺ£ **Bitbucket** | [bitbucket.org/gitdeeper15/aethermesh](https://bitbucket.org/gitdeeper15/aethermesh) |
793
+ | 🐝 **PyPI** | [pypi.org/project/aethermesh](https://pypi.org/project/aethermesh/) |
794
+ | 🌐 **Official Site** | [aethermesh-web.netlify.app](https://aethermesh-web.netlify.app) |
795
+
796
+ ---
797
+
798
+ ## βš–οΈ License
799
+
800
+ | Scope | License |
801
+ |---|---|
802
+ | **Code** | [MIT License](LICENSE) β€” Copyright Β© 2026 Samir Baladi |
803
+ | **Documentation, manuscript, and figures** | [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode) |
804
+
805
+ <details>
806
+ <summary><b>MIT License β€” full text</b></summary>
807
+
808
+ ```text
809
+ MIT License
810
+
811
+ Copyright (c) 2026 Samir Baladi
812
+
813
+ Permission is hereby granted, free of charge, to any person obtaining a copy
814
+ of this software and associated documentation files (the "Software"), to deal
815
+ in the Software without restriction, including without limitation the rights
816
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
817
+ copies of the Software, and to permit persons to whom the Software is
818
+ furnished to do so, subject to the following conditions:
819
+
820
+ The above copyright notice and this permission notice shall be included in all
821
+ copies or substantial portions of the Software.
822
+ ```
823
+
824
+ </details>
825
+
826
+ ---
827
+
828
+ <div align="center">
829
+
830
+ **AetherMesh β€” Program Manuscript v2.0.0 (Reference Implementation)**
831
+
832
+ Β© 2026 Samir Baladi β€” Ronin Institute / Rite of Renaissance β€” MIT (code) + CC-BY-4.0 (docs)
833
+
834
+ [Zenodo](https://doi.org/10.5281/zenodo.24038038) Β·
835
+ [Website](https://aethermesh-web.netlify.app) Β·
836
+ [PyPI](https://pypi.org/project/aethermesh/) *(publishing)* Β·
837
+ OSF: [10.17605/OSF.IO/9PE5V](https://doi.org/10.17605/OSF.IO/9PE5V)
838
+
839
+ </div>