ha-freshharvest/CHANGELOG.md

Changelog

All notable changes to this project are documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.4.0] - 2026-08-03

Control, not just reporting: the box can now be managed from Home Assistant.

Added

• Skip and restore, donate, add/remove add-ons, subscribe/unsubscribe, vacation holds, and produce-box switching — every reversible one verified by a live round trip that returned the account to its prior state.
• Entities for each: a produce-box select, a skip switch, a donate button, an add-ons to-do list the built-in conversation agent can drive, and sensors for subscriptions and vacation holds.
• A freshharvest_action event after every write, carrying action/success/ target/detail so automations can notify on the outcome.
• A four-section dashboard view with the controls in place, exported to examples/dashboard-view.yaml.

Notes

• Donating is the one action never executed: it cannot be undone, so it will be proven the first time there is a box actually worth giving away.
• Entities are not exposed to the conversation agent by default; that is the operator's call.

[Unreleased]

Added

• actions.py: the write layer — skip a delivery, donate a box, add/remove cart items, subscribe/unsubscribe with a frequency, and add a vacation hold over a date range (distinct from skipping: three weeks away is one hold, not three skips). Parsers for current subscriptions and scheduled holds.
• tools/compat.py plus a daily compat.yml workflow: records every assumption this integration makes about freshharvest.com and asserts it against the live site, refreshing the matrix in README and opening an issue on drift.
• FreshHarvestClient.async_fetch, restored as the shared authenticated-fetch primitive that both the snapshot read and every write action build on.
• todo.fresh_harvest_box: the order as a to-do list, so Home Assistant's own conversation agent can add and remove items with no bespoke voice code. Adding resolves the name against the site's search index first.
• switch.fresh_harvest_skip_next_order (a switch, not a button, so the state is readable and reversible) and button.fresh_harvest_donate_next_order (a button, because donating cannot be undone).
• sensor.fresh_harvest_subscriptions and sensor.fresh_harvest_vacation_holds, each listing the detail in attributes.
• A freshharvest_action event fired after every write action, carrying action/success/target/detail so automations can notify on the outcome.

Fixed

• Subscription parsing matched .account-item-multi-fields, which is the heading row, so an account with a live subscription reported zero. Cells are now picked by semantic class. Regression covered in tests/test_actions.py.

• Restore (un-skip) via POST /s/submit/restore-delivery, wired to switch.turn_off. The restore popup only exists once an order is actually skipped, which is why it could not be found until one was. Verified end to end against a live order: skipped Aug 18, restored it, confirmed the account returned to its previous state.

Fixed

• Subscription parsing matched .account-item-multi-fields, which is the heading row, so an account with a live subscription reported zero. Cells are now picked by semantic class. Regression covered in tests/test_actions.py.

• async_fetch treated popup bodies and AJAX replies as full pages. Those are fragments with no navigation, so the signed-in heuristic read every one as logged out, re-authenticated pointlessly and then failed. They now pass is_page=False. This blocked skip entirely.

• The to-do list mixed produce-box contents with add-ons. Only add-ons can be added and removed — the box is chosen, not assembled — so listing produce invited deletes with no endpoint behind them. The entity is now todo.fresh_harvest_add_ons; box contents stay read-only on sensor.*_next_delivery_items.

• Produce box switching: POST /s/submit/select-basket, exposed as select.fresh_harvest_produce_box with all ten boxes. Switching a box is not adding an add-on — you change which box arrives, not what is inside it — so it is a select, where add-ons are a to-do list.

Known gaps

• Entities are deliberately NOT exposed to the conversation agent yet.

Notes

• Actions default to dry_run=True and report exactly what they would submit. Nothing has been executed against a live account yet.

[0.3.0] - 2026-08-03

Prepared for public release as a HACS custom repository.

Added

• Every cost component is now its own entity rather than an attribute: subtotal, box price, add-ons, tax, and delivery fee for the next delivery, plus a total and free-delivery-remaining for the open order.
• binary_sensor.fresh_harvest_order_open, which turns off when the cutoff passes — the last moment to change the box.
• sensor.fresh_harvest_delivery_day.
• Parsing for the driver tip, potential Bounty savings, and the free-delivery threshold, with the threshold carried across orders because the progress bar only renders on carts below it.
• LICENSE (MIT), hacs.json, and a CI workflow running hassfest, the HACS action, and the test suite.
• tests/test_translations.py, which cross-checks every entity's translation_key against both translation files and fails on an orphan or a missing name.

Changed

• Entities share a FreshHarvestEntity base and declare a scope (account, next_order, open_order), so a description states only the field it reads instead of repeating None handling.
• manifest.json documentation and issue-tracker URLs now point at GitHub; they previously pointed at a private forge that no installer could reach.
• Fixture cart identifiers replaced with placeholders.

[0.2.0] - 2026-08-03

Added

• sensor.fresh_harvest_next_delivery_add_ons, the combined cost of the add-ons excluding the produce box.
• add_ons_total and box_price attributes on the item-count sensor.
• A test asserting add_ons_total + box_price equals the portal's own subtotal, so a mis-parsed price cannot pass silently.

Changed

• add_ons attribute entries now carry quantity, unit, and extended price (4 Complete Recovery Smoothie 15.2 fl oz — $17.96) rather than a bare name. Templates reading these strings will need updating.
• The test fixture's totals are now internally consistent, so the subtotal reconciliation is a real invariant rather than copied numbers.

[0.1.0] - 2026-08-03

Added

• Config flow taking freshharvest.com portal credentials.
• Session client implementing the two-step login handshake against /s/popup/login and /s/submit/login, including the per-session LoginSecurity and SubmitToken anti-replay fields, with one automatic re-authentication when a session lapses.
• Dashboard parser reading delivery day, next arrival date, both upcoming carts, produce-box contents, add-ons, and order totals from a single GET /p/dashboard/details.
• Update coordinator polling every 6 hours, surfacing auth failures as ConfigEntryAuthFailed so Home Assistant prompts for re-authentication.
• Five sensors: next delivery date, next delivery total, next delivery item count, open order delivery date, and shopping window.
• Parser tests covering totals, contents, the locked/open distinction, money parsing, and year rollover on undated cart tabs.
• English translations under translations/en.json, which is where custom integrations read entity and config-flow strings from.
• Example dashboard view under examples/dashboard-view.yaml: a three-section tab with a delivery countdown, order tiles, and the full box contents.