Skip to content

Align snapshot-age claims with validator behavior - #37

Merged
coreytshaffer merged 1 commit into
mainfrom
codex/claim-hygiene-snapshot-age
Jul 3, 2026
Merged

Align snapshot-age claims with validator behavior#37
coreytshaffer merged 1 commit into
mainfrom
codex/claim-hygiene-snapshot-age

Conversation

@coreytshaffer

Copy link
Copy Markdown
Owner

Small, focused claim-hygiene slice re-expressed against current main (a follow-up to the review that produced the larger, still-open #36).

What this changes

  • Removed hardcoded, drift-prone snapshot-age text in docs/public-snapshot-release-note-2026-05-13.md and docs/reviewer-demo-notes.md (the "23 days old" / "25 days old" phrasing) and pointed reviewers to the dashboard's dynamically computed snapshot-age badge instead.
  • De-hardcoded the matching guards in scripts/validate-public-mirror.ps1 (two Assert-TextContains needles that required a specific day count) to check for the durable badge cue — so the guards can't drift out of sync with the docs again.
  • Added public-backlog follow-ups (docs/public-backlog.md) for a publication-time stale-snapshot gate, a stale-source fail-vs-warn decision, Python/PowerShell validator unification, and computed source/weather stale status.

Deliberately not changed on main

  • -AllowStaleSnapshot: main has no references to this flag anywhere, so there was nothing to remove.
  • Fail-closed wording: on main this accurately describes the real refresh-pipeline gate (refresh-live-data.ps1 stops on stale FHABS resources, per the formal refresh runbook and a recorded rehearsal). It was left intact rather than downgraded, to avoid making the docs less accurate.

These branch-only concerns are handled separately on the larger field-sensor-readiness branch (#36).

Validation

  • python scripts/validate-public-mirror.py → PASS (exit 0)
  • pwsh ./scripts/validate-public-mirror.ps1 → PASS (exit 0)
  • git diff --check → clean

Remaining validator output is the intentional staleness warnings (snapshot age, FHABS source ages) — the trust signals this slice preserves. Scope is docs + validator claim-hygiene only; no dashboard or data-publication code touched.

🤖 Generated with Claude Code

Re-express the claim-hygiene stabilization slice against current main.

Removes hardcoded, drift-prone snapshot-age wording from the release note and
reviewer demo notes and points reviewers to the dashboard's dynamically
computed snapshot-age badge instead. Replaces the matching hardcoded day-count
guards in validate-public-mirror.ps1 with a durable badge-cue check. Adds
public-backlog follow-ups for a publication-time stale-snapshot gate, a
stale-source fail-vs-warn decision, Python/PowerShell validator unification,
and computed source/weather stale status.

Scope is limited to docs and validator claim-hygiene. Main already had no
-AllowStaleSnapshot references and its fail-closed language accurately
describes the refresh pipeline, so neither was changed.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coreytshaffer
coreytshaffer merged commit 6409444 into main Jul 3, 2026
2 checks passed
@coreytshaffer
coreytshaffer deleted the codex/claim-hygiene-snapshot-age branch July 3, 2026 08:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant