Refactor

Naming:

• Factory functions: createXNode() — never export classes
• Config types: *Config (YAML/static), *Options (runtime)
• Node classes: [ServiceArea][Action]Node

Imports:

• Use subpath imports in external code: @chimpanze/flowapi/services
• Use relative imports in internal code: ../errors/types
• Tests import from source: ../../packages/X/src/...

Exports:

• Update barrel index.ts files when moving/renaming exports
• Never create alias exports
• Never export classes — only factories and types

Runtime:

• Bun SQL: sql.unsafe() returns rows directly (not { rows })
• Bun SQL: sql.begin() for transactions
• Use Bun.password instead of bcrypt
• Use Bun.S3Client instead of minio

Code Style:

• Biome enforced: single quotes, ES5 trailing commas, 2-space indent
• No unused variables (prefix with _ only if truly needed)
• Prefer early returns over nested conditionals

Step 4: Update Consumers

After refactoring, update all consumers:

1. Tests in tests/
2. Other packages in packages/
3. Examples in examples/
4. Documentation in docs/

Step 5: Verify

Run the quality gates:

bunx biome check .          # Lint
npx tsc --noEmit            # Typecheck
bun tests/runner.ts         # Tests

All three must pass before considering the refactor complete.