Check off section 32.8 points 5 and 6 and update the spec to schema 13

This commit is contained in:
ai-bot committed 2026-10-24 10:43:16 +00:00
1 parent acfa72d346
commit 9be04341f4
1 file changed
+34 -27
+34 -27
View File
@@ -17,10 +17,10 @@ Appen skal **berre registrere resultat og historikk**. Han skal ikkje signere Bi
- **§1–§18 er kravspecen og gjeld som han står.** Han skildrar appen slik han er no, ikkje slik han vart bygd. - **§1–§18 er kravspecen og gjeld som han står.** Han skildrar appen slik han er no, ikkje slik han vart bygd.
- **§19–§31 er historikk.** Alle rundane der er ferdige og verifiserte, og står no som éi linje kvar. Reglane deira ligg i §1–§18 og i `ai-note.md`, som er handoveren. - **§19–§31 er historikk.** Alle rundane der er ferdige og verifiserte, og står no som éi linje kvar. Reglane deira ligg i §1–§18 og i `ai-note.md`, som er handoveren.
- **§32 er runden som går no.** §32.1–§32.4 og §32.7 er utførte og verifiserte; dei står nedanfor som korte punktlister, slik at §-referansane i koden held, medan grunngjevinga ligg i git-historikken. Att står §32.8 (sju punkt), §32.6 (dokumentasjonsdrifta) og §32.5 (hevinga av pakkeversjonen), i den rekkjefølgja. I §32.4 står berre BR-003 att, og han kan berre brukaren lukke. - **§32 er runden som går no.** §32.1–§32.4 og §32.7 er utførte og verifiserte; dei står nedanfor som korte punktlister, slik at §-referansane i koden held, medan grunngjevinga ligg i git-historikken. Av §32.8 står berre **punkt 7** att, den manuelle gjennomgangen; deretter kjem §32.6 (dokumentasjonsdrifta) og §32.5 (hevinga av pakkeversjonen), i den rekkjefølgja. I §32.4 står berre BR-003 att, og han kan berre brukaren lukke.
- **Reglane under «Reglar som gjeld alle rundar» er bindande** for kvar framtidig endring. - **Reglane under «Reglar som gjeld alle rundar» er bindande** for kvar framtidig endring.
- Eit punkt utan avkryssingsboks er implementert og verifisert. `[ ]` markerer det som står att. - Eit punkt utan avkryssingsboks er implementert og verifisert. `[ ]` markerer det som står att.
- **Status:** alt til og med §31 er implementert og verifisert, og §32.1, §32.2, §32.3, §32.4 og §32.7 er utførte (sjå §32), med unnatak av BR-003, som berre brukaren kan lukke. I §32.8 er **steg A** (punkt 3, 4 og 2) og **steg B** (punkt 1) utførte; **steg C** (punkt 6 og 5) står att, og punkt 7 er brukaren sin manuelle gjennomgang. Deretter kjem §32.6 og §32.5. Skjema **versjon 12** til steg C landar, då han blir **13**. StartOS-pakka er bygd, sideloda og køyrd på ein eigen StartOS 0.4.0-boks. Pakkeversjonen står på `0.1.0:0` og blir ikkje heva før §32 er ferdig og brukaren seier ifrå. - **Status:** alt til og med §31 er implementert og verifisert, og §32.1, §32.2, §32.3, §32.4 og §32.7 er utførte (sjå §32), med unnatak av BR-003, som berre brukaren kan lukke. I §32.8 er **steg A** (punkt 3, 4 og 2), **steg B** (punkt 1) og **steg C** (punkt 6 og 5) utførte, so skjemaet er no **versjon 13**; att står berre **punkt 7**, som berre brukaren kan gjere. Deretter kjem §32.6 og §32.5. StartOS-pakka er bygd, sideloda og køyrd på ein eigen StartOS 0.4.0-boks. Pakkeversjonen står på `0.1.0:0` og blir ikkje heva før §32 er ferdig og brukaren seier ifrå.
--- ---
@@ -82,17 +82,17 @@ Standardoppsettet appen vart bygd for, med døme-adressestiar:
SQLite, med så få tabellar som mogleg. Kvar tabell har éi rad per kolonne her; kolonnar merkte `*` er legacy-kolonnar som berre finst for gamle rader og aldri blir skrivne på nytt. SQLite, med så få tabellar som mogleg. Kvar tabell har éi rad per kolonne her; kolonnar merkte `*` er legacy-kolonnar som berre finst for gamle rader og aldri blir skrivne på nytt.
**`keys`** — nøkkelplassane i det eine oppsettet. **`keys`** — nøkkelplassane i det eine oppsettet, med éi aktiv rad per `key_number` og valfritt talet på pensjonerte rader attåt.
`id`, `key_number` (1–`multisig_key_count`), `name`, `type` (`hardware`/`cloud`), `model`, `address_path`, `created_at`. `id`, `key_number` (1–`multisig_key_count`), `name`, `type` (`hardware`/`cloud`), `model`, `address_path`, `active` (`0`/`1`), `rotated_at`, `created_at`.
**`health_checks`** — éi rad per innsending, som gjeld éin vald nøkkel. **`health_checks`** — éi rad per innsending, som gjeld éin vald nøkkel.
`id`, `checked_at`, `next_check_due`, `wallet_software`, `software_version`, `software_compatibility_status`, `software_comments`, `sparrow_version*`, `nunchuk_version*`, `contact_info_verified`, `comments`. `id`, `checked_at`, `next_check_due`, `wallet_software`, `software_version`, `software_compatibility_status`, `software_comments`, `sparrow_version*`, `nunchuk_version*`, `contact_info_verified`, `comments`.
**`key_checks`** — eitt record for den valde nøkkelen i kvar innsending. **`key_checks`** — eitt record for den valde nøkkelen i kvar innsending, med eit snapshot av nøkkelen slik han var då kontrollen vart lagra.
`id`, `health_check_id`, `key_id`, `available`, `hardware_works`, `firmware_version`, `seed_backup_verified`, `address_path_verified`, `address_path`, `comments`. `id`, `health_check_id`, `key_id`, `key_name`, `key_type`, `key_model`, `available`, `hardware_works`, `firmware_version`, `seed_backup_verified`, `address_path_verified`, `address_path`, `comments`.
**`ai_security_checks`** — KI-sikkerheitsstatus per leverandør. **`ai_security_checks`** — KI-sikkerheitsstatus per leverandør, med den kontrollerte nøkkelen når leverandøren er nøkkelen sitt eige konfigurerte namn.
`id`, `health_check_id`, `provider`, `status`, `comments`. `id`, `health_check_id`, `provider`, `key_id`, `status`, `comments`.
**`wallet_software`** — lista brukaren vedlikeheld i innstillingane. **`wallet_software`** — lista brukaren vedlikeheld i innstillingane.
`id`, `name`, `created_at`. `id`, `name`, `created_at`.
@@ -121,6 +121,10 @@ Reglar:
- `address_path` må vere unik på tvers av alle nøklane i oppsettet: i oppsettet, i innstillingane og ved rotering. Samanlikninga er kanonisk: `h`/`H` og `'` er same markør, og luft og store/små bokstavar blir ignorerte. Den lagra verdien blir aldri skriven om. - `address_path` må vere unik på tvers av alle nøklane i oppsettet: i oppsettet, i innstillingane og ved rotering. Samanlikninga er kanonisk: `h`/`H` og `'` er same markør, og luft og store/små bokstavar blir ignorerte. Den lagra verdien blir aldri skriven om.
- `reason` i `alert_acknowledgements` lagrar namnet på handlinga som lukka varselet, ikkje ein fri tekst. - `reason` i `alert_acknowledgements` lagrar namnet på handlinga som lukka varselet, ikkje ein fri tekst.
- `key_id` i `alert_acknowledgements` lagrar nøkkelen varselet høyrde til, eller `NULL` for eit programvarevarsel frå innstillingslista. - `key_id` i `alert_acknowledgements` lagrar nøkkelen varselet høyrde til, eller `NULL` for eit programvarevarsel frå innstillingslista.
- Berre éi rad i `keys` per `key_number` er aktiv om gongen. Kravet blir handheva av eit **delvis unikt indeks** på `key_number` der `active = 1`, ikkje av ein `UNIQUE` på tabellen, so pensjonerte rader kan dele multisig-plassen (§32.8 punkt 5).
- `active` er `1` på den rada appen les som «nøkkelen», og `rotated_at` er tidsstempelet då rada vart pensjonert av ei rotering. Alle spørringar som les «nøkkelen» — oppsettet, innstillingane, skjemaet, dashboardet og roteringa — les den **aktive** rada, medan historikk, CSV og varsel les snapshottet på kontrollen.
- `key_name`, `key_type` og `key_model` i `key_checks` er eit **snapshot** av nøkkelen slik han var då kontrollen vart lagra. Korkje ei rotering eller ei omdøyping kan endre det, og migreringa backfyller snapshottet frå den kopla `keys`-rada (§32.8 punkt 5).
- `key_id` i `ai_security_checks` er den kontrollerte nøkkelen når `provider` er nøkkelen sitt eige konfigurerte namn, og `NULL` elles. Kjelda til eit KI-varsel blir difor avgjord av rada sjølv, og ho kan ikkje flippe når nøkkelen blir omdøypt eller rotert (§32.8 punkt 6).
- `failed_login_count` og `failed_login_until` i `app_settings` er innloggingsteljaren og sluttidspunktet for låsa (§32.8 punkt 2). Han overlever ein restart, og `failed_login_until` er eit sekundtal sidan epoch. - `failed_login_count` og `failed_login_until` i `app_settings` er innloggingsteljaren og sluttidspunktet for låsa (§32.8 punkt 2). Han overlever ein restart, og `failed_login_until` er eit sekundtal sidan epoch.
- `tool_checks` finst ikkje. `device`, `seed_backup_status`, `address_verified`, `derivation_height`, `cloud_health_status` og `cloud_provider_operational` finst ikkje. - `tool_checks` finst ikkje. `device`, `seed_backup_status`, `address_verified`, `derivation_height`, `cloud_health_status` og `cloud_provider_operational` finst ikkje.
@@ -221,8 +225,9 @@ Alle lagra kontrollar blir lesne, ikkje berre den nyaste. Like varsel (same `cod
- Kvar varselkode har eit fast sett av handlingar: `rotate`, `replace_hardware`, `remove_software`, `ignore`, `contact_updated`. Ei handling som ikkje høyrer til varselet, blir avvist. - Kvar varselkode har eit fast sett av handlingar: `rotate`, `replace_hardware`, `remove_software`, `ignore`, `contact_updated`. Ei handling som ikkje høyrer til varselet, blir avvist.
- `rotate` blir utført i innstillingane, sidan han krev ein ny adressesti. Dei andre handlingane blir utførte der varselet står, kvar med sin eigen knappetekst og sitt eige stadfestingssteg. - `rotate` blir utført i innstillingane, sidan han krev ein ny adressesti. Dei andre handlingane blir utførte der varselet står, kvar med sin eigen knappetekst og sitt eige stadfestingssteg.
- Kjelda til eit KI-varsel er leverandøren. Er han nøkkelen sitt eige konfigurerte namn, er nøkkelen kjelda, ho blir skriven som `Key N: <namn>` på same måte som alle andre nøkkelvarsel, og ei rotering lukkar varselet. Elles er leverandøren programvara nøkkelen køyrer med, kjelda er berre namnet hennar, og varselet blir lukka ved å fjerne ho frå innstillingane. - Kjelda til eit KI-varsel blir avgjord av rada i `ai_security_checks`, ikkje av namna som er konfigurerte no. Ber rada den kontrollerte nøkkelen, er nøkkelen kjelda, ho blir skriven som `Key N: <namn>` på same måte som alle andre nøkkelvarsel, og ei rotering lukkar varselet. Elles er leverandøren programvara nøkkelen køyrer med, kjelda er berre namnet hennar, og varselet blir lukka ved å fjerne ho frå innstillingane. Ei omdøyping eller ei rotering kan difor ikkje gi eit nytt programvarevarsel ved sida av det nøkkelvarsla roteringa alt lukka (§32.8 punkt 6).
- Eit programvarevarsel frå innstillingslista har inga nøkkel og sperrar inga nøkkel. Eit programvarevarsel som kjem frå eit cloud-nøkkelnamn høyrer til den kontrollerte nøkkelen og sperrar han, sidan namnet aldri kan fjernast frå innstillingane. - Eit programvarevarsel frå innstillingslista har inga nøkkel og sperrar inga nøkkel. Eit programvarevarsel som kjem frå eit cloud-nøkkelnamn høyrer til den kontrollerte nøkkelen og sperrar han, sidan namnet aldri kan fjernast frå innstillingane.
- Lukka varsel blir viste i historia og i CSV-en, både dei som høyrer til ein nøkkel og dei som høyrer til ei programvare i innstillingslista: lukkinga heng på kontrollen ho lukka gjennom `check_id`, so eit lukka programvarevarsel står i same liste som ei rotering (§32.8 punkt 6).
- Kvar handling krev ei stadfesting frå brukaren, og appen utfører aldri tiltaket sjølv. Han kontaktar heller aldri leverandørar eller KI-tenester. - Kvar handling krev ei stadfesting frå brukaren, og appen utfører aldri tiltaket sjølv. Han kontaktar heller aldri leverandørar eller KI-tenester.
- Eit varsel utan handling er ein feil i koden, ikkje ein tilstand brukaren kan hamne i. - Eit varsel utan handling er ein feil i koden, ikkje ein tilstand brukaren kan hamne i.
- Eit varsel om nøkkel utilgjengeleg, adressestifeil eller seed-backup gjeld berre den nøkkelen, og resten av nøkkelfelta kan ikkje registrerast. - Eit varsel om nøkkel utilgjengeleg, adressestifeil eller seed-backup gjeld berre den nøkkelen, og resten av nøkkelfelta kan ikkje registrerast.
@@ -247,9 +252,9 @@ Alle lagra kontrollar blir lesne, ikkje berre den nyaste. Like varsel (same `cod
- Opne ein health check i read-only-visning med dato, neste sjekk, status per nøkkel, programvare og versjon, KI-status og kommentarar. - Opne ein health check i read-only-visning med dato, neste sjekk, status per nøkkel, programvare og versjon, KI-status og kommentarar.
- Gamle health checks blir aldri overskrivne. - Gamle health checks blir aldri overskrivne.
- Vis `Address path verified` som den utleidde verdien han er, og ikkje som eit brukarval. - Vis `Address path verified` som den utleidde verdien han er, og ikkje som eit brukarval.
- Vis namnet nøkkelen har no, sidan namnet kan endrast i innstillingane. - Vis namnet, typen og modellen nøkkelen vart lagra med på kontrollen, sidan snapshottet på kontrollen er frosen og korkje ei rotering eller ei omdøyping kan endre han (§32.8 punkt 5).
- Vis kva varsel som vart lukka på kontrollen, med kva handling og kva dato. - Vis kva varsel som vart lukka på kontrollen, med kva handling og kva dato. Lukka programvarevarsel står i same liste som lukka nøkkelvarsel (§32.8 punkt 6).
- Kortet i lista viser datoen, nøkkelnummeret og namnet nøkkelen har no, og ein kort status: `All OK` eller `Needs follow-up` (§32.2 punkt 14). Det kjem frå `needs_follow_up` i oppsummeringa, som seier om kontrollen reiste noko å følgje opp. - Kortet i lista viser datoen, nøkkelnummeret og namnet nøkkelen vart lagra med på kontrollen, og ein kort status: `All OK` eller `Needs follow-up` (§32.2 punkt 14 og §32.8 punkt 5). Det kjem frå `needs_follow_up` i oppsummeringa, som seier om kontrollen reiste noko å følgje opp.
- Programvara og versjonen hennar står på éi line, t.d. `Sparrow Wallet 2.5.1`, og modellen og firmware-versjonen står på éi line, t.d. `Blockstream Jade 1.4.1` (runden 32.1). Manglar ein del, står resten åleine; manglar båe, står `—`. - Programvara og versjonen hennar står på éi line, t.d. `Sparrow Wallet 2.5.1`, og modellen og firmware-versjonen står på éi line, t.d. `Blockstream Jade 1.4.1` (runden 32.1). Manglar ein del, står resten åleine; manglar båe, står `—`.
- Lukke-tabellen på ein kontroll viser `Alert`, `Action` og `Closed`. Kjelda er inga eiga kolonne (runden 32.1). - Lukke-tabellen på ein kontroll viser `Alert`, `Action` og `Closed`. Kjelda er inga eiga kolonne (runden 32.1).
- Sida har ein eigen `Export`-seksjon etter lista, før detaljseksjonen, med tittellinja `Download the report`, lenkja `Download CSV` utan `download`-attributt — så filnamnet frå `Content-Disposition` vinn — og noten som forklarar eksporten rett under lenkja (§32.7 punkt 5 og etterrunden punkta 1 og 4). Det er den einaste staden eksporten blir lasta ned frå, og sida startar ikkje ein ny kontroll. - Sida har ein eigen `Export`-seksjon etter lista, før detaljseksjonen, med tittellinja `Download the report`, lenkja `Download CSV` utan `download`-attributt — så filnamnet frå `Content-Disposition` vinn — og noten som forklarar eksporten rett under lenkja (§32.7 punkt 5 og etterrunden punkta 1 og 4). Det er den einaste staden eksporten blir lasta ned frå, og sida startar ikkje ein ny kontroll.
@@ -265,15 +270,15 @@ Alle lagra kontrollar blir lesne, ikkje berre den nyaste. Like varsel (same `cod
- Resultat med meir enn éin verdi per innsending ligg i éi celle som `SeedSigner: VULNERABLE; Sparrow Wallet: SECURE`. - Resultat med meir enn éin verdi per innsending ligg i éi celle som `SeedSigner: VULNERABLE; Sparrow Wallet: SECURE`.
- Statusverdiane blir skrivne slik dei er lagra. `0`/`1` blir skrivne som `No`/`Yes`. - Statusverdiane blir skrivne slik dei er lagra. `0`/`1` blir skrivne som `No`/`Yes`.
- Ei tekstcelle som eit rekneark ville lese som ein formel — `=`, `+`, `-`, `@` eller eit kontrollteikn, òg etter leiande mellomrom — får ein leiande apostrof, slik at ho blir tekst. Kolonnenamna, kolonnerekkjefølgja og alle vanlege verdiar er uendra. - Ei tekstcelle som eit rekneark ville lese som ein formel — `=`, `+`, `-`, `@` eller eit kontrollteikn, òg etter leiande mellomrom — får ein leiande apostrof, slik at ho blir tekst. Kolonnenamna, kolonnerekkjefølgja og alle vanlege verdiar er uendra.
- Nøkkelnamnet og nøkkeltypen kjem frå oppsettet, og namnet er namnet nøkkelen har no. - Nøkkelnamnet og nøkkeltypen kjem frå snapshottet på kontrollen, so ei rotering eller ei omdøyping kan ikkje skrive om ei eldre rad (§32.8 punkt 5).
- Nedlastinga heiter `YYYY-MM-DD-vardkey-export.csv`, med datoen serveren har når han svarar. - Nedlastinga heiter `YYYY-MM-DD-vardkey-export.csv`, med datoen serveren har når han svarar.
- Siste kolonne, `Follow-up closed`, listar varsla som vart lukka på kontrollen, som `code: action (YYYY-MM-DD)`. Berre lukkingar som høyrer til ein nøkkel, blir viste. - Siste kolonne, `Follow-up closed`, listar alle varsla som vart lukka på kontrollen, som `code: action (YYYY-MM-DD)`, anten dei høyrer til ein nøkkel eller til ei programvare i innstillingslista (§32.8 punkt 6).
--- ---
# 11. Backend # 11. Backend
- SQLite med initialisering og migrering. Skjemaet er versjon 12. - SQLite med initialisering og migrering. Skjemaet er versjon 13.
- Lagring av nøklar, health checks, historikk og rapporteksport. - Lagring av nøklar, health checks, historikk og rapporteksport.
- Varsellogikken (§7). - Varsellogikken (§7).
- Health endpoint, som er det einaste endepunktet utanfor innlogginga. - Health endpoint, som er det einaste endepunktet utanfor innlogginga.
@@ -289,14 +294,14 @@ Minimumsendepunkt: `GET /health`, `GET /api/keys`, `GET /api/health-checks`, `GE
- `POST /api/setup` lagrar multisig-tala og nøkkeloppsettet éin gong med namn, type, modell og adressesti, og avviser eit nytt oppsett med `409`. - `POST /api/setup` lagrar multisig-tala og nøkkeloppsettet éin gong med namn, type, modell og adressesti, og avviser eit nytt oppsett med `409`.
- `POST /api/setup`, `POST /api/settings/keys` og `POST /api/keys/<id>/rotate` avviser ein adressesti som ein annan nøkkel alt har (`400` i oppsettet og roteringa, `409` i innstillingane). Samanlikninga er kanonisk, sjå §4. - `POST /api/setup`, `POST /api/settings/keys` og `POST /api/keys/<id>/rotate` avviser ein adressesti som ein annan nøkkel alt har (`400` i oppsettet og roteringa, `409` i innstillingane). Samanlikninga er kanonisk, sjå §4.
- `GET /api/settings` gjev nøklane med adressestien og modellen deira og lista over wallet-programvare. - `GET /api/settings` gjev nøklane med adressestien og modellen deira og lista over wallet-programvare.
- `POST /api/settings/keys` lagrar eit nytt namn og ein modell, og ein adressesti så lenge nøkkelen ikkje har nokon lagra kontroll. Typen er aldri med i payloaden. - `POST /api/settings/keys` lagrar eit nytt namn og ein modell, og ein adressesti så lenge nøkkelen ikkje har nokon lagra kontroll. Typen er aldri med i payloaden. Han skriv den aktive rada på plass, so han er ei omdøyping og ikkje ei rotering.
- `POST /api/settings/wallet-software` lagrar heile lista, og lukkar varsla til ei programvare som blir fjerna. - `POST /api/settings/wallet-software` lagrar heile lista, og lukkar varsla til ei programvare som blir fjerna.
- `POST /api/keys/<id>/rotate` roterer ein nøkkel med ein ny, unik adressesti, kan gi nøkkelen den andre typen, og kvitterer ut varsla hans. - `POST /api/keys/<id>/rotate` roterer ein nøkkel med ein ny, unik adressesti, kan gi nøkkelen den andre typen, og kvitterer ut varsla hans. Roteringa legg til **ei ny rad** i `keys` med same `key_number`, merkjer den gamle rada som inaktiv og set `rotated_at` på henne, medan kvitteringane blir skrivne på den gamle rada, som er den rada varsla høyrer til (§32.8 punkt 5).
- `POST /api/keys/<id>/rotate` avviser med `409` ein typeendring som ville gjort nøkkelen til ein cloud-nøkkel under eit namn som wallet-programvare-lista alt har. - `POST /api/keys/<id>/rotate` avviser med `409` ein typeendring som ville gjort nøkkelen til ein cloud-nøkkel under eit namn som wallet-programvare-lista alt har.
- `POST /api/alerts/acknowledge` kvitterer ut eit varsel med `code`, `source` og handlinga som lukkar det. - `POST /api/alerts/acknowledge` kvitterer ut eit varsel med `code`, `source` og handlinga som lukkar det.
- `POST /api/login` avgrensar feila forsøk: etter fem mislukka forsøk på rad blir vidare innloggingar avviste i 15 minutt med `429` og ei melding som seier kor lenge det står att. Eit rett passord i låseperioden blir òg avvist, så svaret røpar ikkje om passordet var rett, og eit vellukka innlogging nullstiller teljaren. Teljaren ligg i `app_settings`, så han overlever ein restart. `POST /api/admin`, den lokale bootstrapen, blir ikkje avgrensa (§32.8 punkt 2). - `POST /api/login` avgrensar feila forsøk: etter fem mislukka forsøk på rad blir vidare innloggingar avviste i 15 minutt med `429` og ei melding som seier kor lenge det står att. Eit rett passord i låseperioden blir òg avvist, så svaret røpar ikkje om passordet var rett, og eit vellukka innlogging nullstiller teljaren. Teljaren ligg i `app_settings`, så han overlever ein restart. `POST /api/admin`, den lokale bootstrapen, blir ikkje avgrensa (§32.8 punkt 2).
- `GET /api/health-checks/<id>` gjev òg `closed_alerts`, lukkingane som høyrer til kontrollen, og kvart nøkkelrecord ber `model` i tillegg til felta det alt hadde, så historia kan vise modellen saman med firmware-versjonen (runden 32.1). Feltet kjem i tillegg, og dei eksisterande namna er uendra. - `GET /api/health-checks/<id>` gjev òg `closed_alerts`, alle lukkingane som høyrer til kontrollen — både dei som høyrer til ein nøkkel og dei som høyrer til ei programvare i innstillingslista (§32.8 punkt 6) — og kvart nøkkelrecord ber `model` i tillegg til felta det alt hadde, så historia kan vise modellen saman med firmware-versjonen (runden 32.1). Felta kjem i tillegg, og dei eksisterande namna er uendra.
- `GET /api/health-checks` gjev kvar oppsummering med dei same felta som før, og i tillegg `key_names` (namnet kvar nøkkel i kontrollen har no, i same rekkjefølgje som `key_numbers`) og `needs_follow_up` (om kontrollen reiste noko å følgje opp, rekna ut av varselreglane i §7, og ein eigenskap ved den lagra kontrollen — han endrar seg ikkje når brukaren lukkar varselet seinare). Felta kjem i tillegg, sjå §32.2 punkt 14. - `GET /api/health-checks` gjev kvar oppsummering med dei same felta som før, og i tillegg `key_names` (namnet kvar nøkkel vart lagra med på kontrollen, lese frå snapshottet, i same rekkjefølgje som `key_numbers`) og `needs_follow_up` (om kontrollen reiste noko å følgje opp, rekna ut av varselreglane i §7, og ein eigenskap ved den lagra kontrollen — han endrar seg ikkje når brukaren lukkar varselet seinare). Felta kjem i tillegg, sjå §32.2 punkt 14 og §32.8 punkt 5.
- Feilkodar: ugyldig payload `400`, ukjend nøkkel eller varsel `404`, låst eller duplikat adressesti `409`, øydelagd database `500`, manglande eller ugyldig sesjon `401`, manglande eller ugyldig CSRF-token `403`, og for mange feila innloggingsforsøk på rad `429` (§32.8 punkt 2). Eit fritekstfelt som ser ut som ei wallet-løyndom er òg ein `400` (sjå §15). - Feilkodar: ugyldig payload `400`, ukjend nøkkel eller varsel `404`, låst eller duplikat adressesti `409`, øydelagd database `500`, manglande eller ugyldig sesjon `401`, manglande eller ugyldig CSRF-token `403`, og for mange feila innloggingsforsøk på rad `429` (§32.8 punkt 2). Eit fritekstfelt som ser ut som ei wallet-løyndom er òg ein `400` (sjå §15).
- `_send_security_headers()` legg `X-Robots-Tag: noindex, nofollow` på kvart svar — sider, JSON, redirect, CSV og statiske filer — så indekseringssperra står i éin stad (§32.7 punkt 6). - `_send_security_headers()` legg `X-Robots-Tag: noindex, nofollow` på kvart svar — sider, JSON, redirect, CSV og statiske filer — så indekseringssperra står i éin stad (§32.7 punkt 6).
@@ -422,7 +427,7 @@ Unngå: Postgres, Redis, ekstern backend, ekstern cloud-service for appdata, og
- Test at ei rotering legg til ei ny rad i `keys` med same `key_number`, at den gamle rada blir inaktiv, og at eldre kontrollar held på namnet og typen dei vart lagra med (§32.8 punkt 5). - Test at ei rotering legg til ei ny rad i `keys` med same `key_number`, at den gamle rada blir inaktiv, og at eldre kontrollar held på namnet og typen dei vart lagra med (§32.8 punkt 5).
- Test at ein cloud-nøkkel med `COMPROMISED` ikkje får eit nytt programvarevarsel når nøkkelen blir rotert eller omdøypt, og at lukka programvarevarsel viser seg i historia og i CSV-en (§32.8 punkt 6). - Test at ein cloud-nøkkel med `COMPROMISED` ikkje får eit nytt programvarevarsel når nøkkelen blir rotert eller omdøypt, og at lukka programvarevarsel viser seg i historia og i CSV-en (§32.8 punkt 6).
**Merk:** dei manuelle nettlesartestane er køyrde og verifiserte fram til §31. §32 legg til nye manuelle punkt: ikonet (32.1), UI-pussen og retro-temaet på ein smal telefon (32.2), og ein kikk på varsellista, nøkkelkortet og sperre-noten i skjemaet etter tekstendringane i 32.3. Etter runden 32.1/32.2 kjem òg: footeren på ei kort side, faviconet i fana, merket i topplinja, installasjon av PWA-en med dei to PNG-ikona, og history-visninga med dei tre tabell- og linjeendringane. §32.7 la til menyen i topplinja og det rydda dashbordet, med `Download CSV` og noten i sin eigen `Export`-seksjon på history-sida, og hoppet til `#history-detail`. §32.8 legg til den manuelle ende-til-ende-gjennomgangen i punkt 7, og dei nye manuelle punkta: at appen ikkje startar før adminpassordet er sett (punkt 1), at innlogginga blir låst etter fem feil forsøk (punkt 2), at ein framtidsdato blir avvist (punkt 3), at topplinja held seg på plass (punkt 4), og at ei rotering ikkje endrar eldre historikk (punkt 5). **Merk:** dei manuelle nettlesartestane er køyrde og verifiserte fram til §31. §32 legg til nye manuelle punkt: ikonet (32.1), UI-pussen og retro-temaet på ein smal telefon (32.2), og ein kikk på varsellista, nøkkelkortet og sperre-noten i skjemaet etter tekstendringane i 32.3. Etter runden 32.1/32.2 kjem òg: footeren på ei kort side, faviconet i fana, merket i topplinja, installasjon av PWA-en med dei to PNG-ikona, og history-visninga med dei tre tabell- og linjeendringane. §32.7 la til menyen i topplinja og det rydda dashbordet, med `Download CSV` og noten i sin eigen `Export`-seksjon på history-sida, og hoppet til `#history-detail`. §32.8 legg til den manuelle ende-til-ende-gjennomgangen i punkt 7, og dei nye manuelle punkta: at appen ikkje startar før adminpassordet er sett (punkt 1), at innlogginga blir låst etter fem feil forsøk (punkt 2), at ein framtidsdato blir avvist (punkt 3), at topplinja held seg på plass (punkt 4), at ei rotering ikkje endrar eldre historikk (punkt 5), og at lukka programvarevarsel står i historia og i CSV-en (punkt 6).
## StartOS-test ## StartOS-test
@@ -508,7 +513,7 @@ Alle rundane under er implementerte og verifiserte. Reglane deira ligg i §1–
| §25 | Adressestien som identitet, rotering, varselkvittering og innstillingar. | | §25 | Adressestien som identitet, rotering, varselkvittering og innstillingar. |
| §26 | Sperring av ein nøkkel med ope varsel (`409`), unike adressestiar, og eigne lukkehandlingar per varselkode. | | §26 | Sperring av ein nøkkel med ope varsel (`409`), unike adressestiar, og eigne lukkehandlingar per varselkode. |
| §27 | Varselhandlingane i historikk og CSV, kontaktvarselet som eit nøkkelvarsel, og dei to formene av `software_incompatible`. Skjema 11. | | §27 | Varselhandlingane i historikk og CSV, kontaktvarselet som eit nøkkelvarsel, og dei to formene av `software_incompatible`. Skjema 11. |
| §28 | Nøkkeltypen kan berre endrast ved ei rotering, og namnet blir endra i roteringsseksjonen. | | §28 | Nøkkeltypen kan berre endrast ved ei rotering, og namnet blir endra i roteringsseksjonen. Frå §32.8 legg ei rotering til ei ny rad i `keys` og pensjonerer den gamle, i staden for å skrive om henne. |
| §29 | Namnebyte til **VardKey**, med beskrivinga «Bitcoin Multisig Health Monitor», databasefila `data/vardkey.sqlite3` og eksportfila `vardkey-export.csv`. | | §29 | Namnebyte til **VardKey**, med beskrivinga «Bitcoin Multisig Health Monitor», databasefila `data/vardkey.sqlite3` og eksportfila `vardkey-export.csv`. |
| §30 | StartOS 0.4.0-pakka: `id: 'vardkey'`, `volumes: ['main']`, `GPL-3.0-only`, bygd og verifisert på boksen. Pakkeversjonen startar på `0.1.0:0`. | | §30 | StartOS 0.4.0-pakka: `id: 'vardkey'`, `volumes: ['main']`, `GPL-3.0-only`, bygd og verifisert på boksen. Pakkeversjonen startar på `0.1.0:0`. |
| §31 | Dei sju punkta før versjon 1: fleksibel terskel (skjema 12), modell/teneste per nøkkel, adressestien på nøkkelkortet, datert CSV-namn, sletting av all data, adminpassord med sesjon og CSRF, og ein installerbar PWA utan offline-data. | | §31 | Dei sju punkta før versjon 1: fleksibel terskel (skjema 12), modell/teneste per nøkkel, adressestien på nøkkelkortet, datert CSV-namn, sletting av all data, adminpassord med sesjon og CSRF, og ein installerbar PWA utan offline-data. |
@@ -517,9 +522,9 @@ Alle rundane under er implementerte og verifiserte. Reglane deira ligg i §1–
# 32. Det som står att # 32. Det som står att
Att står **§32.8** (sju punkt), **§32.6 dokumentasjonsdrifta** og **§32.5 hevinga av pakkeversjonen**, i den rekkjefølgja, og alle **før** pakkeversjonen blir heva frå `0.1.0:0` til `1.0.0:0`. §32.1–§32.4 og §32.7 er utførte og verifiserte, og står nedanfor som korte punktlister, slik at §-referansane i koden held. Eit punkt skal ikkje startast utan at brukaren ber om det. Att står **§32.8 punkt 7**, **§32.6 dokumentasjonsdrifta** og **§32.5 hevinga av pakkeversjonen**, i den rekkjefølgja, og alle **før** pakkeversjonen blir heva frå `0.1.0:0` til `1.0.0:0`. §32.1–§32.4 og §32.7 er utførte og verifiserte, og står nedanfor som korte punktlister, slik at §-referansane i koden held. Eit punkt skal ikkje startast utan at brukaren ber om det.
**Status i §32:** §32.1 (ikonet), §32.2 (UI-passet med retro-temaet), §32.3 (varsel- og sidetekstane), §32.4 (bug-rapporten, rundane 32-A og 32-B) og §32.7 (dashboard-menyen og oppryddinga i dashbordet) er utførte, kvar med etterrunden sin. I §32.4 står berre **BR-003** att, og han er ei manuell ende-til-ende-verifisering som berre brukaren kan gjere — han er no punkt 7 i §32.8. I §32.8 er **steg A** (punkt 3, 4 og 2) og **steg B** (punkt 1) utførte; **steg C** (punkt 6 og 5) står att, og krev skjema **13**. §32.8 skal gjerast ferdig før §32.6, som skal skildre den utgåva som faktisk blir gitt ut, og §32.5 kjem til slutt. Den manuelle nettlesartesten av retro-temaet på ein smal telefon står att for brukaren, saman med dei nye manuelle punkta i etterrunden av §32.1 og §32.2, menyen og det rydda dashbordet, installasjonen av PWA-en med dei to PNG-ikona, dei nye manuelle punkta i §32.8, og den nye bokstesten i §32.5. **Status i §32:** §32.1 (ikonet), §32.2 (UI-passet med retro-temaet), §32.3 (varsel- og sidetekstane), §32.4 (bug-rapporten, rundane 32-A og 32-B) og §32.7 (dashboard-menyen og oppryddinga i dashbordet) er utførte, kvar med etterrunden sin. I §32.4 står berre **BR-003** att, og han er ei manuell ende-til-ende-verifisering som berre brukaren kan gjere — han er no punkt 7 i §32.8. I §32.8 er **steg A** (punkt 3, 4 og 2), **steg B** (punkt 1) og **steg C** (punkt 6 og 5) utførte, so skjemaet er no **versjon 13**; att står berre **punkt 7**. §32.8 skal gjerast ferdig før §32.6, som skal skildre den utgåva som faktisk blir gitt ut, og §32.5 kjem til slutt. Den manuelle nettlesartesten av retro-temaet på ein smal telefon står att for brukaren, saman med dei nye manuelle punkta i etterrunden av §32.1 og §32.2, menyen og det rydda dashbordet, installasjonen av PWA-en med dei to PNG-ikona, dei nye manuelle punkta i §32.8, og den nye bokstesten i §32.5.
## 32.1 Ikonet — utført ## 32.1 Ikonet — utført
@@ -636,15 +641,15 @@ Etterrunden (fire punkt frå brukaren sin gjennomgang), utan skjemaendring, utan
**Utførast før §32.6 og §32.5**, i denne rekkjefølgja: **steg A** (punkt 3, 4 og 2), **steg B** (punkt 1), **steg C** (punkt 6 og 5 saman, sidan begge krev skjema **13**), og til slutt **punkt 7**, som berre brukaren kan gjere. Inga nye endepunkt utanom den nye feilkoden `429`, inga ny avhengigheit, ingen nye dokument, og inga endring i CSV-avtalen utanom det som står i punkt 6. **Utførast før §32.6 og §32.5**, i denne rekkjefølgja: **steg A** (punkt 3, 4 og 2), **steg B** (punkt 1), **steg C** (punkt 6 og 5 saman, sidan begge krev skjema **13**), og til slutt **punkt 7**, som berre brukaren kan gjere. Inga nye endepunkt utanom den nye feilkoden `429`, inga ny avhengigheit, ingen nye dokument, og inga endring i CSV-avtalen utanom det som står i punkt 6.
**Status:** **steg A** (punkt 3, 4 og 2) og **steg B** (punkt 1) er utførte. **Steg C** (punkt 6 og 5) står att. **Status:** **steg A** (punkt 3, 4 og 2), **steg B** (punkt 1) og **steg C** (punkt 6 og 5) er utførte. Att står berre **punkt 7**, som berre brukaren kan gjere.
- [x] **1. Appen skal ikkje starte før adminpassordet er sett.** Pakka skal halde servicen tilbake til admin finst: ei påkravd StartOS-oppgåve (task) som køyrer `maintenance.py set-admin-password` i ein `withTemp`-subcontainer, og som StartOS ikkje lèt brukaren hoppe over. Passordet blir framleis generert **inne i containeren** og skrive ut éin gong — ingenting går frå verten inn i containeren som argument eller på stdin, slik at den eksisterande tryggleiksmodellen held. `startos/main.ts` sin readiness-sjekk mot `/health` står uendra. På app-sida er gatinga som alt finst nok: utan admin svarar `/api/*` `401`, sidene svarar `302` til `/login`, og `/login` viser berre loginsteget og opprett-admin-skjemaet. Det skjemaet er **den lokale bootstrapen** for `python3 app.py`, og blir verken utvida eller fjerna i denne runden; i pakka er han uoppnåeleg fordi servicen ikkje køyrer. Risiko: task-API-et i `@start9labs/start-sdk` 3.0.4 må stadfestast mot SDK-en eller pakkeleiingi før det blir brukt; kan det ikkje stadfestast, blir berre app-sida gjord ferdig, og det blir rapportert. `make x86` køyrer brukaren. **Utført**: task-API-et vart stadfesta mot dei publiserte typane i 3.0.4 (`sdk.action.createOwnTask` / `createTask` / `sdk.action.clearTask`, `effects.action.clearTasks`, `TaskSeverity = 'optional' | 'important' | 'critical'`, `createTask` svarar `null`) og mot SDK-en si eiga `setupPrimaryUrl.setupTask`-implementering. `startos/init/requireAdmin.ts` held oppgåva `Set Admin Password` oppe med `severity: 'important'` medan databasen ikkje har nokon admin, og lukkar henne att når han finst. Oppgåva peikar på den eksisterande handlinga. Sidan SDK 3.0.4 berre har `TaskCondition = 'input-not-matches'`, finst det ikkje noko vilkår for «adminpassordet er ikkje sett», so heving og lukking skjer i init-skriptet. Proben som les `app_settings` (readonly, i ein `withTemp`-subcontainer) **feilar ope**. `tsc --noEmit`, `prettier --check startos` og `make x86` er grøne hjå brukaren. **At oppgåva faktisk held servicen tilbake, og forsvinn når handlinga er køyrd, er framleis ustadfesta og ligg i punkt 7.** - [x] **1. Appen skal ikkje starte før adminpassordet er sett.** Pakka skal halde servicen tilbake til admin finst: ei påkravd StartOS-oppgåve (task) som køyrer `maintenance.py set-admin-password` i ein `withTemp`-subcontainer, og som StartOS ikkje lèt brukaren hoppe over. Passordet blir framleis generert **inne i containeren** og skrive ut éin gong — ingenting går frå verten inn i containeren som argument eller på stdin, slik at den eksisterande tryggleiksmodellen held. `startos/main.ts` sin readiness-sjekk mot `/health` står uendra. På app-sida er gatinga som alt finst nok: utan admin svarar `/api/*` `401`, sidene svarar `302` til `/login`, og `/login` viser berre loginsteget og opprett-admin-skjemaet. Det skjemaet er **den lokale bootstrapen** for `python3 app.py`, og blir verken utvida eller fjerna i denne runden; i pakka er han uoppnåeleg fordi servicen ikkje køyrer. Risiko: task-API-et i `@start9labs/start-sdk` 3.0.4 må stadfestast mot SDK-en eller pakkeleiingi før det blir brukt; kan det ikkje stadfestast, blir berre app-sida gjord ferdig, og det blir rapportert. `make x86` køyrer brukaren. **Utført**: task-API-et vart stadfesta mot dei publiserte typane i 3.0.4 (`sdk.action.createOwnTask` / `createTask` / `sdk.action.clearTask`, `effects.action.clearTasks`, `TaskSeverity = 'optional' | 'important' | 'critical'`, `createTask` svarar `null`) og mot SDK-en si eiga `setupPrimaryUrl.setupTask`-implementering. `startos/init/requireAdmin.ts` held oppgåva `Set Admin Password` oppe med `severity: 'important'` medan databasen ikkje har nokon admin, og lukkar henne att når han finst. Oppgåva peikar på den eksisterande handlinga. Sidan SDK 3.0.4 berre har `TaskCondition = 'input-not-matches'`, finst det ikkje noko vilkår for «adminpassordet er ikkje sett», so heving og lukking skjer i init-skriptet. Proben som les `app_settings` (readonly, i ein `withTemp`-subcontainer) **feilar ope**. `tsc --noEmit`, `prettier --check startos` og `make x86` er grøne hjå brukaren. **At oppgåva faktisk held servicen tilbake, og forsvinn når handlinga er køyrd, er framleis ustadfesta og ligg i punkt 7.**
- [x] **2. Avgrensing av feila innloggingsforsøk.** Etter **5** mislukka `POST /api/login` på rad blir vidare innloggingar avviste i **15 minutt** med den nye statuskoden `429` og ei melding som seier kor lenge det står att. Eit rett passord i låseperioden blir òg avvist, så svaret røpar ikkje om passordet var rett. Ei vellukka innlogging nullstiller teljaren. Teljaren ligg i `app_settings` (`failed_login_count`, `failed_login_until`), så han overlever ein restart. Inga IP-basert logikk: StartOS proxyar alt, og appen les medvite ikkje `X-Forwarded-*`. `POST /api/admin` (den lokale bootstrapen) blir ikkje avgrensa. `429` skal inn i feilkodelista i §11. **Utført** i `app.py` (`_login()` og hjelparane `lockout_seconds_left()`, `register_failed_login()`, `clear_failed_logins()`, `lockout_message()`), med `failed_login_count` / `failed_login_until` i §4 og `429` i feilkodelista i §11. Testar: fem feil → `429` på den femte, rett passord i låseperioden òg `429`, nullstilling ved vellukka innlogging, og at `POST /api/admin` ikkje blir avgrensa. - [x] **2. Avgrensing av feila innloggingsforsøk.** Etter **5** mislukka `POST /api/login` på rad blir vidare innloggingar avviste i **15 minutt** med den nye statuskoden `429` og ei melding som seier kor lenge det står att. Eit rett passord i låseperioden blir òg avvist, så svaret røpar ikkje om passordet var rett. Ei vellukka innlogging nullstiller teljaren. Teljaren ligg i `app_settings` (`failed_login_count`, `failed_login_until`), så han overlever ein restart. Inga IP-basert logikk: StartOS proxyar alt, og appen les medvite ikkje `X-Forwarded-*`. `POST /api/admin` (den lokale bootstrapen) blir ikkje avgrensa. `429` skal inn i feilkodelista i §11. **Utført** i `app.py` (`_login()` og hjelparane `lockout_seconds_left()`, `register_failed_login()`, `clear_failed_logins()`, `lockout_message()`), med `failed_login_count` / `failed_login_until` i §4 og `429` i feilkodelista i §11. Testar: fem feil → `429` på den femte, rett passord i låseperioden òg `429`, nullstilling ved vellukka innlogging, og at `POST /api/admin` ikkje blir avgrensa.
- [x] **3. Ingen kontroll-dato i framtida.** `checked_at` må vere dagens dato eller tidlegare. Grensa blir handheva på serveren i `validation.py` og gjev `400` med ei tydeleg melding, og date-feltet i skjemaet får `max` sett til dagens lokale dato i `health-check.js`. `next_check_due` er uendra (eitt kalenderår etter sjekkdatoen). §6 steg 1 blir oppdatert. **Utført** i `_date()` i `validation.py` og i `setCheckDate()` i `static/health-check.js`. Testar: i morgon → `400`, i dag og ein eldre dato → `201`. - [x] **3. Ingen kontroll-dato i framtida.** `checked_at` må vere dagens dato eller tidlegare. Grensa blir handheva på serveren i `validation.py` og gjev `400` med ei tydeleg melding, og date-feltet i skjemaet får `max` sett til dagens lokale dato i `health-check.js`. `next_check_due` er uendra (eitt kalenderår etter sjekkdatoen). §6 steg 1 blir oppdatert. **Utført** i `_date()` i `validation.py` og i `setCheckDate()` i `static/health-check.js`. Testar: i morgon → `400`, i dag og ein eldre dato → `201`.
- [x] **4. Topplinja fest til toppen.** `.topbar` i `static/styles.css` blir `position: sticky; top: 0` med ein `z-index` som held ho over sideinnhaldet og under meny-panelet, så ho blir verande synleg når ein scrollar. Utan inline stil (CSP), og utan `border-radius`, `box-shadow` eller gradient (retro-temaet i §32.2). §12 blir oppdatert. **Utført**: `.topbar` er `position: sticky; top: 0; z-index: 5`, og meny-panelet held sitt `z-index: 10`. - [x] **4. Topplinja fest til toppen.** `.topbar` i `static/styles.css` blir `position: sticky; top: 0` med ein `z-index` som held ho over sideinnhaldet og under meny-panelet, så ho blir verande synleg når ein scrollar. Utan inline stil (CSP), og utan `border-radius`, `box-shadow` eller gradient (retro-temaet i §32.2). §12 blir oppdatert. **Utført**: `.topbar` er `position: sticky; top: 0; z-index: 5`, og meny-panelet held sitt `z-index: 10`.
- [ ] **5. Rotering gir ny nøkkelrad, og historia blir frosen.** Ei rotering skal ikkje lenger skrive om den eksisterande nøkkelrada. Ho legg til **ei ny rad** i `keys` med **same `key_number`** (multisig-plassen), den nye typen, den nye adressestien, namnet og modellen, og merkjer den gamle rada som inaktiv. Eldre kontrollar peikar framleis på den gamle rada, og kvar kontroll lagrar i tillegg eit **snapshot** av namnet, typen og modellen slik dei var då kontrollen vart lagra, så korkje ei rotering eller ei omdøyping kan endre eldre historikk. Krev **skjema 13**: `UNIQUE` på `keys.key_number` blir fjerna og erstatta av eit delvis unikt indeks på `key_number` der rada er aktiv, `keys` får eit aktiv-flagg og eit `rotated_at`, og `key_checks` får snapshot-kolonnane. Migreringa følgjer mønsteret i §21 (ombygging, `PRAGMA foreign_key_check` før commit, og ein test med eit bokstaveleg `SCHEMA_VERSION_12`), og backfyller snapshottet frå den kopla `keys`-rada, så eksisterande historikk held namnet han har ved migreringa. Alle spørringar som i dag les «nøkkelen» (`list_keys`, `list_key_status`, `list_previous_values`, oppsettet, innstillingane, skjemaet, dashboardet, roteringa) skal lese den **aktive** rada, medan historikk, CSV og varsel skal lese snapshottet. §4, §9, §10, §11 og §28 blir oppdaterte. - [x] **5. Rotering gir ny nøkkelrad, og historia blir frosen.** Ei rotering skal ikkje lenger skrive om den eksisterande nøkkelrada. Ho legg til **ei ny rad** i `keys` med **same `key_number`** (multisig-plassen), den nye typen, den nye adressestien, namnet og modellen, og merkjer den gamle rada som inaktiv. Eldre kontrollar peikar framleis på den gamle rada, og kvar kontroll lagrar i tillegg eit **snapshot** av namnet, typen og modellen slik dei var då kontrollen vart lagra, så korkje ei rotering eller ei omdøyping kan endre eldre historikk. Krev **skjema 13**: `UNIQUE` på `keys.key_number` blir fjerna og erstatta av eit delvis unikt indeks på `key_number` der rada er aktiv, `keys` får eit aktiv-flagg og eit `rotated_at`, og `key_checks` får snapshot-kolonnane. Migreringa følgjer mønsteret i §21 (ombygging, `PRAGMA foreign_key_check` før commit, og ein test med eit bokstaveleg `SCHEMA_VERSION_12`), og backfyller snapshottet frå den kopla `keys`-rada, så eksisterande historikk held namnet han har ved migreringa. Alle spørringar som i dag les «nøkkelen» (`list_keys`, `list_key_status`, `list_previous_values`, oppsettet, innstillingane, skjemaet, dashboardet, roteringa) skal lese den **aktive** rada, medan historikk, CSV og varsel skal lese snapshottet. §4, §9, §10, §11 og §28 blir oppdaterte. **Utført** i `database.py` (`SCHEMA_VERSION = 13`, `KEYS_TABLE` med `active` og `rotated_at` og utan `UNIQUE` på `key_number`, det delvise indekset `idx_keys_active_key_number … WHERE active = 1`, snapshot-kolonnane i `KEY_CHECKS_TABLE`, `_migrate_keys()`, `_backfill_key_check_snapshots()`, `rotate_key()`, og `active = 1`-filteret i `list_keys()`, `list_key_status()` og `list_previous_values()`), i `app.py` (`_rotate_key()` kallar no `rotate_key()`, kvitteringane blir framleis skrivne på den gamle nøkkel-id-en, og `_send_health_check_list()` les `key_names` frå snapshottet på kontrollen), og i `database.py` sine lesarar for historikk og CSV (`get_health_check()` og `list_export_rows()` les snapshotet). §4, §9, §10, §11 og §28 er oppdaterte. Testar: `tests/test_database.py` har `SCHEMA_VERSION_12` med eit bokstaveleg eldre skjema og dekkjer snapshot-backfillen og det delvise indekset; `tests/test_app.py` pinnar at roteringa legg til ei ny aktiv rad med same `key_number` medan den gamle blir inaktiv, at ein kontroll kan registrerast på den nye rada, at historia er frosen etter både rotering og omdøyping, og at `key_names` kjem frå snapshottet; `tests/test_export.py` pinnar at ei eldre eksportrad held nøkkelnamnet og -typen sin.
- [ ] **6. KI-kjelda kan ikkje flippe, og lukka programvarevarsel kjem i historia.** Kvar rad i `ai_security_checks` får `key_id` (nullable), sett til den kontrollerte nøkkelen når leverandøren er nøkkelen sitt eige konfigurerte namn. Då blir kjelda til eit KI-varsel avgjord av rada sjølv, ikkje av ei samanlikning med namna som er konfigurerte no, og ein cloud-nøkkel som blir rotert eller omdøypt kan ikkje lenger gi eit nytt programvarevarsel ved sida av det nøkkelvarsla som roteringa alt lukka. Samstundes skal lukka **programvarevarsel** òg visast i historia og i CSV-en, ikkje berre lukkingar som høyrer til ein nøkkel: `app.closed_alerts()` og `database._grouped_closures()` sluttar å filtrere på `key_id IS NOT NULL`, og lukkinga blir framleis knytt til kontrollen sin gjennom `check_id`. Krev skjema 13 (same migrering som punkt 5). §7, §9 og §10 blir oppdaterte. - [x] **6. KI-kjelda kan ikkje flippe, og lukka programvarevarsel kjem i historia.** Kvar rad i `ai_security_checks` får `key_id` (nullable), sett til den kontrollerte nøkkelen når leverandøren er nøkkelen sitt eige konfigurerte namn. Då blir kjelda til eit KI-varsel avgjord av rada sjølv, ikkje av ei samanlikning med namna som er konfigurerte no, og ein cloud-nøkkel som blir rotert eller omdøypt kan ikkje lenger gi eit nytt programvarevarsel ved sida av det nøkkelvarsla som roteringa alt lukka. Samstundes skal lukka **programvarevarsel** òg visast i historia og i CSV-en, ikkje berre lukkingar som høyrer til ein nøkkel: `app.closed_alerts()` og `database._grouped_closures()` sluttar å filtrere på `key_id IS NOT NULL`, og lukkinga blir framleis knytt til kontrollen sin gjennom `check_id`. Krev skjema 13 (same migrering som punkt 5). §7, §9 og §10 blir oppdaterte. **Utført** i `database.py` (`ai_security_checks.key_id` i `AI_SECURITY_CHECKS_TABLE` og i `OPTIONAL_COLUMNS`, `save_health_check()` set han når leverandøren er nøkkelen sitt eige namn, og `_grouped_closures()` filtrerer berre på `check_id IS NOT NULL`), i `alerts.py` (`_security_alerts()` slår opp rada sin eigen `key_id` i staden for å samanlikne leverandøren med dei konfigurerte namna; `cloud_names` gjeld framleis `software_incompatible`) og i `app.py` (`closed_alerts()` filtrerer ikkje lenger, og docstringane i `_send_health_check_list()` og `_send_health_check()` seier det same som koden). §7, §9 og §10 er oppdaterte. Testar: `tests/test_alerts.py` byggjer KI-kjelda på rada si eiga `key_id` og pinnar at ein cloud-nøkkel med `COMPROMISED` ikkje får eit nytt programvarevarsel etter rotering eller omdøyping; `tests/test_app.py` pinnar at eit lukka programvarevarsel blir lista saman med eit lukka nøkkelvarsel; `tests/test_database.py` og `tests/test_export.py` pinnar at det står i siste kolonne i CSV-en.
- [ ] **7. BR-003 — den manuelle ende-til-ende-gjennomgangen.** Berre brukaren kan gjere denne, og ho blir ikkje rekna som gjord før brukaren seier det. Ho dekkjer: første oppsett og obligatorisk oppretting av admin; login og logout; utløpt eller ugyldig sesjon; direkte API-kall utan innlogging; ein full kontroll og CSV-eksport; ein alternativ terskel og eit anna nøkkeltal; sletting av data med stadfesting; restart, backup og restore; og PWA offline og online, òg etter logout. Punkta over legg til: at appen ikkje startar før adminpassordet er sett (punkt 1), at innlogginga blir låst etter fem feil forsøk (punkt 2), at ein framtidsdato blir avvist (punkt 3), at topplinja held seg på plass (punkt 4), og at ei rotering ikkje endrar eldre historikk (punkt 5). - [ ] **7. BR-003 — den manuelle ende-til-ende-gjennomgangen.** Berre brukaren kan gjere denne, og ho blir ikkje rekna som gjord før brukaren seier det. Ho dekkjer: første oppsett og obligatorisk oppretting av admin; login og logout; utløpt eller ugyldig sesjon; direkte API-kall utan innlogging; ein full kontroll og CSV-eksport; ein alternativ terskel og eit anna nøkkeltal; sletting av data med stadfesting; restart, backup og restore; og PWA offline og online, òg etter logout. Punkta over legg til: at appen ikkje startar før adminpassordet er sett (punkt 1), at innlogginga blir låst etter fem feil forsøk (punkt 2), at ein framtidsdato blir avvist (punkt 3), at topplinja held seg på plass (punkt 4), at ei rotering ikkje endrar eldre historikk (punkt 5), og at lukka programvarevarsel står i historia og i CSV-en (punkt 6).
**Kva spec-seksjonar som må oppdaterast når punkta landar:** §4, §6, §7, §9, §10, §11, §12, §13 og §28, pluss skjemanummeret i §11, `UPDATING.md` og `AGENTS.md` (det siste høyrer til §32.6). §32.6 si liste skal nemne dei nye punkta. **Kva spec-seksjonar som må oppdaterast når punkta landar:** §4, §6, §7, §9, §10, §11, §12, §13 og §28, pluss skjemanummeret i §11, `UPDATING.md` og `AGENTS.md` (det siste høyrer til §32.6). §32.6 si liste skal nemne dei nye punkta.
@@ -653,3 +658,5 @@ Etterrunden (fire punkt frå brukaren sin gjennomgang), utan skjemaendring, utan
**Steg A — utført.** Punkt 3, 4 og 2 er landa i `validation.py`, `static/health-check.js`, `static/styles.css` og `app.py`, med nye testar i `tests/test_app.py` og `tests/test_health_check_form.py`. Sju testar i `tests/test_app.py` som lagra framtidsdatoar for å teste «nyaste kontroll vinn», vart flytte inn i fortida i same endring, sidan grensa no avviser dei. `§6`, `§11` og `§12` er oppdaterte. Suiten står på **519 testar**. **Steg A — utført.** Punkt 3, 4 og 2 er landa i `validation.py`, `static/health-check.js`, `static/styles.css` og `app.py`, med nye testar i `tests/test_app.py` og `tests/test_health_check_form.py`. Sju testar i `tests/test_app.py` som lagra framtidsdatoar for å teste «nyaste kontroll vinn», vart flytte inn i fortida i same endring, sidan grensa no avviser dei. `§6`, `§11` og `§12` er oppdaterte. Suiten står på **519 testar**.
**Steg B — utført.** Punkt 1 er landa i `startos/init/requireAdmin.ts` (ny), `startos/init/index.ts`, `startos/i18n/dictionaries/default.ts` og `startos/i18n/dictionaries/translations.ts`, og §13 er oppdatert. Inga Python-fil og inga anna pakkefil er rørd, so Python-suiten står framleis på **519 testar**. `npx tsc --noEmit`, `prettier --check startos` og `make x86` er grøne. Det som står att av punkt 1, er bokstesten i punkt 7. **Steg B — utført.** Punkt 1 er landa i `startos/init/requireAdmin.ts` (ny), `startos/init/index.ts`, `startos/i18n/dictionaries/default.ts` og `startos/i18n/dictionaries/translations.ts`, og §13 er oppdatert. Inga Python-fil og inga anna pakkefil er rørd, so Python-suiten står framleis på **519 testar**. `npx tsc --noEmit`, `prettier --check startos` og `make x86` er grøne. Det som står att av punkt 1, er bokstesten i punkt 7.
**Steg C — utført.** Punkt 6 og 5 er landa i `alerts.py` (KI-kjelda kjem frå rada), `app.py` (roteringa legg til ei ny rad gjennom `rotate_key()`, kvitteringane blir skrivne på den gamle rada, `closed_alerts()` filtrerer ikkje lenger, og `key_names` kjem frå snapshottet), `database.py` (`_grouped_closures()` filtrerer berre på `check_id`) og `export.py` (module-docstringen). Skjemaet er **13**. Att står berre punkt 7. Testane i `tests/test_alerts.py`, `tests/test_export.py`, `tests/test_app.py` og `tests/test_database.py` er oppdaterte: åtte testar i `tests/test_alerts.py` bygde KI-kjelda på dei konfigurerte namna og er skrivne om, tre påstandar som sa at eit lukka programvarevarsel ikkje blir lista er snudde, og sju nye testar kom til. `tests/test_key_status.py` og `tests/test_health_check_form.py` vart grepa for kvar streng dei pinnar og trong inga endring, sidan inga fil dei les vart rørd. Suiten går frå **519** til **526 testar**, og brukaren stadfestar talet ved å køyre `python3 -m unittest discover -s tests` på Linux og på Windows-kopien.