@lucern/graph-primitives 0.1.0-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (224) hide show
  1. package/README.md +29 -0
  2. package/dist/beliefDecay-Q_26RTc-.d.ts +72 -0
  3. package/dist/beliefDecay.d.ts +2 -0
  4. package/dist/beliefDecay.js +1628 -0
  5. package/dist/beliefDecay.js.map +1 -0
  6. package/dist/beliefEvidenceLinks-42FlR48t.d.ts +77 -0
  7. package/dist/beliefEvidenceLinks.d.ts +1 -0
  8. package/dist/beliefEvidenceLinks.js +1978 -0
  9. package/dist/beliefEvidenceLinks.js.map +1 -0
  10. package/dist/beliefLifecycle-C-AehZgF.d.ts +43 -0
  11. package/dist/beliefLifecycle.d.ts +1 -0
  12. package/dist/beliefLifecycle.js +98 -0
  13. package/dist/beliefLifecycle.js.map +1 -0
  14. package/dist/confidencePropagationDispatch.d.ts +46 -0
  15. package/dist/confidencePropagationDispatch.js +744 -0
  16. package/dist/confidencePropagationDispatch.js.map +1 -0
  17. package/dist/contradictions-Hdwl7zid.d.ts +71 -0
  18. package/dist/contradictions.d.ts +1 -0
  19. package/dist/contradictions.js +1557 -0
  20. package/dist/contradictions.js.map +1 -0
  21. package/dist/convex.d.ts +23 -0
  22. package/dist/convex.js +17 -0
  23. package/dist/convex.js.map +1 -0
  24. package/dist/edgeValidation-CeI0wc0r.d.ts +35 -0
  25. package/dist/edgeValidation.d.ts +2 -0
  26. package/dist/edgeValidation.js +307 -0
  27. package/dist/edgeValidation.js.map +1 -0
  28. package/dist/edges/contains.d.ts +6 -0
  29. package/dist/edges/contains.js +14 -0
  30. package/dist/edges/contains.js.map +1 -0
  31. package/dist/edges/contradicts.d.ts +6 -0
  32. package/dist/edges/contradicts.js +183 -0
  33. package/dist/edges/contradicts.js.map +1 -0
  34. package/dist/edges/dependsOn.d.ts +6 -0
  35. package/dist/edges/dependsOn.js +240 -0
  36. package/dist/edges/dependsOn.js.map +1 -0
  37. package/dist/edges/derivedFrom.d.ts +6 -0
  38. package/dist/edges/derivedFrom.js +14 -0
  39. package/dist/edges/derivedFrom.js.map +1 -0
  40. package/dist/edges/elaborates.d.ts +6 -0
  41. package/dist/edges/elaborates.js +100 -0
  42. package/dist/edges/elaborates.js.map +1 -0
  43. package/dist/edges/index.d.ts +3 -0
  44. package/dist/edges/index.js +556 -0
  45. package/dist/edges/index.js.map +1 -0
  46. package/dist/edges/informs.d.ts +6 -0
  47. package/dist/edges/informs.js +112 -0
  48. package/dist/edges/informs.js.map +1 -0
  49. package/dist/edges/propagationTypes.d.ts +39 -0
  50. package/dist/edges/propagationTypes.js +17 -0
  51. package/dist/edges/propagationTypes.js.map +1 -0
  52. package/dist/edges/refutes.d.ts +6 -0
  53. package/dist/edges/refutes.js +108 -0
  54. package/dist/edges/refutes.js.map +1 -0
  55. package/dist/edges/supports.d.ts +6 -0
  56. package/dist/edges/supports.js +193 -0
  57. package/dist/edges/supports.js.map +1 -0
  58. package/dist/edges/tests.d.ts +6 -0
  59. package/dist/edges/tests.js +14 -0
  60. package/dist/edges/tests.js.map +1 -0
  61. package/dist/edges/utils.d.ts +12 -0
  62. package/dist/edges/utils.js +188 -0
  63. package/dist/edges/utils.js.map +1 -0
  64. package/dist/embeddingTrigger.d.ts +24 -0
  65. package/dist/embeddingTrigger.js +24 -0
  66. package/dist/embeddingTrigger.js.map +1 -0
  67. package/dist/entityBridge-DMaKooYn.d.ts +59 -0
  68. package/dist/entityBridge.d.ts +1 -0
  69. package/dist/entityBridge.js +663 -0
  70. package/dist/entityBridge.js.map +1 -0
  71. package/dist/entityLifecycle-BkhRJ-XI.d.ts +69 -0
  72. package/dist/entityLifecycle.d.ts +1 -0
  73. package/dist/entityLifecycle.js +2083 -0
  74. package/dist/entityLifecycle.js.map +1 -0
  75. package/dist/entityValidation-KLZ_Xl2D.d.ts +50 -0
  76. package/dist/entityValidation.d.ts +3 -0
  77. package/dist/entityValidation.js +71 -0
  78. package/dist/entityValidation.js.map +1 -0
  79. package/dist/epistemicAnswers-DSP1slZ9.d.ts +67 -0
  80. package/dist/epistemicAnswers.d.ts +1 -0
  81. package/dist/epistemicAnswers.js +1650 -0
  82. package/dist/epistemicAnswers.js.map +1 -0
  83. package/dist/epistemicBeliefs-DtFVTp-k.d.ts +377 -0
  84. package/dist/epistemicBeliefs.d.ts +5 -0
  85. package/dist/epistemicBeliefs.js +6386 -0
  86. package/dist/epistemicBeliefs.js.map +1 -0
  87. package/dist/epistemicContractHelpers.d.ts +1 -0
  88. package/dist/epistemicContractHelpers.js +320 -0
  89. package/dist/epistemicContractHelpers.js.map +1 -0
  90. package/dist/epistemicContracts.d.ts +77 -0
  91. package/dist/epistemicContracts.js +8436 -0
  92. package/dist/epistemicContracts.js.map +1 -0
  93. package/dist/epistemicEdges-DcA8ErUG.d.ts +191 -0
  94. package/dist/epistemicEdges.d.ts +2 -0
  95. package/dist/epistemicEdges.js +2749 -0
  96. package/dist/epistemicEdges.js.map +1 -0
  97. package/dist/epistemicEvidence-Bo638XDP.d.ts +128 -0
  98. package/dist/epistemicEvidence.d.ts +3 -0
  99. package/dist/epistemicEvidence.js +3282 -0
  100. package/dist/epistemicEvidence.js.map +1 -0
  101. package/dist/epistemicHelpers-Bd9xbaib.d.ts +329 -0
  102. package/dist/epistemicHelpers.d.ts +4 -0
  103. package/dist/epistemicHelpers.js +999 -0
  104. package/dist/epistemicHelpers.js.map +1 -0
  105. package/dist/epistemicLinking-CyeLOIzN.d.ts +35 -0
  106. package/dist/epistemicLinking.d.ts +1 -0
  107. package/dist/epistemicLinking.js +1391 -0
  108. package/dist/epistemicLinking.js.map +1 -0
  109. package/dist/epistemicNodes-BpD6Koud.d.ts +167 -0
  110. package/dist/epistemicNodes.d.ts +2 -0
  111. package/dist/epistemicNodes.js +2942 -0
  112. package/dist/epistemicNodes.js.map +1 -0
  113. package/dist/epistemicQuestions-CmEeY6zQ.d.ts +214 -0
  114. package/dist/epistemicQuestions.d.ts +3 -0
  115. package/dist/epistemicQuestions.js +4993 -0
  116. package/dist/epistemicQuestions.js.map +1 -0
  117. package/dist/epistemicSources-ZazxHOK1.d.ts +25 -0
  118. package/dist/epistemicSources.d.ts +1 -0
  119. package/dist/epistemicSources.js +2025 -0
  120. package/dist/epistemicSources.js.map +1 -0
  121. package/dist/evaluators/index.d.ts +9 -0
  122. package/dist/evaluators/index.js +8440 -0
  123. package/dist/evaluators/index.js.map +1 -0
  124. package/dist/evaluators/lintCheckerEvaluator.d.ts +11 -0
  125. package/dist/evaluators/lintCheckerEvaluator.js +155 -0
  126. package/dist/evaluators/lintCheckerEvaluator.js.map +1 -0
  127. package/dist/evaluators/sentryCheckerEvaluator.d.ts +11 -0
  128. package/dist/evaluators/sentryCheckerEvaluator.js +126 -0
  129. package/dist/evaluators/sentryCheckerEvaluator.js.map +1 -0
  130. package/dist/evaluators/shared.d.ts +27 -0
  131. package/dist/evaluators/shared.js +92 -0
  132. package/dist/evaluators/shared.js.map +1 -0
  133. package/dist/evaluators/testRunnerEvaluator.d.ts +17 -0
  134. package/dist/evaluators/testRunnerEvaluator.js +232 -0
  135. package/dist/evaluators/testRunnerEvaluator.js.map +1 -0
  136. package/dist/evaluators/tscCheckerEvaluator.d.ts +11 -0
  137. package/dist/evaluators/tscCheckerEvaluator.js +189 -0
  138. package/dist/evaluators/tscCheckerEvaluator.js.map +1 -0
  139. package/dist/globalId-DKh9d_uD.d.ts +20 -0
  140. package/dist/globalId.d.ts +1 -0
  141. package/dist/globalId.js +15 -0
  142. package/dist/globalId.js.map +1 -0
  143. package/dist/graphTypes-CpgIuCdo.d.ts +52 -0
  144. package/dist/graphTypes.d.ts +1 -0
  145. package/dist/graphTypes.js +120 -0
  146. package/dist/graphTypes.js.map +1 -0
  147. package/dist/helpers-BYHIk5vU.d.ts +27 -0
  148. package/dist/helpers.d.ts +4 -0
  149. package/dist/helpers.js +313 -0
  150. package/dist/helpers.js.map +1 -0
  151. package/dist/index-Dct1T70K.d.ts +25 -0
  152. package/dist/index-Dq-7R-gi.d.ts +31 -0
  153. package/dist/index.d.ts +45 -0
  154. package/dist/index.js +22294 -0
  155. package/dist/index.js.map +1 -0
  156. package/dist/invariantEnforcement.d.ts +52 -0
  157. package/dist/invariantEnforcement.js +231 -0
  158. package/dist/invariantEnforcement.js.map +1 -0
  159. package/dist/logicalRoleInference-CJxqWi3u.d.ts +16 -0
  160. package/dist/logicalRoleInference.d.ts +3 -0
  161. package/dist/logicalRoleInference.js +64 -0
  162. package/dist/logicalRoleInference.js.map +1 -0
  163. package/dist/matcherFeedbackUtils.d.ts +33 -0
  164. package/dist/matcherFeedbackUtils.js +95 -0
  165. package/dist/matcherFeedbackUtils.js.map +1 -0
  166. package/dist/ontology-matching-Buhu23ss.d.ts +48 -0
  167. package/dist/ontology-matching.d.ts +2 -0
  168. package/dist/ontology-matching.js +346 -0
  169. package/dist/ontology-matching.js.map +1 -0
  170. package/dist/ontologyApproval-Ba0Jjk1k.d.ts +26 -0
  171. package/dist/ontologyApproval.d.ts +1 -0
  172. package/dist/ontologyApproval.js +78 -0
  173. package/dist/ontologyApproval.js.map +1 -0
  174. package/dist/ontologyDefinitions.d.ts +72 -0
  175. package/dist/ontologyDefinitions.js +635 -0
  176. package/dist/ontologyDefinitions.js.map +1 -0
  177. package/dist/ontologyHelpers.d.ts +79 -0
  178. package/dist/ontologyHelpers.js +81 -0
  179. package/dist/ontologyHelpers.js.map +1 -0
  180. package/dist/ontologyRegistry-B67rPJ16.d.ts +31 -0
  181. package/dist/ontologyRegistry.d.ts +1 -0
  182. package/dist/ontologyRegistry.js +296 -0
  183. package/dist/ontologyRegistry.js.map +1 -0
  184. package/dist/projectionReconciliation-CxrXYGaB.d.ts +20 -0
  185. package/dist/projectionReconciliation.d.ts +1 -0
  186. package/dist/projectionReconciliation.js +261 -0
  187. package/dist/projectionReconciliation.js.map +1 -0
  188. package/dist/projectionStaleness-CAdpIsaW.d.ts +51 -0
  189. package/dist/projectionStaleness.d.ts +1 -0
  190. package/dist/projectionStaleness.js +57 -0
  191. package/dist/projectionStaleness.js.map +1 -0
  192. package/dist/questionEvidenceLinks-BdQD0TkM.d.ts +34 -0
  193. package/dist/questionEvidenceLinks.d.ts +1 -0
  194. package/dist/questionEvidenceLinks.js +1690 -0
  195. package/dist/questionEvidenceLinks.js.map +1 -0
  196. package/dist/resolverTypes-CC8Ea2E2.d.ts +20 -0
  197. package/dist/resolverTypes.d.ts +4 -0
  198. package/dist/resolverTypes.js +3 -0
  199. package/dist/resolverTypes.js.map +1 -0
  200. package/dist/resolvers-Br1a6eLV.d.ts +14 -0
  201. package/dist/resolvers.d.ts +5 -0
  202. package/dist/resolvers.js +308 -0
  203. package/dist/resolvers.js.map +1 -0
  204. package/dist/scopeResolverCompat.d.ts +26 -0
  205. package/dist/scopeResolverCompat.js +242 -0
  206. package/dist/scopeResolverCompat.js.map +1 -0
  207. package/dist/text-matching-CMn2WnVD.d.ts +40 -0
  208. package/dist/text-matching.d.ts +2 -0
  209. package/dist/text-matching.js +246 -0
  210. package/dist/text-matching.js.map +1 -0
  211. package/dist/topicOntologyResolver.d.ts +80 -0
  212. package/dist/topicOntologyResolver.js +67 -0
  213. package/dist/topicOntologyResolver.js.map +1 -0
  214. package/dist/topicProjectOverlay.d.ts +92 -0
  215. package/dist/topicProjectOverlay.js +249 -0
  216. package/dist/topicProjectOverlay.js.map +1 -0
  217. package/dist/topicScope-By_zp4tt.d.ts +34 -0
  218. package/dist/topicScope.d.ts +3 -0
  219. package/dist/topicScope.js +206 -0
  220. package/dist/topicScope.js.map +1 -0
  221. package/dist/workspaceIsolation.d.ts +44 -0
  222. package/dist/workspaceIsolation.js +950 -0
  223. package/dist/workspaceIsolation.js.map +1 -0
  224. package/package.json +46 -0
@@ -0,0 +1,2025 @@
1
+ import { v } from 'convex/values';
2
+ import { componentsGeneric, defineTable, mutationGeneric, anyApi, queryGeneric } from 'convex/server';
3
+
4
+ // src/epistemicSources.ts
5
+ var api = anyApi;
6
+ componentsGeneric();
7
+
8
+ // ../access-control/src/topicProjectOverlay.ts
9
+ var LEGACY_SCOPE_FIELD = "graphScopeProjectId";
10
+ function readNonEmptyString(value) {
11
+ if (typeof value !== "string") {
12
+ return;
13
+ }
14
+ const normalized = value.trim();
15
+ return normalized.length > 0 ? normalized : void 0;
16
+ }
17
+ function readStringArray(value) {
18
+ if (!Array.isArray(value)) {
19
+ return [];
20
+ }
21
+ return value.map((entry) => readNonEmptyString(entry)).filter((entry) => Boolean(entry));
22
+ }
23
+ function readMetadata(topic) {
24
+ return topic.metadata && typeof topic.metadata === "object" ? topic.metadata : {};
25
+ }
26
+ function readLegacyProjectId(value) {
27
+ if (!value) {
28
+ return;
29
+ }
30
+ return readNonEmptyString(value[LEGACY_SCOPE_FIELD]);
31
+ }
32
+ function coerceVisibility(value) {
33
+ return value === "private" || value === "team" || value === "firm" || value === "external" || value === "public" ? value : void 0;
34
+ }
35
+ function coerceStatus(value) {
36
+ return value === "active" || value === "archived" || value === "watching" ? value : void 0;
37
+ }
38
+ function mapProjectType(topic, metadata) {
39
+ const explicit = readNonEmptyString(metadata.projectType);
40
+ if (explicit) {
41
+ return explicit;
42
+ }
43
+ if (topic.type === "theme") {
44
+ return "thematic";
45
+ }
46
+ return readNonEmptyString(topic.type) || "general";
47
+ }
48
+ function isProjectLikeTopic(topic) {
49
+ const metadata = readMetadata(topic);
50
+ return topic.type === "theme" || topic.type === "thematic" || topic.type === "deal" || topic.type === "monitoring" || readLegacyProjectId(topic) !== void 0 || readNonEmptyString(metadata.projectType) !== void 0;
51
+ }
52
+ async function resolveTopicDoc(ctx, scopeId) {
53
+ if (ctx?.db && typeof ctx.db.get === "function") {
54
+ try {
55
+ const directTopic = await ctx.db.get(scopeId);
56
+ if (directTopic) {
57
+ return directTopic;
58
+ }
59
+ } catch {
60
+ }
61
+ }
62
+ if (typeof ctx.runQuery !== "function") {
63
+ return null;
64
+ }
65
+ try {
66
+ const topic = await ctx.runQuery(api.topics.get, {
67
+ id: String(scopeId)
68
+ });
69
+ if (topic?.name !== void 0 && topic?.type !== void 0) {
70
+ return topic;
71
+ }
72
+ } catch {
73
+ }
74
+ try {
75
+ const topic = await ctx.runQuery(api.topics.getByLegacyScopeId, {
76
+ projectId: String(scopeId)
77
+ });
78
+ if (topic?.name !== void 0 && topic?.type !== void 0) {
79
+ return topic;
80
+ }
81
+ } catch {
82
+ }
83
+ return null;
84
+ }
85
+ function materializeTopicProjectOverlay(topic, idMode = "legacy") {
86
+ const metadata = readMetadata(topic);
87
+ const topicId = String(topic._id);
88
+ const legacyProjectId = readLegacyProjectId(topic) || readLegacyProjectId(metadata) || readNonEmptyString(metadata.legacyProjectId);
89
+ const storageProjectId = legacyProjectId || topicId;
90
+ const outwardId = idMode === "topic" ? topicId : storageProjectId;
91
+ const visibility = coerceVisibility(topic.visibility) || coerceVisibility(metadata.visibility) || "private";
92
+ const status = coerceStatus(topic.status) || coerceStatus(metadata.status) || "active";
93
+ const createdAt = typeof topic.createdAt === "number" ? topic.createdAt : typeof topic._creationTime === "number" ? topic._creationTime : 0;
94
+ const updatedAt = typeof topic.updatedAt === "number" ? topic.updatedAt : typeof metadata.updatedAt === "number" ? metadata.updatedAt : createdAt;
95
+ return {
96
+ ...metadata,
97
+ _id: outwardId,
98
+ projectId: outwardId,
99
+ topicId,
100
+ storageProjectId,
101
+ legacyProjectId,
102
+ name: readNonEmptyString(topic.name) || "Untitled Theme",
103
+ type: mapProjectType(topic, metadata),
104
+ description: readNonEmptyString(topic.description),
105
+ ownerId: readNonEmptyString(metadata.ownerId) || readNonEmptyString(topic.createdBy) || "system",
106
+ sharedWith: readStringArray(metadata.sharedWith),
107
+ visibility,
108
+ tenantId: readNonEmptyString(topic.tenantId) || readNonEmptyString(metadata.tenantId),
109
+ workspaceId: readNonEmptyString(topic.workspaceId) || readNonEmptyString(metadata.workspaceId),
110
+ status,
111
+ tags: readStringArray(metadata.tags),
112
+ chatCount: typeof metadata.chatCount === "number" ? metadata.chatCount : 0,
113
+ artifactCount: typeof metadata.artifactCount === "number" ? metadata.artifactCount : 0,
114
+ lastActivityAt: typeof metadata.lastActivityAt === "number" ? metadata.lastActivityAt : updatedAt,
115
+ _creationTime: typeof topic._creationTime === "number" ? topic._creationTime : createdAt,
116
+ createdAt,
117
+ updatedAt
118
+ };
119
+ }
120
+ async function resolveTopicProjectOverlay(ctx, scopeId, options = {}) {
121
+ const topic = await resolveTopicDoc(ctx, scopeId);
122
+ if (!topic) {
123
+ return null;
124
+ }
125
+ if (options.projectLikeOnly !== false && !isProjectLikeTopic(topic)) {
126
+ return null;
127
+ }
128
+ return materializeTopicProjectOverlay(topic, options.idMode);
129
+ }
130
+ async function listTopicProjectOverlays(ctx, options = {}) {
131
+ let allTopics = [];
132
+ if (ctx?.db?.query && typeof ctx.db.query === "function") {
133
+ try {
134
+ allTopics = await ctx.db.query("topics").collect();
135
+ } catch {
136
+ allTopics = [];
137
+ }
138
+ }
139
+ if (allTopics.length === 0 && typeof ctx.runQuery === "function") {
140
+ allTopics = (await ctx.runQuery(api.topics.list, {}) ?? []) || [];
141
+ }
142
+ return allTopics.filter(
143
+ (topic) => options.projectLikeOnly === false || isProjectLikeTopic(topic)
144
+ ).map((topic) => materializeTopicProjectOverlay(topic, options.idMode));
145
+ }
146
+
147
+ // ../access-control/src/projectGrantsBridge.ts
148
+ var PROJECT_GRANT_STATUSES = ["active", "revoked", "expired"];
149
+ function normalizeString(value) {
150
+ if (typeof value !== "string") {
151
+ return;
152
+ }
153
+ const trimmed = value.trim();
154
+ return trimmed.length > 0 ? trimmed : void 0;
155
+ }
156
+ async function resolveGrantScopeIds(ctx, args) {
157
+ const topicId = normalizeString(args.topicId);
158
+ const projectId = normalizeString(args.projectId);
159
+ for (const scopeId of [topicId, projectId]) {
160
+ if (!scopeId) {
161
+ continue;
162
+ }
163
+ try {
164
+ const overlay = await resolveTopicProjectOverlay(ctx, scopeId, {
165
+ idMode: "legacy",
166
+ projectLikeOnly: false
167
+ });
168
+ if (overlay) {
169
+ return {
170
+ topicId: normalizeString(overlay.topicId) ?? topicId,
171
+ projectId: normalizeString(overlay.projectId) ?? projectId ?? scopeId
172
+ };
173
+ }
174
+ } catch {
175
+ }
176
+ }
177
+ return { topicId, projectId };
178
+ }
179
+ async function normalizeProjectGrantRow(ctx, row) {
180
+ const scope = await resolveGrantScopeIds(ctx, {
181
+ topicId: row.topicId,
182
+ projectId: row.projectId
183
+ });
184
+ return {
185
+ ...row,
186
+ ...scope.topicId ? { topicId: scope.topicId } : {},
187
+ ...scope.projectId ?? scope.topicId ? { projectId: scope.projectId ?? scope.topicId } : {}
188
+ };
189
+ }
190
+ async function normalizeProjectGrantRows(ctx, rows) {
191
+ return await Promise.all(rows.map((row) => normalizeProjectGrantRow(ctx, row)));
192
+ }
193
+ async function listProjectGrantsByPrincipal(ctx, principalId) {
194
+ const rows = await Promise.all(
195
+ PROJECT_GRANT_STATUSES.map(
196
+ (status) => ctx.db.query("projectGrants").withIndex(
197
+ "by_principal_status",
198
+ (q) => q.eq("principalId", principalId).eq("status", status)
199
+ ).collect()
200
+ )
201
+ );
202
+ return await normalizeProjectGrantRows(ctx, rows.flat());
203
+ }
204
+ async function listProjectGrantsByGroup(ctx, groupId) {
205
+ const rows = await Promise.all(
206
+ PROJECT_GRANT_STATUSES.map(
207
+ (status) => ctx.db.query("projectGrants").withIndex(
208
+ "by_group_status",
209
+ (q) => q.eq("groupId", groupId).eq("status", status)
210
+ ).collect()
211
+ )
212
+ );
213
+ return await normalizeProjectGrantRows(ctx, rows.flat());
214
+ }
215
+ function buildScopeMatchers(inputScopeId, resolved) {
216
+ return new Set(
217
+ [inputScopeId, resolved.topicId, resolved.projectId].map((value) => normalizeString(value)).filter((value) => Boolean(value))
218
+ );
219
+ }
220
+ function matchesResolvedScope(row, scopeIds) {
221
+ const rowTopicId = normalizeString(row.topicId);
222
+ const rowProjectId = normalizeString(row.projectId);
223
+ return rowTopicId !== void 0 && scopeIds.has(rowTopicId) || rowProjectId !== void 0 && scopeIds.has(rowProjectId);
224
+ }
225
+ async function bridgeListProjectGrantsByTopicAndPrincipal(ctx, topicId, principalId) {
226
+ const resolved = await resolveGrantScopeIds(ctx, { topicId });
227
+ const scopeIds = buildScopeMatchers(topicId, resolved);
228
+ const rows = await listProjectGrantsByPrincipal(ctx, principalId);
229
+ return rows.filter((row) => matchesResolvedScope(row, scopeIds));
230
+ }
231
+ async function bridgeListProjectGrantsByTopicAndGroup(ctx, topicId, groupId) {
232
+ const resolved = await resolveGrantScopeIds(ctx, { topicId });
233
+ const scopeIds = buildScopeMatchers(topicId, resolved);
234
+ const rows = await listProjectGrantsByGroup(ctx, groupId);
235
+ return rows.filter((row) => matchesResolvedScope(row, scopeIds));
236
+ }
237
+ async function bridgeListProjectGrantsByPrincipalStatus(ctx, principalId, status) {
238
+ const rows = await listProjectGrantsByPrincipal(ctx, principalId);
239
+ return rows.filter((row) => row.status === status);
240
+ }
241
+ async function bridgeListProjectGrantsByGroupStatus(ctx, groupId, status) {
242
+ const rows = await listProjectGrantsByGroup(ctx, groupId);
243
+ return rows.filter((row) => row.status === status);
244
+ }
245
+ async function bridgeInsertProjectGrant(ctx, value) {
246
+ const resolved = await resolveGrantScopeIds(ctx, value);
247
+ return await ctx.db.insert("projectGrants", {
248
+ ...value,
249
+ ...resolved.topicId ? { topicId: resolved.topicId } : {},
250
+ ...resolved.projectId ?? resolved.topicId ? { projectId: resolved.projectId ?? resolved.topicId } : {}
251
+ });
252
+ }
253
+
254
+ // ../access-control/src/resolvers.ts
255
+ async function findUserByClerkId(ctx, clerkId) {
256
+ const normalizedClerkId = clerkId.trim();
257
+ if (!normalizedClerkId) {
258
+ return null;
259
+ }
260
+ if (typeof ctx.runQuery === "function") {
261
+ try {
262
+ const bridgedUser = await ctx.runQuery(api.users.getUserByClerkId, {
263
+ clerkId: normalizedClerkId
264
+ });
265
+ if (bridgedUser) {
266
+ return bridgedUser;
267
+ }
268
+ } catch {
269
+ }
270
+ }
271
+ try {
272
+ const users = await ctx.db.query("users").collect();
273
+ return users.find((user) => String(user.clerkId ?? "") === normalizedClerkId) ?? null;
274
+ } catch {
275
+ return null;
276
+ }
277
+ }
278
+ async function findUserByPrincipalId(ctx, principalId) {
279
+ const normalizedPrincipalId = principalId.trim();
280
+ if (!normalizedPrincipalId) {
281
+ return null;
282
+ }
283
+ try {
284
+ const users = await ctx.db.query("users").collect();
285
+ return users.find(
286
+ (user) => String(user.defaultPrincipalId ?? "") === normalizedPrincipalId
287
+ ) ?? null;
288
+ } catch {
289
+ return null;
290
+ }
291
+ }
292
+ async function findAgentByPrincipalId(ctx, principalId) {
293
+ const normalizedPrincipalId = principalId.trim();
294
+ if (!normalizedPrincipalId) {
295
+ return null;
296
+ }
297
+ if (typeof ctx.runQuery === "function") {
298
+ try {
299
+ const bridgedAgent = await ctx.runQuery(
300
+ api.agents.getAgentByPrincipalId,
301
+ {
302
+ principalId: normalizedPrincipalId
303
+ }
304
+ );
305
+ if (bridgedAgent) {
306
+ return bridgedAgent;
307
+ }
308
+ } catch {
309
+ }
310
+ }
311
+ try {
312
+ const agents = await ctx.db.query("agents").collect();
313
+ return agents.find(
314
+ (agent) => String(agent.principalId ?? "") === normalizedPrincipalId
315
+ ) ?? null;
316
+ } catch {
317
+ return null;
318
+ }
319
+ }
320
+ function defaultResolvers() {
321
+ return {
322
+ async getProject(ctx, topicId) {
323
+ return await resolveTopicProjectOverlay(ctx, topicId, {
324
+ idMode: "legacy",
325
+ projectLikeOnly: false
326
+ });
327
+ },
328
+ async listTopics(ctx) {
329
+ return await listTopicProjectOverlays(ctx, { idMode: "legacy" });
330
+ },
331
+ async listTopicsByOwner(ctx, ownerId) {
332
+ const topics = await listTopicProjectOverlays(ctx, { idMode: "legacy" });
333
+ return topics.filter((topic) => topic.ownerId === ownerId);
334
+ },
335
+ async listTopicsByVisibility(ctx, visibility) {
336
+ const topics = await listTopicProjectOverlays(ctx, { idMode: "legacy" });
337
+ return topics.filter((topic) => topic.visibility === visibility);
338
+ },
339
+ async listProjectGrantsByProjectAndPrincipal(ctx, topicId, principalId) {
340
+ return await bridgeListProjectGrantsByTopicAndPrincipal(
341
+ ctx,
342
+ topicId,
343
+ principalId
344
+ );
345
+ },
346
+ async listProjectGrantsByProjectAndGroup(ctx, topicId, groupId) {
347
+ return await bridgeListProjectGrantsByTopicAndGroup(ctx, topicId, groupId);
348
+ },
349
+ async listProjectGrantsByPrincipalStatus(ctx, principalId, status) {
350
+ return await bridgeListProjectGrantsByPrincipalStatus(
351
+ ctx,
352
+ principalId,
353
+ status
354
+ );
355
+ },
356
+ async listProjectGrantsByGroupStatus(ctx, groupId, status) {
357
+ return await bridgeListProjectGrantsByGroupStatus(ctx, groupId, status);
358
+ },
359
+ async insertProjectGrant(ctx, value) {
360
+ return await bridgeInsertProjectGrant(ctx, value);
361
+ },
362
+ async getAgentByPrincipalId(ctx, principalId) {
363
+ return await findAgentByPrincipalId(ctx, principalId);
364
+ },
365
+ async getUserByClerkId(ctx, clerkId) {
366
+ return await findUserByClerkId(ctx, clerkId);
367
+ },
368
+ async getUserByPrincipalId(ctx, principalId) {
369
+ return await findUserByPrincipalId(ctx, principalId);
370
+ }
371
+ };
372
+ }
373
+ var resolverOverrides = {};
374
+ function resolveAccessControlAppResolvers(_ctx) {
375
+ return {
376
+ ...defaultResolvers(),
377
+ ...resolverOverrides
378
+ };
379
+ }
380
+
381
+ // ../access-control/src/principalContext.ts
382
+ function requireCanonicalResolvedUser(user, clerkId) {
383
+ const resolved = user;
384
+ if (!resolved) {
385
+ throw new Error(
386
+ `[AccessControl] Canonical user identity required for ${clerkId}. Sync users.upsertUser before user-bound access checks.`
387
+ );
388
+ }
389
+ const { mcRole, defaultTenantId, defaultWorkspaceId, defaultPrincipalId } = resolved;
390
+ if (mcRole !== "platform_admin" && mcRole !== "tenant_admin" && mcRole !== "workspace_admin" && mcRole !== "editor" && mcRole !== "viewer" && mcRole !== "auditor" && mcRole !== "service_agent") {
391
+ throw new Error(
392
+ `[AccessControl] Canonical MC role required for ${clerkId}. Re-sync Master Control identity before user-bound access checks.`
393
+ );
394
+ }
395
+ if (typeof defaultTenantId !== "string" || defaultTenantId.trim().length === 0) {
396
+ throw new Error(
397
+ `[AccessControl] Canonical home tenant required for ${clerkId}. Re-sync Master Control identity before user-bound access checks.`
398
+ );
399
+ }
400
+ if (typeof defaultWorkspaceId !== "string" || defaultWorkspaceId.trim().length === 0) {
401
+ throw new Error(
402
+ `[AccessControl] Canonical home workspace required for ${clerkId}. Re-sync Master Control identity before user-bound access checks.`
403
+ );
404
+ }
405
+ if (typeof defaultPrincipalId !== "string" || defaultPrincipalId.trim().length === 0) {
406
+ throw new Error(
407
+ `[AccessControl] Canonical federated principal required for ${clerkId}. Re-sync Master Control identity before user-bound access checks.`
408
+ );
409
+ }
410
+ return {
411
+ mcRole,
412
+ defaultTenantId: defaultTenantId.trim(),
413
+ defaultWorkspaceId: defaultWorkspaceId.trim(),
414
+ defaultPrincipalId: defaultPrincipalId.trim()
415
+ };
416
+ }
417
+ function isPrincipalIdInput(value) {
418
+ return value.startsWith("user:") || value.startsWith("group:") || value.startsWith("service:") || value.startsWith("agent:") || value.startsWith("external_viewer:");
419
+ }
420
+ async function resolveCanonicalUserRecord(ctx, actorId) {
421
+ const normalizedActorId = actorId.trim();
422
+ const clerkId = isPrincipalIdInput(normalizedActorId) && normalizedActorId.startsWith("user:") ? normalizedActorId.slice("user:".length) : normalizedActorId;
423
+ const resolvers = resolveAccessControlAppResolvers();
424
+ const resolvedByClerkId = await resolvers.getUserByClerkId(ctx, clerkId);
425
+ if (resolvedByClerkId) {
426
+ return {
427
+ resolvedUser: resolvedByClerkId,
428
+ clerkId,
429
+ contextClerkId: clerkId
430
+ };
431
+ }
432
+ const resolvedByPrincipalId = await resolvers.getUserByPrincipalId(
433
+ ctx,
434
+ normalizedActorId
435
+ );
436
+ return {
437
+ resolvedUser: resolvedByPrincipalId ?? null,
438
+ clerkId,
439
+ contextClerkId: normalizedActorId.startsWith("user:") && clerkId.length > 0 ? clerkId : normalizedActorId
440
+ };
441
+ }
442
+ function uniqRoles(roles) {
443
+ const roleSet = /* @__PURE__ */ new Set();
444
+ for (const role of roles) {
445
+ if (role === "platform_admin" || role === "tenant_admin" || role === "workspace_admin" || role === "editor" || role === "viewer" || role === "auditor" || role === "service_agent") {
446
+ roleSet.add(role);
447
+ }
448
+ }
449
+ return [...roleSet];
450
+ }
451
+ function normalizeGroupIds(value) {
452
+ if (!Array.isArray(value)) {
453
+ return [];
454
+ }
455
+ return [...new Set(
456
+ value.filter((entry) => typeof entry === "string").map((entry) => entry.trim()).filter(Boolean)
457
+ )];
458
+ }
459
+ function requireServiceAgentUser(user, actorId) {
460
+ const canonicalUser = requireCanonicalResolvedUser(user, actorId);
461
+ if (canonicalUser.mcRole !== "service_agent") {
462
+ throw new Error(
463
+ `[AccessControl] Canonical service_agent identity required for ${actorId}. Sync users.upsertUser before agent-bound access checks.`
464
+ );
465
+ }
466
+ return canonicalUser;
467
+ }
468
+ function requireCanonicalResolvedAgent(agent, actorId) {
469
+ const resolved = agent;
470
+ if (!resolved) {
471
+ throw new Error(
472
+ `[AccessControl] Agent "${actorId}" not found in agents or users table.`
473
+ );
474
+ }
475
+ if (typeof resolved.principalId !== "string" || resolved.principalId.trim().length === 0) {
476
+ throw new Error(
477
+ `[AccessControl] Canonical agent principalId required for ${actorId}.`
478
+ );
479
+ }
480
+ if (typeof resolved.tenantId !== "string" || resolved.tenantId.trim().length === 0) {
481
+ throw new Error(
482
+ `[AccessControl] Canonical home tenant required for ${actorId}.`
483
+ );
484
+ }
485
+ if (typeof resolved.workspaceId !== "string" || resolved.workspaceId.trim().length === 0) {
486
+ throw new Error(
487
+ `[AccessControl] Canonical home workspace required for ${actorId}.`
488
+ );
489
+ }
490
+ return {
491
+ principalId: resolved.principalId.trim(),
492
+ tenantId: resolved.tenantId.trim(),
493
+ workspaceId: resolved.workspaceId.trim(),
494
+ roles: uniqRoles(Array.isArray(resolved.roles) ? resolved.roles : []) ?? ["service_agent"],
495
+ groupIds: normalizeGroupIds(resolved.groupIds)
496
+ };
497
+ }
498
+ async function resolvePrincipalContext(ctx, actorId) {
499
+ if (actorId.startsWith("agent:")) {
500
+ const resolvers = resolveAccessControlAppResolvers();
501
+ const resolvedAgent = await resolvers.getAgentByPrincipalId(ctx, actorId);
502
+ if (resolvedAgent) {
503
+ const agent = requireCanonicalResolvedAgent(
504
+ resolvedAgent,
505
+ actorId
506
+ );
507
+ return {
508
+ principalId: agent.principalId,
509
+ principalType: "service",
510
+ clerkId: actorId,
511
+ tenantId: agent.tenantId,
512
+ workspaceId: agent.workspaceId,
513
+ roles: agent.roles.length > 0 ? agent.roles : ["service_agent"],
514
+ groupIds: agent.groupIds,
515
+ isPlatformAdmin: false,
516
+ isTenantAdmin: false,
517
+ isWorkspaceAdmin: false,
518
+ isSystemFallback: false
519
+ };
520
+ }
521
+ const resolvedUser2 = await resolvers.getUserByClerkId(
522
+ ctx,
523
+ actorId
524
+ );
525
+ if (!resolvedUser2) {
526
+ throw new Error(
527
+ `[AccessControl] Agent "${actorId}" not found in agents or users table.`
528
+ );
529
+ }
530
+ const user2 = requireServiceAgentUser(
531
+ resolvedUser2,
532
+ actorId
533
+ );
534
+ console.warn(
535
+ `[AccessControl] Deprecated legacy service-agent fallback for ${actorId}; migrate this principal into identity.agents.`
536
+ );
537
+ return {
538
+ principalId: user2.defaultPrincipalId,
539
+ principalType: "service",
540
+ clerkId: actorId,
541
+ tenantId: user2.defaultTenantId,
542
+ workspaceId: user2.defaultWorkspaceId,
543
+ roles: ["service_agent"],
544
+ groupIds: normalizeGroupIds(resolvedUser2?.principalGroupIds),
545
+ isPlatformAdmin: false,
546
+ isTenantAdmin: false,
547
+ isWorkspaceAdmin: false,
548
+ isSystemFallback: false
549
+ };
550
+ }
551
+ const {
552
+ resolvedUser,
553
+ contextClerkId
554
+ } = await resolveCanonicalUserRecord(ctx, actorId);
555
+ const user = requireCanonicalResolvedUser(
556
+ resolvedUser,
557
+ contextClerkId
558
+ );
559
+ if (!user.defaultPrincipalId) {
560
+ throw new Error(
561
+ `[AccessControl] Canonical federated principal required for ${contextClerkId}. Re-sync Master Control identity before user-bound access checks.`
562
+ );
563
+ }
564
+ if (user.mcRole === "service_agent") {
565
+ return {
566
+ principalId: user.defaultPrincipalId,
567
+ principalType: "service",
568
+ clerkId: contextClerkId,
569
+ tenantId: user.defaultTenantId,
570
+ workspaceId: user.defaultWorkspaceId,
571
+ roles: ["service_agent"],
572
+ groupIds: normalizeGroupIds(resolvedUser?.principalGroupIds),
573
+ isPlatformAdmin: false,
574
+ isTenantAdmin: false,
575
+ isWorkspaceAdmin: false,
576
+ isSystemFallback: false
577
+ };
578
+ }
579
+ const principalId = user.defaultPrincipalId;
580
+ const effectiveRole = user.mcRole;
581
+ const roles = effectiveRole === "platform_admin" ? ["platform_admin", "tenant_admin"] : effectiveRole === "tenant_admin" ? ["tenant_admin"] : [effectiveRole];
582
+ const tenantId = user.defaultTenantId;
583
+ const workspaceId = user.defaultWorkspaceId;
584
+ const isPlatformAdmin = effectiveRole === "platform_admin";
585
+ return {
586
+ principalId,
587
+ principalType: "user",
588
+ clerkId: contextClerkId,
589
+ tenantId,
590
+ workspaceId,
591
+ roles: uniqRoles(roles),
592
+ groupIds: normalizeGroupIds(resolvedUser?.principalGroupIds),
593
+ isPlatformAdmin,
594
+ isTenantAdmin: isPlatformAdmin || effectiveRole === "tenant_admin",
595
+ isWorkspaceAdmin: isPlatformAdmin || effectiveRole === "tenant_admin" || effectiveRole === "workspace_admin",
596
+ isSystemFallback: false
597
+ };
598
+ }
599
+
600
+ // ../access-control/src/access.ts
601
+ function isTopicInPrincipalTenant(topic, principalTenantId) {
602
+ if (!topic.tenantId) {
603
+ return false;
604
+ }
605
+ if (!principalTenantId) {
606
+ return false;
607
+ }
608
+ return String(topic.tenantId) === String(principalTenantId);
609
+ }
610
+ function isTopicInPrincipalWorkspace(topic, principalWorkspaceId) {
611
+ if (!topic.workspaceId) {
612
+ return false;
613
+ }
614
+ if (!principalWorkspaceId) {
615
+ return false;
616
+ }
617
+ return String(topic.workspaceId) === String(principalWorkspaceId);
618
+ }
619
+ function isLegacyUnscopedTopic(topic) {
620
+ return !topic.tenantId || !topic.workspaceId;
621
+ }
622
+ function isGrantScopeAlignedToTopic(topic, grant) {
623
+ if (topic.tenantId && grant.tenantId && String(topic.tenantId) !== String(grant.tenantId)) {
624
+ return false;
625
+ }
626
+ if (topic.workspaceId && grant.workspaceId && String(topic.workspaceId) !== String(grant.workspaceId)) {
627
+ return false;
628
+ }
629
+ return true;
630
+ }
631
+ function isGrantSourceAllowedForVisibility(visibility, source) {
632
+ if (source !== "external_share") {
633
+ return true;
634
+ }
635
+ return visibility === "external" || visibility === "public";
636
+ }
637
+ function isGrantActive(grant) {
638
+ if (grant.status !== "active") {
639
+ return false;
640
+ }
641
+ if (grant.expiresAt !== void 0 && grant.expiresAt <= Date.now()) {
642
+ return false;
643
+ }
644
+ return true;
645
+ }
646
+ async function hasPrincipalGrant(ctx, args) {
647
+ const grants = await resolveAccessControlAppResolvers().listProjectGrantsByProjectAndPrincipal(
648
+ ctx,
649
+ args.topic._id,
650
+ args.principalId
651
+ );
652
+ if (grants.some(
653
+ (grant) => isGrantActive(grant) && isGrantScopeAlignedToTopic(args.topic, grant) && isGrantSourceAllowedForVisibility(
654
+ args.topic.visibility,
655
+ grant.source
656
+ ) && (!args.principalIsExternal || args.topic.visibility === "public" || grant.source === "external_share")
657
+ )) {
658
+ return true;
659
+ }
660
+ return false;
661
+ }
662
+ async function hasGroupGrant(ctx, args) {
663
+ if (args.groupIds.length === 0) {
664
+ return false;
665
+ }
666
+ for (const groupId of args.groupIds) {
667
+ const grants = await resolveAccessControlAppResolvers().listProjectGrantsByProjectAndGroup(ctx, args.topic._id, groupId);
668
+ if (grants.some(
669
+ (grant) => isGrantActive(grant) && isGrantScopeAlignedToTopic(args.topic, grant) && isGrantSourceAllowedForVisibility(
670
+ args.topic.visibility,
671
+ grant.source
672
+ )
673
+ )) {
674
+ return true;
675
+ }
676
+ }
677
+ return false;
678
+ }
679
+ function isExternalPrincipal(_ctx, _args) {
680
+ return false;
681
+ }
682
+ async function evaluateTopicAccessDetailed(ctx, args) {
683
+ if (args.legacyUserId) {
684
+ return {
685
+ hasAccess: true,
686
+ isAdmin: false,
687
+ isOwner: false,
688
+ isShared: false,
689
+ hasGrant: true,
690
+ isFirmVisible: true,
691
+ isExternalVisible: false,
692
+ isPublicVisible: false,
693
+ isTenantScopeMatch: true,
694
+ isWorkspaceScopeMatch: true,
695
+ isPrincipalExternal: false
696
+ };
697
+ }
698
+ const topic = await resolveAccessControlAppResolvers().getProject(
699
+ ctx,
700
+ args.topicId
701
+ );
702
+ if (!topic) {
703
+ return {
704
+ hasAccess: false,
705
+ isAdmin: false,
706
+ isOwner: false,
707
+ isShared: false,
708
+ hasGrant: false,
709
+ isFirmVisible: false,
710
+ isExternalVisible: false,
711
+ isPublicVisible: false,
712
+ isTenantScopeMatch: false,
713
+ isWorkspaceScopeMatch: false,
714
+ isPrincipalExternal: false
715
+ };
716
+ }
717
+ const { principalContext, legacyUserId } = args;
718
+ const userIsAdmin = principalContext.isPlatformAdmin;
719
+ const isOwner = topic.ownerId === legacyUserId;
720
+ const isShared = (topic.sharedWith ?? []).includes(legacyUserId);
721
+ const principalIsExternal = await isExternalPrincipal(ctx, {
722
+ groupIds: principalContext.groupIds,
723
+ topicTenantId: topic.tenantId,
724
+ topicWorkspaceId: topic.workspaceId
725
+ });
726
+ const hasPrincipalGrantResult = await hasPrincipalGrant(ctx, {
727
+ topic,
728
+ principalId: principalContext.principalId,
729
+ principalIsExternal
730
+ });
731
+ const hasGroupGrantResult = await hasGroupGrant(ctx, {
732
+ topic,
733
+ groupIds: principalContext.groupIds
734
+ });
735
+ const hasGrant = isShared || hasPrincipalGrantResult || hasGroupGrantResult;
736
+ const legacyUnscoped = isLegacyUnscopedTopic(topic);
737
+ const tenantScopeMatch = isTopicInPrincipalTenant(
738
+ topic,
739
+ principalContext.tenantId
740
+ );
741
+ const workspaceScopeMatch = isTopicInPrincipalWorkspace(
742
+ topic,
743
+ principalContext.workspaceId
744
+ );
745
+ const isPublicVisible = topic.visibility === "public";
746
+ const isFirmVisible = topic.visibility === "firm" && !legacyUnscoped && tenantScopeMatch && workspaceScopeMatch && !principalIsExternal;
747
+ const hasScopedGrant = hasGrant && (legacyUnscoped || tenantScopeMatch && workspaceScopeMatch);
748
+ const isExternalVisible = topic.visibility === "external" && hasScopedGrant;
749
+ const hasAccess = userIsAdmin || isOwner || hasScopedGrant || isPublicVisible || isFirmVisible;
750
+ return {
751
+ hasAccess,
752
+ isAdmin: userIsAdmin,
753
+ isOwner,
754
+ isShared,
755
+ hasGrant,
756
+ isFirmVisible,
757
+ isExternalVisible,
758
+ isPublicVisible,
759
+ isTenantScopeMatch: tenantScopeMatch,
760
+ isWorkspaceScopeMatch: workspaceScopeMatch,
761
+ isPrincipalExternal: principalIsExternal
762
+ };
763
+ }
764
+ async function checkTopicAccessDetailed(ctx, topicId, userId) {
765
+ const principalContext = await resolvePrincipalContext(ctx, userId);
766
+ return evaluateTopicAccessDetailed(ctx, {
767
+ topicId,
768
+ legacyUserId: userId,
769
+ principalContext
770
+ });
771
+ }
772
+ async function checkTopicAccess(ctx, topicId, userId) {
773
+ const result = await checkTopicAccessDetailed(ctx, topicId, userId);
774
+ return result.hasAccess;
775
+ }
776
+ async function checkScopeAccess(ctx, scopeId, userId) {
777
+ try {
778
+ const topic = await ctx.db.get(scopeId);
779
+ if (topic && topic.name !== void 0 && topic.type !== void 0) {
780
+ return true;
781
+ }
782
+ } catch {
783
+ }
784
+ try {
785
+ return await checkTopicAccess(ctx, scopeId, userId);
786
+ } catch {
787
+ return false;
788
+ }
789
+ }
790
+ async function requireTopicAccess(ctx, topicId, userId) {
791
+ const hasAccess = await checkTopicAccess(ctx, topicId, userId);
792
+ if (!hasAccess) {
793
+ throw new Error(
794
+ "Access denied: You don't have permission to access this topic"
795
+ );
796
+ }
797
+ }
798
+ var requireProjectAccess = requireTopicAccess;
799
+ var permissiveReturn = v.optional(v.any());
800
+ var looseJsonObject = v.record(v.string(), v.any());
801
+ var looseJsonArray = v.array(v.any());
802
+ v.union(
803
+ v.string(),
804
+ v.number(),
805
+ v.boolean(),
806
+ v.null(),
807
+ looseJsonObject,
808
+ looseJsonArray
809
+ );
810
+ var api2 = anyApi;
811
+ componentsGeneric();
812
+ var internal = anyApi;
813
+ var mutation = mutationGeneric;
814
+ var query = queryGeneric;
815
+
816
+ // src/embeddingTrigger.ts
817
+ async function scheduleEmbeddingGeneration(args) {
818
+ try {
819
+ await args.ctx.scheduler.runAfter(
820
+ 0,
821
+ "embeddingActions:generateEpistemicNodeEmbedding",
822
+ {
823
+ nodeId: args.nodeId,
824
+ projectId: args.projectId ? String(args.projectId) : void 0,
825
+ topicId: args.topicId ? String(args.topicId) : void 0,
826
+ createdBy: args.createdBy,
827
+ nodeType: args.nodeType,
828
+ text: args.text.slice(0, 2e4),
829
+ hasAnswer: args.hasAnswer,
830
+ confidence: args.confidence
831
+ }
832
+ );
833
+ } catch {
834
+ }
835
+ }
836
+
837
+ // src/globalId.ts
838
+ function generateGlobalId() {
839
+ const bytes = new Uint8Array(16);
840
+ crypto.getRandomValues(bytes);
841
+ bytes[6] = bytes[6] & 15 | 64;
842
+ bytes[8] = bytes[8] & 63 | 128;
843
+ const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join(
844
+ ""
845
+ );
846
+ return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
847
+ }
848
+ var LEGACY_SCOPE_FIELD2 = "graphScopeProjectId";
849
+ function asMappedProjectId(topic) {
850
+ if (!topic) {
851
+ return;
852
+ }
853
+ const directLegacyProjectId = normalizeScopeValue(topic[LEGACY_SCOPE_FIELD2]);
854
+ if (directLegacyProjectId) {
855
+ return directLegacyProjectId;
856
+ }
857
+ const metadata = topic.metadata || {};
858
+ const candidate = metadata[LEGACY_SCOPE_FIELD2] || metadata.legacyProjectId || metadata.projectId || metadata.scopeProjectId;
859
+ return candidate ? candidate : void 0;
860
+ }
861
+ function normalizeScopeValue(value) {
862
+ if (typeof value !== "string") {
863
+ return;
864
+ }
865
+ const normalized = value.trim();
866
+ return normalized.length > 0 ? normalized : void 0;
867
+ }
868
+ function pickPrimaryTopic(candidates) {
869
+ return [...candidates].sort((a, b) => {
870
+ const depthA = a.depth ?? 9999;
871
+ const depthB = b.depth ?? 9999;
872
+ if (depthA !== depthB) {
873
+ return depthA - depthB;
874
+ }
875
+ const createdA = a.createdAt ?? Number.MAX_SAFE_INTEGER;
876
+ const createdB = b.createdAt ?? Number.MAX_SAFE_INTEGER;
877
+ if (createdA !== createdB) {
878
+ return createdA - createdB;
879
+ }
880
+ return String(a.name || "").localeCompare(String(b.name || ""));
881
+ })[0];
882
+ }
883
+ async function findTopicsByScopeAlias(ctx, scopeId) {
884
+ try {
885
+ return await ctx.db.query("topics").withIndex(
886
+ "by_graph_scope_project",
887
+ (q) => q.eq(LEGACY_SCOPE_FIELD2, scopeId)
888
+ ).collect();
889
+ } catch {
890
+ const topics = await ctx.db.query("topics").collect();
891
+ return topics.filter((topic) => {
892
+ const normalizedGlobalId = normalizeScopeValue(topic.globalId);
893
+ const mappedProjectId = asMappedProjectId(topic);
894
+ return String(topic._id) === scopeId || normalizedGlobalId === scopeId || mappedProjectId === scopeId;
895
+ });
896
+ }
897
+ }
898
+ async function tryResolveHostTopicById(ctx, topicId) {
899
+ if (typeof ctx.runQuery !== "function") {
900
+ return null;
901
+ }
902
+ try {
903
+ return await ctx.runQuery(api2.topics.get, {
904
+ id: topicId
905
+ }) ?? null;
906
+ } catch {
907
+ return null;
908
+ }
909
+ }
910
+ async function tryResolveHostTopicByLegacyScope(ctx, legacyScopeId) {
911
+ if (typeof ctx.runQuery !== "function") {
912
+ return null;
913
+ }
914
+ try {
915
+ return await ctx.runQuery(api2.topics.getByLegacyScopeId, {
916
+ projectId: legacyScopeId
917
+ }) ?? null;
918
+ } catch {
919
+ return null;
920
+ }
921
+ }
922
+ async function resolveInheritedWorkspaceScope(ctx, topic) {
923
+ const MAX_DEPTH = 10;
924
+ let tenantId = normalizeScopeValue(topic.tenantId);
925
+ let workspaceId = normalizeScopeValue(topic.workspaceId);
926
+ if (tenantId && workspaceId) {
927
+ return { tenantId, workspaceId };
928
+ }
929
+ let current = topic;
930
+ for (let i = 0; i < MAX_DEPTH && current?.parentTopicId; i++) {
931
+ current = await ctx.db.get(current.parentTopicId);
932
+ if (!current) break;
933
+ if (!tenantId) {
934
+ tenantId = normalizeScopeValue(current.tenantId);
935
+ }
936
+ if (!workspaceId) {
937
+ workspaceId = normalizeScopeValue(current.workspaceId);
938
+ }
939
+ if (tenantId && workspaceId) break;
940
+ }
941
+ return { tenantId, workspaceId };
942
+ }
943
+ async function resolveTopicProjectScope(ctx, args) {
944
+ if (args.topicId) {
945
+ let topic = null;
946
+ try {
947
+ topic = await ctx.db.get(args.topicId);
948
+ } catch {
949
+ }
950
+ if (!topic) {
951
+ topic = await tryResolveHostTopicById(ctx, String(args.topicId));
952
+ }
953
+ if (!topic) {
954
+ topic = pickPrimaryTopic(
955
+ await findTopicsByScopeAlias(ctx, String(args.topicId))
956
+ ) ?? null;
957
+ }
958
+ if (!topic) {
959
+ throw new Error(`Topic not found: ${String(args.topicId)}`);
960
+ }
961
+ const inherited = await resolveInheritedWorkspaceScope(ctx, topic);
962
+ const mapped = asMappedProjectId(topic);
963
+ if (mapped) {
964
+ return {
965
+ topicId: topic._id,
966
+ projectId: mapped,
967
+ tenantId: inherited.tenantId,
968
+ workspaceId: inherited.workspaceId,
969
+ source: "topic"
970
+ };
971
+ }
972
+ return {
973
+ topicId: topic._id,
974
+ tenantId: inherited.tenantId,
975
+ workspaceId: inherited.workspaceId,
976
+ source: "topic"
977
+ };
978
+ }
979
+ if (args.projectId) {
980
+ let directTopic = null;
981
+ try {
982
+ directTopic = await ctx.db.get(
983
+ args.projectId
984
+ );
985
+ } catch {
986
+ }
987
+ if (directTopic) {
988
+ const inherited = await resolveInheritedWorkspaceScope(ctx, directTopic);
989
+ const mapped = asMappedProjectId(directTopic);
990
+ return {
991
+ topicId: directTopic._id,
992
+ projectId: mapped ?? args.projectId,
993
+ tenantId: inherited.tenantId,
994
+ workspaceId: inherited.workspaceId,
995
+ source: "topic_inferred"
996
+ };
997
+ }
998
+ directTopic = await tryResolveHostTopicByLegacyScope(ctx, args.projectId);
999
+ if (directTopic) {
1000
+ const inherited = await resolveInheritedWorkspaceScope(ctx, directTopic);
1001
+ const mapped = asMappedProjectId(directTopic);
1002
+ return {
1003
+ topicId: directTopic._id,
1004
+ projectId: mapped ?? args.projectId,
1005
+ tenantId: inherited.tenantId,
1006
+ workspaceId: inherited.workspaceId,
1007
+ source: "topic_inferred"
1008
+ };
1009
+ }
1010
+ const topics = await findTopicsByScopeAlias(ctx, args.projectId);
1011
+ const primary = pickPrimaryTopic(topics);
1012
+ if (primary) {
1013
+ const inherited = await resolveInheritedWorkspaceScope(ctx, primary);
1014
+ return {
1015
+ topicId: primary._id,
1016
+ projectId: args.projectId,
1017
+ tenantId: inherited.tenantId,
1018
+ workspaceId: inherited.workspaceId,
1019
+ source: "project_mapped_topic"
1020
+ };
1021
+ }
1022
+ throw new Error(
1023
+ `Legacy project scope ${String(args.projectId)} has no mapped topic.`
1024
+ );
1025
+ }
1026
+ throw new Error(
1027
+ "Missing scope: provide topicId (preferred) or legacy projectId alias."
1028
+ );
1029
+ }
1030
+ ({
1031
+ projectId: v.optional(v.string()),
1032
+ topicId: v.optional(v.string())
1033
+ });
1034
+ v.number();
1035
+ v.union(
1036
+ v.literal("very_high"),
1037
+ // 0.9+
1038
+ v.literal("high"),
1039
+ // 0.7-0.9
1040
+ v.literal("medium"),
1041
+ // 0.4-0.7
1042
+ v.literal("low"),
1043
+ // 0.2-0.4
1044
+ v.literal("very_low")
1045
+ // 0-0.2
1046
+ );
1047
+ v.union(
1048
+ v.literal(1),
1049
+ // Critical
1050
+ v.literal(2),
1051
+ // High
1052
+ v.literal(3),
1053
+ // Medium
1054
+ v.literal(4),
1055
+ // Low
1056
+ v.literal(5)
1057
+ // Backlog
1058
+ );
1059
+ v.union(
1060
+ v.literal("critical"),
1061
+ v.literal("high"),
1062
+ v.literal("medium"),
1063
+ v.literal("low"),
1064
+ v.literal("backlog")
1065
+ );
1066
+ v.union(
1067
+ v.literal("active"),
1068
+ v.literal("paused"),
1069
+ v.literal("completed"),
1070
+ v.literal("archived")
1071
+ );
1072
+ v.union(
1073
+ v.literal("pending"),
1074
+ v.literal("processing"),
1075
+ v.literal("completed"),
1076
+ v.literal("failed")
1077
+ );
1078
+ v.object({
1079
+ crunchbaseId: v.optional(v.string()),
1080
+ linkedinUrl: v.optional(v.string()),
1081
+ pitchbookId: v.optional(v.string()),
1082
+ twitterUrl: v.optional(v.string()),
1083
+ domain: v.optional(v.string())
1084
+ });
1085
+ var sourceType = v.union(
1086
+ v.literal("proprietary"),
1087
+ // Internal Stack research
1088
+ v.literal("primary"),
1089
+ // Direct interviews, calls
1090
+ v.literal("secondary"),
1091
+ // Published sources
1092
+ v.literal("ai_generated"),
1093
+ // AI-synthesized
1094
+ v.literal("user_input"),
1095
+ // Manual user entry
1096
+ v.literal("inferred")
1097
+ // System inference
1098
+ );
1099
+ v.object({
1100
+ sourceType: v.optional(sourceType),
1101
+ sourceId: v.optional(v.string()),
1102
+ // Reference to source entity
1103
+ sourceUrl: v.optional(v.string()),
1104
+ sourceDate: v.optional(v.number()),
1105
+ sourceName: v.optional(v.string())
1106
+ });
1107
+ v.object({
1108
+ cursor: v.optional(v.string()),
1109
+ limit: v.optional(v.number())
1110
+ });
1111
+ v.object({
1112
+ hasMore: v.boolean(),
1113
+ nextCursor: v.optional(v.string()),
1114
+ totalCount: v.optional(v.number())
1115
+ });
1116
+ var richTextContent = v.object({
1117
+ type: v.literal("doc"),
1118
+ content: looseJsonArray
1119
+ });
1120
+ v.union(v.string(), richTextContent);
1121
+ v.object({
1122
+ promptTokens: v.optional(v.number()),
1123
+ completionTokens: v.optional(v.number()),
1124
+ totalTokens: v.optional(v.number())
1125
+ });
1126
+ v.object({
1127
+ fileName: v.optional(v.string()),
1128
+ fileSize: v.optional(v.number()),
1129
+ mimeType: v.optional(v.string()),
1130
+ storageId: v.optional(v.id("_storage")),
1131
+ externalUrl: v.optional(v.string())
1132
+ });
1133
+
1134
+ // ../schema-management/src/spine/tables/epistemicNodes.ts
1135
+ var nodeType = v.union(
1136
+ // --- L4: Audit Targets (decisions, outcomes) ---
1137
+ v.literal("decision"),
1138
+ // Investment decision with knowledge horizon snapshot
1139
+ // --- L3: Traversal Anchors (epistemic structure) ---
1140
+ v.literal("belief"),
1141
+ // Structured conviction (immutable formulation)
1142
+ v.literal("question"),
1143
+ // Unit of uncertainty
1144
+ v.literal("theme"),
1145
+ // Investment thesis / conviction cluster
1146
+ v.literal("deal"),
1147
+ // Investment evaluation process
1148
+ v.literal("topic"),
1149
+ // Hierarchical knowledge container
1150
+ // --- L2: Compression Boundary (minimum reasoning unit) ---
1151
+ v.literal("claim"),
1152
+ // Atomic assertion that can be true/false
1153
+ v.literal("evidence"),
1154
+ // Interpreted signal linked to beliefs
1155
+ v.literal("synthesis"),
1156
+ // Primers, deep research
1157
+ v.literal("answer"),
1158
+ // Immutable answer snapshot for a question
1159
+ // --- L1: Terminal Leaves (non-traversable, grounding) ---
1160
+ v.literal("atomic_fact"),
1161
+ // Raw fact from source (not interpreted)
1162
+ v.literal("excerpt"),
1163
+ // Direct quote from source document
1164
+ v.literal("source"),
1165
+ // News, documents, transcripts
1166
+ // --- Ontological Entities (things in the world) ---
1167
+ v.literal("company"),
1168
+ // Organization (subtype: private, corporate, portfolio)
1169
+ v.literal("person"),
1170
+ // Individual (founder, expert, LP, contact)
1171
+ v.literal("investor"),
1172
+ // Investment entity (subtype: vc, lp, cvc, pe, family_office, angel)
1173
+ v.literal("function"),
1174
+ // What a company does (from classifier)
1175
+ v.literal("value_chain")
1176
+ // Market structure / value flow
1177
+ );
1178
+ var epistemicLayer = v.union(
1179
+ v.literal("L4"),
1180
+ // Decisions, outcomes - audit targets
1181
+ v.literal("L3"),
1182
+ // Beliefs, questions, themes - traversal anchors
1183
+ v.literal("L2"),
1184
+ // Claims, evidence, synthesis - compression boundary
1185
+ v.literal("L1"),
1186
+ // Atomic facts, excerpts, sources - terminal leaves
1187
+ v.literal("ontological"),
1188
+ // Companies, people, etc - not epistemic
1189
+ v.literal("organizational")
1190
+ // Topics, lenses, worktrees — structural containers
1191
+ );
1192
+ var nodeStatus = v.union(
1193
+ v.literal("active"),
1194
+ v.literal("superseded"),
1195
+ // Replaced by newer version
1196
+ v.literal("archived"),
1197
+ v.literal("deleted")
1198
+ );
1199
+ var sourceType2 = v.union(
1200
+ v.literal("human"),
1201
+ // User created directly
1202
+ v.literal("ai_extracted"),
1203
+ // LLM extracted from a source
1204
+ v.literal("ai_generated"),
1205
+ // LLM synthesized/created
1206
+ v.literal("imported"),
1207
+ // External system import
1208
+ v.literal("system"),
1209
+ // System-generated (migrations, classifiers)
1210
+ v.literal("verified"),
1211
+ // Human-verified source
1212
+ v.literal("proprietary")
1213
+ // Proprietary/internal data
1214
+ );
1215
+ var verificationStatus = v.union(
1216
+ v.literal("unverified"),
1217
+ v.literal("human_verified"),
1218
+ v.literal("ai_verified"),
1219
+ v.literal("contradicted"),
1220
+ v.literal("outdated")
1221
+ );
1222
+ var syncStatus = v.union(
1223
+ v.literal("synced"),
1224
+ // Node and edges fully synced to Neo4j
1225
+ v.literal("pending_edges"),
1226
+ // Node created, edges being created
1227
+ v.literal("edge_creation_failed")
1228
+ // Edge creation failed, needs retry
1229
+ );
1230
+ var audienceLabel = v.string();
1231
+ var sensitivityTier = v.union(
1232
+ v.literal("low"),
1233
+ v.literal("medium"),
1234
+ v.literal("high"),
1235
+ v.literal("restricted")
1236
+ );
1237
+ var exportClass = v.union(
1238
+ v.literal("internal_only"),
1239
+ v.literal("client_safe"),
1240
+ v.literal("public_safe"),
1241
+ v.literal("restricted")
1242
+ );
1243
+ var anonymizationClass = v.union(
1244
+ v.literal("none"),
1245
+ v.literal("standard"),
1246
+ v.literal("strict")
1247
+ );
1248
+ var epistemicStatus = v.union(
1249
+ v.literal("hypothesis"),
1250
+ // Initial conjecture, low evidence
1251
+ v.literal("emerging"),
1252
+ // Building evidence, gaining traction
1253
+ v.literal("established"),
1254
+ // Well-evidenced, core to thesis
1255
+ v.literal("challenged"),
1256
+ // Contradicting evidence appeared
1257
+ v.literal("assumption"),
1258
+ // Taken as given, not actively tested
1259
+ v.literal("deprecated")
1260
+ // Superseded or abandoned
1261
+ );
1262
+ var beliefStatus = v.union(
1263
+ v.literal("assumption"),
1264
+ v.literal("hypothesis"),
1265
+ v.literal("belief"),
1266
+ v.literal("fact")
1267
+ );
1268
+ var reversibility = v.union(
1269
+ v.literal("irreversible"),
1270
+ // One-way door decision
1271
+ v.literal("hard_to_reverse"),
1272
+ // Significant cost to undo
1273
+ v.literal("reversible"),
1274
+ // Can change course with moderate effort
1275
+ v.literal("trivial")
1276
+ // Easy to adjust
1277
+ );
1278
+ var predictionOutcome = v.union(
1279
+ v.literal("pending"),
1280
+ v.literal("confirmed"),
1281
+ v.literal("disconfirmed"),
1282
+ v.literal("partial"),
1283
+ v.literal("expired")
1284
+ );
1285
+ var predictionMeta = v.object({
1286
+ isPrediction: v.boolean(),
1287
+ registeredAt: v.number(),
1288
+ // When prediction was made
1289
+ expectedBy: v.optional(v.number()),
1290
+ // When we expect resolution
1291
+ outcome: v.optional(predictionOutcome),
1292
+ outcomeRecordedAt: v.optional(v.number()),
1293
+ outcomeEvidenceId: v.optional(v.string()),
1294
+ // globalId of confirming evidence
1295
+ confidenceAtPrediction: v.optional(v.number()),
1296
+ // 0-1
1297
+ actualVsPredicted: v.optional(v.string())
1298
+ // Notes on how outcome compared
1299
+ });
1300
+ var methodology = v.union(
1301
+ // Primary Research (high value)
1302
+ v.literal("primary_research"),
1303
+ // Direct investigation
1304
+ v.literal("expert_interview"),
1305
+ // Expert call/interview
1306
+ v.literal("customer_interview"),
1307
+ // Customer research
1308
+ v.literal("field_observation"),
1309
+ // On-site observation
1310
+ v.literal("proprietary_data"),
1311
+ // Internal data analysis
1312
+ // Secondary Research
1313
+ v.literal("desk_research"),
1314
+ // Public sources
1315
+ v.literal("regulatory_filing"),
1316
+ // SEC, regulatory docs
1317
+ v.literal("news_article"),
1318
+ // News/press
1319
+ v.literal("academic_paper"),
1320
+ // Academic research
1321
+ // AI-Assisted
1322
+ v.literal("ai_synthesis"),
1323
+ // AI-generated synthesis
1324
+ v.literal("ai_extraction")
1325
+ // AI-extracted from source
1326
+ );
1327
+ var informationAsymmetry = v.union(
1328
+ v.literal("proprietary"),
1329
+ // Only we have this
1330
+ v.literal("early"),
1331
+ // We're early but others will get it
1332
+ v.literal("common")
1333
+ // Everyone has access
1334
+ );
1335
+ var temporalNature = v.union(
1336
+ v.literal("factual"),
1337
+ // Resolved outcome. Grounded in reality.
1338
+ v.literal("forecast"),
1339
+ // Prediction. Will resolve. Discounted weight.
1340
+ v.literal("unknown")
1341
+ // Not yet classified.
1342
+ );
1343
+ var questionType = v.union(
1344
+ v.literal("validation"),
1345
+ // Does evidence support this belief?
1346
+ v.literal("falsification"),
1347
+ // What would prove this belief wrong?
1348
+ v.literal("assumption_probe"),
1349
+ // Is this unstated assumption true?
1350
+ v.literal("prediction_test"),
1351
+ // Will this predicted outcome occur?
1352
+ v.literal("counterfactual"),
1353
+ // What would we expect if X were false?
1354
+ v.literal("discovery"),
1355
+ // What don't we know yet?
1356
+ v.literal("clarification"),
1357
+ // What does X actually mean?
1358
+ v.literal("comparison"),
1359
+ // How does X compare to Y?
1360
+ v.literal("causal"),
1361
+ // What caused X?
1362
+ v.literal("mechanism"),
1363
+ // How does X work?
1364
+ v.literal("general")
1365
+ // Unclassified
1366
+ );
1367
+ var questionPriority = v.union(
1368
+ v.literal("critical"),
1369
+ // Blocks decision-making
1370
+ v.literal("high"),
1371
+ // Important for thesis
1372
+ v.literal("medium"),
1373
+ // Would be nice to know
1374
+ v.literal("low")
1375
+ // Background/curiosity
1376
+ );
1377
+ var answerQuality = v.union(
1378
+ v.literal("definitive"),
1379
+ // Clear, well-supported
1380
+ v.literal("strong"),
1381
+ // Good evidence, high confidence
1382
+ v.literal("moderate"),
1383
+ // Some evidence
1384
+ v.literal("weak"),
1385
+ // Limited evidence
1386
+ v.literal("speculative"),
1387
+ // Mostly conjecture
1388
+ v.literal("unanswered")
1389
+ // No answer yet
1390
+ );
1391
+ var consensusView = v.union(
1392
+ v.literal("aligned"),
1393
+ // We agree with market consensus
1394
+ v.literal("ahead_of"),
1395
+ // We see this before consensus does
1396
+ v.literal("contrarian"),
1397
+ // We actively disagree with consensus
1398
+ v.literal("orthogonal"),
1399
+ // We're looking at something consensus isn't discussing
1400
+ v.literal("unknown")
1401
+ // We don't know what consensus thinks
1402
+ );
1403
+ var themeConviction = v.union(
1404
+ v.literal("high"),
1405
+ // Strong conviction, actively deploying
1406
+ v.literal("medium"),
1407
+ // Building conviction
1408
+ v.literal("low"),
1409
+ // Exploring, not convicted
1410
+ v.literal("negative")
1411
+ // Actively avoiding
1412
+ );
1413
+ var decisionType = v.union(
1414
+ v.literal("invest"),
1415
+ v.literal("pass"),
1416
+ v.literal("follow_on"),
1417
+ v.literal("exit"),
1418
+ v.literal("deep_dive"),
1419
+ v.literal("monitor"),
1420
+ v.literal("deprioritize"),
1421
+ v.literal("thesis_adopt"),
1422
+ v.literal("thesis_revise"),
1423
+ v.literal("thesis_abandon")
1424
+ );
1425
+ var decisionOutcome = v.union(
1426
+ v.literal("pending"),
1427
+ v.literal("successful"),
1428
+ v.literal("unsuccessful"),
1429
+ v.literal("mixed"),
1430
+ v.literal("unknown")
1431
+ );
1432
+ var externalIds2 = v.object({
1433
+ crunchbase: v.optional(v.string()),
1434
+ linkedin: v.optional(v.string()),
1435
+ pitchbook: v.optional(v.string()),
1436
+ twitter: v.optional(v.string()),
1437
+ website: v.optional(v.string())
1438
+ });
1439
+ defineTable({
1440
+ // === IDENTITY ===
1441
+ globalId: v.string(),
1442
+ // UUID - survives migration to Neo4j
1443
+ // === TYPE ===
1444
+ nodeType,
1445
+ // === EPISTEMIC LAYER ===
1446
+ epistemicLayer: v.optional(epistemicLayer),
1447
+ // === SUBTYPE (for typed entities) ===
1448
+ subtype: v.optional(v.string()),
1449
+ // company: private|corporate|portfolio, investor: vc|lp|cvc|pe|family_office|angel
1450
+ // === CONTENT ===
1451
+ canonicalText: v.string(),
1452
+ // The core content (belief statement, company name, etc.)
1453
+ contentHash: v.string(),
1454
+ // SHA256(nodeType + canonicalText) for deduplication
1455
+ // Extended content (for sources/syntheses)
1456
+ content: v.optional(v.string()),
1457
+ // Full text for documents/articles
1458
+ contentType: v.optional(v.string()),
1459
+ // "markdown", "html", "pdf", "text"
1460
+ // === METADATA ===
1461
+ title: v.optional(v.string()),
1462
+ // Display title
1463
+ tags: v.optional(v.array(v.string())),
1464
+ domain: v.optional(v.string()),
1465
+ // For companies: website domain
1466
+ // Type-specific metadata (flexible object - LEGACY)
1467
+ // New code should use the typed fields below when available
1468
+ metadata: v.optional(looseJsonObject),
1469
+ // === POLICY / ENTITLEMENT ===
1470
+ tenantId: v.optional(v.string()),
1471
+ workspaceId: v.optional(v.string()),
1472
+ ownerPrincipalId: v.optional(v.string()),
1473
+ audienceLabel: v.optional(audienceLabel),
1474
+ policyTags: v.optional(v.array(v.string())),
1475
+ sensitivityTier: v.optional(sensitivityTier),
1476
+ exportClass: v.optional(exportClass),
1477
+ anonymizationClass: v.optional(anonymizationClass),
1478
+ // === PUBLICATION (visibility-based, not copy-based) ===
1479
+ // Publication expands who can see a workspace-local node — the node stays
1480
+ // in its workspace, like a microservice exposing part of its API surface.
1481
+ // Rules-based: pack/tenant-level publicationRules auto-evaluate on
1482
+ // confidence changes and node creation. No manual click-by-click.
1483
+ publicationStatus: v.optional(
1484
+ v.union(
1485
+ v.literal("unpublished"),
1486
+ // Default: workspace-local only
1487
+ v.literal("published"),
1488
+ // Visible at tenant scope (rules matched)
1489
+ v.literal("suppressed")
1490
+ // Manually blocked even if rules match
1491
+ )
1492
+ ),
1493
+ publishedAt: v.optional(v.number()),
1494
+ // When publication status last changed to published
1495
+ publishedBy: v.optional(v.string()),
1496
+ // userId or "system:publication_rules" for auto-publish
1497
+ // === TYPED METADATA FIELDS ===
1498
+ // --- Belief ---
1499
+ // Belief type — validated against schemaEnumConfig category "belief_type"
1500
+ // Platform core: hypothesis, belief, principle, invariant, assumption,
1501
+ // tenet, prior, preference, goal, forecast
1502
+ beliefType: v.optional(v.string()),
1503
+ beliefStatus: v.optional(beliefStatus),
1504
+ epistemicStatus: v.optional(epistemicStatus),
1505
+ reversibility: v.optional(reversibility),
1506
+ predictionMeta: v.optional(predictionMeta),
1507
+ // Consensus tracking (for non-consensus detection)
1508
+ consensusView: v.optional(consensusView),
1509
+ consensusConfidence: v.optional(v.number()),
1510
+ // 0-1: What we think consensus confidence is
1511
+ consensusSource: v.optional(v.string()),
1512
+ // Where we got the consensus view (twitter, reports, etc.)
1513
+ // --- Evidence ---
1514
+ methodology: v.optional(methodology),
1515
+ informationAsymmetry: v.optional(informationAsymmetry),
1516
+ temporalNature: v.optional(temporalNature),
1517
+ // --- Question ---
1518
+ questionType: v.optional(questionType),
1519
+ questionPriority: v.optional(questionPriority),
1520
+ answerQuality: v.optional(answerQuality),
1521
+ // --- Theme ---
1522
+ themeConviction: v.optional(themeConviction),
1523
+ // Market timing (for "early on theme" detection)
1524
+ marketAwarenessDate: v.optional(v.number()),
1525
+ // When this theme became broadly discussed
1526
+ marketAwarenessSource: v.optional(v.string()),
1527
+ // How we know (first major report, twitter volume spike, etc.)
1528
+ earlySignalIds: v.optional(v.array(v.string())),
1529
+ // globalIds of evidence we had before market awareness
1530
+ // --- Decision ---
1531
+ decisionType: v.optional(decisionType),
1532
+ decisionOutcome: v.optional(decisionOutcome),
1533
+ // === EXTERNAL IDS (for ontological entities) ===
1534
+ externalIds: v.optional(externalIds2),
1535
+ // === PROVENANCE ===
1536
+ sourceType: sourceType2,
1537
+ aiProvider: v.optional(v.string()),
1538
+ // "claude", "gemini", "gpt-4", etc.
1539
+ extractedFromNodeId: v.optional(v.id("epistemicNodes")),
1540
+ // Quick reference to source
1541
+ // === EXTRACTION CONTEXT ===
1542
+ extractionModel: v.optional(v.string()),
1543
+ // "claude-sonnet-4-20250514"
1544
+ extractionPromptName: v.optional(v.string()),
1545
+ // "lucern/extract-evidence"
1546
+ extractionPromptVersion: v.optional(v.number()),
1547
+ extractionTemperature: v.optional(v.number()),
1548
+ extractionLangfuseTraceId: v.optional(v.string()),
1549
+ // === GROUNDING VERIFICATION ===
1550
+ groundingVerified: v.optional(v.boolean()),
1551
+ groundingConfidence: v.optional(v.number()),
1552
+ // 0-1 match quality
1553
+ groundingMatchedText: v.optional(v.string()),
1554
+ // Actual text from source
1555
+ groundingStartOffset: v.optional(v.number()),
1556
+ groundingEndOffset: v.optional(v.number()),
1557
+ groundingRejectionReason: v.optional(v.string()),
1558
+ // === CONFIDENCE & VERIFICATION ===
1559
+ confidence: v.optional(v.number()),
1560
+ // 0-1 projected probability P(x) = b + a*u
1561
+ verificationStatus: v.optional(verificationStatus),
1562
+ // === SL OPINION (Subjective Logic — Kernel v2) ===
1563
+ // Replaces scalar confidence with rich epistemic state.
1564
+ // b + d + u = 1. P(x) = b + a*u is stored in `confidence` for backward compat.
1565
+ opinion_b: v.optional(v.number()),
1566
+ // Belief: evidence FOR (0-1)
1567
+ opinion_d: v.optional(v.number()),
1568
+ // Disbelief: evidence AGAINST (0-1)
1569
+ opinion_u: v.optional(v.number()),
1570
+ // Uncertainty: absence of evidence (0-1)
1571
+ opinion_a: v.optional(v.number()),
1572
+ // Base rate / prior probability (0-1)
1573
+ tupleContradicted: v.optional(v.boolean()),
1574
+ // Single-belief tuple-space contradiction flag
1575
+ // === LIFECYCLE ===
1576
+ status: nodeStatus,
1577
+ supersededBy: v.optional(v.id("epistemicNodes")),
1578
+ // === OWNERSHIP ===
1579
+ topicId: v.optional(v.string()),
1580
+ // Canonical scope container (topic-first model)
1581
+ projectId: v.optional(v.string()),
1582
+ // DEPRECATED: Use belongs_to edges
1583
+ createdBy: v.string(),
1584
+ // Clerk user ID
1585
+ createdAt: v.number(),
1586
+ updatedAt: v.number(),
1587
+ // === NEO4J SYNC STATUS ===
1588
+ syncStatus: v.optional(syncStatus),
1589
+ syncError: v.optional(v.string())
1590
+ // Error message if sync failed
1591
+ }).index("by_globalId", ["globalId"]).index("by_contentHash", ["contentHash"]).index("by_nodeType", ["nodeType"]).index("by_subtype", ["nodeType", "subtype"]).index("by_domain", ["domain"]).index("by_project", ["projectId"]).index("by_project_type", ["projectId", "nodeType"]).index("by_topic", ["topicId"]).index("by_topic_type", ["topicId", "nodeType"]).index("by_tenantId", ["tenantId"]).index("by_workspaceId", ["workspaceId"]).index("by_tenant_workspace", ["tenantId", "workspaceId"]).index("by_audienceLabel", ["audienceLabel"]).index("by_sensitivityTier", ["sensitivityTier"]).index("by_exportClass", ["exportClass"]).index("by_status", ["status"]).index("by_sourceType", ["sourceType"]).index("by_verification", ["verificationStatus"]).index("by_layer", ["epistemicLayer"]).index("by_layer_type", ["epistemicLayer", "nodeType"]).index("by_syncStatus", ["syncStatus"]).index("by_publicationStatus", ["publicationStatus"]).index("by_tenant_publicationStatus", ["tenantId", "publicationStatus"]).index("by_belief_status", ["nodeType", "beliefStatus"]).index("by_epistemic_status", ["nodeType", "epistemicStatus"]).index("by_temporal_nature", ["nodeType", "temporalNature"]).index("by_methodology", ["nodeType", "methodology"]).index("by_reversibility", ["nodeType", "reversibility"]).index("by_questionType", ["nodeType", "questionType"]).index("by_questionPriority", ["nodeType", "questionPriority"]).searchIndex("search_canonicalText", {
1592
+ searchField: "canonicalText",
1593
+ filterFields: ["nodeType", "projectId", "topicId", "status"]
1594
+ });
1595
+ function getLayerForNodeType(type) {
1596
+ switch (type) {
1597
+ case "decision":
1598
+ return "L4";
1599
+ case "belief":
1600
+ case "question":
1601
+ case "theme":
1602
+ case "deal":
1603
+ return "L3";
1604
+ case "claim":
1605
+ case "evidence":
1606
+ case "synthesis":
1607
+ case "answer":
1608
+ return "L2";
1609
+ case "atomic_fact":
1610
+ case "excerpt":
1611
+ case "source":
1612
+ return "L1";
1613
+ case "topic":
1614
+ return "organizational";
1615
+ case "company":
1616
+ case "person":
1617
+ case "investor":
1618
+ case "function":
1619
+ case "value_chain":
1620
+ return "ontological";
1621
+ }
1622
+ }
1623
+
1624
+ // src/workspaceIsolation.ts
1625
+ function normalizeScopeValue2(value) {
1626
+ if (typeof value !== "string") {
1627
+ return;
1628
+ }
1629
+ const normalized = value.trim();
1630
+ return normalized.length > 0 ? normalized : void 0;
1631
+ }
1632
+ function throwWorkspaceIsolationError(args) {
1633
+ const error = new Error(args.message);
1634
+ error.status = 409;
1635
+ error.code = "INVARIANT_VIOLATION";
1636
+ error.invariantCode = args.invariantCode;
1637
+ error.suggestion = args.suggestion;
1638
+ error.details = args.details;
1639
+ throw error;
1640
+ }
1641
+ function assertWorkspaceScopedEpistemicNodeScope(args) {
1642
+ const layer = getLayerForNodeType(args.nodeType);
1643
+ if (layer === "ontological") {
1644
+ return;
1645
+ }
1646
+ const workspaceId = normalizeScopeValue2(args.scope.workspaceId);
1647
+ if (workspaceId) {
1648
+ return;
1649
+ }
1650
+ throwWorkspaceIsolationError({
1651
+ message: "Workspace-scoped reasoning isolation requires workspaceId on non-ontological node creation.",
1652
+ invariantCode: "workspace.scope_required_for_epistemic_nodes",
1653
+ suggestion: "Resolve the topic/project scope through a workspace-bound topic before creating epistemic nodes.",
1654
+ details: {
1655
+ mutationName: args.mutationName,
1656
+ nodeType: args.nodeType,
1657
+ topicId: args.scope.topicId,
1658
+ projectId: args.scope.projectId
1659
+ }
1660
+ });
1661
+ }
1662
+
1663
+ // src/epistemicSources.ts
1664
+ function throwStructuredSourceError(args) {
1665
+ const error = new Error(args.message);
1666
+ error.status = args.status;
1667
+ error.code = args.code;
1668
+ error.invariantCode = args.invariantCode;
1669
+ error.suggestion = args.suggestion;
1670
+ error.details = args.details;
1671
+ throw error;
1672
+ }
1673
+ function normalizeString2(value) {
1674
+ if (typeof value !== "string") {
1675
+ return void 0;
1676
+ }
1677
+ const normalized = value.trim();
1678
+ return normalized.length > 0 ? normalized : void 0;
1679
+ }
1680
+ function normalizeNumber(value) {
1681
+ return typeof value === "number" && Number.isFinite(value) ? value : void 0;
1682
+ }
1683
+ function asRecord(value) {
1684
+ return value && typeof value === "object" && !Array.isArray(value) ? value : {};
1685
+ }
1686
+ function normalizeMetadata(metadata) {
1687
+ const record = asRecord(metadata);
1688
+ const { url: _ignoredUrl, contentSha: _ignoredSha, ...rest } = record;
1689
+ return rest;
1690
+ }
1691
+ function generateSourceContentHash(identity) {
1692
+ const content2 = `source:${identity.trim().toLowerCase()}`;
1693
+ let hash = 5381;
1694
+ for (let index = 0; index < content2.length; index += 1) {
1695
+ hash = (hash << 5) + hash + content2.charCodeAt(index);
1696
+ hash &= hash;
1697
+ }
1698
+ return Math.abs(hash).toString(16).padStart(8, "0");
1699
+ }
1700
+ function normalizeSourceUrl(url) {
1701
+ const trimmed = normalizeString2(url);
1702
+ if (!trimmed) {
1703
+ throwStructuredSourceError({
1704
+ message: "Source URL is required.",
1705
+ status: 400,
1706
+ code: "INVALID_REQUEST",
1707
+ invariantCode: "source.url.valid",
1708
+ suggestion: "Provide an absolute URL with a valid protocol and host."
1709
+ });
1710
+ }
1711
+ let parsed;
1712
+ try {
1713
+ parsed = new URL(trimmed);
1714
+ } catch {
1715
+ throwStructuredSourceError({
1716
+ message: `Invalid URL: ${trimmed}`,
1717
+ status: 400,
1718
+ code: "INVALID_REQUEST",
1719
+ invariantCode: "source.url.valid",
1720
+ suggestion: "Provide an absolute URL with a valid protocol and host.",
1721
+ details: { url: trimmed }
1722
+ });
1723
+ }
1724
+ const protocol = parsed.protocol.toLowerCase();
1725
+ const hostname = parsed.hostname.toLowerCase();
1726
+ const port = parsed.port ? `:${parsed.port}` : "";
1727
+ const pathname = parsed.pathname === "/" ? "" : parsed.pathname.replace(/\/+$/, "");
1728
+ const sortedEntries = [...parsed.searchParams.entries()].sort(
1729
+ ([aKey, aValue], [bKey, bValue]) => aKey === bKey ? aValue.localeCompare(bValue) : aKey.localeCompare(bKey)
1730
+ );
1731
+ const params = new URLSearchParams();
1732
+ for (const [key, value] of sortedEntries) {
1733
+ params.append(key, value);
1734
+ }
1735
+ const search = params.toString();
1736
+ return `${protocol}//${hostname}${port}${pathname}${search.length > 0 ? `?${search}` : ""}`;
1737
+ }
1738
+ async function findSourceByIdentity(ctx, args) {
1739
+ const sourceNodes = await ctx.db.query("epistemicNodes").withIndex("by_nodeType", (q) => q.eq("nodeType", "source")).collect();
1740
+ let urlMatch = null;
1741
+ let shaMatch = null;
1742
+ for (const node of sourceNodes) {
1743
+ const metadata = asRecord(node.metadata);
1744
+ if (args.normalizedUrl && normalizeString2(metadata.url) === args.normalizedUrl && !urlMatch) {
1745
+ urlMatch = node;
1746
+ }
1747
+ if (args.sha && normalizeString2(metadata.contentSha) === args.sha && !shaMatch) {
1748
+ shaMatch = node;
1749
+ }
1750
+ if (urlMatch && (!args.sha || shaMatch)) {
1751
+ break;
1752
+ }
1753
+ }
1754
+ if (urlMatch && shaMatch && String(urlMatch._id) !== String(shaMatch._id)) {
1755
+ throwStructuredSourceError({
1756
+ message: "Source identity conflict: URL and SHA resolve to different source nodes.",
1757
+ status: 409,
1758
+ code: "CONTENT_SHA_MISMATCH",
1759
+ invariantCode: "source.content_hash_immutable",
1760
+ suggestion: "Same source identity resolves to different records. Create a new source with a distinct URL or use fork semantics.",
1761
+ details: {
1762
+ urlSourceId: String(urlMatch._id),
1763
+ shaSourceId: String(shaMatch._id)
1764
+ }
1765
+ });
1766
+ }
1767
+ return urlMatch ?? shaMatch;
1768
+ }
1769
+ function buildSourceMetadata(args) {
1770
+ const existingMetadata = args.existingMetadata ?? {};
1771
+ const nextMetadata = {
1772
+ ...existingMetadata,
1773
+ kind: args.kind,
1774
+ ...args.metadata
1775
+ };
1776
+ if (args.capturedAt !== void 0) {
1777
+ nextMetadata.capturedAt = args.capturedAt;
1778
+ }
1779
+ if (!Object.prototype.hasOwnProperty.call(existingMetadata, "url") && args.normalizedUrl) {
1780
+ nextMetadata.url = args.normalizedUrl;
1781
+ } else if (Object.prototype.hasOwnProperty.call(existingMetadata, "url")) {
1782
+ nextMetadata.url = existingMetadata.url;
1783
+ }
1784
+ if (!Object.prototype.hasOwnProperty.call(existingMetadata, "contentSha") && args.sha) {
1785
+ nextMetadata.contentSha = args.sha;
1786
+ } else if (Object.prototype.hasOwnProperty.call(existingMetadata, "contentSha")) {
1787
+ nextMetadata.contentSha = existingMetadata.contentSha;
1788
+ }
1789
+ return nextMetadata;
1790
+ }
1791
+ function sourceEmbeddingText(args) {
1792
+ const lines = [
1793
+ normalizeString2(args.title),
1794
+ normalizeString2(args.url),
1795
+ args.kind,
1796
+ normalizeString2(args.metadata.sourceDescription)
1797
+ ].filter((value) => Boolean(value));
1798
+ return lines.join("\n");
1799
+ }
1800
+ var upsertSource = mutation({
1801
+ args: {
1802
+ url: v.optional(v.string()),
1803
+ sha: v.optional(v.string()),
1804
+ kind: v.string(),
1805
+ title: v.optional(v.string()),
1806
+ capturedAt: v.optional(v.number()),
1807
+ metadata: v.optional(v.any()),
1808
+ topicId: v.optional(v.string()),
1809
+ userId: v.string()
1810
+ },
1811
+ returns: permissiveReturn,
1812
+ handler: async (ctx, args) => {
1813
+ const normalizedUrl = normalizeString2(args.url) ? normalizeSourceUrl(args.url) : void 0;
1814
+ const sha = normalizeString2(args.sha);
1815
+ if (!normalizedUrl && !sha) {
1816
+ throwStructuredSourceError({
1817
+ message: "Source identity requires a URL or content SHA.",
1818
+ status: 400,
1819
+ code: "INVALID_REQUEST",
1820
+ invariantCode: "source.identity.required",
1821
+ suggestion: "Provide url or sha."
1822
+ });
1823
+ }
1824
+ const now = Date.now();
1825
+ const metadataPatch = normalizeMetadata(args.metadata);
1826
+ const existing = await findSourceByIdentity(ctx, { normalizedUrl, sha });
1827
+ if (existing) {
1828
+ if (existing.topicId && !await checkScopeAccess(ctx, String(existing.topicId), args.userId)) {
1829
+ throwStructuredSourceError({
1830
+ message: "Access denied to existing source scope.",
1831
+ status: 403,
1832
+ code: "FORBIDDEN",
1833
+ invariantCode: "policy.scope_required",
1834
+ suggestion: "Request access to the source topic scope and retry.",
1835
+ details: { topicId: existing.topicId }
1836
+ });
1837
+ }
1838
+ const existingMetadata = asRecord(existing.metadata);
1839
+ const existingSha = normalizeString2(existingMetadata.contentSha);
1840
+ if (sha && existingSha && existingSha !== sha) {
1841
+ throwStructuredSourceError({
1842
+ message: "Same URL cannot be reused with a different content hash.",
1843
+ status: 409,
1844
+ code: "CONTENT_SHA_MISMATCH",
1845
+ invariantCode: "source.content_hash_immutable",
1846
+ suggestion: "Same URL, different content. Create a new source with a distinct URL or use fork semantics.",
1847
+ details: {
1848
+ sourceId: String(existing._id),
1849
+ url: existingMetadata.url,
1850
+ existingSha,
1851
+ receivedSha: sha
1852
+ }
1853
+ });
1854
+ }
1855
+ const nextMetadata2 = buildSourceMetadata({
1856
+ existingMetadata,
1857
+ kind: args.kind,
1858
+ capturedAt: normalizeNumber(args.capturedAt),
1859
+ metadata: metadataPatch
1860
+ });
1861
+ const patch = {
1862
+ metadata: nextMetadata2,
1863
+ updatedAt: now
1864
+ };
1865
+ const title2 = normalizeString2(args.title);
1866
+ if (title2) {
1867
+ patch.title = title2;
1868
+ patch.canonicalText = title2;
1869
+ }
1870
+ await ctx.db.patch(existing._id, patch);
1871
+ await ctx.scheduler.runAfter(0, internal.neo4jSync.syncNodeToNeo4j, {
1872
+ nodeId: existing._id,
1873
+ operation: "upsert"
1874
+ });
1875
+ await ctx.db.insert("epistemicAudit", {
1876
+ entityType: "source",
1877
+ entityId: existing._id,
1878
+ changeType: "source_metadata_updated",
1879
+ changedAt: now,
1880
+ changedBy: args.userId,
1881
+ isAgent: false,
1882
+ topicId: existing.topicId ? String(existing.topicId) : void 0,
1883
+ previousState: {
1884
+ title: existing.title,
1885
+ metadata: existingMetadata
1886
+ },
1887
+ newState: {
1888
+ title: title2 ?? existing.title,
1889
+ metadata: nextMetadata2
1890
+ }
1891
+ });
1892
+ return await ctx.db.get(existing._id) ?? existing;
1893
+ }
1894
+ if (!normalizeString2(args.topicId)) {
1895
+ throwStructuredSourceError({
1896
+ message: "topicId is required when creating a new source.",
1897
+ status: 400,
1898
+ code: "INVALID_REQUEST",
1899
+ invariantCode: "source.context_required",
1900
+ suggestion: "Provide topicId when creating a new source node."
1901
+ });
1902
+ }
1903
+ const scope = await resolveTopicProjectScope(ctx, {
1904
+ topicId: args.topicId
1905
+ });
1906
+ assertWorkspaceScopedEpistemicNodeScope({
1907
+ scope,
1908
+ nodeType: "source",
1909
+ mutationName: "epistemicSources.upsertSource"
1910
+ });
1911
+ if (scope.projectId) {
1912
+ await requireProjectAccess(ctx, scope.projectId, args.userId);
1913
+ }
1914
+ const globalId = generateGlobalId();
1915
+ const title = normalizeString2(args.title);
1916
+ const nextMetadata = buildSourceMetadata({
1917
+ normalizedUrl,
1918
+ sha,
1919
+ kind: args.kind,
1920
+ capturedAt: normalizeNumber(args.capturedAt),
1921
+ metadata: metadataPatch
1922
+ });
1923
+ const nodeId = await ctx.db.insert("epistemicNodes", {
1924
+ globalId,
1925
+ topicId: scope.topicId,
1926
+ projectId: scope.projectId,
1927
+ tenantId: scope.tenantId,
1928
+ workspaceId: scope.workspaceId,
1929
+ nodeType: "source",
1930
+ epistemicLayer: "L1",
1931
+ canonicalText: title ?? normalizedUrl ?? "source",
1932
+ contentHash: sha ?? generateSourceContentHash(normalizedUrl ?? title ?? "source"),
1933
+ ...title ? { title } : {},
1934
+ status: "active",
1935
+ createdAt: now,
1936
+ updatedAt: now,
1937
+ createdBy: args.userId,
1938
+ metadata: nextMetadata
1939
+ });
1940
+ await ctx.scheduler.runAfter(0, internal.neo4jSync.syncNodeToNeo4j, {
1941
+ nodeId,
1942
+ operation: "upsert"
1943
+ });
1944
+ await scheduleEmbeddingGeneration({
1945
+ ctx,
1946
+ nodeId,
1947
+ projectId: scope.projectId,
1948
+ topicId: scope.topicId,
1949
+ createdBy: args.userId,
1950
+ nodeType: "source",
1951
+ text: sourceEmbeddingText({
1952
+ title,
1953
+ url: normalizedUrl,
1954
+ kind: args.kind,
1955
+ metadata: nextMetadata
1956
+ })
1957
+ });
1958
+ await ctx.db.insert("epistemicAudit", {
1959
+ entityType: "source",
1960
+ entityId: nodeId,
1961
+ changeType: "source_created",
1962
+ changedAt: now,
1963
+ changedBy: args.userId,
1964
+ isAgent: false,
1965
+ topicId: scope.topicId ? String(scope.topicId) : void 0,
1966
+ previousState: null,
1967
+ newState: {
1968
+ title,
1969
+ url: normalizedUrl,
1970
+ contentSha: sha,
1971
+ kind: args.kind
1972
+ }
1973
+ });
1974
+ return await ctx.db.get(nodeId);
1975
+ }
1976
+ });
1977
+ var getById = query({
1978
+ args: {
1979
+ nodeId: v.optional(v.id("epistemicNodes")),
1980
+ sourceId: v.optional(v.string())
1981
+ },
1982
+ returns: permissiveReturn,
1983
+ handler: async (ctx, args) => {
1984
+ const id = args.nodeId ?? args.sourceId;
1985
+ if (!id) {
1986
+ return null;
1987
+ }
1988
+ const node = await ctx.db.get(
1989
+ id
1990
+ );
1991
+ if (!node || node.nodeType !== "source") {
1992
+ return null;
1993
+ }
1994
+ return node;
1995
+ }
1996
+ });
1997
+ var findByUrl = query({
1998
+ args: {
1999
+ url: v.string()
2000
+ },
2001
+ returns: permissiveReturn,
2002
+ handler: async (ctx, args) => {
2003
+ const normalizedUrl = normalizeSourceUrl(args.url);
2004
+ const node = await findSourceByIdentity(ctx, { normalizedUrl });
2005
+ return node && node.nodeType === "source" ? node : null;
2006
+ }
2007
+ });
2008
+ var findBySha = query({
2009
+ args: {
2010
+ sha: v.string()
2011
+ },
2012
+ returns: permissiveReturn,
2013
+ handler: async (ctx, args) => {
2014
+ const sha = normalizeString2(args.sha);
2015
+ if (!sha) {
2016
+ return null;
2017
+ }
2018
+ const node = await findSourceByIdentity(ctx, { sha });
2019
+ return node && node.nodeType === "source" ? node : null;
2020
+ }
2021
+ });
2022
+
2023
+ export { findBySha, findByUrl, getById, normalizeSourceUrl, upsertSource };
2024
+ //# sourceMappingURL=epistemicSources.js.map
2025
+ //# sourceMappingURL=epistemicSources.js.map