OpenParable
Skip to content
← Back to skills

Bumping Web

Development
bumping-web

Bumping Web is an Agent Skill for development published in the opencloud-eu/opencloud repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when the user asks to bump, update, or upgrade the OpenCloud web assets/frontend to a specific version (e.g. "bump web to v7.0.0", "update web to v7.1.2"). Covers editing the version files, the single commit, and opening the PR against the right branch.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/opencloud-eu/opencloud/blob/HEAD/.agents/skills/bumping-web/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/bumping-web, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Bumping Web

Overview

Bumping web updates the pinned OpenCloud web frontend (assets + UI-test runner) to a tagged release of opencloud-eu/web. It touches exactly two files, lands as one commit, and ships as a PR whose body is the web changelog for that version.

Template PR: https://github.com/opencloud-eu/opencloud/pull/2733

Prerequisites

  • gh (GitHub CLI), authenticated — every lookup and the PR creation go through gh api / gh pr. Verify with gh auth status; if it fails, ask the user to run gh auth login (suggest ! gh auth login so it runs in-session). Do not proceed without it.
  • gh needs the system keyring, so run all gh commands with the sandbox disabled.
  • git and base64 (decoding the changelog) — standard on macOS/Linux.

What changes (exactly two files)

FileVariableNew value
services/web/MakefileWEB_ASSETS_VERSIONthe version tag, e.g. v7.0.0
services/web/MakefileWEB_ASSETS_BRANCHbranch carrying the tag (main or stable-X.Y)
.woodpecker.envWEB_COMMITIDfull commit sha the tag points to
.woodpecker.envWEB_BRANCHsame branch as WEB_ASSETS_BRANCH

WEB_ASSETS_BRANCH and WEB_BRANCH are always the same value.

Procedure

Let VERSION be the requested tag (always normalize to a leading v, e.g. v7.0.0).

1. Resolve the commit sha the tag points to

gh api repos/opencloud-eu/web/commits/$VERSION --jq '.sha'

This full sha is the new WEB_COMMITID.

2. Determine the branch (main vs stable-X.Y)

The branch is the line of development that carries the tag. Detect it:

gh api "repos/opencloud-eu/web/compare/main...$VERSION" --jq '.status'
  • identical or behind → the tagged commit is reachable from main → use main.
  • ahead or diverged → the tag lives on a release line → use stable-X.Y matching the version's major.minor (e.g. v7.1.2 → stable-7.1).

Sanity-check that the stable branch actually exists:

gh api repos/opencloud-eu/web/branches --paginate --jq '.[].name' | grep -E 'main|stable'

Typically a freshly released minor (v7.1.0) still sits on main, while later patches on an older line (v7.0.3 after 7.1 exists) sit on stable-7.0.

3. Fetch the changelog for the PR body

gh api "repos/opencloud-eu/web/contents/CHANGELOG.md?ref=$VERSION" --jq '.content' | base64 -d

Take only the section for this version. Match the template: start the PR body at the first content heading (e.g. ### 💥 Breaking changes / ### 📈 Enhancement) and drop the # Changelog title, the ## [x.y.z] - date header, and the ### ❤️ Thanks to all contributors! block. Stop before the next ## [...] version header.

4. Apply the edits

Edit services/web/Makefile (WEB_ASSETS_VERSION, WEB_ASSETS_BRANCH) and .woodpecker.env (WEB_COMMITID, WEB_BRANCH).

5. Pick the target branch for the PR

  • Major or minor release → target main.
  • Patch release → may need to target a stable branch instead. If the user did not specify, ask them which branch to target before continuing.

6. Confirm before committing

Show the user the diff of both files and the target branch, and ask them to confirm. Do not commit until they approve.

7. Commit, push, open PR

  • Create a branch (do not commit on main).
  • One commit, conventional-commits format, empty body:
    chore: bump web to v7.0.0
    
  • PR title: [full-ci] chore: bump web to v7.0.0 (the commit message prefixed with [full-ci] ).
  • PR base: the branch chosen in step 5.
  • PR body: the trimmed changelog from step 3.
  • Add the label Type:Dependencies.
gh pr create --base <target-branch> \
  --title "[full-ci] chore: bump web to $VERSION" \
  --label "Type:Dependencies" \
  --body-file <changelog-file>

(gh commands need the sandbox disabled — they require the system keyring.)

Quick reference

VERSION=v7.0.0
gh api repos/opencloud-eu/web/commits/$VERSION --jq '.sha'                       # WEB_COMMITID
gh api "repos/opencloud-eu/web/compare/main...$VERSION" --jq '.status'           # main vs stable
gh api "repos/opencloud-eu/web/contents/CHANGELOG.md?ref=$VERSION" --jq '.content' | base64 -d  # changelog

Common mistakes

  • Reading WEB_COMMITID or the changelog from web main instead of from the version tag (?ref=$VERSION). Always pin to the tag.
  • Leaving WEB_ASSETS_BRANCH/WEB_BRANCH on main for a patch that belongs on a stable line.
  • Forgetting [full-ci] in the PR title or adding a commit body.
  • Committing before the user confirms the diff and target branch.