@lucern/graph-primitives 0.3.0-alpha.0 → 0.3.0-alpha.10

package/dist/projectionReconciliation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../access-control/src/auth.ts","../../../packages/contracts/src/schema-helpers/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","import { v } from \"convex/values\";\n\nexport const permissiveReturn = v.optional(v.any());\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/contracts/schema-helpers/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"]}
+{"version":3,"sources":["../src/convex.ts","../src/projectionStaleness.ts","../src/projectionReconciliation.ts"],"names":[],"mappings":"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","file":"projectionReconciliation.js","sourcesContent":["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/contracts/schema-helpers/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\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      ctx.db\n        .query(\"neo4jSyncQueue\")\n        .withIndex(\"by_status\", (q: any) => q.eq(\"status\", \"pending\"))\n        .collect() as Promise<QueueRow[]>,\n      ctx.db\n        .query(\"neo4jSyncQueue\")\n        .withIndex(\"by_status\", (q: any) => q.eq(\"status\", \"in_progress\"))\n        .collect() as Promise<QueueRow[]>,\n      ctx.db\n        .query(\"neo4jSyncQueue\")\n        .withIndex(\"by_status\", (q: any) => q.eq(\"status\", \"failed\"))\n        .collect() as Promise<QueueRow[]>,\n      ctx.db\n        .query(\"neo4jSyncQueue\")\n        .withIndex(\"by_status\", (q: any) => q.eq(\"status\", \"succeeded\"))\n        .collect() as Promise<QueueRow[]>,\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 buildProjectionReconciliationStatus(\n  snapshot: Awaited<ReturnType<typeof getQueueSnapshot>>\n) {\n  return {\n    ...snapshot,\n    endpointAssessments: buildEndpointAssessments(snapshot),\n    generatedAt: snapshot.now,\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    return buildProjectionReconciliationStatus(snapshot);\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    return buildProjectionReconciliationStatus(snapshot);\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 → projectionStaleness-CmdbpjVK.d.ts}

@@ -48,4 +48,4 @@ 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 };
+export { PROJECTION_STALENESS_POLICIES as P, type ProjectionEndpointClass as a, type ProjectionFallbackMode as b, type ProjectionStalenessEnvelope as c, type ProjectionStalenessInput as d, type ProjectionStalenessPolicy as e, evaluateProjectionStaleness as f, getProjectionStalenessPolicy as g, projectionStaleness as p, shouldFailClosedForProjection as s };

package/dist/projectionStaleness.d.ts

@@ -1 +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';
+export { P as PROJECTION_STALENESS_POLICIES, a as ProjectionEndpointClass, b as ProjectionFallbackMode, c as ProjectionStalenessEnvelope, d as ProjectionStalenessInput, e as ProjectionStalenessPolicy, f as evaluateProjectionStaleness, g as getProjectionStalenessPolicy, s as shouldFailClosedForProjection } from './projectionStaleness-CmdbpjVK.js';

package/dist/{questionEvidenceLinks-BdQD0TkM.d.ts → questionEvidenceLinks-DFlyPpAj.d.ts}

@@ -31,4 +31,4 @@ 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 };
+export { getByProject as a, getByQuestion as b, create as c, getEvidenceWithDetails as d, getLinkedQuestionsForInsight as e, getPendingSuggestions as f, getByInsight as g, reviewSuggestion as h, questionEvidenceLinks as q, remove as r, updateImpact as u };

package/dist/questionEvidenceLinks.d.ts

@@ -1 +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';
+export { c as create, g as getByInsight, a as getByProject, b as getByQuestion, d as getEvidenceWithDetails, e as getLinkedQuestionsForInsight, f as getPendingSuggestions, r as remove, h as reviewSuggestion, u as updateImpact } from './questionEvidenceLinks-DFlyPpAj.js';