eddie-jekyll 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0fb05e7b2291be54f498bc2e2df6c8b75689e2fecd1e62f069b05712d78882f5
-  data.tar.gz: 402f2f4a6569e9117f7acf584ff4d6966c05cf3601ce2909c3960b489d3180fd
+  metadata.gz: 8ee3de05bd384c3efa54ac0f02fe5ef965ad2ce916527ccfa64b8192e78f8a21
+  data.tar.gz: 74fce98d4bb02cf2b673ea7320e4d76945cba73174aa2d519f18af7a20e0a181
 SHA512:
-  metadata.gz: 28c2cf42975d69ddaa552acb7ece03fe9a7f390d5eac410b35b49387c3f527f85c2b4a01e288f557b681b2a509e40b073deb6d174e5e6296547a0e9466683652
-  data.tar.gz: a6159ac2597c2f1e294ef466d6d1e663cb0f753728e1fa97047a6992987891d5f998cf85d9b5752f61e27bdcf49ca40f7e28e53eb994b0313aece4f36e98aa17
+  metadata.gz: 57a741bc8deb39f770afb142fc6b627e2a716c621691e57aff0a3de5a0b3f097b3b93ca2994148ee8efbd5c0d5cd6233c95bbbc0c7ef8a3a4886021f1cbca49b
+  data.tar.gz: b50f5c323df27a301a03789542c53b5413e69e61a619b6a9945ce0d7fbb21cb1511eb9a9019c065973af2d38e37a705c8f1a598aa70ee54f25be05f3f3e94cfb

data/assets/eddie-agent-worker.js

@@ -265,7 +265,36 @@ const EddieLib = {};
     return { answer: text, citations, nohit: text === "" };
   }
 
+
+  // FAQ card gate: prefer the WASM's fused `confident` flag (qa_lookup v0.4.1+);
+  // older indexes only carry a dense score, so fall back to a plain cutoff.
+  function faqPasses(hit, qaMode) {
+    if (!hit || typeof hit !== "object") return false;
+    if (qaMode === "off") return false;
+    if (qaMode === "always") return true;
+    if (typeof hit.confident === "boolean") return hit.confident;
+    return typeof hit.score === "number" && hit.score >= 0.5;
+  }
+
+  // Turn confident QA hits into agent evidence items ("Q: … A: …") so the
+  // answer model sees the FAQ lane, not only chunk text.
+  function qaEvidence(hits, max) {
+    const limit = max == null ? 2 : max;
+    const out = [];
+    for (const h of Array.isArray(hits) ? hits : []) {
+      if (out.length >= limit) break;
+      if (!faqPasses(h, "auto")) continue;
+      const q = String(h.question || "").trim();
+      const a = String(h.answer || "").trim();
+      if (!q || !a) continue;
+      out.push({ title: "FAQ: " + q, url: h.source_url || "", text: "Q: " + q + "\nA: " + a, faq: true });
+    }
+    return out;
+  }
+
   return {
+    faqPasses,
+    qaEvidence,
     NOHIT,
     AGENT_MODEL_SIZES,
     PLAN_SCHEMA,

data/assets/eddie-wasm.js

@@ -181,8 +181,11 @@ let wasm_bindgen = (function(exports) {
     exports.page = page;
 
     /**
-     * Nearest QA entries by cosine on the qa dense lane. Returns `[]` when the
-     * index has no qa section or no query vector can be produced.
+     * QA entries ranked by [`crate::search::rank_qa`]: the qa dense lane's
+     * cosine fused with lexical overlap and a BM25 pass over the questions and
+     * answers. Returns `[]` when the index has no qa section; without a query
+     * vector (no runnable embedder) the ranking is lexical only and no hit is
+     * `confident`.
      * @param {string} query
      * @param {string | null | undefined} dense_lane_id
      * @param {Float32Array | null | undefined} dense_query_vec

data/assets/eddie-widget.js

@@ -639,7 +639,36 @@ const EddieLib = {};
     return { answer: text, citations, nohit: text === "" };
   }
 
+
+  // FAQ card gate: prefer the WASM's fused `confident` flag (qa_lookup v0.4.1+);
+  // older indexes only carry a dense score, so fall back to a plain cutoff.
+  function faqPasses(hit, qaMode) {
+    if (!hit || typeof hit !== "object") return false;
+    if (qaMode === "off") return false;
+    if (qaMode === "always") return true;
+    if (typeof hit.confident === "boolean") return hit.confident;
+    return typeof hit.score === "number" && hit.score >= 0.5;
+  }
+
+  // Turn confident QA hits into agent evidence items ("Q: … A: …") so the
+  // answer model sees the FAQ lane, not only chunk text.
+  function qaEvidence(hits, max) {
+    const limit = max == null ? 2 : max;
+    const out = [];
+    for (const h of Array.isArray(hits) ? hits : []) {
+      if (out.length >= limit) break;
+      if (!faqPasses(h, "auto")) continue;
+      const q = String(h.question || "").trim();
+      const a = String(h.answer || "").trim();
+      if (!q || !a) continue;
+      out.push({ title: "FAQ: " + q, url: h.source_url || "", text: "Q: " + q + "\nA: " + a, faq: true });
+    }
+    return out;
+  }
+
   return {
+    faqPasses,
+    qaEvidence,
     NOHIT,
     AGENT_MODEL_SIZES,
     PLAN_SCHEMA,
@@ -1659,8 +1688,7 @@ const EddieLib = {};
       return;
     }
     const best = hits[0];
-    const threshold = config.qaMode === "always" ? 0 : 0.5;
-    if (!best || typeof best.score !== "number" || best.score < threshold) {
+    if (!lib.faqPasses(best, config.qaMode)) {
       hide(faqCard);
       return;
     }
@@ -1886,7 +1914,12 @@ const EddieLib = {};
       const evidence = lib.mergeEvidence(lists, 6);
       await expandShortEvidence(evidence);
       if (run.aborted) return;
-      run.evidence = evidence.map((r) => ({ title: r.title, url: r.url, text: r.text || r.snippet || "" }));
+      // Confident FAQ entries (build-time QA lane) go first: they are short,
+      // direct, and already carry a source page.
+      const faqHits = await callWorker("qa", { query: question, k: 3 }).then((m) => m.hits || []).catch(() => []);
+      if (run.aborted) return;
+      const faqItems = lib.qaEvidence(faqHits, 2);
+      run.evidence = faqItems.concat(evidence.map((r) => ({ title: r.title, url: r.url, text: r.text || r.snippet || "" })));
       answerProgress.textContent = "Answering…";
       await streamAnswer(run);
     } catch (err) {

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: eddie-jekyll
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Jason Grey
@@ -18,7 +18,7 @@ dependencies:
         version: '0.4'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.4.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -28,7 +28,7 @@ dependencies:
         version: '0.4'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.4.1
 description: Provides a CLI helper that runs Eddie's Jekyll installer script.
 executables:
 - eddie-jekyll-install