@lucern/contracts 1.0.55 → 1.0.57

package/dist/schemas/manifest.d.ts

@@ -205,6 +205,14 @@ export declare const KERNEL_TABLE_CONTRACTS: readonly [import("../dsl.js").Table
     data: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>;
     correlationId: import("zod").ZodOptional<import("zod").ZodString>;
     expiresAt: import("zod").ZodNumber;
+}>, import("../dsl.js").TableContract<{
+    sink: import("zod").ZodString;
+    lastForwardedTimestamp: import("zod").ZodNumber;
+    lastForwardedEventId: import("zod").ZodString;
+    forwardedCount: import("zod").ZodNumber;
+    updatedAt: import("zod").ZodNumber;
+    lastStatus: import("zod").ZodOptional<import("zod").ZodEnum<["ok", "empty", "export_failed"]>>;
+    lastError: import("zod").ZodOptional<import("zod").ZodString>;
 }>, import("../dsl.js").TableContract<{
     sessionId: import("../dsl.js").ConvexIdSchema<"deliberationSessions">;
     topicId: import("zod").ZodOptional<import("zod").ZodString>;
@@ -5650,6 +5658,14 @@ export declare const TABLE_CONTRACTS_BY_COMPONENT: {
         data: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>;
         correlationId: import("zod").ZodOptional<import("zod").ZodString>;
         expiresAt: import("zod").ZodNumber;
+    }>, import("../dsl.js").TableContract<{
+        sink: import("zod").ZodString;
+        lastForwardedTimestamp: import("zod").ZodNumber;
+        lastForwardedEventId: import("zod").ZodString;
+        forwardedCount: import("zod").ZodNumber;
+        updatedAt: import("zod").ZodNumber;
+        lastStatus: import("zod").ZodOptional<import("zod").ZodEnum<["ok", "empty", "export_failed"]>>;
+        lastError: import("zod").ZodOptional<import("zod").ZodString>;
     }>, import("../dsl.js").TableContract<{
         sessionId: import("../dsl.js").ConvexIdSchema<"deliberationSessions">;
         topicId: import("zod").ZodOptional<import("zod").ZodString>;
@@ -11096,6 +11112,14 @@ export declare const ALL_TABLE_CONTRACTS: readonly [import("../dsl.js").TableCon
     data: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>;
     correlationId: import("zod").ZodOptional<import("zod").ZodString>;
     expiresAt: import("zod").ZodNumber;
+}>, import("../dsl.js").TableContract<{
+    sink: import("zod").ZodString;
+    lastForwardedTimestamp: import("zod").ZodNumber;
+    lastForwardedEventId: import("zod").ZodString;
+    forwardedCount: import("zod").ZodNumber;
+    updatedAt: import("zod").ZodNumber;
+    lastStatus: import("zod").ZodOptional<import("zod").ZodEnum<["ok", "empty", "export_failed"]>>;
+    lastError: import("zod").ZodOptional<import("zod").ZodString>;
 }>, import("../dsl.js").TableContract<{
     sessionId: import("../dsl.js").ConvexIdSchema<"deliberationSessions">;
     topicId: import("zod").ZodOptional<import("zod").ZodString>;
@@ -17678,6 +17702,14 @@ export declare function listTableContractsByName(name: string): (import("../dsl.
     data: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>;
     correlationId: import("zod").ZodOptional<import("zod").ZodString>;
     expiresAt: import("zod").ZodNumber;
+}> | import("../dsl.js").TableContract<{
+    sink: import("zod").ZodString;
+    lastForwardedTimestamp: import("zod").ZodNumber;
+    lastForwardedEventId: import("zod").ZodString;
+    forwardedCount: import("zod").ZodNumber;
+    updatedAt: import("zod").ZodNumber;
+    lastStatus: import("zod").ZodOptional<import("zod").ZodEnum<["ok", "empty", "export_failed"]>>;
+    lastError: import("zod").ZodOptional<import("zod").ZodString>;
 }> | import("../dsl.js").TableContract<{
     tenantId: import("zod").ZodString;
     fnName: import("zod").ZodString;
@@ -23120,6 +23152,14 @@ export declare function getTableContract(name: string, component?: string): impo
     data: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>;
     correlationId: import("zod").ZodOptional<import("zod").ZodString>;
     expiresAt: import("zod").ZodNumber;
+}> | import("../dsl.js").TableContract<{
+    sink: import("zod").ZodString;
+    lastForwardedTimestamp: import("zod").ZodNumber;
+    lastForwardedEventId: import("zod").ZodString;
+    forwardedCount: import("zod").ZodNumber;
+    updatedAt: import("zod").ZodNumber;
+    lastStatus: import("zod").ZodOptional<import("zod").ZodEnum<["ok", "empty", "export_failed"]>>;
+    lastError: import("zod").ZodOptional<import("zod").ZodString>;
 }> | import("../dsl.js").TableContract<{
     tenantId: import("zod").ZodString;
     fnName: import("zod").ZodString;

package/dist/schemas/manifest.js

@@ -2842,9 +2842,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",
@@ -9966,6 +9996,14 @@ DATA_MODEL_MANIFEST_SKELETON.surfaces.map(
   (surface) => surface.compositionEmitted
 );
 var EVIDENCE_RELATION_VALUES = ["supports", "contradicts"];
+var EVIDENCE_KIND_VALUES = [
+  "fact",
+  "observation",
+  "claim",
+  "quote",
+  "statistic",
+  "signal"
+];
 var EVIDENCE_METHODOLOGY_VALUES = [
   "primary_research",
   "expert_interview",
@@ -10019,6 +10057,7 @@ var EVIDENCE_TAXONOMY_REFUSAL_IDS = [
   "metadata_scoring_plan_refused"
 ];
 z.enum(EVIDENCE_RELATION_VALUES);
+z.enum(EVIDENCE_KIND_VALUES);
 z.enum(EVIDENCE_METHODOLOGY_VALUES);
 z.enum(
   EVIDENCE_INFORMATION_ASYMMETRY_VALUES
@@ -13477,6 +13516,7 @@ var KERNEL_TABLE_CONTRACTS = [
   decisionRiskLedger,
   decisionSnapshots,
   domainEvents,
+  domainEventForwardCheckpoints,
   deliberationContributions,
   deliberationSessions,
   stakeholderGroups,

package/dist/schemas/tables/kernel/events.d.ts

@@ -22,3 +22,25 @@ export declare const domainEvents: import("../../../dsl.js").TableContract<{
     correlationId: z.ZodOptional<z.ZodString>;
     expiresAt: z.ZodNumber;
 }>;
+/**
+ * Axiom forwarding checkpoint — the OB.2 log-lake cursor.
+ *
+ * The scheduled `events:recordEvent` -> Axiom forwarder (OB.2) is cursor-based
+ * and idempotent: it persists, per sink, the `(timestamp, eventId)` of the last
+ * domain event it successfully forwarded. On each tick it reads events strictly
+ * after that cursor, forwards them through the transport-core Axiom exporter,
+ * and advances the checkpoint ONLY after a successful export. Forwarding is
+ * fail-open — an export failure leaves the checkpoint unadvanced so the same
+ * window is retried next tick, and it never touches the source `domainEvents`
+ * ledger. One row per `sink` (e.g. `axiom-events`); the row is upserted, never
+ * accreted, because it is operational cursor state, not epistemic state.
+ */
+export declare const domainEventForwardCheckpoints: import("../../../dsl.js").TableContract<{
+    sink: z.ZodString;
+    lastForwardedTimestamp: z.ZodNumber;
+    lastForwardedEventId: z.ZodString;
+    forwardedCount: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    lastStatus: z.ZodOptional<z.ZodEnum<["ok", "empty", "export_failed"]>>;
+    lastError: z.ZodOptional<z.ZodString>;
+}>;

package/dist/schemas/tables/kernel/events.js

@@ -50,8 +50,38 @@ 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"] }]
+});
 
-export { domainEvents };
+export { domainEventForwardCheckpoints, domainEvents };

package/dist/schemas/tables/kernel/spine.js

@@ -5904,6 +5904,14 @@ DATA_MODEL_MANIFEST_SKELETON.surfaces.map(
   (surface) => surface.compositionEmitted
 );
 var EVIDENCE_RELATION_VALUES = ["supports", "contradicts"];
+var EVIDENCE_KIND_VALUES = [
+  "fact",
+  "observation",
+  "claim",
+  "quote",
+  "statistic",
+  "signal"
+];
 var EVIDENCE_METHODOLOGY_VALUES = [
   "primary_research",
   "expert_interview",
@@ -5957,6 +5965,7 @@ var EVIDENCE_TAXONOMY_REFUSAL_IDS = [
   "metadata_scoring_plan_refused"
 ];
 z.enum(EVIDENCE_RELATION_VALUES);
+z.enum(EVIDENCE_KIND_VALUES);
 z.enum(EVIDENCE_METHODOLOGY_VALUES);
 z.enum(
   EVIDENCE_INFORMATION_ASYMMETRY_VALUES

package/dist/schemas.values.js

@@ -2975,9 +2975,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",
@@ -9985,6 +10015,14 @@ DATA_MODEL_MANIFEST_SKELETON.surfaces.map(
   (surface) => surface.compositionEmitted
 );
 var EVIDENCE_RELATION_VALUES = ["supports", "contradicts"];
+var EVIDENCE_KIND_VALUES = [
+  "fact",
+  "observation",
+  "claim",
+  "quote",
+  "statistic",
+  "signal"
+];
 var EVIDENCE_METHODOLOGY_VALUES = [
   "primary_research",
   "expert_interview",
@@ -10038,6 +10076,7 @@ var EVIDENCE_TAXONOMY_REFUSAL_IDS = [
   "metadata_scoring_plan_refused"
 ];
 z.enum(EVIDENCE_RELATION_VALUES);
+z.enum(EVIDENCE_KIND_VALUES);
 z.enum(EVIDENCE_METHODOLOGY_VALUES);
 z.enum(
   EVIDENCE_INFORMATION_ASYMMETRY_VALUES
@@ -13496,6 +13535,7 @@ var KERNEL_TABLE_CONTRACTS = [
   decisionRiskLedger,
   decisionSnapshots,
   domainEvents,
+  domainEventForwardCheckpoints,
   deliberationContributions,
   deliberationSessions,
   stakeholderGroups,

package/dist/tenant-bootstrap-seed.contract.d.ts

@@ -181,6 +181,12 @@ export declare const TENANT_BOOTSTRAP_TABLE_REQUIREMENTS: readonly [{
     readonly prepopulation: "runtime_data";
     readonly copyMode: "none";
     readonly description: "Deliberation sessions are created by tenant workflows.";
+}, {
+    readonly component: "kernel";
+    readonly table: "domainEventForwardCheckpoints";
+    readonly prepopulation: "runtime_data";
+    readonly copyMode: "none";
+    readonly description: "Per-forwarder cursor checkpoints for domain-event log shipping; created at runtime by the log-lake forwarder.";
 }, {
     readonly component: "kernel";
     readonly table: "domainEvents";
@@ -815,6 +821,12 @@ export declare const TENANT_BOOTSTRAP_SEED_MANIFEST: {
         readonly prepopulation: "runtime_data";
         readonly copyMode: "none";
         readonly description: "Deliberation sessions are created by tenant workflows.";
+    }, {
+        readonly component: "kernel";
+        readonly table: "domainEventForwardCheckpoints";
+        readonly prepopulation: "runtime_data";
+        readonly copyMode: "none";
+        readonly description: "Per-forwarder cursor checkpoints for domain-event log shipping; created at runtime by the log-lake forwarder.";
     }, {
         readonly component: "kernel";
         readonly table: "domainEvents";

package/dist/tenant-bootstrap-seed.contract.js

@@ -186,6 +186,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/types/evidence-taxonomy-target-scope.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 export declare const EVIDENCE_RELATION_VALUES: readonly ["supports", "contradicts"];
+export declare const EVIDENCE_KIND_VALUES: readonly ["fact", "observation", "claim", "quote", "statistic", "signal"];
 export declare const EVIDENCE_METHODOLOGY_VALUES: readonly ["primary_research", "expert_interview", "customer_interview", "field_observation", "proprietary_data", "desk_research", "regulatory_filing", "news_article", "academic_paper", "ai_synthesis", "ai_extraction"];
 export declare const EVIDENCE_INFORMATION_ASYMMETRY_VALUES: readonly ["proprietary", "early", "common"];
 export declare const EVIDENCE_SOURCE_QUALITY_VALUES: readonly ["primary", "analyzed", "secondary", "tertiary", "unknown"];
@@ -7,6 +8,7 @@ export declare const EVIDENCE_SOURCE_TYPE_VALUES: readonly ["human", "ai_extract
 export declare const EVIDENCE_SCORING_DIMENSIONS: readonly ["signedImpact", "evidenceRelation", "sourceQuality", "methodology", "informationAsymmetry", "sourceRef", "targetBeliefId", "verificationStatus"];
 export declare const EVIDENCE_TAXONOMY_REFUSAL_IDS: readonly ["orphan_evidence_create_refused", "non_belief_create_target_refused", "zero_signed_impact_refused", "relation_signed_impact_mismatch_refused", "unscoped_list_evidence_refused", "metadata_scoring_plan_refused"];
 export type EvidenceRelation = (typeof EVIDENCE_RELATION_VALUES)[number];
+export type EvidenceKind = (typeof EVIDENCE_KIND_VALUES)[number];
 export type EvidenceMethodology = (typeof EVIDENCE_METHODOLOGY_VALUES)[number];
 export type EvidenceInformationAsymmetry = (typeof EVIDENCE_INFORMATION_ASYMMETRY_VALUES)[number];
 export type EvidenceSourceQuality = (typeof EVIDENCE_SOURCE_QUALITY_VALUES)[number];
@@ -14,6 +16,7 @@ export type EvidenceSourceType = (typeof EVIDENCE_SOURCE_TYPE_VALUES)[number];
 export type EvidenceScoringDimension = (typeof EVIDENCE_SCORING_DIMENSIONS)[number];
 export type EvidenceTaxonomyRefusalId = (typeof EVIDENCE_TAXONOMY_REFUSAL_IDS)[number];
 export declare const EvidenceRelationSchema: z.ZodEnum<["supports", "contradicts"]>;
+export declare const EvidenceKindSchema: z.ZodEnum<["fact", "observation", "claim", "quote", "statistic", "signal"]>;
 export declare const EvidenceMethodologySchema: z.ZodEnum<["primary_research", "expert_interview", "customer_interview", "field_observation", "proprietary_data", "desk_research", "regulatory_filing", "news_article", "academic_paper", "ai_synthesis", "ai_extraction"]>;
 export declare const EvidenceInformationAsymmetrySchema: z.ZodEnum<["proprietary", "early", "common"]>;
 export declare const EvidenceSourceQualitySchema: z.ZodEnum<["primary", "analyzed", "secondary", "tertiary", "unknown"]>;

package/dist/types/evidence-taxonomy-target-scope.js

@@ -2,6 +2,14 @@ import { z } from 'zod';
 
 // src/types/evidence-taxonomy-target-scope.ts
 var EVIDENCE_RELATION_VALUES = ["supports", "contradicts"];
+var EVIDENCE_KIND_VALUES = [
+  "fact",
+  "observation",
+  "claim",
+  "quote",
+  "statistic",
+  "signal"
+];
 var EVIDENCE_METHODOLOGY_VALUES = [
   "primary_research",
   "expert_interview",
@@ -55,6 +63,7 @@ var EVIDENCE_TAXONOMY_REFUSAL_IDS = [
   "metadata_scoring_plan_refused"
 ];
 var EvidenceRelationSchema = z.enum(EVIDENCE_RELATION_VALUES);
+var EvidenceKindSchema = z.enum(EVIDENCE_KIND_VALUES);
 var EvidenceMethodologySchema = z.enum(EVIDENCE_METHODOLOGY_VALUES);
 var EvidenceInformationAsymmetrySchema = z.enum(
   EVIDENCE_INFORMATION_ASYMMETRY_VALUES
@@ -67,4 +76,4 @@ var EvidenceScoringDimensionSchema = z.enum(
   EVIDENCE_SCORING_DIMENSIONS
 );
 
-export { EVIDENCE_INFORMATION_ASYMMETRY_VALUES, EVIDENCE_METHODOLOGY_VALUES, EVIDENCE_RELATION_VALUES, EVIDENCE_SCORING_DIMENSIONS, EVIDENCE_SOURCE_QUALITY_VALUES, EVIDENCE_SOURCE_TYPE_VALUES, EVIDENCE_TAXONOMY_REFUSAL_IDS, EvidenceInformationAsymmetrySchema, EvidenceMethodologySchema, EvidenceRelationSchema, EvidenceScoringDimensionSchema, EvidenceSourceQualitySchema, EvidenceSourceTypeSchema };
+export { EVIDENCE_INFORMATION_ASYMMETRY_VALUES, EVIDENCE_KIND_VALUES, EVIDENCE_METHODOLOGY_VALUES, EVIDENCE_RELATION_VALUES, EVIDENCE_SCORING_DIMENSIONS, EVIDENCE_SOURCE_QUALITY_VALUES, EVIDENCE_SOURCE_TYPE_VALUES, EVIDENCE_TAXONOMY_REFUSAL_IDS, EvidenceInformationAsymmetrySchema, EvidenceKindSchema, EvidenceMethodologySchema, EvidenceRelationSchema, EvidenceScoringDimensionSchema, EvidenceSourceQualitySchema, EvidenceSourceTypeSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucern/contracts",
-  "version": "1.0.55",
+  "version": "1.0.57",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",