bump-ark

name	bump-ark
description	Open or advance a Positron PR that bumps the Ark submodule to a given Ark PR (its head while open, its merge commit once merged) or to latest Ark main, with Positron e2e test tags. Use when the user runs /bump-ark with a PR number or "main" and optional @:tags.

bump-ark

Opens a PR against posit-dev/positron that bumps the Ark submodule (extensions/positron-r/ark) to a target commit. Everything goes through the GitHub API via gh, so no local clone or working tree is read or touched, and it never force-pushes.

Usage

/bump-ark <pr-number | main> [@:tag ...] [--confirm] [--dry-run]

• <pr-number> tracks one Ark PR across its whole life on a single branch bump-ark/pr-<N>. While the PR is open the bump points at its head commit, so you can run Positron e2e against the dev branch. Once the Ark PR is merged, re-running /bump-ark <N> finalizes the same Positron PR to the merge commit on Ark main, turning the testing PR into the mergeable bump. Title: Bump Ark to posit-dev/ark#<N>.
• main bumps to the latest posit-dev/ark@main on a single branch bump-ark/main, advancing it in place on re-run. Title: Bump Ark to latest main.
• @:tag arguments are Positron e2e test tags. @:ark is always included; the supplied tags are added and deduped.
• --confirm advances the open main bump even when a colleague owns it (see below). Never pass it proactively.
• --dry-run prints the assembled PR body to stdout and exits, touching no branch, ref, or PR. Only read-only gh calls run. Use it to preview the Closes/tags/release-notes/commits body for a target before deciding to open or update anything, e.g. if the user wants to see it first.

The merge-commit finalize works for squash, merge-commit, and rebase merges alike, since GitHub records merge_commit_sha for all three.

When the bumped PRs close Positron issues, the body opens with Closes #<N> lines. Then the tag line, a ### Release Notes section aggregated from the bumped Ark PRs, and a ### Commits first-parent list of the Ark commits between the current submodule pointer and the target. Commits belonging to an unmerged PR collapse to one line per PR, in the squash-merge form they will take once that PR lands. The target's stack is found by matching each PR's base branch against the head branch of another open PR, down to the PR based on Ark main, so a stacked target contributes one line per PR in the stack.

Release notes are scraped from each bumped Ark PR's #### New Features / #### Bug Fixes bullets, covering every PR in the target's stack rather than the target alone. parse_description.py is a vendored copy of posit-dev/positron-release-notes's parser, so extraction matches the release-notes collector; bump_notes.py is the skill-local glue on top of it (section rendering, Closes collection).

How to run

Run the bundled script, forwarding the arguments verbatim. It needs python3 and an authenticated gh:

python3 .claude/skills/bump-ark/bump_ark.py <args>

Re-running is always safe. Both bump kinds track one fixed branch and advance it by stacking a fast-forward commit onto its current tip (so the ref only ever moves forward, never a force-push), then refresh the title and description from scratch (commit list, release notes, Closes lines).

A PR bump has no author check: its content is fully determined by the Ark PR, so collaborators converge on the same PR rather than clobber each other. A main bump is author-guarded: you can freely advance your own open Bump Ark to latest main PR, but if the open one belongs to a colleague the script refuses (it never touches their branch) and exits 3.

When the script exits reporting that the main bump belongs to someone else, do not re-run with --confirm on your own initiative. Relay who owns it and its URL, and ask the user to confirm, for example: "The 'Bump Ark to latest main' PR belongs to @foo (). Advance it anyway?" Only if they explicitly confirm, re-run the same command with --confirm appended.

The script prints the Positron PR URL to stdout (progress goes to stderr). Relay that URL. If it reports that the submodule is already at the target, relay that as-is instead.

With --dry-run, stdout is the PR body instead of a URL, and nothing is created or modified: not the tracked branch, not its ref, not the PR. Use it only when asked to preview a bump; the default /bump-ark <args> invocation should not pass it.