pythinker-code 0.26.0__tar.gz → 0.27.0__tar.gz

{pythinker_code-0.26.0 → pythinker_code-0.27.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythinker-code
-Version: 0.26.0
+Version: 0.27.0
 Summary: Pythinker Code is your next CLI agent.
 Keywords: cli,agent,ai,coding-assistant,llm,claude,openai,terminal
 Author: Mohamed Elkholy
@@ -21,7 +21,7 @@ Classifier: Topic :: Software Development :: Code Generators
 Classifier: Topic :: Utilities
 Requires-Dist: agent-client-protocol==0.8.0
 Requires-Dist: aiofiles>=24.0,<26.0
-Requires-Dist: aiohttp==3.13.4
+Requires-Dist: aiohttp==3.13.5
 Requires-Dist: typer==0.21.1
 Requires-Dist: pythinker-core[contrib]==1.1.1
 Requires-Dist: loguru>=0.6.0,<0.7
@@ -34,7 +34,7 @@ Requires-Dist: click==8.3.0
 Requires-Dist: pyperclip==1.11.0
 Requires-Dist: streamingjson==0.0.5
 Requires-Dist: trafilatura==2.0.0
-Requires-Dist: lxml==6.1.0
+Requires-Dist: lxml==6.1.1
 Requires-Dist: tenacity==9.1.4
 Requires-Dist: fastmcp==3.2.0
 Requires-Dist: pydantic==2.13.4
@@ -42,7 +42,7 @@ Requires-Dist: httpx[socks]==0.28.1
 Requires-Dist: pythinker-host==1.0.0
 Requires-Dist: pythinker-review==0.1.0
 Requires-Dist: batrachian-toad==0.5.23 ; python_full_version >= '3.14'
-Requires-Dist: tomlkit==0.14.0
+Requires-Dist: tomlkit==0.15.0
 Requires-Dist: jinja2==3.1.6
 Requires-Dist: pyobjc-framework-cocoa>=12.1 ; sys_platform == 'darwin'
 Requires-Dist: fastapi>=0.115.0
@@ -115,15 +115,15 @@ It speaks the [**Agent Client Protocol (ACP)**](https://github.com/agentclientpr
 
 ---
 
-## 🆕 What's New in 0.26.0
+## 🆕 What's New in 0.27.0
 
-- **Install and update no longer 404 on a freshly published release.** Releases are now published as a prerelease and promoted to "latest" only once every platform asset has uploaded, and the curl/PowerShell installers wait for their archive + checksum before downloading — so `irm | iex` / `curl | bash` run mid-publish no longer fail on a missing installer.
-- **OpenCode Go model catalog refreshes on startup without a re-login.** Bundled catalog changes (new models, corrected provider shapes) now reach existing installs through the every-startup refresh, across both OpenAI- and Anthropic-shaped providers, while preserving your default model and thinking settings.
-- **Homebrew install shows the logo and fails fast on a missing tap token.** `brew install` now prints the robot-head banner via formula caveats, and the tap workflow reports an actionable error when `HOMEBREW_TAP_TOKEN` is missing instead of an opaque git failure.
-- **Markdown and report rendering hardened against real model output.** Code-span pipes inside tables no longer fracture the table, and a `report` block nested inside a documentation fence is no longer wrongly promoted — report fences are now extracted via a markdown-it AST walk.
-- **Steadier agent editing and a restored update prompt.** File-replace edit handling is hardened, subagent prompt persistence and the agent's working language are preserved, and the blocking pre-start update prompt is restored so it runs before every interactive session.
+- **`/feedback` submits structured reports with redacted session context.** A new `/feedback [bug|feature|ux|wrong] [message]` command collects recent session context, strips sensitive file contents before sending, shows a confirmation preview, and falls back to a prefilled GitHub issue when direct submission is unavailable.
+- **Fresh releases surface in the startup update prompt immediately.** The pre-start update prompt revalidates a cached "already current" answer with a bounded conditional request instead of waiting for the 24-hour throttle, and release promotion now waits for the native assets, PyPI, and the Homebrew tap before marking a version latest — so clients never resolve a release before its install channel is ready.
+- **Background agent recovery preserves terminal task state.** Recovery re-reads task runtime under the store update lock before marking orphaned agent work recoverable, so a stale snapshot can no longer clobber a task that already completed.
+- **Shell prompt echoes and background todo rows are clearer.** Transcript echoes now show the resolved submitted text for pasted-content placeholders, and background todo rows align continuation icons with the first row.
+- **StrReplaceFile refuses ambiguous single replacements.** A non-`replace_all` edit now errors when `old` matches more than once instead of silently editing the first match — add surrounding context to make it unique, or pass `replace_all=true` when every occurrence should change.
 
-Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.26.0`, or use the native installer for your platform from the [Releases page](https://github.com/TechMatrix-labs/pythinker-code/releases/latest).
+Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.27.0`, or use the native installer for your platform from the [Releases page](https://github.com/TechMatrix-labs/pythinker-code/releases/latest).
 
 
 ---
@@ -213,7 +213,7 @@ matches your OS — no Python, Node, or `uv` prerequisite.
 
 | Platform | Recommended install | Artifact source |
 |---|---|---|
-| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | `PythinkerSetup-0.26.0.exe` from [Releases](https://github.com/TechMatrix-labs/pythinker-code/releases/latest) |
+| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | `PythinkerSetup-0.27.0.exe` from [Releases](https://github.com/TechMatrix-labs/pythinker-code/releases/latest) |
 | **<img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> / <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux">** | `curl -fsSL https://pythinker.com/install.sh \| bash` | native tarball from [Releases](https://github.com/TechMatrix-labs/pythinker-code/releases/latest) |
 | **<img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> — Homebrew** | `brew install TechMatrix-labs/pythinker/pythinker-code` | auto-published Homebrew tap |
 | **<img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux"> — system package** | Download the `.deb` or `.rpm` for your distro below | [Releases](https://github.com/TechMatrix-labs/pythinker-code/releases/latest) |
@@ -238,7 +238,7 @@ pythinker                      # start the interactive TUI
 
 ### 🪟 Windows — native installer
 
-`PythinkerSetup-0.26.0.exe` is a signed* Inno Setup wizard. Installs per-user
+`PythinkerSetup-0.27.0.exe` is a signed* Inno Setup wizard. Installs per-user
 into `%LOCALAPPDATA%\Programs\Pythinker`, registers `pythinker` on your user
 PATH (`HKCU\Environment`), broadcasts `WM_SETTINGCHANGE` so new shells see
 the change. **No UAC prompt.**
@@ -249,13 +249,13 @@ irm https://pythinker.com/install.ps1 | iex
 
 # Or manually download the installer + checksum from the Releases page,
 # verify with Get-FileHash, then run:
-.\PythinkerSetup-0.26.0.exe
+.\PythinkerSetup-0.27.0.exe
 
 # Open a fresh PowerShell
 pythinker --version
 ```
 
-**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.26.0.exe /ALLUSERS`
+**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.27.0.exe /ALLUSERS`
 installs to `%ProgramFiles%\Pythinker` and writes PATH to HKLM (requires admin).
 
 **Upgrade:** `pythinker update` from inside the running app — it downloads
@@ -306,26 +306,26 @@ attached to every GitHub Release.
 
 ```sh
 # Debian / Ubuntu (x86_64)
-sudo dpkg -i pythinker-code_0.26.0_amd64.deb
+sudo dpkg -i pythinker-code_0.27.0_amd64.deb
 sudo apt-get install -f       # only if dpkg reports missing deps
 
 # Debian / Ubuntu (ARM64)
-sudo dpkg -i pythinker-code_0.26.0_arm64.deb
+sudo dpkg -i pythinker-code_0.27.0_arm64.deb
 
 # Fedora / RHEL / openSUSE (x86_64)
-curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.26.0/pythinker-code-0.26.0.x86_64.rpm
-curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.26.0/pythinker-code-0.26.0.x86_64.rpm.sha256
-sha256sum -c pythinker-code-0.26.0.x86_64.rpm.sha256
+curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.27.0/pythinker-code-0.27.0.x86_64.rpm
+curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.27.0/pythinker-code-0.27.0.x86_64.rpm.sha256
+sha256sum -c pythinker-code-0.27.0.x86_64.rpm.sha256
 # Fedora / RHEL:
-sudo dnf install ./pythinker-code-0.26.0.x86_64.rpm
+sudo dnf install ./pythinker-code-0.27.0.x86_64.rpm
 # openSUSE:
-sudo zypper install ./pythinker-code-0.26.0.x86_64.rpm
+sudo zypper install ./pythinker-code-0.27.0.x86_64.rpm
 
 # Fedora / RHEL (aarch64)
-curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.26.0/pythinker-code-0.26.0.aarch64.rpm
-curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.26.0/pythinker-code-0.26.0.aarch64.rpm.sha256
-sha256sum -c pythinker-code-0.26.0.aarch64.rpm.sha256
-sudo dnf install ./pythinker-code-0.26.0.aarch64.rpm
+curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.27.0/pythinker-code-0.27.0.aarch64.rpm
+curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.27.0/pythinker-code-0.27.0.aarch64.rpm.sha256
+sha256sum -c pythinker-code-0.27.0.aarch64.rpm.sha256
+sudo dnf install ./pythinker-code-0.27.0.aarch64.rpm
 ```
 
 Both packages drop a small `/usr/bin/pythinker` launcher that execs the real
@@ -334,8 +334,8 @@ binary under `/usr/lib/pythinker/`, so your `$PATH` stays tidy.
 **Verify before install:**
 
 ```sh
-sha256sum -c pythinker-code_0.26.0_amd64.deb.sha256        # Debian/Ubuntu
-sha256sum -c pythinker-code-0.26.0.x86_64.rpm.sha256       # Fedora/RHEL
+sha256sum -c pythinker-code_0.27.0_amd64.deb.sha256        # Debian/Ubuntu
+sha256sum -c pythinker-code-0.27.0.x86_64.rpm.sha256       # Fedora/RHEL
 ```
 
 **Upgrade:** download the new `.deb`/`.rpm` from Releases and `dpkg -i` /
@@ -365,7 +365,7 @@ at `~/.local/bin/pythinker`.
 curl -fsSL https://pythinker.com/install.sh | bash
 
 # Pin a specific version
-curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.26.0
+curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.27.0
 
 # Custom prefix (defaults to $HOME/.local)
 curl -fsSL https://pythinker.com/install.sh | bash -s -- --prefix /opt/pythinker

{pythinker_code-0.26.0 → pythinker_code-0.27.0}/README.md

@@ -50,15 +50,15 @@ It speaks the [**Agent Client Protocol (ACP)**](https://github.com/agentclientpr
 
 ---
 
-## 🆕 What's New in 0.26.0
+## 🆕 What's New in 0.27.0
 
-- **Install and update no longer 404 on a freshly published release.** Releases are now published as a prerelease and promoted to "latest" only once every platform asset has uploaded, and the curl/PowerShell installers wait for their archive + checksum before downloading — so `irm | iex` / `curl | bash` run mid-publish no longer fail on a missing installer.
-- **OpenCode Go model catalog refreshes on startup without a re-login.** Bundled catalog changes (new models, corrected provider shapes) now reach existing installs through the every-startup refresh, across both OpenAI- and Anthropic-shaped providers, while preserving your default model and thinking settings.
-- **Homebrew install shows the logo and fails fast on a missing tap token.** `brew install` now prints the robot-head banner via formula caveats, and the tap workflow reports an actionable error when `HOMEBREW_TAP_TOKEN` is missing instead of an opaque git failure.
-- **Markdown and report rendering hardened against real model output.** Code-span pipes inside tables no longer fracture the table, and a `report` block nested inside a documentation fence is no longer wrongly promoted — report fences are now extracted via a markdown-it AST walk.
-- **Steadier agent editing and a restored update prompt.** File-replace edit handling is hardened, subagent prompt persistence and the agent's working language are preserved, and the blocking pre-start update prompt is restored so it runs before every interactive session.
+- **`/feedback` submits structured reports with redacted session context.** A new `/feedback [bug|feature|ux|wrong] [message]` command collects recent session context, strips sensitive file contents before sending, shows a confirmation preview, and falls back to a prefilled GitHub issue when direct submission is unavailable.
+- **Fresh releases surface in the startup update prompt immediately.** The pre-start update prompt revalidates a cached "already current" answer with a bounded conditional request instead of waiting for the 24-hour throttle, and release promotion now waits for the native assets, PyPI, and the Homebrew tap before marking a version latest — so clients never resolve a release before its install channel is ready.
+- **Background agent recovery preserves terminal task state.** Recovery re-reads task runtime under the store update lock before marking orphaned agent work recoverable, so a stale snapshot can no longer clobber a task that already completed.
+- **Shell prompt echoes and background todo rows are clearer.** Transcript echoes now show the resolved submitted text for pasted-content placeholders, and background todo rows align continuation icons with the first row.
+- **StrReplaceFile refuses ambiguous single replacements.** A non-`replace_all` edit now errors when `old` matches more than once instead of silently editing the first match — add surrounding context to make it unique, or pass `replace_all=true` when every occurrence should change.
 
-Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.26.0`, or use the native installer for your platform from the [Releases page](https://github.com/TechMatrix-labs/pythinker-code/releases/latest).
+Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.27.0`, or use the native installer for your platform from the [Releases page](https://github.com/TechMatrix-labs/pythinker-code/releases/latest).
 
 
 ---
@@ -148,7 +148,7 @@ matches your OS — no Python, Node, or `uv` prerequisite.
 
 | Platform | Recommended install | Artifact source |
 |---|---|---|
-| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | `PythinkerSetup-0.26.0.exe` from [Releases](https://github.com/TechMatrix-labs/pythinker-code/releases/latest) |
+| **🪟 Windows** | `irm https://pythinker.com/install.ps1 \| iex` | `PythinkerSetup-0.27.0.exe` from [Releases](https://github.com/TechMatrix-labs/pythinker-code/releases/latest) |
 | **<img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> / <img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux">** | `curl -fsSL https://pythinker.com/install.sh \| bash` | native tarball from [Releases](https://github.com/TechMatrix-labs/pythinker-code/releases/latest) |
 | **<img src="https://img.shields.io/badge/-macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"> — Homebrew** | `brew install TechMatrix-labs/pythinker/pythinker-code` | auto-published Homebrew tap |
 | **<img src="https://img.shields.io/badge/-Linux-FCC624?style=flat-square&logo=linux&logoColor=black" alt="Linux"> — system package** | Download the `.deb` or `.rpm` for your distro below | [Releases](https://github.com/TechMatrix-labs/pythinker-code/releases/latest) |
@@ -173,7 +173,7 @@ pythinker                      # start the interactive TUI
 
 ### 🪟 Windows — native installer
 
-`PythinkerSetup-0.26.0.exe` is a signed* Inno Setup wizard. Installs per-user
+`PythinkerSetup-0.27.0.exe` is a signed* Inno Setup wizard. Installs per-user
 into `%LOCALAPPDATA%\Programs\Pythinker`, registers `pythinker` on your user
 PATH (`HKCU\Environment`), broadcasts `WM_SETTINGCHANGE` so new shells see
 the change. **No UAC prompt.**
@@ -184,13 +184,13 @@ irm https://pythinker.com/install.ps1 | iex
 
 # Or manually download the installer + checksum from the Releases page,
 # verify with Get-FileHash, then run:
-.\PythinkerSetup-0.26.0.exe
+.\PythinkerSetup-0.27.0.exe
 
 # Open a fresh PowerShell
 pythinker --version
 ```
 
-**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.26.0.exe /ALLUSERS`
+**Per-machine install** (IT-managed boxes): `.\PythinkerSetup-0.27.0.exe /ALLUSERS`
 installs to `%ProgramFiles%\Pythinker` and writes PATH to HKLM (requires admin).
 
 **Upgrade:** `pythinker update` from inside the running app — it downloads
@@ -241,26 +241,26 @@ attached to every GitHub Release.
 
 ```sh
 # Debian / Ubuntu (x86_64)
-sudo dpkg -i pythinker-code_0.26.0_amd64.deb
+sudo dpkg -i pythinker-code_0.27.0_amd64.deb
 sudo apt-get install -f       # only if dpkg reports missing deps
 
 # Debian / Ubuntu (ARM64)
-sudo dpkg -i pythinker-code_0.26.0_arm64.deb
+sudo dpkg -i pythinker-code_0.27.0_arm64.deb
 
 # Fedora / RHEL / openSUSE (x86_64)
-curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.26.0/pythinker-code-0.26.0.x86_64.rpm
-curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.26.0/pythinker-code-0.26.0.x86_64.rpm.sha256
-sha256sum -c pythinker-code-0.26.0.x86_64.rpm.sha256
+curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.27.0/pythinker-code-0.27.0.x86_64.rpm
+curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.27.0/pythinker-code-0.27.0.x86_64.rpm.sha256
+sha256sum -c pythinker-code-0.27.0.x86_64.rpm.sha256
 # Fedora / RHEL:
-sudo dnf install ./pythinker-code-0.26.0.x86_64.rpm
+sudo dnf install ./pythinker-code-0.27.0.x86_64.rpm
 # openSUSE:
-sudo zypper install ./pythinker-code-0.26.0.x86_64.rpm
+sudo zypper install ./pythinker-code-0.27.0.x86_64.rpm
 
 # Fedora / RHEL (aarch64)
-curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.26.0/pythinker-code-0.26.0.aarch64.rpm
-curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.26.0/pythinker-code-0.26.0.aarch64.rpm.sha256
-sha256sum -c pythinker-code-0.26.0.aarch64.rpm.sha256
-sudo dnf install ./pythinker-code-0.26.0.aarch64.rpm
+curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.27.0/pythinker-code-0.27.0.aarch64.rpm
+curl -LO https://github.com/TechMatrix-labs/pythinker-code/releases/download/v0.27.0/pythinker-code-0.27.0.aarch64.rpm.sha256
+sha256sum -c pythinker-code-0.27.0.aarch64.rpm.sha256
+sudo dnf install ./pythinker-code-0.27.0.aarch64.rpm
 ```
 
 Both packages drop a small `/usr/bin/pythinker` launcher that execs the real
@@ -269,8 +269,8 @@ binary under `/usr/lib/pythinker/`, so your `$PATH` stays tidy.
 **Verify before install:**
 
 ```sh
-sha256sum -c pythinker-code_0.26.0_amd64.deb.sha256        # Debian/Ubuntu
-sha256sum -c pythinker-code-0.26.0.x86_64.rpm.sha256       # Fedora/RHEL
+sha256sum -c pythinker-code_0.27.0_amd64.deb.sha256        # Debian/Ubuntu
+sha256sum -c pythinker-code-0.27.0.x86_64.rpm.sha256       # Fedora/RHEL
 ```
 
 **Upgrade:** download the new `.deb`/`.rpm` from Releases and `dpkg -i` /
@@ -300,7 +300,7 @@ at `~/.local/bin/pythinker`.
 curl -fsSL https://pythinker.com/install.sh | bash
 
 # Pin a specific version
-curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.26.0
+curl -fsSL https://pythinker.com/install.sh | bash -s -- --version 0.27.0
 
 # Custom prefix (defaults to $HOME/.local)
 curl -fsSL https://pythinker.com/install.sh | bash -s -- --prefix /opt/pythinker

{pythinker_code-0.26.0 → pythinker_code-0.27.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pythinker-code"
-version = "0.26.0"
+version = "0.27.0"
 description = "Pythinker Code is your next CLI agent."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -24,7 +24,7 @@ classifiers = [
 dependencies = [
     "agent-client-protocol==0.8.0",
     "aiofiles>=24.0,<26.0",
-    "aiohttp==3.13.4",
+    "aiohttp==3.13.5",
     "typer==0.21.1",
     "pythinker-core[contrib]==1.1.1",
     # notify-py (via batrachian-toad) caps loguru at <=0.6.0 on 3.14+.
@@ -39,7 +39,7 @@ dependencies = [
     "streamingjson==0.0.5",
     "trafilatura==2.0.0",
     # lxml is used by trafilatura/htmldate/justext; keep pinned for binary wheels.
-    "lxml==6.1.0",
+    "lxml==6.1.1",
     "tenacity==9.1.4",
     "fastmcp==3.2.0",
     "pydantic==2.13.4",
@@ -47,7 +47,7 @@ dependencies = [
     "pythinker-host==1.0.0",
     "pythinker-review==0.1.0",
     "batrachian-toad==0.5.23; python_version >= \"3.14\"",
-    "tomlkit==0.14.0",
+    "tomlkit==0.15.0",
     "jinja2==3.1.6",
     "pyobjc-framework-cocoa>=12.1 ; sys_platform == 'darwin'",
     "fastapi>=0.115.0",

{pythinker_code-0.26.0 → pythinker_code-0.27.0}/src/pythinker_code/CHANGELOG.md

@@ -15,6 +15,36 @@ GitHub Releases page; `0.8.0` is the new starting line.
 
 ## Unreleased
 
+## 0.27.0 (2026-05-31)
+
+### What changed in this release
+
+- **`/feedback` submits structured reports with redacted session context.** A new
+  `/feedback [bug|feature|ux|wrong] [message]` command collects recent session context
+  and strips sensitive file contents before sending, shows a confirmation preview, and
+  falls back to opening a prefilled GitHub issue when direct submission is unavailable.
+- **Fresh releases surface in the startup update prompt immediately.** The pre-start
+  update prompt now revalidates a cached "already current" answer with a bounded
+  conditional request instead of waiting for the 24-hour background-check throttle.
+  Release promotion also waits for exact native assets, PyPI, and the Homebrew tap
+  before marking a version latest, so installed clients no longer resolve a release
+  before its install channel is ready.
+- **Background agent recovery preserves terminal task state.** Recovery now re-reads
+  task runtime under the store update lock before marking orphaned agent work
+  recoverable, so a stale snapshot can no longer clobber a task that completed.
+- **Project memory recall keeps the simple lexical path.** The unused SQLite FTS
+  retriever seam and dead recall path argument are removed; collaborators now use
+  a public memory-store root accessor instead of reaching into private methods.
+- **Shell prompt echoes and background todo rows are clearer.** Transcript echoes now
+  show the resolved submitted text for pasted-content placeholders, and background
+  todo rows align continuation icons with the first row.
+- **StrReplaceFile now refuses ambiguous single replacements.** A non-`replace_all` edit now
+  errors when `old` matches more than once instead of silently editing the first match. Add
+  surrounding context to make the old string unique, or pass `replace_all=true` when every
+  occurrence should change.
+
+Upgrade with `pythinker update`, `pip install --upgrade pythinker-code==0.27.0`, or use the native installer for your OS (see the README install table).
+
 ## 0.26.0 (2026-05-30)
 
 ### What changed in this release

{pythinker_code-0.26.0 → pythinker_code-0.27.0}/src/pythinker_code/agents/default/system.md

@@ -77,7 +77,8 @@ These principles govern every engineering response. They override speed: a slow
 - No "flexibility" or "configurability" that wasn't requested.
 - No error handling for impossible scenarios; validate at boundaries only.
 - If a 200-line draft could be 50 lines, rewrite it before showing it.
-- Self-check: *"Would a senior engineer call this overcomplicated?"* If yes, simplify.
+- Over-fragmentation is overcomplication too: don't scatter logic across many tiny files or extra abstraction layers to satisfy a design pattern. Match the codebase's existing granularity.
+- Self-check: *"Would a senior engineer call this overcomplicated or over-engineered?"* If yes, simplify.
 
 **3. Goal-driven execution — define success criteria, then loop until verified.**
 - Transform vague tasks into verifiable goals before writing code:

{pythinker_code-0.26.0 → pythinker_code-0.27.0}/src/pythinker_code/background/manager.py

@@ -7,6 +7,7 @@ import subprocess
 import sys
 import threading
 import time
+from collections.abc import Callable
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, Literal
 
@@ -262,15 +263,19 @@ class BackgroundTaskManager:
             self._store.write_runtime(task_id, runtime)
             raise
 
-        runtime = self._store.read_runtime(task_id)
-        if runtime.finished_at is None and (
-            runtime.status == "created"
-            or (runtime.status == "starting" and runtime.worker_pid is None)
-        ):
+        def mark_worker_started(runtime: TaskRuntime) -> bool:
+            if runtime.finished_at is not None:
+                return False
+            if runtime.status != "created" and not (
+                runtime.status == "starting" and runtime.worker_pid is None
+            ):
+                return False
             runtime.status = "starting"
             runtime.worker_pid = worker_pid
             runtime.updated_at = time.time()
-            self._store.write_runtime(task_id, runtime)
+            return True
+
+        self._store.update_runtime(task_id, mark_worker_started)
         view = self._store.merged_view(task_id)
         self._journal_task_milestone("background task started", view)
         return view
@@ -630,14 +635,17 @@ class BackgroundTaskManager:
         ``TaskRuntime`` — closing the window where a process crash between
         :meth:`finalize_agent_task`'s two writes, or between :meth:`kill` and the
         runner's cancellation handler, left the two records divergent.
+
+        The runtime is re-read under the store's update lock before recovery so a
+        stale ``TaskView`` snapshot cannot overwrite an authoritative terminal
+        status that was written after the snapshot was created.
         """
         agent_id_raw = (view.spec.kind_payload or {}).get("agent_id")
         agent_id = agent_id_raw if isinstance(agent_id_raw, str) else None
-        runtime_status: TaskStatus = view.runtime.status
-        if not is_terminal_status(runtime_status):
-            if view.spec.id in self._live_agent_tasks:
-                return
-            runtime = view.runtime.model_copy()
+
+        def recover_orphan(runtime: TaskRuntime) -> bool:
+            if is_terminal_status(runtime.status) or view.spec.id in self._live_agent_tasks:
+                return False
             runtime.finished_at = now
             runtime.updated_at = now
             runtime.status = "recoverable" if agent_id is not None else "lost"
@@ -647,9 +655,10 @@ class BackgroundTaskManager:
                 if agent_id is not None
                 else "In-process background agent is no longer running"
             )
-            self._store.write_runtime(view.spec.id, runtime)
-            runtime_status = runtime.status
-        self._reconcile_subagent_status(agent_id, runtime_status, live_agent_ids)
+            return True
+
+        runtime = self._store.update_runtime(view.spec.id, recover_orphan)
+        self._reconcile_subagent_status(agent_id, runtime.status, live_agent_ids)
 
     def _reconcile_subagent_status(
         self, agent_id: str | None, runtime_status: TaskStatus, live_agent_ids: set[str]
@@ -810,105 +819,113 @@ class BackgroundTaskManager:
             if subagent_status is not None:
                 self._runtime.subagent_store.update_instance(agent_id, status=subagent_status)
 
-    def _mark_task_running(self, task_id: str) -> None:
-        with self._store._runtime_lock(task_id):  # pyright: ignore[reportPrivateUsage]
-            runtime = self._store.read_runtime(task_id)
+    def _transition_status(
+        self,
+        task_id: str,
+        *,
+        mutate: Callable[[TaskRuntime], None],
+    ) -> TaskRuntime | None:
+        """Locked, terminal-guarded status write via the public store API.
+
+        Stamps ``updated_at`` then applies ``mutate``. Returns the resulting
+        runtime when the transition was applied, or ``None`` when the task was
+        already terminal (no write performed, so callers skip telemetry).
+        """
+        applied = False
+
+        def _apply(runtime: TaskRuntime) -> bool:
+            nonlocal applied
             if is_terminal_status(runtime.status):
-                return
-            runtime.status = "running"
+                return False
             runtime.updated_at = time.time()
+            mutate(runtime)
+            applied = True
+            return True
+
+        runtime = self._store.update_runtime(task_id, _apply)
+        return runtime if applied else None
+
+    def _mark_task_running(self, task_id: str) -> None:
+        def mutate(runtime: TaskRuntime) -> None:
+            runtime.status = "running"
             runtime.heartbeat_at = runtime.updated_at
             runtime.failure_reason = None
-            self._store._write_runtime_unlocked(task_id, runtime)  # pyright: ignore[reportPrivateUsage]
+
+        self._transition_status(task_id, mutate=mutate)
 
     def _mark_task_awaiting_approval(self, task_id: str, reason: str) -> None:
-        with self._store._runtime_lock(task_id):  # pyright: ignore[reportPrivateUsage]
-            runtime = self._store.read_runtime(task_id)
-            if is_terminal_status(runtime.status):
-                return
+        def mutate(runtime: TaskRuntime) -> None:
             runtime.status = "awaiting_approval"
-            runtime.updated_at = time.time()
             runtime.failure_reason = reason
-            self._store._write_runtime_unlocked(task_id, runtime)  # pyright: ignore[reportPrivateUsage]
+
+        self._transition_status(task_id, mutate=mutate)
 
     def _mark_task_completed(self, task_id: str) -> None:
-        with self._store._runtime_lock(task_id):  # pyright: ignore[reportPrivateUsage]
-            runtime = self._store.read_runtime(task_id)
-            if is_terminal_status(runtime.status):
-                return
+        def mutate(runtime: TaskRuntime) -> None:
             runtime.status = "completed"
-            runtime.updated_at = time.time()
             runtime.finished_at = runtime.updated_at
             runtime.failure_reason = None
-            self._store._write_runtime_unlocked(task_id, runtime)  # pyright: ignore[reportPrivateUsage]
-        from pythinker_code.telemetry import track
 
-        if runtime.started_at and runtime.finished_at:
-            duration = runtime.finished_at - runtime.started_at
-            track("background_task_completed", success=True, duration_s=duration)
+        runtime = self._transition_status(task_id, mutate=mutate)
+        if runtime is not None and runtime.started_at and runtime.finished_at:
+            from pythinker_code.telemetry import track
+
+            track(
+                "background_task_completed",
+                success=True,
+                duration_s=runtime.finished_at - runtime.started_at,
+            )
 
     def _mark_task_failed(self, task_id: str, reason: str) -> None:
-        with self._store._runtime_lock(task_id):  # pyright: ignore[reportPrivateUsage]
-            runtime = self._store.read_runtime(task_id)
-            if is_terminal_status(runtime.status):
-                return
+        def mutate(runtime: TaskRuntime) -> None:
             runtime.status = "failed"
-            runtime.updated_at = time.time()
             runtime.finished_at = runtime.updated_at
             runtime.failure_reason = reason
-            self._store._write_runtime_unlocked(task_id, runtime)  # pyright: ignore[reportPrivateUsage]
-        from pythinker_code.telemetry import track
 
-        if runtime.started_at and runtime.finished_at:
-            duration = runtime.finished_at - runtime.started_at
+        runtime = self._transition_status(task_id, mutate=mutate)
+        if runtime is not None and runtime.started_at and runtime.finished_at:
+            from pythinker_code.telemetry import track
+
             track(
                 "background_task_completed",
                 success=False,
-                duration_s=duration,
+                duration_s=runtime.finished_at - runtime.started_at,
                 reason="error",
             )
 
     def _mark_task_timed_out(self, task_id: str, reason: str) -> None:
-        with self._store._runtime_lock(task_id):  # pyright: ignore[reportPrivateUsage]
-            runtime = self._store.read_runtime(task_id)
-            if is_terminal_status(runtime.status):
-                return
+        def mutate(runtime: TaskRuntime) -> None:
             runtime.status = "failed"
-            runtime.updated_at = time.time()
             runtime.finished_at = runtime.updated_at
             runtime.interrupted = True
             runtime.timed_out = True
             runtime.failure_reason = reason
-            self._store._write_runtime_unlocked(task_id, runtime)  # pyright: ignore[reportPrivateUsage]
-        from pythinker_code.telemetry import track
 
-        if runtime.started_at and runtime.finished_at:
-            duration = runtime.finished_at - runtime.started_at
+        runtime = self._transition_status(task_id, mutate=mutate)
+        if runtime is not None and runtime.started_at and runtime.finished_at:
+            from pythinker_code.telemetry import track
+
             track(
                 "background_task_completed",
                 success=False,
-                duration_s=duration,
+                duration_s=runtime.finished_at - runtime.started_at,
                 reason="timeout",
             )
 
     def _mark_task_killed(self, task_id: str, reason: str) -> None:
-        with self._store._runtime_lock(task_id):  # pyright: ignore[reportPrivateUsage]
-            runtime = self._store.read_runtime(task_id)
-            if is_terminal_status(runtime.status):
-                return
+        def mutate(runtime: TaskRuntime) -> None:
             runtime.status = "killed"
-            runtime.updated_at = time.time()
             runtime.finished_at = runtime.updated_at
             runtime.interrupted = True
             runtime.failure_reason = reason
-            self._store._write_runtime_unlocked(task_id, runtime)  # pyright: ignore[reportPrivateUsage]
-        from pythinker_code.telemetry import track
 
-        if runtime.started_at and runtime.finished_at:
-            duration = runtime.finished_at - runtime.started_at
+        runtime = self._transition_status(task_id, mutate=mutate)
+        if runtime is not None and runtime.started_at and runtime.finished_at:
+            from pythinker_code.telemetry import track
+
             track(
                 "background_task_completed",
                 success=False,
-                duration_s=duration,
+                duration_s=runtime.finished_at - runtime.started_at,
                 reason="killed",
             )

{pythinker_code-0.26.0 → pythinker_code-0.27.0}/src/pythinker_code/background/store.py

@@ -6,6 +6,7 @@ import os
 import re
 import shutil
 import time
+from collections.abc import Callable
 from contextlib import contextmanager
 from pathlib import Path
 
@@ -139,6 +140,18 @@ class BackgroundTaskStore:
         with self._runtime_lock(task_id):
             self._write_runtime_unlocked(task_id, runtime)
 
+    def update_runtime(self, task_id: str, update: Callable[[TaskRuntime], bool]) -> TaskRuntime:
+        """Apply a read-modify-write update under the runtime lock.
+
+        ``update`` mutates the current runtime and returns true when it should
+        be written back. The current runtime is returned either way.
+        """
+        with self._runtime_lock(task_id):
+            runtime = self.read_runtime(task_id)
+            if update(runtime):
+                self._write_runtime_unlocked(task_id, runtime)
+            return runtime
+
     def _write_runtime_unlocked(self, task_id: str, runtime: TaskRuntime) -> None:
         """Write runtime without acquiring the per-task lock (caller holds it)."""
         path = self.runtime_path(task_id)