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

package/dist/{epistemicQuestions-CmEeY6zQ.d.ts → epistemicQuestions-B_nUclrH.d.ts}

@@ -211,4 +211,4 @@ declare namespace epistemicQuestions {
   export { epistemicQuestions_addQuestion as addQuestion, epistemicQuestions_advanceToConviction as advanceToConviction, epistemicQuestions_backfillScoredQuestionEvidence as backfillScoredQuestionEvidence, epistemicQuestions_consolidate as consolidate, epistemicQuestions_create as create, epistemicQuestions_createBatch as createBatch, epistemicQuestions_createEvidenceFromScoredQuestion as createEvidenceFromScoredQuestion, epistemicQuestions_deleteQuestion as deleteQuestion, epistemicQuestions_finalizeConviction as finalizeConviction, epistemicQuestions_flattenQuestionNode as flattenQuestionNode, epistemicQuestions_getByBeliefWithAccess as getByBeliefWithAccess, epistemicQuestions_getByCategory as getByCategory, epistemicQuestions_getById as getById, epistemicQuestions_getByPillar as getByPillar, epistemicQuestions_getByProject as getByProject, epistemicQuestions_getByTopic as getByTopic, epistemicQuestions_getForBelief as getForBelief, epistemicQuestions_getForSprintCluster as getForSprintCluster, epistemicQuestions_getInConviction as getInConviction, epistemicQuestions_getQuestionClusterPositions as getQuestionClusterPositions, epistemicQuestions_internalCreate as internalCreate, epistemicQuestions_internalGetByProject as internalGetByProject, epistemicQuestions_internalGetByTopic as internalGetByTopic, epistemicQuestions_isActiveQuestionNode as isActiveQuestionNode, epistemicQuestions_linkToBelief as linkToBelief, epistemicQuestions_linkToInsight as linkToInsight, epistemicQuestions_list as list, epistemicQuestions_markAnsweredWithArtifact as markAnsweredWithArtifact, epistemicQuestions_matchesRequestedQuestionStatus as matchesRequestedQuestionStatus, epistemicQuestions_resolveLinkedWorktreeId as resolveLinkedWorktreeId, epistemicQuestions_unlinkInsight as unlinkInsight, epistemicQuestions_updateConviction as updateConviction, epistemicQuestions_updatePriority as updatePriority, epistemicQuestions_updateQuestion as updateQuestion, epistemicQuestions_updateStatus as updateStatus };
 }
 
-export { updateQuestion as A, linkToBelief as B, linkToInsight as C, unlinkInsight as D, list as E, getByPillar as F, consolidate as G, deleteQuestion as H, markAnsweredWithArtifact as I, getQuestionClusterPositions as J, createBatch as a, updatePriority as b, create as c, getByProject as d, epistemicQuestions as e, flattenQuestionNode as f, getById as g, getByTopic as h, isActiveQuestionNode as i, getByCategory as j, getForBelief as k, internalGetByProject as l, matchesRequestedQuestionStatus as m, internalGetByTopic as n, internalCreate as o, addQuestion as p, createEvidenceFromScoredQuestion as q, resolveLinkedWorktreeId as r, backfillScoredQuestionEvidence as s, getForSprintCluster as t, updateStatus as u, getInConviction as v, advanceToConviction as w, updateConviction as x, finalizeConviction as y, getByBeliefWithAccess as z };
+export { linkToInsight as A, list as B, markAnsweredWithArtifact as C, matchesRequestedQuestionStatus as D, resolveLinkedWorktreeId as E, unlinkInsight as F, updateConviction as G, updatePriority as H, updateQuestion as I, updateStatus as J, addQuestion as a, advanceToConviction as b, backfillScoredQuestionEvidence as c, consolidate as d, epistemicQuestions as e, create as f, createBatch as g, createEvidenceFromScoredQuestion as h, deleteQuestion as i, finalizeConviction as j, flattenQuestionNode as k, getByBeliefWithAccess as l, getByCategory as m, getById as n, getByPillar as o, getByProject as p, getByTopic as q, getForBelief as r, getForSprintCluster as s, getInConviction as t, getQuestionClusterPositions as u, internalCreate as v, internalGetByProject as w, internalGetByTopic as x, isActiveQuestionNode as y, linkToBelief as z };

package/dist/epistemicQuestions.d.ts

@@ -1,3 +1,3 @@
 import './convex.js';
-export { p as addQuestion, w as advanceToConviction, s as backfillScoredQuestionEvidence, G as consolidate, c as create, a as createBatch, q as createEvidenceFromScoredQuestion, H as deleteQuestion, y as finalizeConviction, f as flattenQuestionNode, z as getByBeliefWithAccess, j as getByCategory, g as getById, F as getByPillar, d as getByProject, h as getByTopic, k as getForBelief, t as getForSprintCluster, v as getInConviction, J as getQuestionClusterPositions, o as internalCreate, l as internalGetByProject, n as internalGetByTopic, i as isActiveQuestionNode, B as linkToBelief, C as linkToInsight, E as list, I as markAnsweredWithArtifact, m as matchesRequestedQuestionStatus, r as resolveLinkedWorktreeId, D as unlinkInsight, x as updateConviction, b as updatePriority, A as updateQuestion, u as updateStatus } from './epistemicQuestions-CmEeY6zQ.js';
+export { a as addQuestion, b as advanceToConviction, c as backfillScoredQuestionEvidence, d as consolidate, f as create, g as createBatch, h as createEvidenceFromScoredQuestion, i as deleteQuestion, j as finalizeConviction, k as flattenQuestionNode, l as getByBeliefWithAccess, m as getByCategory, n as getById, o as getByPillar, p as getByProject, q as getByTopic, r as getForBelief, s as getForSprintCluster, t as getInConviction, u as getQuestionClusterPositions, v as internalCreate, w as internalGetByProject, x as internalGetByTopic, y as isActiveQuestionNode, z as linkToBelief, A as linkToInsight, B as list, C as markAnsweredWithArtifact, D as matchesRequestedQuestionStatus, E as resolveLinkedWorktreeId, F as unlinkInsight, G as updateConviction, H as updatePriority, I as updateQuestion, J as updateStatus } from './epistemicQuestions-B_nUclrH.js';
 import 'convex/values';

package/dist/epistemicQuestions.js

@@ -4,7 +4,7 @@ import { normalizeAudienceKey, canAudienceClassAccess, classFromAudienceKey } fr
 import { listAudienceRegistryRows } from '@lucern/access-control/audienceRegistry';
 import { getCurrentUserId } from '@lucern/access-control/auth';
 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/epistemicQuestions.ts
@@ -16,6 +16,37 @@ 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 formatGraphPrimitiveError(error) {
+  if (error instanceof Error) {
+    return `${error.name}: ${error.message}`;
+  }
+  if (typeof error === "string") {
+    return error;
+  }
+  if (error === null) {
+    return "null";
+  }
+  if (error === void 0) {
+    return "undefined";
+  }
+  try {
+    return JSON.stringify(error);
+  } catch {
+    return Object.prototype.toString.call(error);
+  }
+}
+function debugGraphPrimitiveFallback(message, context) {
+  if (!isGraphPrimitiveDebugEnabled()) {
+    return;
+  }
+  console.debug(message, context ?? {});
+}
+
 // src/embeddingTrigger.ts
 async function scheduleEmbeddingGeneration(args) {
   try {
@@ -33,7 +64,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
+      }
+    );
   }
 }
 
@@ -94,19 +133,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") {
@@ -119,7 +176,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, {
@@ -128,7 +192,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;
 }
@@ -182,7 +250,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 = [];
     }
   }
@@ -277,19 +349,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"]);
@@ -303,32 +384,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 = {};
@@ -379,7 +455,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);
@@ -396,7 +479,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;
   }
 }
@@ -408,7 +498,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;
   }
 }
@@ -437,8 +534,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));
@@ -475,7 +581,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);
@@ -850,6 +963,12 @@ function normalizeQuestionTopicId(topicId) {
 function resolveQuestionScopeId(scope) {
   return normalizeQuestionTopicId(scope.topicId) ?? scope.projectId ?? void 0;
 }
+function logQuestionFallback(message, error, context) {
+  debugGraphPrimitiveFallback(message, {
+    error: formatGraphPrimitiveError(error),
+    ...context ?? {}
+  });
+}
 async function resolveQuestionScopeOrNull(ctx, args) {
   if (!args.projectId && !args.topicId) {
     return null;
@@ -859,7 +978,15 @@ async function resolveQuestionScopeOrNull(ctx, args) {
       projectId: args.projectId ?? void 0,
       topicId: args.topicId ?? void 0
     });
-  } catch {
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[epistemicQuestions] Failed to resolve question scope",
+      {
+        error: formatGraphPrimitiveError(error),
+        projectId: args.projectId,
+        topicId: args.topicId
+      }
+    );
     return null;
   }
 }
@@ -1063,9 +1190,7 @@ var create = mutation({
         source: args.source || "ai_suggested",
         questionStatus: "open",
         linkedBeliefNodeId: args.linkedBeliefNodeId,
-        ...buildLinkedWorktreeMetadata(
-          args.linkedWorktreeId
-        ),
+        ...buildLinkedWorktreeMetadata(args.linkedWorktreeId),
         testType: args.testType,
         importance: args.importance,
         epistemicUnlock: args.epistemicUnlock,
@@ -1476,7 +1601,9 @@ var getByTopic = query({
   handler: async (ctx, args) => {
     const pageSize = clampQuestionLimit(args.limit);
     const scanLimit = Math.min(pageSize * 3, MAX_QUESTION_PAGE_SIZE);
-    const scope = await resolveTopicProjectScope(ctx, { topicId: args.topicId });
+    const scope = await resolveTopicProjectScope(ctx, {
+      topicId: args.topicId
+    });
     const scopedNodes = await getQuestionNodesForScope(ctx, scope, {
       scanLimit
     });
@@ -1500,7 +1627,7 @@ var getByCategory = query({
     const nodes = await getQuestionNodesForScope(ctx, scope);
     return nodes.filter((n) => {
       const metadata = n.metadata || {};
-      return questionMatchesScope(n, scope) && (isActiveQuestionNode(n) && metadata.category === normalizeCategory(args.category));
+      return questionMatchesScope(n, scope) && isActiveQuestionNode(n) && metadata.category === normalizeCategory(args.category);
     });
   }
 });
@@ -1596,7 +1723,9 @@ var internalGetByTopic = internalQuery({
     const pageSize = clampQuestionLimit(args.limit, 500);
     const scanLimit = Math.min(pageSize * 3, MAX_QUESTION_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
@@ -1926,7 +2055,14 @@ A: ${args.answerText}`;
         if (node?.nodeType === "belief") {
           return node;
         }
-      } catch {
+      } catch (error) {
+        debugGraphPrimitiveFallback(
+          "[epistemicQuestions] Failed to resolve belief node",
+          {
+            error: formatGraphPrimitiveError(error),
+            beliefId: bId
+          }
+        );
         return null;
       }
       return null;
@@ -2332,7 +2468,14 @@ var getInConviction = query({
                   exclusiveWithCount: 0
                 };
               }
-            } catch {
+            } catch (error) {
+              debugGraphPrimitiveFallback(
+                "[epistemicQuestions] Failed to hydrate linked belief",
+                {
+                  error: formatGraphPrimitiveError(error),
+                  beliefId
+                }
+              );
             }
             return null;
           })
@@ -2430,6 +2573,14 @@ var advanceToConviction = mutation({
         triggeringAction: "question_advanced_to_conviction"
       });
     } catch (e) {
+      logQuestionFallback(
+        "[epistemicQuestions] Failed to log advanceToConviction audit",
+        e,
+        {
+          questionId: args.questionId,
+          projectId: node.projectId
+        }
+      );
       console.error("[EpistemicAudit] Failed to log advanceToConviction:", e);
     }
     await markProjectGraphDirty(ctx, node.projectId, node.topicId);
@@ -2556,6 +2707,14 @@ var finalizeConviction = mutation({
         triggeringAction: "question_conviction_finalized"
       });
     } catch (e) {
+      logQuestionFallback(
+        "[epistemicQuestions] Failed to log finalizeConviction audit",
+        e,
+        {
+          questionId: args.questionId,
+          projectId: node.projectId
+        }
+      );
       console.error("[EpistemicAudit] Failed to log finalizeConviction:", e);
     }
     if (node.projectId || node.topicId) {
@@ -2579,6 +2738,15 @@ var finalizeConviction = mutation({
             }
           );
         } catch (e) {
+          logQuestionFallback(
+            "[epistemicQuestions] Failed to schedule evidence creation from scored question",
+            e,
+            {
+              questionId: args.questionId,
+              beliefId,
+              projectId: node.projectId
+            }
+          );
           console.error(
             "[finalizeConviction] Failed to schedule evidence creation:",
             e
@@ -2608,10 +2776,24 @@ var getByBeliefWithAccess = query({
     let beliefNode = null;
     try {
       beliefNode = await ctx.db.get(args.beliefId);
-    } catch {
+    } catch (error) {
+      debugGraphPrimitiveFallback(
+        "[epistemicQuestions] Failed to resolve belief node directly",
+        {
+          error: formatGraphPrimitiveError(error),
+          beliefId: args.beliefId
+        }
+      );
       try {
         beliefNode = await ctx.db.get(args.beliefId);
-      } catch {
+      } catch (legacyError) {
+        debugGraphPrimitiveFallback(
+          "[epistemicQuestions] Failed to resolve legacy belief node",
+          {
+            error: formatGraphPrimitiveError(legacyError),
+            beliefId: args.beliefId
+          }
+        );
         return [];
       }
     }
@@ -2755,10 +2937,24 @@ var linkToBelief = mutation({
     let beliefNode = null;
     try {
       beliefNode = await ctx.db.get(args.beliefId);
-    } catch {
+    } catch (error) {
+      debugGraphPrimitiveFallback(
+        "[epistemicQuestions] Failed to resolve belief node directly",
+        {
+          error: formatGraphPrimitiveError(error),
+          beliefId: args.beliefId
+        }
+      );
       try {
         beliefNode = await ctx.db.get(args.beliefId);
-      } catch {
+      } catch (legacyError) {
+        debugGraphPrimitiveFallback(
+          "[epistemicQuestions] Failed to resolve legacy belief node",
+          {
+            error: formatGraphPrimitiveError(legacyError),
+            beliefId: args.beliefId
+          }
+        );
         throw new Error("Belief not found");
       }
     }
@@ -2819,6 +3015,14 @@ var linkToBelief = mutation({
         });
       }
     } catch (e) {
+      logQuestionFallback(
+        "[epistemicQuestions] Failed to create tests edge",
+        e,
+        {
+          questionId: args.questionId,
+          beliefId: args.beliefId
+        }
+      );
       console.error("[linkToBelief] Failed to create tests edge:", e);
     }
     await markProjectGraphDirty(
@@ -2957,6 +3161,14 @@ var unlinkInsight = mutation({
         }
       }
     } catch (e) {
+      logQuestionFallback(
+        "[epistemicQuestions] Failed to remove questionEvidenceLink",
+        e,
+        {
+          questionId: args.questionId,
+          insightId: args.insightId
+        }
+      );
       console.error(
         "[unlinkInsight] Failed to remove questionEvidenceLink:",
         e
@@ -2979,6 +3191,14 @@ var unlinkInsight = mutation({
         }
       }
     } catch (e) {
+      logQuestionFallback(
+        "[epistemicQuestions] Failed to remove derived edge",
+        e,
+        {
+          questionId: args.questionId,
+          insightId: args.insightId
+        }
+      );
       console.error("[unlinkInsight] Failed to remove edge:", e);
     }
     await markProjectGraphDirty(
@@ -3149,7 +3369,14 @@ var consolidate = mutation({
       args.questionIds.map(async (qid) => {
         try {
           return await ctx.db.get(qid);
-        } catch {
+        } catch (error) {
+          debugGraphPrimitiveFallback(
+            "[epistemicQuestions] Failed to load original question",
+            {
+              error: formatGraphPrimitiveError(error),
+              questionId: qid
+            }
+          );
           return null;
         }
       })
@@ -3210,7 +3437,14 @@ var consolidate = mutation({
           const bMeta = belief.metadata || {};
           category = bMeta.category || bMeta.pillar || "other";
         }
-      } catch {
+      } catch (error) {
+        debugGraphPrimitiveFallback(
+          "[epistemicQuestions] Failed to read first linked belief metadata",
+          {
+            error: formatGraphPrimitiveError(error),
+            beliefId: firstBeliefId
+          }
+        );
       }
     }
     const now = Date.now();
@@ -3260,7 +3494,14 @@ var consolidate = mutation({
             }
           });
         }
-      } catch {
+      } catch (error) {
+        debugGraphPrimitiveFallback(
+          "[epistemicQuestions] Failed to archive linked question",
+          {
+            error: formatGraphPrimitiveError(error),
+            questionId: qid
+          }
+        );
       }
     }
     await ctx.scheduler.runAfter(0, internal.neo4jSync.syncNodeToNeo4j, {
@@ -3392,7 +3633,15 @@ var getQuestionClusterPositions = query({
         projectId: args.projectId,
         topicId: args.topicId
       });
-    } catch {
+    } catch (error) {
+      debugGraphPrimitiveFallback(
+        "[epistemicQuestions] Failed to resolve question cluster scope",
+        {
+          error: formatGraphPrimitiveError(error),
+          projectId: args.projectId,
+          topicId: args.topicId
+        }
+      );
       return {
         positions: {},
         counts: {