From 3e3b201ac3a6410abfa1bb69b4c126bb1229dd40 Mon Sep 17 00:00:00 2001
From: dfeen87 <158860247+dfeen87@users.noreply.github.com>
Date: Sat, 25 Apr 2026 10:34:42 +0000
Subject: [PATCH] docs(readme): add BioMesh domain section and update
 repository tree

This commit updates the README.md to include documentation for the
BioMesh domain. It adds a "Domain Focus: BioMesh" section outlining
the core components like SkeletalNode, VascularEdge, OsteoMeshNetwork,
and MetaboJointMatrix. It also updates the Repository Structure tree
to accurately reflect the actual folders in `domains/`, adding
`BioMesh/` and `satellite/` which were missing from the structure tree.

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
---
 README.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/README.md b/README.md
index d881991..0eb6982 100644
--- a/README.md
+++ b/README.md
@@ -78,6 +78,28 @@ Related domain documentation is included in:
 - `domains/medicine/PAPER.md` (wave-native pharmacokinetics concept paper)
 - `domains/medicine/NOTE.md` (technical note on skeletal topological resilience)
 
+## Domain Focus: BioMesh
+
+FEEN includes a biological network domain at `domains/BioMesh/` that models cybernetic hematopoiesis and skeletal-system modeling using a graph-theoretic formalization of biological networks.
+
+### BioMesh Domain Components (`domains/BioMesh/`)
+
+- **`SkeletalNode`**
+  Represents a biological node tracking local metrics such as pH and protease concentration.
+- **`VascularEdge`**
+  Represents vascular connectivity between skeletal nodes, tracking baseline and degraded flow capacity.
+- **`OsteoMeshNetwork`**
+  Topological graph connecting skeletal nodes via vascular edges. Computes structural integrity via the Graph Laplacian's Fiedler value (`L = D - A`).
+- **`MetaboJointMatrix`**
+  A biological "AND" gate utilizing a bistable Duffing oscillator. Payload is eluted only when both conditions are met spatially and temporally (e.g., low pH attenuating the central energy barrier and high protease concentration triggering an enzymatic impulse).
+
+Implementation files:
+- `domains/BioMesh/OsteoMesh.hpp`
+- `domains/BioMesh/OsteoMesh.cpp`
+
+Related domain documentation is included in:
+- `domains/BioMesh/CYBERNETIC_HEMATOPOIESIS.md` (Technical Note: Cybernetic Hematopoiesis and the Wave-Native Eradication of Sickle Cell Disease)
+
 ## Domain Focus: Energy
 
 FEEN includes an energy-systems domain at `domains/energy/` that maps resonator-network physics to grid-like distributed energy resource (DER) coordination.
@@ -651,11 +673,18 @@ feen/
 │   └── SPIRAL_TIME.md                     # Spiral-Time observer specification
 │
 ├── 📁 domains/                            # Domain-specific overlays
+│   ├── 📁 BioMesh/                        # Biological networks and cybernetic hematopoiesis
+│   │   ├── BioMesh_Tests.cpp              # Unit tests for BioMesh mechanics
+│   │   ├── CYBERNETIC_HEMATOPOIESIS.md    # Theoretical framework on wave-native eradication of SCD
+│   │   ├── OsteoMesh.cpp                  # BioMesh domain implementation
+│   │   └── OsteoMesh.hpp                  # BioMesh domain interfaces
 │   ├── 📁 medicine/                       # Pharmacology and skeletal topology models
 │   │   ├── pharma.hpp                     # Medicine domain interfaces
 │   │   ├── pharma.cpp                     # Medicine domain implementation
 │   │   ├── NOTE.md                        # Skeletal topological resilience note
 │   │   └── PAPER.md                       # Wave-native pharmacokinetics concept paper
+│   ├── 📁 satellite/                      # Fractionated spacecraft swarm models
+│   │   └── SatelliteSwarm.hpp             # Satellite swarm domain core types and logic
 │   └── 📁 energy/                         # Grid/DER energy mesh domain
 │       └── EnergyMesh.hpp                 # Energy domain core types and logic
 │