docs: update master development brief — Stage 3B complete, Stage 3 done
Publish Docs / publish-docs (push) Successful in 1m10s Details

Mark Stage 3B (list efficiency improvements) as complete with 294 tests passing. Update baseline commit reference, test count, and next recommended branch to Stage 4A (Android app shell).
This commit is contained in:
Mike Kell 2026-05-22 08:53:10 -04:00
parent 738336d953
commit eaf3e70d30
1 changed files with 8 additions and 19 deletions

View File

@ -82,6 +82,7 @@ Rules:
- ✅ Post-write consistency hardening landed (Stage 2A complete — merged `feat/post-write-consistency``main` at `7acff83`, 2026-04-11). - ✅ Post-write consistency hardening landed (Stage 2A complete — merged `feat/post-write-consistency``main` at `7acff83`, 2026-04-11).
- ✅ Publishing workflow UX hardening landed (Stage 2B complete — merged `feat/publishing-ux-hardening``main` at `b81016d`, 2026-04-11). Stage 2 complete. - ✅ Publishing workflow UX hardening landed (Stage 2B complete — merged `feat/publishing-ux-hardening``main` at `b81016d`, 2026-04-11). Stage 2 complete.
- ✅ Multi-select groundwork landed (Stage 3A complete — merged `feat/multi-select-groundwork``main`, 2026-05-22). - ✅ Multi-select groundwork landed (Stage 3A complete — merged `feat/multi-select-groundwork``main`, 2026-05-22).
- ✅ List efficiency improvements landed (Stage 3B complete — merged `feat/list-efficiency-improvements``main`, 2026-05-22). Stage 3 complete.
### Current narrow edit capabilities on `main` ### Current narrow edit capabilities on `main`
@ -96,14 +97,14 @@ Rules:
- `dart analyze` clean - `dart analyze` clean
- `feature_wordpress` tests passing - `feature_wordpress` tests passing
- `kell_web` dashboard tests passing - `kell_web` dashboard tests passing
- latest reported count for `feature_wordpress`: `262/262 passed` - latest reported count for `feature_wordpress`: `294/294 passed`
- latest reported count for `kell_web` dashboard tests: `5/5 passed` - latest reported count for `kell_web` dashboard tests: `5/5 passed`
- baseline commit: merge of `feat/multi-select-groundwork` (2026-05-22) - baseline commit: merge of `feat/list-efficiency-improvements` (2026-05-22)
### Next recommended branch ### Next recommended branch
**`feat/list-efficiency-improvements`** — Stage 3B: List efficiency improvements. **`feat/android-app-shell`** — Stage 4A: Android app shell and bootstrap.
Branch from latest `main`. Stage 3A (multi-select groundwork) is complete. Branch from latest `main`. Stage 3 (web application operator efficiency) is complete.
--- ---
@ -190,22 +191,10 @@ Increase throughput for product triage and management using existing data.
> Merged `feat/multi-select-groundwork``main` (2026-05-22). > Merged `feat/multi-select-groundwork``main` (2026-05-22).
> Added multi-selection state to `ProductPublishingController` (`toggleMultiSelect`, `clearMultiSelection`, `selectAllVisible`, `isMultiSelected`, `multiSelectedIds`, `multiSelectedCount`). Updated `ProductDraftCard` with optional leading checkbox for multi-select mode. Added `_MultiSelectBar` to `ProductPublishingPage` with selected-count display, Select All, and Clear actions. Single-item preview selection preserved independently. 15 new multi-select tests added (262 total `feature_wordpress` tests passing). No bulk writes introduced. > Added multi-selection state to `ProductPublishingController` (`toggleMultiSelect`, `clearMultiSelection`, `selectAllVisible`, `isMultiSelected`, `multiSelectedIds`, `multiSelectedCount`). Updated `ProductDraftCard` with optional leading checkbox for multi-select mode. Added `_MultiSelectBar` to `ProductPublishingPage` with selected-count display, Select All, and Clear actions. Single-item preview selection preserved independently. 15 new multi-select tests added (262 total `feature_wordpress` tests passing). No bulk writes introduced.
#### Stage 3B — List efficiency improvements #### ~~Stage 3B — List efficiency improvements~~ ✅ COMPLETE
##### Goal > Merged `feat/list-efficiency-improvements``main` (2026-05-22).
> Added compact/standard view toggle (`ListDensity` enum), staleness detection (`isStale()`, `staleCount()` with 30-day threshold), keyboard navigation (`selectNextDraft`/`selectPreviousDraft` with wrapping), description snippet in standard card, and stale indicator icon. Updated `ProductDraftCard` with compact two-row layout variant and `Flexible` overflow handling. Page wires up `Focus`+`onKeyEvent` for arrow keys and density toggle button. 32 new tests added (294 total `feature_wordpress` tests passing). Stage 3 complete.
Further improve operator productivity.
##### Candidate scope
- denser list/card presentation if justified
- quick visual indicators for stale products
- lightweight secondary metadata visibility
- improved keyboard/focus handling on web if easy to support
##### Definition of done
- measurable usability improvement using existing data only
--- ---