From 73b4a49939cc980feb1bc915b0af019517050ec1 Mon Sep 17 00:00:00 2001
From: Mike Kell <mtkell@kellengineering.com>
Date: Sat, 11 Apr 2026 16:18:00 -0400
Subject: [PATCH] docs: update briefs for merged feat/post-write-consistency
 (Stage 2A)

- Mark Stage 2A complete in master brief and build tracker

- Refresh main baseline to 7acff83

- Next slice: feat/publishing-ux-hardening (Stage 2B)
---
 docs/development/build_execution_tracker.md  | 18 ++++++++---
 docs/development/master_development_brief.md | 34 ++++----------------
 2 files changed, 21 insertions(+), 31 deletions(-)

diff --git a/docs/development/build_execution_tracker.md b/docs/development/build_execution_tracker.md
index 871763e..863573d 100644
--- a/docs/development/build_execution_tracker.md
+++ b/docs/development/build_execution_tracker.md
@@ -2,9 +2,9 @@
 
 ## Current status
 
-- main baseline updated through: category-only-edit
-- main baseline commit: `8e7e4cb` (2026-04-11)
-- next branch: feat/post-write-consistency
+- main baseline updated through: post-write-consistency
+- main baseline commit: `7acff83` (2026-04-11)
+- next branch: feat/publishing-ux-hardening
 - current stage: Stage 2 — Web application operational hardening
 
 ## Slice tracker
@@ -31,7 +31,8 @@
 
 ### feat/post-write-consistency
 
-- status: implemented — ready for review / merge
+- status: merged to main
+- commit: `7acff83`
 - inspection: complete
 - implementation: complete
 - files changed:
@@ -40,3 +41,12 @@
 - tests: passed (234/234 feature_wordpress)
 - analyze: passed (dart analyze — no issues found)
 - brief updated: yes
+
+### feat/publishing-ux-hardening
+
+- status: queued (Stage 2B — next)
+- inspection: pending
+- implementation: pending
+- tests: pending
+- analyze: pending
+- brief updated: no
diff --git a/docs/development/master_development_brief.md b/docs/development/master_development_brief.md
index 6495b9b..636703d 100644
--- a/docs/development/master_development_brief.md
+++ b/docs/development/master_development_brief.md
@@ -79,6 +79,7 @@ Rules:
 - Name-only product edit landed.
 - ✅ Description-only product edit landed (Stage 1A complete — merged `feat/description-only-edit` → `main` at `cebac4c`, 2026-04-11).
 - ✅ Category-only product edit landed (Stage 1B complete — merged `feat/category-only-edit` → `main` at `8e7e4cb`, 2026-04-11). Stage 1 complete.
+- ✅ Post-write consistency hardening landed (Stage 2A complete — merged `feat/post-write-consistency` → `main` at `7acff83`, 2026-04-11).
 
 ### Current narrow edit capabilities on `main`
 
@@ -93,21 +94,14 @@ Rules:
 - `dart analyze` clean
 - `feature_wordpress` tests passing
 - `kell_web` dashboard tests passing
-- latest reported count for `feature_wordpress`: `223/223 passed`
+- latest reported count for `feature_wordpress`: `234/234 passed`
 - latest reported count for `kell_web` dashboard tests: `5/5 passed`
-- baseline commit: `8e7e4cb` (2026-04-11)
-
-### Post-write consistency (Stage 2A) — on branch `feat/post-write-consistency`
-
-- `dart analyze` clean
-- `feature_wordpress` tests: `234/234 passed`
-- controller `_refreshSelection()` preserves/refreshes selection after all writes
-- 11 new post-write consistency tests added
+- baseline commit: `7acff83` (2026-04-11)
 
 ### Next recommended branch
 
 **`feat/publishing-ux-hardening`** — Stage 2B: Publishing workflow UX hardening.
-Branch from `main` after merging `feat/post-write-consistency`. Stage 2A is complete on branch.
+Branch from `main` at `7acff83`. Stage 2A (post-write consistency) is complete.
 
 ---
 
@@ -166,24 +160,10 @@ Improve operator consistency, predictability, and usability after writes.
 - `feat/post-write-consistency`
 - `feat/publishing-ux-hardening`
 
-#### Stage 2A — Post-write consistency hardening
+#### ~~Stage 2A — Post-write consistency hardening~~ ✅ COMPLETE
 
-##### Goal
-
-Make list/detail behavior predictable after edits and status changes.
-
-##### Requirements
-
-- preserve selection after update where sensible
-- maintain search/filter/sort persistence after writes
-- handle item repositioning under active sort cleanly
-- ensure latest values refresh correctly
-- verify last-modified updates behave consistently
-
-##### Definition of done
-
-- post-action behavior feels stable and predictable
-- focused tests cover persistence and repositioning
+> Merged `feat/post-write-consistency` → `main` at `7acff83` (2026-04-11).
+> Added `_refreshSelection()` to `ProductPublishingController` to preserve/refresh selection after all write-triggered reloads. 11 new post-write consistency tests added (234 total `feature_wordpress` tests passing).
 
 #### Stage 2B — Publishing workflow UX hardening