@actuate-media/cli 0.4.0 → 0.4.2

package/src/deployment/diagnostics.ts

@@ -1,17 +1,17 @@
-export type DiagnosticStatus = 'pass' | 'warn' | 'fail';
+export type DiagnosticStatus = 'pass' | 'warn' | 'fail'
 
 export interface DiagnosticCheck {
-  id: string;
-  label: string;
-  status: DiagnosticStatus;
-  message: string;
-  fix?: string;
-  docs?: string;
+  id: string
+  label: string
+  status: DiagnosticStatus
+  message: string
+  fix?: string
+  docs?: string
 }
 
 export interface DiagnosticReport {
-  status: DiagnosticStatus;
-  checks: DiagnosticCheck[];
+  status: DiagnosticStatus
+  checks: DiagnosticCheck[]
 }
 
 export const REQUIRED_CMS_MODELS = [
@@ -29,100 +29,127 @@ export const REQUIRED_CMS_MODELS = [
   'ScriptTag',
   'PageTemplate',
   'SavedSection',
-] as const;
+] as const
 
 export const REQUIRED_ENV_VARS = [
   'DATABASE_URL',
   'CMS_SECRET',
   'CMS_ENCRYPTION_KEY',
   'NEXT_PUBLIC_SITE_URL',
-] as const;
+] as const
 
 export interface DiagnosticInput {
-  schemaModels: Set<string>;
-  schemaContent?: string;
-  env: Record<string, string | undefined>;
-  packageManager: string;
-  schemaPath: string;
-  mode?: 'doctor' | 'deploy';
+  schemaModels: Set<string>
+  schemaContent?: string
+  configContent?: string
+  env: Record<string, string | undefined>
+  packageManager: string
+  schemaPath: string
+  mode?: 'doctor' | 'deploy'
 }
 
 export function missingModels(schemaModels: Set<string>): string[] {
-  return REQUIRED_CMS_MODELS.filter((model) => !schemaModels.has(model));
+  return REQUIRED_CMS_MODELS.filter((model) => !schemaModels.has(model))
 }
 
 export function missingEnvVars(env: Record<string, string | undefined>): string[] {
-  return REQUIRED_ENV_VARS.filter((name) => !env[name]);
+  return REQUIRED_ENV_VARS.filter((name) => !env[name])
 }
 
 export function detectPackageManager(lockfiles: Set<string>): string {
-  if (lockfiles.has('pnpm-lock.yaml')) return 'pnpm';
-  if (lockfiles.has('yarn.lock')) return 'yarn';
-  if (lockfiles.has('package-lock.json')) return 'npm';
-  return 'npm';
+  if (lockfiles.has('pnpm-lock.yaml')) return 'pnpm'
+  if (lockfiles.has('yarn.lock')) return 'yarn'
+  if (lockfiles.has('package-lock.json')) return 'npm'
+  return 'npm'
 }
 
 export function createDiagnosticReport(input: DiagnosticInput): DiagnosticReport {
-  const checks: DiagnosticCheck[] = [];
-  const models = missingModels(input.schemaModels);
-  const envVars = input.mode === 'deploy'
-    ? [...missingEnvVars(input.env), ...(!input.env.DIRECT_DATABASE_URL ? ['DIRECT_DATABASE_URL'] : [])]
-    : missingEnvVars(input.env);
-  const fieldProblems = input.schemaContent ? missingCriticalFields(input.schemaContent) : [];
+  const checks: DiagnosticCheck[] = []
+  const models = missingModels(input.schemaModels)
+  const envVars =
+    input.mode === 'deploy'
+      ? [
+          ...missingEnvVars(input.env),
+          ...(!input.env.DIRECT_DATABASE_URL ? ['DIRECT_DATABASE_URL'] : []),
+        ]
+      : missingEnvVars(input.env)
+  const fieldProblems = input.schemaContent ? missingCriticalFields(input.schemaContent) : []
+  const pageBuilderRisk = input.configContent
+    ? detectsFlatMarketingPageModel(input.configContent)
+    : false
 
   checks.push({
     id: 'schema-models',
     label: 'Prisma schema models',
     status: models.length === 0 ? 'pass' : 'fail',
-    message: models.length === 0
-      ? 'All deploy-critical Actuate models are present.'
-      : `Missing deploy-critical Actuate models: ${models.join(', ')}.`,
-    fix: models.length === 0
-      ? undefined
-      : `Run \`actuate db:init --schema ${input.schemaPath}\` for new schemas, or update the existing Actuate block from the database setup docs, then create and apply a Prisma migration.`,
+    message:
+      models.length === 0
+        ? 'All deploy-critical Actuate models are present.'
+        : `Missing deploy-critical Actuate models: ${models.join(', ')}.`,
+    fix:
+      models.length === 0
+        ? undefined
+        : `Run \`actuate db:init --schema ${input.schemaPath}\` for new schemas, or update the existing Actuate block from the database setup docs, then create and apply a Prisma migration.`,
     docs: 'https://actuatecms.dev/docs/database-setup',
-  });
+  })
 
   checks.push({
     id: 'schema-fields',
     label: 'Prisma schema fields',
     status: fieldProblems.length === 0 ? 'pass' : 'fail',
-    message: fieldProblems.length === 0
-      ? 'Deploy-critical model fields are present.'
-      : `Missing deploy-critical model fields: ${fieldProblems.join(', ')}.`,
-    fix: fieldProblems.length === 0
-      ? undefined
-      : 'Update the Actuate Prisma models from the database setup docs, then create and apply a Prisma migration.',
+    message:
+      fieldProblems.length === 0
+        ? 'Deploy-critical model fields are present.'
+        : `Missing deploy-critical model fields: ${fieldProblems.join(', ')}.`,
+    fix:
+      fieldProblems.length === 0
+        ? undefined
+        : 'Update the Actuate Prisma models from the database setup docs, then create and apply a Prisma migration.',
     docs: 'https://actuatecms.dev/docs/database-setup',
-  });
+  })
 
   checks.push({
     id: 'environment',
     label: 'Required environment variables',
     status: envVars.length === 0 ? 'pass' : 'fail',
-    message: envVars.length === 0
-      ? 'Required deployment environment variables are set.'
-      : `Missing required environment variables: ${envVars.join(', ')}.`,
-    fix: envVars.length === 0
-      ? undefined
-      : `Set missing environment variables before deploying: ${envVars.join(', ')}.`,
+    message:
+      envVars.length === 0
+        ? 'Required deployment environment variables are set.'
+        : `Missing required environment variables: ${envVars.join(', ')}.`,
+    fix:
+      envVars.length === 0
+        ? undefined
+        : `Set missing environment variables before deploying: ${envVars.join(', ')}.`,
     docs: 'https://actuatecms.dev/docs/environment-variables',
-  });
+  })
 
   checks.push({
     id: 'package-manager',
     label: 'Package manager',
     status: 'pass',
     message: `Detected ${input.packageManager}. Use the same package manager for install, build, and deploy checks.`,
-  });
+  })
+
+  checks.push({
+    id: 'design-first-page-builder',
+    label: 'Design-first page builder fit',
+    status: pageBuilderRisk ? 'warn' : 'pass',
+    message: pageBuilderRisk
+      ? 'A pages collection appears to model a designed marketing page as flat hero/body/CTA fields. For marketing, service, location, landing, and homepage routes, prefer a page-builder template with blocks, saved sections, forms, media, and seeded layout content unless field-mapped mode was explicitly approved.'
+      : 'No obvious flat marketing-page model detected in the Actuate config.',
+    fix: pageBuilderRisk
+      ? 'Create a design inventory and block coverage plan, then model section-based pages with page-builder content or document why field-mapped mode is intentional.'
+      : undefined,
+    docs: pageBuilderRisk ? 'https://actuatecms.dev/docs/design-first-page-builder' : undefined,
+  })
 
   const status: DiagnosticStatus = checks.some((check) => check.status === 'fail')
     ? 'fail'
     : checks.some((check) => check.status === 'warn')
-    ? 'warn'
-    : 'pass';
+      ? 'warn'
+      : 'pass'
 
-  return { status, checks };
+  return { status, checks }
 }
 
 export function buildDeploymentManifest() {
@@ -162,7 +189,7 @@ export function buildDeploymentManifest() {
       environmentVariables: 'https://actuatecms.dev/docs/environment-variables',
       aiRunbook: 'https://actuatecms.dev/docs/ai-runbook',
     },
-  };
+  }
 }
 
 export function missingCriticalFields(schemaContent: string): string[] {
@@ -172,18 +199,54 @@ export function missingCriticalFields(schemaContent: string): string[] {
     SavedSection: ['tree', 'usageCount', 'category'],
     PasswordResetToken: ['tokenHash', 'expiresAt', 'usedAt'],
     MediaUsage: ['mediaId', 'documentId', 'fieldPath'],
-  };
-  const missing: string[] = [];
+  }
+  const missing: string[] = []
 
   for (const [model, fields] of Object.entries(requiredFields)) {
-    const body = schemaContent.match(new RegExp(`model\\s+${model}\\s+\\{([\\s\\S]*?)\\n\\}`))?.[1] ?? '';
-    if (!body) continue;
+    const body =
+      schemaContent.match(new RegExp(`model\\s+${model}\\s+\\{([\\s\\S]*?)\\n\\}`))?.[1] ?? ''
+    if (!body) continue
     for (const field of fields) {
       if (!new RegExp(`^\\s*${field}\\s+`, 'm').test(body)) {
-        missing.push(`${model}.${field}`);
+        missing.push(`${model}.${field}`)
       }
     }
   }
 
-  return missing;
+  return missing
+}
+
+export function detectsFlatMarketingPageModel(configContent: string): boolean {
+  const normalized = configContent.toLowerCase()
+  const hasPagesCollection =
+    /\bpages\b/.test(normalized) || /slug\s*:\s*['"]pages['"]/.test(normalized)
+  if (!hasPagesCollection) return false
+
+  const hasPageBuilderSignals = [
+    'pagebuilder',
+    'page-builder',
+    "type: 'blocks'",
+    'type: "blocks"',
+    'layout:',
+    'savedsections',
+    'pagetemplate',
+  ].some((signal) => normalized.includes(signal.toLowerCase()))
+
+  if (hasPageBuilderSignals) return false
+
+  const flatMarketingSignals = [
+    'heroheadline',
+    'herosubheadline',
+    'herotitle',
+    'heroimage',
+    'bodycontent',
+    'ctabuttontext',
+    'ctabuttonurl',
+    'servicecards',
+    'testimonial',
+    'reviews',
+  ]
+
+  const signalCount = flatMarketingSignals.filter((signal) => normalized.includes(signal)).length
+  return signalCount >= 3
 }

package/src/index.ts

@@ -1,40 +1,40 @@
 #!/usr/bin/env node
-import { Command } from "commander";
-import { registerMigrateCommand } from "./commands/migrate.js";
-import { registerGenerateCommand } from "./commands/generate.js";
-import { registerSeedCommand } from "./commands/seed.js";
-import { registerImportCommand } from "./commands/import.js";
-import { registerExportCommand } from "./commands/export.js";
-import { registerUpgradeCommand } from "./commands/upgrade.js";
-import { registerUpdateCheckCommand } from "./commands/update-check.js";
-import { registerDbInitCommand } from "./commands/db-init.js";
-import { registerDbStatusCommand } from "./commands/db-status.js";
-import { registerInitCommand } from "./commands/init.js";
+import { Command } from 'commander'
+import { registerMigrateCommand } from './commands/migrate.js'
+import { registerGenerateCommand } from './commands/generate.js'
+import { registerSeedCommand } from './commands/seed.js'
+import { registerImportCommand } from './commands/import.js'
+import { registerExportCommand } from './commands/export.js'
+import { registerUpgradeCommand } from './commands/upgrade.js'
+import { registerUpdateCheckCommand } from './commands/update-check.js'
+import { registerDbInitCommand } from './commands/db-init.js'
+import { registerDbStatusCommand } from './commands/db-status.js'
+import { registerInitCommand } from './commands/init.js'
 import {
   registerDeployCheckCommand,
   registerDoctorCommand,
   registerVerifyCommand,
-} from "./commands/doctor.js";
+} from './commands/doctor.js'
 
-const program = new Command();
+const program = new Command()
 
 program
-  .name("actuate")
-  .description("Actuate CMS — CLI toolkit for migrations, codegen, and more")
-  .version("0.1.0");
+  .name('actuate')
+  .description('Actuate CMS — CLI toolkit for migrations, codegen, and more')
+  .version('0.1.0')
 
-registerMigrateCommand(program);
-registerGenerateCommand(program);
-registerSeedCommand(program);
-registerImportCommand(program);
-registerExportCommand(program);
-registerUpgradeCommand(program);
-registerUpdateCheckCommand(program);
-registerDbInitCommand(program);
-registerDbStatusCommand(program);
-registerInitCommand(program);
-registerDoctorCommand(program);
-registerDeployCheckCommand(program);
-registerVerifyCommand(program);
+registerMigrateCommand(program)
+registerGenerateCommand(program)
+registerSeedCommand(program)
+registerImportCommand(program)
+registerExportCommand(program)
+registerUpgradeCommand(program)
+registerUpdateCheckCommand(program)
+registerDbInitCommand(program)
+registerDbStatusCommand(program)
+registerInitCommand(program)
+registerDoctorCommand(program)
+registerDeployCheckCommand(program)
+registerVerifyCommand(program)
 
-program.parse();
+program.parse()

package/src/utils/logger.ts

@@ -1,26 +1,26 @@
-import chalk from "chalk";
+import chalk from 'chalk'
 
 export interface Logger {
-  info(message: string): void;
-  success(message: string): void;
-  warn(message: string): void;
-  error(message: string): void;
+  info(message: string): void
+  success(message: string): void
+  warn(message: string): void
+  error(message: string): void
 }
 
 export const logger: Logger = {
   info(message: string): void {
-    console.log(chalk.blue("ℹ"), message);
+    console.log(chalk.blue('ℹ'), message)
   },
 
   success(message: string): void {
-    console.log(chalk.green("✔"), message);
+    console.log(chalk.green('✔'), message)
   },
 
   warn(message: string): void {
-    console.warn(chalk.yellow("⚠"), message);
+    console.warn(chalk.yellow('⚠'), message)
   },
 
   error(message: string): void {
-    console.error(chalk.red("✖"), message);
+    console.error(chalk.red('✖'), message)
   },
-};
+}