@lucern/graph-primitives 1.0.22 → 1.0.24

package/dist/epistemicQuestions.create.js

@@ -2,8 +2,9 @@ import { v } from 'convex/values';
 import { checkProjectAccess, checkScopeAccess } from '@lucern/access-control/access';
 import { permissiveReturn } from '@lucern/contracts/schema-helpers/validators';
 import { componentsGeneric, anyApi, mutationGeneric, internalMutationGeneric } from 'convex/server';
-import { generateGlobalId } from '@lucern/contracts/ids';
+import { generateGlobalId, assertUuidV7Identity } from '@lucern/contracts/ids';
 import { isNodeType, getLayerForNodeType } from '@lucern/contracts/schema-helpers/spine/tables/epistemicNodes';
+import '@lucern/contracts';
 
 // src/epistemicQuestions.create.ts
 var api = anyApi;
@@ -53,6 +54,35 @@ async function scheduleEmbeddingGeneration(args) {
   }
 }
 var LEGACY_SCOPE_FIELD = "graphScopeProjectId";
+async function resolveTopicNodeScopeOrNull(ctx, ref) {
+  if (!ctx?.db || typeof ctx.db.query !== "function") {
+    return null;
+  }
+  let node = null;
+  try {
+    const byGlobalId = await ctx.db.query("epistemicNodes").withIndex("by_globalId", (q) => q.eq("globalId", ref)).first();
+    if (byGlobalId && byGlobalId.nodeType === "topic") {
+      node = byGlobalId;
+    }
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[topicScope] topic-node scope lookup by globalId failed",
+      { error, ref }
+    );
+  }
+  if (!node) {
+    return null;
+  }
+  const scopeKey = normalizeScopeValue(node.topicId) ?? normalizeScopeValue(node.globalId);
+  if (!scopeKey) {
+    return null;
+  }
+  return {
+    topicId: scopeKey,
+    projectId: asMappedProjectId(node),
+    source: "topic_node"
+  };
+}
 function asMappedProjectId(topic) {
   if (!topic) {
     return;
@@ -193,6 +223,13 @@ async function resolveTopicProjectScope(ctx, args) {
       ) ?? null;
     }
     if (!topic) {
+      const nodeScope = await resolveTopicNodeScopeOrNull(
+        ctx,
+        String(args.topicId)
+      );
+      if (nodeScope) {
+        return nodeScope;
+      }
       throw new Error(`Topic not found: ${String(args.topicId)}`);
     }
     const inherited = await resolveInheritedWorkspaceScope(ctx, topic);
@@ -263,6 +300,16 @@ async function resolveTopicProjectScope(ctx, args) {
         source: "project_mapped_topic"
       };
     }
+    const nodeScope = await resolveTopicNodeScopeOrNull(
+      ctx,
+      String(args.projectId)
+    );
+    if (nodeScope) {
+      return {
+        ...nodeScope,
+        projectId: nodeScope.projectId ?? String(args.projectId)
+      };
+    }
     throw new Error(
       `Legacy project scope ${String(args.projectId)} has no mapped topic.`
     );
@@ -479,6 +526,9 @@ function materializeTopicProjectOverlay(topic, idMode = "legacy") {
     type: mapProjectType(topic, metadata),
     description: readNonEmptyString(topic.description),
     ownerId: readNonEmptyString(metadata.ownerId) || readNonEmptyString(topic.createdBy) || "system",
+    // FR.7 creator-grant: surface the principal-shaped owner field (column-first,
+    // metadata fallback for legacy rows that recorded it in metadata).
+    ownerPrincipalId: readNonEmptyString(topic.ownerPrincipalId) || readNonEmptyString(metadata.ownerPrincipalId),
     sharedWith: readStringArray(metadata.sharedWith),
     visibility,
     tenantId: readNonEmptyString(topic.tenantId) || readNonEmptyString(metadata.tenantId),
@@ -748,6 +798,10 @@ function buildLinkedWorktreeMetadata(linkedWorktreeId) {
     linkedWorktreeId
   } : {};
 }
+async function insertEpistemicNode(ctx, doc) {
+  assertUuidV7Identity("epistemicNodes", doc.globalId);
+  return ctx.db.insert("epistemicNodes", doc);
+}
 
 // src/epistemicQuestions.create.ts
 var create = mutation({
@@ -821,7 +875,7 @@ var create = mutation({
     const globalId = generateGlobalId();
     const contentHash = generateContentHash(args.question);
     const category = normalizeCategory(args.category);
-    const nodeId = await ctx.db.insert("epistemicNodes", {
+    const nodeId = await insertEpistemicNode(ctx, {
       globalId,
       topicId: scope.topicId,
       projectId: scope.projectId,
@@ -989,7 +1043,7 @@ var createBatch = mutation({
       const globalId = generateGlobalId();
       const contentHash = generateContentHash(q.question);
       const category = normalizeCategory(q.category);
-      const nodeId = await ctx.db.insert("epistemicNodes", {
+      const nodeId = await insertEpistemicNode(ctx, {
         globalId,
         topicId: scope.topicId,
         projectId: scope.projectId,
@@ -1041,7 +1095,7 @@ var createBatch = mutation({
         const beliefNode = await ctx.db.get(q.linkedBeliefNodeId);
         if (beliefNode) {
           await ctx.scheduler.runAfter(0, internal.neo4jEdgeAPI.createEdge, {
-            globalId: crypto.randomUUID(),
+            globalId: generateGlobalId(),
             fromGlobalId: beliefNode.globalId,
             toGlobalId: globalId,
             edgeType: "tests",
@@ -1105,7 +1159,7 @@ var internalCreate = internalMutation({
     const globalId = generateGlobalId();
     const contentHash = generateContentHash(args.question);
     const category = normalizeCategory(args.category);
-    const nodeId = await ctx.db.insert("epistemicNodes", {
+    const nodeId = await insertEpistemicNode(ctx, {
       globalId,
       topicId: scope.topicId,
       projectId: scope.projectId,
@@ -1137,7 +1191,7 @@ var internalCreate = internalMutation({
       const beliefNode = await ctx.db.get(args.linkedBeliefNodeId);
       if (beliefNode) {
         await ctx.scheduler.runAfter(0, internal.neo4jEdgeAPI.createEdge, {
-          globalId: crypto.randomUUID(),
+          globalId: generateGlobalId(),
           fromGlobalId: beliefNode.globalId,
           toGlobalId: globalId,
           edgeType: "tests",
@@ -1208,7 +1262,7 @@ var addQuestion = mutation({
     const contentHash = generateContentHash(args.question);
     const category = normalizeCategory(args.category);
     const additionalMetadata = args.metadata && typeof args.metadata === "object" ? args.metadata : {};
-    const nodeId = await ctx.db.insert("epistemicNodes", {
+    const nodeId = await insertEpistemicNode(ctx, {
       globalId,
       topicId: scope.topicId,
       projectId: scope.projectId,