slhx agent
9dd8e4a944
Add a northstar and ready vertical slices for making html_examples start at an index, splitting implemented examples into focused pages, proving infinite-scroll by scrolling, and keeping smoke/docs/requirements aligned.
56 lines
2.5 KiB
Markdown
56 lines
2.5 KiB
Markdown
---
|
|
id: SLICE-0016
|
|
type: slice
|
|
status: ready
|
|
parent: NS-0004
|
|
title: Update html_examples smoke and README for index/page navigation
|
|
refs:
|
|
- 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.
|