From f7f1e41031d3682f860b75075a3de7b62fe8a0b5 Mon Sep 17 00:00:00 2001 From: ai-bot Date: Sat, 10 Oct 2026 10:43:55 +0000 Subject: [PATCH] TODO: rename the app to VardKey (section 29) and add the StartOS package plan (section 30) --- TODO.md | 51 ++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 46 insertions(+), 5 deletions(-) diff --git a/TODO.md b/TODO.md index 1fe45fa..3849f50 100644 --- a/TODO.md +++ b/TODO.md @@ -1,4 +1,4 @@ -# TODO — Helsesjekk for StartOS 0.4.0 +# TODO — VardKey for StartOS 0.4.0 ## Mål @@ -13,7 +13,7 @@ Appen skal **berre registrere resultat og historikk**. Han skal ikkje signere Bi - §1–§18 er kravspecen og gjeld som han står. - §19–§28 er korte samandrag av rundane. Alle reglane deira står i §1–§18; den fulle grunngjevinga ligg i git-historikken. - Eit punkt utan avkryssingsboks er implementert og verifisert. `[ ]` markerer det som står att. -- **Status:** §1–§28 er implementerte og verifiserte, skjema versjon 11, testsuiten er grøn (345 testar). §18 steg 9–12 (StartOS) er **ikkje starta**. +- **Status:** §1–§28 er implementerte og verifiserte, skjema versjon 11, testsuiten er grøn (345 testar). §29 og §30 er vedtekne og **ikkje starta**; §29 (namnebytet) blir gjord fyrst. §18 steg 9–12 (StartOS) høyrer til §30. ## Språkkrav @@ -295,7 +295,7 @@ Bygg appen som éin enkel StartOS-service. ```text StartOS 0.4.0 -└── Helsesjekk +└── VardKey ├── Web UI ├── Backend/API ├── SQLite @@ -404,7 +404,7 @@ Utfør oppgåvene i denne rekkjefølgja og ikkje hopp fram til avanserte funksjo - [ ] 11. Test restart og restore. - [ ] 12. Bygg endeleg `.s9pk` og gjer første release. -**Merk:** §23–§28 kom inn etter steg 8 og er implementerte og verifiserte. Steg 9–12 er ikkje starta. +**Merk:** §23–§28 kom inn etter steg 8 og er implementerte og verifiserte. Steg 9–12 er ikkje starta, og høyrer til §30. **Testar:** køyr `python3 -m unittest discover -s tests`. Suiten skal vere grøn både på Linux og på Windows-kopien. @@ -416,7 +416,7 @@ Utfør oppgåvene i denne rekkjefølgja og ikkje hopp fram til avanserte funksjo - **§19 — registrering per nøkkel.** Ei innsending gjeld éin vald nøkkel, ikkje alle tre. Brukaren vel éi wallet-programvare med eitt versjonsfelt. Kvar nøkkel har sitt eige neste-sjekk-intervall. - **§20 — skjulte felt som blir utleidde.** Eit felt som ikkje gjeld for den valde nøkkelen eller den valde programvara, blir skjult og utleidd. Førre lagra verdi blir fylt inn som ein vanleg input-verdi, og alt utleidd blir lista i Review-oppsummeringa, merkt som nettopp det. -- **§21 — engelske statusverdiar og alle varsel.** `IKKJE_VURDERT` → `NOT_ASSESSED`. Kvar råka tabell blir bygd opp att med `PRAGMA foreign_keys = OFF` og `PRAGMA foreign_key_check` før commit. `GET /api/alerts` summerer alle lagra kontrollar, slår saman like varsel og listar kritiske først. «Helsesjekk» og `data/helsesjekk.sqlite3` er dokumenterte unntak frå engelskregelen. +- **§21 — engelske statusverdiar og alle varsel.** `IKKJE_VURDERT` → `NOT_ASSESSED`. Kvar råka tabell blir bygd opp att med `PRAGMA foreign_keys = OFF` og `PRAGMA foreign_key_check` før commit. `GET /api/alerts` summerer alle lagra kontrollar, slår saman like varsel og listar kritiske først. Etter §29 er `TODO.md` det einaste norske dokumentet i repoet; korkje produktnamnet eller databasefila er lenger unntak frå engelskregelen. - **§22 — ein nøkkel som ikkje kunne kontrollerast, registrerer ingenting elles.** Det gjeld både `available` = Nei og ein adressesti som ikkje stemmer: `wallet_software` blir `NULL`, `software_compatibility_status` blir `NOT_ASSESSED`, og eit innsend resultat er ein `400`, ikkje noko som blir kasta stille. --- @@ -475,6 +475,47 @@ Typen er ein del av identiteten til nøkkelen, saman med adressestien, så oppse - Ei rotering krev at nøkkelen blir markert med `Rotate this key` **og** at stadfestingsboksen «I confirm that each selected key has been replaced by a new key or hardware wallet» blir huka av. Då blir typen, den nye stien og namnet lagra gjennom roteringsendepunktet. - Knappen heiter `Save keys`, sidan han lagrar både namnebyte og roteringar i éin omgang, og han seier ifrå når det ikkje finst noko å lagre. +--- + +# 29. Namnebyte til VardKey (vedteke, ikkje implementert) + +Avtalt 10.10.2026. Skjema versjon 11 står uendra; dette er eit reint namnebyte utan åtferdsendring. + +Appen heiter **VardKey**, med beskrivinga **Bitcoin Multisig Health Monitor**. Etter bytet er `TODO.md` det einaste norske dokumentet i repoet: korkje produktnamnet eller databasefila er lenger unntak frå engelskregelen. + +- **Databasen.** Standardstien blir `data/vardkey.sqlite3` i `app.py` og i alle funksjonsdefaultane i `database.py`. Det blir **ikkje** skriven migrering: den gamle testdatabasen blir kasta og oppsettet konfigurert på nytt, slik README alt seier for ei eldre testdatabase. +- **Eksportfila.** `EXPORT_FILENAME` i `app.py` og `download`-attributtet i `static/index.html` blir `vardkey-export.csv`, og `tests/test_app.py` sjekkar det nye namnet. Dei to stadene må byte i takt, elles lovar grensesnittet eitt namn og serveren eit anna. +- **Produktnamnet i grensesnittet.** ``, brand-teksten, `aria-label`, `brand-mark` (`H` → `V`) og footeren i alle fem HTML-filene, og intro-meininga i `health-check.html`. +- **Beskrivinga.** «Bitcoin Multisig Health Monitor» blir vist i README, i StartOS-manifestet (§30) og som éi linje under tittelen på dashboardet. Ho blir **ikkje** lagd inn som `<p class="eyebrow">` i `health-check.html` eller `settings.html`: testane samanliknar eyebrow-lista på dei to sidene eksakt. +- **Repoet byter ikkje namn.** Gitea-repoet og prosjekt-id-en held fram som `ai-bot/helsesjekk`. Ei seinare omdøyping i Gitea-UI rører ingen kode, men `REPOSITORIES_JSON` må då oppdaterast. +- **README.md** held strukturen sin. Berre namna, stiane, eksportfila og unntaksavsnittet i «Development» blir endra. Unntaksavsnittet må formulerast på nytt, sidan det ikkje finst namn-unntak att. +- **Inga åtferdsendring, ingen nye funksjonar, ingen skjemaendring.** Testsuiten skal framleis vere grøn, med éin ny test som sjekkar at dashboardet viser namnet og beskrivinga. +- **Filer, i rekkjefølgja dei skal gjerast ferdige:** `app.py`, `database.py`, `static/index.html`, `static/styles.css`, `static/setup.html`, `static/settings.html`, `static/history.html`, `static/health-check.html`, `tests/test_app.py`, `README.md`. `TODO.md` og `ai-note.md` er alt oppdaterte og skal ikkje rørast i denne runden. +- **Vernet:** grep etter `helsesjekk` i heile repoet før arbeidet byrjar og etter at det er ferdig. Null treff att er kriteriet. + +--- + +# 30. StartOS 0.4.0-pakke (vedteke, ikkje starta) + +Avtalt 10.10.2026. Blir bygd etter at §29 er verifisert. + +Appen blir éin StartOS-service: éin daemon, éin container, SQLite på eit persistent volum. Forbodet i §13 gjeld som han står: ingen Postgres, ingen Redis, ingen ekstern backend, inga ekstern cloud-teneste for appdata, og ingen ekstra container utan konkret behov. + +- **Pakka ligg i app-repoet.** StartOS-filene (`startos/`, `Dockerfile`, `Makefile`, `package.json` og resten av skjelettet) ligg ved sida av appen i `ai-bot/helsesjekk`. Pakkeguiden seier at pakke-repoet ikkje skal vere ein fork av appen; her er appen vår eigen og har ikkje noko publisert image, så pakka byggjer appen frå repo-rota. Avviket skal stå i `AGENTS.md`, så ingen legg inn ein submodul for å «rette» det. +- **Namn og versjon.** Manifest `id: 'vardkey'`, `title: 'VardKey'`, `volumes: ['main']` mounta på `/data`. Pakkeversjonen startar på `0.1.0:0` og blir heva til `1.0.0:0` når §16 StartOS-testen og §17 er oppfylte. +- **Lisens.** `GPL-3.0-only`, med ein `LICENSE`-fil i repoet. Det er copyleft-motstykket til CC BY-SA 4.0, som er ein innhaldslisens Creative Commons sjølve rår frå å bruke på programvare, og GPL-3.0 gjev i tillegg ein eksplisitt patentlisens. Blir SPDX-id-en avvist av bygget, blir han skriven som `GPL-3.0`. +- **`marketingUrl`** er `https://sondreolav.com/vardkey`. Sida finst ikkje enno og blir laga til slutt; URL-en blir sett inn no likevel, sidan manifestet krev han. +- **Ikonet blir utsett.** `icon.svg` blir teikna i runden som hevar pakka til `1.0.0`, når appen er ferdig. Nektar bygget å pakke utan ikon, blir eit minimalt placeholder-ikon lagt inn og bytt ut i den runden. +- **Daemonen.** Éin daemon `primary` som køyrer `python3 app.py` med `PORT=8080` og `DATABASE_PATH=/data/vardkey.sqlite3`. Volumet `main` blir mounta skrivbart på `/data`. Ingen oneshot, ingen sidecar, og inga `USER`-linje i Dockerfile, så `/data` er skrivbar utan `chown`. +- **Helsesjekk.** Daemon-`ready` med `checkWebUrl` mot `http://127.0.0.1:8080/health`. Den interne porten i `bindPort` må vere den same som `PORT`, elles blir sjekken aldri grøn. +- **Web-grensesnitt.** `MultiHost.of(effects, 'ui').bindPort(8080, { protocol: 'http', preferredExternalPort: 80 })` med éin `createInterface({ id: 'ui', type: 'ui' })`. StartOS terminerer TLS og proxyar rein HTTP inn i containeren, så appen må ikkje byggje absolutte `http://`-URL-ar. Appen gjer det ikkje i dag. +- **Backup.** `backups.ts` peikar på volumet `main`. Det må undersøkast om `setupBackups` har ein krok som kan ta eit konsistent SQLite-snapshot. Finnst han ikkje, blir snapshotet teke medan ei skriving kan pågå, og det skal i så fall nemnast som ei kjend avgrensing. +- **Ingen CI.** Pakkeguiden føreset GitHub-workflows. Repoet ligg på Gitea, og `.s9pk` blir bygd lokalt med `make`. Det skal stå i `AGENTS.md`. +- **Rekkjefølgje.** Skjelettet kjem frå `s9pk init-workspace`; deretter `LICENSE`, `Dockerfile`, `.dockerignore`, `startos/manifest/i18n.ts`, `startos/manifest/index.ts`, `startos/utils.ts`, `startos/main.ts`, `startos/interfaces.ts`, `startos/backups.ts`, `startos/versions/`, `startos/init/`, `instructions.md`, `UPDATING.md`, `AGENTS.md`, `README.md`, og til slutt `TODO.md` og `ai-note.md`. +- **Framleis manuelt:** §14, §16 StartOS-testen og §17 blir ikkje kryssa av før brukaren har køyrt dei på ein eigen StartOS 0.4.0-boks. + +--- + ## Framtidig arbeid, ikkje no - [ ] Fleire enn tre nøklar, og andre tersklar enn 2-av-3.