docs(app): record markdown wiring, Templates entry and the follow-up evidence fix

This commit is contained in:
2026-10-22 00:38:02 +01:00
parent 78827fe63a
commit bc906ebb38
2 changed files with 29 additions and 22 deletions
+5 -5
View File
@@ -26,25 +26,25 @@ or scratch servers only, never real operator sessions/runs/workflows.
| 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 | Missing | native prompt/workspace/notify dialog, exact pinned run request, response-loss intent |
| Templates | Source repository/create prompt + active gallery76 | Set<template> native gallery/detail/source, Settings/templates entry, create refresh into list |
| 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 | Component landed with legend and recorded-route evidence | run detail Graph tab92 wires it; graph clicks select the recorded visit |
| Run graph | Preview: run detail Graph tab with executed/not-executed legend; a click highlights the recorded timeline row | live activity pulse and expanded pan/zoom view |
| Timeline/recorded visit pane | Preview text rows only; authored definition pane landed | visit selection, status/outcome/duration/model/target/verdict, artifacts/session/input/output/definition tabs |
| 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: run detail → recorded groups, selection facts, external Open/Copy link | present the visit's turn documents (input.md/memory.md/output.md, session.html) as gallery entries; in-app viewer next |
| Artifact preview | Preview: image + text in-app, markdown seam, paging, honest unsupported/external/HTTP states | wire the chat markdown renderer into the viewer; video and HTML remain 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 | Source safe URL resolution | separate external-open/copy/download; SHARE REAL NAMED MIME FILES, not links; slow activation/cancel/errors |
| Session audit/export repair facts | Missing UI | session.html read-only open, partial/missing/skipped/repair choices without fabricating complete evidence |
| Chat session management | Preview list + open session; actions from the list | directory groups/search, shared rename/star/close/reopen/create, local hide/undo/seen state, create dialog in the shell |
| 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 | Source native body70; integrating in79 | markdown (safe links/headings/lists/tables/fences), exact attachments and unknown-part retention |
| 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 | attachments, paste and slash palette remain |
| 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 request facade | picker/paste, latest1MiB total wire bound, base64 files, removable named chips, exact history reconciliation |
| Chat permissions/questions | Source request facade | native approval/risk cards and form option/free-text answers; pending/resolved/stale/error states |
| Chat model/Info/background tasks | Source request facade | current-model selection, numeric Info modal (unknown !=0), bounded running shell pages |
+24 -17
View File
@@ -45,7 +45,7 @@ All work under app/. Existing applications remain running and unchanged.
| C3-state | Chat draft/send/stop controller | run75 /565cdaa |10min MET target; manager reviewed per-chat persistence, stable intent id, refusal restore, queued flag | merged main; ancestry verified | composer UI next |
| C3-form | Native composer control | run? pending | drafts/send/stop UI atop75 | queued | pending |
| Chat screen | Live Chat destination + read-only history | run79 /flutter/chat-live-screen | list/detail routing, paging, live one-thread, reconnect | running | pending |
| Templates gallery | run76 /c56b5d45 | manager re-ran38 templates tests, rebuilt fixture;7 probe checks/7 captures incl inspected detail | merged main; ancestry verified | entry/route registration pending |
| Templates gallery | run76 /c56b5d45 | manager re-ran38 templates tests, rebuilt fixture;7 probe checks/7 captures incl inspected detail | merged main; ancestry verified | Settings entry/route landed94 |
| Stage definition | run77 retained/d88213d | review result-validation failure; manager verified retained slice and drove both-host probe (5 captures each) | merged main; ancestry verified | graph hook85 next |
| Attention model | run82 /38f8576c + manager224f8ee |13min;44 tests; manager namespaced dismissals to this client and re-ran tests | merged main; ancestry verified | bell/sheet UI84 next |
| Pipeline graph | Graph tab + stage pane wiring | run85 retained/0176720 | Code deadline recovery;62 pipelines tests + both-host probe; bounded measured canvas opens pinned definition | merged main; ancestry verified | published8096 |
@@ -53,7 +53,10 @@ All work under app/. Existing applications remain running and unchanged.
| Chat screen | Live Chat destination + read-only history | run79 retained/86a9b4a | deadline recovery;110 focused tests + both-host probes; real app probe verifies /chat/ses route and stored turn | merged main; ancestry verified | published8096 |
| Retry/restart | Retry and restart in actual detail | run80 /2de1c90 base |50min; focused suites; accepted-run navigation verified | merged main; ancestry verified | published8096 |
| Artifact gallery | Recorded visit groups in run detail | run81 retained/df6524c | Code deadline recovery;29 tests +16 fixture captures; real app probe verifies list/selection | merged main; ancestry verified | published8096 |
| Chat markdown | Safe native chat markdown | run83 /a5afc55a + manager5b85c8d | parser split into cohesive files; chat suite118 pass; unsafe links inert | merged main; ancestry verified | call-site wiring91 |
| Chat markdown | Safe native chat markdown | run83 /a5afc55a + manager5b85c8d | parser split into cohesive files; chat suite118 pass; unsafe links inert | merged main; ancestry verified | published8096 |
| Markdown callsites | Thread + artifact preview builder | run91 retained/dc6b963 | evidence bug blocked the run; manager ran234 chat/artifact tests; assistant prose formatted, user text exact | merged main; ancestry verified | published8096 |
| Templates entry | Settings row + /templates route | run94 retained/d527c83 | evidence bug blocked the run; manager ran91 application/settings tests; Back restores Settings, create invalidates list | merged main; ancestry verified | preview republish pending |
| Server evidence | Re-saved visit keeps newest evidence | manager fac055d | runs failed on a raw duplicate key when the runner saved a visit twice; per-visit evidence now upserts under the serialized writer; Go suite green | committed main | deploy after quiescence |
| Artifact viewer | In-app preview + paging | run86 retained/151bd1c | harness deadline recovery;99 artifacts tests + probe(7 viewer states,320/2x,Cupertino); gallery opens viewer for previewable types | merged main; ancestry verified | published8096 |
| Composer UI | Composer strip in the thread | run87 retained/421831b | server storage bug blocked the run; manager ran98 chat tests + both-host probes; drafts/send/stop | merged main; ancestry verified | published8096 |
| Search entry | Register Search in the shell | run88 retained/fd380ef | server storage bug blocked the run; manager ran45 tests + real-app probe; route restores prior screen | merged main; ancestry verified | published8096 |
@@ -107,23 +110,27 @@ override, server edit or shell-write bypass was used by the manager.
Allowed pipeline models: Luna or DeepSeek V4.1 Flash; current runs use Luna.
## Latest integration check
The port was briefly blocked by a SERVER defect, not app work: three runs failed
with `UNIQUE constraint failed: step_file_changes(run_id,sequence)`. A repeated
finish of the same visit with byte-identical evidence now succeeds (a harmless
replay after an ambiguous commit) while different evidence is still refused, so
finished records stay immutable. Regression added; full Go suite green; deployed
at a quiescent window with a SQLite/binary/plist backup under
`~/.local/share/pipelines/backups/evidencefix-20261022-000913` and only the
Pipelines server job restarted (installed SHA256
e7540e0df84a43a5c5f6965a3e4dabfa1499391af33ba9c58e709ef12915e7a0).
The port was blocked by a SERVER defect, not app work: runs failed with
`UNIQUE constraint failed: step_file_changes(run_id,sequence)`. A first fix let an
identical replay succeed, but two more runs then failed with "finished evidence
overwritten": the runner legitimately saves the same visit twice while it is still
running (a settlement after the export gate rescans artifacts), and the second save
carries different evidence. Evidence writes now replace that visit's previous row
under the run's serialized writer, while the step-state transition gate and the
atomic rollback test still hold. Full Go suite green; committed as fac055d and
deployed after the active runs settle, with the earlier backup under
`~/.local/share/pipelines/backups/evidencefix-20261022-000913` retained.
Recovered runs were finished directly rather than replayed: Search entry, run-mode
graph component, pipeline Graph tab, Needs-you bell/sheet, composer and markdown.
Integrated main now946 tests pass with clean analysis. Verified in real Chrome: the
pipeline Graph tab on both hosts at 390x844/2x (graph + pinned definition pane),
the registered Search route, and the 34-capture normal-app run/chat/artifacts flow.
Published bundle rollback build/web-before-graphtab-1792624373, JS SHA256
8f1853a0a9120378aeceba02c54cdf7a075163c33292140db61630894616e4c0.
graph component, pipeline Graph tab, Needs-you bell/sheet, composer, markdown
call-site wiring, Templates entry and (pending) the run Graph tab and saved
schedules. Integrated main now959 tests pass with clean analysis. Verified in real
Chrome: the pipeline Graph tab on both hosts at 390x844/2x (graph + pinned
definition pane), the registered Search route, one composer send with an exact
`chat_prompt` payload, and the 34-capture normal-app run/chat/artifacts flow
(35 captures with the composer step). Published bundle for the markdown wiring:
rollback build/web-before-md-1792625353, JS SHA256
e82352c955900716f7e081ee10cff38a7a4c0ee6a21245623c1bc4dfad6da00f.
The artifact viewer landed after its Code visit ended on a harness transport
deadline; the retained edits were verified rather than retried. Previewable