fix: Clear the initialized condition state when the card is not usable (#2646)

The `initialized` state (used in conditions/triggers) was written once
and never cleared, so it meant "has this card ever been initialized"
while everything reading it took it as "is this card usable now". Home
Assistant takes a card off the page and puts it back whenever its
dashboard tab is left and returned to, so the card initialized again
while the state claimed it was initialized throughout: `trigger:
initialized` fired once per card rather than once per startup, and
automations were dropped in between.

The card lifecycle is now an explicit state machine (`SessionManager`),
the only writer of `initialized`, which separates a card that is
starting up from one initializing part of itself again while it runs. A
new `ever` parameter (conditions/triggers) selects the old latched
behaviour.

`remote_control` uses that parameter to keep its two camera priorities
correct under repeated starts. With `camera_priority: entity` the card
now re-reads the entity every time it starts, so a camera selected while
the card was away is picked up on return. With `camera_priority: card`
the card writes the entity on its first start only, unchanged, since
repeating that write would overwrite a camera the user had selected.

Closes: #2642


BREAKING CHANGE: `condition: initialized` is now `false` whenever the
card is not usable, and `trigger: initialized` fires each time the card
starts up rather than only the first time. Set `ever: true` on either to
keep the previous behaviour.
This commit is contained in:
Dermot Duffy authored and GitHub committed 2026-08-02 12:52:58 -07:00
1 parent e590f72783
commit 17146c8ca6
44 files changed
+1967 -654

No files matched your search

@@ -6,7 +6,7 @@ import { createEvaluatorContext } from './test-utils';
describe('initialized condition', () => {
it('should match an initialized condition', () => {
const evaluator = createConditionEvaluator(
{ condition: 'initialized' as const },
{ condition: 'initialized' as const, ever: false },
createEvaluatorContext(),
);
@@ -14,4 +14,18 @@ describe('initialized condition', () => {
expect(evaluator.evaluate({ initialized: true }).result).toBeTruthy();
expect(evaluator.evaluate({ initialized: false }).result).toBeFalsy();
});
it('should match an ever initialized condition', () => {
const evaluator = createConditionEvaluator(
{ condition: 'initialized' as const, ever: true },
createEvaluatorContext(),
);
expect(evaluator.evaluate({}).result).toBeFalsy();
expect(evaluator.evaluate({ everInitialized: true }).result).toBeTruthy();
expect(
evaluator.evaluate({ initialized: false, everInitialized: true }).result,
).toBeTruthy();
});
});