@zenstackhq/cli 3.0.0-beta.23 → 3.0.0-beta.24

package/dist/index.js

@@ -13,39 +13,11 @@ var __export = (target, all) => {
 
 // src/index.ts
 import { ZModelLanguageMetaData } from "@zenstackhq/language";
-import colors7 from "colors";
+import colors8 from "colors";
 import { Command, CommanderError, Option } from "commander";
 
-// src/actions/db.ts
-import fs2 from "fs";
-
-// src/utils/exec-utils.ts
-import { execSync as _exec } from "child_process";
-import { fileURLToPath } from "url";
-function execSync(cmd, options) {
-  const { env: env2, ...restOptions } = options ?? {};
-  const mergedEnv = env2 ? {
-    ...process.env,
-    ...env2
-  } : void 0;
-  _exec(cmd, {
-    encoding: "utf-8",
-    stdio: options?.stdio ?? "inherit",
-    env: mergedEnv,
-    ...restOptions
-  });
-}
-__name(execSync, "execSync");
-function execPrisma(args, options) {
-  let prismaPath;
-  if (typeof import.meta.resolve === "function") {
-    prismaPath = fileURLToPath(import.meta.resolve("prisma/build/index.js"));
-  } else {
-    prismaPath = __require.resolve("prisma/build/index.js");
-  }
-  execSync(`node ${prismaPath} ${args}`, options);
-}
-__name(execPrisma, "execPrisma");
+// src/actions/check.ts
+import colors2 from "colors";
 
 // src/actions/action-utils.ts
 import { loadDocument } from "@zenstackhq/language";
@@ -85,12 +57,12 @@ function getSchemaFile(file) {
       return pkgJsonConfig.schema;
     }
   }
-  if (fs.existsSync("./zenstack/schema.zmodel")) {
-    return "./zenstack/schema.zmodel";
-  } else if (fs.existsSync("./schema.zmodel")) {
+  if (fs.existsSync("./schema.zmodel")) {
     return "./schema.zmodel";
+  } else if (fs.existsSync("./zenstack/schema.zmodel")) {
+    return "./zenstack/schema.zmodel";
   } else {
-    throw new CliError('Schema file not found in default locations ("./zenstack/schema.zmodel" or "./schema.zmodel").');
+    throw new CliError('Schema file not found in default locations ("./schema.zmodel" or "./zenstack/schema.zmodel").');
   }
 }
 __name(getSchemaFile, "getSchemaFile");
@@ -173,15 +145,71 @@ function findUp(names, cwd = process.cwd(), multiple = false, result = []) {
 }
 __name(findUp, "findUp");
 
+// src/actions/check.ts
+async function run(options) {
+  const schemaFile = getSchemaFile(options.schema);
+  try {
+    await loadSchemaDocument(schemaFile);
+    console.log(colors2.green("\u2713 Schema validation completed successfully."));
+  } catch (error) {
+    console.error(colors2.red("\u2717 Schema validation failed."));
+    throw error;
+  }
+}
+__name(run, "run");
+
+// src/actions/db.ts
+import fs2 from "fs";
+
+// src/utils/exec-utils.ts
+import { execSync as _exec } from "child_process";
+import { fileURLToPath } from "url";
+function execSync(cmd, options) {
+  const { env: env2, ...restOptions } = options ?? {};
+  const mergedEnv = env2 ? {
+    ...process.env,
+    ...env2
+  } : void 0;
+  _exec(cmd, {
+    encoding: "utf-8",
+    stdio: options?.stdio ?? "inherit",
+    env: mergedEnv,
+    ...restOptions
+  });
+}
+__name(execSync, "execSync");
+function execPackage(cmd, options) {
+  const packageManager = process?.versions?.["bun"] ? "bunx" : "npx";
+  execSync(`${packageManager} ${cmd}`, options);
+}
+__name(execPackage, "execPackage");
+function execPrisma(args, options) {
+  let prismaPath;
+  try {
+    if (typeof import.meta.resolve === "function") {
+      prismaPath = fileURLToPath(import.meta.resolve("prisma/build/index.js"));
+    } else {
+      prismaPath = __require.resolve("prisma/build/index.js");
+    }
+  } catch {
+  }
+  if (!prismaPath) {
+    execPackage(`prisma ${args}`, options);
+    return;
+  }
+  execSync(`node ${prismaPath} ${args}`, options);
+}
+__name(execPrisma, "execPrisma");
+
 // src/actions/db.ts
-async function run(command, options) {
+async function run2(command, options) {
   switch (command) {
     case "push":
       await runPush(options);
       break;
   }
 }
-__name(run, "run");
+__name(run2, "run");
 async function runPush(options) {
   const schemaFile = getSchemaFile(options.schema);
   const prismaSchemaFile = await generateTempPrismaSchema(schemaFile);
@@ -206,11 +234,29 @@ async function runPush(options) {
 }
 __name(runPush, "runPush");
 
+// src/actions/format.ts
+import { formatDocument } from "@zenstackhq/language";
+import colors3 from "colors";
+import fs3 from "fs";
+async function run3(options) {
+  const schemaFile = getSchemaFile(options.schema);
+  let formattedContent;
+  try {
+    formattedContent = await formatDocument(fs3.readFileSync(schemaFile, "utf-8"));
+  } catch (error) {
+    console.error(colors3.red("\u2717 Schema formatting failed."));
+    throw error;
+  }
+  fs3.writeFileSync(schemaFile, formattedContent, "utf-8");
+  console.log(colors3.green("\u2713 Schema formatting completed successfully."));
+}
+__name(run3, "run");
+
 // src/actions/generate.ts
 import { invariant } from "@zenstackhq/common-helpers";
 import { isPlugin } from "@zenstackhq/language/ast";
 import { getLiteral, getLiteralArray } from "@zenstackhq/language/utils";
-import colors2 from "colors";
+import colors4 from "colors";
 import path4 from "path";
 import ora from "ora";
 
@@ -223,7 +269,7 @@ __export(plugins_exports, {
 
 // src/plugins/prisma.ts
 import { PrismaSchemaGenerator as PrismaSchemaGenerator2 } from "@zenstackhq/sdk";
-import fs3 from "fs";
+import fs4 from "fs";
 import path2 from "path";
 var plugin = {
   name: "Prisma Schema Generator",
@@ -232,21 +278,21 @@ var plugin = {
     let outFile = path2.join(defaultOutputPath, "schema.prisma");
     if (typeof pluginOptions["output"] === "string") {
       outFile = path2.resolve(defaultOutputPath, pluginOptions["output"]);
-      if (!fs3.existsSync(path2.dirname(outFile))) {
-        fs3.mkdirSync(path2.dirname(outFile), {
+      if (!fs4.existsSync(path2.dirname(outFile))) {
+        fs4.mkdirSync(path2.dirname(outFile), {
           recursive: true
         });
       }
     }
     const prismaSchema = await new PrismaSchemaGenerator2(model).generate();
-    fs3.writeFileSync(outFile, prismaSchema);
+    fs4.writeFileSync(outFile, prismaSchema);
   }
 };
 var prisma_default = plugin;
 
 // src/plugins/typescript.ts
 import { TsSchemaGenerator } from "@zenstackhq/sdk";
-import fs4 from "fs";
+import fs5 from "fs";
 import path3 from "path";
 var plugin2 = {
   name: "TypeScript Schema Generator",
@@ -255,32 +301,37 @@ var plugin2 = {
     let outDir = defaultOutputPath;
     if (typeof pluginOptions["output"] === "string") {
       outDir = path3.resolve(defaultOutputPath, pluginOptions["output"]);
-      if (!fs4.existsSync(outDir)) {
-        fs4.mkdirSync(outDir, {
+      if (!fs5.existsSync(outDir)) {
+        fs5.mkdirSync(outDir, {
           recursive: true
         });
       }
     }
     const lite = pluginOptions["lite"] === true;
     const liteOnly = pluginOptions["liteOnly"] === true;
+    const importWithFileExtension = pluginOptions["importWithFileExtension"];
+    if (importWithFileExtension && typeof importWithFileExtension !== "string") {
+      throw new Error('The "importWithFileExtension" option must be a string if specified.');
+    }
     await new TsSchemaGenerator().generate(model, {
       outDir,
       lite,
-      liteOnly
+      liteOnly,
+      importWithFileExtension
     });
   }
 };
 var typescript_default = plugin2;
 
 // src/actions/generate.ts
-async function run2(options) {
+async function run4(options) {
   const start = Date.now();
   const schemaFile = getSchemaFile(options.schema);
   const model = await loadSchemaDocument(schemaFile);
   const outputPath = getOutputPath(options, schemaFile);
   await runPlugins(schemaFile, model, outputPath, options);
   if (!options.silent) {
-    console.log(colors2.green(`Generation completed successfully in ${Date.now() - start}ms.
+    console.log(colors4.green(`Generation completed successfully in ${Date.now() - start}ms.
 `));
     console.log(`You can now create a ZenStack client with it.
 
@@ -296,7 +347,7 @@ const client = new ZenStackClient(schema, {
 Check documentation: https://zenstack.dev/docs/3.x`);
   }
 }
-__name(run2, "run");
+__name(run4, "run");
 function getOutputPath(options, schemaFile) {
   if (options.output) {
     return options.output;
@@ -331,9 +382,18 @@ async function runPlugins(schemaFile, model, outputPath, options) {
       }
     }
     if (cliPlugin) {
+      const pluginOptions = getPluginOptions(plugin3);
+      if (provider === "@core/typescript") {
+        if (pluginOptions["lite"] === void 0) {
+          pluginOptions["lite"] = options.lite;
+        }
+        if (pluginOptions["liteOnly"] === void 0) {
+          pluginOptions["liteOnly"] = options.liteOnly;
+        }
+      }
       processedPlugins.push({
         cliPlugin,
-        pluginOptions: getPluginOptions(plugin3)
+        pluginOptions
       });
     }
   }
@@ -400,9 +460,9 @@ function getPluginOptions(plugin3) {
 __name(getPluginOptions, "getPluginOptions");
 
 // src/actions/info.ts
-import colors3 from "colors";
+import colors5 from "colors";
 import path5 from "path";
-async function run3(projectPath) {
+async function run5(projectPath) {
   const packages = await getZenStackPackages(projectPath);
   if (!packages) {
     console.error("Unable to locate package.json. Are you in a valid project directory?");
@@ -414,13 +474,13 @@ async function run3(projectPath) {
     if (version2) {
       versions.add(version2);
     }
-    console.log(`    ${colors3.green(pkg.padEnd(20))}	${version2}`);
+    console.log(`    ${colors5.green(pkg.padEnd(20))}	${version2}`);
   }
   if (versions.size > 1) {
-    console.warn(colors3.yellow("WARNING: Multiple versions of Zenstack packages detected. This may cause issues."));
+    console.warn(colors5.yellow("WARNING: Multiple versions of Zenstack packages detected. This may cause issues."));
   }
 }
-__name(run3, "run");
+__name(run5, "run");
 async function getZenStackPackages(projectPath) {
   let pkgJson;
   const resolvedPath = path5.resolve(projectPath);
@@ -463,8 +523,8 @@ async function getZenStackPackages(projectPath) {
 __name(getZenStackPackages, "getZenStackPackages");
 
 // src/actions/init.ts
-import colors4 from "colors";
-import fs5 from "fs";
+import colors6 from "colors";
+import fs6 from "fs";
 import path6 from "path";
 import ora2 from "ora";
 import { detect, resolveCommand } from "package-manager-detector";
@@ -499,7 +559,7 @@ model Post {
 `;
 
 // src/actions/init.ts
-async function run4(projectPath) {
+async function run6(projectPath) {
   const packages = [
     {
       name: "@zenstackhq/cli@next",
@@ -517,7 +577,7 @@ async function run4(projectPath) {
       name: "npm"
     };
   }
-  console.log(colors4.gray(`Using package manager: ${pm.agent}`));
+  console.log(colors6.gray(`Using package manager: ${pm.agent}`));
   for (const pkg of packages) {
     const resolved = resolveCommand(pm.agent, "install", [
       pkg.name,
@@ -540,24 +600,24 @@ async function run4(projectPath) {
     }
   }
   const generationFolder = "zenstack";
-  if (!fs5.existsSync(path6.join(projectPath, generationFolder))) {
-    fs5.mkdirSync(path6.join(projectPath, generationFolder));
+  if (!fs6.existsSync(path6.join(projectPath, generationFolder))) {
+    fs6.mkdirSync(path6.join(projectPath, generationFolder));
   }
-  if (!fs5.existsSync(path6.join(projectPath, generationFolder, "schema.zmodel"))) {
-    fs5.writeFileSync(path6.join(projectPath, generationFolder, "schema.zmodel"), STARTER_ZMODEL);
+  if (!fs6.existsSync(path6.join(projectPath, generationFolder, "schema.zmodel"))) {
+    fs6.writeFileSync(path6.join(projectPath, generationFolder, "schema.zmodel"), STARTER_ZMODEL);
   } else {
-    console.log(colors4.yellow("Schema file already exists. Skipping generation of sample."));
+    console.log(colors6.yellow("Schema file already exists. Skipping generation of sample."));
   }
-  console.log(colors4.green("ZenStack project initialized successfully!"));
-  console.log(colors4.gray(`See "${generationFolder}/schema.zmodel" for your database schema.`));
-  console.log(colors4.gray("Run `zenstack generate` to compile the the schema into a TypeScript file."));
+  console.log(colors6.green("ZenStack project initialized successfully!"));
+  console.log(colors6.gray(`See "${generationFolder}/schema.zmodel" for your database schema.`));
+  console.log(colors6.gray("Run `zenstack generate` to compile the the schema into a TypeScript file."));
 }
-__name(run4, "run");
+__name(run6, "run");
 
 // src/actions/migrate.ts
-import fs6 from "fs";
+import fs7 from "fs";
 import path7 from "path";
-async function run5(command, options) {
+async function run7(command, options) {
   const schemaFile = getSchemaFile(options.schema);
   const prismaSchemaDir = options.migrations ? path7.dirname(options.migrations) : void 0;
   const prismaSchemaFile = await generateTempPrismaSchema(schemaFile, prismaSchemaDir);
@@ -580,12 +640,12 @@ async function run5(command, options) {
         break;
     }
   } finally {
-    if (fs6.existsSync(prismaSchemaFile)) {
-      fs6.unlinkSync(prismaSchemaFile);
+    if (fs7.existsSync(prismaSchemaFile)) {
+      fs7.unlinkSync(prismaSchemaFile);
     }
   }
 }
-__name(run5, "run");
+__name(run7, "run");
 function runDev(prismaSchemaFile, options) {
   try {
     const cmd = [
@@ -661,24 +721,10 @@ function handleSubProcessError2(err) {
 }
 __name(handleSubProcessError2, "handleSubProcessError");
 
-// src/actions/check.ts
-import colors5 from "colors";
-async function run6(options) {
-  const schemaFile = getSchemaFile(options.schema);
-  try {
-    await loadSchemaDocument(schemaFile);
-    console.log(colors5.green("\u2713 Schema validation completed successfully."));
-  } catch (error) {
-    console.error(colors5.red("\u2717 Schema validation failed."));
-    throw error;
-  }
-}
-__name(run6, "run");
-
 // src/telemetry.ts
 import { init } from "mixpanel";
 import { randomUUID as randomUUID2 } from "crypto";
-import fs11 from "fs";
+import fs12 from "fs";
 import * as os2 from "os";
 
 // src/constants.ts
@@ -689,14 +735,14 @@ import { env } from "process";
 var isInCi = env["CI"] !== "0" && env["CI"] !== "false" && ("CI" in env || "CONTINUOUS_INTEGRATION" in env || Object.keys(env).some((key) => key.startsWith("CI_")));
 
 // src/utils/is-container.ts
-import fs8 from "fs";
+import fs9 from "fs";
 
 // src/utils/is-docker.ts
-import fs7 from "fs";
+import fs8 from "fs";
 var isDockerCached;
 function hasDockerEnv() {
   try {
-    fs7.statSync("/.dockerenv");
+    fs8.statSync("/.dockerenv");
     return true;
   } catch {
     return false;
@@ -705,7 +751,7 @@ function hasDockerEnv() {
 __name(hasDockerEnv, "hasDockerEnv");
 function hasDockerCGroup() {
   try {
-    return fs7.readFileSync("/proc/self/cgroup", "utf8").includes("docker");
+    return fs8.readFileSync("/proc/self/cgroup", "utf8").includes("docker");
   } catch {
     return false;
   }
@@ -723,7 +769,7 @@ __name(isDocker, "isDocker");
 var cachedResult;
 var hasContainerEnv = /* @__PURE__ */ __name(() => {
   try {
-    fs8.statSync("/run/.containerenv");
+    fs9.statSync("/run/.containerenv");
     return true;
   } catch {
     return false;
@@ -740,7 +786,7 @@ __name(isInContainer, "isInContainer");
 // src/utils/is-wsl.ts
 import process2 from "process";
 import os from "os";
-import fs9 from "fs";
+import fs10 from "fs";
 var isWsl = /* @__PURE__ */ __name(() => {
   if (process2.platform !== "linux") {
     return false;
@@ -749,7 +795,7 @@ var isWsl = /* @__PURE__ */ __name(() => {
     return true;
   }
   try {
-    return fs9.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft");
+    return fs10.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft");
   } catch {
     return false;
   }
@@ -813,8 +859,8 @@ function getMachineId() {
 __name(getMachineId, "getMachineId");
 
 // src/utils/version-utils.ts
-import colors6 from "colors";
-import fs10 from "fs";
+import colors7 from "colors";
+import fs11 from "fs";
 import path8 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import semver from "semver";
@@ -823,7 +869,7 @@ var VERSION_CHECK_TAG = "next";
 function getVersion() {
   try {
     const _dirname = typeof __dirname !== "undefined" ? __dirname : path8.dirname(fileURLToPath2(import.meta.url));
-    return JSON.parse(fs10.readFileSync(path8.join(_dirname, "../package.json"), "utf8")).version;
+    return JSON.parse(fs11.readFileSync(path8.join(_dirname, "../package.json"), "utf8")).version;
   } catch {
     return void 0;
   }
@@ -838,7 +884,7 @@ async function checkNewVersion() {
     return;
   }
   if (latestVersion && currVersion && semver.gt(latestVersion, currVersion)) {
-    console.log(`A newer version ${colors6.cyan(latestVersion)} is available.`);
+    console.log(`A newer version ${colors7.cyan(latestVersion)} is available.`);
   }
 }
 __name(checkNewVersion, "checkNewVersion");
@@ -953,7 +999,7 @@ var Telemetry = class {
     try {
       const packageJsonPath = import.meta.resolve("prisma/package.json");
       const packageJsonUrl = new URL(packageJsonPath);
-      const packageJson = JSON.parse(fs11.readFileSync(packageJsonUrl, "utf8"));
+      const packageJson = JSON.parse(fs12.readFileSync(packageJsonUrl, "utf8"));
       return packageJson.version;
     } catch {
       return void 0;
@@ -964,45 +1010,49 @@ var telemetry = new Telemetry();
 
 // src/index.ts
 var generateAction = /* @__PURE__ */ __name(async (options) => {
-  await telemetry.trackCommand("generate", () => run2(options));
+  await telemetry.trackCommand("generate", () => run4(options));
 }, "generateAction");
 var migrateAction = /* @__PURE__ */ __name(async (subCommand, options) => {
-  await telemetry.trackCommand(`migrate ${subCommand}`, () => run5(subCommand, options));
+  await telemetry.trackCommand(`migrate ${subCommand}`, () => run7(subCommand, options));
 }, "migrateAction");
 var dbAction = /* @__PURE__ */ __name(async (subCommand, options) => {
-  await telemetry.trackCommand(`db ${subCommand}`, () => run(subCommand, options));
+  await telemetry.trackCommand(`db ${subCommand}`, () => run2(subCommand, options));
 }, "dbAction");
 var infoAction = /* @__PURE__ */ __name(async (projectPath) => {
-  await telemetry.trackCommand("info", () => run3(projectPath));
+  await telemetry.trackCommand("info", () => run5(projectPath));
 }, "infoAction");
 var initAction = /* @__PURE__ */ __name(async (projectPath) => {
-  await telemetry.trackCommand("init", () => run4(projectPath));
+  await telemetry.trackCommand("init", () => run6(projectPath));
 }, "initAction");
 var checkAction = /* @__PURE__ */ __name(async (options) => {
-  await telemetry.trackCommand("check", () => run6(options));
+  await telemetry.trackCommand("check", () => run(options));
 }, "checkAction");
+var formatAction = /* @__PURE__ */ __name(async (options) => {
+  await telemetry.trackCommand("format", () => run3(options));
+}, "formatAction");
 function createProgram() {
-  const program = new Command("zen");
-  program.version(getVersion(), "-v --version", "display CLI version");
+  const program = new Command("zen").alias("zenstack").helpOption("-h, --help", "Show this help message").version(getVersion(), "-v --version", "Show CLI version");
   const schemaExtensions = ZModelLanguageMetaData.fileExtensions.join(", ");
-  program.description(`${colors7.bold.blue("\u03B6")} ZenStack is the data layer for modern TypeScript apps.
+  program.description(`${colors8.bold.blue("\u03B6")} ZenStack is the data layer for modern TypeScript apps.
 
 Documentation: https://zenstack.dev/docs/3.x`).showHelpAfterError().showSuggestionAfterError();
   const schemaOption = new Option("--schema <file>", `schema file (with extension ${schemaExtensions}). Defaults to "zenstack/schema.zmodel" unless specified in package.json.`);
   const noVersionCheckOption = new Option("--no-version-check", "do not check for new version");
-  program.command("generate").description("Run code generation plugins.").addOption(schemaOption).addOption(noVersionCheckOption).addOption(new Option("-o, --output <path>", "default output directory for code generation")).addOption(new Option("--lite", "also generate a lite version of schema without attributes").default(false)).addOption(new Option("--lite-only", "only generate lite version of schema without attributes").default(false)).addOption(new Option("--silent", "suppress all output except errors").default(false)).action(generateAction);
+  program.command("generate").description("Run code generation plugins").addOption(schemaOption).addOption(noVersionCheckOption).addOption(new Option("-o, --output <path>", "default output directory for code generation")).addOption(new Option("--lite", "also generate a lite version of schema without attributes").default(false)).addOption(new Option("--lite-only", "only generate lite version of schema without attributes").default(false)).addOption(new Option("--silent", "suppress all output except errors").default(false)).action(generateAction);
   const migrateCommand = program.command("migrate").description("Run database schema migration related tasks.");
   const migrationsOption = new Option("--migrations <path>", 'path that contains the "migrations" directory');
-  migrateCommand.command("dev").addOption(schemaOption).addOption(noVersionCheckOption).addOption(new Option("-n, --name <name>", "migration name")).addOption(new Option("--create-only", "only create migration, do not apply")).addOption(migrationsOption).description("Create a migration from changes in schema and apply it to the database.").action((options) => migrateAction("dev", options));
-  migrateCommand.command("reset").addOption(schemaOption).addOption(new Option("--force", "skip the confirmation prompt")).addOption(migrationsOption).addOption(noVersionCheckOption).description("Reset your database and apply all migrations, all data will be lost.").action((options) => migrateAction("reset", options));
-  migrateCommand.command("deploy").addOption(schemaOption).addOption(noVersionCheckOption).addOption(migrationsOption).description("Deploy your pending migrations to your production/staging database.").action((options) => migrateAction("deploy", options));
-  migrateCommand.command("status").addOption(schemaOption).addOption(noVersionCheckOption).addOption(migrationsOption).description("Check the status of your database migrations.").action((options) => migrateAction("status", options));
-  migrateCommand.command("resolve").addOption(schemaOption).addOption(noVersionCheckOption).addOption(migrationsOption).addOption(new Option("--applied <migration>", "record a specific migration as applied")).addOption(new Option("--rolled-back <migration>", "record a specific migration as rolled back")).description("Resolve issues with database migrations in deployment databases.").action((options) => migrateAction("resolve", options));
-  const dbCommand = program.command("db").description("Manage your database schema during development.");
-  dbCommand.command("push").description("Push the state from your schema to your database.").addOption(schemaOption).addOption(noVersionCheckOption).addOption(new Option("--accept-data-loss", "ignore data loss warnings")).addOption(new Option("--force-reset", "force a reset of the database before push")).action((options) => dbAction("push", options));
-  program.command("info").description("Get information of installed ZenStack packages.").argument("[path]", "project path", ".").addOption(noVersionCheckOption).action(infoAction);
-  program.command("init").description("Initialize an existing project for ZenStack.").argument("[path]", "project path", ".").addOption(noVersionCheckOption).action(initAction);
-  program.command("check").description("Check a ZModel schema for syntax or semantic errors.").addOption(schemaOption).addOption(noVersionCheckOption).action(checkAction);
+  migrateCommand.command("dev").addOption(schemaOption).addOption(noVersionCheckOption).addOption(new Option("-n, --name <name>", "migration name")).addOption(new Option("--create-only", "only create migration, do not apply")).addOption(migrationsOption).description("Create a migration from changes in schema and apply it to the database").action((options) => migrateAction("dev", options));
+  migrateCommand.command("reset").addOption(schemaOption).addOption(new Option("--force", "skip the confirmation prompt")).addOption(migrationsOption).addOption(noVersionCheckOption).description("Reset your database and apply all migrations, all data will be lost").action((options) => migrateAction("reset", options));
+  migrateCommand.command("deploy").addOption(schemaOption).addOption(noVersionCheckOption).addOption(migrationsOption).description("Deploy your pending migrations to your production/staging database").action((options) => migrateAction("deploy", options));
+  migrateCommand.command("status").addOption(schemaOption).addOption(noVersionCheckOption).addOption(migrationsOption).description("Check the status of your database migrations").action((options) => migrateAction("status", options));
+  migrateCommand.command("resolve").addOption(schemaOption).addOption(noVersionCheckOption).addOption(migrationsOption).addOption(new Option("--applied <migration>", "record a specific migration as applied")).addOption(new Option("--rolled-back <migration>", "record a specific migration as rolled back")).description("Resolve issues with database migrations in deployment databases").action((options) => migrateAction("resolve", options));
+  const dbCommand = program.command("db").description("Manage your database schema during development");
+  dbCommand.command("push").description("Push the state from your schema to your database").addOption(schemaOption).addOption(noVersionCheckOption).addOption(new Option("--accept-data-loss", "ignore data loss warnings")).addOption(new Option("--force-reset", "force a reset of the database before push")).action((options) => dbAction("push", options));
+  program.command("info").description("Get information of installed ZenStack packages").argument("[path]", "project path", ".").addOption(noVersionCheckOption).action(infoAction);
+  program.command("init").description("Initialize an existing project for ZenStack").argument("[path]", "project path", ".").addOption(noVersionCheckOption).action(initAction);
+  program.command("check").description("Check a ZModel schema for syntax or semantic errors").addOption(schemaOption).addOption(noVersionCheckOption).action(checkAction);
+  program.command("format").description("Format a ZModel schema file").addOption(schemaOption).addOption(noVersionCheckOption).action(formatAction);
+  program.addHelpCommand("help [command]", "Display help for a command");
   program.hook("preAction", async (_thisCommand, actionCommand) => {
     if (actionCommand.getOptionValue("versionCheck") !== false) {
       await checkNewVersion();
@@ -1023,10 +1073,10 @@ async function main() {
     if (e instanceof CommanderError) {
       exitCode = e.exitCode;
     } else if (e instanceof CliError) {
-      console.error(colors7.red(e.message));
+      console.error(colors8.red(e.message));
       exitCode = 1;
     } else {
-      console.error(colors7.red(`Unhandled error: ${e}`));
+      console.error(colors8.red(`Unhandled error: ${e}`));
       exitCode = 1;
     }
   }