@lucern/graph-primitives 0.1.0-alpha.4 → 0.3.0-alpha.0

package/dist/epistemicContracts.js

@@ -1,5 +1,5 @@
 import { v } from 'convex/values';
-import { componentsGeneric, defineTable, internalMutationGeneric, mutationGeneric, anyApi, queryGeneric, internalQueryGeneric } from 'convex/server';
+import { componentsGeneric, internalMutationGeneric, mutationGeneric, anyApi, queryGeneric, internalQueryGeneric } from 'convex/server';
 
 // src/epistemicContracts.ts
 var api = anyApi;
@@ -1577,10 +1577,8 @@ async function queryRegistryRows(ctx, args) {
 async function listAudienceRegistryRows(ctx, args) {
   return queryRegistryRows(ctx, args);
 }
-componentsGeneric();
-var internal2 = anyApi;
 
-// ../schema-management/src/enumValidation.ts
+// ../../packages/contracts/src/schema-helpers/enumValidation.ts
 var BUILTIN_ENUM_FALLBACK = {
   topic_type: /* @__PURE__ */ new Set([
     "domain",
@@ -1623,7 +1621,6 @@ var BUILTIN_ENUM_FALLBACK = {
     "tradeoff",
     "policy",
     "implementation_choice",
-    // Coding intelligence domain
     "implementation_decision",
     "interface_contract",
     "migration_state",
@@ -1631,25 +1628,16 @@ var BUILTIN_ENUM_FALLBACK = {
     "deprecation_notice"
   ]),
   edge_type: /* @__PURE__ */ new Set([
-    // === 6 CANONICAL EPISTEMIC TYPES ===
     "supports",
-    // L3↔L3: belief bears on belief (weight -1 to +1)
     "informs",
-    // L2→L3: evidence bears on belief
     "depends_on",
-    // L3→L3, Q→Q: structural gate
     "derived_from",
-    // Any→Any: provenance chain
     "contains",
-    // Any→Any: hierarchy, scoping, membership
     "tests",
-    // Q→L3: question interrogates belief
-    // === STRUCTURAL / LIFECYCLE ===
     "supersedes",
     "responds_to",
     "belongs_to",
     "relates_to_thesis",
-    // === ONTOLOGICAL (tenant-extensible) ===
     "works_at",
     "invested_in",
     "competes_with",
@@ -1698,27 +1686,12 @@ var BUILTIN_ENUM_FALLBACK = {
 function normalizeEnumValue(value) {
   return value.trim().toLowerCase();
 }
-async function validateSchemaEnumValue(ctx, args) {
+async function validateSchemaEnumValue(_ctx, args) {
   const normalized = normalizeEnumValue(args.value);
   if (!normalized) {
     return { valid: false, source: "none" };
   }
-  try {
-    const validFromSchema = await ctx.runQuery(
-      internal2.schemaConfig.internalValidate,
-      {
-        category: args.category,
-        value: normalized,
-        tenantId: args.tenantId
-      }
-    );
-    if (validFromSchema) {
-      return { valid: true, source: "schema" };
-    }
-  } catch {
-  }
-  const fallback = BUILTIN_ENUM_FALLBACK[args.category];
-  if (fallback.has(normalized)) {
+  if (BUILTIN_ENUM_FALLBACK[args.category].has(normalized)) {
     return { valid: true, source: "builtin" };
   }
   return { valid: false, source: "none" };
@@ -1739,7 +1712,7 @@ async function assertSchemaEnumValue(ctx, args) {
   if (!validation.valid) {
     const tenantHint = args.tenantId ? ` for tenant ${args.tenantId}` : "";
     throw new Error(
-      `[${args.context}] Invalid value "${normalized}" for category "${args.category}"${tenantHint}. Add it to schemaEnumConfig before use.`
+      `[${args.context}] Invalid value "${normalized}" for category "${args.category}"${tenantHint}. Add it to the contracts schema enum manifest before use.`
     );
   }
   return normalized;
@@ -1761,30 +1734,30 @@ var RESOLVED_PREDICTION_OUTCOMES = [
 function isBeliefLifecycleStatus(value) {
   return typeof value === "string" && BELIEF_STATUS_VALUES.includes(value);
 }
-function normalizeBeliefConfidence(confidence2) {
-  if (typeof confidence2 !== "number" || !Number.isFinite(confidence2)) {
+function normalizeBeliefConfidence(confidence) {
+  if (typeof confidence !== "number" || !Number.isFinite(confidence)) {
     return null;
   }
-  if (confidence2 >= 0 && confidence2 <= 1) {
-    return confidence2;
+  if (confidence >= 0 && confidence <= 1) {
+    return confidence;
   }
-  if (confidence2 > 1 && confidence2 <= 100) {
-    return confidence2 / 100;
+  if (confidence > 1 && confidence <= 100) {
+    return confidence / 100;
   }
   return null;
 }
-function isResolvedByConfidence(confidence2) {
-  const normalized = normalizeBeliefConfidence(confidence2);
+function isResolvedByConfidence(confidence) {
+  const normalized = normalizeBeliefConfidence(confidence);
   if (normalized === null) {
     return false;
   }
   return normalized <= 0 || normalized >= 1;
 }
-function hasResolvedPredictionOutcome(predictionMeta2) {
-  if (!predictionMeta2 || typeof predictionMeta2 !== "object") {
+function hasResolvedPredictionOutcome(predictionMeta) {
+  if (!predictionMeta || typeof predictionMeta !== "object") {
     return false;
   }
-  const outcome = predictionMeta2.outcome;
+  const outcome = predictionMeta.outcome;
   return typeof outcome === "string" && RESOLVED_PREDICTION_OUTCOMES.includes(outcome);
 }
 function getPredictionMetaFromMetadata(metadata) {
@@ -2115,567 +2088,31 @@ function getTraversalDirections(direction) {
   }
   return ["outgoing", "incoming"];
 }
-v.number();
-v.union(
-  v.literal("very_high"),
-  // 0.9+
-  v.literal("high"),
-  // 0.7-0.9
-  v.literal("medium"),
-  // 0.4-0.7
-  v.literal("low"),
-  // 0.2-0.4
-  v.literal("very_low")
-  // 0-0.2
-);
-v.union(
-  v.literal(1),
-  // Critical
-  v.literal(2),
-  // High
-  v.literal(3),
-  // Medium
-  v.literal(4),
-  // Low
-  v.literal(5)
-  // Backlog
-);
-v.union(
-  v.literal("critical"),
-  v.literal("high"),
-  v.literal("medium"),
-  v.literal("low"),
-  v.literal("backlog")
-);
-v.union(
-  v.literal("active"),
-  v.literal("paused"),
-  v.literal("completed"),
-  v.literal("archived")
-);
-v.union(
-  v.literal("pending"),
-  v.literal("processing"),
-  v.literal("completed"),
-  v.literal("failed")
-);
-v.object({
-  crunchbaseId: v.optional(v.string()),
-  linkedinUrl: v.optional(v.string()),
-  pitchbookId: v.optional(v.string()),
-  twitterUrl: v.optional(v.string()),
-  domain: v.optional(v.string())
-});
-var sourceType = v.union(
-  v.literal("proprietary"),
-  // Internal Stack research
-  v.literal("primary"),
-  // Direct interviews, calls
-  v.literal("secondary"),
-  // Published sources
-  v.literal("ai_generated"),
-  // AI-synthesized
-  v.literal("user_input"),
-  // Manual user entry
-  v.literal("inferred")
-  // System inference
-);
-v.object({
-  sourceType: v.optional(sourceType),
-  sourceId: v.optional(v.string()),
-  // Reference to source entity
-  sourceUrl: v.optional(v.string()),
-  sourceDate: v.optional(v.number()),
-  sourceName: v.optional(v.string())
-});
-v.object({
-  cursor: v.optional(v.string()),
-  limit: v.optional(v.number())
-});
-v.object({
-  hasMore: v.boolean(),
-  nextCursor: v.optional(v.string()),
-  totalCount: v.optional(v.number())
-});
-var richTextContent = v.object({
-  type: v.literal("doc"),
-  content: looseJsonArray
-});
-v.union(v.string(), richTextContent);
-v.object({
-  promptTokens: v.optional(v.number()),
-  completionTokens: v.optional(v.number()),
-  totalTokens: v.optional(v.number())
-});
-v.object({
-  fileName: v.optional(v.string()),
-  fileSize: v.optional(v.number()),
-  mimeType: v.optional(v.string()),
-  storageId: v.optional(v.id("_storage")),
-  externalUrl: v.optional(v.string())
-});
 
-// ../schema-management/src/spine/tables/epistemicNodes.ts
-var nodeType = v.union(
-  // --- L4: Audit Targets (decisions, outcomes) ---
-  v.literal("decision"),
-  // Investment decision with knowledge horizon snapshot
-  // --- L3: Traversal Anchors (epistemic structure) ---
-  v.literal("belief"),
-  // Structured conviction (immutable formulation)
-  v.literal("question"),
-  // Unit of uncertainty
-  v.literal("theme"),
-  // Investment thesis / conviction cluster
-  v.literal("deal"),
-  // Investment evaluation process
-  v.literal("topic"),
-  // Hierarchical knowledge container
-  // --- L2: Compression Boundary (minimum reasoning unit) ---
-  v.literal("claim"),
-  // Atomic assertion that can be true/false
-  v.literal("evidence"),
-  // Interpreted signal linked to beliefs
-  v.literal("synthesis"),
-  // Primers, deep research
-  v.literal("answer"),
-  // Immutable answer snapshot for a question
-  // --- L1: Terminal Leaves (non-traversable, grounding) ---
-  v.literal("atomic_fact"),
-  // Raw fact from source (not interpreted)
-  v.literal("excerpt"),
-  // Direct quote from source document
-  v.literal("source"),
-  // News, documents, transcripts
-  // --- Ontological Entities (things in the world) ---
-  v.literal("company"),
-  // Organization (subtype: private, corporate, portfolio)
-  v.literal("person"),
-  // Individual (founder, expert, LP, contact)
-  v.literal("investor"),
-  // Investment entity (subtype: vc, lp, cvc, pe, family_office, angel)
-  v.literal("function"),
-  // What a company does (from classifier)
-  v.literal("value_chain")
-  // Market structure / value flow
-);
-var epistemicLayer = v.union(
-  v.literal("L4"),
-  // Decisions, outcomes - audit targets
-  v.literal("L3"),
-  // Beliefs, questions, themes - traversal anchors
-  v.literal("L2"),
-  // Claims, evidence, synthesis - compression boundary
-  v.literal("L1"),
-  // Atomic facts, excerpts, sources - terminal leaves
-  v.literal("ontological"),
-  // Companies, people, etc - not epistemic
-  v.literal("organizational")
-  // Topics, lenses, worktrees — structural containers
-);
-var nodeStatus = v.union(
-  v.literal("active"),
-  v.literal("superseded"),
-  // Replaced by newer version
-  v.literal("archived"),
-  v.literal("deleted")
-);
-var sourceType2 = v.union(
-  v.literal("human"),
-  // User created directly
-  v.literal("ai_extracted"),
-  // LLM extracted from a source
-  v.literal("ai_generated"),
-  // LLM synthesized/created
-  v.literal("imported"),
-  // External system import
-  v.literal("system"),
-  // System-generated (migrations, classifiers)
-  v.literal("verified"),
-  // Human-verified source
-  v.literal("proprietary")
-  // Proprietary/internal data
-);
-var verificationStatus = v.union(
-  v.literal("unverified"),
-  v.literal("human_verified"),
-  v.literal("ai_verified"),
-  v.literal("contradicted"),
-  v.literal("outdated")
-);
-var syncStatus = v.union(
-  v.literal("synced"),
-  // Node and edges fully synced to Neo4j
-  v.literal("pending_edges"),
-  // Node created, edges being created
-  v.literal("edge_creation_failed")
-  // Edge creation failed, needs retry
-);
-var audienceLabel = v.string();
-var sensitivityTier = v.union(
-  v.literal("low"),
-  v.literal("medium"),
-  v.literal("high"),
-  v.literal("restricted")
-);
-var exportClass = v.union(
-  v.literal("internal_only"),
-  v.literal("client_safe"),
-  v.literal("public_safe"),
-  v.literal("restricted")
-);
-var anonymizationClass = v.union(
-  v.literal("none"),
-  v.literal("standard"),
-  v.literal("strict")
-);
-var epistemicStatus = v.union(
-  v.literal("hypothesis"),
-  // Initial conjecture, low evidence
-  v.literal("emerging"),
-  // Building evidence, gaining traction
-  v.literal("established"),
-  // Well-evidenced, core to thesis
-  v.literal("challenged"),
-  // Contradicting evidence appeared
-  v.literal("assumption"),
-  // Taken as given, not actively tested
-  v.literal("deprecated")
-  // Superseded or abandoned
-);
-var beliefStatus = v.union(
-  v.literal("assumption"),
-  v.literal("hypothesis"),
-  v.literal("belief"),
-  v.literal("fact")
-);
-var reversibility = v.union(
-  v.literal("irreversible"),
-  // One-way door decision
-  v.literal("hard_to_reverse"),
-  // Significant cost to undo
-  v.literal("reversible"),
-  // Can change course with moderate effort
-  v.literal("trivial")
-  // Easy to adjust
-);
-var predictionOutcome = v.union(
-  v.literal("pending"),
-  v.literal("confirmed"),
-  v.literal("disconfirmed"),
-  v.literal("partial"),
-  v.literal("expired")
-);
-var predictionMeta = v.object({
-  isPrediction: v.boolean(),
-  registeredAt: v.number(),
-  // When prediction was made
-  expectedBy: v.optional(v.number()),
-  // When we expect resolution
-  outcome: v.optional(predictionOutcome),
-  outcomeRecordedAt: v.optional(v.number()),
-  outcomeEvidenceId: v.optional(v.string()),
-  // globalId of confirming evidence
-  confidenceAtPrediction: v.optional(v.number()),
-  // 0-1
-  actualVsPredicted: v.optional(v.string())
-  // Notes on how outcome compared
-});
-var methodology = v.union(
-  // Primary Research (high value)
-  v.literal("primary_research"),
-  // Direct investigation
-  v.literal("expert_interview"),
-  // Expert call/interview
-  v.literal("customer_interview"),
-  // Customer research
-  v.literal("field_observation"),
-  // On-site observation
-  v.literal("proprietary_data"),
-  // Internal data analysis
-  // Secondary Research
-  v.literal("desk_research"),
-  // Public sources
-  v.literal("regulatory_filing"),
-  // SEC, regulatory docs
-  v.literal("news_article"),
-  // News/press
-  v.literal("academic_paper"),
-  // Academic research
-  // AI-Assisted
-  v.literal("ai_synthesis"),
-  // AI-generated synthesis
-  v.literal("ai_extraction")
-  // AI-extracted from source
-);
-var informationAsymmetry = v.union(
-  v.literal("proprietary"),
-  // Only we have this
-  v.literal("early"),
-  // We're early but others will get it
-  v.literal("common")
-  // Everyone has access
-);
-var temporalNature = v.union(
-  v.literal("factual"),
-  // Resolved outcome. Grounded in reality.
-  v.literal("forecast"),
-  // Prediction. Will resolve. Discounted weight.
-  v.literal("unknown")
-  // Not yet classified.
-);
-var questionType = v.union(
-  v.literal("validation"),
-  // Does evidence support this belief?
-  v.literal("falsification"),
-  // What would prove this belief wrong?
-  v.literal("assumption_probe"),
-  // Is this unstated assumption true?
-  v.literal("prediction_test"),
-  // Will this predicted outcome occur?
-  v.literal("counterfactual"),
-  // What would we expect if X were false?
-  v.literal("discovery"),
-  // What don't we know yet?
-  v.literal("clarification"),
-  // What does X actually mean?
-  v.literal("comparison"),
-  // How does X compare to Y?
-  v.literal("causal"),
-  // What caused X?
-  v.literal("mechanism"),
-  // How does X work?
-  v.literal("general")
-  // Unclassified
-);
-var questionPriority = v.union(
-  v.literal("critical"),
-  // Blocks decision-making
-  v.literal("high"),
-  // Important for thesis
-  v.literal("medium"),
-  // Would be nice to know
-  v.literal("low")
-  // Background/curiosity
-);
-var answerQuality = v.union(
-  v.literal("definitive"),
-  // Clear, well-supported
-  v.literal("strong"),
-  // Good evidence, high confidence
-  v.literal("moderate"),
-  // Some evidence
-  v.literal("weak"),
-  // Limited evidence
-  v.literal("speculative"),
-  // Mostly conjecture
-  v.literal("unanswered")
-  // No answer yet
-);
-var consensusView = v.union(
-  v.literal("aligned"),
-  // We agree with market consensus
-  v.literal("ahead_of"),
-  // We see this before consensus does
-  v.literal("contrarian"),
-  // We actively disagree with consensus
-  v.literal("orthogonal"),
-  // We're looking at something consensus isn't discussing
-  v.literal("unknown")
-  // We don't know what consensus thinks
-);
-var themeConviction = v.union(
-  v.literal("high"),
-  // Strong conviction, actively deploying
-  v.literal("medium"),
-  // Building conviction
-  v.literal("low"),
-  // Exploring, not convicted
-  v.literal("negative")
-  // Actively avoiding
-);
-var decisionType = v.union(
-  v.literal("invest"),
-  v.literal("pass"),
-  v.literal("follow_on"),
-  v.literal("exit"),
-  v.literal("deep_dive"),
-  v.literal("monitor"),
-  v.literal("deprioritize"),
-  v.literal("thesis_adopt"),
-  v.literal("thesis_revise"),
-  v.literal("thesis_abandon")
-);
-var decisionOutcome = v.union(
-  v.literal("pending"),
-  v.literal("successful"),
-  v.literal("unsuccessful"),
-  v.literal("mixed"),
-  v.literal("unknown")
-);
-var externalIds2 = v.object({
-  crunchbase: v.optional(v.string()),
-  linkedin: v.optional(v.string()),
-  pitchbook: v.optional(v.string()),
-  twitter: v.optional(v.string()),
-  website: v.optional(v.string())
-});
-defineTable({
-  // === IDENTITY ===
-  globalId: v.string(),
-  // UUID - survives migration to Neo4j
-  // === TYPE ===
-  nodeType,
-  // === EPISTEMIC LAYER ===
-  epistemicLayer: v.optional(epistemicLayer),
-  // === SUBTYPE (for typed entities) ===
-  subtype: v.optional(v.string()),
-  // company: private|corporate|portfolio, investor: vc|lp|cvc|pe|family_office|angel
-  // === CONTENT ===
-  canonicalText: v.string(),
-  // The core content (belief statement, company name, etc.)
-  contentHash: v.string(),
-  // SHA256(nodeType + canonicalText) for deduplication
-  // Extended content (for sources/syntheses)
-  content: v.optional(v.string()),
-  // Full text for documents/articles
-  contentType: v.optional(v.string()),
-  // "markdown", "html", "pdf", "text"
-  // === METADATA ===
-  title: v.optional(v.string()),
-  // Display title
-  tags: v.optional(v.array(v.string())),
-  domain: v.optional(v.string()),
-  // For companies: website domain
-  // Type-specific metadata (flexible object - LEGACY)
-  // New code should use the typed fields below when available
-  metadata: v.optional(looseJsonObject),
-  // === POLICY / ENTITLEMENT ===
-  tenantId: v.optional(v.string()),
-  workspaceId: v.optional(v.string()),
-  ownerPrincipalId: v.optional(v.string()),
-  audienceLabel: v.optional(audienceLabel),
-  policyTags: v.optional(v.array(v.string())),
-  sensitivityTier: v.optional(sensitivityTier),
-  exportClass: v.optional(exportClass),
-  anonymizationClass: v.optional(anonymizationClass),
-  // === PUBLICATION (visibility-based, not copy-based) ===
-  // Publication expands who can see a workspace-local node — the node stays
-  // in its workspace, like a microservice exposing part of its API surface.
-  // Rules-based: pack/tenant-level publicationRules auto-evaluate on
-  // confidence changes and node creation. No manual click-by-click.
-  publicationStatus: v.optional(
-    v.union(
-      v.literal("unpublished"),
-      // Default: workspace-local only
-      v.literal("published"),
-      // Visible at tenant scope (rules matched)
-      v.literal("suppressed")
-      // Manually blocked even if rules match
-    )
-  ),
-  publishedAt: v.optional(v.number()),
-  // When publication status last changed to published
-  publishedBy: v.optional(v.string()),
-  // userId or "system:publication_rules" for auto-publish
-  // === TYPED METADATA FIELDS ===
-  // --- Belief ---
-  // Belief type — validated against schemaEnumConfig category "belief_type"
-  // Platform core: hypothesis, belief, principle, invariant, assumption,
-  //                tenet, prior, preference, goal, forecast
-  beliefType: v.optional(v.string()),
-  beliefStatus: v.optional(beliefStatus),
-  epistemicStatus: v.optional(epistemicStatus),
-  reversibility: v.optional(reversibility),
-  predictionMeta: v.optional(predictionMeta),
-  // Consensus tracking (for non-consensus detection)
-  consensusView: v.optional(consensusView),
-  consensusConfidence: v.optional(v.number()),
-  // 0-1: What we think consensus confidence is
-  consensusSource: v.optional(v.string()),
-  // Where we got the consensus view (twitter, reports, etc.)
-  // --- Evidence ---
-  methodology: v.optional(methodology),
-  informationAsymmetry: v.optional(informationAsymmetry),
-  temporalNature: v.optional(temporalNature),
-  // --- Question ---
-  questionType: v.optional(questionType),
-  questionPriority: v.optional(questionPriority),
-  answerQuality: v.optional(answerQuality),
-  // --- Theme ---
-  themeConviction: v.optional(themeConviction),
-  // Market timing (for "early on theme" detection)
-  marketAwarenessDate: v.optional(v.number()),
-  // When this theme became broadly discussed
-  marketAwarenessSource: v.optional(v.string()),
-  // How we know (first major report, twitter volume spike, etc.)
-  earlySignalIds: v.optional(v.array(v.string())),
-  // globalIds of evidence we had before market awareness
-  // --- Decision ---
-  decisionType: v.optional(decisionType),
-  decisionOutcome: v.optional(decisionOutcome),
-  // === EXTERNAL IDS (for ontological entities) ===
-  externalIds: v.optional(externalIds2),
-  // === PROVENANCE ===
-  sourceType: sourceType2,
-  aiProvider: v.optional(v.string()),
-  // "claude", "gemini", "gpt-4", etc.
-  extractedFromNodeId: v.optional(v.id("epistemicNodes")),
-  // Quick reference to source
-  // === EXTRACTION CONTEXT ===
-  extractionModel: v.optional(v.string()),
-  // "claude-sonnet-4-20250514"
-  extractionPromptName: v.optional(v.string()),
-  // "lucern/extract-evidence"
-  extractionPromptVersion: v.optional(v.number()),
-  extractionTemperature: v.optional(v.number()),
-  extractionLangfuseTraceId: v.optional(v.string()),
-  // === GROUNDING VERIFICATION ===
-  groundingVerified: v.optional(v.boolean()),
-  groundingConfidence: v.optional(v.number()),
-  // 0-1 match quality
-  groundingMatchedText: v.optional(v.string()),
-  // Actual text from source
-  groundingStartOffset: v.optional(v.number()),
-  groundingEndOffset: v.optional(v.number()),
-  groundingRejectionReason: v.optional(v.string()),
-  // === CONFIDENCE & VERIFICATION ===
-  confidence: v.optional(v.number()),
-  // 0-1 projected probability P(x) = b + a*u
-  verificationStatus: v.optional(verificationStatus),
-  // === SL OPINION (Subjective Logic — Kernel v2) ===
-  // Replaces scalar confidence with rich epistemic state.
-  // b + d + u = 1. P(x) = b + a*u is stored in `confidence` for backward compat.
-  opinion_b: v.optional(v.number()),
-  // Belief: evidence FOR (0-1)
-  opinion_d: v.optional(v.number()),
-  // Disbelief: evidence AGAINST (0-1)
-  opinion_u: v.optional(v.number()),
-  // Uncertainty: absence of evidence (0-1)
-  opinion_a: v.optional(v.number()),
-  // Base rate / prior probability (0-1)
-  tupleContradicted: v.optional(v.boolean()),
-  // Single-belief tuple-space contradiction flag
-  // === LIFECYCLE ===
-  status: nodeStatus,
-  supersededBy: v.optional(v.id("epistemicNodes")),
-  // === OWNERSHIP ===
-  topicId: v.optional(v.string()),
-  // Canonical scope container (topic-first model)
-  projectId: v.optional(v.string()),
-  // DEPRECATED: Use belongs_to edges
-  createdBy: v.string(),
-  // Clerk user ID
-  createdAt: v.number(),
-  updatedAt: v.number(),
-  // === NEO4J SYNC STATUS ===
-  syncStatus: v.optional(syncStatus),
-  syncError: v.optional(v.string())
-  // Error message if sync failed
-}).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", {
-  searchField: "canonicalText",
-  filterFields: ["nodeType", "projectId", "topicId", "status"]
-});
+// ../../packages/contracts/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"
+];
+function isNodeType(value) {
+  return NODE_TYPES.includes(value);
+}
 function getLayerForNodeType(type) {
   switch (type) {
     case "decision":
@@ -2909,7 +2346,7 @@ function throwWorkspaceIsolationError(args) {
   throw error;
 }
 function assertWorkspaceScopedEpistemicNodeScope(args) {
-  const layer = getLayerForNodeType(args.nodeType);
+  const layer = isNodeType(args.nodeType) ? getLayerForNodeType(args.nodeType) : void 0;
   if (layer === "ontological") {
     return;
   }
@@ -2937,11 +2374,11 @@ function nodeMatchesWorkspaceReasoningScope(node, scope) {
   const scopeWorkspaceId = normalizeScopeValue2(scope.workspaceId);
   const nodeTenantId = normalizeScopeValue2(node.tenantId);
   const nodeWorkspaceId = normalizeScopeValue2(node.workspaceId);
-  const epistemicLayer2 = typeof node.epistemicLayer === "string" ? node.epistemicLayer : void 0;
+  const epistemicLayer = typeof node.epistemicLayer === "string" ? node.epistemicLayer : void 0;
   if (scopeTenantId && nodeTenantId && scopeTenantId !== nodeTenantId) {
     return false;
   }
-  if (epistemicLayer2 === "ontological" && nodeWorkspaceId === void 0) {
+  if (epistemicLayer === "ontological" && nodeWorkspaceId === void 0) {
     return true;
   }
   if (!scopeWorkspaceId && node.publicationStatus === "published") {
@@ -2969,11 +2406,11 @@ function edgeMatchesWorkspaceReasoningScope(edge, scope) {
   return scopeWorkspaceId === edgeWorkspaceId;
 }
 async function resolveNodeScopeForWorkspaceIsolation(ctx, node) {
-  const epistemicLayer2 = typeof node?.epistemicLayer === "string" ? node.epistemicLayer : void 0;
+  const epistemicLayer = typeof node?.epistemicLayer === "string" ? node.epistemicLayer : void 0;
   const resolved = {
     tenantId: normalizeScopeValue2(node?.tenantId),
     workspaceId: normalizeScopeValue2(node?.workspaceId),
-    epistemicLayer: epistemicLayer2,
+    epistemicLayer,
     nodeType: typeof node?.nodeType === "string" ? node.nodeType : void 0
   };
   if (!node) {
@@ -3623,10 +3060,10 @@ function deriveSyntheticBackfillOpinion(source) {
       a: 0.5
     });
   }
-  const confidence2 = clamp012(readFiniteNumber(source.confidence) ?? 0);
+  const confidence = clamp012(readFiniteNumber(source.confidence) ?? 0);
   return {
-    b: confidence2,
-    d: 1 - confidence2,
+    b: confidence,
+    d: 1 - confidence,
     u: 0,
     a: 0.5
   };
@@ -3670,10 +3107,10 @@ function formatTupleContradictionDescription(args) {
   return `Tuple-space contradiction detected: b=${args.opinion.b.toFixed(2)} > ${args.policy.beliefThreshold.toFixed(2)} and d=${args.opinion.d.toFixed(2)} > ${args.policy.disbeliefThreshold.toFixed(2)}.`;
 }
 function generateContentHash(text) {
-  const content2 = `belief:${text.trim().toLowerCase().replace(/\s+/g, " ")}`;
+  const content = `belief:${text.trim().toLowerCase().replace(/\s+/g, " ")}`;
   let hash = 5381;
-  for (let i = 0; i < content2.length; i++) {
-    hash = (hash << 5) + hash + content2.charCodeAt(i);
+  for (let i = 0; i < content.length; i++) {
+    hash = (hash << 5) + hash + content.charCodeAt(i);
     hash &= hash;
   }
   return Math.abs(hash).toString(16).padStart(8, "0");
@@ -3750,8 +3187,8 @@ async function resolveBeliefScopeOrNull(ctx, args) {
 }
 async function getBeliefNodesForScope(ctx, scope, args) {
   const baseQuery = ctx.db.query("epistemicNodes").withIndex(
-    scope.topicId ? "by_topic_type" : "by_project_type",
-    (q) => scope.topicId ? q.eq("topicId", scope.topicId).eq("nodeType", "belief") : q.eq("projectId", scope.projectId).eq("nodeType", "belief")
+    "by_topic_type",
+    (q) => q.eq("topicId", scope.topicId).eq("nodeType", "belief")
   );
   const nodes = typeof args?.scanLimit === "number" ? await baseQuery.order("desc").take(args.scanLimit) : await baseQuery.collect();
   const scopedNodes = nodes.filter(
@@ -3902,7 +3339,7 @@ async function applyBeliefConfidenceChange(ctx, args) {
     }
   }
   const previousConfidence = node.confidence || 0.5;
-  const predictionMeta2 = node.predictionMeta || existingMetadata.predictionMeta;
+  const predictionMeta = node.predictionMeta || existingMetadata.predictionMeta;
   const previousOpinion = readBeliefOpinionSnapshot(node, existingMetadata);
   const slB = args.belief;
   const slD = args.disbelief;
@@ -3929,7 +3366,7 @@ async function applyBeliefConfidenceChange(ctx, args) {
     currentBeliefStatus,
     {
       confidence: derivedConfidence,
-      predictionMeta: predictionMeta2,
+      predictionMeta,
       metadata: existingMetadata
     }
   );
@@ -4583,8 +4020,8 @@ query({
       }
     }
     const query2 = ctx.db.query("epistemicNodes").withIndex(
-      scope.topicId ? "by_topic_type" : "by_project_type",
-      (q) => scope.topicId ? q.eq("topicId", scope.topicId).eq("nodeType", "belief") : q.eq("projectId", scope.projectId).eq("nodeType", "belief")
+      "by_topic_type",
+      (q) => q.eq("topicId", scope.topicId).eq("nodeType", "belief")
     );
     const nodes = await query2.order("desc").take(scanLimit);
     const scopedNodes = nodes.filter(
@@ -5222,9 +4659,13 @@ query({
   },
   returns: permissiveReturn,
   handler: async (ctx, args) => {
+    const scope = await resolveBeliefScopeOrNull(ctx, args);
+    if (!scope) {
+      return { active: 0, superseded: 0, archived: 0, total: 0 };
+    }
     const nodes = await ctx.db.query("epistemicNodes").withIndex(
-      args.topicId ? "by_topic_type" : "by_project_type",
-      (q) => args.topicId ? q.eq("topicId", args.topicId).eq("nodeType", "belief") : q.eq("projectId", args.projectId).eq("nodeType", "belief")
+      "by_topic_type",
+      (q) => q.eq("topicId", scope.topicId).eq("nodeType", "belief")
     ).collect();
     const counts = {
       active: 0,
@@ -5789,8 +5230,8 @@ query({
       return [];
     }
     const nodes = await ctx.db.query("epistemicNodes").withIndex(
-      scope.topicId ? "by_topic_type" : "by_project_type",
-      (q) => scope.topicId ? q.eq("topicId", scope.topicId).eq("nodeType", "belief") : q.eq("projectId", scope.projectId).eq("nodeType", "belief")
+      "by_topic_type",
+      (q) => q.eq("topicId", scope.topicId).eq("nodeType", "belief")
     ).collect();
     return nodes.filter((n) => {
       const metadata = n.metadata;