bopodev-api
v0.1.28
Published
Express API, websocket hub, and heartbeat scheduler runtime for Bopo.
Readme
apps/api
Express API, websocket hub, and heartbeat scheduler runtime for Bopo.
Responsibilities
- Serve HTTP routes for planning, execution, governance, observability, plugins, and templates.
- Attach websocket hub on
/realtimefor company-scoped live updates. - Run heartbeat scheduler/queue worker based on
BOPO_SCHEDULER_ROLE.
Runtime Entry Points
src/server.ts- startup, env loading, realtime bootstrap, scheduler ownership.src/app.ts- middleware, route mounting, error handling.src/routes/*.ts- route groups.src/worker/scheduler.ts- periodic sweep orchestration.
Local Development
From repository root (recommended):
pnpm devorpnpm start
From this package directly:
pnpm --filter bopodev-api devpnpm --filter bopodev-api startpnpm --filter bopodev-api db:initpnpm --filter bopodev-api onboard:seedpnpm --filter bopodev-api workspaces:backfill
Default port is 4020 (API_PORT/PORT).
Key Route Groups
/auth,/attention,/companies,/projects,/issues,/goals/agents,/governance,/heartbeats,/observability/plugins,/templates
Related Docs
docs/developer/api-reference.mddocs/developer/configuration-reference.mddocs/operations/deployment.md
