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

package/dist/{epistemicHelpers-Bd9xbaib.d.ts → epistemicHelpers-DevrYgPN.d.ts}

@@ -326,4 +326,4 @@ declare namespace epistemicHelpers {
   export { epistemicHelpers_EDGE_LAYER_RULES as EDGE_LAYER_RULES, type epistemicHelpers_EpistemicLayer as EpistemicLayer, epistemicHelpers_LAYER_TRAVERSAL_RULES as LAYER_TRAVERSAL_RULES, type epistemicHelpers_TraversalMode as TraversalMode, type epistemicHelpers_TraversalOptions as TraversalOptions, epistemicHelpers_canTraverseToLayer as canTraverseToLayer, epistemicHelpers_createEdgeForInsightQuestionLink as createEdgeForInsightQuestionLink, epistemicHelpers_createEpistemicEdge as createEpistemicEdge, epistemicHelpers_createEpistemicNodeForArtifact as createEpistemicNodeForArtifact, epistemicHelpers_createEpistemicNodeForBelief as createEpistemicNodeForBelief, epistemicHelpers_createEpistemicNodeForInsight as createEpistemicNodeForInsight, epistemicHelpers_createEpistemicNodeForQuestion as createEpistemicNodeForQuestion, epistemicHelpers_getDefaultEdgeTypesForMode as getDefaultEdgeTypesForMode, epistemicHelpers_getDefaultMinLayer as getDefaultMinLayer, epistemicHelpers_getLayerDepth as getLayerDepth, epistemicHelpers_getNeo4jLabel as getNeo4jLabel, epistemicHelpers_getNeo4jRelType as getNeo4jRelType, epistemicHelpers_getNodeLayer as getNodeLayer, epistemicHelpers_isDeprecatedEdgeType as isDeprecatedEdgeType, epistemicHelpers_isValidLayerConnection as isValidLayerConnection, epistemicHelpers_normalizeConfidence as normalizeConfidence, epistemicHelpers_shouldContinueTraversal as shouldContinueTraversal, epistemicHelpers_validateEdgeLayers as validateEdgeLayers };
 }
 
-export { type EpistemicLayer as E, LAYER_TRAVERSAL_RULES as L, type TraversalMode as T, getLayerDepth as a, type TraversalOptions as b, canTraverseToLayer as c, getDefaultMinLayer as d, epistemicHelpers as e, getDefaultEdgeTypesForMode as f, getNodeLayer as g, EDGE_LAYER_RULES as h, isValidLayerConnection as i, createEpistemicNodeForInsight as j, createEpistemicNodeForBelief as k, createEpistemicNodeForQuestion as l, createEpistemicNodeForArtifact as m, normalizeConfidence as n, createEpistemicEdge as o, createEdgeForInsightQuestionLink as p, shouldContinueTraversal as s, validateEdgeLayers as v };
+export { EDGE_LAYER_RULES as E, LAYER_TRAVERSAL_RULES as L, type TraversalMode as T, type EpistemicLayer as a, type TraversalOptions as b, canTraverseToLayer as c, createEdgeForInsightQuestionLink as d, epistemicHelpers as e, createEpistemicEdge as f, createEpistemicNodeForArtifact as g, createEpistemicNodeForBelief as h, createEpistemicNodeForInsight as i, createEpistemicNodeForQuestion as j, getDefaultEdgeTypesForMode as k, getDefaultMinLayer as l, getLayerDepth as m, getNodeLayer as n, isValidLayerConnection as o, normalizeConfidence as p, shouldContinueTraversal as s, validateEdgeLayers as v };

package/dist/epistemicHelpers.d.ts

@@ -1,4 +1,4 @@
 import './convex.js';
 export { a as getNeo4jLabel, b as getNeo4jRelType, i as isDeprecatedEdgeType } from './graphTypes-CpgIuCdo.js';
-export { h as EDGE_LAYER_RULES, E as EpistemicLayer, L as LAYER_TRAVERSAL_RULES, T as TraversalMode, b as TraversalOptions, c as canTraverseToLayer, p as createEdgeForInsightQuestionLink, o as createEpistemicEdge, m as createEpistemicNodeForArtifact, k as createEpistemicNodeForBelief, j as createEpistemicNodeForInsight, l as createEpistemicNodeForQuestion, f as getDefaultEdgeTypesForMode, d as getDefaultMinLayer, a as getLayerDepth, g as getNodeLayer, i as isValidLayerConnection, n as normalizeConfidence, s as shouldContinueTraversal, v as validateEdgeLayers } from './epistemicHelpers-Bd9xbaib.js';
+export { E as EDGE_LAYER_RULES, a as EpistemicLayer, L as LAYER_TRAVERSAL_RULES, T as TraversalMode, b as TraversalOptions, c as canTraverseToLayer, d as createEdgeForInsightQuestionLink, f as createEpistemicEdge, g as createEpistemicNodeForArtifact, h as createEpistemicNodeForBelief, i as createEpistemicNodeForInsight, j as createEpistemicNodeForQuestion, k as getDefaultEdgeTypesForMode, l as getDefaultMinLayer, m as getLayerDepth, n as getNodeLayer, o as isValidLayerConnection, p as normalizeConfidence, s as shouldContinueTraversal, v as validateEdgeLayers } from './epistemicHelpers-DevrYgPN.js';
 import 'convex/values';

package/dist/{epistemicLinking-CyeLOIzN.d.ts → epistemicLinking-CfE00tHJ.d.ts}

@@ -32,4 +32,4 @@ declare namespace epistemicLinking {
   export { epistemicLinking_linkBeliefToBelief as linkBeliefToBelief, epistemicLinking_linkEvidenceToEvidence as linkEvidenceToEvidence, epistemicLinking_linkQuestionToQuestion as linkQuestionToQuestion };
 }
 
-export { linkQuestionToQuestion as a, linkEvidenceToEvidence as b, epistemicLinking as e, linkBeliefToBelief as l };
+export { linkEvidenceToEvidence as a, linkQuestionToQuestion as b, epistemicLinking as e, linkBeliefToBelief as l };

package/dist/epistemicLinking.d.ts

@@ -1 +1 @@
-export { l as linkBeliefToBelief, b as linkEvidenceToEvidence, a as linkQuestionToQuestion } from './epistemicLinking-CyeLOIzN.js';
+export { l as linkBeliefToBelief, a as linkEvidenceToEvidence, b as linkQuestionToQuestion } from './epistemicLinking-CfE00tHJ.js';

package/dist/epistemicLinking.js

@@ -1,5 +1,5 @@
 import { v } from 'convex/values';
-import { componentsGeneric, mutationGeneric, anyApi } from 'convex/server';
+import { componentsGeneric, anyApi, mutationGeneric } from 'convex/server';
 import { checkProjectAccess } from '@lucern/access-control/access';
 import { permissiveReturn } from '@lucern/contracts/schema-helpers/validators';
 

package/dist/{epistemicNodes-BpD6Koud.d.ts → epistemicNodes-DjSUfvyD.d.ts}

@@ -164,4 +164,4 @@ declare namespace epistemicNodes {
   export { epistemicNodes_archive as archive, epistemicNodes_backfillTopicId as backfillTopicId, epistemicNodes_batchCreate as batchCreate, epistemicNodes_create as create, epistemicNodes_createInternal as createInternal, epistemicNodes_epistemicLayerValidator as epistemicLayerValidator, epistemicNodes_epistemicNodeTypeValidator as epistemicNodeTypeValidator, epistemicNodes_get as get, epistemicNodes_getByContentHash as getByContentHash, epistemicNodes_getByGlobalId as getByGlobalId, epistemicNodes_getByProject as getByProject, epistemicNodes_getByProjectAndType as getByProjectAndType, epistemicNodes_getByProjectAndTypeLite as getByProjectAndTypeLite, epistemicNodes_getByTopic as getByTopic, epistemicNodes_getInternal as getInternal, epistemicNodes_getNodesPendingEdgeSync as getNodesPendingEdgeSync, epistemicNodes_hardDelete as hardDelete, epistemicNodes_l1NodeTypeValidator as l1NodeTypeValidator, epistemicNodes_l2NodeTypeValidator as l2NodeTypeValidator, epistemicNodes_l3NodeTypeValidator as l3NodeTypeValidator, epistemicNodes_l4NodeTypeValidator as l4NodeTypeValidator, epistemicNodes_listAll as listAll, epistemicNodes_nodeTypeValidator as nodeTypeValidator, epistemicNodes_ontologicalNodeTypeValidator as ontologicalNodeTypeValidator, epistemicNodes_organizationalNodeTypeValidator as organizationalNodeTypeValidator, epistemicNodes_search as search, epistemicNodes_sourceTypeValidator as sourceTypeValidator, epistemicNodes_statusValidator as statusValidator, epistemicNodes_supersede as supersede, epistemicNodes_update as update, epistemicNodes_updateSyncStatus as updateSyncStatus, epistemicNodes_verificationStatusValidator as verificationStatusValidator, epistemicNodes_verify as verify };
 }
 
-export { hardDelete as A, verify as B, batchCreate as C, createInternal as D, getInternal as E, updateSyncStatus as F, backfillTopicId as G, getNodesPendingEdgeSync as H, epistemicLayerValidator as a, l3NodeTypeValidator as b, l2NodeTypeValidator as c, l1NodeTypeValidator as d, epistemicNodes as e, epistemicNodeTypeValidator as f, organizationalNodeTypeValidator as g, statusValidator as h, get as i, getByGlobalId as j, getByContentHash as k, l4NodeTypeValidator as l, getByProjectAndType as m, nodeTypeValidator as n, ontologicalNodeTypeValidator as o, getByProjectAndTypeLite as p, getByProject as q, getByTopic as r, sourceTypeValidator as s, listAll as t, search as u, verificationStatusValidator as v, create as w, update as x, supersede as y, archive as z };
+export { search as A, sourceTypeValidator as B, statusValidator as C, supersede as D, update as E, updateSyncStatus as F, verificationStatusValidator as G, verify as H, archive as a, backfillTopicId as b, batchCreate as c, create as d, epistemicNodes as e, createInternal as f, epistemicLayerValidator as g, epistemicNodeTypeValidator as h, get as i, getByContentHash as j, getByGlobalId as k, getByProject as l, getByProjectAndType as m, getByProjectAndTypeLite as n, getByTopic as o, getInternal as p, getNodesPendingEdgeSync as q, hardDelete as r, l1NodeTypeValidator as s, l2NodeTypeValidator as t, l3NodeTypeValidator as u, l4NodeTypeValidator as v, listAll as w, nodeTypeValidator as x, ontologicalNodeTypeValidator as y, organizationalNodeTypeValidator as z };

package/dist/epistemicNodes.d.ts

@@ -1,2 +1,2 @@
 import 'convex/values';
-export { z as archive, G as backfillTopicId, C as batchCreate, w as create, D as createInternal, a as epistemicLayerValidator, f as epistemicNodeTypeValidator, i as get, k as getByContentHash, j as getByGlobalId, q as getByProject, m as getByProjectAndType, p as getByProjectAndTypeLite, r as getByTopic, E as getInternal, H as getNodesPendingEdgeSync, A as hardDelete, d as l1NodeTypeValidator, c as l2NodeTypeValidator, b as l3NodeTypeValidator, l as l4NodeTypeValidator, t as listAll, n as nodeTypeValidator, o as ontologicalNodeTypeValidator, g as organizationalNodeTypeValidator, u as search, s as sourceTypeValidator, h as statusValidator, y as supersede, x as update, F as updateSyncStatus, v as verificationStatusValidator, B as verify } from './epistemicNodes-BpD6Koud.js';
+export { a as archive, b as backfillTopicId, c as batchCreate, d as create, f as createInternal, g as epistemicLayerValidator, h as epistemicNodeTypeValidator, i as get, j as getByContentHash, k as getByGlobalId, l as getByProject, m as getByProjectAndType, n as getByProjectAndTypeLite, o as getByTopic, p as getInternal, q as getNodesPendingEdgeSync, r as hardDelete, s as l1NodeTypeValidator, t as l2NodeTypeValidator, u as l3NodeTypeValidator, v as l4NodeTypeValidator, w as listAll, x as nodeTypeValidator, y as ontologicalNodeTypeValidator, z as organizationalNodeTypeValidator, A as search, B as sourceTypeValidator, C as statusValidator, D as supersede, E as update, F as updateSyncStatus, G as verificationStatusValidator, H as verify } from './epistemicNodes-DjSUfvyD.js';

package/dist/epistemicNodes.js

@@ -1,7 +1,7 @@
 import { v } from 'convex/values';
 import { checkScopeAccess, requireProjectAccess } from '@lucern/access-control/access';
 import { permissiveReturn } from '@lucern/contracts/schema-helpers/validators';
-import { componentsGeneric, queryGeneric, mutationGeneric, anyApi, internalMutationGeneric, internalQueryGeneric } from 'convex/server';
+import { componentsGeneric, anyApi, queryGeneric, mutationGeneric, internalMutationGeneric, internalQueryGeneric } from 'convex/server';
 import { isNodeType, getLayerForNodeType } from '@lucern/contracts/schema-helpers/spine/tables/epistemicNodes';
 
 // src/epistemicNodes.ts
@@ -13,6 +13,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/graphTypes.ts
 function getNodeLayer(nodeType) {
   const L4_TYPES = ["decision"];
@@ -317,7 +329,14 @@ async function findTopicsByScopeAlias(ctx, scopeId) {
       "by_graph_scope_project",
       (q) => q.eq(LEGACY_SCOPE_FIELD, 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);
@@ -334,7 +353,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;
   }
 }
@@ -346,7 +372,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;
   }
 }
@@ -375,8 +408,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));
@@ -413,7 +455,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);
@@ -672,7 +721,15 @@ var getByProjectAndType = query({
         projectId: args.projectId,
         topicId: args.topicId
       });
-    } catch {
+    } catch (error) {
+      debugGraphPrimitiveFallback(
+        "[epistemicNodes] Failed to resolve getByProjectAndType scope",
+        {
+          error,
+          projectId: args.projectId,
+          topicId: args.topicId
+        }
+      );
       return [];
     }
     const pageSize = clampNodeLimit(args.limit);
@@ -709,7 +766,15 @@ var getByProjectAndTypeLite = query({
         projectId: args.projectId,
         topicId: args.topicId
       });
-    } catch {
+    } catch (error) {
+      debugGraphPrimitiveFallback(
+        "[epistemicNodes] Failed to resolve getByNodeType scope",
+        {
+          error,
+          projectId: args.projectId,
+          topicId: args.topicId
+        }
+      );
       return [];
     }
     const pageSize = clampNodeLimit(args.limit);
@@ -741,6 +806,27 @@ function clampNodeLimit(limit, fallback = DEFAULT_NODE_PAGE_SIZE) {
   }
   return Math.max(1, Math.min(Math.floor(limit), MAX_NODE_PAGE_SIZE));
 }
+function buildNodeStatusSuccessResult() {
+  return { success: true };
+}
+function buildNodeArchivedResult() {
+  return {
+    success: true,
+    effectiveStatus: "archived"
+  };
+}
+function buildNodeNotFoundResult() {
+  const result = {};
+  result.success = false;
+  result.error = "Node not found";
+  return result;
+}
+function buildNodeDeletedResult(deletedEdgeCount) {
+  return {
+    success: true,
+    deletedEdgeCount
+  };
+}
 function dedupeWorkspaceNodes(nodes) {
   const seen = /* @__PURE__ */ new Set();
   const deduped = [];
@@ -772,14 +858,13 @@ async function collectScopedNodes(ctx, scope, args) {
       args.nodeType ? ctx.db.query("epistemicNodes").withIndex(
         "by_topic_type",
         (q) => q.eq("topicId", scope.projectId).eq("nodeType", args.nodeType)
-      ).order("desc").take(args.scanLimit) : ctx.db.query("epistemicNodes").withIndex(
-        "by_topic",
-        (q) => q.eq("topicId", scope.projectId)
-      ).order("desc").take(args.scanLimit)
+      ).order("desc").take(args.scanLimit) : ctx.db.query("epistemicNodes").withIndex("by_topic", (q) => q.eq("topicId", scope.projectId)).order("desc").take(args.scanLimit)
     );
   }
   const combined = dedupeWorkspaceNodes((await Promise.all(queries)).flat());
-  return combined.filter((node) => nodeMatchesWorkspaceReasoningScope(node, scope));
+  return combined.filter(
+    (node) => nodeMatchesWorkspaceReasoningScope(node, scope)
+  );
 }
 var getByProject = query({
   args: {
@@ -801,7 +886,15 @@ var getByProject = query({
         projectId: args.projectId,
         topicId: args.topicId
       });
-    } catch {
+    } catch (error) {
+      debugGraphPrimitiveFallback(
+        "[epistemicNodes] Failed to resolve list scope",
+        {
+          error,
+          projectId: args.projectId,
+          topicId: args.topicId
+        }
+      );
       return [];
     }
     if (args.userId) {
@@ -855,7 +948,15 @@ var search = query({
           projectId: args.projectId,
           topicId: args.topicId
         });
-      } catch {
+      } catch (error) {
+        debugGraphPrimitiveFallback(
+          "[epistemicNodes] Failed to resolve search scope",
+          {
+            error,
+            projectId: args.projectId,
+            topicId: args.topicId
+          }
+        );
         return [];
       }
     }
@@ -1082,7 +1183,7 @@ var update = mutation({
       nodeId,
       operation: "upsert"
     });
-    return { success: true };
+    return buildNodeStatusSuccessResult();
   }
 });
 var supersede = mutation({
@@ -1204,7 +1305,7 @@ var archive = mutation({
         projectId: node.projectId
       });
     }
-    return { success: true, effectiveStatus: "archived" };
+    return buildNodeArchivedResult();
   }
 });
 var hardDelete = internalMutation({
@@ -1218,7 +1319,7 @@ var hardDelete = internalMutation({
   handler: async (ctx, args) => {
     const node = await ctx.db.get(args.nodeId);
     if (!node) {
-      return { success: false, error: "Node not found" };
+      return buildNodeNotFoundResult();
     }
     assertBeliefNodeHardDeleteAllowed({
       node,
@@ -1254,10 +1355,7 @@ var hardDelete = internalMutation({
       await ctx.db.delete(edge._id);
     }
     await ctx.db.delete(args.nodeId);
-    return {
-      success: true,
-      deletedEdgeCount: uniqueEdges.size
-    };
+    return buildNodeDeletedResult(uniqueEdges.size);
   }
 });
 var verify = mutation({
@@ -1304,7 +1402,7 @@ var verify = mutation({
       projectId: node.projectId,
       triggeringAction: "epistemicNodes.verify"
     });
-    return { success: true };
+    return buildNodeStatusSuccessResult();
   }
 });
 var batchCreate = mutation({
@@ -1342,6 +1440,27 @@ var batchCreate = mutation({
   },
   returns: permissiveReturn,
   handler: async (ctx, args) => {
+    const resolveNodeScope = async (node) => {
+      if (!(node.topicId || node.projectId)) {
+        return void 0;
+      }
+      try {
+        return await resolveTopicProjectScope(ctx, {
+          topicId: node.topicId,
+          projectId: node.projectId
+        });
+      } catch (error) {
+        debugGraphPrimitiveFallback(
+          "[epistemicNodes] Failed to resolve scope for batch create node",
+          {
+            error,
+            topicId: node.topicId,
+            projectId: node.projectId
+          }
+        );
+        return void 0;
+      }
+    };
     const now = Date.now();
     const results = [];
     for (const node of args.nodes) {
@@ -1350,10 +1469,7 @@ var batchCreate = mutation({
         mutationName: "epistemicNodes.batchCreate"
       });
       const epistemicLayer = getNodeLayer(node.nodeType);
-      const resolvedScope = node.topicId || node.projectId ? await resolveTopicProjectScope(ctx, {
-        topicId: node.topicId,
-        projectId: node.projectId
-      }).catch(() => void 0) : void 0;
+      const resolvedScope = await resolveNodeScope(node);
       const nodeId = await ctx.db.insert("epistemicNodes", {
         ...node,
         epistemicLayer,
@@ -1435,10 +1551,24 @@ var createInternal = internalMutation({
   returns: permissiveReturn,
   handler: async (ctx, args) => {
     const now = Date.now();
-    const resolvedScope = args.topicId || args.projectId ? await resolveTopicProjectScope(ctx, {
-      topicId: args.topicId,
-      projectId: args.projectId
-    }).catch(() => void 0) : void 0;
+    const resolvedScope = args.topicId || args.projectId ? await (async () => {
+      try {
+        return await resolveTopicProjectScope(ctx, {
+          topicId: args.topicId,
+          projectId: args.projectId
+        });
+      } catch (error) {
+        debugGraphPrimitiveFallback(
+          "[epistemicNodes] Failed to resolve create scope",
+          {
+            error,
+            topicId: args.topicId,
+            projectId: args.projectId
+          }
+        );
+        return void 0;
+      }
+    })() : void 0;
     const contentHash = args.contentHash || `${args.nodeType}:${args.canonicalText}`.slice(0, 64);
     const epistemicLayer = args.epistemicLayer || getNodeLayer(args.nodeType);
     const nodeId = await ctx.db.insert("epistemicNodes", {
@@ -1505,7 +1635,7 @@ var updateSyncStatus = internalMutation({
       updates.syncError = args.syncError;
     }
     await ctx.db.patch(args.nodeId, updates);
-    return { success: true };
+    return buildNodeStatusSuccessResult();
   }
 });
 var backfillTopicId = internalMutation({