From 4b8b1a0a6e6a3d4e19669559d1f928f952d7ddcb Mon Sep 17 00:00:00 2001 From: Marcus van Elst Date: Mon, 18 May 2026 09:09:30 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20CLAUDE.md=20=E2=80=94=20push-retry=20ru?= =?UTF-8?q?le=20and=20version-consistency=20invariant?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Document that git push to gitea.gecheckt.de occasionally returns Unauthorized on the first attempt and must be retried once after a 1 s wait before reporting an auth failure. - Codify the version-consistency invariant: pyproject.toml, uv.lock, and the latest CHANGELOG heading must move together; src/mcp_synology_container/__init__.py reads __version__ from importlib.metadata and is never hand-edited. Co-Authored-By: Claude Opus 4.7 --- CLAUDE.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 50a7a28..8e41081 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -26,6 +26,11 @@ containers, images, compose files, networks, and system housekeeping. 3. Restart Claude Desktop (tray icon → Quit → relaunch) ``` +**Push retry:** the Gitea remote (`gitea.gecheckt.de`) occasionally +returns `Unauthorized` on the first push attempt. If `git push` fails +with an auth error, wait 1 s and retry once before reporting back. +Only a second consecutive failure is treated as a real auth problem. + --- ## Implemented tools (23) @@ -72,6 +77,11 @@ containers, images, compose files, networks, and system housekeeping. - Type hints and docstrings everywhere - Formatter: `ruff format` · Linter: `ruff check` · Tests: `pytest` - All text (docstrings, comments, README): English +- **Version consistency:** the package version lives in `pyproject.toml` + and must stay in sync with `uv.lock` and the `[X.Y.Z]` heading in + `CHANGELOG.md`. `src/mcp_synology_container/__init__.py` derives + `__version__` from `importlib.metadata` and is never hand-edited. + Every version bump touches all three files in the same commit. ---