Skip to content

chore: release notes for v2.4.2-beta.3 and the 24-hour energy cap - #295

Merged
andrew-blake merged 3 commits into
mainfrom
chore/prepare-v2.4.2-beta.3
Aug 30, 2026
Merged

chore: release notes for v2.4.2-beta.3 and the 24-hour energy cap#295
andrew-blake merged 3 commits into
mainfrom
chore/prepare-v2.4.2-beta.3

Conversation

@andrew-blake

@andrew-blake andrew-blake commented Aug 29, 2026

Copy link
Copy Markdown
Owner

Summary

Release notes for the v2.4.2-beta.3 tag, plus a review of the existing ones.

The unrecognised-fan-speed behaviour sat under Changed for a sensor that has never shipped, and is now part of its Added entry. The state-change bullet credited outdoor temperature sensors with a change they have had since v2.4.0; the entry now says so, because it was never called out at the time.

The remaining edits are length and formatting. Bullets ran at a median of 70 words against 12 for every other release in the file, and bold marked five of sixteen entries with no criterion anyone could state.

docs/api/melcloudhome-telemetry-endpoints.md also gains the 24-hour truncation warning beside the energy endpoint's from and to parameters, which it had described as if both were honoured. The sweep found nothing else stale: the 48-hour figures in docs/api/ata-api-reference.md describe the outdoor temperature trendsummary window, a different code path from DATA_LOOKBACK_HOURS_ENERGY.

Merged since v2.4.2-beta.2

PR In the notes
#275 read water temperatures from the internaltemperatures report yes, already recorded
#276 generate the ATW testing dashboard from the entity registry no, dev tooling
#277 add a pr-body skill no, internal docs
#279 #280 #281 #282 dependency bumps no
#283 read report timestamps in each unit's own timezone yes, already recorded
#285 expose the fan speed ATA units actually run at yes, already recorded
#286 floor the request window to whole UTC hours yes, new
#287 stamp every outdoor-temperature poll, warn on failure yes, new
#291 reject unlisted fan speeds and flatten names at parse time yes, new
#292 keep the request window inside the server's 24-hour cap yes, new

AI Disclosure

  • No AI/agent tooling was used
  • AI/agent tooling assisted; I reviewed and ran the change myself before submitting

Testing

  • manifest.json and the README "What's New" heading both read 2.4.2, matching the base version the release workflow validates against the tag.
  • make pre-commit at the branch tip: all 12 hooks pass.

andrew-blake and others added 2 commits August 29, 2026 22:54
The base version is unchanged, so manifest.json and the CHANGELOG and
README headings stay at 2.4.2 as the beta process requires. This adds the
user-facing entries for what landed since beta.2.

CHANGELOG gains the energy freeze (#292/#294), the energy decrease
warnings (#286), the outdoor-temperature poll warnings and diagnostics
stamp (#287), and the unrecognised-fan-speed behaviour (#291). The fan
speed sensor itself (#285) was already recorded.

README's "What's New" leads with the energy freeze, since it is the one
item that silently affected every user, and the new fan speed sensor.

docs/api/melcloudhome-telemetry-endpoints.md now records the endpoint's
24-hour truncation next to the parameters it contradicts. That doc
described `from` and `to` as if both were honoured, which is what made
the freeze hard to see.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Features before fixes.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@codecov

codecov Bot commented Aug 29, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.45%. Comparing base (5da6dcb) to head (6b2b822).

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff           @@
##             main     #295   +/-   ##
=======================================
  Coverage   93.45%   93.45%           
=======================================
  Files          44       44           
  Lines        2963     2963           
=======================================
  Hits         2769     2769           
  Misses        194      194           
Flag Coverage Δ
unittests 93.45% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.


Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 5da6dcb...6b2b822. Read the comment docs.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Review of the notes rather than new content. Corrections first:

The "Actual fan speed" behaviour for an unrecognised value sat under
Changed, but the sensor has never shipped, so there was no prior
behaviour to change. Folded into its Added entry.

The bullet on state changes opened "Because that ..." and only parsed if
you had already read a different section, and it credited outdoor
temperature sensors with a change they have had since v2.4.0. Both fixed,
the outdoor attribution stated rather than dropped, since that was never
called out at the time.

Two other bullets referred to "the new source" and "a live one" without
naming either, and (#262) had been lost. All restored.

Then length. The [2.4.2] bullets ran at a median of 70 words against 12
for every other release in the file, with one at 154. Now 44. What went
is mechanism a reader cannot act on, which the linked issues hold; what
stayed is every instruction and issue reference. Bold lead-ins dropped:
they marked five of sixteen entries with no criterion anyone could state,
and no release since 2.4.0 uses them.

README's What's New carried six paragraphs for the three things a reader
does something about. Three now, plus an "Also in this release" sentence
in the v2.4.0 form for the rest, and the changelog link restored to its
own paragraph. The fan speed contributor is credited in both files in
each file's existing form.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@andrew-blake
andrew-blake merged commit 98e0b19 into main Aug 30, 2026
13 checks passed
@andrew-blake
andrew-blake deleted the chore/prepare-v2.4.2-beta.3 branch August 30, 2026 08:11
andrew-blake added a commit that referenced this pull request Sep 1, 2026
The unreleased section adds a new sensor entity, last-reading
timestamps and automation-visible behaviour changes, and removes
phantom ATW sensors; under the semver adherence the changelog header
declares, that is a minor release, not a patch. The 2.4.2-beta.*
pre-releases stay published and order correctly below 2.5.0 in HACS,
so beta installs upgrade cleanly.

Also restores the changelog H1, which #295 left indented six spaces
so GitHub rendered it as a code block.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant