docs(e2e_checklist + README): post-D-26 rewrite (#18) #24

Merged

mik-tf merged 1 commit from development_mik into development

2026-05-23 17:34:34 +00:00

mik-tf commented

2026-05-23 17:34:18 +00:00

Owner

Closes lhumina_code/hero_assistance#18 rows 6, 7, 8.

First post-D-26 rewrite of docs/dev/e2e_checklist.md body + README.md dead-link cleanup. Sections A-D-E row bodies re-cited against the Askama + Unpoly + SSE surface; Sections G + H + I + M removed entirely (row IDs preserved in a new Retired sections appendix per process invariant 4); Section F shrunk from 20 to 6 rows (server-side multipart upload + GET + handler-level claim/cleanup); Section K rows touching phase13_demo.sh / 4-port browser scheme / e2e_journey shell rewritten against lab service hero_assistance --install --start + the router-fronted /hero_assistance/app/ and /hero_assistance/admin/ URLs. K-18 (L-06 events-over-TCP) flipped from skip to fully green - L-06 was closed at s34. Section L 91-row summary updated to note historic Playwright + e2e_journey evidence refs are now [skip: D-26-RETIRED]; integration-test names (phase*_*) in the same row bodies still resolve. New [skip: D-26-RETIRED] REASON registered in the row-state schema.

Pre-merge gate clean: cargo fmt + cargo clippy --release --workspace --all-targets -- -D warnings + cargo build --workspace --release. cargo test posture 255 pass / 2 fail / 14 ignored - byte-stable vs s2-026 baseline (both fails are documented pre-existing flakes).

No D-NN / L-NN minted. After this lands, only row 9 (final live walkthrough + closure + v1.0 tag) remains on #18 - queued for next session.

Doc shape post-rewrite: ~698 to 687 lines net; row inventory drops from 315 to 247 live rows with 79 retired IDs catalogued in the appendix.

Closes lhumina_code/hero_assistance#18 rows 6, 7, 8. First post-D-26 rewrite of `docs/dev/e2e_checklist.md` body + `README.md` dead-link cleanup. Sections A-D-E row bodies re-cited against the Askama + Unpoly + SSE surface; Sections G + H + I + M removed entirely (row IDs preserved in a new Retired sections appendix per process invariant 4); Section F shrunk from 20 to 6 rows (server-side multipart upload + GET + handler-level claim/cleanup); Section K rows touching `phase13_demo.sh` / 4-port browser scheme / e2e_journey shell rewritten against `lab service hero_assistance --install --start` + the router-fronted `/hero_assistance/app/` and `/hero_assistance/admin/` URLs. K-18 (L-06 events-over-TCP) flipped from skip to fully green - L-06 was closed at s34. Section L 91-row summary updated to note historic Playwright + e2e_journey evidence refs are now [skip: D-26-RETIRED]; integration-test names (`phase*_*`) in the same row bodies still resolve. New `[skip: D-26-RETIRED]` REASON registered in the row-state schema. Pre-merge gate clean: cargo fmt + cargo clippy --release --workspace --all-targets -- -D warnings + cargo build --workspace --release. cargo test posture 255 pass / 2 fail / 14 ignored - byte-stable vs s2-026 baseline (both fails are documented pre-existing flakes). No D-NN / L-NN minted. After this lands, only row 9 (final live walkthrough + closure + v1.0 tag) remains on #18 - queued for next session. Doc shape post-rewrite: ~698 to 687 lines net; row inventory drops from 315 to 247 live rows with 79 retired IDs catalogued in the appendix.

mik-tf added 1 commit

2026-05-23 17:34:19 +00:00

docs(e2e_checklist + README): post-D-26 rewrite (#18 ) b554c7b641

Closes lhumina_code/hero_assistance#18 rows 6, 7, 8 — the post-D-26 doc
rewrite that the s2-022 customer-readiness gate filed as v1.0 blockers.

Sections A through D row bodies rewritten to swap Dioxus citations
(enrollment.rs, _ui_wasm/*, tickets/list.rs, tickets/detail.rs,
composer.rs, identity_storage.rs, SPA Playwright specs, spa-*.png
baselines) for the post-D-26 equivalents (crates/hero_assistance_ui
templates + routes.rs). SPA-only behaviours with no post-D-26 analogue
(/enroll two-step modal, browser localStorage identity, F5 reload
restoration, optimistic insert + WebSocket reconciliation, per-tab
presence sidebar, inline image-attachment rendering, clipboard-paste,
drag-and-drop, the _app desktop chrome) flip their UI cells to a new
[skip: D-26-RETIRED] REASON registered in the row-state schema. Wire-
level rows (handler tests in integration.rs phase*_*) stay green
throughout — the OpenRPC surface is byte-stable through D-26 (390
method definitions present today in openrpc.json; spot-checked 7 by
name).

Section E (support-agent files response) given the same treatment —
wire stays green, agent-action UI cells go [skip: D-26-RETIRED] since
_admin is read-only inspection in v1.0-rc.

Section F shrunk from 20 to 6 rows — only server-side multipart upload
+ GET + handler-level claim/cleanup paths survive. The 14 interactive-
UX rows are catalogued in a new Retired sections appendix.

Sections G (multi-project subscription, 20 rows), H (_app desktop
chrome, 15 rows), I (_app config persistence, 10 rows), M (visual
baselines, 20 rows) removed entirely. The original row tables are
preserved inside HTML comment blocks at their original positions for
git-history traceability. Row IDs catalogued in the new Retired
sections appendix at the end of the document, reserved against
re-use per process invariant 4 on append-only IDs.

Section K rows touching phase13_demo.sh, the 4-port browser scheme,
and the e2e_journey shell are rewritten against lab service
hero_assistance --install --start + the router-fronted URLs
(/hero_assistance/app/ for customer, /hero_assistance/admin/ for
operator). K-18 (L-06 events-over-TCP) flipped from skip to fully
green — L-06 was closed at s34.

Section L (91-row programmable surface) summary updated to note that
historic evidence references to tests/playwright/* and
tests/e2e_journey.sh:Phase<N> are now [skip: D-26-RETIRED] for live
verification (those test layers are gone); integration-test names in
the same row bodies (phase*_*) still resolve. Row-by-row evidence-cell
rewrite is post-v1 work.

Top-matter: Test architecture pyramid collapses L4-L7 to deferred;
How to access replaces the 4-port browser scheme with router-fronted
URLs; How to run drops phase13_demo.sh + make dist + dx build + node
tests/perceptual_diff.mjs and surfaces lab service + cargo test.
Milestone scope refreshed against v1.0-rc; M2 marked closed-by-
retirement; M3 in flight at 5/9 acceptance rows.

README dead-link cleanup: 7 lines previously linking to in-repo
decisions/D-*.md and limitations/L-*.md (both directories scrubbed in
s2-021) converted to plain-text decision/limitation name references.
Survival path for the D-NN content documented inline. e2e_checklist
inline dead-link cleanup: 3 live (../../decisions/D-NN-*.md) refs
converted to plain-text.

Pre-merge gate: cargo fmt + cargo clippy --release --workspace
--all-targets -- -D warnings + cargo build --workspace --release all
clean. cargo test --release --workspace --no-fail-fast posture
255 pass / 2 fail / 14 ignored — byte-stable vs s2-026 baseline (both
fails are documented pre-existing flakes:
phase24b_ui_add_access_fails_when_hero_proc_unreachable host-env
flake + phase10_multi_project_merged_stream_tags_by_project_id
transient StreamMap yield-order race).

No D-NN / L-NN minted. Workspace D-NN next-free unchanged at D-28.
After this lands, only row 9 (final live walkthrough + closure +
v1.0 tag) remains on #18 — queued for s2-028.

Signed-by: mik-tf <mik-tf@noreply.invalid>