# Reliability playbook

This playbook keeps booter/shell lanes merge-ready without retry-dependent success.

## Triage order

1. Reproduce with `npm run test:booter:www-ssh` for www/ssh-holesail.
2. Reproduce shell regressions with `npm run test:shell-fast`.
3. Run repeat lane `npm run test:flake-repeat` and inspect `docs/audit/shell-flake-repeat-report.json`.
4. Enforce static gates with `npm run verify:reliability-gates`.

## Unskip policy

- No `test.skip` in first-party reliability suites:
  - `packages/bare-os-booter/test.bare-os-www.js`
  - `packages/bare-os-booter/test.bare-os-ssh-holesail.js`
- No broad placeholder assertions (`t.ok(true)`) in critical booter/shell suites.

## Failure classes

- Port/race timing
- Async lifecycle leak
- Runtime parity mismatch (Node vs Bare)
- Environment-coupled assertions

## Monthly review checklist

- Review trend in `docs/audit/shell-flake-repeat-report.json`.
- Regenerate `docs/audit/shell-reliability-report.json`.
- Confirm release checklist reliability gates are still accurate.