Skip to content
M2 Planner Docs

API

One-liner

Hono OpenAPIHono app running on Cloudflare Workers, with Drizzle ORM against Postgres through Hyperdrive. All domain writes, authentication, queue consumers, and scheduled jobs live here.

Source

  • Code: apps/api/
  • Agent guide: apps/api/AGENTS.md

Overview (TODO)

Architecture (TODO)

Key flows (TODO)

  • Authentication + JWT refresh
  • Role-based access (user / architect / architect_client / admin)
  • File upload presign/commit/attach/detach — documented in Platform → File Storage
  • Queue consumers (CLEANUP_QUEUE, EMBEDDING_QUEUE)
  • Scheduled jobs (cron)
  • Stripe webhooks
  • Feature flag evaluation
  • AGENTS.md — in-repo agent conventions for API work
  • docs/superpowers/specs/ — design docs per subsystem
  • docs/migration-reports/ — post-mortems and migration trails