@lucern/contracts 1.0.56 → 1.0.58

package/CHANGELOG.md

@@ -182,5 +182,8 @@ All notable changes to `@lucern/contracts` are tracked in this repository.
 ## [1.0.55] - 2026-06-30
 - Release notes pending.
 
-## [1.0.56] - 2026-07-02
+## [1.0.57] - 2026-07-03
+- Release notes pending.
+
+## [1.0.58] - 2026-07-03
 - Release notes pending.

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2024 Vercel, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/dist/component-boundary.contract.js

@@ -33,6 +33,7 @@ var TABLE_OWNERSHIP = {
   "deliberationContributions": "K",
   "deliberationSessions": "K",
   "deploymentHosts": "L",
+  "domainEventForwardCheckpoints": "K",
   "domainEvents": "K",
   "epistemicAudit": "K",
   "epistemicContracts": "K",

package/dist/generated/convexSchemas.d.ts

@@ -1168,6 +1168,25 @@ export declare const KERNEL_SCHEMA_TABLES: {
         by_topic_status: ["topicId", "status", "_creationTime"];
         by_createdBy: ["createdBy", "_creationTime"];
     }, {}, {}>;
+    domainEventForwardCheckpoints: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        lastError?: string | undefined;
+        lastStatus?: "ok" | "empty" | "export_failed" | undefined;
+        updatedAt: number;
+        sink: string;
+        lastForwardedTimestamp: number;
+        lastForwardedEventId: string;
+        forwardedCount: number;
+    }, {
+        forwardedCount: import("convex/values").VFloat64<number, "required">;
+        lastError: import("convex/values").VString<string | undefined, "optional">;
+        lastForwardedEventId: import("convex/values").VString<string, "required">;
+        lastForwardedTimestamp: import("convex/values").VFloat64<number, "required">;
+        lastStatus: import("convex/values").VUnion<"ok" | "empty" | "export_failed" | undefined, [import("convex/values").VLiteral<"ok", "required">, import("convex/values").VLiteral<"empty", "required">, import("convex/values").VLiteral<"export_failed", "required">], "optional", never>;
+        sink: import("convex/values").VString<string, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "updatedAt" | "lastError" | "sink" | "lastForwardedTimestamp" | "lastForwardedEventId" | "forwardedCount" | "lastStatus">, {
+        by_sink: ["sink", "_creationTime"];
+    }, {}, {}>;
     domainEvents: import("convex/server").TableDefinition<import("convex/values").VObject<{
         tenantId?: string | undefined;
         workspaceId?: string | undefined;
@@ -1204,6 +1223,7 @@ export declare const KERNEL_SCHEMA_TABLES: {
         by_tenant_workspace_timestamp: ["tenantId", "workspaceId", "timestamp", "_creationTime"];
         by_type_timestamp: ["type", "timestamp", "_creationTime"];
         by_resource: ["resourceType", "resourceId", "timestamp", "_creationTime"];
+        by_timestamp: ["timestamp", "_creationTime"];
         by_expiresAt: ["expiresAt", "_creationTime"];
     }, {}, {}>;
     epistemicAudit: import("convex/server").TableDefinition<import("convex/values").VObject<{
@@ -11710,6 +11730,25 @@ export declare const KERNEL_TIER_SCHEMA_TABLES: {
         by_topic_status: ["topicId", "status", "_creationTime"];
         by_createdBy: ["createdBy", "_creationTime"];
     }, {}, {}>;
+    domainEventForwardCheckpoints: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        lastError?: string | undefined;
+        lastStatus?: "ok" | "empty" | "export_failed" | undefined;
+        updatedAt: number;
+        sink: string;
+        lastForwardedTimestamp: number;
+        lastForwardedEventId: string;
+        forwardedCount: number;
+    }, {
+        forwardedCount: import("convex/values").VFloat64<number, "required">;
+        lastError: import("convex/values").VString<string | undefined, "optional">;
+        lastForwardedEventId: import("convex/values").VString<string, "required">;
+        lastForwardedTimestamp: import("convex/values").VFloat64<number, "required">;
+        lastStatus: import("convex/values").VUnion<"ok" | "empty" | "export_failed" | undefined, [import("convex/values").VLiteral<"ok", "required">, import("convex/values").VLiteral<"empty", "required">, import("convex/values").VLiteral<"export_failed", "required">], "optional", never>;
+        sink: import("convex/values").VString<string, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "updatedAt" | "lastError" | "sink" | "lastForwardedTimestamp" | "lastForwardedEventId" | "forwardedCount" | "lastStatus">, {
+        by_sink: ["sink", "_creationTime"];
+    }, {}, {}>;
     domainEvents: import("convex/server").TableDefinition<import("convex/values").VObject<{
         tenantId?: string | undefined;
         workspaceId?: string | undefined;
@@ -11746,6 +11785,7 @@ export declare const KERNEL_TIER_SCHEMA_TABLES: {
         by_tenant_workspace_timestamp: ["tenantId", "workspaceId", "timestamp", "_creationTime"];
         by_type_timestamp: ["type", "timestamp", "_creationTime"];
         by_resource: ["resourceType", "resourceId", "timestamp", "_creationTime"];
+        by_timestamp: ["timestamp", "_creationTime"];
         by_expiresAt: ["expiresAt", "_creationTime"];
     }, {}, {}>;
     epistemicAudit: import("convex/server").TableDefinition<import("convex/values").VObject<{
@@ -18465,6 +18505,25 @@ export declare const STACK_TIER_SCHEMA_TABLES: {
         by_topic_status: ["topicId", "status", "_creationTime"];
         by_createdBy: ["createdBy", "_creationTime"];
     }, {}, {}>;
+    domainEventForwardCheckpoints: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        lastError?: string | undefined;
+        lastStatus?: "ok" | "empty" | "export_failed" | undefined;
+        updatedAt: number;
+        sink: string;
+        lastForwardedTimestamp: number;
+        lastForwardedEventId: string;
+        forwardedCount: number;
+    }, {
+        forwardedCount: import("convex/values").VFloat64<number, "required">;
+        lastError: import("convex/values").VString<string | undefined, "optional">;
+        lastForwardedEventId: import("convex/values").VString<string, "required">;
+        lastForwardedTimestamp: import("convex/values").VFloat64<number, "required">;
+        lastStatus: import("convex/values").VUnion<"ok" | "empty" | "export_failed" | undefined, [import("convex/values").VLiteral<"ok", "required">, import("convex/values").VLiteral<"empty", "required">, import("convex/values").VLiteral<"export_failed", "required">], "optional", never>;
+        sink: import("convex/values").VString<string, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "updatedAt" | "lastError" | "sink" | "lastForwardedTimestamp" | "lastForwardedEventId" | "forwardedCount" | "lastStatus">, {
+        by_sink: ["sink", "_creationTime"];
+    }, {}, {}>;
     domainEvents: import("convex/server").TableDefinition<import("convex/values").VObject<{
         tenantId?: string | undefined;
         workspaceId?: string | undefined;
@@ -18501,6 +18560,7 @@ export declare const STACK_TIER_SCHEMA_TABLES: {
         by_tenant_workspace_timestamp: ["tenantId", "workspaceId", "timestamp", "_creationTime"];
         by_type_timestamp: ["type", "timestamp", "_creationTime"];
         by_resource: ["resourceType", "resourceId", "timestamp", "_creationTime"];
+        by_timestamp: ["timestamp", "_creationTime"];
         by_expiresAt: ["expiresAt", "_creationTime"];
     }, {}, {}>;
     epistemicAudit: import("convex/server").TableDefinition<import("convex/values").VObject<{
@@ -25848,6 +25908,25 @@ export declare const FULL_TIER_SCHEMA_TABLES: {
         by_topic_status: ["topicId", "status", "_creationTime"];
         by_createdBy: ["createdBy", "_creationTime"];
     }, {}, {}>;
+    domainEventForwardCheckpoints: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        lastError?: string | undefined;
+        lastStatus?: "ok" | "empty" | "export_failed" | undefined;
+        updatedAt: number;
+        sink: string;
+        lastForwardedTimestamp: number;
+        lastForwardedEventId: string;
+        forwardedCount: number;
+    }, {
+        forwardedCount: import("convex/values").VFloat64<number, "required">;
+        lastError: import("convex/values").VString<string | undefined, "optional">;
+        lastForwardedEventId: import("convex/values").VString<string, "required">;
+        lastForwardedTimestamp: import("convex/values").VFloat64<number, "required">;
+        lastStatus: import("convex/values").VUnion<"ok" | "empty" | "export_failed" | undefined, [import("convex/values").VLiteral<"ok", "required">, import("convex/values").VLiteral<"empty", "required">, import("convex/values").VLiteral<"export_failed", "required">], "optional", never>;
+        sink: import("convex/values").VString<string, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "updatedAt" | "lastError" | "sink" | "lastForwardedTimestamp" | "lastForwardedEventId" | "forwardedCount" | "lastStatus">, {
+        by_sink: ["sink", "_creationTime"];
+    }, {}, {}>;
     domainEvents: import("convex/server").TableDefinition<import("convex/values").VObject<{
         tenantId?: string | undefined;
         workspaceId?: string | undefined;
@@ -25884,6 +25963,7 @@ export declare const FULL_TIER_SCHEMA_TABLES: {
         by_tenant_workspace_timestamp: ["tenantId", "workspaceId", "timestamp", "_creationTime"];
         by_type_timestamp: ["type", "timestamp", "_creationTime"];
         by_resource: ["resourceType", "resourceId", "timestamp", "_creationTime"];
+        by_timestamp: ["timestamp", "_creationTime"];
         by_expiresAt: ["expiresAt", "_creationTime"];
     }, {}, {}>;
     epistemicAudit: import("convex/server").TableDefinition<import("convex/values").VObject<{
@@ -34806,6 +34886,25 @@ declare const _default: import("convex/server").SchemaDefinition<{
         by_topic_status: ["topicId", "status", "_creationTime"];
         by_createdBy: ["createdBy", "_creationTime"];
     }, {}, {}>;
+    domainEventForwardCheckpoints: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        lastError?: string | undefined;
+        lastStatus?: "ok" | "empty" | "export_failed" | undefined;
+        updatedAt: number;
+        sink: string;
+        lastForwardedTimestamp: number;
+        lastForwardedEventId: string;
+        forwardedCount: number;
+    }, {
+        forwardedCount: import("convex/values").VFloat64<number, "required">;
+        lastError: import("convex/values").VString<string | undefined, "optional">;
+        lastForwardedEventId: import("convex/values").VString<string, "required">;
+        lastForwardedTimestamp: import("convex/values").VFloat64<number, "required">;
+        lastStatus: import("convex/values").VUnion<"ok" | "empty" | "export_failed" | undefined, [import("convex/values").VLiteral<"ok", "required">, import("convex/values").VLiteral<"empty", "required">, import("convex/values").VLiteral<"export_failed", "required">], "optional", never>;
+        sink: import("convex/values").VString<string, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "updatedAt" | "lastError" | "sink" | "lastForwardedTimestamp" | "lastForwardedEventId" | "forwardedCount" | "lastStatus">, {
+        by_sink: ["sink", "_creationTime"];
+    }, {}, {}>;
     domainEvents: import("convex/server").TableDefinition<import("convex/values").VObject<{
         tenantId?: string | undefined;
         workspaceId?: string | undefined;
@@ -34842,6 +34941,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         by_tenant_workspace_timestamp: ["tenantId", "workspaceId", "timestamp", "_creationTime"];
         by_type_timestamp: ["type", "timestamp", "_creationTime"];
         by_resource: ["resourceType", "resourceId", "timestamp", "_creationTime"];
+        by_timestamp: ["timestamp", "_creationTime"];
         by_expiresAt: ["expiresAt", "_creationTime"];
     }, {}, {}>;
     epistemicAudit: import("convex/server").TableDefinition<import("convex/values").VObject<{

package/dist/generated/convexSchemas.js

@@ -24,7 +24,8 @@ var KERNEL_SCHEMA_TABLES = {
   "decisionSnapshots": defineTable(v.object({ "anonymizationClass": v.optional(v.union(v.literal("none"), v.literal("standard"), v.literal("strict"))), "audienceLabel": v.optional(v.string()), "createdAt": v.number(), "decisionEventId": v.id("decisionEvents"), "exportClass": v.optional(v.union(v.literal("public_safe"), v.literal("client_safe"), v.literal("internal_only"))), "lineageParentDecisionEventId": v.optional(v.id("decisionEvents")), "lineageParentSnapshotId": v.optional(v.id("decisionSnapshots")), "lockedAt": v.number(), "lockedBy": v.string(), "metadata": v.optional(v.record(v.string(), v.any())), "outcome": v.optional(v.union(v.literal("approve"), v.literal("conditional"), v.literal("defer"), v.literal("reject"), v.literal("reopen_on_trigger"))), "ownerPrincipalId": v.optional(v.string()), "payload": v.record(v.string(), v.any()), "payloadHash": v.string(), "policyTags": v.optional(v.array(v.string())), "policyTraceId": v.optional(v.string()), "sensitivityTier": v.optional(v.union(v.literal("low"), v.literal("medium"), v.literal("high"))), "snapshotLabel": v.optional(v.string()), "tenantId": v.optional(v.string()), "topicId": v.optional(v.string()), "version": v.number(), "weightingModelVersion": v.string(), "weightingParameters": v.optional(v.record(v.string(), v.any())), "workspaceId": v.optional(v.string()) })).index("by_decisionEventId", ["decisionEventId"]).index("by_topicId", ["topicId"]).index("by_topic_lockedAt", ["topicId", "lockedAt"]).index("by_decision_version", ["decisionEventId", "version"]).index("by_decision_lockedAt", ["decisionEventId", "lockedAt"]).index("by_payloadHash", ["payloadHash"]),
   "deliberationContributions": defineTable(v.object({ "answer": v.string(), "confidence": v.number(), "contradictionHypotheses": v.array(v.string()), "createdAt": v.number(), "escalationQuestions": v.array(v.string()), "modelKey": v.optional(v.string()), "parsedResponse": v.optional(v.any()), "principalId": v.string(), "projectId": v.optional(v.string()), "promptName": v.optional(v.string()), "rawResponse": v.string(), "reasoningChain": v.array(v.string()), "role": v.union(v.literal("support"), v.literal("oppose"), v.literal("uncertain"), v.literal("synthesize")), "sessionId": v.id("deliberationSessions"), "slot": v.string(), "topicId": v.optional(v.string()), "traceId": v.optional(v.string()), "uncertaintyZones": v.array(v.object({ "explanation": v.string(), "label": v.string() })), "updatedAt": v.number() })).index("by_sessionId", ["sessionId"]).index("by_topicId", ["topicId"]).index("by_session_slot", ["sessionId", "slot"]),
   "deliberationSessions": defineTable(v.object({ "completedAt": v.optional(v.number()), "contextBrief": v.optional(v.string()), "contextSnapshot": v.optional(v.any()), "contradictionIds": v.array(v.string()), "createdAt": v.number(), "createdBy": v.string(), "error": v.optional(v.string()), "escalationQuestionIds": v.array(v.string()), "linkedBeliefNodeId": v.optional(v.string()), "modelSlots": v.array(v.string()), "outcomeSummary": v.optional(v.any()), "principalId": v.string(), "projectId": v.optional(v.string()), "question": v.string(), "replayBaseline": v.optional(v.any()), "replayBaselineAt": v.number(), "replayDelta": v.optional(v.any()), "replayHeadAt": v.optional(v.number()), "status": v.union(v.literal("running"), v.literal("completed"), v.literal("failed")), "tenantId": v.optional(v.string()), "topicId": v.optional(v.string()), "traceId": v.optional(v.string()), "uncertaintyZones": v.array(v.object({ "explanation": v.string(), "label": v.string(), "slots": v.array(v.string()) })), "updatedAt": v.number(), "workspaceId": v.optional(v.string()) })).index("by_topicId", ["topicId"]).index("by_status", ["status"]).index("by_topic_status", ["topicId", "status"]).index("by_createdBy", ["createdBy"]),
-  "domainEvents": defineTable(v.object({ "actorId": v.string(), "actorType": v.union(v.literal("human"), v.literal("agent"), v.literal("service")), "correlationId": v.optional(v.string()), "data": v.record(v.string(), v.any()), "eventId": v.string(), "expiresAt": v.number(), "resourceId": v.string(), "resourceType": v.string(), "tenantId": v.optional(v.string()), "timestamp": v.number(), "topicId": v.string(), "type": v.string(), "version": v.string(), "workspaceId": v.optional(v.string()) })).index("by_eventId", ["eventId"]).index("by_topic_timestamp", ["topicId", "timestamp"]).index("by_tenant_workspace_timestamp", ["tenantId", "workspaceId", "timestamp"]).index("by_type_timestamp", ["type", "timestamp"]).index("by_resource", ["resourceType", "resourceId", "timestamp"]).index("by_expiresAt", ["expiresAt"]),
+  "domainEventForwardCheckpoints": defineTable(v.object({ "forwardedCount": v.number(), "lastError": v.optional(v.string()), "lastForwardedEventId": v.string(), "lastForwardedTimestamp": v.number(), "lastStatus": v.optional(v.union(v.literal("ok"), v.literal("empty"), v.literal("export_failed"))), "sink": v.string(), "updatedAt": v.number() })).index("by_sink", ["sink"]),
+  "domainEvents": defineTable(v.object({ "actorId": v.string(), "actorType": v.union(v.literal("human"), v.literal("agent"), v.literal("service")), "correlationId": v.optional(v.string()), "data": v.record(v.string(), v.any()), "eventId": v.string(), "expiresAt": v.number(), "resourceId": v.string(), "resourceType": v.string(), "tenantId": v.optional(v.string()), "timestamp": v.number(), "topicId": v.string(), "type": v.string(), "version": v.string(), "workspaceId": v.optional(v.string()) })).index("by_eventId", ["eventId"]).index("by_topic_timestamp", ["topicId", "timestamp"]).index("by_tenant_workspace_timestamp", ["tenantId", "workspaceId", "timestamp"]).index("by_type_timestamp", ["type", "timestamp"]).index("by_resource", ["resourceType", "resourceId", "timestamp"]).index("by_timestamp", ["timestamp"]).index("by_expiresAt", ["expiresAt"]),
   "epistemicAudit": defineTable(v.object({ "agentType": v.optional(v.string()), "changedAt": v.number(), "changedBy": v.string(), "changeType": v.union(v.literal("created"), v.literal("status_changed"), v.literal("confidence_changed"), v.literal("criticality_changed"), v.literal("formulation_modified"), v.literal("forked"), v.literal("superseded"), v.literal("archived"), v.literal("resolved"), v.literal("severity_changed"), v.literal("edge_added"), v.literal("edge_removed"), v.literal("annotated"), v.literal("blocked"), v.literal("unblocked"), v.literal("decision_finalized"), v.literal("proposal_accepted"), v.literal("proposal_rejected"), v.literal("pillar_changed"), v.literal("updated"), v.literal("deleted"), v.literal("entity_merged"), v.literal("entity_attributes_updated"), v.literal("entity_archived"), v.literal("published"), v.literal("deprecated"), v.literal("source_created"), v.literal("source_metadata_updated"), v.literal("canonicalText_repaired"), v.literal("globalId_repaired_v4_to_v7")), "entityId": v.string(), "entityType": v.union(v.literal("belief"), v.literal("evidence"), v.literal("question"), v.literal("answer"), v.literal("contradiction"), v.literal("decision"), v.literal("proposal"), v.literal("edge"), v.literal("node"), v.literal("epistemicNode"), v.literal("topic"), v.literal("entity"), v.literal("source"), v.literal("belief_conditional"), v.literal("belief_scenario"), v.literal("ontologyDefinition"), v.literal("ontologyVersion")), "isAgent": v.boolean(), "mcpSessionId": v.optional(v.string()), "mcpToolName": v.optional(v.string()), "newState": v.optional(v.union(v.record(v.string(), v.any()), v.null())), "previousState": v.optional(v.union(v.record(v.string(), v.any()), v.null())), "proposalId": v.optional(v.string()), "rationale": v.optional(v.string()), "sourceCommit": v.optional(v.string()), "topicId": v.optional(v.string()), "triggeringAction": v.optional(v.string()) })).index("by_entityId", ["entityId"]).index("by_entityType", ["entityType"]).index("by_entityType_id", ["entityType", "entityId"]).index("by_changedAt", ["changedAt"]).index("by_changedBy", ["changedBy"]).index("by_topicId", ["topicId"]).index("by_changeType", ["changeType"]).index("by_mcpSessionId", ["mcpSessionId"]),
   "epistemicContracts": defineTable(v.object({ "beliefNodeId": v.string(), "compositeOf": v.optional(v.array(v.string())), "compositeOperator": v.optional(v.union(v.literal("all"), v.literal("any"), v.literal("majority"))), "condition": v.object({ "evaluator": v.string(), "evaluatorConfig": v.optional(v.union(v.string(), v.number(), v.boolean(), v.null(), v.record(v.string(), v.any()), v.array(v.any()))), "expression": v.string() }), "conditionType": v.union(v.literal("assertion"), v.literal("temporal"), v.literal("evidential"), v.literal("threshold"), v.literal("composite")), "contractId": v.string(), "createdAt": v.number(), "createdBy": v.string(), "deadline": v.optional(v.number()), "description": v.optional(v.string()), "direction": v.union(v.literal("confirms"), v.literal("falsifies")), "evaluationCount": v.optional(v.number()), "evaluationSchedule": v.union(v.literal("on_demand"), v.literal("on_evidence"), v.literal("periodic"), v.literal("event_driven")), "inheritedAt": v.optional(v.number()), "inheritedFromBeliefNodeId": v.optional(v.string()), "inheritedFromContractId": v.optional(v.string()), "lastEvaluatedAt": v.optional(v.number()), "lineageSource": v.union(v.literal("declared"), v.literal("inherited")), "modulation": v.object({ "onConfirmed": v.object({ "ceiling": v.optional(v.number()), "delta": v.number() }), "onDisconfirmed": v.object({ "delta": v.number(), "floor": v.optional(v.number()) }), "onExpired": v.optional(v.object({ "delta": v.number() })), "onPartial": v.optional(v.object({ "delta": v.number(), "threshold": v.number() })) }), "periodicIntervalMs": v.optional(v.number()), "status": v.union(v.literal("active"), v.literal("satisfied"), v.literal("violated"), v.literal("expired"), v.literal("suspended"), v.literal("archived")), "title": v.string(), "topicId": v.optional(v.string()), "updatedAt": v.number() })).index("by_contractId", ["contractId"]).index("by_belief", ["beliefNodeId"]).index("by_status", ["status"]).index("by_evaluator", ["condition.evaluator"]).index("by_topic", ["topicId"]).index("by_schedule", ["evaluationSchedule"]),
   "epistemicEdges": defineTable(v.object({ "analogyBasis": v.optional(v.string()), "analogyStrength": v.optional(v.number()), "anonymizationClass": v.optional(v.union(v.literal("none"), v.literal("standard"), v.literal("strict"))), "audienceLabel": v.optional(v.string()), "blocking": v.optional(v.boolean()), "causal": v.optional(v.boolean()), "conditionalA": v.optional(v.object({ "a": v.number(), "b": v.number(), "d": v.number(), "u": v.number() })), "conditionalNotA": v.optional(v.object({ "a": v.number(), "b": v.number(), "d": v.number(), "u": v.number() })), "confidence": v.optional(v.number()), "constraint": v.optional(v.string()), "containment": v.optional(v.string()), "context": v.optional(v.string()), "createdAt": v.number(), "createdBy": v.string(), "defeatType": v.optional(v.union(v.literal("rebuts"), v.literal("undercuts"), v.literal("undermines"))), "derivation": v.optional(v.string()), "derivationType": v.optional(v.string()), "disanalogies": v.optional(v.array(v.string())), "domainNamespace": v.optional(v.string()), "edgeTier": v.optional(v.string()), "edgeType": v.union(v.literal("supports"), v.literal("informs"), v.literal("depends_on"), v.literal("derived_from"), v.literal("contains"), v.literal("tests"), v.literal("supersedes"), v.literal("responds_to"), v.literal("belongs_to"), v.literal("relates_to_thesis"), v.literal("works_at"), v.literal("invested_in"), v.literal("competes_with"), v.literal("participates_in"), v.literal("founded_by"), v.literal("evaluates"), v.literal("performs"), v.literal("function_in"), v.literal("impacts"), v.literal("raised_from"), v.literal("mentioned_in"), v.literal("perspective_on"), v.literal("plays_theme"), v.literal("answers"), v.literal("explores"), v.literal("qualifies"), v.literal("based_on"), v.literal("based_on_belief"), v.literal("based_on_question"), v.literal("blocked_by_contradiction"), v.literal("informed_by_theme"), v.literal("same_as"), v.literal("reinforces"), v.literal("parent_of"), v.literal("child_of"), v.literal("falsified_by"), v.literal("exclusive_with"), v.literal("collapses_if"), v.literal("cascade_from"), v.literal("counterfactual_of"), v.literal("cascade_to"), v.literal("mutually_exclusive"), v.literal("correlates_with"), v.literal("amplifies"), v.literal("precondition_for"), v.literal("in_tension_with"), v.literal("strengthened_by"), v.literal("weakened_by"), v.literal("alternative_to"), v.literal("subsumes"), v.literal("validated_by"), v.literal("required_for"), v.literal("blocks"), v.literal("prerequisite_for"), v.literal("parallel_to"), v.literal("corroborates"), v.literal("extends"), v.literal("same_source_as"), v.literal("same_theme_as"), v.literal("assumes"), v.literal("would_predict"), v.literal("analogous_to"), v.literal("independent_of"), v.literal("implements"), v.literal("violates"), v.literal("co_changes_with"), v.literal("migrating_from"), v.literal("migrating_to"), v.literal("scoped_by"), v.literal("about_entity"), v.literal("entity_referenced_in"), v.literal("contradicts"), v.literal("cites"), v.literal("summarizes"), v.literal("related_to"), v.literal("partially_answers"), v.literal("refines"), v.literal("branches_from"), v.literal("extracted_from")), "endDate": v.optional(v.number()), "evidence": v.optional(v.string()), "exportClass": v.optional(v.union(v.literal("internal_only"), v.literal("client_safe"), v.literal("public_safe"), v.literal("restricted"))), "fromLayer": v.optional(v.union(v.literal("L4"), v.literal("L3"), v.literal("L2"), v.literal("L1"), v.literal("ontological"), v.literal("organizational"))), "fromNodeId": v.string(), "fromNodeType": v.optional(v.string()), "globalId": v.string(), "implicit": v.optional(v.boolean()), "interrogation": v.optional(v.string()), "keywords": v.optional(v.array(v.string())), "logicalRole": v.optional(v.union(v.literal("necessary"), v.literal("sufficient"), v.literal("necessary_sufficient"), v.literal("contributory"), v.literal("corroborative"))), "metadata": v.optional(v.record(v.string(), v.any())), "normalization": v.optional(v.string()), "ownerPrincipalId": v.optional(v.string()), "policyTags": v.optional(v.array(v.string())), "predictionFulfilled": v.optional(v.boolean()), "predictionFulfilledAt": v.optional(v.number()), "predictionFulfilledBy": v.optional(v.string()), "projectId": v.optional(v.string()), "propagation": v.optional(v.string()), "reasoningMethod": v.optional(v.union(v.literal("deductive"), v.literal("inductive"), v.literal("abductive"), v.literal("analogical"), v.literal("causal"), v.literal("correlational"), v.literal("testimonial"), v.literal("statistical"), v.literal("implicit"), v.literal("pattern_match"))), "sensitivityTier": v.optional(v.union(v.literal("low"), v.literal("medium"), v.literal("high"), v.literal("restricted"))), "sourceGlobalId": v.optional(v.string()), "startDate": v.optional(v.number()), "surpriseScore": v.optional(v.number()), "targetGlobalId": v.optional(v.string()), "temporalClass": v.optional(v.union(v.literal("structural"), v.literal("cyclical"), v.literal("transient"), v.literal("point_in_time"))), "tenantId": v.optional(v.string()), "toLayer": v.optional(v.union(v.literal("L4"), v.literal("L3"), v.literal("L2"), v.literal("L1"), v.literal("ontological"), v.literal("organizational"))), "toNodeId": v.optional(v.string()), "toNodeType": v.optional(v.string()), "topicId": v.optional(v.string()), "updatedAt": v.optional(v.number()), "validFrom": v.optional(v.number()), "validUntil": v.optional(v.number()), "weight": v.optional(v.number()), "workspaceId": v.optional(v.string()) })).index("by_globalId", ["globalId"]).index("by_from", ["fromNodeId"]).index("by_to", ["toNodeId"]).index("by_from_type", ["fromNodeId", "edgeType"]).index("by_to_type", ["toNodeId", "edgeType"]).index("by_topic", ["topicId"]).index("by_tenantId", ["tenantId"]).index("by_workspaceId", ["workspaceId"]).index("by_tenant_workspace", ["tenantId", "workspaceId"]).index("by_audienceLabel", ["audienceLabel"]).index("by_sensitivityTier", ["sensitivityTier"]).index("by_exportClass", ["exportClass"]).index("by_type", ["edgeType"]).index("by_from_to", ["fromNodeId", "toNodeId"]).index("by_fromLayer", ["fromLayer"]).index("by_toLayer", ["toLayer"]).index("by_layer_pair", ["fromLayer", "toLayer"]).index("by_source_global_id", ["sourceGlobalId"]).index("by_target_global_id", ["targetGlobalId"]).index("by_reasoning_method", ["edgeType", "reasoningMethod"]).index("by_logical_role", ["edgeType", "logicalRole"]).index("by_temporal_class", ["temporalClass", "validUntil"]).index("by_surprise", ["edgeType", "surpriseScore"]),

package/dist/generated/schema-manifest.json

@@ -1,9 +1,9 @@
 {
   "generatedFrom": "packages/contracts/src/schemas/manifest.ts",
   "counts": {
-    "total": 133,
+    "total": 134,
     "byComponent": {
-      "kernel": 57,
+      "kernel": 58,
       "control-plane": 38,
       "mc": 38,
       "developer-pack": 0
@@ -11,7 +11,7 @@
     "byLayer": {
       "L": 38,
       "C": 38,
-      "K": 57,
+      "K": 58,
       "D": 0,
       "A": 0
     }
@@ -1471,6 +1471,23 @@
       "deprecated": null,
       "invariants": []
     },
+    {
+      "name": "domainEventForwardCheckpoints",
+      "component": "kernel",
+      "layer": "K",
+      "category": "events",
+      "indices": [
+        {
+          "kind": "index",
+          "name": "by_sink",
+          "columns": [
+            "sink"
+          ]
+        }
+      ],
+      "deprecated": null,
+      "invariants": []
+    },
     {
       "name": "domainEvents",
       "component": "kernel",
@@ -1518,6 +1535,13 @@
             "timestamp"
           ]
         },
+        {
+          "kind": "index",
+          "name": "by_timestamp",
+          "columns": [
+            "timestamp"
+          ]
+        },
         {
           "kind": "index",
           "name": "by_expiresAt",

package/dist/generated/tableOwnership.d.ts

@@ -2,7 +2,7 @@ export type TableOwnershipLayer = "L" | "C" | "K" | "D" | "A";
 export declare const TABLES_BY_LAYER: {
     readonly L: readonly ["agentRegistryEntries", "apiKeys", "auditLog", "compatibilityShims", "controlPlaneTenantModelSlotBindings", "controlPlaneTenantProviderSecrets", "controlPlaneTenantProxyGatewayUsage", "controlPlaneTenantProxyTokenLeases", "controlPlaneToolAcls", "cutoverFlags", "deploymentHosts", "groupMemberships", "groups", "memberships", "methodologyPacks", "oauthDeviceCodes", "packAssignments", "packDefinitions", "packEntitlements", "packGroupAssignments", "packInstallations", "packVersions", "permitSyncStates", "policyBundles", "policyDecisionLogs", "policySimulations", "principalIdentityAliases", "principals", "rateLimitWindows", "secretSyncDriftReports", "servicePrincipalKeys", "tenantDeploymentCredentials", "tenantMethodologyAssignments", "tenants", "toolCatalog", "toolRegistryEntries", "userSessions", "workspaces"];
     readonly C: readonly ["agents", "mcpWritePolicy", "modelCallLogs", "modelFunctionSlots", "modelRegistry", "modelSlotConfigs", "permitAccessReviewItems", "permitAccessReviews", "permitAttributeBindings", "permitGroupMemberships", "permitGroups", "permitPolicyBundles", "permitPolicyDecisionReceipts", "permitPrincipalAliases", "permitPrincipals", "permitProjectionOutbox", "permitRelationshipTuples", "permitResourceInstances", "permitRoleAssignments", "platformAudienceGrants", "platformAudiences", "platformPolicyDecisionLogs", "projectGrants", "reasoningPermissions", "tenantApiKeys", "tenantConfig", "tenantIntegrations", "tenantModelSlotBindings", "tenantPermitSyncStates", "tenantPolicies", "tenantProviderSecrets", "tenantProxyGatewayUsage", "tenantProxyTokenMints", "tenantSandboxAuditEvents", "tenantSecrets", "toolAcls", "toolRegistry", "users"];
-    readonly K: readonly ["agentMessages", "agentSessions", "autofixJobs", "backgroundJobRuns", "backgroundJobSettings", "beliefConfidence", "beliefEvidenceLinks", "beliefHistory", "beliefScenarios", "beliefVotes", "calibrationScores", "contractEvaluations", "contradictions", "crossProjectConnections", "decisionComputedSummaries", "decisionEvents", "decisionParticipants", "decisionRiskLedger", "decisionSnapshots", "deliberationContributions", "deliberationSessions", "domainEvents", "epistemicAudit", "epistemicContracts", "epistemicEdges", "epistemicIdentityBackfillMappings", "epistemicNodeEmbeddings", "epistemicNodes", "graphAnalysisCache", "graphAnalysisResults", "graphSuggestions", "harnessReplays", "harnessRuns", "idempotencyTokens", "lenses", "lensTopicBindings", "neo4jSyncQueue", "ontologyDefinitions", "ontologyVersions", "platformAgentRunPolicyDecisions", "platformAgentRunPromptResolutions", "platformAgentRuns", "platformAgentRunToolCalls", "platformHarnessShadowAudit", "publicationRules", "questionEvidenceLinks", "researchJobs", "schemaEnumConfig", "stakeholderGroups", "systemLogs", "tasks", "topics", "workflowDefinitions", "workflowPullRequests", "workflowStages", "worktreeBeliefCluster", "worktrees"];
+    readonly K: readonly ["agentMessages", "agentSessions", "autofixJobs", "backgroundJobRuns", "backgroundJobSettings", "beliefConfidence", "beliefEvidenceLinks", "beliefHistory", "beliefScenarios", "beliefVotes", "calibrationScores", "contractEvaluations", "contradictions", "crossProjectConnections", "decisionComputedSummaries", "decisionEvents", "decisionParticipants", "decisionRiskLedger", "decisionSnapshots", "deliberationContributions", "deliberationSessions", "domainEventForwardCheckpoints", "domainEvents", "epistemicAudit", "epistemicContracts", "epistemicEdges", "epistemicIdentityBackfillMappings", "epistemicNodeEmbeddings", "epistemicNodes", "graphAnalysisCache", "graphAnalysisResults", "graphSuggestions", "harnessReplays", "harnessRuns", "idempotencyTokens", "lenses", "lensTopicBindings", "neo4jSyncQueue", "ontologyDefinitions", "ontologyVersions", "platformAgentRunPolicyDecisions", "platformAgentRunPromptResolutions", "platformAgentRuns", "platformAgentRunToolCalls", "platformHarnessShadowAudit", "publicationRules", "questionEvidenceLinks", "researchJobs", "schemaEnumConfig", "stakeholderGroups", "systemLogs", "tasks", "topics", "workflowDefinitions", "workflowPullRequests", "workflowStages", "worktreeBeliefCluster", "worktrees"];
     readonly D: readonly [];
     readonly A: readonly [];
 };
@@ -40,6 +40,7 @@ export declare const TABLE_OWNERSHIP: {
     readonly deliberationContributions: "K";
     readonly deliberationSessions: "K";
     readonly deploymentHosts: "L";
+    readonly domainEventForwardCheckpoints: "K";
     readonly domainEvents: "K";
     readonly epistemicAudit: "K";
     readonly epistemicContracts: "K";

package/dist/generated/tableOwnership.js

@@ -102,6 +102,7 @@ var TABLES_BY_LAYER = {
     "decisionSnapshots",
     "deliberationContributions",
     "deliberationSessions",
+    "domainEventForwardCheckpoints",
     "domainEvents",
     "epistemicAudit",
     "epistemicContracts",
@@ -176,6 +177,7 @@ var TABLE_OWNERSHIP = {
   "deliberationContributions": "K",
   "deliberationSessions": "K",
   "deploymentHosts": "L",
+  "domainEventForwardCheckpoints": "K",
   "domainEvents": "K",
   "epistemicAudit": "K",
   "epistemicContracts": "K",

package/dist/generated/tier-expectations.json

@@ -51,7 +51,7 @@
       "components": [
         "kernel"
       ],
-      "tableCount": 57,
+      "tableCount": 58,
       "tables": [
         "agentMessages",
         "agentSessions",
@@ -74,6 +74,7 @@
         "decisionSnapshots",
         "deliberationContributions",
         "deliberationSessions",
+        "domainEventForwardCheckpoints",
         "domainEvents",
         "epistemicAudit",
         "epistemicContracts",
@@ -123,7 +124,7 @@
         "control-plane",
         "developer-pack"
       ],
-      "tableCount": 95,
+      "tableCount": 96,
       "tables": [
         "agentMessages",
         "agents",
@@ -147,6 +148,7 @@
         "decisionSnapshots",
         "deliberationContributions",
         "deliberationSessions",
+        "domainEventForwardCheckpoints",
         "domainEvents",
         "epistemicAudit",
         "epistemicContracts",
@@ -282,7 +284,7 @@
         "kernel",
         "developer-pack"
       ],
-      "tableCount": 133,
+      "tableCount": 134,
       "tables": [
         "agentMessages",
         "agentRegistryEntries",
@@ -317,6 +319,7 @@
         "deliberationContributions",
         "deliberationSessions",
         "deploymentHosts",
+        "domainEventForwardCheckpoints",
         "domainEvents",
         "epistemicAudit",
         "epistemicContracts",

package/dist/index.js

@@ -3699,9 +3699,39 @@ var domainEvents = defineTable({
       name: "by_resource",
       columns: ["resourceType", "resourceId", "timestamp"]
     },
+    // OB.2: global chronological order for the Axiom forwarding scan. The
+    // forwarder pages events strictly by (timestamp, eventId) after its
+    // checkpoint cursor, so it needs a total time order independent of topic /
+    // type / tenant. The forwarder additionally tie-breaks on eventId in
+    // application code for events sharing a millisecond timestamp.
+    { kind: "index", name: "by_timestamp", columns: ["timestamp"] },
     { kind: "index", name: "by_expiresAt", columns: ["expiresAt"] }
   ]
 });
+var domainEventForwardCheckpoints = defineTable({
+  name: "domainEventForwardCheckpoints",
+  component: "kernel",
+  category: "events",
+  shape: z.object({
+    // Logical sink name. One checkpoint row per forwarding destination so a
+    // second sink (e.g. a future OTel path) never contends on this cursor.
+    sink: z.string(),
+    // Cursor: the timestamp of the last successfully forwarded event (ms epoch).
+    lastForwardedTimestamp: z.number(),
+    // Cursor tie-breaker: the eventId of the last successfully forwarded event.
+    lastForwardedEventId: z.string(),
+    // Running count of events forwarded through this sink (observability of the
+    // observer — lets an operator confirm the pump is moving without Axiom).
+    forwardedCount: z.number(),
+    // When this checkpoint row was last advanced (ms epoch).
+    updatedAt: z.number(),
+    // Last tick outcome, for at-a-glance health without querying Axiom.
+    lastStatus: z.enum(["ok", "empty", "export_failed"]).optional(),
+    // Redacted last-error summary when lastStatus is export_failed.
+    lastError: z.string().optional()
+  }),
+  indices: [{ kind: "index", name: "by_sink", columns: ["sink"] }]
+});
 var idempotencyTokens = defineTable({
   name: "idempotencyTokens",
   component: "kernel",
@@ -14986,6 +15016,7 @@ var KERNEL_TABLE_CONTRACTS = [
   decisionRiskLedger,
   decisionSnapshots,
   domainEvents,
+  domainEventForwardCheckpoints,
   deliberationContributions,
   deliberationSessions,
   stakeholderGroups,
@@ -28056,6 +28087,7 @@ var TABLE_OWNERSHIP = {
   "deliberationContributions": "K",
   "deliberationSessions": "K",
   "deploymentHosts": "L",
+  "domainEventForwardCheckpoints": "K",
   "domainEvents": "K",
   "epistemicAudit": "K",
   "epistemicContracts": "K",
@@ -87095,6 +87127,13 @@ var TENANT_BOOTSTRAP_TABLE_REQUIREMENTS = [
     copyMode: "none",
     description: "Deliberation sessions are created by tenant workflows."
   },
+  {
+    component: "kernel",
+    table: "domainEventForwardCheckpoints",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Per-forwarder cursor checkpoints for domain-event log shipping; created at runtime by the log-lake forwarder."
+  },
   {
     component: "kernel",
     table: "domainEvents",

package/dist/manifests/__tests__/sc3-operation-manifest-census-derivability.test.d.ts

@@ -0,0 +1 @@
+export {};