outfitter-dev/skillset/skillset-dev-testing

Skillset Testing

Choose The Evidence Level

1. Read docs/adrs/0012-fixtures-tests-dogfooding-and-evals.md, docs/adrs/0019-deterministic-projection-and-adapter-conformance.md, and fixtures/README.md.
2. Use an inline temp fixture for focused positive, negative, diagnostic, and lifecycle cases.
3. Add fixtures/<case>/ only for a durable whole-repo case shared by tests or too large to read inline.
4. Use pinned external fixtures only for opt-in adoption fidelity evidence; turn discovered product gaps into ordinary focused regression tests.
5. Keep compiler fixtures, self-hosted dogfooding, deterministic skillset test declarations, provider runtime probes, and model-facing evals distinct.

Read references/fixture-strategy.md before adding a checked-in or Git-backed fixture, changing test sandbox behavior, or choosing a conformance lane.

Protect The Sandbox

• Build Git-backed fixtures only with scripts/test-helpers/git-remote.ts under a proven disposable root.
• Preserve HOME; rely on repository verification entrypoints to isolate XDG roots and Git configuration.
• Never initialize, configure, or commit into an arbitrary temp path, linked worktree, shared Git directory, or the Skillset checkout.
• Never hand-edit generated fixture output to make a test pass.
• Allocate temp fixtures with createTestFixtureRoot and observe cleanup with tempEntriesLeftBy (both in scripts/test-helpers/fixture-root.ts). Never call the OS tmpdir() in a test; bun run test-fixture-temp:guard fails it.
• After killing a process or process group, await expectProcessGone(pid) from scripts/test-helpers/process.ts. A one-shot process.kill(pid, 0) check is flaky on Linux, and bun run process-gone:guard rejects it.

Verify Narrowly Then Broadly

• Run focused tests with bun run test:focused -- <test-files...>.
• Run bun run conformance:determinism, bun run conformance:adapters, or bun run conformance:fast when the compiler projection or provider contract changes.
• Keep bun run conformance:external opt-in and network-aware.
• Rebuild and check self-hosted output after .skillset/ changes.
• Run bun run check before handoff and report any skipped slow or credentialed evidence explicitly.