From 1fb132119391af839a61f75ac335e29190aaba8a Mon Sep 17 00:00:00 2001
From: Robert DeLanghe <1240090+bdelanghe@users.noreply.github.com>
Date: Wed, 24 Jun 2026 09:55:37 -0400
Subject: [PATCH 1/2] chore: adopt @bounded-systems/mint for versioning

---
 .github/workflows/version.yml | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 .github/workflows/version.yml

diff --git a/.github/workflows/version.yml b/.github/workflows/version.yml
new file mode 100644
index 0000000..ce5f52b
--- /dev/null
+++ b/.github/workflows/version.yml
@@ -0,0 +1,18 @@
+name: version
+
+# Versioning via the bounded-systems mint capability. Validates .release/ intents
+# (fails closed on a malformed one) and previews the next version on every PR.
+# Pinned to an immutable mint commit SHA; bump when mint tags.
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  version:
+    uses: bounded-systems/mint/.github/workflows/version.yml@7bc5c9c0826aa7bcb1fc78c8286ab6cc6311630a # mint
+    with:
+      ref: 7bc5c9c0826aa7bcb1fc78c8286ab6cc6311630a

From 36972b052a018be7dd6324d34a2920e33627f2e7 Mon Sep 17 00:00:00 2001
From: Robert DeLanghe <1240090+bdelanghe@users.noreply.github.com>
Date: Wed, 24 Jun 2026 09:55:38 -0400
Subject: [PATCH 2/2] chore: add .release intent directory

---
 .release/README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 .release/README.md

diff --git a/.release/README.md b/.release/README.md
new file mode 100644
index 0000000..fa57da5
--- /dev/null
+++ b/.release/README.md
@@ -0,0 +1,15 @@
+# Release intents
+
+This repo uses [@bounded-systems/mint](https://github.com/bounded-systems/mint) for
+versioning. Each PR with a user-facing change drops an intent file here; mint
+resolves the strongest bump and cuts the release deterministically.
+
+Format — `.release/<slug>.md`:
+
+    ---
+    bump: minor   # patch | minor | major
+    ---
+    short summary of the change (becomes the changelog line)
+
+The `version` CI job runs `mint plan`, which validates every intent and previews
+the next version.