@theromans/convex-dobty 0.1.12 → 0.1.14

package/dist/component/knowledgeSearch.js

@@ -1,10 +1,10 @@
-import { action } from "./_generated/server.js";
+import { internalAction, action } from "./_generated/server.js";
 import { internal } from "./_generated/api.js";
 import { v } from "convex/values";
 const EMBEDDING_ENDPOINT = "https://openai.inference.de-txl.ionos.com/v1/embeddings";
 const EMBEDDING_MODEL = "BAAI/bge-m3";
 const EMBEDDING_DIMENSIONS = 1024;
-const EMBEDDING_TIMEOUT_MS = 10_000;
+const EMBEDDING_TIMEOUT_MS = 15_000;
 const DEFAULT_SEARCH_LIMIT = 5;
 async function getEmbedding(text, apiToken) {
     const controller = new AbortController();
@@ -25,7 +25,7 @@ async function getEmbedding(text, apiToken) {
         });
         if (!response.ok) {
             const body = await response.text();
-            throw new Error(`Embedding API error ${response.status}: ${body}`);
+            throw new Error(`Embedding API ${response.status}: ${body}`);
         }
         const json = await response.json();
         return json.data[0].embedding;
@@ -40,13 +40,118 @@ async function getEmbedding(text, apiToken) {
         clearTimeout(timer);
     }
 }
+/**
+ * Embed a single chunk for a single language.
+ * Called by the scheduler after a chunk is seeded or updated.
+ * Automatically schedules the other language if it is also stale.
+ */
+export const embedChunk = internalAction({
+    args: {
+        chunkId: v.id("knowledgeChunks"),
+        language: v.union(v.literal("en"), v.literal("de")),
+    },
+    handler: async (ctx, { chunkId, language }) => {
+        const apiToken = globalThis.process?.env?.IONOS_API_TOKEN;
+        if (!apiToken) {
+            console.error("[embedChunk] IONOS_API_TOKEN not set — cannot embed");
+            return;
+        }
+        const chunk = await ctx.runQuery(internal.knowledge.getChunk, { chunkId });
+        if (!chunk) {
+            console.warn(`[embedChunk] chunk ${chunkId} not found, skipping`);
+            return;
+        }
+        const isStaleEn = !chunk.embedding_en ||
+            !chunk.embeddedAt_en ||
+            chunk.embeddedAt_en < chunk.updatedAt;
+        const isStaleDe = !chunk.embedding_de ||
+            !chunk.embeddedAt_de ||
+            chunk.embeddedAt_de < chunk.updatedAt;
+        const isStale = language === "en" ? isStaleEn : isStaleDe;
+        if (!isStale) {
+            // Already up to date — schedule the other language if needed
+            const otherLanguage = language === "en" ? "de" : "en";
+            const otherStale = language === "en" ? isStaleDe : isStaleEn;
+            if (otherStale) {
+                await ctx.scheduler.runAfter(0, internal.knowledgeSearch.embedChunk, {
+                    chunkId,
+                    language: otherLanguage,
+                });
+            }
+            return;
+        }
+        const title = language === "en" ? chunk.title_English : chunk.title_Deutsch;
+        const content = language === "en" ? chunk.content_English : chunk.content_Deutsch;
+        if (!title || !content) {
+            console.warn(`[embedChunk] chunk ${chunk.chunkKey} missing ${language} content, skipping`);
+            return;
+        }
+        try {
+            const embedding = await getEmbedding(`${title}\n\n${content}`, apiToken);
+            if (language === "en") {
+                await ctx.runMutation(internal.knowledge.updateEmbeddingEn, { chunkId, embedding });
+            }
+            else {
+                await ctx.runMutation(internal.knowledge.updateEmbeddingDe, { chunkId, embedding });
+            }
+            console.log(`[embedChunk] embedded ${chunk.chunkKey} (${language})`);
+            // Schedule the other language if it is also stale
+            const otherLanguage = language === "en" ? "de" : "en";
+            const otherStale = language === "en" ? isStaleDe : isStaleEn;
+            if (otherStale) {
+                await ctx.scheduler.runAfter(0, internal.knowledgeSearch.embedChunk, {
+                    chunkId,
+                    language: otherLanguage,
+                });
+            }
+        }
+        catch (e) {
+            console.error(`[embedChunk] failed for ${chunk.chunkKey} (${language}): ${e.message}`);
+        }
+    },
+});
+/**
+ * Schedule embedding jobs for all chunks that are stale
+ * (updatedAt > embeddedAt_en or embeddedAt_de).
+ * Called automatically after seedKnowledgeChunks, or can be triggered manually.
+ */
+export const scheduleStaleEmbeddings = internalAction({
+    args: {},
+    handler: async (ctx) => {
+        const all = await ctx.runQuery(internal.knowledge.listAllChunks, {});
+        let scheduled = 0;
+        for (const chunk of all) {
+            const staleEn = !chunk.embedding_en ||
+                !chunk.embeddedAt_en ||
+                chunk.embeddedAt_en < chunk.updatedAt;
+            const staleDe = !chunk.embedding_de ||
+                !chunk.embeddedAt_de ||
+                chunk.embeddedAt_de < chunk.updatedAt;
+            if (staleEn) {
+                await ctx.scheduler.runAfter(0, internal.knowledgeSearch.embedChunk, {
+                    chunkId: chunk._id,
+                    language: "en",
+                });
+                scheduled++;
+            }
+            else if (staleDe) {
+                // embedChunk for EN will chain to DE when EN is already fresh
+                await ctx.scheduler.runAfter(0, internal.knowledgeSearch.embedChunk, {
+                    chunkId: chunk._id,
+                    language: "de",
+                });
+                scheduled++;
+            }
+        }
+        console.log(`[scheduleStaleEmbeddings] scheduled ${scheduled} jobs for ${all.length} chunks`);
+        return { total: all.length, scheduled };
+    },
+});
 /**
  * Search knowledge chunks by embedding similarity.
- *
- * - language: the requested language for returned title/content ("en" | "de")
- * - Uses the embedding index for the requested language.
- * - Falls back to the other language's index if the primary has no vectors.
- * - Returns up to `limit` results (default 5).
+ * - language: "en" | "de" — which index to search and which fields to return
+ * - Falls back to the other language index if primary has no vectors yet
+ * - Returns up to `limit` results (default 5)
  */
 export const searchKnowledge = action({
     args: {
@@ -62,11 +167,7 @@ export const searchKnowledge = action({
     },
 });
 /**
- * Search knowledge chunks by pre-computed embedding vector (no outbound fetch needed).
- *
- * - language: the requested language for returned title/content ("en" | "de")
- * - Falls back to the other language's index if primary has no vectors.
- * - Returns up to `limit` results (default 5).
+ * Search with a pre-computed embedding vector (no outbound fetch).
  */
 export const searchByVector = action({
     args: {
@@ -83,14 +184,12 @@ async function _searchByVector(ctx, { topic, embedding, language, limit, }) {
     const primaryIndex = language === "en" ? "by_embedding_en" : "by_embedding_de";
     const fallbackIndex = language === "en" ? "by_embedding_de" : "by_embedding_en";
     const fallbackLanguage = language === "en" ? "de" : "en";
-    // Try primary language index first
     let results = await ctx.vectorSearch("knowledgeChunks", primaryIndex, {
         vector: embedding,
         limit,
         filter: (q) => q.eq("topic", topic),
     });
     let embeddingLanguage = language;
-    // Fall back to the other language's index if primary returned nothing
     if (results.length === 0) {
         results = await ctx.vectorSearch("knowledgeChunks", fallbackIndex, {
             vector: embedding,
@@ -102,9 +201,7 @@ async function _searchByVector(ctx, { topic, embedding, language, limit, }) {
     if (results.length === 0)
         return [];
     const docs = await Promise.all(results.map(async (r) => {
-        const doc = await ctx.runQuery(internal.knowledge.getChunk, {
-            chunkId: r._id,
-        });
+        const doc = await ctx.runQuery(internal.knowledge.getChunk, { chunkId: r._id });
         if (!doc)
             return null;
         const title = language === "en" ? doc.title_English : doc.title_Deutsch;
@@ -123,57 +220,4 @@ async function _searchByVector(ctx, { topic, embedding, language, limit, }) {
     }));
     return docs.filter((d) => d !== null);
 }
-/**
- * Re-embed stale chunks for both languages.
- * Embeds English and Deutsch separately, storing embedding_en and embedding_de.
- */
-export const refreshEmbeddings = action({
-    args: {
-        apiToken: v.string(),
-    },
-    handler: async (ctx, { apiToken }) => {
-        const allChunks = await ctx.runQuery(internal.knowledge.listAllChunks, {});
-        const staleEn = allChunks.filter((c) => !c.embedding_en || !c.embeddedAt_en || c.embeddedAt_en < c.updatedAt);
-        const staleDe = allChunks.filter((c) => !c.embedding_de || !c.embeddedAt_de || c.embeddedAt_de < c.updatedAt);
-        let embeddedEn = 0;
-        let embeddedDe = 0;
-        let errors = 0;
-        for (const chunk of staleEn) {
-            try {
-                const embedding = await getEmbedding(`${chunk.title_English}\n\n${chunk.content_English}`, apiToken);
-                await ctx.runMutation(internal.knowledge.updateEmbeddingEn, {
-                    chunkId: chunk._id,
-                    embedding,
-                });
-                embeddedEn++;
-            }
-            catch (e) {
-                console.error(`Failed to embed EN chunk ${chunk.chunkKey}: ${e.message}`);
-                errors++;
-            }
-        }
-        for (const chunk of staleDe) {
-            try {
-                const embedding = await getEmbedding(`${chunk.title_Deutsch}\n\n${chunk.content_Deutsch}`, apiToken);
-                await ctx.runMutation(internal.knowledge.updateEmbeddingDe, {
-                    chunkId: chunk._id,
-                    embedding,
-                });
-                embeddedDe++;
-            }
-            catch (e) {
-                console.error(`Failed to embed DE chunk ${chunk.chunkKey}: ${e.message}`);
-                errors++;
-            }
-        }
-        return {
-            total: allChunks.length,
-            staleEn: staleEn.length,
-            staleDe: staleDe.length,
-            embeddedEn,
-            embeddedDe,
-            errors,
-        };
-    },
-});
 //# sourceMappingURL=knowledgeSearch.js.map

package/dist/component/knowledgeSearch.js.map

@@ -1 +1 @@
-{"version":3,"file":"knowledgeSearch.js","sourceRoot":"","sources":["../../src/component/knowledgeSearch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"knowledgeSearch.js","sourceRoot":"","sources":["../../src/component/knowledgeSearch.ts"],"names":[],"mappings":"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"}

package/knowledge-chunks.json

@@ -9,7 +9,7 @@
       "title_English": "5DoBT+ Engine Overview",
       "title_Deutsch": "5DoBT+ Engine Überblick",
       "content_English": "# 5DOBT+ Engine Overview\n\n> Source: \"5DOBT+ Engine PPT\" (Marktgut GmbH)",
-      "content_Deutsch": "# 5DoBT+ Engine Überblick\n\n> Quelle: „5DoBT+ Engine PPT" (Marktgut GmbH)"
+      "content_Deutsch": "# 5DoBT+ Engine Überblick\n\n> Quelle: '5DoBT+ Engine PPT' (Marktgut GmbH)"
     },
     {
       "topic": "dobt",
@@ -151,7 +151,7 @@
       "topic": "dobt",
       "chunkKey": "faq--what-does-business-value-mean-in-the-context-of-the-engine",
       "title_English": "What does \"business value\" mean in the context of the engine?",
-      "title_Deutsch": "Was bedeutet „Business Value" im Kontext der Engine?",
+      "title_Deutsch": "Was bedeutet 'Business Value' im Kontext der Engine?",
       "content_English": "Business value represents the total positive impact an initiative creates for an organization.\n\nThis includes:\nFinancial gains\nCost savings\nOperational improvements\nRisk reduction\nIncreased innovation capability\nBetter customer outcomes\nStrategic advantages\n\nThe engine recognizes that not all value can be expressed directly in monetary terms. Therefore, it combines quantitative and qualitative assessments to create a more complete picture of value.",
       "content_Deutsch": "Der Business Value bezeichnet die gesamte positive Wirkung, die eine Initiative für ein Unternehmen erzeugt.\n\nDazu zählen:\n* Finanzielle Verbesserungen\n* Kosteneinsparungen\n* Operative Optimierungen\n* Risikoreduktion\n* Erhöhte Innovationsfähigkeit\n* Verbesserte Kundenergebnisse\n* Strategische Vorteile\n\nDie Engine berücksichtigt, dass sich nicht jeder Wert unmittelbar in monetären Kennzahlen ausdrücken lässt. Daher kombiniert sie quantitative und qualitative Bewertungen, um ein umfassenderes Bild des geschäftlichen Nutzens zu ermöglichen."
     },
@@ -177,7 +177,7 @@
       "title_English": "What is the biggest advantage of the DoBT+ Engine?",
       "title_Deutsch": "Was ist der größte Vorteil der DoBT+ Engine?",
       "content_English": "The biggest advantage is that it transforms business value from a subjective discussion into a measurable, transparent, and continuously evolving decision framework.\n\nRather than asking whether an initiative \"sounds good,\" organizations can understand:\nWhat value it creates\nWhere that value comes from\nHow confident they are in the assessment\nWhat actions are required to realize it\nHow the value changes over time\n\nThis creates a much stronger foundation for strategic and operational decision-making.",
-      "content_Deutsch": "Der größte Vorteil besteht darin, dass Business Value von einer subjektiven Diskussion in einen messbaren, transparenten und kontinuierlich weiterentwickelten Entscheidungsrahmen überführt wird.\n\nStatt zu fragen, ob eine Initiative „sinnvoll erscheint", können Organisationen nachvollziehen:\n* welchen Wert sie erzeugt\n* wo dieser Wert entsteht\n* wie belastbar die Bewertung ist\n* welche Maßnahmen erforderlich sind, um den Wert zu realisieren\n* wie sich der Wert über die Zeit entwickelt\n\nDies schafft eine deutlich fundiertere Grundlage für strategische und operative Entscheidungen."
+      "content_Deutsch": "Der größte Vorteil besteht darin, dass Business Value von einer subjektiven Diskussion in einen messbaren, transparenten und kontinuierlich weiterentwickelten Entscheidungsrahmen überführt wird.\n\nStatt zu fragen, ob eine Initiative 'sinnvoll erscheint', können Organisationen nachvollziehen:\n* welchen Wert sie erzeugt\n* wo dieser Wert entsteht\n* wie belastbar die Bewertung ist\n* welche Maßnahmen erforderlich sind, um den Wert zu realisieren\n* wie sich der Wert über die Zeit entwickelt\n\nDies schafft eine deutlich fundiertere Grundlage für strategische und operative Entscheidungen."
     },
     {
       "topic": "dobt",
@@ -201,7 +201,7 @@
       "title_English": "Step 2: What is the purpose of the Definition of Done?",
       "title_Deutsch": "Schritt 2: Was ist der Zweck der Definition of Done?",
       "content_English": "The Definition of Done describes the exact, measurable outcome that must be achieved for the project to be considered successful. It defines the target state at the end of the initiative and ensures alignment across all stakeholders. It also clarifies what \"success\" means in measurable terms, allowing results to be objectively compared against expectations later.",
-      "content_Deutsch": "Die Definition of Done beschreibt das exakte, messbare Ergebnis, das erreicht werden muss, damit das Projekt als erfolgreich gilt. Sie beschreibt den Zielzustand am Ende der Initiative und stellt die Abstimmung zwischen allen Stakeholdern sicher. Zudem wird konkretisiert, was „Erfolg" in messbaren Begriffen bedeutet, sodass die Ergebnisse später objektiv mit den Erwartungen abgeglichen werden können."
+      "content_Deutsch": "Die Definition of Done beschreibt das exakte, messbare Ergebnis, das erreicht werden muss, damit das Projekt als erfolgreich gilt. Sie beschreibt den Zielzustand am Ende der Initiative und stellt die Abstimmung zwischen allen Stakeholdern sicher. Zudem wird konkretisiert, was 'Erfolg' in messbaren Begriffen bedeutet, sodass die Ergebnisse später objektiv mit den Erwartungen abgeglichen werden können."
     },
     {
       "topic": "dobt",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theromans/convex-dobty",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "type": "module",
   "publishConfig": {
     "access": "public"

package/src/client/index.ts

@@ -519,14 +519,6 @@ export class DobtAddon {
     return await ctx.runAction(this.component.knowledgeSearch.searchByVector, args);
   }
 
-  /** Re-embed stale knowledge chunks for both English and Deutsch separately. */
-  async refreshEmbeddings(
-    ctx: ActionCtx,
-    args: { apiToken: string },
-  ) {
-    return await ctx.runAction(this.component.knowledgeSearch.refreshEmbeddings, args);
-  }
-
   /** List knowledge chunks by topic. */
   async listKnowledgeChunks(
     ctx: QueryCtx,
@@ -540,29 +532,13 @@ export class DobtAddon {
     return await ctx.runQuery(this.component.knowledge.listTopics, {});
   }
 
-  /** List chunks with stale English embeddings (no embedding vectors in payload). */
-  async listStaleKnowledgeChunksEn(ctx: QueryCtx) {
-    return await ctx.runQuery(this.component.knowledge.listStaleChunksEn, {});
-  }
-
-  /** List chunks with stale Deutsch embeddings (no embedding vectors in payload). */
-  async listStaleKnowledgeChunksDe(ctx: QueryCtx) {
-    return await ctx.runQuery(this.component.knowledge.listStaleChunksDe, {});
-  }
-
-  /** Update a single chunk's English embedding by ID. */
-  async updateKnowledgeEmbeddingEn(
-    ctx: MutationCtx,
-    args: { chunkId: string; embedding: number[] },
-  ) {
-    return await ctx.runMutation(this.component.knowledge.updateChunkEmbeddingEn, args);
-  }
-
-  /** Update a single chunk's Deutsch embedding by ID. */
-  async updateKnowledgeEmbeddingDe(
-    ctx: MutationCtx,
-    args: { chunkId: string; embedding: number[] },
-  ) {
-    return await ctx.runMutation(this.component.knowledge.updateChunkEmbeddingDe, args);
+  /**
+   * Schedule embedding jobs for all chunks where updatedAt > embeddedAt_en/de.
+   * Embeddings are processed individually in the background via the scheduler.
+   * Called automatically by seedKnowledgeChunks — only needed manually to
+   * recover from a stuck state.
+   */
+  async scheduleStaleEmbeddings(ctx: ActionCtx) {
+    return await ctx.runAction(this.component.knowledgeSearch.scheduleStaleEmbeddings, {});
   }
 }

package/src/component/knowledge.ts

@@ -4,6 +4,7 @@ import {
   internalMutation,
   internalQuery,
 } from "./_generated/server.js";
+import { internal } from "./_generated/api.js";
 import { v } from "convex/values";
 
 /** Upsert knowledge chunks by topic + chunkKey. Only updates if content changed. */
@@ -49,17 +50,32 @@ export const seedKnowledgeChunks = mutation({
             title_Deutsch: chunk.title_Deutsch,
             content_English: chunk.content_English,
             content_Deutsch: chunk.content_Deutsch,
-            // Invalidate both embeddings so they get re-embedded
-            embeddedAt_en: undefined,
-            embeddedAt_de: undefined,
+            // Bump updatedAt — scheduler will detect embeddedAt < updatedAt and re-embed
             updatedAt: Date.now(),
           });
+          // Schedule EN embedding; it will chain to DE automatically
+          await ctx.scheduler.runAfter(0, internal.knowledgeSearch.embedChunk, {
+            chunkId: existing._id,
+            language: "en",
+          });
           updated++;
         } else {
+          // Content unchanged — but schedule embedding if vectors are missing
+          const needsEmbed =
+            !existing.embedding_en ||
+            !existing.embedding_de ||
+            !existing.embeddedAt_en ||
+            !existing.embeddedAt_de;
+          if (needsEmbed) {
+            await ctx.scheduler.runAfter(0, internal.knowledgeSearch.embedChunk, {
+              chunkId: existing._id,
+              language: "en",
+            });
+          }
           skipped++;
         }
       } else {
-        await ctx.db.insert("knowledgeChunks", {
+        const id = await ctx.db.insert("knowledgeChunks", {
           topic: chunk.topic,
           chunkKey: chunk.chunkKey,
           title_English: chunk.title_English,
@@ -68,6 +84,11 @@ export const seedKnowledgeChunks = mutation({
           content_Deutsch: chunk.content_Deutsch,
           updatedAt: Date.now(),
         });
+        // Schedule EN embedding; it will chain to DE automatically
+        await ctx.scheduler.runAfter(0, internal.knowledgeSearch.embedChunk, {
+          chunkId: id,
+          language: "en",
+        });
         inserted++;
       }
     }
@@ -126,77 +147,7 @@ export const listTopics = query({
   },
 });
 
-/** List chunks that need (re-)embedding for English. */
-export const listStaleChunksEn = query({
-  args: {},
-  handler: async (ctx) => {
-    const all = await ctx.db.query("knowledgeChunks").collect();
-    return all
-      .filter(
-        (c) =>
-          !c.embedding_en ||
-          !c.embeddedAt_en ||
-          c.embeddedAt_en < c.updatedAt,
-      )
-      .map((c) => ({
-        _id: c._id,
-        topic: c.topic,
-        chunkKey: c.chunkKey,
-        title: c.title_English,
-        content: c.content_English,
-      }));
-  },
-});
-
-/** List chunks that need (re-)embedding for Deutsch. */
-export const listStaleChunksDe = query({
-  args: {},
-  handler: async (ctx) => {
-    const all = await ctx.db.query("knowledgeChunks").collect();
-    return all
-      .filter(
-        (c) =>
-          !c.embedding_de ||
-          !c.embeddedAt_de ||
-          c.embeddedAt_de < c.updatedAt,
-      )
-      .map((c) => ({
-        _id: c._id,
-        topic: c.topic,
-        chunkKey: c.chunkKey,
-        title: c.title_Deutsch,
-        content: c.content_Deutsch,
-      }));
-  },
-});
-
-/** Update a chunk's English embedding by ID. */
-export const updateChunkEmbeddingEn = mutation({
-  args: {
-    chunkId: v.id("knowledgeChunks"),
-    embedding: v.array(v.float64()),
-  },
-  handler: async (ctx, { chunkId, embedding }) => {
-    await ctx.db.patch(chunkId, {
-      embedding_en: embedding,
-      embeddedAt_en: Date.now(),
-    });
-  },
-});
 
-/** Update a chunk's Deutsch embedding by ID. */
-export const updateChunkEmbeddingDe = mutation({
-  args: {
-    chunkId: v.id("knowledgeChunks"),
-    embedding: v.array(v.float64()),
-  },
-  handler: async (ctx, { chunkId, embedding }) => {
-    await ctx.db.patch(chunkId, {
-      embedding_de: embedding,
-      embeddedAt_de: Date.now(),
-    });
-  },
-});
 
 // ── Internal functions (called by knowledgeSearch.ts) ──