From ef4ff40c4b8a2e3a8ba5fe5733c7d8855d76078b Mon Sep 17 00:00:00 2001 From: Alan Silva Date: Wed, 21 Oct 2026 13:41:22 +0100 Subject: [PATCH] docs(app): enforce quality gates and record verified preview progress --- app/AGENTS.md | 1 + app/WORK.md | 23 ++++++++++++++++++----- 2 files changed, 19 insertions(+), 5 deletions(-) diff --git a/app/AGENTS.md b/app/AGENTS.md index a6c9d870..7752342a 100644 --- a/app/AGENTS.md +++ b/app/AGENTS.md @@ -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. diff --git a/app/WORK.md b/app/WORK.md index 69b2057a..818a5d40 100644 --- a/app/WORK.md +++ b/app/WORK.md @@ -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;