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/gumba-tutorial.html ADDED Viewed

@@ -0,0 +1,1144 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="gumba">
+<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>GUMBA Tutorial | YAKMESH Documentation</title>
+    <meta name="description" content="Step-by-step tutorial for using GUMBA proof-based access control in YAKMESH.">
+    <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: #fbbf24; }
+        .theme-accent-hover:hover { color: #fcd34d; }
+        .theme-badge { background: rgba(251, 191, 36, 0.2); color: #fbbf24; }
+        .theme-border { border-color: #f59e0b; }
+        .theme-callout { background: rgba(251, 191, 36, 0.1); border-color: #d97706; }
+        .active-link { background: rgba(251, 191, 36, 0.2) !important; color: #fbbf24 !important; }
+        .tutorial-card { background: rgba(30, 41, 59, 0.5); border: 1px solid #334155; border-radius: 0.75rem; padding: 1.5rem; margin-bottom: 1.5rem; }
+        .tutorial-card:hover { border-color: #f59e0b; }
+        .step-number { display: inline-flex; align-items: center; justify-content: center; width: 2rem; height: 2rem; background: #f59e0b; color: white; border-radius: 50%; font-weight: bold; margin-right: 0.75rem; }
+        .warning-box { background: rgba(239, 68, 68, 0.1); border: 1px solid #dc2626; border-radius: 0.5rem; padding: 1rem; }
+        .info-box { background: rgba(59, 130, 246, 0.1); border: 1px solid #2563eb; border-radius: 0.5rem; padding: 1rem; }
+    </style>
+    <!-- Open Graph -->
+    <meta property="og:type" content="article">
+    <meta property="og:site_name" content="Yakmesh Documentation">
+    <meta property="og:title" content="GUMBA Tutorial — Yakmesh">
+    <meta property="og:description" content="GUMBA tutorial — step-by-step guide to implementing role-based access control.">
+</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"><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" class="active"><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>
+  <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-gumba"/></svg>
+        <div>
+          <h1 class="text-4xl font-bold">GUMBA Tutorial</h1>
+          <p class="theme-accent">Build a private chat room in 15 minutes</p>
+        </div>
+      </div>
+      <p class="text-xl text-mountain-300 mb-8">
+        Learn to create and manage GUMBA-protected spaces with step-by-step instructions.
+      </p>
+      <!-- Prerequisites -->
+      <div class="info-box mb-8">
+        <h2 class="font-bold mb-2"><svg class="doc-icon inline-icon" width="24" height="24" aria-hidden="true"><use href="#icon-scroll"/></svg> Prerequisites</h2>
+        <ul class="text-mountain-300 text-sm space-y-1">
+          <li>• YAKMESH node installed and running</li>
+          <li>• Basic understanding of Node.js and async/await</li>
+          <li>• DOKO identity created (see <a href="doko.html" class="theme-accent">DOKO documentation</a>)</li>
+        </ul>
+      </div>
+      <!-- Tutorial 1: Create a Private Chat Room -->
+      <section id="tutorial-1" class="mb-16">
+        <h2 class="text-3xl font-bold mb-6 flex items-center gap-3">
+          <svg class="doc-icon hero-icon" aria-hidden="true"><use href="#icon-gumba"/></svg> Tutorial 1: Create a Private Chat Room
+        </h2>
+        <p class="text-mountain-300 mb-6">
+          In this tutorial, you'll create a GUMBA-protected chat room, add members,
+          and handle access requests from visitors.
+        </p>
+        <!-- Step 1 -->
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3"><span class="step-number">1</span> Import GUMBA Components</h3>
+          <p class="text-mountain-300 mb-4">First, import the necessary GUMBA components:</p>
+          <pre class="language-javascript"><code>import {
+  GumbaHub,
+  GumbaProof,
+  GUMBA_ROLE,
+  GUMBA_PROOF_TYPE,
+} from 'yakmesh/mesh/gumba.js';
+// You'll also need your node's identity
+import { loadIdentity } from 'yakmesh/mesh/identity.js';</code></pre>
+        </div>
+        <!-- Step 2 -->
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3"><span class="step-number">2</span> Initialize the GUMBA Hub</h3>
+          <p class="text-mountain-300 mb-4">Create a GumbaHub with your node's identity:</p>
+          <pre class="language-javascript"><code>// Load your node's identity
+const identity = await loadIdentity();
+// Create the GUMBA hub
+// The second parameter is an ANNEX instance for secure delivery (optional)
+const hub = new GumbaHub(identity, null);
+console.log('GUMBA Hub initialized');</code></pre>
+        </div>
+        <!-- Step 3 -->
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3"><span class="step-number">3</span> Create a Bundle (Chat Room)</h3>
+          <p class="text-mountain-300 mb-4">Create a new encrypted bundle for your chat room:</p>
+          <pre class="language-javascript"><code>// Create a new bundle with a unique ID
+hub.createBundle('team-chat', {
+  name: 'Team Chat Room',
+  description: 'Private discussions for the team',
+});
+// Get the bundle reference
+const bundle = hub.getBundle('team-chat');
+console.log('Bundle created:', bundle.getInfo());</code></pre>
+          <div class="info-box mt-4">
+            <p class="text-sm text-mountain-300">
+              <svg class="doc-icon inline-icon" width="24" height="24" aria-hidden="true"><use href="#icon-bolt"/></svg> The bundle ID must be unique within your hub. The bundle is automatically
+              encrypted with a key derived from your node's secret.
+            </p>
+          </div>
+        </div>
+        <!-- Step 4 -->
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3"><span class="step-number">4</span> Add Members</h3>
+          <p class="text-mountain-300 mb-4">Add members with appropriate roles:</p>
+          <pre class="language-javascript"><code>// Add Alice as an admin
+bundle.addMember(
+  'doko-alice-abc123',      // Alice's DOKO ID
+  GUMBA_ROLE.ADMIN,         // Role
+  identity.identity.dokoId  // Your DOKO ID (as owner)
+);
+// Add Bob as a regular member
+bundle.addMember(
+  'doko-bob-def456',
+  GUMBA_ROLE.MEMBER,
+  identity.identity.dokoId
+);
+// Add Carol as read-only
+bundle.addMember(
+  'doko-carol-ghi789',
+  GUMBA_ROLE.READER,
+  identity.identity.dokoId
+);
+console.log('Members added:', bundle.memberTree.getMembers());</code></pre>
+        </div>
+        <!-- Step 5 -->
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3"><span class="step-number">5</span> Register Public Keys</h3>
+          <p class="text-mountain-300 mb-4">Register member public keys for signature verification:</p>
+          <pre class="language-javascript"><code>// Register public keys for each member
+// In production, these would come from KHATA network lookup
+hub.registerPublicKey('doko-alice-abc123', alicePublicKey);
+hub.registerPublicKey('doko-bob-def456', bobPublicKey);
+hub.registerPublicKey('doko-carol-ghi789', carolPublicKey);</code></pre>
+          <div class="warning-box mt-4">
+            <p class="text-sm text-red-300">
+              <svg class="doc-icon inline-icon" width="24" height="24" aria-hidden="true"><use href="#icon-warning"/></svg> In production, public keys are resolved via the KHATA protocol.
+              Manual registration is for testing or pre-cached keys only.
+            </p>
+          </div>
+        </div>
+        <!-- Step 6 -->
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3"><span class="step-number">6</span> Add Some Messages</h3>
+          <p class="text-mountain-300 mb-4">Add initial messages to the chat room:</p>
+          <pre class="language-javascript"><code>// Add messages (as the owner)
+bundle.addMessage(
+  { text: 'Welcome to the team chat!', type: 'text' },
+  identity.identity.dokoId
+);
+bundle.addMessage(
+  { text: 'Please introduce yourselves.', type: 'text' },
+  identity.identity.dokoId
+);
+console.log('Messages added');</code></pre>
+        </div>
+        <!-- Step 7 -->
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3"><span class="step-number">7</span> Handle Access Requests</h3>
+          <p class="text-mountain-300 mb-4">When a visitor wants to access the chat room:</p>
+          <pre class="language-javascript"><code>// Visitor requests access (on their node)
+// Step 1: Issue a challenge
+const challenge = hub.issueChallenge('team-chat', visitorDokoId);
+// Step 2: Send challenge to visitor (via mesh network)
+// ... challenge is sent to visitor node ...
+// Step 3: Visitor signs the challenge (on their node)
+const signedProof = GumbaProof.signChallenge(challenge, visitorSecretKey);
+// Step 4: Visitor sends signed proof back
+// ... signed proof is received ...
+// Step 5: Verify and grant access (on your node)
+const access = await hub.handleAccessRequest(
+  'team-chat',
+  signedProof,
+  'visitor-node-id'
+);
+if (access.granted) {
+  console.log('Access granted!');
+  console.log('Session ID:', access.sessionId);
+  console.log('Role:', access.role);
+} else {
+  console.log('Access denied:', access.reason);
+}</code></pre>
+        </div>
+        <!-- Step 8 -->
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3"><span class="step-number">8</span> Serve Messages</h3>
+          <p class="text-mountain-300 mb-4">Retrieve and deliver messages for an active session:</p>
+          <pre class="language-javascript"><code>// Get messages for a session
+const result = await hub.getMessages(access.sessionId);
+if (result.error) {
+  console.log('Error:', result.error);
+} else {
+  console.log('Messages:', result.messages);
+  // Messages are decrypted locally before delivery
+}
+// Post a message (if the session has write permission)
+const postResult = await hub.postMessage(access.sessionId, {
+  text: 'Hello from visitor!',
+  type: 'text',
+});
+console.log('Message posted:', postResult.success);</code></pre>
+        </div>
+      </section>
+      <!-- Tutorial 2: Attestation-Based Access -->
+      <section id="tutorial-2" class="mb-16">
+        <h2 class="text-3xl font-bold mb-6 flex items-center gap-3">
+          <svg class="doc-icon hero-icon" aria-hidden="true"><use href="#icon-gumba"/></svg> Tutorial 2: Attestation-Based Access
+        </h2>
+        <p class="text-mountain-300 mb-6">
+          Learn how existing members can vouch for new members without owner involvement.
+        </p>
+        <!-- Step 1 -->
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3"><span class="step-number">1</span> Create an Attestation</h3>
+          <p class="text-mountain-300 mb-4">An existing member with sufficient role creates an attestation:</p>
+          <pre class="language-javascript"><code>// Alice (admin) creates attestation for Dave
+const attestation = GumbaProof.createAttestation({
+  bundleId: 'team-chat',
+  grantorDokoId: alice.dokoId,
+  granteeDokoId: 'doko-dave-xyz999',
+  grantorSecretKey: alice.secretKey,
+  grantedRole: GUMBA_ROLE.MEMBER,  // Alice can grant up to MEMBER
+  expiry: Date.now() + 24 * 60 * 60 * 1000,  // Valid for 24 hours
+});
+// Alice sends attestation to Dave out-of-band
+// (email, secure message, QR code, etc.)</code></pre>
+        </div>
+        <!-- Step 2 -->
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3"><span class="step-number">2</span> Use Attestation for Access</h3>
+          <p class="text-mountain-300 mb-4">Dave uses the attestation to request access:</p>
+          <pre class="language-javascript"><code>// Dave presents the attestation to the hub
+const access = await hub.handleAccessRequest(
+  'team-chat',
+  attestation,  // Use attestation as proof
+  'dave-node-id'
+);
+if (access.granted) {
+  console.log('Dave granted access via attestation!');
+  console.log('Role:', access.role);  // Should be MEMBER
+}</code></pre>
+        </div>
+        <div class="info-box">
+          <h4 class="font-bold mb-2"><svg class="doc-icon inline-icon" width="24" height="24" aria-hidden="true"><use href="#icon-pen"/></svg> Attestation Rules</h4>
+          <ul class="text-sm text-mountain-300 space-y-1">
+            <li>• Grantors can only attest roles equal to or below their own role</li>
+            <li>• OWNERs can attest any role except OWNER</li>
+            <li>• ADMINs can attest MEMBER or READER</li>
+            <li>• MEMBERs can only attest READER</li>
+            <li>• READERs cannot create attestations</li>
+          </ul>
+        </div>
+      </section>
+      <!-- Tutorial 3: Anonymous Access with Merkle Proofs -->
+      <section id="tutorial-3" class="mb-16">
+        <h2 class="text-3xl font-bold mb-6 flex items-center gap-3">
+          <svg class="doc-icon hero-icon" aria-hidden="true"><use href="#icon-gumba"/></svg> Tutorial 3: Anonymous Access
+        </h2>
+        <p class="text-mountain-300 mb-6">
+          Use Merkle proofs for privacy-preserving access where identity should remain hidden.
+        </p>
+        <!-- Step 1 -->
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3"><span class="step-number">1</span> Generate Merkle Proof</h3>
+          <p class="text-mountain-300 mb-4">Member generates a proof of their membership:</p>
+          <pre class="language-javascript"><code>// Get the bundle's member tree
+const bundle = hub.getBundle('whistleblower-channel');
+// Generate Merkle proof (proves membership without revealing to others)
+const merkleProof = GumbaProof.createMerkleProof(
+  alice.dokoId,
+  bundle.memberTree
+);
+// The proof contains:
+// - type: MERKLE
+// - dokoId: (can be hidden for true ZK)
+// - proof: Merkle path to root
+// - timestamp</code></pre>
+        </div>
+        <!-- Step 2 -->
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3"><span class="step-number">2</span> Verify Merkle Proof</h3>
+          <p class="text-mountain-300 mb-4">Verify membership without knowing the full member list:</p>
+          <pre class="language-javascript"><code>// Verify the proof against the known root
+const verified = GumbaProof.verifyMerkleProof(
+  merkleProof,
+  bundle.memberTree.getRoot()
+);
+if (verified) {
+  console.log('Member verified via Merkle proof');
+  // Grant read access without logging identity
+}</code></pre>
+        </div>
+        <div class="warning-box">
+          <h4 class="font-bold mb-2"><svg class="doc-icon inline-icon" aria-hidden="true"><use href="#icon-warning"/></svg> Privacy Considerations</h4>
+          <p class="text-sm text-red-300 mb-2">
+            True zero-knowledge Merkle proofs require additional work:
+          </p>
+          <ul class="text-sm text-red-300 space-y-1">
+            <li>• The dokoId in the proof can reveal identity</li>
+            <li>• For full anonymity, use commitment schemes</li>
+            <li>• Consider timing attacks on proof generation</li>
+          </ul>
+        </div>
+      </section>
+      <!-- Tutorial 4: Member Management -->
+      <section id="tutorial-4" class="mb-16">
+        <h2 class="text-3xl font-bold mb-6 flex items-center gap-3">
+          <span class="text-4xl"><svg class="doc-icon hero-icon" width="24" height="24" aria-hidden="true"><use href="#icon-users"/></svg></span> Tutorial 4: Managing Members
+        </h2>
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3">Add, Promote, and Remove Members</h3>
+          <pre class="language-javascript"><code>const bundle = hub.getBundle('team-chat');
+const ownerDokoId = identity.identity.dokoId;
+// Add a new member
+bundle.addMember('doko-eve-new123', GUMBA_ROLE.READER, ownerDokoId);
+// Members can be added with different roles
+// (subject to the adder's own role level)
+// Remove a member
+bundle.removeMember('doko-eve-new123', ownerDokoId);
+// Note: Owner cannot be removed!
+// This will throw an error:
+// bundle.removeMember(ownerDokoId, ownerDokoId);  // Error!
+// Check membership
+if (bundle.memberTree.isMember('doko-alice-abc123')) {
+  const role = bundle.memberTree.getRole('doko-alice-abc123');
+  console.log('Alice is a member with role:', role);
+}
+// List all members
+const members = bundle.memberTree.getMembers();
+console.log('All members:', members);</code></pre>
+        </div>
+      </section>
+      <!-- Complete Example -->
+      <section id="complete-example" class="mb-16">
+        <h2 class="text-3xl font-bold mb-6 flex items-center gap-3">
+          <span class="text-4xl"><svg class="doc-icon hero-icon" width="24" height="24" aria-hidden="true"><use href="#icon-target"/></svg></span> Complete Example
+        </h2>
+        <div class="tutorial-card">
+          <h3 class="text-xl font-bold mb-3">Full Chat Room Implementation</h3>
+          <pre class="language-javascript"><code>import { GumbaHub, GumbaProof, GUMBA_ROLE } from 'yakmesh/mesh/gumba.js';
+import { loadIdentity } from 'yakmesh/mesh/identity.js';
+async function createPrivateChatRoom() {
+  // 1. Load identity and create hub
+  const identity = await loadIdentity();
+  const hub = new GumbaHub(identity, null);
+  // 2. Create the chat room
+  hub.createBundle('private-chat', {
+    name: 'Private Chat',
+  });
+  const bundle = hub.getBundle('private-chat');
+  const ownerDokoId = identity.identity.dokoId;
+  // 3. Add initial members (you'd get these from somewhere)
+  const members = [
+    { dokoId: 'doko-alice-123', role: GUMBA_ROLE.ADMIN, publicKey: '...' },
+    { dokoId: 'doko-bob-456', role: GUMBA_ROLE.MEMBER, publicKey: '...' },
+  ];
+  members.forEach(m => {
+    bundle.addMember(m.dokoId, m.role, ownerDokoId);
+    hub.registerPublicKey(m.dokoId, m.publicKey);
+  });
+  // 4. Add welcome message
+  bundle.addMessage({ text: 'Welcome to the chat!' }, ownerDokoId);
+  // 5. Handle incoming access requests
+  async function handleAccessRequest(visitorDokoId, signedProof, visitorNodeId) {
+    // Verify and grant access
+    const result = await hub.handleAccessRequest(
+      'private-chat',
+      signedProof,
+      visitorNodeId
+    );
+    if (result.granted) {
+      // Send session token to visitor
+      return {
+        success: true,
+        sessionId: result.sessionId,
+        role: result.role,
+      };
+    } else {
+      return {
+        success: false,
+        reason: result.reason,
+      };
+    }
+  }
+  // 6. Handle message requests
+  async function handleGetMessages(sessionId, options = {}) {
+    return await hub.getMessages(sessionId, options);
+  }
+  async function handlePostMessage(sessionId, content) {
+    return await hub.postMessage(sessionId, content);
+  }
+  return {
+    hub,
+    bundle,
+    handleAccessRequest,
+    handleGetMessages,
+    handlePostMessage,
+  };
+}
+// Usage
+const chatRoom = await createPrivateChatRoom();
+console.log('Chat room ready!');</code></pre>
+        </div>
+      </section>
+      <!-- Navigation -->
+      <div class="mt-16 pt-8 border-t border-mountain-700">
+        <div class="flex flex-col sm:flex-row gap-4">
+          <a href="gumba.html" class="flex-1 block bg-mountain-800 border border-mountain-700 rounded-xl p-4 hover:border-amber-500 transition group">
+            <div class="text-xs text-mountain-400 mb-1">← Reference</div>
+            <div class="flex items-center gap-2">
+              <span class="text-xl"><svg class="doc-icon card-icon" width="24" height="24" aria-hidden="true"><use href="#icon-stupa"/></svg></span>
+              <span class="font-semibold group-hover:text-amber-400">GUMBA Documentation</span>
+            </div>
+            <p class="text-mountain-400 text-sm mt-1">Full API reference and concepts</p>
+          </a>
+          <a href="tutorials.html" class="flex-1 block bg-mountain-800 border border-amber-700 rounded-xl p-4 hover:border-amber-500 transition group">
+            <div class="text-xs text-mountain-400 mb-1">More Tutorials →</div>
+            <div class="flex items-center gap-2">
+              <span class="text-xl"><svg class="doc-icon card-icon" width="24" height="24" aria-hidden="true"><use href="#icon-book"/></svg></span>
+              <span class="font-semibold group-hover:text-amber-400">All Tutorials</span>
+            </div>
+            <p class="text-mountain-400 text-sm mt-1">Explore other YAKMESH tutorials</p>
+          </a>
+        </div>
+      </div>
+    </div>
+  </main>
+  <footer class="docs-footer">
+    <p>&copy; 2026 YAKMESH™</p>
+  </footer>
+  <script src="prism.min.js" defer></script>
+  <script src="prism-javascript.min.js" defer></script>
+  <script src="docs.js" defer></script>
+</body>
+</html>