Files
pipelines/app/PARITY.md
T

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) keyed per server (runs 159, 161)
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 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 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 (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 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.