Runde 32-A: append the agent's closing report (verdicts, changes, tests, commands)

This commit is contained in:
ai-bot committed 2026-10-14 12:54:12 +00:00
1 parent b3a81b14ce
commit fa1af75e31
1 file changed
+105 -1
+105 -1
View File
@@ -162,7 +162,7 @@ CSV-eksporten inkluderer brukarkontrollerte namn, programvarenamn og kommentarar
### Arbeid ### Arbeid
- Test eksport med syntetiske celleverdiar som byrjar med dei nemnde prefiksa, også etter mellomrom/CR/LF og i Unicode-kanttilfelle. - Test eksport med syntetiske celleverdiar som byrjar med dei nemnde prefiksa, også etter mellomrom/CR/LF og i Unicode-kanttilfelle.
- Dersom verdiane kan bli formeluttrykk, innfør ei dokumentert, konsistent nøytralisering av tekstceller før CSV-skriving utan å øydeleggje vanlege data. Hald kolonnenamn og CSV-formatavtalen stabile. Ikkje endre numeriske/dato/statusfelt feilaktig. - Dersom verdiane kan bli formeluttrykk, innfør ei dokumentert, konsistent nøytralisering av tekstceller før CSV-skriving utan å øydelegge vanlege data. Hald kolonnenamn og CSV-formatavtalen stabile. Ikkje endre numeriske/dato/statusfelt feilaktig.
### Godkjenningskriterium ### Godkjenningskriterium
@@ -218,3 +218,107 @@ Når arbeidet er ferdig, svar med:
3. Kva regresjonstestar som vart lagde til. 3. Kva regresjonstestar som vart lagde til.
4. Nøyaktig kva kommandoar som vart køyrde og resultata deira. 4. Nøyaktig kva kommandoar som vart køyrde og resultata deira.
5. Eventuelle manuelle StartOS-/nettlesartestar som ikkje kunne køyrast, utan å markere dei som beståtte. 5. Eventuelle manuelle StartOS-/nettlesartestar som ikkje kunne køyrast, utan å markere dei som beståtte.
---
# Svar frå agenten — runde 32-A (bug-triarge)
**Dato:** 2026-10-14
**Omfang:** berre BR-001–BR-008 i denne rapporten. BR-002 høyrer til runde 32-B, ikonet og pakkeversjonen til 32-F, og dokumentasjonsdrifta i `README.md`, `docs/application.md`, `instructions.md` og `UPDATING.md` til 32-E. Ingenting av det vart rørt her.
## Kva som fell bort fordi rapporten er skriven mot eit anna filsett
Rapporten ber om `SECURITY.md`, `PRIVACY.md`, `THREATMODEL.md`, `PLATFORM-ACCESS.md`, `ENCRYPTION.md`, `OFFLINE.md`, `AI-STATUS.md` og `DATA-MODEL.md`. **Ingen av dei finst i dette repoet.** Filene som faktisk ligg her, er `AGENTS.md`, `CLAUDE.md`, `README.md`, `TODO.md`, `ai-note.md`, `UPDATING.md`, `instructions.md`, `docs/application.md`, kjeldekoden på repo-rota, `static/`, `tests/` og `startos/`.
Konsekvensar for dommane:
- **BR-001** kan ikkje avgjerast ved å samanlikne med dei nemnde dokumenta, berre mot koden som faktisk ligg i `main`.
- **BR-004** fell heilt bort: båe dei motstridande kjeldene (`AI-STATUS.md` og `DATA-MODEL.md`) manglar. Den reelle dokumentasjonsdrifta i dette repoet er kjend og høyrer til 32-E.
- **BR-002** sin dokumentasjonadel (`ENCRYPTION.md`, `PRIVACY.md`) fell bort. Sjølve risikofunnet står likevel, og det er alt ført vidare til 32-B.
- **BR-005** sine krav om å teste «bak den reelle reverse proxyen» kan ikkje oppfyllast her, sidan det krev den faktiske StartOS-boksen.
- Rapportens instruks 1 (les dei nemnde dokumenta) og instruks 4 (`make x86`) kan ikkje følgjast fullt ut: ingen av dokumenta finst, og det finst inga StartOS-pakkearbeidsflate i denne køyringa.
## 1. Funn som var stadfesta, falske positive og framleis uløyste
| ID | Dom | Grunnlag |
|---|---|---|
| BR-001 | **Falsk positiv** | Kjeldefilene ligg i `main`: `app.py`, `auth.py`, `database.py`, `export.py`, `maintenance.py`, `validation.py`, `alerts.py`, `tests/`, `static/`, `startos/`, `Dockerfile`, `Makefile`, `package.json`, `tsconfig.json`. Rapporten bygde på rotvisinga i nettgrensesnittet, ikkje på innhaldet i branch-en. |
| BR-002 | **Stadfesta, men utsett** | Fritekstfelta (`name`, `model`, `comments` og nøkkelnotatet) blir lagra utan lokal sperre. Arbeidet høyrer til 32-B og vart ikkje starta. |
| BR-003 | **Stadfesta, men kan berre lukkast av brukaren** | Den manuelle ende-til-ende-verifiseringa i `TODO.md` § 16 og § 31 står framleis att. Ho krev ein nettlesar og ein StartOS 0.4.0-boks. |
| BR-004 | **Fell bort (filene finst ikkje)** | `AI-STATUS.md` og `DATA-MODEL.md` manglar. Koden følgjer alt kontrakten i `TODO.md` § 4–§ 7, så det finst ingen motstrid i implementasjonen å rette her. |
| BR-005 | **Verifisert i koden, inga åtferdsendring** | Sjå punkt 6 nedanfor. Rapporten bad om at åtferda i `app.py` blir rapportert og ikkje endra. |
| BR-006 | **Stadfesta og retta** | CSV-eksporten skreiv brukarstyrte tekstar uendra. |
| BR-007 | **Stadfesta og retta** | Tenestearbeidaren lagra kvar svar, òg ein 302 til `/login` som `fetch` følgjer. |
| BR-008 | **Stadfesta og retta** | Unikheitskontrollen samanlikna rå strengar, så `m/48h/0h/0h/2h` og `m/48'/0'/0'/2'` kunne bli registrerte som to nøklar. |
## 2. Filer som vart endra
| Fil | Endring |
|---|---|
| `export.py` | BR-006. Nye hjelparane `_guard_formula()` og `_needs_guard()`, og `_cell()` går no gjennom dei for alle ikkje-flag-celler. Ei tekstcelle som byrjar med `=`, `+`, `-`, `@`, eit kontrollteikn eller eit slikt teikn etter leiande mellomrom, blir prefiksa med ein apostrof. Kolonnenamna, kolonnerekkjefølgja, flagga (`Yes`/`No`) og alle vanlege verdiar er uendra. |
| `static/sw.js` | BR-007. Ny `isCacheable(response)`, som krev `response.ok`, `response.type === "basic"` og `!response.redirected`. Cache-skrivinga i fetch-handteraren er no verna av han, så ei loginside (eller ei feilside) kan ikkje lenger erstatta det cacha app-skalet. Allow-lista og nettverks-først-strategien er uendra. |
| `validation.py` | BR-008. Ny konstant `HARDENED_MARKER_FOLD` og ny `_path_key()`, som gjev den kanoniske samanlikningsforma (strip, `casefold`, `h`/`H` → `'`). Han blir brukt i `validate_key_setup()`, `_ensure_unique_path()`, `validate_rotation()` (både «stien må endre seg» og unikheit) og `_address_path()`. Den lagra verdien blir ikkje skriven om. |
| `tests/test_export.py` | BR-006-regresjonstestar (ny klasse `FormulaInjectionTests`). |
| `tests/test_pwa.py` | BR-007-regresjonstest (ny test i `ServiceWorkerTests`). |
| `tests/test_validation.py` | BR-008-regresjonstestar (fire nye testar) og ein ny konstant `HARDENED_H_PATH`. |
| `TODO.md` | § 32.4 oppdatert med utfallet per BR og dei tre nye bindande reglane. |
| `BUG-RAPPORT-AI-AGENT.md` | Denne avsluttande rapporten. |
Ingen endring i `app.py`, `auth.py`, `database.py`, `alerts.py`, `static/app.js`, `static/manifest.webmanifest`, ikonet, `package.json` eller pakkeversjonen.
## 3. Regresjonstestar som vart lagde til
**`tests/test_export.py` — klassen `FormulaInjectionTests` (BR-006):**
- `test_a_formula_prefix_is_neutralized` — kvar av `=`, `+`, `-`, `@` blir nøytralisert.
- `test_a_leading_control_character_is_neutralized` — tab, CR og LF framfor ein verdi.
- `test_a_formula_prefix_after_a_space_is_neutralized` — prefiks etter leiande mellomrom.
- `test_ordinary_text_is_written_exactly_as_stored` — vanleg tekst, tekst med separatorar, samanslått statuscelle, versjon, statusverdi og tom celle er uendra.
- `test_the_header_row_and_the_flags_are_not_guarded` — header og `Yes`/`No` er uendra.
**`tests/test_pwa.py` — `ServiceWorkerTests` (BR-007):**
- `test_the_service_worker_only_stores_a_successful_same_origin_answer` — `sw.js` inneheld vernet (`isCacheable`, `response.ok`, `response.type`, `!response.redirected`).
**`tests/test_validation.py` (BR-008):**
- `KeySetupTests.test_the_path_comparison_folds_the_hardened_marker` — duplikat i oppsettet, med `h`, `H` og luft.
- `ValidationTests.test_a_path_written_with_the_h_marker_is_the_keys_own_path` — same sti i `h`-notasjon gjev `OK`, og den innsende skrivemåten blir halden.
- `KeySettingsTests.test_the_duplicate_check_folds_the_hardened_marker` — `DuplicateAddressPath` i innstillingane.
- `RotationTests.test_the_stored_path_is_refused_in_either_marker` — roteringa avviser den lagra stien òg i `h`-notasjon.
Åtte nye testar til saman.
## 4. Kommandoar som vart køyrde og resultatet
- **`python3 -m unittest discover -s tests`** — kunne **ikkje** køyrast i denne køyringa: agenten har ikkje skal eller terminaltilgang, berre Gitea-verktøya. Suiten er difor **ikkje** stadfesta grøn av meg etter endringane. Køyr han på Linux og på Windows-kopien før pakkeversjonen blir heva, og oppdater talet i «Status» i `TODO.md` (det stod på 422 testar før dei åtte nye).
- **`make x86`** — ikkje køyrd. Det finst inga StartOS-pakkearbeidsflate i denne køyringa, og inga pakkefil vart endra.
- **`git status --short`, `git branch --show-current`, `git ls-tree -r --name-only HEAD`** (BR-001) — ikkje køyrde som skal-kommandoar. I staden vart branch `main` lesen gjennom Gitea-API-et, som listar 88 filer, mellom dei alle kjelde-, test- og pakkefilene. Den einskilde kommandoen over kan berre brukaren køyre; resultatet hans er det som formelt lukkar BR-001.
- **Statisk lesing av `app.py` og `auth.py`** for BR-005, og av `export.py`, `static/sw.js`, `validation.py` og testane for BR-006–BR-008.
- Alle filendringane vart gjorde éi fil om gongen gjennom Gitea-verktøya. Merk: verktøyet som var tilgjengeleg, har ingen `preview`/`preview_id`-steg, så kvar endring vart skriven med nøyaktig det gjennomgåtte innhaldet i éin operasjon.
## 5. Manuelle testar som ikkje kunne køyrast
Desse er **ikkje** køyrde, og blir ikkje markerte som beståtte:
- Den manuelle nettlesargjennomgangen i `TODO.md` § 16 og § 31 (BR-003).
- Cookie-åtferda bak den reelle StartOS-proxyen (BR-005), mellom anna `Secure`-flagget, sidan TLS blir terminert av StartOS og proxyar rein HTTP inn i containeren.
- PWA-en i ein faktisk nettlesar: installasjon, innlogging → app → logout → offline, og oppdatering frå ein gamal cache (BR-007). Berre `sw.js`-kjelda er verifisert.
- CSV-en opna i eit faktisk rekneark (BR-006). Nøytraliseringa er verifisert i testar, ikkje i Excel.
- StartOS 0.4.0-boksen: installasjon, restart, backup og restore.
## 6. BR-005 — verifikasjonen, i detalj
Inga åtferd vart endra, slik oppdraget bad om. Funna i koden:
- **Opne ruter:** berre `GET /health` (svarar `{"status": "ok"}`, inga konfigurasjon, inga persondata, ingen trace), `GET /api/session` (berre `admin_configured` og `authenticated`) og `/login` (sjølve loginsida). Alle andre `/api/*` svarar `401` utan gyldig økt, og dei fem app-sidene svarar `302` til `/login`. Statiske ressursar (CSS, JS, manifest, ikon) er opne og inneheld ingen data.
- **CSRF:** alle tilstandsendrande POST går gjennom øktsjekken først og deretter CSRF-sjekken, og svarar `403` på manglande eller feil token. Unntaka er `POST /api/admin` og `POST /api/login`, som må kunne køyrast før ei økt finst. Double-submit: same token i ein lesbar cookie og i `X-CSRF-Token`, samanlikna med `hmac.compare_digest`.
- **Cookie:** økta er `HttpOnly`, `SameSite=Strict`, `Path=/` og har `Max-Age`; CSRF-cookien er medvite lesbar (må inn i headeren). Inga cookie er merkt `Secure`, og det er dokumentert i koden: StartOS terminerer TLS og proxyar rein HTTP inn i containeren, så `Secure` ville droppe cookien på `http://localhost`. Appen les ingen `X-Forwarded-*`-header, så ingen klientstyrt header kan påverke han.
- **Økt og passord:** passordet blir lagra som `hashlib.scrypt`-hash med eit tilfeldig salt per passord og samanlikna med `hmac.compare_digest`; økta er HMAC-SHA256 over eit utløpstidsstempel, nøkla på ein `session_secret` som ligg i `app_settings`. Utløpet blir kontrollert. Verken passordhashen eller `session_secret` blir nokon gong send til klienten eller logga. Ei feilande database gjev eit avvist kall (fail closed), ikkje eit ope eit.
- **Attståande, berre for brukaren:** `Secure`-flagget mot den reelle proxyen, og ei stadfesting av at StartOS ikkje legg noko til eller fjernar noko frå `Set-Cookie` på vegen.
## 7. BR-006, BR-007 og BR-008 — kva rettinga er, og kva ho ikkje er
- **BR-006.** Ei celle som eit rekneark les som ein formel, får no ein leiande apostrof. Rettinga gjeld berre tekstceller som treng det; tal, datoar, statusverdiar og `Yes`/`No` er uendra, og kolonnenamna er dei same, sidan eksporten er ein avtale. Kjend avgrensing: berre dei prefiksa eit rekneark faktisk kjenner att, blir nøytraliserte — Unicode-homoglyfar av `=` blir ikkje det, sidan eit rekneark ikkje les dei som formlar.
- **BR-007.** Rettinga stoggar cachen av eit svar som ikkje er vellukka, ikkje er same-opphav, eller er omdirigert. Ho endrar ikkje allow-lista, som alt held `/api/*`, `/health` og `/login` utanfor, og ikkje nettverks-først-strategien. Skalet er rein HTML utan persondata, så ingen persondata ligg i cachen. `install`-steget brukar framleis `cache.addAll(SHELL)`; det køyrer frå ei beskytta side der det finst ei økt, og vart ikkje endra.
- **BR-008.** Rettinga gjer samanlikninga kanonisk: ho fellar `h`/`H` til `'`, i tillegg til store/små bokstavar og luft. Ho blir brukt for unikheit i oppsettet, i innstillingane og ved rotering, og for samanlikninga mellom innsend og lagra sti i kontrollen, slik at same derivasjonssti i to skrivemåtar ikkje lenger gjev ein falsk `PROBLEM`. Den lagra verdien blir aldri skriven om, så eksisterande data er ikkje endra. Kjend avgrensing: ein sti blir ikkje validert som eit gyldig BIP32-format, berre som ikkje-tom tekst opp til 200 teikn — det er slik `TODO.md` § 4 og § 25.1 skildrar feltet, og ei strengare formatvalidering ville vore ei åtferdsendring utanfor denne runden.