Files
pipelines/app/PARITY.md
T
alan 776afcacea fix(app): offer the session export repair only where the web does
Suppress the export-only repair for a legacy session.html with no recorded
evidence, narrow the identity check to the web's own, and keep the stricter
partial rule for an unverified complete status. Fix the analyzer findings,
add gating/legacy/Cupertino coverage, format, and correct the parity docs.
2026-10-22 10:52:36 +01:00

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 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 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, read-only repair attempt/option labels, and the export-only repair_session_export control for incomplete evidence; session.html opens externally publish a preview of these captures, with rendered evidence of the 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 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 Source pipeline entry and route registration, exact timer provenance vocabulary
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.