@lucern/contracts 1.0.42 → 1.0.44

package/dist/schemas/tables/kernel/intelligence.js

@@ -25,11 +25,12 @@ var crossProjectConnections = defineTable({
   category: "intelligence",
   shape: z.object({
     sourceProjectId: z.string().optional(),
-    sourceTopicId: idOf("topics").optional(),
-    sourceNodeId: idOf("epistemicNodes"),
+    // globalId references (UUIDv7), resolved via by_globalId — not Convex Ids.
+    sourceTopicId: z.string().optional(),
+    sourceNodeId: z.string(),
     targetProjectId: z.string().optional(),
-    targetTopicId: idOf("topics").optional(),
-    targetNodeId: idOf("epistemicNodes"),
+    targetTopicId: z.string().optional(),
+    targetNodeId: z.string(),
     semanticSimilarity: z.number(),
     matchSignals: z.object({
       beliefTextSimilarity: z.number(),
@@ -44,7 +45,7 @@ var crossProjectConnections = defineTable({
     suggestedWeight: z.number().optional(),
     rationale: z.string(),
     decision: z.enum(["pending", "accepted", "declined"]),
-    acceptedEdgeId: idOf("epistemicEdges").optional(),
+    acceptedEdgeId: z.string().optional(),
     declineReason: z.string().optional(),
     declineCategory: z.enum([
       "not_relevant",

package/dist/schemas/tables/kernel/spine.d.ts

@@ -213,7 +213,7 @@ export declare const epistemicNodes: import("../../../dsl.js").TableContract<{
     sourceType: z.ZodEnum<["human", "ai_extracted", "ai_generated", "imported", "system", "verified", "proprietary"]>;
     externalSourceType: z.ZodOptional<z.ZodString>;
     aiProvider: z.ZodOptional<z.ZodString>;
-    extractedFromNodeId: z.ZodOptional<import("../../../dsl.js").ConvexIdSchema<"epistemicNodes">>;
+    extractedFromNodeId: z.ZodOptional<z.ZodString>;
     extractionModel: z.ZodOptional<z.ZodString>;
     extractionPromptName: z.ZodOptional<z.ZodString>;
     extractionPromptVersion: z.ZodOptional<z.ZodNumber>;
@@ -228,7 +228,7 @@ export declare const epistemicNodes: import("../../../dsl.js").TableContract<{
     confidence: z.ZodOptional<z.ZodNumber>;
     verificationStatus: z.ZodOptional<z.ZodEnum<["unverified", "human_verified", "ai_verified", "contradicted", "outdated"]>>;
     status: z.ZodEnum<["active", "superseded", "archived", "deleted"]>;
-    supersededBy: z.ZodOptional<import("../../../dsl.js").ConvexIdSchema<"epistemicNodes">>;
+    supersededBy: z.ZodOptional<z.ZodString>;
     topicId: z.ZodOptional<z.ZodString>;
     projectId: z.ZodOptional<z.ZodString>;
     createdBy: z.ZodString;

package/dist/schemas/tables/kernel/spine.js

@@ -1,17 +1,6 @@
 import { z } from 'zod';
 
 // src/schemas/tables/kernel/spine.ts
-var CONVEX_ID_TABLE = /* @__PURE__ */ Symbol.for("lucern.contracts.convexIdTable");
-function idOf(table) {
-  const schema = z.string().brand();
-  Object.defineProperty(schema, CONVEX_ID_TABLE, {
-    configurable: false,
-    enumerable: false,
-    value: table,
-    writable: false
-  });
-  return schema;
-}
 
 // src/dsl/defineTable.ts
 function defineTable(spec) {
@@ -6627,7 +6616,7 @@ var epistemicNodes = defineTable({
     ]),
     externalSourceType: z.string().optional(),
     aiProvider: z.string().optional(),
-    extractedFromNodeId: idOf("epistemicNodes").optional(),
+    extractedFromNodeId: z.string().optional(),
     extractionModel: z.string().optional(),
     extractionPromptName: z.string().optional(),
     extractionPromptVersion: z.number().optional(),
@@ -6648,7 +6637,7 @@ var epistemicNodes = defineTable({
       "outdated"
     ]).optional(),
     status: z.enum(["active", "superseded", "archived", "deleted"]),
-    supersededBy: idOf("epistemicNodes").optional(),
+    supersededBy: z.string().optional(),
     topicId: z.string().optional(),
     projectId: z.string().optional(),
     createdBy: z.string(),

package/dist/schemas/tables/kernel/workflow.d.ts

@@ -19,7 +19,7 @@ export declare const workflowDefinitions: import("../../../dsl.js").TableContrac
 }>;
 export declare const workflowPullRequests: import("../../../dsl.js").TableContract<{
     topicId: z.ZodOptional<z.ZodString>;
-    worktreeId: import("../../../dsl.js").ConvexIdSchema<"worktrees">;
+    worktreeId: z.ZodString;
     status: z.ZodEnum<["pending_review", "changes_requested", "approved", "blocked"]>;
     summary: z.ZodString;
     reviewers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;

package/dist/schemas/tables/kernel/workflow.js

@@ -51,7 +51,7 @@ var workflowPullRequests = defineTable({
   category: "workflow",
   shape: z.object({
     topicId: z.string().optional(),
-    worktreeId: idOf("worktrees"),
+    worktreeId: z.string(),
     status: z.enum([
       "pending_review",
       "changes_requested",

package/dist/schemas.values.js

@@ -1912,7 +1912,7 @@ var beliefVotes = defineTable({
       "recorder"
     ]).optional(),
     stakeholderGroupId: idOf("stakeholderGroups").optional(),
-    beliefId: idOf("epistemicNodes"),
+    beliefId: z.string(),
     domainCategory: z.string().optional(),
     voteDirection: z.enum(["support", "oppose", "abstain", "uncertain"]),
     confidence: z.number(),
@@ -2190,7 +2190,7 @@ var decisionRiskLedger = defineTable({
     workspaceId: z.string().optional(),
     riskType: z.string(),
     riskDescription: z.string(),
-    relatedBeliefId: idOf("epistemicNodes").optional(),
+    relatedBeliefId: z.string().optional(),
     probabilityBand: z.enum(["very_low", "low", "medium", "high", "very_high"]),
     impactBand: z.enum(["very_low", "low", "medium", "high", "very_high"]),
     ownerPrincipalId: z.string().optional(),
@@ -2386,7 +2386,11 @@ var epistemicNodeEmbeddings = defineTable({
   component: "kernel",
   category: "embedding",
   shape: z.object({
-    nodeId: idOf("epistemicNodes"),
+    // Canonical UUIDv7 globalId of the embedded node (not a Convex Id). Every
+    // cross-row reference in the graph is the node's globalId, resolved via the
+    // `by_globalId` index — see resolveNodeGlobalId/resolveNodeDocSoft. This
+    // keeps embeddings stable across extract/rebuild and carbon-copies.
+    nodeId: z.string(),
     tenantId: z.string().optional(),
     workspaceId: z.string().optional(),
     topicId: z.string().optional(),
@@ -2441,7 +2445,13 @@ var epistemicNodeEmbeddings = defineTable({
       name: "by_embedding",
       vectorField: "embedding",
       dimensions: 1024,
-      filterFields: ["nodeType", "createdBy", "topicId"]
+      filterFields: [
+        "nodeType",
+        "createdBy",
+        "topicId",
+        "tenantId",
+        "workspaceId"
+      ]
     }
   ]
 });
@@ -3187,11 +3197,12 @@ var crossProjectConnections = defineTable({
   category: "intelligence",
   shape: z.object({
     sourceProjectId: z.string().optional(),
-    sourceTopicId: idOf("topics").optional(),
-    sourceNodeId: idOf("epistemicNodes"),
+    // globalId references (UUIDv7), resolved via by_globalId — not Convex Ids.
+    sourceTopicId: z.string().optional(),
+    sourceNodeId: z.string(),
     targetProjectId: z.string().optional(),
-    targetTopicId: idOf("topics").optional(),
-    targetNodeId: idOf("epistemicNodes"),
+    targetTopicId: z.string().optional(),
+    targetNodeId: z.string(),
     semanticSimilarity: z.number(),
     matchSignals: z.object({
       beliefTextSimilarity: z.number(),
@@ -3206,7 +3217,7 @@ var crossProjectConnections = defineTable({
     suggestedWeight: z.number().optional(),
     rationale: z.string(),
     decision: z.enum(["pending", "accepted", "declined"]),
-    acceptedEdgeId: idOf("epistemicEdges").optional(),
+    acceptedEdgeId: z.string().optional(),
     declineReason: z.string().optional(),
     declineCategory: z.enum([
       "not_relevant",
@@ -10686,7 +10697,7 @@ var epistemicNodes = defineTable({
     ]),
     externalSourceType: z.string().optional(),
     aiProvider: z.string().optional(),
-    extractedFromNodeId: idOf("epistemicNodes").optional(),
+    extractedFromNodeId: z.string().optional(),
     extractionModel: z.string().optional(),
     extractionPromptName: z.string().optional(),
     extractionPromptVersion: z.number().optional(),
@@ -10707,7 +10718,7 @@ var epistemicNodes = defineTable({
       "outdated"
     ]).optional(),
     status: z.enum(["active", "superseded", "archived", "deleted"]),
-    supersededBy: idOf("epistemicNodes").optional(),
+    supersededBy: z.string().optional(),
     topicId: z.string().optional(),
     projectId: z.string().optional(),
     createdBy: z.string(),
@@ -11129,7 +11140,7 @@ var workflowPullRequests = defineTable({
   category: "workflow",
   shape: z.object({
     topicId: z.string().optional(),
-    worktreeId: idOf("worktrees"),
+    worktreeId: z.string(),
     status: z.enum([
       "pending_review",
       "changes_requested",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucern/contracts",
-  "version": "1.0.42",
+  "version": "1.0.44",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",