76 lines
11 KiB
Markdown
76 lines
11 KiB
Markdown
# 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) | `pipelines://run/<id>` registered on Android and iOS and routed to the run (cold start and running app); not yet exercised on a device |
|
|
| 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) keyed per server (runs 159, 161) |
|
|
| Templates | Preview: gallery/detail/source, create-only dialog via Settings → Templates, list invalidated on create | create refresh verified against a real server (the web has no run-detail template link, so none is added) |
|
|
| Runs list/filter/sort/live fold | Preview | shell live/attention state (filter menu and day groups landed) |
|
|
| Run detail/input/output/copy | Preview: Summary recorded fields with exact unknown wording, Input/Output/Copy (no usage metrics block, matching the web since be6b6239) | 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 | — (the server's one repair command, export-only retry, is wired per visit; in-flight state survives remounts) |
|
|
| 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 | — (the run-wide aggregate shows only for a succeeded run, as the web) |
|
|
| Artifact groups | Preview: recorded groups in run detail, per-visit drill-down, turn documents (input/memory/output, session.html) in the run gallery | — (images, video, markdown, text/logs/JSON/code, CSV/TSV tables and inert HTML preview in-app; session exports stay external) |
|
|
| Artifact preview | Preview: image + markdown/text in-app through the chat renderer, paging, honest unsupported/external/HTTP states | — (video plays in-app; HTML renders sandboxed; CSV/TSV as tables) |
|
|
| 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 |
|
|
| 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 (the list is offstage while a conversation is open; deep-linked chats are marked read, run 162), 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 (operator decision; the web's is device-local) |
|
|
| 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.
|