add CLAUDE.md and fix tasks.py to use tomlkit

tasks.py still called `poetry version` after the move to uv; replace
with a small tomlkit-based bumper (tomlkit is already a dependency).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: snopoke

CLAUDE.md

@@ -0,0 +1,58 @@
+# Task Badger Python SDK
+
+Official Python client for [Task Badger](https://taskbadger.net/). Public package: `taskbadger` on PyPI.
+
+## Commands
+
+```bash
+uv sync --frozen          # Install deps (incl. dev + cli extras via dependency-groups)
+uv run pytest             # Run unit tests (integration_tests/ is excluded by default)
+uv run pytest integration_tests -vs   # Run integration tests (needs Redis + TASKBADGER_API_KEY)
+uv run ruff check . --fix # Lint
+uv run ruff format .      # Format
+uv build                  # Build sdist + wheel
+```
+
+Pre-commit runs ruff-check + ruff-format; install with `uv run pre-commit install`.
+
+## Architecture
+
+- `taskbadger/` — SDK source
+  - `sdk.py`, `mug.py`, `safe_sdk.py` — public API surface (re-exported from `__init__.py`)
+  - `decorators.py` — `@track` decorator
+  - `systems/`, `celery.py` — Celery integration (optional extra)
+  - `cli/`, `cli_main.py` — Typer-based CLI (optional `[cli]` extra)
+  - `internal/` — **generated** by `openapi-python-client`; do not hand-edit
+- `tests/` — unit tests (pytest, pytest-httpx)
+- `integration_tests/` — hits real Task Badger API; excluded from default pytest run
+- `taskbadger.yaml` — OpenAPI schema used to regenerate `internal/`
+
+## Regenerating the API client
+
+```bash
+uv run invoke update-api          # Pull latest schema + regenerate
+uv run invoke update-api --local  # Regenerate from existing taskbadger.yaml
+```
+
+The `update-api` invoke task curls `localhost:8000/api/schema.json` by default — pass `--local` if you don't have the API server running.
+
+## Code Style
+
+- Ruff: line-length 120, target Python 3.10, rules `E F I UP DJ PT`.
+- Supports Python 3.10–3.14 — don't use 3.11+ syntax (e.g. `Self`, `LiteralString`).
+- Celery and CLI deps are optional; guard imports inside `taskbadger/celery.py`, `taskbadger/systems/celery.py`, `taskbadger/cli/`.
+- `taskbadger/internal/*` is generator output — lint is best-effort, don't reformat manually.
+
+## Releasing
+
+```bash
+uv run invoke tag-release  # Bumps version in pyproject.toml, tags, pushes — triggers release.yml
+```
+
+GitHub Actions then drafts a release; publishing the release triggers `publish.yml` → PyPI.
+
+## Gotchas
+
+- `pytest` skips `integration_tests/` via `norecursedirs` — name them explicitly to run.
+- Integration tests need `TASKBADGER_ORG`, `TASKBADGER_PROJECT`, `TASKBADGER_API_KEY` env vars and a running Redis.
+- Imports of `celery`, `typer`, `rich` must stay optional — only the core httpx/attrs deps are guaranteed.

tasks.py

@@ -1,15 +1,18 @@
+from pathlib import Path
+
+import tomlkit
 from invoke import Context, task
 
+PYPROJECT = Path(__file__).parent / "pyproject.toml"
+
 
 @task
 def tag_release(c: Context):
-    version = _get_version(c)
-    bump_key = input("Current version: {version}. Bump? [1: major, 2: minor, 3: patch / n]")
+    version = _get_version()
+    bump_key = input(f"Current version: {version}. Bump? [1: major, 2: minor, 3: patch / n]")
     if bump_key in ("1", "2", "3"):
-        bump = {"1": "major", "2": "minor", "3": "patch"}.get(bump_key)
-
-        c.run(f"poetry version {bump}")
-        version = _get_version(c)
+        bump = {"1": "major", "2": "minor", "3": "patch"}[bump_key]
+        version = _bump_version(bump)
         c.run("git add pyproject.toml")
         c.run(f"git commit -m 'Bump version to {version}'")
 
@@ -21,11 +24,6 @@ def tag_release(c: Context):
         print("Check https://github.com/taskbadger/taskbadger-python/releases and publish the release.")
 
 
-def _get_version(c):
-    version = c.run("poetry version -s", hide="out").stdout.strip()
-    return version
-
-
 @task
 def update_api(c, local=False):
     if not local:
@@ -35,3 +33,25 @@ def update_api(c, local=False):
         "--config generator_config.yml --overwrite "
         "--output-path taskbadger/internal"
     )
+
+
+def _get_version() -> str:
+    doc = tomlkit.parse(PYPROJECT.read_text())
+    return doc["project"]["version"]
+
+
+def _bump_version(part: str) -> str:
+    doc = tomlkit.parse(PYPROJECT.read_text())
+    major, minor, patch = (int(x) for x in doc["project"]["version"].split("."))
+    if part == "major":
+        major, minor, patch = major + 1, 0, 0
+    elif part == "minor":
+        minor, patch = minor + 1, 0
+    elif part == "patch":
+        patch += 1
+    else:
+        raise ValueError(f"unknown bump part: {part}")
+    new = f"{major}.{minor}.{patch}"
+    doc["project"]["version"] = new
+    PYPROJECT.write_text(tomlkit.dumps(doc))
+    return new