@lucern/graph-primitives 0.1.0-alpha.2

package/dist/entityValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/entityValidation.ts"],"names":[],"mappings":"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","file":"entityValidation.js","sourcesContent":["/**\n * Entity Metadata Validation\n *\n * Validates entity metadata against registered schemas in schemaEnumConfig.\n * Strict on create (must pass), lenient on read (existing data tolerance).\n *\n * @module graph-primitives/entityValidation\n */\n\nimport type { MutationCtx, QueryCtx } from \"./convex\";\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\ntype FieldSchema = {\n  type: \"string\" | \"number\" | \"boolean\";\n  required: boolean;\n};\n\ntype EntitySchema = Record<string, FieldSchema>;\n\ntype ValidationResult = {\n  valid: boolean;\n  errors: string[];\n};\n\n// =============================================================================\n// SCHEMA LOOKUP\n// =============================================================================\n\n/**\n * Fetch the registered metadata schema for an entity type.\n * Returns null if no schema is registered.\n */\nexport async function getEntityTypeSchema(\n  ctx: QueryCtx | MutationCtx,\n  nodeType: string,\n  tenantId?: string\n): Promise<EntitySchema | null> {\n  // Try tenant-specific first, then platform default\n  if (tenantId) {\n    const tenantEntry = await (ctx.db as any)\n      .query(\"schemaEnumConfig\")\n      .withIndex(\"by_tenant_category\", (q: any) =>\n        q.eq(\"tenantId\", tenantId).eq(\"category\", \"entity_type\")\n      )\n      .collect();\n\n    const tenantMatch = tenantEntry.find(\n      (e: any) => e.value === nodeType && e.status === \"active\"\n    );\n    if (tenantMatch?.metadata?.schema) {\n      return tenantMatch.metadata.schema as EntitySchema;\n    }\n  }\n\n  // Fall back to platform default\n  const platformEntry = await (ctx.db as any)\n    .query(\"schemaEnumConfig\")\n    .withIndex(\"by_category_value\", (q: any) =>\n      q.eq(\"category\", \"entity_type\").eq(\"value\", nodeType)\n    )\n    .first();\n\n  if (platformEntry?.metadata?.schema && platformEntry.status === \"active\") {\n    return platformEntry.metadata.schema as EntitySchema;\n  }\n\n  return null;\n}\n\n// =============================================================================\n// VALIDATION\n// =============================================================================\n\n/**\n * Validate entity metadata against the registered schema.\n *\n * Policy: strict on create (unregistered types fail), lenient on read.\n *\n * @param ctx - Convex query/mutation context\n * @param nodeType - The entity nodeType (e.g., \"company\", \"person\")\n * @param metadata - The metadata object to validate\n * @param tenantId - Optional tenant ID for tenant-specific schemas\n * @returns ValidationResult with errors if invalid\n */\nexport async function validateEntityMetadata(\n  ctx: QueryCtx | MutationCtx,\n  nodeType: string,\n  metadata: Record<string, unknown> | undefined | null,\n  tenantId?: string\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n\n  const schema = await getEntityTypeSchema(ctx, nodeType, tenantId);\n\n  if (!schema) {\n    return {\n      valid: false,\n      errors: [\n        `No registered schema for entity type \"${nodeType}\". Register it in schemaEnumConfig (category=\"entity_type\") before creating entities of this type.`,\n      ],\n    };\n  }\n\n  const meta = metadata || {};\n\n  // Check required fields\n  for (const [fieldName, fieldDef] of Object.entries(schema)) {\n    if (fieldDef.required) {\n      const value = meta[fieldName];\n      if (value === undefined || value === null || value === \"\") {\n        errors.push(`Required field \"${fieldName}\" is missing or empty`);\n      }\n    }\n  }\n\n  // Check field types for provided fields\n  for (const [fieldName, value] of Object.entries(meta)) {\n    const fieldDef = schema[fieldName];\n    if (!fieldDef) {\n      // Extra fields are allowed (loose metadata tolerance)\n      continue;\n    }\n\n    if (value === undefined || value === null) {\n      // null/undefined are allowed for optional fields (already caught above for required)\n      continue;\n    }\n\n    const actualType = typeof value;\n    if (actualType !== fieldDef.type) {\n      errors.push(\n        `Field \"${fieldName}\" expected type \"${fieldDef.type}\" but got \"${actualType}\"`\n      );\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Check if a nodeType is a registered entity type (platform or tenant).\n */\nexport async function isRegisteredEntityType(\n  ctx: QueryCtx | MutationCtx,\n  nodeType: string,\n  tenantId?: string\n): Promise<boolean> {\n  const schema = await getEntityTypeSchema(ctx, nodeType, tenantId);\n  return schema !== null;\n}\n"]}

package/dist/epistemicAnswers-DSP1slZ9.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Epistemic Answers API
+ *
+ * Answers are first-class L2 nodes in the epistemic spine.
+ * Every answer is an immutable snapshot — new answers create new nodes,
+ * old ones get `superseded`. This gives full version history and lets
+ * answers have their own edges in the knowledge graph.
+ *
+ * Edge: Answer —responds_to→ Question
+ * Edge: Answer —based_on→ Evidence (for each supporting evidence)
+ * Edge: NewAnswer —supersedes→ OldAnswer (for versioning)
+ *
+ * @see /docs/epistemic-invariants/00-epistemic-invariants.md
+ */
+/**
+ * Create a new answer node for a question.
+ *
+ * 1. Validates the question exists
+ * 2. Determines version number
+ * 3. Supersedes previous active answer (if any)
+ * 4. Creates the answer node
+ * 5. Creates responds_to edge (Answer → Question)
+ * 6. Creates supersedes edge (NewAnswer → OldAnswer) if versioning
+ * 7. Creates based_on edges (Answer → Evidence) for each evidence node
+ * 8. Updates question's answerQuality field
+ * 9. Logs to epistemicAudit
+ */
+declare const create: any;
+/**
+ * Internal mutation for creating answer nodes.
+ * Called from epistemicQuestions.updateStatus when status === "answered".
+ */
+declare const createInternal: any;
+/**
+ * Get all answers for a question, optionally including superseded.
+ */
+declare const getByQuestion: any;
+/**
+ * Get the single active (latest) answer for a question.
+ */
+declare const getLatestForQuestion: any;
+/**
+ * Get full version history for answers to a question.
+ * Returns answers ordered by version number (newest first).
+ */
+declare const getVersionHistory: any;
+/**
+ * Backfill answer nodes for questions that have answer text in metadata
+ * but never had an answer node created (due to the QuestionAnswerEditor bug
+ * where saveAnswer passed wrong params to updateStatus).
+ *
+ * Run once via Convex dashboard:
+ *   internal.epistemicAnswers.backfillAnswerNodes({ projectId, userId })
+ */
+declare const backfillAnswerNodes: any;
+
+declare const epistemicAnswers_backfillAnswerNodes: typeof backfillAnswerNodes;
+declare const epistemicAnswers_create: typeof create;
+declare const epistemicAnswers_createInternal: typeof createInternal;
+declare const epistemicAnswers_getByQuestion: typeof getByQuestion;
+declare const epistemicAnswers_getLatestForQuestion: typeof getLatestForQuestion;
+declare const epistemicAnswers_getVersionHistory: typeof getVersionHistory;
+declare namespace epistemicAnswers {
+  export { epistemicAnswers_backfillAnswerNodes as backfillAnswerNodes, epistemicAnswers_create as create, epistemicAnswers_createInternal as createInternal, epistemicAnswers_getByQuestion as getByQuestion, epistemicAnswers_getLatestForQuestion as getLatestForQuestion, epistemicAnswers_getVersionHistory as getVersionHistory };
+}
+
+export { createInternal as a, getLatestForQuestion as b, create as c, getVersionHistory as d, epistemicAnswers as e, backfillAnswerNodes as f, getByQuestion as g };

package/dist/epistemicAnswers.d.ts

@@ -0,0 +1 @@
+export { f as backfillAnswerNodes, c as create, a as createInternal, g as getByQuestion, b as getLatestForQuestion, d as getVersionHistory } from './epistemicAnswers-DSP1slZ9.js';