yakmesh 2.5.0 → 2.6.0

package/README.md

@@ -134,19 +134,24 @@ yakmesh/
 
 ## Network Identity
 
-Each YAKMESH network has a unique identity derived from configurable salts:
+Each YAKMESH network has a unique identity derived from the **oracle's code hash** — a deterministic fingerprint of the codebase itself. This means the code IS the identity.
 
 ```javascript
-import { setIdentityConfig } from 'yakmesh/oracle/network-identity.js';
+// Network identity is AUTOMATIC - derived from code hash
+// When you run a node, it computes:
+// 1. Code hash → cryptographic identity of the codebase
+// 2. Network name → human-readable name (e.g., "factor-primitive-bose")
+// 3. Verification phrase → speakable phrase for verbal verification
 
-setIdentityConfig({
-  networkPrefix: 'my',           // Network ID prefix
-  identitySalt: 'my-app-v1',     // Unique network salt
-});
+// The identity functions are available for inspection:
+import { deriveNetworkName, deriveVerificationPhrase } from 'yakmesh/oracle/network-identity.js';
 
-// Different salt = different network (cannot interoperate)
+// Same code = same network. Different code = different network.
+// No configuration needed - the math handles network separation.
 ```
 
+**Key Principle:** Two nodes running the same YAKMESH version will automatically be on the same network. Fork the code or modify the oracle, and you're on a different network entirely.
+
 ## Time Source Trust Levels
 
 | Level | Source | Tolerance | Oracle Capable |

package/RELEASE_CHECKLIST.md

@@ -42,6 +42,11 @@ Get-ChildItem -Recurse -Filter "*.js" | Select-String -Pattern "ml_dsa65\.(sign|
 - [ ] **API documentation matches implementation** - Check function signatures
 - [ ] **CHANGELOG.md updated** - Version, date, and all changes documented
 - [ ] **Migration guide** (if breaking changes) - Clear upgrade path for users
+- [ ] **Docs bundle regenerated** - Run `npm run build:docs` before release
+  ```powershell
+  npm run build:docs
+  # Verify output shows correct file count and bundle hash
+  ```
 
 ### 5. Version Management
 
@@ -86,6 +91,7 @@ node -e "const yk = require('yakmesh-node'); console.log('Import successful')"
 | `oracle/module-sealer.js` | Module attestation | HIGH |
 | `mesh/nakpak-routing.js` | Packet signing | HIGH |
 | `identity/node-key.js` | Node authentication | HIGH |
+| `embedded-docs/bundle.js` | Documentation hashes | MEDIUM |
 
 ## Known Pitfalls
 

package/cli/index.js

@@ -823,6 +823,182 @@ geoCmd
     console.log('');
   });
 
+// ===== DOCS COMMAND GROUP =====
+const docsCmd = program
+  .command('docs')
+  .description('Embedded documentation management');
+
+// docs info - Show bundle information
+docsCmd
+  .command('info')
+  .description('Show documentation bundle information')
+  .action(async () => {
+    try {
+      const { getBundleInfo, BUNDLE_HASH, BUNDLE_VERSION } = await import('../embedded-docs/index.js');
+      const info = getBundleInfo();
+      
+      console.log(chalk.cyan('\n📦 YAKMESH Embedded Documentation Bundle\n'));
+      console.log(chalk.white('  Bundle Hash:'), chalk.yellow(BUNDLE_HASH));
+      console.log(chalk.white('  Version:    '), chalk.green(BUNDLE_VERSION));
+      console.log(chalk.white('  Files:      '), info.fileCount);
+      console.log(chalk.white('  Total Size: '), Math.round(info.totalSize / 1024) + ' KB');
+      console.log('');
+      console.log(chalk.gray('  Run "yakmesh docs verify" to verify bundle integrity.'));
+      console.log(chalk.gray('  Run "yakmesh docs list" to see all files.'));
+      console.log('');
+    } catch (err) {
+      console.error(chalk.red('✗ Error loading docs bundle:'), err.message);
+      process.exit(1);
+    }
+  });
+
+// docs verify - Verify bundle integrity
+docsCmd
+  .command('verify')
+  .description('Verify documentation bundle integrity using SHA3-256')
+  .option('-v, --verbose', 'Show individual file verification results')
+  .action(async (options) => {
+    try {
+      const { getBundleInfo, getDocsFile, verifyFile, BUNDLE_HASH } = await import('../embedded-docs/index.js');
+      const info = getBundleInfo();
+      
+      console.log(chalk.cyan('\n🔐 Verifying Documentation Bundle...\n'));
+      
+      let verified = 0;
+      let failed = 0;
+      
+      for (const filePath of info.files) {
+        const file = getDocsFile(filePath);
+        if (!file) {
+          if (options.verbose) {
+            console.log(chalk.red('  ✗'), filePath, chalk.gray('- FILE MISSING'));
+          }
+          failed++;
+          continue;
+        }
+        
+        const result = verifyFile(filePath, file.content);
+        if (result.valid) {
+          verified++;
+          if (options.verbose) {
+            console.log(chalk.green('  ✓'), filePath, chalk.gray(`(${file.content.length} bytes)`));
+          }
+        } else {
+          failed++;
+          if (options.verbose) {
+            console.log(chalk.red('  ✗'), filePath, chalk.gray('- HASH MISMATCH'));
+          }
+        }
+      }
+      
+      console.log('');
+      if (failed === 0) {
+        console.log(chalk.green('✓ Bundle verification PASSED'));
+        console.log(chalk.gray(`  ${verified} files verified`));
+        console.log(chalk.gray(`  Bundle: ${BUNDLE_HASH.substring(0, 32)}...`));
+      } else {
+        console.log(chalk.red('✗ Bundle verification FAILED'));
+        console.log(chalk.gray(`  ${verified} passed, ${failed} failed`));
+        process.exit(1);
+      }
+      console.log('');
+    } catch (err) {
+      console.error(chalk.red('✗ Error:'), err.message);
+      process.exit(1);
+    }
+  });
+
+// docs list - List all files in bundle
+docsCmd
+  .command('list')
+  .description('List all files in the documentation bundle')
+  .option('--html', 'Show only HTML files')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    try {
+      const { getBundleInfo, FILE_INDEX } = await import('../embedded-docs/index.js');
+      const info = getBundleInfo();
+      
+      let files = info.files;
+      if (options.html) {
+        files = files.filter(f => f.endsWith('.html'));
+      }
+      
+      if (options.json) {
+        console.log(JSON.stringify({ files, count: files.length }, null, 2));
+        return;
+      }
+      
+      console.log(chalk.cyan(`\n📄 Documentation Files (${files.length})\n`));
+      for (const file of files.sort()) {
+        const meta = FILE_INDEX[file];
+        const size = meta ? Math.round(meta.size / 1024) + ' KB' : '?';
+        console.log(chalk.gray('  -'), file, chalk.gray(`(${size})`));
+      }
+      console.log('');
+    } catch (err) {
+      console.error(chalk.red('✗ Error:'), err.message);
+      process.exit(1);
+    }
+  });
+
+// docs serve - Start documentation server
+docsCmd
+  .command('serve')
+  .description('Start a local documentation server')
+  .option('-p, --port <port>', 'Port to serve on', '8080')
+  .action(async (options) => {
+    try {
+      const express = (await import('express')).default;
+      const { serveDocsFile, getBundleInfo, BUNDLE_HASH } = await import('../embedded-docs/index.js');
+      
+      const app = express();
+      const port = parseInt(options.port);
+      
+      // Order matters! Specific routes first to avoid redirect loops
+      app.get('/docs/_bundle', (req, res) => res.json(getBundleInfo()));
+      app.get('/docs/index.html', (req, res) => serveDocsFile('index.html', res));
+      app.get('/docs/', (req, res) => serveDocsFile('index.html', res));
+      app.get('/docs', (req, res) => res.redirect('/docs/'));
+      app.get('/docs/:file', (req, res) => {
+        const file = req.params.file || 'index.html';
+        serveDocsFile(file, res);
+      });
+      
+      // Serve assets (silhouettes, etc.) - CSS references ../assets/ from /docs/
+      app.get('/assets/*', (req, res) => {
+        const assetPath = req.path.substring(1); // Remove leading /
+        serveDocsFile(assetPath, res);
+      });
+      
+      app.get('/', (req, res) => res.redirect('/docs/'));
+      
+      app.listen(port, '0.0.0.0', () => {
+        console.log(chalk.cyan('\n📦 YAKMESH Documentation Server\n'));
+        console.log(chalk.white('  URL:        '), chalk.green(`http://localhost:${port}/docs/`));
+        console.log(chalk.white('  Bundle:     '), chalk.gray(BUNDLE_HASH.substring(0, 24) + '...'));
+        console.log(chalk.white('  Files:      '), getBundleInfo().fileCount);
+        console.log('');
+        console.log(chalk.gray('  Press Ctrl+C to stop.'));
+        console.log('');
+      });
+    } catch (err) {
+      console.error(chalk.red('✗ Error:'), err.message);
+      process.exit(1);
+    }
+  });
+
+// docs rebuild - Rebuild the bundle (for developers)
+docsCmd
+  .command('rebuild')
+  .description('Rebuild documentation bundle (development only)')
+  .action(async () => {
+    console.log(chalk.cyan('\n📦 Rebuilding Documentation Bundle...\n'));
+    console.log(chalk.gray('  Run this command from the yakmesh-node directory:'));
+    console.log(chalk.white('  npm run build:docs'));
+    console.log('');
+  });
+
 // ===== VERSION =====
 program
   .version(VERSION)

package/embedded-docs/bundle.js

@@ -0,0 +1,339 @@
+/**
+ * YAKMESH Embedded Documentation Bundle
+ * 
+ * AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
+ * 
+ * Regenerate with: npm run build:docs
+ * Source: website/docs/
+ * 
+ * @generated 2026-02-01T03:15:20.104Z
+ * @module embedded-docs/bundle
+ */
+
+/**
+ * Master hash of the entire documentation bundle.
+ * Computed as: SHA3-256(sorted individual file hashes joined)
+ */
+export const BUNDLE_HASH = 'd431166e8bf0458df547a93d6d388b9599e8219ea76a322654a0f8342da4dae4';
+
+/**
+ * Version of the documentation bundle.
+ * Matches the npm package version at build time.
+ */
+export const BUNDLE_VERSION = '2.6.0';
+
+/**
+ * Build timestamp (ISO 8601)
+ */
+export const BUNDLE_BUILT_AT = '2026-02-01T03:15:20.104Z';
+
+/**
+ * Index of all files in the documentation bundle.
+ * 
+ * Each entry contains:
+ * - hash: SHA3-256 hash of the file content
+ * - size: File size in bytes
+ * - contentType: MIME type for HTTP serving
+ * 
+ * @type {Record<string, {hash: string, size: number, contentType: string}>}
+ */
+export const FILE_INDEX = {
+  "adapters.html": {
+    "hash": "a4725f50254405c2707ad6ba97727c03ae18746724a1f7425df4abd196a68de8",
+    "size": 11778,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "advanced-systems.html": {
+    "hash": "cd95be42f7a41f924a9595017fa9b3de6aa33e7da3a5003faf86db470852a3bd",
+    "size": 22922,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "annex.html": {
+    "hash": "49ac93e2e79a786760b006bb03d046f4968c6d7ed101fa893b3791f2301cd7c1",
+    "size": 28147,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "api.html": {
+    "hash": "38e59308cb3c16fddd71705651ada0846d0b26b50ddffee31302d685c257dfdb",
+    "size": 18875,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "cli.html": {
+    "hash": "236c17ee7e57d7b733e87f5dc1f1f4aee3754fd638e84db9539858cb2e7bb6e1",
+    "size": 38666,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "configuration.html": {
+    "hash": "c0fb9aca6c21f856db7d60721877ea9a100c3e71eef3e2661ae19f5151e9d292",
+    "size": 33144,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "docs-bundle.html": {
+    "hash": "f8c5b1d11bf509bef66e2469fc3aa30aea8154089c1c7a6bd36b27653aa048f5",
+    "size": 18787,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "docs.css": {
+    "hash": "a5cc0ed95d5405e0e3824055abf215e8bdb45a89eb8f714a19b22ffdda2d597d",
+    "size": 36002,
+    "contentType": "text/css; charset=utf-8"
+  },
+  "docs.js": {
+    "hash": "c29823d705194d455ec85f408de3ca2e81052414814f54711ba6a3b33e4f8e3d",
+    "size": 4434,
+    "contentType": "application/javascript; charset=utf-8"
+  },
+  "doko.html": {
+    "hash": "7d7eb43e93196612a5c85bb61d97922750f4214ff63ec06bb9e1d6fd775932ce",
+    "size": 20893,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "geo-proof.html": {
+    "hash": "33e0ec948fa10c85a2d8806bee6823708a75e8d4d1d363c25a954c470bb5ee5e",
+    "size": 15543,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "getting-started.html": {
+    "hash": "5dc03a8f417d306af232c1f20a35d6e5832640eee2e6af0737bcbabc38e238ea",
+    "size": 13401,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "index.html": {
+    "hash": "56a4148a1c594976e52bb3e17a175a3e8586aa92fa9bbac40c0ed096ef36c54a",
+    "size": 12944,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "karma.html": {
+    "hash": "a86ef77a6873b8f404df22f364ce017872b0d6039388cd3d42ae043a07f18860",
+    "size": 18123,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "lama.html": {
+    "hash": "20fc0c463049659771212eacc12a7d5def640ba75afecb3eb79565d7f917be7d",
+    "size": 16483,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "mandala.html": {
+    "hash": "50a667cc5d75450e67012b2ff7b81bc1c7012a312cd988b912d6d27ae26e4060",
+    "size": 19988,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "mani.html": {
+    "hash": "f0c4f8f6f65c68dc70d38d9790a3d62d7b048a0bb6b190d5e10a4e9a71f6653a",
+    "size": 15992,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "mantra.html": {
+    "hash": "76c3bff0a66c2d8d923dd3ddcb4f88c93ef9e390cd36de6f828c8da0da404302",
+    "size": 21140,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "mesh.html": {
+    "hash": "db779eaf76998f53cf29209b89613dc2571b1a4b19c8b8ae7d6ba0e7f57bf6a4",
+    "size": 46268,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "nakpak.html": {
+    "hash": "521bfd22b47a3876f25f1747ef46d30b155f7672e1f31546a9516c8d5e06f2f7",
+    "size": 16535,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "namche.html": {
+    "hash": "bb5070ab9f016ba2050c33743a1b8bee495852c3f743c0cb42fa60dadb52c7e0",
+    "size": 17615,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "privacy.html": {
+    "hash": "e274c5afe9c2188f7840bf78edbc0b45e03e537430cf237a5b7382567a1a623c",
+    "size": 8047,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "sherpa.html": {
+    "hash": "e5b97f5d68e8a89df4fa3358d50ea7340ff9fafe16b1e272d171320a0a2af202",
+    "size": 14989,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "stupa.html": {
+    "hash": "9c79a8984aab8b6e8d5b80170945030538b7ca6c4a41f9ed0ca6098f50551496",
+    "size": 16908,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "tattva.html": {
+    "hash": "e4dd2105547b6f1b93fcca0f2ac34e9bf6e561c4f0956db06680b96b40786a01",
+    "size": 40704,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "terms.html": {
+    "hash": "80e8639dd57ce83e3b9419c3eff222c2cd4fa08c2e8521ad5430f065a2d52e12",
+    "size": 7100,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "time-sources.html": {
+    "hash": "90e9c5cd635d1b71010e87e0ea246bbacf188aad56351670b5004c691d4ad5f6",
+    "size": 43621,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "trademark-policy.html": {
+    "hash": "e76cd517163e1c39e88efcf79c333d0efaf0a8460c70adeb7f5ebbe4ecca316b",
+    "size": 6728,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "trust-security.html": {
+    "hash": "504f324d0197e2edf41da03cb2f2ef738f9e3d023b2ebfae9bee7292d6fedf62",
+    "size": 22932,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "webserver.html": {
+    "hash": "6639bf4f609ab1d8f08e05fbfccd15421c702d09e3476217253e2a0eeed95a5e",
+    "size": 12349,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "yak-protocol.html": {
+    "hash": "016cae60a3657c5f18843a634b83720e9b42efaaa6da2e599929c7813f7d5e3b",
+    "size": 18748,
+    "contentType": "text/html; charset=utf-8"
+  },
+  "assets/silhouettes/adapters.svg": {
+    "hash": "32866be4a0383dd4b0fa894d6fb167ea2af5858c591c3c654bb6a3070994d793",
+    "size": 6708,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/api-endpoints.svg": {
+    "hash": "012ed02645e2fdb9895c118b3f1f718e61e27ff8749b7a16554ee6e8b24d7c10",
+    "size": 8124,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/atomic-clock.svg": {
+    "hash": "d7607ae676c88d4e9cdefad4270ca502304dab6252ee90e955852f30ffdf628f",
+    "size": 4664,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/base-camp.svg": {
+    "hash": "36acb01a56f0cf26556e8453c64efb084ec0a9a150fded380355aec7a7f953d0",
+    "size": 4560,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/bridge.svg": {
+    "hash": "f0e10869c1dc5d7ac40b23fb0a76d3b2575eb03f618a308fdd5ec5414bfc6da7",
+    "size": 4171,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/docs-bundle.svg": {
+    "hash": "686a9f08e44de90a4727302f0e285e08eb46ce0934f4b39f6f2ebb191b75178b",
+    "size": 5325,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/doko-basket.svg": {
+    "hash": "695a0e8a4f16a65aad2b5457e5e95237ecc6b1f893ad1e37c3f6496322ff42a6",
+    "size": 3780,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/fortress.svg": {
+    "hash": "3708addbb09b31e256e3f83a64cc37531bd12ce46dac3236cce5054d07c82cac",
+    "size": 5127,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/gateway.svg": {
+    "hash": "bb6d361cc2a4a61b239d17685ac71697c4c1c8375ac9c42aac2cf718ebb2b525",
+    "size": 3134,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/gears.svg": {
+    "hash": "d7f5cc8a0026f8d89cccc161602e220626c731ad8c9c3b61f48ebbbe6a673978",
+    "size": 5644,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/globe-satellite.svg": {
+    "hash": "a7b34b82e475dec67a8ea716581b204b0353a579665673d796accc375546ba64",
+    "size": 3996,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/karma-wheel.svg": {
+    "hash": "7f19d8646e21aefa249c41837734d90b1e61d8d93b329568b0cfa17890ab39f0",
+    "size": 8840,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/lama-council.svg": {
+    "hash": "f53805c635fdf3c8a398eab7a35899a9b66bba81ff79742ef1ba9c0699793ced",
+    "size": 8840,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/mandala-network.svg": {
+    "hash": "c87d81102804ef014fa34a1e640cc0b9e02c5c612c42125b459241b877b9f273",
+    "size": 9991,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/mani-stones.svg": {
+    "hash": "af42b53aca0ba0f65b80280110243880fc6ee3732743b5d15ce5f76927dd828e",
+    "size": 9129,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/mantra-wheel.svg": {
+    "hash": "3c965a1eb96442b6aaea8afc86d8cc3041a706a5748f5683bc0b61285c777719",
+    "size": 7215,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/mesh-nodes.svg": {
+    "hash": "c9f04677bc1a4f9829d901f53dbafc1aba335d90c18ddba67a028c241d20d4a4",
+    "size": 6767,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/nakpak.svg": {
+    "hash": "25c7ac4dff1434586a3919180dab3b99d6dfa54a435585c310cbc52930fb224e",
+    "size": 3245,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/peak-lightning.svg": {
+    "hash": "2019232dfec6a0a9ea8037010885eb41ffb4e2982c3877e131c5888dd1b1da54",
+    "size": 3862,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/sherpa.svg": {
+    "hash": "f529f52b0e71ee59f2668cbb75b099a094ee8de78780aaa45fdbf39f8052260a",
+    "size": 3360,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/stupa-tower.svg": {
+    "hash": "6a47f026b7cd936cf0da977d13e0586c19227dac0b3563c80fb1b02067e4a19c",
+    "size": 7242,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/tattva-eye.svg": {
+    "hash": "afabc2644033018a2711771ad353eba41d69bd9a8213567696ffb66edb95cc05",
+    "size": 4738,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/terminal.svg": {
+    "hash": "52a9cecb6bd1ce79f2b4b793538a6080c81716cc5d46e83403cb32304c4952e2",
+    "size": 4428,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/webserver.svg": {
+    "hash": "1cea58597a31a9fd7ed9374f024348b2eb1dd5e44d710582aa3b09a932319056",
+    "size": 9166,
+    "contentType": "image/svg+xml"
+  },
+  "assets/silhouettes/yak.svg": {
+    "hash": "3b548d18156638b3fcdf3f5567b4c8542c78a4c7c4a83dc2152ef894125641e3",
+    "size": 4005,
+    "contentType": "image/svg+xml"
+  }
+};
+
+/**
+ * Check if a file exists in the bundle
+ * @param {string} path - File path relative to docs root
+ * @returns {boolean}
+ */
+export function hasFile(path) {
+  return path in FILE_INDEX;
+}
+
+/**
+ * Get file metadata from the bundle
+ * @param {string} path - File path relative to docs root
+ * @returns {{hash: string, size: number, contentType: string} | null}
+ */
+export function getFileMeta(path) {
+  return FILE_INDEX[path] || null;
+}

package/embedded-docs/index.js

@@ -0,0 +1,39 @@
+/**
+ * YAKMESH Embedded Documentation Module
+ * 
+ * Self-contained, mathematically verified documentation that ships
+ * with every YAKMESH node. No network required - docs are local.
+ * 
+ * @module embedded-docs
+ * @author YAKMESH Team
+ * @license MIT
+ */
+
+// Core exports
+export { BUNDLE_HASH, BUNDLE_VERSION, FILE_INDEX } from './bundle.js';
+export { verifyFile, verifyBundle, getBundleInfo } from './verify.js';
+export { createDocsRouter, serveDocsFile, getDocsFile } from './serve.js';
+
+// Re-export content types for convenience
+export const DOCS_CONTENT_TYPES = {
+  '.html': 'text/html; charset=utf-8',
+  '.css': 'text/css; charset=utf-8',
+  '.js': 'application/javascript; charset=utf-8',
+  '.svg': 'image/svg+xml',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.ico': 'image/x-icon',
+  '.woff': 'font/woff',
+  '.woff2': 'font/woff2',
+  '.json': 'application/json',
+};
+
+/**
+ * Get content type for a file path
+ * @param {string} path - File path
+ * @returns {string} Content type
+ */
+export function getContentType(path) {
+  const ext = path.substring(path.lastIndexOf('.'));
+  return DOCS_CONTENT_TYPES[ext] || 'application/octet-stream';
+}