메뉴
Run the test suite for the Cartridge Controller monorepo. Use when validating changes, before committing, or when asked to run tests.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | run-tests |
| description | Run the test suite for the Cartridge Controller monorepo. Use when validating changes, before committing, or when asked to run tests. |
| Command | Purpose | Duration |
|---|---|---|
pnpm lint:check | Lint + format check | ~30s |
pnpm test | Unit tests | ~1-2min |
pnpm test:ci | Unit tests with coverage | ~2-3min |
pnpm test:storybook | Visual regression tests | ~5-10min |
pnpm build | Full build (includes type check) | ~2-3min |
pnpm e2e | End-to-end tests | ~5-10min |
Fastest check - always run before committing:
pnpm lint:check
This runs:
To auto-fix issues:
pnpm format # Fix formatting + lint
Tests the keychain package:
# Standard run
pnpm test
# With coverage report
pnpm test:ci
# Run specific test file
pnpm keychain test -- --testPathPattern="connection"
Test files are located in:
packages/keychain/src/**/*.test.tspackages/controller/src/__tests__/Tests UI components for visual changes:
# Run visual tests (compares against baseline)
pnpm test:storybook
# Update baseline snapshots after intentional changes
pnpm test:storybook:update
Snapshots are stored in:
packages/keychain/__image_snapshots__/TypeScript compilation catches type errors:
pnpm build
This also validates that all packages compile correctly.
Full integration tests with Playwright:
# Run headless
pnpm e2e
# Run with UI for debugging
pnpm e2e:ui
E2E tests are in:
examples/next/tests/To mirror what CI runs, execute in order:
# 1. Quality checks (quality.yml)
pnpm lint:check
# 2. Build and test (test.yml)
pnpm build
pnpm test:ci
# 3. Visual regression (test.yml - storybook job)
pnpm test:storybook
# Re-run failed test with more details
pnpm keychain test -- --verbose --testNamePattern="failing test name"
If Storybook tests fail with visual differences:
packages/keychain/__image_snapshots__/__diff_output__/pnpm test:storybook:update# Check specific package
pnpm controller build:deps
pnpm keychain build
# Controller SDK tests
pnpm controller test
# Keychain tests
pnpm keychain test
# Run test in watch mode for development
pnpm keychain test -- --watch
pnpm clean && pnpm i && pnpm build:deps
Ensure the Storybook server is not already running on port 6006.
Ensure dev servers are running:
pnpm dev # In one terminal
pnpm e2e # In another
The git pre-commit hook automatically runs:
pnpm run format --ui stream
pnpm run lint:check --ui stream
This ensures basic quality before every commit.
Run commands in specific workspace packages using pnpm filters. Use to execute commands in specific packages within the monorepo.
Clean all build artifacts and rebuild from scratch. Use when experiencing stale build artifacts, Turbo cache issues, mysterious build failures, or after dependency updates.
Review code changes for quality, correctness, and best practices. Use when asked to review a PR, review changes, or assess code quality before merge.
Regenerate GraphQL types from API schema. Use when API schema has changed, GraphQL queries/mutations added or modified, or type errors in API calls.
Dispatch a release using GitHub Actions. Use when asked to create a release, publish to npm, or start the release process.
Run all pre-commit checks before committing changes. Use to manually verify changes pass all quality gates before committing.