release: v0.5.0

Author: gilbertwong96

CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to `ado` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.5.0] - 2026-07-22
 
 ### Added
 
@@ -14,16 +14,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   (fzf-style) matching, case-insensitive. Filtering is client-side
   since the Azure DevOps reviewers API returns all reviewers for a PR.
 
+- **`ado-cli` skill restructured into reference files.** The 540-line
+  SKILL.md is now a lean 284-line overview + 7 topic-focused reference
+  files (`references/prs.md`, `references/repos.md`, etc.) readable
+  via `ado skills read ado-cli/references/prs.md`.
+
 ### Fixed
 
-- **EPIPE hang in Burrito binaries when piping to `head`/`less`.**
-  When stdout was piped to a command that exits early (e.g.
-  `ado schema | head -5`), the BEAM's standard_io group leader crashed
-  on EPIPE and the VM hung indefinitely trying to flush IO during
-  shutdown. Burrito's `child.wait()` blocked forever. Fixed in the
-  forked Burrito Zig wrapper: child stdout is now piped through the
-  wrapper process, and when the downstream pipe breaks (EPIPE), the
-  child is killed immediately.
+- **EPIPE hang when piping to `head`/`less`.** When stdout was piped to
+  a command that exits early (e.g. `ado schema | head -5`), the BEAM's
+  standard_io group leader crashed on EPIPE and the VM hung indefinitely
+  trying to flush IO during shutdown. Fixed in two places:
+  - **Burrito binaries:** The forked Burrito Zig wrapper now pipes child
+    stdout through itself. When the downstream pipe breaks (EPIPE), the
+    copy thread kills the BEAM child immediately.
+  - **Escripts:** `CLI.run/1` catches the `ErlangError` (`:terminated`)
+    and halts with `flush:false`, avoiding the `Writer crashed (epipe)`
+    stack trace.
 
 - **Switching auth methods no longer leaves stale credentials in the
   config file.** Previously `ConfigFile.save/1` merged new config over
@@ -40,6 +47,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   without an explicit `--method`. Passing `--method` still overrides
   the inference.
 
+### Changed
+
+- **`ado-ci` skill download URLs updated** to use version-agnostic
+  `latest/download/` links instead of pinned `ado-0.4.3-*` filenames.
+
+- **`ado-auth` skill pitfalls table cleaned up** — removed 4 historical
+  bug-fix rows (v0.4.2/v0.4.3 fixes) that are no longer actionable.
+
+- **burrito upgraded** to `30be1e1` (zig-0.16.0 branch), which includes
+  the EPIPE pipe-copy fix above.
+
 ## [0.4.12] - 2026-06-27
 
 ### Fixed

github-page/index.html

@@ -227,9 +227,9 @@ <h2>Other install methods</h2>
         <div class="card">
           <h3>📥 Download binary</h3>
           <p>Grab the platform-specific binary and put it on your <code>$PATH</code>.</p>
-          <pre><code>curl -L -o ado https://github.com/gilbertwong96/ado_cli/releases/latest/download/ado-0.4.12-macos-aarch64
+          <pre><code>curl -L -o ado https://github.com/gilbertwong96/ado_cli/releases/latest/download/ado-0.5.0-macos-aarch64
 chmod +x ado &amp;&amp; sudo mv ado /usr/local/bin/</code></pre>
-          <p class="hint">Replace <code>ado-0.4.12-macos-aarch64</code> with the binary for your platform (see the <a href="https://github.com/gilbertwong96/ado_cli/releases/latest">release page</a>).</p>
+          <p class="hint">Replace <code>ado-0.5.0-macos-aarch64</code> with the binary for your platform (see the <a href="https://github.com/gilbertwong96/ado_cli/releases/latest">release page</a>).</p>
         </div>
         <div class="card">
           <h3>🔨 Build from source</h3>

mix.exs

@@ -4,7 +4,7 @@ defmodule AdoCli.MixProject do
   def project do
     [
       app: :ado_cli,
-      version: "0.4.12",
+      version: "0.5.0",
       elixir: "~> 1.20",
       start_permanent: Mix.env() == :prod,
       deps: deps(),

npm/@gilbertwong1996-ado-darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gilbertwong1996/ado-darwin-arm64",
-  "version": "0.4.12",
+  "version": "0.5.0",
   "description": "ado binary for macOS Apple Silicon (arm64)",
   "license": "Apache-2.0",
   "repository": {

npm/@gilbertwong1996-ado-darwin-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gilbertwong1996/ado-darwin-x64",
-  "version": "0.4.12",
+  "version": "0.5.0",
   "description": "ado binary for macOS Intel (x86_64)",
   "license": "Apache-2.0",
   "repository": {

npm/@gilbertwong1996-ado-linux-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gilbertwong1996/ado-linux-arm64",
-  "version": "0.4.12",
+  "version": "0.5.0",
   "description": "ado binary for Linux ARM64 (aarch64)",
   "license": "Apache-2.0",
   "repository": {

npm/@gilbertwong1996-ado-linux-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gilbertwong1996/ado-linux-x64",
-  "version": "0.4.12",
+  "version": "0.5.0",
   "description": "ado binary for Linux x86_64",
   "license": "Apache-2.0",
   "repository": {

npm/@gilbertwong1996-ado-win32-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gilbertwong1996/ado-win32-x64",
-  "version": "0.4.12",
+  "version": "0.5.0",
   "description": "ado binary for Windows x86_64",
   "license": "Apache-2.0",
   "repository": {

npm/@gilbertwong1996-ado/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gilbertwong1996/ado",
-  "version": "0.4.12",
+  "version": "0.5.0",
   "description": "AI-native Azure DevOps CLI — structured JSON output, embedded skills for LLM agents, single-file cross-platform binary.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/gilbertwong96/ado_cli",
@@ -37,10 +37,10 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@gilbertwong1996/ado-darwin-arm64": "0.4.12",
-    "@gilbertwong1996/ado-darwin-x64": "0.4.12",
-    "@gilbertwong1996/ado-linux-arm64": "0.4.12",
-    "@gilbertwong1996/ado-linux-x64": "0.4.12",
-    "@gilbertwong1996/ado-win32-x64": "0.4.12"
+    "@gilbertwong1996/ado-darwin-arm64": "0.5.0",
+    "@gilbertwong1996/ado-darwin-x64": "0.5.0",
+    "@gilbertwong1996/ado-linux-arm64": "0.5.0",
+    "@gilbertwong1996/ado-linux-x64": "0.5.0",
+    "@gilbertwong1996/ado-win32-x64": "0.5.0"
   }
 }

priv/skills/ado-auth/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ado-auth
 description: "Authenticate ado: PAT (CI-friendly), browser OAuth (AAD + MSA), device code (headless), env vars, self-hosted server"
-version: "0.4.12"
+version: "0.5.0"
 commands:
   - ado login
   - ado login --method device