Skip to content

Repository files navigation

Clear Lake Watch

Status: Late Prototype / Early MVP License: MIT Live Dashboard

Clear Lake Watch is a late-prototype / early-MVP public dashboard for organizing Clear Lake environmental context, source freshness, map review status, and cautious methodology notes.

It is not official public-health guidance, an official advisory, a validated forecast, or a deployed sensor network.

Live public mirror: coreytshaffer.github.io/clear-lake-watch

Current public status: static reviewed snapshot generated on May 5, 2026. Treat the live mirror as dated portfolio/review evidence, not live lake conditions. See the public snapshot release note.

Clear Lake Watch dashboard preview

Trust Model

  • Uses public-source data and clearly labeled prototype outputs.
  • Public mirror is a reviewed static publication surface, not the operational system of record.
  • Private/local records, reviewer notes, raw field records, and trusted-review paths are excluded from the public mirror.
  • Dashboard is not official guidance, a health advisory, a validated forecast, or a deployed sensor network.

Reviewer Start Here

For a 5-minute review:

  1. Open the dashboard.
  2. Read the evidence summary.
  3. Read known limitations.
  4. Read reviewer demo notes.
  5. Review the public mirror boundary if evaluating data governance.

For Internship Reviewers

Open these first:

  1. Live dashboard
  2. Clear Lake Watch v0.1 evidence summary
  3. Reviewer demo notes

For copy-paste outreach language, see Internship review start here.

What This Public Mirror Shows

  • Public environmental data integration across FHABS, USGS, and OpenStreetMap.
  • Static dashboard pages that can be served directly from GitHub Pages.
  • Source-status metadata and visible uncertainty around generated outputs.
  • Site-registry review cues for markers that still need local review.
  • Conservative methodology language for a sensitive environmental topic.

Known Limitations

  • This dashboard does not issue public-health, recreation, regulatory, or emergency guidance.
  • Some FHABS landmarks still require local review before arm assignments should be treated as authoritative.
  • Weather context is a reviewed public-source snapshot and remains separate from lake-health interpretation.
  • Field and microscopy workflows are represented as reviewed-public export placeholders, not public submission forms.

Open First

Public Documentation

Public Data Files

  • data/live.json: compact current-condition snapshot for the dashboard
  • data/reports.json: normalized FHABS Clear Lake report export
  • data/observations.json: normalized USGS and FHABS observation records
  • data/sites.json: starter site registry
  • data/sites-normalized.json: normalized site registry export
  • data/site-review-summary.json: public-safe aggregate site-review summary
  • data/analytics.json: generated historical summaries for dashboard charts
  • data/manifest.json: source-status manifest
  • data/lake-shoreline.json: OpenStreetMap-derived Clear Lake shoreline geometry
  • data/weather-context.json: reviewed public-source weather context, separate from lake-health interpretation
  • data/reviewed-field-observations.json: reviewed-public field/microscopy placeholder

Validate This Mirror

Run the public mirror validation check from PowerShell:

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\validate-public-mirror.ps1

Or run the cross-platform Python validation helper:

python scripts/validate-public-mirror.py

If a local server is running on http://127.0.0.1:4173/, include endpoint checks (PowerShell only):

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\validate-public-mirror.ps1 -CheckHttp

For a cross-platform baseline check that is suitable for CI, run:

python scripts/validate-public-mirror.py

The Python validator is intentionally lighter than the PowerShell validator. Use it as a portable floor for required files, JSON parsing, static-snapshot warnings, text guardrails, and public/private boundary checks. Keep the PowerShell validator as the stronger release gate for Windows review passes.

For a manual reviewed refresh run, use the formal public refresh runbook or dispatch the Formal Public Refresh GitHub Actions workflow. That workflow generates review artifacts only; it does not publish automatically.

Related Projects

  • community-monitoring — intake-side companion: a local-first trust pipeline for simulated field-sensor observations, with schema validation, semantic QA/QC, station provenance checks, and human-review routing. It is designed so that only validated, approved records could ever feed a public layer like this one. No integration exists yet; nothing in this public mirror comes from it.
  • safetask-ai — hazard-first safety evidence pipeline whose fail-closed, review-gated governance patterns inform this project's publication boundaries. It uses a copy of this dashboard's May 5, 2026 public snapshot as demo fixture data.

The broader private review packet and trusted-review materials are intentionally not part of this public mirror branch.

About

Public environmental monitoring dashboard for Clear Lake, CA — integrating USGS hydrology, FHABS HAB reports, and OSM geospatial data

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages