ralph-hero-knowledge-index 0.1.40 → 0.1.42

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-knowledge",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "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.40"]
+      "args": ["-y", "ralph-hero-knowledge-index@0.1.42"]
     }
   }
 }

package/README.md

@@ -100,6 +100,48 @@ Patterns behave exactly like `.gitignore`:
 Directories whose names start with `.` or `_` are also always skipped, as a
 fast-path before any matcher is consulted.
 
+## Choosing between `knowledge_search` and `knowledge_recall`
+
+ralph-knowledge exposes two retrieval MCP tools that wrap the same underlying
+hybrid search. They differ on **who decides the tier policy**:
+
+| Tool | When to use | Tier handling |
+|------|-------------|---------------|
+| `knowledge_search` | Power-user / explicit path. You know the tier and want full control over `rerank`, `lambda`, `return_diagnostics`, chunk metadata, etc. | You pass `memory_tier` explicitly (`doc`, `raw`, `reflection`, `wiki`, or `any` — default `any`). |
+| `knowledge_recall` | Default for agents and skills. You declare your role and the tool picks the right tiers. | A role-keyed policy fans out one rerank-enabled `hybrid.search()` per tier in the role's list, then merges and re-ranks. |
+
+### Role -> tier policy
+
+`knowledge_recall(query, role, ...)` follows this fixed policy map:
+
+| Role | Tiers (priority order) | Intent |
+|------|------------------------|--------|
+| `researcher` | `raw`, `reflection`, `doc` | Recovery of unfiltered observations + synthesized insights + curated research. Excludes wiki (we are looking for things the wiki does not already cover). |
+| `planner` | `reflection`, `wiki`, `doc` | Bias toward synthesized insights + canonical curated knowledge; excludes raw observations to keep the planning frame stable. |
+| `implementer` | `wiki`, `doc` | Only canonical references — never raw memory or speculative reflections. Keeps implementations grounded in agreed-upon truth. |
+| `reviewer` | `wiki`, `doc` | Same constraints as implementer — review against the canonical surface, not the raw or speculative tiers. |
+| `triager` | `doc`, `wiki` | Doc-first for issue context, wiki as fallback. |
+
+### Cost notes
+
+- `knowledge_recall` always runs the cross-encoder reranker (`rerank=true`)
+  because role-aware retrieval is the most context-sensitive call path in the
+  surface. Expect a one-time ~0.5-1 s cold-start (ONNX model load on the first
+  call after process boot) and ~25-45 ms per (query, doc) pair on warm calls.
+- Each tier sub-query targets <50 ms; a 3-tier fanout totals <150 ms before
+  reranking.
+- If a tier sub-query throws (e.g., transient DB lock), `knowledge_recall`
+  logs the error to stderr and continues with the remaining tiers — degraded
+  results rather than a hard failure.
+
+### Power-user override
+
+Skills can mix both tools. For example, `/ralph-hero:plan` calls
+`knowledge_recall(role="planner", ...)` for the default tier-balanced context
+gather, and ALSO calls `knowledge_search(type="research", ...)` for an explicit
+artifact lookup where it needs a precise type filter. Keeping both tools in a
+skill's allowlist is the recommended pattern.
+
 ## Environment variables
 
 | Variable | Purpose |

package/benchmark/results-2026-05-13.tsv

@@ -0,0 +1,2 @@
+date	doc_count	chunk_count	wall_clock_s	peak_heap_used_mb	peak_rss_mb	peak_external_mb	threshold_pass	notes
+2026-05-13	50	240	5.35	38.8	579.9	28	true	ok

package/coverage/coverage-summary.json

@@ -1,8 +1,8 @@
-{"total": {"lines":{"total":1307,"covered":1218,"skipped":0,"pct":93.19},"statements":{"total":1428,"covered":1317,"skipped":0,"pct":92.22},"functions":{"total":200,"covered":186,"skipped":0,"pct":93},"branches":{"total":842,"covered":698,"skipped":0,"pct":82.89},"branchesTrue":{"total":0,"covered":0,"skipped":0,"pct":"Unknown"}}
+{"total": {"lines":{"total":1439,"covered":1305,"skipped":0,"pct":90.68},"statements":{"total":1572,"covered":1412,"skipped":0,"pct":89.82},"functions":{"total":211,"covered":194,"skipped":0,"pct":91.94},"branches":{"total":923,"covered":744,"skipped":0,"pct":80.6},"branchesTrue":{"total":0,"covered":0,"skipped":0,"pct":100}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/chunker.ts": {"lines":{"total":91,"covered":85,"skipped":0,"pct":93.4},"functions":{"total":6,"covered":6,"skipped":0,"pct":100},"statements":{"total":94,"covered":88,"skipped":0,"pct":93.61},"branches":{"total":45,"covered":39,"skipped":0,"pct":86.66}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/config.ts": {"lines":{"total":34,"covered":32,"skipped":0,"pct":94.11},"functions":{"total":5,"covered":5,"skipped":0,"pct":100},"statements":{"total":36,"covered":34,"skipped":0,"pct":94.44},"branches":{"total":31,"covered":31,"skipped":0,"pct":100}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/db.ts": {"lines":{"total":119,"covered":117,"skipped":0,"pct":98.31},"functions":{"total":31,"covered":31,"skipped":0,"pct":100},"statements":{"total":125,"covered":122,"skipped":0,"pct":97.6},"branches":{"total":78,"covered":68,"skipped":0,"pct":87.17}}
-,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/embedder.ts": {"lines":{"total":32,"covered":32,"skipped":0,"pct":100},"functions":{"total":7,"covered":7,"skipped":0,"pct":100},"statements":{"total":35,"covered":35,"skipped":0,"pct":100},"branches":{"total":24,"covered":22,"skipped":0,"pct":91.66}}
+,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/embedder.ts": {"lines":{"total":55,"covered":52,"skipped":0,"pct":94.54},"functions":{"total":8,"covered":8,"skipped":0,"pct":100},"statements":{"total":60,"covered":57,"skipped":0,"pct":95},"branches":{"total":38,"covered":30,"skipped":0,"pct":78.94}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/file-scanner.ts": {"lines":{"total":16,"covered":16,"skipped":0,"pct":100},"functions":{"total":2,"covered":2,"skipped":0,"pct":100},"statements":{"total":19,"covered":19,"skipped":0,"pct":100},"branches":{"total":21,"covered":21,"skipped":0,"pct":100}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/format.ts": {"lines":{"total":6,"covered":6,"skipped":0,"pct":100},"functions":{"total":4,"covered":4,"skipped":0,"pct":100},"statements":{"total":8,"covered":8,"skipped":0,"pct":100},"branches":{"total":6,"covered":6,"skipped":0,"pct":100}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/generate-indexes.ts": {"lines":{"total":97,"covered":92,"skipped":0,"pct":94.84},"functions":{"total":16,"covered":16,"skipped":0,"pct":100},"statements":{"total":108,"covered":103,"skipped":0,"pct":95.37},"branches":{"total":57,"covered":49,"skipped":0,"pct":85.96}}
@@ -10,12 +10,13 @@
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/graph-tools.ts": {"lines":{"total":242,"covered":230,"skipped":0,"pct":95.04},"functions":{"total":34,"covered":32,"skipped":0,"pct":94.11},"statements":{"total":257,"covered":243,"skipped":0,"pct":94.55},"branches":{"total":151,"covered":120,"skipped":0,"pct":79.47}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/hybrid-search.ts": {"lines":{"total":174,"covered":173,"skipped":0,"pct":99.42},"functions":{"total":19,"covered":19,"skipped":0,"pct":100},"statements":{"total":203,"covered":195,"skipped":0,"pct":96.05},"branches":{"total":129,"covered":110,"skipped":0,"pct":85.27}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/ignore.ts": {"lines":{"total":17,"covered":16,"skipped":0,"pct":94.11},"functions":{"total":2,"covered":2,"skipped":0,"pct":100},"statements":{"total":19,"covered":18,"skipped":0,"pct":94.73},"branches":{"total":12,"covered":11,"skipped":0,"pct":91.66}}
-,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/index.ts": {"lines":{"total":112,"covered":91,"skipped":0,"pct":81.25},"functions":{"total":16,"covered":13,"skipped":0,"pct":81.25},"statements":{"total":128,"covered":105,"skipped":0,"pct":82.03},"branches":{"total":83,"covered":57,"skipped":0,"pct":68.67}}
+,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/index.ts": {"lines":{"total":148,"covered":121,"skipped":0,"pct":81.75},"functions":{"total":19,"covered":16,"skipped":0,"pct":84.21},"statements":{"total":166,"covered":136,"skipped":0,"pct":81.92},"branches":{"total":105,"covered":67,"skipped":0,"pct":63.8}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/llm-client.ts": {"lines":{"total":31,"covered":31,"skipped":0,"pct":100},"functions":{"total":6,"covered":5,"skipped":0,"pct":83.33},"statements":{"total":33,"covered":32,"skipped":0,"pct":96.96},"branches":{"total":13,"covered":13,"skipped":0,"pct":100}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/parser.ts": {"lines":{"total":49,"covered":49,"skipped":0,"pct":100},"functions":{"total":5,"covered":5,"skipped":0,"pct":100},"statements":{"total":53,"covered":53,"skipped":0,"pct":100},"branches":{"total":46,"covered":41,"skipped":0,"pct":89.13}}
-,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/reindex.ts": {"lines":{"total":153,"covered":120,"skipped":0,"pct":78.43},"functions":{"total":11,"covered":5,"skipped":0,"pct":45.45},"statements":{"total":162,"covered":122,"skipped":0,"pct":75.3},"branches":{"total":73,"covered":46,"skipped":0,"pct":63.01}}
+,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/reindex.ts": {"lines":{"total":194,"covered":157,"skipped":0,"pct":80.92},"functions":{"total":15,"covered":9,"skipped":0,"pct":60},"statements":{"total":209,"covered":164,"skipped":0,"pct":78.46},"branches":{"total":104,"covered":74,"skipped":0,"pct":71.15}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/reranker.ts": {"lines":{"total":42,"covered":37,"skipped":0,"pct":88.09},"functions":{"total":7,"covered":6,"skipped":0,"pct":85.71},"statements":{"total":44,"covered":39,"skipped":0,"pct":88.63},"branches":{"total":22,"covered":18,"skipped":0,"pct":81.81}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/search.ts": {"lines":{"total":40,"covered":40,"skipped":0,"pct":100},"functions":{"total":12,"covered":12,"skipped":0,"pct":100},"statements":{"total":47,"covered":46,"skipped":0,"pct":97.87},"branches":{"total":24,"covered":23,"skipped":0,"pct":95.83}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/traverse.ts": {"lines":{"total":15,"covered":15,"skipped":0,"pct":100},"functions":{"total":5,"covered":5,"skipped":0,"pct":100},"statements":{"total":19,"covered":18,"skipped":0,"pct":94.73},"branches":{"total":16,"covered":12,"skipped":0,"pct":75}}
 ,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/vector-search.ts": {"lines":{"total":25,"covered":24,"skipped":0,"pct":96},"functions":{"total":10,"covered":9,"skipped":0,"pct":90},"statements":{"total":26,"covered":25,"skipped":0,"pct":96.15},"branches":{"total":5,"covered":5,"skipped":0,"pct":100}}
+,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/scripts/verify-tiers.ts": {"lines":{"total":32,"covered":0,"skipped":0,"pct":0},"functions":{"total":3,"covered":0,"skipped":0,"pct":0},"statements":{"total":34,"covered":0,"skipped":0,"pct":0},"branches":{"total":14,"covered":0,"skipped":0,"pct":0}}
 }

package/coverage/lcov-report/index.html

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">92.22% </span>
+                <span class="strong">89.82% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>1317/1428</span>
+                <span class='fraction'>1412/1572</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">82.89% </span>
+                <span class="strong">80.6% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>698/842</span>
+                <span class='fraction'>744/923</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">93% </span>
+                <span class="strong">91.94% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>186/200</span>
+                <span class='fraction'>194/211</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">93.19% </span>
+                <span class="strong">90.68% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>1218/1307</span>
+                <span class='fraction'>1305/1439</span>
             </div>
         
             
@@ -79,288 +79,33 @@
 </tr>
 </thead>
 <tbody><tr>
-	<td class="file high" data-value="chunker.ts"><a href="chunker.ts.html">chunker.ts</a></td>
-	<td data-value="93.61" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 93%"></div><div class="cover-empty" style="width: 7%"></div></div>
+	<td class="file high" data-value="src"><a href="src/index.html">src</a></td>
+	<td data-value="91.8" class="pic high">
+	<div class="chart"><div class="cover-fill" style="width: 91%"></div><div class="cover-empty" style="width: 9%"></div></div>
 	</td>
-	<td data-value="93.61" class="pct high">93.61%</td>
-	<td data-value="94" class="abs high">88/94</td>
-	<td data-value="86.66" class="pct high">86.66%</td>
-	<td data-value="45" class="abs high">39/45</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="6" class="abs high">6/6</td>
-	<td data-value="93.4" class="pct high">93.4%</td>
-	<td data-value="91" class="abs high">85/91</td>
+	<td data-value="91.8" class="pct high">91.8%</td>
+	<td data-value="1538" class="abs high">1412/1538</td>
+	<td data-value="81.84" class="pct high">81.84%</td>
+	<td data-value="909" class="abs high">744/909</td>
+	<td data-value="93.26" class="pct high">93.26%</td>
+	<td data-value="208" class="abs high">194/208</td>
+	<td data-value="92.75" class="pct high">92.75%</td>
+	<td data-value="1407" class="abs high">1305/1407</td>
 	</tr>
 
 <tr>
-	<td class="file high" data-value="config.ts"><a href="config.ts.html">config.ts</a></td>
-	<td data-value="94.44" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 94%"></div><div class="cover-empty" style="width: 6%"></div></div>
+	<td class="file low" data-value="src/scripts"><a href="src/scripts/index.html">src/scripts</a></td>
+	<td data-value="0" class="pic low">
+	<div class="chart"><div class="cover-fill" style="width: 0%"></div><div class="cover-empty" style="width: 100%"></div></div>
 	</td>
-	<td data-value="94.44" class="pct high">94.44%</td>
-	<td data-value="36" class="abs high">34/36</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="31" class="abs high">31/31</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="5" class="abs high">5/5</td>
-	<td data-value="94.11" class="pct high">94.11%</td>
-	<td data-value="34" class="abs high">32/34</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="db.ts"><a href="db.ts.html">db.ts</a></td>
-	<td data-value="97.6" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 97%"></div><div class="cover-empty" style="width: 3%"></div></div>
-	</td>
-	<td data-value="97.6" class="pct high">97.6%</td>
-	<td data-value="125" class="abs high">122/125</td>
-	<td data-value="87.17" class="pct high">87.17%</td>
-	<td data-value="78" class="abs high">68/78</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="31" class="abs high">31/31</td>
-	<td data-value="98.31" class="pct high">98.31%</td>
-	<td data-value="119" class="abs high">117/119</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="embedder.ts"><a href="embedder.ts.html">embedder.ts</a></td>
-	<td data-value="100" class="pic high">
-	<div class="chart"><div class="cover-fill cover-full" style="width: 100%"></div><div class="cover-empty" style="width: 0%"></div></div>
-	</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="35" class="abs high">35/35</td>
-	<td data-value="91.66" class="pct high">91.66%</td>
-	<td data-value="24" class="abs high">22/24</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="7" class="abs high">7/7</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="32" class="abs high">32/32</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="file-scanner.ts"><a href="file-scanner.ts.html">file-scanner.ts</a></td>
-	<td data-value="100" class="pic high">
-	<div class="chart"><div class="cover-fill cover-full" style="width: 100%"></div><div class="cover-empty" style="width: 0%"></div></div>
-	</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="19" class="abs high">19/19</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="21" class="abs high">21/21</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="2" class="abs high">2/2</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="16" class="abs high">16/16</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="format.ts"><a href="format.ts.html">format.ts</a></td>
-	<td data-value="100" class="pic high">
-	<div class="chart"><div class="cover-fill cover-full" style="width: 100%"></div><div class="cover-empty" style="width: 0%"></div></div>
-	</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="8" class="abs high">8/8</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="6" class="abs high">6/6</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="4" class="abs high">4/4</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="6" class="abs high">6/6</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="generate-indexes.ts"><a href="generate-indexes.ts.html">generate-indexes.ts</a></td>
-	<td data-value="95.37" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 95%"></div><div class="cover-empty" style="width: 5%"></div></div>
-	</td>
-	<td data-value="95.37" class="pct high">95.37%</td>
-	<td data-value="108" class="abs high">103/108</td>
-	<td data-value="85.96" class="pct high">85.96%</td>
-	<td data-value="57" class="abs high">49/57</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="16" class="abs high">16/16</td>
-	<td data-value="94.84" class="pct high">94.84%</td>
-	<td data-value="97" class="abs high">92/97</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="graph-builder.ts"><a href="graph-builder.ts.html">graph-builder.ts</a></td>
-	<td data-value="100" class="pic high">
-	<div class="chart"><div class="cover-fill cover-full" style="width: 100%"></div><div class="cover-empty" style="width: 0%"></div></div>
-	</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="12" class="abs high">12/12</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="6" class="abs high">6/6</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="2" class="abs high">2/2</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="12" class="abs high">12/12</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="graph-tools.ts"><a href="graph-tools.ts.html">graph-tools.ts</a></td>
-	<td data-value="94.55" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 94%"></div><div class="cover-empty" style="width: 6%"></div></div>
-	</td>
-	<td data-value="94.55" class="pct high">94.55%</td>
-	<td data-value="257" class="abs high">243/257</td>
-	<td data-value="79.47" class="pct medium">79.47%</td>
-	<td data-value="151" class="abs medium">120/151</td>
-	<td data-value="94.11" class="pct high">94.11%</td>
-	<td data-value="34" class="abs high">32/34</td>
-	<td data-value="95.04" class="pct high">95.04%</td>
-	<td data-value="242" class="abs high">230/242</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="hybrid-search.ts"><a href="hybrid-search.ts.html">hybrid-search.ts</a></td>
-	<td data-value="96.05" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 96%"></div><div class="cover-empty" style="width: 4%"></div></div>
-	</td>
-	<td data-value="96.05" class="pct high">96.05%</td>
-	<td data-value="203" class="abs high">195/203</td>
-	<td data-value="85.27" class="pct high">85.27%</td>
-	<td data-value="129" class="abs high">110/129</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="19" class="abs high">19/19</td>
-	<td data-value="99.42" class="pct high">99.42%</td>
-	<td data-value="174" class="abs high">173/174</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="ignore.ts"><a href="ignore.ts.html">ignore.ts</a></td>
-	<td data-value="94.73" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 94%"></div><div class="cover-empty" style="width: 6%"></div></div>
-	</td>
-	<td data-value="94.73" class="pct high">94.73%</td>
-	<td data-value="19" class="abs high">18/19</td>
-	<td data-value="91.66" class="pct high">91.66%</td>
-	<td data-value="12" class="abs high">11/12</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="2" class="abs high">2/2</td>
-	<td data-value="94.11" class="pct high">94.11%</td>
-	<td data-value="17" class="abs high">16/17</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="index.ts"><a href="index.ts.html">index.ts</a></td>
-	<td data-value="82.03" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 82%"></div><div class="cover-empty" style="width: 18%"></div></div>
-	</td>
-	<td data-value="82.03" class="pct high">82.03%</td>
-	<td data-value="128" class="abs high">105/128</td>
-	<td data-value="68.67" class="pct medium">68.67%</td>
-	<td data-value="83" class="abs medium">57/83</td>
-	<td data-value="81.25" class="pct high">81.25%</td>
-	<td data-value="16" class="abs high">13/16</td>
-	<td data-value="81.25" class="pct high">81.25%</td>
-	<td data-value="112" class="abs high">91/112</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="llm-client.ts"><a href="llm-client.ts.html">llm-client.ts</a></td>
-	<td data-value="96.96" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 96%"></div><div class="cover-empty" style="width: 4%"></div></div>
-	</td>
-	<td data-value="96.96" class="pct high">96.96%</td>
-	<td data-value="33" class="abs high">32/33</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="13" class="abs high">13/13</td>
-	<td data-value="83.33" class="pct high">83.33%</td>
-	<td data-value="6" class="abs high">5/6</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="31" class="abs high">31/31</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="parser.ts"><a href="parser.ts.html">parser.ts</a></td>
-	<td data-value="100" class="pic high">
-	<div class="chart"><div class="cover-fill cover-full" style="width: 100%"></div><div class="cover-empty" style="width: 0%"></div></div>
-	</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="53" class="abs high">53/53</td>
-	<td data-value="89.13" class="pct high">89.13%</td>
-	<td data-value="46" class="abs high">41/46</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="5" class="abs high">5/5</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="49" class="abs high">49/49</td>
-	</tr>
-
-<tr>
-	<td class="file medium" data-value="reindex.ts"><a href="reindex.ts.html">reindex.ts</a></td>
-	<td data-value="75.3" class="pic medium">
-	<div class="chart"><div class="cover-fill" style="width: 75%"></div><div class="cover-empty" style="width: 25%"></div></div>
-	</td>
-	<td data-value="75.3" class="pct medium">75.3%</td>
-	<td data-value="162" class="abs medium">122/162</td>
-	<td data-value="63.01" class="pct medium">63.01%</td>
-	<td data-value="73" class="abs medium">46/73</td>
-	<td data-value="45.45" class="pct low">45.45%</td>
-	<td data-value="11" class="abs low">5/11</td>
-	<td data-value="78.43" class="pct medium">78.43%</td>
-	<td data-value="153" class="abs medium">120/153</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="reranker.ts"><a href="reranker.ts.html">reranker.ts</a></td>
-	<td data-value="88.63" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 88%"></div><div class="cover-empty" style="width: 12%"></div></div>
-	</td>
-	<td data-value="88.63" class="pct high">88.63%</td>
-	<td data-value="44" class="abs high">39/44</td>
-	<td data-value="81.81" class="pct high">81.81%</td>
-	<td data-value="22" class="abs high">18/22</td>
-	<td data-value="85.71" class="pct high">85.71%</td>
-	<td data-value="7" class="abs high">6/7</td>
-	<td data-value="88.09" class="pct high">88.09%</td>
-	<td data-value="42" class="abs high">37/42</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="search.ts"><a href="search.ts.html">search.ts</a></td>
-	<td data-value="97.87" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 97%"></div><div class="cover-empty" style="width: 3%"></div></div>
-	</td>
-	<td data-value="97.87" class="pct high">97.87%</td>
-	<td data-value="47" class="abs high">46/47</td>
-	<td data-value="95.83" class="pct high">95.83%</td>
-	<td data-value="24" class="abs high">23/24</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="12" class="abs high">12/12</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="40" class="abs high">40/40</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="traverse.ts"><a href="traverse.ts.html">traverse.ts</a></td>
-	<td data-value="94.73" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 94%"></div><div class="cover-empty" style="width: 6%"></div></div>
-	</td>
-	<td data-value="94.73" class="pct high">94.73%</td>
-	<td data-value="19" class="abs high">18/19</td>
-	<td data-value="75" class="pct medium">75%</td>
-	<td data-value="16" class="abs medium">12/16</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="5" class="abs high">5/5</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="15" class="abs high">15/15</td>
-	</tr>
-
-<tr>
-	<td class="file high" data-value="vector-search.ts"><a href="vector-search.ts.html">vector-search.ts</a></td>
-	<td data-value="96.15" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 96%"></div><div class="cover-empty" style="width: 4%"></div></div>
-	</td>
-	<td data-value="96.15" class="pct high">96.15%</td>
-	<td data-value="26" class="abs high">25/26</td>
-	<td data-value="100" class="pct high">100%</td>
-	<td data-value="5" class="abs high">5/5</td>
-	<td data-value="90" class="pct high">90%</td>
-	<td data-value="10" class="abs high">9/10</td>
-	<td data-value="96" class="pct high">96%</td>
-	<td data-value="25" class="abs high">24/25</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="34" class="abs low">0/34</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="14" class="abs low">0/14</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="3" class="abs low">0/3</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="32" class="abs low">0/32</td>
 	</tr>
 
 </tbody>
@@ -371,7 +116,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-12T02:41:45.982Z
+                at 2026-05-13T02:34:08.145Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/{chunker.ts.html → src/chunker.ts.html}

@@ -3,15 +3,15 @@
 <html lang="en">
 
 <head>
-    <title>Code coverage report for chunker.ts</title>
+    <title>Code coverage report for src/chunker.ts</title>
     <meta charset="utf-8" />
-    <link rel="stylesheet" href="prettify.css" />
-    <link rel="stylesheet" href="base.css" />
-    <link rel="shortcut icon" type="image/x-icon" href="favicon.png" />
+    <link rel="stylesheet" href="../prettify.css" />
+    <link rel="stylesheet" href="../base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="../favicon.png" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <style type='text/css'>
         .coverage-summary .sorter {
-            background-image: url(sort-arrow-sprite.png);
+            background-image: url(../sort-arrow-sprite.png);
         }
     </style>
 </head>
@@ -19,7 +19,7 @@
 <body>
 <div class='wrapper'>
     <div class='pad1'>
-        <h1><a href="index.html">All files</a> chunker.ts</h1>
+        <h1><a href="../index.html">All files</a> / <a href="index.html">src</a> chunker.ts</h1>
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
@@ -379,9 +379,9 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">5x</span>
-<span class="cline-any cline-yes">5x</span>
-<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-yes">6x</span>
+<span class="cline-any cline-yes">6x</span>
+<span class="cline-any cline-yes">6x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -568,23 +568,23 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">94x</span>
-<span class="cline-any cline-yes">94x</span>
-<span class="cline-any cline-yes">94x</span>
+<span class="cline-any cline-yes">215x</span>
+<span class="cline-any cline-yes">215x</span>
+<span class="cline-any cline-yes">215x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">94x</span>
+<span class="cline-any cline-yes">215x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">93x</span>
+<span class="cline-any cline-yes">214x</span>
 <span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">91x</span>
-<span class="cline-any cline-yes">63x</span>
+<span class="cline-any cline-yes">212x</span>
+<span class="cline-any cline-yes">184x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -940,16 +940,16 @@ 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-12T02:41:45.982Z
+                at 2026-05-13T02:34:08.145Z
             </div>
-        <script src="prettify.js"></script>
+        <script src="../prettify.js"></script>
         <script>
             window.onload = function () {
                 prettyPrint();
             };
         </script>
-        <script src="sorter.js"></script>
-        <script src="block-navigation.js"></script>
+        <script src="../sorter.js"></script>
+        <script src="../block-navigation.js"></script>
     </body>
 </html>