8.4 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 | foreground recovery, persisted endpoint boot, protocol warning, complete refresh semantics |
| Native shell/run URLs | Preview: full route vocabulary; pipeline/version/stage, template detail and run visit/stage links open their detail/pane | ?action=decide opening the prompt, runs pipeline filter, native OS deep-link registration |
| 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 | live activity pulse on the run graph (tracked below) |
| Start a pipeline | Preview: native Run action, prompt/workspace/notify dialog, pinned run request, response-loss check/retry | Report format, recent-directory suggestions, pending intent across a reload |
| 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 | full time/status/provenance filters, recency/day groups, shell live/attention state |
| 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 and an expanded view | live activity pulse |
| 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 | settled-run aggregate gate, recorded file/diff/close/back verified in the real app; per-visit capture entry and paging remain |
| 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) |
dismissible web action-failed report (refusals stay under their row until the next accepted action), web Open badge and active/deep-linked read suppression, live New marks from pushed chat events, hide closing an already-open conversation, create dialog in the shell, editable create title (the web fixes New chat) |
| Chat history/live transport | Preview: /chat list and /chat/:id history, paging, live failure notice |
run-detail-style reconnect verification in the real app, then composer integration |
| 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; one verified send in the real app flow | attachments, paste and slash palette remain |
| Chat attachments | Preview: host picker, bounded 1 MiB draft, composer chips, base64 wire payload | send wiring in the composer, paste, history reconciliation |
| Chat permissions/questions | Source: native approval/risk and question cards in the conversation view | authenticated smoke with a real pending approval/question; live multi-client resolution; no production decision sent |
| Chat model/Info/background tasks | Source: numeric Info sheet (unknown != 0) landed | current-model selection, bounded background-task pages |
| Chat commands/notices/scroll | Preview: dismissible local notices with reconnect clearing | slash palette/actions, unknown-command send-as-message, saved scroll/follow intent |
| 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 seeding |
| Search | Preview: exact target model and navigation to pipeline, pinned version, run and recorded stage; unresolvable hits stay read-only | field/artifact hits open the run (their pane selection is a later slice) |
| 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 | background question notices; permission/browser smoke only in fixtures |
| Mobile replacement build | Scaffold only | Android build at end; all source portable to iOS, isolated IDs; device/OS behavior clearly separate |
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.