diff --git a/TODO.md b/TODO.md index 1ff1862..dbdda99 100644 --- a/TODO.md +++ b/TODO.md @@ -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. - **§19–§32 er historikk.** Alle rundane der er ferdige og verifiserte, og står no som éi line kvar. Reglane deira ligg i §1–§18 og i `ai-note.md`, som er handoveren; den fulle grunngjevinga ligg i git-historikken. -- **§32 held berre det som står att:** punkt 7 i §32.8 (brukaren sin manuelle gjennomgang), §32.6 (dokumentasjonsdrifta) og §32.5 (hevinga av pakkeversjonen), i den rekkjefølgja. +- **§32 held berre det som står att:** §32.9 (to rettingar frå den manuelle gjennomgangen), §32.6 (dokumentasjonsdrifta) og §32.5 (hevinga av pakkeversjonen), i den rekkjefølgja. - **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. -- **Status:** alt til og med §32.8 er implementert og verifisert, punkt 7 inkludert. Skjemaet er **versjon 13**, suiten er **532 grøne testar**, og pakkeversjonen står på `0.1.0:0`. Han blir ikkje heva før §32.6 er ferdig og brukaren seier ifrå. StartOS-pakka er bygd, sideloda og køyrd på ein eigen StartOS 0.4.0-boks. +- **Status:** alt til og med §32.8, medrekna punkt 7, er implementert og verifisert. Skjemaet er **versjon 13**, suiten er **532 grøne testar**, og pakkeversjonen står på `0.1.0:0`. Han blir ikkje heva før §32 er ferdig og brukaren seier ifrå. StartOS-pakka er bygd, sideloda og køyrd på ein eigen StartOS 0.4.0-boks. --- @@ -121,11 +121,11 @@ 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. - `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. -- 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). +- 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). - `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. +- `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). +- `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). +- `failed_login_count` og `failed_login_until` i `app_settings` er innloggingsteljaren og sluttidspunktet for låsa (§32.8). 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. --- @@ -150,7 +150,7 @@ Stega følgjer seksjonane i skjemaet. ## Steg 1 — Schedule (01 / Schedule) - Brukaren trykkjer `Start årleg health check`, og dagens dato blir føreslått automatisk. -- Kontroll-datoen kan vere dagen i dag eller ein eldre dato, men ikkje ein dato i framtida: serveren avviser ein dato etter sin eigen dag med `400` og ei melding som seier det, og date-feltet i skjemaet har `max` sett til dagens lokale dato (§32.8 punkt 3). Ein kontroll som ikkje har skjedd enno, kan ikkje registrerast. +- Kontroll-datoen kan vere dagen i dag eller ein eldre dato, men ikkje ein dato i framtida: serveren avviser ein dato etter sin eigen dag med `400` og ei melding som seier det, og date-feltet i skjemaet har `max` sett til dagens lokale dato (§32.8). Ein kontroll som ikkje har skjedd enno, kan ikkje registrerast. - Neste sjekkdato blir rekna ut på serveren som eitt kalenderår etter sjekkdatoen, og kan ikkje redigerast i skjemaet. Grensa endrar ikkje den utrekninga. ## Steg 2 — Key (02 / Key) @@ -225,9 +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. - `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 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: ` 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). +- 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: ` 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). - 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). +- 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). - 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 om nøkkel utilgjengeleg, adressestifeil eller seed-backup gjeld berre den nøkkelen, og resten av nøkkelfelta kan ikkje registrerast. @@ -252,11 +252,11 @@ 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. - Gamle health checks blir aldri overskrivne. - Vis `Address path verified` som den utleidde verdien han er, og ikkje som eit brukarval. -- 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. 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 vart lagra med på kontrollen, og ein kort status: `All OK` eller `Needs follow-up` (§32.2 og §32.8 punkt 5). Det kjem frå `needs_follow_up` i oppsummeringa, som seier om kontrollen reiste noko å følgje opp. +- 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). +- Vis kva varsel som vart lukka på kontrollen, med kva handling og kva dato, og med kjelda si, så nøkkelforma og programvareforma av same `code` kan skiljast. Lukka programvarevarsel står i same liste som lukka nøkkelvarsel (§32.8 og §32.9). +- Kortet i lista viser datoen, nøkkelnummeret og namnet nøkkelen vart lagra med på kontrollen, og ein kort status: `All OK` når kontrollen ikkje reiste noko, `Needs follow-up` medan noko står ope, og eit tredje ord når alt er lukka (§32.2 og §32.9). Statusen seier kva som gjeld **no**, medan `needs_follow_up` på kontrollen er frosen (§11). - 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` (§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 (§32.1). +- Lukke-tabellen på ein kontroll viser `Alert`, `Action` og `Closed`, og kjelda til varselet (§32.9). - 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). Det er den einaste staden eksporten blir lasta ned frå, og sida startar ikkje ein ny kontroll. - `View` i lista opnar kontrollen på ankeret `#history-detail`, og det same gjer ei innsending frå skjemaet, så brukaren landar på kontrollen og ikkje på toppen av sida (§32.7). @@ -270,9 +270,9 @@ 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`. - 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. -- 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). +- 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). - Nedlastinga heiter `YYYY-MM-DD-vardkey-export.csv`, med datoen serveren har når han svarar. -- 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). +- 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). Kjelda til varselet står i same celle, så nøkkelforma og programvareforma av same `code` kan skiljast (§32.9). Kolonnenamnet og rekkjefølgja er uendra. --- @@ -296,13 +296,13 @@ Minimumsendepunkt: `GET /health`, `GET /api/keys`, `GET /api/health-checks`, `GE - `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. 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/keys//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//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). - `POST /api/keys//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/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/` 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 (§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 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 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). +- `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). +- `GET /api/health-checks/` 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) — og kvart nøkkelrecord ber `model` i tillegg til felta det alt hadde, så historia kan vise modellen saman med firmware-versjonen (§32.1). Felta kjem i tillegg, og dei eksisterande namna er uendra; lukkingane ber kjelda si (§32.9). +- `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 og §32.8. §32.9 legg til eit tredje felt som seier om kontrollen har noko ope **no**; `needs_follow_up` held fram uendra. +- 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). 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). --- @@ -316,10 +316,10 @@ Minimumsendepunkt: `GET /health`, `GET /api/keys`, `GET /api/health-checks`, `GE - Eige oppsettsteg ved første oppstart: terskel, talet på nøklar, og namn, type, modell og adressesti per nøkkel. - Eit innloggingssteg framfor alt anna, og eit opprett-admin-steg når ingen admin finst enno. - Topplinja har ein `Menu`-knapp med nedtrekk på alle fem app-sidene, i denne rekkjefølgja: `Dashboard` → `/`, `Start health check` → `/health-check`, `Settings` → `/settings`, `History` → `/history`, ei skiljelinje, og `Sign out` som gjer det same som før. Panelet er skjult til det blir opna, og det blir lukka på `Escape`, ved klikk utanfor og etter eit val. Sida brukaren alt står på er gråa ut, er ikkje ei lenkje og kan ikkje klikkast, og ho ber `aria-current="page"`. `session.js` byggjer både knappen, panelet og `.topbar-actions`-innpakninga, så markupen på sidene er uendra. `/login` har ingen meny, sidan `session.js` ikkje blir lasta der (§32.7). -- Topplinja er fest til toppen: `.topbar` er `position: sticky; top: 0` med ein `z-index` som held ho over sideinnhaldet og under meny-panelet, so ho blir verande synleg når ein scrollar. Ho er eit flex-barn av `body`, som ikkje set nokon `overflow`, og det er difor festet verkar. Utan inline stil, og utan `border-radius`, `box-shadow` eller gradient (§32.8 punkt 4). +- Topplinja er fest til toppen: `.topbar` er `position: sticky; top: 0` med ein `z-index` som held ho over sideinnhaldet og under meny-panelet, so ho blir verande synleg når ein scrollar. Ho er eit flex-barn av `body`, som ikkje set nokon `overflow`, og det er difor festet verkar. Utan inline stil, og utan `border-radius`, `box-shadow` eller gradient (§32.8). - Skjemaet viser kva nøklar som er sperra av eit ope varsel, og kva handling som lukkar det. - Eit påminningsvarsel før innsending når adressestien ikkje stemmer. -- Date-feltet for kontroll-datoen har `max` sett til dagens lokale dato, so datoveljaren ikkje tilbyr ein dato serveren ville avvise (§32.8 punkt 3). +- Date-feltet for kontroll-datoen har `max` sett til dagens lokale dato, so datoveljaren ikkje tilbyr ein dato serveren ville avvise (§32.8). - Innstillingsside med `01 / Wallet software` og `02 / Key rotation`, bygd for fleire tema seinare. Nøkkelnamnet, modellen, adressestien til ein nøkkel utan lagra kontroll, og roteringa med ny type blir alle endra i roteringsseksjonen, og éin knapp lagrar alt. Det finst ikkje lenger ein eigen `01 / Keys`-seksjon. - Varselknappane har den teksten og det stadfestingssteget som høyrer til handlinga si, og varselet om programvare-inkompatibilitet peikar på innstillingane. - Den korte åtvaringa mot å lime inn ei løyndom står **éin gong**, i nøkkeloppsettet, i tillegg til sidenotisen, med stilen `.secret-warning` (§15). Ho blir ikkje gjenteken per fritekstfelt (§32.2). @@ -355,9 +355,9 @@ StartOS 0.4.0 **Merk:** alle ti punkta er oppfylte. Pakka ligg i repoet, er bygd til `vardkey_x86_64.s9pk`, sideloda og køyrd på ein eigen StartOS 0.4.0-boks. To handlingar ligg i `Actions & Config`: `Delete all data` og `Set Admin Password`. -Frå §32.8 punkt 1 har pakka i tillegg ei **oppgåve** (task) som skal halde servicen tilbake til adminpassordet er sett. Ho blir reist og lukka av eit init-skript, `startos/init/requireAdmin.ts`, som er registrert i `sdk.setupInit()` etter handlingane: medan databasen ikkje har nokon admin, held han oppgåva `Set Admin Password` oppe, og når ein admin finst, lukkar han henne att. Oppgåva peikar på den **eksisterande** handlinga, som køyrer `maintenance.py set-admin-password` i ein `withTemp`-subcontainer, so 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. Init-skriptet kan ikkje lese databasen frå sitt eige JavaScript, so det spør eit lite `python3`-probe i ein `withTemp`-subcontainer som les `app_settings` **readonly**. Proben **feilar ope**: kan han ikkje køyrast, blir inga oppgåve reist, so ein brukar som alt har ein admin aldri blir sperra av eit gjet. Readiness-sjekken mot `/health` og `/health`-endepunktet i appen er uendra. +Frå §32.8 har pakka i tillegg ei **oppgåve** (task) som skal halde servicen tilbake til adminpassordet er sett. Ho blir reist og lukka av eit init-skript, `startos/init/requireAdmin.ts`, som er registrert i `sdk.setupInit()` etter handlingane: medan databasen ikkje har nokon admin, held han oppgåva `Set Admin Password` oppe, og når ein admin finst, lukkar han henne att. Oppgåva peikar på den **eksisterande** handlinga, som køyrer `maintenance.py set-admin-password` i ein `withTemp`-subcontainer, so 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. Init-skriptet kan ikkje lese databasen frå sitt eige JavaScript, so det spør eit lite `python3`-probe i ein `withTemp`-subcontainer som les `app_settings` **readonly**. Proben **feilar ope**: kan han ikkje køyrast, blir inga oppgåve reist, so ein brukar som alt har ein admin aldri blir sperra av eit gjet. Readiness-sjekken mot `/health` og `/health`-endepunktet i appen er uendra. -**Merk:** oppgåva blir reist med alvorlegheita `critical` og står som **required** på Tasks, og bokstesten på eit friskt volum viser at ho held servicen tilbake til adminpassordet er sett (§32.8 punkt 1). SDK 3.0.4 kallar henne ein «task notification», og `TaskCondition` har berre `'input-not-matches'`, so det finst ikkje noko vilkår for «adminpassordet er ikkje sett»; oppgåva blir heva og lukka av init-skriptet og ikkje av eit vilkår. +**Merk:** bokstesten (§32.8) viser at oppgåva ikkje held servisen tilbake — ho står berre som «recommended» på Tasks, so brukaren kan starte appen sjølv om adminpassordet manglar. SDK 3.0.4 kallar henne ein «task notification», og `TaskCondition` har berre `'input-not-matches'`, so det finst ikkje noko vilkår for «adminpassordet er ikkje sett»; oppgåva blir heva og lukka av init-skriptet og ikkje av eit vilkår. §32.6 skal skildre det som faktisk skjer. Unngå: Postgres, Redis, ekstern backend, ekstern cloud-service for appdata, og ekstra container utan konkret behov. @@ -386,7 +386,7 @@ Unngå: Postgres, Redis, ekstern backend, ekstern cloud-service for appdata, og - Ikkje send data til eksterne tenester. - Adressestien er ein offentleg derivasjonssti og inneheld inga hemmelegheit. - Fritekst blir sjekka lokalt i `secret_guard.py` før lagring, og før lengdegrensa til feltet. Eit felt som ser ut som ei wallet-løyndom, blir avvist med `400`, ingenting blir lagra, og meldinga gjentek aldri verdien. Sjekken gjer ingen nettverkskall. Han er ei sperre mot dei vanlegaste formata, ikkje eit vern: eit nakent 64-teikns heks-streng, ei frase på eit anna språk, og ei løyndom delt over fleire felt, blir ikkje fanga. I UI-et står den korte åtvaringa **éin gong**, i nøkkeloppsettet, med stilen `.secret-warning`; ho blir ikkje gjenteken ved kvart fritekstfelt (§12 og §32.2). Serveren er uendra og avviser framleis eit løyndom i kvart fritekstfelt. -- Innlogginga er avgrensa: fem mislukka forsøk på rad låser innlogginga i 15 minutt med `429`. Teljaren ligg i `app_settings`, er ikkje knytt til IP, og appen les medvite ikkje `X-Forwarded-*`, sidan StartOS proxyar alt (§32.8 punkt 2). +- Innlogginga er avgrensa: fem mislukka forsøk på rad låser innlogginga i 15 minutt med `429`. Teljaren ligg i `app_settings`, er ikkje knytt til IP, og appen les medvite ikkje `X-Forwarded-*`, sidan StartOS proxyar alt (§32.8). - Eit `python3`-probe i pakka les `app_settings` i appdatabasen **readonly** for å sjå om ein admin finst (§13). Det skriv ingenting, gjer ingen nettverkskall, og sender ingenting vidare. --- @@ -422,12 +422,14 @@ Unngå: Postgres, Redis, ekstern backend, ekstern cloud-service for appdata, og - Test oppsett av eit annet multisig-oppsett enn 2-av-3, modell/teneste per nøkkel, det daterte eksportnamnet, sletting av all data, og installasjon av PWA-en. - Test at `/robots.txt` blir svara, at kvar av dei seks sidene ber robots-metaen, og at kvart svar ber `X-Robots-Tag`. - Test menyen, at sida ein står på er gråa ut og ikkje kan klikkast, at eksporten har sin eigen seksjon på history-sida med noten under lenkja, og at både `View` og ei innsending landar på `#history-detail`. -- Test at ein kontroll-dato i framtida blir avvist med `400`, og at dagen i dag og ein eldre dato går gjennom (§32.8 punkt 3). -- Test at fem feila innloggingsforsøk låser innlogginga i 15 minutt med `429`, at eit rett passord i låseperioden òg blir avvist, og at ein vellukka innlogging nullstiller teljaren (§32.8 punkt 2). -- 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 kontroll-dato i framtida blir avvist med `400`, og at dagen i dag og ein eldre dato går gjennom (§32.8). +- Test at fem feila innloggingsforsøk låser innlogginga i 15 minutt med `429`, at eit rett passord i låseperioden òg blir avvist, og at eit vellukka innlogging nullstiller teljaren (§32.8). +- 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). +- 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). +- Test at lukkinga i historia og i CSV-en ber kjelda si, så nøkkelforma og programvareforma av same `code` kan skiljast (§32.9). +- Test at historikk-kortet viser alle tre statusane, at ein kontroll med alt lukka ikkje seier `Needs follow-up`, og at `needs_follow_up` framleis er frosen (§32.9). -**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), ein kikk på varsellista, nøkkelkortet og sperre-noten i skjemaet etter tekstendringane (§32.3), footeren på ei kort side, faviconet i fana, merket i topplinja, installasjon av PWA-en med dei to PNG-ikona, history-visninga med dei tre tabell- og linjeendringane, menyen i topplinja og det rydda dashbordet med `Download CSV` og noten i sin eigen `Export`-seksjon på history-sida, hoppet til `#history-detail` (§32.7), og til slutt den manuelle ende-til-ende-gjennomgangen i §32.8 punkt 7. +**Merk:** dei manuelle nettlesartestane er køyrde og verifiserte fram til §31. §32 la til nye manuelle punkt: ikonet (§32.1), UI-pussen og retro-temaet på ein smal telefon (§32.2), ein kikk på varsellista, nøkkelkortet og sperre-noten i skjemaet etter tekstendringane (§32.3), footeren på ei kort side, faviconet i fana, merket i topplinja, installasjon av PWA-en med dei to PNG-ikona, history-visninga med dei tre tabell- og linjeendringane, menyen i topplinja og det rydda dashbordet med `Download CSV` og noten i sin eigen `Export`-seksjon på history-sida, hoppet til `#history-detail` (§32.7), og til slutt den manuelle ende-til-ende-gjennomgangen i §32.8, som brukaren køyrde og stadfesta. §32.9 legg til ein kikk på lukke-tabellen i historia og på kortet i lista, med og utan ope varsel. ## StartOS-test @@ -500,7 +502,7 @@ Desse er bindande for kvar framtidig endring, ikkje berre for éin runde. # 19–32. Historikk (ferdige og verifiserte) -Alle rundane under er implementerte og verifiserte. Reglane deira ligg i §1–§18 og i `ai-note.md`; den fulle grunngjevinga ligg i git-historikken. Detaljane er ikkje gjengjevne her, sidan ingen av dei er opne lenger — med unnatak av §32.8, der punkt 7 står att i §32. +Alle rundane under er implementerte og verifiserte. Reglane deira ligg i §1–§18 og i `ai-note.md`; den fulle grunngjevinga ligg i git-historikken. Detaljane er ikkje gjengjevne her, sidan ingen av dei er opne lenger. | Runde | Kva han gjorde | |---|---| @@ -520,40 +522,37 @@ Alle rundane under er implementerte og verifiserte. Reglane deira ligg i §1– | §32.1 | Ikonet: same retro-teikning i `icon.svg` i rota og i `static/icon.svg`, favicon-lenka og `` på alle seks sidene, og dei to rasteriserte PNG-ikona (192 og 512) i manifestet (etter SVG-en), i `STATIC_FILES` og i skal-lista. | | §32.2 | UI-passet: retro-temaet i `static/styles.css` (ingen `border-radius` utanom `0`, ingen `box-shadow`, ingen gradient), åtvaringa mot å lime inn ei løyndom éin gong i nøkkeloppsettet, det rydda nøkkelkortet (nummer og type, namn, modell, sti, `Next check due`), historikk-kortet med kort status, og dei additive felta `key_names` og `needs_follow_up` i oppsummeringa. Etterrunden: footeren nedst på sida, faviconet, merket, bort med «Back to dashboard» og «Start annual health check» på history-sida, og historia med programvare/versjon og modell/firmware på éi line kvar og lukke-tabellen `Alert`/`Action`/`Closed`. | | §32.3 | Meldingstekstane i dei elleve varselradene skrivne i same form: kva som er gale, kva nøkkel eller programvare det gjeld, og kva som lukkar varselet, utan å gjenta namnet i kjelda. | -| §32.4 | Bug-rapporten: BR-001 falsk positiv (kjeldefilene ligg i `main` og er spora av Git), BR-002 retta i `secret_guard.py`, BR-003 er punkt 7 i §32.8, BR-004 fell bort (dei åtte dokumenta han ber om finst ikkje her og skal ikkje opprettast — den reelle dokdrifta er §32.6), BR-005 verifisert i koden utan åtferdsendring, BR-006 retta i `export.py`, BR-007 retta i `static/sw.js`, BR-008 retta i `validation.py`. | +| §32.4 | Bug-rapporten: BR-001 falsk positiv (kjeldefilene ligg i `main` og er spora av Git), BR-002 retta i `secret_guard.py`, BR-003 vart §32.8 punkt 7, BR-004 fell bort (dei åtte dokumenta han ber om finst ikkje her og skal ikkje opprettast — den reelle dokdrifta er §32.6), BR-005 verifisert i koden utan åtferdsendring, BR-006 retta i `export.py`, BR-007 retta i `static/sw.js`, BR-008 retta i `validation.py`. | | §32.7 | Topplinje-menyen (`Dashboard`, `Start health check`, `Settings`, `History`, skiljelinje, `Sign out`) med sida ein står på gråa ut og `aria-current="page"`, og oppryddinga i dashbordet: `Configured setup`/`Your keys` og nøkkelteljaren bort, `Next check`-kortet inn i «Attention», tom varselliste utan plasshaldartekst, history-blokka bort, `Download CSV` og noten i sin eigen `Export`-seksjon på history-sida, ankeret `#history-detail`, og robots-sperra (`static/robots.txt`, robots-metaen på alle seks sidene og `X-Robots-Tag` på kvart svar). | -| §32.8 | Steg A (punkt 3, 4 og 2), steg B (punkt 1) og steg C (punkt 6 og 5 saman, sidan begge kravde skjema 13), og punkt 7, den manuelle gjennomgangen, som brukaren køyrde og stadfesta på boksen. Detaljane står i §32.8. | +| §32.8 | Steg A (punkt 3, 4 og 2), steg B (punkt 1) og steg C (punkt 6 og 5 saman, sidan begge kravde skjema 13): datogrensa på `checked_at`, den faste topplinja, innloggingslåsinga med `429`, oppgåva `Set Admin Password` som `startos/init/requireAdmin.ts` reiser og lukkar, KI-kjelda som kjem frå rada i `ai_security_checks`, og roteringa som legg til ei ny nøkkelrad med eit snapshot av namn, type og modell på kvar kontroll. Skjema **13**. Punkt 7, brukaren sin manuelle ende-til-ende-gjennomgang, vart køyrd på boksen og stadfesta; oppgåva held ikkje servisen tilbake, sjå §13 og §32.6. | --- # 32. Det som står att -Rekkjefølgja er bindande: **§32.8 punkt 7** er ferdig og stadfesta av brukaren; deretter kjem **§32.6**, og til slutt **§32.5** — alle **før** pakkeversjonen blir heva frå `0.1.0:0` til `1.0.0:0`. Resten av §32 er historikk og står i tabellen over. Eit punkt skal ikkje startast utan at brukaren ber om det. +Rekkjefølgja er bindande: **§32.9** først, deretter **§32.6**, og til slutt **§32.5** — alle **før** pakkeversjonen blir heva frå `0.1.0:0` til `1.0.0:0`. Resten av §32 er historikk og står i tabellen over. Eit punkt skal ikkje startast utan at brukaren ber om det. -## 32.8 Dei sju punkta — alle sju er utførte og verifiserte +## 32.9 To rettingar før §32.6 -1. **Appen skal ikkje starte før adminpassordet er sett.** `startos/init/requireAdmin.ts` reiser den påkravde oppgåva `Set Admin Password` medan databasen ikkje har nokon admin, og lukkar henne att når han finst. Proben les `app_settings` readonly i ein `withTemp`-subcontainer og **feilar ope**. Passordet blir framleis generert **inne i containeren** og skrive ut éin gong. På app-sida er gatinga som alt finst nok: utan admin svarar `/api/*` `401`, sidene svarar `302` til `/login`, og `/login` viser opprett-admin-skjemaet, som er den lokale bootstrapen for `python3 app.py`. **Avgjerda er teken:** alvorlegheita er `critical`, den strengaste SDK-en tilbyr, og bokstesten på eit friskt volum viser at oppgåva då står som **required** på Tasks og held servicen tilbake til adminpassordet er sett — med `important` stod ho berre som «recommended» og kunne hoppast over. Ingen avvik står att. -2. **Avgrensing av feila innloggingsforsøk.** Etter fem mislukka `POST /api/login` 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, ei vellukka innlogging nullstiller teljaren, og teljaren ligg i `app_settings`, so han overlever ein restart. Inga IP-basert logikk: appen les medvite ikkje `X-Forwarded-*`. `POST /api/admin` blir ikkje avgrensa. -3. **Ingen kontroll-dato i framtida.** `checked_at` må vere dagen i dag eller tidlegare. `validation.py` svarar `400` med ei tydeleg melding, og date-feltet i skjemaet har `max` sett til dagens lokale dato. `next_check_due` er uendra (eitt kalenderår etter sjekkdatoen). -4. **Topplinja fest til toppen.** `.topbar` er `position: sticky; top: 0` med ein `z-index` over sideinnhaldet og under meny-panelet. Utan inline stil, og utan `border-radius`, `box-shadow` eller gradient. -5. **Rotering gir ny nøkkelrad, og historia blir frosen.** Ei rotering skriv ikkje om den eksisterande nøkkelrada: ho legg til **ei ny rad** i `keys` med **same `key_number`**, den nye typen, den nye adressestien, namnet og modellen, og merkjer den gamle rada som inaktiv med `rotated_at`. Eldre kontrollar peikar framleis på den gamle rada, og kvar kontroll lagrar i tillegg eit **snapshot** av `key_name`, `key_type` og `key_model`. Kravde **skjema 13**: `UNIQUE` på `keys.key_number` er bytt med eit delvis unikt indeks der rada er aktiv, `keys` fekk `active` og `rotated_at`, og `key_checks` fekk snapshot-kolonnane. Migreringa følgjer mønsteret i §21, backfyller snapshottet frå den kopla `keys`-rada, og har sin eigen test med eit bokstaveleg `SCHEMA_VERSION_12`. -6. **KI-kjelda kan ikkje flippe, og lukka programvarevarsel kjem i historia.** Kvar rad i `ai_security_checks` ber `key_id` (nullable), sett til den kontrollerte nøkkelen når leverandøren er nøkkelen sitt eige konfigurerte namn. Då blir kjelda avgjord av rada sjølv, ikkje av ei samanlikning med namna som er konfigurerte no, so ein cloud-nøkkel som blir rotert eller omdøypt kan ikkje gi eit nytt programvarevarsel ved sida av det nøkkelvarsla roteringa alt lukka. Samstundes listar `app.closed_alerts()` og `database._grouped_closures()` kvar lukking som ber eit `check_id`, òg dei programvarekjelda, og lukkinga heng framleis på kontrollen sin. -7. **BR-003 — den manuelle ende-til-ende-gjennomgangen.** Køyrden og stadfesta av brukaren på boksen. 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). +To funn frå den manuelle gjennomgangen i §32.8. Inga ny avhengigheit, ingen nye dokument, og inga endring i API-namna eller i CSV-avtalen utanom det som står under. Kvar retting får regresjonstestar i same endring, og ein påstand blir aldri sletta utan å bli erstatta av ein som pinnar den nye åtferda. -**Køyrt og stadfesta på boksen (brukaren):** første oppsett, login og logout, ugyldig sesjon, direkte API-kall utan sesjon, ein full kontroll, CSV-eksport, eit alternativt oppsett, sletting av data, restart, backup og restore, roteringa med frose historie, lukka programvarevarsel i historia og CSV-en, CSRF-testen (ein `POST` til `/api/settings/wallet-software` utan CSRF-headeren svarar `403` og lagrar ingenting, med headeren `200`), og PWA offline og online, òg etter logout (skalet kjem frå cachen utan gamle data, dataa kjem tilbake online, og etter logout gjev `/` offline det cacha dashbord-skalet og ikkje innloggingssida) — alle OK. Ei merknad: ei forventning i gjennomgangen var feil — ein nøkkel med eit **programvarekjelda** `software_incompatible` skal **ikkje** sperrast i key-select, sidan varselet ikkje høyrer til nøkkelen. Appen er rett der. +1. **Kjelda manglar i `Follow-up closed`.** `security_vulnerable` og `security_compromised` finst i to former — éi som høyrer til ein nøkkel (`Key N: `) og éi som høyrer til ei programvare i innstillingslista — og lukkinga blir skriven som `code: action (YYYY-MM-DD)` åleine. I historia og i CSV-en kan ein difor ikkje sjå kva form som vart lukka. Lukkinga skal bere kjelda si: nøkkelforma som `Key N: `, programvareforma som namnet på programvara. **Additivt:** kolonnenamna og kolonnerekkjefølgja i CSV-en er uendra, og berre verdien i `Follow-up closed` blir utvida; same kjelde skal stå i lukke-tabellen på kontrollen i historia. `closed_alerts` i `GET /api/health-checks/` held namna sine og får kjelda berre om ho ikkje alt er der. §9 og §10 blir oppdaterte. Testar: `tests/test_export.py`, `tests/test_app.py`, og den testen i `tests/test_health_check_form.py` som pinnar lukke-tabellen. Ein test som pinnar at kjelda **ikkje** står der, blir snudd, ikkje sletta. +2. **Historikk-kortet seier `Needs follow-up` om att.** Kortet i lista viser `All OK` eller `Needs follow-up`, og det andre kjem frå `needs_follow_up`, som er ein **frosen** eigenskap ved den lagra kontrollen — han endrar seg ikkje når brukaren lukkar varselet. Difor står det framleis `Needs follow-up` på ein kontroll der alle oppfølgingane er lukka. Kortet skal vise den **noverande** tilstanden, i tre steg: `All OK` når kontrollen ikkje reiste noko, `Needs follow-up` medan noko står ope, og eit tredje ord når alt er lukka (t.d. `Follow-up closed`). Det krev eit **additivt** felt i oppsummeringa (§11), rekna ut av dei same varsel- og kvitteringsreglane som alt finst i `alerts.py`/`app.py` — ikkje av ei ny regel. **`needs_follow_up` skal stå uendra:** han er den lagra sanninga, og å skrive han om ville skrive om historia. Merk at eit varsel ein nyare kontroll reiser på nytt, høyrer til den nyare kontrollen etter samanslåingsregelen i §7; skriv ned kva val du tok og pinn det med ein test. §9 og §11 blir oppdaterte. Testar: oppsummeringstesten i `tests/test_app.py` og kort-testen for historia. + +**Kva spec-seksjonar som må oppdaterast når punkta landar:** §9, §10 og §11. §32.6 si liste skal nemne dei òg. ## 32.6 Dokumentasjonsdrifta -Dokumenta som skildrar pakka og appen, er skrivne før §31 og før 32-A, 32-B, 32.1, 32.2 og 32.7, og dei er framleis ikkje oppdaterte. Dette punktet rettar dei. Det må gjerast **etter** 32.8 punkt 7 og **før** 32.5, slik at dokumenta skildrar den utgåva som faktisk blir gitt ut, og det svarar samstundes på resten av BR-004 i bug-rapporten. +Dokumenta som skildrar pakka og appen, er skrivne før §31 og før heile §32, og dei er framleis ikkje oppdaterte. Dette punktet rettar dei. Det må gjerast **etter** §32.9 og **før** §32.5, slik at dokumenta skildrar den utgåva som faktisk blir gitt ut, og det svarar samstundes på resten av BR-004 i bug-rapporten. -- `README.md` (pakke-README): «Actions: None» og `actions: []` i Quick Reference stemmer ikkje — pakka har to handlingar, `Delete all data` og `Set Admin Password`, og ei oppgåve frå §32.8 punkt 1. Fyrstegongsflyten manglar admin-steget, og «Limitations» manglar at terskel og nøkkeltal er valfrie (`2 ≤ key_count ≤ 15`), at databasen ligg ukryptert på volumet, og at fritekst blir sjekka lokalt. «The icon is a placeholder» er utdatert etter §32.1, og «a fixed 2-of-3 … the three keys» i innleiinga og i Limitations er utdatert etter §31 punkt 7. -- `docs/application.md` (app-referansen): API-tabellen manglar `GET /api/session`, `POST /api/admin`, `POST /api/login` og `POST /api/logout`, og han skildrar korkje innloggingsvakta (`401` på API, `302` til `/login` på sider, `403` utan CSRF-token, `429` ved låst innlogging) eller kva ruter som er opne. Han manglar òg formelnøytraliseringa i CSV-en, den kanoniske stisamanlikninga og den lokale sperra mot wallet-løyndomar, og setninga om at den manuelle StartOS-testen framleis står ope er utdatert. Han manglar `key_names` og `needs_follow_up` i `GET /api/health-checks`, `model` i `GET /api/health-checks/`, favicon-lenka på sidene og dei to PNG-ikona med sine eigne stiar, robots-fila, robots-metaen, `X-Robots-Tag`, menyen i topplinja, at `Download CSV` og noten ligg i sin eigen `Export`-seksjon på history-sida, og ankeret `#history-detail`. Han manglar òg skjema 13 og dei nye kolonnane, at ei rotering legg til ei ny nøkkelrad, at namnet og typen på ein kontroll kjem frå snapshottet på kontrollen, at lukka programvarevarsel òg blir lista, `429`-låsinga, datogrensa, den faste topplinja, og oppgåva frå §32.8 punkt 1. Han seier framleis «the schema is version 12», «Only a closure that belongs to a key is listed», «the history shows the name the key has now», «The dashboard link carries no `download` attribute» og at `keys.key_number` er `UNIQUE` — alle fem er no feil. «a fixed 2-of-3» i innleiinga og «the three key profiles» under «Current status» er utdaterte etter §31 punkt 7. -- `instructions.md`: manglar innloggingssteget, opprettinga av admin, dei to handlingane i `Actions & Config` og oppgåva frå §32.8 punkt 1. «exactly three keys … another threshold is not supported» er feil etter §31 punkt 7. +- `README.md` (pakke-README): «Actions: None» og `actions: []` i Quick Reference stemmer ikkje — pakka har to handlingar, `Delete all data` og `Set Admin Password`, og ei oppgåve frå §32.8. Fyrstegongsflyten manglar admin-steget, og «Limitations» manglar at terskel og nøkkeltal er valfrie (`2 ≤ key_count ≤ 15`), at databasen ligg ukryptert på volumet, og at fritekst blir sjekka lokalt. «The icon is a placeholder» er utdatert etter §32.1, og «a fixed 2-of-3 … the three keys» i innleiinga og i Limitations er utdatert etter §31 punkt 7. +- `docs/application.md` (app-referansen): API-tabellen manglar `GET /api/session`, `POST /api/admin`, `POST /api/login` og `POST /api/logout`, og han skildrar korkje innloggingsvakta (`401` på API, `302` til `/login` på sider, `403` utan CSRF-token, `429` ved låst innlogging) eller kva ruter som er opne. Han manglar òg formelnøytraliseringa i CSV-en, den kanoniske stisamanlikninga og den lokale sperra mot wallet-løyndomar, og setninga om at den manuelle StartOS-testen framleis står ope er utdatert. Han manglar `key_names` og `needs_follow_up` i `GET /api/health-checks`, det tredje statusfeltet frå §32.9, `model` i `GET /api/health-checks/`, at lukkinga ber kjelda si, favicon-lenka på sidene og dei to PNG-ikona med sine eigne stiar, robots-fila, robots-metaen, `X-Robots-Tag`, menyen i topplinja, at `Download CSV` og noten ligg i sin eigen `Export`-seksjon på history-sida, og ankeret `#history-detail`. Han manglar òg skjema 13 og dei nye kolonnane, at ei rotering legg til ei ny nøkkelrad, at namnet og typen på ein kontroll kjem frå snapshottet på kontrollen, at lukka programvarevarsel òg blir lista, `429`-låsinga, datogrensa, den faste topplinja, og oppgåva frå §32.8. Han seier framleis «the schema is version 12», «Only a closure that belongs to a key is listed», «the history shows the name the key has now», «The dashboard link carries no `download` attribute» og at `keys.key_number` er `UNIQUE` — alle fem er no feil. «a fixed 2-of-3» i innleiinga og «the three key profiles» under «Current status» er utdaterte etter §31 punkt 7. +- `instructions.md`: manglar innloggingssteget, opprettinga av admin, dei to handlingane i `Actions & Config` og oppgåva frå §32.8. «exactly three keys … another threshold is not supported» er feil etter §31 punkt 7. - `UPDATING.md`: seier skjema **11**; det er **13**. Versjoneksempla og tag-regelen skal framleis stå, og modullista bør nemne `auth.py`, `maintenance.py` og `secret_guard.py`. - `AGENTS.md`: modullista nemner ikkje `auth.py`, `maintenance.py` eller `secret_guard.py`, og testavsnittet nemner ikkje at suiten òg dekkjer sperra. Han bør òg nemne `startos/init/requireAdmin.ts` og oppgåva. - `startos/manifest/i18n.ts` og `startos/i18n/dictionaries/`: kort- og langskildringa seier «a fixed 2-of-3 … the three keys» på fem språk. Skal ordlyden bli «eit multisig-oppsett, 2-av-3 som standard», må alle fem språka skrivast om, og `make x86` køyrer `prettier --check startos`. -**Merk:** skriv det som faktisk skjer. Avviket i §32.8 punkt 1 er retta, so dokumenta skal seie at oppgåva blir reist som `critical`, står som required på Tasks og held servicen tilbake til adminpassordet er sett. +**Merk:** skriv det som faktisk skjer. Oppgåva frå §32.8 blir reist og står på Tasks, og ho held ikkje servisen tilbake — dokumenta skal seie det, ikkje noko anna. Ikkje bygg om overskriftstrukturen i `README.md` (han følgjer rettleiinga), og ikkje legg til nye dokument. Dei åtte filene bug-rapporten nemner (`SECURITY.md`, `PRIVACY.md`, `THREATMODEL.md`, `PLATFORM-ACCESS.md`, `ENCRYPTION.md`, `OFFLINE.md`, `AI-STATUS.md`, `DATA-MODEL.md`) skal **ikkje** opprettast. Dokumenta i repoet er `README.md`, `docs/application.md`, `instructions.md`, `UPDATING.md`, `AGENTS.md` og `TODO.md`.