@lucern/graph-primitives 1.0.29 → 1.0.30

package/dist/topicOntologyResolver.js

@@ -1,47 +1,69 @@
 // src/topicOntologyResolver.ts
 var MAX_RESOLUTION_DEPTH = 10;
+async function loadTopic(ctx, topicId) {
+  return await ctx.db.get(topicId);
+}
+async function loadOntologyDefinition(ctx, ontologyId) {
+  return await ctx.db.get(ontologyId);
+}
+async function loadPublishedOntologyVersions(ctx, ontologyId) {
+  const versions = await ctx.db.query("ontologyVersions").withIndex("by_ontologyId", (q) => q.eq("ontologyId", ontologyId)).collect();
+  return versions.filter((version) => version.status === "published").sort((a, b) => (b.publishedAt ?? 0) - (a.publishedAt ?? 0));
+}
+function resolvedTopicOntology(args) {
+  return {
+    ontologyId: args.ontologyDef._id,
+    ontologyKey: args.ontologyDef.ontologyKey,
+    ontologyName: args.ontologyDef.name,
+    publishedVersion: args.latestPublished,
+    source: args.source,
+    sourceTopicId: args.sourceTopicId,
+    tier: args.ontologyDef.tier,
+    validEdgeTypes: args.latestPublished?.edgeTypes.map((edgeType) => edgeType.value) ?? [],
+    validEntityTypes: args.latestPublished?.entityTypes.map((entityType) => entityType.value) ?? []
+  };
+}
+async function resolveCurrentTopicOntology(args) {
+  if (!args.current.ontologyId) {
+    return "continue";
+  }
+  const ontologyDef = await loadOntologyDefinition(
+    args.ctx,
+    args.current.ontologyId
+  );
+  if (!ontologyDef || ontologyDef.status === "archived") {
+    return args.current.parentTopicId ? "continue" : null;
+  }
+  const published = await loadPublishedOntologyVersions(
+    args.ctx,
+    args.current.ontologyId
+  );
+  return resolvedTopicOntology({
+    latestPublished: published[0] ?? null,
+    ontologyDef,
+    source: args.current._id === args.startTopicId ? "direct" : "inherited",
+    sourceTopicId: args.current._id
+  });
+}
 async function resolveTopicOntologyInternal(ctx, topicId) {
-  let current = await ctx.db.get(topicId);
+  let current = await loadTopic(ctx, topicId);
   if (!current) {
     return null;
   }
   const startTopicId = topicId;
   for (let i = 0; i < MAX_RESOLUTION_DEPTH && current; i++) {
-    if (current.ontologyId) {
-      const ontologyDef = await ctx.db.get(
-        current.ontologyId
-      );
-      if (!ontologyDef || ontologyDef.status === "archived") {
-        if (current.parentTopicId) {
-          current = await ctx.db.get(
-            current.parentTopicId
-          );
-          continue;
-        }
-        return null;
-      }
-      const versions = await ctx.db.query("ontologyVersions").withIndex(
-        "by_ontologyId",
-        (q) => q.eq("ontologyId", current?.ontologyId)
-      ).collect();
-      const published = versions.filter((v) => v.status === "published").sort((a, b) => (b.publishedAt ?? 0) - (a.publishedAt ?? 0));
-      const latestPublished = published[0] ?? null;
-      return {
-        ontologyId: ontologyDef._id,
-        ontologyKey: ontologyDef.ontologyKey,
-        ontologyName: ontologyDef.name,
-        tier: ontologyDef.tier,
-        source: current._id === startTopicId ? "direct" : "inherited",
-        sourceTopicId: current._id,
-        validEntityTypes: latestPublished ? latestPublished.entityTypes.map((et) => et.value) : [],
-        validEdgeTypes: latestPublished ? latestPublished.edgeTypes.map((et) => et.value) : [],
-        publishedVersion: latestPublished
-      };
+    const resolved = await resolveCurrentTopicOntology({
+      ctx,
+      current,
+      startTopicId
+    });
+    if (resolved !== "continue") {
+      return resolved;
     }
     if (!current.parentTopicId) {
       break;
     }
-    current = await ctx.db.get(current.parentTopicId);
+    current = await loadTopic(ctx, current.parentTopicId);
   }
   return null;
 }

package/dist/topicOntologyResolver.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/topicOntologyResolver.ts"],"names":[],"mappings":"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","file":"topicOntologyResolver.js","sourcesContent":["/**\n * Topic Ontology Resolution — Hybrid Inheritance\n *\n * Resolves the effective ontology for a topic by walking the parent chain.\n *\n * Strategy:\n * - If the topic has an ontologyId, return its ontology definition.\n * - Otherwise, walk up the parent chain until an ancestor with an ontologyId is found.\n * - Returns null if no ancestor in the chain has an ontology binding.\n *\n * This is a helper function callable from within Convex mutation/query handlers.\n * For the public query API, see topics.resolveTopicOntology.\n *\n * @module graph-primitives/topicOntologyResolver\n */\n\nimport type { Id } from \"./convex\";\n\n// Minimal topic shape needed for resolution (avoids importing full generated types)\ntype TopicDoc = {\n  _id: Id<\"topics\">;\n  name: string;\n  depth: number;\n  ontologyId?: Id<\"ontologyDefinitions\">;\n  parentTopicId?: Id<\"topics\">;\n};\n\ntype OntologyDef = {\n  _id: Id<\"ontologyDefinitions\">;\n  ontologyKey: string;\n  name: string;\n  tier: \"platform\" | \"pack\" | \"tenant\";\n  status: \"draft\" | \"active\" | \"deprecated\" | \"archived\";\n};\n\ntype OntologyVer = {\n  _id: Id<\"ontologyVersions\">;\n  ontologyId: Id<\"ontologyDefinitions\">;\n  version: string;\n  status: \"draft\" | \"published\" | \"deprecated\";\n  entityTypes: Array<{ value: string; label: string; description?: string }>;\n  edgeTypes: Array<{ value: string; label: string; description?: string }>;\n  publishedAt?: number;\n};\n\nexport type ResolvedTopicOntology = {\n  ontologyId: Id<\"ontologyDefinitions\">;\n  ontologyKey: string;\n  ontologyName: string;\n  tier: string;\n  source: \"direct\" | \"inherited\";\n  sourceTopicId: Id<\"topics\">;\n  /** Valid entity type values from the latest published version */\n  validEntityTypes: string[];\n  /** Valid edge type values from the latest published version */\n  validEdgeTypes: string[];\n  /** The published version, if any */\n  publishedVersion: OntologyVer | null;\n};\n\nconst MAX_RESOLUTION_DEPTH = 10;\n\n/**\n * Resolve the effective ontology for a topic.\n *\n * @param ctx - Convex mutation/query context with db access\n * @param topicId - The topic to resolve the ontology for\n * @returns The resolved ontology or null if none is bound in the ancestor chain\n */\nexport async function resolveTopicOntologyInternal(\n  ctx: { db: any },\n  topicId: Id<\"topics\">\n): Promise<ResolvedTopicOntology | null> {\n  let current = (await ctx.db.get(topicId)) as TopicDoc | null;\n  if (!current) {\n    return null;\n  }\n\n  const startTopicId = topicId;\n\n  for (let i = 0; i < MAX_RESOLUTION_DEPTH && current; i++) {\n    if (current.ontologyId) {\n      const ontologyDef = (await ctx.db.get(\n        current.ontologyId\n      )) as OntologyDef | null;\n      if (!ontologyDef || ontologyDef.status === \"archived\") {\n        // Ontology was archived or deleted — continue walking up\n        if (current.parentTopicId) {\n          current = (await ctx.db.get(\n            current.parentTopicId\n          )) as TopicDoc | null;\n          continue;\n        }\n        return null;\n      }\n\n      // Fetch the latest published version for this ontology\n      const versions = (await ctx.db\n        .query(\"ontologyVersions\")\n        .withIndex(\"by_ontologyId\", (q: any) =>\n          q.eq(\"ontologyId\", current?.ontologyId!)\n        )\n        .collect()) as OntologyVer[];\n\n      const published = versions\n        .filter((v) => v.status === \"published\")\n        .sort((a, b) => (b.publishedAt ?? 0) - (a.publishedAt ?? 0));\n\n      const latestPublished = published[0] ?? null;\n\n      return {\n        ontologyId: ontologyDef._id,\n        ontologyKey: ontologyDef.ontologyKey,\n        ontologyName: ontologyDef.name,\n        tier: ontologyDef.tier,\n        source: current._id === startTopicId ? \"direct\" : \"inherited\",\n        sourceTopicId: current._id,\n        validEntityTypes: latestPublished\n          ? latestPublished.entityTypes.map((et) => et.value)\n          : [],\n        validEdgeTypes: latestPublished\n          ? latestPublished.edgeTypes.map((et) => et.value)\n          : [],\n        publishedVersion: latestPublished,\n      };\n    }\n\n    // No ontologyId on this topic — walk up\n    if (!current.parentTopicId) {\n      break;\n    }\n    current = (await ctx.db.get(current.parentTopicId)) as TopicDoc | null;\n  }\n\n  return null;\n}\n\n/**\n * Validate that a nodeType is allowed by the resolved ontology for a topic.\n *\n * Returns { valid: true } if:\n * - The topic has no bound ontology (no constraint)\n * - The nodeType is in the ontology's published entity types\n *\n * Returns { valid: false, error } if:\n * - The topic has a bound ontology and the nodeType is not in its entity types\n */\nexport async function validateEntityTypeForTopic(\n  ctx: { db: any },\n  topicId: Id<\"topics\">,\n  nodeType: string\n): Promise<{ valid: true } | { valid: false; error: string }> {\n  const resolved = await resolveTopicOntologyInternal(ctx, topicId);\n\n  // No ontology bound — all entity types are allowed\n  if (!resolved) {\n    return { valid: true };\n  }\n\n  // No published version — ontology exists but has no content yet, allow all\n  if (resolved.validEntityTypes.length === 0) {\n    return { valid: true };\n  }\n\n  // Check if nodeType is in the ontology's entity types\n  if (resolved.validEntityTypes.includes(nodeType)) {\n    return { valid: true };\n  }\n\n  return {\n    valid: false,\n    error: `Entity type \"${nodeType}\" is not defined in the ontology \"${resolved.ontologyKey}\" (${resolved.ontologyName}). Valid entity types: ${resolved.validEntityTypes.join(\", \")}. Source: ${resolved.source} from topic ${resolved.sourceTopicId}.`,\n  };\n}\n"]}
+{"version":3,"sources":["../src/topicOntologyResolver.ts"],"names":[],"mappings":"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","file":"topicOntologyResolver.js","sourcesContent":["// biome-ignore-all lint/style/useFilenamingConvention: Public graph-primitives wildcard-export path; rename requires an export-map migration.\n/**\n * Topic Ontology Resolution — Hybrid Inheritance\n *\n * Resolves the effective ontology for a topic by walking the parent chain.\n *\n * Strategy:\n * - If the topic has an ontologyId, return its ontology definition.\n * - Otherwise, walk up the parent chain until an ancestor with an ontologyId is found.\n * - Returns null if no ancestor in the chain has an ontology binding.\n *\n * This is a helper function callable from within Convex mutation/query handlers.\n * For the public query API, see topics.resolveTopicOntology.\n *\n * @module graph-primitives/topicOntologyResolver\n */\n\nimport type { DatabaseReader, Id } from \"./convex\";\n\n// Minimal topic shape needed for resolution (avoids importing full generated types)\ninterface TopicDoc {\n  _id: Id<\"topics\">;\n  depth: number;\n  name: string;\n  ontologyId?: Id<\"ontologyDefinitions\">;\n  parentTopicId?: Id<\"topics\">;\n}\n\ninterface OntologyDef {\n  _id: Id<\"ontologyDefinitions\">;\n  name: string;\n  ontologyKey: string;\n  status: \"draft\" | \"active\" | \"deprecated\" | \"archived\";\n  tier: \"platform\" | \"pack\" | \"tenant\";\n}\n\ninterface OntologyVer {\n  _id: Id<\"ontologyVersions\">;\n  edgeTypes: Array<{ value: string; label: string; description?: string }>;\n  entityTypes: Array<{ value: string; label: string; description?: string }>;\n  ontologyId: Id<\"ontologyDefinitions\">;\n  publishedAt?: number;\n  status: \"draft\" | \"published\" | \"deprecated\";\n  version: string;\n}\n\nexport interface ResolvedTopicOntology {\n  ontologyId: Id<\"ontologyDefinitions\">;\n  ontologyKey: string;\n  ontologyName: string;\n  /** The published version, if any */\n  publishedVersion: OntologyVer | null;\n  source: \"direct\" | \"inherited\";\n  sourceTopicId: Id<\"topics\">;\n  tier: string;\n  /** Valid edge type values from the latest published version */\n  validEdgeTypes: string[];\n  /** Valid entity type values from the latest published version */\n  validEntityTypes: string[];\n}\n\nconst MAX_RESOLUTION_DEPTH = 10;\n\ninterface TopicOntologyCtx {\n  db: DatabaseReader;\n}\n\nasync function loadTopic(\n  ctx: TopicOntologyCtx,\n  topicId: Id<\"topics\">\n): Promise<TopicDoc | null> {\n  return (await ctx.db.get(topicId)) as unknown as TopicDoc | null;\n}\n\nasync function loadOntologyDefinition(\n  ctx: TopicOntologyCtx,\n  ontologyId: Id<\"ontologyDefinitions\">\n): Promise<OntologyDef | null> {\n  return (await ctx.db.get(ontologyId)) as unknown as OntologyDef | null;\n}\n\nasync function loadPublishedOntologyVersions(\n  ctx: TopicOntologyCtx,\n  ontologyId: Id<\"ontologyDefinitions\">\n): Promise<OntologyVer[]> {\n  const versions = (await ctx.db\n    .query(\"ontologyVersions\")\n    .withIndex(\"by_ontologyId\", (q) => q.eq(\"ontologyId\", ontologyId))\n    .collect()) as unknown as OntologyVer[];\n\n  return versions\n    .filter((version) => version.status === \"published\")\n    .sort((a, b) => (b.publishedAt ?? 0) - (a.publishedAt ?? 0));\n}\n\nfunction resolvedTopicOntology(args: {\n  latestPublished: OntologyVer | null;\n  ontologyDef: OntologyDef;\n  source: \"direct\" | \"inherited\";\n  sourceTopicId: Id<\"topics\">;\n}): ResolvedTopicOntology {\n  return {\n    ontologyId: args.ontologyDef._id,\n    ontologyKey: args.ontologyDef.ontologyKey,\n    ontologyName: args.ontologyDef.name,\n    publishedVersion: args.latestPublished,\n    source: args.source,\n    sourceTopicId: args.sourceTopicId,\n    tier: args.ontologyDef.tier,\n    validEdgeTypes:\n      args.latestPublished?.edgeTypes.map((edgeType) => edgeType.value) ?? [],\n    validEntityTypes:\n      args.latestPublished?.entityTypes.map((entityType) => entityType.value) ??\n      [],\n  };\n}\n\nasync function resolveCurrentTopicOntology(args: {\n  ctx: TopicOntologyCtx;\n  current: TopicDoc;\n  startTopicId: Id<\"topics\">;\n}): Promise<ResolvedTopicOntology | \"continue\" | null> {\n  if (!args.current.ontologyId) {\n    return \"continue\";\n  }\n\n  const ontologyDef = await loadOntologyDefinition(\n    args.ctx,\n    args.current.ontologyId\n  );\n  if (!ontologyDef || ontologyDef.status === \"archived\") {\n    return args.current.parentTopicId ? \"continue\" : null;\n  }\n\n  const published = await loadPublishedOntologyVersions(\n    args.ctx,\n    args.current.ontologyId\n  );\n\n  return resolvedTopicOntology({\n    latestPublished: published[0] ?? null,\n    ontologyDef,\n    source: args.current._id === args.startTopicId ? \"direct\" : \"inherited\",\n    sourceTopicId: args.current._id,\n  });\n}\n\n/**\n * Resolve the effective ontology for a topic.\n *\n * @param ctx - Convex mutation/query context with db access\n * @param topicId - The topic to resolve the ontology for\n * @returns The resolved ontology or null if none is bound in the ancestor chain\n */\nexport async function resolveTopicOntologyInternal(\n  ctx: TopicOntologyCtx,\n  topicId: Id<\"topics\">\n): Promise<ResolvedTopicOntology | null> {\n  let current = await loadTopic(ctx, topicId);\n  if (!current) {\n    return null;\n  }\n\n  const startTopicId = topicId;\n\n  for (let i = 0; i < MAX_RESOLUTION_DEPTH && current; i++) {\n    const resolved = await resolveCurrentTopicOntology({\n      ctx,\n      current,\n      startTopicId,\n    });\n    if (resolved !== \"continue\") {\n      return resolved;\n    }\n\n    // No ontologyId on this topic — walk up\n    if (!current.parentTopicId) {\n      break;\n    }\n    current = await loadTopic(ctx, current.parentTopicId);\n  }\n\n  return null;\n}\n\n/**\n * Validate that a nodeType is allowed by the resolved ontology for a topic.\n *\n * Returns { valid: true } if:\n * - The topic has no bound ontology (no constraint)\n * - The nodeType is in the ontology's published entity types\n *\n * Returns { valid: false, error } if:\n * - The topic has a bound ontology and the nodeType is not in its entity types\n */\nexport async function validateEntityTypeForTopic(\n  ctx: TopicOntologyCtx,\n  topicId: Id<\"topics\">,\n  nodeType: string\n): Promise<{ valid: true } | { valid: false; error: string }> {\n  const resolved = await resolveTopicOntologyInternal(ctx, topicId);\n\n  // No ontology bound — all entity types are allowed\n  if (!resolved) {\n    return { valid: true };\n  }\n\n  // No published version — ontology exists but has no content yet, allow all\n  if (resolved.validEntityTypes.length === 0) {\n    return { valid: true };\n  }\n\n  // Check if nodeType is in the ontology's entity types\n  if (resolved.validEntityTypes.includes(nodeType)) {\n    return { valid: true };\n  }\n\n  return {\n    valid: false,\n    error: `Entity type \"${nodeType}\" is not defined in the ontology \"${resolved.ontologyKey}\" (${resolved.ontologyName}). Valid entity types: ${resolved.validEntityTypes.join(\", \")}. Source: ${resolved.source} from topic ${resolved.sourceTopicId}.`,\n  };\n}\n"]}

package/dist/topicProjectOverlay.d.ts

@@ -1,30 +1,35 @@
+import { DatabaseReader, DatabaseWriter, MutationCtx, QueryCtx } from './convex.js';
+import '@lucern/access-control/convex';
+import '@lucern/contracts/convex/unsafeAnyApi';
+import 'convex/values';
+
 type OverlayIdMode = "legacy" | "topic";
-type LegacyProjectThesis = {
-    statement: string;
+interface LegacyProjectThesis {
     confidence: number;
     lastUpdated: number;
-};
+    statement: string;
+}
 type LegacyPillarImportance = "critical" | "major" | "minor" | "not_applicable";
-type LegacyThesisPillarConfig = {
-    pillarImportance?: Record<string, LegacyPillarImportance | undefined>;
-    configuredAt?: number;
-    configuredBy?: string;
+interface LegacyThesisPillarConfig {
     aiSuggestion?: {
         suggestedAt: number;
         reasoning: string;
     };
-};
-type LegacyBeliefArchitecture = {
-    overallMaturity: number;
-    pillarScores: Array<Record<string, unknown>>;
+    configuredAt?: number;
+    configuredBy?: string;
+    pillarImportance?: Record<string, LegacyPillarImportance | undefined>;
+}
+interface LegacyBeliefArchitecture {
     lastCalculated: number;
-};
-type LegacyOntologyClassification = {
-    valueChains: Array<Record<string, unknown>>;
-    functions: Array<Record<string, unknown>>;
-    overallConfidence: number;
+    overallMaturity: number;
+    pillarScores: Record<string, unknown>[];
+}
+interface LegacyOntologyClassification {
     classifiedAt: number;
-};
+    functions: Record<string, unknown>[];
+    overallConfidence: number;
+    valueChains: Record<string, unknown>[];
+}
 type TopicDocLike = Record<string, unknown> & {
     _id: string;
     _creationTime?: number;
@@ -77,16 +82,21 @@ type TopicProjectOverlay = Record<string, unknown> & {
     createdAt: number;
     updatedAt: number;
 };
+interface OverlayContext {
+    db?: Pick<DatabaseReader, "get" | "query"> & Partial<Pick<DatabaseWriter, "patch">>;
+    runMutation?: MutationCtx["runMutation"];
+    runQuery?: QueryCtx["runQuery"];
+}
 declare function materializeTopicProjectOverlay(topic: TopicDocLike, idMode?: OverlayIdMode): TopicProjectOverlay;
-declare function resolveTopicProjectOverlay(ctx: any, scopeId: string, options?: {
+declare function resolveTopicProjectOverlay(ctx: OverlayContext, scopeId: string, options?: {
     idMode?: OverlayIdMode;
     projectLikeOnly?: boolean;
 }): Promise<TopicProjectOverlay | null>;
-declare function listTopicProjectOverlays(ctx: any, options?: {
+declare function listTopicProjectOverlays(ctx: OverlayContext, options?: {
     idMode?: OverlayIdMode;
     projectLikeOnly?: boolean;
 }): Promise<TopicProjectOverlay[]>;
-declare function patchTopicProjectOverlay(ctx: any, scopeId: string, value: Record<string, unknown>): Promise<TopicProjectOverlay | null>;
+declare function patchTopicProjectOverlay(ctx: OverlayContext, scopeId: string, value: Record<string, unknown>): Promise<TopicProjectOverlay | null>;
 declare function matchesTopicProjectOverlayAccess(accessibleProjectIds: Set<string>, project: {
     topicId: string;
     legacyProjectId?: string;

package/dist/topicProjectOverlay.js

@@ -1,7 +1,11 @@
-import { componentsGeneric, anyApi } from 'convex/server';
+import { unsafeConvexAnyApi } from '@lucern/contracts/convex/unsafeAnyApi';
+import { componentsGeneric } from 'convex/server';
 
 // src/convex.ts
-var api = anyApi;
+var unsafeApi = unsafeConvexAnyApi(
+  "graph-primitives top-level module bundle lacks a committed Convex _generated/api surface"
+);
+var api = unsafeApi;
 componentsGeneric();
 
 // src/debug.ts
@@ -34,6 +38,10 @@ 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;
@@ -114,9 +122,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;
     }
@@ -136,8 +147,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,
@@ -206,90 +227,113 @@ async function patchTopicProjectOverlay(ctx, scopeId, value) {
   if (!topic) {
     return null;
   }
-  const nextMetadata = { ...readMetadata(topic) };
-  const patch = {};
-  const topicUpdateArgs = {
-    id: String(topic._id)
+  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)) {
-    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;
-        }
-    }
+    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;
   }
-  patch.updatedAt = Date.now();
-  patch.metadata = nextMetadata;
-  topicUpdateArgs.metadata = nextMetadata;
+}
+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, topicUpdateArgs);
+      await ctx.runMutation(api.topics.update, plan.topicUpdateArgs);
     } catch (error) {
-      if (!isMissingLucernChildComponentError(error) || !ctx?.db || typeof ctx.db.patch !== "function") {
+      if (!canPatchTopicViaLocalDb(ctx, error)) {
         throw error;
       }
-      await ctx.db.patch(String(topic._id), patch);
+      await ctx.db.patch(topic._id, plan.patch);
     }
   } else if (ctx?.db && typeof ctx.db.patch === "function") {
-    await ctx.db.patch(String(topic._id), patch);
+    await ctx.db.patch(topic._id, plan.patch);
   } else {
     throw new Error(
       "Cannot patch topic without component adapter (ctx.runMutation unavailable)"
     );
   }
-  return materializeTopicProjectOverlay({
-    ...topic,
-    ...patch,
-    metadata: nextMetadata
-  });
+}
+function canPatchTopicViaLocalDb(ctx, error) {
+  return isMissingLucernChildComponentError(error) && Boolean(ctx?.db) && typeof ctx.db?.patch === "function";
 }
 function matchesTopicProjectOverlayAccess(accessibleProjectIds, project) {
   return accessibleProjectIds.has(project.storageProjectId || project.topicId) || accessibleProjectIds.has(project.topicId) || typeof project.legacyProjectId === "string" && accessibleProjectIds.has(project.legacyProjectId);

package/dist/topicProjectOverlay.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/convex.ts","../src/debug.ts","../src/topicProjectOverlay.ts"],"names":[],"mappings":"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","file":"topicProjectOverlay.js","sourcesContent":["import {\n  actionGeneric,\n  anyApi,\n  componentsGeneric,\n  httpActionGeneric,\n  internalActionGeneric,\n  internalMutationGeneric,\n  internalQueryGeneric,\n  mutationGeneric,\n  queryGeneric,\n} from \"convex/server\";\nimport type { GenericId } from \"convex/values\";\n\n// TODO(FR.11-structural): `api`/`internal`/`components` are `anyApi as any`\n// because this module source tree is bundled into the kernel host at deploy time\n// and has NO top-level Convex `_generated/` directory to import a typed surface\n// from. Every `api.*` / `internal.*` / string-literal cross-component ref in this\n// module (topicScope.ts, topicProjectOverlay.ts, questionEvidenceLinks.ts,\n// beliefEvidenceLinks*.ts, epistemicQuestions.helpers.ts) inherits `any` from\n// here. The fix is structural — generate a per-module typed surface or a shared\n// typed function-reference manifest (template: the typed `components.controlPlane`\n// in modules/control-plane/src/component/convex.ts and the\n// `KERNEL_API_REF_MANIFEST` pattern in packages/server-core/src/kernelApi.ts) —\n// owned by the FR.11 closing/synthesis pass, not a mechanical swap.\nexport const api = anyApi as any;\nexport const components = componentsGeneric() as any;\nexport const internal = anyApi as any;\n\nexport type TableNames = string;\nexport type Id<TableName extends TableNames = string> = GenericId<TableName>;\nexport type Doc<TableName extends TableNames = string> = any;\nexport type DataModel = any;\ntype IndexRangeBuilder = {\n  field(fieldName: string): string;\n  eq(fieldName: string, value: unknown): IndexRangeBuilder;\n  gt(fieldName: string, value: unknown): IndexRangeBuilder;\n  gte(fieldName: string, value: unknown): IndexRangeBuilder;\n  lt(fieldName: string, value: unknown): IndexRangeBuilder;\n  lte(fieldName: string, value: unknown): IndexRangeBuilder;\n};\ntype FilterBuilder = {\n  eq(left: unknown, right: unknown): unknown;\n  neq(left: unknown, right: unknown): unknown;\n  gt(left: unknown, right: unknown): unknown;\n  gte(left: unknown, right: unknown): unknown;\n  lt(left: unknown, right: unknown): unknown;\n  lte(left: unknown, right: unknown): unknown;\n  and(...clauses: unknown[]): unknown;\n  or(...clauses: unknown[]): unknown;\n  field(fieldName: string): unknown;\n};\ntype QueryInitializer<TableName extends TableNames> = {\n  withIndex(\n    indexName: string,\n    range?: (q: any) => unknown\n  ): QueryInitializer<TableName>;\n  filter(predicate: (q: any) => unknown): QueryInitializer<TableName>;\n  order(direction: \"asc\" | \"desc\"): QueryInitializer<TableName>;\n  collect(): Promise<Doc<TableName>[]>;\n  take(limit: number): Promise<Doc<TableName>[]>;\n  first(): Promise<Doc<TableName> | null>;\n  unique(): Promise<Doc<TableName> | null>;\n};\nexport type DatabaseReader = {\n  get<TableName extends TableNames>(\n    id: Id<TableName>\n  ): Promise<Doc<TableName> | null>;\n  query<TableName extends TableNames>(\n    tableName: TableName\n  ): QueryInitializer<TableName>;\n  normalizeId?<TableName extends TableNames>(\n    tableName: TableName,\n    id: string\n  ): Id<TableName> | null;\n};\nexport type DatabaseWriter = DatabaseReader & {\n  insert<TableName extends TableNames>(\n    tableName: TableName,\n    value: Record<string, unknown>\n  ): Promise<Id<TableName>>;\n  patch<TableName extends TableNames>(\n    id: Id<TableName>,\n    value: Record<string, unknown>\n  ): Promise<void>;\n  replace<TableName extends TableNames>(\n    id: Id<TableName>,\n    value: Record<string, unknown>\n  ): Promise<void>;\n  delete<TableName extends TableNames>(id: Id<TableName>): Promise<void>;\n};\ntype Scheduler = {\n  runAfter(delayMs: number, functionReference: unknown, args?: unknown): Promise<void>;\n};\ntype AuthReader = {\n  getUserIdentity(): Promise<unknown>;\n};\ntype RuntimeInvoker = {\n  runQuery(functionReference: unknown, args?: unknown): Promise<any>;\n  runMutation(functionReference: unknown, args?: unknown): Promise<any>;\n  runAction(functionReference: unknown, args?: unknown): Promise<any>;\n};\nexport type QueryCtx = RuntimeInvoker & {\n  auth: AuthReader;\n  db: DatabaseReader;\n  scheduler: Scheduler;\n};\nexport type MutationCtx = RuntimeInvoker & {\n  auth: AuthReader;\n  db: DatabaseWriter;\n  scheduler: Scheduler;\n};\nexport type ActionCtx = RuntimeInvoker & {\n  auth: AuthReader;\n  scheduler: Scheduler;\n};\n\ntype ConvexFunctionBuilder<Ctx> = <\n  Definition extends { handler?: (ctx: Ctx, args: any) => any },\n>(\n  definition: Definition\n) => any;\n\nexport const action = actionGeneric as unknown as ConvexFunctionBuilder<ActionCtx>;\nexport const httpAction =\n  httpActionGeneric as unknown as ConvexFunctionBuilder<ActionCtx>;\nexport const internalAction =\n  internalActionGeneric as unknown as ConvexFunctionBuilder<ActionCtx>;\nexport const internalMutation =\n  internalMutationGeneric as unknown as ConvexFunctionBuilder<MutationCtx>;\nexport const internalQuery =\n  internalQueryGeneric as unknown as ConvexFunctionBuilder<QueryCtx>;\nexport const mutation =\n  mutationGeneric as unknown as ConvexFunctionBuilder<MutationCtx>;\nexport const query = queryGeneric as unknown as ConvexFunctionBuilder<QueryCtx>;\n","type GraphPrimitiveDebugEnvironment = {\n  process?: {\n    env?: Record<string, string | undefined>;\n  };\n};\n\nfunction isGraphPrimitiveDebugEnabled(): boolean {\n  const env = (globalThis as GraphPrimitiveDebugEnvironment).process?.env;\n  return (\n    env?.LUCERN_COMPAT_FALLBACK_DEBUG === \"1\" ||\n    env?.LUCERN_GRAPH_DEBUG === \"1\"\n  );\n}\n\nexport function formatGraphPrimitiveError(error: unknown): string {\n  if (error instanceof Error) {\n    return `${error.name}: ${error.message}`;\n  }\n  if (typeof error === \"string\") {\n    return error;\n  }\n  if (error === null) {\n    return \"null\";\n  }\n  if (error === undefined) {\n    return \"undefined\";\n  }\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return Object.prototype.toString.call(error);\n  }\n}\n\nexport function debugGraphPrimitiveFallback(\n  message: string,\n  context?: Record<string, unknown>\n): void {\n  if (!isGraphPrimitiveDebugEnabled()) {\n    return;\n  }\n  console.debug(message, context ?? {});\n}\n","import { api } from \"./convex\";\nimport { debugGraphPrimitiveFallback } from \"./debug\";\n\ntype OverlayIdMode = \"legacy\" | \"topic\";\nconst LEGACY_SCOPE_FIELD = \"graphScope\" + \"ProjectId\";\n\ntype LegacyProjectThesis = {\n  statement: string;\n  confidence: number;\n  lastUpdated: number;\n};\n\ntype LegacyPillarImportance = \"critical\" | \"major\" | \"minor\" | \"not_applicable\";\n\ntype LegacyThesisPillarConfig = {\n  pillarImportance?: Record<string, LegacyPillarImportance | undefined>;\n  configuredAt?: number;\n  configuredBy?: string;\n  aiSuggestion?: {\n    suggestedAt: number;\n    reasoning: string;\n  };\n};\n\ntype LegacyBeliefArchitecture = {\n  overallMaturity: number;\n  pillarScores: Array<Record<string, unknown>>;\n  lastCalculated: number;\n};\n\ntype LegacyOntologyClassification = {\n  valueChains: Array<Record<string, unknown>>;\n  functions: Array<Record<string, unknown>>;\n  overallConfidence: number;\n  classifiedAt: number;\n};\n\ntype TopicDocLike = Record<string, unknown> & {\n  _id: string;\n  _creationTime?: number;\n  globalId?: string;\n  name?: string;\n  description?: string;\n  type?: string;\n  tenantId?: string;\n  workspaceId?: string;\n  status?: string;\n  visibility?: string;\n  createdBy?: string;\n  /** FR.7 creator-grant: the exact acting principal recorded as owner-principal. */\n  ownerPrincipalId?: string;\n  createdAt?: number;\n  updatedAt?: number;\n  metadata?: Record<string, unknown>;\n};\n\nexport type TopicProjectOverlay = Record<string, unknown> & {\n  _id: string;\n  projectId: string;\n  topicId: string;\n  storageProjectId: string;\n  legacyProjectId?: string;\n  name: string;\n  type: string;\n  description?: string;\n  ownerId: string;\n  /** FR.7 creator-grant: principal-shaped owner; distinct from clerkId-shaped ownerId. */\n  ownerPrincipalId?: string;\n  sharedWith: string[];\n  visibility: \"private\" | \"team\" | \"firm\" | \"external\" | \"public\";\n  tenantId?: string;\n  workspaceId?: string;\n  status: \"active\" | \"archived\" | \"watching\";\n  tags: string[];\n  chatCount: number;\n  artifactCount: number;\n  lastActivityAt: number;\n  thesis?: LegacyProjectThesis;\n  wedgeHypothesis?: string;\n  founderArchetype?: string;\n  investmentCriteria?: string[];\n  sprintPhase?:\n    | \"pre_sprint\"\n    | \"readiness_check\"\n    | \"thesis_crystallization\"\n    | \"sprint_planning\"\n    | \"active_sprint\"\n    | \"theme_assembly\"\n    | \"evolution\";\n  currentSprintIndex?: number;\n  thesisPillarConfig?: LegacyThesisPillarConfig;\n  beliefArchitecture?: LegacyBeliefArchitecture;\n  ontologyClassification?: LegacyOntologyClassification;\n  _creationTime: number;\n  createdAt: number;\n  updatedAt: number;\n};\n\nfunction readNonEmptyString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return;\n  }\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : undefined;\n}\n\nfunction readStringArray(value: unknown): string[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  return value\n    .map((entry) => readNonEmptyString(entry))\n    .filter((entry): entry is string => Boolean(entry));\n}\n\nfunction readMetadata(topic: TopicDocLike): Record<string, unknown> {\n  return topic.metadata && typeof topic.metadata === \"object\"\n    ? topic.metadata\n    : {};\n}\n\nfunction readLegacyProjectId(\n  value: Record<string, unknown> | null | undefined,\n): string | undefined {\n  if (!value) {\n    return;\n  }\n  return readNonEmptyString(value[LEGACY_SCOPE_FIELD]);\n}\n\nfunction coerceVisibility(\n  value: unknown,\n): TopicProjectOverlay[\"visibility\"] | undefined {\n  return value === \"private\" ||\n    value === \"team\" ||\n    value === \"firm\" ||\n    value === \"external\" ||\n    value === \"public\"\n    ? value\n    : undefined;\n}\n\nfunction coerceStatus(\n  value: unknown,\n): TopicProjectOverlay[\"status\"] | undefined {\n  return value === \"active\" || value === \"archived\" || value === \"watching\"\n    ? value\n    : undefined;\n}\n\nfunction mapProjectType(\n  topic: TopicDocLike,\n  metadata: Record<string, unknown>,\n): string {\n  const explicit = readNonEmptyString(metadata.projectType);\n  if (explicit) {\n    return explicit;\n  }\n  if (topic.type === \"theme\") {\n    return \"thematic\";\n  }\n  return readNonEmptyString(topic.type) || \"general\";\n}\n\nfunction isProjectLikeTopic(topic: TopicDocLike): boolean {\n  const metadata = readMetadata(topic);\n  return (\n    topic.type === \"theme\" ||\n    topic.type === \"thematic\" ||\n    topic.type === \"deal\" ||\n    topic.type === \"monitoring\" ||\n    readLegacyProjectId(topic) !== undefined ||\n    readNonEmptyString(metadata.projectType) !== undefined\n  );\n}\n\nfunction isMissingLucernChildComponentError(error: unknown): boolean {\n  const message = getErrorMessage(error);\n  return (\n    message.includes(\n      'Child component ComponentName(Identifier(\"lucern\")) not found',\n    ) ||\n    (message.includes(\"Child component\") &&\n      message.includes(\"lucern\") &&\n      message.includes(\"not found\"))\n  );\n}\n\nfunction getErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n  if (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"message\" in error &&\n    typeof (error as { message?: unknown }).message === \"string\"\n  ) {\n    return (error as { message: string }).message;\n  }\n  return \"unknown error\";\n}\n\nasync function resolveTopicDoc(\n  ctx: any,\n  scopeId: string,\n): Promise<TopicDocLike | null> {\n  if (ctx?.db && typeof ctx.db.get === \"function\") {\n    try {\n      const directTopic = (await ctx.db.get(\n        scopeId as any,\n      )) as TopicDocLike | null;\n      if (directTopic) {\n        return directTopic;\n      }\n    } catch (error) {\n      debugGraphPrimitiveFallback(\n        \"[topicProjectOverlay] Failed to resolve topic by direct ID\",\n        {\n          error,\n          scopeId,\n        },\n      );\n      // Not a direct topics-table id.\n    }\n  }\n\n  if (typeof ctx.runQuery !== \"function\") {\n    return null;\n  }\n\n  try {\n    const topic = await ctx.runQuery(api.topics.get as any, {\n      id: String(scopeId),\n    });\n    if (topic?.name !== undefined && topic?.type !== undefined) {\n      return topic as TopicDocLike;\n    }\n  } catch (error) {\n    debugGraphPrimitiveFallback(\n      \"[topicProjectOverlay] Failed to resolve topic by ID query\",\n      {\n        error,\n        scopeId,\n      },\n    );\n    // Fall through to legacy-scope lookup.\n  }\n\n  try {\n    const topic = await ctx.runQuery(api.topics.getByLegacyScopeId as any, {\n      projectId: String(scopeId),\n    });\n    if (topic?.name !== undefined && topic?.type !== undefined) {\n      return topic as TopicDocLike;\n    }\n  } catch (error) {\n    debugGraphPrimitiveFallback(\n      \"[topicProjectOverlay] Failed to resolve topic by legacy scope ID\",\n      { error, scopeId },\n    );\n    // Best-effort compat lookup only.\n  }\n\n  return null;\n}\n\nexport function materializeTopicProjectOverlay(\n  topic: TopicDocLike,\n  idMode: OverlayIdMode = \"legacy\",\n): TopicProjectOverlay {\n  const metadata = readMetadata(topic);\n  const topicId = String(topic._id);\n  const legacyProjectId =\n    readLegacyProjectId(topic) ||\n    readLegacyProjectId(metadata) ||\n    readNonEmptyString(metadata.legacyProjectId);\n  const storageProjectId = legacyProjectId || topicId;\n  const outwardId = idMode === \"topic\" ? topicId : storageProjectId;\n  const visibility =\n    coerceVisibility(topic.visibility) ||\n    coerceVisibility(metadata.visibility) ||\n    \"private\";\n  const status =\n    coerceStatus(topic.status) || coerceStatus(metadata.status) || \"active\";\n  const createdAt =\n    typeof topic.createdAt === \"number\"\n      ? topic.createdAt\n      : typeof topic._creationTime === \"number\"\n        ? topic._creationTime\n        : 0;\n  const updatedAt =\n    typeof topic.updatedAt === \"number\"\n      ? topic.updatedAt\n      : typeof metadata.updatedAt === \"number\"\n        ? (metadata.updatedAt as number)\n        : createdAt;\n\n  return {\n    ...metadata,\n    _id: outwardId,\n    projectId: outwardId,\n    topicId,\n    storageProjectId,\n    legacyProjectId,\n    name: readNonEmptyString(topic.name) || \"Untitled Theme\",\n    type: mapProjectType(topic, metadata),\n    description: readNonEmptyString(topic.description),\n    ownerId:\n      readNonEmptyString(metadata.ownerId) ||\n      readNonEmptyString(topic.createdBy) ||\n      \"system\",\n    // FR.7 creator-grant: surface the principal-shaped owner field (column-first,\n    // metadata fallback for legacy rows that recorded it in metadata).\n    ownerPrincipalId:\n      readNonEmptyString(topic.ownerPrincipalId) ||\n      readNonEmptyString(metadata.ownerPrincipalId),\n    // RR.1 carrier: preserve the nested metadata carrier so the kernel's\n    // `checkProjectAccessDetailed` metadata-PRIMARY read\n    // (`project.metadata?.ownerPrincipalId`) resolves the grant. The `...metadata`\n    // spread above only flattens keys; it does not leave a nested `metadata`.\n    metadata,\n    sharedWith: readStringArray(metadata.sharedWith),\n    visibility,\n    tenantId:\n      readNonEmptyString(topic.tenantId) ||\n      readNonEmptyString(metadata.tenantId),\n    workspaceId:\n      readNonEmptyString(topic.workspaceId) ||\n      readNonEmptyString(metadata.workspaceId),\n    status,\n    tags: readStringArray(metadata.tags),\n    chatCount:\n      typeof metadata.chatCount === \"number\"\n        ? (metadata.chatCount as number)\n        : 0,\n    artifactCount:\n      typeof metadata.artifactCount === \"number\"\n        ? (metadata.artifactCount as number)\n        : 0,\n    lastActivityAt:\n      typeof metadata.lastActivityAt === \"number\"\n        ? (metadata.lastActivityAt as number)\n        : updatedAt,\n    _creationTime:\n      typeof topic._creationTime === \"number\" ? topic._creationTime : createdAt,\n    createdAt,\n    updatedAt,\n  };\n}\n\nexport async function resolveTopicProjectOverlay(\n  ctx: any,\n  scopeId: string,\n  options: {\n    idMode?: OverlayIdMode;\n    projectLikeOnly?: boolean;\n  } = {},\n): Promise<TopicProjectOverlay | null> {\n  const topic = await resolveTopicDoc(ctx, scopeId);\n  if (!topic) {\n    return null;\n  }\n  if (options.projectLikeOnly !== false && !isProjectLikeTopic(topic)) {\n    return null;\n  }\n  return materializeTopicProjectOverlay(topic, options.idMode);\n}\n\nexport async function listTopicProjectOverlays(\n  ctx: any,\n  options: {\n    idMode?: OverlayIdMode;\n    projectLikeOnly?: boolean;\n  } = {},\n): Promise<TopicProjectOverlay[]> {\n  let allTopics: TopicDocLike[] = [];\n\n  if (ctx?.db?.query && typeof ctx.db.query === \"function\") {\n    try {\n      allTopics = (await ctx.db.query(\"topics\").collect()) as TopicDocLike[];\n    } catch (error) {\n      debugGraphPrimitiveFallback(\n        \"[topicProjectOverlay] Failed to read topics table; falling back to API\",\n        { error },\n      );\n      allTopics = [];\n    }\n  }\n\n  if (allTopics.length === 0 && typeof ctx.runQuery === \"function\") {\n    allTopics =\n      (((await ctx.runQuery(api.topics.list as any, {})) ??\n        []) as TopicDocLike[]) || [];\n  }\n\n  return allTopics\n    .filter(\n      (topic) => options.projectLikeOnly === false || isProjectLikeTopic(topic),\n    )\n    .map((topic) => materializeTopicProjectOverlay(topic, options.idMode));\n}\n\nexport async function patchTopicProjectOverlay(\n  ctx: any,\n  scopeId: string,\n  value: Record<string, unknown>,\n): Promise<TopicProjectOverlay | null> {\n  const topic = await resolveTopicDoc(ctx, scopeId);\n  if (!topic) {\n    return null;\n  }\n\n  const nextMetadata = { ...readMetadata(topic) };\n  const patch: Record<string, unknown> = {};\n  const topicUpdateArgs: Record<string, unknown> = {\n    id: String(topic._id),\n  };\n\n  for (const [key, rawValue] of Object.entries(value)) {\n    switch (key) {\n      case \"_id\":\n      case \"projectId\":\n      case \"topicId\":\n      case \"legacyProjectId\":\n      case \"storageProjectId\":\n        break;\n      case \"name\":\n      case \"description\":\n        patch[key] = rawValue;\n        topicUpdateArgs[key] = rawValue;\n        break;\n      case \"tenantId\":\n      case \"workspaceId\":\n      case \"ownerId\":\n        throw new Error(\n          `patchTopicProjectOverlay cannot mutate ${key} via component-owned topics`,\n        );\n      case \"status\": {\n        const status = coerceStatus(rawValue);\n        if (status) {\n          patch.status = status;\n          topicUpdateArgs.status = status;\n        }\n        break;\n      }\n      case \"visibility\": {\n        const visibility = coerceVisibility(rawValue);\n        if (visibility) {\n          patch.visibility = visibility;\n          topicUpdateArgs.visibility = visibility;\n        }\n        break;\n      }\n      case \"type\": {\n        const projectType = readNonEmptyString(rawValue);\n        if (projectType) {\n          nextMetadata.projectType = projectType;\n        } else {\n          delete nextMetadata.projectType;\n        }\n        break;\n      }\n      case \"updatedAt\":\n      case \"createdAt\":\n        break;\n      default:\n        if (rawValue === undefined) {\n          delete nextMetadata[key];\n        } else {\n          nextMetadata[key] = rawValue;\n        }\n    }\n  }\n\n  patch.updatedAt = Date.now();\n  patch.metadata = nextMetadata;\n  topicUpdateArgs.metadata = nextMetadata;\n\n  if (typeof ctx.runMutation === \"function\") {\n    try {\n      await ctx.runMutation(api.topics.update as any, topicUpdateArgs);\n    } catch (error) {\n      if (\n        !isMissingLucernChildComponentError(error) ||\n        !ctx?.db ||\n        typeof ctx.db.patch !== \"function\"\n      ) {\n        throw error;\n      }\n      await ctx.db.patch(String(topic._id) as any, patch);\n    }\n  } else if (ctx?.db && typeof ctx.db.patch === \"function\") {\n    await ctx.db.patch(String(topic._id) as any, patch);\n  } else {\n    throw new Error(\n      \"Cannot patch topic without component adapter (ctx.runMutation unavailable)\",\n    );\n  }\n\n  return materializeTopicProjectOverlay({\n    ...topic,\n    ...patch,\n    metadata: nextMetadata,\n  } as TopicDocLike);\n}\n\nexport function matchesTopicProjectOverlayAccess(\n  accessibleProjectIds: Set<string>,\n  project: {\n    topicId: string;\n    legacyProjectId?: string;\n    storageProjectId?: string;\n  },\n): boolean {\n  return (\n    accessibleProjectIds.has(project.storageProjectId || project.topicId) ||\n    accessibleProjectIds.has(project.topicId) ||\n    (typeof project.legacyProjectId === \"string\" &&\n      accessibleProjectIds.has(project.legacyProjectId))\n  );\n}\n"]}
+{"version":3,"sources":["../src/convex.ts","../src/debug.ts","../src/topicProjectOverlay.ts"],"names":[],"mappings":"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","file":"topicProjectOverlay.js","sourcesContent":["import type { Doc as AccessControlDoc } from \"@lucern/access-control/convex\";\nimport {\n  type UnsafeConvexAnyApi,\n  unsafeConvexAnyApi,\n} from \"@lucern/contracts/convex/unsafeAnyApi\";\nimport {\n  actionGeneric,\n  componentsGeneric,\n  httpActionGeneric,\n  internalActionGeneric,\n  internalMutationGeneric,\n  internalQueryGeneric,\n  mutationGeneric,\n  queryGeneric,\n} from \"convex/server\";\nimport type { GenericId } from \"convex/values\";\n\n// TODO(FR.11-structural): `api`/`internal`/`components` are `anyApi as any`\n// because this module source tree is bundled into the kernel host at deploy time\n// and has NO top-level Convex `_generated/` directory to import a typed surface\n// from. Every `api.*` / `internal.*` / string-literal cross-component ref in this\n// module (topicScope.ts, topicProjectOverlay.ts, questionEvidenceLinks.ts,\n// beliefEvidenceLinks*.ts, epistemicQuestions.helpers.ts) inherits `any` from\n// here. The fix is structural — generate a per-module typed surface or a shared\n// typed function-reference manifest (template: the typed `components.controlPlane`\n// in modules/control-plane/src/component/convex.ts and the\n// `KERNEL_API_REF_MANIFEST` pattern in packages/server-core/src/kernelApi.ts) —\n// owned by the FR.11 closing/synthesis pass, not a mechanical swap.\nconst unsafeApi = unsafeConvexAnyApi(\n  \"graph-primitives top-level module bundle lacks a committed Convex _generated/api surface\"\n);\nexport const api = unsafeApi;\nexport const components =\n  componentsGeneric() as unknown as UntypedFunctionReferenceSurface;\nexport const internal = unsafeApi;\n\ntype UntypedFunctionReferenceSurface = UnsafeConvexAnyApi;\ntype BoundaryValue = UntypedFunctionReferenceSurface[string];\n\nexport type TableNames = string;\nexport type Id<TableName extends TableNames = string> = GenericId<TableName>;\nexport type Doc<TableName extends TableNames = string> =\n  AccessControlDoc<TableName>;\nexport type DataModel = Record<TableNames, unknown>;\ninterface IndexRangeBuilder {\n  eq(fieldName: string, value: unknown): IndexRangeBuilder;\n  field(fieldName: string): string;\n  gt(fieldName: string, value: unknown): IndexRangeBuilder;\n  gte(fieldName: string, value: unknown): IndexRangeBuilder;\n  lt(fieldName: string, value: unknown): IndexRangeBuilder;\n  lte(fieldName: string, value: unknown): IndexRangeBuilder;\n}\ninterface FilterBuilder {\n  and(...clauses: unknown[]): FilterBuilder;\n  eq(left: unknown, right: unknown): FilterBuilder;\n  field(fieldName: string): string;\n  gt(left: unknown, right: unknown): FilterBuilder;\n  gte(left: unknown, right: unknown): FilterBuilder;\n  lt(left: unknown, right: unknown): FilterBuilder;\n  lte(left: unknown, right: unknown): FilterBuilder;\n  neq(left: unknown, right: unknown): FilterBuilder;\n  or(...clauses: unknown[]): FilterBuilder;\n  [operator: string]: unknown;\n}\ninterface QueryInitializer<TableName extends TableNames> {\n  collect(): Promise<Doc<TableName>[]>;\n  filter(predicate: (q: FilterBuilder) => unknown): QueryInitializer<TableName>;\n  first(): Promise<Doc<TableName> | null>;\n  order(direction: \"asc\" | \"desc\"): QueryInitializer<TableName>;\n  take(limit: number): Promise<Doc<TableName>[]>;\n  unique(): Promise<Doc<TableName> | null>;\n  withIndex(\n    indexName: string,\n    range?: (q: IndexRangeBuilder) => unknown\n  ): QueryInitializer<TableName>;\n  withSearchIndex(\n    indexName: string,\n    search?: (q: IndexRangeBuilder) => unknown\n  ): QueryInitializer<TableName>;\n}\nexport interface DatabaseReader {\n  get<TableName extends TableNames>(\n    id: unknown\n  ): Promise<Doc<TableName> | null>;\n  normalizeId?<TableName extends TableNames>(\n    tableName: TableName,\n    id: string\n  ): Id<TableName> | null;\n  query<TableName extends TableNames>(\n    tableName: TableName\n  ): QueryInitializer<TableName>;\n}\nexport type DatabaseWriter = DatabaseReader & {\n  insert<TableName extends TableNames>(\n    tableName: TableName,\n    value: Record<string, unknown>\n  ): Promise<Id<TableName>>;\n  patch<TableName extends TableNames>(\n    id: Id<TableName>,\n    value: Record<string, unknown>\n  ): Promise<void>;\n  replace<TableName extends TableNames>(\n    id: Id<TableName>,\n    value: Record<string, unknown>\n  ): Promise<void>;\n  delete<TableName extends TableNames>(id: Id<TableName>): Promise<void>;\n};\ninterface Scheduler {\n  runAfter(\n    delayMs: number,\n    functionReference: unknown,\n    args?: unknown\n  ): Promise<void>;\n}\ninterface AuthReader {\n  getUserIdentity(): Promise<{\n    readonly subject: string;\n    readonly [claimName: string]: unknown;\n  } | null>;\n}\ninterface RuntimeInvoker {\n  runAction<Result = unknown>(\n    functionReference: unknown,\n    args?: unknown\n  ): Promise<Result>;\n  runMutation<Result = unknown>(\n    functionReference: unknown,\n    args?: unknown\n  ): Promise<Result>;\n  runQuery<Result = unknown>(\n    functionReference: unknown,\n    args?: unknown\n  ): Promise<Result>;\n}\nexport type QueryCtx = RuntimeInvoker & {\n  auth: AuthReader;\n  db: DatabaseReader;\n  scheduler: Scheduler;\n};\nexport type MutationCtx = RuntimeInvoker & {\n  auth: AuthReader;\n  db: DatabaseWriter;\n  scheduler: Scheduler;\n};\nexport type ActionCtx = RuntimeInvoker & {\n  auth: AuthReader;\n  scheduler: Scheduler;\n};\n\ntype ConvexFunctionBuilder<Ctx> = <\n  Args = BoundaryValue,\n  Result = BoundaryValue,\n>(definition: {\n  args?: unknown;\n  handler: (ctx: Ctx, args: Args) => Result;\n  returns?: unknown;\n}) => unknown;\n\ntype OptionalHandlerConvexFunctionBuilder<Ctx> = <\n  Args = BoundaryValue,\n  Result = BoundaryValue,\n>(definition: {\n  args?: unknown;\n  handler?: (ctx: Ctx, args: Args) => Result;\n  returns?: unknown;\n}) => unknown;\n\nexport const action =\n  actionGeneric as unknown as ConvexFunctionBuilder<ActionCtx>;\nexport const httpAction =\n  httpActionGeneric as unknown as ConvexFunctionBuilder<ActionCtx>;\nexport const internalAction =\n  internalActionGeneric as unknown as ConvexFunctionBuilder<ActionCtx>;\nexport const internalMutation =\n  internalMutationGeneric as unknown as OptionalHandlerConvexFunctionBuilder<MutationCtx>;\nexport const internalQuery =\n  internalQueryGeneric as unknown as OptionalHandlerConvexFunctionBuilder<QueryCtx>;\nexport const mutation =\n  mutationGeneric as unknown as ConvexFunctionBuilder<MutationCtx>;\nexport const query = queryGeneric as unknown as ConvexFunctionBuilder<QueryCtx>;\n","interface GraphPrimitiveDebugEnvironment {\n  process?: {\n    env?: Record<string, string | undefined>;\n  };\n}\n\nfunction isGraphPrimitiveDebugEnabled(): boolean {\n  const env = (globalThis as GraphPrimitiveDebugEnvironment).process?.env;\n  return (\n    env?.LUCERN_COMPAT_FALLBACK_DEBUG === \"1\" || env?.LUCERN_GRAPH_DEBUG === \"1\"\n  );\n}\n\nexport function formatGraphPrimitiveError(error: unknown): string {\n  if (error instanceof Error) {\n    return `${error.name}: ${error.message}`;\n  }\n  if (typeof error === \"string\") {\n    return error;\n  }\n  if (error === null) {\n    return \"null\";\n  }\n  if (error === undefined) {\n    return \"undefined\";\n  }\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return Object.prototype.toString.call(error);\n  }\n}\n\nexport function debugGraphPrimitiveFallback(\n  message: string,\n  context?: Record<string, unknown>\n): void {\n  if (!isGraphPrimitiveDebugEnabled()) {\n    return;\n  }\n  console.debug(message, context ?? {});\n}\n","// biome-ignore-all lint/style/useFilenamingConvention: Public graph-primitives wildcard-export path; rename requires an export-map migration.\nimport type {\n  DatabaseReader,\n  DatabaseWriter,\n  Id,\n  MutationCtx,\n  QueryCtx,\n} from \"./convex\";\nimport { api } from \"./convex\";\nimport { debugGraphPrimitiveFallback } from \"./debug\";\n\ntype OverlayIdMode = \"legacy\" | \"topic\";\nconst LEGACY_SCOPE_FIELD = \"graphScopeProjectId\";\n\ninterface LegacyProjectThesis {\n  confidence: number;\n  lastUpdated: number;\n  statement: string;\n}\n\ntype LegacyPillarImportance = \"critical\" | \"major\" | \"minor\" | \"not_applicable\";\n\ninterface LegacyThesisPillarConfig {\n  aiSuggestion?: {\n    suggestedAt: number;\n    reasoning: string;\n  };\n  configuredAt?: number;\n  configuredBy?: string;\n  pillarImportance?: Record<string, LegacyPillarImportance | undefined>;\n}\n\ninterface LegacyBeliefArchitecture {\n  lastCalculated: number;\n  overallMaturity: number;\n  pillarScores: Record<string, unknown>[];\n}\n\ninterface LegacyOntologyClassification {\n  classifiedAt: number;\n  functions: Record<string, unknown>[];\n  overallConfidence: number;\n  valueChains: Record<string, unknown>[];\n}\n\ntype TopicDocLike = Record<string, unknown> & {\n  _id: string;\n  _creationTime?: number;\n  globalId?: string;\n  name?: string;\n  description?: string;\n  type?: string;\n  tenantId?: string;\n  workspaceId?: string;\n  status?: string;\n  visibility?: string;\n  createdBy?: string;\n  /** FR.7 creator-grant: the exact acting principal recorded as owner-principal. */\n  ownerPrincipalId?: string;\n  createdAt?: number;\n  updatedAt?: number;\n  metadata?: Record<string, unknown>;\n};\n\nexport type TopicProjectOverlay = Record<string, unknown> & {\n  _id: string;\n  projectId: string;\n  topicId: string;\n  storageProjectId: string;\n  legacyProjectId?: string;\n  name: string;\n  type: string;\n  description?: string;\n  ownerId: string;\n  /** FR.7 creator-grant: principal-shaped owner; distinct from clerkId-shaped ownerId. */\n  ownerPrincipalId?: string;\n  sharedWith: string[];\n  visibility: \"private\" | \"team\" | \"firm\" | \"external\" | \"public\";\n  tenantId?: string;\n  workspaceId?: string;\n  status: \"active\" | \"archived\" | \"watching\";\n  tags: string[];\n  chatCount: number;\n  artifactCount: number;\n  lastActivityAt: number;\n  thesis?: LegacyProjectThesis;\n  wedgeHypothesis?: string;\n  founderArchetype?: string;\n  investmentCriteria?: string[];\n  sprintPhase?:\n    | \"pre_sprint\"\n    | \"readiness_check\"\n    | \"thesis_crystallization\"\n    | \"sprint_planning\"\n    | \"active_sprint\"\n    | \"theme_assembly\"\n    | \"evolution\";\n  currentSprintIndex?: number;\n  thesisPillarConfig?: LegacyThesisPillarConfig;\n  beliefArchitecture?: LegacyBeliefArchitecture;\n  ontologyClassification?: LegacyOntologyClassification;\n  _creationTime: number;\n  createdAt: number;\n  updatedAt: number;\n};\n\ninterface OverlayContext {\n  db?: Pick<DatabaseReader, \"get\" | \"query\"> &\n    Partial<Pick<DatabaseWriter, \"patch\">>;\n  runMutation?: MutationCtx[\"runMutation\"];\n  runQuery?: QueryCtx[\"runQuery\"];\n}\n\ninterface TopicPatchPlan {\n  nextMetadata: Record<string, unknown>;\n  patch: Record<string, unknown>;\n  topicUpdateArgs: Record<string, unknown> & { id: string };\n}\n\nfunction readNonEmptyString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return;\n  }\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : undefined;\n}\n\nfunction readStringArray(value: unknown): string[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  return value\n    .map((entry) => readNonEmptyString(entry))\n    .filter((entry): entry is string => Boolean(entry));\n}\n\nfunction readMetadata(topic: TopicDocLike): Record<string, unknown> {\n  return topic.metadata && typeof topic.metadata === \"object\"\n    ? topic.metadata\n    : {};\n}\n\nfunction omitMetadataKey(\n  metadata: Record<string, unknown>,\n  key: string\n): Record<string, unknown> {\n  const { [key]: _omitted, ...rest } = metadata;\n  return rest;\n}\n\nfunction readLegacyProjectId(\n  value: Record<string, unknown> | null | undefined\n): string | undefined {\n  if (!value) {\n    return;\n  }\n  return readNonEmptyString(value[LEGACY_SCOPE_FIELD]);\n}\n\nfunction coerceVisibility(\n  value: unknown\n): TopicProjectOverlay[\"visibility\"] | undefined {\n  return value === \"private\" ||\n    value === \"team\" ||\n    value === \"firm\" ||\n    value === \"external\" ||\n    value === \"public\"\n    ? value\n    : undefined;\n}\n\nfunction coerceStatus(\n  value: unknown\n): TopicProjectOverlay[\"status\"] | undefined {\n  return value === \"active\" || value === \"archived\" || value === \"watching\"\n    ? value\n    : undefined;\n}\n\nfunction mapProjectType(\n  topic: TopicDocLike,\n  metadata: Record<string, unknown>\n): string {\n  const explicit = readNonEmptyString(metadata.projectType);\n  if (explicit) {\n    return explicit;\n  }\n  if (topic.type === \"theme\") {\n    return \"thematic\";\n  }\n  return readNonEmptyString(topic.type) || \"general\";\n}\n\nfunction isProjectLikeTopic(topic: TopicDocLike): boolean {\n  const metadata = readMetadata(topic);\n  return (\n    topic.type === \"theme\" ||\n    topic.type === \"thematic\" ||\n    topic.type === \"deal\" ||\n    topic.type === \"monitoring\" ||\n    readLegacyProjectId(topic) !== undefined ||\n    readNonEmptyString(metadata.projectType) !== undefined\n  );\n}\n\nfunction isMissingLucernChildComponentError(error: unknown): boolean {\n  const message = getErrorMessage(error);\n  return (\n    message.includes(\n      'Child component ComponentName(Identifier(\"lucern\")) not found'\n    ) ||\n    (message.includes(\"Child component\") &&\n      message.includes(\"lucern\") &&\n      message.includes(\"not found\"))\n  );\n}\n\nfunction getErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n  if (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"message\" in error &&\n    typeof (error as { message?: unknown }).message === \"string\"\n  ) {\n    return (error as { message: string }).message;\n  }\n  return \"unknown error\";\n}\n\nasync function resolveTopicDoc(\n  ctx: OverlayContext,\n  scopeId: string\n): Promise<TopicDocLike | null> {\n  if (ctx?.db && typeof ctx.db.get === \"function\") {\n    try {\n      const directTopic = (await ctx.db.get(\n        scopeId as Id<\"topics\">\n      )) as TopicDocLike | null;\n      if (directTopic) {\n        return directTopic;\n      }\n    } catch (error) {\n      debugGraphPrimitiveFallback(\n        \"[topicProjectOverlay] Failed to resolve topic by direct ID\",\n        {\n          error,\n          scopeId,\n        }\n      );\n      // Not a direct topics-table id.\n    }\n  }\n\n  if (typeof ctx.runQuery !== \"function\") {\n    return null;\n  }\n\n  try {\n    const topic = await ctx.runQuery<TopicDocLike | null>(api.topics.get, {\n      id: String(scopeId),\n    });\n    if (topic?.name !== undefined && topic?.type !== undefined) {\n      return topic as TopicDocLike;\n    }\n  } catch (error) {\n    debugGraphPrimitiveFallback(\n      \"[topicProjectOverlay] Failed to resolve topic by ID query\",\n      {\n        error,\n        scopeId,\n      }\n    );\n    // Fall through to legacy-scope lookup.\n  }\n\n  try {\n    const topic = await ctx.runQuery<TopicDocLike | null>(\n      api.topics.getByLegacyScopeId,\n      {\n        projectId: String(scopeId),\n      }\n    );\n    if (topic?.name !== undefined && topic?.type !== undefined) {\n      return topic as TopicDocLike;\n    }\n  } catch (error) {\n    debugGraphPrimitiveFallback(\n      \"[topicProjectOverlay] Failed to resolve topic by legacy scope ID\",\n      { error, scopeId }\n    );\n    // Best-effort compat lookup only.\n  }\n\n  return null;\n}\n\nexport function materializeTopicProjectOverlay(\n  topic: TopicDocLike,\n  idMode: OverlayIdMode = \"legacy\"\n): TopicProjectOverlay {\n  const metadata = readMetadata(topic);\n  const topicId = String(topic._id);\n  const legacyProjectId =\n    readLegacyProjectId(topic) ||\n    readLegacyProjectId(metadata) ||\n    readNonEmptyString(metadata.legacyProjectId);\n  const storageProjectId = legacyProjectId || topicId;\n  const outwardId = idMode === \"topic\" ? topicId : storageProjectId;\n  const visibility =\n    coerceVisibility(topic.visibility) ||\n    coerceVisibility(metadata.visibility) ||\n    \"private\";\n  const status =\n    coerceStatus(topic.status) || coerceStatus(metadata.status) || \"active\";\n  let createdAt = 0;\n  if (typeof topic.createdAt === \"number\") {\n    createdAt = topic.createdAt;\n  } else if (typeof topic._creationTime === \"number\") {\n    createdAt = topic._creationTime;\n  }\n  let updatedAt = createdAt;\n  if (typeof topic.updatedAt === \"number\") {\n    updatedAt = topic.updatedAt;\n  } else if (typeof metadata.updatedAt === \"number\") {\n    updatedAt = metadata.updatedAt;\n  }\n\n  return {\n    ...metadata,\n    _id: outwardId,\n    projectId: outwardId,\n    topicId,\n    storageProjectId,\n    legacyProjectId,\n    name: readNonEmptyString(topic.name) || \"Untitled Theme\",\n    type: mapProjectType(topic, metadata),\n    description: readNonEmptyString(topic.description),\n    ownerId:\n      readNonEmptyString(metadata.ownerId) ||\n      readNonEmptyString(topic.createdBy) ||\n      \"system\",\n    // FR.7 creator-grant: surface the principal-shaped owner field (column-first,\n    // metadata fallback for legacy rows that recorded it in metadata).\n    ownerPrincipalId:\n      readNonEmptyString(topic.ownerPrincipalId) ||\n      readNonEmptyString(metadata.ownerPrincipalId),\n    // RR.1 carrier: preserve the nested metadata carrier so the kernel's\n    // `checkProjectAccessDetailed` metadata-PRIMARY read\n    // (`project.metadata?.ownerPrincipalId`) resolves the grant. The `...metadata`\n    // spread above only flattens keys; it does not leave a nested `metadata`.\n    metadata,\n    sharedWith: readStringArray(metadata.sharedWith),\n    visibility,\n    tenantId:\n      readNonEmptyString(topic.tenantId) ||\n      readNonEmptyString(metadata.tenantId),\n    workspaceId:\n      readNonEmptyString(topic.workspaceId) ||\n      readNonEmptyString(metadata.workspaceId),\n    status,\n    tags: readStringArray(metadata.tags),\n    chatCount:\n      typeof metadata.chatCount === \"number\"\n        ? (metadata.chatCount as number)\n        : 0,\n    artifactCount:\n      typeof metadata.artifactCount === \"number\"\n        ? (metadata.artifactCount as number)\n        : 0,\n    lastActivityAt:\n      typeof metadata.lastActivityAt === \"number\"\n        ? (metadata.lastActivityAt as number)\n        : updatedAt,\n    _creationTime:\n      typeof topic._creationTime === \"number\" ? topic._creationTime : createdAt,\n    createdAt,\n    updatedAt,\n  };\n}\n\nexport async function resolveTopicProjectOverlay(\n  ctx: OverlayContext,\n  scopeId: string,\n  options: {\n    idMode?: OverlayIdMode;\n    projectLikeOnly?: boolean;\n  } = {}\n): Promise<TopicProjectOverlay | null> {\n  const topic = await resolveTopicDoc(ctx, scopeId);\n  if (!topic) {\n    return null;\n  }\n  if (options.projectLikeOnly !== false && !isProjectLikeTopic(topic)) {\n    return null;\n  }\n  return materializeTopicProjectOverlay(topic, options.idMode);\n}\n\nexport async function listTopicProjectOverlays(\n  ctx: OverlayContext,\n  options: {\n    idMode?: OverlayIdMode;\n    projectLikeOnly?: boolean;\n  } = {}\n): Promise<TopicProjectOverlay[]> {\n  let allTopics: TopicDocLike[] = [];\n\n  if (ctx?.db?.query && typeof ctx.db.query === \"function\") {\n    try {\n      allTopics = (await ctx.db.query(\"topics\").collect()) as TopicDocLike[];\n    } catch (error) {\n      debugGraphPrimitiveFallback(\n        \"[topicProjectOverlay] Failed to read topics table; falling back to API\",\n        { error }\n      );\n      allTopics = [];\n    }\n  }\n\n  if (allTopics.length === 0 && typeof ctx.runQuery === \"function\") {\n    allTopics =\n      (((await ctx.runQuery(api.topics.list, {})) ?? []) as TopicDocLike[]) ||\n      [];\n  }\n\n  return allTopics\n    .filter(\n      (topic) => options.projectLikeOnly === false || isProjectLikeTopic(topic)\n    )\n    .map((topic) => materializeTopicProjectOverlay(topic, options.idMode));\n}\n\nexport async function patchTopicProjectOverlay(\n  ctx: OverlayContext,\n  scopeId: string,\n  value: Record<string, unknown>\n): Promise<TopicProjectOverlay | null> {\n  const topic = await resolveTopicDoc(ctx, scopeId);\n  if (!topic) {\n    return null;\n  }\n\n  const plan = buildTopicProjectOverlayPatchPlan(topic, value);\n  await applyTopicProjectOverlayPatch(ctx, topic, plan);\n\n  return materializeTopicProjectOverlay({\n    ...topic,\n    ...plan.patch,\n    metadata: plan.nextMetadata,\n  } as TopicDocLike);\n}\n\nfunction buildTopicProjectOverlayPatchPlan(\n  topic: TopicDocLike,\n  value: Record<string, unknown>\n): TopicPatchPlan {\n  const plan: TopicPatchPlan = {\n    nextMetadata: { ...readMetadata(topic) },\n    patch: {},\n    topicUpdateArgs: {\n      id: String(topic._id),\n    },\n  };\n  for (const [key, rawValue] of Object.entries(value)) {\n    applyTopicProjectOverlayPatchEntry(plan, key, rawValue);\n  }\n\n  plan.patch.updatedAt = Date.now();\n  plan.patch.metadata = plan.nextMetadata;\n  plan.topicUpdateArgs.metadata = plan.nextMetadata;\n\n  return plan;\n}\n\nfunction applyTopicProjectOverlayPatchEntry(\n  plan: TopicPatchPlan,\n  key: string,\n  rawValue: unknown\n) {\n  switch (key) {\n    case \"_id\":\n    case \"projectId\":\n    case \"topicId\":\n    case \"legacyProjectId\":\n    case \"storageProjectId\":\n    case \"updatedAt\":\n    case \"createdAt\":\n      return;\n    case \"name\":\n    case \"description\":\n      plan.patch[key] = rawValue;\n      plan.topicUpdateArgs[key] = rawValue;\n      return;\n    case \"tenantId\":\n    case \"workspaceId\":\n    case \"ownerId\":\n      throw new Error(\n        `patchTopicProjectOverlay cannot mutate ${key} via component-owned topics`\n      );\n    case \"status\":\n      applyTopicStatusPatch(plan, rawValue);\n      return;\n    case \"visibility\":\n      applyTopicVisibilityPatch(plan, rawValue);\n      return;\n    case \"type\":\n      applyTopicProjectTypePatch(plan, rawValue);\n      return;\n    default:\n      applyTopicMetadataPatch(plan, key, rawValue);\n  }\n}\n\nfunction applyTopicStatusPatch(plan: TopicPatchPlan, rawValue: unknown) {\n  const status = coerceStatus(rawValue);\n  if (status) {\n    plan.patch.status = status;\n    plan.topicUpdateArgs.status = status;\n  }\n}\n\nfunction applyTopicVisibilityPatch(plan: TopicPatchPlan, rawValue: unknown) {\n  const visibility = coerceVisibility(rawValue);\n  if (visibility) {\n    plan.patch.visibility = visibility;\n    plan.topicUpdateArgs.visibility = visibility;\n  }\n}\n\nfunction applyTopicProjectTypePatch(plan: TopicPatchPlan, rawValue: unknown) {\n  const projectType = readNonEmptyString(rawValue);\n  if (projectType) {\n    plan.nextMetadata.projectType = projectType;\n    return;\n  }\n  plan.nextMetadata = omitMetadataKey(plan.nextMetadata, \"projectType\");\n}\n\nfunction applyTopicMetadataPatch(\n  plan: TopicPatchPlan,\n  key: string,\n  rawValue: unknown\n) {\n  if (rawValue === undefined) {\n    plan.nextMetadata = omitMetadataKey(plan.nextMetadata, key);\n    return;\n  }\n  plan.nextMetadata[key] = rawValue;\n}\n\nasync function applyTopicProjectOverlayPatch(\n  ctx: OverlayContext,\n  topic: TopicDocLike,\n  plan: TopicPatchPlan\n): Promise<void> {\n  if (typeof ctx.runMutation === \"function\") {\n    try {\n      await ctx.runMutation(api.topics.update, plan.topicUpdateArgs);\n    } catch (error) {\n      if (!canPatchTopicViaLocalDb(ctx, error)) {\n        throw error;\n      }\n      await ctx.db.patch(topic._id as Id<\"topics\">, plan.patch);\n    }\n  } else if (ctx?.db && typeof ctx.db.patch === \"function\") {\n    await ctx.db.patch(topic._id as Id<\"topics\">, plan.patch);\n  } else {\n    throw new Error(\n      \"Cannot patch topic without component adapter (ctx.runMutation unavailable)\"\n    );\n  }\n}\n\nfunction canPatchTopicViaLocalDb(\n  ctx: OverlayContext,\n  error: unknown\n): ctx is {\n  db: Pick<DatabaseReader, \"get\" | \"query\"> & Pick<DatabaseWriter, \"patch\">;\n} {\n  return (\n    isMissingLucernChildComponentError(error) &&\n    Boolean(ctx?.db) &&\n    typeof ctx.db?.patch === \"function\"\n  );\n}\n\nexport function matchesTopicProjectOverlayAccess(\n  accessibleProjectIds: Set<string>,\n  project: {\n    topicId: string;\n    legacyProjectId?: string;\n    storageProjectId?: string;\n  }\n): boolean {\n  return (\n    accessibleProjectIds.has(project.storageProjectId || project.topicId) ||\n    accessibleProjectIds.has(project.topicId) ||\n    (typeof project.legacyProjectId === \"string\" &&\n      accessibleProjectIds.has(project.legacyProjectId))\n  );\n}\n"]}