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/coupled-groups.md

View on GitHub
# Coupled Package Groups + Edge Cases

## Must-move-together groups

When ≥2 members of a group appear in the outdated set, force them into ONE
update step + commit — even if the user picked a narrower scope. If only
one member is outdated but a sibling pins it, `mix hex.outdated <pkg>`
surfaces the constraint.

| Group | Packages | Why |
|-------|----------|-----|
| Phoenix core | `phoenix`, `phoenix_html`, `phoenix_live_view`, `phoenix_live_dashboard`, `phoenix_ecto` | Shared protocols/JS; LV pins a phoenix range. Mismatch = compile/runtime errors. Triggers the JS-sync step |
| LV satellites | `phoenix_live_view` + LV-component libs present (`live_select`, `salad_ui`, ...) | They pin an LV version range |
| Ecto | `ecto`, `ecto_sql`, `postgrex` (+ `myxql`/`tds`) | `ecto_sql` pins `ecto`; the adapter pins `ecto_sql` |
| Ash | `ash`, `ash_postgres`, `ash_phoenix`, `ash_sql`, `ash_oban`, `ash_authentication` | Tight inter-version pinning; bump as a set |
| Telemetry | `telemetry`, `telemetry_metrics`, `telemetry_poller` | Shared core version |
| OpenTelemetry | `opentelemetry`, `opentelemetry_api`, `opentelemetry_exporter`, instrumentation libs | API/SDK lockstep |
| Oban | `oban`, `oban_pro`, `oban_web` | Pro/Web pin an `oban` range; Pro/Web are private (org auth + off-hex notes) |
| Absinthe | `absinthe`, `absinthe_plug`, `absinthe_phoenix` | Plug/Phoenix pin core |
| Asset installers | `tailwind`, `esbuild` | Installer bump may need a version bump in `config/config.exs` |

## Phoenix/JS coupling

A Phoenix-family bump with `assets/package.json` present requires:
`npm install --prefix assets` and staging `assets/package-lock.json` in
the SAME commit as `mix.lock` (Iron Law 5). The JS packages track the hex
versions (`file:../deps/phoenix` references).

## Edge cases

| Case | Detection | Handling |
|------|-----------|----------|
| Umbrella | `apps_path:` in mix.exs | `mix hex.outdated` from root iterates `apps/*`; updates apply at the root lock; snapshot changelogs from root `deps/` |
| Git deps | `git:` in tuple | Skipped by hex.outdated. Update via `mix deps.update <pkg>` (re-resolves ref); no hex changelog — link the git compare URL; flag "git dep — manual ref review" in inventory |
| Path deps | `path:` in tuple | Local, never outdated — exclude from inventory |
| Private orgs | `organization:`/`repo:` in tuple | Needs prior `mix hex.organization auth <org>`; on 401 tell the user, never handle keys |
| Blocked major | Status `Update not possible` | Edit mix.exs constraint; `override: true` only if a transitive consumer blocks (per-package hex.outdated table); one per PR |
| Greenfield (<10 .ex files) | file count | Skip area bucketing — bundle everything; coupled groups still apply |
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 CodeCodexVerifiedInstall
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