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/time-sources.html ADDED Viewed

@@ -0,0 +1,1392 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="time-sources">
+<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>Precision Time Sources | YAKMESH Documentation</title>
+    <meta name="description" content="YAKMESH precision time synchronization. Quantum, atomic, GPS, PTP, and NTP time sources for ultra-accurate mesh 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: #fbbf24; }
+        .theme-accent-hover:hover { color: #fcd34d; }
+        .theme-badge { background: rgba(251, 191, 36, 0.2); color: #fcd34d; }
+        .theme-border { border-color: #fbbf24; }
+        .theme-callout { background: rgba(251, 191, 36, 0.1); border-color: #f59e0b; }
+        .active-link { background: rgba(251, 191, 36, 0.2) !important; color: #fcd34d !important; }
+        .trust-table { width: 100%; border-collapse: collapse; }
+        .trust-table th, .trust-table td { padding: 0.75rem; text-align: left; border-bottom: 1px solid #2e4c43; }
+        .trust-table th { color: #fbbf24; font-weight: 600; background: rgba(251, 191, 36, 0.1); }
+        .trust-table code { background: #1f332d; padding: 0.25rem 0.5rem; border-radius: 4px; color: #fcd34d; }
+        .trust-level-quantum { background: linear-gradient(135deg, rgba(139, 92, 246, 0.3), rgba(236, 72, 153, 0.2)); border-left: 4px solid #a855f7; }
+        .trust-level-atomic { background: linear-gradient(135deg, rgba(251, 191, 36, 0.3), rgba(245, 158, 11, 0.2)); border-left: 4px solid #fbbf24; }
+        .trust-level-gps { background: linear-gradient(135deg, rgba(34, 197, 94, 0.3), rgba(22, 163, 74, 0.2)); border-left: 4px solid #22c55e; }
+        .trust-level-ptp { background: linear-gradient(135deg, rgba(59, 130, 246, 0.3), rgba(37, 99, 235, 0.2)); border-left: 4px solid #3b82f6; }
+        .trust-level-ntp { background: linear-gradient(135deg, rgba(156, 163, 175, 0.3), rgba(107, 114, 128, 0.2)); border-left: 4px solid #9ca3af; }
+        .trust-level-unsync { background: linear-gradient(135deg, rgba(239, 68, 68, 0.3), rgba(220, 38, 38, 0.2)); border-left: 4px solid #ef4444; }
+        .device-path { font-family: monospace; background: #0d1117; padding: 0.25rem 0.5rem; border-radius: 4px; font-size: 0.875rem; }
+    </style>
+    <!-- Open Graph -->
+    <meta property="og:type" content="article">
+    <meta property="og:site_name" content="Yakmesh Documentation">
+    <meta property="og:title" content="Time Sources — Yakmesh">
+    <meta property="og:description" content="Precision time synchronization — GPS, NTP, and satellite time source integration.">
+</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" class="active"><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-mani"/></svg>
+                <div>
+                    <div class="flex items-center gap-3">
+                        <h1 class="text-4xl font-bold">Precision Time Sources</h1>
+                        <span class="theme-badge text-xs px-2 py-1 rounded-full font-mono">v2.0.0</span>
+                    </div>
+                    <p class="theme-accent">Sub-millisecond synchronization for mesh coordination</p>
+                </div>
+            </div>
+            <p class="text-xl text-mountain-300 mb-8">
+                YAKMESH integrates with quantum, atomic, GPS, PTP, and NTP time sources to enable precision-grade
+                phase synchronization across the mesh network.
+            </p>
+            <!-- Overview Callout -->
+            <div class="theme-callout rounded-xl p-6 mb-8 border">
+                <p class="font-semibold mb-2 theme-accent"><svg class="doc-icon inline-icon" width="24" height="24" aria-hidden="true"><use href="#icon-target"/></svg> Why Precision Time Matters</p>
+                <p class="text-mountain-300 text-sm mb-4">
+                    YAKMESH uses <strong>phase epochs</strong> to coordinate network consensus. Higher-precision time sources
+                    enable tighter phase windows, reducing attack surfaces and improving network synchronization.
+                </p>
+                <ul class="text-mountain-400 text-sm space-y-1">
+                    <li>• Atomic-tier nodes can serve as <strong>time oracles</strong> for the network</li>
+                    <li>• GPS/PTP nodes can validate tight phase windows</li>
+                    <li>• NTP nodes still participate but with wider tolerance margins</li>
+                </ul>
+            </div>
+            <!-- Trust Levels Section -->
+            <h2 class="text-2xl font-bold mb-4" id="trust-levels">Trust Levels</h2>
+            <p class="text-mountain-300 mb-6">
+                Time sources are classified into trust levels based on their precision and reliability.
+                Higher trust levels enable tighter phase tolerances for consensus operations.
+            </p>
+            <!-- Trust Level Cards -->
+            <div class="space-y-4 mb-8">
+                <!-- QUANTUM -->
+                <div class="trust-level-quantum rounded-xl p-5">
+                    <div class="flex items-center justify-between mb-3">
+                        <div class="flex items-center gap-3">
+                            <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-lama"/></svg>
+                            <div>
+                                <h3 class="text-xl font-bold text-purple-300">QUANTUM</h3>
+                                <span class="text-sm text-purple-400">Level 5 • Stratum 0</span>
+                            </div>
+                        </div>
+                        <div class="text-right">
+                            <div class="text-2xl font-mono text-purple-300">±1ms</div>
+                            <div class="text-xs text-purple-400">tolerance</div>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Quantum optical network time sources including White Rabbit PTP (WR-PTP),
+                        optical atomic references, and entanglement-based synchronization. Sub-nanosecond capable.
+                    </p>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-purple-900/50 text-purple-300 px-2 py-1 rounded">WR-PTP</span>
+                        <span class="text-xs bg-purple-900/50 text-purple-300 px-2 py-1 rounded">Optical Atomic</span>
+                        <span class="text-xs bg-purple-900/50 text-purple-300 px-2 py-1 rounded">Entanglement Sync</span>
+                    </div>
+                </div>
+                <!-- ATOMIC -->
+                <div class="trust-level-atomic rounded-xl p-5">
+                    <div class="flex items-center justify-between mb-3">
+                        <div class="flex items-center gap-3">
+                            <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-tattva"/></svg>
+                            <div>
+                                <h3 class="text-xl font-bold text-yellow-300">ATOMIC</h3>
+                                <span class="text-sm text-yellow-400">Level 4 • Stratum 0</span>
+                            </div>
+                        </div>
+                        <div class="text-right">
+                            <div class="text-2xl font-mono text-yellow-300">±100ms</div>
+                            <div class="text-xs text-yellow-400">tolerance</div>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        PCIe atomic clocks including Chip-Scale Atomic Clocks (CSAC) and Rubidium oscillators.
+                        Reference-grade timing for infrastructure nodes.
+                    </p>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-yellow-900/50 text-yellow-300 px-2 py-1 rounded">PCIe CSAC</span>
+                        <span class="text-xs bg-yellow-900/50 text-yellow-300 px-2 py-1 rounded">Rubidium</span>
+                        <span class="text-xs bg-yellow-900/50 text-yellow-300 px-2 py-1 rounded">SA.45s</span>
+                        <span class="text-xs bg-yellow-900/50 text-yellow-300 px-2 py-1 rounded">Caesium</span>
+                    </div>
+                </div>
+                <!-- GPS -->
+                <div class="trust-level-gps rounded-xl p-5">
+                    <div class="flex items-center justify-between mb-3">
+                        <div class="flex items-center gap-3">
+                            <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-satellite"/></svg>
+                            <div>
+                                <h3 class="text-xl font-bold text-green-300">GPS</h3>
+                                <span class="text-sm text-green-400">Level 3 • Stratum 1</span>
+                            </div>
+                        </div>
+                        <div class="text-right">
+                            <div class="text-2xl font-mono text-green-300">±500ms</div>
+                            <div class="text-xs text-green-400">tolerance</div>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Hardware GPS receivers with PPS (Pulse-Per-Second) signal output.
+                        Provides globally synchronized timing from satellite constellation.
+                    </p>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-green-900/50 text-green-300 px-2 py-1 rounded">PPS Signal</span>
+                        <span class="text-xs bg-green-900/50 text-green-300 px-2 py-1 rounded">gpsd</span>
+                        <span class="text-xs bg-green-900/50 text-green-300 px-2 py-1 rounded">u-blox</span>
+                        <span class="text-xs bg-green-900/50 text-green-300 px-2 py-1 rounded">Trimble</span>
+                    </div>
+                </div>
+                <!-- PTP -->
+                <div class="trust-level-ptp rounded-xl p-5">
+                    <div class="flex items-center justify-between mb-3">
+                        <div class="flex items-center gap-3">
+                            <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-link"/></svg>
+                            <div>
+                                <h3 class="text-xl font-bold text-blue-300">PTP</h3>
+                                <span class="text-sm text-blue-400">Level 2 • Stratum 1</span>
+                            </div>
+                        </div>
+                        <div class="text-right">
+                            <div class="text-2xl font-mono text-blue-300">±500ms</div>
+                            <div class="text-xs text-blue-400">tolerance</div>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        IEEE 1588 Precision Time Protocol with hardware timestamping.
+                        Network-based synchronization for data center and enterprise deployments.
+                    </p>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-blue-900/50 text-blue-300 px-2 py-1 rounded">IEEE 1588</span>
+                        <span class="text-xs bg-blue-900/50 text-blue-300 px-2 py-1 rounded">ptp4l</span>
+                        <span class="text-xs bg-blue-900/50 text-blue-300 px-2 py-1 rounded">phc2sys</span>
+                        <span class="text-xs bg-blue-900/50 text-blue-300 px-2 py-1 rounded">Meinberg</span>
+                    </div>
+                </div>
+                <!-- NTP -->
+                <div class="trust-level-ntp rounded-xl p-5">
+                    <div class="flex items-center justify-between mb-3">
+                        <div class="flex items-center gap-3">
+                            <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-globe"/></svg>
+                            <div>
+                                <h3 class="text-xl font-bold text-gray-300">NTP</h3>
+                                <span class="text-sm text-gray-400">Level 1 • Stratum 2</span>
+                            </div>
+                        </div>
+                        <div class="text-right">
+                            <div class="text-2xl font-mono text-gray-300">±5000ms</div>
+                            <div class="text-xs text-gray-400">tolerance</div>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        Standard Network Time Protocol synchronization.
+                        Universal fallback available on all network-connected systems.
+                    </p>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-gray-800/50 text-gray-300 px-2 py-1 rounded">chrony</span>
+                        <span class="text-xs bg-gray-800/50 text-gray-300 px-2 py-1 rounded">ntpd</span>
+                        <span class="text-xs bg-gray-800/50 text-gray-300 px-2 py-1 rounded">systemd-timesyncd</span>
+                        <span class="text-xs bg-gray-800/50 text-gray-300 px-2 py-1 rounded">w32tm</span>
+                    </div>
+                </div>
+                <!-- UNSYNC -->
+                <div class="trust-level-unsync rounded-xl p-5">
+                    <div class="flex items-center justify-between mb-3">
+                        <div class="flex items-center gap-3">
+                            <svg class="doc-icon card-icon" aria-hidden="true"><use href="#icon-warning"/></svg>
+                            <div>
+                                <h3 class="text-xl font-bold text-red-300">UNSYNC</h3>
+                                <span class="text-sm text-red-400">Level 0 • Stratum 16</span>
+                            </div>
+                        </div>
+                        <div class="text-right">
+                            <div class="text-2xl font-mono text-red-300">±30000ms</div>
+                            <div class="text-xs text-red-400">tolerance</div>
+                        </div>
+                    </div>
+                    <p class="text-mountain-300 text-sm mb-3">
+                        No reliable time source available. Degraded mode with wide tolerance.
+                        Node cannot participate in time-critical consensus operations.
+                    </p>
+                    <div class="flex flex-wrap gap-2">
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Degraded Mode</span>
+                        <span class="text-xs bg-red-900/50 text-red-300 px-2 py-1 rounded">Local Clock Only</span>
+                    </div>
+                </div>
+            </div>
+            <!-- Trust Levels Table -->
+            <h3 class="text-xl font-bold mb-4">Quick Reference Table</h3>
+            <div class="overflow-x-auto mb-8">
+                <table class="trust-table rounded-lg overflow-hidden">
+                    <thead>
+                        <tr>
+                            <th>Trust Level</th>
+                            <th>Rank</th>
+                            <th>Stratum</th>
+                            <th>Tolerance</th>
+                            <th>Epoch Duration</th>
+                            <th>Grace Period</th>
+                            <th>Use Case</th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        <tr>
+                            <td><code>QUANTUM</code></td>
+                            <td>5</td>
+                            <td>0</td>
+                            <td>±1ms</td>
+                            <td>1 hour</td>
+                            <td>1 min</td>
+                            <td>Research labs, quantum networks</td>
+                        </tr>
+                        <tr>
+                            <td><code>ATOMIC</code></td>
+                            <td>4</td>
+                            <td>0</td>
+                            <td>±100ms</td>
+                            <td>1 hour</td>
+                            <td>1 min</td>
+                            <td>Time oracles, infrastructure nodes</td>
+                        </tr>
+                        <tr>
+                            <td><code>GPS</code></td>
+                            <td>3</td>
+                            <td>1</td>
+                            <td>±500ms</td>
+                            <td>2 hours</td>
+                            <td>5 min</td>
+                            <td>Edge nodes, outdoor deployments</td>
+                        </tr>
+                        <tr>
+                            <td><code>PTP</code></td>
+                            <td>2</td>
+                            <td>1</td>
+                            <td>±500ms</td>
+                            <td>2 hours</td>
+                            <td>5 min</td>
+                            <td>Data centers, enterprise networks</td>
+                        </tr>
+                        <tr>
+                            <td><code>NTP</code></td>
+                            <td>1</td>
+                            <td>2</td>
+                            <td>±5000ms</td>
+                            <td>6 hours</td>
+                            <td>15 min</td>
+                            <td>Standard nodes, home users</td>
+                        </tr>
+                        <tr>
+                            <td><code>UNSYNC</code></td>
+                            <td>0</td>
+                            <td>16</td>
+                            <td>±30000ms</td>
+                            <td>12 hours</td>
+                            <td>30 min</td>
+                            <td>Degraded mode, offline operation</td>
+                        </tr>
+                    </tbody>
+                </table>
+            </div>
+            <!-- TimeSourceDetector Section -->
+            <h2 class="text-2xl font-bold mb-4" id="time-source-detector">TimeSourceDetector Class</h2>
+            <p class="text-mountain-300 mb-6">
+                The <code class="bg-mountain-800 px-2 py-1 rounded theme-accent">TimeSourceDetector</code> class
+                automatically detects available time sources and selects the highest-quality option.
+            </p>
+            <h3 class="text-xl font-bold mb-3">Basic Usage</h3>
+            <pre class="language-javascript mb-6"><code>import {
+  TimeSourceDetector,
+  TimeTrustLevel,
+  PhaseTolerance
+} from './oracle/time-source.js';
+// Create detector with hardware detection enabled
+const detector = new TimeSourceDetector({
+  detectHardware: true,
+  checkNtp: true,
+  refreshInterval: 60000, // Re-check every minute
+  verbose: true
+});
+// Start continuous monitoring
+detector.start();
+// Get detection results
+const results = detector.detect();
+console.log('Primary source:', results.primarySource);
+console.log('Trust level:', results.trustLevel);
+console.log('Phase tolerance:', results.phaseTolerance, 'ms');</code></pre>
+            <h3 class="text-xl font-bold mb-3">Constructor Options</h3>
+            <div class="overflow-x-auto mb-6">
+                <table class="trust-table rounded-lg overflow-hidden">
+                    <thead>
+                        <tr>
+                            <th>Option</th>
+                            <th>Type</th>
+                            <th>Default</th>
+                            <th>Description</th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        <tr>
+                            <td><code>detectHardware</code></td>
+                            <td>boolean</td>
+                            <td><code>true</code></td>
+                            <td>Enable detection of atomic clocks, GPS, and PTP devices</td>
+                        </tr>
+                        <tr>
+                            <td><code>checkNtp</code></td>
+                            <td>boolean</td>
+                            <td><code>true</code></td>
+                            <td>Check NTP/Chrony synchronization status</td>
+                        </tr>
+                        <tr>
+                            <td><code>customDevices</code></td>
+                            <td>object</td>
+                            <td><code>{}</code></td>
+                            <td>Custom device paths for detection</td>
+                        </tr>
+                        <tr>
+                            <td><code>refreshInterval</code></td>
+                            <td>number</td>
+                            <td><code>60000</code></td>
+                            <td>Refresh interval in milliseconds (0 to disable)</td>
+                        </tr>
+                        <tr>
+                            <td><code>verbose</code></td>
+                            <td>boolean</td>
+                            <td><code>false</code></td>
+                            <td>Enable verbose logging of detection results</td>
+                        </tr>
+                    </tbody>
+                </table>
+            </div>
+            <h3 class="text-xl font-bold mb-3">Key Methods</h3>
+            <pre class="language-javascript mb-6"><code>// Start continuous monitoring
+detector.start();
+// Stop monitoring
+detector.stop();
+// Manual detection
+const results = detector.detect();
+// Get current trust level
+const trust = detector.getTrustLevel(); // 'atomic', 'gps', 'ntp', etc.
+// Get phase tolerance in milliseconds
+const tolerance = detector.getPhaseTolerance(); // e.g., 100
+// Get NTP stratum equivalent
+const stratum = detector.getStratum(); // e.g., 0, 1, 2, 16
+// Check if atomic-tier time is available
+if (detector.hasAtomicTime()) {
+  console.log('Node can serve as time oracle');
+}
+// Check if high-precision time is available (atomic, GPS, or PTP)
+if (detector.hasHighPrecisionTime()) {
+  console.log('Node can validate tight phase windows');
+}
+// Get full status object for API responses
+const status = detector.getStatus();</code></pre>
+            <h3 class="text-xl font-bold mb-3">Event Handling</h3>
+            <pre class="language-javascript mb-8"><code>// Listen for detection events
+detector.on('detected', (results) => {
+  console.log('Time sources detected:', results);
+  console.log('Primary:', results.primarySource);
+  console.log('Trust:', results.trustLevel);
+  console.log('Tolerance:', results.phaseTolerance, 'ms');
+});</code></pre>
+            <!-- Device Paths Section -->
+            <h2 class="text-2xl font-bold mb-4" id="device-paths">Device Paths</h2>
+            <p class="text-mountain-300 mb-6">
+                The detector checks platform-specific device paths for hardware time sources.
+            </p>
+            <h3 class="text-xl font-bold mb-3">Linux</h3>
+            <div class="bg-mountain-800 rounded-lg p-4 mb-6">
+                <div class="grid gap-3">
+                    <div>
+                        <span class="text-mountain-400 text-sm">PPS Devices:</span>
+                        <div class="flex flex-wrap gap-2 mt-1">
+                            <span class="device-path text-green-400">/dev/pps0</span>
+                            <span class="device-path text-green-400">/dev/pps1</span>
+                            <span class="device-path text-green-400">/dev/pps2</span>
+                        </div>
+                    </div>
+                    <div>
+                        <span class="text-mountain-400 text-sm">PTP Devices:</span>
+                        <div class="flex flex-wrap gap-2 mt-1">
+                            <span class="device-path text-blue-400">/dev/ptp0</span>
+                            <span class="device-path text-blue-400">/dev/ptp1</span>
+                            <span class="device-path text-blue-400">/dev/ptp2</span>
+                        </div>
+                    </div>
+                    <div>
+                        <span class="text-mountain-400 text-sm">GPS Devices:</span>
+                        <div class="flex flex-wrap gap-2 mt-1">
+                            <span class="device-path text-yellow-400">/dev/ttyUSB0</span>
+                            <span class="device-path text-yellow-400">/dev/ttyACM0</span>
+                            <span class="device-path text-yellow-400">/dev/gps0</span>
+                        </div>
+                    </div>
+                    <div>
+                        <span class="text-mountain-400 text-sm">Chrony Socket:</span>
+                        <div class="flex flex-wrap gap-2 mt-1">
+                            <span class="device-path text-gray-400">/var/run/chrony/chronyd.sock</span>
+                        </div>
+                    </div>
+                </div>
+            </div>
+            <h3 class="text-xl font-bold mb-3">Windows</h3>
+            <div class="bg-mountain-800 rounded-lg p-4 mb-6">
+                <div class="grid gap-3">
+                    <div>
+                        <span class="text-mountain-400 text-sm">Time Service:</span>
+                        <div class="flex flex-wrap gap-2 mt-1">
+                            <span class="device-path text-gray-400">w32tm</span>
+                        </div>
+                    </div>
+                    <div>
+                        <span class="text-mountain-400 text-sm">PTP:</span>
+                        <span class="text-mountain-500 text-sm ml-2">Requires vendor-specific drivers (Meinberg, etc.)</span>
+                    </div>
+                </div>
+            </div>
+            <h3 class="text-xl font-bold mb-3">macOS (Darwin)</h3>
+            <div class="bg-mountain-800 rounded-lg p-4 mb-8">
+                <div class="grid gap-3">
+                    <div>
+                        <span class="text-mountain-400 text-sm">PPS Devices:</span>
+                        <div class="flex flex-wrap gap-2 mt-1">
+                            <span class="device-path text-green-400">/dev/pps0</span>
+                        </div>
+                    </div>
+                    <div>
+                        <span class="text-mountain-400 text-sm">PTP Devices:</span>
+                        <div class="flex flex-wrap gap-2 mt-1">
+                            <span class="device-path text-blue-400">/dev/ptp0</span>
+                        </div>
+                    </div>
+                    <div>
+                        <span class="text-mountain-400 text-sm">GPS Devices:</span>
+                        <div class="flex flex-wrap gap-2 mt-1">
+                            <span class="device-path text-yellow-400">/dev/cu.usbserial*</span>
+                        </div>
+                    </div>
+                </div>
+            </div>
+            <!-- Detection Methods Section -->
+            <h2 class="text-2xl font-bold mb-4" id="detection-methods">Detection Methods</h2>
+            <h3 class="text-xl font-bold mb-3">Atomic Clock Detection</h3>
+            <p class="text-mountain-300 mb-4">
+                The detector identifies atomic clocks through multiple methods:
+            </p>
+            <ul class="list-disc list-inside text-mountain-300 space-y-2 mb-6">
+                <li>Chrony sources reporting <code class="theme-accent">PPS</code> or <code class="theme-accent">ATOM</code> references</li>
+                <li>PPS device names containing: <code class="theme-accent">atomic</code>, <code class="theme-accent">csac</code>, <code class="theme-accent">rubidium</code>, <code class="theme-accent">caesium</code>, <code class="theme-accent">sa.45</code></li>
+                <li>PCIe devices via <code class="theme-accent">lspci</code> matching time/clock/atomic keywords</li>
+                <li>Windows: Jackson Labs CSAC driver processes</li>
+            </ul>
+            <h3 class="text-xl font-bold mb-3">GPS Detection</h3>
+            <p class="text-mountain-300 mb-4">
+                GPS receivers are detected via:
+            </p>
+            <ul class="list-disc list-inside text-mountain-300 space-y-2 mb-6">
+                <li><code class="theme-accent">gpsd</code> service status and <code class="theme-accent">gpspipe</code> output</li>
+                <li>Serial devices at standard GPS paths</li>
+                <li>Associated PPS devices for high-precision timing</li>
+                <li>Chrony sources with GPS references</li>
+            </ul>
+            <h3 class="text-xl font-bold mb-3">PTP Detection</h3>
+            <p class="text-mountain-300 mb-4">
+                IEEE 1588 PTP synchronization is detected through:
+            </p>
+            <ul class="list-disc list-inside text-mountain-300 space-y-2 mb-6">
+                <li>PTP hardware devices at <code class="theme-accent">/dev/ptpN</code></li>
+                <li><code class="theme-accent">ptp4l</code> service with <code class="theme-accent">pmc</code> queries for offset</li>
+                <li><code class="theme-accent">phc2sys</code> process for PTP-to-system clock sync</li>
+                <li>Meinberg PTP hardware (PTP270PEX) via <code class="theme-accent">lspci</code> and <code class="theme-accent">mbgstatus</code></li>
+            </ul>
+            <h3 class="text-xl font-bold mb-3">NTP Detection</h3>
+            <p class="text-mountain-300 mb-4">
+                NTP status is checked via:
+            </p>
+            <ul class="list-disc list-inside text-mountain-300 space-y-2 mb-8">
+                <li><strong>Chrony:</strong> <code class="theme-accent">chronyc tracking</code> for stratum, offset, and server</li>
+                <li><strong>systemd-timesyncd:</strong> <code class="theme-accent">timedatectl show</code></li>
+                <li><strong>ntpd:</strong> <code class="theme-accent">ntpq -p</code> for selected source</li>
+                <li><strong>Windows:</strong> <code class="theme-accent">w32tm /query /status</code></li>
+                <li><strong>macOS:</strong> <code class="theme-accent">sntp</code> queries</li>
+            </ul>
+            <!-- Phase Configuration Section -->
+            <h2 class="text-2xl font-bold mb-4" id="phase-config">Phase Configuration</h2>
+            <p class="text-mountain-300 mb-6">
+                Use <code class="bg-mountain-800 px-2 py-1 rounded theme-accent">createPhaseConfig()</code> to generate
+                phase epoch configuration based on detected time source quality.
+            </p>
+            <pre class="language-javascript mb-6"><code>import {
+  TimeSourceDetector,
+  createPhaseConfig
+} from './oracle/time-source.js';
+const detector = new TimeSourceDetector({ detectHardware: true });
+detector.detect();
+const phaseConfig = createPhaseConfig(detector);
+console.log(phaseConfig);
+// {
+//   trustLevel: 'atomic',
+//   toleranceMs: 100,
+//   epochDurationHours: 1,
+//   gracePeriodMinutes: 1,
+//   capabilities: {
+//     canBeTimeOracle: true,
+//     canValidateTightPhase: true,
+//     canParticipateInConsensus: true
+//   }
+// }</code></pre>
+            <h3 class="text-xl font-bold mb-3">Capabilities by Trust Level</h3>
+            <div class="overflow-x-auto mb-8">
+                <table class="trust-table rounded-lg overflow-hidden">
+                    <thead>
+                        <tr>
+                            <th>Capability</th>
+                            <th>QUANTUM</th>
+                            <th>ATOMIC</th>
+                            <th>GPS</th>
+                            <th>PTP</th>
+                            <th>NTP</th>
+                            <th>UNSYNC</th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        <tr>
+                            <td>Can be Time Oracle</td>
+                            <td class="text-green-400">✓</td>
+                            <td class="text-green-400">✓</td>
+                            <td class="text-red-400">✗</td>
+                            <td class="text-red-400">✗</td>
+                            <td class="text-red-400">✗</td>
+                            <td class="text-red-400">✗</td>
+                        </tr>
+                        <tr>
+                            <td>Validate Tight Phase</td>
+                            <td class="text-green-400">✓</td>
+                            <td class="text-green-400">✓</td>
+                            <td class="text-green-400">✓</td>
+                            <td class="text-red-400">✗</td>
+                            <td class="text-red-400">✗</td>
+                            <td class="text-red-400">✗</td>
+                        </tr>
+                        <tr>
+                            <td>Participate in Consensus</td>
+                            <td class="text-green-400">✓</td>
+                            <td class="text-green-400">✓</td>
+                            <td class="text-green-400">✓</td>
+                            <td class="text-green-400">✓</td>
+                            <td class="text-green-400">✓</td>
+                            <td class="text-red-400">✗</td>
+                        </tr>
+                    </tbody>
+                </table>
+            </div>
+            <!-- Constants Section -->
+            <h2 class="text-2xl font-bold mb-4" id="constants">Exported Constants</h2>
+            <h3 class="text-xl font-bold mb-3">TimeTrustLevel</h3>
+            <pre class="language-javascript mb-6"><code>export const TimeTrustLevel = {
+  QUANTUM: 'quantum',   // Quantum optical network (WR-PTP, optical atomic)
+  ATOMIC: 'atomic',     // PCIe atomic clock (CSAC, Rubidium)
+  GPS: 'gps',           // GPS with PPS signal
+  PTP: 'ptp',           // IEEE 1588 PTP synchronized
+  NTP: 'ntp',           // Standard NTP
+  UNSYNC: 'unsync',     // No reliable time source
+};</code></pre>
+            <h3 class="text-xl font-bold mb-3">PhaseTolerance</h3>
+            <pre class="language-javascript mb-6"><code>export const PhaseTolerance = {
+  [TimeTrustLevel.QUANTUM]: 1,       // ±1ms for quantum (sub-nanosecond capable)
+  [TimeTrustLevel.ATOMIC]: 100,      // ±100ms for atomic
+  [TimeTrustLevel.GPS]: 500,         // ±500ms for GPS
+  [TimeTrustLevel.PTP]: 500,         // ±500ms for PTP
+  [TimeTrustLevel.NTP]: 5000,        // ±5 seconds for NTP
+  [TimeTrustLevel.UNSYNC]: 30000,    // ±30 seconds for unsync (degraded mode)
+};</code></pre>
+            <h3 class="text-xl font-bold mb-3">StratumLevel</h3>
+            <pre class="language-javascript mb-8"><code>export const StratumLevel = {
+  [TimeTrustLevel.QUANTUM]: 0, // Quantum reference (highest)
+  [TimeTrustLevel.ATOMIC]: 0,  // Reference clock
+  [TimeTrustLevel.GPS]: 1,     // Primary server
+  [TimeTrustLevel.PTP]: 1,     // Primary server
+  [TimeTrustLevel.NTP]: 2,     // Secondary server
+  [TimeTrustLevel.UNSYNC]: 16, // Unsynchronized
+};</code></pre>
+            <!-- Helper Functions Section -->
+            <h2 class="text-2xl font-bold mb-4" id="helpers">Helper Functions</h2>
+            <h3 class="text-xl font-bold mb-3">Quick Detection</h3>
+            <pre class="language-javascript mb-6"><code>import { detectTimeSources } from './oracle/time-source.js';
+// One-shot detection without continuous monitoring
+const results = detectTimeSources();
+console.log('Detected:', results.primarySource, 'at', results.trustLevel);</code></pre>
+            <h3 class="text-xl font-bold mb-3">Singleton Instance</h3>
+            <pre class="language-javascript mb-8"><code>import { getTimeSourceDetector } from './oracle/time-source.js';
+// Get or create the global detector instance
+const detector = getTimeSourceDetector({ verbose: true });
+detector.start();
+// Subsequent calls return the same instance
+const sameDetector = getTimeSourceDetector();
+console.log(detector === sameDetector); // true</code></pre>
+            <!-- Next Steps -->
+            <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-tattva"/></svg>
+                        <a href="tattva.html" class="theme-accent theme-accent-hover">Oracle System</a>
+                        <span class="text-mountain-400 text-sm">— Network-wide time consensus</span>
+                    </li>
+                    <li class="flex items-center gap-2">
+                        <svg class="doc-icon inline-icon" aria-hidden="true"><use href="#icon-mandala"/></svg>
+                        <a href="mandala.html" class="theme-accent theme-accent-hover">MANDALA (Mesh)</a>
+                        <span class="text-mountain-400 text-sm">— Peer coordination and routing</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">— Phase-based trust validation</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">— Time source configuration options</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="mesh.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-mandala"/></svg>
+              <span class="font-semibold group-hover:text-theme-accent">Mesh Network</span>
+            </div>
+            <p class="text-mountain-400 text-sm mt-1">P2P mesh infrastructure</p>
+          </a>
+          <a href="webserver.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-server"/></svg>
+              <span class="font-semibold group-hover:text-theme-accent">Web Server</span>
+            </div>
+            <p class="text-mountain-400 text-sm mt-1">HTTP & WebSocket server</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>