hemx/work/slices/SLICE-0016-html-examples-smoke-and-readme.md

id, type, status, parent, title, refs

id	type	status	parent	title	refs
SLICE-0016	slice	ready	NS-0004	Update html_examples smoke and README for index/page navigation	AGENTS.md REQUIREMENTS.md examples/html_examples/README.md examples/html_examples/src/main.rs hemx-xtask/src/main.rs

Objective

Keep the public documentation and focused browser smoke aligned with the new html_examples structure so contributors can trust / as an index, focused pages as copyable examples, and infinite-scroll as a scroll-triggered interaction.

Authority

• AGENTS.md identifies cargo run -p hemx-xtask -- html-examples-smoke as the focused repo-owned browser verification for the HTML pattern gallery and no-reload dynamic interactions. req: test/006 req: test/013 req: test/014
• examples/html_examples/README.md is the public run command and pattern matrix.
• hemx-xtask/src/main.rs owns smoke scripts, diagnostics, and no-navigation/no-reload guards.

Close when

• examples/html_examples/README.md still explains the run command and pattern matrix, but its proof anchors and navigation notes match the new index/per-page structure.
• cargo run -p hemx-xtask -- html-examples-smoke starts from the index, follows real example links/routes, and proves representative no-reload dynamic behavior on focused pages.
• The smoke includes a scroll-based infinite-scroll proof and keeps the existing no-navigation/no-reload guard for dynamic interactions.
• Smoke failures identify the named example route/path so a broken page split is easy to diagnose.

Allowed files

• examples/html_examples/README.md
• hemx-xtask/src/main.rs
• examples/html_examples/src/main.rs only for testability hooks or route names already owned by implementation slices
• REQUIREMENTS.md only if smoke/documentation duties become durable requirements
• AGENTS.md only if the stable command guidance must change; otherwise do not touch it

Verification

• cargo test -p hemx-xtask
• cargo run -p hemx-xtask -- html-examples-smoke
• cargo test -p hemx-html-examples if route names/templates changed in the same slice
• redgate health --strict && redgate lint if REQUIREMENTS.md or AGENTS.md changes

Non-goals

• Do not add a second smoke runner, Playwright/Selenium dependency, /tmp smoke scripts, or untracked proof files.
• Do not use smoke updates to implement new examples.
• Do not weaken existing dynamic checks for click-to-edit, edit-row, validation, search, lazy-load, click-to-load, progress, value-select, reset, or revealed fallback.

Evidence

Ready; no implementation evidence yet.