Runbook: lead the TouchHub setup with the zero-config flow #179

Member

Task fc69c940-e993-4449-8dd8-b0c748dab7d0 (feature 20 — Zero-Config Panel Dashboard).

Rewrites the README TouchHub runbook so the primary flow is the zero-config one: install the integration, add the config entry (no fields), set the NestQuest API base URL and panel service token in the options flow, and the panel dashboard registered on setup (url_path /nestquest, strategy custom:nestquest-party) simply appears — no YAML, no manual views, no child_order/quest_log_path/board_path. The hand-built two-view instructions move under a manual alternative (strategy-first, then the two hand-built views), and a new constraints subsection keeps TouchHub Auto-Return greater than idle_return_seconds (default 40s) and the Panel-layout requirement documented, stating the zero-config path satisfies Panel automatically while the manual path must set it.

Checks: TZ=UTC uv run pytest -q -> 1709 passed (baseline 1709); tests/test_panel_cards.py -> 30 passed including the no-admin-controls guard; all README-asserting tests pass. Head: 1ff41c02bd.

Task fc69c940-e993-4449-8dd8-b0c748dab7d0 (feature 20 — Zero-Config Panel Dashboard). Rewrites the README TouchHub runbook so the primary flow is the zero-config one: install the integration, add the config entry (no fields), set the NestQuest API base URL and panel service token in the options flow, and the panel dashboard registered on setup (url_path /nestquest, strategy custom:nestquest-party) simply appears — no YAML, no manual views, no child_order/quest_log_path/board_path. The hand-built two-view instructions move under a manual alternative (strategy-first, then the two hand-built views), and a new constraints subsection keeps TouchHub Auto-Return greater than idle_return_seconds (default 40s) and the Panel-layout requirement documented, stating the zero-config path satisfies Panel automatically while the manual path must set it. Checks: TZ=UTC uv run pytest -q -> 1709 passed (baseline 1709); tests/test_panel_cards.py -> 30 passed including the no-admin-controls guard; all README-asserting tests pass. Head: 1ff41c02bd3fc9e03101348d6b27ce64e56a713a.
dev_agent added 1 commit 2026-09-23 11:40:00 -04:00
The integration now registers its panel dashboard itself on setup
(storage-mode dashboard at /nestquest running the custom:nestquest-party
strategy), so the runbook's primary path no longer asks users to build
views: install, add the config entry, set the API base URL and panel
service token in the options flow, and the dashboard simply appears with
Panel-layout views generated from the roster. The hand-built two-view
instructions move under a manual alternative, and the two constraints
(Panel layout — Masonry squeezes the 1080px card into a column — and
TouchHub Auto-Return greater than idle_return_seconds, default 40s) get
their own subsection stating which path gets each for free.
review_agent left a comment
Member

Independent Claude Sonnet 5 review completed for this exact commit.

Independent Claude Sonnet 5 review completed for this exact commit.
dev_agent merged commit 0354db82ce into feature/3e640c07-2132-46e2-a363-be72ee091291-zero-config-panel-dashboard 2026-09-23 11:49:23 -04:00
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Maniacs_Mansion/NestQuest#179