generate-release-notes

Skill: generate-release-notes

Generate a high-level release note summarising what changed between a git tag and the current codebase.

Arguments: <tag> [package] — a git tag to diff against (e.g. v1.2.0, @phantom/[email protected]), and an optional package name to scope the diff (e.g. @phantom/react-sdk). If no package is provided, all packages are included.

Note: Release tags live on the public mirror at https://github.com/phantom/phantom-connect-sdk. The diff is always performed against the current (internal) repo.

---

Phase 0 — Determine scope

Parse the arguments:

• {tag} — the first argument (required)
• {package} — the second argument (optional)

If {package} is provided, scope all git diff/log commands to packages/{package-dirname}/ where {package-dirname} is derived from the package name (e.g. @phantom/react-sdk → react-sdk). Use the package name in the output filename.

If {package} is not provided, run commands without a path filter to capture all packages, and use all in the output filename.

---

Phase 1 — Resolve the tag commit from the public repo

The internal repo does not have release tags. Fetch the commit SHA that the tag points to from the public mirror:

# Get the commit SHA the tag resolves to on the public repo
git ls-remote https://github.com/phantom/phantom-connect-sdk.git "refs/tags/{tag}" "refs/tags/{tag}^{}"

Take the last SHA returned (the dereferenced ^{} entry if present, otherwise the only entry). Call this {public-sha}.

Then verify this commit exists in the internal repo:

git -C <repo-root> cat-file -t {public-sha}

If the commit is not found, the internal and public repos may have diverged in history. Stop and report this to the user.

---

Phase 2 — Gather raw data

Run the following from the repo root using {public-sha} as the base:

# List commits between the tag SHA and HEAD (scoped to package path if provided)
git log {public-sha}...HEAD --oneline --no-merges [-- packages/{package-dirname}/]

# Full diff summary
git diff {public-sha}...HEAD --stat [-- packages/{package-dirname}/]

# Detailed diff
git diff {public-sha}...HEAD [-- packages/{package-dirname}/]