Imhotep/BUILD.md

Build and Verification

Prerequisites

• Node.js >= 18
• npm >= 9 (workspace support)

Install

npm ci

Build All Packages

npm run build

Root build executes workspaces in dependency order. All 14 packages compile cleanly.

Type Check

npm run typecheck

Unit/Integration Test Sweep

npm test --workspaces

Runs all tests across all workspaces. Current status: 959 unit tests passing, 0 failures.

E2E (Playwright)

npx playwright test --config packages/imhotep-fixtures/playwright.config.ts

Playwright config lives at packages/imhotep-fixtures/playwright.config.ts and targets packages/imhotep-fixtures/src/e2e*.test.ts.

Current status: 215 E2E tests passing, 0 failures.

External Smoke Test

npm run test:external-smoke

Creates a clean temp directory, installs packages from local paths, and runs a full integration smoke test. Verifies that the published package structure works correctly.

Common Targeted Runs

# Run tests for a specific package
npm test -w packages/imhotep-playwright
npm test -w packages/imhotep-fixtures

# Run specific E2E test file
npx playwright test packages/imhotep-fixtures/src/e2e-public.test.ts

Clean

npm run clean

Packaging Smoke

Use this before publishing a package:

npm pack --json

Check packed package/package.json for:

• no workspace:* protocol dependencies
• correct main, types, and exports