webterm/.github/copilot-instructions.md

Copilot Development Instructions

Makefile Usage (MANDATORY)

Always use the Makefile for development tasks. Never run raw go test, go vet, or bun commands directly.

Quick Reference

Task	Command	Description
Run tests	make test	Run Go tests
Run linter	make lint	Run go vet
Format code	make format	Run gofmt
Coverage report	make coverage	Run Go coverage with -coverpkg
Full check	make check	Run lint + coverage
Race tests	make race	Run go test -race
Fuzz smoke run	make fuzz	Run all fuzz targets briefly
Build frontend	make build	TypeScript typecheck + bundle
Build Go binary	make build-go	Build CLI binary
Full rebuild	make build-all	Clean + deps + build + checks
See all targets	make help	Show all available commands

Development Workflow

1. Before changes: Run make check to establish baseline.
2. After changes: Run make check and make race.
3. Frontend edits: Run make build after changing webterm/static/js/terminal.ts.
4. Major validation: Run make build-all for a reproducible full run.