Files
pipelines/app/PARITY.md
T

10 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) persisted endpoint boot, 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 opens the run's decision prompt (9344e6d3) 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 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 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, 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), web Open badge and active/deep-linked read suppression, hide closing an already-open conversation, 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
Chat attachments Preview: host picker, pasted files through the same bounded 1 MiB draft, composer chips, base64 wire payload, sent with the prompt (87bb518c) history reconciliation
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) command actions /new, /close, /rename, /stop, /help
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 background question notices; permission/browser smoke only in fixtures
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.