test

name	test
description	Runs lint, type check, tests, and visual verification. Auto-detects tools. Use when running tests, linting, type checking, or writing tests.
argument-hint	<run | write | browser | electron | all> [staged | branch]

Arguments: $ARGUMENTS

Command	Behavior
run	Lint + type check + run tests
write	Generate tests, then run pipeline
browser	Visual verification (web apps)
electron	Visual verification (Electron/VS Code apps)
all	run + browser/electron combined

Scope (optional, default: branch):

Scope	Command
branch	git diff main...HEAD --name-only
staged	git diff --cached --name-only

---

Run Mode

1. Detect Tools

Config	Tool	Command
package.json + vitest	Vitest	npx vitest run
package.json + jest	Jest	npx jest
package.json + "test"	npm	npm test
pyproject.toml	pytest	pytest
Cargo.toml	cargo	cargo test
go.mod	go	go test ./...
.eslintrc* / eslint.config.*	ESLint	npx eslint .
biome.json	Biome	npx biome check .
tsconfig.json	TypeScript	npx tsc --noEmit

2. Setup (if missing)

# JS/TS test runner
npm install -D vitest

# JS/TS linter
npm install -D eslint @eslint/js

# JS/TS types
npm install -D typescript && npx tsc --init

# Python
pip install pytest ruff mypy

3. Run Pipeline

# 1. Lint
npx eslint . --fix  # or: npx biome check . --write

# 2. Type check
npx tsc --noEmit    # or: mypy .

# 3. Test
npx vitest run      # or: pytest, cargo test, go test ./...

Fix errors, re-run until all pass.

---

Write Mode

1. Get Changed Files

git diff main...HEAD --name-only  # branch scope
git diff --cached --name-only     # staged scope

Filter to source files (exclude tests, configs, docs).

2. Launch Test Writers

Delegate files to the test-writer subagent (persona in agents/test-writer.md). It determines testability and writes tests.

Files	Subagents
1-3	1
4-8	2-3
9+	3-5

spawn subagent(role="test-writer", prompt="Write tests for: [file list]. Runner: vitest. Convention: *.test.ts")

3. Run Pipeline

Same as Run Mode step 3.

---

Browser Mode

Visual verification for web apps. The legacy standalone UI automation workflow has been removed; use the host environment's available browser automation tool directly.

1. Detect dev server URL from package.json or running processes
2. Open the URL, capture an accessibility/DOM snapshot, interact through semantic selectors, and take screenshots
3. Screenshots go to .otto/test-screenshots/
4. Cleanup any browser session/tool process and remove .otto/test-screenshots when no longer needed

---

Electron Mode

Visual verification for Electron/VS Code apps. The legacy standalone UI automation workflow has been removed; use the app's project-specific harness first when available, otherwise use the host environment's available browser automation tool directly.

1. Detect app type: engines.vscode in package.json → VS Code extension, electron in dependencies → Electron app
2. Build first: npm run compile
3. Launch with CDP/automation hooks, connect, inspect snapshots/webviews, interact through semantic selectors, and take screenshots
4. Screenshots go to .otto/test-screenshots/
5. Cleanup browser/app processes and remove .otto/test-screenshots when no longer needed

---

All Mode

1. Run Mode (lint, type check, test)
2. Auto-detect: web → Browser Mode, Electron/VS Code → Electron Mode
3. Report results