chore: prepare release v0.8.2

[AliMuhammadOfficial]

Pull Request

Summary

Prepares the corrected 0.8.2 patch release after the malformed 0.8.1 GitHub Release failed version validation.

This change synchronizes all required release surfaces:

• Updates pyproject.toml from 0.8.0 to 0.8.2.
• Synchronizes the project package version in uv.lock.
• Updates the current version in README.md.
• Moves the documentation improvements into the dated 0.8.2 changelog section.
• Records the 0.8.1 release-metadata recovery.
• Updates changelog comparison links for v0.8.2.

After approval, merge, and TestPyPI verification, the immutable v0.8.2 tag will deploy the updated versioned documentation and refresh the latest alias.

Change type

• Bug fix
• Backward-compatible feature
• Breaking change
• Documentation
• Test or internal maintenance
• Security-sensitive change handled through a private advisory

Compatibility

No Python API, CLI, YAML/TOML, checkpoint, durable-run-data, provider, or tool protocol contracts change.

• Version impact: patch
• Deprecation or migration path: None required.
• Rollback or persisted-data impact: No persisted-data impact. Published versions and tags remain immutable; any release defect must be corrected with a later patch rather than moving or replacing v0.8.2.

Verification

• Regression or behavior tests added or updated
• uv run python -m pytest
• uv run python -m ruff check .
• uv run python -m ruff format --check src/
• uv run python -m pyright
• uv run python -m mkdocs build --strict

Additional release verification:

• uv sync --locked --group dev
• uv run python scripts/check_versions.py
• uv run python scripts/check_versions.py --tag v0.8.2
• Credential-free test run: 891 passed, 15 deselected
• uv run python scripts/check_docs.py — 403 exports and 40 examples verified
• uv run python -m build --no-isolation
• uv run python -m twine check --strict dist/*
• Built exactly anycode_py-0.8.2-py3-none-any.whl and anycode_py-0.8.2.tar.gz
• git diff --check

The two optional live-provider tests were excluded from the credential-free local run because the workstation contains provider credentials while network access is restricted. GitHub release CI runs without those local credentials.

Documentation and release notes

• Public docstrings and reference pages match the implementation
• Guides, examples, README, and site_docs/llms.txt reviewed and updated where needed
• [Unreleased] changes moved into the dated 0.8.2 changelog section
• Security, configuration, and release documentation reviewed where needed

Reviewer notes

The public GitHub Release named 0.8.1 was created with the wrong tag format and points to source declaring version 0.8.0. Its publication workflow failed before publishing anycode-py==0.8.1 or updated versioned documentation.

Because that GitHub Release is already public, it must not be deleted, moved, or reused. This PR intentionally advances to 0.8.2.

Required post-merge sequence:

1. Record the reviewed release merge commit.
2. Run the TestPyPI workflow against that exact commit.
3. Verify installation, core import, CLI version, metadata, and optional dependencies.
4. Create immutable tag v0.8.2.
5. Confirm documentation deployment updates version 0.8 and the latest alias.
6. Publish the v0.8.2 GitHub Release only after the preflight passes.
7. Annotate the malformed 0.8.1 release as failed and direct users to 0.8.2.