Bug: Local development instructions outdated; missing scripts; API fails to start due to circular dependency

[bluemoon288]

Following the README instructions for local development results in multiple issues:

1. Missing scripts
   The README references the following commands:

Code
pnpm --filter @telivityhaip/database run migrate
pnpm --filter @telivityhaip/api run seed
However, neither @telivityhaip/database nor @telivityhaip/api contains a migrate or seed script.
Running these commands results in:

Code
None of the selected packages has a "migrate" script
None of the selected packages has a "seed" script
2. API fails to start due to circular dependency
Running pnpm dev causes the API to crash immediately with:

Code
ReferenceError: Cannot access 'ChannelAdapterFactory' before initialization
This error originates from:

Code
apps/api/src/modules/channel/channel-adapter.factory.ts:12
It appears to be caused by a circular import between:

channel-adapter.factory.ts

ari.service.ts

possibly other channel-related services

Expected behavior
README instructions should match the actual workspace scripts.

Local development should start without runtime errors.

Migration/seed steps should either exist or be documented as handled by Docker.

Actual behavior
Migration and seed scripts referenced in the README do not exist.

API crashes on startup due to a circular dependency in the channel module.

Steps to reproduce
Clone the repository

Run: docker compose up -d postgres redis keycloak

• Run: pnpm install
• Run: pnpm build
• Run: pnpm dev

Observe crash

Environment

• Windows 11
• Node.js v20 / v24 tested
• pnpm 9.x
• Docker Desktop
• HAIP version: latest commit as of April 22, 2026

[telivity-otaip]

on it. will respond later tonight.

[telivity-otaip]

Fixed in 84f9025 (PR #89).

Circular dependency: The barrel ./adapters/booking-com/index.ts re-exports BookingComInboundController alongside BookingComAdapter. The factory imported the adapter from the barrel, which pulled the controller's import chain (→ inbound-reservation.service → ChannelAdapterFactory) into module init. Fixed by importing adapters directly from .adapter.ts files in both channel-adapter.factory.ts and channel.module.ts.

Missing scripts: Added migrate to @telivityhaip/database (points at src/push-schema.ts). Both migrate and seed live on the database package, not api. Updated the README accordingly.

Verified: pnpm dev now reports Nest application successfully started; pnpm --filter @telivityhaip/database run migrate and run seed both work; 575/575 tests pass. Thanks for the detailed repro.