@lucern/contracts 1.0.38 → 1.0.40

package/dist/proof-attestation.json

@@ -41,5 +41,5 @@
     "convex-validators",
     "proof-attestation"
   ],
-  "signedAt": 1782410971176
+  "signedAt": 1782431036075
 }

package/dist/types/evidence-taxonomy-target-scope.js

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+
+// src/types/evidence-taxonomy-target-scope.ts
+var EVIDENCE_RELATION_VALUES = ["supports", "contradicts"];
+var EVIDENCE_METHODOLOGY_VALUES = [
+  "primary_research",
+  "expert_interview",
+  "customer_interview",
+  "field_observation",
+  "proprietary_data",
+  "desk_research",
+  "regulatory_filing",
+  "news_article",
+  "academic_paper",
+  "ai_synthesis",
+  "ai_extraction"
+];
+var EVIDENCE_INFORMATION_ASYMMETRY_VALUES = [
+  "proprietary",
+  "early",
+  "common"
+];
+var EVIDENCE_SOURCE_QUALITY_VALUES = [
+  "primary",
+  "analyzed",
+  "secondary",
+  "tertiary",
+  "unknown"
+];
+var EVIDENCE_SOURCE_TYPE_VALUES = [
+  "human",
+  "ai_extracted",
+  "ai_generated",
+  "imported",
+  "system",
+  "verified",
+  "proprietary"
+];
+var EVIDENCE_SCORING_DIMENSIONS = [
+  "signedImpact",
+  "evidenceRelation",
+  "sourceQuality",
+  "methodology",
+  "informationAsymmetry",
+  "sourceRef",
+  "targetBeliefId",
+  "verificationStatus"
+];
+var EVIDENCE_TAXONOMY_REFUSAL_IDS = [
+  "orphan_evidence_create_refused",
+  "non_belief_create_target_refused",
+  "zero_signed_impact_refused",
+  "relation_signed_impact_mismatch_refused",
+  "unscoped_list_evidence_refused",
+  "metadata_scoring_plan_refused"
+];
+var EvidenceRelationSchema = z.enum(EVIDENCE_RELATION_VALUES);
+var EvidenceMethodologySchema = z.enum(EVIDENCE_METHODOLOGY_VALUES);
+var EvidenceInformationAsymmetrySchema = z.enum(
+  EVIDENCE_INFORMATION_ASYMMETRY_VALUES
+);
+var EvidenceSourceQualitySchema = z.enum(
+  EVIDENCE_SOURCE_QUALITY_VALUES
+);
+var EvidenceSourceTypeSchema = z.enum(EVIDENCE_SOURCE_TYPE_VALUES);
+var EvidenceScoringDimensionSchema = z.enum(
+  EVIDENCE_SCORING_DIMENSIONS
+);
+
+export { EVIDENCE_INFORMATION_ASYMMETRY_VALUES, EVIDENCE_METHODOLOGY_VALUES, EVIDENCE_RELATION_VALUES, EVIDENCE_SCORING_DIMENSIONS, EVIDENCE_SOURCE_QUALITY_VALUES, EVIDENCE_SOURCE_TYPE_VALUES, EVIDENCE_TAXONOMY_REFUSAL_IDS, EvidenceInformationAsymmetrySchema, EvidenceMethodologySchema, EvidenceRelationSchema, EvidenceScoringDimensionSchema, EvidenceSourceQualitySchema, EvidenceSourceTypeSchema };

package/dist/types/graph-ref.js

@@ -0,0 +1,173 @@
+import { z } from 'zod';
+
+// src/types/graph-ref.ts
+z.enum([
+  "decision",
+  "belief",
+  "question",
+  "theme",
+  "deal",
+  "topic",
+  "claim",
+  "evidence",
+  "synthesis",
+  "answer",
+  "atomic_fact",
+  "excerpt",
+  "source",
+  "company",
+  "person",
+  "investor",
+  "function",
+  "value_chain"
+]);
+var EDGE_TYPE_VALUES = [
+  "supports",
+  "informs",
+  "depends_on",
+  "derived_from",
+  "contains",
+  "tests",
+  "supersedes",
+  "responds_to",
+  "belongs_to",
+  "relates_to_thesis",
+  "works_at",
+  "invested_in",
+  "competes_with",
+  "participates_in",
+  "founded_by",
+  "evaluates",
+  "performs",
+  "function_in",
+  "impacts",
+  "raised_from",
+  "mentioned_in",
+  "perspective_on",
+  "plays_theme",
+  "answers",
+  "explores",
+  "qualifies",
+  "based_on",
+  "based_on_belief",
+  "based_on_question",
+  "blocked_by_contradiction",
+  "informed_by_theme",
+  "same_as",
+  "reinforces",
+  "parent_of",
+  "child_of",
+  "falsified_by",
+  "exclusive_with",
+  "collapses_if",
+  "cascade_from",
+  "counterfactual_of",
+  "cascade_to",
+  "mutually_exclusive",
+  "correlates_with",
+  "amplifies",
+  "precondition_for",
+  "in_tension_with",
+  "strengthened_by",
+  "weakened_by",
+  "alternative_to",
+  "subsumes",
+  "validated_by",
+  "required_for",
+  "blocks",
+  "prerequisite_for",
+  "parallel_to",
+  "corroborates",
+  "extends",
+  "same_source_as",
+  "same_theme_as",
+  "assumes",
+  "would_predict",
+  "analogous_to",
+  "independent_of",
+  "implements",
+  "violates",
+  "co_changes_with",
+  "migrating_from",
+  "migrating_to",
+  "scoped_by",
+  "about_entity",
+  "entity_referenced_in",
+  "contradicts",
+  "cites",
+  "summarizes",
+  "related_to",
+  "partially_answers",
+  "refines",
+  "branches_from"
+];
+var STORAGE_EDGE_TYPE_VALUES = [
+  ...EDGE_TYPE_VALUES,
+  "extracted_from"
+];
+z.enum(EDGE_TYPE_VALUES);
+z.enum(STORAGE_EDGE_TYPE_VALUES);
+z.enum(["active", "archived", "watching"]);
+z.enum([
+  "private",
+  "team",
+  "firm",
+  "external",
+  "public"
+]);
+
+// src/ids/edge-storage-vocabulary.ts
+new Set(
+  STORAGE_EDGE_TYPE_VALUES
+);
+
+// src/ids/index.ts
+var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function isUuidV7(value) {
+  return UUID_PATTERN.test(value) && value[14]?.toLowerCase() === "7";
+}
+
+// src/schema-helpers/spine/tables/epistemicNodes.ts
+var NODE_TYPES = [
+  "decision",
+  "belief",
+  "question",
+  "theme",
+  "deal",
+  "topic",
+  "claim",
+  "evidence",
+  "synthesis",
+  "answer",
+  "atomic_fact",
+  "excerpt",
+  "source",
+  "company",
+  "person",
+  "investor",
+  "function",
+  "value_chain"
+];
+new Set(NODE_TYPES);
+
+// src/types/graph-ref.ts
+var GRAPH_REF_EXTRA_NODE_TYPES = [
+  "edge",
+  "ontology",
+  "lens",
+  "contradiction"
+];
+var GRAPH_REF_NODE_TYPES = [
+  ...NODE_TYPES,
+  ...GRAPH_REF_EXTRA_NODE_TYPES
+];
+var EpistemicNodeTypeSchema = z.enum(
+  GRAPH_REF_NODE_TYPES
+);
+var GraphRefSchema = z.object({
+  kind: z.literal("epistemic_node"),
+  nodeId: z.string().refine(isUuidV7, "must be UUIDv7"),
+  nodeType: EpistemicNodeTypeSchema
+});
+
+export { EpistemicNodeTypeSchema, GRAPH_REF_NODE_TYPES, GraphRefSchema };

package/dist/types/reasoning-method.js

@@ -0,0 +1,15 @@
+// src/types/reasoning-method.ts
+var REASONING_METHODS = [
+  "deductive",
+  "inductive",
+  "abductive",
+  "analogical",
+  "causal",
+  "correlational",
+  "testimonial",
+  "statistical",
+  "implicit",
+  "pattern_match"
+];
+
+export { REASONING_METHODS };

package/dist/types/traversal-mode-constitution.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+
+// src/types/traversal-mode-constitution.ts
+var TRAVERSAL_MODE_VALUES = [
+  "anchored_ranked",
+  "bounded_exploration",
+  "contradiction_scan",
+  "pattern_recall",
+  "forensic_replay"
+];
+var TRAVERSAL_DEPTH_VALUES = [
+  "low",
+  "medium",
+  "high",
+  "extra-high"
+];
+var LEGACY_EDGE_TRAVERSAL_MODE_VALUES = [
+  "anchor_down",
+  "anchor_up",
+  "same_layer",
+  "decision_trace"
+];
+var TRAVERSAL_MODE_CONSTITUTION_REFUSAL_IDS = [
+  "missing_traversal_mode_refused",
+  "missing_traversal_depth_refused",
+  "invalid_traversal_mode_refused",
+  "invalid_traversal_depth_refused",
+  "legacy_depth_as_mode_refused",
+  "depth_exceeds_mode_ceiling_refused",
+  "mode_without_required_anchor_refused",
+  "bounded_exploration_scope_missing_refused",
+  "pattern_recall_evidence_write_refused",
+  "forensic_replay_horizon_missing_refused"
+];
+var ConstitutionalTraversalModeSchema = z.enum(TRAVERSAL_MODE_VALUES);
+var TraversalDepthSchema = z.enum(TRAVERSAL_DEPTH_VALUES);
+var LegacyEdgeTraversalModeSchema = z.enum(
+  LEGACY_EDGE_TRAVERSAL_MODE_VALUES
+);
+function normalizeTraversalDepth(value) {
+  const parsed = TraversalDepthSchema.safeParse(value);
+  return parsed.success ? parsed.data : void 0;
+}
+function canonicalizeTraversalMode(value) {
+  const parsed = ConstitutionalTraversalModeSchema.safeParse(value);
+  if (parsed.success) {
+    return parsed.data;
+  }
+  switch (value) {
+    case "anchor_down":
+    case "anchor_up":
+      return "anchored_ranked";
+    case "same_layer":
+      return "bounded_exploration";
+    case "decision_trace":
+      return "forensic_replay";
+    default:
+      return;
+  }
+}
+function toLegacyEdgeTraversalMode(value) {
+  const legacy = LegacyEdgeTraversalModeSchema.safeParse(value);
+  if (legacy.success) {
+    return legacy.data;
+  }
+  switch (canonicalizeTraversalMode(value)) {
+    case "anchored_ranked":
+      return "anchor_down";
+    case "bounded_exploration":
+      return "same_layer";
+    case "contradiction_scan":
+      return "same_layer";
+    case "pattern_recall":
+      return "same_layer";
+    case "forensic_replay":
+      return "decision_trace";
+    default:
+      return;
+  }
+}
+function maxDepthForTraversalDepth(value) {
+  switch (normalizeTraversalDepth(value)) {
+    case "low":
+      return 1;
+    case "medium":
+      return 2;
+    case "high":
+      return 4;
+    case "extra-high":
+      return 8;
+    default:
+      return;
+  }
+}
+
+export { ConstitutionalTraversalModeSchema, LEGACY_EDGE_TRAVERSAL_MODE_VALUES, LegacyEdgeTraversalModeSchema, TRAVERSAL_DEPTH_VALUES, TRAVERSAL_MODE_CONSTITUTION_REFUSAL_IDS, TRAVERSAL_MODE_VALUES, TraversalDepthSchema, canonicalizeTraversalMode, maxDepthForTraversalDepth, normalizeTraversalDepth, toLegacyEdgeTraversalMode };

package/package.json

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