T

Joshua King 0281b51676 fix: read-only corruption preflight, early-return safety path, errorcode classification, sidecar snapshot test

- _preflight_existing_file probes an EXISTING file with a mode=ro URI
  connection before the read-write open, so a corrupt file is detected
  BEFORE WAL mode persists or sidecars appear; the preflight is inside
  the same ConfigEntryNotReady classification as open()/migrations
- corruption classification now prefers sqlite_errorcode (SQLITE_CORRUPT/
  SQLITE_NOTADB primary-byte match, locale-independent, Python 3.11+)
  with message fallback including 'database disk image is malformed'
- the early-return path (existing runtime record) routes through
  _async_open_database and reopens when db is None OR not connected
- new migration-stage corruption test: valid header + damaged page
  4096+, asserts main file byte-identical AND no -wal/-shm sidecars
  left behind; vacuous test replaced with pytest.raises form

2026-09-14 08:37:07 -04:00

custom_components/nestquest

fix: read-only corruption preflight, early-return safety path, errorcode classification, sidecar snapshot test

2026-09-14 08:37:07 -04:00

tests

fix: read-only corruption preflight, early-return safety path, errorcode classification, sidecar snapshot test

2026-09-14 08:37:07 -04:00

.gitignore

docs: add HACS repository metadata and developer setup docs

2026-09-11 09:06:02 -04:00

hacs.json

feat: implement setup/unload lifecycle with options-reload listener (#5 )

2026-09-13 15:02:42 -04:00

LICENSE

docs: add HACS repository metadata and developer setup docs

2026-09-11 09:06:02 -04:00

pyproject.toml

test: wire pytest test harness with standard hass fixture (#9 )

2026-09-13 19:18:10 -04:00

README.md

docs: point HACS installation at the public GitHub mirror (#6 )

2026-09-13 15:01:09 -04:00

uv.lock

test: wire pytest test harness with standard hass fixture (#9 )

2026-09-13 19:18:10 -04:00

README.md

NestQuest - House Chaos Coordination

Home Assistant custom integration for managing chores, custody schedules, and house coordination.

Overview

NestQuest helps households coordinate daily life, chore tracking, custody schedules, and shared tasks directly within Home Assistant. It provides sensors, calendar events, and service calls designed for busy households and modern co-parenting setups.

Installation

HACS Installation (Recommended)

Ensure HACS (Home Assistant Community Store) is installed.
In Home Assistant, open HACS > Integrations.
Select the three-dots menu in the top right and click Custom repositories.
Enter the repository URL: https://github.com/talon2king/NestQuest
Select category Integration and click Add.
Search for NestQuest and click Download.
Restart Home Assistant.

Note: Development happens in the private Gitea repository (https://code.cubecraftlabs.com/Maniacs_Mansion/NestQuest). The GitHub repository is a public mirror maintained for HACS distribution.

Manual Installation

Download the latest release from the repository.
Copy the custom_components/nestquest directory into your Home Assistant installation's config/custom_components/ folder:
```
cp -R custom_components/nestquest <config_dir>/custom_components/
```
Restart Home Assistant.

Configuration

After installation and restart:

Navigate to Settings > Devices & Services in Home Assistant.
Click Add Integration and search for NestQuest.
Follow the on-screen configuration flow.

Developer Setup and Testing

This project uses uv for fast Python package and dependency management.

Prerequisites

Python 3.11 or newer
uv installed on your machine

Setup Environment

To set up the development environment and install dependencies:

uv sync

Running Tests

Run the test suite with pytest:

uv run pytest

License

This project is licensed under the MIT License - see the LICENSE file for details.