local-frontend-check

name local-frontend-check description Smoke-test or verify UI behaviour on the local Jarvis Registry frontend running at http://localhost/gateway. Use for manual regression checks, bug-fix verification, and end-to-end confirmation of specific flows without running the automated test suite. allowed-tools Bash(playwright-cli:*) Bash(docker:*) Local Frontend Check Skill Fixed Configuration Setting Value Base URL http://localhost/gateway Browser session Named jarvis — keeps a stable, reusable identity across runs Launch flags --persistent --headed — profile saved to disk, browser window visible Backend log container <cwd-basename>-registry-1 — where <cwd-basename> is the basename of your current working directory (e.g. if CWD is /projects/jarvis-registry , use jarvis-registry-registry-1 ) Workflow Follow these phases in order every time this skill is invoked. Do not skip phases. Phase 1 — Open the browser playwright-cli -s=jarvis open http://localhost/gateway --persistent --headed Then take a snapshot to read the page's current state: playwright-cli -s=jarvis snapshot Phase 2 — Handle authentication Inspect the snapshot. If the app loads directly (no login form, no auth redirect visible): the persistent profile is still valid. Skip to Phase 3. If a login page or auth redirect is visible : the session has expired or this is a first run. Do the following: Tell the user: "The browser window is open and showing a login page. Please log in in the headed browser window, then confirm here when done." Use AskUserQuestion to wait for the user's confirmation before continuing. Take a second snapshot and verify the app has loaded (URL is no longer the login page, and the main app UI is visible). If still on the login page, tell the user and repeat. Because --persistent saves the profile to disk, subsequent runs will pick up the stored session automatically and this phase will be skipped. Phase 3 — Orient and navigate Read the user's description of what to check. Navigate to the relevant section of the UI: Use playwright-cli -s=jarvis goto <url> for direct navigation. Use playwright-cli -s=jarvis snapshot --depth=3 to get a lightweight view of a complex page. Use playwright-cli -s=jarvis click <ref> to follow navigation links or open panels. Take snapshots as needed to orient yourself before acting. Phase 4 — Perform the described operations Execute the operations step by step. After each significant action (form submit, dialog confirm, delete button, save button), take a snapshot immediately to observe the result. Note what you see: Success signals : confirmation toast/banner, resource list updated, no error visible, HTTP response in UI shows 2xx. Failure signals : error toast, error dialog, HTTP 4xx/5xx error text, UI stuck in loading state. Capture a screenshot at any notable point (success or failure): playwright-cli -s=jarvis screenshot Phase 5 — Read backend logs After triggering the key operation(s), read recent logs from the backend container: docker logs <cwd-basename>-registry-1 -- tail =200 2>&1 # Replace <cwd-basename> with the basename of your CWD (e.g. `jarvis-registry` if CWD is `/projects/jarvis-registry`) Look for: Python tracebacks or ERROR -level log lines near the time of the operation. HTTP route log lines showing the request method, path, and status code. Any RuntimeError , ValueError , or DuplicateKeyError messages. If the log output is noisy, filter for the operation's timeframe by scanning the last N lines around when you performed the action. Phase 6 — Report findings Summarise clearly: Operations performed — what you did and in what order. UI result — what the browser showed after each operation (include snapshot filenames or key text). Log evidence — relevant log lines (errors, warnings, or confirmation of a clean request/response). Verdict — PASS or FAIL with a one-sentence reason. Notes Do not close the browser session at the end unless the user asks. Leaving it open avoids re-login overhead on follow-up checks. If the app is unreachable ( ERR_CONNECTION_REFUSED ), tell the user that the services may not be running and suggest docker compose up -d . Use playwright-cli -s=jarvis snapshot <ref> to inspect a specific element more closely when the full-page snapshot is too large. If an operation opens a confirmation dialog, handle it explicitly with playwright-cli -s=jarvis click <confirm-button-ref> rather than assuming it auto-dismisses.