Rewrite the documentation and update packaging

.github/workflows/ci.yml

@@ -11,17 +11,19 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13", "3.14", "3.15"]
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
         with:
           python-version: ${{ matrix.python-version }}
-      - uses: astral-sh/setup-uv@v5
+      - uses: astral-sh/setup-uv@v10.3.3
       - name: Install
         run: uv sync --group dev
       - name: Lint
         run: uv run ruff check .
+      - name: Format
+        run: uv run ruff format --check .
       - name: Typecheck
         run: uv run mypy src
       - name: Test

.gitignore

@@ -8,5 +8,3 @@ __pycache__/
 *.pyc
 .venv/
 .python-version.local
-.tmp/
-.claude/

.python-version

@@ -1 +1 @@
-3.10
+3.11

CHANGELOG.md

@@ -1,10 +1,36 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
+All notable changes to this project are documented in this file.
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.1.0] - 2026-04-13
+## [Unreleased]
 
-- Initial Python SDK scaffold for OctaSpace.
+### Changed
+
+- **Breaking:** Python 3.11 or later is required; Python 3.10 is no longer
+  supported.
+
+### Removed
+
+- **Breaking:** the `octaspace-smoke` command and `python -m octaspace`.
+
+## [0.1.0] - 2026-04-14
+
+### Added
+
+- `OctaSpaceClient` with the resources `accounts`, `nodes`, `sessions`,
+  `apps`, `network`, `idle_jobs` and `services` (`mr`, `vpn`, `render` and
+  `session(uuid)`).
+- `APIResponse` with the parsed JSON, raw body, headers and request ID.
+- Error classes for each HTTP status, network errors and timeouts.
+- Automatic retries with exponential backoff and `Retry-After`.
+- Several API hosts with failover (`base_urls`).
+- Keep-alive connection pool, `on_request` / `on_response` hooks and logging.
+- `ClientConfig.from_env()` and a shared client (`octaspace.configure()`,
+  `octaspace.client()`).
+- Models `Account`, `Balance`, `Node` and `Session`.
+
+[Unreleased]: https://github.com/octaspace/python-sdk/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/octaspace/python-sdk/releases/tag/v0.1.0