feat: UI improvements and E2E testing with agent-browser

- Move font controls (A+/A-) to left of connection status
- Redesign tab count with stepper buttons (−/number/+)
- Remove respawn panel, integrate settings into session options modal
- Fix Monitor panel SSE handler (wrong element ID)
- Add screen wrapping support to Session class
- Add E2E testing skill using agent-browser
- Document testing approach in README.md and CLAUDE.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
arkon
2026-01-19 03:40:57 +01:00
co-authored by Claude Opus 4.5
parent 7d01d3f274
commit bf41dab827
10 changed files with 770 additions and 311 deletions
+101
View File
@@ -322,6 +322,8 @@ GET /api/status # Full state snapshot (sessions + schedule
## Testing
### Unit Tests
Tests use Vitest and auto-discover `*.test.ts` files in the `test/` directory:
```bash
@@ -332,6 +334,105 @@ npx vitest run test/session.test.ts # Single file
npx vitest run -t "should create session" # By pattern
```
### E2E Testing with agent-browser
For UI testing, we use [agent-browser](https://github.com/vercel-labs/agent-browser) - a fast CLI for browser automation optimized for AI agents.
**Installation:**
```bash
npm install agent-browser --save-dev
npx agent-browser install # Download Chromium
```
**Basic E2E Test Flow:**
```bash
# Start the server
npx tsx src/index.ts web &
# Open browser
npx agent-browser open http://localhost:3000
# Get page snapshot (shows accessibility tree with element refs)
npx agent-browser snapshot
# Click elements by reference
npx agent-browser click @e5 # Click element with ref=e5
# Or use semantic locators
npx agent-browser find text "Run Claude" click
npx agent-browser find role button click --name "Monitor"
# Fill inputs
npx agent-browser fill @e32 "my-session-name"
# Execute JavaScript in page context
npx agent-browser eval "app.sessions.get(app.activeSessionId)"
# Take screenshots
npx agent-browser screenshot /tmp/test-result.png
# Close browser
npx agent-browser close
```
**E2E Test Skill (`.claude/skills/e2e-test.md`):**
A skill file exists that documents the full E2E test plan. Key tests include:
1. **Initial Load**: Verify header layout (font controls, connection status, tokens)
2. **Font Controls**: Test A-/A+ buttons change font size
3. **Tab Count Stepper**: Test −/+ buttons increment/decrement
4. **Session Creation**: Create session, verify screen wrapping
5. **Session Options Modal**: Open gear icon, verify respawn settings visible
6. **Monitor Panel**: Test Screen Sessions and Background Tasks display
**Example Test Session:**
```bash
# Clean up previous screens
screen -ls | grep -oP '\d+\.claudeman-[a-z0-9]+' | while read s; do
screen -S "$s" -X quit
done
# Start fresh server
rm -f ~/.claudeman/screens.json
npx tsx src/index.ts web &
sleep 4
# Run tests
npx agent-browser open http://localhost:3000
npx agent-browser snapshot | head -30 # Check initial state
npx agent-browser click @e5 # Run Claude
sleep 4
npx agent-browser snapshot # Verify session created
# Check screen wrapping
screen -ls | grep claudeman # Should show screen session
# Check session has PID
npx agent-browser eval "app.sessions.get(app.activeSessionId).pid"
# Test session options
npx agent-browser eval "document.querySelector('[title=\"Session options\"]').click()"
npx agent-browser snapshot | grep -E "Respawn|Enable" # Should show respawn settings
npx agent-browser screenshot /tmp/test-final.png
npx agent-browser close
```
**Key Commands:**
| Command | Description |
|---------|-------------|
| `open <url>` | Navigate to URL |
| `snapshot` | Get accessibility tree with element refs |
| `snapshot -i` | Interactive elements only |
| `click @ref` | Click element by ref |
| `fill @ref "text"` | Fill input field |
| `eval "js code"` | Execute JavaScript |
| `screenshot path` | Save screenshot |
| `find text/role/label "x" click` | Semantic element location |
| `wait 1000` | Wait milliseconds |
| `close` | Close browser |
## Frontend
The web UI (`src/web/public/`) uses vanilla JavaScript with: