Skip to content

oliver-kriska/claude-elixir-phoenix / targets/pi/skills/phx-deps-update

phx-deps-update

Verified

Bump outdated Hex deps — inventory, snapshot changelogs, update, fix breaks, split reviewable PRs (patches bundled, majors solo). Use to upgrade/bump Elixir dependencies or when versions fall behind. NOT for deps.get failures (/skill:phx-investigate).

FileKindSize
SKILL.mdskill md5.2 KB
references/changelog-sources.mdmarkdown2.0 KB
references/coupled-groups.mdmarkdown2.7 KB
references/pr-strategy.mdmarkdown2.1 KB
references/update-mechanics.mdmarkdown2.5 KB

references/changelog-sources.md

View on GitHub
# Changelog Delta Sources (priority order)

## 1. `mix hex.package diff <pkg> <v1>..<v2>` — PRIMARY

Built into Hex. Fetches both tarballs, unpacks, runs `git diff --no-index`.
The `CHANGELOG.md` hunk is the delta you want — no network parsing:

```
diff --git jason-1.4.4/CHANGELOG.md jason-1.4.5/CHANGELOG.md
+## 1.4.5 (05.05.2026)
+* Add support for Decimal 3.0
```

Filter to the hunk whose path matches `CHANGELOG` (e.g.
`awk '/^diff --git/{keep=/CHANGELOG/} keep'`). Works off the hex registry
— no GitHub dependency. Network cost: two tarballs per package; for large
`--scope all` runs, diff sequentially rather than in parallel.

## 2. `deps/<pkg>/CHANGELOG.md` — the BEFORE snapshot

After `mix deps.get`, the currently-locked changelog is on disk. Snapshot
it to scratch BEFORE updating (Iron Law 2). Most packages ship one, but it
is NOT guaranteed — commercial/private packages often omit it.

## 3. GitHub releases fallback

When the diff has no CHANGELOG hunk, derive `owner/repo` from
`mix hex.info <pkg>`'s GitHub link:

```bash
gh api repos/{owner}/{repo}/releases \
  --jq '.[] | select(.tag_name | test("v?1\\.4\\.5$")) | .body'
```

No releases either → `gh api repos/{owner}/{repo}/tags` (names only) and
link the compare URL: `github.com/{owner}/{repo}/compare/v{old}...v{new}`.

## 4. diff.hex.pm — for PR bodies only

`https://diff.hex.pm/diff/<pkg>/<v1>..<v2>` renders the same diff as
source 1. Use as a clickable link in PR bodies, never as a parse target.

## Private / organization packages

Deps with `organization:`/`repo:` in the tuple need prior auth:
`mix hex.organization auth <org>`. On a 401, tell the user to run that
command themselves — never prompt for or store keys. Private packages may
publish release notes outside hex.pm; accept a user-supplied URL and
WebFetch the relevant section — no vendor names hardcoded.

## Nothing found

Note in the per-package file: "no changelog available; review the diff at
{diff.hex.pm URL}" — and lean on `/skill:phx-deps-audit`'s diff scan for safety.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexUnverifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall