Update claude.md

Author: jdalton

CLAUDE.md

@@ -15,18 +15,30 @@ You are a **Principal Software Engineer** responsible for:
 
 ### Development Commands
 - **Build**: `npm run build` (alias for `npm run build:dist`)
-- **Build source**: `npm run build:dist:src`
+- **Build source**: `npm run build:dist:src` or `pnpm build:dist:src`
 - **Build types**: `npm run build:dist:types`
 - **Test**: `npm run test` (runs check + all tests)
-- **Test unit only**: `npm run test:unit`
+- **Test unit only**: `npm run test:unit` or `pnpm test:unit`
+- **Test specific file**: `pnpm run test:unit -- path/to/test.mts`
+- **Test with pattern**: `pnpm run test:unit -- path/to/test.mts -t "test name pattern"`
 - **Test with coverage**: `npm run test:unit:coverage`
-- **Update test snapshots**: `npm run testu` (builds, then updates snapshots)
+- **Update test snapshots**: `npm run testu` or `pnpm testu` (builds, then updates snapshots)
+- **Update snapshots for specific file**: `pnpm run testu -- path/to/test.mts`
 - **Lint**: `npm run check:lint` (uses eslint)
 - **Type check**: `npm run check:tsc` (uses tsgo)
 - **Check all**: `npm run check` (lint + typecheck)
 - **Fix linting**: `npm run lint:fix`
 - **Commit without tests**: `git commit --no-verify` (skips pre-commit hooks including tests)
 
+### Testing Best Practices
+- **Always build before testing**: Run `pnpm build:dist:src` before running tests to ensure dist files are up to date
+- **Test single files**: `pnpm run test:unit src/commands/specific/cmd-file.test.mts` (no `--` needed)
+- **Test with pattern**: `pnpm run test:unit src/commands/specific/cmd-file.test.mts -t "pattern"`
+- **Update snapshots**:
+  - All tests: `pnpm testu` (builds first, then updates all snapshots)
+  - Single file: `pnpm run test:unit src/commands/specific/cmd-file.test.mts --update`
+- **Timeout for long tests**: Some tests may need longer timeouts, which can be specified in the test file
+
 ### Git Commit Guidelines
 - **🚨 FORBIDDEN**: NEVER add Claude co-authorship or Claude signatures to commits
 - **🚨 FORBIDDEN**: Do NOT include "Generated with Claude Code" or similar AI attribution in commit messages