@lucern/graph-primitives 0.1.0-alpha.2

package/dist/epistemicEvidence-Bo638XDP.d.ts

@@ -0,0 +1,128 @@
+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, getByProject as b, create as c, getByTopic as d, epistemicEvidence as e, flattenEvidenceNode as f, getById as g, getForBelief as h, internalGetByProject as i, internalGetByTopic as j, internalCreate as k, updateVerificationStatus as l, getByProjectSystem as m, getEvidenceBalance as n, update as o, flagAsIncorrect as p, remove as q, resolveEvidenceLinkedWorktreeId as r, updateStatus as u };

package/dist/epistemicEvidence.d.ts

@@ -0,0 +1,3 @@
+import './convex.js';
+export { c as create, a as createAndLink, p as flagAsIncorrect, f as flattenEvidenceNode, g as getById, b as getByProject, m as getByProjectSystem, d as getByTopic, n as getEvidenceBalance, h as getForBelief, k as internalCreate, i as internalGetByProject, j as internalGetByTopic, q as remove, r as resolveEvidenceLinkedWorktreeId, o as update, u as updateStatus, l as updateVerificationStatus } from './epistemicEvidence-Bo638XDP.js';
+import 'convex/values';