feat: seal fresh continuous

external_types/DatabaseCatalogAPI.yaml

@@ -332,8 +332,9 @@ paths:
       - $ref: "#/components/parameters/feed_id_path_param"
     get:
       description: >
-        Returns the continuous coverage of a GTFS feed: `latest_state` and `latest_failure`,
-        plus the history, one entry per dataset ordered by `downloaded_at` from newest to oldest.
+        Returns the continuous coverage of a GTFS feed: `latest_state` and `latest_failure`, each
+        carrying the two datasets it compares, plus the history, one entry per dataset ordered by
+        `downloaded_at` from newest to oldest.
         Each entry carries the service window the dataset covers, the window declared in its
         `feed_info.txt`, whether the two agree, and how much that dataset overlaps the previous
         (older) one.
@@ -1394,9 +1395,8 @@ components:
       type: object
       description: >
         `latest_state` is the feed's latest dataset measured against the one before it;
-        `latest_failure` is the same measurement at the criterion's last observed failure. Both
-        have the structure of an `items[]` entry, and either can be null. Together they name at
-        most four datasets, shared when the latest state is itself the failure.
+        `latest_failure` is the same at the criterion's last observed failure. Each carries both
+        datasets of the comparison, and either can be null.
       required:
         - feed_id
         - items
@@ -1409,9 +1409,9 @@ components:
           description: Unique identifier of the GTFS feed.
           example: mdb-123
         latest_state:
-          $ref: "#/components/schemas/GtfsFeedContinuousCoverage"
+          $ref: "#/components/schemas/GtfsFeedContinuousCoverageBoundary"
         latest_failure:
-          $ref: "#/components/schemas/GtfsFeedContinuousCoverage"
+          $ref: "#/components/schemas/GtfsFeedContinuousCoverageBoundary"
         total:
           type: integer
           description: Total number of matching datasets regardless of limit and offset.
@@ -1432,6 +1432,19 @@ components:
           items:
             $ref: "#/components/schemas/GtfsFeedContinuousCoverage"
 
+    GtfsFeedContinuousCoverageBoundary:
+      type: object
+      description: >
+        Two successive datasets: `newer` and the one downloaded immediately before it. `older` is
+        null when `newer` is the feed's first dataset.
+      required:
+        - newer
+      properties:
+        newer:
+          $ref: "#/components/schemas/GtfsFeedContinuousCoverage"
+        older:
+          $ref: "#/components/schemas/GtfsFeedContinuousCoverage"
+
     GtfsFeedContinuousCoverage:
       type: object
       description: >
@@ -1441,9 +1454,10 @@ components:
 
         Three windows are reported. `service_window` is the service dates the validator derived from
         `calendar.txt` and `calendar_dates.txt`; `feed_info_window` is what the dataset's
-        `feed_info.txt` declares; `coverage_window` is the one the calculation actually used, with
-        `coverage_window_source` naming which of the two it came from. Any of them may be absent when
-        the dataset did not supply the underlying files.
+        `feed_info.txt` declares; `coverage_window` is the one the criterion measures by - the
+        declared window, falling back to the validated one - with `coverage_window_source` naming
+        which of the two it came from. Any of them may be absent when the dataset did not supply
+        the underlying files.
       required:
         - dataset_id
         - is_latest
@@ -1473,14 +1487,13 @@ components:
           description: >
             Which input `coverage_window` was taken from.
 
+            * `feed_info` - the dates declared in `feed_info.txt`.
             * `service_dates` - the service dates derived by the validator from `calendar.txt` and
-              `calendar_dates.txt`.
-            * `feed_info` - the dates declared in `feed_info.txt`, used only when the service dates
-              are missing.
+              `calendar_dates.txt`, used when the dataset declares no range.
           enum:
             - service_dates
             - feed_info
-          example: service_dates
+          example: feed_info
         within_max_coverage_window:
           type: boolean
           nullable: true
@@ -2713,4 +2726,4 @@ components:
       $ref: "./BearerTokenSchema.yaml#/components/securitySchemes/Authentication"
 
 security:
-  - Authentication: []
+  - Authentication: []

messages/en.json

@@ -324,16 +324,16 @@
     "sealLostAt": "Seal of Reliability lost",
     "sealEvaluatedAt": "Seal of Reliability last evaluated",
     "sealAvailabilityIntro": "Daily fetch results over the last {months, plural, one {# month} other {# months}}.",
-    "sealAvailabilityNoFailures": "Every day ended with a successful fetch.",
-    "sealAvailabilityRecovered": "{count, plural, one {# day ended with a failed fetch} other {# days ended with a failed fetch}} (last on {date}), recovered within the {graceDays}-day grace window.",
-    "sealAvailabilityAtRisk": "The feed has been unreachable since {date}.",
-    "sealAvailabilityAtRiskUndated": "The feed has been unreachable.",
+    "sealAvailabilityNoFailures": "<b>Every day ended with a successful fetch.</b>",
+    "sealAvailabilityRecovered": "<b>{count, plural, one {# day ended with a failed fetch} other {# days ended with a failed fetch}}</b> (last on {date}), recovered within the {graceDays}-day grace window.",
+    "sealAvailabilityAtRisk": "The feed has been <b>unreachable since {date}</b>.",
+    "sealAvailabilityAtRiskUndated": "The feed has been <b>unreachable</b>.",
     "sealAvailabilityGraceTitle": "{days, plural, one {# day} other {# days}} left to restore access",
     "sealAvailabilityGraceDescription": "Restore access to the feed before the grace period ends to keep the Seal.",
-    "sealAvailabilityFailing": "The feed has been unreachable since {date}. Ensure this feed is available consistently for {months, plural, one {# month} other {# months}} to pass this criterion.",
-    "sealAvailabilityFailingUndated": "The feed has been unreachable. Ensure this feed is available consistently for {months, plural, one {# month} other {# months}} to pass this criterion.",
-    "sealAvailabilityProbation": "Fetches are succeeding again. This criterion is rebuilding its six-month record after its last recorded error on {date}.",
-    "sealAvailabilityProbationUndated": "Fetches are succeeding again. This criterion is rebuilding its six-month record after a confirmed failure.",
+    "sealAvailabilityFailing": "The feed has been <b>unreachable since {date}</b>. Ensure this feed is available consistently for {months, plural, one {# month} other {# months}} to pass this criterion.",
+    "sealAvailabilityFailingUndated": "The feed has been <b>unreachable</b>. Ensure this feed is available consistently for {months, plural, one {# month} other {# months}} to pass this criterion.",
+    "sealAvailabilityProbation": "<b>Fetches are succeeding again.</b> This criterion is rebuilding its six-month record after its last recorded error on {date}.",
+    "sealAvailabilityProbationUndated": "<b>Fetches are succeeding again.</b> This criterion is rebuilding its six-month record after a confirmed failure.",
     "sealAvailabilityNotApplicable": "Daily availability checks don't apply to this feed.",
     "sealAvailabilityNoData": "No availability checks have been recorded for this feed yet.",
     "sealAvailabilityError": "Availability history could not be loaded right now.",
@@ -351,14 +351,14 @@
     "sealCompliantNoReportSubtitle": "No validation report available",
     "sealCompliantNotEvaluatedSubtitle": "Not evaluated yet",
     "sealCompliantNotApplicableSubtitle": "Not applicable to this feed",
-    "sealCompliantPassing": "The latest dataset was validated on {date} with no errors.",
-    "sealCompliantPassingUndated": "The latest dataset validates with no errors.",
-    "sealCompliantAtRisk": "The latest validation report has {count, plural, one {# error} other {# errors}}.",
+    "sealCompliantPassing": "The latest dataset was validated on {date} with <b>no errors</b>.",
+    "sealCompliantPassingUndated": "The latest dataset validates with <b>no errors</b>.",
+    "sealCompliantAtRisk": "The latest validation report has <b>{count, plural, one {# error} other {# errors}}</b>.",
     "sealCompliantGraceTitle": "{days, plural, one {# day} other {# days}} left to resolve errors",
     "sealCompliantGraceDescription": "Resolve these errors before the grace period ends to keep the Seal.",
-    "sealCompliantFailing": "The latest validation report has {count, plural, one {# error} other {# errors}}. Resolve these validation errors to pass this criterion.",
-    "sealCompliantProbation": "The latest dataset validates with no errors. This criterion is rebuilding its six-month record after its last recorded error on {date}.",
-    "sealCompliantProbationUndated": "The latest dataset validates with no errors. This criterion is rebuilding its six-month record after a confirmed failure.",
+    "sealCompliantFailing": "The latest validation report has <b>{count, plural, one {# error} other {# errors}}</b>. Resolve these validation errors to pass this criterion.",
+    "sealCompliantProbation": "The latest dataset validates with <b>no errors</b>. This criterion is rebuilding its six-month record after its last recorded error on {date}.",
+    "sealCompliantProbationUndated": "The latest dataset validates with <b>no errors</b>. This criterion is rebuilding its six-month record after a confirmed failure.",
     "sealCompliantNotApplicable": "Validation doesn't apply to this feed.",
     "sealCompliantNoReport": "No validation report is available for this feed's latest dataset.",
     "sealCompliantNoData": "This feed's compliance has not been evaluated yet.",
@@ -375,6 +375,89 @@
     "sealComplianceViewReportLink": "Validation report",
     "sealComplianceOccurrences": "{count, plural, one {# time} other {# times}}",
     "sealComplianceHistoryError": "Earlier datasets could not be loaded, so new errors are not marked.",
+    "sealFreshRollingCoveredSubtitle": "Coverage extends past the {minimumDays}-day minimum",
+    "sealFreshRollingShortSubtitle": "Coverage falls short of the {minimumDays}-day minimum",
+    "sealFreshRollingNoWindowSubtitle": "No service coverage window available",
+    "sealFreshRollingNotEvaluatedSubtitle": "Not evaluated yet",
+    "sealFreshRollingNotApplicableSubtitle": "Not applicable — this feed is seasonal",
+    "sealFreshRollingPassing": "The latest dataset covers service through {date}, <b>{days, plural, one {# day} other {# days}} ahead of today</b>, {beyond, plural, one {# day} other {# days}} beyond the {minimumDays}-day minimum.",
+    "sealFreshRollingPassingExact": "The latest dataset covers service through {date}, <b>{days, plural, one {# day} other {# days}} ahead of today</b> — exactly the {minimumDays}-day minimum.",
+    "sealFreshRollingPassingShort": "The latest dataset covers service through {date}, <b>less than {minimumDays} days ahead</b>. This is not counting against the Seal yet, but it will if the next check confirms it.",
+    "sealFreshRollingAtRisk": "The latest dataset covers service <b>only through {date}</b>. Publish an update with at least {minimumDays} days of future service.",
+    "sealFreshRollingFailing": "The latest dataset covers service <b>only through {date}</b>. Publish an update extending coverage at least {minimumDays} days ahead to pass this criterion.",
+    "sealFreshRollingProbation": "<b>Coverage now extends through {date}.</b> This criterion is rebuilding its six-month record after its last recorded failure on {failureDate}.",
+    "sealFreshRollingProbationUndated": "<b>Coverage now extends through {date}.</b> This criterion is rebuilding its six-month record after a confirmed failure.",
+    "sealFreshRollingNoWindow": "No service coverage window is available for this feed's latest dataset.",
+    "sealFreshRollingNoData": "This feed's service coverage has not been evaluated yet.",
+    "sealFreshRollingNotApplicable": "Seasonal feeds don't run service year-round, so the rolling 7-day coverage check doesn't apply to them.",
+    "sealFreshRollingGraceTitle": "{days, plural, one {# day} other {# days}} left to extend coverage",
+    "sealFreshRollingGraceDescription": "Publish a dataset covering at least {minimumDays} days of service before the grace period ends to keep the Seal.",
+    "sealFreshRollingMissingCoverageLabel": "Missing feed coverage",
+    "sealFreshRollingMinimumLabel": "Required by",
+    "sealFreshRollingStepToday": "Today (UTC)",
+    "sealFreshRollingStepRequired": "Required by",
+    "sealFreshRollingStepRequiredTooltip": "Today + {minimumDays} days",
+    "sealFreshRollingStepCoverageEnd": "Coverage ends",
+    "sealFreshRollingStepMinimum": "+{days}d min",
+    "sealFreshRollingStepMargin": "{days}d margin",
+    "sealFreshRollingStepNoMargin": "no margin",
+    "sealFreshRollingStepShort": "{days}d short",
+    "sealFreshRollingDiagramLabel": "Service coverage from {start} to {end}, required by {minimum} to meet the {minimumDays}-day minimum.",
+    "sealContinuousContinuousSubtitle": "Continuous coverage, no gaps",
+    "sealContinuousGapSubtitle": "Gap between datasets",
+    "sealContinuousWindowSubtitle": "Service window over {years} years",
+    "sealContinuousNoHistorySubtitle": "No coverage history available",
+    "sealContinuousNotEvaluatedSubtitle": "Not evaluated yet",
+    "sealContinuousNotApplicableSubtitle": "Not applicable to this feed",
+    "sealContinuousIntro": "Checks that successive datasets overlap with no gaps, and that the service window stays within the {years}-year limit.",
+    "sealContinuousPassing": "The latest dataset <b>overlaps by {days, plural, one {# day} other {# days}}</b>, the one before it, and its service window <b>stays inside the {years}-year limit</b>.",
+    "sealContinuousPassingNoOverlap": "The latest dataset's service window picks up where the previous one ends, with <b>no uncovered day</b>, and <b>stays inside the {years}-year limit</b>.",
+    "sealContinuousPassingSingle": "This feed has <b>only one dataset</b> so far. Its service window <b>stays inside the {years}-year limit</b>.",
+    "sealContinuousGapFailing": "<b>{days, plural, one {# day} other {# days}} of service are uncovered</b> between the dataset downloaded on {date} and the one before it. Publish datasets whose service windows meet or overlap to pass this criterion.",
+    "sealContinuousWindowFailing": "The dataset downloaded on {date} declares a <b>service window longer than the {years}-year limit</b>. Shorten it to pass this criterion.",
+    "sealContinuousFailing": "The dataset downloaded on {date} <b>broke continuous coverage</b>. Publish datasets whose service windows meet or overlap and stay inside the {years}-year limit.",
+    "sealContinuousFailingUndated": "<b>Continuous coverage is broken.</b> Publish datasets whose service windows meet or overlap and stay inside the {years}-year limit.",
+    "sealContinuousProbation": "<b>Coverage is continuous again.</b> This criterion is rebuilding its six-month record after its last recorded failure on {date}.",
+    "sealContinuousProbationUndated": "<b>Coverage is continuous again.</b> This criterion is rebuilding its six-month record after a confirmed failure.",
+    "sealContinuousProbationDetail": "This feed was <b>fixed on {fixedDate}</b> and is now continuous. This feed must maintain this continuity until {endDate} to pass this criterion.",
+    "sealContinuousNotApplicable": "Continuous coverage checks don't apply to this feed.",
+    "sealContinuousNoHistory": "No coverage history is available for this feed yet.",
+    "sealContinuousNoHistoryDescription": "We couldn't load this feed's dataset coverage history. Please try again later.",
+    "sealContinuousNoData": "This feed's continuous coverage has not been evaluated yet.",
+    "sealContinuousFilesTitle": "Files used in this calculation",
+    "sealContinuousFileMissing": "{name} (missing)",
+    "sealContinuousWindowSectionTitle": "Service window length",
+    "sealContinuousWindowSectionDescription": "Checks that the latest dataset's service window does not run longer than {years} years.",
+    "sealContinuousCoverageStart": "Coverage start",
+    "sealContinuousCoverageEnd": "Coverage end",
+    "sealContinuousContinuitySectionTitle": "Continuity between datasets",
+    "sealContinuousContinuitySectionDescription": "Checks that each dataset's service window overlaps or meets the one published before it, leaving no gap in service.",
+    "sealContinuousFailureTitle": "Last recorded failure",
+    "sealFreshRollingServiceEndDate": "{date}",
+    "sealFreshRollingServiceStartDate": "{date}",
+    "sealContinuousRangeCaption": "{start} → {end}",
+    "sealContinuousLatestDatasetTitle": "Latest Dataset",
+    "sealContinuousPreviousDatasetTitle": "Previous Dataset",
+    "sealContinuousFirstErrorDatasetTitle": "First Error Dataset",
+    "sealContinuousPreviousErrorDatasetTitle": "Previous Error Dataset",
+    "sealContinuousJoinOverlapDetail": "Overlap × {days, plural, one {# day} other {# days}}: {start} → {end}",
+    "sealContinuousJoinGapDetail": "Gap × {days, plural, one {# day} other {# days}}: {start} → {end}",
+    "sealContinuousJoinMeetsDetail": "Windows meet exactly: {start}",
+    "sealContinuousJoinOverlapUnshown": "Overlaps the previous dataset by {days, plural, one {# day} other {# days}}. That dataset supplied no service dates, so the overlap isn't drawn.",
+    "sealContinuousJoinGapUnshown": "{days, plural, one {# day} other {# days}} of service are uncovered between this dataset and the previous one, which supplied no service dates, so the gap isn't drawn.",
+    "sealContinuousJoinMeetsUnshown": "This dataset picks up exactly where the previous one ends. That dataset supplied no service dates, so nothing is drawn between them.",
+    "sealContinuousWindowChipYears": "{years} yr window",
+    "sealContinuousWindowTooltip": "The span of service this dataset declares, from its first service date to its last. A single dataset may cover at most {years} years.",
+    "sealContinuousWindowTooltipWithin": "The span of service this dataset declares, from its first service date to its last. A single dataset may cover at most {years} years, and this one is inside that limit.",
+    "sealContinuousWindowTooltipOver": "The span of service this dataset declares, from its first service date to its last. It is longer than the {years} years a single dataset may cover, so it does not meet this criterion.",
+    "sealContinuousWindowChipMonths": "{months} mo window",
+    "sealContinuousWindowChipDays": "{days, plural, one {# day} other {# days}} window",
+    "sealContinuousTrackLabel": "{source}: {start} to {end}",
+    "sealContinuousTrackGapLabel": "Uncovered service from {start} to {end}.",
+    "sealContinuousTrackOverlapLabel": "Service covered by both datasets from {start} to {end}.",
+    "sealContinuousNoWindows": "This dataset supplied no service dates.",
+    "sealContinuousGraceTitle": "{days, plural, one {# day} other {# days}} left to restore continuous coverage",
+    "sealContinuousGraceDescription": "Publish a dataset that closes the gap before the grace period ends to keep the Seal.",
     "pageGeneratedAt": "Page generated at",
     "serviceDateRange": "Service Date Range",
     "serviceDateRangeTooltip": "Dates are relative to the specified timezone. If no timezone is specified, the dates are in UTC.",