Skip to content

docs: add latest tags back and improve workflow#2363

Merged
jcstein merged 2 commits intomainfrom
jcs/add-latest-tags
Dec 17, 2025
Merged

docs: add latest tags back and improve workflow#2363
jcstein merged 2 commits intomainfrom
jcs/add-latest-tags

Conversation

@jcstein
Copy link
Copy Markdown
Member

@jcstein jcstein commented Dec 17, 2025

Summary

Restores the manual “Latest Tags” workflow and updates it for the new docs constants layout. The workflow fetches the latest celestia-app and celestia-node release tags (per selected network) and resolves them to commit SHAs, then writes the results to the network JSON file and opens a PR.

Changes

  • Adds .github/workflows/latest-tags.yaml (manual workflow_dispatch with network: mainnet|arabica|mocha).
  • Writes output to constants/${network}_versions.json to match the new directory structure and JSON-based constants usage.
  • Resolves the tag’s underlying commit SHA (handles annotated tags via ref/tag fallback).

How to run

Actions → Latest Tags → Run workflow → select network.
Creates/updates a PR from gh-action/latest-tags-${network} with the updated constants/${network}_versions.json.

Requirements

  • PAT_CREATE_PR secret with permissions to push a branch and open PRs in this repo.
  • Uses GITHUB_TOKEN for GitHub API reads.

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Note

Gemini is unable to generate a summary for this pull request due to the file types involved not being currently supported.

Comment thread .github/workflows/latest-tags.yaml Fixed
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Dec 17, 2025

🚀 Preview Deployment

Your preview is ready: https://celestiaorg.github.io/docs-preview/pr-2363/

@jcstein jcstein requested a review from gbarros December 17, 2025 18:25
@jcstein jcstein self-assigned this Dec 17, 2025
Copy link
Copy Markdown
Contributor

@gbarros gbarros left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These look good. Only way to be certain they are 100%, is to run it 👍

Suggestion for another iteration:

Manual Trigger: Currently, you must go to the GitHub Actions "Actions" tab, select "Latest Tags," click "Run workflow," and choose a network (mainnet, arabica, or mocha).
Watching Changes: It is absolutely possible to automate this "watching" behavior. 
Since GitHub Actions events (like on: release) only fire for the repository they are in (not external ones like celestia-app), we typically use one of two approaches:

Option A: Scheduled Polling (Easiest & Recommended) We add a schedule trigger (Cron) to run this workflow periodically (e.g., every 6 or 24 hours). It would check usage for all networks (mainnet, arabica, mocha) and only create a PR if it finds a new version that you don't have yet.

Option B: Repository Dispatch (Real-time) If you control the celestia-app and celestia-node repositories, you can add a workflow to them that "pings" this repository whenever a release is published. This is instant but requires changes in the other repositories.

@jcstein jcstein changed the title docs: add latest tags back docs: add latest tags back and improve workflow Dec 17, 2025
@jcstein
Copy link
Copy Markdown
Member Author

jcstein commented Dec 17, 2025

thank you. I'm implementing this suggestion along with some custom logic to, for example, not try to update mocha if it is just an arabica release.

Comment thread .github/workflows/latest-tags.yaml Dismissed
@jcstein jcstein merged commit e4d9262 into main Dec 17, 2025
6 checks passed
@jcstein jcstein deleted the jcs/add-latest-tags branch December 17, 2025 22:36
@jcstein
Copy link
Copy Markdown
Member Author

jcstein commented Dec 17, 2025

when no new release:

Fetching latest release for celestiaorg/celestia-app (network=arabica)...
Resolved celestia-app: v6.4.3-arabica @ bb664e70d76613b29a3a071bf03063e7dbd8fe0c
Fetching latest release for celestiaorg/celestia-node (network=arabica)...
Resolved celestia-node: v0.28.5-arabica @ 97579a55b765d57754322f168ddba0f9adba7cdc
No new arabica release detected; skipping PR.

when there is a new release:

Fetching latest release for celestiaorg/celestia-app (network=mocha)...
Resolved celestia-app: v6.4.2-mocha @ 90990a85393e958ee2a382bb6231f68b73286027
Fetching latest release for celestiaorg/celestia-node (network=mocha)...
Resolved celestia-node: v0.28.5-mocha @ f10991334ff261ccb88b86e17a2369d7b8218d10
New mocha release detected; opening PR.

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.

3 participants