Files
pipelines/app/PARITY.md
T

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.