@lucern/graph-primitives 1.0.50 → 1.0.52

package/dist/scopeResolverCompat.js

@@ -1,6 +1,5 @@
 import { v } from 'convex/values';
-import { unsafeConvexAnyApi } from '@lucern/contracts/convex/unsafeAnyApi';
-import { componentsGeneric } from 'convex/server';
+import { isUuidV7 } from '@lucern/contracts/ids';
 
 // src/debug.ts
 function isGraphPrimitiveDebugEnabled() {
@@ -13,11 +12,6 @@ function debugGraphPrimitiveFallback(message, context) {
   }
   console.debug(message, context ?? {});
 }
-var unsafeApi = unsafeConvexAnyApi(
-  "graph-primitives top-level module bundle lacks a committed Convex _generated/api surface"
-);
-var api = unsafeApi;
-componentsGeneric();
 
 // src/topicScope.ts
 var LEGACY_SCOPE_FIELD = "graphScopeProjectId";
@@ -40,16 +34,36 @@ async function resolveTopicNodeScopeOrNull(ctx, ref) {
   if (!node) {
     return null;
   }
-  const scopeKey = normalizeScopeValue(node.topicId) ?? normalizeScopeValue(node.globalId);
+  const scopeKey = canonicalTopicGlobalId(node);
   if (!scopeKey) {
-    return null;
+    throw new Error(
+      `topic.uuidv7_identity_required: topic node ${ref} is missing a UUIDv7 globalId.`
+    );
   }
+  const metadata = node.metadata ?? {};
   return {
     topicId: scopeKey,
     projectId: asMappedProjectId(node),
-    source: "topic_node"
+    source: "topic_node",
+    tenantId: normalizeScopeValue(node.tenantId) ?? normalizeScopeValue(metadata.tenantId),
+    workspaceId: normalizeScopeValue(node.workspaceId) ?? normalizeScopeValue(metadata.workspaceId)
   };
 }
+function canonicalTopicGlobalId(node) {
+  const globalId = normalizeScopeValue(node.globalId);
+  if (globalId && isUuidV7(globalId)) {
+    return globalId;
+  }
+  const topicId = normalizeScopeValue(node.topicId);
+  return topicId && isUuidV7(topicId) ? topicId : null;
+}
+function requireUuidV7TopicScope(field, value) {
+  if (!isUuidV7(value)) {
+    throw new Error(
+      `topic.uuidv7_required: ${field} must be a UUIDv7 public topic identifier.`
+    );
+  }
+}
 function asMappedProjectId(topic) {
   if (!topic) {
     return;
@@ -71,200 +85,25 @@ function normalizeScopeValue(value) {
   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 query = ctx.db.query("topics");
-  try {
-    return await query.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 query.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(
+      "topic.uuidv7_required: projectId scope aliases are retired; pass topicId as the UUIDv7 topic globalId."
+    );
   }
-  throw new Error(
-    "Missing scope: provide topicId (preferred) or legacy projectId alias."
-  );
+  throw new Error("topic.uuidv7_required: Missing scope: provide topicId.");
 }
 async function resolveScopeFromTopicId(ctx, topicId) {
-  const topic = await resolveTopicDocFromTopicId(ctx, topicId);
-  if (topic) {
-    return await buildTopicScope(ctx, topic, "topic");
-  }
-  const nodeScope = await resolveTopicNodeScopeOrNull(ctx, String(topicId));
+  const topicGlobalId = String(topicId);
+  requireUuidV7TopicScope("topicId", topicGlobalId);
+  const nodeScope = await resolveTopicNodeScopeOrNull(ctx, topicGlobalId);
   if (nodeScope) {
     return nodeScope;
   }
-  throw new Error(`Topic not found: ${String(topicId)}`);
-}
-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;
-}
-async function resolveScopeFromLegacyProjectId(ctx, legacyProjectId) {
-  const directTopic = await resolveDirectLegacyProjectTopic(
-    ctx,
-    legacyProjectId
-  );
-  if (directTopic) {
-    return await buildTopicScope(ctx, directTopic, "topic_inferred", {
-      fallbackProjectId: legacyProjectId
-    });
-  }
-  const primary = pickPrimaryTopic(
-    await findTopicsByScopeAlias(ctx, legacyProjectId)
-  );
-  if (primary) {
-    return await buildTopicScope(ctx, primary, "project_mapped_topic", {
-      fallbackProjectId: legacyProjectId
-    });
-  }
-  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.`
-  );
-}
-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 tryReadTopicDoc(ctx, id, log) {
-  try {
-    return await ctx.db.get(id);
-  } catch (error) {
-    debugGraphPrimitiveFallback(log.failureLog, {
-      error,
-      [log.idLogKey]: id
-    });
-    return null;
-  }
-}
-async function buildTopicScope(ctx, topic, source, options = {}) {
-  const inherited = await resolveInheritedWorkspaceScope(ctx, topic);
-  const mapped = asMappedProjectId(topic);
-  return {
-    topicId: topic._id,
-    ...mapped || options.fallbackProjectId ? { projectId: mapped ?? options.fallbackProjectId } : {},
-    tenantId: inherited.tenantId,
-    workspaceId: inherited.workspaceId,
-    source
-  };
+  throw new Error(`Topic not found: ${topicGlobalId}`);
 }
 var optionalScopeArgs = {
   projectId: v.optional(v.string()),

package/dist/topicOntologyResolver.d.ts

@@ -43,7 +43,7 @@ interface ResolvedTopicOntology {
     /** The published version, if any */
     publishedVersion: OntologyVer | null;
     source: "direct" | "inherited";
-    sourceTopicId: Id<"topics">;
+    sourceTopicId: string;
     tier: string;
     /** Valid edge type values from the latest published version */
     validEdgeTypes: string[];
@@ -60,7 +60,7 @@ interface TopicOntologyCtx {
  * @param topicId - The topic to resolve the ontology for
  * @returns The resolved ontology or null if none is bound in the ancestor chain
  */
-declare function resolveTopicOntologyInternal(ctx: TopicOntologyCtx, topicId: Id<"topics">): Promise<ResolvedTopicOntology | null>;
+declare function resolveTopicOntologyInternal(ctx: TopicOntologyCtx, topicId: string): Promise<ResolvedTopicOntology | null>;
 /**
  * Validate that a nodeType is allowed by the resolved ontology for a topic.
  *
@@ -71,7 +71,7 @@ declare function resolveTopicOntologyInternal(ctx: TopicOntologyCtx, topicId: Id
  * Returns { valid: false, error } if:
  * - The topic has a bound ontology and the nodeType is not in its entity types
  */
-declare function validateEntityTypeForTopic(ctx: TopicOntologyCtx, topicId: Id<"topics">, nodeType: string): Promise<{
+declare function validateEntityTypeForTopic(ctx: TopicOntologyCtx, topicId: string, nodeType: string): Promise<{
     valid: true;
 } | {
     valid: false;

package/dist/topicOntologyResolver.js

@@ -1,7 +1,50 @@
+import { isUuidV7 } from '@lucern/contracts/ids';
+
+// src/globalId.ts
+
 // src/topicOntologyResolver.ts
 var MAX_RESOLUTION_DEPTH = 10;
-async function loadTopic(ctx, topicId) {
-  return await ctx.db.get(topicId);
+async function loadTopic(ctx, topicGlobalId) {
+  requireUuidV7TopicGlobalId(topicGlobalId);
+  const topic = await ctx.db.query("epistemicNodes").withIndex("by_globalId", (q) => q.eq("globalId", topicGlobalId)).first();
+  return requireTopicGlobalId(topic);
+}
+function requireUuidV7TopicGlobalId(topicGlobalId) {
+  if (!isUuidV7(topicGlobalId)) {
+    throw new Error(
+      `topic.uuidv7_required: topic ontology resolution requires a UUIDv7 topic globalId, received ${topicGlobalId}.`
+    );
+  }
+}
+function requireTopicGlobalId(topic) {
+  if (!topic) {
+    return null;
+  }
+  if (topic.nodeType !== "topic") {
+    return null;
+  }
+  if (!isUuidV7(topic.globalId)) {
+    throw new Error(
+      `topic.uuidv7_required: topic node ${String(topic._id)} is missing a UUIDv7 globalId.`
+    );
+  }
+  return topic;
+}
+function metadataString(topic, field) {
+  const value = topic.metadata?.[field];
+  return typeof value === "string" && value.trim() ? value : null;
+}
+function topicOntologyId(topic) {
+  const ontologyId = metadataString(topic, "ontologyId");
+  return ontologyId ? ontologyId : null;
+}
+function parentTopicGlobalId(topic) {
+  const parent = metadataString(topic, "parentTopicGlobalId");
+  if (!parent) {
+    return null;
+  }
+  requireUuidV7TopicGlobalId(parent);
+  return parent;
 }
 async function loadOntologyDefinition(ctx, ontologyId) {
   return await ctx.db.get(ontologyId);
@@ -24,25 +67,20 @@ function resolvedTopicOntology(args) {
   };
 }
 async function resolveCurrentTopicOntology(args) {
-  if (!args.current.ontologyId) {
+  const ontologyId = topicOntologyId(args.current);
+  if (!ontologyId) {
     return "continue";
   }
-  const ontologyDef = await loadOntologyDefinition(
-    args.ctx,
-    args.current.ontologyId
-  );
+  const ontologyDef = await loadOntologyDefinition(args.ctx, ontologyId);
   if (!ontologyDef || ontologyDef.status === "archived") {
-    return args.current.parentTopicId ? "continue" : null;
+    return parentTopicGlobalId(args.current) ? "continue" : null;
   }
-  const published = await loadPublishedOntologyVersions(
-    args.ctx,
-    args.current.ontologyId
-  );
+  const published = await loadPublishedOntologyVersions(args.ctx, ontologyId);
   return resolvedTopicOntology({
     latestPublished: published[0] ?? null,
     ontologyDef,
-    source: args.current._id === args.startTopicId ? "direct" : "inherited",
-    sourceTopicId: args.current._id
+    source: args.current.globalId === args.startTopicGlobalId ? "direct" : "inherited",
+    sourceTopicId: args.current.globalId
   });
 }
 async function resolveTopicOntologyInternal(ctx, topicId) {
@@ -50,20 +88,21 @@ async function resolveTopicOntologyInternal(ctx, topicId) {
   if (!current) {
     return null;
   }
-  const startTopicId = topicId;
+  const startTopicGlobalId = topicId;
   for (let i = 0; i < MAX_RESOLUTION_DEPTH && current; i++) {
     const resolved = await resolveCurrentTopicOntology({
       ctx,
       current,
-      startTopicId
+      startTopicGlobalId
     });
     if (resolved !== "continue") {
       return resolved;
     }
-    if (!current.parentTopicId) {
+    const parent = parentTopicGlobalId(current);
+    if (!parent) {
       break;
     }
-    current = await loadTopic(ctx, current.parentTopicId);
+    current = await loadTopic(ctx, parent);
   }
   return null;
 }

package/dist/{topicScope-DJVa0mLa.d.ts → topicScope-CL1IVOmv.d.ts}

@@ -20,7 +20,7 @@ interface TopicProjectScope {
     projectId?: string;
     source: "topic" | "project_mapped_topic" | "topic_inferred" | "topic_node";
     tenantId?: string;
-    topicId: Id<"topics">;
+    topicId: string;
     workspaceId?: string;
 }
 interface MaterializedTopicNodeDoc {
@@ -32,7 +32,7 @@ declare function resolveTopicProjectScope(ctx: TopicScopeContext, args: {
     topicId?: Id<"topics"> | string;
     projectId?: string;
 }): Promise<TopicProjectScope>;
-/** Shared scope args for graph-primitive functions. topicId is canonical; projectId is a legacy alias. */
+/** Shared scope args for graph-primitive functions. topicId is canonical UUIDv7; projectId is a refused legacy alias. */
 declare const optionalScopeArgs: {
     readonly projectId: convex_values.VString<string | undefined, "optional">;
     readonly topicId: convex_values.VString<string | undefined, "optional">;

package/dist/topicScope.d.ts

@@ -1,5 +1,5 @@
 import 'convex/values';
 import './convex.js';
-export { T as TopicProjectScope, o as optionalScopeArgs, a as readMaterializedTopicTableId, r as resolveTopicProjectScope } from './topicScope-DJVa0mLa.js';
+export { T as TopicProjectScope, o as optionalScopeArgs, a as readMaterializedTopicTableId, r as resolveTopicProjectScope } from './topicScope-CL1IVOmv.js';
 import '@lucern/access-control/convex';
 import '@lucern/contracts/convex/unsafeAnyApi';

package/dist/topicScope.js

@@ -1,13 +1,7 @@
 import { v } from 'convex/values';
-import { unsafeConvexAnyApi } from '@lucern/contracts/convex/unsafeAnyApi';
-import { componentsGeneric } from 'convex/server';
+import { isUuidV7 } from '@lucern/contracts/ids';
 
 // src/topicScope.ts
-var unsafeApi = unsafeConvexAnyApi(
-  "graph-primitives top-level module bundle lacks a committed Convex _generated/api surface"
-);
-var api = unsafeApi;
-componentsGeneric();
 
 // src/debug.ts
 function isGraphPrimitiveDebugEnabled() {
@@ -42,16 +36,36 @@ async function resolveTopicNodeScopeOrNull(ctx, ref) {
   if (!node) {
     return null;
   }
-  const scopeKey = normalizeScopeValue(node.topicId) ?? normalizeScopeValue(node.globalId);
+  const scopeKey = canonicalTopicGlobalId(node);
   if (!scopeKey) {
-    return null;
+    throw new Error(
+      `topic.uuidv7_identity_required: topic node ${ref} is missing a UUIDv7 globalId.`
+    );
   }
+  const metadata = node.metadata ?? {};
   return {
     topicId: scopeKey,
     projectId: asMappedProjectId(node),
-    source: "topic_node"
+    source: "topic_node",
+    tenantId: normalizeScopeValue(node.tenantId) ?? normalizeScopeValue(metadata.tenantId),
+    workspaceId: normalizeScopeValue(node.workspaceId) ?? normalizeScopeValue(metadata.workspaceId)
   };
 }
+function canonicalTopicGlobalId(node) {
+  const globalId = normalizeScopeValue(node.globalId);
+  if (globalId && isUuidV7(globalId)) {
+    return globalId;
+  }
+  const topicId = normalizeScopeValue(node.topicId);
+  return topicId && isUuidV7(topicId) ? topicId : null;
+}
+function requireUuidV7TopicScope(field, value) {
+  if (!isUuidV7(value)) {
+    throw new Error(
+      `topic.uuidv7_required: ${field} must be a UUIDv7 public topic identifier.`
+    );
+  }
+}
 function asMappedProjectId(topic) {
   if (!topic) {
     return;
@@ -73,82 +87,6 @@ function normalizeScopeValue(value) {
   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 query = ctx.db.query("topics");
-  try {
-    return await query.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 query.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;
-  }
-}
 function readMaterializedTopicTableId(topicNode) {
   if (!topicNode) {
     return;
@@ -157,124 +95,25 @@ function readMaterializedTopicTableId(topicNode) {
   const topicTableId = metadata.topicTableId || metadata.topicId;
   return typeof topicTableId === "string" && topicTableId.trim().length > 0 ? topicTableId.trim() : void 0;
 }
-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(
+      "topic.uuidv7_required: projectId scope aliases are retired; pass topicId as the UUIDv7 topic globalId."
+    );
   }
-  throw new Error(
-    "Missing scope: provide topicId (preferred) or legacy projectId alias."
-  );
+  throw new Error("topic.uuidv7_required: Missing scope: provide topicId.");
 }
 async function resolveScopeFromTopicId(ctx, topicId) {
-  const topic = await resolveTopicDocFromTopicId(ctx, topicId);
-  if (topic) {
-    return await buildTopicScope(ctx, topic, "topic");
-  }
-  const nodeScope = await resolveTopicNodeScopeOrNull(ctx, String(topicId));
+  const topicGlobalId = String(topicId);
+  requireUuidV7TopicScope("topicId", topicGlobalId);
+  const nodeScope = await resolveTopicNodeScopeOrNull(ctx, topicGlobalId);
   if (nodeScope) {
     return nodeScope;
   }
-  throw new Error(`Topic not found: ${String(topicId)}`);
-}
-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;
-}
-async function resolveScopeFromLegacyProjectId(ctx, legacyProjectId) {
-  const directTopic = await resolveDirectLegacyProjectTopic(
-    ctx,
-    legacyProjectId
-  );
-  if (directTopic) {
-    return await buildTopicScope(ctx, directTopic, "topic_inferred", {
-      fallbackProjectId: legacyProjectId
-    });
-  }
-  const primary = pickPrimaryTopic(
-    await findTopicsByScopeAlias(ctx, legacyProjectId)
-  );
-  if (primary) {
-    return await buildTopicScope(ctx, primary, "project_mapped_topic", {
-      fallbackProjectId: legacyProjectId
-    });
-  }
-  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.`
-  );
-}
-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 tryReadTopicDoc(ctx, id, log) {
-  try {
-    return await ctx.db.get(id);
-  } catch (error) {
-    debugGraphPrimitiveFallback(log.failureLog, {
-      error,
-      [log.idLogKey]: id
-    });
-    return null;
-  }
-}
-async function buildTopicScope(ctx, topic, source, options = {}) {
-  const inherited = await resolveInheritedWorkspaceScope(ctx, topic);
-  const mapped = asMappedProjectId(topic);
-  return {
-    topicId: topic._id,
-    ...mapped || options.fallbackProjectId ? { projectId: mapped ?? options.fallbackProjectId } : {},
-    tenantId: inherited.tenantId,
-    workspaceId: inherited.workspaceId,
-    source
-  };
+  throw new Error(`Topic not found: ${topicGlobalId}`);
 }
 var optionalScopeArgs = {
   projectId: v.optional(v.string()),