docs(app): enforce quality gates and record verified preview progress

This commit is contained in:
2026-10-21 13:41:22 +01:00
parent 160ab45fe0
commit ef4ff40c4b
2 changed files with 19 additions and 5 deletions
+1
View File
@@ -6,6 +6,7 @@
- Standard Material and Cupertino controls, including buttons/menus in custom graphs/diffs/chat. System typography, theme colors, light/dark, content-driven layout and text scaling. No fixed row/bubble/button dimensions, bespoke palette or CSS token port. Platform differences are intentional. Centralize necessary layout constraints; do not ban legitimate native default spacing or graph coordinates.
- Develop and test ONLY web now. No ADB, emulators, device changes, Android/iOS builds or installs. Keep source portable to all three targets. Explicitly report mobile as unverified.
- Small cohesive files (aim below 250 lines; split by responsibility, not arbitrary fragments). Each task owns a directory and its tests. Do not edit another lane or root pubspec/main unless assigned.
- Code quality is a delivery requirement. No minified implementations, silent capability fallbacks, fake data masking missing features, or workarounds that bypass the real defect. A pipeline success does not waive missing behavior, native controls, regression coverage or rendered evidence. Label incomplete work honestly and complete it before claiming parity.
## Shared contract
- `lib/core/api_gateway.dart`: `JsonMap` alias; `ApiGateway.call(type, [fields])` yields the entire decoded reply envelope; `frames` yields unsolicited server envelopes. Gateway owns request IDs. Do not put domain interpretation in transport.
+18 -5
View File
@@ -7,13 +7,16 @@ All work under app/. Existing applications remain running and unchanged.
| Item | Scope | Source | Verification | Landing | Preview |
| --- | --- | --- | --- | --- | --- |
| F0 | Scaffold and gateway contract | 0e0ef54 | analyze + 1 scaffold test pass | main | not served |
| F1 | Socket transport, endpoint rules, reconnect | run 29 / flutter/f1-transport | pipeline passed; manager expanded to 12 regressions and corrected races | pending | — |
| F2 | Adaptive shell and standard platform controls | run 31 / flutter/f2-shell | pipeline passed; manager completing real browser evidence and native-default corrections | pending | pending |
| F3 | Run models, live event fold, actions | run 32 / flutter/f3-runs | pipeline passed; manager correcting ignored source and parity gaps | pending | — |
| F1 | Socket transport, endpoint rules, reconnect | run 29 + 1e4ecea | 12 regressions pass, analyze/web build pass | main cb1ea90, ancestry verified | — |
| F2 | Adaptive shell and standard platform controls | run 31 + a561c45 | 6 widget tests; real Chrome navigation + inspected phone/desktop PNGs | main 2f60a0e, ancestry verified | served skeleton |
| F3 | Run models, live event fold, actions | run 32 + 1515ebe | 11 regressions/analyze pass; 5 source files 105–226 lines | main 37d0823, ancestry verified | — |
| F4 | Chat models, history/live fold, request facade | run 33 / flutter/f4-chat | pipeline passed; wire omissions carried into C1 | pending C1 adapter fixes | — |
| F5 | Isolated authenticated web preview tooling | run 30 / flutter/f5-preview | pipeline passed; manager checking actual websocket/auth/byte forwarding | pending | pending |
| F5 | Isolated authenticated web preview tooling | run 30 + ae352bb | 6 proxy fixtures incl auth/bytes/origin/idle sockets pass | main 160ab45, ancestry verified | http://127.0.0.1:8096/ |
| P1 | Pipeline list/detail/source/version browser | run 34 / flutter/p1-pipelines | running (DeepSeek V4.1 Flash) | pending | pending |
| C1 | Chat session browser and management | run 35 / flutter/f4-chat | running (Luna), includes adapter prerequisites | pending | pending |
| C1 | Chat session browser and management | run 35 → resume 36 / flutter/f4-chat | pipeline passed; manager finishing native controls, grouping, selectors + captures | pending; not parity-complete | pending |
| N1 | Connection settings/preferences | run 37 / flutter/n1-settings | running (Flash) | pending | pending |
| R1 | Run list/detail/live timeline | run 38 / flutter/r1-runs-ui | running (Luna) | pending | pending |
| D1 | Recorded changes/diff viewer | run 39 / flutter/d1-diff-viewer | running (Flash) | pending | pending |
## Next ready work
- P1 pipelines list/detail/source/version; P2 graph and stage/visit selection.
@@ -45,6 +48,16 @@ workspace/write scope, so could not correct this admission mistake. No policy
override, server edit or shell-write bypass was used by the manager.
Allowed pipeline models: Luna or DeepSeek V4.1 Flash; current runs use Luna.
## Latest integration check
At 160ab45: 29 Flutter tests and 6 Node proxy fixtures pass; flutter analyze,
flutter build web and git diff --check pass. Real Chrome phone/desktop captures
are in the approved OpenCode temporary directory, named f2-shell-*.png. The
preview process is running separately on loopback 8096, authenticating via the
unchanged existing web proxy on 8095. Verified unauthenticated page redirects
to login, JS denies with 401, and proxied login responds 200. The served app is
currently a shell with explicit unimplemented bodies, NOT a feature-complete app.
No Android/iOS build or device verification has occurred.
### Manager integration findings
- F3 candidate omitted `lib/features/runs/data/runs_repository.dart`: root
runtime-data ignore matched source. Main 718442d adds an app-only exception;