@lucern/graph-primitives 1.0.29 → 1.0.31

package/dist/epistemicQuestions.create.js

@@ -1,15 +1,19 @@
-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 { v } from 'convex/values';
+import { unsafeConvexAnyApi } from '@lucern/contracts/convex/unsafeAnyApi';
+import { componentsGeneric, mutationGeneric, internalMutationGeneric } from 'convex/server';
+import '@lucern/contracts';
 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;
+var unsafeApi = unsafeConvexAnyApi(
+  "graph-primitives top-level module bundle lacks a committed Convex _generated/api surface"
+);
+var api = unsafeApi;
 componentsGeneric();
-var internal = anyApi;
+var internal = unsafeApi;
 var internalMutation = internalMutationGeneric;
 var mutation = mutationGeneric;
 
@@ -26,22 +30,19 @@ function debugGraphPrimitiveFallback(message, context) {
 }
 
 // src/embeddingTrigger.ts
+var embeddingActionRef = "embeddingActions:generateEpistemicNodeEmbedding";
 async function scheduleEmbeddingGeneration(args) {
   try {
-    await args.ctx.scheduler.runAfter(
-      0,
-      "embeddingActions:generateEpistemicNodeEmbedding",
-      {
-        nodeId: args.nodeId,
-        projectId: args.projectId ? String(args.projectId) : void 0,
-        topicId: args.topicId ? String(args.topicId) : void 0,
-        createdBy: args.createdBy,
-        nodeType: args.nodeType,
-        text: args.text.slice(0, 2e4),
-        hasAnswer: args.hasAnswer,
-        confidence: args.confidence
-      }
-    );
+    await args.ctx.scheduler.runAfter(0, embeddingActionRef, {
+      nodeId: args.nodeId,
+      projectId: args.projectId ? String(args.projectId) : void 0,
+      topicId: args.topicId ? String(args.topicId) : void 0,
+      createdBy: args.createdBy,
+      nodeType: args.nodeType,
+      text: args.text.slice(0, 2e4),
+      hasAnswer: args.hasAnswer,
+      confidence: args.confidence
+    });
   } catch (error) {
     debugGraphPrimitiveFallback(
       "[embeddingTrigger] Failed to schedule embedding generation",
@@ -53,348 +54,13 @@ 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;
-  }
-  const directLegacyProjectId = normalizeScopeValue(topic[LEGACY_SCOPE_FIELD]);
-  if (directLegacyProjectId) {
-    return directLegacyProjectId;
-  }
-  const metadata = topic.metadata || {};
-  const candidate = metadata[LEGACY_SCOPE_FIELD] || metadata.legacyProjectId || metadata.projectId || metadata.scopeProjectId;
-  return candidate ? candidate : void 0;
-}
-function normalizeScopeValue(value) {
-  if (typeof value !== "string") {
-    return;
-  }
-  const normalized = value.trim();
-  return normalized.length > 0 ? normalized : void 0;
-}
-function pickPrimaryTopic(candidates) {
-  return [...candidates].sort((a, b) => {
-    const depthA = a.depth ?? 9999;
-    const depthB = b.depth ?? 9999;
-    if (depthA !== depthB) {
-      return depthA - depthB;
-    }
-    const createdA = a.createdAt ?? Number.MAX_SAFE_INTEGER;
-    const createdB = b.createdAt ?? Number.MAX_SAFE_INTEGER;
-    if (createdA !== createdB) {
-      return createdA - createdB;
-    }
-    return String(a.name || "").localeCompare(String(b.name || ""));
-  })[0];
-}
-async function findTopicsByScopeAlias(ctx, scopeId) {
-  try {
-    return await ctx.db.query("topics").withIndex(
-      "by_graph_scope_project",
-      (q) => q.eq(LEGACY_SCOPE_FIELD, scopeId)
-    ).collect();
-  } 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);
-      const mappedProjectId = asMappedProjectId(topic);
-      return String(topic._id) === scopeId || normalizedGlobalId === scopeId || mappedProjectId === scopeId;
-    });
-  }
-}
-async function tryResolveHostTopicById(ctx, topicId) {
-  if (typeof ctx.runQuery !== "function") {
-    return null;
-  }
-  try {
-    return await ctx.runQuery(api.topics.get, {
-      id: topicId
-    }) ?? null;
-  } catch (error) {
-    debugGraphPrimitiveFallback(
-      "[topicScope] Failed to resolve topic by host query",
-      {
-        error,
-        topicId
-      }
-    );
-    return null;
-  }
-}
-async function tryResolveHostTopicByLegacyScope(ctx, legacyScopeId) {
-  if (typeof ctx.runQuery !== "function") {
-    return null;
-  }
-  try {
-    return await ctx.runQuery(api.topics.getByLegacyScopeId, {
-      projectId: legacyScopeId
-    }) ?? null;
-  } catch (error) {
-    debugGraphPrimitiveFallback(
-      "[topicScope] Failed to resolve topic by legacy scope",
-      {
-        error,
-        legacyScopeId
-      }
-    );
-    return null;
-  }
-}
-async function resolveInheritedWorkspaceScope(ctx, topic) {
-  const MAX_DEPTH = 10;
-  let tenantId = normalizeScopeValue(topic.tenantId);
-  let workspaceId = normalizeScopeValue(topic.workspaceId);
-  if (tenantId && workspaceId) {
-    return { tenantId, workspaceId };
-  }
-  let current = topic;
-  for (let i = 0; i < MAX_DEPTH && current?.parentTopicId; i++) {
-    current = await ctx.db.get(current.parentTopicId);
-    if (!current) break;
-    if (!tenantId) {
-      tenantId = normalizeScopeValue(current.tenantId);
-    }
-    if (!workspaceId) {
-      workspaceId = normalizeScopeValue(current.workspaceId);
-    }
-    if (tenantId && workspaceId) break;
-  }
-  return { tenantId, workspaceId };
-}
-async function resolveTopicProjectScope(ctx, args) {
-  if (args.topicId) {
-    let topic = null;
-    try {
-      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));
-    }
-    if (!topic) {
-      topic = pickPrimaryTopic(
-        await findTopicsByScopeAlias(ctx, String(args.topicId))
-      ) ?? 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);
-    const mapped = asMappedProjectId(topic);
-    if (mapped) {
-      return {
-        topicId: topic._id,
-        projectId: mapped,
-        tenantId: inherited.tenantId,
-        workspaceId: inherited.workspaceId,
-        source: "topic"
-      };
-    }
-    return {
-      topicId: topic._id,
-      tenantId: inherited.tenantId,
-      workspaceId: inherited.workspaceId,
-      source: "topic"
-    };
-  }
-  if (args.projectId) {
-    let directTopic = null;
-    try {
-      directTopic = await ctx.db.get(
-        args.projectId
-      );
-    } catch (error) {
-      debugGraphPrimitiveFallback(
-        "[topicScope] Failed to load direct project topic",
-        {
-          error,
-          projectId: args.projectId
-        }
-      );
-    }
-    if (directTopic) {
-      const inherited = await resolveInheritedWorkspaceScope(ctx, directTopic);
-      const mapped = asMappedProjectId(directTopic);
-      return {
-        topicId: directTopic._id,
-        projectId: mapped ?? args.projectId,
-        tenantId: inherited.tenantId,
-        workspaceId: inherited.workspaceId,
-        source: "topic_inferred"
-      };
-    }
-    directTopic = await tryResolveHostTopicByLegacyScope(ctx, args.projectId);
-    if (directTopic) {
-      const inherited = await resolveInheritedWorkspaceScope(ctx, directTopic);
-      const mapped = asMappedProjectId(directTopic);
-      return {
-        topicId: directTopic._id,
-        projectId: mapped ?? args.projectId,
-        tenantId: inherited.tenantId,
-        workspaceId: inherited.workspaceId,
-        source: "topic_inferred"
-      };
-    }
-    const topics = await findTopicsByScopeAlias(ctx, args.projectId);
-    const primary = pickPrimaryTopic(topics);
-    if (primary) {
-      const inherited = await resolveInheritedWorkspaceScope(ctx, primary);
-      return {
-        topicId: primary._id,
-        projectId: args.projectId,
-        tenantId: inherited.tenantId,
-        workspaceId: inherited.workspaceId,
-        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.`
-    );
-  }
-  throw new Error(
-    "Missing scope: provide topicId (preferred) or legacy projectId alias."
-  );
-}
-var optionalScopeArgs = {
-  projectId: v.optional(v.string()),
-  topicId: v.optional(v.string())
-};
-function normalizeScopeValue2(value) {
-  if (typeof value !== "string") {
-    return;
-  }
-  const normalized = value.trim();
-  return normalized.length > 0 ? normalized : void 0;
-}
-function throwWorkspaceIsolationError(args) {
-  const error = new Error(args.message);
-  error.status = 409;
-  error.code = "INVARIANT_VIOLATION";
-  error.invariantCode = args.invariantCode;
-  error.suggestion = args.suggestion;
-  error.details = args.details;
-  throw error;
-}
-function assertWorkspaceScopedEpistemicNodeScope(args) {
-  const layer = isNodeType(args.nodeType) ? getLayerForNodeType(args.nodeType) : void 0;
-  if (layer === "ontological") {
-    return;
-  }
-  const workspaceId = normalizeScopeValue2(args.scope.workspaceId);
-  if (workspaceId) {
-    return;
-  }
-  throwWorkspaceIsolationError({
-    message: "Workspace-scoped reasoning isolation requires workspaceId on non-ontological node creation.",
-    invariantCode: "workspace.scope_required_for_epistemic_nodes",
-    suggestion: "Resolve the topic/project scope through a workspace-bound topic before creating epistemic nodes.",
-    details: {
-      mutationName: args.mutationName,
-      nodeType: args.nodeType,
-      topicId: args.scope.topicId,
-      projectId: args.scope.projectId
-    }
-  });
-}
-function resolveRuntimePackMutationContext(args) {
-  if (!args.runtimeToolName && !args.runtimePackKey && !args.runtimePackInstallScope) {
-    return;
-  }
-  return {
-    toolName: args.runtimeToolName,
-    packKey: args.runtimePackKey,
-    packInstallScope: args.runtimePackInstallScope
-  };
-}
-function assertTenantPackWorkspaceMutationAllowed(args) {
-  if (!args.runtime?.packKey || args.runtime.packInstallScope !== "tenant") {
-    return;
-  }
-  const targetWorkspaceId = normalizeScopeValue2(args.target.workspaceId);
-  const targetLayer = typeof args.target.epistemicLayer === "string" ? args.target.epistemicLayer : void 0;
-  if (!targetWorkspaceId || targetLayer === "ontological") {
-    return;
-  }
-  throwWorkspaceIsolationError({
-    message: `Tenant-scoped pack "${args.runtime.packKey}" cannot mutate workspace-scoped reasoning state.`,
-    invariantCode: "workspace.tenant_pack_reasoning_write_forbidden",
-    suggestion: "Use a workspace-scoped pack for workspace-local graph mutations, or route the change through tenant-global canonical entity flows.",
-    details: {
-      mutationName: args.mutationName,
-      toolName: args.runtime.toolName,
-      packKey: args.runtime.packKey,
-      targetWorkspaceId,
-      targetNodeType: args.target.nodeType,
-      targetLayer
-    }
-  });
+function insertEpistemicNode(ctx, doc) {
+  assertUuidV7Identity("epistemicNodes", doc.globalId);
+  return ctx.db.insert("epistemicNodes", doc);
 }
 
 // src/topicProjectOverlay.ts
-var LEGACY_SCOPE_FIELD2 = "graphScopeProjectId";
+var LEGACY_SCOPE_FIELD = "graphScopeProjectId";
 function readNonEmptyString(value) {
   if (typeof value !== "string") {
     return;
@@ -411,11 +77,15 @@ function readStringArray(value) {
 function readMetadata(topic) {
   return topic.metadata && typeof topic.metadata === "object" ? topic.metadata : {};
 }
+function omitMetadataKey(metadata, key) {
+  const { [key]: _omitted, ...rest } = metadata;
+  return rest;
+}
 function readLegacyProjectId(value) {
   if (!value) {
     return;
   }
-  return readNonEmptyString(value[LEGACY_SCOPE_FIELD2]);
+  return readNonEmptyString(value[LEGACY_SCOPE_FIELD]);
 }
 function coerceVisibility(value) {
   return value === "private" || value === "team" || value === "firm" || value === "external" || value === "public" ? value : void 0;
@@ -491,9 +161,12 @@ async function resolveTopicDoc(ctx, scopeId) {
     );
   }
   try {
-    const topic = await ctx.runQuery(api.topics.getByLegacyScopeId, {
-      projectId: String(scopeId)
-    });
+    const topic = await ctx.runQuery(
+      api.topics.getByLegacyScopeId,
+      {
+        projectId: String(scopeId)
+      }
+    );
     if (topic?.name !== void 0 && topic?.type !== void 0) {
       return topic;
     }
@@ -513,8 +186,18 @@ function materializeTopicProjectOverlay(topic, idMode = "legacy") {
   const outwardId = idMode === "topic" ? topicId : storageProjectId;
   const visibility = coerceVisibility(topic.visibility) || coerceVisibility(metadata.visibility) || "private";
   const status = coerceStatus(topic.status) || coerceStatus(metadata.status) || "active";
-  const createdAt = typeof topic.createdAt === "number" ? topic.createdAt : typeof topic._creationTime === "number" ? topic._creationTime : 0;
-  const updatedAt = typeof topic.updatedAt === "number" ? topic.updatedAt : typeof metadata.updatedAt === "number" ? metadata.updatedAt : createdAt;
+  let createdAt = 0;
+  if (typeof topic.createdAt === "number") {
+    createdAt = topic.createdAt;
+  } else if (typeof topic._creationTime === "number") {
+    createdAt = topic._creationTime;
+  }
+  let updatedAt = createdAt;
+  if (typeof topic.updatedAt === "number") {
+    updatedAt = topic.updatedAt;
+  } else if (typeof metadata.updatedAt === "number") {
+    updatedAt = metadata.updatedAt;
+  }
   return {
     ...metadata,
     _id: outwardId,
@@ -574,167 +257,445 @@ async function listTopicProjectOverlays(ctx, options = {}) {
   if (allTopics.length === 0 && typeof ctx.runQuery === "function") {
     allTopics = (await ctx.runQuery(api.topics.list, {}) ?? []) || [];
   }
-  return allTopics.filter(
-    (topic) => options.projectLikeOnly === false || isProjectLikeTopic(topic)
-  ).map((topic) => materializeTopicProjectOverlay(topic, options.idMode));
+  return allTopics.filter(
+    (topic) => options.projectLikeOnly === false || isProjectLikeTopic(topic)
+  ).map((topic) => materializeTopicProjectOverlay(topic, options.idMode));
+}
+async function patchTopicProjectOverlay(ctx, scopeId, value) {
+  const topic = await resolveTopicDoc(ctx, scopeId);
+  if (!topic) {
+    return null;
+  }
+  const plan = buildTopicProjectOverlayPatchPlan(topic, value);
+  await applyTopicProjectOverlayPatch(ctx, topic, plan);
+  return materializeTopicProjectOverlay({
+    ...topic,
+    ...plan.patch,
+    metadata: plan.nextMetadata
+  });
+}
+function buildTopicProjectOverlayPatchPlan(topic, value) {
+  const plan = {
+    nextMetadata: { ...readMetadata(topic) },
+    patch: {},
+    topicUpdateArgs: {
+      id: String(topic._id)
+    }
+  };
+  for (const [key, rawValue] of Object.entries(value)) {
+    applyTopicProjectOverlayPatchEntry(plan, key, rawValue);
+  }
+  plan.patch.updatedAt = Date.now();
+  plan.patch.metadata = plan.nextMetadata;
+  plan.topicUpdateArgs.metadata = plan.nextMetadata;
+  return plan;
+}
+function applyTopicProjectOverlayPatchEntry(plan, key, rawValue) {
+  switch (key) {
+    case "_id":
+    case "projectId":
+    case "topicId":
+    case "legacyProjectId":
+    case "storageProjectId":
+    case "updatedAt":
+    case "createdAt":
+      return;
+    case "name":
+    case "description":
+      plan.patch[key] = rawValue;
+      plan.topicUpdateArgs[key] = rawValue;
+      return;
+    case "tenantId":
+    case "workspaceId":
+    case "ownerId":
+      throw new Error(
+        `patchTopicProjectOverlay cannot mutate ${key} via component-owned topics`
+      );
+    case "status":
+      applyTopicStatusPatch(plan, rawValue);
+      return;
+    case "visibility":
+      applyTopicVisibilityPatch(plan, rawValue);
+      return;
+    case "type":
+      applyTopicProjectTypePatch(plan, rawValue);
+      return;
+    default:
+      applyTopicMetadataPatch(plan, key, rawValue);
+  }
+}
+function applyTopicStatusPatch(plan, rawValue) {
+  const status = coerceStatus(rawValue);
+  if (status) {
+    plan.patch.status = status;
+    plan.topicUpdateArgs.status = status;
+  }
+}
+function applyTopicVisibilityPatch(plan, rawValue) {
+  const visibility = coerceVisibility(rawValue);
+  if (visibility) {
+    plan.patch.visibility = visibility;
+    plan.topicUpdateArgs.visibility = visibility;
+  }
+}
+function applyTopicProjectTypePatch(plan, rawValue) {
+  const projectType = readNonEmptyString(rawValue);
+  if (projectType) {
+    plan.nextMetadata.projectType = projectType;
+    return;
+  }
+  plan.nextMetadata = omitMetadataKey(plan.nextMetadata, "projectType");
+}
+function applyTopicMetadataPatch(plan, key, rawValue) {
+  if (rawValue === void 0) {
+    plan.nextMetadata = omitMetadataKey(plan.nextMetadata, key);
+    return;
+  }
+  plan.nextMetadata[key] = rawValue;
+}
+async function applyTopicProjectOverlayPatch(ctx, topic, plan) {
+  if (typeof ctx.runMutation === "function") {
+    try {
+      await ctx.runMutation(api.topics.update, plan.topicUpdateArgs);
+    } catch (error) {
+      if (!canPatchTopicViaLocalDb(ctx, error)) {
+        throw error;
+      }
+      await ctx.db.patch(topic._id, plan.patch);
+    }
+  } else if (ctx?.db && typeof ctx.db.patch === "function") {
+    await ctx.db.patch(topic._id, plan.patch);
+  } else {
+    throw new Error(
+      "Cannot patch topic without component adapter (ctx.runMutation unavailable)"
+    );
+  }
+}
+function canPatchTopicViaLocalDb(ctx, error) {
+  return isMissingLucernChildComponentError(error) && Boolean(ctx?.db) && typeof ctx.db?.patch === "function";
+}
+
+// src/resolvers.ts
+function isMissingLucernChildComponentError2(error) {
+  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"]);
+  const keys = Object.keys(value);
+  return keys.length > 0 && keys.every((key) => advisoryKeys.has(key));
+}
+async function patchProjectWithTolerance(ctx, projectId, value) {
+  try {
+    await patchTopicProjectOverlay(ctx, projectId, value);
+  } catch (error) {
+    if (!(isAdvisoryTopicPatch(value) && isMissingLucernChildComponentError2(error))) {
+      throw error;
+    }
+    console.warn(
+      "[lucern graph-primitives] Non-fatal advisory topic patch failure",
+      {
+        projectId,
+        keys: Object.keys(value),
+        error: getErrorMessage2(error)
+      }
+    );
+  }
+}
+function defaultResolvers() {
+  return {
+    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 = {};
+function resolveGraphPrimitivesAppResolvers(_ctx) {
+  return {
+    ...defaultResolvers(),
+    ...resolverOverrides
+  };
+}
+var LEGACY_SCOPE_FIELD2 = "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;
+  }
+  const directLegacyProjectId = normalizeScopeValue(
+    topic[LEGACY_SCOPE_FIELD2]
+  );
+  if (directLegacyProjectId) {
+    return directLegacyProjectId;
+  }
+  const metadata = topic.metadata || {};
+  const candidate = metadata[LEGACY_SCOPE_FIELD2] || metadata.legacyProjectId || metadata.projectId || metadata.scopeProjectId;
+  return typeof candidate === "string" ? normalizeScopeValue(candidate) : void 0;
+}
+function normalizeScopeValue(value) {
+  if (typeof value !== "string") {
+    return;
+  }
+  const normalized = value.trim();
+  return normalized.length > 0 ? normalized : void 0;
+}
+function pickPrimaryTopic(candidates) {
+  return [...candidates].sort((a, b) => {
+    const depthA = a.depth ?? 9999;
+    const depthB = b.depth ?? 9999;
+    if (depthA !== depthB) {
+      return depthA - depthB;
+    }
+    const createdA = a.createdAt ?? Number.MAX_SAFE_INTEGER;
+    const createdB = b.createdAt ?? Number.MAX_SAFE_INTEGER;
+    if (createdA !== createdB) {
+      return createdA - createdB;
+    }
+    return String(a.name || "").localeCompare(String(b.name || ""));
+  })[0];
+}
+async function findTopicsByScopeAlias(ctx, scopeId) {
+  const query2 = ctx.db.query("topics");
+  try {
+    return await query2.withIndex(
+      "by_graph_scope_project",
+      (q) => q.eq(LEGACY_SCOPE_FIELD2, scopeId)
+    ).collect();
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[topicScope] Failed to resolve scope alias via index",
+      {
+        error,
+        scopeId
+      }
+    );
+    const topics = await query2.collect();
+    return topics.filter((topic) => {
+      const normalizedGlobalId = normalizeScopeValue(topic.globalId);
+      const mappedProjectId = asMappedProjectId(topic);
+      return String(topic._id) === scopeId || normalizedGlobalId === scopeId || mappedProjectId === scopeId;
+    });
+  }
+}
+async function tryResolveHostTopicById(ctx, topicId) {
+  if (typeof ctx.runQuery !== "function") {
+    return null;
+  }
+  try {
+    return await ctx.runQuery(api.topics.get, {
+      id: topicId
+    }) ?? null;
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[topicScope] Failed to resolve topic by host query",
+      {
+        error,
+        topicId
+      }
+    );
+    return null;
+  }
+}
+async function tryResolveHostTopicByLegacyScope(ctx, legacyScopeId) {
+  if (typeof ctx.runQuery !== "function") {
+    return null;
+  }
+  try {
+    return await ctx.runQuery(api.topics.getByLegacyScopeId, {
+      projectId: legacyScopeId
+    }) ?? null;
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[topicScope] Failed to resolve topic by legacy scope",
+      {
+        error,
+        legacyScopeId
+      }
+    );
+    return null;
+  }
+}
+async function resolveInheritedWorkspaceScope(ctx, topic) {
+  const MAX_DEPTH = 10;
+  let tenantId = normalizeScopeValue(topic.tenantId);
+  let workspaceId = normalizeScopeValue(topic.workspaceId);
+  if (tenantId && workspaceId) {
+    return { tenantId, workspaceId };
+  }
+  let current = topic;
+  for (let i = 0; i < MAX_DEPTH && current?.parentTopicId; i++) {
+    current = await ctx.db.get(current.parentTopicId);
+    if (!current) {
+      break;
+    }
+    if (!tenantId) {
+      tenantId = normalizeScopeValue(current.tenantId);
+    }
+    if (!workspaceId) {
+      workspaceId = normalizeScopeValue(current.workspaceId);
+    }
+    if (tenantId && workspaceId) {
+      break;
+    }
+  }
+  return { tenantId, workspaceId };
+}
+async function resolveTopicProjectScope(ctx, args) {
+  if (args.topicId) {
+    return await resolveScopeFromTopicId(ctx, args.topicId);
+  }
+  if (args.projectId) {
+    return await resolveScopeFromLegacyProjectId(ctx, args.projectId);
+  }
+  throw new Error(
+    "Missing scope: provide topicId (preferred) or legacy projectId alias."
+  );
 }
-async function patchTopicProjectOverlay(ctx, scopeId, value) {
-  const topic = await resolveTopicDoc(ctx, scopeId);
-  if (!topic) {
-    return null;
-  }
-  const nextMetadata = { ...readMetadata(topic) };
-  const patch = {};
-  const topicUpdateArgs = {
-    id: String(topic._id)
-  };
-  for (const [key, rawValue] of Object.entries(value)) {
-    switch (key) {
-      case "_id":
-      case "projectId":
-      case "topicId":
-      case "legacyProjectId":
-      case "storageProjectId":
-        break;
-      case "name":
-      case "description":
-        patch[key] = rawValue;
-        topicUpdateArgs[key] = rawValue;
-        break;
-      case "tenantId":
-      case "workspaceId":
-      case "ownerId":
-        throw new Error(
-          `patchTopicProjectOverlay cannot mutate ${key} via component-owned topics`
-        );
-      case "status": {
-        const status = coerceStatus(rawValue);
-        if (status) {
-          patch.status = status;
-          topicUpdateArgs.status = status;
-        }
-        break;
-      }
-      case "visibility": {
-        const visibility = coerceVisibility(rawValue);
-        if (visibility) {
-          patch.visibility = visibility;
-          topicUpdateArgs.visibility = visibility;
-        }
-        break;
-      }
-      case "type": {
-        const projectType = readNonEmptyString(rawValue);
-        if (projectType) {
-          nextMetadata.projectType = projectType;
-        } else {
-          delete nextMetadata.projectType;
-        }
-        break;
-      }
-      case "updatedAt":
-      case "createdAt":
-        break;
-      default:
-        if (rawValue === void 0) {
-          delete nextMetadata[key];
-        } else {
-          nextMetadata[key] = rawValue;
-        }
-    }
+async function resolveScopeFromTopicId(ctx, topicId) {
+  const topic = await resolveTopicDocFromTopicId(ctx, topicId);
+  if (topic) {
+    return await buildTopicScope(ctx, topic, "topic");
   }
-  patch.updatedAt = Date.now();
-  patch.metadata = nextMetadata;
-  topicUpdateArgs.metadata = nextMetadata;
-  if (typeof ctx.runMutation === "function") {
-    try {
-      await ctx.runMutation(api.topics.update, topicUpdateArgs);
-    } catch (error) {
-      if (!isMissingLucernChildComponentError(error) || !ctx?.db || typeof ctx.db.patch !== "function") {
-        throw error;
-      }
-      await ctx.db.patch(String(topic._id), patch);
-    }
-  } else if (ctx?.db && typeof ctx.db.patch === "function") {
-    await ctx.db.patch(String(topic._id), patch);
-  } else {
-    throw new Error(
-      "Cannot patch topic without component adapter (ctx.runMutation unavailable)"
-    );
+  const nodeScope = await resolveTopicNodeScopeOrNull(ctx, String(topicId));
+  if (nodeScope) {
+    return nodeScope;
   }
-  return materializeTopicProjectOverlay({
-    ...topic,
-    ...patch,
-    metadata: nextMetadata
-  });
+  throw new Error(`Topic not found: ${String(topicId)}`);
 }
-
-// src/resolvers.ts
-function isMissingLucernChildComponentError2(error) {
-  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");
+async function resolveTopicDocFromTopicId(ctx, topicId) {
+  const direct = await tryReadTopicDoc(ctx, topicId, {
+    failureLog: "[topicScope] Failed to load topic by direct id",
+    idLogKey: "topicId"
+  });
+  if (direct) {
+    return direct;
+  }
+  const hostTopic = await tryResolveHostTopicById(ctx, String(topicId));
+  if (hostTopic) {
+    return hostTopic;
+  }
+  return pickPrimaryTopic(await findTopicsByScopeAlias(ctx, String(topicId))) ?? null;
 }
-function getErrorMessage2(error) {
-  if (error instanceof Error) {
-    return error.message;
+async function resolveScopeFromLegacyProjectId(ctx, legacyProjectId) {
+  const directTopic = await resolveDirectLegacyProjectTopic(
+    ctx,
+    legacyProjectId
+  );
+  if (directTopic) {
+    return await buildTopicScope(ctx, directTopic, "topic_inferred", {
+      fallbackProjectId: legacyProjectId
+    });
   }
-  if (typeof error === "object" && error !== null && "message" in error && typeof error.message === "string") {
-    return error.message;
+  const primary = pickPrimaryTopic(
+    await findTopicsByScopeAlias(ctx, legacyProjectId)
+  );
+  if (primary) {
+    return await buildTopicScope(ctx, primary, "project_mapped_topic", {
+      fallbackProjectId: legacyProjectId
+    });
   }
-  return "unknown error";
+  const nodeScope = await resolveTopicNodeScopeOrNull(ctx, legacyProjectId);
+  if (nodeScope) {
+    return {
+      ...nodeScope,
+      projectId: nodeScope.projectId ?? legacyProjectId
+    };
+  }
+  throw new Error(
+    `Legacy project scope ${legacyProjectId} has no mapped topic.`
+  );
 }
-function isAdvisoryTopicPatch(value) {
-  const advisoryKeys = /* @__PURE__ */ new Set(["lastActivityAt", "updatedAt"]);
-  const keys = Object.keys(value);
-  return keys.length > 0 && keys.every((key) => advisoryKeys.has(key));
+async function resolveDirectLegacyProjectTopic(ctx, legacyProjectId) {
+  const directTopic = await tryReadTopicDoc(ctx, legacyProjectId, {
+    failureLog: "[topicScope] Failed to load direct project topic",
+    idLogKey: "projectId"
+  });
+  return directTopic ?? tryResolveHostTopicByLegacyScope(ctx, legacyProjectId);
 }
-async function patchProjectWithTolerance(ctx, projectId, value) {
+async function tryReadTopicDoc(ctx, id, log) {
   try {
-    await patchTopicProjectOverlay(ctx, projectId, value);
+    return await ctx.db.get(id);
   } catch (error) {
-    if (!isAdvisoryTopicPatch(value) || !isMissingLucernChildComponentError2(error)) {
-      throw error;
-    }
-    console.warn(
-      "[lucern graph-primitives] Non-fatal advisory topic patch failure",
-      {
-        projectId,
-        keys: Object.keys(value),
-        error: getErrorMessage2(error)
-      }
-    );
+    debugGraphPrimitiveFallback(log.failureLog, {
+      error,
+      [log.idLogKey]: id
+    });
+    return null;
   }
 }
-function defaultResolvers() {
-  return {
-    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 = {};
-function resolveGraphPrimitivesAppResolvers(_ctx) {
+async function buildTopicScope(ctx, topic, source, options = {}) {
+  const inherited = await resolveInheritedWorkspaceScope(ctx, topic);
+  const mapped = asMappedProjectId(topic);
   return {
-    ...defaultResolvers(),
-    ...resolverOverrides
+    topicId: topic._id,
+    ...mapped || options.fallbackProjectId ? { projectId: mapped ?? options.fallbackProjectId } : {},
+    tenantId: inherited.tenantId,
+    workspaceId: inherited.workspaceId,
+    source
   };
 }
+var optionalScopeArgs = {
+  projectId: v.optional(v.string()),
+  topicId: v.optional(v.string())
+};
 
 // src/epistemicQuestions.helpers.ts
 function generateContentHash(text) {
   const content = `question:${text.trim().toLowerCase().replace(/\s+/g, " ")}`;
   let hash = 5381;
+  const maxSigned32Bit = 2147483647;
+  const uint32Size = 4294967296;
   for (let i = 0; i < content.length; i++) {
-    hash = (hash << 5) + hash + content.charCodeAt(i);
-    hash &= hash;
+    hash = Math.imul(hash, 33) + content.charCodeAt(i);
+    hash %= uint32Size;
+    if (hash > maxSigned32Bit) {
+      hash -= uint32Size;
+    }
   }
   return Math.abs(hash).toString(16).padStart(8, "0");
 }
@@ -742,9 +703,10 @@ function buildTestsEdgeGlobalId(fromGlobalId, toGlobalId) {
   return `edge-${fromGlobalId}-tests-${toGlobalId}`;
 }
 async function markProjectGraphDirty(ctx, projectId, topicId) {
+  const markCacheStaleByTopic = internal.graphAnalysisCache.markCacheStaleByTopic;
   const normalizedProjectId = typeof projectId === "string" && projectId.trim().length > 0 ? projectId : void 0;
   const normalizedTopicId = typeof topicId === "string" && topicId.trim().length > 0 ? topicId : void 0;
-  if (!normalizedProjectId && !normalizedTopicId) {
+  if (!(normalizedProjectId || normalizedTopicId)) {
     return;
   }
   if (normalizedProjectId) {
@@ -757,17 +719,17 @@ async function markProjectGraphDirty(ctx, projectId, topicId) {
     );
   }
   if (normalizedTopicId) {
-    await ctx.scheduler.runAfter(
-      0,
-      internal.graphAnalysisCache.markCacheStaleByTopic,
-      {
-        topicId: normalizedTopicId
-      }
-    );
+    await ctx.scheduler.runAfter(0, markCacheStaleByTopic, {
+      topicId: normalizedTopicId
+    });
+  }
+  const resolvedProjectId = normalizedTopicId ?? normalizedProjectId;
+  if (!resolvedProjectId) {
+    return;
   }
   await resolveGraphPrimitivesAppResolvers().patchProject(
     ctx,
-    normalizedTopicId ?? normalizedProjectId,
+    resolvedProjectId,
     {
       lastActivityAt: Date.now()
     }
@@ -803,12 +765,126 @@ function buildLinkedWorktreeMetadata(linkedWorktreeId) {
     linkedWorktreeId
   } : {};
 }
-async function insertEpistemicNode(ctx, doc) {
-  assertUuidV7Identity("epistemicNodes", doc.globalId);
-  return ctx.db.insert("epistemicNodes", doc);
+function normalizeScopeValue2(value) {
+  if (typeof value !== "string") {
+    return;
+  }
+  const normalized = value.trim();
+  return normalized.length > 0 ? normalized : void 0;
+}
+function throwWorkspaceIsolationError(args) {
+  const error = new Error(args.message);
+  error.status = 409;
+  error.code = "INVARIANT_VIOLATION";
+  error.invariantCode = args.invariantCode;
+  error.suggestion = args.suggestion;
+  error.details = args.details;
+  throw error;
+}
+function assertWorkspaceScopedEpistemicNodeScope(args) {
+  const layer = isNodeType(args.nodeType) ? getLayerForNodeType(args.nodeType) : void 0;
+  if (layer === "ontological") {
+    return;
+  }
+  const workspaceId = normalizeScopeValue2(args.scope.workspaceId);
+  if (workspaceId) {
+    return;
+  }
+  throwWorkspaceIsolationError({
+    message: "Workspace-scoped reasoning isolation requires workspaceId on non-ontological node creation.",
+    invariantCode: "workspace.scope_required_for_epistemic_nodes",
+    suggestion: "Resolve the topic/project scope through a workspace-bound topic before creating epistemic nodes.",
+    details: {
+      mutationName: args.mutationName,
+      nodeType: args.nodeType,
+      topicId: args.scope.topicId,
+      projectId: args.scope.projectId
+    }
+  });
+}
+function resolveRuntimePackMutationContext(args) {
+  if (!(args.runtimeToolName || args.runtimePackKey || args.runtimePackInstallScope)) {
+    return;
+  }
+  return {
+    toolName: args.runtimeToolName,
+    packKey: args.runtimePackKey,
+    packInstallScope: args.runtimePackInstallScope
+  };
+}
+function assertTenantPackWorkspaceMutationAllowed(args) {
+  if (!args.runtime?.packKey || args.runtime.packInstallScope !== "tenant") {
+    return;
+  }
+  const targetWorkspaceId = normalizeScopeValue2(args.target.workspaceId);
+  const targetLayer = typeof args.target.epistemicLayer === "string" ? args.target.epistemicLayer : void 0;
+  if (!targetWorkspaceId || targetLayer === "ontological") {
+    return;
+  }
+  throwWorkspaceIsolationError({
+    message: `Tenant-scoped pack "${args.runtime.packKey}" cannot mutate workspace-scoped reasoning state.`,
+    invariantCode: "workspace.tenant_pack_reasoning_write_forbidden",
+    suggestion: "Use a workspace-scoped pack for workspace-local graph mutations, or route the change through tenant-global canonical entity flows.",
+    details: {
+      mutationName: args.mutationName,
+      toolName: args.runtime.toolName,
+      packKey: args.runtime.packKey,
+      targetWorkspaceId,
+      targetNodeType: args.target.nodeType,
+      targetLayer
+    }
+  });
 }
 
 // src/epistemicQuestions.create.ts
+var EMBEDDING_GENERATION_ACTION = "embeddingActions:generateEpistemicNodeEmbedding";
+function readOptionalString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value : void 0;
+}
+function readConvexId(value) {
+  const normalized = readOptionalString(value);
+  return normalized ? normalized : null;
+}
+function readRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function readBeliefNodeRow(value) {
+  const record = readRecord(value);
+  if (!record) {
+    return null;
+  }
+  const id = readConvexId(record._id);
+  const globalId = readOptionalString(record.globalId);
+  return id && globalId ? { _id: id, globalId } : null;
+}
+async function scheduleTestsEdgeToBelief(ctx, args) {
+  const beliefNode = readBeliefNodeRow(await ctx.db.get(args.beliefNodeId));
+  if (!beliefNode) {
+    return;
+  }
+  await ctx.scheduler.runAfter(100, internal.neo4jSync.syncNodeToNeo4j, {
+    nodeId: beliefNode._id,
+    operation: "upsert"
+  });
+  const edgeGlobalId = buildTestsEdgeGlobalId(
+    args.questionGlobalId,
+    beliefNode.globalId
+  );
+  await ctx.scheduler.runAfter(250, internal.neo4jEdgeAPI.createEdge, {
+    globalId: edgeGlobalId,
+    fromGlobalId: args.questionGlobalId,
+    toGlobalId: beliefNode.globalId,
+    edgeType: "tests",
+    weight: 1,
+    context: args.testType || "tests",
+    createdBy: args.createdBy,
+    topicId: args.topicId,
+    fromNodeType: "question",
+    toNodeType: "belief",
+    fromLayer: "L3",
+    toLayer: "L3"
+  });
+}
 var create = mutation({
   args: {
     ...optionalScopeArgs,
@@ -929,31 +1005,13 @@ var create = mutation({
       text: args.question
     });
     if (args.linkedBeliefNodeId) {
-      const beliefNode = await ctx.db.get(args.linkedBeliefNodeId);
-      if (beliefNode?.globalId) {
-        await ctx.scheduler.runAfter(100, internal.neo4jSync.syncNodeToNeo4j, {
-          nodeId: args.linkedBeliefNodeId,
-          operation: "upsert"
-        });
-        const edgeGlobalId = buildTestsEdgeGlobalId(
-          beliefNode.globalId,
-          globalId
-        );
-        await ctx.scheduler.runAfter(250, internal.neo4jEdgeAPI.createEdge, {
-          globalId: edgeGlobalId,
-          fromGlobalId: beliefNode.globalId,
-          toGlobalId: globalId,
-          edgeType: "tests",
-          weight: 1,
-          context: args.testType || "tests",
-          createdBy: args.userId,
-          topicId: scope.projectId ? String(scope.projectId) : void 0,
-          fromNodeType: "belief",
-          toNodeType: "question",
-          fromLayer: "L3",
-          toLayer: "L3"
-        });
-      }
+      await scheduleTestsEdgeToBelief(ctx, {
+        beliefNodeId: args.linkedBeliefNodeId,
+        createdBy: args.userId,
+        questionGlobalId: globalId,
+        testType: args.testType,
+        topicId: normalizeQuestionTopicId(scope.topicId) ?? scope.projectId
+      });
     }
     await ctx.db.insert("epistemicAudit", {
       entityType: "question",
@@ -970,19 +1028,15 @@ var create = mutation({
       }
     });
     if (scope.projectId || scope.topicId) {
-      await ctx.scheduler.runAfter(
-        0,
-        "embeddingActions:generateEpistemicNodeEmbedding",
-        {
-          nodeId,
-          projectId: scope.projectId,
-          topicId: scope.topicId ? String(scope.topicId) : void 0,
-          createdBy: args.userId,
-          nodeType: "question",
-          text: args.question,
-          hasAnswer: false
-        }
-      );
+      await ctx.scheduler.runAfter(0, EMBEDDING_GENERATION_ACTION, {
+        nodeId,
+        projectId: scope.projectId,
+        topicId: scope.topicId ? String(scope.topicId) : void 0,
+        createdBy: args.userId,
+        nodeType: "question",
+        text: args.question,
+        hasAnswer: false
+      });
     }
     if (scope.projectId || scope.topicId) {
       await ctx.scheduler.runAfter(
@@ -1097,22 +1151,13 @@ var createBatch = mutation({
         operation: "upsert"
       });
       if (q.linkedBeliefNodeId) {
-        const beliefNode = await ctx.db.get(q.linkedBeliefNodeId);
-        if (beliefNode) {
-          await ctx.scheduler.runAfter(0, internal.neo4jEdgeAPI.createEdge, {
-            globalId: generateGlobalId(),
-            fromGlobalId: beliefNode.globalId,
-            toGlobalId: globalId,
-            edgeType: "tests",
-            weight: 1,
-            createdBy: args.userId,
-            topicId: scope.projectId,
-            fromNodeType: "belief",
-            toNodeType: "question",
-            fromLayer: "L3",
-            toLayer: "L3"
-          });
-        }
+        await scheduleTestsEdgeToBelief(ctx, {
+          beliefNodeId: q.linkedBeliefNodeId,
+          createdBy: args.userId,
+          questionGlobalId: globalId,
+          testType: q.testType,
+          topicId: normalizeQuestionTopicId(scope.topicId) ?? scope.projectId
+        });
       }
     }
     await markProjectGraphDirty(
@@ -1193,37 +1238,24 @@ var internalCreate = internalMutation({
       operation: "upsert"
     });
     if (args.linkedBeliefNodeId) {
-      const beliefNode = await ctx.db.get(args.linkedBeliefNodeId);
-      if (beliefNode) {
-        await ctx.scheduler.runAfter(0, internal.neo4jEdgeAPI.createEdge, {
-          globalId: generateGlobalId(),
-          fromGlobalId: beliefNode.globalId,
-          toGlobalId: globalId,
-          edgeType: "tests",
-          weight: 1,
-          createdBy: args.userId,
-          topicId: scope.projectId ? String(scope.projectId) : void 0,
-          fromNodeType: "belief",
-          toNodeType: "question",
-          fromLayer: "L3",
-          toLayer: "L3"
-        });
-      }
+      await scheduleTestsEdgeToBelief(ctx, {
+        beliefNodeId: args.linkedBeliefNodeId,
+        createdBy: args.userId,
+        questionGlobalId: globalId,
+        testType: args.testType,
+        topicId: normalizeQuestionTopicId(scope.topicId) ?? scope.projectId
+      });
     }
     if (scope.projectId || scope.topicId) {
-      await ctx.scheduler.runAfter(
-        0,
-        "embeddingActions:generateEpistemicNodeEmbedding",
-        {
-          nodeId,
-          projectId: scope.projectId,
-          topicId: scope.topicId ? String(scope.topicId) : void 0,
-          createdBy: args.userId,
-          nodeType: "question",
-          text: args.question,
-          hasAnswer: false
-        }
-      );
+      await ctx.scheduler.runAfter(0, EMBEDDING_GENERATION_ACTION, {
+        nodeId,
+        projectId: scope.projectId,
+        topicId: scope.topicId ? String(scope.topicId) : void 0,
+        createdBy: args.userId,
+        nodeType: "question",
+        text: args.question,
+        hasAnswer: false
+      });
     }
     await markProjectGraphDirty(
       ctx,
@@ -1266,7 +1298,7 @@ var addQuestion = mutation({
     const globalId = generateGlobalId();
     const contentHash = generateContentHash(args.question);
     const category = normalizeCategory(args.category);
-    const additionalMetadata = args.metadata && typeof args.metadata === "object" ? args.metadata : {};
+    const additionalMetadata = readRecord(args.metadata) ?? {};
     const nodeId = await insertEpistemicNode(ctx, {
       globalId,
       topicId: scope.topicId,
@@ -1321,19 +1353,15 @@ var addQuestion = mutation({
       nodeId,
       operation: "upsert"
     });
-    await ctx.scheduler.runAfter(
-      0,
-      "embeddingActions:generateEpistemicNodeEmbedding",
-      {
-        nodeId,
-        projectId: scope.projectId,
-        topicId: normalizeQuestionTopicId(scope.topicId),
-        createdBy: args.userId,
-        nodeType: "question",
-        text: args.question,
-        hasAnswer: false
-      }
-    );
+    await ctx.scheduler.runAfter(0, EMBEDDING_GENERATION_ACTION, {
+      nodeId,
+      projectId: scope.projectId,
+      topicId: normalizeQuestionTopicId(scope.topicId),
+      createdBy: args.userId,
+      nodeType: "question",
+      text: args.question,
+      hasAnswer: false
+    });
     await markProjectGraphDirty(
       ctx,
       scope.projectId,