ralph-hero-knowledge-index 0.1.60 → 0.1.67
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.
- package/README.md +22 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -55,7 +55,7 @@ The path can be overridden via the `RALPH_KNOWLEDGE_CONFIG` env var.
|
|
|
55
55
|
{
|
|
56
56
|
"roots": [
|
|
57
57
|
"~/projects/ralph-hero/thoughts",
|
|
58
|
-
"~/projects/
|
|
58
|
+
"~/projects/acme-crawler/thoughts",
|
|
59
59
|
"~/notes"
|
|
60
60
|
],
|
|
61
61
|
"ignorePatterns": [
|
|
@@ -241,6 +241,27 @@ skip the call rather than pass an empty string.
|
|
|
241
241
|
| `RALPH_KNOWLEDGE_CONFIG` | Override path to `knowledge.config.json` (tilde expanded). |
|
|
242
242
|
| `RALPH_KNOWLEDGE_DIRS` | Comma-separated list of roots. Beats config, loses to CLI. |
|
|
243
243
|
| `RALPH_KNOWLEDGE_DB` | Override SQLite path. Beats `config.dbPath`, loses to a CLI `.db` positional. |
|
|
244
|
+
| `RALPH_KNOWLEDGE_HANDSHAKE_DEADLINE_SEC` | How long the launcher waits for a first-run bootstrap before answering the MCP handshake with a no-tools stub and finishing the install in the background (default `15`; `0` blocks until the install completes). |
|
|
245
|
+
| `RALPH_KNOWLEDGE_BOOTSTRAP_WAIT_SEC` | How long to wait for *another* process's bootstrap before giving up (default `900`). Only reachable with the handshake deadline disabled. |
|
|
246
|
+
|
|
247
|
+
### First run on a slow link
|
|
248
|
+
|
|
249
|
+
The first launch for a given runtime installs ~155MB and builds — about 4.5s on
|
|
250
|
+
a normal connection, comfortably inside Claude Code's 30s MCP startup deadline.
|
|
251
|
+
On a slow link the download can outrun that deadline, and the server would be
|
|
252
|
+
marked failed for the whole session *and* the install killed with it, so the
|
|
253
|
+
next session would start just as cold.
|
|
254
|
+
|
|
255
|
+
Past `RALPH_KNOWLEDGE_HANDSHAKE_DEADLINE_SEC` the launcher instead answers the
|
|
256
|
+
handshake from a zero-dependency stub that reports **no tools**, and lets the
|
|
257
|
+
install finish in the background. The session is honestly degraded — the model
|
|
258
|
+
is told the toolset is unavailable and why — and a session started after the
|
|
259
|
+
install completes gets the full server. A bootstrap that *fails* is not a slow
|
|
260
|
+
one: it aborts the launch with its error, as before.
|
|
261
|
+
|
|
262
|
+
Closing that first session before the install finishes interrupts it, but npm's
|
|
263
|
+
cache keeps whatever was already fetched, so the next launch resumes rather than
|
|
264
|
+
restarting the download.
|
|
244
265
|
|
|
245
266
|
## Benchmarks
|
|
246
267
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ralph-hero-knowledge-index",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.67",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"files": [
|
|
@@ -44,9 +44,9 @@
|
|
|
44
44
|
},
|
|
45
45
|
"devDependencies": {
|
|
46
46
|
"@types/better-sqlite3": "^7.6.13",
|
|
47
|
-
"@types/node": "^
|
|
47
|
+
"@types/node": "^26.2.0",
|
|
48
48
|
"@vitest/coverage-v8": "^4.1.10",
|
|
49
|
-
"tsx": "^4.23.
|
|
49
|
+
"tsx": "^4.23.12",
|
|
50
50
|
"typescript": "^6.0.3",
|
|
51
51
|
"vitest": "^4.0.0"
|
|
52
52
|
},
|