Files
vardkey/ai-note.md
T

48 lines
4.1 KiB
Markdown

# AI Agent Note — Per-Key Health Check Changes
## Status
The requirements below have been agreed with the user and added to section 19 of `TODO.md`. They are **not yet implemented**. Treat section 19 as authoritative wherever older requirements elsewhere in `TODO.md` conflict with it. Do not mark TODO items complete until code and tests have been implemented and verified.
## Product behavior
- Each form submission records one selected key only: SeedSigner (key 1), Blockstream Jade (key 2), or Nunchuk (key 3).
- All key-specific checks and notes in that submission apply only to the selected key.
- The user chooses the check date. Next check due is automatically one calendar year later, is not editable in the UI, and must be calculated/validated on the server too.
- Contact confirmation and overall comments remain available for each submission.
- Software compatibility: select one wallet software (Sparrow or Nunchuk), and record its compatibility status and version for the selected key. Remove the separate Sparrow/Nunchuk version inputs.
- BIP327/SLIP39: record only the two statuses for the selected key/product. Remove version, date checked, and notes/source fields. Do not require statuses for other keys/products in the same submission.
- Security status fields are contextual:
- SeedSigner status appears only for key 1.
- Blockstream Jade status appears only for key 2.
- Sparrow Wallet and Nunchuk software statuses are included with every submission.
- There is only one Nunchuk status per submission. For key 3, it covers both the Nunchuk key/provider and Nunchuk wallet software; do not duplicate it.
- Show and require only statuses relevant to the selected key and software. Use the four existing allowed values: `TRYGG`, `PATCHA`, `SÅRBAR`, `KOMPROMITTERT`.
- History must clearly show the selected key and its associated results. Preserve existing saved history and provide a safe, backward-compatible database migration if needed.
## Implementation guidance
1. Read the existing form, API validation, database schema/storage, history UI, alerts, and tests before changing them.
2. Keep the current local SQLite and simple architecture. Avoid unrelated features and do not add AI/network integrations.
3. Update the form and payload so one key is selected and submitted, rather than serializing all three key checks and all four products/providers.
4. Update server-side validation so exactly one configured key is accepted, selected software is valid, and only the relevant key/product/security results are required. Reject invalid or duplicate records.
5. Compute next-check date server-side as one calendar year after `checked_at`; handle leap day consistently (for example, clamp to the last valid day of February). Do not trust a client-provided due date.
6. Update persistence and read APIs as required, retaining compatibility with old records. Old records may contain multiple key, tool, and security rows; continue rendering them safely.
7. Update history rendering and alert logic to work for both legacy multi-key records and new single-key records.
8. Add/update tests for each key selection, relevance/omission of security fields, Sparrow/Nunchuk software choice and version, BIP327/SLIP39 statuses, server-derived due date including leap day, invalid payloads, alerts/history, and legacy database/history compatibility.
9. Run the full test suite and report results. Do not edit `TODO.md` beyond its agreed section 19 without asking the user.
## Likely files to inspect/update
- `static/health-check.html`
- `static/health-check.js`
- `validation.py`
- `database.py` (only if needed; preserve old data)
- `static/history.js`
- `alerts.py`
- Relevant tests: `tests/test_health_check_form.py`, `tests/test_validation.py`, `tests/test_database.py`, `tests/test_app.py`, `tests/test_alerts.py`
## Important product clarification
Nunchuk has two roles: it is the third key/provider and also wallet software. Still record only one Nunchuk security status per submission. Sparrow is software only and is checked on every submission. Software compatibility is a separate selection where the user chooses Sparrow or Nunchuk.