diff --git a/TODO.md b/TODO.md index 9c0ba3d..1ff1862 100644 --- a/TODO.md +++ b/TODO.md @@ -20,7 +20,7 @@ Appen skal **berre registrere resultat og historikk**. Han skal ikkje signere Bi - **§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 §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. +- **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. --- @@ -357,7 +357,7 @@ StartOS 0.4.0 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:** 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. +**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. Unngå: Postgres, Redis, ekstern backend, ekstern cloud-service for appdata, og ekstra container utan konkret behov. @@ -423,7 +423,7 @@ Unngå: Postgres, Redis, ekstern backend, ekstern cloud-service for appdata, og - 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 eit vellukka innlogging nullstiller teljaren (§32.8 punkt 2). +- 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). @@ -522,25 +522,25 @@ Alle rundane under er implementerte og verifiserte. Reglane deira ligg i §1– | §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.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. Det som står att -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. +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. -## 32.8 Dei sju punkta — punkt 1–6 er utførte, punkt 7 står att +## 32.8 Dei sju punkta — alle sju er utførte og verifiserte -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. +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.** 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). +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). -**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. +**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. ## 32.6 Dokumentasjonsdrifta @@ -553,7 +553,7 @@ Dokumenta som skildrar pakka og appen, er skrivne før §31 og før 32-A, 32-B, - `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. 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. +**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. 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`.