Detect stale docs.livestore.dev deploys via version meta tag - #1290
Draft
schickling-assistant wants to merge 1 commit into
Draft
Detect stale docs.livestore.dev deploys via version meta tag#1290schickling-assistant wants to merge 1 commit into
schickling-assistant wants to merge 1 commit into
Conversation
Adds a `<meta name="livestore-version" content="…">` tag to the docs site build (via `docs/astro.config.ts`) and a daily health workflow that compares it against npm `latest`. Mismatch outside a 30m grace window after a GitHub Release opens (or warms) a `bug`-labelled issue. The check also runs on release `published` events so a freshly cut release that never made it to docs is surfaced quickly instead of silently lagging behind npm. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> agent-session-id: c1934b02-14a7-4f20-a3e4-9e7b987c77ab agent-tool: Claude Code agent-tool-version: 2.1.145 agent-model: claude-opus-4-7 tooling-profile: dotfiles@unknown-dirty
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
`https://docs.livestore.dev\` can fall behind the latest LiveStore release if the Netlify deploy fails or never runs. Nothing currently surfaces a stale docs deploy until a user complains.
Solution
Behaviour:
Deferred sub-features
Observation about existing version markers
Today the docs site only exposes the version through `og:site_name` (`LiveStore (0.4.0)`), which doubles as the human-readable site title. Tying a health check to a render-cosmetic string is fragile — hence the dedicated `livestore-version` meta tag.
Validation
Files
🤖 Generated with Claude Code