release: v0.2.0

Author: dmorn

.pi/skills/elixir-hex-release/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: elixir-hex-release
+description: Run a safe, repeatable Elixir library release flow (changelog, version bump, tag, GitHub release, Hex publish), including preflight checks and Hex package-name ownership validation.
+---
+
+# Elixir Hex Release
+
+## When to use
+- Releasing this repository as a new Hex version.
+- User asks to "cut a release", "publish to hex", or "bump version + tag + release".
+
+## Preflight (must pass first)
+1. Confirm clean working tree:
+   ```bash
+   git status --short --branch
+   ```
+2. Run required project quality checks:
+   ```bash
+   mix format
+   mix test
+   mix credo --strict
+   ```
+3. Confirm intended release version (example: `0.1.1`).
+4. Validate Hex package target and ownership:
+   ```bash
+   mix hex.info moqx
+   # if authenticated:
+   mix hex.owner list moqx
+   ```
+   - If package name already exists and you are not an owner, stop and choose a different package name in `mix.exs` (`package: [name: "..."]`).
+
+## Release workflow
+1. Update `CHANGELOG.md` with a new version section and release date.
+2. Bump `version` in `mix.exs`.
+3. If README install snippet includes pinned version, update it.
+4. Commit:
+   ```bash
+   git add CHANGELOG.md mix.exs README.md
+   git commit -m "release: vX.Y.Z"
+   git push
+   ```
+5. Create and push annotated tag:
+   ```bash
+   git tag -a vX.Y.Z -m "vX.Y.Z"
+   git push origin vX.Y.Z
+   ```
+6. Publish to Hex (required):
+   ```bash
+   mix hex.publish
+   ```
+   - For first release of a package, this step is the authoritative publication.
+7. Publish docs (recommended):
+   ```bash
+   mix hex.docs
+   ```
+8. Create GitHub release (optional):
+   ```bash
+   gh release create vX.Y.Z --title "<project> vX.Y.Z" --notes-file /tmp/release-notes.md
+   ```
+
+## Notes for this repo
+- Required before committing: `mix format`, `mix test`, `mix credo`.
+- Existing tag/release operations may happen independently, but Hex publication is the critical ship step.
+- Keep release notes aligned with `CHANGELOG.md`.
+
+## Quick operator checklist
+- [ ] Preflight checks pass
+- [ ] Changelog updated
+- [ ] `mix.exs` version bumped
+- [ ] Commit pushed
+- [ ] Tag created and pushed
+- [ ] `mix hex.publish` completed
+- [ ] `mix hex.docs` completed (recommended)
+- [ ] GitHub release created/published (optional)

CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to `moqx` will be documented in this file.
 
+## [0.2.0] - 2026-04-08
+
+First release of the current Rustler + `moqtail-rs` based Elixir MOQ client library line.
+
+### Added
+
+- CMSF catalog decoding and media track discovery via `MOQX.Catalog`
+- raw fetch and catalog retrieval APIs for subscriber sessions
+- validated relay-backed integration coverage for v14/v17 interop and live relay behavior
+
+### Changed
+
+- native integration migrated to `moqtail-rs`
+- publish flow aligned around `PublishNamespace` behavior
+- docs and examples updated for the current client contract
+
+### Notes
+
+- `moqx` on Hex had prior unrelated releases; `0.2.0` marks this project line as the canonical continuation.
+
 ## [0.1.0] - 2026-03-30
 
 Initial public client release.

README.md

@@ -8,7 +8,7 @@
 
 ```elixir
 # mix.exs
-{:moqx, "~> 0.1.0"}
+{:moqx, "~> 0.2.0"}
 ```
 
 Release metadata:

mix.exs

@@ -4,7 +4,7 @@ defmodule MOQX.MixProject do
   def project do
     [
       app: :moqx,
-      version: "0.1.0",
+      version: "0.2.0",
       description: description(),
       elixir: "~> 1.19",
       elixirc_paths: elixirc_paths(Mix.env()),