@lucern/graph-primitives 0.3.0-alpha.1 → 0.3.0-alpha.11

package/dist/{epistemicEvidence-Bo638XDP.d.ts → epistemicEvidence-xw6UUrwh.d.ts}

@@ -125,4 +125,4 @@ declare namespace epistemicEvidence {
   export { epistemicEvidence_create as create, epistemicEvidence_createAndLink as createAndLink, epistemicEvidence_flagAsIncorrect as flagAsIncorrect, epistemicEvidence_flattenEvidenceNode as flattenEvidenceNode, epistemicEvidence_getById as getById, epistemicEvidence_getByProject as getByProject, epistemicEvidence_getByProjectSystem as getByProjectSystem, epistemicEvidence_getByTopic as getByTopic, epistemicEvidence_getEvidenceBalance as getEvidenceBalance, epistemicEvidence_getForBelief as getForBelief, epistemicEvidence_internalCreate as internalCreate, epistemicEvidence_internalGetByProject as internalGetByProject, epistemicEvidence_internalGetByTopic as internalGetByTopic, epistemicEvidence_remove as remove, epistemicEvidence_resolveEvidenceLinkedWorktreeId as resolveEvidenceLinkedWorktreeId, epistemicEvidence_update as update, epistemicEvidence_updateStatus as updateStatus, epistemicEvidence_updateVerificationStatus as updateVerificationStatus };
 }
 
-export { createAndLink as a, getByProject as b, create as c, getByTopic as d, epistemicEvidence as e, flattenEvidenceNode as f, getById as g, getForBelief as h, internalGetByProject as i, internalGetByTopic as j, internalCreate as k, updateVerificationStatus as l, getByProjectSystem as m, getEvidenceBalance as n, update as o, flagAsIncorrect as p, remove as q, resolveEvidenceLinkedWorktreeId as r, updateStatus as u };
+export { createAndLink as a, flattenEvidenceNode as b, create as c, getByProject as d, epistemicEvidence as e, flagAsIncorrect as f, getById as g, getByProjectSystem as h, getByTopic as i, getEvidenceBalance as j, getForBelief as k, internalCreate as l, internalGetByProject as m, internalGetByTopic as n, resolveEvidenceLinkedWorktreeId as o, updateStatus as p, updateVerificationStatus as q, remove as r, update as u };

package/dist/epistemicEvidence.d.ts

@@ -1,3 +1,3 @@
 import './convex.js';
-export { c as create, a as createAndLink, p as flagAsIncorrect, f as flattenEvidenceNode, g as getById, b as getByProject, m as getByProjectSystem, d as getByTopic, n as getEvidenceBalance, h as getForBelief, k as internalCreate, i as internalGetByProject, j as internalGetByTopic, q as remove, r as resolveEvidenceLinkedWorktreeId, o as update, u as updateStatus, l as updateVerificationStatus } from './epistemicEvidence-Bo638XDP.js';
+export { c as create, a as createAndLink, f as flagAsIncorrect, b as flattenEvidenceNode, g as getById, d as getByProject, h as getByProjectSystem, i as getByTopic, j as getEvidenceBalance, k as getForBelief, l as internalCreate, m as internalGetByProject, n as internalGetByTopic, r as remove, o as resolveEvidenceLinkedWorktreeId, u as update, p as updateStatus, q as updateVerificationStatus } from './epistemicEvidence-xw6UUrwh.js';
 import 'convex/values';

package/dist/epistemicEvidence.js

@@ -3,7 +3,7 @@ import { requireProjectAccess, checkScopeAccess, checkProjectAccess } from '@luc
 import { canAudienceClassAccess, normalizeAudienceKey, classFromAudienceKey } from '@lucern/access-control/audience';
 import { listAudienceRegistryRows } from '@lucern/access-control/audienceRegistry';
 import { permissiveReturn } from '@lucern/contracts/schema-helpers/validators';
-import { componentsGeneric, mutationGeneric, anyApi, queryGeneric, internalQueryGeneric, internalMutationGeneric } from 'convex/server';
+import { componentsGeneric, anyApi, mutationGeneric, queryGeneric, internalQueryGeneric, internalMutationGeneric } from 'convex/server';
 import { isNodeType, getLayerForNodeType } from '@lucern/contracts/schema-helpers/spine/tables/epistemicNodes';
 
 // src/epistemicEvidence.ts
@@ -15,6 +15,18 @@ var internalQuery = internalQueryGeneric;
 var mutation = mutationGeneric;
 var query = queryGeneric;
 
+// src/debug.ts
+function isGraphPrimitiveDebugEnabled() {
+  const env = globalThis.process?.env;
+  return env?.LUCERN_COMPAT_FALLBACK_DEBUG === "1" || env?.LUCERN_GRAPH_DEBUG === "1";
+}
+function debugGraphPrimitiveFallback(message, context) {
+  if (!isGraphPrimitiveDebugEnabled()) {
+    return;
+  }
+  console.debug(message, context ?? {});
+}
+
 // src/embeddingTrigger.ts
 async function scheduleEmbeddingGeneration(args) {
   try {
@@ -32,7 +44,15 @@ async function scheduleEmbeddingGeneration(args) {
         confidence: args.confidence
       }
     );
-  } catch {
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[embeddingTrigger] Failed to schedule embedding generation",
+      {
+        error,
+        nodeId: String(args.nodeId),
+        nodeType: args.nodeType
+      }
+    );
   }
 }
 
@@ -93,19 +113,37 @@ function isProjectLikeTopic(topic) {
   return topic.type === "theme" || topic.type === "thematic" || topic.type === "deal" || topic.type === "monitoring" || readLegacyProjectId(topic) !== void 0 || readNonEmptyString(metadata.projectType) !== void 0;
 }
 function isMissingLucernChildComponentError(error) {
-  const message = error instanceof Error ? error.message : String(error);
+  const message = getErrorMessage(error);
   return message.includes(
     'Child component ComponentName(Identifier("lucern")) not found'
   ) || message.includes("Child component") && message.includes("lucern") && message.includes("not found");
 }
+function getErrorMessage(error) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  if (typeof error === "object" && error !== null && "message" in error && typeof error.message === "string") {
+    return error.message;
+  }
+  return "unknown error";
+}
 async function resolveTopicDoc(ctx, scopeId) {
   if (ctx?.db && typeof ctx.db.get === "function") {
     try {
-      const directTopic = await ctx.db.get(scopeId);
+      const directTopic = await ctx.db.get(
+        scopeId
+      );
       if (directTopic) {
         return directTopic;
       }
-    } catch {
+    } catch (error) {
+      debugGraphPrimitiveFallback(
+        "[topicProjectOverlay] Failed to resolve topic by direct ID",
+        {
+          error,
+          scopeId
+        }
+      );
     }
   }
   if (typeof ctx.runQuery !== "function") {
@@ -118,7 +156,14 @@ async function resolveTopicDoc(ctx, scopeId) {
     if (topic?.name !== void 0 && topic?.type !== void 0) {
       return topic;
     }
-  } catch {
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[topicProjectOverlay] Failed to resolve topic by ID query",
+      {
+        error,
+        scopeId
+      }
+    );
   }
   try {
     const topic = await ctx.runQuery(api.topics.getByLegacyScopeId, {
@@ -127,7 +172,11 @@ async function resolveTopicDoc(ctx, scopeId) {
     if (topic?.name !== void 0 && topic?.type !== void 0) {
       return topic;
     }
-  } catch {
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[topicProjectOverlay] Failed to resolve topic by legacy scope ID",
+      { error, scopeId }
+    );
   }
   return null;
 }
@@ -181,7 +230,11 @@ async function listTopicProjectOverlays(ctx, options = {}) {
   if (ctx?.db?.query && typeof ctx.db.query === "function") {
     try {
       allTopics = await ctx.db.query("topics").collect();
-    } catch {
+    } catch (error) {
+      debugGraphPrimitiveFallback(
+        "[topicProjectOverlay] Failed to read topics table; falling back to API",
+        { error }
+      );
       allTopics = [];
     }
   }
@@ -276,19 +329,28 @@ async function patchTopicProjectOverlay(ctx, scopeId, value) {
       "Cannot patch topic without component adapter (ctx.runMutation unavailable)"
     );
   }
-  return materializeTopicProjectOverlay(
-    {
-      ...topic,
-      ...patch,
-      metadata: nextMetadata
-    }
-  );
+  return materializeTopicProjectOverlay({
+    ...topic,
+    ...patch,
+    metadata: nextMetadata
+  });
 }
 
 // src/resolvers.ts
 function isMissingLucernChildComponentError2(error) {
-  const message = error instanceof Error ? error.message : String(error);
-  return message.includes('Child component ComponentName(Identifier("lucern")) not found') || message.includes("Child component") && message.includes("lucern") && message.includes("not found");
+  const message = getErrorMessage2(error);
+  return message.includes(
+    'Child component ComponentName(Identifier("lucern")) not found'
+  ) || message.includes("Child component") && message.includes("lucern") && message.includes("not found");
+}
+function getErrorMessage2(error) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  if (typeof error === "object" && error !== null && "message" in error && typeof error.message === "string") {
+    return error.message;
+  }
+  return "unknown error";
 }
 function isAdvisoryTopicPatch(value) {
   const advisoryKeys = /* @__PURE__ */ new Set(["lastActivityAt", "updatedAt"]);
@@ -302,32 +364,27 @@ async function patchProjectWithTolerance(ctx, projectId, value) {
     if (!isAdvisoryTopicPatch(value) || !isMissingLucernChildComponentError2(error)) {
       throw error;
     }
-    console.warn("[lucern graph-primitives] Non-fatal advisory topic patch failure", {
-      projectId,
-      keys: Object.keys(value),
-      error: error instanceof Error ? error.message : error
-    });
+    console.warn(
+      "[lucern graph-primitives] Non-fatal advisory topic patch failure",
+      {
+        projectId,
+        keys: Object.keys(value),
+        error: getErrorMessage2(error)
+      }
+    );
   }
 }
 function defaultResolvers() {
   return {
-    async getProject(ctx, projectId) {
-      return await resolveTopicProjectOverlay(ctx, projectId, {
-        idMode: "legacy",
-        projectLikeOnly: false
-      });
-    },
-    async patchProject(ctx, projectId, value) {
-      await patchProjectWithTolerance(ctx, projectId, value);
-    },
-    async listTopics(ctx) {
-      return await listTopicProjectOverlays(ctx, {
-        idMode: "legacy"
-      });
-    },
-    async getFinalArtifact(ctx, artifactId) {
-      return await ctx.db.get(artifactId);
-    }
+    getProject: (ctx, projectId) => resolveTopicProjectOverlay(ctx, projectId, {
+      idMode: "legacy",
+      projectLikeOnly: false
+    }),
+    patchProject: (ctx, projectId, value) => patchProjectWithTolerance(ctx, projectId, value),
+    listTopics: (ctx) => listTopicProjectOverlays(ctx, {
+      idMode: "legacy"
+    }),
+    getFinalArtifact: (ctx, artifactId) => ctx.db.get(artifactId)
   };
 }
 var resolverOverrides = {};
@@ -378,7 +435,14 @@ async function findTopicsByScopeAlias(ctx, scopeId) {
       "by_graph_scope_project",
       (q) => q.eq(LEGACY_SCOPE_FIELD2, scopeId)
     ).collect();
-  } catch {
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[topicScope] Failed to resolve scope alias via index",
+      {
+        error,
+        scopeId
+      }
+    );
     const topics = await ctx.db.query("topics").collect();
     return topics.filter((topic) => {
       const normalizedGlobalId = normalizeScopeValue(topic.globalId);
@@ -395,7 +459,14 @@ async function tryResolveHostTopicById(ctx, topicId) {
     return await ctx.runQuery(api.topics.get, {
       id: topicId
     }) ?? null;
-  } catch {
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[topicScope] Failed to resolve topic by host query",
+      {
+        error,
+        topicId
+      }
+    );
     return null;
   }
 }
@@ -407,7 +478,14 @@ async function tryResolveHostTopicByLegacyScope(ctx, legacyScopeId) {
     return await ctx.runQuery(api.topics.getByLegacyScopeId, {
       projectId: legacyScopeId
     }) ?? null;
-  } catch {
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[topicScope] Failed to resolve topic by legacy scope",
+      {
+        error,
+        legacyScopeId
+      }
+    );
     return null;
   }
 }
@@ -436,8 +514,17 @@ async function resolveTopicProjectScope(ctx, args) {
   if (args.topicId) {
     let topic = null;
     try {
-      topic = await ctx.db.get(args.topicId);
-    } catch {
+      topic = await ctx.db.get(
+        args.topicId
+      );
+    } catch (error) {
+      debugGraphPrimitiveFallback(
+        "[topicScope] Failed to load topic by direct id",
+        {
+          error,
+          topicId: args.topicId
+        }
+      );
     }
     if (!topic) {
       topic = await tryResolveHostTopicById(ctx, String(args.topicId));
@@ -474,7 +561,14 @@ async function resolveTopicProjectScope(ctx, args) {
       directTopic = await ctx.db.get(
         args.projectId
       );
-    } catch {
+    } catch (error) {
+      debugGraphPrimitiveFallback(
+        "[topicScope] Failed to load direct project topic",
+        {
+          error,
+          projectId: args.projectId
+        }
+      );
     }
     if (directTopic) {
       const inherited = await resolveInheritedWorkspaceScope(ctx, directTopic);
@@ -725,7 +819,15 @@ async function resolveEvidenceScopeOrNull(ctx, args) {
       projectId: args.projectId ?? void 0,
       topicId: args.topicId ?? void 0
     });
-  } catch {
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[epistemicEvidence] Failed to resolve evidence scope",
+      {
+        error,
+        projectId: args.projectId,
+        topicId: args.topicId
+      }
+    );
     return null;
   }
 }
@@ -1101,7 +1203,15 @@ var getByProject = query({
         projectId: args.projectId,
         topicId: args.topicId
       });
-    } catch {
+    } catch (error) {
+      debugGraphPrimitiveFallback(
+        "[epistemicEvidence] Failed to resolve getByProject scope",
+        {
+          error,
+          projectId: args.projectId,
+          topicId: args.topicId
+        }
+      );
       return [];
     }
     if (args.userId) {
@@ -1136,7 +1246,9 @@ var getByTopic = query({
   handler: async (ctx, args) => {
     const pageSize = clampEvidenceLimit(args.limit);
     const scanLimit = Math.min(pageSize * 3, MAX_EVIDENCE_PAGE_SIZE);
-    const scope = await resolveTopicProjectScope(ctx, { topicId: args.topicId });
+    const scope = await resolveTopicProjectScope(ctx, {
+      topicId: args.topicId
+    });
     const topicNodes = await ctx.db.query("epistemicNodes").withIndex(
       "by_topic_type",
       (q) => q.eq("topicId", scope.topicId).eq("nodeType", "evidence")
@@ -1246,7 +1358,9 @@ var internalGetByTopic = internalQuery({
     const pageSize = clampEvidenceLimit(args.limit, 500);
     const scanLimit = Math.min(pageSize * 3, MAX_EVIDENCE_PAGE_SIZE);
     const audienceMode = args.audienceMode ?? "internal";
-    const scope = await resolveTopicProjectScope(ctx, { topicId: args.topicId });
+    const scope = await resolveTopicProjectScope(ctx, {
+      topicId: args.topicId
+    });
     const registryRows = await listAudienceRegistryRows(ctx, {
       tenantId: scope.tenantId,
       workspaceId: scope.workspaceId