blog: release 0.21, 0.22

Author: Chemaclass

content/blog/2025-10-20-release-0.21.md

@@ -0,0 +1,40 @@
++++
+title = "Release v0.21 – Multi-Arity Functions"
+description = "Phel v0.21 delivers multi-arity functions, richer macro hygiene, flexible destructuring, and a brighter REPL experience."
+author = "The Phel Team"
++++
+
+Phel v0.21 is all about broadening the way you shape and read code. Multi-arity functions unlock expressive APIs without
+boilerplate, while a suite of macro and metadata improvements tighten up contracts and hygiene. With more flexible
+comments, smarter destructuring, and a friendlier REPL, this release makes day-to-day development feel smoother from
+first keystroke to final evaluation.
+
+## ✨ Highlights
+
+- **Multi-arity functions** let you design natural overloads without branching manually.
+- **Comment enhancements** add inline skips via `#_`, an alternative `;` comment symbol, and rich block comments with `#|…|#`.
+- **Metadata `pre`/`post` conditions** deliver clearer runtime contracts around your functions.
+- **Macro auto-gensym** keeps hygienic macros effortless and robust.
+- **Map destructuring with `:keys` and `:as`** brings ergonomic data extraction to bindings.
+- **REPL upgrades** surface the running version and forward CLI flags to `phel run` scripts.
+
+## 🐛 Bug fixes
+
+- Ensured `.phar` builds autoload Phel classes correctly and resolve namespaces from the working directory.
+- Fixed vector and hashmap literal handling inside `try` blocks.
+- Restored reliable REPL symbol resolution when loading from the current directory.
+
+## 🔧 Enhancements
+
+- Updated the default error log file location for a more consistent debugging workflow.
+
+## 👥 Contributors
+
+A big thank you to **@Chemaclass**, **@jasalt**, and **@JesusValeraDev** for shepherding the release.
+
+## Dive deeper
+
+Review every commit and conversation in the official notes:
+
+- [Full changelog for v0.21.0](https://github.com/phel-lang/phel-lang/compare/v0.20.0...v0.21.0)
+- [Release on GitHub](https://github.com/phel-lang/phel-lang/releases/tag/v0.21.0)

content/blog/2025-11-30-release-0.22.md

@@ -0,0 +1,40 @@
++++
+title = "Release v0.22 – Metadata Conditions"
+description = "Phel v0.22 deepens metadata support, adds new array helpers, introduces a debug namespace, and polishes the developer experience."
+author = "The Phel Team"
++++
+
+Just weeks after multi-arity functions landed, Phel v0.22 doubles down on ergonomics. Stronger metadata handling, fresh
+array utilities, and the new `phel\\debug` toolbox make it easier than ever to inspect, test, and evolve your code. Along the
+way, we tightened the public API surface and nudged code quality forward with a higher PHPStan bar.
+
+## ✨ Highlights
+
+- **Nested array helpers**: reach into deep structures with `php/aget-in`, `php/aset-in`, `php/aunset-in`, and `php/apush-in`.
+- **Metadata `:pre`/`:post` conditions** now have a toggle for performance-sensitive workloads.
+- **`*file*` global** exposes the current source path for macros, tooling, and documentation.
+- **Set literal shorthand `#{...}`** and optional commas in hash maps add readability without ceremony.
+- **`phel\\debug` namespace** introduces helpers like `spy` and `tap` for inline introspection.
+- **Public API refinements** update `PhelFunction` with generated file paths, GitHub URLs, and structured metadata, while
+deprecating older method calls.
+
+## 🐛 Bug fixes
+
+- Ensured the REPL can `require` code from `repl.phel` and returns an empty string for `__FILE__` / `__DIR__`.
+- Repaired metadata persistence on definitions, core functions, and macros.
+- Fixed `argv` to provide a vector result and tightened `NsSymbol` namespace validation.
+
+## 📈 Code quality
+
+- Raised PHPStan to level 5 and removed the legacy `phel\\trace` namespace in favor of `phel\\debug`.
+
+## 👥 Contributors
+
+Huge thanks to **@Chemaclass**, **@jasalt**, and **@JesusValeraDev** for continuing to push the language forward.
+
+## Dive deeper
+
+For every detail, dig into the official documentation:
+
+- [Full changelog for v0.22.0](https://github.com/phel-lang/phel-lang/compare/v0.21.0...v0.22.0)
+- [Release on GitHub](https://github.com/phel-lang/phel-lang/releases/tag/v0.22.0)