- Source rows, observation dates, and generated output counts come
- from the public snapshot manifest.
+ Source rows, observation dates, source-resource dates, and
+ generated output counts come from the public snapshot manifest.
+
diff --git a/scripts/dashboard-utils.js b/scripts/dashboard-utils.js
index c579adb..814276d 100644
--- a/scripts/dashboard-utils.js
+++ b/scripts/dashboard-utils.js
@@ -63,7 +63,28 @@ export const setStoredBoolean = (key, value) => {
export const getStoredJson = (key, fallback = null) => {
try {
const value = localStorage.getItem(key);
- return value ? JSON.parse(value) : fallback;
+
+ if (value === null || value === undefined) {
+ return fallback;
+ }
+
+ const parsed = JSON.parse(value);
+
+ if (fallback === null || fallback === undefined) {
+ return parsed ?? fallback;
+ }
+
+ if (Array.isArray(fallback)) {
+ return Array.isArray(parsed) ? parsed : fallback;
+ }
+
+ if (typeof fallback === "object") {
+ return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)
+ ? parsed
+ : fallback;
+ }
+
+ return typeof parsed === typeof fallback ? parsed : fallback;
} catch (error) {
console.warn(error);
return fallback;
diff --git a/scripts/validate-public-mirror.ps1 b/scripts/validate-public-mirror.ps1
index 1a56715..fb24691 100644
--- a/scripts/validate-public-mirror.ps1
+++ b/scripts/validate-public-mirror.ps1
@@ -237,6 +237,22 @@ function Test-ManifestFreshness {
}
$maxSourceAgeDays = if ($Manifest.sourceFreshnessMaxAgeDays) { [int]$Manifest.sourceFreshnessMaxAgeDays } else { 14 }
+ $fieldDefinitions = $Manifest.fieldDefinitions
+ if ($null -eq $fieldDefinitions) {
+ Add-Failure "Manifest must include fieldDefinitions for trust clarity."
+ } else {
+ foreach ($fieldName in @("generatedAt", "latestObservationDate", "resourceDate", "resourceAgeDays")) {
+ if ([string]::IsNullOrWhiteSpace($fieldDefinitions.$fieldName)) {
+ Add-Failure "Manifest fieldDefinitions is missing $fieldName."
+ }
+ }
+ }
+
+ $freshnessLegendText = (@($Manifest.freshnessLegend) | ForEach-Object { "$($_.term) $($_.definition)" }) -join " "
+ foreach ($requiredPhrase in @("Dashboard snapshot freshness", "Observation freshness", "Resource freshness")) {
+ Assert-TextContains -Text $freshnessLegendText -Needle $requiredPhrase -Message "Manifest freshnessLegend must include $requiredPhrase."
+ }
+
foreach ($source in @($Manifest.sources)) {
if ([string]::IsNullOrWhiteSpace($source.id)) {
@@ -317,6 +333,7 @@ function Test-ManifestFreshness {
$notesText = (@($Manifest.notes) -join " ")
Assert-TextContains -Text $notesText -Needle "Observation dates may be older than the dashboard generation time" -Message "Manifest must preserve dashboard-refresh versus source-observation distinction."
+ Assert-TextContains -Text $notesText -Needle "Resource freshness and observation freshness are separate checks" -Message "Manifest must preserve resource-freshness versus observation-freshness distinction."
}
function Test-WeatherContext {
@@ -589,6 +606,8 @@ try {
Assert-TextContains -Text $readme -Needle "docs/secchi-mentor-review-handoff.md" -Message "README must link the Secchi mentor-review handoff."
Assert-TextContains -Text $index -Needle "late prototype / early MVP" -Message "Homepage must preserve maturity language."
Assert-TextContains -Text $index -Needle "Internship portfolio prototype showing Clear Lake environmental data integration, GIS/spatial QA, source-freshness validation, static deployment, and responsible public communication." -Message "Homepage meta description must describe the internship portfolio signal."
+ Assert-TextContains -Text $index -Needle "source-resource dates" -Message "Homepage must distinguish source-resource dates from observation dates."
+ Assert-TextContains -Text $index -Needle "source-freshness-legend" -Message "Homepage must expose the freshness legend container."
Assert-TextContains -Text $index -Needle "Internship Reviewer Path" -Message "Homepage must include an above-the-fold reviewer path."
Assert-TextContains -Text $index -Needle "Dashboard snapshot" -Message "Homepage reviewer path must start with the dashboard snapshot."
Assert-TextContains -Text $index -Needle "github.com/coreytshaffer/clear-lake-watch/blob/main/docs/clear-lake-watch-v0.1-evidence-summary.md" -Message "Homepage reviewer path must link the GitHub evidence summary."
@@ -615,6 +634,8 @@ try {
Assert-TextContains -Text $app -Needle "renderSnapshotStatusStrip" -Message "App must render the snapshot status strip."
Assert-TextContains -Text $app -Needle "Latest Clear Lake FHABS report" -Message "App must expose FHABS report freshness in the status strip."
Assert-TextContains -Text $app -Needle "Latest FHABS lab-linked sample" -Message "App must expose FHABS lab-result freshness in the status strip."
+ Assert-TextContains -Text $app -Needle "Observation freshness can be older than dashboard refresh time" -Message "App must distinguish dashboard refresh time from observation freshness."
+ Assert-TextContains -Text $app -Needle "Resource freshness: source file was" -Message "App must label resource freshness separately from observation freshness."
Assert-TextContains -Text $app -Needle "before site or arm assignments should be treated as authoritative" -Message "App must preserve map-review caution language."
$publicBacklog = Get-Content -LiteralPath (Resolve-ProjectPath "docs\public-backlog.md") -Raw
@@ -644,7 +665,7 @@ try {
Assert-TextContains -Text $publicBacklog -Needle "County GIS geometry publication boundary" -Message "Public backlog must include county GIS publication-boundary candidate."
Assert-TextContains -Text $publicBacklog -Needle "Browser accessibility interaction pass" -Message "Public backlog must include browser accessibility interaction-pass status."
Assert-TextContains -Text $publicBacklog -Needle "Maintenance file split" -Message "Public backlog must include maintenance file split status."
- Assert-TextContains -Text $publicBacklog -Needle "No maintenance/trust issues are currently open" -Message "Public backlog must record that maintenance candidates are closed."
+ Assert-TextContains -Text $publicBacklog -Needle "Freshness and publication-safety alignment follow-ups" -Message "Public backlog must track the freshness and publication-safety alignment follow-ups."
$releaseNote = Get-Content -LiteralPath (Resolve-ProjectPath "docs\public-snapshot-release-note-2026-05-13.md") -Raw
Assert-TextContains -Text $releaseNote -Needle "Public Snapshot Release Note - 2026-05-13" -Message "Release note must include its title."
@@ -655,7 +676,7 @@ try {
Assert-TextContains -Text $releaseNote -Needle "September 7, 2025" -Message "Release note must include FHABS report freshness date."
Assert-TextContains -Text $releaseNote -Needle "January 11, 2024" -Message "Release note must include FHABS lab-linked sample freshness date."
Assert-TextContains -Text $releaseNote -Needle "Static Snapshot Age Cue" -Message "Release note must include a static snapshot age cue."
- Assert-TextContains -Text $releaseNote -Needle "the dashboard files are 23 days old" -Message "Release note must make committed snapshot age visible."
+ Assert-TextContains -Text $releaseNote -Needle "snapshot-age badge" -Message "Release note must point to the dashboard's dynamic snapshot-age badge instead of a hardcoded day count."
Assert-TextContains -Text $releaseNote -Needle "not current bloom observations" -Message "Release note must preserve stale FHABS warning framing."
Assert-TextContains -Text $releaseNote -Needle "clear-lake-watch-homepage-desktop-2026-05-13.png" -Message "Release note must link the desktop screenshot."
Assert-TextContains -Text $releaseNote -Needle "clear-lake-watch-homepage-mobile-2026-05-13.png" -Message "Release note must link the mobile-width screenshot."
@@ -697,6 +718,7 @@ try {
Assert-TextContains -Text $sourceFreshnessValidation -Needle "Source Freshness Validation" -Message "Source freshness validation doc must include its title."
Assert-TextContains -Text $sourceFreshnessValidation -Needle "not live monitoring" -Message "Source freshness validation doc must preserve non-operational boundary."
Assert-TextContains -Text $sourceFreshnessValidation -Needle "dashboard refresh time and source observation dates" -Message "Source freshness validation doc must preserve freshness distinction."
+ Assert-TextContains -Text $sourceFreshnessValidation -Needle "Resource freshness and observation freshness are separate checks" -Message "Source freshness validation doc must preserve resource-versus-observation freshness distinction."
Assert-TextContains -Text $sourceFreshnessValidation -Needle "Warning Versus Failure" -Message "Source freshness validation doc must explain warning versus failure behavior."
$scheduledRefreshDesign = Get-Content -LiteralPath (Resolve-ProjectPath "docs\scheduled-public-refresh-design.md") -Raw
@@ -785,7 +807,7 @@ try {
Assert-TextContains -Text $reviewerDemoNotes -Needle "Methodology page" -Message "Reviewer demo notes must caption the methodology screenshot."
Assert-TextContains -Text $reviewerDemoNotes -Needle "Project page" -Message "Reviewer demo notes must caption the project-page screenshot."
Assert-TextContains -Text $reviewerDemoNotes -Needle "dashboard-anatomy-review-guide.md" -Message "Reviewer demo notes must link the dashboard anatomy guide."
- Assert-TextContains -Text $reviewerDemoNotes -Needle "the committed snapshot generated on May 5, 2026 is 23 days old" -Message "Reviewer demo notes must make committed snapshot age visible."
+ Assert-TextContains -Text $reviewerDemoNotes -Needle "snapshot-age badge" -Message "Reviewer demo notes must point to the dashboard's dynamic snapshot-age badge instead of a hardcoded day count."
Assert-TextContains -Text $reviewerDemoNotes -Needle "not official public-health guidance" -Message "Reviewer demo notes must preserve public-health boundary."
$portfolioEvidenceIndex = Get-Content -LiteralPath (Resolve-ProjectPath "docs\portfolio-evidence-index.md") -Raw
diff --git a/scripts/validate-public-mirror.py b/scripts/validate-public-mirror.py
new file mode 100644
index 0000000..c79d0fc
--- /dev/null
+++ b/scripts/validate-public-mirror.py
@@ -0,0 +1,458 @@
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+from dataclasses import dataclass, field
+from datetime import date, datetime
+from pathlib import Path
+from typing import Iterable
+
+
+PROJECT_ROOT = Path(__file__).resolve().parent.parent
+
+REQUIRED_FILES = [
+ Path(".nojekyll"),
+ Path("README.md"),
+ Path("index.html"),
+ Path("project.html"),
+ Path("methodology.html"),
+ Path("styles.css"),
+ Path("app.js"),
+ Path("sw.js"),
+ Path("manifest.webmanifest"),
+ Path("scripts/dashboard-utils.js"),
+ Path("scripts/public-mirror-link-validation.ps1"),
+ Path("scripts/validate-public-mirror.ps1"),
+ Path("data/live.json"),
+ Path("data/reports.json"),
+ Path("data/observations.json"),
+ Path("data/sites.json"),
+ Path("data/sites-normalized.json"),
+ Path("data/site-review-summary.json"),
+ Path("data/analytics.json"),
+ Path("data/manifest.json"),
+ Path("data/lake-shoreline.json"),
+ Path("data/weather-context.json"),
+ Path("data/reviewed-field-observations.json"),
+ Path("docs/public-backlog.md"),
+ Path("docs/public-snapshot-release-note-2026-05-13.md"),
+ Path("docs/reviewer-demo-notes.md"),
+ Path("docs/publication-review-checklist.md"),
+ Path("docs/public-mirror-boundary.md"),
+ Path("docs/flagship-maturity-plan.md"),
+ Path("docs/scheduled-public-refresh-design.md"),
+]
+
+TEXT_GUARDS = {
+ Path("README.md"): [
+ "late-prototype / early-MVP",
+ "not official public-health guidance",
+ "static reviewed snapshot generated on May 5, 2026",
+ "not live lake conditions",
+ "docs/public-snapshot-release-note-2026-05-13.md",
+ ],
+ Path("index.html"): [
+ "late prototype / early MVP",
+ "Public Data Snapshot, Not Advisory Guidance",
+ "What The Public Snapshot Files Are Showing",
+ "source-resource dates",
+ "source-freshness-legend",
+ ],
+ Path("project.html"): [
+ "late prototype / early MVP",
+ "not official public-health guidance",
+ ],
+ Path("methodology.html"): [
+ "not official public-health direction",
+ ],
+ Path("docs/public-snapshot-release-note-2026-05-13.md"): [
+ "Snapshot generated: May 5, 2026",
+ "not official public-health guidance",
+ "Static Snapshot Age Cue",
+ ],
+ Path("docs/reviewer-demo-notes.md"): [
+ "static portfolio evidence, not current conditions",
+ "not official public-health guidance",
+ ],
+ Path("docs/scheduled-public-refresh-design.md"): [
+ "No unattended publication workflow is enabled",
+ "The scheduled workflow must never publish",
+ ],
+}
+
+EXPECTED_SOURCE_IDS = {
+ "usgs-lake-level",
+ "usgs-cole-creek-discharge",
+ "fhabs-bloom-reports",
+ "fhabs-results",
+}
+
+EXCLUDED_TRACKED_PATHS = [
+ "docs/private",
+ "docs/review-screenshots",
+ "docs/trusted-review-request.md",
+ "docs/trusted-review-feedback-log.md",
+ "docs/communications-log.md",
+ "data/private",
+ "data/site-review.json",
+ "portfolio-materials.html",
+ "shortcuts",
+ "server.pid",
+ "server.out.log",
+ "server.err.log",
+]
+
+DISALLOWED_WORKING_PATHS = [
+ Path("geometry-preview.html"),
+ Path("data/lake-shoreline-county-candidate.json"),
+ Path("data/lake-shoreline-county-simplified-25ft.json"),
+ Path("data/lake-shoreline-county-simplified-50ft.json"),
+]
+
+
+@dataclass
+class ValidationState:
+ failures: list[str] = field(default_factory=list)
+ warnings: list[str] = field(default_factory=list)
+
+ def fail(self, message: str) -> None:
+ self.failures.append(message)
+
+ def warn(self, message: str) -> None:
+ self.warnings.append(message)
+
+
+def project_path(relative_path: Path) -> Path:
+ return PROJECT_ROOT / relative_path
+
+
+def read_text(relative_path: Path, state: ValidationState) -> str:
+ path = project_path(relative_path)
+ try:
+ return path.read_text(encoding="utf-8")
+ except FileNotFoundError:
+ state.fail(f"Missing required file: {relative_path.as_posix()}")
+ except OSError as exc:
+ state.fail(f"Unable to read {relative_path.as_posix()}: {exc}")
+ return ""
+
+
+def read_json(relative_path: Path, state: ValidationState) -> object | None:
+ content = read_text(relative_path, state)
+ if not content:
+ return None
+ try:
+ return json.loads(content)
+ except json.JSONDecodeError as exc:
+ state.fail(f"Invalid JSON in {relative_path.as_posix()}: {exc}")
+ return None
+
+
+def assert_required_files(state: ValidationState) -> None:
+ for relative_path in REQUIRED_FILES:
+ if not project_path(relative_path).is_file():
+ state.fail(f"Missing required file: {relative_path.as_posix()}")
+
+
+def assert_text_guards(state: ValidationState) -> None:
+ for relative_path, needles in TEXT_GUARDS.items():
+ text = read_text(relative_path, state)
+ for needle in needles:
+ if needle not in text:
+ state.fail(
+ f"{relative_path.as_posix()} is missing required text: {needle}"
+ )
+
+
+def parse_date_like(value: str) -> datetime:
+ normalized = value.replace("Z", "+00:00")
+ return datetime.fromisoformat(normalized)
+
+
+def load_tracked_files(state: ValidationState) -> set[str]:
+ try:
+ result = subprocess.run(
+ ["git", "ls-files"],
+ cwd=PROJECT_ROOT,
+ check=True,
+ capture_output=True,
+ text=True,
+ )
+ except (OSError, subprocess.CalledProcessError) as exc:
+ state.warn(f"Unable to inspect tracked files with git ls-files: {exc}")
+ return set()
+ return {line.strip() for line in result.stdout.splitlines() if line.strip()}
+
+
+def assert_tracked_boundaries(state: ValidationState, tracked_files: set[str]) -> None:
+ if not tracked_files:
+ return
+
+ for excluded_path in EXCLUDED_TRACKED_PATHS:
+ normalized = excluded_path.replace("\\", "/")
+ for tracked_path in tracked_files:
+ if tracked_path == normalized or tracked_path.startswith(f"{normalized}/"):
+ state.fail(
+ "Public mirror must not track excluded review/private/local "
+ f"artifact: {normalized}"
+ )
+ break
+
+ for tracked_path in tracked_files:
+ if tracked_path.startswith("data/") and tracked_path.endswith(".local.json"):
+ state.fail(f"Public mirror must not track local/private file: {tracked_path}")
+ if tracked_path.endswith(".local.sqlite"):
+ state.fail(f"Public mirror must not track local/private file: {tracked_path}")
+
+
+def assert_working_boundaries(state: ValidationState) -> None:
+ for relative_path in DISALLOWED_WORKING_PATHS:
+ if project_path(relative_path).exists():
+ state.fail(
+ "Public mirror must not expose unverified county GIS review artifact: "
+ f"{relative_path.as_posix()}"
+ )
+
+
+def assert_manifest_freshness(
+ state: ValidationState, manifest: dict, live_data: dict
+) -> None:
+ try:
+ manifest_generated_at = parse_date_like(str(manifest["generatedAt"]))
+ live_generated_at = parse_date_like(str(live_data["generatedAt"]))
+ except (KeyError, TypeError, ValueError) as exc:
+ state.fail(f"Unable to parse manifest or live snapshot timestamps: {exc}")
+ return
+
+ gap_minutes = abs((manifest_generated_at - live_generated_at).total_seconds()) / 60
+ if gap_minutes > 5:
+ state.fail(
+ "Manifest and live snapshot appear to come from different refresh passes. "
+ f"Gap: {gap_minutes:.2f} minutes."
+ )
+
+ max_source_age_days = int(manifest.get("sourceFreshnessMaxAgeDays", 14))
+ field_definitions = manifest.get("fieldDefinitions")
+ if not isinstance(field_definitions, dict):
+ state.fail("Manifest must include fieldDefinitions for trust clarity.")
+ else:
+ for field_name in (
+ "generatedAt",
+ "latestObservationDate",
+ "resourceDate",
+ "resourceAgeDays",
+ ):
+ definition = field_definitions.get(field_name)
+ if not isinstance(definition, str) or not definition.strip():
+ state.fail(f"Manifest fieldDefinitions is missing {field_name}.")
+
+ freshness_legend = manifest.get("freshnessLegend")
+ if not isinstance(freshness_legend, list) or len(freshness_legend) < 3:
+ state.fail("Manifest must include a freshnessLegend with at least three entries.")
+ else:
+ legend_text = " ".join(
+ str(entry.get("term", "")) + " " + str(entry.get("definition", ""))
+ for entry in freshness_legend
+ if isinstance(entry, dict)
+ )
+ for required_phrase in (
+ "Dashboard snapshot freshness",
+ "Observation freshness",
+ "Resource freshness",
+ ):
+ if required_phrase not in legend_text:
+ state.fail(f"Manifest freshnessLegend is missing {required_phrase}.")
+
+ sources = manifest.get("sources")
+ if not isinstance(sources, list):
+ state.fail("Manifest sources must be a list.")
+ return
+
+ source_ids = {
+ source.get("id")
+ for source in sources
+ if isinstance(source, dict) and source.get("id")
+ }
+ missing_ids = sorted(EXPECTED_SOURCE_IDS - source_ids)
+ for source_id in missing_ids:
+ state.fail(f"Manifest is missing expected source: {source_id}")
+
+ today = date.today()
+ snapshot_age_days = (today - manifest_generated_at.date()).days
+ if snapshot_age_days > max_source_age_days:
+ state.warn(
+ "Dashboard snapshot is "
+ f"{snapshot_age_days} days old, which exceeds "
+ f"sourceFreshnessMaxAgeDays={max_source_age_days}. "
+ "Keep static-snapshot language visible."
+ )
+
+ if manifest.get("status") == "ok":
+ non_ok_sources = [
+ source.get("id", "unknown")
+ for source in sources
+ if isinstance(source, dict) and source.get("status") != "ok"
+ ]
+ if non_ok_sources:
+ state.fail(
+ "Manifest status is ok, but one or more sources are not ok: "
+ + ", ".join(non_ok_sources)
+ )
+
+ for source in sources:
+ if not isinstance(source, dict):
+ state.fail("Manifest source entry must be an object.")
+ continue
+ source_id = str(source.get("id", "unknown"))
+ status = source.get("status")
+ row_count = source.get("rowCount")
+ latest_observation = source.get("latestObservationDate")
+
+ if not status:
+ state.fail(f"Manifest source {source_id} is missing status.")
+ if not isinstance(row_count, (int, float)) or row_count <= 0:
+ state.fail(f"Manifest source {source_id} must have a positive rowCount.")
+ if not latest_observation:
+ state.fail(f"Manifest source {source_id} is missing latestObservationDate.")
+ continue
+
+ try:
+ latest_observation_date = parse_date_like(str(latest_observation)).date()
+ except ValueError:
+ latest_observation_date = datetime.fromisoformat(
+ f"{latest_observation}T00:00:00"
+ ).date()
+
+ age_days = (manifest_generated_at.date() - latest_observation_date).days
+ if age_days < 0:
+ state.fail(
+ f"Manifest source {source_id} has a latestObservationDate after "
+ "the manifest generatedAt."
+ )
+ elif age_days > max_source_age_days:
+ state.warn(
+ f"Manifest source {source_id} latest observation is {age_days} days "
+ "older than the dashboard snapshot; keep stale-source language visible."
+ )
+
+ if source_id.startswith("fhabs-"):
+ resource_date = source.get("resourceDate")
+ resource_age_days = source.get("resourceAgeDays")
+ if not resource_date:
+ state.fail(f"Manifest source {source_id} is missing resourceDate.")
+ else:
+ try:
+ resource_datetime = parse_date_like(str(resource_date))
+ except ValueError:
+ resource_datetime = datetime.fromisoformat(
+ f"{resource_date}T00:00:00"
+ )
+ if resource_datetime.date() > manifest_generated_at.date():
+ state.fail(
+ f"Manifest source {source_id} resourceDate is after "
+ "the manifest generatedAt."
+ )
+ if not isinstance(resource_age_days, (int, float)) or resource_age_days < 0:
+ state.fail(
+ f"Manifest source {source_id} must have non-negative resourceAgeDays."
+ )
+
+ notes_text = " ".join(str(note) for note in manifest.get("notes", []))
+ for required_note in (
+ "Observation dates may be older than the dashboard generation time",
+ "Resource freshness and observation freshness are separate checks",
+ ):
+ if required_note not in notes_text:
+ state.fail(f"Manifest notes are missing required trust note: {required_note}")
+
+
+def assert_live_data_shape(state: ValidationState, live_data: dict) -> None:
+ for key in ("liveCards", "mapMarkers", "dataProducts"):
+ value = live_data.get(key)
+ if not isinstance(value, list) or not value:
+ state.fail(f"Live snapshot must include a non-empty {key} list.")
+
+
+def assert_reviewed_field_observations(state: ValidationState, reviewed_data: dict) -> None:
+ records = reviewed_data.get("records")
+ if not isinstance(records, list):
+ state.fail("Reviewed field observations must expose a records list.")
+ return
+
+ private_needles = {
+ "collectorName",
+ "qaNotes",
+ "custodyNotes",
+ "photoOrVoucherReference",
+ "latitude",
+ "longitude",
+ }
+ for record in records:
+ serialized = json.dumps(record, sort_keys=True)
+ for private_needle in private_needles:
+ if private_needle in serialized:
+ record_id = (
+ record.get("recordId", "unknown")
+ if isinstance(record, dict)
+ else "unknown"
+ )
+ state.fail(
+ "Reviewed public field observation "
+ f"{record_id} includes private or sensitive field: {private_needle}"
+ )
+
+
+def validate() -> ValidationState:
+ state = ValidationState()
+ assert_required_files(state)
+ assert_text_guards(state)
+
+ tracked_files = load_tracked_files(state)
+ assert_tracked_boundaries(state, tracked_files)
+ assert_working_boundaries(state)
+
+ manifest = read_json(Path("data/manifest.json"), state)
+ live_data = read_json(Path("data/live.json"), state)
+ reviewed_field_observations = read_json(
+ Path("data/reviewed-field-observations.json"), state
+ )
+
+ if isinstance(manifest, dict) and isinstance(live_data, dict):
+ assert_manifest_freshness(state, manifest, live_data)
+ assert_live_data_shape(state, live_data)
+ else:
+ state.fail("Manifest or live snapshot JSON is missing required object structure.")
+
+ if isinstance(reviewed_field_observations, dict):
+ assert_reviewed_field_observations(state, reviewed_field_observations)
+ else:
+ state.fail("Reviewed field observations JSON is missing required object structure.")
+
+ return state
+
+
+def emit_messages(messages: Iterable[str], label: str) -> None:
+ messages = list(messages)
+ if not messages:
+ return
+ print(f"{label}:")
+ for message in messages:
+ print(f" - {message}")
+
+
+def main() -> int:
+ state = validate()
+ emit_messages(state.warnings, "Warnings")
+ emit_messages(state.failures, "Failures")
+
+ if state.failures:
+ print("Validation failed for Clear Lake Watch public mirror.")
+ return 1
+
+ print("Validation passed for Clear Lake Watch public mirror.")
+ return 0
+
+
+if __name__ == "__main__":
+ sys.exit(main())
diff --git a/styles.css b/styles.css
index ac9ebb4..3443973 100644
--- a/styles.css
+++ b/styles.css
@@ -1363,6 +1363,26 @@ h2 {
gap: 12px;
}
+.source-freshness-legend {
+ display: grid;
+ grid-template-columns: repeat(3, minmax(0, 1fr));
+ gap: 12px;
+}
+
+.source-freshness-item {
+ display: grid;
+ align-content: start;
+ gap: 8px;
+ border: 1px solid var(--line);
+ border-radius: 18px;
+ padding: 14px;
+ background: rgba(221, 182, 111, 0.12);
+}
+
+.source-freshness-item h4 {
+ margin: 0;
+ font-size: 0.98rem;
+}
.source-output-panel {
display: grid;
gap: 12px;