"""Tests for annual health-check form content and client-side behavior.""" from pathlib import Path import re import unittest ROOT = Path(__file__).resolve().parents[1] def read_static(name): """Return the text of one static asset.""" return (ROOT / "static" / name).read_text(encoding="utf-8") class HealthCheckFormTests(unittest.TestCase): def test_form_includes_privacy_notice_and_review_without_save_claim(self): html = read_static("health-check.html") self.assertIn('', html) self.assertIn("Never enter seed phrases", html) self.assertIn('id="health-check-form"', html) self.assertIn("Review check", html) self.assertIn("No data from this form has been stored", html) def test_form_selects_one_key_and_one_wallet_software(self): html = read_static("health-check.html") self.assertIn('id="key-select"', html) self.assertIn('name="wallet_software"', html) self.assertIn('id="next-check-preview"', html) self.assertNotIn("next_check_due", html) self.assertIn('name="contact_info_verified"', html) def test_the_form_sections_follow_the_agreed_order(self): html = read_static("health-check.html") eyebrows = re.findall(r'

([^<]+)

', html) # The page heading comes first, and the form is renumbered with # 04 / Standards gone (section 24.3). self.assertEqual( eyebrows, [ "Annual security check", "01 / Schedule", "02 / Key", "03 / Compatibility", "04 / External research", "05 / Contact confirmation", "06 / Notes", "Review", ], ) def test_form_script_covers_the_checklist_fields_and_status_values(self): script = read_static("health-check.js") for field in ( "hardware_works", "address_path", "seed_backup_verified", ): self.assertIn(field, script) for status in ("SECURE", "PATCHED", "VULNERABLE", "COMPROMISED"): self.assertIn(status, script) self.assertIn("formatLocalDate", script) self.assertIn("Needs assessment", script) self.assertIn("Results requiring follow-up", script) def test_the_bip327_and_slip39_function_is_gone(self): html = read_static("health-check.html") script = read_static("health-check.js") history = read_static("history.js") # The whole function is removed (section 24.2), so neither the form, the # script, nor the history view mentions it any more. self.assertNotIn("BIP327", html) self.assertNotIn("SLIP39", html) self.assertNotIn("tool-checks", html) self.assertNotIn("toolChecks", script) self.assertNotIn("standardsStatuses", script) self.assertNotIn("tool_checks", script) self.assertNotIn("BIP327", history) self.assertNotIn("tool_checks", history) def test_form_script_no_longer_uses_the_removed_fields(self): script = read_static("health-check.js") for removed in ("seed_backup_status", "address_verified", "derivation_height"): self.assertNotIn(removed, script) def test_the_wallet_software_choices_come_from_the_settings_and_the_cloud_keys(self): script = read_static("health-check.js") html = read_static("health-check.html") self.assertIn("walletSoftwareChoices", script) self.assertIn("renderWalletSoftwareOptions", script) # The settings list plus the name of every configured cloud key # (section 25.4). self.assertIn("/api/settings", script) self.assertIn("walletSoftwareList", script) self.assertIn('key.type === "cloud"', script) self.assertIn("key.name", script) # The old fixed list and the built-in Sparrow constant are gone from both # the markup and the script. self.assertNotIn('option value="Nunchuk"', html) self.assertNotIn("KEY_PRODUCTS", script) self.assertNotIn("SPARROW_SOFTWARE", script) def test_form_script_uses_the_configured_key_name(self): script = read_static("health-check.js") self.assertIn("expectedLabels", script) self.assertIn("key.name", script) self.assertNotIn("keyProductFor", script) self.assertNotIn("CLOUD_KEY_NUMBER", script) def test_form_script_derives_from_availability(self): script = read_static("health-check.js") self.assertIn("/api/previous-values", script) self.assertIn("derivedSummary", script) self.assertIn("Derived from availability and the address path", script) self.assertIn('key.type === "cloud"', script) # The section 20 carry-forward of a third provider is gone (section 23.3). self.assertNotIn("carriedSecurity", script) self.assertNotIn("Carried forward from the last saved check", script) # The cloud key no longer renders the cloud results as form fields, and # the derived values themselves are gone (section 25.6). self.assertNotIn('makeField("Cloud health check"', script) self.assertNotIn('makeField("Provider operational"', script) self.assertNotIn("cloud_health_status", script) self.assertNotIn("cloud_provider_operational", script) def test_form_prefills_the_saved_values_as_input_values(self): script = read_static("health-check.js") # A previous value is a real input value, not an HTML placeholder, so an # untouched field is saved as it stands (section 23.1). self.assertIn("previousText", script) self.assertIn("input.value = value", script) self.assertNotIn("input.placeholder", script) self.assertIn('previousText(previous, "firmware_version")', script) # The address path is prefilled from the key profile, because that is the # stored path it is compared with (section 25.1). self.assertIn("key.address_path", script) self.assertIn("updateSoftwareVersionValue", script) self.assertIn("softwareVersionInput.value = reusable", script) self.assertIn("previous.wallet_software === walletSoftwareSelect.value", script) def test_form_requires_an_explicit_compatibility_status(self): html = read_static("health-check.html") script = read_static("health-check.js") self.assertIn('id="software-compatibility"', html) self.assertIn('', html) self.assertIn('name="software_compatibility_status" required', html) self.assertNotIn('value="NOT_ASSESSED"', html) # The hidden control carries the derived value for the cloud key and is # not required for a key that was not available (sections 20 and 22). self.assertIn("softwareCompatibilitySelect.required", script) self.assertIn("compatibilityDerived", script) self.assertIn('softwareCompatibilitySelect.value = "OK"', script) def test_form_requires_hardware_works_and_the_contact_confirmation(self): html = read_static("health-check.html") script = read_static("health-check.js") # Hardware works is a required choice for an available hardware key # (section 24.1), so the placeholder is not an answer. self.assertIn("hardwareWorksOptions", script) self.assertIn('["", "Select status"]', script) self.assertIn('makeSelect(hardwareWorksOptions, "hardware_works")', script) self.assertNotIn("booleanOptions", script) # The required flag is cleared when the key was not available, because a # hidden required control would block the submission. The address path is # no longer a field of its own (section 25.1). self.assertIn('["hardware_works", "seed_backup_verified"]', script) self.assertNotIn("address_path_verified", script) # The confirmation is required in the markup, with the same placeholder, # and it has no "not assessed" value. self.assertIn('name="contact_info_verified" required', html) self.assertNotIn("Not assessed", html) def test_form_asks_about_the_selected_key_holder_and_reminds_about_updates(self): html = read_static("health-check.html") script = read_static("health-check.js") self.assertIn("this key holder's contact details are current?", html) self.assertIn('', html) self.assertIn('', html) self.assertIn("KEY_COUNT = 3", script) self.assertIn('/api/setup', script) self.assertIn("collectSetup", script) self.assertIn("address_path", script) self.assertIn("_address_path", script) # The type and the address path are locked once the setup is saved, while # the name may be changed in the settings (sections 25.1 and 25.2). self.assertIn("lockForm", script) self.assertIn("/settings", script) def test_the_settings_page_has_the_three_sections(self): html = read_static("settings.html") self.assertIn('', html) self.assertIn("Never enter seed phrases", html) eyebrows = re.findall(r'

([^<]+)

', html) self.assertEqual(eyebrows, ["Settings", "01 / Keys", "02 / Wallet software", "03 / Key rotation"]) self.assertIn('id="keys-list"', html) self.assertIn('id="wallet-software-list"', html) self.assertIn('id="rotation-list"', html) self.assertIn('id="add-software"', html) self.assertIn('id="save-software"', html) self.assertIn('id="rotate-keys"', html) def test_the_settings_page_warns_about_moving_the_funds(self): html = read_static("settings.html") # Rotating a key creates a new wallet, so the funds have to be moved # (section 25.2). self.assertIn("Rotating a key creates a new wallet", html) self.assertIn("Move your funds from the old multisig setup to the new one", html) self.assertIn("Do not discard the old keys", html) self.assertIn('id="rotation-replaced"', html) self.assertIn('id="rotation-path-unchanged"', html) self.assertIn("I confirm that each selected key has been replaced", html) self.assertIn("I confirm that the address path of each selected key is unchanged", html) def test_the_settings_script_stores_the_list_whole_and_rotates(self): script = read_static("settings.js") self.assertIn("/api/settings/keys", script) self.assertIn("/api/settings/wallet-software", script) self.assertIn("/api/keys/", script) self.assertIn("rotate", script) self.assertIn("wallet_software", script) self.assertIn("collectSoftware", script) self.assertIn("collectRotation", script) self.assertIn("keep_name", script) self.assertIn("address_path_unchanged", script) self.assertIn("replaced", script) # The address path is locked as soon as the key has a saved check, and the # name may always be changed (sections 25.1 and 25.2). self.assertIn("has_checks", script) self.assertIn("pathInput.disabled", script) # A link from the dashboard pre-selects the key it points at. self.assertIn("requestedRotation", script) def test_history_shows_a_note_when_no_security_status_was_recorded(self): script = read_static("history.js") self.assertIn("securityTable", script) self.assertIn("No security statuses were recorded", script) def test_history_shows_the_contact_status_as_text(self): script = read_static("history.js") self.assertIn("Contact details confirmed", script) self.assertIn("record.contact_info_verified", script) def test_history_shows_the_derived_address_path_result(self): script = read_static("history.js") # The result is derived by the server, so it is shown as a derived value # (sections 9 and 25.1). self.assertIn("Address path verified (derived)", script) self.assertIn("keyCheck.address_path_verified", script) self.assertIn("keyCheck.address_path", script) # The removed cloud results are no longer shown (section 25.6). self.assertNotIn("Cloud health check", script) self.assertNotIn("Provider operational", script) self.assertNotIn("cloud_health_status", script) self.assertNotIn("cloud_provider_operational", script) def test_stylesheet_makes_the_hidden_attribute_work_on_grid_containers(self): styles = read_static("styles.css") self.assertIn(".form-stack[hidden]", styles) self.assertIn(".field-grid[hidden]", styles) self.assertIn(".form-section[hidden]", styles) def test_stylesheet_covers_the_new_elements(self): styles = read_static("styles.css") for rule in ( ".warning-note", ".checkbox-field", ".software-row", ".alert-actions", ".topbar-actions", ): self.assertIn(rule, styles) if __name__ == "__main__": unittest.main()