11 KiB
Flutter port acceptance
Target: current web/src/ behavior and latest entries in web/PARITY.md, NOT
web CSS. Native Material/Cupertino controls, typography, semantic colours and
content-driven sizing take precedence over visual-review styling suggestions.
WORK.md is the run/commit queue; this file tracks what remains for a full port.
Evidence vocabulary
- Preview: registered in the normal app and published to8096, with fixture browser interaction/captures. This does NOT imply live production mutations.
- Source: landed/tested reusable code, not a delivered screen.
- Active: assigned implementation, not accepted or deployed.
- Missing: still required; no implied fallback or scope waiver.
Live authenticated data, OS sharing/notifications and Android/iOS device behavior remain unverified unless explicitly recorded. Test mutations use isolated fakes or scratch servers only, never real operator sessions/runs/workflows.
Functional inventory
| Area | Current state | Remaining acceptance |
|---|---|---|
| Shared transport/settings connection | Preview: reconnect when the app returns to the foreground and the protocol-mismatch warning stays visible (8b9a298d) |
native boot uses the saved endpoint (run 155); a connected foreground return re-reads the visible Pipelines/Runs list (run 157) skipped while a dialog, page or text field is in use (run 158); the list keeps its scroll on the re-read (run 160, test-only) |
| Native shell/run URLs | Preview: full route vocabulary; pipeline/version/stage, template detail and run visit/stage links open their detail/pane; ?action=decide opens the run's decision prompt (9344e6d3) |
native OS deep-link registration (the /runs?pipeline filter landed with runs-pipeline-url) |
| Pipeline list/filter/sort/detail/source/versions | Preview: recorded row metadata and miniature, pinned detail URLs, filter/sort | none outstanding on the list/detail read path |
| Definition graph | Preview: measured native canvas, pipeline Graph tab, pan/zoom, expanded view, stage definition pane, pipeline stage deep link | none outstanding on the definition graph read path |
| Start a pipeline | Preview: native Run action, prompt/workspace/notify dialog, pinned run request, response-loss check/retry | pending launch intent persists across a reload (run 159) but is keyed with a blank endpoint, not per server |
| Templates | Preview: gallery/detail/source, create-only dialog via Settings → Templates, list invalidated on create | run-detail template link, create refresh verified against a real server |
| Runs list/filter/sort/live fold | Preview | shell live/attention state (filter menu and day groups landed) |
| Run detail/input/output/copy/metrics | Preview: Summary recorded fields with exact unknown wording, Input/Output/Copy, metrics | verify the remaining server-shape variants against fixtures |
| Rename run | Preview | verified exact accepted title fold; no live production mutation tested |
| Cancel run | Preview | exact confirm/server-accepted detail+list fold; production cancellation not tested |
| Retry/restart | Preview controls in the run detail | accepted new-run navigation, stale/refusal handling verified in the app |
| Human decisions | Preview waiting card/native prompt/exact accepted reply | attention/action URL entry; no production decision answered during tests |
| Run graph | Preview: Graph tab with legend, recorded-stage selection, canvas pan/zoom, an expanded view, and a live pulse on the recorded current stage while executing | rendered browser capture of the pulse; styling advisories tracked in notes/graph-pulse.md |
| Timeline/recorded visit pane | Preview: selection opens the recorded facts with Input/Output/Artifacts/Session/Definition sections and exact absence wording | full per-visit session-repair choices (separate row); the export-only retry lives in Session |
| Changes/diffs | Preview via run detail: one recorded visit at a time with Previous/Next paging and capture states, probed in Chrome (9532ecdd, c0ba5d54); recorded file/diff/close/back verified |
settled-run aggregate gate |
| Artifact groups | Preview: recorded groups in run detail, per-visit drill-down, turn documents (input/memory/output, session.html) in the run gallery | video/HTML preview remains external-only |
| Artifact preview | Preview: image + markdown/text in-app through the chat renderer, paging, honest unsupported/external/HTTP states | video and HTML remain external-only |
| Artifact actions | Preview: external Open, Copy link, download and native share carry the recorded name/MIME bytes; progress, cancel, HTTP failure and unsupported-share states | OS share/download on Android/iOS remain unverified until the final build |
| Session audit/export repair facts | Preview: recorded export state/reason, repair request with one-shot submit and refusal, session.html external-only | rendered browser evidence for the repair control; full per-visit repair choices |
| Chat session management | Preview list + open session; shared create/rename/star/close/reopen with server-refreshed rows and full-width row refusals; local hide/undo and this device's read watermark (open rows only; a closed row never shows New) |
web action-failed report is a modal (Flutter keeps the refusal under its row with an OK dismiss), hide closing an open conversation is not reachable here (the list is offstage while one is open), web Open badge and active/deep-linked read suppression, create dialog in the shell |
| Chat history/live transport | Preview: /chat list and /chat/:id history, paging, live failure notice; composer integrated with the thread |
run-detail-style reconnect verification in the real app |
| Chat message surfaces | Preview: formatted assistant markdown (safe links/headings/lists/tables/fences), user text exact, disclosures plain | exact attachments, unknown-part rendering beyond retained placeholders |
| Chat activity/reasoning/tools | Preview: one activity line, expanded native overlay with lifecycle/input/output/error/duration/edit diff | compaction wording variants |
| Chat composer | Preview: field, Send/Stop, persisted draft, queued/refusal lines; attachments sent with the prompt (87bb518c); slash palette with no-send routing (63babc59); file and text paste (copied text keeps the field's caret and draft); one verified send in the real app flow |
— (slash command actions landed) |
| Chat attachments | Preview: host picker, pasted files through the same bounded 1 MiB draft, composer chips, base64 wire payload, sent with the prompt (87bb518c); the sent turn shows its files until history replaces it (run 156) |
— |
| Chat permissions/questions | Preview: native approval/risk and question cards in the conversation view, Chrome fixture captures under the C4 probe (notes/C4-approvals.md) |
authenticated smoke with a real pending approval/question; live multi-client resolution; no production decision sent |
| Chat model/Info/background tasks | Preview: numeric Info sheet (unknown != 0); header model control and chooser (notes/chat-model-picker.md); Background tasks bar with N running, capped scrolling rows, selected-task detail and one bounded chat_shell_output page (cursor 0, 64 KiB) that reports empty/unavailable/refused states, re-read on reconnect; the bar keeps half the viewport and the output pane twelve scaled lines (run 139 + manager fix; widget tests, published, no rendered capture yet) |
rendered browser captures of the model chooser and the task bar; authenticated smoke with a real running shell |
| Chat commands/notices/scroll | Preview: dismissible local notices with reconnect clearing; slash palette with the unknown-command report and Send as message / Cancel (63babc59, notes/C9-commands.md); streamed follow and restored read position (e4c196d7) |
/rename sends the shared server rename while the web's is device-local; decision pending |
| Saved schedule list | Preview: Settings row, /schedules route, read-only list; a row opens the owning pipeline detail (Summary by default) | authenticated smoke |
| Schedule editor | Preview: pipeline Summary creates/edits/pauses/deletes with the lossless draft and revision guard; conflict keeps the draft and shows the server words; Schedule this run seeds the editor with the recorded run's options (f2c33d2a) |
authenticated smoke |
| Search | Preview: exact target model and navigation to pipeline, pinned version, run and recorded stage; field/artifact hits select the recorded Summary section/visit (artifact hits follow web S2/Android and open the recorded visit, where the current browser source opens the artifact externally); a retired field or unknown visit selects the plain Summary; unresolvable hits stay read-only | authenticated smoke; rendered capture of the field/artifact selection |
| Needs you | Preview: runs-list bell/count, native sheet, dismiss/clear persistence, live fold, transition notifications, Settings permission tile | authenticated preview smoke |
| Notifications | Preview: Settings permission tile over live platform state, transition-only dedupe, tap opens the run | permission/browser smoke only in fixtures (background question notices landed) |
| Mobile replacement build | Native build: Android release APK from clean main 67045f25 (net.awan.pipelines.next, label Pipelines Next, debug-signed, app/build/android-testing/pipelines-next-67045f25.apk, sha256 084a06b8…); iOS Runner.app compiles unsigned after the deployment target moved to 15.0; all six web-only modules have conditional stubs; no device install, OS share/notification or endpoint smoke yet |
phone install against a reachable endpoint (the server binds loopback only; a tailnet TLS-terminated forward gives wss://, which avoids Android cleartext), device/OS behavior, release signing |
Current-reference corrections
Latest behavior supersedes older parity rows: Enter inserts a newline and Ctrl/Cmd+Enter sends; chat rename/star are server-shared; chat usage is behind Info; graph clicks open recorded visits; image artifacts preview internally; artifact Share carries bytes as a named file, never a URL; attachments use the latest bounded attachment envelope. Native layout differences are intentional; missing behavior is not a native-layout difference.
Completion gate
Every row must have actual normal-app registration, request/state regression coverage, and real-browser evidence for visible/interactive states. Recheck integrated analysis/tests/build and publish the verified preview. Produce the requested Android testing build only after development acceptance; do not use the personal delivery device for tests. Distinguish code, landing, publication, authenticated smoke, native build and device/OS verification in the final report.