npm - yakmesh - Versions diffs - 2.8.2 → 3.0.0 - Mend

yakmesh 2.8.2 → 3.0.0

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.

Files changed (232) hide show

package/CHANGELOG.md +637 -0
package/CONTRIBUTING.md +42 -0
package/Caddyfile +77 -0
package/README.md +119 -29
package/adapters/adapter-mlv-bible/README.md +124 -0
package/adapters/adapter-mlv-bible/index.js +400 -0
package/adapters/chat-mod-adapter.js +532 -0
package/adapters/content-adapter.js +273 -0
package/content/api.js +50 -41
package/content/index.js +2 -2
package/content/store.js +355 -173
package/dashboard/index.html +19 -3
package/database/replication.js +117 -37
package/docs/CRYPTO-AGILITY.md +204 -0
package/docs/MTLS-RESEARCH.md +367 -0
package/docs/NAMCHE-SPEC.md +681 -0
package/docs/PEERQUANTA-YAKMESH-INTEGRATION.md +407 -0
package/docs/PRECISION-DISCLOSURE.md +96 -0
package/docs/README.md +76 -0
package/docs/ROADMAP-2.4.0.md +447 -0
package/docs/ROADMAP-2.5.0.md +244 -0
package/docs/SECURITY-AUDIT-REPORT.md +306 -0
package/docs/SST-INTEGRATION.md +712 -0
package/docs/STEADYWATCH-IMPLEMENTATION.md +303 -0
package/docs/TERNARY-AUDIT-REPORT.md +247 -0
package/docs/TME-FAQ.md +221 -0
package/docs/WHITEPAPER.md +623 -0
package/docs/adapters.html +1001 -0
package/docs/advanced-systems.html +1045 -0
package/docs/annex.html +1046 -0
package/docs/api.html +970 -0
package/docs/business/response-templates.md +160 -0
package/docs/c2c.html +1225 -0
package/docs/cli.html +1332 -0
package/docs/configuration.html +1248 -0
package/docs/darshan.html +1085 -0
package/docs/dharma.html +966 -0
package/docs/docs-bundle.html +1075 -0
package/docs/docs.css +3120 -0
package/docs/docs.js +556 -0
package/docs/doko.html +969 -0
package/docs/geo-proof.html +858 -0
package/docs/getting-started.html +840 -0
package/docs/gumba-tutorial.html +1144 -0
package/docs/gumba.html +1098 -0
package/docs/index.html +914 -0
package/docs/jhilke.html +1312 -0
package/docs/karma.html +1100 -0
package/docs/katha.html +1037 -0
package/docs/lama.html +978 -0
package/docs/mandala.html +1067 -0
package/docs/mani.html +964 -0
package/docs/mantra.html +967 -0
package/docs/mesh.html +1409 -0
package/docs/nakpak.html +869 -0
package/docs/namche.html +928 -0
package/docs/nav-order.json +53 -0
package/docs/prahari.html +1043 -0
package/docs/prism-bash.min.js +1 -0
package/docs/prism-javascript.min.js +1 -0
package/docs/prism-json.min.js +1 -0
package/docs/prism-tomorrow.min.css +1 -0
package/docs/prism.min.js +1 -0
package/docs/privacy.html +699 -0
package/docs/quick-reference.html +1181 -0
package/docs/sakshi.html +1402 -0
package/docs/sandboxing.md +386 -0
package/docs/seva.html +911 -0
package/docs/sherpa.html +871 -0
package/docs/studio.html +860 -0
package/docs/stupa.html +995 -0
package/docs/tailwind.min.css +2 -0
package/docs/tattva.html +1332 -0
package/docs/terms.html +686 -0
package/docs/time-server-deployment.md +166 -0
package/docs/time-sources.html +1392 -0
package/docs/tivra.html +1127 -0
package/docs/trademark-policy.html +686 -0
package/docs/tribhuj.html +1183 -0
package/docs/trust-security.html +1029 -0
package/docs/tutorials/backup-recovery.html +654 -0
package/docs/tutorials/dashboard.html +604 -0
package/docs/tutorials/domain-setup.html +605 -0
package/docs/tutorials/host-website.html +456 -0
package/docs/tutorials/mesh-network.html +505 -0
package/docs/tutorials/mobile-access.html +445 -0
package/docs/tutorials/privacy.html +467 -0
package/docs/tutorials/raspberry-pi.html +600 -0
package/docs/tutorials/security-basics.html +539 -0
package/docs/tutorials/share-files.html +431 -0
package/docs/tutorials/troubleshooting.html +637 -0
package/docs/tutorials/trust-karma.html +419 -0
package/docs/tutorials/yak-protocol.html +456 -0
package/docs/tutorials.html +1034 -0
package/docs/vani.html +1270 -0
package/docs/webserver.html +809 -0
package/docs/yak-protocol.html +940 -0
package/docs/yak-timeserver-design.md +475 -0
package/docs/yakapp.html +1015 -0
package/docs/ypc27.html +1069 -0
package/docs/yurt.html +1344 -0
package/embedded-docs/bundle.js +334 -74
package/gossip/protocol.js +247 -27
package/identity/key-resolver.js +262 -0
package/identity/machine-seed.js +632 -0
package/identity/node-key.js +669 -368
package/identity/tribhuj-ratchet.js +506 -0
package/knowledge-base.js +37 -8
package/launcher/yakmesh.bat +62 -0
package/launcher/yakmesh.sh +70 -0
package/mesh/annex.js +462 -108
package/mesh/beacon-broadcast.js +113 -1
package/mesh/darshan.js +1718 -0
package/mesh/gumba.js +1567 -0
package/mesh/jhilke.js +651 -0
package/mesh/katha.js +1012 -0
package/mesh/nakpak-routing.js +8 -5
package/mesh/network.js +724 -34
package/mesh/pulse-sync.js +4 -1
package/mesh/rate-limiter.js +127 -15
package/mesh/seva.js +526 -0
package/mesh/sherpa-discovery.js +89 -8
package/mesh/sybil-defense.js +19 -5
package/mesh/temporal-encoder.js +4 -3
package/mesh/vani.js +1364 -0
package/mesh/yurt.js +1340 -0
package/models/entropy-sentinel.onnx +0 -0
package/models/karma-trust.onnx +0 -0
package/models/manifest.json +43 -0
package/models/sakshi-anomaly.onnx +0 -0
package/oracle/code-proof-protocol.js +7 -6
package/oracle/codebase-lock.js +257 -28
package/oracle/index.js +74 -15
package/oracle/ma902-snmp.js +678 -0
package/oracle/module-sealer.js +5 -3
package/oracle/network-identity.js +16 -0
package/oracle/packet-checksum.js +201 -0
package/oracle/sst.js +579 -0
package/oracle/ternary-144t.js +714 -0
package/oracle/ternary-ml.js +481 -0
package/oracle/time-api.js +239 -0
package/oracle/time-source.js +137 -47
package/oracle/validation-oracle-hardened.js +1111 -1071
package/oracle/validation-oracle.js +4 -2
package/oracle/ypc27.js +211 -0
package/package.json +20 -3
package/protocol/yak-handler.js +35 -9
package/protocol/yak-protocol.js +28 -13
package/reference/cpp/yakmesh_mceliece_shard.cpp +168 -0
package/reference/cpp/yakmesh_ypc27.cpp +179 -0
package/sbom.json +87 -0
package/scripts/security-audit.mjs +264 -0
package/scripts/update-docs-nav.js +194 -0
package/scripts/update-docs-sidebar.cjs +164 -0
package/security/crypto-config.js +4 -3
package/security/dharma-moderation.js +517 -0
package/security/doko-identity.js +193 -143
package/security/domain-consensus.js +86 -85
package/security/fs-hardening.js +620 -0
package/security/hardware-attestation.js +5 -3
package/security/hybrid-trust.js +227 -87
package/security/karma-rate-limiter.js +692 -0
package/security/khata-protocol.js +22 -21
package/security/khata-trust-integration.js +277 -150
package/security/memory-safety.js +635 -0
package/security/mesh-auth.js +11 -10
package/security/mesh-revocation.js +373 -5
package/security/namche-gateway.js +298 -69
package/security/sakshi.js +460 -3
package/security/sangha.js +770 -0
package/security/secure-config.js +473 -0
package/security/silicon-parity.js +13 -10
package/security/steadywatch.js +1142 -0
package/security/strike-system.js +32 -3
package/security/temporal-signing.js +488 -0
package/security/trit-commitment.js +464 -0
package/server/crypto/annex.js +247 -0
package/server/darshan-api.js +343 -0
package/server/index.js +3259 -362
package/server/komm-api.js +668 -0
package/utils/accel.js +2273 -0
package/utils/ternary-id.js +79 -0
package/utils/verify-worker.js +57 -0
package/webserver/index.js +95 -5
package/assets/yakmesh-logo.png +0 -0
package/assets/yakmesh-logo.svg +0 -80
package/assets/yakmesh-logo2.png +0 -0
package/assets/yakmesh-logo2sm.png +0 -0
package/assets/ymsm.png +0 -0
package/website/assets/silhouettes/adapters.svg +0 -107
package/website/assets/silhouettes/api-endpoints.svg +0 -115
package/website/assets/silhouettes/atomic-clock.svg +0 -83
package/website/assets/silhouettes/base-camp.svg +0 -81
package/website/assets/silhouettes/bridge.svg +0 -69
package/website/assets/silhouettes/docs-bundle.svg +0 -113
package/website/assets/silhouettes/doko-basket.svg +0 -70
package/website/assets/silhouettes/fortress.svg +0 -93
package/website/assets/silhouettes/gateway.svg +0 -54
package/website/assets/silhouettes/gears.svg +0 -93
package/website/assets/silhouettes/globe-satellite.svg +0 -67
package/website/assets/silhouettes/karma-wheel.svg +0 -137
package/website/assets/silhouettes/lama-council.svg +0 -141
package/website/assets/silhouettes/mandala-network.svg +0 -169
package/website/assets/silhouettes/mani-stones.svg +0 -149
package/website/assets/silhouettes/mantra-wheel.svg +0 -116
package/website/assets/silhouettes/mesh-nodes.svg +0 -113
package/website/assets/silhouettes/nakpak.svg +0 -56
package/website/assets/silhouettes/peak-lightning.svg +0 -73
package/website/assets/silhouettes/sherpa.svg +0 -69
package/website/assets/silhouettes/stupa-tower.svg +0 -119
package/website/assets/silhouettes/tattva-eye.svg +0 -78
package/website/assets/silhouettes/terminal.svg +0 -74
package/website/assets/silhouettes/webserver.svg +0 -145
package/website/assets/silhouettes/yak.svg +0 -78
package/website/assets/yakmesh-logo.png +0 -0
package/website/assets/yakmesh-logo.webp +0 -0
package/website/assets/yakmesh-logo128x140.webp +0 -0
package/website/assets/yakmesh-logo2.png +0 -0
package/website/assets/yakmesh-logo2.svg +0 -51
package/website/assets/yakmesh-logo40x44.webp +0 -0
package/website/assets/yakmesh.gif +0 -0
package/website/assets/yakmesh.ico +0 -0
package/website/assets/yakmesh.jpg +0 -0
package/website/assets/yakmesh.pdf +0 -0
package/website/assets/yakmesh.png +0 -0
package/website/assets/yakmesh.svg +0 -70
package/website/assets/yakmesh128.webp +0 -0
package/website/assets/yakmesh32.png +0 -0
package/website/assets/yakmesh32.svg +0 -65
package/website/assets/yakmesh32o.ico +0 -2
package/website/assets/yakmesh32o.svg +0 -65
package/website/assets/yakmesh32o.svgz +0 -0

package/docs/mesh.html ADDED Viewed

@@ -0,0 +1,1409 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="mesh">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <link rel="icon" href="favicon.ico" sizes="32x32">
+    <link rel="icon" href="icon.svg" type="image/svg+xml">
+    <link rel="apple-touch-icon" href="apple-touch-icon.png">
+    <title>Mesh Network | YAKMESH Documentation</title>
+    <meta name="description" content="YAKMESH mesh networking infrastructure. WebSocket-based P2P communication, gossip protocol, onion routing, and distributed peer coordination.">
+    <link rel="stylesheet" href="tailwind.min.css">
+    <link rel="stylesheet" href="prism-tomorrow.min.css" media="print" onload="this.media='all'">
+    <noscript><link rel="stylesheet" href="prism-tomorrow.min.css"></noscript>
+    <link rel="stylesheet" href="docs.css">
+    <style>
+        .theme-accent { color: #14b8a6; }
+        .theme-accent-hover:hover { color: #2dd4bf; }
+        .theme-badge { background: rgba(20, 184, 166, 0.2); color: #2dd4bf; }
+        .theme-border { border-color: #14b8a6; }
+        .theme-callout { background: rgba(20, 184, 166, 0.1); border-color: #0d9488; }
+        .active-link { background: rgba(20, 184, 166, 0.2) !important; color: #2dd4bf !important; }
+        .mesh-table { width: 100%; border-collapse: collapse; }
+        .mesh-table th, .mesh-table td { padding: 0.75rem; text-align: left; border-bottom: 1px solid #2e4c43; }
+        .mesh-table th { color: #14b8a6; font-weight: 600; background: rgba(20, 184, 166, 0.1); }
+        .mesh-table code { background: #1f332d; padding: 0.25rem 0.5rem; border-radius: 4px; color: #2dd4bf; }
+        .module-card { background: linear-gradient(135deg, rgba(20, 184, 166, 0.15), rgba(13, 148, 136, 0.1)); border-left: 4px solid #14b8a6; }
+        .module-card-network { background: linear-gradient(135deg, rgba(20, 184, 166, 0.2), rgba(13, 148, 136, 0.1)); border-left: 4px solid #14b8a6; }
+        .module-card-annex { background: linear-gradient(135deg, rgba(168, 85, 247, 0.2), rgba(139, 92, 246, 0.1)); border-left: 4px solid #a855f7; }
+        .module-card-beacon { background: linear-gradient(135deg, rgba(251, 191, 36, 0.2), rgba(245, 158, 11, 0.1)); border-left: 4px solid #fbbf24; }
+        .module-card-sherpa { background: linear-gradient(135deg, rgba(34, 197, 94, 0.2), rgba(22, 163, 74, 0.1)); border-left: 4px solid #22c55e; }
+        .module-card-nakpak { background: linear-gradient(135deg, rgba(59, 130, 246, 0.2), rgba(37, 99, 235, 0.1)); border-left: 4px solid #3b82f6; }
+        .module-card-pulse { background: linear-gradient(135deg, rgba(236, 72, 153, 0.2), rgba(219, 39, 119, 0.1)); border-left: 4px solid #ec4899; }
+        .module-card-security { background: linear-gradient(135deg, rgba(239, 68, 68, 0.2), rgba(220, 38, 38, 0.1)); border-left: 4px solid #ef4444; }
+        .module-card-echo { background: linear-gradient(135deg, rgba(99, 102, 241, 0.2), rgba(79, 70, 229, 0.1)); border-left: 4px solid #6366f1; }
+        .module-card-temporal { background: linear-gradient(135deg, rgba(245, 158, 11, 0.2), rgba(217, 119, 6, 0.1)); border-left: 4px solid #f59e0b; }
+        .mesh-philosophy { font-style: italic; background: linear-gradient(135deg, rgba(20, 184, 166, 0.2), rgba(99, 102, 241, 0.1)); border-left: 4px solid #14b8a6; }
+    </style>
+    <!-- Open Graph -->
+    <meta property="og:type" content="article">
+    <meta property="og:site_name" content="Yakmesh Documentation">
+    <meta property="og:title" content="Mesh Network — Yakmesh">
+    <meta property="og:description" content="P2P mesh infrastructure — deep dive into mesh networking and node interconnection.">
+</head>
+<body class="bg-mountain-900 text-white min-h-screen">
+<!-- YAKMESH-ICON-SPRITE-START -->
+<svg xmlns="http://www.w3.org/2000/svg" style="display:none">
+<!--
+  Yakmesh Docs Icon Sprite Sheet
+  24×24 viewBox — stroke/fill set via .doc-icon CSS
+  Usage: <svg class="doc-icon"><use href="#icon-name"/></svg>
+-->
+<!-- ═══ GUIDES ═══ -->
+<symbol id="icon-home" viewBox="0 0 24 24">
+  <path d="M3 9.5L12 3l9 6.5V20a1 1 0 01-1 1H4a1 1 0 01-1-1V9.5z"/>
+  <polyline points="9 22 9 12 15 12 15 22"/>
+</symbol>
+<symbol id="icon-rocket" viewBox="0 0 24 24">
+  <path d="M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 00-2.91-.09z"/>
+  <path d="M12 15l-3-3a22 22 0 012-3.95A12.88 12.88 0 0122 2c0 2.72-.78 7.5-6 11a22.35 22.35 0 01-4 2z"/>
+  <path d="M9 12H4s.55-3.03 2-4c1.62-1.08 5 0 5 0"/>
+  <path d="M12 15v5s3.03-.55 4-2c1.08-1.62 0-5 0-5"/>
+</symbol>
+<symbol id="icon-book" viewBox="0 0 24 24">
+  <path d="M4 19.5A2.5 2.5 0 016.5 17H20"/>
+  <path d="M6.5 2H20v20H6.5A2.5 2.5 0 014 19.5v-15A2.5 2.5 0 016.5 2z"/>
+  <line x1="8" y1="7" x2="16" y2="7"/>
+  <line x1="8" y1="11" x2="13" y2="11"/>
+</symbol>
+<!-- ═══ PROTOCOL STACK ═══ -->
+<!-- YAK:// — Content addressing (yak horns) -->
+<symbol id="icon-yak" viewBox="0 0 24 24">
+  <path d="M4 4c1 3 3 5 5 6"/>
+  <path d="M20 4c-1 3-3 5-5 6"/>
+  <circle cx="12" cy="14" r="5"/>
+  <circle cx="10" cy="13" r="0.5" fill="currentColor"/>
+  <circle cx="14" cy="13" r="0.5" fill="currentColor"/>
+  <path d="M10 16c1 1 3 1 4 0"/>
+</symbol>
+<!-- ANNEX — Encrypted bridge -->
+<symbol id="icon-annex" viewBox="0 0 24 24">
+  <path d="M4 18h3a4 4 0 004-4V8"/>
+  <path d="M20 18h-3a4 4 0 01-4-4V8"/>
+  <circle cx="7" cy="6" r="2"/>
+  <circle cx="17" cy="6" r="2"/>
+  <line x1="7" y1="8" x2="7" y2="18"/>
+  <line x1="17" y1="8" x2="17" y2="18"/>
+</symbol>
+<!-- JHILKE — Cricket / steganographic key lifecycle -->
+<symbol id="icon-jhilke" viewBox="0 0 24 24">
+  <ellipse cx="12" cy="14" rx="4" ry="6"/>
+  <path d="M8 10c-2-3-4-6-3-8"/>
+  <path d="M16 10c2-3 4-6 3-8"/>
+  <line x1="10" y1="20" x2="8" y2="23"/>
+  <line x1="14" y1="20" x2="16" y2="23"/>
+  <path d="M9 12l-4 2"/>
+  <path d="M15 12l4 2"/>
+</symbol>
+<!-- NAKPAK — Onion layers / backpack -->
+<symbol id="icon-nakpak" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="10" opacity="0.3"/>
+  <circle cx="12" cy="12" r="7" opacity="0.5"/>
+  <circle cx="12" cy="12" r="4" opacity="0.8"/>
+  <circle cx="12" cy="12" r="1.5" fill="currentColor"/>
+</symbol>
+<!-- NAMCHE — Gateway door -->
+<symbol id="icon-namche" viewBox="0 0 24 24">
+  <rect x="3" y="3" width="18" height="18" rx="2"/>
+  <path d="M9 3v18"/>
+  <path d="M15 3v18"/>
+  <line x1="3" y1="8" x2="9" y2="8"/>
+  <line x1="15" y1="8" x2="21" y2="8"/>
+  <circle cx="12" cy="14" r="1" fill="currentColor"/>
+</symbol>
+<!-- DOKO — Basket / certificate -->
+<symbol id="icon-doko" viewBox="0 0 24 24">
+  <path d="M6 8l-2 12h16l-2-12"/>
+  <path d="M6 8c0-3 2.7-5 6-5s6 2 6 5"/>
+  <line x1="8" y1="10" x2="10" y2="18"/>
+  <line x1="16" y1="10" x2="14" y2="18"/>
+  <line x1="12" y1="10" x2="12" y2="18"/>
+</symbol>
+<!-- SHERPA — Mountain climber -->
+<symbol id="icon-sherpa" viewBox="0 0 24 24">
+  <path d="M4 20L10 6l3 6 3-4 4 12"/>
+  <line x1="4" y1="20" x2="20" y2="20"/>
+  <circle cx="13" cy="4" r="1.5"/>
+</symbol>
+<!-- MANDALA — Network topology web -->
+<symbol id="icon-mandala" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="9"/>
+  <circle cx="12" cy="12" r="4.5"/>
+  <line x1="12" y1="3" x2="12" y2="21"/>
+  <line x1="3" y1="12" x2="21" y2="12"/>
+  <line x1="5.6" y1="5.6" x2="18.4" y2="18.4"/>
+  <line x1="18.4" y1="5.6" x2="5.6" y2="18.4"/>
+</symbol>
+<!-- MANTRA — Gossip / prayer wheel -->
+<symbol id="icon-mantra" viewBox="0 0 24 24">
+  <circle cx="12" cy="10" r="7"/>
+  <path d="M12 3v14"/>
+  <path d="M8 7c2 1.5 6 1.5 8 0"/>
+  <path d="M8 13c2-1.5 6-1.5 8 0"/>
+  <line x1="12" y1="17" x2="12" y2="22"/>
+  <line x1="9" y1="22" x2="15" y2="22"/>
+</symbol>
+<!-- GUMBA — Temple / access control -->
+<symbol id="icon-gumba" viewBox="0 0 24 24">
+  <path d="M12 2L3 9h18z"/>
+  <line x1="5" y1="9" x2="5" y2="19"/>
+  <line x1="9" y1="9" x2="9" y2="19"/>
+  <line x1="15" y1="9" x2="15" y2="19"/>
+  <line x1="19" y1="9" x2="19" y2="19"/>
+  <line x1="3" y1="19" x2="21" y2="19"/>
+  <line x1="3" y1="21" x2="21" y2="21"/>
+</symbol>
+<!-- YURT — Camp / room -->
+<symbol id="icon-yurt" viewBox="0 0 24 24">
+  <path d="M3 20L12 4l9 16"/>
+  <line x1="3" y1="20" x2="21" y2="20"/>
+  <path d="M10 20v-5a2 2 0 014 0v5"/>
+  <path d="M6 14h12"/>
+</symbol>
+<!-- KATHA — Chat / story scroll -->
+<symbol id="icon-katha" viewBox="0 0 24 24">
+  <path d="M21 15a2 2 0 01-2 2H7l-4 4V5a2 2 0 012-2h14a2 2 0 012 2z"/>
+  <line x1="8" y1="8" x2="16" y2="8"/>
+  <line x1="8" y1="12" x2="13" y2="12"/>
+</symbol>
+<!-- VANI — Voice / microphone -->
+<symbol id="icon-vani" viewBox="0 0 24 24">
+  <rect x="9" y="2" width="6" height="11" rx="3"/>
+  <path d="M5 10a7 7 0 0014 0"/>
+  <line x1="12" y1="17" x2="12" y2="22"/>
+  <line x1="8" y1="22" x2="16" y2="22"/>
+</symbol>
+<!-- DARSHAN — Eye / viewing -->
+<symbol id="icon-darshan" viewBox="0 0 24 24">
+  <path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8S1 12 1 12z"/>
+  <circle cx="12" cy="12" r="3"/>
+</symbol>
+<!-- STUPA — Tower / distributed storage -->
+<symbol id="icon-stupa" viewBox="0 0 24 24">
+  <line x1="12" y1="2" x2="12" y2="5"/>
+  <path d="M10 5h4l1 3H9z"/>
+  <ellipse cx="12" cy="11" rx="5" ry="3"/>
+  <ellipse cx="12" cy="15" rx="6" ry="3"/>
+  <ellipse cx="12" cy="19" rx="7" ry="3"/>
+</symbol>
+<!-- LAMA — Crystal ball / consensus -->
+<symbol id="icon-lama" viewBox="0 0 24 24">
+  <circle cx="12" cy="10" r="7"/>
+  <path d="M12 3c-1.5 2-2 5 0 7s4.5 2 6 0"/>
+  <path d="M7 19h10"/>
+  <path d="M9 22h6"/>
+  <line x1="9" y1="17" x2="9" y2="19"/>
+  <line x1="15" y1="17" x2="15" y2="19"/>
+</symbol>
+<!-- MANI — Prayer stone / time sync -->
+<symbol id="icon-mani" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="9"/>
+  <polyline points="12 6 12 12 16 14"/>
+  <circle cx="12" cy="12" r="1" fill="currentColor"/>
+</symbol>
+<!-- KARMA — Yin-yang / reputation -->
+<symbol id="icon-karma" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="9"/>
+  <path d="M12 3a4.5 4.5 0 010 9 4.5 4.5 0 000 9"/>
+  <circle cx="12" cy="7.5" r="1.5" fill="currentColor"/>
+  <circle cx="12" cy="16.5" r="1.5"/>
+</symbol>
+<!-- TATTVA — Quantum elements / atom -->
+<symbol id="icon-tattva" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="2.5" fill="currentColor" stroke="none"/>
+  <ellipse cx="12" cy="12" rx="10" ry="4"/>
+  <ellipse cx="12" cy="12" rx="10" ry="4" transform="rotate(60 12 12)"/>
+  <ellipse cx="12" cy="12" rx="10" ry="4" transform="rotate(120 12 12)"/>
+</symbol>
+<!-- TRIBHUJ — Triangle / balanced ternary -->
+<symbol id="icon-tribhuj" viewBox="0 0 24 24">
+  <polygon points="12,3 21,20 3,20"/>
+  <line x1="12" y1="3" x2="12" y2="20"/>
+  <line x1="7.5" y1="11.5" x2="16.5" y2="11.5"/>
+  <circle cx="12" cy="14" r="1" fill="currentColor"/>
+</symbol>
+<!-- YPC-27 — Lock / cipher -->
+<symbol id="icon-ypc27" viewBox="0 0 24 24">
+  <rect x="5" y="11" width="14" height="10" rx="2"/>
+  <path d="M8 11V7a4 4 0 118 0v4"/>
+  <circle cx="12" cy="16" r="1" fill="currentColor"/>
+  <line x1="12" y1="17" x2="12" y2="19"/>
+</symbol>
+<!-- SAKSHI — Witness / aperture eye -->
+<symbol id="icon-sakshi" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="9"/>
+  <path d="M12 3l3 9-3 9"/>
+  <path d="M12 3l-3 9 3 9"/>
+  <circle cx="12" cy="12" r="2.5"/>
+  <circle cx="12" cy="12" r="0.8" fill="currentColor"/>
+</symbol>
+<!-- PRAMAAN — Globe / geographic proof -->
+<symbol id="icon-pramaan" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="9"/>
+  <ellipse cx="12" cy="12" rx="4" ry="9"/>
+  <line x1="3" y1="9" x2="21" y2="9"/>
+  <line x1="3" y1="15" x2="21" y2="15"/>
+  <path d="M18 4l-2 2 1 3"/>
+  <path d="M6 18l2-1 3 1"/>
+</symbol>
+<!-- SURAKSHA — Shield / security -->
+<symbol id="icon-suraksha" viewBox="0 0 24 24">
+  <path d="M12 2l8 4v6c0 5.5-3.8 10.7-8 12-4.2-1.3-8-6.5-8-12V6z"/>
+  <polyline points="9 12 11 14 15 10"/>
+</symbol>
+<!-- TIVRA — Lightning bolt / acceleration -->
+<symbol id="icon-tivra" viewBox="0 0 24 24">
+  <polygon points="13,2 3,14 12,14 11,22 21,10 12,10"/>
+</symbol>
+<!-- PRAHARI — Satellite / sentinel -->
+<symbol id="icon-prahari" viewBox="0 0 24 24">
+  <rect x="9" y="9" width="6" height="6" rx="1" transform="rotate(45 12 12)"/>
+  <line x1="12" y1="5" x2="12" y2="2"/>
+  <line x1="19" y1="12" x2="22" y2="12"/>
+  <line x1="12" y1="19" x2="12" y2="22"/>
+  <line x1="5" y1="12" x2="2" y2="12"/>
+  <path d="M7 7L5 5"/>
+  <path d="M17 7l2-2"/>
+</symbol>
+<!-- DHARMA — Balance scale / content moderation -->
+<symbol id="icon-dharma" viewBox="0 0 24 24">
+  <line x1="12" y1="3" x2="12" y2="21"/>
+  <line x1="4" y1="7" x2="20" y2="7"/>
+  <path d="M4 7l2 7h0a3 3 0 006 0h0l2-7"/>
+  <path d="M14 7l2 7h0a3 3 0 006 0h0l2-7"/>
+  <line x1="10" y1="21" x2="14" y2="21"/>
+</symbol>
+<!-- SEVA — Helping hands / NPU sharing -->
+<symbol id="icon-seva" viewBox="0 0 24 24">
+  <path d="M12 22c-4 0-8-2-8-6 0-2 1-3 3-4l5-3 5 3c2 1 3 2 3 4 0 4-4 6-8 6z"/>
+  <path d="M12 11V5"/>
+  <path d="M9 8l3-3 3 3"/>
+  <circle cx="12" cy="16" r="2"/>
+</symbol>
+<!-- ═══ APPLICATIONS ═══ -->
+<!-- YakApp — Messenger -->
+<symbol id="icon-yakapp" viewBox="0 0 24 24">
+  <path d="M21 11.5a8.38 8.38 0 01-.9 3.8 8.5 8.5 0 01-7.6 4.7 8.38 8.38 0 01-3.8-.9L3 21l1.9-5.7a8.38 8.38 0 01-.9-3.8 8.5 8.5 0 014.7-7.6 8.38 8.38 0 013.8-.9h.5a8.48 8.48 0 018 8v.5z"/>
+</symbol>
+<!-- C2C — Core to Cosmos -->
+<symbol id="icon-c2c" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="3"/>
+  <circle cx="12" cy="12" r="9"/>
+  <path d="M12 3v3"/>
+  <path d="M12 18v3"/>
+  <path d="M3 12h3"/>
+  <path d="M18 12h3"/>
+</symbol>
+<!-- Studio — Creative suite -->
+<symbol id="icon-studio" viewBox="0 0 24 24">
+  <circle cx="13.5" cy="6.5" r="2.5"/>
+  <path d="M6 21l4-10 3 5 4-7 4 12"/>
+  <rect x="2" y="2" width="20" height="20" rx="2"/>
+</symbol>
+<!-- ═══ REFERENCE ═══ -->
+<!-- Quick Reference — Clipboard -->
+<symbol id="icon-quickref" viewBox="0 0 24 24">
+  <path d="M16 4h2a2 2 0 012 2v14a2 2 0 01-2 2H6a2 2 0 01-2-2V6a2 2 0 012-2h2"/>
+  <rect x="8" y="2" width="8" height="4" rx="1"/>
+  <line x1="8" y1="10" x2="16" y2="10"/>
+  <line x1="8" y1="14" x2="16" y2="14"/>
+  <line x1="8" y1="18" x2="12" y2="18"/>
+</symbol>
+<!-- GRANTH — Docs bundle -->
+<symbol id="icon-granth" viewBox="0 0 24 24">
+  <path d="M4 19.5A2.5 2.5 0 016.5 17H20"/>
+  <path d="M6.5 2H20v20H6.5A2.5 2.5 0 014 19.5v-15A2.5 2.5 0 016.5 2z"/>
+  <path d="M8 7h8"/>
+  <path d="M8 11h5"/>
+  <path d="M8 15h3"/>
+</symbol>
+<!-- API — Signal tower -->
+<symbol id="icon-api" viewBox="0 0 24 24">
+  <line x1="12" y1="10" x2="12" y2="22"/>
+  <path d="M8 6a6 6 0 018 0"/>
+  <path d="M5 3a10 10 0 0114 0"/>
+  <circle cx="12" cy="10" r="2"/>
+</symbol>
+<!-- Adapters — Plug connector -->
+<symbol id="icon-adapters" viewBox="0 0 24 24">
+  <path d="M6 3v4"/>
+  <path d="M10 3v4"/>
+  <path d="M4 7h8v3a4 4 0 01-8 0V7z"/>
+  <line x1="8" y1="14" x2="8" y2="17"/>
+  <path d="M14 10h4v3a2 2 0 01-4 0v-3z"/>
+  <line x1="16" y1="7" x2="16" y2="10"/>
+  <line x1="16" y1="13" x2="16" y2="17"/>
+  <line x1="8" y1="17" x2="16" y2="17"/>
+  <line x1="12" y1="17" x2="12" y2="21"/>
+</symbol>
+<!-- ═══ EXTRA (pages outside nav-order) ═══ -->
+<!-- Terminal / CLI -->
+<symbol id="icon-terminal" viewBox="0 0 24 24">
+  <rect x="2" y="3" width="20" height="18" rx="2"/>
+  <polyline points="7 9 10 12 7 15"/>
+  <line x1="13" y1="15" x2="17" y2="15"/>
+</symbol>
+<!-- Gear / Configuration -->
+<symbol id="icon-gear" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="3"/>
+  <path d="M19.4 15a1.65 1.65 0 00.33 1.82l.06.06a2 2 0 01-2.83 2.83l-.06-.06a1.65 1.65 0 00-1.82-.33 1.65 1.65 0 00-1 1.51V21a2 2 0 01-4 0v-.09A1.65 1.65 0 009 19.4a1.65 1.65 0 00-1.82.33l-.06.06a2 2 0 01-2.83-2.83l.06-.06A1.65 1.65 0 004.68 15a1.65 1.65 0 00-1.51-1H3a2 2 0 010-4h.09A1.65 1.65 0 004.6 9a1.65 1.65 0 00-.33-1.82l-.06-.06a2 2 0 012.83-2.83l.06.06A1.65 1.65 0 009 4.68a1.65 1.65 0 001-1.51V3a2 2 0 014 0v.09a1.65 1.65 0 001 1.51 1.65 1.65 0 001.82-.33l.06-.06a2 2 0 012.83 2.83l-.06.06A1.65 1.65 0 0019.4 9a1.65 1.65 0 001.51 1H21a2 2 0 010 4h-.09a1.65 1.65 0 00-1.51 1z"/>
+</symbol>
+<!-- Server / Web hosting -->
+<symbol id="icon-server" viewBox="0 0 24 24">
+  <rect x="2" y="2" width="20" height="8" rx="2"/>
+  <rect x="2" y="14" width="20" height="8" rx="2"/>
+  <line x1="6" y1="6" x2="6.01" y2="6"/>
+  <line x1="6" y1="18" x2="6.01" y2="18"/>
+</symbol>
+<!-- ═══ CHROME / UI ═══ -->
+<!-- Mountain peak — logo icon (replaces 🏔️) -->
+<symbol id="icon-mountain" viewBox="0 0 24 24">
+  <path d="M8 21l4.5-9 3 5.5L19 12l3 9H2l6-9z"/>
+  <path d="M12 12l1.5-3L16 14"/>
+</symbol>
+<!-- Dashboard / bar chart (replaces 📊) -->
+<symbol id="icon-dashboard" viewBox="0 0 24 24">
+  <line x1="18" y1="20" x2="18" y2="10"/>
+  <line x1="12" y1="20" x2="12" y2="4"/>
+  <line x1="6" y1="20" x2="6" y2="14"/>
+  <rect x="2" y="2" width="20" height="20" rx="2" stroke-opacity="0.4"/>
+</symbol>
+<!-- ═══ GENERIC / CONTENT ICONS ═══ -->
+<!-- Lock / encrypted (replaces 🔐) -->
+<symbol id="icon-lock" viewBox="0 0 24 24">
+  <rect x="3" y="11" width="18" height="11" rx="2"/>
+  <path d="M7 11V7a5 5 0 0110 0v4"/>
+</symbol>
+<!-- Signal / broadcast (replaces 📡) -->
+<symbol id="icon-signal" viewBox="0 0 24 24">
+  <path d="M2 12a10 10 0 0118 0"/>
+  <path d="M5 12a7 7 0 0112 0"/>
+  <path d="M8 12a4 4 0 016 0"/>
+  <circle cx="11" cy="12" r="1"/>
+</symbol>
+<!-- Link / chain (replaces 🔗) -->
+<symbol id="icon-link" viewBox="0 0 24 24">
+  <path d="M10 13a5 5 0 007.54.54l3-3a5 5 0 00-7.07-7.07l-1.72 1.71"/>
+  <path d="M14 11a5 5 0 00-7.54-.54l-3 3a5 5 0 007.07 7.07l1.71-1.71"/>
+</symbol>
+<!-- Globe / network (replaces 🌐) -->
+<symbol id="icon-globe" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="10"/>
+  <line x1="2" y1="12" x2="22" y2="12"/>
+  <path d="M12 2a15.3 15.3 0 014 10 15.3 15.3 0 01-4 10 15.3 15.3 0 01-4-10 15.3 15.3 0 014-10z"/>
+</symbol>
+<!-- Sync / refresh (replaces 🔄) -->
+<symbol id="icon-sync" viewBox="0 0 24 24">
+  <polyline points="23 4 23 10 17 10"/>
+  <polyline points="1 20 1 14 7 14"/>
+  <path d="M3.51 9a9 9 0 0114.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0020.49 15"/>
+</symbol>
+<!-- Users / group (replaces 👥) -->
+<symbol id="icon-users" viewBox="0 0 24 24">
+  <path d="M17 21v-2a4 4 0 00-4-4H5a4 4 0 00-4 4v2"/>
+  <circle cx="9" cy="7" r="4"/>
+  <path d="M23 21v-2a4 4 0 00-3-3.87"/>
+  <path d="M16 3.13a4 4 0 010 7.75"/>
+</symbol>
+<!-- Shield / protection (replaces 🛡) -->
+<symbol id="icon-shield" viewBox="0 0 24 24">
+  <path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"/>
+</symbol>
+<!-- Heartbeat / pulse (replaces 💓) -->
+<symbol id="icon-heartbeat" viewBox="0 0 24 24">
+  <path d="M3 12h4l3-9 4 18 3-9h4"/>
+</symbol>
+<!-- Map pin / location (replaces 📍) -->
+<symbol id="icon-pin" viewBox="0 0 24 24">
+  <path d="M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0118 0z"/>
+  <circle cx="12" cy="10" r="3"/>
+</symbol>
+<!-- Traffic light / status (replaces 🚦) -->
+<symbol id="icon-traffic" viewBox="0 0 24 24">
+  <rect x="7" y="2" width="10" height="20" rx="3"/>
+  <circle cx="12" cy="7" r="1.5"/>
+  <circle cx="12" cy="12" r="1.5"/>
+  <circle cx="12" cy="17" r="1.5"/>
+</symbol>
+<!-- Check circle (replaces ✅) -->
+<symbol id="icon-check" viewBox="0 0 24 24">
+  <path d="M22 11.08V12a10 10 0 11-5.93-9.14"/>
+  <polyline points="22 4 12 14.01 9 11.01"/>
+</symbol>
+<!-- Megaphone / broadcast (replaces 📢) -->
+<symbol id="icon-megaphone" viewBox="0 0 24 24">
+  <path d="M21 15a2 2 0 01-2 2H7l-4 4V5a2 2 0 012-2h14a2 2 0 012 2z"/>
+</symbol>
+<!-- Pen / signed (replaces ✍) -->
+<symbol id="icon-pen" viewBox="0 0 24 24">
+  <path d="M12 20h9"/>
+  <path d="M16.5 3.5a2.121 2.121 0 013 3L7 19l-4 1 1-4L16.5 3.5z"/>
+</symbol>
+<!-- Warning / alert (replaces ⚠) -->
+<symbol id="icon-warning" viewBox="0 0 24 24">
+  <path d="M10.29 3.86L1.82 18a2 2 0 001.71 3h16.94a2 2 0 001.71-3L13.71 3.86a2 2 0 00-3.42 0z"/>
+  <line x1="12" y1="9" x2="12" y2="13"/>
+  <line x1="12" y1="17" x2="12.01" y2="17"/>
+</symbol>
+<!-- Hourglass / timer (replaces ⏳) -->
+<symbol id="icon-hourglass" viewBox="0 0 24 24">
+  <path d="M6 2h12v5l-4 4 4 4v5H6v-5l4-4-4-4V2z"/>
+</symbol>
+<!-- Scroll / document (replaces 📜) -->
+<symbol id="icon-scroll" viewBox="0 0 24 24">
+  <path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/>
+  <polyline points="14 2 14 8 20 8"/>
+  <line x1="16" y1="13" x2="8" y2="13"/>
+  <line x1="16" y1="17" x2="8" y2="17"/>
+</symbol>
+<!-- Bolt / lightning (replaces ⚡) -->
+<symbol id="icon-bolt" viewBox="0 0 24 24">
+  <polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"/>
+</symbol>
+<!-- Target / crosshair (replaces 🎯) -->
+<symbol id="icon-target" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="10"/>
+  <circle cx="12" cy="12" r="6"/>
+  <circle cx="12" cy="12" r="2"/>
+</symbol>
+<!-- Handshake / trust (replaces 🤝) -->
+<symbol id="icon-handshake" viewBox="0 0 24 24">
+  <path d="M11 17l-3.5-3.5a2.12 2.12 0 013-3L14 14"/>
+  <path d="M20.88 7.12l-3.17 3.17"/>
+  <path d="M3.12 7.12l3.17 3.17"/>
+  <path d="M2 12h4"/>
+  <path d="M18 12h4"/>
+  <path d="M7.76 4.25L12 2l4.24 2.25"/>
+</symbol>
+<!-- Leaf / organic (replaces 🌿) -->
+<symbol id="icon-leaf" viewBox="0 0 24 24">
+  <path d="M17 8C8 10 5.9 16.17 3.82 21.34l1.89.66.95-2.3c.48.17.98.3 1.34.3C19 20 22 3 22 3c-1 0-8 0-10 2"/>
+  <path d="M7 15c2-2 5.5-3 9-3"/>
+</symbol>
+<!-- Satellite (replaces 🛰) -->
+<symbol id="icon-satellite" viewBox="0 0 24 24">
+  <path d="M13 7L9 3 5 7l4 4"/>
+  <path d="M17 11l4 4-4 4-4-4"/>
+  <line x1="8" y1="11" x2="13" y2="16"/>
+  <line x1="3" y1="21" x2="3.01" y2="21"/>
+  <path d="M6 18a3 3 0 000 0"/>
+  <path d="M9 15a6 6 0 000 0"/>
+</symbol>
+<!-- Phone / mobile (replaces 📱) -->
+<symbol id="icon-phone" viewBox="0 0 24 24">
+  <rect x="5" y="2" width="14" height="20" rx="2"/>
+  <line x1="12" y1="18" x2="12.01" y2="18"/>
+</symbol>
+<!-- Masks / theater (replaces 🎭) -->
+<symbol id="icon-masks" viewBox="0 0 24 24">
+  <circle cx="12" cy="12" r="10"/>
+  <path d="M8 14s1.5 2 4 2 4-2 4-2"/>
+  <line x1="9" y1="9" x2="9.01" y2="9"/>
+  <line x1="15" y1="9" x2="15.01" y2="9"/>
+</symbol>
+<!-- Stars / cosmos (replaces 🌌) -->
+<symbol id="icon-cosmos" viewBox="0 0 24 24">
+  <polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/>
+</symbol>
+<!-- Gem / diamond (replaces 💎) -->
+<symbol id="icon-gem" viewBox="0 0 24 24">
+  <polygon points="6 3 18 3 22 9 12 22 2 9 6 3"/>
+  <line x1="2" y1="9" x2="22" y2="9"/>
+  <line x1="12" y1="22" x2="8" y2="9"/>
+  <line x1="12" y1="22" x2="16" y2="9"/>
+  <line x1="8" y1="9" x2="10" y2="3"/>
+  <line x1="16" y1="9" x2="14" y2="3"/>
+</symbol>
+<!-- Search / magnifying glass (replaces 🔍) -->
+<symbol id="icon-search" viewBox="0 0 24 24">
+  <circle cx="11" cy="11" r="8"/>
+  <line x1="21" y1="21" x2="16.65" y2="16.65"/>
+</symbol>
+</svg>
+<!-- YAKMESH-ICON-SPRITE-END -->
+<a href="#mainContent" class="skip-link">Skip to main content</a>
+  <nav class="docs-sidebar" id="sidebar">
+    <a href="index.html" class="sidebar-logo">
+      <span class="logo-icon"><svg class="doc-icon" aria-hidden="true"><use href="#icon-mountain"/></svg></span>
+      <span class="logo-text">Yakmesh</span>
+    </a>
+    <a href="/dashboard" class="sidebar-dashboard-link"><svg class="doc-icon" aria-hidden="true"><use href="#icon-dashboard"/></svg> <span>Dashboard</span></a>
+    <ul class="sidebar-nav">
+      <li class="sidebar-section"><span><svg class="doc-icon" aria-hidden="true"><use href="#icon-book"/></svg> Guides</span></li>
+      <li><a href="index.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-home"/></svg> <span>Overview</span></a></li>
+      <li><a href="getting-started.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-rocket"/></svg> <span>Getting Started</span></a></li>
+      <li><a href="tutorials.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-book"/></svg> <span>Tutorials</span></a></li>
+      <li class="sidebar-section"><span><svg class="doc-icon" aria-hidden="true"><use href="#icon-yak"/></svg> Protocol Stack</span></li>
+      <li><a href="yak-protocol.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-yak"/></svg> <span>YAK://</span></a></li>
+      <li><a href="annex.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-annex"/></svg> <span>ANNEX</span></a></li>
+      <li><a href="jhilke.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-jhilke"/></svg> <span>JHILKE</span></a></li>
+      <li><a href="nakpak.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-nakpak"/></svg> <span>NAKPAK</span></a></li>
+      <li><a href="namche.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-namche"/></svg> <span>NAMCHE</span></a></li>
+      <li><a href="doko.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-doko"/></svg> <span>DOKO</span></a></li>
+      <li><a href="sherpa.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-sherpa"/></svg> <span>SHERPA</span></a></li>
+      <li><a href="mandala.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-mandala"/></svg> <span>MANDALA</span></a></li>
+      <li><a href="mantra.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-mantra"/></svg> <span>MANTRA</span></a></li>
+      <li><a href="gumba.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-gumba"/></svg> <span>GUMBA</span></a></li>
+      <li><a href="yurt.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-yurt"/></svg> <span>YURT</span></a></li>
+      <li><a href="katha.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-katha"/></svg> <span>KATHA</span></a></li>
+      <li><a href="vani.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-vani"/></svg> <span>VANI</span></a></li>
+      <li><a href="darshan.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-darshan"/></svg> <span>DARSHAN</span></a></li>
+      <li><a href="stupa.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-stupa"/></svg> <span>STUPA</span></a></li>
+      <li><a href="lama.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-lama"/></svg> <span>LAMA</span></a></li>
+      <li><a href="mani.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-mani"/></svg> <span>MANI</span></a></li>
+      <li><a href="karma.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-karma"/></svg> <span>KARMA</span></a></li>
+      <li><a href="tattva.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-tattva"/></svg> <span>TATTVA</span></a></li>
+      <li><a href="tribhuj.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-tribhuj"/></svg> <span>TRIBHUJ</span></a></li>
+      <li><a href="ypc27.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-ypc27"/></svg> <span>YPC-27</span></a></li>
+      <li><a href="sakshi.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-sakshi"/></svg> <span>SAKSHI</span></a></li>
+      <li><a href="geo-proof.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-pramaan"/></svg> <span>PRAMAAN</span></a></li>
+      <li><a href="trust-security.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-suraksha"/></svg> <span>SURAKSHA</span></a></li>
+      <li><a href="tivra.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-tivra"/></svg> <span>TIVRA</span></a></li>
+      <li><a href="prahari.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-prahari"/></svg> <span>PRAHARI</span></a></li>
+      <li><a href="dharma.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-dharma"/></svg> <span>DHARMA</span></a></li>
+      <li><a href="seva.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-seva"/></svg> <span>SEVA</span></a></li>
+      <li><a href="docs-bundle.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-granth"/></svg> <span>GRANTH</span></a></li>
+      <li><a href="api.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-api"/></svg> <span>API</span></a></li>
+      <li><a href="adapters.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-adapters"/></svg> <span>Adapters</span></a></li>
+      <li class="sidebar-section"><span><svg class="doc-icon" aria-hidden="true"><use href="#icon-rocket"/></svg> Applications</span></li>
+      <li><a href="yakapp.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-yakapp"/></svg> <span>YakApp</span></a></li>
+      <li><a href="c2c.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-c2c"/></svg> <span>C2C</span></a></li>
+      <li><a href="studio.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-studio"/></svg> <span>Studio</span></a></li>
+      <li class="sidebar-section"><span><svg class="doc-icon" aria-hidden="true"><use href="#icon-gear"/></svg> Infrastructure</span></li>
+      <li><a href="cli.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-terminal"/></svg> <span>CLI</span></a></li>
+      <li><a href="configuration.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-gear"/></svg> <span>Configuration</span></a></li>
+      <li><a href="mesh.html" class="active"><svg class="doc-icon" aria-hidden="true"><use href="#icon-mandala"/></svg> <span>Mesh Network</span></a></li>
+      <li><a href="time-sources.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-mani"/></svg> <span>Time Sources</span></a></li>
+      <li><a href="webserver.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-server"/></svg> <span>Web Server</span></a></li>
+      <li><a href="advanced-systems.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-tivra"/></svg> <span>Advanced Systems</span></a></li>
+      <li class="sidebar-section"><span><svg class="doc-icon" aria-hidden="true"><use href="#icon-book"/></svg> Tutorials</span></li>
+      <li><a href="gumba-tutorial.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-gumba"/></svg> <span>GUMBA Tutorial</span></a></li>
+      <li class="sidebar-section"><span><svg class="doc-icon" aria-hidden="true"><use href="#icon-quickref"/></svg> Reference</span></li>
+      <li><a href="quick-reference.html"><svg class="doc-icon" aria-hidden="true"><use href="#icon-quickref"/></svg> <span>Quick Ref</span></a></li>
+    </ul>
+  </nav>
+  <button class="sidebar-toggle" id="sidebarToggle" title="Toggle sidebar">
+    <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+      <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 19l-7-7 7-7m8 14l-7-7 7-7" />
+    </svg>
+  </button>
+  <!-- Mobile overlay for tap-to-close sidebar -->
+  <div class="sidebar-overlay" id="sidebarOverlay"></div>
+  <main class="docs-main" id="mainContent">
+        <div class="docs-content">
+            <!-- Page Header -->
+            <div class="flex items-center gap-3 mb-4">
+                <svg class="doc-icon hero-icon" aria-hidden="true"><use href="#icon-mandala"/></svg>
+                <div>
+                    <div class="flex items-center gap-3">
+                        <h1 class="text-4xl font-bold">Mesh Network</h1>
+                        <span class="theme-badge text-xs px-2 py-1 rounded-full font-mono">v1.5.0</span>
+                    </div>
+                    <p class="theme-accent">WebSocket-based peer-to-peer mesh infrastructure</p>
+                </div>
+            </div>
+            <p class="text-xl text-mountain-300 mb-8">
+                The YAKMESH mesh network provides the communication backbone for all peer-to-peer operations.
+                Built on WebSockets with quantum-resistant cryptography, gossip protocols, and onion routing.
+            </p>
+            <!-- Philosophy Callout -->
+            <div class="mesh-philosophy rounded-xl p-6 mb-8">
+                <p class="text-lg text-teal-200 mb-2">
+                    <strong class="theme-accent">"Your packets travel like yak caravans through hidden mountain paths"</strong>
+                </p>
+                <p class="text-mountain-300">
+                    The mesh network is designed for resilience, privacy, and decentralization.
+                    No central servers, no single points of failure — just nodes cooperating through cryptographic trust.
+                </p>
+            </div>
+            <!-- Quick Start -->
+            <h2 class="text-2xl font-bold mb-4" id="quick-start">Quick Start</h2>
+            <p class="text-mountain-300 mb-4">
+                Create and start a mesh network node:
+            </p>
+            <pre class="language-javascript mb-8"><code>import { MeshNetwork, MessageTypes } from './mesh/network.js';
+// Create mesh network with your node identity
+const mesh = new MeshNetwork(identity, {
+  wsPort: 9001,           // WebSocket port (auto-fallback if in use)
+  maxPeers: 10,           // Maximum concurrent peer connections
+  pingInterval: 30000,    // Keep-alive ping interval (ms)
+  portRetries: 10,        // Try up to 10 sequential ports
+  networkId: 'yakmesh',   // Network identifier
+  networkFingerprint: fingerprint,  // Code proof verification
+});
+// Start listening for connections
+await mesh.start();
+// Connect to a peer
+await mesh.connect('ws://peer-node:9001');
+// Broadcast to all peers (gossip)
+mesh.broadcast({ type: 'custom', data: 'hello mesh!' });
+// Send to specific peer
+mesh.sendTo(nodeId, { action: 'sync', payload: data });
+// Listen for messages
+mesh.on(MessageTypes.GOSSIP, (msg, ws, nodeId) => {
+  console.log(`Gossip from ${nodeId}:`, msg.payload);
+});
+// Get connected peers
+const peers = mesh.getPeers();
+console.log(`Connected to ${peers.length} peers`);
+// Stop mesh server
+await mesh.stop();</code></pre>
+            <!-- Message Types Table -->
+            <h2 class="text-2xl font-bold mb-4" id="message-types">Message Types</h2>
+            <p class="text-mountain-300 mb-6">
+                The mesh protocol uses these message types for peer communication:
+            </p>
+            <div class="overflow-x-auto mb-8">
+                <table class="mesh-table rounded-lg overflow-hidden">
+                    <thead>
+                        <tr>
+                            <th>Type</th>
+                            <th>Constant</th>
+                            <th>Description</th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        <tr>
+                            <td><code>hello</code></td>
+                            <td><code>MessageTypes.HELLO</code></td>
+                            <td>Initial connection handshake with identity and network fingerprint</td>
+                        </tr>
+                        <tr>
+                            <td><code>welcome</code></td>
+                            <td><code>MessageTypes.WELCOME</code></td>
+                            <td>Response to hello with peer list</td>
+                        </tr>
+                        <tr>
+                            <td><code>ping</code></td>
+                            <td><code>MessageTypes.PING</code></td>
+                            <td>Keep-alive ping</td>
+                        </tr>
+                        <tr>
+                            <td><code>pong</code></td>
+                            <td><code>MessageTypes.PONG</code></td>
+                            <td>Keep-alive response</td>
+                        </tr>
+                        <tr>
+                            <td><code>peers</code></td>
+                            <td><code>MessageTypes.PEERS</code></td>
+                            <td>Share known peer endpoints</td>
+                        </tr>
+                        <tr>
+                            <td><code>sync_request</code></td>
+                            <td><code>MessageTypes.SYNC_REQUEST</code></td>
+                            <td>Request data synchronization</td>
+                        </tr>
+                        <tr>
+                            <td><code>sync_response</code></td>
+                            <td><code>MessageTypes.SYNC_RESPONSE</code></td>
+                            <td>Data sync response</td>
+                        </tr>
+                        <tr>
+                            <td><code>replicate</code></td>
+                            <td><code>MessageTypes.REPLICATE</code></td>
+                            <td>Push new data to peers</td>
+                        </tr>
+                        <tr>
+                            <td><code>gossip</code></td>
+                            <td><code>MessageTypes.GOSSIP</code></td>
+                            <td>Broadcast message with deduplication</td>
+                        </tr>
+                    </tbody>
+                </table>
+            </div>
+            <!-- Mesh Files Section -->
+            <h2 class="text-2xl font-bold mb-4" id="modules">Mesh Modules</h2>
+            <p class="text-mountain-300 mb-6">
+                The mesh subsystem is composed of specialized modules, each handling a critical aspect of network communication.
+            </p>
+            <div class="space-y-4 mb-8">
+                <!-- Network Core -->
+                <div class="module-card-network rounded-xl p-5">
+                    <div class="flex items-center gap-3 mb-3">
+                        <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-mandala"/></svg>
+                        <div>
+                            <h3 class="text-xl font-bold text-teal-300">MeshNetwork</h3>
+                            <span class="text-sm text-teal-400">network.js</span>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Core mesh network manager handling peer connections, message routing, and WebSocket server.
+                        Features automatic port fallback, code proof verification, and gossip with deduplication.
+                    </p>
+                    <pre class="language-javascript mb-3"><code>import { MeshNetwork, MessageTypes } from './mesh/network.js';
+const mesh = new MeshNetwork(identity, { wsPort: 9001 });
+await mesh.start();
+mesh.broadcast({ type: 'announce', data: myData });</code></pre>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-teal-900/50 text-teal-300 px-2 py-1 rounded">WebSocket</span>
+                        <span class="text-xs bg-teal-900/50 text-teal-300 px-2 py-1 rounded">Gossip Protocol</span>
+                        <span class="text-xs bg-teal-900/50 text-teal-300 px-2 py-1 rounded">Port Fallback</span>
+                        <span class="text-xs bg-teal-900/50 text-teal-300 px-2 py-1 rounded">Code Proof</span>
+                    </div>
+                </div>
+                <!-- ANNEX -->
+                <div class="module-card-annex rounded-xl p-5">
+                    <div class="flex items-center gap-3 mb-3">
+                        <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-lock"/></svg>
+                        <div>
+                            <h3 class="text-xl font-bold text-purple-300">ANNEX</h3>
+                            <span class="text-sm text-purple-400">annex.js — Autonomous Network Negotiated Encrypted eXchange</span>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        End-to-end encrypted point-to-point channels using ML-KEM768 (Kyber) for quantum-resistant key exchange
+                        and AES-256-GCM for authenticated encryption. Perfect forward secrecy via ephemeral keys.
+                    </p>
+                    <pre class="language-javascript mb-3"><code>import { AnnexChannel } from './mesh/annex.js';
+const channel = new AnnexChannel(myIdentity, peerId);
+await channel.establish(meshNetwork);
+await channel.send({ secret: 'data' });  // E2E encrypted</code></pre>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-purple-900/50 text-purple-300 px-2 py-1 rounded">ML-KEM768</span>
+                        <span class="text-xs bg-purple-900/50 text-purple-300 px-2 py-1 rounded">AES-256-GCM</span>
+                        <span class="text-xs bg-purple-900/50 text-purple-300 px-2 py-1 rounded">ML-DSA-65</span>
+                        <span class="text-xs bg-purple-900/50 text-purple-300 px-2 py-1 rounded">PFS</span>
+                    </div>
+                </div>
+                <!-- Beacon Broadcast -->
+                <div class="module-card-beacon rounded-xl p-5">
+                    <div class="flex items-center gap-3 mb-3">
+                        <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-signal"/></svg>
+                        <div>
+                            <h3 class="text-xl font-bold text-yellow-300">Beacon Broadcast</h3>
+                            <span class="text-sm text-yellow-400">beacon-broadcast.js — Broadcast Emergency Alert Channel Over Network</span>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Priority message propagation with guaranteed delivery. Flood-based protocol with intelligent
+                        deduplication, proof-of-receipt, and emergency priority levels (ROUTINE → CRITICAL).
+                    </p>
+                    <pre class="language-javascript mb-3"><code>import { BeaconBroadcaster, Priority } from './mesh/beacon-broadcast.js';
+const beacon = new BeaconBroadcaster(mesh);
+await beacon.broadcast(payload, {
+  priority: Priority.IMMEDIATE,
+  ttl: 10,  // hop count
+});</code></pre>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-yellow-900/50 text-yellow-300 px-2 py-1 rounded">Priority Levels</span>
+                        <span class="text-xs bg-yellow-900/50 text-yellow-300 px-2 py-1 rounded">Proof-of-Receipt</span>
+                        <span class="text-xs bg-yellow-900/50 text-yellow-300 px-2 py-1 rounded">TTL Control</span>
+                    </div>
+                </div>
+                <!-- SHERPA Discovery -->
+                <div class="module-card-sherpa rounded-xl p-5">
+                    <div class="flex items-center gap-3 mb-3">
+                        <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-mountain"/></svg>
+                        <div>
+                            <h3 class="text-xl font-bold text-green-300">SHERPA Discovery</h3>
+                            <span class="text-sm text-green-400">sherpa-discovery.js — Secure Hidden Endpoint Resolution Path Architecture</span>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Decentralized peer discovery using public web endpoints as a DHT. Nodes expose
+                        <code class="bg-mountain-800 px-1 rounded">/.well-known/yakmesh/beacon</code> for self-organizing peer registry.
+                        No central bootstrap nodes required.
+                    </p>
+                    <pre class="language-javascript mb-3"><code>import { SherpaDiscovery } from './mesh/sherpa-discovery.js';
+const sherpa = new SherpaDiscovery(identity, {
+  maxCrawlDepth: 3,
+  crawlInterval: 300000,  // 5 minutes
+});
+const peers = await sherpa.discover(seedEndpoints);</code></pre>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-green-900/50 text-green-300 px-2 py-1 rounded">Web DHT</span>
+                        <span class="text-xs bg-green-900/50 text-green-300 px-2 py-1 rounded">Peer Scoring</span>
+                        <span class="text-xs bg-green-900/50 text-green-300 px-2 py-1 rounded">Geo-Proof v2.5</span>
+                    </div>
+                </div>
+                <!-- NAKPAK Routing -->
+                <div class="module-card-nakpak rounded-xl p-5">
+                    <div class="flex items-center gap-3 mb-3">
+                        <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-nakpak"/></svg>
+                        <div>
+                            <h3 class="text-xl font-bold text-blue-300">NAKPAK Routing</h3>
+                            <span class="text-sm text-blue-400">nakpak-routing.js — Nested Anonymous Kernel for Private Authenticated Komms</span>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Post-quantum secure onion routing with ML-DSA-65 signatures at every layer and ML-KEM key encapsulation.
+                        Multi-layer encryption with timing attack resistance through temporal padding.
+                    </p>
+                    <pre class="language-javascript mb-3"><code>import { NakpakRouter } from './mesh/nakpak-routing.js';
+const router = new NakpakRouter(identity, mesh);
+const circuit = await router.buildCircuit(3);  // 3 hops
+await router.sendAnonymous(circuit, payload);</code></pre>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-blue-900/50 text-blue-300 px-2 py-1 rounded">Onion Routing</span>
+                        <span class="text-xs bg-blue-900/50 text-blue-300 px-2 py-1 rounded">ML-KEM768</span>
+                        <span class="text-xs bg-blue-900/50 text-blue-300 px-2 py-1 rounded">Decoy Traffic</span>
+                        <span class="text-xs bg-blue-900/50 text-blue-300 px-2 py-1 rounded">Fixed-Size Packets</span>
+                    </div>
+                </div>
+                <!-- Pulse Sync -->
+                <div class="module-card-pulse rounded-xl p-5">
+                    <div class="flex items-center gap-3 mb-3">
+                        <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-heartbeat"/></svg>
+                        <div>
+                            <h3 class="text-xl font-bold text-pink-300">Pulse Sync</h3>
+                            <span class="text-sm text-pink-400">pulse-sync.js — Precision Universal Latency Sync Engine</span>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        The heartbeat of the mesh network. Distributed liveness detection with temporal proofs,
+                        cryptographic heartbeat chains, and partition detection through gap analysis.
+                    </p>
+                    <pre class="language-javascript mb-3"><code>import { PulseSync } from './mesh/pulse-sync.js';
+const pulse = new PulseSync(identity, mesh, {
+  heartbeatIntervalMs: 1000,
+  missedBeatsThreshold: 5,
+});
+pulse.on('partition', (nodes) => handlePartition(nodes));</code></pre>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-pink-900/50 text-pink-300 px-2 py-1 rounded">Heartbeat Chains</span>
+                        <span class="text-xs bg-pink-900/50 text-pink-300 px-2 py-1 rounded">Partition Detection</span>
+                        <span class="text-xs bg-pink-900/50 text-pink-300 px-2 py-1 rounded">Leader Election</span>
+                    </div>
+                </div>
+                <!-- Echo Ranging -->
+                <div class="module-card-echo rounded-xl p-5">
+                    <div class="flex items-center gap-3 mb-3">
+                        <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-pin"/></svg>
+                        <div>
+                            <h3 class="text-xl font-bold text-indigo-300">Echo Ranging</h3>
+                            <span class="text-sm text-indigo-400">echo-ranging.js — Encrypted Coordinate Heuristic Oracle</span>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Privacy-preserving network cartography. Maps mesh topology using encrypted timing probes
+                        without exposing node positions. Builds virtual coordinate space from RTT measurements.
+                    </p>
+                    <pre class="language-javascript mb-3"><code>import { EchoRanging } from './mesh/echo-ranging.js';
+const echo = new EchoRanging(identity, mesh);
+const rtt = await echo.measureLatency(peerId);
+const coords = echo.getVirtualCoordinates();</code></pre>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-indigo-900/50 text-indigo-300 px-2 py-1 rounded">RTT Measurement</span>
+                        <span class="text-xs bg-indigo-900/50 text-indigo-300 px-2 py-1 rounded">Virtual Coords</span>
+                        <span class="text-xs bg-indigo-900/50 text-indigo-300 px-2 py-1 rounded">Encrypted Probes</span>
+                    </div>
+                </div>
+                <!-- Temporal Encoder -->
+                <div class="module-card-temporal rounded-xl p-5">
+                    <div class="flex items-center gap-3 mb-3">
+                        <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-hourglass"/></svg>
+                        <div>
+                            <h3 class="text-xl font-bold text-amber-300">Temporal Encoder</h3>
+                            <span class="text-sm text-amber-400">temporal-encoder.js — Temporal Mesh Encoding</span>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Novel packet resilience through temporal encoding. Instead of erasure coding across space,
+                        TME encodes data across TIME using synchronized clocks as the redundancy dimension.
+                    </p>
+                    <pre class="language-javascript mb-3"><code>import { TemporalEncoder } from './mesh/temporal-encoder.js';
+const encoder = new TemporalEncoder({
+  sliceIntervalNs: 50_000_000,  // 50ms slices
+  minSlicesForReconstruction: 0.6,
+});
+const slices = encoder.encode(data);</code></pre>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-amber-900/50 text-amber-300 px-2 py-1 rounded">Temporal Slicing</span>
+                        <span class="text-xs bg-amber-900/50 text-amber-300 px-2 py-1 rounded">Hash Chains</span>
+                        <span class="text-xs bg-amber-900/50 text-amber-300 px-2 py-1 rounded">Path Diversity</span>
+                    </div>
+                </div>
+            </div>
+            <!-- Security Modules -->
+            <h2 class="text-2xl font-bold mb-4" id="security">Security Modules</h2>
+            <p class="text-mountain-300 mb-6">
+                Defense-in-depth protection against network attacks:
+            </p>
+            <div class="space-y-4 mb-8">
+                <!-- Rate Limiter -->
+                <div class="module-card-security rounded-xl p-5">
+                    <div class="flex items-center gap-3 mb-3">
+                        <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-traffic"/></svg>
+                        <div>
+                            <h3 class="text-xl font-bold text-red-300">Rate Limiter</h3>
+                            <span class="text-sm text-red-400">rate-limiter.js</span>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Sliding window rate limiter protecting against connection floods, handshake spam, and gossip storms.
+                        Per-IP and per-node tracking with automatic banning.
+                    </p>
+                    <pre class="language-javascript mb-3"><code>import { ConnectionRateLimiter } from './mesh/rate-limiter.js';
+const limiter = new ConnectionRateLimiter({
+  maxConnectionsPerMinute: 10,
+  maxMessagesPerSecond: 50,
+  maxHandshakesPerMinute: 5,
+  banThreshold: 5,
+  banDuration: 300000,  // 5 minutes
+});
+if (!limiter.checkConnection(ip).allowed) {
+  ws.close(1008, 'Rate limited');
+}</code></pre>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Sliding Window</span>
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Auto-Ban</span>
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Per-IP Tracking</span>
+                    </div>
+                </div>
+                <!-- Message Validator -->
+                <div class="module-card-security rounded-xl p-5">
+                    <div class="flex items-center gap-3 mb-3">
+                        <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-check"/></svg>
+                        <div>
+                            <h3 class="text-xl font-bold text-red-300">Message Validator</h3>
+                            <span class="text-sm text-red-400">message-validator.js</span>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Validates message size and structure to prevent amplification attacks.
+                        Enforces payload limits by type: gossip (64KB), handshake (8KB), listing (128KB), data (512KB).
+                    </p>
+                    <pre class="language-javascript mb-3"><code>import { MessageValidator, SafeJsonParser } from './mesh/message-validator.js';
+const validator = new MessageValidator();
+const parser = new SafeJsonParser();
+const sizeCheck = validator.validateRaw(rawMessage, 'gossip');
+if (!sizeCheck.valid) reject(sizeCheck.reason);
+const parsed = parser.parse(rawMessage);
+if (!parsed.success) reject(parsed.error);
+const structCheck = validator.validateStructure(parsed.data, 'gossip');
+if (!structCheck.valid) reject(structCheck.reason);</code></pre>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Size Limits</span>
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Depth Check</span>
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Safe JSON</span>
+                    </div>
+                </div>
+                <!-- Replay Defense -->
+                <div class="module-card-security rounded-xl p-5">
+                    <div class="flex items-center gap-3 mb-3">
+                        <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-sync"/></svg>
+                        <div>
+                            <h3 class="text-xl font-bold text-red-300">Replay Defense</h3>
+                            <span class="text-sm text-red-400">replay-defense.js</span>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Multi-layer replay attack protection with nonce registry, timestamp validation, and sequence tracking.
+                        Automatically detects and rejects duplicate or out-of-window messages.
+                    </p>
+                    <pre class="language-javascript mb-3"><code>import { NonceRegistry, TimestampValidator, SequenceTracker }
+  from './mesh/replay-defense.js';
+const nonces = new NonceRegistry({ maxAge: 3600000 });
+const timestamps = new TimestampValidator({ maxAge: 600000 });
+const sequences = new SequenceTracker();
+// Generate nonce for outgoing message
+const nonce = nonces.generate();
+// Validate incoming message
+const nonceOk = nonces.validate(msg.nonce);
+const timeOk = timestamps.validate(msg.timestamp);
+const seqOk = sequences.validate(msg.senderId, msg.sequence);</code></pre>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Nonce Registry</span>
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Timestamp</span>
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Sequence Window</span>
+                    </div>
+                </div>
+                <!-- Sybil Defense -->
+                <div class="module-card-security rounded-xl p-5">
+                    <div class="flex items-center gap-3 mb-3">
+                        <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-users"/></svg>
+                        <div>
+                            <h3 class="text-xl font-bold text-red-300">Sybil Defense</h3>
+                            <span class="text-sm text-red-400">sybil-defense.js</span>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Protection against Sybil attacks through NAVR (proof-of-work challenges),
+                        reputation tracking, and subnet diversity enforcement.
+                    </p>
+                    <pre class="language-javascript mb-3"><code>import { NAVR, ReputationTracker, SubnetDiversity }
+  from './mesh/sybil-defense.js';
+const navr = new NAVR({ difficulty: 16 });
+const reputation = new ReputationTracker();
+const subnets = new SubnetDiversity({ maxPerSubnet: 3 });
+// Challenge new peer
+const challenge = navr.createChallenge(peerId);
+// Peer solves and returns solution
+const verified = navr.verify(challenge, solution);
+// Track reputation
+reputation.registerNode(peerId, solution);
+reputation.reportGoodBehavior(peerId);
+const trust = reputation.getTrustLevel(peerId);  // 'trusted'|'normal'|'suspicious'|'banned'
+// Check subnet diversity
+if (!subnets.allowConnection(peerIp).allowed) {
+  reject('Too many connections from this subnet');
+}</code></pre>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">NAVR PoW</span>
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Reputation</span>
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Subnet Diversity</span>
+                    </div>
+                </div>
+            </div>
+            <!-- Network Features -->
+            <h2 class="text-2xl font-bold mb-4" id="features">Key Features</h2>
+            <div class="grid md:grid-cols-2 gap-4 mb-8">
+                <div class="bg-mountain-800 rounded-xl p-5">
+                    <p class="font-semibold text-teal-400 mb-2"><svg class="doc-icon inline-icon" width="24" height="24" aria-hidden="true"><use href="#icon-sync"/></svg> Automatic Port Fallback</p>
+                    <p class="text-mountain-300 text-sm">
+                        If the configured WebSocket port is in use, automatically tries sequential ports
+                        up to <code class="bg-mountain-700 px-1 rounded">portRetries</code> times.
+                    </p>
+                </div>
+                <div class="bg-mountain-800 rounded-xl p-5">
+                    <p class="font-semibold text-teal-400 mb-2"><svg class="doc-icon inline-icon" width="24" height="24" aria-hidden="true"><use href="#icon-lock"/></svg> Code Proof Verification</p>
+                    <p class="text-mountain-300 text-sm">
+                        Network fingerprint exchanged during handshake. Nodes running different codebases
+                        are automatically rejected.
+                    </p>
+                </div>
+                <div class="bg-mountain-800 rounded-xl p-5">
+                    <p class="font-semibold text-teal-400 mb-2"><svg class="doc-icon inline-icon" width="24" height="24" aria-hidden="true"><use href="#icon-megaphone"/></svg> Gossip Deduplication</p>
+                    <p class="text-mountain-300 text-sm">
+                        Messages include unique IDs tracked in <code class="bg-mountain-700 px-1 rounded">seenMessages</code>
+                        set. Prevents infinite broadcast loops.
+                    </p>
+                </div>
+                <div class="bg-mountain-800 rounded-xl p-5">
+                    <p class="font-semibold text-teal-400 mb-2"><svg class="doc-icon inline-icon" aria-hidden="true"><use href="#icon-pen"/></svg> Signed Messages</p>
+                    <p class="text-mountain-300 text-sm">
+                        All outgoing messages are signed with the node's identity using ML-DSA-65.
+                        Receivers verify authenticity.
+                    </p>
+                </div>
+            </div>
+            <!-- Configuration Options -->
+            <h2 class="text-2xl font-bold mb-4" id="configuration">Configuration</h2>
+            <p class="text-mountain-300 mb-4">
+                MeshNetwork constructor options:
+            </p>
+            <div class="overflow-x-auto mb-8">
+                <table class="mesh-table rounded-lg overflow-hidden">
+                    <thead>
+                        <tr>
+                            <th>Option</th>
+                            <th>Default</th>
+                            <th>Description</th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        <tr>
+                            <td><code>wsPort</code></td>
+                            <td><code>9001</code></td>
+                            <td>WebSocket server port</td>
+                        </tr>
+                        <tr>
+                            <td><code>maxPeers</code></td>
+                            <td><code>10</code></td>
+                            <td>Maximum concurrent peer connections</td>
+                        </tr>
+                        <tr>
+                            <td><code>pingInterval</code></td>
+                            <td><code>30000</code></td>
+                            <td>Keep-alive ping interval (ms)</td>
+                        </tr>
+                        <tr>
+                            <td><code>portRetries</code></td>
+                            <td><code>10</code></td>
+                            <td>Number of sequential ports to try if base port is in use</td>
+                        </tr>
+                        <tr>
+                            <td><code>networkId</code></td>
+                            <td><code>null</code></td>
+                            <td>Network identifier for code proof</td>
+                        </tr>
+                        <tr>
+                            <td><code>networkFingerprint</code></td>
+                            <td><code>null</code></td>
+                            <td>Codebase hash for peer verification</td>
+                        </tr>
+                        <tr>
+                            <td><code>publicHost</code></td>
+                            <td><code>null</code></td>
+                            <td>Public hostname for endpoint advertisement</td>
+                        </tr>
+                        <tr>
+                            <td><code>rateLimiter</code></td>
+                            <td><code>{}</code></td>
+                            <td>Rate limiter configuration object</td>
+                        </tr>
+                    </tbody>
+                </table>
+            </div>
+            <!-- MeshNetwork API -->
+            <h2 class="text-2xl font-bold mb-4" id="api">MeshNetwork API</h2>
+            <div class="overflow-x-auto mb-8">
+                <table class="mesh-table rounded-lg overflow-hidden">
+                    <thead>
+                        <tr>
+                            <th>Method</th>
+                            <th>Description</th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        <tr>
+                            <td><code>start()</code></td>
+                            <td>Start WebSocket server with automatic port fallback</td>
+                        </tr>
+                        <tr>
+                            <td><code>connect(endpoint)</code></td>
+                            <td>Connect to a peer node, returns identity on WELCOME</td>
+                        </tr>
+                        <tr>
+                            <td><code>broadcast(message)</code></td>
+                            <td>Send gossip message to all connected peers</td>
+                        </tr>
+                        <tr>
+                            <td><code>sendTo(nodeId, message)</code></td>
+                            <td>Send direct message to specific peer</td>
+                        </tr>
+                        <tr>
+                            <td><code>on(type, handler)</code></td>
+                            <td>Register message handler for type</td>
+                        </tr>
+                        <tr>
+                            <td><code>off(type, handler)</code></td>
+                            <td>Remove message handler</td>
+                        </tr>
+                        <tr>
+                            <td><code>emit(type, ...args)</code></td>
+                            <td>Emit event to registered handlers</td>
+                        </tr>
+                        <tr>
+                            <td><code>isConnectedTo(nodeId)</code></td>
+                            <td>Check if connected to a specific node</td>
+                        </tr>
+                        <tr>
+                            <td><code>getPeers()</code></td>
+                            <td>Get list of connected peers with metadata</td>
+                        </tr>
+                        <tr>
+                            <td><code>getPublicEndpoint()</code></td>
+                            <td>Get this node's public WebSocket endpoint</td>
+                        </tr>
+                        <tr>
+                            <td><code>stop()</code></td>
+                            <td>Stop server and close all connections</td>
+                        </tr>
+                    </tbody>
+                </table>
+            </div>
+            <!-- Related Documentation -->
+            <div class="bg-mountain-800 border theme-border rounded-xl p-6 mt-8">
+                <h3 class="text-lg font-semibold mb-4">Related Documentation</h3>
+                <ul class="space-y-3 text-mountain-300">
+                    <li class="flex items-center gap-2">
+                        <svg class="doc-icon inline-icon" aria-hidden="true"><use href="#icon-sherpa"/></svg>
+                        <a href="sherpa.html" class="theme-accent theme-accent-hover">SHERPA</a>
+                        <span class="text-mountain-400 text-sm">— Detailed peer discovery documentation</span>
+                    </li>
+                    <li class="flex items-center gap-2">
+                        <svg class="doc-icon inline-icon" aria-hidden="true"><use href="#icon-nakpak"/></svg>
+                        <a href="nakpak.html" class="theme-accent theme-accent-hover">NAKPAK</a>
+                        <span class="text-mountain-400 text-sm">— Onion routing deep dive</span>
+                    </li>
+                    <li class="flex items-center gap-2">
+                        <svg class="doc-icon inline-icon" aria-hidden="true"><use href="#icon-annex"/></svg>
+                        <a href="annex.html" class="theme-accent theme-accent-hover">ANNEX</a>
+                        <span class="text-mountain-400 text-sm">— Encrypted P2P channels</span>
+                    </li>
+                    <li class="flex items-center gap-2">
+                        <svg class="doc-icon inline-icon" aria-hidden="true"><use href="#icon-tattva"/></svg>
+                        <a href="tattva.html" class="theme-accent theme-accent-hover">TATTVA</a>
+                        <span class="text-mountain-400 text-sm">— Code proof and validation</span>
+                    </li>
+                    <li class="flex items-center gap-2">
+                        <svg class="doc-icon inline-icon" aria-hidden="true"><use href="#icon-suraksha"/></svg>
+                        <a href="trust-security.html" class="theme-accent theme-accent-hover">SURAKSHA</a>
+                        <span class="text-mountain-400 text-sm">— Trust scoring and verification</span>
+                    </li>
+                    <li class="flex items-center gap-2">
+                        <svg class="doc-icon inline-icon" aria-hidden="true"><use href="#icon-gear"/></svg>
+                        <a href="configuration.html" class="theme-accent theme-accent-hover">Configuration</a>
+                        <span class="text-mountain-400 text-sm">— Full configuration reference</span>
+                    </li>
+                </ul>
+            </div>
+                  <!-- Journey Navigation -->
+                                                                  <div class="border-t border-mountain-700 mt-12 pt-8">
+        <h2 class="text-xl font-bold mb-6">Continue the Journey</h2>
+        <div class="flex flex-col sm:flex-row gap-4">
+          <a href="configuration.html" class="flex-1 block bg-mountain-800 border border-mountain-700 rounded-xl p-4 hover:border-theme-accent transition group">
+            <div class="text-xs text-mountain-400 mb-1">← Previous</div>
+            <div class="flex items-center gap-2">
+              <svg class="doc-icon journey-icon" aria-hidden="true"><use href="#icon-gear"/></svg>
+              <span class="font-semibold group-hover:text-theme-accent">Configuration</span>
+            </div>
+            <p class="text-mountain-400 text-sm mt-1">Node configuration reference</p>
+          </a>
+          <a href="time-sources.html" class="flex-1 block bg-mountain-800 border border-theme-primary rounded-xl p-4 hover:border-theme-accent transition group">
+            <div class="text-xs text-mountain-400 mb-1">Next →</div>
+            <div class="flex items-center gap-2">
+              <svg class="doc-icon journey-icon" aria-hidden="true"><use href="#icon-mani"/></svg>
+              <span class="font-semibold group-hover:text-theme-accent">Time Sources</span>
+            </div>
+            <p class="text-mountain-400 text-sm mt-1">Precision time synchronization</p>
+          </a>
+        </div>
+      </div>
+    </main>
+  <footer class="docs-footer">
+    <p>© 2026 YAKMESH™</p>
+  </footer><!-- Scripts -->
+    <script src="prism.min.js" defer></script>
+    <script src="prism-javascript.min.js" defer></script>
+    <script src="prism-bash.min.js" defer></script>
+    <script src="prism-json.min.js" defer></script>
+    <script src="docs.js" defer></script>
+</body>
+</html>