Skip to content

feat: Jev QA mode — switchable, remembered screen checks with an HTML report (v0.21.0) - #16

Merged
cskwork merged 1 commit into
mainfrom
feat/jev-qa-mode
Oct 1, 2026
Merged

cskwork merged 1 commit into
mainfrom
feat/jev-qa-mode

Conversation

@cskwork

@cskwork cskwork commented Oct 1, 2026

Copy link
Copy Markdown
Owner

What

A second way for the verifier to check screens: jev mode runs each UI scenario through Jego (Jev on Ego Lite) and produces one HTML report with screenshots, time, and cost per scenario. The default stays agent; nothing changes until someone switches.

How it works

  • tools/qa-mode.sh set jev [--jev-dir <path>] switches and remembers the choice in ${XDG_CONFIG_HOME:-~/.config}/sdlc-kit/config, so it holds in every project until set agent.
  • --project writes .sdlc/config.md qa_mode: instead, which overrides the user default for that project.
  • tools/qa-mode.sh check says whether Jego can run (checkout, ego-browser, node, TypeSafe key presence). When it cannot, the verifier uses agent mode and states why. It never switches silently.
  • docs/jev-qa.md gives the verifier steps: scenarios from the plan, qa/run.mjs, reviewer notes, qa/report.mjs, and what counts as evidence. The agent's own DONE never counts; expected texts, the final URL, and an independent re-open do.

Changed

tools/qa-mode.sh (new), docs/jev-qa.md (new), roles/verifier.md, SKILL.md route, init.sh config template (qa_mode:, jev_dir:), READMEs EN/KO, gates/selftest.sh (new qa_mode section), VERSION 0.21.0, log/changelog-v0.21.0.md.

Verified

  • bash gates/selftest.sh → SELFTEST PASS, including the new section: default agent, remembered across projects, project override, unknown modes refused, check fails closed.
  • I followed the documented jev steps in a scratch project: set jev → check ready → qa/run.mjs on 2 public-site scenarios → 2/2 passed → report.html built.
  • The Jego QA runner itself was exercised on a 20-scenario run against a real web app.

… report (v0.21.0)

The verifier's UI checks can run through Jego (ego-jev-ultrafast): each
scenario is a plain-language goal plus the texts that must appear, re-checked
in a fresh tab, with one HTML report (screenshots, time, cost) for the ship
gate. Default stays agent.

tools/qa-mode.sh switches and remembers the mode: the user default lives in
${XDG_CONFIG_HOME:-~/.config}/sdlc-kit/config and holds across projects; a
project's .sdlc/config.md qa_mode: overrides it. check reports whether Jego
can run; when it cannot, the verifier uses agent mode and says why.

Docs: docs/jev-qa.md, verifier role, SKILL.md route, READMEs (EN/KO).
Selftest: new qa_mode section; full SELFTEST PASS.
@cskwork
cskwork merged commit ca73677 into main Oct 1, 2026
3 checks passed
@cskwork
cskwork deleted the feat/jev-qa-mode branch October 1, 2026 01:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant