@lucern/graph-primitives 0.3.0-alpha.0 → 0.3.0-alpha.10

package/dist/epistemicNodes.js

@@ -1,820 +1,30 @@
 import { v } from 'convex/values';
-import { componentsGeneric, queryGeneric, mutationGeneric, anyApi, internalMutationGeneric, internalQueryGeneric } from 'convex/server';
+import { checkScopeAccess, requireProjectAccess } from '@lucern/access-control/access';
+import { permissiveReturn } from '@lucern/contracts/schema-helpers/validators';
+import { componentsGeneric, anyApi, queryGeneric, mutationGeneric, internalMutationGeneric, internalQueryGeneric } from 'convex/server';
+import { isNodeType, getLayerForNodeType } from '@lucern/contracts/schema-helpers/spine/tables/epistemicNodes';
 
 // src/epistemicNodes.ts
 var api = anyApi;
 componentsGeneric();
-
-// ../access-control/src/topicProjectOverlay.ts
-var LEGACY_SCOPE_FIELD = "graphScopeProjectId";
-function readNonEmptyString(value) {
-  if (typeof value !== "string") {
-    return;
-  }
-  const normalized = value.trim();
-  return normalized.length > 0 ? normalized : void 0;
-}
-function readStringArray(value) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return value.map((entry) => readNonEmptyString(entry)).filter((entry) => Boolean(entry));
-}
-function readMetadata(topic) {
-  return topic.metadata && typeof topic.metadata === "object" ? topic.metadata : {};
-}
-function readLegacyProjectId(value) {
-  if (!value) {
-    return;
-  }
-  return readNonEmptyString(value[LEGACY_SCOPE_FIELD]);
-}
-function coerceVisibility(value) {
-  return value === "private" || value === "team" || value === "firm" || value === "external" || value === "public" ? value : void 0;
-}
-function coerceStatus(value) {
-  return value === "active" || value === "archived" || value === "watching" ? value : void 0;
-}
-function mapProjectType(topic, metadata) {
-  const explicit = readNonEmptyString(metadata.projectType);
-  if (explicit) {
-    return explicit;
-  }
-  if (topic.type === "theme") {
-    return "thematic";
-  }
-  return readNonEmptyString(topic.type) || "general";
-}
-function isProjectLikeTopic(topic) {
-  const metadata = readMetadata(topic);
-  return topic.type === "theme" || topic.type === "thematic" || topic.type === "deal" || topic.type === "monitoring" || readLegacyProjectId(topic) !== void 0 || readNonEmptyString(metadata.projectType) !== void 0;
-}
-async function resolveTopicDoc(ctx, scopeId) {
-  if (ctx?.db && typeof ctx.db.get === "function") {
-    try {
-      const directTopic = await ctx.db.get(scopeId);
-      if (directTopic) {
-        return directTopic;
-      }
-    } catch {
-    }
-  }
-  if (typeof ctx.runQuery !== "function") {
-    return null;
-  }
-  try {
-    const topic = await ctx.runQuery(api.topics.get, {
-      id: String(scopeId)
-    });
-    if (topic?.name !== void 0 && topic?.type !== void 0) {
-      return topic;
-    }
-  } catch {
-  }
-  try {
-    const topic = await ctx.runQuery(api.topics.getByLegacyScopeId, {
-      projectId: String(scopeId)
-    });
-    if (topic?.name !== void 0 && topic?.type !== void 0) {
-      return topic;
-    }
-  } catch {
-  }
-  return null;
-}
-function materializeTopicProjectOverlay(topic, idMode = "legacy") {
-  const metadata = readMetadata(topic);
-  const topicId = String(topic._id);
-  const legacyProjectId = readLegacyProjectId(topic) || readLegacyProjectId(metadata) || readNonEmptyString(metadata.legacyProjectId);
-  const storageProjectId = legacyProjectId || topicId;
-  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;
-  return {
-    ...metadata,
-    _id: outwardId,
-    projectId: outwardId,
-    topicId,
-    storageProjectId,
-    legacyProjectId,
-    name: readNonEmptyString(topic.name) || "Untitled Theme",
-    type: mapProjectType(topic, metadata),
-    description: readNonEmptyString(topic.description),
-    ownerId: readNonEmptyString(metadata.ownerId) || readNonEmptyString(topic.createdBy) || "system",
-    sharedWith: readStringArray(metadata.sharedWith),
-    visibility,
-    tenantId: readNonEmptyString(topic.tenantId) || readNonEmptyString(metadata.tenantId),
-    workspaceId: readNonEmptyString(topic.workspaceId) || readNonEmptyString(metadata.workspaceId),
-    status,
-    tags: readStringArray(metadata.tags),
-    chatCount: typeof metadata.chatCount === "number" ? metadata.chatCount : 0,
-    artifactCount: typeof metadata.artifactCount === "number" ? metadata.artifactCount : 0,
-    lastActivityAt: typeof metadata.lastActivityAt === "number" ? metadata.lastActivityAt : updatedAt,
-    _creationTime: typeof topic._creationTime === "number" ? topic._creationTime : createdAt,
-    createdAt,
-    updatedAt
-  };
-}
-async function resolveTopicProjectOverlay(ctx, scopeId, options = {}) {
-  const topic = await resolveTopicDoc(ctx, scopeId);
-  if (!topic) {
-    return null;
-  }
-  if (options.projectLikeOnly !== false && !isProjectLikeTopic(topic)) {
-    return null;
-  }
-  return materializeTopicProjectOverlay(topic, options.idMode);
-}
-async function listTopicProjectOverlays(ctx, options = {}) {
-  let allTopics = [];
-  if (ctx?.db?.query && typeof ctx.db.query === "function") {
-    try {
-      allTopics = await ctx.db.query("topics").collect();
-    } catch {
-      allTopics = [];
-    }
-  }
-  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));
-}
-
-// ../access-control/src/projectGrantsBridge.ts
-var PROJECT_GRANT_STATUSES = ["active", "revoked", "expired"];
-function normalizeString(value) {
-  if (typeof value !== "string") {
-    return;
-  }
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : void 0;
-}
-async function resolveGrantScopeIds(ctx, args) {
-  const topicId = normalizeString(args.topicId);
-  const projectId = normalizeString(args.projectId);
-  for (const scopeId of [topicId, projectId]) {
-    if (!scopeId) {
-      continue;
-    }
-    try {
-      const overlay = await resolveTopicProjectOverlay(ctx, scopeId, {
-        idMode: "legacy",
-        projectLikeOnly: false
-      });
-      if (overlay) {
-        return {
-          topicId: normalizeString(overlay.topicId) ?? topicId,
-          projectId: normalizeString(overlay.projectId) ?? projectId ?? scopeId
-        };
-      }
-    } catch {
-    }
-  }
-  return { topicId, projectId };
-}
-async function normalizeProjectGrantRow(ctx, row) {
-  const scope = await resolveGrantScopeIds(ctx, {
-    topicId: row.topicId,
-    projectId: row.projectId
-  });
-  return {
-    ...row,
-    ...scope.topicId ? { topicId: scope.topicId } : {},
-    ...scope.projectId ?? scope.topicId ? { projectId: scope.projectId ?? scope.topicId } : {}
-  };
-}
-async function normalizeProjectGrantRows(ctx, rows) {
-  return await Promise.all(rows.map((row) => normalizeProjectGrantRow(ctx, row)));
-}
-async function listProjectGrantsByPrincipal(ctx, principalId) {
-  const rows = await Promise.all(
-    PROJECT_GRANT_STATUSES.map(
-      (status) => ctx.db.query("projectGrants").withIndex(
-        "by_principal_status",
-        (q) => q.eq("principalId", principalId).eq("status", status)
-      ).collect()
-    )
-  );
-  return await normalizeProjectGrantRows(ctx, rows.flat());
-}
-async function listProjectGrantsByGroup(ctx, groupId) {
-  const rows = await Promise.all(
-    PROJECT_GRANT_STATUSES.map(
-      (status) => ctx.db.query("projectGrants").withIndex(
-        "by_group_status",
-        (q) => q.eq("groupId", groupId).eq("status", status)
-      ).collect()
-    )
-  );
-  return await normalizeProjectGrantRows(ctx, rows.flat());
-}
-function buildScopeMatchers(inputScopeId, resolved) {
-  return new Set(
-    [inputScopeId, resolved.topicId, resolved.projectId].map((value) => normalizeString(value)).filter((value) => Boolean(value))
-  );
-}
-function matchesResolvedScope(row, scopeIds) {
-  const rowTopicId = normalizeString(row.topicId);
-  const rowProjectId = normalizeString(row.projectId);
-  return rowTopicId !== void 0 && scopeIds.has(rowTopicId) || rowProjectId !== void 0 && scopeIds.has(rowProjectId);
-}
-async function bridgeListProjectGrantsByTopicAndPrincipal(ctx, topicId, principalId) {
-  const resolved = await resolveGrantScopeIds(ctx, { topicId });
-  const scopeIds = buildScopeMatchers(topicId, resolved);
-  const rows = await listProjectGrantsByPrincipal(ctx, principalId);
-  return rows.filter((row) => matchesResolvedScope(row, scopeIds));
-}
-async function bridgeListProjectGrantsByTopicAndGroup(ctx, topicId, groupId) {
-  const resolved = await resolveGrantScopeIds(ctx, { topicId });
-  const scopeIds = buildScopeMatchers(topicId, resolved);
-  const rows = await listProjectGrantsByGroup(ctx, groupId);
-  return rows.filter((row) => matchesResolvedScope(row, scopeIds));
-}
-async function bridgeListProjectGrantsByPrincipalStatus(ctx, principalId, status) {
-  const rows = await listProjectGrantsByPrincipal(ctx, principalId);
-  return rows.filter((row) => row.status === status);
-}
-async function bridgeListProjectGrantsByGroupStatus(ctx, groupId, status) {
-  const rows = await listProjectGrantsByGroup(ctx, groupId);
-  return rows.filter((row) => row.status === status);
-}
-async function bridgeInsertProjectGrant(ctx, value) {
-  const resolved = await resolveGrantScopeIds(ctx, value);
-  return await ctx.db.insert("projectGrants", {
-    ...value,
-    ...resolved.topicId ? { topicId: resolved.topicId } : {},
-    ...resolved.projectId ?? resolved.topicId ? { projectId: resolved.projectId ?? resolved.topicId } : {}
-  });
-}
-
-// ../access-control/src/resolvers.ts
-async function findUserByClerkId(ctx, clerkId) {
-  const normalizedClerkId = clerkId.trim();
-  if (!normalizedClerkId) {
-    return null;
-  }
-  if (typeof ctx.runQuery === "function") {
-    try {
-      const bridgedUser = await ctx.runQuery(api.users.getUserByClerkId, {
-        clerkId: normalizedClerkId
-      });
-      if (bridgedUser) {
-        return bridgedUser;
-      }
-    } catch {
-    }
-  }
-  try {
-    const users = await ctx.db.query("users").collect();
-    return users.find((user) => String(user.clerkId ?? "") === normalizedClerkId) ?? null;
-  } catch {
-    return null;
-  }
-}
-async function findUserByPrincipalId(ctx, principalId) {
-  const normalizedPrincipalId = principalId.trim();
-  if (!normalizedPrincipalId) {
-    return null;
-  }
-  try {
-    const users = await ctx.db.query("users").collect();
-    return users.find(
-      (user) => String(user.defaultPrincipalId ?? "") === normalizedPrincipalId
-    ) ?? null;
-  } catch {
-    return null;
-  }
-}
-async function findAgentByPrincipalId(ctx, principalId) {
-  const normalizedPrincipalId = principalId.trim();
-  if (!normalizedPrincipalId) {
-    return null;
-  }
-  if (typeof ctx.runQuery === "function") {
-    try {
-      const bridgedAgent = await ctx.runQuery(
-        api.agents.getAgentByPrincipalId,
-        {
-          principalId: normalizedPrincipalId
-        }
-      );
-      if (bridgedAgent) {
-        return bridgedAgent;
-      }
-    } catch {
-    }
-  }
-  try {
-    const agents = await ctx.db.query("agents").collect();
-    return agents.find(
-      (agent) => String(agent.principalId ?? "") === normalizedPrincipalId
-    ) ?? null;
-  } catch {
-    return null;
-  }
-}
-function defaultResolvers() {
-  return {
-    async getProject(ctx, topicId) {
-      return await resolveTopicProjectOverlay(ctx, topicId, {
-        idMode: "legacy",
-        projectLikeOnly: false
-      });
-    },
-    async listTopics(ctx) {
-      return await listTopicProjectOverlays(ctx, { idMode: "legacy" });
-    },
-    async listTopicsByOwner(ctx, ownerId) {
-      const topics = await listTopicProjectOverlays(ctx, { idMode: "legacy" });
-      return topics.filter((topic) => topic.ownerId === ownerId);
-    },
-    async listTopicsByVisibility(ctx, visibility) {
-      const topics = await listTopicProjectOverlays(ctx, { idMode: "legacy" });
-      return topics.filter((topic) => topic.visibility === visibility);
-    },
-    async listProjectGrantsByProjectAndPrincipal(ctx, topicId, principalId) {
-      return await bridgeListProjectGrantsByTopicAndPrincipal(
-        ctx,
-        topicId,
-        principalId
-      );
-    },
-    async listProjectGrantsByProjectAndGroup(ctx, topicId, groupId) {
-      return await bridgeListProjectGrantsByTopicAndGroup(ctx, topicId, groupId);
-    },
-    async listProjectGrantsByPrincipalStatus(ctx, principalId, status) {
-      return await bridgeListProjectGrantsByPrincipalStatus(
-        ctx,
-        principalId,
-        status
-      );
-    },
-    async listProjectGrantsByGroupStatus(ctx, groupId, status) {
-      return await bridgeListProjectGrantsByGroupStatus(ctx, groupId, status);
-    },
-    async insertProjectGrant(ctx, value) {
-      return await bridgeInsertProjectGrant(ctx, value);
-    },
-    async getAgentByPrincipalId(ctx, principalId) {
-      return await findAgentByPrincipalId(ctx, principalId);
-    },
-    async getUserByClerkId(ctx, clerkId) {
-      return await findUserByClerkId(ctx, clerkId);
-    },
-    async getUserByPrincipalId(ctx, principalId) {
-      return await findUserByPrincipalId(ctx, principalId);
-    }
-  };
-}
-var resolverOverrides = {};
-function resolveAccessControlAppResolvers(_ctx) {
-  return {
-    ...defaultResolvers(),
-    ...resolverOverrides
-  };
-}
-
-// ../access-control/src/principalContext.ts
-function requireCanonicalResolvedUser(user, clerkId) {
-  const resolved = user;
-  if (!resolved) {
-    throw new Error(
-      `[AccessControl] Canonical user identity required for ${clerkId}. Sync users.upsertUser before user-bound access checks.`
-    );
-  }
-  const { mcRole, defaultTenantId, defaultWorkspaceId, defaultPrincipalId } = resolved;
-  if (mcRole !== "platform_admin" && mcRole !== "tenant_admin" && mcRole !== "workspace_admin" && mcRole !== "editor" && mcRole !== "viewer" && mcRole !== "auditor" && mcRole !== "service_agent") {
-    throw new Error(
-      `[AccessControl] Canonical MC role required for ${clerkId}. Re-sync Master Control identity before user-bound access checks.`
-    );
-  }
-  if (typeof defaultTenantId !== "string" || defaultTenantId.trim().length === 0) {
-    throw new Error(
-      `[AccessControl] Canonical home tenant required for ${clerkId}. Re-sync Master Control identity before user-bound access checks.`
-    );
-  }
-  if (typeof defaultWorkspaceId !== "string" || defaultWorkspaceId.trim().length === 0) {
-    throw new Error(
-      `[AccessControl] Canonical home workspace required for ${clerkId}. Re-sync Master Control identity before user-bound access checks.`
-    );
-  }
-  if (typeof defaultPrincipalId !== "string" || defaultPrincipalId.trim().length === 0) {
-    throw new Error(
-      `[AccessControl] Canonical federated principal required for ${clerkId}. Re-sync Master Control identity before user-bound access checks.`
-    );
-  }
-  return {
-    mcRole,
-    defaultTenantId: defaultTenantId.trim(),
-    defaultWorkspaceId: defaultWorkspaceId.trim(),
-    defaultPrincipalId: defaultPrincipalId.trim()
-  };
-}
-function isPrincipalIdInput(value) {
-  return value.startsWith("user:") || value.startsWith("group:") || value.startsWith("service:") || value.startsWith("agent:") || value.startsWith("external_viewer:");
-}
-async function resolveCanonicalUserRecord(ctx, actorId) {
-  const normalizedActorId = actorId.trim();
-  const clerkId = isPrincipalIdInput(normalizedActorId) && normalizedActorId.startsWith("user:") ? normalizedActorId.slice("user:".length) : normalizedActorId;
-  const resolvers = resolveAccessControlAppResolvers();
-  const resolvedByClerkId = await resolvers.getUserByClerkId(ctx, clerkId);
-  if (resolvedByClerkId) {
-    return {
-      resolvedUser: resolvedByClerkId,
-      clerkId,
-      contextClerkId: clerkId
-    };
-  }
-  const resolvedByPrincipalId = await resolvers.getUserByPrincipalId(
-    ctx,
-    normalizedActorId
-  );
-  return {
-    resolvedUser: resolvedByPrincipalId ?? null,
-    clerkId,
-    contextClerkId: normalizedActorId.startsWith("user:") && clerkId.length > 0 ? clerkId : normalizedActorId
-  };
-}
-function uniqRoles(roles) {
-  const roleSet = /* @__PURE__ */ new Set();
-  for (const role of roles) {
-    if (role === "platform_admin" || role === "tenant_admin" || role === "workspace_admin" || role === "editor" || role === "viewer" || role === "auditor" || role === "service_agent") {
-      roleSet.add(role);
-    }
-  }
-  return [...roleSet];
-}
-function normalizeGroupIds(value) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return [...new Set(
-    value.filter((entry) => typeof entry === "string").map((entry) => entry.trim()).filter(Boolean)
-  )];
-}
-function requireServiceAgentUser(user, actorId) {
-  const canonicalUser = requireCanonicalResolvedUser(user, actorId);
-  if (canonicalUser.mcRole !== "service_agent") {
-    throw new Error(
-      `[AccessControl] Canonical service_agent identity required for ${actorId}. Sync users.upsertUser before agent-bound access checks.`
-    );
-  }
-  return canonicalUser;
-}
-function requireCanonicalResolvedAgent(agent, actorId) {
-  const resolved = agent;
-  if (!resolved) {
-    throw new Error(
-      `[AccessControl] Agent "${actorId}" not found in agents or users table.`
-    );
-  }
-  if (typeof resolved.principalId !== "string" || resolved.principalId.trim().length === 0) {
-    throw new Error(
-      `[AccessControl] Canonical agent principalId required for ${actorId}.`
-    );
-  }
-  if (typeof resolved.tenantId !== "string" || resolved.tenantId.trim().length === 0) {
-    throw new Error(
-      `[AccessControl] Canonical home tenant required for ${actorId}.`
-    );
-  }
-  if (typeof resolved.workspaceId !== "string" || resolved.workspaceId.trim().length === 0) {
-    throw new Error(
-      `[AccessControl] Canonical home workspace required for ${actorId}.`
-    );
-  }
-  return {
-    principalId: resolved.principalId.trim(),
-    tenantId: resolved.tenantId.trim(),
-    workspaceId: resolved.workspaceId.trim(),
-    roles: uniqRoles(Array.isArray(resolved.roles) ? resolved.roles : []) ?? ["service_agent"],
-    groupIds: normalizeGroupIds(resolved.groupIds)
-  };
-}
-async function resolvePrincipalContext(ctx, actorId) {
-  if (actorId.startsWith("agent:")) {
-    const resolvers = resolveAccessControlAppResolvers();
-    const resolvedAgent = await resolvers.getAgentByPrincipalId(ctx, actorId);
-    if (resolvedAgent) {
-      const agent = requireCanonicalResolvedAgent(
-        resolvedAgent,
-        actorId
-      );
-      return {
-        principalId: agent.principalId,
-        principalType: "service",
-        clerkId: actorId,
-        tenantId: agent.tenantId,
-        workspaceId: agent.workspaceId,
-        roles: agent.roles.length > 0 ? agent.roles : ["service_agent"],
-        groupIds: agent.groupIds,
-        isPlatformAdmin: false,
-        isTenantAdmin: false,
-        isWorkspaceAdmin: false,
-        isSystemFallback: false
-      };
-    }
-    const resolvedUser2 = await resolvers.getUserByClerkId(
-      ctx,
-      actorId
-    );
-    if (!resolvedUser2) {
-      throw new Error(
-        `[AccessControl] Agent "${actorId}" not found in agents or users table.`
-      );
-    }
-    const user2 = requireServiceAgentUser(
-      resolvedUser2,
-      actorId
-    );
-    console.warn(
-      `[AccessControl] Deprecated legacy service-agent fallback for ${actorId}; migrate this principal into identity.agents.`
-    );
-    return {
-      principalId: user2.defaultPrincipalId,
-      principalType: "service",
-      clerkId: actorId,
-      tenantId: user2.defaultTenantId,
-      workspaceId: user2.defaultWorkspaceId,
-      roles: ["service_agent"],
-      groupIds: normalizeGroupIds(resolvedUser2?.principalGroupIds),
-      isPlatformAdmin: false,
-      isTenantAdmin: false,
-      isWorkspaceAdmin: false,
-      isSystemFallback: false
-    };
-  }
-  const {
-    resolvedUser,
-    contextClerkId
-  } = await resolveCanonicalUserRecord(ctx, actorId);
-  const user = requireCanonicalResolvedUser(
-    resolvedUser,
-    contextClerkId
-  );
-  if (!user.defaultPrincipalId) {
-    throw new Error(
-      `[AccessControl] Canonical federated principal required for ${contextClerkId}. Re-sync Master Control identity before user-bound access checks.`
-    );
-  }
-  if (user.mcRole === "service_agent") {
-    return {
-      principalId: user.defaultPrincipalId,
-      principalType: "service",
-      clerkId: contextClerkId,
-      tenantId: user.defaultTenantId,
-      workspaceId: user.defaultWorkspaceId,
-      roles: ["service_agent"],
-      groupIds: normalizeGroupIds(resolvedUser?.principalGroupIds),
-      isPlatformAdmin: false,
-      isTenantAdmin: false,
-      isWorkspaceAdmin: false,
-      isSystemFallback: false
-    };
-  }
-  const principalId = user.defaultPrincipalId;
-  const effectiveRole = user.mcRole;
-  const roles = effectiveRole === "platform_admin" ? ["platform_admin", "tenant_admin"] : effectiveRole === "tenant_admin" ? ["tenant_admin"] : [effectiveRole];
-  const tenantId = user.defaultTenantId;
-  const workspaceId = user.defaultWorkspaceId;
-  const isPlatformAdmin = effectiveRole === "platform_admin";
-  return {
-    principalId,
-    principalType: "user",
-    clerkId: contextClerkId,
-    tenantId,
-    workspaceId,
-    roles: uniqRoles(roles),
-    groupIds: normalizeGroupIds(resolvedUser?.principalGroupIds),
-    isPlatformAdmin,
-    isTenantAdmin: isPlatformAdmin || effectiveRole === "tenant_admin",
-    isWorkspaceAdmin: isPlatformAdmin || effectiveRole === "tenant_admin" || effectiveRole === "workspace_admin",
-    isSystemFallback: false
-  };
-}
-
-// ../access-control/src/access.ts
-function isTopicInPrincipalTenant(topic, principalTenantId) {
-  if (!topic.tenantId) {
-    return false;
-  }
-  if (!principalTenantId) {
-    return false;
-  }
-  return String(topic.tenantId) === String(principalTenantId);
-}
-function isTopicInPrincipalWorkspace(topic, principalWorkspaceId) {
-  if (!topic.workspaceId) {
-    return false;
-  }
-  if (!principalWorkspaceId) {
-    return false;
-  }
-  return String(topic.workspaceId) === String(principalWorkspaceId);
-}
-function isLegacyUnscopedTopic(topic) {
-  return !topic.tenantId || !topic.workspaceId;
-}
-function isGrantScopeAlignedToTopic(topic, grant) {
-  if (topic.tenantId && grant.tenantId && String(topic.tenantId) !== String(grant.tenantId)) {
-    return false;
-  }
-  if (topic.workspaceId && grant.workspaceId && String(topic.workspaceId) !== String(grant.workspaceId)) {
-    return false;
-  }
-  return true;
-}
-function isGrantSourceAllowedForVisibility(visibility, source) {
-  if (source !== "external_share") {
-    return true;
-  }
-  return visibility === "external" || visibility === "public";
-}
-function isGrantActive(grant) {
-  if (grant.status !== "active") {
-    return false;
-  }
-  if (grant.expiresAt !== void 0 && grant.expiresAt <= Date.now()) {
-    return false;
-  }
-  return true;
-}
-async function hasPrincipalGrant(ctx, args) {
-  const grants = await resolveAccessControlAppResolvers().listProjectGrantsByProjectAndPrincipal(
-    ctx,
-    args.topic._id,
-    args.principalId
-  );
-  if (grants.some(
-    (grant) => isGrantActive(grant) && isGrantScopeAlignedToTopic(args.topic, grant) && isGrantSourceAllowedForVisibility(
-      args.topic.visibility,
-      grant.source
-    ) && (!args.principalIsExternal || args.topic.visibility === "public" || grant.source === "external_share")
-  )) {
-    return true;
-  }
-  return false;
-}
-async function hasGroupGrant(ctx, args) {
-  if (args.groupIds.length === 0) {
-    return false;
-  }
-  for (const groupId of args.groupIds) {
-    const grants = await resolveAccessControlAppResolvers().listProjectGrantsByProjectAndGroup(ctx, args.topic._id, groupId);
-    if (grants.some(
-      (grant) => isGrantActive(grant) && isGrantScopeAlignedToTopic(args.topic, grant) && isGrantSourceAllowedForVisibility(
-        args.topic.visibility,
-        grant.source
-      )
-    )) {
-      return true;
-    }
-  }
-  return false;
-}
-function isExternalPrincipal(_ctx, _args) {
-  return false;
-}
-async function evaluateTopicAccessDetailed(ctx, args) {
-  if (args.legacyUserId) {
-    return {
-      hasAccess: true,
-      isAdmin: false,
-      isOwner: false,
-      isShared: false,
-      hasGrant: true,
-      isFirmVisible: true,
-      isExternalVisible: false,
-      isPublicVisible: false,
-      isTenantScopeMatch: true,
-      isWorkspaceScopeMatch: true,
-      isPrincipalExternal: false
-    };
-  }
-  const topic = await resolveAccessControlAppResolvers().getProject(
-    ctx,
-    args.topicId
-  );
-  if (!topic) {
-    return {
-      hasAccess: false,
-      isAdmin: false,
-      isOwner: false,
-      isShared: false,
-      hasGrant: false,
-      isFirmVisible: false,
-      isExternalVisible: false,
-      isPublicVisible: false,
-      isTenantScopeMatch: false,
-      isWorkspaceScopeMatch: false,
-      isPrincipalExternal: false
-    };
-  }
-  const { principalContext, legacyUserId } = args;
-  const userIsAdmin = principalContext.isPlatformAdmin;
-  const isOwner = topic.ownerId === legacyUserId;
-  const isShared = (topic.sharedWith ?? []).includes(legacyUserId);
-  const principalIsExternal = await isExternalPrincipal(ctx, {
-    groupIds: principalContext.groupIds,
-    topicTenantId: topic.tenantId,
-    topicWorkspaceId: topic.workspaceId
-  });
-  const hasPrincipalGrantResult = await hasPrincipalGrant(ctx, {
-    topic,
-    principalId: principalContext.principalId,
-    principalIsExternal
-  });
-  const hasGroupGrantResult = await hasGroupGrant(ctx, {
-    topic,
-    groupIds: principalContext.groupIds
-  });
-  const hasGrant = isShared || hasPrincipalGrantResult || hasGroupGrantResult;
-  const legacyUnscoped = isLegacyUnscopedTopic(topic);
-  const tenantScopeMatch = isTopicInPrincipalTenant(
-    topic,
-    principalContext.tenantId
-  );
-  const workspaceScopeMatch = isTopicInPrincipalWorkspace(
-    topic,
-    principalContext.workspaceId
-  );
-  const isPublicVisible = topic.visibility === "public";
-  const isFirmVisible = topic.visibility === "firm" && !legacyUnscoped && tenantScopeMatch && workspaceScopeMatch && !principalIsExternal;
-  const hasScopedGrant = hasGrant && (legacyUnscoped || tenantScopeMatch && workspaceScopeMatch);
-  const isExternalVisible = topic.visibility === "external" && hasScopedGrant;
-  const hasAccess = userIsAdmin || isOwner || hasScopedGrant || isPublicVisible || isFirmVisible;
-  return {
-    hasAccess,
-    isAdmin: userIsAdmin,
-    isOwner,
-    isShared,
-    hasGrant,
-    isFirmVisible,
-    isExternalVisible,
-    isPublicVisible,
-    isTenantScopeMatch: tenantScopeMatch,
-    isWorkspaceScopeMatch: workspaceScopeMatch,
-    isPrincipalExternal: principalIsExternal
-  };
-}
-async function checkTopicAccessDetailed(ctx, topicId, userId) {
-  const principalContext = await resolvePrincipalContext(ctx, userId);
-  return evaluateTopicAccessDetailed(ctx, {
-    topicId,
-    legacyUserId: userId,
-    principalContext
-  });
-}
-async function checkTopicAccess(ctx, topicId, userId) {
-  const result = await checkTopicAccessDetailed(ctx, topicId, userId);
-  return result.hasAccess;
-}
-async function checkScopeAccess(ctx, scopeId, userId) {
-  try {
-    const topic = await ctx.db.get(scopeId);
-    if (topic && topic.name !== void 0 && topic.type !== void 0) {
-      return true;
-    }
-  } catch {
-  }
-  try {
-    return await checkTopicAccess(ctx, scopeId, userId);
-  } catch {
-    return false;
-  }
-}
-async function requireTopicAccess(ctx, topicId, userId) {
-  const hasAccess = await checkTopicAccess(ctx, topicId, userId);
-  if (!hasAccess) {
-    throw new Error(
-      "Access denied: You don't have permission to access this topic"
-    );
-  }
-}
-var requireProjectAccess = requireTopicAccess;
-var permissiveReturn = v.optional(v.any());
-var looseJsonObject = v.record(v.string(), v.any());
-var looseJsonArray = v.array(v.any());
-v.union(
-  v.string(),
-  v.number(),
-  v.boolean(),
-  v.null(),
-  looseJsonObject,
-  looseJsonArray
-);
-var api2 = anyApi;
-componentsGeneric();
 var internal = anyApi;
 var internalMutation = internalMutationGeneric;
 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"];
@@ -1078,17 +288,17 @@ function assertOntologicalNodeSupersedeAllowed(args) {
     }
   });
 }
-var LEGACY_SCOPE_FIELD2 = "graphScopeProjectId";
+var LEGACY_SCOPE_FIELD = "graphScopeProjectId";
 function asMappedProjectId(topic) {
   if (!topic) {
     return;
   }
-  const directLegacyProjectId = normalizeScopeValue(topic[LEGACY_SCOPE_FIELD2]);
+  const directLegacyProjectId = normalizeScopeValue(topic[LEGACY_SCOPE_FIELD]);
   if (directLegacyProjectId) {
     return directLegacyProjectId;
   }
   const metadata = topic.metadata || {};
-  const candidate = metadata[LEGACY_SCOPE_FIELD2] || metadata.legacyProjectId || metadata.projectId || metadata.scopeProjectId;
+  const candidate = metadata[LEGACY_SCOPE_FIELD] || metadata.legacyProjectId || metadata.projectId || metadata.scopeProjectId;
   return candidate ? candidate : void 0;
 }
 function normalizeScopeValue(value) {
@@ -1117,9 +327,16 @@ async function findTopicsByScopeAlias(ctx, scopeId) {
   try {
     return await ctx.db.query("topics").withIndex(
       "by_graph_scope_project",
-      (q) => q.eq(LEGACY_SCOPE_FIELD2, scopeId)
+      (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);
@@ -1133,10 +350,17 @@ async function tryResolveHostTopicById(ctx, topicId) {
     return null;
   }
   try {
-    return await ctx.runQuery(api2.topics.get, {
+    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;
   }
 }
@@ -1145,10 +369,17 @@ async function tryResolveHostTopicByLegacyScope(ctx, legacyScopeId) {
     return null;
   }
   try {
-    return await ctx.runQuery(api2.topics.getByLegacyScopeId, {
+    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;
   }
 }
@@ -1177,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));
@@ -1215,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);
@@ -1264,61 +511,6 @@ var optionalScopeArgs = {
   projectId: v.optional(v.string()),
   topicId: v.optional(v.string())
 };
-
-// ../../packages/contracts/src/schema-helpers/spine/tables/epistemicNodes.ts
-var NODE_TYPES = [
-  "decision",
-  "belief",
-  "question",
-  "theme",
-  "deal",
-  "topic",
-  "claim",
-  "evidence",
-  "synthesis",
-  "answer",
-  "atomic_fact",
-  "excerpt",
-  "source",
-  "company",
-  "person",
-  "investor",
-  "function",
-  "value_chain"
-];
-function isNodeType(value) {
-  return NODE_TYPES.includes(value);
-}
-function getLayerForNodeType(type) {
-  switch (type) {
-    case "decision":
-      return "L4";
-    case "belief":
-    case "question":
-    case "theme":
-    case "deal":
-      return "L3";
-    case "claim":
-    case "evidence":
-    case "synthesis":
-    case "answer":
-      return "L2";
-    case "atomic_fact":
-    case "excerpt":
-    case "source":
-      return "L1";
-    case "topic":
-      return "organizational";
-    case "company":
-    case "person":
-    case "investor":
-    case "function":
-    case "value_chain":
-      return "ontological";
-  }
-}
-
-// src/workspaceIsolation.ts
 function normalizeScopeValue2(value) {
   if (typeof value !== "string") {
     return;
@@ -1529,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);
@@ -1566,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);
@@ -1598,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 = [];
@@ -1629,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: {
@@ -1658,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) {
@@ -1712,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 [];
       }
     }
@@ -1939,7 +1183,7 @@ var update = mutation({
       nodeId,
       operation: "upsert"
     });
-    return { success: true };
+    return buildNodeStatusSuccessResult();
   }
 });
 var supersede = mutation({
@@ -2061,7 +1305,7 @@ var archive = mutation({
         projectId: node.projectId
       });
     }
-    return { success: true, effectiveStatus: "archived" };
+    return buildNodeArchivedResult();
   }
 });
 var hardDelete = internalMutation({
@@ -2075,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,
@@ -2111,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({
@@ -2161,7 +1402,7 @@ var verify = mutation({
       projectId: node.projectId,
       triggeringAction: "epistemicNodes.verify"
     });
-    return { success: true };
+    return buildNodeStatusSuccessResult();
   }
 });
 var batchCreate = mutation({
@@ -2199,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) {
@@ -2207,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,
@@ -2292,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", {
@@ -2362,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({