@actuate-media/cli 0.4.0 → 0.4.2

package/src/commands/db-status.ts

@@ -1,120 +1,122 @@
-import { Command } from "commander";
-import { execSync } from "node:child_process";
-import { readFile, access } from "node:fs/promises";
-import { resolve } from "node:path";
-import ora from "ora";
-import chalk from "chalk";
-import { logger } from "../utils/logger.js";
-import { REQUIRED_CMS_MODELS } from "../deployment/diagnostics.js";
+import { Command } from 'commander'
+import { execSync } from 'node:child_process'
+import { readFile, access } from 'node:fs/promises'
+import { resolve } from 'node:path'
+import ora from 'ora'
+import chalk from 'chalk'
+import { logger } from '../utils/logger.js'
+import { REQUIRED_CMS_MODELS } from '../deployment/diagnostics.js'
 
-const CMS_SCHEMA_MARKER = "// ── Actuate CMS models";
+const CMS_SCHEMA_MARKER = '// ── Actuate CMS models'
 
 async function fileExists(filePath: string): Promise<boolean> {
   try {
-    await access(filePath);
-    return true;
+    await access(filePath)
+    return true
   } catch {
-    return false;
+    return false
   }
 }
 
 export function registerDbStatusCommand(program: Command): void {
   program
-    .command("db:status")
-    .description("Check which Actuate CMS models are present in your Prisma schema")
-    .option("--schema <path>", "Path to schema.prisma", "prisma/schema.prisma")
+    .command('db:status')
+    .description('Check which Actuate CMS models are present in your Prisma schema')
+    .option('--schema <path>', 'Path to schema.prisma', 'prisma/schema.prisma')
     .action(async (opts: { schema: string }) => {
-      const schemaPath = resolve(process.cwd(), opts.schema);
+      const schemaPath = resolve(process.cwd(), opts.schema)
 
       if (!(await fileExists(schemaPath))) {
-        logger.error(`Schema file not found at ${schemaPath}`);
-        logger.info("Run `npx prisma init` first, or specify --schema <path>.");
-        process.exitCode = 1;
-        return;
+        logger.error(`Schema file not found at ${schemaPath}`)
+        logger.info('Run `npx prisma init` first, or specify --schema <path>.')
+        process.exitCode = 1
+        return
       }
 
-      const spinner = ora("Checking schema...").start();
+      const spinner = ora('Checking schema...').start()
 
-      let content: string;
+      let content: string
       try {
-        content = await readFile(schemaPath, "utf-8");
+        content = await readFile(schemaPath, 'utf-8')
       } catch (err) {
-        spinner.fail("Failed to read schema file.");
-        logger.error(err instanceof Error ? err.message : String(err));
-        process.exitCode = 1;
-        return;
+        spinner.fail('Failed to read schema file.')
+        logger.error(err instanceof Error ? err.message : String(err))
+        process.exitCode = 1
+        return
       }
 
-      spinner.stop();
+      spinner.stop()
 
-      const hasMarker = content.includes(CMS_SCHEMA_MARKER);
-      const modelRegex = /^model\s+(\w+)\s*\{/gm;
-      const schemaModels = new Set<string>();
-      let match;
+      const hasMarker = content.includes(CMS_SCHEMA_MARKER)
+      const modelRegex = /^model\s+(\w+)\s*\{/gm
+      const schemaModels = new Set<string>()
+      let match
       while ((match = modelRegex.exec(content)) !== null) {
-        schemaModels.add(match[1]!);
+        schemaModels.add(match[1]!)
       }
 
-      console.log();
-      console.log(chalk.bold("  Actuate CMS Model Status"));
-      console.log(chalk.dim("  ─────────────────────────────────"));
-      console.log();
+      console.log()
+      console.log(chalk.bold('  Actuate CMS Model Status'))
+      console.log(chalk.dim('  ─────────────────────────────────'))
+      console.log()
 
-      let present = 0;
-      let missing = 0;
+      let present = 0
+      let missing = 0
 
       for (const model of REQUIRED_CMS_MODELS) {
         if (schemaModels.has(model)) {
-          console.log(`  ${chalk.green("✓")} ${model}`);
-          present++;
+          console.log(`  ${chalk.green('✓')} ${model}`)
+          present++
         } else {
-          console.log(`  ${chalk.red("✗")} ${model} ${chalk.dim("— missing")}`);
-          missing++;
+          console.log(`  ${chalk.red('✗')} ${model} ${chalk.dim('— missing')}`)
+          missing++
         }
       }
 
-      console.log();
-      console.log(chalk.dim("  ─────────────────────────────────"));
-      console.log(`  ${chalk.green(present)} present, ${missing > 0 ? chalk.red(missing) : chalk.green(missing)} missing`);
+      console.log()
+      console.log(chalk.dim('  ─────────────────────────────────'))
+      console.log(
+        `  ${chalk.green(present)} present, ${missing > 0 ? chalk.red(missing) : chalk.green(missing)} missing`,
+      )
 
       if (!hasMarker) {
-        console.log();
-        logger.warn("CMS schema marker not found. Models may have been added manually.");
-        logger.info("Run `actuate db:init` to add CMS models with proper markers.");
+        console.log()
+        logger.warn('CMS schema marker not found. Models may have been added manually.')
+        logger.info('Run `actuate db:init` to add CMS models with proper markers.')
       }
 
       if (missing > 0) {
-        console.log();
-        logger.info("Run `actuate db:init` to add missing models.");
+        console.log()
+        logger.info('Run `actuate db:init` to add missing models.')
       }
 
-      let dbConnected = false;
+      let dbConnected = false
       try {
-        spinner.start("Checking database connection...");
-        execSync("npx prisma db execute --stdin --schema " + JSON.stringify(schemaPath), {
-          input: "SELECT 1;",
-          stdio: ["pipe", "pipe", "pipe"],
+        spinner.start('Checking database connection...')
+        execSync('npx prisma db execute --stdin --schema ' + JSON.stringify(schemaPath), {
+          input: 'SELECT 1;',
+          stdio: ['pipe', 'pipe', 'pipe'],
           cwd: process.cwd(),
-        });
-        spinner.succeed("Database connection OK.");
-        dbConnected = true;
+        })
+        spinner.succeed('Database connection OK.')
+        dbConnected = true
       } catch {
-        spinner.warn("Could not connect to database. Check DATABASE_URL.");
+        spinner.warn('Could not connect to database. Check DATABASE_URL.')
       }
 
       if (dbConnected && missing === 0) {
         try {
-          spinner.start("Checking migration status...");
-          spinner.stop();
-          execSync("npx prisma migrate status", {
-            stdio: "inherit",
+          spinner.start('Checking migration status...')
+          spinner.stop()
+          execSync('npx prisma migrate status', {
+            stdio: 'inherit',
             cwd: process.cwd(),
-          });
+          })
         } catch {
-          logger.warn("Could not check migration status.");
+          logger.warn('Could not check migration status.')
         }
       }
 
-      console.log();
-    });
+      console.log()
+    })
 }

package/src/commands/doctor.ts

@@ -1,159 +1,183 @@
-import { Command } from "commander";
-import { access, readdir, readFile } from "node:fs/promises";
-import { resolve } from "node:path";
-import chalk from "chalk";
+import { Command } from 'commander'
+import { access, readdir, readFile } from 'node:fs/promises'
+import { resolve } from 'node:path'
+import chalk from 'chalk'
 import {
   buildDeploymentManifest,
   createDiagnosticReport,
   detectPackageManager,
   type DiagnosticReport,
-} from "../deployment/diagnostics.js";
+} from '../deployment/diagnostics.js'
 
 async function fileExists(path: string): Promise<boolean> {
   try {
-    await access(path);
-    return true;
+    await access(path)
+    return true
   } catch {
-    return false;
+    return false
   }
 }
 
 async function readSchemaModels(schemaPath: string): Promise<Set<string>> {
-  if (!(await fileExists(schemaPath))) return new Set();
-  const schema = await readFile(schemaPath, "utf-8");
-  const models = new Set<string>();
-  const modelRegex = /^model\s+(\w+)\s*\{/gm;
-  let match;
+  if (!(await fileExists(schemaPath))) return new Set()
+  const schema = await readFile(schemaPath, 'utf-8')
+  const models = new Set<string>()
+  const modelRegex = /^model\s+(\w+)\s*\{/gm
+  let match
   while ((match = modelRegex.exec(schema)) !== null) {
-    models.add(match[1]!);
+    models.add(match[1]!)
   }
-  return models;
+  return models
 }
 
 async function readSchemaContent(schemaPath: string): Promise<string> {
-  if (!(await fileExists(schemaPath))) return "";
-  return readFile(schemaPath, "utf-8");
+  if (!(await fileExists(schemaPath))) return ''
+  return readFile(schemaPath, 'utf-8')
+}
+
+async function readOptionalFile(path: string): Promise<string> {
+  if (!(await fileExists(path))) return ''
+  return readFile(path, 'utf-8')
 }
 
 async function detectProjectPackageManager(): Promise<string> {
-  const entries = new Set(await readdir(process.cwd()));
-  return detectPackageManager(entries);
+  const entries = new Set(await readdir(process.cwd()))
+  return detectPackageManager(entries)
 }
 
 function printReport(title: string, report: DiagnosticReport): void {
-  console.log();
-  console.log(chalk.bold(title));
-  console.log(chalk.dim("─────────────────────────────────"));
+  console.log()
+  console.log(chalk.bold(title))
+  console.log(chalk.dim('─────────────────────────────────'))
   for (const check of report.checks) {
-    const icon = check.status === "pass" ? chalk.green("PASS") : check.status === "warn" ? chalk.yellow("WARN") : chalk.red("FAIL");
-    console.log(`${icon} ${check.label}: ${check.message}`);
-    if (check.fix) console.log(chalk.dim(`  Fix: ${check.fix}`));
-    if (check.docs) console.log(chalk.dim(`  Docs: ${check.docs}`));
+    const icon =
+      check.status === 'pass'
+        ? chalk.green('PASS')
+        : check.status === 'warn'
+          ? chalk.yellow('WARN')
+          : chalk.red('FAIL')
+    console.log(`${icon} ${check.label}: ${check.message}`)
+    if (check.fix) console.log(chalk.dim(`  Fix: ${check.fix}`))
+    if (check.docs) console.log(chalk.dim(`  Docs: ${check.docs}`))
   }
-  console.log(chalk.dim("─────────────────────────────────"));
-  console.log(`Status: ${report.status.toUpperCase()}`);
-  console.log();
+  console.log(chalk.dim('─────────────────────────────────'))
+  console.log(`Status: ${report.status.toUpperCase()}`)
+  console.log()
 }
 
-async function buildReport(schemaPath: string, mode: "doctor" | "deploy" = "doctor") {
-  const resolvedSchema = resolve(process.cwd(), schemaPath);
-  const [schemaModels, schemaContent, packageManager] = await Promise.all([
+async function buildReport(
+  schemaPath: string,
+  configPath: string,
+  mode: 'doctor' | 'deploy' = 'doctor',
+) {
+  const resolvedSchema = resolve(process.cwd(), schemaPath)
+  const resolvedConfig = resolve(process.cwd(), configPath)
+  const [schemaModels, schemaContent, configContent, packageManager] = await Promise.all([
     readSchemaModels(resolvedSchema),
     readSchemaContent(resolvedSchema),
+    readOptionalFile(resolvedConfig),
     detectProjectPackageManager(),
-  ]);
+  ])
 
   return createDiagnosticReport({
     schemaModels,
     schemaContent,
+    configContent,
     env: process.env,
     packageManager,
     schemaPath,
     mode,
-  });
+  })
 }
 
 export function registerDoctorCommand(program: Command): void {
   program
-    .command("doctor")
-    .description("Run AI-friendly preflight checks for an Actuate CMS project")
-    .option("--schema <path>", "Path to schema.prisma", "prisma/schema.prisma")
-    .option("--json", "Print machine-readable JSON")
-    .action(async (opts: { schema: string; json?: boolean }) => {
-      const report = await buildReport(opts.schema, "doctor");
+    .command('doctor')
+    .description('Run AI-friendly preflight checks for an Actuate CMS project')
+    .option('--schema <path>', 'Path to schema.prisma', 'prisma/schema.prisma')
+    .option('--config <path>', 'Path to actuate.config.ts', 'actuate.config.ts')
+    .option('--json', 'Print machine-readable JSON')
+    .action(async (opts: { schema: string; config: string; json?: boolean }) => {
+      const report = await buildReport(opts.schema, opts.config, 'doctor')
       if (opts.json) {
-        console.log(JSON.stringify(report, null, 2));
+        console.log(JSON.stringify(report, null, 2))
       } else {
-        printReport("Actuate Doctor", report);
+        printReport('Actuate Doctor', report)
       }
-      if (report.status === "fail") process.exitCode = 1;
-    });
+      if (report.status === 'fail') process.exitCode = 1
+    })
 }
 
 export function registerDeployCheckCommand(program: Command): void {
   program
-    .command("deploy:check")
-    .description("Check production deployment readiness for Actuate CMS")
-    .option("--schema <path>", "Path to schema.prisma", "prisma/schema.prisma")
-    .option("--json", "Print machine-readable JSON")
-    .action(async (opts: { schema: string; json?: boolean }) => {
-      const report = await buildReport(opts.schema, "deploy");
+    .command('deploy:check')
+    .description('Check production deployment readiness for Actuate CMS')
+    .option('--schema <path>', 'Path to schema.prisma', 'prisma/schema.prisma')
+    .option('--config <path>', 'Path to actuate.config.ts', 'actuate.config.ts')
+    .option('--json', 'Print machine-readable JSON')
+    .action(async (opts: { schema: string; config: string; json?: boolean }) => {
+      const report = await buildReport(opts.schema, opts.config, 'deploy')
       if (opts.json) {
-        console.log(JSON.stringify({ ...report, manifest: buildDeploymentManifest() }, null, 2));
+        console.log(JSON.stringify({ ...report, manifest: buildDeploymentManifest() }, null, 2))
       } else {
-        printReport("Actuate Deploy Check", report);
-        console.log(chalk.dim("Run `actuate verify --full` after deployment succeeds."));
+        printReport('Actuate Deploy Check', report)
+        console.log(chalk.dim('Run `actuate verify --full` after deployment succeeds.'))
       }
-      if (report.status === "fail") process.exitCode = 1;
-    });
+      if (report.status === 'fail') process.exitCode = 1
+    })
 }
 
 export function registerVerifyCommand(program: Command): void {
   program
-    .command("verify")
-    .description("Verify an installed or deployed Actuate CMS project")
-    .option("--full", "Run the full verification checklist")
-    .option("--url <origin>", "Deployed site origin to verify, for example https://example.com")
-    .option("--json", "Print the deployment manifest as JSON")
+    .command('verify')
+    .description('Verify an installed or deployed Actuate CMS project')
+    .option('--full', 'Run the full verification checklist')
+    .option('--url <origin>', 'Deployed site origin to verify, for example https://example.com')
+    .option('--json', 'Print the deployment manifest as JSON')
     .action(async (opts: { full?: boolean; url?: string; json?: boolean }) => {
-      const manifest = buildDeploymentManifest();
+      const manifest = buildDeploymentManifest()
       if (opts.json) {
-        console.log(JSON.stringify(manifest, null, 2));
-        return;
+        console.log(JSON.stringify(manifest, null, 2))
+        return
       }
 
-      console.log();
-      console.log(chalk.bold(opts.full ? "Actuate Full Verification" : "Actuate Verification"));
-      console.log(chalk.dim("─────────────────────────────────"));
-      console.log(`PASS Manifest generated for ${manifest.packageScope} packages.`);
+      console.log()
+      console.log(chalk.bold(opts.full ? 'Actuate Full Verification' : 'Actuate Verification'))
+      console.log(chalk.dim('─────────────────────────────────'))
+      console.log(`PASS Manifest generated for ${manifest.packageScope} packages.`)
       if (!opts.url) {
-        console.log("WARN No --url provided, so remote health/admin endpoints were not checked.");
-        console.log(chalk.dim("Run `actuate verify --full --url https://your-site.com` after deployment."));
-        console.log();
-        return;
+        console.log('WARN No --url provided, so remote health/admin endpoints were not checked.')
+        console.log(
+          chalk.dim('Run `actuate verify --full --url https://your-site.com` after deployment.'),
+        )
+        console.log()
+        return
       }
 
-      const origin = opts.url.replace(/\/$/, "");
-      const healthUrl = `${origin}${manifest.routes.apiHealth}`;
-      const adminUrl = `${origin}${manifest.routes.adminDefault}`;
-      let failed = false;
+      const origin = opts.url.replace(/\/$/, '')
+      const healthUrl = `${origin}${manifest.routes.apiHealth}`
+      const adminUrl = `${origin}${manifest.routes.adminDefault}`
+      let failed = false
 
-      for (const [label, url] of [['Health', healthUrl], ['Admin', adminUrl]] as const) {
+      for (const [label, url] of [
+        ['Health', healthUrl],
+        ['Admin', adminUrl],
+      ] as const) {
         try {
-          const response = await fetch(url, { method: 'GET' });
+          const response = await fetch(url, { method: 'GET' })
           if (response.ok || response.status === 302 || response.status === 401) {
-            console.log(`PASS ${label} route responded at ${url}.`);
+            console.log(`PASS ${label} route responded at ${url}.`)
           } else {
-            failed = true;
-            console.log(`FAIL ${label} route returned HTTP ${response.status} at ${url}.`);
+            failed = true
+            console.log(`FAIL ${label} route returned HTTP ${response.status} at ${url}.`)
           }
         } catch (error) {
-          failed = true;
-          const message = error instanceof Error ? error.message : String(error);
-          console.log(`FAIL ${label} route could not be reached at ${url}: ${message}`);
+          failed = true
+          const message = error instanceof Error ? error.message : String(error)
+          console.log(`FAIL ${label} route could not be reached at ${url}: ${message}`)
         }
       }
-      console.log();
-      if (failed) process.exitCode = 1;
-    });
+      console.log()
+      if (failed) process.exitCode = 1
+    })
 }