79 KiB
TODO — VardKey for StartOS 0.4.0
Mål
Bygg ein enkel lokal web-app som køyrer som ein StartOS 0.4.0-service.
Appen skal hjelpe éin brukar å gjennomføre og dokumentere ein årleg health check av eit multisig-oppsett (standard 2-av-3 med tre nøklar; terskel og talet på nøklar er valfritt). Namn, type, modell og adressesti blir konfigurerte ved første oppstart.
Appen skal berre registrere resultat og historikk. Han skal ikkje signere Bitcoin-transaksjonar, handtere private nøklar eller utføre wallet-operasjonar.
Språkkrav
- Brukargrensesnittet, app-tekst, kjeldekode, variabel- og funksjonsnamn, kommentarar og teknisk dokumentasjon skal vere på engelsk.
TODO.mder på norsk; dette er det einaste unntaket.
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 (ikonet med favicon og PNG-ar), §32.2 (UI-passet med retro-temaet), §32.3 (varsel- og sidetekstane), §32.4 (bug-rapporten) og §32.7 (dashboard-menyen og oppryddinga i dashbordet, med etterrunden sin) er utførte. I §32.4 står berre BR-003 att, og han kan berre brukaren lukke. §32.6 og §32.5 står att. Etterrunden av §32.1 og §32.2 — faviconet, merket i topplinja, footeren nedst på sida, den eine vegen tilbake, history-knappen og linje- og tabellendringane i historia — er òg utførd.
- 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. Av §32 står §32.6 og §32.5 att. Skjema versjon 12, testsuiten grøn (513 testar), og StartOS-pakka er bygd, sideloda og køyrd på ein eigen StartOS 0.4.0-boks. Pakkeversjonen står på
0.1.0:0og blir ikkje heva før §32 er ferdig og brukaren seier ifrå.
1. Scope for første versjon
Dette skal vere med
- Ein enkel web-app med dashboard.
- Registrering av nøklane i multisig-oppsettet.
- Registrering av årleg health check, med kontroll av alle punkta i den årlege sjekklista.
- Varsel når eit kontrollpunkt krev oppfølging.
- Historikk over gjennomførte health checks.
- Automatisk forslag til neste sjekk, ca. eitt år fram i tid.
- Rapporteksport i CSV-format.
- Lokal SQLite-database.
- Persistent lagring på StartOS.
- StartOS health check.
- StartOS backup og restore.
- Passordvern med ein adminbrukar, og ein veg til å nullstille appdata frå StartOS.
Dette skal ikkje vere med
Ingen AI-integrasjon, ingen Bitcoin-node-integrasjon, ingen Bitcoin-signering, ingen PSBT-generering eller signering, ingen seed phrase-lagring, ingen private key-lagring, ingen cloud sync av appdata, ingen ekstern database, ingen offline-database og ingen offline-registrering av kontrollar (ein installerbar PWA utan offline-data er tillaten), ingen kalenderintegrasjon, ingen avansert analyse eller grafar, og inga støtte for fleire multisig-oppsett — det er framleis berre eitt oppsett, men terskelen og talet på nøklar i det er valfrie.
Merk: dette er eit varig forbod, ikkje ei oppgåveliste. Det skal stadfestast på nytt før release.
2. Viktige reglar for appen
- Appen skal aldri spørje etter seed phrase, private keys, PIN, passord eller wallet-hemmelegheiter, og aldri lagre slike. Det gjeld wallet-hemmelegheiter: adminpassordet er den einaste akkrediteringa appen lagrar, og han blir lagra som ein
hashlib.scrypt-hash, aldri i klartekst. - Eit fritekstfelt avviser eit innlimt wallet-hemmelegheit lokalt, før noko blir lagra (sjå §15). Den korte åtvaringa mot å lime inn ei løyndom står éin gong, i nøkkeloppsettet, og blir ikkje gjenteken per fritekstfelt (sjå §12 og §15).
- Kontaktinformasjon til nøkkelhaldarar skal ikkje lagrast; berre om kontaktinfo er stadfesta.
- Appen skal ikkje late som han sjølv har utført ein hardware-test. Brukaren registrerer resultatet av testen.
- Appen skal vere lokal og enkel. Dersom noko ikkje er nødvendig for den årlege health check-en, skal det ikkje byggjast.
3. Nøkkeloppsettet
Appen er bygd for eitt multisig-oppsett. Ved første oppstart gjev brukaren terskelen og talet på nøklar, og kvar nøkkel får namn, type (hardware/cloud), ein valfri modell/teneste og ein adressesti.
- Terskelen er
1 ≤ threshold ≤ key_count, og2 ≤ key_count ≤ 15. Appen legg inga meining i tala sine. - Namnet brukaren skriv, er produktetiketten overalt: skjema, varsel, historikk og CSV-eksport. Nøkkelnummeret blir vist saman med namnet der det trengst, t.d.
Key 1: ColdCard. - Nøkkeltypen styrer kontrollane, aldri nøkkelnummeret.
typeogaddress_pather identiteten til nøkkelen og er låste etter oppsettet. Namnet og modellen kan endrast i innstillingane. Berre ei rotering, som byter ut nøkkelen med ein ny, kan gi han den andre typen.
Standardoppsettet appen vart bygd for, med døme-adressestiar:
| Nøkkel | Type | Eining | Adressesti (døme) |
|---|---|---|---|
| 1 | Hardware | SeedSigner | m/48'/0'/0'/2' |
| 2 | Hardware | Blockstream Jade | m/48'/1'/0'/2' |
| 3 | Cloud | Nunchuk | m/48'/2'/0'/2' |
4. Datamodell
SQLite, med så få tabellar som mogleg. Kvar tabell har éi rad per kolonne her; kolonnar merkte * er legacy-kolonnar som berre finst for gamle rader og aldri blir skrivne på nytt.
keys — nøkkelplassane i det eine oppsettet.
id, key_number (1–multisig_key_count), name, type (hardware/cloud), model, address_path, created_at.
health_checks — éi rad per innsending, som gjeld éin vald nøkkel.
id, checked_at, next_check_due, wallet_software, software_version, software_compatibility_status, software_comments, sparrow_version*, nunchuk_version*, contact_info_verified, comments.
key_checks — eitt record for den valde nøkkelen i kvar innsending.
id, health_check_id, key_id, available, hardware_works, firmware_version, seed_backup_verified, address_path_verified, address_path, comments.
ai_security_checks — KI-sikkerheitsstatus per leverandør.
id, health_check_id, provider, status, comments.
wallet_software — lista brukaren vedlikeheld i innstillingane.
id, name, created_at.
alert_acknowledgements — kvitterte varsel.
id, code, source, key_id, check_id, reason, acknowledged_at.
app_settings — namn/verdi, for det som ikkje er historikk.
name (PRIMARY KEY), value. Held multisig_threshold, multisig_key_count, admin_username, admin_password_hash og session_secret.
Reglar:
hardware_works,firmware_versionogseed_backup_verifiedgjeld berre hardware-nøklar.seed_backup_verifiedogaddress_path_verifiedhar berre verdianeOKellerPROBLEM.address_pathlagrar adressestien for den kontrollen.- Når
availableer Nei, blir dei andre nøkkelfelta tømde, medan nøkkelnotatet blir behalde. - Når
availableer Nei, blirwallet_softwareogai_security_checksikkje registrerte i det heile. typeblir lagra éin gong ved første oppstart og er låst etterpå; berre ei rotering kan gi nøkkelen den andre typen.modeler valfri fri tekst (maks 60 teikn) og er rein dokumentasjon: ein hardware-modell eller, for ein cloud-nøkkel, namnet på tenesta. Han er ikkje ein del av identiteten, ikkje eit wallet-programvare-val, og blir ikkje brukt i varselkjelda.providerlagrar det konfigurerte nøkkelnamnet og den valde programvara, ikkje faste produktnamn.contact_info_verifieder fri tekst med to verdiar, og har ingen «not assessed»-verdi.hardware_workser obligatorisk for ein tilgjengeleg hardware-nøkkel.namekan endrast i innstillingane;typeogaddress_pather identiteten til nøkkelen.address_path_verifiedblir sett av serveren ut frå ei samanlikning medkeys.address_path, og blir ikkje sendt inn av brukaren.wallet_softwareihealth_checksheld fram som fri tekst, slik at eldre rader og fjerna listeelement held fram å visast rett.address_pathmå vere unik på tvers av alle nøklane i oppsettet: i oppsettet, i innstillingane og ved rotering. Samanlikninga er kanonisk:h/Hog'er same markør, og luft og store/små bokstavar blir ignorerte. Den lagra verdien blir aldri skriven om.reasonialert_acknowledgementslagrar namnet på handlinga som lukka varselet, ikkje ein fri tekst.key_idialert_acknowledgementslagrar nøkkelen varselet høyrde til, ellerNULLfor eit programvarevarsel frå innstillingslista.tool_checksfinst ikkje.device,seed_backup_status,address_verified,derivation_height,cloud_health_statusogcloud_provider_operationalfinst ikkje.
5. Statusverdiar
- Generelle kontrollar brukar
OKellerPROBLEM.NOT_ASSESSEDfinst berre som den utleidde verdien forsoftware_compatibility_statusnår nøkkelen ikkje kunne kontrollerast; ingen andre felt tilbyr eller godtar han. seed_backup_verifiedogaddress_path_verifiedbrukar berreOKellerPROBLEM.- KI-sikkerheitsstatus brukar nøyaktig
SECURE,PATCHED,VULNERABLEogCOMPROMISED. - Kontaktstadfesting brukar
Confirmed currentellerNeeds external update. Hardware works(Yes/No) ogSoftware compatibility(OK/PROBLEM) krev eit aktivt val for ein tilgjengeleg nøkkel.address_path_verifieder utleidd av serveren og er ikkje eit val i skjemaet.- Same statuslogikk i database, validering, varsel, CSV-eksport og UI.
- Ikkje bland saman «ikkje vurdert» og eit faktisk negativt resultat.
6. Årleg health check — steg for steg
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. - Neste sjekkdato blir rekna ut på serveren som eitt kalenderår etter sjekkdatoen, og kan ikkje redigerast i skjemaet.
Steg 2 — Key (02 / Key)
- Brukaren vel kva nøkkel innsendinga gjeld. Ei innsending gjeld éin nøkkel.
Availabilityer obligatorisk: Ja eller Nei.- Ein nøkkel med eit ope varsel kan ikkje veljast, og skjemaet seier kva varsel som står i vegen.
- Hardware-nøkkel:
Hardware workser obligatorisk (Yes/No), firmware-versjon blir registrert, og seed-backup intakt og stemmande med hardware girseed_backup_verified(OK/PROBLEM). Kommentar ved behov. - Cloud-nøkkel: berre
Availabilityblir spurd om. Kommentar ved behov. - Adressesti (alle nøklar): brukaren registrerer berre
Address path, førehandsutfylt med nøkkelen sin lagra sti. Serveren samanliknar den innsende stien medkeys.address_pathetter den kanoniske regelen i §4: lik →OK, ulik →PROBLEM. - Når nøkkelen ikkje er tilgjengeleg, blir resten skjult og ikkje kravd.
- Stemmer ikkje stien, viser nettlesaren eit påminningsvarsel før innsending, og kontrollen blir lagra som ein nøkkel som ikkje kunne kontrollerast.
Steg 3 — Compatibility (03 / Compatibility)
- Brukaren vel éi wallet-programvare: eit namn frå innstillingane, eller namnet på ein konfigurert cloud-nøkkel. Ein cloud-nøkkel er låst til sitt eige namn.
Software versionblir registrert for alle nøklar, òg ein cloud-nøkkel.OKellerPROBLEM, med kommentar ved problem.- For ein cloud-nøkkel er
Wallet softwareogCompatibility statusskjulte og utleidde. - Når nøkkelen ikkje er tilgjengeleg, er feltet skjult og valfritt.
Steg 4 — External research (04 / External research)
- Leverandørar per innsending: den valde nøkkelen (ved namn) og den valde programvara.
- Registrer status (
SECURE/PATCHED/VULNERABLE/COMPROMISED) og ein kort kommentar. - Berre den valde nøkkelen og den valde programvara blir registrerte. Appen kontaktar ikkje KI sjølv.
- Når nøkkelen ikkje er tilgjengeleg, blir ingen statusar registrerte.
Steg 5 — Contact confirmation (05 / Contact confirmation)
- Stadfest at kontaktinformasjonen til nøkkelhaldaren til den valde nøkkelen er gyldig:
Confirmed currentellerNeeds external update. Stadfestinga er obligatorisk, òg når nøkkelen ikkje er tilgjengeleg. - Berre statusen blir lagra. Ikkje lagre namn, telefonnummer, e-post eller anna kontaktinnhald.
Steg 6 — Notes (06 / Notes)
- Eitt overordna kommentarfelt for observasjonar, og eigne kommentarar per nøkkel der det trengst.
Oppsummering før lagring (Review-panelet)
- Før lagring viser appen alle kontrollpunkt, alle problem, alle manglande kontrollar, neste sjekkdato, handlingar som bør følgjast opp, og utleidde verdiar merkte som nettopp det.
- Brukaren må trykkje
Lagre health checkfor å lagre kontrollen. - Når adressestien ikkje stemmer, blir valet om å lagre likevel tydeleg merkt i oppsummeringa.
7. Varsel og oppfølging
Alle lagra kontrollar blir lesne, ikkje berre den nyaste. Like varsel (same code og source) blir slegne saman, og berre den nyaste blir vist. Kritiske varsel blir lista før informative, og nyaste kontroll først innanfor kvar alvor. Eit kvittert varsel held seg skjult til ein nyare kontroll for same code og source utløyser det igjen. Eit varsel som høyrer til ein nøkkel, blir i staden skjult etter nøkkelen, så ei omdøyping ikkje opnar det att.
Eit ope varsel som høyrer til ein nøkkel sperrar den nøkkelen til varselet er lukka. Serveren handhevar regelen, så eit direkte API-kall ikkje kan omgå han. Sperringa gjeld berre den nøkkelen som har varselet.
code |
Alvor | Kjelde | Utløyst av | Slik blir det lukka |
|---|---|---|---|---|
key_unavailable |
critical | nøkkel | available = Nei |
Rotering |
address_path_mismatch |
critical | nøkkel | Adressestien stemmer ikkje med den lagra | Rotering |
hardware_failure |
critical | nøkkel | Hardware works = No |
Rotering, eller at hardware-walleten blir bytt med same seed |
seed_backup_problem |
critical | nøkkel | Seed-backup PROBLEM |
Rotering |
software_incompatible |
critical | nøkkel | software_compatibility_status = PROBLEM, og den registrerte programvara er namnet på ein konfigurert cloud-nøkkel |
At hardware-walleten blir bytt |
software_incompatible |
critical | programvare | software_compatibility_status = PROBLEM |
Fjerning av den feilande programvara i innstillingane |
security_vulnerable |
critical | nøkkel | KI-status VULNERABLE |
Rotering, eller lukking utan tiltak |
security_vulnerable |
critical | programvare | KI-status VULNERABLE |
Fjerning av programvara, eller lukking utan tiltak |
security_compromised |
critical | nøkkel | KI-status COMPROMISED |
Rotering er påkravd |
security_compromised |
critical | programvare | KI-status COMPROMISED |
Fjerning av programvara |
contact_info_unconfirmed |
info | nøkkel | Kontaktstadfesting Needs external update |
Lukking, etter at kontaktinformasjonen er oppdatert eksternt |
Forma på meldingane. Kvar rad over har ein message i alerts.py, og alle elleve er skrivne om til same form (§32.3): kva som er gale, kva nøkkel eller programvare det gjeld, og kva som lukkar varselet. Meldingane er engelske, korte og konkrete, og dei seier ikkje at appen sjølv har gjort noko.
-
Meldinga gjentek ikkje namnet i kjelda.
sourceer antenKey N: <namn>eller namnet på programvara, og han blir vist rett over meldinga i varsellista, i parentes på nøkkelkortet og framføre meldinga i sperre-noten i skjemaet. Difor seier meldinga «this key» og ikkje nøkkelnamnet. Det einaste unntaket er nøkkelforma avsoftware_incompatible: der er kjelda nøkkelen, medan meldinga namngjev programvara, sidan ho ikkje står nokon annan stad i den forma. -
Dei to formene av ein KI-kode har kvar si melding.
security_vulnerableogsecurity_compromisedblir lukka av kvar si handling alt etter om kjelda er nøkkelen eller programvara, så kvar form seier kva som lukkar henne. -
Handlinga står òg i knappen og i sperre-noten. Det er medvite: knappen og noten seier kva brukaren kan trykkje på, medan meldinga skal stå åleine når ho blir lesen utan knappane.
-
Meldinga viser ikkje den interne koden.
codeer for API-et og foralert_acknowledgements, ikkje for brukaren. -
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. -
rotateblir utført i innstillingane, sidan han krev ein ny adressesti. Dei andre handlingane blir utførte der varselet står, kvar med sin eigen knappetekst og sitt eige stadfestingssteg. -
Kjelda til eit KI-varsel er leverandøren. Er han nøkkelen sitt eige konfigurerte namn, er nøkkelen kjelda, ho blir skriven som
Key N: <namn>på same måte som alle andre nøkkelvarsel, og ei rotering lukkar varselet. Elles er leverandøren programvara nøkkelen køyrer med, kjelda er berre namnet hennar, og varselet blir lukka ved å fjerne ho frå innstillingane. -
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.
-
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.
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, utanYour keys-overskrift og utan nøkkelteljar (§32.7 punkt 2). - 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 <dato>, for Key N: <namn>.). 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 punkt 1).
- 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).
9. Historikk
- Vis alle gjennomførte health checks kronologisk, nyaste først, med kva nøkkel kvar innsending gjeld.
- 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 verifiedsom den utleidde verdien han er, og ikkje som eit brukarval. - Vis namnet nøkkelen har no, sidan namnet kan endrast i innstillingane.
- Vis kva varsel som vart lukka på kontrollen, med kva handling og kva dato.
- Kortet i lista viser datoen, nøkkelnummeret og namnet nøkkelen har no, og ein kort status:
All OKellerNeeds follow-up(§32.2 punkt 14). Det kjem fråneeds_follow_upi 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,ActionogClosed. Kjelda er inga eiga kolonne (runden 32.1). - Sida har lenkja
Download CSVi overskrifta, utandownload-attributt, så filnamnet fråContent-Dispositionvinn, og noten som forklarar eksporten står rett under lenkja (§32.7 punkt 5 og etterrunden punkt 1). Det er den einaste staden eksporten blir lasta ned frå, og sida startar ikkje ein ny kontroll. Viewi 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).
10. Rapporteksport
GET /api/exportgjev rein CSV (UTF-8, komma, CRLF, header). Ingen XLSX, og appen lovar ikkje Excel-kompatibilitet.- Éi rad per nøkkelsjekk. Kolonnen
Check idknyter saman rader frå same innsending. - Inneheld dato, neste sjekk, nøkkelstatus, hardware/firmware, seed-resultat, adresse-sti, programvare og kompatibilitet, KI-status, kontaktstadfesting og kommentarar.
- 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/1blir skrivne somNo/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å oppsettet, og namnet er namnet nøkkelen har no.
- Nedlastinga heiter
YYYY-MM-DD-vardkey-export.csv, med datoen serveren har når han svarar. - Siste kolonne,
Follow-up closed, listar varsla som vart lukka på kontrollen, somcode: action (YYYY-MM-DD). Berre lukkingar som høyrer til ein nøkkel, blir viste.
11. Backend
- SQLite med initialisering og migrering. Skjemaet er versjon 12.
- Lagring av nøklar, health checks, historikk og rapporteksport.
- Varsellogikken (§7).
- Health endpoint, som er det einaste endepunktet utanfor innlogginga.
- Valider input på serveren, og bruk parameteriserte SQL-spørringar.
Minimumsendepunkt: GET /health, GET /api/keys, GET /api/health-checks, GET /api/health-checks/:id, POST /api/health-checks, GET /api/export.
Merk: GET /api/session, POST /api/admin, POST /api/login, POST /api/logout, GET /api/setup, POST /api/setup, GET /api/settings, POST /api/settings/keys, POST /api/settings/wallet-software, POST /api/keys/<id>/rotate, POST /api/alerts/acknowledge, GET /api/key-status, GET /api/previous-values og GET /api/alerts er ekstra endepunkt utanom minimumslista, fordi oppsettsteget, innstillingane, dashboardet, skjemaet og innlogginga treng dei. Dei står ikkje i spesifikasjonen enno.
POST /api/health-checkskrev éin konfigurert nøkkel,availableog gyldige, relevante resultat, og avviser manglande eller dupliserte registreringar.POST /api/health-checkskrev ikkje programvare eller KI-status når nøkkelen ikkje kunne kontrollerast, og avviser slike resultat med400.POST /api/health-checksavviser ein nøkkel som har eit ope varsel, med409, og regelen blir handheva før resten av valideringa.POST /api/setuplagrar multisig-tala og nøkkeloppsettet éin gong med namn, type, modell og adressesti, og avviser eit nytt oppsett med409.POST /api/setup,POST /api/settings/keysogPOST /api/keys/<id>/rotateavviser ein adressesti som ein annan nøkkel alt har (400i oppsettet og roteringa,409i innstillingane). Samanlikninga er kanonisk, sjå §4.GET /api/settingsgjev nøklane med adressestien og modellen deira og lista over wallet-programvare.POST /api/settings/keyslagrar eit nytt namn og ein modell, og ein adressesti så lenge nøkkelen ikkje har nokon lagra kontroll. Typen er aldri med i payloaden.POST /api/settings/wallet-softwarelagrar heile lista, og lukkar varsla til ei programvare som blir fjerna.POST /api/keys/<id>/rotateroterer ein nøkkel med ein ny, unik adressesti, kan gi nøkkelen den andre typen, og kvitterer ut varsla hans.POST /api/keys/<id>/rotateavviser med409ein typeendring som ville gjort nøkkelen til ein cloud-nøkkel under eit namn som wallet-programvare-lista alt har.POST /api/alerts/acknowledgekvitterer ut eit varsel medcode,sourceog handlinga som lukkar det.GET /api/health-checks/<id>gjev ògclosed_alerts, lukkingane som høyrer til kontrollen, og kvart nøkkelrecord bermodeli tillegg til felta det alt hadde, så historia kan vise modellen saman med firmware-versjonen (runden 32.1). Feltet kjem i tillegg, og dei eksisterande namna er uendra.GET /api/health-checksgjev kvar oppsummering med dei same felta som før, og i tilleggkey_names(namnet kvar nøkkel i kontrollen har no, i same rekkjefølgje somkey_numbers) ogneeds_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.- Feilkodar: ugyldig payload
400, ukjend nøkkel eller varsel404, låst eller duplikat adressesti409, øydelagd database500, manglande eller ugyldig sesjon401, og manglande eller ugyldig CSRF-token403. Eit fritekstfelt som ser ut som ei wallet-løyndom er òg ein400(sjå §15). _send_security_headers()leggX-Robots-Tag: noindex, nofollowpå kvart svar — sider, JSON, redirect, CSV og statiske filer — så indekseringssperra står i éin stad (§32.7 punkt 6).
12. Frontend
- Enkel responsiv web-UI. Enkelheit går framfor grafisk kompleksitet.
- Tydlege statusfelt, og faste val der statusen skal vere ein avgrensa verdi.
- Vis problem tydeleg, og vis kva som står att før ein health check kan lagrast.
- 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, ogSign outsom 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 beraria-current="page".session.jsbyggjer både knappen, panelet og.topbar-actions-innpakninga, så markupen på sidene er uendra./loginhar ingen meny, sidansession.jsikkje blir lasta der (§32.7 punkt 1 og etterrunden punkt 2). - 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.
- Innstillingsside med
01 / Wallet softwareog02 / 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 eigen01 / 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. - 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
<meta name="robots" content="noindex, nofollow">,X-Robots-Tag: noindex, nofollowstår på kvart svar, ogstatic/robots.txtsvararDisallow: /(§32.7 punkt 6).
13. StartOS 0.4.0
Appen er éin enkel StartOS-service.
StartOS 0.4.0
└── VardKey
├── Web UI
├── Backend/API
├── SQLite
└── Persistent data
- Opprett StartOS package.
- Opprett manifest.
- Opprett service-definisjon.
- Opprett HTTP web-interface.
- Opprett persistent volume.
- Opprett health check.
- Opprett backup-oppsett.
- Opprett installasjons-/brukarinstruksjonar.
- Bygg
.s9pk. - Verifiser at pakken kan installerast på 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.
Unngå: Postgres, Redis, ekstern backend, ekstern cloud-service for appdata, og ekstra container utan konkret behov.
Merk: dette er eit varig forbod, ikkje ei oppgåveliste. Det skal stadfestast på nytt før release.
14. Lagring og backup
- SQLite-database skal liggje på persistent volum.
- Appdata skal overleve restart.
- Konfigurer StartOS backup av persistent data.
- Test backup og test restore.
- Verifiser at gamle health checks finst etter restore.
Merk: alle punkta er køyrde og verifiserte på boksen, gjennom §16 StartOS-testen og §17. startos/backups.ts brukar sdk.Backups.ofVolumes('main'), og databasen ligg på main-volumet på /data. StartOS stoppar servicen medan ein backup går, så databasefila er ikkje under skriving når ho blir kopiert — ingen eigen SQLite-snapshot-krok trongst, og inga kjend avgrensing står att. Punkta skal køyrast på nytt når §32 er ferdig, sidan skjemaet og innlogginga har endra seg.
15. Sikkerheit og personvern
- Ingen seed phrase, private keys, wallet-passord eller sky-tokens i databasen.
- Ingen unødvendige personopplysningar. Kontaktinfo blir berre registrert som status (
Confirmed current/Needs external update). - Valider input på serveren, og bruk parameteriserte SQL-spørringar.
- Ikkje implementer eigen kryptografi. Adminpassordet brukar
hashlib.scryptfrå 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.pyfør lagring, og før lengdegrensa til feltet. Eit felt som ser ut som ei wallet-løyndom, blir avvist med400, 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.
16. Testing
Funksjonstest
- Opprett nøklane, start ein health check, fullfør alle kontrollpunkt, lagre han og vis han i historikken.
- Start ein ny health check, og verifiser at den gamle kontrollen framleis finst.
Problemtest
- Test nøkkel utilgjengeleg, hardware-feil og seed-backup-feil.
- Test adressestifeil, både påminninga før innsending og varselet etterpå.
- Test programvare-inkompatibilitet, og at
Hardware worksog kontaktstadfestinga krev eit val. - Test KI-status
VULNERABLEogCOMPROMISED, og kontaktinfoNeeds external update. - Test rotering av ein nøkkel, med og utan nytt namn, og at rotering krev ein ny adressesti.
- Test kvittering av eit varsel, og at eit nyare varsel kjem tilbake.
- Test at ein nøkkel med eit ope varsel ikkje kan få ein ny kontroll, og at nøkkelen blir ledig igjen når varselet er lukka.
- Test at to nøklar ikkje kan ha same adressesti, korkje i oppsettet, i innstillingane eller ved rotering, òg når den andre er skriven med
h-markøren. - Test kvar varselhandling, og at eit varsel utan handlingar blir rekna som ein feil.
- Test at eit nøkkelkort viser ei varselmelding når nøkkelen har eit ope varsel.
- Test at fjerning av den feilande programvara lukkar
software_incompatible. - Test at eit lukka varsel viser seg i historikken og i CSV-en, med handling og dato.
- Test at eit kontaktvarsel gir
Needs actionog sperrar nøkkelen, og at nøkkelen blir ledig att vedcontact_updated. - Test at
software_incompatiblemed ei cloud-nøkkel-programvare girreplace_hardwarepå den kontrollerte nøkkelen, og at det same varselet frå innstillingslista held fram medremove_software. - Test at ein kan byte namn på ein nøkkel i roteringsseksjonen utan å rotere han, og at ei rotering krev stadfestingsboksen.
- Test at ei rotering kan gi nøkkelen den andre typen, og at eit namn som wallet-programvare-lista alt har, blir avvist.
- Test innlogging og sesjon: første oppstart utan admin, rett og feil passord,
401på API utan sesjon, omdirigering på sider, open/health, og eit manglande CSRF-token. - Test at eit fritekstfelt som ser ut som ei wallet-løyndom, blir avvist, at meldinga seier kva ho ser ut som, og at ingenting blir lagra eller eksportert.
- Test at ein CSV-celle som byrjar med
=,+,-,@eller eit kontrollteikn, blir eksportert som tekst, og at vanleg innhald er uendra. - 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.txtblir svara, at kvar av dei seks sidene ber robots-metaen, og at kvart svar berX-Robots-Tag. - Test menyen, at sida ein står på er gråa ut og ikkje kan klikkast, at eksport-noten står under
Download CSV-lenkja på history-sida, og at bådeViewog ei innsending landar på#history-detail.
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 på history-sida, og hoppet til #history-detail.
StartOS-test
- Installer
.s9pkpå StartOS 0.4.0, start servicen og opne web UI. - Utfør ein komplett test-check.
- Restart servicen, og verifiser at data framleis finst.
- Ta backup, restore backup, og verifiser data etter restore.
- Verifiser at
Set Admin PasswordogDelete all datastår iActions & Configog verkar. - Verifiser at ein installerbar PWA kan leggjast til frå nettlesaren.
Merk: alle er køyrde og verifiserte på boksen. vardkey_x86_64.s9pk vart sideloda og installert, servicen står som Running, helsesjekken melder «The web interface is ready», og Open UI opnar VardKey i nettlesaren på StartOS-adressa. Restart og restore heldt på dataa, og dei gamle health checkane fanst etter restore. Skal køyrast på nytt når §32 er ferdig.
17. Ferdigkriterium for første release
Før første release skal alle desse vere oppfylte:
- Appen køyrer på StartOS 0.4.0.
- Nøklane i multisig-oppsettet er representerte i appen.
- Ein komplett årleg health check kan gjennomførast i nettlesaren, og alle årlege kontrollpunkt kan registrerast.
- KI-status kan registrerast som SECURE, PATCHED, VULNERABLE eller COMPROMISED.
- Kontaktinfo kan verifiserast utan å lagre kontaktinformasjonen.
- Problem gir tydelege varsel, og eit varsel kan lukkast på den måten som høyrer til varselet.
- Neste sjekk blir lagra, og historikk fungerer.
- CSV-rapport kan eksporterast.
- Data overlever restart, og backup og restore fungerer.
- Ingen wallet-hemmelegheiter blir lagra.
- Appen er passordbeskytta med ein adminbrukar.
- All appdata kan nullstillast frå StartOS, medan adminbrukaren står att.
Merk: alle punkta er køyrde og verifiserte på boksen. Kriterielista er oppfylt, men pakkeversjonen blir ikkje heva før §32 er ferdig — sjå §32.
18. Arbeidsrekkefølgje for AI-programmeraren
Utfør oppgåvene i denne rekkjefølgja og ikkje hopp fram til avanserte funksjonar:
- 1–8. Grunnleggande web-app, SQLite og datamodellen, nøklane, health check-skjemaet, lagring og historikk, varsellogikken, dashboardet og rapporteksport.
-
- Implementer StartOS package.
-
- Implementer persistent storage og backup.
-
- Test restart og restore.
- 12. Bygg endeleg
.s9pkog gjer første release.
Merk: steg 1–11 er ferdige. Steg 12 ventar på §32.
Testar: køyr python3 -m unittest discover -s tests. Suiten skal vere grøn både på Linux og på Windows-kopien.
Hovudregel: Bygg den minste løysinga som oppfyller lista over. Ikkje legg til nye funksjonar, tenester eller arkitektur utan at dei er nødvendige for punkta i denne TODO-lista.
Reglar som gjeld alle rundar
Desse er bindande for kvar framtidig endring, ikkje berre for éin runde.
- Migreringar er additive, eller ein ombygging etter mønsteret i §21. Kvar migrasjon skal ha ein test med eit bokstaveleg eldre skjema (
SCHEMA_VERSION_nitests/test_database.py), ogPRAGMA foreign_key_checkfør commit der ein tabell blir bygd om. - API-et held namna sine. Nye felt kjem i tillegg; eksisterande felt byter ikkje namn eller type. Eit felt som forsvinn, er eit brot.
- Ei eldre database skal alltid kunne opnast og bli migrert framover. Appen skal framleis nekte å opne eit skjema som er nyare enn han sjølv kjenner, i staden for å skrive i det.
- Pakkeversjonen rører ikkje appdata. Appen migrerer skjemaet sitt sjølv ved oppstart, så
startos/versions/treng inga datamigrering. Kjem det ein pakkeendring som krev det, skalup/downskrivast der — ikkje i appen. - Ein nedgradering til ein eldre pakkeversjon er ikkje støtta når skjemaet har gått framover, og det skal stå i
UPDATING.md. - 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
<meta name="robots" content="noindex, nofollow">,_send_security_headers()iapp.pyleggX-Robots-Tag: noindex, nofollowpå kvart svar, ogstatic/robots.txtsvararDisallow: /. Robots-fila står iSTATIC_FILES, men er ikkje iSHELL-lista istatic/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.jsbyggjer 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)
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 |
|---|---|
| §19 | Registrering per nøkkel: éi innsending gjeld éin vald nøkkel, og kvar nøkkel har sitt eige neste-sjekk-intervall. |
| §20 | Eit felt som ikkje gjeld for den valde nøkkelen eller programvara, blir skjult og utleidd, og alt utleidd blir lista i Review-oppsummeringa. |
| §21 | Engelske statusverdiar (IKKJE_VURDERT → NOT_ASSESSED) og GET /api/alerts, som summerer alle lagra kontrollar og listar kritiske først. Skjema 11. |
| §22 | Ein nøkkel som ikkje kunne kontrollerast, registrerer ingenting elles: wallet_software blir NULL, software_compatibility_status blir NOT_ASSESSED, og eit innsend resultat er ein 400. |
| §23 | Konfigurerbart nøkkeloppsett ved første oppstart; GET/POST /api/setup. |
| §24 | Obligatoriske val (Hardware works, kontaktstadfestinga) og skjemastrukturen i seks seksjonar. BIP327/SLIP39 og tool_checks fjerna. |
| §25 | Adressestien som identitet, rotering, varselkvittering og innstillingar. |
| §26 | Sperring av ein nøkkel med ope varsel (409), unike adressestiar, og eigne lukkehandlingar per varselkode. |
| §27 | Varselhandlingane i historikk og CSV, kontaktvarselet som eit nøkkelvarsel, og dei to formene av software_incompatible. Skjema 11. |
| §28 | Nøkkeltypen kan berre endrast ved ei rotering, og namnet blir endra i roteringsseksjonen. |
| §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. Det som står att
Sju punkt, alle før pakkeversjonen blir heva frå 0.1.0:0 til 1.0.0:0. §32.1, §32.2, §32.3, §32.4 og §32.7 er utførte; §32.6 og §32.5 står att, og eit punkt skal ikkje startast utan at brukaren ber om det.
Status i §32: 32.1 er utført — SVG-en er teikna om, faviconet ligg på alle seks sidene, og PNG-ikona på 192 og 512 px er rasteriserte, lista i manifestet og serverte. 32.2 er utført saman med etterrunden sin, 32.3 er utført, 32.4 er utført i rundane 32-A og 32-B, og 32.7 er utført — menyen i topplinja, det rydda dashbordet, Download CSV og noten på history-sida, hoppet til #history-detail og robots-sperra. I 32.4 står berre BR-003 att, og han er ei manuell ende-til-ende-verifisering som berre brukaren kan gjere. 32.6 og 32.5 står framleis att: 32.6 skal skildre den utgåva som faktisk blir gitt ut, og kjem før 32.5, som er hevinga av pakkeversjonen. 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, og den nye bokstesten i 32.5.
32.1 Ikonet
Utført. icon.svg i repo-rota og static/icon.svg er den same retro-teikninga: eit heva grått vindauge med dei tre nøklane i standardoppsettet, sentrerte i flata. Fila i rota er 1,2 KiB, langt under grensa på 40 KiB, og ho er rein SVG utan fontar, bilete eller nettverkskall, så CSP-en default-src 'self' held.
- Den marineblå tittelstripa er fjerna. Nøklane er rekna på nytt og sentrerte i flata: kvar nøkkelgruppe er 21 høg, og flata innanfor 3D-kanten går frå 6 til 122, så senteret er 64. Nøklane står difor på
translate(23, 25.5),(23, 51.5)og(23, 77.5), med same innbyrdes avstand som før. Same stil, sameviewBoxog samerole/aria-labeler behaldne. static/icon.svger den same teikninga som pakke-ikonet i repo-rota, som er kjelda til sanninga. Ein test samanliknar dei to filene frå<svg>-elementet og ut, så berre den leiande kommentaren kan skilje dei.- Faviconet: kvart av dei seks sidene har
<link rel=\"icon\" type=\"image/svg+xml\" href=\"/icon.svg\">i<head>, ved sida av manifest-lenka på dei fem som har ei./loginhar ikkje noko manifest, så der står ikonet ved sida av stilarket. - Merket i topplinja:
<span class=\"brand-mark\" aria-hidden=\"true\">V</span>er bytt mot<img class=\"brand-mark\" src=\"/icon.svg\" alt=\"\" aria-hidden=\"true\">på alle seks sidene. Klassenamnetbrand-markstår, og.brand-markistatic/styles.csser justert til eit bilete: 18×18, same kant, ogimage-rendering: pixelated.place-itemsog font-reglane som berre galdt bokstaven, er borte. - PNG-ikona:
static/icon-192.png(192×192) ogstatic/icon-512.png(512×512) er rasteriserte fråstatic/icon.svg. Begge står iicons-oppføringa istatic/manifest.webmanifestmedsizesogtype: \"image/png\", etter SVG-oppføringa, som framleis er fyrst. Stiane står òg iSTATIC_FILESiapp.pyog i skal-allow-lista istatic/sw.js, så dei blir serverte og ligg i PWA-cachen. tests/test_pwa.pypinnar favicon-lenka på alle seks sidene, at merket er biletet og ikkje bokstaven,.brand-mark-stilen, at dei to SVG-filene har same teikning, at dei to PNG-ane er 192×192 og 512×512 ifylgje sin eigen IHDR, at manifestet listar dei med rett storleik og type, og at begge blir serverte.- Dette lukkar den opne boksen i §30.
32.2 UI-finpuss
Utført. Ein gjennomgang av dei fem sidene og /login, utan nye funksjonar. Sidene har fått eit retro-tema, og dei 15 designpunkta er gjennomførte.
Retro-temaet (Windows-app, midten av 90-talet). static/styles.css er skriven om: 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 (lys oppe/til venstre, mørk nede/til høgre). Skrifta er systemfont-stabelen \"MS Sans Serif\", Tahoma, Verdana, Geneva, sans-serif i 12–13 px med tette linjer. Knappar er heva og ser nedtrykte ut på :active, skjemfelta er søkkte, fokus er den klassiske stipla ramma (outline: 1px dotted #000000), overskriftene er tittelstriper, og tabellane er rutemønster med 1 px rammer. Dei responsive reglane står uendra, og ingen tekst blir klypt på ein smal telefon. theme-color-metaet på dei fem sidene og /login og theme_color/background_color i static/manifest.webmanifest er sette til #c0c0c0 saman med sidebakgrunnen, og tests/test_pwa.py er oppdatert.
Dei 15 designpunkta:
- Luft mellom hjelpetekst og neste blokk. CSS-regelen
.field-help + .field-grid, .field-help + .form-stack { margin-top: 12px; }gjev blokka luft etter hjelpelinja på dei tre stadene: førdiv.field-gridisetup.html, førdiv#key-checkihealth-check.htmlog førdiv#wallet-software-listisettings.html. - Åtvaringa i key setup berre éin gong. Ho står no som eitt
p.secret-warningover heile nøkkel-lista isetup.html, ogsetup.jslegg henne ikkje lenger inn i kvart nøkkelkort. - Dashbord-overskrifta nemner oppsettet.
p#setup-shapeblir fylla avrenderSetupHeading()iapp.jsfråthresholdogkey_counti/api/setup, t.d. «Bitcoin Health Monitor for a 2-of-3 Multisig Setup.». Linja som står i markupen er fallbacken før dataa kjem. Beskrivinga «Bitcoin Multisig Health Monitor» står framleis i manifestet og i §29. - «An overview of your multisig setup and annual checks.» er fjerna frå dashbordet.
section.setup-carder fjerna.app.jsskriv ikkje lenger til#setup-title/#setup-description:setupTitle,setupDescription,renderSetupShape()ogsetupResult-greina er bytte ut medsetupShapeogrenderSetupHeading().- Nøkkelkortet viser nummer og type i toppen (
01 · Hardware/01 · Cloud), og den separateHardware key/Cloud key-linja er borte. - Nøkkelkortet viser berre stien, i skrå skrift (
.key-path), utan prefiksetAddress path:. - Nøkkelkortet viser berre modellnamnet, under namnet og over stien. Er modellnamnet likt nøkkelnamnet utan omsyn til store/små bokstavar og luft (
sameLabel()), blir linja ikkje vist i det heile. - Nøkkelkortet viser berre neste kontroll.
Next check duestår;Last checkeder fjerna. - Åtvaringa står berre i key setup. Serverlogikken er uendra:
secret_guard.py,validation.pyogauth.pyer ikkje rørde, og eit løyndom i eit fritekstfelt blir framleis avvist med400. Den korte åtvaringa er fjerna fråhealth-check.html(3),health-check.js(3),settings.js(2) ogsetup.js(1 per kort), og står no éin gong isetup.html. Formuleringa i §2, §12 og §15 er oppdatert, ogWarningTestsitests/test_secret_guard.pypinnar den nye regelen. Needs assessment-lista i Review-oppsummeringa er fjerna fråhealth-check.js.Results requiring follow-upstår.- Oppsummeringslinja i Review med
Key N: … · Check date: … · Next check due: …er fjerna. Local servicei topbaren ogYour data stays local.i footeren er fjerna på alle sidene, òg/login.- Historikk-kortet viser datoen, nøkkelnummer og -namn, og ein kort status (
All OK/Needs follow-up).Next check dueogSoftware-teksten er borte. Dette kravde eit additivt felt i oppsummeringa:GET /api/health-checksgjev nokey_namesogneeds_follow_upi tillegg til felta som alt var der (§11).needs_follow_upblir rekna ut av dei same varselreglane som dashbordet brukar, og er ein eigenskap ved den lagra kontrollen, så han endrar seg ikkje når brukaren lukkar varselet seinare. - Historikk-tabellane på mobil. CSS-reglane
table-layout: fixed,overflow-wrap: break-wordog mindre skrift på.detail-tableheldSecurity statusogFollow-up closedinnanfor sida på ein smal skjerm. Løyst i CSS, utan ny JavaScript.
Etterrunden av §32.1 og §32.2 — faviconet, merket, footeren og historia. Same gjennomgangen førte til desse punkta, utan nye funksjonar og utan skjemaendring:
- Footeren ligg nedst på sida òg når innhaldet er kort.
bodyer ein kolonne medmin-height: 100vhog100dvh, ogmaintek resten av høgda (main { flex: 1 1 auto; })..footerligg etter han. Ingen andre layoutreglar er rørde. - Faviconet. Alle seks sidene lenkjer
/icon.svgi<head>, ved sida av manifest-lenka der det finst ei (§32.1). - Merket i topplinja er ikonet som bilete, med same klasse
brand-mark, så CSS-en og testane som visar til han held (§32.1). - «Back to dashboard» er fjerna frå
history.html,settings.html,setup.htmloghealth-check.html. Merket «VardKey» er vegen tilbake. Lenkja i sperre-noten i skjemaet står, for ho peikar på dashbordet av ein annan grunn. - «Start annual health check»-knappen er fjerna frå
history.html. Ein kontroll blir starta frå dashbordet. - Historie-visninga i
history.js: programvara og versjonen hennar står på éi line (Sparrow Wallet 2.5.1), modellen og firmware-versjonen står på éi line (Blockstream Jade 1.4.1), og lukke-tabellen viserAlert,ActionogClosed— kjelde-kolonnen er borte. Manglar ein del av eit par, står resten åleine; manglar båe, står—. Dette kravde eit additivt felt i svaret:GET /api/health-checks/<id>ber nomodelpå 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, og nye testar pinnar nøkkelkortet, dashbord-overskrifta, historikk-kortet, dei to nye oppsummeringsfelta, lufta etter hjelpelinja, dei to tabellane og retro-reglane. Suiten gjekk frå 477 til 484 testar. Etterrunden la til ti testar: tre i tests/test_alerts.py (nøkkelkjelda til eit KI-varsel, at programvareforma held den reine leverandørkj elda, og at eit nøkkelvarsel framleis blir skjult på key_id etter kjeldeendringa), fire i tests/test_pwa.py (favicon-lenka, merket, .brand-mark-stilen og footeren) og tre i tests/test_health_check_form.py (dei samanslåtte linjene, den eine vegen tilbake, og at history-sida ikkje startar ein kontroll). Då PNG-ikona kom på plass, la tests/test_pwa.py til fire testar til: at dei to SVG-filene har same teikning, at kvar PNG er den storleiken han oppgjev, at manifestet listar begge med rett storleik og type, og at begge blir serverte. Suiten går difor frå 484 til 498 testar.
Det som står att i §32.2: ingenting av dei 15 punkta, og ingenting av etterrunden. Den manuelle nettlesartesten av retro-temaet på ein smal telefon, stadfestinga av at ingenting blir klypt eller overfylt der, og ein kikk på footeren, faviconet, merket i topplinja, PWA-installasjonen og history-visninga høyrer til brukaren.
32.3 Gjennomgang av meldingstekstane i varsla
Utført. Kvar av dei elleve varselradene i §7 har ein message i alerts.py, og alle er skrivne om til 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. Forma er no presisert i §7.
- Nye private konstantar.
_HARDWARE_FAILURE_MESSAGEog_SEED_BACKUP_MESSAGEer trekte ut av_key_alerts, der dei låg inline._SOFTWARE_INCOMPATIBLE_KEY_MESSAGEer no ein mal med{software}, sidan kjelda til den forma er nøkkelen og ikkje programvara._VULNERABLE_MESSAGEog_COMPROMISED_MESSAGEer delte i_VULNERABLE_KEY_MESSAGE/_VULNERABLE_SOFTWARE_MESSAGEog_COMPROMISED_KEY_MESSAGE/_COMPROMISED_SOFTWARE_MESSAGE, sidan dei to formene blir lukka av kvar si handling. - «Replace the key» er borte der den einaste handlinga varselet tilbyr er
rotate. Meldingane seier no kva handling som lukkar dei, og dei gjentek ikkje at nøkkelen ikkje kan kontrollerast — det står alt i sperre-noten og på nøkkelkortet. - «PROTOCOL 3: key loss» og «follow the key loss procedure» er tekne bort. Ingen av dei er definerte i appen eller i dokumenta, så dei peika på eit omgrep brukaren ikkje har.
- Kontaktvarselet namngjev ikkje lenger nøkkelen i meldinga. Kjelda er
Key N: <namn>, og ho blir vist rett over meldinga i varsellista og framføre henne i sperre-noten i skjemaet, så meldinga seier «this key». - Den nøkkelforma av
software_incompatiblenamngjev programvara, fordi kjelda der er nøkkelen. - Dobbeltføringa som står att: handlinga blir nemnd både i meldinga, i knappen i varsellista og i «Close it with: …» i sperre-noten. Det er medvite — knappen og noten seier kva brukaren kan trykkje på, medan meldinga skal stå åleine når ho blir lesen utan knappane.
- Testar:
tests/test_alerts.pyheld tekstane. Seks testar er oppdaterte eller omdøypte (test_a_hardware_failure_points_at_the_replacement,test_a_damaged_seed_backup_asks_for_a_rotation,test_a_mismatched_address_path_asks_for_a_replacement,test_a_compromised_security_status_asks_for_a_rotation,test_contact_details_that_need_an_external_update_are_reported,test_a_contact_alert_for_another_key_carries_that_key), og éin ny test pinnar at nøkkelforma og programvareforma av same kode har kvar si melding.tests/test_app.pyheld ikkje på nokon meldingstekst.
Dei andre tekststadene i appen (del 2 av same runde). Gjennomgangen fann desse overflødige eller dupliserte tekstane; dei er tekne bort eller skrivne om:
static/index.html: eyebrow-en «Multisig setup» dupliserte h2-en i same kort.static/settings.html: eyebrow-en «Settings» dupliserte h1-en, og dei to hjelpetekstane som begge byrja med «Removing an entry…» er slått saman til eitt avsnitt.static/login.html: h2-en «Sign in» dupliserte både h1-en og eyebrow-en «01 / Sign in»;aria-labelledbypeikar no på eyebrow-en.static/health-check.html: hjelpelinja «A blocked key is marked in the list and cannot be selected.» dupliserte sperre-noten rett over, og den statiske#software-help-teksten vart overstyrt av skriptet før brukaren såg han. Begge er borte; elementet står att og blir fylla avlockSoftwareFields().static/setup.jsogstatic/app.js: lenkja til innstillingane heiter no «Open the settings» i begge. Topbaren held «Settings» som navigasjonslenkje.static/app.js:setupDescriptiongjentek ikkje lenger «This app records check results only — never keys or seed phrases.»; same bodskap står i introen og i side-notisen.app.py: sperre-svaret (409) seier ikkje lenger den interne koden. Det er no «This key has an open alert. Close the alert before recording a new check.»validation.py: «a configured cloud key already provides this wallet software name» er blitt «this name already comes from a configured cloud key».- Uendra etter kontroll:
ACTION_LABELS/ACTION_CONFIRMATIONSi dei tre kopiane (static/app.js,static/health-check.js,static/history.js) er identiske, og blir ikkje slått saman til ei ny delt fil — ho måtte inn iSTATIC_FILESiapp.pyog i allow-lista istatic/sw.js.UNAVAILABLE_MESSAGEihealth-check.jsstår òg, sjølv om seksjonen han blir rendra i, er skjult for ein nøkkel som ikkje kan kontrollerast. - Testar:
tests/test_health_check_form.pyheld dei endra sidetekstane.test_the_settings_page_has_the_two_sectionsventar no eyebrow-lista[\\\"01 / Wallet software\\\", \\\"02 / Key rotation\\\"]og<h1>Settings</h1>;test_form_marks_the_keys_that_an_open_alert_blocksventar at hjelpelinja er borte; ogtest_the_settings_link_has_one_wordingheld dei to lenkjetekstane like. Testane itests/test_app.pyheld berre statuskoden, ikkje 409-teksten, og held difor uendra.
32.4 Bug-rapporten
- Arbeid gjennom
BUG-RAPPORT-AI-AGENT.md(BR-001–BR-008): verifiser kvart funn i koden først, rett dei som blir stadfesta med små, målretta endringar, legg til regresjonstestar, og rapporter kva som var stadfesta, kva som var falske positive, og kva som ikkje kunne avgjerast. - Rapporten er skriven mot eit anna filsett enn dette repoet. Han ber om
SECURITY.md,PRIVACY.md,THREATMODEL.md,PLATFORM-ACCESS.md,ENCRYPTION.md,OFFLINE.md,AI-STATUS.mdogDATA-MODEL.md, og ingen av dei finst her. BR-001, BR-004 og delar av BR-002 kviler på dei. Verifiser mot filene som faktisk ligg i repoet i staden, og meld frå om kva som fell bort av den grunn. - BR-001 (
P0 dersom stadfesta) gjeld at kjeldefilene skulle mangle i repo-visinga. Dei ligg imainog er spora av Git, så han skal kunne lukkast som falsk positiv etter eingit ls-tree -r --name-only HEAD. - BR-002 er den tyngste: fritekstfelta (
name,model,commentsog notatfelta) kan lagre ei seed phrase eller ein privatnøkkel brukaren limer inn ved eit uhell. Ei realistisk lokal sperre mot dei vanlegaste wallet-format, i tillegg til ei åtvaring ved kvart fritekstfelt, er innanfor grensene i §2 og §15 — men ikkje send noko til ein ekstern teneste, og ikkje logg feltinnhald. - BR-005, BR-006, BR-007 og BR-008 krev ein verifikasjon først: autentisering og CSRF, CSV-formelinjeksjon, PWA-cachen og normaliseringa av adressestiar.
- Ikkje hev pakkeversjonen, ikkje byt ikonet, og ikkje legg til nye tenester eller infrastruktur som del av denne jobben.
Utfall av runde 32-A (bug-triarge). Kvar BR vart verifisert i koden som ligg i dette repoet før noko vart endra:
- BR-001 — falsk positiv. Kjeldefilene ligg i
mainog er spora av Git; rapporten bygde på repo-visinga, ikkje på ein checkout. - BR-002 — stadfesta, utsett. Eit fritekstfelt kan framleis lagre ei løyndom brukaren limer inn ved eit uhell. Arbeidet høyrde til 32-B og vart ikkje starta i 32-A.
- BR-003 — stadfesta som formulering, men han kviler på ein tekst som ikkje finst. Sjå «Det som står att i 32.4» nedanfor.
- BR-004 — fell bort.
AI-STATUS.mdogDATA-MODEL.mdfinst ikkje i dette repoet. Koden følgjer alt kontrakten i §4–§7: statusaneSECURE/PATCHED/VULNERABLE/COMPROMISED, tabellanekeys,health_checks,key_checks,ai_security_checks,wallet_software,alert_acknowledgementsogapp_settings, og ingatool_checks. Den reelle dokdrifta er 32.6. - BR-005 — verifisert i koden, inga åtferdsendring. Berre
GET /health,GET /api/sessionog/loginer opne; alle andre/api/*svarar401og sidene svarar302til/login; kvar tilstandsendrande POST krev ei gyldig økt og CSRF-tokenet (403). Passordet er einhashlib.scrypt-hash med salt per passord, økta er ein HMAC-SHA256-signert cookie med utløp, og begge samanlikningane brukarhmac.compare_digest. IngenX-Forwarded-*-header blir lesen. Det einaste som ikkje kan stadfestast her, erSecure-flagget mot den reelle StartOS-proxyen: flagget er medvite utelate fordi StartOS terminerer TLS og proxyar rein HTTP inn i containeren. - BR-006 — stadfesta og retta i
export.py. Kvar tekstcelle som byrjar med=,+,-,@eller eit kontrollteikn — òg etter leiande mellomrom — blir no prefiksa med ein apostrof. Kolonnenamna, kolonnerekkjefølgja og vanlege verdiar er uendra. - BR-007 — stadfesta og retta i
static/sw.js. Tenestearbeidaren lagrar no eit svar berre når det er vellukka, same-opphav og ikkje omdirigert, så loginsida kan ikkje lenger erstatta det cacha app-skalet. - BR-008 — stadfesta og retta i
validation.py. Samanlikninga av adressestiar fellar no den harda markøren (h/H≡') i tillegg til store/små bokstavar og luft, så same derivasjonssti i to skrivemåtar blir avvist som duplikat i oppsettet, i innstillingane og ved rotering — og blir rekna som nøkkelen sin eigen sti i kontrollen. Den lagra verdien blir aldri skriven om.
Nye bindande reglar frå 32-A: (dei står òg i §4, §10 og §11)
- Eksporten nøytraliserer formelceller. Ei tekstcelle som eit rekneark ville lese som ein formel, får ein leiande apostrof. Kolonnenamna, kolonnerekkjefølgja og formatavtalen elles står fast.
- Adressestien blir samanlikna kanonisk. Same derivasjonssti i kvar av dei støtta skrivemåtane er den same stien, både for unikheit og for samanlikninga i kontrollen.
- PWA-cachen lagrar berre eit gyldig skal-svar. Eit svar som ikkje er vellukka, ikkje er same-opphav eller er omdirigert, blir ikkje cacha.
Utfall av runde 32-B (BR-002). Sperra mot wallet-løyndomar i fritekst er no på plass:
- Ny modul
secret_guard.py. Han held den engelske BIP39-ordlista (2048 ord, bakt inn lokalt — appen gjer framleis ingen nettverkskall) og einfind_secret()som kjenner att eit PEM-privatnøkkelblock, ein utvida privatnøkkel (xprv/yprv/zprv/tprv/uprv/vprv), ein WIF-nøkkel (51 eller 52 teikn), ein BIP38-nøkkel og eit ordløp på 12 eller fleire BIP39-ord. Funksjonen gjev berre ei kort engelsk nemning attende, aldri teksten, så ingenting hamnar i ein logg eller ein feilmelding. validation.pyavviser slikt innhald i kvart fritekstfelt. Sjekken sit i dei fire teksthjelparane (_text,_key_name,_model,_required_path), så kvart fritekstfelt er dekt av konstruksjon: nøkkelnamn, modell, wallet-programvarenamn, programvareversjon, firmware-versjon, notatfelta og KI-kommentarane. Han kastarSecretDetected, som er einValidationError, så svaret blir400og ikkje500. Valideringa køyrer før noko blir skrive, så eit avvist innhald blir aldri lagra delvis.- Sjekken køyrer òg før lengdegrensa til feltet. Eit innlimt løyndom blir difor svara med kva det ser ut som, ikkje med «too long» — som elles ville bedt brukaren om å korte ned eit seed phrase i staden for å fjerne det. Lengdegrensa står framleis som ytre grense og gjeld for alt annet. Rekkjefølgja er medvite vald og festa i testar, både for eit løyndom som passar i feltet og eit som ikkje gjer det.
auth.pyavviser òg eit adminbrukarnamn som ser ut som ei løyndom, med same rekkjefølgje. Passordet blir medvite ikkje sjekka, sidan ein lang passfrase er eit legitimt passord og ei avvising der ville stengje brukaren ute frå sin eigen konto.- Meldinga gjentek aldri verdien. Ho namngjev feltet og forma som vart kjend att, og seier at ingenting vart lagra.
- Åtvaring ved felta i UI-et. Runde 32-B la inn ei kort linje i same ambra-palett som sidenotisen, i
static/health-check.html,static/health-check.js,static/setup.html,static/setup.jsogstatic/settings.js, med stilen.secret-warningistatic/styles.css. 32.2 endra dette: åtvaringa står no éin gong, i nøkkeloppsettet, og er elles fjerna (§2, §12 og §15). Sidenotisen om løyndomar står framleis, og sideoverskriftene er uendra. - Kjende avgrensingar står i modulens docstring og blir ikkje tona ned: eit nakent 64-teikns heksadesimalt streng blir ikkje avvist (det kan like gjerne vere ein transaksjons-id, som er legitimt notatinnhald), berre den engelske ordlista blir brukt, og eit format utanom mønstra eller ei løyndom som er delt over fleire felt, blir ikkje fanga.
Nye bindande reglar frå 32-B: (dei står òg i §2, §12 og §15)
- Fritekst blir sjekka lokalt før lagring, og før lengdegrensa til feltet. Eit felt som ser ut som ei wallet-løyndom, blir avvist med
400og med kva det ser ut som, ingenting blir lagra, og meldinga gjentek aldri verdien. Sjekken er lokal og gjer ingen nettverkskall. - Den korte åtvaringa ved feltet er éin, i nøkkeloppsettet, med stilen
.secret-warning. Ho blir ikkje gjenteken per fritekstfelt. (Endra i §32.2 punkt 2 og 10; serveren avviser framleis eit løyndom i kvart fritekstfelt.)
Testar lagde til: ti i runde 32-A (fem i tests/test_export.py, ein i tests/test_pwa.py og fire i tests/test_validation.py) og 43 i runde 32-B, alle i den nye tests/test_secret_guard.py (5 ordlistetestar, 10 gjenkjenningstestar, 17 feltnivåtestar, 6 åtvaringstestar og 5 API-testar). Runde 32.3 la til éin test i tests/test_alerts.py og éin i tests/test_health_check_form.py, og runde 32.2 la til sju. Suiten gjekk frå 422 til 484 testar. Etterrunden av 32.1 og 32.2 la til ti, og PNG-ikona fire til, så han står på 498 testar.
Det som står att i 32.4: berre BR-003, og han må lesast rett. Rapporten vart skriven mot eit anna filsett og 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 (32.1), UI-pussen og retro-temaet på ein smal telefon (32.2), ein kikk på varsellista, nøkkelkortet og sperre-noten etter tekstendringane (32.3), menyen og det rydda dashbordet (32.7), og heile bokstesten på nytt etter endringane (32.5) — saman med dei nye punkta i etterrunden av 32.1 og 32.2, og ei stadfesting frå brukaren på at dei er køyrde. Alt anna i rapporten er avgjort: BR-001 er ein falsk positiv, BR-004 fell bort, BR-005 er verifisert utan åtferdsendring, og BR-002, BR-006, BR-007 og BR-008 er retta med regresjonstestar. To manuelle punkt under 32-B er alt stadfesta av brukaren: at eit seed phrase blir stoppa i namnefeltet og i adressestifeltet, og at åtvaringa ved felta er lesleg på ein telefon.
32.5 Hevinga av pakkeversjonen
- Pakkeversjonen blir heva frå
0.1.0:0til1.0.0:0når punkta over er ferdige og brukaren seier ifrå. §18 steg 12 («bygg endeleg.s9pkog 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 og 32.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. 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 på history-sida, at menyen merkjer sida ein står på, hoppet til #history-detail, og robots-sperra.
README.md(pakke-README): «Actions: None» ogactions: []i Quick Reference stemmer ikkje — pakka har to handlingar,Delete all dataogSet Admin Password. 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 manglarGET /api/session,POST /api/admin,POST /api/loginogPOST /api/logout, og han skildrar korkje innloggingsvakta (401på API,302til/loginpå sider,403utan CSRF-token) 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 ògkey_namesogneeds_follow_upiGET /api/health-checks, og skildringa av felta ved kvart fritekstfelt. Etter runden 32.1 manglar hanmodeliGET /api/health-checks/<id>, 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, atDownload CSVog noten no ligg på history-sida, og ankeret#history-detail.instructions.md: manglar innloggingssteget, opprettinga av admin og dei to handlingane iActions & Config. «exactly three keys … another threshold is not supported» er feil etter §31 punkt 7.UPDATING.md: seier skjema 11; det er 12. Versjoneksempla og tag-regelen skal framleis stå, og modullista bør nemneauth.py,maintenance.pyogsecret_guard.py.AGENTS.md: modullista nemner ikkjeauth.py,maintenance.pyellersecret_guard.py, og testavsnittet nemner ikkje at suiten òg dekkjer sperra.startos/manifest/i18n.tsogstartos/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, ogmake x86køyrerprettier --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, ingen nye dokument, og static/robots.txt er 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.jsbyggjer einMenu-knapp med nedtrekk i staden for «Sign out»-knappen, på alle fem app-sidene (/loginhar framleis ingen, sidansession.jsikkje blir lasta der). Vala, i denne rekkjefølgja:Start health check→/health-check,Settings→/settings,History→/history, så ein skiljelinje, og til sluttSign out, som gjer det same som i dag (POST /api/logoutgjennom den pakkafetch-en isession.js, deretter/login).Sign outer ein<button type="button">, dei tre andre er<a>. Panelet er skjult som standard og blir opna og lukka ved klikk, medaria-haspopup,aria-expandedogaria-controls, og det blir lukka påEscape, ved klikk utanfor og etter eit val.session.jsheld fram med å lage.topbar-actions-innpakninga si sjølv, så alle sidene ser like ut utan at markupen må endrast. Fjerna fråstatic/index.html:<a class="primary-button active-button" href="/health-check">Start annual health check</a>i.page-headingog heile<div class="topbar-actions">medSettings-lenkja. Behalde: lenkja til/i sperre-noten ihealth-check.html, «Open the settings» isetup.js,/settings-lenkjene iapp.js(createRotateLinkogcreateRemoveSoftwareControl) og «Open the alert list» på nøkkelkortet — dei er kontekstlenkjer, ikkje navigasjon. Nye klassar istatic/styles.css(.menu,.menu-button,.menu-panel,.menu-item,.menu-separator), i retro-temaet og utan inline stil, fordi CSP-en erdefault-src 'self'. - 2. «Configured setup / Your keys» og nøkkelteljaren bort. I
static/index.htmlblirsection.section-blocksom ber eyebrow-enConfigured setup,h2«Your keys» ogspan#key-count, sletta, og<div class="key-grid" id="key-list">flytt til å stå rett etter<p class="intro" id="setup-shape">, inne i den samesection.page-heading.aria-labelledby="keys-title"fell bort med overskrifta. Istatic/app.jsblirconst keyCountog båe skrivingane til han sletta ("Unavailable"i feilgreina og teljinga irenderKeyCards()), så ingenquerySelectorpeikar på eit element som ikkje finst. - 3. «Next check»-kortet bort, tidlegaste forfall inn i «Attention».
.info-card-et med#next-check-titleog#next-check-detailblir sletta, og «Attention»-kortet står att åleine og skal spenne heile innhaldsbreidda på alle breiddder;.overview-gridog medie-spørringa blir rydda slik at det stemmer.nextCheckTitleognextCheckDetailistatic/app.jsfell bort, ogrenderSummary()styrer berre «Attention»: overskrifta er uendra (Nothing overdue/1 key overdue/N keys overdue), detaljlinja er den forfalne lista som i dag når noko er forfalle, og ellesEarliest next check <YYYY-MM-DD>, for Key N: <namn>.i staden forNo key has passed its next check date.Har ingen nøkkel einnext_check_due, står den eksisterande fallbackenNo key has a next check date yet. Save a health check to schedule one. - 4. Tomt varsel-område utan plasshaldartekst. I
renderAlerts()istatic/app.jsblir#alerts-listtømd utan tekst når det ikkje finst varsel, medanalertCountheld fram medNo alerts.aria-live="polite"-regionen, plasshaldaren i markupen og feilgreina (offline / «could not be loaded») står uendra. - 5. History-blokka bort frå dashbordet,
Download CSVtil history-sida.section.history-cardistatic/index.html(eyebrowPrevious checks,h2«History»,Open historyogDownload CSV) blir sletta. Istatic/history.htmlkjem<a class="secondary-button" href="/api/export">Download CSV</a>i.page-headingetter intro-avsnittet, utandownload-attributt, så filnamnet fråContent-Dispositionvinn. Den daudehistory-card-delen av selektoren istatic/styles.cssblir fjerna. - 6. Ingen indeksering, ingen bots. Ny
static/robots.txtmedUser-agent: *ogDisallow: /, lagt inn iSTATIC_FILESiapp.pysomtext/plain; charset=utf-8(ei fil som ikkje står der, svarar404), men ikkje iSHELL-lista istatic/sw.js.X-Robots-Tag: noindex, nofollowblir lagd i_send_security_headers()iapp.py, så sider, JSON, redirect, CSV og statiske filer er dekte i éin stad. Alle seks sidene istatic/får<meta name="robots" content="noindex, nofollow">i<head>.
Bindingar: engelsk UI-tekst og engelske kommentarar; CSP-en default-src 'self'; style-src 'self'; script-src 'self' tillèt ikkje inline skript eller inline stil; retro-temaet i §32.2 tillèt ingen border-radius utanom 0, ingen box-shadow og ingen gradient. alerts.py, validation.py, secret_guard.py, auth.py, database.py, export.py, maintenance.py, ikonet, manifestet, sw.js, startos/ og pakkeversjonen blir ikkje rørde.
Testar: kvar streng og kvar selektor som vart fjerna eller omdøypt, vart greppa i tests/ først, og ingen påstand vart sletta utan å bli erstatta av ein som pinnar den nye åtferda. Tretten nye testar pinnar menyen, at dashbordet ikkje har dei fjerna elementa, earliest-linja i «Attention», den tome varsellista, Download CSV-lenkja på history-sida utan download, robots-metaen på alle seks sidene, /robots.txt, og X-Robots-Tag-headeren. Brukaren køyrer python3 -m unittest discover -s tests og oppgjev talet før og etter; suiten går frå 498 til 511 testar.
Etterrunden (tre punkt frå brukaren sin gjennomgang). Utført, utan skjemaendring, utan nye endepunkt og utan nye dokument:
- 1. Eksport-noten flytt til history-sida, og knappen fekk luft.
p#workflow-noteer fjerna fråstatic/index.htmlog står no istatic/history.html, rett underDownload CSV-lenkja. Ordlyden er skriven om frå «The history page exports every saved key check…» til «Download CSV exports every saved key check, one row per key check, as a dated file.», sidan noten no står på den sida ho forklarer.static/styles.csshar fått.page-heading > .secondary-button { margin-top: 12px; }, så knappen ikkje rører linja over seg. - 2. Menyen:
Dashboardfyrst, og sida ein står på er gråa ut.MENU_ITEMSistatic/session.jshar no fire oppføringar:Dashboard→/,Start health check→/health-check,Settings→/settings,History→/history. Sida brukaren alt står på blir rendra som eit<span class="menu-item menu-item-current">medaria-current="page"i staden for ein<a>, så ho kan ikkje klikkast og sida blir ikkje lasta på nytt. Samanlikninga normaliserer stien (/health-check/≡/health-check, rota blir/)..menu-item-currenter grå (var(--line)) medcursor: default, og hover-/fokus-regelen er avgrensa med:not(.menu-item-current). - 3. Ankeret
#history-detailpå history-sida.View-lenkja ihistory.jspeikar no på/history?id=<id>#history-detail, oghealth-check.jssender brukaren til/history?id=<ny id>#history-detailetter lagring. Sidan detaljen er skjult til ein kontroll blir opna, og eit skjult element ikkje har nokon boks å rulle til, avdekkjer den nyerevealDetail()seksjonen først og kallarscrollIntoView({ behavior: "smooth", block: "start" })etterpå.
Testar i etterrunden: to testar er omdøypte og utvida i staden for sletta — test_the_top_bar_menu_offers_the_three_pages_and_sign_out → test_the_top_bar_menu_lists_the_dashboard_and_the_pages, og test_the_history_page_offers_the_export → test_the_history_page_offers_the_export_and_the_note. To nye kom til: test_the_menu_marks_the_page_you_are_on_and_greys_it_out og test_the_history_links_to_the_detail_section. I tillegg pinnar test_the_dashboard_has_no_next_check_card_and_no_history_block no <p class="eyebrow">Next check</p> i staden for den bare frasen Next check, fordi ein bar delstreng òg fangar ein HTML-kommentar. Suiten går difor frå 511 til 513 testar.
Etter runden: [ ] vart fjerna frå kvart punkt, sidan eit punkt utan avkryssingsboks er det som gjeld i dette dokumentet. Testtalet i «Status» øvst og i §32-statusen er oppdatert, §8, §9 og §12 er skrivne om til den nye sanninga, det nye bindande punktet om robots står under «Reglar som gjeld alle rundar», og ai-note.md er oppdatert med det same og med dei nye fellene.