#2618 - [Diagnose][P0] Release-builds schrijven geen enkele fout weg — "start niet" en "loopt vast" zijn niet te onderzoeken - LibreKAT/Ocideck - Pawprint: You digital pawprint in a cat-savy internet

brenno commented

2026-10-28 16:31:27 +00:00

Owner

Symptoom

Gebruikers melden dat OciDeck "regelmatig niet opstart" of "vastloopt terwijl ik werk" (o.a. op Windows 10). We kunnen dat nu niet onderzoeken: een release-build laat geen enkel spoor achter.

Oorzaak

lib/utils/log.dart stuurt alles naar dart:developer (developer.log). Die stroom bestaat alleen met een aangesloten VM-service (DevTools/flutter run). In een release-build verdwijnen dus álle ~800 logError/logWarning-aanroepen, inclusief de zone-handler in lib/main.dart:78 (Uncaught zone error) en FlutterError.onError. Er is geen logbestand, geen crashmarkering en geen manier voor een gebruiker om iets mee te sturen.

Daarbij: op Windows wordt het venster pas getoond bij het eerste frame (windows/runner/flutter_window.cpp:40, SetNextFrameCallback → Show()). Hangt iets vóór dat frame, dan ziet de gebruiker níets — wel een proces in Taakbeheer.

Voorgestelde oplossing

Lokaal, begrensd logbestand in de applicatie-ondersteuningsmap: twee roterende bestanden van elk ≤1 MiB, append-only, async geschreven (gebufferd, flush op fout en bij afsluiten). Zelfde privacyregel als nu: alleen operatienaam + gesaneerde fout (_safeError), nooit deck- of bestandsinhoud, geen paden van gebruikersbestanden (of alleen de bestandsnaam-hash). Valt onder de bestaande belofte in docs/PRIVACY.md — tekst daar bijwerken.
Opstartmijlpalen met tijdstempel: main gestart, elke await vóór runApp klaar (AssetStaging.initialize, lexicon, configureNativeWindow), eerste frame, toestemming geladen, shell gebouwd. Zo zie je in één logregel wáár een start bleef hangen.
UI-stallmelder: een Timer.periodic(250 ms) die de drift meet; is de UI-isolate >500 ms bezet geweest, log dan de duur plus het laatst gezette "werklabel" (een goedkope currentOperation-string die zware paden zetten: gezichtsscan, export, openen, documentsync). Dit levert precies de data die "loopt vast" nu mist.
Crashmarkering: een running-bestand dat bij nette afsluiting verdwijnt. Staat het er bij de volgende start nog, dan de vorige sessie als "onverwacht beëindigd" loggen.
Help → Diagnose: knop "Logmap openen" en "Diagnose kopiëren" (versie, OS-versie, GPU/renderer indien bekend, laatste 200 regels). De gebruiker beslist zelf of hij iets deelt; niets gaat automatisch het netwerk op (geen telemetrie).

Wat overeind moet blijven

Geen netwerkverkeer, geen telemetrie. Release blijft "stil" naar buiten.
Geen persoonsgegevens in het log (bestaande regel in de kop van log.dart); een test die een FormatException met bron-inhoud logt en controleert dat de inhoud niet in het bestand belandt.

Toets

Unit: rotatie bij 1 MiB, nooit meer dan 2 bestanden; sanering van FormatException.
Integratie: start → mijlpalen staan in het log; een kunstmatige UI-blokkade van 800 ms levert één stallregel.
Release-rookproef op Windows (#2314) leest na de start het log en eist de mijlpaal "eerste frame" — dan bewijst de proef dat er een venster kwam, niet alleen dat het proces leeft.

Onderdeel van de prestatie- en stabiliteitsinspectie van 28-10-2026 (EPIC #2637).

## Symptoom Gebruikers melden dat OciDeck "regelmatig niet opstart" of "vastloopt terwijl ik werk" (o.a. op Windows 10). We kunnen dat nu niet onderzoeken: een release-build laat geen enkel spoor achter. ## Oorzaak `lib/utils/log.dart` stuurt alles naar `dart:developer` (`developer.log`). Die stroom bestaat alleen met een aangesloten VM-service (DevTools/`flutter run`). In een release-build verdwijnen dus álle ~800 `logError`/`logWarning`-aanroepen, inclusief de zone-handler in `lib/main.dart:78` (`Uncaught zone error`) en `FlutterError.onError`. Er is geen logbestand, geen crashmarkering en geen manier voor een gebruiker om iets mee te sturen. Daarbij: op Windows wordt het venster pas getoond bij het eerste frame (`windows/runner/flutter_window.cpp:40`, `SetNextFrameCallback → Show()`). Hangt iets vóór dat frame, dan ziet de gebruiker níets — wel een proces in Taakbeheer. ## Voorgestelde oplossing 1. **Lokaal, begrensd logbestand** in de applicatie-ondersteuningsmap: twee roterende bestanden van elk ≤1 MiB, append-only, async geschreven (gebufferd, flush op fout en bij afsluiten). Zelfde privacyregel als nu: alleen operatienaam + gesaneerde fout (`_safeError`), nooit deck- of bestandsinhoud, geen paden van gebruikersbestanden (of alleen de bestandsnaam-hash). Valt onder de bestaande belofte in `docs/PRIVACY.md` — tekst daar bijwerken. 2. **Opstartmijlpalen** met tijdstempel: `main` gestart, elke `await` vóór `runApp` klaar (`AssetStaging.initialize`, lexicon, `configureNativeWindow`), eerste frame, toestemming geladen, shell gebouwd. Zo zie je in één logregel wáár een start bleef hangen. 3. **UI-stallmelder**: een `Timer.periodic(250 ms)` die de drift meet; is de UI-isolate >500 ms bezet geweest, log dan de duur plus het laatst gezette "werklabel" (een goedkope `currentOperation`-string die zware paden zetten: gezichtsscan, export, openen, documentsync). Dit levert precies de data die "loopt vast" nu mist. 4. **Crashmarkering**: een `running`-bestand dat bij nette afsluiting verdwijnt. Staat het er bij de volgende start nog, dan de vorige sessie als "onverwacht beëindigd" loggen. 5. **Help → Diagnose**: knop "Logmap openen" en "Diagnose kopiëren" (versie, OS-versie, GPU/renderer indien bekend, laatste 200 regels). De gebruiker beslist zelf of hij iets deelt; niets gaat automatisch het netwerk op (geen telemetrie). ## Wat overeind moet blijven - Geen netwerkverkeer, geen telemetrie. Release blijft "stil" naar buiten. - Geen persoonsgegevens in het log (bestaande regel in de kop van `log.dart`); een test die een `FormatException` met bron-inhoud logt en controleert dat de inhoud niet in het bestand belandt. ## Toets - Unit: rotatie bij 1 MiB, nooit meer dan 2 bestanden; sanering van `FormatException`. - Integratie: start → mijlpalen staan in het log; een kunstmatige UI-blokkade van 800 ms levert één stallregel. - Release-rookproef op Windows (#2314) leest na de start het log en eist de mijlpaal "eerste frame" — dan bewijst de proef dat er een venster kwam, niet alleen dat het proces leeft. Onderdeel van de prestatie- en stabiliteitsinspectie van 28-10-2026 (EPIC #2637).

brenno added the

enhancement

label

2026-10-28 16:31:27 +00:00

brenno referenced this issue

2026-10-28 16:32:34 +00:00

[EPIC] Prestatie- en stabiliteitsinspectie 28-10-2026: traag bij groot, start niet, loopt vast #2637

brenno referenced this issue

2026-10-28 16:32:59 +00:00

[Prestaties][P1] Renderpad doet per afbeelding per build twee synchrone realpath-aanroepen — zwaar op Windows #2624

brenno referenced this issue

2026-10-28 16:33:01 +00:00

[Opstart][P1] Vóór het eerste frame — en dus vóór het venster op Windows — draait onbegrensd synchroon werk #2626

brenno referenced this issue

2026-10-28 16:33:05 +00:00

[Windows][P2] Visual C++-runtime wordt niet meegeleverd; de rookproef kan dat niet zien #2630

brenno referenced this issue

2026-10-28 16:33:10 +00:00

[Poort][P1] Schaal- en per-toetsaanslagtoetsen voor de paden zonder prestatiepoort, plus Windows-meting #2636

brenno added the

in-progress

label

2026-10-28 22:23:58 +00:00

brenno commented

2026-10-28 22:24:00 +00:00

Author

Owner

Opgepakt op tak fix/release-logbestand-2618. Verwachte reikwijdte: lib/utils/log.dart (bestandssink), lib/main.dart (mijlpalen, crashmarkering), een stallmelder, Help → Diagnose, docs/PRIVACY*.md.

Opgepakt op tak `fix/release-logbestand-2618`. Verwachte reikwijdte: `lib/utils/log.dart` (bestandssink), `lib/main.dart` (mijlpalen, crashmarkering), een stallmelder, Help → Diagnose, `docs/PRIVACY*.md`.

brenno referenced this issue from a pull request that will close it,

2026-10-29 00:53:23 +00:00

Logbestand en diagnose voor release-builds (#2618) #2654

brenno commented

2026-10-29 00:53:40 +00:00

Author

Owner

PR #2654 staat open (tak fix/release-logbestand-2618, make check groen op 697348e64). Nog niet gemerged: er loopt een release, en de Windows-kant (integratietest + strengere rookproef) heeft nog niet op Windows gedraaid.

PR #2654 staat open (tak `fix/release-logbestand-2618`, `make check` groen op `697348e64`). Nog niet gemerged: er loopt een release, en de Windows-kant (integratietest + strengere rookproef) heeft nog niet op Windows gedraaid.

brenno referenced this issue

2026-10-29 13:30:20 +00:00

[Poort][P2] Windows time-to-first-frame meten en plafond zetten #2657

brenno referenced this issue from a commit

2026-10-29 15:22:50 +00:00

feat(log): tweede bestemming naast de VM-service, met padsanering (#2618)

brenno referenced this issue from a commit

2026-10-29 15:22:50 +00:00

feat(diagnose): stallmelder voor de UI-isolate (#2618)

brenno referenced this issue from a commit

2026-10-29 15:22:50 +00:00

feat(diagnose): begrensd, roterend logbestand met sessiemarkering (#2618)