From c22bf44a46d7b90c6b77053b865439cfca55839f Mon Sep 17 00:00:00 2001
From: cat <git@chen.rs>
Date: Mon, 27 Jul 2026 09:44:43 +0800
Subject: [PATCH] =?UTF-8?q?docs(release):=20=E8=AE=B0=E5=BD=95=20v0.5.1=20?=
 =?UTF-8?q?=E5=8F=91=E5=B8=83=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a197c533..80804926 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -38,6 +38,40 @@ and uses semver-style versions once tags are published.
 - _Template: intentionally accepted limitations, unstable schemas, incomplete
   integrations, or non-blocking risks relevant to this release._
 
+## [0.5.1] - 2026-07-27
+
+### Fixed
+
+- Mainline hook context injection is now bounded. The shared hook renderer
+  compacts status and proposal JSON semantically and enforces final byte
+  budgets (32 KiB for session-start context, 16 KiB for turn-start context);
+  oversized context is replaced with a compact warning that points to the
+  `mainline` commands carrying the full detail instead of flooding the agent
+  session.
+- The generated Pi extension now caps hook stdout at 256 KiB and combined
+  injected context at 48 KiB, so a pathological repository state can no longer
+  blow up Pi session memory or context windows through the Mainline hook.
+- Abandoning a shared proposal no longer fails with `NO_ACTIVE_INTENT` when the
+  local draft is missing: `mainline abandon` falls back to the shared intent
+  view so sealed/proposed intents can reach the abandoned terminal state after
+  worktree cleanup.
+- Syncing after a notes migration no longer resurrects backfill notes on
+  rewritten pre-migration commits: pinning a merged intent with recorded
+  mainline evidence now follows the merged-evidence path instead of replaying
+  stale `BackfillCommits` from the immutable seal event.
+
+### Migration Notes
+
+- No action required. Repositories with Pi hooks installed pick up the bounded
+  extension after `mainline hooks install --agent pi` (or a fresh
+  `mainline init`); the previously generated extension keeps working but
+  without the new stdout/context caps.
+
+### Known Alpha Limits
+
+- Hook context budgets are fixed constants in this release; they are not yet
+  configurable per repository.
+
 ## [0.5.0] - 2026-07-03
 
 ### Added