From 6751c7dcd1e4df66bd40eafc98484065c8984cdc Mon Sep 17 00:00:00 2001
From: kreczko <lkreczko@googlemail.com>
Date: Mon, 26 Oct 2026 12:43:47 +0000
Subject: [PATCH] docs: add CHANGELOG.md and a docs-update policy

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 AGENTS.md    |  7 +++++++
 CHANGELOG.md | 27 +++++++++++++++++++++++++++
 2 files changed, 34 insertions(+)
 create mode 100644 CHANGELOG.md

diff --git a/AGENTS.md b/AGENTS.md
index e672a83..9915d81 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -109,3 +109,10 @@ environment-qualified runs for Python-version or docs-specific work.
 - CLI test outputs, compiled workflow artifacts, downloaded files and generated
   docs are products of tests or commands. Do not check them in unless they are
   intentional fixtures.
+
+## Documentation and Changelog
+
+User-facing changes — new features, behavior changes, bug fixes, breaking changes — must add an
+entry to `CHANGELOG.md` under `## [Unreleased]`, in the matching [Keep a
+Changelog](https://keepachangelog.com/en/1.1.0/) category (Added, Changed, Deprecated, Removed,
+Fixed, Security). This repository has no `docs/` yet.
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..7a4b2c6
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This project uses
+calendar versioning (`YYYY.MM.N`) rather than semantic versioning.
+
+Add new entries under `## [Unreleased]`, in the category they belong to. At release time, rename
+`## [Unreleased]` to `## [<version>] - <YYYY-MM-DD>` and start a fresh `## [Unreleased]` above it.
+
+## [Unreleased]
+
+### Added
+
+- Progress display for distributed execution updates.
+
+### Changed
+
+- Now depends on `fasthep-toolbench[display,http]` explicitly, since Toolbench is making `rich`,
+  `httpx` and `tabulate` optional extras rather than hard dependencies.
+
+## [2026.08.2] - 2026-08-25
+
+### Added
+
+- Partition selection for runtime commands.
+- Simple progress reporting during command execution.