@lucern/graph-primitives 1.0.55 → 1.0.57

package/dist/epistemicEdges.helpers.d.ts

@@ -5,7 +5,7 @@ import '@lucern/access-control/convex';
 import '@lucern/contracts/convex/unsafeAnyApi';
 import './topicScope-CL1IVOmv.js';
 
-declare const epistemicLayerValidator: convex_values.VUnion<"L4" | "L3" | "L2" | "L1" | "ontological" | "organizational", [convex_values.VLiteral<"L4", "required">, convex_values.VLiteral<"L3", "required">, convex_values.VLiteral<"L2", "required">, convex_values.VLiteral<"L1", "required">, convex_values.VLiteral<"ontological", "required">, convex_values.VLiteral<"organizational", "required">], "required", never>;
+declare const epistemicLayerValidator: convex_values.VUnion<"ontological" | "L4" | "L3" | "L2" | "L1" | "organizational", [convex_values.VLiteral<"L4", "required">, convex_values.VLiteral<"L3", "required">, convex_values.VLiteral<"L2", "required">, convex_values.VLiteral<"L1", "required">, convex_values.VLiteral<"ontological", "required">, convex_values.VLiteral<"organizational", "required">], "required", never>;
 declare const subjectiveOpinionValidator: convex_values.VObject<{
     a: number;
     b: number;

package/dist/epistemicEvidence.d.ts

@@ -7,3 +7,4 @@ import 'convex/values';
 import './convex.js';
 import '@lucern/access-control/convex';
 import '@lucern/contracts/convex/unsafeAnyApi';
+import '@lucern/contracts/schema-helpers/evidenceAdmission';

package/dist/epistemicEvidence.js

@@ -1,4 +1,5 @@
 import { canAudienceClassAccess, normalizeAudienceKey, classFromAudienceKey } from '@lucern/access-control/audience';
+import { normalizeEvidenceKind, normalizeEvidenceSourceType } from '@lucern/contracts/schema-helpers/evidenceAdmission';
 import { unsafeConvexAnyApi } from '@lucern/contracts/convex/unsafeAnyApi';
 import { componentsGeneric, mutationGeneric, internalMutationGeneric, queryGeneric, internalQueryGeneric } from 'convex/server';
 import { v } from 'convex/values';
@@ -522,24 +523,10 @@ function generateContentHash(text) {
   return Math.abs(hash).toString(16).padStart(8, "0");
 }
 function normalizeKind(kind) {
-  if (!kind) {
-    return "observation";
-  }
-  const validKinds = [
-    "fact",
-    "observation",
-    "claim",
-    "quote",
-    "statistic",
-    "signal"
-  ];
-  return validKinds.find((k) => kind.toLowerCase() === k) || "observation";
+  return normalizeEvidenceKind(kind, "evidence.kind");
 }
 function normalizeSourceType(sourceType) {
-  if (sourceType === "proprietary" || sourceType === "verified") {
-    return sourceType;
-  }
-  return "ai_generated";
+  return normalizeEvidenceSourceType(sourceType, "evidence.sourceType");
 }
 async function markProjectGraphDirty(ctx, projectId, topicId) {
   const normalizedProjectId = typeof projectId === "string" && projectId.trim().length > 0 ? projectId : void 0;

package/dist/epistemicEvidenceHelpers.d.ts

@@ -1,11 +1,12 @@
 import * as _lucern_access_control_convex_js from '@lucern/access-control/convex.js';
 import { r as resolveTopicProjectScope, T as TopicProjectScope } from './topicScope-CL1IVOmv.js';
 import * as convex_values from 'convex/values';
+import { EvidenceKind, EvidenceSourceType } from '@lucern/contracts/schema-helpers/evidenceAdmission';
+export { EvidenceKind, EvidenceSourceType } from '@lucern/contracts/schema-helpers/evidenceAdmission';
 import { Doc, QueryCtx, MutationCtx } from './convex.js';
 import '@lucern/access-control/convex';
 import '@lucern/contracts/convex/unsafeAnyApi';
 
-type EvidenceKind = "fact" | "observation" | "claim" | "quote" | "statistic" | "signal";
 type AudienceClass = "internal" | "restricted_external" | "public";
 interface EvidenceScopeArgs {
     projectId?: string | null;
@@ -18,7 +19,7 @@ declare const optionalEvidenceScopeArgs: {
 };
 declare function generateContentHash(text: string): string;
 declare function normalizeKind(kind?: string): EvidenceKind;
-declare function normalizeSourceType(sourceType?: string): "proprietary" | "verified" | "ai_generated";
+declare function normalizeSourceType(sourceType?: string): EvidenceSourceType;
 declare function markProjectGraphDirty(ctx: QueryCtx | MutationCtx, projectId: string | undefined | null, topicId?: string | undefined | null): Promise<void>;
 declare function clampEvidenceLimit(limit: number | undefined, fallback?: number): number;
 declare function dedupeEvidenceNodes(nodes: EvidenceNodeDoc[]): EvidenceNodeDoc[];
@@ -84,4 +85,4 @@ declare function formatEvidenceNode(n: {
     updatedAt: number;
 };
 
-export { type AudienceClass, type EvidenceKind, type EvidenceNodeDoc, type EvidenceScopeArgs, clampEvidenceLimit, createEvidenceAudienceResolver, dedupeEvidenceNodes, evidenceMatchesScope, flattenEvidenceNode, formatEvidenceNode, generateContentHash, getEvidenceNodesForScope, markProjectGraphDirty, normalizeKind, normalizeSourceType, optionalEvidenceScopeArgs, resolveEvidenceLinkedWorktreeId, resolveEvidenceScopeOrNull };
+export { type AudienceClass, type EvidenceNodeDoc, type EvidenceScopeArgs, clampEvidenceLimit, createEvidenceAudienceResolver, dedupeEvidenceNodes, evidenceMatchesScope, flattenEvidenceNode, formatEvidenceNode, generateContentHash, getEvidenceNodesForScope, markProjectGraphDirty, normalizeKind, normalizeSourceType, optionalEvidenceScopeArgs, resolveEvidenceLinkedWorktreeId, resolveEvidenceScopeOrNull };

package/dist/epistemicEvidenceHelpers.js

@@ -1,4 +1,5 @@
 import { normalizeAudienceKey, classFromAudienceKey } from '@lucern/access-control/audience';
+import { normalizeEvidenceKind, normalizeEvidenceSourceType } from '@lucern/contracts/schema-helpers/evidenceAdmission';
 import { unsafeConvexAnyApi } from '@lucern/contracts/convex/unsafeAnyApi';
 import { componentsGeneric } from 'convex/server';
 import { v } from 'convex/values';
@@ -511,24 +512,10 @@ function generateContentHash(text) {
   return Math.abs(hash).toString(16).padStart(8, "0");
 }
 function normalizeKind(kind) {
-  if (!kind) {
-    return "observation";
-  }
-  const validKinds = [
-    "fact",
-    "observation",
-    "claim",
-    "quote",
-    "statistic",
-    "signal"
-  ];
-  return validKinds.find((k) => kind.toLowerCase() === k) || "observation";
+  return normalizeEvidenceKind(kind, "evidence.kind");
 }
 function normalizeSourceType(sourceType) {
-  if (sourceType === "proprietary" || sourceType === "verified") {
-    return sourceType;
-  }
-  return "ai_generated";
+  return normalizeEvidenceSourceType(sourceType, "evidence.sourceType");
 }
 async function markProjectGraphDirty(ctx, projectId, topicId) {
   const normalizedProjectId = typeof projectId === "string" && projectId.trim().length > 0 ? projectId : void 0;

package/dist/epistemicEvidenceMutations.js

@@ -5,6 +5,7 @@ import { v } from 'convex/values';
 import { unsafeConvexAnyApi } from '@lucern/contracts/convex/unsafeAnyApi';
 import { componentsGeneric, mutationGeneric, internalMutationGeneric } from 'convex/server';
 import '@lucern/access-control/audience';
+import { normalizeEvidenceKind, normalizeEvidenceSourceType } from '@lucern/contracts/schema-helpers/evidenceAdmission';
 import { generateGlobalId, assertUuidV7Identity, assertUuidV7Reference, assertStorageEdgeVocabulary, assertUuidShapedEdgeEndpoint, isUuidV7 } from '@lucern/contracts/ids';
 import { assertEdgePolicyAllowed } from '@lucern/contracts/manifests/edge-policy-manifest';
 import { edgePolicyManifest } from '@lucern/contracts/manifests/edge-policy-manifest.data';
@@ -542,24 +543,10 @@ function generateContentHash(text) {
   return Math.abs(hash).toString(16).padStart(8, "0");
 }
 function normalizeKind(kind) {
-  if (!kind) {
-    return "observation";
-  }
-  const validKinds = [
-    "fact",
-    "observation",
-    "claim",
-    "quote",
-    "statistic",
-    "signal"
-  ];
-  return validKinds.find((k) => kind.toLowerCase() === k) || "observation";
+  return normalizeEvidenceKind(kind, "evidence.kind");
 }
 function normalizeSourceType(sourceType) {
-  if (sourceType === "proprietary" || sourceType === "verified") {
-    return sourceType;
-  }
-  return "ai_generated";
+  return normalizeEvidenceSourceType(sourceType, "evidence.sourceType");
 }
 async function markProjectGraphDirty(ctx, projectId, topicId) {
   const normalizedProjectId = typeof projectId === "string" && projectId.trim().length > 0 ? projectId : void 0;

package/dist/epistemicEvidenceQueries.js

@@ -5,6 +5,7 @@ import { permissiveReturn } from '@lucern/contracts/schema-helpers/validators';
 import { v } from 'convex/values';
 import { unsafeConvexAnyApi } from '@lucern/contracts/convex/unsafeAnyApi';
 import { componentsGeneric, queryGeneric, internalQueryGeneric } from 'convex/server';
+import '@lucern/contracts/schema-helpers/evidenceAdmission';
 import { isUuidV7 } from '@lucern/contracts/ids';
 import '@lucern/contracts/schema-helpers/spine/tables/epistemicNodes';
 

package/dist/epistemicNodes.validators.d.ts

@@ -7,7 +7,7 @@ import * as convex_values from 'convex/values';
  * L2: Claims, evidence, synthesis - compression boundary
  * L1: Atomic facts, excerpts, sources - terminal leaves
  */
-declare const epistemicLayerValidator: convex_values.VUnion<"L4" | "L3" | "L2" | "L1" | "ontological" | "organizational", [convex_values.VLiteral<"L4", "required">, convex_values.VLiteral<"L3", "required">, convex_values.VLiteral<"L2", "required">, convex_values.VLiteral<"L1", "required">, convex_values.VLiteral<"ontological", "required">, convex_values.VLiteral<"organizational", "required">], "required", never>;
+declare const epistemicLayerValidator: convex_values.VUnion<"ontological" | "L4" | "L3" | "L2" | "L1" | "organizational", [convex_values.VLiteral<"L4", "required">, convex_values.VLiteral<"L3", "required">, convex_values.VLiteral<"L2", "required">, convex_values.VLiteral<"L1", "required">, convex_values.VLiteral<"ontological", "required">, convex_values.VLiteral<"organizational", "required">], "required", never>;
 declare const l4NodeTypeValidator: convex_values.VUnion<"decision", [convex_values.VLiteral<"decision", "required">], "required", never>;
 declare const l3NodeTypeValidator: convex_values.VUnion<"belief" | "question" | "theme" | "deal", [convex_values.VLiteral<"belief", "required">, convex_values.VLiteral<"question", "required">, convex_values.VLiteral<"theme", "required">, convex_values.VLiteral<"deal", "required">], "required", never>;
 declare const l2NodeTypeValidator: convex_values.VUnion<"evidence" | "synthesis" | "claim", [convex_values.VLiteral<"claim", "required">, convex_values.VLiteral<"evidence", "required">, convex_values.VLiteral<"synthesis", "required">], "required", never>;
@@ -17,7 +17,7 @@ declare const ontologicalNodeTypeValidator: convex_values.VUnion<"function" | "c
 declare const organizationalNodeTypeValidator: convex_values.VUnion<"topic", [convex_values.VLiteral<"topic", "required">], "required", never>;
 declare const nodeTypeValidator: convex_values.VUnion<"function" | "belief" | "question" | "evidence" | "answer" | "synthesis" | "theme" | "source" | "decision" | "deal" | "topic" | "claim" | "atomic_fact" | "excerpt" | "company" | "person" | "investor" | "value_chain", [convex_values.VLiteral<"decision", "required">, convex_values.VLiteral<"belief", "required">, convex_values.VLiteral<"question", "required">, convex_values.VLiteral<"theme", "required">, convex_values.VLiteral<"deal", "required">, convex_values.VLiteral<"claim", "required">, convex_values.VLiteral<"evidence", "required">, convex_values.VLiteral<"synthesis", "required">, convex_values.VLiteral<"answer", "required">, convex_values.VLiteral<"atomic_fact", "required">, convex_values.VLiteral<"excerpt", "required">, convex_values.VLiteral<"source", "required">, convex_values.VLiteral<"company", "required">, convex_values.VLiteral<"person", "required">, convex_values.VLiteral<"investor", "required">, convex_values.VLiteral<"function", "required">, convex_values.VLiteral<"value_chain", "required">, convex_values.VLiteral<"topic", "required">], "required", never>;
 declare const sourceTypeValidator: convex_values.VUnion<"system" | "human" | "ai_generated" | "ai_extracted" | "imported", [convex_values.VLiteral<"human", "required">, convex_values.VLiteral<"ai_extracted", "required">, convex_values.VLiteral<"ai_generated", "required">, convex_values.VLiteral<"imported", "required">, convex_values.VLiteral<"system", "required">], "required", never>;
-declare const statusValidator: convex_values.VUnion<"active" | "archived" | "deleted" | "superseded", [convex_values.VLiteral<"active", "required">, convex_values.VLiteral<"superseded", "required">, convex_values.VLiteral<"archived", "required">, convex_values.VLiteral<"deleted", "required">], "required", never>;
+declare const statusValidator: convex_values.VUnion<"deleted" | "active" | "archived" | "superseded", [convex_values.VLiteral<"active", "required">, convex_values.VLiteral<"superseded", "required">, convex_values.VLiteral<"archived", "required">, convex_values.VLiteral<"deleted", "required">], "required", never>;
 declare const verificationStatusValidator: convex_values.VUnion<"ai_verified" | "contradicted" | "human_verified" | "outdated" | "unverified", [convex_values.VLiteral<"unverified", "required">, convex_values.VLiteral<"human_verified", "required">, convex_values.VLiteral<"ai_verified", "required">, convex_values.VLiteral<"contradicted", "required">, convex_values.VLiteral<"outdated", "required">], "required", never>;
 
 export { epistemicLayerValidator, epistemicNodeTypeValidator, l1NodeTypeValidator, l2NodeTypeValidator, l3NodeTypeValidator, l4NodeTypeValidator, nodeTypeValidator, ontologicalNodeTypeValidator, organizationalNodeTypeValidator, sourceTypeValidator, statusValidator, verificationStatusValidator };

package/dist/index.d.ts

@@ -49,6 +49,7 @@ import './epistemicEdges.mutations.js';
 import './epistemicEdges.queries.js';
 import './epistemicEvidenceHelpers.js';
 import '@lucern/access-control/convex.js';
+import '@lucern/contracts/schema-helpers/evidenceAdmission';
 import './epistemicEvidenceMutations.js';
 import './epistemicEvidenceQueries.js';
 import './epistemicNodes.queries.js';

package/dist/index.js

@@ -14,6 +14,7 @@ import { assertEdgePolicyAllowed } from '@lucern/contracts/manifests/edge-policy
 import { edgePolicyManifest } from '@lucern/contracts/manifests/edge-policy-manifest.data';
 import { listAudienceRegistryRows } from '@lucern/access-control/audienceRegistry';
 import { REASONING_METHODS } from '@lucern/contracts/types/reasoning-method';
+import { normalizeEvidenceKind, normalizeEvidenceSourceType } from '@lucern/contracts/schema-helpers/evidenceAdmission';
 import { EVIDENCE_SOURCE_QUALITY_VALUES, EVIDENCE_METHODOLOGY_VALUES, EVIDENCE_INFORMATION_ASYMMETRY_VALUES } from '@lucern/contracts/evidence-taxonomy-target-scope.contract';
 import { scoreEntityTypeMatch, scoreEntityConnection, rankEntityTypeMatches, rankEntityConnections } from '@lucern/contracts/v1/ontologies/v1';
 import { wordTokenize, wordOverlapScore, tokenizeSearchText, tokenOverlapScore, stemToken, scoreLexicalSignals, scoreLexicalSignal, rerankLexicalWindow, rankWindowScore, prepareLexicalQuery, jaccardSimilarity, bigramTokenize } from '@lucern/contracts/text-matching.contract';
@@ -14311,24 +14312,10 @@ function generateContentHash5(text) {
   return Math.abs(hash).toString(16).padStart(8, "0");
 }
 function normalizeKind(kind) {
-  if (!kind) {
-    return "observation";
-  }
-  const validKinds = [
-    "fact",
-    "observation",
-    "claim",
-    "quote",
-    "statistic",
-    "signal"
-  ];
-  return validKinds.find((k) => kind.toLowerCase() === k) || "observation";
+  return normalizeEvidenceKind(kind, "evidence.kind");
 }
 function normalizeSourceType(sourceType) {
-  if (sourceType === "proprietary" || sourceType === "verified") {
-    return sourceType;
-  }
-  return "ai_generated";
+  return normalizeEvidenceSourceType(sourceType, "evidence.sourceType");
 }
 async function markProjectGraphDirty2(ctx, projectId, topicId2) {
   const normalizedProjectId = typeof projectId === "string" && projectId.trim().length > 0 ? projectId : void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucern/graph-primitives",
-  "version": "1.0.55",
+  "version": "1.0.57",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -32,9 +32,9 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@lucern/access-control": "1.0.55",
-    "@lucern/confidence": "1.0.55",
-    "@lucern/contracts": "1.0.55",
+    "@lucern/access-control": "workspace:*",
+    "@lucern/confidence": "workspace:*",
+    "@lucern/contracts": "workspace:*",
     "convex": "^1.39.1"
   },
   "devDependencies": {

package/dist/proof-attestation.json

@@ -1,45 +0,0 @@
-{
-  "proofIrVersion": "proof-ir/v1",
-  "manifestVersions": {
-    "@lucern/confidence": "0.3.0-alpha.0",
-    "@lucern/contracts": "0.3.0-alpha.0",
-    "edge-policy-manifest": "1.0.0"
-  },
-  "invariantsCovered": [
-    "INV-1: beliefs append-only",
-    "INV-14: no silent state transitions",
-    "MANIFEST-1: kernel projections declare epistemicAudit"
-  ],
-  "invariantResults": [
-    {
-      "invariant": "INV-1: beliefs append-only",
-      "status": "passed",
-      "severity": "block_publish",
-      "evidenceRefs": []
-    },
-    {
-      "invariant": "INV-14: no silent state transitions",
-      "status": "passed",
-      "severity": "block_publish",
-      "evidenceRefs": []
-    },
-    {
-      "invariant": "MANIFEST-1: kernel projections declare epistemicAudit",
-      "status": "passed",
-      "severity": "block_publish",
-      "evidenceRefs": []
-    }
-  ],
-  "contractsCovered": [
-    "append_sl_scoring",
-    "create_evidence",
-    "list_beliefs",
-    "list_tasks"
-  ],
-  "emittersUsed": [
-    "typescript-types",
-    "convex-validators",
-    "proof-attestation"
-  ],
-  "signedAt": 1782827051581
-}