Promote Feature 12 to main #135

2026-09-21T06:49:00-04:00

orchestrator-agent commented

2026-09-21 06:49:00 -04:00

Promotion PR: dev → main.

Feature 12 (kid panel Lovelace cards) merged to dev via PR #134.

Includes:

Party board card (1a) and quest log card (1b)
Complete confirm (1j) with optimistic seal
Quest complete screen (1c)
Live event subscriptions
Empty/error states
1920x1080 layout verification
Panel card tests + no-admin-controls guard
TouchHub setup runbook
weather_entity on quest log

All PRs Codex-reviewed. pytest 1496 passed.

Promotion PR: dev → main. Feature 12 (kid panel Lovelace cards) merged to dev via PR #134. Includes: - Party board card (1a) and quest log card (1b) - Complete confirm (1j) with optimistic seal - Quest complete screen (1c) - Live event subscriptions - Empty/error states - 1920x1080 layout verification - Panel card tests + no-admin-controls guard - TouchHub setup runbook - weather_entity on quest log All PRs Codex-reviewed. pytest 1496 passed.

orchestrator-agent added 72 commits 2026-09-21 06:49:01 -04:00

Register canonical NestQuest HA services with schemas 2d30f0ce77

Domain-global handlers for the ENTITIES-AND-SERVICES inventory plus
regenerate. No permission decorator yet.

Regenerate child instances after presence service writes b1c42f10d0

Presence pattern and override handlers now call regenerate_for_child.
Definition edit/activate pass HA-local today and configured horizon.

Register canonical NestQuest HA services with schemas a2e9bdffee

Register canonical NestQuest HA services with schemas (#98)

Add admin-only versus open service policy registry 4281b9d01c

One mapping in service_policy.py: complete_quest is open, every other
registered nestquest service is admin_only.

Add admin-only versus open service policy registry dd7ea10936

Gate every NestQuest service behind the admin permission check 37d7b7e6c3

permission_gate wraps all registered services at registration time:
admin-only policy reads call.context.user_id against admin_allowlist
is_admin (fail closed on no context); complete_quest stays open.

Gate every NestQuest service behind the admin permission check 2a0e568940

Cover fail-closed no-context behavior across admin-only services d0f49b44b5

Parametrised test denies no-context calls on every admin-only service;
complete_quest proceeds with no user; scheduled internals stay direct
function calls.

Cover fail-closed no-context behavior across admin-only services eb4de7b565

Test the permission gate's audit logging b5058a3bed

Warning on denial and debug on success carry the service, the caller
user id (or none), and a UTC stamp; nothing beyond the user id leaks.

Test the permission gate audit logging cf67e9bed9

Add the permission test matrix across every registered service c1efd39ce3

Admin succeeds on all ten admin-only services; a non-admin and a
no-context call are refused on each; complete_quest stays open; a
kiosk-style id is refused on uncomplete_quest and regenerate; the
registry coverage assertion fails the suite on any gap.

Add the permission test matrix across every registered service fc81b4b813

Feature 09: Permission Enforcement Layer 3ac1d32e1b

Add the shared NestQuest data update coordinator 979eafc5a2

One refresh pass builds the whole entity snapshot: active children,
today's instances with derived open/done/missed states, per-child
presence via the PresenceEngine (records converted to model objects),
rollup counts, and the custody cycle day. Interval configurable via
the new update_interval option, default five minutes.

Shut the coordinator down when first refresh fails setup 5c99987e7f

The setup except path closes the database; the coordinator created
above it now shuts down first so no listener can fire against the
closed connection. Regression test included.

Add the shared NestQuest data update coordinator 322038998b

Add per-child daily count and percentage sensors 00409a76db

Four sensors per active child read the coordinator snapshot: quests
due today (carrying the panel payload that omits missed instances plus
the admin payload that includes them, D-009), completed, remaining, and
completion percentage (100 on a zero-quest day). Platform forwarding
wired through the harness's entity registry stand-ins.

Honor failed platform unload; derive labels from the snapshot 7a0c8d1885

A False platform unload now returns False and retains the runtime
record so live entities keep their database. Sensor names and device
labels re-derive from the current snapshot so child renames
propagate; unique_ids stay child-id based.

Add per-child daily count and percentage sensors 813055a24c

Add the per-child next-quest sensor 1f7a7ba46c

State carries the earliest open quest's title truncated under the
255-character limit with the full shape in attributes; the documented
"none" sentinel is reported when the day is clear.

Add the per-child next-quest sensor 236e8f4adf

Add per-child all-done and present-today binary sensors df4c9eb21a

all_done is on exactly when the child owed quests today and owes none
remaining (a zero-quest day stays off so celebrations never fire on
an empty day); present_today mirrors the presence engine's answer
for the HA-local date.

Add per-child all-done and present-today binary sensors 99a8a133e2

Add household rollup and cycle-day sensors 5bca24910a

Household quests due/completed today sum the active children's
snapshots; cycle day reports the first scheduled child's cycle
position (0 when nobody is scheduled), anchor-date arithmetic only.

Add household rollup and cycle-day sensors fa153059cb

Fire the documented bus events from the completion service paths fe38e5040e

quest_completed and quest_uncompleted fire on actual transitions with
documented payloads; child_day_complete fires when a completion clears
the child's day; quest_missed is defined as Feature 11's contract.
Payloads documented in the README for automation authors.

Decide event transitions under the completion lock 2a4eec658f

complete/uncomplete return a CompletionResult str subclass carrying
appended (decided with the write under the lock), so duplicate
concurrent calls fire one transition event; day-complete only
evaluates for an instance due today.

Fire the documented bus events from the completion service paths b90f55f750

Refresh entities immediately after completion service calls ad56d13c6e

complete_quest and uncomplete_quest force a coordinator refresh when
the call appended, so entity states land the moment the service call
returns; scheduled internals are unaffected.

Serialize forced coordinator refreshes per entry a5dbae5d50

NestQuestCoordinator.async_refresh holds a per-entry lock so
overlapping service-path refreshes never interleave; the queued pass
always publishes after the in-flight one.

Refresh entities immediately after completion service calls 933e29ae76

Handle entity lifecycle for child add, deactivate, reactivate a9d8f1d225

The harness tracks entities per entry so a platform unload removes
exactly that entry's entities; lifecycle tests prove deactivated
children drop out on reload, reactivation restores the original
unique_ids, new children appear without disturbing existing ones,
and the restart equivalent restores live states.

Handle entity lifecycle for child add, deactivate, reactivate 58cd68354f

Add the entity-and-event matrix test 36263d3f19

One fixture drives every Feature 10 contract: all per-child sensors
and binary sensors, household rollups, the 255-character limit,
the three events exactly once with schema-valid payloads, the
missed-instance omission rule, and no entities for inactive children.

Add the entity-and-event matrix test a65e32f577

Carry completion timing under the lock; shut down before close 35e66bd9e6

The completed event's was_on_time travels on the CompletionResult
(decided with the write) instead of re-reading latest state a racing
reversal could replace; unload clears coordinator listeners before
the database close.

Feature 10: Home Assistant Entity and Event Surface 25005cda77

Add the nightly missed-quest sweep 3de9f4b970

Fires one nestquest_quest_missed event per past-due open instance at
the configured rollover time and at startup, watermark-guarded in the
new nestquest_meta_state table (migration 7, strictly additive).
Read-only over the domain tables; never reports an instance that was
ever completed.

Serialize the missed sweep's watermark claim 8cd43141a9

The whole watermark read-query-fire-write span runs under a
per-database sweep lock; a racing second sweep re-reads the watermark
inside the lock and announces nothing.

Add the nightly missed-quest sweep 8c421abeb2

Add the notification section to the options flow 3c832c1cee

Notify target (empty default, household fills their own service),
three strict HH:MM automation times (08:00/15:00/20:00 — the report
deliberately before the midnight sweep), and four independent enable
toggles, all leniently stored and round-tripped.

Allow saving the empty default notify target fbde3eeaa1

An empty target means notifications are not configured yet and is the
shipped default; only malformed strings (padded or whitespace-only)
reject.

Add the notification section to the options flow 1d5143f850

Add the morning summary blueprint dc7a82f6e2

Iterates present children from the Feature 10 presence sensors, lists
what each owes today from the remaining sensor, omits absent children
entirely. Blueprint inputs (time, notify service, send toggle); the
notify target is the household's choice, never hard-coded. PyYAML and
Jinja2 join the dev-only dependencies for blueprint template tests.

Include collision-suffixed entity ids in the morning summary f31bda2714

Duplicate child names get HA registry suffixes (_2); the template now
iterates the due sensors (which carry present/child_id/child_name as
attributes) and pairs counts by child_id, so suffixed duplicates are
listed and the household rollup is excluded by the presence guard.

Add the morning summary blueprint fcc7a29f05

Add the afternoon open-quests reminder blueprint ad6f1768d7

Lists only present children who still owe quests; sends nothing at
all when every present child is clear (a false template condition
stops the action). Blueprint test helpers move to a shared module.

Nest notify payload fields under the action's data key 715aac994a

The modern HA action schema passes title and message to the notify
service only under data; fix the morning summary and afternoon
reminder blueprints and the test accessors accordingly.

Add the afternoon open-quests reminder blueprint 19a17b647d

Add the end-of-day parent report blueprint d2f9c50930

Defaults to 20:00 local — deliberately before the midnight missed
sweep, reading the same day's data. Every present child gets a
completion line; owed lines name still-open quests; absent children
are omitted; nothing sends when all clear unless opted in.

Report when remaining counts are unavailable, not all-clear b913772007

A missing or non-numeric remaining sensor reads as -1 in the
all-clear guard, so a degraded day reaches the parent instead of
looking like a clear day.

Add the end-of-day parent report blueprint 9d3cb30617

Add the day-complete celebration blueprint bf84793a1c

Triggers on nestquest_child_day_complete (never a zero-quest day),
notifies with the payload's child name, and dedupes per child per
day via an input_text helper holding <child_id>:<today> entries
pruned to today — a re-cleared day does not re-fire, but a second
child clearing the same day still celebrates.

Compare celebration stamps as whole entries; queue events f6166f25d9

Child ids sharing a prefix no longer suppress each other (split and
compare entries for equality), and queued mode keeps a second child's
day-complete event from being dropped while the first notify runs.

Add the day-complete celebration blueprint 5092369d49

Document the automation package and test event validity 3a2e6faa69

README gains the blueprint section: all four blueprints, their
inputs, the wiring table to the options-flow notification settings,
the celebration helper setup, event/sensor payload reference, and a
copy-pasteable example package. Tests assert every event trigger
references a real NestQuest event and no reminder is produced for an
absent child.

Document the automation package and test event validity e508c80465

Read the celebration payload from trigger.event.data ca93176768

HA event triggers expose the payload as trigger.event.data, not
trigger.payload; fix the blueprint, its tests, and the README
examples, with a regression guard.

Feature 11: Progress Automations and Notifications 7c62c50526

Add the Lit card toolchain and auto-register the Lovelace bundle edca25affa

Add bundled fonts, token CSS, and local font-face loading 89f517b3ad

Add bundled fonts, token CSS, and local font-face loading

Co-authored-by: grok <24+grok@code.cubecraftcreations.com>
Co-committed-by: grok <24+grok@code.cubecraftcreations.com>

Add the party board card (1a) read-only 1911b2bf6e

Add the party board card (1a) read-only

Add the quest log card (1b) read-only 0d2e0d6f26

Add the quest log card (1b) read-only

Define and implement the panel's empty and error states 028215fa38

Define and implement the panel's empty and error states

Wire complete_quest with optimistic seal and parchment toast 2b45ebf035

Wire complete_quest with optimistic seal and parchment toast

Add the quest complete screen (1c) a2c027deca

Add the quest complete screen (1c)

Subscribe panel cards to live NestQuest events (#130 ) 030ba83b14

Record 1920x1080 panel layout and TouchHub dock behaviour 4cb07fbca4

Record 1920x1080 panel layout and TouchHub dock behaviour

Panel card tests including the no-admin-controls assertion 43ad44ee48

Panel card tests including the no-admin-controls assertion

TouchHub setup runbook 7386999cf7

TouchHub setup runbook

Feature 12: Kid panel Lovelace cards 1c08c793e3

Feature 12: Kid panel Lovelace cards

Squash-merged PRs #125-#133. All Codex-reviewed. pytest 1496 passed.

overseer merged commit fe71d37bb0 into main

2026-09-21 06:57:16 -04:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Maniacs_Mansion/NestQuest#135