@lucern/graph-primitives 1.0.18 → 1.0.19

package/dist/epistemicEdges.helpers.d.ts

@@ -15,7 +15,7 @@ declare const subjectiveOpinionValidator: convex_values.VObject<{
     u: convex_values.VFloat64<number, "required">;
     a: convex_values.VFloat64<number, "required">;
 }, "required", "b" | "d" | "u" | "a">;
-declare const edgeTypeValidator: convex_values.VUnion<"supports" | "informs" | "depends_on" | "derived_from" | "contains" | "tests" | "based_on_belief" | "based_on_question" | "blocked_by_contradiction" | "informed_by_theme" | "works_at" | "invested_in" | "competes_with" | "participates_in" | "founded_by" | "evaluates" | "performs" | "function_in" | "impacts" | "raised_from" | "mentioned_in" | "perspective_on" | "supersedes" | "responds_to" | "belongs_to" | "relates_to_thesis" | "plays_theme" | "contradicts" | "scoped_by" | "prerequisite_for" | "parallel_to" | "corroborates" | "extends" | "same_source_as" | "same_theme_as" | "qualifies" | "explores" | "same_as" | "assumes" | "would_predict" | "analogous_to" | "independent_of" | "counterfactual_of" | "cascade_to" | "mutually_exclusive" | "correlates_with" | "amplifies" | "precondition_for" | "in_tension_with" | "cascade_from" | "falsified_by" | "exclusive_with" | "collapses_if" | "strengthened_by" | "weakened_by" | "alternative_to" | "subsumes" | "validated_by" | "required_for" | "blocks", [convex_values.VLiteral<"based_on_belief", "required">, convex_values.VLiteral<"based_on_question", "required">, convex_values.VLiteral<"blocked_by_contradiction", "required">, convex_values.VLiteral<"informed_by_theme", "required">, convex_values.VLiteral<"derived_from", "required">, convex_values.VLiteral<"responds_to", "required">, convex_values.VLiteral<"informs", "required">, convex_values.VLiteral<"tests", "required">, convex_values.VLiteral<"explores", "required">, convex_values.VLiteral<"qualifies", "required">, convex_values.VLiteral<"relates_to_thesis", "required">, convex_values.VLiteral<"belongs_to", "required">, convex_values.VLiteral<"plays_theme", "required">, convex_values.VLiteral<"scoped_by", "required">, convex_values.VLiteral<"evaluates", "required">, convex_values.VLiteral<"perspective_on", "required">, convex_values.VLiteral<"works_at", "required">, convex_values.VLiteral<"mentioned_in", "required">, convex_values.VLiteral<"founded_by", "required">, convex_values.VLiteral<"participates_in", "required">, convex_values.VLiteral<"performs", "required">, convex_values.VLiteral<"function_in", "required">, convex_values.VLiteral<"impacts", "required">, convex_values.VLiteral<"invested_in", "required">, convex_values.VLiteral<"raised_from", "required">, convex_values.VLiteral<"supersedes", "required">, convex_values.VLiteral<"same_as", "required">, convex_values.VLiteral<"depends_on", "required">, convex_values.VLiteral<"supports", "required">, convex_values.VLiteral<"contains", "required">, convex_values.VLiteral<"counterfactual_of", "required">, convex_values.VLiteral<"cascade_to", "required">, convex_values.VLiteral<"cascade_from", "required">, convex_values.VLiteral<"mutually_exclusive", "required">, convex_values.VLiteral<"correlates_with", "required">, convex_values.VLiteral<"amplifies", "required">, convex_values.VLiteral<"precondition_for", "required">, convex_values.VLiteral<"in_tension_with", "required">, convex_values.VLiteral<"falsified_by", "required">, convex_values.VLiteral<"exclusive_with", "required">, convex_values.VLiteral<"contradicts", "required">, convex_values.VLiteral<"collapses_if", "required">, convex_values.VLiteral<"strengthened_by", "required">, convex_values.VLiteral<"weakened_by", "required">, convex_values.VLiteral<"alternative_to", "required">, convex_values.VLiteral<"subsumes", "required">, convex_values.VLiteral<"validated_by", "required">, convex_values.VLiteral<"required_for", "required">, convex_values.VLiteral<"blocks", "required">, convex_values.VLiteral<"prerequisite_for", "required">, convex_values.VLiteral<"parallel_to", "required">, convex_values.VLiteral<"corroborates", "required">, convex_values.VLiteral<"extends", "required">, convex_values.VLiteral<"same_source_as", "required">, convex_values.VLiteral<"same_theme_as", "required">, convex_values.VLiteral<"assumes", "required">, convex_values.VLiteral<"would_predict", "required">, convex_values.VLiteral<"analogous_to", "required">, convex_values.VLiteral<"independent_of", "required">, convex_values.VLiteral<"competes_with", "required">], "required", never>;
+declare const edgeTypeValidator: convex_values.VUnion<"supports" | "informs" | "depends_on" | "derived_from" | "contains" | "tests" | "based_on_belief" | "based_on_question" | "blocked_by_contradiction" | "informed_by_theme" | "works_at" | "invested_in" | "competes_with" | "participates_in" | "founded_by" | "evaluates" | "performs" | "function_in" | "impacts" | "raised_from" | "mentioned_in" | "perspective_on" | "supersedes" | "responds_to" | "belongs_to" | "relates_to_thesis" | "plays_theme" | "contradicts" | "prerequisite_for" | "parallel_to" | "corroborates" | "extends" | "same_source_as" | "same_theme_as" | "qualifies" | "explores" | "scoped_by" | "same_as" | "assumes" | "would_predict" | "analogous_to" | "independent_of" | "counterfactual_of" | "cascade_to" | "mutually_exclusive" | "correlates_with" | "amplifies" | "precondition_for" | "in_tension_with" | "cascade_from" | "falsified_by" | "exclusive_with" | "collapses_if" | "strengthened_by" | "weakened_by" | "alternative_to" | "subsumes" | "validated_by" | "required_for" | "blocks", [convex_values.VLiteral<"based_on_belief", "required">, convex_values.VLiteral<"based_on_question", "required">, convex_values.VLiteral<"blocked_by_contradiction", "required">, convex_values.VLiteral<"informed_by_theme", "required">, convex_values.VLiteral<"derived_from", "required">, convex_values.VLiteral<"responds_to", "required">, convex_values.VLiteral<"informs", "required">, convex_values.VLiteral<"tests", "required">, convex_values.VLiteral<"explores", "required">, convex_values.VLiteral<"qualifies", "required">, convex_values.VLiteral<"relates_to_thesis", "required">, convex_values.VLiteral<"belongs_to", "required">, convex_values.VLiteral<"plays_theme", "required">, convex_values.VLiteral<"scoped_by", "required">, convex_values.VLiteral<"evaluates", "required">, convex_values.VLiteral<"perspective_on", "required">, convex_values.VLiteral<"works_at", "required">, convex_values.VLiteral<"mentioned_in", "required">, convex_values.VLiteral<"founded_by", "required">, convex_values.VLiteral<"participates_in", "required">, convex_values.VLiteral<"performs", "required">, convex_values.VLiteral<"function_in", "required">, convex_values.VLiteral<"impacts", "required">, convex_values.VLiteral<"invested_in", "required">, convex_values.VLiteral<"raised_from", "required">, convex_values.VLiteral<"supersedes", "required">, convex_values.VLiteral<"same_as", "required">, convex_values.VLiteral<"depends_on", "required">, convex_values.VLiteral<"supports", "required">, convex_values.VLiteral<"contains", "required">, convex_values.VLiteral<"counterfactual_of", "required">, convex_values.VLiteral<"cascade_to", "required">, convex_values.VLiteral<"cascade_from", "required">, convex_values.VLiteral<"mutually_exclusive", "required">, convex_values.VLiteral<"correlates_with", "required">, convex_values.VLiteral<"amplifies", "required">, convex_values.VLiteral<"precondition_for", "required">, convex_values.VLiteral<"in_tension_with", "required">, convex_values.VLiteral<"falsified_by", "required">, convex_values.VLiteral<"exclusive_with", "required">, convex_values.VLiteral<"contradicts", "required">, convex_values.VLiteral<"collapses_if", "required">, convex_values.VLiteral<"strengthened_by", "required">, convex_values.VLiteral<"weakened_by", "required">, convex_values.VLiteral<"alternative_to", "required">, convex_values.VLiteral<"subsumes", "required">, convex_values.VLiteral<"validated_by", "required">, convex_values.VLiteral<"required_for", "required">, convex_values.VLiteral<"blocks", "required">, convex_values.VLiteral<"prerequisite_for", "required">, convex_values.VLiteral<"parallel_to", "required">, convex_values.VLiteral<"corroborates", "required">, convex_values.VLiteral<"extends", "required">, convex_values.VLiteral<"same_source_as", "required">, convex_values.VLiteral<"same_theme_as", "required">, convex_values.VLiteral<"assumes", "required">, convex_values.VLiteral<"would_predict", "required">, convex_values.VLiteral<"analogous_to", "required">, convex_values.VLiteral<"independent_of", "required">, convex_values.VLiteral<"competes_with", "required">], "required", never>;
 declare function buildEdgeStatusSuccessResult(): EdgeStatusResult;
 declare function buildEdgeNotFoundResult(): EdgeStatusResult;
 declare function buildEdgeMirrorSkippedResult(): EdgeStatusResult;

package/dist/index.js

@@ -2562,7 +2562,7 @@ function scopeFromTopicAnchor(topicNode) {
 }
 async function createRequiredBeliefTopicEdge(ctx, args) {
   const topicGlobalId = args.topicNode.globalId;
-  const edgeGlobalId = `edge:${args.beliefGlobalId}:${topicGlobalId}:scoped_by`;
+  const edgeGlobalId = `edge:${args.beliefGlobalId}:${topicGlobalId}:belongs_to`;
   const now = Date.now();
   const existing = await ctx.db.query("epistemicEdges").withIndex("by_globalId", (q) => q.eq("globalId", edgeGlobalId)).first();
   if (!existing) {
@@ -2572,7 +2572,7 @@ async function createRequiredBeliefTopicEdge(ctx, args) {
       toNodeId: String(args.topicNode._id),
       sourceGlobalId: args.beliefGlobalId,
       targetGlobalId: topicGlobalId,
-      edgeType: "scoped_by",
+      edgeType: "belongs_to",
       weight: 1,
       confidence: 1,
       context: "Belief creation topic anchor invariant.",
@@ -2596,7 +2596,7 @@ async function createRequiredBeliefTopicEdge(ctx, args) {
     globalId: edgeGlobalId,
     fromGlobalId: args.beliefGlobalId,
     toGlobalId: topicGlobalId,
-    edgeType: "scoped_by",
+    edgeType: "belongs_to",
     weight: 1,
     confidence: 1,
     context: "Belief creation topic anchor invariant.",
@@ -4156,6 +4156,39 @@ var getWithEvidence = query({
     };
   }
 });
+async function collectRelationshipNodeRefs(ctx, nodeId) {
+  const refs = /* @__PURE__ */ new Set([String(nodeId)]);
+  const node = await ctx.db.get(nodeId);
+  const globalId = typeof node?.globalId === "string" ? node.globalId.trim() : "";
+  if (globalId.length > 0) {
+    refs.add(globalId);
+  }
+  return [...refs];
+}
+function endpointMatches(q, fields, refs) {
+  return q.or(
+    ...fields.flatMap(
+      (field) => refs.map((ref) => q.eq(q.field(field), ref))
+    )
+  );
+}
+async function resolveRelationshipEndpoint(ctx, endpointId, globalEndpointId) {
+  const candidates = [endpointId, globalEndpointId].map((value) => typeof value === "string" ? value.trim() : "").filter((value, index, values) => value.length > 0 && values.indexOf(value) === index);
+  for (const candidate of candidates) {
+    try {
+      const direct = await ctx.db.get(candidate);
+      if (direct) {
+        return direct;
+      }
+    } catch {
+    }
+    const byGlobalId = await ctx.db.query("epistemicNodes").withIndex("by_globalId", (q) => q.eq("globalId", candidate)).first();
+    if (byGlobalId) {
+      return byGlobalId;
+    }
+  }
+  return null;
+}
 var getRelationships = query({
   args: {
     nodeId: v.id("epistemicNodes"),
@@ -4170,17 +4203,38 @@ var getRelationships = query({
       incoming: [],
       outgoing: []
     };
+    const nodeRefs = await collectRelationshipNodeRefs(ctx, args.nodeId);
     if (direction === "in" || direction === "both") {
-      const inEdges = await ctx.db.query("epistemicEdges").filter((q) => q.eq(q.field("toNodeId"), args.nodeId)).collect();
+      const inEdges = await ctx.db.query("epistemicEdges").filter(
+        (q) => endpointMatches(
+          q,
+          ["toNodeId", "targetGlobalId", "toGlobalId", "toUuid"],
+          nodeRefs
+        )
+      ).collect();
       for (const edge of inEdges) {
-        const sourceNode = await ctx.db.get(edge.fromNodeId);
+        const sourceNode = await resolveRelationshipEndpoint(
+          ctx,
+          edge.fromNodeId,
+          edge.sourceGlobalId ?? edge.fromGlobalId ?? edge.fromUuid
+        );
         results.incoming.push({ edge, node: sourceNode });
       }
     }
     if (direction === "out" || direction === "both") {
-      const outEdges = await ctx.db.query("epistemicEdges").filter((q) => q.eq(q.field("fromNodeId"), args.nodeId)).collect();
+      const outEdges = await ctx.db.query("epistemicEdges").filter(
+        (q) => endpointMatches(
+          q,
+          ["fromNodeId", "sourceGlobalId", "fromGlobalId", "fromUuid"],
+          nodeRefs
+        )
+      ).collect();
       for (const edge of outEdges) {
-        const targetNode = edge.toNodeId ? await ctx.db.get(edge.toNodeId) : null;
+        const targetNode = await resolveRelationshipEndpoint(
+          ctx,
+          edge.toNodeId,
+          edge.targetGlobalId ?? edge.toGlobalId ?? edge.toUuid
+        );
         results.outgoing.push({ edge, node: targetNode });
       }
     }