@saacms/cli

The saacms binary. A thin orchestrator over codegen, migrations, publish, log fetching, and environment health checks. Per ADR 0011, it is not a server — the host framework's own dev command runs the show.

Surface

• saacms init — bootstrap saacms into an existing host project (v1 alpha: Astro only).
• saacms codegen [--watch] — Effect Schema → Drizzle / OpenAPI / TS-types / Puck-fields projections.
• saacms dev — sugar that runs the host's dev script alongside saacms codegen --watch.
• saacms migrate generate | run | check — DB and content migrations.
• saacms publish — commit drafts + generated routes to the developer's Git repo.
• saacms logs <deploy-id> — fetch deploy/runtime logs.
• saacms doctor — environment health report.

Reading order (relevant ADRs)

• 0011 — Dev workflow: piggyback the host's dev server
• 0012 — Migrations: schema (DB) and content (Page JSON)
• 0024 — v1 alpha scope: Astro + Cloudflare Pages + D1 + R2

Status

Scaffold. Sub-commands are wired through citty; handlers print what they would do and reference the relevant ADR. No real work is performed yet.