ruvnet-kb-first 6.5.2 → 6.5.3

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 (2) hide show
  1. package/README.md +54 -2
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,10 +1,16 @@
1
- Updated: 2026-01-02 11:15:00 EST | Version 6.3.0
1
+ Updated: 2026-01-02 14:00:00 EST | Version 6.5.2
2
2
  Created: 2026-01-01 15:28:53 EST
3
3
 
4
- # RuvNet-KB-First Application Builder v6.3.0
4
+ # RuvNet KB-First Application Builder v6.5.2
5
5
 
6
6
  ## Build Intelligent Applications on Expert Knowledge
7
7
 
8
+ ### NEW in v6.5: Embedded WASM Knowledge Base
9
+ - **17,524 entries** embedded directly in the npm package
10
+ - **Zero infrastructure** - works offline, no PostgreSQL required
11
+ - **15-30ms search latency** (1,340x faster than PostgreSQL)
12
+ - **Auto-update detection** - knows when KB needs refresh
13
+
8
14
  [![npm version](https://img.shields.io/npm/v/ruvnet-kb-first.svg)](https://www.npmjs.com/package/ruvnet-kb-first)
9
15
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
10
16
 
@@ -71,6 +77,49 @@ npx ruvnet-kb-first init
71
77
 
72
78
  ---
73
79
 
80
+ ## Embedded WASM Knowledge Base (NEW in v6.5)
81
+
82
+ 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:
83
+
84
+ ```javascript
85
+ import { loadKB, search, checkForUpdates } from 'ruvnet-kb-first/kb-data/kb-loader.js';
86
+
87
+ // Load KB (once, ~400ms)
88
+ await loadKB();
89
+
90
+ // Search (15-30ms per query)
91
+ const results = await search('how to create agents', 5);
92
+
93
+ // Check if KB needs update
94
+ const status = await checkForUpdates();
95
+ if (status.needsUpdate) {
96
+ console.log('Run: npm update ruvnet-kb-first');
97
+ }
98
+ ```
99
+
100
+ ### WASM KB vs PostgreSQL
101
+
102
+ | Feature | WASM KB | PostgreSQL KB |
103
+ |---------|---------|---------------|
104
+ | Entries | 17,524 | 230,000+ |
105
+ | Setup | None | Docker required |
106
+ | Search latency | 15-30ms | ~6,700ms |
107
+ | Works offline | ✓ | ✗ |
108
+ | Auto-updates | npm update | Docker pull |
109
+
110
+ ### Update Workflow
111
+
112
+ When the PostgreSQL KB is updated:
113
+
114
+ ```bash
115
+ npm run kb:export # Re-export WASM with new data
116
+ npm test # Verify 43 tests pass
117
+ npm version patch # Bump version
118
+ npm publish # Publish to npm
119
+ ```
120
+
121
+ ---
122
+
74
123
  ## Three-Tier Knowledge Base System
75
124
 
76
125
  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:
122
171
  | Tier | Requirements | Entries | Features |
123
172
  |------|--------------|---------|----------|
124
173
  | **Full** | Docker + ruvector-postgres | 230K+ | All features: semantic search, citations, gap detection |
174
+ | **WASM** (NEW) | None (npm package) | 17,524 | Embedded KB, 15-30ms search, offline capable |
125
175
  | **Starter** | None (bundled SQLite) | 500 | Core patterns, basic semantic search |
126
176
  | **Structural** | None | 0 | Directory scoring, phase tracking, hooks only |
127
177
 
178
+ **v6.5 Default:** The WASM KB is now the automatic fallback when PostgreSQL is unavailable.
179
+
128
180
  ---
129
181
 
130
182
  ## What You See
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ruvnet-kb-first",
3
- "version": "6.5.2",
3
+ "version": "6.5.3",
4
4
  "description": "RuvNet KB-First Application Builder - Build intelligent applications on expert knowledge",
5
5
  "type": "module",
6
6
  "main": "src/index.js",