@lucern/graph-primitives 1.0.0 → 1.0.1

package/dist/epistemicEvidence-xw6UUrwh.d.ts

@@ -1,128 +0,0 @@
-import { Doc } from './convex.js';
-
-/**
- * Epistemic Evidence API
- *
- * Clean API for managing evidence/insights in the epistemic spine (epistemicNodes).
- * This is the NEW API that replaces insights.ts for CREATE operations.
- *
- * Key differences from insights.ts:
- * - Writes ONLY to epistemicNodes (no dual-write)
- * - Uses epistemicNodes IDs directly (no legacyInsightId lookups)
- * - Syncs to Neo4j after mutations
- * - Follows Lucern invariants strictly
- *
- * Terminology:
- * - "Evidence" in the epistemic graph = "Insight" in the legacy schema
- * - Evidence is at L2 (Compression Boundary) in the Lucern architecture
- *
- * @see /docs/epistemic-invariants/00-epistemic-invariants.md
- */
-
-type EvidenceNodeDoc = Doc<"epistemicNodes">;
-declare function resolveEvidenceLinkedWorktreeId(metadata: Record<string, unknown> | undefined): string | undefined;
-declare function flattenEvidenceNode(n: EvidenceNodeDoc): any;
-/**
- * Create new evidence in the epistemic spine.
- * Returns the epistemicNodes ID directly (not an insights ID).
- */
-declare const create: any;
-/**
- * Create evidence and link to a belief in one operation
- */
-declare const createAndLink: any;
-/**
- * Update evidence status
- */
-declare const updateStatus: any;
-/**
- * Get evidence by ID
- */
-declare const getById: any;
-/**
- * Get all evidence for a project
- */
-declare const getByProject: any;
-/**
- * Get all evidence for a topic.
- */
-declare const getByTopic: any;
-/**
- * Get evidence linked to a specific belief
- */
-declare const getForBelief: any;
-/**
- * Internal query to get evidence for a project
- */
-declare const internalGetByProject: any;
-/**
- * Internal query to get evidence for a topic
- */
-declare const internalGetByTopic: any;
-/**
- * Internal mutation to create evidence (for other Convex modules)
- */
-declare const internalCreate: any;
-/**
- * Update verification status on an evidence node.
- * Used by verificationActions after deep verification completes.
- */
-declare const updateVerificationStatus: any;
-/**
- * Get evidence for project - SYSTEM query (no access check)
- */
-declare const getByProjectSystem: any;
-/**
- * Get evidence balance for a project (supporting vs challenging evidence).
- * Used by the EvidenceBalance visualization component.
- *
- * Calculates by examining edges from evidence nodes to belief nodes,
- * where positive weight = supporting and negative weight = challenging.
- */
-declare const getEvidenceBalance: any;
-/**
- * Update an evidence node's text, kind, tags, or verification fields.
- * Accepts either a native epistemicNodes ID via `nodeId` or a string `insightId`
- * for backward compatibility (callers still pass Id<"epistemicNodes"> shaped strings).
- *
- * Ported from insights.ts → update mutation.
- */
-declare const update: any;
-/**
- * Flag an evidence node as incorrect (human contradiction).
- * Sets verificationStatus to "contradicted" and records the reason in metadata.
- *
- * Ported from insights.ts → flagAsIncorrect mutation.
- */
-declare const flagAsIncorrect: any;
-/**
- * Archive (soft-delete) an evidence node.
- * Sets status to "archived" — never actually deletes from epistemicNodes.
- *
- * Ported from insights.ts → remove mutation.
- */
-declare const remove: any;
-
-declare const epistemicEvidence_create: typeof create;
-declare const epistemicEvidence_createAndLink: typeof createAndLink;
-declare const epistemicEvidence_flagAsIncorrect: typeof flagAsIncorrect;
-declare const epistemicEvidence_flattenEvidenceNode: typeof flattenEvidenceNode;
-declare const epistemicEvidence_getById: typeof getById;
-declare const epistemicEvidence_getByProject: typeof getByProject;
-declare const epistemicEvidence_getByProjectSystem: typeof getByProjectSystem;
-declare const epistemicEvidence_getByTopic: typeof getByTopic;
-declare const epistemicEvidence_getEvidenceBalance: typeof getEvidenceBalance;
-declare const epistemicEvidence_getForBelief: typeof getForBelief;
-declare const epistemicEvidence_internalCreate: typeof internalCreate;
-declare const epistemicEvidence_internalGetByProject: typeof internalGetByProject;
-declare const epistemicEvidence_internalGetByTopic: typeof internalGetByTopic;
-declare const epistemicEvidence_remove: typeof remove;
-declare const epistemicEvidence_resolveEvidenceLinkedWorktreeId: typeof resolveEvidenceLinkedWorktreeId;
-declare const epistemicEvidence_update: typeof update;
-declare const epistemicEvidence_updateStatus: typeof updateStatus;
-declare const epistemicEvidence_updateVerificationStatus: typeof updateVerificationStatus;
-declare namespace epistemicEvidence {
-  export { epistemicEvidence_create as create, epistemicEvidence_createAndLink as createAndLink, epistemicEvidence_flagAsIncorrect as flagAsIncorrect, epistemicEvidence_flattenEvidenceNode as flattenEvidenceNode, epistemicEvidence_getById as getById, epistemicEvidence_getByProject as getByProject, epistemicEvidence_getByProjectSystem as getByProjectSystem, epistemicEvidence_getByTopic as getByTopic, epistemicEvidence_getEvidenceBalance as getEvidenceBalance, epistemicEvidence_getForBelief as getForBelief, epistemicEvidence_internalCreate as internalCreate, epistemicEvidence_internalGetByProject as internalGetByProject, epistemicEvidence_internalGetByTopic as internalGetByTopic, epistemicEvidence_remove as remove, epistemicEvidence_resolveEvidenceLinkedWorktreeId as resolveEvidenceLinkedWorktreeId, epistemicEvidence_update as update, epistemicEvidence_updateStatus as updateStatus, epistemicEvidence_updateVerificationStatus as updateVerificationStatus };
-}
-
-export { createAndLink as a, flattenEvidenceNode as b, create as c, getByProject as d, epistemicEvidence as e, flagAsIncorrect as f, getById as g, getByProjectSystem as h, getByTopic as i, getEvidenceBalance as j, getForBelief as k, internalCreate as l, internalGetByProject as m, internalGetByTopic as n, resolveEvidenceLinkedWorktreeId as o, updateStatus as p, updateVerificationStatus as q, remove as r, update as u };

package/dist/epistemicHelpers-DevrYgPN.d.ts

@@ -1,329 +0,0 @@
-import { Id, MutationCtx } from './convex.js';
-import { a as getNeo4jLabel, b as getNeo4jRelType, i as isDeprecatedEdgeType } from './graphTypes-CpgIuCdo.js';
-
-/**
- * Epistemic Spine - Dual-Write Helpers
- *
- * These functions handle writing to both legacy tables AND the epistemic spine.
- * They're called from existing mutations to ensure every new entity gets a spine entry.
- *
- * The spine is the canonical identity layer - these helpers ensure consistency.
- *
- * @see /docs/architecture/EPISTEMIC_SPINE.md
- * @see /docs/architecture/UNIFIED_GRAPH_ARCHITECTURE.md
- */
-
-/**
- * Epistemic Layer - governs traversal rules
- * L4 → L3 → L2 → L1 (never skip layers)
- */
-type EpistemicLayer = "L4" | "L3" | "L2" | "L1" | "ontological" | "organizational";
-/**
- * Map nodeType to its epistemic layer
- *
- * Layer semantics:
- * - L4: Audit targets (decisions, outcomes) - what we committed to
- * - L3: Traversal anchors (beliefs, questions, themes) - epistemic structure
- * - L2: Compression boundary (claims, evidence, synthesis) - minimum reasoning unit
- * - L1: Terminal leaves (atomic_fact, excerpt, source) - non-traversable grounding
- * - ontological: Entities in the world (companies, people) - not epistemic
- * - organizational: Structural containers (topics, lenses, worktrees) - not epistemic
- */
-declare function getNodeLayer(nodeType: string): EpistemicLayer;
-/**
- * Layer traversal rules
- * Key constraint: Cannot skip layers during traversal
- */
-declare const LAYER_TRAVERSAL_RULES: {
-    readonly L4: {
-        readonly canReach: readonly ["L3", "L4"];
-        readonly mustPassThrough: "L3";
-    };
-    readonly L3: {
-        readonly canReach: readonly ["L2", "L3", "L4"];
-        readonly mustPassThrough: "L2";
-    };
-    readonly L2: {
-        readonly canReach: readonly ["L1", "L2", "L3"];
-        readonly mustPassThrough: null;
-    };
-    readonly L1: {
-        readonly canReach: readonly ["L1"];
-        readonly mustPassThrough: null;
-    };
-    readonly ontological: {
-        readonly canReach: readonly ["L3", "L2", "ontological"];
-        readonly mustPassThrough: null;
-    };
-    readonly organizational: {
-        readonly canReach: readonly ["L3", "L2", "organizational"];
-        readonly mustPassThrough: null;
-    };
-};
-/**
- * Check if a direct edge between two layers is allowed
- */
-declare function isValidLayerConnection(fromLayer: EpistemicLayer, toLayer: EpistemicLayer): boolean;
-/**
- * Get layer hierarchy number (for comparison)
- * Higher number = higher layer
- */
-declare function getLayerDepth(layer: EpistemicLayer): number;
-/**
- * Check if we can traverse from one layer to another
- * (considering intermediate layers)
- */
-declare function canTraverseToLayer(fromLayer: EpistemicLayer, toLayer: EpistemicLayer): boolean;
-/**
- * Traversal mode - determines how to traverse the graph
- *
- * anchor_down: Start at L3 belief, traverse to L2 evidence, stop at L1 sources
- * anchor_up: Start at L2 evidence, traverse to L3 beliefs it supports
- * same_layer: Traverse within a single layer (e.g., belief → belief)
- * decision_trace: Start at L4 decision, traverse to L3 beliefs it was based on
- */
-type TraversalMode = "anchor_down" | "anchor_up" | "same_layer" | "decision_trace";
-/**
- * Traversal options for layer-aware queries
- */
-type TraversalOptions = {
-    /** Starting node ID */
-    startNodeId: Id<"epistemicNodes">;
-    /** Traversal mode */
-    mode: TraversalMode;
-    /** Edge types to follow (empty = all valid for mode) */
-    allowedEdgeTypes?: string[];
-    /** Maximum depth */
-    maxDepth?: number;
-    /** Minimum layer to stop at (L1 = 1, L4 = 4) */
-    minLayer?: number;
-    /** Maximum layer to reach */
-    maxLayer?: number;
-};
-/**
- * Check if traversal should continue based on layer constraints
- */
-declare function shouldContinueTraversal(currentLayer: EpistemicLayer, targetLayer: EpistemicLayer, options: {
-    mode: TraversalMode;
-    minLayer?: number;
-    maxLayer?: number;
-}): boolean;
-/**
- * Get default minLayer for a traversal mode
- */
-declare function getDefaultMinLayer(mode: TraversalMode): number;
-/**
- * Get allowed edge types for a traversal mode
- */
-declare function getDefaultEdgeTypesForMode(mode: TraversalMode): string[];
-/**
- * Edge Layer Rules - defines valid layer combinations for each edge type
- *
- * Format: { from: [allowed source layers], to: [allowed target layers] }
- *
- * Key rules:
- * - L4 edges: Decision → L3 (beliefs, questions, themes)
- * - Cross-layer edges: L2 → L3 (evidence informs beliefs)
- * - Same-layer edges: L3 → L3, L2 → L2 (beliefs depend on beliefs)
- * - Downward edges: L2 → L1 (evidence extracted from source)
- * - Lifecycle edges: same layer only (supersedes)
- */
-declare const EDGE_LAYER_RULES: Record<string, {
-    from: EpistemicLayer[];
-    to: EpistemicLayer[];
-    description: string;
-}>;
-/**
- * Validate an edge against layer rules
- *
- * Returns { valid: true } or { valid: false, reason: string }
- */
-declare function validateEdgeLayers(edgeType: string, fromLayer: EpistemicLayer, toLayer: EpistemicLayer): {
-    valid: boolean;
-    reason?: string;
-};
-/**
- * Create an epistemic node for an insight (evidence)
- * Called after inserting into the insights table
- */
-declare function createEpistemicNodeForInsight(ctx: MutationCtx, _insightId: Id<"epistemicNodes">, insight: {
-    projectId: string;
-    text: string;
-    kind: string;
-    tags?: string[];
-    sourceType?: string;
-    aiProvider?: string;
-    verificationStatus?: string;
-    sourceArtifactId?: Id<"finalArtifacts">;
-    sourceQuestionId?: Id<"epistemicNodes">;
-    sourceAnchor?: {
-        artifactId: string;
-        artifactType: string;
-        artifactTitle?: string;
-        sectionHeading?: string;
-        selectedText?: string;
-        startOffset?: number;
-        endOffset?: number;
-        pageNumber?: number;
-    };
-    createdBy: string;
-}): Promise<Id<"epistemicNodes">>;
-/**
- * Create an epistemic node for a belief
- * Called after inserting into the beliefs table
- */
-declare function createEpistemicNodeForBelief(ctx: MutationCtx, beliefId: Id<"epistemicNodes">, belief: {
-    projectId: string;
-    belief: string;
-    rationale?: string;
-    confidence: string;
-    topic?: string;
-    sourceAnchor?: {
-        artifactId: string;
-        artifactType: string;
-        artifactTitle?: string;
-        sectionHeading?: string;
-        selectedText?: string;
-        startOffset?: number;
-        endOffset?: number;
-    };
-    createdBy: string;
-}): Promise<Id<"epistemicNodes">>;
-/**
- * Create an epistemic node for a question
- * Called after inserting into the questions table
- */
-declare function createEpistemicNodeForQuestion(ctx: MutationCtx, _questionId: Id<"epistemicNodes">, question: {
-    projectId: string;
-    question: string;
-    category?: string;
-    priority: string;
-    source: string;
-    sourceAnchor?: {
-        artifactId: string;
-        artifactType: string;
-        artifactTitle?: string;
-        sectionHeading?: string;
-        selectedText?: string;
-        startOffset?: number;
-        endOffset?: number;
-    };
-    createdBy: string;
-}): Promise<Id<"epistemicNodes">>;
-/**
- * Create an epistemic node for a synthesis artifact (primer or deep research).
- *
- * ⚠️ IMPORTANT: This function should NOT be called for primers/deep research
- * unless the node is being connected to evidence as a source.
- * Standalone synthesis nodes create orphans in the graph.
- *
- * The correct pattern is:
- * 1. Store the artifact in finalArtifacts (for UI display)
- * 2. Only create epistemic node when extracting evidence FROM the artifact
- * 3. Create edge: evidence -> derived_from -> synthesis
- *
- * @deprecated Consider removing automatic node creation for primers.
- * Use the artifact ID reference in evidence metadata instead.
- */
-declare function createEpistemicNodeForArtifact(ctx: MutationCtx, artifactId: Id<"finalArtifacts">, artifact: {
-    projectId?: string;
-    title: string;
-    content: string;
-    type: string;
-    isDeepResearch?: boolean;
-    aiProvider?: string;
-    createdBy: string;
-}): Promise<Id<"epistemicNodes">>;
-/**
- * Edge type union for createEpistemicEdge
- * Phase 2C: Updated to include L4 edges and modern edge types
- * Phase 3: Added full epistemic impact edges for confidence propagation
- */
-type EpistemicEdgeType = "derived_from" | "supports" | "contains" | "depends_on" | "informs" | "tests" | "responds_to" | "relates_to_thesis" | "belongs_to" | "plays_theme" | "supersedes" | "counterfactual_of" | "cascade_to" | "mutually_exclusive" | "correlates_with" | "amplifies" | "precondition_for" | "in_tension_with" | "assumes" | "would_predict" | "analogous_to" | "independent_of" | "prerequisite_for" | "parallel_to" | "corroborates" | "extends" | "same_source_as" | "same_theme_as" | "evaluates" | "perspective_on" | "works_at" | "participates_in" | "performs" | "function_in" | "impacts" | "invested_in" | "raised_from" | "mentioned_in" | "founded_by" | "competes_with";
-/**
- * Normalize confidence to a 0-1 number regardless of input format.
- *
- * Handles:
- * - number (0-1): returned as-is
- * - number (1-100): divided by 100
- * - string ("high"/"medium"/"low"): mapped to 0.8/0.5/0.3
- * - undefined/null/other: returns 0.5 default
- *
- * This is the canonical way to read confidence from any source.
- */
-declare function normalizeConfidence(confidence: unknown): number;
-/**
- * Epistemic Edge Propagation Semantics
- *
- * Each edge type has specific propagation rules for confidence cascades:
- *
- * | Edge Type         | Direction    | Propagation Rule                                          |
- * |-------------------|--------------|-----------------------------------------------------------|
- * | depends_on        | B → A        | A.conf = min(A.conf, B.conf + 0.2)                       |
- * | reinforces        | A ↔ B        | Both get boost when either validated                      |
- * | falsified_by      | B → A        | A.conf = 1 - B.conf (inverse)                            |
- * | exclusive_with    | A ↔ B        | A.conf + B.conf ≤ 1.0 (redistribute on evidence)         |
- * | contradicts       | A ↔ B        | Creates tension - neither can be validated without fork   |
- * | collapses_if      | A → B        | If A.conf < threshold, B.conf → 0                        |
- * | cascade_from      | A → B        | B.conf_delta = A.conf_delta * damping_factor             |
- * | strengthened_by   | A → B        | B.conf += A.conf_delta * correlation                     |
- * | weakened_by       | A → B        | B.conf -= A.conf_delta * correlation                     |
- * | alternative_to    | A ↔ B        | Evidence for A reduces B, and vice versa                 |
- * | subsumes          | A → B        | A.conf >= B.conf always                                  |
- * | validated_by      | A → B        | If A validated, B gains confidence                       |
- * | required_for      | A → B        | B cannot be validated until A is validated               |
- * | blocks            | A → B        | B resolution blocked until A resolved                    |
- */
-/**
- * Create an epistemic edge between two nodes
- *
- * Phase 1 (Graph Architecture): Writes to Neo4j directly - Neo4j is source of truth.
- * Returns globalId (string) instead of Convex edge ID.
- *
- * Phase 2C: Validates layer rules before creation
- */
-declare function createEpistemicEdge(ctx: MutationCtx, params: {
-    fromNodeId: Id<"epistemicNodes">;
-    toNodeId: Id<"epistemicNodes">;
-    edgeType: EpistemicEdgeType;
-    weight?: number;
-    confidence?: number;
-    context?: string;
-    projectId?: string;
-    createdBy: string;
-    skipLayerValidation?: boolean;
-}): Promise<string>;
-/**
- * Create an edge when linking an insight to a question
- * This creates a "derived_from" edge (evidence answers/informs question)
- */
-declare function createEdgeForInsightQuestionLink(ctx: MutationCtx, questionId: Id<"epistemicNodes">, insightId: Id<"epistemicNodes">, createdBy: string): Promise<string | null>;
-
-declare const epistemicHelpers_EDGE_LAYER_RULES: typeof EDGE_LAYER_RULES;
-type epistemicHelpers_EpistemicLayer = EpistemicLayer;
-declare const epistemicHelpers_LAYER_TRAVERSAL_RULES: typeof LAYER_TRAVERSAL_RULES;
-type epistemicHelpers_TraversalMode = TraversalMode;
-type epistemicHelpers_TraversalOptions = TraversalOptions;
-declare const epistemicHelpers_canTraverseToLayer: typeof canTraverseToLayer;
-declare const epistemicHelpers_createEdgeForInsightQuestionLink: typeof createEdgeForInsightQuestionLink;
-declare const epistemicHelpers_createEpistemicEdge: typeof createEpistemicEdge;
-declare const epistemicHelpers_createEpistemicNodeForArtifact: typeof createEpistemicNodeForArtifact;
-declare const epistemicHelpers_createEpistemicNodeForBelief: typeof createEpistemicNodeForBelief;
-declare const epistemicHelpers_createEpistemicNodeForInsight: typeof createEpistemicNodeForInsight;
-declare const epistemicHelpers_createEpistemicNodeForQuestion: typeof createEpistemicNodeForQuestion;
-declare const epistemicHelpers_getDefaultEdgeTypesForMode: typeof getDefaultEdgeTypesForMode;
-declare const epistemicHelpers_getDefaultMinLayer: typeof getDefaultMinLayer;
-declare const epistemicHelpers_getLayerDepth: typeof getLayerDepth;
-declare const epistemicHelpers_getNeo4jLabel: typeof getNeo4jLabel;
-declare const epistemicHelpers_getNeo4jRelType: typeof getNeo4jRelType;
-declare const epistemicHelpers_getNodeLayer: typeof getNodeLayer;
-declare const epistemicHelpers_isDeprecatedEdgeType: typeof isDeprecatedEdgeType;
-declare const epistemicHelpers_isValidLayerConnection: typeof isValidLayerConnection;
-declare const epistemicHelpers_normalizeConfidence: typeof normalizeConfidence;
-declare const epistemicHelpers_shouldContinueTraversal: typeof shouldContinueTraversal;
-declare const epistemicHelpers_validateEdgeLayers: typeof validateEdgeLayers;
-declare namespace epistemicHelpers {
-  export { epistemicHelpers_EDGE_LAYER_RULES as EDGE_LAYER_RULES, type epistemicHelpers_EpistemicLayer as EpistemicLayer, epistemicHelpers_LAYER_TRAVERSAL_RULES as LAYER_TRAVERSAL_RULES, type epistemicHelpers_TraversalMode as TraversalMode, type epistemicHelpers_TraversalOptions as TraversalOptions, epistemicHelpers_canTraverseToLayer as canTraverseToLayer, epistemicHelpers_createEdgeForInsightQuestionLink as createEdgeForInsightQuestionLink, epistemicHelpers_createEpistemicEdge as createEpistemicEdge, epistemicHelpers_createEpistemicNodeForArtifact as createEpistemicNodeForArtifact, epistemicHelpers_createEpistemicNodeForBelief as createEpistemicNodeForBelief, epistemicHelpers_createEpistemicNodeForInsight as createEpistemicNodeForInsight, epistemicHelpers_createEpistemicNodeForQuestion as createEpistemicNodeForQuestion, epistemicHelpers_getDefaultEdgeTypesForMode as getDefaultEdgeTypesForMode, epistemicHelpers_getDefaultMinLayer as getDefaultMinLayer, epistemicHelpers_getLayerDepth as getLayerDepth, epistemicHelpers_getNeo4jLabel as getNeo4jLabel, epistemicHelpers_getNeo4jRelType as getNeo4jRelType, epistemicHelpers_getNodeLayer as getNodeLayer, epistemicHelpers_isDeprecatedEdgeType as isDeprecatedEdgeType, epistemicHelpers_isValidLayerConnection as isValidLayerConnection, epistemicHelpers_normalizeConfidence as normalizeConfidence, epistemicHelpers_shouldContinueTraversal as shouldContinueTraversal, epistemicHelpers_validateEdgeLayers as validateEdgeLayers };
-}
-
-export { EDGE_LAYER_RULES as E, LAYER_TRAVERSAL_RULES as L, type TraversalMode as T, type EpistemicLayer as a, type TraversalOptions as b, canTraverseToLayer as c, createEdgeForInsightQuestionLink as d, epistemicHelpers as e, createEpistemicEdge as f, createEpistemicNodeForArtifact as g, createEpistemicNodeForBelief as h, createEpistemicNodeForInsight as i, createEpistemicNodeForQuestion as j, getDefaultEdgeTypesForMode as k, getDefaultMinLayer as l, getLayerDepth as m, getNodeLayer as n, isValidLayerConnection as o, normalizeConfidence as p, shouldContinueTraversal as s, validateEdgeLayers as v };

package/dist/epistemicNodes-DjSUfvyD.d.ts

@@ -1,167 +0,0 @@
-import * as convex_values from 'convex/values';
-
-/**
- * Epistemic Nodes - CRUD operations for the knowledge graph nodes
- *
- * Every belief, question, evidence, and source in StackOS is an epistemic node.
- * This is the canonical identity layer - these records are the source of truth.
- *
- * @see /docs/architecture/EPISTEMIC_SPINE.md
- */
-/**
- * Epistemic Layer Validator
- * L4: Decisions, outcomes - audit targets
- * L3: Beliefs, questions, themes - traversal anchors
- * 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 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>;
-declare const l1NodeTypeValidator: convex_values.VUnion<"source" | "atomic_fact" | "excerpt", [convex_values.VLiteral<"atomic_fact", "required">, convex_values.VLiteral<"excerpt", "required">, convex_values.VLiteral<"source", "required">], "required", never>;
-declare const epistemicNodeTypeValidator: convex_values.VUnion<"belief" | "question" | "evidence" | "answer" | "synthesis" | "theme" | "source" | "decision" | "deal" | "claim" | "atomic_fact" | "excerpt", [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">], "required", never>;
-declare const ontologicalNodeTypeValidator: convex_values.VUnion<"function" | "company" | "person" | "investor" | "value_chain", [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">], "required", never>;
-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 verificationStatusValidator: convex_values.VUnion<"unverified" | "human_verified" | "ai_verified" | "contradicted" | "outdated", [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>;
-/**
- * Get a single node by ID
- */
-declare const get: any;
-/**
- * Get a node by its global UUID
- */
-declare const getByGlobalId: any;
-/**
- * Find nodes by content hash (for deduplication)
- */
-declare const getByContentHash: any;
-/**
- * Get all nodes of a specific type for a project
- */
-declare const getByProjectAndType: any;
-/**
- * Lightweight variant of getByProjectAndType for operational scripts.
- * Returns compact node metadata and supports limits to avoid oversized payloads.
- */
-declare const getByProjectAndTypeLite: any;
-/**
- * Get all nodes for a project
- */
-declare const getByProject: any;
-declare const getByTopic: any;
-/**
- * List all active nodes (unscoped — for internal dev tools).
- * No project filtering, no access control.
- */
-declare const listAll: any;
-/**
- * Search nodes by text content
- */
-declare const search: any;
-/**
- * Create a new epistemic node
- */
-declare const create: any;
-/**
- * Update an existing node
- */
-declare const update: any;
-/**
- * Supersede a node with a new version
- * Creates a new node and marks the old one as superseded
- *
- * Phase 2B: Supersession only allowed within the same layer
- * (e.g., a belief can only supersede another belief)
- */
-declare const supersede: any;
-/**
- * Archive a node (soft delete)
- *
- * INVARIANT: Belief nodes cannot be archived per Epistemic Invariant #1.
- * For belief nodes, this uses "superseded" status instead.
- */
-declare const archive: any;
-/**
- * Permanently delete a node (hard delete)
- * INTERNAL ONLY - not exposed to clients
- * Use with extreme caution - prefer archive for most cases
- * Violates Lucern Invariant #1 (append-only) - only use for data cleanup/migration
- */
-declare const hardDelete: any;
-/**
- * Update verification status
- */
-declare const verify: any;
-/**
- * Batch create nodes (for migrations or bulk imports)
- * Phase 2B: Auto-derives epistemicLayer from nodeType
- */
-declare const batchCreate: any;
-/**
- * Internal mutation to create a node with syncStatus tracking
- * Used by neo4jEdgeAPI.createNodeWithEdges for atomic node+edge creation
- */
-declare const createInternal: any;
-/**
- * Internal query to get a node by ID
- * Used by neo4jEdgeAPI for reading node data
- */
-declare const getInternal: any;
-/**
- * Update the sync status of a node (for Neo4j edge sync tracking)
- * Used by neo4jEdgeAPI to mark nodes as synced or failed
- */
-declare const updateSyncStatus: any;
-/**
- * Backfill: move nodes from one topicId to another.
- * Used for data migration when nodes are accidentally scoped to Root.
- */
-declare const backfillTopicId: any;
-/**
- * Find nodes that need edge sync retry
- * Used by background reconciliation job
- */
-declare const getNodesPendingEdgeSync: any;
-
-declare const epistemicNodes_archive: typeof archive;
-declare const epistemicNodes_backfillTopicId: typeof backfillTopicId;
-declare const epistemicNodes_batchCreate: typeof batchCreate;
-declare const epistemicNodes_create: typeof create;
-declare const epistemicNodes_createInternal: typeof createInternal;
-declare const epistemicNodes_epistemicLayerValidator: typeof epistemicLayerValidator;
-declare const epistemicNodes_epistemicNodeTypeValidator: typeof epistemicNodeTypeValidator;
-declare const epistemicNodes_get: typeof get;
-declare const epistemicNodes_getByContentHash: typeof getByContentHash;
-declare const epistemicNodes_getByGlobalId: typeof getByGlobalId;
-declare const epistemicNodes_getByProject: typeof getByProject;
-declare const epistemicNodes_getByProjectAndType: typeof getByProjectAndType;
-declare const epistemicNodes_getByProjectAndTypeLite: typeof getByProjectAndTypeLite;
-declare const epistemicNodes_getByTopic: typeof getByTopic;
-declare const epistemicNodes_getInternal: typeof getInternal;
-declare const epistemicNodes_getNodesPendingEdgeSync: typeof getNodesPendingEdgeSync;
-declare const epistemicNodes_hardDelete: typeof hardDelete;
-declare const epistemicNodes_l1NodeTypeValidator: typeof l1NodeTypeValidator;
-declare const epistemicNodes_l2NodeTypeValidator: typeof l2NodeTypeValidator;
-declare const epistemicNodes_l3NodeTypeValidator: typeof l3NodeTypeValidator;
-declare const epistemicNodes_l4NodeTypeValidator: typeof l4NodeTypeValidator;
-declare const epistemicNodes_listAll: typeof listAll;
-declare const epistemicNodes_nodeTypeValidator: typeof nodeTypeValidator;
-declare const epistemicNodes_ontologicalNodeTypeValidator: typeof ontologicalNodeTypeValidator;
-declare const epistemicNodes_organizationalNodeTypeValidator: typeof organizationalNodeTypeValidator;
-declare const epistemicNodes_search: typeof search;
-declare const epistemicNodes_sourceTypeValidator: typeof sourceTypeValidator;
-declare const epistemicNodes_statusValidator: typeof statusValidator;
-declare const epistemicNodes_supersede: typeof supersede;
-declare const epistemicNodes_update: typeof update;
-declare const epistemicNodes_updateSyncStatus: typeof updateSyncStatus;
-declare const epistemicNodes_verificationStatusValidator: typeof verificationStatusValidator;
-declare const epistemicNodes_verify: typeof verify;
-declare namespace epistemicNodes {
-  export { epistemicNodes_archive as archive, epistemicNodes_backfillTopicId as backfillTopicId, epistemicNodes_batchCreate as batchCreate, epistemicNodes_create as create, epistemicNodes_createInternal as createInternal, epistemicNodes_epistemicLayerValidator as epistemicLayerValidator, epistemicNodes_epistemicNodeTypeValidator as epistemicNodeTypeValidator, epistemicNodes_get as get, epistemicNodes_getByContentHash as getByContentHash, epistemicNodes_getByGlobalId as getByGlobalId, epistemicNodes_getByProject as getByProject, epistemicNodes_getByProjectAndType as getByProjectAndType, epistemicNodes_getByProjectAndTypeLite as getByProjectAndTypeLite, epistemicNodes_getByTopic as getByTopic, epistemicNodes_getInternal as getInternal, epistemicNodes_getNodesPendingEdgeSync as getNodesPendingEdgeSync, epistemicNodes_hardDelete as hardDelete, epistemicNodes_l1NodeTypeValidator as l1NodeTypeValidator, epistemicNodes_l2NodeTypeValidator as l2NodeTypeValidator, epistemicNodes_l3NodeTypeValidator as l3NodeTypeValidator, epistemicNodes_l4NodeTypeValidator as l4NodeTypeValidator, epistemicNodes_listAll as listAll, epistemicNodes_nodeTypeValidator as nodeTypeValidator, epistemicNodes_ontologicalNodeTypeValidator as ontologicalNodeTypeValidator, epistemicNodes_organizationalNodeTypeValidator as organizationalNodeTypeValidator, epistemicNodes_search as search, epistemicNodes_sourceTypeValidator as sourceTypeValidator, epistemicNodes_statusValidator as statusValidator, epistemicNodes_supersede as supersede, epistemicNodes_update as update, epistemicNodes_updateSyncStatus as updateSyncStatus, epistemicNodes_verificationStatusValidator as verificationStatusValidator, epistemicNodes_verify as verify };
-}
-
-export { search as A, sourceTypeValidator as B, statusValidator as C, supersede as D, update as E, updateSyncStatus as F, verificationStatusValidator as G, verify as H, archive as a, backfillTopicId as b, batchCreate as c, create as d, epistemicNodes as e, createInternal as f, epistemicLayerValidator as g, epistemicNodeTypeValidator as h, get as i, getByContentHash as j, getByGlobalId as k, getByProject as l, getByProjectAndType as m, getByProjectAndTypeLite as n, getByTopic as o, getInternal as p, getNodesPendingEdgeSync as q, hardDelete as r, l1NodeTypeValidator as s, l2NodeTypeValidator as t, l3NodeTypeValidator as u, l4NodeTypeValidator as v, listAll as w, nodeTypeValidator as x, ontologicalNodeTypeValidator as y, organizationalNodeTypeValidator as z };