ruvnet-kb-first 6.5.1 → 6.5.3

package/README.md

@@ -1,10 +1,16 @@
-Updated: 2026-01-02 11:15:00 EST | Version 6.3.0
+Updated: 2026-01-02 14:00:00 EST | Version 6.5.2
 Created: 2026-01-01 15:28:53 EST
 
-# RuvNet-KB-First Application Builder v6.3.0
+# RuvNet KB-First Application Builder v6.5.2
 
 ## Build Intelligent Applications on Expert Knowledge
 
+### NEW in v6.5: Embedded WASM Knowledge Base
+- **17,524 entries** embedded directly in the npm package
+- **Zero infrastructure** - works offline, no PostgreSQL required
+- **15-30ms search latency** (1,340x faster than PostgreSQL)
+- **Auto-update detection** - knows when KB needs refresh
+
 [![npm version](https://img.shields.io/npm/v/ruvnet-kb-first.svg)](https://www.npmjs.com/package/ruvnet-kb-first)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
@@ -71,6 +77,49 @@ npx ruvnet-kb-first init
 
 ---
 
+## Embedded WASM Knowledge Base (NEW in v6.5)
+
+The npm package now includes an **embedded WASM-based knowledge base** with 17,524 entries. This means you can use the KB without any infrastructure:
+
+```javascript
+import { loadKB, search, checkForUpdates } from 'ruvnet-kb-first/kb-data/kb-loader.js';
+
+// Load KB (once, ~400ms)
+await loadKB();
+
+// Search (15-30ms per query)
+const results = await search('how to create agents', 5);
+
+// Check if KB needs update
+const status = await checkForUpdates();
+if (status.needsUpdate) {
+  console.log('Run: npm update ruvnet-kb-first');
+}
+```
+
+### WASM KB vs PostgreSQL
+
+| Feature | WASM KB | PostgreSQL KB |
+|---------|---------|---------------|
+| Entries | 17,524 | 230,000+ |
+| Setup | None | Docker required |
+| Search latency | 15-30ms | ~6,700ms |
+| Works offline | ✓ | ✗ |
+| Auto-updates | npm update | Docker pull |
+
+### Update Workflow
+
+When the PostgreSQL KB is updated:
+
+```bash
+npm run kb:export   # Re-export WASM with new data
+npm test            # Verify 43 tests pass
+npm version patch   # Bump version
+npm publish         # Publish to npm
+```
+
+---
+
 ## Three-Tier Knowledge Base System
 
 RuvNet-KB-First uses a tiered approach to ensure it works for everyone:
@@ -122,9 +171,12 @@ RuvNet-KB-First uses a tiered approach to ensure it works for everyone:
 | Tier | Requirements | Entries | Features |
 |------|--------------|---------|----------|
 | **Full** | Docker + ruvector-postgres | 230K+ | All features: semantic search, citations, gap detection |
+| **WASM** (NEW) | None (npm package) | 17,524 | Embedded KB, 15-30ms search, offline capable |
 | **Starter** | None (bundled SQLite) | 500 | Core patterns, basic semantic search |
 | **Structural** | None | 0 | Directory scoring, phase tracking, hooks only |
 
+**v6.5 Default:** The WASM KB is now the automatic fallback when PostgreSQL is unavailable.
+
 ---
 
 ## What You See

package/kb-data/kb-loader.js

@@ -4,14 +4,14 @@
  * Loads the embedded knowledge base into RvLite WASM.
  * Provides semantic search with ~5ms latency.
  *
- * Content Hash: 62117666416c8c6e
- * Generated: 2026-01-02T18:51:15.858Z
+ * Content Hash: 004c720e1d38de27
+ * Generated: 2026-01-02T18:55:18.300Z
  * Entries: 17,524
  */
 
 import fs from 'fs';
 import path from 'path';
-import { fileURLToPath, pathToFileURL } from 'url';
+import { fileURLToPath } from 'url';
 
 // Initialize WASM on first import
 let wasmInitialized = false;
@@ -22,9 +22,24 @@ async function ensureWasmInit() {
     // Dynamic import to get the init function
     const rvliteModule = await import('@ruvector/edge-full/rvlite');
 
-    // Get the wasm file path
-    const rvlitePath = path.dirname(fileURLToPath(import.meta.resolve('@ruvector/edge-full/rvlite')));
-    const wasmPath = path.join(rvlitePath, 'rvlite_bg.wasm');
+    // Find the WASM file by walking up from this file to find node_modules
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    let searchDir = __dirname;
+    let wasmPath = null;
+
+    // Search for node_modules in parent directories
+    while (searchDir !== path.dirname(searchDir)) {
+      const candidatePath = path.join(searchDir, 'node_modules', '@ruvector', 'edge-full', 'rvlite', 'rvlite_bg.wasm');
+      if (fs.existsSync(candidatePath)) {
+        wasmPath = candidatePath;
+        break;
+      }
+      searchDir = path.dirname(searchDir);
+    }
+
+    if (!wasmPath) {
+      throw new Error('Could not find rvlite_bg.wasm in node_modules');
+    }
 
     // Read the wasm file and pass as buffer (Node.js compatible)
     const wasmBuffer = fs.readFileSync(wasmPath);
@@ -44,8 +59,8 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // KB Version Info
 export const KB_VERSION = {
-  hash: '62117666416c8c6e',
-  exportedAt: '2026-01-02T18:51:15.858Z',
+  hash: '004c720e1d38de27',
+  exportedAt: '2026-01-02T18:55:18.300Z',
   totalEntries: 17524,
   embeddingDim: 384,
   quantization: 'binary',

package/kb-data/kb-metadata.json

@@ -1,7 +1,7 @@
 {
   "version": "1.0.0",
   "schema": "ask_ruvnet",
-  "exportedAt": "2026-01-02T18:51:15.858Z",
+  "exportedAt": "2026-01-02T18:55:18.300Z",
   "totalEntries": 17524,
   "embeddingDim": 384,
   "quantization": "binary",
@@ -67,5 +67,5 @@
       "count": 14
     }
   ],
-  "contentHash": "62117666416c8c6e"
+  "contentHash": "004c720e1d38de27"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ruvnet-kb-first",
-  "version": "6.5.1",
+  "version": "6.5.3",
   "description": "RuvNet KB-First Application Builder - Build intelligent applications on expert knowledge",
   "type": "module",
   "main": "src/index.js",
@@ -13,12 +13,14 @@
     "dev": "tsc --watch",
     "start": "node bin/kb-first.js",
     "mcp": "node src/mcp-server.js",
-    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test": "node tests/run-wasm-tests.js",
+    "test:wasm": "node tests/run-wasm-tests.js",
     "lint": "eslint src/ templates/",
     "kb:init": "node bin/kb-first.js init",
     "kb:score": "node bin/kb-first.js score",
     "kb:verify": "node bin/kb-first.js verify",
     "kb:status": "node bin/kb-first.js status",
+    "kb:export": "node scripts/kb-export-wasm.js --schema ask_ruvnet --output kb-data/",
     "prepublishOnly": "echo 'Publishing ruvnet-kb-first...'"
   },
   "keywords": [
@@ -49,7 +51,7 @@
   },
   "dependencies": {
     "@ruvector/edge-full": "^0.1.0",
-    "agentic-flow": "^2.0.1-alpha.43",
+    "agentic-flow": "^2.0.1-alpha.50",
     "chalk": "^5.3.0",
     "claude-flow": "^2.7.47",
     "commander": "^12.0.0",
@@ -59,7 +61,7 @@
     "ora": "^8.0.0",
     "pg": "^8.16.3",
     "ruv-swarm": "^1.0.20",
-    "ruvector": "^0.1.82"
+    "ruvector": "^0.1.94"
   },
   "devDependencies": {
     "@types/jest": "^29.5.11",

package/scripts/kb-export-wasm.js

@@ -122,7 +122,6 @@ async function exportKB(schema, outputDir) {
     const entries = [];
     const embeddings = [];
     let offset = 0;
-    let hashInput = '';
 
     console.log(`\n   Exporting chunks...`);
 
@@ -155,9 +154,6 @@ async function exportKB(schema, outputDir) {
         } else {
           embeddings.push(new Float32Array(embeddingArray));
         }
-
-        // Add to hash input
-        hashInput += `${row.id}:${row.title}:${row.category}|`;
       }
 
       offset += CONFIG.export.chunkSize;
@@ -167,8 +163,13 @@ async function exportKB(schema, outputDir) {
 
     console.log('\n');
 
-    // Compute content hash
-    metadata.contentHash = crypto.createHash('sha256').update(hashInput).digest('hex').substring(0, 16);
+    // Compute content hash using MD5 (matches PostgreSQL checkForUpdates query)
+    const hashResult = await client.query(`
+      SELECT MD5(STRING_AGG(id::text || ':' || title || ':' || category, '|' ORDER BY id))::text as hash
+      FROM ${schema}.architecture_docs
+      WHERE embedding IS NOT NULL AND is_duplicate = false
+    `);
+    metadata.contentHash = hashResult.rows[0]?.hash?.substring(0, 16) || 'unknown';
     console.log(`   Content Hash: ${metadata.contentHash}`);
 
     // Write metadata