chore(release): prepare 0.31.0

[elkaix]

Summary

• Bumps version to 0.31.0 across pyproject.toml, uv.lock, changelogs, READMEs, and installer docs
• Promotes Unreleased CHANGELOG entries to 0.31.0 (2026-06-02): calmer TUI rendering, auto-mode fails-closed, yolo hardening, reviewflow validation, Homebrew tap best-effort gate
• Adds 0.31.0 no-breaking-changes entry to breaking-changes.md

Test plan

• check_version_tag.py passes
• README What's New heading and upgrade snippet verified
• CHANGELOG 0.31.0 entry present
• check_pythinker_dependency_versions.py passes
• tests/test_installation_docs.py and tests/test_homebrew_formula.py — 17 passed

Summary by CodeRabbit

• Documentation

  • Released version 0.31.0 with updated release notes and guides
  • Synchronized installation instructions across Windows, Linux, and macOS platforms
  • Confirmed backward compatibility with version 0.30.0

• Chores

  • Updated package version to 0.31.0

[coderabbitai]

📝 Walkthrough

Walkthrough

This PR updates version references from 0.30.0 to 0.31.0 across project metadata (pyproject.toml), release documentation (CHANGELOG.md and release-notes), and all user-facing installation guides (README.md, getting-started.md, and linux-installer documentation). No code changes, configuration, or dependencies are modified.

Changes

0.31.0 Release Documentation

Layer / File(s)	Summary
Project metadata and release notes pyproject.toml, CHANGELOG.md, docs/en/release-notes/changelog.md, docs/en/release-notes/breaking-changes.md	Project version is bumped to 0.31.0. Release sections are created in changelog files documenting feature updates (TUI theming, auto-mode approval behavior, plan-mode semantics) and confirming no breaking changes versus 0.30.0.
Platform-specific installation guides README.md, docs/en/guides/getting-started.md, packages/linux-installer/README.md	Windows installer filenames, Linux .deb/.rpm package names, GitHub Release download URLs, and .sha256 checksum verification commands are updated to reference 0.31.0 artifacts across Quick Start tables, native installer sections, and platform-specific build documentation.

---

🎯 1 (Trivial) | ⏱️ ~2 minutes

---

Possibly related PRs

• Pythoughts-labs/pythinker-code#59: Prior release-prep version bump to 0.30.0 that updated the same files and sections (CHANGELOG, README, getting-started, breaking-changes, linux-installer, and pyproject.toml).
• Pythoughts-labs/pythinker-code#53: Earlier release-prep version bump that established the pattern of synchronizing version references across documentation and build metadata.

---

Suggested labels

documentation

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	Title follows conventional commits format with appropriate type (chore) and scope (release), accurately describing the version bump to 0.31.0.
Description check	✅ Passed	PR description is complete with summary, test plan results, and all checklist items verified; follows repository guidelines.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch release/0.31.0

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/en/release-notes/changelog.md`:
- Around line 20-31: The release notes file was edited directly; revert those
manual edits and instead make your changes in the canonical CHANGELOG.md at the
repo root, then run the repository's sync script to regenerate the mirrored
release-notes changelog (do not manually edit the release-notes changelog file),
ensuring the authoritative CHANGELOG.md is the single source-of-truth and the
sync script produces the updated docs.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 43775075-6da1-482c-87b0-3d844f7d9906

📥 Commits

Reviewing files that changed from the base of the PR and between fd8622f and 8f89c81.

⛔ Files ignored due to path filters (1)

• uv.lock is excluded by !**/*.lock

📒 Files selected for processing (7)

• CHANGELOG.md
• README.md
• docs/en/guides/getting-started.md
• docs/en/release-notes/breaking-changes.md
• docs/en/release-notes/changelog.md
• packages/linux-installer/README.md
• pyproject.toml