From 4ad68c6e0855fd40d66f92660b0f281e3dba4f24 Mon Sep 17 00:00:00 2001 From: ai-bot Date: Sun, 25 Oct 2026 14:22:56 +0000 Subject: [PATCH] Shorten TODO.md: move the finished 32.1-32.4, 32.7 and 32.8 stages into the history table --- TODO.md | 201 ++++++++++++++------------------------------------------ 1 file changed, 51 insertions(+), 150 deletions(-) diff --git a/TODO.md b/TODO.md index a3602b8..9c0ba3d 100644 --- a/TODO.md +++ b/TODO.md @@ -16,11 +16,11 @@ Appen skal **berre registrere resultat og historikk**. Han skal ikkje signere Bi ## Om dokumentet - **§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. -- **§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. +- **§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. - **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 §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å. +- **Status:** alt til og med §32.7 og §32.8 steg A, B og C er implementert og verifisert, med unnatak av punkt 7 i §32.8, som berre brukaren kan gjere. 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. --- @@ -237,12 +237,12 @@ Alle lagra kontrollar blir lesne, ikkje berre den nyaste. Like varsel (same `cod # 8. Dashboard - Vis multisig-oppsettet og status for kvar nøkkel, med neste forfall per nøkkel. -- Nøkkelkorta står rett under overskrifta på sida, utan ein eigen `Configured setup`-seksjon, utan `Your keys`-overskrift og utan nøkkelteljar (§32.7 punkt 2). +- Nøkkelkorta står rett under overskrifta på sida, utan ein eigen `Configured setup`-seksjon, utan `Your keys`-overskrift og utan nøkkelteljar (§32.7). - Eitt oversiktskort, «Attention»: kor mange nøklar som har passert fristen, med kva nøklar det gjeld. Er ingen passert, står den tidlegaste sjekkdatoen der i staden, med kva nøkkel ho gjeld (`Earliest next check , for Key N: .`). Har ingen nøkkel ein dato, står fallbacken om å lagre ein health check. Om ein dato er passert, blir avgjort i nettlesaren. -- Vis alle aktive varsel, med kva registrering kvart varsel kjem frå, og handlinga som lukkar det. Ei tom varselliste viser ingen tekst; teljaren ved overskrifta seier `No alerts` (§32.7 punkt 4). -- Ingen navigasjonslenkjer i sjølve dashbordet: menyen i topplinja er vegen til skjemaet, innstillingane og historia, og eksporten ligg på history-sida (§32.7 punkta 1 og 5, og etterrunden punkta 1 og 4). Dashbordet har heller inga notelinje av eige; noten som forklarar eksporten står i eksportseksjonen på history-sida (etterrunden punkt 4). +- Vis alle aktive varsel, med kva registrering kvart varsel kjem frå, og handlinga som lukkar det. Ei tom varselliste viser ingen tekst; teljaren ved overskrifta seier `No alerts` (§32.7). +- Ingen navigasjonslenkjer i sjølve dashbordet: menyen i topplinja er vegen til skjemaet, innstillingane og historia, og eksporten ligg på history-sida (§32.7). Dashbordet har heller inga notelinje av eige; noten som forklarar eksporten står i eksportseksjonen på history-sida (§32.7). - Vis oppsettsteget i staden for dashboardet når nøkkeloppsettet manglar. -- Eit nøkkelkort viser namn, adressesti, modell/teneste og type, og ei tydeleg melding når nøkkelen har eit ope varsel, i tillegg til datoane sine: kor mange varsel som står ope, at nøkkelen ikkje kan kontrollerast før dei er lukka, kva handling som lukkar det første, og ei lenkje til varsellista. Kortet viser nummeret og typen på den øvste linja (§32.2 punkt 6), modellen under namnet (punkt 8) og adressestien under han (punkt 7), og av datoane berre `Next check due` (punkt 9). +- Eit nøkkelkort viser namn, adressesti, modell/teneste og type, og ei tydeleg melding når nøkkelen har eit ope varsel, i tillegg til datoane sine: kor mange varsel som står ope, at nøkkelen ikkje kan kontrollerast før dei er lukka, kva handling som lukkar det første, og ei lenkje til varsellista. Kortet viser nummeret og typen på den øvste linja, modellen under namnet og adressestien under han, og av datoane berre `Next check due` (§32.2). --- @@ -254,11 +254,11 @@ Alle lagra kontrollar blir lesne, ikkje berre den nyaste. Like varsel (same `cod - 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 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 `—`. -- 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. -- `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 etterrunden punkt 3). +- 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. +- 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). +- 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). --- @@ -300,10 +300,10 @@ Minimumsendepunkt: `GET /health`, `GET /api/keys`, `GET /api/health-checks`, `GE - `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 (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 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. +- `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). -- `_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). --- @@ -315,17 +315,17 @@ Minimumsendepunkt: `GET /health`, `GET /api/keys`, `GET /api/health-checks`, `GE - Skjul felt som ikkje gjeld for vald nøkkel eller vald programvare, og skjul programvare og KI-status nøkkelen ikkje kunne kontrollerast. Eit skjult `required`-felt blokkerer innsendinga, så flagget må alltid clearast når feltet blir skjult. - 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 punkt 1 og etterrunden punkt 2). +- 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). - 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). - 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. +- 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). - Appen skal kunne installerast som ein PWA utan offline-data. - Sørg for at appen fungerer godt i vanleg StartOS-browser. -- Ingen indeksering og ingen bots: alle seks sidene ber ``, `X-Robots-Tag: noindex, nofollow` står på kvart svar, og `static/robots.txt` svarar `Disallow: /` (§32.7 punkt 6). +- Ingen indeksering og ingen bots: alle seks sidene ber ``, `X-Robots-Tag: noindex, nofollow` står på kvart svar, og `static/robots.txt` svarar `Disallow: /` (§32.7). --- @@ -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 **påkravd 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 med `severity: 'important'`, 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 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. -**Merk:** at oppgåva faktisk held servicen tilbake, og at ho forsvinn når handlinga er køyrd, er ei åtferd i StartOS som berre bokstesten i §32.8 punkt 7 kan stadfeste. SDK-en kallar henne ein «task notification», og det finst ikkje noko eige vilkår for «adminpassordet er ikkje sett» i SDK 3.0.4 (`TaskCondition` har berre `'input-not-matches'`), so oppgåva blir heva og lukka av init-skriptet og ikkje av eit vilkår. +**Merk:** bokstesten (§32.8 punkt 7) viser at oppgåva ikkje held servicen tilbake — ho står berre som «recommended» på Tasks, so brukaren kan starte appen sjølv om adminpassordet manglar. Det er eit avvik frå kravet i punkt 1, og avgjerda står i §32.8. 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. Unngå: Postgres, Redis, ekstern backend, ekstern cloud-service for appdata, og ekstra container utan konkret behov. @@ -385,7 +385,7 @@ Unngå: Postgres, Redis, ekstern backend, ekstern cloud-service for appdata, og - Ikkje implementer eigen kryptografi. Adminpassordet brukar `hashlib.scrypt` frå standardbiblioteket, og sesjonen ein HMAC-SHA256-signatur. - 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 punkt 10). Serveren er uendra og avviser framleis eit løyndom i kvart fritekstfelt. +- 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). - 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. @@ -427,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 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), at ei rotering ikkje endrar eldre historikk (punkt 5), og at lukka programvarevarsel står i historia og i CSV-en (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), 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. ## StartOS-test @@ -493,14 +493,14 @@ Desse er bindande for kvar framtidig endring, ikkje berre for éin runde. - **Backup teken på ein eldre versjon** skal kunne gjenopprettast og bli migrert framover. - **Eksporten er ein avtale.** Kolonnenamna i CSV-en blir ikkje endra utan at det står her eller i ein seinare runde. - **Ingen indeksering og ingen bots.** Alle seks sidene ber ``, `_send_security_headers()` i `app.py` legg `X-Robots-Tag: noindex, nofollow` på kvart svar, og `static/robots.txt` svarar `Disallow: /`. Robots-fila står i `STATIC_FILES`, men er **ikkje** i `SHELL`-lista i `static/sw.js`, sidan ho ikkje er ein del av app-skalet. Ein ny side skal ha metaen med frå første stund. -- **Navigasjonen ligg i topplinja, ikkje på sida.** `static/session.js` byggjer menyen på dei fem app-sidene, og sida brukaren står på er ikkje ei lenkje. Dashbordet skal ikkje ha navigasjonslenkjer i markupen sin, og eksporten ligg på history-sida. +- **Navigasjonen ligg i topplinja, ikke på sida.** `static/session.js` byggjer menyen på dei fem app-sidene, og sida brukaren står på er ikkje ei lenkje. Dashbordet skal ikkje ha navigasjonslenkjer i markupen sin, og eksporten ligg på history-sida. - **Forbodslistene i §1 og §13 skal stadfestast på nytt før release.** --- -# 19–31. Historikk (ferdige og verifiserte) +# 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. +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. | Runde | Kva han gjorde | |---|---| @@ -517,146 +517,47 @@ Alle rundane under er implementerte og verifiserte. Reglane deira ligg i §1– | §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`. | | §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. | +| §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.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). Detaljane står i §32.8. | --- # 32. Det som står att -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. +Rekkjefølgja er bindande: **§32.8 punkt 7** 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. -**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.8 Dei sju punkta — punkt 1–6 er utførte, punkt 7 står att -## 32.1 Ikonet — utført +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`. **Avvik funne i bokstesten:** oppgåva står berre som «recommended» på Tasks, so brukaren kan starte appen utan admin. Att er ei avgjerd: anten prøve ei strengare alvorlegheit i `requireAdmin.ts` og teste på nytt på boksen, eller godta avviket og dokumentere det i §32.6. +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.** 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). -1. `icon.svg` i repo-rota og `static/icon.svg` er den same retro-teikninga: eit heva grått vindauge med dei tre nøklane, sentrerte i flata. Den marineblå tittelstripa er borte, nøkkelgruppa er 21 høg, flata innanfor 3D-kanten går frå 6 til 122, så senteret er 64 og nøklane står på `translate(23, 25.5)`, `(23, 51.5)` og `(23, 77.5)`. Fila i rota er 1,2 KiB, og ho er rein SVG utan fontar, bilete eller nettverkskall, så CSP-en `default-src 'self'` held. -2. Kvart av dei seks sidene har `` i ``, og `` i topplinja. Klassenamnet `brand-mark` står, og `.brand-mark` i `static/styles.css` er 18×18 med `image-rendering: pixelated`. -3. `static/icon-192.png` (192×192) og `static/icon-512.png` (512×512) er rasteriserte frå SVG-en. Begge står i `icons`-oppføringa i `static/manifest.webmanifest` med rett storleik og `type: "image/png"`, **etter** SVG-oppføringa, og begge er med i `STATIC_FILES` i `app.py` og i skal-allow-lista i `static/sw.js`. -4. `tests/test_pwa.py` pinnar favicon-lenka og merket på alle seks sidene, `.brand-mark`-stilen, at dei to SVG-filene har same teikning, at kvar PNG er den storleiken han oppgjev, og at begge blir serverte. +**Køyrt så langt 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, og lukka programvarevarsel i historia og CSV-en — alle OK. **Att:** CSRF-testen (ein `POST` til `/api/settings/wallet-software` utan CSRF-headeren, venta `403`) og PWA offline og online etter logout, pluss brukaren si stadfesting. To merknader: avviket i punkt 1, og at 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. -## 32.2 UI-finpussen — utført +## 32.6 Dokumentasjonsdrifta -Retro-temaet (Windows-app, midten av 90-talet) ligg i `static/styles.css`: bakgrunn `#c0c0c0`, felt `#ffffff`, mørk kant `#808080`, mørkast `#000000` og tittelstripe `#000080` med kvit tekst. Ingen `border-radius`, ingen `box-shadow` og ingen gradientar — djupna kjem av 3D-kantar. Skrifta er systemfont-stabelen `"MS Sans Serif", Tahoma, Verdana, Geneva, sans-serif` i 12–13 px, fokus er `outline: 1px dotted #000000`, og tabellane er rutemønster med 1 px rammer. `theme-color` på dei fem sidene og `/login` og `theme_color`/`background_color` i manifestet er `#c0c0c0`. +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. -1. Luft mellom hjelpetekst og neste blokk: `.field-help + .field-grid, .field-help + .form-stack { margin-top: 12px; }`. -2. Åtvaringa mot å lime inn ei løyndom står no éin gong, som eitt `p.secret-warning` over heile nøkkel-lista i `setup.html`; `setup.js` legg henne ikkje lenger inn per kort. -3. Dashbord-overskrifta blir fylla av `renderSetupHeading()` i `app.js` frå `threshold` og `key_count` i `/api/setup`; linja i markupen er fallbacken. -4. «An overview of your multisig setup and annual checks.» er fjerna. -5. `section.setup-card` er fjerna, saman med `setupTitle`, `setupDescription` og `renderSetupShape()`. -6. Nøkkelkortet viser nummer og type på den øvste linja (`01 · Hardware`). -7. Nøkkelkortet viser berre stien, i skrå skrift (`.key-path`), utan prefikset `Address path:`. -8. Nøkkelkortet viser berre modellnamnet, under namnet og over stien, og hoppar over det når det berre gjentek nøkkelnamnet (`sameLabel()`). -9. Nøkkelkortet viser berre `Next check due`; `Last checked` er borte. -10. Den korte åtvaringa er fjerna frå `health-check.html`, `health-check.js`, `settings.js` og `setup.js`. Serveren er uendra: eit løyndom i eit fritekstfelt blir framleis avvist med `400`. -11. `Needs assessment`-lista i Review-oppsummeringa er fjerna; `Results requiring follow-up` står. -12. Oppsummeringslinja i Review med `Key N: … · Check date: … · Next check due: …` er fjerna. -13. `Local service` i topbaren og `Your data stays local.` i footeren er fjerna på alle sidene, òg `/login`. -14. Historikk-kortet viser datoen, nøkkelnummeret og namnet nøkkelen har no, og ein kort status (`All OK` / `Needs follow-up`). Dette kravde eit **additivt** felt i oppsummeringa: `GET /api/health-checks` gjev no `key_names` og `needs_follow_up` i tillegg til felta som alt var der (§11). `needs_follow_up` er ein eigenskap ved den lagra kontrollen, så han endrar seg ikkje når brukaren lukkar varselet seinare. -15. Historikk-tabellane held seg innanfor sida på ein smal skjerm, med `table-layout: fixed`, `overflow-wrap: break-word` og mindre skrift på `.detail-table`. Løyst i CSS, utan ny JavaScript. +- `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. +- `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`. -Etterrunden av §32.1 og §32.2 — faviconet, merket, footeren og historia: +**Merk:** skriv det som faktisk skjer. Viss avviket i §32.8 punkt 1 ikkje blir retta først, skal dokumenta seie at oppgåva blir reist og står på Tasks, ikkje at ho held servicen tilbake. -16. Footeren ligg nedst på sida òg når innhaldet er kort: `body` er ein kolonne med `min-height: 100vh` og `100dvh`, og `main { flex: 1 1 auto; }` tek resten. -17. Faviconet ligg på alle seks sidene. -18. Merket i topplinja er ikonet som bilete, med same klasse `brand-mark`. -19. «Back to dashboard» er fjerna frå `history.html`, `settings.html`, `setup.html` og `health-check.html`; merket «VardKey» er vegen tilbake. Lenkja i sperre-noten i skjemaet står. -20. «Start annual health check»-knappen er fjerna frå `history.html`. Ein kontroll blir starta frå dashbordet. -21. Historie-visninga i `history.js` slår saman programvara og versjonen hennar på éi line (`Sparrow Wallet 2.5.1`) og modellen og firmware-versjonen på éi line (`Blockstream Jade 1.4.1`); manglar ein del, står resten åleine, og manglar båe, står `—`. Lukke-tabellen viser `Alert`, `Action` og `Closed` — kjelde-kolonnen er borte. Dette kravde eit **additivt** felt i svaret: `GET /api/health-checks/` ber no `model` på kvart nøkkelrecord (§11). - -**Testar:** `tests/test_health_check_form.py`, `tests/test_pwa.py`, `tests/test_secret_guard.py`, `tests/test_key_status.py` og `tests/test_app.py` er oppdaterte. Suiten gjekk frå 477 til **484 testar**, etterrunden la til ti og PNG-ikona fire til, så han stod på **498 testar**. - -## 32.3 Meldingstekstane i varsla — utført - -1. Kvar av dei elleve varselradene i §7 har ein `message` i `alerts.py`, og alle er skrivne i same form: kva som er gale, kva nøkkel eller programvare det gjeld, og kva som lukkar varselet. `code`, alvor, kjelde, handlingar og `software`-feltet er uendra, og forma er no presisert i §7. -2. Meldinga gjentek ikkje namnet i `source`; ho seier «this key». Det einaste unntaket er den nøkkelforma av `software_incompatible` som namngjev programvara, fordi kjelda der er nøkkelen. -3. `_VULNERABLE_MESSAGE` og `_COMPROMISED_MESSAGE` er delte i kvar si melding for nøkkel- og programvareforma, sidan dei to formene blir lukka av kvar si handling. `_HARDWARE_FAILURE_MESSAGE`, `_SEED_BACKUP_MESSAGE` og malen `_SOFTWARE_INCOMPATIBLE_KEY_MESSAGE` er trekte ut av `_key_alerts`. -4. «Replace the key» er borte der den einaste handlinga er `rotate`, og «PROTOCOL 3: key loss» og «follow the key loss procedure» er tekne bort, sidan ingen av dei er definerte nokon stad. -5. Sperre-svaret (`409`) seier ikkje lenger den interne koden: «This key has an open alert. Close the alert before recording a new check.» -6. Sidetekstane som vart rydda: den dupliserte eyebrow-en i `index.html` og `settings.html`, den dupliserte `Sign in`-overskrifta i `login.html`, den dupliserte hjelpelinja og den døde `#software-help`-teksten i `health-check.html`, dei to `Removing an entry…`-hjelpene i `settings.html` slått saman til eitt avsnitt, «Open the settings» i både `setup.js` og `app.js`, og den gjentekne personvernsetninga i `app.js`'s `setupDescription`. `validation.py`-meldinga er skriven om til «this name already comes from a configured cloud key». -7. Medvite uendra: `ACTION_LABELS` / `ACTION_CONFIRMATIONS` i dei tre kopiane, og `UNAVAILABLE_MESSAGE` i `health-check.js`. - -**Testar:** `tests/test_alerts.py` held tekstane; seks testar er oppdaterte eller omdøypte, og éin ny pinnar at nøkkelforma og programvareforma av same kode har kvar si melding. `tests/test_app.py` held ikkje på nokon meldingstekst. - -## 32.4 Bug-rapporten — utført, utanom BR-003 - -Rapporten vart skriven mot eit anna filsett; dei åtte dokumenta han ber om finst ikkje her, og skal ikkje opprettast. Kvar BR vart verifisert i koden som ligg i dette repoet før noko vart endra: - -- **BR-001 — falsk positiv.** Kjeldefilene ligg i `main` og er spora av Git; rapporten bygde på repo-visinga, ikkje på ein checkout. -- **BR-002 — stadfesta og retta** i runde 32-B, sjå nedanfor. -- **BR-003 — står att.** Sjå «Det som står att i 32.4» nedanfor. Han er no punkt 7 i §32.8. -- **BR-004 — fell bort.** `AI-STATUS.md` og `DATA-MODEL.md` finst ikkje i dette repoet, og koden følgjer alt kontrakten i §4–§7. Den reelle dokdrifta er 32.6. -- **BR-005 — verifisert i koden, inga åtferdsendring.** Berre `GET /health`, `GET /api/session` og `/login` er opne; alle andre `/api/*` svarar `401` og sidene `302` til `/login`; kvar tilstandsendrande POST krev økt og CSRF-token (`403`). Passordet er ein `hashlib.scrypt`-hash med salt per passord, økta ein HMAC-SHA256-signert cookie med utløp, og begge samanlikningane brukar `hmac.compare_digest`. `Secure`-flagget er medvite utelate, fordi StartOS terminerer TLS og proxyar rein HTTP inn i containeren. -- **BR-006 — retta i `export.py`.** Ei tekstcelle som byrjar med `=`, `+`, `-`, `@` eller eit kontrollteikn — òg etter leiande mellomrom — blir prefiksa med ein apostrof (§10). -- **BR-007 — retta i `static/sw.js`.** Tenestearbeidaren lagrar no eit svar berre når det er vellukka, same-opphav og ikkje omdirigert (§12). -- **BR-008 — retta i `validation.py`.** Samanlikninga av adressestiar fellar no òg den harda markøren (`h`/`H` ≡ `'`), i oppsettet, i innstillingane, ved rotering og i kontrollen. Den lagra verdien blir aldri skriven om (§4). - -**Runde 32-B.** `secret_guard.py` avviser eit wallet-løyndom i kvart fritekstfelt med `400`, før noko blir lagra og før lengdegrensa til feltet; `auth.py` gjer det same for adminbrukarnamnet, men ikkje for passordet. Meldinga namngjev feltet og forma og gjentek aldri verdien. Sjekken er lokal og gjer ingen nettverkskall. Ordlista, mønstra og dei kjende avgrensingane står i modulens docstring. Reglane står òg i §2, §12 og §15. - -**Testar:** ti i runde 32-A og 43 i den nye `tests/test_secret_guard.py` i runde 32-B. Suiten gjekk frå 422 til **484 testar**, og vidare til 498 etter etterrunden av §32.1 og §32.2. - -**Det som står att i 32.4:** berre **BR-003**, og han må lesast rett. Rapporten siterer ein §31-tekst om at den manuelle gjennomgangen står att, men den teksten finst ikkje lenger, og §16 og §17 seier at dei manuelle nettlesartestane og bokstestane vart køyrde og verifiserte fram til §31. Det som faktisk står att, er difor dei **nye** manuelle punkta §32 legg til — ikonet, UI-pussen og retro-temaet på ein smal telefon, ein kikk på varsellista, nøkkelkortet og sperre-noten etter tekstendringane, menyen og det rydda dashbordet, og eksportseksjonen på history-sida — saman med heile bokstesten på nytt etter §32.5, og ei stadfesting frå brukaren på at dei er køyrde. Ikkje re-verifiser det §16 og §17 alt har som gjort. Punkta i BR-003 er førte opp som punkt 7 i §32.8. +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`. ## 32.5 Hevinga av pakkeversjonen - Pakkeversjonen blir heva frå `0.1.0:0` til `1.0.0:0` når punkta over er ferdige og brukaren seier ifrå. §18 steg 12 («bygg endeleg `.s9pk` og gjer første release») høyrer til same runden. - Inga skjemaendring, ingen nye endepunkt og ingen nye funksjonar i denne runden. `startos/versions/` held fram tomt for datamigrasjonar, sidan appen migrerer skjemaet sitt sjølv. - -## 32.6 Dokumentasjonsdrifta - -Dokumenta som skildrar pakka og appen, er skrivne før §31 og før 32-A, 32-B og 32.2, og dei er framleis ikkje oppdaterte. Dette punktet rettar dei. Det må gjerast **etter** 32.1–32.3, 32.7 og 32.8 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. Etter §32.7 manglar dokumenta i tillegg menyen i topplinja, at dashbordet ikkje har `Next check`-kortet og history-blokka, at `Download CSV` og noten ligg i sin eigen `Export`-seksjon på history-sida, at menyen merkjer sida ein står på, hoppet til `#history-detail`, og robots-sperra. Etter §32.8 kjem òg: admin-steget og pakkeoppgåva som held servicen tilbake, `429`-låsinga av innlogginga, at ein kontroll-dato ikkje kan liggje i framtida, den faste topplinja, at ei rotering legg til ei ny nøkkelrad og at historia er frosen, at eit lukka programvarevarsel òg står i historia og CSV-en, og at skjemaet er **13**. - -- `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 frå §32.8 ei påkravd oppgåve som held servicen tilbake til adminpassordet er sett. 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 òg 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. Etter 32.2 manglar han òg `key_names` og `needs_follow_up` i `GET /api/health-checks`, og skildringa av felta ved kvart fritekstfelt. Etter runden 32.1 manglar han `model` i `GET /api/health-checks/`, favicon-lenka på sidene og dei to PNG-ikona med sine eigne stiar. «a fixed 2-of-3» i innleiinga og «the three key profiles» under «Current status» er òg utdaterte etter §31 punkt 7. Etter §32.7 manglar han robots-fila, robots-metaen, `X-Robots-Tag`, menyen i topplinja, at `Download CSV` og noten no ligg i sin eigen `Export`-seksjon på history-sida, og ankeret `#history-detail`. Etter §32.8 manglar han i tillegg 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 den påkravde oppgåva som held servicen tilbake til admin finst. -- `instructions.md`: manglar innloggingssteget, opprettinga av admin, dei to handlingane i `Actions & Config` og den påkravde oppgåva frå §32.8 punkt 1. «exactly three keys … another threshold is not supported» er feil etter §31 punkt 7. -- `UPDATING.md`: seier skjema **11**; det er **13** etter §32.8. 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. Etter §32.8 bør han òg nemne `startos/init/requireAdmin.ts` og den påkravde 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`. - -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`. - -## 32.7 Dashboard-menyen og oppryddinga i dashbordet — utført - -Seks punkt, inga skjemaendring, ingen nye endepunkt, ingen nye funksjonar, og `static/robots.txt` var den einaste nye fila. Runden vart utførd **før** 32.6 og 32.5, og §8, §9 og §12 skildrar no den nye sanninga, sidan §1–§18 skildrar appen slik han er no. - -1. **Meny i topplinja i staden for «Sign out».** `static/session.js` byggjer ein `Menu`-knapp med nedtrekk på alle fem app-sidene (`/login` har framleis ingen). Vala, i denne rekkjefølgja: `Start health check` → `/health-check`, `Settings` → `/settings`, `History` → `/history`, så ein skiljelinje, og til slutt `Sign out`, som gjer det same som før (`POST /api/logout` gjennom den pakka `fetch`-en, deretter `/login`). `Sign out` er ein `