ralph-hero-knowledge-index 0.1.45 → 0.1.46

package/.claude-plugin/plugin.json

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

package/README.md

@@ -142,6 +142,85 @@ 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.
 
+## `knowledge_expert` — domain-keyed memory bundles
+
+`knowledge_expert(domain, issue_number, ...)` returns a curated context bundle
+for a named domain — wiki entries, recent reflections, and prior outcomes — so
+sub-agents become per-domain experts via memory rather than per-domain prompts.
+It is the **domain-keyed** companion to `knowledge_recall`'s **role-keyed**
+retrieval: role decides which tiers to surface; domain decides which slice of
+the corpus.
+
+### Signature
+
+```
+knowledge_expert(
+  domain: string,             // Tag to match (e.g. "auth", "memory-tiers", "ralph-knowledge")
+  issue_number: number,       // GitHub issue on whose behalf this call is made — required for telemetry
+  limit?: number,             // Max entries per bucket. Default 5.
+  recency_window_days?: number, // Reflection age cutoff in days. Default 30.
+  path_prefix?: string,       // Optional secondary filter: only docs whose path starts with this prefix.
+  session_id?: string,        // Team/hero session ID — passed through to the outcome event.
+)
+```
+
+Domain matching uses the `tags` table (frontmatter `tags:` arrays are the
+primary signal). `path_prefix` is a secondary narrowing filter — not a
+replacement for tags. Pass `"thoughts/shared/"` to restrict to the shared
+corpus, for example.
+
+### Return shape
+
+```json
+{
+  "query_id": "uuid-v4",
+  "domain": "auth",
+  "wiki": [ ...DocumentRow ],
+  "reflections": [ ...DocumentRow ],
+  "prior_outcomes": [ ...OutcomeEventRow ],
+  "warning": null
+}
+```
+
+| Field | Description |
+|-------|-------------|
+| `query_id` | UUID generated per call. Save this and pass it to `knowledge_record_outcome` as `query_id` to correlate downstream outcomes back to this expert call. |
+| `domain` | Echo of the requested domain. |
+| `wiki` | Up to `limit` documents with `memory_tier = 'wiki'` tagged with `domain`, ordered by date descending. |
+| `reflections` | Up to `limit` documents with `memory_tier = 'reflection'` tagged with `domain` and dated within `recency_window_days`. |
+| `prior_outcomes` | Up to `limit` `outcome_events` rows whose `payload` JSON contains `domain` — pipeline history for this domain. |
+| `warning` | Non-null string when both `wiki` and `reflections` are empty, suggesting the caller tag existing docs or broaden the domain term. `null` on a successful hit. |
+
+### Telemetry
+
+Every `knowledge_expert` call writes an `outcome_events` row with
+`event_type = 'expert_call'`. The `payload` JSON carries `query_id`, `domain`,
+`returned_doc_ids`, `limit`, `recency_window_days`, `path_prefix`, and
+`warning`. This makes per-domain hit rate queryable from day one:
+
+```
+knowledge_query_outcomes({ event_type: "expert_call", aggregate: true })
+```
+
+Pass `query_id` to `knowledge_record_outcome` to tie subsequent phase/research
+outcomes back to the originating expert call:
+
+```
+knowledge_record_outcome({
+  event_type: "research_completed",
+  issue_number: 1306,
+  query_id: "<query_id from knowledge_expert>",
+  verdict: "complete"
+})
+```
+
+### Degradation
+
+`knowledge_expert` degrades the same way as the other knowledge tools — return
+an empty bundle with a `warning` when no matching documents exist; never throw
+on a valid call. If the domain cannot be determined at call time, callers should
+skip the call rather than pass an empty string.
+
 ## Environment variables
 
 | Variable | Purpose |

package/coverage/coverage-summary.json

@@ -1,7 +1,7 @@
-{"total": {"lines":{"total":1489,"covered":1346,"skipped":0,"pct":90.39},"statements":{"total":1623,"covered":1453,"skipped":0,"pct":89.52},"functions":{"total":218,"covered":200,"skipped":0,"pct":91.74},"branches":{"total":936,"covered":762,"skipped":0,"pct":81.41},"branchesTrue":{"total":0,"covered":0,"skipped":0,"pct":"Unknown"}}
+{"total": {"lines":{"total":1521,"covered":1375,"skipped":0,"pct":90.4},"statements":{"total":1655,"covered":1482,"skipped":0,"pct":89.54},"functions":{"total":223,"covered":205,"skipped":0,"pct":91.92},"branches":{"total":957,"covered":782,"skipped":0,"pct":81.71},"branchesTrue":{"total":0,"covered":0,"skipped":0,"pct":"Unknown"}}
 ,"/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":69,"skipped":0,"pct":88.46}}
+,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/db.ts": {"lines":{"total":134,"covered":130,"skipped":0,"pct":97.01},"functions":{"total":33,"covered":33,"skipped":0,"pct":100},"statements":{"total":140,"covered":135,"skipped":0,"pct":96.42},"branches":{"total":85,"covered":75,"skipped":0,"pct":88.23}}
 ,"/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}}
@@ -10,7 +10,7 @@
 ,"/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":183,"covered":162,"skipped":0,"pct":88.52},"functions":{"total":26,"covered":22,"skipped":0,"pct":84.61},"statements":{"total":202,"covered":177,"skipped":0,"pct":87.62},"branches":{"total":122,"covered":84,"skipped":0,"pct":68.85}}
+,"/home/runner/work/ralph-hero/ralph-hero/plugin/ralph-knowledge/src/index.ts": {"lines":{"total":200,"covered":178,"skipped":0,"pct":89},"functions":{"total":29,"covered":25,"skipped":0,"pct":86.2},"statements":{"total":219,"covered":193,"skipped":0,"pct":88.12},"branches":{"total":136,"covered":98,"skipped":0,"pct":72.05}}
 ,"/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":241,"covered":157,"skipped":0,"pct":65.14},"functions":{"total":18,"covered":9,"skipped":0,"pct":50},"statements":{"total":258,"covered":164,"skipped":0,"pct":63.56},"branches":{"total":114,"covered":74,"skipped":0,"pct":64.91}}

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:12:26.778Z
+                at 2026-05-22T03:06:22.333Z
             </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:12:26.778Z
+                at 2026-05-22T03:06:22.333Z
             </div>
         <script src="prettify.js"></script>
         <script>

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

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">97.6% </span>
+                <span class="strong">96.42% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>122/125</span>
+                <span class='fraction'>135/140</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">88.46% </span>
+                <span class="strong">88.23% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>69/78</span>
+                <span class='fraction'>75/85</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
                 <span class="strong">100% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>31/31</span>
+                <span class='fraction'>33/33</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">98.31% </span>
+                <span class="strong">97.01% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>117/119</span>
+                <span class='fraction'>130/134</span>
             </div>
         
             
@@ -610,7 +610,69 @@
 <a name='L545'></a><a href='#L545'>545</a>
 <a name='L546'></a><a href='#L546'>546</a>
 <a name='L547'></a><a href='#L547'>547</a>
-<a name='L548'></a><a href='#L548'>548</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<a name='L548'></a><a href='#L548'>548</a>
+<a name='L549'></a><a href='#L549'>549</a>
+<a name='L550'></a><a href='#L550'>550</a>
+<a name='L551'></a><a href='#L551'>551</a>
+<a name='L552'></a><a href='#L552'>552</a>
+<a name='L553'></a><a href='#L553'>553</a>
+<a name='L554'></a><a href='#L554'>554</a>
+<a name='L555'></a><a href='#L555'>555</a>
+<a name='L556'></a><a href='#L556'>556</a>
+<a name='L557'></a><a href='#L557'>557</a>
+<a name='L558'></a><a href='#L558'>558</a>
+<a name='L559'></a><a href='#L559'>559</a>
+<a name='L560'></a><a href='#L560'>560</a>
+<a name='L561'></a><a href='#L561'>561</a>
+<a name='L562'></a><a href='#L562'>562</a>
+<a name='L563'></a><a href='#L563'>563</a>
+<a name='L564'></a><a href='#L564'>564</a>
+<a name='L565'></a><a href='#L565'>565</a>
+<a name='L566'></a><a href='#L566'>566</a>
+<a name='L567'></a><a href='#L567'>567</a>
+<a name='L568'></a><a href='#L568'>568</a>
+<a name='L569'></a><a href='#L569'>569</a>
+<a name='L570'></a><a href='#L570'>570</a>
+<a name='L571'></a><a href='#L571'>571</a>
+<a name='L572'></a><a href='#L572'>572</a>
+<a name='L573'></a><a href='#L573'>573</a>
+<a name='L574'></a><a href='#L574'>574</a>
+<a name='L575'></a><a href='#L575'>575</a>
+<a name='L576'></a><a href='#L576'>576</a>
+<a name='L577'></a><a href='#L577'>577</a>
+<a name='L578'></a><a href='#L578'>578</a>
+<a name='L579'></a><a href='#L579'>579</a>
+<a name='L580'></a><a href='#L580'>580</a>
+<a name='L581'></a><a href='#L581'>581</a>
+<a name='L582'></a><a href='#L582'>582</a>
+<a name='L583'></a><a href='#L583'>583</a>
+<a name='L584'></a><a href='#L584'>584</a>
+<a name='L585'></a><a href='#L585'>585</a>
+<a name='L586'></a><a href='#L586'>586</a>
+<a name='L587'></a><a href='#L587'>587</a>
+<a name='L588'></a><a href='#L588'>588</a>
+<a name='L589'></a><a href='#L589'>589</a>
+<a name='L590'></a><a href='#L590'>590</a>
+<a name='L591'></a><a href='#L591'>591</a>
+<a name='L592'></a><a href='#L592'>592</a>
+<a name='L593'></a><a href='#L593'>593</a>
+<a name='L594'></a><a href='#L594'>594</a>
+<a name='L595'></a><a href='#L595'>595</a>
+<a name='L596'></a><a href='#L596'>596</a>
+<a name='L597'></a><a href='#L597'>597</a>
+<a name='L598'></a><a href='#L598'>598</a>
+<a name='L599'></a><a href='#L599'>599</a>
+<a name='L600'></a><a href='#L600'>600</a>
+<a name='L601'></a><a href='#L601'>601</a>
+<a name='L602'></a><a href='#L602'>602</a>
+<a name='L603'></a><a href='#L603'>603</a>
+<a name='L604'></a><a href='#L604'>604</a>
+<a name='L605'></a><a href='#L605'>605</a>
+<a name='L606'></a><a href='#L606'>606</a>
+<a name='L607'></a><a href='#L607'>607</a>
+<a name='L608'></a><a href='#L608'>608</a>
+<a name='L609'></a><a href='#L609'>609</a>
+<a name='L610'></a><a href='#L610'>610</a></td><td class="line-coverage quiet"><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>
@@ -705,15 +767,15 @@
 <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">387x</span>
-<span class="cline-any cline-yes">387x</span>
-<span class="cline-any cline-yes">387x</span>
-<span class="cline-any cline-yes">387x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">399x</span>
+<span class="cline-any cline-yes">399x</span>
+<span class="cline-any cline-yes">399x</span>
+<span class="cline-any cline-yes">399x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">387x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">399x</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>
@@ -789,9 +851,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">387x</span>
-<span class="cline-any cline-yes">387x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">399x</span>
+<span class="cline-any cline-yes">399x</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>
@@ -799,15 +861,15 @@
 <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">387x</span>
-<span class="cline-any cline-yes">387x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">399x</span>
+<span class="cline-any cline-yes">399x</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">387x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">399x</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>
@@ -815,11 +877,12 @@
 <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">387x</span>
-<span class="cline-any cline-yes">387x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">399x</span>
+<span class="cline-any cline-yes">399x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">387x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">399x</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>
@@ -847,8 +910,8 @@
 <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">387x</span>
-<span class="cline-any cline-yes">387x</span>
+<span class="cline-any cline-yes">399x</span>
+<span class="cline-any cline-yes">399x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -875,11 +938,11 @@
 <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">968x</span>
+<span class="cline-any cline-yes">975x</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">968x</span>
+<span class="cline-any cline-yes">975x</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>
@@ -907,9 +970,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">171x</span>
-<span class="cline-any cline-yes">171x</span>
-<span class="cline-any cline-yes">300x</span>
+<span class="cline-any cline-yes">178x</span>
+<span class="cline-any cline-yes">178x</span>
+<span class="cline-any cline-yes">308x</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>
@@ -917,6 +980,43 @@
 <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-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-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">22x</span>
+<span class="cline-any cline-yes">22x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">22x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">22x</span>
+<span class="cline-any cline-yes">11x</span>
+<span class="cline-any cline-yes">11x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">22x</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-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">22x</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">341x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -929,11 +1029,11 @@
 <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">28x</span>
-<span class="cline-any cline-yes">28x</span>
-<span class="cline-any cline-yes">28x</span>
+<span class="cline-any cline-yes">50x</span>
+<span class="cline-any cline-yes">50x</span>
+<span class="cline-any cline-yes">50x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">28x</span>
+<span class="cline-any cline-yes">50x</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>
@@ -953,56 +1053,80 @@
 <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">28x</span>
+<span class="cline-any cline-yes">50x</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">18x</span>
-<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">32x</span>
+<span class="cline-any cline-yes">32x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">18x</span>
-<span class="cline-any cline-yes">9x</span>
-<span class="cline-any cline-yes">9x</span>
+<span class="cline-any cline-yes">32x</span>
+<span class="cline-any cline-yes">12x</span>
+<span class="cline-any cline-yes">12x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">18x</span>
-<span class="cline-any cline-yes">2x</span>
-<span class="cline-any cline-yes">2x</span>
+<span class="cline-any cline-yes">32x</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-yes">4x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">32x</span>
 <span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">32x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">32x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">32x</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">32x</span>
 <span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">32x</span>
+<span class="cline-any cline-yes">11x</span>
+<span class="cline-any cline-yes">11x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">32x</span>
+<span class="cline-any cline-yes">32x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">32x</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">18x</span>
-<span class="cline-any cline-yes">18x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">18x</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">32x</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">18x</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">3x</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-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">3x</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>
@@ -1228,6 +1352,7 @@ export interface OutcomeQueryParams {
   verdict?: string;
   sessionId?: string;
   since?: string;
+  domain?: string;
   limit?: number;
 }
 &nbsp;
@@ -1462,6 +1587,43 @@ export class KnowledgeDB {
   getTags(docId: string): string[] {
     return (this.db.prepare("SELECT tag FROM tags WHERE doc_id = ? ORDER BY tag").all(docId) as Array&lt;{ tag: string }&gt;).map(r =&gt; r.tag);
   }
+&nbsp;
+  /**
+   * Return documents matching a domain tag and memory tier.
+   * Joins documents ↔ tags so the domain (frontmatter tag) is the primary
+   * signal. Optional pathPrefix and sinceDate narrow further.
+   */
+  queryByDomain(params: {
+    domain: string;
+    memoryTier: "wiki" | "reflection" | "doc" | "raw";
+    limit: number;
+    pathPrefix?: string;
+    sinceDate?: string;
+  }): DocumentRow[] {
+    const conditions: string[] = ["t.tag = ?", "d.memory_tier = ?"];
+    const values: unknown[] = [params.domain, params.memoryTier];
+&nbsp;
+    <span class="missing-if-branch" title="if path not taken" >I</span>if (params.pathPrefix !== undefined) {
+<span class="cstat-no" title="statement not covered" >      conditions.push("d.path LIKE ?");</span>
+<span class="cstat-no" title="statement not covered" >      values.push(`${params.pathPrefix}%`);</span>
+    }
+    if (params.sinceDate !== undefined) {
+      conditions.push("d.date &gt;= ?");
+      values.push(params.sinceDate);
+    }
+&nbsp;
+    const sql = `
+      SELECT DISTINCT d.id, d.path, d.title, d.date, d.type, d.status,
+             d.github_issue AS githubIssue, d.content, d.is_stub AS isStub
+      FROM documents d
+      JOIN tags t ON t.doc_id = d.id
+      WHERE ${conditions.join(" AND ")}
+      ORDER BY d.date DESC NULLS LAST
+      LIMIT ?
+    `;
+&nbsp;
+    return this.db.prepare(sql).all(...values, params.limit) as DocumentRow[];
+  }
 &nbsp;
   addRelationship(sourceId: string, targetId: string, type: string, context?: string): void {
     this.db.prepare("INSERT OR IGNORE INTO relationships (source_id, target_id, type, context) VALUES (?, ?, ?, ?)").run(sourceId, targetId, type, context ?? null);
@@ -1535,6 +1697,10 @@ export class KnowledgeDB {
       conditions.push("timestamp &gt;= ?");
       values.push(params.since);
     }
+    if (params.domain !== undefined) {
+      conditions.push("json_extract(payload, '$.domain') = ?");
+      values.push(params.domain);
+    }
 &nbsp;
     const where = conditions.length &gt; 0 ? `WHERE ${conditions.join(" AND ")}` : "";
     const limit = params.limit ?? 50;
@@ -1551,6 +1717,26 @@ export class KnowledgeDB {
 &nbsp;
     return this.db.prepare(sql).all(...values, limit) as OutcomeEventRow[];
   }
+&nbsp;
+  /**
+   * Return outcome events whose payload JSON contains a matching `query_id`.
+   * Uses SQLite's JSON1 `json_extract()` function (available by default in
+   * better-sqlite3). Rows with malformed payload JSON silently return NULL
+   * from json_extract and are excluded — the desired behavior.
+   */
+  queryOutcomeEventsByQueryId(queryId: string, limit = 50): OutcomeEventRow[] {
+    const sql = `
+      SELECT id, event_type AS eventType, issue_number AS issueNumber, session_id AS sessionId,
+             timestamp, duration_ms AS durationMs, verdict, component_area AS componentArea,
+             estimate, drift_count AS driftCount, model, agent_type AS agentType,
+             iteration_count AS iterationCount, payload
+      FROM outcome_events
+      WHERE json_extract(payload, '$.query_id') = ?
+      ORDER BY timestamp DESC
+      LIMIT ?
+    `;
+    return this.db.prepare(sql).all(queryId, limit) as OutcomeEventRow[];
+  }
 &nbsp;
   aggregateOutcomeEvents(params: OutcomeQueryParams = {}): OutcomeAggregate {
     // Override limit to aggregate over all matching events, not just the caller's limit
@@ -1711,7 +1897,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:12:26.778Z
+                at 2026-05-22T03:06:22.333Z
             </div>
         <script src="prettify.js"></script>
         <script>