chore(release): prepare 0.27.0

[elkaix]

Prepares the 0.27.0 release: version bump across the standard release file set, plus CHANGELOG/README/docs narrative.

What changed in this release

• /feedback submits structured reports with redacted session context. New /feedback [bug|feature|ux|wrong] [message] command (feat(feedback): add structured feedback reporting #31).
• Fresh releases surface in the startup update prompt immediately. Pre-start prompt revalidates cached "already current" with a bounded conditional request; promotion waits for native assets, PyPI, and the Homebrew tap before marking latest (fix(update): startup readiness and reliability cleanups #30).
• Background agent recovery preserves terminal task state. Recovery re-reads task runtime under the store update lock before marking orphaned work recoverable (fix: address audit bug regressions #29).
• Project memory recall keeps the simple lexical path. Unused SQLite FTS retriever seam and dead recall path argument removed (fix: address audit bug regressions #29).
• Shell prompt echoes and background todo rows are clearer. (fix: address audit bug regressions #29)
• StrReplaceFile refuses ambiguous single replacements. Non-replace_all edit errors when old matches more than once (fix: address audit bug regressions #29).

Dependency bump (#32) and CI-only changes (#25, #27, #28) are intentionally not in the user-facing notes, consistent with prior releases.

Release mechanics

• Version bumped 0.26.0 → 0.27.0 across the standard ~18-file scaffold (pyproject, uv.lock, install scripts, workflow input examples, README/docs asset names).
• ## Unreleased consumed into ## 0.27.0 (2026-05-31); mirrored into docs changelog; breaking-changes entry added (no breaking changes).
• Local gates pass: version-tag check, README markers, CHANGELOG header, pythinker dependency-version check, tests/test_installation_docs.py + tests/test_homebrew_formula.py (17 passed).

Summary by CodeRabbit

• New Features

  • Structured feedback submissions with improved context handling
  • Enhanced background agent recovery for terminal tasks
  • Improved release promotion and update prompt revalidation
  • Project memory and session path enhancements
  • Stricter file replacement validation

• Documentation

  • Updated installation guides and scripts for version 0.27.0
  • Added release notes and breaking changes documentation

• Chores

  • Version bump to 0.27.0

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 08f27cf6-2177-41c3-b7a4-2737830e3fad

📥 Commits

Reviewing files that changed from the base of the PR and between a0a2f96 and 989b154.

⛔ Files ignored due to path filters (1)

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

📒 Files selected for processing (18)

• .github/workflows/homebrew-tap.yml
• .github/workflows/linux-installer.yml
• .github/workflows/promote-release.yml
• .github/workflows/windows-installer.yml
• CHANGELOG.md
• README.md
• docs/en/guides/getting-started.md
• docs/en/release-notes/breaking-changes.md
• docs/en/release-notes/changelog.md
• docs/public/install.ps1
• docs/public/install.sh
• packages/homebrew-tap/generate-formula.py
• packages/linux-installer/README.md
• pyproject.toml
• scripts/install-native.sh
• scripts/install.ps1
• web/public/install.ps1
• web/public/install.sh

---

📝 Walkthrough

Walkthrough

This PR is a straightforward version bump to 0.27.0 across the entire project. Changes include updating pyproject.toml metadata, GitHub workflow input descriptions, release notes and changelogs, installation documentation for Windows and Linux, installer script examples, and package build documentation.

Changes

Release version 0.27.0 update

Layer / File(s)	Summary
Version metadata and workflow configuration pyproject.toml, .github/workflows/homebrew-tap.yml, .github/workflows/linux-installer.yml, .github/workflows/promote-release.yml, .github/workflows/windows-installer.yml	The project version is bumped to 0.27.0 in pyproject.toml. GitHub Actions workflow input descriptions for manual version/tag entry are updated to show 0.27.0 as the current example version.
Release notes and changelog CHANGELOG.md, docs/en/release-notes/breaking-changes.md, docs/en/release-notes/changelog.md	CHANGELOG.md now includes 0.27.0 release section with upgrade instructions. Breaking-changes documentation confirms no breaking changes relative to 0.26.0. Detailed changelog lists feature updates including structured feedback submissions, startup update prompt revalidation, agent recovery, project memory paths, shell transcript alignment, and stricter StrReplaceFile behavior.
User-facing installation documentation README.md, docs/en/guides/getting-started.md	README adds "What's New in 0.27.0" section and updates all installation examples (Windows exe names, Linux deb/rpm package names and URLs, sha256 verification filenames, curl version pinning) to 0.27.0. Getting-started guide updates Linux/macOS and Windows install command references.
Installer scripts and examples docs/public/install.ps1, docs/public/install.sh, scripts/install-native.sh, scripts/install.ps1, web/public/install.ps1, web/public/install.sh	Version pinning comments and usage examples across public and internal installer scripts are updated from 0.26.0 to 0.27.0.
Package build documentation and scripts packages/linux-installer/README.md, packages/homebrew-tap/generate-formula.py	Linux installer README updates download URLs, checksum filenames, build command arguments, and dist artifact naming to 0.27.0 for both deb and rpm packages across architectures. Homebrew formula script example usage updated to reference 0.27.0.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• TechMatrix-labs/pythinker-code#24: Earlier 0.26.0 version bump that follows the same pattern of updating workflow inputs, documentation, installation examples, and script references across the project.
• TechMatrix-labs/pythinker-code#14: Another release version bump applying consistent version reference updates across workflows, README, installers, and build documentation.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'chore(release): prepare 0.27.0' follows the conventional commits format and accurately describes the release preparation changes.
Description check	✅ Passed	The description comprehensively covers what changed, why, release mechanics, and verification; it exceeds the template requirements despite not matching the exact structure.
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 docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

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

---

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