---
name: test-runner
description: Run and triage Go tests with correct environment handling; produce compact, actionable failure summaries.
license: MIT
metadata:
  mode: verify
  purpose: test
---

# Test Runner

## When to Use

- Validate changes with unit/integration tests or triage failing test runs.

## Rules

- Use `source setTestEnv.sh` when environment variables are required.
- Focus on the first actionable failure line and include package + test name.
- Prefer targeted test runs (`-run`) over full-suite when iterating.

## Commands

- **Full suite (with test env):** `source setTestEnv.sh && go test -v -cover ./...`
- **Single package:** `source setTestEnv.sh && go test -v -cover ./lib/...`
- **Single test:** `source setTestEnv.sh && go test -v -run TestHashPass ./lib/...`

## Output

- **Result:** pass or fail.
- **Failures:** package, test name, first actionable error lines.
- **Next:** 1-3 focused suggestions (narrow test, inspect file, add mock).

## Related Skills

- `logs-repro-harness`, `linter-runner`, `db-infra-mocks`