91 lines
5.6 KiB
Markdown
91 lines
5.6 KiB
Markdown
# Web client — parity checklist
|
|
|
|
The browser client's acceptance gate. **The target is the Android app's feature
|
|
set** (`android/`), rendered for the web. A row is only `done` when the feature
|
|
works in the browser against a live server **and** a review stage captured the
|
|
rendered result through `test/ui-smoke.mjs` (or an extension of it). A green unit
|
|
test, or a code change without a capture, is `partial` at best.
|
|
|
|
Status legend: `todo` · `partial` (some of it works) · `done` (working + captured).
|
|
|
|
## Transport and connection
|
|
| # | Feature (Android counterpart) | Protocol | Status |
|
|
| --- | --- | --- | --- |
|
|
| T1 | Server-URL entry + validation rules (`data/transport/ServerUrl.kt`) | — | done |
|
|
| T2 | One reused socket, id matching, request timeout, not-connected guard (`PipelinesClient.kt`) | — | done |
|
|
| T3 | Connect / disconnect / manual reconnect | `ping` | partial (connect works; no reconnect UI) |
|
|
| T4 | Backoff recovery + foreground reconnect after sleep/blur (`ConnectionRecovery.kt`, `ForegroundReconnector.kt`) | — | todo |
|
|
| T5 | Connection banner + live badge; build/protocol mismatch warning | `pong` build/protocol | todo |
|
|
| T6 | Artifact URL resolution against the configured server (`resolveArtifactUrl`) | `GET /artifacts/…` | done (URL only) |
|
|
|
|
## Pipelines
|
|
| # | Feature | Protocol | Status |
|
|
| --- | --- | --- | --- |
|
|
| P1 | Pipeline list | `list_pipelines` | partial (list + count only) |
|
|
| P2 | Filter + sort (status/name/updated) | client-side | todo |
|
|
| P3 | Pipeline detail: stages, graph, versions, last run, content hash | `get_pipeline` | todo |
|
|
| P4 | Templates gallery + template detail | `list_templates`, `validate` | done |
|
|
| P5 | Create pipeline from a template (validate then submit) | `validate`, `submit` | todo |
|
|
| P6 | Workflow graph rendering (nodes, edges, stage panes) | `get_pipeline` | todo |
|
|
|
|
## Runs
|
|
| # | Feature | Protocol | Status |
|
|
| --- | --- | --- | --- |
|
|
| R1 | Run history list with status roll-up | `list_runs` | partial (list only) |
|
|
| R2 | Filter by status, sort, "needs you" markers | client-side | todo |
|
|
| R3 | Run detail: run fields, steps/visits, targets, sessions | `get_run` | partial (fields + steps) |
|
|
| R4 | Summary tab incl. collapsible **Changes** viewer (raw + rendered diff) | `get_run` file changes | todo |
|
|
| R5 | Graph tab (per-stage panes, verdicts) | `get_run` | todo |
|
|
| R6 | Input / Output field sections per stage | `get_run` | todo |
|
|
| R7 | Timeline | `get_run` | todo |
|
|
| R8 | Artifacts gallery + full-screen viewer (images inline, others download/open) | `GET /artifacts/…` | todo |
|
|
| R9 | Session export link (read-only `session.html`) | `GET /artifacts/…` | todo |
|
|
| R10 | Live run updates: subscribe/unsubscribe + event fold | `subscribe`, `unsubscribe`, `run_event` | todo |
|
|
| R11 | Human decision sheet: prompt, options, feedback | `decide_run` | todo |
|
|
| R12 | Cancel run | `cancel_run` | todo |
|
|
| R13 | Retry failed stage (resume) / restart from start | `retry_run` | todo |
|
|
| R14 | Rename a run | `set_run_title` | todo |
|
|
| R15 | Attention / "Needs you" surface: counts, open, individual dismiss, clear all | derived from `list_runs` + run events | todo |
|
|
|
|
## Search
|
|
| # | Feature | Protocol | Status |
|
|
| --- | --- | --- | --- |
|
|
| S1 | Omni-search across pipelines, versions, runs, steps, fields, artifacts | `search` | todo |
|
|
| S2 | Result routing (open the pipeline, run, stage, artifact) | — | todo |
|
|
|
|
## Chat
|
|
| # | Feature | Protocol | Status |
|
|
| --- | --- | --- | --- |
|
|
| C1 | Session list (operator sessions, closed grouped as history) | `chat_sessions` | todo |
|
|
| C2 | Create a chat (directory picker) | `chat_directories`, `chat_create` | todo |
|
|
| C3 | Open / close / reopen a session | `chat_close`, `chat_reopen` | todo |
|
|
| C4 | History with paging / "load older" | `chat_messages` | todo |
|
|
| C5 | Live transcript: user/assistant text, one reply = one turn | `chat_subscribe`, `chat_event` | todo |
|
|
| C6 | Reasoning block + tool calls with name/input for the whole lifecycle | `chat_event` | todo |
|
|
| C7 | Markdown rendering + code blocks | — | todo |
|
|
| C8 | Composer: send, stop, attachments, draft | `chat_prompt`, `chat_interrupt` | todo |
|
|
| C9 | Slash commands | client-side | todo |
|
|
| C10 | Permission/approval cards (allow once/always/reject) | `chat_permission`, `chat_reply` | todo |
|
|
| C11 | Background tasks bar: running shells only, capped + scrollable, bounded output page | `chat_shells`, `chat_shell_output` | todo |
|
|
| C12 | Human-decision notices inside chat + dismiss | `chat_event` | todo |
|
|
| C13 | Local rename/hide, seen state, persistence to `localStorage` | client-side | todo |
|
|
| C14 | Scroll behaviour: follow newest, "jump to newest", restored position | client-side | todo |
|
|
|
|
## Settings, layout, platform
|
|
| # | Feature | Protocol | Status |
|
|
| --- | --- | --- | --- |
|
|
| L1 | Settings: server URL, workspace | — | todo |
|
|
| L2 | Wide layout: left rail + two panes | client-side | todo |
|
|
| L3 | Narrow layout: bottom section strip + bottom navigation | client-side | todo |
|
|
| L4 | Responsive switch by viewport width (no hardcoded device) | `WindowSize.kt` analogue | todo |
|
|
| L5 | Notifications for failed/waiting runs (browser Notification API; HTTPS/localhost only) | derived | todo |
|
|
| L6 | Deep links to a run (`pipelines://run/…` analogue → URL route) | — | todo |
|
|
| L7 | Accessibility: focus order, labels, keyboard operation | — | todo |
|
|
|
|
## Deliberately out of scope
|
|
- **Operator-only transport** — `inspect_resource`, `reconcile_resource`,
|
|
`inspect_resource_pool`, `configure_resource_pool` are loopback-only and must
|
|
not be exposed by a browser client.
|
|
- **Device/ADB features** — the Android app's device work is the UI reviewer's
|
|
lease-based work, not a client feature.
|