docs: Prepare the first tagged release

CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to the FlatRun GitHub Actions are documented in this file.
+
+## [1.0.0] - 2026-08-11
+
+First tagged release. The actions were usable from `main` before this, but nothing resolved
+`@v1`, which is what the README tells people to pin, so every documented example was broken.
+
+### Added
+
+- `setup-flatrun` installs a pinned FlatRun CLI release on the runner and puts it on `PATH`,
+  taking the binary from the release assets and caching it in the runner tool cache. The source
+  repository can be overridden to install from a fork.
+- A `v1` tag that moves with each 1.x release, so `@v1` tracks the latest without a workflow edit,
+  alongside the exact `v1.0.0` tag for anyone pinning strictly.
+
+### Changed
+
+- The examples install CLI 0.3.0, the first version whose command surface covers the whole agent
+  API.

README.md

@@ -19,7 +19,7 @@ jobs:
     steps:
       - uses: flatrun/actions/setup-flatrun@v1
         with:
-          version: 0.1.0
+          version: 0.3.0
       - run: flatrun deployment deploy api
         env:
           FLATRUN_URL: ${{ vars.FLATRUN_URL }}

examples/deploy.yml

@@ -13,7 +13,7 @@ jobs:
 
       - uses: flatrun/actions/setup-flatrun@v1
         with:
-          version: 0.1.0
+          version: 0.3.0
 
       - name: Roll out the new image
         run: flatrun deployment deploy api --pull

setup-flatrun/README.md

@@ -7,7 +7,7 @@ Downloads a pinned release of the [FlatRun CLI](https://github.com/flatrun/cli),
 ```yaml
 - uses: flatrun/actions/setup-flatrun@v1
   with:
-    version: 0.1.0
+    version: 0.3.0
 
 - run: flatrun version
 ```