@lucern/graph-primitives 0.1.0-alpha.2

package/dist/ontologyRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../access-control/src/auth.ts","../../schema-management/src/validators.ts","../src/convex.ts","../src/ontologyRegistry.ts"],"names":["v"],"mappings":"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","file":"ontologyRegistry.js","sourcesContent":["/**\n * auth module implementation.\n */\n\nimport type { ActionCtx, MutationCtx, QueryCtx } from \"./convex\";\n\ntype AnyCtx = QueryCtx | MutationCtx | ActionCtx;\n\n/**\n * Get the current user's identity from Clerk.\n */\nexport async function getCurrentUser(ctx: AnyCtx) {\n  const identity = await ctx.auth.getUserIdentity();\n  return identity;\n}\n\n/**\n * Get the current user ID (Clerk subject).\n */\nexport async function getCurrentUserId(ctx: AnyCtx): Promise<string | null> {\n  const identity = await ctx.auth.getUserIdentity();\n  return identity?.subject ?? null;\n}\n","/**\n * validators module implementation.\n */\n\nimport { v } from \"convex/values\";\n\n/**\n * Permissive return validator used while contracts are tightened.\n */\nexport const permissiveReturn: any = v.optional(v.any());\n\n/**\n * Shallow JSON validators for dynamic payloads.\n */\nexport const looseJsonObject = v.record(v.string(), v.any());\nexport const looseJsonArray = v.array(v.any());\nexport const looseJsonValue = v.union(\n  v.string(),\n  v.number(),\n  v.boolean(),\n  v.null(),\n  looseJsonObject,\n  looseJsonArray\n);\n","import {\n  actionGeneric,\n  anyApi,\n  componentsGeneric,\n  httpActionGeneric,\n  internalActionGeneric,\n  internalMutationGeneric,\n  internalQueryGeneric,\n  mutationGeneric,\n  queryGeneric,\n} from \"convex/server\";\nimport type { GenericId } from \"convex/values\";\n\nexport const api = anyApi as any;\nexport const components = componentsGeneric() as any;\nexport const internal = anyApi as any;\n\nexport type TableNames = string;\nexport type Id<TableName extends TableNames = string> = GenericId<TableName>;\nexport type Doc<TableName extends TableNames = string> = any;\nexport type DataModel = any;\nexport type ActionCtx = any;\nexport type DatabaseReader = any;\nexport type DatabaseWriter = any;\nexport type MutationCtx = any;\nexport type QueryCtx = any;\n\nexport const action = actionGeneric as any;\nexport const httpAction = httpActionGeneric as any;\nexport const internalAction = internalActionGeneric as any;\nexport const internalMutation = internalMutationGeneric as any;\nexport const internalQuery = internalQueryGeneric as any;\nexport const mutation = mutationGeneric as any;\nexport const query = queryGeneric as any;\n","/**\n * Ontology Registry\n *\n * Seeds schemaEnumConfig with platform-default entity types, subtypes,\n * and entity edge types. Provides tenant extension API.\n *\n * Categories:\n * - entity_type: Company, Person, Investor, Function, ValueChain\n * - entity_subtype: company/private, investor/vc, etc.\n * - entity_edge_type: works_at, invested_in, etc.\n *\n * @module graph-primitives/ontologyRegistry\n */\n\nimport { v } from \"convex/values\";\nimport { getCurrentUserId } from \"@lucern/access-control/auth\";\nimport { permissiveReturn } from \"@lucern/schema-management/validators\";\nimport type { MutationCtx } from \"./convex\";\nimport { internalMutation, mutation } from \"./convex\";\n\n// =============================================================================\n// PLATFORM-DEFAULT ENTITY TYPES\n// =============================================================================\n\ntype FieldSchema = {\n  type: \"string\" | \"number\" | \"boolean\";\n  required: boolean;\n};\n\ntype EntityTypeDefinition = {\n  value: string;\n  label: string;\n  description: string;\n  schema: Record<string, FieldSchema>;\n};\n\nconst PLATFORM_ENTITY_TYPES: EntityTypeDefinition[] = [\n  {\n    value: \"company\",\n    label: \"Company\",\n    description: \"A business entity — startup, portfolio company, or corporate\",\n    schema: {\n      name: { type: \"string\", required: true },\n      sector: { type: \"string\", required: false },\n      founded_year: { type: \"number\", required: false },\n      website: { type: \"string\", required: false },\n      domain: { type: \"string\", required: false },\n    },\n  },\n  {\n    value: \"person\",\n    label: \"Person\",\n    description: \"An individual — founder, executive, or contact\",\n    schema: {\n      name: { type: \"string\", required: true },\n      role: { type: \"string\", required: false },\n      affiliation: { type: \"string\", required: false },\n      linkedin: { type: \"string\", required: false },\n    },\n  },\n  {\n    value: \"investor\",\n    label: \"Investor\",\n    description: \"An investment entity — fund, GP, or angel\",\n    schema: {\n      name: { type: \"string\", required: true },\n      fund_name: { type: \"string\", required: false },\n      investment_focus: { type: \"string\", required: false },\n      aum: { type: \"number\", required: false },\n    },\n  },\n  {\n    value: \"function\",\n    label: \"Function\",\n    description: \"A business function in a value chain\",\n    schema: {\n      name: { type: \"string\", required: true },\n      description: { type: \"string\", required: false },\n    },\n  },\n  {\n    value: \"value_chain\",\n    label: \"Value Chain\",\n    description: \"A value chain or industry vertical\",\n    schema: {\n      name: { type: \"string\", required: true },\n      description: { type: \"string\", required: false },\n    },\n  },\n];\n\n// =============================================================================\n// PLATFORM-DEFAULT ENTITY SUBTYPES\n// =============================================================================\n\ntype SubtypeDefinition = {\n  value: string;\n  label: string;\n  parentType: string;\n};\n\nconst PLATFORM_ENTITY_SUBTYPES: SubtypeDefinition[] = [\n  // Company subtypes\n  { value: \"company/private\", label: \"Private Company\", parentType: \"company\" },\n  { value: \"company/corporate\", label: \"Corporate\", parentType: \"company\" },\n  {\n    value: \"company/portfolio\",\n    label: \"Portfolio Company\",\n    parentType: \"company\",\n  },\n  // Investor subtypes\n  { value: \"investor/vc\", label: \"Venture Capital\", parentType: \"investor\" },\n  { value: \"investor/lp\", label: \"Limited Partner\", parentType: \"investor\" },\n  { value: \"investor/cvc\", label: \"Corporate VC\", parentType: \"investor\" },\n  { value: \"investor/pe\", label: \"Private Equity\", parentType: \"investor\" },\n  {\n    value: \"investor/family_office\",\n    label: \"Family Office\",\n    parentType: \"investor\",\n  },\n  { value: \"investor/angel\", label: \"Angel Investor\", parentType: \"investor\" },\n];\n\n// =============================================================================\n// PLATFORM-DEFAULT ENTITY EDGE TYPES\n// =============================================================================\n\ntype EntityEdgeTypeDefinition = {\n  value: string;\n  label: string;\n  description: string;\n};\n\nconst PLATFORM_ENTITY_EDGE_TYPES: EntityEdgeTypeDefinition[] = [\n  {\n    value: \"works_at\",\n    label: \"Works At\",\n    description: \"Person → Company/Investor employment\",\n  },\n  {\n    value: \"performs\",\n    label: \"Performs\",\n    description: \"Company → Function capability\",\n  },\n  {\n    value: \"invested_in\",\n    label: \"Invested In\",\n    description: \"Investor → Company investment\",\n  },\n  {\n    value: \"founded_by\",\n    label: \"Founded By\",\n    description: \"Company → Person founding\",\n  },\n  {\n    value: \"participates_in\",\n    label: \"Participates In\",\n    description: \"Company → ValueChain participation\",\n  },\n  {\n    value: \"function_in\",\n    label: \"Function In\",\n    description: \"Function → ValueChain membership\",\n  },\n  {\n    value: \"impacts\",\n    label: \"Impacts\",\n    description: \"Theme → ValueChain impact\",\n  },\n  {\n    value: \"mentioned_in\",\n    label: \"Mentioned In\",\n    description: \"Entity → Source reference\",\n  },\n  {\n    value: \"competes_with\",\n    label: \"Competes With\",\n    description: \"Company → Company competition\",\n  },\n  {\n    value: \"depends_on\",\n    label: \"Depends On\",\n    description: \"Entity → Entity dependency\",\n  },\n  {\n    value: \"contains\",\n    label: \"Contains\",\n    description: \"Containment: ValueChain → Function, Belief/Question/Theme → Entity, Entity → Evidence\",\n  },\n  {\n    value: \"raised_from\",\n    label: \"Raised From\",\n    description: \"Company → Investor fundraising\",\n  },\n  {\n    value: \"derived_from\",\n    label: \"Derived From\",\n    description: \"Entity → Entity deduplication merge link (replaces same_as)\",\n  },\n];\n\n// =============================================================================\n// SEED MUTATION (idempotent)\n// =============================================================================\n\nasync function upsertEnumEntry(\n  ctx: MutationCtx,\n  entry: {\n    category: string;\n    value: string;\n    label: string;\n    description?: string;\n    tier: \"platform\" | \"tenant\";\n    metadata?: Record<string, unknown>;\n    sortOrder?: number;\n  }\n): Promise<{ inserted: boolean }> {\n  const existing = await ctx.db\n    .query(\"schemaEnumConfig\")\n    .withIndex(\"by_category_value\", (q) =>\n      q.eq(\"category\", entry.category).eq(\"value\", entry.value)\n    )\n    .first();\n\n  if (existing) {\n    return { inserted: false };\n  }\n\n  const now = Date.now();\n  await ctx.db.insert(\"schemaEnumConfig\", {\n    category: entry.category,\n    value: entry.value,\n    label: entry.label,\n    description: entry.description,\n    tier: entry.tier,\n    metadata: entry.metadata,\n    sortOrder: entry.sortOrder,\n    status: \"active\" as const,\n    createdAt: now,\n    updatedAt: now,\n  });\n\n  return { inserted: true };\n}\n\n/**\n * Seed the ontology registry with platform-default entity types.\n * Idempotent — safe to call multiple times.\n */\nexport const seedOntologyRegistry = internalMutation({\n  args: {},\n  returns: permissiveReturn,\n  handler: async (ctx) => {\n    let inserted = 0;\n    let skipped = 0;\n\n    // Seed entity types\n    for (let i = 0; i < PLATFORM_ENTITY_TYPES.length; i++) {\n      const entityType = PLATFORM_ENTITY_TYPES[i];\n      const result = await upsertEnumEntry(ctx, {\n        category: \"entity_type\",\n        value: entityType.value,\n        label: entityType.label,\n        description: entityType.description,\n        tier: \"platform\",\n        metadata: { schema: entityType.schema },\n        sortOrder: i + 1,\n      });\n      if (result.inserted) {\n        inserted++;\n      } else {\n        skipped++;\n      }\n    }\n\n    // Seed entity subtypes\n    for (let i = 0; i < PLATFORM_ENTITY_SUBTYPES.length; i++) {\n      const subtype = PLATFORM_ENTITY_SUBTYPES[i];\n      const result = await upsertEnumEntry(ctx, {\n        category: \"entity_subtype\",\n        value: subtype.value,\n        label: subtype.label,\n        tier: \"platform\",\n        metadata: { parentType: subtype.parentType },\n        sortOrder: i + 1,\n      });\n      if (result.inserted) {\n        inserted++;\n      } else {\n        skipped++;\n      }\n    }\n\n    // Seed entity edge types\n    for (let i = 0; i < PLATFORM_ENTITY_EDGE_TYPES.length; i++) {\n      const edgeType = PLATFORM_ENTITY_EDGE_TYPES[i];\n      const result = await upsertEnumEntry(ctx, {\n        category: \"entity_edge_type\",\n        value: edgeType.value,\n        label: edgeType.label,\n        description: edgeType.description,\n        tier: \"platform\",\n        sortOrder: i + 1,\n      });\n      if (result.inserted) {\n        inserted++;\n      } else {\n        skipped++;\n      }\n    }\n\n    return { inserted, skipped, total: inserted + skipped };\n  },\n});\n\n// =============================================================================\n// TENANT EXTENSION API\n// =============================================================================\n\n/**\n * Register a new entity type for a tenant.\n * Creates a schemaEnumConfig entry with tier='tenant'.\n */\nexport const registerEntityType = mutation({\n  args: {\n    tenantId: v.string(),\n    value: v.string(),\n    label: v.string(),\n    description: v.optional(v.string()),\n    schema: v.any(), // Record<string, { type, required }>\n    domainNamespace: v.optional(v.string()),\n  },\n  returns: permissiveReturn,\n  handler: async (ctx, args) => {\n    // Auth guard — tenant mutations require authenticated user\n    const userId = await getCurrentUserId(ctx as any);\n    if (!userId) {\n      throw new Error(\"Authentication required to register entity types.\");\n    }\n\n    // Check for existing entry with same value\n    const existing = await ctx.db\n      .query(\"schemaEnumConfig\")\n      .withIndex(\"by_tenant_category\", (q) =>\n        q.eq(\"tenantId\", args.tenantId).eq(\"category\", \"entity_type\")\n      )\n      .collect();\n\n    const duplicate = existing.find((e) => e.value === args.value);\n    if (duplicate) {\n      throw new Error(\n        `Entity type \"${args.value}\" already registered for tenant ${args.tenantId}`\n      );\n    }\n\n    const now = Date.now();\n    const id = await ctx.db.insert(\"schemaEnumConfig\", {\n      tenantId: args.tenantId,\n      category: \"entity_type\",\n      value: args.value,\n      label: args.label,\n      description: args.description,\n      tier: \"tenant\" as const,\n      domainNamespace: args.domainNamespace,\n      metadata: { schema: args.schema },\n      status: \"active\" as const,\n      createdAt: now,\n      updatedAt: now,\n    });\n\n    return { id, value: args.value };\n  },\n});\n"]}

package/dist/projectionReconciliation-CxrXYGaB.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Projection Reconciliation Runtime
+ *
+ * Phase 2 (WT-C) runtime hooks for Convex-authoritative / Neo4j-projected
+ * reconciliation health and endpoint-class staleness evaluation.
+ */
+declare const getProjectionReconciliationStatusInternal: any;
+declare const getProjectionReconciliationStatus: any;
+declare const assessProjectionStaleness: any;
+declare const runProjectionRepairCycle: any;
+
+declare const projectionReconciliation_assessProjectionStaleness: typeof assessProjectionStaleness;
+declare const projectionReconciliation_getProjectionReconciliationStatus: typeof getProjectionReconciliationStatus;
+declare const projectionReconciliation_getProjectionReconciliationStatusInternal: typeof getProjectionReconciliationStatusInternal;
+declare const projectionReconciliation_runProjectionRepairCycle: typeof runProjectionRepairCycle;
+declare namespace projectionReconciliation {
+  export { projectionReconciliation_assessProjectionStaleness as assessProjectionStaleness, projectionReconciliation_getProjectionReconciliationStatus as getProjectionReconciliationStatus, projectionReconciliation_getProjectionReconciliationStatusInternal as getProjectionReconciliationStatusInternal, projectionReconciliation_runProjectionRepairCycle as runProjectionRepairCycle };
+}
+
+export { getProjectionReconciliationStatus as a, assessProjectionStaleness as b, getProjectionReconciliationStatusInternal as g, projectionReconciliation as p, runProjectionRepairCycle as r };

package/dist/projectionReconciliation.d.ts

@@ -0,0 +1 @@
+export { b as assessProjectionStaleness, a as getProjectionReconciliationStatus, g as getProjectionReconciliationStatusInternal, r as runProjectionRepairCycle } from './projectionReconciliation-CxrXYGaB.js';

package/dist/projectionReconciliation.js

@@ -0,0 +1,261 @@
+import { v } from 'convex/values';
+import { componentsGeneric, internalQueryGeneric, queryGeneric, internalActionGeneric, anyApi } from 'convex/server';
+
+// src/projectionReconciliation.ts
+
+// ../access-control/src/auth.ts
+async function getCurrentUserId(ctx) {
+  const identity = await ctx.auth.getUserIdentity();
+  return identity?.subject ?? null;
+}
+var permissiveReturn = v.optional(v.any());
+var looseJsonObject = v.record(v.string(), v.any());
+var looseJsonArray = v.array(v.any());
+v.union(
+  v.string(),
+  v.number(),
+  v.boolean(),
+  v.null(),
+  looseJsonObject,
+  looseJsonArray
+);
+componentsGeneric();
+var internal = anyApi;
+var internalAction = internalActionGeneric;
+var internalQuery = internalQueryGeneric;
+var query = queryGeneric;
+
+// src/projectionStaleness.ts
+var PROJECTION_STALENESS_POLICIES = {
+  analytics: {
+    endpointClass: "analytics",
+    thresholdMs: 3e4,
+    fallbackMode: "fail_with_503",
+    nonOverridable: true
+  },
+  traversal: {
+    endpointClass: "traversal",
+    thresholdMs: 6e4,
+    fallbackMode: "degrade_to_convex_depth_limited",
+    nonOverridable: true
+  },
+  entity_read: {
+    endpointClass: "entity_read",
+    thresholdMs: 5 * 6e4,
+    fallbackMode: "fallback_to_convex_entity_read",
+    nonOverridable: true
+  },
+  non_graph: {
+    endpointClass: "non_graph",
+    thresholdMs: Number.POSITIVE_INFINITY,
+    fallbackMode: "none",
+    nonOverridable: true
+  }
+};
+function getProjectionStalenessPolicy(endpointClass) {
+  return PROJECTION_STALENESS_POLICIES[endpointClass];
+}
+function evaluateProjectionStaleness(input) {
+  const policy = getProjectionStalenessPolicy(input.endpointClass);
+  const evaluatedAt = input.nowMs ?? Date.now();
+  const stalenessMs = Math.max(0, input.queueBacklogAgeMs);
+  const isStale = stalenessMs > policy.thresholdMs;
+  const lastSuccessfulSyncAgeMs = input.lastSuccessfulSyncAt !== void 0 ? Math.max(0, evaluatedAt - input.lastSuccessfulSyncAt) : void 0;
+  return {
+    endpointClass: input.endpointClass,
+    stalenessMs,
+    thresholdMs: policy.thresholdMs,
+    isStale,
+    fallbackMode: policy.fallbackMode,
+    queuePendingCount: input.queuePendingCount,
+    queueFailedCount: input.queueFailedCount,
+    evaluatedAt,
+    lastSuccessfulSyncAt: input.lastSuccessfulSyncAt,
+    lastSuccessfulSyncAgeMs,
+    reasonCode: isStale ? input.queueFailedCount > 0 ? "PROJECTION_STALE_WITH_FAILED_RETRIES" : "PROJECTION_STALE" : "PROJECTION_HEALTHY"
+  };
+}
+
+// src/projectionReconciliation.ts
+async function collectQueueByStatus(ctx, status) {
+  return await ctx.db.query("neo4jSyncQueue").withIndex("by_status", (q) => q.eq("status", status)).collect();
+}
+function maxTimestamp(rows, field) {
+  let maxValue;
+  for (const row of rows) {
+    const value = row[field];
+    if (!Number.isFinite(value)) {
+      continue;
+    }
+    if (maxValue === void 0 || value > maxValue) {
+      maxValue = value;
+    }
+  }
+  return maxValue;
+}
+function minTimestamp(rows, field) {
+  let minValue;
+  for (const row of rows) {
+    const value = row[field];
+    if (!Number.isFinite(value)) {
+      continue;
+    }
+    if (minValue === void 0 || value < minValue) {
+      minValue = value;
+    }
+  }
+  return minValue;
+}
+async function getQueueSnapshot(ctx) {
+  const [pendingRows, inProgressRows, failedRows, succeededRows] = await Promise.all([
+    collectQueueByStatus(ctx, "pending"),
+    collectQueueByStatus(ctx, "in_progress"),
+    collectQueueByStatus(ctx, "failed"),
+    collectQueueByStatus(ctx, "succeeded")
+  ]);
+  const now = Date.now();
+  const backlogOldestCreatedAt = minTimestamp(
+    [...pendingRows, ...inProgressRows],
+    "createdAt"
+  );
+  const queueBacklogAgeMs = backlogOldestCreatedAt !== void 0 ? Math.max(0, now - backlogOldestCreatedAt) : 0;
+  const lastSuccessfulSyncAt = maxTimestamp(succeededRows, "updatedAt");
+  return {
+    now,
+    queuePendingCount: pendingRows.length,
+    queueInProgressCount: inProgressRows.length,
+    queueFailedCount: failedRows.length,
+    queueSucceededCount: succeededRows.length,
+    queueBacklogAgeMs,
+    backlogOldestCreatedAt,
+    lastSuccessfulSyncAt
+  };
+}
+function buildEndpointAssessments(snapshot) {
+  const analytics = evaluateProjectionStaleness({
+    endpointClass: "analytics",
+    queueBacklogAgeMs: snapshot.queueBacklogAgeMs,
+    queuePendingCount: snapshot.queuePendingCount + snapshot.queueInProgressCount,
+    queueFailedCount: snapshot.queueFailedCount,
+    nowMs: snapshot.now,
+    lastSuccessfulSyncAt: snapshot.lastSuccessfulSyncAt
+  });
+  const traversal = evaluateProjectionStaleness({
+    endpointClass: "traversal",
+    queueBacklogAgeMs: snapshot.queueBacklogAgeMs,
+    queuePendingCount: snapshot.queuePendingCount + snapshot.queueInProgressCount,
+    queueFailedCount: snapshot.queueFailedCount,
+    nowMs: snapshot.now,
+    lastSuccessfulSyncAt: snapshot.lastSuccessfulSyncAt
+  });
+  const entityRead = evaluateProjectionStaleness({
+    endpointClass: "entity_read",
+    queueBacklogAgeMs: snapshot.queueBacklogAgeMs,
+    queuePendingCount: snapshot.queuePendingCount + snapshot.queueInProgressCount,
+    queueFailedCount: snapshot.queueFailedCount,
+    nowMs: snapshot.now,
+    lastSuccessfulSyncAt: snapshot.lastSuccessfulSyncAt
+  });
+  const nonGraph = evaluateProjectionStaleness({
+    endpointClass: "non_graph",
+    queueBacklogAgeMs: snapshot.queueBacklogAgeMs,
+    queuePendingCount: snapshot.queuePendingCount + snapshot.queueInProgressCount,
+    queueFailedCount: snapshot.queueFailedCount,
+    nowMs: snapshot.now,
+    lastSuccessfulSyncAt: snapshot.lastSuccessfulSyncAt
+  });
+  return {
+    analytics,
+    traversal,
+    entityRead,
+    nonGraph
+  };
+}
+function assertAuthenticated(clerkId) {
+  if (!clerkId) {
+    throw new Error("Authentication required");
+  }
+  return clerkId;
+}
+var getProjectionReconciliationStatusInternal = internalQuery({
+  args: {},
+  returns: permissiveReturn,
+  handler: async (ctx) => {
+    const snapshot = await getQueueSnapshot(ctx);
+    const assessments = buildEndpointAssessments(snapshot);
+    return {
+      ...snapshot,
+      endpointAssessments: assessments,
+      generatedAt: snapshot.now
+    };
+  }
+});
+var getProjectionReconciliationStatus = query({
+  args: {},
+  returns: permissiveReturn,
+  handler: async (ctx) => {
+    assertAuthenticated(await getCurrentUserId(ctx));
+    const snapshot = await getQueueSnapshot(ctx);
+    const assessments = buildEndpointAssessments(snapshot);
+    return {
+      ...snapshot,
+      endpointAssessments: assessments,
+      generatedAt: snapshot.now
+    };
+  }
+});
+var assessProjectionStaleness = query({
+  args: {
+    endpointClass: v.union(
+      v.literal("analytics"),
+      v.literal("traversal"),
+      v.literal("entity_read"),
+      v.literal("non_graph")
+    )
+  },
+  returns: permissiveReturn,
+  handler: async (ctx, args) => {
+    assertAuthenticated(await getCurrentUserId(ctx));
+    const snapshot = await getQueueSnapshot(ctx);
+    const endpointClass = args.endpointClass;
+    return {
+      endpointClass,
+      assessment: evaluateProjectionStaleness({
+        endpointClass,
+        queueBacklogAgeMs: snapshot.queueBacklogAgeMs,
+        queuePendingCount: snapshot.queuePendingCount + snapshot.queueInProgressCount,
+        queueFailedCount: snapshot.queueFailedCount,
+        nowMs: snapshot.now,
+        lastSuccessfulSyncAt: snapshot.lastSuccessfulSyncAt
+      }),
+      snapshot
+    };
+  }
+});
+var runProjectionRepairCycle = internalAction({
+  args: {
+    limit: v.optional(v.number())
+  },
+  returns: permissiveReturn,
+  handler: async (ctx, args) => {
+    const processed = await ctx.runAction(
+      internal.neo4jSync.processRetryQueue,
+      {
+        limit: args.limit ?? 25
+      }
+    );
+    const status = await ctx.runQuery(
+      internal.projectionReconciliation.getProjectionReconciliationStatusInternal,
+      {}
+    );
+    return {
+      processed,
+      status,
+      runAt: Date.now()
+    };
+  }
+});
+
+export { assessProjectionStaleness, getProjectionReconciliationStatus, getProjectionReconciliationStatusInternal, runProjectionRepairCycle };
+//# sourceMappingURL=projectionReconciliation.js.map
+//# sourceMappingURL=projectionReconciliation.js.map

package/dist/projectionReconciliation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../access-control/src/auth.ts","../../schema-management/src/validators.ts","../src/convex.ts","../src/projectionStaleness.ts","../src/projectionReconciliation.ts"],"names":["v"],"mappings":"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","file":"projectionReconciliation.js","sourcesContent":["/**\n * auth module implementation.\n */\n\nimport type { ActionCtx, MutationCtx, QueryCtx } from \"./convex\";\n\ntype AnyCtx = QueryCtx | MutationCtx | ActionCtx;\n\n/**\n * Get the current user's identity from Clerk.\n */\nexport async function getCurrentUser(ctx: AnyCtx) {\n  const identity = await ctx.auth.getUserIdentity();\n  return identity;\n}\n\n/**\n * Get the current user ID (Clerk subject).\n */\nexport async function getCurrentUserId(ctx: AnyCtx): Promise<string | null> {\n  const identity = await ctx.auth.getUserIdentity();\n  return identity?.subject ?? null;\n}\n","/**\n * validators module implementation.\n */\n\nimport { v } from \"convex/values\";\n\n/**\n * Permissive return validator used while contracts are tightened.\n */\nexport const permissiveReturn: any = v.optional(v.any());\n\n/**\n * Shallow JSON validators for dynamic payloads.\n */\nexport const looseJsonObject = v.record(v.string(), v.any());\nexport const looseJsonArray = v.array(v.any());\nexport const looseJsonValue = v.union(\n  v.string(),\n  v.number(),\n  v.boolean(),\n  v.null(),\n  looseJsonObject,\n  looseJsonArray\n);\n","import {\n  actionGeneric,\n  anyApi,\n  componentsGeneric,\n  httpActionGeneric,\n  internalActionGeneric,\n  internalMutationGeneric,\n  internalQueryGeneric,\n  mutationGeneric,\n  queryGeneric,\n} from \"convex/server\";\nimport type { GenericId } from \"convex/values\";\n\nexport const api = anyApi as any;\nexport const components = componentsGeneric() as any;\nexport const internal = anyApi as any;\n\nexport type TableNames = string;\nexport type Id<TableName extends TableNames = string> = GenericId<TableName>;\nexport type Doc<TableName extends TableNames = string> = any;\nexport type DataModel = any;\nexport type ActionCtx = any;\nexport type DatabaseReader = any;\nexport type DatabaseWriter = any;\nexport type MutationCtx = any;\nexport type QueryCtx = any;\n\nexport const action = actionGeneric as any;\nexport const httpAction = httpActionGeneric as any;\nexport const internalAction = internalActionGeneric as any;\nexport const internalMutation = internalMutationGeneric as any;\nexport const internalQuery = internalQueryGeneric as any;\nexport const mutation = mutationGeneric as any;\nexport const query = queryGeneric as any;\n","/**\n * projectionStaleness module implementation.\n */\n\nexport type ProjectionEndpointClass =\n  | \"analytics\"\n  | \"traversal\"\n  | \"entity_read\"\n  | \"non_graph\";\n\nexport type ProjectionFallbackMode =\n  | \"fail_with_503\"\n  | \"degrade_to_convex_depth_limited\"\n  | \"fallback_to_convex_entity_read\"\n  | \"none\";\n\nexport type ProjectionStalenessPolicy = {\n  endpointClass: ProjectionEndpointClass;\n  thresholdMs: number;\n  fallbackMode: ProjectionFallbackMode;\n  nonOverridable: true;\n};\n\nexport type ProjectionStalenessInput = {\n  endpointClass: ProjectionEndpointClass;\n  queueBacklogAgeMs: number;\n  queuePendingCount: number;\n  queueFailedCount: number;\n  nowMs?: number;\n  lastSuccessfulSyncAt?: number;\n};\n\nexport type ProjectionStalenessEnvelope = {\n  endpointClass: ProjectionEndpointClass;\n  stalenessMs: number;\n  thresholdMs: number;\n  isStale: boolean;\n  fallbackMode: ProjectionFallbackMode;\n  queuePendingCount: number;\n  queueFailedCount: number;\n  evaluatedAt: number;\n  lastSuccessfulSyncAt?: number;\n  lastSuccessfulSyncAgeMs?: number;\n  reasonCode:\n    | \"PROJECTION_HEALTHY\"\n    | \"PROJECTION_STALE\"\n    | \"PROJECTION_STALE_WITH_FAILED_RETRIES\";\n};\n\nexport const PROJECTION_STALENESS_POLICIES: Record<\n  ProjectionEndpointClass,\n  ProjectionStalenessPolicy\n> = {\n  analytics: {\n    endpointClass: \"analytics\",\n    thresholdMs: 30_000,\n    fallbackMode: \"fail_with_503\",\n    nonOverridable: true,\n  },\n  traversal: {\n    endpointClass: \"traversal\",\n    thresholdMs: 60_000,\n    fallbackMode: \"degrade_to_convex_depth_limited\",\n    nonOverridable: true,\n  },\n  entity_read: {\n    endpointClass: \"entity_read\",\n    thresholdMs: 5 * 60_000,\n    fallbackMode: \"fallback_to_convex_entity_read\",\n    nonOverridable: true,\n  },\n  non_graph: {\n    endpointClass: \"non_graph\",\n    thresholdMs: Number.POSITIVE_INFINITY,\n    fallbackMode: \"none\",\n    nonOverridable: true,\n  },\n};\n\nexport function getProjectionStalenessPolicy(\n  endpointClass: ProjectionEndpointClass\n): ProjectionStalenessPolicy {\n  return PROJECTION_STALENESS_POLICIES[endpointClass];\n}\n\nexport function evaluateProjectionStaleness(\n  input: ProjectionStalenessInput\n): ProjectionStalenessEnvelope {\n  const policy = getProjectionStalenessPolicy(input.endpointClass);\n  const evaluatedAt = input.nowMs ?? Date.now();\n  const stalenessMs = Math.max(0, input.queueBacklogAgeMs);\n  const isStale = stalenessMs > policy.thresholdMs;\n  const lastSuccessfulSyncAgeMs =\n    input.lastSuccessfulSyncAt !== undefined\n      ? Math.max(0, evaluatedAt - input.lastSuccessfulSyncAt)\n      : undefined;\n\n  return {\n    endpointClass: input.endpointClass,\n    stalenessMs,\n    thresholdMs: policy.thresholdMs,\n    isStale,\n    fallbackMode: policy.fallbackMode,\n    queuePendingCount: input.queuePendingCount,\n    queueFailedCount: input.queueFailedCount,\n    evaluatedAt,\n    lastSuccessfulSyncAt: input.lastSuccessfulSyncAt,\n    lastSuccessfulSyncAgeMs,\n    reasonCode: isStale\n      ? input.queueFailedCount > 0\n        ? \"PROJECTION_STALE_WITH_FAILED_RETRIES\"\n        : \"PROJECTION_STALE\"\n      : \"PROJECTION_HEALTHY\",\n  };\n}\n\nexport function shouldFailClosedForProjection(\n  envelope: ProjectionStalenessEnvelope\n): boolean {\n  return envelope.isStale && envelope.fallbackMode === \"fail_with_503\";\n}\n","/**\n * Projection Reconciliation Runtime\n *\n * Phase 2 (WT-C) runtime hooks for Convex-authoritative / Neo4j-projected\n * reconciliation health and endpoint-class staleness evaluation.\n */\n\nimport { v } from \"convex/values\";\nimport { getCurrentUserId } from \"@lucern/access-control/auth\";\nimport { permissiveReturn } from \"@lucern/schema-management/validators\";\nimport { internal, internalAction, internalQuery, query } from \"./convex\";\nimport {\n  evaluateProjectionStaleness,\n  type ProjectionEndpointClass,\n} from \"./projectionStaleness\";\n\ntype QueueStatus = \"pending\" | \"in_progress\" | \"failed\" | \"succeeded\";\n\ntype QueueRow = {\n  status: QueueStatus;\n  createdAt: number;\n  updatedAt: number;\n};\n\nasync function collectQueueByStatus(\n  ctx: any,\n  status: QueueStatus\n): Promise<QueueRow[]> {\n  return await ctx.db\n    .query(\"neo4jSyncQueue\")\n    .withIndex(\"by_status\", (q: any) => q.eq(\"status\", status))\n    .collect();\n}\n\nfunction maxTimestamp(\n  rows: QueueRow[],\n  field: \"createdAt\" | \"updatedAt\"\n): number | undefined {\n  let maxValue: number | undefined;\n  for (const row of rows) {\n    const value = row[field];\n    if (!Number.isFinite(value)) {\n      continue;\n    }\n    if (maxValue === undefined || value > maxValue) {\n      maxValue = value;\n    }\n  }\n  return maxValue;\n}\n\nfunction minTimestamp(\n  rows: QueueRow[],\n  field: \"createdAt\" | \"updatedAt\"\n): number | undefined {\n  let minValue: number | undefined;\n  for (const row of rows) {\n    const value = row[field];\n    if (!Number.isFinite(value)) {\n      continue;\n    }\n    if (minValue === undefined || value < minValue) {\n      minValue = value;\n    }\n  }\n  return minValue;\n}\n\nasync function getQueueSnapshot(ctx: any) {\n  const [pendingRows, inProgressRows, failedRows, succeededRows] =\n    await Promise.all([\n      collectQueueByStatus(ctx, \"pending\"),\n      collectQueueByStatus(ctx, \"in_progress\"),\n      collectQueueByStatus(ctx, \"failed\"),\n      collectQueueByStatus(ctx, \"succeeded\"),\n    ]);\n\n  const now = Date.now();\n  const backlogOldestCreatedAt = minTimestamp(\n    [...pendingRows, ...inProgressRows],\n    \"createdAt\"\n  );\n  const queueBacklogAgeMs =\n    backlogOldestCreatedAt !== undefined\n      ? Math.max(0, now - backlogOldestCreatedAt)\n      : 0;\n  const lastSuccessfulSyncAt = maxTimestamp(succeededRows, \"updatedAt\");\n\n  return {\n    now,\n    queuePendingCount: pendingRows.length,\n    queueInProgressCount: inProgressRows.length,\n    queueFailedCount: failedRows.length,\n    queueSucceededCount: succeededRows.length,\n    queueBacklogAgeMs,\n    backlogOldestCreatedAt,\n    lastSuccessfulSyncAt,\n  };\n}\n\nfunction buildEndpointAssessments(\n  snapshot: Awaited<ReturnType<typeof getQueueSnapshot>>\n) {\n  const analytics = evaluateProjectionStaleness({\n    endpointClass: \"analytics\",\n    queueBacklogAgeMs: snapshot.queueBacklogAgeMs,\n    queuePendingCount:\n      snapshot.queuePendingCount + snapshot.queueInProgressCount,\n    queueFailedCount: snapshot.queueFailedCount,\n    nowMs: snapshot.now,\n    lastSuccessfulSyncAt: snapshot.lastSuccessfulSyncAt,\n  });\n  const traversal = evaluateProjectionStaleness({\n    endpointClass: \"traversal\",\n    queueBacklogAgeMs: snapshot.queueBacklogAgeMs,\n    queuePendingCount:\n      snapshot.queuePendingCount + snapshot.queueInProgressCount,\n    queueFailedCount: snapshot.queueFailedCount,\n    nowMs: snapshot.now,\n    lastSuccessfulSyncAt: snapshot.lastSuccessfulSyncAt,\n  });\n  const entityRead = evaluateProjectionStaleness({\n    endpointClass: \"entity_read\",\n    queueBacklogAgeMs: snapshot.queueBacklogAgeMs,\n    queuePendingCount:\n      snapshot.queuePendingCount + snapshot.queueInProgressCount,\n    queueFailedCount: snapshot.queueFailedCount,\n    nowMs: snapshot.now,\n    lastSuccessfulSyncAt: snapshot.lastSuccessfulSyncAt,\n  });\n  const nonGraph = evaluateProjectionStaleness({\n    endpointClass: \"non_graph\",\n    queueBacklogAgeMs: snapshot.queueBacklogAgeMs,\n    queuePendingCount:\n      snapshot.queuePendingCount + snapshot.queueInProgressCount,\n    queueFailedCount: snapshot.queueFailedCount,\n    nowMs: snapshot.now,\n    lastSuccessfulSyncAt: snapshot.lastSuccessfulSyncAt,\n  });\n\n  return {\n    analytics,\n    traversal,\n    entityRead,\n    nonGraph,\n  };\n}\n\nfunction assertAuthenticated(clerkId: string | null): string {\n  if (!clerkId) {\n    throw new Error(\"Authentication required\");\n  }\n  return clerkId;\n}\n\nexport const getProjectionReconciliationStatusInternal = internalQuery({\n  args: {},\n  returns: permissiveReturn,\n  handler: async (ctx) => {\n    const snapshot = await getQueueSnapshot(ctx);\n    const assessments = buildEndpointAssessments(snapshot);\n\n    return {\n      ...snapshot,\n      endpointAssessments: assessments,\n      generatedAt: snapshot.now,\n    };\n  },\n});\n\nexport const getProjectionReconciliationStatus = query({\n  args: {},\n  returns: permissiveReturn,\n  handler: async (ctx) => {\n    assertAuthenticated(await getCurrentUserId(ctx));\n    const snapshot = await getQueueSnapshot(ctx);\n    const assessments = buildEndpointAssessments(snapshot);\n\n    return {\n      ...snapshot,\n      endpointAssessments: assessments,\n      generatedAt: snapshot.now,\n    };\n  },\n});\n\nexport const assessProjectionStaleness = query({\n  args: {\n    endpointClass: v.union(\n      v.literal(\"analytics\"),\n      v.literal(\"traversal\"),\n      v.literal(\"entity_read\"),\n      v.literal(\"non_graph\")\n    ),\n  },\n  returns: permissiveReturn,\n  handler: async (ctx, args) => {\n    assertAuthenticated(await getCurrentUserId(ctx));\n    const snapshot = await getQueueSnapshot(ctx);\n    const endpointClass = args.endpointClass as ProjectionEndpointClass;\n\n    return {\n      endpointClass,\n      assessment: evaluateProjectionStaleness({\n        endpointClass,\n        queueBacklogAgeMs: snapshot.queueBacklogAgeMs,\n        queuePendingCount:\n          snapshot.queuePendingCount + snapshot.queueInProgressCount,\n        queueFailedCount: snapshot.queueFailedCount,\n        nowMs: snapshot.now,\n        lastSuccessfulSyncAt: snapshot.lastSuccessfulSyncAt,\n      }),\n      snapshot,\n    };\n  },\n});\n\nexport const runProjectionRepairCycle = internalAction({\n  args: {\n    limit: v.optional(v.number()),\n  },\n  returns: permissiveReturn,\n  handler: async (ctx, args) => {\n    const processed = await ctx.runAction(\n      internal.neo4jSync.processRetryQueue,\n      {\n        limit: args.limit ?? 25,\n      }\n    );\n    const status = await ctx.runQuery(\n      internal.projectionReconciliation\n        .getProjectionReconciliationStatusInternal,\n      {}\n    );\n\n    return {\n      processed,\n      status,\n      runAt: Date.now(),\n    };\n  },\n});\n"]}

package/dist/projectionStaleness-CAdpIsaW.d.ts

@@ -0,0 +1,51 @@
+/**
+ * projectionStaleness module implementation.
+ */
+type ProjectionEndpointClass = "analytics" | "traversal" | "entity_read" | "non_graph";
+type ProjectionFallbackMode = "fail_with_503" | "degrade_to_convex_depth_limited" | "fallback_to_convex_entity_read" | "none";
+type ProjectionStalenessPolicy = {
+    endpointClass: ProjectionEndpointClass;
+    thresholdMs: number;
+    fallbackMode: ProjectionFallbackMode;
+    nonOverridable: true;
+};
+type ProjectionStalenessInput = {
+    endpointClass: ProjectionEndpointClass;
+    queueBacklogAgeMs: number;
+    queuePendingCount: number;
+    queueFailedCount: number;
+    nowMs?: number;
+    lastSuccessfulSyncAt?: number;
+};
+type ProjectionStalenessEnvelope = {
+    endpointClass: ProjectionEndpointClass;
+    stalenessMs: number;
+    thresholdMs: number;
+    isStale: boolean;
+    fallbackMode: ProjectionFallbackMode;
+    queuePendingCount: number;
+    queueFailedCount: number;
+    evaluatedAt: number;
+    lastSuccessfulSyncAt?: number;
+    lastSuccessfulSyncAgeMs?: number;
+    reasonCode: "PROJECTION_HEALTHY" | "PROJECTION_STALE" | "PROJECTION_STALE_WITH_FAILED_RETRIES";
+};
+declare const PROJECTION_STALENESS_POLICIES: Record<ProjectionEndpointClass, ProjectionStalenessPolicy>;
+declare function getProjectionStalenessPolicy(endpointClass: ProjectionEndpointClass): ProjectionStalenessPolicy;
+declare function evaluateProjectionStaleness(input: ProjectionStalenessInput): ProjectionStalenessEnvelope;
+declare function shouldFailClosedForProjection(envelope: ProjectionStalenessEnvelope): boolean;
+
+declare const projectionStaleness_PROJECTION_STALENESS_POLICIES: typeof PROJECTION_STALENESS_POLICIES;
+type projectionStaleness_ProjectionEndpointClass = ProjectionEndpointClass;
+type projectionStaleness_ProjectionFallbackMode = ProjectionFallbackMode;
+type projectionStaleness_ProjectionStalenessEnvelope = ProjectionStalenessEnvelope;
+type projectionStaleness_ProjectionStalenessInput = ProjectionStalenessInput;
+type projectionStaleness_ProjectionStalenessPolicy = ProjectionStalenessPolicy;
+declare const projectionStaleness_evaluateProjectionStaleness: typeof evaluateProjectionStaleness;
+declare const projectionStaleness_getProjectionStalenessPolicy: typeof getProjectionStalenessPolicy;
+declare const projectionStaleness_shouldFailClosedForProjection: typeof shouldFailClosedForProjection;
+declare namespace projectionStaleness {
+  export { projectionStaleness_PROJECTION_STALENESS_POLICIES as PROJECTION_STALENESS_POLICIES, type projectionStaleness_ProjectionEndpointClass as ProjectionEndpointClass, type projectionStaleness_ProjectionFallbackMode as ProjectionFallbackMode, type projectionStaleness_ProjectionStalenessEnvelope as ProjectionStalenessEnvelope, type projectionStaleness_ProjectionStalenessInput as ProjectionStalenessInput, type projectionStaleness_ProjectionStalenessPolicy as ProjectionStalenessPolicy, projectionStaleness_evaluateProjectionStaleness as evaluateProjectionStaleness, projectionStaleness_getProjectionStalenessPolicy as getProjectionStalenessPolicy, projectionStaleness_shouldFailClosedForProjection as shouldFailClosedForProjection };
+}
+
+export { type ProjectionEndpointClass as P, type ProjectionFallbackMode as a, type ProjectionStalenessPolicy as b, type ProjectionStalenessInput as c, type ProjectionStalenessEnvelope as d, PROJECTION_STALENESS_POLICIES as e, evaluateProjectionStaleness as f, getProjectionStalenessPolicy as g, projectionStaleness as p, shouldFailClosedForProjection as s };

package/dist/projectionStaleness.d.ts

@@ -0,0 +1 @@
+export { e as PROJECTION_STALENESS_POLICIES, P as ProjectionEndpointClass, a as ProjectionFallbackMode, d as ProjectionStalenessEnvelope, c as ProjectionStalenessInput, b as ProjectionStalenessPolicy, f as evaluateProjectionStaleness, g as getProjectionStalenessPolicy, s as shouldFailClosedForProjection } from './projectionStaleness-CAdpIsaW.js';

package/dist/projectionStaleness.js

@@ -0,0 +1,57 @@
+// src/projectionStaleness.ts
+var PROJECTION_STALENESS_POLICIES = {
+  analytics: {
+    endpointClass: "analytics",
+    thresholdMs: 3e4,
+    fallbackMode: "fail_with_503",
+    nonOverridable: true
+  },
+  traversal: {
+    endpointClass: "traversal",
+    thresholdMs: 6e4,
+    fallbackMode: "degrade_to_convex_depth_limited",
+    nonOverridable: true
+  },
+  entity_read: {
+    endpointClass: "entity_read",
+    thresholdMs: 5 * 6e4,
+    fallbackMode: "fallback_to_convex_entity_read",
+    nonOverridable: true
+  },
+  non_graph: {
+    endpointClass: "non_graph",
+    thresholdMs: Number.POSITIVE_INFINITY,
+    fallbackMode: "none",
+    nonOverridable: true
+  }
+};
+function getProjectionStalenessPolicy(endpointClass) {
+  return PROJECTION_STALENESS_POLICIES[endpointClass];
+}
+function evaluateProjectionStaleness(input) {
+  const policy = getProjectionStalenessPolicy(input.endpointClass);
+  const evaluatedAt = input.nowMs ?? Date.now();
+  const stalenessMs = Math.max(0, input.queueBacklogAgeMs);
+  const isStale = stalenessMs > policy.thresholdMs;
+  const lastSuccessfulSyncAgeMs = input.lastSuccessfulSyncAt !== void 0 ? Math.max(0, evaluatedAt - input.lastSuccessfulSyncAt) : void 0;
+  return {
+    endpointClass: input.endpointClass,
+    stalenessMs,
+    thresholdMs: policy.thresholdMs,
+    isStale,
+    fallbackMode: policy.fallbackMode,
+    queuePendingCount: input.queuePendingCount,
+    queueFailedCount: input.queueFailedCount,
+    evaluatedAt,
+    lastSuccessfulSyncAt: input.lastSuccessfulSyncAt,
+    lastSuccessfulSyncAgeMs,
+    reasonCode: isStale ? input.queueFailedCount > 0 ? "PROJECTION_STALE_WITH_FAILED_RETRIES" : "PROJECTION_STALE" : "PROJECTION_HEALTHY"
+  };
+}
+function shouldFailClosedForProjection(envelope) {
+  return envelope.isStale && envelope.fallbackMode === "fail_with_503";
+}
+
+export { PROJECTION_STALENESS_POLICIES, evaluateProjectionStaleness, getProjectionStalenessPolicy, shouldFailClosedForProjection };
+//# sourceMappingURL=projectionStaleness.js.map
+//# sourceMappingURL=projectionStaleness.js.map

package/dist/projectionStaleness.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/projectionStaleness.ts"],"names":[],"mappings":";AAiDO,IAAM,6BAAA,GAGT;AAAA,EACF,SAAA,EAAW;AAAA,IACT,aAAA,EAAe,WAAA;AAAA,IACf,WAAA,EAAa,GAAA;AAAA,IACb,YAAA,EAAc,eAAA;AAAA,IACd,cAAA,EAAgB;AAAA,GAClB;AAAA,EACA,SAAA,EAAW;AAAA,IACT,aAAA,EAAe,WAAA;AAAA,IACf,WAAA,EAAa,GAAA;AAAA,IACb,YAAA,EAAc,iCAAA;AAAA,IACd,cAAA,EAAgB;AAAA,GAClB;AAAA,EACA,WAAA,EAAa;AAAA,IACX,aAAA,EAAe,aAAA;AAAA,IACf,aAAa,CAAA,GAAI,GAAA;AAAA,IACjB,YAAA,EAAc,gCAAA;AAAA,IACd,cAAA,EAAgB;AAAA,GAClB;AAAA,EACA,SAAA,EAAW;AAAA,IACT,aAAA,EAAe,WAAA;AAAA,IACf,aAAa,MAAA,CAAO,iBAAA;AAAA,IACpB,YAAA,EAAc,MAAA;AAAA,IACd,cAAA,EAAgB;AAAA;AAEpB;AAEO,SAAS,6BACd,aAAA,EAC2B;AAC3B,EAAA,OAAO,8BAA8B,aAAa,CAAA;AACpD;AAEO,SAAS,4BACd,KAAA,EAC6B;AAC7B,EAAA,MAAM,MAAA,GAAS,4BAAA,CAA6B,KAAA,CAAM,aAAa,CAAA;AAC/D,EAAA,MAAM,WAAA,GAAc,KAAA,CAAM,KAAA,IAAS,IAAA,CAAK,GAAA,EAAI;AAC5C,EAAA,MAAM,WAAA,GAAc,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,MAAM,iBAAiB,CAAA;AACvD,EAAA,MAAM,OAAA,GAAU,cAAc,MAAA,CAAO,WAAA;AACrC,EAAA,MAAM,uBAAA,GACJ,KAAA,CAAM,oBAAA,KAAyB,MAAA,GAC3B,IAAA,CAAK,IAAI,CAAA,EAAG,WAAA,GAAc,KAAA,CAAM,oBAAoB,CAAA,GACpD,MAAA;AAEN,EAAA,OAAO;AAAA,IACL,eAAe,KAAA,CAAM,aAAA;AAAA,IACrB,WAAA;AAAA,IACA,aAAa,MAAA,CAAO,WAAA;AAAA,IACpB,OAAA;AAAA,IACA,cAAc,MAAA,CAAO,YAAA;AAAA,IACrB,mBAAmB,KAAA,CAAM,iBAAA;AAAA,IACzB,kBAAkB,KAAA,CAAM,gBAAA;AAAA,IACxB,WAAA;AAAA,IACA,sBAAsB,KAAA,CAAM,oBAAA;AAAA,IAC5B,uBAAA;AAAA,IACA,YAAY,OAAA,GACR,KAAA,CAAM,gBAAA,GAAmB,CAAA,GACvB,yCACA,kBAAA,GACF;AAAA,GACN;AACF;AAEO,SAAS,8BACd,QAAA,EACS;AACT,EAAA,OAAO,QAAA,CAAS,OAAA,IAAW,QAAA,CAAS,YAAA,KAAiB,eAAA;AACvD","file":"projectionStaleness.js","sourcesContent":["/**\n * projectionStaleness module implementation.\n */\n\nexport type ProjectionEndpointClass =\n  | \"analytics\"\n  | \"traversal\"\n  | \"entity_read\"\n  | \"non_graph\";\n\nexport type ProjectionFallbackMode =\n  | \"fail_with_503\"\n  | \"degrade_to_convex_depth_limited\"\n  | \"fallback_to_convex_entity_read\"\n  | \"none\";\n\nexport type ProjectionStalenessPolicy = {\n  endpointClass: ProjectionEndpointClass;\n  thresholdMs: number;\n  fallbackMode: ProjectionFallbackMode;\n  nonOverridable: true;\n};\n\nexport type ProjectionStalenessInput = {\n  endpointClass: ProjectionEndpointClass;\n  queueBacklogAgeMs: number;\n  queuePendingCount: number;\n  queueFailedCount: number;\n  nowMs?: number;\n  lastSuccessfulSyncAt?: number;\n};\n\nexport type ProjectionStalenessEnvelope = {\n  endpointClass: ProjectionEndpointClass;\n  stalenessMs: number;\n  thresholdMs: number;\n  isStale: boolean;\n  fallbackMode: ProjectionFallbackMode;\n  queuePendingCount: number;\n  queueFailedCount: number;\n  evaluatedAt: number;\n  lastSuccessfulSyncAt?: number;\n  lastSuccessfulSyncAgeMs?: number;\n  reasonCode:\n    | \"PROJECTION_HEALTHY\"\n    | \"PROJECTION_STALE\"\n    | \"PROJECTION_STALE_WITH_FAILED_RETRIES\";\n};\n\nexport const PROJECTION_STALENESS_POLICIES: Record<\n  ProjectionEndpointClass,\n  ProjectionStalenessPolicy\n> = {\n  analytics: {\n    endpointClass: \"analytics\",\n    thresholdMs: 30_000,\n    fallbackMode: \"fail_with_503\",\n    nonOverridable: true,\n  },\n  traversal: {\n    endpointClass: \"traversal\",\n    thresholdMs: 60_000,\n    fallbackMode: \"degrade_to_convex_depth_limited\",\n    nonOverridable: true,\n  },\n  entity_read: {\n    endpointClass: \"entity_read\",\n    thresholdMs: 5 * 60_000,\n    fallbackMode: \"fallback_to_convex_entity_read\",\n    nonOverridable: true,\n  },\n  non_graph: {\n    endpointClass: \"non_graph\",\n    thresholdMs: Number.POSITIVE_INFINITY,\n    fallbackMode: \"none\",\n    nonOverridable: true,\n  },\n};\n\nexport function getProjectionStalenessPolicy(\n  endpointClass: ProjectionEndpointClass\n): ProjectionStalenessPolicy {\n  return PROJECTION_STALENESS_POLICIES[endpointClass];\n}\n\nexport function evaluateProjectionStaleness(\n  input: ProjectionStalenessInput\n): ProjectionStalenessEnvelope {\n  const policy = getProjectionStalenessPolicy(input.endpointClass);\n  const evaluatedAt = input.nowMs ?? Date.now();\n  const stalenessMs = Math.max(0, input.queueBacklogAgeMs);\n  const isStale = stalenessMs > policy.thresholdMs;\n  const lastSuccessfulSyncAgeMs =\n    input.lastSuccessfulSyncAt !== undefined\n      ? Math.max(0, evaluatedAt - input.lastSuccessfulSyncAt)\n      : undefined;\n\n  return {\n    endpointClass: input.endpointClass,\n    stalenessMs,\n    thresholdMs: policy.thresholdMs,\n    isStale,\n    fallbackMode: policy.fallbackMode,\n    queuePendingCount: input.queuePendingCount,\n    queueFailedCount: input.queueFailedCount,\n    evaluatedAt,\n    lastSuccessfulSyncAt: input.lastSuccessfulSyncAt,\n    lastSuccessfulSyncAgeMs,\n    reasonCode: isStale\n      ? input.queueFailedCount > 0\n        ? \"PROJECTION_STALE_WITH_FAILED_RETRIES\"\n        : \"PROJECTION_STALE\"\n      : \"PROJECTION_HEALTHY\",\n  };\n}\n\nexport function shouldFailClosedForProjection(\n  envelope: ProjectionStalenessEnvelope\n): boolean {\n  return envelope.isStale && envelope.fallbackMode === \"fail_with_503\";\n}\n"]}

package/dist/questionEvidenceLinks-BdQD0TkM.d.ts

@@ -0,0 +1,34 @@
+/**
+ * questionEvidenceLinks module implementation.
+ */
+/**
+ * Question Evidence Links Management
+ *
+ * Links evidence (insights) to questions to track what evidence helps answer which questions.
+ */
+declare const create: any;
+declare const updateImpact: any;
+declare const reviewSuggestion: any;
+declare const remove: any;
+declare const getByQuestion: any;
+declare const getPendingSuggestions: any;
+declare const getByInsight: any;
+declare const getEvidenceWithDetails: any;
+declare const getByProject: any;
+declare const getLinkedQuestionsForInsight: any;
+
+declare const questionEvidenceLinks_create: typeof create;
+declare const questionEvidenceLinks_getByInsight: typeof getByInsight;
+declare const questionEvidenceLinks_getByProject: typeof getByProject;
+declare const questionEvidenceLinks_getByQuestion: typeof getByQuestion;
+declare const questionEvidenceLinks_getEvidenceWithDetails: typeof getEvidenceWithDetails;
+declare const questionEvidenceLinks_getLinkedQuestionsForInsight: typeof getLinkedQuestionsForInsight;
+declare const questionEvidenceLinks_getPendingSuggestions: typeof getPendingSuggestions;
+declare const questionEvidenceLinks_remove: typeof remove;
+declare const questionEvidenceLinks_reviewSuggestion: typeof reviewSuggestion;
+declare const questionEvidenceLinks_updateImpact: typeof updateImpact;
+declare namespace questionEvidenceLinks {
+  export { questionEvidenceLinks_create as create, questionEvidenceLinks_getByInsight as getByInsight, questionEvidenceLinks_getByProject as getByProject, questionEvidenceLinks_getByQuestion as getByQuestion, questionEvidenceLinks_getEvidenceWithDetails as getEvidenceWithDetails, questionEvidenceLinks_getLinkedQuestionsForInsight as getLinkedQuestionsForInsight, questionEvidenceLinks_getPendingSuggestions as getPendingSuggestions, questionEvidenceLinks_remove as remove, questionEvidenceLinks_reviewSuggestion as reviewSuggestion, questionEvidenceLinks_updateImpact as updateImpact };
+}
+
+export { remove as a, getPendingSuggestions as b, create as c, getByInsight as d, getEvidenceWithDetails as e, getByProject as f, getByQuestion as g, getLinkedQuestionsForInsight as h, questionEvidenceLinks as q, reviewSuggestion as r, updateImpact as u };

package/dist/questionEvidenceLinks.d.ts

@@ -0,0 +1 @@
+export { c as create, d as getByInsight, f as getByProject, g as getByQuestion, e as getEvidenceWithDetails, h as getLinkedQuestionsForInsight, b as getPendingSuggestions, a as remove, r as reviewSuggestion, u as updateImpact } from './questionEvidenceLinks-BdQD0TkM.js';