Files
pipelines/app/PARITY.md
T

8.5 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 including pipeline/version/stage, template detail, run visit/stage and decide, runs pipeline filter; pipeline and template links open their detail run visit/stage and decide destinations still open the run only; no native OS deep-link registration
Pipeline list/filter/sort/detail/source/versions Preview latest summary metadata/miniatures, pinned detail URLs
Definition graph Source nodes/layout/routes/edges; active canvas71 compose measured native nodes+labels, graph tab, pan/zoom, expanded view, definition stage pane
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 latest summary tabs/fields and exact empty/unknown states
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 per-visit session-repair choices (separate row)
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 Source: the visit Session section reports the recorded export state (complete, partial, missing, skipped, repair, or the server's verbatim unknown word), the recorded reason for a present export, and read-only repair attempt/option labels; session.html opens externally publish a preview of these captures; the repair_session_export action and 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 Source raw fields only one activity line, compaction, native reasoning/tools overlays, lifecycle/input/output/error/duration/edit diff
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 Source: bounded draft model (1 MiB) and a native host file picker seam composer chips, base64 send payload, 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 request facade current-model selection, numeric Info modal (unknown !=0), bounded running shell pages
Chat commands/notices/scroll Missing slash palette/actions, unknown-command send-as-message, dismissible local notices, saved scroll/follow intent
Saved schedule list Preview: Settings row, /schedules route, read-only list with exact timer provenance and pipeline identity row opening a pipeline lands on its Summary section; no editing from this list
Schedule editor Preview: pipeline Summary section creates/edits/pauses/deletes with the lossless draft and revision guard; conflict keeps the draft and shows the server words Schedule-this-run seeding, schedules list entry/route
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 from the same list rows, native sheet, open/dismiss/clear persistence, live fold and reconnect reseed notification permission/transition notices, 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.