@rise-maritime/keelson-js 0.6.0-pre.13 → 0.6.0-pre.15

package/dist/interfaces/Route.d.ts

@@ -108,6 +108,30 @@ export declare enum RouteStatus {
 }
 export declare function routeStatusFromJSON(object: any): RouteStatus;
 export declare function routeStatusToJSON(object: RouteStatus): string;
+/**
+ * Which side of an operational limit counts as a breach.
+ *
+ * RouteInfo's own limit block carries both directions — max_wind_gust_mps is
+ * breached above, min_visibility_m below — so nothing about a limit's identity
+ * says which way it fails. Consumers of an exceedance record need it: "the most
+ * extreme value reached" is undefined without it, and deriving the direction
+ * from a `max_` / `min_` name prefix is a string match that fails silently the
+ * first time a limit is named anything else.
+ *
+ * Lives here rather than beside either consumer because it is a property of the
+ * limit as authored, not of the monitoring. Read by keelson.EnvelopeExceedance
+ * and keelson.EnvelopeLimitState.
+ */
+export declare enum EnvelopeBound {
+    ENVELOPE_BOUND_UNSPECIFIED = 0,
+    /** ENVELOPE_BOUND_UPPER - Breached by going ABOVE the limit value (max_wind_gust_mps, max_roll_deg). */
+    ENVELOPE_BOUND_UPPER = 1,
+    /** ENVELOPE_BOUND_LOWER - Breached by going BELOW it (min_visibility_m, min_speed_knots). */
+    ENVELOPE_BOUND_LOWER = 2,
+    UNRECOGNIZED = -1
+}
+export declare function envelopeBoundFromJSON(object: any): EnvelopeBound;
+export declare function envelopeBoundToJSON(object: EnvelopeBound): string;
 /** Required action for an ActionPoint. */
 export declare enum ActionPointRequiredAction {
     ACTION_POINT_REQUIRED_ACTION_UNSPECIFIED = 0,
@@ -272,6 +296,19 @@ export interface RouteInfo {
     maxWindSpeedMps?: number | undefined;
     minSpeedKnots?: number | undefined;
     maxSpeedKnots?: number | undefined;
+    /**
+     * Minimum visibility the route is valid above. `visibility_range_m` is
+     * published, so without this the measurement exists and the limit it should
+     * be checked against does not.
+     */
+    minVisibilityM?: number | undefined;
+    /**
+     * Gust limit, distinct from the mean-wind limit above. Gust is what governs
+     * small-craft operations: 12 m/s mean with 20 m/s gusts is a different
+     * proposition from a steady 12 m/s, and only the mean can be constrained
+     * today. Checked against the windowed `true_wind_speed_max_mps`.
+     */
+    maxWindGustMps?: number | undefined;
     /**
      * -- Optimization & autonomy ------------------------------------------------
      * Free-form optimization method label (e.g. "fuel-min", "eta-min", "weather-routed").

package/dist/interfaces/Route.js

@@ -5,8 +5,8 @@
 //   protoc               v6.30.2
 // source: Route.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RouteIssue = exports.RouteChallenge = exports.HazardZone = exports.ActionPoint = exports.ActionPoints = exports.ScheduleElement = exports.Schedule = exports.Schedules = exports.Leg = exports.Waypoint = exports.DefaultWaypoint = exports.Waypoints = exports.RouteInfo = exports.Route = exports.Extensions_Entry_AttributesEntry = exports.Extensions_Entry = exports.Extensions = exports.CircleGeometry = exports.RouteRef = exports.schedule_OriginToJSON = exports.schedule_OriginFromJSON = exports.Schedule_Origin = exports.actionPointRequiredActionToJSON = exports.actionPointRequiredActionFromJSON = exports.ActionPointRequiredAction = exports.routeStatusToJSON = exports.routeStatusFromJSON = exports.RouteStatus = exports.geometryTypeToJSON = exports.geometryTypeFromJSON = exports.GeometryType = exports.colregTrafficIntensityToJSON = exports.colregTrafficIntensityFromJSON = exports.ColregTrafficIntensity = exports.colregSituationToJSON = exports.colregSituationFromJSON = exports.ColregSituation = exports.hazardZoneTypeToJSON = exports.hazardZoneTypeFromJSON = exports.HazardZoneType = exports.routeChallengeTypeToJSON = exports.routeChallengeTypeFromJSON = exports.RouteChallengeType = exports.operationalContextToJSON = exports.operationalContextFromJSON = exports.OperationalContext = exports.autonomyLevelToJSON = exports.autonomyLevelFromJSON = exports.AutonomyLevel = exports.protobufPackage = void 0;
-exports.RouteStatusUpdate = exports.RouteSignature = exports.RouteSignatures = void 0;
+exports.ActionPoint = exports.ActionPoints = exports.ScheduleElement = exports.Schedule = exports.Schedules = exports.Leg = exports.Waypoint = exports.DefaultWaypoint = exports.Waypoints = exports.RouteInfo = exports.Route = exports.Extensions_Entry_AttributesEntry = exports.Extensions_Entry = exports.Extensions = exports.CircleGeometry = exports.RouteRef = exports.schedule_OriginToJSON = exports.schedule_OriginFromJSON = exports.Schedule_Origin = exports.actionPointRequiredActionToJSON = exports.actionPointRequiredActionFromJSON = exports.ActionPointRequiredAction = exports.envelopeBoundToJSON = exports.envelopeBoundFromJSON = exports.EnvelopeBound = exports.routeStatusToJSON = exports.routeStatusFromJSON = exports.RouteStatus = exports.geometryTypeToJSON = exports.geometryTypeFromJSON = exports.GeometryType = exports.colregTrafficIntensityToJSON = exports.colregTrafficIntensityFromJSON = exports.ColregTrafficIntensity = exports.colregSituationToJSON = exports.colregSituationFromJSON = exports.ColregSituation = exports.hazardZoneTypeToJSON = exports.hazardZoneTypeFromJSON = exports.HazardZoneType = exports.routeChallengeTypeToJSON = exports.routeChallengeTypeFromJSON = exports.RouteChallengeType = exports.operationalContextToJSON = exports.operationalContextFromJSON = exports.OperationalContext = exports.autonomyLevelToJSON = exports.autonomyLevelFromJSON = exports.AutonomyLevel = exports.protobufPackage = void 0;
+exports.RouteStatusUpdate = exports.RouteSignature = exports.RouteSignatures = exports.RouteIssue = exports.RouteChallenge = exports.HazardZone = void 0;
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 const Coordinate_1 = require("./Coordinate");
@@ -492,6 +492,61 @@ function routeStatusToJSON(object) {
     }
 }
 exports.routeStatusToJSON = routeStatusToJSON;
+/**
+ * Which side of an operational limit counts as a breach.
+ *
+ * RouteInfo's own limit block carries both directions — max_wind_gust_mps is
+ * breached above, min_visibility_m below — so nothing about a limit's identity
+ * says which way it fails. Consumers of an exceedance record need it: "the most
+ * extreme value reached" is undefined without it, and deriving the direction
+ * from a `max_` / `min_` name prefix is a string match that fails silently the
+ * first time a limit is named anything else.
+ *
+ * Lives here rather than beside either consumer because it is a property of the
+ * limit as authored, not of the monitoring. Read by keelson.EnvelopeExceedance
+ * and keelson.EnvelopeLimitState.
+ */
+var EnvelopeBound;
+(function (EnvelopeBound) {
+    EnvelopeBound[EnvelopeBound["ENVELOPE_BOUND_UNSPECIFIED"] = 0] = "ENVELOPE_BOUND_UNSPECIFIED";
+    /** ENVELOPE_BOUND_UPPER - Breached by going ABOVE the limit value (max_wind_gust_mps, max_roll_deg). */
+    EnvelopeBound[EnvelopeBound["ENVELOPE_BOUND_UPPER"] = 1] = "ENVELOPE_BOUND_UPPER";
+    /** ENVELOPE_BOUND_LOWER - Breached by going BELOW it (min_visibility_m, min_speed_knots). */
+    EnvelopeBound[EnvelopeBound["ENVELOPE_BOUND_LOWER"] = 2] = "ENVELOPE_BOUND_LOWER";
+    EnvelopeBound[EnvelopeBound["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(EnvelopeBound || (exports.EnvelopeBound = EnvelopeBound = {}));
+function envelopeBoundFromJSON(object) {
+    switch (object) {
+        case 0:
+        case "ENVELOPE_BOUND_UNSPECIFIED":
+            return EnvelopeBound.ENVELOPE_BOUND_UNSPECIFIED;
+        case 1:
+        case "ENVELOPE_BOUND_UPPER":
+            return EnvelopeBound.ENVELOPE_BOUND_UPPER;
+        case 2:
+        case "ENVELOPE_BOUND_LOWER":
+            return EnvelopeBound.ENVELOPE_BOUND_LOWER;
+        case -1:
+        case "UNRECOGNIZED":
+        default:
+            return EnvelopeBound.UNRECOGNIZED;
+    }
+}
+exports.envelopeBoundFromJSON = envelopeBoundFromJSON;
+function envelopeBoundToJSON(object) {
+    switch (object) {
+        case EnvelopeBound.ENVELOPE_BOUND_UNSPECIFIED:
+            return "ENVELOPE_BOUND_UNSPECIFIED";
+        case EnvelopeBound.ENVELOPE_BOUND_UPPER:
+            return "ENVELOPE_BOUND_UPPER";
+        case EnvelopeBound.ENVELOPE_BOUND_LOWER:
+            return "ENVELOPE_BOUND_LOWER";
+        case EnvelopeBound.UNRECOGNIZED:
+        default:
+            return "UNRECOGNIZED";
+    }
+}
+exports.envelopeBoundToJSON = envelopeBoundToJSON;
 /** Required action for an ActionPoint. */
 var ActionPointRequiredAction;
 (function (ActionPointRequiredAction) {
@@ -1311,6 +1366,8 @@ function createBaseRouteInfo() {
         maxWindSpeedMps: undefined,
         minSpeedKnots: undefined,
         maxSpeedKnots: undefined,
+        minVisibilityM: undefined,
+        maxWindGustMps: undefined,
         optimizationMethod: "",
         autonomyLevel: 0,
         extensions: undefined,
@@ -1360,6 +1417,12 @@ exports.RouteInfo = {
         if (message.maxSpeedKnots !== undefined) {
             writer.uint32(277).float(message.maxSpeedKnots);
         }
+        if (message.minVisibilityM !== undefined) {
+            writer.uint32(285).float(message.minVisibilityM);
+        }
+        if (message.maxWindGustMps !== undefined) {
+            writer.uint32(293).float(message.maxWindGustMps);
+        }
         if (message.optimizationMethod !== "") {
             writer.uint32(402).string(message.optimizationMethod);
         }
@@ -1476,6 +1539,20 @@ exports.RouteInfo = {
                     message.maxSpeedKnots = reader.float();
                     continue;
                 }
+                case 35: {
+                    if (tag !== 285) {
+                        break;
+                    }
+                    message.minVisibilityM = reader.float();
+                    continue;
+                }
+                case 36: {
+                    if (tag !== 293) {
+                        break;
+                    }
+                    message.maxWindGustMps = reader.float();
+                    continue;
+                }
                 case 50: {
                     if (tag !== 402) {
                         break;
@@ -1521,6 +1598,8 @@ exports.RouteInfo = {
             maxWindSpeedMps: isSet(object.maxWindSpeedMps) ? globalThis.Number(object.maxWindSpeedMps) : undefined,
             minSpeedKnots: isSet(object.minSpeedKnots) ? globalThis.Number(object.minSpeedKnots) : undefined,
             maxSpeedKnots: isSet(object.maxSpeedKnots) ? globalThis.Number(object.maxSpeedKnots) : undefined,
+            minVisibilityM: isSet(object.minVisibilityM) ? globalThis.Number(object.minVisibilityM) : undefined,
+            maxWindGustMps: isSet(object.maxWindGustMps) ? globalThis.Number(object.maxWindGustMps) : undefined,
             optimizationMethod: isSet(object.optimizationMethod) ? globalThis.String(object.optimizationMethod) : "",
             autonomyLevel: isSet(object.autonomyLevel) ? autonomyLevelFromJSON(object.autonomyLevel) : 0,
             extensions: isSet(object.extensions) ? exports.Extensions.fromJSON(object.extensions) : undefined,
@@ -1570,6 +1649,12 @@ exports.RouteInfo = {
         if (message.maxSpeedKnots !== undefined) {
             obj.maxSpeedKnots = message.maxSpeedKnots;
         }
+        if (message.minVisibilityM !== undefined) {
+            obj.minVisibilityM = message.minVisibilityM;
+        }
+        if (message.maxWindGustMps !== undefined) {
+            obj.maxWindGustMps = message.maxWindGustMps;
+        }
         if (message.optimizationMethod !== "") {
             obj.optimizationMethod = message.optimizationMethod;
         }
@@ -1600,6 +1685,8 @@ exports.RouteInfo = {
         message.maxWindSpeedMps = object.maxWindSpeedMps ?? undefined;
         message.minSpeedKnots = object.minSpeedKnots ?? undefined;
         message.maxSpeedKnots = object.maxSpeedKnots ?? undefined;
+        message.minVisibilityM = object.minVisibilityM ?? undefined;
+        message.maxWindGustMps = object.maxWindGustMps ?? undefined;
         message.optimizationMethod = object.optimizationMethod ?? "";
         message.autonomyLevel = object.autonomyLevel ?? 0;
         message.extensions = (object.extensions !== undefined && object.extensions !== null)

package/dist/payloads/ChecklistEvent.d.ts

@@ -19,7 +19,18 @@ export interface ChecklistEvent {
     itemId: string;
     /** Event-specific text payload (note text, flag reason, resolution text) */
     detail: string;
-    /** Reference ID for additive entries (note_id, evidence_id) */
+    /**
+     * Which additive entry this event names: `note_id`, `evidence_id`, or `flag_id`.
+     *
+     * Each is the union key its list merges on in protocol-specification.md §7.2, so an event that
+     * omits this can only append — it cannot say which existing entry it acts on.
+     *
+     * LEGACY, and unrelated to the above: on an EVENT_TYPE_TIME_SET from a publisher that predates
+     * `corrected_field`, this instead carries the NAME of the timestamp being corrected, as one of
+     * the strings "started_at", "completed_at", "run_started_at". See `corrected_field` for that
+     * fallback path. New publishers set `corrected_field` and leave this to mean what the first
+     * paragraph says.
+     */
     referenceId: string;
     /**
      * Which RUN of `procedure_id` this event belongs to.
@@ -30,6 +41,29 @@ export interface ChecklistEvent {
     runId: string;
     /** Set on EVENT_TYPE_EVIDENCE_ATTACHED. Metadata only — see ChecklistEvidence.proto. */
     evidence: ChecklistItemEvidence | undefined;
+    /**
+     * The corrected instant, on EVENT_TYPE_TIME_SET.
+     *
+     * This used to travel as a UTC ISO-8601 string in `detail`, in a message that already imports
+     * google.protobuf.Timestamp — so every consumer wrote its own parser, and every parser was a
+     * chance to disagree about an instant in a safety record.
+     *
+     * LEGACY FALLBACK: a publisher predating this field leaves it unset and writes the string. A
+     * receiver reads this field when `corrected_field` is set, and falls back to parsing `detail`
+     * only when `corrected_field == TIME_FIELD_UNKNOWN` — never the other way round, so a
+     * publisher writing both cannot be misread. Publishers SHOULD write both until every consumer
+     * is known to read the typed pair; recordings full of the string form must keep replaying.
+     */
+    correctedTime: Date | undefined;
+    /**
+     * Which timestamp `corrected_time` replaces. Set together with it, or neither.
+     *
+     * TIME_FIELD_UNKNOWN on an EVENT_TYPE_TIME_SET means a legacy publisher: fall back to the
+     * `reference_id` string ("started_at", "completed_at", "run_started_at"). An unrecognised
+     * value here is dropped, not guessed — a correction applied to the wrong field is worse than
+     * one not applied at all.
+     */
+    correctedField: ChecklistEvent_TimeField;
 }
 export declare enum ChecklistEvent_EventType {
     EVENT_TYPE_UNKNOWN = 0,
@@ -38,6 +72,21 @@ export declare enum ChecklistEvent_EventType {
     EVENT_TYPE_ITEM_COMPLETED = 3,
     EVENT_TYPE_ITEM_REVERTED = 4,
     EVENT_TYPE_NOTE_ADDED = 5,
+    /**
+     * EVENT_TYPE_ITEM_FLAGGED - An issue raised on an item, and the moment it was cleared.
+     *
+     * Both carry the flag they act on in `reference_id` — the `flag_id`, which is the union key
+     * ChecklistState.ItemState.flags merges on. Without it a receiver folding one of these into
+     * `flags` has nothing to match against and can only append, so resolving a flag would add a
+     * second open one instead of closing the first.
+     *
+     * A publisher of FLAG_RESOLVED must ALSO write the resolution triple on the ItemFlag —
+     * `resolved_at`, `resolved_by`, `resolution` — because that is the half that survives in a
+     * snapshot. The event is the live path; a station bootstrapping later sees only the state.
+     * Those three are absorbing and settled earliest-wins, per protocol-specification.md §7.2: a
+     * peer that never saw the resolution must not reopen it, and two stations genuinely clearing
+     * one flag are decided by the earlier time as a value, never by whose snapshot landed last.
+     */
     EVENT_TYPE_ITEM_FLAGGED = 6,
     EVENT_TYPE_FLAG_RESOLVED = 7,
     /**
@@ -63,9 +112,9 @@ export declare enum ChecklistEvent_EventType {
      * "confirmed" row, and changes nothing. The guard is right for genuine concurrent completion
      * and must not be relaxed for this.
      *
-     * `detail` carries the corrected instant as a UTC ISO-8601 string. `reference_id` names the
-     * field being corrected: "started_at", "completed_at" or "run_started_at" (the last one
-     * ignores item_id and moves the run's own start).
+     * The corrected instant travels in `corrected_time` and the field it corrects in
+     * `corrected_field`. See those fields for what a receiver does with a publisher that
+     * predates them.
      *
      * Applying it patches ONLY that timestamp — status and author are untouched — and it is
      * recorded as its own kind of entry. In a safety record a corrected time that renders
@@ -89,6 +138,23 @@ export declare enum ChecklistEvent_EventType {
 }
 export declare function checklistEvent_EventTypeFromJSON(object: any): ChecklistEvent_EventType;
 export declare function checklistEvent_EventTypeToJSON(object: ChecklistEvent_EventType): string;
+/**
+ * Which timestamp an EVENT_TYPE_TIME_SET corrects.
+ *
+ * An enum rather than the field's name as a string, because a string target is matched by
+ * every consumer against its own spelling: a typo is not an error, it is a silent no-op that
+ * logs an audited correction and patches nothing.
+ */
+export declare enum ChecklistEvent_TimeField {
+    TIME_FIELD_UNKNOWN = 0,
+    TIME_FIELD_ITEM_STARTED_AT = 1,
+    TIME_FIELD_ITEM_COMPLETED_AT = 2,
+    /** TIME_FIELD_RUN_STARTED_AT - The run's own start. Ignores `item_id`. */
+    TIME_FIELD_RUN_STARTED_AT = 3,
+    UNRECOGNIZED = -1
+}
+export declare function checklistEvent_TimeFieldFromJSON(object: any): ChecklistEvent_TimeField;
+export declare function checklistEvent_TimeFieldToJSON(object: ChecklistEvent_TimeField): string;
 export declare const ChecklistEvent: MessageFns<ChecklistEvent, "keelson.ChecklistEvent">;
 type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
 type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {

package/dist/payloads/ChecklistEvent.js

@@ -5,7 +5,7 @@
 //   protoc               v6.30.2
 // source: ChecklistEvent.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChecklistEvent = exports.checklistEvent_EventTypeToJSON = exports.checklistEvent_EventTypeFromJSON = exports.ChecklistEvent_EventType = void 0;
+exports.ChecklistEvent = exports.checklistEvent_TimeFieldToJSON = exports.checklistEvent_TimeFieldFromJSON = exports.ChecklistEvent_TimeField = exports.checklistEvent_EventTypeToJSON = exports.checklistEvent_EventTypeFromJSON = exports.ChecklistEvent_EventType = void 0;
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 const ChecklistEvidence_1 = require("./ChecklistEvidence");
@@ -19,6 +19,21 @@ var ChecklistEvent_EventType;
     ChecklistEvent_EventType[ChecklistEvent_EventType["EVENT_TYPE_ITEM_COMPLETED"] = 3] = "EVENT_TYPE_ITEM_COMPLETED";
     ChecklistEvent_EventType[ChecklistEvent_EventType["EVENT_TYPE_ITEM_REVERTED"] = 4] = "EVENT_TYPE_ITEM_REVERTED";
     ChecklistEvent_EventType[ChecklistEvent_EventType["EVENT_TYPE_NOTE_ADDED"] = 5] = "EVENT_TYPE_NOTE_ADDED";
+    /**
+     * EVENT_TYPE_ITEM_FLAGGED - An issue raised on an item, and the moment it was cleared.
+     *
+     * Both carry the flag they act on in `reference_id` — the `flag_id`, which is the union key
+     * ChecklistState.ItemState.flags merges on. Without it a receiver folding one of these into
+     * `flags` has nothing to match against and can only append, so resolving a flag would add a
+     * second open one instead of closing the first.
+     *
+     * A publisher of FLAG_RESOLVED must ALSO write the resolution triple on the ItemFlag —
+     * `resolved_at`, `resolved_by`, `resolution` — because that is the half that survives in a
+     * snapshot. The event is the live path; a station bootstrapping later sees only the state.
+     * Those three are absorbing and settled earliest-wins, per protocol-specification.md §7.2: a
+     * peer that never saw the resolution must not reopen it, and two stations genuinely clearing
+     * one flag are decided by the earlier time as a value, never by whose snapshot landed last.
+     */
     ChecklistEvent_EventType[ChecklistEvent_EventType["EVENT_TYPE_ITEM_FLAGGED"] = 6] = "EVENT_TYPE_ITEM_FLAGGED";
     ChecklistEvent_EventType[ChecklistEvent_EventType["EVENT_TYPE_FLAG_RESOLVED"] = 7] = "EVENT_TYPE_FLAG_RESOLVED";
     /**
@@ -44,9 +59,9 @@ var ChecklistEvent_EventType;
      * "confirmed" row, and changes nothing. The guard is right for genuine concurrent completion
      * and must not be relaxed for this.
      *
-     * `detail` carries the corrected instant as a UTC ISO-8601 string. `reference_id` names the
-     * field being corrected: "started_at", "completed_at" or "run_started_at" (the last one
-     * ignores item_id and moves the run's own start).
+     * The corrected instant travels in `corrected_time` and the field it corrects in
+     * `corrected_field`. See those fields for what a receiver does with a publisher that
+     * predates them.
      *
      * Applying it patches ONLY that timestamp — status and author are untouched — and it is
      * recorded as its own kind of entry. In a safety record a corrected time that renders
@@ -160,6 +175,59 @@ function checklistEvent_EventTypeToJSON(object) {
     }
 }
 exports.checklistEvent_EventTypeToJSON = checklistEvent_EventTypeToJSON;
+/**
+ * Which timestamp an EVENT_TYPE_TIME_SET corrects.
+ *
+ * An enum rather than the field's name as a string, because a string target is matched by
+ * every consumer against its own spelling: a typo is not an error, it is a silent no-op that
+ * logs an audited correction and patches nothing.
+ */
+var ChecklistEvent_TimeField;
+(function (ChecklistEvent_TimeField) {
+    ChecklistEvent_TimeField[ChecklistEvent_TimeField["TIME_FIELD_UNKNOWN"] = 0] = "TIME_FIELD_UNKNOWN";
+    ChecklistEvent_TimeField[ChecklistEvent_TimeField["TIME_FIELD_ITEM_STARTED_AT"] = 1] = "TIME_FIELD_ITEM_STARTED_AT";
+    ChecklistEvent_TimeField[ChecklistEvent_TimeField["TIME_FIELD_ITEM_COMPLETED_AT"] = 2] = "TIME_FIELD_ITEM_COMPLETED_AT";
+    /** TIME_FIELD_RUN_STARTED_AT - The run's own start. Ignores `item_id`. */
+    ChecklistEvent_TimeField[ChecklistEvent_TimeField["TIME_FIELD_RUN_STARTED_AT"] = 3] = "TIME_FIELD_RUN_STARTED_AT";
+    ChecklistEvent_TimeField[ChecklistEvent_TimeField["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(ChecklistEvent_TimeField || (exports.ChecklistEvent_TimeField = ChecklistEvent_TimeField = {}));
+function checklistEvent_TimeFieldFromJSON(object) {
+    switch (object) {
+        case 0:
+        case "TIME_FIELD_UNKNOWN":
+            return ChecklistEvent_TimeField.TIME_FIELD_UNKNOWN;
+        case 1:
+        case "TIME_FIELD_ITEM_STARTED_AT":
+            return ChecklistEvent_TimeField.TIME_FIELD_ITEM_STARTED_AT;
+        case 2:
+        case "TIME_FIELD_ITEM_COMPLETED_AT":
+            return ChecklistEvent_TimeField.TIME_FIELD_ITEM_COMPLETED_AT;
+        case 3:
+        case "TIME_FIELD_RUN_STARTED_AT":
+            return ChecklistEvent_TimeField.TIME_FIELD_RUN_STARTED_AT;
+        case -1:
+        case "UNRECOGNIZED":
+        default:
+            return ChecklistEvent_TimeField.UNRECOGNIZED;
+    }
+}
+exports.checklistEvent_TimeFieldFromJSON = checklistEvent_TimeFieldFromJSON;
+function checklistEvent_TimeFieldToJSON(object) {
+    switch (object) {
+        case ChecklistEvent_TimeField.TIME_FIELD_UNKNOWN:
+            return "TIME_FIELD_UNKNOWN";
+        case ChecklistEvent_TimeField.TIME_FIELD_ITEM_STARTED_AT:
+            return "TIME_FIELD_ITEM_STARTED_AT";
+        case ChecklistEvent_TimeField.TIME_FIELD_ITEM_COMPLETED_AT:
+            return "TIME_FIELD_ITEM_COMPLETED_AT";
+        case ChecklistEvent_TimeField.TIME_FIELD_RUN_STARTED_AT:
+            return "TIME_FIELD_RUN_STARTED_AT";
+        case ChecklistEvent_TimeField.UNRECOGNIZED:
+        default:
+            return "UNRECOGNIZED";
+    }
+}
+exports.checklistEvent_TimeFieldToJSON = checklistEvent_TimeFieldToJSON;
 function createBaseChecklistEvent() {
     return {
         $type: "keelson.ChecklistEvent",
@@ -176,6 +244,8 @@ function createBaseChecklistEvent() {
         referenceId: "",
         runId: "",
         evidence: undefined,
+        correctedTime: undefined,
+        correctedField: 0,
     };
 }
 exports.ChecklistEvent = {
@@ -220,6 +290,12 @@ exports.ChecklistEvent = {
         if (message.evidence !== undefined) {
             ChecklistEvidence_1.ChecklistItemEvidence.encode(message.evidence, writer.uint32(106).fork()).join();
         }
+        if (message.correctedTime !== undefined) {
+            timestamp_1.Timestamp.encode(toTimestamp(message.correctedTime), writer.uint32(114).fork()).join();
+        }
+        if (message.correctedField !== 0) {
+            writer.uint32(120).int32(message.correctedField);
+        }
         return writer;
     },
     decode(input, length) {
@@ -320,6 +396,20 @@ exports.ChecklistEvent = {
                     message.evidence = ChecklistEvidence_1.ChecklistItemEvidence.decode(reader, reader.uint32());
                     continue;
                 }
+                case 14: {
+                    if (tag !== 114) {
+                        break;
+                    }
+                    message.correctedTime = fromTimestamp(timestamp_1.Timestamp.decode(reader, reader.uint32()));
+                    continue;
+                }
+                case 15: {
+                    if (tag !== 120) {
+                        break;
+                    }
+                    message.correctedField = reader.int32();
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -344,6 +434,8 @@ exports.ChecklistEvent = {
             referenceId: isSet(object.referenceId) ? globalThis.String(object.referenceId) : "",
             runId: isSet(object.runId) ? globalThis.String(object.runId) : "",
             evidence: isSet(object.evidence) ? ChecklistEvidence_1.ChecklistItemEvidence.fromJSON(object.evidence) : undefined,
+            correctedTime: isSet(object.correctedTime) ? fromJsonTimestamp(object.correctedTime) : undefined,
+            correctedField: isSet(object.correctedField) ? checklistEvent_TimeFieldFromJSON(object.correctedField) : 0,
         };
     },
     toJSON(message) {
@@ -387,6 +479,12 @@ exports.ChecklistEvent = {
         if (message.evidence !== undefined) {
             obj.evidence = ChecklistEvidence_1.ChecklistItemEvidence.toJSON(message.evidence);
         }
+        if (message.correctedTime !== undefined) {
+            obj.correctedTime = message.correctedTime.toISOString();
+        }
+        if (message.correctedField !== 0) {
+            obj.correctedField = checklistEvent_TimeFieldToJSON(message.correctedField);
+        }
         return obj;
     },
     create(base) {
@@ -409,6 +507,8 @@ exports.ChecklistEvent = {
         message.evidence = (object.evidence !== undefined && object.evidence !== null)
             ? ChecklistEvidence_1.ChecklistItemEvidence.fromPartial(object.evidence)
             : undefined;
+        message.correctedTime = object.correctedTime ?? undefined;
+        message.correctedField = object.correctedField ?? 0;
         return message;
     },
 };

package/dist/payloads/ChecklistEvidence.d.ts

@@ -28,7 +28,7 @@ export interface ChecklistItemEvidence {
     /** When the image was TAKEN, which is not necessarily when it was attached. */
     capturedAt: Date | undefined;
     author: string;
-    authorRocSite: string;
+    authorSite: string;
     /**
      * Full media type, e.g. "image/jpeg". Drives the Blob the receiver builds, and is echoed into
      * the CompressedImage's own `format` so a recovered blob is self-describing.

package/dist/payloads/ChecklistEvidence.js

@@ -65,7 +65,7 @@ function createBaseChecklistItemEvidence() {
         caption: "",
         capturedAt: undefined,
         author: "",
-        authorRocSite: "",
+        authorSite: "",
         mediaType: "",
         byteSize: 0,
         width: 0,
@@ -88,8 +88,8 @@ exports.ChecklistItemEvidence = {
         if (message.author !== "") {
             writer.uint32(34).string(message.author);
         }
-        if (message.authorRocSite !== "") {
-            writer.uint32(42).string(message.authorRocSite);
+        if (message.authorSite !== "") {
+            writer.uint32(42).string(message.authorSite);
         }
         if (message.mediaType !== "") {
             writer.uint32(50).string(message.mediaType);
@@ -147,7 +147,7 @@ exports.ChecklistItemEvidence = {
                     if (tag !== 42) {
                         break;
                     }
-                    message.authorRocSite = reader.string();
+                    message.authorSite = reader.string();
                     continue;
                 }
                 case 6: {
@@ -200,7 +200,7 @@ exports.ChecklistItemEvidence = {
             caption: isSet(object.caption) ? globalThis.String(object.caption) : "",
             capturedAt: isSet(object.capturedAt) ? fromJsonTimestamp(object.capturedAt) : undefined,
             author: isSet(object.author) ? globalThis.String(object.author) : "",
-            authorRocSite: isSet(object.authorRocSite) ? globalThis.String(object.authorRocSite) : "",
+            authorSite: isSet(object.authorSite) ? globalThis.String(object.authorSite) : "",
             mediaType: isSet(object.mediaType) ? globalThis.String(object.mediaType) : "",
             byteSize: isSet(object.byteSize) ? globalThis.Number(object.byteSize) : 0,
             width: isSet(object.width) ? globalThis.Number(object.width) : 0,
@@ -222,8 +222,8 @@ exports.ChecklistItemEvidence = {
         if (message.author !== "") {
             obj.author = message.author;
         }
-        if (message.authorRocSite !== "") {
-            obj.authorRocSite = message.authorRocSite;
+        if (message.authorSite !== "") {
+            obj.authorSite = message.authorSite;
         }
         if (message.mediaType !== "") {
             obj.mediaType = message.mediaType;
@@ -251,7 +251,7 @@ exports.ChecklistItemEvidence = {
         message.caption = object.caption ?? "";
         message.capturedAt = object.capturedAt ?? undefined;
         message.author = object.author ?? "";
-        message.authorRocSite = object.authorRocSite ?? "";
+        message.authorSite = object.authorSite ?? "";
         message.mediaType = object.mediaType ?? "";
         message.byteSize = object.byteSize ?? 0;
         message.width = object.width ?? 0;

package/dist/payloads/ChecklistPresence.d.ts

@@ -31,10 +31,16 @@ export interface ChecklistPresence {
      */
     openRunIds: string[];
 }
+/**
+ * Renamed from CURSOR_* to carry the enum's own name, which is what every other enum in this
+ * family does (RUN_STATUS_, ITEM_STATUS_, SOURCE_, EVENT_TYPE_). The WIRE IS UNCHANGED — only
+ * the generated identifiers move, so a recording decodes identically and a consumer notices at
+ * compile time rather than at runtime.
+ */
 export declare enum ChecklistPresence_CursorState {
-    CURSOR_IDLE = 0,
-    CURSOR_VIEWING = 1,
-    CURSOR_EDITING_NOTE = 2,
+    CURSOR_STATE_IDLE = 0,
+    CURSOR_STATE_VIEWING = 1,
+    CURSOR_STATE_EDITING_NOTE = 2,
     UNRECOGNIZED = -1
 }
 export declare function checklistPresence_CursorStateFromJSON(object: any): ChecklistPresence_CursorState;

package/dist/payloads/ChecklistPresence.js

@@ -10,24 +10,30 @@ exports.ChecklistPresence = exports.checklistPresence_CursorStateToJSON = export
 const wire_1 = require("@bufbuild/protobuf/wire");
 const timestamp_1 = require("./google/protobuf/timestamp");
 const typeRegistry_1 = require("./typeRegistry");
+/**
+ * Renamed from CURSOR_* to carry the enum's own name, which is what every other enum in this
+ * family does (RUN_STATUS_, ITEM_STATUS_, SOURCE_, EVENT_TYPE_). The WIRE IS UNCHANGED — only
+ * the generated identifiers move, so a recording decodes identically and a consumer notices at
+ * compile time rather than at runtime.
+ */
 var ChecklistPresence_CursorState;
 (function (ChecklistPresence_CursorState) {
-    ChecklistPresence_CursorState[ChecklistPresence_CursorState["CURSOR_IDLE"] = 0] = "CURSOR_IDLE";
-    ChecklistPresence_CursorState[ChecklistPresence_CursorState["CURSOR_VIEWING"] = 1] = "CURSOR_VIEWING";
-    ChecklistPresence_CursorState[ChecklistPresence_CursorState["CURSOR_EDITING_NOTE"] = 2] = "CURSOR_EDITING_NOTE";
+    ChecklistPresence_CursorState[ChecklistPresence_CursorState["CURSOR_STATE_IDLE"] = 0] = "CURSOR_STATE_IDLE";
+    ChecklistPresence_CursorState[ChecklistPresence_CursorState["CURSOR_STATE_VIEWING"] = 1] = "CURSOR_STATE_VIEWING";
+    ChecklistPresence_CursorState[ChecklistPresence_CursorState["CURSOR_STATE_EDITING_NOTE"] = 2] = "CURSOR_STATE_EDITING_NOTE";
     ChecklistPresence_CursorState[ChecklistPresence_CursorState["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
 })(ChecklistPresence_CursorState || (exports.ChecklistPresence_CursorState = ChecklistPresence_CursorState = {}));
 function checklistPresence_CursorStateFromJSON(object) {
     switch (object) {
         case 0:
-        case "CURSOR_IDLE":
-            return ChecklistPresence_CursorState.CURSOR_IDLE;
+        case "CURSOR_STATE_IDLE":
+            return ChecklistPresence_CursorState.CURSOR_STATE_IDLE;
         case 1:
-        case "CURSOR_VIEWING":
-            return ChecklistPresence_CursorState.CURSOR_VIEWING;
+        case "CURSOR_STATE_VIEWING":
+            return ChecklistPresence_CursorState.CURSOR_STATE_VIEWING;
         case 2:
-        case "CURSOR_EDITING_NOTE":
-            return ChecklistPresence_CursorState.CURSOR_EDITING_NOTE;
+        case "CURSOR_STATE_EDITING_NOTE":
+            return ChecklistPresence_CursorState.CURSOR_STATE_EDITING_NOTE;
         case -1:
         case "UNRECOGNIZED":
         default:
@@ -37,12 +43,12 @@ function checklistPresence_CursorStateFromJSON(object) {
 exports.checklistPresence_CursorStateFromJSON = checklistPresence_CursorStateFromJSON;
 function checklistPresence_CursorStateToJSON(object) {
     switch (object) {
-        case ChecklistPresence_CursorState.CURSOR_IDLE:
-            return "CURSOR_IDLE";
-        case ChecklistPresence_CursorState.CURSOR_VIEWING:
-            return "CURSOR_VIEWING";
-        case ChecklistPresence_CursorState.CURSOR_EDITING_NOTE:
-            return "CURSOR_EDITING_NOTE";
+        case ChecklistPresence_CursorState.CURSOR_STATE_IDLE:
+            return "CURSOR_STATE_IDLE";
+        case ChecklistPresence_CursorState.CURSOR_STATE_VIEWING:
+            return "CURSOR_STATE_VIEWING";
+        case ChecklistPresence_CursorState.CURSOR_STATE_EDITING_NOTE:
+            return "CURSOR_STATE_EDITING_NOTE";
         case ChecklistPresence_CursorState.UNRECOGNIZED:
         default:
             return "UNRECOGNIZED";