ralph-hero-knowledge-index 0.1.44 → 0.1.45

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-knowledge",
-  "version": "0.1.44",
+  "version": "0.1.45",
   "description": "Knowledge graph for ralph-hero: semantic search, relationship traversal, and document indexing across thoughts/ documents. Optional companion to ralph-hero.",
   "author": {
     "name": "Chad Dubiel",

package/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "ralph-knowledge": {
       "command": "npx",
-      "args": ["-y", "ralph-hero-knowledge-index@0.1.44"]
+      "args": ["-y", "ralph-hero-knowledge-index@0.1.45"]
     }
   }
 }

package/coverage/lcov-report/chunker.ts.html

@@ -940,7 +940,7 @@ export function chunkText(text: string, opts: ChunkerOptions = {}): Chunk[] {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/config.ts.html

@@ -385,7 +385,7 @@ export function loadConfig(): KnowledgeConfig {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/db.ts.html

@@ -1711,7 +1711,7 @@ export class KnowledgeDB {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/embedder.ts.html

@@ -763,7 +763,7 @@ export function prepareTextForEmbedding(
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/file-scanner.ts.html

@@ -199,7 +199,7 @@ export function findMarkdownFiles(dir: string, matcher?: IgnoreMatcher): string[
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/format.ts.html

@@ -295,7 +295,7 @@ export function formatTraverseResults(
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/generate-indexes.ts.html

@@ -670,7 +670,7 @@ export function writeTypeIndex(
   const superseded = docs.filter((d) => d.status === "superseded");
  
   const sortByDate = (a: ParsedDocument, b: ParsedDocument) =>
-    (b.date ?? <span class="branch-1 cbranch-no" title="branch not covered" >"").l</span>ocaleCompare(a.date ?? <span class="branch-1 cbranch-no" title="branch not covered" >"");</span>
+    (b.date ?? <span class="branch-1 cbranch-no" title="branch not covered" >"").l</span>ocaleCompare(a.date ?? <span class="branch-1 cbranch-no" title="branch not covered" >"")</span>;
   active.sort(sortByDate);
   superseded.sort(sortByDate);
 &nbsp;
@@ -791,7 +791,7 @@ export function writeIssueHubs(outDir: string, allDocs: ParsedDocument[]): void
 const RECENT_LIMIT = 20;
 &nbsp;
 export function writeMasterIndex(outDir: string, allDocs: ParsedDocument[], hasUncategorized = false): void {
-  const sorted = [...allDocs].sort((a, b) =&gt; (b.date ?? <span class="branch-1 cbranch-no" title="branch not covered" >"").l</span>ocaleCompare(a.date ?? <span class="branch-1 cbranch-no" title="branch not covered" >""))</span>;
+  const sorted = [...allDocs].sort((a, b) =&gt; (b.date ?? <span class="branch-1 cbranch-no" title="branch not covered" >"").l</span>ocaleCompare(a.date ?? <span class="branch-1 cbranch-no" title="branch not covered" >"")</span>);
   const recent = sorted.slice(0, RECENT_LIMIT);
 &nbsp;
   const lines: string[] = [
@@ -946,7 +946,7 @@ export function generateIndexes(outDir: string, allDocs: ParsedDocument[]): void
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/graph-builder.ts.html

@@ -292,7 +292,7 @@ export class GraphBuilder {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/graph-tools.ts.html

@@ -2386,12 +2386,12 @@ export function registerGraphTools(server: McpServer, db: KnowledgeDB): void {
           // Run Louvain to partition, then extract the community subgraph
           const partition: Record<string, number> =
             graph.size > 0
-              ? louvain(graph, { rng: () =&gt; 0.5 })<span class="fstat-no" title="function not covered" ><span class="branch-1 cbranch-no" title="branch not covered" ></span></span>
+              ? louvain(graph, { rng: () =&gt; 0.5 }<span class="fstat-no" title="function not covered" ><span class="branch-1 cbranch-no" title="branch not covered" >)</span></span>
               : // No edges — each node is its own community, numbered by iteration order
                 (() =&gt; {
                   const p: Record&lt;string, number&gt; = <span class="cstat-no" title="statement not covered" >{};</span>
                   let idx = <span class="cstat-no" title="statement not covered" >0;</span>
-<span class="cstat-no" title="statement not covered" >                  graph.<span class="fstat-no" title="function not covered" >forEachNode((n</span>) =&gt; { <span class="cstat-no" title="statement not covered" >p[n] = idx++; });</span></span>
+<span class="cstat-no" title="statement not covered" >                  graph.<span class="fstat-no" title="function not covered" >forEachNode((n</span>) =&gt; { <span class="cstat-no" title="statement not covered" >p[n] = idx++; }</span>);</span>
 <span class="cstat-no" title="statement not covered" >                  return p;</span>
                 })();
 &nbsp;
@@ -2821,7 +2821,7 @@ export function registerGraphTools(server: McpServer, db: KnowledgeDB): void {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/hybrid-search.ts.html

@@ -1519,7 +1519,7 @@ export class HybridSearch {
     for (const c of candidates) {
       // When all scores are equal (range = 0) treat as full relevance for all
       // so the choice falls through to the diversity term.
-      scoreNorm.set(c.id, range &gt; 0 ? (c.score - minScore) / range : <span class="branch-1 cbranch-no" title="branch not covered" >1.0);</span>
+      scoreNorm.set(c.id, range &gt; 0 ? (c.score - minScore) / range : <span class="branch-1 cbranch-no" title="branch not covered" >1.0)</span>;
     }
 &nbsp;
     // Pre-fetch embeddings for the candidate's best chunk. Doc-level vec ids
@@ -1606,7 +1606,7 @@ export class HybridSearch {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/ignore.ts.html

@@ -316,7 +316,7 @@ export function loadIgnoreForRoot(
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/index.html

@@ -371,7 +371,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/index.ts.html

@@ -1547,7 +1547,7 @@ const DEFAULT_DB_PATH = join(homedir(), ".ralph-hero", "knowledge.db");
 function resolveEnv(name: string): string | undefined {
   const val = process.env[name];
   // Claude Code passes unexpanded ${VAR} literals for unset env vars in .mcp.json
-  <span class="missing-if-branch" title="else path not taken" >E</span>if (!val || <span class="branch-1 cbranch-no" title="branch not covered" >val.startsWith("${"))</span> return undefined;
+  <span class="missing-if-branch" title="else path not taken" >E</span>if (!val || <span class="branch-1 cbranch-no" title="branch not covered" >val.startsWith("${")) r</span>eturn undefined;
 <span class="cstat-no" title="statement not covered" >  return val;</span>
 }
 &nbsp;
@@ -1705,7 +1705,7 @@ export function createServer(dbPath: string, opts: CreateServerOptions = {}) {
 <span class="fstat-no" title="function not covered" >    write: (p</span>ath: string, <span class="cstat-no" title="statement not covered" >body: string) =&gt; writeFileSync(path, body, "utf-8"),</span>
   };
   const rememberReindexImpl = opts.rememberReindex ?? reindexPath;
-  const rememberNow = opts.<span class="fstat-no" title="function not covered" ><span class="branch-1 cbranch-no" title="branch not covered" >rememberNow ?? (() =&gt; <span class="cstat-no" title="statement not covered" >n</span>ew Date())</span></span>;
+  const rememberNow = opts.<span class="fstat-no" title="function not covered" ><span class="branch-1 cbranch-no" title="branch not covered" >rememberNow ?? (() =&gt; <span class="cstat-no" title="statement not covered" >n</span>ew Date());</span></span>
   const rememberBaseDir = opts.rememberBaseDir
     ?? resolveEnv("RALPH_DREAM_MEMORIES_DIR")
     ?? join(homedir(), "projects", "thoughts", "dream-memories");
@@ -2045,7 +2045,7 @@ export function createServer(dbPath: string, opts: CreateServerOptions = {}) {
             return (tier ?? <span class="branch-1 cbranch-no" title="branch not covered" >"doc") === w</span>antedTier;
           });
         }
-        const formatted = formatTraverseResults(<span class="fstat-no" title="function not covered" >results, (i</span>d) =&gt; <span class="cstat-no" title="statement not covered" >db.getTags(id),</span> args.brief ?? false);
+        const formatted = formatTraverseResults(<span class="fstat-no" title="function not covered" >results, (i</span>d) =&gt; <span class="cstat-no" title="statement not covered" >db.getTags(id), a</span>rgs.brief ?? false);
         return { content: [{ type: "text" as const, text: JSON.stringify(formatted, null, 2) }] };
       } catch (e) {
 <span class="cstat-no" title="statement not covered" >        return { content: [{ type: "text" as const, text: `Error: ${(e as Error).message}` }], isError: true };</span>
@@ -2260,7 +2260,7 @@ server.connect(transport).catch(console.error);
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/llm-client.ts.html

@@ -436,7 +436,7 @@ export function createLlmClient(opts: LlmClientOptions = {}): LlmClient {
  
   async function contextualize(fullDocument: string, chunkContent: string): Promise<string> {
     const controller = new AbortController();
-    const timer = <span class="fstat-no" title="function not covered" >setTimeout(() =&gt; <span class="cstat-no" title="statement not covered" >c</span>ontroller.abort(),</span> timeoutMs);
+    const timer = <span class="fstat-no" title="function not covered" >setTimeout(() =&gt; <span class="cstat-no" title="statement not covered" >c</span>ontroller.abort(), t</span>imeoutMs);
     try {
       const prompt = buildContextualizePrompt(fullDocument, chunkContent);
       const response = await fetch(`${baseUrl}/v1/chat/completions`, {
@@ -478,7 +478,7 @@ export function createLlmClient(opts: LlmClientOptions = {}): LlmClient {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/parser.ts.html

@@ -490,7 +490,7 @@ export function extractUntypedWikilinks(
  
 export function parseDocument(id: string, path: string, raw: string): ParsedDocument {
   const fmMatch = raw.match(FRONTMATTER_RE);
-  const frontmatter = fmMatch ? parseYaml(fmMatch[1]) ?? <span class="branch-1 cbranch-no" title="branch not covered" >{} </span>: <span class="branch-1 cbranch-no" title="branch not covered" >{};</span>
+  const frontmatter = fmMatch ? parseYaml(fmMatch[1]) ?? <span class="branch-1 cbranch-no" title="branch not covered" >{} : <span class="branch-1 cbranch-no" title="branch not covered" >{</span>};</span>
   const body = fmMatch ? raw.slice(fmMatch[0].length).trim() : <span class="branch-1 cbranch-no" title="branch not covered" >raw.trim();</span>
   const titleMatch = body.match(TITLE_RE);
   const title = titleMatch ? titleMatch[1].trim() : <span class="branch-1 cbranch-no" title="branch not covered" >id;</span>
@@ -565,7 +565,7 @@ export function parseDocument(id: string, path: string, raw: string): ParsedDocu
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/reindex.ts.html

@@ -1693,7 +1693,7 @@ export async function reindex(
         .all(parsed.id) as Array<{ chunk_index: number; context_prefix: string }>;
       <span class="missing-if-branch" title="else path not taken" >E</span>if (priorChunks.length &gt; 0) {
         cachedPrefixes = new Map(
-          priorChunks.map(r =&gt; [r.chunk_index, r.context_prefix ?? <span class="branch-1 cbranch-no" title="branch not covered" >""] </span>as [number, string])
+          priorChunks.map(r =&gt; [r.chunk_index, r.context_prefix ?? <span class="branch-1 cbranch-no" title="branch not covered" >""]</span> as [number, string])
         );
       }
     }
@@ -1718,7 +1718,7 @@ export async function reindex(
     // BEFORE buffering so the context prefix becomes part of `embedText`
     // and the existing `cachedPrefixes` fast-path is preserved.
     try {
-      const tagLine = parsed.tags.length &gt; 0 ? <span class="branch-0 cbranch-no" title="branch not covered" >parsed.tags.join(", ") </span>: "";
+      const tagLine = parsed.tags.length &gt; 0 ? <span class="branch-0 cbranch-no" title="branch not covered" >parsed.tags.join(", ") : "</span>";
       const chunks: Chunk[] = parsed.content.length === 0
         ? <span class="branch-0 cbranch-no" title="branch not covered" >[{ index: 0, content: "", charStart: 0, charEnd: 0 }]</span>
         : chunkText(parsed.content);
@@ -1980,7 +1980,7 @@ export async function <span class="fstat-no" title="function not covered" >reind
 &nbsp;
     const texts = <span class="cstat-no" title="statement not covered" >chunks.<span class="fstat-no" title="function not covered" >map((c</span>) =&gt; {</span>
       const parts = <span class="cstat-no" title="statement not covered" >[parsed.title, tagLine, c.content];</span>
-<span class="cstat-no" title="statement not covered" >      return parts.<span class="fstat-no" title="function not covered" >filter((p</span>) =&gt; <span class="cstat-no" title="statement not covered" >p.length &gt; 0).</span>join("\n");</span>
+<span class="cstat-no" title="statement not covered" >      return parts.<span class="fstat-no" title="function not covered" >filter((p</span>) =&gt; <span class="cstat-no" title="statement not covered" >p.length &gt; 0)</span>.join("\n");</span>
     });
     const embeddings = <span class="cstat-no" title="statement not covered" >await embedChunks(texts);</span>
     const insertChunk = <span class="cstat-no" title="statement not covered" >db.db.prepare(</span>
@@ -2032,7 +2032,7 @@ const isMain = process.argv[1]?.endsWith("reindex.js");
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/reranker.ts.html

@@ -790,7 +790,7 @@ export class Reranker {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/search.ts.html

@@ -814,7 +814,7 @@ export class FtsSearch {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/traverse.ts.html

@@ -487,7 +487,7 @@ export class Traverser {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/vector-search.ts.html

@@ -439,7 +439,7 @@ export class VectorSearch {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-19T02:05:41.884Z
+                at 2026-05-19T02:12:26.778Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-hero-knowledge-index",
-  "version": "0.1.44",
+  "version": "0.1.45",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -23,9 +23,9 @@
   },
   "dependencies": {
     "@huggingface/transformers": "^3.0.0",
-    "@modelcontextprotocol/sdk": "^1.26.0",
-    "better-sqlite3": "^12.6.0",
-    "graphology": "^0.25.4",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^12.10.0",
+    "graphology": "^0.26.0",
     "graphology-communities-louvain": "^2.0.2",
     "graphology-components": "^1.5.4",
     "graphology-metrics": "^2.4.0",
@@ -35,15 +35,15 @@
     "graphology-traversal": "^0.3.1",
     "graphology-types": "^0.24.8",
     "ignore": "^7.0.5",
-    "sqlite-vec": "^0.1.7-alpha.10",
-    "yaml": "^2.8.4",
+    "sqlite-vec": "^0.1.9",
+    "yaml": "^2.9.0",
     "zod": "^3.25.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^25.7.0",
-    "@vitest/coverage-v8": "^4.1.5",
-    "tsx": "^4.21.0",
+    "@types/node": "^25.9.0",
+    "@vitest/coverage-v8": "^4.1.6",
+    "tsx": "^4.22.2",
     "typescript": "^6.0.3",
     "vitest": "^4.0.0"
   }