Skip to content

Commit 5d23cee

Browse files
authored
e2e: remove the browse/promote authoring loop (#1205)
The browse -> promote pipeline (drive a flow, record the steps, codegen a test) was more than intended. Developing against the UI is just running Playwright, which is already in-repo and is the same thing a scenario() runs. Remove src/journey/ (steps/codegen/run), the browse/promote commands in scripts/cli.ts, and the "Authoring from a live browser" doc section. The cross-OS desktop targets are unaffected.
1 parent b0f4b82 commit 5d23cee

5 files changed

Lines changed: 0 additions & 776 deletions

File tree

e2e/AGENTS.md

Lines changed: 0 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -130,38 +130,6 @@ When handing results to the user, follow the evidence contract in the root
130130
[AGENTS.md](../AGENTS.md) (direct run links + a live instance + what to try);
131131
[RUNNING.md](../RUNNING.md) has the current sharing/demo mechanics.
132132

133-
## Authoring from a live browser (`browse``promote`)
134-
135-
You don't have to hand-write a browser scenario. Drive a running instance's web
136-
UI one step at a time, then turn the recorded journey into a committed scenario.
137-
The generated test drives the same Browser surface the exploration drove, so it
138-
is the real test, not a transcript of one — develop the flow, then crystallize
139-
it.
140-
141-
```sh
142-
cd e2e
143-
bun run cli up cloud # a live instance to develop against
144-
bun run cli browse cloud goto / # each step REPLAYS the whole flow from a
145-
bun run cli browse cloud click link Policies # clean browser and prints the page's controls
146-
bun run cli browse cloud at-url /policies # (role · name) + a screenshot, so the next
147-
bun run cli browse cloud see "No policies yet" # step is written against what's actually there
148-
bun run cli promote cloud "Policies · a fresh workspace has none"
149-
```
150-
151-
Each `browse` replays every step so far, so what you are building is, at every
152-
moment, exactly what `promote` emits — a step that doesn't reproduce fails here,
153-
not in CI. Steps: `goto <path>`, `click <role> <name>`, `click-text <text>`,
154-
`fill <field> <value>`, `press <key>`, and the assertions `see <text>` /
155-
`at-url <substring>`. `--label "…"` names a step (it becomes the `step(...)`
156-
group); `browse <target> show | undo | reset` manages the journey.
157-
158-
`promote` writes `<target>/<slug>.gen.test.ts` and runs it against the live
159-
instance, producing the usual run artifacts (session.mp4, step screenshots,
160-
trace). A journey with no assertion is refused — a scenario must prove
161-
something. From then on the file is an ordinary scenario: edit it, add API/MCP
162-
checks, drop the `.gen` once it's yours. The journey itself lives in
163-
`.dev/<target>.journey.json` (gitignored), not the repo.
164-
165133
## Desktop targets (the app on real OSes, filmed)
166134

167135
The packaged desktop app runs as its own targets, each landing in its own

0 commit comments

Comments
 (0)